next up previous contents index
Next: XY_MAP /NOGRID Up: MAP Language Internal Help Previous: DECONVOLVE   Contents   Index


XY_MAP

        MAP\XY_MAP [FilenamePrefix] [/NOGRID] [/TYPE LMV|VLM|...]

    Build  an LMV spectra cube and an associated weight image from an XY ta-
    ble. The LMV cube (.lmv), WEI image (.wei) and XY table (.tab) share the
    same file name, given without extension. By default, data is grided with
    a convolution (general case), unless /NOGRID option is invoked (typical-
    ly when the data is already regularly placed).

    By default, the spatial grid of the LMV cube will be large enough to use
    all the spectra of the XY table. The pixel size will ensure Nyquist sam-
    pling (i.e. at least 2 pixels per beam). The grid position reference and
    position angle will be taken from the XY table header.  The  convolution
    kernel is a Gaussian of size one-third the telescope beamwidth, the con-
    volution being computed on a limited support (large enough to ensure ex-
    cellent accuracy).

    However,  the  griding  process may be finely tuned through user defined
    values of the MAP structure. The header of an existing LMV cube  may  be
    used  as  a  template for the grid definition. To do this, the user must
    set the MAP%LIKE variable to the template filename. When MAP%LIKE is set
    to  an  empty  string,  the user may define the grid by hand through the
    following parameters

    MAP%CELL     [arcsec    ]   X and Y pixel size
    MAP%SIZE     [pixel     ]   X and Y map   size
    MAP%ANGLE    [degree    ]   Grid position angle
    MAP%RA       [  HH:MM:SS]   Grid reference position
    MAP%DEC      [+DDD:MM:SS]   Grid reference position
    MAP%SHIFT    [logical   ]   Shift and/or Rotate grid?

    The natural beamwidth of the telescope is set in order of precedence by

    TAB%MAJOR    [radian    ]   The resolution in the table header, if defined
    MAP%TELE     [string    ]   The telescope name
    MAP%DIAM     [m         ]   The telescope diameter (if MAP%DIAM = 0)
    MAP%BEAM     [arcsec    ]   The beam size (if MAP%TELE = "" and MAP%DIAM = 0

    Because of the convolution, the spatial resolution of  the  grided  data
    will by default be 5.4% wider than the telescope beamwidth at the obser-
    vation frequency. It is however possible to grid the data with  a  wider
    Gaussian  in  order  to smooth the data (e.g. to increase the signal-to-
    noise ratio of extended emission). The user have to define the  required
    resolution of the grided data through

    MAP%RESO     [arcsec    ]   Final resolution of the grided data (default is

    the  command  will  deduce the size of the griding kernel from the tele-
    scope beamwidth and the required resolution.

    It is advised to avoid changing the following more technical parameters.
    However those parameters are tunable through

    MAP%COL      [integer   ]   Range of columns to grid
    MAP%WCOL     [integer   ]   Column of weights
    MAP%CTYPE    [integer   ]   Convolution kernel type
    MAP%SUPPORT  [arcsec    ]   Convolution kernel support size

    For  ease  of use, a sensible value of each griding parameter will auto-
    matically be computed from the context if the value of the corresponding
    MAP structure component is set to its default value, i.e. zero value and
    empty string. The only exception is the position reference and/or  posi-
    tion  angle  of  the  grid:  Changing  them  requires in addition to set
    MAP%SHIFT to YES.

    The output LMV cube can be then analysed with the  standard  GreG  tools
    like GO VIEW. However, it is also possible to reimport the cube in Class
    as a set of spectra thanks to the command ANALYSE\LMV (see HELP for  de-
    tails).


Subsections

Gildas manager 2014-07-01