Imaging Flanking Fields
Overview
The ability to image flanking fields will be introduced in CASA v. 3.0.0. For the purposes of this guide, flanking fields are the locations of neighboring radio sources that can contribute significant, confusing signal to your science target. The confusing signal is introduced through sidelobes, which are local maxima of the point response function, or beam, of the array. The contaminating sidelobes are reduced by imaging and deconvolving the neighboring radio sources.
One approach is simply to make a sufficiently large image around your science target to include neighboring radio sources, but unfortunately these images can become inconveniently (or impractically) large. There are two angular scales important to the discussion: the synthesized beam and the primary beam. The synthesized beam is the effective angular resolution of the array and is determined by the longest baselines, or telescope separations. The primary beam is the angular resolution of a single telescope in the array, and is determined by its physical diameter. The response to radio sources outside 1-2 times the primary beam is very poor, and, unless they are peculiarly bright, such radio sources will contribute negligible confusing signal. The scale of both synthesized beam and the primary beam can be approximated by the Rayleigh criterion.
Here's the problem. Long baseline configurations require small pixels to sample the synthesized beam, and the number of pixels required to map the primary beam becomes inconveniently large. To illustrate, the following table lists the image sizes required to map the VLA primary beam at observing frequency 1.4 GHz and for the four primary array configurations. The primary beam at this frequency is ~32'.
| Configuration | A | B | C | D |
|---|---|---|---|---|
| Synthesized Beam(") | 1.4 | 4.6 | 15 | 50 |
| Pixels | 4200 | 1300 | 380 | 120 |
The upshot is that VLA A-array and B-array observations would require very large, mostly empty images to map the primary beam. It's potentially faster and certainly lighter on disk space to make postage stamp images, or smaller images centered at the science target and flanking fields that contain bright radio sources.
To set up flanking fields in clean, you just need to set up appropriate lists for phase centers, image names, and image sizes. The following is an example specifically from the help file for clean.
imagename = ['M1_0','M1_1','M1_2]
imsize = [
[1024,1024],
[128,128],
[128,128]
]
phasecenter = [
'J2000 13h27m20.98 43d26m28.0',
'J2000 13h30m52.159 43d23m08.02',
'J2000 13h24m08.16 43d09m48.0'
]
<source>
== Example: VLA A-array Continuum Observations of NGC 3079 ==
To illustrate the use of flanking fields, we will use CASA to image archival 1.4 GHz, A-array observations of NGC 3079. These data (program AU079) may be obtained from the [https://archive.nrao.edu/archive/ArchiveQuery?PASSWD=&QUERYTYPE=ARCHIVE&PROTOCOL=HTML&SORT_PARM=Starttime&SORT_ORDER=Asc&MAX_ROWS=NO+LIMIT&SORT_PARM2=Starttime&SORT_ORDER2=Asc&QUERY_ID=9999&QUERY_MODE=Prepare+Download&LOCKMODE=PROJECT&SITE_CODE=AOC&DBHOST=CHEWBACCA&WRITELOG=0&PROJECT_CODE=AU0079&SEGMENT=&OBSERVER=&ARCHIVE_VOLUME=&TIMERANGE1=&TIMERANGE2=&SOURCE_ID=&SRC_SEARCH_TYPE=SIMBAD+or+NED+Resolver&CALIB_TYPE=ALL+Srcs&CENTER_RA=&LONG_RANGE=&FRAME=Equatorial&CENTER_DEC=&LAT_RANGE=&EQUINOX=J2000&SRAD=1.0%27&MIN_EXPOSURE=&OBS_BANDS=L&TELESCOPE=VLA&OBS_MODE=ALL&CORR_MODE=ALL&TELESCOPE_CONFIG=A&OBS_POLAR=ALL&OBSFREQ1=&DATATYPE=ALL&OBSBW1=&ARCHFORMAT=ALL&SUBMIT=Submit+Query VLA Archive]. [http://nedwww.ipac.caltech.edu/cgi-bin/nph-objsearch?objname=NGC3079&extend=no&hconst=73&omegam=0.27&omegav=0.73&corr_z=1&out_csys=Equatorial&out_equinox=J2000.0&obj_sort=RA+or+Longitude&of=pre_text&zv_breaker=30000.0&list_limit=5&img_stamp=YES NGC 3079] is an edge-on galaxy with kiloparsec-scale, minor-axis radio lobes.
== Determining the Location of Flanking Fields ==
There are two approaches to determining the location of flanking fields. The first is to make a tapered image with large pixels and map the primary beam at artificially poorer angular resolution. The positions of confusing sources can be read off using the CASA viewer. The second approach is to use the on-line [http://www.cv.nrao.edu/nvss/ NVSS] catalog, which has effectively performed the tapering and imaging for you.
The location of flanking fields is determined in two steps: (1) generating an NVSS postage stamp image to identify potential confusing radio sources, and (2) using the NVSS catalog to look up the coordinates of the confusing sources.
=== NVSS Postage Stamp Image Server ===
[[File:N3079stamp.jpg|thumb|NVSS postage stamp image of NGC 3079 and its surroundings. The image size is 30' x 30', spanning nearly two primary beamwidths in either dimension.]]
First, use the [http://www.cv.nrao.edu/nvss/postage.shtml postage stamp image server] to generate an NVSS image of radio sources surrounding NGC 3079. Example inputs to the form are shown in the figure below, and the result is shown in the figure at right.
[[image:NVSSPostageServer_65percent.jpg | Inputs to the NVSS postage stamp server. These inputs produce a 30' x 30' image surrounding NGC 3079.]]
Alternatively, one could specify "FITS" for the image type, and the coordinates of the confusing sources could be read using a FITS image viewer.
From inspection of the postage stamp image, there are 5 radio sources to be imaged including NGC 3079. We'll use the NVSS catalog to get their coordinates.
=== NVSS Catalog ===
Appropriate inputs for the [http://www.cv.nrao.edu/nvss/NVSSlist.shtml NVSS Catalog Browser] are shown in the figure below.
[[File:NVSSCatalogExample.png | Example inputs to the NVSS catalog browser to look for neighboring radio sources of NGC 3079.]]
The results of this search are provided in the following table. Sources fainter than 10 mJy were removed, and the results are sorted in order of increasing distance from the search center.
{| border="1"
! RA(2000)
! Dec(2000)
! Dist(")
! Flux(mJy)
! Notes
|- align="right"
| 10 01 57.82 || +55 40 48.5 || <2 || 769.4 || NGC 3079 Nucleus
|- align="right"
| 10 01 58.71 || +55 39 33.3 || 74 || 52.0 || Disk of NGC 3079
|- align="right"
| 10 01 55.53 || +55 42 04.9 || 80 || 44.0 || Disk of NGC 3079
|- align="right"
| 10 00 58.93 || +55 40 56.7 || 498 || 56.6 || Nearby radio source
|- align="right"
| 10 02 09.96 || +55 51 26.9 || 648 || 19.7 || Nearby radio source
|- align="right"
| 10 02 45.35 || +55 51 25.2 || 754 || 38.6 || Nearby radio source
|- align="right"
| 10 01 21.07 || +55 53 55.8 || 847 || 551.4 || Nearby radio source
|}
All of the sources associated with NGC 3079 will comfortably image onto one field; the neighboring sources will require the use of flanking fields.
== Editing and Calibration ==
The following script follows the more detailed tutorial, [[Calibrating a VLA 5 GHz continuum survey | Calibrating a VLA 5 GHz continuum survey]]. Some things to note:
* This script employs the python ''glob'' command, which generates lists of file names based on wildcard matches.
* Antennas 13 and 26 appeared were misbehaving during the run and are flagged after loading the data.
* If all goes well, the script will generate two measurement sets, "au079.ms," which is the measurement set containing the source and its calibrators, and "N3079.split.ms," which contains the primary calibrated data for N3079.
<source lang="python">
# from loaddata.py
from glob import glob
# Define the list of files for reading. Use glob to perform wildcard matching with VLA archive filenames.
fileList = glob('AU079_*.xp?')
importvla(archivefiles=fileList,vis='au079.ms')
listobs('au079.ms')
vishead('au079.ms')
# used viewer to view au079.ms and identified flaky telescopes
# also used casaplotms to identify residual, flaky visibilities
default(flagdata)
vis = 'au079.ms'
# these antennas were producing some junk!
antenna = '13,21'
spw = '0,1'
correlation = ''
timerange = ''
mode = 'manualflag'
clipexpr = 'I'
flagdata()
antenna = ''
mode = ''
# from au079.py
#vis = 'au079.ms'
#xaxis = 'x'
#plotxy()
myRefAnt = 'VA06'
myChans = '0,1'
ampcallist = ['1331+305']
phasecallist = ['0957+553']
sourcelist = ['N3079']
allcals = ampcallist + phasecallist
calDict = {'N3079':'0957+553'}
# set flux calibrator numbers
default(setjy)
modimage = '/usr/lib64/casapy/data/nrao/VLA/CalModels/3C286_L.im'
setjy('au079.ms', field = ampcallist[0], spw=myChans)
# generate initial calibration solutions
rmtables('cal.G')
gaincal(vis='au079.ms',spw=myChans,caltable='cal.G', field=','.join(allcals), solint='inf',
refant=myRefAnt, append=False, gaincurve=True)
# generate amplitude calibration for phase cal
rmtables('cal.Gflx')
fluxscale(vis='au079.ms', caltable='cal.G',reference=','.join(ampcallist), transfer
= ','.join(phasecallist), fluxtable='cal.Gflx', append=False)
# apply calibrations to the source
# first, generate a blank table
accum(vis='au079.ms',tablein='',accumtime=10.0,incrtable='cal.Gflx',
interp='linear', caltable='multisource.gcal',
field=','.join(allcals), calfield=','.join(allcals))
# now accumulate solutions onto that table
# loop over the source and calibrator pairs in the calDict dictionary variable
for source, calibrator in calDict.iteritems():
accum(vis='au079.ms',tablein='multisource.gcal',accumtime=10.0,
incrtable='cal.Gflx',
interp='linear', field=source,
calfield=calibrator)
# Finally, apply the calibrations to the measurement set
default(applycal)
applycal(vis='au079.ms', gaintable='multisource.gcal',
gaincurve=True)
splitfile = 'N3079.split.ms'
rmtables(splitfile) # get rid of any old versions before splitting
split(vis='au079.ms',outputvis=splitfile, datacolumn='corrected', field='N3079', spw=myChans)
Imaging with Flanking Fields
Imaging with flanking fields uses either the outlierfile or phasecenter parameter of clean; in this tutorial we'll use the phasecenter parameter. First, set up clean. The listed parameter choices are reasonable for a VLA snapshot, 1.4 GHz continuum observation.
vis = 'N3079.split.ms' # name of input visibility file
outlierfile = '' # Text file with image names, sizes, centers
field = '' # Field Name
spw = '0,1' # Spectral windows:channels: '' is all
selectdata = False # Other data selection parameters
mode = 'mfs' # Type of selection (mfs, channel, velocity,frequency)
gridmode = '' # The kind gridding kernel to be used for FFT-based transforms
niter = 5000 # Maximum number of iterations
gain = 0.1 # Loop gain for cleaning
threshold = '0.04mJy' # Flux level to stop cleaning. Must include units
psfmode = 'clark' # method of PSF calculation to use during minor cycles
imagermode = 'csclean' # Use csclean or mosaic. If '', use psfmode
cyclefactor = 2
cyclespeedup = 50
multiscale = [] # deconvolution scales (pixels); [] = default standard clean
interactive = False # use interactive clean (with GUI viewer)
mask = [] # cleanbox(es), mask image(s), and/or region(s) used in cleaning
cell = ['0.3arcsec', '0.3arcsec'] # x and y cell size. default unit arcsec
restfreq = '' # rest frequency to assign to image (see help)
stokes = 'I' # Stokes params to image (eg I,IV, QU,IQUV)
weighting = 'natural' # Weighting of uv (natural, uniform, briggs, ...)
uvtaper = False # Apply additional uv tapering of visibilities.
modelimage = '' # Name of model image(s) to initialize cleaning
restoringbeam = [''] # Output Gaussian restoring beam for CLEAN image
pbcor = False # Output primary beam-corrected image
minpb = 0.1 # Minimum PB level to use
calready = True # Create scratch columns and store model visibilities so that selfcal can be run after
# clean
async = False # If true the taskname must be started using clean(...)
Now, set up the flanking fields. For each field, we need an imagename, a phasecenter, and an image size (in pixels).
imagename = [
'N3079_00',
'N3079_01',
'N3079_02',
'N3079_03',
'N3079_04'
] # Pre-name of output images
phasecenter = [
'J2000 10h01m57.82 +55d40m48.5',
'J2000 10h01m21.07 +55d53m55.8',
'J2000 10h00m58.93 +55d40m56.7',
'J2000 10h02m09.96 +55d51m26.9',
'J2000 10h02m45.35 +55d51m25.2'
]
imsize = [
[512,512],
[256,256],
[256,256],
[256,256],
[256,256]
]
clean()
The resulting clean-deconvolved images will be stored in N3079_01.image, N3079_02.image, etc and can be viewed using viewer.
--Jgallimo 19:34, 12 November 2009 (UTC)
