Expressions/pl

Przegląd
Możliwe jest definiowanie właściwości za pomocą wyrażeń matematycznych. W GUI, pola wyboru lub pola wejściowe, które są powiązane z właściwościami zawierają niebieską ikonę. Kliknięcie na ikonę lub wpisanie znaku równości powoduje wyświetlenie edytora wyrażeń dla danej właściwości.

Wyrażenie FreeCAD jest wyrażeniem matematycznym zgodnym z notacją dla standardowych operatorów matematycznych i funkcji opisanych poniżej. Dodatkowo, wyrażenie może odwoływać się do innych właściwości, a także używać warunków. Liczby w wyrażeniu mogą mieć opcjonalnie dołączoną jednostkę.

W liczbach można używać przecinka lub przecinka dziesiętnego  oddzielającego całe cyfry od części dziesiętnych. Gdy używany jest przecinek, po nim musi następować co najmniej jedna cyfra. Zatem wyrażenia i  są nieprawidłowe, ale  i  są już poprawne.

Operatory i funkcje są świadome jednostek i wymagają poprawnych kombinacji jednostek, jeśli zostały podane. Na przykład, jest poprawnym wyrażeniem, podczas gdy  nie jest (powodem tego jest to, że wyrażenie takie jak  będzie najprawdopodobniej interpretowane jako  przez ludzi, ale wszystkie jednostki są konwertowane do układu SI wewnętrznie, a system nie jest w stanie tego odgadnąć). Obecnie rozpoznawane są następujące jednostki.

Możesz użyć stałych predefiniowanych i funkcji.

Argumenty funkcji
Wiele argumentów funkcji może być oddzielonych albo średnikiem lub przecinkiem po którym następuje spacja. W tym drugim przypadku, po wprowadzeniu przecinek jest konwertowany na średnik. Gdy używany jest średnik, spacja nie jest wymagana.

Argumenty mogą zawierać odwołania do komórek w arkuszu kalkulacyjnym. Odwołanie do komórki składa się z wielkiej litery wiersza, po której następuje numer kolumny, na przykład. Można też odwołać się do komórki, używając jej aliasu, na przykład.

Odwołania do obiektów
Możesz odwołać się do obiektu przez jego właściwość lub. W przypadku właściwości, musi ona być zamknięta w podwójnych symbolach i , na przykład.

Możesz odwołać się do dowolnej właściwości numerycznej obiektu. Na przykład, aby odwołać się do wysokości bryły walca, możesz użyć właściwości lub.

Aby odwołać się do obiektów listy, użyj właściwości lub. Jeśli chcesz na przykład odwołać się do wiązania w szkicu, użyj właściwości. Jeśli znajdujesz się w tym samym szkicu, możesz pominąć jego nazwę i po prostu użyć właściwości. Uwaga: Numeracja indeksów zaczyna się od 0, dlatego wiązanie 17 ma indeks 16.

Więcej informacji na temat odwoływania się do obiektów znajdziesz w akapicie Odwołanie do danych CAD.

Obsługiwane stałe
Obsługiwane są następujące stałe:

Obsługiwane operatory
Obsługiwane są następujące operatory:

Ogólne funkcje matematyczne
Dostępne są funkcje matematyczne wymienione poniżej.

Funkcje trygonometryczne używają stopnia jako domyślnej jednostki. W przypadku miary radianowej, dodaj nazwę jednostki za pierwszą wartością w wyrażeniu. Tak więc np. jest tym samym co. W wyrażeniach w stopniach można używać albo nazwę jednostki albo symbol jednostki, np. lub. Jeśli wyrażenie nie ma jednostek i musi być przeliczone na stopnie lub radiany dla zgodności, pomnóż je przez, lub , odpowiednio, np. ; ; . Obsługiwane są następujące funkcje trygonometryczne:

These functions for exponentiation and logarithmization are supported:

These functions for rounding, truncation and remainder are supported:

Statistical / aggregate functions
Aggregate functions take one or more arguments.

Individual arguments to aggregate functions may consist of ranges of cells. A range of cells is expressed as two cell references separated by a colon, for example or. The cell references may also use cell aliases, for example.

These aggregate functions are supported:

String identification
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 :

String concatenation
Strings can be concatenated using the '+' sign.

Following example will be concatenated to "MYTEXT".

String formatting
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

Conditional expressions
Conditional expressions are of the form. The condition is defined as an expression that evaluates to either (false) or non-zero (true). Note that enclosing the conditional expression in parentheses is currently considered an error.

The following relational operators are defined:

Jednostki
Units can be used directly in expressions. The parser connects them to the previous value. So or  is valid while  is invalid because there is no preceding value.

All values must have a unit. Therefore you must in general use a unit for values in spreadsheets. In some cases it works even without a unit, for example if you have e.g. in spreadsheet cell B1 just the number and refer to it for a pad height. This only works because the pad height predefines the unit that is used if no unit is given. It will nevertheless fail if you use for the pad height e.g. because  has a unit and  has not.

Units with exponents can directly be entered. So e.g. will be recognized as mm³ and  will be recognized as m³.

If you have a variable whose name is that of a unit you must put the variable between to prevent it from being recognized as a unit. For example if you have the dimension it would be recognized as the unit ampere. Therefore you must write it in the expression as.

The following units are recognized by the expression parser:

Amount of substance:

Angle:

Current:

Electrical capacitance:

Electrical conductance:

Electrical inductance:

Electrical resistance:

Electric charge:

Electric potential:

Energy / work:

Force:

Length:

Luminous intensity:

Magnetic field strength:

