[general]
name=PlanX: Urban Resilience
email=yusuf.eminoglu@deu.edu.tr
author=Yusuf Eminoglu
qgisMinimumVersion=3.10
description=PlanX urban resilience suite (28 tools): seismic, heat, flood, social, emergency access, evacuation, network criticality, air, drought, synthesis, risk-recovery matrix, time-series, scenario tools, HTML/Markdown/PDF atlas, symbology.
about=28 Processing algorithms and a QGIS dashboard for city-scale resilience screening: synthetic QA, seismic debris, heat and flood, social vulnerability, Euclidean and network emergency access, evacuation simulation with optional timestep queue, network criticality, air and drought, multi-hazard and equity-adjusted synthesis, climate projection overlay, recovery capacity, scenario sensitivity, risk-recovery priority matrix, time-series tracking, scenario templates, HTML/Markdown/PDF atlas with map-book presets, shelter arrival summaries, and symbology. DEU City and Regional Planning educational workflows.
version=1.19.1
tracker=https://github.com/YusufEminoglu/planx_urban_resilience/issues
repository=https://github.com/YusufEminoglu/planx_urban_resilience

category=Processing
tags=planx,urban resilience,drr,seismic,debris,heat,flood,social vulnerability,emergency accessibility,network analysis,air quality,drought,adaptation,scenario planning,scenario comparison,reporting,markdown,symbology,synthetic data,climate,spatial planning,QGIS,processing
homepage=https://github.com/YusufEminoglu/planx_urban_resilience
icon=icons/plugin.svg
experimental=False
deprecated=False
qgisMaximumVersion=3.99
hasProcessingProvider=yes
plugin_dependencies=
license=GPL-3
changelog=
    PlanX Urban Resilience 1.19.1 - Hub-scan hygiene patch.
        - Removed the build_local_zip.ps1 local-dev script from the shipped zip (flagged as suspicious file by Hub security scan in 1.19.0).
        - Hardened packaging/zip_hub.py to skip .ps1, .bat, .exe, .lnk, .dll, .pyc and similar non-plugin files by default so no future Hub upload accidentally ships executables.
        - Cleaned the 32 flake8 issues from the Hub Code Quality report: removed unused imports (dashboard.py, heat, scenario_comparison, pdf_atlas), removed dead 'ys' list in pluvial flood, fixed E302/E701/W293 in monte_carlo_debris (one statement per line, two blank lines before class, blank-line whitespace).
        - Added setup.cfg disabling W503 (modern PEP 8 prefers break-before-operator) and E203 (Black-style slicing).
    PlanX Urban Resilience 1.19.0 - Join scores to units + helpers rollout across hazard modules.
        - Join Hazard Scores to Planning Units: up to five intersecting score layers on planning-unit polygons.
        - processing/_helpers.py extended; heat/flood/social/air/drought/emergency/adaptation/recovery use shared clamp and class helpers.
        - build_local_zip.ps1 for local Hub zip without git.
    PlanX Urban Resilience 1.18.0 - Risk-recovery matrix, directional roads, helper rollout.
        - Risk-Recovery Priority Matrix: combine hazard/adapt score with recovery capacity deficit; rr_priority_score and intervention class.
        - Directional road network: optional direction field (both/ft/bt) on evacuation and network criticality via build_road_graph.
        - Synthetic roads include direction (North connector one-way ft); equity and scenario sensitivity use processing/_helpers.
    PlanX Urban Resilience 1.17.0 - Arrival curves, PDF presets, shared helpers, network refactor.
        - Evacuation Shelter Arrival Summary: per-shelter timestep/minute arrival table plus optional HTML from evacuation origin outputs.
        - Resilience PDF Atlas: map-book presets (A3 standard, A4 compact, A3 studio 300 dpi).
        - processing/_helpers.py shared clamp/risk-class/weight parsers; network_accessibility uses _network_graph.
    PlanX Urban Resilience 1.16.0 - Evacuation v2: road capacity mapping and timestep queue.
        - build_road_graph now maps per-edge capacity from a numeric field or road-class lookup (arterial/collector/local defaults).
        - Evacuation Time Simulation: optional timestep queue (minutes > 0) defers departures when segment flow exceeds per-interval capacity; new origin fields travel_min, evac_delay_min, evac_timestep; edge outputs trip_count, load_pop, congestion_pct.
        - Synthetic demo roads include capacity_ph and class for evacuation smoke tests.
    PlanX Urban Resilience 1.15.0 - Evacuation simulation and shared network graph module.
        - Evacuation Time Simulation: greedy capacity-constrained shelter assignment on the road network; outputs assigned origins, shelter utilization, edge load/bottleneck scores; P50/P95 evacuation times in the log.
        - Shared processing/accessibility/_network_graph.py; network_criticality refactored to use it.
        - Synthetic demo buildings now include a population field for evacuation smoke tests.
    PlanX Urban Resilience 1.14.0 - PDF atlas wired up, scenario sensitivity, dashboard sync.
        - Resilience PDF Atlas: multi-page A3 QgsLayout export (cover, overview, per-class maps) now registered in Processing and the dashboard.
        - Scenario Sensitivity Analysis: Latin Hypercube weight perturbation with baseline, mean, std, p05/p95, range and stability score per unit.
        - Dashboard: Recovery Capacity Index, Time-Series Tracker and PDF Atlas module cards added (were missing from v1.13).
        - Future-modules hint updated (evacuation simulation, GEE connectors remain on the roadmap).
    PlanX Urban Resilience 1.13.0 - Six new algorithms across synthesis, emergency and reporting.
        - Multi-Hazard Composite Index: weighted composite, dominant hazard label, Shannon diversity, top drivers, data-gap count.
        - Equity-Adjusted Adaptation Priority: equity factor from SVI, normalized adjusted priority (0-100) + class.
        - Network Criticality (edge betweenness proxy): origin to nearest-destination shortest-path edge usage; outputs usage_count and criticality_score 0-100 per edge.
        - Climate Projection Overlay: amplification factor (built-in 1.5C/2C/3C or custom) to a today score, with delta and delta class per unit.
        - Recovery Capacity Index: composite of four offline-derivable proxies (HHI diversity, redundancy, green coverage, social cohesion). Complementary to Adaptation Priority.
        - Resilience Time-Series Tracker: join two snapshots on a stable ID, emit per-unit delta, percent change, trend (Improved/Stable/Worsened), optional target gap.
        - All registered in the Processing provider and the dashboard catalog under Synthesis, Emergency and Report-and-QA groups.
    PlanX Urban Resilience 1.11.0 - Two new synthesis algorithms.
        - Multi-Hazard Composite Index: combine N hazard score fields per planning unit. Outputs weighted composite, class, dominant hazard, Shannon diversity index (single-stress -> multi-stress), top 3 drivers, and data-gap count.
        - Equity-Adjusted Adaptation Priority: multiply a hazard score by an equity factor derived from the Social Vulnerability Index. Surfaces units that are both high-hazard and high-vulnerability.
        - Both algorithms registered in the Processing provider and the dashboard module catalog under the Synthesis group.
    PlanX Urban Resilience 1.10.0 - New icon, dashboard UX overhaul, correctness pass, roadmap.
        - Replaced the seismic-only icon with a new mark representing the full suite: stratified city skyline, sweeping renewal arc and cycle dots on a soft teal-green base.
        - Dashboard: Overview/Modules/Run pages now scroll inside a QScrollArea, fixing overflow on small screens.
        - Dashboard: search bar on the Modules and Run pages filters cards by title, category, inputs and outputs in real time.
        - Dashboard: module cards are grouped by category (Seismic, Heat, Flood, Social, Emergency, Air, Drought, Synthesis, Report and QA) instead of a flat 2-column grid.
        - Seismic / Monte Carlo Debris: replaced hard-coded PyQt5 import with qgis.PyQt (forward-compatible with Qt6 QGIS), added empty-input guard, narrowed bare except clauses, and guarded the field-index lookup.
        - Added ROADMAP.md outlining the next nine algorithm candidates and a suggested release schedule.
        - Added tests/smoke_pipeline.py - one-shot QGIS-console smoke run across seven modules using synthetic inputs.
    PlanX Urban Resilience 1.9.0 - Added Markdown studio brief generation for planning communication.
        - Added Resilience Studio Brief to create first-draft executive summaries, key metrics, class distributions, dominant drivers, limitations, and suggested next actions.
        - Updated dashboard module cards, README, metadata, and Plugin Hub changelog for HTML/Markdown reporting workflows.
    PlanX Urban Resilience 1.8.0 - Added scenario planning template generation.
        - Added Scenario Planning Template to create editable baseline/proposed score worksheets from any planning unit or scored layer.
        - Added intervention labels, scenario metadata, expected reduction, draft status, and notes fields for studio workflows.
        - Updated dashboard guidance, README, metadata, and Plugin Hub changelog.
    PlanX Urban Resilience 1.7.0 - Added QGIS style preset tooling for scored and classified resilience outputs.
        - Added Apply Resilience Symbology for 0-100 risk scores, access classes, scenario change classes, and adaptation priority classes.
        - Added optional QML style export for reusable cartographic presets.
        - Updated dashboard cards, README, metadata, and Plugin Hub changelog.
    PlanX Urban Resilience 1.6.0 - Added network-based emergency accessibility screening.
        - Added Network Emergency Accessibility to compute approximate road-network distance and travel time from origins to shelters or safe assembly areas.
        - Added underserved origin outputs, access classes, snap-distance QA flags, and graph-build feedback.
        - Updated dashboard guidance, README, metadata, and Plugin Hub changelog for the new network workflow.
    PlanX Urban Resilience 1.5.0 - Added reporting and scenario comparison tools for studio-ready outputs.
        - Added Scenario Comparison / Delta Map to compare baseline and proposed 0-100 score fields.
        - Added Resilience Score HTML Report for standalone score summaries, class distributions, and top drivers.
        - Updated dashboard module cards, data readiness guidance, README, metadata, and roadmap.
    PlanX Urban Resilience 1.4.0 - Added synthetic demo data generation and dashboard smoke-test guidance.
        - Added Synthetic Resilience Demo Dataset Processing algorithm for artificial study area, buildings, roads, impervious surfaces, green infrastructure, water, shelters, social units, and sensitive receptors.
        - Added a dashboard Test page that opens the synthetic dataset generator and explains the smoke-test workflow.
        - Updated README, metadata, provider registration, and data readiness guidance for classroom and QA workflows.
    PlanX Urban Resilience 1.3.0 - Added the remaining roadmap modules as offline-first Processing tools.
        - Added Air Quality / Urban Exposure screening for road, source, sensitive receptor, and green buffer inputs.
        - Added Drought and Green Infrastructure Stress screening for parks, canopy patches, impervious context, water access, and tree density.
        - Added Climate Adaptation Priority Synthesis to combine joined 0-100 risk fields into one priority layer.
        - Updated the dashboard, data readiness guidance, README, and Plugin Hub metadata for the expanded eight-module suite.
    PlanX Urban Resilience 1.2.0 - Expanded the suite with Social Vulnerability Index and Emergency Accessibility/Shelter Coverage modules.
        - Added a weighted social vulnerability screening algorithm for neighborhood or census polygons.
        - Added an emergency accessibility and shelter coverage screening algorithm with underserved asset outputs.
        - Updated the dashboard module catalog, data readiness guidance, README, and Plugin Hub metadata.
    PlanX Urban Resilience 1.1.0 - Added QGIS dashboard, Urban Heat Comfort Risk screening, and Pluvial Flood Susceptibility screening modules.
        - Added module cards, project data readiness guidance, and Processing launch shortcuts.
        - Registered heat and flood Processing groups alongside the existing seismic debris module.
    PlanX Urban Resilience 1.0.3 - Standardized author/email metadata, added DEU educational context, marked the plugin stable, and refreshed the Plugin Hub release package.
    PlanX Urban Resilience 1.0.2 - Refreshed the release for Plugin Hub publication.
        - Update package metadata for the next published version.
        - Rebuild the Hub-ready ZIP archive from the current plugin sources.
    PlanX Urban Resilience 1.0.1 - Built a Hub-conformant ZIP package with forward-slash paths.
    PlanX Urban Resilience 1.0.0 - Initial suite release with the seismic debris and evacuation-network module migrated from the former PlanX Seismic Resilience package.
