Skip to main content

โ€‹
Widget Core Function

The equation widget is used for doing engineering calculations. Itโ€™s the primary calculation engine in Calcs.com templates.

โ€‹
UI Experience

  • Not interactive for the user
  • Displays the equation used for the calculation
  • Shows the calculated value to the user

โ€‹
Data Organization and Manipulation

Primary widget for:
  • Mathematical calculations and algebraic expressions
  • Conditional statements and checks
  • Iterations and matrix/vector manipulation
Watch tutorials:

โ€‹
Equation Structure

โ€‹
Single Equation

{
  "type": "computed",
  "label": "Area",
  "symbol": "A",
  "units": "mm^2",
  "equation": [
    {
      "result": "width * height",
      "condition": "@default"
    }
  ],
  "referenceId": "area"
}

โ€‹
Multiple Conditional Equations

{
  "type": "computed",
  "label": "Capacity Factor",
  "symbol": "ฯ†",
  "equation": [
    {
      "result": "0.9",
      "condition": "loadType == 'tension'"
    },
    {
      "result": "0.85",
      "condition": "loadType == 'compression'"
    },
    {
      "result": "0.75",
      "condition": "@default"
    }
  ],
  "referenceId": "phi"
}

โ€‹
Using @ Shortcuts

Simplify equation building by using โ€@โ€ to reference other widgets: 
{
  "equation": [
    {
      "result": "@width * @height",
      "condition": "@default"
    }
  ]
}
The โ€@โ€ symbol searches by label, symbol, and reference ID, automatically inserting the correct references.
Watch tutorial: Using @ in equations

โ€‹
Error Handling

โ€‹
ThrowError vs Throw

  • throwError: Displays a specific message to the user
  • throw: Shows generic โ€œUnexpected Errorโ€ message
{
  "equation": [
    {
      "result": "width / height",
      "condition": "height != 0"
    },
    {
      "result": "throwError('Height cannot be zero')",
      "condition": "@default"
    }
  ]
}

โ€‹
Special โ€œmembersโ€ Equation Widget

For exporting data to Member Schedule: 
{
  "type": "computed",
  "label": "Members Export",
  "export": true,
  "hidden": true,
  "equation": [
    {
      "condition": "@default",
      "result": "[
        { 
          id: 'member',
          designation: designation,
          length: L,
          lengthUnit: 'm',
          nCom: N_compression,
          comments: 'Main beam'
        }
      ]"
    }
  ],
  "referenceId": "members"
}

โ€‹
Advanced Features

โ€‹
Matrix Operations

{
  "result": "[[1,2,3], [4,5,6]] * transpose([[7], [8], [9]])"
}

โ€‹
Iterations

{
  "result": "sum(iterate(1, 10, 1, i^2, i))"
}

โ€‹
Unit Conversions

{
  "result": "convert(length, 'mm', 'm')"
}

โ€‹
Conditional Logic

โ€‹
Using @default

The @default condition acts as an โ€œelseโ€ statement: 
{
  "equation": [
    {
      "result": "value1",
      "condition": "type == 'A'"
    },
    {
      "result": "value2",
      "condition": "type == 'B'"
    },
    {
      "result": "value3",
      "condition": "@default"
    }
  ]
}
Watch tutorial: Using @default

โ€‹
Best Practices

  • Use meaningful variable names
  • Add comments in authorNotes for complex calculations
  • Include proper error handling
  • Reference relevant standards in the references field
  • Use @default for catch-all conditions
  • Test edge cases thoroughly

โ€‹
Common Patterns

โ€‹
Safety Factor Application

{
  "result": "phi * capacity",
  "condition": "@default"
}

โ€‹
Min/Max Selection

{
  "result": "min(value1, value2, value3)",
  "condition": "@default"
}

โ€‹
Rounding

{
  "result": "round(value, 2)",
  "condition": "@default"
}

โ€‹
Examples from Current Calculators

ReferenceIdCalculator
s_t-EU Steel Column