Graph-ReadWrite
                              2.00

This is a collection of perl classes for reading and writing directed graphs in a variety of file formats. The graphs are represented in Perl using Jarkko Hietaniemi's Graph classes. Version 2.0 of this distribution works with version 0.5 and later of the Graph distribution.

There are two base classes:

        Graph::Reader
        Base class for classes which read a graph
        file and create an instance of the Graph class.

        Graph::Writer
        Base class for classes which take an instance of the
        Graph class and write it out in a specific file format.

This distribution also defines a simple XML format for storing directed graphs, defined to meet the needs of the Graph class. A reader and writer are provided for this:

        Graph::Reader::XML
        Graph::Writer::XML

Writers are also included for Dot, VCG, and daVinci, two packages for displaying / rendering graphs. Dot and VCG are freely available; daVinci is freely available at the moment, but that is going to change soon.

        Graph::Writer::Dot
        Graph::Writer::VCG
        Graph::Writer::daVinci

A reader for Dot files has been contributed by Mark Hillebrand:

Graph::Reader::Dot

A reader and writer for HTK lattices are also included:

        Graph::Reader::HTK
        Graph::Writer::HTK

These last two will probably only be of interest to people working with HTK, or tools which use the same format.

Dependencies

Graph Jarkko's Graph classes XML::Parser used by Graph::Reader::XML XML::Writer used by Graph::Writer::XML IO::File

To install these modules, you should just have to run the following:

        % perl Makefile.PL
        % make
        % make test
        % make install

This distribution contains an early version of a test-suite; you may get a warning about an undefined value from one of the tests.

Bugs, suggestions, and new readers and writers will be gratefully received.

Neil Bowers <neil@bowers.com>
$Id: README,v 1.2 2005/01/02 19:00:08 neilb Exp $