PrepareTools

class ansys.geometry.core.tools.prepare_tools.PrepareTools(grpc_client: ansys.geometry.core.connection.GrpcClient)

Prepare tools for PyAnsys Geometry.

Parameters:

grpc_clientGrpcClient

Active supporting geometry service instance for design modeling.

Overview

Methods

extract_volume_from_faces	Extract a volume from input faces.
extract_volume_from_edge_loops	Extract a volume from input edge loops.
remove_rounds	Remove rounds from geometry.
share_topology	Share topology between the chosen bodies.
enhanced_share_topology	Share topology between the chosen bodies.
find_logos	Detect logos in geometry.
find_and_remove_logos	Detect and remove logos in geometry.

Import detail

from ansys.geometry.core.tools.prepare_tools import PrepareTools

Method detail

PrepareTools.extract_volume_from_faces(sealing_faces: list[ansys.geometry.core.designer.face.Face], inside_faces: list[ansys.geometry.core.designer.face.Face]) → list[ansys.geometry.core.designer.body.Body]

Extract a volume from input faces.

Creates a volume (typically a flow volume) from a list of faces that seal the volume and one or more faces that define the wetted surface (inside faces of the solid).

Parameters:

sealing_faceslist[Face]

List of faces that seal the volume.

inside_faceslist[Face]

List of faces that define the interior of the solid.

Returns:

list[Body]

List of created bodies.

Warning

This method is only available starting on Ansys release 25R1.

PrepareTools.extract_volume_from_edge_loops(sealing_edges: list[ansys.geometry.core.designer.edge.Edge], inside_faces: list[ansys.geometry.core.designer.face.Face] = None) → list[ansys.geometry.core.designer.body.Body]

Extract a volume from input edge loops.

Creates a volume (typically a flow volume) from a list of edge loops that seal the volume. and one or more faces that define the wetted surface (inside faces of the solid).

Parameters:

sealing_edgeslist[Edge]

List of faces that seal the volume.

inside_faceslist[Face], optional

List of faces that define the interior of the solid (not always necessary).

Returns:

list[Body]

List of created bodies.

Warning

This method is only available starting on Ansys release 25R1.

PrepareTools.remove_rounds(faces: list[ansys.geometry.core.designer.face.Face], auto_shrink: bool = False) → bool

Remove rounds from geometry.

Tries to remove rounds from geometry. Faces to be removed are input to the method.

Parameters:

round_faceslist[Face]

List of rounds faces to be removed

auto_shrinkbool, default: False

Whether to shrink the geometry after removing rounds. Fills in the gaps left by the removed rounds.

Returns:

bool

True if successful, False if failed.

PrepareTools.share_topology(bodies: list[ansys.geometry.core.designer.body.Body], tol: ansys.geometry.core.typing.Real = 0.0, preserve_instances: bool = False) → bool

Share topology between the chosen bodies.

Parameters:

bodieslist[Body]

List of bodies to share topology between.

tolReal

Maximum distance between bodies.

preserve_instancesbool

Whether instances are preserved.

Returns:

bool

True if successful, False if failed.

Warning

This method is only available starting on Ansys release 24R2.

PrepareTools.enhanced_share_topology(bodies: list[ansys.geometry.core.designer.body.Body], tol: ansys.geometry.core.typing.Real = 0.0, preserve_instances: bool = False) → ansys.geometry.core.tools.repair_tool_message.RepairToolMessage

Share topology between the chosen bodies.

Parameters:

bodieslist[Body]

List of bodies to share topology between.

tolReal

Maximum distance between bodies.

preserve_instancesbool

Whether instances are preserved.

Returns:

RepairToolMessage

Message containing number of problem areas found/fixed, created and/or modified bodies.

Warning

This method is only available starting on Ansys release 25R2.

PrepareTools.find_logos(bodies: list[ansys.geometry.core.designer.body.Body] = None, min_height: ansys.geometry.core.typing.Real = None, max_height: ansys.geometry.core.typing.Real = None) → ansys.geometry.core.tools.problem_areas.LogoProblemArea

Detect logos in geometry.

Detects logos, using a list of bodies if provided. The logos are returned as a list of faces.

Parameters:

bodieslist[Body], optional

List of bodies where logos should be detected

min_heightreal, optional

The minimum height when searching for logos

max_height: real, optional

The minimum height when searching for logos

Returns:

LogoProblemArea

Problem area with logo faces.

Warning

This method is only available starting on Ansys release 25R2.

PrepareTools.find_and_remove_logos(bodies: list[ansys.geometry.core.designer.body.Body] = None, min_height: ansys.geometry.core.typing.Real = None, max_height: ansys.geometry.core.typing.Real = None) → bool

Detect and remove logos in geometry.

Detects and remove logos, using a list of bodies if provided.

Parameters:

bodieslist[Body], optional

List of bodies where logos should be detected and removed.

min_heightreal, optional

The minimum height when searching for logos

max_height: real, optional

The minimum height when searching for logos

Returns:

Boolean value indicating whether the operation was successful.

Warning

This method is only available starting on Ansys release 25R2.