Expressions/de

Übersicht
Es ist möglich, Eigenschaften unter Verwendung von mathematischen Ausdrücken festzulegen. In der GUI enthalten Drehfelder oder Eingabefelder, die an Eigenschaften gebunden sind, ein blaues Symbol. Klicken auf das Symbol oder Eingeben des Gleichheitszeichens ruft den Ausdruckseditor für diese bestimmte Eigenschaft auf.

Ein FreeCAD Ausdruck ist ein mathematischer Ausdruck, der der Schreibweise für die unten beschriebenen mathematischen Standardoperatoren und -funktionen folgt. Außerdem kann der Ausdruck auf andere Eigenschaften verweisen und auch Konditionale verwenden. Zahlen in einem Ausdruck können eine optionalen Einheit angehängt bekommen.

Zahlen können entweder ein Komma  oder einen Dezimalpunkt  zur Trennung der Ganzzahlen von Nachkommastellen verwenden. Wenn diese Trennung benutzt wird, muss danach mindestens eine Ziffer folgen. Daher sind die Ausdrücke   und  ungültig, aber  und   sind gültig.

Operatoren und Funktionen sind einheitenbewusst und erfordern gültige Kombinationen von Einheiten, falls verfügbar. Zum Beispiel ist  ein gültiger Ausdruck, während  kein gültiger Ausdruck ist (der Grund dafür ist, dass ein Ausdruck wie  von Menschen höchstwahrscheinlich als   interpretiert wird, aber alle Einheiten werden intern in das SI System umgewandelt, und das System ist nicht in der Lage, dies zu erraten). Diese Einheiten werden derzeit erkannt.

Du kannst vorgegebene Konstanten und Funktionen verwenden.

Funktionsargumente
Mehrere Argumente zu einer Funktion können entweder durch ein Semikolon oder ein Komma gefolgt von einem Leerzeichen   getrennt werden. Im letzteren Fall wird das Komma nach der Eingabe in ein Semikolon umgewandelt. Wenn ein Semikolon verwendet wird, ist kein Leerzeichen am Ende des Semikolons erforderlich.

Die Argumente können Verweise auf Zellen in einer Kalkulationstabelle enthalten. Ein Zellverweis besteht aus dem großen Zeilenbuchstaben der Zelle, gefolgt von ihrer Spaltennummer, zum Beispiel. Eine Zelle kann auch durch den Alias der Zelle referenziert werden, zum Beispiel.

Referenzierende Objekte
Du kannst auf ein Objekt über seinen oder über seine  verweisen. Im Falle einer muss es in doppelten  und  Symbolen eingeschlossen sein, wie z.B..

Du kannst auf jede numerische Eigenschaft eines Objekts referenzieren. Um sich beispielsweise auf die Höhe eines Zylinders zu beziehen, kann oder  verwendet werden.

Um auf Listenobjekte zu verweisen, verwende oder. Wenn du beispielsweise auf eine Beschränkung in einer Skizze verweisen möchtest, verwende. Wenn du dich in derselben Skizze befindest, kann man den Namen weglassen und einfach verwenden. Hinweis: Der Index beginnt mit 0, daher hat die Beschränkung 17 den Index 16.

Für weitere Informationen über das Referenzieren von Objekten siehe Referenz zu CAD Daten.

Unterstützte Konstanten
Die folgenden Konstanten werden unterstützt:

Unterstützte Operatoren
Die folgenden Operatoren werden untertstützt:

Allgemeine mathematische Funktionen
Die nachfolgend aufgeführten mathematischen Funktionen sind verfügbar.

Trigonometrische Funktionen verwenden Grad als Standardeinheit. Für die Angabe im Bogenmaß wird nach dem ersten Wert in einem Ausdruck hinzugefügt. So ist z.B. das gleiche, wie. Ausdrücke in Grad können entweder oder  verwenden, z.B.  or. Ein Ausdruck, der ohne Einheiten angegeben ist und aus Kompatibilitätsgründen in Grad oder Bogenmaß umgewandelt werden muss, wird mit 1 deg, 1 ° oder 1 rad multipliziert, gegebenenfalls, z.B. (360 - X) * 1deg; (360 - X) * 1°; (0.5 + pi / 2) * 1rad. Folgende Trigonometrische Funktionen werden unterstützt:

Diese Exponential- oder Logarithmusfunktionen werden unterstützt:

Diese Funktionen für Rundung, Trunkierung und Modulo werden unterstützt:

Statistische / Aggregatfunktionen
Aggregatfunktion verwenden ein oder mehrere Argumente.

Einzelne Argumente für Aggregatfunktionen können aus Zellbereichen bestehen. Ein Zellbereich wird durch zwei Zellbezüge ausgedrückt, die durch einen Doppelpunkt getrennt sind, zum Beispiel  oder. Die Zellbezüge können auch Zell Aliase verwenden, zum Beispiel.

Diese Aggregatfunktionen werden unterstützt:

