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à.

Un'espressione di FreeCAD è un'espressione matematica che utilizza gli operatori, le funzioni e le costanti standard come descritto di seguito. Inoltre, l'espressione può fare riferimento a proprietà dell'oggetto e utilizzare anche espressioni condizionali. I numeri in un'espressione possono avere una unità facoltativa allegata.

I numeri possono utilizzare una virgola o un punto decimale  per separare le cifre intere dai decimali. Quando viene utilizzato il marcatore decimale, deve essere seguito da almeno una cifra. Pertanto, le espressioni e  non sono valide, ma  e  sono validi.

Gli operatori e le funzioni sono unit-aware (consapevoli delle unità), e richiedono combinazioni di unità valide, se sono necessarie. Ad esempio, è un'espressione valida, mentre  non lo è. Questo vale anche per i riferimenti alle proprietà dell'oggetto che hanno unità, come la proprietà Length. Pertanto non è valido poiché aggiunge un numero puro a una proprietà con una unità di lunghezza, si richiede.

Alcuni errori relativi alle unità possono sembrare non intuitivi, con espressioni respinte o che producono risultati che non corrispondono alle unità della proprietà impostata. Ecco alcuni esempi:

non viene interpretato come mezzo millimetro ma come, risultante in:.

non è valido perché la chiamata alla funzione non è un numero. Questo deve essere inserito come.



Argomenti delle funzioni
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.

Gli argomenti possono includere riferimenti a celle in un foglio di calcolo. Un riferimento di cella è costituito dalla lettera maiuscola della riga della cella seguita dal suo numero di colonna, ad esempio. È anche possibile fare riferimento a una cella utilizzando l'alias della cella, ad esempio.



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à di un oggetto. Ad esempio, per fare riferimento all'altezza di un cilindro, è possibile utilizzare o. Per fare riferimento all'oggetto stesso si usa la pseudo proprietà. Ad esempio, puoi utilizzare o.

Per fare riferimento agli oggetti dell'elenco, usa o. Se ad esempio si desidera fare riferimento a un vincolo in uno schizzo, lo si può fare usando. Se il riferimento si trova nello stesso schizzo, si può ometterne il nome e utilizzare solo. Nota: L'indice inizia con 0, quindi Constraint17 deve essere referenziato come.

Per ulteriori informazioni sui riferimenti agli oggetti, vedere Riferimento ai dati_CAD.



Costanti supportate
Sono supportate le seguenti costanti:



Operatori supportati
Sono supportati i seguenti operatori:



Funzioni supportate


Funzioni matematiche generali
Sono supportate le seguenti funzioni matematiche:



Funzioni trigonometriche
Le funzioni trigonometriche usano il grado come unità predefinita. Per la misura in radianti, aggiungi dopo il primo valore in un'espressione. Quindi ad es. è uguale a. Le espressioni in gradi possono utilizzare o, ad es. o. Se un'espressione è senza unità e deve essere convertita in gradi o radianti per compatibilità, moltiplicare per, o  in modo appropriato, ad es. ; ;.



Funzioni esponenziali e logaritmiche


Funzioni di arrotondamento, troncamento e resto


Funzioni statistiche / aggregate
Le funzioni di aggregazione prendono uno o più argomenti.

I singoli argomenti per le funzioni di aggregazione possono essere costituiti da intervalli di celle. Un intervallo di celle è espresso come due riferimenti di cella separati da due punti, ad esempio o. I riferimenti di cella possono anche utilizzare alias di cella, ad esempio.

Sono supportate le seguenti funzioni di aggregazione:



Manipolazione delle stringhe


Identificazione della stringa
Le stringhe sono identificate nelle espressioni con doppi chevron di apertura/chiusura (così come le etichette).

Nell'esempio seguente, "TEXT" è riconosciuto come una stringa:



Concatenazione di stringhe
Le stringhe possono essere concatenate utilizzando il segno '+'.

L'esempio seguente sarà concatenato a "MYTEXT".



Conversione di stringhe
I valori numerici possono essere convertiti in stringhe con la funzione :



Formattazione della stringa
La formattazione delle stringhe è supportata utilizzando il (vecchio) stile Python col %.

Tutti gli %-specifiers come definiti nella documentazione di Python.

Ad esempio, supponendo di avere un cubo predefinito di 10 mm di lato denominato 'Box' (denominazione predefinita di FreeCAD), la seguente espressione si espanderà in "Cube length: 10,0 mm"

Per più di uno specificatore % utilizzare la seguente sintassi:. Oppure usa la concatenazione:. Entrambi si espandono in "La lunghezza del cubo è 10,0 mm e la larghezza è 10,0 mm".

È disponibile un file di esempio di FreeCAD che utilizza la formattazione delle stringhe nel forum



Funzioni per la creazione di oggetti
I seguenti oggetti possono essere creati nelle espressioni utilizzando le seguenti funzioni:

<span id="Vector_functions">

Funzioni vettoriali
Funzioni:.

<span id="Matrix_functions">

Funzioni matriciali
e possono essere rappresentati ciascuno da una. Le seguenti funzioni accettano tutte, o  come primo parametro indicato nella tabella seguente da. Il tipo dell'oggetto restituito è lo stesso dell'oggetto fornito nel primo argomento tranne quando si utilizza su, nel qual caso sarà restituito.

