> ## Documentation Index
> Fetch the complete documentation index at: https://calcs.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Legacy Diagrams

> Overview of legacy diagram types available in Calcs.com templates

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

<CardGroup cols={2}>
  <Card title="Cross-Section Diagram" href="/calcs_builder/diagrams/cross_section_diagram" icon="circle">
    Plot arbitrary cross-sections with section data like centroid and mesh
  </Card>

  <Card title="Free-Body Diagram" href="/calcs_builder/diagrams/free_body_diagram" icon="arrows-to-dot">
    Display factored loads and reactions for specific load combinations
  </Card>

  <Card title="Load & Support Diagram" href="/calcs_builder/diagrams/load_support_diagram" icon="arrow-down-to-line">
    Show unfactored load types and supports on structural members
  </Card>

  <Card title="Reactions Diagram" href="/calcs_builder/diagrams/reactions_diagram" icon="triangle">
    Visualize all reactions for each support in a structural member
  </Card>

  <Card title="XY Plot" href="/calcs_builder/diagrams/xy_plot" icon="chart-line">
    Create live XY line plots for engineering data visualization
  </Card>
</CardGroup>

## Common Implementation Pattern

All legacy diagrams follow a consistent implementation pattern:

<CodeBlock title="Basic Diagram Structure">
  ```json theme={null}
  {
      "type": "sheetTemplateWidgets",
      "attributes": {
          "type": "diagram",
          "diagram": [
              {
                  "type": "DIAGRAM_TYPE"
              }
          ],
          "equation": [
              {
                  "result": "{PARAMETERS}",
                  "condition": "CONDITIONS"
              }
          ],
          "referenceId": "diagram_id"
      }
  }
  ```
</CodeBlock>

## Key Features

### Standardized Visualization

* Consistent styling and formatting across all Calcs.com 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

<Note>
  While legacy diagrams continue to be supported, new template development should consider using the newer [Interactive Diagrams](/calcs_builder/diagrams/interactive_diagrams) for enhanced functionality and better user experience.
</Note>

## 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

<Tip>
  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.
</Tip>