Description of a pixel. More...

#include <Pixel.h>

Public Types
enum	Status { eGood = 0, eBadCalibration = 1, eUnknown }

Public Member Functions
unsigned int	GetChannelId () const

float	GetCloudFraction () const
	how much of pixel is obscured by clouds More...

unsigned int	GetColumn (const unsigned int pixelid) const

unsigned int	GetColumn () const

double	GetDiaPhoton2PEFactor (const double wavelength, const std::string &configSignature="") const

const utl::Vector &	GetDirection () const
	pointing direction of this pixel More...

double	GetEndToEndCalibration (const double wavelength) const
	multiplication of calA(+drum) constant and optical efficiency correction is returned More...

double	GetEndToEndCalibrationAtReferenceWavelength () const

const utl::TabulatedFunction &	GetEndToEndCalibrationConstant () const
	end to end calibration function More...

double	GetEndToEndCalibrationConstant (const double wavelength) const
	calA(+drum) constant is returned More...

double	GetEndToEndCalibrationConstantAtReferenceWavelength () const
	calA(+drum) constant is returned More...

unsigned int	GetEyeId () const
	1..5 (4x normal FD, 1x HEAT) More...

unsigned int	GetId () const
	By default from 1..440. More...

const utl::TabulatedFunction &	GetOpticalEfficiencyCorrection () const
	optical efficiency correction is returned as a function of wavelength More...

double	GetOpticalEfficiencyCorrection (const double wavelength) const
	optical efficiency correction is returned More...

double	GetOpticalEfficiencyCorrectionAtReferenceWavelength () const
	optical efficiency correction is returned More...

Status	GetOpticalEfficiencyStatus () const

const utl::CoordinateSystemPtr &	GetPixelCoordinateSystem () const

const utl::TabulatedFunction &	GetQEfficiency () const
	Average quantum efficiency as a function of the wavelength. More...

unsigned int	GetRow (const unsigned int pixelid) const

unsigned int	GetRow () const

double	GetSimulatedDiaPhoton2ADC (const std::string &configSignature, const double wavelength) const

double	GetSimulatedEndToEndCalibration (const std::string &configSignature) const
	for the simulated end-to-end calibration constant More...

double	GetSolidAngle () const
	The solid angle viewed by this pixel. More...

Status	GetStatus () const
	Get the pixel status flag. More...

const Telescope &	GetTelescope () const
	Access the telescope this Pixel belongs to. More...

unsigned int	GetTelescopeId () const
	1..6 for normal FD, 1..3 for HEAT More...

double	GetTimeOffset () const
	pixel time offset More...

bool	HasCloudFraction () const

bool	IsMismatched () const

bool	IsObscuredByCloud () const

void	Update ()

Private Member Functions
int	GetCloudIndex () const
	Cloud index in strange units. To access please use GetCloudFraction() More...

template<typename T >
const T &	GetPixelData (T *&requestedData, const std::string &property, const std::string &component, const std::string &errorMsg, const std::string &extraIndex="") const

template<typename T >
void	GetPixelData (T &requestedData, const std::string &property, const std::string &component, const std::string &errorMsg, const std::string &extraIndex="") const

template<typename T >
const T &	GetPixelDataDiaphragm (T *&requestedData, const std::string &property, const std::string &component, const std::string &errorMsg) const

template<typename T >
void	GetPixelDataDiaphragm (T &requestedData, const std::string &property, const std::string &component, const std::string &errorMsg) const

Pixel &	operator= (const Pixel &)

	Pixel (const unsigned int eyeId, const unsigned int telescopeId, const unsigned int pixelId, const std::string &physEyeIdString, const std::string &physTelIdString)

	Pixel (const Pixel &)

	~Pixel ()

Private Attributes
int	fCloudIndex

det::ValidityStamp	fCloudValidityStamp

utl::CoordinateSystemPtr	fCoordinateSystem

utl::Vector	fDirection

unsigned int	fEyeId

