# 3fon3fonov/exostriker architecture

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

- Interactive diagram: https://gitdiagram.com/3fon3fonov/exostriker
- Repository: https://github.com/3fon3fonov/exostriker

## Overview

Exo-Striker is a desktop and importable exoplanet-analysis application. Users load RV, transit, and related observations, search for signals, fit orbital and activity models, inspect inference results, and run dynamical or stability analyses. Its GUI and scientific runtime span legacy RV fitting, native joint modeling, samplers, astrometry, and plotting. The README documents several capabilities whose GUI wiring is not shown in the excerpts; those connections are omitted rather than inferred. The graph emphasizes documented capabilities and source-index-supported dependencies.

Main entry points: [`exostriker/lib/native_inference.py`](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/native_inference.py) (Native Inference), [`exostriker/lib/native_joint_fit.py`](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/native_joint_fit.py) (Joint Fitting), [`exostriker/lib/RV_mod/__init__.py`](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/RV_mod/__init__.py) (RV Fitting), [`exostriker/lib/activity_gp.py`](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/activity_gp.py) (Activity GP)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_gui["Desktop GUI<br/>[gui.py]"]
  node_entry["CLI Entry<br/>[__main__.py]"]
end

subgraph group_search["Signal Search"]
  node_tls["Transit Search<br/>[main.py]"]
  node_periodogram["RV Periodograms<br/>[gls.py]"]
end

subgraph group_model["Modeling and Inference"]
  node_rvfit["RV Fitting<br/>[__init__.py]"]
  node_nativefit["Joint Fitting"]
  node_nativeinfer["Native Inference"]
  node_likelihood["Native Likelihood"]
  node_transitmodel["Transit Model"]
  node_activity["Activity GP<br/>[activity_gp.py]"]
  node_magnetic["Magnetic Cycle<br/>[magnetic_cycle.py]"]
  node_mass["Mass Coordinates"]
  node_samplers["Sampling Engines<br/>[CustomSampler.py]"]
end

subgraph group_analysis["Dynamics and Astrometry"]
  node_astrometry["ExTRA Astrometry"]
  node_stellar["Stellar Parameters"]
  node_dynamics["N-body Analysis<br/>[__init__.py]"]
end

subgraph group_results["Results and Visualization"]
  node_results["Model Results"]
  node_posterior["Posterior Display"]
  node_plots["Interactive Plots<br/>[rvs.py]"]
end

node_user(("Astronomer"))

node_user -.->|"uses"| node_gui
node_entry -->|"launches"| node_gui
node_rvfit -->|"uses"| node_activity
node_rvfit -->|"uses"| node_magnetic
node_rvfit -->|"delegates"| node_nativeinfer
node_nativefit -->|"uses"| node_nativeinfer
node_nativefit -->|"uses"| node_likelihood
node_nativefit -->|"uses"| node_transitmodel
node_nativefit -->|"uses"| node_activity
node_nativefit -->|"uses"| node_magnetic
node_nativefit -->|"uses"| node_mass
node_nativeinfer -->|"evaluates"| node_likelihood
node_nativeinfer -->|"uses"| node_transitmodel
node_nativeinfer -->|"uses"| node_activity
node_nativeinfer -->|"uses"| node_magnetic
node_nativeinfer -->|"synchronizes"| node_stellar
node_nativeinfer -->|"synchronizes"| node_mass
node_likelihood -->|"uses"| node_transitmodel
node_activity -->|"uses"| node_magnetic
node_stellar -->|"uses"| node_dynamics
node_nativeinfer -->|"builds"| node_results
node_samplers -->|"evaluates posterior"| node_rvfit
node_user -.->|"searches transits"| node_tls
node_user -.->|"searches signals"| node_periodogram
node_user -.->|"fits astrometry"| node_astrometry
node_user -.->|"checks stability"| node_dynamics
node_user -.->|"inspects results"| node_posterior
node_user -.->|"explores plots"| node_plots

