DKRZ JupyterHub
The exercises are provided as Python Jupyter notebooks and are run on JupyterHub provided by DKRZ.
Log in with your u-Account at https://jupyterhub.dkrz.de/ and start a notebook server
Choose the following profile and fill in the account name um0878
First time setup
To checkout the repository and install the required Python modules, the following step has to be done once.
Open a terminal
Run the following commands
Code Block |
---|
module unload netcdf_c
module load anaconda3
pip install --user /work/um0878/users/olemke/rtcourse/python/*.whl
git clone --branch=wise2020 /work/um0878/users/olemke/rtcourse/arts-lectures.git |
If no errors occured, type `exit` and close the browser tab.
You can now navigate the file tree to `arts
Getting started
The material needed for the course is distributed via a subversion repository. Subversion is a version control system and can be used via the command line client git
.
These steps have to be done only once.
Code Block | ||
---|---|---|
| ||
cd ~
git clone --depth=1 -b wise2019 https://github.com/atmtools/arts-lectures.git |
Setting up the environment (do this once in every new terminal)
Every time you open a new terminal, you need to source the course environment. If you know that your default shell (echo $SHELL
) is bash
and not tcsh
, you can skip the first command:
Code Block | ||
---|---|---|
| ||
bash --login
source ~/arts-lectures/bin/arts-init.bash |
The following command shows the location of the ARTS API if it is successfully loaded:
Code Block | ||
---|---|---|
| ||
python -c "import typhon; \
typhon.set_loglevel('INFO'); \
import typhon.arts.workspace"
|
Updating the lecture package
Use the git pull
command to ensure that you have the latest version of the lecture files:
Code Block | ||
---|---|---|
| ||
cd ~/arts-lectures
git pull
|
Getting the lecture notes
Change to the directory script/
and run make:
Code Block | ||
---|---|---|
| ||
cd ~/arts-lectures/script
make
|
This will generate two PDF files, one optimised for viewing on the screen, one optimised for printing.
Running the exercises
Don't forget to run the source
command from the 'Setting up the environment' section above. You need to do this everytime you open a new terminal.
Change to the directory of the first exercise and run the Python script:
...
language | bash |
---|
...
-lectures/exercises/01-rotational
...
This opens an interactive window showing the simulated absorption cross sections.
The script will also save the plot as PDF file in the plots/
subdirectory. You can use a PDF viewer (e.g. evince) to display the plot:
...
language | bash |
---|
...
_spectra` and open the first exercise notebook `absorption_exe.ipynb`
Closing the notebook and server
After you're done for the day, shut down the notebook server. The notebook will be shutdown automatically after 12 hours. To save computate time (which will be accounted to the project even when the notebook is running in the background), please always close it down after you're done.
First close your notebook
Then go to the control panel
And stop the notebook server
...
Web location
This document can be found at https://collaboration.cen.uni-hamburg.de/display/RaRe/ARTS+Lecture
...