Arbeitsbereich Tabellenkalkulation
eingeführt mit Version 0.15Der Arbeitsbereich Tabellenkalkulation ermöglicht die Erstellung und Bearbeitung von Tabellen, das Einfügen von Daten eines 3D-Models, die Durchführung von Berechnungen und das Exportieren der Daten zur Verwendung in anderer Software für Tabellenkalkulation, wie LibreOffice oder Microsoft Excel.
Der Arbeitsbereich Tabellenkalkulation ist verfügbar seit FreeCAD 0.15.
Cell Expressions
A spreadsheet cell may contain arbitrary text or an expression. Technically, expressions must start with an equals '=' sign. However, the spreadsheet attempts to be intelligent; if you enter what looks like an expression without the leading '=', one will be added automatically.
Cell expressions may contain numbers, functions, and references to other cells. Cells are referenced by their row (CAPITAL letter) and column (number). Example: B4 + A6
Numbers may use either a comma ',' or a decimal point '.' separating whole digits from decimals.
Die Konstanten pi und e sind vordefiniert.
Unterstützte Funktionen
Mathematical Functions
Die folgenden Funktionen mit einem oder zwei Argumenten stehen zur Verfügung: abs, acos, asin, atan, atan2, cos, cosh, exp, log, log10, mod, pow, sin, sinh, sqrt, tan, tanh
Multiple arguments to a function may be separated by either a semicolon (';') or a comma followed by a space (", "). In the latter case, the comma is converted to a semicolon after entry.
Trigonometrische Funktionen verwenden Grad als Standardeinheit. Durch Hinzufügen von rad kann auch die Einheit Radiant verwendet werden.
Description: Ceiling
Returns: The smallest integer value greater than or equal to x introduced in version 0.16
Description: Floor
Returns: The largest integer value less than or equal to x introduced in version 0.16
Description:
Returns: x rounded to the nearest integer introduced in version 0.16
Description: Truncate
Returns: x truncated to the nearest integer introduced in version 0.16
Die folgenden statistischen Funktionen sind verfügbar: average, count, max, min, stddev, sum.
Description: Number of cells from x through y
Returns: The number of cells from x through y, inclusive
Description: Standard deviation of values in cells x through y
Returns: Standard deviation
Conditional Expressions
Die bedingte Anweisung wird wie folgt benutzt: = Bedingung ? Wahr-Ergebnis : Falsch-Ergebnis
Die Bedingung muss ein Ausdruck sein, der entweder 0 (für falsch) oder ungleich 0 für wahr ergibt. Die folgenden Vergleichsoperatoren stehen zur Verfügung: ==, !=, >, <, >=, und <=.
Die bedingte Anweisung (conditional statement) hat zur Zeit einen Fehler. Nur der true-Teil darf eine weitere bedingte Anweisung entahlten. Klammern werden entfernt nachdem der Ausdruck gespeichert wurde. Wenn man versucht, eine geschachtelte bedingte Anweisung im false-Teil zu verwenden, führt die intern verwendete Klammerung zu einem falschen Ergebnis, nach dem Speichern und Neuladen.
Referenzen auf CAD-Daten
Daten der CAD-Konstruktion können in dem Tabellenblatt verwendet werden. Die folgende Tabelle zeigt einige Beispiele. Es wird dabei vorausgesetzt, dass das FreeCAD-Dokument ein Objekt Namens "Würfel" zum Beispiel aus der Arbeitsbereich Part enthält.(Anmerkung, dies ist der interne Name des Objekts, nicht das vom Benutzer zugewiesene Label):
CAD-Data | Formel im Tabellenblatt | Ergebnis |
---|---|---|
Parametrische Länge eines Würfels des Arbeitsbereiches Part | =Würfel.Length | Länge mit den Einheiten mm |
Volumen des Würfels | =Würfel.Shape.Volume | Volumen in mm³ ohne Einheiten |
Typ des Würfel-"Shapes" | =Würfel.Shape.ShapeType | String: Solid |
Label des Würfels | =Cube.Label | String: Würfel |
x-Koordinate des Massenschwerpunktes des Würfels | =Würfel.Shape.CenterOfMass.x | x-Koordinate in mm ohne Einheiten |
Eigenschaften der Zellen
Die Eigenschaften der Zellen der Tabelle können mit einem Rechtsklick geändert werden. Es öffnet sich der folgende Dialog:
Er hat mehrere Reiter. Die folgenden Eigenschaften können geändert werden:
- Textfarbe sowie Hintergrundfarbe
- horizontale und vertikale Textausrichtung
- Textstile: fett, kursiv, unterstrichen
- Die angezeigten Einheiten für diese Zelle. (Unbedingt den Abschnitt unten beachten.)
- Einen Alias-Namen für diese Zelle festlegen. Der Alias-Name kann in den Zellformeln und auch in den FreeCAD-Ausdrücken verwendet werden eingeführt mit Version 0.16.
Die Ausdrücke werden hier erläutert: Expressions
Daten aus Tabellenblättern in FreeCAD-Ausdrücken
Um die die Tabellendaten in anderen Teilen von FreeCAD benutzen zu können, wird ein vollständig definierter Name benötigt. Weil es möglich ist, mehrere Tabellenblätter in einem FreeCAD-Dokument zu haben, wird der Tabellenname zusammen mit der Zellreferenz oder dem Zell-Alias benötigt. Die folgende Abbildung zeigt die Verwendung eines Aliasses "number" aus einem Tabellenblatt "MySheet" in einem Ausdruck in dem Arbeitsbereich PartDesign.
Durch eine Eintippen von "M" erreicht man die Anzeige von verfügbaren Namen, die mit "M" beginnen. Mit den Pfeiltasten kann "MySheet" ausgewählt werden.
Anschließendes Eintippen von "n" zeigt nun die Liste der verfügbaren Namen in MySheet, die mit "n" anfangen. Der Name "number" kann mit der Pfeilrunter-Taste ausgewählt werden. Wenn eine gültiger Formel angegeben ist, zeigt das Ergebnisfeld die berechnete Länge.
Einheiten
Die Tabellen verwenden Einheiten. Wenn eine Zahl eine Einheit hat, wird diese Einheit auch in den Berechnungen verwendet. Die Multiplikation von zwei Längen mit der Einheit mm ergibt eine Fläche mit der Einheit mm².
Man kann die dargestellte Längeneinheit von Millimeter auf Inch in dem Eigenschaftsdialog ändern. Die Zelle zeigt danach die Länge in Inch. Der eigentliche Wert, der in den Berechnungen verwendet wird, hat sich dadurch nicht geändert. Die Ergebnisse einer Formel, die diesen Wert benutzen, werden durch die angezeigte Einheit nicht geändert. Das Resultat der besagten Formel benutzt immer noch den Wert der Länge in Millimeter.
Eine Zahl ohne Einheit kann durch den Eigenschaftsdialog nicht in eine Zahl mit Einheit umgewandelt werden. Man kann eine Zeichenkette mit einer Einheitsbezeichnung eingeben, die dann auch angezeigt wird. Aber die Zelle enthält immer noch nur eine Zahl ohne Einheit.
Manchmal ist es notwendig, die Einheit von einer Zahl zu entfernen. Dies kann nur durch die Multiplikation einer 1 mit der reziproken Einheit erreicht werden.
Importieren und Exportieren
Tabellen können im CSV-Format[1] importiert und exportiert werden. Dieses Format enthält keine Formeln, kann aber von den meisten anderen Tabellenkalkulationsprogrammen wie Microsoft Excel oder LibreOffice Calc gelesen und geschrieben werden. Wenn Dateien importiert werden, muss das Trennzeichen (das Zeichen, welches die Spalten trennt) das TAB-Zeichen sein. Dies kann üblicherweise in Tabellenkalkulationsprogrammen eingestellt werden. Der Import einer CSV-Datei ist über das Menü Spreadsheet/Importiere Kalkulationstabelle oder durch Klick auf das Symbol möglich. Diese Import-Funktion öffnet keine Excel-Dateien oder andere Tabellenkalkulationsformate.
Tabellen im Excel-format "xlsx" können über das Menü Datei/Importieren... in ein FreeCAD-Document importiert werden. Excel-Tabellen können auch durch FreeCAD mit Klick auf das Symbol im Menü Datei/Öffnen... geöffnet werden. In diesem Fall wird ein neues Dokument mit einer Tabelle erzeugt. Es werden die folgenden Eigenschaften unterstützt:
- Alle Funktionen, die auch im FreeCAD-Spreadsheet zur Verfügung stehen. Andere Funktionen ergeben einen Fehler in der korrespondierenden Zelle nach dem Import.
- Aliasnamen für Zellen
- Mehr als eine Tabelle in der Excel-Datei. In diesem Fall werden mehre Tabellenblätter in dem FreeCAD-Dokument erzeugt.
Andere Inhalte werden nicht in das FreeCAD-Tabellenblatt übernommen. Der Excel-Import ist eingeführt mit Version 0.17 von FreeCAD zur Verfügung.
Bestehende Limitierungen
Innerhalb eines Tabellenblattes ist es nicht möglich die Daten für einen geometrischen Körper zu definieren, zum Beispiel die Länge, und zugleich eine resultierende Größe wie das Volumen dieses Körpers auszuwerten. Dies würde eine zirkulare Referenz erzeugen. Dies ist eine Design-Entscheidung. Es ist jedoch möglich zwei verschieden Tabellenblätter zur benutzen: Eins als Datenquelle für die Geometrie und ein anderes für die Darstellung der resultierenden Größen.
Es ist nicht möglich mehrere Zellen auszuwählen und die Inhalte zu kopieren. Es kann jeweils nur der Inhalt einer Zelle aus dem Eingabefeld kopiert und in das Eingabefeld einer anderen Zelle eingefügt werden.
Für FreeCAD-Versionen 0.14 siehe hier Spreadsheet legacy
Grundlagen der Skripterstellung
import Spreadsheet
sheet = App.ActiveDocument.addObject("Spreadsheet::Sheet")
sheet.Label = "Dimensions"