Element Properties

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">

This section explains the functions that pertain to element properties.

elementprops_create	(prop_name, elem_type_id, geo_opt_id, con_opt_id, for_opt_id, lam_opt_id, dof_opt_id, property_ids, property_types, property_data, app_region)

Description:
This function creates an element property set.
Input:
STRING	prop_name[31]	This value specifies the name of the property set to be created.
INTEGER	elem_type_id	This value specifies the element type ID.
INTEGER	geo_opt_id	This value specifies the geometric option ID.
INTEGER	con_opt_id	This value specifies the condensation option ID.
INTEGER	for_opt_id	This value specifies the formulation option ID.
INTEGER	lam_opt_id	This value specifies the laminate option ID.
INTEGER	dof_opt_id	This value specifies the degree of freedom option ID.
INTEGER	property_ids()	This value specifies the property ID list.
INTEGER	property_types()	This value specifies the property data type list.
STRING	property_data[256]()
		This value specifies the property data.
STRING	app_region[]	This value specifies the application region.
Output:
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:
8107002	Last command aborted
13000004	Duplicate entry exists in table
13000020	Node not found
13000021	Element not found
13000022	Geometric entity not found
13000032	Point not found
13000041	Element not found
13000089	No default value found
13000090	Analysis code input was not found
13000091	Analysis type input was not found
13000097	Curve input was not found
13000098	Solid input was not found
13000119	The region specified in the query was not found
13000122	The surface requested was not found
13000125	The property entered does not exist.
13000127	The field entered does not exist.
13000184	The field is in use and cannot be deleted.
14000002	LpEval: Unknown evaluation method
14000003	LpSublistType: No sublist filter bits are set on invocation
14000004	LpSublistType: I am being invoked with a NULL list
14000005	LpSublistType: In the list being used, the current sublist has a nonatomic CAR
14000006	LpSublistType: In the list being used, the current geometry sublist is unclassifiable
14000007	LpSublistType: In the list being used, the current finite element sublist is unclassifiable
14000008	LpSublistType: In the list being used, the current token sublist is unclassifiable
14000009	LpSublistType: In the list being used, the current sublist is unclassifiable
14000010	LpSublistType: In the list being used, the current sublist does not match the sublist filter
14000014	LpSublistNext: Attempt to proceed past last sublist in current list
14000015	LpSublistNext: End of current list has been reached
14000308	LpEval: Memory exhausted preparing to evaluate pick
29001001	Unable to allocate the necessary memory.
29002007	The data entered for Property %A% cannot be parsed. %A%
29002008	The data entered for Property %A% is invalid. %A%
29002009	Property %A% requires a Spatial Scalar field. %A%
29002010	Property %A% requires a Spatial Vector field. %A%
29002011	A value for Property %A% must be entered. %A%
29002012	The data form for Property %A% is invalid. %A%
29002013	The data form for Property %A% is not recognized by the system. %A%
29002014	The material specified for property %A% is invalid. %A%
29002016	The value of property %A% is not in the valid range. %A%
29002025	The material specified for property %A% has an invalid Constitutive model activated. %A%
29002026	The material specified for property %A% has an invalid Directionality for this element type. %A%
29002037	The material specified for property %A% must be a laminate. %A%
29002038	Beam Section %A% not found.
29003001	Property Set %A% cannot be deleted.
29003002	The property set already exists.
29006003	The Property Set Name %A% is invalid.

Description:

This function creates an element property set.

Input:

STRING

prop_name[31]

This value specifies the name of the property set to be created.

INTEGER

elem_type_id

This value specifies the element type ID.

INTEGER

geo_opt_id

This value specifies the geometric option ID.

INTEGER

con_opt_id

This value specifies the condensation option ID.

INTEGER

for_opt_id

This value specifies the formulation option ID.

INTEGER

lam_opt_id

This value specifies the laminate option ID.

INTEGER

dof_opt_id

This value specifies the degree of freedom option ID.

INTEGER

property_ids()

This value specifies the property ID list.

INTEGER

property_types()

This value specifies the property data type list.

STRING

property_data[256]()

This value specifies the property data.

STRING

app_region[]

This value specifies the application region.

Output:

INTEGER

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:

8107002

Last command aborted

13000004

Duplicate entry exists in table

13000020

Node not found

13000021

Element not found

13000022

Geometric entity not found

13000032

Point not found

13000041

Element not found

13000089

No default value found

13000090

Analysis code input was not found

13000091

Analysis type input was not found

13000097

Curve input was not found

13000098

Solid input was not found

13000119

The region specified in the query was not found

13000122

The surface requested was not found

13000125

The property entered does not exist.

13000127

The field entered does not exist.

13000184

The field is in use and cannot be deleted.

14000002

LpEval: Unknown evaluation method

14000003

LpSublistType: No sublist filter bits are set on invocation

