Runtime Architecture

GSL Runtime

A single universal input layer sitting in front of four independent solver engines — CVRP, VRPTW, MDVRP, and MDVRPTW. It handles file parsing and ZIP extraction consistently across all modules, while each module's problem-specific logic and feasibility rules remain fully independent.

Supported Input Formats

Upload directly, or as a ZIP archive. When a ZIP contains more than one candidate file, the Runtime selects one automatically using the priority order below.

PriorityFormatDescription
1.csvUnified tabular format — the primary format for real-world operational data
2.xlsx / .xlsBusiness/Excel format
3.vrpClassic CVRPLIB-style benchmark format
4.txtClassic Solomon-style benchmark format
5(no extension)Legacy benchmark instances with no file suffix (e.g. "pr10")
Note: file extension is used as a candidate hint only — it is never treated as a confirmed format. Every file still passes through the selected module's own structural validation before solving begins.

How It Works

One instance per request. The Runtime does not run batch/folder jobs — each upload is solved individually.

1
Select Module
2
Upload File / ZIP
3
Structural Validation
4
Deterministic Solve
5
Report + Download

Fast-Fail Module Matching

If the uploaded data doesn't structurally match the selected module, the Runtime rejects it immediately with a clear message — instead of silently mis-parsing the file or consuming credits on a meaningless result.

[ERROR] Data looks like VRPTW (Solomon-style time-window columns detected). Please select the VRPTW module instead.

Four Independent Modules

The input layer is shared. The problem-solving logic underneath is not — each module has its own parser, its own feasibility rules, and its own solver.

CVRP

Capacitated Vehicle Routing. Single depot, vehicle capacity constraints only.

VRPTW

Adds customer time-window and service-time constraints on top of capacity.

MDVRP

Multi-Depot routing — requires at least two depots explicitly marked in the data.

MDVRPTW

Multi-Depot routing combined with time-window and route-duration constraints.

Output

Every run returns a full .sol report directly in the browser — unchanged from the original engine output — plus two additional downloadable formats built on top of it.

--- GSL ENGINE: UNIVERSAL MASTER DEPLOYED --- Dimension : 469 Cost : 220529.09 Vehicles : 138 / 138 Time : 0.8531s -------------------------------------------------- Route #1: 4 1 2 Route #2: 3 ... -------------------------------------------------- STATUS: VERIFIED BY GSL ALGORITHM (FEASIBLE)

.sol

The original engine report, byte-for-byte unchanged.

.xlsx

Business-readable workbook with Summary, Fleet, Routes, and (when supplied) Baseline Comparison sheets.

.csv

Structured output, one row per stop — ready to feed into another system.

JSON (internal)

A canonical Unified Output object used internally to generate .xlsx/.csv, reserved for a future API/middleware — not offered as a direct download in this phase.

Baseline Comparison (Optional)

Before running a job, you can optionally provide a baseline to compare against — either typed in directly or extracted from an existing routing report.

Manual Entry

Type in the company's existing cost, distance, time, and vehicle count directly.

Upload Baseline File

Only scalar metrics (cost, distance, time, vehicles) are extracted. The baseline's own route sequence is never used as GSL input.

Note: comparison output (cost saving, vehicle reduction, etc.) only appears when a baseline was actually supplied. If no baseline is provided, the solve runs and returns results exactly as before.

Ready to Run Your Own Data?

Upload a file directly, or try a live demo dataset with no account required.

Launch GSL Solver View Research & Benchmarks