man1/DMANflattop

Table of Contents

Name

DMANflattop - flattopping program for AMS setup

Synopsis

DMANflattop <argument list>

Description

A graphical utility for flattopping

See the online help system for an explanation of how the program works.

Arguments

--dbman_host <hn>

the host where dbman(8) is running

If not supplied the default is: localhost

--mngr_conf <fn>

Pathname of the CONFLIST file to load.
See the section "FLATTOPconf configuration file" below.

If not supplied the default is: FLATTOPconf.

--data_dir <dir>

Pathname to a directory for holding flattop information.
--plot_mode <mode>

Mode for generating plot files.
--show_tbl

Print internal table information.
--help

Starting the program with this option causes it to print an online help message to stderr and exit.

FLATTOPconf configuration file

Groups are used to denote one "flattop" group. Each group must contain all parameters listed as required.

<ctl1 0> - required

The parameter to "sweep" when performing the flattop.

This parameter must be writable by DMANflattop.

<read1 0> - required

The parameter to monitor.

<read1 1> - optional

A second parameter to monitor.
<int0 0> - required

the width i.e. the range over which to sweep the control

width is used like this:
c_min = (ctl1 0) - (width/2.0)

c_max = (ctl1 0) + (width/2.0)

<int0 1> - required

the time between steps (in seconds)

<int0 2> - required

the number of steps
<int0 3> - optional

flattopping mode

valid values are:
0 - nrm

1 - dual

if the parameter is missing "nrm" is assumed

<int1 0> - optional

starting value for the ft1 confidence limit
The value range is: 0 --> 1.0
<int1 1> - optional

starting value for the ft2 confidence limit
The value range is: 0 --> 1.0
<int2 0> - optional

starting value for the ft1 select limit
The value range is: 0 --> 1.0
<int2 1> - optional

starting value for the ft2 select limit
The value range is: 0 --> 1.0

<int3 0> - optional

the read1 0 readback limit

This value which must be exceeded before flattopping is allowed. If the record is missing the check is skipped. The preset field is used to specify the value

<int3 1> - optional

the read1 1 readback limit

This value which must be exceeded before flattopping is allowed. If the record is missing the check is skipped. The preset field

is used to specify the value

FLATTOPconf file example

This is a rather long example taken from an actual working configuration for a SSAMS system.

