Proxy class for an abstract representation. More...

#include <AbstractRepresentation.h>

Inheritance diagram for resqml2::AbstractRepresentation:

Public Member Functions
virtual	~AbstractRepresentation ()=default

eml2::AbstractLocal3dCrs *	getLocalCrs (uint64_t patchIndex) const

virtual common::DataObjectReference	getLocalCrsDor (uint64_t patchIndex) const

virtual common::DataObjectReference	getHdfProxyDor () const =0
	Gets the data object reference of the HDF proxy which is used for storing the numerical values of this representation (i.e. its geometry).

void	setTimeIndex (uint64_t timeIndex, eml2::TimeSeries *timeSeries)

uint64_t	getTimeIndex () const
	Gets the time index of this representation in the associated TimeSeries. Be sure to first check that a TimeSeries is associated this representation by calling getTimeSeriesDor or getTimeSeries;.

eml2::TimeSeries *	getTimeSeries () const

common::DataObjectReference	getTimeSeriesDor () const
	Gets the data object reference of the TimeSeries containing the time of this representation at a particular index. For now, this method only look for a TimeSeries at the first patch containing a point geometry.

std::vector< class AbstractProperty * >	getPropertySet () const

void	setInterpretation (class AbstractFeatureInterpretation *interp)

class AbstractFeatureInterpretation *	getInterpretation () const

common::DataObjectReference	getInterpretationDor () const

virtual uint64_t	getXyzPointCountOfPatch (unsigned int patchIndex) const =0

uint64_t	getXyzPointCountOfAllPatches () const

virtual void	getXyzPointsOfPatch (unsigned int patchIndex, double *xyzPoints) const =0
	Gets all the xyz points of a particular patch of this representation. xyz points are given in the local CRS.

void	getXyzPointsOfPatchInGlobalCrs (unsigned int patchIndex, double *xyzPoints) const
	Gets all the xyz points of a particular patch of this representation. xyz points are given in the global CRS.

void	getXyzPointsOfAllPatches (double *xyzPoints) const
	Gets all the xyz points of all patches of this representation. xyz points are given in the local CRS.

bool	isInSingleLocalCrs () const

bool	isInSingleGlobalCrs () const

void	getXyzPointsOfAllPatchesInGlobalCrs (double *xyzPoints) const

AbstractRepresentation *	getSeismicSupportOfPatch (const unsigned int &patchIndex) const

std::set< AbstractRepresentation * >	getAllSeismicSupport () const

virtual uint64_t	getPatchCount () const =0

void	pushBackIntoRepresentationSet (class RepresentationSetRepresentation *repSet)

void	addSeismic3dCoordinatesToPatch (unsigned int patchIndex, double inlines, double crosslines, uint64_t pointCount, resqml2::AbstractRepresentation seismicSupport, eml2::AbstractHdfProxy proxy)

void	addSeismic3dCoordinatesToPatch (unsigned int patchIndex, double startInline, double incrInline, unsigned int countInline, double startCrossline, double incrCrossline, unsigned int countCrossline, resqml2::AbstractRepresentation *seismicSupport)

void	addSeismic2dCoordinatesToPatch (unsigned int patchIndex, double lineAbscissa, resqml2::AbstractRepresentation seismicSupport, eml2::AbstractHdfProxy *proxy)

void	getSeismicLineAbscissaOfPointsOfPatch (unsigned int patchIndex, double *values) const

void	getInlinesOfPointsOfPatch (unsigned int patchIndex, double *values) const

void	getCrosslinesOfPointsOfPatch (unsigned int patchIndex, double *values) const

virtual void	loadTargetRelationships () override

Public Member Functions inherited from common::AbstractObject
bool	isPartial () const

virtual bool	isTopLevelElement () const

std::string	getUuid () const

std::string	getTitle () const

std::string	getEditor () const

time_t	getCreation () const

tm	getCreationAsTimeStructure () const

std::string	getOriginator () const

std::string	getDescription () const

time_t	getLastUpdate () const

tm	getLastUpdateAsTimeStructure () const

std::string	getFormat () const

std::string	getDescriptiveKeywords () const

std::string	getVersion () const

void	setTitle (const std::string &title)

void	setEditor (const std::string &editor)

