Skip to content

About

Open-source urban rail design, simulation, operations, QA, maintenance, and certification-evidence stack for locally manufactured light metro systems.

Topics

Resources

Contributing

Stars

6 stars

Watchers

1 watching

Forks

Latest commit

 

History

354 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenSourceRail

nobody should be priced out of dignity

Give your city a railway it can own

OpenSourceRail is an open urban-rail reference platform for countries that want to retain design authority, software, fabrication, integration, operations and maintenance capability in-country. It connects city planning, GIS, CAD/IFC, simulation, project controls, local manufacturing, ERP, equipment supervision and assurance around the same city, asset and engineering-revision identities.

Important

Repository outputs are planning and engineering-screening evidence—not bids, construction releases, safety certificates, approvals or endorsements. Open topography and water data do not replace survey, geotechnical or hydraulic evidence. Simulation and formal checks do not authorize live railway command.

OpenSourceRail light-metro reference trainset

Start here: two-page brochure · complete PDF book · one-page overview · architecture · current roadmap and open work

Functional comparison

Native part generation: generate drilled steel cleats and RHS/I-section civil beams through FreeCAD → Gmsh → CalculiX, then use native feedback to choose subsequent designs. Deterministic bounded search retains failed cases, provenance, geometry and solver files. Best-design claims cover the declared, fully tested numerical domain; physical qualification remains open. Run the recursive workflow · Review twelve related design systems. OpenSourceRail connects corridor choices to engineering revisions, local production, delivery costs and maintenance evidence. Its planning portfolio covers 265 cities in 44 developing countries, plus one European comparison model. This table compares published functions, not performance, price or railway acceptance. Reviewed 12 October 2026: linked primary sources; capabilities depend on edition/configuration. “Integrated” means an existing OSR component; “workflow” means a tool used with OSR; “benchmark” implies no connector.

