Expressions/it: Difference between revisions
(Updating to match new version of source page) |
No edit summary |
||
(304 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
{{TOCright}} |
|||
<span id="Overview"></span> |
|||
<div style="float:right; clean:both; margin-left:0.5em;">__TOC__</div> |
|||
==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 [[Image:Bound-expression.svg|24px]]. Cliccando sull'icona, oppure digitando il segno di uguale {{KEY|=}}, si porta in primo piano l'editor delle espressioni per quella particolare proprietà. |
|||
<div class="mw-translate-fuzzy"> |
|||
{{Version|0.16}} |
|||
</div> |
|||
Un'espressione di FreeCAD è un'espressione matematica che utilizza gli [[#Operatori_supportati|operatori]], le [[#Funzioni_supportate|funzioni]] e le [[#Costanti_supportate|costanti]] standard come descritto di seguito. Inoltre, l'espressione può fare riferimento a proprietà dell'oggetto e utilizzare anche [[#Espressioni_condizionali|espressioni condizionali]]. I numeri in un'espressione possono avere una [[#Unità|unità]] facoltativa allegata. |
|||
<div class="mw-translate-fuzzy"> |
|||
Ora è possibile definire le proprietà utilizzando espressioni matematiche. Nella GUI, gli spin box o i campi di input che sono legati alle proprietà contengono un'icona blu [[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> |
|||
I numeri possono utilizzare una virgola {{incode|,}} o un punto decimale {{incode|.}} per separare le cifre intere dai decimali. Quando viene utilizzato il marcatore decimale, ''deve'' essere seguito da almeno una cifra. Pertanto, le espressioni {{incode|1.+2.}} e {{incode|1,+2,}} non sono valide, ma {{incode|1.0 + 2.0}} e {{incode|1,0 + 2 ,0}} sono validi. |
|||
<div class="mw-translate-fuzzy"> |
|||
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> |
|||
Gli operatori e le funzioni sono unit-aware (consapevoli delle unità), e richiedono combinazioni di unità valide, se sono necessarie. Ad esempio, {{incode|2mm + 4mm}} è un'espressione valida, mentre {{incode|2mm + 4}} non lo è. Questo vale anche per i riferimenti alle proprietà dell'oggetto che hanno unità, come la proprietà Length. Pertanto {{incode|Pad001.Length + 1}} non è valido poiché aggiunge un numero puro a una proprietà con una unità di lunghezza, si richiede {{incode|Pad001.Length + 1mm}}. |
|||
Numbers may use either a comma ',' or a decimal point '.' separating whole digits from decimals. |
|||
When the decimal marker is used, it ''must'' be followed by at least one digit. |
|||
Thus, the expressions '''1.+2.''' and '''1,+2,''' are invalid, but '''1.0 + 2.0''' and '''1,0 + 2,0''' are valid. |
|||
Alcuni errori relativi alle unità possono sembrare non intuitivi, con espressioni respinte o che producono risultati che non corrispondono alle unità della proprietà impostata. Ecco alcuni esempi: |
|||
<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). |
|||
</div> |
|||
{{incode|1/2mm}} non viene interpretato come mezzo millimetro ma come {{incode|1/(2mm)}}, risultante in: {{incode|0.5 mm^-1}}. |
|||
You can use [[#Supported Constants|predefined constants]] and [[#Supported Functions|functions]]. |
|||
{{incode|sqrt(2)mm}} non è valido perché la chiamata alla funzione non è un numero. Questo deve essere inserito come {{incode|sqrt(2) * 1mm}}. |
|||
===Referencing objects=== |
|||
<span id="Function_arguments"></span> |
|||
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>>}}. |
|||
===Argomenti delle funzioni=== |
|||
Quando una funzione accetta più argomenti, questi possono essere separati da un punto e virgola {{incode|;}} o da una virgola <em>seguita da uno spazio</em> {{incode|, }}. 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. |
|||
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}}. |
|||
Gli argomenti possono includere riferimenti a celle in un foglio di calcolo. Un riferimento di cella è costituito dalla lettera maiuscola della riga della cella seguita dal suo numero di colonna, ad esempio {{incode|A1}}. È anche possibile fare riferimento a una cella utilizzando l'alias della cella, ad esempio {{incode|Spreadsheet.MyPartWidth}}. |
|||
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]'''. |
|||
<span id="Referencing_objects"></span> |
|||
For more info about referencing objects, see [[#Reference To CAD-Data|this section]]. |
|||
===Riferimenti a oggetti=== |
|||
Come già mostrato sopra,S si può fare riferimento a un oggetto tramite il suo {{PropertyData|Name}}. Ma si può anche usare la sua {{PropertyData|Label}}. Nel caso di una {{PropertyData|Label}}, essa deve essere racchiusa tra i simboli {{incode|<<}} e {{incode|>>}}, come questa: {{incode|<<Label>>}}. |
|||
==Supported Operators== |
|||
È possibile fare riferimento a qualsiasi proprietà di un oggetto. Ad esempio, per fare riferimento all'altezza di un cilindro, è possibile utilizzare {{incode|Cylinder.Height}} o {{incode|<<Label_of_cylinder>>.Height}} |
|||
The following operators are supported: |
|||
{| class="wikitable float-right mw-collapsible mw-uncollapsed" |
|||
Per ulteriori informazioni sui riferimenti agli oggetti, vedere [[#Riferimento_ai_dati_CAD|Riferimento ai dati CAD]]. |
|||
!style="width: 33%;"|Operator |
|||
{{Top}} |
|||
!style="width: 66%;"|Description |
|||
<span id="Supported_constants"></span> |
|||
== Costanti supportate == |
|||
Sono supportate le seguenti costanti: |
|||
{| class="wikitable" |
|||
!style="width: 33%;"|Constante |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|- |
||
| style="text-align:center;" | '''e''' |
|||
| + |
|||
| [https://en.wikipedia.org/wiki/ |
| [https://en.wikipedia.org/wiki/E_(mathematical_constant) Numero di Eulero] |
||
|- |
|- |
||
| style="text-align:center;" | '''pi''' |
|||
| - |
|||
| [https://en.wikipedia.org/wiki/ |
| [https://en.wikipedia.org/wiki/Pi Pi greco] |
||
|} |
|||
{{Top}} |
|||
<span id="Supported_operators"></span> |
|||
== Operatori supportati == |
|||
Sono supportati i seguenti operatori: |
|||
{| class="wikitable" |
|||
!style="width: 33%;"|Operatore |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|- |
||
| style="text-align:center;" |'''+''' |
|||
| * |
|||
| [https://en.wikipedia.org/wiki/ |
| [https://en.wikipedia.org/wiki/Addition Addizione] |
||
|- |
|- |
||
| style="text-align:center;" |'''-''' |
|||
| / |
|||
| [https://en.wikipedia.org/wiki/ |
| [https://en.wikipedia.org/wiki/Subtraction Sottrazione] |
||
|- |
|- |
||
| style="text-align:center;" | '''*''' |
|||
| ^ |
|||
| [https://en.wikipedia.org/wiki/ |
| [https://en.wikipedia.org/wiki/Multiplication Multiplicazione] |
||
|- |
|||
| style="text-align:center;" | '''/''' |
|||
| [https://en.wikipedia.org/wiki/Division_(mathematics) Divisione] virgola mobile |
|||
|- |
|||
| style="text-align:center;" | '''%''' |
|||
| [https://en.wikipedia.org/wiki/Remainder Resto] |
|||
|- |
|||
| style="text-align:center;" | '''^''' |
|||
| [https://en.wikipedia.org/wiki/Exponentiation Potenze] |
|||
|} |
|} |
||
{{Top}} |
|||
<span id="Supported_functions"></span> |
|||
== Funzioni supportate == |
|||
<span id="General_mathematical_functions"></span> |
|||
<div class="mw-translate-fuzzy"> |
|||
=== Funzioni matematiche generali === |
|||
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> |
|||
Sono supportate le seguenti funzioni matematiche: |
|||
<div class="mw-translate-fuzzy"> |
|||
{{APIFunction |abs|x| Absolute value | value <nowiki> >= 0 </nowiki> }} |
|||
{{APIFunction |acos|x| Arc cosine; <nowiki> -1 <= x <= 1 </nowiki> | acos(x) }} |
|||
{{APIFunction |asin|x| Arc sine; <nowiki> -1 <= x <= 1 </nowiki> | asin(x) }} |
|||
{{APIFunction |atan|x| Arc tangent | atan(x) }} |
|||
{{APIFunction |atan2|y, x| Arc tangent of y / x; | atan2(y,x) }} |
|||
{{APIFunction |ceil|x| Ceiling | The smallest integer value greater than or equal to x {{Version|0.16}} }} |
|||
{{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) }} |
|||
{{APIFunction |exp|y| Natural exponent | e<sup> y</sup> }} |
|||
{{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> |
|||
<span id="Trigonometric_functions"></span> |
|||
== Funzioni Supportate == |
|||
==== Funzioni trigonometriche ==== |
|||
[https://en.wikipedia.org/wiki/Trigonometric_functions Le funzioni trigonometriche] usano il grado come unità predefinita. Per i radianti, aggiungere {{incode|rad}} dopo il <em>primo</em> valore in un'espressione. Quindi ad es. {{incode|cos(45)}} è uguale a {{incode|cos(pi rad / 4)}}. Le espressioni in gradi possono utilizzare {{incode|deg}} o {{incode|°}}, ad es. {{incode|360deg - atan2(3; 4)}} o {{incode|360° - atan2(3; 4)}}. Se un'espressione è senza unità e deve essere convertita in gradi o radianti per compatibilità, moltiplicare per {{incode|1deg}}, {{incode|1°}} o {{incode|1rad}} in modo appropriato, ad es. {{incode|(360 - X) * 1deg}}; {{incode|(360 - X) * 1°}}; {{incode|(0.5 + pi / 2) * 1rad}}. |
|||
=== General Mathematical Functions === |
|||
{| class="wikitable" |
|||
Le funzioni matematiche elencate di seguito sono disponibili. |
|||
!style="width: 15%;"|Funzione |
|||
!style="width: 55%;"|Descrizione |
|||
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. |
|||
!style="width: 30%;"|Intervallo di valori |
|||
[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/> |
|||
These trigonometric functions are supported: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Function |
|||
!style="width: 33%;"|Description |
|||
!style="width: 33%;"|Value range |
|||
|- |
|- |
||
| acos(x) |
| {{incode|acos(x)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Funzione_trigonometrica_inversa Arco seno] |
||
| -1 <= x <= 1 |
| -1 <= x <= 1 |
||
|- |
|- |
||
| asin(x) |
| {{incode|asin(x)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Funzione_trigonometrica_inversa Arco coseno] |
||
| -1 <= x <= 1 |
| -1 <= x <= 1 |
||
|- |
|- |
||
| atan(x) |
| {{incode|atan(x)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Funzione_trigonometrica_inversa Arco tangente], restituisce un valore con -90° < valore < 90° |
||
| |
| tutti |
||
|- |
|- |
||
| atan2( |
| {{incode|atan2(y; x)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Funzione_trigonometrica_inversa Arco tangente 2] con ''y/x'' tenendo conto del quadrante, restituisce un valore con -180° < valore <= 180° |
||
| tutti, l'input non valido x = y = 0 restituisce 0 |
|||
| all, except y = 0 |
|||
|- |
|- |
||
| cos(x) |
| {{incode|cos(x)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Funzione_trigonometrica#Definizioni_tramite_triangoli_rettangoli Coseno] |
||
| |
| tutti |
||
|- |
|- |
||
| cosh(x) |
| {{incode|cosh(x)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Funzioni_iperboliche#Definizioni Coseno iperbolico] |
||
| |
| tutti |
||
|- |
|- |
||
| sin(x) |
| {{incode|sin(x)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Funzione_trigonometrica#Definizioni_tramite_triangoli_rettangoli Seno] |
||
| |
| tutti |
||
|- |
|- |
||
| sinh(x) |
| {{incode|sinh(x)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Funzioni_iperboliche#Definizioni Seno iperbolico] |
||
| |
| tutti |
||
|- |
|- |
||
| tan(x) |
| {{incode|tan(x)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Funzione_trigonometrica#Definizioni_tramite_triangoli_rettangoli Tangente] |
||
| |
| tutti, eccetto x = n*90 con = intero dispari |
||
|- |
|- |
||
| tanh(x) |
| {{incode|tanh(x)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Funzioni_iperboliche#Definizioni Tangente iperbolica] |
||
| |
| tutti |
||
|- |
|||
| {{incode|hypot(x; y)}} |
|||
| [https://en.wikipedia.org/wiki/Pythagorean_addition Addizione pitagorica] (utilizzo di '''hypot'''), e.g. hypot(4; 3) = 5 |
|||
| x e y >= 0 |
|||
|- |
|||
| {{incode|cath(x; y)}} |
|||
| Data l'ipotenusa e un lato, restituisce l'altro lato del triangolo rettangolo, per esempio cath(5; 3) = 4 |
|||
| x >= y >= 0 |
|||
|} |
|} |
||
<span id="Exponential_and_logarithmic_functions"></span> |
|||
These functions for exponentiation and logarithmization are supported: |
|||
==== Funzioni esponenziali e logaritmiche ==== |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Function |
|||
{| class="wikitable" |
|||
!style="width: 33%;"|Description |
|||
!style="width: 33%;"| |
!style="width: 33%;"|Funzione |
||
!style="width: 33%;"|Descrizione |
|||
!style="width: 33%;"|Intervallo di valori |
|||
|- |
|- |
||
| exp(x) |
| {{incode|exp(x)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Funzione_esponenziale#Definizioni Esponenziale] |
||
| |
| tutti |
||
|- |
|- |
||
| log(x) |
| {{incode|log(x)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Logaritmo_naturale Logaritmo naturale] |
||
| x > 0 |
| x > 0 |
||
|- |
|- |
||
| log10(x) |
| {{incode|log10(x)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Logaritmo Logaritmo in base 10] |
||
| x > 0 |
| x > 0 |
||
|- |
|- |
||
| pow(x |
| {{incode|pow(x; y)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Potenza_(matematica) Potenza] |
||
| |
| tutti |
||
|- |
|- |
||
| sqrt(x) |
| {{incode|sqrt(x)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Radice_quadrata Radice quadrata] |
||
| x >= 0 |
| x >= 0 |
||
|- |
|||
| {{incode|cbrt(x)}} {{Version/it|0.21}} |
|||
| [https://it.wikipedia.org/wiki/Radicale_(matematica) Radice cubica] |
|||
| tutti |
|||
|} |
|} |
||
<span id="Rounding,_truncation_and_remainder_functions"></span> |
|||
These functions for rounding, truncation and remainder are supported: |
|||
==== Funzioni di arrotondamento, troncamento e resto ==== |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 20%;"|Function |
|||
{| class="wikitable" |
|||
!style="width: 55%;"|Description |
|||
!style="width: |
!style="width: 20%;"|Funzione |
||
!style="width: 55%;"|Descrizione |
|||
!style="width: 25%;"|Intervallo di valori |
|||
|- |
|- |
||
| abs(x) |
| {{incode|abs(x)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Valore_assoluto Valore assoluto] |
||
| |
| tutti |
||
|- |
|- |
||
| ceil(x) |
| {{incode|ceil(x)}} |
||
| [https://en.wikipedia.org/wiki/Floor_and_ceiling_functions |
| [https://en.wikipedia.org/wiki/Floor_and_ceiling_functions Approssimazione per difetto], valore intero più piccolo maggiore o uguale a x |
||
| |
| tutti |
||
|- |
|- |
||
| floor(x) |
| {{incode|floor(x)}} |
||
| [https://en.wikipedia.org/wiki/Floor_and_ceiling_functions |
| [https://en.wikipedia.org/wiki/Floor_and_ceiling_functions Approssimazione in eccesso], valore intero più grande minore o uguale a x |
||
| |
| tutti |
||
|- |
|- |
||
| mod(x |
| {{incode|mod(x; y)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Resto Resto] dopo aver diviso ''x'' per ''y'', il segno del risultato è quello del dividendo. |
||
| |
| tutti, eccetto y = 0 |
||
|- |
|- |
||
| round(x) |
| {{incode|round(x)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Arrotondamento Arrotondamento] all'intero più vicino |
||
| |
| tutti |
||
|- |
|- |
||
| trunc(x) |
| {{incode|trunc(x)}} |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Troncamento_(matematica) Troncamento] all'intero più vicino nella direzione dello zero |
||
| |
| tutti |
||
|} |
|} |
||
{{Top}} |
|||
<span id="Statistical_/_aggregate_functions"></span> |
|||
=== Funzioni statistiche / aggregate === |
|||
Le [https://it.wikipedia.org/wiki/Funzione_di_aggregazione funzioni di aggregazione] prendono uno o più argomenti.<br> |
|||
<div class="mw-translate-fuzzy"> |
|||
=== Statistica / Funzioni di aggregazione === |
|||
Le funzioni di aggregazione elencate di seguito sono supportate. |
|||
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 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> |
|||
I singoli argomenti per le funzioni di aggregazione possono essere costituiti da intervalli di celle. Un intervallo di celle è espresso come due riferimenti di cella separati da due punti {{Incode|:}}, ad esempio {{Incode|average(B1:B8)}} o {{Incode|sum(A1:A4; B1:B4 )}}. |
|||
<div class="mw-translate-fuzzy"> |
|||
I riferimenti di cella possono anche utilizzare alias di cella, ad esempio {{Incode|average(StartTemp:EndTemp)}}. |
|||
{{APIFunction |average|x y| Average of values in cells x through y | sum(x, y) / count(x, y) }} |
|||
{{APIFunction |count|x y| Number of cells from x through y | The number of cells from x through y, inclusive }} |
|||
{{APIFunction |max|x y| Maximum value in cells x through y | Maximum value }} |
|||
{{APIFunction |min|x y| Minimum value in cells x through y | Minimum value }} |
|||
{{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 }} |
|||
</div> |
|||
Sono supportate le seguenti funzioni di aggregazione: |
|||
== Conditional Expressions == |
|||
{| class="wikitable" |
|||
!style="width: 20%;"|Funzione |
|||
Le espressioni condizionali sono nella forma ''condition ? resultTrue : resultFalse'' |
|||
!style="width: 55%;"|Descrizione |
|||
</div> |
|||
!style="width: 25%;"|Intervallo di valori |
|||
|- |
|||
| {{incode|average(a; b; c; ...)}} |
|||
| [https://it.wikipedia.org/wiki/Media_(statistica)#Media_aritmetica Media aritmetica] del valore degli argomenti, calcolato come sum(a; b; c; ...) / count(a; b; c; ...) |
|||
| tutti |
|||
|- |
|||
| {{incode|count(a; b; c; ...)}} |
|||
| [https://it.wikipedia.org/wiki/Statistica Conteggio] degli argomenti, generalmente utilizzato su intervalli di celle |
|||
| tutti |
|||
|- |
|||
| {{incode|max(a; b; c; ...)}} |
|||
| [https://it.wikipedia.org/wiki/Massimo_e_minimo_di_una_funzione Massimo] valore tra gli argomenti |
|||
| tutti |
|||
|- |
|||
| {{incode|min(a; b; c; ...)}} |
|||
| [https://it.wikipedia.org/wiki/Massimo_e_minimo_di_una_funzione Minimo] valore tra gli argomenti |
|||
| tutti |
|||
|- |
|||
| {{incode|stddev(a; b; c; ...)}} |
|||
| [https://it.wikipedia.org/wiki/Scarto_quadratico_medio Deviazione standard] dei valori degli argomenti |
|||
| tutti |
|||
|- |
|||
| {{incode|sum(a; b; c; ...)}} |
|||
| [https://it.wikipedia.org/wiki/Sommatoria Sommatoria] dei valori degli argomenti, tipicamente utilizzato su intervalli di celle |
|||
| tutti |
|||
|} |
|||
{{Top}} |
|||
<span id="String_manipulation"></span> |
|||
=== Manipolazione delle stringhe === |
|||
<span id="String_identification"></span> |
|||
==== Identificazione della stringa ==== |
|||
Le stringhe sono identificate nelle espressioni con doppi chevron di apertura/chiusura (così come le etichette). |
|||
Nell'esempio seguente, "TEXT" è riconosciuto come una stringa: {{incode|<<TEXT>>}} |
|||
<span id="String_concatenation"></span> |
|||
==== Concatenazione di stringhe ==== |
|||
Le stringhe possono essere concatenate utilizzando il segno '+'. |
|||
L'esempio seguente {{incode|<<MY>> + <<TEXT>>}} sarà concatenato a "MYTEXT". |
|||
<span id="String_conversion"></span> |
|||
==== Conversione di stringhe ==== |
|||
I valori numerici possono essere convertiti in stringhe con la funzione {{incode|str}}: |
|||
{{incode|str(Box.Length.Value)}} |
|||
<span id="String_formatting"></span> |
|||
==== Formattazione della stringa ==== |
|||
La formattazione delle stringhe è supportata utilizzando il (vecchio) stile Python col %. |
|||
Tutti gli %-specifiers come definiti nella [https://docs.python.org/3/library/stdtypes.html#printf-style-string-formatting documentazione di Python]. |
|||
Ad esempio, supponendo di avere un cubo predefinito di 10 mm di lato denominato 'Box' (denominazione predefinita di FreeCAD), la seguente espressione {{incode|<<Cube length : %s>> % Box.Length}} si espanderà in "Cube length: 10,0 mm" |
|||
Per più di uno specificatore % utilizzare la seguente sintassi: {{incode|<<La lunghezza del cubo è %s e la larghezza è %s>> % tuple(Box.Length; Box.Width)}}. Oppure usa la concatenazione: {{incode|<<La lunghezza del cubo è %s>> % Box.Length + << e la larghezza è %s>> % Box.Width}}. Entrambi si espandono in "La lunghezza del cubo è 10,0 mm e la larghezza è 10,0 mm". |
|||
È disponibile un file di esempio di FreeCAD che utilizza la formattazione delle stringhe [https://forum.freecadweb.org/viewtopic.php?f=8&t=58657 nel forum] |
|||
{{Top}} |
|||
<span id="Object_creation_functions"></span> |
|||
=== Funzioni per la creazione di oggetti === |
|||
I seguenti oggetti possono essere creati nelle espressioni utilizzando le seguenti funzioni: |
|||
{| class="wikitable" |
|||
The following [https://en.wikipedia.org/wiki/Relational_operator#Standard_relational_operators relational operators] are defined: |
|||
! Tipo |
|||
{| class="wikitable float-right mw-collapsible mw-uncollapsed" |
|||
! Funzione |
|||
!style="width: 33%;"|Unit |
|||
! Descrizione |
|||
!style="width: 66%;"|Description |
|||
|- |
|- |
||
| {{incode|Tuple}} |
|||
| == |
|||
| {{incode|tuple(a; b; ...)}} |
|||
| equal to |
|||
| Esempio: {{incode|tuple(2; 1; 2)}} |
|||
|- |
|- |
||
| {{incode|List}} |
|||
| != |
|||
| {{incode|list(a; b; ...)}} |
|||
| not equal to |
|||
| Esempio: {{incode|list(2; 1; 2)}} |
|||
|- |
|- |
||
| rowspan="2" | [[Vector API|{{incode|Vector}}]] |
|||
| > |
|||
| {{incode|vector(x; y; z)}} |
|||
| greater than |
|||
| rowspan="2" | Crea un vettore senza unità o utilizzando tre valori con unità di {{incode|Lunghezza}}. |
|||
Esempio: {{incode|vector(2; 1; 3)}} |
|||
|- |
|- |
||
| {{incode|create(<<vector>>; x; y; z)}} |
|||
| < |
|||
| less than |
|||
|- |
|- |
||
| rowspan="2" | [[Matrix API|{{incode|Matrix}}]] |
|||
| >= |
|||
| |
|||
| greater than or equal to |
|||
matrix( |
|||
a<sub>11</sub>; a<sub>12</sub>; a<sub>13</sub>; a<sub>14</sub>; |
|||
a<sub>21</sub>; a<sub>22</sub>; a<sub>23</sub>; a<sub>24</sub>; |
|||
a<sub>31</sub>; a<sub>32</sub>; a<sub>33</sub>; a<sub>34</sub>; |
|||
a<sub>41</sub>; a<sub>42</sub>; a<sub>43</sub>; a<sub>44</sub> |
|||
) |
|||
| rowspan="2" | Crea una matrice 4x4 [https://en.wikipedia.org/wiki/Row-_and_column-major_order ordinata per riga]: |
|||
<math> |
|||
\begin{bmatrix} |
|||
a_{11} & a_{12} & a_{13} & a_{14} \\ |
|||
a_{21} & a_{22} & a_{23} & a_{24} \\ |
|||
a_{31} & a_{32} & a_{33} & a_{34} \\ |
|||
a_{41} & a_{42} & a_{43} & a_{44} \\ |
|||
\end{bmatrix} |
|||
</math> |
|||
È possibile fornire un minimo di 1 argomento come {{incode|matrix(1)}} che crea una matrice identità. |
|||
Esempio: {{incode|matrix(1; 2; 3; 4; 5; 6; 7; 8; 9; 10; 11; 12; 13; 14; 15; 16)}} |
|||
|- |
|||
| {{incode|create(<<matrix>>; a<sub>11</sub>; a<sub>12</sub>; ...; a<sub>44</sub>)}} |
|||
|- |
|||
| rowspan="4" | {{incode|Rotation}} |
|||
| {{incode|rotation(axis; angle)}} |
|||
| rowspan="4" | Crea una {{incode|Rotation}} specificando il suo {{incode|axis}} ({{incode|Vector}}) e {{incode|angle}} ({{incode|Angle}} senza unità o con unità), o i tre angoli di Eulero {{incode|α}}, {{incode|β}}, {{incode|γ}}. |
|||
Esempi: |
|||
* {{incode|rotation(vector(0; 1; 0); 45)}} |
|||
* {{incode|create(<<rotation>>; 30; 30; 30)}} |
|||
|- |
|||
| {{incode|rotation(α; β; γ)}} |
|||
|- |
|||
| {{incode|create(<<rotation>>; axis; angle)}} |
|||
|- |
|||
| {{incode|create(<<rotation>>; α; β; γ)}} |
|||
|- |
|||
| rowspan="5" | [[Placement_API|{{incode|Placement}}]] |
|||
| {{incode|placement(base; rotation)}} |
|||
| rowspan="5" | Crea un {{incode|Placement}} con vari parametri, inclusi: |
|||
* {{incode|base}}: posizione di base ({{incode|Vector}}) |
|||
* {{incode|center}}: posizione centrale ({{incode|Vector}}) |
|||
* {{incode|rotation}}: {{incode|Rotation}} |
|||
* {{incode|axis}}: asse di rotazione ({{incode|Vector}}) |
|||
* {{incode|angle}}: angolo di rotazione (senza unità o con unità {{incode|Angle}}) |
|||
* {{incode|matrix}}: {{incode|Matrix}} |
|||
Esempi: |
|||
* {{incode|placement(vector(2; 1; 3); rotation(vector(0; 0; 1); 45))}} |
|||
* {{incode|create(<<placement>>; create(<<vector>>; 2; 1; 2); create(<<rotation>>; create(<<vector>>; 0; 1; 0); 45))}} |
|||
|- |
|||
| {{incode|placement(base; rotation; center)}} |
|||
|- |
|||
| {{incode|placement(base; axis; angle)}} |
|||
|- |
|||
| {{incode|placement(matrix)}} |
|||
|- |
|- |
||
| {{incode|create(<<placement>>; ...)}} |
|||
| <= |
|||
| less than or equal to |
|||
|} |
|} |
||
{{Top}} |
|||
<span id="Vector_functions"></span> |
|||
=== Funzioni vettoriali === |
|||
Funzioni: {{Version/it|1.0}}. |
|||
<div class="mw-translate-fuzzy"> |
|||
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> |
|||
{| class="wikitable" |
|||
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. |
|||
! Funzione / Operatore |
|||
! Descrizzione |
|||
|- |
|||
| {{incode|v1 + v2}} |
|||
| Somma vettoriale. |
|||
|- |
|||
| {{incode|v1 - v2}} |
|||
| Sottrazione vettoriale. |
|||
|- |
|||
| {{incode|v * s}} |
|||
| Prodotto scalare per {{incode|s}}. |
|||
|- |
|||
| {{incode|vangle(v1; v2)}} |
|||
| Angolo tra due vettori in gradi. |
|||
|- |
|||
| {{incode|vcross(v1; v2)}} |
|||
| Prodotto vettoriale tra due vettori <math>v_1 \times v_2</math>. |
|||
|- |
|||
| {{incode|v1 * v2}} |
|||
| rowspan="2" | Prodotto scalare tra due vettori <math>v_1 \cdot v_2</math>. |
|||
|- |
|||
| {{incode|vdot(v1; v2)}} |
|||
|- |
|||
| {{incode|vlinedist(v1; v2; v3)}} |
|||
| Distanza tra {{incode|v1}} e una linea attraverso {{incode|v2}} in direzione di {{incode|v3}}. |
|||
|- |
|||
| {{incode|vlinesegdist(v1; v2; v3)}} |
|||
| Distanza tra il vettore {{incode|v1}} e il punto più vicino su un segmento di linea da {{incode|v2}} a {{incode|v3}}. |
|||
|- |
|||
| {{incode|vlineproj(v1; v2; v3)}} |
|||
| Proiezione di un vettore {{incode|v1}} su una linea attraverso {{incode|v2}} in direzione {{incode|v3}}. |
|||
|- |
|||
| {{incode|vnormalize(v)}} |
|||
| Normalizza un vettore in un vettore unitario. |
|||
|- |
|||
| {{incode|vplanedist(v1)}} |
|||
| Distanza tra il vettore {{incode|v1}} e un piano definito da un punto {{incode|v2}} e una normale {{incode|v3}}. |
|||
|- |
|||
| {{incode|vplaneproj(v1)}} |
|||
| Proietta il vettore {{incode|v1}} su un piano definito da un punto {{incode|v2}} e una normale {{incode|v3}}. |
|||
|- |
|||
| {{incode|vscale(v; sx; sy; sz)}} |
|||
| rowspan="4" | Ridimensiona in modo non uniforme un vettore di {{incode|sx}} nella direzione X, {{incode|sy}} nella direzione Y e {{incode|sz}} nella direzione Z. |
|||
|- |
|||
| {{incode|vscalex(v; sx)}} |
|||
|- |
|||
| {{incode|vscaley(v; sy)}} |
|||
|- |
|||
| {{incode|vscalez(v; sz)}} |
|||
|} |
|||
{{Top}} |
|||
<span id="Matrix_functions"></span> |
|||
=== Funzioni matriciali === |
|||
{{incode|Rotation}} e {{incode|Placement}} possono essere rappresentati ciascuno da una {{incode|Matrix}}. Le seguenti funzioni accettano tutte {{incode|Matrix}}, {{incode|Rotation}} o {{incode|Placement}} come primo parametro indicato nella tabella seguente da {{incode|m}}. Il tipo dell'oggetto restituito è lo stesso dell'oggetto fornito nel primo argomento tranne quando si utilizza {{incode|mtranslate}} su {{incode|Rotation}}, nel qual caso sarà restituito {{incode|Placement}}. |
|||
All values must have a unit. Therefore you must in general use a unit for values in spreadsheets.<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. |
|||
{| class="wikitable" |
|||
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³. |
|||
! Funzione |
|||
! Descrizione |
|||
|- |
|||
| {{incode|minvert(m)}} |
|||
| Calcola la [https://it.wikipedia.org/wiki/Matrice_invertibile Matrice inversa]. |
|||
|- |
|||
| {{incode|mrotate(m; rotation)}} |
|||
| rowspan="3" | [https://it.wikipedia.org/wiki/Matrice_di_trasformazione Rotazione] con: |
|||
* una {{incode|Rotazione}} |
|||
* un asse ({{incode|Vettore}}) e un angolo ({{incode|Angolo}} con unità o adimensionale) |
|||
* i tre angoli di Eulero {{incode|α}}, {{incode|β}}, {{incode|γ}} |
|||
|- |
|||
| {{incode|mrotate(m; axis; angle)}} |
|||
|- |
|||
| {{incode|mrotate(m; α; β; γ)}} |
|||
|- |
|||
| {{incode|mrotatex(m; angle)}} |
|||
| [https://it.wikipedia.org/wiki/Matrice_di_trasformazione Rotazione] attorno all'asse X. |
|||
|- |
|||
| {{incode|mrotatey(m; angle)}} |
|||
| [https://it.wikipedia.org/wiki/Matrice_di_trasformazione Rotazione] attorno all'asse Y. |
|||
|- |
|||
| {{incode|mrotatez(m; angle)}} |
|||
| [https://it.wikipedia.org/wiki/Matrice_di_trasformazione Rotazione] attorno all'asse Z. |
|||
|- |
|||
| {{incode|mtranslate(m; vector)}} |
|||
| rowspan="2" | [https://it.wikipedia.org/wiki/Traslazione_(geometria)#Rappresentazione_con_matrici Traslazione] con un {{incode|vector}} ({{incode|Vector}}) o con i valori X, Y, Z. Se una {{incode|Rotazione}} è anche traslata, l'oggetto restituito è un {{incode|Placement}}. |
|||
|- |
|||
| {{incode|mtranslate(m; x; y; z)}} |
|||
|- |
|||
| {{incode|mscale(m; vector)}} |
|||
| rowspan="2" | [https://en.wikipedia.org/wiki/Scaling_(geometry)#Matrix_representation Scala] per un {{incode|vector}} ({{incode|Vector}}) o per i valori X, Y, Z. |
|||
|- |
|||
| {{incode|mscale(m; x; y; z)}} |
|||
|} |
|||
{{Top}} |
|||
<span id="Conditional_expressions"></span> |
|||
== Espressioni condizionali == |
|||
Le espressioni condizionali hanno la forma {{incode|condition ? resultTrue : resultFalse}}. La condizione è definita come un'espressione che restituisce {{incode|0}} (falso) o diverso da zero (vero). |
|||
<div class="mw-translate-fuzzy"> |
|||
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> |
|||
Sono definiti i seguenti [https://en.wikipedia.org/wiki/Relational_operator#Standard_relational_operators operatori relazionali]: |
|||
The following units are recognized by the expression parser: |
|||
{| class="wikitable" |
|||
!style="width: 33%;"|Operatore |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|||
| style="text-align:center;" | '''==''' |
|||
| uguale |
|||
|- |
|||
| style="text-align:center;" | '''!=''' |
|||
| diverso |
|||
|- |
|||
| style="text-align:center;" | '''>''' |
|||
| maggiore |
|||
|- |
|||
| style="text-align:center;" | '''<''' |
|||
| minore |
|||
|- |
|||
| style="text-align:center;" | '''>=''' |
|||
| maggiore o uguale |
|||
|- |
|||
| style="text-align:center;" | '''<=''' |
|||
| minore o uguale |
|||
|} |
|||
{{Top}} |
|||
<span id="Units"></span> |
|||
==Unità== |
|||
Le unità possono essere utilizzate direttamente nelle espressioni. Il parser le collega al valore precedente. Quindi {{incode|2mm}} o {{incode|2 mm}} è valido mentre {{incode|mm}} non è valido perché non esiste un valore precedente. |
|||
Amount of substance: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
Tutti i valori devono avere un'unità. Pertanto, in generale è necessario utilizzare un'unità per i valori nei fogli di calcolo. <br/> |
|||
!style="width: 33%;"|Unit |
|||
In alcuni casi funziona anche senza un'unità, ad esempio se nella cella B1 del foglio di calcolo si ha solo il numero {{incode|1.5}} e si fa riferimento ad esso per l'altezza del pad. Questo funziona perché l'altezza del pad predispone l'unità {{incode|mm}} che viene utilizzata quando non viene fornita alcuna unità. Però fallisce se si utilizza per l'altezza del pad, ad es. {{incode|Sketch1.Constraints.Width - Spreadsheet.B1}} perché {{incode|Sketch1.Constraints.Width}} ha un'unità e {{incode|Spreadsheet.B1}} no. |
|||
!style="width: 66%;"|Description |
|||
Le unità con esponenti possono essere inserite direttamente. Quindi ad es. {{incode|mm^3}} viene riconosciuto come mm³ e {{incode|m^3}} viene riconosciuto come m³. |
|||
Se si ha una variabile il cui nome è quello di un'unità di misura, si deve inserire la variabile tra {{incode|<< >>}} per evitare che venga riconosciuta come un'unità di misura. Ad esempio, la dimensione {{incode|Sketch.Constraints.A}} verrebbe riconosciuta come l'unità ampere. Quindi è necessario scriverla nell'espressione come {{incode|Sketch.Constraints.<<A>>}}. |
|||
Il parser delle espressioni riconosce le seguenti unità: |
|||
<span id="Amount_of_substance"></span> |
|||
=== Quantità di sostanza === |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|||
| mmol |
|||
| Milli[https://en.wikipedia.org/wiki/Mole_(unit) mole] |
|||
|- |
|- |
||
| mol |
| mol |
||
Line 275: | Line 530: | ||
|} |
|} |
||
Angle |
<span id="Angle"></span> |
||
=== Angolo === |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 66%;"|Description |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|- |
||
| ° |
| ° |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Grado_d%27arco Grado]; alternativa all'unità deg |
||
|- |
|- |
||
| deg |
| deg |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Grado_d%27arco Grado]; alternativa all'unità ° |
||
|- |
|- |
||
| rad |
| rad |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Radiante Radiante] |
||
|- |
|- |
||
| gon |
| gon |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Grado_centesimale Grado centesimale] |
||
|- |
|- |
||
| S |
| S |
||
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc |
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc Secondo di arco]; alternativa all'unità ″ |
||
|- |
|- |
||
| ″ |
| ″ |
||
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc |
| [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 |
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc Minuto di arco]; alternativa all'unità ′ |
||
|- |
|- |
||
| ′ |
| ′ |
||
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc |
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc Minuto di arco]; alternativa all'unità M |
||
|} |
|} |
||
Current |
<span id="Current"></span> |
||
=== Corrente === |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
!style="width: 33%;"| |
!style="width: 33%;"|Unità |
||
!style="width: 66%;"| |
!style="width: 66%;"|Descrizione |
||
|- |
|- |
||
| mA |
| mA |
||
| Milli[https:// |
| Milli[https://it.wikipedia.org/wiki/Ampere ampere] |
||
|- |
|- |
||
| A |
| A |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Ampere ampere] |
||
|- |
|- |
||
| kA |
| kA |
||
| Kilo[https:// |
| Kilo[https://it.wikipedia.org/wiki/Ampere ampere] |
||
|- |
|- |
||
| MA |
| MA |
||
| Mega[https:// |
| Mega[https://it.wikipedia.org/wiki/Ampere ampere] |
||
|} |
|} |
||
<span id="Electric_capacitance"></span> |
|||
Energy / Work: |
|||
=== Capacità elettrica === |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|||
| pF |
|||
| Pico[https://it.wikipedia.org/wiki/Farad farad] |
|||
|- |
|||
| nF |
|||
| Nano[https://it.wikipedia.org/wiki/Farad farad] |
|||
|- |
|||
| uF |
|||
| Micro[https://it.wikipedia.org/wiki/Farad farad]; alternativa all'unità µF |
|||
|- |
|||
| µF |
|||
| Micro[https://it.wikipedia.org/wiki/Farad farad]; alternativa all'unità uF |
|||
|- |
|||
| mF |
|||
| Milli[https://it.wikipedia.org/wiki/Farad farad] |
|||
|- |
|||
| F |
|||
| [https://it.wikipedia.org/wiki/Farad Farad]; 1 F = 1 s^4·A^2/m^2/kg |
|||
|} |
|||
<span id="Electric_charge"></span> |
|||
=== Carica elettrica === |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|||
| C |
|||
| [https://it.wikipedia.org/wiki/Coulomb coulomb]; 1 C = 1 A*s |
|||
|} |
|||
<span id="Electric_conductivity"></span> |
|||
=== Conducibilità elettrica === |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|||
| uS |
|||
| Micro[https://it.wikipedia.org/wiki/Siemens_(unit%C3%A0_di_misura) siemens]; alternative to the unit µS |
|||
|- |
|||
| µS |
|||
| Micro[https://it.wikipedia.org/wiki/Siemens_(unit%C3%A0_di_misura) siemens]; alternative to the unit uS |
|||
|- |
|||
| mS |
|||
| Milli[https://it.wikipedia.org/wiki/Siemens_(unit%C3%A0_di_misura) siemens] |
|||
|- |
|||
| S |
|||
| [https://it.wikipedia.org/wiki/Siemens_(unit%C3%A0_di_misura) siemens]; 1 S = 1 s^3·A^2/kg/m^2 |
|||
|- |
|||
| kS |
|||
| Kilo[https://it.wikipedia.org/wiki/Siemens_(unit%C3%A0_di_misura) siemens] |
|||
|- |
|||
| MS |
|||
| Mega[https://it.wikipedia.org/wiki/Siemens_(unit%C3%A0_di_misura) siemens] |
|||
|} |
|||
<span id="Electric_inductance"></span> |
|||
=== Induttanza elettrica === |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|||
| nH |
|||
| Nano[https://it.wikipedia.org/wiki/Henry_(unit%C3%A0_di_misura) henry] |
|||
|- |
|||
| uH |
|||
| Micro[https://it.wikipedia.org/wiki/Henry_(unit%C3%A0_di_misura) henry]; alternativa all'unità µH |
|||
|- |
|||
| µH |
|||
| Micro[https://it.wikipedia.org/wiki/Henry_(unit%C3%A0_di_misura) henry]; alternativa all'unità uH |
|||
|- |
|||
| mH |
|||
| Milli[https://it.wikipedia.org/wiki/Henry_(unit%C3%A0_di_misura) henry] |
|||
|- |
|||
| H |
|||
| [https://it.wikipedia.org/wiki/Henry_(unit%C3%A0_di_misura) henry]; 1 H = 1 kg·m^2/s^2/A^2 |
|||
|} |
|||
<span id="Electric_potential"></span> |
|||
=== Potenziale elettrico === |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|||
| mV |
|||
| Milli[https://it.wikipedia.org/wiki/Volt volt] |
|||
|- |
|||
| V |
|||
| [https://it.wikipedia.org/wiki/Volt volt] |
|||
|- |
|||
| kV |
|||
| Kilo[https://it.wikipedia.org/wiki/Volt volt] |
|||
|} |
|||
<span id="Electric_resistance"></span> |
|||
=== Resistenza elettrica === |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|||
| ohm |
|||
| [https://it.wikipedia.org/wiki/Ohm ohm]; 1 ohm = 1 kg·m^2/s^3/A^2 |
|||
|- |
|||
| kohm |
|||
| Kilo[https://it.wikipedia.org/wiki/Ohm ohm] |
|||
|- |
|||
| Mohm |
|||
| Mega[https://it.wikipedia.org/wiki/Ohm ohm] |
|||
|} |
|||
<span id="Energy/work"></span> |
|||
=== Energia/lavoro === |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
{| class="wikitable float-right mw-collapsible mw-collapsed" |
||
!style="width: 33%;"| |
!style="width: 33%;"|Unità |
||
!style="width: 66%;"| |
!style="width: 66%;"|Descrizione |
||
|- |
|||
| mJ |
|||
| Milli[https://en.wikipedia.org/wiki/Joule joule] |
|||
|- |
|- |
||
| J |
| J |
||
| [https://en.wikipedia.org/wiki/Joule |
| [https://en.wikipedia.org/wiki/Joule joule] |
||
|- |
|||
| kJ |
|||
| Kilo[https://en.wikipedia.org/wiki/Joule joule] |
|||
|- |
|||
| eV |
|||
| [https://en.wikipedia.org/wiki/Electronvolt Elettronvolt]; 1 eV = 1.602176634e-19 J |
|||
|- |
|||
| keV |
|||
| Kilo[https://en.wikipedia.org/wiki/Electronvolt elettronvolt] |
|||
|- |
|||
| MeV |
|||
| Mega[https://en.wikipedia.org/wiki/Electronvolt elettronvolt] |
|||
|- |
|||
| kWh |
|||
| [https://en.wikipedia.org/wiki/Kilowatt_hour kilowattora]; 1 kWh = 3.6e6 J |
|||
|- |
|- |
||
| Ws |
| Ws |
||
| [https://en.wikipedia.org/wiki/Joule#Watt_second Watt |
| [https://en.wikipedia.org/wiki/Joule#Watt_second Watt secondo]; alternativa all'unità ''Joule'' |
||
|- |
|- |
||
| VAs |
| VAs |
||
| [https://en.wikipedia.org/wiki/Joule |
| [https://en.wikipedia.org/wiki/Joule volt-ampere-secondo]; alternativa all'unità ''Joule'' |
||
|- |
|- |
||
| CV |
| CV |
||
| [https://en.wikipedia.org/wiki/Joule |
| [https://en.wikipedia.org/wiki/Joule coulomb-volt]; alternativa all'unità ''Joule'' |
||
|- |
|||
| cal |
|||
| [https://en.wikipedia.org/wiki/Calorie calorie]; 1 cal = 4.184 J |
|||
|- |
|||
| kcal |
|||
| Kilo[https://en.wikipedia.org/wiki/Calorie calorie] |
|||
|} |
|} |
||
Force |
<span id="Force"></span> |
||
=== Forza === |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 66%;"|Description |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|- |
||
| mN |
| mN |
||
Line 350: | Line 757: | ||
|- |
|- |
||
| N |
| N |
||
| [https://en.wikipedia.org/wiki/Newton_(unit) |
| [https://en.wikipedia.org/wiki/Newton_(unit) newton] |
||
|- |
|- |
||
| kN |
| kN |
||
Line 359: | Line 766: | ||
|- |
|- |
||
| lbf |
| lbf |
||
| [https://en.wikipedia.org/wiki/Pound_(force) |
| [https://en.wikipedia.org/wiki/Pound_(force) Libbra forza] |
||
|} |
|} |
||
Length |
<span id="Length"></span> |
||
=== Lunghezza === |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
!style="width: 66%;"|Description |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|- |
||
| nm |
| nm |
||
| Nano[https://en.wikipedia.org/wiki/Metre |
| Nano[https://en.wikipedia.org/wiki/Metre metro] |
||
|- |
|- |
||
| um |
| um |
||
| Micro[https://en.wikipedia.org/wiki/Metre |
| Micro[https://en.wikipedia.org/wiki/Metre metro]; alternativa all'unità µm |
||
|- |
|- |
||
| µm |
| µm |
||
| Micro[https://en.wikipedia.org/wiki/Metre |
| Micro[https://en.wikipedia.org/wiki/Metre metro]; alternativa all'unità ''mu'' |
||
|- |
|- |
||
| mm |
| mm |
||
| Milli[https://en.wikipedia.org/wiki/Metre |
| Milli[https://en.wikipedia.org/wiki/Metre metro] |
||
|- |
|- |
||
| cm |
| cm |
||
| Centi[https://en.wikipedia.org/wiki/Metre |
| Centi[https://en.wikipedia.org/wiki/Metre metro] |
||
|- |
|||
| mm |
|||
| Milli[https://en.wikipedia.org/wiki/Metre meter] |
|||
|- |
|- |
||
| dm |
| dm |
||
| Deci[https://en.wikipedia.org/wiki/Metre |
| Deci[https://en.wikipedia.org/wiki/Metre metro] |
||
|- |
|- |
||
| m |
| m |
||
| [https://en.wikipedia.org/wiki/Metre |
| [https://en.wikipedia.org/wiki/Metre metro] |
||
|- |
|- |
||
| km |
| km |
||
| Kilo[https://en.wikipedia.org/wiki/Metre |
| Kilo[https://en.wikipedia.org/wiki/Metre metro] |
||
|- |
|- |
||
| mil |
| mil |
||
| [https://en.wikipedia.org/wiki/Thousandth_of_an_inch Thousandth of an inch]; |
| [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]; |
| [https://en.wikipedia.org/wiki/Thousandth_of_an_inch Thousandth of an inch]; alternativa all'unità mil |
||
|- |
|- |
||
| in |
| in |
||
| [https://en.wikipedia.org/wiki/Inch Inch] |
| [https://en.wikipedia.org/wiki/Inch Inch]; alternativa all'unità " |
||
|- |
|- |
||
| ft |
| ft |
||
| [https://en.wikipedia.org/wiki/Foot_(unit) Foot]; |
| [https://en.wikipedia.org/wiki/Foot_(unit) Foot]; alternativa all'unità ' |
||
|- |
|- |
||
| ' |
| ' |
||
| [https://en.wikipedia.org/wiki/Foot_(unit) Foot]; |
| [https://en.wikipedia.org/wiki/Foot_(unit) Foot]; alternativa all'unità ''ft'' |
||
|- |
|- |
||
| yd |
| yd |
||
Line 416: | Line 823: | ||
|} |
|} |
||
<span id="Luminous_intensity"></span> |
|||
Luminous intensity: |
|||
=== Intensità luminosa === |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 66%;"|Description |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|- |
||
| cd |
| cd |
||
| [https://en.wikipedia.org/wiki/Candela |
| [https://en.wikipedia.org/wiki/Candela candela] |
||
|} |
|} |
||
<span id="Magnetic_flux"></span> |
|||
Mass: |
|||
=== Flusso magnetico === |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 66%;"|Description |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|||
| Wb |
|||
| [https://en.wikipedia.org/wiki/Weber_(unit) weber]; 1 Wb = 1 kg*m^2/s^2/A |
|||
|} |
|||
<span id="Magnetic_flux_density"></span> |
|||
=== Densità del flusso magnetico === |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|||
| G |
|||
| [https://en.wikipedia.org/wiki/Gauss_(unit) gauss]; 1 G = 1 e-4 T |
|||
|- |
|||
| T |
|||
| [https://en.wikipedia.org/wiki/Tesla_(unit) tesla]; 1 T = 1 kg/s^2/A |
|||
|} |
|||
<span id="Mass"></span> |
|||
=== Massa === |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|- |
||
| ug |
| ug |
||
| Micro[https:// |
| Micro[https://it.wikipedia.org/wiki/Grammo grammo]; alternativa all'unità µg |
||
|- |
|- |
||
| µg |
| µg |
||
| Micro[https:// |
| Micro[https://it.wikipedia.org/wiki/Grammo grammo]; alternativa all'unità ug |
||
|- |
|- |
||
| mg |
| mg |
||
| Milli[https:// |
| Milli[https://it.wikipedia.org/wiki/Grammo grammo] |
||
|- |
|- |
||
| g |
| g |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Grammo grammo] |
||
|- |
|- |
||
| kg |
| kg |
||
| Kilo[https:// |
| Kilo[https://it.wikipedia.org/wiki/Grammo grammo] |
||
|- |
|- |
||
| t |
| t |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Tonnellata Tonnellata] |
||
|- |
|- |
||
| oz |
| oz |
||
Line 452: | Line 888: | ||
|- |
|- |
||
| lb |
| lb |
||
| [https://en.wikipedia.org/wiki/Pound_(mass) Pound]; |
| [https://en.wikipedia.org/wiki/Pound_(mass) Pound]; alternativa all'unità lbm |
||
|- |
|- |
||
| lbm |
| lbm |
||
| [https://en.wikipedia.org/wiki/Pound_(mass) Pound]; |
| [https://en.wikipedia.org/wiki/Pound_(mass) Pound]; alternativa all'unità lb |
||
|- |
|- |
||
| st |
| st |
||
Line 464: | Line 900: | ||
|} |
|} |
||
<span id="Power"></span> |
|||
<div class="mw-translate-fuzzy"> |
|||
=== |
=== Potenza === |
||
</div> |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
Pressure: |
|||
!style="width: 33%;"|Unità |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: |
!style="width: 66%;"|Descrizione |
||
|- |
|||
!style="width: 66%;"|Description |
|||
| W |
|||
| [https://en.wikipedia.org/wiki/Watt watt] |
|||
|- |
|||
| kW |
|||
| Kilo[https://en.wikipedia.org/wiki/Watt watt], {{Version/it|0.19}} |
|||
|- |
|||
| VA |
|||
| [https://en.wikipedia.org/wiki/Volt-ampere volt-ampere] |
|||
|} |
|||
<span id="Pressure"></span> |
|||
=== Pressione === |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|- |
||
| Pa |
| Pa |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Pascal_(unit%C3%A0_di_misura) pascal] |
||
|- |
|- |
||
| kPa |
| kPa |
||
| Kilo[https:// |
| Kilo[https://it.wikipedia.org/wiki/Pascal_(unit%C3%A0_di_misura) pascal] |
||
|- |
|- |
||
| MPa |
| MPa |
||
| Mega[https:// |
| Mega[https://it.wikipedia.org/wiki/Pascal_(unit%C3%A0_di_misura) pascal] |
||
|- |
|- |
||
| GPa |
| GPa |
||
| Giga[https:// |
| Giga[https://it.wikipedia.org/wiki/Pascal_(unit%C3%A0_di_misura) pascal] |
||
|- |
|- |
||
| uTorr |
| uTorr |
||
| Micro[https:// |
| Micro[https://it.wikipedia.org/wiki/Torr torr]; alternativa all'unità µTorr |
||
|- |
|- |
||
| µTorr |
| µTorr |
||
| Micro[https:// |
| Micro[https://it.wikipedia.org/wiki/Torr torr]; alternativa all'unità uTorr |
||
|- |
|- |
||
| mTorr |
| mTorr |
||
| Milli[https:// |
| Milli[https://it.wikipedia.org/wiki/Torr torr] |
||
|- |
|- |
||
| Torr |
| Torr |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Torr Torr]; 1 Torr = 133.32 Pa |
||
|- |
|- |
||
| psi |
| psi |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Psi_(unit%C3%A0_di_misura) Libbra-forza per pollice quadrato]; 1 psi = 6.895 kPa |
||
|- |
|- |
||
| ksi |
| ksi |
||
| Kilo[https:// |
| Kilo[https://it.wikipedia.org/wiki/Psi_(unit%C3%A0_di_misura) Libbra-forza per pollice quadrato] |
||
|} |
|} |
||
Temperature |
<span id="Temperature"></span> |
||
=== Temperatura === |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 66%;"|Description |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|- |
||
| uK |
| uK |
||
| Micro[https:// |
| Micro[https://it.wikipedia.org/wiki/Kelvin kelvin]; alternativa all'unità µK |
||
|- |
|- |
||
| µK |
| µK |
||
| Micro[https:// |
| Micro[https://it.wikipedia.org/wiki/Kelvin kelvin]; alternativa all'unità uK |
||
|- |
|- |
||
| mK |
| mK |
||
| Milli[https:// |
| Milli[https://it.wikipedia.org/wiki/Kelvin kelvin] |
||
|- |
|- |
||
| K |
| K |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Kelvin Kelvin] |
||
|} |
|} |
||
<span id="Time"></span> |
|||
Time: |
|||
=== Tempo === |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 66%;"|Description |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|- |
||
| s |
| s |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Secondo secondo] |
||
|- |
|- |
||
| min |
| min |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Minuto minuto] |
||
|- |
|- |
||
| h |
| h |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Ora ora] |
||
|} |
|||
Torque: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
!style="width: 66%;"|Description |
|||
|- |
|- |
||
| Hz (1/s) |
|||
| Nm |
|||
| [https:// |
| [https://it.wikipedia.org/wiki/Hertz Hertz] |
||
|} |
|||
Volume: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unit |
|||
!style="width: 66%;"|Description |
|||
|- |
|- |
||
| |
| kHz |
||
| [https:// |
| Kilo[https://it.wikipedia.org/wiki/Hertz hertz] |
||
|- |
|||
| MHz |
|||
| Mega[https://it.wikipedia.org/wiki/Hertz hertz] |
|||
|- |
|||
| GHz |
|||
| Giga[https://it.wikipedia.org/wiki/Hertz hertz] |
|||
|- |
|||
| THz |
|||
| Tera[https://it.wikipedia.org/wiki/Hertz hertz] |
|||
|} |
|} |
||
=== Volume === |
|||
The following commonly used units are not yet supported: |
|||
{| class="wikitable float-right mw-collapsible mw-collapsed" |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 25%;"|Unit |
|||
!style="width: |
!style="width: 33%;"|Unità |
||
!style="width: |
!style="width: 66%;"|Descrizione |
||
|- |
|- |
||
| |
| ml |
||
| [https://en.wikipedia.org/wiki/ |
| Milli[https://en.wikipedia.org/wiki/Litre litro] |
||
| 1 A*s |
|||
|- |
|- |
||
| |
| l |
||
| [https://en.wikipedia.org/wiki/ |
| [https://en.wikipedia.org/wiki/Litre litro] |
||
| 1 /s |
|||
|- |
|- |
||
| |
| cft |
||
| [https://en.wikipedia.org/wiki/ |
| Cubic[https://en.wikipedia.org/wiki/Foot_(unit) foot] (piede cubico) |
||
|} |
|||
| 1 W/A |
|||
<span id="Special_imperial_units"></span> |
|||
=== Unità imperiali speciali === |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 33%;"|Unità |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|- |
||
| |
| mph |
||
| [https://en.wikipedia.org/wiki/ |
| [https://en.wikipedia.org/wiki/Miles_per_hour Miles per hour] |
||
| 1.602176634e-19 J |
|||
|- |
|- |
||
| |
| sqft |
||
| [https://en.wikipedia.org/wiki/ |
| [https://en.wikipedia.org/wiki/Square_foot Square foot] |
||
|} |
|||
| 3.6e6 J |
|||
<span id="Unsupported_units"></span> |
|||
=== Unità non supportate === |
|||
Le seguenti unità di uso comune non sono ancora supportate, per alcune viene fornita un'alternativa: |
|||
{| class="wikitable mw-collapsible mw-collapsed" |
|||
!style="width: 25%;"|Unità |
|||
!style="width: 50%;"|Descrizione |
|||
!style="width: 25%;"|Alternativa |
|||
|- |
|- |
||
| |
| °C |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Grado_Celsius Grado Celsius] |
||
| [°C] + 273.15 K |
|||
| 100 kPa |
|||
|- |
|- |
||
| |
| °F |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Grado_Fahrenheit Grado Fahrenheit]; |
||
| ([°F] + 459.67) × 5/9 |
|||
| 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:// |
| [https://it.wikipedia.org/wiki/Unit%C3%A0_di_massa_atomica Unità di massa atomica]; alternativa all'unità Da |
||
| 1.66053906660e-27 kg |
| 1.66053906660e-27 kg |
||
|- |
|- |
||
| Da |
| Da |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Unit%C3%A0_di_massa_atomica dalton]; alternativa all'unità u |
||
| 1.66053906660e-27 kg |
| 1.66053906660e-27 kg |
||
|- |
|||
| cal |
|||
| [https://en.wikipedia.org/wiki/Calorie Calorie] |
|||
| 4.184 J |
|||
|- |
|- |
||
| sr |
| sr |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Steradiante steradiante] |
||
| not directly |
| not directly |
||
|- |
|- |
||
| lm |
| lm |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Lumen lumen] |
||
| non direttamente |
|||
| not directly |
|||
|- |
|- |
||
| lx |
| lx |
||
| [https:// |
| [https://it.wikipedia.org/wiki/Lux lux] |
||
| non direttamente |
|||
| not directly |
|||
|- |
|- |
||
| |
| px |
||
| |
| [https://it.wikipedia.org/wiki/Pixel pixel] |
||
| non direttamente |
|||
| 1000 ksi |
|||
|} |
|} |
||
{{Top}} |
|||
<span id="Invalid_characters_and_names"></span> |
|||
==Caratteri e nomi non validi== |
|||
La funzionalità delle espressioni è molto potente, ma per raggiungere questo potere ha alcune limitazioni relative ad alcuni caratteri. Per ovviare a questo, FreeCAD offre la possibilità di utilizzare etichette e fare riferimento ad esse invece che ai nomi degli oggetti. Nelle etichette puoi usare quasi tutti i caratteri speciali. |
|||
Nei casi in cui non è possibile utilizzare un'etichetta, come il nome dei vincoli di uno schizzo, è necessario sapere quali caratteri non sono consentiti. |
|||
<span id="Labels"></span> |
|||
===Etichette=== |
|||
Per le [[Object_name/it#Etichette|etichette]] non ci sono caratteri non validi, tuttavia è necessario eseguire l'escape di alcuni caratteri: |
|||
{| class="wikitable" |
|||
!style="width: 33%;"|Caratteri |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|||
| {{incode|'}}, {{incode|\}}, {{incode|"}} |
|||
| È necessario inserire l'escape aggiungendogli {{incode|\}}. |
|||
|} |
|||
Ad esempio, l'etichetta {{incode|Sketch\002}} deve essere referenziata come {{incode|<<Sketch\\002>>}}. |
|||
<span id="Names"></span> |
|||
===Nomi=== |
|||
[[Object_name#Nome|Nomi]] di oggetti come dimensioni, schizzi, ecc. non devono avere i caratteri o le sequenze di caratteri elencati di seguito, perchè altrimenti il nome non è valido: |
|||
{| class="wikitable" |
|||
!style="width: 33%;"|Caratteri / Sequenze di caratteri |
|||
!style="width: 66%;"|Descrizione |
|||
|- |
|||
| '''+''', '''-''', '''*''', '''/''', '''^''', '''_''', '''<''', '''>''', '''(''', ''')''', '''{''', '''}''', '''[''', ''']''', '''.''', ''',''', '''=''' |
|||
| Caratteri che sono operatori matematici o parte di costrutti matematici |
|||
|- |
|||
| '''A''', '''kA''', '''mA''', '''MA''', '''J''', '''K''', ''' ' ''', ''' ft ''', '''°''', and many more! |
|||
| Caratteri e sequenze di caratteri che sono unità (vedere paragrafo [[#Unità|Unità]].) |
|||
|- |
|||
| '''#''', '''!''', '''?''', '''§''', '''$''', '''%''', '''&''', ''':''', ''';''', '''\''', '''<nowiki>|</nowiki>''', '''~''', '''∆''', '''¿''', e molti altri! |
|||
| Caratteri usati come segnaposto o per attivare operazioni speciali |
|||
|- |
|||
| '''pi''', '''e''' |
|||
| Costanti matematiche |
|||
|- |
|||
| '''´''', '''`''', ''' ' ''', '''"''' |
|||
| Caratteri usati per gli accenti |
|||
|- |
|||
| spazio |
|||
| Uno spazio definisce la fine di un nome e pertanto non può essere utilizzato |
|||
|} |
|||
Ad esempio, è valido il seguente nome: {{incode|<<Sketch>>.Constraints.T2üßµ@}}. Mentre questi sono nomi non validi: {{incode|<<Sketch>>.Constraints.test\result_2}} (\r significa "ritorno a capo") o {{incode|<<Sketch>>.Constraints.mol}} (mol è un'unità). |
|||
Poiché i nomi più brevi (soprattutto se hanno solo uno o due caratteri) possono facilmente risultare in nomi non validi, prendere in considerazione l'utilizzo di nomi più lunghi e/o stabilire una convenzione di denominazione adeguata. |
|||
<span id="Cell_aliases"></span> |
|||
===Alias di cella=== |
|||
Vedere [[Spreadsheet_SetAlias/it#Utilizzo|Spreadsheet SetAlias]]. |
|||
{{Top}} |
|||
<span id="Reference_to_CAD_data"></span> |
|||
== Riferimento ai dati CAD == |
== Riferimento ai dati CAD == |
||
È possibile utilizzare i dati del modello stesso in un'espressione. Per fare riferimento a una proprietà utilizzare {{incode|object_name.property}} o {{incode|<<object_label>>.property}}, le etichette devono essere racchiuse tra {{incode|<<}} e {{incode|>>} }. Se si desidera utilizzare le etichette, queste devono essere univoche. |
|||
Tutti gli esempi successivi fanno riferimento all'oggetto con il suo nome, ma in tutti i casi è possibile utilizzare anche l'etichetta dell'oggetto. |
|||
Se la proprietà è un composto di campi, è possibile accedere ai singoli campi come {{incode|object_name.property.field}}. |
|||
Per fare riferimento agli oggetti dell'elenco utilizzare {{incode|object_name.list[list_index]}}. Se si vuole fare riferimento a un vincolo in uno schizzo, usare {{incode|Sketch.Constraints[16]}}. Se ci si trova nello stesso sketch è possibile ometterne il nome e usare semplicemente {{incode|Constraints[16]}}. Tenere presente che l'indice inizia con 0, pertanto è necessario fare riferimento a Constraint17 come {{incode|Constraints[16]}}. |
|||
Per fare riferimento all'oggetto stesso utilizzare la pseudo proprietà {{incode|_self}}: {{incode|object_name._self}}. |
|||
La tabella seguente mostra alcuni esempi: |
La tabella seguente mostra alcuni ulteriori esempi: |
||
{| class="wikitable" |
|||
{|{{Prettytable}} |
|||
!Dati CAD |
!Dati CAD |
||
!Chiamata nell'espressione |
!Chiamata nell'espressione |
||
!Risultato |
!Risultato |
||
|- |
|- |
||
|Lunghezza |
|Lunghezza di un [[Part_Box/it|Box di Part]] |
||
| |
|{{incode|Box.Length}} |
||
|Lunghezza con unità |
|Lunghezza con unità (mm) |
||
|- |
|- |
||
|Volume |
|Volume di un Box |
||
| |
|{{incode|Box.Shape.Volume}} |
||
|Volume |
|Volume in mm³ senza unità |
||
|- |
|- |
||
|Tipo di |
|Tipo di Shape di un Box |
||
| |
|{{incode|Box.Shape.ShapeType}} |
||
|Stringa: Solid |
|Stringa: Solid |
||
|- |
|- |
||
|Etichetta |
|Etichetta di una Box |
||
| |
|{{incode|Box.Label}} |
||
|Stringa: Label |
|Stringa: Label |
||
|- |
|- |
||
| |
|Coordinata X del centro di massa di un Box |
||
| |
|{{incode|Box.Shape.CenterOfMass.x}} |
||
| |
|Coordinata X in mm senza unità |
||
|- |
|||
|Coordinata X del Box placement |
|||
|{{incode|Box.Placement.Base.x}} |
|||
|Coordinata X con l'unità (mm) |
|||
|- |
|||
|Componente X dell'asse di rotazione del placement di un Box |
|||
|{{incode|Box.Placement.Rotation.Axis.x}} |
|||
|Componente X del vettore unitario in mm senza unità |
|||
|- |
|||
|Angolo di rotazione del placemente di un Box |
|||
|{{incode|Box.Placement.Rotation.Angle}} |
|||
|Angolo di rotazione con unità (deg) |
|||
|- |
|||
|Oggetto Full Box |
|||
|{{incode|Box._self}} |
|||
|Oggetto del tipo <Part::PartFeature> |
|||
|- |
|- |
||
|Valore di un vincolo in uno schizzo |
|Valore di un vincolo in uno schizzo |
||
|Constraints.Width |
|{{incode|Constraints.Width}} |
||
|Valore numerico |
|Valore numerico di un vincolo denominato {{incode|Width}} nello sketch, se l'espressione è utilizzata nello sketch stesso. |
||
|- |
|- |
||
|Valore di un vincolo in uno schizzo |
|Valore di un vincolo in uno schizzo |
||
|MySketch.Constraints.Width |
|{{incode|MySketch.Constraints.Width}} |
||
|Valore numerico |
|Valore numerico di un vincolo denominato {{incode|Width}} nello sketch, se l'espressione viene utilizzata all'esterno dello sketch. |
||
|- |
|- |
||
|Valore di un alias in |
|Valore di un alias in uno Spreadsheet |
||
|Spreadsheet.Depth |
|{{incode|Spreadsheet.Depth}} |
||
|Valore dell'alias |
|Valore dell'alias {{incode|Depth}} nel foglio di calcolo {{incode|Spreadsheet}} |
||
|- |
|- |
||
|Valore di una proprietà locale |
|Valore di una proprietà locale |
||
|Length |
|{{incode|Length}} |
||
|Valore della proprietà Length, ad |
|Valore della proprietà {{PropertyData|Length}}, ad esempio in un oggetto Pad, se l'espressione è utilizzata ad esempio in {{PropertyData|Length2}} nello stesso oggetto. |
||
|} |
|} |
||
<span id="Cyclic_dependencies"></span> |
|||
=== Dipendenze cicliche === |
|||
FreeCAD controlla le dipendenze in base alla relazione tra gli oggetti del documento, non alle proprietà. Ciò significa che non è possibile fornire dati a un oggetto ed eseguire query sullo stesso oggetto per ottenere risultati. Ad esempio, anche se non esistono dipendenze cicliche quando vengono considerate le proprietà stesse, potresti non avere un oggetto che ottiene le sue dimensioni da un foglio di calcolo e quindi visualizza il volume di quell'oggetto nello stesso foglio di calcolo. Si devono utilizzare due fogli di calcolo, uno per gestire il proprio modello e l'altro per i report. |
|||
Come soluzione alternativa è possibile visualizzare un intervallo di celle dal secondo foglio di calcolo nel primo (o viceversa) creando un [[Spreadsheet_Workbench#Cell_binding|associazione di celle]] con l'opzione {{MenuCommand|Nascondi dipendenza dell'associazione}}. |
|||
Un altro modo per aggirare le dipendenze cicliche è nascondere il riferimento utilizzando la funzione {{incode|href}} o {{incode|hiddenref}} per le singole espressioni, ad esempio: {{incode|href(Box.Length)}}. |
|||
Tenere presente che entrambe le soluzioni alternative menzionate devono essere utilizzate con cautela e che non funzionano se le proprietà segnalate dipendono da dimensioni determinate dallo stesso foglio di calcolo. |
|||
{{Top}} |
|||
<span id="Document-wide_global_variables"></span> |
|||
== Variabili globali nell'ambito del documento == |
== Variabili globali nell'ambito del documento == |
||
Al momento in FreeCAD non esiste il concetto di variabili globali. Invece, utilizzando l'ambiente [[Spreadsheet Workbench/it|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. |
Al momento in FreeCAD non esiste il concetto di variabili globali. Invece, utilizzando l'ambiente [[Spreadsheet Workbench/it|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. |
||
{{Top}} |
|||
<span id="Cross-document_linking"></span> |
|||
== Riferimenti incrociati nel documento == |
== 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 {{PropertyData/it|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 class="mw-translate-fuzzy"> |
|||
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. |
||
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 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". Notare che il documento master deve sempre essere caricato affinché i valori nel master siano disponibili per il documento dipendente. |
|||
</div> |
|||
{{incode|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 {{Button|OK}} diventa attivo. |
|||
Naturalmente, dopo spetta all'utente il compito di caricare i documenti corrispondenti, quando si desidera cambiare qualcosa. |
Naturalmente, dopo spetta all'utente il compito di caricare i documenti corrispondenti, quando si desidera cambiare qualcosa. |
||
{{Top}} |
|||
<span id="Known_issues_/_remaining_tasks"></span> |
|||
== Problemi noti / attività rimanenti == |
== Problemi noti / attività rimanenti == |
||
* FreeCAD non dispone ancora di un gestore di espressioni integrato in cui tutte le espressioni in un documento sono elencate e possono essere create, cancellate, interrogate, ecc. Ma è disponibile un componente aggiuntivo: [https://github.com/gbroques/fcxref fcxref expression manager]. |
|||
* 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 bug/ticket aperti per le espressioni possono essere trovati su [https://github.com/FreeCAD/FreeCAD/issues?q=is%3Aissue+is%3Aopen+label%3AExpressions GitHub]. |
|||
* 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. |
|||
{{Top}} |
|||
* 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 bug aperti per le espressioni si trovano in [https://freecadweb.org/tracker/set_project.php?project_id=4;20 FreeCAD Bugtracker Expressions category] |
|||
{{Userdocnavi/it}} |
|||
[[Category:User Documentation/it]] |
|||
[[Category:API/it]] |
|||
{{Powerdocnavi{{#translation:}}}} |
|||
{{clear}} |
|||
[[Category:Spreadsheet{{#translation:}}]] |
Latest revision as of 20:06, 23 April 2024
Descrizione
È possibile definire le proprietà utilizzando espressioni matematiche. Nella GUI, gli spin box o i campi di input che sono legati alle proprietà contengono un'icona blu . Cliccando sull'icona, oppure digitando il segno di uguale =, si porta in primo piano l'editor delle espressioni per quella particolare proprietà.
Un'espressione di FreeCAD è un'espressione matematica che utilizza gli operatori, le funzioni e le costanti standard come descritto di seguito. Inoltre, l'espressione può fare riferimento a proprietà dell'oggetto e utilizzare anche espressioni condizionali. I numeri in un'espressione possono avere una unità facoltativa allegata.
I numeri possono utilizzare una virgola ,
o un punto decimale .
per separare le cifre intere dai decimali. Quando viene utilizzato il marcatore decimale, deve essere seguito da almeno una cifra. Pertanto, le espressioni 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 necessarie. Ad esempio, 2mm + 4mm
è un'espressione valida, mentre 2mm + 4
non lo è. Questo vale anche per i riferimenti alle proprietà dell'oggetto che hanno unità, come la proprietà Length. Pertanto Pad001.Length + 1
non è valido poiché aggiunge un numero puro a una proprietà con una unità di lunghezza, si richiede Pad001.Length + 1mm
.
Alcuni errori relativi alle unità possono sembrare non intuitivi, con espressioni respinte o che producono risultati che non corrispondono alle unità della proprietà impostata. Ecco alcuni esempi:
1/2mm
non viene interpretato come mezzo millimetro ma come 1/(2mm)
, risultante in: 0.5 mm^-1
.
sqrt(2)mm
non è valido perché la chiamata alla funzione non è un numero. Questo deve essere inserito come sqrt(2) * 1mm
.
Argomenti delle funzioni
Quando una funzione accetta più argomenti, questi possono essere separati da un punto e virgola ;
o da una virgola seguita da uno spazio ,
. In quest'ultimo caso, la virgola viene convertita in un punto e virgola dopo la voce. Quando si utilizza un punto e virgola, non è necessario terminare la riga con uno spazio.
Gli argomenti possono includere riferimenti a celle in un foglio di calcolo. Un riferimento di cella è costituito dalla lettera maiuscola della riga della cella seguita dal suo numero di colonna, ad esempio A1
. È anche possibile fare riferimento a una cella utilizzando l'alias della cella, ad esempio Spreadsheet.MyPartWidth
.
Riferimenti a oggetti
Come già mostrato sopra,S si può fare riferimento a un oggetto tramite il suo DatiName. Ma si può anche usare la sua DatiLabel. Nel caso di una DatiLabel, essa deve essere racchiusa tra i simboli <<
e >>
, come questa: <<Label>>
.
È possibile fare riferimento a qualsiasi proprietà di un oggetto. Ad esempio, per fare riferimento all'altezza di un cilindro, è possibile utilizzare Cylinder.Height
o <<Label_of_cylinder>>.Height
Per ulteriori informazioni sui riferimenti agli oggetti, vedere Riferimento ai dati CAD.
Costanti supportate
Sono supportate le seguenti costanti:
Constante | Descrizione |
---|---|
e | Numero di Eulero |
pi | Pi greco |
Operatori supportati
Sono supportati i seguenti operatori:
Operatore | Descrizione |
---|---|
+ | Addizione |
- | Sottrazione |
* | Multiplicazione |
/ | Divisione virgola mobile |
% | Resto |
^ | Potenze |
Funzioni supportate
Funzioni matematiche generali
Sono supportate le seguenti funzioni matematiche:
Funzioni trigonometriche
Le funzioni trigonometriche usano il grado come unità predefinita. Per i radianti, aggiungere rad
dopo il primo valore in un'espressione. Quindi ad es. cos(45)
è uguale a cos(pi rad / 4)
. Le espressioni in gradi possono utilizzare deg
o °
, ad es. 360deg - atan2(3; 4)
o 360° - atan2(3; 4)
. Se un'espressione è senza unità e deve essere convertita in gradi o radianti per compatibilità, moltiplicare per 1deg
, 1°
o 1rad
in modo appropriato, ad es. (360 - X) * 1deg
; (360 - X) * 1°
; (0.5 + pi / 2) * 1rad
.
Funzione | Descrizione | Intervallo di valori |
---|---|---|
acos(x)
|
Arco seno | -1 <= x <= 1 |
asin(x)
|
Arco coseno | -1 <= x <= 1 |
atan(x)
|
Arco tangente, restituisce un valore con -90° < valore < 90° | tutti |
atan2(y; x)
|
Arco tangente 2 con y/x tenendo conto del quadrante, restituisce un valore con -180° < valore <= 180° | tutti, l'input non valido x = y = 0 restituisce 0 |
cos(x)
|
Coseno | tutti |
cosh(x)
|
Coseno iperbolico | tutti |
sin(x)
|
Seno | tutti |
sinh(x)
|
Seno iperbolico | tutti |
tan(x)
|
Tangente | tutti, eccetto x = n*90 con = intero dispari |
tanh(x)
|
Tangente iperbolica | tutti |
hypot(x; y)
|
Addizione pitagorica (utilizzo di hypot), e.g. hypot(4; 3) = 5 | x e y >= 0 |
cath(x; y)
|
Data l'ipotenusa e un lato, restituisce l'altro lato del triangolo rettangolo, per esempio cath(5; 3) = 4 | x >= y >= 0 |
Funzioni esponenziali e logaritmiche
Funzione | Descrizione | Intervallo di valori |
---|---|---|
exp(x)
|
Esponenziale | tutti |
log(x)
|
Logaritmo naturale | x > 0 |
log10(x)
|
Logaritmo in base 10 | x > 0 |
pow(x; y)
|
Potenza | tutti |
sqrt(x)
|
Radice quadrata | x >= 0 |
cbrt(x) disponibile dalla versione 0.21
|
Radice cubica | tutti |
Funzioni di arrotondamento, troncamento e resto
Funzione | Descrizione | Intervallo di valori |
---|---|---|
abs(x)
|
Valore assoluto | tutti |
ceil(x)
|
Approssimazione per difetto, valore intero più piccolo maggiore o uguale a x | tutti |
floor(x)
|
Approssimazione in eccesso, valore intero più grande minore o uguale a x | tutti |
mod(x; y)
|
Resto dopo aver diviso x per y, il segno del risultato è quello del dividendo. | tutti, eccetto y = 0 |
round(x)
|
Arrotondamento all'intero più vicino | tutti |
trunc(x)
|
Troncamento all'intero più vicino nella direzione dello zero | tutti |
Funzioni statistiche / aggregate
Le funzioni di aggregazione prendono uno o più argomenti.
I singoli argomenti per le funzioni di aggregazione possono essere costituiti da intervalli di celle. Un intervallo di celle è espresso come due riferimenti di cella separati da due punti :
, ad esempio average(B1:B8)
o sum(A1:A4; B1:B4 )
.
I riferimenti di cella possono anche utilizzare alias di cella, ad esempio average(StartTemp:EndTemp)
.
Sono supportate le seguenti funzioni di aggregazione:
Funzione | Descrizione | Intervallo di valori |
---|---|---|
average(a; b; c; ...)
|
Media aritmetica del valore degli argomenti, calcolato come sum(a; b; c; ...) / count(a; b; c; ...) | tutti |
count(a; b; c; ...)
|
Conteggio degli argomenti, generalmente utilizzato su intervalli di celle | tutti |
max(a; b; c; ...)
|
Massimo valore tra gli argomenti | tutti |
min(a; b; c; ...)
|
Minimo valore tra gli argomenti | tutti |
stddev(a; b; c; ...)
|
Deviazione standard dei valori degli argomenti | tutti |
sum(a; b; c; ...)
|
Sommatoria dei valori degli argomenti, tipicamente utilizzato su intervalli di celle | tutti |
Manipolazione delle stringhe
Identificazione della stringa
Le stringhe sono identificate nelle espressioni con doppi chevron di apertura/chiusura (così come le etichette).
Nell'esempio seguente, "TEXT" è riconosciuto come una stringa: <<TEXT>>
Concatenazione di stringhe
Le stringhe possono essere concatenate utilizzando il segno '+'.
L'esempio seguente <<MY>> + <<TEXT>>
sarà concatenato a "MYTEXT".
Conversione di stringhe
I valori numerici possono essere convertiti in stringhe con la funzione str
:
str(Box.Length.Value)
Formattazione della stringa
La formattazione delle stringhe è supportata utilizzando il (vecchio) stile Python col %.
Tutti gli %-specifiers come definiti nella documentazione di Python.
Ad esempio, supponendo di avere un cubo predefinito di 10 mm di lato denominato 'Box' (denominazione predefinita di FreeCAD), la seguente espressione <<Cube length : %s>> % Box.Length
si espanderà in "Cube length: 10,0 mm"
Per più di uno specificatore % utilizzare la seguente sintassi: <<La lunghezza del cubo è %s e la larghezza è %s>> % tuple(Box.Length; Box.Width)
. Oppure usa la concatenazione: <<La lunghezza del cubo è %s>> % Box.Length + << e la larghezza è %s>> % Box.Width
. Entrambi si espandono in "La lunghezza del cubo è 10,0 mm e la larghezza è 10,0 mm".
È disponibile un file di esempio di FreeCAD che utilizza la formattazione delle stringhe nel forum
Funzioni per la creazione di oggetti
I seguenti oggetti possono essere creati nelle espressioni utilizzando le seguenti funzioni:
Tipo | Funzione | Descrizione |
---|---|---|
Tuple
|
tuple(a; b; ...)
|
Esempio: tuple(2; 1; 2)
|
List
|
list(a; b; ...)
|
Esempio: list(2; 1; 2)
|
Vector
|
vector(x; y; z)
|
Crea un vettore senza unità o utilizzando tre valori con unità di Lunghezza .
Esempio: |
create(<<vector>>; x; y; z)
| ||
Matrix
|
matrix( a11; a12; a13; a14; a21; a22; a23; a24; a31; a32; a33; a34; a41; a42; a43; a44 ) |
Crea una matrice 4x4 ordinata per riga:
È possibile fornire un minimo di 1 argomento come Esempio: |
create(<<matrix>>; a11; a12; ...; a44)
| ||
Rotation
|
rotation(axis; angle)
|
Crea una Rotation specificando il suo axis (Vector ) e angle (Angle senza unità o con unità), o i tre angoli di Eulero α , β , γ .
Esempi:
|
rotation(α; β; γ)
| ||
create(<<rotation>>; axis; angle)
| ||
create(<<rotation>>; α; β; γ)
| ||
Placement
|
placement(base; rotation)
|
Crea un Placement con vari parametri, inclusi:
Esempi:
|
placement(base; rotation; center)
| ||
placement(base; axis; angle)
| ||
placement(matrix)
| ||
create(<<placement>>; ...)
|
Funzioni vettoriali
Funzioni: disponibile dalla versione 1.0.
Funzione / Operatore | Descrizzione |
---|---|
v1 + v2
|
Somma vettoriale. |
v1 - v2
|
Sottrazione vettoriale. |
v * s
|
Prodotto scalare per s .
|
vangle(v1; v2)
|
Angolo tra due vettori in gradi. |
vcross(v1; v2)
|
Prodotto vettoriale tra due vettori . |
v1 * v2
|
Prodotto scalare tra due vettori . |
vdot(v1; v2)
| |
vlinedist(v1; v2; v3)
|
Distanza tra v1 e una linea attraverso v2 in direzione di v3 .
|
vlinesegdist(v1; v2; v3)
|
Distanza tra il vettore v1 e il punto più vicino su un segmento di linea da v2 a v3 .
|
vlineproj(v1; v2; v3)
|
Proiezione di un vettore v1 su una linea attraverso v2 in direzione v3 .
|
vnormalize(v)
|
Normalizza un vettore in un vettore unitario. |
vplanedist(v1)
|
Distanza tra il vettore v1 e un piano definito da un punto v2 e una normale v3 .
|
vplaneproj(v1)
|
Proietta il vettore v1 su un piano definito da un punto v2 e una normale v3 .
|
vscale(v; sx; sy; sz)
|
Ridimensiona in modo non uniforme un vettore di sx nella direzione X, sy nella direzione Y e sz nella direzione Z.
|
vscalex(v; sx)
| |
vscaley(v; sy)
| |
vscalez(v; sz)
|
Funzioni matriciali
Rotation
e Placement
possono essere rappresentati ciascuno da una Matrix
. Le seguenti funzioni accettano tutte Matrix
, Rotation
o Placement
come primo parametro indicato nella tabella seguente da m
. Il tipo dell'oggetto restituito è lo stesso dell'oggetto fornito nel primo argomento tranne quando si utilizza mtranslate
su Rotation
, nel qual caso sarà restituito Placement
.
Funzione | Descrizione |
---|---|
minvert(m)
|
Calcola la Matrice inversa. |
mrotate(m; rotation)
|
Rotazione con:
|
mrotate(m; axis; angle)
| |
mrotate(m; α; β; γ)
| |
mrotatex(m; angle)
|
Rotazione attorno all'asse X. |
mrotatey(m; angle)
|
Rotazione attorno all'asse Y. |
mrotatez(m; angle)
|
Rotazione attorno all'asse Z. |
mtranslate(m; vector)
|
Traslazione con un vector (Vector ) o con i valori X, Y, Z. Se una Rotazione è anche traslata, l'oggetto restituito è un Placement .
|
mtranslate(m; x; y; z)
| |
mscale(m; vector)
|
Scala per un vector (Vector ) o per i valori X, Y, Z.
|
mscale(m; x; y; z)
|
Espressioni condizionali
Le espressioni condizionali hanno la forma condition ? resultTrue : resultFalse
. La condizione è definita come un'espressione che restituisce 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 si ha una variabile il cui nome è quello di un'unità di misura, si deve inserire la variabile tra << >>
per evitare che venga riconosciuta come un'unità di misura. Ad esempio, la dimensione Sketch.Constraints.A
verrebbe riconosciuta come l'unità ampere. Quindi è necessario scriverla nell'espressione come Sketch.Constraints.<<A>>
.
Il parser delle espressioni riconosce le seguenti unità:
Quantità di sostanza
Unità | Descrizione |
---|---|
mmol | Millimole |
mol | Mole |
Angolo
Unità | Descrizione |
---|---|
° | Grado; alternativa all'unità deg |
deg | Grado; alternativa all'unità ° |
rad | Radiante |
gon | Grado centesimale |
S | Secondo di arco; alternativa all'unità ″ |
″ | Secondo di arco; alternativa all'unità S |
M | Minuto di arco; alternativa all'unità ′ |
′ | Minuto di arco; alternativa all'unità M |
Corrente
Unità | Descrizione |
---|---|
mA | Milliampere |
A | ampere |
kA | Kiloampere |
MA | Megaampere |
Capacità elettrica
Unità | Descrizione |
---|---|
pF | Picofarad |
nF | Nanofarad |
uF | Microfarad; alternativa all'unità µF |
µF | Microfarad; alternativa all'unità uF |
mF | Millifarad |
F | Farad; 1 F = 1 s^4·A^2/m^2/kg |
Carica elettrica
Unità | Descrizione |
---|---|
C | coulomb; 1 C = 1 A*s |
Conducibilità elettrica
Unità | Descrizione |
---|---|
uS | Microsiemens; alternative to the unit µS |
µS | Microsiemens; alternative to the unit uS |
mS | Millisiemens |
S | siemens; 1 S = 1 s^3·A^2/kg/m^2 |
kS | Kilosiemens |
MS | Megasiemens |
Induttanza elettrica
Unità | Descrizione |
---|---|
nH | Nanohenry |
uH | Microhenry; alternativa all'unità µH |
µH | Microhenry; alternativa all'unità uH |
mH | Millihenry |
H | henry; 1 H = 1 kg·m^2/s^2/A^2 |
Potenziale elettrico
Unità | Descrizione |
---|---|
mV | Millivolt |
V | volt |
kV | Kilovolt |
Resistenza elettrica
Unità | Descrizione |
---|---|
ohm | ohm; 1 ohm = 1 kg·m^2/s^3/A^2 |
kohm | Kiloohm |
Mohm | Megaohm |
Energia/lavoro
Unità | Descrizione |
---|---|
mJ | Millijoule |
J | joule |
kJ | Kilojoule |
eV | Elettronvolt; 1 eV = 1.602176634e-19 J |
keV | Kiloelettronvolt |
MeV | Megaelettronvolt |
kWh | kilowattora; 1 kWh = 3.6e6 J |
Ws | Watt secondo; alternativa all'unità Joule |
VAs | volt-ampere-secondo; alternativa all'unità Joule |
CV | coulomb-volt; alternativa all'unità Joule |
cal | calorie; 1 cal = 4.184 J |
kcal | Kilocalorie |
Forza
Unità | Descrizione |
---|---|
mN | Millinewton |
N | newton |
kN | Kilonewton |
MN | Meganewton |
lbf | Libbra forza |
Lunghezza
Unità | Descrizione |
---|---|
nm | Nanometro |
um | Micrometro; alternativa all'unità µm |
µm | Micrometro; alternativa all'unità mu |
mm | Millimetro |
cm | Centimetro |
dm | Decimetro |
m | metro |
km | Kilometro |
mil | Thousandth of an inch; alternativa all'unità thou |
thou | Thousandth of an inch; alternativa all'unità mil |
in | Inch; alternativa all'unità " |
ft | Foot; alternativa all'unità ' |
' | Foot; alternativa all'unità ft |
yd | Yard |
mi | Mile |
Intensità luminosa
Unità | Descrizione |
---|---|
cd | candela |
Flusso magnetico
Unità | Descrizione |
---|---|
Wb | weber; 1 Wb = 1 kg*m^2/s^2/A |
Densità del flusso magnetico
Unità | Descrizione |
---|---|
G | gauss; 1 G = 1 e-4 T |
T | tesla; 1 T = 1 kg/s^2/A |
Massa
Unità | Descrizione |
---|---|
ug | Microgrammo; alternativa all'unità µg |
µg | Microgrammo; alternativa all'unità ug |
mg | Milligrammo |
g | grammo |
kg | Kilogrammo |
t | Tonnellata |
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 |
uTorr | Microtorr; alternativa all'unità µTorr |
µTorr | Microtorr; alternativa all'unità uTorr |
mTorr | Millitorr |
Torr | Torr; 1 Torr = 133.32 Pa |
psi | Libbra-forza per pollice quadrato; 1 psi = 6.895 kPa |
ksi | KiloLibbra-forza per pollice quadrato |
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 |
kHz | Kilohertz |
MHz | Megahertz |
GHz | Gigahertz |
THz | Terahertz |
Volume
Unità | Descrizione |
---|---|
ml | Millilitro |
l | litro |
cft | Cubicfoot (piede cubico) |
Unità imperiali speciali
Unità | Descrizione |
---|---|
mph | Miles per hour |
sqft | Square foot |
Unità non supportate
Le seguenti unità di uso comune non sono ancora supportate, per alcune viene fornita un'alternativa:
Unità | Descrizione | Alternativa |
---|---|---|
°C | Grado Celsius | [°C] + 273.15 K |
°F | Grado Fahrenheit; | ([°F] + 459.67) × 5/9 |
u | Unità di massa atomica; alternativa all'unità Da | 1.66053906660e-27 kg |
Da | dalton; alternativa all'unità u | 1.66053906660e-27 kg |
sr | steradiante | not directly |
lm | lumen | non direttamente |
lx | lux | non direttamente |
px | pixel | non direttamente |
Caratteri e nomi non validi
La funzionalità delle espressioni è molto potente, ma per raggiungere questo potere ha alcune limitazioni relative ad alcuni caratteri. Per ovviare a questo, FreeCAD offre la possibilità di utilizzare etichette e fare riferimento ad esse invece che ai nomi degli oggetti. Nelle etichette puoi usare quasi tutti i caratteri speciali.
Nei casi in cui non è possibile utilizzare un'etichetta, come il nome dei vincoli di uno schizzo, è necessario sapere quali caratteri non sono consentiti.
Etichette
Per le etichette non ci sono caratteri non validi, tuttavia è necessario eseguire l'escape di alcuni caratteri:
Caratteri | Descrizione |
---|---|
' , \ , "
|
È necessario inserire l'escape aggiungendogli \ .
|
Ad esempio, l'etichetta Sketch\002
deve essere referenziata come <<Sketch\\002>>
.
Nomi
Nomi di oggetti come dimensioni, schizzi, ecc. non devono avere i caratteri o le sequenze di caratteri elencati di seguito, perchè altrimenti il nome non è valido:
Caratteri / Sequenze di caratteri | Descrizione |
---|---|
+, -, *, /, ^, _, <, >, (, ), {, }, [, ], ., ,, = | Caratteri che sono operatori matematici o parte di costrutti matematici |
A, kA, mA, MA, J, K, ' , ft , °, and many more! | Caratteri e sequenze di caratteri che sono unità (vedere paragrafo Unità.) |
#, !, ?, §, $, %, &, :, ;, \, |, ~, ∆, ¿, e molti altri! | Caratteri usati come segnaposto o per attivare operazioni speciali |
pi, e | Costanti matematiche |
´, `, ' , " | Caratteri usati per gli accenti |
spazio | Uno spazio definisce la fine di un nome e pertanto non può essere utilizzato |
Ad esempio, è valido il seguente nome: <<Sketch>>.Constraints.T2üßµ@
. Mentre questi sono nomi non validi: <<Sketch>>.Constraints.test\result_2
(\r significa "ritorno a capo") o <<Sketch>>.Constraints.mol
(mol è un'unità).
Poiché i nomi più brevi (soprattutto se hanno solo uno o due caratteri) possono facilmente risultare in nomi non validi, prendere in considerazione l'utilizzo di nomi più lunghi e/o stabilire una convenzione di denominazione adeguata.
Alias di cella
Vedere Spreadsheet SetAlias.
Riferimento ai dati CAD
È possibile utilizzare i dati del modello stesso in un'espressione. Per fare riferimento a una proprietà utilizzare object_name.property
o <<object_label>>.property
, le etichette devono essere racchiuse tra <<
e {{incode|>>} }. Se si desidera utilizzare le etichette, queste devono essere univoche.
Tutti gli esempi successivi fanno riferimento all'oggetto con il suo nome, ma in tutti i casi è possibile utilizzare anche l'etichetta dell'oggetto.
Se la proprietà è un composto di campi, è possibile accedere ai singoli campi come object_name.property.field
.
Per fare riferimento agli oggetti dell'elenco utilizzare object_name.list[list_index]
. Se si vuole fare riferimento a un vincolo in uno schizzo, usare Sketch.Constraints[16]
. Se ci si trova nello stesso sketch è possibile ometterne il nome e usare semplicemente Constraints[16]
. Tenere presente che l'indice inizia con 0, pertanto è necessario fare riferimento a Constraint17 come Constraints[16]
.
Per fare riferimento all'oggetto stesso utilizzare la pseudo proprietà _self
: object_name._self
.
La tabella seguente mostra alcuni ulteriori esempi:
Dati CAD | Chiamata nell'espressione | Risultato |
---|---|---|
Lunghezza di un Box di Part | Box.Length
|
Lunghezza con unità (mm) |
Volume di un Box | Box.Shape.Volume
|
Volume in mm³ senza unità |
Tipo di Shape di un Box | Box.Shape.ShapeType
|
Stringa: Solid |
Etichetta di una Box | Box.Label
|
Stringa: Label |
Coordinata X del centro di massa di un Box | Box.Shape.CenterOfMass.x
|
Coordinata X in mm senza unità |
Coordinata X del Box placement | Box.Placement.Base.x
|
Coordinata X con l'unità (mm) |
Componente X dell'asse di rotazione del placement di un Box | Box.Placement.Rotation.Axis.x
|
Componente X del vettore unitario in mm senza unità |
Angolo di rotazione del placemente di un Box | Box.Placement.Rotation.Angle
|
Angolo di rotazione con unità (deg) |
Oggetto Full Box | Box._self
|
Oggetto del tipo <Part::PartFeature> |
Valore di un vincolo in uno schizzo | Constraints.Width
|
Valore numerico di un vincolo denominato Width nello sketch, se l'espressione è utilizzata nello sketch stesso.
|
Valore di un vincolo in uno schizzo | MySketch.Constraints.Width
|
Valore numerico di un vincolo denominato Width nello sketch, se l'espressione viene utilizzata all'esterno dello sketch.
|
Valore di un alias in uno Spreadsheet | Spreadsheet.Depth
|
Valore dell'alias Depth nel foglio di calcolo Spreadsheet
|
Valore di una proprietà locale | Length
|
Valore della proprietà DatiLength, ad esempio in un oggetto Pad, se l'espressione è utilizzata ad esempio in DatiLength2 nello stesso oggetto. |
Dipendenze cicliche
FreeCAD controlla le dipendenze in base alla relazione tra gli oggetti del documento, non alle proprietà. Ciò significa che non è possibile fornire dati a un oggetto ed eseguire query sullo stesso oggetto per ottenere risultati. Ad esempio, anche se non esistono dipendenze cicliche quando vengono considerate le proprietà stesse, potresti non avere un oggetto che ottiene le sue dimensioni da un foglio di calcolo e quindi visualizza il volume di quell'oggetto nello stesso foglio di calcolo. Si devono utilizzare due fogli di calcolo, uno per gestire il proprio modello e l'altro per i report.
Come soluzione alternativa è possibile visualizzare un intervallo di celle dal secondo foglio di calcolo nel primo (o viceversa) creando un associazione di celle con l'opzione Nascondi dipendenza dell'associazione.
Un altro modo per aggirare le dipendenze cicliche è nascondere il riferimento utilizzando la funzione href
o hiddenref
per le singole espressioni, ad esempio: href(Box.Length)
.
Tenere presente che entrambe le soluzioni alternative menzionate devono essere utilizzate con cautela e che non funzionano se le proprietà segnalate dipendono da dimensioni determinate dallo stesso foglio di calcolo.
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 Datilunghezza 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.
Naturalmente, dopo spetta all'utente il compito di caricare i documenti corrispondenti, quando si desidera cambiare qualcosa.
Problemi noti / attività rimanenti
- FreeCAD non dispone ancora di un gestore di espressioni integrato in cui tutte le espressioni in un documento sono elencate e possono essere create, cancellate, interrogate, ecc. Ma è disponibile un componente aggiuntivo: fcxref expression manager.
- I bug/ticket aperti per le espressioni possono essere trovati su GitHub.
- 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