Skip to main content

Geometry and visualization tools for collections of particles

Project description

PyPI ReadTheDocs CircleCI Binder

Introduction

Plato is designed for efficient visualization of particle data: collections of particles that may be colored or oriented differently. It fills a similar role as matplotlib, but is less focused on 2D plotting. It supports a variety of backends with different capabilities and use cases, ranging from interactive visualization in the desktop or jupyter notebooks to high-quality, static raytraced and vector images for publication.

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 supports 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. We also keep some advice here regarding particular known-good versions of dependencies for pip and conda.

Documentation

The documentation is available as standard sphinx documentation:

$ cd doc
$ pip install -r requirements.txt
$ 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, available as live examples on mybinder.org. Somewhat less transparent examples can be found in the plato-gallery repository.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for plato-draw, version 1.11.0
Filename, size File type Python version Upload date Hashes
Filename, size plato_draw-1.11.0-py3-none-any.whl (126.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size plato-draw-1.11.0.tar.gz (95.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page