A virtual base class to evaluate image background levels. More...

#include <Background.h>

Inheritance diagram for lsst::afw::math::Background:

Public Types
typedef float	InternalPixelT
	type used for any internal images, and returned by getApproximate More...

Public Member Functions
	Background (Background const &)=delete

	Background (Background &&)=delete

Background &	operator= (Background const &)=delete

Background &	operator= (Background &&)=delete

virtual Background &	operator+= (float const delta)=0
	Add a constant level to a background. More...

virtual Background &	operator-= (float const delta)=0
	Subtract a constant level from a background. More...

template<typename PixelT >
std::shared_ptr< lsst::afw::image::Image< PixelT > >	getImage (Interpolate::Style const interpStyle, UndersampleStyle const undersampleStyle=THROW_EXCEPTION) const
	Method to interpolate and return the background for entire image. More...

template<typename PixelT >
std::shared_ptr< lsst::afw::image::Image< PixelT > >	getImage (std::string const &interpStyle, std::string const &undersampleStyle="THROW_EXCEPTION") const
	Method to interpolate and return the background for entire image. More...

template<typename PixelT >
std::shared_ptr< lsst::afw::image::Image< PixelT > >	getImage (lsst::geom::Box2I const &bbox, Interpolate::Style const interpStyle, UndersampleStyle const undersampleStyle=THROW_EXCEPTION) const

template<typename PixelT >
std::shared_ptr< lsst::afw::image::Image< PixelT > >	getImage (lsst::geom::Box2I const &bbox, std::string const &interpStyle, std::string const &undersampleStyle="THROW_EXCEPTION") const

template<typename PixelT >
std::shared_ptr< lsst::afw::image::Image< PixelT > >	getImage () const
	Method to interpolate and return the background for entire image. More...

Interpolate::Style	getAsUsedInterpStyle () const
	Return the Interpolate::Style that we actually used in the last call to getImage() More...

UndersampleStyle	getAsUsedUndersampleStyle () const
	Return the UndersampleStyle that we actually used in the last call to getImage() More...

std::shared_ptr< math::Approximate< InternalPixelT > >	getApproximate (ApproximateControl const &actrl, UndersampleStyle const undersampleStyle=THROW_EXCEPTION) const
	Method to return an approximation to the background. More...

lsst::geom::Box2I	getImageBBox () const
	Return the input image's (PARENT) bounding box. More...

std::shared_ptr< BackgroundControl >	getBackgroundControl ()

std::shared_ptr< BackgroundControl const >	getBackgroundControl () const

Protected Member Functions
template<typename ImageT >
	Background (ImageT const &img, BackgroundControl const &bgCtrl)
	Constructor for Background. More...

	Background (lsst::geom::Box2I const imageBBox, int const nx, int const ny)
	Create a Background without any values in it. More...

virtual	~Background ()=default
	dtor More...

Protected Attributes
lsst::geom::Box2I	_imgBBox
	size and origin of input image More...

std::shared_ptr< BackgroundControl >	_bctrl
	control info set by user. More...

Interpolate::Style	_asUsedInterpStyle
	the style we actually used More...

UndersampleStyle	_asUsedUndersampleStyle
	the undersampleStyle we actually used More...

std::vector< double >	_xcen
	x center pix coords of sub images More...

std::vector< double >	_ycen
	y center ... More...

std::vector< int >	_xorig
	x origin pix coords of sub images More...

std::vector< int >	_yorig
	y origin ... More...

std::vector< int >	_xsize
	x size of sub images More...

std::vector< int >	_ysize
	y size ... More...

Detailed Description

A virtual base class to evaluate image background levels.

Definition at line 260 of file Background.h.

Member Typedef Documentation

◆ InternalPixelT

typedef float lsst::afw::math::Background::InternalPixelT

type used for any internal images, and returned by getApproximate

Definition at line 293 of file Background.h.

Constructor & Destructor Documentation

◆ Background() [1/4]

template<typename ImageT >

lsst::afw::math::Background::Background	(	ImageT const &	img,
		BackgroundControl const &	bgCtrl
	)

explicitprotected

Constructor for Background.

Estimate the statistical properties of the Image in a grid of cells; we'll later call getImage() to interpolate those values, creating an image the same size as the original

Note: The old and deprecated API specified the interpolation style as part of the BackgroundControl object passed to this ctor. This is still supported, but the work isn't done until the getImage() method is called