Tool / suite Availability / relationship Main functions OpenSourceRail's corresponding value and limits
OpenSourceRail Open source; connected reference platform City GIS, service/energy simulation, CAD/IFC, quantities, local manufacture, finite-resource CPM, procurement/cashflow, ERP, supervision and maintenance evidence Common city/asset/revision identities connect planning through repair; reproducible demonstrations exist, while physical railway qualification and live control acceptance remain open.
Siemens TPS.plan, TPS.live, TPS.trackworks Commercial; benchmark Infrastructure-aware timetables, traffic forecasts/conflicts, dispatching and track-work windows OSR schedules declared physical routes around possessions and resource conflicts, with fleet/energy and staff recovery; search is bounded and live dispatch acceptance remains open.
Alstom Urbalis Vision / ICONIS supervision Commercial; benchmark Integrated urban traffic supervision, regulation, SCADA, incident and depot management OSR joins OCC, simulator and observation-only FUXA views to asset/work records; its management stack is not an accepted live ATS/CBTC product.
Alstom HealthHub / FlexCare digital services Commercial; benchmark Fleet, infrastructure and signalling condition monitoring, predictive maintenance and service support OSR joins condition-to-repair and serial/parts history to exposure/fault trends and held-out degradation/RUL validation; measured calibration and predictive deployment remain open.
Hitachi Rail HMAX Commercial; benchmark Digital asset management, harmonised health data, condition/predictive maintenance and digital twins OSR exposes engineering provenance and condition-to-repair evidence in an adaptable owner-held stack; deployed predictive depth and support equivalence are unproven.
Hitachi Energy EAM / FSM / APM Commercial; benchmark Rail asset registers, track defects, work orders, field service and asset performance OSR links assets, work and independent handback to revisions, with offline typed/photo work packs, durable synchronisation and native-state revalidation; operator commissioning remains open.
Dassault DELMIA Quintiq Commercial; benchmark Coupled service, fleet and crew planning, constraint optimisation and disruption replanning OSR proposes possession-aware service/fleet/energy recovery and bounded staff rosters, retaining deadheads, charging and fixed maintenance; unrestricted optimisation depth remains unproven.
Tracsis ATTUne / TRACS / TRACS Enterprise Commercial; benchmark Timetables, vehicle/crew diagrams, rostering, personnel and on-day operations OSR proposes rosters across operating and maintenance roles, checking competence, travel, rest, breaks and workload; native assignment and deployed rostering acceptance remain separate.
Wabtec RailConnect Commercial; freight benchmark Railcar movement, switching, mobile work, freight revenue/billing and industry exchanges OSR's current reference is urban passenger rail with engineering-to-maintenance continuity; freight settlement and car-hire workflows would require a separate profile.
Petrosoft RAILSoft / mRails Commercial; benchmark Fleet planning, maintenance intervals, parts/history and mobile field execution, including offline work OSR joins ERP asset/parts/people records to offline field evidence, operational/GTFS exchange and configured operator identity adapters; national transport integrations remain deployment-specific.
IBM Maximo Application Suite Commercial; benchmark Asset/work management, inspection, reliability, monitoring and predictive maintenance OSR connects comparable asset/work record categories to public railway definitions and engineering changes; equivalent operating scale, analytics and service support require proof.
Bentley OpenRail Designer Commercial; benchmark Specialist alignment, cant, turnouts/yards, corridor modelling and design documentation OSR carries screening geometry into quantities, IFC, procurement and cashflow; it does not claim equivalent detailed alignment design or issued-for-construction capability.
OSRD Open source; benchmark Railway infrastructure, train simulation, timetables, capacity and short-term path requests OSR extends the workflow into vehicle/civil references, manufacture, delivery and maintenance; breadth does not establish equivalent timetable/capacity depth.
Eclipse SUMO Open source; workflow Microscopic multimodal simulation: road, rail, public transport and pedestrians OSR uses SUMO for independent screening and adds rail engineering, asset and delivery context; numerical agreement requires matched inputs and declared tolerances.
QGIS Open source; workflow Raster/vector GIS, spatial analysis, cartography and geospatial exchange OSR supplies city/route revisions, demand and terrain/water screening connected to service, civil quantities and delivery outputs.
FreeCAD Open source; workflow Parametric solid modelling, assemblies, drawings and extensible engineering tools OSR supplies controlled train/station/civil families, product interfaces, BOMs and manufacturing/evidence gates around native CAD.
Bonsai / IfcOpenShell Open source; workflow Native IFC authoring, model review, coordination and programmable BIM OSR supplies railway asset identities, IFC4.3 packages, quantities, 4D states and executable information requirements linked to revisions.
ERPNext / Frappe HR Open source; integrated Procurement, stock, manufacturing, quality, projects, assets, finance, employees and payroll These hold OSR's native business records; OSR adds railway context, engineering-change disposition, competence/resource checks and independent inspection/handback.
FUXA Open source; integrated Web SCADA/HMI, process displays and industrial protocol connectivity OSR supplies versioned observations, durable history/alarms and ERP maintenance linkage; the installed OSR gateway carries no railway command authority.
OpenProject Community Open source core; benchmark Project/work-package tracking, collaboration, Gantt schedules and dependencies OSR adds finite-resource CPM, railway quantities/BOM demand, supplier order-by dates and local/import cashflow; no OpenProject connector is claimed.
CalculiX / OpenSees CalculiX GPL; OpenSees use restrictions; workflow Finite-element analysis; structural/geotechnical nonlinear and dynamic research OSR drives source-bound beam–pier–foundation comparisons and retains failed cases, tradeoffs and model limits; solver convergence does not qualify a railway structure.

Why use OSR? A corridor or component change can be reviewed alongside its asset quantities, manufacturing work, procurement, cash needs and maintenance consequences, with inspectable source and retained evidence. Start with the owner/operator platform; use the competitive position and proof roadmap to judge maturity. The six-item operations implementation adds bounded resource/fleet/staff planning, offline evidence, reliability validation and operational exchange; measured/operator commissioning remains separate.

The physical reference is a 49.5 m, three-car driverless light metro with 360 AW2 / 480 AW3 capacity and 675 kWh gross / 540 kWh usable LFP storage, integrated battery/cabin thermal control, seven station archetypes and reusable civil families. A welded steel safety frame, non-structural GFRP cladding and supplier-neutral COTS subsystem interfaces support local fabrication, assembly and repair. Its 120 LM3 product rows, 26 assembly nodes, 30 tooling/mould families and 146 native FreeCAD models with matching split IFC4.3 files connect that make/buy strategy to BOMs, tooling and qualification gates.

