AIPS HELP file for MARSP in 31DEC25
As of Wed May 21 21:59:19 2025
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