# shreeranganathsaravade78/ml-mini-project architecture

> Architecture diagram of the GitHub repository shreeranganathsaravade78/ml-mini-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shreeranganathsaravade78/ml-mini-project
- Repository: https://github.com/shreeranganathsaravade78/ml-mini-project

## Overview

This project downloads the public MSK pancreatic cancer cohort, prepares survival records, and evaluates both 270-day death classifiers and Cox survival models. Its principal workflow runs from cohort download through analysis outputs; separate scripts turn saved classifier results into comparison plots and a PDF summary. The README documents the analysis capabilities and run sequence; sampled source shows the downloader, model implementations, and plot/report inputs. The analysis excerpt is incomplete, so some internal output wiring is represented only where documented.

Main entry points: [`src/analysis.py`](https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/src/analysis.py) (Analysis Runner), [`data/download_msk_paad.py`](https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/data/download_msk_paad.py) (Cohort Downloader), [`src/create_plots.py`](https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/src/create_plots.py) (Comparison Plots), [`src/create_writeup.py`](https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/src/create_writeup.py) (PDF Write-up)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cohort["Cohort Data"]
  node_downloader["Cohort Downloader"]
  node_cohort_csv["Prepared Cohort CSV<br/>[.gitkeep]"]
end

subgraph group_analysis["Survival Analysis"]
  node_analysis_cli["Analysis Runner<br/>[analysis.py]"]
  node_classifier["270-Day Classifiers<br/>[analysis.py]"]
  node_cox["Cox Evaluation<br/>[analysis.py]"]
  node_km["Kaplan–Meier<br/>[analysis.py]"]
  node_analysis_tables["Analysis Tables"]
end

subgraph group_visuals["Results Presentation"]
  node_plots["Comparison Plots<br/>[create_plots.py]"]
  node_plot_files["Plot Files"]
  node_writeup["PDF Write-up<br/>[create_writeup.py]"]
  node_pdf["Project PDF"]
end

node_analyst(("Analyst"))
node_portal{{"cBioPortal"}}

node_analyst -->|"runs download"| node_downloader
node_downloader -->|"fetches cohort"| node_portal
node_downloader -->|"writes CSV"| node_cohort_csv
node_analyst -->|"runs analysis"| node_analysis_cli
node_cohort_csv -->|"loads data"| node_analysis_cli
node_analysis_cli -->|"evaluates classifiers"| node_classifier
node_analysis_cli -->|"evaluates Cox"| node_cox
node_analysis_cli -->|"computes survival"| node_km
node_analysis_cli -->|"saves results"| node_analysis_tables
node_analyst -->|"runs plotting"| node_plots
node_plots -->|"reads tables"| node_analysis_tables
node_plots -->|"saves plots"| node_plot_files
node_analyst -->|"builds summary"| node_writeup
node_writeup -->|"reads results"| node_analysis_tables
node_writeup -->|"writes PDF"| node_pdf

click node_downloader "https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/data/download_msk_paad.py"
click node_cohort_csv "https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/data/private/.gitkeep"
click node_analysis_cli "https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/src/analysis.py"
click node_classifier "https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/src/analysis.py"
click node_cox "https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/src/analysis.py"
click node_km "https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/src/analysis.py"
click node_analysis_tables "https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/outputs/msk_paad_2024/classifier_results.csv"
click node_plots "https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/src/create_plots.py"
click node_plot_files "https://github.com/shreeranganathsaravade78/ml-mini-project/tree/main/outputs"
click node_writeup "https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/src/create_writeup.py"
click node_pdf "https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/outputs/mini_project_writeup.pdf"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_downloader,node_cohort_csv toneBlue
class node_analysis_cli,node_classifier,node_cox,node_km,node_analysis_tables toneAmber
class node_plots,node_plot_files,node_writeup,node_pdf toneMint
class node_analyst,node_portal toneIndigo
```

## Components

### Cohort Data

- [Cohort Downloader](https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/data/download_msk_paad.py): `data/download_msk_paad.py`
- [Prepared Cohort CSV](https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/data/private/.gitkeep): `data/private/.gitkeep`

### Survival Analysis

- [Analysis Runner](https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/src/analysis.py): `src/analysis.py`
- [270-Day Classifiers](https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/src/analysis.py): `src/analysis.py`
- [Cox Evaluation](https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/src/analysis.py): `src/analysis.py`
- [Kaplan–Meier](https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/src/analysis.py): `src/analysis.py`
- [Analysis Tables](https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/outputs/msk_paad_2024/classifier_results.csv): `outputs/msk_paad_2024/classifier_results.csv`

### Results Presentation

- [Comparison Plots](https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/src/create_plots.py): `src/create_plots.py`
- [Plot Files](https://github.com/shreeranganathsaravade78/ml-mini-project/tree/main/outputs): `outputs`
- [PDF Write-up](https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/src/create_writeup.py): `src/create_writeup.py`
- [Project PDF](https://github.com/shreeranganathsaravade78/ml-mini-project/blob/main/outputs/mini_project_writeup.pdf): `outputs/mini_project_writeup.pdf`

### Other components

- **Analyst**
- **cBioPortal**

## Connections

- Analyst → Cohort Downloader: runs download (evidence: `README.md`)
- Cohort Downloader → cBioPortal: fetches cohort (evidence: `data/download_msk_paad.py`)
- Cohort Downloader → Prepared Cohort CSV: writes CSV (evidence: `data/download_msk_paad.py`)
- Analyst → Analysis Runner: runs analysis (evidence: `README.md`)
- Prepared Cohort CSV → Analysis Runner: loads data (evidence: `README.md`)
- Analysis Runner → 270-Day Classifiers: evaluates classifiers (evidence: `README.md`)
- Analysis Runner → Cox Evaluation: evaluates Cox (evidence: `README.md`)
- Analysis Runner → Kaplan–Meier: computes survival (evidence: `README.md`)
- Analysis Runner → Analysis Tables: saves results (evidence: `README.md`)
- Analyst → Comparison Plots: runs plotting (evidence: `README.md`)
- Comparison Plots → Analysis Tables: reads tables (evidence: `src/create_plots.py`)
- Comparison Plots → Plot Files: saves plots (evidence: `src/create_plots.py`)
- Analyst → PDF Write-up: builds summary (evidence: `README.md`)
- PDF Write-up → Analysis Tables: reads results (evidence: `src/create_writeup.py`)
- PDF Write-up → Project PDF: writes PDF (evidence: `src/create_writeup.py`)
