vamseeachanta Common Errors and Fixes (+1)
Common Errors and Fixes
| Error | Cause | Fix |
|---|---|---|
Wizard did not converge |
Target tension unachievable with current line geometry | Increase MaxDamping (try 50, 100, 200); check target is physically possible |
Line not found |
Line name in config doesn't match model | Check exact spelling and case of line names in model |
Singular Jacobian |
Too many lines configured simultaneously | Reduce number of included lines; solve in batches |
| Wizard converges but tension wrong | Wrong LineEnd specified (End A vs End B) |
Verify which end connects to vessel (usually End A for fairlead tension) |
| Length becomes negative | Target tension too low for line weight | Increase target tension above minimum catenary tension |
| Wizard changes wrong section | length_index not targeting the adjustable section |
Verify which section should change length (typically the longest segment) |
Debugging Wizard Failures
def diagnose_wizard_failure(model, line_name, target_tension):
"""Diagnose why Line Setup Wizard fails for a specific line."""
line = model[line_name]
issues = []
# Check line is properly connected
end_a = line.EndAConnection
end_b = line.EndBConnection
if end_a == "Free" and end_b == "Free":
*See sub-skills for full details.*