OTFMAP

##
OTFMAP

        OTFMAP xStart yStart xEnd yEnd

        Specify an On-The-Fly (OTF) map with linear OTF subscans.

        Real      :: xStart            ! x-offset of start of first OTF  subscan
        Real      :: yStart            ! y-offset of start of first OTF  subscan
        Real      :: xEnd              ! x-offset of end   of first OTF  subscan
        Real      :: yEnd              ! y-offset of end   of first OTF  subscan

        The sequence of subscans is determined by:
        /croLoop /nOtf /reference /step /zigzag

        /croLoop     sequence of:
                     R off-source Reference
                     O on-source OTF
        /nOtf        number of OTF subscans
        /reference   off-source reference position
        /step        step in x and y between OTF subscans
                     = translation of one OTF subscans to the next
        /zigzag      option to scan back-and-forth

        The scan analysis loops through the letter codes in croLoop until nOtf
        OTF subscans have been generated, starting with first letter in the
        croLoop.

           IF THE CROCODE LETTER IS "R" AND /REFERENCE IS TRUE:

           1 subscan tracking the fixed off-source reference position
           is generated

           IF THE CROCODE LETTER IS "O":

           1 linear OTF subscan is generated.
           - The start and end positions of the first OTF subscan are:
             parameters xStart yStart xEnd yEnd of the OTFMAP command
           - For the second and all following OTF subscans:
             xStart yStart xEnd yEnd of the previous OTF subscan are
             incremented by parameters dx and dy of option /step.
             If /zigzag is true, xStart yStart and xEnd yEnd are
             interchanged.

        Then the next letter code in the croLoop is considered
        in the same way.

        If /reference is true, a croCode ending in "R" will ensure that an
        off-source reference subscan follows the last OTF subscan.

        /CROLOOP croLoop

        sequence of R = off-source Reference
                    O = On-source subscans

        Character :: croLoop

        Example:
        /croLoop ROOR

        /NOTF nOtf

        Integer   :: nOtf              ! number of OTF (on-the-fly) subscans

        /REFERENCE xOffsetR yOffsetR [systemNameRef]
        or
        /REFERENCE NO                  ! no reference

        position of off-source reference subscans

        Real      :: xOffsetR          ! x-offset
        Real      :: yOffsetR          ! y-offset
        Character :: systemNameRef     ! name of system
                                       ! see /SYSTEM for choices

        NOTE: with the usage /REFERENCE xOffsetR yOffsetR, both parameters are requi
        but you can replace either parameter with * to leave it unchanged.

        /STEP dx dy

        Step (shift or translation)  between lines in a map.

        Real      :: dx                ! shift in x-offsets
        Real      :: dy                ! shift in y-offsets

        /SYSTEM systemName

        Name of system for offsets.

        Character :: systemName          ! name of system, one of:
                                         ! PROJECTION
                                         ! TRUEHORIZON
                                         ! NASMYTH

        <<TBD:                           ! DESCRIPTIVE>>
        <<TBD:                           ! BASIS>>
        <<TBD:                           ! EQUATORIAL>>
        <<TBD:                           ! HADECL>>
        <<TBD:                           ! HORIZONTAL>>

        PROJECTION for now means only the standard simple "radio" projection
        offsets in the chosen coordinate system. This is normally the
        astronomical system of offsets in which point-by-point (TRACK, ONOFF)
        or on-the-fly (OTFMAP) maps are made.

        TRUEHORIZON means the horizontal system with a factor 1/cos(elevation)
        applied to the azimuth offset.

        NASMYTH are special offsets to point an off-center pixel of a
        focal-plane array receiver (bolometer, HERA) to the commanded
        astronomical position, e.g., to use an off-center pixel for pointing,
        focus, ONOFF.

        IMPORTANT NOTE: projection, trueHorizon

           If the observing mode (LISSAJOUS, ONOFF, OTFMAP, ...)
           is in /SYSTEM projection,
           OFFSETS ... /SYSTEM projection is ignored (not used).
           If the observing mode (LISSAJOUS, ONOFF, OTFMAP, ...)
           is in /SYSTEM trueHorizon,
           OFFSETS ... /SYSTEM trueHorizon is ignored (not used).

        IMPORTANT NOTE: OFFSETS   /SYSTEM Nasmyth

           If OFFSETS xOffset yOffset /SYSTEM Nasmyth are specified in pako,
           the values xOffset yOffset are used during the observations.
           (this inludes the case that they are explicitly set to 0.0).
           It is up to the observer to make sure that they are "correct".
           (in pakoDisplay /SYS Nasmyth will be highlighted as yellow alert.)

           If OFFSETS xOffset yOffset /SYSTEM Nasmyth are not specified
           (cleared), for the MAMBO bolometer, Nasmyth offsets are used
           automatically according to the selected bolometer channel (pixel).

Subsections

- OTFMAP /DEFAULTS
- OTFMAP /CROLOOP
- OTFMAP /NOTF
- OTFMAP /REFERENCE
- OTFMAP /STEP
- OTFMAP /SPEED
- OTFMAP /SYSTEM
- OTFMAP /TOTF
- OTFMAP /TREFERENCE
- OTFMAP /ZIGZAG
- OTFMAP /TUNE
- OTFMAP /TTUNE
- OTFMAP EXAMPLES