The city catalogue uses elevated land sections in its controlled central study areas, radial tangents and curved ring connections where terrain and water permit; retained shore detours and priced bridge candidates replace long lake crossings. Outer approaches retain their actual at-grade, elevated and special-crossing mix, with no tunnels. Each city reports its current civil quantities, one full-fleet planning depot per line, graded staffing and an 18-month factory-readiness plan. These are planning concepts: property, survey, supplier, structural and operational releases remain open. Catalogue design review · Water and interchange checks · Baghdad’s dedicated proposal and funding.

Complete viaduct design exploration

The civil workbench compares complete beam–pier–foundation packages, with Baghdad as the qualification target. It searches for separate low-cost, low-mass and short-construction-time choices and retains the Pareto tradeoffs, failures, changed parameters and evidence gaps. The retained LM3 verification studies and Baghdad research results have distinct load bases; Baghdad supplier axle positions are still missing.

Part of the system Choices investigated
Beams and decks Pi20/Pi25 controls; hollow box; prestressed I; U; ribbed; targeted UHPC ribs; FRP shell/concrete; segmental box; steel–concrete I; FRP–concrete I. Research spans include 20, 25 and 30 m.
Materials and composites Normal, high-performance and structural lightweight concrete; targeted UHPC; steel; GFRP and CFRP orthotropic matrices. Properties remain declared research hypotheses until measured.
Piers Solid; solid tapered; hollow tapered; hollow prismatic; segmental hollow; experimental double-skin FRP/concrete. Reinforcement, confinement, joint and cyclic acceptance remain open.
Foundations Reference pile group; four/six bored piles; single shaft; CFA; displacement piles; hollow and square driven precast piles; spread footings. Diameter, length and cap sizes are investigated with each package.
Assembly and delivery Simple spans, link slabs and continuity; full precast, segmental, shell/infill and in-situ construction; finite factory/rig/transport/erection resources, curing and inspection.

Parametric beam, pier and foundation research choices; colours identify materials and blue markers identify pile positions

Executed comparison: 731 distinct complete packages, 779 evaluations, 24 detailed packages, using 300 m of double track.

Conditional objective Beam Pier Foundation Synthetic installed cost Installed study mass Working time
Cheapest in concrete-first U-girder 20 m, lightweight hollow-tapered CFA-six $1,774,796 6,504.4 t 120 working days
Lightest in concrete-first hybrid-shell 20 m, high-performance hollow-prismatic square-driven-six $7,374,804 5,499.2 t 154.625 working days
Fastest in concrete-first uhpc-ribbed 20 m, high-performance hollow-prismatic CFA-six $2,640,915 7,609.1 t 63 working days

These are the best confirmed research choices found within the declared search budget and synthetic price/productivity scenarios. Supplier-priced cheapest design, railway qualification and global optimality remain unresolved. All physical and operating release flags remain false.

Reduced native models screen the packages. A diverse shortlist receives three actual-section CalculiX solid meshes and three 3D OpenSees meshes, including separate tracks, asymmetric uniform loading, braking sensitivity, transverse cap bending, torsion and coupled foundation translation/rotation. Composite-slip diagnostics expose dependence on connectors. Empty shipping/lifting units remain separate from complete service mass; driven-pile production and delivery are included in construction planning. The detailed shortlist contains 16 designs at 20 m, six at 25 m and two at 30 m. All 24 converged; 22 passed every shared provisional constraint. The two 30 m cases remain rejected diagnostics, with their failed limits retained. Every refined load case repeats the shared drift, settlement, foundation-demand, deflection and lifting checks. Force and central solid-stress convergence are recorded as well as displacement convergence. Evolution considers all three commercial scenarios, whole-life cost and erection mass; per-seed benchmarks retain unique evaluations, timing, coverage and observed Pareto quality.

Native FreeCAD 1.1.4 verification passed all 25 registered beam, pier and foundation families and all 24 complete shortlisted assemblies, including valid kernel solids, independent net volumes and agreement with the retained IFC quantities. The source-bound receipt is separate from ordinary Python CAD fallback tests. Reproduce with FreeCADCmd tools/automation/verify-civil-native-cad.py in a FreeCAD environment. Structural construction-stage load paths, V/Y supports, haunched sections and calibrated ground improvement remain explicit model extensions; measured inputs, physical validation and independent acceptance remain open.

Reproduce with tools/automation/osr-python tools/automation/civil-study.py system-study and system-verify; see the retained comparison below for the complete commands. Open the generated report.html to filter choices and compare objectives, or read the retained comparison and implementation/acceptance details. The scope includes materials, reinforcement/tendon allowances, foundations, connections, production, transport, plant, temporary works, labour, QA, site carrying cost, maintenance and bearing/joint replacement scenarios. The shared engineering demonstrators reconcile native CAD mass/CG/inertia, hollow sections, IFC analysis identities, joint screens and evidence-gated mixed searches. Actual Baghdad supplier prices and construction commitments remain open. Static distributed planning loads support research comparisons; actual axle loading, calibrated soil/material/connection behaviour, physical tests and independent acceptance are required for railway qualification. No numerical winner automatically changes the catalogue, city finances or release status.

Feature Highlights

flowchart LR
  P[1. PLAN<br/>City Studio / GIS] --> E[2. ENGINEER<br/>CAD / IFC4.3 / simulation] --> D[3. DELIVER<br/>CPM / ERP / QA / manufacturing] --> O[4. OPERATE<br/>assets / SCADA views / evidence] --> R[maintain / renew] --> P
Loading

Digital standards adherence from the first design change

The Digital Standards Thread connects publisher records and deployment law to controls, requirements, hazards, design items, evidence and G1–G4 decisions. Local validation rejects stale reviews, broken mappings and changed hashes, while its impact index identifies reassessment after change. A green result means evidence coherence—not clause conformity, physical qualification, independent assessment or legal authorization.

1. Turn city data into a costed railway candidate. Rust planning and simulation work with deterministic Python GIS/design generators to connect source-locked city data → route and station candidates → reference vehicles and civil quantities → service, fleet and energy checks → procurement, construction schedule and cashflow. In City Studio, edit lines, stations and service over 20 layers including roads, buildings, population/demand, open-DEM elevation/slope and mapped water. Compare catchment and service implications, identify likely crossings and station exclusions, seal a candidate revision and regenerate its delivery twin. This makes alternatives and their costs reviewable from the same inputs. Surveyed walking access, turnout/siding layouts, calibrated running times and engineering release require further evidence; route coverage, battery suitability and safety headways are checked against declared inputs rather than guaranteed by automation. The population, transfer and viaduct-clearance review separates native population catchments from routing demand, includes transfers through intermediate lines, and records beam/building, support/foundation and terrain conflicts. Unknown heights and incomplete mapping remain explicit release gates.

2. Engineer the railway and its interfaces. Export OSR-ALN, GIS and IFC4.3 data for QGIS and Bonsai/IfcOpenShell; generate quantities, classifications, asset identities, 4D states, IDS requirements and BCF-oriented evidence; and use native FreeCAD train, station and civil geometry. System simulation connects trains, stations, energy, wayside, points/crossings, fares, regenerative braking and depots. Route changes flow into named compatibility checks for gradient, curvature, cant, platforms, clearances, braking, energy, crosswind, recovery and evacuation. The design-detail register controls terrain/water impacts, BIM groups, vehicle datums, mechanical interfaces, load cases and route gates. All 146 split LM3 IFC files carry provenance and interface properties; the buildingSMART IDS requirements execute 4 specifications and 945 checks. This closes information delivery—not supplier selection, calculations, tolerance stacks, structural proof, physical tests or authority acceptance.

3. Deliver through local production and accountable project controls. Turn city design into asset registers, BOM demand, finite-resource schedules, supplier candidates, order-by dates, cash requirements, QA gates and construction states. ERPNext holds native projects, procurement, inventory, manufacturing, quality, finance, people and maintenance records. The first-article baseline controls 120 product rows and 26 assembly nodes; 30 tooling families, 16 factory packages and 29 drawing-definition seeds feed nested BOMs, methods, travelers and hold points. Across 62 locally made rows, 472 fail-closed slots—including exterior finish and mass closure—prevent first-article release without required production and approval evidence.

4. Operate, maintain and retain evidence. One Workbench joins City Studio, simulation, OCC, railway works, ERPNext/Frappe HR, FUXA and lifecycle views. Nine native Rust evaluator families publish exact units, identities and provenance through a versioned observation-only contract into durable history, alarms and read-only supervision. Reviewed conditions become ERP maintenance cases and Asset Repairs with parts, technicians, downtime and evidence. Local end-to-end acceptance exercises complete-city load, queued delivery, restart persistence, backup and clean-volume recovery. ERP, FUXA and management automation have no path to movement authority, point/barrier command, safety release or engineering acceptance.

Step-by-step use cases

Scenario 1 — Compare two city corridors before funding survey work

  1. Select a catalogue city in City Studio, then inspect roads, buildings, demand, existing rail and places. 2. Draw candidate lines and stations; compare OD demand, fleet and timetable implications. 3. Add source-locked open DEM and water evidence. The router classifies likely at-grade, viaduct and bridge segments and rejects stations in mapped exclusions. 4. Model constrained single-track sections with passing at stations and recovery sidings where appropriate. 5. Compile each candidate into an immutable revision and generate its asset, quantity, cost, cashflow, critical-path and survey-gap outputs. 6. Use the comparison to commission field survey, geotechnical and hydraulic work—not to release a route or structure.

Scenario 2 — Propagate an alignment change into engineering and delivery

  1. Seal the revised GIS/OSR-ALN candidate so every downstream result refers to the same bytes. 2. Regenerate civil/station IFC4.3, quantities, classifications, asset IDs and 4D construction states. 3. Run route–vehicle gates for gradient, curvature, cant, platform, clearance, braking, energy, crosswind, evacuation and recovery interfaces. 4. Validate the 146-file LM3 federation against the IDS requirements, then run deterministic FMEA/standards and baseline-drift checks. 5. Recalculate BOM demand, finite-resource CPM, suppliers, order-by dates, QA gates and local/import cashflow; expose affected open ERP work for disposition. 6. Stop at unresolved calculations, supplier data, physical tests or approvals. A green digital report is design evidence, not construction release.

Scenario 3 — Manufacture and commission a locally built subsystem

  1. Start from one of 120 controlled product rows and follow its CAD/IFC, mechanical interfaces, material/process fields and nested BOM. 2. Issue a bounded supplier package separating NRE, tooling, first article, repeat units and support; treat catalogue vendors as leads until qualified. 3. Create the ERP project, purchase and receipt records; preserve batch/serial identity and inspection references. 4. Execute the factory traveler and hold points, record NCRs and accepted evidence, then install the serialized item against its planned asset identity. 5. Bind design, execution, inspection and simulation commissioning evidence. A later replacement keeps the removed serial's history and requires fresh evidence. 6. Provision a lookup-only QR only after an operator has configured a secure resolver and independently verified the physical binding; see the governance templates.

Scenario 4 — Turn a train or station fault into controlled maintenance

  1. The Rust evaluator emits unit- and source-qualified observations through the command-free osr-supervision-contract boundary. 2. The gateway retains history and alarm state; FUXA shows condition but cannot grant movement authority or engineering release. 3. A reviewed actionable condition creates one durable ERP Issue, including response guidance and immutable incident provenance. 4. A maintainer previews the linked Asset, parts availability, technician and downtime, then creates one unsubmitted Asset Repair. 5. Native ERP records work, stock and actual downtime; separate inspection and handback evidence decide whether railway use may resume. 6. Restart, ERP outage and duplicate-delivery tests prove queued events and serial history recover without turning case closure into safety clearance.

Scenario 5 — Rehearse degraded operation and recovery

  1. Run normal, peak, continuously degraded and recovery profiles against the current controlled Samawah scenario using the multi-day soak harness. 2. Exercise shared battery/cabin thermal control: pack cooling, traction derate and protection take priority over comfort. 3. Remove the network path. Stored plan plus sensor localisation may retain route intent only when two fresh, trusted inputs match exactly; disagreement holds. 4. Rehearse corridor recovery from every-third-station sidings with the fail-held shunt-robot model, while retaining separation, route locking, detected points, speed supervision and emergency braking requirements. 5. Review bounded queues, historian tiers, events, CBM state, work-order evidence and the resilience report; proceed to HIL and physical trials before any safety claim.

