runOneFilter

lsst.validate.drp.validate.runOneFilter(repo, visitDataIds, metrics, brightSnr=100, makeJson=True, filterName=None, outputPrefix='', doApplyExternalPhotoCalib=False, externalPhotoCalibName=None, doApplyExternalSkyWcs=False, externalSkyWcsName=None, skipTEx=False, verbose=False, metrics_package='verify_metrics', instrument='Unknown', dataset_repo_url='./', skipNonSrd=False, **kwargs)

Main executable for the case where there is just one filter.

Plot files and JSON files are generated in the local directory prefixed with the repository name (where ‘_’ replace path separators), unless overriden by specifying outputPrefix. E.g., Analyzing a repository CFHT/output will result in filenames that start with CFHT_output_.

Parameters

repostring or Butler

A Butler or a repository URL that can be used to construct one.

dataIdslist of dict

List of butler data IDs of Image catalogs to compare to reference. The calexp pixel image is needed for the photometric calibration unless doApplyExternalPhotoCalib is True such that the appropriate photoCalib dataset is used. Note that these have data IDs that include the tract number.

metricsdict or collections.OrderedDict

Dictionary of lsst.validate.base.Metric instances. Typically this is data from validate_drp’s metrics.yaml and loaded with lsst.validate.base.load_metrics.

brightSnrfloat, optional

Minimum SNR for a star to be considered bright

makeJsonbool, optional

Create JSON output file for metrics. Saved to current working directory.

outputPrefixstr, optional

Specify the beginning filename for output files.

filterNamestr, optional

Name of the filter (bandpass).

doApplyExternalPhotoCalibbool, optional

Apply external photoCalib to calibrate fluxes.

externalPhotoCalibNamestr, optional

Type of external PhotoCalib to apply. Currently supported are jointcal, fgcm, and fgcm_tract. Must be set if doApplyExternalPhotoCalib is True.

doApplyExternalSkyWcsbool, optional

Apply external wcs to calibrate positions.

externalSkyWcsNamestr, optional

Type of external wcs to apply. Currently supported is jointcal. Must be set if “doApplyExternalSkyWcs” is True.

skipTExbool, optional

Skip TEx calculations (useful for older catalogs that don’t have PsfShape measurements).

verbosebool, optional

Output additional information on the analysis steps.

skipNonSrdbool, optional

Skip any metrics not defined in the LSST SRD.

Raises

RuntimeError:

Raised if “doApplyExternalPhotoCalib” is True and “externalPhotoCalibName” is None, or if “doApplyExternalSkyWcs” is True and “externalSkyWcsName” is None.