////////////////////////////////////////////////////////////////////
///
///
/// \brief  Calibration source run level information.
///
///
/// \author J. Maneira <maneira@lip.pt>
/// \auhtor G. Prior <gersende@lip.pt>
///
/// REVISION HISTORY: 2016-11-21 J. Maneira, G. Prior - split from LASERBALL.ratcb to separate
///                              run-level info in file writable by the near-line
///
///
/// \details  Position and other parameters describing the status of calibration
///           sources on a given run.
///
////////////////////////////////////////////////////////////////////////
//* Specify the parameters for the position, orientation and source type, from manip
{
type: "CALIB_COMMON_RUN_LEVEL",
index: "MANIP"
version: 2,
run_range: [0, 0],
pass: 0,
comment: "",
timestamp: "",

source_type:                "LASERBALL",
source_version:             "OLDSNO02",

position_valid:       true, // bool
position_bitmask:     0, // 0 = no errors; bits describe the error (high tension, low tension, not stopped,...)
position:             [0.0, 0.0, 0.0], // float, in mm, center of source/decay chamber/etc...
position_pivot:       [0.0, 0.0, 0.0], // float, in mm, where ropes attach, in case of manip
err_position:         [0.0, 0.0, 0.0], // rms of position. float, in mm
orientation:          0.0, //Float: Phi in units of Pi/2: Manip: 0 (default - East), 1 (N), 2 (W), 3 (S)

}
//* Specify the parameters for the position, orientation and source type, from manip
{
type: "CALIB_COMMON_RUN_LEVEL",
index: "CAMERA"
version: 2,
run_range: [0, 0],
pass: 0,
comment: "",
timestamp: "",

source_type:                "LASERBALL",
source_version:             "OLDSNO02",

position_valid:       true, // bool
position_bitmask:     0, // 0 = no errors; bits describe the error (high tension, low tension, not stopped,...)
position:             [0.0, 0.0, 0.0], // float, in mm, center of source/decay chamber/etc...
position_pivot:       [0.0, 0.0, 0.0], // float, in mm, TBD. where ropes attach or LEDs flash?
err_position:         [0.0, 0.0, 0.0], // rms of position. float, in mm
orientation:          0.0, //Float: Phi in units of Pi/2: Manip: 0 (default - East), 1 (N), 2 (W), 3 (S)

}


//* Specify the parameters for the N2dye laser
{
type: "N2DYELASER_RUN_LEVEL",
version: 1,
run_range: [0, 0],
pass: 0,
comment: "",
timestamp: "",

n2laser_valid:              true,
n2laser_bitmask:            0, // 0 = no errors; bits describe the error (power off, low N2 pressure, low n2 flow...)
n2laser_rate:               30.0, // (in Hz) (data only) Float: rate of N2 laser

dyelaser_valid:             true,
dyelaser_bitmask:           0, // 0 = no errors; bits describe the error (stir motors off, mirror not stopped...)
dyelaser_cell_nbr:          4,  //Integer: range 0-5
dyelaser_cell_set:          "DEFAULT",  //String; could be "WATERPHASE", "SCINTPHASE"
dyelaser_wl:                500,  //Integer (directly from manip)

ndfilter_valid:             true,
ndfilter_bitmask:           0, // 0 = no errors; bits describe the error (moving, beam blocked,...)
ndfilter1:                  0, // integer: id of filter in filter wheel 1
ndfilter2:                  0, // integer: id of filter in filter wheel 2
neutral_density:            0.0 // float: compound neutral density of both filters

}