Scenario 6 — Use multi-model AI for administration without delegating authority

  1. Freeze the ERP/SCADA context and ask the experimental executive council for an allowlisted budget, maintenance, material-request or work-order proposal. 2. Collect blind ballots from strategy, finance, operations and risk identities spanning at least two providers and three model families. 3. Require 75% endorsement; any rejection, missing perspective, stale context or diversity failure routes the proposal to human review. 4. Deterministically verify the policy, context, proposal and ballot hashes, then require an operator-keyed attestation. 5. Let ERPNext independently verify and map the result to an unsubmitted draft. Models cannot pay, contract, hire/fire, certify, release engineering, operate SCADA or command trains.

For a single runnable story joining planning, ERPNext, manufacturing, FUXA, native Rust evaluation, maintenance, restart and clean-volume recovery, follow the Samawah example-city acceptance.

What is ready for what?

Product Current maturity Credible use now
Design and delivery platform Serious demonstration City GIS, alignment, service, cost, IFC, procurement, schedule, project twin and engineering coordination.
Train and infrastructure reference system Engineering development Local-manufacture planning, supplier RFQs, prototype definition, BIM coordination and civil option studies.
Open GoA 4 control system R&D / pre-certification Deterministic simulation, shadow mode, formal review and HIL preparation—not live railway command.

The first adoptable product does not require a new autonomous railway. Start with an existing depot, workshop or pilot corridor and deploy the non-safety owner/operator stack: asset register, project controls, simulator, Ops Core, QA, maintenance and evidence portal. See the first-adoptable-product boundary.

See the current system

Unified lifecycle workspace ERPNext city execution Embedded supervision
Installed Workbench lifecycle overview and city deployment status Native ERPNext project and OpenSourceRail operating actions inside Workbench FUXA vehicle condition monitoring from Rust evaluators
City Studio Civil IFC coordination Trainset assembly
City Studio deterministic GIS workspace Bonsai IFC4.3 construction sequence LM3 complete 146-node assembly

These are captures of the installed simulation platform and generated engineering models, not UI mockups. Reproduce the Workbench captures with capture-platform.mjs, or watch the 88-second product assembly and 48-second civil IFC sequence.

The economic case

The platform is designed to let a public owner competitively procure ordinary civil works, vehicle structures, GFRP panels, interiors, wiring, installation and maintenance locally, importing specialist components where local suppliers are not yet qualified. The reference model uses about $0.9M per 3-car light-metro trainset (current build record: $885k), a factory-gate planning target whose BOM, labour and contingency basis remains subject to supplier/process qualification. Delivered procurement must separately price engineering, homologation, commissioning, warranty and spares. The $60k per supported vehicle/car module country factory allowance scales with fleet size; national capital uses the larger of that allowance and the physical city-order factory envelope. Workshop budgets must account for the actual buildings, equipment, tooling, test paths and production-readiness work. The Iraq strategy publishes conditional city studies; a consolidated national budget, funded deployment and realised national saving remain unestablished. Transparent code and COTS choices expose assumptions for review; independently calibrated demand, risk and comparable bids are still needed to control optimism bias.

For an illustrative $100M OpenSourceRail scope, the editable default comparison applies a 2.0× foreign-turnkey price with 90% requiring foreign currency or international capital:

Same modelled railway scope Localisation-first OpenSourceRail Foreign-turnkey sensitivity
Programme price $100.0M $200.0M
Value not requiring external capital $79.1M $20.0M
External-capital requirement $20.9M $180.0M

In that scenario, the external-capital requirement is $159.1M (88.4%) lower before interest. Across the 265-city model, about $488B—roughly 79% of programme value—is assigned to domestic activity. Scope snapshot: 7 October 2026, retained catalogue finance; excludes adoption of the revised Baghdad scenario. These are reproducible planning sensitivities, not bids, audited origin claims or financing offers. Review the assumptions, low/default/high comparisons and financing cases in the portfolio calculation.

Run it

On Debian, Ubuntu, Mint, Fedora, RHEL, Rocky, AlmaLinux, CentOS, openSUSE or Arch Linux, install, build and launch the Workbench; or run the deterministic simulator and test harness:

./install.sh
./osr build
./osr book
./osr
./osr sim --duration 3600 --status-every 300
./osr test

