MultiVisitCoveragePlot

class lsst.analysis.tools.actions.plot.MultiVisitCoveragePlot(*args, **kw)

Bases: PlotAction

Plot the coverage for a set of visits.

Attributes Summary

bandLabelColorDict

A dict mapping which color to use for the labels of a given band.

cmapName

Name of the color map to be used if not using the default color-blind friendly orange/blue default (used if this is set to None).

doScatterInRaDec

Whether to scatter the points in RA/Dec before plotting.

nBins

Number of bins to use within the effective plot ranges along the spatial directions.

nPointBinThresh

Threshold number of data points above which binning of the data will be performed in the RA/Dec projection.

parametersToPlotList

List of paramters to plot.

plotAllTractOutlines

Whether to plot tract outlines for all tracts within the plot limits (regardless if they have any data in them).

plotDetectorOutline

Whether to plot a shaded outline of the detector size in the RA/Dec projectionfor reference.

plotName

The name for the plot.

projection

Projection to plot.

raDecLimitsDict

A dict mapping the RA/Dec limits to apply to the plot.

showExtremeOutliers

Use overlaid scatter points to show the x-y positions of the 15% most extreme values? (bool, default True)

sortedFullBandList

List of all bands that could, in principle, but do not have to, exist in data table.

tractsToPlotList

List of tracts within which to limit the RA and Dec limits of the plot.

trimToTract

Whether to trim the plot limits to the tract limit(s).

unitsDict

A dict mapping a parameter to its appropriate units (for label plotting).

vectorsToLoadList

List of columns to load from input table.

Methods Summary

__call__(data, **kwargs)

Call self as a function.

getInputSchema()

Return the schema an AnalysisAction expects to be present in the arguments supplied to the __call__ method.

makePlot(data[, plotInfo, camera, skymap, ...])

Make an Nband x Nparameter panel multi-visit coverage plot.

Attributes Documentation

bandLabelColorDict

A dict mapping which color to use for the labels of a given band. (Dict, default {'u': 'tab:purple', 'g': 'tab:blue', 'r': 'tab:green', 'i': 'gold', 'z': 'tab:orange', 'y': 'tab:red', 'N921': 'tab:pink'})

cmapName

Name of the color map to be used if not using the default color-blind friendly orange/blue default (used if this is set to None). Any name available via matplotlib.cm may be used. (str, default None)

doScatterInRaDec

Whether to scatter the points in RA/Dec before plotting. This may be useful for visualization for surveys with tight dithering patterns. (bool, default False)

nBins

Number of bins to use within the effective plot ranges along the spatial directions. Only used in the “raDec” projection (for the “focalPlane” projection, the binning is effectively one per detector). (int, default 25)

nPointBinThresh

Threshold number of data points above which binning of the data will be performed in the RA/Dec projection. If projection is “focalPlane”, the per-detector nPoint threshold is nPointMinThresh/number of science detectors in the given camera. (int, default 400)

parametersToPlotList

List of paramters to plot. They are plotted along rows and the columns plot these parameters for each band. (List, default ['psfSigma', 'astromOffsetMean', 'medianE', 'psfStarScaledDeltaSizeScatter', 'skyBg', 'zeroPoint'])

plotAllTractOutlines

Whether to plot tract outlines for all tracts within the plot limits (regardless if they have any data in them). (bool, default False)

plotDetectorOutline

Whether to plot a shaded outline of the detector size in the RA/Dec projectionfor reference. Ignored if projection is not raDec or no camera is provided in the inputs. (bool, default False)

plotName

The name for the plot. (str)

projection

Projection to plot. Currently only “raDec” and “focalPlane” are permitted. In either case, one point is plotted per visit/detector combination. (str, default 'raDec')

raDecLimitsDict

A dict mapping the RA/Dec limits to apply to the plot. Set to None to use base limits on the default or the other config options. The dict must contain the keys raMin, ramax, decMin, decMax, e.g. raDecLimitsDict = {“raMin”: 0, “raMax”: 360, “decMin”: -90, “decMax”: 90}. Not compatible with trimToTract or tractsToPlotList (i.e. the latter two will be ignored if the dict is not None). (Dict, default None)

