Legacy diagrams are pre-built diagram widgets that provide standardized visualization for common engineering calculations. These diagrams are implemented as diagram widgets with specific types and use equation interfaces to pass parameters.

Available Legacy Diagram Types

Common Implementation Pattern

All legacy diagrams follow a consistent implementation pattern:
{
    "type": "sheetTemplateWidgets",
    "attributes": {
        "type": "diagram",
        "diagram": [
            {
                "type": "DIAGRAM_TYPE"
            }
        ],
        "equation": [
            {
                "result": "{PARAMETERS}",
                "condition": "CONDITIONS"
            }
        ],
        "referenceId": "diagram_id"
    }
}

Key Features

Standardized Visualization

  • Consistent styling and formatting across all ClearCalcs templates
  • Pre-configured for common engineering use cases
  • Automatic unit handling and display

Dynamic Data Binding

  • Real-time updates when calculation inputs change
  • Integration with remote solvers and calculation results
  • Conditional display based on template logic

Interactive Elements

  • Tooltips with detailed information
  • Clickable elements for navigation between related sheets
  • Zoom and pan capabilities where appropriate

Migration to New Diagrams

While legacy diagrams continue to be supported, new template development should consider using the newer Interactive Diagrams for enhanced functionality and better user experience.

Best Practices

  1. Data Validation: Always validate input data before passing to diagram widgets
  2. Unit Consistency: Ensure all units are properly converted and labeled
  3. Conditional Display: Use visibleIf conditions to show diagrams only when relevant
  4. Performance: Minimize complex calculations within diagram equations
  5. User Experience: Provide clear labels and tooltips for diagram elements
Legacy diagrams are battle-tested and reliable for standard engineering visualizations. They provide consistent behavior across the platform and are well-suited for most template requirements.