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

int – Uniquely identifies the source in its catalog.

name

str – Name given to the source in some catalogs.

ra

float – Source right ascension (degrees).

e_ra

float – Error on the right ascension (degrees).

dec

float – Source declination (degrees).

e_dec

float – Error on the declination (degrees).

total_flux

float – Total integrated flux (mJy).

e_total_flux

float – Error on the total flux (mJy).

peak_flux

float – Peak flux density per beam (mJy/beam).

e_peak_flux

float – Error on the peak flux (mJy/beam).

maj

float – FWHM of the source major axis (arcsec).

e_maj

float – Error on the major axis size (arcsec).

min

float – FWHM of the source minor axis (arcsec).

e_min

float – Error on the minor axis size (arcsec).

pa

float – Position angle of the source major axis (degrees).

e_pa

float – Error on the position angle (degrees).

rms

float – Local or image noise (mJy/beam).

field

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

catalog_id

int – Uniquely identifies the radio catalog from which this source originates.

assoc_id

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

sep

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

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_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_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_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