# iamafrar/deforestation-and-land-cover-change-analysis- architecture

> Architecture diagram of the GitHub repository iamafrar/deforestation-and-land-cover-change-analysis-, 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/iamafrar/deforestation-and-land-cover-change-analysis-
- Repository: https://github.com/iamafrar/deforestation-and-land-cover-change-analysis-

## Overview

This repository contains standalone Landsat file-preparation scripts, not a single application. The apparent workflow is to inventory filenames, sort Landsat files into year-month folders, then downscale and compress rasters while copying metadata. The scripts have no imports connecting them, so that sequence is a practical workflow rather than a demonstrated runtime pipeline. The compressor’s excerpt shows parallel raster processing; omitted source limits detail on its full scan and reporting behavior.

Main entry points: [`compress_data.py`](https://github.com/iamafrar/deforestation-and-land-cover-change-analysis-/blob/main/compress_data.py) (Raster compressor), [`getFileNames.py`](https://github.com/iamafrar/deforestation-and-land-cover-change-analysis-/blob/main/getFileNames.py) (Filename inventory), [`catogirizingData.py`](https://github.com/iamafrar/deforestation-and-land-cover-change-analysis-/blob/main/catogirizingData.py) (Date categorizer), [`landsat_filenames.txt`](https://github.com/iamafrar/deforestation-and-land-cover-change-analysis-/blob/main/landsat_filenames.txt) (Filename list)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_inventory["Filename inventory<br/>[getFileNames.py]"]
node_categorized["Date categorizer"]
node_compressor["Raster compressor<br/>[compress_data.py]"]
node_uncategorized[("uncategorized files")]
node_filename_list["Filename list"]
node_raw_data[("data/raw folders")]
node_data_source[("data source folder")]
node_compressed[("compressed output")]
node_metadata_copy["Metadata copier<br/>[compress_data.py]"]
node_raster_worker["Raster worker<br/>[compress_data.py]"]

node_user -.->|"runs"| node_inventory
node_user -.->|"runs"| node_categorized
node_user -.->|"runs"| node_compressor
node_inventory -->|"lists"| node_uncategorized
node_inventory -->|"writes"| node_filename_list
node_categorized -->|"reads and moves"| node_uncategorized
node_categorized -->|"organizes into"| node_raw_data
node_compressor -->|"scans"| node_data_source
node_compressor -->|"copies metadata"| node_metadata_copy
node_compressor -->|"dispatches rasters"| node_raster_worker
node_metadata_copy -->|"copies files"| node_compressed
node_raster_worker -->|"writes rasters"| node_compressed

click node_inventory "https://github.com/iamafrar/deforestation-and-land-cover-change-analysis-/blob/main/getFileNames.py"
click node_categorized "https://github.com/iamafrar/deforestation-and-land-cover-change-analysis-/blob/main/catogirizingData.py"
click node_compressor "https://github.com/iamafrar/deforestation-and-land-cover-change-analysis-/blob/main/compress_data.py"
click node_filename_list "https://github.com/iamafrar/deforestation-and-land-cover-change-analysis-/blob/main/landsat_filenames.txt"
click node_metadata_copy "https://github.com/iamafrar/deforestation-and-land-cover-change-analysis-/blob/main/compress_data.py"
click node_raster_worker "https://github.com/iamafrar/deforestation-and-land-cover-change-analysis-/blob/main/compress_data.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_user toneBlue
class node_inventory,node_categorized,node_compressor,node_filename_list,node_metadata_copy toneTeal
class node_uncategorized,node_raw_data,node_data_source,node_compressed toneAmber
class node_raster_worker toneRose
```

## Components

### Other components

- **User**
- [Filename inventory](https://github.com/iamafrar/deforestation-and-land-cover-change-analysis-/blob/main/getFileNames.py): `getFileNames.py`
- [Date categorizer](https://github.com/iamafrar/deforestation-and-land-cover-change-analysis-/blob/main/catogirizingData.py): `catogirizingData.py`
- [Raster compressor](https://github.com/iamafrar/deforestation-and-land-cover-change-analysis-/blob/main/compress_data.py): `compress_data.py`
- **uncategorized files**
- [Filename list](https://github.com/iamafrar/deforestation-and-land-cover-change-analysis-/blob/main/landsat_filenames.txt): `landsat_filenames.txt`
- **data/raw folders**
- **data source folder**
- **compressed output**
- [Metadata copier](https://github.com/iamafrar/deforestation-and-land-cover-change-analysis-/blob/main/compress_data.py): `compress_data.py`
- [Raster worker](https://github.com/iamafrar/deforestation-and-land-cover-change-analysis-/blob/main/compress_data.py): `compress_data.py`

## Connections

- User → Filename inventory: runs
- User → Date categorizer: runs
- User → Raster compressor: runs
- Filename inventory → uncategorized files: lists (evidence: `getFileNames.py`)
- Filename inventory → Filename list: writes (evidence: `getFileNames.py`)
- Date categorizer → uncategorized files: reads and moves (evidence: `catogirizingData.py`)
- Date categorizer → data/raw folders: organizes into (evidence: `catogirizingData.py`)
- Raster compressor → data source folder: scans (evidence: `compress_data.py`)
- Raster compressor → Metadata copier: copies metadata (evidence: `compress_data.py`)
- Raster compressor → Raster worker: dispatches rasters (evidence: `compress_data.py`)
- Metadata copier → compressed output: copies files (evidence: `compress_data.py`)
- Raster worker → compressed output: writes rasters (evidence: `compress_data.py`)
