QASC_samplePrint.c File Reference

Development/debug routine to print one ACD counter statistics sample. More...

#include <QSSP/QASC_samplePrint.h>
#include <QSSP/QASC_sample.h>
#include <QSSP/QSSP_spanPrint.h>
#include <stdio.h>

Defines
#define	__U8__   "%8u"
	Used to fill the space of 8 characters for a 8u formatting string. This keeps the format statement visually aligned.
Functions
static void	printMonitorV0 (const QASC_monitorV0 *monitor)
	Prints the accumulation (mainly timing) monitoring statistics.
static void	printSummaryV0 (const QASC_summaryV0 *summary)
	Prints the summary statistics block.
static void	printCnosV0 (const QASC_cnoHistogramV0 *cnos)
	Prints the CNO statistics block.
static void	printTilesV0 (const QASC_tileHistogramV0 *tiles)
	Prints the full statistics array fro the GEM/AEM counts.
static void	printHdrV0 (const char *name, int c, int cnt)
	Prints a header line for each ACD list, ie one of XZ, YZ, XY, RU.
static void	printRowV0 (const QASC_tileHistogramV0 *hists, int bin, int cnt)
	Prints one row (pattern fixed) of statistics.
void	QASC_samplePrint (const QASC_sample *sample, int version, unsigned int options)
	Prints the statistics counters.
static __inline unsigned int	to_nsecs (unsigned int ticks, unsigned int frequency)
	Uses the specified frequency to convert the ticks to nanoseconds.

---

Detailed Description

Development/debug routine to print one ACD counter statistics sample.

Author:

JJRussell - russell@slac.stanford.edu

CVS $Id: QASC_samplePrint.c,v 1.2 2011/03/29 00:14:57 russell Exp $

---

Function Documentation

static void printCnosV0

(

const QASC_cnoHistogramV0 *

cnos

)

[static]

Prints the CNO statistics block.

Parameters:

cnos

The 6 CNO statistics block to print

The CNO statistics blocks consists of 4 entries per board pair. A board pair is matching A/B pair. The statistics count the number of times only the A end is active, only the B end is active and the nubmer of times there is a coincidence between the two. Accumulation of the number of times neither is struck is deemed to be a waste of time since this number is just the difference of the total number of events seen (available in the summary statistics block) and the some of the just mentioned three numbers.

Referenced by QASC_samplePrint().

static void printHdrV0	(	const char *	name,
		int	c,
		int	cnt
	)			[static]

Prints a header line for each ACD list, ie one of XZ, YZ, XY, RU.

Parameters:

	name	The name of the list (XZ, YZ, XY, RU)
	c	Beginning channel index
	cnt	The number of channels to print

Referenced by printTilesV0().

static void printMonitorV0

(

const QASC_monitorV0 *

monitor

)

[static]

Prints the accumulation (mainly timing) monitoring statistics.

Parameters:

monitor

The monitoring information to print

References _QASC_monitorV0::eacc, _QASC_monitorV0::ecompress, _QASC_monitorV0::edir, _QASC_monitorV0::etotal, _QASC_monitorV0::eunpack, _QASC_monitorV0::frequency, _QASC_monitorV0::nmissed, _QASC_monitorV0::nsampled, _QASC_monitorV0::nused, and to_nsecs().

Referenced by QASC_samplePrint().

static void printRowV0	(	const QASC_tileHistogramV0 *	hists,
		int	bin,
		int	cnt
	)			[static]

Prints one row (pattern fixed) of statistics.

Parameters:

	hists	The histograms for the channels to be printed
	bin	The bin to be printed
	cnt	The number of channels to print

References QASC_TILEBINV0_M_HA, QASC_TILEBINV0_M_HB, QASC_TILEBINV0_M_PA, QASC_TILEBINV0_M_PB, and QASC_TILEBINV0_M_V.

Referenced by printTilesV0().

static void printSummaryV0

(

const QASC_summaryV0 *

summary

)

[static]

Prints the summary statistics block.

Parameters:

summary

The summary statistics block to print

References __U8__, and _QASC_summaryV0::stats.

Referenced by QASC_samplePrint().

static void printTilesV0

(

const QASC_tileHistogramV0 *

tiles

)

[static]

Prints the full statistics array fro the GEM/AEM counts.

Parameters:

tiles

The tile hisograms

References printHdrV0(), and printRowV0().

Referenced by QASC_samplePrint().

void QASC_samplePrint	(	const QASC_sample *	sample,
		int	version,
		unsigned int	options
	)

Prints the statistics counters.

Parameters:

	sample	The sample to print
	version	The sample version to print
	options	Print options,

See also:

QSSP_PRINT_M

References _QASC_statisticsV0::cnos, _QASC_sampleV0::monitor, printCnosV0(), printMonitorV0(), printSummaryV0(), printTilesV0(), QASC_PRINT_M_CNO, QASC_PRINT_M_HDR, QASC_PRINT_M_MONITOR, QASC_PRINT_M_SUMMARY, QASC_PRINT_M_TILE, QSSP_spanV1Print(), _QASC_sampleV0::span, _QASC_sampleV0::statistics, _QASC_statisticsV0::summary, _QASC_statisticsV0::tiles, and _QASC_sample::v0.

static __inline unsigned int to_nsecs	(	unsigned int	ticks,
		unsigned int	frequency
	)			[static]

Uses the specified frequency to convert the ticks to nanoseconds.

Returns:

The convert time in nanoseconds.

Parameters:

	ticks	The number of CPU clock ticks to convert
	frequency	The frequency of the CPU clock

If the frequency is specified as 0, the value ticks is returned.

Referenced by printMonitorV0().