Expressions/it

Other languages:

Descrizione

È possibile definire le proprietà utilizzando espressioni matematiche. Nella GUI, le caselle di selezione o i campi di input associati alle proprietà mostrano un'icona blu quando sono attivati. Facendo clic sull'icona o digitando il segno uguale = si apre l'editor delle espressioni per quella particolare proprietà. Se il campo di input mostra un pulsante ... invece di un'icona, l'editor delle espressioni può essere aperto facendo clic con il pulsante destro del mouse sulla proprietà e selezionando Expression... dal menu contestuale.

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.

Operatore	Descrizione
+	Addizione
-	Sottrazione
*	Multiplicazione
/	Divisione virgola mobile
%	Resto
^	Potenze

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

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

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

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

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: `vector(2; 1; 3)`
`Vector`	`create(<<vector>>; x; y; z)`
`Matrix`	matrix( a₁₁; a₁₂; a₁₃; a₁₄; a₂₁; a₂₂; a₂₃; a₂₄; a₃₁; a₃₂; a₃₃; a₃₄; a₄₁; a₄₂; a₄₃; a₄₄ )	Crea una matrice 4x4 ordinata per riga: ${\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}}$ È possibile fornire un minimo di 1 argomento come `matrix(1)` che crea una matrice identità. Esempio: `matrix(1; 2; 3; 4; 5; 6; 7; 8; 9; 10; 11; 12; 13; 14; 15; 16)`
`Matrix`	`create(<<matrix>>; a₁₁; a₁₂; ...; a₄₄)`
`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(vector(0; 1; 0); 45)` `create(<<rotation>>; 30; 30; 30)`
	`rotation(α; β; γ)`
	`create(<<rotation>>; axis; angle)`
	`create(<<rotation>>; α; β; γ)`
`Placement`	`placement(base; rotation)`	Crea un `Placement` con vari parametri, inclusi: `base`: posizione di base (`Vector`) `center`: posizione centrale (`Vector`) `rotation`: `Rotation` `axis`: asse di rotazione (`Vector`) `angle`: angolo di rotazione (senza unità o con unità `Angle`) `matrix`: `Matrix` Esempi: `placement(vector(2; 1; 3); rotation(vector(0; 0; 1); 45))` `create(<<placement>>; create(<<vector>>; 2; 1; 2); create(<<rotation>>; create(<<vector>>; 0; 1; 0); 45))`
	`placement(base; rotation; center)`
	`placement(base; axis; angle)`
	`placement(matrix)`
	`create(<<placement>>; ...)`

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 $v_{1}\times v_{2}$ .
`v1 * v2`	Prodotto scalare tra due vettori $v_{1}\cdot v_{2}$ .
`vdot(v1; v2)`	Prodotto scalare tra due vettori $v_{1}\cdot v_{2}$ .
`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)`

Funzione	Descrizione
`minvert(m)`	Calcola la Matrice inversa.
`mrotate(m; rotation)`	Rotazione con: una `Rotazione` un asse (`Vettore`) e un angolo (`Angolo` con unità o adimensionale) i tre angoli di Eulero `α`, `β`, `γ`
`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)`	Scala per un `vector` (`Vector`) o per i valori X, Y, Z.

Operatore	Descrizione
==	uguale
!=	diverso
>	maggiore
<	minore
>=	maggiore o uguale
<=	minore o uguale

Unità	Descrizione
°	Degree; alternativa all'unità deg
deg	Degree; alternativa all'unità °
rad	Radiante
gon	Gradianti
M	Minuto d'arco; alternativa all'unità ′
'	Minuto d'arco; questo è il simbolo primo (U+2032); alternativa all'unità M
S	Secondo d'arco; NON FUNZIONA; alternativa all'unità″
"	Secondo d'arco; questo è il simbolo del doppio primo (U+2033); alternativa all'unità S

Constante	Descrizione
e	Numero di Eulero
pi	Pi greco

Unità	Descrizione
mmol	Millimole
mol	Mole

Unità	Descrizione
mA	Milliampere
A	ampere
kA	Kiloampere
MA	Megaampere

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

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

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

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

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

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

Unità	Descrizione
W	watt
kW	Kilowatt, disponibile dalla versione 0.19
VA	volt-ampere

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

Unità	Descrizione
uK	Microkelvin; alternativa all'unità µK
µK	Microkelvin; alternativa all'unità uK
mK	Millikelvin
K	Kelvin

Unità	Descrizione
s	secondo
min	minuto
h	ora
Hz (1/s)	Hertz
kHz	Kilohertz
MHz	Megahertz
GHz	Gigahertz
THz	Terahertz

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

Expressions/it

Descrizione

Argomenti delle funzioni

Riferimenti a oggetti

Costanti supportate

Operatori supportati

Funzioni supportate

Funzioni matematiche generali

Funzioni trigonometriche

Funzioni esponenziali e logaritmiche

Funzioni di arrotondamento, troncamento e resto

Funzioni statistiche / aggregate

Manipolazione delle stringhe

Identificazione della stringa

Concatenazione di stringhe

Conversione di stringhe

Formattazione della stringa

Funzioni per la creazione di oggetti

Funzioni vettoriali

Funzioni matriciali

Espressioni condizionali

Unità

Quantità di sostanza

Angolo

Corrente

Capacità elettrica

Carica elettrica

Conducibilità elettrica

Induttanza elettrica

Potenziale elettrico

Resistenza elettrica

Energia/lavoro

Forza

Lunghezza

Intensità luminosa

Flusso magnetico

Densità del flusso magnetico

Massa

Potenza

Pressione

Temperatura

Tempo

Volume

Unità imperiali speciali

Unità non supportate

Caratteri e nomi non validi

Etichette

Nomi

Alias di cella

Riferimento ai dati CAD

Dipendenze cicliche

Variabili globali nell'ambito del documento

Riferimenti incrociati nel documento

Problemi noti / attività rimanenti

Script

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

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.