Magnetic flux:

Magnetic flux density:

Mass:

Power:

Pressure:

Temperature:

Time:

Volume:

Special imperial units:

The following commonly used units are not yet supported:

Invalid characters and names
The expression feature is very powerful but to achieve this power it has some limitations concerning some characters. To overcome this, FreeCAD offers to use labels and reference them instead of the object names. In labels you can use almost all special characters.

In cases where you cannot use a label, such as the name of a sketch's constraints, you must be aware what characters are not allowed.

Labels
For labels there are no invalid characters, however some characters need to be escaped:

For example, the label must be referenced as.

Names
Names of objects like dimensions, sketches, etc. may not have the characters or character sequences listed below, otherwise the name is invalid:

For example, the following name is valid:. While these are invalid names: (\r means "carriage return") or  (mol is a unit).

Since shorter names (especially if they have only one or two characters) can easily result in invalid names, consider using longer names and/or establishing a suitable naming convention.

Odwołanie do danych CAD
Możliwe jest użycie danych zawartych w samym modelu w wyrażeniu. Aby odwołać się do właściwości użyj. Jeśli właściwość jest złożeniem pól, poszczególne pola mogą być dostępne jako.

Poniższa tabela przedstawia kilka przykładów:

Zmienne globalne w obrębie dokumentu
W tej chwili w programie FreeCAD nie ma koncepcji zmiennych globalnych. Zamiast tego zmienne mogą być definiowane jako komórki w arkuszu kalkulacyjnym za pomocą środowiska roboczego Arkusz kalkulacyjny, a następnie można im nadać nazwę za pomocą właściwości aliasu dla komórki (kliknij prawym przyciskiem myszy na komórkę). Następnie można się do nich odwoływać z dowolnego wyrażenia, tak jak do innych właściwości obiektu.

Powiązania między dokumentami
Możliwe jest (z ograniczeniami) zdefiniowanie właściwości obiektu w bieżącym dokumencie (plik ".FCstd") za pomocą Wyrażenia odwołującego się do właściwości obiektu znajdującego się w innym dokumencie (plik ".FCstd"). Na przykład, komórka w arkuszu kalkulacyjnym lub właściwość sześcianu środowiska Część itp. w jednym dokumencie mogą być zdefiniowane przez Wyrażenie, które odwołuje się do wartości X Umiejscowienia lub innej właściwości obiektu znajdującego się w innym dokumencie.

Nazwa dokumentu jest używana do odwoływania się do jego zawartości z innych dokumentów. Przy pierwszym zapisie dokumentu wybieramy nazwę pliku, która zazwyczaj różni się od początkowej domyślnej nazwy "Nienazwany1". Aby uniknąć utraty linków w przypadku zmiany nazwy dokumentu głównego przy zapisie, zaleca się najpierw utworzenie dokumentu głównego, utworzenie w nim arkusza kalkulacyjnego i zapisanie go. Następnie można nadal wprowadzać zmiany w pliku i jego arkuszu kalkulacyjnym, ale nie należy modyfikować jego nazwy.

Po utworzeniu i zapisaniu (nazwaniu) dokumentu głównego z arkuszem kalkulacyjnym można bezpiecznie tworzyć dokumenty zależne. Na przykład, zakładając, że nazwiesz dokument główny, arkusz kalkulacyjny i nadasz komórce alias nazwy , możesz następnie uzyskać dostęp do wartości jako:

Uwaga:, Dokument źródłowy musi być wczytany, aby wartości z dokumentu źródłowego były dostępne dla dokumentu powiązanego.

Niestety, zintegrowany program sprawdzający czasami twierdzi, że prawidłowa nazwa nie istnieje. Mimo to kontynuuj wpisywanie. Po wprowadzeniu kompletnego odwołania, przycisk stanie się aktywny.

Oczywiście, to do Ciebie zależy, czy wczytasz odpowiednie dokumenty później, gdy będziesz chciał coś zmienić.

Znane problemy / niezrealizowane zadania

 * Graf zależności oparty jest na relacjach pomiędzy obiektami dokumentu, a nie na właściwościach. Oznacza to, że nie można dostarczać danych do obiektu i odpytywać tego samego obiektu o wyniki. Na przykład, nawet jeśli nie ma cyklicznych zależności, gdy brane są pod uwagę same właściwości, nie można mieć obiektu, który pobiera swoje wymiary z arkusza kalkulacyjnego, a następnie wyświetlać objętość tego obiektu w tym samym arkuszu kalkulacyjnym. Aby obejść ten problem, należy użyć wielu arkuszy kalkulacyjnych, jednego do napędzania modelu, a drugiego do raportowania.
 * Parser wyrażeń nie radzi sobie dobrze z nawiasami i nie jest w stanie poprawnie przetworzyć niektórych wyrażeń. Na przykład:   skutkuje błędem, podczas gdy  jest akceptowane.  Wyrażenie  nie może być wprowadzone w żadnej formie.
 * Jak wspomniano powyżej, niestety zintegrowany moduł sprawdzający czasami twierdzi, że prawidłowa nazwa nie istnieje. Mimo to kontynuuj wpisywanie. Po wpisaniu pełnego odwołania, przycisk stanie się aktywny.
 * Nie ma zaimplementowanego menedżera wyrażeń, w którym wszystkie wyrażenia w dokumencie byłyby wymienione i mogłyby być tworzone, usuwane, wyszukiwane itd.
 * Otwarte błędy/tickety dotyczące wyrażeń można znaleźć w FreeCAD Bugtracker kategoria Wyrażenia