SamplingPoint#

class ansys.dpf.composites.sampling_point.SamplingPoint(*args, **kwargs)#

Implements the Sampling Point object that wraps the DPF sampling point operator.

Use CompositeModel.get_sampling_point() to get a sampling point object. This class provides for plotting the lay-up and results at a certain point of the layered structure. The results, including analysis_plies, e1, s12, and failure_modes, are always from the bottom to the top of the laminate (along the element normal direction). Postprocessing results such as e1 are returned as flat arrays where self.spots_per_ply can be used to compute the index for a certain ply.

Notes

The results of layered elements are stored per integration point. A layered shell element has a number of in-plane integration points (depending on the integration scheme) and typically three integration points through the thickness. The through-the-thickness integration points are called spots. They are typically at the BOTTOM, MIDDLE, and TOP of the layer. This notation is used here to identify the corresponding data.

The SamplingPoint class returns three results per layer (one for each spot) because the results of the in-plane integration points are interpolated to the centroid of the element. The following table shows an example of a laminate with three layers. So a result, such as s1 has nine values, three for each ply.

Layer	Index	Spot
Layer 3	8 7 6	TOP of Layer 3 MIDDLE of Layer 3 BOTTOM of Layer 3
Layer 2	5 4 3	TOP of Layer 2 MIDDLE of Layer 2 BOTTOM of Layer 2
Layer 1	2 1 0	TOP of Layer 1 MIDDLE of Layer 1 BOTTOM of Layer 1

The get_indices and get_offsets_by_spots methods simplify the indexing and filtering of the data.

Methods

`SamplingPoint.add_ply_sequence_to_plot`(axes)	Add the stacking (ply and text) to an axis or plot.
`SamplingPoint.add_results_to_plot`(axes, ...)	Add results (strain, stress, or failure values) to an `Axes` object.
`SamplingPoint.get_indices`([spots])	Get the indices of the selected spots (interfaces) for each ply.
`SamplingPoint.get_offsets_by_spots`([spots, ...])	Access the y coordinates of the selected spots (interfaces) for each ply.
`SamplingPoint.get_ply_wise_critical_failures`()	Get the critical failure value and modes per ply.
`SamplingPoint.get_polar_plot`([components])	Create a standard polar plot to visualize the polar properties of the laminate.
`SamplingPoint.get_result_plots`([...])	Generate a figure with a grid of axes (plot) for each selected result entity.

Attributes

`SamplingPoint.analysis_plies`	List of analysis plies from the bottom to the top.
`SamplingPoint.e1`	Strains in the material 1 direction of each ply.
`SamplingPoint.e12`	In-plane shear strains e12 of each ply.
`SamplingPoint.e13`	Out-of-plane shear strains e13 of each ply.
`SamplingPoint.e2`	Strains in the material 2 direction of each ply.
`SamplingPoint.e23`	Out-of-plane shear strains e23 of each ply.
`SamplingPoint.e3`	Strains in the material 3 direction of each ply.
`SamplingPoint.element_id`	Element label for sampling the laminate.
`SamplingPoint.failure_modes`	Critical failure mode of each ply.
`SamplingPoint.inverse_reserve_factor`	Critical inverse reserve factor of each ply.
`SamplingPoint.is_uptodate`	True if the Sampling Point is up-to-date.
`SamplingPoint.margin_of_safety`	Lowest margin of safety of each ply.
`SamplingPoint.name`	Name of the object.
`SamplingPoint.number_of_plies`	Number of plies.
`SamplingPoint.offsets`	Z coordinates for each interface and ply.
`SamplingPoint.polar_properties_E1`	Polar property E1 of the laminate.
`SamplingPoint.polar_properties_E2`	Polar property E2 of the laminate.
`SamplingPoint.polar_properties_G12`	Polar property G12 of the laminate.
`SamplingPoint.reserve_factor`	Lowest reserve factor of each ply.
`SamplingPoint.results`	Results of the sampling point results as a JSON dictionary.
`SamplingPoint.s1`	Stresses in the material 1 direction of each ply.
`SamplingPoint.s12`	In-plane shear stresses s12 of each ply.
`SamplingPoint.s13`	Out-of-plane shear stresses s13 of each ply.
`SamplingPoint.s2`	Stresses in the material 2 direction of each ply.
`SamplingPoint.s23`	Out-of-plane shear stresses s23 of each ply.
`SamplingPoint.s3`	Stresses in the material 3 direction of each ply.
`SamplingPoint.spots_per_ply`	Number of through-the-thickness integration points per ply.