std::string	fPhysicalEyeIdString

std::string	fPhysicalTelescopeIdString

unsigned int	fPixelId

std::string	fPixelIdString

Status	fPixelOpticalEfficiencyStatus

Status	fPixelStatus

utl::TabulatedFunction *	fQEfficiency

double *	fSimulatedEndToEnd

double *	fSolidAngle

unsigned int	fTelescopeId

double *	fTimeOffset

utl::TabulatedFunction	fWavelengthCalib

utl::TabulatedFunction	fWavelengthOpticalEfficiencyCorrection

Friends
class	fdet::Telescope

Detailed Description

Description of a pixel.

Author: S. Argiro; L. Prado Jr

Date: 29 Jun 2003

Definition at line 39 of file FDetector/Pixel.h.

Member Enumeration Documentation

enum fdet::Pixel::Status

Enumerator
eGood
eBadCalibration
eUnknown

Definition at line 42 of file FDetector/Pixel.h.

Constructor & Destructor Documentation

Pixel::Pixel	(	const unsigned int	eyeId,
		const unsigned int	telescopeId,
		const unsigned int	pixelId,
		const std::string &	physEyeIdString,
		const std::string &	physTelIdString
	)

private

Definition at line 33 of file FDetector/Pixel.cc.

References fPixelIdString.

Pixel::~Pixel ( )

private

Definition at line 56 of file FDetector/Pixel.cc.

References fQEfficiency, fSimulatedEndToEnd, fSolidAngle, and fTimeOffset.

fdet::Pixel::Pixel ( const Pixel & )

private

Member Function Documentation

unsigned int Pixel::GetChannelId ( ) const

Definition at line 84 of file FDetector/Pixel.cc.

References fPixelId, fdet::Telescope::GetCamera(), fdet::Camera::GetChannelId(), and GetTelescope().

Referenced by FdCalibratorOG::FdCalibrator::ApplyCalibration(), otoa::Detector2ADST::FillDetector(), FdPulseFinderOG::FdPulseFinder::FindBestSignalOverNoise(), FdPulseFinderOG::FdPulseFinder::FindPulse(), FdNoiseAdderKG::GetCalibConst(), fdet::FDetector::GetChannel(), fdet::Telescope::GetChannel(), fdet::Telescope::GetConfigSignatureStr(), and IsMismatched().

float Pixel::GetCloudFraction ( ) const

how much of pixel is obscured by clouds

Note: Using the mid-interval values for for the second to second-to-last bins and the extreme values for the first and last bin may skew things, but users may want to test for "entirely clear" or "entirely obscured", so we cater to that illusion.

Definition at line 407 of file FDetector/Pixel.cc.

References GetCloudIndex().

Referenced by otoa::Detector2ADST::FillCloudCameraData(), otoa::FD2ADST::FillCloudCameraDataBrief(), ReadCloudLLNS::ReadCloudLL::Run(), and testAtmLowLevelAtmInterface::testCloudDB().

int Pixel::GetCloudIndex ( ) const

private

Cloud index in strange units. To access please use GetCloudFraction()

Definition at line 388 of file FDetector/Pixel.cc.

References fCloudIndex, fCloudValidityStamp, and det::ValidityStamp::IsValid().

Referenced by GetCloudFraction(), and IsObscuredByCloud().

unsigned int Pixel::GetColumn ( const unsigned int pixelid ) const

Definition at line 358 of file FDetector/Pixel.cc.

References fdet::Telescope::GetFirstColumn(), fdet::Telescope::GetFirstPixelId(), fdet::Telescope::GetLastRow(), and GetTelescope().

Referenced by FdEnergyDepositFinderKG::CFMatrixCalculator::CalculateTelescopeData(), and fdet::Telescope::GetCameraPixelDirection().

unsigned int fdet::Pixel::GetColumn ( ) const

inline

Definition at line 102 of file FDetector/Pixel.h.

References fPixelId, and GetColumn().

Referenced by GetColumn().

