Metadata-Version: 2.1
Name: plato-draw
Version: 1.10.0
Summary: Geometry and visualization tools for collections of particles
Home-page: UNKNOWN
Author: Matthew Spellings
Author-email: mspells@umich.edu
License: BSD-3-Clause
Project-URL: Documentation, http://plato-draw.readthedocs.io/
Project-URL: Source, https://github.com/glotzerlab/plato
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3
Requires-Dist: numpy
Requires-Dist: scipy
Requires-Dist: rowan
Provides-Extra: pyside
Requires-Dist: pyside ; extra == 'pyside'
Requires-Dist: vispy (>=0.5.3) ; extra == 'pyside'
Provides-Extra: pyside2
Requires-Dist: pyside2 ; extra == 'pyside2'
Requires-Dist: vispy (>=0.6) ; extra == 'pyside2'
Provides-Extra: pythreejs
Requires-Dist: pythreejs ; extra == 'pythreejs'

=================================
Welcome to plato's documentation!
=================================

Plato is designed for efficient visualization of particle data. Think
of it sort of like matplotlib, but being less focused on 2D plotting.

Installation
============

Plato is available on PyPI for installation via pip::

  $ pip install plato-draw

You can also install plato from source, like this::

   $ git clone https://github.com/glotzerlab/plato.git
   $ # now install
   $ cd plato && python setup.py install

.. note::

   Depending on which backends you want to use, there may be
   additional steps required; see the section on interactive backends
   below.

Using Interactive Backends
--------------------------

Plato contains a number of backends, each with its own set of
dependencies. Getting the vispy backend working for both the desktop
and jupyter notebook can be tricky. Make sure to check the official
`vispy documentation <http://vispy.org/installation.html>`_. We also
keep some advice `here
<https://bitbucket.org/snippets/glotzer/nMg8Gr/plato-dependency-installation-tips>`_
regarding particular known-good versions of dependencies for pip and
conda.

Documentation
=============

The documentation is available as standard sphinx documentation::

  $ cd doc
  $ make html

Automatically-built documentation is available at
https://plato-draw.readthedocs.io .

Examples
========

Several usage examples are available. Many simple, but less
interesting, scenes can be found in `the test demo scene script
<https://github.com/glotzerlab/plato/blob/master/test/test_scenes.py>`_,
available as `live examples on mybinder.org
<https://mybinder.org/v2/gh/glotzerlab/plato/master?filepath=examples>`_. Somewhat
less transparent examples can be found in `the plato-gallery
repository <https://github.com/glotzerlab/plato-gallery>`_.



