qsep_select.c File Reference

QSEP specific event selection utilities. More...

#include <qsep_select.h>
#include <EDS/ESS.h>
#include <stdio.h>

Functions
int	qsep_select_parse_size (ESS_ctl *ess, const char *s)
	Chooses which is the relevant event size, the datagram size or the expanded EBF size.
void	qsep_select_usage (int which)
	Prints the selection usage explanations.
Variables
static const char	Select_Condition_Usage []
	String for defining a GEM Pattern Condition specifier. This is meant to be used when reporting the usage of this specifier.
static const char	Select_Readout_Usage []
	String for defining a readout specifier. This maybe used to select only events that are, for example Zero-suppressed events Zero-suppressed, single range events Non-zero suppressed four range readout events.
static const char	Select_Range_Usage []
	String for defining a range specifier. This is meant to be used when reporting the usage of this specifier.

---

Detailed Description

QSEP specific event selection utilities.

Author:

JJRussell - russell@slac.stanford.edu

   CVS $Id: qsep_select.c,v 1.2 2011/03/29 18:49:04 russell Exp $

---

Function Documentation

static int qsep_select_parse_size	(	ESS_ctl *	ess,
		const char *	s
	)

Chooses which is the relevant event size, the datagram size or the expanded EBF size.

Parameters:

	ess	The Event Selection control handle
	s	The options string to parse.

If the first character of the options string is

• D, then use datagram size
• E or anything else, then use the expanded EBF size.

Referenced by get_ctl().

void qsep_select_usage

(

int

which

)

Prints the selection usage explanations.

Parameters:

which

Which string to print 0 The basic terse explanation 1 The full explanation

References Select_Condition_Usage, Select_Range_Usage, and Select_Readout_Usage.

Referenced by report_usage().

---

Variable Documentation

const char Select_Range_Usage [static]

Initial value:

"  Range Selection Definition\n"
"  --------------------------\n"
"  A range can be specified as\n"
"    1. A single positive number, indicating an inclusive lower limit\n"
"    2. A single negative number, indicating an inclusive upper limit\n"
"    3. An = followed by a single number, indicates precisely that number\n"
"    4. A pair of numbers separated by a ',' or ':', indicating an \n"
"       inclusive range\n"
"\n"
"  Examples using the event size selection -S:\n"
"    -S1000      Select events with EBF size >= 1000 bytes\n"
"    -S-1000     Select events with EBF size <= 1000 bytes\n"
"    -S1000:2000 Select events with EBF size  =[1000 - 2000] bytes\n"
"    -S=4000     Select events with EBF size  = 4000 bytes or\n"
"    -S4000:4000 Select events with EBF size  = 4000 bytes\n"

String for defining a range specifier. This is meant to be used when reporting the usage of this specifier.

Referenced by qsep_select_usage().

const char Select_Readout_Usage [static]

Initial value:

"  Readout Selection Definition\n"
"  --------------------------\n"
"  A readout selection can be specified to select\n"
"    1. Zero-suppressed events    (-Rz)\n"
"    2. Nonzero-suppressed events (-Rn)\n"
"    3. Single-range readout      (-R1)\n"
"    4. Four-range readout        (-R4)\n"
"\n"
"  These may be appear in any combination, for example\n"
   "    -Rz1 - Selects zero-suppressed     single-range events\n"
"    -Rz4 - Selects zero-suppressed       four-range events\n"
"    -Rn1 - Selects non-zero suppressed single-range events\n"
"    -Rn4 - Selects non-zero suppressed   four-range events\n"
"\n"
"  Note that combinations are allowed, but unnecessarily verbose\n"
"    -Rz14 is equivalent to -Rz\n"
"    -Rnz & -R14 are equivalent to not specifying the default, i.e all\n"

String for defining a readout specifier. This maybe used to select only events that are, for example

• Zero-suppressed events
• Zero-suppressed, single range events
• Non-zero suppressed four range readout events.

Referenced by qsep_select_usage().