Transform Action

PCL Reference Manual > Finite Element Functions > Transform Action

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">

Transform Action

This section is used to describe some of the functions used to mirror, rotate, and translate finite element model nodes, elements, multi-point constraints (MPCs), meshes, and mesh seeds.


fem_transform_elems_mirror_1	(new_eid_list, plane_list, offset, reverse_elems, flag, elem_list, created_nids, created_eids, deleted_nids, deleted_eids)


Description:
This function will do a mirror translation on selected elements.
Input:
STRING	new_eid_list[]	This value specifies a selection of element identifiers to be assigned to the newly created elements.
STRING	plane_list[]	This value specifies an identifier for the plane around which the mirror transformation will be made.
REAL	offset	This value specifies an offset from the mirror transformation plane.
LOGICAL	reverse_elems	This value specifies, when set to TRUE, that the mirrored elements are to be reversed after mirror transformation has been done. Setting this value to TRUE will ensure that the jacobian values for solid elements will remain positive. Setting this value to FALSE may allow the creation of elements with negative jacobian values.
INTEGER	flag	This value specifies, when set to 1, that the original elements and nodes from which the sweep operation was made will be deleted. When set to 2 this value uses the new numbering control scheme and when set to 3, uses the new id offset method.
STRING	elem_list[]	This value specifies a list of elements to mirror.
Output:
STRING	created_nids[VIRTUAL]	This value returns a description of the created nodes.
STRING	created_eids[VIRTUAL]	This value returns a description of the created elements.
STRING	deleted_nids[VIRTUAL]	This value returns a description of the deleted nodes.
STRING	deleted_eids[VIRTUAL]	This value returns a description of the deleted elements.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

Space is internally allocated for the string returned by the output values created_nids, created_eids, deleted_nids, and deleted_eids. It is the responsibility of the calling function to free the allocated string storage space.

This function can create and delete elements that are stored in the database and displayed in a viewport.

Example:

Please see fem_transform_elems_mirror_1.


fem_transform_elems_rotate_1	(rotate_elem_select, axis_select, rotation_angle, offset_angle, ref_coord_frame, repeat_number, flag, element_select, nodes_created, elements_created, nodes_deleted, elements_deleted)


Description:
This function will do a rotation translation on the input list of elements.
Input:
STRING	rotate_elem_select[]	This value specifies a selection of element identifiers to be assigned to the newly created elements.
STRING	axis_select[]	This value specifies an identifier for the axis around which the rotation translation will take place.
REAL	rotation_angle	This value specifies the angle of rotation in degrees.
REAL	offset_angle	This value specifies the offset angle for the rotation translation in degrees.
STRING	ref_coord_frame[]	This value specifies an identifier for the reference coordinate frame.
INTEGER	repeat_number	This value specifies the number of times to repeat the rotation translation.
INTEGER	flag	This value specifies, when set to 1, that the original elements and nodes from which the sweep operation was made will be deleted. When set to 2 this value uses the new numbering control scheme and when set to 4, uses the new id offset method.
STRING	element_select[]	This value specifies a list of elements to rotate.
Output:
STRING	nodes_created[VIRTUAL]	This value returns a description of the created nodes.
STRING	elements_created[VIRTUAL]	This value returns a description of the created elements.
STRING	nodes_deleted[VIRTUAL]	This value returns a description of the deleted nodes.
STRING	elements_deleted[VIRTUAL]	This value returns a description of the deleted elements.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

Space is internally allocated for the string returned by the output values nodes_created, elements_created, nodes_deleted, and elements_deleted. It is the responsibility of the calling function to free the allocated string storage space.

This function can create and delete elements that are stored in the database and displayed in a viewport.

Example:

Please see fem_transform_elems_rotate_1.


fem_transform_nodes_mirror_1	(new_nid_list, plane_list, offset, flag, node_list, created_nids, deleted_ids)


Description:
This function will do a mirror translation on the input list of nodes.
Input:
STRING	new_nid_list[]	This value specifies a selection of node identifiers to be assigned to the newly created nodes.
STRING	plane_list[]	This value specifies an identifier for the axis around which the mirror translation will take place.
REAL	offset	This value specifies an offset from the mirror transformation plane.
INTEGER	flag	This value specifies, when set to 1, that the original elements and nodes from which the sweep operation was made will be deleted. When set to 2 this value uses the new numbering control scheme and when set to 3, uses the new id offset method.
STRING	node_list[]	This value specifies a list of nodes to mirror.
Output:
STRING	created_nids[VIRTUAL]	This value returns a description of the created nodes.
STRING	deleted_ids[VIRTUAL]	This value returns a description of the deleted nodes.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

