|
|||
NRAO Home > CASA > CASA Task Reference Manual |
|
0.1.23 exportuvfits
Requires:
Synopsis
Convert a CASA visibility data set to a UVFITS file:
Description
Arguments
Inputs |
| ||
vis |
| Name of input visibility file
| |
| allowed: | string |
|
| Default: |
| |
fitsfile |
| Name of output UV FITS file
| |
| allowed: | string |
|
| Default: |
| |
datacolumn |
| Visibility file data column
| |
| allowed: | string |
|
| Default: | corrected |
|
field |
| Select field using field id(s) or field name(s)
| |
| allowed: | any |
|
| Default: | variant
|
|
spw |
| Select spectral window/channels
| |
| allowed: | string |
|
| Default: |
|
|
antenna |
| Select data based on antenna/baseline
| |
| allowed: | string |
|
| Default: |
| |
timerange |
| Select data based on time range
| |
| allowed: | string |
|
| Default: |
|
|
avgchan |
| DEPRECATED. Use mstransform to select and average
data prior to running exportuvfits.
| |
| allowed: | int |
|
| Default: | 1 |
|
writesyscal |
| Write GC and TY tables, (Not yet available)
| |
| allowed: | bool |
|
| Default: | False |
|
multisource |
| Write in multi-source format? Set to False if only one
source is selected. Note that diffmap does not work on
multisource uvfits files.
| |
| allowed: | bool |
|
| Default: | True |
|
combinespw |
| Export the spectral windows as IFs
| |
| allowed: | bool |
|
| Default: | True |
|
writestation |
| Write station name instead of antenna name
| |
| allowed: | bool |
|
| Default: | True |
|
padwithflags |
| Fill in missing data with flags to fit IFs
| |
| allowed: | bool |
|
| Default: | False |
|
overwrite |
| Overwrite output file if it exists?
| |
| allowed: | bool |
|
| Default: | False |
|
This task writes a UVFITS file, a general format data set used
to transfer data between different software systems. It is
written in floating point format. Different programs have different
restrictions on what forms of UVFITS files they will use, especially
whether they will accept multiple sources and/or spectral windows in
the same file. See the spw, multisource, and combinespw descriptions
below.
IMPORTANT NOTE: In general, some of the data averaging features of this task have never
worked properly. In general, users should run mstransform to select and average data
prior to running exportuvfits. The associated input parameters are being slowly
deprecated and removed.
Keyword arguments:
vis -- Name of input visibility file
default: none; example: vis=’ngc5921.ms’
fitsfile -- Name of output UV FITS file
default: none; example=’3C273XC1.fits’
datacolumn -- Visibility file data column
default: => ’corrected’; example: datacolumn=’model’
Options: ’data’ (raw),’corrected’,’model’,’weight’
field -- Select field using field id(s) or field name(s).
[run listobs to obtain the list id’s or names]
default: ’’=all fields
If field string is a non-negative integer, it is assumed a field index
otherwise, it is assumed a field name
field=’0~2’; field ids 0,1,2
field=’0,4,5~7’; field ids 0,4,5,6,7
field=’3C286,3C295’; field named 3C286 adn 3C295
field = ’3,4C*’; field id 3, all names starting with 4C
spw -- Select spectral window/channels
type ’help par.selection’ for more examples.
spw=’0~2,4’; spectral windows 0,1,2,4 (all channels)
spw=’<2’; spectral windows less than 2 (i.e. 0,1)
spw=’0:5~61’; spw 0, channels 5 to 61, INCLUSIVE
spw=’*:5~61’; all spw with channels 5 to 62
spw=’0,10,3:3~45’; spw 0,10 all channels, spw 3, channels 3 to 45.
spw=’0~2:2~6’; spw 0,1,2 with channels 2 through 6 in each.
spw=’0:0~10;15~60’; spectral window 0 with channels 0-10,15-60
NOTE ’;’ to separate channel selections
spw=’0:0~10^2,1:20~30^5’; spw 0, channels 0,2,4,6,8,10,
spw 1, channels 20,25,30
antenna -- Select data based on antenna/baseline
default: ’’ (all)
If antenna string is a non-negative integer, it is assumed
an antenna index
otherwise, it is assumed as an antenna name
antenna=’5&6’; baseline between antenna index 5 and index 6.
antenna=’VA05&VA06’; baseline between VLA antenna 5 and 6.
antenna=’5&6;7&8’; baseline 5-6 and 7-8
antenna=’5’; all baselines with antenna index 5
antenna=’05’; all baselines with antenna name ’05’, vla antenna
antenna=’5,6,10’; all baselines with antennas 5, 6 and 10
timerange -- Select data based on time range:
default = ’’ (all); examples,
timerange = ’YYYY/MM/DD/hh:mm:ss~YYYY/MM/DD/hh:mm:ss’
Note: if YYYY/MM/DD is missing dat defaults to first day in data set
timerange=’09:14:0~09:54:0’ picks 40 min on first day
timerange=’25:00:00~27:30:00’ picks 1 hr to 3 hr 30min on next day
timerange=’09:44:00’ data within one integration of time
timerange=’>10:24:00’ data after this time
avgchan -- DEPRECATED Use mstranform to select and average data prior to running exportuvfits.
multisource -- Write in multi-source format
default: => True;
Set to False if a single source is selected. Note that diffmap does not work on
multi-source uvfits files, so if planning on using diffmap on the resulting uvfits
file, select a single source and set multisource = False. Otherwise use True. (If
multiple sources are selected, a multi-source file will be written no matter what
the setting of this parameter).
combinespw -- If True, export the spectral windows as IFs.
Otherwise multiple windows will use multiple FREQIDs.
default: => True;
all spectral windows must have same shape.
True is recommended for AIPS, and mandatory for difmap.
padwithflags -- If True, and combinespw is True, fill in missing
data as needed to fit the IF structure. This is
appropriate if the MS had a few frequency-dependent
flags applied, and was then time-averaged by split, or
when exporting for use by difmap. If the spectral
windows were observed at different times,
padwithflags=True will add a large number of flags,
making the output file significantly longer. It does
not yet support spectral windows with different widths.
writestation -- Write station name instead of antenna name
default: True;
writesyscal -- Write GC and TY tables
default: => False; Not yet available
overwrite -- Overwrite specified output file if it exists?
More information about CASA may be found at the
CASA web page
Copyright © 2016 Associated Universities Inc., Washington, D.C.
This code is available under the terms of the GNU General Public Lincense
Home |
Contact Us |
Directories |
Site Map |
Help |
Privacy Policy |
Search