click node_gui "https://github.com/3fon3fonov/exostriker/blob/main/exostriker/gui.py"
click node_entry "https://github.com/3fon3fonov/exostriker/blob/main/exostriker/__main__.py"
click node_rvfit "https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/RV_mod/__init__.py"
click node_nativefit "https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/native_joint_fit.py"
click node_nativeinfer "https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/native_inference.py"
click node_likelihood "https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/native_likelihood.py"
click node_transitmodel "https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/native_transit_model.py"
click node_activity "https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/activity_gp.py"
click node_magnetic "https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/magnetic_cycle.py"
click node_mass "https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/mass_parameterization.py"
click node_tls "https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/transitleastsquares_ES/main.py"
click node_periodogram "https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/gls.py"
click node_astrometry "https://github.com/3fon3fonov/exostriker/tree/main/exostriker/lib/ExTRA"
click node_stellar "https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/stellar_parameters.py"
click node_dynamics "https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/RV_mod/rvmod/__init__.py"
click node_results "https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/native_model_results.py"
click node_posterior "https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/posterior_display.py"
click node_plots "https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/rvs.py"
click node_samplers "https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/RV_mod/CustomSampler.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_gui,node_entry toneBlue
class node_tls,node_periodogram toneAmber
class node_rvfit,node_nativefit,node_nativeinfer,node_likelihood,node_transitmodel,node_activity,node_magnetic,node_mass,node_samplers toneMint
class node_astrometry,node_stellar,node_dynamics toneRose
class node_results,node_posterior,node_plots,node_user toneIndigo
```

## Components

### Application

- [Desktop GUI](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/gui.py): `exostriker/gui.py`
- [CLI Entry](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/__main__.py): `exostriker/__main__.py`

### Signal Search

- [Transit Search](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/transitleastsquares_ES/main.py): `exostriker/lib/transitleastsquares_ES/main.py`
- [RV Periodograms](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/gls.py): `exostriker/lib/gls.py`

### Modeling and Inference

- [RV Fitting](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/RV_mod/__init__.py): `exostriker/lib/RV_mod/__init__.py`
- [Joint Fitting](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/native_joint_fit.py): `exostriker/lib/native_joint_fit.py`
- [Native Inference](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/native_inference.py): `exostriker/lib/native_inference.py`
- [Native Likelihood](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/native_likelihood.py): `exostriker/lib/native_likelihood.py`
- [Transit Model](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/native_transit_model.py): `exostriker/lib/native_transit_model.py`
- [Activity GP](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/activity_gp.py): `exostriker/lib/activity_gp.py`
- [Magnetic Cycle](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/magnetic_cycle.py): `exostriker/lib/magnetic_cycle.py`
- [Mass Coordinates](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/mass_parameterization.py): `exostriker/lib/mass_parameterization.py`
- [Sampling Engines](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/RV_mod/CustomSampler.py): `exostriker/lib/RV_mod/CustomSampler.py`

### Dynamics and Astrometry

- [ExTRA Astrometry](https://github.com/3fon3fonov/exostriker/tree/main/exostriker/lib/ExTRA): `exostriker/lib/ExTRA`
- [Stellar Parameters](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/stellar_parameters.py): `exostriker/lib/stellar_parameters.py`
- [N-body Analysis](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/RV_mod/rvmod/__init__.py): `exostriker/lib/RV_mod/rvmod/__init__.py`

### Results and Visualization

- [Model Results](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/native_model_results.py): `exostriker/lib/native_model_results.py`
- [Posterior Display](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/posterior_display.py): `exostriker/lib/posterior_display.py`
- [Interactive Plots](https://github.com/3fon3fonov/exostriker/blob/main/exostriker/lib/rvs.py): `exostriker/lib/rvs.py`

### Other components

- **Astronomer**

## Connections

- Astronomer → Desktop GUI: uses
- CLI Entry → Desktop GUI: launches (evidence: `exostriker/__main__.py`)
- RV Fitting → Activity GP: uses (evidence: `exostriker/lib/RV_mod/__init__.py`)
- RV Fitting → Magnetic Cycle: uses (evidence: `exostriker/lib/RV_mod/__init__.py`)
- RV Fitting → Native Inference: delegates (evidence: `exostriker/lib/RV_mod/__init__.py`)
- Joint Fitting → Native Inference: uses (evidence: `exostriker/lib/native_joint_fit.py`)
- Joint Fitting → Native Likelihood: uses (evidence: `exostriker/lib/native_joint_fit.py`)
- Joint Fitting → Transit Model: uses (evidence: `exostriker/lib/native_joint_fit.py`)
- Joint Fitting → Activity GP: uses (evidence: `exostriker/lib/native_joint_fit.py`)
- Joint Fitting → Magnetic Cycle: uses (evidence: `exostriker/lib/native_joint_fit.py`)
- Joint Fitting → Mass Coordinates: uses (evidence: `exostriker/lib/native_joint_fit.py`)
- Native Inference → Native Likelihood: evaluates (evidence: `exostriker/lib/native_inference.py`)
- Native Inference → Transit Model: uses (evidence: `exostriker/lib/native_inference.py`)
- Native Inference → Activity GP: uses (evidence: `exostriker/lib/native_inference.py`)
- Native Inference → Magnetic Cycle: uses (evidence: `exostriker/lib/native_inference.py`)
- Native Inference → Stellar Parameters: synchronizes (evidence: `exostriker/lib/native_inference.py`)
- Native Inference → Mass Coordinates: synchronizes (evidence: `exostriker/lib/native_inference.py`)
- Native Likelihood → Transit Model: uses (evidence: `exostriker/lib/native_likelihood.py`)
- Activity GP → Magnetic Cycle: uses (evidence: `exostriker/lib/activity_gp.py`)
- Stellar Parameters → N-body Analysis: uses (evidence: `exostriker/lib/stellar_parameters.py`)
- Native Inference → Model Results: builds (evidence: `exostriker/lib/native_inference.py`)
- Sampling Engines → RV Fitting: evaluates posterior (evidence: `exostriker/lib/RV_mod/CustomSampler.py`)
- Astronomer → Transit Search: searches transits
- Astronomer → RV Periodograms: searches signals
- Astronomer → ExTRA Astrometry: fits astrometry
- Astronomer → N-body Analysis: checks stability
- Astronomer → Posterior Display: inspects results
- Astronomer → Interactive Plots: explores plots
