05.3.1 Setting up terminal session
Whenever you start new session you have to make sure that environment is correctly set. Environment configuration is done via the set of modules. In case of IMAS environment there is a module called imasenv
that will load many other modules.
The very basic setup of your environment follows
# Loading imasenv module (development version) # > module load imasenv/3.24.0/rc INFO: No wpcdenv was set. Using default one. IMAS environment loaded. # In addition to that you should make sure to install your personal version # of Kepler - it's a good idea to choose a place where your Kepler installations # will be stored. In case you don't set it, your personal Kepler location is set # to $HOME/.local/kepler # > mkdir -p $ITMWORK/imas-keplers > setenv KEPLER_DIR $ITMWORK/imas-keplers > kepler_install my_first_kepler # Make sure to initialise your database - this step will be dropped in the future > imasdb test # After Kepler is installed you can list all your Kepler installations # and choose one of them to be loaded # > kepler_avail Using KEPLER_DIR at: /afs/eufus.eu/user/g/g2michal/itmwork/imas-keplers. Available local installations (* currently loaded): my_first_kepler : /gw/swimas/extra/kepler/2.5p4-3.0.5 keplertools/1.8.7 my_own_kepler : /gw/swimas/extra/kepler/2.5p2-2.1.5 keplertools/ test : /gw/swimas/extra/kepler/2.5p2-2.1.5 keplertools/ NOTE: No installation is currently loaded, please use `kepler_load` to load one or create a new one with `kepler_install`. > kepler_load my_first_kepler Using KEPLER_DIR at: /afs/eufus.eu/user/g/g2michal/itmwork/imas-keplers. # You can start Kepler now # > kepler Using KEPLER_DIR at: /afs/eufus.eu/user/g/g2michal/itmwork/imas-keplers. The base dir is /gss_efgw_work/work/g2michal/imas-keplers/my_first_kepler/kepler ... ...
More about installing and configuring Kepler for IMAS can be found at following location: IMAS Kepler - 2.5p4-3.0.5
It's a good idea to keep your configuration inside shell scripts and then, loading them at one go. For example, you could have put something like this
module load imasenv/3.24.0/rc mkdir -p $ITMWORK/imas-keplers setenv KEPLER_DIR ~/imas-keplers kepler_install my_first_kepler kepler_load my_first_kepler
inside file ~/my_setup.sh
and then, instead of typic these commands each time you log in, you could have your environment set after calling
> source ~/my_setup.sh
05.3.2 Creating directory for user's data
Whenever you work with input/output data you need location for database. It is assumed that all data files are stored inside ~/public/imasdb/MACHINE_NAME
location. Before you run any IMAS related code you have to make sure your database is properly set.
# For example. To work with jet data, you will create jet database where all the pulse files are stored # In case this directory doesn't exist yet, it will be created. # > imasdb test
05.3.3 Running commands after session is set up
After your terminal session is set up you can use basic tools out of the box
> kepler > fc2k
Please note that some tools will require X11 to run properly. You have to have your NX session running. On the other hand, some tools may be started directly from ssh session - this refers to all the CLI based tools.