I.4.4.10 “deriveByRemapping” method
“deriveByRemapping” method returns a Result object obtained by remapping the values of the Result
object to which the method is applied. This method takes three parameters:
-
1.
- “FromTo”: a String object specifying the correspondence between the keys of the old Result
object and the keys of the new Result object. Eleven different values of the “FromTo” argument
are allowed:
- “CentersToElemsAndNodes”: one selects all the values at center of elements (i.e.
the key of which has an elemId, but no nodeId), then one produce a new Result
object with values associated to the corners and edges of those elements.
- “CentersToNodes”: one selects all the values at center of elements (i.e. the key of
which has an elemId, but no nodeId), then one produce a new Result object with
values associated to the nodes of those elements (i.e. the key of which has no elemId
but has a nodeId).
- “CentersToCorners”: one selects all the values at center of elements (i.e. the key of
which has an elemId, but no nodeId), then one produce a new Result object with
values associated to the corners of those elements.
- “CentersToCornerNodes”: one selects all the values at center of elements (i.e. the
key of which has an elemId, but no nodeId), then one produce a new Result object
with values associated to the corner nodes of those elements (i.e. the key of which
has no elemId but has a nodeId).
- “NodesToCenters”: one selects all the values associated to nodes and produces a
new Result in which the values are associated to the centers of the elements touching
this node.
- “NodesToElemsAndNodes”: one selects all the values associated to nodes and
produces a new Result in which the values are associated to the elements touching
this node, but one keeps the association to the initial node.
- “CornersToCenters”: one selects all the values associated to corners (i.e. the key of
which has both an elemId and a nodeId corresponding to a corner of this element),
and one builds a Result object with values associated to the center of elements.
- “CornersToNodes”: one selects all the values associated to corners (i.e. the key of
which has both an elemId and a nodeId that corresponds to an element corner), and
one builds a Result object with values associated to the corresponding nodes.
- “MergeLayers”: one produces a Result object in which for each pair of Element,
Node and SubLayer only one Layer is kept. The layerId of each key of the produced
Result object is kept uninitialized (i.e. set to -1).
- “MergeLayersKeepId”: one produces a Result object in which for each pair of
Element, Node and SubLayer only one Layer is kept. The layerId of each key of the
produced Result object is the one of the selected key-value of the original Result.
For this option only “min” and “max” selection methods are accepted.
- “MergeSubLayers”: one produces a Result object in which for each pair of Element,
Node and Layer only one SubLayer is kept. The subLayerId of each key of the
produced Result object is kept uninitialized (i.e. set to 0).
- “MergeSubLayersKeepId”: one produces a Result object in which for each pair of
Element, Node and Layer only one SubLayer is kept. The subLayerId of each key
of the produced Result object is the one of the selected key-value of the original
Result. For this option only “min” and “max” selection methods are accepted.
- “MergeAll” merges all the keys and produces a Result object with a single
“key-value” pair. The “sum”, “average”, “min” and “max” selection methods are
accepted.
- “NodesToCorners”: one selects all the values associated to nodes and produces a
new Result in which the values are associated to the elements touching this node
and of which the node is a corner, and one keeps the association to the initial node.
- “CornersToElemsAndNodes”: one selects the values associated to element corners
and produces a new Result in which values are associated to all the nodes defining
the element. Values are associated to element ID and node IDs.
- “ElemsAndNodesToCenters”: one selects all the values associated to elements and
nodes (i.e. the key of which has both an elemId and a nodeId), and one builds a
Result object with values associated to the center of elements.
- “ElemsAndNodesToNodes”: one selects all the values associated to corners (i.e. the
key of which has both an elemId and a nodeId), and one builds a Result object with
values associated to the corresponding nodes but not to the elements.
- “ElemsAllToCenters”: one selects all the values associated to elements corners
and center, and one builds a Result object with values associated to the center of
elements.
- “CornersToElemsAllNodes”: reinterpolates the result values at element corners to
other element nodes (typically edge nodes, or node at element center). The available
methods are “average” and “sum”. (See below.) Currently, this method is available
for Nastran results only.
The different “fromTo” parameters are summarized in Table I.4.7. Remark that one
distinguishes the “CornerNodes” (Result keys associated to elements and nodes at corner of
elements) and the “ElemsAndNodes” (Result keys associated to elements and nodes of elements
but not necessarily at their corners).
-
2.
- “Method”: a String object used to specify the way values associated to different keys are merged
into a single value (if this happens). An example of situation in which the case may occur is for
example when one uses the “NodesToCenters” option and that the values of several nodes are
merged into the value of a single element. Five values of “Method” argument are
allowed:
- “average”: each merged value is defined as the average of its different contributions.
- “sum”: each merged value is defined as the sum of its different contributions.
- “min”: one keeps the smallest value. This option can be used for scalar Results only.
- “max”: one keeps the largest value. This option can be used for scalar Results only.
- “NONE”: this option is used when one is sure that no merging of several values is
possible.
Note that when vectorial or tensorial Results are merged (“sum” or “average” options,
their respective coordinate systems must be identical. Otherwise an error message is
issued.
-
3.
- “DB”: a DataBase object used by the method to recover the association of node and elements.
This association is often needed to perform the remapping.
The “deriveByRemapping” method can be used with Real as well as Complex Results. Only, for Complex
Results, there are some restriction about the type of “Method” argument for merging values: the “min”
and “max” values are not accepted for Complex Results.
Table I.4.7: The different “fromTo” arguments for “derivebyRemapping” method.
|
|
|
|
“fromTo” argument | Source | target | Target key types |
|
|
|
|
|
|
|
|
“CentersToCorners” | Element Centers | Element Corners | EN** |
|
|
|
|
“CentersToNodes” | Element Centers | Nodes of Elements | -N** |
|
|
|
|
“NodesToCenters” | Nodes | Element Centers | E-** |
|
|
|
|
“NodesToCorners” | Nodes | Element corners | EN** |
|
|
|
|
“CornersToCenters” | Element Corners | Element Centers | E-** |
|
|
|
|
“CornersToNodes” | Element Corners | Nodes of Elements | -N** |
|
|
|
|
“MergeLayers” | Layers | - | EN-* |
|
|
|
|
“MergeLayersKeepId” | Layers | Layers | EN** |
|
|
|
|
“MergeSubLayers” | Sub-layers | - | EN*- |
|
|
|
|
“MergeSubLayersKeepId” | Sub-layers | Sub-layers | EN** |
|
|
|
|
“MergeAll” | All keys | - | —- |
|
|
|
|
“CentersToElemsAndNodes” | Element Centers | Element Nodes | EN** |
|
|
|
|
“CornersToElemsAndNodes” | Element Corners | Element Nodes | EN** |
|
|
|
|
“CentersToCornerNodes” | Element Centers | Element Corner Nodes | -N** |
|
|
|
|
“ElemsAndNodesToCenters” | Element Nodes | Element Centers | -N** |
|
|
|
|
“ElemsAndNodesToNodes” | Element Nodes | Nodes | -N** |
|
|
|
|
“NodesToElemsAndNodes” | Nodes | Element Nodes | EN** |
|
|
|
|
|