void	setCreation (time_t creation)

void	setCreation (const tm &creation)

void	setOriginator (const std::string &originator)

void	setDescription (const std::string &description)

void	setLastUpdate (time_t lastUpdate)

void	setLastUpdate (const tm &lastUpdate)

void	setDescriptiveKeywords (const std::string &descriptiveKeywords)

void	setVersion (const std::string &version)

void	setMetadata (const std::string &title, const std::string &editor, time_t creation, const std::string &originator, const std::string &description, time_t lastUpdate, const std::string &descriptiveKeywords)

void	serializeIntoStream (std::ostream *stream)

gsoap_resqml2_0_1::eml20__AbstractCitedDataObject *	getEml20GsoapProxy () const

void	setGsoapProxy (gsoap_resqml2_0_1::eml20__AbstractCitedDataObject *gsoapProxy)

gsoap_eml2_3::eml23__AbstractObject *	getEml23GsoapProxy () const

void	setGsoapProxy (gsoap_eml2_3::eml23__AbstractObject *gsoapProxy)

soap *	getGsoapContext () const

int	getGsoapType () const

gsoap_resqml2_0_1::eml20__DataObjectReference *	newResqmlReference () const

gsoap_eml2_3::eml23__DataObjectReference *	newEml23Reference () const

gsoap_resqml2_0_1::resqml20__ContactElementReference *	newContactElementReference2_0_1 () const

gsoap_eml2_3::resqml22__ContactElement *	newContactElementReference2_2 () const

common::DataObjectRepository *	getRepository () const

virtual std::string	getXmlNamespace () const =0

virtual std::string	getXmlTag () const =0

virtual std::string	getXmlNamespaceVersion () const

virtual std::string	getContentType () const

virtual std::string	getQualifiedType () const

virtual std::string	getPartNameInEpcDocument () const

std::string	serializeIntoString ()

void	addAlias (const std::string &authority, const std::string &title)

uint64_t	getAliasCount () const

std::string	getAliasAuthorityAtIndex (uint64_t index) const

std::string	getAliasTitleAtIndex (uint64_t index) const

std::vector< eml2::Activity * >	getActivitySet () const

uint64_t	getActivityCount () const

eml2::Activity *	getActivity (uint64_t index) const

void	pushBackExtraMetadata (const std::string &key, const std::string &value)

std::unordered_map< std::string, std::string >	getExtraMetadataSet () const

std::vector< std::string >	getExtraMetadata (const std::string &key) const

unsigned int	getExtraMetadataCount () const

std::string	getExtraMetadataKeyAtIndex (unsigned int index) const

std::string	getExtraMetadataStringValueAtIndex (unsigned int index) const

std::string	buildEtp12Uri () const

void	setUriSource (const std::string &uriSource)

const std::string &	getUriSource () const

std::string	getEpcSourceFolder () const

void	changeToPartialObject ()

Static Public Attributes
static constexpr char const *	XML_TAG = "AbstractRepresentation"

Additional Inherited Members
Public Types inherited from common::AbstractObject
enum class	numericalDatatypeEnum { UNKNOWN = 0 , DOUBLE = 1 , FLOAT = 2 , INT64 = 3 , UINT64 = 4 , INT32 = 5 , UINT32 = 6 , INT16 = 7 , UINT16 = 8 , INT8 = 9 , UINT8 = 10 }

Static Public Member Functions inherited from common::AbstractObject
static void	setFormat (const std::string &vendor, const std::string &applicationName, const std::string &applicationVersionNumber)

Detailed Description

Proxy class for an abstract representation.

Constructor & Destructor Documentation

◆ ~AbstractRepresentation()

virtual resqml2::AbstractRepresentation::~AbstractRepresentation ( )

virtualdefault

Destructor does nothing since the memory is managed by the gSOAP context.

Member Function Documentation

◆ addSeismic2dCoordinatesToPatch()

void resqml2::AbstractRepresentation::addSeismic2dCoordinatesToPatch	(	unsigned int	patchIndex,
		double *	lineAbscissa,
		resqml2::AbstractRepresentation *	seismicSupport,
		eml2::AbstractHdfProxy *	proxy )

Adds seismic 2d coordinates to an existing point geometry patch.

