HyperView User's Guide

Binding Change Operators

Binding Change Operators

Previous topic Next topic Expand/collapse all hidden text  

Binding Change Operators

Previous topic Next topic JavaScript is required for expanding text JavaScript is required for the print function  

Binding change operators enable conversion of values from one entity to another related entity.  When performing binding changes, it may be necessary to specify how the values will be aggregated, and depending upon the source value type (scalar, vector, or tensor), only a subset of aggregation modes are valid.  Min, max, and extreme aggregation modes are applicable to real scalar values only.

Aggregation Mode

Description

Applies To

average

Sum of values divided by the number of values.

scalar, vector, tensor

sum

Total of values.

scalar, vector, tensor

min

Minimum value.

scalar

max

Maximum value.

scalar

extreme

Value with the largest absolute value (with sign).

scalar

The Model Library contains the following Binding Change operators:

hmtoggle_plus1BCNodeToElem

Aggregates nodal values to elemental values.

Inputs

src: a nodal value table.

elems: an element entity table.

aggregate: an aggregation mode (avg, sum, min, max, extreme).

Outputs

answer: an elemental value table.

Notes

If src is a vector or tensor table, it should be transformed to the global coordinate system.
min, max, and extreme aggregate modes are valid only for scalar data.

Expression Builder

BCNodeToElem(src,elems,aggregate)

XML Example

<call name="BCNodeToElem" src="src_tab" elems="elem_tab"

 aggregate="avg" answer="ans_tab" />

hmtoggle_plus1BCNodeToPart

Aggregates nodal values to part values.

Inputs

src: a nodal value table.

elems: an element entity table.

aggregate: an aggregation mode (avg, sum, min, max, extreme).

Outputs

answer: an elemental value table.

Notes

If src is a vector or tensor table, it should be transformed to the global coordinate system.
min, max, and extreme aggregate modes are valid only for scalar data.

Expression Builder

BCNodeToPart(src,elems,aggregate)

XML Example

<call name="BCNodeToPart" src="src_tab" elems="elem_tab"

 aggregate="avg" answer="ans_tab" />

hmtoggle_plus1BCNodeToSet

Aggregates nodal values to sets.

Inputs

src: a node value table.

sets: a set entity table.

aggregate: an aggregation mode (avg, sum, min, max, extreme).

pool_name: name of the node pool in the set.

Outputs

answer: a set value table

Notes

If src is a vector or tensor table, it should be transformed to the global coordinate system.
min, max, and extreme aggregate modes are valid only for scalar data.
The Expression Builder will auto-fill pool_name with @current_pool (assigned by the HyperWorks application).
It is not possible to plot set-bound values in HyperView.  A set-bound value must be assigned to elements using BCSetToNode.

Expression Builder

BCNodeToSet(src,sets,max)

XML Example

<call name="BCNodeToSet" src="src_tab" sets="set_tab"
pool_name="shell" aggregate="max" answer="ans_tab" />

hmtoggle_plus1BCElemToNode

Converts elemental values to nodal values.

Inputs

src: an elemental value table.

elems: an element entity table.

aggregate: an aggregation mode (avg, sum, min, max, extreme).

Outputs

answer: a nodal value table.

Notes

If src is a vector or tensor table, it should be transformed to the global coordinate system.
min, max, and extreme aggregate modes are valid only for scalar data.

Expression Builder

BCElemToNode (src,elems,aggregate)

XML Example

<call name="BCElemToNode" src="src_tab" elems="elem_tab"

 aggregate="avg" answer="ans_tab" />

hmtoggle_plus1BCElemToPart

Converts elemental values to part values.

Inputs

src: an elemental value table.

elems: an element entity table.

aggregate: an aggregation mode (avg, sum, min, max, extreme).

Outputs

answer: a part value table.

Notes

If src is a vector or tensor table, it should be transformed to the global coordinate system.
min, max, and extreme aggregate modes are valid only for scalar data.

Expression Builder

BCElemToPart(src,elems,aggregate)

XML Example

<call name="BCElemToPart" src="src_tab" elems="elem_tab"

 aggregate="avg" answer="ans_tab" />

hmtoggle_plus1BCElemToSet

Aggregates element values to sets.

Inputs

src: an element value table.

sets: a set entity table.

aggregate: an aggregation mode (avg, sum, min, max, extreme).

pool_name: name of the element pool in the set.

Outputs

answer: a set value table

Notes