showExtremeOutliers

Use overlaid scatter points to show the x-y positions of the 15% most extreme values? (bool, default True)

sortedFullBandList

List of all bands that could, in principle, but do not have to, exist in data table. The sorting of the plot panels will follow this list (typically by wavelength). (List, default ['u', 'g', 'r', 'i', 'z', 'y', 'N921'])

tractsToPlotList

List of tracts within which to limit the RA and Dec limits of the plot. (List, default None)

trimToTract

Whether to trim the plot limits to the tract limit(s). Otherwise, plot will be trimmed to data limits (both will be expanded in the smaller range direction for an equal aspect square plot). (bool, default False)

unitsDict

A dict mapping a parameter to its appropriate units (for label plotting). (Dict, default {'astromOffsetMean': 'arcsec', 'astromOffsetStd': 'arcsec', 'psfSigma': 'pixels', 'skyBg': 'counts', 'skyNoise': 'counts', 'visit': 'number', 'detector': 'number', 'zenithDistance': 'deg', 'zeroPoint': 'mag', 'ra': 'deg', 'decl': 'deg', 'xFp': 'mm', 'yFp': 'mm', 'medianE': '', 'psfStarScaledDeltaSizeScatter': '', 'psfTraceRadiusDelta': 'pixel'})

vectorsToLoadList

List of columns to load from input table. (List, default ['visitId', 'detector', 'band', 'ra', 'decl', 'zeroPoint', 'psfSigma', 'skyBg', 'astromOffsetMean', 'psfStarDeltaE1Median', 'psfStarDeltaE2Median', 'psfStarScaledDeltaSizeScatter', 'psfTraceRadiusDelta', 'llcra', 'lrcra', 'ulcra', 'urcra', 'llcdec', 'lrcdec', 'ulcdec', 'urcdec', 'xSize', 'ySize'])

Methods Documentation

__call__(data: MutableMapping[str, ndarray[Any, dtype[ScalarType]] | Scalar | HealSparseMap | Tensor], **kwargs) Mapping[str, Figure] | Figure

Call self as a function.

getInputSchema() Tensor]]]

Return the schema an AnalysisAction expects to be present in the arguments supplied to the __call__ method.

Returns:
resultKeyedDataSchema

The schema this action requires to be present when calling this action, keys are unformatted.

makePlot(data: MutableMapping[str, ndarray[Any, dtype[ScalarType]] | Scalar | HealSparseMap | Tensor], plotInfo: Mapping[str, str] | None = None, camera: Camera | None = None, skymap: BaseSkyMap | None = None, calibrateConfig: Config | None = None, makeWarpConfig: Config | None = None, **kwargs) Figure

Make an Nband x Nparameter panel multi-visit coverage plot.

The panels rows are for different bands,sorted according to the order in config sortedFullBandList. The columns are per-parameter, plotted in the order given by the config parametersToPlotList. Red “over” colors indicate thresholds in play in the data processing (e.g. used to select against data of sufficient quality).

Parameters:
datalsst.analysis.tools.interfaces.KeyedData

The key-based catalog of data to plot.

plotInfodict [str], optional

A dictionary of information about the data being plotted with (at least) keys:

"run"

Output run for the plots (str).

"tableName"

Name of the table from which results are taken (str).

cameralsst.afw.cameraGeom.Camera, optional

The camera object associated with the data. This is to enable the conversion of to focal plane coordinates (if needed, i.e. for the focal plane projection version of this plot) and to obtain the projected (in RA/Dec) size of a typical detector (for reference in the raDec projection plots when requested, i.e. if the config plotDetectorOutline is True).

skymaplsst.skymap.BaseSkyMap, optional

The sky map used for this dataset. If a specific tract[List] is provided, this is used to determine the appropriate RA & Dec limits to downselect the data to within those limits for plotting.

calibrateConfiglsst.pex.config.Config, optional

The persisted config used in the calibration task for the given collection. Used to introspect threshold values used in the run.

makeWarpConfiglsst.pex.config.Config, optional

The persisted config used in the makeWarp task for the given collection. Used to introspect threshold values used in the run.

Returns:
figmatplotlib.figure.Figure

The resulting figure.