Automation and interoperability

Tutorial

Albane le Tournoulx de la Villegeorges
WEBKNOSSOS
3 min readJun 19, 2023

--

In this tutorial, we will explore two methods for downloading data: First, we will use the WEBKNOSSOS UI to download data as a Tiff stack. Then, we will learn how to automate this process using Python. Additionally, I will guide you through the process of incorporating an N5 remote dataset into WEBKNOSSOS. Let’s have a look!

WEBKNOSSOS makes it easy to download and export annotations as Tiff images. Start by creating a bounding box with the bounding box tool. Adjust it so that it covers the desired area.

Creating a bounding box around the area you want to export using the bounding box tool.

Then, access the “Download” option from the dropdown menu and select “Tiff Export”. Choose which layer you want to export, and the bounding box covering the region you want to download. Click “export”, and that’s it! The Tiff stack will be saved in your download folder.

Export the color layer as Tiff stack using the “download” modal.

To automate this process with Python, follow the same initial steps. Select “Python client” in the download modal, then copy the provided code. You can also use the Python library documentation for more code examples to interact with your data.

Opening the download modal and copying the Python code.

Run the code on your computer to complete the process.

Running the code to download the data.

WEBKNOSSOS integrates seamlessly with other analysis softwares, enabling you to work with datasets from tools like Neuroglancer and Fiji. Let’s see an example of importing a Neuroglancer dataset to WEBKNOSSOS.

First, find the released dataset you would like to import online and copy its URL. In WEBKNOSSOS, click on “Add dataset” and select “Add remote dataset”. Paste the link, then click “Add layer”. Similar to adding local data, choose a target folder. Define a name for your dataset, set the voxel size, and click “import”. Once the dataset is imported, open it and enjoy the view!

Adding an N5 remote dataset to WEBKNOSSOS.

That’s it, now you know how to export data using the UI or Python as well as how to work with remote datasets. Try out what you have learned now on webknossos.org! For more tutorials and updates on new features, follow us on Twitter or Mastodon.

--

--

WEBKNOSSOS
WEBKNOSSOS

Published in WEBKNOSSOS

WEBKNOSSOS: Visualize, share and collaboratively annotate your large 3D image datasets online. Here we introduce new features and share insights into the WEBKNOSSOS development roadmap.

Albane le Tournoulx de la Villegeorges
Albane le Tournoulx de la Villegeorges

Written by Albane le Tournoulx de la Villegeorges

Marketing Manager and Visual Designer at scalable minds