Agent skill
orcaflex-installation-analysis-common-errors-and-fixes
Sub-skill of orcaflex-installation-analysis: Common Errors and Fixes (+3).
Install this agent skill to your Project
npx add-skill https://github.com/vamseeachanta/workspace-hub/tree/main/.claude/skills/_archive/engineering/marine-offshore/orcaflex-installation-analysis/common-errors-and-fixes
SKILL.md
Common Errors and Fixes (+3)
Common Errors and Fixes
| Error | Cause | Fix |
|---|---|---|
FileNotFoundError: reference_model_file |
Path to base model incorrect | Check reference_model_file and reference_elevation_file paths are relative to working directory |
KeyError: 'Key not found in line item' |
length_index doesn't match line sections |
Count sections in reference model (0-indexed); verify length_index matches the section to extend |
| Static convergence fails at depth | Crane wire too short, structure below seabed, or tension too high | Check delta_elevation doesn't place structure below seabed; verify wire length = reference + abs(delta) |
6DBuoy position error |
InitialZ places buoy at impossible position | Verify reference elevation is correct; check for sign convention (negative = below sea level) |
| Model loads but simulation crashes | Environmental loads inappropriate for installation depth | Reduce wave Hs for splash zone cases; calm seas typical for installation |
| Crane wire tension exceeds capacity | Structure too heavy for depth or wire angle too steep | Add buoyancy aids; check structure submerged weight vs crane capacity |
| Sling connection breaks | Sling too short after depth change | Ensure intermediate slings are also updated with delta_elevation |
Debugging Installation Models
def diagnose_installation_model(model_path, expected_depth):
"""Check generated installation model for common issues."""
import OrcFxAPI
issues = []
model = OrcFxAPI.Model()
model.LoadData(model_path)
wd = model.general.WaterDepth
*See sub-skills for full details.*
## Splash Zone Analysis Checklist
- [ ] Wave Hs appropriate for installation weather window (typically Hs < 2.5m)
- [ ] Fine depth increments through splash zone (1-2m steps)
- [ ] Hydrodynamic coefficients set for partially submerged structure
- [ ] Slamming loads considered (if applicable)
- [ ] Crane wire dynamic amplification factor applied
- [ ] Structure orientation at each depth is physical
## Validation
| Check | Method | Acceptable Range |
|-------|--------|-----------------|
| Crane wire tension | Extract from static results | < crane SWL with safety factor (typically SF > 2.0) |
| Structure elevation | Compare 6DBuoy Z with target | Within 0.1m of target delta_elevation |
| Wire length | Sum of wire sections | Reference length + abs(delta_elevation) +/- 1% |
| Sling tensions | Extract from static results | Positive (no compression in slings) |
| Static convergence | model.CalculateStatics() | Converges at all depths |
| Touchdown | Check structure Z vs seabed | Structure Z > -water_depth (not through seabed) |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
gsd-complete-milestone
Archive completed milestone and prepare for next version
gsd-reapply-patches
Reapply local modifications after a GSD update
gsd-verify-work
Validate built features through conversational UAT
gsd-thread
Manage persistent context threads for cross-session work
clinical-trial-protocol
Generate clinical trial protocols for medical devices or drugs through a modular, waypoint-based architecture with research-only and full protocol modes.
single-cell-rna-qc
Performs quality control on single-cell RNA-seq data (.h5ad or .h5 files) using scverse best practices with MAD-based filtering and comprehensive visualizations.
Didn't find tool you were looking for?