Versions Compared

Key

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

Quote of the day:
I love the smell of broken configuration in the morning ...
- Anonymous tutorial lecturer

Info

In this tutorial

  • installation and configuration of MDSPlus databases

 

 

Table of Contents
Table of Contents

 

Warning

Warning

Stop here for a moment. Make sure you have followed the configuration setup before proceeding any further!

Configuration related tutorial is here -> Click me! <-


2.1.

...

Database Creation

$ITMSCRIPTDIR/create_user_itm_dir test 4.10b

 

MDSplus is a set of software tools for data acquisition and storage and a methodology for management of complex scientific data (source).

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/ITMv1 kepler test 4.10b > /dev/null
$ITMSCRIPTDIR/create_user_itm_dir test 4.10b

...

locationdescription
$HOME/public/itmdb/itm_trees/$TOKAMAKNAME
example: ~owsiak/public/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
$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.
Contains data for given shot

ids_####.datafile,

ids_####.tree,

ids_####.characteristics

Contain data for givet shot/run

2.2. Accessing MDSPlus database data

From the user's point of view, there are few characteristics that define single data tree:

...

Info

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

source $ITMSCRIPTDIR/ITMv1 kepler test 4.10b > /dev/null

 

2.2.1 Listing pulse files

Info
titleitmdbs command

Usage: itmdbs [OPTIONS] [COMMAND]

This program lists existing ITM databases.

Possible commands are:

        list <shot number>- list existing databases

       slices <shot number> <run number> - list existing databases, including number of timeslices and time range for time-dependent IDSes

        times <shot number> <run number> - list existing databases, including number of timeslices their time points for time-dependent IDSes

        tokamak - list existing tokamaks (with data versions)                                                                                

        dataversion - list existing dataversions (with tokamaks)                                                                             

If the optional arguments shot number and run number are given, only databases with these numbers will be shown.

If no command is given, the list command is performed.

To see databases stored in the public itm database, use 'public' as the user name.

Options:

  -h, --help            show this help message and exit

  -u USER, --user=USER  Show databases of specified user

  -t TOKAMAK, --tokamak=TOKAMAK                         

                        Show only databases for specified tokamaks

  -v VERSION, --version=VERSION                                   

                        Show only databases for specified data version

  --backend=BACKEND     Show databases written with given backend(s).  Comma-

                        separated list of backends (Currently supported:     

                        mdsplus, hdf5). By default all backends are shown.   

  -c, --compact         Compact/reduced output

Code Block
shell> itmdbs -t test slices 14 4
Tokamak: test
   Data version: 4.10b
      UAL Backend: mdsplus
         Shot    14
             Run:     4
                   equilibrium:  100 slices ( 0.0 - 99.0)

 

2.2.2 Copying database files directly

In case you know user name, machine name, shot number and run number, you can import users' database files copying them directly from the users' public directories. Database files are located inside:

...