Summary

The fesdata program is used to carry out operations on data files residing either on the local Unix system or on any of the FES PCs. Because it takes many coordinated data files, one for each detector element, to hold the data for a single run, many of the data file operations involve such a complete set of data, and all of them can operate on at least a subset of these files. The available operations are the generation of a standard set of test data, the conversion of EBF or packet data to FES format, the display of FES data files, the display of information about a set of data files, the loading of a set of data files to their respective FES PCs, the joining of sets of local data files, and the deletion and renaming of sets of data files.

Synopsis

fesdata command options parameters

Commands

The commands that can be executed by the program are listed below. Each may be abbreviated to its shortest unique form.

show	Show summary information about data file sets.
disp	Display the contents of one or more data files.
gen	Generate a set of standard test data files.
gentrig	Generate a set of trigger test data files.
genped	Generate a set of standard pedestal data files.
convert	Convert a file of EBF or packet data to a set of FES data files.
load	Load one or more sets of data files onto the FES PCs.
join	Join one or more sets of data files locally.
delete	Delete one or more sets of data files.
rename	Rename a set of data files.
help	Show usage information about commands.

Options

The possible options and the commands that use them are described below. If multiple options conflict, the last one specified is used.

-A	Process marker events (instead of dropping them).	convert
-a	Pass auxilliary (Monte Carlo) data through.	convert
-b	Display brief or summary information only.	show, disp
-c cfg-file	The configuration file name (if not default).	all
-d detc-name	Use file for detector (board) detc-name.	disp, convert, load, join, rename
-E	Display only event transition records.	disp
-e nevent	The number of events to generate (default 100).	gen
-f format	The format version: 0 - cable-ready; 1 - detector oriented; 2 - cable-ready with times (default); 3 - detector oriented with times.	gen, convert
-g ngrps	The number of calibration groups to generate (default 1).	gen
-I	Display records non-interactively (no pausing).	disp
-i intvl	The interval (50 ns units) between events (default 20K).	gen
-K APIDs	Convert a file of packet data (instead of an EBF file) using the specified APIDs. The latter is generally a comma-separated list but the special designations "p" and "c" may be used to specify the standard APIDs for physics and calibration data respectively.	convert
-k nskip	Skip nskip records or events before displaying or converting (default 0).	disp, convert
-L	Generate large events.	gen
-M	Generate medium-sized events.	gen
-m detc-mask	Use files for boards with set bits in detc-mask.	disp, convert, load, join, rename
-N	Suppress the display of null transitions.	disp
-n node-name	The name of the node to use (default all FES PCs).	show, gen, gentrig, genped, delete
-O	Overwrite existing data sets without prompting, verbosely.	gen, gentrig, genped, convert
-P	Preserve existing data sets, verbosely.	gen, gentrig, genped, convert
-p	Display full path name for each file.	show
-q	Delete data sets without prompting, silently.	delete
-R	Auto-range CAL events by putting the best range first.	convert
-r ndisp	Display or convert ndisp records or events (default -1 for display and 0 for convert, i.e. all).	disp, convert
-S	Generate small events.	gen
-s	Search tree below each matching directory.	show, delete
-T	Display file totals.	disp
-t type	The type of data to generate: 0 (default) - standard; 1 - encoded event numbers; 2 - use pedestals; 3 - calibration.	gen
-u	Use local Unix node instead of PCs.	show, convert, delete
-V	Display trigger counters at the end (verbose).	convert
-v	Delete data sets without prompting, verbosely.	delete
-x	Convert extended (> 128 hits per cable) tracker events without truncation.	convert
-z	Insert a dummy time alignment event at the beginning of the data.	convert

Parameters

The possible parameters and the commands that use them are:

file-patt	The name of the file stem pattern to be used. For the local Unix machine this consists of the relative or absolute path name, with the file type omitted. For an FES PC, it is the absolute path name (no node or disk name) with the file type omitted. All components may contain the standard wild-card characters "?" and "*".	show, delete
file-name	The name of the file to be used. For a file on the local machine, this consists of either a relative or absolute path name. For a file on an FES PC, the name must be prefixed by the node and disk names, separated by a colon.	disp, gentrig
file-stem	The name of the file stem to be used. For the local machine this consists of the relative or absolute path name, with the file type omitted. For an FES PC, it is the absolute path name (no node or disk name) with the file type omitted.	disp, gen, gentrig, genped, convert, load, join, rename
command	The command name or its unique abbreviation.	help

Detailed Command Descriptions

show [-usbp] [-c cfg-file] [-n node-name] file-patt
	Displays a list of all file sets matching file-patt in a case-insensitive way, sorted by name. The -n option restricts the list to files on the specified PC, instead of using all PCs. The -u option causes the local Unix file system to be used instead of disks on the FES PCs. The -s option causes the entire directory tree below any matching directories to be searched for matching files. The output normally lists matching non-empty directory names, each followed by a line for each matching file in that directory containing the average size of the files in the set, the date of the oldest file in the set, the mask of detectors which have files in the set, and the bare file stem. The -p option causes the separate directory lines to be omitted, and the directory name prepended to each file stem. The -b option causes the size and date to be omitted from each line.
disp [-bEITN] [-c cfg-file] [-r ndisp] [-k nskip] file-name
disp [-bEITN] [-c cfg-file] [-r ndisp] [-k nskip] [-d detc-name] [-m detc-mask] file-stem
	Displays the contents of the specified FES data file(s), formatting each record according to its type. Without either the -d or the -m option, the parameter is a file name. If either -d or -m is specified, the parameter is a file stem and multiple files are displayed in parallel if the mask contains more than one set bit. The -E option restricts the display to event records only. The -N option suppresses the display of null transition records. The -r and -k options cause only a subsection of the file(s) to be displayed, and count event records if the -E option is present. Normally the display is done interactively, pausing after each record (or set of records for multiple files) to ask for continuation. The -I option allows the display to proceed without pausing.
gen [-SMLOP] [-c cfg-file] [-e nevent] [-f format] [-g ngrps] [-t type] [-i intvl] [-n node-name] file-stem
	Generates a set of files of standard test data on the FES PCs. The -n option restricts the files to a single PC instead of using all of them. The -O and -P options allow existing files to be overwritten or preserved, respectively, without prompting. The remaining options control the event size (or the number of calibration groups), the number of events, the type and format of the events and the interval between them.
gentrig [-OP] [-c cfg-file] [-n node-name] file-name file-stem
	Generates a set of files on the FES PCs of trigger test data using file-name as input. The -n option restricts the files to a single PC instead of using all of them. The -O and -P options allow existing files to be overwritten or preserved, respectively, without prompting.
genped [-OP] [-c cfg-file] [-n node-name] file-stem
	Generates a set of files of standard pedestal data on the FES PCs. The -n option restricts the files to a single PC instead of using all of them. The -O and -P options allow existing files to be overwritten or preserved, respectively, without prompting.
convert [-auxzOPRV] [-c cfg-file] [-d detc-name] [-m detc-mask] [-K APIDs] [-r nconv] [-k nskip] file-name file-stem
	Converts a file of EBF or packet data to a set of files stored locally or on the FES PCs using file-name as input. The -K option specifies that a packet data file is to be converted, and supplies the list of APIds to use; otherwise the input file must be EBF data. Normally the data for all detectors is converted, but a subset may be selected via the -d or -m options. These options require some caution since any error in an input event causes that event to be omitted from the output. If a subset of the detectors is being used, an error may be overlooked. The -r and -k options are used to convert only a portion of the events in the input file. The -x option allows events with more than 128 tracker hits on a cable to be converted without truncation (up to 512 hits). The -R option causes four-range CAL data to be auto-ranged, putting the most sensitive non-saturated range first. The -u option causes the files to be generated on the Unix file system instead of on disks on the FES PCs. The -a option causes the auxilliary (Monte Carlo) data to be encoded as 12-bit PHA values for the 22 non-assigned ACD channels. The -z option causes a dummy time alignment event to be inserted at the beginning, before the real data. The -O and -P options allow existing files to be overwritten or preserved, respectively, without prompting. The -V (verbose) option causes the trigger counters to be displayed at the end of the conversion.
load [-c cfg-file] [-d detc-name] [-m detc-mask] file-stem-out file-stem-in-1... file-stem-in-n
	Loads one or more data file sets from the local Unix file system onto FES PCs, concatenating multiple sets into a single one. Normally the data for all detectors is loaded, but a subset may be selected via the -d and -m options. If any of the input file stems consists of only a directory, the file name proper is taken from the output stem.
join [-c cfg-file] [-d detc-name] [-m detc-mask] file-stem-out file-stem-in-1... file-stem-in-n
	Copies a data file set locally or joins several such sets. Normally the data for all detectors is copied or joined, but a subset may be selected via the -d and -m options. If any of the input file stems consists of only a directory, the file name proper is taken from the output stem.
delete [-usqv] [-c cfg-file] [-n node-name] file-patt
	Deletes all file sets matching file-patt in a case-sensitive way. The -n option restricts the deletion to files on the specified PC, instead of using all PCs. The -u option causes the local Unix file system to be used instead of disks on the FES PCs. The -s option causes the entire directory tree below any matching directories to be searched for matching files. Normally the user is prompted for confirmation before each file set is deleted, but this behaviour can be changed via the -q and -v options. When prompted, several possible responses are available: y - delete the file; a - delete the file and all other matching ones without further confirmation, displaying the results; q - don't delete any more files; n (or anything else) - don't delete this file.
rename [-c cfg-file] [-d detc-name] [-m detc-mask] file-stem file-stem-new
	Renames a data file set either locally or on the FES PCs. Normally the files for all detectors are renamed, but a subset may be selected via the -d and -m options. The files are assumed to reside on the FES PCs unless the file stem starts with "/", "./" or "../". If the new file stem consists only of a directory path (i.e. it ends with "/"), the files are renamed into this directory (which must exist). If the new file stem consists only of a bare file name, the files are renamed within their original directories (or directory).
help [command]
	If command is specified, summarizes it. Otherwise gives a brief summary of all commands.