# bogdanmaslyuk/master-cancer-landscape architecture

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

- Interactive diagram: https://gitdiagram.com/bogdanmaslyuk/master-cancer-landscape
- Repository: https://github.com/bogdanmaslyuk/master-cancer-landscape

## Overview

This is a reproducible cancer-target evidence pipeline, not a target-ranking system. Users seed targets and cancer contexts, normalize target identity against HGNC, then gather complementary Open Targets and DepMap evidence; DepMap adds context audits and primary or sensitivity analyses. QC and provenance preserve interpretability, while reports and an explorer expose results. README documents genome-wide DepMap analysis and synchronization capabilities beyond the sampled excerpts; those branches are included, but their internal links are limited to documented relationships.

Main entry points: [`src/mcl/cli.py`](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/cli.py) (Command interface), [`src/mcl/sources/depmap.py`](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/sources/depmap.py) (DepMap file access), [`src/mcl/analysis/opentargets.py`](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/analysis/opentargets.py) (Open Targets evidence), [`src/mcl/analysis/depmap.py`](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/analysis/depmap.py) (Context analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and sources"]
  node_cli["Command interface<br/>[cli.py]"]
  node_config["Project configuration<br/>[config.py]"]
  node_hgnc["HGNC snapshots<br/>[hgnc.py]"]
  node_normalization["Target normalization<br/>[targets.py]"]
  node_targetdata["Normalized targets"]
  node_ot_source["Open Targets access<br/>[opentargets.py]"]
  node_disease_mapping["Disease mapping<br/>[disease_mapping.py]"]
  node_depmap_sync["DepMap synchronization<br/>[depmap_sync.py]"]
  node_depmap_source["DepMap file access<br/>[depmap.py]"]
end

subgraph group_evidence["Evidence analysis"]
  node_ot_analysis["Open Targets evidence<br/>[opentargets.py]"]
  node_ot_results["Association evidence"]
  node_depmap_analysis["Context analysis<br/>[depmap.py]"]
  node_depmap_models["Context evidence models<br/>[depmap.py]"]
  node_depmap_results["Context evidence"]
  node_genomewide["Genome-wide analysis"]
  node_sensitivity["KRAS sensitivity<br/>[depmap.py]"]
end

subgraph group_assurance["QC and provenance"]
  node_qc["Evidence quality checks<br/>[depmap.py]"]
  node_ot_qc["Open Targets checks<br/>[opentargets.py]"]
  node_target_qc["Target identity checks<br/>[targets.py]"]
  node_qc_records["QC records<br/>[qc.py]"]
  node_provenance["Provenance records<br/>[provenance.py]"]
end

subgraph group_products["Results and exploration"]
  node_reports["Run manifests<br/>[reporting.py]"]
  node_visualization["DepMap explorer<br/>[depmap_explorer.py]"]
  node_output_files["QC and reports"]
end

node_scientist(("Pipeline user"))
node_ot_api{{"Open Targets API"}}
node_depmap_files["Pinned DepMap release"]

node_scientist -->|"runs commands"| node_cli
node_cli -->|"loads settings"| node_config
node_cli -->|"fetches snapshots"| node_hgnc
node_cli -->|"runs normalization"| node_normalization
node_normalization -->|"resolves identities"| node_hgnc
node_normalization -->|"writes identifiers"| node_targetdata
node_cli -->|"validates mappings"| node_disease_mapping
node_cli -->|"runs evidence fetch"| node_ot_analysis
node_ot_analysis -->|"queries platform"| node_ot_source
node_ot_analysis -->|"resolves diseases"| node_disease_mapping
node_ot_source -.->|"sends requests"| node_ot_api
node_ot_analysis -->|"writes associations"| node_ot_results
node_cli -->|"runs synchronization"| node_depmap_sync
node_depmap_sync -->|"checks local files"| node_depmap_source
node_depmap_source -->|"reads release files"| node_depmap_files
node_cli -->|"runs context analysis"| node_depmap_analysis
node_depmap_analysis -->|"loads inputs"| node_depmap_source
node_depmap_analysis -->|"creates evidence"| node_depmap_models
node_depmap_analysis -->|"writes results"| node_depmap_results
node_cli -->|"runs genome-wide analysis"| node_genomewide
node_genomewide -->|"loads matrix inputs"| node_depmap_source
node_cli -->|"runs KRAS sensitivity"| node_sensitivity
node_sensitivity -->|"loads inputs"| node_depmap_source
node_cli -->|"checks DepMap evidence"| node_qc
node_qc -->|"validates records"| node_depmap_models
node_cli -->|"checks associations"| node_ot_qc
node_cli -->|"checks identities"| node_target_qc
node_qc -->|"emits findings"| node_qc_records
node_ot_qc -->|"emits findings"| node_qc_records
node_target_qc -->|"emits findings"| node_qc_records
node_cli -->|"writes manifests"| node_reports
node_cli -->|"creates explorer"| node_visualization
node_reports -->|"writes reports"| node_output_files
node_visualization -->|"writes explorer pages"| node_output_files

click node_cli "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/cli.py"
click node_config "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/config.py"
click node_hgnc "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/sources/hgnc.py"
click node_normalization "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/normalize/targets.py"
click node_targetdata "https://github.com/bogdanmaslyuk/master-cancer-landscape/tree/main/data/processed"
click node_ot_source "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/sources/opentargets.py"
click node_disease_mapping "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/normalize/disease_mapping.py"
click node_ot_analysis "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/analysis/opentargets.py"
click node_ot_results "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/data/processed/opentargets_associations.tsv"
click node_depmap_sync "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/sources/depmap_sync.py"
click node_depmap_source "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/sources/depmap.py"
click node_depmap_files "https://github.com/bogdanmaslyuk/master-cancer-landscape/tree/main/data"
click node_depmap_analysis "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/analysis/depmap.py"
click node_depmap_models "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/models/depmap.py"
click node_depmap_results "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/data/processed/depmap_evidence.tsv"
click node_genomewide "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/analysis/depmap_genomewide.py"
click node_sensitivity "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/analysis/depmap.py"
click node_qc "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/qc/depmap.py"
click node_ot_qc "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/qc/opentargets.py"
click node_target_qc "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/qc/targets.py"
click node_qc_records "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/models/qc.py"
click node_provenance "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/models/provenance.py"
click node_reports "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/reporting.py"
click node_visualization "https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/visualization/depmap_explorer.py"
click node_output_files "https://github.com/bogdanmaslyuk/master-cancer-landscape/tree/main/outputs"

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_cli,node_config,node_hgnc,node_normalization,node_targetdata,node_ot_source,node_disease_mapping,node_depmap_sync,node_depmap_source,node_scientist toneBlue
class node_ot_analysis,node_ot_results,node_depmap_analysis,node_depmap_models,node_depmap_results,node_genomewide,node_sensitivity toneAmber
class node_qc,node_ot_qc,node_target_qc,node_qc_records,node_provenance,node_ot_api toneMint
class node_reports,node_visualization,node_output_files toneRose
class node_depmap_files toneTeal
```

## Components

### Identity and sources

- [Command interface](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/cli.py): `src/mcl/cli.py`
- [Project configuration](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/config.py): `src/mcl/config.py`
- [HGNC snapshots](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/sources/hgnc.py): `src/mcl/sources/hgnc.py`
- [Target normalization](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/normalize/targets.py): `src/mcl/normalize/targets.py`
- [Normalized targets](https://github.com/bogdanmaslyuk/master-cancer-landscape/tree/main/data/processed): `data/processed`
- [Open Targets access](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/sources/opentargets.py): `src/mcl/sources/opentargets.py`
- [Disease mapping](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/normalize/disease_mapping.py): `src/mcl/normalize/disease_mapping.py`
- [DepMap synchronization](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/sources/depmap_sync.py): `src/mcl/sources/depmap_sync.py`
- [DepMap file access](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/sources/depmap.py): `src/mcl/sources/depmap.py`

### Evidence analysis

- [Open Targets evidence](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/analysis/opentargets.py): `src/mcl/analysis/opentargets.py`
- [Association evidence](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/data/processed/opentargets_associations.tsv): `data/processed/opentargets_associations.tsv`
- [Context analysis](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/analysis/depmap.py): `src/mcl/analysis/depmap.py`
- [Context evidence models](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/models/depmap.py): `src/mcl/models/depmap.py`
- [Context evidence](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/data/processed/depmap_evidence.tsv): `data/processed/depmap_evidence.tsv`
- [Genome-wide analysis](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/analysis/depmap_genomewide.py): `src/mcl/analysis/depmap_genomewide.py`
- [KRAS sensitivity](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/analysis/depmap.py): `src/mcl/analysis/depmap.py`

### QC and provenance

- [Evidence quality checks](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/qc/depmap.py): `src/mcl/qc/depmap.py`
- [Open Targets checks](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/qc/opentargets.py): `src/mcl/qc/opentargets.py`
- [Target identity checks](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/qc/targets.py): `src/mcl/qc/targets.py`
- [QC records](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/models/qc.py): `src/mcl/models/qc.py`
- [Provenance records](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/models/provenance.py): `src/mcl/models/provenance.py`

### Results and exploration

- [Run manifests](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/reporting.py): `src/mcl/reporting.py`
- [DepMap explorer](https://github.com/bogdanmaslyuk/master-cancer-landscape/blob/main/src/mcl/visualization/depmap_explorer.py): `src/mcl/visualization/depmap_explorer.py`
- [QC and reports](https://github.com/bogdanmaslyuk/master-cancer-landscape/tree/main/outputs): `outputs`

### Other components

- **Pipeline user**
- **Open Targets API**
- [Pinned DepMap release](https://github.com/bogdanmaslyuk/master-cancer-landscape/tree/main/data): `data`

## Connections

- Pipeline user → Command interface: runs commands (evidence: `README.md`)
- Command interface → Project configuration: loads settings (evidence: `src/mcl/cli.py`)
- Command interface → HGNC snapshots: fetches snapshots (evidence: `src/mcl/cli.py`)
- Command interface → Target normalization: runs normalization (evidence: `src/mcl/cli.py`)
- Target normalization → HGNC snapshots: resolves identities (evidence: `src/mcl/normalize/targets.py`)
- Target normalization → Normalized targets: writes identifiers (evidence: `README.md`)
- Command interface → Disease mapping: validates mappings (evidence: `src/mcl/cli.py`)
- Command interface → Open Targets evidence: runs evidence fetch (evidence: `src/mcl/cli.py`)
- Open Targets evidence → Open Targets access: queries platform (evidence: `src/mcl/analysis/opentargets.py`)
- Open Targets evidence → Disease mapping: resolves diseases (evidence: `src/mcl/analysis/opentargets.py`)
- Open Targets access → Open Targets API: sends requests
- Open Targets evidence → Association evidence: writes associations (evidence: `README.md`)
- Command interface → DepMap synchronization: runs synchronization (evidence: `src/mcl/cli.py`)
- DepMap synchronization → DepMap file access: checks local files (evidence: `src/mcl/sources/depmap_sync.py`)
- DepMap file access → Pinned DepMap release: reads release files (evidence: `README.md`)
- Command interface → Context analysis: runs context analysis (evidence: `src/mcl/cli.py`)
- Context analysis → DepMap file access: loads inputs (evidence: `src/mcl/analysis/depmap.py`)
- Context analysis → Context evidence models: creates evidence (evidence: `src/mcl/analysis/depmap.py`)
- Context analysis → Context evidence: writes results (evidence: `README.md`)
- Command interface → Genome-wide analysis: runs genome-wide analysis (evidence: `src/mcl/cli.py`)
- Genome-wide analysis → DepMap file access: loads matrix inputs (evidence: `src/mcl/analysis/depmap_genomewide.py`)
- Command interface → KRAS sensitivity: runs KRAS sensitivity (evidence: `src/mcl/cli.py`)
- KRAS sensitivity → DepMap file access: loads inputs (evidence: `src/mcl/analysis/depmap.py`)
- Command interface → Evidence quality checks: checks DepMap evidence (evidence: `src/mcl/cli.py`)
- Evidence quality checks → Context evidence models: validates records (evidence: `src/mcl/qc/depmap.py`)
- Command interface → Open Targets checks: checks associations (evidence: `src/mcl/cli.py`)
- Command interface → Target identity checks: checks identities (evidence: `src/mcl/cli.py`)
- Evidence quality checks → QC records: emits findings (evidence: `src/mcl/qc/depmap.py`)
- Open Targets checks → QC records: emits findings (evidence: `src/mcl/qc/opentargets.py`)
- Target identity checks → QC records: emits findings (evidence: `src/mcl/qc/targets.py`)
- Command interface → Run manifests: writes manifests (evidence: `README.md`)
- Command interface → DepMap explorer: creates explorer (evidence: `README.md`)
- Run manifests → QC and reports: writes reports (evidence: `README.md`)
- DepMap explorer → QC and reports: writes explorer pages (evidence: `README.md`)