14000004

LpSublistType: I am being invoked with a NULL list

14000005

LpSublistType: In the list being used, the current sublist has a nonatomic CAR

14000006

LpSublistType: In the list being used, the current geometry sublist is unclassifiable

14000007

LpSublistType: In the list being used, the current finite element sublist is unclassifiable

14000008

LpSublistType: In the list being used, the current token sublist is unclassifiable

14000009

LpSublistType: In the list being used, the current sublist is unclassifiable

14000010

LpSublistType: In the list being used, the current sublist does not match the sublist filter

14000014

LpSublistNext: Attempt to proceed past last sublist in current list

14000015

LpSublistNext: End of current list has been reached

14000308

LpEval: Memory exhausted preparing to evaluate pick

29001001

Unable to allocate the necessary memory.

29002007

The data entered for Property %A% cannot be parsed. %A%

29002008

The data entered for Property %A% is invalid. %A%

29002009

Property %A% requires a Spatial Scalar field. %A%

29002010

Property %A% requires a Spatial Vector field. %A%

29002011

A value for Property %A% must be entered. %A%

29002012

The data form for Property %A% is invalid. %A%

29002013

The data form for Property %A% is not recognized by the system. %A%

29002014

The material specified for property %A% is invalid. %A%

29002016

The value of property %A% is not in the valid range. %A%

29002025

The material specified for property %A% has an invalid Constitutive model activated. %A%

29002026

The material specified for property %A% has an invalid Directionality for this element type. %A%

29002037

The material specified for property %A% must be a laminate. %A%

29002038

Beam Section %A% not found.

29003001

Property Set %A% cannot be deleted.

29003002

The property set already exists.

29006003

The Property Set Name %A% is invalid.

elementprops_compress	(nitems, compress_names, n_sig, combineDfem, del_comp, n_compressed, c_names)

Description:
Compress the list of property names. Compress means to find duplicates and merge them while replacing references.
Input:
INTEGER	nitems	Number properties selected.
STRING[32]()	compress_names	Array of property names selected (size = nitems)
INTEGER	n_sig	Number of signicant digits for REAL property comparision purposes.
LOGICAL	combineDfem	Flag whether to combine discrete fem fields referenced by properties. TRUE=combine, FALSE=do not combine.
LOGICAL	deleteComp	Flag whether to delete duplicates. TRUE=delete, FALSE=do not delete.
Output:
INTEGER	nCompressed	Number of actual properties compressed.
STRING[ 32]()	n_compressed c_names	Names of properties actually compressed
INTEGER	<Return Value>	0=success, other=error

Description:

Compress the list of property names. Compress means to find duplicates and merge them while replacing references.

Input:

INTEGER

nitems

Number properties selected.

STRING[32]()

compress_names

Array of property names selected (size = nitems)

INTEGER

n_sig

Number of signicant digits for REAL property comparision purposes.

LOGICAL

combineDfem

Flag whether to combine discrete fem fields referenced by properties. TRUE=combine, FALSE=do not combine.

LOGICAL

deleteComp

Flag whether to delete duplicates. TRUE=delete, FALSE=do not delete.

Output:

INTEGER

nCompressed

Number of actual properties compressed.

STRING[ 32]()

n_compressed c_names

Names of properties actually compressed

INTEGER

0=success, other=error

elementprops_delete	(prop_name)

Description:
This function deletes a list of element property sets.
Input:
STRING	prop_name[31]()	This value specifies the names of the element property sets to be deleted.
Output:
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:
-1	This is an internal status condition. There is no corresponding status message in the message database.

Description:

This function deletes a list of element property sets.

Input:

STRING

prop_name[31]()

This value specifies the names of the element property sets to be deleted.

Output:

INTEGER

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:

-1

This is an internal status condition. There is no corresponding status message in the message database.

This function can display a fatal popup message form with the following messages:

This function can display a warning popup message form with the following message:

This function can display an information popup message form with the following message:

elementprops_expand	(opt_flags, name_mod, nselected, selected )

Description:
Expand the property name(s). Expand means to create an individual property per element in the application region.
Input:
INTEGER	opt_flags	1 = do not delete original property set(s); use default property name: PropName.ElemID 17 = delete original property set(s); use default property name: PropName.ElemID 2 = do not delete original proprety set(2); use Prefix on new property names: Prefix.PropName.ElemID 18 = delete original property set(s); use Prefix on new property names: Prefix.PropName.ElemID 4 = do not delete original proprety set(2); use Suffix on new property names:PropName.ElemID.Suffix 20 = delete original property set(s); use Prefix on new property names: PropName.ElemID.Suffix
STRING	name_mod[32]	Prefix/Suffix name when choosing to name new property set(s), e.g.: Prefix.PropName.ElemID or PropName.ElemID.Suffix
INTEGER	nselected	The number of selected property sets to expand
STRING	selected[32](nselected)
		String array of the names of the selectect property sets to expand
