Fesapi
2.0.0.0
This project provides C++ classes which allow an easy access in import and export to the Energistics standards.
|
Proxy class for a sub-representation. A sub representation is an ordered list of indexable elements and/or indexable element pairs of an existing representation. More...
#include <SubRepresentation.h>
Public Member Functions | |
virtual | ~SubRepresentation ()=default |
virtual indexableElement | getElementKindOfPatch (unsigned int patchIndex, unsigned int elementIndicesIndex) const =0 |
virtual uint64_t | getElementCountOfPatch (unsigned int patchIndex) const =0 |
virtual void | getElementIndicesOfPatch (unsigned int patchIndex, unsigned int elementIndicesIndex, uint64_t *elementIndices) const =0 |
virtual void | getSupportingRepresentationIndicesOfPatch (unsigned int patchIndex, short *supportingRepresentationIndices) const =0 |
Gets the indices of the supporting representations that refer the selected elements indices of a particular patch of this sub-representation. More... | |
virtual bool | areElementIndicesPairwise (unsigned int patchIndex) const =0 |
virtual bool | areElementIndicesBasedOnLattice (unsigned int patchIndex, unsigned int elementIndicesIndex=0) const =0 |
virtual int64_t | getLatticeElementIndicesStartValue (unsigned int patchIndex, unsigned int elementIndicesIndex=0) const =0 |
virtual unsigned int | getLatticeElementIndicesDimensionCount (unsigned int patchIndex, unsigned int elementIndicesIndex=0) const =0 |
virtual int64_t | getLatticeElementIndicesOffsetValue (unsigned int latticeDimensionIndex, unsigned int patchIndex, unsigned int elementIndicesIndex=0) const =0 |
virtual uint64_t | getLatticeElementIndicesOffsetCount (unsigned int latticeDimensionIndex, unsigned int patchIndex, unsigned int elementIndicesIndex=0) const =0 |
virtual void | pushBackSubRepresentationPatch (gsoap_eml2_3::resqml22__IndexableElement elementKind, uint64_t originIndex, unsigned int elementCountInSlowestDimension, unsigned int elementCountInMiddleDimension, unsigned int elementCountInFastestDimension)=0 |
void | pushBackSubRepresentationPatch (gsoap_eml2_3::resqml22__IndexableElement elementKind, uint64_t elementCount, uint64_t *elementIndices, eml2::AbstractHdfProxy *proxy, short *supportingRepIndices=nullptr) |
virtual void | pushBackSubRepresentationPatch (gsoap_eml2_3::resqml22__IndexableElement elementKind0, gsoap_eml2_3::resqml22__IndexableElement elementKind1, uint64_t elementCount, uint64_t *elementIndices0, uint64_t *elementIndices1, eml2::AbstractHdfProxy *proxy)=0 |
virtual void | pushBackRefToExistingDataset (gsoap_eml2_3::resqml22__IndexableElement elementKind, uint64_t elementCount, const std::string &elementDataset, int64_t nullValue, eml2::AbstractHdfProxy *proxy, const std::string &supportingRepDataset="")=0 |
uint64_t | getXyzPointCountOfPatch (unsigned int patchIndex) const override |
More... | |
void | getXyzPointsOfPatch (unsigned int patchIndex, double *xyzPoints) const override |
virtual unsigned int | getPatchCount () const override=0 |
void | pushBackSupportingRepresentation (AbstractRepresentation *supportingRep) |
virtual unsigned int | getSupportingRepresentationCount () const =0 |
AbstractRepresentation * | getSupportingRepresentation (unsigned int index) const |
virtual common::DataObjectReference | getSupportingRepresentationDor (unsigned int index) const =0 |
virtual std::string | getXmlTag () const final |
void | loadTargetRelationships () final |
Public Member Functions inherited from resqml2::AbstractRepresentation | |
virtual | ~AbstractRepresentation ()=default |
class AbstractLocal3dCrs * | getLocalCrs (unsigned int patchIndex) const |
virtual common::DataObjectReference | getLocalCrsDor (unsigned int 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). More... | |
std::vector< class AbstractProperty * > | getPropertySet () const |
void | setInterpretation (class AbstractFeatureInterpretation *interp) |
class AbstractFeatureInterpretation * | getInterpretation () const |
common::DataObjectReference | getInterpretationDor () const |
uint64_t | getXyzPointCountOfAllPatches () const |
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. More... | |
void | getXyzPointsOfAllPatches (double *xyzPoints) const |
Gets all the xyz points of all patches of this representation. xyz points are given in the local CRS. More... | |
bool | isInSingleLocalCrs () const |
bool | isInSingleGlobalCrs () const |
void | getXyzPointsOfAllPatchesInGlobalCrs (double *xyzPoints) const |
AbstractRepresentation * | getSeismicSupportOfPatch (const unsigned int &patchIndex) const |
std::set< AbstractRepresentation * > | getAllSeismicSupport () const |
void | pushBackIntoRepresentationSet (class RepresentationSetRepresentation *repSet) |
void | addSeismic3dCoordinatesToPatch (unsigned int patchIndex, double *inlines, double *crosslines, unsigned int 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 |
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) |
void | setGsoapProxy (gsoap_resqml2_0_1::eml20__AbstractCitedDataObject *gsoapProxy) |
void | setGsoapProxy (gsoap_eml2_1::eml21__AbstractObject *gsoapProxy) |
gsoap_resqml2_0_1::eml20__AbstractCitedDataObject * | getEml20GsoapProxy () const |
gsoap_eml2_1::eml21__AbstractObject * | getEml21GsoapProxy () const |
gsoap_eml2_2::eml22__AbstractObject * | getEml22GsoapProxy () const |
void | setGsoapProxy (gsoap_eml2_2::eml22__AbstractObject *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_1::eml21__DataObjectReference * | newEmlReference () const |
gsoap_eml2_2::eml22__DataObjectReference * | newEml22Reference () 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 | 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) |
unsigned int | getAliasCount () const |
std::string | getAliasAuthorityAtIndex (unsigned int index) const |
std::string | getAliasTitleAtIndex (unsigned int index) const |
std::vector< eml2::Activity * > | getActivitySet () const |
unsigned int | getActivityCount () const |
eml2::Activity * | getActivity (unsigned int 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 |
Static Public Attributes | |
static const char * | XML_TAG |
Static Public Attributes inherited from resqml2::AbstractRepresentation | |
static const char * | XML_TAG |
Additional Inherited Members | |
Public Types inherited from resqml2::AbstractRepresentation | |
enum | indexableElement { NODE = 0 , EDGE = 1 , FACE = 2 , VOLUME = 3 , PILLAR = 4 } |
Public Types inherited from common::AbstractObject | |
enum | hdfDatatypeEnum { UNKNOWN = 0 , DOUBLE = 1 , FLOAT = 2 , LONG_64 = 3 , ULONG_64 = 4 , INT = 5 , UINT = 6 , SHORT = 7 , USHORT = 8 , CHAR = 9 , UCHAR = 10 } |
Static Public Member Functions inherited from common::AbstractObject | |
static void | setFormat (const std::string &vendor, const std::string &applicationName, const std::string &applicationVersionNumber) |
Proxy class for a sub-representation. A sub representation is an ordered list of indexable elements and/or indexable element pairs of an existing representation.
Because the representation concepts of topology, geometry, and property values are separate in RESQML, it is now possible to select a range of nodes, edges, faces, or volumes (cells) indices from the topological support of an existing representation to define a sub-representation. A sub- representation may describe a different feature interpretation using the same geometry or property as the "parent" representation. In this case, the only information exchanged is a set of potentially non-consecutive indices of the topological support of the representation.
|
virtualdefault |
Destructor does nothing since the memory is managed by the gsoap context.
Reimplemented in resqml2_2::SubRepresentation, and resqml2_0_1::SubRepresentation.
|
pure virtual |
Checks if the element indices of a particular patch are based on a lattice or not.
std::out_of_range | If patchIndex is out of range. |
std::out_of_range | If elementIndicesIndex is out of range. Must be: 0 for non pairwise element indices; 0 or 1 for pairwise element indices (0 for the left and 1 for the right part of the pairs). |
patchIndex | Zero-based index of the patch. |
elementIndicesIndex | (Optional) In case of pairwise elements, allows to select the first (elementIndicesIndex = 0 ) or second (elementIndicesIndex = 1 ) element index of the pair. Default value is 0 , corresponding to both non-pairwise elements and first element of a pair. |
Implemented in resqml2_2::SubRepresentation, and resqml2_0_1::SubRepresentation.
|
pure virtual |
Checks if the element indices of a particular patch are pairwise or not.
std::out_of_range | If patchIndex is out of range. |
patchIndex | Zero-based index of the patch. |
Implemented in resqml2_2::SubRepresentation, and resqml2_0_1::SubRepresentation.
|
pure virtual |
Gets the count of the selected elements of a particular patch of this sub-representation.
std::out_of_range | If patchIndex is out of range. |
patchIndex | Zero-based index of the patch from which we want to count the selected elements. |
Implemented in resqml2_2::SubRepresentation, and resqml2_0_1::SubRepresentation.
|
pure virtual |
Gets the indices of the selected elements for a particular patch of this sub-representation.
std::out_of_range | If patchIndex is out of range. |
std::out_of_range | If elementIndicesIndex is out of range. Must be: 0 for non pairwise element indices; 0 or 1 for pairwise element indices (0 for the left and 1 for the right part of the pairs). |
logic_error | If the selected elements indices of the patch are not stored in a HDF5 integer array. |
patchIndex | Zero-based index of the patch. | |
elementIndicesIndex | Must be equal to 0 if the element indices are not pairwise. This method must be called twice if the element indices are pairwise: one call with elementIndicesIndex = 0 for getting the indices of the left elements of the pair; one call with elementIndices = 1 for getting the indices of the right elements of the pair. | |
[out] | elementIndices | Output array for collecting the indices of the selected elements. It must be preallocated with getElementCountOfPatch() size. |
Implemented in resqml2_2::SubRepresentation, and resqml2_0_1::SubRepresentation.
|
pure virtual |
Gets the kind of the selected elements for a particular patch of this sub-representation.
std::out_of_range | If patchIndex is out of range. |
std::out_of_range | If elementIndicesIndex is out of range. Must be: 0 for non pairwise element indices; 0 or 1 for pairwise element indices (0 for the left and 1 for the right part of the pairs). |
std::invalid_argument | If the kind of the selected elements we look for is not supported (the kind is neither a node, edge, face, volume nor pillar). |
patchIndex | Zero-based index of the patch. |
elementIndicesIndex | Must be equal to 0 if the element indices are not pairwise. This method must be called twice if the element indices are pairwise: one call with elementIndicesIndex = 0 for getting the kind of the left elements of the pair; one call with elementIndices = 1 for getting the kind of the right elements of the pair. |
Implemented in resqml2_2::SubRepresentation, and resqml2_0_1::SubRepresentation.
|
pure virtual |
Gets the dimension count of the lattice the element indices of a particular patch are based on.
std::invalid_argument | If the element indices are not based on a lattice. |
std::out_of_range | If patchIndex is out of range. |
std::out_of_range | If elementIndicesIndex is out of range. Must be: 0 for non pairwise element indices; 0 or 1 for pairwise element indices (0 for the left and 1 for the right part of the pairs). |
patchIndex | Zero-based index of the patch. |
elementIndicesIndex | (Optional) In case of pairwise elements, allow to select the first (elementIndicesIndex = 0 ) or second (elementIndicesIndex = 1 ) element index of the pair. Default value is 0 , corresponding to both non-pairwise elements and first element of a pair. |
Implemented in resqml2_2::SubRepresentation, and resqml2_0_1::SubRepresentation.
|
pure virtual |
Gets the offset count at a given dimension of the lattice the element indices of a particular patch are based on.
std::invalid_argument | If the element indices are not based on a lattice. |
std::out_of_range | If latticeDimensionIndex is out of range. |
std::out_of_range | If patchIndex is out of range. |
std::out_of_range | If elementIndicesIndex is out of range. Must be: 0 for non pairwise element indices; 0 or 1 for pairwise element indices (0 for the left and 1 for the right part of the pairs). |
latticeDimensionIndex | Zero-based index of the lattice dimension. |
patchIndex | Zero-based index of the patch. |
elementIndicesIndex | (Optional) In case of pairwise elements, allow to select the first (elementIndicesIndex = 0 ) or second (elementIndicesIndex = 1 ) element index of the pair. Default value is 0 , corresponding to both non- pairwise elements and first element of a pair. |
Implemented in resqml2_2::SubRepresentation, and resqml2_0_1::SubRepresentation.
|
pure virtual |
Gets the offset value at a given dimension of the lattice the element indices of a particular patch are based on.
std::invalid_argument | If the element indices are not based on a lattice. |
std::out_of_range | If latticeDimensionIndex is out of range. |
std::out_of_range | If patchIndex is out of range. |
std::out_of_range | If elementIndicesIndex is out of range. Must be: 0 for non pairwise element indices; 0 or 1 for pairwise element indices (0 for the left and 1 for the right part of the pairs). |
latticeDimensionIndex | Zero-based index of the lattice dimension. |
patchIndex | Zero-based index of the patch. |
elementIndicesIndex | (Optional) In case of pairwise elements, allow to select the first (elementIndicesIndex = 0 ) or second (elementIndicesIndex = 1 ) element index of the pair. Default value is 0 , corresponding to both non- pairwise elements and first element of a pair. |
Implemented in resqml2_2::SubRepresentation, and resqml2_0_1::SubRepresentation.
|
pure virtual |
Gets the start value of the lattice the element indices of a particular patch are based on.
std::invalid_argument | If the element indices are not based on a lattice. |
std::out_of_range | If patchIndex is out of range. |
std::out_of_range | If elementIndicesIndex is out of range. Must be: 0 for non pairwise element indices; 0 or 1 for pairwise element indices (0 for the left and 1 for the right part of the pairs). |
patchIndex | Zero-based index of the patch. |
elementIndicesIndex | (Optional) In case of pairwise elements, allow to select the first (elementIndicesIndex = 0 ) or second (elementIndicesIndex = 1 ) element index of the pair. Default value is 0 , corresponding to both non-pairwise elements and first element of a pair. |
Implemented in resqml2_2::SubRepresentation, and resqml2_0_1::SubRepresentation.
|
overridepure virtual |
Gets the patch count.
Implements resqml2::AbstractRepresentation.
Implemented in resqml2_2::SubRepresentation, and resqml2_0_1::SubRepresentation.
AbstractRepresentation* resqml2::SubRepresentation::getSupportingRepresentation | ( | unsigned int | index | ) | const |
Gets the supporting representation located at a specific index of this sub-representation.
std::invalid_argument | If no supporting representation is already associated to this sub-representation. |
std::out_of_range | If index is out of range. |
index | Zero-based index of the supporting representation we look for. |
index
.
|
pure virtual |
Gets the count of supporting representations of this sub-representation.
Implemented in resqml2_2::SubRepresentation, and resqml2_0_1::SubRepresentation.
|
pure virtual |
Gets the data object reference of the supporting representation located at a specific index of this sub-representation.
std::invalid_argument | If no supporting representation is already associated to this sub-representation. |
std::out_of_range | If index is out of range. |
index | Zero-based index of the supporting representation we look for. |
index
. Implemented in resqml2_2::SubRepresentation, and resqml2_0_1::SubRepresentation.
|
pure virtual |
Gets the indices of the supporting representations that refer the selected elements indices of a particular patch of this sub-representation.
std::out_of_range | If patchIndex is out of range. |
patchIndex | Zero-based index of the patch. | |
[out] | supportingRepresentationIndices | Output array for collecting the supporting representations indices. This array must be preallocated with getElementCountOfPatch() size. The index at a given position is the index of the supporting representation associated to the selected element (or the selected pair of elements) at the same position in the sub- elements) at the same position in the sub- representation patch. |
Implemented in resqml2_2::SubRepresentation, and resqml2_0_1::SubRepresentation.
|
inlinefinalvirtual |
Gets the standard XML tag without XML namespace for serializing this data object.
Implements common::AbstractObject.
|
overridevirtual |
Get the xyz point count in a given patch of this representation.
std::out_of_range | If patchIndex is out of range. |
std::logic_error | If this representation is partial. |
patchIndex | Zero-based index of the patch from which we look for the xyz points. |
patchIndex
. std::logic_error | If the kind of the selected elements of this patch is not node (non pairwise) or if the kind of the left part of the pairs of elements is not node (pairwise case). |
Implements resqml2::AbstractRepresentation.
|
overridevirtual |
Please do note use : not implemented yet.
Implements resqml2::AbstractRepresentation.
|
finalvirtual |
Loads target relationships
Reimplemented from resqml2::AbstractRepresentation.
|
pure virtual |
Pushes back a new patch (without pairwise elements) in this sub-representation where the indices values have not to yet been written in the HDF5 file. The reason can be that the indices values already exist in an external file (only HDF5 for now) or that the writing of these indices values in the external file is postponed in time.
elementKind | The kind of (indexable) elements which constitutes the sub-representation patch. | |
elementCount | The count of elements which constitutes the sub- representation patch. | |
elementDataset | The HDF5 dataset name where the element indices are stored. If empty, the dataset will be named the same as the dataset naming convention fesapi : getHdfGroup() + subRep- >uuid + "/subrepresentation_elementIndices0_patch" + patchIndex; | |
nullValue | The null value which has been chosen in the referenced HDF5 dataset. | |
[in] | proxy | The HDF5 proxy where the values are already stored or will be stored. |
supportingRepDataset | (Optional) The HDF5 dataset name where the element indices are stored. If empty (default), no information about suppporting representation will be exported since there is only one suppporting representation for this whole patch. |
Implemented in resqml2_2::SubRepresentation, and resqml2_0_1::SubRepresentation.
void resqml2::SubRepresentation::pushBackSubRepresentationPatch | ( | gsoap_eml2_3::resqml22__IndexableElement | elementKind, |
uint64_t | elementCount, | ||
uint64_t * | elementIndices, | ||
eml2::AbstractHdfProxy * | proxy, | ||
short * | supportingRepIndices = nullptr |
||
) |
Pushes back a new patch (without pairwise elements) in this sub-representation.
elementKind | The kind of (indexable) elements which constitutes the sub-representation patch. | |
elementCount | The count of elements which constitutes the sub- representation patch. | |
[in] | elementIndices | The indices of the elements in the supporting representation. |
[in] | proxy | The HDF proxy where the numerical values (indices) are stored. |
[in] | supportingRepIndices | (Optional) The indices of the supporting representation corresponding to the element indices. The count must be elementCount. |
|
pure virtual |
Pushes back a new lattice-based patch (without pairwise elements) in this sub-representation. The offset value is set to 1 in each dimension of the lattice.
elementKind | The kind of (indexable) elements which constitutes the sub-representation patch. |
originIndex | The index of the origin (its start value). |
elementCountInSlowestDimension | The number of elements in the slowest dimension (commonly in K dimension). |
elementCountInMiddleDimension | The number of elements in the middle dimension (commonly in J dimension). |
elementCountInFastestDimension | The number of elements in the fastest dimension (commonly in I dimension). |
Implemented in resqml2_2::SubRepresentation, and resqml2_0_1::SubRepresentation.
|
pure virtual |
Pushes back a new patch in this sub-representation which is constituted by means of pairwise elements.
elementKind0 | The kind of (indexable) elements which constitutes the first part of the pair of elements of the sub-representation patch. | |
elementKind1 | The kind of (indexable) elements which constitutes the second part of the pair of elements of the sub-representation patch. | |
elementCount | The count of elements which constitutes the sub- representation patch. | |
[in,out] | elementIndices0 | The indices of the first part of the element pairs in the supporting representation. |
[in,out] | elementIndices1 | The indices of the second part of the element pairs in the supporting representation. |
[in,out] | proxy | The HDF proxy where the numerical values (indices) are stored. |
Implemented in resqml2_2::SubRepresentation, and resqml2_0_1::SubRepresentation.
void resqml2::SubRepresentation::pushBackSupportingRepresentation | ( | AbstractRepresentation * | supportingRep | ) |
Pushes back a representation which is one of the support of this sub-representation. And push back this sub-representation as a subrepresentation of the representation as well.
std::invalid_argument | If supportingRep is nullptr. |
[in] | supportingRep | If representation to set as a supporting representation of this sub-representation. |
|
static |
The standard XML tag without XML namespace for serializing this data object