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


MSETUP CALIBRATION

        [MRTCAL\]MSETUP CALIBRATION Keyword Switch

    [MRTCAL\]MSETUP CALIBRATION ANTSLOW_MJD_SHIFT Value

    Apply  (add)  a  shift in the antenna slow MJD traces of the given value
    (in seconds, can be positive or negative). As a result the antenna  will
    appear  earlier  or  later  at  the associated position (namely LONGOFF,
    LATOFF, CAZIMUTH, CELEVATI). The subscan start and stop  timestamps  are
    NOT shifted. The antenna fast traces are NOT shifted neither. Default is
    0, i.e. no shift is applied.

    [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 2024-12-01