Orcaflex Enrichment

OrcaFlex Enrichment Skill

Converts binary OrcaFlex .dat model files to enriched, client-clean YAML test fixtures using worldenergydata public databases.

Pipeline (all on licensed-win-1)

Stage 1  Extract    .dat + OrcFxAPI → raw YAML params
Stage 2  Enrich     raw YAML + worldenergydata lookups → enriched YAML → client-c/
Stage 3  Clean      enriched YAML → strip client names → legal scan → digitalmodel/

Stage 1 — Extract

python scripts\data\orcaflex\dat-to-yaml.py ^
    --input "\\dev-secondary\dde\Orcaflex\0000 Drilling Riser Development\Latest" ^
    --output "client-c\data\raw\orcaflex-extracted\drilling-riser-development" ^
    --project drilling-riser-development

Extracts: general, environment, lines[], vessels[] per .dat file.

Stage 2 — Enrich + Stage (client-c)

python scripts\data\orcaflex\enrich-and-clean.py ^
    --input  client-c\data\raw\orcaflex-extracted\ ^
    --output digitalmodel\data\orcaflex\ ^
    --dry-run

Enrichment lookups performed

Enriched YAML output example (line object)

lines:
- component_type: marine_drilling_riser_joint
  nps_in: 21.0
  public_match:
    grade_range: [G105, S135]
    api_standard: API-STD-16F
    source: worldenergydata.vessel_fleet.DrillingRiserLoader
  dat_properties:      # numeric props from .dat — unchanged
    OD: [0.5334]
    WallThickness: [0.025]
    Length: [15.24, 15.24, 15.24]
    CDt: 0.01
    CDn: 1.0
  # name: stripped (client-specific)

Enriched YAML output example (vessel object)

vessels:
- vessel_class: drillship
  water_depth_rating_m: 3658
  dp_class: DP3
  public_source: worldenergydata.vessel_fleet.BSEE_rig_fleet
  dat_properties:
    InitialX: 0.0
    InitialY: 0.0
    InitialZ: 0.0
  # name: stripped

Stage 3 — Clean + Commit

bash scripts/legal/legal-sanity-scan.sh digitalmodel/data/orcaflex/
cd digitalmodel
git add data/orcaflex/
git commit -m "data(orcaflex): enriched fixtures from public vessel/riser databases"

Priority Extraction Order

worldenergydata Database Status

Key worldenergydata API Calls

from worldenergydata.vessel_fleet import DrillingRiserLoader

loader = DrillingRiserLoader()
# Match riser joint by OD
joints = loader.filter_by_size(od_in=21.0)

# Get all riser joints
all_joints = loader.get_riser_joints()

# Get BOPs
bops = loader.get_bops()

# Pipeline spec lookup (after WRK-594)
from worldenergydata.bsee.pipeline import PipelineSpecLookup

lookup = PipelineSpecLookup()
spec = lookup.match_od_wt(od_m=0.2731, wt_m=0.012)
# → {nps_in: 10.75, schedule: "XS", grade_range: ["X60", "X65"], ...}

Blocked By

• WRK-593: expand drilling_riser_components.csv + add construction_vessels.csv
• WRK-594: create api_5l_pipe_schedule.csv + PipelineSpecLookup class

Documentation Reference

llm-wiki base: data/llm-wiki/orcaflex/

Relevant OrcaFlex topics:

• Textdatafiles.md -- YAML/text data file format for .dat extraction
• Vesseldata.md, Vesseltypes.md -- vessel object properties extracted in Stage 1
• Lines.md, Linedata.md, Linetypes,Geometry,massexpansiondata.md -- line object properties (OD, WT)
• Environment.md, Generaldata.md -- general/environment parameters

OrcFxAPI topics (data/llm-wiki/orcfxapi/):

• Modelbuilding,Settingthedata.md -- programmatic data extraction via OrcFxAPI
• Pythoninterface,Objectdata.md -- Python object data access for .dat reading