runOneFilter

lsst.validate.drp.validate.runOneFilter(repo, visitDataIds, brightSnrMin=None, brightSnrMax=None, 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:

repo : string or Butler

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

dataIds : list 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.

brightSnrMin : float, optional

Minimum median SNR for a source to be considered bright; passed to lsst.validate.drp.matchreduce.build_matched_dataset.

brightSnrMax : float, optional

Maximum median SNR for a source to be considered bright; passed to lsst.validate.drp.matchreduce.build_matched_dataset.

makeJson : bool, optional

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

outputPrefix : str, optional

Specify the beginning filename for output files.

filterName : str, optional

Name of the filter (bandpass).

doApplyExternalPhotoCalib : bool, optional

Apply external photoCalib to calibrate fluxes.

externalPhotoCalibName : str, optional

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

doApplyExternalSkyWcs : bool, optional

Apply external wcs to calibrate positions.

externalSkyWcsName : str, optional

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

skipTEx : bool, optional

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

verbose : bool, optional

Output additional information on the analysis steps.

skipNonSrd : bool, 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.