source_catalog¶

jwst_novt.footprints.source_catalog(catalog_file)[source]¶

Create point regions for a source catalog.

The input catalog is in ‘.radec’ form. Three whitespace-separated columns are expected: RA, Dec, and flag. RA and Dec must be in degrees. The flag may be ‘P’ for primary source or ‘F’ for filler.

Note that this method produces a single region for each source. It is suitable for saving to DS9 region files, for example, but for display purposes, it may be faster to make a scatter plot out of all sources at once, directly from the catalog. See jwst_novt.display.bqplot_catalog for an example.

Parameters:: catalog_file (str or pandas.DataFrame) – Path to a .radec catalog file or a DataFrame containing columns ‘ra’, ‘dec’, and optionally, ‘flag’.
Returns:: primary_sources, filler_sources – Catalog source regions, returned as 2 separate sets for primary and filler sources. All contained regions are Point regions in sky coordinates.
Return type:: regions.Regions, regions.Regions