Debian Codegraph @

texmf-dist/doc/latex/bodegraph/bodegraph.tex

raw
1
2 % !TeX program =pdfLatex+shell-escape
3 % !TeX encoding = utf8
4 % !TeX spellcheck = fr
5
6 \documentclass[a4paper,12pt]{article} % Type de document
7 \usepackage[french]{babel}
8
9
10 \usepackage[T1]{fontenc} % Correspondance clavier -> document (sous pdflatex } shell-escape)
11 \usepackage{kpfonts}
12 \usepackage[usenames,dvipsnames]{xcolor}
13 \usepackage{tikz}
14 \usetikzlibrary{arrows,snakes,tikzmark,fit,positioning}
15 \usepackage[listings,most]{tcolorbox}
16 \usepackage{listings}
17 \usepackage{color}
18 \usepackage{verbatim}
19
20
21
22 \usepackage{calc,fullpage}
23 \usepackage{amsmath,amssymb}
24 \usepackage{url}
25
26
27 \usepackage{siunitx}
28 \sisetup{output-decimal-marker={,},group-minimum-digits=4,abbreviations,
29 detect-family = true}
30
31 \usepackage{multicol}
32
33 \usepackage{graphicx}
34
35
36 \usepackage[unicode]{hyperref}
37
38
39 \usepackage{bodegraph}
40
41
42 %---------------Commandes mise en forme des exemples ----------
43
44 \usepackage[most]{tcolorbox}
45 \newtcblisting{tikzexample}[1][]{%tikz lower,
46 colback=red!5!white,colframe=red!75!black,listing side text,
47 title=,fonttitle=\bfseries,
48 toprule=2mm,
49 bicolor,
50 colback=red!15!white,
51 colbacklower=red!5!white, %white,
52 %listing options={style=tcblatex,basicstyle=\small},
53 #1}
54
55
56
57 \newtcblisting{tikzexampleL}[1][]{%tikz lower,
58 listing above text,
59 colback=red!5!white,
60 colframe=red!75!black,
61 title=,fonttitle=\bfseries,
62 toprule=2mm,
63 bicolor,
64 colback=red!15!white,
65 colbacklower=red!5!white, %white,
66 listing options={style=tcblatex,basicstyle=\small},
67 #1}
68
69 \DeclareTotalTCBox{\myverb}{ v }{verbatim,
70 colframe=red!75!black,colupper=blue}{#1}
71
72
73
74 %---------------Commandes de traduction--------------------
75
76 \newcommand{\traduction}[2]{
77 \begin{tikzpicture}
78 \coordinate(O);
79 \node[text width=0.48\linewidth,below left=0 and 0.01\linewidth of O,align=justify](n1){
80 #1
81 };
82 \node[text width=0.48\linewidth,,below right=0 and 0.01\linewidth of O,align=justify](n2){
83 \color{blue}
84 #2
85 };
86 \draw[blue] (O) -- (O|-n1.south) -- (O|-n2.south);
87 \end{tikzpicture}
88 }
89
90 \newcommand{\TradEnLigne}[2]{
91 #1 / {\color{blue}#2}
92 }
93
94
95 %-------------PAGE-DE-GARDE----------------------------------------------------
96
97 \title{Diagrammes de Bode, Black et Nyquist avec PGF/TIKZ} % Titre
98 \author{Papanicola Robert\thanks{Merci à Germain Gondor pour ses remarques et à Mariachiara Garofalo pour la traduction}} % Auteur(s)
99
100 \date{\today} % Date (\today pour aujourd'hui)
101
102
103 %-------------DEBUT-DU-DOCUMENT-----------------------------------------------
104 \makeindex
105
106 \begin{document}
107
108 \maketitle
109
110
111 \begin{description}
112 \item[version 1.6] 04/11/2023: \TradEnLigne{Traduction en anglais de la documentation par Mariachiara Garofalo. Correction de quelques coquilles et ré-écriture des exemples. Utilisation du package \textbf{tcolorbox} pour les exemples.}{English translation of the documentation by Mariachiara Garofalo. Fixed some typos and rewrote examples. Using the \textbf{tcolorbox} package for examples.}
113 \item[version 1.5] 24/06/2014 : \TradEnLigne{Petites modifications pour prendre en compte les évolutions de pgf.}{Small modifications to take into account the developments of pgf3.}
114 \item[version 1.41] 08/06/2011: Ajout de la commande \myverb{\Unites{}}, légère modification du positionnement des légendes.
115 \item[version 1.4] 09/10/2010 : Modification du répertoire par défaut des fichiers Gnuplot.
116 \item[version 1.3] 1/05/2010 :
117 \begin{itemize}
118 \item Ajout de la commande \myverb{\semilogNG} qui permet de tracer un diagramme semi-log sans graduation
119 \item suppression de tous les styles (couleurs et épaisseurs) et remplacement par des styles définis par \myverb{\tikzset};
120 \item Ajout de la commande \myverb{\BodePoint}.
121
122 \end{itemize}
123 \item[version 1.2.1:] 20/01/2010 : ajout de la commande \myverb{\semilog*} pour une grille log plus fine.
124 \item [version 1.2:] 22/08/2009,
125 \begin{itemize}
126 \item remplacement des commandes \myverb{\BodeAmp} et \myverb{\BodeArg} par \myverb{\BodeGraph}, ces deux commandes sont maintenues pour assurer la compatibilité avec les anciens fichiers.
127 \item ajout des commandes \myverb{\BlackText} et \myverb{\NyquistText} permettant d'annoter les courbes de Black et Nyquist;
128 \item ajout de la commande \myverb{\BodePoint}
129
130 qui permet de marquer sur les diagrammes une liste de points par une puce (pas d'annotation de ces points);
131
132 \item ajout d'un style pour les puces;
133
134 \end{itemize}
135
136 \item[version 1.1:] 03/05/2009, ajout;
137 \begin{itemize}
138 \item abaque temps de réponse 2\up{nd} ordre,
139 \item abaque des dépassements d'un 2\up{nd} ordre;
140 \end{itemize}
141 \item[version 1:] mise en ligne de la version initiale 06/04/2009.
142
143
144 \end{description}
145
146
147
148 \section{\TradEnLigne{Introduction}{Introduction}}
149
150 \traduction{Ce package permet de tracer les diagrammes de Bode, Black et Nyquist à l'aide de Gnuplot et Tikz. Les fonctions de transfert élémentaires et les correcteurs courants sont préprogrammés pour être utilisés dans les fonctions de tracé.
151 }{This package allows to draw Bode, Nichols and Nyquist graphs using Gnuplot and Tikz. Basic transfer functions and correctors are pre-installed to be used in the tracing functions.
152 }
153
154
155 \subsection{ \TradEnLigne{Nécessite}{ Need}}
156
157 \traduction{Pour fonctionner ce package a besoin:
158 \begin{itemize}
159 \item d'une version CVS de Pgf/Tikz (certaines commandes de calculs ont étés modifiées ou intégrées depuis la version 2), elle peut être téléchargée sur le site Texample \url{http://www.texample.net/tikz/builds/}.
160 \item que \emph{gnuplot} soit installé et configuré pour être exécuté lors de la compilation de votre fichier \LaTeX (Cf. la doc de Pgf/Tikz).
161 \end{itemize}
162 }{To run this package requires:
163 \begin{itemize}
164 \item a CVS Pgf / Tikz (some commands calculations have summers modified or integrated since version 2) it can be downloaded from Texample http://www.texample.net/tikz/builds/
165 \item Gnuplot must be installed and configured to be executed when compiling your ...file (see the doc Pgf/Tikz)
166 \end{itemize}
167 }
168
169
170
171
172 \subsection{\TradEnLigne{Composition du package}{Composition of Package}}
173
174 \traduction{Ce package est constitué de trois fichiers:
175 \begin{itemize}
176 \item bodegraph.sys : le package proprement dit;
177 \item isom.txt : macro-commandes de définition des courbes iso-module;
178 \item isoa.txt : macro-commandes de définition des courbes iso-arguments.
179 \end{itemize}
180 et du fichier bodegraph.tex, ce fichier contenant la documentation.
181 Les courbes gnuplot précalculées sont dans le répertoire /gnuplot/.
182 }{Package This package consists of three files:
183 \begin{itemize}
184 \item bodegraph.sys: the package itself;
185 \item Isom.txt: macros defining curves iso-module
186 \item Isoa.txt: macros definition curves iso-arguments.
187 \end{itemize}
188 bodegraph.tex file, the file containing the documentation.
189 Gnuplot precomputed curves are in the directory /gnuplot/.
190 }
191
192
193
194
195 \subsection{\TradEnLigne{Utilisation}{ Use}}
196
197 \traduction{
198 Décompresser l'archive du package dans votre répertoire personnel.
199 Rajouter dans l’entête la commande :
200 }{Unzip the archive package in your home directory.
201 Add in the header control:
202 }
203 \myverb{\usepackage{bodegraph}}
204
205 \subsection{\TradEnLigne{À faire}{To Do}}
206
207 \traduction{
208 \begin{itemize}
209 \item Compléter les fonctions élémentaires,
210 \item Traduction correcte en anglais,
211 \item \dots
212 \end{itemize}
213 }{
214 \begin{itemize}
215 \item Complete the basic functions
216 \item Better english !!!
217 \item \dots
218 \end{itemize}
219 }
220
221
222
223
224
225
226 \section{\TradEnLigne{Les commandes}{ Commands}}
227
228
229 \subsection{\TradEnLigne{Grille semilog}{ semilog grid}}
230
231 \begin{itemize}
232 \item \myverb{\semilog{décade mini}{décade maxi}{ymini}{ymaxi} }
233 \item \myverb{\semilog*{décade mini}{décade maxi}{ymini}{ymaxi} }
234 \end{itemize}
235
236
237 \traduction{
238 Cette commande générique, étoilée ou non (fig.~\ref{fig:semilog}) permet de tracer une grille semilog. La commande étoilée permet d'afficher une grille logarithmique plus précise (demi valeur).
239 }{
240 This generic command, starred or not (fig.~\ref{fig:semilog}), allows to draw a semilog grid. When the command is starred, it allows to attach a logarithmic grid more precise (semi value).
241 }
242
243
244
245 \begin{figure}[!htb]
246 \centering
247
248 \begin{tikzexample}[title=,righthand width=0.55\textwidth,]
249 \begin{tikzpicture}
250 [yscale=2/30,xscale=7/5]
251 \semilog{-2}{3}{-20}{10}
252 \end{tikzpicture}
253 \end{tikzexample}
254
255 \begin{tikzexample}[title=,righthand width=0.55\textwidth,]
256 \begin{tikzpicture}
257 [yscale=2/30,xscale=7/5]
258 \semilog*{-2}{3}{-20}{10}
259 \end{tikzpicture}
260 \end{tikzexample}
261 \caption{Grille semilog avec graduation}
262 \label{fig:semilog}
263 \end{figure}
264
265
266
267
268 \traduction{
269 L'amplitude des coordonnées de l’abscisse doit être donnée en décade, de $10^\text{décade mini}$ à $10^\text{décade maxi}$, l'ordonnée varie elle de $ymini$ à $ymaxi$.
270
271 On utilisera les commandes d'échelles de tikz pour adapter les dimensions de la grille à celle de la page. Ainsi si on souhaite afficher un diagramme d'amplitude de 5 décades de $10^{-1}$ à $10^{4}$ sur \SI{7}{\centi\metre} et $\SI{80}{\deci\bel}$ de $-60$ à $\SI{20}{\deci\bel}$ sur \SI{3}{\centi\metre}, le diagramme de phase de$\ang{- 180}$ à $\ang{0}$ sur $\SI{3}{\cm}$ avec un pas vertical de \ang{30}en précisant les unités (fig.~\ref{fig:semilog}).
272 }
273 {
274 The amplitude of the coordinates of the X axis must be given in decades, from $10^\text{minimum decade}$ to $10^\text{maxi decade}$.
275
276 You can use the commands of the tikz scales to adjust the grid dimension to the one of the page. Therefore, if you would like to attach an amplitude graph of 5 decades of $10^{-1}$ to $10^4$ on \SI{7}{\centi\metre} and \SI{80}{\deci\bel} of $-60$ to $\SI{20}{\deci\bel}$ on \SI{3}{\centi\metre}, phase graph of $-\ang{180}$ to $\ang{0}$ on $\SI{3}{\cm}$ with a vertical step of \ang{30} specifying the unites (fig.~\ref{fig:semilog}).
277 }
278
279
280
281
282
283 \subsection{\TradEnLigne{Grille semilog sans graduation}{grid without graduation} }
284
285
286 \begin{itemize}
287 \item \myverb{\semilogNG{nbdec}{y}}
288 \end{itemize}
289
290 \traduction{
291 Cette commande permet de tracer des diagrammes semi log sans graduation (fig.~\ref{fig:semilogNG}), le premier paramètre est le nombre de décade, le second l'amplitude des ordonnées.
292 }
293 {
294 This command allows to draw semilog graphs without graduation (fig.~\ref{fig:semilogNG}), the first parameter is the number of decade, the second the amplitude of ordinates.
295 }
296
297 \begin{figure}[!htb]
298 \centering
299 \begin{tikzexample}[title=,righthand width=0.5\textwidth,]
300 \begin{tikzpicture}
301 [yscale=3/50,
302 xscale=0.9\textwidth/3cm]
303 \semilogNG{3}{50}
304 \end{tikzpicture}
305 \end{tikzexample}
306 \caption{Grille semilog sans graduation}
307 \label{fig:semilogNG}
308 \end{figure}
309
310
311
312 \subsection{\TradEnLigne{Paramètres}{ parameters}}
313
314
315
316 \begin{figure}[!htb]
317 \centering
318 \begin{tikzexample}[title=,righthand width=0.55\textwidth,]
319
320 \begin{tikzpicture}
321 [xscale=7/5]
322 \begin{scope}[yscale=3/80]
323 \UnitedB
324 \semilog*{-1}{4}{-60}{20}
325 \end{scope}
326
327 \begin{scope}
328 [yshift=-3cm,yscale=3/180]
329 \UniteDegre
330 \OrdBode{30}
331 \semilog*{-1}{4}{-180}{0}
332 \end{scope}
333 \end{tikzpicture}
334
335 \end{tikzexample}
336
337 \caption{Grille semilog avec unités}
338 \label{fig:semilog-parametre}
339 \end{figure}
340
341
342 \begin{itemize}
343 \item \myverb{\UnitedB}
344
345 \traduction{permet d'afficher les unités pour un diagramme d'amplitude}{
346 allows to attach unites for an amplitude graph
347 }
348
349
350 %\myverb{\uniteDB}
351
352 \item \myverb{ \UniteDegre}
353
354 \traduction{permet d'afficher les unités pour un diagramme de phase.}
355 { allows to attach unites for a phase graph.}
356
357 \item \myverb{\OrdBode{pas}}
358
359 \traduction{permet de préciser le pas des graduations verticales (par défaut 10) du diagramme semilog.}
360 {allows to specify the step of vertical graduations ( 10 by default) of the graph
361 }
362
363 \item \myverb{\Unites{label axe X}{label axe Y}}
364
365 \traduction{permet de préciser directement les unités des axes.}
366 {allows to specify the label of axes
367 }
368 \item \myverb{\Unitx{}} et \myverb{\Unity{}}
369
370 \traduction{permettent de choisir directement les unités à afficher, à utiliser sous la forme
371 {\texttt{\def\Unity{}} }
372 }
373 {allow to choose directly the unites to attach, to be used under the form {\texttt{\def\Unity{}} }
374 }
375
376 \end{itemize}
377
378
379
380
381
382
383
384 \subsubsection{Style du diagramme}
385
386
387 \begin{figure}[!htb]
388 \centering
389 \begin{tikzexampleL}[title= ]
390 \begin{tikzpicture}
391 \begin{scope}[yscale=2/50,xscale=0.9\textwidth/2cm]
392 \semilog*{0}{2}{-20}{30}
393 \end{scope}
394 \begin{scope}[yshift=-3cm,
395 yscale=2/50,xscale=0.9\textwidth/2cm]
396 \tikzset{
397 semilog lines/.style={thin, blue},
398 semilog lines 2/.style={semilog lines,red!50 },
399 semilog half lines/.style={semilog lines 2,dotted },
400 semilog label x/.style= {semilog lines, below,font=\tiny},
401 semilog label y/.style={semilog lines,right,font=\tiny}
402 }
403 \semilog*{0}{2}{-20}{30}
404 \end{scope}
405 \end{tikzpicture}
406 \end{tikzexampleL}
407
408
409
410
411 \caption{Modification des styles par défaut}
412
413 \label{fig:semilogstyle}
414 \end{figure}
415
416
417
418 \traduction{Les styles de tracé par défaut sont définis à l'aide de la commande \texttt{\textbackslash tikzset } (voir figure~\ref{fig:semilogstyle})}{Default drawing styles are defined by the command \texttt{\textbackslash tikzset } ( see figure~\ref{fig:semilogstyle}) }
419
420 \begin{itemize}
421 \item \myverb{ Bode lines/.style={very thick, blue}}:
422
423 \traduction{ style par défaut des tracé de bode (amplitude et gain);}{
424 default style of the bode plot (amplitude and gain) ;
425 }
426
427 \item \myverb{ asymp lines/.style={Bode lines,thin}}:
428
429 \traduction{style, déduit du précédent, utilisable pour tracer les asymptotes;}
430 { style, deduced by the previous one, it can be used to trace the asymptotes, ;
431 }
432
433 \item \myverb{ semilog lines/.style={thin, brown}}:\\
434 \traduction{ style par défaut de la grille semilog;}
435 {default style of the semilog grid ;
436 }
437 \item \myverb{ semilog half lines/.style={semilog lines 2, dashed }}:
438
439 \traduction{style par défaut des demi pas de la grille semilog;}
440 {default style of the grid half step ;
441 }
442
443 \item \myverb{ semilog label x/.style={semilog lines,below,font=\tiny}}:
444
445 \traduction{style des labels de l'axe des abscisses de la grille semilog;}{
446 style of the grid X axis labels ;
447 }
448 \item \myverb{ semilog label y/.style={semilog lines,right,font=\tiny}}:
449
450 \traduction{ idem pour l'axe des ordonnées.}{
451 do the same for the Y axis
452 }
453 \end{itemize}
454
455
456
457 %
458
459
460 \traduction{ Vous pouvez, en modifiant ces styles agir les tracés par défaut (fig.~\ref{fig:semilogstyle}).}{
461 You can move the defaults drawings by modifying these styles
462 }
463
464
465
466
467
468 \subsection{ \TradEnLigne{Tracé des diagrammes}{Drawing bode graph} }
469
470 \subsubsection{\TradEnLigne{Commandes}{Commands}}
471
472 \traduction{Les commandes de tracés nécessitent que gnuplot (\url{http://www.gnuplot.info/}) soit installé et utilisable par votre distribution \LaTeX.}{Plot commands require gnuplot (\url{http://www.gnuplot.info/}) to be installed and usable by your \LaTeX distribution.
473 }
474
475 \traduction{Trois commandes permettent de tracer les diagrammes d'amplitude et de phase. (fig.~\ref{fig:utilBodeGraph}).}{Three commands allow you to draw amplitude and phase diagrams (fig.~\ref{fig:utilBodeGraph}).}
476
477 \begin{itemize}
478 \item \myverb{\BodeGraph[Options]{domain}{fonction}}:
479
480 \traduction{pour le diagramme d'amplitude et de phase.}{
481 for the amplitude and phase graph.
482 }
483
484 \item \myverb{\BodeGraph*[Options]{domain}{fonction}{[options]{texte}}}
485
486 \traduction{ réalise le tracé et ajoute le texte avec les options précisées à l'extrémité.}{
487 draw the graph and add the text by using the options at the end.
488 }
489
490 \item \myverb{\BodePoint[Options]{liste}{fonction}}
491
492 \traduction{ place les points de la liste sur le diagramme.}
493 {place the list points on the graph.
494 }
495
496 \end{itemize}
497
498
499
500 \TradEnLigne{avec}{with}
501
502 \begin{itemize}
503 \item \myverb{domain}:
504
505 \traduction{
506 le domaine du tracé précisé en puissance de 10, ainsi pour tracer une fonction de $\SI{e-2}{\radian\per\second}$ à $\SI{e3}{\radian\per\second}$ on notera le domaine \textbf{ \{-2:3\} }.}{
507 the graph domain precised in power of 10 le, therefore to draw a function of $\SI{e-2}{\radian\per\second}$ to $\SI{e3}{\radian\per\second}$ you will note the domain \textbf{ \{-2:3\} }.
508 }
509
510 \item \myverb{ fonction}
511
512 \traduction{ la fonction à tracer écrite avec la syntaxe gnuplot.}
513 {the function on the drawing written with gnuplot syntax.}
514
515 \item \myverb{ options}
516
517 \traduction{Toutes les options de tracé de tikz et de gnuplot peuvent être utilisées et substituent à celle par défaut, on notera principalement:}{all the options of tikz and gnuplot drawings can be used to replace the default ones, it may be noted mainly:}
518
519
520
521 \begin{itemize}
522 \item \TradEnLigne{spécifiques à tikz}{specifics to tikz}
523 \begin{itemize}
524 \item \TradEnLigne{la couleur}{the colour} : \myverb{[red]}, \myverb{[blue]}, \dots
525 \item \TradEnLigne{l'épaisseur}{the thickness}: \myverb{[thin]}, \myverb{[thick]}, \dots
526 \item \TradEnLigne{le style}{the style}: \myverb{[dotted]}, \myverb{[dashed]}, \dots
527 \end{itemize}
528 \item \TradEnLigne{spécifiques à gnuplot}{specifics to gnuplot}
529 \begin{itemize}
530 \item \TradEnLigne{nombre de points}{number of points} : \myverb{ [samples=xxx] }
531
532 \item \TradEnLigne{Nom du fichier créé}{File name} \myverb{[id=nomdufichier]}
533
534 \item \TradEnLigne{Répertoire par défaut}{default directory} \myverb{prefix=gnuplot/\jobname}
535
536 \item \TradEnLigne{valeurs par défaut}{ default values} : \myverb{ [samples=50, thick, blue]}) l
537
538
539 \traduction{Il est à noter que tikz, sauvegarde au premier appel de gnuplot la table des valeurs et que si celle-ci est inchangée lors d'une compilation ultérieure, tikz réutilise la table précédemment sauvée. il est donc important pour minimiser le temps de compilation de préciser un id différent pour chaque courbe, par défaut les macros sauvegardent les graphes dans des fichiers différents (incrémentation d'un compteur).}
540 {It should be noticed that tikz saves at the first order of gnuplot the table of values and if it is not modified at the time of a further compilation, tikz reuses the table previously saved. Therefore, it is important, in order to reduce the compilation time, to specify a different id for each curve. As default macros save the graphs into different files (incrementing a counter).}
541
542 \item Répertoire/ directory: \myverb{[prefix=repertoire/] }
543
544 \traduction{Le répertoire de sauvegarde des tables de données . Cette configuration par défaut est réglé par un style défini en utilisant la commande :}{
545 This default configuration is regulated by a style defined using:
546 }
547
548 {\scriptsize
549 \myverb{\tikzset{gnuplot def/.style={samples=50,id=\arabic{idGnuplot},prefix=gnuplot/\jobname } }}
550 }
551
552 \traduction{Sur certains systèmes (windows), le répertoire \textbf{gnuplot/\jobname } est créé par gnuplot, si ce n'est pas le cas, vous devez le créer.}{On some systems (windows), the \textbf{gnuplot/\jobname } directory is created by gnuplot, if this is not the case, you must create it.}
553 \end{itemize}
554 \item \TradEnLigne{pour les autres options, consulter la documentation de tikz.}{ for the other options consult tikz documentation.}
555 \end{itemize}
556 \item \TradEnLigne{styles prédéfinis}{preset styles} :
557
558 \traduction{
559 plusieurs styles sont prédéfinis.}{many styles are preset.}
560 \end{itemize}
561
562
563
564 \subsubsection{\TradEnLigne{Exemples}{Examples}}
565
566 \traduction{Pour tracer le diagramme d'amplitude de la fonction du premier ordre, $H(s) =\dfrac{3}{1+0.3\cdot s}$ entre $10^{-2}$~rad/s et $10^{2}$~rad/s sur une grille semi logarithmique, on utilise la séquence de commandes ci-dessous.}{To draw an amplitude graph of the first order function , $H(s) =\dfrac{3}{1+0.3\cdot s}$ between $10^{-2}$~rad/s et $10^{2}$~rad/s on a semi logarithmic grids, you can use the commands sequence below.}
567
568 \begin{figure}[!ht]
569 \centering
570 \begin{tikzexample}[title=,righthand width=0.4\textwidth,]
571 \begin{tikzpicture}
572 [xscale=5/4,yscale=5/30]
573 \NomGnuplot[orde1-]
574 \UnitedB
575 \semilog{-2}{2}{-20}{10}
576 \BodeGraph{-2:2}
577 {20*log10(abs(3/sqrt(1+(0.3*10**t)**2)))}
578 \end{tikzpicture}
579 \end{tikzexample}
580 \caption{Utilisation de BodeGraph}
581 \label{fig:utilBodeGraph}
582 \end{figure}
583
584
585 \begin{figure}[!ht]
586 \centering
587 \begin{tikzexample}[title=,righthand width=0.45\textwidth,]
588 \begin{tikzpicture}
589 [xscale=6/4,yscale=5/30]
590 \Unites{rad/s}{Module en dB}
591 \semilog{-2}{2}{-20}{10}
592 \BodePoint{0.1,0.15,0.5,1,2.5,
593 5,10,20,50,80}
594 {20*log10(abs(3/sqrt
595 (1+(0.3*10**t)**2)))}
596 \end{tikzpicture}
597 \end{tikzexample}
598 \caption{Utilisation de BodePoint}
599 \label{fig:utilBodePoint}
600 \end{figure}
601
602 \clearpage
603
604 \subsection{\TradEnLigne{Fonctions de transfert élémentaires préprogrammées }{\\ pre-programmed elementary transfer functions }}
605
606 \traduction{Les fonctions de base pour tracer les diagrammes de Bode des systèmes du premier, du second ordre, et l'intégration, sont directement implémentées dans le package ainsi que les diagrammes asymptotiques de ces même fonctions.}{Basic functions to draw Bode graphs of the first, second order systems, and integration, are directly implemented in the package, as well as asymptotic graphs of the same functions.}
607
608
609
610 \traduction{Ces fonctions ne peuvent être utilisées qu'avec les commandes de tracé:}{These functions can only be used with the drawing commands : }
611
612 \begin{itemize}
613 \item \myverb{\BodeGraph[Options]{domaine}{fonction}};
614 \item \myverb{\BodeGraph*[Options]{domaine}{fonction}};
615 \end{itemize}
616
617 \traduction{Le tracé des asymptotes présente un défaut à la cassure, cela est du à la finesse du tracé avec gnuplot, pour améliorer ce tracé, il est possible d'utiliser l'option \textbf{ const plot} qui permet de tracer des créneaux et d'augmenter le nombre de points à calculer \textbf{ samples=xxx} et mais cela risque d’accroître le temps de compilation.}
618 {Asymptotes graph presents a defect on the break, this is due to the thinness of the graph with gnuplot. To improve this drawing, it is possible to use the option \textbf{ const plot} which allows to draw crenels and to increase the number of points to calculate \textbf{ samples=xxx} . However, this risks to increase the compilation time. }
619
620 \newpage
621
622 \subsubsection{\TradEnLigne{Premier ordre}{First order}}
623
624 \traduction{Deux commandes implémentent les formules permettant le tracé des diagrammes d'amplitude et de phase par gnuplot de la fonction du premier ordre $H_1(s)=\dfrac{K}{1+\tau\cdot s}$ et deux autres les diagrammes asymptotiques (fig.~\ref{fig:premierordre}):}{Two commands implement formulae which allow the drawing of amplitude and phase graphs , through gnuplot, of the first order function $H_1(s)=\dfrac{K}{1+\tau\cdot s}$ And two others for the asymptotic graphs (fig.~\ref{fig:premierordre}):}
625
626
627 \begin{figure}[!htb]
628 \centering
629 \begin{tikzexample}[title=,righthand width=0.55\textwidth,]
630
631 \begin{tikzpicture}
632 [xscale=7/4]
633 \begin{scope}[yscale=4/40]
634 \semilog{-2}{2}{-20}{20}
635 \BodeGraph[asymp lines,red,samples=100]
636 {-2:2}{\POAmpAsymp{6}{0.3}}
637 \BodeGraph{-2:2}
638 {\POAmp{6}{0.3}}
639 \end{scope}
640
641 \begin{scope}
642 [yshift=-3.5cm,yscale=4/90]
643 \semilog{-2}{2}{-90}{0}
644 \BodeGraph[asymp lines,
645 red, samples=100,
646 const plot]{-2:2}
647 {\POArgAsymp{6}{0.3}}
648 \BodeGraph{-2:2}
649 {\POArg{6}{0.3}}
650 \end{scope}
651 \end{tikzpicture}
652
653 \end{tikzexample}
654 \caption{Premier ordre}
655 \label{fig:premierordre}
656 \end{figure}
657
658
659
660 \begin{itemize}
661 \item \myverb{\POAmp{K}{tau}} \TradEnLigne{pour le diagramme d'amplitude, avec \textbf{ K} le gain \textbf{ tau} la constante de temps}{ for the amplitude graph, with \textbf{K} as gain \textbf{tau} constant of time };
662 \item \myverb{\POAmpAsymp{K}{tau}} \TradEnLigne{pour le diagramme asymptotique d'amplitude}{for the asymptotic amplitude graph};
663 \item \myverb{\POArg{K}{tau}} \TradEnLigne{pour le diagramme de phase}{for the phase graph};
664 \item \myverb{\POArgAsymp{K}{tau}} \TradEnLigne{pour le diagramme asymptotique de phase}{for the asymptotic phase graph}.
665 \end{itemize}
666
667 \traduction{Remarque : \textbf{ K} n'est pas utile pour tracer le diagramme de phase, il est juste maintenu pour faciliter l'écriture de la fonction par copie directe de la commande de tracer du module.}{Note: \textbf{K} is not useful anymore to trace a phase graph,it is only kept to simplify the writing od the function by a direct copy of the module drawing.}
668
669
670
671
672 %\newpage
673
674 \subsubsection{\TradEnLigne{Second ordre}{Second order }}
675
676
677 \begin{figure}[!htb]
678 \centering
679 \begin{tikzexample}[title=,righthand width=0.55\textwidth,]
680 \begin{tikzpicture}[xscale=7/3]
681 \tikzset{
682 mylines/.style={very thick, red},
683 myasymp/.style={Bode lines,thin,blue}}
684 \begin{scope}[yscale=4/40]
685 \UnitedB
686 \semilog{-1}{2}{-20}{20}
687 \BodeGraph[myasymp]{-1:1.7}
688 {\SOAmpAsymp{6}{0.3}{10}}
689 \BodeGraph[mylines,
690 samples=101]{-1:1.7}
691 {\SOAmp{6}{0.3}{10}}
692 \end{scope}
693 \begin{scope}
694 [yshift=-3cm,yscale=4/180]
695 \OrdBode{30}
696 \UniteDegre
697 \semilog{-1}{2}{-180}{0}
698 \BodeGraph[myasymp, const plot]{-1:2}
699 {\SOArgAsymp{6}{0.3}{10}}
700 \BodeGraph[mylines]{-1:2}
701 {\SOArg{6}{0.3}{10}}
702 \end{scope}
703 \end{tikzpicture}
704 \end{tikzexample}
705 \caption{Second ordre}
706 \label{fig:Secondordre}
707 \end{figure}
708
709
710 \traduction{Deux commandes implémentent les formules permettant le tracé des diagrammes d'amplitude et de phase par gnuplot de la fonction du second ordre $H_2(s)=\dfrac{K}{1+\frac{2\cdot z}{\omega_n}\cdot s +\frac{s^2}{\omega_n^2}}$ et deux pour le tracé des asymptotes (fig.~\ref{fig:Secondordre}):}{Two commands implement formulae which allow the drawing of amplitude and phase graphs of the second order function $H_2(s)=\dfrac{K}{1+\frac{2\cdot z}{\omega_n}\cdot s +\frac{s^2}{\omega_n^2}}$ And two for the asymptotic graphs (fig.~\ref{fig:Secondordre}): }
711
712 \begin{itemize}
713 \item \TradEnLigne{Pour le diagramme d'amplitude, avec \textbf{K} le gain, \textbf{z} le coefficient d'amortissement et \textbf{Wn} la pulsation propre;}{for the amplitude graph, with \textbf{K} the gain, \textbf{z} damping coefficient and \textbf{Wn} the natuarl pulsation }: \\
714 \myverb{\SOAmp{K}{z}{Wn}}
715 \item \TradEnLigne{Pour le diagramme asymptotique d'amplitude}{ for the asymptotic amplitude graph }:\\ \myverb{\SOAmpAsymp{K}{z}{Wn}}
716 \item \TradEnLigne{Pour le diagramme de phase}{for the phase graph}:\\ \myverb{\SOArg{K}{z}{Wn} }
717 \item \TradEnLigne{Pour le diagramme asymptotique de phase;}{for the asymptotic phase graph}: \\
718 \myverb{\SOArgAsymp{K}{z}{Wn}}
719 \end{itemize}
720
721
722
723 %\newpage
724
725 \subsubsection{\TradEnLigne{Intégrateur}{Integrator }}
726 $H_i(s)=\dfrac{K}{s}$ (fig.~\ref{fig:integrateur})
727 \begin{itemize}
728 \item \TradEnLigne{Diagramme d'amplitude;}{Amplitude graph }: \myverb{\IntAmp{K}}
729 \item \TradEnLigne{Diagramme de phase.}{Phase graph}: \myverb{\IntArg{K}}
730 \end{itemize}
731
732
733 \begin{figure}[!htb]
734 \centering
735 \begin{tikzexample}[title=,righthand width=0.55\textwidth,]
736 \begin{tikzpicture}
737 \begin{scope}
738 [xscale=7/4,yscale=2.5/80]
739 \semilog{-2}{2}{-40}{40}
740 \BodeGraph{-2:2}{\IntAmp{1}}
741 \end{scope}
742 \begin{scope}[yshift=-2cm,
743 xscale=7/4,yscale=2.5/110]
744 \semilog{-2}{2}{-100}{10}
745 \BodeGraph{-2:2}{\IntArg{1}}
746 \end{scope}
747 \end{tikzpicture}
748 \end{tikzexample}
749 \caption{Intégrateur}
750 \label{fig:integrateur}
751 \end{figure}
752
753
754
755
756 \subsubsection{\TradEnLigne{Gain seul}{Gain alone}}
757
758 $H_K(s)=K$
759
760 \TradEnLigne{Pour le diagramme d'amplitude (pas de diagramme de phase).}{for the amplitude graph (not the phase graph) }:\\
761 \myverb{\KAmp{K}}
762
763
764 \subsubsection{\TradEnLigne{Premier Ordre généralisé}{First order generalised }}
765 $H(p)=K\dfrac{a_1+a_2\cdot p}{b_1+b_2\cdot p}$ (fig.~\ref{fig:premierordregeneralise})
766
767
768 \TradEnLigne{Courbes réelles}{real curves}
769 \begin{itemize}
770 \item \myverb{\POgAmp{K}{a1}{a2}{b1}{b2}}
771 \item \myverb{\POgArg{K}{a1}{a2}{b1}{b2}}
772 \end{itemize}
773
774 Asymptotes
775 \begin{itemize}
776 \item \myverb{\POgAmpAsymp{K}{a1}{a2}{b1}{b2}}
777 \item \myverb{\POgArgAsymp{K}{a1}{a2}{b1}{b2}}
778 \end{itemize}
779
780
781
782 \TradEnLigne{$a_1$ et $b_1$ ne doivent pas être nuls.}{$a_1$ and $b_1$ must not be zero.}
783
784
785
786
787 \begin{figure}[!htb]
788 \centering
789 \begin{tikzexample}[title=,righthand width=0.5\textwidth,]
790 \begin{tikzpicture}[xscale=7/4]
791 \begin{scope}[yscale=4/40]
792 \semilog{-2}{2}{-20}{10}
793 \BodeGraph{-2:2}
794 {\POgAmp{3}{4}{5}{6}{70}}
795 \BodeGraph[thin,red]{-2:2}
796 {\POgAmpAsymp{3}{4}{5}{6}{70}}
797 \end{scope}
798 \begin{scope}
799 [yshift=-4cm,yscale=4/180]
800 \OrdBode{30}
801 \semilog{-2}{2}{-90}{60}
802 \BodeGraph{-2:2}
803 {\POgArg{3}{4}{5}{6}{70}}
804 \BodeGraph[thin,red,const plot]{-2:2}
805 {\POgArgAsymp{3}{4}{5}{6}{70}}
806 \end{scope}
807 \end{tikzpicture}
808 \end{tikzexample}
809 \caption{Premier ordre généralisé}
810 \label{fig:premierordregeneralise}
811 \end{figure}
812
813
814
815
816 \subsubsection{\TradEnLigne{Retard}{Delay}}
817 $H_r(s)=e^{-T_r\cdot s}$(fig.~\ref{fig:ret1ordre})
818
819
820 \begin{figure}[!htb]
821 \centering
822 \begin{tikzexampleL}[title=]
823 \begin{tikzpicture}[xscale=12/3]
824 \begin{scope}[yscale=3.5/50]
825 \UnitedB
826 \semilog{0}{3}{-40}{10}
827 \BodeGraph{0:3}{\RetAmp{0.08}}
828 \BodeGraph[red]{0:3}{\POAmp{1.0}{0.08}}
829 \BodeGraph[black]{0:3}{\POAmp{1.0}{0.08}+\RetAmp{0.08}}
830 \draw [latex-](2.2,-0)--++(-0.1,-5)node[left] {retard};
831 \draw [latex-](2.2,-22)--++(-0.1,-5)node[left] {1er ordre};
832 \draw [latex-](2.2,-22) --++(-0.1,-10)node[left] {1er ordre retardé};
833 \end{scope}
834 \begin{scope}[yshift=-3.5cm,yscale=3.5/180]
835 \UniteDegre
836 \OrdBode{30}
837 \semilog{0}{3}{-180}{0}
838 \BodeGraph{0:3}{\RetArg{0.08}}
839 \BodeGraph[red]{0:3}{\POArg{1}{0.08}}
840 \BodeGraph[black]{0:3}{\POArg{1}{0.08}+\RetArg{0.08}}
841 \draw [latex-](2.8,-50)--++(-0.1,-10)node[left] {retard};
842 \draw [latex-](2.8,-88)--++(-0.1,+10)node[left] {1er ordre};
843 \draw [latex-](2.8,-140) --++(-0.1,-10)node[left] {1er ordre retardé};
844 \end{scope}
845 \end{tikzpicture}
846 \end{tikzexampleL}
847 \caption{Retard et 1er ordre}
848 \label{fig:ret1ordre}
849 \end{figure}
850 \begin{itemize}
851 \item \myverb{\RetAmp{Tr}}:\\
852 \traduction{Tracé du diagramme d'amplitude.}{Plotting the amplitude diagram.}
853
854 \item \myverb{\RetArg{Tr}}: \\
855 \traduction{Tracé du diagramme de phase.}{Plotting the phase graph.}
856 \end{itemize}
857
858 \traduction{Sur la figure~\Ref{fig:ret1ordre} on note l'effet d'un retard sur une fonction de transfert du premier ordre. }{In the figure~\ref{fig:ret1ordre}, we note the effect of a delay on a first order transfer function.}
859
860 \subsubsection{\TradEnLigne{Fonctions inverses}{inverse functions}}
861
862 \traduction{À partir des fonctions élémentaires ci-dessus il est facile de tracer les fonctions inverses en changeant uniquement le signe.}{Using the basic functions above, it is possible to draw the inverse functions just by changing their sign.}
863
864
865 \begin{figure}[!ht]
866 \centering
867 \begin{tikzexample}[title=,righthand width=0.55\textwidth,]
868
869 \begin{tikzpicture}
870 [xscale=7/4]
871 \begin{scope}[yscale=4/40]
872 \semilog{-2}{2}{-10}{30}
873 \BodeGraph[asymp lines,red,samples=100]
874 {-2:2}{-\POAmpAsymp{1}{0.3}}
875 \BodeGraph{-2:2}
876 {-\POAmp{1}{0.3}}
877 \end{scope}
878 \begin{scope}
879 [yshift=-6cm,yscale=4/90]
880 \semilog{-2}{2}{0}{90}
881 \BodeGraph[asymp lines,
882 red, samples=100,
883 const plot]{-2:2}
884 {-\POArgAsymp{1}{0.3}}
885 \BodeGraph{-2:2}
886 {-\POArg{1}{0.3}}
887 \end{scope}
888 \end{tikzpicture}
889 \end{tikzexample}
890 \caption{Premier ordre au numérateur}
891 \label{fig:premierordre}
892 \end{figure}
893
894
895 \begin{description}
896 \item [\TradEnLigne{Premier ordre au numérateur}{ 1st order at the numerator}:] $N_1(s)=1+T\cdot s$ \TradEnLigne{avec}{with}
897
898 \begin{itemize}
899 \item \TradEnLigne{pour le module}{for module}:\\
900 \myverb{\BodeGraph[Options]{domain}{-\POAmp{1}{T}}}
901 \item \TradEnLigne{pour la phase}{for phase}: \\
902 \myverb{\BodeGraph[Options]{domain}{-\POArg{1}{T}}}
903 \end{itemize}
904 \item [\TradEnLigne{Second ordre au numérateur}{Second order in the numerator} : ]~\\ $N_2(s)=1+2\dfrac{2\cdot z}{\omega_n} \cdot s +\dfrac{s^2}{\omega_n^2}$ \\
905 \TradEnLigne{avec}{with}
906 \begin{itemize}
907 \item \TradEnLigne{pour le module}{for module}: \\
908 \myverb{\BodeGraph[Options]{domain}{-\SOAmp{1}{z}{Wn}}}
909 \item \TradEnLigne{pour la phase}{for phase}:\\
910 \myverb{\BodeGraph[Options]{domain}{-\SOArg{1}{z}{Wn}} }
911 \end{itemize}
912
913 \item [Dérivateur : ] $N_d(s)=s$ avec
914 \begin{itemize}
915 \item \TradEnLigne{Module}{Module} : \myverb{\BodeGraph[Options]{domain}{-\IntAmp{1}}}
916 \item \TradEnLigne{Phase}{Phase}: \myverb{\BodeGraph[Options]{domain}{-\IntArg{1}}}
917
918 \end{itemize}
919
920
921 \end{description}
922
923
924 \clearpage
925
926 \subsection{Correcteurs}
927
928 \traduction{Les correcteurs de base sont aussi pré-programmés.}{Basic correctors are also pre-programmed.}
929
930 \paragraph{\TradEnLigne{Correcteur Proportionnel P}{Proportional controller P}} :$C(p)=K$
931 \begin{itemize}
932 \item \TradEnLigne{Module}{Module} : \myverb{\Kamp{K}}
933 \item \TradEnLigne{Phase}{Phase} : \myverb{\Karg{K}}\footnote{\TradEnLigne{commande inutile, elle retourne 0}{Useless command, it returns 0}}
934
935 \end{itemize}
936
937 \paragraph{\TradEnLigne{Correcteur Proportionnel intégrateur (PI)}{proportional-integral controller (PI)}}
938
939 $C(s)=K_p\cdot\dfrac{1+T_i\cdot s}{T_i\cdot s}$ (fig.~\ref{fig:corpi})
940
941 \begin{multicols}{2}
942 \begin{description}
943 \item[Courbes réelles]~\\
944 \begin{itemize}
945 \item module : \myverb{\PIAmp{Kp}{Ti}},
946 \item argument: \myverb{\PIArg{Kp}{Ti}}
947 \end{itemize}
948
949 \item[Asymptotes]~\\
950
951 \begin{itemize}
952 \item module : \myverb{\PIAmpAsymp{Kp}{Ti}},
953 \item argument: \myverb{\PIArgAsymp{Kp}{Ti}}
954 \end{itemize}
955 \end{description}
956
957 \end{multicols}
958
959
960
961 \begin{figure}[!ht]
962 \centering
963 \begin{tikzexample}[title=,righthand width=0.55\textwidth,]
964 \begin{tikzpicture}[xscale=7/3]
965 \begin{scope}[yscale=3/40]
966 \UnitedB
967 \BodeGraph[thick]{0:3}
968 {\PIAmp{2}{0.08}}
969 \BodeGraph[black]{0:3}
970 {\PIAmpAsymp{2}{0.08}}
971 \semilog{0}{3}{-10}{30}
972 \end{scope}
973 \begin{scope}[yshift=-1.5cm,
974 yscale=3/90]
975 \UniteDegre
976 \OrdBode{15}
977 \semilog{0}{3}{-90}{0}
978 \BodeGraph[thick]{0:3}
979 {\PIArg{2}{0.08}}
980 \BodeGraph[black
981 ,samples=201,const plot]{0:3}
982 {\PIArgAsymp{2}{0.08}}
983 \end{scope}
984 \end{tikzpicture}
985 \end{tikzexample}
986 \caption{Correcteur P.I}
987 \label{fig:corpi}
988 \end{figure}
989
990 \clearpage
991
992 \subsubsection{\TradEnLigne{Correcteur Proportionnel Derivée (PD)}{Derived proportional controller (PD)}}
993
994 $C(s)=K_p\cdot\left(1+T_d\cdot s\right)$
995
996 \traduction{Le correcteur PD programmé est un correcteur idéal, pour réaliser un correcteur réel, on utilisera le correcteur à avance de phase (fig.~\ref{fig:corpd}).}{Controller PD programmed is an ideal corrector. To create an real corrector, you can use the advance phase controller (fig.~\ref{fig:corpd}) }
997
998 \begin{description}
999 \item[\TradEnLigne{Courbes réelles}{Real curves}]~\\
1000 \begin{itemize}
1001 \item \TradEnLigne{Module}{Module}: \myverb{\PDAmp{Kp}{Td}},
1002 \item \TradEnLigne{Phase}{Phase}: \myverb{\PDArg{Kp}{Td}}
1003 \end{itemize}
1004
1005 \item[Asymptotes]~\\
1006 \begin{itemize}
1007 \item \TradEnLigne{Module}{Module}: \myverb{\PDAmpAsymp{Kp}{Td}},
1008 \item \TradEnLigne{Phase}{Phase}: \myverb{\PDArgAsymp{Kp}{Td}}
1009 \end{itemize}
1010 \end{description}
1011
1012
1013 \begin{figure}[!ht]
1014 \centering
1015 \begin{tikzexample}[title=,righthand width=0.5\textwidth,]
1016 \begin{tikzpicture}[xscale=7/3]
1017 \begin{scope}[yscale=3/50]
1018 \UnitedB
1019 \semilog{0}{3}{0}{50}
1020 \BodeGraph[thick]{0:3}
1021 {\PDAmp{2}{0.08}}
1022 \BodeGraph[black]{0:3}
1023 {\PDAmpAsymp{2}{0.08}}
1024 \end{scope}
1025 \begin{scope}[yshift=-3.5cm,
1026 yscale=3/90]
1027 \UniteDegre
1028 \OrdBode{15}
1029 \semilog{0}{3}{0}{90}
1030 \BodeGraph[thick]{0:3}
1031 {\PDArg{2}{0.08}}
1032 \BodeGraph[black,samples=201
1033 ,const plot]
1034 {0:3}{\PDArgAsymp{2}{0.08}}
1035 \end{scope}
1036 \end{tikzpicture}
1037 \end{tikzexample}
1038 \caption{Correcteur P.D}
1039 \label{fig:corpd}
1040 \end{figure}
1041
1042
1043
1044 \newpage
1045
1046 \subsubsection{\TradEnLigne{Correcteur à Avance de phase}{Advance phase corrector}}
1047
1048 $C_{AP}(s)=K_p\cdot\dfrac{1+a\cdot T_a \cdot s}{1+T_a\cdot s}$ (fig.~\ref{fig:corav})
1049
1050 \begin{description}
1051 \item[\TradEnLigne{Courbes réelles}{Real curves}]~\\
1052 \begin{itemize}
1053 \item \TradEnLigne{Module}{Module}: \myverb{\APAmp{Kp}{Ta}{a}},
1054 \item \TradEnLigne{Phase}{Phase}: \myverb{\APArg{Kp}{Ta}{a}}
1055 \end{itemize}
1056 \item[Asymptotes]~\\
1057 \begin{itemize}
1058 \item \TradEnLigne{Module}{Module}: \myverb{\APAmpAsymp{Kp}{Ta}{a}},
1059 \item \TradEnLigne{Phase}{Phase}: \myverb{\APArgAsymp{Kp}{Ta}{a}}
1060 \end{itemize}
1061 \end{description}
1062
1063
1064
1065 \begin{figure}[!ht]
1066 \centering
1067 \begin{tikzexample}[title=,righthand width=0.5\textwidth,]
1068 \begin{tikzpicture}
1069 [xscale=7/3]
1070 \begin{scope}[yscale=4/40]
1071 \UnitedB
1072 \semilog{0}{3}{0}{30}
1073 \BodeGraph{0:3}
1074 {\APAmp{2}{0.02}{3}}
1075 \BodeGraph[thick,samples=101,
1076 red]
1077 {0:3}{\APAmpAsymp{2}{0.02}{3}}
1078 \end{scope}
1079 \begin{scope}
1080 [yshift=-3cm,yscale=4/180]
1081 \UniteDegre
1082 \OrdBode{30}
1083 \semilog{0}{3}{-30}{90}
1084 \BodeGraph{0:3}
1085 {\APArg{2}{0.02}{3}}
1086 \BodeGraph[thick,samples=201,
1087 red,const plot]
1088 {0:3}{\APArgAsymp{2}{0.02}{3}}
1089 \end{scope}
1090 \end{tikzpicture}
1091 \end{tikzexample}
1092 \caption{Correcteur avance de phase}
1093 \label{fig:corav}
1094 \end{figure}
1095
1096 \clearpage
1097
1098 \subsubsection{\TradEnLigne{Correcteur à Retard de phase}{Phase delay corrector}}
1099
1100 $C_{RP}(p)=K_p\cdot\dfrac{1+ T_r \cdot p}{1+a\cdot T_r\cdot p}$(fig.~\ref{fig:corar})
1101
1102 \begin{description}
1103 \item[\TradEnLigne{Courbes réelles}{Real curves}]~\\
1104 \begin{itemize}
1105 \item \TradEnLigne{Module}{Module}: \myverb{\RPAmp{Kp}{Tr}{a}}
1106 \item \TradEnLigne{Phase}{Phase}: \myverb{\RPArg{Kp}{Tr}{a}}
1107 \end{itemize}
1108 \item[Asymptotes]~\\
1109 \begin{itemize}
1110 \item \TradEnLigne{Module}{Module}: \myverb{\RPAmpAsymp{Kp}{Tr}{a}}
1111 \item \TradEnLigne{Phase}{Phase}: \myverb{\RPArgAsymp{Kp}{Tr}{a}}
1112 \end{itemize}
1113 \end{description}
1114
1115
1116
1117 \begin{figure}[!ht]
1118 \centering
1119 \begin{tikzexample}[title=,righthand width=0.5\textwidth,]
1120 \begin{tikzpicture}[xscale=7/3]
1121 \begin{scope}[yscale=3/40]
1122 \UnitedB
1123 %\node{\tiny \PIAmp{3}{0.5}};
1124 \semilog{0}{3}{-10}{30}
1125 \BodeGraph[thick]
1126 {0:3}{\RPAmp{2}{0.02}{3}}
1127 \BodeGraph[,thin,samples=101,red]
1128 {0:3}{\RPAmpAsymp{2}{0.02}{3}}
1129 \end{scope}
1130 \begin{scope}
1131 [yshift=-3cm,yscale=3/180]
1132 \UniteDegre
1133 \OrdBode{30}
1134 \semilog{0}{3}{-90}{90}
1135 \BodeGraph[thick]
1136 {0:3}{\RPArg{2}{0.02}{3}}
1137 \BodeGraph[thin,samples=201,
1138 red,const plot]
1139 {0:3}{\RPArgAsymp{2}{0.02}{3}}
1140 \end{scope}
1141 \end{tikzpicture}
1142 \end{tikzexample}
1143 \caption{Correcteur retard de phase}
1144 \label{fig:corar}
1145 \end{figure}
1146
1147
1148 \newpage
1149
1150 \subsubsection{\TradEnLigne{Correcteur proportionnel intégral dérivateur (forme série) PID}{proportional integral derivative corrector (series form) (PID)} }
1151
1152 $C(s)=K_p\cdot\dfrac{1+T_i\cdot s}{T_i\cdot s}\cdot\left(1+T_d\cdot s\right)$ (fig.~\ref{fig:corpids})
1153
1154
1155 \begin{description}
1156 \item[\TradEnLigne{Courbes réelles}{Real curves}]~\\
1157 \begin{itemize}
1158 \item \TradEnLigne{Module}{Module}: \myverb{\PIDAmp{Kp}{Ti}{Td}}
1159 \item \TradEnLigne{Phase}{Phase}: \myverb{\PIDArg{Kp}{Ti}{Td}}
1160 \end{itemize}
1161 Asymptotes
1162 \begin{itemize}
1163 \item \TradEnLigne{Module}{Module}: \\myverb{\PIDAmpAsymp{Kp}{Ti}{Td}}
1164 \item \TradEnLigne{Phase}{Phase}: \myverb{\PIDArgAsymp{Kp}{Ti}{Td}}
1165 \end{itemize}
1166 \end{description}
1167
1168 \begin{figure}[!ht]
1169 \centering
1170 \begin{tikzexample}[title=,righthand width=0.55\textwidth,]
1171 \begin{tikzpicture}[xscale=7/3]
1172 \begin{scope}[yscale=3/40]
1173 \UnitedB
1174 \semilog{0}{3}{-10}{30}
1175 \BodeGraph{0:3}
1176 {\PIDAmp{2}{0.08}{0.02}}
1177 \BodeGraph[black]
1178 {0:3}{\PIDAmpAsymp{2}{0.08}{0.02}}
1179 \end{scope}
1180 \begin{scope}[yshift=-3cm,yscale=3/180]
1181 \Unites{rad/s}{Argument en degré}
1182 \OrdBode{30}
1183 \semilog{0}{3}{-90}{90}
1184 \BodeGraph{0:3}
1185 {\PIDArg{2}{0.08}{0.02}}
1186 \BodeGraph[samples=2,
1187 black,samples=201]
1188 {0:3}{\PIDArgAsymp{2}{0.08}{0.02}}
1189 \end{scope}
1190 \end{tikzpicture}
1191 \end{tikzexample}
1192 \caption{Correcteur P.I.D série}
1193 \label{fig:corpids}
1194 \end{figure}
1195
1196 \clearpage
1197
1198
1199
1200
1201
1202 \subsection{\TradEnLigne{Fonctions de transfert complexes}{Complex functions of transfer}}
1203
1204
1205 \traduction{
1206 Pour tracé les diagrammes de Bode d'un fonction de transfert complexe, définie par le produit de fonctions élémentaires, il suffit de sommer les représentations, aussi bien pour le tracé de la fonction que pour les asymptotes.}{To trace Bode plot of a complex transfer function, defined by the product of basic functions, you can simply sum up the representations, of the function graph as well as of the asymptotes.
1207 }
1208 \subsubsection{\TradEnLigne{Exemples}{Examples}}
1209
1210 \begin{description}
1211 \item [\TradEnLigne{Premier ordre + intégrateur}{first order + integrator}:] $H_1(s)=\dfrac{8}{s\cdot \left(1+\num{0.5}\cdot s\right)}=\dfrac{1}{s}\cdot\dfrac{8}{1+\num{0.5}\cdot s}$ (fig.~\ref{fig:premiordreint})
1212
1213 \begin{figure}[!ht]
1214 \centering
1215 \begin{tikzexample}[title=,righthand width=0.5\textwidth,]
1216 \begin{tikzpicture}
1217 [xscale=7/4]
1218 \begin{scope}
1219 [yscale=4/100]
1220 \semilog{-2}{2}{-40}{60}
1221 \BodeGraph[thin,samples=100]
1222 {-1.5:1.5}
1223 {\POAmpAsymp{8}{0.5}
1224 +\IntAmp{1}}
1225 \BodeGraph{-1.8:1.5}
1226 {\POAmp{8}{0.5}+\IntAmp{1}}
1227 \end{scope}
1228 \begin{scope}
1229 [yshift=-2.5cm,yscale=4/200]
1230 \OrdBode{20}
1231 \semilog{-2}{2}{-200}{0}
1232 \BodeGraph[samples=100,thin,
1233 red,const plot]
1234 {-2:2}
1235 {\POArgAsymp{8}{0.5}
1236 +\IntArg{1}}
1237 \BodeGraph{-2:2}
1238 {\POArg{8}{0.5}+\IntArg{1}}
1239 \end{scope}
1240 \end{tikzpicture}
1241 \end{tikzexample}
1242 \caption{Premier ordre +intégrateur}
1243 \label{fig:premiordreint}
1244 \end{figure}
1245
1246
1247 \clearpage
1248
1249 \item [\TradEnLigne{Second ordre généralisé}{Second order generalised} : ] ~\\
1250 $H_{2g}=5\cdot\dfrac{1+\num{0.01}\cdot s}{1+\dfrac{2\cdot \num{0.3}}{15}\cdot s +\dfrac{s^2}{15^2}}=\left({1+\num{0.01}\cdot s}\right)\dfrac{5}{1+\dfrac{2\cdot \num{0.3}}{15}\cdot s +\dfrac{s^2}{15^2}}$(fig.~\ref{fig:secondordregene})
1251
1252
1253 \begin{figure}[!ht]
1254 \centering
1255 \begin{tikzexample}[title=,righthand width=0.55\textwidth,]
1256 \begin{tikzpicture}
1257 [xscale=7/5]
1258 \begin{scope}[yscale=4/80]
1259 \semilog{-1}{4}{-50}{30}
1260 \BodeGraph[red]{-1:4}
1261 {\SOAmpAsymp{5}{0.3}{15}-
1262 \POAmpAsymp{1}{0.01}}
1263 \BodeGraph[smooth,samples=100,
1264 thick]{-1:4}
1265 {\SOAmp{5}{0.3}{15}
1266 -\POAmp{1}{0.01}}
1267 \end{scope}
1268 \begin{scope}
1269 [yshift=-3.5cm,yscale=4/210]
1270 \OrdBode{30}
1271 \semilog{-1}{4}{-180}{10}
1272 \BodeGraph[samples=100,
1273 red,const plot]{-1:4}
1274 {\SOArgAsymp{5}{0.3}{15}
1275 -\POArgAsymp{1}{0.01}}
1276 \BodeGraph[thick]{-1:4}
1277 {\SOArg{5}{0.3}{15}
1278 -\POArg{1}{0.01}}
1279 \end{scope}
1280 \end{tikzpicture}
1281 \end{tikzexample}
1282 \caption{Second ordre généralisé}
1283 \label{fig:secondordregene}
1284 \end{figure}
1285
1286
1287
1288 \end{description}
1289 \clearpage
1290
1291 \section{\TradEnLigne{Diagramme de black nichols}{black nichols diagram}}
1292
1293 \traduction{Ce package permet aussi de tracer les diagrammes de Black avec des commandes analogues à celles utilisées pour les diagrammes de Bode.}{This package also allows you to draw Black diagrams with commands similar to those used for Bode diagrams.
1294 }
1295
1296 \subsection{\TradEnLigne{Lieu de Black-Nicols}{Black-Nichols locus}}
1297
1298 \traduction{Trois commandes (et 3 étoilées) et permettent de tracer et commenter le lieu de Black d'une fonction (fig.~\ref{fig:diagblack}).}{Three commands (and 3 starred) allow to trace and comment the Nichols locus of a function (fig.~\ref{fig:diagblack}). }
1299
1300 \begin{itemize}
1301 \item { \myverb{\BlackGraph[options de trace]{domaine}{argument,module}} }
1302 \begin{itemize}
1303 \item \myverb{{domaine}}: \\
1304 \traduction{ c'est le domaine de tracé au sens de GnuPlot, il est conseillé de définir le domaine décade (entière ou non) comme \textbf{ \{-1:3\}}, GnuPlot va tracer la fonction pour $\omega$ compris entre $10^{-1}$ et $10^{3}$.}{it’s the domain of graph in the sense of GnuPlot, I suggest to define the domain in decades (integer or not) like\textbf{ \{-1:3\}}, GnuPlot will trace the function for $\omega$ including between $10^{-1}$ et $10^{3}$. }
1305 \item \myverb{{argument,module}}:\\
1306 \traduction{la fonction à tracer doit être définie par l'\textbf{argument} qui retourne l'argument en $~^\circ$ et le \textbf{module} qui retourne le module en dB. On peut bien sur utiliser les fonctions définies au dessus pour les diagrammes de Bode pour ces fonctions.}{the function to trace must be defined by the \textbf{argument} function which returns the argument in $~^\circ$, and the module function which returns the \textbf{module} in dB. You can also use the functions defined on the top for the bode graphs for these functions.
1307 }
1308 \item \myverb{ [options de trace]}: \\
1309 \TradEnLigne{toutes les options tikz pour tracer des fonctions gnuplot.}{all of the tikz options to trace gnuplot functions.}
1310 \end{itemize}
1311 \item {\small \myverb{\BlackGraph*[options de trace]{domaine}{argument,module}{[options]{texte}}} }\traduction{cette commande permet de rajouter commentaire (nom, référence, équation) à l'extrémité d'un tracé. Les paramètres sont identiques, se rajoute uniquement \textbf{\{[options]\{texte\}\}}.}{This command allows to add again comments (name, reference, equation) at the bottom of a drawing. Parameters are identical, you only re-add
1312 \textbf{\{[options]\{texte\}\}} .}
1313 \begin{itemize}
1314 \item \myverb{ [options]}:\\
1315 \traduction{ce sont les options d'écriture du texte (couleur, position,\dots)}{these are the options of the writing style of a text (colour, position,\dots), }
1316 \item \myverb{ {texte}}, \TradEnLigne{le texte à écrire entre parenthèses;}{text to write between brackets;}
1317 \end{itemize}
1318 \item \myverb{\BlackPoint[options]{liste pulsations}{argument,module}}:\\
1319 \traduction{cette commande permet de tracer et noter des points particuliers du graphe, la valeur de la pulsation est placée à coté (droite par défaut).}{this command allows to trace and mark specific points of the graph, the pulsation value is placed on the side (on the right by default.}
1320 \begin{itemize}
1321 \item \myverb{ [options]} \TradEnLigne{options de tracé (couleur, id, prefix,\dots),}{ tracing options (colour, id, prefix,\dots), }
1322 \item \myverb{ {liste pulsations}} \TradEnLigne{pulsations en rad/s séparées par une virgule,}{beats in rad/s separated by a comma,}
1323 \item \myverb{ {argument,module}} \TradEnLigne{identique à}{identical to} \myverb{\BlackGraph}
1324 \end{itemize}
1325
1326 \item \myverb{\BlackPoint*[options]{liste pulsations}{argument,module}} :\\
1327
1328 \traduction{ la version étoilée de la commande précédente permet de choisir la position de chaque texte, comme l'exemple \textbf{ 1/right,10/left,150/above right,....)}}{starred version of the previous command. It allows to choose the position of each text, like in the example \textbf{1/right,10/left,150/above right,\dots) }}
1329
1330
1331 \item \myverb{\BlackText[options]{pulsation/pos/texte}{argument,module}}:\\
1332 \traduction{cette commande permet de positionner un \textbf{texte} par rapport à la courbe définie par \textbf{\{argument,module\}} le texte étant positionné à la pulsation \textbf{pulsation}, le paramètre \textbf{pos} permet de préciser la position du texte ( \textbf{right}, \textbf{above}, \textbf{below left}, \dots). Le point est nommé \textbf{NBlack}.}{this command allows to position a text in relation to the curve defined by \textbf{\{argument, module\} }once the text is positioned at the beat, the parameter pos allows to specify the text position (\textbf{right}, \textbf{above}, \textbf{below left}, \dots). The point is named \textbf{NBlack}.
1333 }
1334
1335 \item \myverb{\BlackText*[options]{pulsation/pos/texte}{argument,module}}:\\
1336 \traduction{cette commande est identique à la précédente mais ne dessine pas de points.}{this command is identical to the previous one but it does not draw any points.}
1337 \end{itemize}
1338
1339
1340
1341 \subsubsection{\TradEnLigne{Styles par défaut}{Default styles}}
1342
1343 \traduction{Le tracé du diagramme de Black, de la grille et de l'abaque de Black-Nichols utilise plusieurs styles que vous pouvez modifier, avec la commande \textbf{\textbackslash{tikzset}}.}{The drawing of Nichols plot, grid and Nichols chart use different style you can modify using the command \textbf{\textbackslash{tikzset}}.}
1344
1345 \begin{itemize}
1346 \item \myverb{ Black lines/.style={very thick, blue}}:\\
1347 \traduction{style par défaut du tracé du lieu de Black;}{style for the drawing of Nyquist’s locus ;
1348 }
1349 \item \myverb{ Black grid/.style={ultra thin,brown!50}}:\\
1350 \traduction{Style par défaut de la grille (commande \textbf{\textbackslash BlackGrid});}{grid style ; }
1351
1352 \item \myverb{ Black label points/.style={font=\tiny}}:\\
1353 \traduction{style par défaut du label des points marqués (commandes \textbf{\textbackslash BlackPoint} et \textbf{\textbackslash BlackText});}{style used to mark the points on graph; }
1354
1355 \item \myverb{ Black label axes/.style={Black grid, font=\tiny}} \\
1356 \traduction{style par défaut des axes du diagramme;}{style used for the axis ;}
1357
1358 \item \myverb{ Black abaque mag/.style={gray,ultra thin,dashed,smooth}}:\\
1359 \traduction{style par défaut des contours isogains;}{default style of isogain contours;}
1360
1361 \item \myverb{Black abaque phase/.style={gray,ultra thin,smooth}}: \\
1362 \traduction{style par défaut des contours isoarguments;}{default style of isoarguments contours;
1363 }
1364 \item {\small \myverb{ ref points/.style={circle,draw, black, opacity=0.7,fill, minimum size= 2pt, inner sep=0}} }:\\
1365 \traduction{style utilisé pour marquer les points sur le diagramme.}{style used to mark points on the diagram.}
1366 \end{itemize}
1367
1368
1369
1370
1371
1372 \subsection{ \TradEnLigne{Grille et abaque de Black-Nichols}{Nichols plot chart and grid}}
1373
1374 \subsection{\TradEnLigne{Exemples}{Examples}}
1375
1376
1377 \traduction{Sur les figures~\ref{fig:diagblack1} et~\ref{fig:diagblack2} sont représentées les fonctions suivantes:}{In the figures~\ref{fig:diagblack1} et~\ref{fig:diagblack2} the following functions are represented:}
1378
1379 \begin{multicols}{2}
1380 $H_1(p)=\dfrac{1}{1+\dfrac{2\cdot 0.1}{1500}\cdot p +\dfrac{p^2}{1500^2}}$, \\
1381 $H_2(p)=\dfrac{5}{1+\dfrac{2\cdot 0.2}{150}\cdot p +\dfrac{p^2}{150^2}}$,\\
1382 $H_3(p)=\dfrac{5}{1+\dfrac{2\cdot 2}{150}\cdot p +\dfrac{p^2}{150^2}}$,\\
1383 $H_4(p)=\dfrac{5}{1+3\cdot p}$,\\
1384 \end{multicols}
1385 $H_5(p)=\dfrac{1}{1+\dfrac{2\cdot 0.1}{1500}\cdot p +\dfrac{p^2}{1500^2}} \cdot \dfrac{0.43\cdot\left(1+0.0009\cdot p\right)^2}{0.0009\cdot p}$
1386
1387 \begin{figure}[!htb]
1388 \centering
1389
1390 \begin{tikzexample}[title=,righthand width=0.5\textwidth,]
1391
1392 \begin{tikzpicture}
1393 \begin{scope}
1394 [xscale=6/180,yscale=8/60]
1395 \BlackGraph*[samples=150,red,
1396 smooth,ultra thick,-<]
1397 {-2:1}{\SOBlack{1}{0.1}{1500}}
1398 {[red,right]{\footnotesize $H_1$}}
1399 \BlackGraph*[samples=150,black,
1400 smooth,ultra thick]
1401 {-1:3.5}{\SOArg{5}{0.2}{150},
1402 \SOAmp{5}{0.2}{150}}
1403 {[right]{$H_2 $}}
1404 \BlackGraph*[samples=150,blue,
1405 smooth,ultra thick]
1406 {-1:3.5}{\SOArg{5}{2}{150},
1407 \SOAmp{5}{2}{150}}
1408 {[right]{$H_3 $}}
1409 \BlackGrid
1410 \end{scope}
1411 \end{tikzpicture}
1412 \end{tikzexample}
1413 \caption{Diagrammes de Black 1}
1414 \label{fig:diagblack1}
1415 \end{figure}
1416
1417
1418
1419 \begin{figure}[!ht]
1420 \centering
1421 \begin{tikzexample}[title=,righthand width=0.4\textwidth,]
1422 \begin{tikzpicture}
1423 \begin{scope}
1424 [xscale=6/180,yscale=8/60]
1425 \BlackGraph[samples=150,blue,
1426 smooth,ultra thick]
1427 {1:5}{\SOArg{1}{0.1}{1500}+
1428 \IntArg{0.43/0.0009}-2*\POArg{1}{0.0009},
1429 \SOAmp{1}{0.1}{1500}+\IntAmp{0.43/0.0009}
1430 -2*\POAmp{1}{0.0009}}
1431 \BlackGraph*[samples=100,purple,smooth]
1432 {-3:2}{\POArg{5}{3},\POAmp{5}{3}}
1433 {[purple!50,right]{\footnotesize $H_3$}}
1434 \BlackPoint[purple]{0.1,1,3,12,65}
1435 {\POArg{5}{3},\POAmp{5}{3}}
1436 \BlackPoint*[black]{25/right,
1437 80/above right,
1438 500/above,1500/above,4000/right}
1439 {\SOArg{1}{0.1}{1500}+\IntArg{0.43/0.0009}
1440 -2*\POArg{1}{0.0009},\SOAmp{1}{0.1}{1500}+
1441 \IntAmp{0.43/0.0009}-2*\POAmp{1}{0.0009}}
1442 \BlackText[blue]{5000/left/{\normalsize $H_4$}}
1443 {\SOArg{1}{0.1}{1500}+\IntArg{0.43/0.0009}
1444 -2*\POArg{1}{0.0009},\SOAmp{1}{0.1}{1500}+
1445 \IntAmp{0.43/0.0009}-2*\POAmp{1}{0.0009}}
1446 \BlackGrid
1447 \end{scope}
1448 \end{tikzpicture}
1449 \end{tikzexample}
1450 \caption{Diagramme de Black}
1451 \label{fig:diagblack2}
1452 \end{figure}
1453
1454
1455
1456 \traduction{Pour les deux derniers exemples, les courbes ont été graduées en pulsation avec la commande \textbf{\textbackslash BlackPoint} et annotées la commande \textbf{\textbackslash BlackText}.}{For the last two examples, the curves were graduated in pulsation with the command \textbf{\textbackslash BlackPoint} and annotated with the command \textbf{\textbackslash BlackText}.}
1457
1458
1459 \subsubsection{\TradEnLigne{Grille}{Grid}}
1460
1461 \traduction{Une grille peut aussi être ajoutée avec la commande \textbf{\textbackslash BlackGrid} qui dessine une grille dont le pas horizontal est définie par la variable \textbf{\textbackslash valgridBx} (par défaut $45^\circ$ que l'on change si on le souhaite par \textbf{\textbackslash def \textbackslash valgridBx{10}}, le pas vertical est lui défini par \textbf{\textbackslash valgridBy} (par défaut 10~dB ). Cette commande dessine aussi le point critique (-$180^circ$ ,0~dB) et gradue les axes. La commande étoilée \textbf{\textbackslash BlackGrid*} , ne dessine que la grille.}{
1462 A grid can be added too by the command \textbf{\textbackslash BlackGrid} , which draws a grid whose horizontal step is defined by the variable \textbf{\textbackslash valgridBx} (45◦ by default, you can change it if you want by \textbf{\textbackslash def \textbackslash valgridBx{10}}), vertical step is defined by \textbf{\textbackslash valgridBy} (10 dB by default). This command also draws the critic point (-180◦ ,0 dB) and graduates axis. The starred command \textbf{\textbackslash BlackGrid*} only draws the grid}
1463
1464
1465
1466
1467 %\clearpage
1468
1469 \subsubsection{\TradEnLigne{Abaque de Black-Nichols}{Nichols chart}}
1470
1471 \myverb{\AbaqueBlack} \\
1472 \traduction{permet de tracer les courbes isomodule et isoargument de l'abaque de Black-Nichols (fig.~\ref{fig:AbaqueBlack}).}{allows to trace isomodule curves and isoargument of Nichols chart (figure 17). }
1473
1474
1475 \traduction{Les seules valeurs possibles pour ces courbes de gain et d'argument sont les suivantes:}{The only values possible for these curves of gain and argument are the following : }
1476
1477 \begin{itemize}
1478 \item isomodule, gain en dB: -30, -25, -20, -15, -12, -10, -8, -6, -5, -4, -3, -2, -1, -0.5, -0.2, 0, 0.2, 0.5, 1, 2, 2.3, 3, 4, 5, 6, 8, 10;
1479 \item isoargument, en $~^\circ$: 359, 357, 354, 350, 345, 340, 330, 315, 300, 285, 270, 255, 240 , 225, 210,195, 190, 170,165, 150, 135, 120, 105, 90, 75, 60, 45, 30, 20, 15, 10, 6, 3, 1.
1480 \end{itemize}
1481
1482 \traduction{Deux autres commandes permettent de limiter l'affichage à quelques courbes:}{Two other commands allow to limit the display to certain curves:}
1483
1484 \begin{itemize}
1485 \item \myverb{\IsoModule[listedB]} \\
1486 \traduction{ cette commande permet de tracer uniquement les courbes d'amplitude de la liste \textbf{ listedB}, par défaut, toutes les courbes sont dessinées.}{this command allows to trace only the amplitude curves of the list edB list, all the curves are drawn by default.
1487 }
1488
1489 \item \myverb{\IsoArgument[listedeg]}\\
1490 \traduction{ cette commande permet de tracer uniquement les courbes d'amplitude de la liste \textbf{ listedeg}, par défaut, toutes les courbes sont tracées.}{this command allows to trace only the amplitude curves of the \textbf{listedeg} list, all the curves are drawn by default.
1491 }
1492 \end{itemize}
1493
1494 \traduction{Le style des courbes tracées est modifiable à l'aide des deux commandes:}{The style of the traced curve can be changed using two commands: }
1495
1496 \begin{itemize}
1497 \item \myverb{\StyleIsoM[couleur,épaisseur, ...]} \TradEnLigne{pour les courbes isomodules.}{for the isomodule curves.}
1498 \item \myverb{\StyleIsoA[couleur,épaisseur, ...]} \TradEnLigne{pour les courbes isoarguments.}{for the isoargument curves.}
1499 \end{itemize}
1500
1501 \begin{figure}[!htb]
1502 \centering
1503 \begin{tikzexampleL}[title=]
1504 \begin{tikzpicture}
1505 \begin{scope}[xscale=15/360,yscale=11/60]
1506 \BlackGraph[samples=100,purple,smooth]{-1:1}{\IntArg{0.3}+\SOArg{3.9}{0.4}{3},
1507 \IntAmp{0.3}+\SOAmp{3.9}{0.4}{3}}
1508 \def\valmaxBf{-360}
1509 \StyleIsoM[blue,dashed]
1510 \StyleIsoA[blue]
1511 \AbaqueBlack
1512 \StyleIsoM[blue,thick]
1513 \IsoModule[2.3]
1514 \BlackGrid
1515 \BlackText[black]{2.6/right/{\normalsize $\omega_r\approx 2.6~rad/sec$}} {\IntArg{0.3}+\SOArg{3.9}{0.4}{3},
1516 \IntAmp{0.3}+\SOAmp{3.9}{0.4}{3}}
1517 \end{scope}
1518 \end{tikzpicture}
1519 \end{tikzexampleL}
1520 \caption{Abaque de Black}
1521 \label{fig:AbaqueBlack}
1522 \end{figure}
1523
1524
1525
1526 \traduction{Remarque: pour ne pas trop ralentir la compilation, les courbes sont pré-calculées. Elles sont définies dans les deux fichiers \textbf{isom.txt } et \textbf{isoa.txt} (respectivement pour le module et l'argument). Si vous souhaitez ajouter de nouvelles courbes, il faut les ajouter dans ces fichiers en respectant la syntaxe.}{
1527 Note: do not slow down the compilation too much, curves are already pre-calculated. They are defined by the files \textbf{isom.txt} and \textbf{isoa.txt} (respectively for the module and for the argument). If you would like to add new curves, you must add them in the files and using the same syntax.}
1528
1529
1530
1531 \clearpage
1532
1533 \section{\TradEnLigne{Diagramme de Nyquist}{Nyquist plot}}
1534
1535 \traduction{Le package permet aussi de tracer le diagramme de Nyquist (fig.~\ref{fig:diagnyq}) d'une fonction linéaire, le tracé est réalisé à partir de la description polaire de la fonction de transfert $H(i\cdot \omega)=\|{H(i\cdot \omega)}\|\cdot e^{\arg\left(H(i\cdot \omega)\right)}$. Cela permet de tracer le diagramme de Nyquist à partir des définitions précédentes du module et de l'argument.}{The package also allows to trace Nyquist plot (fig.~\ref{fig:diagnyq}) of a linear function, the drawing is traced out of the polar description of the transfer function $H(i\cdot \omega)=\|{H(i\cdot \omega)}\|\cdot e^{\arg\left(H(i\cdot \omega)\right)}$. This allows to trace (fig.~\ref{fig:diagnyq}) Nyquist graph, starting from the previous definitions of module and argument.}
1536
1537
1538
1539 \begin{figure}[!htb]
1540 \centering
1541 \begin{tikzexample}[title=,righthand width=0.4\textwidth,]
1542 \begin{tikzpicture}[scale=0.8]
1543 \begin{scope}
1544 \NyquistGraph[smooth,samples=81]{-1:4}
1545 {\POAmp{3}{0.5}}{\POArg{3}{0.5}}
1546 %\NyquistGraph[purple,smooth,samples=81,]
1547 %{-2:2}{\SOAmp{3}{0.5}{10}}{\SOArg{3}{0.5}{10}}
1548 \NyquistGraph[red,samples=151,smooth,]
1549 {-3:2}{\POAmp{4}{0.5}+\POAmp{1}{2}}
1550 {\POArg{4}{0.5}+\POArg{1}{2}}
1551 \NyquistGraph[green,samples=101,smooth,]
1552 {0.5:2}{\SOAmp{15}{0.5}{10}+\IntAmp{1}}
1553 {\SOArg{15}{0.5}{10}+\IntArg{1}}
1554 \end{scope}
1555 \NyquistGrid
1556 \end{tikzpicture}
1557
1558 \end{tikzexample}
1559 \caption{Diagrammes de Nyquist}
1560 \label{fig:diagnyq1}
1561 \end{figure}
1562
1563
1564
1565 \begin{figure}[!htb]
1566 \centering
1567 \begin{tikzexample}[title=,righthand width=0.4\textwidth]
1568 \begin{tikzpicture}[scale=0.8]
1569 \begin{scope}
1570 {\SOArg{15}{0.5}{10}+\IntArg{1}}
1571 \NyquistGraph[black,smooth,]{-1:2}
1572 {\POAmp{4}{0.5}+\RetAmp{1.8}}
1573 {\POArg{4}{0.5}+\RetArg{1.8}}
1574
1575 \NyquistGraph*[black,smooth,samples=2,
1576 only marks,mark=.]{-1:0.3}
1577 {\POAmp{4}{0.5}+\RetAmp{1.8}}
1578 {\POArg{4}{0.5}+\RetArg{1.8}}{[above]
1579 {\footnotesize $H_3$}}
1580 \NyquistGraph[purple,smooth,samples=81,]
1581 {-2:2}{\SOAmp{3}{0.5}{10}}{\SOArg{3}{0.5}{10}}
1582 \NyquistPoint*[black,]{8/below right,
1583 10/below left,20/left}
1584 {\SOAmp{3}{0.5}{10}}{\SOArg{3}{0.5}{10}}
1585 \NyquistText[red]{8/below left/Texte}
1586 {\SOAmp{3}{0.5}{10}}{\SOArg{3}{0.5}{10}}
1587 \end{scope}
1588 \NyquistGrid
1589 \end{tikzpicture}
1590 \end{tikzexample}
1591 \caption{Diagramme de Nyquist}
1592 \label{fig:diagnyq2}
1593 \end{figure}
1594
1595
1596
1597
1598 \begin{itemize}
1599 \item
1600 \myverb{\NyquistGraph[options]{domaine}{Module en dB}{Argument en degre}} \\
1601 \traduction{trace donc le lieu de Nyquist de fonctions simples ou de fonctions composées (voir les exemples ci-dessous).}{ traces Nyquist’s locus of simple functions or of compound functions ( see the examples below).}
1602
1603 \begin{itemize}
1604 \item \myverb{ [options]}\\
1605 \traduction{options de tracé}{options of drawing }
1606 \item \myverb{ {domaine}}\\
1607 \traduction{le domaine de tracé doit être défini en décade}{domain of drawing must be indicated in decades}
1608 \item \myverb{ {Module en dB}}\\
1609 \traduction{le module doit être écrit en dB, on peut bien sûr utiliser les fonctions élémentaires ci-dessus comme \textbf{\textbackslash POAmp}, \textbf{\textbackslash SOAmp} pour obtenir ce module.}
1610 {the module must be written in dB, you can also use the basic functions above such as \textbf{\textbackslash POAmp}, \textbf{\textbackslash SOAmp} to obtain the module.}
1611 \item \myverb{ {Argument en degre}}\\
1612 \traduction{l'argument doit être définie en degré, on peut utiliser les fonctions arguments ci-dessus comme \textbf{\textbackslash POArg}, \textbf{\textbackslash SOArg}.}
1613 {the argument must be indicated in degrees, you can use the argument functions above such as \textbf{\textbackslash POArg}, \textbf{\textbackslash SOArg}.}
1614 \end{itemize}
1615 \item {\small \myverb{\NyquistGraph*[options]{domaine}{Module en dB}{Argument en degre}{[options]{texte}}} }\\
1616
1617 \traduction{cette version étoilée permet de rajouter un commentaire à l'extrémité du tracé.}{this allows to add again a comment at the bottom of the drawing.
1618 }
1619
1620 \item {\small \myverb{\NyquistPoint[options]{liste pulsations}{Module en dB}{Argument en degre}}}\\
1621 \traduction{cette commande permet de tracer et noter des points particuliers du graphe, la valeur de la pulsation est placée à coté (droite par défaut).}{this command allows to trace and msrk specific points of the graph, the pulsation value is place on the side (on the right side by default).}
1622
1623 \item {\small \myverb{\NyquistPoint*[options]{liste pulsations}{Module en dB}{Argument en degre}} }\\
1624 \traduction{la version étoilée permet de préciser la position du point.}{the starred version allows to specify the point position.}
1625
1626 \item {\small \myverb{\NyquistText[options]{pulsation/pos/text}{Module en dB}{Argument en degre}} }\\
1627 \traduction{cette commande permet de positionner un \textbf{texte} par rapport à la courbe définie par \textbf{argument,module} le texte étant positionné à la pulsation \textbf{pulsation}, le paramètre \textbf{pos} permet de préciser la position du texte (\textbf{ right}, \textbf{ above}, \textbf{ below left}, \dots). Le point est nommé \textbf{ NNyquist}.}{this command allows to place a \textbf{texte} in relation to the curve defined by \textbf{argument} , \textbf{module} the text being positioned to the pulsation pulsation, \textbf{pos} parameter allows to specify the positioning of the text (\textbf{right}, \textbf{above}, \textbf{below left}, \dots). The point is named \textbf{NNyquist}.}
1628
1629 \item {\small \myverb{\NyquistText*[options]{pulsation/pos/text}{Module en dB}{Argument en degre}} }\\
1630 \traduction{commande identique à la précédente mais le point n'est pas dessiné.}{identical command to the previous one, but the point is not drawn. }
1631
1632 \end{itemize}
1633
1634
1635 \traduction{Une grille peut être ajoutée au tracé par la commande \textbf{\textbackslash NyquistGrid}, par défaut le pas de la grille est de 1 mais peut être réglé avec les deux variables \textbf{\textbackslash valgridNx} et \textbf{\textbackslash valgridNy}. La commande étoilée trace la grille seule sans graduation, la commande simple trace en plus le cercle unitaire, le point critique (-1,0).}{You can add a grid to the drawing by the command \textbf{\textbackslash NyquistGrid}, the grid step is 1 by default, but it can be modified using the two variables \textbf{\textbackslash valgridNx} and \textbf{\textbackslash valgridNy}. The starred command traces only the grid without graduation, the simple command traces also the unit circle, the critic point (-1,0).}
1636
1637
1638
1639 \subsubsection{\TradEnLigne{Styles par défaut}{Default style}}
1640
1641 Comme pour le diagramme de Black, des styles par défaut sont proposés:
1642
1643 \begin{itemize}
1644 \item \myverb{ Nyquist lines/.style={very thick, blue}}: \\
1645 \traduction{style pour le tracé du lieu de Nyquist;}{style for the drawing of Nyquist’s locus ;}
1646
1647 \item \myverb{ Nyquist grid/.style={ultra thin,brown}}:\\
1648 \traduction{ style de la grille;}{: grid style ; }
1649
1650 \item \myverb{ Nyquist label axes/.style={Nyquist grid,font=\tiny}}:\\
1651 \traduction{style utilisé pour les axes;}{style used for the axis ;}
1652
1653 \item \myverb{ Nyquist label points/.style={font=\tiny}}: \\
1654 \traduction{style utilisé pour les points;}{style used for the points;}
1655
1656 \item {\small \myverb{ ref points/.style={circle,draw, black, opacity=0.7,fill, minimum size= 2pt, inner sep=0}} }:\\
1657 \traduction{style utilisé pour marquer les points sur le diagramme.}{style used to mark the points on graph.}
1658 \end{itemize}
1659
1660
1661 \subsection{\TradEnLigne{Quelques exemples de tracé de lieu de Nyquist}{Some examples of Nyquist’s locus drawing }}
1662
1663 \traduction{Sur les deux figures fig.~\ref{fig:diagnyq1} et~\ref{fig:diagnyq2} sont représentées les fonctions suivantes:}{ the following functions are represented on the figure~\ref{fig:diagnyq1} et~\ref{fig:diagnyq2}.
1664 }
1665
1666 \begin{itemize}
1667 \item $H_1(p)=\dfrac{1}{1+\dfrac{2\cdot 0.1}{1500}\cdot p +\dfrac{p^2}{1500^2}}$
1668 \item $H_2(p)=\dfrac{5}{1+\dfrac{2\cdot 0.2}{150}\cdot p +\dfrac{p^2}{150^2}}$
1669 \item $H_3(p)=\dfrac{5}{1+3\cdot p}$
1670 \item $H_4(p)=\dfrac{1}{1}\dfrac{2\cdot 0.1}{1500}\cdot p +\dfrac{p^2}{1500^2}+ \cdot \dfrac{0.43\cdot\left(1+0.0009\cdot p\right)^2}{0.0009\cdot p}$
1671
1672 \end{itemize}
1673
1674
1675 \clearpage
1676
1677 \section{\TradEnLigne{Réponse temporelle}{Time response}}
1678 fig.~\ref{fig:graphreptemp}
1679 \begin{itemize}
1680 \item \myverb{\RepTemp[options]{domaine}{fonction}}\\
1681 \traduction{trace la fonction, la fonction doit être définie comme une fonction Gnuplot.}{traces the function, function must be defined like a gnuplot function.}
1682 \item \myverb{\RepTemp*[options]{domaine}{fonction}{[options]{texte}}}\\
1683 \traduction{trace la fonction et ajoute le texte à l'extrémité.}{traces the function and adds the text at the bottom.}
1684 \end{itemize}
1685
1686 \begin{figure}[!htb]
1687 \centering
1688 \begin{tikzexample}[title=,righthand width=0.4\textwidth]
1689 \begin{tikzpicture}[xscale=5/2,yscale=7/2]
1690 \RepTemp*[color=black,samples=31,
1691 smooth,]{0:1.8}
1692 {-.198*exp(-35.4*x)-.638*exp(-2.28*x)
1693 *cos(18.3*x)
1694 -.462*exp(-2.28*x)*sin(18.3*x)+.833
1695 }{[right]{\small 1}}
1696 \RepTemp*[color=blue,samples=31,smooth
1697 ]{0:1.8}{1-.117*exp(-24.1*x)-.883*exp(-2.94*x)
1698 *cos(7.03*x)
1699 -.769*exp(-2.94*x)*sin(7.03*x)
1700 }{[right]{\small 2}}
1701 \def\valmaxx{1.8}
1702 \def\valmaxy{1.2}
1703 \TempGrid[xstep=0.2,ystep=0.2]
1704 \end{tikzpicture}
1705 \end{tikzexample}
1706 \caption{Réponse temporelle}
1707 \label{fig:graphreptemp}
1708 \end{figure}
1709
1710
1711 \subsection{\TradEnLigne{Styles}{Styles}}
1712 \traduction{Plusieurs styles sont définis par défaut:}{ Different styles are defined by default:}
1713
1714 \begin{itemize}
1715 \item \myverb{ Temp lines/.style={very thick, blue} }: \TradEnLigne{style du tracé;}{ style of the drawing ;}
1716 \item \myverb{ Temp grid/.style={ultra thin,brown!80} }: \TradEnLigne{style de la grille;}{grid style;}
1717
1718 \item \myverb{ Temp label axes/.style={Temp grid, font=\tiny} }: \TradEnLigne{style des labels des axes;}{style of the labels of the axis ;}
1719
1720 \item \myverb{ Temp label points/.style={font=\tiny}}: \TradEnLigne{style des points marqués.}{style of marked points .}
1721 \end{itemize}
1722
1723
1724
1725 \newpage
1726
1727 \section{\TradEnLigne{Abaques}{Abacus}}
1728
1729 \traduction{Ces deux dernières commandes permettent de tracer les abaques caractéristiques d'un système du second ordre}{These last two commands allow you to draw the characteristic charts of a second order system.}
1730
1731 \subsection{\TradEnLigne{Temps de réponse d'un second ordre}{Second order response time chart}}
1732
1733 \begin{tikzexample}[title=,righthand width=0.5\textwidth,]
1734 \begin{tikzpicture}
1735 [xscale=2.5,yscale=3]
1736 \AbaqueTRsecond
1737 \end{tikzpicture}
1738 \end{tikzexample}
1739
1740
1741 \subsection{\TradEnLigne{Abaque des dépassements indiciels}{Abacus of index overruns}}
1742
1743 \begin{tikzexample}[title=,righthand width=0.55\textwidth,]
1744 \begin{tikzpicture}
1745 [scale=6/2]
1746 \AbaqueDepassement
1747 \end{tikzpicture}
1748 \end{tikzexample}
1749
1750
1751
1752
1753 \newpage
1754
1755 \tableofcontents
1756
1757
1758
1759 \end{document}