next up previous contents
Next: MSETUP OUTPUT Up: MSETUP Previous: MSETUP BOOKKEEPING   Contents


MSETUP CALIBRATION

        [MRTCAL\]MSETUP CALIBRATION Keyword Switch

    [MRTCAL\]MSETUP CALIBRATION BAD YES|NO

    Choose  if  the  bad time dumps in the BackendXXX tables should be cali-
    brated (in addition to the good ones).  A  bad  time  dump  has  a  null
    ISWITCH  value, and its associated data (e.g. MJD, INTEGTIM) are not ex-
    pected to be correct. If YES is requested, you will likely be exposed to
    problems (e.g. if MJD column has incorrect values, searches in this col-
    umn may fail without advise). Default is NO.

    [MRTCAL\]MSETUP CALIBRATION BANDWIDTH Value

    Setup the desired calibration bandwidth in MHz. The nearest  value  that
    allows  the  division  of  the good spectra channels of each chunkset in
    equal virtual chunk sizes will be used. Exceptions are:
      - if value is 0, use the native hardware chunk size (no subdivision),
      - if value is larger than the native hardware chunk size,  the  latter
        is used instead (same as 0),
      - if  value  is lower than the channel spacing, the latter is used in-
        stead (all channels calibrated individually, use with caution).
    Default is 20 MHz.

    [MRTCAL\]MSETUP CALIBRATION CHOPPER STRICT|TOLERANT

    Setup the chopper calibration engine. By default (strict mode), any  er-
    ror  occuring during this process (e.g. cold load greater than hot load)
    blanks the resulting data at  the  chunk  level  (i.e.  the  surrounding
    chunks  are  calibrated  if they have no problem). In tolerant mode, the
    engine goes to the end of process, even if this implies non physical re-
    sults  (e.g. negative Trec). This second mode is dangerous and should be
    used for testing purposes only.
    In both modes, a FLAG array is added to the  calibration  products  (see
    HELP  MSET  OUTPUT CALIBRATION). It is 0 where no problem occured, and 1
    otherwise.

    [MRTCAL\]MSETUP CALIBRATION FEEDBACK PIXEL|SET|ELEMENT

    Tune the granurality of the calibration results (Tsys, Tcal, Trec, ...).
    The  median  value per pixel, per chunkset, or per chunk element will be
    printed in the PIXEL, SET, or ELEMENT mode, respectively. One value  per
    chunk  element  may  result  in very long lists when using virtual chunk
    sizes (see MSETUP CALIBRATION BANDWIDTH). Default is SET.

    [MRTCAL\]MSETUP CALIBRATION INTERVAL ErrLimit [WarnLimit]

    Setup the time limits (in minutes) used when searching automatically for
    a  calibration scan to be associated to a science scan. Beyond ErrLimit,
    an error is raised if no calibration scan is  found.  Beyond  WarnLimit,
    only  a  warning  is displayed. Automatic search is used by the commands
    PIPELINE and CALIBRATE without the option /WITH.  The  calibration  scan
    always  can  be forced with CALIBRATE /WITH. Default ErrLimit is 30 min-
    utes, and WarnLimit defaults to 2/3 of ErrLimit.

    [MRTCAL\]MSETUP CALIBRATION MATCH Value

    Define the position matching tolerance when checking the  subscan  posi-
    tion(s)  on  sky. This tolerance is used 1) when checking that a 'track'
    subscan effectively provides dumps at the same  position,  and  2)  when
    grouping  the  subscans  per ON or OFF positions, and checking that each
    group effectively provides the same position. Default is 4 centi-arcsec-
    onds.

    [MRTCAL\]MSETUP CALIBRATION MJDINTER YES|NO

    Choose  if  Mrtcal  should intersect the DATE-OBS and DATE-END (on-track
    range) of the subscans with the MJD columns in the tables Antenna  Slow,
    Antenna  Fast, and Backend Data. It may happen that one of these columns
    are too short and the data dumps can  not  be  calibrated.  Setting  YES
    means  that  the associated dumps in this missing range won't be consid-
    ered on-track anymore, and won't be calibrated. Default is NO.

    [MRTCAL\]MSETUP CALIBRATION OFF NEAREST|LINEAR

    Define how to select the OFF subscan matching the current ON subscan da-
    ta (OTF PSW only). In NEAREST mode, the OFF subscan nearest in time will
    be used. In LINEAR mode, the algorithm will linearly interpolate between
    the two nearest OFF spectra. Default is LINEAR.

    [MRTCAL\]MSETUP CALIBRATION PRODUCTS LINEAR|NEAREST|SPLINE

    One set of calibration products Trec, Tcal, Tsys, precipitable water va-
    por, and zenithal opacity is computed per chunk, at the  middle  of  the
    chunk  (chunk  bandwidth  is  ruled by MSET CALIB BANDWIDTH). In NEAREST
    mode, the intermediate values on the frequency axis use the nearest com-
    puted values (flat value per chunk/bandwidth, possible discontinuities).
    In LINEAR mode, the intermediate values  are  interpolated  between  two
    middle  of chunks (possible discontinuity of the derivatives). In SPLINE
    mode, the intermediate values are cubic spline interpolated between  two
    middle  of  chunks  (ensuring continuity of the first and second deriva-
    tives). Default is LINEAR.

    [MRTCAL\]MSETUP CALIBRATION SCAN NEAREST|LINEAR

    Define how to select the calibration scan used calibrate  science  data.
    In  NEAREST mode, the scan nearest in time will be used. In LINEAR mode,
    the algorithm will linearly interpolate calibration  parameters  between
    the two nearest calibration scans. Default is NEAREST.

    [MRTCAL\]MSETUP CALIBRATION WATER SET
    [MRTCAL\]MSETUP CALIBRATION WATER ELEMENT
    [MRTCAL\]MSETUP CALIBRATION WATER FIXED Value

    Define  if  the  precipitable water vapour amount should be minimized or
    not:
      - SET means one single value for the whole bandwidth,
      - ELEMENT means one independent value per calibration bandwidth,
      - FIXED Value will force the pwv amount to  the  given  value  without
        minimization.
    Default is ELEMENT.


Gildas manager 2023-06-01