Tutorials

Tutorials are available at torax/tutorials/. The tutorial is comprised of a series of exercises. An additional notebook containing suggested solutions is also available. The tutorial is tested for TORAX v1.0.0 and is not guaranteed to work with later major versions due to API changes.

The tutorials are intended to be run in either a Jupyter or Colab notebook.

The exercises focus on investigating the impact of heating and current drive actuators on q-profile tailoring for a scenario inspired by the ITER hybrid scenario. Further context is provided within the tutorial notebook itself.

To facilitate the tutorial, a baseline TORAX configuration has been provided. Additionally, various helper functions for simulation config modification, simulation execution, and plotting routines, are also all packaged with the notebook. Instructions for using these routines are provided in the notebook itself.

Google Colab

For loading the tutorial notebook directly from GitHub, click the link below:

Open In Colab

And for the notebook containing the suggested solutions, click the link below:

Open In Colab

The tutorial notebook can then be immediately run.

For loading the tutorial notebook from your cloned source code, carry out the following steps:

  1. Navigate your browser to https://colab.research.google.com/

  2. Click on “File” in the upper left corner, then “Upload notebook”, then “Browse”.

  3. Navigate to the torax/tutorials directory in the file explorer and upload the desired notebook.

Jupyter

First install the necessary dependencies. For PyPI installations:

pip install torax[tutorial]

For installations from the cloned source code, run the following from the TORAX root directory:

pip install -e .[tutorial]

Then run the kernel:

jupyter notebook --no-browser

If successful, you should see a message like:

To access the server, open this file in a browser:
    file:///<PATH>
Or copy and paste one of these URLs:
    http://localhost:8890/tree?token=<TOKEN>
    http://127.0.0.1:8890/tree?token=<TOKEN>

With <PATH> and <TOKEN> being environment and instance specific.

To access the notebook server:

  1. Copy one of the URLs into your browser.

  2. Assuming that you have cloned the TORAX source code, navigate to the torax/tutorials directory in the file explorer.

  3. Open the desired notebook.