Open http://127.0.0.1:8090/. The shared design workflow adds local jobs, validated installed BOMs, guided manufacturing/site/foundation inputs, independently reviewed revisions, broader civil/vehicle alternatives and scoped evidence verification; see the 36-package acceptance status and capability directory. The local server is not an authenticated public deployment. The installer reports existing tools before changing anything and offers larger engineering applications separately. Disposable output goes under build/ and target/release/; public review artifacts remain tracked outside those trees.

Find Your Way

If you are… Start with…
A city or transport planner City Studio, city catalogue, cost model and portfolio
A civil/BIM engineer Civil system, Bonsai IFC workflow, BIM reference package and survey gates
A rolling-stock, supplier or manufacturing engineer LM3 reference, buildable trainset, supplier technical-support package, CAD models and factory readiness
Researching component and system best practice Source-backed handbook, installed design twin, design expansion review, component mapping and OSR-BP-001
An operator or maintainer Operations, Workbench, connected lifecycle and example-city deployment
An ERP/SCADA integrator Operating platform, ERPNext setup, supervision gateway and embedded contract
A software or assurance reviewer Rust workspace, software architecture, formal results, safety case, assurance/authorization framework, manufactured viaduct review, controls and financial review and historical codebase review
A public owner, funder or delivery partner October 5 cost and demand reconciliation, latest Baghdad staffing, depot, local-production and funding recalculation, complete Baghdad proposal, Baghdad-only original reference funding programme, competitive position and proof roadmap, owner–builder–operator plan, mobilisation status, JV/development framework, partnership status and supplier-support status
A contributor Contributing guide, governance, change log and release checklist

Source Of Truth

Source-locked inputs → validated candidate and deterministic generators → content-addressed Git-reviewable revision → GIS/OSR-ALN/CAD/IFC/cost/simulation/project-twin outputs → independent evidence, named approval and operational baseline.

This root README is the only human-facing front door. A hash proves which bytes were reviewed; it does not approve them. Generated city packages still require survey, calibrated demand, utility and ground data, supplier qualification, first-article manufacture and testing, competent engineering review and national authorization. The principal editable sources are:

Concern Source of truth Generated/review output
Architecture and decisions docs/ARCHITECTURE.md, accepted docs/rfcs/ Diagrams, guides and summaries
Rust behavior and simulation crates/ and tests Applications, traces and coverage evidence
City synthesis and shared assumptions design/city-generation/, lib/templates/, lib/recipes/, lib/city-batches/world-sample.toml City catalogue, service, finance and engineering packages
Iraqi funding and current publication lib/templates/baghdad-programme-recalculation.toml, lib/templates/iraq-funding.toml, controlled procurement schedules and lib/templates/city-publication.toml Current Baghdad summary, latest scope and funding cases; original catalogue appraisals are labelled separately
Interactive city revisions cities/workspaces/ Content-addressed candidates and exports
Mechanical/station/civil geometry design/component-catalogue/src/osr_mech/ FreeCAD, IFC, BOM, traveler and image artifacts
Component and system practice research engineering/best_practice/data/, linked to existing standards controls Reproducible handbook, catalogue coverage and open verification/backlog plans
ERP and supervision integration deployment/erpnext/, deployment/supervision/, services/integration/ ERP workflows, FUXA views, history and maintenance evidence
Survey and released alignment Accepted deployment GIS and OSR-ALN sources QGIS, GeoPackage, corridor and IFC alignment evidence
Assurance and approval docs/certification/, docs/safety-case/, engineering/assurance/formal/ Proof records, verification status and acceptance reports

The local validation workflow keeps compute on your machine and GitHub for source and reviewed artifacts; GitHub Actions are disabled. Start with ./osr validate run --profile quick. The artifact policy retains useful CAD, IFC, PDF, image and animation evidence with a 50 MiB per-file ceiling.

License

Software is Apache 2.0. Control electronics and open physical designs use CERN-OHL-S v2. Documentation is CC-BY-SA 4.0. See LICENSE.md and LICENSES/ for the full texts.

About

Open-source urban rail design, simulation, operations, QA, maintenance, and certification-evidence stack for locally manufactured light metro systems.

Topics

Resources

Contributing

Stars

6 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages