AIPS NRAO AIPS HELP file for MARSP in 31DEC24



As of Wed Oct 9 4:50:56 2024


MARSP: Find planetary polarization angle, plot histogram

INPUTS

INNAME                             POLI or Q image name (name)
INCLASS                            POLI or Q image name (class)
INSEQ             0.0     9999.0   POLI or Q image name (seq#)
INDISK            0.0        9.0   POLI or Q image disk unit #
IN2NAME                            POLA or U image name (name)
IN2CLASS                           POLA or U image name (class)
IN2SEQ           -1.0     9999.0   POLA or U image name (seq#)
IN2DISK           0.0        9.0   POLA or Uimage disk unit #.
BLC                                Bottom left corner of input
TRC                                Top right corner of input
CPARM                              (1) POLI flux cutoff
                                   (2) X center (pixels)
                                   (3) Y center (pixels)
                                   (4) Inner radius (pixels)
                                   (5) Outer radius (pixels)
DOPLOT                             > 0 make a histogram plot
                                     1 -> sum count
                                     2 -> sum weights
NBOXES           10      1800      Number cells in histogram
PIXRANGE                           Plot range: 0 -> -90 to 90
GRCHAN                             Graphics channel
FUNCTYPE                           'LG' logarithmic on counts
                                   else linear
DOTV                               > 0 -> do plot on TV, else
                                   make a plot file

HELP SECTION

MARSP
Task:  Reads a POLI and a POLA image and looks at the POLA to see if
       it is radial.  Alternatively, one can input Q and U images and
       MARSP will compute the POLI and POLA.  A histogram plot of the
       deviations from radial is possible.
Adverbs:
  INNAME.....POLI or Q image name (name).       Standard defaults.
  INCLASS....POLI or Q image name (class).      Standard defaults.
  INSEQ......POLI or Q image name (seq. #).     0 => highest.
  INDISK.....Disk drive # of POLI or Q image.   0 => any.
  IN2NAME....POLA or U image name (name).       Standard defaults.
  IN2CLASS...POLA or U image name (class).      Standard defaults.
  IN2SEQ.....POLA or U image name (seq. #).     0 => highest unique.
  IN2DISK....Disk drive # of POLA or U image.   0 => highest disk
             number with sufficient space.
  BLC........Bottom right corner in input image of desired
             subimage.  Default is entire image.
  TRC........Top right corner in input image of desired
             subimage.  Default is entire image.
  CPARM......(1) Compute only when POLI > CPARM(1) Jy/beam
                 0 -> 3 * robust rms
             (2) Use this X centroid in pixels
                 0 -> intensity weighted centroid
             (3) use this Y centroid in pixels
                 0 -> intensity weighted centroid
             (4) Inner radius of region omitted from computation in
                 pixels.  0 -> 0
             (5) Outer radius of region included in computation in
                 pixels.  <= CPARM(4)  -> 10000
             Defaults are 3 sigma, the actual centroid, 0, and
             infinite (but CPARM(1) will limit it)
  DOPLOT.....> 0 plot histogram of differences between the measured
                 POLA and radial.  Histogram is of counts unless
             > 1.5 when the histogram sums the POLI values instead.
  NBOXES.....Controls the number of summing boxes for the histogram
             to cover the PIXRANGE.  Allowed values 10 to 1800.
  PIXRANGE...Plot range in degrees:  PIXR(1) >= PIXR(2) does -90
             to +90 in the NBOXES.  The actual plot range will not
             include the empty boxes below the minimum or above the
             maximum.
  GRCHAN.....> 0 -> the TV graphics channel on which to plot.
             = 0 -> use graphics 1 for labels, 2 for the plot and
                    3 for marking the fit values and rms
  FUNCTYPE...'LG' use log10 of counts when DOPLOT <= 1.5.  This
             option is unlikely to be needed.
  DOTV.......> 0 => make plot on the TV
             else => make a plot file.

EXPLAIN SECTION


AIPS