# vida-nyu/tile2net architecture

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

- Interactive diagram: https://gitdiagram.com/vida-nyu/tile2net
- Repository: https://github.com/vida-nyu/tile2net

## Overview

Tile2Net turns aerial imagery into georeferenced pedestrian infrastructure: users generate a project from a location or supplied tiles, then run segmentation inference to produce polygons and a connected pedestrian network. The graph preserves the documented download, verification, stitching, optional preview, and vector-output stages. Several implementation links are based on SOURCE INDEX references or README descriptions; unsampled details are not inferred beyond those links.

Main entry points: [`src/tile2net/tileseg/inference/inference.py`](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/tileseg/inference/inference.py) (Inference runner), [`src/tile2net/raster/generate/generate.py`](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/generate/generate.py) (Project generation), [`src/tile2net/raster/raster.py`](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/raster.py) (Raster orchestration), [`src/tile2net/raster/pednet.py`](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/pednet.py) (Pedestrian network)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Commands and projects"]
  node_commands["CLI commands<br/>[__main__.py]"]
  node_generation["Project generation<br/>[generate.py]"]
  node_project["Project metadata<br/>[project.py]"]
  node_weights["Checkpoint manager<br/>[weights.py]"]
end

subgraph group_imagery["Imagery preparation"]
  node_raster["Raster orchestration<br/>[raster.py]"]
  node_geocoding["Location lookup<br/>[nominatim.py]"]
  node_imagery_sources["Imagery sources<br/>[source.py]"]
  node_grid["Tile grid<br/>[grid.py]"]
  node_tile["Tile operations<br/>[tile.py]"]
end

subgraph group_model["Segmentation inference"]
  node_inference["Inference runner<br/>[inference.py]"]
  node_dataset["Inference datasets<br/>[__init__.py]"]
  node_config["Model configuration<br/>[config.py]"]
  node_network["Segmentation network<br/>[ocrnet.py]"]
end

subgraph group_vectors["Geospatial outputs"]
  node_formats["Vector formats<br/>[formats.py]"]
  node_polygons["Polygon extraction<br/>[tile.py]"]
  node_pednet["Pedestrian network<br/>[pednet.py]"]
end

subgraph group_internals["Model and spatial internals"]
  node_network_core["Network components<br/>[mynn.py]"]
  node_seg_utils["Inference utilities<br/>[misc.py]"]
  node_topology["Topology processing<br/>[topology.py]"]
  node_geo_utils["Geodata utilities<br/>[geodata_utils.py]"]
  node_shape_ops["Shape operations<br/>[momepy_shapes.py]"]
  node_weight_manifest["Weight manifest<br/>[weights.py]"]
end

node_user(("User"))

node_user -->|"runs"| node_commands
node_commands -->|"dispatches"| node_generation
node_commands -->|"dispatches"| node_inference
node_generation -->|"creates"| node_raster
node_generation -->|"downloads"| node_weights
node_generation -->|"writes metadata"| node_project
node_raster -->|"uses lookup"| node_geocoding
node_raster -->|"selects source"| node_imagery_sources
node_raster -->|"builds grid"| node_grid
node_grid -->|"creates project"| node_project
node_inference -->|"loads data"| node_dataset
node_inference -->|"runs model"| node_network
node_inference -->|"uses settings"| node_config
node_inference -->|"uses utilities"| node_seg_utils
node_network -->|"uses layers"| node_network_core
node_inference -->|"uses tile grid"| node_tile
node_tile -->|"extracts polygons"| node_polygons
node_inference -->|"creates network"| node_pednet
node_pednet -->|"processes topology"| node_topology
node_pednet -->|"uses geodata"| node_geo_utils
node_topology -->|"uses geodata"| node_geo_utils
node_topology -->|"uses shapes"| node_shape_ops
node_pednet -->|"writes vectors"| node_formats
node_weights -->|"validates against"| node_weight_manifest
node_user -.->|"provides tiles"| node_imagery_sources
node_inference -->|"reads metadata"| node_project
node_inference -->|"produces vector output"| node_polygons

