{"name":"napari-mm3","display_name":"napari-mm3","visibility":"public","icon":"","categories":[],"schema_version":"0.1.0","on_activate":null,"on_deactivate":null,"contributions":{"commands":[{"id":"napari-mm3.TIFFConverter","title":"Converts an nd2 (or other bioformats supported filetype) file to TIFFs.","python_name":"napari_mm3._tiff_converter:TIFFExport","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"napari-mm3.Compile","title":"Performs Mother Machine Analysis","python_name":"napari_mm3._compile:Compile","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"napari-mm3.Subtract","title":"Performs Mother Machine Analysis","python_name":"napari_mm3._subtract:Subtract","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"napari-mm3.SegmentOtsu","title":"Performs Mother Machine Analysis","python_name":"napari_mm3._segment_otsu:SegmentOtsu","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"napari-mm3.SegmentUnet","title":"Performs Mother Machine Analysis","python_name":"napari_mm3._segment_unet:SegmentUnet","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"napari-mm3.Track","title":"Performs Mother Machine Analysis","python_name":"napari_mm3._track:Track","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"napari-mm3.Annotate","title":"Annotate training data","python_name":"napari_mm3._annotate:Annotate","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"napari-mm3.TrainUnet","title":"Train U-net model","python_name":"napari_mm3._train_unet:TrainUnet","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"napari-mm3.ChannelPicker","title":"Sort channels","python_name":"napari_mm3._channel_picker:ChannelPicker","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"napari-mm3.Colors","title":"Analyze fluorescence images","python_name":"napari_mm3._colors:Colors","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"napari-mm3.Foci","title":"Detect and track foci","python_name":"napari_mm3._foci:Foci","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"napari-mm3.FociPicking","title":"Foci picking","python_name":"napari_mm3._foci_picking:FociPicking","short_title":null,"category":null,"icon":null,"enablement":null}],"readers":null,"writers":null,"widgets":[{"command":"napari-mm3.TIFFConverter","display_name":"TIFFConverter","autogenerate":false},{"command":"napari-mm3.Compile","display_name":"Compile","autogenerate":false},{"command":"napari-mm3.ChannelPicker","display_name":"PickChannels","autogenerate":false},{"command":"napari-mm3.Subtract","display_name":"Subtract","autogenerate":false},{"command":"napari-mm3.SegmentOtsu","display_name":"SegmentOtsu","autogenerate":false},{"command":"napari-mm3.SegmentUnet","display_name":"SegmentUnet","autogenerate":false},{"command":"napari-mm3.Track","display_name":"Track","autogenerate":false},{"command":"napari-mm3.Annotate","display_name":"Annotate","autogenerate":false},{"command":"napari-mm3.TrainUnet","display_name":"TrainUnet","autogenerate":false},{"command":"napari-mm3.Colors","display_name":"Colors","autogenerate":false},{"command":"napari-mm3.Foci","display_name":"Foci","autogenerate":false},{"command":"napari-mm3.FociPicking","display_name":"FociPicking","autogenerate":false}],"sample_data":null,"themes":null,"menus":{},"submenus":null,"keybindings":null,"configuration":[]},"package_metadata":{"metadata_version":"2.1","name":"napari-mm3","version":"0.0.16","dynamic":null,"platform":null,"supported_platform":null,"summary":"a plugin for mother machine image analysis","description":"# napari-mm3\n\n[![License](https://img.shields.io/pypi/l/napari-mm3.svg?color=green)](https://github.com/junlabucsd/napari-mm3/raw/main/LICENSE)\n[![PyPI](https://img.shields.io/pypi/v/napari-mm3.svg?color=green)](https://pypi.org/project/napari-mm3)\n[![Python Version](https://img.shields.io/pypi/pyversions/napari-mm3.svg?color=green)](https://python.org)\n[![tests](https://github.com/junlabucsd/napari-mm3/workflows/tests/badge.svg)](https://github.com/junlabucsd/napari-mm3/actions)\n[![napari hub](https://img.shields.io/endpoint?url=https://api.napari-hub.org/shields/napari-mm3)](https://napari-hub.org/plugins/napari-mm3)\n\nA plugin for mother machine image analysis by the [Jun Lab](https://jun.ucsd.edu/).\n\nReference:\n[Tools and methods for high-throughput single-cell imaging with the mother machine. Ryan Thiermann, Michael Sandler, Gursharan Ahir, John T. Sauls, Jeremy W. Schroeder, Steven D. Brown, Guillaume Le Treut, Fangwei Si, Dongyang Li, Jue D. Wang, Suckjoon Jun. eLife12:RP88463\nhttps://doi.org/10.7554/eLife.88463.1](https://elifesciences.org/reviewed-preprints/88463)\n\n----------------------------------\n\nThis [napari] plugin was generated with [Cookiecutter] using [@napari]'s [cookiecutter-napari-plugin] template.\n\n<!--\nDon't miss the full getting started guide to set up your new package:\nhttps://github.com/napari/cookiecutter-napari-plugin#getting-started\n\nand review the napari docs for plugin developers:\nhttps://napari.org/plugins/stable/index.html\n-->\n\n\nhttps://github.com/junlabucsd/napari-mm3/assets/40699438/1b3e6121-f5e1-475f-aca3-c6ed1b5bab3a\n\n\n\n## Installation\n\nWe describe installation with mamba, a faster version of conda which we recommend. Installation with conda is the exact same, except replace `mamba` with `conda` Run the following command:\n\n```\nmamba create -n napari-mm3 -c conda-forge conda-build tensorflow napari\n``` \nNow, you need to install our code (please let us know if this causes problems -- it has been a pain point in the past). To do so, clone the repository:\n\n```\ngit clone https://github.com/junlabucsd/napari-mm3.git\n```\n\nThen, run the following commands from within your conda environment:\n```\ncd napari-mm3\npip install -e .\n```\nThis supplies you with the latest, most recent version of our code.\n\nIf you would like to have a more stable version, simply run `pip install napari-mm3`. In general, we recommend going off of the github version.\n\nnapari-MM3 can use the [python-bioformats](https://pypi.org/project/python-bioformats/) library to import various image file formats. It can be installed with pip:\n```\npip install python-bioformats\n```\nIf your raw images are in the .nd2 format, they will be read in with the nd2reader package. In this case, Bio-Formats is not required.\n\nNOTES:\nNot running the conda command above and trying to install things in a different way may lead to difficult issues with PyQt5. We recommend following the above commands to simplify the situation.\nUsing `pip -e .` instead of `mamba develop .` is a deliberate choice, the former did not seem to register the plugin with napari.\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## Usage guide\n\n\nhttps://github.com/junlabucsd/napari-mm3/assets/8302475/68c726be-620e-4375-b1c9-3db56ac9a82a\n\nAdditional reference information is available below.\n### a. Preprocessing\n\n* [TIFFConverter](https://github.com/junlabucsd/napari-mm3/blob/main/docs/tiffconvert-widget.md) -- Turn your nd2 microscopy data, or other format via bioformats, into TIFFs. If your data is already exported as individual TIFF files, skip to the [Compile](https://github.com/junlabucsd/napari-mm3/blob/main/docs/compile-widget.md) widget. Take note of the [input image guidelines](https://github.com/junlabucsd/napari-mm3/blob/main/docs/Input-images-guidelines.md).\n\n* [Compile](https://github.com/junlabucsd/napari-mm3/blob/main/docs/compile-widget.md) -- Locate traps, separate their timelapses into their own TIFFs, and return metadata.\n\n* [PickChannels](https://github.com/junlabucsd/napari-mm3/blob/main/docs/pickchannels-widget.md) -- User guided selection of empty and full traps.\n\n### b. Segmentation\n\n___With Otsu's method:___\n\n* [Subtract](https://github.com/junlabucsd/napari-mm3/blob/main/docs/subtract-widget.md) -- Remove (via subtraction) empty traps from the background of traps that contain cells; run this on the phase contrast channel.\n\n* [SegmentOtsu](https://github.com/junlabucsd/napari-mm3/blob/main/docs/segmentotsu-widget.md) -- Use Otsu's method to segment cells.\n\n___With U-Net:___\n\n* [Annotate](https://github.com/junlabucsd/napari-mm3/blob/main/docs/annotate-widget.md) -- annotate images for ML (U-Net or similar) training purposes.\n\n* [Train U-Net](https://github.com/junlabucsd/napari-mm3/blob/main/docs/trainunet-widget.md) -- Train a U-Net model for cell segmentation.\n\n* [SegmentUnet](https://github.com/junlabucsd/napari-mm3/blob/main/docs/segmentunet-widget.md) -- Run U-Net segmentation.\n\n### c. Tracking\n\n* [Track](https://github.com/junlabucsd/napari-mm3/blob/main/docs/track-widget.md) -- Acquire individual cell properties and track lineages.\n\n### d. Fluorescence data analysis\n\n* [Subtract](https://github.com/junlabucsd/napari-mm3/blob/main/docs/subtract-widget.md) -- Remove (via subtraction) empty traps from the background of traps that contain cells. This time, run this on your fluorescence channels.\n\n* [Colors](https://github.com/junlabucsd/napari-mm3/blob/main/docs/colors-widget.md) -- Calculate fluorescence information.\n\n### e. Focus tracking\n\n* [Foci](https://github.com/junlabucsd/napari-mm3/blob/main/docs/foci-widget.md) -- We use this to track `foci` (bright fluorescent spots) inside of cells.\n\n### f. Extracting data and plotting\n\n* The notebook [here](https://github.com/junlabucsd/napari-mm3/blob/main/notebooks/napari_mm3_analysis_template.ipynb) demonstrates how to extract, filter and visualize the lineage data output by the [Track](https://github.com/junlabucsd/napari-mm3/blob/main/docs/track-widget.md) widget.\n\n\n### g. Outputs, inputs, and file structure\nFinally, to better understand the data formats, you may wish to refer to the following documents:\n\n* [Input image guidelines](https://github.com/junlabucsd/napari-mm3/blob/main/docs/Input-images-guidelines.md)\n\n* [File structure](https://github.com/junlabucsd/napari-mm3/blob/main/docs/file-structure.md)\n\n* [Output data structure](https://github.com/junlabucsd/napari-mm3/blob/main/docs/Cell-class-docs.md)\n\n## License\n\nDistributed under the terms of the [BSD-3] license,\n\"napari-mm3\" 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/junlabucsd/napari-mm3/issues\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/junlabucsd/napari-mm3","download_url":null,"author":"Gursharan Ahir, Michael Sandler, Ryan Thiermann","author_email":"ryan.thiermann@gmail.com","maintainer":null,"maintainer_email":null,"license":"BSD-3-Clause","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.9","Programming Language :: Python :: 3.10","Programming Language :: Python :: 3.11","Operating System :: OS Independent","License :: OSI Approved :: BSD License"],"requires_dist":["napari-plugin-engine >=0.1.4","numpy","h5py","tifffile ==2021.11.2","scikit-learn","scikit-image","tensorflow","nd2reader","seaborn","elasticdeform"],"requires_python":">=3.9","requires_external":null,"project_url":["Bug Tracker, https://github.com/junlabucsd/napari-mm3/issues","Documentation, https://github.com/junlabucsd/napari-mm3#README.md","Source Code, https://github.com/junlabucsd/napari-mm3","User Support, https://github.com/junlabucsd/napari-mm3/issues"],"provides_extra":null,"provides_dist":null,"obsoletes_dist":null},"npe1_shim":false}