<span id="Conditional_expressions">

Espressioni condizionali
Le espressioni condizionali hanno la forma. La condizione è definita come un'espressione che restituisce (falso) o diverso da zero (vero). Si noti che racchiudere l'espressione condizionale tra parentesi è attualmente considerato un errore.

Sono definiti i seguenti operatori relazionali:

Unità
Le unità possono essere utilizzate direttamente nelle espressioni. Il parser le collega al valore precedente. Quindi o  è valido mentre  non è valido perché non esiste un valore precedente.

Tutti i valori devono avere un'unità. Pertanto, in generale è necessario utilizzare un'unità per i valori nei fogli di calcolo. In alcuni casi funziona anche senza un'unità, ad esempio se nella cella B1 del foglio di calcolo si ha solo il numero e si fa riferimento ad esso per l'altezza del pad. Questo funziona perché l'altezza del pad predispone l'unità che viene utilizzata quando non viene fornita alcuna unità. Però fallisce se si utilizza per l'altezza del pad, ad es. perché ha un'unità e  no.

Le unità con esponenti possono essere inserite direttamente. Quindi ad es. viene riconosciuto come mm³ e viene riconosciuto come m³.

Se si ha una variabile il cui nome è quello di un'unità di misura, si deve inserire la variabile tra per evitare che venga riconosciuta come un'unità di misura. Ad esempio, la dimensione verrebbe riconosciuta come l'unità ampere. Quindi è necessario scriverla nell'espressione come.

Il parser delle espressioni riconosce le seguenti unità:

<span id="Amount_of_substance">

Corrente
<span id="Electric_capacitance">

Capacità elettrica
<span id="Electric_charge">

Carica elettrica
<span id="Electric_conductivity">

Conducibilità elettrica
<span id="Electric_inductance">

Induttanza elettrica
<span id="Electric_potential">

Potenziale elettrico
<span id="Electric_resistance">

Resistenza elettrica
<span id="Energy/work">

Lunghezza
<span id="Luminous_intensity">

Intensità luminosa
<span id="Magnetic_flux">

Flusso magnetico
<span id="Magnetic_flux_density">

Volume
<span id="Special_imperial_units">

Unità imperiali speciali
<span id="Unsupported_units">

Unità non supportate
Le seguenti unità di uso comune non sono ancora supportate, per alcune viene fornita un'alternativa:

<span id="Invalid_characters_and_names">

Caratteri e nomi non validi
La funzionalità delle espressioni è molto potente, ma per raggiungere questo potere ha alcune limitazioni relative ad alcuni caratteri. Per ovviare a questo, FreeCAD offre la possibilità di utilizzare etichette e fare riferimento ad esse invece che ai nomi degli oggetti. Nelle etichette puoi usare quasi tutti i caratteri speciali.

Nei casi in cui non è possibile utilizzare un'etichetta, come il nome dei vincoli di uno schizzo, è necessario sapere quali caratteri non sono consentiti.

Etichette
Per le etichette non ci sono caratteri non validi, tuttavia è necessario eseguire l'escape di alcuni caratteri:

Ad esempio, l'etichetta deve essere referenziata come.

Nomi
Nomi di oggetti come dimensioni, schizzi, ecc. non devono avere i caratteri o le sequenze di caratteri elencati di seguito, perchè altrimenti il nome non è valido:

Ad esempio, è valido il seguente nome:. Mentre questi sono nomi non validi: (\r significa "ritorno a capo") o  (mol è un'unità).

Poiché i nomi più brevi (soprattutto se hanno solo uno o due caratteri) possono facilmente risultare in nomi non validi, prendere in considerazione l'utilizzo di nomi più lunghi e/o stabilire una convenzione di denominazione adeguata.

<span id="Cell_aliases">

Alias di cella
See Spreadsheet SetAlias.

<span id="Reference_to_CAD_data">

Riferimento ai dati CAD
È possibile utilizzare i dati del modello stesso in un'espressione. Per fare riferimento a una proprietà utilizzare. Se la proprietà è un composto di campi, è possibile accedere ai singoli campi come.

La tabella seguente mostra alcuni esempi:

<span id="Document-wide_global_variables">

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.

<span id="Cross-document_linking">

Riferimenti incrociati nel documento
È possibile (con limitazioni) definire una proprietà di un oggetto nel documento corrente (file ".FCstd") utilizzando un'espressione per fare riferimento a una proprietà di un oggetto contenuto in un documento diverso (file ".FCstd"). Ad esempio, una cella in un foglio di calcolo o la lunghezza di un cubo di Part, ecc. in un documento può essere definita da un'espressione che fa riferimento al valore di posizionamento X o ad un'altra proprietà di un oggetto contenuto in un documento diverso.

È 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 "", il foglio di calcolo sia stato rinominato "" e a una cella sia stato assegnato un nome alias "", si può quindi accedere al valore con:

Notare che il documento master deve sempre essere caricato affinché i valori del master siano disponibili per il documento dipendente.

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.

<span id="Known_issues_/_remaining_tasks">

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.
 * Come affermato sopra, sfortunatamente, a volte il controllo integrato afferma che non esiste un nome valido. Continuare comunque a digitare. Dopo aver completato il riferimento completo, il pulsante diventerà attivo.
 * 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