Skip to main content

Prime Mesh Python client library 2026 R1

wrap

Last update: 02.04.2026

Mesh.wrap(min_size=None, max_size=None, growth_rate=1.2, elements_per_gap=None, normal_angle=18.0, input_parts='*', input_labels='*', keep_inputs=False, region_extract=WrapRegion.EXTERNAL, material_point=None, extract_features=True, create_intersection_loops=False, use_existing_features=False, enable_feature_octree_refinement=True, feature_angle=40.0, contact_prevention_size=None, number_of_threads=None, remesh_postwrap=True, recompute_remesh_sizes=False, use_existing_size_fields=False, size_fields=None, wrap_size_controls=None, remesh_size_controls=None, feature_recovery_params=None, contact_prevention_params=None, leak_prevention_params=None)

Wrap and remesh the input.

The default behavior is to perform an external wrap of all parts in the model using curvature sizing and extracting features. The wrap is then remeshed to provide a surface mesh for the extracted region.

Geodesic sizing is used only if soft and curvature controls are set. If contact prevention size is set and geodesic sizing is available, contact detection is used globally.

If minimum and maximum sizes are provided, variable size mesh is generated between the minimum size and maximum size by applying sizes based on curvature.

If either minimum size or maximum size is provided, constant size mesh is generated with the provided size.

If neither minimum size or maximum size is provided, global minimum and maximum settings are used to generate a variable size mesh based on curvature.

Parameters:

min_size

Minimum edge length of the mesh. The default is None.

max_size

Maximum edge length of the mesh. The default is None.

growth_rate

Growth rate. The default is 1.2.

elements_per_gap

Global proximity size control elements per gap with self proximity. The default is None.

normal_angle

Global curvature size control normal angle. The default is 18.0.

input_parts

Parts to wrap. The default is "*".

input_labels

Labels to wrap. The default is "*".

keep_inputs

Whether to retain inputs. The default is False.

region_extract

Region to wrap. The default is prime.WrapRegion.EXTERNAL.

material_point

Material point if the region extraction method is set to material point. The default is None.

extract_features

Whether to extract feature edges using the feature angle. The default is True.

create_intersection_loops

Whether to create intersection loops between all parts. The default is False.

use_existing_features

Whether to maintain existing features on parts. The default is False.

enable_feature_octree_refinement: bool, optional

Whether to apply refinement to feature edges during the wrap. The default is True.

feature_angle

Angle to use for extracting features. The default is 40.0.

contact_prevention_size

Global proximity size controls between all parts. The default is None.

number_of_threads

Number of threads. The default is None.

remesh_postwrap

Whether to remesh the wrap. The default is True.

recompute_remesh_sizes

Whether to recompute sizes from global controls using the wrap surface. The default is False.

use_existing_size_fields

Whether to use precomputed size fields. The default is False.

size_fields

List of size fields to use. The default is None.

wrap_size_controls

List of wrap size controls to use. The default is None.

remesh_size_controls

List of remesh size controls to use. The default is None.

feature_recovery_params

List of feature recovery parameters to use. The default is None.

contact_prevention_params

List of contact prevention parameters to use. The default is None.

leak_prevention_params

List of leak prevention parameters to use. The default is None.

Returns:

Wrapped part Returns Part.

Examples

>>> import ansys.meshing.prime as prime
>>> from ansys.meshing.prime import lucid
>>> prime_client = prime.launch_prime()
>>> model = prime_client.model
>>> mesh = lucid.Mesh(model)
>>> mesh.read("/my_geometry.stl")
>>> mesh.wrap(min_size=1, max_size=20, create_intersection_loops=True)
>>> mesh.write("/mesh_output.pmdat")
>>> prime_client.exit()

Connect with Ansys