Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

In order to benefit from UAL layer, scientific data must be stored in MDSPlus database. Before you will be able to use it, you have to create database's structure. This is fairly simple. All you have to do is to execute following commands:

source $ITMSCRIPTDIR/ITMv2 test kepler > /dev/null
$ITMSCRIPTDIR/create_user_itm_dir test 4.10bimasdb <machine_name>

At this point, you can check your public directory and browse through the database structure.

cd $HOME/public/itmdbimasdb/itm_trees

Explanation of the tree structure:

/itm_trees/$TOKAMAKNAME ~owsiak
location

description

$HOME/public/itmdb/<machine_name>/<data_version>/<MDSPlus_tree_number>/ids_<shot><run>.*
example:
~/public/imasdb/test/3/0/ids_120001.*
<machine_name>
example: test/itmdb/itm_trees/test)
defines the equipment used for acquiring the results; "test" - is most commonly used for artificial, test data
$HOME/public/itmdb/itm_trees/$TOKAMAKNAME/$DATAVERSION/mdsplus
example: ~owsiak/public/itmdb/itm_trees/test/4.10b/mdsplus
contains experimental data for given UAL version
<data_version>
example: 3
Major Data Dictionary version
<MDSPlus_tree_number>
example: $HOME/public/itmdb/itm_trees/$TOKAMAKNAME/$DATAVERSION/$MDSPLUS_TREE_BASE_$NUMBER/
example: ~/public/itmdb/itm_trees/test/4.10b/mdsplus/0
Contains all the shot and runs for given data tree$HOME/public/itmdb/itm_trees/$TOKAMAKNAME/$DATAVERSION/mdsplus/$MDSPLUS_TREE_BASE_$NUMBER/ids_$SHOT
example: ~/public/itmdb/itm_trees/test/4.10b/mdsplus/ids_120001.
Run numberRun number is represented by last four digits in database file ids_SSSSRRRR.*
Shot numberShot number is represented by first digits in database file ids_SSSSRRRR.*; there is no limit for number of digits usedContains data for given shot

ids_####.datafile,

ids_####.tree,

ids_####.characteristics

Contain Contains data for givet given shot/run

2.2. Accessing MDSPlus database data

...

Info

ITMv2 script
All above environment variables are set to default values whenever ITMv2 imasdb script is executed

imasdb <machine_name>
 source $ITMSCRIPTDIR/ITMv2 test kepler > /dev/null

 

2.2.1 Listing pulse files

...