Math formulas

Create calculations with regular math formulas

CalcTree supports regular math formulas as a calculation option. You can create and edit Math formulas right inside the page document.

Create a math formula

Math formulas are calculation sources that define one parameter using a regular math expression. Click somewhere on a page document and follow the following steps to create one:

	What to type in:	What happens next:
step one	/p then Enter	a new math formula is defined. The math formula defines one parameter. You can start typing a Display name for the parameter that is defined
step two	Length then =	you've assigned Length as a display name for the math parameter. The calculation-friendly Name of the parameter will be in small letters: length. That means to refer to this parameter in other sources, you need to use length
step three	2 + 2 then =	you've defined the math formula as 2 + 2, exited the math ditor mode, and received a representation of the math formula and the current value of the parameter it defines

The element you've just created on the page document, acts as an inline source editor for the math source and also as a parametric element that represents the math source and the parameter it defines. Learn more about parametric document elements here: Parametric content

Math formula editor

While typing the math formula, you are in a formula editor. The formula editor comes with a suggestion drop-down that helps you type in valid terms. The suggestions includes:

• Parameter names

• Physical units

• Math functions

For example, by typing w in the formula editor below, an available parameter name, two available physical units and an available math function that starts with w are suggested:

Physical units in math formulas

A number and a physical unit comprise a quantity in CalcTree. You can use quantities in Math formulas because formulas accept physical units as valid terms. For example, you can multiply 1 kPa and 1 m^2 to get 1 kN:

Note that if you try operations on quantities that are not physically meaningful, you will receive an error. For example adding a length to a time will result in an error, designated by red background:

This unit-awareness acts as a built-in quality control, because it checks the operations are done on compatible quantities. This is especially useful when linking parameters from other sources in Math formulas. Read more here: #chaining-math-formulas-to-other-sources

Edit a math parameter's Name or Display name

Each parameter has a Name and a Display name:

• Name: is a calculation friendly string that is used to refer to the parameter in sources. It follows the common practices for naming in programming:

  • starts with a small letter (a-z) or underline _

  • can contain only small letters, underline, and digits (0-9)

  • can not be a reserved keyword ( Python syntax terms such as if and while, or Physical units such as m and s )

  • should be unique among all Page parameters (collection of all parameters defined by all sources of a CalcTree page)

• Display name: is a document-friendly way of representing the parameter on the document. The above constraints doesn't apply to Display name

You can edit the Display name of a parameter on the document, or on the Settings panel on the right hand side. The settings panel appears when you click on a parametric element. You can edit both the Display name and the Name of a Math parameter on the settings panel:

Parametric element settings on the right-hand panel

The settings panel includes various options for tweaking how the parametric element appears on the document. Learn more about those options here: Parametric equation

Linking math formulas to other sources

You can link multiple sources to create more complex calculations. That means a source picks up a result from another source and does more calculations on it.

In order to link a Math formula to other calculations, it needs to refer to the value of another source's parameters. That is simply achievable by typing the parameter name inside the formula. For example, if you have two parameters called length, and width which are defined by other sources, you can refer to them in your formula:

In the above example, the parameters length and width could be defined by another source of any type.