[ Basic Info | References | User Guide ]
Basic Information on smalod
Task: smalod
Purpose: Convert an Sma archive data (Caltech MIR) into Miriad uv format
Categories: data transfer
SMALOD is a MIRIAD task, which converts the standard SMA data
format to Miriad format. It also automatically selects SMA
doubleband patch for handling 4GHz data.
Key: in Name of the input MIR file.
There is no default.
Key: out
Name of the output Miriad uv data-set. No default.
Key: rxif
select data from one of the dual receivers/IFs:
rxif=-1 for the 1st rxif band;
rxif=-2 for the 2nd rxif band.
select the data based on receiver id:
for data taken after 2006-12-28 --
rxif=0 for receiver id = 0 -> 230 GHz band;
rxif=1 for receiver id = 1 -> 340 GHz band;
rxif=2 for receiver id = 2 -> 400 GHz band;
rxif=3 for receiver id = 3 -> 690 GHz band;
for data taken before 2006-12-28 --
rxif=0 for receiver id = 0 -> 230 GHz band;
rxif=1 for receiver id = 1 -> 340 GHz band;
rxif=2 for receiver id = 2 -> 690 GHz band.
The default is rxif=-1 or the 1st rxif band.
Key: restfreq
The rest frequency, in GHz, for line observations. By default,
the value in the MIR file is used.
we are cosidering to support the following functions: Giving a
value for the "restfreq" parameter overrides the MIR file value.
If you do set this parameter, you MUST give the same number of
values as the number of IFs written out. A value of 0 is used
for a continuum observation. For example, if you have two IFs,
the first of which is CO(3-2), and the second is continuum, use
restfreq=345.795991,0
Not for 4GHz data.
Key: vsource
The radial velocity of source in km/s w.r.t. the LSR or
the barycenter, which was included in the online Doppler
track. The velocity reference frame can be selected
in options. Positive velocity is away from observer.
Default is zero.
Not for 4GHz data.
Key: refant
The reference antenna. Default is 6. The reference antenna needs
to be present while the antenna positions are being decoded
from baseline vectors stored in SMA MIR data. The geocentrical
coordinates for the antennas can be retrieved from SMA sybase.
For double checking the antenna positions, one can login to
d2o.sma.hawaii.edu (IP:128.171.116.111) and use the following
command:
dBValue -d hal9000-newdds -v dsm_dds_hal_x_v11_d -t "2004-11-16 00:00:00"
dBValue -d hal9000-newdds -v dsm_dds_hal_y_v11_d -t "2004-11-16 00:00:00"
dBValue -d hal9000-newdds -v dsm_dds_hal_z_v11_d -t "2004-11-16 00:00:00"
If the reference antenna is not the default value 6, one may need
to give the reference antenna here.
For 4GHz data, it uses the reference antenna given in the
antenna table.
Key: options
'bary' Compute the radial velocities of the observatory, in the
direction of a source, w.r.t. the barycenter.
Default uses the on-line values.
'lsr' Compute the radial velocities of the observatory, in the
direction of a source, w.r.t. the LSR.
Default uses the on-line values.
The above two options might be applied only when
the chunk frequency stored in the SMA raw data
corresponds to the true Doppler tracked sky frequency
or no online correction to the frequency has been
made.
'nopol' Disable polarization. All the correlations will be
labelled as XX. Default in options for polarization
is nopol.
'circular' when circular polarization data taken with single
receivers and waveplates for each antenna. For the
circular polarization data observed before 2005-06-10,
the polarization states are swapped by the default
(RR<->LL, RL<->LR or -1 <-> -2, -3 <-> -4).
'linear' when linear polarization data taken with dual linear feeds.
'oldpol' Obsoleted.
Defaults assume that non-polarization state is assigned.
'dospc' reverses the order of the spectral chunks in frequency
only for the first three blocks (1 2 3).
frequency code vs. spectral window orders:
frcode iband
4 1
3 2
2 3
1 4
8 5
7 6
6 7
5 8
12 9
11 10
10 11
9 12
13 13
14 14
15 15
16 16
17 17
18 18
19 19
20 20
21 21
22 22
23 23
24 24
'doengrd' to read the engineer file for Tsys and LST.
'conjugat' to phase conjugate for lsb data.
Default:
conjugate the phase of the lsb data observed before
2005-04-28;
no phase flip for the data observed after 2005-04-28.
'noskip' not to skip any data; the default is to skip
data with source name "target" and/or "unknown".
'mcconfig' to handle multiple correlator configurations.
The default is to handle multiple correlator configuration.
'nohspr' to turn off the high spectral resolution mode.
For data taken after 2006-5-12, the default
will properly handle the hybrid high spectral
resolution mode, allowing presence of empty
spectral windows (chunks).
'debug' to print out the warning messages indicating
what have been fixed or skipped for the header
problems. ERRreport.log is created in reporting
the detailed errors. Default mutes these messages.
'uvwide' to call uvwide routine to generate "wideband" data
while the original uvdata files are kept. The
output wideband data should be identical with
the products from uvwide program with the default
keyword input.
The default is not to generate "wideband" data.
'sendian' For little endian online data computer;
default is for big endian formatted data.
'2GHz' Only check 2GHz mode (for old data before end of 2008).
The default is to check both 2GHz and 4GHz mode.
'flagch0' The default is to flag ch0 data in 4GHz data mode.
'ipoint' An option to keep the ipointing data. The default is
to flag iPointing data with non-zero offset from source.
No extra processing options have been given yet. The default
works.
Key: rsnchan
This is an option for resampling SMA uvdata from higher
spectral resolution to lower spectral resolution or from
hybrid spectral resolutions across the 24 spectral windows
(chunks or IFs) to a uniform spectral resolution.
The default or a negative is no resampling to be applied.
Note that this number must be power of 2 and equal to/less
than the smallest channel number in the 24 spectral windows.
If rsnchan is not equal to the nth power of 2, the program
will take the a number of 2**n which is close to the input
value. If rsnchan is greater than the smallest channel number,
the program will take the smallest channel number.
It has not been implemented for 4GHz data.
Key: spskip
For data taken after 2006-5-12, the default will properly
handle the skipped windows (chunks).
For data taken earlier than 2006-5-12, this keyword
specifies the skipping in spectral windows, e.g.:
spskip=21,2 means that starting at spcode (MIR) = 21, two
spectral chunks are skipped, i.e. no data are produced for the
spectral chunks with spcode=21 and 22. Then smalod will
move up by two spectral windows while storing the rest of
the chunks' data with the following mapping between MIR
spcode and Miriad spectral window id:
MIR Miriad
1 -> 1
2 -> 2
...
20 -> 20
21 skipped
22 skipped
23 -> 21
24 -> 22
Thus, the data in Miriad format will have a total
of 22 spectral windows instead of 24.
In addition, spskip=-1 takes the frequency
configuration from that of the first integration
assigned by nscans assuming that the frequency
configuration for the rest of integrations does not
change.
For old data sets (such as 2003), spskip=-2003 might be
useful to handle data from an incompleted correlator.
The default is no skipping in spectral windows.
It has not been implemented for 4GHz data.
Key: sideband
This is an option for separating sidebands. A value of 0 is for
lower sideband only, 1 for upper sideband and 2 for both.
The default is 0.
Key: nfiles
This gives one or two numbers, being the number of files to skip,
followed by the number of files to process (not yet). This is only
useful when the input is a tape device containing multiple files.
The default is 0,1 (i.e. skip none, process 1 file).
It has not been implemented.
Key: nscans
This gives one or two numbers, being the number of scans to skip,
followed by the number of scans to process.
The default is to skip the 1st and the last 2 scans
and process the rest of scans in the file.
It has not been implemented for 4GHz data. For 4GHz data, it
loads in all the data.