Reading Other Radio Catalogs

This module contains all the messy I/O functionality for reading in the different sky survey catalogs. Each catalog source is initialized as a CatalogSource object to create a uniform set of properties for each radio catalog’s sources. When reading the catalogs for the first time, sources with the uniform set of attributes are written to text files called “[catalog_name]_psql.txt”, which is used to insert the sources into the PostgreSQL database in an efficient way.

Instructions for adding a new catalog:

1. Add catalog name in all lowercase and a new id number to the catalog dictionary. DO NOT re-order the id numbers unless you plan on re-writing all the “*_psql.txt” files and the entire “radcat” schema. Otherwise, the id number of the catalog in the radcat.catalogs table will not match the ‘catalog_id’ of the sources in the catalog’s table.

2. Write a function called read_[catalog name] for reading in the catalog and writing to the text file if it doesn’t exist using the same format as all the others.

3. Add a line to radcatdb.py to call the read_[catalog name] function.

Adapted from EP’s iofuncs.py.

class radiocatalogs.catalogio.CatalogSource

Bases: object

Class for the radio catalog sources. Their catalog origin is identified by the ‘catalog_id’ attribute.

id

Uniquely identifies the source in its catalog.

Type:int

name

Name given to the source in some catalogs.

Type:str

ra

Source right ascension (degrees).

Type:float

e_ra

Error on the right ascension (degrees).

Type:float

dec

Source declination (degrees).

Type:float

e_dec

Error on the declination (degrees).

Type:float

total_flux

Total integrated flux (mJy).

Type:float

e_total_flux

Error on the total flux (mJy).

Type:float

peak_flux

Peak flux density per beam (mJy/beam).

Type:float

e_peak_flux

Error on the peak flux (mJy/beam).

Type:float

maj

FWHM of the source major axis (arcsec).

Type:float

e_maj

Error on the major axis size (arcsec).

Type:float

min

FWHM of the source minor axis (arcsec).

Type:float

e_min

Error on the minor axis size (arcsec).

Type:float

pa

Position angle of the source major axis (degrees).

Type:float

e_pa

Error on the position angle (degrees).

Type:float

rms

Local or image noise (mJy/beam).

Type:float

field

Name of the field where the source is located provided by some catalogs.

Type:str

catalog_id

Uniquely identifies the radio catalog from which this source originates.

Type:int

pt_like

True if source is point-like. Null if unknown

Type:boolean

assoc_id

The id of the closest VLITE source in the assoc_source table.

Type:int

sep

Angular separation between this catalog source and the closest VLITE source (arcsec).

Type:float

radiocatalogs.catalogio.dms2deg(d, m, s)

Translates coordinates from deg:min:sec to decimal degrees. If computing RA, the result needs to be multiplied by 15.

radiocatalogs.catalogio.read_atlas(return_sources=False)

Generates a list of CatalogSource objects from the ATLAS survey catalog and writes them into a file in the same directory called atlas_psql.txt if the file does not already exist.

Telescope/frequency: ATLAS 1.4 GHz

Spatial resolution: 11’’

radiocatalogs.catalogio.read_cosmos(return_sources=False)

Generates a list of CatalogSource objects from the COSMOS Legacy survey catalog and writes them into a file in the same directory called cosmos_psql.txt if the file does not already exist. All non-header lines start with ‘C’.

Telescope/frequency: VLA 320 MHz

Spatial resolution: ~6’’

radiocatalogs.catalogio.read_first(return_sources=False)

Generates a list of CatalogSource objects from the FIRST survey catalog and writes them into a file in the same directory called first_psql.txt if the file does not already exist.

Telescope/frequency: VLA 1.4 GHz

Spatial resolution: 5’’

radiocatalogs.catalogio.read_gleam(return_sources=False)

Generates a list of CatalogSource objects from the GLEAM survey catalog and writes them into a file in the same directory called gleam_psql.txt if the file does not already exist.

Telescope/frequency: MWA 74-231 MHz

Spatial resolution: ~100’’

radiocatalogs.catalogio.read_gpsr1(return_sources=False)

Generates a list of CatalogSource objects from the Galactic Plan 1.4-GHz VLA Survey catalog and writes them into a file in the same directory called gpsr1_psql.txt if the file does not already exist.

Telescope/frequency: VLA 1.4 GHz

Spatial resolution: ~5’’

radiocatalogs.catalogio.read_gpsr5(return_sources=False)

Generates a list of CatalogSource objects from the Galactic Plan 5-GHz VLA Survey catalog and writes them into a file in the same directory called gpsr5_psql.txt if the file does not already exist.

Telescope/frequency: VLA 5 GHz

Spatial resolution: ~4’’

radiocatalogs.catalogio.read_lazio04(return_sources=False)

Generates a list of CatalogSource objects from the Nord et al. Galactic Center survey catalog and writes them into a file in the same directory called lazio04_psql.txt if the file does not already exist.

Telescope/frequency: VLA 330 MHz

Spatial resolution: 6?’’

radiocatalogs.catalogio.read_lofar_hba(return_sources=False)

Generates a list of CatalogSource objects from the Nord et al. Galactic Center survey catalog and writes them into a file in the same directory called lofar_hba_psql.txt if the file does not already exist.

Telescope/frequency: LOFAR 150 MHz

Spatial resolution: 6’’

radiocatalogs.catalogio.read_lofar_lba(return_sources=False)

