How rainingsherry/topogate works
TopoGate is a research codebase for comparing graph-aware clustering methods on caller-supplied datasets. The principal workflow is to select a version and configuration, provide data, run a variant’s preprocessing and graph/model training, then inspect clustering metrics and audit artifacts. The repository also contains independent mechanism and validation studies. The tree and README establish the broader variant portfolio; sampled excerpts support only some internal call relationships, so uncertain wiring is omitted.
Main entry points: V11 Version runners · ACCG ACCG runners · V26 V26 runners · scMAE_family.py scMAE data prep
Components 21
Inputs and backbone
- scMAE backbone
methods/NeighborMix_scMAE/model.py - scMAE data prep
methods/DeepLearning/scMAE_family.py
TopoGate variants
- Early gate variants
methods/TopoGate/learnable_gate - Reliable graph
methods/TopoGate/v10_reliable_graph - V11 counterfactual
methods/TopoGate/V11 - V15 counterfactual
methods/TopoGate/V15_counterfactual_gate - V17 relation native
methods/TopoGate/V17_topology_native - V18–V22 variants
methods/TopoGate/V18_scmae_latent_gate - ACCG constrained gate
methods/TopoGate/ACCG_action_constrained_gate - V26 support oracle
methods/TopoGate/V26_support_oracle
Studies and protocols
- Mechanism studies
methods/TopoGate/V25_systematic_mechanism_study - Validation studies
scripts/support_target_validation_probe - Corruption studies
scripts/sparse_corruption_principle_probe - Representation study
scripts/representation_consumer_probe
Experiment evaluation
- Version runners
scripts/V11 - ACCG runners
scripts/ACCG - V26 runners
scripts/V26 - Curated results
result/final_results
Other components
- Researcher
- Input dataset
- Run outputs
Connections 21
- Researcher → Input dataset: supplies
- Researcher → Version runners: selects and runs
- Input dataset → scMAE data prep: loads and prepares
- scMAE data prep → scMAE backbone: provides inputs
- Version runners → V11 counterfactual: runs variant
- Version runners → Reliable graph: runs variant
- Version runners → V17 relation native: runs variant
- Version runners → V15 counterfactual: runs variant
- Version runners → V18–V22 variants: runs variant
- Version runners → Early gate variants: runs variant
- V11 counterfactual → scMAE backbone: uses backbone
- ACCG runners → ACCG constrained gate: runs protocol
- V26 runners → V26 support oracle: runs study
- Mechanism studies → V18–V22 variants: reuses V21 primitives
- ACCG constrained gate → Mechanism studies: inherits matched protocol
- Researcher → Validation studies: runs preflight
- Researcher → Corruption studies: runs study
- Researcher → Representation study: runs study
- Version runners → Curated results: summarizes results
- ACCG runners → Run outputs: writes artifacts
- V26 runners → Run outputs: writes summaries