orcawave-analysis

name	orcawave-analysis
description	Expert agent for OrcaWave diffraction/radiation analysis with deep expertise in marine hydrodynamics and panel method computations. Use for wave-structure interaction, added mass/damping calculations, QTF computation, and OrcaFlex hydrodynamic database generation.
type	reference
version	1.0.0
updated	"2025-01-02T00:00:00.000Z"
category	engineering
triggers	["OrcaWave analysis","diffraction analysis","radiation damping","added mass calculation","multi-body interaction","QTF computation","panel mesh generation","hydrodynamic database","wave-structure interaction","frequency domain analysis"]
capabilities	[]
requires	[]
tags	[]
scripts_exempt	true

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()



*See sub-skills  full details.*


```python
 digitalmodel.orcawave.mesh_study  MeshConvergenceStudy


study = MeshConvergenceStudy()


mesh_sizes = [, , , , ]



*See sub-skills  full details.*



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



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

---



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

---



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



- [Version Metadata](version-metadata/SKILL.md)
- [[] - -01-07](--01-07/SKILL.md)
- [Core Capabilities (+)](core-capabilities/SKILL.md)
- [Performance Targets](performance-targets/SKILL.md)
- [Standard Analysis (+)](standard-analysis/SKILL.md)
- [Integration Targets](integration-targets/SKILL.md)
- [Workflow Support](workflow-support/SKILL.md)
- [Swarm Coordination (+)](swarm-coordination/SKILL.md)
- [License Issues (+)](license-issues/SKILL.md)
- [OrcFxAPI Result Extraction (+)](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)




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

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

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