Debian Codegraph @

texmf-dist/doc/latex/tkz-fct/TKZdoc-fct-compilation.tex

raw
1 \section{Utilisation de Gnuplot}
2 %–––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––>
3 \subsection{Mécanisme d'interaction entre \TIKZ\ et \tkzname{Gnuplot}}
4
5 \TEX\ est un système logiciel de composition de documents ( text processing programm ). Il permet bien sûr de calculer, mais avec des moyens limités. \TIKZ\ est ainsi limité par \TEX\ pour effectuer des calculs. Pour rappel ±16383.99999 pt est l'intervalle dans lequel \TEX\ stocke ses valeurs. Sachant que 1 cm est égal à 28.45274 pt, on s'aperçoit que \TEX\ ne peut traiter que des dimensions inférieures à 5,75 mètres environ.
6 Bien sûr, cela paraît suffisant, mais malheureusement, pendant un enchaînement de calculs, il est assez facile de dépasser ces limites.
7
8 \bigskip
9 \tkzActivOff
10 \newcommand{\drawpage}[4]{%
11 \begin{scope}[xshift=#1, yshift=#2,font=\footnotesize]
12 \filldraw[fill=white!75!#4,draw=#4, very thin]%
13 (0,0) -- (4.2,0) -- (4.2,4.85) --(3.21,5.84)-- (0,5.84) -- cycle;
14 \fill[fill=#4,shade,top color=#4,bottom color=#4!40]%
15 (3.21,5.84) -- ++(0,-0.99) -- ++(0.99,0) -- cycle;
16 \path (2.1,2.97) node{#3};
17 \end{scope}
18 }
19
20 \begin{center}
21 \begin{tikzpicture}[>=triangle 45,scale=.75]
22 \drawpage{0cm}{0cm}{\texttt\blue\begin{minipage}{2cm}
23 sample.tex
24
25 with
26
27 \tkzcname{draw plot[id=fct] function{---.};}
28 \end{minipage}}{blue}
29 \drawpage{12cm}{0cm}{\texttt \red sample.fct.gnuplot}{red}
30 \drawpage{12cm}{-14cm}{\texttt\red sample.fct.table}{red}
31 \drawpage{0cm}{-14cm}{\texttt\blue\begin{minipage}{2cm}
32 sample.pdf
33
34 \bigskip
35 \shorthandoff{:}
36 \begin{tikzpicture}[domain=-1.5:.8]
37 \draw plot[id=f1,samples=200] function{x*x};
38 \end{tikzpicture}
39 \end{minipage}}{blue}
40
41 \path (8.05,2.9) node(A)
42 [diamond,%
43 draw,color = black,
44 fill = red!60,%
45 text = black,%
46 minimum size = 3 cm,%
47 font = \normalsize]
48 {{\texttt \tikzname-\TEX}};
49 \path (14.1,-4.08) node(B)
50 [diamond,%
51 draw,color=black,fill=green!60,%
52 text = black,%
53 minimum size = 3 cm,%
54 font = \normalsize]
55 {{\texttt gnuplot}};
56 \path (8.05,-11.1) node(C)
57 [diamond,%
58 draw,color = black,
59 fill = red!60,%
60 text = black,%
61 minimum size = 3 cm,%
62 font = \normalsize]
63 {{\texttt \tikzname-\TEX}};
64 \draw[->] (4.2,2.9) -- (A.west);
65 \draw[->] (A.east) -- (12,2.9);
66 \draw[->] (14.1,0) -- (B.north);
67 \draw[->] (B.south) -- (14.1,-8.18);
68 \draw[->] (12 ,-11.1)--(C.east);
69 \draw[->] (C.west)--(4.2,-11.1);
70 \draw[->,magenta] (4.2,2.9) to [ out =-80,in=260] node[below,pos=.5]{étape 1} (12,2.9);
71 \draw[->,magenta] (14.1,0) to [ out =200,in=160] node[left,pos=.5]{étape 2} (14.1,-8.18);
72 \draw[->,magenta] (12 ,-11.1) to [ out =110,in=70] node[above,pos=.5]{étape 3} (4.2,-11.1);
73 \end{tikzpicture}
74 \end{center}
75
76 \newpage
77
78 Pour tracer des courbes en 2D en contournant ces problèmes, un moyen simple offert par \TIKZ, est d'utiliser \tkzname{gnuplot}.
79
80 \tkzname{tkz-fct.sty} s'appuie sur le programme \tkzname{gnuplot} et le package \tkzname{fp.sty}. Le premier est utilisé pour obtenir une liste de points, et le second pour évaluer ponctuellement des valeurs.
81
82 Vous devez donc installer \tkzname{Gnuplot}, son installation dépend de votre système, puis il faudra que votre distribution trouve \tkzname{Gnuplot}, et que \TeX\ autorise \tkzname{Gnuplot} à écrire un fichier.
83
84 \begin{itemize}
85 \item \textcolor{red}{\textbf{Étape 1}}
86
87 On part du fichier \tkzname{sample.tex} suivant :
88
89 \medskip
90 \begin{tkzltxexample}[]
91 \documentclass{article}
92 \usepackage{tikz}
93 \begin{document}
94 \begin{tikzpicture}
95 \draw plot[id=f1,samples=200,domain=-2:2] function{x*x};
96 \end{tikzpicture}
97 \end{document}
98 \end{tkzltxexample}
99 \tkzActivOn
100
101 La compilation de ce fichier créé avec \TIKZ, produit un fichier nommé \tkzname{sample.f1.gnuplot}. Le nom du fichier est obtenu à partir de \tkzcname{jobname} et de l'option \tkzname{id}. Ainsi un même fichier peut créer plusieurs fichiers distincts. C'est un fichier texte ordinaire, affecté de l'extension \tkzname{gnuplot}. Il contient un préambule indiquant à \tkzname{gnuplot} qu'il doit créer une table contenant les coordonnées d'un certain nombre de points obtenu par la fonction définie par $x\longrightarrow x^2$. Ce nombre de points est défini par l'option \tkzname{samples}. Cette étape ne présente aucune difficulté particulière. Le fichier obtenu peut être traité manuellement avec \tkzname{gnuplot}. Le résultat est le fichier suivant :
102
103 \begin{tkzltxexample}[]
104 set table; set output "sample.f1.table"; set format "%.5f"
105 set samples 200; plot [x=-2:2] x*x
106 \end{tkzltxexample}
107
108 Une table sera créée et enregistrée dans un fichier texte nommé "sample.f1.table". Les nombres seront formatés pour ne contenir que 5 décimales.
109 La table contiendra 201 couples de coordonnées.
110
111 \item \textcolor{red}{\textbf{Étape 2}}
112
113 Elle est la plus délicate car le fichier \tkzname{sample.f1.gnuplot} doit être ouvert par \tkzname{gnuplot}. Cela implique d'une part, que \TEX\ autorise l'ouverture\footnote{c'est ici que l'on parle des options \tkzname{--shell-escape} et \tkzname{--enable-write18}}
114 du fichier \tkzname{sample.f1.gnuplot} par \tkzname{gnuplot} et d'autre part, que \TEX\ puisse trouver \tkzname{gnuplot}\footnote{c'est ici que l'on parle de \tkzname{PATH}}.
115
116 Si \tkzname{gnuplot} trouve \tkzname{sample.f1.gnuplot} alors il produit un fichier texte \tkzname{sample.f1.table} si l'expression de la fonction est correcte.
117
118 \item \textcolor{red}{\textbf{Étape 3}}
119
120 Le fichier \tkzname{sample.f1.table} obtenu à l'étape précédente est utilisé par \TIKZ\ pour tracer la courbe.
121
122 \medskip\hspace{1cm}
123 \begin{tkzltxexample}[]
124 # Curve 0 of 1, 201 points
125 # Curve title: "x*x"
126 # x y type
127 -2.00000 4.00000 i
128 -1.98000 3.92040 i
129 -1.96000 3.84160 i
130 ---.
131 1.98000 3.92040 i
132 2.00000 4.00000 i
133 \end{tkzltxexample}
134 \end{itemize}
135
136 \begin{enumerate}
137
138 \item Il faut remarquer qu'au cours d'une seconde compilation, si le fichier \tkzname{sample.f1.gnuplot} ne change pas, alors \tkzname{gnuplot} n'est pas lancé et le fichier présent \tkzname{sample.f1.table} est utilisé.
139
140 \item On peut aussi remarquer que si vous êtes paranoïaque et que vous n'autorisez pas le lancement de gnuplot, alors une première compilation permettra de créer le fichier \tkzname{sample.f1.table}, ensuite manuellement, vous pourrez lancer gnuplot et obtenir le fichier \tkzname{sample.f1.table}.
141
142 \item Il est aussi possible de créer manuellement ou encore avec un quelconque programme, un fichier data.table que \TIKZ\ pourra lire avec
143
144 \begin{tkzltxexample}[]
145 \draw plot[smooth] file {data.table};
146 \end{tkzltxexample}
147 \end{enumerate}
148
149 \subsection{Installation de \tkzname{Gnuplot}}
150
151 Gnuplot est proposé avec la plupart des distributions Linux, et existe pour OS X ainsi que pour Windows.
152
153 \begin{enumerate}
154 \item \tkzname{Ubuntu}\NameSys{Linux Ubuntu} ou un autre système Linux: on l'installe en suivant la procédure classique d'installation d'un nouveau paquetage.
155 \item \tkzname{Windows}\NameSys{Windows XP} Les utilisateurs de Windows doivent se méfier, après avoir téléchargé la bonne version et installé \tkzname{gnuplot} alors il faudra renommé wgnuplot en gnuplot. Ensuite il faudra modifier le \tkzname{path}. Si le chemin du programme est \shorthandoff{:}\tkzname{C:\textbackslash gnuplot} alors il faudra ajouter \tkzname{{C:}\textbackslash gnuplot\textbackslash bin\textbackslash}\shorthandon{:} aux variables environnement (Aller à "Poste de Travail" puis faire "propriétés", dans l'onglet "Avancé", cliquer sur "Variables d'environnement". ).
156 Ensuite pour compiler sous latex, il faudra ajouter au script de compilation l'option \tkzname{--enable-write18 }.
157 \item \tkzname{OS X}\NameSys{OS X} C'est le système qui pose le plus de problème, car il faut compiler les sources.
158 \end{enumerate}
159
160 \subsection{ Test de l'installation de tkz-base}
161 Enregister le code suivant dans un fichier avec le nom test.tex, puis compiler avec pdflatex ou bien lualatex. Vous devez obtenir cela :
162
163
164 \begin{tkzltxexample}[]
165 \documentclass{scrartcl}
166 \usepackage{tkz-fct}
167 \begin{document}
168 \begin{tikzpicture}
169 \tkzInit[xmin=-5,xmax=5,ymax=2]
170 \tkzGrid
171 \tkzAxeXY
172 \end{tikzpicture}
173 \end{document}
174 \end{tkzltxexample}
175
176 \begin{tikzpicture}
177 \tkzInit[xmin=-5,xmax=5,ymax=2]
178 \tkzGrid
179 \tkzAxeXY
180 \end{tikzpicture}
181
182
183
184 \subsection{ Test de l'installation de tkz-fct}
185 Il suffit d'ajouter une ligne pour tracer la représentation graphique d'une fonction.
186
187 \begin{tkzltxexample}[]
188 \documentclass{scrartcl}
189 \usepackage[usenames,dvipsnames]{xcolor}
190 \usepackage{tkz-fct}
191 \begin{document}
192 \begin{tikzpicture}[scale=1.25]
193 \tkzInit[xmin=-5,xmax=5,ymax=2]
194 \tkzGrid
195 \tkzAxeXY
196 \tkzFct[color=red]{2*x**2/(x**2+1)}
197 \end{tikzpicture}
198 \end{document}
199 \end{tkzltxexample}
200
201 \begin{tkzexample}[]
202 \begin{tikzpicture}[scale=1.25]
203 \tkzInit[xmin=-5,xmax=5,ymax=2]
204 \tkzGrid
205 \tkzAxeXY
206 \tkzFct[color=red]{2*x**2/(x**2+1)}
207 \end{tikzpicture}
208 \end{tkzexample}
209 \endinput