Expressions/it: Difference between revisions

From FreeCAD Documentation
(Created page with "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:")
(Created page with "{{incode|1/2mm}} non viene interpretato come mezzo millimetro ma come {{incode|1/(2mm)}}, risultante in: {{incode|0.5 mm^-1}}.")
Line 21: Line 21:
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:
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:


{{incode|1/2mm}} is not interpreted as half a millimeter but as {{incode|1/(2mm)}}, resulting in: {{incode|0.5 mm^-1}}.
{{incode|1/2mm}} non viene interpretato come mezzo millimetro ma come {{incode|1/(2mm)}}, risultante in: {{incode|0.5 mm^-1}}.


{{incode|sqrt(2)mm}} is not valid because the function call is not a number. This has to be entered as {{incode|sqrt(2) * 1mm}}.
{{incode|sqrt(2)mm}} is not valid because the function call is not a number. This has to be entered as {{incode|sqrt(2) * 1mm}}.

Revision as of 19:16, 22 May 2023

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 fornite. Ad esempio, 2mm + 4mm è un'espressione valida, mentre 2mm + 4 non lo è (il motivo di questo è che un'espressione come 1in + 4 molto probabilmente viene interpretata come 1in + 4in da un umano, ma tutte le unità vengono convertite nel sistema SI interno, e il sistema non è in grado di indovinare questo). Queste unità sono attualmente riconosciute.

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 is not valid because the function call is not a number. This has to be entered as 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 il vincolo 17 ha l'indice 16.

Per ulteriori informazioni sul riferimento a oggetti, vedere questa sezione.

Inizio

Costanti supportate

Sono supportate le seguenti costanti:

Sono supportate le seguenti costanti:

Constante Descrizione
e Numero di Eulero
pi Pi greco

Inizio

Supported operators

The following operators are supported:

Sono supportati i seguenti operatori:

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

Inizio

Funzioni supportate

Funzioni matematiche generali

The following mathematical functions are supported:

Trigonometric functions

Trigonometric functions use degree as their default unit. For radian measure, add rad following the first value in an expression. So e.g. cos(45) is the same as cos(pi rad / 4). Expressions in degrees can use either deg or °, e.g. 360deg - atan2(3; 4) or 360° - atan2(3; 4). If an expression is without units and needs to be converted to degrees or radians for compatibility, multiply by 1 deg, 1 ° or 1 rad as appropriate, e.g. (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

Exponential and logarithmic functions

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

Rounding, truncation and remainder functions

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

Inizio

Statistical / aggregate functions

Statistica e Funzioni di aggregazione

Le funzioni di aggregazione accettano uno o più argomenti, separati da un punto e virgola ';' o da una virgola e uno spazio ', '.
Gli argomenti possono includere riferimenti a celle di un foglio di calcolo. I riferimenti alla cella sono costituiti dalla lettera maiuscola seguita dal numero della colonna.
Gli argomenti possono includere intervalli di celle usando due riferimenti di cella separati da due punti, ad esempio average(B1:B8).

Individual arguments to aggregate functions may consist of ranges of cells. A range of cells is expressed as two cell references separated by a colon :, for example average(B1:B8) or sum(A1:A4; B1:B4). The cell references may also use cell aliases, for example average(StartTemp:EndTemp).

The following aggregate functions are supported:

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

Inizio

String manipulation

String identification

Strings are identified in expressions by surrounding them with opening/closing double chevrons (as are labels).

In following example, "TEXT" is recognized as a string : <<TEXT>>

String concatenation

Strings can be concatenated using the '+' sign.

Following example <<MY>> + <<TEXT>> will be concatenated to "MYTEXT".

String conversion

Numerical values can be converted to strings with the str function:

str(Box.Length.Value)

String formatting

String formatting is supported using the (old) %-style Python way.

All %-specifiers as defined in Python documentation.

As an example, supposing you have a default 10mm-side cube named 'Box' (default FreeCAD naming), 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

Inizio

Object creation functions

The following objects may be created in expressions using the following functions:

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: vector(2; 1; 3)

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 matrix(1) which creates an identity matrix.

Example: matrix(1; 2; 3; 4; 5; 6; 7; 8; 9; 10; 11; 12; 13; 14; 15; 16)

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(vector(0; 1; 0); 45)
  • create(<<rotation>>; 30; 30; 30)
rotation(α; β; γ)
create(<<rotation>>; axis; angle)
create(<<rotation>>; α; β; γ)
Placement placement(base; rotation) Create a Placement with various parameters, including:
  • base: base location (Vector)
  • center: center location (Vector)
  • rotation: Rotation
  • axis: Rotation axis (Vector)
  • angle: Rotation angle (unit-less or Angle unit value)
  • matrix: Matrix

Examples:

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

Inizio

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:
  • a Rotation
  • an axis (Vector) and an angle (Angle unit or unit-less)
  • three Euler angles α, β, γ
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)

Inizio

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

Inizio

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

Quantità di sostanza:

Unità Descrizione
mmol Millimole
mol Mole

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

Corrente:

Unità Descrizione
mA Milliampere
A Ampere
kA Kiloampere
MA Megaampere

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

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

Inizio

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.

Inizio

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.

Inizio

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.

Inizio

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.

Inizio

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

Inizio