This class implements the Breon + Rahman ground type. More...

#include <ground_brdf.h>

Inheritance diagram for FullPhysics::GroundBrdf:

Collaboration diagram for FullPhysics::GroundBrdf:

Public Types
enum	ParamIndex { BRDF_WEIGHT_INTERCEPT_INDEX, BRDF_WEIGHT_SLOPE_INDEX, RAHMAN_KERNEL_FACTOR_INDEX, RAHMAN_OVERALL_AMPLITUDE_INDEX, RAHMAN_ASYMMETRY_FACTOR_INDEX, RAHMAN_GEOMETRIC_FACTOR_INDEX, BREON_KERNEL_FACTOR_INDEX }

Public Member Functions
	GroundBrdf (const blitz::Array< double, 2 > &Coeffs, const blitz::Array< bool, 2 > &Flag, const ArrayWithUnit< double, 1 > &Ref_points, const std::vector< std::string > &Desc_band_names)
	Constructor that defines coefficients in a 2d array: Num_spectrometer * NUM_COEFF Each row has the NUM_COEFF BRDF parameters for a spectrometer. More...

virtual void	add_observer (Observer< Ground > &Obs)
	Add an observer. More...

void	add_observer_and_keep_reference (boost::shared_ptr< Observer< Ground > > &Obs)
	Add an observer and keep a reference to it. More...

virtual const AutoDerivative< double >	anisotropy_parameter (const int spec_index) const

virtual void	anisotropy_parameter (const int spec_index, const AutoDerivative< double > &val)

virtual const AutoDerivative< double >	asymmetry_parameter (const int spec_index) const

virtual void	asymmetry_parameter (const int spec_index, const AutoDerivative< double > &val)

virtual const double	black_sky_albedo (const int Spec_index, const double Sza)=0

const blitz::Array< double, 2 >	brdf_covariance (const int spec_index) const

virtual const AutoDerivative< double >	breon_factor (const int spec_index) const

virtual void	breon_factor (const int spec_index, const AutoDerivative< double > &val)

virtual const std::string	breon_type () const =0
	String describing which type of Breon surface type, also makes this class abstract. More...

virtual boost::shared_ptr< Ground >	clone () const =0
	Clone a Ground object. More...

const ArrayAd< double, 1 > &	coefficient () const

virtual std::string	desc () const

virtual const AutoDerivative< double >	hotspot_parameter (const int spec_index) const

virtual void	hotspot_parameter (const int spec_index, const AutoDerivative< double > &val)

void	init (const blitz::Array< double, 1 > &Coeff, const blitz::Array< bool, 1 > &Used_flag, const boost::shared_ptr< Pressure > &Press=boost::shared_ptr< Pressure >(), bool Mark_according_to_press=true, int Pdep_start=0)

virtual const double	kernel_value (const int Spec_index, const double Sza, const double Vza, const double Azm)=0

