ADCs Package for Sunsort

Relies on: Structure Sunsort
C include file: hitsubs.h
FORTRAN include files: subs.i and hitsubs.i

This package uses the variable adcnum in the struct detectors type provided by the package Structure. It activates it to mean the adc associated with that node in the tree. It is initialised to -1.

Routines

int loadadcs(struct detector *dp, char *filename, int tdcoffset);
integer function (character*(*) filename, integer tdcoffset)

This routine loads the adc values from the specified file into the structure. Only nodes whose names begin with signal are considered candidates for loading. If tdcoffset is set to zero then the routine expects every signal to have a number in the file. If tdcoffset is non-zero then only every other signal is read from the file, the others are set to the last value read plus tdcoffset. This routine expects there to be at least as many numbers in the file as nodes called 'signal...'. It returns 0 for a successful load, and non-zero for an error.

In the input file, anything from a !, # or * to the end of a line is ignored.

In the C routine, dp should point to the top of the tree that you wish to load. You may load part of a tree by specifying a pointer partway down the tree. In FORTRAN this routine always loads the whole of the default tree.

FORTRAN only routines

integer function getadcnum(...), getthisadcnum()

Return the adcnum for the specified node, the specification is the same as that described for the get routines in package Structure.

subroutine setadcnum(integer value, ...), subroutine setthisadcnum(integer value)

Set the adcnum variable for a node. The specification is the same as in the get routines, however, note that in setadcnum the value comes before the reference (for example, call setadcnum(67,'%.%.signalbt',2,3) would set adcnum in the node given in the structure package description as an example reference to 67).