# iarsana/trf-isoeqtl-sqtl-analysis architecture

> Architecture diagram of the GitHub repository iarsana/trf-isoeqtl-sqtl-analysis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/iarsana/trf-isoeqtl-sqtl-analysis
- Repository: https://github.com/iarsana/trf-isoeqtl-sqtl-analysis

## Overview

PCa-tRFQTL is a bioinformatics pipeline for integrating prostate-cancer GWAS with tRF-QTL and transcript isoform/splicing-QTL evidence. Its principal workflow validates and standardizes genomic inputs, harmonizes identifiers and coordinates, finds overlapping candidate signals, evaluates LD and colocalization, then interprets candidates and assesses clinical or independent-data validation. The README documents the broad research stages; source-index references and excerpts support selected internal calls. Many stage-specific implementations were not sampled, so their detailed wiring is intentionally omitted.

Main entry points: [`pcatRFQTL/src/pcatrfqtl/standardization/runners/standardize.py`](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/standardization/runners/standardize.py) (Data standardization), [`pcatRFQTL/src/pcatrfqtl/validation`](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/tree/main/pcatRFQTL/src/pcatrfqtl/validation) (Input validation), [`pcatRFQTL/src/pcatrfqtl/harmonization/runners/harmonize.py`](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/harmonization/runners/harmonize.py) (Schema harmonization), [`pcatRFQTL/src/pcatrfqtl/analysis/m5/cached_pairwise_ld_provider.py`](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m5/cached_pairwise_ld_provider.py) (Cached LD provider)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_prep["Data preparation"]
  node_ingest["Dataset ingestion"]
  node_validate["Input validation"]
  node_gwas_validator["GWAS validator<br/>[gwas.py]"]
  node_standardize["Data standardization<br/>[standardize.py]"]
  node_standardize_common["Standardization rules<br/>[common.py]"]
  node_std_gwas["GWAS standardization<br/>[gwas.py]"]
  node_std_trfqtl["tRF-QTL standardization<br/>[trfqtl.py]"]
  node_std_moradi["Moradi QTL standardization<br/>[moradi_qtl.py]"]
  node_harmonize["Schema harmonization<br/>[harmonize.py]"]
  node_feature_harm["Feature harmonization<br/>[features.py]"]
end

subgraph group_signals["Signal integration"]
  node_overlap["GWAS-QTL overlap<br/>[overlap.py]"]
  node_moradi_evidence["Evidence summaries"]
  node_loci["GWAS locus retrieval"]
  node_retrieve_runner["Locus retrieval runner"]
  node_lead_coord["Lead coordinates"]
  node_ld_bridge["LD integration"]
  node_ld_runner["Pairwise LD runner"]
  node_ld_cached["Cached LD provider"]
  node_ldlink["LDlink provider"]
  node_ld_cache[("Pairwise LD cache")]
  node_coloc["Colocalization assessment"]
end

subgraph group_interpret["Biological interpretation"]
  node_candidate["Candidate prioritization"]
  node_feature_map["Regulatory feature mapping"]
  node_feature_runner["Feature mapping runner"]
  node_gene_pathway["Gene and pathway analysis"]
end

subgraph group_validation["Validation readiness"]
  node_clinical["Clinical validation<br/>[clinical_cohort.py]"]
  node_external_trf["External tRF evidence"]
  node_integrated["Integrated evidence"]
  node_fragment_runner["Fragment interpretation runner"]
  node_fragment["Fragment interpretation"]
end

subgraph group_core["Shared runtime"]
  node_parquet["Parquet I/O<br/>[parquet.py]"]
  node_logger["Pipeline logging<br/>[logger.py]"]
end

node_sources(("Genomic datasets"))

