Différences

Ci-dessous, les différences entre deux révisions de la page.

--- ressources:latex:py2tikz:accueil [2020/12/03 15:57] – thibautvadcard
+++ ressources:latex:py2tikz:accueil [2023/04/05 09:04] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 8: / Ligne 8: @@
    * graphes 2D
    * graphes 3D
-   * graphes en couleur
+   * graphes en couleur (contourplot)
-   * combinaison des 3
+   * histogrammes
+   * tracés dans le repère polaire
+   * combinaison des plusieurs types de graphes
 En effet, afin de garder l'outil assez simple et avec des paramètres d'entrée relativement limités, le code ne pourra pas traiter les graphes les plus compliqués. Pour ces derniers, il est toujours possible d'utiliser Py2tikz pour faire une ébauche de la figure finale sans les éléments limitants, puis rajouter manuellement ces derniers.
 ==== Paramètres d'entrée ====
-Les options d'entrée (commit 09324a42) sont :
+Les options d'entrée (commit 64019c27a35da08117405e26e4b850f8f155c067) sont :
 **Obligatoires**:
@@ Ligne 27: / Ligne 29: @@
 **Optionnels**:
-  *''width'' (type : ''str'') : largeur de l'axe , par défaut ''width = '6cm' ''
+  *''width'' (type : ''str'')            : largeur de l'axe , par défaut ''width = '6cm' ''
-  *''height'' (type : ''str'') : hauteur de l'axe , par défaut ''height = '6cm' ''
+  *''height'' (type : ''str'')           : hauteur de l'axe , par défaut ''height = '6cm' ''
-  *''legend'' (type : ''bool'') :  activer la légende , par défaut ''legend = True''. Pour l'instant la légende est affichée en dehors de la figure dans le coin haut droit (à modifier)
+  *''legend'' (type : ''bool'')          :  activer la légende , par défaut ''legend = True''. Pour l'instant la légende est affichée en dehors de la figure dans le coin haut droit (à modifier)
-  *''grid'' (type : ''bool'') : activer la grille , par défaut ''grid = False''. Pour l'instant la seule option est une grille sur les ticks majeurs.
+  *''grid'' (type : ''bool'')            : activer la grille , par défaut ''grid = False''. Pour l'instant la seule option est une grille sur les ticks majeurs.
-  *''auto_xticks'' (type : ''bool'') : utiliser les xticks automatiques de tikz , par défaut ''auto_xticks = False''.
+  *''auto_xticks'' (type : ''bool'')     : utiliser les xticks automatiques de tikz , par défaut ''auto_xticks = False''.
-  *''auto_yticks'' (type : ''bool'') : utiliser les yticks automatiques de tikz , par défaut ''auto_yticks = False''.
+  *''auto_yticks'' (type : ''bool'')     : utiliser les yticks automatiques de tikz , par défaut ''auto_yticks = False''.
-  *''type_axis''(type : ''str'') : type d'axe à utiliser . Par défaut ''type_axis = 'axis' '', autres options : ''semilogxaxis'', ''semilogyaxis'', ''loglogaxis''.
+  *''type_axis''(type : ''str'')         : type d'axe à utiliser . Par défaut ''type_axis = 'axis' '', autres options : ''semilogxaxis'', ''semilogyaxis'', ''loglogaxis''.
-  *''RAZ_figure''  (type : ''bool'') : Remise à zéro du dossier de la figure pour ne pas stocker tous les fichiers data des exécutions précédentes. Par défaut ''RAZ_figure = False''.
+  *''RAZ_figure''  (type : ''bool'')     : Remise à zéro du dossier de la figure pour ne pas stocker tous les fichiers data des exécutions précédentes. Par défaut ''RAZ_figure = False''.
+  *''split_subplots''  (type : ''bool'') : Exportation de chaque subplot dans un fichier pdf séparé. Par défaut ''split_subplots = False''.
+  *''opacity''  (type : ''bool'')        : Prise en charge de l'opacité dans le graphe (surfaces remplies), pour des soucis d'économie mémoire. Par défaut ''opacity = False''.
+  *''mappable''  (type : ''bool'')        : Prise en charge d'un élément de remplissage (contourplot dans le graphe) qui sera enregistré en image et mis en fond de l'axe correspondant, par défaut ''mappable = False''.
+  *''compileur''  (type : ''str'')        : Compileur latex utilisé pour la compilation du ''.tex'', à utiliser dans le cas d'une figure avec beaucoup de données en utilisant ''opacity = 'lualatex' '', par défaut ''opacity = 'pdflatex' ''.
+  *''type_figure''  (type : ''str'')        : type de figure traitée, spécifier ''type_figure = '3D' '' dans le cas d'une figure avec trois axes,par défaut ''type_figure = '2D' ''
 ==== Utilisation ====
 L'utilisation du code est assez simple :
-  - Importer le code :
+  - Installer la librairie, dans le dossier py2tikz (qui contient ''setup.py'') dans une console :
+<code> pip install . </code>
+  - Importer la fonction py2tikz du module py2tikz (depuis n'importe où grâce à l'installation par pip du module) :
-<code> from py2tikz.main import py2tikz </code>
+<code> from py2tikz import py2tikz </code>
-  - Appeler la fonction ''py2tikz'', par exemple :
+  - Appeler la fonction ''py2tikz'' par exemple :
 <code> py2tikz(fig,'Nom_du_fichier_tex',height='6cm',width='10cm',grid=True) </code>
@@ Ligne 51: / Ligne 60: @@
   * Le fichier ''.pdf'' compilé, s'il n'est pas présent c'est qu'il y a une erreur dans le code et la compilation n'a pas fonctionné.
   * Le dossier ''data'' qui contient tous les fichiers ''.tsv'' contenant les données du tracé.
+==== Démarche de génération d'une figure (inutile pour utilisateur) ====
+La démarche utilisée est récapitulée dans la figure suivante :
+<figure>
+{{ :ressources:latex:py2tikz:recap_total.png?1200 |}}
+<caption> Flowchart {{recap_total.pdf|pdf}} de ''py2tikz'' </caption>
+</figure>
@@ Ligne 65: / Ligne 83: @@
 == Graphique 2D simple (markers) ==
+La figure utilisée pour la base non régression est la suivante :
+<figure>
+{{ :ressources:latex:py2tikz:lineplots.png?600 |}}
+<caption> Figure matplotlib 2D simple </caption>
+</figure>
-|  {{ :ressources:latex:py2tikz:lineplots.png?600 |}} <caption> Graphique 2D matplotlib </caption> |{{pdfjs 450px,500px> :ressources:latex:py2tikz:lineplots.pdf  }}<caption> Graphique 2D tikz </caption>|
+Résultats compilés de l'exécution de ''py2tikz'' sur cette figure :
+  * Exécution sans options (par défaut) : {{lineplots_default.pdf|pdf}}
+  * Exécution avec options : {{lineplots.pdf|pdf}}
+  * Exécution avec ''split_subplots = True'' et axes log : {{lineplots_sep_merge.pdf|pdf}}