Exceptions

std::out_of_range	If `patchIndex` is out of range.
std::invalid_argument	If `patchIndex` does not identify a point geometry patch.
std::invalid_argument	If there already exists some seismic 3d coordinates for the geometry patch at position `patchIndex`.

Parameters

	patchIndex	The index of the geometry patch which receives the seismic coordinates.
[in,out]	lineAbscissa	The abscissa of each points of the patch on the seismic line. The count of this array must be equal to `getXyzPointCountOfPatch(patchIndex)`.
[in,out]	seismicSupport	The representation of the seismic line.
[in,out]	proxy	The HDF proxy where to write the `lineAbscissa` values. It must be already opened for writing and won't be closed in this method.

◆ addSeismic3dCoordinatesToPatch() [1/2]

void resqml2::AbstractRepresentation::addSeismic3dCoordinatesToPatch	(	unsigned int	patchIndex,
		double *	inlines,
		double *	crosslines,
		uint64_t	pointCount,
		resqml2::AbstractRepresentation *	seismicSupport,
		eml2::AbstractHdfProxy *	proxy )

Adds seismic 3d coordinates to an existing point geometry patch.

Exceptions

std::out_of_range	If `patchIndex` is out of range.
std::invalid_argument	If `patchIndex` does not identify a point geometry patch.
std::invalid_argument	If there already exists some seismic 2d coordinates for the geometry patch at position `patchIndex`.

Parameters

	patchIndex	The index of the geometry patch which receives the seismic coordinates.
[in]	inlines	The sequence of trace or inter-trace inline positions that correspond to the geometry coordinates. It must be in the same order than `crosslines`.
[in]	crosslines	The sequence of trace or inter-trace crossline positions that correspond to the geometry coordinates. It must be in the same order than `inlines`.
	pointCount	Number of points. It is the size of both `inlines` and `crosslines`.
[in]	seismicSupport	The representation of the seismic line.
[in,out]	proxy	The HDF proxy where to write the `inlines` and `crosslines` values. It must be already opened for writing and won't be closed in this method.

◆ addSeismic3dCoordinatesToPatch() [2/2]

void resqml2::AbstractRepresentation::addSeismic3dCoordinatesToPatch	(	unsigned int	patchIndex,
		double	startInline,
		double	incrInline,
		unsigned int	countInline,
		double	startCrossline,
		double	incrCrossline,
		unsigned int	countCrossline,
		resqml2::AbstractRepresentation *	seismicSupport )

Adds seismic 3d coordinates to an existing point geometry patch.

Exceptions

std::out_of_range	If `patchIndex` is out of range.
std::invalid_argument	If `patchIndex` does not identify a point geometry patch.
std::invalid_argument	If there already exists some seismic 2d coordinates for the geometry patch at position `patchIndex`.

Parameters

	patchIndex	The index of the geometry patch which receives the seismic coordinates.
	startInline	The first inline.
	incrInline	The inline increment.
	countInline	The inline count.
	startCrossline	The first crossline.
	incrCrossline	The crossline increment.
	countCrossline	The crossline count.
[in]	seismicSupport	The representation of the seismic line.

◆ getAllSeismicSupport()

std::set< AbstractRepresentation * > resqml2::AbstractRepresentation::getAllSeismicSupport ( ) const

Gets all seismic supports of the current geometry of this representation (that is to say the seismic supports of all the patches). This method does not return the seismic lattice representations which are support of 2d grid representation.

Returns: A vector of pointers to all the seismic supports associated to this representation.

◆ getCrosslinesOfPointsOfPatch()

void resqml2::AbstractRepresentation::getCrosslinesOfPointsOfPatch	(	unsigned int	patchIndex,
		double *	values ) const

Gets all the crossline coordinates of the points of a specific patch related to seismic lattice.

Exceptions

std::out_of_range	If `patchIndex` is out of range.
std::invalid_argument	If the patch at position `patchIndex` has no seismic information.

Parameters

	patchIndex	The index of the geometry patch which stores the seismic coordinates.
[out]	values	The array where the crossline coordinates are going to be stored. The count of this array must be equal to `getXyzPointCountOfPatch(patchIndex)`.

◆ getHdfProxyDor()

