#include <altimetry-definitions.h>

Inheritance diagram for woss::Altimetry:

Collaboration diagram for woss::Altimetry:

Public Member Functions
	Altimetry ()

	Altimetry (AltimetryMap &map)

	Altimetry (double range, double altimetry)

	Altimetry (const Altimetry &copy)

virtual Altimetry *	create () const

virtual Altimetry *	create (AltimetryMap &map) const

virtual Altimetry *	create (const Altimetry &copy) const

virtual Altimetry *	clone () const

Altimetry &	insertValue (double range, double altimetry)

Altimetry &	sumValue (double range, double altimetry)

AltCIt	findValue (double range) const

Altimetry &	eraseValue (double range)

virtual Altimetry *	crop (double range_start, double range_end)

virtual Altimetry *	randomize (double ratio_incr_value) const

AltCIt	begin () const

AltCIt	end () const

AltCIt	at (const int i) const

int	size () const

bool	empty () const

void	clear ()

Altimetry &	setEvolutionTimeQuantum (double quantum)

Altimetry &	setTotalRangeSteps (int r_s)

Altimetry &	setRange (double r)

Altimetry &	setDepth (double d)

double	getMaxRangeValue () const

double	getMinRangeValue () const

double	getMaxAltimetryValue () const

double	getMinAltimetryValue () const

long double	getRangePrecision () const

double	getEvolutionTimeQuantum () const

double	getRange () const

int	getTotalRangeSteps () const

double	getDepth () const

virtual bool	isValid () const

virtual bool	initialize ()

virtual Altimetry *	timeEvolve (const Time &time_value)

Altimetry &	operator= (const Altimetry &copy)

Static Public Member Functions
static AltimetryMap &	createNotValid ()

static AltimetryMap &	createFlat (double altimetry=0)

static void	setDebug (bool flag)

static bool	getDebug (bool flag)

Protected Member Functions
virtual Altimetry &	updateMinMaxAltimetryValues ()

Protected Attributes
double	range

int	total_range_steps

double	min_altimetry_value

double	max_altimetry_value

long double	range_precision

Time	last_evolution_time

double	evolution_time_quantum

double	depth

AltimetryMap	altimetry_map

Static Protected Attributes
static bool	debug = false

Friends
bool	operator== (const Altimetry &left, const Altimetry &right)

bool	operator!= (const Altimetry &left, const Altimetry &right)

const Altimetry	operator+ (const Altimetry &left, const Altimetry &right)

const Altimetry	operator- (const Altimetry &left, const Altimetry &right)

const Altimetry	operator+ (const Altimetry &left, const double right)

const Altimetry	operator- (const Altimetry &left, const double right)

const Altimetry	operator/ (const Altimetry &left, const double right)

const Altimetry	operator* (const Altimetry &left, const double right)

const Altimetry	operator+ (const double left, const Altimetry &right)

const Altimetry	operator- (const double left, const Altimetry &right)

const Altimetry	operator/ (const double left, const Altimetry &right)

const Altimetry	operator* (const double left, const Altimetry &right)

Altimetry &	operator+= (Altimetry &left, const Altimetry &right)

Altimetry &	operator-= (Altimetry &left, const Altimetry &right)

Altimetry &	operator+= (Altimetry &left, double right)

Altimetry &	operator-= (Altimetry &left, double right)

Altimetry &	operator/= (Altimetry &left, double right)

Altimetry &	operator*= (Altimetry &left, double right)

std::ostream &	operator<< (std::ostream &os, const Altimetry &instance)

Detailed Description

Altimetry profile class.

Altimetry class offers the possibility to store and manipulate altimetry profiles, e.g. a collection of range [m] values associated to a altimetry value [m].

Constructor & Destructor Documentation

◆ Altimetry() [1/4]

Altimetry::Altimetry ( )

Default Altimetry constructor

Referenced by clone(), create(), crop(), and randomize().

◆ Altimetry() [2/4]

Altimetry::Altimetry ( AltimetryMap & map )

Altimetry constructor

