man5/runlist_v2

Table of Contents

Name

runlist_v2 - DMANserv_v2(8) runlist file format

Description

The runlist file defines a list of cathodes to be processed by the DMANserv_v2(8) program.

The lines starting with the word batch specify global settings which apply to all cathodes in the list. The rare isotope name, which ion source to use, what cathode to park the source on when the list is finished, the operating mode of the program and whether to autorange the current amplifiers used for abundant isotope measurements are specified here.

Lines starting with the word cathode are entries in a list of cathodes.

Lines starting with the word item specify settings related to each item in the list. Each line specifies parameters for one runlist item.

summary are entries in a summary group.

Each line in the file contains one directive. The fields within a line should be separated by tabs or spaces and the line terminated with a newline.

Lines beginning with a # are treated as comments. There is no line continuation character.

If multiple batch lines occur for the same batch directive the last entry in the file is used.

If multiple cathode lines occur with the same cathode position number second and subsequent occurances are ignored and a complaint is written to stderr (DMANserv’s log file) and to the user.

If multiple item lines occur with the same item number the second and subsequent occurances are ignored and a complaint is written to stderr (DMANserv’s log file) and to the user.

If multiple summary lines occur with the same grp number the second and subsequent occurances are ignored and a complaint is written to stderr (DMANserv’s log file) and to the user.

batch directives should appear first in the file.
cathode directives should appear next.
item directives are next.
summary directives are last.

batch parameters

Batch parameters consist of three fields, the word batch, the parameter name and the parameter value.
autorange <no/yes>

Disable/enable autoranging of the abundant isotope measurement system.
This setting may be changed by a button in DMANmngr_v2(1) after the runlist is loaded.
isotope <isotope_name>

The name of the rare isotope. The maximum size of this field is 5 chars. There can be no whitespace in this field.
judge <on/off>

Disable/enable judgement.
This setting may be changed by a button in DMANmngr_v2(1) after the runlist is loaded.
This function has no meaning if DMANjudge_v2(8) isn’t running.
mode <nrm/rpt/grp/sgl>

See the section DMANserv operating modes for a description of this parameter.
This setting may be changed by a button in DMANmngr_v2(1) after the runlist is loaded.
parkmode <off/on>

Enable or disable parking.
This setting may be changed by a button in DMANmngr_v2(1) after the runlist is loaded.
park N

Which cathode position to park the wheel in when the runlist is completed.
N specifies the cathode number.
If N is -1 the indexer will not be parked. Otherwise, legal values of N are from 0 to the maximum number of cathode positions in the ion source.
An illegal value will cause the cathode index operation to fail.
source <S1/S2>

This parameter specifies which ion source to use.
wlimit <value>

Warmup limit. This value is used when autoranging to specify the maximum number of cycles to spend in autoranging. If this value is reached DMANserv moves on even if autoranging is not finished.

cathode parameters

Each line in the runlist specifies parameters for one cathode position in the ion source.

A cathode must exist is this group before it may be specified by an item directive.

The fields are in the following order: the word cathode and the fields Pos, SmType, Sample Name, and Sample Name2.

The field usage is as follows:

Pos

The cathode position in the wheel. Pos is a positive integer value. The minimum legal value is 0. The maximum legal value depends on the number of cathode positions in the ion source. An illegal value will cause the program to pause and complain about the cathode number being out of range.
SmType

used by the PV-Wave software to identify the sample material in a cathode for the delta 13C correction. The maximum size of this field is 8 chars. Letters may be upper or lower case (the PV-Wave software converts all letters to upper case). There can be no whitespace in this field.

The PV-Wave software looks for the SmType indentifier in the file /IsoNET/inputs/deltafile on the computer where PV-Wave is running. If the identifier is found in the file, the program uses the listed delta 13C value and its uncertainty. Each line in the file contains 3 parameters: the SampleType(SmType) indentifier, the Delta 13C value for that material, and the uncertainty (Sigma) of the delta 13C value. At least one space is required between the 3 values on each line, and any amount of white space is allowed.

Here is a list of SmType values supplied with the system:

ANU ANU sucrose, delta13C = -10.8, sigma = 0.47
SUC Sucrose, delta13C = -10.8, sigma = 0.47
HOXII Oxalyic Acid II, delta13C = -17.8, sigma = 0.5
OXII Oxalyic Acid II, delta13C = -17.8, sigma = 0.5
HOXI Oxalyic Acid I, delta13C = -19.0, sigma = 1.0
OXI Oxalyic Acid I, delta13C = -19.0, sigma = 1.0
C1 IAEA material code, delta13C = 2.42, sigma = 0.33
C2 IAEA material code, delta13C = -8.25, sigma = 0.31
C3 IAEA material code, delta13C = -24.91, sigma = 0.49
C4 IAEA material code, delta13C = -23.96, sigma = 0.62
C5 IAEA material code, delta13C = -25.49, sigma = 0.72
C6 IAEA material code, delta13C = -10.8, sigma = 0.47