Output:
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.

Description:

Expand the property name(s). Expand means to create an individual property per element in the application region.

Input:

INTEGER

opt_flags

1 = do not delete original property set(s); use default property name: PropName.ElemID

17 = delete original property set(s); use default property name: PropName.ElemID

2 = do not delete original proprety set(2); use Prefix on new property names: Prefix.PropName.ElemID

18 = delete original property set(s); use Prefix on new property names: Prefix.PropName.ElemID

4 = do not delete original proprety set(2); use Suffix on new property names:PropName.ElemID.Suffix

20 = delete original property set(s); use Prefix on new property names: PropName.ElemID.Suffix

STRING

name_mod[32]

Prefix/Suffix name when choosing to name new property set(s), e.g.: Prefix.PropName.ElemID or PropName.ElemID.Suffix

INTEGER

nselected

The number of selected property sets to expand

STRING

selected[32](nselected)

String array of the names of the selectect property sets to expand

Output:

INTEGER

This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.

The opt_flags argument is a single integer that is a sum of the desired options. The values are as listed below:

Use standard	PropName.ElemID	1
Add a	prefix.PropName.ElemID	2
Add a	PropName.ElemID.Suffix	4
Delete Original	Properties	16

Use standard

PropName.ElemID

Add a

prefix.PropName.ElemID

Add a

PropName.ElemID.Suffix

Delete Original

Properties

For example, to add a suffix, and delete the original property, opt_flags = 4+16 = 20

elementprops_modify	(prop_name, new_name, elem_type_id, geo_opt_id, con_opt_id, for_opt_id, lam_opt_id, dof_opt_id, property_ids, property_types, property_data, app_region)

Description:
This function modifies an existing element property set.
Input:
STRING	prop_name[31]	This value specifies the name of the property set to be modified.
STRING	new_name[31]	This value specifies the new name of the property set.
INTEGER	elem_type_id	This value specifies the element type ID.
INTEGER	geo_opt_id	This value specifies the geometric option ID.
INTEGER	con_opt_id	This value specifies the condensation option ID.
INTEGER	for_opt_id	This value specifies the formulation option ID.
INTEGER	lam_opt_id	This value specifies the laminate option ID.
INTEGER	dof_opt_id	This value specifies the degree of freedom option ID.
INTEGER	property_ids()	This value specifies the property ID list.
INTEGER	property_types()	This value specifies the property data type list.
STRING	property_data[256]()
		This value specifies the property data.
STRING	app_region[]	This value specifies the application region.
Output:
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:
8107002	Last command aborted
13000004	Duplicate entry exists in table
13000020	Node not found
13000021	Element not found
13000022	Geometric entity not found
13000032	Point not found
13000041	Element not found
13000089	No default value found
13000090	Analysis code input was not found
13000091	Analysis type input was not found
13000097	Curve input was not found
13000098	Solid input was not found
13000119	The region specified in the query was not found
13000122	The surface requested was not found
13000125	The property entered does not exist.
13000127	The field entered does not exist.
13000184	The field is in use and cannot be deleted.
14000002	LpEval: Unknown evaluation method
14000003	LpSublistType: No sublist filter bits are set on invocation
14000004	LpSublistType: I am being invoked with a NULL list
14000005	LpSublistType: In the list being used, the current sublist has a nonatomic CAR
14000006	LpSublistType: In the list being used, the current geometry sublist is unclassifiable
14000007	LpSublistType: In the list being used, the current finite element sublist is unclassifiable
14000008	LpSublistType: In the list being used, the current token sublist is unclassifiable
14000009	LpSublistType: In the list being used, the current sublist is unclassifiable
14000010	LpSublistType: In the list being used, the current sublist does not match the sublist filter
14000014	LpSublistNext: Attempt to proceed past last sublist in current list
14000015	LpSublistNext: End of current list has been reached
14000308	LpEval: Memory exhausted preparing to evaluate pick
29001001	Unable to allocate the necessary memory.
29002006	Property Set %A% Exists. Overwrite?
29002007	The data entered for Property %A% cannot be parsed. %A%
29002008	The data entered for Property %A% is invalid. %A%
29002009	Property %A% requires a Spatial Scalar field. %A%
29002010	Property %A% requires a Spatial Vector field. %A%
29002011	A value for Property %A% must be entered. %A%
29002012	The data form for Property %A% is invalid. %A%
29002013	The data form for Property %A% is not recognized by the system. %A%
29002014	The material specified for property %A% is invalid. %A%
29002016	The value of property %A% is not in the valid range. %A%
29002025	The material specified for property %A% has an invalid Constitutive model activated. %A%
29002026	The material specified for property %A% has an invalid Directionality for this element type. %A%
29002033	An error occurred while processing Property %A%. %A%
29002037	The material specified for property %A% must be a laminate. %A%
29002038	Beam Section %A% not found.
29006001	Property Set %A% does not exist and cannot be modified.
29006003	The Property Set Name %A% is invalid.

