Expressions/it: Difference between revisions
Renatorivo (talk | contribs) No edit summary |
(Updating to match new version of source page) |
||
(21 intermediate revisions by 2 users not shown) | |||
Line 4: | Line 4: | ||
==Descrizione== |
==Descrizione== |
||
<div class="mw-translate-fuzzy"> |
|||
È 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 [[Image:Sketcher_Expressions.png|32px]]. Cliccando sull'icona, oppure digitando il segno di uguale {{KEY|=}}, si porta in primo piano l'editor delle espressioni per quella particolare proprietà. |
È 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 [[Image:Sketcher_Expressions.png|32px]]. Cliccando sull'icona, oppure digitando il segno di uguale {{KEY|=}}, si porta in primo piano l'editor delle espressioni per quella particolare proprietà. |
||
</div> |
|||
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. |
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. |
||
<div class="mw-translate-fuzzy"> |
|||
I numeri possono usare una virgola ',' o un punto '.' per separare le cifre intere dai decimali. |
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. |
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. |
Pertanto, le espressioni '''1.+2.''' e '''1,+2,''' non sono valide, ma '''1.0+2.0''' e '''1,0+2,0''' sono validi. |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
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à|unità]] sono attualmente riconosciute. |
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à|unità]] sono attualmente riconosciute. |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Si possono usare le [[#Costanti supportate|costanti predefinite]] e le [[#Funzioni supportate|funzioni]]. |
Si possono usare le [[#Costanti supportate|costanti predefinite]] e le [[#Funzioni supportate|funzioni]]. |
||
</div> |
|||
===Function arguments=== |
|||
<div class="mw-translate-fuzzy"> |
|||
Quando una funzione accetta più argomenti, questi possono essere separati da un punto e virgola (';') o da una virgola <em>seguita da uno spazio</em> (", "). 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. |
|||
</div> |
|||
Arguments may include references to cells in a spreadsheet. A cell reference consists of the cell's uppercase row letter followed by its column number, for example {{incode|A1}}. A cell may also be referenced by using the cell's alias instead, for example {{incode|Spreadsheet.MyPartWidth}}. |
|||
===Riferimenti a oggetti=== |
===Riferimenti a oggetti=== |
||
<div class="mw-translate-fuzzy"> |
|||
Si può fare riferimento a un oggetto tramite il suo {{incode|Name}} o la sua {{incode|Label}}. Nel caso di una {{incode|Label}}, essa deve essere racchiusa tra i simboli {{incode|<<}} e {{incode|>>}}, come questa: {{incode|<<Label>>}}. |
Si può fare riferimento a un oggetto tramite il suo {{incode|Name}} o la sua {{incode|Label}}. Nel caso di una {{incode|Label}}, essa deve essere racchiusa tra i simboli {{incode|<<}} e {{incode|>>}}, come questa: {{incode|<<Label>>}}. |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
È possibile fare riferimento a qualsiasi proprietà numerica di un oggetto. Ad esempio, per fare riferimento all'altezza di un cilindro, è possibile utilizzare {{incode|Cylinder.Height}} o {{incode|<<Long_name_of_cylinder>>.Height}}. |
È possibile fare riferimento a qualsiasi proprietà numerica di un oggetto. Ad esempio, per fare riferimento all'altezza di un cilindro, è possibile utilizzare {{incode|Cylinder.Height}} o {{incode|<<Long_name_of_cylinder>>.Height}}. |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Per fare riferimento agli oggetti dell'elenco, la sintassi è {{incode|<<object_label>>.list[list_index]}} o {{incode|object_name.list[list_index]}}. Se ad esempio si desidera fare riferimento a un vincolo in uno schizzo, si può farlo usando questa sintassi |
Per fare riferimento agli oggetti dell'elenco, la sintassi è {{incode|<<object_label>>.list[list_index]}} o {{incode|object_name.list[list_index]}}. Se ad esempio si desidera fare riferimento a un vincolo in uno schizzo, si può farlo usando questa sintassi |
||
'''<<MySketch>>.Constraints[16]'''. Se il riferimento si trova nello stesso schizzo, si può ometterne il nome e utilizzare solo '''Constraints[16]'''.<br/> |
'''<<MySketch>>.Constraints[16]'''. Se il riferimento si trova nello stesso schizzo, si può ometterne il nome e utilizzare solo '''Constraints[16]'''.<br/> |
||
'''Nota:''' L'indice inizia con 0, quindi il vincolo 17 ha l'indice 16. |
'''Nota:''' L'indice inizia con 0, quindi il vincolo 17 ha l'indice 16. |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Per ulteriori informazioni sul riferimento a oggetti, vedere [[#Riferimento ai dati CAD|questa sezione]]. |
Per ulteriori informazioni sul riferimento a oggetti, vedere [[#Riferimento ai dati CAD|questa sezione]]. |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
== Costanti supportate == |
|||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Sono supportate le seguenti costanti: |
|||
{| class="wikitable float-right mw-collapsible mw-uncollapsed" |
|||
!style="width: 33%;"|Constante |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|||
| style="text-align:center;" | '''e''' |
|||
| [https://en.wikipedia.org/wiki/E_(mathematical_constant) Numero di Eulero] |
|||
|- |
|||
| style="text-align:center;" | '''pi''' |
|||
| [https://en.wikipedia.org/wiki/Pi Pi greco] |
|||
|} |
|||
</div> |
|||
== Supported operators == |
|||
<div class="mw-translate-fuzzy"> |
|||
Sono supportati i seguenti operatori: |
Sono supportati i seguenti operatori: |
||
{| class="wikitable float-right mw-collapsible mw-uncollapsed" |
{| class="wikitable float-right mw-collapsible mw-uncollapsed" |
||
Line 52: | Line 96: | ||
| [https://en.wikipedia.org/wiki/Exponentiation Potenze] |
| [https://en.wikipedia.org/wiki/Exponentiation Potenze] |
||
|} |
|} |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
== Costanti supportate == |
|||
Sono supportate le seguenti costanti: |
|||
{| class="wikitable float-right mw-collapsible mw-uncollapsed" |
|||
!style="width: 33%;"|Constante |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|||
| style="text-align:center;" | '''e''' |
|||
| [https://en.wikipedia.org/wiki/E_(mathematical_constant) Numero di Eulero] |
|||
|- |
|||
| style="text-align:center;" | '''pi''' |
|||
| [https://en.wikipedia.org/wiki/Pi Pi greco] |
|||
|} |
|||
== Funzioni supportate == |
== Funzioni supportate == |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
=== Funzioni matematiche generali === |
=== Funzioni matematiche generali === |
||
</div> |
|||
Le funzioni matematiche elencate di seguito sono disponibili. |
Le funzioni matematiche elencate di seguito sono disponibili. |
||
<div class="mw-translate-fuzzy"> |
|||
Quando una funzione accetta più argomenti, questi possono essere separati da un punto e virgola (';') o da una virgola <em>seguita da uno spazio</em> (", "). 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 [https://en.wikipedia.org/wiki/Trigonometric_functions funzioni trigonometriche] usano i gradi come unità predefinita. Per le misure in radianti aggiungere '''rad''' dopo il <em>primo</em> valore in una espressione. Per esempio '''cos(45)''' è la stessa cosa di '''cos(pi rad / 4)'''. Se un'espressione è senza unità e per compatibilità deve essere convertita in gradi o radianti,, moltiplicare per '''1 deg''', '''1 °''' o '''1 rad''' secondo il caso, ad es. '''(360 - X) * 1deg'''; '''(360 - X) * 1°'''; '''(0.5 + pi / 2) * 1rad'''.<br/> |
Le [https://en.wikipedia.org/wiki/Trigonometric_functions funzioni trigonometriche] usano i gradi come unità predefinita. Per le misure in radianti aggiungere '''rad''' dopo il <em>primo</em> valore in una espressione. Per esempio '''cos(45)''' è la stessa cosa di '''cos(pi rad / 4)'''. Se un'espressione è senza unità e per compatibilità deve essere convertita in gradi o radianti,, moltiplicare per '''1 deg''', '''1 °''' o '''1 rad''' secondo il caso, ad es. '''(360 - X) * 1deg'''; '''(360 - X) * 1°'''; '''(0.5 + pi / 2) * 1rad'''.<br/> |
||
Sono supportate le seguenti funzioni trigonometriche: |
Sono supportate le seguenti funzioni trigonometriche: |
||
Line 122: | Line 156: | ||
| tutti |
| tutti |
||
|} |
|} |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Per esponenziazione e logaritmizzazione sono supportate le seguenti funzioni: |
Per esponenziazione e logaritmizzazione sono supportate le seguenti funzioni: |
||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 149: | Line 185: | ||
| x >= 0 |
| x >= 0 |
||
|} |
|} |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Per arrotondamento, troncamento e resto sono supportate queste funzioni : |
Per arrotondamento, troncamento e resto sono supportate queste funzioni : |
||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 180: | Line 218: | ||
| tutti |
| tutti |
||
|} |
|} |
||
</div> |
|||
=== Statistical / aggregate functions === |
|||
<div class="mw-translate-fuzzy"> |
|||
=== Statistica e Funzioni di aggregazione === |
=== Statistica e Funzioni di aggregazione === |
||
Le [https://en.wikipedia.org/wiki/Aggregate_function funzioni di aggregazione] accettano uno o più argomenti, separati da un punto e virgola ';' o da una virgola '' e '' uno spazio ', '.<br/> |
Le [https://en.wikipedia.org/wiki/Aggregate_function funzioni di aggregazione] accettano uno o più argomenti, separati da un punto e virgola ';' o da una virgola '' e '' uno spazio ', '.<br/> |
||
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.<br/> |
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.<br/> |
||
Gli argomenti possono includere intervalli di celle usando due riferimenti di cella separati da due punti, ad esempio '''average(B1:B8)'''. |
Gli argomenti possono includere intervalli di celle usando due riferimenti di cella separati da due punti, ad esempio '''average(B1:B8)'''. |
||
</div> |
|||
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 {{Incode|:}}, for example {{Incode|average(B1:B8)}} or {{Incode|sum(A1:A4; B1:B4)}}. |
|||
The cell references may also use cell aliases, for example {{Incode|average(StartTemp:EndTemp)}}. |
|||
<div class="mw-translate-fuzzy"> |
|||
Sono supportate queste funzioni aggregate : |
Sono supportate queste funzioni aggregate : |
||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 216: | Line 263: | ||
| tutti |
| tutti |
||
|} |
|} |
||
</div> |
|||
=== String manipulation === |
|||
==== 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 : {{incode|<<TEXT>>}} |
|||
==== String concatenation ==== |
|||
Strings can be concatenated using the '+' sign. |
|||
Following example {{incode|<<MY>> + <<TEXT>>}} will be concatenated to "MYTEXT". |
|||
==== String formatting ==== |
|||
String formatting is supported using the (old) %-style Python way. |
|||
All %-specifiers as defined in [https://docs.python.org/3/library/stdtypes.html#printf-style-string-formatting Python documentation]. |
|||
As an example, supposing you have a default 10mm-side cube named 'Box' --default FreeCAD naming--, following expression {{incode|<<Cube length : %s>> % Box.Length}} 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 {{incode|<<Cube length is %s>> % Box.Length + << and width is %s>> % Box.Width}} will expand to "Cube length is 10.0 mm and width is 10.0 mm". |
|||
A FreeCAD sample file using string formatting is available [https://forum.freecadweb.org/viewtopic.php?f=8&t=58657 in the forum] |
|||
=== Create function === |
|||
The following objects may be created in expressions via the {{incode|create}} function: |
|||
* Vector |
|||
* Matrix |
|||
* Rotation |
|||
* Placement |
|||
The {{incode|create}} function passes subsequent arguments to the underlying Python constructor when creating the object. |
|||
Various mathematical operations such as multiplication, addition, and subtraction are supported via standard mathematical operators (e.g. {{incode|*}}, {{incode|+}}, {{incode|-}}). |
|||
==== Vector ==== |
|||
When {{incode|create}} is passed {{incode|<<vector>>}} as the 1st argument, the next 3 arguments are the X, Y, and Z coordinates for the {{incode|Vector}} respectively. |
|||
Example: |
|||
{{incode|create(<<vector>>; 2; 1; 2)}} |
|||
==== Matrix ==== |
|||
When {{incode|create}} is passed {{incode|<<matrix>>}} as the 1st argument, the next 16 arguments are the elements for the {{incode|Matrix}} in [https://en.wikipedia.org/wiki/Row-_and_column-major_order row-major order]. |
|||
Example: |
|||
{{incode|create(<<matrix>>; 1; 2; 3; 4; 5; 6; 7; 8; 9; 10; 11; 12; 13; 14; 15; 16)}} |
|||
==== Rotation ==== |
|||
When {{incode|create}} is passed {{incode|<<rotation>>}} as the 1st argument, there are two ways to create a {{incode|Rotation}}: |
|||
1. Specify an axis vector and a rotation angle. |
|||
Example: |
|||
{{incode|create(<<rotation>>; create(<<vector>>; 0; 1; 0); 45)}} |
|||
2. Specify 3 rotations about the X, Y, and Z axes as Euler angles. |
|||
Example: |
|||
{{incode|create(<<rotation>>; 30; 30; 30)}} |
|||
==== Placement ==== |
|||
When {{incode|create}} is passed {{incode|<<placement>>}} as the 1st argument, there are five ways to create a {{incode|Placement}}. |
|||
These possible combinations are documented in the below table and are based on the [[Placement_API|Placement API]] page. |
|||
{| class="wikitable" |
|||
!style="width: 33%;"|Number of arguments |
|||
!style="width: 66%;"|Description |
|||
|- |
|||
| 2 |
|||
| {{incode|create(<<placement>>; Placement)}} |
|||
|- |
|||
| 2 |
|||
| {{incode|create(<<placement>>; Matrix)}} |
|||
|- |
|||
| 3 |
|||
| {{incode|create(<<placement>>; Base; Rotation)}} |
|||
|- |
|||
| 4 |
|||
| {{incode|create(<<placement>>; Base; Rotation; Center)}} |
|||
|- |
|||
| 4 |
|||
| {{incode|create(<<placement>>; Base; Axis; Angle)}} |
|||
|} |
|||
The following example shows the syntax for creating a {{incode|Placement}} from a {{incode|Base}} (vector) and a {{incode|Rotation}}: |
|||
{{incode|create(<<placement>>; create(<<vector>>; 2; 1; 2); create(<<rotation>>; create(<<vector>>; 0; 1; 0); 45))}} |
|||
For readability, you can define vectors and rotations in separate cells, and then reference the cells in your expression. |
|||
=== Matrix functions === |
|||
==== mscale ==== |
|||
Scale a {{incode|Matrix}} with a given {{incode|Vector}}. |
|||
{{incode|mscale(Matrix; Vector)}} |
|||
{{incode|mscale(Matrix; x; y; z)}} |
|||
==== minvert ==== |
|||
Invert the given {{incode|Matrix}}, {{incode|Rotation}}, or {{incode|Placement}}. |
|||
{{incode|minvert(Matrix)}} |
|||
{{incode|minvert(Rotation)}} |
|||
{{incode|minvert(Placement)}} |
|||
=== Tuple & list === |
|||
You can create Python {{incode|tuple}} or {{incode|list}} objects via their respective functions. |
|||
{{incode|tuple(2; 1; 2)}} |
|||
{{incode|list(2; 1; 2)}} |
|||
<div class="mw-translate-fuzzy"> |
|||
== Espressioni condizionali == |
== Espressioni condizionali == |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
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). |
|||
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). |
|||
Notare che racchiudere l'espressione condizionale tra parentesi è attualmente considerato un errore. {{VersionMinus/it|0.19}} |
|||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Sono definiti i seguenti [https://en.wikipedia.org/wiki/Relational_operator#Standard_relational_operators operatori relazionali]: |
Sono definiti i seguenti [https://en.wikipedia.org/wiki/Relational_operator#Standard_relational_operators operatori relazionali]: |
||
{| class="wikitable float-right mw-collapsible mw-uncollapsed" |
{| class="wikitable float-right mw-collapsible mw-uncollapsed" |
||
Line 244: | Line 428: | ||
| minore o uguale |
| minore o uguale |
||
|} |
|} |
||
</div> |
|||
==Unità== |
==Unità== |
||
<div class="mw-translate-fuzzy"> |
|||
Le unità possono essere utilizzate direttamente nelle espressioni. Il parser le collega al valore precedente. Quindi ''''2mm'''' o ''''2 mm'''' è valido mentre ''''mm'''' non è valido perché non esiste un valore precedente. |
Le unità possono essere utilizzate direttamente nelle espressioni. Il parser le collega al valore precedente. Quindi ''''2mm'''' o ''''2 mm'''' è valido mentre ''''mm'''' non è valido perché non esiste un valore precedente. |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Tutti i valori devono avere un'unità. Pertanto, in generale è necessario utilizzare un'unità per i valori nei fogli di calcolo. <br/> |
Tutti i valori devono avere un'unità. Pertanto, in generale è necessario utilizzare un'unità per i valori nei fogli di calcolo. <br/> |
||
In alcuni casi funziona anche senza un'unità, ad esempio se nella cella B1 del foglio di calcolo si ha solo il numero ''1,5'' e si fa riferimento ad esso per l'altezza del pad. Questo funziona perché l'altezza del pad predispone l'unità ''mm'' che viene utilizzata quando non viene fornita alcuna unità. Però fallisce se si utilizza per l'altezza del pad, ad es. '''Sketch1.Constraints.Width - Spreadsheet.B1''' perché ''Sketch1.Constraints.Width'' ha un'unità e ''Spreadsheet.B1'' no. |
In alcuni casi funziona anche senza un'unità, ad esempio se nella cella B1 del foglio di calcolo si ha solo il numero ''1,5'' e si fa riferimento ad esso per l'altezza del pad. Questo funziona perché l'altezza del pad predispone l'unità ''mm'' che viene utilizzata quando non viene fornita alcuna unità. Però fallisce se si utilizza per l'altezza del pad, ad es. '''Sketch1.Constraints.Width - Spreadsheet.B1''' perché ''Sketch1.Constraints.Width'' ha un'unità e ''Spreadsheet.B1'' no. |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Le unità con esponenti possono essere inserite direttamente. Quindi ad es. '''mm^3''' viene riconosciuto come mm³ e '''m^3''' viene riconosciuto come m³. |
Le unità con esponenti possono essere inserite direttamente. Quindi ad es. '''mm^3''' viene riconosciuto come mm³ e '''m^3''' viene riconosciuto come m³. |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
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.<<A>>''''. |
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.<<A>>''''. |
||
</div> |
|||
Il parser delle espressioni riconosce le seguenti unità: |
Il parser delle espressioni riconosce le seguenti unità: |
||
<div class="mw-translate-fuzzy"> |
|||
Quantità di sostanza: |
Quantità di sostanza: |
||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 269: | Line 463: | ||
| [https://en.wikipedia.org/wiki/Mole_(unit) Mole] |
| [https://en.wikipedia.org/wiki/Mole_(unit) Mole] |
||
|} |
|} |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Angolo: |
Angolo: |
||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 299: | Line 495: | ||
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc Minuto di arco]; alternativa all'unità ''M'' |
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc Minuto di arco]; alternativa all'unità ''M'' |
||
|} |
|} |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Corrente: |
Corrente: |
||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 317: | Line 515: | ||
| Mega[https://en.wikipedia.org/wiki/Ampere ampere] |
| Mega[https://en.wikipedia.org/wiki/Ampere ampere] |
||
|} |
|} |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Electrical Capacitance: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
!style="width: 66%;"|Description |
|||
|- |
|||
| pF |
|||
| Pico[https://en.wikipedia.org/wiki/Farad farad], {{Version|0.19}} |
|||
|- |
|||
| nF |
|||
| Nano[https://en.wikipedia.org/wiki/Farad farad], {{Version|0.19}} |
|||
|- |
|||
| uF |
|||
| Micro[https://en.wikipedia.org/wiki/Farad farad]; alternative to the unit ''µF'', {{Version|0.19}} |
|||
|- |
|||
| µF |
|||
| Micro[https://en.wikipedia.org/wiki/Farad farad]; alternative to the unit ''uF'', {{Version|0.19}} |
|||
|- |
|||
| mF |
|||
| Milli[https://en.wikipedia.org/wiki/Farad farad], {{Version|0.19}} |
|||
|- |
|||
| F |
|||
| [https://en.wikipedia.org/wiki/Farad Farad]; 1 F = 1 s^4·A^2/m^2/kg, {{Version|0.19}} |
|||
|} |
|||
Electrical Conductance: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
!style="width: 66%;"|Description |
|||
|- |
|||
| uS |
|||
| Micro[https://en.wikipedia.org/wiki/Siemens_(unit) siemens]; alternative to the unit ''µS'', {{Version|0.19}} |
|||
|- |
|||
| µS |
|||
| Micro[https://en.wikipedia.org/wiki/Siemens_(unit) siemens]; alternative to the unit ''uS'', {{Version|0.19}} |
|||
|- |
|||
| mS |
|||
| Milli[https://en.wikipedia.org/wiki/Siemens_(unit) siemens], {{Version|0.19}} |
|||
|- |
|||
| S |
|||
| [https://en.wikipedia.org/wiki/Siemens_(unit) Siemens]; 1 S = 1 s^3·A^2/kg/m^2, {{Version|0.19}} |
|||
|} |
|||
Electrical Inductance: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
!style="width: 66%;"|Description |
|||
|- |
|||
| nH |
|||
| Nano[https://en.wikipedia.org/wiki/Henry_(unit) henry], {{Version|0.19}} |
|||
|- |
|||
| uH |
|||
| Micro[https://en.wikipedia.org/wiki/Henry_(unit) henry]; alternative to the unit ''µH'', {{Version|0.19}} |
|||
|- |
|||
| µH |
|||
| Micro[https://en.wikipedia.org/wiki/Henry_(unit) henry]; alternative to the unit ''uH'', {{Version|0.19}} |
|||
|- |
|||
| mH |
|||
| Milli[https://en.wikipedia.org/wiki/Henry_(unit) henry], {{Version|0.19}} |
|||
|- |
|||
| H |
|||
| [https://en.wikipedia.org/wiki/Henry_(unit) Henry]; 1 H = 1 kg·m^2/s^2/A^2, {{Version|0.19}} |
|||
|} |
|||
Electrical Resistance: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
!style="width: 66%;"|Description |
|||
|- |
|||
| Ohm |
|||
| [https://en.wikipedia.org/wiki/Ohm Ohm]; 1 Ohm = 1 kg·m^2/s^3/A^2, {{Version|0.19}} |
|||
|- |
|||
| kOhm |
|||
| Kilo[https://en.wikipedia.org/wiki/Ohm ohm], {{Version|0.19}} |
|||
|- |
|||
| MOhm |
|||
| Mega[https://en.wikipedia.org/wiki/Ohm ohm], {{Version|0.19}} |
|||
|} |
|||
Electric Charge: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
!style="width: 66%;"|Description |
|||
|- |
|||
| C |
|||
| [https://en.wikipedia.org/wiki/Coulomb Coulomb]; 1 C = 1 A·s, {{Version|0.19}} |
|||
|} |
|||
Electric Potential: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
!style="width: 66%;"|Description |
|||
|- |
|||
| mV |
|||
| Milli[https://en.wikipedia.org/wiki/Volt volt] |
|||
|- |
|||
| V |
|||
| [https://en.wikipedia.org/wiki/Volt Volt] |
|||
|- |
|||
| kV |
|||
| Kilo[https://en.wikipedia.org/wiki/Volt volt] |
|||
|} |
|||
Energia / Lavoro: |
Energia / Lavoro: |
||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 461: | Line 559: | ||
| Kilo[https://en.wikipedia.org/wiki/Calorie calorie], {{Version/it|0.19}} |
| Kilo[https://en.wikipedia.org/wiki/Calorie calorie], {{Version/it|0.19}} |
||
|} |
|} |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Forza: |
Forza: |
||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 482: | Line 582: | ||
| [https://en.wikipedia.org/wiki/Pound_(force) Pound of force] |
| [https://en.wikipedia.org/wiki/Pound_(force) Pound of force] |
||
|} |
|} |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Lunghezza: |
Lunghezza: |
||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 536: | Line 638: | ||
| [https://en.wikipedia.org/wiki/Mile Mile] |
| [https://en.wikipedia.org/wiki/Mile Mile] |
||
|} |
|} |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Intensità luminosa: |
Intensità luminosa: |
||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 545: | Line 649: | ||
| [https://en.wikipedia.org/wiki/Candela Candela] |
| [https://en.wikipedia.org/wiki/Candela Candela] |
||
|} |
|} |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Magnetic Field Strength: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
!style="width: 66%;"|Description |
|||
|- |
|||
| Oe |
|||
| [https://en.wikipedia.org/wiki/Oersted Oersted]; 1 Oe = 79.57747 A/m, {{Version|0.19}} |
|||
|} |
|||
Magnetic Flux: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
!style="width: 66%;"|Description |
|||
|- |
|||
| Wb |
|||
| [https://en.wikipedia.org/wiki/Weber_(unit) Weber]; 1 Wb = 1 kg*m^2/s^2/A, {{Version|0.19}} |
|||
|} |
|||
Magnetic Flux Density: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
!style="width: 66%;"|Description |
|||
|- |
|||
| G |
|||
| [https://en.wikipedia.org/wiki/Gauss_(unit) Gauss]; 1 G = 1 e-4 T, {{Version|0.19}} |
|||
|- |
|||
| T |
|||
| [https://en.wikipedia.org/wiki/Tesla_(unit) Tesla]; 1 T = 1 kg/s^2/A, {{Version|0.19}} |
|||
|} |
|||
Massa: |
Massa: |
||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 614: | Line 690: | ||
| [https://en.wikipedia.org/wiki/Hundredweight Hundredweight] |
| [https://en.wikipedia.org/wiki/Hundredweight Hundredweight] |
||
|} |
|} |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Potenza: |
Potenza: |
||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 629: | Line 707: | ||
| [https://en.wikipedia.org/wiki/Volt-ampere Volt-ampere] |
| [https://en.wikipedia.org/wiki/Volt-ampere Volt-ampere] |
||
|} |
|} |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Pressione: |
Pressione: |
||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 674: | Line 754: | ||
| Mega[https://en.wikipedia.org/wiki/Pounds_per_square_inch libbre per pollice quadrato], {{Version/it|0.19}} |
| Mega[https://en.wikipedia.org/wiki/Pounds_per_square_inch libbre per pollice quadrato], {{Version/it|0.19}} |
||
|} |
|} |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Temperatura: |
Temperatura: |
||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 692: | Line 774: | ||
| [https://en.wikipedia.org/wiki/Kelvin Kelvin] |
| [https://en.wikipedia.org/wiki/Kelvin Kelvin] |
||
|} |
|} |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Tempo: |
Tempo: |
||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
Line 722: | Line 806: | ||
| Tera[https://en.wikipedia.org/wiki/Hertz hertz], {{Version/it|0.19}} |
| Tera[https://en.wikipedia.org/wiki/Hertz hertz], {{Version/it|0.19}} |
||
|} |
|} |
||
</div> |
|||
Momento meccanico: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|||
| Nm |
|||
| [https://en.wikipedia.org/wiki/Newton_metre newton metro] |
|||
|} |
|||
<div class="mw-translate-fuzzy"> |
<div class="mw-translate-fuzzy"> |
||
Line 737: | Line 813: | ||
!style="width: 33%;"|Unità |
!style="width: 33%;"|Unità |
||
!style="width: 66%;"|Descrizione |
!style="width: 66%;"|Descrizione |
||
|- |
|||
| ml |
|||
| Milli[https://en.wikipedia.org/wiki/Litre litro], {{Version/it|0.19}} |
|||
|- |
|- |
||
| l |
| l |
||
| [https://en.wikipedia.org/wiki/Litre litro] |
| [https://en.wikipedia.org/wiki/Litre litro] |
||
|- |
|||
| cft |
|||
| Cubic[https://en.wikipedia.org/wiki/Foot_(unit) foot] (piede cubico), {{Version/it|0.19}} |
|||
|} |
|} |
||
</div> |
</div> |
||
Special imperial units: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
!style="width: 66%;"|Description |
|||
|- |
|||
| mph |
|||
| [https://en.wikipedia.org/wiki/Miles_per_hour Miles per hour], {{Version|0.19}} |
|||
|- |
|||
| sqft |
|||
| [https://en.wikipedia.org/wiki/Square_foot Square foot], {{Version|0.19}} |
|||
|} |
|||
<div class="mw-translate-fuzzy"> |
<div class="mw-translate-fuzzy"> |
||
Line 762: | Line 832: | ||
!style="width: 25%;"|Alternativa |
!style="width: 25%;"|Alternativa |
||
|- |
|- |
||
| C |
| °C |
||
| [https://en.wikipedia.org/wiki/ |
| [https://en.wikipedia.org/wiki/Celsius Celsius ] |
||
| [°C] + 273.15 K |
|||
| 1 A*s |
|||
|- |
|- |
||
| |
| °F |
||
| [https://en.wikipedia.org/wiki/ |
| [https://en.wikipedia.org/wiki/Fahrenheit Fahrenheit]; |
||
| ([°F] + 459.67) × 5/9 |
|||
| 1 W/A |
|||
|- |
|||
| eV |
|||
| [https://en.wikipedia.org/wiki/Electronvolt electronvolt] |
|||
| 1.602176634e-19 J |
|||
|- |
|||
| kWh |
|||
| [https://en.wikipedia.org/wiki/Kilowatt_hour kilowatt ora] |
|||
| 3.6e6 J |
|||
|- |
|||
| bar |
|||
| [https://en.wikipedia.org/wiki/Bar_(unit) bar] |
|||
| 100 kPa |
|||
|- |
|||
| T |
|||
| [https://en.wikipedia.org/wiki/Tesla_(unit) tesla] |
|||
| 1 kg/s^2/A |
|||
|- |
|||
| F |
|||
| [https://en.wikipedia.org/wiki/Farad farad] |
|||
| 1 s^4*A^2/m^2/kg |
|||
|- |
|||
| H |
|||
| [https://en.wikipedia.org/wiki/Henry_(unit) henry] |
|||
| 1 kg*m^2/s^2/A^2 |
|||
|- |
|- |
||
| u |
| u |
||
| [https://en.wikipedia.org/wiki/Unified_atomic_mass_unit Atomic mass unit]; |
| [https://en.wikipedia.org/wiki/Unified_atomic_mass_unit Atomic mass unit]; alternative to the unit 'Da' |
||
| 1.66053906660e-27 kg |
| 1.66053906660e-27 kg |
||
|- |
|- |
||
| Da |
| Da |
||
| [https://en.wikipedia.org/wiki/Unified_atomic_mass_unit |
| [https://en.wikipedia.org/wiki/Unified_atomic_mass_unit Dalton]; alternative to the unit 'u' |
||
| 1.66053906660e-27 kg |
| 1.66053906660e-27 kg |
||
|- |
|||
| cal |
|||
| [https://en.wikipedia.org/wiki/Calorie calorie] |
|||
| 4.184 J |
|||
|- |
|- |
||
| sr |
| sr |
||
| [https://en.wikipedia.org/wiki/Steradian |
| [https://en.wikipedia.org/wiki/Steradian Steradian] |
||
| not directly |
| not directly |
||
|- |
|- |
||
| lm |
| lm |
||
| [https://en.wikipedia.org/wiki/Lumen_(unit) |
| [https://en.wikipedia.org/wiki/Lumen_(unit) Lumen] |
||
| not directly |
| not directly |
||
|- |
|- |
||
| lx |
| lx |
||
| [https://en.wikipedia.org/wiki/Lux |
| [https://en.wikipedia.org/wiki/Lux Lux] |
||
| not directly |
| not directly |
||
|- |
|- |
||
| |
| px |
||
| |
| [https://en.wikipedia.org/wiki/Pixel Pixel] |
||
| not directly |
|||
| 1000 ksi |
|||
|} |
|} |
||
</div> |
</div> |
||
==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 [[Object_name#Label|labels]] there are no invalid characters, however some characters need to be escaped: |
|||
{| class="wikitable" |
|||
!style="width: 33%;"|Characters |
|||
!style="width: 66%;"|Description |
|||
|- |
|||
| {{incode|'}}, {{incode|\}}, {{incode|"}} |
|||
| Need to be escaped by adding {{incode|\}} in front of them. |
|||
|} |
|||
For example, the label {{incode|Sketch\002}} must be referenced as {{incode|<<Sketch\\002>>}}. |
|||
===Names=== |
|||
[[Object_name#Name|Names]] of objects like dimensions, sketches, etc. may not have the characters or character sequences listed below, otherwise the name is invalid: |
|||
{| class="wikitable" |
|||
!style="width: 33%;"|Characters / Character sequences |
|||
!style="width: 66%;"|Description |
|||
|- |
|||
| '''+''', '''-''', '''*''', '''/''', '''^''', '''_''', '''<''', '''>''', '''(''', ''')''', '''{''', '''}''', '''[''', ''']''', '''.''', ''',''', '''=''' |
|||
| Characters that are math operators or part of mathematical constructs |
|||
|- |
|||
| '''A''', '''kA''', '''mA''', '''MA''', '''C''', '''G''', '''F''', '''uF''', '''µF''', '''J''', '''K''', ''' ' ''', ''' ft ''', '''°''', and many more! |
|||
| Characters and character sequences that are [[Expressions#Units|units]] |
|||
|- |
|||
| '''#''', '''!''', '''?''', '''§''', '''$''', '''%''', '''&''', ''':''', ''';''', '''\''', '''<nowiki>|</nowiki>''', '''~''', '''∆''', '''¿''', and many more! |
|||
| Characters used as placeholder or to trigger special operations |
|||
|- |
|||
| '''pi''', '''e''' |
|||
| Mathematical constants |
|||
|- |
|||
| '''´''', '''`''', ''' ' ''', '''"''' |
|||
| Characters used for accents |
|||
|- |
|||
| space |
|||
| A space defines the end of a name and can therefore not be used |
|||
|} |
|||
For example, the following name is valid: {{incode|<<Sketch>>.Constraints.T2üßµ@}}. While these are invalid names: {{incode|<<Sketch>>.Constraints.test\result_2}} (\r means "carriage return") or {{incode|<<Sketch>>.Constraints.mol}} (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. |
|||
===Cell aliases=== |
|||
For [[Spreadsheet_SetAlias|spreadsheet cell aliases]] only alphanumeric characters and underscores ({{incode|A}} to {{incode|Z}}, {{incode|a}} to {{incode|z}}, {{incode|0}} to {{incode|9}} and {{incode|_}}) are allowed. |
|||
<div class="mw-translate-fuzzy"> |
|||
==Riferimento ai dati CAD== |
==Riferimento ai dati CAD== |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
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. |
|||
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. |
|||
</div> |
|||
<div class="mw-translate-fuzzy"> |
<div class="mw-translate-fuzzy"> |
||
Line 836: | Line 936: | ||
|- |
|- |
||
|Lunghezza parametrica di un Cubo di Parte |
|Lunghezza parametrica di un Cubo di Parte |
||
|Cube.Length |
|{{incode|Cube.Length}} |
||
|Lunghezza con unità in mm |
|{{incode|Length}} Lunghezza con unità in mm |
||
|- |
|- |
||
|Volume del Cubo |
|Volume del Cubo |
||
|Cube.Shape.Volume |
|{{incode|Cube.Shape.Volume}} |
||
|Volume |
|{{incode|Volume}} in mm³ senza unità |
||
|- |
|- |
||
|Tipo di forma del Cubo |
|Tipo di forma del Cubo |
||
|Cube.Shape.ShapeType |
|{{incode|Cube.Shape.ShapeType}} |
||
|Stringa: Solid |
|Stringa: Solid |
||
|- |
|- |
||
|Etichetta del Cubo |
|Etichetta del Cubo |
||
|Cube.Label |
|{{incode|Cube.Label}} |
||
|Stringa: Label |
|Stringa: Label |
||
|- |
|- |
||
| |
|Coordinata x del centro di massa del Cubo |
||
|Cube.Shape.CenterOfMass.x |
|{{incode|Cube.Shape.CenterOfMass.x}} |
||
| |
|Coordinata x in mm senza unità |
||
|- |
|- |
||
|Valore di un vincolo in uno schizzo |
|Valore di un vincolo in uno schizzo |
||
|Constraints.Width |
|{{incode|Constraints.Width}} |
||
|Valore numerico del vincolo di nome 'Width' nello schizzo, se l'espressione è utilizzata nello schizzo stesso. |
|Valore numerico del vincolo di nome '{{incode|Width}}' nello schizzo, se l'espressione è utilizzata nello schizzo stesso. |
||
|- |
|- |
||
|Valore di un vincolo in uno schizzo |
|Valore di un vincolo in uno schizzo |
||
|MySketch.Constraints.Width |
|{{incode|MySketch.Constraints.Width}} |
||
|Valore numerico del vincolo di nome 'Width' nello schizzo, se l'espressione è usata al di fuori dello schizzo. |
|Valore numerico del vincolo di nome '{{incode|Width}}' nello schizzo, se l'espressione è usata al di fuori dello schizzo. |
||
|- |
|- |
||
|Valore di un alias in spreadsheet |
|Valore di un alias in spreadsheet |
||
|Spreadsheet.Depth |
|{{incode|Spreadsheet.Depth}} |
||
|Valore dell'alias "Depth" nel foglio "Spreadsheet" |
|Valore dell'alias "{{incode|Depth}}" nel foglio "{{incode|Spreadsheet}}" |
||
|- |
|- |
||
|Valore di una proprietà locale |
|Valore di una proprietà locale |
||
|Length |
|{{incode|Length}} |
||
|Valore della proprietà Length |
|Valore della proprietà {{incode|Length}} ad es. di un oggetto Pad, se l'espressione viene utilizzata, ad esempio, in Length2 nello stesso oggetto. |
||
|} |
|} |
||
</div> |
</div> |
||
Line 879: | Line 979: | ||
== Riferimenti incrociati nel documento == |
== Riferimenti incrociati nel documento == |
||
<div class="mw-translate-fuzzy"> |
|||
È 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 (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. |
||
</div> |
|||
È 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. |
È 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. |
||
<div class="mw-translate-fuzzy"> |
<div class="mw-translate-fuzzy"> |
||
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", |
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 "{{incode|master}}", il foglio di calcolo sia stato rinominato "{{incode|modelConstants}}" e a una cella sia stato assegnato un nome alias "{{incode|Length}}", si può quindi accedere al valore con: |
||
</div> |
</div> |
||
<div class="mw-translate-fuzzy"> |
<div class="mw-translate-fuzzy"> |
||
master#modelConstants.Length |
{{Code|code=master#modelConstants.Length}} |
||
</div> |
</div> |
||
'''Notare''' che il documento master deve sempre essere caricato affinché i valori del master siano disponibili per il documento dipendente. |
|||
<div class="mw-translate-fuzzy"> |
|||
Notare che il documento master deve sempre essere caricato affinché i valori del master siano disponibili per il documento dipendente. |
|||
</div> |
|||
Purtroppo, il checker integrato a volte afferma che un nome valido non esiste. Continuare comunque a digitare. Quando il riferimento è completato, il pulsante {{Button|OK}} diventa attivo. |
Purtroppo, il checker integrato a volte afferma che un nome valido non esiste. Continuare comunque a digitare. Quando il riferimento è completato, il pulsante {{Button|OK}} diventa attivo. |
||
Line 904: | Line 1,004: | ||
* 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. |
* 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. |
* 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 {{Button|OK}} 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. |
* 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 [https://forum.freecadweb.org/viewtopic.php?p=302500#p302381; discussione nel forum]. |
* I nomi dei vincoli di Sketcher non devono contenere spazi vuoti quando il valore è calcolato da un'espressione, vedere questa [https://forum.freecadweb.org/viewtopic.php?p=302500#p302381; discussione nel forum]. |
||
* I bug aperti per le espressioni si trovano in [https://freecadweb.org/tracker/set_project.php?project_id=4;20 FreeCAD Bugtracker Expressions category] |
* I bug aperti per le espressioni si trovano in [https://freecadweb.org/tracker/set_project.php?project_id=4;20 FreeCAD Bugtracker Expressions category] |
||
</div> |
</div> |
||
{{Powerdocnavi{{#translation:}}}} |
{{Powerdocnavi{{#translation:}}}} |
||
[[Category:Spreadsheet{{#translation:}}]] |
[[Category:Spreadsheet{{#translation:}}]] |
||
{{clear}} |
Revision as of 15:01, 28 October 2021
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 File:Sketcher Expressions.png. 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.
Function arguments
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.
Arguments may include references to cells in a spreadsheet. A cell reference consists of the cell's uppercase row letter followed by its column number, for example A1
. A cell may also be referenced by using the cell's alias instead, for example Spreadsheet.MyPartWidth
.
Riferimenti a oggetti
Si può fare riferimento a un oggetto tramite il suo Name
o la sua Label
. Nel caso di una Label
, essa deve essere racchiusa tra i simboli <<
e >>
, come questa: <<Label>>
.
È possibile fare riferimento a qualsiasi proprietà numerica di un oggetto. Ad esempio, per fare riferimento all'altezza di un cilindro, è possibile utilizzare Cylinder.Height
o <<Long_name_of_cylinder>>.Height
.
Per fare riferimento agli oggetti dell'elenco, la sintassi è <<object_label>>.list[list_index]
o object_name.list[list_index]
. Se ad esempio si desidera fare riferimento a un vincolo in uno schizzo, si può farlo usando questa sintassi
<<MySketch>>.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.
Costanti supportate
Sono supportate le seguenti costanti:
Constante | Descrizione |
---|---|
e | Numero di Eulero |
pi | Pi greco |
Supported operators
Sono supportati i seguenti operatori:
Operatore | Descrizione |
---|---|
+ | Addizione |
- | Sottrazione |
* | Multiplicazione |
/ | Divisione virgola mobile |
% | Resto |
^ | Potenze |
Funzioni supportate
Funzioni matematiche generali
Le funzioni matematiche elencate di seguito sono disponibili.
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). Se un'espressione è senza unità e per compatibilità deve essere convertita in gradi o radianti,, moltiplicare per 1 deg, 1 ° o 1 rad secondo il caso, ad es. (360 - X) * 1deg; (360 - X) * 1°; (0.5 + pi / 2) * 1rad.
Sono supportate le seguenti funzioni trigonometriche:
Funzione | Descrizione | Intervallo di valori |
---|---|---|
acos(x) | Arc cosine | -1 <= x <= 1 |
asin(x) | Arc sine | -1 <= x <= 1 |
atan(x) | Arc tangent | tutti |
atan2(x, y) | Arc tangent of x/y | tutti, eccetto y = 0 |
cos(x) | Cosine | tutti |
cosh(x) | Hyperbolic cosine | tutti |
sin(x) | Sine | tutti |
sinh(x) | Hyperbolic sine | tutti |
tan(x) | Tangent | tutti, eccetto x = n·90 con n = intero |
tanh(x) | Hyperbolic tangent | tutti |
Per esponenziazione e logaritmizzazione sono supportate le seguenti funzioni:
Funzione | Descrizione | Intervallo di valori |
---|---|---|
exp(x) | Exponential function | tutti |
log(x) | Natural logarithm | x > 0 |
log10(x) | Common logarithm | x > 0 |
pow(x, y) | Exponentiation | all |
sqrt(x) | Square root | x >= 0 |
Per arrotondamento, troncamento e resto sono supportate queste funzioni :
Funzione | Descrizione | Intervallo di valori |
---|---|---|
abs(x) | Valore assoluto | tutti |
ceil(x) | Parte intera superiore valore intero più piccolo maggiore o uguale a x | tutti |
floor(x) | Parte intera inferiore, valore intero più grande minore o uguale a x | tutti |
mod(x, y) | Resto dopo aver diviso x per y | tutti, eccetto y = 0 |
round(x) | Arrotondamento al numero intero più vicino | tutti |
trunc(x) | Troncamento al numero intero più vicino | tutti |
Statistical / aggregate functions
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).
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 average(B1:B8)
or sum(A1:A4; B1:B4)
.
The cell references may also use cell aliases, for example average(StartTemp:EndTemp)
.
Sono supportate queste funzioni aggregate :
Funzione | Descrizione | Intervallo di valori |
---|---|---|
average(x:y) | Media aritmetica dei valori nelle celle da x a y; sum(x:y) / count(x:y) | tutti |
count(x:y) | Conteggio di celle da x a y | tutti |
max(x:y) | Massimo valore nelle celle da x a y | tutti |
min(x:y) | Minimo valore nelle celle da x a y | tutti |
stddev(x:y) | Deviazione standard dei valori nelle celle da x a y | tutti |
sum(x: y) | Somma dei valori nelle celle da x a y | tutti |
String manipulation
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 : <<TEXT>>
String concatenation
Strings can be concatenated using the '+' sign.
Following example <<MY>> + <<TEXT>>
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 <<Cube length : %s>> % Box.Length
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 <<Cube length is %s>> % Box.Length + << and width is %s>> % Box.Width
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
Create function
The following objects may be created in expressions via the create
function:
- Vector
- Matrix
- Rotation
- Placement
The create
function passes subsequent arguments to the underlying Python constructor when creating the object.
Various mathematical operations such as multiplication, addition, and subtraction are supported via standard mathematical operators (e.g. *
, +
, -
).
Vector
When create
is passed <<vector>>
as the 1st argument, the next 3 arguments are the X, Y, and Z coordinates for the Vector
respectively.
Example:
create(<<vector>>; 2; 1; 2)
Matrix
When create
is passed <<matrix>>
as the 1st argument, the next 16 arguments are the elements for the Matrix
in row-major order.
Example:
create(<<matrix>>; 1; 2; 3; 4; 5; 6; 7; 8; 9; 10; 11; 12; 13; 14; 15; 16)
Rotation
When create
is passed <<rotation>>
as the 1st argument, there are two ways to create a Rotation
:
1. Specify an axis vector and a rotation angle.
Example:
create(<<rotation>>; create(<<vector>>; 0; 1; 0); 45)
2. Specify 3 rotations about the X, Y, and Z axes as Euler angles.
Example:
create(<<rotation>>; 30; 30; 30)
Placement
When create
is passed <<placement>>
as the 1st argument, there are five ways to create a Placement
.
These possible combinations are documented in the below table and are based on the Placement API page.
Number of arguments | Description |
---|---|
2 | create(<<placement>>; Placement)
|
2 | create(<<placement>>; Matrix)
|
3 | create(<<placement>>; Base; Rotation)
|
4 | create(<<placement>>; Base; Rotation; Center)
|
4 | create(<<placement>>; Base; Axis; Angle)
|
The following example shows the syntax for creating a Placement
from a Base
(vector) and a Rotation
:
create(<<placement>>; create(<<vector>>; 2; 1; 2); create(<<rotation>>; create(<<vector>>; 0; 1; 0); 45))
For readability, you can define vectors and rotations in separate cells, and then reference the cells in your expression.
Matrix functions
mscale
Scale a Matrix
with a given Vector
.
mscale(Matrix; Vector)
mscale(Matrix; x; y; z)
minvert
Invert the given Matrix
, Rotation
, or Placement
.
minvert(Matrix)
minvert(Rotation)
minvert(Placement)
Tuple & list
You can create Python tuple
or list
objects via their respective functions.
tuple(2; 1; 2)
list(2; 1; 2)
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). Notare che racchiudere l'espressione condizionale tra parentesi è attualmente considerato un errore. versione 0.19 e precedenti
Sono definiti i seguenti operatori relazionali:
Operatore | Descrizione |
---|---|
== | uguale |
!= | diverso |
> | maggiore |
< | minore |
>= | maggiore o uguale |
<= | minore o uguale |
Unità
Le unità possono essere utilizzate direttamente nelle espressioni. Il parser le collega al valore precedente. Quindi '2mm' o '2 mm' è valido mentre 'mm' 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 1,5 e si fa riferimento ad esso per l'altezza del pad. Questo funziona perché l'altezza del pad predispone l'unità mm che viene utilizzata quando non viene fornita alcuna unità. Però fallisce se si utilizza per l'altezza del pad, ad es. Sketch1.Constraints.Width - Spreadsheet.B1 perché Sketch1.Constraints.Width ha un'unità e Spreadsheet.B1 no.
Le unità con esponenti possono essere inserite direttamente. Quindi ad es. mm^3 viene riconosciuto come mm³ e m^3 viene riconosciuto come 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.<<A>>'.
Il parser delle espressioni riconosce le seguenti unità:
Angolo:
Unità | Descrizione |
---|---|
° | Grado; alternativa all'unità deg |
deg | Grado; alternativa all'unità ° |
rad | Radiante |
gon | Gradiante |
S | Secondo di arco |
″ | Secondo di arco; alternativa all'unità S |
M | Minuto di arco |
′ | Minuto di arco; alternativa all'unità M |
Energia / Lavoro:
Unità | Descrizione |
---|---|
mJ | Millijoule |
J | Joule |
kJ | Kilojoule, disponibile dalla versione 0.19 |
eV | Elettronvolt; 1 ev = 1.602176634e-19 J, disponibile dalla versione 0.19 |
keV | Kiloelettronvolt, disponibile dalla versione 0.19 |
MeV | Megaelettronvolt, disponibile dalla versione 0.19 |
kWh | Kilowattora; 1 kWh = 3.6e6 J, disponibile dalla versione 0.19 |
Ws | Watt second; alternativa all'unità Joule |
VAs | Volt-ampere-second; alternativa all'unità Joule |
CV | Coulomb-volt; alternativa all'unità Joule |
cal | Calorie; 1 cal = 4.184 J, disponibile dalla versione 0.19 |
kcal | Kilocalorie, disponibile dalla versione 0.19 |
Forza:
Unità | Descrizione |
---|---|
mN | Millinewton |
N | Newton |
kN | Kilonewton |
MN | Meganewton |
lbf | Pound of force |
Lunghezza:
Unità | Descrizione |
---|---|
nm | Nanometer |
um | Micrometer; alternativa all'unità µm |
µm | Micrometer; alternativa all'unità mu |
mm | Millimeter |
cm | Centimeter |
mm | Millimeter |
dm | Decimeter |
m | Meter |
km | Kilometer |
mil | Thousandth of an inch; alternativa all'unità thou |
thou | Thousandth of an inch; alternativa all'unità mil |
in | Inch |
ft | Foot; alternativa all'unità ' |
' | Foot; alternativa all'unità ft |
yd | Yard |
mi | Mile |
Intensità luminosa:
Unità | Descrizione |
---|---|
cd | Candela |
Massa:
Unità | Descrizione |
---|---|
ug | Microgram; alternativa all'unità µg |
µg | Microgram; alternativa all'unità ug |
mg | Milligram |
g | Gram |
kg | Kilogram |
t | Tonne |
oz | Ounce |
lb | Pound; alternativa all'unità lbm |
lbm | Pound; alternativa all'unità lb |
st | Stone |
cwt | Hundredweight |
Potenza:
Unità | Descrizione |
---|---|
W | Watt |
kW | Kilowatt, disponibile dalla versione 0.19 |
VA | Volt-ampere |
Pressione:
Unità | Descrizione |
---|---|
Pa | pascal |
kPa | Kilopascal |
MPa | Megapascal |
GPa | Gigapascal |
mbar | Millibar, disponibile dalla versione 0.19 |
bar | bar, disponibile dalla versione 0.19 |
uTorr | Microtorr; alternativa all'unità µTorr |
µTorr | Microtorr; alternativa all'unità uTorr |
mTorr | Millitorr |
Torr | torr; 1 Torr = 133.32 Pa |
psi | libbre per pollice quadrato; 1 psi = 6.895 kPa |
ksi | Kilolibbre per pollice quadrato |
Mpsi | Megalibbre per pollice quadrato, disponibile dalla versione 0.19 |
Temperatura:
Unità | Descrizione |
---|---|
uK | Microkelvin; alternativa all'unità µK |
µK | Microkelvin; alternativa all'unità uK |
mK | Millikelvin |
K | Kelvin |
Tempo:
Unità | Descrizione |
---|---|
s | secondo |
min | minuto |
h | ora |
Hz (1/s) | Hertz, disponibile dalla versione 0.19 |
kHz | Kilohertz, disponibile dalla versione 0.19 |
MHz | Megahertz, disponibile dalla versione 0.19 |
GHz | Gigahertz, disponibile dalla versione 0.19 |
THz | Terahertz, disponibile dalla versione 0.19 |
Volume:
Unità | Descrizione |
---|---|
ml | Millilitro, disponibile dalla versione 0.19 |
l | litro |
cft | Cubicfoot (piede cubico), disponibile dalla versione 0.19 |
Le seguenti unità comunemente utilizzate non sono ancora supportate:
Unità | Descrizione | Alternativa |
---|---|---|
°C | Celsius | [°C] + 273.15 K |
°F | Fahrenheit; | ([°F] + 459.67) × 5/9 |
u | Atomic mass unit; alternative to the unit 'Da' | 1.66053906660e-27 kg |
Da | Dalton; alternative to the unit 'u' | 1.66053906660e-27 kg |
sr | Steradian | not directly |
lm | Lumen | not directly |
lx | Lux | not directly |
px | Pixel | not directly |
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:
Characters | Description |
---|---|
' , \ , "
|
Need to be escaped by adding \ in front of them.
|
For example, the label Sketch\002
must be referenced as <<Sketch\\002>>
.
Names
Names of objects like dimensions, sketches, etc. may not have the characters or character sequences listed below, otherwise the name is invalid:
Characters / Character sequences | Description |
---|---|
+, -, *, /, ^, _, <, >, (, ), {, }, [, ], ., ,, = | Characters that are math operators or part of mathematical constructs |
A, kA, mA, MA, C, G, F, uF, µF, J, K, ' , ft , °, and many more! | Characters and character sequences that are units |
#, !, ?, §, $, %, &, :, ;, \, |, ~, ∆, ¿, and many more! | Characters used as placeholder or to trigger special operations |
pi, e | Mathematical constants |
´, `, ' , " | Characters used for accents |
space | A space defines the end of a name and can therefore not be used |
For example, the following name is valid: <<Sketch>>.Constraints.T2üßµ@
. While these are invalid names: <<Sketch>>.Constraints.test\result_2
(\r means "carriage return") or <<Sketch>>.Constraints.mol
(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.
Cell aliases
For spreadsheet cell aliases only alphanumeric characters and underscores (A
to Z
, a
to z
, 0
to 9
and _
) are allowed.
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:
Dati CAD | Chiamata nell'espressione | Risultato |
---|---|---|
Lunghezza parametrica di un Cubo di Parte | Cube.Length
|
Length Lunghezza con unità in mm
|
Volume del Cubo | Cube.Shape.Volume
|
Volume in mm³ senza unità
|
Tipo di forma del Cubo | Cube.Shape.ShapeType
|
Stringa: Solid |
Etichetta del Cubo | Cube.Label
|
Stringa: Label |
Coordinata x del centro di massa del Cubo | Cube.Shape.CenterOfMass.x
|
Coordinata x in mm senza unità |
Valore di un vincolo in uno schizzo | Constraints.Width
|
Valore numerico del vincolo di nome 'Width ' nello schizzo, se l'espressione è utilizzata nello schizzo stesso.
|
Valore di un vincolo in uno schizzo | MySketch.Constraints.Width
|
Valore numerico del vincolo di nome 'Width ' nello schizzo, se l'espressione è usata al di fuori dello schizzo.
|
Valore di un alias in spreadsheet | Spreadsheet.Depth
|
Valore dell'alias "Depth " nel foglio "Spreadsheet "
|
Valore di una proprietà locale | Length
|
Valore della proprietà Length ad es. di un oggetto Pad, se l'espressione viene utilizzata, ad esempio, in Length2 nello stesso oggetto.
|
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
È 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 "master
", il foglio di calcolo sia stato rinominato "modelConstants
" e a una cella sia stato assegnato un nome alias "Length
", si può quindi accedere al valore con:
master#modelConstants.Length
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 OK 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.
- 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 OK 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
- FreeCAD scripting: Python, Introduction to Python, Python scripting tutorial, FreeCAD Scripting Basics
- Modules: Builtin modules, Units, Quantity
- Workbenches: Workbench creation, Gui Commands, Commands, Installing more workbenches
- Meshes and Parts: Mesh Scripting, Topological data scripting, Mesh to Part, PythonOCC
- Parametric objects: Scripted objects, Viewproviders (Custom icon in tree view)
- Scenegraph: Coin (Inventor) scenegraph, Pivy
- Graphical interface: Interface creation, Interface creation completely in Python (1, 2, 3, 4, 5), PySide, PySide examples beginner, intermediate, advanced
- Macros: Macros, How to install macros
- Embedding: Embedding FreeCAD, Embedding FreeCADGui
- Other: Expressions, Code snippets, Line drawing function, FreeCAD vector math library (deprecated)
- Hubs: User hub, Power users hub, Developer hub