Platform Documentation

Welcome to the official documentation for the CitySimulate Platform. Learn how to configure policies, run hybrid simulations, and analyze government-scale data.

Getting Started

To begin simulating the future of your city:

  1. Navigate to the Simulator.
  2. Adjust policy levers on the left sidebar corresponding to Transport, Energy, Housing, etc.
  3. Click Run Simulation.
  4. Analyze the KPIs below the map and use Analytics for deeper dives.

How the Simulation Engine Works

The core of CitySimulate is a deterministic hybrid engine that combines statistical baselines with rule-based modifiers.

function calculateMetrics(params) { // Base math for linear progression let carbonEmissions = energyConsumption * 0.4; carbonEmissions -= renewablePercent * 3; return carbonEmissions; }

Each metric is calculated inter-dependently. For instance, creating transit-oriented development will impact both Housing and Transportation scores.

Policy Modules Guide

There are five core modules available:

  • Transport: Modifies vehicle density and tolling logic.
  • Roads: Infrastructure construction and maintenance.
  • Energy: Grid load capacity and smart technology integration.
  • Transit: Headways, coverage geometry, and fares.
  • Housing: Zoning density restrictions and equity constraints.

Understanding Metrics

Calculated outputs use standardized indexing so that inter-city comparisons mean something:

MetricUnitIdeal Trend
Congestion Score0-100Downward 📉
Economic Impact$ BillionsUpward 📈

Frequently Asked Questions

Can I import actual GIS data?

Currently, the sandbox supports CartoDB base tiles. Bespoke GeoJSON uploads will be supported in v2.

Where is my data saved?

All experiments are securely saved to the government-grade Supabase Postgres cluster associated with your account.