{"name":"MSI-Explorer","display_name":"MSI-Explorer","visibility":"public","icon":"","categories":[],"schema_version":"0.2.0","on_activate":null,"on_deactivate":null,"contributions":{"commands":[{"id":"MSI-Explorer.get_reader","title":"Open data with MSI-Explorer","python_name":"msi_explorer._reader:napari_get_reader","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"MSI-Explorer.write_multiple","title":"Save multi-layer data with MSI-Explorer","python_name":"msi_explorer._writer:write_multiple","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"MSI-Explorer.write_single_image","title":"Save image data with MSI-Explorer","python_name":"msi_explorer._writer:write_single_image","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"MSI-Explorer.make_qwidget","title":"Make MSI-Explorer","python_name":"msi_explorer._widget:MSI_Explorer","short_title":null,"category":null,"icon":null,"enablement":null}],"readers":[{"command":"msi_explorer.get_reader","filename_patterns":["*.imzML"],"accepts_directories":false}],"writers":[{"command":"MSI-Explorer.write_multiple","layer_types":["image*","labels*"],"filename_extensions":[],"display_name":""},{"command":"MSI-Explorer.write_single_image","layer_types":["image"],"filename_extensions":[".npy"],"display_name":""}],"widgets":[{"command":"MSI-Explorer.make_qwidget","display_name":"MSI-Explorer","autogenerate":false}],"sample_data":null,"themes":null,"menus":{},"submenus":null,"keybindings":null,"configuration":[]},"package_metadata":{"metadata_version":"2.1","name":"MSI-Explorer","version":"1.0.1","dynamic":null,"platform":null,"supported_platform":null,"summary":"a napari plug-in for biochemical annotation of mass spectrometry imaging data","description":"# MSI-Explorer\n\n[![License BSD-3](https://img.shields.io/pypi/l/MSI-Explorer.svg?color=green)](https://github.com/MMV-Lab/MSI-Explorer/raw/main/LICENSE)\n[![PyPI](https://img.shields.io/pypi/v/MSI-Explorer.svg?color=green)](https://pypi.org/project/MSI-Explorer)\n[![Python Version](https://img.shields.io/pypi/pyversions/MSI-Explorer.svg?color=green)](https://python.org)\n[![tests](https://github.com/MMV-Lab/MSI-Explorer/workflows/tests/badge.svg)](https://github.com/MMV-Lab/MSI-Explorer/actions)\n[![codecov](https://codecov.io/gh/MMV-Lab/MSI-Explorer/branch/main/graph/badge.svg?token=LR8CU032ZD)](https://codecov.io/gh/MMV-Lab/MSI-Explorer)\n[![napari hub](https://img.shields.io/endpoint?url=https://api.napari-hub.org/shields/MSI-Explorer)](https://napari-hub.org/plugins/MSI-Explorer)\n\n# User Manual\n\nThe MSI-Explorer napari plugin is a powerful tool designed for targeted biochemical annotations in MSI data. This user manual provides a comprehensive guide on how to install, use, and explore the functionalities of the plugin within the napari platform. It covers data import, visualization, mean intensity calculation, region of interest (ROI) analysis, annotation with selected databases and pre-processing such as noise reduction and normalization. \n\n[MSI-Explorer] \n \n## Installation\n\nInstall napari by using this command.\n   \n     pip install \"napari[all]\"\n\nYou can install `MSI-Explorer` via [pip]:\n   \n     pip install MSI-Explorer\n\n## Usage\nStart napari from the console with:\n\n    napari\n\nNavigate to `Plugins -> MSI-Explorer (MSI-Explorer)`\n![Plugin](https://github.com/nmmtsaw/MSI-Explorer_User-Manual/assets/127961719/104718fa-227e-4117-9b52-f674a265d218)\n\n### 1. Uploading and visualization of mass spectrometry imaging data\n- Select imzml file using `Load imzML`.\n- Metadata can be checked by `View Metadata`.\n![Uploading MSI data_v1](https://github.com/nmmtsaw/MSI-Explorer_User-Manual/assets/127961719/a4783643-cf8e-4c68-af8e-03f264a48573)\n\n![Visualization of MSI data_v1](https://github.com/nmmtsaw/MSI-Explorer_User-Manual/assets/127961719/5e37c375-d430-419a-9038-9980e858c482)\n\n\n####\nUpon uploading profile mode data, a pop-up appears prompting you to convert it to centroid mode.\nSelecting `Yes` converts the data, while `No` keeps it in its original profile format.\n\n![profile_centroid](https://github.com/nmmtsaw/MSI-Explorer-Manual/assets/127961719/5eecf5c2-e9b5-45da-a620-6dfaad058faf)\n\n### 2. Calculating mean (average) intensity\n- To calculate the mean spectrum, click on `Show true mean spectrum`.\n- Clicking `Show image` will create an image view of the currently plotted data\n- To export the plotted data as .csv file, click `Export spectrum data`.\n- To save the spectrum plot as image, click `Export spectrum plot`.\n\n![Calculating mean spectrum](https://github.com/nmmtsaw/MSI-Explorer_User-Manual/assets/127961719/2e921e00-75cf-4925-a9de-01d093277a06)\n\n![Calculating mean spectrum_v1](https://github.com/nmmtsaw/MSI-Explorer_User-Manual/assets/127961719/19a713e3-a9ff-4e0c-be6b-545fb29991c6)\n\n\n#### 2.1. Calculating mean (average) intensity of selected m/z value\nTo focus on a specific m/z value, zoom in on the spectrum plot. The figure will be as\nshown as below.\n![Calculating mean spectrum specific mz_v1](https://github.com/nmmtsaw/MSI-Explorer_User-Manual/assets/127961719/ba47080a-f439-4dc2-96b9-1f82ee5acbc3)\n\nIt is recommended to use `Multi` panel view.\nThe image can be displayed by `Show image` and the data can be exported as `.csv` file by using `Export spectrum data`.\n\n### 3. Pre-processing\nThe pre-processing capabilities of MSI-Explorer enhance data quality and prepare MSI data for downstream analysis. Pre-processing steps involve: \n\n\n#### (a) Noise reduction\nUsers can choose their desired level of noise reduction (shown as a percentage) for their experiment. \n\n![Noise reduction_v1](https://github.com/nmmtsaw/MSI-Explorer_User-Manual/assets/127961719/9ce5e428-fe46-4f5f-a53f-7186c9f5ca8c)\n\n#### (b) Normalization\nThe normalization methods that the user can apply are \n- Total ion current (TIC)\n- Root mean square (RMS)\n- Medium\n- Reference peak (or internal standard)\n\n![normalization_v1](https://github.com/nmmtsaw/MSI-Explorer_User-Manual/assets/127961719/972b30af-8425-46e4-bb54-705df52c725a)\n\n#### (c) Hotspot removal\nHotspot removal can also be applied using a default threshold of 99.99%.\n![hotspot removal_v1](https://github.com/nmmtsaw/MSI-Explorer_User-Manual/assets/127961719/c9d279fa-d03b-499d-857d-6953ba7ea253)\n\n\nAfter pre-processing steps are chosen, click `Execute` and `Show true mean spectrum` to calculate the mean intensity.\n\nThe figure shows the spectrum and image of the TIC normalization with 3% noise reduction and hotspot removal for the 99.9% quantile.\n![pre-processed_v1](https://github.com/nmmtsaw/MSI-Explorer_User-Manual/assets/127961719/d1068382-f6e2-4af9-9c5b-949fb87ac90c)\n\n\n### 4. Database\nTo use the database search, click on `Select` and a pop-up window will appear. There,\nselect `Metabolite_database_ver2`, which is a built-in database, and click `Confirm`.\n\n![Database](https://github.com/nmmtsaw/MSI-Explorer_User-Manual/assets/127961719/928fa260-196e-4034-8ddd-0944c751c77e)\n\nThe features of the database function are\n1. Charge (neutral, positive or negative)\n2. Adduct (based on the charge chosen)\n3. Range of the m/z value for the image display\n4. custom search with molecule name or m/z value\n\n![Database_search](https://github.com/nmmtsaw/MSI-Explorer_User-Manual/assets/127961719/ca7d943a-1b6b-4cba-bf4d-934ee574cc61)\n\nUsers can customize the database with exact mass, molecule name, or molecular formula. The format should be as shown in the table and the headers are not needed in the database.\n\nExact mass | Molecule name | Molecula formula\n------- | -------- | --------\n176.0950 | Cotinine | C10H12N2O\n174.1117 | Arginine | C6H14N4O2\n244.0881 | Biotin | C10H16N2O3S\n\n### 5. Region of interest (ROI) selection\n- To select the ROI, click on `Select ROI for mean spectrum`. Adjust the brush size and label color. You can fill the area by using paint icon. \n- Then click on the `Calculate ROI mean spectrum`.\n- You can export as `.csv` file by using `Export spectrum data`.\n- If one m/z is needed, just zoom-in the spectrum plot window and export.\n- Before selecting the second ROI, remove the first selected area by using eraser or label 0.\n\n![ROI selection_v1](https://github.com/nmmtsaw/MSI-Explorer_User-Manual/assets/127961719/e79ca007-a0b5-4ba7-8cea-ae5e8ad6dd7d)\n\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 [BSD-3] license,\n\"MSI-Explorer\" 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[file an issue]: https://github.com/MMV-Lab/MSI-Explorerissues\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","description_content_type":"text/markdown","keywords":null,"home_page":"https://github.com/MMV-Lab/MSI-Explorer","download_url":null,"author":"lennart kowitz","author_email":"lennart.kowitz@isas.de","maintainer":null,"maintainer_email":null,"license":"BSD-3-Clause","classifier":["Development Status :: 2 - Pre-Alpha","Framework :: napari","Intended Audience :: Developers","License :: OSI Approved :: BSD License","Operating System :: OS Independent","Programming Language :: Python","Programming Language :: Python :: 3","Programming Language :: Python :: 3 :: Only","Programming Language :: Python :: 3.8","Programming Language :: Python :: 3.9","Programming Language :: Python :: 3.10","Topic :: Scientific/Engineering :: Image Processing"],"requires_dist":["numpy","qtpy","pyimzml","matplotlib","vaex","opencv-python","tox ; extra == 'testing'","pytest ; extra == 'testing'","pytest-cov ; extra == 'testing'","pytest-qt ; extra == 'testing'","napari ; extra == 'testing'","pyqt5 ; extra == 'testing'"],"requires_python":">=3.8","requires_external":null,"project_url":["Bug Tracker, https://github.com/MMV-Lab/MSI-Explorer/issues","Documentation, https://github.com/MMV-Lab/MSI-Explorer#README.md","Source Code, https://github.com/MMV-Lab/MSI-Explorer","User Support, https://github.com/MMV-Lab/MSI-Explorer/issues"],"provides_extra":["testing"],"provides_dist":null,"obsoletes_dist":null},"npe1_shim":false}