Parameters

img	ImageT (or MaskedImage) whose properties we want
bgCtrl	Control how the Background is estimated

Definition at line 44 of file Background.cc.

         : _imgBBox(img.getBBox()),
           _bctrl(new BackgroundControl(bgCtrl)),
           _asUsedInterpStyle(Interpolate::UNKNOWN),
           _asUsedUndersampleStyle(THROW_EXCEPTION),
           _xcen(0),
           _ycen(0),
           _xorig(0),
           _yorig(0),
           _xsize(0),
           _ysize(0) {
     if (_imgBBox.isEmpty()) {
         throw LSST_EXCEPT(ex::InvalidParameterError, "Image contains no pixels");
     }
 
     // Check that an int's large enough to hold the number of pixels
     if (_imgBBox.getWidth() * static_cast<double>(_imgBBox.getHeight()) > std::numeric_limits<int>::max()) {
         throw LSST_EXCEPT(lsst::pex::exceptions::OverflowError,
                           str(boost::format("Image %dx%d has more pixels than fit in an int (%d)") %
                               _imgBBox.getWidth() % _imgBBox.getHeight() % std::numeric_limits<int>::max()));
     }
 
     _setCenOrigSize(_imgBBox.getWidth(), _imgBBox.getHeight(), bgCtrl.getNxSample(), bgCtrl.getNySample());
 }

◆ Background() [2/4]

lsst::afw::math::Background::Background	(	lsst::geom::Box2I const	imageBBox,
		int const	nx,
		int const	ny
	)

explicitprotected

Create a Background without any values in it.

Parameters

imageBBox	Bounding box for image to be created by getImage()
nx	Number of samples in x-direction
ny	Number of samples in y-direction

Note: This ctor is mostly used to create a Background given its sample values, and that (in turn) is mostly used to implement persistence.

Definition at line 69 of file Background.cc.

         : _imgBBox(imageBBox),
           _bctrl(new BackgroundControl(nx, ny)),
           _asUsedInterpStyle(Interpolate::UNKNOWN),
           _asUsedUndersampleStyle(THROW_EXCEPTION),
           _xcen(0),
           _ycen(0),
           _xorig(0),
           _yorig(0),
           _xsize(0),
           _ysize(0) {
     if (_imgBBox.isEmpty()) {
         throw LSST_EXCEPT(ex::InvalidParameterError, "Image contains no pixels");
     }
 
     // Check that an int's large enough to hold the number of pixels
     if (_imgBBox.getWidth() * static_cast<double>(_imgBBox.getHeight()) > std::numeric_limits<int>::max()) {
         throw LSST_EXCEPT(lsst::pex::exceptions::OverflowError,
                           str(boost::format("Image %dx%d has more pixels than fit in an int (%d)") %
                               _imgBBox.getWidth() % _imgBBox.getHeight() % std::numeric_limits<int>::max()));
     }
 
     _setCenOrigSize(_imgBBox.getWidth(), _imgBBox.getHeight(), nx, ny);
 }

◆ ~Background()

virtual lsst::afw::math::Background::~Background ( )

protectedvirtualdefault

dtor

◆ Background() [3/4]

lsst::afw::math::Background::Background ( Background const & )

delete

◆ Background() [4/4]

lsst::afw::math::Background::Background ( Background && )

delete

Member Function Documentation

◆ getApproximate()

std::shared_ptr<math::Approximate<InternalPixelT> > lsst::afw::math::Background::getApproximate	(	ApproximateControl const &	actrl,
		UndersampleStyle const	undersampleStyle = `THROW_EXCEPTION`
	)		const

inline

Method to return an approximation to the background.

Parameters

actrl	Approximation style
undersampleStyle	Behaviour if there are too few points

Definition at line 381 of file Background.h.

                                                                              {
         InternalPixelT disambiguate = 0;
         return _getApproximate(actrl, undersampleStyle, disambiguate);
     }

◆ getAsUsedInterpStyle()

Interpolate::Style lsst::afw::math::Background::getAsUsedInterpStyle ( ) const

inline

Return the Interpolate::Style that we actually used in the last call to getImage()

N.b. Interpolate can fallback to a lower order if there aren't enough samples

Definition at line 370 of file Background.h.

370 { return _asUsedInterpStyle; }

lsst::afw::math::Background::_asUsedInterpStyle

Interpolate::Style _asUsedInterpStyle

the style we actually used

Definition: Background.h:398

◆ getAsUsedUndersampleStyle()

UndersampleStyle lsst::afw::math::Background::getAsUsedUndersampleStyle ( ) const

inline

Return the UndersampleStyle that we actually used in the last call to getImage()

Definition at line 374 of file Background.h.

374 { return _asUsedUndersampleStyle; }

lsst::afw::math::Background::_asUsedUndersampleStyle

UndersampleStyle _asUsedUndersampleStyle

the undersampleStyle we actually used

Definition: Background.h:399

◆ getBackgroundControl() [1/2]

std::shared_ptr<BackgroundControl> lsst::afw::math::Background::getBackgroundControl ( )

inline

Definition at line 392 of file Background.h.

392 { return _bctrl; }

lsst::afw::math::Background::_bctrl

std::shared_ptr< BackgroundControl > _bctrl

control info set by user.

Definition: Background.h:397

◆ getBackgroundControl() [2/2]

std::shared_ptr<BackgroundControl const> lsst::afw::math::Background::getBackgroundControl ( ) const

inline

Definition at line 393 of file Background.h.

393 { return _bctrl; }

lsst::afw::math::Background::_bctrl

std::shared_ptr< BackgroundControl > _bctrl

control info set by user.

Definition: Background.h:397

◆ getImage() [1/5]

template<typename PixelT >

std::shared_ptr<lsst::afw::image::Image<PixelT> > lsst::afw::math::Background::getImage	(	Interpolate::Style const	interpStyle,
		UndersampleStyle const	undersampleStyle = `THROW_EXCEPTION`
	)		const

inline

Method to interpolate and return the background for entire image.

Parameters

interpStyle	Style of the interpolation
undersampleStyle	Behaviour if there are too few points

Returns: A boost shared-pointer to an image containing the estimated background

Definition at line 312 of file Background.h.

                                                                              {
         return getImage<PixelT>(_imgBBox, interpStyle, undersampleStyle);
     }

◆ getImage() [2/5]

template<typename PixelT >

std::shared_ptr<lsst::afw::image::Image<PixelT> > lsst::afw::math::Background::getImage	(	std::string const &	interpStyle,
		std::string const &	undersampleStyle = `"THROW_EXCEPTION"`
	)		const

inline

Method to interpolate and return the background for entire image.

Parameters

interpStyle	Style of the interpolation
undersampleStyle	Behaviour if there are too few points

Returns: A boost shared-pointer to an image containing the estimated background

Definition at line 325 of file Background.h.

                                                                                                        {
         return getImage<PixelT>(math::stringToInterpStyle(interpStyle),
                                 stringToUndersampleStyle(undersampleStyle));
     }

◆ getImage() [3/5]

template<typename PixelT >

std::shared_ptr<lsst::afw::image::Image<PixelT> > lsst::afw::math::Background::getImage	(	lsst::geom::Box2I const &	bbox,
		Interpolate::Style const	interpStyle,
		UndersampleStyle const	undersampleStyle = `THROW_EXCEPTION`
	)		const

inline

Parameters

bbox	Bounding box for sub-image
interpStyle	Style of the interpolation
undersampleStyle	Behaviour if there are too few points

Definition at line 336 of file Background.h.

                                                                              {
         return _getImage(bbox, interpStyle, undersampleStyle, static_cast<PixelT>(0));
     }

◆ getImage() [4/5]

template<typename PixelT >

std::shared_ptr<lsst::afw::image::Image<PixelT> > lsst::afw::math::Background::getImage	(	lsst::geom::Box2I const &	bbox,
		std::string const &	interpStyle,
		std::string const &	undersampleStyle = `"THROW_EXCEPTION"`
	)		const

inline

Parameters

bbox	Bounding box for sub-image
interpStyle	Style of the interpolation
undersampleStyle	Behaviour if there are too few points

Definition at line 347 of file Background.h.

                                                                          {
         return _getImage(bbox, math::stringToInterpStyle(interpStyle),
                          stringToUndersampleStyle(undersampleStyle), static_cast<PixelT>(0));
     }

◆ getImage() [5/5]

template<typename PixelT >

std::shared_ptr<lsst::afw::image::Image<PixelT> > lsst::afw::math::Background::getImage ( ) const

inline

Method to interpolate and return the background for entire image.

Deprecated:: New code should specify the interpolation style in getImage, not the ctor

Definition at line 362 of file Background.h.

                              {
         return getImage<PixelT>(_bctrl->getInterpStyle(), _bctrl->getUndersampleStyle());
     }

◆ getImageBBox()

lsst::geom::Box2I lsst::afw::math::Background::getImageBBox ( ) const

inline

Return the input image's (PARENT) bounding box.

Definition at line 390 of file Background.h.

390 { return _imgBBox; }

lsst::afw::math::Background::_imgBBox

lsst::geom::Box2I _imgBBox

size and origin of input image

Definition: Background.h:396

◆ operator+=()

virtual Background& lsst::afw::math::Background::operator+= ( float const delta )

pure virtual

Add a constant level to a background.

Implemented in lsst::afw::math::BackgroundMI.

◆ operator-=()

virtual Background& lsst::afw::math::Background::operator-= ( float const delta )

pure virtual

Subtract a constant level from a background.

Implemented in lsst::afw::math::BackgroundMI.

◆ operator=() [1/2]

Background& lsst::afw::math::Background::operator= ( Background const & )

delete

◆ operator=() [2/2]

Background& lsst::afw::math::Background::operator= ( Background && )

delete

Member Data Documentation

◆ _asUsedInterpStyle

Interpolate::Style lsst::afw::math::Background::_asUsedInterpStyle

mutableprotected

the style we actually used

Definition at line 398 of file Background.h.

◆ _asUsedUndersampleStyle

UndersampleStyle lsst::afw::math::Background::_asUsedUndersampleStyle

mutableprotected

the undersampleStyle we actually used

Definition at line 399 of file Background.h.

◆ _bctrl

std::shared_ptr<BackgroundControl> lsst::afw::math::Background::_bctrl

protected

control info set by user.

Definition at line 397 of file Background.h.

◆ _imgBBox

lsst::geom::Box2I lsst::afw::math::Background::_imgBBox

protected

size and origin of input image

Definition at line 396 of file Background.h.

◆ _xcen

std::vector<double> lsst::afw::math::Background::_xcen

protected

x center pix coords of sub images

Definition at line 401 of file Background.h.

◆ _xorig

std::vector<int> lsst::afw::math::Background::_xorig

protected

x origin pix coords of sub images

Definition at line 403 of file Background.h.

◆ _xsize

std::vector<int> lsst::afw::math::Background::_xsize

protected

x size of sub images

Definition at line 405 of file Background.h.

◆ _ycen

std::vector<double> lsst::afw::math::Background::_ycen

protected

y center ...

Definition at line 402 of file Background.h.

◆ _yorig

std::vector<int> lsst::afw::math::Background::_yorig

protected

y origin ...

Definition at line 404 of file Background.h.

◆ _ysize

std::vector<int> lsst::afw::math::Background::_ysize

protected

y size ...

Definition at line 406 of file Background.h.

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

/j/snowflake/release/lsstsw/stack/Linux64/afw/19.0.0-4-ga671dab3b+1/include/lsst/afw/math/Background.h
/j/snowflake/release/lsstsw/stack/Linux64/afw/19.0.0-4-ga671dab3b+1/src/math/Background.cc

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ InternalPixelT

Constructor & Destructor Documentation

◆ Background() [1/4]

◆ Background() [2/4]

◆ ~Background()

◆ Background() [3/4]

◆ Background() [4/4]

Member Function Documentation

◆ getApproximate()

◆ getAsUsedInterpStyle()

◆ getAsUsedUndersampleStyle()

◆ getBackgroundControl() [1/2]

◆ getBackgroundControl() [2/2]

◆ getImage() [1/5]

◆ getImage() [2/5]

◆ getImage() [3/5]

◆ getImage() [4/5]

◆ getImage() [5/5]

◆ getImageBBox()

◆ operator+=()

◆ operator-=()

◆ operator=() [1/2]

◆ operator=() [2/2]

Member Data Documentation

◆ _asUsedInterpStyle

◆ _asUsedUndersampleStyle

◆ _bctrl

◆ _imgBBox

◆ _xcen

◆ _xorig

◆ _xsize

◆ _ycen

◆ _yorig

◆ _ysize