Data Analysis - General Parameters

From Xem2
Jump to navigationJump to search

General Parameters

General parameters are broken into two categories; parameters that are not spectrometer specific, and those that are spectrometer specific.

  • All general parameters are included using the general.param file, which is spectrometer specific. The general.param file is located at:
DBASE/<spec>/
  • Global general parameters used for the hall C beamline and debug modes are stored in:
PARAM/GEN/ directory.
  • Spectrometer specific general parameters are included at:
PARAM/SHMS/GEN/
PARAM/HMS/GEN/

Non-Spectrometer General Parameters

As the name implies, these do not deal with the specific spectrometer, but rather the beamline or target componenets. There used to be energy loss parameters included in this directory for the old Fortran analyzer. The C++ analyzer no longer calculates energy loss, so the variables associated with energy loss have been removed.
The main parameters of this section are the BCM scalers and the BPM positions from HARP scans and the raster conversions. These aspects have their own devoted analysis section.

Global GEN Files

  • PARAM/GEN/genflags.param
    Only includes the gen_run_starting_event parameter.
  • PARAM/GEN/gdebug.param
    No used parameters
  • PARAM/GEN/gtarget.param
    No used parameters, Eloss not included in hcana. Eloss handeled in rc-externals
  • PARAM/GEN/gscalers.param
    Calibration of scaler BCM branches. Must be set before running the BCM calibration procedure.
  • PARAM/GEN/gbeam.param
    Calibration of beam position on target and raster settings.

gscalers

The gscalers.param file currently only includes BCM calibration information. In theory, there could be other scaler calibrations here, but it is unlikely this will change. BCM calibrations are typically applied on a specified run-range based on a BCM calibration run. The gscalers.param Main Parameters:

  • gNumBCMs = 6
  • gBCM_Names = " BCM1 BCM2 Unser BCM4A BCM4B BCM4C"
  • gBCM_Gain = 4795.0, 4092.0, 4000.0, 13020.0, 2042.0, 6238.0
  • gBCM_Offset = 250300.0, 250200.0, 393000.0, 432.4, 204.9, 127.8
  • gBCM_Current_threshold = 5.0
  • gBCM_Current_threshold_index = 3

The naming of these variables is different than any other variable in hcana because of their capitalized letters. Additionally, No other detector has space-separated names like this one does.

gbeam

The gbeam parameter files include information related to the surveys of absolute beam position using HARP scans and the EPICS RAW BPM variables. The naming of these parameters is self-explanatory, but the sign on many of the parameters is not straight forward because the difference in coordinate systems in the hall. Refer to the BPM calibration procedure for specifics on this.

Hall C EPICS RAW BPM values in units of cm
gbeam_{x,y}
gbeam_{xp,yp}
Hall C BPM A, B, and C, slope and offsets based on HARP scans
gbpm{x,y}{a,b,c}_slope
gbpm{x,y}{a,b,c}_off
positions of BPMs relative to target determined from Survey and Alignment
gbpma_zpos
gbpmb_zpos
gbpmc_zpos
Fast Raster Calibration Constants
gusefr = 1
flag if 1 fast raster data used with average beam pos and angles in calculating beam position. If 0 then only use average beam pos and angles in calculating beam position
gfr_cal_mom
gfr{x,y}{a,b}_adc_zero_offset
gfr{x,y}{a,b}_adcpercm
positions of FR magnets relative to target (cm)
gfr{x,y}_dist

Spectrometer General Parameters

As the name implies, these parameters deal with the specific spectrometer parameters. These are more general parameters than detector-specific parameters, which are covered in the next page of data analysis. The HMS and SHMS has its own separate GEN parameters located in:

  • PARAM/SHMS/GEN/
  • PARAM/HMS/GEN/

SHMS GEN Files

  • PARAM/SHMS/GEN/pcana.param
    Magnetic optics matrix elements used for reconstruction of target variables. Also includes SHMS path length.
  • PARAM/SHMS/GEN/pdebug.param
    Dump flags used to debug tracking algorithm for the SHMS. Number of events with different values before resetting pedestals.
  • PARAM/SHMS/GEN/shmsflags.param
    Momentum, angle, and delta corrections as well as saturation corrections applied to the central momentum and reconstructed variables.
  • PARAM/SHMS/GEN/ptracking.param
    Parameters used to tell hcana which tracking algorithm to use, and which cuts are to be applied to select good tracks.
  • PARAM/SHMS/GEN/p_reftime_cut.param
    Location of reference time cuts for the specified detectors. Refer to the Reference time and timing windows section for more information.

HMS GEN Files

  • PARAM/HMS/GEN/hcana.param
    Magnetic optics matrix elements used for reconstruction of target variables. Also includes SHMS path length, detector-specific fiducail volumes and corrections.
  • PARAM/HMS/GEN/hdebug.param
    Dump flags used to debug tracking algorithm for the HMS.
  • PARAM/HMS/GEN/hmsflags.param
    Momentum, angle, and delta corrections as well as saturation corrections applied to the central momentum and reconstructed variables.
  • PARAM/HMS/GEN/htracking.param
    Parameters used to tell hcana which tracking algorithm to use, and which cuts are to be applied to select good tracks.
  • PARAM/HMS/GEN/h_reftime_cut.param
    Location of reference time cuts for the specified detectors. Refer to the Reference time and timing windows section for more information.