virtual common::DataObjectReference resqml2::AbstractRepresentation::getHdfProxyDor ( ) const

pure virtual

Gets the data object reference of the HDF proxy which is used for storing the numerical values of this representation (i.e. its geometry).

Exceptions

std::logic_error If this representation is partial.

Returns: The data object reference of the HDF proxy used for storing the geometry, or empty data object reference if it fails.

◆ getInlinesOfPointsOfPatch()

void resqml2::AbstractRepresentation::getInlinesOfPointsOfPatch	(	unsigned int	patchIndex,
		double *	values ) const

Gets all the inline coordinates of the points of a specific patch related to seismic lattice.

Exceptions

std::out_of_range	If `patchIndex` is out of range.
std::invalid_argument	If the patch at position `patchIndex` has no seismic information.

Parameters

	patchIndex	The index of the geometry patch which stores the seismic coordinates.
[out]	values	The array where the inlines coordinates are going to be stored. The count of this array must be equal to `getXyzPointCountOfPatch(patchIndex)`.

◆ getInterpretation()

class AbstractFeatureInterpretation * resqml2::AbstractRepresentation::getInterpretation ( ) const

Gets the interpretation associated to this representation.

Returns: Null pointer if no interpretation is associated to this representation. Otherwise the associated interpretation.

◆ getInterpretationDor()

common::DataObjectReference resqml2::AbstractRepresentation::getInterpretationDor ( ) const

Gets the data object reference of the interpretation associated to this representation.

Returns: Empty data object reference if no interpretation is associated to this representation. Otherwise the data object reference of the associated interpretation.

◆ getLocalCrs()

eml2::AbstractLocal3dCrs * resqml2::AbstractRepresentation::getLocalCrs ( uint64_t patchIndex ) const

Gets the local 3d CRS associated to a given patch of this representation in read and write access.

Exceptions

std::out_of_range If patchIndex is out of range.

Parameters

patchIndex Zero-based index of the patch for which we look for the local CRS.

Returns: Null if it fails, else the local CRS associated to the patchIndex patch.

◆ getLocalCrsDor()

virtual common::DataObjectReference resqml2::AbstractRepresentation::getLocalCrsDor ( uint64_t patchIndex ) const

virtual

Gets the data object reference of the local 3d CRS associated to a given patch of this representation. This local CRS is where the point ordinals are given.

Exceptions

std::out_of_range If patchIndex is out of range.

Parameters

patchIndex Zero-based index of the patch for which we look for the local CRS.

Returns: Empty data object reference if it fails, else the data object reference of the local CRS associated to the patchIndex patch.

Reimplemented in resqml2::WellboreFrameRepresentation, resqml2::WellboreTrajectoryRepresentation, resqml2_0_1::PlaneSetRepresentation, resqml2_0_1::WellboreTrajectoryRepresentation, resqml2_2::PlaneSetRepresentation, and resqml2_2::WellboreTrajectoryRepresentation.

◆ getPatchCount()

virtual uint64_t resqml2::AbstractRepresentation::getPatchCount ( ) const

pure virtual

Gets the patch count.

Returns: The patch count.

◆ getPropertySet()

std::vector< class AbstractProperty * > resqml2::AbstractRepresentation::getPropertySet ( ) const

Gets all the properties which use this representation as support.

Returns: A vector of pointers on all the properties which use this representation as support.

◆ getSeismicLineAbscissaOfPointsOfPatch()

void resqml2::AbstractRepresentation::getSeismicLineAbscissaOfPointsOfPatch	(	unsigned int	patchIndex,
		double *	values ) const

Gets all the abscissa of the points of a specific patch related to 2d seismic line.

Exceptions

std::out_of_range	If `patchIndex` is out of range.
std::invalid_argument	If the patch at position `patchIndex` has no seismic information.

Parameters

	patchIndex	The index of the geometry patch which stores the seismic coordinates.
[out]	values	The array where the abscissa are going to be stored. The count of this array must be equal to `getXyzPointCountOfPatch(patchIndex)`.

◆ getSeismicSupportOfPatch()

AbstractRepresentation * resqml2::AbstractRepresentation::getSeismicSupportOfPatch ( const unsigned int & patchIndex ) const

