Difference between revisions of "Spreadsheet Workbench/fr"

From FreeCAD Documentation
Jump to navigation Jump to search
(Updating to match new version of source page)
Line 1: Line 1:
 
<languages/>
 
<languages/>
 +
<div class="mw-translate-fuzzy">
 
{{Docnav/fr
 
{{Docnav/fr
 
|[[Sketcher Workbench/fr|Atelier Sketcher]]
 
|[[Sketcher Workbench/fr|Atelier Sketcher]]
Line 6: Line 7:
 
|IconR=Workbench_Start.svg
 
|IconR=Workbench_Start.svg
 
}}
 
}}
 +
</div>
  
 
[[Image:Workbench_Spreadsheet.svg|thumb|128px|Icône de l'atelier Spreadsheet]]
 
[[Image:Workbench_Spreadsheet.svg|thumb|128px|Icône de l'atelier Spreadsheet]]
Line 11: Line 13:
 
== Introduction ==
 
== Introduction ==
  
 +
<div class="mw-translate-fuzzy">
 
L'[[Image:Workbench_Spreadsheet.svg|24px]] [[Spreadsheet Workbench/fr|atelier Spreadsheet]] vous permet de créer et d’éditer des feuilles de calcul, de remplir la feuille de calcul avec les données extraites d’un modèle, d’effectuer des calculs et de les exporter vers d’autres applications de tableurs telles que LibreOffice ou Microsoft Excel.
 
L'[[Image:Workbench_Spreadsheet.svg|24px]] [[Spreadsheet Workbench/fr|atelier Spreadsheet]] vous permet de créer et d’éditer des feuilles de calcul, de remplir la feuille de calcul avec les données extraites d’un modèle, d’effectuer des calculs et de les exporter vers d’autres applications de tableurs telles que LibreOffice ou Microsoft Excel.
 +
</div>
  
 
{{TOCright}}
 
{{TOCright}}
Line 43: Line 47:
 
* {{Button|Noir}} et {{Button|Blanc}} définissent les couleurs de premier plan et d'arrière-plan des cellules sélectionnées.
 
* {{Button|Noir}} et {{Button|Blanc}} définissent les couleurs de premier plan et d'arrière-plan des cellules sélectionnées.
  
 +
<div class="mw-translate-fuzzy">
 +
=== Propriétés d'une cellule ===
 +
</div>
 +
 +
Les propriétés d'un cellule de feuille de calcul peuvent être éditées avec un clic-droit sur la cellule. La boîte de dialogue suivante apparaît :
 +
 +
[[File:SpreadsheetCellPropDialog.png]]
 +
 +
Comme mentionné dans les onglets, les propriétés suivantes peuvent être changées :
 +
 +
<div class="mw-translate-fuzzy">
 +
* Couleur: couleur du texte et couleur d'arrière-plan
 +
* Alignement: alignement horizontal et vertical du texte
 +
* Style: style du texte : gras, italique, souligné
 +
* Affichage unités: <span id="units_tab"></span> affiche l'unité de la cellule. Veuillez lire la section [[#Unités|Unités]] ci-dessous.
 +
* Alias : <span id="alias_name"></span> défini un nom pour la cellule. Ce nom peut être utilisé dans les formules des cellules ainsi que dans les expressions FreeCAD. Voir [[#Donn.C3.A9es_de_la_feuille_de_calcul_dans_les_expressions|Données de la feuille de calcul dans les expressions]] ci-dessous pour plus d'informations sur le sujet.
 +
</div>
 +
 +
<div class="mw-translate-fuzzy">
 
== Expressions dans les cellules ==
 
== Expressions dans les cellules ==
 +
</div>
  
 +
<div class="mw-translate-fuzzy">
 
Une cellule de feuille de calcul peut contenir du texte arbitraire ou une expression. Techniquement, les expressions doivent commencer par un signe égal '='. Cependant, le tableur tente d’être intelligent ; si vous entrez ce qui ressemble à une expression sans le signe '=', celui-ci sera ajouté automatiquement.
 
Une cellule de feuille de calcul peut contenir du texte arbitraire ou une expression. Techniquement, les expressions doivent commencer par un signe égal '='. Cependant, le tableur tente d’être intelligent ; si vous entrez ce qui ressemble à une expression sans le signe '=', celui-ci sera ajouté automatiquement.
 +
</div>
  
 +
<div class="mw-translate-fuzzy">
 
Les expressions cellulaires peuvent contenir des nombres, des fonctions, des références à d'autres cellules et des références à des propriétés du modèle (voir toutefois les [[#Limitations Courantes|limitations courantes]] ci-dessous). Les cellules sont référencées par leur colonne (lettre CAPITALE) et leur rangée (nombre). Une cellule peut également être référencée par son [[#alias_name|alias]] (ci-dessous). Exemple: B4 + A6
 
Les expressions cellulaires peuvent contenir des nombres, des fonctions, des références à d'autres cellules et des références à des propriétés du modèle (voir toutefois les [[#Limitations Courantes|limitations courantes]] ci-dessous). Les cellules sont référencées par leur colonne (lettre CAPITALE) et leur rangée (nombre). Une cellule peut également être référencée par son [[#alias_name|alias]] (ci-dessous). Exemple: B4 + A6
 +
</div>
  
 
'''Remarque:''' Les expressions de cellule sont traitées par FreeCAD comme du code de programmation. Par conséquent, lorsque vous modifiez une cellule, vous voyez que le contenu ne suit pas vos paramètres d'affichage:
 
'''Remarque:''' Les expressions de cellule sont traitées par FreeCAD comme du code de programmation. Par conséquent, lorsque vous modifiez une cellule, vous voyez que le contenu ne suit pas vos paramètres d'affichage:
Line 53: Line 81:
 
* le nombre de décimales affichées peut différer de vos [[Preferences_Editor/fr#Unit.C3.A9s|paramètres de préférences]]
 
* le nombre de décimales affichées peut différer de vos [[Preferences_Editor/fr#Unit.C3.A9s|paramètres de préférences]]
  
 +
<div class="mw-translate-fuzzy">
 
Les références aux objets d'un modèle sont expliquées sous [[#R.C3.A9f.C3.A9rences_aux_donn.C3.A9es_CAO|Références aux données CAO]] ci-dessous. L'utilisation des valeurs de cellule de la feuille de calcul pour définir les propriétés du modèle est expliquée dans [[#Donn.C3.A9es_de_la_feuille_de_calcul_dans_les_expressions|Données de la feuille de calcul dans les expressions]] ci-dessous. Pour plus de détails sur la manière dont les expressions sont formées, voir [[Expressions/fr|Expressions]].
 
Les références aux objets d'un modèle sont expliquées sous [[#R.C3.A9f.C3.A9rences_aux_donn.C3.A9es_CAO|Références aux données CAO]] ci-dessous. L'utilisation des valeurs de cellule de la feuille de calcul pour définir les propriétés du modèle est expliquée dans [[#Donn.C3.A9es_de_la_feuille_de_calcul_dans_les_expressions|Données de la feuille de calcul dans les expressions]] ci-dessous. Pour plus de détails sur la manière dont les expressions sont formées, voir [[Expressions/fr|Expressions]].
 +
</div>
  
== Fonctions supportées ==
+
<div class="mw-translate-fuzzy">
 
 
Les fonctions trigonométriques standard et autres fonctions mathématiques courantes ainsi que les fonctions d'agrégation statistique sont prises en charge (voir [[Expressions/fr|Expressions)]].
 
 
 
 
== Interaction entre les feuilles de calcul et l'objet CAO ==
 
== Interaction entre les feuilles de calcul et l'objet CAO ==
 +
</div>
  
 +
<div class="mw-translate-fuzzy">
 
Les données contenues dans les cellules d'une feuille de calcul peuvent être utilisées dans les expressions de paramètres de modèle de CAO. Ainsi, une feuille de calcul peut être utilisée comme source pour les valeurs de paramètres utilisées dans un modèle, regroupant efficacement les valeurs à un endroit. Lorsque les valeurs sont modifiées dans la feuille de calcul, elles sont propagées dans tout le modèle.
 
Les données contenues dans les cellules d'une feuille de calcul peuvent être utilisées dans les expressions de paramètres de modèle de CAO. Ainsi, une feuille de calcul peut être utilisée comme source pour les valeurs de paramètres utilisées dans un modèle, regroupant efficacement les valeurs à un endroit. Lorsque les valeurs sont modifiées dans la feuille de calcul, elles sont propagées dans tout le modèle.
 +
</div>
  
De même, les propriétés des objets de modèle CAO peuvent être utilisées dans les expressions des cellules de la feuille de calcul. Cela permet d'utiliser des propriétés d'objet telles que le volume ou la surface dans la feuille de calcul. Si le nom d'un objet dans le modèle CAO est modifié, le changement sera automatiquement propagé à toutes les références dans les expressions de feuille de calcul en utilisant le nom qui a été modifié.  
+
<div class="mw-translate-fuzzy">
 +
De même, les propriétés des objets de modèle CAO peuvent être utilisées dans les expressions des cellules de la feuille de calcul. Cela permet d'utiliser des propriétés d'objet telles que le volume ou la surface dans la feuille de calcul. Si le nom d'un objet dans le modèle CAO est modifié, le changement sera automatiquement propagé à toutes les références dans les expressions de feuille de calcul en utilisant le nom qui a été modifié.
 +
</div>
  
 
Plusieurs feuilles de calcul peuvent être utilisées dans un document. Une feuille de calcul peut être identifiée à l'aide de son nom ou de son étiquette.
 
Plusieurs feuilles de calcul peuvent être utilisées dans un document. Une feuille de calcul peut être identifiée à l'aide de son nom ou de son étiquette.
  
 +
<div class="mw-translate-fuzzy">
 
FreeCAD attribuera automatiquement un nom unique à une feuille de calcul lors de sa création. Ces noms suivent le modèle {{incode|Spreadsheet}}, {{incode|Spreadsheet001}}, {{incode|Spreadsheet002}} et ainsi de suite. Le nom ne peut pas être modifié manuellement et il n'est pas visible dans les propriétés de la feuille de calcul. Il peut être utilisé pour faire référence à la feuille de calcul dans une [[Expressions/fr|Expression]] (voir [[#Donn.C3.A9es_de_la_feuille_de_calcul_dans_les_expressions|Données de la feuille de calcul dans les expressions]] ci-dessous.)
 
FreeCAD attribuera automatiquement un nom unique à une feuille de calcul lors de sa création. Ces noms suivent le modèle {{incode|Spreadsheet}}, {{incode|Spreadsheet001}}, {{incode|Spreadsheet002}} et ainsi de suite. Le nom ne peut pas être modifié manuellement et il n'est pas visible dans les propriétés de la feuille de calcul. Il peut être utilisé pour faire référence à la feuille de calcul dans une [[Expressions/fr|Expression]] (voir [[#Donn.C3.A9es_de_la_feuille_de_calcul_dans_les_expressions|Données de la feuille de calcul dans les expressions]] ci-dessous.)
 +
</div>
  
 
L'étiquette d'une feuille de calcul est automatiquement définie sur le nom de la feuille de calcul lors de sa création. Contrairement au nom, l'étiquette peut être modifiée, par exemple dans le panneau des propriétés ou à l'aide de l'action Renommer du menu contextuel. Notez que l'étiquette d'une feuille de calcul dans un document doit être unique. Si vous essayez de changer l'étiquette en une étiquette déjà utilisée par une autre feuille de calcul, FreeCAD n'acceptera pas la nouvelle étiquette.
 
L'étiquette d'une feuille de calcul est automatiquement définie sur le nom de la feuille de calcul lors de sa création. Contrairement au nom, l'étiquette peut être modifiée, par exemple dans le panneau des propriétés ou à l'aide de l'action Renommer du menu contextuel. Notez que l'étiquette d'une feuille de calcul dans un document doit être unique. Si vous essayez de changer l'étiquette en une étiquette déjà utilisée par une autre feuille de calcul, FreeCAD n'acceptera pas la nouvelle étiquette.
  
 +
<div class="mw-translate-fuzzy">
 
FreeCAD vérifie les dépendances cycliques. Voir [[Spreadsheet_Workbench/fr#Limitations Courantes|limitations courantes]].
 
FreeCAD vérifie les dépendances cycliques. Voir [[Spreadsheet_Workbench/fr#Limitations Courantes|limitations courantes]].
 +
</div>
  
=== Propriétés d'une cellule ===
+
<div class="mw-translate-fuzzy">
 
 
Les propriétés d'un cellule de feuille de calcul peuvent être éditées avec un clic-droit sur la cellule. La boîte de dialogue suivante apparaît :
 
 
 
[[File:SpreadsheetCellPropDialog.png]]
 
 
 
Comme mentionné dans les onglets, les propriétés suivantes peuvent être changées :
 
 
 
* Couleur: couleur du texte et couleur d'arrière-plan
 
* Alignement: alignement horizontal et vertical du texte
 
* Style: style du texte : gras, italique, souligné
 
* Affichage unités: <span id="units_tab"></span> affiche l'unité de la cellule. Veuillez lire la section [[#Unités|Unités]] ci-dessous.
 
* Alias : <span id="alias_name"></span> défini un nom pour la cellule. Ce nom peut être utilisé dans les formules des cellules ainsi que dans les expressions FreeCAD. Voir [[#Donn.C3.A9es_de_la_feuille_de_calcul_dans_les_expressions|Données de la feuille de calcul dans les expressions]] ci-dessous pour plus d'informations sur le sujet.
 
 
 
 
=== Références aux données CAO ===
 
=== Références aux données CAO ===
 +
</div>
  
 
Comme indiqué ci-dessus, il est possible de référencer les données du modèle CAO dans des expressions de feuille de calcul.
 
Comme indiqué ci-dessus, il est possible de référencer les données du modèle CAO dans des expressions de feuille de calcul.
  
 +
<div class="mw-translate-fuzzy">
 
Les expressions calculées dans les cellules de la feuille de calcul commencent par un signe égal ('='). Cependant, le mécanisme de saisie du tableur tente d’être astucieux. Une expression peut être entrée sans le signe '='. Si la chaîne entrée est une expression valide, un '=' est automatiquement ajouté lors de la frappe de la touche {{KEY|Valider}}. Si la chaîne entrée n'est pas une expression valide (souvent le résultat d'une saisie avec une casse incorrecte, par exemple "MonCube.longueur" à la place de "MonCube.Longueur"), aucun '=' n'est ajouté et cela est traité comme une simple chaîne de texte.
 
Les expressions calculées dans les cellules de la feuille de calcul commencent par un signe égal ('='). Cependant, le mécanisme de saisie du tableur tente d’être astucieux. Une expression peut être entrée sans le signe '='. Si la chaîne entrée est une expression valide, un '=' est automatiquement ajouté lors de la frappe de la touche {{KEY|Valider}}. Si la chaîne entrée n'est pas une expression valide (souvent le résultat d'une saisie avec une casse incorrecte, par exemple "MonCube.longueur" à la place de "MonCube.Longueur"), aucun '=' n'est ajouté et cela est traité comme une simple chaîne de texte.
 +
</div>
  
 
'''Remarque:''' le comportement ci-dessus (insertion automatique de '=') a des travers désagréables :
 
'''Remarque:''' le comportement ci-dessus (insertion automatique de '=') a des travers désagréables :
Line 97: Line 123:
 
* Si vous faites une erreur lors de la saisie du nom dans la colonne d'étiquette et souhaitez le corriger, vous ne pouvez pas le changer simplement en nom d'alias. Au lieu de cela, vous devez d'abord remplacer le nom d'alias par un autre nom, puis corriger le nom du texte dans la colonne d'étiquette, puis remplacer le nom d'alias dans la colonne de valeur par son nom d'origine.
 
* Si vous faites une erreur lors de la saisie du nom dans la colonne d'étiquette et souhaitez le corriger, vous ne pouvez pas le changer simplement en nom d'alias. Au lieu de cela, vous devez d'abord remplacer le nom d'alias par un autre nom, puis corriger le nom du texte dans la colonne d'étiquette, puis remplacer le nom d'alias dans la colonne de valeur par son nom d'origine.
  
 +
<div class="mw-translate-fuzzy">
 
Une façon d'éviter ces problèmes consiste à préfixer les étiquettes de texte correspondant aux noms d'alias avec une chaîne fixe, les rendant ainsi différentes. Notez que "_" ne fonctionnera pas, car il est converti en "=". Cependant, un blanc, bien qu'invisible, fonctionnera.
 
Une façon d'éviter ces problèmes consiste à préfixer les étiquettes de texte correspondant aux noms d'alias avec une chaîne fixe, les rendant ainsi différentes. Notez que "_" ne fonctionnera pas, car il est converti en "=". Cependant, un blanc, bien qu'invisible, fonctionnera.
 +
</div>
  
 
Le tableau suivant montre quelques exemples en supposant que le modèle a une fonctionnalité nommée "MonCube" :
 
Le tableau suivant montre quelques exemples en supposant que le modèle a une fonctionnalité nommée "MonCube" :
Line 126: Line 154:
 
  |}
 
  |}
  
 +
<div class="mw-translate-fuzzy">
 
=== Données de la feuille de calcul dans les expressions ===
 
=== Données de la feuille de calcul dans les expressions ===
 +
</div>
  
 
Pour utiliser les données de la feuille de calcul dans d'autres parties de FreeCAD, vous allez généralement créer une [[Expressions/fr|Expression]] qui fait référence à la feuille de calcul et à la cellule contenant les données que vous souhaitez utiliser. Vous pouvez identifier les feuilles de calcul par le nom ou par l'étiquette, et vous pouvez identifier les cellules par leur position ou par leur alias. L'autocomplétion est disponible pour toutes les formes de référencement.
 
Pour utiliser les données de la feuille de calcul dans d'autres parties de FreeCAD, vous allez généralement créer une [[Expressions/fr|Expression]] qui fait référence à la feuille de calcul et à la cellule contenant les données que vous souhaitez utiliser. Vous pouvez identifier les feuilles de calcul par le nom ou par l'étiquette, et vous pouvez identifier les cellules par leur position ou par leur alias. L'autocomplétion est disponible pour toutes les formes de référencement.
Line 153: Line 183:
  
 
Bien que vous puissiez utiliser le numéro de ligne et de colonne dans une expression pour référencer une cellule, la meilleure pratique consiste à donner à la cellule un nom d'alias et à l'utiliser. Voir [[#Propri.C3.A9t.C3.A9s_d.27une_cellule|Propriétés d'une cellule]] ci-dessus pour savoir comment définir l'alias. Par exemple, si les données de la cellule B1 contenaient le paramètre de longueur pour un objet, un nom d'alias de {{incode|MyObject_Length}} permettrait à la valeur d'être appelée {{incode|<<MyParams>>.MyObject_Length}} au lieu de {{incode|Spreadsheet.B1}}. En plus d'être beaucoup plus faciles à lire et à comprendre, les noms d'alias sont également beaucoup plus faciles à modifier si vous décidez d'ajuster la structure de votre feuille de calcul. L'utilisation d'un alias présente également l'avantage qu'il est plus facile de voir quelles cellules sont utilisées pour contrôler d'autres parties du document. Notez que FreeCAD ajustera automatiquement les références de position dans les expressions si vous insérez ou supprimez des lignes et des colonnes dans la feuille de calcul, donc même si vous utilisez des numéros de ligne et de colonne dans une expression, vous pouvez insérer des lignes et des colonnes sans casser les références aux cellules environnantes.  
 
Bien que vous puissiez utiliser le numéro de ligne et de colonne dans une expression pour référencer une cellule, la meilleure pratique consiste à donner à la cellule un nom d'alias et à l'utiliser. Voir [[#Propri.C3.A9t.C3.A9s_d.27une_cellule|Propriétés d'une cellule]] ci-dessus pour savoir comment définir l'alias. Par exemple, si les données de la cellule B1 contenaient le paramètre de longueur pour un objet, un nom d'alias de {{incode|MyObject_Length}} permettrait à la valeur d'être appelée {{incode|<<MyParams>>.MyObject_Length}} au lieu de {{incode|Spreadsheet.B1}}. En plus d'être beaucoup plus faciles à lire et à comprendre, les noms d'alias sont également beaucoup plus faciles à modifier si vous décidez d'ajuster la structure de votre feuille de calcul. L'utilisation d'un alias présente également l'avantage qu'il est plus facile de voir quelles cellules sont utilisées pour contrôler d'autres parties du document. Notez que FreeCAD ajustera automatiquement les références de position dans les expressions si vous insérez ou supprimez des lignes et des colonnes dans la feuille de calcul, donc même si vous utilisez des numéros de ligne et de colonne dans une expression, vous pouvez insérer des lignes et des colonnes sans casser les références aux cellules environnantes.  
 
{{Version/fr|0.16}}
 
  
 
</div>
 
</div>
 
</div>
 
</div>
  
<!--
+
=== Complex models and recomputes ===
REMARQUE: les captures d'écran dans le texte suivant sont trompeuses car elles suggèrent un nom de feuille de calcul modifiable. Comme ils ne sont pas vraiment spécifiques à l'édition de feuilles de calcul, mais expliquent plutôt comment utiliser la fonction de saisie semi-automatique, je les ai omis du paragraphe réécrit.
 
 
 
L'utilisation des données de la feuille de calcul dans d'autres objets de FreeCAD nécessite un nom complètement défini. Parce qu'il est possible d'avoir plus d'une feuille de calcul dans un document, le nom de la feuille ainsi que celui de la cellule (coordonnées ou alias) sont obligatoires. L'image suivante illustre l'utilisation de l'alias "number" dans la feuille "MySheet" dans une expression dans l'atelier Part-Design.
 
 
 
[[File:Expression usage1.png]]
 
 
 
Taper un "M" affiche une liste de noms disponibles (ci-dessus). Les touches fléchées permettent de descendre dans "MySheet" et de le sélectionner; {{KEY|Enter}} entraînera son exécution dans l'expression. Vous pouvez également continuer à taper ou cliquer sur l'entrée avec la souris.
 
 
 
[[File:Expression usage2.png]]
 
 
 
Taper un "n" affiche maintenant la liste des noms d’alias disponibles dans MySheet commençant par "n" (ci-dessus). "number" peut maintenant être sélectionné comme décrit ci-dessus. Une fois qu'un nom valide avec un contenu utilisable est entré, le champ de résultat affiche la valeur calculée. dans ce cas, la longueur (ci-dessous).
 
  
[[File:Expression usage3.png]]
+
Editing a spreadsheet will trigger a recompute of the 3D model, even if the changes do not affect the model. For a complex model a recompute can take a long time, and having to wait after every single edit is of course quite annoying.
  
Si vous tapez davantage, par exemple en ajoutant un signe "+", vous obtiendrez une expression qui ne sera plus valide, ce qui sera indiqué. Continuer à compléter l'expression peut à nouveau générer une expression valide.
+
There are three solutions to deal with this:
-->
+
# Temporarily skip recomputes:
 +
#* Right-click the document node in the [[Tree_view|Tree view]].
 +
#* Select the {{MenuCommand|Skip recomputes}} option from the context menu.
 +
#* There is a big disadvantage to this solution. New values entered in the spreadsheet will not be displayed until the document is recomputed. Instead {{incode|#PENDING}} is shown.
 +
#* You can either recompute manually, using the [[Std_Refresh|Std Refresh]] command, or disable {{MenuCommand|Skip recomputes}} when you are done editing.
 +
# Use a macro to automatically skip recomputes while editing a spreadsheet:
 +
#* Download and run [https://forum.freecadweb.org/viewtopic.php?f=8&t=48600#p419301 skipSheet.FCMacro].
 +
#* This solution saves a few steps compared to the first solution, but also has the mentioned disadvantage.
 +
# Put the spreadsheet in a separate file:
 +
#* You can reference spreadsheet data from an external file with this syntax: {{incode|<nowiki>=NameOfFile#<<MySpreadsheet>>.MyAlias</nowiki>}}.
 +
#* The advantage of having the spreadsheet in another file over switching off recomputes is that the spreadsheet itself does get recomputed.
 +
#* The disadvantage is that the model won't automatically recompute after changes to the spreadsheet.
 +
#* In the scenario where you first open the 'spreadsheet' file, change one or more values and then open the 'model' file, there won't be any indication that the model needs to be recomputed. But if both files are open the [[Std_Refresh|Std Refresh]] icon will update correctly for the 'model' file after changes to the 'spreadsheet' file.
  
 
== Unités ==
 
== Unités ==
  
 +
<div class="mw-translate-fuzzy">
 
Le tableur intègre une notion de dimension (unités) associée aux valeurs de cellule. Un numéro entré sans unité associée n'a pas de dimension. L'unité doit être entrée immédiatement après la valeur numérique, sans espace intermédiaire. Si un nombre a une unité associée, cette unité sera utilisée dans tous les calculs. Par exemple, la multiplication de deux longueurs avec l'unité mm donne une surface avec l'unité mm².
 
Le tableur intègre une notion de dimension (unités) associée aux valeurs de cellule. Un numéro entré sans unité associée n'a pas de dimension. L'unité doit être entrée immédiatement après la valeur numérique, sans espace intermédiaire. Si un nombre a une unité associée, cette unité sera utilisée dans tous les calculs. Par exemple, la multiplication de deux longueurs avec l'unité mm donne une surface avec l'unité mm².
 +
</div>
  
 +
<div class="mw-translate-fuzzy">
 
Si une cellule contient une valeur qui représente une dimension, vous devez la saisir avec son unité associée. Bien que dans de nombreux cas simples, on puisse se débrouiller avec une valeur sans dimension, il est déconseillé de ne pas entrer l'unité. Si une valeur représentant une dimension est entrée sans son unité associée, certaines séquences d'opérations obligent FreeCAD à alerter sur les unités incompatibles dans une expression lorsqu'il apparaît que celle-ci doit être validée. (Cela peut être mieux compris en consultant ce [https://forum.freecadweb.org/viewtopic.php?f=3&t=34713&p=292455#p292438 sujet (en)] dans les forums FreeCAD.)
 
Si une cellule contient une valeur qui représente une dimension, vous devez la saisir avec son unité associée. Bien que dans de nombreux cas simples, on puisse se débrouiller avec une valeur sans dimension, il est déconseillé de ne pas entrer l'unité. Si une valeur représentant une dimension est entrée sans son unité associée, certaines séquences d'opérations obligent FreeCAD à alerter sur les unités incompatibles dans une expression lorsqu'il apparaît que celle-ci doit être validée. (Cela peut être mieux compris en consultant ce [https://forum.freecadweb.org/viewtopic.php?f=3&t=34713&p=292455#p292438 sujet (en)] dans les forums FreeCAD.)
 +
</div>
  
 +
<div class="mw-translate-fuzzy">
 
Vous pouvez modifier les unités affichées pour une valeur de cellule à l'aide de l'onglet Unités de la boîte de dialogue Propriétés [[#Unit.C3.A9s|Unités]] (ci-dessus). Cela ne change pas la valeur contenue dans la cellule; il ne convertit que la valeur existante pour l'affichage. La valeur utilisée pour les calculs ne change pas et les résultats des formules utilisant cette valeur ne changent pas. Par exemple, une cellule contenant la valeur "5.08cm" peut être affichée sous la forme "2in" en modifiant la valeur de l'onglet des unités en "in".
 
Vous pouvez modifier les unités affichées pour une valeur de cellule à l'aide de l'onglet Unités de la boîte de dialogue Propriétés [[#Unit.C3.A9s|Unités]] (ci-dessus). Cela ne change pas la valeur contenue dans la cellule; il ne convertit que la valeur existante pour l'affichage. La valeur utilisée pour les calculs ne change pas et les résultats des formules utilisant cette valeur ne changent pas. Par exemple, une cellule contenant la valeur "5.08cm" peut être affichée sous la forme "2in" en modifiant la valeur de l'onglet des unités en "in".
 +
</div>
  
 +
<div class="mw-translate-fuzzy">
 
Un nombre sans dimension ne peut pas être changé en nombre avec une unité dans la boîte de dialogue des propriétés de la cellule. On peut mentionner une chaîne unité, et cette chaîne sera affichée ; mais la cellule contient toujours un nombre sans dimension. Afin de changer une valeur sans dimension en une valeur avec dimension, la valeur elle-même doit être entrée à nouveau avec son unité associée.
 
Un nombre sans dimension ne peut pas être changé en nombre avec une unité dans la boîte de dialogue des propriétés de la cellule. On peut mentionner une chaîne unité, et cette chaîne sera affichée ; mais la cellule contient toujours un nombre sans dimension. Afin de changer une valeur sans dimension en une valeur avec dimension, la valeur elle-même doit être entrée à nouveau avec son unité associée.
 +
</div>
  
 
Parfois, il peut être souhaitable de supprimer une dimension dans une expression. Cela peut être fait en multipliant par 1 avec une unité réciproque.
 
Parfois, il peut être souhaitable de supprimer une dimension dans une expression. Cela peut être fait en multipliant par 1 avec une unité réciproque.
Line 193: Line 230:
 
Les feuilles de calculs peuvent être importées et exportées au format [https://fr.wikipedia.org/wiki/Comma-separated_values ​​csv] qui peut également être lu et écrit par la plupart des tableurs tels que Microsoft Excel ou LibreOffice Calc. Lors de l'importation de fichiers dans FreeCAD, le délimiteur (le caractère utilisé pour séparer les colonnes) doit être le caractère TAB (ceci peut être défini lors de l'exportation à partir d'autres applications). L'importation d'un fichier CSV est disponible via le menu {{MenuCommand|Spreadsheet → Importer une feuille de calcul}} ou en cliquant sur l'icône [[Image:SpreadsheetImport.svg|24px]]. Cette fonction d'importation n'ouvre pas les fichiers Excel ou tout autre format de tableur.
 
Les feuilles de calculs peuvent être importées et exportées au format [https://fr.wikipedia.org/wiki/Comma-separated_values ​​csv] qui peut également être lu et écrit par la plupart des tableurs tels que Microsoft Excel ou LibreOffice Calc. Lors de l'importation de fichiers dans FreeCAD, le délimiteur (le caractère utilisé pour séparer les colonnes) doit être le caractère TAB (ceci peut être défini lors de l'exportation à partir d'autres applications). L'importation d'un fichier CSV est disponible via le menu {{MenuCommand|Spreadsheet → Importer une feuille de calcul}} ou en cliquant sur l'icône [[Image:SpreadsheetImport.svg|24px]]. Cette fonction d'importation n'ouvre pas les fichiers Excel ou tout autre format de tableur.
  
 +
<div class="mw-translate-fuzzy">
 
Les feuilles de calculs au format Excel "xlsx" peuvent être importées via le menu {{MenuCommand|Fichier → Importer...}}  dans un document FreeCAD. Les feuilles de calculs Excel peuvent également être ouvertes par FreeCAD en cliquant dans le menu {{MenuCommand|Fichier → Ouvrir...}} ou en cliquant sur l'icône [[Image:Document-open.svg|24px]]. Dans ce cas un nouveau document avec une feuille de calcul à l'intérieur est créé. Les fonctionnalités suivantes sont prises en charge :
 
Les feuilles de calculs au format Excel "xlsx" peuvent être importées via le menu {{MenuCommand|Fichier → Importer...}}  dans un document FreeCAD. Les feuilles de calculs Excel peuvent également être ouvertes par FreeCAD en cliquant dans le menu {{MenuCommand|Fichier → Ouvrir...}} ou en cliquant sur l'icône [[Image:Document-open.svg|24px]]. Dans ce cas un nouveau document avec une feuille de calcul à l'intérieur est créé. Les fonctionnalités suivantes sont prises en charge :
 +
</div>
  
 
* Toutes les fonctions qui sont également disponibles dans la feuille de calcul FreeCAD. D'autres fonctions donnent une erreur dans la cellule correspondante après l'importation.
 
* Toutes les fonctions qui sont également disponibles dans la feuille de calcul FreeCAD. D'autres fonctions donnent une erreur dans la cellule correspondante après l'importation.
Line 201: Line 240:
 
Les autres fonctionnalités ne sont pas importées dans la feuille de calcul FreeCAD. L'importation Excel est possible à partir de la {{Version/fr|0.17}} de FreeCAD.
 
Les autres fonctionnalités ne sont pas importées dans la feuille de calcul FreeCAD. L'importation Excel est possible à partir de la {{Version/fr|0.17}} de FreeCAD.
  
 +
<div class="mw-translate-fuzzy">
 
== Limitations Courantes ==
 
== Limitations Courantes ==
 +
</div>
  
 +
<div class="mw-translate-fuzzy">
 
FreeCAD vérifie les dépendances cycliques. De par sa conception, cette vérification s’arrête au niveau de l’objet feuille de calcul. Par conséquent, vous ne devriez pas avoir de feuille de calcul contenant à la fois des cellules dont les valeurs sont utilisées pour spécifier des paramètres pour le modèle et des cellules dont les valeurs utilisent la sortie du modèle. Par exemple, vous ne pouvez pas avoir de cellules spécifiant la longueur, la largeur et la hauteur d'un objet, et une autre cellule qui référence le volume total de la forme obtenue. Cette restriction peut être surmontée en disposant de deux feuilles de calcul : l'une utilisée comme source de données pour les paramètres d'entrée du modèle et l'autre pour les calculs basés sur les données géométriques résultantes.
 
FreeCAD vérifie les dépendances cycliques. De par sa conception, cette vérification s’arrête au niveau de l’objet feuille de calcul. Par conséquent, vous ne devriez pas avoir de feuille de calcul contenant à la fois des cellules dont les valeurs sont utilisées pour spécifier des paramètres pour le modèle et des cellules dont les valeurs utilisent la sortie du modèle. Par exemple, vous ne pouvez pas avoir de cellules spécifiant la longueur, la largeur et la hauteur d'un objet, et une autre cellule qui référence le volume total de la forme obtenue. Cette restriction peut être surmontée en disposant de deux feuilles de calcul : l'une utilisée comme source de données pour les paramètres d'entrée du modèle et l'autre pour les calculs basés sur les données géométriques résultantes.
 +
</div>
  
 +
<div class="mw-translate-fuzzy">
 
Lorsque les cellules sont copiées, seul le contenu (expression/valeur) est copié. Les [[Spreadsheet_Workbench/fr#Propriétés de Cellule|propriétés de cellule]] décrites ci-dessus ne sont pas copiées.
 
Lorsque les cellules sont copiées, seul le contenu (expression/valeur) est copié. Les [[Spreadsheet_Workbench/fr#Propriétés de Cellule|propriétés de cellule]] décrites ci-dessus ne sont pas copiées.
 +
</div>
  
 
Pour d'anciennes versions de FreeCAD voir [[Spreadsheet_legacy/fr|Spreadsheet Feuille de calcul historique]].
 
Pour d'anciennes versions de FreeCAD voir [[Spreadsheet_legacy/fr|Spreadsheet Feuille de calcul historique]].
  
== Scripts basiques==  
+
<div class="mw-translate-fuzzy">
 +
== Scripts basiques==
 +
</div>
  
 
{{Code|code=
 
{{Code|code=
Line 217: Line 264:
 
}}
 
}}
  
 +
<div class="mw-translate-fuzzy">
 
{{Docnav/fr
 
{{Docnav/fr
 
|[[Sketcher_Workbench/fr|Atelier Sketcher]]
 
|[[Sketcher_Workbench/fr|Atelier Sketcher]]
Line 223: Line 271:
 
|IconR=Workbench_Start.svg
 
|IconR=Workbench_Start.svg
 
}}
 
}}
 +
</div>
  
 
{{Spreadsheet_Tools_navi{{#translation:}}}}
 
{{Spreadsheet_Tools_navi{{#translation:}}}}
 
{{Userdocnavi{{#translation:}}}}
 
{{Userdocnavi{{#translation:}}}}
 
[[Category:Workbenches{{#translation:}}]]
 
[[Category:Workbenches{{#translation:}}]]

Revision as of 14:09, 2 December 2020

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Türkçe • ‎español • ‎français • ‎hrvatski • ‎italiano • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎svenska • ‎čeština • ‎български • ‎русский • ‎中文 • ‎中文(中国大陆)‎ • ‎中文(台灣)‎ • ‎한국어
Arrow-left.svg Page précédente : Workbench Sketcher.svg Atelier Sketcher
Page suivante : Atelier Start Workbench Start.svg Arrow-right.svg
Icône de l'atelier Spreadsheet

Introduction

L'Workbench Spreadsheet.svg atelier Spreadsheet vous permet de créer et d’éditer des feuilles de calcul, de remplir la feuille de calcul avec les données extraites d’un modèle, d’effectuer des calculs et de les exporter vers d’autres applications de tableurs telles que LibreOffice ou Microsoft Excel.

Spreadsheet screenshot.jpg

Une feuille de tableur avec un certain nombre de cellules remplies de texte et de quantités


Outils

  • Spreadsheet Import.svg Importer: importe un fichier de valeurs séparées par des virgules (CSV) dans une feuille de calcul.
  • Spreadsheet Export.svg Exporter: exporte un fichier de valeurs séparées par des virgules (CSV) à partir d'une feuille de calcul.
  • Spreadsheet SetAlias.svg Alias: définit des alias pour les cellules sélectionnées.
  • Noir et Blanc définissent les couleurs de premier plan et d'arrière-plan des cellules sélectionnées.

Propriétés d'une cellule

Les propriétés d'un cellule de feuille de calcul peuvent être éditées avec un clic-droit sur la cellule. La boîte de dialogue suivante apparaît :

SpreadsheetCellPropDialog.png

Comme mentionné dans les onglets, les propriétés suivantes peuvent être changées :

  • Couleur: couleur du texte et couleur d'arrière-plan
  • Alignement: alignement horizontal et vertical du texte
  • Style: style du texte : gras, italique, souligné
  • Affichage unités: affiche l'unité de la cellule. Veuillez lire la section Unités ci-dessous.
  • Alias : défini un nom pour la cellule. Ce nom peut être utilisé dans les formules des cellules ainsi que dans les expressions FreeCAD. Voir Données de la feuille de calcul dans les expressions ci-dessous pour plus d'informations sur le sujet.

Expressions dans les cellules

Une cellule de feuille de calcul peut contenir du texte arbitraire ou une expression. Techniquement, les expressions doivent commencer par un signe égal '='. Cependant, le tableur tente d’être intelligent ; si vous entrez ce qui ressemble à une expression sans le signe '=', celui-ci sera ajouté automatiquement.

Les expressions cellulaires peuvent contenir des nombres, des fonctions, des références à d'autres cellules et des références à des propriétés du modèle (voir toutefois les limitations courantes ci-dessous). Les cellules sont référencées par leur colonne (lettre CAPITALE) et leur rangée (nombre). Une cellule peut également être référencée par son alias (ci-dessous). Exemple: B4 + A6

Remarque: Les expressions de cellule sont traitées par FreeCAD comme du code de programmation. Par conséquent, lorsque vous modifiez une cellule, vous voyez que le contenu ne suit pas vos paramètres d'affichage:

Les références aux objets d'un modèle sont expliquées sous Références aux données CAO ci-dessous. L'utilisation des valeurs de cellule de la feuille de calcul pour définir les propriétés du modèle est expliquée dans Données de la feuille de calcul dans les expressions ci-dessous. Pour plus de détails sur la manière dont les expressions sont formées, voir Expressions.

Interaction entre les feuilles de calcul et l'objet CAO

Les données contenues dans les cellules d'une feuille de calcul peuvent être utilisées dans les expressions de paramètres de modèle de CAO. Ainsi, une feuille de calcul peut être utilisée comme source pour les valeurs de paramètres utilisées dans un modèle, regroupant efficacement les valeurs à un endroit. Lorsque les valeurs sont modifiées dans la feuille de calcul, elles sont propagées dans tout le modèle.

De même, les propriétés des objets de modèle CAO peuvent être utilisées dans les expressions des cellules de la feuille de calcul. Cela permet d'utiliser des propriétés d'objet telles que le volume ou la surface dans la feuille de calcul. Si le nom d'un objet dans le modèle CAO est modifié, le changement sera automatiquement propagé à toutes les références dans les expressions de feuille de calcul en utilisant le nom qui a été modifié.

Plusieurs feuilles de calcul peuvent être utilisées dans un document. Une feuille de calcul peut être identifiée à l'aide de son nom ou de son étiquette.

FreeCAD attribuera automatiquement un nom unique à une feuille de calcul lors de sa création. Ces noms suivent le modèle Spreadsheet, Spreadsheet001, Spreadsheet002 et ainsi de suite. Le nom ne peut pas être modifié manuellement et il n'est pas visible dans les propriétés de la feuille de calcul. Il peut être utilisé pour faire référence à la feuille de calcul dans une Expression (voir Données de la feuille de calcul dans les expressions ci-dessous.)

L'étiquette d'une feuille de calcul est automatiquement définie sur le nom de la feuille de calcul lors de sa création. Contrairement au nom, l'étiquette peut être modifiée, par exemple dans le panneau des propriétés ou à l'aide de l'action Renommer du menu contextuel. Notez que l'étiquette d'une feuille de calcul dans un document doit être unique. Si vous essayez de changer l'étiquette en une étiquette déjà utilisée par une autre feuille de calcul, FreeCAD n'acceptera pas la nouvelle étiquette.

FreeCAD vérifie les dépendances cycliques. Voir limitations courantes.

Références aux données CAO

Comme indiqué ci-dessus, il est possible de référencer les données du modèle CAO dans des expressions de feuille de calcul.

Les expressions calculées dans les cellules de la feuille de calcul commencent par un signe égal ('='). Cependant, le mécanisme de saisie du tableur tente d’être astucieux. Une expression peut être entrée sans le signe '='. Si la chaîne entrée est une expression valide, un '=' est automatiquement ajouté lors de la frappe de la touche Valider. Si la chaîne entrée n'est pas une expression valide (souvent le résultat d'une saisie avec une casse incorrecte, par exemple "MonCube.longueur" à la place de "MonCube.Longueur"), aucun '=' n'est ajouté et cela est traité comme une simple chaîne de texte.

Remarque: le comportement ci-dessus (insertion automatique de '=') a des travers désagréables :

  • si vous souhaitez conserver une colonne de noms correspondant aux noms d'alias dans une colonne de valeurs adjacente, vous devez saisir le nom dans la colonne d'étiquette avant celle donnée à la cellule dans la colonne de valeur comme nom d'alias. Sinon, lorsque vous entrez le nom d'alias dans la colonne d'étiquette, la feuille de calcul considère qu'il s'agit d'une expression et la remplace par "=<alias_name>" ; et le texte affiché correspondra à la valeur de la cellule <alias_name>.
  • Si vous faites une erreur lors de la saisie du nom dans la colonne d'étiquette et souhaitez le corriger, vous ne pouvez pas le changer simplement en nom d'alias. Au lieu de cela, vous devez d'abord remplacer le nom d'alias par un autre nom, puis corriger le nom du texte dans la colonne d'étiquette, puis remplacer le nom d'alias dans la colonne de valeur par son nom d'origine.

Une façon d'éviter ces problèmes consiste à préfixer les étiquettes de texte correspondant aux noms d'alias avec une chaîne fixe, les rendant ainsi différentes. Notez que "_" ne fonctionnera pas, car il est converti en "=". Cependant, un blanc, bien qu'invisible, fonctionnera.

Le tableau suivant montre quelques exemples en supposant que le modèle a une fonctionnalité nommée "MonCube" :

Donnée CAO Appel dans la feuille de calcul Résultat
Longueur paramétrique d'un Cube dans l'Atelier Part =MonCube.Longueur Longueur en mm
Volume du Cube =MonCube.Shape.Volume Volume en mm³ sans unité
Type de la forme du Cube =MonCube.Shape.ShapeType String: Solid
Nom du Cube =MonCube.Label String: MonCube
Coordonnée x du centre de gravité du Cube =MonCube.Shape.CenterOfMass.x Coordonnée x en mm sans unité

Données de la feuille de calcul dans les expressions

Pour utiliser les données de la feuille de calcul dans d'autres parties de FreeCAD, vous allez généralement créer une Expression qui fait référence à la feuille de calcul et à la cellule contenant les données que vous souhaitez utiliser. Vous pouvez identifier les feuilles de calcul par le nom ou par l'étiquette, et vous pouvez identifier les cellules par leur position ou par leur alias. L'autocomplétion est disponible pour toutes les formes de référencement.

Feuille de calcul par le nom Feuille de calcul par l'étiquette
Cellule par la position =Spreadsheet042.B5 =<<MySpreadsheet>>.B5
Cellule par l'alias =Spreadsheet042.MyAlias =<<MySpreadsheet>>.MyAlias

La méthode recommandée pour faire référence aux données de la feuille de calcul consiste à utiliser l'étiquette de la feuille de calcul et le nom d'alias de cellule. Pour une explication plus approfondie des avantages et des inconvénients des modes d'adressage, consultez la section développée ci-dessous.

L'utilisation de l'étiquette de la feuille de calcul présente l'avantage de pouvoir être librement modifiée pour décrire le contenu de la feuille de calcul. Il est également plus facile d'identifier la feuille de calcul utilisée car le texte de l'expression correspond à l'étiquette affichée dans les vues du modèle et des propriétés. Si vous décidez de modifier l'étiquette d'une feuille de calcul, les références existantes au contenu de la feuille de calcul seront mises à jour, de sorte que vous ne casserez pas vos expressions en renommant la feuille de calcul. Le nom interne de la feuille de calcul n'est pas facilement disponible ailleurs que dans l'éditeur d'expression, donc si vous utilisez le nom interne et décidez plus tard de renommer les feuilles de calcul, vous pourriez avoir du mal à retracer vos données d'expression jusqu'à leur source.

Sachez que lorsque vous créez une nouvelle feuille de calcul, le nom et l'étiquette sont identiques, il est donc facile d'utiliser accidentellement le nom de la feuille de calcul au lieu de l'étiquette. Un moyen simple d'éviter cela est de donner à la feuille de calcul un nom significatif avant de commencer à l'utiliser dans des expressions.

Bien que vous puissiez utiliser le numéro de ligne et de colonne dans une expression pour référencer une cellule, la meilleure pratique consiste à donner à la cellule un nom d'alias et à l'utiliser. Voir Propriétés d'une cellule ci-dessus pour savoir comment définir l'alias. Par exemple, si les données de la cellule B1 contenaient le paramètre de longueur pour un objet, un nom d'alias de MyObject_Length permettrait à la valeur d'être appelée <<MyParams>>.MyObject_Length au lieu de Spreadsheet.B1. En plus d'être beaucoup plus faciles à lire et à comprendre, les noms d'alias sont également beaucoup plus faciles à modifier si vous décidez d'ajuster la structure de votre feuille de calcul. L'utilisation d'un alias présente également l'avantage qu'il est plus facile de voir quelles cellules sont utilisées pour contrôler d'autres parties du document. Notez que FreeCAD ajustera automatiquement les références de position dans les expressions si vous insérez ou supprimez des lignes et des colonnes dans la feuille de calcul, donc même si vous utilisez des numéros de ligne et de colonne dans une expression, vous pouvez insérer des lignes et des colonnes sans casser les références aux cellules environnantes.

Complex models and recomputes

Editing a spreadsheet will trigger a recompute of the 3D model, even if the changes do not affect the model. For a complex model a recompute can take a long time, and having to wait after every single edit is of course quite annoying.

There are three solutions to deal with this:

  1. Temporarily skip recomputes:
    • Right-click the document node in the Tree view.
    • Select the Skip recomputes option from the context menu.
    • There is a big disadvantage to this solution. New values entered in the spreadsheet will not be displayed until the document is recomputed. Instead #PENDING is shown.
    • You can either recompute manually, using the Std Refresh command, or disable Skip recomputes when you are done editing.
  2. Use a macro to automatically skip recomputes while editing a spreadsheet:
    • Download and run skipSheet.FCMacro.
    • This solution saves a few steps compared to the first solution, but also has the mentioned disadvantage.
  3. Put the spreadsheet in a separate file:
    • You can reference spreadsheet data from an external file with this syntax: =NameOfFile#<<MySpreadsheet>>.MyAlias.
    • The advantage of having the spreadsheet in another file over switching off recomputes is that the spreadsheet itself does get recomputed.
    • The disadvantage is that the model won't automatically recompute after changes to the spreadsheet.
    • In the scenario where you first open the 'spreadsheet' file, change one or more values and then open the 'model' file, there won't be any indication that the model needs to be recomputed. But if both files are open the Std Refresh icon will update correctly for the 'model' file after changes to the 'spreadsheet' file.

Unités

Le tableur intègre une notion de dimension (unités) associée aux valeurs de cellule. Un numéro entré sans unité associée n'a pas de dimension. L'unité doit être entrée immédiatement après la valeur numérique, sans espace intermédiaire. Si un nombre a une unité associée, cette unité sera utilisée dans tous les calculs. Par exemple, la multiplication de deux longueurs avec l'unité mm donne une surface avec l'unité mm².

Si une cellule contient une valeur qui représente une dimension, vous devez la saisir avec son unité associée. Bien que dans de nombreux cas simples, on puisse se débrouiller avec une valeur sans dimension, il est déconseillé de ne pas entrer l'unité. Si une valeur représentant une dimension est entrée sans son unité associée, certaines séquences d'opérations obligent FreeCAD à alerter sur les unités incompatibles dans une expression lorsqu'il apparaît que celle-ci doit être validée. (Cela peut être mieux compris en consultant ce sujet (en) dans les forums FreeCAD.)

Vous pouvez modifier les unités affichées pour une valeur de cellule à l'aide de l'onglet Unités de la boîte de dialogue Propriétés Unités (ci-dessus). Cela ne change pas la valeur contenue dans la cellule; il ne convertit que la valeur existante pour l'affichage. La valeur utilisée pour les calculs ne change pas et les résultats des formules utilisant cette valeur ne changent pas. Par exemple, une cellule contenant la valeur "5.08cm" peut être affichée sous la forme "2in" en modifiant la valeur de l'onglet des unités en "in".

Un nombre sans dimension ne peut pas être changé en nombre avec une unité dans la boîte de dialogue des propriétés de la cellule. On peut mentionner une chaîne unité, et cette chaîne sera affichée ; mais la cellule contient toujours un nombre sans dimension. Afin de changer une valeur sans dimension en une valeur avec dimension, la valeur elle-même doit être entrée à nouveau avec son unité associée.

Parfois, il peut être souhaitable de supprimer une dimension dans une expression. Cela peut être fait en multipliant par 1 avec une unité réciproque.

Importation et exportation

Les feuilles de calculs peuvent être importées et exportées au format ​​csv qui peut également être lu et écrit par la plupart des tableurs tels que Microsoft Excel ou LibreOffice Calc. Lors de l'importation de fichiers dans FreeCAD, le délimiteur (le caractère utilisé pour séparer les colonnes) doit être le caractère TAB (ceci peut être défini lors de l'exportation à partir d'autres applications). L'importation d'un fichier CSV est disponible via le menu Spreadsheet → Importer une feuille de calcul ou en cliquant sur l'icône SpreadsheetImport.svg. Cette fonction d'importation n'ouvre pas les fichiers Excel ou tout autre format de tableur.

Les feuilles de calculs au format Excel "xlsx" peuvent être importées via le menu Fichier → Importer... dans un document FreeCAD. Les feuilles de calculs Excel peuvent également être ouvertes par FreeCAD en cliquant dans le menu Fichier → Ouvrir... ou en cliquant sur l'icône Document-open.svg. Dans ce cas un nouveau document avec une feuille de calcul à l'intérieur est créé. Les fonctionnalités suivantes sont prises en charge :

  • Toutes les fonctions qui sont également disponibles dans la feuille de calcul FreeCAD. D'autres fonctions donnent une erreur dans la cellule correspondante après l'importation.
  • Noms d'alias pour les cellules
  • Plusieurs tableaux dans une feuille Excel. Dans ce cas, une feuille de calcul FreeCAD est créée pour chaque tableau Excel.

Les autres fonctionnalités ne sont pas importées dans la feuille de calcul FreeCAD. L'importation Excel est possible à partir de la Introduit dans la version 0.17 de FreeCAD.

Limitations Courantes

FreeCAD vérifie les dépendances cycliques. De par sa conception, cette vérification s’arrête au niveau de l’objet feuille de calcul. Par conséquent, vous ne devriez pas avoir de feuille de calcul contenant à la fois des cellules dont les valeurs sont utilisées pour spécifier des paramètres pour le modèle et des cellules dont les valeurs utilisent la sortie du modèle. Par exemple, vous ne pouvez pas avoir de cellules spécifiant la longueur, la largeur et la hauteur d'un objet, et une autre cellule qui référence le volume total de la forme obtenue. Cette restriction peut être surmontée en disposant de deux feuilles de calcul : l'une utilisée comme source de données pour les paramètres d'entrée du modèle et l'autre pour les calculs basés sur les données géométriques résultantes.

Lorsque les cellules sont copiées, seul le contenu (expression/valeur) est copié. Les propriétés de cellule décrites ci-dessus ne sont pas copiées.

Pour d'anciennes versions de FreeCAD voir Spreadsheet Feuille de calcul historique.

Scripts basiques

import Spreadsheet
sheet = App.ActiveDocument.addObject("Spreadsheet::Sheet")
sheet.Label = "Dimensions"
Arrow-left.svg Page précédente : Workbench Sketcher.svg Atelier Sketcher
Page suivante : Atelier Start Workbench Start.svg Arrow-right.svg