Space is internally allocated for the string returned by the output values created_nids and deleted_ids. It is the responsibility of the calling function to free the allocated string storage space.

This function can create and delete elements that are stored in the database and displayed in a viewport.

Example:

Please see fem_transform_nodes_rotate_1.


fem_transform_nodes_rotate_1	(rotate_node_select, axis_select, rotation_angle, offset_angle, ref_coord_frame, repeat_number, flag, node_select, nodes_created, nodes_deleted)


Description:
This function will do a rotation translation on the input list of nodes.
Input:
STRING	rotate_node_select[]	This value specifies a selection of node identifiers to be assigned to the newly created nodes.
STRING	axis_select[]	This value specifies an identifier for the axis around which the rotation translation will take place.
REAL	rotation_angle	This value specifies the angle of rotation in degrees.
REAL	offset_angle	This value specifies the offset angle for the rotation translation in degrees.
STRING	ref_coord_frame[]	This value specifies an identifier for the reference coordinate frame.
INTEGER	repeat_number	This value specifies the number of times to repeat the rotation translation.
INTEGER	flag	This value specifies, when set to 1, that the original elements and nodes from which the sweep operation was made will be deleted. When set to 2 this value uses the new numbering control scheme and when set to 4, uses the new id offset method.
STRING	node_select[]	This value specifies a list of elements to rotate.
Output:
STRING	nodes_created[VIRTUAL]	This value returns a description of the created nodes.
STRING	nodes_deleted[VIRTUAL]	This value returns a description of the deleted nodes.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

Space is internally allocated for the string returned by the output values nodes_created, and nodes_deleted. It is the responsibility of the calling function to free the allocated string storage space.

This function can create and delete elements that are stored in the database and displayed in a viewport.

Example:

Please see fem_transform_nodes_rotate_1.


fem_translate_nodes_1	(trans_node_select, vector_select, ref_coord_frame, repeat_number, transform_type, delete_parents, node_select, nodes_created, nodes_deleted)


Description:
This function will do a translation operation on the input list of nodes.
Input:
STRING	trans_node_select[]	This value specifies a selection of node identifiers to be assigned to the newly created nodes.
STRING	vector_select[]	This value specifies an identifier for the vector describing the direction and distance used for the translation operation.
STRING	ref_coord_frame[]	This value specifies an identifier for the reference coordinate frame.
INTEGER	repeat_number	This value specifies the number of times to repeat the translation operation.
LOGICAL	transform_type	This value specifies, when set to TRUE, that the local coordinate system will used to interpret the input value vector_select. If this value is set to FALSE it will be assumed that the input value vector_select specifies a vector in cartesian coordinates.
INTEGER	flag	This value specifies, when set to 1, that the original elements and nodes from which the sweep operation was made will be deleted. When set to 2 this value uses the new numbering control scheme and when set to 4, uses the new id offset method.
STRING	node_select[]	This value specifies a list of nodes to translate.
Output:
STRING	nodes_created[VIRTUAL]	This value returns a description of the created nodes.
STRING	nodes_deleted[VIRTUAL]	This value returns a description of the deleted nodes.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function can create and delete elements that are stored in the database and displayed in a viewport.

Example:

Please see fem_translate_nodes_1.


fem_translate_nodes_2	(trans_node_select, vector_select, vector_magnitude, reverse_dir, ref_coord_frame, repeat_number, transform_type, delete_parents, node_select, nodes_created, nodes_deleted)


Description:
This function will do a translation operation on the input list of nodes.
Input:
STRING	assigned_ids[]	This value specifies a selection of node identifiers to be assigned to the newly created nodes. Default "#" (Next available id)
STRING	vector_select[]	This value specifies an identifier for the vector describing the direction and distance used for the translation operation. Default "<1 0 0>"
REAL	magnitude	The distance to translate in the specified vector direction. Default is the magnitude of the direction vector, e.g. 1.
LOGICAL	reverse_dir	This value specifies, when set to TRUE, to translate in the negative direction of the translation vector. If FALSE, in the positive direction. Default is FALSE
STRING	ref_coord_frame[]	This value specifies an identifier for the reference coordinate frame. Default is "Coord 0".
INTEGER	repeat_number	This value specifies the number of times to repeat the translation operation. Default is 1
LOGICAL	transform_type	This value specifies, when set to TRUE, that the local coordinate system will be used to interpret the input value vector_select. If this value is set to FALSE, it will be assumed that the input value vector_select specifies a vector in cartesian coordinates. Default is FALSE.
INTEGER	flag	This value specifies, when set to 1, that the original nodes from which the transform operation was made will be deleted. When set to 2 this value uses the new numbering control scheme and when set to 4, uses the new id offset method. Default is 2
STRING	node_select[]	This value specifies a list of nodes to translate.
Output:
STRING	nodes_created[VIRTUAL]	This value returns a description of the created nodes.
STRING	nodes_deleted[VIRTUAL]	This value returns a description of the deleted nodes.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

