dash-docs/img/dev

## Files Ending In .dot, .neato, .circo

Many of the images are generated using dot from the graphviz package.  For
assistance with these files, feel free to contact dave@dtrt.org.

The following examples generate a .png or .svg file from a .dot file:

dot -T svg file.dot -o file.svg
dot -T png file.dot -o file.png

You can change a .circo or .neato file into a .png or .svg using
corresponding commands:

circo -T svg file.circo -o file.svg
neato -T png file.neato -o file.png

Notice: Graphviz can be inconsistent across versions. 
Up until commit ab415e8b6 (2014-12-17), all of the SVG and
PNG images here were generated using graphviz version 2.26.3
(20100126.1600) on Debian 7 using the following shell loop:

    fn="fontname=Sans"
    for f in *dot
    do 
        dot -N$fn -G$fn -E$fn -o ${f/.dot}.svg -T svg $f
        dot -N$fn -G$fn -E$fn -o ${f/.dot}.png -T png $f
        optipng -o7 ${f/.dot}.png
    done

Images created after commit ab415e8b6 used Debian Graphviz version
2.38.0-7.  This higher version is required to support the HTML bold and
italics tags used in some newer images, and we may come to use some of
its other extra features such as the sides="" parameter.

For improved compatability between Graphviz versions, files created or
updated after 6 May 2014 are recommend to include the following code
near the top of the file:

    edge [ fontname="Sans" ]
    node [ fontname="Sans" ]
    graph [ fontname="Sans" ]

Also, splines=ortho should not be used in new or updated files until
Graphviz fixes its post-2.26.3 ortho code.


## Files Ending In .gnuplot

Some images are generated using gnuplot.  As of this writing, you can
generate both the SVG and PNG output for any of these files by running
the following command:

    gnuplot <filename.gnuplot>

After generating, you should use optipng to reduce the PNG filesize.
(Reductions here tend to be small, ~10%):

    optipng -o7 <filename.png>

If your plot has a high sample rate, you can reduce the SVG filesize by
opening it in Inkscape, ungrouping the graphic, selecting plot lines,
and using Path->Simplify.  Then select all, regroup, and save.  Be sure
to double-check your work---if you simplify text, it becomes unreadable.
(Reductions here tend to be large, I've seen ~80%.)