README

SNO+ Dispatcher
===============

Installation
------------

To install the dispatcher library::

    $ git clone git@github.com:snoplus/disp.git
    $ cd disp
    $ make
    $ source env.sh

Running the Dispatcher
----------------------

To run the dispatcher, simply run::

    $ dispatch

To run the dispatcher as a daemon::

    $ nohup dispatch &>[path/to/logfile] &

Reading from the Dispatcher
---------------------------

You can read events from the dispatch stream
using the python module dispatch::

    >>> from dispatch import *
    >>> d = Dispatch('localhost')
    >>> record = d.recv()
    >>> id, record = unpack_header(record)
    >>> id == RECORD_IDS['PMT_RECORD']
    True
    >>> pmt_record_gen = unpack_pmt_record(record)
    >>> pmt_event_record = next(pmt_record_gen)
    >>> pmt_event_record.NPmtHit
    20
    >>> for uncal_pmt in pmt_record_gen:
    ...     print uncal_pmt.BoardID
    ... 
    11
    3