Expressions/fr: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Created page with "Notez que le document maître doit être chargé pour que les valeurs de ce dernier soient disponibles pour le document dépendant.")
(49 intermediate revisions by the same user not shown)
Line 7: Line 7:
Il est maintenant possible de définir des propriétés utilisant des expressions mathématiques. Dans l'interface graphique, les boîtes de dialogues numériques et les champs de saisie qui sont liés à des propriétés contiennent une icône bleue [[Image:Sketcher_Expressions.png|24px]]. En cliquant sur l'icône, ou en tapant le signe égal (=) comme dans un tableur, on fait apparaître l'éditeur d'expression pour cette propriété spécifique.
Il est maintenant possible de définir des propriétés utilisant des expressions mathématiques. Dans l'interface graphique, les boîtes de dialogues numériques et les champs de saisie qui sont liés à des propriétés contiennent une icône bleue [[Image:Sketcher_Expressions.png|24px]]. En cliquant sur l'icône, ou en tapant le signe égal (=) comme dans un tableur, on fait apparaître l'éditeur d'expression pour cette propriété spécifique.


Une expression FreeCAD est une expression mathématique qui suit la notation pour les opérateurs mathématiques standard et fonctionne comme décrit ci-dessous. En outre, l'expression peut faire référence à d'autres propriétés et également utiliser des conditions. Une unité facultative peut être attachée aux nombres d'une expression.
<div class="mw-translate-fuzzy">
Une expression FreeCAD est une expression mathématique, suivant la notation normale des opérateurs mathématiques standard (+, -, * et /) et fonctionne comme décrit ci-dessous. En outre, l'expression peut faire référence à d'autres propriétés, et utiliser également des conditions. Les nombres dans une expression peuvent avoir une unité optionnelle attachée à celle-ci.
</div>


Numbers may use either a comma ',' or a decimal point '.' separating whole digits from decimals.
Les nombres peuvent utiliser une virgule ',' ou un point décimal '.' séparer les chiffres entiers des décimales.
Lorsque le marqueur décimal est utilisé, il doit obligatoirement être suivi d'au moins un chiffre.
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.
Ainsi, les expressions '''1.+2.''' et '''1,+2,''' ne sont pas valides, mais '''1.0+2.0''' et '''1,0+2,0''' sont valables.


The constants ''pi'' and ''e'' are predefined, and must be written in lowercase.
Les constantes ''pi'' et ''e'' sont prédéfinies et doivent être écrites en minuscules.


Les opérateurs et fonctions reconnaissent les unités de mesure et nécessitent des combinaisons valides si elles sont fournies. Par exemple, 2mm + 4mm est une expression valide, tandis que 2mm + 4 ne l'est pas (la raison est qu'une expression comme 1in + 4 sera très probablement interprété comme 1in + 4in par le dessinateur mais comme toutes les unités en interne sont converties au système international SI, et le système est totalement incapable de deviner de quelle unité il s'agit).
Les opérateurs et fonctions reconnaissent les unités de mesure et nécessitent des combinaisons valides si elles sont fournies. Par exemple, 2mm + 4mm est une expression valide, tandis que 2mm + 4 ne l'est pas (la raison est qu'une expression comme 1in + 4 sera très probablement interprété comme 1in + 4in par le dessinateur mais comme toutes les unités en interne sont converties au système international SI, et le système est totalement incapable de deviner de quelle unité il s'agit).


== Supported Operators ==
== Opérateurs pris en charge ==


