Orcawave Analysis

[!WARNING] Part of the Python API documented below does not exist in digitalmodel. These snippets are a specification of intended capability, not runnable code. Do not import them, and do not report a result obtained by pretending they ran.

Absent as of this revision:

• digitalmodel.orcawave.batch
• digitalmodel.orcawave.batch.OrcaWaveBatch
• digitalmodel.orcawave.mesh_study
• digitalmodel.orcawave.mesh_study.MeshConvergenceStudy
• digitalmodel.orcawave.orcaflex_export
• digitalmodel.orcawave.orcaflex_export.OrcaFlexExporter
• digitalmodel.orcawave.orcawave_analysis
• digitalmodel.orcawave.orcawave_analysis.OrcaWaveAnalysis

The surrounding engineering content — method, conventions, what to watch for — is unaffected and remains usable.

The intended API is now specified in digitalmodel, at docs/domains/orcawave/intended-api/analysis.md, where it is a build target rather than something an agent may mistake for working code. Tracked in aceengineer-strategy#267, digitalmodel#2045.

Orcawave Analysis

When to Use

• Diffraction analysis for wave-structure interaction
• Radiation analysis for added mass and damping
• Multi-body hydrodynamic interactions
• QTF (Quadratic Transfer Function) second-order calculations
• Panel mesh generation and optimization
• Batch processing of multiple configurations
• OrcaFlex hydrodynamic database generation
• Frequency domain marine analysis

Prerequisites

• OrcaWave license (COM API access)
• Python environment with digitalmodel package
• Panel mesh geometry files

Python API

Basic Analysis

from digitalmodel.orcawave.orcawave_analysis import OrcaWaveAnalysis

# Initialize analysis
orcawave = OrcaWaveAnalysis()

# Configure analysis
config = {
    "vessel_mesh": "geometry/hull_panels.dat",
    "water_depth": 1000.0,

*See sub-skills for full details.*
### Batch Processing

```python
from digitalmodel.orcawave.batch import OrcaWaveBatch

# Initialize batch processor
batch = OrcaWaveBatch(parallel=True, max_workers=4)

# Define configurations
configs = [
    {"name": "draft_full", "draft": 20.0},
    {"name": "draft_ballast", "draft": 12.0},

*See sub-skills for full details.*
### OrcaFlex Integration

```python
from digitalmodel.orcawave.orcaflex_export import OrcaFlexExporter

# Initialize exporter
exporter = OrcaFlexExporter()

# Load OrcaWave results
exporter.load_results("orcawave_results/vessel.dat")

# Export to OrcaFlex hydrodynamic database

*See sub-skills for full details.*
### Mesh Convergence Study

```python
from digitalmodel.orcawave.mesh_study import MeshConvergenceStudy

# Initialize study
study = MeshConvergenceStudy()

# Define mesh sizes to test
mesh_sizes = [2.0, 1.5, 1.0, 0.75, 0.5]

# Run convergence study

*See sub-skills for full details.*

## Related Skills

- [diffraction-analysis](../diffraction-analysis/SKILL.md) - **Master skill** for all diffraction workflows
- [bemrosetta](../bemrosetta/SKILL.md) - AQWA → OrcaFlex conversion with QTF and mesh support
- [orcaflex/modeling](../orcaflex/modeling/SKILL.md) - Apply hydrodynamic database in OrcaFlex
- [aqwa-analysis](../aqwa-analysis/SKILL.md) - AQWA validation and comparison
- [gmsh-meshing](../gmsh-meshing/SKILL.md) - Panel mesh generation
- [hydrodynamics](../hydrodynamics/SKILL.md) - Coefficient management

## References

- Orcina OrcaWave Documentation
- Newman, J.N.: Marine Hydrodynamics
- Faltinsen, O.M.: Sea Loads on Ships and Offshore Structures
- Agent Configuration: `agents/orcawave/agent_config.json`

---

## Version History

- **1.2.0** (2026-02-15): Added production-proven pitfalls (unit traps, result extraction, phase correlation, QTF guard)
- **1.1.0** (2026-01-05): Added AQWA benchmark comparison, peak-focused validation framework, 5% tolerance criteria for significant values
- **1.0.0** (2025-01-02): Initial release from agents/orcawave/ configuration

---

## Sub-Skills

- [Best Practices](best-practices/SKILL.md)

## Sub-Skills

- [Version Metadata](version-metadata/SKILL.md)
- [[1.0.0] - 2026-01-07](100-2026-01-07/SKILL.md)
- [Core Capabilities (+2)](core-capabilities/SKILL.md)
- [Performance Targets](performance-targets/SKILL.md)
- [Standard Analysis (+1)](standard-analysis/SKILL.md)
- [Integration Targets](integration-targets/SKILL.md)
- [Workflow Support](workflow-support/SKILL.md)
- [Swarm Coordination (+2)](swarm-coordination/SKILL.md)
- [License Issues (+1)](license-issues/SKILL.md)
- [OrcFxAPI Result Extraction (+3)](orcfxapi-result-extraction/SKILL.md)
- [DiffractionSpec Conventions (spec.yml to OrcaWave)](diffractionspec-conventions-specyml-to-orcawave/SKILL.md)
- [OrcaWave API Properties Reference](orcawave-api-properties-reference/SKILL.md)


## Documentation Reference

llm-wiki base: `data/llm-wiki/orcawave/`

Core theory and data topics:
- `Theory,Governingequations.md` -- BVP formulation for diffraction/radiation
- `Theory,First-orderequations.md` -- first-order panel method equations
- `Theory,Green'sfunction.md` -- Green's function approach
- `Theory,Irregularfrequencies.md` -- irregular frequency removal
- `Data,Bodies.md` -- body definition and mesh assignment
- `Data,Calculationandoutput.md` -- frequency range, output control
- `Results,Addedmassanddamping.md` -- added mass/damping matrix results
- `Results,DisplacementRAOs.md` -- displacement RAO output

Papers (`data/llm-wiki/papers/`):
- `OrcaWave-working-with-meshes.md` -- mesh best practices for OrcaWave
- `Generating-Spectral-RAOs.md` -- spectral RAO generation guidance