Debian Codegraph @

texmf-dist/doc/generic/dcpic/manDCPiCpt.tex

raw
1 % $Id: manDCPiCpt.tex 13 2013-04-21 15:28:45Z pedro $
2 \documentclass[a4paper,11pt]{article}
3 \usepackage{a4wide}
4 \usepackage[portuguese]{babel}
5 \usepackage{ae} % Virtual fonts for PDF-files with T1 encoded CMR-fonts.
6 \usepackage[T1]{fontenc}
7 \usepackage[utf8x]{inputenc}
8 \usepackage{dcpic,pictex}
9 \usepackage{alltt}
10 \usepackage{verbatim}
11 \usepackage{longtable}
12 \usepackage{svn-multi}
13 \usepackage{listings}
14 \usepackage{url}
15
16 \svnidlong
17 {$HeadURL: svn+ssh://gentzen.mat.uc.pt/var/lib/svn/DCPiC/CTAN5.0/manDCPiCpt.tex $}
18 {$LastChangedDate: 2013-05-01 19:49:49 +0100 (Qua, 01 Mai 2013) $}
19 {$LastChangedRevision: 15 $}
20 {$LastChangedBy: pedro $}
21
22 \svnid{$Id: manDCPiCpt.tex 13 2013-04-21 15:28:45Z pedro $}
23
24 \newcommand{\docversion}{\svnyear/\svnmonth/\svnday\ (v\svnrev)}
25
26 \def\dcpicversion{v5.0.0}
27
28 \lstset{language=TeX,
29 frame = single,
30 morekeywords={begindc,enddc,cmor,pup,commdiag,undigraph,digraph,cdigraph,cundigraph,obj,mor,pleft,pup,pdown,pright,north,northeast,east,southeast,south,southwest,west,northwest,atright,atleft,solidarrow,dashArrow,dotArrow,solidline,dashline,dotline,injectionarrow,aplicationarrow,surjectivearrow,equalline,doublearrow,doubleopposite,nullarrow},
31 basicstyle=\scriptsize}
32
33
34 \title{DCpic (5.0) --- Manual de Utilização\\
35 \docversion}
36
37 \author{Pedro Quaresma\\ CISUC/Departamento de Matemática,
38 Universidade de Coimbra\\ 3001-454 COIMBRA, PORTUGAL\\
39 \url{[email protected]}\quad phone: +351-239~791~137\quad fax:
40 +351-239~832~568}
41
42 \date{2013/05/01}
43
44 \begin{document}
45
46 \maketitle
47
48 \begin{abstract}
49 O {\em DCpic\/} é um conjunto de comandos para a escrita de grafos,
50 para tal desenvolveu-se um conjunto de comandos, com uma sintaxe
51 simples, que permite a construção de quase todo o tipo de grafos.
52
53 Originalmente o {\em DCpic\/} ({\bf D}iagramas {\bf C}omutativos
54 utilizando o {\bf PiC}TeX) foi concebido para a construção de
55 diagramas comutativos tal como são usados em Teoria das
56 Categorias~\cite{Herrlich73,Pierce98}, temos então grafos etiquetados
57 e com elementos nos nós. A partir da versão 4.0 o conjunto de
58 comandos foi alterada de forma a considerar-se também a construção de
59 grafos dirigidos, e grafos não dirigidos. A forma de os especificar
60 recorre à colocação dos diferentes objectos (nós e arestas) num dado
61 referencial ortonormado,
62
63 O {\em DCpic} está baseado no \PiCTeX\ necessitando deste para poder
64 ser usado.
65 \end{abstract}
66
67 \vfill
68 \begin{quotation}
69 This work may be distributed and/or modified under the
70 conditions of the LaTeX Project Public License, either version 1.3
71 of this license or (at your option) any later version.
72 The latest version of this license is in
73 http://www.latex-project.org/lppl.txt
74 and version 1.3 or later is part of all distributions of LaTeX
75 version 2005/12/01 or later.
76 This work has the LPPL maintenance status `maintained'.
77
78 The Current Maintainer of this work is Pedro Quaresma (\url{[email protected]}).
79
80 This work consists of the files dcpic.sty.
81 \end{quotation}
82
83 \vspace*{2cm}
84 \noindent Coimbra, 2013/04/21\\
85 Pedro Quaresma
86
87 \pagebreak
88 \section{Hist\'oria}
89
90 \begin{description}
91 \item[11/1990 - versão 1.0]
92 \item[10/1991 - versão 1.1]
93 \item[9/1993 - versão 1.2:] argumento ``distância entre as
94 extremidades da seta e os objectos'' passou a ser opcional; uma nova
95 opção para as ``setas'' (opção 3).
96 \item[2/3/1995 - versão 1.3:] foi acrescentado o tipo de seta de
97 aplicação (opção 4) a distância da etiqueta
98 à seta respectiva passou a ser fixa (10 unidades de medida).
99
100 \item[15/7/1996 - vers\~ao 2.1:] o comando {\tt mor} passou a ter uma
101 sintaxe distinta. Os parâmetros 5 e 6 passaram a ser a
102 distância entre os objectos e os extremos da seta o
103 parâmetro 7 é o nome do morfismo e os parâmetros 8 e 9,
104 colocação do morfismo e tipo de morfismo passaram a ser
105 opcionais.
106
107 \item[5/2001 - versão 3.0:] implementação do comando
108 {\tt cmor} baseado no comando de desenho de curvas quadráticas pelo
109 \PiCTeX.
110
111 \item[11/2001 - versão 3.1:] modificação das pontas das
112 setas de forma a estas ficarem semelhantes às setas
113 (símbolos) dos TeX.
114
115 \item[1/2002 - versão 3.2:] modificação dos comandos {\tt obj}
116 e {\tt mor} de forma a introduzir a especificação lógica
117 dos morfismos, isto é, passa-se a dizer qual é o objecto de
118 partida e/ou o objecto de chegada em vez de ter de especificar o
119 morfismo em termos de coordenadas. Por outro lado o tamanho das
120 setas passa a ser ajustado automaticamente em relação ao
121 tamanho dos objectos.
122
123 \item[5/2002 - vers\~ao 4.0:] {\bf vers\~ao incompatível com as
124 anteriores}. Modificação dos comandos {\tt begindc} e {\tt obj}. O
125 primeiro passou a ter um argumento (obrigat\'orio) que nos
126 permite especificar o tipo de grafo que estamos a querer
127 especificar:
128 \begin{itemize}
129 \item {\tt commdiag} (0), para diagramas comutativos;
130 \item {\tt digraph} (1), para grafos orientados;
131 \item {\tt undigraph} (2), para grafos n\~ao orientados.
132 \end{itemize}
133
134 O comando {\tt obj} modificou a sua sintaxe passou a ter um (após a
135 especifica\c c\~ao das coordenadas, um argumento opcional, um argumento
136 obrigat\'orio, e um argumento opcional. O primeiro argumento opcional
137 d\'a-nos a etiqueta que serve como refer\^encia para a especifica\c c\~ao dos
138 morfismos, na sua aus\^encia usa-se o argumento obrigat\'orio para esse
139 efeito, o argumento obrigat\'orio d\'a-nos o ``conte\'udo'' do objecto, nos
140 diagramas comutativos \'e centrado no ponto dado pelas coordenadas
141 sendo o argumento seguinte simplesmente ignorado, nos grafos o
142 ``conte\'udo'' \'e colocado numa posi\c c\~ao a norte, a noroeste, a este, \ldots,
143 sendo que a posi\c c\~ao concreta \'e especificada pelo \'ultimo dos
144 argumentos deste comando, o valor por omiss\~ao \'e o {\tt norte}.
145
146 \item[3/2003 - vers\~ao 4.1:] a pedido de Jon Barker \url{<[email protected]>}
147 criei um novo tipo de seta, a seta de sobrejec\c c\~ao. Para j\'a a dupla
148 seta s\'o fica bem nas setas horizontais ou verticais.
149
150 \item[12/2004 - vers\~ao 4.1.1:] nova vers\~ao das setas de sobrejec\c c\~ao que
151 corrigue completamente os problemas da solu\c c\~ao anterior.
152
153 \item[3/2007 - vers\~ao 4.2:] acrescenta a directiva
154 ``providespackage''. Acrescenta linhas a ponteado e a tracejado.
155
156 \item[5/2008 - vers\~ao 4.2.1:] apaga alguns contadores para tentar
157 diminuir o excessivo uso dos mesmos por parte do PiCTeX.
158
159 \item[8/2008 - vers\~ao 4.3:] gra\c cas a Ruben Debeerst
160 \url{<[email protected]>}, acrescentei uma nova
161 ``seta'' a ``equalline''. Ap\'os isso decidi tamb\'em acrescentar
162 setas duplas, com o mesmo ou diferentes sentidos. Acrescentou-se
163 também a seta nula, isto é, sem representação gráfica, a qual pode
164 ser usada para acrescentar etiquetas a outras ``setas''.
165
166 \item[12/2008 - version 4.3.1:] para evitar conflitos com outros
167 pacotes o comando ``id'' \'e internalizado. O comando ``dasharrow'' \'e
168 modificado para ``dashArrow'' para evitar um conflito com o AMSTeX.
169
170 \item[12/2009 - version 4.3.2:] para evitar um conflito com o pacote
171 ``hyperref'' mudou-se o contador ``d'' para ``deuc'', aproveitei e
172 mudei os contadores ``x'' e ``y'' para ``xO'' e ``yO''
173
174 \item[4/2013 - version 4.4.0:] graças a Xingliang Liang
175 \url{[email protected]>} acrescentou-se uma nova seta ``dotarrow''.
176
177 \item[4/2013 - version 5.0:] {\bf uma nova unidade para o sistema de
178 coordenadas}, 1/10 da anterior. Esta nova unidade permite
179 corriguir um problema com a construção das setas duplas, além de
180 permitir uma especificação mais fina dos diagramas.
181 \end{description}
182
183 \section{Introdução}
184
185 O conjunto de comandos {\em DCpic} é um conjunto de comandos
186 \TeX~\cite{Knuth86} dedicado à escrita de diagramas tal como são
187 usados em Teoria das Categorias~\cite{Herrlich73,Pierce98}, assim como
188 de grafos dirigidos e não dirigidos~\cite{Harary72}.
189
190 Pretendeu-se com a sua escrita ter uma forma simples de especificar
191 grafos, fazendo-o através da especificação de um conjunto de
192 ``objectos'' (nós do grafo) colocados num dado referencial
193 ortonormado, e através de um conjuntos de morfismos (arestas) que os
194 são posicionados explicitamente no referido referencial, ou então,
195 a são posição é dada especificando qual é o seu nó de
196 partida e qual é o seu nó de chegada.
197
198 O gráfico em si é construído recorrendo aos comandos gráficos
199 do \PiCTeX.
200
201 \section{Utilização}
202
203 Antes de mais é necessário carregar os dois conjuntos de comandos
204 acima referidos, no caso de um documento \LaTeX~\cite{Lamport94} isso
205 pode ser feito com o seguinte comando (no preâmbulo).
206
207 \begin{verbatim}
208 \usepackage{dcpic,pictex}
209 \end{verbatim}
210
211 Nos outros formatos ter-se-á de usar um comando equivalente. Após
212 isso os diagramas podem ser escritos através dos comandos
213 disponibilizados pelo {\em DCpic}. Por exemplo, os comandos:
214
215
216 \begin{lstlisting}
217 \begindc{\commdiag}[200]
218 \obj(1,4){$A^B$}
219 \obj(1,1){$C$}
220 \obj(3,4){$A$}
221 \obj(3,1){$C\times{}B$}
222 \obj(6,4){$A^B\times{}B$}
223 \mor{$C$}{$A^B$}{$f$}
224 \mor{$C\times{}B$}{$A$}{$\bar f$}[\atleft,\dashArrow]
225 \mor{$A^B\times{}B$}{$A$}{$ev$}[\atright,\solidarrow]
226 \mor{$C\times{}B$}{$A^B\times{}B$}{$f\times{}id$}[\atright,\solidarrow]
227 \enddc
228 \end{lstlisting}
229
230 produzem o seguinte diagrama:
231
232 $$
233 \begindc{\commdiag}[200]
234 \obj(1,4){$A^B$}
235 \obj(1,1){$C$}
236 \obj(3,4){$A$}
237 \obj(3,1){$C\times{}B$}
238 \obj(6,4){$A^B\times{}B$}
239 \mor{$C$}{$A^B$}{$f$}
240 \mor{$C\times{}B$}{$A$}{$\bar f$}[\atleft,\dashArrow]
241 \mor{$A^B\times{}B$}{$A$}{$ev$}[\atright,\solidarrow]
242 \mor{$C\times{}B$}{$A^B\times{}B$}{$f\times{}id$}[\atright,\solidarrow]
243 \enddc
244 $$
245
246 O meio ambiente {\tt begindc}, {\tt enddc} permite-nos construir um
247 grafo por colocação dos objectos num referencial ortonormado tendo
248 a origem em (0,0). As arestas (morfismos) vão ligar pares de nós
249 (objectos) entre si.
250
251 \section{Comandos Disponíveis}
252
253 De seguida apresenta-se a descrição dos comandos, a sua sintaxe e
254 a sua funcionalidade. Os argumentos entre parêntesis rectos são
255 opcionais.
256
257 \begin{description}
258 \item[\tt $\backslash$begindc\{\#1\}[\#2\mbox{]}] -- entrada no ambiente de
259 escrita de grafos:
260
261 \begin{tabular}{r@{ -- }l}
262 {\tt \#1} & tipo de grafo\\
263 \multicolumn{2}{l}{\quad $0\equiv\backslash$commdiag, diagrama comutativo;}\\
264 \multicolumn{2}{l}{\quad $1\equiv\backslash$digraph, grafo orientado;}\\
265 \multicolumn{2}{l}{\quad $2\equiv\backslash$undigraph, grafo não orientado;}\\
266 \multicolumn{2}{l}{\quad $3\equiv\backslash$cdigraph, grafo orientado, com
267 objectos circunscritos;}\\
268 \multicolumn{2}{l}{\quad $4\equiv\backslash$cundigraph, grafo não orientado,
269 com objectos circunscritos.}\\
270 {\tt \#2} & factor de escala (opcional)\\
271 \multicolumn{2}{l}{\quad valor por omissão: 300}
272 \end{tabular}
273
274 \item[\tt $\backslash$enddc] -- saída do meio ambiente para a
275 escrita de grafos.
276
277 \item[{\tt $\backslash$obj(\#1,\#2)[\#3]\{\#4\}[\#5]}:] comando de colocação
278 dos nós (objectos).
279
280 \begin{tabular}{r@{ -- }l}
281 {\tt \#1} e {\tt \#2}& coordenadas do centro da caixa que vai
282 conter o texto\\
283 {\tt \#3} & etiqueta para identificar o objecto (opcional)\\
284 {\tt \#4} & texto (conte{\'u}do do nó)\\
285 {\tt \#5} & colocação relativa do objecto (opcional)\\
286 \multicolumn{2}{l}{\qquad\quad $0\doteq\backslash$pcent, centrado}\\
287 \multicolumn{2}{l}{\qquad\quad $1\doteq\backslash$north, norte}\\
288 \multicolumn{2}{l}{\qquad\quad $2\doteq\backslash$northeast, nordeste}\\
289 \multicolumn{2}{l}{\qquad\quad $3\doteq\backslash$east, este}\\
290 \multicolumn{2}{l}{\qquad\quad $4\doteq\backslash$southeast, sudeste}\\
291 \multicolumn{2}{l}{\qquad\quad $5\doteq\backslash$south, sul}\\
292 \multicolumn{2}{l}{\qquad\quad $6\doteq\backslash$southwest, sudoeste}\\
293 \multicolumn{2}{l}{\qquad\quad $7\doteq\backslash$west, oeste}\\
294 \multicolumn{2}{l}{\qquad\quad $8\doteq\backslash$northwest, noroeste}
295 \end{tabular}
296
297 A etiqueta explícita-se quando não é possível usar o objecto como
298 forma de identificação do nó, por exemplo num dado grafo não orientado
299 os nós podem não ter conteúdo e como tal serem todos iguais em termos
300 de identificação:
301
302 Em alguns casos, por exemplo comandos dos \LaTeX\ complexos, pode ser
303 necessário explicitar o argumento {\tt \#3} mesmo que seja através da
304 etiqueta vazia {\tt []}. Esse especificar da etiqueta vazia torna-se
305 necessário para que o mecanismo interno do DCpic de comunicação entre
306 comandos (pilhas) não se baralhe e entre num ciclo infinito.
307
308
309 $$
310 \begindc{\undigraph}[200]
311 \obj(1,1)[1]{}
312 \obj(3,2)[2]{}
313 \obj(5,1)[3]{}
314 \obj(3,4)[4]{}
315 \mor{1}{2}{}
316 \mor{1}{3}{}
317 \mor{2}{3}{}
318 \mor{4}{1}{}
319 \mor{4}{3}{}
320 \mor{2}{4}{}
321 \enddc
322 $$
323 foi produzido por:
324 \begin{lstlisting}
325 \begindc{\undigraph}[200]
326 \obj(1,1)[1]{}
327 \obj(3,2)[2]{}
328 \obj(5,1)[3]{}
329 \obj(3,4)[4]{}
330 \mor{1}{2}{}
331 \mor{1}{3}{}
332 \mor{2}{3}{}
333 \mor{4}{1}{}
334 \mor{4}{3}{}
335 \mor{2}{4}{}
336 \enddc
337 \end{lstlisting}
338
339
340 O parâmetro referente à colocação do objecto só é relevante quando se
341 pensa na identificação dos nós num dado grafo orientado (ou não), por
342 exemplo o grafo ``Around the Word''~\cite{Harary72}:
343
344 $$
345 \begindc{\undigraph}[70]
346 \obj(6,4){18}[\south]
347 \obj(18,4){17}[\south]
348 \obj(8,7){11}[\west]
349 \obj(12,8){12}[\south]
350 \obj(16,7){13}[\east]
351 \obj(8,11){10}[\west]
352 \obj(10,12){6}[\northwest]
353 \obj(12,10){5}
354 \obj(14,12){4}[\northeast]
355 \obj(16,11){14}[\east]
356 \obj(2,16){19}
357 \obj(6,15){9}
358 \obj(9,16){8}
359 \obj(11,14){7}
360 \obj(13,14){3}
361 \obj(15,16){2}
362 \obj(18,15){15}
363 \obj(22,16){16}
364 \obj(12,19){1}[\northeast]
365 \obj(12,22){20}
366 \mor{18}{17}{}\mor{18}{11}{}\mor{18}{19}{}
367 \mor{11}{12}{}\mor{11}{10}{}\mor{12}{13}{}
368 \mor{12}{5}{}\mor{10}{6}{}\mor{10}{9}{}
369 \mor{5}{6}{}\mor{5}{4}{}\mor{13}{17}{}
370 \mor{13}{14}{}\mor{9}{19}{}\mor{9}{8}{}
371 \mor{6}{7}{}\mor{4}{3}{}\mor{4}{14}{}
372 \mor{19}{20}{}\mor{8}{1}{}\mor{8}{7}{}
373 \mor{7}{3}{}\mor{3}{2}{}\mor{2}{1}{}
374 \mor{2}{15}{}\mor{14}{15}{}\mor{17}{16}{}
375 \mor{16}{20}{}\mor{1}{20}{}\mor{15}{16}{}
376 \enddc
377 $$
378 foi produzido por
379 \begin{lstlisting}
380 \begindc{\undigraph}[70]
381 \obj(6,4){18}[\south]
382 \obj(18,4){17}[\south]
383 \obj(8,7){11}[\west]
384 \obj(12,8){12}[\south]
385 \obj(16,7){13}[\east]
386 \obj(8,11){10}[\west]
387 \obj(10,12){6}[\northwest]
388 \obj(12,10){5}
389 \obj(14,12){4}[\northeast]
390 \obj(16,11){14}[\east]
391 \obj(2,16){19}
392 \obj(6,15){9}
393 \obj(9,16){8}
394 \obj(11,14){7}
395 \obj(13,14){3}
396 \obj(15,16){2}
397 \obj(18,15){15}
398 \obj(22,16){16}
399 \obj(12,19){1}[\northeast]
400 \obj(12,22){20}
401 \mor{18}{17}{}\mor{18}{11}{}\mor{18}{19}{}
402 \mor{11}{12}{}\mor{11}{10}{}\mor{12}{13}{}
403 \mor{12}{5}{}\mor{10}{6}{}\mor{10}{9}{}
404 \mor{5}{6}{}\mor{5}{4}{}\mor{13}{17}{}
405 \mor{13}{14}{}\mor{9}{19}{}\mor{9}{8}{}
406 \mor{6}{7}{}\mor{4}{3}{}\mor{4}{14}{}
407 \mor{19}{20}{}\mor{8}{1}{}\mor{8}{7}{}
408 \mor{7}{3}{}\mor{3}{2}{}\mor{2}{1}{}
409 \mor{2}{15}{}\mor{14}{15}{}\mor{17}{16}{}
410 \mor{16}{20}{}\mor{1}{20}{}\mor{15}{16}{}
411 \enddc
412 \end{lstlisting}
413
414
415
416 \item[{\tt $\backslash$mor\{\#1\}\{\#2\}[\#5,\#6]\{\#7\}[\#8,\#9]}:]
417 Comando de colocação da seta (morfismo) de ligação de dois objectos
418 -- Primeira variante.
419
420 A numeração errada dos argumentos é aqui feita propositadamente,
421 aquando da explicação da segunda variante deste comando
422 compreender-se-á o porquê desta opção de escrita.
423
424 \begin{longtable}{r@{ -- }p{32em}}
425 {\tt \#1} & referência do nó de partida\\
426 {\tt \#2} & referência do nó de chegada\\
427 {\tt \#5} e {\tt \#6} & distância do centro dos objectos às
428 extremidades inicial e final respectivamente da seta. Valores por
429 omissão: 10, 10 (para diagramas) 2, 2 (para os grafos)\\
430 {\tt \#7} & texto, ``nome'' do morfismo\\
431 {\tt \#8} & colocação do nome do morfismo em relação à seta. Valor
432 por omissão, $\backslash$atleft. \\
433 \multicolumn{2}{l}{\hspace*{4.5em} 1 $\doteq\backslash$atright, à direita}\\
434 \multicolumn{2}{l}{\hspace*{4.5em} -1 $\doteq\backslash$atleft, à esquerda}\\
435 {\tt \#9} & tipo da seta. Valor por omissão, $\backslash$solidarrow.\\
436 \multicolumn{2}{l}{\hspace*{4.5em} 0 $\doteq\backslash$solidarrow, seta sólida} \\
437 \multicolumn{2}{l}{\hspace*{4.5em} 1 $\doteq\backslash$dashArrow, seta tracejada} \\
438 \multicolumn{2}{l}{\hspace*{4.5em} 2 $\doteq\backslash$dotArrow, seta ponteada} \\
439 \multicolumn{2}{l}{\hspace*{4.5em} 3 $\doteq\backslash$solidline, linha sólida} \\
440 \multicolumn{2}{l}{\hspace*{4.5em} 4 $\doteq\backslash$dashline, linha a tracejado} \\
441 \multicolumn{2}{l}{\hspace*{4.5em} 5 $\doteq\backslash$dotline, linha a ponteado} \\
442 \multicolumn{2}{l}{\hspace*{4.5em} 6 $\doteq\backslash$injectionarrow, seta de
443 injecção. Valor anterior 3 (vers\~ao $<$ 4.2) } \\
444 \multicolumn{2}{l}{\hspace*{4.5em} 7 $\doteq\backslash$aplicationarrow, seta de
445 aplicação. Valor anterior 4 (vers\~ao $<$ 4.2) } \\
446 \multicolumn{2}{l}{\hspace*{4.5em} 8 $\doteq\backslash$surjectivearrow, seta de
447 função sobrejectiva. Valor anterior 5 (vers\~ao $<$ 4.2) }\\
448 \multicolumn{2}{l}{\hspace*{4.5em} 9 $\doteq\backslash$equalline, linha dupla}\\
449 \multicolumn{2}{l}{\hspace*{4.5em} 10
450 $\doteq\backslash$doublearrow, seta dupla}\\
451 \multicolumn{2}{l}{\hspace*{4.5em} 11
452 $\doteq\backslash$doubleopposite, seta dupla em sentidos opostos}\\
453 \multicolumn{2}{l}{\hspace*{4.5em} 12
454 $\doteq\backslash$nullarrow, seta nula, serve o propósito de
455 acrescentar etiquetas as outras ``setas''.}\\
456 \end{longtable}
457
458 \item[{\tt $\backslash$mor(\#1,\#2)(\#3,\#4)[\#5,\#6]\{\#7\}[\#8,\#9]}:]
459 Comando de colocação da seta (morfismo) de ligação de dois objectos
460 -- Segunda variante.
461
462 \begin{longtable}{r@{ -- }p{32em}}
463 {\tt \#1} e {\tt \#2} & coordenadas do nó de partida\\
464 {\tt \#3} e {\tt \#4} & coordenadas do nó de chegada\\
465 \end{longtable}
466
467 Todos os outros argumentos têm o significado já explicado (por
468 isso a numeração errada). É de notar que para a primeira variante é
469 feito o cálculo das coordenadas dos nós de forma automática e depois
470 são passados esses valores para a segunda variante do comando.
471
472
473 \item[{\tt $\backslash$cmor(\#1) \#2(\#3,\#4)\{\#5\}[\#6]}] comando para a
474 especificação de setas curvas. O algoritmo de construção das setas é
475 o do \PiCTeX\ o que implica que se está a especificar uma linha
476 quadrática através de um número ímpar de pontos.
477
478 \begin{tabular}{c@{---}l}
479 {\tt \#1} & lista de pontos, em número ímpar \\
480 {\tt \#2} & direccionamento da seta \\
481 \multicolumn{2}{l}{\qquad 0 $\doteq\backslash$pup, apontar para cima}\\
482 \multicolumn{2}{l}{\qquad 1 $\doteq \backslash$pdown, apontar para
483 baixo}\\
484 \multicolumn{2}{l}{\qquad 2 $\doteq \backslash$pright, apontar para a
485 direita}\\
486 \multicolumn{2}{l}{\qquad 3 $\doteq \backslash$pleft, apontar para a
487 esquerda}\\
488 {\tt \#3} & abcissa do morfismo\\
489 {\tt \#4} & ordenada do morfismo\\
490 {\tt \#5} & morfismo\\
491 {\tt \#6} & tipo de ``seta'', valor por omissão: 0, seta
492 sólida.\\
493 \multicolumn{2}{l}{\hspace*{4.5em} Os restantes valores poss\'\i veis
494 s\~ao os descritos na variante anterior.}\\
495
496 \end{tabular}
497
498 O comando {\tt cmor} no caso em que não tem o último parâmetro opcional
499 tem de ser seguido por um espaço. O espaço antes do direccionamento
500 da seta é obrigatório.
501
502 No caso de se ter o valor 2 (``$\backslash$solidline'') o valor para o
503 direccionamento da seta não é tipo em conta, no entanto dado se
504 tratar de um do parâmetro obrigatório é necessário dar-lhe um valor
505 \end{description}
506
507
508 \section{Alguns Exemplos}
509
510
511 \subsection{Setas Duplas, Transformações Naturais, \ldots}
512
513 É de notar que alguns casos aparentemente omissos na actual versão
514 podem perfeitamente ser construídos através de uma utilização
515 imaginativa dos actuais comandos. Por exemplo os seguintes diagramas:
516
517 $$
518 \begindc{\commdiag}[30]
519 \obj(5,5){$A$}
520 \obj(20,5){$B$}
521 \mor{$A$}{$B$}{$f$}[\atright,\doublearrow]
522 \mor{$A$}{$B$}{$g$}[\atleft,\nullarrow]
523 \enddc
524 \qquad\qquad\qquad
525 \begindc{\commdiag}[140]
526 \obj(5,5){$A$}
527 \obj(9,5){$B$}
528 \mor(5,6)(9,6){$\downarrow\sigma$}[\atright,\solidarrow]
529 \mor{$A$}{$B$}{}
530 \mor(5,4)(9,4){$\downarrow\tau$}
531 \enddc
532 $$
533
534 Podem ser construídos com a actual versão. Eis como:
535
536
537 \begin{lstlisting}
538 \begindc{\commdiag}[30]
539 \obj(5,5){$A$}
540 \obj(20,5){$B$}
541 \mor{$A$}{$B$}{$f$}[\atright,\doublearrow]
542 \mor{$A$}{$B$}{$g$}[\atleft,\nullarrow]
543
544 \begindc{\commdiag}[14]
545 \obj(5,5){$A$}
546 \obj(9,5){$B$}
547 \mor(5,6)(9,6){$\downarrow\sigma$}[\atright,\solidarrow]
548 \mor{$A$}{$B$}{}
549 \mor(5,4)(9,4){$\downarrow\tau$}
550 \enddc
551 \end{lstlisting}
552
553
554 \subsection{Grafos Orientados com Objectos Circunscritos}
555
556
557 $$
558 \begindc{\cdigraph}[250]
559 \obj(1,5){A}
560 \obj(1,4){B}
561 \obj(1,1){C}
562 \obj(5,5){E}
563 \obj(5,3){F}
564 \obj(5,1){G}
565 \mor{A}{E}[80,80]{5}
566 \mor{A}{F}[80,80]{3}
567 \mor{B}{F}[80,80]{6}[\atright,\solidarrow]
568 \mor{B}{E}[80,80]{1}
569 \mor{C}{F}[80,80]{5}
570 \mor{C}{G}[80,80]{7}
571 \enddc
572 $$
573
574 Foi produzido através dos seguintes comandos:
575
576
577 \begin{lstlisting}
578 \begindc{\commdiag}[250]
579 \obj(1,5){A}
580 \obj(1,4){B}
581 \obj(1,1){C}
582 \obj(5,5){E}
583 \obj(5,3){F}
584 \obj(5,1){G}
585 \mor{A}{E}[80,80]{5}
586 \mor{A}{F}[80,80]{3}
587 \mor{B}{F}[80,80]{6}[\atright,\solidarrow]
588 \mor{B}{E}[80,80]{1}
589 \mor{C}{F}[80,80]{5}
590 \mor{C}{G}[80,80]{7}
591 \enddc
592 \end{lstlisting}
593
594 \subsection{Diferentes Tipos de Setas/Linhas}
595
596
597 \begin{lstlisting}
598 \begindc{\commdiag}[250]
599 \obj(10,10)[A]{$OOOOOO$}
600 \obj(15,10)[A0]{$A_0$}
601 \obj(14,11)[A1]{$A_1$}
602 \obj(13,12)[A2]{$A_2$}
603 \obj(12,13)[A3]{$A_3$}
604 \obj(10,14)[A4]{$A_4$}
605 \obj(9,13)[A5]{$A_5$}
606 \obj(8,12)[A6]{$A_6$}
607 \obj(7,11)[A7]{$A_7$}
608 \obj(6,10)[A8]{$A_8$}
609 \obj(7,9)[A9]{$A_9$}
610 \obj(9,8)[A10]{$A_{10}$}
611 \obj(12,8)[A11]{$A_{11}$}
612 \mor{A}{A0}{$a_0$}[\atright,\solidarrow]
613 \mor{A}{A1}{$a_1$}[\atright,\dashArrow]
614 \mor{A}{A2}{$a_2$}[\atright,\dotArrow]
615 \mor{A}{A3}{$a_3$}[\atright,\solidline]
616 \mor{A}{A4}{$a_4$}[\atright,\dashline]
617 \mor{A}{A5}{$a_5$}[\atleft,\dotline]
618 \mor{A}{A6}{$a_6$}[\atleft,\injectionarrow]
619 \mor{A}{A7}{$a_7$}[\atleft,\aplicationarrow]
620 \mor{A}{A8}{$a_8$}[\atleft,\surjectivearrow]
621 \mor{A}{A9}{$a_9$}[\atleft,\equalline]
622 \mor{A}{A10}{$a_{10}$}[\atleft,\doublearrow]
623 \mor{A}{A11}{$a_{11}$}[\atleft,\doubleopposite]
624 \mor{A}{A11}{$a_{12}$}[\atright,\nullarrow]
625 \enddc
626 \end{lstlisting}
627
628 $$
629 \begindc{\commdiag}[250]
630 \obj(10,10)[A]{$OOOOOO$}
631 \obj(15,10)[A0]{$A_0$}
632 \obj(14,11)[A1]{$A_1$}
633 \obj(13,12)[A2]{$A_2$}
634 \obj(12,13)[A3]{$A_3$}
635 \obj(10,14)[A4]{$A_4$}
636 \obj(9,13)[A5]{$A_5$}
637 \obj(8,12)[A6]{$A_6$}
638 \obj(7,11)[A7]{$A_7$}
639 \obj(6,10)[A8]{$A_8$}
640 \obj(7,9)[A9]{$A_9$}
641 \obj(9,8)[A10]{$A_{10}$}
642 \obj(12,8)[A11]{$A_{11}$}
643 \mor{A}{A0}{$a_0$}[\atright,\solidarrow]
644 \mor{A}{A1}{$a_1$}[\atright,\dashArrow]
645 \mor{A}{A2}{$a_2$}[\atright,\dotArrow]
646 \mor{A}{A3}{$a_3$}[\atright,\solidline]
647 \mor{A}{A4}{$a_4$}[\atright,\dashline]
648 \mor{A}{A5}{$a_5$}[\atleft,\dotline]
649 \mor{A}{A6}{$a_6$}[\atleft,\injectionarrow]
650 \mor{A}{A7}{$a_7$}[\atleft,\aplicationarrow]
651 \mor{A}{A8}{$a_8$}[\atleft,\surjectivearrow]
652 \mor{A}{A9}{$a_9$}[\atleft,\equalline]
653 \mor{A}{A10}{$a_{10}$}[\atleft,\doublearrow]
654 \mor{A}{A11}{$a_{11}$}[\atleft,\doubleopposite]
655 \mor{A}{A11}{$a_{12}$}[\atright,\nullarrow]
656 \enddc
657 $$
658
659 \subsection{Diagramas com Setas Curvas}
660
661
662
663 \begin{lstlisting}
664 \begindc{\commdiag}[30]
665 \obj(14,11){$A$}
666 \obj(39,11){$B$}
667 \mor(14,12)(39,12){$f$}
668 \mor(39,10)(14,10){$g$}
669 \cmor((10,10)(6,11)(5,15)(6,19)(10,20)(14,19)(15,15))
670 \pdown(2,20){$id_A$}
671 \cmor((40,7)(41,3)(45,2)(49,3)(50,7)(49,11)(45,12))
672 \pleft(54,3){$id_B$}
673 \enddc
674
675 \begindc{\commdiag}[30]
676 \obj(10,15)[A]{$A$}
677 \obj(40,15)[Aa]{$A$}
678 \obj(25,15)[B]{$B$}
679 \mor{A}{B}{$f$}
680 \mor{B}{Aa}{$g$}
681 \cmor((10,11)(11,7)(15,6)(25,6)(35,6)(39,7)(40,11))
682 \pup(25,3){$id_A$}
683 \enddc
684 \end{lstlisting}
685
686 $$
687 \begindc{\commdiag}[30]
688 \obj(14,11){$A$}
689 \obj(39,11){$B$}
690 \mor(14,12)(39,12){$f$}%[\atright,\solidarrow]
691 \mor(39,10)(14,10){$g$}%[\atright,\solidarrow]
692 \cmor((10,10)(6,11)(5,15)(6,19)(10,20)(14,19)(15,15))
693 \pdown(2,20){$id_A$}
694 \cmor((40,7)(41,3)(45,2)(49,3)(50,7)(49,11)(45,12))
695 \pleft(54,3){$id_B$}
696 \enddc
697 \qquad
698 \begindc{\commdiag}[30]
699 \obj(10,15)[A]{$A$}
700 \obj(40,15)[Aa]{$A$}
701 \obj(25,15)[B]{$B$}
702 \mor{A}{B}{$f$}%[\atright,\solidarrow]
703 \mor{B}{Aa}{$g$}%[\atright,\solidarrow]
704 \cmor((10,11)(11,7)(15,6)(25,6)(35,6)(39,7)(40,11))
705 \pup(25,3){$id_A$}
706 \enddc
707 $$
708
709 \subsection{Um Exemplo Complexo}
710
711 O diagrama seguinte foi proposto por Feruglio~\cite{Feruglio94} como
712 um caso de teste. Como \'e poss\'\i vel ver o DCpic produz o diagrama
713 correctamente a partir de uma especifica\c c\~ao simples.
714
715
716 \begin{lstlisting}
717 \newcommand{\barraA}{\vrule height2em width0em depth0em}
718 \newcommand{\barraB}{\vrule height1.6em width0em depth0em}
719 \begindc{\commdiag}[350]
720 \obj(1,1)[Gr]{$G$}
721 \obj(3,1)[Grstar]{$G_{r^*}$}
722 \obj(5,1)[H]{$H$}
723 \obj(2,2)[SigmaG]{$\Sigma^G$}
724 \obj(6,2)[SigmaH]{$\Sigma^H$}
725 \obj(1,3)[Lm]{$L_m$}
726 \obj(3,3)[Krm]{$K_{r,m}$}
727 \obj(5,3)[Rmstar]{$R_{m^*}$}
728 \obj(1,5)[L]{$L$}
729 \obj(3,5)[Lr]{$L_r$}
730 \obj(5,5)[R]{$R$}
731 \obj(2,6)[SigmaL]{$\Sigma^L$}
732 \obj(6,6)[SigmaR]{$\Sigma^R$}
733 \mor{Gr}{SigmaG}{$\lambda^G$}
734 \mor{Grstar}{Gr}{$i_5$}[\atleft,\aplicationarrow]
735 \mor{Grstar}{H}{$r^*$}[\atright,\solidarrow]
736 \mor{H}{SigmaH}{$\lambda^H$}[\atright,\dashArrow]
737 \mor{SigmaG}{SigmaH}{$\varphi^{r^*}$}[\atleft,\solidarrow]
738 \mor{Lm}{Gr}{$m$}[\atright,\solidarrow]
739 \mor{Lm}{L}{$i_2$}[\atleft,\aplicationarrow]
740 \mor{Krm}{Lm}{$i_3\quad$}[\atright,\aplicationarrow]
741 \mor{Krm}{Rmstar}{$r$}
742 \mor{Krm}{Lr}{$i_4$}[\atright,\aplicationarrow]
743 \mor{Krm}{Grstar}{\barraA$m$}
744 \mor{Rmstar}{R}{$i_6$}[\atright,\aplicationarrow]
745 \mor{Rmstar}{H}{\barraB$m^*$}
746 \mor{L}{SigmaL}{$\lambda^L$}
747 \mor{Lr}{L}{$i_1\quad$}[\atright,\aplicationarrow]
748 \mor{Lr}{R}{$r$}
749 \mor{R}{SigmaR}{$\lambda^R$}[\atright,\solidarrow]
750 \mor{SigmaL}{SigmaG}{$\varphi^m$}[\atright,\solidarrow]
751 \mor{SigmaL}{SigmaR}{$\varphi^r$}
752 \mor{SigmaR}{SigmaH}{$\varphi^{m^*}$}
753 \enddc
754 \end{lstlisting}
755
756 \newcommand{\barraA}{\vrule height2em width0em depth0em}
757 \newcommand{\barraB}{\vrule height1.6em width0em depth0em}
758 $$\begindc{\commdiag}[350]
759 \obj(1,1)[Gr]{$G$}
760 \obj(3,1)[Grstar]{$G_{r^*}$}
761 \obj(5,1)[H]{$H$}
762 \obj(2,2)[SigmaG]{$\Sigma^G$}
763 \obj(6,2)[SigmaH]{$\Sigma^H$}
764 \obj(1,3)[Lm]{$L_m$}
765 \obj(3,3)[Krm]{$K_{r,m}$}
766 \obj(5,3)[Rmstar]{$R_{m^*}$}
767 \obj(1,5)[L]{$L$}
768 \obj(3,5)[Lr]{$L_r$}
769 \obj(5,5)[R]{$R$}
770 \obj(2,6)[SigmaL]{$\Sigma^L$}
771 \obj(6,6)[SigmaR]{$\Sigma^R$}
772 \mor{Gr}{SigmaG}{$\lambda^G$}
773 \mor{Grstar}{Gr}{$i_5$}[\atleft,\aplicationarrow]
774 \mor{Grstar}{H}{$r^*$}[\atright,\solidarrow]
775 \mor{H}{SigmaH}{$\lambda^H$}[\atright,\dashArrow]
776 \mor{SigmaG}{SigmaH}{$\varphi^{r^*}$}[\atleft,\solidarrow]
777 \mor{Lm}{Gr}{$m$}[\atright,\solidarrow]
778 \mor{Lm}{L}{$i_2$}[\atleft,\aplicationarrow]
779 \mor{Krm}{Lm}{$i_3\quad$}[\atright,\aplicationarrow]
780 \mor{Krm}{Rmstar}{$r$}
781 \mor{Krm}{Lr}{$i_4$}[\atright,\aplicationarrow]
782 \mor{Krm}{Grstar}{\barraA$m$}
783 \mor{Rmstar}{R}{$i_6$}[\atright,\aplicationarrow]
784 \mor{Rmstar}{H}{\barraB$m^*$}
785 \mor{L}{SigmaL}{$\lambda^L$}
786 \mor{Lr}{L}{$i_1\quad$}[\atright,\aplicationarrow]
787 \mor{Lr}{R}{$r$}
788 \mor{R}{SigmaR}{$\lambda^R$}[\atright,\solidarrow]
789 \mor{SigmaL}{SigmaG}{$\varphi^m$}[\atright,\solidarrow]
790 \mor{SigmaL}{SigmaR}{$\varphi^r$}
791 \mor{SigmaR}{SigmaH}{$\varphi^{m^*}$}
792 \enddc
793 $$
794
795
796 %\bibliographystyle{plain}
797 %\bibliography{pedro}
798
799 \newcommand{\noopsort}[1]{} \newcommand{\singleletter}[1]{#1}
800 \begin{thebibliography}{1}
801
802 \bibitem{Feruglio94}
803 {Gabriel Valiente} Feruglio.
804 \newblock Typesetting commutative diagrams.
805 \newblock {\em TUGboat}, 15(4):466--484, 1994.
806
807 \bibitem{Harary72}
808 Frank Harary.
809 \newblock {\em Graph Theory}.
810 \newblock Addison-Wesley, Reading, Massachusetts, 1972.
811
812 \bibitem{Herrlich73}
813 Horst Herrlich and George Strecker.
814 \newblock {\em Category Theory}.
815 \newblock Allyn and Bacon Inc., 1973.
816
817 \bibitem{Knuth86}
818 Donald~E. Knuth.
819 \newblock {\em The {\TeX}book}.
820 \newblock Addison-Wesley Publishing Company, Reading, Massachusetts, 1986.
821
822 \bibitem{Lamport94}
823 Leslie Lamport.
824 \newblock {\em {\LaTeX}: A Document Preparation System}.
825 \newblock Addison-Wesley Publishing Company, Reading,Massachusetts, 2nd
826 edition, 1994.
827
828 \bibitem{Pierce98}
829 Benjamin Pierce.
830 \newblock {\em Basic Category Theory for Computer Scientists}.
831 \newblock Foundations of Computing. The MIT Press, London, England, 1998.
832
833 \end{thebibliography}
834
835 \appendix
836 \section{O Código}
837
838 {\scriptsize
839 \verbatiminput{dcpic.sty}}
840
841 \end{document}
842
843 %%% Local Variables:
844 %%% mode: latex
845 %%% TeX-master: t
846 %%% End: