Plot Basic tutorial/fr

Dans ce tutoriel, nous allons apprendre, comment effectuer une approche de base, à l'aide du module Plot, et, de la console Python. Vous en apprendrez plus ici, sur le module Plot.

Basic plot example.

Dans l'image précédente, vous pouvez voir à peux près le résultat que l'on obtiendra.

À la suite de ce tutoriel, vous apprendrez à connaître :


 * La création d'un Plot à partir de la Console Python.
 * Comment tracer certaines données avec la Console Python.
 * Comment faire pour afficher les lignes de la grille.
 * Comment faire pour afficher les légendes.
 * Comment faire pour modifier les étiquettes de Series, introduire le texte dans LaTeX.
 * Comment faire pour modifier les étiquettes des axes, introduire le texte dans LaTeX.
 * Comment faire pour modifier les styles de Series.
 * Comment enregistrer votre résultat Plot.

Créer les données Plot
Pour tracer les données, vous n'avez pas besoin de créer un nouveau document FreeCAD, il faut simplement aller dans la console Python, et, entrer les commandes, ou utilisez les macros.

Création d'un document Plot
Les documents Plot, sont des documents spéciaux, qui peuvent être créés manuellement, pour y ajouter des données, ou le module peut en crée un automatiquement, lorsque vous démarrez le traçage de données.

Créer votre propre document Plot, a 2 avantages :


 * Vous pouvez définir l'étiquette de la fenêtre du document.
 * Vous pouvez contrôler facilement le document dont vous ajoutez vos données.

Afin de créer nouveau document Plot, lancez simplement ces commandes : Cela va créer un nouvel onglet sur la fenêtre principale, appelée TrigonometricTest . Le nouveau document créé, a déjà un ensemble d'axes. Chaque document Plot a au moins un jeu d'axes, qui peut être supprimé, sans utiliser pleinement matplotlib.

Fonctions de dessin
Vous pouvez commencer le travail, toutes commandes Plot, démarrent un nouveau document, mais toutes les commandes Plot, que vous exécuterez, ajouterons une Series de tracés, tant que vous ne créez pas un nouveau document. Donc pratiquement, il est préférable de conserver les documents Plot ouverts.

La première chose que nous devons faire, est de créer les données pour les fonctions sinus, et, cosinus, que nous voulons tracer : Ceci va créer 3 tableaux de données (avec 101 points) :


 * t = Temps en secondes.
 * s = fonction Sinus.
 * c = fonction Cosinus.

Afin de tracer les deux fonctions, il suffit de lancer les commandes suivantes : Ces commandes vont tracer nos fonctions. La commande Plot permet d'utiliser une Series d'étiquettes, comme arguments, mais ultérieurement, nous allons modifier les données à l'aide du module Plot, donc, nous ne transmettrons pas encore ces données.

Afficher la grille, et, les légendes
Pour modifier l'outil module Plot de FreeCAD, allez dans le menu Affichage -> Workbench. Lorsque vous avez activé, le module Plot utilisez l'outil Grid afin de l'afficher.

Show/hide grid tool icon.

Vous pouvez répéter l'action pour le cacher. Vous pouvez également afficher la légende avec l'outil fourni.

Show/hide legend tool icon.

Comme vous pouvez le voir, la légende est vide, parce que nous n'avons pas mis d'étiquette à la Series. La Series module Plot sans étiquette, n'est pas représentée dans la légende, afin de permettre de dessiner une ligne auxiliaire.

Définir les étiquettes des Series
Avec l'outil Series, vous pouvez modifier certains paramètres de la Series.

Series configuration tool icon.

Tout d'abord, pour toutes les lignes sélectionnées que vous souhaitez modifier, pour l'exemple, nous allons commencer avec la première ligne.

Décochez la case No label, et, la valeur de cette étiquette : Étant donné que matplotlib, prend en charge LaTeX, vous pouvez définir toutes les étiquettes, ou les titres que vous voulez utiliser.

Donnez l'étiquette suivante à la deuxième Series :

Définition d'un style à la Series
L'outils Series, vous permet de définir un grand nombre de propriétés à la Series. Essayez de définir les propriétés affichées dans l'image exemple, modifiez les couleurs de la Series, et, le style de dessin en une seconde.

Définition des Labels des axes
Avec l'outil Labels, vous pouvez définir des labels associées à tous les axes créés.

Labels tool icon.

Définir ces données :


 * Title = Trigonometric functions example
 * X Label = $t$
 * Y Label = $y = \mathrm{f} \left( t \right)$

Modifiez également la taille de chacun d'eux à 20.

Sauvez Plot
Sauvegardes avec l'outil Plot, vous pouvez enregistrer votre Plot, dans un fichier image, dans plusieurs formats différents.

Save tool icon.

Commencez par sélectionner le chemin du fichier de sortie. Vous pouvez utiliser la boîte de dialogue sélection fichier à l'aide de la touche à droite, de la ligne d'édition du chemin d'accès.

Vous pouvez définir la taille de l'image de sortie en pouces (inches), par exemple, nous pouvons définir 11.7x8.3, qui est un format DIN A4, la taille d'une feuille de papier standard. La résolution de l'image, dépendra du DPI (Dots per inch ou points par pouce), par exemple avec 100 dpi, vous obtiendrez une image de 1170 x 830 pixels.