summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docFR.tex
blob: cce06c5ef1ffc5cc397e26e7d06b02715b37dbe0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
\documentclass{article}
\usepackage[latin1]{inputenc}%
\usepackage[T1]{fontenc}
\usepackage[a4paper,margin=2cm]{geometry}
%% Manuel LUQUE <Mluque5130aol.com> %%
%% 1 Octobre 1999 pour le dodécaèdre %%
%% 23 avril 2003 pour le calendrier %%
%% 26 avril : calcul de la date de Pâques %%
%% 27 avril 20003 : repérer une date particulière,
%% suggestion de Jean-Michel Sarlat %%
%% jours fériés : 1 et 8 mai, 1 et 11 décembre
%% 25 août et lundi de Pâques
\pagestyle{empty}
%
\usepackage[french]{pst-calendar}
%
\usepackage{url}
\newcommand\Encadre[1]{\psframebox[fillstyle=solid,fillcolor=yellow,linecolor=red]{#1}}
\title{Calculer un calendrier avec \LaTeX{},\\
le dessiner en 3D avec PSTricks (version 0.47)}
\author{Manuel Luque}
\date{\today}
\begin{document}

\maketitle
%{\typein[\Year]{Entrez l'année (2000...2099)?}
%\def\Year{2006}
\begin{center}
\psset{An=2006}
\begin{tabular}{ll}
\psCalendar[Mois=1]&\psCalendar[Mois=2]\\
\psCalendar[Mois=3]&\psCalendar[Mois=4]\\
\psCalendar[Mois=5]&\psCalendar[Mois=6]
\end{tabular}

\end{center}
\begin{center}
\begin{tabular}{ll}
\psCalendar[Mois=7]&\psCalendar[Mois=8]\\
\psCalendar[Mois=9]&\psCalendar[Mois=10]\\
\psCalendar[Mois=11]&\psCalendar[Mois=12]
\end{tabular}
\end{center}
%}
\begin{center}
\psscalebox{0.5}{\psCalDodecaeder[Vx=-\rd,Vy=\rc,Vz=0,viewangle=198]}
\end{center}
\section{Objectifs, outils et méthodes adoptés}
\subsection{Objectifs}
Il s'agissait de calculer avec \LaTeX{}, un calendrier valable de l'an
2\,000 à l'an 2\,099 (je suis optimiste), puis d'adopter une méthode
originale de représentation en 3D, en plaçant chaque mois sur l'une des
faces d'un dodécaèdre. Un calendrier de ce type était, il y quelques années,
offert par les visiteurs médicaux des laboratoires \textsc{Pfizer}.
\subsection{Outils adoptés}
Il existe déjà un calendrier écrit en \LaTeX{}, dont les calculs sont faits
directement en \TeX{}. Il s'agit de \texttt{calendar}, écrit par Michael
Barret et disponible sur le serveur du \texttt{CTAN} ; c'est très bien fait.

Un calendrier en 3D, dessiné avec PSTricks, est déjà proposé depuis plusieurs d'années par Denis
Girou sur : \url{http://tug.org/applications/PSTricks/More}.

Donc, rien de neuf, mais revu à ma façon : pour ma part j'ai décidé d'utiliser les macros du package \texttt{fp} de Michael
Mehlich, qui forment un excellent outil de calcul. La lecture du code écrit
avec ce package est plus compréhensible que celui écrit en \TeX{} de base.

Pour la représentation en 3d, j'ai aussi, utilisé PSTricks de Timothy Van Zandt, et
en particulier l'extension \texttt{pst-3d}.
\subsection{Méthode adoptée}
La méthode de calcul des jours de semaine du calendrier est déduite de quelques
observations :
\begin{enumerate}
  \item Le 1 janvier 2\,000 est un samedi. On adopte la convention de
  représenter les jours de semaine par un numéro : j'ai choisi :
\begin{center}
  \renewcommand{\arraystretch}{1.5}
  \begin{tabular}{ccccccc}
  lundi&mardi&mercredi&jeudi&vendredi&samedi&dimanche\\ \hline
  1&2&3&4&5&6&7
  \end{tabular}
\end{center}
  \item Une année ordinaire comprend 365 jours, or $365=52\times7+1$. Il y a
  donc un décalage de 1~jour dans le nom des jours pour l'année suivante si
  elle est ordinaire elle aussi. Autrement dit le 1~janvier 2\,001 devrait
  être un dimanche ($6+1=7$). Or l'an 2\,000 est bissextile et comporte 366~jours : le
  décalage sera de 2, le 1~janvier 2\,001 correspondra au numéro $6+2=8=1\ (modulo\ 7)$.
  \item Sur la période retenue 2\,000/2\,099 les années divisibles par 4 :
  2\,000, 2\,004, 2\,008 etc. sont bissextiles. On déterminera donc si
  l'année choisie est bissextile en testant si elle est un multiple de~4.
\begin{verbatim}
% test d'une année bissextile
\FPeval{\YearBissextil}{(\psk@CalendrierA)/4}
\FPtrunc{\YearBissextil}{\YearBissextil}{0}
\FPeval{\YearBissextil}{(\YearBissextil)*4}
\FPtrunc{\YearBissextil}{\YearBissextil}{0}
\ifnum\YearBissextil=\psk@CalendrierA
etc.
\end{verbatim}
  \item Pour une année choisie, on calculera le décalage par rapport à
  2\,000, en comptant les années et en ajoutant 1 chaque fois qu'il y aura
  dans cet intervalle une année bissextile (en tenant compte de 2\,000).
  \item On retient pour le début de chaque mois :
\begin{center}
  \renewcommand{\arraystretch}{1.5}
  \begin{tabular}{c|c|c}
  mois&année ordinaire&année bissextile\\ \hline
  janvier&1&1\\
  février&32&32\\
  mars&60&61\\
  avril&91&92\\
  mai&121&122\\
  juin&152&153\\
  juillet&182&183\\
  août&213&214\\
  septembre&244&245\\
  octobre&274&275\\
  novembre&305&306\\
  décembre&335&336\\
  \end{tabular}
\end{center}
\end{enumerate}




\section{L'utilisation}
\subsection{Utilisation simple}
Si on veut voir uniquement le mois de l'année choisie, on fera, par exemple :
\begin{verbatim}
\psCalendar[An=2099,Mois=12,Jour=25,MoisChoisi=12]
\end{verbatim}
\begin{center}
\psCalendar[An=2099,Mois=12,Jour=25,MoisChoisi=12]
\end{center}
Cette étude ne teste pas si les valeurs introduites pour l'année(\texttt{An}) et le mois(\texttt{Mois}), sont correctes !

Par défaut, la commande \verb+\psCalendar+ affiche le mois et l'année en
cours et entoure la date du jour (suggestion de Jean-Michel \textsc{Sarlat}).

Si on veut voir afficher, un jour d'un mois particulier, on rajoutera le
paramètre \Encadre{\texttt{MoisChoisi=valeur}} aux autres, comme dans
l'exemple précédent et le suivant.
\begin{center}
\psCalendar
\end{center}
\begin{verbatim}
\psCalendar[An=2004,Mois=6,Jour=21,MoisChoisi=6]
\end{verbatim}
\begin{center}
\psCalendar[An=2004,Mois=6,Jour=21,MoisChoisi=6]
\end{center}
\subsection{Le calendrier en 3D}
La commande s'écrit très simplement :
\begin{verbatim}
\psCalDodecaeder
\end{verbatim}
\begin{center}
\psscalebox{0.5}{\psCalDodecaeder}
\end{center}
pour avoir le calendrier de l'année en cours. Si le schéma est trop grand à
votre goût, encadrez la commande par un \verb+\psscalebox{0.5}{\psCalDodecaeder}+

Pour avoir le mois de mai face à soi, on écrira, par exemple :
\begin{verbatim}
\psscalebox{0.5}{\psCalDodecaeder[style=mai]}
\end{verbatim}
\begin{center}
\psscalebox{0.5}{\psCalDodecaeder[style=mai]}
\end{center}
\verb+Vx, Vy, Vz+ sont les valeurs des paramètres de \texttt{viewpoint=-5.85 -3.62
0} de la commande \verb+\ThreeDput+ de \verb+pst-3d+, qui sont les
coordonnées d'un vecteur définissant la direction où se trouve
l'observateur (la direction de la projection parallèle).

On jouera aussi sur le paramètre \verb+viewangle+, pour amener la face
observée dans le bon sens de la lecture.

Pour avoir le mois de janvier face à soi, on écrira :
\begin{verbatim}
\psscalebox{0.35}{\psCalDodecaeder[style=janvier]}
\end{verbatim}
\begin{center}
\psscalebox{0.35}{\psCalDodecaeder[style=janvier]}
\end{center}
Pour avoir le mois de février face à soi, on écrira :
\begin{verbatim}
\psscalebox{0.35}{\psCalDodecaeder[style=fevrier]}
\end{verbatim}
\begin{center}
\psscalebox{0.35}{\psCalDodecaeder[style=fevrier]}
\end{center}
Pour avoir le mois de mars face à soi, on écrira :
\begin{verbatim}
\psscalebox{0.35}{\psCalDodecaeder[style=mars]}
\end{verbatim}
\begin{center}
\psscalebox{0.35}{\psCalDodecaeder[style=mars]}
\end{center}
Pour avoir le mois d'avril face à soi, on écrira :
\begin{verbatim}
\psscalebox{0.35}{\psCalDodecaeder[style=avril]}
\end{verbatim}
\begin{center}
\psscalebox{0.35}{\psCalDodecaeder[style=avril]}
\end{center}
Pour avoir le mois de juin face à soi, on écrira :
\begin{verbatim}
\psscalebox{0.35}{\psCalDodecaeder[style=juin]}
\end{verbatim}
\begin{center}
\psscalebox{0.35}{\psCalDodecaeder[style=juin]}
\end{center}
Pour avoir le mois de juillet face à soi, on écrira :
\begin{verbatim}
\psscalebox{0.35}{\psCalDodecaeder[style=juillet]}
\end{verbatim}
\begin{center}
\psscalebox{0.35}{\psCalDodecaeder[style=juillet]}
\end{center}
Pour avoir le mois d'août face à soi, on écrira :
\begin{verbatim}
\psscalebox{0.35}{\psCalDodecaeder[style=aout]}
\end{verbatim}
\begin{center}
\psscalebox{0.35}{\psCalDodecaeder[style=aout]}
\end{center}
Pour avoir le mois de septembre face à soi, on écrira :
\begin{verbatim}
\psscalebox{0.35}{\psCalDodecaeder[style=septembre]}
\end{verbatim}
\begin{center}
\psscalebox{0.35}{\psCalDodecaeder[style=septembre]}
\end{center}
Pour avoir le mois d'octobre face à soi, on écrira :
\begin{verbatim}
\psscalebox{0.35}{\psCalDodecaeder[style=octobre]}
\end{verbatim}
\begin{center}
\psscalebox{0.35}{\psCalDodecaeder[style=octobre]}
\end{center}
Pour avoir le mois de novembre face à soi, on écrira :
\begin{verbatim}
\psscalebox{0.35}{\psCalDodecaeder[style=novembre]}
\end{verbatim}
\begin{center}
\psscalebox{0.35}{\psCalDodecaeder[style=novembre]}
\end{center}
Pour avoir le mois de décembre face à soi, on écrira :
\begin{verbatim}
\psscalebox{0.35}{\psCalDodecaeder[style=decembre]}
\end{verbatim}
\begin{center}
\psscalebox{0.35}{\psCalDodecaeder[style=decembre]}
\end{center}
Pour visualiser une année particulière, avec un mois choisi face à soi, et un jour de ce mois, (15~mai~2004) on
fera :
\begin{verbatim}
\psscalebox{0.35}{\psCalDodecaeder[style=mai,An=2004,MoisChoisi=5,Jour=15]}
\end{verbatim}
\begin{center}
\psscalebox{0.35}{\psCalDodecaeder[style=mai,An=2004,MoisChoisi=5,Jour=15]}
\end{center}
\section{Calcul de la date de Pâques}
On trouve sur internet, à propos de ce sujet de nombreux sites. \'A partir
de la \textit{définition} de la fête proprement dite, les formules <<
magiques >> abondent. L'une d'elle a retenu mon attention, je l'ai
retranscrite avec le package \texttt{fp}. Dans l'ordre, un aperçu de la
page, puis le codage des calculs avec \texttt{fp}.

Le site : \texttt{http://www.altcal.com/elmcal.html}, et un extrait :

\begin{verbatim}
Version 2.0 - 11 Nov 1998

Copyright and disclaimer
------------------------
        This document is Copyright (C) 1998 by Claus Tondering.
        E-mail: claus@tondering.dk.
        The document may be freely distributed, provided this
        copyright notice is included and no money is charged for
        the document.
        This document is provided "as is". No warranties are made as
        to its correctness.

G = year mod 19

For the Julian calendar:
    I = (19*G + 15) mod 30
    J = (year + year/4 + I) mod 7

For the Gregorian calendar:
    C = year/100
    H = (C - C/4 - (8*C+13)/25 + 19*G + 15) mod 30
    I = H - (H/28)*(1 - (H/28)*(29/(H + 1))*((21 - G)/11))
    J = (year + year/4 + I + 2 - C + C/4) mod 7

Thereafter, for both calendars:
L = I - J
EasterMonth = 3 + (L + 40)/44
EasterDay = L + 28 - 31*(EasterMonth/4)
\end{verbatim}

\hrule
{\blue
\begin{verbatim}
\FPset{\Year}{1981}  % placer ici l'année
\FPeval\GY{(\Year)-19*trunc((\Year)/19,0)}
\FPeval{\Cent}{trunc((\Year)/100,0)}
\FPeval{\Iter}{trunc((\Cent)-trunc((\Cent)/4,0)-trunc((8*(\Cent)+13)/25,0)+
                (\GY)*19+15,0)}
\FPeval{\Iterdiv}{trunc((\Iter)/30,0)}
\FPeval\Hepact{(\Iter)-30*(\Iterdiv)}
\FPeval\Inbre{trunc((\Hepact)-trunc((\Hepact)/28,0)*
              (1-trunc((\Hepact)/28,0))*(trunc(29/((\Hepact)+1),0)*trunc((21-(\GY))/11,0)),0)}
\FPeval\Jnbreinter{trunc((\Year)+trunc((\Year)/4,0)+(\Inbre)+2-(\Cent)+trunc((\Cent)/4,0),0)}
\FPeval\Jnbre{trunc((\Jnbreinter)-7*trunc((\Jnbreinter)/7,0),0)}
\FPeval\Lnbre{trunc((\Inbre)-(\Jnbre),0)}
\FPeval\Month{trunc(3+trunc(((\Lnbre)+40)/44,0),0)}
\FPeval\Day{trunc((\Lnbre)+28-31*trunc((\Month)/4,0),0)}
\ifnum\Month=4
  \ifnum\Day>25 \FPeval{\Day}{trunc((\Day)-7,0)} \fi
\fi

P\^aques le Dimanche \FPprint\Day/\FPprint\Month/\FPprint\Year
\end{verbatim}}
\FPset{\Year}{1981}  % placer ici l'année
\FPeval\GY{(\Year)-19*trunc((\Year)/19,0)}
\FPeval{\Cent}{trunc((\Year)/100,0)}
\FPeval{\Iter}{trunc((\Cent)-trunc((\Cent)/4,0)-trunc((8*(\Cent)+13)/25,0)+
                (\GY)*19+15,0)}
\FPeval{\Iterdiv}{trunc((\Iter)/30,0)}
\FPeval\Hepact{(\Iter)-30*(\Iterdiv)}
\FPeval\Inbre{trunc((\Hepact)-trunc((\Hepact)/28,0)*
              (1-trunc((\Hepact)/28,0))*(trunc(29/((\Hepact)+1),0)*trunc((21-(\GY))/11,0)),0)}
\FPeval\Jnbreinter{trunc((\Year)+trunc((\Year)/4,0)+(\Inbre)+2-(\Cent)+trunc((\Cent)/4,0),0)}
\FPeval\Jnbre{trunc((\Jnbreinter)-7*trunc((\Jnbreinter)/7,0),0)}
\FPeval\Lnbre{trunc((\Inbre)-(\Jnbre),0)}
\FPeval\Month{trunc(3+trunc(((\Lnbre)+40)/44,0),0)}
\FPeval\Day{trunc((\Lnbre)+28-31*trunc((\Month)/4,0),0)}
\ifnum\Month=4
  \ifnum\Day>25 \FPeval{\Day}{trunc((\Day)-7,0)} \fi
\fi

\centerline{\Encadre{P\^aques tombe le dimanche
\FPprint\Day/\FPprint\Month/\FPprint\Year}}

Vous y reconnaîtrez sans peine l'algorithme initial, j'ai rajouté les trois
dernières lignes, car l'auteur des formules précédentes semble avoir oublié
que Pâques peut varier seulement entre le 22~mars et le 25~avril inclus
 Sans cette correction, le programme affiche dans l'exemple précédent (1981), le dimanche 26~avril au lieu du
 19~avril.

Pour le tester quelques dates :
\begin{center}
\begin{tabular}{c|c}
1978& 26 mars \\ \hline
1979&15 avril \\ \hline
1980&6 avril \\ \hline
2000&23 avril \\ \hline
2002&31 mars \\ \hline
2003&20 avril \\ \hline
\end{tabular}
\end{center}
Ce n'est pas garanti sans erreurs, l'emploi des fonctions \texttt{trunc} ou
\texttt{round} ou \texttt{clip} ne donnent pas à 100\% toujours, le résultat
attendu. Par exemple si \texttt{fp} calcule $14.99999999$, alors que
de toute évidence c'est $15$, il ne vaut mieux pas faire
\texttt{trunc} pour avoir la partie entière, mais \texttt{round},
car sinon on commet une erreur d'une unité en moins ! Il faudrait
donc prévoir de tester ces cas !
\section{Que reste-t-il à faire ? Problèmes !}
\begin{itemize}
  \item Placer les jours fériés du lundi de Pâques et du lundi de
  Pentecôte.
  \item Dessiner automatiquement le mois en cours, face à notre regard.
  \item Prévoir un test qui limite l'année choisie à l'intervalle permis,
  soit $[2000-2099]$.
  \item Trouver un moyen simple, élégant et cohérent d'entourer la date choisie.
  \item Débusquer les erreurs, si vous en trouvez\ldots
\end{itemize}

\end{document}