1. How to use tool
These are just examples. The tool is still in development phase. Once we agree that current status is what we are looking for, we will release it.
Publicly available copy of private database can be created using createpublicdb_imas.
> createpublicdb_imas
To get basic help, run the tool following way
> createpublicdb_imas --help
1.1. Example usage
- Create a text file with name
description.txt
that contains a plain-text description of the database you want to save - it can be arbitrary text, it is supposed to give basic information about your pulse file. Run the tool in
dry mode
first:# You have to provide basic information related to your pulse file # createpublicdb_imas -n <USER> <TOKAMAK> <DATAVERSION> <SHOT> <RUN> description.txt # example - for user g2dfigat - make sure to use your own user name and proper shot/run numbers; # version of database is also mandatory > createpublicdb_imas -n g2dfigat jet 3 12 12 description.txt
This will output the actions that will be taken and the metadata file that will be created on stdout.
Run the tool:
> createpublicdb_imas g2dfigat jet 3 12 12 description.txt
Check the output with imasdbs:
> imasdbs -u public -t jet -v 3
This should now list the shot (in this case
12
)
2. Test environment
Please note that for now we are working with artificially created environment - to make sure we don't access public database location yet.
The tool is meant to modify the public database, which carries the risk of corrupting important data. For testing the tool, or practicing its use, a test environment is foreseen. In this test environment a test copy of the public database is used. Below are instructions how to use the test environment.
2.1. Switch to development environment
module purge module load cineca module load imasenv cd /pfs/work/g2dfigat/archiving_scripts/R3-imas source environment
2.2. Check that you have the development database selected:
env | grep PUBLICDB
This should give:
IMASPUBLICDBHOME=/pfs/work/g2dfigat/archiving_scripts/imasdb/public IMASPUBLICDBMETADATA=/pfs/work/g2dfigat/archiving_scripts/imasdb/meta
IMPORTANT: If you don't check this, you risk overwriting the real public database!
2.3. Run tool
bin/createpublicdb_imas --help
This should give you some basic documentation.
2.4. use tool to create entries in the public database
createpublicdb_imas <USER> <TOKAMAK> <DATAVERSION> <SHOT> <RUN> description.txt
In case of error:
ERROR - Public database not set up for tokamak west and data version 3
ERROR - You have to run
create_public_imas_dir <TOKAMAK> <DATAVERSION>
Please run:
./create_public_imas_dir <TOKAMAK> <DATAVERSION>
5. check that the public database is populated correctly:
ls -l $IMASPUBLICDBHOME/<TOKAMAK>/3/0/
or
bin/publicIMASdb -u public
6. please report any problems you find.