Skip to main content
Version: 2026R2

UserDefinedData

class compolyx.plot_data.UserDefinedData(graph, obj, parent=None, display_data=None)

Attributes

NameDescription
UserDefinedData.activeWhether the plot is active or not; an inactive plot is not updated and it does not contain data
UserDefinedData.active_display_dataReturns a dictionary containing display data for this plot owned by the active scene
UserDefinedData.all_display_dataReturns a list of all display data classes in existence for this object
UserDefinedData.changedStatus boolean
UserDefinedData.color_table
UserDefinedData.componentThe requested result component for a specific plot, e.g. s1 for the stress in the 1-direction
UserDefinedData.componentsReturn the possible component set on this plot type
UserDefinedData.data_scopeData scope of the plot where results will be evaluated
UserDefinedData.definition_id
UserDefinedData.description_changedStatus boolean
UserDefinedData.enabledWhether this object is currently enabled or not
UserDefinedData.eval_positionThe finite element position at which the results are given, e.g. centroid or nodal
UserDefinedData.has_element_wiseWhether the plot offers element-wise data
UserDefinedData.has_ply_wiseWhether the plot offers ply-wise data
UserDefinedData.idID of object
UserDefinedData.is_dict_itemSpecifies whether the object is an item of a dict
UserDefinedData.is_list_itemSpecifies whether the object is an item of a list
UserDefinedData.link_pathRoot path of the current node in the tree for links to this object
UserDefinedData.lockedReturns the locked status of the plot
UserDefinedData.minmaxMin and max value of current data
UserDefinedData.minmax_last_queryMin and max value of data of last query
UserDefinedData.nameName of object
UserDefinedData.parentParent object in tree
UserDefinedData.ply_offset_scale_factorOffset scale factor
UserDefinedData.ply_wiseWhether to plot ply-wise or element-wise
UserDefinedData.requires_solution
UserDefinedData.root_pathRoot path of the current node in the tree
UserDefinedData.scope_entire_modelWhether the plot scope is the entire model or a subset defined by the data_scope
UserDefinedData.show_on_solidsWhether to plot results on solid or shell elements
UserDefinedData.show_ply_offsets
UserDefinedData.show_user_textWhether to show the user-defined text labels or not
UserDefinedData.solutionSolution underlying the plot
UserDefinedData.solution_setSolution Set selection
UserDefinedData.spotNot applicable to a user-defined plot
UserDefinedData.spotsReturn the possible spot set on this plot type
UserDefinedData.statusStatus of the object
UserDefinedData.status_changedBoolean flag which is set to true in C++ when up-to-date status of object changes
UserDefinedData.text_thresholdThreshold above/below which user text is hidden
UserDefinedData.text_threshold_type"show_all" (default), "show_only_values_above_threshold", "show_only_values_below_threshold
UserDefinedData.uidUID of object
UserDefinedData.updatedStatus boolean
UserDefinedData.uptodateWhether the plot is uptodate
UserDefinedData.user_dataAccess to the user-defined data of the plot
UserDefinedData.user_element_centroidsRetrieve the centroids of the elements consistent with the current user element indices/labels
UserDefinedData.user_element_indicesAccess the indices for the given data-scope
UserDefinedData.user_element_labelsAccess the labels for the given data-scope
UserDefinedData.user_scriptBody of the script to be executed is user_script_enabled is set to True
UserDefinedData.user_script_enabledWhether to run a custom script on update
UserDefinedData.user_textAccess to the user-defined text of the plot
UserDefinedData.vertexThis will throw an error if the object has been removed from the graph

Methods

NameDescription
UserDefinedData.add_data_scope_entity(entity)Add 1 entity to the Data Scope of a plot
UserDefinedData.clear_data_scope()Cleares the complete data scope of a plot, i.e. all scope entities are removed at once
UserDefinedData.display_data_create([parent])Function for internal use, not meant for scripting
UserDefinedData.find_parent(type)Function steps up the tree and returns the first parent with given type
UserDefinedData.get_data([visible, selected])Get data of plot
UserDefinedData.get_deformations([visible, ...])Function used internally to query matching nodal deformations for a given plot
UserDefinedData.get_element_indices([...])Get element indices (ACP internal element numbers starting from 0) of plot
UserDefinedData.get_element_labels([...])Get element labels (element numbers as read from / written to mesh files) of plot
UserDefinedData.get_full_description()This function returns information displayed together with the legend
UserDefinedData.get_ply_offsets([visible, ...])Get the offset between plies and reference surface
UserDefinedData.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
UserDefinedData.remove_data_scope_entity(entity)Remove 1 entity to the Data Scope of a plot
UserDefinedData.serialize()Serialize to Python string
UserDefinedData.serialize_create_function()
UserDefinedData.serialize_name_and_id()Helper function to serialize name and ID
UserDefinedData.serialize_properties()Serialize to Python string
UserDefinedData.serialize_python_only_attributes()
UserDefinedData.update()
UserDefinedData.user_script_default()
UserDefinedData.visit(visitor)Walk through the tree and let the visitor perform action on every descendant node