plot_points

Catalog.plot_points(*, ra_column: str | None = None, dec_column: str | None = None, color_col: str | None = None, projection: str = 'MOL', title: str | None = None, fov: Quantity | tuple[Quantity, Quantity] | None = None, center: SkyCoord | None = None, wcs: astropy.wcs.WCS | None = None, frame_class: Type[BaseFrame] | None = None, ax: WCSAxes | None = None, fig: Figure | None = None, **kwargs)

Plots the points in the catalog as a scatter plot

Performs a scatter plot on a WCSAxes after computing the points of the catalog. This will perform compute on the catalog, and so may be slow/resource intensive. If the fov or wcs args are set, only the partitions in the catalog visible to the plot will be computed. The scatter points can be colored by a column of the catalog by using the color_col kwarg.

Parameters:

ra_columnstr | None, default None

The column to use as the RA of the points to plot. Defaults to the catalog’s default RA column. Useful for plotting joined or cross-matched points

dec_columnstr | None, default None

The column to use as the Declination of the points to plot. Defaults to the catalog’s default Declination column. Useful for plotting joined or cross-matched points

color_colstr | None, default None

The column to use as the color array for the scatter plot. Allows coloring of the points by the values of a given column.

projectionstr, default “MOL”

The projection to use in the WCS. Available projections listed at https://docs.astropy.org/en/stable/wcs/supported_projections.html

titlestr, default None

The title of the plot

fovQuantity or Sequence[Quantity, Quantity] | None, default None

The Field of View of the WCS. Must be an astropy Quantity with an angular unit, or a tuple of quantities for different longitude and latitude FOVs (Default covers the full sky)

centerSkyCoord | None, default None

The center of the projection in the WCS (Default: SkyCoord(0, 0))

wcsWCS | None, default None

The WCS to specify the projection of the plot. If used, all other WCS parameters are ignored and the parameters from the WCS object is used.

frame_classType[BaseFrame] | None, default None

The class of the frame for the WCSAxes to be initialized with. if the ax kwarg is used, this value is ignored (By Default uses EllipticalFrame for full sky projection. If FOV is set, RectangularFrame is used)

axWCSAxes | None, default None

The matplotlib axes to plot onto. If None, an axes will be created to be used. If specified, the axes must be an astropy WCSAxes, and the wcs parameter must be set with the WCS object used in the axes. (Default: None)

figFigure | None, default None

The matplotlib figure to add the axes to. If None, one will be created, unless ax is specified (Default: None)

**kwargs

Additional kwargs to pass to creating the matplotlib scatter function. These include c for color, s for the size of hte points, marker for the maker type, cmap and norm if color_col is used

Returns:

tuple[Figure, WCSAxes]

The figure and axes used for the plot