Gets the seismic support of a specific patch of this representation.

Exceptions

std::out_of_range If patchIndex is out of the patch count range.

Parameters

patchIndex Zero-based index of the patch from which we look for the seismic support.

Returns: Null if no seismic information have been provided for the patch at position patchIndex. Else, its seismic support.

◆ getTimeIndex()

uint64_t resqml2::AbstractRepresentation::getTimeIndex ( ) const

Gets the time index of this representation in the associated TimeSeries. Be sure to first check that a TimeSeries is associated this representation by calling getTimeSeriesDor or getTimeSeries;.

Exceptions

std::logic_error If this representation is partial. Or if the representation is not associated to any TimeSeries.

Returns: The time index of this representation in the associated TimeSeries.

◆ getTimeSeries()

eml2::TimeSeries * resqml2::AbstractRepresentation::getTimeSeries ( ) const

Gets the TimeSeries associated to this representation.

Returns: Null if it fails, else the TimeSeries associated to this representation.

◆ getTimeSeriesDor()

common::DataObjectReference resqml2::AbstractRepresentation::getTimeSeriesDor ( ) const

Gets the data object reference of the TimeSeries containing the time of this representation at a particular index. For now, this method only look for a TimeSeries at the first patch containing a point geometry.

Exceptions

std::logic_error If this representation is partial.

Returns: The data object reference of the TimeSeries, or empty data object reference there is not TimeSeries found.

◆ getXyzPointCountOfAllPatches()

uint64_t resqml2::AbstractRepresentation::getXyzPointCountOfAllPatches ( ) const

Get the xyz point count of all patches of this representation.

Returns: The xyz point count of all patches.

◆ getXyzPointCountOfPatch()

virtual uint64_t resqml2::AbstractRepresentation::getXyzPointCountOfPatch ( unsigned int patchIndex ) const

pure virtual

Get the xyz point count in a given patch of this representation.

Exceptions

std::out_of_range	If `patchIndex` is out of range.
std::logic_error	If this representation is partial.

Parameters

patchIndex Zero-based index of the patch from which we look for the xyz points.

Returns: The xyz point count of the patch at position patchIndex.

◆ getXyzPointsOfAllPatches()

void resqml2::AbstractRepresentation::getXyzPointsOfAllPatches ( double * xyzPoints ) const

Gets all the xyz points of all patches of this representation. xyz points are given in the local CRS.

Parameters

[out] xyzPoints A linearized 2d array where the first (quickest) dimension is the coordinate dimension (x, y or z) and second dimension is vertex dimension. It must be preallocated with a size of 3 * getXyzPointCountOfAllPatches().

◆ getXyzPointsOfAllPatchesInGlobalCrs()

void resqml2::AbstractRepresentation::getXyzPointsOfAllPatchesInGlobalCrs ( double * xyzPoints ) const

Gets all the xyz points of all patches of this individual representation. xyz points are given in the global CRS.

Parameters

[out] xyzPoints A linearized 2d array where the first (quickest) dimension is the coordinate dimension (x, y or Z) and second dimension is vertex dimension. Thus, its size is 3*(3*[count of all xyz points]). It must be preallocated.

◆ getXyzPointsOfPatch()

virtual void resqml2::AbstractRepresentation::getXyzPointsOfPatch	(	unsigned int	patchIndex,
		double *	xyzPoints ) const

pure virtual

Gets all the xyz points of a particular patch of this representation. xyz points are given in the local CRS.

Exceptions

std::out_of_range	If `patchIndex` is out of range.
std::logic_error	If this representation is partial.

Parameters

	patchIndex	Zero-based index of the patch from which we look for the xyz points.
[out]	xyzPoints	A linearized 2d array where the first (quickest) dimension is the coordinate dimension (x, y or z) and second dimension is vertex dimension. It must be preallocated with a size of `3 * getXyzPointCountOfPatch(patchIndex)`.

◆ getXyzPointsOfPatchInGlobalCrs()

void resqml2::AbstractRepresentation::getXyzPointsOfPatchInGlobalCrs	(	unsigned int	patchIndex,
		double *	xyzPoints ) const

Gets all the xyz points of a particular patch of this representation. xyz points are given in the global CRS.

Exceptions

