ACP in-app scripting API 2026 R1

SamplingPoint

Last update: 16.07.2026

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

The sampling point enables picking through the laminate at a certain point to run detailed analyses.

Key features: : - Layup in the object tree of the closest element to the selected point.

  • Sampling direction defines the ply order (bottom-up or top-down).
  • Reference direction defines the 0 degree axis of the element used for the evaluations (CLT).
  • Optional a user-defined coordinate system can be selected to compute the reference direction. The element normal and reference direction. defines the result coordinate system.
  • 2D plots showing the layup, stress, strain and failure distribution through the laminate.
  • Polar plot of the laminate properties.
  • Analysis based on the Classical Laminate Theory (CLT).
  • Export to ESAComp, CSV file, etc.

Usage

>>> model.create_sampling_point(name='Sampling Point')

Attributes

Name Description
SamplingPoint.active Active status of the object.
SamplingPoint.consider_coupling_effect Whether to consider coupling effects (B-Matrix) for the calculation of the laminate engineering constants.
SamplingPoint.direction Sampling point Direction.
SamplingPoint.element_id Element ID (label) of the sampling point.
SamplingPoint.enabled Whether this object is currently enabled.
SamplingPoint.graph_plot Graph Plot object used to configure 2D plots.
SamplingPoint.id ID of the object.
SamplingPoint.is_dict_item Indicates whether the object is an item in a dictionary.
SamplingPoint.is_list_item Indicates whether the object is an item of a list.
SamplingPoint.link_path Root path of the current node in the tree for links to this object.
SamplingPoint.locked Sampling point is generated from an imported source and cannot be changed.
SamplingPoint.name Name of the object.
SamplingPoint.offset_is_middle Whether to offset the reference surface to the mid-plane of the laminate.
SamplingPoint.parent Parent object in the tree.
SamplingPoint.plies Plies of the sampling point.
SamplingPoint.point Sampling point.
SamplingPoint.reference_direction Reference direction.
SamplingPoint.root_path Root path of the current node in the tree.
SamplingPoint.rosette Rosette of the sampling point.
SamplingPoint.solution_set Solution and Set selection.
SamplingPoint.status Status of the object.
SamplingPoint.status_changed Boolean flag which is set to true in C++ when up-to-date status of object changes.
SamplingPoint.uid UID of the object.
SamplingPoint.use_default_reference_direction Flag to use default reference direction.
SamplingPoint.vertex Raises an error if the object has been removed from the graph.

Methods

Name Description
SamplingPoint.aligned() Returns true if the sampling direction is aligned with the normal direction of the closest element.
SamplingPoint.capture_analysis_plot([path, size]) Saves the sampling point analysis plot to a file.
SamplingPoint.clt_query([query, ...]) Returns the properties of the classical laminate theory:.
SamplingPoint.create_plot([query, ...]) Generates 2D plots with the results of interest.
SamplingPoint.export_laminate(filename[, ...])
SamplingPoint.find_parent(type) Steps up the tree and returns the first parent with given type.
SamplingPoint.obj_exists() Checks if __obj still references the c++ object (has not been reset to None by self._delete) and exists in the graph.
SamplingPoint.serialize()
SamplingPoint.serialize_name_and_id() Serializes the name and ID.
SamplingPoint.update()
SamplingPoint.update_plot(offset_is_middle, ...) Updates the 2D plot.
SamplingPoint.visit(visitor) Walk through the tree and let the visitor perform action on every descendant node.

Connect with Ansys