Expressions/fr: Difference between revisions
No edit summary |
(Semble plus compréhensible ainsi) |
||
Line 2: | Line 2: | ||
{{TOCright}} |
{{TOCright}} |
||
<span id="Overview"></span> |
|||
==Vue d'ensemble== |
==Vue d'ensemble== |
||
Line 14: | Line 15: | ||
Vous pouvez utiliser des [[#Constantes_prises_en_charge|constantes prédéfinies]] et des [[#Fonctions_support.C3.A9es|fonctions]]. |
Vous pouvez utiliser des [[#Constantes_prises_en_charge|constantes prédéfinies]] et des [[#Fonctions_support.C3.A9es|fonctions]]. |
||
<span id="Function_arguments"></span> |
|||
=== Arguments de la fonction === |
=== Arguments de la fonction === |
||
Line 20: | Line 22: | ||
Les arguments peuvent inclure des références à des cellules dans une feuille de calcul. Une référence de cellule se compose de la lettre en majuscule de la ligne de la cellule suivie de son numéro de colonne, par exemple {{incode|A1}}. Une cellule peut également être référencée en utilisant l'alias de la cellule, par exemple {{incode|Spreadsheet.MyPartWidth}}. |
Les arguments peuvent inclure des références à des cellules dans une feuille de calcul. Une référence de cellule se compose de la lettre en majuscule de la ligne de la cellule suivie de son numéro de colonne, par exemple {{incode|A1}}. Une cellule peut également être référencée en utilisant l'alias de la cellule, par exemple {{incode|Spreadsheet.MyPartWidth}}. |
||
<span id="Referencing_objects"></span> |
|||
===Référencement d'objets=== |
===Référencement d'objets=== |
||
Line 31: | Line 34: | ||
Pour plus d'informations sur le référencement des objets, voir [[#R.C3.A9f.C3.A9rence_aux_donn.C3.A9es_CAO|Référence aux données CAO]]. |
Pour plus d'informations sur le référencement des objets, voir [[#R.C3.A9f.C3.A9rence_aux_donn.C3.A9es_CAO|Référence aux données CAO]]. |
||
{{Top}} |
{{Top}} |
||
<span id="Supported_constants"></span> |
|||
== Constantes prises en charge == |
== Constantes prises en charge == |
||
Line 46: | Line 50: | ||
|} |
|} |
||
{{Top}} |
{{Top}} |
||
<span id="Supported_operators"></span> |
|||
== Opérateurs pris en charge == |
== Opérateurs pris en charge == |
||
Line 73: | Line 78: | ||
|} |
|} |
||
{{Top}} |
{{Top}} |
||
<span id="Supported_functions"></span> |
|||
== Fonctions supportées == |
== Fonctions supportées == |
||
<span id="General_mathematical_functions"></span> |
|||
=== Fonctions mathématiques générales === |
=== Fonctions mathématiques générales === |
||
Les fonctions mathématiques suivantes sont prises en charge : |
Les fonctions mathématiques suivantes sont prises en charge : |
||
<span id="Trigonometric_functions"></span> |
|||
==== Fonctions trigonométriques ==== |
==== Fonctions trigonométriques ==== |
||
Line 137: | Line 145: | ||
|} |
|} |
||
<span id="Exponential_and_logarithmic_functions"></span> |
|||
==== Fonctions exponentielles et logarithmiques ==== |
==== Fonctions exponentielles et logarithmiques ==== |
||
Line 165: | Line 174: | ||
|} |
|} |
||
<span id="Rounding,_truncation_and_remainder_functions"></span> |
|||
==== Fonctions d'arrondi, de troncature et de reste ==== |
==== Fonctions d'arrondi, de troncature et de reste ==== |
||
Line 197: | Line 207: | ||
|} |
|} |
||
{{Top}} |
{{Top}} |
||
<span id="Statistical_/_aggregate_functions"></span> |
|||
=== Statistiques et fonctions d'agrégation === |
=== Statistiques et fonctions d'agrégation === |
||
Line 236: | Line 247: | ||
|} |
|} |
||
{{Top}} |
{{Top}} |
||
<span id="String_manipulation"></span> |
|||
=== Manipulation de chaînes de caractères === |
=== Manipulation de chaînes de caractères === |
||
<span id="String_identification"></span> |
|||
==== Identification de chaînes de caractères ==== |
==== Identification de chaînes de caractères ==== |
||
Line 244: | Line 257: | ||
Dans l'exemple suivant, "TEXT" est reconnu comme une chaîne de caractères : {{incode|<<TEXT>>}}. |
Dans l'exemple suivant, "TEXT" est reconnu comme une chaîne de caractères : {{incode|<<TEXT>>}}. |
||
<span id="String_concatenation"></span> |
|||
==== Concaténation de chaînes de caractères ==== |
==== Concaténation de chaînes de caractères ==== |
||
Line 250: | Line 264: | ||
L'exemple suivant {{incode|<<MY>> + <<TEXT>>}} sera concaténé en "MYTEXT". |
L'exemple suivant {{incode|<<MY>> + <<TEXT>>}} sera concaténé en "MYTEXT". |
||
<span id="String_conversion"></span> |
|||
==== Conversion de chaînes de caractères ==== |
==== Conversion de chaînes de caractères ==== |
||
Line 256: | Line 271: | ||
{{incode|str(Box.Length.Value)}} |
{{incode|str(Box.Length.Value)}} |
||
<span id="String_formatting"></span> |
|||
==== Formatage des chaînes de caractères ==== |
==== Formatage des chaînes de caractères ==== |
||
Line 268: | Line 284: | ||
Un exemple de fichier FreeCAD utilisant le formatage des chaînes de caractères est disponible [https://forum.freecadweb.org/viewtopic.php?f=8&t=58657 dans le forum]. |
Un exemple de fichier FreeCAD utilisant le formatage des chaînes de caractères est disponible [https://forum.freecadweb.org/viewtopic.php?f=8&t=58657 dans le forum]. |
||
{{Top}} |
{{Top}} |
||
<span id="Create_function"></span> |
|||
=== Créer une fonction === |
=== Créer une fonction === |
||
Line 280: | Line 297: | ||
Diverses opérations mathématiques telles que la multiplication, l'addition et la soustraction sont prises en charge par les opérateurs mathématiques standard (par exemple, {{incode|*}}, {{incode|+}}, {{incode|-}}). |
Diverses opérations mathématiques telles que la multiplication, l'addition et la soustraction sont prises en charge par les opérateurs mathématiques standard (par exemple, {{incode|*}}, {{incode|+}}, {{incode|-}}). |
||
<span id="Vector"></span> |
|||
==== Vecteur ==== |
==== Vecteur ==== |
||
Line 288: | Line 306: | ||
{{incode|create(<<vector>>; 2; 1; 2)}} |
{{incode|create(<<vector>>; 2; 1; 2)}} |
||
<span id="Matrix"></span> |
|||
==== Matrice ==== |
==== Matrice ==== |
||
Line 344: | Line 363: | ||
Pour plus de lisibilité, vous pouvez définir les vecteurs et les rotations dans des cellules distinctes, puis faire référence à ces cellules dans votre expression. |
Pour plus de lisibilité, vous pouvez définir les vecteurs et les rotations dans des cellules distinctes, puis faire référence à ces cellules dans votre expression. |
||
{{Top}} |
{{Top}} |
||
<span id="Matrix_functions"></span> |
|||
=== Fonctions matricielles === |
=== Fonctions matricielles === |
||
Line 364: | Line 384: | ||
{{incode|minvert(Placement)}} |
{{incode|minvert(Placement)}} |
||
{{Top}} |
{{Top}} |
||
<span id="Tuple_&_list"></span> |
|||
=== Tuple & liste === |
=== Tuple & liste === |
||
Line 372: | Line 393: | ||
{{incode|list(2; 1; 2)}} |
{{incode|list(2; 1; 2)}} |
||
{{Top}} |
{{Top}} |
||
<span id="Conditional_expressions"></span> |
|||
== Expressions conditionnelles == |
== Expressions conditionnelles == |
||
Line 400: | Line 422: | ||
|} |
|} |
||
{{Top}} |
{{Top}} |
||
<span id="Units"></span> |
|||
== Unités == |
== Unités == |
||
Line 413: | Line 436: | ||
Les unités suivantes sont reconnues par l’analyseur d’expression: |
Les unités suivantes sont reconnues par l’analyseur d’expression: |
||
<span id="Amount_of_substance"></span> |
|||
=== Quantité de substance === |
=== Quantité de substance === |
||
Line 454: | Line 478: | ||
|} |
|} |
||
<span id="Current"></span> |
|||
=== Courant === |
=== Courant === |
||
Line 473: | Line 498: | ||
|} |
|} |
||
<span id="Energy/work"></span> |
|||
=== Énergie/travail === |
=== Énergie/travail === |
||
Line 514: | Line 540: | ||
|} |
|} |
||
<span id="Length"></span> |
|||
===Longueur=== |
===Longueur=== |
||
Line 569: | Line 596: | ||
|} |
|} |
||
<span id="Luminous_intensity"></span> |
|||
=== Intensité lumineuse === |
=== Intensité lumineuse === |
||
Line 579: | Line 607: | ||
|} |
|} |
||
<span id="Mass"></span> |
|||
=== Poids === |
=== Poids === |
||
Line 619: | Line 648: | ||
|} |
|} |
||
<span id="Power"></span> |
|||
=== Puissance === |
=== Puissance === |
||
Line 632: | Line 662: | ||
|} |
|} |
||
<span id="Pressure"></span> |
|||
=== Pression === |
=== Pression === |
||
Line 669: | Line 700: | ||
|} |
|} |
||
<span id="Temperature"></span> |
|||
=== Température === |
=== Température === |
||
Line 688: | Line 720: | ||
|} |
|} |
||
<span id="Time"></span> |
|||
=== Temps === |
=== Temps === |
||
Line 714: | Line 747: | ||
|} |
|} |
||
<span id="Unsupported_units"></span> |
|||
=== Unités non supportées === |
=== Unités non supportées === |
||
Line 756: | Line 790: | ||
|} |
|} |
||
{{Top}} |
{{Top}} |
||
<span id="Invalid_characters_and_names"></span> |
|||
==Caractères et noms non valides== |
==Caractères et noms non valides== |
||
Line 762: | Line 797: | ||
Dans les cas où vous ne pouvez pas utiliser une étiquette, telle que le nom des contraintes d'une esquisse, vous devez savoir quels caractères ne sont pas autorisés. |
Dans les cas où vous ne pouvez pas utiliser une étiquette, telle que le nom des contraintes d'une esquisse, vous devez savoir quels caractères ne sont pas autorisés. |
||
<span id="Labels"></span> |
|||
===Étiquettes=== |
===Étiquettes=== |
||
Line 775: | Line 811: | ||
Par exemple, l'étiquette {{incode|Sketch\002}} doit être référencée comme {{incode|<<Sketch\\002>>}}. |
Par exemple, l'étiquette {{incode|Sketch\002}} doit être référencée comme {{incode|<<Sketch\\002>>}}. |
||
<span id="Names"></span> |
|||
===Noms=== |
===Noms=== |
||
Les [[Object_name/fr#Name_.28Nom.29|Noms]] d'objets tels que des dimensions, des croquis, etc |
Les [[Object_name/fr#Name_.28Nom.29|Noms]] d'objets tels que des dimensions, des croquis, etc. ne doivent pas avoir les caractères ou les séquences de caractères répertoriés ci-dessous, sinon le nom n'est pas valide: |
||
{| class="wikitable" |
{| class="wikitable" |
||
Line 806: | Line 843: | ||
'''Remarque:''' puisque des noms plus courts (surtout s'ils n'ont qu'un ou deux caractères) peuvent facilement entraîner des noms invalides, envisagez d'utiliser des noms plus longs et/ou d'établir une convention de dénomination appropriée. |
'''Remarque:''' puisque des noms plus courts (surtout s'ils n'ont qu'un ou deux caractères) peuvent facilement entraîner des noms invalides, envisagez d'utiliser des noms plus longs et/ou d'établir une convention de dénomination appropriée. |
||
<span id="Cell_aliases"></span> |
|||
===Alias de cellules=== |
===Alias de cellules=== |
||
Voir [[Spreadsheet_SetAlias/fr#Utilisation|Spreadsheet Alias]]. |
Voir [[Spreadsheet_SetAlias/fr#Utilisation|Spreadsheet Alias]]. |
||
{{Top}} |
{{Top}} |
||
<span id="Reference_to_CAD_data"></span> |
|||
== Référence aux données CAO == |
== Référence aux données CAO == |
||
Line 873: | Line 912: | ||
|} |
|} |
||
{{Top}} |
{{Top}} |
||
<span id="Document-wide_global_variables"></span> |
|||
== Variables globales == |
== 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 [[Spreadsheet Workbench/fr|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. |
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 [[Spreadsheet Workbench/fr|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. |
||
{{Top}} |
{{Top}} |
||
<span id="Cross-document_linking"></span> |
|||
== Liaison entre documents == |
== Liaison entre documents == |
||
Line 893: | Line 934: | ||
Bien sûr, vous pouvez charger les documents correspondants à tout moment pour y faire les modifications que vous voudrez. |
Bien sûr, vous pouvez charger les documents correspondants à tout moment pour y faire les modifications que vous voudrez. |
||
{{Top}} |
{{Top}} |
||
<span id="Known_issues_/_remaining_tasks"></span> |
|||
== Problèmes connus / tâches restantes == |
== Problèmes connus / tâches restantes == |
||
Revision as of 16:57, 30 January 2023
Vue d'ensemble
Il est possible de définir des propriétés à l'aide d'expressions mathématiques. Dans l'interface graphique, les zones de sélection numérique ou les champs de saisie liés aux propriétés contiennent une icône bleue . Cliquez sur l'icône ou tapez le signe égal = pour ouvrir l'éditeur d'expression pour cette propriété particulière.
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éparanr 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 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 en est qu'une expression comme 1in + 4
sera très probablement interprétée comme 1in + 4in
par les humains, mais comme toutes les unités sont converties au système SI en interne, le système n'est pas en mesure de deviner). Ces unités sont actuellement reconnues.
Vous pouvez utiliser des constantes prédéfinies et des fonctions.
Arguments de la fonction
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 arguments peuvent inclure des références à des cellules dans une feuille de calcul. Une référence de cellule se compose de la lettre en majuscule de la ligne de la cellule suivie de son numéro de colonne, par exemple A1
. Une cellule peut également être référencée en utilisant l'alias de la cellule, par exemple Spreadsheet.MyPartWidth
.
Référencement d'objets
Vous pouvez faire référence à un objet par sa DonnéesName ou sa DonnéesLabel. Dans le cas d'une DonnéesLabel, vous devez l'entourer de double symboles <<
et >>
, comme ceci <<Label>>
.
Vous pouvez référencer n'importe quelle propriété numérique d'un objet. Par exemple, pour référencer la hauteur d'un cylindre, vous pouvez utiliser Cylinder.Height
ou <<Long_name_of_cylinder>>.Height
. Pour faire référence à l'objet lui-même, utilisez la pseudo-propriété _self
. Par exemple, vous pouvez utiliser Cylinder._self
ou <<Label_of_cylinder>>._self
.
Pour référencer des objets de liste, utilisez <<object_label>>.list[list_index]
ou object_name.list[index_liste]
. Si vous souhaitez par exemple référencer une contrainte dans une esquisse, utilisez <<MySketch>>.Constraints[16]
. Si vous êtes dans la même esquisse, vous pouvez omettre son nom et utiliser simplement Constraints[16]
.
Remarque : l'index commence par 0, la contrainte 17 a donc l'index 16.
Pour plus d'informations sur le référencement des objets, voir Référence aux données CAO.
Constantes prises en charge
Les constantes suivantes sont prises en charge :
Constante | Description |
---|---|
e | nombre d'Euler |
pi | Pi |
Opérateurs pris en charge
Les opérateurs suivants sont pris en charge :
Opération | Description |
---|---|
+ | Addition |
- | Soustraction |
* | Multiplication |
/ | Division en virgule flottante |
% | Reste |
^ | Exponentiation |
Fonctions supportées
Fonctions mathématiques générales
Les fonctions mathématiques suivantes sont prises en charge :
Fonctions trigonométriques
Les fonctions trigonométriques utilisent le degré comme unité par défaut. Pour la mesure du radian, ajoutez rad
après la première valeur dans une expression. Ainsi, par exemple, cos(45)
est identique à cos(pi rad / 4)
. Les expressions en degrés peuvent utiliser soit deg
soit °
, par exemple 360deg - atan2(3 ; 4)
ou 360° - atan2(3 ; 4)
. Si une expression est sans unité et doit être convertie en degrés ou en radians pour des raisons de compatibilité, multipliez-la par 1 deg
, 1 °
ou 1 rad
selon le cas, par exemple (360 - X) * 1deg
; (360 - X) * 1°
; (0.5 + pi / 2) * 1rad
.
Fonction | Description | Plage de saisie |
---|---|---|
acos(x) | Arc cosinus | -1 <= x <= 1 |
asin(x) | Arc sinus | -1 <= x <= 1 |
atan(x) | Arc tangente, retourne la valeur dans la plage -90° < valeur < 90° | tout |
atan2(y; x) | atan2 de la comptabilité y/x pour le quadrant, retour de la valeur dans la plage -180° < valeur <= 180° | tout, l'entrée invalide x = y = 0 renvoie 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 impair |
tanh(x) | Tangente hyperbolique | tout |
hypot(x; y) | Somme pythagoricienne (hypoténuse), par ex. hypot(4; 3) = 5. | x et y >= 0 |
cath(x; y) | Étant donné l'hypoténuse, et un côté, donne l'autre côté du triangle, par ex. cath(5; 3) = 4. | x >= y >= 0 |
Fonctions exponentielles et logarithmiques
Fonction | Description | Plage de saisie |
---|---|---|
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 |
Fonctions d'arrondi, de troncature et de reste
Fonction | Description | Plage de saisie |
---|---|---|
abs(x) | Valeur absolue | tout |
ceil(x) | Partie entière par excès, la plus petite valeur entière supérieure ou égale à x | tout |
floor(x) | Partie entière, la plus grande valeur entière inférieure ou égale à x | tout |
mod(x; y) | Reste après la division de x par y, le signe du résultat est celui du dividende. | tout sauf y = 0 |
round(x) | Arrondi au nombre entier le plus proche | tout |
trunc(x) | Troncature au nombre entier le plus proche en direction de zéro | tout |
Statistiques et fonctions d'agrégation
Les fonctions d'agrégation prennent un ou plusieurs arguments.
Les arguments individuels pour agréger les fonctions peuvent être constitués de plages de cellules. Une plage de cellules est exprimée sous la forme de deux références de cellule séparées par deux points :
, par exemple average(B1:B8)
ou sum(A1:A4; B1:B4)
.
Les références de cellule peuvent également utiliser des alias de cellule, par exemple average(StartTemp:EndTemp)
.
Les fonctions d'agrégation suivantes sont prises en charge :
Fonction | Description | Plage de saisie |
---|---|---|
average(a; b; c; ...) | Valeur Moyenne des arguments, identique à sum(a; b; c; ...) / count(a; b; c; ...) | tout |
count(a; b; c; ...) | Comptage des arguments, généralement utilisé pour les plages de cellules | tout |
max(a; b; c; ...) | Valeur Maximum des arguments | tout |
min(a; b; c; ...) | Valeur Minimum des arguments | tout |
stddev(a; b; c; ...) | Écart type des valeurs des arguments | tout |
sum(a; b; c; ...) | Somme des valeurs des arguments, généralement utilisé pour les plages de cellules | tout |
Manipulation de chaînes de caractères
Identification de chaînes de caractères
Les chaînes de caractères sont identifiées dans les expressions en les entourant de doubles chevrons ouvrants/fermants (comme les étiquettes).
Dans l'exemple suivant, "TEXT" est reconnu comme une chaîne de caractères : <<TEXT>>
.
Concaténation de chaînes de caractères
Les chaînes de caractères peuvent être concaténées à l'aide du signe '+'.
L'exemple suivant <<MY>> + <<TEXT>>
sera concaténé en "MYTEXT".
Conversion de chaînes de caractères
Les valeurs numériques peuvent être converties en chaînes de caractères avec la fonction str
:
str(Box.Length.Value)
Formatage des chaînes de caractères
Le formatage des chaînes de caractères est pris en charge en utilisant le (vieux) style % de Python.
Tous les spécificateurs % tels que définis dans la documentation Python.
Par exemple, supposons que vous ayez un cube par défaut de 10mm de côté nommé "Box" (nomination par défaut de FreeCAD), l'expression suivante <<Cube length : %s>> % Box.Length
se développera en "Cube length : 10.0 mm"
Au dessus d'un spécificateur de %, utilisez la syntaxe suivante : <<Cube length is %s and width is %s>> % tuple(Box.Length; Box.Width)
. Ou utilisez la concaténation : <<Cube length is %s>> % Box.Length + << and width is %s>> % Box.Width
. Les deux se développeront en "Cube length is 10.0 mm and width is 10.0 mm".
Un exemple de fichier FreeCAD utilisant le formatage des chaînes de caractères est disponible dans le forum.
Créer une fonction
Les objets suivants peuvent être créés dans des expressions via la fonction create
:
- Vecteur
- Matrice
- Rotation
- Placement
La fonction create
transmet les arguments suivants au constructeur Python sous-jacent lors de la création de l'objet.
Diverses opérations mathématiques telles que la multiplication, l'addition et la soustraction sont prises en charge par les opérateurs mathématiques standard (par exemple, *
, +
, -
).
Vecteur
Lorsque create
reçoit <<vector>>
comme 1er argument, les 3 arguments suivants sont respectivement les coordonnées X, Y et Z de Vector
.
Exemple :
create(<<vector>>; 2; 1; 2)
Matrice
Lorsque create
reçoit <<matrix>>
comme 1er argument, les 16 arguments suivants sont les éléments de Matrix
dans l'ordre row-major (rang-majeur).
Exemple :
create(<<matrix>>; 1; 2; 3; 4; 5; 6; 7; 8; 9; 10; 11; 12; 13; 14; 15; 16)
Rotation
Lorsque create
reçoit <<rotation>>
comme 1er argument, il existe deux façons de créer une Rotation
:
1. Spécifiez un vecteur d'axe et un angle de rotation.
Exemple :
create(<<rotation>>; create(<<vector>>; 0; 1; 0); 45)
2. Spécifiez 3 rotations autour des axes X, Y et Z comme angles d'Euler.
Exemple :
create(<<rotation>>; 30; 30; 30)
Placement
Lorsque create
reçoit <<placement>>
comme 1er argument, il existe cinq façons de créer un Placement
.
Ces combinaisons possibles sont documentées dans le tableau ci-dessous et sont basées sur la page Placement API.
Nombre d'arguments | Description |
---|---|
2 | create(<<placement>>; Placement)
|
2 | create(<<placement>>; Matrix)
|
3 | create(<<placement>>; Base; Rotation)
|
4 | create(<<placement>>; Base; Rotation; Center)
|
4 | create(<<placement>>; Base; Axis; Angle)
|
L'exemple suivant montre la syntaxe pour créer un Placement
à partir d'une Base
(vecteur) et d'une Rotation
:
create(<<placement>>; create(<<vector>>; 2; 1; 2); create(<<rotation>>; create(<<vector>>; 0; 1; 0); 45))
Pour plus de lisibilité, vous pouvez définir les vecteurs et les rotations dans des cellules distinctes, puis faire référence à ces cellules dans votre expression.
Fonctions matricielles
mscale
Mettre à l'échelle une Matrice
avec un Vecteur
donné.
mscale(Matrix; Vector)
mscale(Matrix; x; y; z)
minvert
Inverse la Matrice
, Rotation
ou le Placement
donné.
minvert(Matrix)
minvert(Rotation)
minvert(Placement)
Tuple & liste
Vous pouvez créer des objets Python tuple
ou list
via leurs fonctions respectives.
tuple(2; 1; 2)
list(2; 1; 2)
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). Remarquez que le fait de mettre l'expression conditionnelle entre parenthèses est actuellement considéré comme une erreur.
Les opérateurs relationnels suivants sont définis:
Unité | Description |
---|---|
== | égal à |
!= | différent de |
> | 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.
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 dont le nom est celui d'une unité, vous devez mettre la variable entre << >>
pour éviter qu'elle ne soit reconnue comme une unité. Par exemple, si vous avez la dimension Sketch.Constraints.A
, elle serait reconnue comme l'unité Ampère. Par conséquent, vous devez l'écrire dans l'expression sous la forme Sketch.Constraints.<<A>>
.
Les unités suivantes sont reconnues par l’analyseur d’expression:
Quantité de substance
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; alternative à l'unité ″ |
″ | Seconde d'arc; alternative à l'unité S |
M | Minute d'arc; alternative à l'unité ′ |
′ | Minute d'arc; alternative à l'unité M |
Courant
Unité | Description |
---|---|
mA | Milliampère |
A | Ampère |
kA | Kiloampère |
MA | Mégaampère |
Énergie/travail
Unité | Description |
---|---|
J | Joule |
Ws | Watt-seconde; alternative à l'unité Joule |
VAs | Volt ampère seconde; 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é um |
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; alternative à l'unité " |
" | pouce; alternative à l'unité in |
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; 1 Torr = 133.32 Pa |
psi | Livre-force par pouce carré; 1 psi = 6.895 kPa |
ksi | Kilolivre-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 |
Volume
Unité | Description |
---|---|
l | Litre |
Unités non supportées
Les unités suivantes, couramment utilisées, ne sont pas encore prises en charge ; pour certaines, une alternative est proposée :
Unité | Description | Alternative |
---|---|---|
°C | Celsius | [°C] + 273.15 K |
°F | Fahrenheit; | ([°F] + 459.67) × 5/9 |
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 |
sr | Steradian | Pas directement |
lm | Lumen | Pas directement |
lx | Lux | Pas directement |
px | Pixel | Pas directement |
Caractères et noms non valides
La fonction expression est très puissante mais pour atteindre cette puissance, elle présente certaines limitations concernant certains caractères. Pour surmonter cela, FreeCAD propose d'utiliser des étiquettes et de les référencer à la place des noms d'objets. Dans les étiquettes, vous pouvez utiliser presque tous les caractères spéciaux.
Dans les cas où vous ne pouvez pas utiliser une étiquette, telle que le nom des contraintes d'une esquisse, vous devez savoir quels caractères ne sont pas autorisés.
Étiquettes
Pour les étiquettes, il n'y a pas de caractères non valides, cependant certains caractères doivent être évités:
Caractères | Description |
---|---|
' , \ , "
|
Doivent être évités en ajoutant \ devant eux.
|
Par exemple, l'étiquette Sketch\002
doit être référencée comme <<Sketch\\002>>
.
Noms
Les Noms d'objets tels que des dimensions, des croquis, etc. ne doivent pas avoir les caractères ou les séquences de caractères répertoriés ci-dessous, sinon le nom n'est pas valide:
Caractères / Séquences de caractères | Description |
---|---|
+, -, *, /, ^, _, <, >, (, ), {, }, [, ], ., ,, = | Caractères qui sont des opérateurs mathématiques ou qui font partie de constructions mathématiques |
A, kA, mA, MA, C, G, F, uF, µF, J, K, ' , ft , ° et bien d'autres! | Caractères et séquences de caractères qui sont des unités (voir le paragraphe unités) |
#, !, ?, §, $, %, &, :, ;, \, |, ~, ∆, ¿, and many more! | Caractères utilisés comme espace réservé ou pour déclencher des opérations spéciales |
pi, e | Constantes mathématiques |
´, `, ' , " | Caractères utilisés pour les accents |
espace | Un espace définit la fin d'un nom et ne peut donc pas être utilisé |
Par exemple, le nom suivant est valide: <<Sketch>>.Constraints.T2üßµ@
, alors que ces noms sont non valables: <<Sketch>>.Constraints.test\result_2
(\r signifie "retour chariot") ou <<Sketch>>.Constraints.mol
(mol est une unité).
Remarque: puisque des noms plus courts (surtout s'ils n'ont qu'un ou deux caractères) peuvent facilement entraîner des noms invalides, envisagez d'utiliser des noms plus longs et/ou d'établir une convention de dénomination appropriée.
Alias de cellules
Voir Spreadsheet Alias.
Référence aux données CAO
Il est possible d'utiliser les données du modèle lui-même dans une expression. Pour référencer une propriété, utilisez object.property
. Si la propriété est un composé de champs, les champs individuels sont accessibles en tant que object.property.field
.
Le tableau suivant montre quelques exemples :
Données CAO | Appel dans l'expression | Résultat |
---|---|---|
Longueur d'un Part Cube | Box.Length
|
Longueur avec unités (mm) |
Volume du Cube | Box.Shape.Volume
|
Volume en mm³ ; sans unités |
Type de forme du Cube | Box.Shape.ShapeType
|
String : Solide |
Etiquette du Cube | Box.Label
|
String : Label |
Coordonnée X du centre de masse du Cube | Box.Shape.CenterOfMass.x
|
Coordonnée X en mm sans unité |
Coordonnée X de l'emplacement du Cube | Box.Placement.Base.x
|
Coordonnée X avec unités (mm) |
Composante X de l'axe de rotation du placement du Cube | Box.Placement.Rotation.Axis.x
|
Composante X du vecteur unitaire en mm sans unités |
Angle de rotation du placement du Cube | Box.Placement.Rotation.Angle
|
Angle de rotation avec unités (deg) |
Objet Cube complet | Box._self
|
Objet de type <Part::PartFeature>>. |
Valeur de la contrainte dans une esquisse | Constraints.Width
|
Valeur numérique de la contrainte nommée Width dans l'esquisse, si l'expression est utilisée dans l'esquisse elle-même.
|
Valeur de la contrainte dans une esquisse | MonSketch.Constraints.Width
|
Valeur numérique de la contrainte nommée Width dans l'esquisse, si l'expression est utilisée en dehors de l'esquisse.
|
Valeur d'un alias de feuille de calcul | Spreadsheet.Depth
|
Valeur de l'alias Depth dans la feuille de calcul Spreadsheet .
|
Valeur d'une propriété locale | Length
|
Valeur de la propriété DonnéesLength dans, par exemple, un objet Pad, si l'expression est utilisée dans, par exemple, DonnéesLength2 dans le même objet. |
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 DonnéesLength 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
Remarque: 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, l'un pour contrôler votre modèle et l'autre pour faire des 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. - Comme indiqué ci-dessus, malheureusement, le vérificateur intégré prétend parfois qu'un nom valide n'existe pas. Continuez à taper quand même. Une fois la référence complète terminée, le bouton OK devient actif.
- FreeCAD ne dispose pas encore d'un gestionnaire d'expressions intégré où toutes les expressions d'un document sont listées et peuvent être créées, supprimées, interrogées etc... Une extension est disponible : fcxref expression manager.
- les bogues et tickets ouverts pour les expressions sont référencés sur le Bugtracker de Freecad, catégorie Expressions
- Scripts FreeCAD : Python, Introduction à Python, Tutoriel sur les scripts Python, Débuter avec les scripts
- Modules : Modules intégrés, Unités, Quantity
- Ateliers : Création d'atelier, Commands Gui, Les commandes, Installer des ateliers supplémentaires
- Maillages et objets Parts : Scripts Mesh, Script de données topologiques, Conversion objet Mesh en Part, PythonOCC
- Objets paramétriques : Objets créés par script, Viewproviders (Icône personnalisée dans l'arborescence)
- Scénographie : Graphe de scène Coin (Inventor), Pivy
- Interface graphique : Création d'interface, Création d'une boite de dialogue (1, 2, 3, 4, 5), PySide, Exemples PySide débutant, intermédiaire, expérimenté
- Macros : Macros, Comment installer des macros
- Intégration : Intégrer FreeCAD, Intégration de FreeCADGui
- Autre : Expressions, Extraits de codes, Fonction - tracer une ligne, Bibliothèque mathématique vectorielle de FreeCAD (déprécié)