Connect to ANSYS Mechanical via gRPC. Args: port: gRPC port reported by Workbench (changes every session)

Disconnect from Mechanical, leaving the session running. Args: shutdown (True also closes Mechanical itself - unsaved work is lost)

Check connection status.

Get model info: bodies, named selections, analyses.

List all materials in Engineering Data.

Assign material to a body. Args: body_name, material_name

Set global mesh element size in mm. Args: element_size_mm

Generate mesh. Visible live in Mechanical GUI.

Get mesh node and element counts.

Add Fixed Support to a named selection. Args: named_selection, analysis_index

Add Force load in Newtons. Args: named_selection, fx_n, fy_n, fz_n, analysis_index

Add Pressure load in Pascals. Args: named_selection, magnitude_pa, analysis_index

List all boundary conditions. Args: analysis_index

Solve the analysis. Progress visible in GUI. Returns solver messages. Args: analysis_index, wait (False submits and returns at once - then poll get_solve_status; use it for solves longer than the client call timeout)

Get solve status. Args: analysis_index

Add Total Deformation for all modal modes. Args: num_modes, analysis_index

Add Total Deformation result. Args: mode (0=not modal), analysis_index

Get natural frequencies from a modal analysis.

Frequencies are only readable through result objects. When none exist the tool used to return an empty list with ok:true, which reads as "this model has no modes" rather than "nobody asked for the results yet". Args: analysis_index, add_results_if_missing (add Total Deformation results and evaluate them when the solution has none)

Generate simulation report. Args: output_path, analysis_index, fmt (docx or txt)

Run custom Python script inside Mechanical ACT API. Args: script

List all named selections with face/body counts.

Delete a named selection by name. Args: name

Suppress or unsuppress bodies by name prefix (empty = all bodies). Args: name_prefix, suppress (True=suppress, False=unsuppress)

List all Point Masses with CG, mass, pinball and scoped named selection.

Add Frictionless Support. Args: named_selection, analysis_index

Add Displacement BC. Pass None for a DOF to leave it free. Args: named_selection, x_mm, y_mm, z_mm (None=free), analysis_index

Add Remote Displacement BC. Pass None for a DOF to leave it free. Args: named_selection, x_mm, y_mm, z_mm, rot_x_deg, rot_y_deg, rot_z_deg, analysis_index

Add Standard Earth Gravity. Direction vector defaults to -Y (down). Args: analysis_index, x_component, y_component, z_component (unit vector)

Add Remote Force load. Args: named_selection, fx_n, fy_n, fz_n, analysis_index

Add Moment load in N·m. Args: named_selection, mx_nm, my_nm, mz_nm, analysis_index

Add Equivalent (von Mises) Stress result, optionally scoped to a named selection. Args: named_selection (empty = whole model), analysis_index

Add Directional Deformation result. Args: axis (X/Y/Z), named_selection, analysis_index

Add Principal Stress result. Args: which (max/mid/min), analysis_index

Add Stress Tool (safety factor, stress ratio) using material limits. Args: analysis_index

Add Force Reaction probe at a named selection. Args: named_selection, analysis_index

Convert all unsuppressed bodies whose name starts with body_name_prefix to a combined Point Mass, then create a Named Selection of all coplanar attachment faces on the nearest structural surface. No ACT extensions required. Args: body_name_prefix, proximity_multiplier (default 3.0)

Convert all unsuppressed bodies inside a named Part to a combined Point Mass, then create a Named Selection of all coplanar attachment faces on the nearest structural surface. No ACT extensions required. Args: part_name, proximity_multiplier (default 3.0)