wiki:Help/AdminAddSimulation

Adding Batch Simulation Results

The ESTEST web upload form supports posting tar/gzip format archives of simulation I/O documents. For not too large or too many simulation I/O, this form works fine as a batch upload method.

Simulations that are either too large or collections in which many simulations must be uploaded must be handled offline via the command line. The putur.py script in the ESTEST source tree directory scripts/admin is a helper script that invokes the ur4Xxx translator, generates a UR XML representation of the simulation, and uploads that UR document to a eXist-db server belong to a specified user. To use putur.py you must download the source version of ESTEST (including the translators sources) to your workstation and execute the correct command line. The usage for putur.py is

Usage: putur.py [options]

Options:
  -h, --help            show this help message and exit
  -c CODE, --code=CODE  Translator code
  -d IDENTIFIER, --identifier=IDENTIFIER
                        UR document identifier
  -i INPUTS, --input=INPUTS
                        input files
  -l, --list            List available codes and exit
  -o OUTPUTS, --output=OUTPUTS
                        output files
  -p PASSWORD, --password=PASSWORD
                        eXist-db user password
  -r PORT, --port=PORT  ESTEST server port
  -s SERVER, --server=SERVER
                        ESTEST server URL
  -t HOSTNAME, --hostname=HOSTNAME
                        Machine host name
  -u USERNAME, --username=USERNAME
                        eXist-db user name

This script uploads one UR simulation document at a time using a command line, an example

$ putur.py -c siesta -i ./22_Phenoldimer/SIESTA/Phenoldimer/Phenoldimer.fdf \
-o ./22_Phenoldimer/SIESTA/Phenoldimer/Phenoldimer.xml \
-d yuangm/JSCH-S22-2005-IE-SIESTA-GGA/22_Phenoldimer/SIESTA/Phenoldimer.xml \
-u tester -p PASSWORD -s http://estest.ucdavis.edu

Input files are listed using the -i flag; likewise, output files use the -o flag. These two flags -i/-o can be used any number of times to specify multiple simulation I/O files. The -c flag specifies which translator to use, the convention we adopt is that the flag argument is the lower case version of the string "Xxx" where the translator script is named "ur4Xxx". The eXist-db server can be changed using the -s flag; by default it is "http://localhost". The command line should specify the username and password of an account on the remote ESTEST server using the -u and -p flags. A UR document upload using this command line can set its identifier element using the -d flag which will name it with the argument.

Last modified 6 years ago Last modified on 01/31/12 14:01:28