Parameters

map	custom time arrival map

References altimetry_map, and range_precision.

◆ Altimetry() [3/4]

Altimetry::Altimetry	(	double	range,
		double	altimetry
	)

Altimetry constructor

Parameters

range	range [m]
altimetry	altimetry [m]

References altimetry_map, max_altimetry_value, min_altimetry_value, and range.

◆ Altimetry() [4/4]

Altimetry::Altimetry ( const Altimetry & copy )

Altimetry copy constructor

Parameters

copy	Altimetry to be copied

Member Function Documentation

◆ at()

AltCIt Altimetry::at ( const int i ) const

Returns a const iterator to the altimetry value at i-th position

Parameters

i	integer should be between 0 and size()

Returns: const iterator to end() if position i is not found

References altimetry_map.

◆ begin()

AltCIt woss::Altimetry::begin ( ) const

inline

Returns a const iterator to the beginning of the altimetry map

Returns: const iterator

References altimetry_map.

◆ clear()

void woss::Altimetry::clear ( )

inline

Erase all values of altimetry

References altimetry_map.

◆ clone()

virtual Altimetry * woss::Altimetry::clone ( ) const

inlinevirtual

Altimetry virtual factory method

Returns: a heap-created copy of this instance

Reimplemented in woss::AltimBretschneider.

References Altimetry().

Referenced by woss::DefHandler::operator=(), and timeEvolve().

Here is the call graph for this function:

◆ create() [1/3]

virtual Altimetry * woss::Altimetry::create ( ) const

inlinevirtual

Altimetry virtual factory method

Returns: a heap-created Altimetry object

Reimplemented in woss::AltimBretschneider.

References Altimetry().

Referenced by crop().

Here is the call graph for this function:

◆ create() [2/3]

virtual Altimetry * woss::Altimetry::create ( AltimetryMap & map ) const

inlinevirtual

Altimetry virtual factory method

Parameters

map	custom time arrival map

Returns: a heap-created Altimetry object

Reimplemented in woss::AltimBretschneider.

References Altimetry().

Here is the call graph for this function:

◆ create() [3/3]

virtual Altimetry * woss::Altimetry::create ( const Altimetry & copy ) const

inlinevirtual

Altimetry virtual factory method

Parameters

copy	Altimetry to be copied

Returns: a heap-created Altimetry object

Reimplemented in woss::AltimBretschneider.

References Altimetry().

Here is the call graph for this function:

◆ createFlat()

AltimetryMap & woss::Altimetry::createFlat ( double altimetry = 0 )

inlinestatic

Creates a flat altimetry

Returns: a new flat altimetry instance ( e.g. range 0.0 = altimetry )

References altimetry_map.

◆ createNotValid()

AltimetryMap & woss::Altimetry::createNotValid ( )

inlinestatic

Creates an instance not valid

Returns: a new instance not valid ( e.g. range 0.0 = +inf )

References altimetry_map.

Referenced by crop(), woss::WossDbManager::getAltimetry(), and randomize().

◆ crop()

Altimetry * Altimetry::crop	(	double	range_start,
		double	range_end
	)

virtual

Crops the Altimetry between given range values and returns a new heap-allocated object. The new object will have range values in [range_start, range_end)

Parameters

time_start	start range value [m]
time_end	end range value [m]

Returns: a new Altimetry object

References Altimetry(), altimetry_map, create(), createNotValid(), debug, isValid(), and range_precision.

Here is the call graph for this function:

◆ empty()

bool woss::Altimetry::empty ( ) const

inline

Checks if the instance has stored values

Returns: true if condition applies, false otherwise

References altimetry_map.

◆ end()

AltCIt woss::Altimetry::end ( ) const

inline

Returns a const iterator to the end of the altimetry map

Returns: const iterator

References altimetry_map.

◆ eraseValue()

Altimetry & woss::Altimetry::eraseValue ( double range )

inline

Erase the altimetry value with key == range parameter

Parameters

range range value [s]

Returns: reference to *this

References altimetry_map, and range.

