To define the series you have to generate a second file with the same
name, but the extension "inf", in this case 'simulation.inf'. You can
choose and edit that file by using the menu "File"->"Edit Series File".
You might start with the file "SeriesTemplate.inf". This info file is also
delivered - directory .../VITESS/FILES - and looks like that:
WinNT 1
# Operating system (WinNT, Win98, Unix, Linux); number of batch files
S
# Shortening option, N: normal, S: short, V: very short
I:\FILES\Test # parameter directory
Series-Name # name of the series
#
# files to be saved (max. 10)
lambda.dat pos_y.dat
#
# List of variable parameters
#
no. traj. sample
1
16
-n
-S
run_1 9000000 I:\FILES\Test\isotropic.san
# test
run_2 249000000 I:\FILES\Test\sphere500.san
This file defines what the parser "GenerBatch" will do. It generates 1
or 2 batch files.
For Unix and Linux it is always 1 file, named 'simulationS'.
It contents the pipe commands for all simulations. In these commands, the
original parameter values are substituted by those, given in the file 'simulation.inf'.
Each command is embedded in some other commands that make sure that
- the log file information is collected in a file "history.txt"
- date and time of the beginning and the end of the simulation are noted
- the files that shall be saved are copied (see below)
- names of series and simulation are written to the history file
In Windows the same is done, if you give 1 (or nothing, because it is
the default value) as "number of batch files", (1. line, 2. parameter in
"SeriesTemplate.inf"). You will get a batch file 'simulationS.bat' then.
Alternatively, you can choose 2 batch files. In this case, you get the files
'simulationB.bat' and 'simulationV.bat'. The latter one is very similar to
the original 'simulation.bat', except:
- that it is changed to a working batch file
- that the variable parameters are substituted by %1, %2, etc.
This batch file is called by the other one - 'simulationB.bat' - and the
variable parameters are given as parameters to the lower level batch ('simulationV.bat').
Due to the MS-DOS restrictions, this method can only be used, if there are
less than 10 variable parameters in the series. Otherwise, the other way to
do it must be chosen.
In the example given above, 2 runs are demanded and two parameters are
variable. The first variable parameter is in module 1 and identified by
the command option -n. This is the number of trajectories (if "Source" is
the first module). In the first run it has a value of 9 Mio., in the second
of 249 Mio.
The second variable parameter is the command option -S of module 16. This
is the name of a file; in this case it is thought to be the name of a (SANS)
sample. Here two different samples are used for the 2 runs. (The symbols characterising
a command option can be seen by clicking on the label of the item.)
To save the results of the simulations, a list of files must be given that shall be copied (line 6 and 7 of the template file). They are copied to a file with the new name "run-name_filename". Therefore, every run must have its name; and there should be no blanks, commas etc. within the names. Additionally, the name will appear in the title of the simulation in the history file.
Further explanations:
- Everything after a sign '#' in the info file is regarded as a comment.
- In the first line you have to define the platform and maybe the number
of batch files
- The second line defines the option to shorten the command lines.
'N' means: no shortening
'S' means: a length reduction by substituting "C:/temp/vpipelog"
by "C:/temp/log" or "/tmp/vpipelog" by "/tmp/log"
'V' means: a length reduction by substituting "C:/temp/vpipelog"
by "C:/L" or "/tmp/vpipelog" by "/tmp/L" and by deleting "--B10000"
These changes might be necessary as the length of the pipe command
that can be executed is restricted in MS-DOS. (1 kByte for Windows 98, 2
kByte for Windows NT)
- In the third line the 'parameter directory' (or 'default directory') has
to be given
- In the fourth line a name for the simulation series can be given. It will
appear in the titles of the history file. (Blanks etc. are allowed.)
When you have completed that file, you can start the parser "GenerBatch"
from the menu ("Tools"->"Generate Batches"). You have to give the file
name 'simulation' and its directory. Then 'simulationV.bat' and 'simulationB.bat'
or 'simulationS.bat' or 'simulationS' are generated.
In the Unix/Linux batches, the environment variables $VIMG and $PDIR are
used for the module and the parameter directory resp.. In the Windows batches,
the logical drives V: and P: are used for those directories. If they already
exist as logical drives, the connection is removed. If they exist as physical
drives, the batch file must be changed; P or V must be substituted by another
letter.
The series can then be started outside the GUI as a separated batch (by
typing 'simulationB.bat'/'simulationS.bat'/'sh simulationS') in a DOS/Unix
shell.
Restrictions:
max. number of modules:
30
max. number of variable parameters: 25
max. number of simulations:
100
max. number of files to be copied: 10
Concluding remarks:
- It is necessary to start from the right platform. If you want to switch
it (e.g. from Windows 98 to Unix) you have to transfer the GUI file.
- A more flexible and easier solution will be presented in the next version
of VITESS.
Legend:
"fixed_name": names written in signs of quotation are fixed names
'example' : names written in apostrophes
are examples for naming