Date help created: 13 Jun 1994 Date last updated: 22 Mar 2001'contours' creates contour files that can be read by Per Kraulis' Ansig program. All or a subset of planes in the chosen dimensions can be contoured.
The input data file must be blocked.
To run the program type
contours <contours script file>
The contours script file must have the following format:
input <par file of input data file> output <contours file> ! not an ordinary data file pnt_range <dim> <first> <last> ! optional for given dim. ppm_range <dim> <first> <last> ! optional for given dim. ! cannot have both pnt_range and ppm_range for given dim. pnt_exclude <dim> <first> <last> ! optional for given dim. ppm_exclude <dim> <first> <last> ! optional for given dim. ! can have multiple exclusions for any given dim. diag_exclude <dim1> <dim2> <delta> ! optional dims <dim1 of plane> <dim2 of plane> levels <levels to contour> levels_mult <base level> <number of levels> <level multiplier> levels_add <base level> <number of levels> <level adder> ! previous three lines can be repeated if want more levels ! <levels to contour> can be positive or negative ! <base level> can be positive or negative
'pnt_range' and 'ppm_range' are optional for each dimension, and can be used both for the plane dimensions and in the dimensions orthogonal to these. <first> must be less than <last>, and the contouring is done inclusive of both values (rounded to the nearest point integer).
'pnt_exclude' and 'ppm_exclude' are optional for each dimension, and any given dimension can have more than one exclusion. Any contour edge with one vertex in one of the excluded regions is excluded from the output file.
'diag_exclude' is optional, and can appear at most once for a given pair of (dim1, dim2). Any contour edge with one vertex in a diagonally excluded region (i.e. that for which the ppm values in the corresponding dimensions are within delta of each other) is excluded from the output file.
A typical example would be
input /usr/people/wb104/edl387/edl387_5.spc.par output /usr/people/wb104/edl387_5.spc.cnt23 ppm_range 1 8.0 10.5 ! ppm_range for dim. 1 ppm_range 2 8.0 10.5 ! ppm_range for dim. 2 pnt_range 3 12 30 ! pnt_range for dim. 3 diag_exclude 1 2 0.5 ! exclusion within 0.5 ppm of diagonal dims 2 3 ! contour plane for dims. 2 and 3 levels 20000 -20000 ! contour at levels +- 20000 levels 40000 -40000 ! also contour at levels +- 40000
This contours the planes in the (2, 3) dimensions, for the ppm range (8.0, 10.5) in dimensions 1 and 2 and for the point range (12, 30) in dimension 3. The contour levels are 20000, -20000, 40000 and -40000.
Azara help: contours / W. Boucher / azara@bioc.cam.ac.uk