LSSTApplications  18.0.0+106,18.0.0+50,19.0.0,19.0.0+1,19.0.0+10,19.0.0+11,19.0.0+13,19.0.0+17,19.0.0+2,19.0.0-1-g20d9b18+6,19.0.0-1-g425ff20,19.0.0-1-g5549ca4,19.0.0-1-g580fafe+6,19.0.0-1-g6fe20d0+1,19.0.0-1-g7011481+9,19.0.0-1-g8c57eb9+6,19.0.0-1-gb5175dc+11,19.0.0-1-gdc0e4a7+9,19.0.0-1-ge272bc4+6,19.0.0-1-ge3aa853,19.0.0-10-g448f008b,19.0.0-12-g6990b2c,19.0.0-2-g0d9f9cd+11,19.0.0-2-g3d9e4fb2+11,19.0.0-2-g5037de4,19.0.0-2-gb96a1c4+3,19.0.0-2-gd955cfd+15,19.0.0-3-g2d13df8,19.0.0-3-g6f3c7dc,19.0.0-4-g725f80e+11,19.0.0-4-ga671dab3b+1,19.0.0-4-gad373c5+3,19.0.0-5-ga2acb9c+2,19.0.0-5-gfe96e6c+2,w.2020.01
LSSTDataManagementBasePackage
Public Member Functions | Friends | List of all members
lsst::jointcal::PhotometryTransform Class Referenceabstract

A photometric transform, defined in terms of the input flux or magnitude. More...

#include <PhotometryTransform.h>

Inheritance diagram for lsst::jointcal::PhotometryTransform:
lsst::jointcal::PhotometryTransformChebyshev lsst::jointcal::PhotometryTransformSpatiallyInvariant lsst::jointcal::FluxTransformChebyshev lsst::jointcal::MagnitudeTransformChebyshev lsst::jointcal::FluxTransformSpatiallyInvariant lsst::jointcal::MagnitudeTransformSpatiallyInvariant

Public Member Functions

virtual double transform (double x, double y, double value) const =0
 Return the transform of value at (x,y). More...
 
double transform (Point const &in, double value) const
 Return the transformed value at Point(x,y). More...
 
virtual double transformError (double x, double y, double value, double valueErr) const =0
 Return the transformed valueErr at Point(x,y). More...
 
double transformError (Point const &in, double value, double valueErr) const
 Return the transformed valueErr at Point(x,y). More...
 
virtual void dump (std::ostream &stream=std::cout) const =0
 dumps the transform coefficients to stream. More...
 
virtual std::size_t getNpar () const =0
 Return the number of parameters (used to compute chisq) More...
 
virtual void offsetParams (Eigen::VectorXd const &delta)=0
 Offset the parameters by some (negative) amount during fitting. More...
 
virtual std::shared_ptr< PhotometryTransformclone () const =0
 return a copy (allocated by new) of the transformation. More...
 
virtual void computeParameterDerivatives (double x, double y, double value, Eigen::Ref< Eigen::VectorXd > derivatives) const =0
 Compute the derivatives with respect to the parameters (i.e. More...
 
virtual Eigen::VectorXd getParameters () const =0
 Get a copy of the parameters of this model, in the same order as offsetParams. More...
 

Friends

std::ostreamoperator<< (std::ostream &s, PhotometryTransform const &transform)
 

Detailed Description

A photometric transform, defined in terms of the input flux or magnitude.

Unit agnostic: a higher level Model must keep track of the units going into and out of of its Transforms.

See also
lsst::afw::image::PhotoCalib

Definition at line 52 of file PhotometryTransform.h.

Member Function Documentation

◆ clone()

virtual std::shared_ptr<PhotometryTransform> lsst::jointcal::PhotometryTransform::clone ( ) const
pure virtual

◆ computeParameterDerivatives()

virtual void lsst::jointcal::PhotometryTransform::computeParameterDerivatives ( double  x,
double  y,
double  value,
Eigen::Ref< Eigen::VectorXd >  derivatives 
) const
pure virtual

Compute the derivatives with respect to the parameters (i.e.

the coefficients).

Parameters
[in]xThe x coordinate to compute at (in the appropriate units for this transform).
[in]yThe y coordinate to compute at (in the appropriate units for this transform).
[in]valueThe instrument flux or magnitude to compute the derivative at.
[out]derivativesThe computed derivatives, in the same order as the deltas in offsetParams.

Implemented in lsst::jointcal::MagnitudeTransformChebyshev, lsst::jointcal::FluxTransformChebyshev, lsst::jointcal::MagnitudeTransformSpatiallyInvariant, and lsst::jointcal::FluxTransformSpatiallyInvariant.

◆ dump()

virtual void lsst::jointcal::PhotometryTransform::dump ( std::ostream stream = std::cout) const
pure virtual

dumps the transform coefficients to stream.

Implemented in lsst::jointcal::PhotometryTransformChebyshev, and lsst::jointcal::PhotometryTransformSpatiallyInvariant.

◆ getNpar()

virtual std::size_t lsst::jointcal::PhotometryTransform::getNpar ( ) const
pure virtual

Return the number of parameters (used to compute chisq)

Implemented in lsst::jointcal::PhotometryTransformChebyshev, and lsst::jointcal::PhotometryTransformSpatiallyInvariant.

◆ getParameters()

virtual Eigen::VectorXd lsst::jointcal::PhotometryTransform::getParameters ( ) const
pure virtual

Get a copy of the parameters of this model, in the same order as offsetParams.

Implemented in lsst::jointcal::PhotometryTransformChebyshev, and lsst::jointcal::PhotometryTransformSpatiallyInvariant.

◆ offsetParams()

virtual void lsst::jointcal::PhotometryTransform::offsetParams ( Eigen::VectorXd const &  delta)
pure virtual

Offset the parameters by some (negative) amount during fitting.

Equivalent to flatten(parameters) -= delta

Ordering of delta is the same as the ordering of the derivatives returned from computeParameterDerivatives.

Implemented in lsst::jointcal::PhotometryTransformChebyshev, and lsst::jointcal::PhotometryTransformSpatiallyInvariant.

◆ transform() [1/2]

virtual double lsst::jointcal::PhotometryTransform::transform ( double  x,
double  y,
double  value 
) const
pure virtual

◆ transform() [2/2]

double lsst::jointcal::PhotometryTransform::transform ( Point const &  in,
double  value 
) const
inline

Return the transformed value at Point(x,y).

Definition at line 58 of file PhotometryTransform.h.

58 { return transform(in.x, in.y, value); }
virtual double transform(double x, double y, double value) const =0
Return the transform of value at (x,y).

◆ transformError() [1/2]

virtual double lsst::jointcal::PhotometryTransform::transformError ( double  x,
double  y,
double  value,
double  valueErr 
) const
pure virtual

◆ transformError() [2/2]

double lsst::jointcal::PhotometryTransform::transformError ( Point const &  in,
double  value,
double  valueErr 
) const
inline

Return the transformed valueErr at Point(x,y).

Definition at line 64 of file PhotometryTransform.h.

64  {
65  return transformError(in.x, in.y, value, valueErr);
66  }
virtual double transformError(double x, double y, double value, double valueErr) const =0
Return the transformed valueErr at Point(x,y).

Friends And Related Function Documentation

◆ operator<<

std::ostream& operator<< ( std::ostream s,
PhotometryTransform const &  transform 
)
friend

Definition at line 71 of file PhotometryTransform.h.

71  {
72  transform.dump(s);
73  return s;
74  }

The documentation for this class was generated from the following file: