VOEventLib
==========
Roy Williams and Dave Kuhlmann
version 1.1, 2011 March 3

VOEventLib is a reference implementation and parser for the VOEvent2 XML specification, now under discussion at the IVOA. VOEventLib uses code binding technology to build a parser from a documented XML schema. There is also a utility package, documentation, example code, and example events.

--------------------

First the parser itself (inner package). Use this command to get the software:
    svn checkout https://ligo-vcs.phys.uwm.edu/svn/VOEventLib/lib
and you will have:

    VOEventLib
    |-- README
    |-- VOEvent.py … autogenerated parser code for VOEvent object
    |-- Vutil.py … 
    |-- doc
    |   |-- index.html … documentation for all the methods of the parser
    |   |-- VOEvent-20110215.html … draft document for the VOEvent2 specification
    |-- events
    |   |-- CRTSsample.xml
    |   |-- LIGO-LOFAR.xml … contains Table element from VOEvent2
    |   |-- SD29A8A.xml ... sample NEO report from the Catalina Sky Survey
    |   |-- SWIFT.xml ... sample event from the SWIFT satellite
    |   |-- SWIFTCircular.xml ... writing about a SWIFT notice
    |   |-- event4.xml … contains Table element from VOEvent2
    |   |-- sample.xml ... as generated by the buildVOEvent code in the examples
    |-- examples
    |   |-- buildVOEvent.py ... build a VOEvent from scratch
    |   |-- format_to_html.py ... represent a VOEvent in the browser
    |   |-- modify.py ... modify an existing VOEvent
    |   |-- simpleevent.py .. create a very simple VOEvent
    |   |-- tables.py ... print out the tables in a VOEvent


Read the README, which tells you to put the lib directory in your PYTHONPATH then try out one of the example programs, then modify it to your pleasure.
