man3scale/libscale

Table of Contents

Name

libscale - accelerator scaling functions

Description

libscale is a collection of functions used for scaling accelerator parameters to new values.

Config Table Usage

mngrlib(3mngr) functions and a configuration table are used to provide access to many of the user tunable parameters in the library.

Magnetic components

Configuration group 1 ( CFG1 ) is used to associate a device used to read a magnetic field with the appropriate control used to change the field.

The readback is a field reading parameter ( MfieldR ) from a hall probe or an NMR. It uses read1 in the configuration file.

The control is usually the MfieldC control associated with the bending magnet. It uses comm1 in the configuration file.

The index field is used to associate comm1 and read1. i.e both have the same index value.

If the parameter is a device such as a magnetic steerer or a magnetic quadrupole no such association needs to be made in the configuration table and the control will be scaled using the formula for magnetic scaling.

Electrostatic components

Charging system / TPS components

There are several constants associated with the charging system and TPS. CFG2 is used for them.
const0

The maximum number of LE shorting rods which can be placed in the accelerator.
const1

The maximum number of HE shorting rods which can be placed in the accelerator.
const2

The maximum column current.
const3

The maximum terminal voltage.
const4

The number of charging chains in the system.
const5

The chain constant. This is expressed as the uA of charging current per KV of charging voltage. For example: 3.0 = 3uA/1kV.
const10

Initial value for probe quiescient current.
file1

The TPS probe piece table

Note that the usage of this may be a little strange and maybe it will go way therefore I gave it a high const number so that if it is eliminated other items won’t have to change assignments in the mngr conf file. - rlk 1/16/2001

Functions

See scalelib.h for a list of the functions contained in the library. See the manual page for each function for a description and argument usage.

Configuration 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 |1|BM 01-2|MfieldC |
DBscale|g1|comm2 |1|BM 01-2|ClearSC |
#
DBscale|g1|comm1 |2|BM 02-1|MfieldC |
DBscale|g1|read1 |2|HPB 02-1|MfieldR |

Notes

The manual pages for the functions haven’t been written yet.

Yes, this manual page is inadequate..... but what else is new.

Manual page revision

$Id: libscale.3,v 1.2 2002/04/07 19:18:06 kitchen Exp $


Table of Contents