fastplotlib · kushalkolar · Jan 26, 2025 · Jan 23, 2025 · Jan 23, 2025 · Jan 23, 2025
@@ -15,11 +15,28 @@
 [**Examples**](https://github.com/kushalkolar/fastplotlib#examples) | 
 [**Contributing**](https://github.com/kushalkolar/fastplotlib#heart-contributing)

-Next-gen plotting library built using the [`pygfx`](https://github.com/pygfx/pygfx) rendering engine that can utilize [Vulkan](https://en.wikipedia.org/wiki/Vulkan), [DX12](https://en.wikipedia.org/wiki/DirectX#DirectX_12), or [Metal](https://developer.apple.com/metal/) via WGPU, so it is very fast! `fastplotlib` is an expressive plotting library that enables rapid prototyping for large scale exploratory scientific visualization.
+Next-gen plotting library built using the [`pygfx`](https://github.com/pygfx/pygfx) rendering engine that utilizes [Vulkan](https://en.wikipedia.org/wiki/Vulkan), [DX12](https://en.wikipedia.org/wiki/DirectX#DirectX_12), or [Metal](https://developer.apple.com/metal/) via WGPU, so it is very fast! `fastplotlib` is an expressive plotting library that enables rapid prototyping for large scale exploratory scientific visualization.

-> **Note**
-> 
-> `fastplotlib` is currently in the **late alpha stage**, but you're welcome to use it or contribute! See our [Roadmap](https://github.com/kushalkolar/fastplotlib/issues/55). See this for a discussion on API stability: https://github.com/fastplotlib/fastplotlib/issues/121
+<div align="center">
+  <img src=https://github.com/user-attachments/assets/5c6bede6-e0cb-4867-bb9b-f86cc5e98619 width="1000" /> 
+</div>
+
+> **Note:**
+> `fastplotlib` is currently in the **late alpha stage**, but you're welcome to use it or contribute! See our [Roadmap](https://github.com/kushalkolar/fastplotlib/issues/55). Also, see this for a discussion on API stability: https://github.com/fastplotlib/fastplotlib/issues/121
+
+# What are *some* things I can do with `fastplotlib`?
+
+- GPU-accelerated visualization
+
+- interactive visualization via an intuitive and expressive API
+
+- rapid prototyping and algorithm design
+
+- easy exploration and fast rendering of large-scale data
+
+- design, develop, evaluate, and ship machine learning models
+
+- create visualizations for real-time acquisition systems for scientific instruments (cameras, etc.)

 # Supported frameworks

@@ -30,11 +47,7 @@ Next-gen plotting library built using the [`pygfx`](https://github.com/pygfx/pyg
 :heavy_check_mark: `glfw`\
 :heavy_check_mark: `wxPython`

-**Notes:**\
-:heavy_check_mark: Non-blocking interactive Qt/PySide output is supported in ipython and notebooks, see the [interactive shells section in the user guide](http://fastplotlib.org/ver/dev/user_guide/guide.html#using-fastplotlib-in-an-interactive-shell) \
-:grey_exclamation: We do not officially support `jupyter notebook` through `jupyter_rfb`, this may change with notebook v7\
-:grey_exclamation: We only support jupyterlab for use in notebooks. This means that we do not support VSCode notebooks or any other python notebook platform. Jupyterlab is the most reliable way to use widget-based libraries in notebooks.\
-:disappointed: [`jupyter_rfb`](https://github.com/vispy/jupyter_rfb) does not work in collab, see https://github.com/vispy/jupyter_rfb/pull/77 
+Write your code once and run it anywhere. Whether you are using `Qt`, `glfw`, `jupyter lab`, or doing offscreen rendering, `fastplotlib` works across all major platforms (Linux, Windows, Mac OS X) :smile: See the [FAQ](https://www.fastplotlib.org/ver/dev/user_guide/faq.html) for more details on where and how you can use `fastplotlib`.

 # Documentation

@@ -63,7 +76,7 @@ pip install -U "fastplotlib[notebook]"
 We strongly recommend installing ``simplejpeg`` for use in notebooks, you must first install [libjpeg-turbo](https://libjpeg-turbo.org/)

 - If you use ``conda``, you can get ``libjpeg-turbo`` through conda.
- If you are on linux you can get it through your distro's package manager.
+- If you are on linux, you can get it through your distro's package manager.
 - For Windows and Mac compiled binaries are available on their release page: https://github.com/libjpeg-turbo/libjpeg-turbo/releases

 Once you have ``libjpeg-turbo``:
@@ -72,8 +85,7 @@ Once you have ``libjpeg-turbo``:
 pip install simplejpeg
 ```

-> **Note**
->
+> **Note:**
 > `fastplotlib` and `pygfx` are fast evolving projects, the version available through pip might be outdated, you will need to follow the "For developers" instructions below if you want the latest features. You can find the release history here: https://github.com/fastplotlib/fastplotlib/releases

 ### For developers
@@ -85,7 +97,7 @@ git clone https://github.com/fastplotlib/fastplotlib.git
 cd fastplotlib

 # install all extras in place
-pip install -e ".[notebook,docs,tests]"
+pip install -e ".[notebook,docs,tests,imgui]"

 # install latest pygfx
 pip install git+https://github.com/pygfx/pygfx.git@main
@@ -105,16 +117,28 @@ User guide: http://fastplotlib.org/ver/dev/user_guide/guide.html

 The `quickstart.ipynb` tutorial notebook is a great way to get familiar with the API: https://github.com/fastplotlib/fastplotlib/tree/main/examples/notebooks/quickstart.ipynb

-## GPU drivers and requirements
+# GPU drivers and requirements

 Generally if your GPU is from 2017 or later it should be fine. Modern integrated graphics are usually fine for many use cases. The exact requirements will depend on how complex your visualization is and how many objects you need to render.

 More detailed information on GPUs and drivers is here: http://fastplotlib.org/ver/dev/user_guide/gpu.html

 For more detailed information, such as use on cloud computing infrastructure, see the WGPU docs: https://wgpu-py.readthedocs.io/en/stable/start.html#cloud-compute

-# :heart: Contributing
+# Contributing :heart:

 We welcome contributions! See the contributing guide: https://github.com/fastplotlib/fastplotlib/blob/main/CONTRIBUTING.md

 You can also take a look at our [**Roadmap for 2025**](https://github.com/fastplotlib/fastplotlib/issues/55) and [**Issues**](https://github.com/fastplotlib/fastplotlib/issues) for ideas on how to contribute!
+
+# Developers :brain:
+
+- [**Kushal Kolar**](https://github.com/kushalkolar)
+
+- [**Caitlin Lewis**](https://github.com/clewis7)
+
+- [**Almar Klein**](https://github.com/almarklein)
+
+- [**Amol Pasarkar**](https://github.com/apasarkar)
+
+A special thanks to all of the `pygfx` developers and the amazing work they have done. 
@@ -95,8 +95,12 @@ What frameworks does ``fastplotlib`` support?
        - `glfw`
        - `wxPython`

-    Note: Use in Google Colab is not highly functional. We recommend using an inexpensive alternative cloud provider
-    such as CodeOcean or Lambda Cloud. We have tested these and `fastplotlib` works very well.
+    Notes:
+        - `jupyter_rfb <https://github.com/vispy/jupyter_rfb>`_ does not work in Google Collab, see https://github.com/vispy/jupyter_rfb/pull/77
+        - Non-blocking interactive Qt/PySide output is supported in ipython and notebooks, see the `interactive shells section in the user guide <http://fastplotlib.org/ver/dev/user_guide/guide.html#using-fastplotlib-in-an-interactive-shell>`_
+        - We do not officially support `jupyter notebook` through `jupyter_rfb` and strongly recommend using `jupyter lab`. Jupyter Notebook v7 might work, but this has not been extensively tested.
+        - We only support `jupyterlab` for use in notebooks. This means that we do not support VSCode notebooks or any other python notebook platform. Jupyterlab is the most reliable way to use widget-based libraries in notebooks.
+

 How can I use ``fastplotlib`` interactively?
 --------------------------------------------