Giter VIP home page Giter VIP logo

lambda-science / myoquant-streamlit Goto Github PK

View Code? Open in Web Editor NEW
2.0 1.0 0.0 7.26 MB

MyoQuant-Streamlit is a demo web application to showcase usage of MyoQuant. Demo version deployed at: https://lbgi.fr/MyoQuant

Home Page: https://lbgi.fr/MyoQuant

License: GNU Affero General Public License v3.0

Python 93.77% Dockerfile 1.62% Jupyter Notebook 3.61% Shell 1.01%
computer-vision deep-learning disease histology image medecine python pytorch quantification streamlit

myoquant-streamlit's Introduction

title emoji colorFrom colorTo sdk sdk_version app_file license python
MyoQuant Streamlit
🔬
yellow
purple
streamlit
1.19.0
Home.py
agpl-3.0
3.10.9

Twitter Follow Demo Version PyPi Pypi verison

MyoQuant-Streamlit🔬: a demo web interface for the MyoQuant tool.

Please refer to the MyoQuant GitHub Repository or the MyoQuant PyPi repository for full documentation.

MyoQuant-Streamlit🔬 is a demo web interface to showcase the usage of MyoQuant.

MyoQuant Banner

MyoQuant Illustration

MyoQuant🔬 is a command-line tool to automatically quantify pathological features in muscle fiber histology images.
It is built using CellPose, Stardist, custom neural-network models and image analysis techniques to automatically analyze myopathy histology images. Currently MyoQuant is capable of quantifying centralization of nuclei in muscle fiber with HE staining, anomaly in the mitochondria distribution in muscle fibers with SDH staining and the number of type 1 muscle fiber vs type 2 muscle fiber with ATP staining.
This web application is intended for demonstration purposes only.

How to install or deploy the interface

The demo version is deployed at https://lbgi.fr/MyoQuant/. You can deploy your own demo version using Docker, your own python environment or google Colab for GPU support.

Docker

You can build the docker image by running docker build -t streamlit . and launch the container using docker run -p 8501:8501 streamlit.

Non-Docker

If you do not want to use Docker you can install the poetry package in a miniconda (python 3.9, 3.10) base env, run poetry install to install the python env, activate the env with poetry shell and launch the app by running streamlit run Home.py.

Deploy on Google Colab for GPU

As this application uses various deep-learning model, you could benefit from using a deployment solution that provides a GPU.
To do so, you can leverage Google Colab free GPU to boost this Streamlit application.
To run this app on Google Colab, simply clone the notebook called google_colab_deploy.ipynb into Colab and run the four cells. It will automatically download the latest code version, install dependencies and run the app. A link will appear in the output of the lat cell with a structure like https://word1-word2-try-01-234-567-890.loca.lt. Click it and the click continue and you’re ready to use the app!

How to Use

Once on the demo, click on the corresponding staining analysis on the sidebar, and upload your histology image. Results will be displayed in the main area automatically.
For all analysis you can press the "Load Default File" to load a sample image to try the tool.

Troubleshooting

If you have an error like libcublas.so[0-9] cannot be found It probably means that there is a weird CUDA on CPU-only hardware installation error. Try pip remove torch and pip install torch --index-url https://download.pytorch.org/whl/cpu, in your python virtual env. It should do the trick.

Contact

Creator and Maintainer: Corentin Meyer, 3rd year PhD Student in the CSTB Team, ICube — CNRS — Unistra [email protected]
The source code for MyoQuant is available HERE, for the demo website it is available HERE

Citing MyoQuant🔬

[placeholder]

Partners

Partner Banner

MyoQuant is born within the collaboration between the CSTB Team @ ICube led by Julie D. Thompson, the Morphological Unit of the Institute of Myology of Paris led by Teresinha Evangelista, the imagery platform MyoImage of Center of Research in Myology led by Bruno Cadot, the photonic microscopy platform of the IGMBC led by Bertrand Vernay and the Pathophysiology of neuromuscular diseases team @ IGBMC led by Jocelyn Laporte

myoquant-streamlit's People

Contributors

dependabot[bot] avatar lambda-science avatar

Stargazers

 avatar  avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.