-pic
Xy-pic - Typesetting graphs and diagrams in
TeX
The latest Xy-pic release 3.7 is available at the
locations listed below.
Xy-pic is a package for typesetting graphs and diagrams using the
principle of `logical composition of visual components'. It is
structured as several modules, each defining a mnemonic plain text
notation for a particular kind of graphical object or structure.
Example objects are arrows, curves, frames, and colouring/rotation on
drivers that support it; these can be organised in matrix, directed
graph, path, polygon, knot, and 2-cell structure (a more complete list
of the features is given below).
Xy-pic works with most formats, including all variants of LaTeX,
AMS-TeX,
and plain
TeX, and has been used to typeset complicated diagrams from many
application areas including category theory, automata theory, algebra,
neural networks, and database theory.
Xy-pic is supported through a mailing list.
Contents: availability,
features,
papers,
samples.
You can get Xy-pic from its home courtesy of TUG.
(Of course you can also search for it on the Web with an
Alta Vista query
or on FTP with an
Archie FTP search; finally Alta Vista also permits locating all web pages that refer to this page.)
Xy-pic was conceived by
Kristoffer Høgsbro Rose,
the present version is the result of several years of collaboration with
Ross Moore.
Xy-pic is © by its authors as free software (see the
GNU
General Public License for details).
(excerpt from
README
file)
Xy-pic is structured as a `kernel' and several orthogonal modules called
`options', each defining a custom notation for a particular kind of
graphical object or structure.
These (combinable) `logical composition' structures are available:
- A graph combinator mode where diagrams are specified the way they are
composed as graphs.
- A matrix-like mode where the dimensions of the drawing are computed by
aligning diagram entries in rows and columns (this is the `diagram'
mode Xy-pic version 2 users are used to).
- A polygon mode where diagrams shaped as regular polygons are entered
in a simple way.
- A mode for typesetting beautiful knots and links.
- A general object-oriented `turtle graphic' drawing language for
specifying graphs with objects and connections between them in a
manner independent of orientation.
The following `visual component' objects can be used:
- Positions can be given in variety of formats (extendable) including
user defined coordinates (x,y) and relative to previous positions,
objects, object edges, and points on connections.
- Objects may be circular, elliptic, or rectangular (more shapes can be
added) and adjusted in several ways.
- Large library of objects with mnemonic names.
- Objects that orient themself along a connection when placed relative
to it, e.g., `
@{|-}' is like `\vdash'
but thus oriented; new such objects can be defined in a convenient way.
- TeX `boxes', i.e., text and mathematical formulae.
- Includes circle segments and optionally arbitrary elliptical,
quadratic, and cubic arcs.
- Connections are aligned between the reference points of objects but
start and end on the edges.
- Any object can be used to build a connection (using `diagonal
filling'); library objects provide common line types.
- Flexible notation for drawing arrows and general paths with tail,
stem, and head built from any object(s). Special support for arrows
that cross each other, arrows that `go by' other entries, paired
arrows (including support for 2-cells), curved arrows, and arrows with
bends.
- Library of frames and braces.
- Special notation for rotation, scaling, colour, and line thickness.
The correct typesetting of these features requires a backend that
supports it (i.e., PostScript¹) but even when this is not available
Xy-pic tries to approximate what is requested such that at least the
picture size is stable (and thus page breaks).
- Output can use PostScript¹ for drawing (several \special formats are
supported: dvips, Textures, and OzTeX - more are being added
continuously: contact Ross Moore for the current
list). Notation for inclusion of literal PostScript¹ is available.
Clicking on a title will show the proper reference; other forms
available as indicated.
- New! A Lauda: Xy-pic Tutorial: Strings, Cobordisms, Braids and Lots More.
Available as html.
-
This is a tutorial that explains by example how to construct diagrams using XY-pic.
Explains some beautiful yet complicated categorical and algebraic diagrams.
- K H Rose: Xy-pic User's Guide
Latest edition available as
dvi,
ps, and
ps.gz.
- Explains how to use the Xy-pic macro package to typeset
`matrix-like' diagrams with TeX.
- K H Rose & R Moore: Xy-pic Reference Manual
Latest edition available as
dvi,
ps, and
ps.gz.
- Reference manual for Xy-pic summarising syntax and `drawing
semantics' of the capabilities in the kernel, all extensions and
features, and the PostScript¹ backend.
- M Goossens,
S Rahtz,
and F Mittelbach:
The LaTeX Graphics Companion
Addison-Wesley, 1997.
- Chapter 5 gives a concise introduction to some advanced uses of Xy-pic.
- K H Rose: ``Very High Level 2-dimensional Graphics'' with TeX and Xy-pic
Invited for TUG '97.
Latest edition available as
ps and
ps.gz.
- Shows how a custom embedded language for drawing directory trees
is implemented with Xy-pic; this make it possible to get nice pictures
and diagrams in paper aesthetically integrated with the text, ensuring
that the information in the pictures can be exploited in alternate
ways. As an example of the latter we show how the picture can be used
to create this animation.
- K H Rose: Xy-pic and Notation for Categorical Diagrams
- Discusses textual notation for categorical diagrams based on the
authors experience from developing Xy-pic. In particular the notion
of `conceptual markup' for diagrams is introduced, and the `graph'
mode implementing it in Xy-pic is explained.
This was presented as an invited
talk at ECCT-94, the European Colloquium on Category
Theory.
- R Moore: Typesetting Neural Nets using Xy-pic (as
ps and
ps.gz).
- This note gives an example of how to use Xy-pic's ``Graph
Combinator'' feature to specify the type of diagram that is
frequently used to display Neural Networks.
- K H Rose: How
to Typeset Pretty Diagram Arrows with TeX
- Explains the design decisions used in the design of the arrows
used by the macro package Xy-pic for typesetting graphs and
diagrams with TeX.
- K H Rose: Typesetting
Diagrams with Xy-pic: User's Manual
- First published introduction to Xy-pic (for version 2.6; obsolete).
- R Street:
Quantum Groups: an entrée to modern algebra
- Several chapters of a book which uses diagrams in an essential way.
- R Moore: Polynomial Invariants for Knots (as
tex,
ps and
ps.gz)
- This note is an example of the use of the Xy-pic `knots and links'
feature.
- K H Rose:
Fundamental Reduction Systems, Examination (as
tex,
ps and
ps.gz)
- This illustrates how the graph mode was used to draw electronic
circuits in an exam paper.
- R Moore:
Endomorphism Rings (1st:
tex,
ps and
ps.gz,
2nd:
tex,
ps and
ps.gz,
3rd:
tex,
ps and
ps.gz,
4th:
tex,
ps and
ps.gz)
- Matrices and graphs for studying endomorphism rings, devised by
George Ivanov.
¹ PostScript is a trademark of Adobe, Inc.
Kristoffer Høgsbro Rose
<krisrose@tug.org>.
Last modified: Mon Jun 3 12:00:00 EDT 2002
Hits by
:
.
This page awarded
.
And we're
SAL!