std::out_of_range If patchIndex is out of range.

Parameters

	patchIndex	Zero-based index of the patch from which we look for the xyz points.
[out]	xyzPoints	A linearized 2d array where the first (quickest) dimension is the coordinate dimension (x, y or z) and second dimension is vertex dimension. It must be preallocated with a size of `3 * getXyzPointCountOfPatch(patchIndex)`.

◆ isInSingleGlobalCrs()

bool resqml2::AbstractRepresentation::isInSingleGlobalCrs ( ) const

Checks if all of the patches (geometries) of this representation are defined in a same global CRS.

Returns: True if this representation is defined in a single global CRS, false if not.

◆ isInSingleLocalCrs()

bool resqml2::AbstractRepresentation::isInSingleLocalCrs ( ) const

Checks if all of the patches (geometries) of this representation are defined in a same local CRS.

Returns: True if this representation is defined in a single local CRS, false if not.

◆ loadTargetRelationships()

virtual void resqml2::AbstractRepresentation::loadTargetRelationships ( )

overridevirtual

Reads the forward relationships of this data object and update the .rels of the associated data repository.

Implements common::AbstractObject.

Reimplemented in resqml2::AbstractGridRepresentation, resqml2::RepresentationSetRepresentation, resqml2::StreamlinesRepresentation, resqml2::SubRepresentation, and resqml2_2::SeismicWellboreFrameRepresentation.

◆ pushBackIntoRepresentationSet()

void resqml2::AbstractRepresentation::pushBackIntoRepresentationSet ( class RepresentationSetRepresentation * repSet )

Pushes back this representation into a representation set representation.

Exceptions

std::invalid_argument If repSet is null.

Parameters

[in] repSet The representation set representation which will contain this representation.

◆ setInterpretation()

void resqml2::AbstractRepresentation::setInterpretation ( class AbstractFeatureInterpretation * interp )

Sets the interpretation which is associated to this representation.

Exceptions

std::invalid_argument If interp is null.

Parameters

[in] interp The interpretation to associate to this representation.

◆ setTimeIndex()

void resqml2::AbstractRepresentation::setTimeIndex	(	uint64_t	timeIndex,
		eml2::TimeSeries *	timeSeries )

Set a time index in a time series for all point geometries of all existing patches of this representation.

Parameters

timeIndex	The time index of the time to associate to this representation.
timeSeries	The time series containing the time of the representation at `timeIndex`.

Member Data Documentation

◆ XML_TAG

char const* resqml2::AbstractRepresentation::XML_TAG = "AbstractRepresentation"

staticconstexpr

The standard XML tag without XML namespace for serializing this data object

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

C:/Users/philippe/dev/fesapiEnv/fesapi-2.10.1.0/src/resqml2/AbstractRepresentation.h

Public Member Functions

Static Public Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ~AbstractRepresentation()

Member Function Documentation

◆ addSeismic2dCoordinatesToPatch()

◆ addSeismic3dCoordinatesToPatch() [1/2]

◆ addSeismic3dCoordinatesToPatch() [2/2]

◆ getAllSeismicSupport()

◆ getCrosslinesOfPointsOfPatch()

◆ getHdfProxyDor()

◆ getInlinesOfPointsOfPatch()

◆ getInterpretation()

◆ getInterpretationDor()

◆ getLocalCrs()

◆ getLocalCrsDor()

◆ getPatchCount()

◆ getPropertySet()

◆ getSeismicLineAbscissaOfPointsOfPatch()

◆ getSeismicSupportOfPatch()

◆ getTimeIndex()

◆ getTimeSeries()

◆ getTimeSeriesDor()

◆ getXyzPointCountOfAllPatches()

◆ getXyzPointCountOfPatch()

◆ getXyzPointsOfAllPatches()

◆ getXyzPointsOfAllPatchesInGlobalCrs()

◆ getXyzPointsOfPatch()

◆ getXyzPointsOfPatchInGlobalCrs()

◆ isInSingleGlobalCrs()

◆ isInSingleLocalCrs()

◆ loadTargetRelationships()

◆ pushBackIntoRepresentationSet()

◆ setInterpretation()

◆ setTimeIndex()

Member Data Documentation

◆ XML_TAG