# pytroll/satpy architecture

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

- Interactive diagram: https://gitdiagram.com/pytroll/satpy
- Repository: https://github.com/pytroll/satpy

## Overview

Satpy is a meteorological satellite-data processing library. A user loads satellite files into a Scene, whose reader stack decodes instrument products into identified datasets and navigation areas. The Scene can apply modifiers, calculate geometry, generate RGB composites, and resample products. It then dispatches data to image, CF, GeoTIFF, or AWIPS writers. MultiScene extends this workflow across timesteps, including animation-oriented output. The tree and excerpts establish these subsystem boundaries; some cross-module calls are inferred only from documented public capabilities.

Main entry points: [`satpy/scene.py`](https://github.com/pytroll/satpy/blob/main/satpy/scene.py) (Scene), [`satpy/writers/__init__.py`](https://github.com/pytroll/satpy/blob/main/satpy/writers/__init__.py) (Writer Dispatch), [`satpy/readers/core/loading.py`](https://github.com/pytroll/satpy/blob/main/satpy/readers/core/loading.py) (Reader Loading), [`satpy/readers/core/file_handlers.py`](https://github.com/pytroll/satpy/blob/main/satpy/readers/core/file_handlers.py) (File Handlers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_g_ingest["Data Ingestion"]
  node_reader_loading["Reader Loading<br/>[loading.py]"]
  node_file_handlers["File Handlers<br/>[file_handlers.py]"]
  node_dataset_model["Dataset Model"]
  node_navigation["Navigation Areas<br/>[area.py]"]
end

subgraph group_g_scene["Scene Processing"]
  node_scene["Scene<br/>[scene.py]"]
  node_resampling["Resampling"]
  node_modifiers["Data Modifiers"]
  node_angles["Angle Calculations<br/>[angles.py]"]
end

subgraph group_g_products["Product Generation"]
  node_composites["RGB Composites"]
  node_enhancements["Image Enhancements"]
  node_multiscene["MultiScene<br/>[_multiscene.py]"]
end

subgraph group_g_output["Output Services"]
  node_writer_dispatch["Writer Dispatch<br/>[__init__.py]"]
  node_image_writer["Image Writer<br/>[simple_image.py]"]
  node_cf_writer["CF Writer<br/>[cf_writer.py]"]
  node_geotiff_writer["GeoTIFF Writer<br/>[geotiff.py]"]
  node_awips_writer["AWIPS Writer<br/>[awips_tiled.py]"]
end

node_user(("Analyst"))
node_satellite_files["Satellite Files"]
node_output_files["Result Files"]

node_user -->|"requests loads"| node_scene
node_satellite_files -->|"provides files"| node_reader_loading
node_scene -->|"loads data"| node_reader_loading
node_reader_loading -->|"dispatches readers"| node_file_handlers
node_file_handlers -->|"decodes datasets"| node_dataset_model
node_file_handlers -->|"builds navigation"| node_navigation
node_reader_loading -->|"returns datasets"| node_scene
node_scene -->|"stores datasets"| node_dataset_model
node_scene -->|"applies modifiers"| node_modifiers
node_modifiers -->|"computes geometry"| node_angles
node_scene -->|"resamples areas"| node_resampling
node_scene -->|"builds composites"| node_composites
node_scene -->|"enhances imagery"| node_enhancements
node_user -->|"requests sequences"| node_multiscene
node_multiscene -->|"manages scenes"| node_scene
node_scene -->|"saves products"| node_writer_dispatch
node_writer_dispatch -->|"dispatches images"| node_image_writer
node_writer_dispatch -->|"dispatches CF"| node_cf_writer
node_writer_dispatch -->|"dispatches GeoTIFF"| node_geotiff_writer
node_writer_dispatch -->|"dispatches AWIPS"| node_awips_writer
node_image_writer -->|"writes images"| node_output_files
node_cf_writer -->|"writes data"| node_output_files
node_geotiff_writer -->|"writes rasters"| node_output_files
node_awips_writer -->|"writes tiles"| node_output_files

click node_scene "https://github.com/pytroll/satpy/blob/main/satpy/scene.py"
click node_reader_loading "https://github.com/pytroll/satpy/blob/main/satpy/readers/core/loading.py"
click node_file_handlers "https://github.com/pytroll/satpy/blob/main/satpy/readers/core/file_handlers.py"
click node_dataset_model "https://github.com/pytroll/satpy/tree/main/satpy/dataset"
click node_navigation "https://github.com/pytroll/satpy/blob/main/satpy/area.py"
click node_resampling "https://github.com/pytroll/satpy/tree/main/satpy/resample"
click node_modifiers "https://github.com/pytroll/satpy/tree/main/satpy/modifiers"
click node_angles "https://github.com/pytroll/satpy/blob/main/satpy/modifiers/angles.py"
click node_composites "https://github.com/pytroll/satpy/tree/main/satpy/composites"
click node_enhancements "https://github.com/pytroll/satpy/tree/main/satpy/enhancements"
click node_multiscene "https://github.com/pytroll/satpy/blob/main/satpy/multiscene/_multiscene.py"
click node_writer_dispatch "https://github.com/pytroll/satpy/blob/main/satpy/writers/__init__.py"
click node_image_writer "https://github.com/pytroll/satpy/blob/main/satpy/writers/simple_image.py"
click node_cf_writer "https://github.com/pytroll/satpy/blob/main/satpy/writers/cf_writer.py"
click node_geotiff_writer "https://github.com/pytroll/satpy/blob/main/satpy/writers/geotiff.py"
click node_awips_writer "https://github.com/pytroll/satpy/blob/main/satpy/writers/awips_tiled.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_reader_loading,node_file_handlers,node_dataset_model,node_navigation toneBlue
class node_scene,node_resampling,node_modifiers,node_angles toneAmber
class node_composites,node_enhancements,node_multiscene toneMint
class node_writer_dispatch,node_image_writer,node_cf_writer,node_geotiff_writer,node_awips_writer toneRose
class node_user,node_satellite_files,node_output_files toneIndigo
```

## Components

### Data Ingestion

- [Reader Loading](https://github.com/pytroll/satpy/blob/main/satpy/readers/core/loading.py): `satpy/readers/core/loading.py`
- [File Handlers](https://github.com/pytroll/satpy/blob/main/satpy/readers/core/file_handlers.py): `satpy/readers/core/file_handlers.py`
- [Dataset Model](https://github.com/pytroll/satpy/tree/main/satpy/dataset): `satpy/dataset`
- [Navigation Areas](https://github.com/pytroll/satpy/blob/main/satpy/area.py): `satpy/area.py`

### Scene Processing

- [Scene](https://github.com/pytroll/satpy/blob/main/satpy/scene.py): `satpy/scene.py`
- [Resampling](https://github.com/pytroll/satpy/tree/main/satpy/resample): `satpy/resample`
- [Data Modifiers](https://github.com/pytroll/satpy/tree/main/satpy/modifiers): `satpy/modifiers`
- [Angle Calculations](https://github.com/pytroll/satpy/blob/main/satpy/modifiers/angles.py): `satpy/modifiers/angles.py`

### Product Generation

- [RGB Composites](https://github.com/pytroll/satpy/tree/main/satpy/composites): `satpy/composites`
- [Image Enhancements](https://github.com/pytroll/satpy/tree/main/satpy/enhancements): `satpy/enhancements`
- [MultiScene](https://github.com/pytroll/satpy/blob/main/satpy/multiscene/_multiscene.py): `satpy/multiscene/_multiscene.py`

### Output Services

- [Writer Dispatch](https://github.com/pytroll/satpy/blob/main/satpy/writers/__init__.py): `satpy/writers/__init__.py`
- [Image Writer](https://github.com/pytroll/satpy/blob/main/satpy/writers/simple_image.py): `satpy/writers/simple_image.py`
- [CF Writer](https://github.com/pytroll/satpy/blob/main/satpy/writers/cf_writer.py): `satpy/writers/cf_writer.py`
- [GeoTIFF Writer](https://github.com/pytroll/satpy/blob/main/satpy/writers/geotiff.py): `satpy/writers/geotiff.py`
- [AWIPS Writer](https://github.com/pytroll/satpy/blob/main/satpy/writers/awips_tiled.py): `satpy/writers/awips_tiled.py`

### Other components

- **Analyst**
- **Satellite Files**
- **Result Files**

## Connections

- Analyst → Scene: requests loads
- Satellite Files → Reader Loading: provides files
- Scene → Reader Loading: loads data
- Reader Loading → File Handlers: dispatches readers
- File Handlers → Dataset Model: decodes datasets
- File Handlers → Navigation Areas: builds navigation
- Reader Loading → Scene: returns datasets
- Scene → Dataset Model: stores datasets
- Scene → Data Modifiers: applies modifiers
- Data Modifiers → Angle Calculations: computes geometry
- Scene → Resampling: resamples areas
- Scene → RGB Composites: builds composites
- Scene → Image Enhancements: enhances imagery
- Analyst → MultiScene: requests sequences
- MultiScene → Scene: manages scenes
- Scene → Writer Dispatch: saves products
- Writer Dispatch → Image Writer: dispatches images
- Writer Dispatch → CF Writer: dispatches CF
- Writer Dispatch → GeoTIFF Writer: dispatches GeoTIFF
- Writer Dispatch → AWIPS Writer: dispatches AWIPS
- Image Writer → Result Files: writes images
- CF Writer → Result Files: writes data
- GeoTIFF Writer → Result Files: writes rasters
- AWIPS Writer → Result Files: writes tiles