◆ findValue()

AltCIt woss::Altimetry::findValue ( double range ) const

inline

Returns a const iterator to the altimetry with key == range parameter

Parameters

range range value [m]

Returns: const iterator to end() if range is not found

References altimetry_map, and range.

◆ getDebug()

static bool woss::Altimetry::getDebug ( bool flag )

inlinestatic

Gets debug flag for all instances

Returns: flag debug

References debug.

◆ getDepth()

double woss::Altimetry::getDepth ( ) const

inline

Returns the scenario depth

Returns: depth [m]

References depth.

◆ getEvolutionTimeQuantum()

double woss::Altimetry::getEvolutionTimeQuantum ( ) const

inline

Returns the evolution time quantum

Returns: time quantum [s]

References evolution_time_quantum.

◆ getMaxAltimetryValue()

double woss::Altimetry::getMaxAltimetryValue ( ) const

inline

Returns the maximum altimetry value

Returns: maximum altimetry [m]

References max_altimetry_value.

Referenced by woss::ACToolboxWoss::initAltimetry().

◆ getMaxRangeValue()

double woss::Altimetry::getMaxRangeValue ( ) const

inline

Returns the maximum range value

Returns: maximum range [m]

References altimetry_map.

◆ getMinAltimetryValue()

double woss::Altimetry::getMinAltimetryValue ( ) const

inline

Returns the minimum altimetry value

Returns: minimum altimetry [m]

References min_altimetry_value.

Referenced by woss::ACToolboxWoss::initAltimetry().

◆ getMinRangeValue()

double woss::Altimetry::getMinRangeValue ( ) const

inline

Returns the maximum range value

Returns: maximum range [m]

References altimetry_map.

◆ getRange()

double woss::Altimetry::getRange ( ) const

inline

Returns the max range [m]

Returns: max range [m]

References range.

Referenced by woss::ACToolboxWoss::initAltimetry().

◆ getRangePrecision()

long double woss::Altimetry::getRangePrecision ( ) const

inline

Returns the range precision

Returns: range precision [m]

References range_precision.

◆ getTotalRangeSteps()

int woss::Altimetry::getTotalRangeSteps ( ) const

inline

Returns the total range step

Returns: range steps

References total_range_steps.

Referenced by woss::ACToolboxWoss::initAltimetry().

◆ initialize()

bool Altimetry::initialize ( )

virtual

Initializes the altimetry vector. used if there is a matematical function that generates the whole vector.

Returns: true succeeded false otherwise

Reimplemented in woss::AltimBretschneider.

References isValid(), range, range_precision, and total_range_steps.

Referenced by woss::ACToolboxWoss::initAltimetry().

Here is the call graph for this function:

◆ insertValue()

Altimetry & Altimetry::insertValue	(	double	range,
		double	altimetry
	)

Inserts and replace an altimetry value at closest range step

Parameters

range	range value [m]
altimetry	altimetry value [m]; > 0 ==> under water; < 0 ==> above water

Returns: reference to *this

References altimetry_map, max_altimetry_value, min_altimetry_value, and range.

◆ isValid()

bool Altimetry::isValid ( ) const

virtual

Checks the validity of Altimetry

Returns: true if it has at least one value, false otherwise

Reimplemented in woss::AltimBretschneider.

References altimetry_map.

Referenced by crop(), woss::WossDbManager::getAltimetry(), woss::ACToolboxWoss::initAltimetry(), initialize(), randomize(), woss::BellhopWoss::timeEvolve(), and woss::BellhopWoss::writeNormalizedSSP().

◆ operator=()

Altimetry & Altimetry::operator= ( const Altimetry & copy )

Assignment operator

Parameters

copy	const reference to a Altimetry object to be copied

Returns: Altimetry reference to this

References altimetry_map, depth, evolution_time_quantum, last_evolution_time, max_altimetry_value, min_altimetry_value, range, range_precision, and total_range_steps.

Referenced by woss::AltimBretschneider::operator=().

◆ randomize()

Altimetry * Altimetry::randomize ( double ratio_incr_value ) const

