Orcaflex Environment Config Common Errors And Fixes

Mode-Setting Property Order

OrcaFlex requires mode-setting properties to be set BEFORE dependent properties:

# WRONG — gamma set before spectrum type
env.WaveGamma = 3.3
env.WaveSpectrumType = OrcFxAPI.wsJONSWAP  # Too late

# CORRECT — mode first, then dependent properties
env.WaveType = OrcFxAPI.wtIrregular
env.WaveSpectrumType = OrcFxAPI.wsJONSWAP
env.WaveGamma = 3.3  # Now valid

Debugging Environment Issues

def diagnose_environment(model):
    """Check environment configuration for common issues."""
    env = model.environment
    general = model.general
    issues = []

    # Check water depth vs wave height
    wd = general.WaterDepth
    if hasattr(env, 'WaveHs') and env.WaveHs > 0:

*See sub-skills for full details.*