eqn2graph

eqn2graph [ -format name ] [ -density num ]

-format name
    Specifies the output format. 'pic' is the default and most common, generating commands for the pic preprocessor. 'plot' is another supported format.

-density num
    Sets the density for bitmap output. A higher number increases resolution but also file size. The default value is 100.

eqn2graph is a utility within the groff typesetting system that plays a crucial role in rendering mathematical equations. It takes the output generated by eqn, the equation preprocessor for troff/groff, and transforms it into graphical commands. Specifically, it converts the textual representation of equations produced by eqn into pic (picture) commands by default, or optionally into plot commands. These graphical commands can then be embedded into groff documents, allowing groff to render complex mathematical expressions as scalable vector graphics. This enables seamless integration of equations within technical documentation and publications, ensuring high-quality output regardless of the output device or resolution. eqn2graph typically reads from standard input and writes to standard output, making it suitable for pipe-based workflows.

eqn2graph is primarily designed to work as part of the groff ecosystem, specifically with eqn input and pic/plot output for groff. It does not directly convert LaTeX equations or other equation formats. Its output is generally not intended for standalone image files (like PNG or SVG) but rather for embedding within groff documents processed by groff -G. Using it outside this intended workflow might require additional processing steps.

Typically, eqn2graph is used in a pipeline where eqn processes equations and pipes its output to eqn2graph, which then pipes its output to groff. For example:
echo '.EQ\na+b=c\n.EN' | eqn | eqn2graph | groff -G -pic
This command chain would process a simple equation and render it graphically.

The '-G' option for groff is specifically designed to work with eqn2graph's output. When groff -G encounters pic commands generated by eqn2graph, it understands how to embed and render these graphical representations of equations directly into the document.

eqn2graph is a component of the GNU groff (GNU troff) project, which provides a free software implementation of the troff text formatting system. Its development is tied to the evolution of groff as a comprehensive typesetting suite capable of handling complex documents, including those with mathematical equations. It facilitates the graphical rendering of eqn output, a capability crucial for high-quality scientific and technical document preparation within the groff framework.

eqn(1), groff(1), pic(1), troff(1)