[general]
name=02Route 3D - Multi-Criteria 3D Mobility Studio
qgisMinimumVersion=3.28
qgisMaximumVersion=4.99
description=Profile-aware urban mobility and 3D shortest-path studio with 15 user profiles, modal access controls, network readiness audit, AHP cost surfaces, OD matrices, and WebGL route inspection.
version=0.4.0
author=Yusuf Eminoglu
email=yusuf.eminoglu@deu.edu.tr

about=02Route 3D is a profile-aware urban mobility, shortest-path, and 3D route inspection studio for QGIS. It routes across real QGIS line networks or bounded OpenStreetMap downloads using terrain, optional environmental rasters, road hierarchy, surface quality, direction, and modal access attributes.\n\nKey Capabilities:\n- 15 Mobility Profiles: pedestrian, inclusive mobility, micromobility, vehicle, freight, and emergency profiles with distinct speed, slope, stair, surface, and hierarchy constraints.\n- Consistent Routing Policy: primary A*, Pareto, isochrone, batch, OD, and evacuation workflows respect the same access and physical constraints.\n- Network Readiness Audit: annotated red/green LineStringZ output identifies blocked segments, one-way links, weak components, surface quality, and connectivity.\n- Route Diagnostics: bounded network snapping plus snap-distance, expanded-node, and blocked-edge reporting.\n- Biomechanical Kinematics: Tobler walking speed and Minetti metabolic energy, with mode-specific travel-time models.\n- 15 Processing Algorithms: routes, isochrones, Pareto alternatives, OD matrices, accessibility equity, network QA, exports, and analytical reports.\n- Interoperability: LineStringZ, GPX 1.1, GeoJSON 3D, AutoCAD DXF, and self-contained offline 3D HTML.\n\nInspiration & Acknowledgment:\nThe inclusive mobility persona framework is inspired by Transform Transport / Systematica research (UX-Mobility: Multi-User Walkability Route Planner, https://transformtransport.org/research/inclusive-mobility/ux-mobility-multi-user-walkability-route-planner/).

tracker=https://gitlab.com/geospacephilo/zero2route3d/-/issues
repository=https://gitlab.com/geospacephilo/zero2route3d
homepage=https://geophilo.com/zero2route3d/

category=Analysis
tags=network, shortest path, network audit, topology, modal access, od matrix, routing, 3d, mobility, accessibility, walkability, inclusive mobility, pedestrian, wheelchair, bicycle, micromobility, least cost path, threejs, webgl, elevation, slope, tobler, kinematics, minetti, pareto, mcda, ahp, isochrone, service area, e2sfca, spatial equity, evacuation, solar exposure, map matching, gps, gpx, dxf, cad, urban analytics, zero2

icon=icons/icon.png

experimental=False
deprecated=False
hasProcessingProvider=yes
license=GPL-2.0-or-later

changelog=
    0.4.0 - Profile-Aware Routing & Network QA:
        - Added modal access filtering for pedestrians, bicycles and motor vehicles using OSM-style tags and road-class defaults.
        - Added Routing Network Readiness Audit as the fifteenth Processing algorithm.
        - Added bounded network snapping, route diagnostics, weak-component topology fixes, real convex-hull isochrone area, and projected-center CRS correction.

    0.3.0 - Official QGIS Hub Release & UX Urban Mobility Evolution:
        - Transitioned out of experimental status for official QGIS Plugin Hub publication.
        - Enhanced metadata, shortest path descriptions, and added formal research acknowledgment for Transform Transport inclusive mobility inspiration.

    0.2.9 - Full Map Extent DEM & -5m Relative Skirt Extrusion:
        - Query Open-Elevation DEM for the full map canvas extent and normalized Web 3D terrain skirts to scene minimum elevation with -5m base plinth.

    0.2.8 - Point A & Point B 3D Billboard Text Sizing:
        - Dynamically measured text width and scaled the pill textbox background and sprite aspect ratio so that "Point A (Origin)" and "Point B (Destination)" fit with comfortable margins.

    0.2.7 - Rollback to Verified Web Basemap Milestone:
        - Reverted Web 3D studio and codebase back to v0.2.1 basemap milestone while preserving updated transparent 3D diorama brand icons.

    0.2.1 - Web Basemap Coverage & Geolocator A/B Pin Enhancements:
        - Resolved Web 3D basemap tile cutoff by dynamically choosing optimal zoom levels and loading all bounding tiles without artificial truncation.
        - Added lettered A/B geolocator pins and billboard badges in WebGL 3D, and composite font marker symbology and halo labeling in QGIS.

    0.2.0 - Correctness and honesty release:
        - Removed fabricated data: the NDVI, LST and NDBI rasters labelled as
          Copernicus Sentinel-2 products were generated from a hash of the pixel
          indices and fed into the routing cost; the 3D studio displayed a
          built-in demo route as if it were real; trees were placed
          procedurally; four algorithms substituted a hard-coded line in Izmir
          when input geometry was missing.
        - Missing elevation, heat and greenery data are now reported as absent
          instead of being replaced by 0.0, 0.5 and 0.4, which made a network
          with no DEM look flat and fully barrier-free compliant.
        - Corrected the Minetti metabolic cost equation, which overstated
          walking energy roughly fivefold.
        - Fixed field construction that raised TypeError on QGIS 4, so every
          algorithm producing a layer failed there before writing a feature.
        - Added coordinate reprojection throughout: projected inputs were being
          consumed as WGS84 degrees.
        - Fixed the isochrone profile list, which mapped Passenger Car to a
          mountain bike and left six profiles unreachable.
        - Fixed the accessibility, walkability, cost surface, DXF, HTML and
          solar algorithms, each of which crashed, produced nothing, or scored
          against invented inputs.
        - The standalone HTML export rendered a blank page for every user.
        - Processing outputs now carry symbology, field aliases and metadata.
        - Closing the dock no longer deletes the route layers you just added.
        - Restored the complete GPL-2 licence text and corrected the documented
          algorithm identifiers, 11 of which were wrong.

    0.1.0 - Initial release:
        - Interactive card-based QGIS Dock with adaptive dark/light styling.
        - 15 mobility profiles across pedestrian, micromobility and vehicle categories.
        - Multi-criteria raster cost surfaces (DEM, Slope, LST, Tree Canopy, Road Hierarchy).
        - Hardware-accelerated embedded 3D WebGL studio with chase and drone cam, and elevation HUD.
        - 3D LineStringZ vector layer creation and GPX/GeoJSON export.
        - Native QGIS Processing provider with 14 headless algorithms.
