WEBKNOSSOS Python Library
Python API for working with WEBKNOSSOS datasets, annotations, and for WEBKNOSSOS server interaction.
For the WEBKNOSSOS server, please refer to https://github.com/scalableminds/webknossos.
Features
- easy-to-use dataset API for reading/writing/editing raw 2D/3D image data and volume annotations/segmentation in WEBKNOSSOS-compatiböe format
- convert from other formats, e.g. tiff stacks
- add/remove layers
- update metadata (
datasource-properties.json) - up/downsample layers
- compress layers
- add/remove magnifications
- Command line tool (CLI) for manipulating and creating WEBKNOSSOS datasets
- manipulation of WEBKNOSSOS skeleton annotations (*.nml) as Python objects
- access to nodes, comments, trees, bounding boxes, metadata, etc.
- create new skeleton annotation from Graph structures or Python objects
- interaction, connection & scripting with your WEBKNOSSOS instance over the REST API
- list datastets, annotations, and tasks
- up- & downloading annotations and datasets
Please refer to the documentation for further instructions.
Installation
The webknossos package requires at least Python 3.10.
You can install it from pypi, e.g. via pip:
pip install webknossos
To install webknossos with the dependencies for all examples and support for more file types, run: pip install webknossos[all].
For working with Zeiss CZI microscopy data use pip install --extra-index-url https://pypi.scm.io/simple/ webknossos[czi].
By default webknossos can only distribute any computations through multiprocessing or Slurm. For Kubernetes or Dask install these additional dependencies:
pip install cluster_tools[kubernetes]
pip install cluster_tools[dask]
Examples
See the examples folder or the the documentation.
The dependencies for the examples are not installed by default. Use pip install webknossos[examples] to install them.
Contributions & Development
Please see the respective documentation page.
License
AGPLv3 Copyright scalable minds
Test Data Credits
Excerpts for testing purposes have been sampled from:
- Dow Jacobo Hossain Siletti Hudspeth (2018). Connectomics of the zebrafish's lateral-line neuromast reveals wiring and miswiring in a simple microcircuit. eLife. DOI:10.7554/eLife.33988
- Zheng Lauritzen Perlman Robinson Nichols Milkie Torrens Price Fisher Sharifi Calle-Schuler Kmecova Ali Karsh Trautman Bogovic Hanslovsky Jefferis Kazhdan Khairy Saalfeld Fetter Bock (2018). A Complete Electron Microscopy Volume of the Brain of Adult Drosophila melanogaster. Cell. DOI:10.1016/j.cell.2018.06.019. License: CC BY-NC 4.0
- Bosch Ackels Pacureanu et al (2022). Functional and multiscale 3D structural investigation of brain tissue through correlative in vivo physiology, synchrotron microtomography and volume electron microscopy. Nature Communications. DOI:10.1038/s41467-022-30199-6
- Hanke, M., Baumgartner, F. J., Ibe, P., Kaule, F. R., Pollmann, S., Speck, O., Zinke, W. & Stadler, J. (2014). A high-resolution 7-Tesla fMRI dataset from complex natural stimulation with an audio movie. Scientific Data, 1:140003. DOI:10.1038/sdata.2014.3
- Sample OME-TIFF files (c) by the OME Consortium https://downloads.openmicroscopy.org/images/OME-TIFF/2016-06/bioformats-artificial/
Release files for webknossos 4.2.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| webknossos-4.2.2.tar.gz | 352.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| webknossos-4.2.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 761.2 kB
Release files / webknossos-4.2.2.tar.gz
| Download URL | webknossos-4.2.2.tar.gz |
|---|---|
| Size | 352.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f1c6b08578443311ff69c07127640a8454c09dd8dc2f1c4d20098021aa44fc45
|
|
BLAKE2b-256 checksum How to use checksums |
86a9999ba900eacb577b0d964bead78d30802dc731f3a88833273c219bcca7fc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / webknossos-4.2.2-py3-none-any.whl
| Download URL | webknossos-4.2.2-py3-none-any.whl |
|---|---|
| Size | 408.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7eba3a7914849bf36675326912a0a82bfd1cb921e4aa54eb69ec27ba71568bc6
|
|
BLAKE2b-256 checksum How to use checksums |
d804c3b7bacdadfb71821e79b63a9023ddaa220f5162c1b77b625525f53cbae9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