double Pixel::GetDiaPhoton2PEFactor	(	const double	wavelength,
		const std::string &	configSignature = `""`
	)		const

Definition at line 275 of file FDetector/Pixel.cc.

References fdet::Telescope::GetCamera(), fdet::Telescope::GetConfigSignature(), fdet::Camera::GetElectronicsGain(), GetSimulatedDiaPhoton2ADC(), and GetTelescope().

Referenced by FdBackgroundSimulatorOG::FdBackgroundSimulator::AddBackground(), FdPulseFinderOG::FdPulseFinder::FindBestSignalOverNoise(), FdApertureLightFinderOG::FdApertureLightFinder::FindLightFlux(), FdApertureLightFinderOG::FdApertureLightFinder::FindZeta(), FdProfileConstrainedGeometryFitPG::ApertureLight::FindZeta(), FdProfileConstrainedGeometryFit::ApertureLight::FindZeta(), FdApertureLightFinderKG::FdApertureLightFinder::FindZeta(), and FdEnergyDepositFinderKG::CFMatrixCalculator::SetTelescopeParameters().

const Vector & Pixel::GetDirection ( ) const

pointing direction of this pixel

Definition at line 92 of file FDetector/Pixel.cc.

References fDirection, fdet::Telescope::GetCameraPixelDirection(), GetId(), utl::Vector::GetMag2(), and GetTelescope().

Referenced by FdBackgroundSimulatorOG::FdBackgroundSimulator::AddBackgroundFromVariance(), FdProfileConstrainedGeometryFitPG::PCGFitter::AdjustGeometry(), FdEnergyDepositFinderKG::CFMatrixCalculator::CalculateTelescopeData(), SpotPhotonGeneratorOG::SpotPhotonGenerator::DoSpot(), FdSDPFinderOG::FdSDPFinder::EstimateChi_i(), otoa::FD2ADST::FillCloudCameraDataBrief(), FdAxisFinderOG::FdAxisFinder::FillPoints(), HdAxisFinderUU::HdAxisFinder::FillPoints(), otoa::FD2ADST::FillRecPixel(), FdPulseFinderOG::FdPulseFinder::FindAdditionalPulse(), StereoGeometryFinderOG::StereoGeometryFinder::FindAxisStereo(), StereoGeometryFinderOG::StereoGeometryFinder::FindAxisStereoHybrid(), FdApertureLightFinderOG::FdApertureLightFinder::FindLightFlux(), FdSDPFinderOG::FdSDPFinder::FindSDPFirstGuess(), FdApertureLightFinderOG::FdApertureLightFinder::FindZeta(), FdProfileConstrainedGeometryFitPG::ApertureLight::FindZeta(), FdProfileConstrainedGeometryFit::ApertureLight::FindZeta(), FdApertureLightFinderKG::FdApertureLightFinder::FindZeta(), fdet::Telescope::GetModelMeanEfficiency(), GetPixelCoordinateSystem(), GetSimulatedDiaPhoton2ADC(), FdSDPFinderOG::FdSDPFinder::IsIsolated(), FdSDPFinderOG::FdSDPFinder::MinuitFitFunc(), FdProfileConstrainedGeometryFitPG::ChiZeroRegression::MinuitFitFunc(), HybridGeometryFinderWG::HybridGeometryFinder::MinuitFitFuncAxis(), StereoGeometryFinderOG::StereoGeometryFinder::MinuitFitFuncStereo(), StereoGeometryFinderOG::StereoGeometryFinder::MinuitFitFuncStereoHybrid(), FdSDPFinderOG::FdSDPFinder::ReadmitPixel(), FdAxisFinderOG::FdAxisFinder::ReadmitPixel(), HybridGeometryFinderOG::HybridGeometryFinder::ReadmitPixel(), HybridGeometryFinderWG::HybridGeometryFinder::ReadmitPixel(), HybridGeometryFinderWG::HybridGeometryFinder::RecalculateChiSquare(), FdSDPFinderOG::FdSDPFinder::RemoveNoise(), HybridGeometryFinderWG::HybridGeometryFinder::RemovePixel(), ReadCloudHLNS::ReadCloudHL::Run(), HybridGeometryFinderWG::HybridGeometryFinder::SelectPixels(), UseMcGeometryOG::UseMcGeometry::SetSDP(), UseMcGeometryOG::UseMcGeometry::SetTimeFit(), and HybridGeometryFinderWG::HybridGeometryFinder::StoreData().

