# kashkovvv/mars-flight architecture

> Architecture diagram of the GitHub repository kashkovvv/mars-flight, 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/kashkovvv/mars-flight
- Repository: https://github.com/kashkovvv/mars-flight

## Overview

Это учебная численная модель полёта Земля—Марс. Основной сценарий запускает расчёт миссии: взлёт с Земли, пассивный перелёт в солнечном поле и торможение у Марса; `MissionModel` передаёт между этапами нужные скорости и результаты. Аналитический переход Гомана служит ориентиром, а результаты визуализируются и сохраняются при запуске. Связи этапов подтверждены фрагментом `mission.py`; графики и запуск описаны README и импортами в SOURCE INDEX. Некоторые детали реализации не показаны.

Main entry points: [`mars_flight/mission.py`](https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/mission.py) (Связка миссии), [`mars_flight/config.py`](https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/config.py) (Параметры модели), [`mars_flight/__main__.py`](https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/__main__.py) (Запуск программы), [`mars_flight/plots.py`](https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/plots.py) (Графики этапов)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_run["Запуск и настройка"]
  node_cli["Запуск программы<br/>[__main__.py]"]
  node_config["Параметры модели<br/>[config.py]"]
end

subgraph group_mission["Этапы миссии"]
  node_mission_model["Связка миссии<br/>[mission.py]"]
  node_earth_ascent["Взлёт с Земли<br/>[earth.py]"]
  node_solar_transfer["Солнечный перелёт<br/>[transfer.py]"]
  node_mars_landing["Посадка на Марс<br/>[mars.py]"]
  node_hohmann["Ориентир Гомана<br/>[theory.py]"]
end

subgraph group_analysis["Анализ результатов"]
  node_plots["Графики этапов<br/>[plots.py]"]
  node_results["Файлы результатов"]
end

node_user(("Пользователь"))

node_user -->|"запускает"| node_cli
node_cli -->|"запускает расчёт"| node_mission_model
node_cli -->|"строит графики"| node_plots
node_cli -->|"читает параметры"| node_config
node_mission_model -->|"использует настройки"| node_config
node_earth_ascent -->|"читает параметры"| node_config
node_solar_transfer -->|"читает параметры"| node_config
node_mars_landing -->|"читает параметры"| node_config
node_mission_model -->|"вычисляет ориентир"| node_hohmann
node_mission_model -->|"рассчитывает взлёт"| node_earth_ascent
node_mission_model -->|"рассчитывает перелёт"| node_solar_transfer
node_mission_model -->|"рассчитывает посадку"| node_mars_landing
node_plots -->|"использует единицы"| node_config
node_plots -->|"читает результаты"| node_earth_ascent
node_plots -->|"читает результаты"| node_solar_transfer
node_plots -->|"читает результаты"| node_mars_landing
node_cli -->|"сохраняет графики и параметры"| node_results

click node_cli "https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/__main__.py"
click node_config "https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/config.py"
click node_mission_model "https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/mission.py"
click node_earth_ascent "https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/earth.py"
click node_solar_transfer "https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/transfer.py"
click node_mars_landing "https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/mars.py"
click node_hohmann "https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/theory.py"
click node_plots "https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/plots.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_cli,node_config toneBlue
class node_mission_model,node_earth_ascent,node_solar_transfer,node_mars_landing,node_hohmann toneAmber
class node_plots,node_results toneMint
class node_user toneIndigo
```

## Components

### Запуск и настройка

- [Запуск программы](https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/__main__.py): `mars_flight/__main__.py`
- [Параметры модели](https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/config.py): `mars_flight/config.py`

### Этапы миссии

- [Связка миссии](https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/mission.py): `mars_flight/mission.py`
- [Взлёт с Земли](https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/earth.py): `mars_flight/earth.py`
- [Солнечный перелёт](https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/transfer.py): `mars_flight/transfer.py`
- [Посадка на Марс](https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/mars.py): `mars_flight/mars.py`
- [Ориентир Гомана](https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/theory.py): `mars_flight/theory.py`

### Анализ результатов

- [Графики этапов](https://github.com/kashkovvv/mars-flight/blob/main/mars_flight/plots.py): `mars_flight/plots.py`
- **Файлы результатов**

### Other components

- **Пользователь**

## Connections

- Пользователь → Запуск программы: запускает (evidence: `README.md`)
- Запуск программы → Связка миссии: запускает расчёт (evidence: `mars_flight/__main__.py`)
- Запуск программы → Графики этапов: строит графики (evidence: `mars_flight/__main__.py`)
- Запуск программы → Параметры модели: читает параметры (evidence: `mars_flight/__main__.py`)
- Связка миссии → Параметры модели: использует настройки (evidence: `mars_flight/mission.py`)
- Взлёт с Земли → Параметры модели: читает параметры (evidence: `mars_flight/earth.py`)
- Солнечный перелёт → Параметры модели: читает параметры (evidence: `mars_flight/transfer.py`)
- Посадка на Марс → Параметры модели: читает параметры (evidence: `mars_flight/mars.py`)
- Связка миссии → Ориентир Гомана: вычисляет ориентир (evidence: `mars_flight/mission.py`)
- Связка миссии → Взлёт с Земли: рассчитывает взлёт (evidence: `mars_flight/mission.py`)
- Связка миссии → Солнечный перелёт: рассчитывает перелёт (evidence: `mars_flight/mission.py`)
- Связка миссии → Посадка на Марс: рассчитывает посадку (evidence: `mars_flight/mission.py`)
- Графики этапов → Параметры модели: использует единицы (evidence: `mars_flight/plots.py`)
- Графики этапов → Взлёт с Земли: читает результаты (evidence: `mars_flight/plots.py`)
- Графики этапов → Солнечный перелёт: читает результаты (evidence: `mars_flight/plots.py`)
- Графики этапов → Посадка на Марс: читает результаты (evidence: `mars_flight/plots.py`)
- Запуск программы → Файлы результатов: сохраняет графики и параметры (evidence: `README.md`)
