Class for reading and manipulating results provided by any acoustic toolbox textual ARR file. More...

#include <ac-toolbox-arr-asc-reader.h>

Inheritance diagram for woss::ArrAscResReader:

Collaboration diagram for woss::ArrAscResReader:

Public Member Functions
	ArrAscResReader ()

	ArrAscResReader (const Woss *const woss)

virtual bool	initialize ()

virtual Pressure *	readAvgPressure (double frequency, double tx_depth, double start_rx_depth, double start_rx_range, double end_rx_depth, double end_rx_range)

virtual Pressure *	readPressure (double frequency, double tx_depth, double rx_depth, double rx_range) const

virtual TimeArr *	readTimeArr (double frequency, double tx_depth, double rx_depth, double rx_range) const

Public Member Functions inherited from woss::ResReader
	ResReader ()

	ResReader (const Woss *const woss)

ResReader &	setWossPtr (const Woss *const woss)

const Woss *const	getWossPtr ()

ResReader &	setFileName (const ::std::string &name)

::std::string	getFileName ()

Protected Member Functions
TimeArr *	accessMap (double frequency, double tx_depth, double rx_depth, double rx_range) const

::std::complex< double >	readMapAvgPressure (double frequency, double tx_depth, double start_rx_depth, double start_rx_range, double end_rx_depth, double end_rx_range)

bool	getArrAscHeader ()

bool	getArrAscFile ()

Protected Attributes
bool	arr_asc_header_collected

bool	arr_asc_file_collected

::std::ifstream	file_reader

::std::streampos	skip_header

ArrData	arr_file

double	last_tx_depth

double	last_start_rx_depth

double	last_start_rx_range

double	last_end_rx_depth

double	last_end_rx_range

::std::complex< double >	last_ret_value

Protected Attributes inherited from woss::ResReader
const Woss *	woss_ptr

::std::string	file_name

Detailed Description

Class for reading and manipulating results provided by any acoustic toolbox textual ARR file.

Class ArrAscResReader stores TimeArr provided by any acoustic toolbox textual ARR file in a ArrData. It also offers TimeArr manipulation and Pressure conversion methods.

Constructor & Destructor Documentation

◆ ArrAscResReader() [1/2]

ArrAscResReader::ArrAscResReader ( )

ArrAscResReader default constructor

◆ ArrAscResReader() [2/2]

ArrAscResReader::ArrAscResReader ( const Woss *const woss )

ArrAscResReader constructor

Parameters

woss	const pointer to a const Woss object

Member Function Documentation

◆ accessMap()

TimeArr * woss::ArrAscResReader::accessMap	(	double	frequency,
		double	tx_depth,
		double	rx_depth,
		double	rx_range
	)		const

inlineprotected

Gets the TimeArr value from ArrData TimeArr array associated to given parameters

Parameters

frequency	[hZ]
tx_depth	transmitter depth [m]
rx_depth	start receiver depth [m]
rx_range	start receiver range [m]

Returns: a valid TimeArr value; a not valid TimeArr if arr_file hasn't been read yet

References arr_file, woss::ArrData::arr_values, and woss::ArrData::getTimeArrIndex().

Referenced by readTimeArr().

Here is the call graph for this function:

◆ getArrAscFile()

bool ArrAscResReader::getArrAscFile ( )

protected

Process the ARR file data

Returns: true if method was successful, false otherwise

References arr_asc_file_collected, arr_asc_header_collected, arr_file, woss::ArrData::arr_values, woss::BELLHOP_CREATOR_ARR_FILE_SYNTAX_0, woss::BELLHOP_CREATOR_ARR_FILE_SYNTAX_1, woss::BELLHOP_CREATOR_ARR_FILE_SYNTAX_2, woss::ResReader::file_name, file_reader, woss::ArrData::frequency, woss::BellhopWoss::getBellhopArrSyntax(), woss::Pressure::getTxLossDb(), woss::Woss::getWossId(), woss::ArrData::Nrd, woss::ArrData::Nrr, woss::ArrData::Nsd, woss::ArrData::rx_depths, woss::ArrData::rx_ranges, skip_header, woss::TimeArr::sumValue(), woss::ArrData::tx_depths, woss::Woss::usingDebug(), and woss::ResReader::woss_ptr.

Referenced by initialize().

Here is the call graph for this function:

◆ getArrAscHeader()

bool ArrAscResReader::getArrAscHeader ( )

protected

Process the ARR file header

Returns: true if method was successful, false otherwise

References arr_asc_header_collected, arr_file, woss::ArrData::arr_values, woss::BELLHOP_CREATOR_ARR_FILE_SYNTAX_2, woss::TimeArr::createArray(), woss::ResReader::file_name, file_reader, woss::ArrData::frequency, woss::BellhopWoss::getBellhopArrSyntax(), woss::Woss::getWossId(), woss::Singleton< T >::instance(), woss::ArrData::Nrd, woss::ArrData::Nrr, woss::ArrData::Nsd, woss::ArrData::rx_depths, woss::ArrData::rx_ranges, skip_header, woss::ArrData::tx_depths, woss::Woss::usingDebug(), and woss::ResReader::woss_ptr.

Referenced by initialize().

Here is the call graph for this function:

◆ initialize()

bool ArrAscResReader::initialize ( )

virtual

Initializes the ArrAscResReader object, reads ARR file, and stores read TimeArr values

Returns: true if method was successful, false otherwise

Implements woss::ResReader.

References woss::ResReader::file_name, getArrAscFile(), getArrAscHeader(), and woss::ResReader::woss_ptr.

Here is the call graph for this function:

◆ readAvgPressure()

Pressure * ArrAscResReader::readAvgPressure	(	double	frequency,
		double	tx_depth,
		double	start_rx_depth,
		double	start_rx_range,
		double	end_rx_depth,
		double	end_rx_range
	)

virtual

Gets the average Pressure value in given rx range-depth box. Returned Pressure is the coherent sum of the computed average TimeArr

Parameters

frequency	frequency [hZ]
tx_depth	transmitter depth [m]
start_rx_depth	start receiver depth [m]
start_rx_range	start receiver range [m]
end_rx_depth	end receiver depth [m]
end_rx_range	end receiver range [m]

Returns: a valid Pressure value; a not valid Pressure if arr_file hasn't been read yet

Implements woss::ResReader.

References arr_asc_file_collected, woss::Pressure::create(), woss::Pressure::createNotValid(), woss::Singleton< T >::instance(), and readMapAvgPressure().

Here is the call graph for this function:

◆ readMapAvgPressure()

std::complex< double > ArrAscResReader::readMapAvgPressure	(	double	frequency,
		double	tx_depth,
		double	start_rx_depth,
		double	start_rx_range,
		double	end_rx_depth,
		double	end_rx_range
	)

protected

Gets the average Pressure value in given rx range-depth box converted from ArrData TimeArr array

Parameters

frequency	frequency [hZ]
tx_depth	transmitter depth [m]
start_rx_depth	start receiver depth [m]
start_rx_range	start receiver range [m]
end_rx_depth	end receiver depth [m]
end_rx_range	end receiver range [m]