...
| 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. Introduction
For the future versions of UAL physical implementation of back-ends will be fully transparent,
however current version of UAL is coupled only with MDSPlus engine used for storing/ reading data locally.
This part of tutorial provides you some tricks useful in everyday work.
2.2. MDSPlus database
MDSplus is a set of software tools for data acquisition and storage and a methodology for management of complex scientific data (source).
...
| 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 | defines the equipment used for acquiring the results; "test" - is most commonly used for artificial, test data |
| <data_version> example: 3 | Major Data Dictionary version |
| <MDSPlus_tree_number> example: 0 | Contains all the shot and runs for given data tree |
| Shot number | Shot number is represented by first digits in database file ids_SSSSRRRR.*; there is no limit for number of digits used |
| Run number | Run number is represented by last four digits in database file ids_SSSSRRRR.* |
ids_####.datafile, ids_####.tree, ids_####.characteristics | Contains data for given shot/run |
2.
...
3. Accessing MDSPlus database data
2.
...
3.1 Listing pulse files
| Info | ||
|---|---|---|
| ||
Usage: imasdbs [OPTIONS] [COMMAND] This program lists existing 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 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> imasdbs -u palakb
Tokamak: test
Data version: 3
UAL Backend: mdsplus
Shot 1 Runs: 1
Shot 2 Runs: 3 666 777 999
Shot 10 Runs: 30 40 42 60 61 64 65 66 80 81 99 123 666 999 1234
Shot 12 Runs: 1 2 99
Shot 13 Runs: 1 |
2.
...
3.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:
...
| Code Block |
|---|
# change directory in your $HOME cd $HOME/public/imasdb/test/3/0/ # copy data files (pay attention to *_dot_* at the end of command line!) cp ~michalo/public/imasdb/test/3/0/ids_120002.* . cp ~michalo/public/imasdb/test/3/0/ids_130003.* . |
Currently UAL uses only MDSPlus engine for storing/ reading data locally.