Metadata-Version: 2.0
Name: live-serial
Version: 0.0.2
Summary: Real-time serial port plotter/logger.
Home-page: https://github.com/rosenbrockc/live-serial
Author: Conrad W Rosenbrock
Author-email: rosenbrockc@gmail.com
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Requires-Dist: argparse
Requires-Dist: matplotlib
Requires-Dist: numpy
Requires-Dist: pyserial
Requires-Dist: pytest
Requires-Dist: python-coveralls
Requires-Dist: termcolor

|Build Status| |Coverage Status| |PyPI|

``live-serial``: real-time serial port plotter/logger
=====================================================

``live-serial`` is a simple package that ties ``pyserial``,
``matplotlib`` and ``csv`` together to create a real-time plotter and
logger of serial port data. This is intended to make life easier for
people who work with sensors who need to see real-time feedback when
they interact with the sensors.

Quickstart
----------

::

    pip install live-serial
    cd live-serial
    tox

This will install live-serial and run all the unit tests to make sure
that your local setup is working correctly.

Start Monitoring
----------------

The package includes a script ``livemon.py`` that starts the plotting
and logging. Although the script is documented internally, the most
common use cases are:

::

    livemon.py COM3 -logdir C:\sensordata\

on a Windows machine, and:

::

    livemon.py /dev/ttyACM0 -logdir ~/sensordata

for linux or MacOS. To see a full list of examples and command-line
arguments, type ``livemon.py -examples``.

API Documentation
-----------------

Full API documentation is hosted at `github
pages <https://rosenbrockc.github.io/liveserial/>`__.

.. |Build Status| image:: https://travis-ci.org/rosenbrockc/live-serial.svg?branch=master
   :target: https://travis-ci.org/rosenbrockc/live-serial
.. |Coverage Status| image:: https://coveralls.io/repos/github/rosenbrockc/live-serial/badge.svg?branch=master
   :target: https://coveralls.io/github/rosenbrockc/live-serial?branch=master
.. |PyPI| image:: https://img.shields.io/pypi/v/live-serial.svg
   :target: https://pypi.python.org/pypi/live-serial/


