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 2018-05-27