Check whether the Abaqus-side socket bridge is reachable.

Return a concise human-readable bridge status.

Execute Python code in the active Abaqus/CAE kernel.

Single-line expressions are evaluated and returned. Multi-line scripts are executed; set a variable named result to return structured data.

Compatibility wrapper around run_python that returns stdout/text.

Change the current Abaqus working directory.

Get parts, materials, steps, loads, BCs, interactions, jobs, and viewports.

List all Abaqus jobs in the current CAE session.

Submit an existing Abaqus job and wait for completion.

Inspect job objects and tail .sta/.msg diagnostics. Set diagnose=True for full solver-log analysis.

Run a comprehensive solver-log diagnosis on a job's output files.

Scans .sta, .msg, .dat, .log files for 40+ known error/warning patterns across 14 categories: license, convergence, model setup, contact, material, resources, environment, ODB, syntax, explicit, output, scripting, mesh, and general.

Returns a structured Markdown diagnostic panel with severity markers, source file references, and actionable fix suggestions.

Open an ODB read-only and return metadata about steps, frames, and outputs.

Compatibility wrapper for inspect_odb returning formatted JSON.

Extract KPIs from an ODB file using declarative queries.

queries is a JSON array of query objects, each with:

• query_id (str): unique identifier for this KPI

• field (str): field output name, e.g. "S", "U", "RF", "PEEQ", "NT"

• component (str, optional): e.g. "Mises", "U1", "S11", "RF2"

• invariant (str, optional): e.g. "Mises", "MaxPrincipal", "Tresca"

• step (str, optional): step name, default first step

• frame (str, optional): "last", "first", or frame index, default "last"

• aggregation (str, optional): max, min, sum, avg, range, abs_max, default "max"

• region (str, optional): node/element set name, default ALL

Example queries JSON: [ {"query_id": "max_stress", "field": "S", "invariant": "Mises", "aggregation": "max"}, {"query_id": "max_disp", "field": "U", "component": "Magnitude", "aggregation": "max"}, {"query_id": "rf_sum", "field": "RF", "component": "RF2", "aggregation": "sum", "region": "FIXED_END"} ]

Returns a structured Markdown KPI report.

Capture current Abaqus session state into an experiment capsule.

Saves model info, job status, output file inventory, and Abaqus version for reproducibility and later comparison.

Args: capsule_id: Unique identifier for this capsule (e.g. "baseline_v1"). notes: Optional description of this run.

List all saved experiment capsules.

Load a saved experiment capsule by ID.

Delete a saved experiment capsule.

Compare two experiment capsules and show differences.

Check physics contracts against KPI values from a capsule or direct JSON.

Validates that simulation results meet design requirements defined as contracts (range, threshold, exact, pct_change). Supports two modes:

1. Direct mode: provide contracts_json and kpis_json directly.

2. Capsule mode: provide contracts_json and capsule_id to load KPIs from a previously saved experiment capsule.

Args: contracts_json: JSON array of contract dicts. Each dict must have contract_id, kpi_name, contract_type. Optional: expected, tolerance, severity, description. kpis_json: JSON object mapping KPI names to values, e.g. {"max_stress": 345.6}. Required if capsule_id is empty. capsule_id: Load KPIs from this capsule instead of kpis_json.

Contract types: - range: value must be within [min, max] - threshold_gt: value must be greater than X - threshold_lt: value must be less than X - exact: value must equal X (within tolerance) - pct_change: change from baseline must be within X%

Returns: Markdown-formatted contract validation report.

Generate a comprehensive simulation report in Markdown format.

Combines capsule snapshot, KPI lens results, physics contracts validation, solver diagnosis, and silent failure detection into a single structured report. Supports two modes:

1. Full mode: provide capsule_id (and optionally contracts_json). The report will include model info, job status, KPIs, solver diagnosis, and contract validation from the capsule.

2. Quick mode: provide contracts_json and kpis_json directly (uses check_physics_contracts internally).

Args: capsule_id: Load data from this capsule. If provided, the report includes model info, job status, KPIs, and diagnosis from the capsule. contracts_json: JSON array of contract dicts to validate against capsule KPIs. Only used when capsule_id is provided. report_title: Title for the report. output_path: If provided, save the report to this file path. Otherwise, return the report as text. include_silent_failures: If True, run silent-failure checks on the model and include the results in the report.

Returns: The generated report as Markdown text, or a confirmation message if output_path is provided.

Capture an Abaqus viewport as base64 image data.

Compatibility wrapper returning a data URI for the requested viewport.

Run silent-failure checks on the current Abaqus model.

Detects 7 categories of model issues that Abaqus does not report as errors:

1. Mesh integrity: parts with zero elements, unmeshable hex requests

2. Constraint coverage: tie constraints that may silently drop nodes

3. Volume/logic: cut operations that removed nothing, degenerate geometry

4. Contact validity: contact pairs without adjacency

5. Element quality: risky elements (C3D8R hourglass), hourglass-prone configs

6. Job output: completed jobs with no ODB, meaningless exit codes

7. Unconstrained parts: instances free to undergo rigid body motion

These checks measure the model you built, not just the answer it produced.

Args: model_name: Name of the model to check (default: first available model). workdir: Working directory for job output checks (default: current).

Returns: Structured Markdown report with pass/fail/warning findings.

Quick model integrity check: mesh, constraints, contacts, volumes.

A fast subset of check_silent_failures focused on the most common silent failures. Runs the same checks but returns a compact format.

Use this after building a model and before submitting a job.

Args: model_name: Name of the model to check (default: first available model).

Returns: Compact text report of findings.

Get auto-fix suggestions for convergence problems diagnosed by the Solver Doctor.

Supports two modes:

1. From diagnosis: pass the result of diagnose_job as diagnosis_result (JSON string). The advisor extracts error/warning patterns and returns ranked fix suggestions.

2. Direct: pass comma-separated pattern_ids to get advice for specific patterns.

Each suggestion includes:

• Priority (1 = try first, 5 = last resort)

• Risk level (low/medium/high)

• Code template for the fix (where applicable)

• Description of what to do

Patterns supported: too_many_attempts, time_increment_too_small, maximum_increments_exceeded, negative_eigenvalues, rigid_body_motion, contact_overclosure, excessive_distortion, explicit_stable_time_too_small, zero_pivot, material_instability, excessive_pivot_ratio.

Args: diagnosis_result: JSON string from diagnose_job output. If provided, pattern_ids is ignored. pattern_ids: Comma-separated pattern IDs (e.g., "too_many_attempts,rigid_body_motion"). Only used if diagnosis_result is empty.

Returns: Markdown-formatted fix suggestions with priority and risk levels.

Create a linear elastic material in Abaqus.

Create an elasto-plastic material with isotropic hardening.

List all materials in the specified model.

Create a homogeneous solid section.

Assign a section to a region.

Create an encastre (fully fixed) BC.

Create a displacement BC.

Create a pressure load.

Create a gravity load.

Create a tie constraint.

Create a Static, General step.

Create a Frequency (modal) analysis step.

Create a 3D deformable cube/box part.

Create a 3D deformable cylinder.

Generate mesh for the whole model.

Get summary of field outputs in an ODB.

Set the viewport display type and variable.

Args: plot_type: "contour", "symbol", "material", "undeformed" variable: Field output variable (e.g., "S", "U", "RF") component: Component (e.g., "Mises", "U1", "S11") deformation_scale: Deformation scale factor (None = auto)

Set the camera view in the viewport.

Args: view_type: "iso", "front", "back", "top", "bottom", "left", "right"

Set viewport annotations (title, legend, etc.).

Args: title: Title text for the viewport subtitle: Subtitle text legend: Show/hide legend

Create multiple viewports for side-by-side comparison.

Args: layout: "2x2", "3x1", "1x3", "2x1", "1x2"

Create a concentrated force on a vertex or reference point.

Create a moment load on a vertex or reference point.

Create a shell edge load (force per unit length).

Create a line load (force per unit length) on an edge set.

Create a body force (force per unit volume) on the entire model.

Create a surface heat flux load.

Create a body heat flux (heat generation per unit volume).

Create a connector force on a connector/wire set.

Create a symmetry boundary condition.

Args: symmetry_type: "XSYMM", "YSYMM", "ZSYMM", "XASYMM", "YASYMM", "ZASYMM"

Create a pinned BC (U1=U2=U3=0, rotations free).

Create a velocity boundary condition.

Create an acceleration boundary condition.

Create a temperature boundary condition.

Create a connector displacement BC.

Create a rigid body constraint.

Args: body_type: "BODY" or "PIN" (pin constrains only translational DOFs)

Create a coupling constraint between a reference point and a surface.

Args: coupling_type: "KINEMATIC", "DISTRIBUTING", or "STRUCTURAL"

Create an MPC constraint.

Args: mpc_type: "BEAM", "LINK", "PIN", "TIE", "ELBOW", "SLIDER", "PLANAR", "REVOLUTE", "UNIVERSAL", "WELD"

Create an embedded region constraint (e.g., reinforcement in concrete).

Create a linear equation constraint.

Args: terms: list of (coefficient, set_name, dof) tuples. e.g., [(1.0, "Set-1", 1), (-1.0, "Set-2", 1)] for u1(Set-1) = u1(Set-2)

Create an instance of a part in the assembly.

Translate an instance in the assembly.

Rotate an instance around an axis by a given angle (degrees).

Create a reference point in the assembly.

Create a set from faces of an instance.

Create a set from edges of an instance.

Create a set from vertices of an instance.

Create a surface from faces of an instance.

Create a surface from edges of an instance (for shell/beam).

Find the face index of an instance closest to the given coordinate.

Find the edge index of an instance closest to the given coordinate.

Create a contact interaction property.

Create a surface-to-surface contact interaction.

Create a surface-to-surface contact interaction for explicit analysis.

Create a general contact (all-inclusive) interaction.

Create a general contact for explicit analysis.

Create an Explicit Dynamics step.

Create a Heat Transfer step.

Create a Coupled Temperature-Displacement step.

Create a Dynamic Implicit step.

Create a Static Riks step (for post-buckling analysis).

Create a Linear Buckle step.

Create a field output request for a specific step.

Args: variables: list of variable names, e.g. ["S", "E", "U", "RF"] frequency: output frequency (every N increments)

Create a history output request.

Args: variables: list of variable names region_name: set name for the region (empty = whole model) frequency: output frequency (every N increments)

Seed a part with a global element size.

Set the element type for a part.

Args: elem_type: e.g., "C3D8R", "C3D8", "C3D10", "CPS4R", "CPE4R", "S4R", "B31"

Set mesh control algorithm for a part.

Args: algorithm: "MEDIAL_AXIS", "ADVANCING_FRONT", or "SWEEP"

Create a tabular amplitude.

Args: data: list of (time/frequency, amplitude) tuples smooth: "SOLVER_DEFAULT", "STEP", "LINEAR", "SMOOTH"

Create a smooth step amplitude.

Create a periodic (Fourier series) amplitude.

Extract XY data from an ODB.

Args: node_label: node label for history-based extraction element_label: element label for element-based extraction frame_index: -1 for last frame

Get history output data from an ODB.

Get the coordinates of a specific node.

List elements in an instance with their type and connectivity.

List nodes in an instance.

Create a hyperelastic (Mooney-Rivlin) material.

Create a viscoelastic material with Prony series.

Args: relaxation_data: list of (g_i, k_i, tau_i) Prony series terms

Add thermal expansion to an existing material.

Add thermal conductivity to an existing material.

Add specific heat to an existing material.

Add ductile damage initiation to a material.

Create a 3D sphere part.

Create a 3D wire (beam) part.

Create a 3D shell (planar) part.

Create a beam section.

Args: integration: "BEFORE_ANALYSIS" or "DURING_ANALYSIS"

Create a homogeneous shell section.