The optional OUTPUT element gives a new name to the output job file writtem after checkpoints. It then contains a list of tasks. In each TASK element, the INPUT element specifies an input file for the tasks. Optionally a new file name for the checkpoints can be given by OUTPUT elements.<JOB> <OUTPUT file="parm.xml"/> <TASK status="new"> <INPUT file="parm.task1.in.xml"/> <OUTPUT file="parm.task1.xml"/> </TASK> <TASK status="new"> <INPUT file="parm.task2.in.xml"/> <OUTPUT file="parm.task2.xml"/> </TASK> <TASK status="new"> <INPUT file="parm.task3.in.xml"/> <OUTPUT file="parm.task3.xml"/> </TASK> </JOB>
Before a simulation starts, this file just lists all simulation parameters. Afterwards results and checkpoint information will be added. See the schema documentation for more details.<SIMULATION> <PARAMETERS> <PARAMETER name="L">100</PARAMETER> <PARAMETER name="SWEEPS">10000</PARAMETER> <PARAMETER name="T">0.5</PARAMETER> <PARAMETER name="THERMALIZATION">100</PARAMETER> <PARAMETER name="WORK_FACTOR">SWEEPS * L</PARAMETER> </PARAMETERS> </SIMULATION>
Two parameters have a special meaning:
Parameter | Default | Meaning |
SEED | 0 | The random number seed used in the next Monte Carlo run created. After using a seed in the creation of a Monte Carlo run, this value gets incremented by one. |
WORK_FACTOR | 1 | A factor by which the work that needs to be done for a simulation is multiplied in load balancing. |
where each group of assignments inside a block of curly braces {...} indicated a set of parameters for a single simulation. Assignments outside of a block of curly braces are valid globally for all simulation after the point of definition. Strings are given in double quotes, as in "Ising" and expressions in square brackets, as in [L*SWEEPS]. To ensure backwards compatibility, and also because this is a format which is easier to enter than a set of XML files, we provide a tool convert2xml which can convert these parameter files into XML files. The syntax is:MODEL="Ising"; SWEEPS=1000; THERMALIZATION=100; WORK_FACTOR=[L*SWEEPS]; { L=10; T=0.1; } { L=20; T=0.05; }
which converts a parameterfile into a set of XML files, starting with the prefix given as optional second argument. The default for the second argument is the name as the parameterfile.convert2xml parameterfile [xmlfileprefix]
The results will be stored in a file job.out.xml, which refers to the files job.task1.out.xml, job.task2.out.xml and job.task3.out.xml for the results of the three simulations.convert2xml parm job main job.in.xml
Option | Default | Description |
-T or --time-limit timelimit | infinity | gives the time (in seconds) which the program should run before writing a final checkpoint and exiting. |
--Tc checkpointtime | 1800 | gives the time (in seconds) after which the program should write a checkpoint. |
--Tmin checkingtime | 60 | gives the minimum time (in seconds) which the scheduler waits before checking (again) whether a simulation is finished. |
--Tmax checkingtime | 900 | gives the maximum time (in seconds) which the scheduler waits before checking (again) whether a simulation is finished. |
convert2xml parm job mpirun -np 4 main job.in.xml
Option | Default | Description |
--Nmin numprocs | 1 | gives the minimum number of processes to assign to a simulation. |
--Nmax numprocs | infinity | gives the maximum number of processes to assign to a simulation. |
This will produce a file job.task1.run1.xml, containing information extracted from this Monte Carlo run.convert2xml job.task1.run1
Optionally, the compacted file can be given a new name:compactrun job.task1.run1
compactrun job.task1.run1 compacted.task1.run1
copyright (c) 1994-2010 by Matthias Troyer
Distributed under the Boost Software License, Version 1.0. (See http://www.boost.org/LICENSE_1_0.txt)