Spreadsheet Workbench/fr

Introduction
L'atelier tableur 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 feuille de calcul telles que LibreOffice ou Microsoft Excel.

L'atelier tableur est disponible depuis FreeCAD 0.15.



Cell Expressions
A spreadsheet cell may contain arbitrary text or an expression. Technically, expressions must start with an equals '=' sign. However, the spreadsheet attempts to be intelligent; if you enter what looks like an expression without the leading '=', one will be added automatically.

Cell expressions may contain numbers, functions, and references to other cells. Cells are referenced by their row (CAPITAL letter) and column (number). Example: B4 + A6

Numbers may use either a comma ',' or a decimal point '.' separating whole digits from decimals.

Les constantes "pi" et "e" sont prédéfinies.

Mathematical Functions
Le tableur met à disposition les fonctions suivantes, elles prennent un ou deux arguments : abs, acos, asin, atan, atan2, cos, cosh, exp, log, log10, mod, pow, sin, sinh, sqrt, tan, tanh

Plusieurs arguments d’une fonction peuvent être séparés par un point-virgule (';') ou une virgule suivie d'un espace  (","). Dans ce dernier cas, la virgule est convertie en point-virgule après la saisie.

Les fonctions trigonométriques utilisent les degrés par défaut; vous devez spécifier rad si vous voulez que les fonctions utilisent le radian.

L'ensemble des fonctions suivantes est supporté : "average", "count", "max", "min", "stddev", "sum".

Conditional Expressions
L'instruction conditionnelle fonctionne comme cela : "= condition ? résultatVrai : résultatFaux"

La condition est définie comme une expression qui donnera soit 0 (pour faux) ou différent de 0 pour vrai. Les opérateurs de comparaison sont les suivants : ==, !=, >, <, >= et <=.

L'instruction conditionnelle a en fait un bogue concernant les instructions conditionnelles imbriquées. Seul le vrai-résultat peut avoir une autre déclaration conditionnelle. Les parenthèses sont supprimées après confirmation de l'expression. Essayer de mettre une instruction conditionnelle imbriquée dans le faux-résultat entraîne des parenthèses incorrectes avec un résultat différent après l'enregistrement et la réouverture du document.

Référence aux données CAO
Il est possible d'utiliser des données de la construction dans la feuille de calcul. Le tableau suivant montre quelques exemples en supposant que le modèle a une fonctionnalité nommée "Cube" (notez qu'il s'agit du nom interne de la fonctionnalité, pas de l'étiquette affectée par l'utilisateur):

Propriétés de la Cellule
Les propriétés de la cellule peuvent être éditées avec un clic-droit dans la cellule. La boîte de dialogue suivante apparaît :



Elle contient plusieurs onglets. Les propriétés suivantes peuvent être changées :


 * Couleur du texte et couleur d'arrière-plan
 * Alignement horizontal et vertical du texte
 * Style du texte : gras, italique, souligné
 * Affichage de l'unité pour cette cellule. Veuillez lire la section ci-dessous.
 * Définir un nom pour cette cellule. Ce nom peut être utilisé dans les formules des cellules ainsi que dans les expressions dans Freecad.

Les expressions sont expliquées ici : Expressions

Données de la feuille de calcul dans les Expressions
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.

En tapant un "M", apparaît une liste des noms disponibles. Les touches fléchées permettent de sélectionner "MySheet".



En tapant un "n", on voit apparaître la liste des noms disponibles dans MySheet commençant par "n". L'alias "number" peut être sélectionné avec la touche flèche vers le bas. Une fois qu'un nom valide ainsi qu'un contenu correct seront saisis, le champ résultat affichera la longueur calculée.



Unités
Les feuilles de calculs utilisent les unités. Si un nombre a une unité, cette unité sera utilisée dans les calculs. La multiplication de deux longueurs avec l'unité mm donne une surface en mm&sup2;.

On peut basculer l'unité de longueur des mm vers les pouces dans la boîte de dialogue obtenue par un clic-droit dans la cellule. La cellule montrera alors la longueur en pouces. La valeur utilisée pour les calculs ne change pas. Les résultats d'une formule utilisant cette valeur ne changent pas, quand l'unité affichée d'une entrée a été changée. Le résultat est toujours calculé à partir de la longueur en mm.

Un nombre sans unité ne peut pas être modifié en un nombre avec unité via la boite de propriétés des cellules. On peut saisir un texte indiquant l'unité, qui sera aussi affiché, mais la cellule ne contiendra toujours qu'un nombre sans unité.

Parfois il peut être préférable de se débarrasser de l'unité. Cela peut seulement être réalisé en multipliant par 1 avec une unité inverse.

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 Feuille de calcul / Importer une feuille de calcul ou en cliquant sur l'icône. Cette fonction d'importation n'ouvre pas les fichiers Excel ou tout autre format de feuille de calcul.

Les feuilles de calculs au format Excel "xlsx" peuvent être importées via le menu File/Import... 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. 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 la feuille Excel : Dans ce cas, plusieurs feuilles de calculs FreeCAD sont créées.

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

Limitations Courantes
Il n'est pas possible de fournir des données pour une géométrie, par exemple une longueur, dans une feuille de calcul et récupérer dans la même feuille le volume de la forme résultante. Ceci crée une référence circulaire. C'est une choix dans la conception. Cependant, il est possible d'utiliser deux feuilles différentes : une pour les données source de la géométrie et une autre pour reporter les données de la géométrie.

Il n'est pas possible de copier et de sélectionner plusieurs cellules. Seul le contenu d'une cellule d'un champ de saisie peut être copié et collé dans le champ de saisie d'une autre cellule.

Pour des anciennes versions de FreeCAD voir Spreadsheet legacy