Main repository for Vispy
Python GLSL C Other
Latest commit c862d86 Nov 23, 2016 @ktritz ktritz committed with Eric89GXL fix face/vertex colors (#1254)
* fix face/vertex colors

using vispy.plot mesh: vertex and face colors are now applied to mesh.
shading can be specified instead of always 'smooth'.

* Updated docstring

* fix docstring

fix docstring

* trigger Travis rebuild

* Trigger Travis rebuild

* Change shading keyword to 'auto'

Shading will be set to 'smooth' unless face_colors is set, in which case
shading will be set to None.

* Various fixes

Changed default shading to auto (smooth unless face_colors is set)


VisPy: interactive scientific visualization in Python

Main website:

Build Status Appveyor Status Coverage Status Zenodo Link

VisPy is a high-performance interactive 2D/3D data visualization library. VisPy leverages the computational power of modern Graphics Processing Units (GPUs) through the OpenGL library to display very large datasets. Applications of VisPy include:

  • High-quality interactive scientific plots with millions of points.
  • Direct visualization of real-time data.
  • Fast interactive visualization of 3D models (meshes, volume rendering).
  • OpenGL visualization demos.
  • Scientific GUIs with fast, scalable visualization widgets (Qt or IPython notebook with WebGL).


Using VisPy

VisPy is a young library under heavy development at this time. It targets two categories of users:

  1. Users knowing OpenGL, or willing to learn OpenGL, who want to create beautiful and fast interactive 2D/3D visualizations in Python as easily as possible.
  2. Scientists without any knowledge of OpenGL, who are seeking a high-level, high-performance plotting toolkit.

If you're in the first category, you can already start using VisPy. VisPy offers a Pythonic, NumPy-aware, user-friendly interface for OpenGL ES 2.0 called gloo. You can focus on writing your GLSL code instead of dealing with the complicated OpenGL API - VisPy takes care of that automatically for you.

If you're in the second category, we're starting to build experimental high-level plotting interfaces. Notably, VisPy now ships a very basic and experimental OpenGL backend for matplotlib.


VisPy runs on Python 2.6+ and Python 3.3+ and depends on NumPy. You also need a backend (PyQt4/PySide, glfw, pyglet, SDL, or wx).

As VisPy is under heavy development at this time, we highly recommend you to use the development version on Github (master branch). You need to clone the repository and install VisPy with python install.

As a one-liner, assuming git is installed

git clone && cd vispy && python install --user

This will automatically install the latest version of vispy.

If you need to install Python for the first time, consider using the Anaconda Python distribution. It provides a convenient package management system.

Structure of VisPy

Currently, the main subpackages are:

  • app: integrates an event system and offers a unified interface on top of many window backends (Qt4, wx, glfw, IPython notebook with/without WebGL, and others). Relatively stable API.
  • gloo: a Pythonic, object-oriented interface to OpenGL. Relatively stable API.
  • mpl_plot: an OpenGL backend for matplotlib. Experimental.
  • scene: this is the system underlying our upcoming high level visualization interfaces. Under heavy development and still experimental, it contains several modules.
    • Visuals are graphical abstractions representing 2D shapes, 3D meshes, text, etc.
    • Transforms implement 2D/3D transformations implemented on both CPU and GPU.
    • Shaders implements a shader composition system for plumbing together snippets of GLSL code.
    • The scene graph tracks all objects within a transformation graph.
  • plot: high-level plotting interfaces.

The API of all public interfaces are subject to change in the future, although app and gloo are relatively stable at this point.


VisPy began when four developers with their own visualization libraries decided to team up:

Now VisPy looks to build on the expertise of these developers and the broader open-source community to build a high-performance OpenGL library.

External links