virtual

Performs a random perturbation of altimetry values with given ratio

Parameters

ratio_incr_value perturbation ratio

Returns: a new Altimetry object

Reimplemented in woss::AltimBretschneider.

References Altimetry(), altimetry_map, createNotValid(), woss::Singleton< T >::instance(), and isValid().

Referenced by timeEvolve().

Here is the call graph for this function:

◆ setDebug()

static void woss::Altimetry::setDebug ( bool flag )

inlinestatic

Sets debug flag for all instances

Parameters

flag	debug bool

References debug.

◆ setDepth()

Altimetry & woss::Altimetry::setDepth ( double d )

inline

Sets the depth

Parameters

d	scenario depth [m]

References depth.

Referenced by woss::ACToolboxWoss::initAltimetry().

◆ setEvolutionTimeQuantum()

Altimetry & woss::Altimetry::setEvolutionTimeQuantum ( double quantum )

inline

Sets the evolution time quantum

Parameters

quantum time quantum [s]

References evolution_time_quantum.

◆ setRange()

Altimetry & woss::Altimetry::setRange ( double r )

inline

Sets the range

Parameters

r	max range [m]

References range.

Referenced by woss::ACToolboxWoss::initAltimetry().

◆ setTotalRangeSteps()

Altimetry & woss::Altimetry::setTotalRangeSteps ( int r_s )

inline

Sets the total range step

Parameters

r_s	range steps

References total_range_steps.

Referenced by woss::ACToolboxWoss::initAltimetry().

◆ size()

int woss::Altimetry::size ( ) const

inline

Returns the number of altimetry values stored

Returns: number of altimetry values stored

References altimetry_map.

◆ sumValue()

Altimetry & woss::Altimetry::sumValue	(	double	range,
		double	altimetry
	)

inline

Inserts and sums an altimetry value at closest range step

Parameters

range	range value [m]
altimetry	altimetry value [m]; > 0 ==> under water; < 0 ==> above water

References altimetry_map, max_altimetry_value, min_altimetry_value, and range.

◆ timeEvolve()

Altimetry * Altimetry::timeEvolve ( const Time & time_value )

virtual

Performs a time evoulion

Parameters

time_value const reference to a valid Time object

Returns: a pointer to a new heap allocated Altimetry object

Reimplemented in woss::AltimBretschneider.

References clone(), debug, evolution_time_quantum, woss::Time::isValid(), last_evolution_time, and randomize().

Referenced by woss::BellhopWoss::timeEvolve().

Here is the call graph for this function:

Friends And Related Function Documentation

◆ operator!=

bool operator!=	(	const Altimetry &	left,
		const Altimetry &	right
	)

friend

Inequality operator

Parameters

left	left operand const reference
right	right operand const reference

Returns: true if left != right, false otherwise

◆ operator* [1/2]

const Altimetry operator*	(	const Altimetry &	left,
		const double	right
	)

friend

Multiplication operator

Parameters

left	left operand const reference
right	right operand const reference

Returns: a new const instance holding the operation result

◆ operator* [2/2]

const Altimetry operator*	(	const double	left,
		const Altimetry &	right
	)

friend

Multiplication operator

Parameters

left	left operand const reference
right	right operand const reference

Returns: a new const instance holding the operation result

◆ operator*=

Altimetry & operator*=	(	Altimetry &	left,
		double	right
	)

friend

Compound assignment multiplication operator

Parameters

left	left operand reference
right	right operand const reference

Returns: left reference after the operation

◆ operator+ [1/3]

const Altimetry operator+	(	const Altimetry &	left,
		const Altimetry &	right
	)

friend

Sum operator

Parameters

left	left operand const reference
right	right operand const reference

Returns: a new const instance holding the operation result

◆ operator+ [2/3]

const Altimetry operator+	(	const Altimetry &	left,
		const double	right
	)

friend

Sum operator

Parameters

left	left operand const reference
right	right operand const reference

Returns: a new const instance holding the operation result

◆ operator+ [3/3]

