QSTD_samplesPrint.c File Reference

Science Statistics Physics sample print utilities. More...

#include <QSSP/QSTD_sample.h>
#include <QSSP/QSTD_samplesPrint.h>
#include <QSSP/QSTD_labels.h>
#include <time.h>
#include <stdio.h>

Defines
#define	SA_UTB_OFFSET   0x3a4fc880
	The offset between Spectrum-Astro Epoch and UTB.
Functions
static void	print_separator (int cnt)
	Prints a standard separator line.
static void	print_titles_v0 (const QSTD_sampleV0 *samples, int beg, int cnt)
	Prints the title line for the specified array of samples.
static int	print_vals_ull (const char *label, const char *format, const unsigned long long int *val, int cnt, int stride)
	Print the specified series of 64-bit integers properly spaced, i.e. stride, values.
static int	print_vals_ui (const char *label, const char *format, const unsigned int *val, int cnt, int stride)
	Print the specified series of integers properly spaced, i.e. stride, values.
static void	print_point_v0 (const QSSP_pointV0 *point, int which, int cnt, int stride)
	Prints the sample header for the specified array of samples.
static void	print_epoints_v0 (const QSTD_sampleV0 *samples, int cnt)
	Prints the elapsed information from the sample headers for the specified array of samples.
static void	print_points_v0 (const QSSP_pointV0 *points, int cnt, int stride)
	Prints the QSSP_pointV0 structure.
static void	print_counts_v0 (const QSTD_sampleV0 *samples, int cnt)
	Prints the QSTD_sampleV0.
static void	print_stats_v0 (const QSTD_statisticsV0 *statistics, int cnt, int stride, const QSTD_labels *labels)
	Prints the statistics counters of the specified array of samples.
void	QSTD_samplesPrint (const QSTD_sample *samples, int version, int beg, int cnt, const QSTD_labels *labels)
	Prints the specified list of samples.
Variables
static const char	Hxl [] = " %11llx"
static const char	Hex [] = " %8.8x"
static const char	Ui [] = " %8u"

---

Detailed Description

Science Statistics Physics sample print utilities.

Author:

JJRussell - russell@slac.stanford.edu

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

---

Define Documentation

#define SA_UTB_OFFSET   0x3a4fc880

The offset between Spectrum-Astro Epoch and UTB.

Parameters:

SA_UTB_OFFSET

Referenced by print_epoints_v0().

---

Function Documentation

static void print_counts_v0	(	const QSTD_sampleV0 *	samples,
		int	cnt
	)			[static]

Prints the QSTD_sampleV0.

Parameters:

	samples	The array of samples to print the sample points for
	cnt	The count of samples

Versions < 2 did not track the counts, so only the number actually used is available, and that only as a derived number.

Referenced by QSTD_samplesPrint().

static void print_epoints_v0	(	const QSTD_sampleV0 *	samples,
		int	cnt
	)			[static]

Prints the elapsed information from the sample headers for the specified array of samples.

Parameters:

	samples	The array of samples to print
	cnt	The count of samples

References _QSSP_spanV0::esequence, _QSSP_spanV0::etime, _QSSP_spanV0::points, SA_UTB_OFFSET, _QSTD_sampleV0::span, _QSSP_pointV0::time, and _QSSP_pointV0::timetones.

Referenced by QSTD_samplesPrint().

static void print_point_v0	(	const QSSP_pointV0 *	point,
		int	which,
		int	cnt,
		int	stride
	)			[static]

Prints the sample header for the specified array of samples.

Parameters:

	point	The array of points to print
	which	Which herder to print 0 = beginning 1 = ending
	cnt	The count of samples
	stride	The stride, in bytes, between points

References _QSSP_pointV0::gemClock, print_vals_ui(), print_vals_ull(), _QSSP_pointV0::relative, _QSSP_pointV0::sequence, and _QSSP_pointV0::timetones.

Referenced by print_points_v0().

static void print_points_v0	(	const QSSP_pointV0 *	points,
		int	cnt,
		int	stride
	)			[static]

Prints the QSSP_pointV0 structure.

Parameters:

	points	The array of points to print
	cnt	The count of points
	stride	The stride, in bytes, between pairs

References print_point_v0().

Referenced by QSTD_samplesPrint().

static void print_separator

(

int

cnt

)

[static]

Prints a standard separator line.

Parameters:

cnt

The number of records

Referenced by print_titles_v0(), and QSTD_samplesPrint().

static void print_stats_v0	(	const QSTD_statisticsV0 *	stats,
		int	cnt,
		int	stride,
		const QSTD_labels *	labels
	)			[static]

Prints the statistics counters of the specified array of samples.

Parameters:

	stats	The array of statistics to print
	cnt	The count of samples
	stride	The stride, in bytes, between statistics sets
	labels	The soure of titles for the statistics counters

Referenced by QSTD_samplesPrint().

static void print_titles_v0	(	const QSTD_sampleV0 *	samples,
		int	beg,
		int	cnt
	)			[static]

Prints the title line for the specified array of samples.

Parameters:

	samples	The array of samples to print
	beg	The record number of the first sample
	cnt	The count of samples

References print_separator(), QSTD_TYPE_K_CUMULATIVE_BEG, QSTD_TYPE_K_CUMULATIVE_END, QSTD_TYPE_K_INCREMENTAL, and _QSTD_sampleV0::type.

Referenced by QSTD_samplesPrint().

static int print_vals_ui	(	const char *	label,
		const char *	format,
		const unsigned int *	val,
		int	cnt,
		int	stride
	)			[static]

Print the specified series of integers properly spaced, i.e. stride, values.

Returns:

The number of characters printed, less the new line

Parameters:

	label	The name/label of the values
	format	The format statement
	val	Pointer to the first value
	cnt	The number of values
	stride	The stride, in bytes, between values

Referenced by print_point_v0().

static int print_vals_ull	(	const char *	label,
		const char *	format,
		const unsigned long long int *	val,
		int	cnt,
		int	stride
	)			[static]

Print the specified series of 64-bit integers properly spaced, i.e. stride, values.

Returns:

The number of characters printed, less the new line

Parameters:

	label	The name/label of the values
	format	The format statement
	val	Pointer to the first value
	cnt	The number of values
	stride	The stride, in bytes, between values

Referenced by print_point_v0().

void QSTD_samplesPrint	(	const QSTD_sample *	samples,
		int	version,
		int	beg,
		int	cnt,
		const QSTD_labels *	labels
	)

Prints the specified list of samples.

Parameters:

	samples	The array of samples to print
	version	The sample version (only of the statistics schema)
	beg	The record number of the first sample
	cnt	The count of samples
	labels	The labels of the statistics counters

References _QSSP_spanV0::points, print_counts_v0(), print_epoints_v0(), print_points_v0(), print_separator(), print_stats_v0(), print_titles_v0(), _QSTD_sampleV0::span, _QSTD_sampleV0::stats, and _QSTD_sample::v0.