Manual:Using spreadsheets/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "* Bien que ces résultats soient exprimés avec leurs unités, les valeurs peuvent être manipulées comme n'importe quel nombre, essayez, par exemple, d'entrer dans la cellul...")
(Created page with "La page de l'atelier Spreadsheet (Spreadsheet Workbench) décrit plus en détail toutes les opérations et fonctions possibles que vous pouvez utiliser...")
Line 35: Line 35:
[[Image:Exercise_spreadsheet_04.jpg]]
[[Image:Exercise_spreadsheet_04.jpg]]


The [[Spreadsheet_Module|Spreadsheet Workbench]] page will describe more in detail all the possible operations and functions that you can use in spreadsheets.
La page de l'atelier Spreadsheet ([[Spreadsheet_Module|Spreadsheet Workbench]]) décrit plus en détail toutes les opérations et fonctions possibles que vous pouvez utiliser dans les feuilles de calcul.


=== Writing properties ===
=== Writing properties ===

Revision as of 16:13, 5 June 2017

FreeCAD dispose d'un autre atelier intéressant à explorer : l’atelier Feuilles de calcul (Spreadsheet Workbench). Cet atelier permet de créer des feuilles de calcul (spreadsheets) telles que celles réalisées avec Excel ou LibreOffice directement dans FreeCAD. Ces feuilles de calcul peuvent ensuite être remplies avec des données extraites de votre modèle et peuvent également effectuer une série de calculs entre les valeurs. Les feuilles de calcul peuvent être exportées sous forme de fichiers CSV, qui peuvent être importés dans n'importe quelle autre application de tableur.

Dans FreeCAD, cependant, les feuilles de calcul ont une utilité supplémentaire : leurs cellules peuvent recevoir un nom et peuvent être référencées par n'importe quel champ pris en charge par le moteur des expressions (expressions engine). Cela transforme les feuilles de calcul en puissantes structures de contrôle, où les valeurs insérées dans des cellules spécifiques peuvent générer des dimensions du modèle. Il n'y a qu'une chose à garder à l'esprit, car FreeCAD interdit les dépendances circulaires entre les objets, une même feuille de calcul ne peut pas être utilisée pour définir une propriété d'un objet et, en même temps, récupérer une valeur de propriété à partir du même objet. Cela rendrait la feuille de calcul et l'objet dépendant l’un de l'autre.

Dans l'exemple suivant, nous allons créer quelques objets, récupérer certaines de leurs propriétés dans une feuille de calcul, puis utiliser la feuille de calcul pour générer directement les propriétés d'autres objets.