Les opérations suivantes sont supportées:
The following operators are supported:
{| class="wikitable float-right mw-collapsible mw-uncollapsed"
{| class="wikitable float-right mw-collapsible mw-uncollapsed"
!style="width: 33%;"|Operator
!style="width: 33%;"|Opération
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| +
| +
| [https://en.wikipedia.org/wiki/Addition Addition]
| [https://fr.wikipedia.org/wiki/Addition Addition]
|-
|-
| -
| -
| [https://en.wikipedia.org/wiki/Subtraction Subtraction]
| [https://fr.wikipedia.org/wiki/Soustraction Soustraction]
|-
|-
| *
| *
| [https://en.wikipedia.org/wiki/Multiplication Multiplication]
| [https://fr.wikipedia.org/wiki/Multiplication Multiplication]
|-
|-
| /
| /
| [https://en.wikipedia.org/wiki/Division_(mathematics) Division]
| [https://fr.wikipedia.org/wiki/Division Division]
|-
|-
| ^
| ^
| [https://en.wikipedia.org/wiki/Exponentiation Exponentiation]
| [https://fr.wikipedia.org/wiki/Exponentiation Exponentiation]
|}
|}


== Constantes prises en charge ==
<div class="mw-translate-fuzzy">
Lorsqu'une fonction prend plusieurs arguments, ceux-ci peuvent être séparés par un point-virgule (';') ou une virgule <em>suivie par un espace</em> (", ").
Dans ce derniers cas, la virgule est convertie en point-virgule après la saisie.
Quand on utilise un point-virgule, il n'est pas nécessaire de finir la ligne par un espace.
</div>


Les constantes suivantes sont supportées:
<div class="mw-translate-fuzzy">
{| class="wikitable float-right mw-collapsible mw-uncollapsed"
{{APIFunction/fr |abs|x| Valeur absolue | valeur <nowiki> >= 0 </nowiki> }}
!style="width: 33%;"|Constante
{{APIFunction/fr |acos|x| Arc cosinus ; <nowiki> -1 <= x <= 1 </nowiki>| acos(x) }}
!style="width: 66%;"|Description
{{APIFunction/fr |asin|x| Arc sinus ; <nowiki> -1 <= x <= 1 </nowiki> | asin(x) }}
|-
{{APIFunction/fr |atan|x| Arc tangente | atan(x) }}
| e
{{APIFunction/fr |atan2|y, x| Arc tangente of y / x | atan2(y,x) }}
| [https://fr.wikipedia.org/wiki/E_(nombre) nombre d'Euler]
{{APIFunction/fr |ceil|x| Arrondi au nombre entier supérieur | Le plus petit nombre entier &gt;&#61; x {{Version|0.16}} }}
|-
{{APIFunction/fr |cos|angle| Cosinus ; n'importe quelle valeur d'angle en degrés | <nowiki> -1 <= cos(x) <= 1 </nowiki> }}
| pi
{{APIFunction/fr |cosh|x| Cosinus hyperbolique de x | cosh(x) }}
| [https://fr.wikipedia.org/wiki/Pi Pi]
{{APIFunction/fr |exp|y| Fonction exponentielle | e<sup> y</sup> }}
|}
{{APIFunction/fr |floor|x| Arrondi au nombre entier inférieur | Le plus grand nombre entier &lt;&#61; x {{Version|0.16}} }}
{{APIFunction/fr |log|x| Fonction logarithme naturel | log<sub>e</sub> x }}
{{APIFunction/fr |log10|x| Fonction logarithme de base 10 | log<sub>10</sub> x }}
{{APIFunction/fr |mod|x, y| Modulo de x/y | Reste après avoir divisé x par y }}
{{APIFunction/fr |pow|x, y| Fonction puissance | x<sup> y</sup> }}
{{APIFunction/fr |round|x| Fonction arrondi | x arrondi à l'entier le plus proche {{Version|0.16}} }}
{{APIFunction/fr |sin|angle| Sinus ; n'importe quelle valeur d'angle en degrés | <nowiki> -1 <= sin(x) <= 1 </nowiki> }}
{{APIFunction/fr |sinh|x| Sinus hyperbolique de x | sinh(x) }}
{{APIFunction/fr |sqrt|x| Racine carrée ; <nowiki> x >= 0 </nowiki> | Racine carrée x }}
{{APIFunction/fr |tan|angle| Tangente ; n'importe quelle valeur d'angle en degrés | tan(angle) }}
{{APIFunction/fr |tanh|x| Tangente hyperbolique of x | tanh(x) }}
{{APIFunction/fr |trunc|x| Fonction partie entière | x tronqué à l'entier relatif le plus proche {{Version|0.16}} }}
</div>


== Fonctions Supportées ==
== Fonctions Supportées ==


=== General Mathematical Functions ===
=== Fonctions Mathématiques Générales ===


Les fonctions mathématiques suivantes sont disponibles.
Les fonctions mathématiques suivantes sont disponibles.


Lorsqu'une fonction prend plusieurs arguments, ceux-ci peuvent être séparés par un point-virgule ';' ou une virgule <em>suivie par un espace</em> ','.
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.
Dans ce derniers cas, la virgule est convertie en point-virgule après la saisie. Quand on utilise un point-virgule, il n'est pas nécessaire de finir la ligne par un espace.


[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/>
Les [https://fr.wikipedia.org/wiki/Fonction_trigonom%C3%A9trique fonctions trigonométriques] utilisent le degré comme unité par défaut. Pour la mesure en radian, ajoutez '''rad''' après la <em>première</em> valeur dans une expression. Par exemple '''cos(45)''' est identique à '''cos(pi rad / 4)'''.<br/>
Ces fonctions trigonométriques sont supportées:
These trigonometric functions are supported:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Function
!style="width: 33%;"|Fonction
!style="width: 33%;"|Description
!style="width: 33%;"|Description
!style="width: 33%;"|Value range
!style="width: 33%;"|Plage des valeurs
|-
|-
| acos(x)
| acos(x)
| [https://en.wikipedia.org/wiki/Inverse_trigonometric_functions#Basic_properties Arc cosine]
| [https://fr.wikipedia.org/wiki/Arc_cosinus Arc cosinus]
| -1 <= x <= 1
| -1 <= x <= 1
|-
|-
| asin(x)
| asin(x)
| [https://en.wikipedia.org/wiki/Inverse_trigonometric_functions#Basic_properties Arc sine]
| [https://fr.wikipedia.org/wiki/Arc_sinus Arc sinus]
| -1 <= x <= 1
| -1 <= x <= 1
|-
|-
| atan(x)
| atan(x)
| [https://en.wikipedia.org/wiki/Inverse_trigonometric_functions#Basic_properties Arc tangent]
| [https://fr.wikipedia.org/wiki/Arc_tangente Arc tangente]
| all
| tout
|-
|-
| atan2(x, y)
| atan2(x, y)
| [https://en.wikipedia.org/wiki/Inverse_trigonometric_functions#Basic_properties Arc tangent] of ''x/y''
| [https://fr.wikipedia.org/wiki/Atan2 atan2] de ''x/y''
| all, except y = 0
| tout sauf y = 0
|-
|-
| cos(x)
| cos(x)
| [https://en.wikipedia.org/wiki/Trigonometric_functions#Right-angled_triangle_definitions Cosine]
| [https://fr.wikipedia.org/wiki/Cosinus Cosinus]
| all
| tout
|-
|-
| cosh(x)
| cosh(x)
| [https://en.wikipedia.org/wiki/Hyperbolic_function#Trigonometric_definitions Hyperbolic cosine]
| [https://fr.wikipedia.org/wiki/Cosinus_hyperbolique Cosinus hyperbolique]
| all
| tout
|-
|-
| sin(x)
| sin(x)
| [https://en.wikipedia.org/wiki/Trigonometric_functions#Right-angled_triangle_definitions Sine]
| [https://fr.wikipedia.org/wiki/Sinus_(math%C3%A9matiques) Sinus]
| all
| tout
|-
|-
| sinh(x)
| sinh(x)
| [https://en.wikipedia.org/wiki/Hyperbolic_function#Trigonometric_definitions Hyperbolic sine]
| [https://fr.wikipedia.org/wiki/Sinus_hyperbolique Sinus hyperbolique]
| all
| tout
|-
|-
| tan(x)
| tan(x)
| [https://en.wikipedia.org/wiki/Trigonometric_functions#Right-angled_triangle_definitions Tangent]
| [https://fr.wikipedia.org/wiki/Tangente_(trigonom%C3%A9trie) Tangente]
| all, except of x = n·90 with n = integer
| tout sauf x = n·90 avec n = entier
|-
|-
| tanh(x)
| tanh(x)
| [https://en.wikipedia.org/wiki/Hyperbolic_function#Trigonometric_definitions Hyperbolic tangent]
| [https://fr.wikipedia.org/wiki/Tangente_hyperbolique Tangente hyperbolique]
| all
| tout
|}
|}


Ces fonctions d’exponentiation et de logarithmisation sont prises en charge:
These functions for exponentiation and logarithmization are supported:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Function
!style="width: 33%;"|Fonction
!style="width: 33%;"|Description
!style="width: 33%;"|Description
!style="width: 33%;"|Value range
!style="width: 33%;"|Plage des valeurs
|-
|-
| exp(x)
| exp(x)
| [https://en.wikipedia.org/wiki/Exponential_function#Formal_definition Exponential function]
| [https://fr.wikipedia.org/wiki/Fonction_exponentielle Fonction exponentielle]
| all
| tout
|-
|-
| log(x)
| log(x)
| [https://en.wikipedia.org/wiki/Natural_logarithm Natural logarithm]
| [https://fr.wikipedia.org/wiki/Logarithme_naturel Logarithme népérien]
| x > 0
| x > 0
|-
|-
| log10(x)
| log10(x)
| [https://en.wikipedia.org/wiki/Common_logarithm Common logarithm]
| [https://fr.wikipedia.org/wiki/Logarithme_d%C3%A9cimal Logarithme décimal]
| x > 0
| x > 0
|-
|-
| pow(x, y)
| pow(x, y)
| [https://en.wikipedia.org/wiki/Exponentiation Exponentiation]
| [https://fr.wikipedia.org/wiki/Exposant_(math%C3%A9matiques) Les puissances]
| all
| tout
|-
|-
| sqrt(x)
| sqrt(x)
| [https://en.wikipedia.org/wiki/Square_root Square root]
| [https://fr.wikipedia.org/wiki/Racine_carr%C3%A9e Racine carrée]
| x >= 0
| x >= 0
|}
|}


Ces fonctions d'arrondi, de troncature et de reste sont supportées:
These functions for rounding, truncation and remainder are supported:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 20%;"|Function
!style="width: 20%;"|Fonction
!style="width: 55%;"|Description
!style="width: 55%;"|Description
!style="width: 25%;"|Value range
!style="width: 25%;"|Plage des valeurs
|-
|-
| abs(x)
| abs(x)
| [https://en.wikipedia.org/wiki/Absolute_value Absolute value]
| [https://fr.wikipedia.org/wiki/Valeur_absolue Valeur absolue]
| all
| tout
|-
|-
| ceil(x)
| ceil(x)
| [https://en.wikipedia.org/wiki/Floor_and_ceiling_functions Ceiling function] smallest integer value greater than or equal to x
| [https://en.wikipedia.org/wiki/Floor_and_ceiling_functions Ceiling function] la plus petite valeur entière supérieure ou égale à x
| all
| tout
|-
|-
| floor(x)
| floor(x)
| [https://en.wikipedia.org/wiki/Floor_and_ceiling_functions Floor function], largest integer value less than or equal to x
| [https://en.wikipedia.org/wiki/Floor_and_ceiling_functions Floor function], la plus grande valeur entière supérieure ou égale à x
| all
| tout
|-
|-
| mod(x, y)
| mod(x, y)
| [https://en.wikipedia.org/wiki/Remainder Remainder] after dividing ''x'' by ''y''
| [https://fr.wikipedia.org/wiki/Reste REste] après la division de ''x'' par ''y''
| all, except y = 0
| tout sauf y = 0
|-
|-
| round(x)
| round(x)
| [https://en.wikipedia.org/wiki/Rounding Rounding] to the nearest integer
| [https://fr.wikipedia.org/wiki/Arrondi_(math%C3%A9matiques) Arrondi] au nombre entier le plus proche
| all
| tout
|-
|-
| trunc(x)
| trunc(x)
| [https://en.wikipedia.org/wiki/Truncation Truncation] to the nearest integer
| [https://fr.wikipedia.org/wiki/Troncature Troncature] au nombre entier le plus proche
| all
| tout
|}
|}


=== Statistiques et Fonctions cumulatives ===
<div class="mw-translate-fuzzy">
[https://en.wikipedia.org/wiki/Aggregate_function Les fonctions cumulatives] prennent un ou plusieurs arguments, séparés par un point-virgule ';' ou une virgule ''et'' un espace ','.<br/>
=== Statistiques et Fonctions Cumulatives ===
Les arguments peuvent inclure des références à des cellules dans une feuille de calcul. Les références de cellule sont constituées de lettres (CAPITAL) suivies du numéro de colonne.<br/>
Les fonctions cumulatives suivantes sont disponibles.
Les arguments peuvent inclure des plages de cellules (deux références de cellules séparées par un deux-points), par exemple '''average(B1:B8)'''.
Elles prennent un ou plusieurs arguments, ceux-ci peuvent être séparés par un point-virgule ";" ou une virgule <em>suivie par un espace</em> ", ".
Les arguments peuvent contenir des références aux cellules d'une feuille de calcul ; les références aux cellules sont constituées de la lettre de colonne (en CAPITALES), suivie par le numéro de ligne.
On peut passer en argument une plage de cellules (deux références de cellules séparées par le signe deux-points ":").
Exemple : ''average(B1:B8)''
</div>


Les fonctions cumulatives supportées sont
<div class="mw-translate-fuzzy">
{| class="wikitable float-right mw-collapsible mw-collapsed"
{{APIFunction/fr |average|x y| Moyenne des valeurs des cellules x à y | sum(x, y) / count(x, y) }}
!style="width: 20%;"|Fonction
{{APIFunction/fr |count|x y| Nombre de cellules de x à y | Le nombre de cellules de x à y, inclusif }}
!style="width: 55%;"|Description
{{APIFunction/fr |max|x y| Valeur maximale dans les cellules x à y | Valeur maximale }}
!style="width: 25%;"|Plage des valeurs
{{APIFunction/fr |min|x y| Valeur minimale dans les cellules x à y | Valeur minimale }}
|-
{{APIFunction/fr |stddev|x y| Écart type des valeurs dans les cellules x à y | Ecart type }}
| average(x:y)
{{APIFunction/fr |sum|x y| Somme des valeurs dans les cellules x à y | Somme }}
| [https://fr.wikipedia.org/wiki/Moyenne_arithm%C3%A9tique Moyenne arithmétique] des valeurs dans les cellules x à y; sum(x:y) / count(x:y)
</div>
| tout
|-
| count(x:y)
| [https://fr.wikipedia.org/wiki/D%C3%A9nombrement Comptage] de cellules de x à y
| tout
|-
| max(x:y)
| Valeur [https://fr.wikipedia.org/wiki/Extremum Maximum] dans les cellules x à y
| tout
|-
| min(x:y)
| Valeur [https://fr.wikipedia.org/wiki/Extremum Minimum] dans les cellules x à y
| tout
|-
| stddev(x:y)
| [https://fr.wikipedia.org/wiki/%C3%89cart_type Écart type] de valeurs des cellules x à y
| tout
|-
| sum(x: y)
| [https://fr.wikipedia.org/wiki/Somme_(arithm%C3%A9tique) Somme] de valeurs des cellules x à y
| tout
|}


== Conditional Expressions ==
== Expressions conditionnelles ==


Les expressions conditionnelles sont de la forme '''condition? resultTrue: resultFalse ''' (''condition ? résultat si VRAI : résultat si FAUX''). La condition est définie comme une expression dont le résultat est '0' (faux) ou différent de zéro (vrai).
<div class="mw-translate-fuzzy">
Les expressions conditionnelles s'expriment sous la forme ''condition ? résultat si VRAI : résultat si FAUX''.
</div>


The following [https://en.wikipedia.org/wiki/Relational_operator#Standard_relational_operators relational operators] are defined:
Les [https://en.wikipedia.org/wiki/Relational_operator#Standard_relational_operators opérateurs relationnels] suivants sont définis:
{| class="wikitable float-right mw-collapsible mw-uncollapsed"
{| class="wikitable float-right mw-collapsible mw-uncollapsed"
!style="width: 33%;"|Unit
!style="width: 33%;"|Unité
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| ==
| ==
| equal to
| égal à
|-
|-
| !=
| !=
| not equal to
| pas égal à
|-
|-
| >
| >
| strictement plus grand que
| greater than
|-
|-
| <
| <
| strictement plus petit que
| less than
|-
|-
| >=
| >=
| greater than or equal to
| plus grand ou égal à
|-
|-
| <=
| <=
| less than or equal to
| plus petit ou égal à
|}
|}


== Unités ==
<div class="mw-translate-fuzzy">
La condition est définie comme une expression qui donnera soit 0 (pour faux) ou différent de 0 (pour vrai). Les opérateurs de comparaison sont les suivants : ==, !=, >, <, >= et <=.
</div>


Units can directly be used in expressions. The parser connects them to the previous value. So ''''2mm'''' or ''''2 mm'''' is valid while '''' mm'''' is invalid because there is no preceding value.
Les unités peuvent être directement utilisées dans des expressions. L'analyseur les connecte à la valeur précédente. Donc ''''2mm'''' ou ''''2 mm'''' sont valides tandis que '''' mm'''' est invalide car il n'y a pas de valeur.


Toutes les valeurs doivent avoir une unité. Par conséquent, vous devez généralement utiliser une unité pour les valeurs dans les feuilles de calcul.<br/>
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.
Dans certains cas, cela fonctionne même sans unité, par exemple si vous avez dans la cellule B1 du calculateur, juste le nombre ''1.5'' et qu'il se reporte à la hauteur du pavé. Cela ne fonctionne que parce que la hauteur du pad prédéfinit l'unité ''mm'' utilisée si aucune unité n'est donnée. Il échouera néanmoins si vous utilisez pour la hauteur du pad, par exemple '''Sketch1.Constraints.Width - Spreadsheet.B1''' car ''Sketch1.Constraints.Width'' a une unité et ''Spreadsheet.B1'' n'en a pas. euh ce n'est pas clair...


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³.
Les unités avec des exposants peuvent être directement entrées. Donc, par exemple '''mm^3''' sera reconnu comme mm³ et '''m^3''' sera reconnu comme m³.


Si vous avez une variable avec le nom d'une unité, vous devez la mettre entre '''<< >>'''pour éviter qu'elle ne soit reconnue comme une unité. Par exemple, si vous avez la dimension ''''Sketch.Constraints.A'''' , elle sera reconnue comme l'unité Ampère. Dans une expression, vous devez l'écrire sous la forme ''''Sketch.Constraints.<<A>>''''.
<div class="mw-translate-fuzzy">
Les fonctions trigonométriques utilisent les degrés par défaut.
Pour les mesures utilisant le radian, il faut ajouter '''rad''' suivant la <em>première</em> valeur angulaire dans l'expression.
Exemple : cos(45) est identique à cos(pi rad / 4).
</div>


Les unités suivantes sont reconnues par l’analyseur d’expression:
The following units are recognized by the expression parser:


Une quantité de matière:
Amount of substance:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
!style="width: 33%;"|Unité
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| mol
| mol
| [https://en.wikipedia.org/wiki/Mole_(unit) Mole]
| [https://fr.wikipedia.org/wiki/Mole_(unit%C3%A9) Mole]
|}
|}


Angle:
Angle:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
!style="width: 33%;"|Unité
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| °
| °
| [https://en.wikipedia.org/wiki/Degree_(angle) Degree]; alternative to the unit ''deg''
| [https://fr.wikipedia.org/wiki/Degree_(angle) Degré]; alternative à l'unité ''deg''
|-
|-
| deg
| deg
| [https://en.wikipedia.org/wiki/Degree_(angle) Degree]; alternative to the unit ''°''
| [https://fr.wikipedia.org/wiki/Degree_(angle) Degré]; alternative à l'unité ''°''
|-
|-
| rad
| rad
| [https://en.wikipedia.org/wiki/Radian Radian]
| [https://fr.wikipedia.org/wiki/Radian Radian]
|-
|-
| gon
| gon
| [https://en.wikipedia.org/wiki/Gon_(unit) Gradian]
| [https://fr.wikipedia.org/wiki/Gon_(unit) Gradian]
|-
|-
| S
| S
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc Second of arc]
| [https://fr.wikipedia.org/wiki/Sous-unit%C3%A9s_du_degr%C3%A9 Seconde d'arc]
|-
|-
| ″
| ″
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc Second of arc]; alternative to the unit ''S''
| [https://fr.wikipedia.org/wiki/Sous-unit%C3%A9s_du_degr%C3%A9 Seconde d'arc]; alternative à l'unité ''S''
|-
|-
| M
| M
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc Minute of arc]
| [https://fr.wikipedia.org/wiki/Sous-unit%C3%A9s_du_degr%C3%A9 Minute d'arc]
|-
|-
| ′
| ′
| [https://en.wikipedia.org/wiki/Minute_and_second_of_arc Minute of arc]; alternative to the unit ''M''
| [https://fr.wikipedia.org/wiki/Sous-unit%C3%A9s_du_degr%C3%A9 Minute d'arc]; à l'unité ''M''
|}
|}


Courant:
Current:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
!style="width: 33%;"|Unité
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| mA
| mA
| Milli[https://en.wikipedia.org/wiki/Ampere ampere]
| [https://fr.wikipedia.org/wiki/Amp%C3%A8re milliAmpère]
|-
|-
| A
| A
| [https://en.wikipedia.org/wiki/Ampere Ampere]
| [https://fr.wikipedia.org/wiki/Amp%C3%A8re Ampère]
|-
|-
| kA
| kA
| Kilo[https://en.wikipedia.org/wiki/Ampere ampere]
| [https://fr.wikipedia.org/wiki/Amp%C3%A8re kiloAmpère]
|-
|-
| MA
| MA
| Mega[https://en.wikipedia.org/wiki/Ampere ampere]
| [https://fr.wikipedia.org/wiki/Amp%C3%A8re megaAmpère]
|}
|}


Energy / Work:
Energie / Travail:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
!style="width: 33%;"|Unité
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| J
| J
| [https://en.wikipedia.org/wiki/Joule Joule]
| [https://fr.wikipedia.org/wiki/Joule Joule]
|-
|-
| Ws
| Ws
| [https://en.wikipedia.org/wiki/Joule#Watt_second Watt second]; alternative to the unit ''Joule''
| [https://fr.wikipedia.org/wiki/Joule#Dans_la_vie_courante#Conversion Watt second]; alternative à l'unité ''Joule''
|-
|-
| VAs
| VAs
| [https://en.wikipedia.org/wiki/Joule Volt-ampere-second]; alternative to the unit ''Joule''
| [https://en.wikipedia.org/wiki/Joule Volt-ampere-second]; alternative à l'unité ''Joule''
|-
|-
| CV
| CV
| [https://en.wikipedia.org/wiki/Joule Coulomb·Volt]; alternative to the unit ''Joule''
| [https://en.wikipedia.org/wiki/Joule Coulomb·Volt]; alternative à l'unité ''Joule''
|}
|}


Force:
Force:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
!style="width: 33%;"|Unité
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| mN
| mN
| Milli[https://en.wikipedia.org/wiki/Newton_(unit) newton]
| [https://fr.wikipedia.org/wiki/Newton_(unit%C3%A9) milliNewton]
|-
|-
| N
| N
| [https://en.wikipedia.org/wiki/Newton_(unit) Newton]
| [https://fr.wikipedia.org/wiki/Newton_(unit%C3%A9) Newton]
|-
|-
| kN
| kN
| Kilo[https://en.wikipedia.org/wiki/Newton_(unit) newton]
| [https://fr.wikipedia.org/wiki/Newton_(unit%C3%A9) kiloNewton]
|-
|-
| MN
| MN
| Mega[https://en.wikipedia.org/wiki/Newton_(unit) newton]
| [https://fr.wikipedia.org/wiki/Newton_(unit%C3%A9) mégaNewton]
|-
|-
| lbf
| lbf
| [https://en.wikipedia.org/wiki/Pound_(force) Pound of force]
| [https://fr.wikipedia.org/wiki/Livre-force Livre-force]
|}
|}


Longueur:
Length:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
!style="width: 33%;"|Unité
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| nm
| nm
| Nano[https://en.wikipedia.org/wiki/Metre meter]
| [https://fr.wikipedia.org/wiki/M%C3%A8tre nanomètre]
|-
|-
| um
| um
| Micro[https://en.wikipedia.org/wiki/Metre meter]; alternative to the unit ''µm''
| [https://fr.wikipedia.org/wiki/M%C3%A8tre micromètre]; alternative à l'unité ''µm''
|-
|-
| µm
| µm
| Micro[https://en.wikipedia.org/wiki/Metre meter]; alternative to the unit ''mu''
| [https://fr.wikipedia.org/wiki/M%C3%A8tre micromètre]; alternative à l'unité ''mu''
|-
|-
| mm
| mm
| Milli[https://en.wikipedia.org/wiki/Metre meter]
| [https://fr.wikipedia.org/wiki/M%C3%A8tre millimètre]
|-
|-
| cm
| cm
| Centi[https://en.wikipedia.org/wiki/Metre meter]
| [https://fr.wikipedia.org/wiki/M%C3%A8tre centimètre]
|-
|-
| mm
| m
| Milli[https://en.wikipedia.org/wiki/Metre meter]
| [https://fr.wikipedia.org/wiki/M%C3%A8tre mètre]
|-
|-
| dm
| dm
| Deci[https://en.wikipedia.org/wiki/Metre meter]
| [https://fr.wikipedia.org/wiki/M%C3%A8tre décimètre]
|-
| m
| [https://en.wikipedia.org/wiki/Metre Meter]
|-
|-
| km
| km
| Kilo[https://en.wikipedia.org/wiki/Metre meter]
| [https://fr.wikipedia.org/wiki/M%C3%A8tre kilomètre]
|-
|-
| mil
| mil
| [https://en.wikipedia.org/wiki/Thousandth_of_an_inch Thousandth of an inch]; alternative to the unit ''thou''
| [https://en.wikipedia.org/wiki/Thousandth_of_an_inch millième de pouce]; alternative à l'unité ''thou''
|-
|-
| thou
| thou
| [https://en.wikipedia.org/wiki/Thousandth_of_an_inch Thousandth of an inch]; alternative to the unit ''mil''
| [https://en.wikipedia.org/wiki/Thousandth_of_an_inch millième de pouce]; alternative à l'unité ''mil''
|-
|-
| in
| in
| [https://en.wikipedia.org/wiki/Inch Inch]
| [https://fr.wikipedia.org/wiki/Pouce_(unit%C3%A9) pouce]
|-
|-
| ft
| ft
| [https://en.wikipedia.org/wiki/Foot_(unit) Foot]; alternative to the unit '
| [https://fr.wikipedia.org/wiki/Pied_(unit%C3%A9) pied]; alternative à l'unité '
|-
|-
| '
| '
| [https://en.wikipedia.org/wiki/Foot_(unit) Foot]; alternative to the unit ''ft''
| [https://fr.wikipedia.org/wiki/Pied_(unit%C3%A9) pied]; alternative à l'unité ''ft''
|-
|-
| yd
| yd
| [https://en.wikipedia.org/wiki/Yard Yard]
| [https://fr.wikipedia.org/wiki/Verge_(unit%C3%A9) yard ou verge]
|-
|-
| mi
| mi
| [https://en.wikipedia.org/wiki/Mile Mile]
| [https://fr.wikipedia.org/wiki/Mille_(unit%C3%A9) mille]
|}
|}


Intensité lumineuse:
Luminous intensity:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
!style="width: 33%;"|Unit"
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| cd
| cd
| [https://en.wikipedia.org/wiki/Candela Candela]
| [https://fr.wikipedia.org/wiki/Candela Candela]
|}
|}


Poids:
Mass:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
!style="width: 33%;"|Unité
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| ug
| ug
| Micro[https://en.wikipedia.org/wiki/Gram gram]; alternative to the unit ''µg''
| [https://fr.wikipedia.org/wiki/Gramme microgramme]; alternative à l'unité ''µg''
|-
|-
| µg
| µg
| Micro[https://en.wikipedia.org/wiki/Gram gram]; alternative to the unit ''ug''
| [https://fr.wikipedia.org/wiki/Gramme microgramme]; alternative à l'unité ''ug''
|-
|-
| mg
| mg
| Milli[https://en.wikipedia.org/wiki/Gram gram]
| [https://fr.wikipedia.org/wiki/Gramme milligramme]
|-
|-
| g
| g
| [https://en.wikipedia.org/wiki/Gram Gram]
| [https://fr.wikipedia.org/wiki/Gramme gramme]
|-
|-
| kg
| kg
| Kilo[https://en.wikipedia.org/wiki/Gram gram]
| [https://fr.wikipedia.org/wiki/Gramme kilogramme]
|-
|-
| t
| t
| [https://en.wikipedia.org/wiki/Tonne Tonne]
| [https://fr.wikipedia.org/wiki/Tonne Tonne]
|-
|-
| oz
| oz
| [https://en.wikipedia.org/wiki/Ounce Ounce]
| [https://fr.wikipedia.org/wiki/Once_(unit%C3%A9) Once]
|-
|-
| lb
| lb
| [https://en.wikipedia.org/wiki/Pound_(mass) Pound]; alternative to the unit ''lbm''
| [https://fr.wikipedia.org/wiki/Livre_(unit%C3%A9_de_masse) livre]; alternative à l'unité ''lbm''
|-
|-
| lbm
| lbm
| [https://en.wikipedia.org/wiki/Pound_(mass) Pound]; alternative to the unit ''lb''
| [https://fr.wikipedia.org/wiki/Livre_(unit%C3%A9_de_masse) Pound]; alternative à l'unité ''lb''
|-
|-
| st
| st
| [https://en.wikipedia.org/wiki/Stone_(weight) Stone]
| [https://fr.wikipedia.org/wiki/Stone_(unit%C3%A9) Stone]
|-
|-
| cwt
| cwt
Line 451: Line 441:
|}
|}


Puissance:
<div class="mw-translate-fuzzy">
{| class="wikitable float-right mw-collapsible mw-collapsed"
=== Expressions conditionnelles ===
!style="width: 33%;"|Unité
</div>
!style="width: 66%;"|Description
|-
| W
| [https://fr.wikipedia.org/wiki/Watt Watt]
|-
| VA
| [https://fr.wikipedia.org/wiki/Voltamp%C3%A8re Voltampère]
|}


Pression:
Pressure:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
!style="width: 33%;"|Unité
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| Pa
| Pa
| [https://en.wikipedia.org/wiki/Pascal_(unit) Pascal]
| [https://fr.wikipedia.org/wiki/Pascal_(unit%C3%A9) pascal]
|-
|-
| kPa
| kPa
| Kilo[https://en.wikipedia.org/wiki/Pascal_(unit) pascal]
| [https://fr.wikipedia.org/wiki/Pascal_(unit%C3%A9) kilopascal]
|-
|-
| MPa
| MPa
| Mega[https://en.wikipedia.org/wiki/Pascal_(unit) pascal]
| [https://fr.wikipedia.org/wiki/Pascal_(unit%C3%A9) mégapascal]
|-
|-
| GPa
| GPa
| Giga[https://en.wikipedia.org/wiki/Pascal_(unit) pascal]
| [https://fr.wikipedia.org/wiki/Pascal_(unit%C3%A9) gigapascal]
|-
|-
| uTorr
| uTorr
| Micro[https://en.wikipedia.org/wiki/Torr torr]; alternative to the unit ''µTorr''
| [https://fr.wikipedia.org/wiki/Torr microtorr]; alternative à l'unité ''µTorr''
|-
|-
| µTorr
| µTorr
| Micro[https://en.wikipedia.org/wiki/Torr torr]; alternative to the unit ''uTorr''
| [https://fr.wikipedia.org/wiki/Torr microtorr]; alternative à l'unité ''uTorr''
|-
|-
| mTorr
| mTorr
| Milli[https://en.wikipedia.org/wiki/Torr torr]
| [https://fr.wikipedia.org/wiki/Torr millitorr]
|-
|-
| Torr
| Torr
| [https://en.wikipedia.org/wiki/Torr Torr]
| [https://fr.wikipedia.org/wiki/Torr Torr]
|-
|-
| psi
| psi
| [https://en.wikipedia.org/wiki/Pounds_per_square_inch Pound-force per square inch]
| [https://fr.wikipedia.org/wiki/Livre-force_par_pouce_carr%C3%A9 Livre-force par pouce carré]
|-
|-
| ksi
| ksi
| Kilo[https://en.wikipedia.org/wiki/Pounds_per_square_inch pound-force per square inch]
| [https://fr.wikipedia.org/wiki/Livre-force_par_pouce_carr%C3%A9 kilo livre-force par pouce carré]
|}
|}


Température:
Temperature:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
!style="width: 33%;"|Unité
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| uK
| uK
| Micro[https://en.wikipedia.org/wiki/Kelvin kelvin]; alternative to the unit ''µK''
| [https://fr.wikipedia.org/wiki/Kelvin microkelvin]; alternative à l'unité ''µK''
|-
|-
| µK
| µK
| Micro[https://en.wikipedia.org/wiki/Kelvin kelvin]; alternative to the unit ''uK''
| [https://fr.wikipedia.org/wiki/Kelvin microkelvin]; alternative à l'unité ''uK''
|-
|-
| mK
| mK
| Milli[https://en.wikipedia.org/wiki/Kelvin kelvin]
| [https://fr.wikipedia.org/wiki/Kelvin millikelvin]
|-
|-
| K
| K
| [https://en.wikipedia.org/wiki/Kelvin Kelvin]
| [https://fr.wikipedia.org/wiki/Kelvin Kelvin]
|}
|}


Temps:
Time:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
!style="width: 33%;"|Unité
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| s
| s
| [https://en.wikipedia.org/wiki/Second Second]
| [https://fr.wikipedia.org/wiki/Seconde_(temps) Seconde]
|-
|-
| min
| min
| [https://en.wikipedia.org/wiki/Minute Minute]
| [https://fr.wikipedia.org/wiki/Minute_(temps) Minute]
|-
|-
| h
| h
| [https://en.wikipedia.org/wiki/Hour Hour]
| [https://fr.wikipedia.org/wiki/Heure Heure]
|}
|}


Couple:
Torque:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
!style="width: 33%;"|Unité
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| Nm
| Nm
| [https://en.wikipedia.org/wiki/Newton_metre Newton metre]
| [https://fr.wikipedia.org/wiki/Newton_m%C3%A8tre Newton mètre]
|}
|}


Volume:
Volume:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Unit
!style="width: 33%;"|Unité
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| l
| l
| [https://en.wikipedia.org/wiki/Litre Liter]
| [https://fr.wikipedia.org/wiki/Litre Litre]
|}
|}


Les unités couramment utilisées suivantes ne sont pas encore prises en charge:
The following commonly used units are not yet supported:
{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 25%;"|Unit
!style="width: 25%;"|Unité
!style="width: 50%;"|Description
!style="width: 50%;"|Description
!style="width: 25%;"|Alternative
!style="width: 25%;"|Alternative
|-
|-
| C
| C
| [https://en.wikipedia.org/wiki/Coulomb Coulomb]
| [https://fr.wikipedia.org/wiki/Coulomb Coulomb]
| 1 A*s
| 1 A*s
|-
|-
| Hz
| Hz
| [https://en.wikipedia.org/wiki/Hertz Hertz]
| [https://fr.wikipedia.org/wiki/Hertz Hertz]
| 1 /s
| 1 /s
|-
|-
| V
| V
| [https://en.wikipedia.org/wiki/Volt Volt]
| [https://fr.wikipedia.org/wiki/Volt Volt]
| 1 W/A
| 1 W/A
|-
|-
| eV
| eV
| [https://en.wikipedia.org/wiki/Electronvolt Electronvolt]
| [https://fr.wikipedia.org/wiki/Electronvolt Electronvolt]
| 1.602176634e-19 J
| 1.602176634e-19 J
|-
|-
| kWh
| kWh
| [https://en.wikipedia.org/wiki/Kilowatt_hour Kilowatt hour]
| [https://fr.wikipedia.org/wiki/Kilowatt-heure Kilowatt-heure]
| 3.6e6 J
| 3.6e6 J
|-
|-
| bar
| bar
| [https://en.wikipedia.org/wiki/Bar_(unit) Bar]
| [https://fr.wikipedia.org/wiki/Bar_(unit%C3%A9) Bar]
| 100 kPa
| 100 kPa
|-
|-
| T
| T
| [https://en.wikipedia.org/wiki/Tesla_(unit) Tesla]
| [https://fr.wikipedia.org/wiki/Tesla_(unit%C3%A9) Tesla]
| 1 kg/s^2/A
| 1 kg/s^2/A
|-
|-
| F
| F
| [https://en.wikipedia.org/wiki/Farad Farad]
| [https://fr.wikipedia.org/wiki/Farad Farad]
| 1 s^4*A^2/m^2/kg
| 1 s^4*A^2/m^2/kg
|-
|-
| H
| H
| [https://en.wikipedia.org/wiki/Henry_(unit) Henry]
| [https://fr.wikipedia.org/wiki/Henry_(unit%C3%A9) Henry]
| 1 kg*m^2/s^2/A^2
| 1 kg*m^2/s^2/A^2
|-
|-
| u
| u
| [https://en.wikipedia.org/wiki/Unified_atomic_mass_unit Atomic mass unit]; alternative to the unit 'Da'
| [https://fr.wikipedia.org/wiki/Unit%C3%A9_de_masse_atomique_unifi%C3%A9e Unité de masse atomique unifiée]; alternative à l'unité "Da"
| 1.66053906660e-27 kg
| 1.66053906660e-27 kg
|-
|-
| Da
| Da
| [https://en.wikipedia.org/wiki/Unified_atomic_mass_unit Dalton]; alternative to the unit 'u'
| [https://fr.wikipedia.org/wiki/Unit%C3%A9_de_masse_atomique_unifi%C3%A9e Dalton]; alternative à l'unité "u"
| 1.66053906660e-27 kg
| 1.66053906660e-27 kg
|-
|-
| cal
| cal
| [https://en.wikipedia.org/wiki/Calorie Calorie]
| [https://fr.wikipedia.org/wiki/Calorie Calorie]
| 4.184 J
| 4.184 J
|-
|-
| sr
| sr
| [https://en.wikipedia.org/wiki/Steradian Steradian]
| [https://fr.wikipedia.org/wiki/Steradian Steradian]
| Pas directement
| not directly
|-
|-
| lm
| lm
| [https://en.wikipedia.org/wiki/Lumen_(unit) Lumen]
| [https://fr.wikipedia.org/wiki/Lumen_(unit%C3%A9) Lumen]
| Pas directement
| not directly
|-
|-
| lx
| lx
| [https://en.wikipedia.org/wiki/Lux Lux]
| [https://fr.wikipedia.org/wiki/Lux_(unit%C3%A9) Lux]
| Pas directement
| not directly
|-
|-
| Mpsi
| Mpsi
| Mega[https://en.wikipedia.org/wiki/Pounds_per_square_inch pound-force per square inch]
| [https://fr.wikipedia.org/wiki/Livre-force_par_pouce_carr%C3%A9 méga livre-force par pouce carré]
| 1000 ksi
| 1000 ksi
|}
|}
Line 615: Line 613:
== Références aux données CAD ==
== Références aux données CAD ==


Il est possible d'utiliser des données provenant de l'objet courant ou d'autres objets du document dans une expression. La syntaxe pour référencer un champ se fait comme ceci : "objet.propriété". Si la propriété est un composé de champs, ils peuvent être accessibles ainsi : "objet.propriété.champs".
Il est possible d'utiliser des données provenant de l'objet courant ou d'autres objets du document dans une expression. La syntaxe pour référencer un champ se fait comme ceci : "object.property". Si la propriété est un composé de champs, ils peuvent être accessibles ainsi : "object.property.field".


Le tableau suivant montre quelques exemples :
Le tableau suivant montre quelques exemples :
Line 666: Line 664:
== Liaison entre documents ==
== Liaison entre documents ==


Il est possible (avec limitations) de définir une propriété d'un objet dans votre document actuel (fichier ".FCstd") en utilisant une expression pour référencer une propriété d'un objet contenu dans un autre document (fichier ".FCstd"). Par exemple, une cellule dans une feuille de calcul ou la longueur d'un cube de pièce, etc. dans un document peut être définie par une expression faisant référence à la valeur de placement X ou à une autre propriété d'un objet contenu dans un autre document.
<div class="mw-translate-fuzzy">
Il est possible de faire référence à une feuille de calcul d'un document depuis d'autres documents.
</div>


Note importante : Imaginez que vous utilisiez le nom d'un document pour le référencer depuis d'autres documents. Lorsque vous sauverez ce document pour la première fois, vous allez certainement lui choisir un nom différent de "Unnamed1" (ou sa version traduite), et là, quand vous allez le ré-ouvrir, les liens seront perdus. Il est donc recommandé de créer en premier le document "maître", puis d'y créer immédiatement la feuille de calcul, de sauver le document maître avec un nom had-hoc et de le fermer. Après l'avoir ouvert à nouveau, son nom sera fixé en interne dans FreeCAD. Ensuite vous pourrez toujours faire des modification mais il ne faudra pas le renommer.
Note importante : Imaginez que vous utilisiez le nom d'un document pour le référencer depuis d'autres documents. Lorsque vous sauverez ce document pour la première fois, vous allez certainement lui choisir un nom différent de "Unnamed1" (ou sa version traduite), et là, quand vous allez le ré-ouvrir, les liens seront perdus. Il est donc recommandé de créer en premier le document "maître", puis d'y créer immédiatement la feuille de calcul, de sauver le document maître avec un nom had-hoc et de le fermer. Après l'avoir ouvert à nouveau, son nom sera fixé en interne dans FreeCAD. Ensuite vous pourrez toujours faire des modification mais il ne faudra pas le renommer.


Une fois que le document maître avec la feuille de calcul est créé et enregistré (nommé), vous pouvez créer des documents dépendants en toute sécurité. Par exemple, si vous nommez le document maître "master", la feuille de calcul "modelConstants" et attribuez à une cellule un nom d'alias "Length", vous pouvez ensuite accéder à la valeur comme suit:
<div class="mw-translate-fuzzy">
Une fois que le document maître contenant la feuille de calcul est créé et enregistré (nommé), vous pouvez sans risque créer des documents dépendants. Supposons que vous avez nommé le document maître "maitre", que la feuille de calcul ait été renommée "Constantes_modele" et que vous ayez défini l'alias "Longueur" pour une cellule donnée, vous pourrez accéder à un alias comme ceci : "master#Constantes_modele.Longueur". Note : un document maître doit toujours être ouvert pour que ses valeurs soient accessibles au document dépendant.
</div>


master#modelConstants.Length
master#modelConstants.Length


Note that the master document must be loaded for the values in the master to be available to the dependent document.
Notez que le document maître doit être chargé pour que les valeurs de ce dernier soient disponibles pour le document dépendant.


Malheureusement, le vérificateur intégré suppose parfois qu’aucun nom valide étendu n’existe. Continuez à taper quand même. Lorsque vous avez terminé la référence complète, le bouton {{Button|OK}} devient actif.
Malheureusement, le vérificateur intégré suppose parfois qu’aucun nom valide étendu n’existe. Continuez à taper quand même. Lorsque vous avez terminé la référence complète, le bouton {{Button|OK}} devient actif.

Revision as of 15:06, 17 August 2019

Fonctions générales : min, max, count, sum, stddev et average. Les fonctions générales peuvent prendre un ou plusieurs arguments, séparés par une virgule ou un point-virgule. Les arguments peuvent inclure des plages de données (deux cellules séparées par deux points), par exemple =average(B1:B8). Celles-ci sont interprétées comme les propriétés B1, B2, ..., B8.

introduit dans la version 0.16

Il est maintenant possible de définir des propriétés utilisant des expressions mathématiques. Dans l'interface graphique, les boîtes de dialogues numériques et les champs de saisie qui sont liés à des propriétés contiennent une icône bleue File:Sketcher Expressions.png. En cliquant sur l'icône, ou en tapant le signe égal (=) comme dans un tableur, on fait apparaître l'éditeur d'expression pour cette propriété spécifique.

Une expression FreeCAD est une expression mathématique qui suit la notation pour les opérateurs mathématiques standard et fonctionne comme décrit ci-dessous. En outre, l'expression peut faire référence à d'autres propriétés et également utiliser des conditions. Une unité facultative peut être attachée aux nombres d'une expression.

Les nombres peuvent utiliser une virgule ',' ou un point décimal '.' séparer les chiffres entiers des décimales. Lorsque le marqueur décimal est utilisé, il doit obligatoirement être suivi d'au moins un chiffre. Ainsi, les expressions 1.+2. et 1,+2, ne sont pas valides, mais 1.0+2.0 et 1,0+2,0 sont valables.

Les constantes pi et e sont prédéfinies et doivent être écrites en minuscules.

Les opérateurs et fonctions reconnaissent les unités de mesure et nécessitent des combinaisons valides si elles sont fournies. Par exemple, 2mm + 4mm est une expression valide, tandis que 2mm + 4 ne l'est pas (la raison est qu'une expression comme 1in + 4 sera très probablement interprété comme 1in + 4in par le dessinateur mais comme toutes les unités en interne sont converties au système international SI, et le système est totalement incapable de deviner de quelle unité il s'agit).

Opérateurs pris en charge

Les opérations suivantes sont supportées:

Opération Description
+ Addition
- Soustraction
* Multiplication
/ Division
^ Exponentiation

Constantes prises en charge

Les constantes suivantes sont supportées:

Constante Description
e nombre d'Euler
pi Pi

Fonctions Supportées

Fonctions Mathématiques Générales

Les fonctions mathématiques suivantes sont disponibles.

Lorsqu'une fonction prend plusieurs arguments, ceux-ci peuvent être séparés par un point-virgule ';' ou une virgule suivie par un espace ','. Dans ce derniers cas, la virgule est convertie en point-virgule après la saisie. Quand on utilise un point-virgule, il n'est pas nécessaire de finir la ligne par un espace.

Les fonctions trigonométriques utilisent le degré comme unité par défaut. Pour la mesure en radian, ajoutez rad après la première valeur dans une expression. Par exemple cos(45) est identique à cos(pi rad / 4).
Ces fonctions trigonométriques sont supportées:

Fonction Description Plage des valeurs
acos(x) Arc cosinus -1 <= x <= 1
asin(x) Arc sinus -1 <= x <= 1
atan(x) Arc tangente tout
atan2(x, y) atan2 de x/y tout sauf y = 0
cos(x) Cosinus tout
cosh(x) Cosinus hyperbolique tout
sin(x) Sinus tout
sinh(x) Sinus hyperbolique tout
tan(x) Tangente tout sauf x = n·90 avec n = entier
tanh(x) Tangente hyperbolique tout

Ces fonctions d’exponentiation et de logarithmisation sont prises en charge:

Fonction Description Plage des valeurs
exp(x) Fonction exponentielle tout
log(x) Logarithme népérien x > 0
log10(x) Logarithme décimal x > 0
pow(x, y) Les puissances tout
sqrt(x) Racine carrée x >= 0

Ces fonctions d'arrondi, de troncature et de reste sont supportées:

Fonction Description Plage des valeurs
abs(x) Valeur absolue tout
ceil(x) Ceiling function la plus petite valeur entière supérieure ou égale à x tout
floor(x) Floor function, la plus grande valeur entière supérieure ou égale à x tout
mod(x, y) REste après la division de x par y tout sauf y = 0
round(x) Arrondi au nombre entier le plus proche tout
trunc(x) Troncature au nombre entier le plus proche tout

Statistiques et Fonctions cumulatives

Les fonctions cumulatives prennent un ou plusieurs arguments, séparés par un point-virgule ';' ou une virgule et un espace ','.
Les arguments peuvent inclure des références à des cellules dans une feuille de calcul. Les références de cellule sont constituées de lettres (CAPITAL) suivies du numéro de colonne.
Les arguments peuvent inclure des plages de cellules (deux références de cellules séparées par un deux-points), par exemple average(B1:B8).

Les fonctions cumulatives supportées sont

Fonction Description Plage des valeurs
average(x:y) Moyenne arithmétique des valeurs dans les cellules x à y; sum(x:y) / count(x:y) tout
count(x:y) Comptage de cellules de x à y tout
max(x:y) Valeur Maximum dans les cellules x à y tout
min(x:y) Valeur Minimum dans les cellules x à y tout
stddev(x:y) Écart type de valeurs des cellules x à y tout
sum(x: y) Somme de valeurs des cellules x à y tout

Expressions conditionnelles

Les expressions conditionnelles sont de la forme condition? resultTrue: resultFalse (condition ? résultat si VRAI : résultat si FAUX). La condition est définie comme une expression dont le résultat est '0' (faux) ou différent de zéro (vrai).

Les opérateurs relationnels suivants sont définis:

Unité Description
== égal à
!= pas égal à
> strictement plus grand que
< strictement plus petit que
>= plus grand ou égal à
<= plus petit ou égal à

Unités

Les unités peuvent être directement utilisées dans des expressions. L'analyseur les connecte à la valeur précédente. Donc '2mm' ou '2 mm' sont valides tandis que ' mm' est invalide car il n'y a pas de valeur.

Toutes les valeurs doivent avoir une unité. Par conséquent, vous devez généralement utiliser une unité pour les valeurs dans les feuilles de calcul.
Dans certains cas, cela fonctionne même sans unité, par exemple si vous avez dans la cellule B1 du calculateur, juste le nombre 1.5 et qu'il se reporte à la hauteur du pavé. Cela ne fonctionne que parce que la hauteur du pad prédéfinit l'unité mm utilisée si aucune unité n'est donnée. Il échouera néanmoins si vous utilisez pour la hauteur du pad, par exemple Sketch1.Constraints.Width - Spreadsheet.B1 car Sketch1.Constraints.Width a une unité et Spreadsheet.B1 n'en a pas. euh ce n'est pas clair...

Les unités avec des exposants peuvent être directement entrées. Donc, par exemple mm^3 sera reconnu comme mm³ et m^3 sera reconnu comme m³.

Si vous avez une variable avec le nom d'une unité, vous devez la mettre entre << >>pour éviter qu'elle ne soit reconnue comme une unité. Par exemple, si vous avez la dimension 'Sketch.Constraints.A' , elle sera reconnue comme l'unité Ampère. Dans une expression, vous devez l'écrire sous la forme 'Sketch.Constraints.<<A>>'.

Les unités suivantes sont reconnues par l’analyseur d’expression:

Une quantité de matière:

Unité Description
mol Mole

Angle:

Unité Description
° Degré; alternative à l'unité deg
deg Degré; alternative à l'unité °
rad Radian
gon Gradian
S Seconde d'arc
Seconde d'arc; alternative à l'unité S
M Minute d'arc
Minute d'arc; à l'unité M

Courant:

Unité Description
mA milliAmpère
A Ampère
kA kiloAmpère
MA megaAmpère

Energie / Travail:

Unité Description
J Joule
Ws Watt second; alternative à l'unité Joule
VAs Volt-ampere-second; alternative à l'unité Joule
CV Coulomb·Volt; alternative à l'unité Joule

Force:

Unité Description
mN milliNewton
N Newton
kN kiloNewton
MN mégaNewton
lbf Livre-force

Longueur:

Unité Description
nm nanomètre
um micromètre; alternative à l'unité µm
µm micromètre; alternative à l'unité mu
mm millimètre
cm centimètre
m mètre
dm décimètre
km kilomètre
mil millième de pouce; alternative à l'unité thou
thou millième de pouce; alternative à l'unité mil
in pouce
ft pied; alternative à l'unité '
' pied; alternative à l'unité ft
yd yard ou verge
mi mille

Intensité lumineuse:

Unit" Description
cd Candela

Poids:

Unité Description
ug microgramme; alternative à l'unité µg
µg microgramme; alternative à l'unité ug
mg milligramme
g gramme
kg kilogramme
t Tonne
oz Once
lb livre; alternative à l'unité lbm
lbm Pound; alternative à l'unité lb
st Stone
cwt Hundredweight

Puissance:

Unité Description
W Watt
VA Voltampère

Pression:

Unité Description
Pa pascal
kPa kilopascal
MPa mégapascal
GPa gigapascal
uTorr microtorr; alternative à l'unité µTorr
µTorr microtorr; alternative à l'unité uTorr
mTorr millitorr
Torr Torr
psi Livre-force par pouce carré
ksi kilo livre-force par pouce carré

Température:

Unité Description
uK microkelvin; alternative à l'unité µK
µK microkelvin; alternative à l'unité uK
mK millikelvin
K Kelvin

Temps:

Unité Description
s Seconde
min Minute
h Heure

Couple:

Unité Description
Nm Newton mètre

Volume:

Unité Description
l Litre

Les unités couramment utilisées suivantes ne sont pas encore prises en charge:

Unité Description Alternative
C Coulomb 1 A*s
Hz Hertz 1 /s
V Volt 1 W/A
eV Electronvolt 1.602176634e-19 J
kWh Kilowatt-heure 3.6e6 J
bar Bar 100 kPa
T Tesla 1 kg/s^2/A
F Farad 1 s^4*A^2/m^2/kg
H Henry 1 kg*m^2/s^2/A^2
u Unité de masse atomique unifiée; alternative à l'unité "Da" 1.66053906660e-27 kg
Da Dalton; alternative à l'unité "u" 1.66053906660e-27 kg
cal Calorie 4.184 J
sr Steradian Pas directement
lm Lumen Pas directement
lx Lux Pas directement
Mpsi méga livre-force par pouce carré 1000 ksi

Références aux données CAD

Il est possible d'utiliser des données provenant de l'objet courant ou d'autres objets du document dans une expression. La syntaxe pour référencer un champ se fait comme ceci : "object.property". Si la propriété est un composé de champs, ils peuvent être accessibles ainsi : "object.property.field".

Le tableau suivant montre quelques exemples :

Données CAO Appel dans l'expression Résultat
Longueur paramétrique d'un Cube de l'atelier Part Cube.Length Longueur en mm
Volume du Cube Cube.Shape.Volume Volume en mm³ sans unité
Type de la forme Cube Cube.Shape.ShapeType Chaîne de caractère : Solid
Label du Cube Cube.Label Chaîne de caractère : Label
coordonnée x du centre de gravité du Cube Cube.Shape.CenterOfMass.x coordonnée x en mm sans unité
Valeur d'une contrainte dans une esquisse Constraints.Largeur Valeur numérique de la contrainte nommée "Largeur" dans l'esquisse
Valeur d'une contrainte provenant d'une autre esquisse MonEsquisse.Constraints.Largeur Valeur numérique de la contrainte nommée "Largeur" dans l'esquisse nommée "MonEsquisse"
Valeur d'un alias de feuille de calcul MaFeuille.Profondeur Valeur de l'alias nommé "Profondeur" dans la feuille de calcul nommée "MaFeuille"
Valeur d'une propriété locale Length Valeur de la propriété Length, par exemple dans un objet "Pad" on pourrait l'utiliser pour calculer Length2, si celle-ci est utilisé.

Variables globales

Pour le moment il n'y a pas de notion de variables globales dans FreeCAD. Mais des variables arbitraires peuvent être définies comme des cellules dans une feuille de calcul en utilisant l'atelier Spreadsheet, auquelles on aura donné un nom en utilisant l'alias de la propriété pour la cellule utilisée (clic-droit dans la cellule). Ainsi, elles peuvent être accessibles à partir de toute expression comme toute autre propriété de l'objet.

Liaison entre documents

Il est possible (avec limitations) de définir une propriété d'un objet dans votre document actuel (fichier ".FCstd") en utilisant une expression pour référencer une propriété d'un objet contenu dans un autre document (fichier ".FCstd"). Par exemple, une cellule dans une feuille de calcul ou la longueur d'un cube de pièce, etc. dans un document peut être définie par une expression faisant référence à la valeur de placement X ou à une autre propriété d'un objet contenu dans un autre document.

Note importante : Imaginez que vous utilisiez le nom d'un document pour le référencer depuis d'autres documents. Lorsque vous sauverez ce document pour la première fois, vous allez certainement lui choisir un nom différent de "Unnamed1" (ou sa version traduite), et là, quand vous allez le ré-ouvrir, les liens seront perdus. Il est donc recommandé de créer en premier le document "maître", puis d'y créer immédiatement la feuille de calcul, de sauver le document maître avec un nom had-hoc et de le fermer. Après l'avoir ouvert à nouveau, son nom sera fixé en interne dans FreeCAD. Ensuite vous pourrez toujours faire des modification mais il ne faudra pas le renommer.

Une fois que le document maître avec la feuille de calcul est créé et enregistré (nommé), vous pouvez créer des documents dépendants en toute sécurité. Par exemple, si vous nommez le document maître "master", la feuille de calcul "modelConstants" et attribuez à une cellule un nom d'alias "Length", vous pouvez ensuite accéder à la valeur comme suit:

    master#modelConstants.Length  

Notez que le document maître doit être chargé pour que les valeurs de ce dernier soient disponibles pour le document dépendant.

Malheureusement, le vérificateur intégré suppose parfois qu’aucun nom valide étendu n’existe. Continuez à taper quand même. Lorsque vous avez terminé la référence complète, le bouton OK devient actif.

Bien sûr, vous pouvez charger les documents correspondants à tout moment pour y faire les modifications que vous voudrez.

Problèmes connus / tâches restantes

  • Le graphe de dépendance est basé sur la relation entre les objets et le document, et non sur les propriétés. Cela signifie que vous ne pouvez pas renseigner et interroger le même objet, par exemple dans une feuille de calcul, même si il n'y a pas de dépendance cyclique si l'on considère seulement les propriétés, vous ne pouvez pas avoir d'objet dont les dimensions proviennent de la feuille de calcul et calculer son volume dans la même feuille de calcul. Pour contourner le problème, utilisez plusieurs feuilles de calcul, par exemple une pour contrôler votre modèle, et une autre pour les rapports.
  • L'analyseur syntaxique d'expressions ne gère pas bien les parenthèses et n'est pas capable d'analyser correctement certaines expressions. Par exemple : "= (A1 > A2) ? 1 : 0" donne une erreur, alors que "= A1 > A2 ? 1 : 0" est accepté. L'expression "= 5 + ((A1>A2) ? 1 : 0)" va contrarier l'analyseur syntaxique dans tous les cas.
  • Il n'y a aucun gestionnaire d'expressions où toutes les expressions d'un document seraient répertoriées et où elles pourraient être créées, supprimées, interrogées, etc.
  • Les noms des contraintes Sketcher ne doivent contenir aucun blanc lorsque la valeur est calculée par une expression, voir la discussion sur le forum.
  • les bogues et tickets ouverts pour les expressions sont référencés sur le Bugtracker de Freecad, catégorie Expressions