AIPS HELP file for OTFUV in 31DEC24
As of Thu Apr 25 22:23:31 2024
OTFUV: Task to read 12-m OTF data to an AIPS UV file
INPUTS
DATAIN
Input data file (sdd file)
DATA2IN
Input gain file (gsdd file)
BCOUNT First included scan
ECOUNT Last included scan
BIF First IF number: 0 => lowest
EIF Last IF number: 0 => highest
DOUVCOMP -1.0 1.0 >=0 => compressed data (FITS)
OUTNAME Output UV file name (name)
blank => OBJECT
OUTCLASS Output UV file name (class)
blank => OTFUV
OUTSEQ -1.0 9999.0 Output UV file name (seq #)
0 => high unique
OUTDISK 0.0 9.0 Output disk drive #
XINC 0.0 1000.0 Write an output record every
XINC'th time
YINC 0.0 1000.0 Time smooth by averaging
every YINC records
DOWEIGHT -1.0 1.0 > 0 => interpolate Offs and
Gains in time
DOCONCAT -1.0 1.0 > concatenation allowed?
FQTOL Frequency tolerance needed to
decide if OTFUV should
concatanate files. (MHz)
<=0 => 2 MHz
DETIME 0.0 100.0 Time (days) to add to data
set being concatenated
BCHAN 0.0 8192. First channel to include
ECHAN 0.0 8192. Last channel to include
CHANSEL 0.0 8192.0 Channels to be flagged:
n1(i) to n2(i) by n3(i)
where n2(i) >= n1(i) > 0.
HELP SECTION
OTFUV
Type: Task
Use: Convert a single 12m OTF map (in UniPOPS SDD format) to UV
(single-dish) format within AIPS.
Adverbs:
DATAIN......Input 12m sdd file (raw data file).
DATA2IN.....Input 12m gsdd file (gains file).
BCOUNT......First scan in OTF map which you want to process.
ECOUNT......Last scan in OTF map which you want to process.
BIF.........Lowest IF number to process. The IF number is converted
into the apparent antenna number for the "autocorrelation"
data on output ("BEAM" = 257 * IF#, "BASELINE" = IF#-IF#).
The antenna number can be used later for data selection.
0 => lowest in data set.
EIF.........Highest IF number to process. OTFUV will attempt to write
data for multiple IFs at once to the output file so that
it will not be necessary to run OTFUV multiple times
followed by a UVSRT on the concatenated output. 0 =>
highest in data set. IFs that do not match in center
frequency or channel width to those of BIF will be
omitted.
DOUVCOMP....If true (DOUVCOMP >= 0) the output data is written in
compressed format which can result in a substantial
reduction in disk space needed but a few tasks still
cannot read this format.
OUTNAME.....Output (SD) UV file name (name).
OUTCLASS....Output (SD) UV file name (class). Standard behavior with
default = 'OTFUV'.
OUTSEQ......Output (SD) UV file name (seq #). 0 => highest unique.
OUTDISK.....Output (SD) UV file disk drive #. 0 => highest w space for
the initial file size. Be careful to select a disk with
plenty of space. Unlike some AIPS tasks, OTFUV has to
increase the size of the UV file after creation if there
is more data than it guessed initially.
XINC........Output data every XINC'th time: ignored if YINC <= 1; 0 =>
YINC.
YINC........Average every YINC times together in the output. The
combination of XINC and YINC allows you to, for example,
averages of 5 samples every third sample time.
DOWEIGHT....> 0 => the Off and Gain data are interpolated in time
before being applied to the on-source data. <= 0 => the
Off and Gain scans assigned to the on-source scan are
applied to the full scan.
DOCONCAT....> 0 => that OTFUV will concatenate the current data to a
pre-existing data set (OUTNAME, OUTCL, and especially
OUTSEQ must be specified).
FQTOL.......Frequency tolerance in MHz. Data sets separated in
frequency by > FQTOL will not be concatenated. 0 => 2 MHz.
DETIME......Time in integer days to add to observed time when
concatenating data. This is to allow you to edit one data
set wrt the other. Note that, if the two data sets are
from different times, you should read in the earlier one
first and do not need to set DETIME.
BCHAN.......First channel to include: 0 -> 1. Including fewer
channels speeds up the task and decreases the size of the
output file. However, it also removes channels to be used
for fitting spectral baselines.
ECHAN.......Last channel to include; <= BCHAN => max in data
CHANSEL.....Channels to be flagged as they are read in. CHANSEL is an
array of (3,N) and the channels to be flagged are
CHANSEL(1,i) to CHANSEL(2,i) by CHANSEL(3,i). Thus, to
flag channels 31 and 34, for example, set CHANSEL = 31,
34, 3, 0. The first CHANSEL(2,i) < CHANSEL(1,i) or either
of these = 0 terminates the list. N <= 10. Channel
numbers are before correction for BCHAN.
EXPLAIN SECTION
OTFUV : Task to read 12-m OTF data to AIPS UV file
DOCUMENTOR: J. G. Mangum (SMTO)
DATE OF DOCUMENTATION:
RELATED PROGRAMS: PRTSD, SDGRD, OTFIN
VERSION:
PURPOSE
OTFUV is an AIPS task which will take a 12m OTF (On-The-Fly) data
set (one map at one polarization) and convert it to AIPS pseudo-UV
single-dish format within AIPS. For further information on the
reduction of 12m OTF data, see the 12m observers memo "How to Process
Spectral Line On The Fly Data" by Jeff Mangum.
COMMENTS
Currently, OTFUV will only process spectral-line OTF data from the
12m. In the future, OTFUV will be adapted to process continuum OTF data
obtained at the 12m.