How greensopinion/vectorvector works
Main Components
a) Input Processing Layer:
• GeoTIFF Elevation Data Reader
• CLI Interface (CliOptions.kt)
• Input Validation System
b) Core Processing Components:
• Elevation Processing Pipeline
• Block Management System
• Coordinate Translation System
c) Output Generation Layer:
• Vector Tile Generator
• Hillshade Generator
• Terrarium Tile Generator
d) Storage Layer:
• File System Storage
• MBTiles Storage
• Caching System
Key Relationships to Highlight
[Input Layer] → [Core Processing] → [Output Generation] → [Storage Layer]
With parallel paths for different output types:
• ┌→ [Contour Generation] →┐
[Elevation Data] → ├→ [Hillshade Creation] →┼→ [Storage]
• → [Terrarium Tiles] →┘
Detailed Component Breakdown
a) Input Processing:
[CLI Interface] → [Input Validator] → [GeoTIFF Reader]
b) Core Processing:
[BlockMapper] → [ElevationInterpolator] → [SlippyMapTranslator]
c) Output Generation:
[ContourLineGenerator] → [LineSimplifier]
[HornAlgorithm] → [HillshadeRasterSink]
[TerrariumSink]
Important Architectural Elements
• Metrics system (MetricsProvider) connecting to all major components
• Caching layer (CachingBlockStore, CachingElevationDataStore)
• Fault tolerance system (FaultBarrierTileSink)
Technical Details
• Input Format: GeoTIFF
• Output Formats: MBTiles, Files
• Processing Algorithms:
• Marching Squares (contours)
• Horn Algorithm (hillshade)
• Ramer-Douglas-Peucker (line simplification)
Integration Points
Connections to:
• External tile serving systems
• Conversion to PMTiles format
• Visualization tools