Difference between revisions of "Expressions/it"

From FreeCAD Documentation
Jump to: navigation, search
(Created page with "Le seguenti unità comunemente utilizzate non sono ancora supportate: {| class="wikitable float-right mw-collapsible mw-collapsed" !style="width: 25%;"|Unità !style="width: 5...")
 
(59 intermediate revisions by 2 users not shown)
Line 7: Line 7:
 
È 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|24px]]. Cliccando sull'icona, oppure digitando il segno di uguale (=), 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|24px]]. Cliccando sull'icona, oppure digitando il segno di uguale (=), si porta in primo piano l'editor delle espressioni per quella particolare proprietà.
  
<div class="mw-translate-fuzzy">
+
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 normale notazione per gli operatori matematici standard (+, -, * e /) e le funzioni come descritto in seguito. Inoltre, l'espressione può fare riferimento ad altre proprietà, e anche utilizzare le condizioni. I numeri di un'espressione possono opzionalmente essere collegati ad una unità di misura.
 
</div>
 
  
Numbers may use either a comma ',' or a decimal point '.' separating whole digits from decimals.
+
I numeri possono usare una virgola ',' o un punto '.' per separare le cifre intere dai decimali.
When the decimal marker is used, it ''must'' be followed by at least one digit.
+
Quando viene utilizzato il separatore decimale, esso "deve" essere seguito da almeno una cifra.
Thus, the expressions '''1.+2.''' and '''1,+2,''' are invalid, but '''1.0 + 2.0''' and '''1,0 + 2,0''' are valid.
+
Pertanto, le espressioni '''1.+2.''' e '''1,+2,''' non sono valide, ma '''1.0+2.0''' e '''1,0+2,0''' sono validi.
  
<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).
 