SampleName
sample identifier.

SampleName has a maximum size of 16 chars. There can be no whitespace in this field. Entries longer than 16 chars will be truncated.

SampleName2
an auxiliary sample identifier.

SampleName2 has a maximum size of 16 chars. There can be no whitespace in this field. Entries longer than 16 chars will be truncated.

item parameters

Each line in the item list specifies parameters for one set of measurements on one cathode. The same cathode may appear in more than one item entry.

Please note that the keyword run is still recognized and may be used in place of the keyword item but is deprecated.

The fields are in the following order: the word item (or the word run) and the fields Item, Pos, Grp, Sum, Runs, Md, Tlimit, Climit, and Warm. These are required fields.

The fields Jn and Jlimit fields are optional and need to be added if judgement is used.

The field usage is as follows:

Item

The item number of the run. The first component of the run directory names are this number.
Pos

The cathode position in the wheel. This refers to an entry in the cathode list which must be present for the item to be accepted.
Grp

Associates items in the list. All items in group 0 will be measured before items in group 1 and so on. Grp is an integer value. The minimum legal value is 0. The maximum legal value is 99.

Note that the user may start execution at any point in the runlist from DMANmngr_v2(1) . Placing the DMAN system in grp mode and selecting an item at the beginning of a group using DMANmngr allows any single group to be executed.

Sum

Associates an item with a summary group.
Runs

The number of times to measure an item. An item is selected, warmed up and measured the number of times given here. After that it is ignored in the list. Runs is a positive integer value.

Md/Tlimit/Climit

Md (mode), Tlimit and Climit together specify how to perform the measurement.

If mode is T then the Tlimit field specifies the number of jumping cycles to perform. A typical jumping cycle is 100mS long so a Tlimit value of 3000 means to measure for 300 seconds. Climit is ignored but the field must be present.

If mode is C then Tlimit works as already described and Climit also comes into play. Climit is the number of gated rare isotope events to collect before ending the measurement. If either Climit or Tlimit is reached the measurement is concluded.

Tlimit and Climit are positive integer values.

Note that the measurement time as specified here is actual data collection time NOT clock time. The actual measurement will take a little bit longer than the amount of time specified by Tlimit due to various overheads.

Warm

The amount of time in jumping cycles to warm up the cathode before beginning a measurement. Warm is a positive integer value. As with Tlimit a typical jumping cycle is 100mS so a Warm value of 1000 means to warm up the cathode for 100 seconds.
Jn

The minimum number of measurements to use when judging. Jmeas is a positive integer value. The miniumum value is 3.
Jlimit

The judgement error limit. Jlimit may be specified as a fixed format number, i.e. "0.1", or a scientific notation number, i.e. "1.0e-1".

summary parameters

Each line in the summary list specifies parameters for one summary group.

The fields are in the following order: the word sum and the fields Grp, and Group Name.

The field usage is as follows:

Grp

The summary group number.
Group Name

The name of the summary group.

DMANserv operating modes

nrm

nrm mode traverses the runlist, usually several times, measuring each cathode once then indexing the ion source after each measurement until all cathodes have been measured the number of times specified by Runs.
rpt

rpt mode measures each cathode the number of times specified by Runs and then indexes to the next cathode in the list.

This is typically used in applications where it is desired to make several short measurements of a cathode and after some minimum number of measurements make a decision based on the scatter of measurements whether to measure again or move to the next cathode. It is possible to write program modules using other selection criteria.

AccelNET provides a program module which makes this decision based on the results of the most recent N number of runs.

The PV-Wave analysis software also contains options to select the "best" N runs, based on your choice of any of five criteria, during offline reanalysis of the data.

grp

grp mode allows all cathodes in a single group to be measured. The cathodes are measured as in nrm mode except that the measurements are concluded when all cathodes in a single group are measured.
sgl

sgl mode allows a single cathode to be selected and measured. This mode does not pay any attention to the Runs field.

Example runlist

#
# batch control items --------------------
#
batch isotope 14C
batch source S1
batch park 0
batch mode nrm
batch autorange no
batch judge on
#
# cathode list items --------------------
#
cat 1 UNK Poco_0.40 1
cat 2 UNK Poco_0.40 2
cat 3 UNK Poco_0.80 1
cat 4 UNK NIES_std 1
cat 4 UNK NIES_std 2
#
# run list items --------------------
#
item 1 1 1 10 T 3000 0 100 3 0.2
item 2 2 1 10 T 3000 0 100 3 0.2
item 3 3 2 10 T 3000 0 100 3 0.2
item 4 4 2 10 T 3000 0 100 3 0.2
item 5 5 3 10 T 3000 0 100 3 0.2
#
# summary list items --------------------
#
sum 1 poco40
sum 2 poco80

sum 3 standards

Manual page revision

$Id: runlist_v2.5,v 2.10 2007/05/15 18:09:04 kitchen Exp $


Table of Contents