Lecture des propriétés

  • Commencez par passer à l’atelier Part (Part Workbench), et créez quelques objets : une boîte ( box), un cylindre ( cylinder) et une sphère ( sphere).
  • Modifiez leur propriété de Placement (ou utilisez l'outil Déplacer Draft Move ) pour les séparer un peu, afin que nous puissions mieux observer les effets de ce que nous allons faire :

  • Maintenant, on va extraire des informations sur ces objets. Passez à l'atelier Feuille de calcul (Spreadsheet Workbench).
  • Appuyez sur le bouton Nouvelle feuille de calcul ().
  • Double-cliquez sur l'objet Nouvelle feuille de calcul dans l'arborescence. L'éditeur de feuille de calcul s'ouvre :

L'éditeur de feuilles de calcul de FreeCAD, bien qu'il ne soit pas aussi complet et puissant que les applications de tableurs plus complètes que nous avons énumérées ci-dessus, a néanmoins la plupart des outils et des fonctions de base couramment utilisés, comme la possibilité de modifier l'aspect des cellules (Taille, couleur, alignement), joindre et diviser les cellules, utiliser des formules telles que =2+2, ou référencer d'autres cellules avec =B1.

Dans FreeCAD, à ces comportements communs, on a ajouté une possibilité très intéressante : la possibilité de faire référence non seulement à d'autres cellules, mais aussi d'autres objets du document, et de récupérer des valeurs à partir de leurs propriétés. Par exemple, récupérons quelques propriétés des 3 objets que nous avons créés ci-dessus. Les propriétés sont ce que nous pouvons voir dans la fenêtre de l'éditeur de propriétés, sous l'onglet Données (Data), lorsqu'un objet est sélectionné.

  • Commençons par entrer quelques textes dans les cellules A1, A2 et A3, alors nous nous souvenons de ce qui se passera plus tard, par exemple Cube Length (longueur de l’arête du cube), Cylinder Radius (rayon du cylindre) et Sphere Radius (rayon de la sphère). Pour entrer du texte, écrivez simplement dans le "Conteneur" disposé au-dessus de la feuille de calcul ou double-cliquez sur une cellule.
  • Maintenant, récupérons la longueur réelle de notre cube. Dans la cellule B1, tapez =Cube.Length. Vous remarquerez que la feuille de calcul possède un mécanisme de remplissage automatique, qui est en fait le même que l'éditeur d'expression que nous avons utilisé dans le chapitre précédent.
  • Faites de même pour la cellule B2 (=Cylinder.Radius) et B3 (=Sphere.Radius).

  • Bien que ces résultats soient exprimés avec leurs unités, les valeurs peuvent être manipulées comme n'importe quel nombre, essayez, par exemple, d'entrer dans la cellule C1 : =B1*2.
  • Nous pouvons maintenant modifier une de ces valeurs dans l'éditeur de propriétés, et la modification sera immédiatement reflétée dans la feuille de calcul. Par exemple, modifions la longueur de notre cube à 20mm :

La page de l'atelier Spreadsheet (Spreadsheet Workbench) décrit plus en détail toutes les opérations et fonctions possibles que vous pouvez utiliser dans les feuilles de calcul.

Writing properties

Another very interesting use of the Spreadsheet Workbench in FreeCAD is to do the contrary of what we have been doing until now: Instead of reading the values of properties of 3D objects, we can also assign values to these objects. Remember, however, one of the fundamental rules of FreeCAD: Circular dependencies are forbidden. We can therefore not use the same spreadsheet to read and write values to a 3D object. That would make the object depend on the spreadsheet, which would also depend on the object. Instead, we will create another spreadsheet.

  • We can now close the spreadsheet tab (under the 3D view). This is not mandatory, there is no problem in keeping several spreadsheet windows open.
  • Press the New Spreadsheet button again
  • Change the name of the new spreadsheet to something more meaningful, such as Input (do this by right-clicking the new spreadsheet object, and choosing Rename).
  • Double-click the Input spreadsheet to open the spreadsheet editor.
  • In cell A1, let's put a descriptive text, for example: "Cube dimensions"
  • In cell B1, write =5mm (using the = sign makes sure the value is interpreted as a unit value, not a text).
  • Now to be able to use this value outside the spreadsheet, we need to give a name, or alias, to the B1 cell. Right-click the cells, click Properties and select the Alias tab. Give it a name, such as cubedims:

  • Press OK, then close the spreadsheet tab
  • Select the cube object
  • In the properties editor, click the little expression icon at the right side of the Length field. This will open the expressions editor, where you can write Spreadsheet001.cubedims. Repeat this for Height and Width:

You might wonder why we had to use "Spreadsheet001" instead of "Input" in the expression above. This is because each object, in a FreeCAD document, has an internal name, which is unique in the document, and a label, which is what appears in the tree view. If you uncheck the appropriate option in the preferences settings, FreeCAD will allow you to give the same label to more than one object. This is why all operations that must identify an object with absolutely no doubt, will use the internal name instead of the label, which could designate more than one object. The easiest way to know the internal name of an object is by keeping the selection panel (menu Edit->Panels) open, it will always indicate the internal name of a selected object:

By using cell aliases in spreadsheets, we are able to use a spreadsheet to store "master values" in a FreeCAD document. This can be used, for example, to have a model of a piece of certain dimensions, and to store these dimensions in a spreadsheet. It becomes then very easy to produce another model with different dimensions, it is just a matter of opening the file and changing a couple of dimensions in the spreadsheet.

Finally, note that the constraints inside a sketch can also receive the value of a spreadsheet cell:

You can also give aliases to dimensional constraints (horizontal, vertical or distance) in a sketch (you can then use that value from outside the sketch as well):

Download

Read more