Skip to main content

A simple plugin to view large images

Project description

Large-Image-Viewer

License MIT PyPI Python Version tests codecov napari hub

A simple plugin to view large images


Installation

You can install Large-Image-Viewer via pip:

pip install Large-Image-Viewer

To install latest development version :

pip install git+https://github.com/WyssCenter/Large-Image-Viewer.git

Contributing

Contributions are very welcome. Tests can be run with tox, please ensure the coverage at least stays the same before you submit a pull request.

License

Distributed under the terms of the MIT license, "Large-Image-Viewer" is free and open source software

Issues

If you encounter any problems, please file an issue along with a detailed description.

Napari Large Image Viewer Plugin

The Napari Large Image Viewer Plugin is a powerful extension for the napari image visualization software. This plugin is designed to enable the visualization of large TIFF | TIF files directly from disk, without the need to load the entire image into RAM. This is particularly useful when working with large datasets that exceed the available memory of your system.

Features

  • Efficient Large Image Visualization: The plugin allows you to open and visualize large files that are too big to fit into memory. It utilizes efficient memory-mapping techniques to display image data without fully loading it into RAM.

  • Interactive Exploration: With the Napari Large Image Viewer Plugin, you can interactively explore large datasets using familiar zooming, panning, and slicing actions.

  • Quick Installation: Installing the plugin is simple and straightforward, and it seamlessly integrates with the napari environment.

  • User-Friendly Interface: The plugin provides an intuitive user interface that integrates seamlessly into the napari interface, making it easy to use for both beginners and experienced users.

Installation

  1. Prerequisites: Make sure you have napari installed on your system. If not, you can install it using:

    pip install napari
    
  2. Install the Plugin: You can install the plugin directly from GitHub using pip:

    pip install git+https://github.com/WyssCenter/Large-Image-Viewer.git
    
  3. Launch napari: Launch napari from your terminal:

    napari
    
  4. Activate the Plugin: Once napari is launched, go to the Plugins menu and select Large Image Viewer to activate the plugin.

  5. Open Large TIFF | TIF File: With the plugin activated, you can now open a large file by dragging and dropping it to the napari viewer.

Usage

  1. Open a Large TIFF | TIF File: Follow the installation instructions above to open a large TIFF | TIF file using the plugin.

  2. Explore the Image: Once the image is loaded, you can use the mouse to zoom in/out, pan, and interactively explore the data. You can also adjust the colormap, contrast, and other visualization settings from the napari interface.

  3. Slicing and Navigation: Use the slicing and navigation tools in napari to navigate through different sections of the large file.

  4. Save Visualizations: You can save snapshots or screenshots of the current visualization using the napari interface.

Contributions

Contributions to the Napari Large Image Viewer Plugin are welcome! If you encounter issues or have suggestions for improvements, please open an issue on the GitHub repository.

License

This plugin is licensed under the MIT License.

Contact

For any inquiries or questions, you can reach out to the author at nima.mojtahedi@wysscenter.ch

Project details


Download files

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

Source Distribution

Large-Image-Viewer-1.1.0.tar.gz (10.4 kB view details)

Uploaded Source

Built Distribution

Large_Image_Viewer-1.1.0-py3-none-any.whl (7.9 kB view details)

Uploaded Python 3

File details

Details for the file Large-Image-Viewer-1.1.0.tar.gz.

File metadata

  • Download URL: Large-Image-Viewer-1.1.0.tar.gz
  • Upload date:
  • Size: 10.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for Large-Image-Viewer-1.1.0.tar.gz
Algorithm Hash digest
SHA256 507baf46c9e13cfea7e2ba72cdfa85349c6db2becd036b4afdea27e02fab0c92
MD5 99a3f6eed03f4693c5da1baf842e5553
BLAKE2b-256 80f43fa3073e941dd4323a56047dbbcac2aa8f837449ccd23f30bf847dcab02d

See more details on using hashes here.

File details

Details for the file Large_Image_Viewer-1.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for Large_Image_Viewer-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 33b87707a8f91e2360c76ae00a37ee8c4a08f2b22dc8e3b8092e1a7fb498b881
MD5 80b04f5e60e37472fb0c46eb5cec169a
BLAKE2b-256 e6feeb0eea19d1c56db7d183e1db686a0cacc4cd1b3d74e3e75c0d576d12740b

See more details on using hashes here.

Supported by

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