{"name":"napari-apr-viewer","display_name":"napari-apr-viewer","visibility":"public","icon":"","categories":[],"schema_version":"0.2.0","on_activate":null,"on_deactivate":null,"contributions":{"commands":[{"id":"napari-apr-viewer.APRViewer","title":"APRViewer","python_name":"napari_apr_viewer._APRViewer:APRViewer","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"napari-apr-viewer.convert_image_to_apr","title":"convert_image_to_apr","python_name":"napari_apr_viewer._convert_image_to_apr:convert_image_to_apr","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"napari-apr-viewer.convert_apr_to_image","title":"convert_apr_to_image","python_name":"napari_apr_viewer._convert_apr_to_image:convert_apr_to_image","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"napari-apr-viewer.threshold","title":"threshold","python_name":"napari_apr_viewer._threshold:threshold","short_title":null,"category":null,"icon":null,"enablement":null}],"readers":[{"command":"napari-apr-viewer.napari_get_reader","filename_patterns":["*"],"accepts_directories":true}],"writers":[{"command":"napari-apr-viewer.napari_write_image","layer_types":["image"],"filename_extensions":[],"display_name":"image"}],"widgets":[{"command":"napari-apr-viewer.APRViewer","display_name":"APRViewer","autogenerate":false},{"command":"napari-apr-viewer.convert_image_to_apr","display_name":"convert_image_to_apr","autogenerate":false},{"command":"napari-apr-viewer.convert_apr_to_image","display_name":"convert_apr_to_image","autogenerate":false},{"command":"napari-apr-viewer.threshold","display_name":"threshold","autogenerate":false}],"sample_data":null,"themes":null,"menus":{},"submenus":null,"keybindings":null,"configuration":[]},"package_metadata":{"metadata_version":"2.1","name":"napari-apr-viewer","version":"1.0.1","dynamic":null,"platform":null,"supported_platform":null,"summary":"A simple plugin to view APR images in napari","description":"# napari-apr-viewer\n\n[![License](https://img.shields.io/pypi/l/napari-apr-viewer.svg?color=green)](https://github.com/AdaptiveParticles/napari-apr-viewer/raw/main/LICENSE)\n[![PyPI](https://img.shields.io/pypi/v/napari-apr-viewer.svg?color=green)](https://pypi.org/project/napari-apr-viewer)\n[![Python Version](https://img.shields.io/pypi/pyversions/napari-apr-viewer.svg?color=green)](https://python.org)\n[![tests](https://github.com/AdaptiveParticles/napari-apr-viewer/workflows/tests/badge.svg)](https://github.com/AdaptiveParticles/napari-apr-viewer/actions)\n[![codecov](https://codecov.io/gh/AdaptiveParticles/napari-apr-viewer/branch/main/graph/badge.svg)](https://codecov.io/gh/AdaptiveParticles/napari-apr-viewer)\n[![napari hub](https://img.shields.io/endpoint?url=https://api.napari-hub.org/shields/napari-apr-viewer)](https://napari-hub.org/plugins/napari-apr-viewer)\n\nA simple plugin to create and view APR images in napari\n\n## Usage\n\nTo get started, open an image of your choice (2D or 3D grayscale) in napari and open the `convert_image_to_apr` panel. Select the image layer to convert, an appropriate data type, and hit `Run`. \n\n**Note:** choosing a data type smaller than the input type may lead to overflow and thus erroneous results.\n\nConversion parameters can often be left to their default values, thanks to the automatic parameter tuning. For very noisy images, it is sometimes useful to increase the `smoothing` parameter. In order to get a more (or less) aggressive adaptation, change the `relative error` parameter.\n\n![conversion.png](https://github.com/AdaptiveParticles/napari-apr-viewer/raw/main/docs/conversion.png)\n\nTo save the result to file, simply save the newly created layer using the `File` menu. We use the extension `.apr`, although the file is actually written in `hdf5` format (and can be opened/explored as such). In this example, the APR is roughly 80 times smaller than the original image on disk. APR files can be opened directly in napari, e.g. by drag and drop.\n\n![apr_file.png](https://github.com/AdaptiveParticles/napari-apr-viewer/raw/main/docs/apr_file.png)\n\nTo better understand the workings of the APR on your data, you can use the `APR Viewer` panel to change the `View mode` for a selected APR layer to `level`. This shows you a visualization of the adaptive resolution. Particles in the brightest regions correspond exactly to pixels (lossless), while each shade darker corresponds to downsampling by a factor of 2 in each dimension.\n\n![view_level.png](https://github.com/AdaptiveParticles/napari-apr-viewer/raw/main/docs/view_level.png)\n\nThe `Downsample` slider can be used to reduce the resolution of the displayed data for the selected layer. This can be used to explore large volumes in 3D, where rendering the full data requires too much memory. \n\n**Note:** We do not offer APR-native rendering at this time, so this step will reconstruct the entire pixel volume (at the selected resolution). Thus, for large volumes, be sure to increase the downsampling before toggling the 3D viewer. \n\n![view_3D.png](https://github.com/AdaptiveParticles/napari-apr-viewer/raw/main/docs/view_3D.png)\n\n![view_3D_ds.png](https://github.com/AdaptiveParticles/napari-apr-viewer/raw/main/docs/view_3D_downsampled.png)\n\n_The data shown in these examples was taken from the Platynereis-ISH-Nuclei-CBG dataset available [here](https://github.com/juglab/EmbedSeg/releases)._\n\n \n\n----------------------------------\n\nThis [napari] plugin was generated with [Cookiecutter] using [@napari]'s [cookiecutter-napari-plugin] template.\n\n## Installation\n\nYou can install `napari-apr-viewer` via [pip]:\n\n    pip install napari-apr-viewer\n\n## Contributing\n\nContributions are very welcome. Tests can be run with [tox], please ensure\nthe coverage at least stays the same before you submit a pull request.\n\n## License\n\nDistributed under the terms of the [Apache Software License 2.0] license,\n\"napari-apr-viewer\" is free and open source software\n\n## Issues\n\nIf you encounter any problems, please [file an issue] along with a detailed description.\n\n[napari]: https://github.com/napari/napari\n[Cookiecutter]: https://github.com/audreyr/cookiecutter\n[@napari]: https://github.com/napari\n[MIT]: http://opensource.org/licenses/MIT\n[BSD-3]: http://opensource.org/licenses/BSD-3-Clause\n[GNU GPL v3.0]: http://www.gnu.org/licenses/gpl-3.0.txt\n[GNU LGPL v3.0]: http://www.gnu.org/licenses/lgpl-3.0.txt\n[Apache Software License 2.0]: http://www.apache.org/licenses/LICENSE-2.0\n[Mozilla Public License 2.0]: https://www.mozilla.org/media/MPL/2.0/index.txt\n[cookiecutter-napari-plugin]: https://github.com/napari/cookiecutter-napari-plugin\n\n[napari]: https://github.com/napari/napari\n[tox]: https://tox.readthedocs.io/en/latest/\n[pip]: https://pypi.org/project/pip/\n[PyPI]: https://pypi.org/\n\n[file an issue]: https://github.com/AdaptiveParticles/napari-apr-viewer/issues\n","description_content_type":"text/markdown","keywords":null,"home_page":null,"download_url":null,"author":"Joel Jonsson","author_email":"jonsson@mpi-cbg.de","maintainer":null,"maintainer_email":null,"license":"Apache-2.0","classifier":["Development Status :: 2 - Pre-Alpha","Intended Audience :: Developers","Framework :: napari","Topic :: Software Development :: Testing","Programming Language :: Python","Programming Language :: Python :: 3","Programming Language :: Python :: 3.8","Programming Language :: Python :: 3.9","Programming Language :: Python :: 3.10","Programming Language :: Python :: 3.11","Operating System :: OS Independent","License :: OSI Approved :: Apache Software License"],"requires_dist":["numpy","pyapr >=1.0.0rc1","napari","napari-plugin-engine >=0.1.4","qtpy","magicgui"],"requires_python":">=3.8","requires_external":null,"project_url":null,"provides_extra":null,"provides_dist":null,"obsoletes_dist":null},"npe1_shim":true}