click node_commands "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/__main__.py"
click node_generation "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/generate/generate.py"
click node_project "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/project.py"
click node_weights "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/weights.py"
click node_raster "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/raster.py"
click node_geocoding "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/nominatim.py"
click node_imagery_sources "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/source.py"
click node_grid "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/grid.py"
click node_tile "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/tile.py"
click node_formats "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/formats.py"
click node_inference "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/tileseg/inference/inference.py"
click node_dataset "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/tileseg/datasets/__init__.py"
click node_config "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/tileseg/config.py"
click node_network "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/tileseg/network/ocrnet.py"
click node_network_core "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/tileseg/network/mynn.py"
click node_seg_utils "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/tileseg/utils/misc.py"
click node_polygons "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/tile.py"
click node_pednet "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/pednet.py"
click node_topology "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/tile_utils/topology.py"
click node_geo_utils "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/tile_utils/geodata_utils.py"
click node_shape_ops "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/tile_utils/momepy_shapes.py"
click node_weight_manifest "https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/weights.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_commands,node_generation,node_project,node_weights,node_user toneBlue
class node_raster,node_geocoding,node_imagery_sources,node_grid,node_tile toneAmber
class node_inference,node_dataset,node_config,node_network toneMint
class node_formats,node_polygons,node_pednet toneRose
class node_network_core,node_seg_utils,node_topology,node_geo_utils,node_shape_ops,node_weight_manifest toneIndigo
```

## Components

### Commands and projects

- [CLI commands](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/__main__.py): `src/tile2net/__main__.py`
- [Project generation](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/generate/generate.py): `src/tile2net/raster/generate/generate.py`
- [Project metadata](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/project.py): `src/tile2net/raster/project.py`
- [Checkpoint manager](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/weights.py): `src/tile2net/raster/weights.py`

### Imagery preparation

- [Raster orchestration](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/raster.py): `src/tile2net/raster/raster.py`
- [Location lookup](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/nominatim.py): `src/tile2net/raster/nominatim.py`
- [Imagery sources](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/source.py): `src/tile2net/raster/source.py`
- [Tile grid](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/grid.py): `src/tile2net/raster/grid.py`
- [Tile operations](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/tile.py): `src/tile2net/raster/tile.py`

### Segmentation inference

- [Inference runner](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/tileseg/inference/inference.py): `src/tile2net/tileseg/inference/inference.py`
- [Inference datasets](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/tileseg/datasets/__init__.py): `src/tile2net/tileseg/datasets/__init__.py`
- [Model configuration](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/tileseg/config.py): `src/tile2net/tileseg/config.py`
- [Segmentation network](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/tileseg/network/ocrnet.py): `src/tile2net/tileseg/network/ocrnet.py`

### Geospatial outputs

- [Vector formats](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/formats.py): `src/tile2net/raster/formats.py`
- [Polygon extraction](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/tile.py): `src/tile2net/raster/tile.py`
- [Pedestrian network](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/pednet.py): `src/tile2net/raster/pednet.py`

### Model and spatial internals

- [Network components](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/tileseg/network/mynn.py): `src/tile2net/tileseg/network/mynn.py`
- [Inference utilities](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/tileseg/utils/misc.py): `src/tile2net/tileseg/utils/misc.py`
- [Topology processing](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/tile_utils/topology.py): `src/tile2net/raster/tile_utils/topology.py`
- [Geodata utilities](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/tile_utils/geodata_utils.py): `src/tile2net/raster/tile_utils/geodata_utils.py`
- [Shape operations](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/tile_utils/momepy_shapes.py): `src/tile2net/raster/tile_utils/momepy_shapes.py`
- [Weight manifest](https://github.com/vida-nyu/tile2net/blob/main/src/tile2net/raster/weights.py): `src/tile2net/raster/weights.py`

### Other components

- **User**

## Connections

- User → CLI commands: runs
- CLI commands → Project generation: dispatches (evidence: `src/tile2net/__main__.py`)
- CLI commands → Inference runner: dispatches (evidence: `src/tile2net/__main__.py`)
- Project generation → Raster orchestration: creates (evidence: `src/tile2net/raster/generate/generate.py`)
- Project generation → Checkpoint manager: downloads (evidence: `src/tile2net/raster/generate/generate.py`)
- Project generation → Project metadata: writes metadata
- Raster orchestration → Location lookup: uses lookup (evidence: `src/tile2net/raster/raster.py`)
- Raster orchestration → Imagery sources: selects source (evidence: `src/tile2net/raster/raster.py`)
- Raster orchestration → Tile grid: builds grid (evidence: `src/tile2net/raster/raster.py`)
- Tile grid → Project metadata: creates project (evidence: `src/tile2net/raster/grid.py`)
- Inference runner → Inference datasets: loads data (evidence: `src/tile2net/tileseg/inference/inference.py`)
- Inference runner → Segmentation network: runs model (evidence: `src/tile2net/tileseg/inference/inference.py`)
- Inference runner → Model configuration: uses settings (evidence: `src/tile2net/tileseg/inference/inference.py`)
- Inference runner → Inference utilities: uses utilities (evidence: `src/tile2net/tileseg/inference/inference.py`)
- Segmentation network → Network components: uses layers (evidence: `src/tile2net/tileseg/network/ocrnet.py`)
- Inference runner → Tile operations: uses tile grid (evidence: `src/tile2net/tileseg/inference/inference.py`)
- Tile operations → Polygon extraction: extracts polygons (evidence: `src/tile2net/raster/tile.py`)
- Inference runner → Pedestrian network: creates network (evidence: `src/tile2net/tileseg/inference/inference.py`)
- Pedestrian network → Topology processing: processes topology (evidence: `src/tile2net/raster/pednet.py`)
- Pedestrian network → Geodata utilities: uses geodata (evidence: `src/tile2net/raster/pednet.py`)
- Topology processing → Geodata utilities: uses geodata (evidence: `src/tile2net/raster/tile_utils/topology.py`)
- Topology processing → Shape operations: uses shapes (evidence: `src/tile2net/raster/tile_utils/topology.py`)
- Pedestrian network → Vector formats: writes vectors (evidence: `src/tile2net/raster/pednet.py`)
- Checkpoint manager → Weight manifest: validates against
- User → Imagery sources: provides tiles
- Inference runner → Project metadata: reads metadata (evidence: `src/tile2net/tileseg/inference/inference.py`)
- Inference runner → Polygon extraction: produces vector output (evidence: `src/tile2net/tileseg/inference/inference.py`)