const Altimetry operator+	(	const double	left,
		const Altimetry &	right
	)

friend

Sum operator

Parameters

left	left operand const reference
right	right operand const reference

Returns: a new const instance holding the operation result

◆ operator+= [1/2]

Altimetry & operator+=	(	Altimetry &	left,
		const Altimetry &	right
	)

friend

Compound assignment sum operator

Parameters

left	left operand reference
right	right operand const reference

Returns: left reference after the operation

◆ operator+= [2/2]

Altimetry & operator+=	(	Altimetry &	left,
		double	right
	)

friend

Compound assignment sum operator

Parameters

left	left operand reference
right	right operand const reference

Returns: left reference after the operation

◆ operator- [1/3]

const Altimetry operator-	(	const Altimetry &	left,
		const Altimetry &	right
	)

friend

Subtraction operator

Parameters

left	left operand const reference
right	right operand const reference

Returns: a new const instance holding the operation result

◆ operator- [2/3]

const Altimetry operator-	(	const Altimetry &	left,
		const double	right
	)

friend

Subtraction operator

Parameters

left	left operand const reference
right	right operand const reference

Returns: a new const instance holding the operation result

◆ operator- [3/3]

const Altimetry operator-	(	const double	left,
		const Altimetry &	right
	)

friend

Subtraction operator

Parameters

left	left operand const reference
right	right operand const reference

Returns: a new const instance holding the operation result

◆ operator-= [1/2]

Altimetry & operator-=	(	Altimetry &	left,
		const Altimetry &	right
	)

friend

Compound assignment subtraction operator

Parameters

left	left operand reference
right	right operand const reference

Returns: left reference after the operation

◆ operator-= [2/2]

Altimetry & operator-=	(	Altimetry &	left,
		double	right
	)

friend

Compound assignment subtraction operator

Parameters

left	left operand reference
right	right operand const reference

Returns: left reference after the operation

◆ operator/ [1/2]

const Altimetry operator/	(	const Altimetry &	left,
		const double	right
	)

friend

Division operator

Parameters

left	left operand const reference
right	right operand const reference

Returns: a new const instance holding the operation result

◆ operator/ [2/2]

const Altimetry operator/	(	const double	left,
		const Altimetry &	right
	)

friend

Division operator

Parameters

left	left operand const reference
right	right operand const reference

Returns: a new const instance holding the operation result

◆ operator/=

Altimetry & operator/=	(	Altimetry &	left,
		double	right
	)

friend

Compound assignment division operator

Parameters

left	left operand reference
right	right operand const reference

Returns: left reference after the operation

◆ operator<<

std::ostream & operator<<	(	std::ostream &	os,
		const Altimetry &	instance
	)

friend

<< operator

Parameters

os	left operand ostream reference
instance	right operand const Pressure reference

Returns: os reference after the operation

◆ operator==

bool operator==	(	const Altimetry &	left,
		const Altimetry &	right
	)

friend

Equality operator

Parameters

left	left operand const reference
right	right operand const reference

Returns: true if left == right, false otherwise

Member Data Documentation

◆ altimetry_map

AltimetryMap woss::Altimetry::altimetry_map

protected

altimetry values map

Referenced by Altimetry(), at(), begin(), clear(), createFlat(), createNotValid(), crop(), empty(), end(), eraseValue(), findValue(), getMaxRangeValue(), getMinRangeValue(), insertValue(), isValid(), woss::operator*=(), woss::operator+=(), woss::operator-=(), woss::operator/=(), operator=(), randomize(), size(), and sumValue().

◆ debug

bool Altimetry::debug = false

staticprotected

Debug flag

Referenced by crop(), getDebug(), woss::AltimBretschneider::isValid(), woss::AltimBretschneider::randomize(), setDebug(), timeEvolve(), and woss::AltimBretschneider::timeEvolve().

◆ depth

double woss::Altimetry::depth

protected

Stores the depth of the scenario [m]

Referenced by woss::AltimBretschneider::AltimBretschneider(), woss::AltimBretschneider::create(), getDepth(), operator=(), and setDepth().

◆ evolution_time_quantum

double woss::Altimetry::evolution_time_quantum

protected

Stores the last evolution time quantum [s]

Referenced by getEvolutionTimeQuantum(), operator=(), setEvolutionTimeQuantum(), timeEvolve(), and woss::AltimBretschneider::timeEvolve().

◆ last_evolution_time

Time woss::Altimetry::last_evolution_time

protected

Stores the last evolution's simulation time

Referenced by operator=(), timeEvolve(), and woss::AltimBretschneider::timeEvolve().

◆ max_altimetry_value

double woss::Altimetry::max_altimetry_value

protected

Stores the maximum altimetry value [m] i.e. the min negative value (if present)

Referenced by Altimetry(), getMaxAltimetryValue(), insertValue(), operator=(), and sumValue().

◆ min_altimetry_value

double woss::Altimetry::min_altimetry_value

protected

Stores the miminum altimetry value [m] i.e. the maximum positive value (if present)

Referenced by Altimetry(), getMinAltimetryValue(), insertValue(), operator=(), and sumValue().

◆ range

double woss::Altimetry::range

protected

range [m]

Referenced by Altimetry(), eraseValue(), findValue(), getRange(), initialize(), woss::AltimBretschneider::initialize(), insertValue(), operator=(), setRange(), and sumValue().

◆ range_precision

long double woss::Altimetry::range_precision

protected

Stores the precision of all PDouble ranges [m]

Referenced by Altimetry(), crop(), getRangePrecision(), initialize(), woss::AltimBretschneider::initialize(), and operator=().

◆ total_range_steps

int woss::Altimetry::total_range_steps

protected

range total steps

Referenced by woss::AltimBretschneider::AltimBretschneider(), woss::AltimBretschneider::create(), getTotalRangeSteps(), initialize(), woss::AltimBretschneider::initialize(), woss::AltimBretschneider::isValid(), operator=(), and setTotalRangeSteps().

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

woss/woss_def/altimetry-definitions.h
woss/woss_def/altimetry-definitions.cpp

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ Altimetry() [1/4]

◆ Altimetry() [2/4]

◆ Altimetry() [3/4]

◆ Altimetry() [4/4]

Member Function Documentation

◆ at()

◆ begin()

◆ clear()

◆ clone()

◆ create() [1/3]

◆ create() [2/3]

◆ create() [3/3]

◆ createFlat()

◆ createNotValid()

◆ crop()

◆ empty()

◆ end()

◆ eraseValue()

◆ findValue()

◆ getDebug()

◆ getDepth()

◆ getEvolutionTimeQuantum()

◆ getMaxAltimetryValue()

◆ getMaxRangeValue()

◆ getMinAltimetryValue()

◆ getMinRangeValue()

◆ getRange()

◆ getRangePrecision()

◆ getTotalRangeSteps()

◆ initialize()

◆ insertValue()

◆ isValid()

◆ operator=()

◆ randomize()

◆ setDebug()

◆ setDepth()

◆ setEvolutionTimeQuantum()

◆ setRange()

◆ setTotalRangeSteps()

◆ size()

◆ sumValue()

◆ timeEvolve()

Friends And Related Function Documentation

◆ operator!=

◆ operator* [1/2]

◆ operator* [2/2]

◆ operator*=

◆ operator+ [1/3]

◆ operator+ [2/3]

◆ operator+ [3/3]

◆ operator+= [1/2]

◆ operator+= [2/2]

◆ operator- [1/3]

◆ operator- [2/3]

◆ operator- [3/3]

◆ operator-= [1/2]

◆ operator-= [2/2]

◆ operator/ [1/2]

◆ operator/ [2/2]

◆ operator/=

◆ operator<<

◆ operator==

Member Data Documentation

◆ altimetry_map

◆ debug

◆ depth

◆ evolution_time_quantum

◆ last_evolution_time

◆ max_altimetry_value

◆ min_altimetry_value

◆ range

◆ range_precision