27#include "boost/math/constants/constants.hpp"
40FlagDefinitionList flagDefinitions;
45 flagDefinitions.add(
"flag_noCentroid",
"Object has no centroid");
47 flagDefinitions.add(
"flag_noShape",
"Object has no shape");
60 childHeavy = std::dynamic_pointer_cast<afw::detection::HeavyFootprint<float>
const>(childFootprint);
74 typedef ndarray::Array<float const, 1, 1>::Iterator ChildPixIter;
75 auto spanIter = childHeavy->getSpans()->begin();
76 auto const spanEnd = childHeavy->getSpans()->end();
77 ChildPixIter childPixIter = childHeavy->getImageArray().begin();
80 while (spanIter != spanEnd) {
81 afw::geom::Span
const& span = *spanIter;
82 ParentPixIter parentPixIter =
83 parentImage.
x_at(span.getBeginX() - parentImage.
getX0(), span.getY() - parentImage.
getY0());
84 int const width = span.getWidth();
86 for (
int x = 0;
x < width; ++parentPixIter, ++childPixIter, ++
x) {
87 cp += (*childPixIter) * ((*parentPixIter) - (*childPixIter));
88 cc += (*childPixIter) * (*childPixIter);
98class FluxAccumulator {
100 FluxAccumulator() :
_w(0.0),
_ww(0.0),
_wd(0.0) {}
102 void operator()(
double,
double,
float weight,
float data) {
104 _ww += weight * weight;
108 double getFlux()
const {
return _w *
_wd /
_ww; }
116class ShapeAccumulator :
public FluxAccumulator {
118 ShapeAccumulator() : FluxAccumulator(), _wdxx(0.0), _wdyy(0.0), _wdxy(0.0) {}
120 void operator()(
double x,
double y,
float weight,
float data) {
121 FluxAccumulator::operator()(x, y, weight, data);
122 _wdxx +=
x *
x * weight *
data;
123 _wdyy +=
y *
y * weight *
data;
124 _wdxy +=
x *
y * weight *
data;
127 ShapeResult getShape()
const {
143template <
typename Accumulator>
144void computeMoments(afw::image::MaskedImage<float>
const& image,
geom::Point2D const& centroid,
145 afw::geom::ellipses::Quadrupole
const& shape,
double nSigmaWeightMax,
146 Accumulator& accumulatorRaw, Accumulator& accumulatorAbs) {
149 afw::geom::ellipses::Ellipse ellipse(shape, centroid);
150 ellipse.getCore().scale(nSigmaWeightMax);
155 geom::LinearTransform
transform = shape.getGridTransform();
161 afw::geom::ellipses::PixelRegion region(ellipse);
162 bool isContained =
bbox.contains(region.getBBox());
163 SpanIter
const spanEnd = region.end();
164 for (SpanIter spanIter = region.begin(); spanIter != spanEnd; ++spanIter) {
165 afw::geom::Span span = *spanIter;
167 if (span.getY() <
bbox.getMinY() || span.getY() >
bbox.getMaxY()) {
170 span = afw::geom::Span(span.getY(),
std::max(span.getMinX(),
bbox.getMinX()),
172 if (span.getMinX() > span.getMaxX()) {
176 PixelIter pixelIter =
image.x_at(span.getBeginX() -
image.getX0(), span.getY() -
image.getY0());
177 PointIter
const pointEnd = span.end();
178 for (PointIter pointIter = span.begin(); pointIter != pointEnd; ++pointIter, ++pixelIter) {
182 float weight =
std::exp(
static_cast<float>(-0.5 * td.computeSquaredNorm()));
183 float data = pixelIter.image();
184 accumulatorRaw(d.getX(), d.getY(), weight, data);
185 float variance = pixelIter.variance();
188 accumulatorAbs(d.getX(), d.getY(), weight, std::abs(data) - bias);
199 _old =
schema.addField<
double>(
201 "Blendedness from dot products: (child.dot(parent)/child.dot(child) - 1)");
204 _raw =
schema.addField<
double>(
206 "Measure of how much the flux is affected by neighbors: "
207 "(1 - child_instFlux/parent_instFlux). Operates on the \"raw\" pixel values.");
208 _instFluxChildRaw =
schema.addField<
double>(
210 "Instrumental flux of the child, measured with a Gaussian weight matched to the child. "
211 "Operates on the \"raw\" pixel values.",
"count");
212 _instFluxParentRaw =
schema.addField<
double>(
214 "Instrumental flux of the parent, measured with a Gaussian weight matched to the child. "
215 "Operates on the \"raw\" pixel values.",
"count");
216 _abs =
schema.addField<
double>(
218 "Measure of how much the flux is affected by neighbors: "
219 "(1 - child_instFlux/parent_instFlux). "
220 "Operates on the absolute value of the pixels to try to obtain a \"de-noised\" value. "
221 "See section 4.9.11 of Bosch et al. 2018, PASJ, 70, S5 for details.");
222 _instFluxChildAbs =
schema.addField<
double>(
224 "Instrumental flux of the child, measured with a Gaussian weight matched to the child. "
225 "Operates on the absolute value of the pixels to try to obtain a \"de-noised\" value. "
226 "See section 4.9.11 of Bosch et al. 2018, PASJ, 70, S5 for details.",
"count");
227 _instFluxParentAbs =
schema.addField<
double>(
229 "Instrumental flux of the parent, measured with a Gaussian weight matched to the child. "
230 "Operates on the absolute value of the pixels to try to obtain a \"de-noised\" value. "
231 "See section 4.9.11 of Bosch et al. 2018, PASJ, 70, S5 for details.",
"count");
236 "Shape of the child, measured with a Gaussian weight matched to the child. "
240 "Shape of the parent, measured with a Gaussian weight matched to the child. "
244 "Shape of the child, measured with a Gaussian weight matched to the child. "
245 "Operates on the absolute value of the pixels to try to obtain a \"de-noised\" value. "
246 "See section 4.9.11 of Bosch et al. 2018, PASJ, 70, S5 for details.",
250 "Shape of the parent, measured with a Gaussian weight matched to the child. "
251 "Operates on the absolute value of the pixels to try to obtain a \"de-noised\" value. "
252 "See section 4.9.11 of Bosch et al. 2018, PASJ, 70, S5 for details.",
283 if (!
child.getTable()->getCentroidSlot().getMeasKey().isValid()) {
285 "Centroid Key must be defined to measure the blendedness instFlux");
289 if (!child.
getTable()->getCentroidSlot().getMeasKey().isValid()) {
291 "Shape Key must be defined to measure the blendedness shape");
296 if (child.
getTable()->getCentroidSlot().getFlagKey().isValid()) {
304 if (child.
getTable()->getShapeSlot().getFlagKey().isValid()) {
326 ShapeAccumulator accumulatorRaw;
327 ShapeAccumulator accumulatorAbs;
331 child.
set(instFluxRawKey, accumulatorRaw.getFlux());
332 child.
set(instFluxAbsKey,
std::max(accumulatorAbs.getFlux(), 0.0));
334 _shapeRawKey.
set(child, accumulatorRaw.getShape());
335 _shapeAbsKey.
set(child, accumulatorAbs.getShape());
336 }
else if (_ctrl.
doFlux) {
337 FluxAccumulator accumulatorRaw;
338 FluxAccumulator accumulatorAbs;
341 child.
set(instFluxRawKey, accumulatorRaw.getFlux());
342 child.
set(instFluxAbsKey,
std::max(accumulatorAbs.getFlux(), 0.0));
348 _measureMoments(
image,
child, _instFluxChildRaw, _instFluxChildAbs, _shapeChildRaw, _shapeChildAbs);
356 _measureMoments(
image,
child, _instFluxParentRaw, _instFluxParentAbs, _shapeParentRaw, _shapeParentAbs);
358 child.set(_raw, 1.0 -
child.get(_instFluxChildRaw) /
child.get(_instFluxParentRaw));
359 child.set(_abs, 1.0 -
child.get(_instFluxChildAbs) /
child.get(_instFluxParentAbs));
360 if (
child.get(_instFluxParentAbs) == 0.0) {
table::Key< std::string > name
#define LSST_EXCEPT(type,...)
SpanPixelIterator Iterator
std::vector< Span >::const_iterator Iterator
double getDeterminant() const
typename _const_view_t::x_iterator const_x_iterator
lsst::geom::Box2I getBBox(ImageOrigin origin=PARENT) const
x_iterator x_at(int x, int y) const
const_MaskedImageIterator< typename Image::x_iterator, typename Mask::x_iterator, typename Variance::x_iterator > const_x_iterator
void set(Key< T > const &key, U const &value)
bool getShapeFlag() const
CentroidSlotDefinition::MeasValue getCentroid() const
bool getCentroidFlag() const
std::shared_ptr< SourceTable const > getTable() const
ShapeSlotDefinition::MeasValue getShape() const
bool contains(Point2I const &point) const noexcept
static float computeAbsExpectation(float data, float variance)
Compute the posterior expectation value of the true instrumental flux in a pixel from its (Gaussian) ...
void measureChildPixels(afw::image::MaskedImage< float > const &image, afw::table::SourceRecord &child) const
static FlagDefinitionList const & getFlagDefinitions()
static float computeAbsBias(float mu, float variance)
Compute the bias induced by using the absolute value of a pixel instead of its value.
static FlagDefinition const NO_SHAPE
static FlagDefinition const NO_CENTROID
static FlagDefinition const FAILURE
BlendednessAlgorithm(Control const &ctrl, std::string const &name, afw::table::Schema &schema)
void measureParentPixels(afw::image::MaskedImage< float > const &image, afw::table::SourceRecord &child) const
double nSigmaWeightMax
"Radius factor that sets the maximum extent of the weight function (and hence the " "flux measurement...
bool doOld
"Whether to compute HeavyFootprint dot products (the old deblend.blendedness parameter)" ;
bool doShape
"Whether to compute quantities related to the Gaussian-weighted shape" ;
bool doFlux
"Whether to compute quantities related to the Gaussian-weighted flux" ;
vector-type utility class to build a collection of FlagDefinitions
static FlagHandler addFields(afw::table::Schema &schema, std::string const &prefix, FlagDefinitionList const &flagDefs, FlagDefinitionList const &exclDefs=FlagDefinitionList::getEmptyList())
Add Flag fields to a schema, creating a FlagHandler object to manage them.
void setValue(afw::table::BaseRecord &record, std::size_t i, bool value) const
Set the flag field corresponding to the given flag index.
A FunctorKey for ShapeResult.
static ShapeResultKey addFields(afw::table::Schema &schema, std::string const &name, std::string const &doc, UncertaintyEnum uncertainty, afw::table::CoordinateType coordType=afw::table::CoordinateType::PIXEL)
Add the appropriate fields to a Schema, and return a ShapeResultKey that manages them.
virtual void set(afw::table::BaseRecord &record, ShapeResult const &value) const
Set a ShapeResult in the given record.
Extent< double, 2 > Extent2D
Point< double, 2 > Point2D
@ NO_UNCERTAINTY
Algorithm provides no uncertainy information at all.