Find sources using VizieR catalogs and create an outlierfile for input to cleanFind sources using VizieR catalog queries and create an outlierfile for input to clean; useful for making flanking images of bright sourcesName of output outlierfile to produceCentral position for catalog query (byfield, bycoord)byfieldbyfieldbycoordName of input visibility fileField name or indexRight ascension (decimal degrees)0.0Declination (decimal degrees)0.0Catalog name (see http://vizier.u-strasbg.fr/viz-bin/VizieR)NVSSVizieR catalog flux density keyS1.4VizieR catalog flux density limit0.0Inner radius for catalog search (arcminutes)0.0Outer radius for catalog search (arcminutes)10.0x and y image sizes in pixels256256Clobber/overwrite existing files?False0.00.0
This task queries the selected VizieR catalog around
coordinates defined by either the phase center of a source in
the input visibility file or an input RA, Dec. It creates an
outlier file which can be used by clean to create images of
flanking fields. This is particularly useful if there is a
bright source relatively nearby which would create imaging
artifacts if ignored.
Any VizieR catalog may be used -- check the list at
(http://vizier.u-strasbg.fr/viz-bin/vizHelp?cats/U.htx) for
useful catalog abbreviations. Note that some abbreviations
are ambiguous: in this case, use the full catalog name, or
VizieR will query multiple catalogs.
VizieR input and output files are saved as
'VizieR_query-yyyy.mm.dd-hhmmss.txt' and
'VizieR_return-yyyy.mm.dd-hhmmss.txt' in the working directory.
Keyword arguments:
outlierfile -- name of output outlierfile
querycenter -- Either 'byfield', in which case it will use the
phase center of the requested object, or 'bycoord',
in which case it will use the input RA and Dec for
the center coordinates of the catalog query.
vis -- Name of input visibility file; needed if querycenter =
'byfield' to determine phase center of source.
Example: vis = 'obs.ms'
field -- Field name or index around which to perform query;
needed if querycenter = 'byfield'.
Example: field = '0' or field = '0137*' (where the
asterisk indicates a wildcard match)
ra -- Right ascension around which to perform query (decimal
degrees); needed if querycenter = 'bycoord'.
Example: ra = 12.34567
dec -- Declination around which to perform query (decimal
degrees); needed if querycenter = 'bycoord'.
Example: dec = -12.34567
catalog -- Catalog to query via VizieR
(http://vizier.u-strasbg.fr/viz-bin/VizieR).
Example: catalog='VIII/81A/sumss2_1'
fluxparam -- VizieR catalog flux density key. Check VizieR
for appropriate values.
Example: fluxparam = 'Fint' (for FIRST)
fluxlim -- VizieR catalog flux density limit corresponding to
fluxparam. Sources below this value will not be
included in the outlierfile. Must be set to zero
if fluxparam is left blank. Units will depend on
the chosen catalog's units for fluxparam.
Example: fluxlim = 10.0
minradius -- Inner radius for producing outlier file
(arcminutes). Any source found within this
radius will be ignored.
Example: minradius = 0.167 will ignore sources
less than 10 arcseconds from the query center.
maxradius -- Outer radius for catalog search (arcminutes).
Example: maxradius = 100.0
imsize -- array containing the [x, y] image size (pixels) to
write into the outlier file. This will be used by
clean to determine image sizes.
Example: imsize = [1024, 1024]
clobber -- boolean parameter which sets whether or not
findsources will overwrite an existing outlierfile
of the requested name.
default = False -- do not overwrite.
async -- Run asynchronously
default = False -- do not run asychronously.