LSSTApplications  19.0.0-14-gb0260a2+72efe9b372,20.0.0+7927753e06,20.0.0+8829bf0056,20.0.0+995114c5d2,20.0.0+b6f4b2abd1,20.0.0+bddc4f4cbe,20.0.0-1-g253301a+8829bf0056,20.0.0-1-g2b7511a+0d71a2d77f,20.0.0-1-g5b95a8c+7461dd0434,20.0.0-12-g321c96ea+23efe4bbff,20.0.0-16-gfab17e72e+fdf35455f6,20.0.0-2-g0070d88+ba3ffc8f0b,20.0.0-2-g4dae9ad+ee58a624b3,20.0.0-2-g61b8584+5d3db074ba,20.0.0-2-gb780d76+d529cf1a41,20.0.0-2-ged6426c+226a441f5f,20.0.0-2-gf072044+8829bf0056,20.0.0-2-gf1f7952+ee58a624b3,20.0.0-20-geae50cf+e37fec0aee,20.0.0-25-g3dcad98+544a109665,20.0.0-25-g5eafb0f+ee58a624b3,20.0.0-27-g64178ef+f1f297b00a,20.0.0-3-g4cc78c6+e0676b0dc8,20.0.0-3-g8f21e14+4fd2c12c9a,20.0.0-3-gbd60e8c+187b78b4b8,20.0.0-3-gbecbe05+48431fa087,20.0.0-38-ge4adf513+a12e1f8e37,20.0.0-4-g97dc21a+544a109665,20.0.0-4-gb4befbc+087873070b,20.0.0-4-gf910f65+5d3db074ba,20.0.0-5-gdfe0fee+199202a608,20.0.0-5-gfbfe500+d529cf1a41,20.0.0-6-g64f541c+d529cf1a41,20.0.0-6-g9a5b7a1+a1cd37312e,20.0.0-68-ga3f3dda+5fca18c6a4,20.0.0-9-g4aef684+e18322736b,w.2020.45
LSSTDataManagementBasePackage
psfDeterminer.py
Go to the documentation of this file.
1 #
2 # LSST Data Management System
3 #
4 # Copyright 2008-2017 AURA/LSST.
5 #
6 # This product includes software developed by the
7 # LSST Project (http://www.lsst.org/).
8 #
9 # This program is free software: you can redistribute it and/or modify
10 # it under the terms of the GNU General Public License as published by
11 # the Free Software Foundation, either version 3 of the License, or
12 # (at your option) any later version.
13 #
14 # This program is distributed in the hope that it will be useful,
15 # but WITHOUT ANY WARRANTY; without even the implied warranty of
16 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 # GNU General Public License for more details.
18 #
19 # You should have received a copy of the LSST License Statement and
20 # the GNU General Public License along with this program. If not,
21 # see <https://www.lsstcorp.org/LegalNotices/>.
22 #
23 
24 __all__ = ["BasePsfDeterminerConfig", "BasePsfDeterminerTask", "psfDeterminerRegistry"]
25 
26 import abc
27 
28 import lsst.pipe.base as pipeBase
29 import lsst.pex.config as pexConfig
30 
31 
32 class BasePsfDeterminerConfig(pexConfig.Config):
33  """Configuration that is likely to be shared by all PSF determiners
34 
35  This is fairly sparse; more fields can be moved here once it is clear they are universal.
36  """
37  kernelSize = pexConfig.Field(
38  doc="radius of the kernel to create, relative to the square root of the stellar quadrupole moments",
39  dtype=float,
40  default=10.0,
41  )
42  kernelSizeMin = pexConfig.Field(
43  doc="Minimum radius of the kernel",
44  dtype=int,
45  default=25,
46  )
47  kernelSizeMax = pexConfig.Field(
48  doc="Maximum radius of the kernel",
49  dtype=int,
50  default=45,
51  )
52 
53 
54 class BasePsfDeterminerTask(pipeBase.Task, metaclass=abc.ABCMeta):
55  """!Base class for PSF determiners
56 
57  Register all PSF determiners with the psfDeterminerRegistry using:
58  psfDeterminerRegistry.register(name, class)
59  """
60 
61  usesMatches = False # Does the PSF determiner use the "matches" argument in the "run method? Few do.
62  ConfigClass = BasePsfDeterminerConfig
63  _DefaultName = "psfDeterminer"
64 
65  def __init__(self, config, schema=None, **kwds):
66  """Construct a PSF Determiner
67 
68  @param[in] config an instance of pexConfig.Config that configures this algorithm
69  @param[in,out] schema an instance of afw.table.Schema used for sources; passing a
70  schema allows the determiner to reserve a flag field to mark stars
71  used in PSF measurement, but some PSF determiners ignore this argument
72  """
73  pipeBase.Task.__init__(self, config=config, **kwds)
74 
75  @abc.abstractmethod
76  def determinePsf(self, exposure, psfCandidateList, metadata=None):
77  """Determine a PSF model
78 
79  @param[in] exposure exposure containing the psf candidates (lsst.afw.image.Exposure)
80  @param[in] psfCandidateList: a sequence of PSF candidates (each an
81  lsst.meas.algorithms.PsfCandidate); typically obtained by
82  detecting sources and then running them through a star selector
83  @param[in,out] metadata a place to save interesting items
84 
85  @return
86  - psf: the fit PSF; a subclass of lsst.afw.detection.Psf
87  - cellSet: the spatial cell set used to determine the PSF (lsst.afw.math.SpatialCellSet)
88  """
89  raise NotImplementedError("BasePsfDeterminerTask is abstract, subclasses must override this method")
90 
91 
92 psfDeterminerRegistry = pexConfig.makeRegistry(
93  doc="A registry of PSF determiners (subclasses of BasePsfDeterminerTask)",
94 )
lsst.pex.config
Definition: __init__.py:1
lsst::meas::algorithms.psfDeterminer.BasePsfDeterminerTask.determinePsf
def determinePsf(self, exposure, psfCandidateList, metadata=None)
Definition: psfDeterminer.py:76
lsst::meas::algorithms.psfDeterminer.BasePsfDeterminerConfig
Definition: psfDeterminer.py:32
lsst.pipe.base
Definition: __init__.py:1
lsst::meas::algorithms.psfDeterminer.BasePsfDeterminerTask.__init__
def __init__(self, config, schema=None, **kwds)
Definition: psfDeterminer.py:65
lsst::meas::algorithms.psfDeterminer.BasePsfDeterminerTask
Base class for PSF determiners.
Definition: psfDeterminer.py:54