double Pixel::GetEndToEndCalibration ( const double wavelength ) const

multiplication of calA(+drum) constant and optical efficiency correction is returned

Definition at line 193 of file FDetector/Pixel.cc.

References fdet::Telescope::CachePixelCalibrations(), fdet::Telescope::CachePixelOpticalEfficiencyCorrections(), fWavelengthCalib, fWavelengthOpticalEfficiencyCorrection, fdet::Telescope::GetMeasuredRelativeEfficiency(), GetTelescope(), utl::TabulatedFunction::XBack(), utl::TabulatedFunction::XFront(), utl::TabulatedFunction::YBack(), and utl::TabulatedFunction::YFront().

Referenced by GetEndToEndCalibrationAtReferenceWavelength().

double Pixel::GetEndToEndCalibrationAtReferenceWavelength ( ) const

end to end calibration at the reference wavelength multiplication of calA(+drum) constant and optical efficiency correction is returned

Definition at line 145 of file FDetector/Pixel.cc.

References GetEndToEndCalibration().

Referenced by FdCalibratorOG::FdCalibrator::ApplyCalibration(), otoa::LongitudinalXmaxScanner::FillLightFactors(), FdNoiseAdderKG::GetCalibConst(), and otoa::fd::GetCalibrationConstant().

const TabulatedFunction & Pixel::GetEndToEndCalibrationConstant ( ) const

end to end calibration function

For an example of reading FD calibration constants, see the ReadFDCalibNS::ReadFDCalib example. See also: GetEndToEndCalibrationAtReferenceWavelength()! calA(+drum) constant is returned as a function of wavelength

Definition at line 172 of file FDetector/Pixel.cc.

References fdet::Telescope::CachePixelCalibrations(), fWavelengthCalib, and GetTelescope().

Referenced by FdCalibratorOG::FdCalibrator::ApplyCalibration(), otoa::fd::GetCalibrationConstant(), GetEndToEndCalibrationConstantAtReferenceWavelength(), FdElectronicsSimulatorOG::FdElectronicsSimulator::InitCamera(), FDetectorTest::testGetPixelCalibNullEndTime(), FDetectorTest::testGetPixelCalibTime1(), FDetectorTest::testGetPixelCalibTime2(), FDetectorTest::testGetPixelCalibTime3(), and FDetectorTest::testReadFullTelescope().

double Pixel::GetEndToEndCalibrationConstant ( const double wavelength ) const

calA(+drum) constant is returned

Definition at line 230 of file FDetector/Pixel.cc.

References fdet::Telescope::CachePixelCalibrations(), fWavelengthCalib, fdet::Telescope::GetMeasuredRelativeEfficiency(), GetTelescope(), utl::TabulatedFunction::XBack(), utl::TabulatedFunction::XFront(), utl::TabulatedFunction::YBack(), and utl::TabulatedFunction::YFront().

double Pixel::GetEndToEndCalibrationConstantAtReferenceWavelength ( ) const

calA(+drum) constant is returned

Definition at line 154 of file FDetector/Pixel.cc.

References GetEndToEndCalibrationConstant().

Referenced by FdElectronicsSimulatorOG::FdElectronicsSimulator::InitCamera().

unsigned int fdet::Pixel::GetEyeId ( ) const

inline

1..5 (4x normal FD, 1x HEAT)

Definition at line 99 of file FDetector/Pixel.h.

References fEyeId.