</div>
 
  
You can use [[#Supported Constants|predefined constants]] and [[#Supported Functions|functions]].
+
Si possono usare le [[#Costanti supportate|costanti predefinite]] e le [[#Funzioni supportate|funzioni]].
  
===Referencing objects===
+
===Riferimenti a oggetti===
  
You can reference to an object by its {{incode|Name}} or by its {{incode|Label}}. In the case of a {{incode|Label}}, it must be enclosed in double {{incode|<<}} and {{incode|>>}} symbols, such as {{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>>}}.
  
You can reference any numerical property of this object. For example, to refer to a Cylinder's height, you may use {{incode|Cylinder.Height}} or {{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}}.
  
To reference list objects, the syntax is {{incode|object_name.list[list_index]}}. If you want for example reference a constraint in a sketch, hover with the mouse over this constraint and look in the footer of FreeCAD's main window. Assuming you see there ''Sketch_name.Constraint17'', then you reference it this way: '''Sketch_name.Constraints[16]''' (The index starts with 0, therefore constraint 17 has the index 16.) If you are in the same sketch you can omit its name and just use '''Constraints[16]'''.
+
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/>
 +
'''Nota:''' L'indice inizia con 0, quindi il vincolo 17 ha l'indice 16.  
  
For more info about referencing objects, see [[#Reference To CAD-Data|this section]].
+
Per ulteriori informazioni sul riferimento a oggetti, vedere [[#Riferimento ai dati CAD|questa sezione]].
  
==Supported Operators==
+
==Operatori supportati==
  
The following operators are supported:
+
Sono supportati i seguenti operatori:
 
{| class="wikitable float-right mw-collapsible mw-uncollapsed"
 
{| class="wikitable float-right mw-collapsible mw-uncollapsed"
!style="width: 33%;"|Operator
+
!style="width: 33%;"|Operatore
!style="width: 66%;"|Description
+
!style="width: 66%;"|Descrizione
 
|-
 
|-
 
| +
 
| +
| [https://en.wikipedia.org/wiki/Addition Addition]
+
| [https://en.wikipedia.org/wiki/Addition Addizione]
 
|-
 
|-
 
| -
 
| -
| [https://en.wikipedia.org/wiki/Subtraction Subtraction]
+
| [https://en.wikipedia.org/wiki/Subtraction Sottrazione]
 
|-
 
|-
 
| *
 
| *
| [https://en.wikipedia.org/wiki/Multiplication Multiplication]
+
| [https://en.wikipedia.org/wiki/Multiplication Multiplicazione]
 
|-
 
|-
 
| /
 
| /
| [https://en.wikipedia.org/wiki/Division_(mathematics) Division]
+
| [https://en.wikipedia.org/wiki/Division_(mathematics) Divisione]
 
|-
 
|-
 
| ^
 
| ^
| [https://en.wikipedia.org/wiki/Exponentiation Exponentiation]
+
| [https://en.wikipedia.org/wiki/Exponentiation Potenze]
 
|}
 
|}
  
<div class="mw-translate-fuzzy">
+
== Costanti supportate ==
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.
 
</div>
 
  
<div class="mw-translate-fuzzy">
+
Sono supportate le seguenti costanti:
{{APIFunction  |abs|x|  Absolute value | value <nowiki> >= 0 </nowiki> }}
+
{| class="wikitable float-right mw-collapsible mw-uncollapsed"
{{APIFunction  |acos|x|  Arc cosine; <nowiki> -1  <=  x <=  1 </nowiki> | acos(x)  }}
+
!style="width: 33%;"|Constante
{{APIFunction  |asin|x|  Arc sine; <nowiki> -1 <= x <= 1 </nowiki> | asin(x) }}
+
!style="width: 66%;"|Descrizione
{{APIFunction  |atan|x|  Arc tangent | atan(x) }}
+
|-
{{APIFunction  |atan2|y, x|  Arc tangent of y / x; | atan2(y,x) }}
+
| e
{{APIFunction  |ceil|x|  Ceiling | The smallest integer value greater than or equal to x {{Version|0.16}} }}
+
| [https://en.wikipedia.org/wiki/E_(mathematical_constant) Numero di Eulero]
{{APIFunction  |cos|angle|  Cosine; angle is in degrees (any value) | <nowiki> -1 <= cos(x) <= 1 </nowiki> }}
+
|-
{{APIFunction  |cosh|x| Hyperbolic cosine of x | cosh(x) }}
+
| pi
{{APIFunction  |exp|y|  Natural exponent | e<sup> y</sup> }}
+
| [https://en.wikipedia.org/wiki/Pi Pi greco]
{{APIFunction  |floor|x|  Floor | The largest integer value less than or equal to x {{Version|0.16}} }}
+
|}
{{APIFunction  |log|x|  Natural logarithm | log<sub>e</sub> x }}
 
{{APIFunction  |log10|x|  Logarithm base 10 | log<sub>10</sub> x }}
 
{{APIFunction  |mod|x, y| Remainder x/y | Remainder after dividing x by y }}
 
{{APIFunction  |pow|x, y| Power function| x<sup> y</sup> }}
 
{{APIFunction  |round|x| | x rounded to the nearest integer {{Version|0.16}} }}
 
{{APIFunction  |sin|angle| Cosine; angle in degrees (any value) | <nowiki> -1 <= sin(x) <= 1 </nowiki> }}
 
{{APIFunction  |sinh|x|  Hyperbolic sine of x | sinh(x) }}
 
{{APIFunction  |sqrt|x|  Square root; <nowiki> x >= 0 </nowiki> | Square root of x }}
 
{{APIFunction  |tan|angle| Tangent; angle in degrees (any value) | tan(angle) }}
 
{{APIFunction  |tanh|x|  Hyperbolic tangent of x | tanh(x) }}
 
{{APIFunction  |trunc|x|  Truncate | x truncated to the nearest integer {{Version|0.16}} }}
 
</div>
 
  
== Funzioni Supportate ==
+
== Funzioni supportate ==
  
=== General Mathematical Functions ===
+
=== Funzioni matematiche generali ===
  
 
Le funzioni matematiche elencate di seguito sono disponibili.
 
Le funzioni matematiche elencate di seguito sono disponibili.
  
Multiple arguments to a function may be separated by either a semicolon ';' or a comma <em>followed by a space</em> ', '. In the latter case, the comma is converted to a semicolon after entry. When a semicolon is used, no trailing space is necessary.
+
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.
  
[https://en.wikipedia.org/wiki/Trigonometric_functions Trigonometric functions] use degree as their default unit. For radian measure, add '''rad''' following the <em>first</em> value in an expression. So e.g. '''cos(45)''' is the same as '''cos(pi rad / 4)'''.<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)'''.<br/>
These trigonometric functions are supported:
+
Sono supportate le seguenti funzioni trigonometriche:
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Function
+
!style="width: 33%;"|Funzione
!style="width: 33%;"|Description
+
!style="width: 33%;"|Descrizione
!style="width: 33%;"|Value range
+
!style="width: 33%;"|Intervallo di valori
 
|-
 
|-
 
| acos(x)
 
| acos(x)
Line 107: Line 91:
 
| atan(x)
 
| atan(x)
 
| [https://en.wikipedia.org/wiki/Inverse_trigonometric_functions#Basic_properties Arc tangent]
 
| [https://en.wikipedia.org/wiki/Inverse_trigonometric_functions#Basic_properties Arc tangent]
| all
+
| tutti
 
|-
 
|-
 
| atan2(x, y)
 
| atan2(x, y)
 
| [https://en.wikipedia.org/wiki/Inverse_trigonometric_functions#Basic_properties Arc tangent] of ''x/y''
 
| [https://en.wikipedia.org/wiki/Inverse_trigonometric_functions#Basic_properties Arc tangent] of ''x/y''
| all, except y = 0
+
| tutti, eccetto y = 0
 
|-
 
|-
 
| cos(x)
 
| cos(x)
 
| [https://en.wikipedia.org/wiki/Trigonometric_functions#Right-angled_triangle_definitions Cosine]
 
| [https://en.wikipedia.org/wiki/Trigonometric_functions#Right-angled_triangle_definitions Cosine]
| all
+
| tutti
 
|-
 
|-
 
| cosh(x)
 
| cosh(x)
 
| [https://en.wikipedia.org/wiki/Hyperbolic_function#Trigonometric_definitions Hyperbolic cosine]
 
| [https://en.wikipedia.org/wiki/Hyperbolic_function#Trigonometric_definitions Hyperbolic cosine]
| all
+
| tutti
 
|-
 
|-
 
| sin(x)
 
| sin(x)
 
| [https://en.wikipedia.org/wiki/Trigonometric_functions#Right-angled_triangle_definitions Sine]
 
| [https://en.wikipedia.org/wiki/Trigonometric_functions#Right-angled_triangle_definitions Sine]
| all
+
| tutti
 
|-
 
|-
 
| sinh(x)
 
| sinh(x)
 
| [https://en.wikipedia.org/wiki/Hyperbolic_function#Trigonometric_definitions Hyperbolic sine]
 
| [https://en.wikipedia.org/wiki/Hyperbolic_function#Trigonometric_definitions Hyperbolic sine]
| all
+
| tutti
 
|-
 
|-
 
| tan(x)
 
| tan(x)
 
| [https://en.wikipedia.org/wiki/Trigonometric_functions#Right-angled_triangle_definitions Tangent]
 
| [https://en.wikipedia.org/wiki/Trigonometric_functions#Right-angled_triangle_definitions Tangent]
| all, except of x = n·90 with n = integer
+
| tutti, eccetto x = n·90 con n = intero
 
|-
 
|-
 
| tanh(x)
 
| tanh(x)
 
| [https://en.wikipedia.org/wiki/Hyperbolic_function#Trigonometric_definitions Hyperbolic tangent]
 
| [https://en.wikipedia.org/wiki/Hyperbolic_function#Trigonometric_definitions Hyperbolic tangent]
| all
+
| tutti
 
|}
 
|}
  
These functions for exponentiation and logarithmization are supported:
+
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"
!style="width: 33%;"|Function
+
!style="width: 33%;"|Funzione
!style="width: 33%;"|Description
+
!style="width: 33%;"|Descrizione
!style="width: 33%;"|Value range
+
!style="width: 33%;"|Intervallo di valori
 
|-
 
|-
 
| exp(x)
 
| exp(x)
 
| [https://en.wikipedia.org/wiki/Exponential_function#Formal_definition Exponential function]
 
| [https://en.wikipedia.org/wiki/Exponential_function#Formal_definition Exponential function]
| all
+
| tutti
 
|-
 
|-
 
| log(x)
 
| log(x)
Line 165: Line 149:
 
|}
 
|}
  
These functions for rounding, truncation and remainder are supported:
+
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"
!style="width: 20%;"|Function
+
!style="width: 20%;"|Funzione
!style="width: 55%;"|Description
+
!style="width: 55%;"|Descrizione
!style="width: 25%;"|Value range
+
!style="width: 25%;"|Intervallo di valori
 
|-
 
|-
 
| abs(x)
 
| abs(x)
| [https://en.wikipedia.org/wiki/Absolute_value Absolute value]
+
| [https://en.wikipedia.org/wiki/Absolute_value Valore assoluto]
| all
+
| tutti
 
|-
 
|-
 
| ceil(x)
 
| ceil(x)
| [https://en.wikipedia.org/wiki/Floor_and_ceiling_functions Ceiling function] smallest integer value greater than or equal to x
+
| [https://en.wikipedia.org/wiki/Floor_and_ceiling_functions Parte intera superiore] valore intero più piccolo maggiore o uguale a x
| all
+
| tutti
 
|-
 
|-
 
| floor(x)
 
| floor(x)
| [https://en.wikipedia.org/wiki/Floor_and_ceiling_functions Floor function], largest integer value less than or equal to x
+
| [https://en.wikipedia.org/wiki/Floor_and_ceiling_functions Parte intera inferiore], valore intero più grande minore o uguale a x
| all
+
| tutti
 
|-
 
|-
 
| mod(x, y)
 
| mod(x, y)
| [https://en.wikipedia.org/wiki/Remainder Remainder] after dividing ''x'' by ''y''
+
| [https://en.wikipedia.org/wiki/Remainder Resto] dopo aver diviso ''x'' per ''y''
| all, except y = 0
+
| tutti, eccetto y = 0
 
|-
 
|-
 
| round(x)
 
| round(x)
| [https://en.wikipedia.org/wiki/Rounding Rounding] to the nearest integer
+
| [https://en.wikipedia.org/wiki/Rounding Arrotondamento] al numero intero più vicino
| all
+
| tutti
 
|-
 
|-
 
| trunc(x)
 
| trunc(x)
| [https://en.wikipedia.org/wiki/Truncation Truncation] to the nearest integer
+
| [https://en.wikipedia.org/wiki/Truncation Troncamento] al numero intero più vicino
| all
+
| tutti
 
|}
 
|}
  
<div class="mw-translate-fuzzy">
+
=== Statistica e Funzioni di aggregazione ===
=== Statistica / 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 funzioni di aggregazione elencate di seguito sono supportate.
+
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/>
Le funzioni di aggregazione accettano uno o più argomenti, separati da un punto e virgola ';' o una virgola e uno spazio ", ".
+
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 riferimenti a celle di un foglio di calcolo; i riferimenti alla cella sono costituiti dalla lettera di riga (Maiuscola) seguita dal numero di colonna.
 
Gli argomenti possono includere intervalli di celle (due riferimenti di cella separati da due punti).
 
Esempio: ''average(B1:B8)''
 
</div>
 
  
<div class="mw-translate-fuzzy">
+
Sono supportate queste funzioni aggregate :
{{APIFunction  |average|x y| Average of values in cells x through y | sum(x, y) / count(x, y) }}
+
{| class="wikitable float-right mw-collapsible mw-collapsed"
{{APIFunction  |count|x y| Number of cells from x through y | The number of cells from x through y, inclusive }}
+
!style="width: 20%;"|Funzione
{{APIFunction  |max|x y| Maximum value in cells x through y | Maximum value }}
+
!style="width: 55%;"|Descrizione
{{APIFunction  |min|x y| Minimum value in cells x through y | Minimum value }}
+
!style="width: 25%;"|Intervallo di valori
{{APIFunction  |stddev|x y| Standard deviation of values in cells x through y | Standard deviation }}
+
|-
{{APIFunction  |sum|x y| Sum of values in cells x through y | Sum }}
+
| average(x:y)
</div>
+
| [https://en.wikipedia.org/wiki/Arithmetic_mean Media aritmetica] dei valori nelle celle da x a y; sum(x:y) / count(x:y)
 +
| tutti
 +
|-
 +
| count(x:y)
 +
| [https://en.wikipedia.org/wiki/Counting Conteggio] di celle da x a y
 +
| tutti
 +
|-
 +
| max(x:y)
 +
| [https://en.wikipedia.org/wiki/Maxima_and_minima Massimo] valore nelle celle da x a y
 +
| tutti
 +
|-
 +
| min(x:y)
 +
| [https://en.wikipedia.org/wiki/Maxima_and_minima Minimo] valore nelle celle da x a y
 +
| tutti
 +
|-
 +
| stddev(x:y)
 +
| [https://en.wikipedia.org/wiki/Standard_deviation Deviazione standard] dei valori nelle celle da x a y
 +
| tutti
 +
|-
 +
| sum(x: y)
 +
| [https://en.wikipedia.org/wiki/Summation Somma] dei valori nelle celle da x a y
 +
| tutti
 +
|}
  
== Conditional Expressions ==
+
== Espressioni condizionali ==
  
<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''
 
</div>
 
  
The following [https://en.wikipedia.org/wiki/Relational_operator#Standard_relational_operators relational operators] are defined:
+
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"
!style="width: 33%;"|Unit
+
!style="width: 33%;"|Operatore
!style="width: 66%;"|Description
+
!style="width: 66%;"|Descrizione
 
|-
 
|-
 
| ==
 
| ==
| equal to
+
| uguale
 
|-
 
|-
 
| !=
 
| !=
| not equal to
+
| diverso
 
|-
 
|-
 
| >
 
| >
| greater than
+
| maggiore
 
|-
 
|-
 
| <
 
| <
| less than
+
| minore
 
|-
 
|-
 
| >=
 
| >=
| greater than or equal to
+
| maggiore o uguale
 
|-
 
|-
 
| <=
 
| <=
| less than or equal to
+
| minore o uguale
 
|}
 
|}
  
<div class="mw-translate-fuzzy">
+
==Unità==
La condizione è definita come un'espressione che restituisce 0 per false, o non-zero per true. Sono definiti i seguenti operatori di confronto: ==, !=, >, <, >=, e <=.
 
</div>
 
  
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.
+
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.
  
All values must have a unit. Therefore you must in general use a unit for values in spreadsheets.<br/>
+
Tutti i valori devono avere un'unità. Pertanto, in generale è necessario utilizzare un'unità per i valori nei fogli di calcolo. <br/>
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.
+
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.
  
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³.
+
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 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>>''''.
Le funzioni trigonometriche usano i gradi come unità predefinita.
 
Per le misurazioni che utilizzano il radiante, aggiungere rad dopo il primo valore angolare nell'espressione. Esempio: cos(45) è equivalente a cos(pi rad/4).
 
</div>
 
  
The following units are recognized by the expression parser:
+
Il parser delle espressioni riconosce le seguenti unità:
  
Amount of substance:
+
Quantità di sostanza:
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
+
!style="width: 33%;"|Unità
!style="width: 66%;"|Description
+
!style="width: 66%;"|Descrizione
 
|-
 
|-
 
| mol
 
| mol
Line 271: Line 266:
 
|}
 
|}
  
Angle:
+
Angolo:
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
+
!style="width: 33%;"|Unità
!style="width: 66%;"|Description
+
!style="width: 66%;"|Descrizione
 
|-
 
|-
 
| °
 
| °
| [https://en.wikipedia.org/wiki/Degree_(angle) Degree]; alternative to the unit ''deg''
+
| [https://en.wikipedia.org/wiki/Degree_(angle) Grado]; alternativa all'unità ''deg''
 
|-
 
|-
 
| deg
 
| deg
| [https://en.wikipedia.org/wiki/Degree_(angle) Degree]; alternative to the unit ''°''
+
| [https://en.wikipedia.org/wiki/Degree_(angle) Grado]; alternativa all'unità ''°''
 
|-
 
|-
 
| rad
 
| rad
| [https://en.wikipedia.org/wiki/Radian Radian]
+
| [https://en.wikipedia.org/wiki/Radian Radiante]
 
|-
 
|-
 
| gon
 
| gon
| [https://en.wikipedia.org/wiki/Gon_(unit) Gradian]
+
| [https://en.wikipedia.org/wiki/Gon_(unit) Gradiante]
 
|-
 
|-
 
| S
 
| S
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc Second of arc]
+
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc Secondo di arco]
 
|-
 
|-
 
| ″
 
| ″
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc Second of arc]; alternative to the unit ''S''
+
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc Secondo di arco]; alternativa all'unità ''S''
 
|-
 
|-
 
| M
 
| M
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc Minute of arc]
+
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc Minuto di arco]
 
|-
 
|-
 
| ′
 
| ′
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc Minute of arc]; alternative to the unit ''M''
+
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc Minuto di arco]; alternativa all'unità ''M''
 
|}
 
|}
  
Current:
+
Corrente:
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
+
!style="width: 33%;"|Unità
!style="width: 66%;"|Description
+
!style="width: 66%;"|Descrizione
 
|-
 
|-
 
| mA
 
| mA
Line 319: Line 314:
 
|}
 
|}
  
Energy / Work:
+
Energia / Lavoro:
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
+
!style="width: 33%;"|Unità
!style="width: 66%;"|Description
+
!style="width: 66%;"|Descrizione
 
|-
 
|-
 
| J
 
| J
Line 328: Line 323:
 
|-
 
|-
 
| Ws
 
| Ws
| [https://en.wikipedia.org/wiki/Joule#Watt_second Watt second]; alternative to the unit ''Joule''
+
| [https://en.wikipedia.org/wiki/Joule#Watt_second Watt second]; alternativa all'unità ''Joule''
 
|-
 
|-
 
| VAs
 
| VAs
| [https://en.wikipedia.org/wiki/Joule Volt-ampere-second]; alternative to the unit ''Joule''
+
| [https://en.wikipedia.org/wiki/Joule Volt-ampere-second]; alternativa all'unità ''Joule''
 
|-
 
|-
 
| CV
 
| CV
| [https://en.wikipedia.org/wiki/Joule Coulomb·Volt]; alternative to the unit ''Joule''
+
| [https://en.wikipedia.org/wiki/Joule Coulomb·Volt]; alternativa all'unità ''Joule''
 
|}
 
|}
  
Force:
+
Forza:
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
+
!style="width: 33%;"|Unità
!style="width: 66%;"|Description
+
!style="width: 66%;"|Descrizione
 
|-
 
|-
 
| mN
 
| mN
Line 358: Line 353:
 
|}
 
|}
  
Length:
+
Lunghezza:
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
+
!style="width: 33%;"|Unità
!style="width: 66%;"|Description
+
!style="width: 66%;"|Descrizione
 
|-
 
|-
 
| nm
 
| nm
Line 367: Line 362:
 
|-
 
|-
 
| um
 
| um
| Micro[https://en.wikipedia.org/wiki/Metre meter]; alternative to the unit ''µm''
+
| Micro[https://en.wikipedia.org/wiki/Metre meter]; alternativa all'unità ''µm''
 
|-
 
|-
 
| µm
 
| µm
| Micro[https://en.wikipedia.org/wiki/Metre meter]; alternative to the unit ''mu''
+
| Micro[https://en.wikipedia.org/wiki/Metre meter]; alternativa all'unità ''mu''
 
|-
 
|-
 
| mm
 
| mm
Line 391: Line 386:
 
|-
 
|-
 
| mil
 
| mil
| [https://en.wikipedia.org/wiki/Thousandth_of_an_inch Thousandth of an inch]; alternative to the unit ''thou''
+
| [https://en.wikipedia.org/wiki/Thousandth_of_an_inch Thousandth of an inch]; alternativa all'unità ''thou''
 
|-
 
|-
 
| thou
 
| thou
| [https://en.wikipedia.org/wiki/Thousandth_of_an_inch Thousandth of an inch]; alternative to the unit ''mil''
+
| [https://en.wikipedia.org/wiki/Thousandth_of_an_inch Thousandth of an inch]; alternativa all'unità ''mil''
 
|-
 
|-
 
| in
 
| in
Line 400: Line 395:
 
|-
 
|-
 
| ft
 
| ft
| [https://en.wikipedia.org/wiki/Foot_(unit) Foot]; alternative to the unit '
+
| [https://en.wikipedia.org/wiki/Foot_(unit) Foot]; alternativa all'unità '
 
|-
 
|-
 
| '
 
| '
| [https://en.wikipedia.org/wiki/Foot_(unit) Foot]; alternative to the unit ''ft''
+
| [https://en.wikipedia.org/wiki/Foot_(unit) Foot]; alternativa all'unità ''ft''
 
|-
 
|-
 
| yd
 
| yd
Line 412: Line 407:
 
|}
 
|}
  
Luminous intensity:
+
Intensità luminosa:
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
+
!style="width: 33%;"|Unità
!style="width: 66%;"|Description
+
!style="width: 66%;"|Descrizione
 
|-
 
|-
 
| cd
 
| cd
Line 421: Line 416:
 
|}
 
|}
  
Mass:
+
Massa:
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
+
!style="width: 33%;"|Unità
!style="width: 66%;"|Description
+
!style="width: 66%;"|Descrizione
 
|-
 
|-
 
| ug
 
| ug
| Micro[https://en.wikipedia.org/wiki/Gram gram]; alternative to the unit ''µg''
+
| Micro[https://en.wikipedia.org/wiki/Gram gram]; alternativa all'unità ''µg''
 
|-
 
|-
 
| µg
 
| µg
| Micro[https://en.wikipedia.org/wiki/Gram gram]; alternative to the unit ''ug''
+
| Micro[https://en.wikipedia.org/wiki/Gram gram]; alternativa all'unità ''ug''
 
|-
 
|-
 
| mg
 
| mg
Line 448: Line 443:
 
|-
 
|-
 
| lb
 
| lb
| [https://en.wikipedia.org/wiki/Pound_(mass) Pound]; alternative to the unit ''lbm''
+
| [https://en.wikipedia.org/wiki/Pound_(mass) Pound]; alternativa all'unità ''lbm''
 
|-
 
|-
 
| lbm
 
| lbm
| [https://en.wikipedia.org/wiki/Pound_(mass) Pound]; alternative to the unit ''lb''
+
| [https://en.wikipedia.org/wiki/Pound_(mass) Pound]; alternativa all'unità ''lb''
 
|-
 
|-
 
| st
 
| st
Line 460: Line 455:
 
|}
 
|}
  
<div class="mw-translate-fuzzy">
+
Potenza:
=== Espressioni condizionali ===
+
{| class="wikitable float-right mw-collapsible mw-collapsed"
</div>
+
!style="width: 33%;"|Unità
 +
!style="width: 66%;"|Descrizione
 +
|-
 +
| W
 +
| [https://en.wikipedia.org/wiki/Watt Watt]
 +
|-
 +
| VA
 +
| [https://en.wikipedia.org/wiki/Volt-ampere Volt-ampere]
 +
|}
  
Pressure:
+
Pressione:
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
+
!style="width: 33%;"|Unità
!style="width: 66%;"|Description
+
!style="width: 66%;"|Descrizione
 
|-
 
|-
 
| Pa
 
| Pa
| [https://en.wikipedia.org/wiki/Pascal_(unit) Pascal]
+
| [https://en.wikipedia.org/wiki/Pascal_(unit) pascal]
 
|-
 
|-
 
| kPa
 
| kPa
Line 482: Line 485:
 
|-
 
|-
 
| uTorr
 
| uTorr
| Micro[https://en.wikipedia.org/wiki/Torr torr]; alternative to the unit ''µTorr''
+
| Micro[https://en.wikipedia.org/wiki/Torr torr]; alternativa all'unità ''µTorr''
 
|-
 
|-
 
| µTorr
 
| µTorr
| Micro[https://en.wikipedia.org/wiki/Torr torr]; alternative to the unit ''uTorr''
+
| Micro[https://en.wikipedia.org/wiki/Torr torr]; alternativa all'unità ''uTorr''
 
|-
 
|-
 
| mTorr
 
| mTorr
Line 500: Line 503:
 
|}
 
|}
  
Temperature:
+
Temperatura:
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
+
!style="width: 33%;"|Unità
!style="width: 66%;"|Description
+
!style="width: 66%;"|Descrizione
 
|-
 
|-
 
| uK
 
| uK
| Micro[https://en.wikipedia.org/wiki/Kelvin kelvin]; alternative to the unit ''µK''
+
| Micro[https://en.wikipedia.org/wiki/Kelvin kelvin]; alternativa all'unità ''µK''
 
|-
 
|-
 
| µK
 
| µK
| Micro[https://en.wikipedia.org/wiki/Kelvin kelvin]; alternative to the unit ''uK''
+
| Micro[https://en.wikipedia.org/wiki/Kelvin kelvin]; alternativa all'unità ''uK''
 
|-
 
|-
 
| mK
 
| mK
Line 518: Line 521:
 
|}
 
|}
  
Time:
+
Tempo:
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
+
!style="width: 33%;"|Unità
!style="width: 66%;"|Description
+
!style="width: 66%;"|Descrizione
 
|-
 
|-
 
| s
 
| s
| [https://en.wikipedia.org/wiki/Second Second]
+
| [https://en.wikipedia.org/wiki/Second secondo]
 
|-
 
|-
 
| min
 
| min
| [https://en.wikipedia.org/wiki/Minute Minute]
+
| [https://en.wikipedia.org/wiki/Minute minuto]
 
|-
 
|-
 
| h
 
| h
| [https://en.wikipedia.org/wiki/Hour Hour]
+
| [https://en.wikipedia.org/wiki/Hour ora]
 +
|-
 +
| Hz (1/s)
 +
| [https://en.wikipedia.org/wiki/Hertz hertz], {{Version/it|0.19}}
 +
|-
 +
| kHz
 +
| Kilo[https://en.wikipedia.org/wiki/Hertz hertz], {{Version/it|0.19}}
 +
|-
 +
| MHz
 +
| Mega[https://en.wikipedia.org/wiki/Hertz hertz], {{Version/it|0.19}}
 +
|-
 +
| GHz
 +
| Giga[https://en.wikipedia.org/wiki/Hertz hertz], {{Version/it|0.19}}
 
|}
 
|}
  
Torque:
+
Momento meccanico:
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
+
!style="width: 33%;"|Unità
!style="width: 66%;"|Description
+
!style="width: 66%;"|Descrizione
 
|-
 
|-
 
| Nm
 
| Nm
| [https://en.wikipedia.org/wiki/Newton_metre Newton metre]
+
| [https://en.wikipedia.org/wiki/Newton_metre newton metro]
 
|}
 
|}
  
 
Volume:
 
Volume:
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
+
!style="width: 33%;"|Unità
!style="width: 66%;"|Description
+
!style="width: 66%;"|Descrizione
 
|-
 
|-
 
| l
 
| l
| [https://en.wikipedia.org/wiki/Litre Liter]
+
| [https://en.wikipedia.org/wiki/Litre litro]
 
|}
 
|}
  
The following commonly used units are not yet supported:
+
Le seguenti unità comunemente utilizzate non sono ancora supportate:
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
 
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 25%;"|Unit
+
!style="width: 25%;"|Unità
!style="width: 50%;"|Description
+
!style="width: 50%;"|Descrizione
!style="width: 25%;"|Alternative
+
!style="width: 25%;"|Alternativa
 
|-
 
|-
 
| C
 
| C
| [https://en.wikipedia.org/wiki/Coulomb Coulomb]
+
| [https://en.wikipedia.org/wiki/Coulomb coulomb]
 
| 1 A*s
 
| 1 A*s
|-
 
| Hz
 
| [https://en.wikipedia.org/wiki/Hertz Hertz]
 
| 1 /s
 
 
|-
 
|-
 
| V
 
| V
| [https://en.wikipedia.org/wiki/Volt Volt]
+
| [https://en.wikipedia.org/wiki/Volt volt]
 
| 1 W/A
 
| 1 W/A
 
|-
 
|-
 
| eV
 
| eV
| [https://en.wikipedia.org/wiki/Electronvolt Electronvolt]
+
| [https://en.wikipedia.org/wiki/Electronvolt electronvolt]
 
| 1.602176634e-19 J
 
| 1.602176634e-19 J
 
|-
 
|-
 
| kWh
 
| kWh
| [https://en.wikipedia.org/wiki/Kilowatt_hour Kilowatt hour]
+
| [https://en.wikipedia.org/wiki/Kilowatt_hour kilowatt ora]
 
| 3.6e6 J
 
| 3.6e6 J
 
|-
 
|-
 
| bar
 
| bar
| [https://en.wikipedia.org/wiki/Bar_(unit) Bar]
+
| [https://en.wikipedia.org/wiki/Bar_(unit) bar]
 
| 100 kPa
 
| 100 kPa
 
|-
 
|-
 
| T
 
| T
| [https://en.wikipedia.org/wiki/Tesla_(unit) Tesla]
+
| [https://en.wikipedia.org/wiki/Tesla_(unit) tesla]
 
| 1 kg/s^2/A
 
| 1 kg/s^2/A
 
|-
 
|-
 
| F
 
| F
| [https://en.wikipedia.org/wiki/Farad Farad]
+
| [https://en.wikipedia.org/wiki/Farad farad]
 
| 1 s^4*A^2/m^2/kg
 
| 1 s^4*A^2/m^2/kg
 
|-
 
|-
 
| H
 
| H
| [https://en.wikipedia.org/wiki/Henry_(unit) Henry]
+
| [https://en.wikipedia.org/wiki/Henry_(unit) henry]
 
| 1 kg*m^2/s^2/A^2
 
| 1 kg*m^2/s^2/A^2
 
|-
 
|-
 
| u
 
| u
| [https://en.wikipedia.org/wiki/Unified_atomic_mass_unit Atomic mass unit]; alternative to the unit 'Da'
+
| [https://en.wikipedia.org/wiki/Unified_atomic_mass_unit Atomic mass unit]; alternativa all'unità 'Da'
 
| 1.66053906660e-27 kg
 
| 1.66053906660e-27 kg
 
|-
 
|-
 
| Da
 
| Da
| [https://en.wikipedia.org/wiki/Unified_atomic_mass_unit Dalton]; alternative to the unit 'u'
+
| [https://en.wikipedia.org/wiki/Unified_atomic_mass_unit dalton]; alternativa all'unità 'u'
 
| 1.66053906660e-27 kg
 
| 1.66053906660e-27 kg
 
|-
 
|-
 
| cal
 
| cal
| [https://en.wikipedia.org/wiki/Calorie Calorie]
+
| [https://en.wikipedia.org/wiki/Calorie calorie]
 
| 4.184 J
 
| 4.184 J
 
|-
 
|-
 
| sr
 
| sr
| [https://en.wikipedia.org/wiki/Steradian Steradian]
+
| [https://en.wikipedia.org/wiki/Steradian steradiante]
 
| not directly
 
| not directly
 
|-
 
|-
 
| lm
 
| lm
| [https://en.wikipedia.org/wiki/Lumen_(unit) Lumen]
+
| [https://en.wikipedia.org/wiki/Lumen_(unit) lumen]
 
| not directly
 
| not directly
 
|-
 
|-
 
| lx
 
| lx
| [https://en.wikipedia.org/wiki/Lux Lux]
+
| [https://en.wikipedia.org/wiki/Lux lux]
 
| not directly
 
| not directly
 
|-
 
|-
Line 622: Line 633:
 
|}
 
|}
  
== Riferimento ai dati CAD ==
+
==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.  
 
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.  
Line 675: Line 686:
 
== 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.
In un documento è possibile fare riferimento a un foglio di calcolo contenuto in un altro documento.
 
</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">
+
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". Si può quindi accedere al valore con:
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.
 
</div>
 
  
 
     master#modelConstants.Length   
 
     master#modelConstants.Length   
  
Note that the master document must be loaded for the values in the master to be available to the dependent document.
+
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 {{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.

Latest revision as of 09:30, 20 November 2019

Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎italiano • ‎русский

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

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.

Operatori supportati

Sono supportati i seguenti operatori:

Operatore Descrizione
+ Addizione
- Sottrazione
* Multiplicazione
/ Divisione
^ Potenze

Costanti supportate

Sono supportate le seguenti costanti:

Constante Descrizione
e Numero di Eulero
pi Pi greco

Funzioni supportate

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:

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

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 :

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

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

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

Quantità di sostanza:

Unità Descrizione
mol Mole

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

Corrente:

Unità Descrizione
mA Milliampere
A Ampere
kA Kiloampere
MA Megaampere

Energia / Lavoro:

Unità Descrizione
J Joule
Ws Watt second; alternativa all'unità Joule
VAs Volt-ampere-second; alternativa all'unità Joule
CV Coulomb·Volt; alternativa all'unità Joule

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
VA Volt-ampere

Pressione:

Unità Descrizione
Pa pascal
kPa Kilopascal
MPa Megapascal
GPa Gigapascal
uTorr Microtorr; alternativa all'unità µTorr
µTorr Microtorr; alternativa all'unità uTorr
mTorr Millitorr
Torr Torr
psi Pound-force per square inch
ksi Kilopound-force per square inch

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

Momento meccanico:

Unità Descrizione
Nm newton metro

Volume:

Unità Descrizione
l litro

Le seguenti unità comunemente utilizzate non sono ancora supportate:

Unità Descrizione Alternativa
C coulomb 1 A*s
V volt 1 W/A
eV electronvolt 1.602176634e-19 J
kWh kilowatt ora 3.6e6 J
bar bar 100 kPa
T tesla 1 kg/s^2/A
F farad 1 s^4*A^2/m^2/kg
H henry 1 kg*m^2/s^2/A^2
u Atomic mass unit; alternativa all'unità 'Da' 1.66053906660e-27 kg
Da dalton; alternativa all'unità 'u' 1.66053906660e-27 kg
cal calorie 4.184 J
sr steradiante not directly
lm lumen not directly
lx lux not directly
Mpsi Megapound-force per square inch 1000 ksi

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 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, oppure Length2 nello stesso oggetto se l'espressione è già usata.

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", il valore è accessibile come "master#modelConstants.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.
  • 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