I.4.4.11 “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 with 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 with 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 with 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 with 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 with the elements touching this node, but one keeps the association to the initial node.

• “CornersToCenters”: one selects all the values associated with 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 with 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 with 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 with 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 with element ID and node IDs.

• “ElemsAndNodesToCenters”: one selects all the values associated with 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 with 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 with 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. Note that a distinction is made between the “CornerNodes” (Result keys associated with elements and nodes at corner of elements) and the “ElemsAndNodes” (Result keys associated with 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. However, for Complex Results, there are some restrictions on the type of “Method” argument for merging values: the “min” and “max” values are not accepted for Complex Results.