node_sources -->|"provides data"| node_ingest
node_ingest -->|"supplies inputs"| node_validate
node_validate -->|"validated data"| node_standardize
node_standardize -->|"standardized data"| node_harmonize
node_standardize -->|"standardizes GWAS"| node_std_gwas
node_standardize -->|"standardizes tRF-QTL"| node_std_trfqtl
node_standardize -->|"standardizes QTL"| node_std_moradi
node_std_gwas -->|"uses rules"| node_standardize_common
node_std_trfqtl -->|"uses rules"| node_standardize_common
node_std_moradi -->|"uses rules"| node_standardize_common
node_validate -.->|"validates GWAS"| node_gwas_validator
node_harmonize -->|"harmonizes features"| node_feature_harm
node_harmonize -->|"harmonized inputs"| node_overlap
node_overlap -->|"overlap evidence"| node_moradi_evidence
node_moradi_evidence -.->|"candidate signals"| node_loci
node_retrieve_runner -->|"retrieves loci"| node_loci
node_retrieve_runner -->|"resolves coordinates"| node_lead_coord
node_loci -.->|"locus evidence"| node_ld_bridge
node_ld_runner -->|"queries pairs"| node_ld_cached
node_ld_cached -->|"uses cache"| node_ld_cache
node_ld_cached -->|"delegates queries"| node_ldlink
node_ld_bridge -->|"supports assessment"| node_coloc
node_coloc -->|"prioritized loci"| node_candidate
node_candidate -.->|"candidate loci"| node_feature_runner
node_feature_runner -->|"maps features"| node_feature_map
node_feature_map -->|"functional evidence"| node_gene_pathway
node_gene_pathway -->|"candidate findings"| node_clinical
node_clinical -.->|"validation evidence"| node_external_trf
node_external_trf -->|"external evidence"| node_integrated
node_fragment_runner -->|"interprets artifacts"| node_fragment
node_fragment_runner -->|"reads and writes"| node_parquet

