Skip to main content

ACP scripting interface 2025 R2

Material

Last update: 16.07.2025

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

ComPoLyX material class.

This class enables retrieving all material properties defined within 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 object
Material.active_properties List of the active properties for the underlying material
Material.enabled Whether this object is currently enabled or not
Material.ext_id ID of corresponding Material in external source
Material.id ID of object
Material.is_constant True if engineering constants are constant
Material.is_dict_item Specifies whether the object is an item of a dict
Material.is_isotropic True if ply_type is isotropic or isotropic_homogeneous_core
Material.is_list_item Specifies 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 object
Material.parent Parent object in 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 object
Material.vertex This will throw 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) Function steps up the tree and returns the first parent with given type
Material.obj_exists() Checks if __obj still references the C++ object (i.e. 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() Helper function to serialize 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