Referenced by FdCalibratorOG::FdCalibrator::ApplyCalibration(), atm::VCloudModel::EvaluateCloudCoverage(), FdPulseFinderOG::FdPulseFinder::FindPulse(), FdNoiseAdderKG::GetCalibConst(), otoa::fd::GetCalibrationConstant(), fdet::FDetector::GetChannel(), and ReadCloudLLNS::ReadCloudLL::Run().

unsigned int fdet::Pixel::GetId ( ) const

inline

By default from 1..440.

Definition at line 93 of file FDetector/Pixel.h.

References fPixelId.

Referenced by FdCalibratorOG::FdCalibrator::ApplyCalibration(), SpotPhotonGeneratorOG::SpotPhotonGenerator::DoSpot(), atm::VCloudModel::EvaluateCloudCoverage(), otoa::fd::GetCalibrationConstant(), fdet::Camera::GetChannelId(), GetDirection(), IsMismatched(), StereoGeometryFinderOG::StereoGeometryFinder::MinuitFitFuncStereo(), StereoGeometryFinderOG::StereoGeometryFinder::MinuitFitFuncStereoHybrid(), and ReadCloudLLNS::ReadCloudLL::Run().

const TabulatedFunction & Pixel::GetOpticalEfficiencyCorrection ( ) const

optical efficiency correction is returned as a function of wavelength

Definition at line 182 of file FDetector/Pixel.cc.

References fdet::Telescope::CachePixelOpticalEfficiencyCorrections(), fWavelengthOpticalEfficiencyCorrection, and GetTelescope().

Referenced by GetOpticalEfficiencyCorrectionAtReferenceWavelength().

double Pixel::GetOpticalEfficiencyCorrection ( const double wavelength ) const

optical efficiency correction is returned

Definition at line 257 of file FDetector/Pixel.cc.

References fdet::Telescope::CachePixelOpticalEfficiencyCorrections(), fWavelengthOpticalEfficiencyCorrection, GetTelescope(), utl::TabulatedFunction::XBack(), utl::TabulatedFunction::XFront(), utl::TabulatedFunction::YBack(), and utl::TabulatedFunction::YFront().

double Pixel::GetOpticalEfficiencyCorrectionAtReferenceWavelength ( ) const

optical efficiency correction is returned

Definition at line 163 of file FDetector/Pixel.cc.

References GetOpticalEfficiencyCorrection().

Referenced by FdElectronicsSimulatorOG::FdElectronicsSimulator::InitCamera().

Pixel::Status Pixel::GetOpticalEfficiencyStatus ( ) const

Definition at line 331 of file FDetector/Pixel.cc.

References fdet::Telescope::CachePixelOpticalEfficiencyCorrections(), fPixelOpticalEfficiencyStatus, and GetTelescope().

const CoordinateSystemPtr & Pixel::GetPixelCoordinateSystem ( ) const

template<typename T >

const T & Pixel::GetPixelData	(	T *&	requestedData,
		const std::string &	property,
		const std::string &	component,
		const std::string &	errorMsg,
		const std::string &	extraIndex = `""`
	)		const

private

Definition at line 445 of file FDetector/Pixel.cc.

Referenced by GetQEfficiency(), GetSimulatedEndToEndCalibration(), GetSolidAngle(), and GetTimeOffset().

template<typename T >

void Pixel::GetPixelData	(	T &	requestedData,
		const std::string &	property,
		const std::string &	component,
		const std::string &	errorMsg,
		const std::string &	extraIndex = `""`
	)		const

private

Definition at line 461 of file FDetector/Pixel.cc.

References det::VManager::eNotFound, ERROR, fPhysicalEyeIdString, fPhysicalTelescopeIdString, fPixelIdString, det::VManager::GetData(), and det::VManager::QueryInfoMessage().

template<typename T >

const T & Pixel::GetPixelDataDiaphragm	(	T *&	requestedData,
		const std::string &	property,
		const std::string &	component,
		const std::string &	errorMsg
	)		const