# muhammadmapkar/chip-tess architecture

> Architecture diagram of the GitHub repository muhammadmapkar/chip-tess, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/muhammadmapkar/chip-tess
- Repository: https://github.com/muhammadmapkar/chip-tess

## Overview

This is a research workflow for testing whether conformal host-star shortlists cover the injected transit source in real TESS pixel images. The documented path is pixel data and candidate stars, transit injection, CNN scores, conformal shortlists, then coverage analysis by SNR, crowding, and neighbouring-field group. The repository also preserves an independent synthetic track and paper release data. The audit implementation is explicitly absent; links to unsampled stages below reflect README documentation, not inspected code.

Main entry points: [`track2_real`](https://github.com/muhammadmapkar/chip-tess/tree/main/track2_real) (Coverage audit), [`track2_real/src`](https://github.com/muhammadmapkar/chip-tess/tree/main/track2_real/src) (CNN star scores), [`release`](https://github.com/muhammadmapkar/chip-tess/tree/main/release) (Audit release data), [`track2_real/src/pixels.py`](https://github.com/muhammadmapkar/chip-tess/blob/main/track2_real/src/pixels.py) (Real-pixel injection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Inputs and injection"]
  node_real_injection["Real-pixel injection<br/>[pixels.py]"]
  node_pixel_features["Difference images<br/>[pixels.py]"]
  node_synthetic_track["Synthetic track"]
end

subgraph group_prediction["Host-star prediction"]
  node_cnn_scores["CNN star scores"]
  node_split_conformal["Split conformal<br/>[conformal.py]"]
  node_mondrian["Crowding calibration<br/>[conformal.py]"]
  node_shortlist["Star shortlist"]
end

subgraph group_evaluation["Coverage evaluation"]
  node_coverage_audit["Coverage audit"]
  node_snr_analysis["SNR analysis"]
  node_crowding_analysis["Crowding analysis"]
  node_field_analysis["Field-group analysis"]
end

subgraph group_release["Research release"]
  node_paper_data[("Audit release data")]
  node_dip_scores["Dip scores<br/>[dip_scores.csv]"]
  node_groups_data["Field groups<br/>[groups.csv]"]
end

node_researcher(("Researcher"))
node_tess_pixels[("TESS pixel images")]
node_candidate_stars[("Candidate stars")]

node_tess_pixels -->|"supplies pixels"| node_real_injection
node_candidate_stars -->|"defines candidates"| node_real_injection
node_real_injection -->|"forms differences"| node_pixel_features
node_pixel_features -->|"scores candidates"| node_cnn_scores
node_cnn_scores -->|"calibrates scores"| node_split_conformal
node_cnn_scores -->|"calibrates by crowding"| node_mondrian
node_split_conformal -->|"forms shortlist"| node_shortlist
node_mondrian -->|"forms shortlist"| node_shortlist
node_shortlist -->|"tests coverage"| node_coverage_audit
node_coverage_audit -->|"reports by SNR"| node_snr_analysis
node_coverage_audit -->|"reports by crowding"| node_crowding_analysis
node_coverage_audit -->|"reports by field group"| node_field_analysis
node_researcher -->|"runs independent track"| node_synthetic_track
node_coverage_audit -->|"releases results"| node_paper_data
node_paper_data -->|"includes"| node_dip_scores
node_paper_data -->|"includes"| node_groups_data

click node_real_injection "https://github.com/muhammadmapkar/chip-tess/blob/main/track2_real/src/pixels.py"
click node_pixel_features "https://github.com/muhammadmapkar/chip-tess/blob/main/track2_real/src/pixels.py"
click node_synthetic_track "https://github.com/muhammadmapkar/chip-tess/tree/main/track1_synthetic/src"
click node_cnn_scores "https://github.com/muhammadmapkar/chip-tess/tree/main/track2_real/src"
click node_split_conformal "https://github.com/muhammadmapkar/chip-tess/blob/main/track2_real/src/conformal.py"
click node_mondrian "https://github.com/muhammadmapkar/chip-tess/blob/main/track2_real/src/conformal.py"
click node_shortlist "https://github.com/muhammadmapkar/chip-tess/tree/main/track2_real/src"
click node_coverage_audit "https://github.com/muhammadmapkar/chip-tess/tree/main/track2_real"
click node_snr_analysis "https://github.com/muhammadmapkar/chip-tess/tree/main/track2_real"
click node_crowding_analysis "https://github.com/muhammadmapkar/chip-tess/tree/main/track2_real"
click node_field_analysis "https://github.com/muhammadmapkar/chip-tess/tree/main/track2_real"
click node_paper_data "https://github.com/muhammadmapkar/chip-tess/tree/main/release"
click node_dip_scores "https://github.com/muhammadmapkar/chip-tess/blob/main/release/dip_scores.csv"
click node_groups_data "https://github.com/muhammadmapkar/chip-tess/blob/main/release/groups.csv"

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_real_injection,node_pixel_features,node_synthetic_track toneBlue
class node_cnn_scores,node_split_conformal,node_mondrian,node_shortlist,node_tess_pixels,node_candidate_stars toneAmber
class node_coverage_audit,node_snr_analysis,node_crowding_analysis,node_field_analysis toneMint
class node_paper_data,node_dip_scores,node_groups_data toneRose
class node_researcher toneIndigo
```

## Components

### Inputs and injection

- [Real-pixel injection](https://github.com/muhammadmapkar/chip-tess/blob/main/track2_real/src/pixels.py): `track2_real/src/pixels.py`
- [Difference images](https://github.com/muhammadmapkar/chip-tess/blob/main/track2_real/src/pixels.py): `track2_real/src/pixels.py`
- [Synthetic track](https://github.com/muhammadmapkar/chip-tess/tree/main/track1_synthetic/src): `track1_synthetic/src`

### Host-star prediction

- [CNN star scores](https://github.com/muhammadmapkar/chip-tess/tree/main/track2_real/src): `track2_real/src`
- [Split conformal](https://github.com/muhammadmapkar/chip-tess/blob/main/track2_real/src/conformal.py): `track2_real/src/conformal.py`
- [Crowding calibration](https://github.com/muhammadmapkar/chip-tess/blob/main/track2_real/src/conformal.py): `track2_real/src/conformal.py`
- [Star shortlist](https://github.com/muhammadmapkar/chip-tess/tree/main/track2_real/src): `track2_real/src`

### Coverage evaluation

- [Coverage audit](https://github.com/muhammadmapkar/chip-tess/tree/main/track2_real): `track2_real`
- [SNR analysis](https://github.com/muhammadmapkar/chip-tess/tree/main/track2_real): `track2_real`
- [Crowding analysis](https://github.com/muhammadmapkar/chip-tess/tree/main/track2_real): `track2_real`
- [Field-group analysis](https://github.com/muhammadmapkar/chip-tess/tree/main/track2_real): `track2_real`

### Research release

- [Audit release data](https://github.com/muhammadmapkar/chip-tess/tree/main/release): `release`
- [Dip scores](https://github.com/muhammadmapkar/chip-tess/blob/main/release/dip_scores.csv): `release/dip_scores.csv`
- [Field groups](https://github.com/muhammadmapkar/chip-tess/blob/main/release/groups.csv): `release/groups.csv`

### Other components

- **Researcher**
- **TESS pixel images**
- **Candidate stars**

## Connections

- TESS pixel images → Real-pixel injection: supplies pixels (evidence: `README.md`)
- Candidate stars → Real-pixel injection: defines candidates (evidence: `README.md`)
- Real-pixel injection → Difference images: forms differences (evidence: `track2_real/src/pixels.py`)
- Difference images → CNN star scores: scores candidates (evidence: `README.md`)
- CNN star scores → Split conformal: calibrates scores (evidence: `README.md`)
- CNN star scores → Crowding calibration: calibrates by crowding (evidence: `README.md`)
- Split conformal → Star shortlist: forms shortlist (evidence: `README.md`)
- Crowding calibration → Star shortlist: forms shortlist (evidence: `README.md`)
- Star shortlist → Coverage audit: tests coverage (evidence: `README.md`)
- Coverage audit → SNR analysis: reports by SNR (evidence: `README.md`)
- Coverage audit → Crowding analysis: reports by crowding (evidence: `README.md`)
- Coverage audit → Field-group analysis: reports by field group (evidence: `README.md`)
- Researcher → Synthetic track: runs independent track (evidence: `README.md`)
- Coverage audit → Audit release data: releases results (evidence: `README.md`)
- Audit release data → Dip scores: includes (evidence: `README.md`)
- Audit release data → Field groups: includes (evidence: `README.md`)