#
#    DMANflattop conf file
#
#
DMANflattop| g1|ctl1 |0|ESA 01-1|VC |
DMANflattop| g1|read1 |0|FC 04-1|CR |
#
DMANflattop| g1|int0 |0|NULL |NULL |0.1
DMANflattop| g1|int0 |1|NULL |NULL |2.0
DMANflattop| g1|int0 |2|NULL |NULL |20
#
DMANflattop| g1|int1 |0|NULL |NULL |0.9100
#
DMANflattop| g1|int2 |0|NULL |NULL |0.9200
#
DMANflattop| g1|int3 |0|NULL |NULL |7.5e-8
#
#
#
DMANflattop| g2|ctl1 |0|BM 01-1|MfieldC |
DMANflattop| g2|read1 |0|FC 04-1|CR |
#
DMANflattop| g2|int0 |0|NULL |NULL |5.0
DMANflattop| g2|int0 |1|NULL |NULL |8.0
DMANflattop| g2|int0 |2|NULL |NULL |20
#
DMANflattop| g2|int1 |0|NULL |NULL |0.9100
#
DMANflattop| g2|int2 |0|NULL |NULL |0.9200
#
DMANflattop| g2|int3 |0|NULL |NULL |7.5e-8
#
#
#
DMANflattop| g3|ctl1 |0|MBS 01-1|VCreg2 |
DMANflattop| g3|read1 |0|FC 04-1|CR |
#
DMANflattop| g3|int0 |0|NULL |NULL |0.1
DMANflattop| g3|int0 |1|NULL |NULL |2.0
DMANflattop| g3|int0 |2|NULL |NULL |20
#
DMANflattop| g3|int1 |0|NULL |NULL |0.9100
#
DMANflattop| g3|int2 |0|NULL |NULL |0.9200
#
DMANflattop| g3|int3 |0|NULL |NULL |7.5e-8
#
#
#
DMANflattop| g4|ctl1 |0|BM 03-1|MfieldC |
DMANflattop| g4|read1 |0|FC 04-1|CR |
#
DMANflattop| g4|int0 |0|NULL |NULL |15.0
DMANflattop| g4|int0 |1|NULL |NULL |8.0
DMANflattop| g4|int0 |2|NULL |NULL |20
#
DMANflattop| g4|int1 |0|NULL |NULL |0.9100
#
DMANflattop| g4|int2 |0|NULL |NULL |0.9200
#
DMANflattop| g4|int3 |0|NULL |NULL |7.5e-8
#
#
#
DMANflattop| g5|ctl1 |0|ESY S1-1|YVC |
DMANflattop| g5|read1 |0|FC 04-1|CR |
#
DMANflattop| g5|int0 |0|NULL |NULL |0.01
DMANflattop| g5|int0 |1|NULL |NULL |2.0
DMANflattop| g5|int0 |2|NULL |NULL |20
#
DMANflattop| g5|int1 |0|NULL |NULL |0.9100
#
DMANflattop| g5|int2 |0|NULL |NULL |0.9200
#
DMANflattop| g5|int3 |0|NULL |NULL |7.5e-8
#
#
#
DMANflattop| g6|ctl1 |0|ESY 01-1|VCreg2 |
DMANflattop| g6|read1 |0|FC 04-1|CR |
#
DMANflattop| g6|int0 |0|NULL |NULL |20.0
DMANflattop| g6|int0 |1|NULL |NULL |2.0
DMANflattop| g6|int0 |2|NULL |NULL |20
#
DMANflattop| g6|int1 |0|NULL |NULL |0.9100
#
DMANflattop| g6|int2 |0|NULL |NULL |0.9200
#
DMANflattop| g6|int3 |0|NULL |NULL |7.5e-8
#
#
#
DMANflattop| g7|ctl1 |0|EL 02-1|VC |
DMANflattop| g7|read1 |0|FC 04-1|CR |
#
DMANflattop| g7|int0 |0|NULL |NULL |1.0
DMANflattop| g7|int0 |1|NULL |NULL |2.0
DMANflattop| g7|int0 |2|NULL |NULL |20
#
DMANflattop| g7|int1 |0|NULL |NULL |0.9100
#
DMANflattop| g7|int2 |0|NULL |NULL |0.9200
#
DMANflattop| g7|int3 |0|NULL |NULL |7.5e-8
#
#
#
DMANflattop| g8|ctl1 |0|ESA 04-1|VC |
DMANflattop| g8|read1 |0|FC 05-1|CR |
#
DMANflattop| g8|int0 |0|NULL |NULL |0.3
DMANflattop| g8|int0 |1|NULL |NULL |2.0
DMANflattop| g8|int0 |2|NULL |NULL |20
#
DMANflattop| g8|int1 |0|NULL |NULL |0.9100
#
DMANflattop| g8|int2 |0|NULL |NULL |0.9200
#
DMANflattop| g8|int3 |0|NULL |NULL |7.5e-8
#
#
DMANflattop| g9|ctl1 |0|SPD 05-1|VCreg2 |
DMANflattop| g9|read1 |0|FC 05-1|CR |
#
DMANflattop| g9|int0 |0|NULL |NULL |5.0
DMANflattop| g9|int0 |1|NULL |NULL |2.0
DMANflattop| g9|int0 |2|NULL |NULL |20
#
DMANflattop| g9|int1 |0|NULL |NULL |0.9100
#
DMANflattop| g9|int2 |0|NULL |NULL |0.9200
#
DMANflattop| g9|int3 |0|NULL |NULL |7.5e-8
#
# tune C14
#
DMANflattop|g10|ctl1 |0|MBS 01-1|VCreg0 |
DMANflattop|g10|read1 |0|MFC 04-1|CR |
#
DMANflattop|g10|int0 |0|NULL |NULL |0.1
DMANflattop|g10|int0 |1|NULL |NULL |2.0
DMANflattop|g10|int0 |2|NULL |NULL |20
#
DMANflattop|g10|int1 |0|NULL |NULL |0.9100
#
DMANflattop|g10|int2 |0|NULL |NULL |0.9200
#
DMANflattop|g10|int3 |0|NULL |NULL |1.0e-6
#
#
#
DMANflattop|g11|ctl1 |0|ESY 01-1|VCreg0 |
DMANflattop|g11|read1 |0|MFC 04-1|CR |
#
DMANflattop|g11|int0 |0|NULL |NULL |50.0
DMANflattop|g11|int0 |1|NULL |NULL |2.0
DMANflattop|g11|int0 |2|NULL |NULL |20
#
DMANflattop|g11|int1 |0|NULL |NULL |0.9100
#
DMANflattop|g11|int2 |0|NULL |NULL |0.9200
#
DMANflattop|g11|int3 |0|NULL |NULL |1.0e-6
#
#
#
DMANflattop|g12|ctl1 |0|MBS 01-1|VCreg1 |
DMANflattop|g12|read1 |0|MFC 04-2|CR |
#
DMANflattop|g12|int0 |0|NULL |NULL |0.1
DMANflattop|g12|int0 |1|NULL |NULL |2.0
DMANflattop|g12|int0 |2|NULL |NULL |20
#
DMANflattop|g12|int1 |0|NULL |NULL |0.9100
#
DMANflattop|g12|int2 |0|NULL |NULL |0.9200
#
DMANflattop|g12|int3 |0|NULL |NULL |0.7e-7
#
#
#
DMANflattop|g13|ctl1 |0|ESY 01-1|VCreg1 |
DMANflattop|g13|read1 |0|MFC 04-2|CR |
#
DMANflattop|g13|int0 |0|NULL |NULL |60.0
DMANflattop|g13|int0 |1|NULL |NULL |2.0
DMANflattop|g13|int0 |2|NULL |NULL |20
#
DMANflattop|g13|int1 |0|NULL |NULL |0.9100
#
DMANflattop|g13|int2 |0|NULL |NULL |0.9200
#
DMANflattop|g13|int3 |0|NULL |NULL |0.7e-7
#
#
#
DMANflattop|g14|ctl1 |0|EL 02-1|VC |
DMANflattop|g14|read1 |0|MFC 04-1|CR |
DMANflattop|g14|read1 |1|MFC 04-2|CR |
#
DMANflattop|g14|int0 |0|NULL |NULL |60.0
DMANflattop|g14|int0 |1|NULL |NULL |2.0
DMANflattop|g14|int0 |2|NULL |NULL |20
DMANflattop|g14|int0 |3|NULL |NULL |1
#
DMANflattop|g14|int1 |0|NULL |NULL |0.9100
DMANflattop|g14|int1 |1|NULL |NULL |0.9100
#
DMANflattop|g14|int2 |0|NULL |NULL |0.9200
DMANflattop|g14|int2 |1|NULL |NULL |0.9200
#
DMANflattop|g14|int3 |0|NULL |NULL |0.7e-7
DMANflattop|g14|int3 |1|NULL |NULL |0.7e-9

Notes

the online help is presently sparse... to say the least....

Manual page revision

$Id: DMANflattop.1,v 1.0 2007/08/16 17:22:46 kitchen Exp $

Table of Contents