MasterCatalog

class dendrocat.MasterCatalog(*args, catalog=None)[source]

Bases: object

An object to store combined data from two or more RadioSource objects.

Create a new master catalog object.

Parameters:
catalog : astropy.table.Table object

The master table from which to build the catalog object.

*args : radiosource.RadioSource objects

RadioSource objects from which the master table was built.

Methods Summary

add_objects(*args) Add a new RadioSource object to the existing master catalog.
add_sources(*args) Add source entries from another catalog.
ffplot(rsobj1, rsobj2[, apertures, …]) Produce a flux-flux plot for two RadioSource objects.
grab(name[, skip_rejects]) Grab a source or sources by name.
photometer(*args[, catalog]) Add photometry data columns to the master catalog.

Methods Documentation

add_objects(*args)[source]

Add a new RadioSource object to the existing master catalog.

Parameters:
*args : ‘~dendrocat.RadioSource` objects

RadioSource objects to add to the master catalog.

add_sources(*args)[source]

Add source entries from another catalog.

Parameters:
*args : astropy.table.Table objects

Source tables to vertically stack with the existing master catalog.

ffplot(rsobj1, rsobj2, apertures=[], bkg_apertures=[], alphas=None, peak=False, label=False, log=True, outfile=None)[source]

Produce a flux-flux plot for two RadioSource objects.

Parameters:
rsobj1 : RadioSource object

One of two radio source objects from which to make a flux-flux plot.

rsobj2 : RadioSource object

The other of two radio source objects from which to make a flux-flux plot.

apertures : list

List of Aperture objects to use for source apertures.

bkg_apertures : list

List of Aperture objects to use for background apertures.

alphas : list, optional

Spectral indices to overplot on top of the flux-flux data. 1, 2, and 3 will be used by default.

peak : bool, optional

If enabled, peak flux inside the aperture is used instead of aperture sum. Disabled by default.

label : bool, optional

If enabled, labels will be printed on the plot to identify sources. Disabled by default.

log : bool, optional

If enabled, results will be shown on log-log axes. Enabled by default.

outfile : str, optional

If provided, output plot will be saved to this file path.

grab(name, skip_rejects=False)[source]

Grab a source or sources by name.

Parameters:
name : str or list

String or list of strings to search the catalog “_name” header for.

skip_rejects : bool, optional

If enabled, rejected sources will not be queried. Disabled by default.

photometer(*args, catalog=None)[source]

Add photometry data columns to the master catalog.

Parameters:
args : Aperture objects

The apertures to use for photometry. Can be given as either instances or objects, to use fixed or variable aperture widths, respectively.

catalog : astropy.table.Table object

The catalog from which to extract source coordinates and ellipse parameters.