Expressions/it

Ora è possibile definire le proprietà utilizzando espressioni matematiche. Nella GUI, gli spin box o i campi di input che sono legati alle proprietà contengono un'icona blu. Cliccando sull'icona, oppure digitando il segno di uguale (=), si porta in primo piano l'editor delle espressioni per quella particolare proprietà.

Una espressione di FreeCAD è un'espressione matematica che segue la normale notazione per gli operatori matematici standard (+, -, * e /) e le funzioni come descritto in seguito. Inoltre, l'espressione può fare riferimento ad altre proprietà, e anche utilizzare le condizioni. I numeri di un'espressione possono opzionalmente essere collegati ad una unità di misura.

Gli operatori e le funzioni sono unit-aware (consapevoli delle unità), e richiedono combinazioni di unità valide, se sono fornite. Ad esempio, 2mm + 4mm è un'espressione valida, mentre 2mm + 4 non lo è (il motivo di questo è che un'espressione come 1in + 4 molto probabilmente viene interpretata come 1in + 4in da un umano, ma tutte le unità vengono convertite nel sistema SI interno, e il sistema non è in grado di indovinare questo).

Funzioni Supportate
Nelle espressioni, sono supportate le seguenti funzioni, usando uno o due argomenti: abs, acos, asin, atan, atan2, cos, cosh, exp, log, log10, mod, pow, sin, sinh, sqrt, tan, tanh, ceil, floor, trunc, round.

Le funzioni di aggregazione: min, max, count, sum, stddev, e average. Le funzioni di aggregazione possono prendere uno o più argomenti, separati da virgola o punto e virgola. Gli argomenti possono includere degli intervalli (due celle separate da due punti), ad es =average(B1:B8). Questi vengono interpretati come le proprietà B1, B2, ... B8.

Le funzioni trigonometriche utilizzano i gradi come unità di default; fornire "rad" se si desidera che utilizzino i radianti.

Le costanti pi greco ed e sono predefinite

L'istruzione condizionale funziona così: = condition ? resultTrue : resultFalse

La condizione è definita come un'espressione che restituisce 0 (per false) o non-zero per true. Sono definiti i seguenti operatori di confronto: ==, !=, >, <, >=, and <=.

Le formule sono scritte in questo modo: 2 * Length, dove Length è una proprietà contenuta nell'oggetto dell'espressione.

Riferimento ai dati CAD
In un'espressione è possibile utilizzare i dati provenienti da altre parti della costruzione. La sintassi per un riferimento a un campo è il seguente: object.property. Se la proprietà è un composto di campi, si può accedere ad esempio con object.property.field.

La tabella seguente mostra alcuni esempi:

Variabili globali nell'ambito del documento
Al momento in FreeCAD non esiste il concetto di variabili globali. Invece, utilizzando l'ambiente Spreadsheet, si possono definire delle variabili arbitrarie come celle in un foglio di calcolo, e poi assegnare loro un nome utilizzando la proprietà alias della cella (tasto destro del mouse sulla cella). Dopo si può accedere alla variabile da qualsiasi espressione, come per qualsiasi altra proprietà di un oggetto.

Riferimenti incrociati nel documento
Un documento può contenere un foglio di calcolo in cui i valori sono riferiti ad altri documenti.

Nota importante. È possibile utilizzare il nome di un documento per fare riferimento ad esso da altri documenti. Ora, quando si salva il documento per la prima volta si sceglie un determinato nome per il file, solitamente diverso da "Unnamed1" (o la sua versione tradotta), quindi quando si riapre il file i collegamenti sono persi. Perciò, si consiglia di creare prima il documento master, creare un foglio di calcolo, salvarlo e chiuderlo. Dopo la riapertura il nome è impostato sul nome del file di cui sopra. Successivamente è ancora possibile apportare modifiche e salvare il file, ma non si deve rinominarlo.

Quindi creare gli ulteriori documenti in cui si desidera aggiungere espressioni. Supponendo di aver chiamato il documento master "master" è possibile accedervi con un alias come questo: master#Spreadsheet.Length

Purtroppo, il checker integrato crea più confusione che aiuto perché restituisce sempre errori di analisi o sostiene che questo o quello non esiste. Quindi, basta continuare a digitare. Quando si è finito e il contenuto è corretto l'OK diventa improvvisamente attivo.

Naturalmente, dopo spetta all'utente il compito di caricare i documenti corrispondenti, quando si desidera cambiare qualcosa.

Problemi noti / attività rimanenti

 * I grafici delle dipendenze si basano sul rapporto tra gli oggetti del documento, non sulle proprietà. Questo significa che non è possibile fornire i dati a un oggetto e interrogare lo stesso oggetto, ad esempio, in un foglio di calcolo siccome sono considerate solo le proprietà non c'è una dipendenza ciclica. Per aggirare il problema, utilizzare più fogli di calcolo, ad esempio uno per sviluppare il modello, e uno per i rapporti.
 * Non è implementato nessun gestore delle espressioni in cui siano elencate tutte le espressioni di un documento, e possano essere create, eliminate, interrogate, ecc.
 * I bug aperti per le espressioni si trovano in FreeCAD Bugtracker Expressions category