Skip to main content

Python API for working with WEBKNOSSOS datasets, annotations, and for WEBKNOSSOS server interaction.

Project description

WEBKNOSSOS Python Library

PyPI version Supported Python Versions Build Status Documentation Code Style

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 wrap (*.wkw) format
    • add/remove layers
    • update metadata (datasource-properties.json)
    • up/downsample layers
    • compress layers
    • add/remove magnifications
    • execute any of the wkCuber operations from your code
  • 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
    • up- & downloading annotations and datasets

Please refer to the documentation for further instructions.

Installation

The webknossos package requires at least Python 3.8.

You can install it from pypi, e.g. via pip:

pip install webknossos

Examples

See the examples folder or the the documentation.

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

Release history Release notifications | RSS feed

Download files

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

Source Distribution

webknossos-0.13.7.tar.gz (202.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

webknossos-0.13.7-py3-none-any.whl (384.4 kB view details)

Uploaded Python 3

File details

Details for the file webknossos-0.13.7.tar.gz.

File metadata

  • Download URL: webknossos-0.13.7.tar.gz
  • Upload date:
  • Size: 202.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.5.1 CPython/3.8.18 Linux/6.2.0-1012-azure

File hashes

Hashes for webknossos-0.13.7.tar.gz
Algorithm Hash digest
SHA256 558d52423814963738495c788e7a55157854f8cdde4e75d8b3788d2229ec88bf
MD5 c6669565fbcfca8002778dcb35811a12
BLAKE2b-256 7e8732e575f56aff06de36dd100b618b5acce79b9c7cc029eef6a85a929cd0c6

See more details on using hashes here.

File details

Details for the file webknossos-0.13.7-py3-none-any.whl.

File metadata

  • Download URL: webknossos-0.13.7-py3-none-any.whl
  • Upload date:
  • Size: 384.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.5.1 CPython/3.8.18 Linux/6.2.0-1012-azure

File hashes

Hashes for webknossos-0.13.7-py3-none-any.whl
Algorithm Hash digest
SHA256 01c421f77174ac9b2b51b59133daab604b2e46d9f42aa0c9dbc6823cb2a13a0e
MD5 6b7a2b86f9f6c002964269aa5f64ed98
BLAKE2b-256 fefe3cdd425334922c7935808e5b9dcf7546e6a3de5a105ea0cb7b24a464315e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page