acd_db_pedestals_create.c File Reference

Creates the include file used to build the loadable shareable image for the ACD pedestals. More...

#include <stdio.h>
#include <stdlib.h>
#include <acd_import.h>
#include <acd_import_pedestals.h>
#include <calib_db_create.h>

Classes
struct	_Ctl
	The ACD include file creation control structure. More...
Typedefs
typedef struct _Ctl	Ctl
	Typedef for struct _Ctl.
Functions
static void	reportUsage (void)
	Brief explanation of the test creation usage.
static void	full_prepare (unsigned int *export, const float pedestals[12][18][2])
	Prepares the imported data for export.
static void	idealized_prepare (unsigned int *export, const float pedestals[2])
	Prepares the imported data for export.
static void	fillCable (unsigned short int *pedestals, const unsigned int *exports)
	Fills one cables worth of pedestals.
static int	writeFile (FILE *hfile, const char *hname, const char *package, const char *constituent, const char *version, CALIB_DB_STYLE_K style, const char *origin_name, const char *style_name, unsigned int key, unsigned int tag, const unsigned int *export)
	Files and writes the output include file.
static int	fillCtl (Ctl *ctl, int argc, char *const argv[])
	Examines the command line parameters and fills the include file creation control structure.
static int	writeCable (FILE *hfile, int cable, const unsigned short int v[18])
	Write one layers worth of constants.
int	AcdDbPedestalsCreate (int argc, char *const argv[], const AcdImportPedestals *import)
	Driver program to create ACD calibration include file.

---

Detailed Description

Creates the include file used to build the loadable shareable image for the ACD pedestals.

Author:

JJRussell - russell@slac.stanford.edu

   CVS $Id: acd_db_pedestals_create.c,v 1.4 2011/03/25 02:40:52 apw Exp $

This program accepts a acd_pedestals.h file and converts it to a representation that is used to by FSW. This portion handles only the pedestals. The gains are done similarly, but by a different program.

The mechanism is fairly clunky, belonging to that ilk of programs whose mission is to write another program. In this case, the pedestal data is written out as data to a C data structure, called the schema. The resulting file is then compiled and built into a shareable image.

In addition to holding the data values, this schema also holds pointers to routines that are used to access the data. This tactic allows the interface to be stable, but effectively hides the internal representation of the data. Because the accessor routine's job is act as a go-between between the caller and the internal data, it must

1. Present a well-defined and stable interface to the user
2. Be privy to the detailed layout of the data

It is this last point that drives the design to include the implementation of these routines at the same time the data is defined. That keeps the two in lock step.

---

Typedef Documentation

Ctl

Typedef for struct _Ctl.

Contains all the parameters controlling the creation and content of the test include file.

---

Function Documentation

int AcdDbPedestalsCreate	(	int	argc,
		char *const	argv[],
		const AcdImportPedestals *	import
	)

Driver program to create ACD calibration include file.

Returns:

Status, if 0, then successfully created the output file

Parameters:

	argc	The count of input arguments
	argv	The vector of input arguments
	import	The imported database

References CALIB_DB_STYLE_K_FULL, CALIB_DB_STYLE_K_IDEALIZED, fillCtl(), full_prepare(), _Ctl::hname, idealized_prepare(), reportUsage(), and writeFile().

static void fillCable	(	unsigned short int *	pedestals,
		const unsigned int *	exports
	)			[static]

Fills one cables worth of pedestals.

Parameters:

	pedestals	The output gain array
	exports	The export data

Referenced by writeFile().

static int fillCtl	(	Ctl *	ctl,
		int	argc,
		char *const	argv[]
	)			[static]

Examines the command line parameters and fills the include file creation control structure.

Parameters:

	ctl	The parameter control block.
	argc	The number of command line parameters.
	argv	The array of pointers to the command line parameters.

Return values:

	0,Everything	is okay.
	-1,Incorrect	command usage. Usually this means that the input file name was absent.

References _Ctl::hname, and reportUsage().

Referenced by AcdDbPedestalsCreate().

static void full_prepare	(	unsigned int *	export,
		const float	pedestals[12][18][2]
	)			[static]

Prepares the imported data for export.

Parameters:

	export	Filled with the data to be exported
	pedestals	The imported pedestal data

Referenced by AcdDbPedestalsCreate().

static void idealized_prepare	(	unsigned int *	export,
		const float	pedestals[2]
	)			[static]

Prepares the imported data for export.

Parameters:

	export	Filled with the data to be exported
	pedestals	The imported pedestal data

Referenced by AcdDbPedestalsCreate().

static int writeCable	(	FILE *	hfile,
		int	cable,
		const unsigned short int	v[18]
	)			[static]

Write one layers worth of constants.

Parameters:

	hfile	The include file handle
	cable	The cable number being written
	v	The 18 pedestals for this cable

Referenced by writeFile().

static int writeFile	(	FILE *	hfile,
		const char *	hname,
		const char *	package,
		const char *	constituent,
		const char *	version,
		CALIB_DB_STYLE_K	style,
		const char *	origin_name,
		const char *	style_name,
		unsigned int	key,
		unsigned int	tag,
		const unsigned int *	export
	)			[static]

Files and writes the output include file.

Returns:

Status

Parameters:

	hfile	The include file handle
	hname	The name of the output file
	package	The package name
	constituent	The constituent name
	version	The schema version number
	style	The style (CALIB_DB_STYLE_K_FULL, CALIB_DB_STYLE_K_IDEALIZED)
	origin_name	The name of the originating data source ("GLEAM", "LAT", etc)
	style_name	The style name ("FULL", "IDEALIZED")
	key	The database's identifying key
	tag	The file's online tag (CMX version for example)
	export	The constants to export

References calib_db_info_write(), calib_db_preamble_write(), CALIB_DB_STYLE_K_FULL, fillCable(), and writeCable().

Referenced by AcdDbPedestalsCreate().