Package: napari-cryoet-data-portal
napari-cryoet-data-portalList and open tomograms from the CZ Imaging Institute'sCryoET Data Portalinnapari.InstallationYou can install the latest stable version usingpip:pip install napari-cryoet-data-portalYou will also need to install napari separately as a Python package in the same environment.
One way to do that with Qt included is to run:pip install "napari[all]"but more generally you should follow thelatest napari installation instructions.UsageSee the following video for a demonstration of basic usage of the plugin.https://github.com/chanzuckerberg/napari-cryoet-data-portal/assets/2608297/51207e08-68af-446a-87bb-3de9c6756d35Click theConnectbutton to establish a connection to the data portal.You can optionally query a subset of datasets, runs, voxel spacings, or tomograms using their corresponding IDs.
This can speed up the listing process as the portal grows.
To do so, select an ID type in the associated drop-down box from this panel, then enter the IDs of interest separated by commas in the text box next to it.
For example, if you only want to list datasets 10000 and 10001, selectDataset IDsfrom the drop-down box and enter the text10000,10001in the text box.
By default, all datasets are listed.After connecting to the portal, datasets are added below as they are found.Datasets and tomograms can be filtered by specifying a regular expression pattern.Selecting a dataset displays its metadata, which can be similarly explored and filtered.Selecting a tomogram displays its metadata and also opens the lowest resolution tomogram and all of its associated point annotations in the napari viewer.Higher resolution tomograms can be loaded instead by selecting a different resolution and clicking theOpenbutton.In this case, napari only loads the data that needs to be displayed in the canvas.
While this can reduce the amount of data loaded, it may also cause performance problems when initially opening and exploring the data.
By default, opening a new tomogram clears all the existing layers in napari.
If instead you want to keep those layers, uncheck the associated check-box in this panel.In general, finding and fetching data from the portal can take a long time.
All plugin operations that fetch data from the portal try to run concurrently in order to keep interaction with napari and the plugin as responsive as possible.
These operations can also be cancelled by clicking theCancelbutton.ContributingThis is still in early development, but contributions and ideas are welcome!
Don't hesitate toopen an issueoropen a pull requestto help improve this plugin.To setup a development environment, fork this repository, clone your fork, change into its top level directory and run:pip install -e ".[testing]"This project adheres to theContributor Covenant code of conduct.
By participating, you are expected to uphold this code.
Please report unacceptable behavior toopensource@chanzuckerberg.com.SecurityIf you believe you have found a security issue, please see oursecurity policyon how to report it.LicenseDistributed under the terms of theMITlicense, "napari-cryoet-data-portal" is free and open source software. See thelicense filefor more details.AcknowledgementsThis plugin was generated withCookiecutterusing@napari'scookiecutter-napari-plugintemplate.