Space is internally allocated for the string returned by the output values nodes_created and nodes_deleted. It is the responsibility of the calling function to free the allocated string storage space.

This function can create and delete elements that are stored in the database and displayed in a viewport.


fem_translate_elems_1	(trans_elem_select, vector_select, ref_coord_frame, repeat_number, transform_type, flag, elem_select, nodes_created, elements_created, nodes_deleted, elements_deleted)


Description:
This function will do a translation operation on the input list of elements.
Input:
STRING	trans_elem_select[]	This value specifies a selection of element identifiers to be assigned to the newly created elements.
STRING	vector_select[]	This value specifies an identifier for the vector describing the direction and distance used for the translation operation.
STRING	ref_coord_frame[]	This value specifies an identifier for the reference coordinate frame.
INTEGER	repeat_number	This value specifies the number of times to repeat the translation operation.
LOGICAL	transform_type	This value specifies, when set to TRUE, that the local coordinate system will used to interpret the input value vector_select. If this value is set to FALSE it will be assumed that the input value vector_select specifies a vector in cartesian coordinates.
INTEGER	flag	This value specifies, when set to 1, that the original elements and nodes from which the sweep operation was made will be deleted. When set to 2 this value uses the new numbering control scheme and when set to 4, uses the new id offset method.
STRING	elem_select[]	This value specifies a list of elements to translate.
Output:
STRING	nodes_created[VIRTUAL]	This value returns a description of the created nodes.
STRING	elements_created[VIRTUAL]	This value returns a description of the created elements.
STRING	nodes_deleted[VIRTUAL]	This value returns a description of the deleted nodes.
STRING	elements_deleted[VIRTUAL]	This value returns a description of the deleted elements.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function can create and delete elements that are stored in the database and displayed in a viewport.

Example:

Please see fem_translate_elems_1.


fem_translate_elems_2	(trans_elem_select, vector_select, vector_magnitude, reverse_dir, ref_coord_frame, repeat_number, transform_type, flag, elem_select, nodes_created, elements_created, nodes_deleted, elements_deleted)


Description:
This function will do a translation operation on the input list of elements.
Input:
STRING	trans_elem_select[]	This value specifies a selection of element identifiers to be assigned to the newly created elements.
STRING	vector_select[]	This value specifies an identifier for the vector direction used for the translation operation.
REAL	vector_magnitude	This value specifies an identifier for the vector magnitude used for the translation operation.
LOGICAL	reverse_dir	This value specifies, when set to TRUE, that the vector direction will be reversed. If this vale is set to FALSE, vector direction will not be reversed.
STRING	ref_coord_frame[]	This value specifies an identifier for the reference coordinate frame.
INTEGER	repeat_number	This value specifies the number of times to repeat the translation operation.
LOGICAL	transform_type	This value specifies, when set to TRUE, that the local coordinate system will be used to interpret the input value vector_select. If this value is set to FALSE, it will be assumed that the input value vector_select specifies a vector in cartesian coordinates.
INTEGER	flag	This value specifies, when set to 1, that the original elements and nodes from which the sweep operation was made will be deleted. When set to 2 this value uses the new numbering control scheme and when set to 4, uses the new id offset method.
STRING	elem_select[]	This value specifies a list of elements to translate.
Output:
STRING	nodes_created[VIRTUAL]	This value returns a description of the created nodes.
STRING	elements_created[VIRTUAL]	This value returns a description of the created elements.
STRING	nodes_deleted[VIRTUAL]	This value returns a description of the deleted nodes.
STRING	elements_deleted[VIRTUAL]	This value returns a description of the deleted elements.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function can create and delete elements that are stored in the database and displayed in a viewport.