next up previous contents index
Next: MODIFY FREQUENCY Up: MODIFY Previous: MODIFY BEAM_EFF   Contents   Index


MODIFY DOPPLER

        LAS\MODIFY DOPPLER [SIGN|*|Value]

    Change or recompute the Doppler factor according to the CLASS convention
    (-V/c).  With no argument, checks whether the header value is consistent
    with the CLASS value computed according to the date and observatory. The
    checking  precision corresponds to 0.6 m/s in V. A logical SIC variable,
    DOPPLER_PB, is set to true if the values disagree.  If  an  argument  is
    present:

      SIGN   change the sign of the Doppler factor but do not recompute it,
      *      compute  and update the Doppler factor according to the observ-
             ing date-time and the observatory position (this  position  can
             be  customized  with  SET OBSERVATORY). This is suited when the
             frequencies in the Class header are described in the observato-
             ry frame. See also undefined Doppler section below.
      0      force  the  Doppler  factor  to  0, i.e. the frequencies in the
             Class header are already corrected for the Doppler factor  (de-
             scribed in the LSR frame).
      Value  set the Doppler factor to <Value>


    Undefined Doppler factor:
        If  the Doppler factor is -1 (no physical meaning), it is considered
      "undefined" by Class. In most of the cases, this happens when  reading
      old Class data files where the Doppler factor was not available in the
      data format. Since then, telescopes are encouraged to use  the  newest
      data  format  and  write  directly a valid Doppler factor value at the
      time the Class files are created.

        At read time (GET or other commands reading a spectrum), Class  con-
      siders  the  value  -1  as  a  request  to recompute automatically the
      Doppler factor from the telescope position on Earth and from observing
      date-time,  assuming  the  frequencies  in the spectrum header are de-
      scribed in the observatory frame. In other words, Class tries to apply
      implicitly the command MODIFY DOPPLER * on the spectrum.

        The above automatic patch works if the observatory can be recognized
      by Class from the telescope name (R%HEAD%GEN%TELES). If not, you  will
      encounter this error:
        E-COMPUTE_DOPPLER,  Telescope not understood from XXX
      In this case, use the command SET OBSERVATORY beforehand.

        Beware  that  the automatic patch makes sense if the frequencies are
      described in the observatory frame. If they are described in  the  LSR
      frame, the Doppler factor must be forced to 0.

        Finally,  if  you have an old Class file without the Doppler factor,
      it is advised to copy it to a newer Class Data Format. This will  save
      the  computed Doppler value directly in the new file instead of recom-
      puting again and again this factor each time the spectrum is read from
      the old file. If MODIDY DOPPLER * is what you want (frequencies in the
      observatory frame), this will do the job:
        FILE IN old.30m
        FIND
        FILE OUT new.30m SINGLE ! Uses newest data format
        COPY                    ! Implicit MODIFY DOPPLER * on each spectrum
      If you need a custom Doppler value (most probably 0), use:
        FILE IN old.30m
        FIND
        FILE OUT new.30m SINGLE ! Uses newest data format
        FOR I 1 TO FOUND
          GET NEXT
          MODIFY DOPPLER 0
          WRITE
        NEXT


Gildas manager 2024-04-19