Arbeitsbereich Tabellenkalkulation
introduced in version 0.15The spreadsheet workbench allows you to create and edit spreadsheets, perform calculations, and retrieve data from a model, and export its data to other spreadsheet applications such as LibreOffice or Microsoft Excel.
Supported Functions
The spreadsheet provides the following functions taking one or two arguments: abs, acos, asin, atan, atan2, cos, cosh, exp, log, log10, mod, pow, sin, sinh, sqrt, tan, tanh
The following aggregate functions are supported: average, count, max, min, stddev, sum.
Aggregate functions are written with a colon: =average(B1:B8)
The constants pi and e are predefined.
The conditional statement works like this: = condition ? resultTrue : resultFalse
Formulas are written as follows: =A2+A3
Cell-references have to be written with upper letters.
Reference To CAD-Data
It is possible to use data from the construction in the spreadsheet. The following table shows some examples:
| CAD-Data | Call in Spreadsheet | Result |
|---|---|---|
| Parametric Length of a Part-Workbench Cube | =Cube.Length | Length with units mm |
| Volume of the Cube | =Cube.Shape.Volume | Volume in mm³ without units |
| Type of the Cube-shape | =Cube.Shape.ShapeType | String: Solid |
| Label of the Cube | =Cube.Label | String: Cube |
| x-coordinate of center of mass of the Cube | =Cube.Shape.CenterOfMass.x | x-coordinate in mm without units |
Cell Properties
The properties of a spreadsheet cell can be edited with a right-click on a cell. The following dialog pops up:
It has several tabs. The following properties can be changed:
- Text color and background color
- Text horizontal and vertical alignment
- Text style: bold, italic, underline
- Display unit for this cell. Please read the section below.
- Define an alias-name for this cell. This alias-name can be used in cell-formulas and also in FreeCAD-Expressionsintroduced in version 0.16-in Development
Units
The Spreadsheet uses units. If a number has a unit, this unit will be used in all calculations. The multiplication of two length with the unit mm gives an area with the unit mm².
You can switch the length-unit from mm to inch in the dialog, you get with a right-click on a cell. The cell will now show the length in inches. The value used for calculations does not change. The results of a formula using this value do not change, when the shown unit of an input was changed. The result is still calculated from the length in mm.
A number without a unit cannot be changed in a number with unit by the cell properties dialog. One can put in a unit string, that will also be shown, but the cell still contains only a number without unit.
Sometime it is desirably to get rid of a unit. This can only to be done by multiplying with 1 with a reciprocal unit.
Current Limitations
It is not possible to select and copy multiple cells. Only the content of a cell from the input field can be copied and paste into the input field of another cell.
For FreeCAD earlier versions see Spreadhseet legacy
