Orcawave Multi Body

[!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.multibody
• digitalmodel.orcawave.multibody.CouplingMatrixExtractor
• digitalmodel.orcawave.multibody.GapResonanceAnalyzer
• digitalmodel.orcawave.multibody.MultiBodyAnalysis
• digitalmodel.orcawave.multibody.ShieldingAnalyzer
• digitalmodel.orcawave.multibody.SideBySideAnalysis

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/multi-body.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 Multi Body

When to Use

• Side-by-side (STS) ship-to-ship transfer operations
• FPSO and offloading tanker interaction
• Multiple floating bodies in close proximity
• Gap resonance phenomenon investigation
• Hydrodynamic shielding effects
• Coupled vessel response analysis
• Multi-body mooring system design

Python API

Basic Multi-Body Setup

from digitalmodel.orcawave.multibody import MultiBodyAnalysis

# Initialize multi-body analysis
mb = MultiBodyAnalysis()

# Add primary vessel (FPSO)
mb.add_body(
    name="FPSO",
    mesh_file="geometry/fpso_panels.gdf",

*See sub-skills for full details.*
### Gap Resonance Analysis

```python
from digitalmodel.orcawave.multibody import GapResonanceAnalyzer

# Initialize gap resonance analyzer
gap = GapResonanceAnalyzer()

# Configure gap geometry
gap.configure(
    vessel1="FPSO",
    vessel2="Shuttle_Tanker",

*See sub-skills for full details.*
### Side-by-Side Operations

```python
from digitalmodel.orcawave.multibody import SideBySideAnalysis

# Initialize STS analysis
sts = SideBySideAnalysis()

# Configure vessels
sts.configure_fpso(
    mesh="geometry/fpso.gdf",
    loa=300.0,

*See sub-skills for full details.*
### Hydrodynamic Coupling Matrices

```python
from digitalmodel.orcawave.multibody import CouplingMatrixExtractor

# Extract coupling matrices
extractor = CouplingMatrixExtractor()

# Load multi-body results
extractor.load_results("results/multibody.owr")

# Get coupled added mass (12x12 for 2 bodies)

*See sub-skills for full details.*
### Shielding Effects

```python
from digitalmodel.orcawave.multibody import ShieldingAnalyzer

# Analyze wave shielding
shielding = ShieldingAnalyzer()

# Configure
shielding.load_multibody_results("results/multibody.owr")

# Compare sheltered vs exposed

*See sub-skills for full details.*

## Related Skills

- [orcawave-analysis](../orcawave-analysis/SKILL.md) - Single body diffraction
- [orcawave-mesh-generation](../orcawave-mesh-generation/SKILL.md) - Panel mesh creation
- [orcawave-to-orcaflex](../orcawave-to-orcaflex/SKILL.md) - Export to OrcaFlex
- [mooring-design](../mooring-design/SKILL.md) - Mooring system design

## References

- Faltinsen, O.M.: Sea Loads on Ships and Offshore Structures
- Newman, J.N.: Wave Effects on Deformable Bodies
- Molin, B.: On the Piston and Sloshing Modes in Moonpools
- OrcaWave Multi-Body Documentation

---

**Version History**

- **1.0.0** (2026-01-17): Initial release with STS analysis, gap resonance, and coupling matrix extraction

## Sub-Skills

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

## Sub-Skills

- [Error Handling](error-handling/SKILL.md)

## Sub-Skills

- [Version Metadata](version-metadata/SKILL.md)
- [Common Scenarios (+1)](common-scenarios/SKILL.md)
- [Multi-Body Analysis Configuration (+1)](multi-body-analysis-configuration/SKILL.md)
- [CLI Usage](cli-usage/SKILL.md)
- [Export for Time-Domain](export-for-time-domain/SKILL.md)


## Documentation Reference

OrcaWave topics (`data/llm-wiki/orcawave/`):
- `Data,Bodies.md` -- multi-body definition (multiple bodies per model)
- `Data,Constraints.md` -- inter-body constraints
- `Data,Springdampers.md` -- external stiffness/damping between bodies
- `Theory,Dampinglid.md` -- damping lid for gap resonance suppression
- `Results,Addedmassanddamping.md` -- coupled AMD matrices (NxN body DOFs)
- `Data,Calculationandoutput.md` -- multi-body output control

OrcaFlex topics (`data/llm-wiki/orcaflex/`):
- `Vesseltypes,Multibodydata.md` -- multi-body vessel type data in OrcaFlex
- `Vesseltheory,Impulseresponseandconvolution.md` -- coupled time-domain approach

Papers (`data/llm-wiki/papers/`):
- `Buoy-Vessel-Modelling.md` -- buoy-vessel interaction modelling