[general]
name=LandXML Road & Terrain GIS Tools
qgisMinimumVersion=3.44
qgisMaximumVersion=4.99
description=Civil 3D, OpenRoads and generic LandXML in QGIS: terrain, road geometry, profile and cross-section viewers, earthworks quantities, site-grading quantities, design reports and a geometric design review (alignment phasing, sight distance, barriers) against Kenya RDM 1.3 or AASHTO.
version=1.10.0
author=Edmond Akello
email=francenicklaus@gmail.com
about=Brings LandXML road and terrain data into QGIS and turns it into review-ready reports.

    Import: TIN surfaces to GeoTIFF, surface boundaries, breaklines and feature lines; horizontal alignments with true arc-length stationing; vertical and existing-ground profiles; 3D centrelines; station points; Civil 3D corridor cross-sections placed along their alignment; a Complete Road Design GeoPackage export.

    Review and report: a Station & Offset Locator dock (map clicks or manual engineering station input, signed offsets and map markers); a Profile Viewer dock (click an alignment to see existing ground against design, with cut/fill shading, transitions and a cross-section tab); cut/fill, corridor and TIN-to-TIN quantities with mass haul and side-slope areas for grassing; cross-section sheets as PDF, HTML or PNG; a Road Design Report with plan, curvature, gradient, long-section and superelevation diagrams.

    Site grading: exact cut and fill from a volume surface or from design and existing-ground surfaces (no grid), platform levels and falls, basin stage–storage with freeboard checks, multi-site earthwork balance under shrinkage factors, and revision comparison by zone.

    Geometric Design Review: checks alignment phasing, stopping sight distance, crest and sag K, grades, radii, transitions, superelevation, design speed changes and embankment barrier warrants against Kenya RDM 1.3 (2025) or AASHTO 2018 criteria files, follows the design speeds set in Civil 3D, and writes recommended PVIs and curve lengths as a Civil 3D profile text file, a comparison LandXML and a changed-PVI CSV, with A3 plan and profile sheets.

    Coordinate handling is explicit: stored coordinates, axis swap, offset, 2-D Helmert or reprojection are chosen by the user; a LandXML-declared CRS is shown for reference only. US survey feet, international feet and metres remain distinct. No extra Python dependencies.

    Licensed under the GNU General Public License version 2 or later.
repository=https://github.com/EdmondAkello/LandXML-Road-and-Terrain-GIS-Tools
tracker=https://github.com/EdmondAkello/LandXML-Road-and-Terrain-GIS-Tools/issues
homepage=https://github.com/EdmondAkello/LandXML-Road-and-Terrain-GIS-Tools
changelog=1.10.0
    - Site grading group: exact Grading Quantities from a Civil 3D volume surface or from design and existing-ground surfaces, Platform Levels and Falls, Basin Stage–Storage, Earthwork Balance and Grading Revision Comparison, with visual reports and an explicit vertical-unit choice.
    - Geometric Design Review: A3 plan and profile sheets, a banded long section with numbered findings and phasing bands, finding numbers in every output, findings map points by default, and a comparison LandXML plus changed-PVI CSV for Civil 3D.
    - Roadway station equations across stationing, exports, reports and the Profile Viewer.
    - Profile Viewer clicks centre the map again; the viewer and locator docks no longer squeeze other panels; northing-first coordinate warnings.
    - Interactive Station & Offset Locator: map clicks, manual station/offset lookup, engineering notation and three-decimal displays, with explicit coordinate settings and source units.
    - Coordinate interpretation includes the shared OpenRoads axis-order reminder.
    - Complete Road Design can load exported layers, names terrain outputs by source evidence, and preserves original surface names from prepared LandXML.
    - Processing dialogs remember project inputs; vector outputs share road-review styles; startup, QGIS 4 dialog and dropdown refresh fixes.
    1.9.2
    - Fixed an error when moving the mouse over the cross-section chart in the Profile Viewer.
    - Clicking the long section outside the cross-section coverage now says so instead of silently showing the end section.
    1.9.1
    - AASHTO metric reviews read the required superelevation from Green Book Tables 3-8 and 3-9 for e max 4 and 6 percent, instead of an estimate that understated it.
    1.9.0
    - Prepare LandXML from Geometry and Terrains: combine an alignment file with separate existing and proposed terrain files, sampling the missing profiles and cross-sections from the TINs.
    - AASHTO 2018 US customary criteria (mph, feet) and e max 10 percent for AASHTO metric and US customary reviews.
    - Volume units in all earthworks tools (Automatic, CY, CF, m³). Foot-based projects now report CY by default; regenerate earlier outputs.
    - Section quantities no longer integrate across stations with missing data; large-grid limit is now a configurable warning.
    1.8.1
    - Reports print cleanly to PDF: page numbers, no empty pages, headings kept with charts, legend colours kept, tables split across pages with repeated headers.
    - Review findings grouped by category with wider issue and recommendation columns; the Road Design Report opens with a table of its alignments.
    - Design speed card lists only the speeds that apply within each alignment.
    1.8.0
    - Geometric Design Review: alignment phasing, sight distance, vertical and horizontal curves, grades, superelevation, design speed changes and barrier warrants, with Kenya RDM 1.3 (2025) or AASHTO 2018 criteria.
    - Recommended PVIs and curve lengths exported for Civil 3D (Create Profile from File text and LandXML).
    - Design speeds from Civil 3D speed stations are followed section by section.
    - The Road Design Report can include the review.
    1.7.0
    - Name dropdowns and automatic surface choice; cross-section sheets and viewer tab; Road Design Report.
    1.6.0
    - Profile Viewer; profile, corridor and surface cut/fill quantities; corrected cross-section placement, hidden TIN faces and curve stationing.
    Full history: CHANGELOG.md
experimental=False
deprecated=False
tags=LandXML,design review,site grading,volume surface,stage storage,plan and profile,alignment phasing,sight distance,guardrail,RDM,AASHTO,TIN,earthworks,cross-section sheets,superelevation,design report,cut and fill,quantities,mass haul,long section,DTM,DEM,GeoTIFF,Civil 3D,OpenRoads Designer,road design,alignment,profile,cross-section,feature line,breakline,GeoPackage,QGIS,Processing
category=Vector
icon=icon.png
