| name | aqwa-reference |
| description | AQWA solver stages (RESTART), OPTIONS keywords, FIDP/FISK external damping/stiffness cards, backend bugs, and MCP tool integration patterns. |
| type | reference |
| version | 2.0.0 |
| updated | "2026-03-16T00:00:00.000Z" |
| category | engineering |
| triggers | ["AQWA solver stages","AQWA OPTIONS keywords","AQWA RESTART","AQWA FIDP cards","AQWA FISK cards","AQWA MCP integration"] |
| capabilities | [] |
| requires | [] |
| see_also | ["aqwa-analysis"] |
| tags | [] |
| scripts_exempt | true |
AQWA Reference Skill
Solver internals, OPTIONS keywords, external damping/stiffness cards, and MCP integration for ANSYS AQWA. See aqwa for Python API.
RESTART Stage Reference
| RESTART | Stages Run | Purpose | Typical Use |
|---|
1 2 | Geometry + radiation | Added mass & damping matrices only | Quick coefficient extraction |
1 5 | Full diffraction | First-order RAOs + added mass + damping | Standard frequency-domain analysis |
1 8 | Full + QTF | Everything in 1-5 plus second-order QTF forces | Mooring design, slow drift |
OPTIONS Keyword Reference
| Keyword | Purpose | When to Use |
|---|
GOON | Continue past non-fatal mesh errors | Always (recommended) |
LHFR | Remove irregular frequency effects (lid method) | When remove_irregular_frequencies: true |
MQTF | Enable QTF computation | When qtf_calculation: true and RESTART includes stages 6-8 |
AHD1 | Generate .AH1 ASCII hydrodynamic database | When output_ah1: true |
REST END | End OPTIONS block (RESTART must follow immediately) | Always (required) |
Card Ordering in .dat File
OPTIONS GOON <- Always first (error tolerance)
OPTIONS LHFR MQTF REST END <- Feature options + terminator
OPTIONS AHD1 <- Optional output format (BEFORE REST END line)
RESTART 1 5 <- Must immediately follow REST END
FIDP External Damping Cards (Deck 7)
FIDP (Frequency Independent DamPing) cards in Deck 7 WFS1:
- Format:
{6sp}FIDP{5sp}{row_idx 5-wide}{6 x 10-char scientific notation values}
- Generated when
vessel.external_damping has non-zero entries in spec.yml
- FIDP has on frequency-domain RAOs (stages 1-5)