Generates a list of CatalogSource objects from the Nord et al. Galactic Center survey catalog and writes them into a file in the same directory called lofar_lba_psql.txt if the file does not already exist.

Telescope/frequency: LOFAR 34, 46, & 62 MHz

Spatial resolution: 30-56’’

radiocatalogs.catalogio.read_lotss(return_sources=False)

Generates a list of CatalogSource objects from the Nord et al. Galactic Center survey catalog and writes them into a file in the same directory called lotss_psql.txt if the file does not already exist.

Telescope/frequency: LOFAR 150 MHz

Spatial resolution: 25’’

radiocatalogs.catalogio.read_lotssdr1(return_sources=False)

Generates a list of CatalogSource objects from the LOFAR 2m Sky Survey: LoTSS DR1, catalog and writes them into a file in the same directory called lotssdr1_psql.txt if the file does not already exist.

Telescope/frequency: LOFAR 150 MHz

Spatial resolution: 6’’

radiocatalogs.catalogio.read_m31_glg04(return_sources=False)

Generates a list of CatalogSource objects from the Nord et al. Galactic Center survey catalog and writes them into a file in the same directory called m31_glg04_psql.txt if the file does not already exist.

Telescope/frequency: VLA 325 MHz

Spatial resolution: 6’’

radiocatalogs.catalogio.read_nordgc(return_sources=False)

Generates a list of CatalogSource objects from the Nord et al. Galactic Center survey catalog and writes them into a file in the same directory called nordgc_psql.txt if the file does not already exist.

NOTE: This is actually the Hyman-updated version of the Nord et al. (2004) catalog.

Telescope/frequency: VLA 330 MHz

Spatial resolution: ~10’’

radiocatalogs.catalogio.read_nrl_nvss(return_sources=False)

Generates a list of CatalogSource objects from the Nord et al. Galactic Center survey catalog and writes them into a file in the same directory called nrl_nvss_psql.txt if the file does not already exist.

NOTE: This is our version of the NVSS catalog after running PyBDSF on all NVSS images.

Telescope/frequency: VLA 1.4 GHz

Spatial resolution: 45’’

radiocatalogs.catalogio.read_nvss(return_sources=False)

Generates a list of CatalogSource objects from the NVSS survey catalog and writes them into a file in the same directory called nvss_psql.txt if the file does not already exist.

Telescope/frequency: VLA 1.4 GHz

Spatial resolution: 45’’

radiocatalogs.catalogio.read_psr(return_sources=False)

Generates a list of CatalogSource objects from the ATNF pulsar catalog and writes them into a file in the same directory called psr_psql.txt if the file does not already exist.

Telescope/frequency: Many, set to: ATNF. Will include 1400 MHz fluxes,

if given

Spatial resolution: No fixed resolution, set to: 0’’

radiocatalogs.catalogio.read_racs(return_sources=False)

Generates a list of CatalogSource objects from the Rapid ASKAP Continuum Survey: RACS, catalog and writes them into a file in the same directory called racs_psql.txt if the file does not already exist.

Telescope/frequency: ASKAP 887.5 MHz

Spatial resolution: 25’’

radiocatalogs.catalogio.read_sevenc(return_sources=False)

Generates a list of CatalogSource objects from the 7C survey catalog and writes them into a file in the same directory called sevenc_psql.txt if the file does not already exist.

Telescope/frequency: Cambridge Low Frequency Synthesis Telescope 151 MHz

Spatial resolution: ~70’’

radiocatalogs.catalogio.read_sumss(return_sources=False)

Generates a list of CatalogSource objects from the SUMSS survey catalog and writes them into a file in the same directory called sumss_psql.txt if the file does not already exist.

Telescope/frequency: MOST 843 MHz

Spatial resolution: 45’’

radiocatalogs.catalogio.read_tgss(return_sources=False)

Generates a list of CatalogSource objects from the TGSS survey catalog and writes them into a file in the same directory called tgss_psql.txt if the file does not already exist.

Telescope/frequency: GMRT 150 MHz

Spatial resolution: 25’’

radiocatalogs.catalogio.read_txs(return_sources=False)

Generates a list of CatalogSource objects from the TXS survey catalog and writes them into a file in the same directory called txs_psql.txt if the file does not already exist.

Telescope/frequency: Texas Interferometer 365 MHz

Spatial resolution: 100”?

radiocatalogs.catalogio.read_vlssr(return_sources=False)

Generates a list of CatalogSource objects from the VLA Low-frequency Sky Survey Redux catalog and writes them into a file in the same directory called vlssr_psql.txt if the file does not already exist.

Telescope/frequency: VLA 74 MHz

Spatial resolution: ~75’’

radiocatalogs.catalogio.read_wenss(return_sources=False)

Generates a list of CatalogSource objects from the WENSS survey catalog and writes them into a file in the same directory called wenss_psql.txt if the file does not already exist.

Telescope/frequency: WSRT 325 MHz

Spatial resolution: 54’’

radiocatalogs.catalogio.set_error(catalog, attrs)

Sets missing values for specified attributes to the median value of the distribution.

Parameters:

• catalog (list) – List of CatalogSource objects with missing attribute values.
• attrs (list) – Attribute names which contain missing values to be set to the median of the distribution.

Returns:

catalog – CatalogSource objects with modified attributes that contain no missing values.

Return type:

list