# urbangiser/urbananalytics architecture

> Architecture diagram of the GitHub repository urbangiser/urbananalytics, 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/urbangiser/urbananalytics
- Repository: https://github.com/urbangiser/urbananalytics

## Overview

UrbanAnalytics is a collection of urban-analysis models and data, rather than one integrated application. Its documented capabilities are spatial accessibility via reconciled 2SFCA, network community scanning for Chinese urban agglomerations, and multi-constraint Monte Carlo simulation with geographic imputation for cancer data. The r2SFCA example demonstrates model calculations, parameter search, optimization, comparisons, and reporting. The KNIME-oriented imputation scripts show input-to-output table processing. Community-scanning implementation details and cross-project orchestration were not sampled, so those connections are intentionally not inferred.

Main entry points: [`Accessibility/r2sfca/example_usage.py`](https://github.com/urbangiser/urbananalytics/blob/main/Accessibility/r2sfca/example_usage.py) (Usage examples), [`Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation1.py`](https://github.com/urbangiser/urbananalytics/blob/main/Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation1.py) (Constrained Monte Carlo), [`Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation-2.py`](https://github.com/urbangiser/urbananalytics/blob/main/Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation-2.py) (Age and sex constraints), [`Multi_Constraint_Monte_Carlo_GeoImputation/Python/Geo_Imputation.py`](https://github.com/urbangiser/urbananalytics/blob/main/Multi_Constraint_Monte_Carlo_GeoImputation/Python/Geo_Imputation.py) (County-to-ZCTA imputation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Spatial accessibility"]
  node_example["Usage examples<br/>[example_usage.py]"]
  node_model["r2SFCA model<br/>[core.py]"]
end

subgraph group_community["Community scanning"]
  node_scanning["Community scanning methods"]
  node_mobility["Baidu mobility data"]
end

subgraph group_impute["Cancer data imputation"]
  node_simulation["Constrained Monte Carlo<br/>[MMC_Simulation1.py]"]
  node_multiconstraint["Age and sex constraints"]
  node_geoimpute["County-to-ZCTA imputation<br/>[Geo_Imputation.py]"]
  node_derived["Aggregate missing fields<br/>[MMC_Simulation3.py]"]
end

subgraph group_r2internal["r2SFCA internals"]
  node_utilities["Evaluation and plots<br/>[utils.py]"]
end

node_user(("Analyst"))

node_user -->|"runs examples"| node_example
node_example -->|"calls model"| node_model
node_example -->|"uses reporting"| node_utilities
node_user -.->|"runs methods"| node_scanning
node_user -->|"supplies tables"| node_simulation
node_simulation -->|"outputs table"| node_user
node_user -->|"supplies tables"| node_multiconstraint
node_multiconstraint -->|"outputs table"| node_user
node_user -->|"supplies tables"| node_geoimpute
node_geoimpute -->|"outputs table"| node_user
node_user -->|"supplies table"| node_derived
node_derived -->|"outputs table"| node_user

click node_example "https://github.com/urbangiser/urbananalytics/blob/main/Accessibility/r2sfca/example_usage.py"
click node_model "https://github.com/urbangiser/urbananalytics/blob/main/Accessibility/r2sfca/r2sfca/core.py"
click node_utilities "https://github.com/urbangiser/urbananalytics/blob/main/Accessibility/r2sfca/r2sfca/utils.py"
click node_scanning "https://github.com/urbangiser/urbananalytics/blob/main/CommunityScan/Code/Network_Community_Scanning_for_UA_2025.ipynb"
click node_mobility "https://github.com/urbangiser/urbananalytics/blob/main/CommunityScan/Data/BaiduMobility2023.csv"
click node_simulation "https://github.com/urbangiser/urbananalytics/blob/main/Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation1.py"
click node_multiconstraint "https://github.com/urbangiser/urbananalytics/blob/main/Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation-2.py"
click node_geoimpute "https://github.com/urbangiser/urbananalytics/blob/main/Multi_Constraint_Monte_Carlo_GeoImputation/Python/Geo_Imputation.py"
click node_derived "https://github.com/urbangiser/urbananalytics/blob/main/Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation3.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_example,node_model toneBlue
class node_scanning,node_mobility toneAmber
class node_simulation,node_multiconstraint,node_geoimpute,node_derived toneMint
class node_utilities toneRose
class node_user toneIndigo
```

## Components

### Spatial accessibility

- [Usage examples](https://github.com/urbangiser/urbananalytics/blob/main/Accessibility/r2sfca/example_usage.py): `Accessibility/r2sfca/example_usage.py`
- [r2SFCA model](https://github.com/urbangiser/urbananalytics/blob/main/Accessibility/r2sfca/r2sfca/core.py): `Accessibility/r2sfca/r2sfca/core.py`

### Community scanning

- [Community scanning methods](https://github.com/urbangiser/urbananalytics/blob/main/CommunityScan/Code/Network_Community_Scanning_for_UA_2025.ipynb): `CommunityScan/Code/Network_Community_Scanning_for_UA_2025.ipynb`
- [Baidu mobility data](https://github.com/urbangiser/urbananalytics/blob/main/CommunityScan/Data/BaiduMobility2023.csv): `CommunityScan/Data/BaiduMobility2023.csv`

### Cancer data imputation

- [Constrained Monte Carlo](https://github.com/urbangiser/urbananalytics/blob/main/Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation1.py): `Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation1.py`
- [Age and sex constraints](https://github.com/urbangiser/urbananalytics/blob/main/Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation-2.py): `Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation-2.py`
- [County-to-ZCTA imputation](https://github.com/urbangiser/urbananalytics/blob/main/Multi_Constraint_Monte_Carlo_GeoImputation/Python/Geo_Imputation.py): `Multi_Constraint_Monte_Carlo_GeoImputation/Python/Geo_Imputation.py`
- [Aggregate missing fields](https://github.com/urbangiser/urbananalytics/blob/main/Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation3.py): `Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation3.py`

### r2SFCA internals

- [Evaluation and plots](https://github.com/urbangiser/urbananalytics/blob/main/Accessibility/r2sfca/r2sfca/utils.py): `Accessibility/r2sfca/r2sfca/utils.py`

### Other components

- **Analyst**

## Connections

- Analyst → Usage examples: runs examples (evidence: `Accessibility/r2sfca/example_usage.py`)
- Usage examples → r2SFCA model: calls model (evidence: `Accessibility/r2sfca/example_usage.py`)
- Usage examples → Evaluation and plots: uses reporting (evidence: `Accessibility/r2sfca/example_usage.py`)
- Analyst → Community scanning methods: runs methods (evidence: `README.md`)
- Analyst → Constrained Monte Carlo: supplies tables (evidence: `Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation1.py`)
- Constrained Monte Carlo → Analyst: outputs table (evidence: `Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation1.py`)
- Analyst → Age and sex constraints: supplies tables (evidence: `Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation-2.py`)
- Age and sex constraints → Analyst: outputs table (evidence: `Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation-2.py`)
- Analyst → County-to-ZCTA imputation: supplies tables (evidence: `Multi_Constraint_Monte_Carlo_GeoImputation/Python/Geo_Imputation.py`)
- County-to-ZCTA imputation → Analyst: outputs table (evidence: `Multi_Constraint_Monte_Carlo_GeoImputation/Python/Geo_Imputation.py`)
- Analyst → Aggregate missing fields: supplies table (evidence: `Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation3.py`)
- Aggregate missing fields → Analyst: outputs table (evidence: `Multi_Constraint_Monte_Carlo_GeoImputation/Python/MMC_Simulation3.py`)
