Expressions/it

Descrizione
È 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 notazione per gli operatori matematici standard 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.

I numeri possono usare una virgola ',' o un punto '.' per separare le cifre intere dai decimali. Quando viene utilizzato il separatore decimale, esso "deve" essere seguito da almeno una cifra. Pertanto, le espressioni 1.+2. e 1,+2, non sono valide, ma 1.0+2.0 e 1,0+2,0 sono validi.

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). Queste unità sono attualmente riconosciute.

Si possono usare le costanti predefinite e le funzioni.

Riferimenti a oggetti
Si può fare riferimento a un oggetto tramite il suo o la sua. Nel caso di una, essa deve essere racchiusa tra i simboli e , come questa:.

È possibile fare riferimento a qualsiasi proprietà numerica di un oggetto. Ad esempio, per fare riferimento all'altezza di un cilindro, è possibile utilizzare o.

Per fare riferimento agli oggetti dell'elenco, la sintassi è o. Se ad esempio si desidera fare riferimento a un vincolo in uno schizzo, si può farlo usando questa sintassi <>.Constraints[16]. Se il riferimento si trova nello stesso schizzo, si può ometterne il nome e utilizzare solo Constraints[16]. Nota: L'indice inizia con 0, quindi il vincolo 17 ha l'indice 16.

Per ulteriori informazioni sul riferimento a oggetti, vedere questa sezione.

Operatori supportati
Sono supportati i seguenti operatori:

Costanti supportate
Sono supportate le seguenti costanti:

Funzioni matematiche generali
Le funzioni matematiche elencate di seguito sono disponibili.

Quando una funzione accetta più argomenti, questi possono essere separati da un punto e virgola (';') o da una virgola seguita da uno spazio (", "). In quest'ultimo caso, la virgola viene convertita in un punto e virgola dopo la voce. Quando si utilizza un punto e virgola, non è necessario terminare la riga con uno spazio.

Le funzioni trigonometriche usano i gradi come unità predefinita. Per le misure in radianti aggiungere rad dopo il primo valore in una espressione. Per esempio cos(45) è la stessa cosa di cos(pi rad / 4). Sono supportate le seguenti funzioni trigonometriche:

Per esponenziazione e logaritmizzazione sono supportate le seguenti funzioni:

Per arrotondamento, troncamento e resto sono supportate queste funzioni :

Statistica e Funzioni di aggregazione
Le funzioni di aggregazione accettano uno o più argomenti, separati da un punto e virgola ';' o da una virgola  e  uno spazio ', '. Gli argomenti possono includere riferimenti a celle di un foglio di calcolo. I riferimenti alla cella sono costituiti dalla lettera maiuscola seguita dal numero della colonna. Gli argomenti possono includere intervalli di celle usando due riferimenti di cella separati da due punti, ad esempio average(B1:B8).

Sono supportate queste funzioni aggregate :

Espressioni condizionali
Le espressioni condizionali sono nella forma '''condition ? resultTrue : resultFalse'''. La condizione è definita come un'espressione il cui risultato è '0' (falso) o diverso da zero (vero).

The following relational operators are defined:

Unità
Units can directly be used in expressions. The parser connects them to the previous value. So '2mm' or '2 mm' is valid while ' mm' 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 1.5 and refer to it for a pad height. This only works because the pad height predefines the unit mm that is used if no unit is given. It will nevertheless fail if you use for the pad height e.g. Sketch1.Constraints.Width - Spreadsheet.B1 because Sketch1.Constraints.Width has a unit and Spreadsheet.B1 has not.

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

Se una variabile ha il nome di un'unità di misura, bisogna inserire la variabile in << >> per impedire che venga riconosciuta come unità di misura. Ad esempio, la dimensione 'Sketch.Constraints.A' verrebbe riconosciuta come unità Ampere. Pertanto è necessario scriverla nell'espressione in questo modo 'Sketch.Constraints.<>'.

The following units are recognized by the expression parser:

Amount of substance:

Angle:

Current:

Energy / Work:

Force:

Length:

Luminous intensity:

Mass:

Power:

Pressure:

Temperature:

Time:

Torque:

Volume:

The following commonly used units are not yet supported:

Riferimento ai dati CAD
In un'espressione è possibile utilizzare i dati del modello stesso. Per fare riferimento a una proprietà usare object.property. Se la proprietà è un composto di campi, è possibile accedere ai singoli campi come 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
In un documento è possibile fare riferimento a un foglio di calcolo contenuto in un altro documento.

È possibile utilizzare il nome di un documento per fare riferimento ad esso da altri documenti. Quando si salva un documento per la prima volta, si sceglie un nome per il file; questo di solito è diverso dal default iniziale "Unnamed1" (o il suo equivalente tradotto). Per evitare la perdita dei collegamenti quando il documento master viene rinominato al momento del salvataggio, si consiglia di creare prima il documento master, creare un foglio di calcolo al suo interno e salvarlo. Successivamente è ancora possibile apportare modifiche e salvare il file, ma non si deve rinominarlo.

Una volta creato e salvato (e denominato) il documento master con il foglio di calcolo, è possibile creare dei documenti dipendenti. Supponendo che il documento master sia stato denominato "master", il foglio di calcolo sia stato rinominato "modelConstants" e a una cella sia stato assegnato un nome alias "Length", il valore è accessibile come "master#modelConstants.Length". Notare che il documento master deve sempre essere caricato affinché i valori nel master siano disponibili per il documento dipendente.

master#modelConstants.Length

Note that the master document must be loaded for the values in the master to be available to the dependent document.

Purtroppo, il checker integrato a volte afferma che un nome valido non esiste. Continuare comunque a digitare. Quando il riferimento è completato, il pulsante diventa 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 per i risultati. Ad esempio, anche se non ci sono dipendenze cicliche quando vengono considerate solo le proprietà, non si può avere un oggetto che ottiene le sue dimensioni da un foglio di calcolo e quindi visualizza il volume di tale oggetto nello stesso foglio di calcolo. Per aggirare il problema, utilizzare più fogli di calcolo, ad esempio uno per sviluppare il modello, e uno per i rapporti.
 * Il parser delle espressioni non gestisce bene le parentesi e non è in grado di analizzare correttamente alcune espressioni. Ad esempio: "= (A1 > A2) ? 1 : 0" restituisce un errore, mentre "= A1 > A2 ? 1 : 0" è accettato. L'espressione "= 5 + ((A1>A2) ? 1 : 0)" non può essere inserita in nessuna forma.
 * Non è implementato nessun gestore delle espressioni in cui siano elencate tutte le espressioni di un documento, e possano essere create, eliminate, interrogate, ecc.
 * I nomi dei vincoli di Sketcher non devono contenere spazi vuoti quando il valore è calcolato da un'espressione, vedere questa discussione nel forum.
 * I bug aperti per le espressioni si trovano in FreeCAD Bugtracker Expressions category