virtual void	mark_used (const StateVector &Sv, blitz::Array< bool, 1 > &Used) const
	Mark elements that we are actively using (i.e., that aren't ignored). More...

virtual void	mark_used (const StateVector &Sv, blitz::Array< bool, 1 > &Used) const
	Mark elements that we are actively using (i.e., that aren't ignored). More...

void	mark_used_sub (blitz::Array< bool, 1 > &Used) const
	Called by mark_used with the subset of the state vector used by this class. More...

virtual void	notify_add (StateVector &Observed_object)
	Called when an object is added to an Observable. More...

virtual void	notify_add ()

virtual void	notify_add (StateVector &Sv)
	Called when an object is added to an Observable. More...

virtual void	notify_remove (StateVector &Observed_object)
	Called when an object is removed from an Observable. More...

virtual void	notify_remove ()

virtual void	notify_remove (StateVector &Sv)
	Called when an object is removed from an Observable. More...

virtual void	notify_update (const StateVector &Sv)
	Called when the Observed object is updated. More...

virtual void	notify_update (const StateVector &Observed_object)
	Called when the Observed object is updated. More...

virtual const int	number_spectrometer () const

const boost::shared_ptr< Pressure > &	pressure () const

virtual void	print (std::ostream &Os) const

std::string	print_to_string () const
	Print to string. More...

virtual const AutoDerivative< double >	rahman_factor (const int spec_index) const

virtual void	rahman_factor (const int spec_index, const AutoDerivative< double > &val)

virtual const DoubleWithUnit	reference_point (const int spec_index) const
	Center wavelength that spectrally dependent parameter is referenced to. More...

virtual const double	refractive_index (const int Spec_idx) const
	Returns hard coded value of 1.5 since that is the value hardcoded into LIDORT. More...

virtual void	remove_observer (Observer< Ground > &Obs)
	Remove an observer. More...

virtual void	state_vector_name (const StateVector &Sv, blitz::Array< std::string, 1 > &Sv_name) const
	Update any portion of the list of the state vector names that apply to this object. More...

virtual void	state_vector_name (const StateVector &Sv, blitz::Array< std::string, 1 > &Sv_name) const
	Update any portion of the list of the state vector names that apply to this object. More...

virtual std::string	state_vector_name_i (int i) const
	Return state vector name for ith entry in coeff. More...

virtual void	state_vector_name_sub (blitz::Array< std::string, 1 > &Sv_name) const
	Called by state_vector_name with the subset of the Sv_name used by this class. More...

int	state_vector_start_index () const
	Starting index of state vector used by this object. More...

const blitz::Array< double, 2 > &	statevector_covariance () const

virtual std::string	sub_state_identifier () const
	Return a string to identify this part of the state, this name should be all lower case and seperate parts with a /. More...

int	sub_vector_size () const
	Length of the sub set of the state vector used by this object. More...

virtual ArrayAd< double, 1 >	surface_parameter (const double wn, const int spec_index) const
	Surface parmeters. More...

virtual void	update_sub_state (const ArrayAd< double, 1 > &Sv_sub, const blitz::Array< double, 2 > &Cov)
	Called by update_state with the subset of the state vector used by this class. More...

virtual void	update_sub_state_hook ()
	Hook for anything a derived class needs to do after coefficient is updated and before notify_update. More...

const blitz::Array< bool, 1 > &	used_flag_value () const

virtual const AutoDerivative< double >	weight (const double wn, const int spec_index) const

virtual const AutoDerivative< double >	weight_intercept (const int spec_index) const

virtual void	weight_intercept (const int spec_index, const AutoDerivative< double > &val)

virtual const AutoDerivative< double >	weight_slope (const int spec_index) const

virtual void	weight_slope (const int spec_index, const AutoDerivative< double > &val)

Protected Member Functions
	GroundBrdf (const blitz::Array< double, 1 > &Spec_coeffs, const blitz::Array< bool, 1 > &Flag, const ArrayWithUnit< double, 1 > &Ref_points, const std::vector< std::string > &Desc_band_names)
	Protected constructor that matches the dimensionality of coeff and flag arrays. More...

void	add_observer_do (Observer< Ground > &Obs, Ground &t)
	Add an observer. More...

void	add_observer_do (Observer< Ground > &Obs)

blitz::Array< double, 1 >	black_sky_params (const int Spec_index)

void	clean_dead_ptr ()
	Remove any dead pointers. More...

blitz::Array< double, 1 >	kernel_value_params (const int Spec_index)

void	notify_update_do (const Ground &Self)
	Function to call to notify Observers of a state change. More...

void	remove_observer_do (Observer< Ground > &Obs, Ground &t)
	Remove an observer. More...

void	remove_observer_do (Observer< Ground > &Obs)

void	state_vector_observer_initialize (int Plen)
	Take the given number of state vector parameters. More...

Protected Attributes
ArrayAd< double, 1 >	coeff
	Coefficients. More...

blitz::Array< double, 2 >	cov
	Last covariance matrix updated from the StateVector. More...

std::vector< std::string >	desc_band_names

bool	mark_according_to_press
	Flag indicating if we only mark coefficients >= pdep_start + press->number_level() in mark_used_sub. More...

std::list< boost::weak_ptr< Observer< Ground > > >	olist

int	pdep_start
	Index of first coefficient that depends on the number of pressure levels. More...

boost::shared_ptr< Pressure >	press
	Pressure. More...

std::vector< boost::shared_ptr< Observer< Ground > > >	ref_list

ArrayWithUnit< double, 1 >	reference_points

blitz::Array< double, 2 >	sv_cov_full
	The last full covariance matrix we have been with, saved for reference by derived class. More...

blitz::Array< double, 2 >	sv_cov_sub
	The subset of cov_full that is "owned" by this class, what was passed through update_sub_state. More...

ArrayAd< double, 1 >	sv_full
	The last full state vector we have been updated with, saved for reference by derived class. More...

ArrayAd< double, 1 >	sv_sub
	The subset of sv_full that is "owned" by this class, what was passed through update_sub_state. More...

blitz::Array< bool, 1 >	used_flag
	Flag indicating which of the coefficients gets updated by the StateVector. More...

Detailed Description

This class implements the Breon + Rahman ground type.

The retrieved parameters are for the Rahman type. Refractive index is hardcoded at 1.5 as it is hard coded inside of LIDORT and l_rad.

Base class for both Vegetative and Soil types which share the same mechanisms but are implemented differently in RT codes

Definition at line 19 of file ground_brdf.h.

Member Enumeration Documentation

◆ ParamIndex

enum FullPhysics::GroundBrdf::ParamIndex

Enumerator
BRDF_WEIGHT_INTERCEPT_INDEX
BRDF_WEIGHT_SLOPE_INDEX
RAHMAN_KERNEL_FACTOR_INDEX
RAHMAN_OVERALL_AMPLITUDE_INDEX
RAHMAN_ASYMMETRY_FACTOR_INDEX
RAHMAN_GEOMETRIC_FACTOR_INDEX
BREON_KERNEL_FACTOR_INDEX

Definition at line 21 of file ground_brdf.h.

Constructor & Destructor Documentation

◆ GroundBrdf() [1/2]

GroundBrdf::GroundBrdf	(	const blitz::Array< double, 2 > &	Coeffs,
		const blitz::Array< bool, 2 > &	Flag,
		const ArrayWithUnit< double, 1 > &	Ref_points,
		const std::vector< std::string > &	Desc_band_names
	)

Constructor that defines coefficients in a 2d array: Num_spectrometer * NUM_COEFF Each row has the NUM_COEFF BRDF parameters for a spectrometer.

Coefficients are ordered: 0: BRDF overall weight intercept 1: BRDF overall weight slope 2: Rahman kernel factor 3: Rahman hotspot parameter 4: Rahman asymmetry factor 5: Rahman anisotropy parameter 6: Breon kernel factor

Definition at line 79 of file ground_brdf.cc.

◆ GroundBrdf() [2/2]

GroundBrdf::GroundBrdf	(	const blitz::Array< double, 1 > &	Spec_coeffs,
		const blitz::Array< bool, 1 > &	Flag,
		const ArrayWithUnit< double, 1 > &	Ref_points,
		const std::vector< std::string > &	Desc_band_names
	)

protected

Protected constructor that matches the dimensionality of coeff and flag arrays.

Definition at line 125 of file ground_brdf.cc.

Member Function Documentation

◆ add_observer()

virtual void FullPhysics::Ground::add_observer ( Observer< Ground > & Obs )

inlinevirtualinherited

Add an observer.

Implements FullPhysics::Observable< Ground >.

Definition at line 26 of file ground.h.

◆ add_observer_and_keep_reference()

void FullPhysics::Observable< Ground >::add_observer_and_keep_reference ( boost::shared_ptr< Observer< Ground > > & Obs )

inlineinherited

Add an observer and keep a reference to it.

See the discussion in the Observer class description for details.

Definition at line 107 of file observer.h.

◆ add_observer_do() [1/2]

void FullPhysics::Observable< Ground >::add_observer_do	(	Observer< Ground > &	Obs,
		Ground &	t
	)

inlineprotectedinherited

Add an observer.

Definition at line 148 of file observer.h.

◆ add_observer_do() [2/2]

void FullPhysics::Observable< Ground >::add_observer_do ( Observer< Ground > & Obs )

inlineprotectedinherited

Definition at line 159 of file observer.h.

◆ anisotropy_parameter() [1/2]

const AutoDerivative< double > GroundBrdf::anisotropy_parameter ( const int spec_index ) const

virtual

Definition at line 193 of file ground_brdf.cc.

◆ anisotropy_parameter() [2/2]

void GroundBrdf::anisotropy_parameter	(	const int	spec_index,
		const AutoDerivative< double > &	val
	)

virtual

Definition at line 244 of file ground_brdf.cc.

◆ asymmetry_parameter() [1/2]

const AutoDerivative< double > GroundBrdf::asymmetry_parameter ( const int spec_index ) const

virtual

Definition at line 186 of file ground_brdf.cc.

◆ asymmetry_parameter() [2/2]

void GroundBrdf::asymmetry_parameter	(	const int	spec_index,
		const AutoDerivative< double > &	val
	)

virtual

Definition at line 237 of file ground_brdf.cc.

◆ black_sky_albedo()

virtual const double FullPhysics::GroundBrdf::black_sky_albedo	(	const int	Spec_index,
		const double	Sza
	)

pure virtual

Implemented in FullPhysics::GroundBrdfSoil, and FullPhysics::GroundBrdfVeg.

◆ black_sky_params()

blitz::Array< double, 1 > GroundBrdf::black_sky_params ( const int Spec_index )

protected

Definition at line 292 of file ground_brdf.cc.

◆ brdf_covariance()

const blitz::Array< double, 2 > GroundBrdf::brdf_covariance ( const int spec_index ) const

Definition at line 258 of file ground_brdf.cc.

◆ breon_factor() [1/2]

const AutoDerivative< double > GroundBrdf::breon_factor ( const int spec_index ) const

virtual

Definition at line 200 of file ground_brdf.cc.

◆ breon_factor() [2/2]

void GroundBrdf::breon_factor	(	const int	spec_index,
		const AutoDerivative< double > &	val
	)

virtual

Definition at line 251 of file ground_brdf.cc.

◆ breon_type()

virtual const std::string FullPhysics::GroundBrdf::breon_type ( ) const

pure virtual

String describing which type of Breon surface type, also makes this class abstract.

Implemented in FullPhysics::GroundBrdfSoil, and FullPhysics::GroundBrdfVeg.

◆ clean_dead_ptr()

void FullPhysics::Observable< Ground >::clean_dead_ptr ( )

inlineprotectedinherited

Remove any dead pointers.

Definition at line 196 of file observer.h.

◆ clone()

virtual boost::shared_ptr<Ground> FullPhysics::GroundBrdf::clone ( ) const

pure virtual

Clone a Ground object.

Note that the cloned version will not be attached to a StateVector, although you can of course attach them after receiving the cloned object.

Because this isn't attached to the StateVector, one use of the clone operator is to create a "frozen" Ground object.

Implements FullPhysics::Ground.

Implemented in FullPhysics::GroundBrdfSoil, and FullPhysics::GroundBrdfVeg.

◆ coefficient()

const ArrayAd<double, 1>& FullPhysics::SubStateVectorArray< Ground >::coefficient ( ) const

inlineinherited

Definition at line 171 of file sub_state_vector_array.h.

◆ desc()

virtual std::string FullPhysics::GroundBrdf::desc ( ) const

inlinevirtual

Definition at line 83 of file ground_brdf.h.

◆ hotspot_parameter() [1/2]

const AutoDerivative< double > GroundBrdf::hotspot_parameter ( const int spec_index ) const

virtual

Definition at line 179 of file ground_brdf.cc.

◆ hotspot_parameter() [2/2]

void GroundBrdf::hotspot_parameter	(	const int	spec_index,
		const AutoDerivative< double > &	val
	)

virtual

Definition at line 230 of file ground_brdf.cc.

◆ init()

void FullPhysics::SubStateVectorArray< Ground >::init	(	const blitz::Array< double, 1 > &	Coeff,
		const blitz::Array< bool, 1 > &	Used_flag,
		const boost::shared_ptr< Pressure > &	Press = `boost::shared_ptr<Pressure>()`,
		bool	Mark_according_to_press = `true`,
		int	Pdep_start = `0`
	)

inlineinherited

Definition at line 59 of file sub_state_vector_array.h.

◆ kernel_value()

virtual const double FullPhysics::GroundBrdf::kernel_value	(	const int	Spec_index,
		const double	Sza,
		const double	Vza,
		const double	Azm
	)

pure virtual

Implemented in FullPhysics::GroundBrdfSoil, and FullPhysics::GroundBrdfVeg.

◆ kernel_value_params()

blitz::Array< double, 1 > GroundBrdf::kernel_value_params ( const int Spec_index )

protected

Definition at line 307 of file ground_brdf.cc.

◆ mark_used() [1/2]

void SubStateVectorObserver::mark_used	(	const StateVector &	Sv,
		blitz::Array< bool, 1 > &	Used
	)		const

virtualinherited

Mark elements that we are actively using (i.e., that aren't ignored).

You only need to mark the ones that are used as true, everything is already initialized as false. Default is to do nothing.

Reimplemented from FullPhysics::StateVectorObserver.

Definition at line 35 of file sub_state_vector_observer.cc.

◆ mark_used() [2/2]

virtual void FullPhysics::StateVectorObserver::mark_used	(	const StateVector &	Sv,
		blitz::Array< bool, 1 > &	Used
	)		const

inlinevirtualinherited

Mark elements that we are actively using (i.e., that aren't ignored).

You only need to mark the ones that are used as true, everything is already initialized as false. Default is to do nothing.

Reimplemented in FullPhysics::SubStateVectorObserver.

Definition at line 26 of file state_vector_observer.h.

◆ mark_used_sub()

void FullPhysics::SubStateVectorArray< Ground >::mark_used_sub ( blitz::Array< bool, 1 > & Used ) const

inlinevirtualinherited

Called by mark_used with the subset of the state vector used by this class.

The default marks everything as used, but derived classes can override this.

Reimplemented from FullPhysics::SubStateVectorObserver.

Definition at line 91 of file sub_state_vector_array.h.

◆ notify_add() [1/3]

virtual void FullPhysics::Observer< StateVector >::notify_add ( StateVector & Observed_object )

inlinevirtualinherited

Called when an object is added to an Observable.

Default is to do nothing.

Reimplemented in FullPhysics::AtmosphereOco, and FullPhysics::SubStateVectorObserver.

Definition at line 47 of file observer.h.

◆ notify_add() [2/3]

virtual void FullPhysics::Observer< StateVector >::notify_add ( )

inlinevirtualinherited

Definition at line 48 of file observer.h.

◆ notify_add() [3/3]

virtual void FullPhysics::SubStateVectorObserver::notify_add ( StateVector & Observed_object )

inlinevirtualinherited

Called when an object is added to an Observable.

Default is to do nothing.

Reimplemented from FullPhysics::Observer< StateVector >.

Definition at line 60 of file sub_state_vector_observer.h.

◆ notify_remove() [1/3]

virtual void FullPhysics::Observer< StateVector >::notify_remove ( StateVector & Observed_object )

inlinevirtualinherited

Called when an object is removed from an Observable.

Default is to do nothing.

Reimplemented in FullPhysics::AtmosphereOco, and FullPhysics::SubStateVectorObserver.

Definition at line 55 of file observer.h.

◆ notify_remove() [2/3]

virtual void FullPhysics::Observer< StateVector >::notify_remove ( )

inlinevirtualinherited

Definition at line 56 of file observer.h.

◆ notify_remove() [3/3]

virtual void FullPhysics::SubStateVectorObserver::notify_remove ( StateVector & Observed_object )

inlinevirtualinherited

Called when an object is removed from an Observable.

Default is to do nothing.

Reimplemented from FullPhysics::Observer< StateVector >.

Definition at line 68 of file sub_state_vector_observer.h.

◆ notify_update() [1/2]

void SubStateVectorObserver::notify_update ( const StateVector & Observed_object )

virtualinherited

Called when the Observed object is updated.

Reimplemented from FullPhysics::Observer< StateVector >.

Reimplemented in FullPhysics::RadianceScalingSvFit.

Definition at line 6 of file sub_state_vector_observer.cc.

◆ notify_update() [2/2]

virtual void FullPhysics::Observer< StateVector >::notify_update ( const StateVector & Observed_object )

inlinevirtualinherited

Called when the Observed object is updated.

Reimplemented in FullPhysics::AtmosphereOco, FullPhysics::RadianceScalingSvFit, FullPhysics::AbsorberAbsco, FullPhysics::AerosolOptical, and FullPhysics::SubStateVectorObserver.

Definition at line 40 of file observer.h.

◆ notify_update_do()

void FullPhysics::Observable< Ground >::notify_update_do ( const Ground & Self )

inlineprotectedinherited

Function to call to notify Observers of a state change.

The object should pass itself to this function, so it can be passed to the Observers.

Definition at line 121 of file observer.h.

◆ number_spectrometer()

virtual const int FullPhysics::GroundBrdf::number_spectrometer ( ) const

inlinevirtual

Definition at line 38 of file ground_brdf.h.

◆ pressure()

const boost::shared_ptr<Pressure>& FullPhysics::SubStateVectorArray< Ground >::pressure ( ) const

inlineinherited

Definition at line 186 of file sub_state_vector_array.h.

◆ print()

void GroundBrdf::print ( std::ostream & Os ) const

virtual

Reimplemented from FullPhysics::SubStateVectorObserver.

Definition at line 377 of file ground_brdf.cc.

◆ print_to_string()

std::string FullPhysics::Printable< StateVectorObserver >::print_to_string ( ) const

inlineinherited

Print to string.

This is primarily useful for SWIG wrappers to this class, e.g. a to_s method in ruby.

Definition at line 31 of file printable.h.

◆ rahman_factor() [1/2]

const AutoDerivative< double > GroundBrdf::rahman_factor ( const int spec_index ) const

virtual

Definition at line 172 of file ground_brdf.cc.

◆ rahman_factor() [2/2]

void GroundBrdf::rahman_factor	(	const int	spec_index,
		const AutoDerivative< double > &	val
	)

virtual

Definition at line 223 of file ground_brdf.cc.

◆ reference_point()

virtual const DoubleWithUnit FullPhysics::GroundBrdf::reference_point ( const int spec_index ) const

inlinevirtual

Center wavelength that spectrally dependent parameter is referenced to.

Definition at line 73 of file ground_brdf.h.

◆ refractive_index()

virtual const double FullPhysics::GroundBrdf::refractive_index ( const int Spec_idx ) const

inlinevirtual

Returns hard coded value of 1.5 since that is the value hardcoded into LIDORT.

Definition at line 61 of file ground_brdf.h.

◆ remove_observer()

virtual void FullPhysics::Ground::remove_observer ( Observer< Ground > & Obs )

inlinevirtualinherited

Remove an observer.

Implements FullPhysics::Observable< Ground >.

Definition at line 28 of file ground.h.

◆ remove_observer_do() [1/2]

void FullPhysics::Observable< Ground >::remove_observer_do	(	Observer< Ground > &	Obs,
		Ground &	t
	)

inlineprotectedinherited

Remove an observer.

Definition at line 173 of file observer.h.

◆ remove_observer_do() [2/2]

void FullPhysics::Observable< Ground >::remove_observer_do ( Observer< Ground > & Obs )

inlineprotectedinherited

Definition at line 181 of file observer.h.

◆ state_vector_name() [1/2]

void SubStateVectorObserver::state_vector_name	(	const StateVector &	Sv,
		blitz::Array< std::string, 1 > &	Sv_name
	)		const

virtualinherited

Update any portion of the list of the state vector names that apply to this object.

Default is to do nothing.

Reimplemented from FullPhysics::StateVectorObserver.

Definition at line 52 of file sub_state_vector_observer.cc.

◆ state_vector_name() [2/2]

virtual void FullPhysics::StateVectorObserver::state_vector_name	(	const StateVector &	Sv,
		blitz::Array< std::string, 1 > &	Sv_name
	)		const

inlinevirtualinherited

Update any portion of the list of the state vector names that apply to this object.

Default is to do nothing.

Reimplemented in FullPhysics::SubStateVectorObserver.

Definition at line 34 of file state_vector_observer.h.

◆ state_vector_name_i()

std::string GroundBrdf::state_vector_name_i ( int i ) const

virtual

Return state vector name for ith entry in coeff.

Reimplemented from FullPhysics::SubStateVectorArray< Ground >.

Definition at line 342 of file ground_brdf.cc.

◆ state_vector_name_sub()

virtual void FullPhysics::SubStateVectorArray< Ground >::state_vector_name_sub ( blitz::Array< std::string, 1 > & Sv_name ) const

inlinevirtualinherited

Called by state_vector_name with the subset of the Sv_name used by this class.

The default function doesn't change anything, but derived classes can ovveride this.

Reimplemented from FullPhysics::SubStateVectorObserver.

Definition at line 134 of file sub_state_vector_array.h.

◆ state_vector_observer_initialize()

void SubStateVectorObserver::state_vector_observer_initialize ( int Plen )

protectedinherited

Take the given number of state vector parameters.

We determine where the starting point to use is when we attach to the state vector.

Note that it is perfectly legal for Plen to be 0, that just means we don't have any parameters. This is a useful edge case that we support.

Definition at line 80 of file sub_state_vector_observer.cc.

◆ state_vector_start_index()

int FullPhysics::SubStateVectorObserver::state_vector_start_index ( ) const

inlineinherited

Starting index of state vector used by this object.

Definition at line 25 of file sub_state_vector_observer.h.

◆ statevector_covariance()

const blitz::Array<double, 2>& FullPhysics::SubStateVectorArray< Ground >::statevector_covariance ( ) const

inlineinherited

Definition at line 181 of file sub_state_vector_array.h.

◆ sub_state_identifier()

virtual std::string FullPhysics::GroundBrdf::sub_state_identifier ( ) const

inlinevirtual

Return a string to identify this part of the state, this name should be all lower case and seperate parts with a /.

For example, an aerosol named strat would be named as: aerosol/strat. A gas named CO2 would be named like this: absorber/co2 The name is intended to be used for looking up retrieval values for a configuration system. Classes that have the same type of inputs should have the same name.

Reimplemented from FullPhysics::SubStateVectorArray< Ground >.

Definition at line 77 of file ground_brdf.h.

◆ sub_vector_size()

int FullPhysics::SubStateVectorObserver::sub_vector_size ( ) const

inlineinherited

Length of the sub set of the state vector used by this object.

Definition at line 31 of file sub_state_vector_observer.h.

◆ surface_parameter()

ArrayAd< double, 1 > GroundBrdf::surface_parameter	(	const double	wn,
		const int	spec_index
	)		const

virtual

Surface parmeters.

What exactly these parameters mean is determined by the surface type, see the discussion in the comments before the Ground class.

Implements FullPhysics::Ground.

Definition at line 134 of file ground_brdf.cc.

◆ update_sub_state()

virtual void FullPhysics::SubStateVectorArray< Ground >::update_sub_state	(	const ArrayAd< double, 1 > &	Sv_sub,
		const blitz::Array< double, 2 > &	Cov
	)

inlinevirtualinherited

Called by update_state with the subset of the state vector used by this class.

Implements FullPhysics::SubStateVectorObserver.

Definition at line 145 of file sub_state_vector_array.h.

◆ update_sub_state_hook()

virtual void FullPhysics::SubStateVectorArray< Ground >::update_sub_state_hook ( )

inlinevirtualinherited

Hook for anything a derived class needs to do after coefficient is updated and before notify_update.

Default is nothing.

Reimplemented in FullPhysics::GroundCoxmunk.

Definition at line 167 of file sub_state_vector_array.h.

◆ used_flag_value()

const blitz::Array<bool, 1>& FullPhysics::SubStateVectorArray< Ground >::used_flag_value ( ) const

inlineinherited

Definition at line 176 of file sub_state_vector_array.h.

◆ weight()

const AutoDerivative< double > GroundBrdf::weight	(	const double	wn,
		const int	spec_index
	)		const

virtual

Definition at line 147 of file ground_brdf.cc.

◆ weight_intercept() [1/2]

const AutoDerivative< double > GroundBrdf::weight_intercept ( const int spec_index ) const

virtual

Definition at line 158 of file ground_brdf.cc.

◆ weight_intercept() [2/2]

void GroundBrdf::weight_intercept	(	const int	spec_index,
		const AutoDerivative< double > &	val
	)

virtual

Definition at line 209 of file ground_brdf.cc.

◆ weight_slope() [1/2]

const AutoDerivative< double > GroundBrdf::weight_slope ( const int spec_index ) const

virtual

Definition at line 165 of file ground_brdf.cc.

◆ weight_slope() [2/2]

void GroundBrdf::weight_slope	(	const int	spec_index,
		const AutoDerivative< double > &	val
	)

virtual

Definition at line 216 of file ground_brdf.cc.

Member Data Documentation

◆ coeff

ArrayAd<double, 1> FullPhysics::SubStateVectorArray< Ground >::coeff

protectedinherited

Coefficients.

Definition at line 196 of file sub_state_vector_array.h.

◆ cov

blitz::Array<double, 2> FullPhysics::SubStateVectorArray< Ground >::cov

protectedinherited

Last covariance matrix updated from the StateVector.

If we haven't updated yet, this will be a 0x0 array.

Definition at line 216 of file sub_state_vector_array.h.

◆ desc_band_names

std::vector<std::string> FullPhysics::GroundBrdf::desc_band_names

protected

Definition at line 93 of file ground_brdf.h.

◆ mark_according_to_press

bool FullPhysics::SubStateVectorArray< Ground >::mark_according_to_press

protectedinherited

Flag indicating if we only mark coefficients >= pdep_start + press->number_level() in mark_used_sub.

This may seem a bit arcane, but this matches some of the classes that derive from this one (e.g., TemperatureFixedLevel).

Definition at line 225 of file sub_state_vector_array.h.

◆ olist

std::list<boost::weak_ptr<Observer<Ground > > > FullPhysics::Observable< Ground >::olist

protectedinherited

Definition at line 200 of file observer.h.

◆ pdep_start

int FullPhysics::SubStateVectorArray< Ground >::pdep_start

protectedinherited

Index of first coefficient that depends on the number of pressure levels.

This is only used if mark_according_to_press to true, otherwise we don't do anything with this value.

Definition at line 233 of file sub_state_vector_array.h.

◆ press

boost::shared_ptr<Pressure> FullPhysics::SubStateVectorArray< Ground >::press

protectedinherited

Pressure.

This may be a null pointer, which just means this particular class doesn't store the Pressure object.

Definition at line 203 of file sub_state_vector_array.h.

◆ ref_list

std::vector<boost::shared_ptr<Observer<Ground > > > FullPhysics::Observable< Ground >::ref_list

protectedinherited

Definition at line 201 of file observer.h.

◆ reference_points

ArrayWithUnit<double, 1> FullPhysics::GroundBrdf::reference_points

protected

Definition at line 92 of file ground_brdf.h.

◆ sv_cov_full

blitz::Array<double, 2> FullPhysics::SubStateVectorObserver::sv_cov_full

protectedinherited

The last full covariance matrix we have been with, saved for reference by derived class.

Definition at line 108 of file sub_state_vector_observer.h.

◆ sv_cov_sub

blitz::Array<double, 2> FullPhysics::SubStateVectorObserver::sv_cov_sub

protectedinherited

The subset of cov_full that is "owned" by this class, what was passed through update_sub_state.

Saved for reference by derived class.

Definition at line 122 of file sub_state_vector_observer.h.

◆ sv_full

ArrayAd<double, 1> FullPhysics::SubStateVectorObserver::sv_full

protectedinherited

The last full state vector we have been updated with, saved for reference by derived class.

Definition at line 102 of file sub_state_vector_observer.h.

◆ sv_sub

ArrayAd<double, 1> FullPhysics::SubStateVectorObserver::sv_sub

protectedinherited

The subset of sv_full that is "owned" by this class, what was passed through update_sub_state.

Saved for reference by derived class.

Definition at line 115 of file sub_state_vector_observer.h.

◆ used_flag

blitz::Array<bool, 1> FullPhysics::SubStateVectorArray< Ground >::used_flag

protectedinherited

Flag indicating which of the coefficients gets updated by the StateVector.

Definition at line 210 of file sub_state_vector_array.h.

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

Implementation/ground_brdf.h
Implementation/ground_brdf.cc

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ ParamIndex

Constructor & Destructor Documentation

◆ GroundBrdf() [1/2]

◆ GroundBrdf() [2/2]

Member Function Documentation

◆ add_observer()

◆ add_observer_and_keep_reference()

◆ add_observer_do() [1/2]

◆ add_observer_do() [2/2]

◆ anisotropy_parameter() [1/2]

◆ anisotropy_parameter() [2/2]

◆ asymmetry_parameter() [1/2]

◆ asymmetry_parameter() [2/2]

◆ black_sky_albedo()

◆ black_sky_params()

◆ brdf_covariance()

◆ breon_factor() [1/2]

◆ breon_factor() [2/2]

◆ breon_type()

◆ clean_dead_ptr()

◆ clone()

◆ coefficient()

◆ desc()

◆ hotspot_parameter() [1/2]

◆ hotspot_parameter() [2/2]

◆ init()

◆ kernel_value()

◆ kernel_value_params()

◆ mark_used() [1/2]

◆ mark_used() [2/2]

◆ mark_used_sub()

◆ notify_add() [1/3]

◆ notify_add() [2/3]

◆ notify_add() [3/3]

◆ notify_remove() [1/3]

◆ notify_remove() [2/3]

◆ notify_remove() [3/3]

◆ notify_update() [1/2]

◆ notify_update() [2/2]

◆ notify_update_do()

◆ number_spectrometer()

◆ pressure()

◆ print()

◆ print_to_string()

◆ rahman_factor() [1/2]

◆ rahman_factor() [2/2]

◆ reference_point()

◆ refractive_index()

◆ remove_observer()

◆ remove_observer_do() [1/2]

◆ remove_observer_do() [2/2]

◆ state_vector_name() [1/2]

◆ state_vector_name() [2/2]

◆ state_vector_name_i()

◆ state_vector_name_sub()

◆ state_vector_observer_initialize()

◆ state_vector_start_index()

◆ statevector_covariance()

◆ sub_state_identifier()

◆ sub_vector_size()

◆ surface_parameter()

◆ update_sub_state()

◆ update_sub_state_hook()

◆ used_flag_value()

◆ weight()

◆ weight_intercept() [1/2]

◆ weight_intercept() [2/2]

◆ weight_slope() [1/2]

◆ weight_slope() [2/2]

Member Data Documentation

◆ coeff

◆ cov

◆ desc_band_names

◆ mark_according_to_press