## On this page
# Toolbox
Last update: 16.07.2025
Data analysis and manipulation toolbox. [More...](#details)
## Classes
class [ComputeAbsoluteMaxima< TYPE >](class_compute_absolute_maxima.xhtml) a struct which collects settings for *[ComputeAbsoluteMaxima](class_compute_absolute_maxima.xhtml "a struct which collects settings for ComputeAbsoluteMaxima ")* [More...](class_compute_absolute_maxima.xhtml#details)
class [ComputeAbsoluteMinima< TYPE >](class_compute_absolute_minima.xhtml) a struct which collects settings for *[ComputeAbsoluteMinima](class_compute_absolute_minima.xhtml "a struct which collects settings for ComputeAbsoluteMinima ")* [More...](class_compute_absolute_minima.xhtml#details)
struct [ComputeNodalCoorDeviation](struct_compute_nodal_coor_deviation.xhtml) a struct which collects settings for *computeNodalCoorDeviation* [More...](struct_compute_nodal_coor_deviation.xhtml#details)
class [ComputeRelativeMaxima< TYPE >](class_compute_relative_maxima.xhtml) a struct which collects settings for *[ComputeRelativeMaxima](class_compute_relative_maxima.xhtml "a struct which collects settings for ComputeRelativeMaxima ")* [More...](class_compute_relative_maxima.xhtml#details)
class [ComputeRelativeMinima< TYPE >](class_compute_relative_minima.xhtml) a struct which collects settings for *[ComputeRelativeMinima](class_compute_relative_minima.xhtml "a struct which collects settings for ComputeRelativeMinima ")* [More...](class_compute_relative_minima.xhtml#details)
class [ComputeSingleObjectPerObject< TYPE >](class_compute_single_object_per_object.xhtml) a base class for algorithms that apply a simple algorithm to obtain a single object from another object [More...](class_compute_single_object_per_object.xhtml#details)
class [ComputeSingleObjectPerSample< TYPE >](class_compute_single_object_per_sample.xhtml) a base class for algorithms that apply a simple algorithm to obtain a single object from a single set of samples. [More...](class_compute_single_object_per_sample.xhtml#details)
struct [ConvertToElement< TYPE >](struct_convert_to_element.xhtml) a struct which collects settings for *convertToElement* [More...](struct_convert_to_element.xhtml#details)
struct [ConvertToNode< TYPE >](struct_convert_to_node.xhtml) a struct which collects settings for *convertToNode* [More...](struct_convert_to_node.xhtml#details)
class [CopyFilledData< TYPE >](class_copy_filled_data.xhtml) a struct which collects settings for *[CopyFilledData](class_copy_filled_data.xhtml "a struct which collects settings for CopyFilledData ")* [More...](class_copy_filled_data.xhtml#details)
class [DistanceField](class_distance_field.xhtml) represents a distance field for an unstructured grid [More...](class_distance_field.xhtml#details)
class [ExtractAboveThreshold< TYPE >](class_extract_above_threshold.xhtml) a struct which collects settings for *extractAboveThreshold* [More...](class_extract_above_threshold.xhtml#details)
class [ExtractBelowThreshold< TYPE >](class_extract_below_threshold.xhtml) a struct which collects settings for *extractBelowThreshold* [More...](class_extract_below_threshold.xhtml#details)
class [ExtractMissingDataFlags< TYPE >](class_extract_missing_data_flags.xhtml) a struct which collects settings for *[ExtractMissingDataFlags](class_extract_missing_data_flags.xhtml "a struct which collects settings for ExtractMissingDataFlags ")* [More...](class_extract_missing_data_flags.xhtml#details)
class [ExtractScalarsFromQuantity< TYPE >](class_extract_scalars_from_quantity.xhtml) a struct which collects settings for *extractAboveThreshold* [More...](class_extract_scalars_from_quantity.xhtml#details)
struct [MeshMorpherSettings](struct_mesh_morpher_settings.xhtml) a class containing global settings for mesh morphing [More...](struct_mesh_morpher_settings.xhtml#details)
class [ReplaceAboveThreshold< TYPE >](class_replace_above_threshold.xhtml) a struct which collects settings for *[ReplaceAboveThreshold](class_replace_above_threshold.xhtml "a struct which collects settings for ReplaceAboveThreshold ")* [More...](class_replace_above_threshold.xhtml#details)
class [ReplaceBelowThreshold< TYPE >](class_replace_below_threshold.xhtml) a struct which collects settings for *[ReplaceBelowThreshold](class_replace_below_threshold.xhtml "a struct which collects settings for ReplaceBelowThreshold ")* [More...](class_replace_below_threshold.xhtml#details)
## Functions
[Matrix](class_matrix.xhtml) [checkPointsInElement](group__toolbox.xhtml#ga3d271639ce30ae41ef6fc0b152d1708e) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), [Matrix](class_matrix.xhtml) coors) checks in which finite element which coordinates are located [More...](#ga3d271639ce30ae41ef6fc0b152d1708e)
[Matrix](class_matrix.xhtml) [checkPointsInVolume](group__toolbox.xhtml#ga216863415a26411ae9e4f7b9ebc843d9) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), [Matrix](class_matrix.xhtml) coors) checks which coordinates are in the interior of a volume [More...](#ga216863415a26411ae9e4f7b9ebc843d9)
[Matrix](class_matrix.xhtml) [computeEuclidianDistancesNode](group__toolbox.xhtml#gaf3c9b09de87d21154d944be806306558) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), [Matrix](class_matrix.xhtml) reference\_indices) computes the Euclidian distances of all nodes with respect to a given node set. [More...](#gaf3c9b09de87d21154d944be806306558)
[Matrix](class_matrix.xhtml) [computeGraphDistancesNode](group__toolbox.xhtml#ga6d1a880d55f0247e64fca274b358aa85) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), [Matrix](class_matrix.xhtml) reference\_indices) computes the graph (i.e. normalized) distances of all nodes with respect to a given node set. [More...](#ga6d1a880d55f0247e64fca274b358aa85)
number [computeLargestModelDimension](group__toolbox.xhtml#ga49dfbde3573203385be3bdf60ccdb98c) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b)) computes the largest axial dimension of the mesh [More...](#ga49dfbde3573203385be3bdf60ccdb98c)
[computeNodalCoorDeviation](group__toolbox.xhtml#gad77a9797ed81a41c4cc04eed3cfe2401) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), [Structure](class_structure.xhtml) mesh\_project\_target, [MetaStructure](class_meta_structure.xhtml) mesh\_project\_contactor, number max\_search\_distance, bool number\_sided\_n2s\_contact, string new\_x\_deviation\_ident, string new\_y\_deviation\_ident, string new\_z\_deviation\_ident, string new\_normal\_deviation\_ident, string new\_design\_ident, bool overwrite\_existing, bool associate\_face\_normals) computes the deviation of nodal coordinates between two meshes [More...](#gad77a9797ed81a41c4cc04eed3cfe2401)
[DataObjectVector](class_data_object_vector.xhtml) [computeNodalCoorDeviationVectorFromSignedDistance](group__toolbox.xhtml#ga17463bc47c971d5ce84effc82610e8b0) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), [IndexMapper](class_index_mapper.xhtml) index\_mapper, [DataObjectPtr](class_data_object_ptr.xhtml) signed\_distance, bool use\_interpolated\_missing\_values, bool use\_distancefield, bool mesh\_smoothening) Computes the deviation vector (of node coordinates) given a signed distance vector and a reference mesh. The output will, of course, only contain the nodes on the boundary - all other are marked as "missing". [More...](#ga17463bc47c971d5ce84effc82610e8b0)
[Matrix](class_matrix.xhtml) [computeNodeIndicesWithOptimalSpatialDistribution](group__toolbox.xhtml#gab5d59b8aea74df929cf4dc5d7dcfe380) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), number number, [Matrix](class_matrix.xhtml) boundary\_indices) [computeSmoothenedCoorDeviationVector](group__toolbox.xhtml#ga603da4e157ca813d3f8c756ec7904b76) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), [IndexMapper](class_index_mapper.xhtml) index\_mapper, [Matrix](class_matrix.xhtml) deviations, [Matrix](class_matrix.xhtml) smoothened\_deviations, Eigen::VectorXd missing\_items\_of\_deviations) Computes the deviation vector (of node coordinates) given 3 vectors defining the desired deviation direction in 3d space and a reference mesh. The output will, only contain the nodes on the boundary - all other are marked as "missing". [More...](#ga603da4e157ca813d3f8c756ec7904b76)
[DataObjectVector](class_data_object_vector.xhtml) [computeSmoothenedCoorDeviationVector](group__toolbox.xhtml#gab19910412f50ce5f1d4064e0877c7c81) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), [IndexMapper](class_index_mapper.xhtml) index\_mapper, [DataObjectPtr](class_data_object_ptr.xhtml) distance\_vector\_x, [DataObjectPtr](class_data_object_ptr.xhtml) distance\_vector\_y, [DataObjectPtr](class_data_object_ptr.xhtml) distance\_vector\_z, bool use\_interpolated\_missing\_values) Computes the deviation vector (of node coordinates) given 3 vectors defining the desired deviation direction in 3d space and a reference mesh. The output will, only contain the nodes on the boundary - all other are marked as "missing". [More...](#gab19910412f50ce5f1d4064e0877c7c81)
[Matrix](class_matrix.xhtml) [computeTopologicalDistancesElement](group__toolbox.xhtml#ga603e2114e5daa50c03e89f27b3ad2063) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), [Matrix](class_matrix.xhtml) reference\_indices) computes the topological distances of all elements with respect to a given element set. [More...](#ga603e2114e5daa50c03e89f27b3ad2063)
[Matrix](class_matrix.xhtml) [computeTopologicalDistancesNode](group__toolbox.xhtml#ga04d77239f0ea8db999841d66f7248f87) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), [Matrix](class_matrix.xhtml) reference\_indices) computes the topological distances of all nodes with respect to a given node set. [More...](#ga04d77239f0ea8db999841d66f7248f87)
[Structure](class_structure.xhtml) [extractSubstructure](group__toolbox.xhtml#gac82afcfa64ebccbe4cc5f228b71ae523) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), [Matrix](class_matrix.xhtml) nodes, [Matrix](class_matrix.xhtml) elements) [Matrix](class_matrix.xhtml) [globalIndexFromElementSet](group__toolbox.xhtml#gac40454960f443af9f7f89becd4be1f34) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), string part\_ident, string set\_ident) [Matrix](class_matrix.xhtml) [globalIndexFromNodeSet](group__toolbox.xhtml#ga718f52c7baee70200cbbe83ce8926ece) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), string part\_ident, string set\_ident) [Matrix](class_matrix.xhtml) [identifyElementsAdjacentToNodes](group__toolbox.xhtml#gade8eabb9d84527dbbc0ff2a5ac517aca) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), [Matrix](class_matrix.xhtml) node\_indices) [Matrix](class_matrix.xhtml) [identifyNodesInRange](group__toolbox.xhtml#gadf306ee3797c53354e75eabd496726b3) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), number min\_x, number max\_x, number min\_y, number max\_y, number min\_z, number max\_z) identifies all nodes being in the defined rectangular region [More...](#gadf306ee3797c53354e75eabd496726b3)
[Matrix](class_matrix.xhtml) [identifyNodesNearFixedBoundary](group__toolbox.xhtml#ga75ed12bdb94554c36fc8a53292a63732) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b)) identifies all FE nodes being which are part of the current reference set and which touch the fixed boundary [More...](#ga75ed12bdb94554c36fc8a53292a63732)
[Matrix](class_matrix.xhtml) [identifyNodesOfElements](group__toolbox.xhtml#ga242ab68bb3053b304f54f7fff3b0c880) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), [Matrix](class_matrix.xhtml) element\_indices) [Matrix](class_matrix.xhtml) [identifyNodesOnBoundary](group__toolbox.xhtml#ga18ebe568e5db4b165a81cdc98da3d28f) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b)) identifies all FE nodes being on the boundary surface of a FEM mesh [More...](#ga18ebe568e5db4b165a81cdc98da3d28f)
[Matrix](class_matrix.xhtml) [identifyNodesOnBoundaryEdges](group__toolbox.xhtml#ga4ec8c55d9b81c9a90219f248ac33b64c) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b)) identifies all FE nodes being on the boundary and on an edge of a FEM mesh or of the active domain. [More...](#ga4ec8c55d9b81c9a90219f248ac33b64c)
[Matrix](class_matrix.xhtml) [identifyNodesOnBoundaryNearSharpFeatures](group__toolbox.xhtml#ga5fe93d5b9ee42dc1d6091e3bf03354f5) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), number cos\_angle\_limit) identifies all FE nodes on the boundary, at boundary edges and at boundary points with sharp edges/corners [More...](#ga5fe93d5b9ee42dc1d6091e3bf03354f5)
[Matrix](class_matrix.xhtml) [identifyNodesOnReferenceSetBoundary](group__toolbox.xhtml#ga8b507ac76ab318ec7e76ee610ab9bd40) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b)) identifies all FE nodes being on the edge of the current reference set (neighbours of nodes being not part of it) [More...](#ga8b507ac76ab318ec7e76ee610ab9bd40)
[Matrix](class_matrix.xhtml) [identifyNodesOnSurfaceAndReferenceSetBoundary](group__toolbox.xhtml#ga066af3bc2ce84788e60e71709cd34343) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b)) identifies all FE nodes being on the boundary surface of a FEM mesh AND on the edge of the current reference set (neighbours of nodes being not part of it) [More...](#ga066af3bc2ce84788e60e71709cd34343)
[Matrix](class_matrix.xhtml) [identifyNodesOnSurfacePatches](group__toolbox.xhtml#gad28b34776e07d60455e4ca099ea76bf8) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), [Matrix](class_matrix.xhtml) reference\_indices, number cos\_angle\_limit=0.75) identifies all FE nodes being on the boundary surface of a FEM mesh AND which define a single or multiple surface patches. A surface patch is defined by a part of the boundary that is delimited by an edge with too sharp angle between surface segements. [More...](#gad28b34776e07d60455e4ca099ea76bf8)
[Matrix](class_matrix.xhtml) [indexDifference](group__toolbox.xhtml#gabbad639b996754299728f4a699b3cf11) ([Matrix](class_matrix.xhtml) A, [Matrix](class_matrix.xhtml) B) [Matrix](class_matrix.xhtml) [indexIntersection](group__toolbox.xhtml#gab43769abbf6a48c1447575048d4b1007) ([Matrix](class_matrix.xhtml) A, [Matrix](class_matrix.xhtml) B) [Matrix](class_matrix.xhtml) [indexUnion](group__toolbox.xhtml#ga00387fd8ba72b74464abfab40441ff23) ([Matrix](class_matrix.xhtml) A, [Matrix](class_matrix.xhtml) B) **template** (ExtractBelowThresholdNode) [ExtractBelowThreshold](class_extract_below_threshold.xhtml)< [NODE\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a2bccb499db6de63e558b75b39da3d482) > **template** (ExtractBelowThresholdElement) [ExtractBelowThreshold](class_extract_below_threshold.xhtml)< [ELEMENT\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379ae9445a58a2c3cd515f2058cbd3117174) > **template** (ExtractAboveThresholdNode) [ExtractAboveThreshold](class_extract_above_threshold.xhtml)< [NODE\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a2bccb499db6de63e558b75b39da3d482) > **template** (ExtractBelowThresholdScalar) [ExtractBelowThreshold](class_extract_below_threshold.xhtml)< [SCALAR\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a916fc40dfca5ba301488a121abe77495) > **template** (ExtractAboveThresholdElement) [ExtractAboveThreshold](class_extract_above_threshold.xhtml)< [ELEMENT\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379ae9445a58a2c3cd515f2058cbd3117174) > **template** (CopyFilledDataNode) [CopyFilledData](class_copy_filled_data.xhtml)< [NODE\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a2bccb499db6de63e558b75b39da3d482) > **template** (ExtractMissingDataFlagsNode) [ExtractMissingDataFlags](class_extract_missing_data_flags.xhtml)< [NODE\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a2bccb499db6de63e558b75b39da3d482) > **template** (ExtractAboveThresholdScalar) [ExtractAboveThreshold](class_extract_above_threshold.xhtml)< [SCALAR\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a916fc40dfca5ba301488a121abe77495) > **template** (ExtractScalarsFromQuantityNode) [ExtractScalarsFromQuantity](class_extract_scalars_from_quantity.xhtml)< [NODE\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a2bccb499db6de63e558b75b39da3d482) > **template** (CopyFilledDataElement) [CopyFilledData](class_copy_filled_data.xhtml)< [ELEMENT\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379ae9445a58a2c3cd515f2058cbd3117174) > **template** (ExtractMissingDataFlagsElement) [ExtractMissingDataFlags](class_extract_missing_data_flags.xhtml)< [ELEMENT\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379ae9445a58a2c3cd515f2058cbd3117174) > **template** (ComputeAbsoluteMaximaNode) [ComputeAbsoluteMaxima](class_compute_absolute_maxima.xhtml)< [NODE\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a2bccb499db6de63e558b75b39da3d482) > **template** (ComputeAbsoluteMinimaNode) [ComputeAbsoluteMinima](class_compute_absolute_minima.xhtml)< [NODE\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a2bccb499db6de63e558b75b39da3d482) > **template** (ExtractScalarsFromQuantityElement) [ExtractScalarsFromQuantity](class_extract_scalars_from_quantity.xhtml)< [ELEMENT\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379ae9445a58a2c3cd515f2058cbd3117174) > **template** (CopyFilledDataScalar) [CopyFilledData](class_copy_filled_data.xhtml)< [SCALAR\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a916fc40dfca5ba301488a121abe77495) > **template** (ComputeAbsoluteMaximaElement) [ComputeAbsoluteMaxima](class_compute_absolute_maxima.xhtml)< [ELEMENT\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379ae9445a58a2c3cd515f2058cbd3117174) > **template** (ComputeAbsoluteMinimaElement) [ComputeAbsoluteMinima](class_compute_absolute_minima.xhtml)< [ELEMENT\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379ae9445a58a2c3cd515f2058cbd3117174) > **template** (ReplaceAboveThresholdNode) [ReplaceAboveThreshold](class_replace_above_threshold.xhtml)< [NODE\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a2bccb499db6de63e558b75b39da3d482) > **template** (ReplaceBelowThresholdNode) [ReplaceBelowThreshold](class_replace_below_threshold.xhtml)< [NODE\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a2bccb499db6de63e558b75b39da3d482) > **template** (ExtractMissingDataFlagsScalar) [ExtractMissingDataFlags](class_extract_missing_data_flags.xhtml)< [SCALAR\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a916fc40dfca5ba301488a121abe77495) > **template** (ReplaceAboveThresholdElement) [ReplaceAboveThreshold](class_replace_above_threshold.xhtml)< [ELEMENT\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379ae9445a58a2c3cd515f2058cbd3117174) > **template** (ReplaceBelowThresholdElement) [ReplaceBelowThreshold](class_replace_below_threshold.xhtml)< [ELEMENT\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379ae9445a58a2c3cd515f2058cbd3117174) > **template** (ReplaceAboveThresholdScalar) [ReplaceAboveThreshold](class_replace_above_threshold.xhtml)< [SCALAR\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a916fc40dfca5ba301488a121abe77495) > **template** (ReplaceBelowThresholdScalar) [ReplaceBelowThreshold](class_replace_below_threshold.xhtml)< [SCALAR\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a916fc40dfca5ba301488a121abe77495) > **template** (ComputeRelativeMaximaNode) [ComputeRelativeMaxima](class_compute_relative_maxima.xhtml)< [NODE\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a2bccb499db6de63e558b75b39da3d482) > **template** (ComputeRelativeMinimaNode) [ComputeRelativeMinima](class_compute_relative_minima.xhtml)< [NODE\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a2bccb499db6de63e558b75b39da3d482) > **template** (ComputeRelativeMinimaElement) [ComputeRelativeMinima](class_compute_relative_minima.xhtml)< [ELEMENT\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379ae9445a58a2c3cd515f2058cbd3117174) > **template** (ComputeRelativeMaximaElement) [ComputeRelativeMaxima](class_compute_relative_maxima.xhtml)< [ELEMENT\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379ae9445a58a2c3cd515f2058cbd3117174) > **template** (ConvertNodeToNode) [ConvertToNode](struct_convert_to_node.xhtml)< [NODE\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a2bccb499db6de63e558b75b39da3d482) > **template** (ConvertNodeToElement) [ConvertToElement](struct_convert_to_element.xhtml)< [NODE\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a2bccb499db6de63e558b75b39da3d482) > **template** (ConvertElementToNode) [ConvertToNode](struct_convert_to_node.xhtml)< [ELEMENT\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379ae9445a58a2c3cd515f2058cbd3117174) > **template** (ConvertElementToElement) [ConvertToElement](struct_convert_to_element.xhtml)< [ELEMENT\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379ae9445a58a2c3cd515f2058cbd3117174) > **template** (ComputeSingleObjectPerSampleNode) [ComputeSingleObjectPerSample](class_compute_single_object_per_sample.xhtml)< [NODE\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a2bccb499db6de63e558b75b39da3d482) > **template** (ComputeSingleObjectPerSampleElement) [ComputeSingleObjectPerSample](class_compute_single_object_per_sample.xhtml)< [ELEMENT\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379ae9445a58a2c3cd515f2058cbd3117174) > **template** (ComputeSingleObjectPerSampleScalar) [ComputeSingleObjectPerSample](class_compute_single_object_per_sample.xhtml)< [SCALAR\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a916fc40dfca5ba301488a121abe77495) > **template** (ComputeSingleObjectPerObjectNode) [ComputeSingleObjectPerObject](class_compute_single_object_per_object.xhtml)< [NODE\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a2bccb499db6de63e558b75b39da3d482) > **template** (ComputeSingleObjectPerObjectElement) [ComputeSingleObjectPerObject](class_compute_single_object_per_object.xhtml)< [ELEMENT\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379ae9445a58a2c3cd515f2058cbd3117174) > **template** (ComputeSingleObjectPerObjectScalar) [ComputeSingleObjectPerObject](class_compute_single_object_per_object.xhtml)< [SCALAR\_DATA](group__data.xhtml#gga1bebf1e22deb3cd41d7d99ddcdb15379a916fc40dfca5ba301488a121abe77495) > ## Variables
[MeshMorpherSettings](struct_mesh_morpher_settings.xhtml) [mesh\_morpher\_settings](group__toolbox.xhtml#ga655cb021f721f0981865bc866b508df4) global settings for mesh morphing
## Detailed Description
Data analysis and manipulation toolbox.
## Function Documentation
## [◆ ](#ga3d271639ce30ae41ef6fc0b152d1708e)checkPointsInElement()
[Matrix](class_matrix.xhtml) checkPointsInElement ( [Structure](class_structure.xhtml) *database*, [Matrix](class_matrix.xhtml) *coors* )
checks in which finite element which coordinates are located
Parameters databasecontains the mesh (FEM) coorsthe coordinates of the points to be tested (3\*N, each column is one coordinate in 3d) Returnsa column vector indicating outside by -1 and else the index of the finite element (with respect to indexMapper)
## [◆ ](#ga216863415a26411ae9e4f7b9ebc843d9)checkPointsInVolume()
[Matrix](class_matrix.xhtml) checkPointsInVolume ( [Structure](class_structure.xhtml) *database*, [Matrix](class_matrix.xhtml) *coors* )
checks which coordinates are in the interior of a volume
Parameters databasecontains the mesh coorsthe coordinates of the points to be tested (3\*N, each column is one coordinate in 3d) Returnsa column vector indicating outside by 0 and inside by 1
## [◆ ](#gaf3c9b09de87d21154d944be806306558)computeEuclidianDistancesNode()
[Matrix](class_matrix.xhtml) computeEuclidianDistancesNode ( [Structure](class_structure.xhtml) *database*, [Matrix](class_matrix.xhtml) *reference\_indices* )
computes the Euclidian distances of all nodes with respect to a given node set.
Returnsa vector containing the euclidian distances of each node to the respective reference nodes The euclidian distance between two nodes defines the distance between two nodes in Euclidian space (ignoring mesh topology). Numerical complexity is O(n\*m) with n = number of nodes, m=number of reference nodes; Parameters databasethe database containing the reference mesh reference\_indicesa vector containing the indices to nodes the define the zero distances (e.g. reference boundary)
## [◆ ](#ga6d1a880d55f0247e64fca274b358aa85)computeGraphDistancesNode()
[Matrix](class_matrix.xhtml) computeGraphDistancesNode ( [Structure](class_structure.xhtml) *database*, [Matrix](class_matrix.xhtml) *reference\_indices* )
computes the graph (i.e. normalized) distances of all nodes with respect to a given node set.
Returnsa vector containing the graph distances of each node to the respective reference nodes The graph distance defines between two nodes how many graph edges are used at least to connect the two nodes. Parameters databasethe database containing the reference mesh reference\_indicesa vector containing the indices to nodes the define the zero distances (e.g. reference boundary)
## [◆ ](#ga49dfbde3573203385be3bdf60ccdb98c)computeLargestModelDimension()
number computeLargestModelDimension ( [Structure](class_structure.xhtml) *database*)
computes the largest axial dimension of the mesh
Parameters databasecontains the mesh Returnsthe largest dimension of the mesh along one of the axis.
## [◆ ](#gad77a9797ed81a41c4cc04eed3cfe2401)computeNodalCoorDeviation()
computeNodalCoorDeviation ( [Structure](class_structure.xhtml) *database*, [Structure](class_structure.xhtml) *mesh\_project\_target*, [MetaStructure](class_meta_structure.xhtml) *mesh\_project\_contactor*, number *max\_search\_distance*, bool *number\_sided\_n2s\_contact*, string *new\_x\_deviation\_ident*, string *new\_y\_deviation\_ident*, string *new\_z\_deviation\_ident*, string *new\_normal\_deviation\_ident*, string *new\_design\_ident*, bool *overwrite\_existing*, bool *associate\_face\_normals* )
computes the deviation of nodal coordinates between two meshes
Parameters mesh\_project\_targetis the mesh to which the deviation is measured. the difference vector will be the difference of the coordinates of *mesh\_project\_contactor* minus the coordinates of *mesh\_project\_target*. On requires that the onSurface flags were set in the *mesh\_project\_target* mesh! mesh\_project\_contactoris the mesh from which the deviation is to be measured. If *mesh\_project\_target* and *mesh\_project\_contactor* are compatible, a simple algorithm is used which only takes the nodal coordinates (and the normal vectors on the boundary of *mesh-from*) as reference. If both are incompatible, then a real closest-point projection is performed. Usually, *mesh\_project\_contactor* is one of the imported design meshes. It must be identical or compatible with the mesh stored in database. If *mesh\_project\_contactor* is empty, one takes the mesh from *database* instead. The coordinate deviation is computes such that coor\[contactor\]+deviation = coor\[target\] max\_search\_distancethe maximum search distance used in closest-point projection. number\_sided\_n2s\_contactdefines if a number sided node-to-surface projection is used in closest-point projection (recommended). If not, only the boundary nodes of *mesh\_project\_contactor* are chosen. new\_x\_deviation\_identthe ident of the nodal deviation object along x direction (if empty: no object will be created) new\_y\_deviation\_identthe ident of the nodal deviation object along y direction (if empty: no object will be created) new\_z\_deviation\_identthe ident of the nodal deviation object along z direction (if empty: no object will be created) new\_normal\_deviation\_identthe ident of the nodal deviation object along normal direction (if empty: no object will be created) new\_design\_identthe design ident of all new objects databasethe database where all objects are to be inserted. overwrite\_existingis true if already existing output data objects will be replaced. In this case, also all depending objects of the already existing one will be deleted. associate\_face\_normalsif true, then the detection tries to associate only those boundary faces which point into the same half space. This may be good for thin-walled structures, but may fail in case of large deformations.
## [◆ ](#ga17463bc47c971d5ce84effc82610e8b0)computeNodalCoorDeviationVectorFromSignedDistance()
[DataObjectVector](class_data_object_vector.xhtml) computeNodalCoorDeviationVectorFromSignedDistance ( [Structure](class_structure.xhtml) *database*, [IndexMapper](class_index_mapper.xhtml) *index\_mapper*, [DataObjectPtr](class_data_object_ptr.xhtml) *signed\_distance*, bool *use\_interpolated\_missing\_values*, bool *use\_distancefield*, bool *mesh\_smoothening* )
Computes the deviation vector (of node coordinates) given a signed distance vector and a reference mesh. The output will, of course, only contain the nodes on the boundary - all other are marked as "missing".
Parameters meshThe reference mesh index\_mapperthe index mapper all data refer to signed\_distanceThe signed distance ("deviation") vector based on the reference mesh. use\_interpolated\_missing\_valuesIf true, then one takes the interpolated value if the input has missing items. Otherwise, missing items in the input will be also missing in the output. use\_distancefieldIf false: Use normal vectors on the boundary. Else: Use distance field for geometric morphing. mesh\_smootheningif true: use iterative smoothening, if false: no smoothening ReturnsA vector with 3 objects: the deviation along x \[0\], y \[1\], and z \[2\] direction.
## [◆ ](#gab5d59b8aea74df929cf4dc5d7dcfe380)computeNodeIndicesWithOptimalSpatialDistribution()
[Matrix](class_matrix.xhtml) computeNodeIndicesWithOptimalSpatialDistribution ( [Structure](class_structure.xhtml) *database*, number *number*, [Matrix](class_matrix.xhtml) *boundary\_indices* )
Returnsa vector with node indices Parameters numberthe number of indices boundary\_indicesthe boundary indices, e.g. obtained from identifyNodesOnBoundaryEdges databasethe database containing the reference mesh
## [◆ ](#ga603da4e157ca813d3f8c756ec7904b76)computeSmoothenedCoorDeviationVector() \[1/2\]
computeSmoothenedCoorDeviationVector ( [Structure](class_structure.xhtml) *database*, [IndexMapper](class_index_mapper.xhtml) *index\_mapper*, [Matrix](class_matrix.xhtml) *deviations*, [Matrix](class_matrix.xhtml) *smoothened\_deviations*, Eigen::VectorXd *missing\_items\_of\_deviations* )
Computes the deviation vector (of node coordinates) given 3 vectors defining the desired deviation direction in 3d space and a reference mesh. The output will, only contain the nodes on the boundary - all other are marked as "missing".
Parameters meshThe reference mesh index\_mapperthe index mapper all data refer to deviations3 columns containing the axial deviations ReturnsA matrix with 3 columns: the deviation along x \[0\], y \[1\], and z \[2\] direction.
## [◆ ](#gab19910412f50ce5f1d4064e0877c7c81)computeSmoothenedCoorDeviationVector() \[2/2\]
[DataObjectVector](class_data_object_vector.xhtml) computeSmoothenedCoorDeviationVector ( [Structure](class_structure.xhtml) *database*, [IndexMapper](class_index_mapper.xhtml) *index\_mapper*, [DataObjectPtr](class_data_object_ptr.xhtml) *distance\_vector\_x*, [DataObjectPtr](class_data_object_ptr.xhtml) *distance\_vector\_y*, [DataObjectPtr](class_data_object_ptr.xhtml) *distance\_vector\_z*, bool *use\_interpolated\_missing\_values* )
Computes the deviation vector (of node coordinates) given 3 vectors defining the desired deviation direction in 3d space and a reference mesh. The output will, only contain the nodes on the boundary - all other are marked as "missing".
Parameters meshThe reference mesh index\_mapperthe index mapper all data refer to distance\_vector\_xThe distance ("deviation") vector along x axis based on the reference mesh. distance\_vector\_yThe distance ("deviation") vector along y axis based on the reference mesh. distance\_vector\_zThe distance ("deviation") vector along z axis based on the reference mesh. use\_interpolated\_missing\_valuesIf true, then one takes the interpolated value if the input has missing items. Otherwise, missing items in the input will be also missing in the output. ReturnsA vector with 3 objects: the deviation along x \[0\], y \[1\], and z \[2\] direction.
## [◆ ](#ga603e2114e5daa50c03e89f27b3ad2063)computeTopologicalDistancesElement()
[Matrix](class_matrix.xhtml) computeTopologicalDistancesElement ( [Structure](class_structure.xhtml) *database*, [Matrix](class_matrix.xhtml) *reference\_indices* )
computes the topological distances of all elements with respect to a given element set.
Returnsa vector containing the topological distances of each element to the respective reference elements The topological distance between two nodes defines the minimum cumulative distance along the graph edges to connect the two elements. Parameters databasethe database containing the reference mesh reference\_indicesa vector containing the indices to elements the define the zero distances (e.g. reference boundary)
## [◆ ](#ga04d77239f0ea8db999841d66f7248f87)computeTopologicalDistancesNode()
[Matrix](class_matrix.xhtml) computeTopologicalDistancesNode ( [Structure](class_structure.xhtml) *database*, [Matrix](class_matrix.xhtml) *reference\_indices* )
computes the topological distances of all nodes with respect to a given node set.
Returnsa vector containing the topological distances of each node to the respective reference nodes The topological distance between two nodes defines the minimum cumulative distance along the graph edges to connect the two nodes. Parameters databasethe database containing the reference mesh reference\_indicesa vector containing the indices to nodes the define the zero distances (e.g. reference boundary)
## [◆ ](#gac82afcfa64ebccbe4cc5f228b71ae523)extractSubstructure()
[Structure](class_structure.xhtml) extractSubstructure ( [Structure](class_structure.xhtml) *database*, [Matrix](class_matrix.xhtml) *nodes*, [Matrix](class_matrix.xhtml) *elements* )
Returnsa database containing only the specified spatial substructure of the original data Parameters databasethe original database nodesthe global indices of the nodes to be exported elementsthe global indices of the elements to be exportedThe given indices refer to the curently active sets. All nodes being part of the given elements must be part of the specified list of nodes. The output database has the following properties:
- smaller mesh (limited to the node/elements)
- smaller node and element sets (limtied to the node/elements)
- copy of all scalar objects
- copy of all field objects, but with reduced dimension
- copy of all random fields, but with reduced dimension (probably not optimal -> recreation the random field is recommended)
- copy of all FMOP, but with reduced dimension (probably not optimal -> recreation the FMOP is recommended)
## [◆ ](#gac40454960f443af9f7f89becd4be1f34)globalIndexFromElementSet()
[Matrix](class_matrix.xhtml) globalIndexFromElementSet ( [Structure](class_structure.xhtml) *database*, string *part\_ident*, string *set\_ident* )
Returnsa column vector containing the global indices of all elements that are in the given element set and in the currently set reference element set Parameters databasethe database containing the reference mesh part\_identthe part ident of the element set set\_identthe ident of the element set within the part
## [◆ ](#ga718f52c7baee70200cbbe83ce8926ece)globalIndexFromNodeSet()
[Matrix](class_matrix.xhtml) globalIndexFromNodeSet ( [Structure](class_structure.xhtml) *database*, string *part\_ident*, string *set\_ident* )
Returnsa column vector containing the global indices of all nodes that are in the given node set and in the currently set reference node set Parameters databasethe database containing the reference mesh part\_identthe part ident of the node set set\_identthe ident of the node set within the part
## [◆ ](#gade8eabb9d84527dbbc0ff2a5ac517aca)identifyElementsAdjacentToNodes()
[Matrix](class_matrix.xhtml) identifyElementsAdjacentToNodes ( [Structure](class_structure.xhtml) *database*, [Matrix](class_matrix.xhtml) *node\_indices* )
Returnsa column vector containing the global indices of all elements that are connected to the given list of nodes Parameters databasethe database containing the reference mesh node\_indicesindices (global indices) of all nodes to be considered
## [◆ ](#gadf306ee3797c53354e75eabd496726b3)identifyNodesInRange()
[Matrix](class_matrix.xhtml) identifyNodesInRange ( [Structure](class_structure.xhtml) *database*, number *min\_x*, number *max\_x*, number *min\_y*, number *max\_y*, number *min\_z*, number *max\_z* )
identifies all nodes being in the defined rectangular region
Parameters databasethe database containing the mesh and refernece node set min\_xlower bound for X max\_xupper bound for X min\_ylower bound for Y max\_yupper bound for Y min\_zlower bound for Z max\_zupper bound for Z Returnsa vector with indices. Each index corresponds to a node and is the index in a dataobject.
## [◆ ](#ga75ed12bdb94554c36fc8a53292a63732)identifyNodesNearFixedBoundary()
[Matrix](class_matrix.xhtml) identifyNodesNearFixedBoundary ( [Structure](class_structure.xhtml) *database*)
identifies all FE nodes being which are part of the current reference set and which touch the fixed boundary
Parameters databasecontains the FEM mesh Returnsa vector with indices. Each index corresponds to a node and is the index in a dataobject.
## [◆ ](#ga242ab68bb3053b304f54f7fff3b0c880)identifyNodesOfElements()
[Matrix](class_matrix.xhtml) identifyNodesOfElements ( [Structure](class_structure.xhtml) *database*, [Matrix](class_matrix.xhtml) *element\_indices* )
Returnsa column vector containing the global indices of all nodes that belong to the givven list of elements Parameters databasethe database containing the reference mesh element\_indicesindices (global indices) of all elements to be considered
## [◆ ](#ga18ebe568e5db4b165a81cdc98da3d28f)identifyNodesOnBoundary()
[Matrix](class_matrix.xhtml) identifyNodesOnBoundary ( [Structure](class_structure.xhtml) *database*)
identifies all FE nodes being on the boundary surface of a FEM mesh
Parameters databasecontains the FEM mesh Returnsa vector with indices. Each index corresponds to a node and is the index in a dataobject.
## [◆ ](#ga4ec8c55d9b81c9a90219f248ac33b64c)identifyNodesOnBoundaryEdges()
[Matrix](class_matrix.xhtml) identifyNodesOnBoundaryEdges ( [Structure](class_structure.xhtml) *database*)
identifies all FE nodes being on the boundary and on an edge of a FEM mesh or of the active domain.
Parameters databasecontains the FEM mesh Returnsa vector with indices. Each index corresponds to a node and is the index in a dataobject.
## [◆ ](#ga5fe93d5b9ee42dc1d6091e3bf03354f5)identifyNodesOnBoundaryNearSharpFeatures()
[Matrix](class_matrix.xhtml) identifyNodesOnBoundaryNearSharpFeatures ( [Structure](class_structure.xhtml) *database*, number *cos\_angle\_limit* )
identifies all FE nodes on the boundary, at boundary edges and at boundary points with sharp edges/corners
Parameters databasecontains the FEM mesh cos\_angle\_limitthe cosine of the limiting angle between neighbouring normal vectors. If the actual scalar product is larger than the value defined here, it is considered as a sharp feature. "0" means e.g. an angle of >90° Returnsa vector with indices. Each index corresponds to a node and is the index in a dataobject.
## [◆ ](#ga8b507ac76ab318ec7e76ee610ab9bd40)identifyNodesOnReferenceSetBoundary()
[Matrix](class_matrix.xhtml) identifyNodesOnReferenceSetBoundary ( [Structure](class_structure.xhtml) *database*)
identifies all FE nodes being on the edge of the current reference set (neighbours of nodes being not part of it)
NoteAdvantage: Works also for nsets in interior of volumes. Disadvantage: All nodes of the bounding element layer are token as boundary. Check method identifyNodesOnSurfaceAndReferenceSetBoundary as alternative. Parameters databasecontains the FEM mesh Returnsa vector with indices. Each index corresponds to a node and is the index in a dataobject.
## [◆ ](#ga066af3bc2ce84788e60e71709cd34343)identifyNodesOnSurfaceAndReferenceSetBoundary()
[Matrix](class_matrix.xhtml) identifyNodesOnSurfaceAndReferenceSetBoundary ( [Structure](class_structure.xhtml) *database*)
identifies all FE nodes being on the boundary surface of a FEM mesh AND on the edge of the current reference set (neighbours of nodes being not part of it)
Parameters databasecontains the FEM mesh Returnsa vector with indices. Each index corresponds to a node and is the index in a dataobject.
## [◆ ](#gad28b34776e07d60455e4ca099ea76bf8)identifyNodesOnSurfacePatches()
[Matrix](class_matrix.xhtml) identifyNodesOnSurfacePatches ( [Structure](class_structure.xhtml) *database*, [Matrix](class_matrix.xhtml) *reference\_indices*, number *cos\_angle\_limit* = `0.75` )
identifies all FE nodes being on the boundary surface of a FEM mesh AND which define a single or multiple surface patches. A surface patch is defined by a part of the boundary that is delimited by an edge with too sharp angle between surface segements.
Parameters databasecontains the FEM mesh cos\_angle\_limitthe cosine of the limiting angle between neighbouring normal vectors. If the actual scalar product is larger than the value defined here, it is considered as a sharp feature. "0" means e.g. an angle of >90° referenceindices contains the global indices of the FEM nodes which are located on the surface patch(es) to be identified. Returnsa vector with indices. Each index corresponds to a node and is the index in a dataobject.
## [◆ ](#gabbad639b996754299728f4a699b3cf11)indexDifference()
[Matrix](class_matrix.xhtml) indexDifference ( [Matrix](class_matrix.xhtml) *A*, [Matrix](class_matrix.xhtml) *B* )
Returnsa column vector containing the difference of the indices A-B Parameters Athe first index matrix Bthe second index matrix
## [◆ ](#gab43769abbf6a48c1447575048d4b1007)indexIntersection()
[Matrix](class_matrix.xhtml) indexIntersection ( [Matrix](class_matrix.xhtml) *A*, [Matrix](class_matrix.xhtml) *B* )
Returnsa column vector containing the intersection of the indices A and B Parameters Athe first index matrix Bthe second index matrix
## [◆ ](#ga00387fd8ba72b74464abfab40441ff23)indexUnion()
[Matrix](class_matrix.xhtml) indexUnion ( [Matrix](class_matrix.xhtml) *A*, [Matrix](class_matrix.xhtml) *B* )
Returnsa column vector containing the union of all indices Parameters Athe first index matrix Bthe second index matrix