Description:

This function modifies an existing element property set.

Input:

STRING

prop_name[31]

This value specifies the name of the property set to be modified.

STRING

new_name[31]

This value specifies the new name of the property set.

INTEGER

elem_type_id

This value specifies the element type ID.

INTEGER

geo_opt_id

This value specifies the geometric option ID.

INTEGER

con_opt_id

This value specifies the condensation option ID.

INTEGER

for_opt_id

This value specifies the formulation option ID.

INTEGER

lam_opt_id

This value specifies the laminate option ID.

INTEGER

dof_opt_id

This value specifies the degree of freedom option ID.

INTEGER

property_ids()

This value specifies the property ID list.

INTEGER

property_types()

This value specifies the property data type list.

STRING

property_data[256]()

This value specifies the property data.

STRING

app_region[]

This value specifies the application region.

Output:

INTEGER

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:

8107002

Last command aborted

13000004

Duplicate entry exists in table

13000020

Node not found

13000021

Element not found

13000022

Geometric entity not found

13000032

Point not found

13000041

Element not found

13000089

No default value found

13000090

Analysis code input was not found

13000091

Analysis type input was not found

13000097

Curve input was not found

13000098

Solid input was not found

13000119

The region specified in the query was not found

13000122

The surface requested was not found

13000125

The property entered does not exist.

13000127

The field entered does not exist.

13000184

The field is in use and cannot be deleted.

14000002

LpEval: Unknown evaluation method

14000003

LpSublistType: No sublist filter bits are set on invocation

14000004

LpSublistType: I am being invoked with a NULL list

14000005

LpSublistType: In the list being used, the current sublist has a nonatomic CAR

14000006

LpSublistType: In the list being used, the current geometry sublist is unclassifiable

14000007

LpSublistType: In the list being used, the current finite element sublist is unclassifiable

14000008

LpSublistType: In the list being used, the current token sublist is unclassifiable

14000009

LpSublistType: In the list being used, the current sublist is unclassifiable

14000010

LpSublistType: In the list being used, the current sublist does not match the sublist filter

14000014

LpSublistNext: Attempt to proceed past last sublist in current list

14000015

LpSublistNext: End of current list has been reached

14000308

LpEval: Memory exhausted preparing to evaluate pick

29001001

Unable to allocate the necessary memory.

29002006

Property Set %A% Exists. Overwrite?

29002007

The data entered for Property %A% cannot be parsed. %A%

29002008

The data entered for Property %A% is invalid. %A%

29002009

Property %A% requires a Spatial Scalar field. %A%

29002010

Property %A% requires a Spatial Vector field. %A%

29002011

A value for Property %A% must be entered. %A%

29002012

The data form for Property %A% is invalid. %A%

29002013

The data form for Property %A% is not recognized by the system. %A%

29002014

The material specified for property %A% is invalid. %A%

29002016

The value of property %A% is not in the valid range. %A%

29002025

The material specified for property %A% has an invalid Constitutive model activated. %A%

29002026

The material specified for property %A% has an invalid Directionality for this element type. %A%

29002033

An error occurred while processing Property %A%. %A%

29002037

The material specified for property %A% must be a laminate. %A%

29002038

Beam Section %A% not found.

29006001

Property Set %A% does not exist and cannot be modified.

29006003

The Property Set Name %A% is invalid.

elementprops_show	(prop_name, display_type, group_names)

Description:
This function displays the element property values.
Input:
STRING	prop_name[31]	This value specifies the name of the property to be displayed.
STRING	display_type[31]	This value specifies the form of the display: “Table”, “Marker Plot”, “Vector Plot”, or “Scalar Plot”.
STRING	group_names[31]()
		This value specifies a list of the group names to display on.
Output:
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:
8107002	Last command aborted
11000050	The group name is invalid.
11000098	A fatal error has occurred in the database. Database is corrupted.
11000105	The specified group was not found in the database.
11000143	The specified vector result table was not found.
13000008	Group not found

Description:

This function displays the element property values.

Input:

STRING

prop_name[31]

This value specifies the name of the property to be displayed.

STRING

display_type[31]

This value specifies the form of the display: “Table”, “Marker Plot”, “Vector Plot”, or “Scalar Plot”.

STRING

group_names[31]()

This value specifies a list of the group names to display on.

Output:

INTEGER

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:

8107002

Last command aborted

11000050

The group name is invalid.

11000098

A fatal error has occurred in the database. Database is corrupted.

11000105

The specified group was not found in the database.

11000143

The specified vector result table was not found.

13000008

Group not found