# kornelszyszka/planetgenerator architecture

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

- Interactive diagram: https://gitdiagram.com/kornelszyszka/planetgenerator
- Repository: https://github.com/kornelszyszka/planetgenerator

## Overview

Planet Generator is a Tkinter desktop app for procedurally creating and saving planet images. The user sets resolution, temperature, and star type, then generates a planet: the app requests terrain and cloud noise, selects biome colors, composites the layers, and displays the image; users can save it as PNG. The graph separates those domain stages and palette data from the UI. The sampled main.py shows orchestration and asset loading; unsampled resources contents are represented only as a directory.

Main entry points: [`main.py`](https://github.com/kornelszyszka/planetgenerator/blob/main/main.py) (Tkinter app), [`body_gen.py`](https://github.com/kornelszyszka/planetgenerator/blob/main/body_gen.py) (Biome coloring), [`noise_gen.py`](https://github.com/kornelszyszka/planetgenerator/blob/main/noise_gen.py) (Noise generation), [`planet_type.py`](https://github.com/kornelszyszka/planetgenerator/blob/main/planet_type.py) (Biome palettes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_app["Tkinter app<br/>[main.py]"]
end

subgraph group_generation["Planet generation"]
  node_noise["Noise generation<br/>[noise_gen.py]"]
  node_colors["Biome coloring<br/>[body_gen.py]"]
  node_palettes["Biome palettes<br/>[planet_type.py]"]
end

subgraph group_presentation["Image presentation"]
  node_composition["Layer composition<br/>[main.py]"]
  node_image["Display and save<br/>[main.py]"]
  node_assets["Image assets"]
end

node_user(("User"))

node_user -->|"sets parameters"| node_app
node_user -->|"generates or saves"| node_app
node_app -->|"requests noise"| node_noise
node_app -->|"requests colors"| node_colors
node_colors -->|"selects palettes"| node_palettes
node_app -->|"builds layers"| node_composition
node_composition -->|"displays image"| node_image
node_app -->|"loads images"| node_assets

click node_app "https://github.com/kornelszyszka/planetgenerator/blob/main/main.py"
click node_noise "https://github.com/kornelszyszka/planetgenerator/blob/main/noise_gen.py"
click node_colors "https://github.com/kornelszyszka/planetgenerator/blob/main/body_gen.py"
click node_palettes "https://github.com/kornelszyszka/planetgenerator/blob/main/planet_type.py"
click node_composition "https://github.com/kornelszyszka/planetgenerator/blob/main/main.py"
click node_image "https://github.com/kornelszyszka/planetgenerator/blob/main/main.py"
click node_assets "https://github.com/kornelszyszka/planetgenerator/tree/main/resources"

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_app,node_user toneBlue
class node_noise,node_colors,node_palettes toneAmber
class node_composition,node_image,node_assets toneMint
```

## Components

### User interface

- [Tkinter app](https://github.com/kornelszyszka/planetgenerator/blob/main/main.py): `main.py`

### Planet generation

- [Noise generation](https://github.com/kornelszyszka/planetgenerator/blob/main/noise_gen.py): `noise_gen.py`
- [Biome coloring](https://github.com/kornelszyszka/planetgenerator/blob/main/body_gen.py): `body_gen.py`
- [Biome palettes](https://github.com/kornelszyszka/planetgenerator/blob/main/planet_type.py): `planet_type.py`

### Image presentation

- [Layer composition](https://github.com/kornelszyszka/planetgenerator/blob/main/main.py): `main.py`
- [Display and save](https://github.com/kornelszyszka/planetgenerator/blob/main/main.py): `main.py`
- [Image assets](https://github.com/kornelszyszka/planetgenerator/tree/main/resources): `resources`

### Other components

- **User**

## Connections

- User → Tkinter app: sets parameters (evidence: `README.md`)
- User → Tkinter app: generates or saves (evidence: `README.md`)
- Tkinter app → Noise generation: requests noise (evidence: `main.py`)
- Tkinter app → Biome coloring: requests colors (evidence: `main.py`)
- Biome coloring → Biome palettes: selects palettes (evidence: `body_gen.py`)
- Tkinter app → Layer composition: builds layers (evidence: `main.py`)
- Layer composition → Display and save: displays image (evidence: `main.py`)
- Tkinter app → Image assets: loads images (evidence: `main.py`)