click node_ingest "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/tree/main/pcatRFQTL/src/pcatrfqtl/ingestion"
click node_validate "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/tree/main/pcatRFQTL/src/pcatrfqtl/validation"
click node_gwas_validator "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/validation/validators/gwas.py"
click node_standardize "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/standardization/runners/standardize.py"
click node_standardize_common "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/standardization/common.py"
click node_std_gwas "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/standardization/gwas.py"
click node_std_trfqtl "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/standardization/trfqtl.py"
click node_std_moradi "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/standardization/moradi_qtl.py"
click node_harmonize "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/harmonization/runners/harmonize.py"
click node_feature_harm "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/harmonization/features.py"
click node_overlap "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m3/overlap.py"
click node_moradi_evidence "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m4/evidence_summary.py"
click node_loci "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m5/gwas_locus_retrieval.py"
click node_retrieve_runner "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m5/runners/retrieve_gwas_loci.py"
click node_lead_coord "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m5/gwas_lead_coordinate.py"
click node_ld_bridge "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m5/disease_regulatory_pairwise_ld.py"
click node_ld_runner "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m5/runners/query_disease_regulatory_pairwise_ld.py"
click node_ld_cached "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m5/cached_pairwise_ld_provider.py"
click node_ldlink "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m5/ldlink_pairwise_provider.py"
click node_ld_cache "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m5/pairwise_ld_cache.py"
click node_coloc "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/tree/main/pcatRFQTL/src/pcatrfqtl/analysis/m5"
click node_candidate "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m6/candidate_prioritization.py"
click node_feature_map "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m6/regulatory_feature_mapping.py"
click node_feature_runner "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m6/runners/map_regulatory_features.py"
click node_gene_pathway "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/tree/main/pcatRFQTL/src/pcatrfqtl/analysis/m6"
click node_clinical "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m7/clinical_cohort.py"
click node_external_trf "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m7/external_trf_raw_read_acquisition.py"
click node_integrated "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m7/integrated_evidence_resolution.py"
click node_fragment_runner "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m7/runners/interpret_candidate_fragment.py"
click node_fragment "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m7/candidate_fragment_interpretation.py"
click node_parquet "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/io/parquet.py"
click node_logger "https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/logging/logger.py"

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_ingest,node_validate,node_gwas_validator,node_standardize,node_standardize_common,node_std_gwas,node_std_trfqtl,node_std_moradi,node_harmonize,node_feature_harm toneBlue
class node_overlap,node_moradi_evidence,node_loci,node_retrieve_runner,node_lead_coord,node_ld_bridge,node_ld_runner,node_ld_cached,node_ldlink,node_ld_cache,node_coloc toneAmber
class node_candidate,node_feature_map,node_feature_runner,node_gene_pathway toneMint
class node_clinical,node_external_trf,node_integrated,node_fragment_runner,node_fragment toneRose
class node_parquet,node_logger,node_sources toneIndigo
```

## Components

### Data preparation

- [Dataset ingestion](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/tree/main/pcatRFQTL/src/pcatrfqtl/ingestion): `pcatRFQTL/src/pcatrfqtl/ingestion`
- [Input validation](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/tree/main/pcatRFQTL/src/pcatrfqtl/validation): `pcatRFQTL/src/pcatrfqtl/validation`
- [GWAS validator](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/validation/validators/gwas.py): `pcatRFQTL/src/pcatrfqtl/validation/validators/gwas.py`
- [Data standardization](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/standardization/runners/standardize.py): `pcatRFQTL/src/pcatrfqtl/standardization/runners/standardize.py`
- [Standardization rules](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/standardization/common.py): `pcatRFQTL/src/pcatrfqtl/standardization/common.py`
- [GWAS standardization](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/standardization/gwas.py): `pcatRFQTL/src/pcatrfqtl/standardization/gwas.py`
- [tRF-QTL standardization](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/standardization/trfqtl.py): `pcatRFQTL/src/pcatrfqtl/standardization/trfqtl.py`
- [Moradi QTL standardization](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/standardization/moradi_qtl.py): `pcatRFQTL/src/pcatrfqtl/standardization/moradi_qtl.py`
- [Schema harmonization](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/harmonization/runners/harmonize.py): `pcatRFQTL/src/pcatrfqtl/harmonization/runners/harmonize.py`
- [Feature harmonization](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/harmonization/features.py): `pcatRFQTL/src/pcatrfqtl/harmonization/features.py`

### Signal integration

- [GWAS-QTL overlap](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m3/overlap.py): `pcatRFQTL/src/pcatrfqtl/analysis/m3/overlap.py`
- [Evidence summaries](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m4/evidence_summary.py): `pcatRFQTL/src/pcatrfqtl/analysis/m4/evidence_summary.py`
- [GWAS locus retrieval](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m5/gwas_locus_retrieval.py): `pcatRFQTL/src/pcatrfqtl/analysis/m5/gwas_locus_retrieval.py`
- [Locus retrieval runner](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m5/runners/retrieve_gwas_loci.py): `pcatRFQTL/src/pcatrfqtl/analysis/m5/runners/retrieve_gwas_loci.py`
- [Lead coordinates](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m5/gwas_lead_coordinate.py): `pcatRFQTL/src/pcatrfqtl/analysis/m5/gwas_lead_coordinate.py`
- [LD integration](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m5/disease_regulatory_pairwise_ld.py): `pcatRFQTL/src/pcatrfqtl/analysis/m5/disease_regulatory_pairwise_ld.py`
- [Pairwise LD runner](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m5/runners/query_disease_regulatory_pairwise_ld.py): `pcatRFQTL/src/pcatrfqtl/analysis/m5/runners/query_disease_regulatory_pairwise_ld.py`
- [Cached LD provider](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m5/cached_pairwise_ld_provider.py): `pcatRFQTL/src/pcatrfqtl/analysis/m5/cached_pairwise_ld_provider.py`
- [LDlink provider](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m5/ldlink_pairwise_provider.py): `pcatRFQTL/src/pcatrfqtl/analysis/m5/ldlink_pairwise_provider.py`
- [Pairwise LD cache](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m5/pairwise_ld_cache.py): `pcatRFQTL/src/pcatrfqtl/analysis/m5/pairwise_ld_cache.py`
- [Colocalization assessment](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/tree/main/pcatRFQTL/src/pcatrfqtl/analysis/m5): `pcatRFQTL/src/pcatrfqtl/analysis/m5`

### Biological interpretation

- [Candidate prioritization](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m6/candidate_prioritization.py): `pcatRFQTL/src/pcatrfqtl/analysis/m6/candidate_prioritization.py`
- [Regulatory feature mapping](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m6/regulatory_feature_mapping.py): `pcatRFQTL/src/pcatrfqtl/analysis/m6/regulatory_feature_mapping.py`
- [Feature mapping runner](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m6/runners/map_regulatory_features.py): `pcatRFQTL/src/pcatrfqtl/analysis/m6/runners/map_regulatory_features.py`
- [Gene and pathway analysis](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/tree/main/pcatRFQTL/src/pcatrfqtl/analysis/m6): `pcatRFQTL/src/pcatrfqtl/analysis/m6`

### Validation readiness

- [Clinical validation](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m7/clinical_cohort.py): `pcatRFQTL/src/pcatrfqtl/analysis/m7/clinical_cohort.py`
- [External tRF evidence](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m7/external_trf_raw_read_acquisition.py): `pcatRFQTL/src/pcatrfqtl/analysis/m7/external_trf_raw_read_acquisition.py`
- [Integrated evidence](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m7/integrated_evidence_resolution.py): `pcatRFQTL/src/pcatrfqtl/analysis/m7/integrated_evidence_resolution.py`
- [Fragment interpretation runner](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m7/runners/interpret_candidate_fragment.py): `pcatRFQTL/src/pcatrfqtl/analysis/m7/runners/interpret_candidate_fragment.py`
- [Fragment interpretation](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/analysis/m7/candidate_fragment_interpretation.py): `pcatRFQTL/src/pcatrfqtl/analysis/m7/candidate_fragment_interpretation.py`

### Shared runtime

- [Parquet I/O](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/io/parquet.py): `pcatRFQTL/src/pcatrfqtl/io/parquet.py`
- [Pipeline logging](https://github.com/iarsana/trf-isoeqtl-sqtl-analysis/blob/main/pcatRFQTL/src/pcatrfqtl/logging/logger.py): `pcatRFQTL/src/pcatrfqtl/logging/logger.py`

### Other components

- **Genomic datasets**

## Connections

- Genomic datasets → Dataset ingestion: provides data
- Dataset ingestion → Input validation: supplies inputs
- Input validation → Data standardization: validated data
- Data standardization → Schema harmonization: standardized data
- Data standardization → GWAS standardization: standardizes GWAS (evidence: `pcatRFQTL/src/pcatrfqtl/standardization/runners/standardize.py`)
- Data standardization → tRF-QTL standardization: standardizes tRF-QTL (evidence: `pcatRFQTL/src/pcatrfqtl/standardization/runners/standardize.py`)
- Data standardization → Moradi QTL standardization: standardizes QTL (evidence: `pcatRFQTL/src/pcatrfqtl/standardization/runners/standardize.py`)
- GWAS standardization → Standardization rules: uses rules (evidence: `pcatRFQTL/src/pcatrfqtl/standardization/gwas.py`)
- tRF-QTL standardization → Standardization rules: uses rules (evidence: `pcatRFQTL/src/pcatrfqtl/standardization/trfqtl.py`)
- Moradi QTL standardization → Standardization rules: uses rules (evidence: `pcatRFQTL/src/pcatrfqtl/standardization/moradi_qtl.py`)
- Input validation → GWAS validator: validates GWAS
- Schema harmonization → Feature harmonization: harmonizes features (evidence: `pcatRFQTL/src/pcatrfqtl/harmonization/runners/harmonize.py`)
- Schema harmonization → GWAS-QTL overlap: harmonized inputs
- GWAS-QTL overlap → Evidence summaries: overlap evidence
- Evidence summaries → GWAS locus retrieval: candidate signals
- Locus retrieval runner → GWAS locus retrieval: retrieves loci (evidence: `pcatRFQTL/src/pcatrfqtl/analysis/m5/runners/retrieve_gwas_loci.py`)
- Locus retrieval runner → Lead coordinates: resolves coordinates (evidence: `pcatRFQTL/src/pcatrfqtl/analysis/m5/runners/retrieve_gwas_loci.py`)
- GWAS locus retrieval → LD integration: locus evidence
- Pairwise LD runner → Cached LD provider: queries pairs (evidence: `pcatRFQTL/src/pcatrfqtl/analysis/m5/runners/query_disease_regulatory_pairwise_ld.py`)
- Cached LD provider → Pairwise LD cache: uses cache (evidence: `pcatRFQTL/src/pcatrfqtl/analysis/m5/cached_pairwise_ld_provider.py`)
- Cached LD provider → LDlink provider: delegates queries (evidence: `pcatRFQTL/src/pcatrfqtl/analysis/m5/cached_pairwise_ld_provider.py`)
- LD integration → Colocalization assessment: supports assessment (evidence: `pcatRFQTL/src/pcatrfqtl/analysis/m5/runners/query_disease_regulatory_pairwise_ld.py`)
- Colocalization assessment → Candidate prioritization: prioritized loci
- Candidate prioritization → Feature mapping runner: candidate loci
- Feature mapping runner → Regulatory feature mapping: maps features (evidence: `pcatRFQTL/src/pcatrfqtl/analysis/m6/runners/map_regulatory_features.py`)
- Regulatory feature mapping → Gene and pathway analysis: functional evidence (evidence: `pcatRFQTL/src/pcatrfqtl/analysis/m6/runners/map_regulatory_features.py`)
- Gene and pathway analysis → Clinical validation: candidate findings
- Clinical validation → External tRF evidence: validation evidence
- External tRF evidence → Integrated evidence: external evidence
- Fragment interpretation runner → Fragment interpretation: interprets artifacts (evidence: `pcatRFQTL/src/pcatrfqtl/analysis/m7/runners/interpret_candidate_fragment.py`)
- Fragment interpretation runner → Parquet I/O: reads and writes (evidence: `pcatRFQTL/src/pcatrfqtl/analysis/m7/runners/interpret_candidate_fragment.py`)
