Skip to main content

ACP in-app scripting API 2026 R1

Material

Last update: 16.07.2026

class compolyx.Material(graph, obj, parent=None)

Represents a material.

Provides access to all material properties defined in the loaded finite element model.

Access

>>> import compolyx
>>> db = compolyx.DB()
>>> model = db.models['class40.1']
>>> materials = model.material_data.materials
>>> mat_UD300 = materials['UD300_GLAS']
>>> print mat_UD300.property_names

[‘density’, ‘engineering_constants’, ‘larc_constants’, ‘puck_constants’, ‘strain_limits’, ‘stress_limits’, ‘thermal_expansion_coefficients’, ‘tsai_wu_constants’, ‘woven_characterization’, ‘woven_puck_constants_1’, ‘woven_puck_constants_2’, ‘woven_stress_limits_1’, ‘woven_stress_limits_2’]

>>> property_set_eng_const = mat_UD300['engineering_constants']

Attributes

Name Description
Material.active Active status of the object.
Material.active_properties List of the active properties for the underlying material.
Material.enabled Indicates whether the object is enabled.
Material.ext_id ID of corresponding Material in external source.
Material.id ID of the object.
Material.is_constant True if engineering constants are constant.
Material.is_dict_item Indicates whether the object is an item in a dictionary.
Material.is_isotropic True if ply_type is isotropic or isotropic_homogeneous_core.
Material.is_list_item Indicates whether the object is an item of a list.
Material.link_path Root path of the current node in the tree for links to this object.
Material.locked Material is generated from an external source and cannot be changed.
Material.name Name of the object.
Material.parent Parent object in the tree.
Material.ply_type Ply type.
Material.property_names List with all available property keys.
Material.root_path Root path of the current node in the tree.
Material.status Status of the object.
Material.status_changed Boolean flag which is set to true in C++ when up-to-date status of object changes.
Material.uid UID of the object.
Material.vertex Raises an error if the object has been removed from the graph.

Methods

Name Description
Material.create_property_set(property_name, ...) Function to create a specific property set.
Material.delete_property_set(property_name) Function to delete a specific property set.
Material.find_parent(type) Steps up the tree and returns the first parent with given type.
Material.obj_exists() Checks if __obj still references the c++ object (has not been reset to None by self._delete) and exists in the graph.
Material.serialize() Serialize to Python string.
Material.serialize_name_and_id() Serializes the name and ID.
Material.update()
Material.visit(visitor) Walk through the tree and let the visitor perform action on every descendant node.

Connect with Ansys