MultibandFootprint¶
- class lsst.afw.detection.MultibandFootprint(filters, singles)¶
Bases:
MultibandBase
Multiband Footprint class
A
MultibandFootprint
is a collection of HeavyFootprints that have the sameSpanSet
andpeakCatalog
but different flux in each band.- Parameters:
- filters
list
List of filter names.
- singles
list
A list of single band
HeavyFootprint
objects. EachHeavyFootprint
should have the samePeakCatalog
and the sameSpanSet
, however to save CPU cycles there is no internal check for consistency of the peak catalog.
- filters
Attributes Summary
List of filter names for the single band objects
Common SpanSet and peak catalog for the single band footprints
Height of the images
MultibandMaskedImage that the footprints present a view into
Minimum (y,x) position
PeakCatalog
of theMultibandFootprint
List of single band objects
SpanSet
of theMultibandFootprint
Width of the images
X0
Y0
Methods Summary
clone
([deep])Copy the current object
fromArrays
(filters, image[, mask, variance, ...])Create a
MultibandFootprint
from animage
,mask
,variance
fromImages
(filters, image[, mask, variance, ...])Create a
MultibandFootprint
from animage
,mask
,variance
fromMaskedImages
(filters, maskedImages[, ...])Create a
MultibandFootprint
from a list ofMaskedImage
getBBox
()Bounding box
getImage
([bbox, fill, imageType])Convert a
MultibandFootprint
to aMultibandImage
getPeaks
()Get the
PeakCatalog
getSpans
()Get the full
SpanSet
getXY0
()Minimum coordinate in the bounding box
setXY0
(xy0)Shift the bounding box but keep the same Extent
shiftedBy
(offset)Shift a bounding box by an offset, but keep the same Extent
shiftedTo
(xy0)Shift the bounding box but keep the same Extent
Attributes Documentation
- filters¶
List of filter names for the single band objects
- footprint¶
Common SpanSet and peak catalog for the single band footprints
- height¶
Height of the images
- mMaskedImage¶
MultibandMaskedImage that the footprints present a view into
- origin¶
Minimum (y,x) position
This is the position of
self.getBBox().getMin()
, but available as a tuple for numpy array indexing.
- peaks¶
PeakCatalog
of theMultibandFootprint
- singles¶
List of single band objects
- spans¶
SpanSet
of theMultibandFootprint
- width¶
Width of the images
- x0¶
X0
X component of XY0
Point2I.getX()
- y0¶
Y0
Y component of XY0
Point2I.getY()
Methods Documentation
- clone(deep=True)¶
Copy the current object
- Parameters:
- deep
bool
Whether or not to make a deep copy
- deep
- Returns:
- result
MultibandFootprint
The cloned footprint.
- result
- static fromArrays(filters, image, mask=None, variance=None, footprint=None, xy0=None, thresh=0, peaks=None)¶
Create a
MultibandFootprint
from animage
,mask
,variance
- Parameters:
- filters
list
List of filter names.
- image: array
An array to convert into
lsst.afw.detection.HeavyFootprint
objects. Only pixels above thethresh
value for at least one band will be included in theSpanSet
and resulting footprints.- maskarray
Mask for the
image
array.- variancearray
Variance of the
image
array.- footprint
Footprint
Footprint
that contains theSpanSet
andPeakCatalog
to use for theHeavyFootprint
in each band. Iffootprint
isNone
then thethresh
is used to create aFootprint
based on the pixels above thethresh
value.- xy0
Point2I
If
image
is an array andfootprint
isNone
then specifyingxy0
gives the location of the minimumx
andy
value of theimages
.- thresh
float
or list of floats Threshold in each band (or the same threshold to be used in all bands) to include a pixel in the
SpanSet
of theMultibandFootprint
. IfFootprint
is notNone
thenthresh
is ignored.- peaks
PeakCatalog
Catalog containing information about the peaks located in the footprints.
- filters
- Returns:
- result
MultibandFootprint
MultibandFootprint created from the arrays
- result
- static fromImages(filters, image, mask=None, variance=None, footprint=None, thresh=0, peaks=None)¶
Create a
MultibandFootprint
from animage
,mask
,variance
- Parameters:
- filters
list
List of filter names.
- image
lsst.afw.image.MultibandImage
, or list oflsst.afw.image.Image
A
lsst.afw.image.MultibandImage
(or collection of images in each band) to convert intoHeavyFootprint
objects. Only pixels above thethresh
value for at least one band will be included in theSpanSet
and resulting footprints.- mask
MultibandMask
or list ofMask
Mask for the
image
.- variance
lsst.afw.image.MultibandImage
, or list oflsst.afw.image.Image
Variance of the
image
.- thresh
float
orlist
of floats Threshold in each band (or the same threshold to be used in all bands) to include a pixel in the
SpanSet
of theMultibandFootprint
. IfFootprint
is notNone
thenthresh
is ignored.- peaks
PeakCatalog
Catalog containing information about the peaks located in the footprints.
- filters
- Returns:
- result
MultibandFootprint
MultibandFootprint created from the image, mask, and variance
- result
- static fromMaskedImages(filters, maskedImages, footprint=None, thresh=0, peaks=None)¶
Create a
MultibandFootprint
from a list ofMaskedImage
See
fromImages
for a description of the parameters not listed below- Parameters:
- maskedImages
list
oflsst.afw.image.MaskedImage
MaskedImages to extract the single band heavy footprints from. Like
fromImages
, if afootprint
is not specified then all pixels abovethresh
will be used, andpeaks
will be added to thePeakCatalog
.
- maskedImages
- Returns:
- result
MultibandFootprint
MultibandFootprint created from the image, mask, and variance
- result
- getBBox()¶
Bounding box
- getImage(bbox=None, fill=nan, imageType=<class 'lsst.afw.image._image._multiband.MultibandMaskedImage'>)¶
Convert a
MultibandFootprint
to aMultibandImage
This returns the heavy footprints converted into an
MultibandImage
orMultibandMaskedImage
(depending onimageType
). This might be different than the internalmMaskedImage
property of theMultibandFootprint
, as themMaskedImage
might contain some non-zero pixels not contained in the footprint but present in the images.- Parameters:
- bbox
Box2I
Bounding box of the resulting image. If no bounding box is specified, then the bounding box of the footprint is used.
- fill
float
Value to use for any pixel in the resulting image outside of the
SpanSet
.- imageType
type
This should be either a
MultibandMaskedImage
orMultibandImage
and describes the type of the output image.
- bbox
- Returns:
- result
MultibandBase
The resulting
MultibandImage
orMultibandMaskedImage
created from theMultibandHeavyFootprint
.
- result
- getPeaks()¶
Get the
PeakCatalog
- getSpans()¶
Get the full
SpanSet
- getXY0()¶
Minimum coordinate in the bounding box
- setXY0(xy0)¶
Shift the bounding box but keep the same Extent
- Parameters:
- xy0: `Point2I`
New minimum bounds of the bounding box
- shiftedBy(offset)¶
Shift a bounding box by an offset, but keep the same Extent
This method is broken until DM-10781 is completed.
- Parameters:
- offset: `Extent2I`
Amount to shift the bounding box in x and y.
- Returns:
- result:
MultibandBase
A copy of the object, shifted by
offset
- result:
- shiftedTo(xy0)¶
Shift the bounding box but keep the same Extent
This method is broken until DM-10781 is completed.
- Parameters:
- xy0: `Point2I`
New minimum bounds of the bounding box
- Returns:
- result:
MultibandBase
A copy of the object, shifted to
xy0
.
- result: