lsst::afw::cameraGeom::Amplifier Class Reference

Geometry and electronic information about raw amplifier images. More...

#include <Amplifier.h>

Inheritance diagram for lsst::afw::cameraGeom::Amplifier:

Classes
class	Builder
	A mutable Amplifier subclass class that can be used to incrementally construct or modify Amplifiers. More...
struct	Fields

Public Member Functions
virtual	~Amplifier () noexcept=default
void	toRecord (table::BaseRecord &record) const
	Copy the Amplifier's fields into the given record. More...
Builder	rebuild () const
	Return a Builder object initialized with the fields of this. More...
std::string	getName () const
	Name of the amplifier. More...
lsst::geom::Box2I	getBBox () const
	Bounding box of amplifier pixels in the trimmed, assembled image. More...
double	getGain () const
	Amplifier gain in e-/ADU. More...
double	getReadNoise () const
	Amplifier read noise, in e-. More...
double	getSaturation () const
	Level in ADU above which pixels are considered saturated; use nan if no such level applies. More...
double	getSuspectLevel () const
	Level in ADU above which pixels are considered suspicious, meaning they may be affected by unknown systematics; for example if non-linearity corrections above a certain level are unstable then that would be a useful value for suspectLevel. More...
ReadoutCorner	getReadoutCorner () const
	Readout corner in the trimmed, assembled image. More...
ndarray::Array< double const, 1, 1 >	getLinearityCoeffs () const
	Vector of linearity coefficients. More...
std::string	getLinearityType () const
	Name of linearity parameterization. More...
double	getLinearityThreshold () const
	Level in ADU above which linearity should be applied. More...
double	getLinearityMaximum () const
	Level in ADU above which the linearity relation is poorly defined. More...
std::string	getLinearityUnits () const
	Units for the input to the linearity relation (DN). More...
bool	getHasRawInfo () const
	Does this table have raw amplifier information? More...
lsst::geom::Box2I	getRawBBox () const
	Bounding box of all amplifier pixels on untrimmed, assembled raw image. More...
lsst::geom::Box2I	getRawDataBBox () const
	Bounding box of amplifier image pixels on untrimmed, assembled raw image. More...
bool	getRawFlipX () const
	Flip row order in transformation from untrimmed, assembled raw image to trimmed, assembled post-ISR image? More...
bool	getRawFlipY () const
	Flip column order in transformation from untrimmed, assembled raw image to trimmed, assembled post-ISR image? More...
lsst::geom::Extent2I	getRawXYOffset () const
	Offset in transformation from pre-raw, unassembled image to trimmed, assembled post-ISR image: final xy0 - pre-raw xy0. More...
lsst::geom::Box2I	getRawHorizontalOverscanBBox () const
	The bounding box of horizontal overscan pixels in the assembled, untrimmed raw image. More...
lsst::geom::Box2I	getRawVerticalOverscanBBox () const
	The bounding box of vertical overscan pixels in the assembled, untrimmed raw image. More...
lsst::geom::Box2I	getRawPrescanBBox () const
	The bounding box of (horizontal) prescan pixels in the assembled, untrimmed raw image. More...
lsst::geom::Box2I	getRawSerialOverscanBBox () const
	The bounding box of serial overscan pixels (equivalent to horizontal overscan pixels) in the assembled, untrimmed raw image. More...
lsst::geom::Box2I	getRawParallelOverscanBBox () const
	The bounding box of parallel overscan pixels (equivalent to vertical overscan pixels) in the assembled, untrimmed raw image. More...
lsst::geom::Box2I	getRawSerialPrescanBBox () const
	The bounding box of horizontal/serial prescan pixels in the assembled, untrimmed raw image. More...
lsst::geom::Box2I	getRawHorizontalPrescanBBox () const
	The bounding box of horizontal/serial prescan pixels in the assembled, untrimmed raw image. More...

Static Public Member Functions
static table::Schema	getRecordSchema ()
	Return the schema used in the afw.table representation of amplifiers. More...

Protected Member Functions
	Amplifier ()=default
	Amplifier (Amplifier const &)=default
	Amplifier (Amplifier &&)=default
Amplifier &	operator= (Amplifier const &)=default
Amplifier &	operator= (Amplifier &&)=default
virtual Fields const &	getFields () const =0

Detailed Description

Geometry and electronic information about raw amplifier images.

The Amplifier class itself is an abstract base class that provides no mutation or copy interfaces. Typically Amplifiers are constructed via the Builder subclass, which can produce a shared_ptr to an immutable Amplifier instance.

Here is a pictorial example showing the meaning of flipX and flipY:

    CCD with 4 amps        Desired assembled output      Use these parameters

    --x         x--            y
   |  amp1    amp2 |           |                               flipX       flipY
   y               y           |                       amp1    False       True
                               | CCD image             amp2    True        True
   y               y           |                       amp3    False       False
   |  amp3    amp4 |           |                       amp4    True        False
    --x         x--             ----------- x

Note

• All bounding boxes are parent boxes with respect to the raw image.
• The overscan and prescan bounding boxes represent the full regions; unusable regions are set via ISR configuration parameters.
• xyOffset is not used for instrument signature removal (ISR); it is intended for use by display utilities. It supports construction of a raw CCD image in the case that raw data is provided as individual amplifier images (which is uncommon):
  • Use 0,0 for cameras that supply raw data as a raw CCD image (most cameras)
  • Use nonzero for cameras that supply raw data as separate amplifier images with xy0=0,0 (LSST)
• This design assumes assembled X is always +/- raw X, which we require for CCDs (so that bleed trails are always along the Y axis).

Definition at line 86 of file Amplifier.h.

Constructor & Destructor Documentation

~Amplifier()

virtual lsst::afw::cameraGeom::Amplifier::~Amplifier ( )

virtualdefaultnoexcept

Amplifier() [1/3]

lsst::afw::cameraGeom::Amplifier::Amplifier ( )

protecteddefault

Amplifier() [2/3]

lsst::afw::cameraGeom::Amplifier::Amplifier ( Amplifier const &  )

protecteddefault

Amplifier() [3/3]

lsst::afw::cameraGeom::Amplifier::Amplifier ( Amplifier &&  )

protecteddefault

Member Function Documentation

getBBox()

lsst::geom::Box2I lsst::afw::cameraGeom::Amplifier::getBBox ( ) const

inline

Bounding box of amplifier pixels in the trimmed, assembled image.

Definition at line 115 of file Amplifier.h.

{ return getFields().bbox; }

getFields()

virtual Fields const& lsst::afw::cameraGeom::Amplifier::getFields ( ) const

protectedpure virtual

Implemented in lsst::afw::cameraGeom::Amplifier::Builder.

getGain()

double lsst::afw::cameraGeom::Amplifier::getGain ( ) const

inline

Amplifier gain in e-/ADU.

Definition at line 118 of file Amplifier.h.

{ return getFields().gain; }

getHasRawInfo()

bool lsst::afw::cameraGeom::Amplifier::getHasRawInfo ( ) const

inline

Does this table have raw amplifier information?

Definition at line 163 of file Amplifier.h.

{ return true; }

getLinearityCoeffs()

ndarray::Array<double const, 1, 1> lsst::afw::cameraGeom::Amplifier::getLinearityCoeffs ( ) const

inline

Vector of linearity coefficients.

Definition at line 142 of file Amplifier.h.

{ return getFields().linearityCoeffs; }

getLinearityMaximum()

double lsst::afw::cameraGeom::Amplifier::getLinearityMaximum ( ) const

inline

Level in ADU above which the linearity relation is poorly defined.

Should be set to the saturation level if no other value is known.

Definition at line 156 of file Amplifier.h.

{ return getFields().linearityMaximum; }

getLinearityThreshold()

double lsst::afw::cameraGeom::Amplifier::getLinearityThreshold ( ) const

inline

Level in ADU above which linearity should be applied.

This should be set to 0.0 if no other value is known.

Definition at line 150 of file Amplifier.h.

{ return getFields().linearityThreshold; }

getLinearityType()

std::string lsst::afw::cameraGeom::Amplifier::getLinearityType ( ) const

inline

Name of linearity parameterization.

Definition at line 145 of file Amplifier.h.

{ return getFields().linearityType; }

getLinearityUnits()

std::string lsst::afw::cameraGeom::Amplifier::getLinearityUnits ( ) const

inline

Units for the input to the linearity relation (DN).

Definition at line 159 of file Amplifier.h.

{ return getFields().linearityUnits; }

getName()

std::string lsst::afw::cameraGeom::Amplifier::getName ( ) const

inline

Name of the amplifier.

Definition at line 112 of file Amplifier.h.

{ return getFields().name; }

getRawBBox()

lsst::geom::Box2I lsst::afw::cameraGeom::Amplifier::getRawBBox ( ) const

inline

Bounding box of all amplifier pixels on untrimmed, assembled raw image.

Definition at line 169 of file Amplifier.h.

{ return getFields().rawBBox; }

getRawDataBBox()

lsst::geom::Box2I lsst::afw::cameraGeom::Amplifier::getRawDataBBox ( ) const

inline

Bounding box of amplifier image pixels on untrimmed, assembled raw image.

Definition at line 175 of file Amplifier.h.

{ return getFields().rawDataBBox; }

getRawFlipX()

bool lsst::afw::cameraGeom::Amplifier::getRawFlipX ( ) const

inline

Flip row order in transformation from untrimmed, assembled raw image to trimmed, assembled post-ISR image?

Definition at line 181 of file Amplifier.h.

{ return getFields().rawFlipX; }

getRawFlipY()

bool lsst::afw::cameraGeom::Amplifier::getRawFlipY ( ) const

inline

Flip column order in transformation from untrimmed, assembled raw image to trimmed, assembled post-ISR image?

Definition at line 187 of file Amplifier.h.

{ return getFields().rawFlipY; }

getRawHorizontalOverscanBBox()

lsst::geom::Box2I lsst::afw::cameraGeom::Amplifier::getRawHorizontalOverscanBBox ( ) const

inline

The bounding box of horizontal overscan pixels in the assembled, untrimmed raw image.

Definition at line 199 of file Amplifier.h.

{ return getFields().rawHorizontalOverscanBBox; }

getRawHorizontalPrescanBBox()

lsst::geom::Box2I lsst::afw::cameraGeom::Amplifier::getRawHorizontalPrescanBBox ( ) const

inline

The bounding box of horizontal/serial prescan pixels in the assembled, untrimmed raw image.

This duplicates the getRawPrescanBBox method for legacy reasons.

Definition at line 235 of file Amplifier.h.

{ return getFields().rawPrescanBBox; }

getRawParallelOverscanBBox()

lsst::geom::Box2I lsst::afw::cameraGeom::Amplifier::getRawParallelOverscanBBox ( ) const

inline

The bounding box of parallel overscan pixels (equivalent to vertical overscan pixels) in the assembled, untrimmed raw image.

This duplicates the getRawVerticalOverscanBBox method for legacy reasons.

Definition at line 225 of file Amplifier.h.

{ return getFields().rawVerticalOverscanBBox; }

getRawPrescanBBox()

lsst::geom::Box2I lsst::afw::cameraGeom::Amplifier::getRawPrescanBBox ( ) const

inline

The bounding box of (horizontal) prescan pixels in the assembled, untrimmed raw image.

Definition at line 211 of file Amplifier.h.

{ return getFields().rawPrescanBBox; }

getRawSerialOverscanBBox()

lsst::geom::Box2I lsst::afw::cameraGeom::Amplifier::getRawSerialOverscanBBox ( ) const

inline

The bounding box of serial overscan pixels (equivalent to horizontal overscan pixels) in the assembled, untrimmed raw image.

This duplicates the getRawHorizontalOverscanBBox method for legacy reasons.

Definition at line 218 of file Amplifier.h.

{ return getFields().rawHorizontalOverscanBBox; }

getRawSerialPrescanBBox()

lsst::geom::Box2I lsst::afw::cameraGeom::Amplifier::getRawSerialPrescanBBox ( ) const

inline

The bounding box of horizontal/serial prescan pixels in the assembled, untrimmed raw image.

This duplicates the getRawPrescanBBox method for legacy reasons.

Definition at line 232 of file Amplifier.h.

{ return getFields().rawPrescanBBox; }

getRawVerticalOverscanBBox()

lsst::geom::Box2I lsst::afw::cameraGeom::Amplifier::getRawVerticalOverscanBBox ( ) const

inline

The bounding box of vertical overscan pixels in the assembled, untrimmed raw image.

Definition at line 205 of file Amplifier.h.

{ return getFields().rawVerticalOverscanBBox; }

getRawXYOffset()

lsst::geom::Extent2I lsst::afw::cameraGeom::Amplifier::getRawXYOffset ( ) const

inline

Offset in transformation from pre-raw, unassembled image to trimmed, assembled post-ISR image: final xy0 - pre-raw xy0.

Definition at line 193 of file Amplifier.h.

{ return getFields().rawXYOffset; }

getReadNoise()

double lsst::afw::cameraGeom::Amplifier::getReadNoise ( ) const

inline

Amplifier read noise, in e-.

Definition at line 121 of file Amplifier.h.

{ return getFields().readNoise; }

getReadoutCorner()

ReadoutCorner lsst::afw::cameraGeom::Amplifier::getReadoutCorner ( ) const

inline

Readout corner in the trimmed, assembled image.

Definition at line 139 of file Amplifier.h.

{ return getFields().readoutCorner; }

getRecordSchema()

table::Schema lsst::afw::cameraGeom::Amplifier::getRecordSchema ( )

static

Return the schema used in the afw.table representation of amplifiers.

Definition at line 267 of file Amplifier.cc.

                                       {
    return RecordSchemaHelper::getMinimal().schema;
}

getSaturation()

double lsst::afw::cameraGeom::Amplifier::getSaturation ( ) const

inline

Level in ADU above which pixels are considered saturated; use nan if no such level applies.

Definition at line 127 of file Amplifier.h.

{ return getFields().saturation; }

getSuspectLevel()

double lsst::afw::cameraGeom::Amplifier::getSuspectLevel ( ) const

inline

Level in ADU above which pixels are considered suspicious, meaning they may be affected by unknown systematics; for example if non-linearity corrections above a certain level are unstable then that would be a useful value for suspectLevel.

Use nan if no such level applies.

Definition at line 136 of file Amplifier.h.

{ return getFields().suspectLevel; }

operator=() [1/2]

Amplifier& lsst::afw::cameraGeom::Amplifier::operator= ( Amplifier const &  )

protecteddefault

operator=() [2/2]

Amplifier& lsst::afw::cameraGeom::Amplifier::operator= ( Amplifier &&  )

protecteddefault

rebuild()

Amplifier::Builder lsst::afw::cameraGeom::Amplifier::rebuild

(

)

const

Return a Builder object initialized with the fields of this.

This is simply a shortcut for Amplifier::Builder(*this).

Definition at line 271 of file Amplifier.cc.

{ return Builder(*this); }

toRecord()

void lsst::afw::cameraGeom::Amplifier::toRecord

(

table::BaseRecord &

record

)

const

Copy the Amplifier's fields into the given record.

Parameters

[out]

record

Record to modify. record.getSchema().contains(this->getRecordSchema()) must be true.

Definition at line 322 of file Amplifier.cc.

                                                       {
    auto const helper = RecordSchemaHelper(record.getSchema());
    auto const & fields = getFields();
    record.set(helper.name, fields.name);
    record.set(helper.bbox, fields.bbox);
    record.set(helper.gain, fields.gain);
    record.set(helper.readNoise, fields.readNoise);
    record.set(helper.saturation, fields.saturation);
    record.set(helper.suspectLevel, fields.suspectLevel);
    record.set(helper.readoutCorner, static_cast<int>(fields.readoutCorner));
    ndarray::Array<double, 1, 1> coeffs = ndarray::copy(fields.linearityCoeffs);
    record.set(helper.linearityCoeffs, coeffs);
    record.set(helper.linearityType, fields.linearityType);
    record.set(helper.rawBBox, fields.rawBBox);
    record.set(helper.rawDataBBox, fields.rawDataBBox);
    record.set(helper.rawFlipX, fields.rawFlipX);
    record.set(helper.rawFlipY, fields.rawFlipY);
    record.set(helper.rawXYOffset, lsst::geom::Point2I(fields.rawXYOffset));
    record.set(helper.rawHorizontalOverscanBBox, fields.rawHorizontalOverscanBBox);
    record.set(helper.rawVerticalOverscanBBox, fields.rawVerticalOverscanBBox);
    record.set(helper.rawPrescanBBox, fields.rawPrescanBBox);
    // Set not-always-present fields only when present.
    auto setIfValid = [this, &record](auto value, auto & key) {
        if (key.isValid()) {
            record.set(key, value);
        }
    };
    setIfValid(fields.linearityThreshold, helper.linearityThreshold);
    setIfValid(fields.linearityMaximum, helper.linearityMaximum);
    setIfValid(fields.linearityUnits, helper.linearityUnits);
}

---

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/cameraGeom/Amplifier.h
• /j/snowflake/release/lsstsw/stack/Linux64/afw/19.0.0-4-ga671dab3b+1/src/cameraGeom/Amplifier.cc