This class implements a Coxmunk ground type. More...

#include <ground_coxmunk.h>

Inheritance diagram for FullPhysics::GroundCoxmunk:

Collaboration diagram for FullPhysics::GroundCoxmunk:

Public Member Functions
	GroundCoxmunk (const double Windspeed, const bool &Ws_flag, const blitz::Array< double, 1 > &Refr_index)

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 boost::shared_ptr< Ground >	clone () const
	Clone a Ground object. More...

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

virtual std::string	desc () const

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

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 double	refractive_index (const int Spec_idx) const

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 >	windspeed () const

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

void	add_observer_do (Observer< Ground > &Obs)

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

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

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

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 a Coxmunk ground type.

Definition at line 12 of file ground_coxmunk.h.

Constructor & Destructor Documentation

◆ GroundCoxmunk()

GroundCoxmunk::GroundCoxmunk	(	const double	Windspeed,
		const bool &	Ws_flag,
		const blitz::Array< double, 1 > &	Refr_index
	)

Definition at line 17 of file ground_coxmunk.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.

◆ clean_dead_ptr()

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

inlineprotectedinherited

Remove any dead pointers.

Definition at line 196 of file observer.h.

◆ clone()

boost::shared_ptr< Ground > GroundCoxmunk::clone ( ) const

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.

Definition at line 47 of file ground_coxmunk.cc.

◆ 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::GroundCoxmunk::desc ( ) const

inlinevirtual

Definition at line 32 of file ground_coxmunk.h.

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

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

◆ 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 GroundCoxmunk::print ( std::ostream & Os ) const

virtual

Reimplemented from FullPhysics::SubStateVectorObserver.

Definition at line 55 of file ground_coxmunk.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.

◆ refractive_index()

const double GroundCoxmunk::refractive_index ( const int Spec_idx ) const

virtual

Definition at line 42 of file ground_coxmunk.cc.

◆ 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 GroundCoxmunk::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 51 of file ground_coxmunk.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::GroundCoxmunk::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 26 of file ground_coxmunk.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 > GroundCoxmunk::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 25 of file ground_coxmunk.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()

void GroundCoxmunk::update_sub_state_hook ( )

virtual

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

Default is nothing.

Reimplemented from FullPhysics::SubStateVectorArray< Ground >.

Definition at line 64 of file ground_coxmunk.cc.

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

◆ windspeed()

const AutoDerivative< double > GroundCoxmunk::windspeed ( ) const

virtual

Definition at line 37 of file ground_coxmunk.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.

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

◆ 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_coxmunk.h
Implementation/ground_coxmunk.cc

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ GroundCoxmunk()

Member Function Documentation

◆ add_observer()

◆ add_observer_and_keep_reference()

◆ add_observer_do() [1/2]

◆ add_observer_do() [2/2]

◆ clean_dead_ptr()

◆ clone()

◆ coefficient()

◆ desc()

◆ init()

◆ 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()

◆ pressure()

◆ print()

◆ print_to_string()

◆ 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()

◆ windspeed()

Member Data Documentation

◆ coeff

◆ cov

◆ mark_according_to_press

◆ olist

◆ pdep_start

◆ press

◆ ref_list

◆ sv_cov_full

◆ sv_cov_sub

◆ sv_full

◆ sv_sub

◆ used_flag