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
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 print (std::ostream &out) const =0
 Print 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.

◆ 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.

◆ print()

virtual void lsst::jointcal::PhotometryTransform::print ( std::ostream out) const
pure virtual

Print the transform coefficients to stream.

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); }

◆ 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  }

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.print(s);
73  return s;
74  }

The documentation for this class was generated from the following file:
lsst::jointcal::PhotometryTransform::transform
virtual double transform(double x, double y, double value) const =0
Return the transform of value at (x,y).
lsst::jointcal::PhotometryTransform::transformError
virtual double transformError(double x, double y, double value, double valueErr) const =0
Return the transformed valueErr at Point(x,y).