fesConvert.h File Reference

Definitions for FES data conversion. More...

Enumerations
enum	{   CVO_LOCAL = 0x01,   CVO_FLOOD = 0x02,   CVO_MCDATA = 0x04,   CVO_DMYEVT = 0x08,   CVO_VERBOSE = 0x10,   CVO_TRIGGER = 0x20,   CVO_MARKERS = 0x40,   CVO_AUTORNG = 0x80,   CVO_PKTDATA = 0x4000,   CVO_CALIB = 0x8000,   CVO_V_APIDS = 16,   CVO_M_APIDS = 0x0f0000 }
	Processing options. More...
enum	{   CNV_LPA_APID_BASE = 0x3bb,   CNV_LCI_APID_BASE = 0x3c5,   CNV_APID_COUNT = 4 }
	APID values. More...
Functions
int	fesConvert (const char *eName, int nSkip, int nProc, int versn, const char *fName, long long bMask, int optns, int action)
	Convert event data file to FES format.

---

Detailed Description

Definitions for FES data conversion.

Author:

Owen H Saxton

$Id: fesConvert.h,v 1.6 2010/07/26 18:47:14 saxton Exp $

---

Enumeration Type Documentation

anonymous enum

Processing options.

Enumerator:

CVO_LOCAL	Write output locally.
CVO_FLOOD	Allow unlimited tracker hits.
CVO_MCDATA	Pass monte carlo data through.
CVO_DMYEVT	Insert dummy event at the beginning.
CVO_VERBOSE	Show extra statistics at the end.
CVO_TRIGGER	Ignore events with no triggers.
CVO_MARKERS	Process marker events.
CVO_AUTORNG	Auto-range CAL data.
CVO_PKTDATA	Read packet data, not EBF.
CVO_CALIB	Packet data is calibration.
CVO_V_APIDS	Bit offset to APID mask.
CVO_M_APIDS	Mask of APID bits.

anonymous enum

APID values.

Enumerator:

CNV_LPA_APID_BASE	Physics data APID base.
CNV_LCI_APID_BASE	Calibration data APID base.
CNV_APID_COUNT	The number of contiguous APIDs.

---

Function Documentation

int fesConvert	(	const char *	iName,
		int	nSkip,
		int	nProc,
		int	versn,
		const char *	oName,
		long long	bMask,
		int	optns,
		int	action
	)

Convert event data file to FES format.

This routine generates a set of FES data files from a supplied EBF or packet event data file.

Parameters:

	iName	The address of the name of the input data file.
	nSkip	The number of events to be skipped at the beginning of the input file.
	nProc	The number of events to process from the input file. If zero or negative, all events (after passing the skip count) are processed.
	versn	The format version of data to be generated: 0: Cable-ready data 1: Detector-oriented data 2: Cable-ready data with event times 3: Detector-oriented data with event times
	oName	The address of the name of the output file stem, i.e. without disk name or extension, to be used for the generated files.
	bMask	A 40-bit mask which, if non-zero, selects which boards of the full set are to have their files loaded. Bits 0 - 15 select tracker boards 0 - 15; bits 16 - 31 select calorimeter boards 0 - 15; bits 32 - 39 select ACD boards 0 - 7.
	optns	A bit mask of processing options. The following bit values are defined: CVO_PKTDATA: The input file contains packet data. CVO_CALIB: The packet data is calibration. CVO_M_APIDS: The mask of APIDs to use in packet data. CVO_LOCAL: The output data files are written to the local (Unix) node instead of to the appropriate FES PC nodes. CVO_FLOOD: Enforcement of the 128 tracker hits per cable limit is relaxed. CVO_MCDATA: Pass through Monte Carlo and other data via non-assigned ACD channels. CVO_DMYEVT: Insert dummy event at beginning. CVO_VERBOSE: Display extra statistics at the end. CVO_TRIGGER: Ignore events with no triggers. CVO_MARKERS: Process marker events CVO_AUTORNG: Re-order CAL ranges to put optimal range first.
	action	Specifies what to do if a file already exists: < 0: Do not overwrite it 0: Prompt user for action > 0: Overwrite it

Return values:

	FES_SUCCESS	Success.
	FES_EFILOPEN	Unable to open input file.

References CVO_PKTDATA, and CVO_VERBOSE.