Espressioni
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à.
Una espressione di FreeCAD è un'espressione matematica che segue la notazione per gli operatori matematici standard e le funzioni come descritto in seguito. Inoltre, l'espressione può fare riferimento ad altre proprietà, e anche utilizzare le condizioni. I numeri di un'espressione possono opzionalmente essere collegati ad una unità di misura.
I numeri possono usare una virgola ,
o un punto .
per separare le cifre intere dai decimali.
Quando viene utilizzato il separatore decimale, esso "deve" essere seguito da almeno una cifra.
Pertanto, le espressioni 1.+2.
e 1,+2,
non sono valide, ma 1.0 + 2.0
e 1,0 + 2,0
sono valide.
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
Si può fare riferimento a un oggetto tramite il suo DatiName o 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 <<Long_name_of_cylinder>>.Height
. Per fare riferimento all'oggetto stesso si usa la pseudo proprietà _self
. Ad esempio, puoi utilizzare Cylinder._self
o <<Label_of_cylinder>>._self
.
Per fare riferimento agli oggetti dell'elenco, usa <<object_label>>.list[list_index]
o object_name.list[list_index]
. Se ad esempio si desidera fare riferimento a un vincolo in uno schizzo, lo si può fare usando <<MySketch>>.Constraints[16]
. Se il riferimento si trova nello stesso schizzo, si può ometterne il nome e utilizzare solo Constraints[16]
.
Nota: L'indice inizia con 0, quindi Constraint17 deve essere referenziato come Constraints[16]
.
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 la misura in radianti, aggiungi 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 1 deg
, 1 °
o 1 rad
in modo appropriato, ad es. (360 - X) * 1deg
; (360 - X) * 1°
; (0.5 + pi / 2) * 1rad
.
Le funzioni trigonometriche usano i gradi come unità predefinita. Per le misure in radianti aggiungere rad dopo il primo valore in una espressione. Per esempio cos(45) è la stessa cosa di cos(pi rad / 4). Se un'espressione è senza unità e per compatibilità deve essere convertita in gradi o radianti,, moltiplicare per 1 deg, 1 ° o 1 rad secondo il caso, ad es. (360 - X) * 1deg; (360 - X) * 1°; (0.5 + pi / 2) * 1rad.
Sono supportate le seguenti funzioni trigonometriche:
Funzione | Descrizione | Intervallo di valori |
---|---|---|
acos(x) | Arc cosine | -1 <= x <= 1 |
asin(x) | Arc sine | -1 <= x <= 1 |
atan(x) | Arc tangent | tutti |
atan2(x, y) | Arc tangent of x/y | tutti, eccetto y = 0 |
cos(x) | Cosine | tutti |
cosh(x) | Hyperbolic cosine | tutti |
sin(x) | Sine | tutti |
sinh(x) | Hyperbolic sine | tutti |
tan(x) | Tangent | tutti, eccetto x = n·90 con n = intero |
tanh(x) | Hyperbolic tangent | tutti |
Funzioni esponenziali e logaritmiche
Per esponenziazione e logaritmizzazione sono supportate le seguenti funzioni:
Funzione | Descrizione | Intervallo di valori |
---|---|---|
exp(x) | Exponential function | tutti |
log(x) | Natural logarithm | x > 0 |
log10(x) | Common logarithm | x > 0 |
pow(x, y) | Exponentiation | all |
sqrt(x) | Square root | x >= 0 |
Funzioni di arrotondamento, troncamento e resto
Per arrotondamento, troncamento e resto sono supportate queste funzioni :
Funzione | Descrizione | Intervallo di valori |
---|---|---|
abs(x) | Valore assoluto | tutti |
ceil(x) | Parte intera superiore valore intero più piccolo maggiore o uguale a x | tutti |
floor(x) | Parte intera inferiore, valore intero più grande minore o uguale a x | tutti |
mod(x, y) | Resto dopo aver diviso x per y | tutti, eccetto y = 0 |
round(x) | Arrotondamento al numero intero più vicino | tutti |
trunc(x) | Troncamento al numero intero più vicino | tutti |
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:
Sono supportate queste funzioni aggregate :
Funzione | Descrizione | Intervallo di valori |
---|---|---|
average(x:y) | Media aritmetica dei valori nelle celle da x a y; sum(x:y) / count(x:y) | tutti |
count(x:y) | Conteggio di celle da x a y | tutti |
max(x:y) | Massimo valore nelle celle da x a y | tutti |
min(x:y) | Minimo valore nelle celle da x a y | tutti |
stddev(x:y) | Deviazione standard dei valori nelle celle da x a y | tutti |
sum(x: y) | Somma dei valori nelle celle da x a y | tutti |
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 '+'.
Following example <<MY>> + <<TEXT>>
will be concatenated to "MYTEXT".
Conversione di stringhe
Numerical values can be converted to strings with the str
function:
str(Box.Length.Value)
Formattazione della stringa
String formatting is supported using the (old) %-style Python way.
All %-specifiers as defined in Python documentation.
As an example, supposing you have a default 10mm-side cube named 'Box' (default FreeCAD naming), the following expression <<Cube length : %s>> % Box.Length
will expand to "Cube length : 10.0 mm"
For more than one %-specifier use the following syntax: <<Cube length is %s and width is %s>> % tuple(Box.Length; Box.Width)
. Or use concatenation: <<Cube length is %s>> % Box.Length + << and width is %s>> % Box.Width
. Both will expand to "Cube length is 10.0 mm and width is 10.0 mm".
A FreeCAD sample file using string formatting is available in the forum
Funzioni per la creazione di oggetti
I seguenti oggetti possono essere creati nelle espressioni utilizzando le seguenti funzioni:
Type | Function | Description |
---|---|---|
Tuple
|
tuple(a; b; ...)
|
Example: tuple(2; 1; 2)
|
List
|
list(a; b; ...)
|
Example: list(2; 1; 2)
|
Vector
|
vector(x; y; z)
|
Create a vector using three unit-less or Length unit values.
Example: |
create(<<vector>>; x; y; z)
| ||
Matrix
|
matrix( a11; a12; a13; a14; a21; a22; a23; a24; a31; a32; a33; a34; a41; a42; a43; a44 ) |
Create a 4x4 matrix in row-major order:
A minimum of 1 argument can be supplied such as Example: |
create(<<matrix>>; a11; a12; ...; a44)
| ||
Rotation
|
rotation(axis; angle)
|
Create a Rotation by specifying its axis (Vector ) and angle (Angle unit or unit-less), or three Euler angles α , β , γ .
Examples:
|
rotation(α; β; γ)
| ||
create(<<rotation>>; axis; angle)
| ||
create(<<rotation>>; α; β; γ)
| ||
Placement
|
placement(base; rotation)
|
Create a Placement with various parameters, including:
Examples:
|
placement(base; rotation; center)
| ||
placement(base; axis; angle)
| ||
placement(matrix)
| ||
create(<<placement>>; ...)
|
Matrix functions
Rotation
and Placement
can each be represented by a Matrix
. The following functions all take in a Matrix
, Rotation
, or Placement
as their first parameter denoted in the table below by m
. The type of the returned object is the same as the object supplied in the first argument except when using mtranslate
on a Rotation
, in which case a Placement
will be returned.
Function | Description |
---|---|
minvert(m)
|
Calculate the Inverse matrix. |
mrotate(m; rotation)
|
Rotate by either:
|
mrotate(m; axis; angle)
| |
mrotate(m; α; β; γ)
| |
mrotatex(m; angle)
|
Rotate around the X axis. |
mrotatey(m; angle)
|
Rotate around the Y axis. |
mrotatez(m; angle)
|
Rotate around the Z axis. |
mtranslate(m; vector)
|
Translate by a vector (Vector ) or X, Y, Z values. If a Rotation is translated, the returned object is a Placement .
|
mtranslate(m; x; y; z)
| |
mscale(m; vector)
|
Scale by a vector (Vector ) or X, Y, Z values.
|
mscale(m; x; y; z)
|
Espressioni condizionali
Le espressioni condizionali sono nella forma condition ? resultTrue : resultFalse. La condizione è definita come un'espressione il cui risultato è '0' (falso) o diverso da zero (vero). Notare che racchiudere l'espressione condizionale tra parentesi è attualmente considerato un errore. versione 0.19 e precedenti
Sono definiti i seguenti operatori relazionali:
Operatore | Descrizione |
---|---|
== | uguale |
!= | diverso |
> | maggiore |
< | minore |
>= | maggiore o uguale |
<= | minore o uguale |
Unità
Le unità possono essere utilizzate direttamente nelle espressioni. Il parser le collega al valore precedente. Quindi '2mm' o '2 mm' è valido mentre 'mm' non è valido perché non esiste un valore precedente.
Tutti i valori devono avere un'unità. Pertanto, in generale è necessario utilizzare un'unità per i valori nei fogli di calcolo.
In alcuni casi funziona anche senza un'unità, ad esempio se nella cella B1 del foglio di calcolo si ha solo il numero 1,5 e si fa riferimento ad esso per l'altezza del pad. Questo funziona perché l'altezza del pad predispone l'unità mm che viene utilizzata quando non viene fornita alcuna unità. Però fallisce se si utilizza per l'altezza del pad, ad es. Sketch1.Constraints.Width - Spreadsheet.B1 perché Sketch1.Constraints.Width ha un'unità e Spreadsheet.B1 no.
Le unità con esponenti possono essere inserite direttamente. Quindi ad es. mm^3 viene riconosciuto come mm³ e m^3 viene riconosciuto come m³.
Se una variabile ha il nome di un'unità di misura, bisogna inserire la variabile in << >> per impedire che venga riconosciuta come unità di misura. Ad esempio, la dimensione 'Sketch.Constraints.A' verrebbe riconosciuta come unità Ampere. Pertanto è necessario scriverla nell'espressione in questo modo 'Sketch.Constraints.<<A>>'.
Il parser delle espressioni riconosce le seguenti unità:
Amount of substance
Angle
Angolo:
Unità | Descrizione |
---|---|
° | Grado; alternativa all'unità deg |
deg | Grado; alternativa all'unità ° |
rad | Radiante |
gon | Gradiante |
S | Secondo di arco |
″ | Secondo di arco; alternativa all'unità S |
M | Minuto di arco |
′ | Minuto di arco; alternativa all'unità M |
Current
Electric capacitance
Unit | Description |
---|---|
pF | Picofarad |
nF | Nanofarad |
uF | Microfarad; alternative to the unit µF |
µF | Microfarad; alternative to the unit uF |
mF | Millifarad |
F | Farad; 1 F = 1 s^4·A^2/m^2/kg |
Electric charge
Unit | Description |
---|---|
C | Coulomb; 1 C = 1 A*s |
Electric conductivity
Unit | Description |
---|---|
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 |
Electric inductance
Unit | Description |
---|---|
nH | Nanohenry |
uH | Microhenry; alternative to the unit µH |
µH | Microhenry; alternative to the unit uH |
mH | Millihenry |
H | Henry; 1 H = 1 kg·m^2/s^2/A^2 |
Electric potential
Unit | Description |
---|---|
mV | Millivolt |
V | Volt |
kV | Kilovolt |
Electric resistance
Unit | Description |
---|---|
Ohm | Ohm; 1 Ohm = 1 kg·m^2/s^3/A^2 |
kOhm | Kiloohm |
MOhm | Megaohm |
Energy/work
Energia / Lavoro:
Unità | Descrizione |
---|---|
mJ | Millijoule |
J | Joule |
kJ | Kilojoule, disponibile dalla versione 0.19 |
eV | Elettronvolt; 1 ev = 1.602176634e-19 J, disponibile dalla versione 0.19 |
keV | Kiloelettronvolt, disponibile dalla versione 0.19 |
MeV | Megaelettronvolt, disponibile dalla versione 0.19 |
kWh | Kilowattora; 1 kWh = 3.6e6 J, disponibile dalla versione 0.19 |
Ws | Watt second; alternativa all'unità Joule |
VAs | Volt-ampere-second; alternativa all'unità Joule |
CV | Coulomb-volt; alternativa all'unità Joule |
cal | Calorie; 1 cal = 4.184 J, disponibile dalla versione 0.19 |
kcal | Kilocalorie, disponibile dalla versione 0.19 |
Force
Forza:
Unità | Descrizione |
---|---|
mN | Millinewton |
N | Newton |
kN | Kilonewton |
MN | Meganewton |
lbf | Pound of force |
Length
Lunghezza:
Unità | Descrizione |
---|---|
nm | Nanometer |
um | Micrometer; alternativa all'unità µm |
µm | Micrometer; alternativa all'unità mu |
mm | Millimeter |
cm | Centimeter |
mm | Millimeter |
dm | Decimeter |
m | Meter |
km | Kilometer |
mil | Thousandth of an inch; alternativa all'unità thou |
thou | Thousandth of an inch; alternativa all'unità mil |
in | Inch |
ft | Foot; alternativa all'unità ' |
' | Foot; alternativa all'unità ft |
yd | Yard |
mi | Mile |
Luminous intensity
Intensità luminosa:
Unità | Descrizione |
---|---|
cd | Candela |
Magnetic flux
Unit | Description |
---|---|
Wb | Weber; 1 Wb = 1 kg*m^2/s^2/A |
Magnetic flux density
Unit | Description |
---|---|
G | Gauss; 1 G = 1 e-4 T |
T | Tesla; 1 T = 1 kg/s^2/A |
Mass
Massa:
Unità | Descrizione |
---|---|
ug | Microgram; alternativa all'unità µg |
µg | Microgram; alternativa all'unità ug |
mg | Milligram |
g | Gram |
kg | Kilogram |
t | Tonne |
oz | Ounce |
lb | Pound; alternativa all'unità lbm |
lbm | Pound; alternativa all'unità lb |
st | Stone |
cwt | Hundredweight |
Power
Potenza:
Unità | Descrizione |
---|---|
W | Watt |
kW | Kilowatt, disponibile dalla versione 0.19 |
VA | Volt-ampere |
Pressure
Pressione:
Unità | Descrizione |
---|---|
Pa | pascal |
kPa | Kilopascal |
MPa | Megapascal |
GPa | Gigapascal |
mbar | Millibar, disponibile dalla versione 0.19 |
bar | bar, disponibile dalla versione 0.19 |
uTorr | Microtorr; alternativa all'unità µTorr |
µTorr | Microtorr; alternativa all'unità uTorr |
mTorr | Millitorr |
Torr | torr; 1 Torr = 133.32 Pa |
psi | libbre per pollice quadrato; 1 psi = 6.895 kPa |
ksi | Kilolibbre per pollice quadrato |
Mpsi | Megalibbre per pollice quadrato, disponibile dalla versione 0.19 |
Temperature
Temperatura:
Unità | Descrizione |
---|---|
uK | Microkelvin; alternativa all'unità µK |
µK | Microkelvin; alternativa all'unità uK |
mK | Millikelvin |
K | Kelvin |
Time
Tempo:
Unità | Descrizione |
---|---|
s | secondo |
min | minuto |
h | ora |
Hz (1/s) | Hertz, disponibile dalla versione 0.19 |
kHz | Kilohertz, disponibile dalla versione 0.19 |
MHz | Megahertz, disponibile dalla versione 0.19 |
GHz | Gigahertz, disponibile dalla versione 0.19 |
THz | Terahertz, disponibile dalla versione 0.19 |
Volume
Volume:
Unità | Descrizione |
---|---|
ml | Millilitro, disponibile dalla versione 0.19 |
l | litro |
cft | Cubicfoot (piede cubico), disponibile dalla versione 0.19 |
Special imperial units
Unit | Description |
---|---|
mph | Miles per hour |
sqft | Square foot |
Unsupported units
The following commonly used units are not yet supported, for some an alternative is provided:
Le seguenti unità comunemente utilizzate non sono ancora supportate:
Unità | Descrizione | Alternativa |
---|---|---|
°C | Celsius | [°C] + 273.15 K |
°F | Fahrenheit; | ([°F] + 459.67) × 5/9 |
u | Atomic mass unit; alternative to the unit 'Da' | 1.66053906660e-27 kg |
Da | Dalton; alternative to the unit 'u' | 1.66053906660e-27 kg |
sr | Steradian | not directly |
lm | Lumen | not directly |
lx | Lux | not directly |
px | Pixel | not directly |
Invalid characters and names
The expression feature is very powerful but to achieve this power it has some limitations concerning some characters. To overcome this, FreeCAD offers to use labels and reference them instead of the object names. In labels you can use almost all special characters.
In cases where you cannot use a label, such as the name of a sketch's constraints, you must be aware what characters are not allowed.
Labels
For labels there are no invalid characters, however some characters need to be escaped:
Characters | Description |
---|---|
' , \ , "
|
Need to be escaped by adding \ in front of them.
|
For example, the label Sketch\002
must be referenced as <<Sketch\\002>>
.
Names
Names of objects like dimensions, sketches, etc. may not have the characters or character sequences listed below, otherwise the name is invalid:
Characters / Character sequences | Description |
---|---|
+, -, *, /, ^, _, <, >, (, ), {, }, [, ], ., ,, = | Characters that are math operators or part of mathematical constructs |
A, kA, mA, MA, J, K, ' , ft , °, and many more! | Characters and character sequences that are units (see the Units paragraph) |
#, !, ?, §, $, %, &, :, ;, \, |, ~, ∆, ¿, and many more! | Characters used as placeholder or to trigger special operations |
pi, e | Mathematical constants |
´, `, ' , " | Characters used for accents |
space | A space defines the end of a name and can therefore not be used |
For example, the following name is valid: <<Sketch>>.Constraints.T2üßµ@
. While these are invalid names: <<Sketch>>.Constraints.test\result_2
(\r means "carriage return") or <<Sketch>>.Constraints.mol
(mol is a unit).
Since shorter names (especially if they have only one or two characters) can easily result in invalid names, consider using longer names and/or establishing a suitable naming convention.
Cell aliases
See Spreadsheet SetAlias.
Riferimento ai dati CAD
In un'espressione è possibile utilizzare i dati del modello stesso. Per fare riferimento a una proprietà usare object.property. Se la proprietà è un composto di campi, è possibile accedere ai singoli campi come object.property.field.
La tabella seguente mostra alcuni esempi:
Dati CAD | Chiamata nell'espressione | Risultato |
---|---|---|
Lunghezza parametrica di un Cubo di Parte | Cube.Length
|
Length Lunghezza con unità in mm
|
Volume del Cubo | Cube.Shape.Volume
|
Volume in mm³ senza unità
|
Tipo di forma del Cubo | Cube.Shape.ShapeType
|
Stringa: Solid |
Etichetta del Cubo | Cube.Label
|
Stringa: Label |
Coordinata x del centro di massa del Cubo | Cube.Shape.CenterOfMass.x
|
Coordinata x in mm senza unità |
Valore di un vincolo in uno schizzo | Constraints.Width
|
Valore numerico del vincolo di nome 'Width ' nello schizzo, se l'espressione è utilizzata nello schizzo stesso.
|
Valore di un vincolo in uno schizzo | MySketch.Constraints.Width
|
Valore numerico del vincolo di nome 'Width ' nello schizzo, se l'espressione è usata al di fuori dello schizzo.
|
Valore di un alias in spreadsheet | Spreadsheet.Depth
|
Valore dell'alias "Depth " nel foglio "Spreadsheet "
|
Valore di una proprietà locale | Length
|
Valore della proprietà Length ad es. di un oggetto Pad, se l'espressione viene utilizzata, ad esempio, in Length2 nello stesso oggetto.
|
Variabili globali nell'ambito del documento
Al momento in FreeCAD non esiste il concetto di variabili globali. Invece, utilizzando l'ambiente Spreadsheet, si possono definire delle variabili arbitrarie come celle in un foglio di calcolo, e poi assegnare loro un nome utilizzando la proprietà alias della cella (tasto destro del mouse sulla cella). Dopo si può accedere alla variabile da qualsiasi espressione, come per qualsiasi altra proprietà di un oggetto.
Riferimenti incrociati nel documento
È possibile (con limitazioni) definire una proprietà di un oggetto nel documento corrente (file ".FCstd") utilizzando un'espressione per fare riferimento a una proprietà di un oggetto contenuto in un documento diverso (file ".FCstd"). Ad esempio, una cella in un foglio di calcolo o la lunghezza di un cubo di Part, ecc. in un documento può essere definita da un'espressione che fa riferimento al valore di posizionamento X o ad un'altra proprietà di un oggetto contenuto in un documento diverso.
È possibile utilizzare il nome di un documento per fare riferimento ad esso da altri documenti. Quando si salva un documento per la prima volta, si sceglie un nome per il file; questo di solito è diverso dal default iniziale "Unnamed1" (o il suo equivalente tradotto). Per evitare la perdita dei collegamenti quando il documento master viene rinominato al momento del salvataggio, si consiglia di creare prima il documento master, creare un foglio di calcolo al suo interno e salvarlo. Successivamente è ancora possibile apportare modifiche e salvare il file, ma non si deve rinominarlo.
Una volta creato e salvato (e denominato) il documento master con il foglio di calcolo, è possibile creare dei documenti dipendenti. Supponendo che il documento master sia stato denominato "master
", il foglio di calcolo sia stato rinominato "modelConstants
" e a una cella sia stato assegnato un nome alias "Length
", si può quindi accedere al valore con:
master#modelConstants.Length
Notare che il documento master deve sempre essere caricato affinché i valori del master siano disponibili per il documento dipendente.
Purtroppo, il checker integrato a volte afferma che un nome valido non esiste. Continuare comunque a digitare. Quando il riferimento è completato, il pulsante OK diventa attivo.
Naturalmente, dopo spetta all'utente il compito di caricare i documenti corrispondenti, quando si desidera cambiare qualcosa.
Problemi noti / attività rimanenti
- I grafici delle dipendenze si basano sul rapporto tra gli oggetti del documento, non sulle proprietà. Questo significa che non è possibile fornire i dati a un oggetto e interrogare lo stesso oggetto per i risultati. Ad esempio, anche se non ci sono dipendenze cicliche quando vengono considerate solo le proprietà, non si può avere un oggetto che ottiene le sue dimensioni da un foglio di calcolo e quindi visualizza il volume di tale oggetto nello stesso foglio di calcolo. Per aggirare il problema, utilizzare più fogli di calcolo, ad esempio uno per sviluppare il modello, e uno per i rapporti.
- Il parser delle espressioni non gestisce bene le parentesi e non è in grado di analizzare correttamente alcune espressioni. Ad esempio: "= (A1 > A2) ? 1 : 0" restituisce un errore, mentre "= A1 > A2 ? 1 : 0" è accettato. L'espressione "= 5 + ((A1>A2) ? 1 : 0)" non può essere inserita in nessuna forma.
- Come affermato sopra, sfortunatamente, a volte il controllo integrato afferma che non esiste un nome valido. Continuare comunque a digitare. Dopo aver completato il riferimento completo, il pulsante OK diventerà attivo.
- Non è implementato nessun gestore delle espressioni in cui siano elencate tutte le espressioni di un documento, e possano essere create, eliminate, interrogate, ecc.
- I nomi dei vincoli di Sketcher non devono contenere spazi vuoti quando il valore è calcolato da un'espressione, vedere questa discussione nel forum.
- I bug aperti per le espressioni si trovano in FreeCAD Bugtracker Expressions category
- FreeCAD scripting: Python, Introduction to Python, Python scripting tutorial, FreeCAD Scripting Basics
- Modules: Builtin modules, Units, Quantity
- Workbenches: Workbench creation, Gui Commands, Commands, Installing more workbenches
- Meshes and Parts: Mesh Scripting, Topological data scripting, Mesh to Part, PythonOCC
- Parametric objects: Scripted objects, Viewproviders (Custom icon in tree view)
- Scenegraph: Coin (Inventor) scenegraph, Pivy
- Graphical interface: Interface creation, Interface creation completely in Python (1, 2, 3, 4, 5), PySide, PySide examples beginner, intermediate, advanced
- Macros: Macros, How to install macros
- Embedding: Embedding FreeCAD, Embedding FreeCADGui
- Other: Expressions, Code snippets, Line drawing function, FreeCAD vector math library (deprecated)
- Hubs: User hub, Power users hub, Developer hub