Zeichenkettenerkennung
Strings are identified in expressions by surrounding them with opening/closing double chevrons (as are labels).

In following example, "TEXT" is recognized as a string :

Zeichenkettenverkettung
Strings can be concatenated using the '+' sign.

Following example will be concatenated to "MYTEXT".

Zeichenkettenformatierung
String formatting is supported using the (old) %-style Python way.

All %-specifiers as defined in Python documentation.

As an example, supposing you have a default 10mm-side cube named 'Box' --default FreeCAD naming--, following expression will expand to "Cube length : 10.0 mm"

A limitation is that only one %-specifier is allowed in string, thus you have to use string concatenation if more than one is needed. With same above situation, expression will expand to "Cube length is 10.0 mm and width is 10.0 mm".

A FreeCAD sample file using string formatting is available in the forum

Bedingte Ausdrücke
Bedingte Ausdrücke haben die Form. Die Bedingung ist definiert als ein Ausdruck, der entweder zu (falsch) oder Nicht-Null (wahr) ausgewertet wird. Beachte, dass das Einschließen des bedingten Ausdrucks in Klammern derzeit als Fehler angesehen wird.

Die folgenden Vergleichsoperatoren sind definiert:

Einheiten
Einheiten können direkt in Ausdrücken verwendet werden. Der Analysator (parser) verbindet sie mit dem vorherigen Wert. So ist oder  gültig, während   ungültig ist, weil es keinen vorhergehenden Wert gibt.

Alle Werte müssen eine Einheit haben. Daher müssen Werte auch in Kalkulationstabellen im allgemeinen eine Einheit haben. In einigen Fällen funktioniert es auch ohne Einheit, z.B. wenn Sie in Zelle B1 der Kalkulationstabelle z.B. nur die Zahl haben und sich für eine Blockhöhe darauf beziehen. Dies funktioniert nur, weil die Blockhöhe die Einheit vordefiniert und die verwendet wird, wenn keine Einheit angegeben ist. Es schlägt jedoch fehl, wenn Sie für die Blockhöhe z.B. verwenden, weil  eine Einheit hat und  keine Einheit.

Einheiten mit Exponenten können direkt eingegeben werden. So wird z.B. als mm³ erkannt und  wird als m³ erkannt.

Wenn eine Variable mit dem Namen einer Einheit verwendet wird, muß die Variable in  gesetzt werden. Das verhindert, dass die Variable als Einheit erkannt wird. Das Maß  würde z.B. als Einheit Ampere erkannt werden. Daher muß der Ausdruck als geschrieben werden.

Die folgenden Einheiten werden vom Analysator für Ausdrücke erkannt:

Chemische Menge einer Substanz:

Winkel:

Strom:

Elektrische Kapazität:

Elektrische Leitfähigkeit:

Elektrische Induktivität:

Elektrischer Widerstand:

Elektrische Ladung:

Elektrisches Spannung:

Energie / Arbeit:

Kraft:

Länge:

Lichtstärke:

Magnetische Feldstärke (seit 1970 nicht mehr offiziell gültig):

Magnetischer Fluß:

Magnetische Flußdichte:

Masse:

Energie:

Druck:

Temperatur:

Zeit:

Volumen:

Imperiale Spezialeinheiten:

Die folgenden häufig verwendeten Einheiten werden noch nicht unterstützt:

Ungültige Zeichen und Namen
Das Ausdrucks-Feature ist sehr leistungsfähig. Um das zu ermöglichen gibt es ein paar Einschränkungen bei ein paar Zeichen. Als Workaround gibt es in FreeCAD die Möglichkeit anstatt der Objektnamen sog. Bezeichner ('labels') zu verwenden und sich auf diese zu beziehen.

In Fällen, in denen du keine Beschriftung verwenden kannst, wie z. B. der Name einer Skizzenbeschränkung, musst du dir bewusst sein, welche Zeichen nicht erlaubt sind.

Bezeichner
Für Bezeichner gibt es keine ungültigen Zeichen, jedoch müssen einige Zeichen maskiert werden:

Zum Beispiel muss der Bezeichner als  referenziert werden.

Namen
de/Namen von Objekten wie Dimensionen, Skizzen, usw. dürfen folgende Zeichen oder Zeichenfolgen nicht enthalten. Anderenfalls ist der Namen ungültig.

Beispielsweise ist folgender Name gültig:. Hingegen sind diese ungültige Namen: (\r bedeutet "Wagenrücklauf (carriage return)") oder<>.Constraints.mol (mol ist eine Einheit).

Da kürzere Namen (vor allem, wenn sie nur ein oder zwei Zeichen haben) leicht zu ungültigen Namen führen können, sollte die Verwendung längerer Namen in Betracht gezogen und/oder eine geeignete Namenskonvention festgelegt werden.

Zell Aliase
For spreadsheet cell aliases only alphanumeric characters and underscores ( to, to ,  to  and ) are allowed.

Referenzen auf CAD Daten
Es ist möglich, Daten aus dem Modell selbst in einem Ausdruck zu verwenden. Um auf eine Eigenschaft zu verweisen, verwende. Wenn die Eigenschaft ein Verbund von Feldern ist, kann auf die einzelnen Felder mit  zugegriffen werden.

Die folgende Tabelle zeigt einige Beispiele:

Dokumentweit gültige globale Variablen
In FreeCAD gibt es zur Zeit kein Konzept für globale Variablen. Stattdessen können beliebige Variablen mit Hilfe der Arbeitsbereich Kalkulationstabelle als Zellen in einer Kalkulationstabelle definiert werden und dann mit Hilfe der Alias Eigenschaft für die Zelle (Rechtsklick auf die Zelle) einen Namen erhalten. Dann kann von jedem Ausdruck aus auf sie zugegriffen werden, wie auf jede andere Objekteigenschaft auch.

Dokumentenübergreifende Verweise
Es ist (mit Begrenzungen) möglich, eine Eigenschaft eines Objekts in deinem aktuellen Dokument (".FCstd" Datei) durch Verwendung eines Ausdrucks zu definieren, um auf eine Eigenschaft eines Objekts in einem anderen Dokument zu verweisen (".FCstd" file). Zum Beispiel kann eine Zelle in einer Kalkulationstabelle oder die eines Formteil Würfels usw. in einem Dokument durch einen Ausdruck definiert werden, der auf den X Platzierungswert oder eine andere Eigenschaft eines Objekts in einem anderen Dokument verweist.

Der Name des Dokuments wird verwendet, um von einem anderen Dokument aus darauf zu referenzieren. Wenn ein Dokument zum ersten Mal gespeichert wird, muss dem Dokument ein Name gegeben werden. Dies ist normalerweise ein anderer Name als die Vorgabe "Unbenannt1". Um zu verhindern, dass Veknüpfungen beim Speichern des Hauptdokumentes verloren gehen, wenn dieses dabei einen anderen Namen bekommt, sollte das Hauptdokument zuerst mit einer Kalkulationstabelle erstellt werden. Danach kann der Inhalt des Dokuments geändert und das Dokument gespeichert werden, aber es darf nicht umbenannt werden.

Sobald das Mutterdokument mit der Kalkulationstabelle erstellt und gespeichert (benannt) ist, können abhängige Dokumente erstellt werden. Angenommen, du nennst das Mutterdokument, die Kalkulationstabelle und gibst einer Zelle einen Alias-Namen , dann kannst du auf den Wert zugreifen als:

Hinweis:dass der Mutterdokument geladen sein muss, damit die Werte des Mutterdokuments für das abhängige Dokument verfügbar sind.

Leider meldet der integrierte Prüfer manchmal, dass ein gültiger Name nicht existiert. Tippe trotzdem weiter. Wenn du die vollständige Referenz eingegeben hast, wird die Schaltfläche aktiv.

Natürlich liegt es bei dir, die zugehörigen Dokumente später zu laden, wenn du etwas ändern willst.

Bekannte Probleme / Verbleibende Aufgaben

 * Das Abhängigkeitsdiagramm basiert auf der Beziehung zwischen Dokumentobjekten, nicht auf Eigenschaften. Das bedeutet, dass man nicht Daten einem Objekt zur Verfügung stellen kann und gleichzeitig Daten von diesem Objekt abfragt. Auch wenn es beispielsweise keine zyklischen Abhängigkeiten gibt, wenn die Eigenschaften selbst berücksichtigt werden, kann es vorkommen, dass es kein Objekt gibt, das seine Abmessungen aus einer Kalkulationstabelle erhält und dann das Volumen dieses Objekts in derselben Kalkulationstabelle anzeigt. Zur Umgehung des Problems können mehrere Tabellen angelegt werden: Eine Tabelle, die die Objektdaten zur Verfügung stellt und eine andere zur Datenauswertung.
 * Der Analysator für Ausdrucke kann mit Klammern nicht gut umgehen und ist nicht in der Lage einige Ausdrücke korrekt zu analysieren. Zum Beispiel "= (A1 > A2) ? 1 : 0" führt zu einem Fehler, während "= A1 > A2 ? 1 : 0" akzeptiert wird. Der Ausdruck "= 5 + ((A1>A2) ? 1 : 0)" kann in keiner Form eingegeben werden.
 * Wie oben erwähnt, erkennt der eingebaute Formelprüfer einen gültigen Namen manchmal nicht. Daher einfach mit der Eingabe fortfahren. Wenn die vollständige Verknüpfung eingegeben ist, wird die Schaltfläche aktiv.
 * Es gibt keinen Ausdrucksverwalter, mit dem Ausdrücke erstellt werden können, der alle vorhandenen Ausdrücke aufzeigt, löscht oder sucht etc.
 * Offene Fehler/Tickets für die Ausdrücke (Expressions) können hier nachgeschlagen werden: FreeCAD Bugtracker Expressions category