If src is a vector or tensor table, it should be transformed to the global coordinate system.
min, max, and extreme aggregate modes are valid only for scalar data.
The Expression Builder will auto-fill pool_name with @current_pool (assigned by the HyperWorks application).
It is not possible to plot set-bound values in HyperView.  A set-bound value must be assigned to elements using BCSetToElem.

Expression Builder

BCElemToSet(src,sets,max)

XML Example

<call name="BCElemToSet" src="src_tab" sets="set_tab"
pool_name="shell" aggregate="max" answer="ans_tab" />

hmtoggle_plus1BCPartToElem

Converts part values to elemental values.

Inputs

src: an part value table.

elems: an element entity table.

Outputs

answer: an elemental value table.

Notes

If src is a vector or tensor table, it should be transformed to the global coordinate system.
Aggregation modes are not applicable for this operation.

Expression Builder

BCElemToPart(src,elems)

XML Example

<call name="BCPartToElem" src="src_tab" elems="elem_tab"

 answer="ans_tab" />

hmtoggle_plus1BCPropToElem

Converts property values to elemental values.

Inputs

src: an property value table.

elems: an element entity table.

parts: a part entity table.

Outputs

answer: an elemental value table

Notes

If src is a vector or tensor table, it should be transformed to the global coordinate system.
Aggregation modes are not applicable for this operation

Expression Builder

BCPropToElem(src,elems,parts)

XML Example

<call name="BCPropToElem" src="src_tab" elems="elem_tab"

 parts="part_tab" answer="ans_tab" />

hmtoggle_plus1BCPlyToElem

Converts ply values to elemental values.

Inputs

src: an ply value table.

sets: a set entity table.

pool_name: name of the element pool in the set.

Outputs

answer: an elemental value table

Notes

If src is a vector or tensor table, it should be transformed to the global coordinate system.
Aggregation modes are not applicable for this operation.
The Expression Builder will auto-fill pool_name with @current_pool (assigned by the  HyperWorksapplication).

Expression Builder

BCPlyToElem(src,sets)

XML Example

<call name="BCPlyToElem" src="src_tab" sets="set_tab"

 pool_name="shell" answer="ans_tab" />

hmtoggle_plus1BCMatToElem

Converts material values to elemental values.

Inputs

src: an property value table.

elems: an element entity table.

parts: a part entity table.

props: a property entity table.

mats: a material entity table.

layer_idx: layer index.

layer_label: selected layer label.

Outputs

answer: an elemental value table.

Notes

If src is a vector or tensor table, it should be transformed to the global coordinate system.
Aggregation modes are not applicable for this operation.
layer_idx = layer index for the chosen data type, assigned by the HyperWorks application, and defaults to the value “@current_slice_index”. @current_slice_index represents the layer index for the chosen datatype.
layer_label = layer label for the chosen data type, assigned by the HyperWorks application, and defaults to the value “@current_slice_label”. @current_slice_label represents the layer label for the chosen data type, and is used to determine the layer ID in cases where an index-based layer lookup is invalid.
The XML example below does not specify layer_idx or layer_label and uses the defaults.
The Expression Builder will provide default values for layer_idx and layer_label.

Expression Builder

BCMatToElem(src,elems,parts,props,mats,layer_idx,layer_label)

XML Example

<call name="BCMatToElem" src="mat_val_tab" elems="elem_tab"

 parts="part_tab" props="prop_tab"

 mats="mat_tab " answer="ans_tab" />

hmtoggle_plus1BCSetToElem

Assigns set values to elements.

Inputs

src: an set value table.

sets: a set entity table.

pool_name: name of the element pool in the set.

Outputs

answer: an elemental value table

Notes

If src is a vector or tensor table, it should be transformed to the global coordinate system.
Aggregation modes are not applicable for this operation.
The Expression Builder will auto-fill pool_name with @current_pool (assigned by the  HyperWorksapplication).

Expression Builder

BCSetToElem(src,sets)

XML Example

<call name="BCSetToElem" src="src_tab" sets="set_tab"

 pool_name="shell" answer="ans_tab" />

hmtoggle_plus1BCSetToNode

Assigns set values to nodes.

Inputs

src: an set value table.

sets: a set entity table.

pool_name: name of the node pool in the set.

Outputs

answer: an nodal value table

Notes

If src is a vector or tensor table, it should be transformed to the global coordinate system.
Aggregation modes are not applicable for this operation.
The Expression Builder will auto-fill pool_name with @current_pool (assigned by the  HyperWorksapplication).

Expression Builder

BCSetToNode(src,sets)

XML Example

<call name="BCSetToNode" src="src_tab" sets="set_tab"

 pool_name="node" answer="ans_tab" />