LSST Applications
21.0.0-172-gfb10e10a+18fedfabac,22.0.0+297cba6710,22.0.0+80564b0ff1,22.0.0+8d77f4f51a,22.0.0+a28f4c53b1,22.0.0+dcf3732eb2,22.0.1-1-g7d6de66+2a20fdde0d,22.0.1-1-g8e32f31+297cba6710,22.0.1-1-geca5380+7fa3b7d9b6,22.0.1-12-g44dc1dc+2a20fdde0d,22.0.1-15-g6a90155+515f58c32b,22.0.1-16-g9282f48+790f5f2caa,22.0.1-2-g92698f7+dcf3732eb2,22.0.1-2-ga9b0f51+7fa3b7d9b6,22.0.1-2-gd1925c9+bf4f0e694f,22.0.1-24-g1ad7a390+a9625a72a8,22.0.1-25-g5bf6245+3ad8ecd50b,22.0.1-25-gb120d7b+8b5510f75f,22.0.1-27-g97737f7+2a20fdde0d,22.0.1-32-gf62ce7b1+aa4237961e,22.0.1-4-g0b3f228+2a20fdde0d,22.0.1-4-g243d05b+871c1b8305,22.0.1-4-g3a563be+32dcf1063f,22.0.1-4-g44f2e3d+9e4ab0f4fa,22.0.1-42-gca6935d93+ba5e5ca3eb,22.0.1-5-g15c806e+85460ae5f3,22.0.1-5-g58711c4+611d128589,22.0.1-5-g75bb458+99c117b92f,22.0.1-6-g1c63a23+7fa3b7d9b6,22.0.1-6-g50866e6+84ff5a128b,22.0.1-6-g8d3140d+720564cf76,22.0.1-6-gd805d02+cc5644f571,22.0.1-8-ge5750ce+85460ae5f3,master-g6e05de7fdc+babf819c66,master-g99da0e417a+8d77f4f51a,w.2021.48
LSST Data Management Base Package
|
A set of pixels in an Image, including those pixels' actual values. More...
#include <HeavyFootprint.h>
Classes | |
class | Factory |
Public Member Functions | |
HeavyFootprint (Footprint const &foot, lsst::afw::image::MaskedImage< ImagePixelT, MaskPixelT, VariancePixelT > const &mimage, HeavyFootprintCtrl const *ctrl=nullptr) | |
Create a HeavyFootprint from a regular Footprint and the image that provides the pixel values. More... | |
HeavyFootprint (Footprint const &foot, HeavyFootprintCtrl const *ctrl=nullptr) | |
Create a HeavyFootprint from a regular Footprint, allocating space to hold foot.getArea() pixels, but not initializing them. More... | |
HeavyFootprint ()=default | |
Default constructor for HeavyFootprint. More... | |
~HeavyFootprint () override=default | |
HeavyFootprint (HeavyFootprint const &other)=default | |
HeavyFootprint (HeavyFootprint &&other)=default | |
HeavyFootprint & | operator= (HeavyFootprint const &)=default |
HeavyFootprint & | operator= (HeavyFootprint &&)=default |
bool | isHeavy () const override |
Is this a HeavyFootprint (yes!) More... | |
void | insert (lsst::afw::image::MaskedImage< ImagePixelT, MaskPixelT, VariancePixelT > &mimage) const |
Replace all the pixels in the image with the values in the HeavyFootprint. More... | |
void | insert (lsst::afw::image::Image< ImagePixelT > &image) const |
Replace all the pixels in the image with the values in the HeavyFootprint. More... | |
ndarray::Array< ImagePixelT, 1, 1 > | getImageArray () |
ndarray::Array< MaskPixelT, 1, 1 > | getMaskArray () |
ndarray::Array< VariancePixelT, 1, 1 > | getVarianceArray () |
ndarray::Array< ImagePixelT const, 1, 1 > | getImageArray () const |
ndarray::Array< MaskPixelT const, 1, 1 > | getMaskArray () const |
ndarray::Array< VariancePixelT const, 1, 1 > | getVarianceArray () const |
MaskPixelT | getMaskBitsSet () const |
double | dot (HeavyFootprint< ImagePixelT, MaskPixelT, VariancePixelT > const &other) const |
Dot product between HeavyFootprints. More... | |
std::shared_ptr< geom::SpanSet > | getSpans () const |
Return a shared pointer to the SpanSet. More... | |
void | setSpans (std::shared_ptr< geom::SpanSet > otherSpanSet) |
Sets the shared pointer to the SpanSet in the Footprint. More... | |
PeakCatalog & | getPeaks () |
Return the Peaks contained in this Footprint. More... | |
const PeakCatalog & | getPeaks () const |
std::shared_ptr< PeakRecord > | addPeak (float fx, float fy, float value) |
Convenience function to add a peak. More... | |
void | sortPeaks (afw::table::Key< float > const &key=afw::table::Key< float >()) |
Sort Peaks from most positive value to most negative. More... | |
void | setPeakSchema (afw::table::Schema const &peakSchema) |
Set the Schema used by the PeakCatalog (will throw if PeakCatalog is not empty). More... | |
void | setPeakCatalog (PeakCatalog const &otherPeaks) |
Set the peakCatalog to a copy of the supplied catalog. More... | |
std::size_t | getArea () const |
Return the number of pixels in this Footprint. More... | |
lsst::geom::Point2D | getCentroid () const |
Return the Footprint's centroid. More... | |
geom::ellipses::Quadrupole | getShape () const |
Return the Footprint's shape (interpreted as an ellipse) More... | |
void | shift (int dx, int dy) |
Shift a Footprint by (dx, dy) More... | |
void | shift (lsst::geom::ExtentI const &d) |
Shift a Footprint by a given extent. More... | |
lsst::geom::Box2I | getBBox () const |
Return the Footprint's bounding box. More... | |
lsst::geom::Box2I | getRegion () const |
Return the corners of the MaskedImage the footprints live in. More... | |
void | setRegion (lsst::geom::Box2I const ®ion) |
Set the corners of the MaskedImage wherein the footprints dwell. More... | |
void | clipTo (lsst::geom::Box2I const &bbox) |
Clip the Footprint such that all values lie inside the supplied Bounding Box. More... | |
bool | contains (lsst::geom::Point2I const &pix) const |
Tests if a pixel postion falls inside the Footprint. More... | |
std::shared_ptr< Footprint > | transform (std::shared_ptr< geom::SkyWcs > source, std::shared_ptr< geom::SkyWcs > target, lsst::geom::Box2I const ®ion, bool doClip=true) const |
Transform the footprint from one WCS to another. More... | |
std::shared_ptr< Footprint > | transform (lsst::geom::LinearTransform const &t, lsst::geom::Box2I const ®ion, bool doClip=true) const |
Return a new Footprint whose pixels are the product of applying the specified transformation. More... | |
std::shared_ptr< Footprint > | transform (lsst::geom::AffineTransform const &t, lsst::geom::Box2I const ®ion, bool doClip=true) const |
Return a new Footprint whose pixels are the product of applying the specified transformation. More... | |
std::shared_ptr< Footprint > | transform (geom::TransformPoint2ToPoint2 const &t, lsst::geom::Box2I const ®ion, bool doClip=true) const |
Return a new Footprint whose pixels are the product of applying the specified transformation. More... | |
bool | isPersistable () const noexcept override |
Report if this object is persistable. More... | |
void | dilate (int r, geom::Stencil s=geom::Stencil::CIRCLE) |
Dilate the Footprint with a defined kernel. More... | |
void | dilate (geom::SpanSet const &other) |
Dilate the Footprint with a defined kernel. More... | |
void | erode (int r, geom::Stencil s=geom::Stencil::CIRCLE) |
Erode the Footprint with a defined kernel. More... | |
void | erode (geom::SpanSet const &other) |
Erode the Footprint with a defined kernel. More... | |
void | removeOrphanPeaks () |
Remove peaks from the PeakCatalog that fall outside the area of the Footprint. More... | |
bool | isContiguous () const |
Reports if the Footprint is simply connected or has multiple components. More... | |
std::vector< std::shared_ptr< Footprint > > | split () const |
Split a multi-component Footprint into a vector of contiguous Footprints. More... | |
bool | operator== (Footprint const &other) const |
equality operator More... | |
void | writeFits (std::string const &fileName, std::string const &mode="w") const |
Write the object to a regular FITS file. More... | |
void | writeFits (fits::MemFileManager &manager, std::string const &mode="w") const |
Write the object to a FITS image in memory. More... | |
void | writeFits (fits::Fits &fitsfile) const |
Write the object to an already-open FITS object. More... | |
Protected Types | |
using | OutputArchiveHandle = io::OutputArchiveHandle |
Protected Member Functions | |
std::string | getPersistenceName () const override |
Return the name correspoinging ot the persistence type. More... | |
void | write (OutputArchiveHandle &handle) const override |
Write an instance of a Footprint to an output Archive. More... | |
std::string | getPythonModule () const override |
Return the python module the object will live in. More... | |
Static Protected Member Functions | |
static std::unique_ptr< Footprint > | readSpanSet (afw::table::BaseCatalog const &, afw::table::io::InputArchive const &) |
Static method used to unpersist the SpanSet member of the Footprint class. More... | |
static void | readPeaks (afw::table::BaseCatalog const &, Footprint &) |
Static method used to unpersist the PeakCatalog member of the Footprint class. More... | |
A set of pixels in an Image, including those pixels' actual values.
Definition at line 47 of file HeavyFootprint.h.
|
protectedinherited |
Definition at line 108 of file Persistable.h.
|
explicit |
Create a HeavyFootprint from a regular Footprint and the image that provides the pixel values.
foot | The Footprint defining the pixels to set |
mimage | The pixel values |
ctrl | Control how we manipulate HeavyFootprints |
Definition at line 71 of file HeavyFootprint.cc.
|
explicit |
Create a HeavyFootprint from a regular Footprint, allocating space to hold foot.getArea() pixels, but not initializing them.
This is used when unpersisting a HeavyFootprint.
foot | The Footprint defining the pixels to set |
ctrl | Control how we manipulate HeavyFootprints |
Definition at line 107 of file HeavyFootprint.cc.
|
default |
Default constructor for HeavyFootprint.
Most common use for this will be in combination with the assignment operator
|
overridedefault |
|
default |
|
default |
|
inherited |
Convenience function to add a peak.
fx | Float containing the x position of a peak |
fy | Float containing the y position of a peak |
value | The intensity value of the peak |
Definition at line 47 of file Footprint.cc.
|
inherited |
Clip the Footprint such that all values lie inside the supplied Bounding Box.
bbox | Integer box object that defines the boundaries the footprint should be clipped to. |
Definition at line 74 of file Footprint.cc.
|
inherited |
Tests if a pixel postion falls inside the Footprint.
pix | Integer point object defining the position of a pixel to test |
Definition at line 79 of file Footprint.cc.
|
inherited |
Dilate the Footprint with a defined kernel.
This function enlarges the SpanSet which defines the area of the Footprint by an amount governed by the input kernel
other | SpanSet to use as the kernel in dilation |
Definition at line 124 of file Footprint.cc.
|
inherited |
Dilate the Footprint with a defined kernel.
This function enlarges the SpanSet which defines the area of the Footprint by an amount governed by in input kernel
r | The radius of the stencil object used to create a dilation kernel |
s | The stencil object used to create the dilation kernel |
Definition at line 122 of file Footprint.cc.
double lsst::afw::detection::HeavyFootprint< ImagePixelT, MaskPixelT, VariancePixelT >::dot | ( | HeavyFootprint< ImagePixelT, MaskPixelT, VariancePixelT > const & | other | ) | const |
Dot product between HeavyFootprints.
The mask and variance planes are ignored.
Definition at line 151 of file HeavyFootprint.cc.
|
staticinherited |
Dynamically cast a shared_ptr.
Dynamically cast a shared pointer and raise on failure.
You must provide an explicit template instantiation in the .cc file for each class that inherits from PersistableFacade. Designed to work around RTTI issues on macOS with hidden symbols;
lsst::pex::exceptions::LogicError | if the cast fails |
param[in] ptr The pointer to be cast.
lsst::pex::exceptions::TypeError | If the dynamic cast fails. |
Definition at line 218 of file Persistable.cc.
|
staticinherited |
Dynamically cast a shared_ptr.
Dynamically cast a shared pointer and raise on failure.
You must provide an explicit template instantiation in the .cc file for each class that inherits from PersistableFacade. Designed to work around RTTI issues on macOS with hidden symbols;
lsst::pex::exceptions::LogicError | if the cast fails |
param[in] ptr The pointer to be cast.
lsst::pex::exceptions::TypeError | If the dynamic cast fails. |
Definition at line 218 of file Persistable.cc.
|
inherited |
Erode the Footprint with a defined kernel.
This function reduces the size of the SpanSet which defines the area of the Footprint by an amount governed by the input kernel
other | SpanSet to use as the kernel in erosion |
Definition at line 131 of file Footprint.cc.
|
inherited |
Erode the Footprint with a defined kernel.
This function reduces the size of the SpanSet which defines the area of the Footprint by an amount governed by the input kernel
r | The radius of the stencil object used to create a erosion kernel |
s | The stencil object used to create the erosion kernel |
Definition at line 126 of file Footprint.cc.
|
inlineinherited |
Return the number of pixels in this Footprint.
This function returns the real number of pixels, not the area of the bbox.
Definition at line 173 of file Footprint.h.
|
inlineinherited |
Return the Footprint's bounding box.
Definition at line 208 of file Footprint.h.
|
inlineinherited |
Return the Footprint's centroid.
The centroid is calculated as the mean of the pixel centers
Definition at line 180 of file Footprint.h.
|
inline |
Definition at line 107 of file HeavyFootprint.h.
|
inline |
Definition at line 111 of file HeavyFootprint.h.
|
inline |
Definition at line 108 of file HeavyFootprint.h.
|
inline |
Definition at line 112 of file HeavyFootprint.h.
|
inline |
Definition at line 116 of file HeavyFootprint.h.
|
inlineinherited |
Return the Peaks contained in this Footprint.
The peaks should be ordered by decreasing pixel intensity at the peak position (so the most negative peak appears last). Users that add new Peaks manually are responsible for maintaining this sorting.
Definition at line 129 of file Footprint.h.
|
inlineinherited |
Definition at line 130 of file Footprint.h.
|
overrideprotectedvirtual |
Return the name correspoinging ot the persistence type.
Reimplemented from lsst::afw::detection::Footprint.
Definition at line 259 of file HeavyFootprint.cc.
|
inlineoverrideprotectedvirtualinherited |
Return the python module the object will live in.
Reimplemented from lsst::afw::table::io::Persistable.
Definition at line 362 of file Footprint.h.
|
inlineinherited |
Return the corners of the MaskedImage the footprints live in.
Definition at line 213 of file Footprint.h.
|
inlineinherited |
Return the Footprint's shape (interpreted as an ellipse)
The shape is determined by measuring the moments of the pixel centers about its centroid (cf. getCentroid)
Definition at line 188 of file Footprint.h.
|
inlineinherited |
Return a shared pointer to the SpanSet.
Definition at line 115 of file Footprint.h.
|
inline |
Definition at line 109 of file HeavyFootprint.h.
|
inline |
Definition at line 113 of file HeavyFootprint.h.
void lsst::afw::detection::HeavyFootprint< ImagePixelT, MaskPixelT, VariancePixelT >::insert | ( | lsst::afw::image::Image< ImagePixelT > & | image | ) | const |
Replace all the pixels in the image with the values in the HeavyFootprint.
[out] | image | Image to set |
Definition at line 123 of file HeavyFootprint.cc.
void lsst::afw::detection::HeavyFootprint< ImagePixelT, MaskPixelT, VariancePixelT >::insert | ( | lsst::afw::image::MaskedImage< ImagePixelT, MaskPixelT, VariancePixelT > & | mimage | ) | const |
Replace all the pixels in the image with the values in the HeavyFootprint.
Definition at line 115 of file HeavyFootprint.cc.
|
inlineinherited |
Reports if the Footprint is simply connected or has multiple components.
Definition at line 335 of file Footprint.h.
|
inlineoverridevirtual |
Is this a HeavyFootprint (yes!)
Reimplemented from lsst::afw::detection::Footprint.
Definition at line 93 of file HeavyFootprint.h.
|
inlineoverridevirtualnoexceptinherited |
Report if this object is persistable.
Reimplemented from lsst::afw::table::io::Persistable.
Definition at line 283 of file Footprint.h.
|
default |
|
default |
|
inherited |
equality operator
other | The Footprint for which equality will be computed |
Definition at line 162 of file Footprint.cc.
|
inlinestaticinherited |
Read an object from an already open FITS object.
[in] | fitsfile | FITS object to read from, already positioned at the desired HDU. |
Definition at line 183 of file Persistable.h.
|
inlinestaticinherited |
Read an object from an already open FITS object.
[in] | fitsfile | FITS object to read from, already positioned at the desired HDU. |
Definition at line 183 of file Persistable.h.
|
inlinestaticinherited |
Read an object from a FITS file in memory.
[in] | manager | Manager for the memory to read from. |
[in] | hdu | HDU to read, where 0 is the primary. The special value of afw::fits::DEFAULT_HDU skips the primary HDU if it is empty. |
Definition at line 205 of file Persistable.h.
|
inlinestaticinherited |
Read an object from a FITS file in memory.
[in] | manager | Manager for the memory to read from. |
[in] | hdu | HDU to read, where 0 is the primary. The special value of afw::fits::DEFAULT_HDU skips the primary HDU if it is empty. |
Definition at line 205 of file Persistable.h.
|
inlinestaticinherited |
Read an object from a regular FITS file.
[in] | fileName | Name of the file to read. |
[in] | hdu | HDU to read, where 0 is the primary. The special value of afw::fits::DEFAULT_HDU skips the primary HDU if it is empty. |
Definition at line 194 of file Persistable.h.
|
inlinestaticinherited |
Read an object from a regular FITS file.
[in] | fileName | Name of the file to read. |
[in] | hdu | HDU to read, where 0 is the primary. The special value of afw::fits::DEFAULT_HDU skips the primary HDU if it is empty. |
Definition at line 194 of file Persistable.h.
|
staticprotectedinherited |
Static method used to unpersist the PeakCatalog member of the Footprint class.
Definition at line 296 of file Footprint.cc.
|
staticprotectedinherited |
Static method used to unpersist the SpanSet member of the Footprint class.
Definition at line 272 of file Footprint.cc.
|
inherited |
Remove peaks from the PeakCatalog that fall outside the area of the Footprint.
Definition at line 136 of file Footprint.cc.
|
inherited |
Set the peakCatalog to a copy of the supplied catalog.
PeakCatalog will be copied into the Footprint, but a PeakCatalog is a shallow copy, so records will not be duplicated. This function will throw an error if the PeakCatalog of *this is not empty.
otherPeaks | The PeakCatalog to copy |
Definition at line 421 of file Footprint.cc.
|
inherited |
Set the Schema used by the PeakCatalog (will throw if PeakCatalog is not empty).
peakSchema | The schema to use in the PeakCatalog |
pex::exceptions::LogicError | Thrown if if the PeakCatalog is not empty |
Definition at line 417 of file Footprint.cc.
|
inlineinherited |
Set the corners of the MaskedImage wherein the footprints dwell.
region | A box describing the corners of the Image the Footprint derives from |
Definition at line 220 of file Footprint.h.
|
inherited |
Sets the shared pointer to the SpanSet in the Footprint.
otherSpanSet | Shared pointer to a SpanSet |
Definition at line 45 of file Footprint.cc.
|
inherited |
Shift a Footprint by (dx, dy)
dx | How much to move Footprint in column direction |
dy | How much to move in row direction |
Definition at line 64 of file Footprint.cc.
|
inlineinherited |
Shift a Footprint by a given extent.
d | ExtentI object which gives the dimensions the Footprint should be shifted |
Definition at line 203 of file Footprint.h.
|
inherited |
Sort Peaks from most positive value to most negative.
If the key passed is invalid (the default) PeakTable::getPeakValueKey() will be used.
key | A key corresponding to the field in the Schema the PeakCatalog is to be sorted by. |
Definition at line 57 of file Footprint.cc.
|
inherited |
Split a multi-component Footprint into a vector of contiguous Footprints.
Split a multi-component Footprint such that each Footprint in the output vector is contiguous and contains only peaks that can be found within the bounds of the Footprint
Definition at line 145 of file Footprint.cc.
|
inherited |
Return a new Footprint whose pixels are the product of applying the specified transformation.
t | A 2-D transform which will be used to map the pixels |
region | Used to set the "region" box of the returned footprint; note that this is NOT the same as the footprint's bounding box. |
doClip | If true, clip the new footprint to the region bbox before returning it. |
Definition at line 98 of file Footprint.cc.
|
inherited |
Return a new Footprint whose pixels are the product of applying the specified transformation.
t | An affine transform object which will be used to map the pixels |
region | Used to set the "region" box of the returned footprint; note that this is NOT the same as the footprint's bounding box. |
doClip | If true, clip the new footprint to the region bbox before returning it. |
Definition at line 93 of file Footprint.cc.
|
inherited |
Return a new Footprint whose pixels are the product of applying the specified transformation.
t | A linear transform object which will be used to map the pixels |
region | Used to set the "region" box of the returned footprint; note that this is NOT the same as the footprint's bounding box. |
doClip | If true, clip the new footprint to the region bbox before returning it. |
Definition at line 88 of file Footprint.cc.
|
inherited |
Transform the footprint from one WCS to another.
source | Wcs that defines the coordinate system of the input footprint. |
target | Wcs that defines that desired coordinate system of the returned footprint. |
region | Used to set the "region" box of the returned footprint; note that this is NOT the same as the footprint's bounding box. |
doClip | If true, clip the new footprint to the region bbox before returning it. |
Definition at line 81 of file Footprint.cc.
|
overrideprotectedvirtual |
Write an instance of a Footprint to an output Archive.
Reimplemented from lsst::afw::detection::Footprint.
Definition at line 264 of file HeavyFootprint.cc.
|
inherited |
Write the object to an already-open FITS object.
[in] | fitsfile | Open FITS object to write to. |
Definition at line 18 of file Persistable.cc.
|
inherited |
Write the object to a FITS image in memory.
[in] | manager | Name of the file to write to. |
[in] | mode | If "w", any existing file with the given name will be overwritten. If "a", new HDUs will be appended to an existing file. |
Definition at line 29 of file Persistable.cc.
|
inherited |
Write the object to a regular FITS file.
[in] | fileName | Name of the file to write to. |
[in] | mode | If "w", any existing file with the given name will be overwritten. If "a", new HDUs will be appended to an existing file. |
Definition at line 24 of file Persistable.cc.