man1/DBscale_batch

Table of Contents

Name

DBscale_batch - Accelerator parameter batch scaling program

Synopsis

DBscale_batch <type> <value> <db_file_dir> <MNGRconf file> <setup file> <input file> <output file>

Description

This program allows an AccelNET parameter set previously created by another program such as g_request(1) to be scaled for a new set of operating conditions.

It is capable of scaling based on changing the charge state, the total particle energy, the machine energy, the injection energy, and the terminal voltage.

This program is functionaly similiar to DBscale(1) except that is a batch mode program which only allows one parameter to be changed.

Arguments

Argument processing is done using Unix long argument syntax.

The values of all of the parameters listed here (whether or not they were supplied on the command line) may be printed on stderr when the program starts. See the "--verbose" argument.

--dbfiles <pn>

The pathname to the database files

If the environment variables USER_TREE and CONF are both present they are used to compute the pathname of the files like this:

$USER_TREE/db/$CONF/trans

--mngr <fn>

The name of the CONFLIST file to use to load the configuration

default:

SCALEconf

See the CONFIGURATION FILE section below.

--mngr_pn <pn>

The program name to use when parsing the CONFLIST file

default: DBscale

--setup <fn>

This file is a list of AccelNET parameter names and values needed by the program to know the current state of the accelerator.

This argument is required when starting the program.

--env <fn>

The pathname to the scaling environment file This file contains the settings

used by the last invocation of DBscale

If this file exists it is read by the program when it starts. When program settings are changed it is created or overwritten.

This argument is required when starting the program.

--inp <fn>

A file containing a list of AccelNET parameter names and values which are

to be scaled by the program

This argument is required when starting the program.

--out <fn>

The file produced by the program which contains the list of new AccelNET

parameter names and values

This argument is required when starting the program.

--type <name>

The name of the scaling parameter to change.

This argument is required when starting the program.

Valid values for <name> are:

e_total - total particle energy
e_mach - machine particle energy
e_inj - injected particle energy
i_mass - input mass
o_mass - output mass
i_chg - input charge state
o_chg - output charge state

--value <v>

The new value for the chosen scaling.

This argument is required when starting the program.

--verbose=<n>

Normally the program does it’s work silently. This sets the level of logging information. The number is optional but if provided it must include the "=". If no argument is provided the default level is 1.

0 - work silently
1 - print signon msg, option settings

--help
Prints this help message to stderr and exits.

Configuration File

Group 1

Group 1 is used to make associations between a parameter providing a magnetic field reading such as a hall probe or an NMR and a parameter used to provide a field strength command to a magnet.
comm1

The magnetic field output parameter.
read1

The magnetic field input parameter.

Group 2

Group 2 is used for parameters related to the voltage stabilization system (the tps) and the accelerator charging system.
const0

max number of LE shorting rods
const1

max number of HE shorting rods
const2

max column current
const3

max terminal voltage
const4

number of charging chains
const5

charging constant
const10

starting probe QCC
file1

probe position piece table

MNGRconf file example


#
# group 1 - magnet/hall probe associations
#
DBscale|g1|comm1 |0|BM 01-1|MfieldC |
DBscale|g1|read1 |0|HPB 01-1|MfieldR |
#
DBscale|g1|comm1 |2|BM 02-1|MfieldC |
DBscale|g1|read1 |2|HPB 02-1|MfieldR |
#
DBscale|g1|comm1 |5|BM TD-1|MfieldC |
DBscale|g1|read1 |5|HPB TD-1|MfieldR |
#
# group 2 - charging/tps parameters
#
DBscale|g2|const0 |0|9.0 |NULL |
DBscale|g2|const1 |0|9.0 |NULL |
DBscale|g2|const2 |0|50.0 |NULL |
DBscale|g2|const3 |0|3.0 |NULL |
DBscale|g2|const4 |0|2.0 |NULL |
DBscale|g2|const5 |0|3.0 |NULL |
DBscale|g2|const10 |0|25.0 |NULL |
#

Notes

This manual page needs a lot more added to it.

Manual Page Revision

$Id: DBscale_batch.1,v 1.1 2008/05/05 14:52:18 kitchen Exp $

Table of Contents