Skip to main content

surfplot

https://zenodo.org/badge/380025008.svg

surfplot is a flexible and easy-to-use package that makes publication-ready brain surface plots. Users can easily set the plot views and layout, add multiple data layers, draw outlines, and further customize their figure directly using matplotlib.

example

Example Neurosynth association maps; see Example 1

At its core, surfplot is simply a high-level interface to Brainspace’s excellent surface plotting and manipulation capabilities, which are built on top of Visualization Toolkit (VTK). Surfaces are rendered with Brainspace and then embedded into a matplotlib figure for easy integration with typical plotting workflows. A big thank you to the Brainspace developers for making this package possible.

surfplot is designed around common use-cases for surface plotting and popular surface plotting software (e.g., Connectome Workbench). surfplot also provides some additional utility functions to streamline the plotting process.

Getting started

Follow the Installation Instructions to install surfplot, and then check out the Tutorials and Examples to learn how to get up and running! Refer to the API reference for complete documentation.

Citing surfplot

Please cite the following if you use surfplot:

Gale, Daniel J., Vos de Wael., Reinder, Benkarim, Oualid, & Bernhardt, Boris. (2021). Surfplot: Publication-ready brain surface figures (v0.1.0). Zenodo. https://doi.org/10.5281/zenodo.5567926

Vos de Wael R, Benkarim O, Paquola C, Lariviere S, Royer J, Tavakol S, Xu T, Hong S-J, Langs G, Valk S, Misic B, Milham M, Margulies D, Smallwood J, Bernhardt BC. 2020. BrainSpace: a toolbox for the analysis of macroscale gradients in neuroimaging and connectomics datasets. Communications Biology. 3:103. https://doi.org/10.1038/s42003-020-0794-7

License information

This codebase is licensed under the 3-clause BSD license. The full license can be found in the LICENSE file in the surfplot distribution.

Support

If you encounter problems or bugs with surfplot, or have questions or improvement suggestions, please feel free to get in touch via the Github issues.

Metadata

Release files for surfplot 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for surfplot 0.2.0
File Size Uploaded
surfplot-0.2.0.tar.gz 72.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for surfplot 0.2.0
File Interpreter ABI Platform
surfplot-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 141.8 kB

Release files / surfplot-0.2.0.tar.gz

Download URL surfplot-0.2.0.tar.gz
Size 72.1 kB
Tags Source
SHA-256 checksum
How to use checksums
1dd4ae3943860b1756f97e6acb10decc6e0411637a9d3ab4d365c4df99bb7bad
BLAKE2b-256 checksum
How to use checksums
d4f81b74ddcb05764db182b1f468bcb8efb5548b8efe5f6e29be86c07d25cd8e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.8.15

Release files / surfplot-0.2.0-py3-none-any.whl

Download URL surfplot-0.2.0-py3-none-any.whl
Size 69.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cec0cc4283406898ef0c92e7c952dddc0f77993a8c05a6ceb9974a556a228ab8
BLAKE2b-256 checksum
How to use checksums
b117440347ae24a38c78a9b116e0b80d91ee980ab88936a474546b7d2b5238c9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.8.15
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page