lsst.meas.extensions.multiprofit

lsst.meas.extensions.multiprofit implements separate tasks for PSF and source model fitting using lsst.multiprofit. The tasks depend on more generic lsst.pipe.tasks.PipelineTask classes defined in lsst.pipe.tasks.fit_coadd_psf and lsst.pipe.tasks.fit_coadd_multiband. Both of the PSF and source model-fitting tasks operate row-by-row on single deblended objects from direct coadds. Tickets such as DM-42968 may add additional functionality like multi-object fitting and initializing models from previous fit parameters.

Because these tasks produce per-patch Arrow/Astropy tables, a generic task to consolidate the results into a single multiband tract-based table is provided in lsst.meas.extensions.multiprofit.consolidate_astropy_table. It is anticipated that some of this functionality will be folded into the tasks producing objectTable_tract outputs in lsst.pipe.tasks.postprocess.

Using lsst.meas.extensions.multiprofit

Besides the tasks classes themselves, various conveniently configured subclasses are provided in lsst.meas.extensions.multiprofit.pipetasks_fit, lsst.meas.extensions.multiprofit.pipetasks_match, and lsst.meas.extensions.multiprofit.pipetasks_merge.

Note

While use of these classes is not mandatory, it is recommended since they are standard configurations used in DRP pipelines and, amongst other things, set consistent dataset type names for commonly-used models.

To analyze the outputs, lsst.meas.extensions.multiprofit.analysis_tools provides subclasses of lsst.analysis.tools tools for producing plots and metrics.

lsst.meas.extensions.multiprofit.plots provides functions and classes for visualizing individual blends. lsst.meas.extensions.multiprofit.rebuild_coadd_multiband expands on this functionality with classes that can load and plot images from an entire patch while overlaying relevant model parameters.

Contributing

lsst.meas.extensions.multiprofit is developed at https://github.com/lsst/meas_extensions_multiprofit. You can find Jira issues for this module under the meas_extensions_multiprofit component.

Task reference

Pipeline tasks

No topics.

Command-line tasks

No topics.

Tasks

No topics.

Configurations

No topics.

Python API reference

lsst.meas.extensions.multiprofit.consolidate_astropy_table Module

Classes

ConsolidateAstropyTableConfigBase(*args, **kw)	Config for ConsolidateAstropyTableTask.
ConsolidateAstropyTableConnections(*[, config])	Connections for ConsolidateAstropyTableTask.
ConsolidateAstropyTableConfig(*args, **kw)	PipelineTaskConfig for ConsolidateAstropyTableTask.
ConsolidateAstropyTableTask(*[, config, ...])	Write patch-merged astropy tables to a tract-level astropy table.

lsst.meas.extensions.multiprofit.fit_coadd_multiband Module

Classes

PsfFitSuccessActionBase(*args, **kw)	Base action to return whether a source had a succesful PSF fit.
PsfComponentsActionBase(*args, **kw)	Base action to return a list of Gaussians from a source mapping.
SourceTablePsfFitSuccessAction(*args, **kw)	Action to return PSF fit status from a SourceTable row.
SourceTablePsfComponentsAction(*args, **kw)	Action to return PSF components from a SourceTable.
MagnitudeDependentSizePriorConfig(*args, **kw)	Configuration for a magnitude-dependent size prior.
ModelInitializer(*, inputs, typing.Any] =, ...)	An interface for a configurable model initializer based on priors and optional external data.
MakeInitializerActionBase(*args, **kw)	An interface for an action that creates an initializer.
BasicModelInitializer(*, inputs, ...)	A generic model initializer that should work on most kinds of models with a single source.
CachedBasicModelInitializer(*, inputs, ...)	A basic initializer with a cached list of model sources and priors.
InitialInputData(*[, column_id, size_column])	A configurable wrapper to retrieve formatted columns from a catalog.
MakeBasicInitializerAction(*args, **kw)	An action to construct an initializer for a single-component, single-source model.
MakeCachedBasicInitializerAction(*args, **kw)	A MakeBasicInitializerAction that caches references to the source and prior objects of the model.
MultiProFitSourceConfig(*args, **kw)	Configuration for the MultiProFit profile fitter.
CatalogExposurePsfs(*, dataId, catalog, ...)	Input data from lsst pipelines, parsed for MultiProFit.
MultiProFitSourceFitter(wcs, ...)	A MultiProFit source fitter.
MultiProFitSourceTask(**kwargs)	Run MultiProFit on Exposure/SourceCatalog pairs in multiple bands.

lsst.meas.extensions.multiprofit.fit_coadd_psf Module

Classes

CatalogPsfFitter([modeller, errors_expected])	Fit a Gaussian mixture model to a pixelated PSF image.
CatalogPsfFitterConfig(*args, **kw)	Configuration for MultiProFit PSF image fitter.
CatalogPsfFitterConfigData(*, config)	A PSF fit configuration that can initialize models and images thereof.
ComponentGroupConfig(*args, **kw)	Configuration for a group of lsst.gauss2d.fit Components.
FluxFractionParameterConfig(*args, **kw)	Configuration for flux fraction parameters (ProperFractionParameterD).
FluxParameterConfig(*args, **kw)	Configuration for flux parameters (IntegralParameterD).
GaussianComponentConfig(*args, **kw)	Configuration for an lsst.gauss2d.fit Gaussian component.
InvalidPsfError(arg, *args, **kwds)
IsParentError	RuntimeError for objects that are parents and shouldn't be fit.
MultiProFitPsfConfig(*args, **kw)	Configuration for the MultiProFit Gaussian mixture PSF fitter.
MultiProFitPsfTask(**kwargs)	Fit a Gaussian mixture PSF model at cataloged locations.
ParameterConfig(*args, **kw)	Configuration for a parameter.
SourceConfig(*args, **kw)	Configuration for an lsst.gauss2d.fit Source.