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 hashes)

Uploaded Source

Built Distribution

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

Uploaded Python 3

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