orcawave-damping-sweep

name	orcawave-damping-sweep
description	Viscous damping analysis for OrcaWave. Use when running parametric damping sweeps, optimizing roll damping coefficients, computing critical damping, or comparing damping results with model test data for vessel motion tuning.
type	reference
version	1.0.0
updated	"2026-01-17T00:00:00.000Z"
category	engineering
triggers	["damping sweep","roll damping","viscous damping study","critical damping","damping optimization","bilge keel effect","damping coefficient tuning","model test comparison"]
capabilities	[]
requires	[]
tags	[]
scripts_exempt	true

Orcawave Damping Sweep

When to Use

• Parametric studies of viscous damping effects
• Roll damping coefficient optimization
• Comparing radiation damping with viscous damping
• Tuning damping to match model test data
• Estimating bilge keel damping contribution
• Critical damping ratio calculations
• Sensitivity analysis for motion predictions
• Roll resonance mitigation studies

Python API

Basic Damping Sweep

from digitalmodel.orcawave.damping import DampingSweep

# Initialize sweep
sweep = DampingSweep()

# Load base model
sweep.load_model("models/fpso.owr")

# Define damping values to sweep

*See sub-skills for full details.*
### Multi-Parameter Sweep

```python
from digitalmodel.orcawave.damping import MultiParameterDampingSweep

# Initialize multi-parameter sweep
sweep = MultiParameterDampingSweep()

# Load model
sweep.load_model("models/fpso.owr")

# Define parameter space

*See sub-skills for full details.*
### Critical Damping Calculation

```python
from digitalmodel.orcawave.damping import CriticalDampingCalculator

# Initialize calculator
calc = CriticalDampingCalculator()

# Load model with mass and stiffness
calc.load_model("models/fpso.owr")

# Calculate critical damping for each DOF

*See sub-skills for full details.*
### Model Test Comparison

```python
from digitalmodel.orcawave.damping import ModelTestComparison

# Initialize comparison
comparison = ModelTestComparison()

# Load OrcaWave results
comparison.load_orcawave_results("results/fpso.owr")

# Load model test data

*See sub-skills  full details.*


```python
 digitalmodel.orcawave.damping  BilgeKeelDamping


bk = BilgeKeelDamping()


bk.configure_vessel(
    beam=,          
    draft=,         

*See sub-skills  full details.*


```python
 digitalmodel.orcawave.damping  DampingPeriodAnalyzer


analyzer = DampingPeriodAnalyzer()


analyzer.load_results()



*See sub-skills  full details.*



- [orcawave-analysis](../orcawave-analysis/SKILL.md) - OrcaWave diffraction analysis
- [orcawave-to-orcaflex](../orcawave-to-orcaflex/SKILL.md) - Export  damping
- [hydrodynamics](../hydrodynamics/SKILL.md) - Coefficient management
- [viv-analysis](../viv-analysis/SKILL.md) - Vibration damping



- Himeno, Y.: Prediction of Ship Roll Damping - State of the Art
- Ikeda, Y.: Prediction Methods of Roll Damping of Ships
- OrcaWave Roll Damping Documentation
- Script: `scripts/python/digitalmodel/modules/run_orcawave_damping_sweep.py`

---

**Version History**

- **** (-01-): Initial release  damping sweep, model test comparison,  bilge keel estimation



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



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



- [Version Metadata](version-metadata/SKILL.md)
- [Total Damping Composition (+)](total-damping-composition/SKILL.md)
- [Damping Sweep Configuration (+)](damping-sweep-configuration/SKILL.md)
- [CLI Usage](cli-usage/SKILL.md)
- [Typical Values by Vessel  (+)](typical-values-by-vessel-/SKILL.md)
- [Damping-Related Properties](damping-related-properties/SKILL.md)




OrcaWave topics (`data/llm-wiki/orcawave/`):
- `Theory,Dampinglid.md` -- damping lid method  free-surface suppression
- `Theory,Hydrodynamicdrag.md` -- linearized viscous drag  frequency domain
- `Results,Rolldamping.md` -- roll damping results output
- `Results,Addedmassanddamping.md` -- radiation damping vs frequency
- `Data,Springdampers.md` -- external damping specification

OrcaFlex topics (`data/llm-wiki/orcaflex/`):
- `Vesseltypes,Otherdamping.md` -- additional damping  vessel types
- `Vesseltheory,Otherdamping.md` -- damping theory beyond radiation

Papers (`data/llm-wiki/papers/`):
- `Structural-Damping.md` -- structural damping concepts
- `Spar-Buoy-Equation-of-Motion.md` -- damping  spar buoy dynamics