02TODLab carries the routine evidence base of a municipal transport office from raw tables to styled maps and one documented report: station-area assessment for transit-oriented development (TOD), traffic counts to annual average daily traffic (AADT), motorised, pedestrian, bicycle and walkway level of service (LOS), and kerb-parking surveys. It works in one dock panel and through 20 Processing algorithms. It needs nothing beyond QGIS (NumPy and the Python standard library ship with it) and makes no network request: GTFS feeds, counts and surveys are read from local files or layers.
All metric work happens in a projected CRS in metres. A geographic or non-metric input is reprojected to the UTM zone of its extent centre; outputs are written in that working CRS and the log says so. Traffic equations calibrated in US units (ft, mph, \(\mathrm{pc/mi/ln}\)) are evaluated in those units and reported in both SI and US units.
Station-area TOD assessment, traffic-count processing, level-of-service screening and parking surveys are the routine evidence base of a municipal transport office, yet none of them has a QGIS tool that carries the work from raw tables to a map and a documented result. On the QGIS plugin repository (searched 14 November 2026) there is no plugin for the node-place model or a TOD index, none that turns counts into AADT and none that computes HCM-style level of service. The nearest neighbours answer different questions: Parking Spaces locates garages and street parking that could move into them; ParkSense Metrics estimates supply and parking pressure from footprints and points of interest; Traffica UE Analytics and QAequilibraE model demand and assignment; UrbanSafeID screens road safety; OS-WALK-EU and Walk Potential score walkability. Outside QGIS the work is scattered across a browser tool for one metro corridor (TODSphere), an inactive R package (MMLOS), city-specific notebooks (Toronto's Traffic Prophet) and research code.
02TODLab is one panel plus Processing tools for four jobs: (1) station catchments (buffer, network pedshed or your polygons), 5D built-environment indicators, Bertolini's node-place model with GTFS-derived node indicators and a composite TOD index with equal, AHP or PCA weights; (2) traffic-count quality control, AADT at continuous stations (AASHTO and the TMG 2022 hour-based procedure), factor groups, short-count expansion, \(K\), \(D\) and \(\mathrm{PHF}\), and AADT mapped onto road segments with a log-linear model for uncounted links; (3) motorised LOS (basic freeway and multilane density, urban street speed ratio, \(v/c\)) from that AADT, plus pedestrian, bicycle and walkway LOS; (4) a kerb-parking survey (inventory, occupancy by beat, the 85 % rule, turnover, duration, overstay from privacy-hashed plates, demand-responsive pricing, spare capacity within walking reach) on block-face geometry with a temporal layer. It analyses observed data only: it does not estimate demand from land-use rates, assign traffic or compute level of traffic stress.
In QGIS: Plugins › Manage and Install Plugins, search for 02TODLab, install. From a release zip: Plugins › Manage and Install Plugins › Install from ZIP. Requirements: QGIS 3.28 or later (QGIS 4 included). The toolbar button opens the dock; the algorithms appear in the Processing Toolbox under 02TODLab.
In Processing, run Demo district to get the same layers (and the GTFS zip), then TOD and traffic lab (all modules) or any single tool on them. The values the analysis must recover are planted in the generator; see the worked example.
A dark icon rail on the left of the dock switches pages; Help is pinned at the bottom. Each page is a column of numbered steps followed by a results card. Every indicator, letter chip and method has a tooltip with its formula and reference.
(1) Units and working CRS: SI or US customary units for the LOS pages; a badge shows the working CRS of the current station layer and why it was chosen. (2) Demo district: load or remove it. (3) Modules: one card per module (TOD, AADT, LOS, Parking) showing not run or done with a key number; a click opens the page.
(1) Stations: point layer and id field. (2) Catchments: radius chips (400 m, 800 m or your own), an optional network pedshed with the street layer and budget, or a polygon layer joined by station id. (3) Data layers: residents, jobs, dwellings (points or polygons, polygons areal-weighted), land use with its category field, destinations with a weight and the Hansen \(\beta\), transit stops, and the street type field for the pedestrian share. (4) GTFS node indicators: zip file, service date and time window. (5) Node-place model: pick node and place indicators and their weights. (6) Composite TOD index: indicators, a cost toggle per indicator, normalisation and weighting chips (equal, manual, AHP, PCA). AHP opens a pairwise matrix editor: a Saaty 1-9 combo per upper cell, reciprocals filled below and a live consistency-ratio gauge that turns red when \(\mathrm{CR} > 0.10\); the run refuses an inconsistent matrix. (7) Run. Results: the node-place diagram (balance band, stress and dependency corners, stations coloured by class), KPI cards (stations, balanced share, top score), a ranked table and the station map styled by class.
(1) Count stations: point layer with id, and optional kind (ccs / short), factor group and segment id fields. (2) Hourly counts: a CSV file or a table, with a column mapping and the hour-ending switch. (3) Quality check: an issue table and a calendar heat strip per station (flags only). (4) AADT method and factor groups: hour-based TMG 2022, AASHTO or simple; groups from a field or k-means. (5) Road segments and the model: snap tolerance and model covariates. Results: KPI cards (stations, continuous, short, segments counted and modelled, LOOCV MAPE), monthly and day-of-week factor charts per group, the ranked-hour curve with the 30th hour marked, and the AADT map (line width by AADT, dashes for modelled links).
Two tabs. Motorised: segments and facility field (or a default), \(K\), \(D\) and \(\mathrm{PHF}\) from the AADT result or typed, \(E_T\), speed limit, free-flow and observed speed fields, urban lane capacity. Results: an LOS distribution bar, the map coloured by letter and a table of LOS F segments. Pedestrian & bicycle: a column-mapping table (streetlos column, meaning, unit, layer field), units, the platoon switch and an override editor for any breakpoint table. Results: side-by-side letter bars and a flags list.
(1) Block faces and inventory: id, spaces, zone, space type, facility, time limit, unavailable windows and rate fields. (2) Occupancy counts: a CSV file or table with face, beat and vehicles columns. (3) Plate survey (optional): sightings with hashed tokens, or raw plates with a salt (password field, New salt button, Hash the raw CSV tool), beat length and gap tolerance. (4) Targets and pricing: target occupancy (default 85 %), practical factors, pricing policy and rate period. Results: KPI cards (spaces, peak occupancy, faces above target, turnover, overstay share), the accumulation curve, a zone \(\times\) hour heat map, the recommended rate table and the map styled by peak occupancy with a break at the target; the occupancy-by-beat layer is temporal, so the Temporal Controller animates it. (5) Spare capacity near destinations: destinations, walking radius, optional streets and a beat.
Choose the modules, the folder and the file stem; write one self-contained HTML report (inline CSS, SVG charts and an offline KaTeX bundle that typesets every formula; no remote resource), one CSV per result layer, or one GeoPackage with every result layer.
A short guide per page, the method references, the calibration and copyright note, and links to this manual and the repository.
Symbols are defined under each equation. Traffic models calibrated in US units take widths in ft, speeds in mph and densities in \(\mathrm{pc/mi/ln}\); the plugin converts SI inputs before evaluating them and reports both.
Euclidean buffers of \(r = 400\,\mathrm{m}\) and \(r = 800\,\mathrm{m}\) (5- and 10-minute walk; Guerra et al. 2012) are built as equal-area polygons whose area is exactly \(\pi r^2\). Network pedsheds come from a walk graph of the streets: both directions are walked, un-noded T-junctions are split, the station's connector to the nearest street is subtracted from the budget, the last edge is trimmed at the exact budget point, and the reached pieces are buffered and dissolved. User polygons are joined by station id. The pedshed ratio (Calthorpe 1993; Porta & Renne 2005) is
\[ R_{\mathrm{ped}} = \frac{A_{\mathrm{ped}}}{\pi r^{2}} \tag{1} \]where \(A_{\mathrm{ped}}\) is the area of the network pedshed (\(\mathrm{m^2}\)) and \(r\) the walking budget (m).
A polygon count (residents, jobs, dwellings) is shared among catchments in proportion to area (Goodchild & Lam 1980):
\[ x_{C} = \sum_{P} x_{P}\,\frac{\lvert P \cap C \rvert}{\lvert P \rvert} \tag{2} \]where \(x_P\) is the value carried by source polygon \(P\), \(C\) the catchment and \(\lvert\cdot\rvert\) the area.
After Cervero & Kockelman (1997) and Ewing & Cervero (2010): residents \(P\), jobs \(J\) and dwellings and their densities per hectare of catchment area \(A_C\); activity density \((P + J)/A_C\) in \(\mathrm{ha^{-1}}\); street length and intersection density (nodes of degree \(\ge 3\)) per \(\mathrm{km^2}\); pedestrian street share; destinations; transit stops; nearest station. Land-use mix is the normalised Shannon entropy (Frank et al. 2004):
\[ E = -\frac{\sum_{k=1}^{K} p_{k} \ln p_{k}}{\ln K} \tag{3} \]where \(p_k\) is the share of land use \(k\) in the catchment (by area for polygons, by weight for points) and \(K\) the number of land-use categories in the study; \(E = 0\) when \(K < 2\) and \(E \in [0, 1]\).
\[ B = 1 - \frac{\lvert J - rP \rvert}{J + rP} \tag{4} \]where \(J\) and \(P\) are the jobs and residents of the catchment and \(r\) the regional jobs per resident (or the value given); \(B = 1\) is the regional balance, \(B = 0\) a catchment with only jobs or only residents.
\[ G_{i} = \sum_{d} w_{d}\, e^{-\beta\, d_{id}} \tag{5} \]is the Hansen (1959) gravity accessibility of station \(i\), where \(w_d\) is the weight of destination \(d\) inside the catchment, \(d_{id}\) its distance to the station (m) and \(\beta\) the decay per metre (\(\beta > 0\) enables it). The population-weighted mean distance to the station is \(\bar{d} = \sum_{p} n_{p} d_{p} / \sum_{p} n_{p}\) over resident features \(p\) with count \(n_p\) (network distance in a pedshed).
Distinct trips boarding in the window, distinct routes, distinct modes (route_type), the busiest
clock hour, and the mean headway of the most frequent route and direction,
\(h = T_{w} / n_{\max}\), with \(T_w\) the window length (min) and \(n_{\max}\) the departures of that route and
direction in the window. Stops within 150 m, and stops sharing a parent_station, belong to a
station.
Bertolini (1999). Each indicator is min-max normalised over the stations, \(\tilde{x}_{k} = (x_{k} - x_{k,\min}) / (x_{k,\max} - x_{k,\min})\) (a constant indicator maps to 0.5), and the node and place indices are weighted means
\[ N = \sum_{k \in \mathcal{N}} w_{k}\, \tilde{x}_{k}, \qquad L = \sum_{k \in \mathcal{L}} w_{k}\, \tilde{x}_{k}, \qquad \sum_{k} w_{k} = 1 \tag{6} \]where \(\mathcal{N}\) and \(\mathcal{L}\) are the node and place indicator sets and \(w_k\) their weights (equal unless given, rescaled to sum to one). Stations are classed by
\[ \text{class} = \begin{cases} \text{unsustained node} & N - L > \delta \\ \text{unsustained place} & L - N > \delta \\ \text{stress} & \lvert N - L \rvert \le \delta \text{ and } \tfrac{1}{2}(N + L) \ge s \\ \text{dependency} & \lvert N - L \rvert \le \delta \text{ and } \tfrac{1}{2}(N + L) \le d \\ \text{balanced} & \text{otherwise} \end{cases} \tag{7} \]with balance band \(\delta = 0.2\), stress threshold \(s = 0.7\) and dependency threshold \(d = 0.3\). These thresholds are package conventions (Reusser et al. 2008; Vale 2015).
OECD & JRC (2008). Each indicator is normalised by min-max, \(z = (x - x_{\min})/(x_{\max} - x_{\min})\), or z-score, \(z = (x - \bar{x})/s_x\) with the sample standard deviation; a cost indicator (lower is better) is inverted, \(z = (x_{\max} - x)/(x_{\max} - x_{\min})\) or \(z = -(x - \bar{x})/s_x\). The score of station \(i\) is
\[ S_{i} = \sum_{k=1}^{m} w_{k}\, z_{ik}, \qquad \sum_{k=1}^{m} w_{k} = 1 \tag{8} \]with weights equal, manual, AHP or PCA. Rank 1 is the highest score; ties share the best rank.
AHP (Saaty 1980): \(\mathbf{w}\) is the normalised principal eigenvector of the reciprocal pairwise matrix \(A\), \(A\mathbf{w} = \lambda_{\max}\mathbf{w}\), with
\[ \mathrm{CI} = \frac{\lambda_{\max} - n}{n - 1}, \qquad \mathrm{CR} = \frac{\mathrm{CI}}{\mathrm{RI}_{n}} \tag{9} \]where \(\lambda_{\max}\) is estimated as the mean of \((A\mathbf{w})_i / w_i\), \(n\) is the number of criteria and \(\mathrm{RI}_n\) Saaty's random index; a matrix with \(\mathrm{CR} > 0.10\) is refused.
PCA: the eigen-decomposition of the indicator correlation matrix keeps the components with eigenvalue \(\lambda_c > 1\) (at least one, unrotated). With loadings \(\ell_{kc} = v_{kc}\sqrt{\lambda_c}\),
\[ w_{k} \propto \max_{c} \left( \frac{\ell_{kc}^{2}}{\sum_{j} \ell_{jc}^{2}} \cdot \frac{\lambda_{c}}{\sum_{c'} \lambda_{c'}} \right) \tag{10} \]where \(v_{kc}\) is the eigenvector entry of indicator \(k\) on retained component \(c\); the weights are then rescaled to sum to one.
Flags only, the data are never changed: missing hours, zero runs (6 h), constant runs (4 h), a ceiling, and robust outliers within each day-of-week \(\times\) hour group (Iglewicz & Hoaglin 1993):
\[ z = \frac{0.6745\, \lvert x - \tilde{x} \rvert}{\mathrm{MAD}}, \qquad \mathrm{MAD} = \operatorname{median} \lvert x - \tilde{x} \rvert, \qquad \text{flag if } z > 5 \tag{11} \]where \(x\) is the hourly volume and \(\tilde{x}\) the median of its group.
AASHTO method (FHWA TMG 2013 §3.2.1; AASHTO 2009):
\[ \mathrm{AADT} = \frac{1}{7} \sum_{i=1}^{7} \left[ \frac{1}{12} \sum_{j=1}^{12} \left( \frac{1}{n_{ij}} \sum_{k=1}^{n_{ij}} \mathrm{VOL}_{ijk} \right) \right] \tag{12} \]where \(\mathrm{VOL}_{ijk}\) is the daily traffic of the \(k\)-th occurrence of day of week \(i\) in month \(j\) and \(n_{ij}\) the number of such days with data; the inner mean is the monthly average day of week \(\mathrm{MADW}\).
Hour-based procedure (FHWA TMG 2022 §3.1.4.7):
\[ \mathrm{MADT}_{m} = \frac{\sum_{j} w_{jm} \sum_{h=0}^{23} \left( \frac{1}{n_{hjm}} \sum_{i} \mathrm{VOL}_{ihjm} \right)}{\sum_{j} w_{jm}}, \qquad \mathrm{AADT} = \frac{\sum_{m} d_{m}\, \mathrm{MADT}_{m}}{\sum_{m} d_{m}} \tag{13} \]where \(\mathrm{VOL}_{ihjm}\) is the volume of hour \(h\) on the \(i\)-th day of week \(j\) in month \(m\), \(n_{hjm}\) the number of such hours with data, \(w_{jm}\) the number of times day of week \(j\) occurs in month \(m\) of the year (4 or 5) and \(d_m\) the number of days in month \(m\).
Monthly \(f_{m} = \mathrm{AADT}/\mathrm{MADT}_{m}\), day-of-week \(f_{j} = \mathrm{AADT}/\mathrm{ADT}_{j}\) and month \(\times\) day-of-week \(f_{mj} = \mathrm{AADT}/\mathrm{MADW}_{mj}\). A group factor is the mean \(\bar{f}\) over its \(n\) stations, with relative precision (TMG 2022 §3.1.4.5, §3.2.6.2)
\[ \mathrm{RP} = \frac{t_{0.975,\,n-1}\; s_{f}}{\sqrt{n}\; \bar{f}} \tag{14} \]where \(s_f\) is the sample standard deviation of the station factors and \(t_{0.975,\,n-1}\) the two-sided 95 % Student \(t\) value. Groups come from a field or from k-means on the monthly factors (NCHRP Research Report 1081, as a reviewable starting point).
where \(\mathrm{VOL}_{24}\) is a 24-hour volume, \(M\) the monthly and \(D\) the day-of-week factor of the group, \(A\) the axle correction from \(V\) vehicles and \(N_{\mathrm{ax}}\) axles, \(G\) the growth factor for annual rate \(r\) over \(t\) years; the estimate is averaged over the complete days (TMG 2022 §3.2.8). The TMG worked example \(518 \times 0.95 \times 1.24 \approx 610\) is a test.
where \(V_{30}\) is the 30th highest hourly volume of the year, \(D\) the peak-direction share at that hour, \(V\) the volume of that hour and \(V_{15}\) its highest 15-minute count. \(\mathrm{PHF}\) needs 15-minute counts (a short count: at its peak hour); from hourly tables it stays NULL and the segment uses the default 0.92.
Stations join segments by a shared id field, else the nearest segment within the snap tolerance; directional stations on one segment are summed; an unmatched station is listed. Uncounted links use a log-linear model fitted by OLS (Mohamad et al. 1998; Zhao & Chung 2001):
\[ \ln \mathrm{AADT}_{i} = \mathbf{x}_{i}^{\top} \boldsymbol{\beta} + \varepsilon_{i} \tag{17} \]where \(\mathbf{x}_i\) holds an intercept, functional-class dummies, lanes, speed limit and optionally \(\ln(P_{500} + 1)\) with \(P_{500}\) the population within 500 m. Retransformation uses Duan's (1983) smearing factor and the 95 % prediction interval is
\[ S = \frac{1}{n} \sum_{i=1}^{n} e^{\hat{\varepsilon}_{i}}, \qquad \exp\!\Big( \mathbf{x}^{\top} \hat{\boldsymbol{\beta}} \pm t_{0.975,\,n-p}\, s \sqrt{1 + \mathbf{x}^{\top} (X^{\top} X)^{-1} \mathbf{x}} \Big)\, S \tag{18} \]where \(\hat{\varepsilon}_i\) are the residuals, \(n\) the counted segments, \(p\) the parameters, \(s\) the residual standard error and \(X\) the design matrix; the point estimate is \(e^{\mathbf{x}^{\top}\hat{\boldsymbol{\beta}}}\, S\). Leave-one-out residuals \(\hat{\varepsilon}_{i} / (1 - h_{ii})\), with leverage \(h_{ii} = \mathbf{x}_{i}^{\top} (X^{\top} X)^{-1} \mathbf{x}_{i}\), give LOOCV RMSE and \(\mathrm{MAPE} = \frac{100}{n} \sum_{i} \lvert \hat{y}_{(-i)} - y_{i} \rvert / y_{i}\) on the AADT scale. An unseen category level gives NULL; the model needs \(n \ge p + 5\).
where \(v_p\) is the flow rate (\(\mathrm{pc/h/ln}\)), \(N\) the lanes per direction, \(P_T\) the heavy-vehicle proportion and \(E_T = 2.0\) their passenger-car equivalent on level terrain.
where \(S\) is the mean speed (mph), \(\mathrm{FFS}\) the free-flow speed (mph), \(c\) the capacity, \(\mathrm{BP}\) the breakpoint, \(D_c\) the density at capacity and \(\rho\) the density (\(\mathrm{pc/mi/ln}\)); the ratio in the squared term is capped at 1. Basic freeway: \(c = 2200 + 10\,(\min(\mathrm{FFS}, 70) - 50)\) \(\mathrm{pc/h/ln}\), \(\mathrm{BP} = 1000 + 40\,(75 - \mathrm{FFS})\), \(D_c = 45\). LOS A \(\rho \le 11\), B \(\le 18\), C \(\le 26\), D \(\le 35\), E \(\le 45\), F above or when \(v_p > c\). Multilane highway: \(c = 1900 + 20\,(\min(\mathrm{FFS}, 60) - 45)\), \(\mathrm{BP} = 1400\), \(D_c = 40, 41, 43, 45\) for \(\mathrm{FFS} = 60, 55, 50, 45\) mph (linear in between), which is also the upper bound of E; flagged unverified.
Base free-flow speed from a field or \(S_{f0} = 25.6 + 0.47\, S_{pl}\) (mph), with \(S_{pl}\) the speed limit. LOS by the travel speed \(S_T\) as a percentage of the base free-flow speed, \(100\, S_T / S_{f0}\): A \(> 80\), B \(> 67\), C \(> 50\), D \(> 40\), E \(> 30\), F otherwise or when \(v/c > 1\) (HCM 2010 used 85 for A). Here \(v/c = v_p / c\) with the urban lane capacity \(c = 1900 \times g/C\) (\(855\,\mathrm{veh/h/ln}\) at \(g/C = 0.45\)). Without an observed speed only \(v/c\) is reported.
Pedestrian terms: \(F_{w} = -1.2276 \ln(W_{v} + 0.5\, W_{1} + 50\, p_{pk} + W_{buf} f_{b} + W_{aA} f_{sw})\), \(F_{v} = 0.0091\, v_{m} / (4 N_{th})\), \(F_{s} = 4\, (S_{R}/100)^{2}\). Bicycle terms: \(F_{w}' = -0.005\, W_{e}^{2}\), \(F_{v}' = 0.507 \ln\!\big(v_{ma} / (4 N_{th})\big)\), \(F_{s}' = 0.199\, \big(1.1199 \ln(S_{Ra} - 20) + 0.8103\big)(1 + 0.1038\, P_{HVa})^{2}\), \(F_{p} = 7.066 / P_{c}^{2}\). Here \(W_v\) is the volume-adjusted outside width (ft), \(W_1\) the bicycle lane plus shoulder width, \(p_{pk}\) the parking occupancy share, \(W_{buf}\) the buffer width with barrier factor \(f_b = 5.37\) (else 1), \(W_{aA} = \min(W_{sw}, 10)\) the sidewalk width with \(f_{sw} = 6.0 - 0.3\, W_{aA}\), \(v_m\) the directional flow (veh/h), \(N_{th}\) the through lanes, \(S_R\) the running speed (mph), \(W_e\) the effective width, \(v_{ma} = \max(v_m, 4 N_{th})\), \(S_{Ra} = \max(S_R, 21)\), \(P_{HVa}\) the adjusted heavy-vehicle percentage and \(P_c\) the pavement rating (0.5 to 5). Letters: A \(\le 2.00\), B \(\le 2.75\), C \(\le 3.50\), D \(\le 4.25\), E \(\le 5.00\), F above.
where \(v_p\) is the unit flow, \(v_{15}\) the peak 15-minute two-way pedestrian volume, \(W_E\) the effective width after shy distances, \(A_p\) the space per pedestrian, \(S_p\) the walking speed and \(V_h\) the hourly volume when no 15-minute volume is given. The model is evaluated in ft (\(v_p\) in \(\mathrm{p/min/ft}\), \(A_p\) in \(\mathrm{ft^2/p}\)) and reported in \(\mathrm{p/min/m}\) and \(\mathrm{m^2/p}\) with SI units. The letter is the worse of the space and flow letters, from the average-flow or the platoon table. Comfort flags: PROWAG 1.2 m clear width and 1.5 m passing space.
Every table can be overridden and carries its source, edition and a verified flag. HCM text is not reproduced; only equations and numeric thresholds as published in the cited open sources.
where \(o_{f,b}\) is the occupancy of block face \(f\) at beat \(b\), \(V_{f,b}\) the vehicles counted, \(S_{f,b}\) the legal spaces available at that beat (spaces in an unavailable window count as zero; vehicles above the spaces are kept and flagged), \(S_f\) the legal spaces, \(\tau = 0.85\) the target occupancy (85 % rule; Shoup 2005) and \(\phi = 0.85\) on-street or \(0.90\) off-street (planning conventions).
Plate survey: consecutive sightings of one token are one stay, with minimum duration \(t_n - t_1\) and estimated duration \(t_n - t_1 + b\) for first and last sightings \(t_1\), \(t_n\) and beat length \(b\); stays at session edges are censored. Overstay is judged against the posted limit on the minimum basis by default.
\[ T = \frac{N_{s}}{S_{f}}, \qquad T_{h} = \frac{T}{H}, \qquad U = \frac{\sum_{s} \hat{t}_{s}}{S_{f}\, H} \tag{24} \]where \(T\) is the turnover, \(N_s\) the number of stays on the face (a vehicle that leaves and returns counts twice), \(H\) the survey hours, \(\hat{t}_s\) the estimated duration of stay \(s\) (h) and \(U\) the utilisation (space-hours used over space-hours supplied). Mean and median durations also use the estimated durations.
Pricing: SFMTA demand-responsive policy (5 December 2017) on the mean occupancy \(\bar{o}\) of the rate period: \(\bar{o} \ge 0.80\): \(+0.25\); \(0.60 \le \bar{o} < 0.80\): hold; \(\bar{o} < 0.60\): \(-0.25\); rates kept in \([0.50,\ 8.00]\) per hour. The SFpark pilot table is the other built-in example; both are configurable.
\[ \text{spare} = \sum_{f \in \mathcal{R}} \max\!\left(0,\; C_{\mathrm{eff},f} - V_{f,b}\right) \tag{25} \]where \(\mathcal{R}\) is the set of block faces whose midpoint lies within the walking radius (straight line or walk graph) and \(b\) the chosen beat (default the study-wide peak).
Provider 02TODLab. Every algorithm copies its inputs first, works in the working CRS and writes outputs with real field types; nothing is styled inside the run. The tables below are generated from the algorithm definitions.
Builds the catchment of every station: one polygon per station and label.
Catchments: Euclidean buffers (label = radius, e.g. 400; area exactly \(\pi r^2\); 400 m and 800 m are the 5- and 10-minute walk), network pedsheds (label net800: street pieces reached within the walking budget, the last edge trimmed at the exact budget point, buffered by the pedshed buffer and dissolved; one-way streets are walked both ways; the station's connector to the street is subtracted from the budget) or your own polygons joined by station id (label poly). Pedshed ratio \(R_{\mathrm{ped}} = A_{\mathrm{ped}} / \pi r^2\) with \(A_{\mathrm{ped}}\) the pedshed area and \(r\) the budget.
Output fields: station_id, label, kind (buffer / network / poly), area_ha, pedshed_ratio (network catchments only).
Geographic or non-metric input is reprojected to the UTM zone of the layer centre; the outputs are written in that working CRS and the log says so.
| Name | Description | Type | Default | |
|---|---|---|---|---|
STATIONS | Stations | source | ||
STATION_ID | Station id field | field | station_id | |
RADII | Buffer radii (m, comma-separated) | string | 400, 800 | optional |
NETWORK_RADII | Network pedshed budgets (m, comma-separated; needs streets) | string | optional | |
STREETS | Street centre lines (for pedsheds and design indicators) | source | optional | |
PEDSHED_BUFFER | Pedshed buffer around reached streets (m) | number | 50.0 | advanced |
MAX_SNAP | Largest station-to-street distance (m) | number | 200.0 | advanced |
CATCHMENTS | Catchment polygons with a station id field (optional, label 'poly') | source | optional | |
OUTPUT | Catchments | sink |
| Name | Description | Type |
|---|---|---|
OUTPUT | Catchments | outputVector |
CATCHMENT_COUNT | Number of catchment polygons | outputNumber |
5D built-environment indicators per station and catchment (Cervero & Kockelman 1997; Ewing & Cervero 2010), as fields indicator_label (e.g. activity_density_400): residents, jobs and dwellings and their densities per ha; activity density \((P + J)/A_C\) per ha; normalised land-use entropy \(E = -\sum_k p_k \ln p_k / \ln K\) (Frank et al. 2004; polygons by area, points by weight); jobs-population balance \(B = 1 - \lvert J - rP \rvert / (J + rP)\) with \(J\) jobs, \(P\) residents and \(r\) the regional jobs per resident (or the value given); street length, intersections (degree \(\ge 3\)) per \(\mathrm{km^2}\) and pedestrian street share; destinations and Hansen gravity \(G = \sum_d w_d\, e^{-\beta d}\) (Hansen 1959; set \(\beta > 0\) to enable); transit stops; population-weighted mean distance to the station (network distance in a pedshed); nearest station.
Polygon population, jobs and dwellings are areal-weighted: a polygon \(P\) adds \(x_P \,\lvert P \cap C \rvert / \lvert P \rvert\) to catchment \(C\) (Goodchild & Lam 1980).
Catchments: Euclidean buffers (label = radius, e.g. 400; area exactly \(\pi r^2\); 400 m and 800 m are the 5- and 10-minute walk), network pedsheds (label net800: street pieces reached within the walking budget, the last edge trimmed at the exact budget point, buffered by the pedshed buffer and dissolved; one-way streets are walked both ways; the station's connector to the street is subtracted from the budget) or your own polygons joined by station id (label poly). Pedshed ratio \(R_{\mathrm{ped}} = A_{\mathrm{ped}} / \pi r^2\) with \(A_{\mathrm{ped}}\) the pedshed area and \(r\) the budget.
Geographic or non-metric input is reprojected to the UTM zone of the layer centre; the outputs are written in that working CRS and the log says so.
| Name | Description | Type | Default | |
|---|---|---|---|---|
STATIONS | Stations | source | ||
STATION_ID | Station id field | field | station_id | |
RADII | Buffer radii (m, comma-separated) | string | 400, 800 | optional |
NETWORK_RADII | Network pedshed budgets (m, comma-separated; needs streets) | string | optional | |
STREETS | Street centre lines (for pedsheds and design indicators) | source | optional | |
PEDSHED_BUFFER | Pedshed buffer around reached streets (m) | number | 50.0 | advanced |
MAX_SNAP | Largest station-to-street distance (m) | number | 200.0 | advanced |
CATCHMENTS | Catchment polygons with a station id field (optional, label 'poly') | source | optional | |
PEDESTRIAN_FIELD | Street type field for the pedestrian share (e.g. highway) | field | optional, advanced | |
PEDESTRIAN_VALUES | Values counted as pedestrian streets | string | pedestrian, footway, living_street, path, steps, residential | optional, advanced |
POPULATION | Residents (points or polygons) | source | optional | |
POPULATION_FIELD | Residents count field (empty: 1 per feature) | field | optional | |
JOBS | Jobs (points or polygons) | source | optional | |
JOBS_FIELD | Jobs count field (empty: 1 per feature) | field | optional | |
DWELLINGS | Dwellings (points or polygons) | source | optional | |
DWELLINGS_FIELD | Dwellings count field (empty: 1 per feature) | field | optional | |
LANDUSE | Land use (polygons by area, points by weight) | source | optional | |
LANDUSE_FIELD | Land-use category field | field | optional | |
LANDUSE_WEIGHT_FIELD | Land-use point weight field | field | optional, advanced | |
DESTINATIONS | Destinations (points) | source | optional | |
DESTINATION_WEIGHT_FIELD | Destination weight field | field | optional | |
GRAVITY_BETA | Hansen gravity decay \(\beta\) (per m; 0: off) | number | 0.0 | |
TRANSIT_STOPS | Transit stops (points) | source | optional | |
JOBS_PER_RESIDENT | Jobs per resident \(r\) (0: regional ratio) | number | 0.0 | advanced |
OUTPUT | Stations with indicators | sink | ||
CATCHMENTS_OUT | Catchments | sink | optional |
| Name | Description | Type |
|---|---|---|
OUTPUT | Stations with indicators | outputVector |
CATCHMENTS_OUT | Catchments | outputVector |
Node indicators of the node-place model from a local GTFS Schedule feed (zip file) for one service date (calendar.txt and calendar_dates.txt honoured, times past 24:00:00 included) and a time window: departures (distinct trips boarding at the station in the window), routes (distinct route_id), modes (distinct route_type), peak_departures_per_hour (busiest clock hour) and min_headway_min \(= T_w / n_{\max}\), the window minutes \(T_w\) over the departures \(n_{\max}\) of the most frequent route and direction (mean headway, TCQSM). A stop belongs to the nearest station within the stop radius; stops sharing a parent_station follow the station of their group. No network request is made.
Geographic or non-metric input is reprojected to the UTM zone of the layer centre; the outputs are written in that working CRS and the log says so.
| Name | Description | Type | Default | |
|---|---|---|---|---|
STATIONS | Stations | source | ||
STATION_ID | Station id field | field | station_id | |
GTFS | GTFS feed (zip) | file | ||
DATE | Service date (YYYY-MM-DD) | string | ||
WINDOW | Time window (HH:MM-HH:MM) | string | 07:00-09:00 | |
STOP_RADIUS | Stop-to-station radius (m) | number | 150.0 | |
PARENT_STATION | Stops sharing a parent_station join the same station | boolean | True | advanced |
OUTPUT | Stations with node indicators | sink |
| Name | Description | Type |
|---|---|---|
OUTPUT | Stations with node indicators | outputVector |
Bertolini's node-place model on an indicator table (for example the output of the indicator and GTFS tools). Node and place indices are weighted means of min-max normalised indicators (equal weights unless given as name=weight; ...). Classes, with node \(N\), place \(L\) and band \(\delta\): unsustained node when \(N - L > \delta\); unsustained place when \(L - N > \delta\); otherwise stress when \(\tfrac{1}{2}(N + L) \ge s\), dependency when \(\tfrac{1}{2}(N + L) \le d\), else balanced. Band \(\delta = 0.2\), stress \(s = 0.7\) and dependency \(d = 0.3\) are package conventions, stated as such.
Output: the input with node, place and np_class.
| Name | Description | Type | Default | |
|---|---|---|---|---|
INPUT | Station indicator layer or table | source | ||
STATION_ID | Station id field | field | station_id | |
NODE_FIELDS | Node indicators | field | ||
PLACE_FIELDS | Place indicators | field | ||
NODE_WEIGHTS | Node weights (name=weight; ...; empty: equal) | string | optional, advanced | |
PLACE_WEIGHTS | Place weights (name=weight; ...; empty: equal) | string | optional, advanced | |
BAND | Balance band | number | 0.2 | |
STRESS | Stress threshold | number | 0.7 | |
DEPENDENCY | Dependency threshold | number | 0.3 | |
OUTPUT | Node-place classes | sink |
| Name | Description | Type |
|---|---|---|
OUTPUT | Node-place classes | outputVector |
BALANCED | Balanced stations | outputNumber |
COUNTS | Stations per class | outputString |
A composite index (OECD & JRC 2008) of chosen indicators: each is normalised (min-max or z-score), cost indicators (lower is better, e.g. mean distance to the station) are inverted, and the score is the weighted sum \(S_i = \sum_k w_k z_{ik}\) with \(\sum_k w_k = 1\); rank 1 = highest score.
Weights: equal; manual (name=weight; ...); AHP, the principal eigenvector of a pairwise comparison matrix on Saaty's 1-9 scale given as a:b=3; a:c=5; b:c=2 (a is 3 times as important as b; \(1/3\) for the reverse; every pair needed), with \(\mathrm{CI} = (\lambda_{\max} - n)/(n - 1)\) and \(\mathrm{CR} = \mathrm{CI}/\mathrm{RI}_n\); the run refuses \(\mathrm{CR} > 0.10\) (Saaty 1980); or PCA (components with eigenvalue \(\lambda_c > 1\), squared loadings weighted by explained variance, unrotated).
Output: the input with tod_score and tod_rank.
| Name | Description | Type | Default | |
|---|---|---|---|---|
INPUT | Station indicator layer or table | source | ||
STATION_ID | Station id field | field | station_id | |
FIELDS | Indicators | field | ||
COST_FIELDS | Cost indicators (lower is better) | field | optional | |
NORMALIZATION | Normalisation | enum: Min-max / Z-score | Min-max | |
WEIGHTING | Weighting | enum: Equal / AHP / PCA / Manual | Equal | |
AHP_JUDGEMENTS | AHP judgements (a:b=value; ...) | string | optional | |
MANUAL_WEIGHTS | Manual weights (name=weight; ...) | string | optional | |
OUTPUT | Composite TOD index | sink |
| Name | Description | Type |
|---|---|---|
OUTPUT | Composite TOD index | outputVector |
CR | AHP consistency ratio | outputNumber |
WEIGHTS | Weights used | outputString |
Flags problems in hourly counts per station, never changing the data: missing hours, zero runs (default 6 h or longer), constant runs (4 h), values above a ceiling, and robust outliers \(z = 0.6745\, \lvert x - \tilde{x} \rvert / \mathrm{MAD} > 5\) (\(\tilde{x}\) the median) within each day-of-week \(\times\) hour group (Iglewicz & Hoaglin 1993). Directions and classes are summed per hour first.
The hourly count table (a CSV file or any table) needs one row per station, hour and (optionally) direction or vehicle class: a station id, a date-time (or a clock time plus a date column) and a volume. Rows without a volume are missing hours. Hour ending shifts stamps that mark the end of the hour back by one hour.
Outputs: a station table (hours_total, hours_flagged, completeness, first and last hour, issue count) and an issue table (kind, start, end, hours, detail).
| Name | Description | Type | Default | |
|---|---|---|---|---|
COUNTS | Hourly count table (CSV or table) | source | ||
COUNT_STATION | Station id column | field | station | |
COUNT_DATETIME | Date-time column (hour start) | field | datetime | |
COUNT_VOLUME | Volume column | field | volume | |
COUNT_DIRECTION | Direction column (for D) | field | optional | |
COUNT_CLASS | Vehicle class column (FHWA 1-13, for the truck share) | field | optional, advanced | |
COUNT_DATE | Date column (when the time column holds clock times) | field | optional, advanced | |
HOUR_ENDING | Stamps mark the end of the hour | boolean | False | advanced |
ZERO_RUN | Zero run length that is flagged (h) | number | 6 | advanced |
CONSTANT_RUN | Constant run length that is flagged (h) | number | 4 | advanced |
OUTLIER_Z | Robust z above which an hour is an outlier | number | 5.0 | advanced |
MAX_HOURLY | Hourly ceiling (0: none) | number | 0.0 | advanced |
OUTPUT | Quality per station | sink | ||
ISSUES | Quality issues | sink | optional |
| Name | Description | Type |
|---|---|---|
OUTPUT | Quality per station | outputVector |
ISSUES | Quality issues | outputVector |
HOURS_FLAGGED | Flagged hours (all stations) | outputNumber |
AADT of every continuous count station (CCS). Hour-based (FHWA TMG 2022 §3.1.4.7): \[ \mathrm{MADT}_m = \frac{\sum_j w_{jm} \sum_h \big( \frac{1}{n_{hjm}} \sum_i \mathrm{VOL}_{ihjm} \big)}{\sum_j w_{jm}}, \qquad \mathrm{AADT} = \frac{\sum_m d_m\, \mathrm{MADT}_m}{\sum_m d_m} \] AASHTO (TMG 2013 §3.2.1): \[ \mathrm{AADT} = \frac{1}{7} \sum_i \Big[ \frac{1}{12} \sum_j \Big( \frac{1}{n_{ij}} \sum_k \mathrm{VOL}_{ijk} \Big) \Big] \] Symbols as in Eqs. (12) and (13) of the methods section. Simple: mean of complete days. Empty month \(\times\) day-of-week cells are skipped with a note. Design hour: \(K = V_{30}/\mathrm{AADT}\) and \(D\) = peak-direction share at that hour (TMG 2022 §3.1.2). \(\mathrm{PHF} = V/(4 V_{15})\) at the design hour from 15-minute counts; NULL for hourly tables.
The hourly count table (a CSV file or any table) needs one row per station, hour and (optionally) direction or vehicle class: a station id, a date-time (or a clock time plus a date column) and a volume. Rows without a volume are missing hours. Hour ending shifts stamps that mark the end of the hour back by one hour.
A station is continuous when its kind field says ccs, or, without one, when it has at least the given number of complete days; other stations are listed and left out (use the short-count tool). Outputs: a station table and an optional MADT table (station, month, madt).
| Name | Description | Type | Default | |
|---|---|---|---|---|
COUNTS | Hourly count table (CSV or table) | source | ||
COUNT_STATION | Station id column | field | station | |
COUNT_DATETIME | Date-time column (hour start) | field | datetime | |
COUNT_VOLUME | Volume column | field | volume | |
COUNT_DIRECTION | Direction column (for D) | field | optional | |
COUNT_CLASS | Vehicle class column (FHWA 1-13, for the truck share) | field | optional, advanced | |
COUNT_DATE | Date column (when the time column holds clock times) | field | optional, advanced | |
HOUR_ENDING | Stamps mark the end of the hour | boolean | False | advanced |
STATIONS | Count stations (optional: kind and group fields) | source | optional | |
STATION_ID | Station id field | field | station | optional |
KIND_FIELD | Kind field (ccs / short; empty: by complete days) | field | optional | |
METHOD | AADT method at continuous stations | enum: Hour-based (FHWA TMG 2022) / AASHTO (TMG 2013) / Simple mean of days | Hour-based (FHWA TMG 2022) | |
DROP_FLAGGED | Drop hours flagged by quality control | boolean | True | |
MIN_DAYS | Complete days that make a station continuous | number | 300 | advanced |
DESIGN_HOUR | Design hour \(n\) (\(K = V_n / \mathrm{AADT}\)) | number | 30 | advanced |
OUTPUT | AADT per continuous station | sink | ||
MADT | Monthly average daily traffic | sink | optional |
| Name | Description | Type |
|---|---|---|
OUTPUT | AADT per continuous station | outputVector |
MADT | Monthly average daily traffic | outputVector |
STATIONS_CCS | Continuous stations | outputNumber |
Expansion factors from the continuous stations: monthly \(f_m = \mathrm{AADT}/\mathrm{MADT}_m\), day-of-week \(f_j = \mathrm{AADT}/\mathrm{ADT}_j\) and month \(\times\) day-of-week \(f_{mj} = \mathrm{AADT}/\mathrm{MADW}_{mj}\). A group factor is the mean \(\bar{f}\) over its \(n\) stations, with relative precision \(t_{0.975,\,n-1}\, s_f / (\sqrt{n}\, \bar{f})\) (TMG 2022 §3.1.4.5, §3.2.6.2). Groups come from a station field, else from k-means on the monthly factor vectors (deterministic for the seed; a reviewable starting point, NCHRP Report 1081), else one group all.
The hourly count table (a CSV file or any table) needs one row per station, hour and (optionally) direction or vehicle class: a station id, a date-time (or a clock time plus a date column) and a volume. Rows without a volume are missing hours. Hour ending shifts stamps that mark the end of the hour back by one hour.
Output: a long table group, type (monthly / dow / month_dow), month, dow (\(0\) = Monday), factor, precision, stations.
| Name | Description | Type | Default | |
|---|---|---|---|---|
COUNTS | Hourly count table (CSV or table) | source | ||
COUNT_STATION | Station id column | field | station | |
COUNT_DATETIME | Date-time column (hour start) | field | datetime | |
COUNT_VOLUME | Volume column | field | volume | |
COUNT_DIRECTION | Direction column (for D) | field | optional | |
COUNT_CLASS | Vehicle class column (FHWA 1-13, for the truck share) | field | optional, advanced | |
COUNT_DATE | Date column (when the time column holds clock times) | field | optional, advanced | |
HOUR_ENDING | Stamps mark the end of the hour | boolean | False | advanced |
STATIONS | Count stations (optional: kind and group fields) | source | optional | |
STATION_ID | Station id field | field | station | optional |
KIND_FIELD | Kind field (ccs / short; empty: by complete days) | field | optional | |
GROUP_FIELD | Factor group field (empty: k-means or one group) | field | optional | |
METHOD | AADT method at continuous stations | enum: Hour-based (FHWA TMG 2022) / AASHTO (TMG 2013) / Simple mean of days | Hour-based (FHWA TMG 2022) | |
DROP_FLAGGED | Drop hours flagged by quality control | boolean | True | |
MIN_DAYS | Complete days that make a station continuous | number | 300 | advanced |
DESIGN_HOUR | Design hour \(n\) (\(K = V_n / \mathrm{AADT}\)) | number | 30 | advanced |
K_GROUPS | Number of k-means groups (0: field or one group) | number | 0 | |
SEED | Random seed of k-means | number | 42 | advanced |
OUTPUT | Factors | sink |
| Name | Description | Type |
|---|---|---|
OUTPUT | Factors | outputVector |
GROUPS | Number of groups | outputNumber |
AADT of short counts (e.g. 48 h) expanded with the factors of their group built from the continuous stations in the same table: \(\mathrm{AADT} = \mathrm{VOL}_{24} \cdot M \cdot D \cdot A \cdot G\) averaged over the complete days (TMG 2022 §3.2.8; the TMG worked example \(518 \times 0.95 \times 1.24 \approx 610\)), axle correction \(A = V / (N_{\mathrm{ax}}/2)\) for \(V\) vehicles and \(N_{\mathrm{ax}}\) axles, growth \(G = (1 + r)^t\). Without a complete calendar day, consecutive 24-hour blocks are used. The 95 % interval uses the group's relative precision of the month and day-of-week factors.
The hourly count table (a CSV file or any table) needs one row per station, hour and (optionally) direction or vehicle class: a station id, a date-time (or a clock time plus a date column) and a volume. Rows without a volume are missing hours. Hour ending shifts stamps that mark the end of the hour back by one hour.
A short count belongs to the group named in the group field; with one group, every short count uses it. Output: one row per short count with aadt, aadt_lo, aadt_hi, factor_group, k_fac and d_fac (group means).
| Name | Description | Type | Default | |
|---|---|---|---|---|
COUNTS | Hourly count table (CSV or table) | source | ||
COUNT_STATION | Station id column | field | station | |
COUNT_DATETIME | Date-time column (hour start) | field | datetime | |
COUNT_VOLUME | Volume column | field | volume | |
COUNT_DIRECTION | Direction column (for D) | field | optional | |
COUNT_CLASS | Vehicle class column (FHWA 1-13, for the truck share) | field | optional, advanced | |
COUNT_DATE | Date column (when the time column holds clock times) | field | optional, advanced | |
HOUR_ENDING | Stamps mark the end of the hour | boolean | False | advanced |
STATIONS | Count stations (optional: kind and group fields) | source | optional | |
STATION_ID | Station id field | field | station | optional |
KIND_FIELD | Kind field (ccs / short; empty: by complete days) | field | optional | |
GROUP_FIELD | Factor group field (empty: k-means or one group) | field | optional | |
METHOD | AADT method at continuous stations | enum: Hour-based (FHWA TMG 2022) / AASHTO (TMG 2013) / Simple mean of days | Hour-based (FHWA TMG 2022) | |
DROP_FLAGGED | Drop hours flagged by quality control | boolean | True | |
MIN_DAYS | Complete days that make a station continuous | number | 300 | advanced |
DESIGN_HOUR | Design hour \(n\) (\(K = V_n / \mathrm{AADT}\)) | number | 30 | advanced |
K_GROUPS | Number of k-means groups (0: field or one group) | number | 0 | advanced |
AXLE_FACTOR | Axle correction factor \(A\) | number | 1.0 | |
GROWTH_RATE | Annual growth rate \(r\) (\(0.02\) = 2 percent) | number | 0.0 | advanced |
GROWTH_YEARS | Years of growth \(t\) | number | 0.0 | advanced |
OUTPUT | AADT of short counts | sink |
| Name | Description | Type |
|---|---|---|
OUTPUT | AADT of short counts | outputVector |
EXPANDED | Short counts with an AADT | outputNumber |
The whole counts-to-segments chain: quality control, AADT at continuous stations, factor groups, short-count expansion, matching to segments and the model for uncounted links.
Count stations are matched to road segments by a shared id field, else to the nearest segment within the snap tolerance; two directional stations on one segment are summed; an unmatched station is listed, never dropped silently. Continuous stations give AADT directly, short counts are expanded with their factor group. Segment fields: aadt, aadt_src (ccs / short / model / NULL), aadt_lo, aadt_hi, aadt_year, k_fac, d_fac, ddhv \(= \mathrm{AADT} \cdot K \cdot D\), phf, trk_pct, count_stations.
Uncounted links (optional): \(\ln \mathrm{AADT} = X\boldsymbol{\beta} + \boldsymbol{\varepsilon}\) by OLS with the chosen categorical and numeric segment fields (\(\ln x\) for the log fields) and optionally \(\ln(P_r + 1)\) with \(P_r\) the population within the radius (Mohamad et al. 1998; Zhao & Chung 2001); retransformation with Duan's smearing factor \(S = \frac{1}{n}\sum_i e^{\hat{\varepsilon}_i}\) (Duan 1983); 95 % prediction interval \[ \exp\!\Big( \mathbf{x}^{\top} \hat{\boldsymbol{\beta}} \pm t_{0.975,\,n-p}\, s \sqrt{1 + \mathbf{x}^{\top} (X^{\top} X)^{-1} \mathbf{x}} \Big)\, S \] leave-one-out residuals \(\hat{\varepsilon}_i/(1 - h_{ii})\) give LOOCV RMSE and MAPE. A category level unseen in the counted links gives NULL. The model needs \(n \ge p + 5\) counted segments, else it is skipped with a message.
The hourly count table (a CSV file or any table) needs one row per station, hour and (optionally) direction or vehicle class: a station id, a date-time (or a clock time plus a date column) and a volume. Rows without a volume are missing hours. Hour ending shifts stamps that mark the end of the hour back by one hour.
Geographic or non-metric input is reprojected to the UTM zone of the layer centre; the outputs are written in that working CRS and the log says so.
| Name | Description | Type | Default | |
|---|---|---|---|---|
COUNT_STATIONS | Count stations (points) | source | ||
STATION_ID | Station id field | field | station | |
KIND_FIELD | Kind field (ccs / short; empty: by complete days) | field | optional | |
GROUP_FIELD | Factor group field | field | optional | |
SEGMENT_ID_FIELD | Segment id field (same name on both layers; empty: nearest) | field | optional | |
COUNTS | Hourly count table (CSV or table) | source | ||
COUNT_STATION | Station id column | field | station | |
COUNT_DATETIME | Date-time column (hour start) | field | datetime | |
COUNT_VOLUME | Volume column | field | volume | |
COUNT_DIRECTION | Direction column (for D) | field | optional | |
COUNT_CLASS | Vehicle class column (FHWA 1-13, for the truck share) | field | optional, advanced | |
COUNT_DATE | Date column (when the time column holds clock times) | field | optional, advanced | |
HOUR_ENDING | Stamps mark the end of the hour | boolean | False | advanced |
SEGMENTS | Road segments | source | ||
SNAP_TOLERANCE | Snap tolerance (m) | number | 25.0 | |
METHOD | AADT method at continuous stations | enum: Hour-based (FHWA TMG 2022) / AASHTO (TMG 2013) / Simple mean of days | Hour-based (FHWA TMG 2022) | |
K_GROUPS | Number of k-means groups (0: field or one group) | number | 0 | advanced |
MODEL | Estimate uncounted segments with the log-linear model | boolean | True | |
MODEL_FIELDS | Model covariates | field | optional | |
LOG_FIELDS | Covariates entered as \(\ln x\) | field | optional, advanced | |
POPULATION | Population (adds \(\ln(P_r + 1)\), \(P_r\) the population within the radius) | source | optional | |
POPULATION_FIELD | Population field | field | optional | |
POPULATION_RADIUS | Population radius (m) | number | 500.0 | advanced |
DROP_FLAGGED | Drop hours flagged by quality control | boolean | True | advanced |
MIN_DAYS | Complete days that make a station continuous | number | 300 | advanced |
DESIGN_HOUR | Design hour \(n\) | number | 30 | advanced |
PHF | Default peak-hour factor | number | 0.92 | advanced |
SEED | Random seed | number | 42 | advanced |
OUTPUT | Segments with AADT | sink | ||
STATIONS_OUT | Count stations with AADT | sink | optional |
| Name | Description | Type |
|---|---|---|
OUTPUT | Segments with AADT | outputVector |
STATIONS_OUT | Count stations with AADT | outputVector |
COUNTED | Counted segments | outputNumber |
MODELLED | Modelled segments | outputNumber |
LOOCV_MAPE | LOOCV MAPE (percent) | outputNumber |
Flow rate (HCM 6): \(v_p = \mathrm{AADT} \cdot K \cdot D / (\mathrm{PHF} \cdot N \cdot f_{HV})\), \(f_{HV} = 1/\big(1 + P_T (E_T - 1)\big)\), \(E_T = 2.0\) on level terrain. \(K\), \(D\) and \(\mathrm{PHF}\) come from the parameters, else from the k_fac, d_fac and phf fields of the AADT tool, else 0.10, 0.55 and 0.92 (0.95 freeway).
Basic freeway (HCM 6 Ch. 12): \(c = 2200 + 10\,(\min(\mathrm{FFS}, 70) - 50)\) \(\mathrm{pc/h/ln}\); breakpoint \(\mathrm{BP} = 1000 + 40\,(75 - \mathrm{FFS})\); \(S = \mathrm{FFS}\) up to \(\mathrm{BP}\), else \(S = \mathrm{FFS} - (\mathrm{FFS} - c/45)\,\big((v_p - \mathrm{BP})/(c - \mathrm{BP})\big)^2\); density \(\rho = v_p/S\); LOS A \(\rho \le 11\), B \(\le 18\), C \(\le 26\), D \(\le 35\), E \(\le 45\,\mathrm{pc/mi/ln}\), F above or when \(v_p > c\). Multilane: \(c = 1900 + 20\,(\min(\mathrm{FFS}, 60) - 45)\), \(\mathrm{BP} = 1400\), the same speed-flow form with \(c/D_c\) in place of \(c/45\) and the E bound \(D_c\) set by FFS (table flagged unverified). Urban street (HCM 6 Ch. 18): base FFS from a field or \(S_{f0} = 25.6 + 0.47\, S_{pl}\) (mph); LOS by travel speed as a percent of base FFS: A \(> 80\), B \(> 67\), C \(> 50\), D \(> 40\), E \(> 30\), F otherwise or when \(v/c > 1\). Without an observed travel speed only \(v/c\) is reported (los_basis = v/c screening). \(v/c = v_p/c\), with the urban lane capacity \(c = 1900 \times g/C\).
Output fields: facility, v_p, ffs_kmh, capacity, v_c, speed_kmh, speed_pct, density_pckmln, density_pcmiln, los, los_basis, los_notes, los_range (letters at the ends of the 95 % AADT interval aadt_lo to aadt_hi when the segment carries one). US-calibrated models rank links relative to each other outside the US.
| Name | Description | Type | Default | |
|---|---|---|---|---|
SEGMENTS | Road segments with AADT | source | ||
FACILITY_FIELD | Facility field (freeway / multilane / urban) | field | optional | |
DEFAULT_FACILITY | Facility when the field is empty | enum: Basic freeway / Multilane / Urban street | Urban street | |
AADT_FIELD | AADT field | field | aadt | |
LANES_FIELD | Lanes per direction field | field | lanes | |
K | \(K\) factor (empty: k_fac field or 0.10) | number | optional | |
D | \(D\) factor (empty: d_fac field or 0.55) | number | optional | |
PHF | Peak-hour factor (empty: phf field or default) | number | optional | |
TRUCK_FIELD | Heavy vehicle percent field | field | optional | |
E_T | Passenger-car equivalent of heavy vehicles \(E_T\) | number | 2.0 | advanced |
FFS_FIELD | Free-flow speed field (km/h) | field | optional | |
SPEED_LIMIT_FIELD | Speed limit field (km/h) | field | optional | |
SPEED_FIELD | Observed travel speed field (km/h, urban streets) | field | optional | |
URBAN_LANE_CAPACITY | Urban lane capacity (\(\mathrm{veh/h/ln} = 1900 \times g/C\)) | number | 855.0 | advanced |
OUTPUT | Motorised LOS | sink |
| Name | Description | Type |
|---|---|---|
OUTPUT | Motorised LOS | outputVector |
LOS_F | Segments at LOS F | outputNumber |
Segment LOS after NCHRP Report 616 (Dowling et al. 2008; HCM 2010 Ch. 17). Pedestrian link score \(I_p = 6.0468 + F_w + F_v + F_s\) (cross-section, motor-vehicle volume and speed terms); bicycle link score \(I_b = 0.760 + F_w' + F_v' + F_s' + F_p\) (pavement); the terms are given in Eq. (21) of the methods section. Letters A \(\le 2.00\), B \(\le 2.75\), C \(\le 3.50\), D \(\le 4.25\), E \(\le 5.00\), F above. The walkway LOS (FHWA-RD-98-107) is computed too when pedestrian volumes are mapped; see the walkway tool. Comfort flags: PROWAG 1.2 m clear width and 1.5 m passing space; other flags are screening heuristics.
One feature is one side or direction. Map each streetlos column to a field; the motor-vehicle volume falls back to \(\mathrm{AADT} \cdot K \cdot D\) from the aadt, k_fac and d_fac fields of the AADT tool when volume_vph is not mapped. Missing inputs give NULL and a los_notes entry, never a letter. Bicycle LOS here is the NCHRP 616 perceived-quality score, not level of traffic stress (LTS).
| Name | Description | Type | Default | |
|---|---|---|---|---|
SEGMENTS | Street segments | source | ||
MAP_OUTSIDE_LANE | outside_lane: outside through lane width \(W_{ol}\) (m / ft) | field | optional | |
MAP_BIKE_LANE | bike_lane: bicycle lane width \(W_{bl}\) (m / ft) | field | optional | |
MAP_SHOULDER | shoulder: paved shoulder or parking lane width \(W_{os}\) (m / ft) | field | optional, advanced | |
MAP_CURB | curb: curb present (yes/no, default yes) (-) | field | optional, advanced | |
MAP_PARKING_OCCUPANCY | parking_occupancy: share of on-street parking occupied \(p_{pk} \in [0, 1]\) (-) | field | optional, advanced | |
MAP_PARKING_STRIPED | parking_striped: parking spaces striped (yes/no) (-) | field | optional, advanced | |
MAP_BUFFER | buffer: buffer between sidewalk and road \(W_{buf}\) (m / ft) | field | optional | |
MAP_BARRIER | barrier: continuous barrier \(\ge 0.9\,\mathrm{m}\) (\(3\,\mathrm{ft}\)) in the buffer (yes/no) (-) | field | optional, advanced | |
MAP_SIDEWALK_WIDTH | sidewalk_width: sidewalk width excluding the buffer (m / ft) | field | optional | |
MAP_BUILDING_EDGE | building_edge: none / building / window_display / fence / low_wall (-) | field | optional, advanced | |
MAP_OBSTRUCTIONS | obstructions: ';'-separated obstruction names or widths in the walking path (m / ft) | field | optional, advanced | |
MAP_VOLUME_VPH | volume_vph: motor-vehicle flow in this direction (veh/h) | field | optional | |
MAP_THROUGH_LANES | through_lanes: through lanes in this direction (-) | field | optional | |
MAP_SPEED | speed: motor-vehicle running speed (km/h / mph) | field | optional | |
MAP_HEAVY_VEHICLE_PCT | heavy_vehicle_pct: heavy vehicles (%) | field | optional, advanced | |
MAP_PAVEMENT_RATING | pavement_rating: pavement condition \(P_c \in [0.5, 5]\) (-) | field | optional | |
MAP_DIVIDED | divided: divided street (yes/no) (-) | field | optional, advanced | |
MAP_PED_VOLUME_15MIN | ped_volume_15min: peak 15-min two-way pedestrian volume (p/15 min) | field | optional | |
MAP_PED_VOLUME_HOUR | ped_volume_hour: hourly two-way pedestrian volume (with phf) (p/h) | field | optional, advanced | |
MAP_PHF | phf: peak-hour factor for ped_volume_hour (-) | field | optional, advanced | |
MAP_WALK_SPEED | walk_speed: pedestrian walking speed (m/s / ft/s) | field | optional, advanced | |
MAP_FACILITY | facility: bicycle facility type (-) | field | optional, advanced | |
MAP_BIKE_BUFFER | bike_buffer: buffer beside the bicycle lane (m / ft) | field | optional, advanced | |
UNITS | Units of the mapped fields | enum: SI (m, km/h, m/s) / US (ft, mph, ft/s) | SI (m, km/h, m/s) | |
PLATOON | Platoon-adjusted walkway LOS | boolean | False | |
VOLUME_FROM_AADT | Volume from \(\mathrm{AADT} \times K \times D\) when volume_vph is not mapped | boolean | True | |
K_DEFAULT | \(K\) when the layer has no k_fac | number | 0.1 | advanced |
D_DEFAULT | \(D\) when the layer has no d_fac | number | 0.55 | advanced |
OUTPUT | Pedestrian and bicycle LOS | sink |
| Name | Description | Type |
|---|---|---|
OUTPUT | Pedestrian and bicycle LOS | outputVector |
PED_RATED | Segments with a pedestrian letter | outputNumber |
BIKE_RATED | Segments with a bicycle letter | outputNumber |
Walkway LOS (FHWA-RD-98-107, Rouphail et al. 1998; Pushkarev & Zupan 1975): unit flow \(v_p = v_{15} / (15\, W_E)\) in \(\mathrm{p/min/m}\) (\(\mathrm{p/min/ft}\) in US units) and space \(A_p = 60\, S_p / v_p\); the letter is the worse of the space and flow letters, from the average-flow or the platoon-adjusted table. The effective width \(W_E\) is the sidewalk width minus shy distances to the building edge, the kerb and obstructions (street-furniture widths flagged unverified, as in streetlos). The 15-minute volume \(v_{15}\) comes from ped_volume_15min or from \(V_h / (4 \cdot \mathrm{PHF})\) with \(V_h\) = ped_volume_hour.
Output fields: effective_width, unit_flow, ped_space, walkway_los_space, walkway_los_flow, walkway_los, los_units, los_notes.
| Name | Description | Type | Default | |
|---|---|---|---|---|
SEGMENTS | Sidewalk segments | source | ||
MAP_BUFFER | buffer: buffer between sidewalk and road \(W_{buf}\) (m / ft) | field | optional, advanced | |
MAP_BARRIER | barrier: continuous barrier \(\ge 0.9\,\mathrm{m}\) (\(3\,\mathrm{ft}\)) in the buffer (yes/no) (-) | field | optional, advanced | |
MAP_SIDEWALK_WIDTH | sidewalk_width: sidewalk width excluding the buffer (m / ft) | field | optional | |
MAP_BUILDING_EDGE | building_edge: none / building / window_display / fence / low_wall (-) | field | optional, advanced | |
MAP_OBSTRUCTIONS | obstructions: ';'-separated obstruction names or widths in the walking path (m / ft) | field | optional | |
MAP_PED_VOLUME_15MIN | ped_volume_15min: peak 15-min two-way pedestrian volume (p/15 min) | field | optional | |
MAP_PED_VOLUME_HOUR | ped_volume_hour: hourly two-way pedestrian volume (with phf) (p/h) | field | optional, advanced | |
MAP_PHF | phf: peak-hour factor for ped_volume_hour (-) | field | optional, advanced | |
MAP_WALK_SPEED | walk_speed: pedestrian walking speed (m/s / ft/s) | field | optional, advanced | |
UNITS | Units of the mapped fields | enum: SI (m, km/h, m/s) / US (ft, mph, ft/s) | SI (m, km/h, m/s) | |
PLATOON | Platoon-adjusted walkway LOS | boolean | False | |
OUTPUT | Walkway LOS | sink |
| Name | Description | Type |
|---|---|---|
OUTPUT | Walkway LOS | outputVector |
RATED | Segments with a walkway letter | outputNumber |
Occupancy at a beat \(o = V/S\), vehicles over legal spaces available at that beat (spaces in an unavailable window count as zero; vehicles above the legal spaces are kept and flagged over_cap). Effective capacity \(C_{\mathrm{eff}} = \tau\, S\) with target \(\tau = 0.85\) (85 % rule; Shoup 2005); practical capacity \(C_{\mathrm{prac}} = \phi\, S\) with facility factor \(\phi = 0.85\) on-street or \(0.90\) off-street (planning conventions). A face is above target when its peak occupancy exceeds the effective capacity.
Block faces are lines or polygons with an id and the number of legal spaces (and optionally a zone, space type, facility on_street / off_street, posted time limit in minutes, unavailable windows "07:00-09:00;16:00-18:00" and the hourly rate). The count table holds one row per face and beat: face id, beat time (date-time, or clock time plus a date column) and vehicles counted.
Outputs: block faces (face_id, zone, spaces, peak_occ, peak_rate, peak_beat, eff_cap, prac_cap, above_tgt, surplus, mean_occ), one feature per face and beat (beat as date-time, occupied, capacity, rate, eff_cap, over_cap; loaded with temporal properties so the Temporal Controller animates it) and a zone table.
Geographic or non-metric input is reprojected to the UTM zone of the layer centre; the outputs are written in that working CRS and the log says so.
| Name | Description | Type | Default | |
|---|---|---|---|---|
FACES | Block faces | source | ||
FACE_ID | Face id field | field | face_id | |
SPACES | Legal spaces field | field | spaces | |
ZONE | Zone field | field | optional | |
SPACE_TYPE | Space type field | field | optional, advanced | |
FACILITY | Facility field (on_street / off_street) | field | optional, advanced | |
UNAVAILABLE | Unavailable windows field | field | optional, advanced | |
COUNTS | Occupancy counts (CSV or table) | source | ||
COUNT_FACE | Face id column | field | face_id | |
COUNT_TIME | Beat column | field | beat | |
COUNT_DATE | Date column (for clock times) | field | optional, advanced | |
COUNT_VALUE | Vehicles column | field | vehicles | |
TARGET | Target occupancy (85 percent rule) | number | 0.85 | |
ON_STREET_FACTOR | Practical capacity factor, on-street | number | 0.85 | advanced |
OFF_STREET_FACTOR | Practical capacity factor, off-street | number | 0.9 | advanced |
BEAT_MINUTES | Beat length (min; empty: inferred) | number | optional, advanced | |
OUTPUT | Occupancy per block face | sink | ||
BEATS | Occupancy by beat | sink | optional | |
ZONES | Occupancy per zone | sink | optional |
| Name | Description | Type |
|---|---|---|
OUTPUT | Occupancy per block face | outputVector |
BEATS | Occupancy by beat | outputVector |
ZONES | Occupancy per zone | outputVector |
FACES_ABOVE | Faces above the target | outputNumber |
PEAK_BEAT | Study-wide peak beat | outputString |
From a licence-plate beat survey: consecutive sightings of one token on one face are one stay (gaps up to the tolerance bridged); minimum duration \(t_n - t_1\), estimated \(t_n - t_1 + b\) with beat length \(b\); stays at a session edge are censored. Turnover \(T = N_s / S\), stays over spaces (and per hour, \(T/H\)); utilisation \(U = \sum_s \hat{t}_s / (S\, H)\), estimated space-hours over spaces \(\times\) survey hours \(H\); overstay against the posted limit on the conservative minimum basis by default.
Privacy: the sightings table should carry hashed tokens (see Hash licence plates). If it carries a raw plate column instead, give a salt: plates are normalised (NFKC, upper case, letters and digits) and replaced by HMAC-SHA256 (RFC 2104) in memory, never stored. Processing history records parameter values, so prefer the salt file parameter (only its path is recorded) for real surveys. Plates are personal data under GDPR and KVKK.
Block faces are lines or polygons with an id and the number of legal spaces (and optionally a zone, space type, facility on_street / off_street, posted time limit in minutes, unavailable windows "07:00-09:00;16:00-18:00" and the hourly rate). The count table holds one row per face and beat: face id, beat time (date-time, or clock time plus a date column) and vehicles counted.
Outputs: block faces with turnover, turnover_h, mean_dur, med_dur (min), overstay (count; NULL without a limit), overstay_sh, utilization; optionally the hashed stays as CSV.
| Name | Description | Type | Default | |
|---|---|---|---|---|
FACES | Block faces | source | ||
FACE_ID | Face id field | field | face_id | |
SPACES | Legal spaces field | field | spaces | |
ZONE | Zone field | field | optional | |
SPACE_TYPE | Space type field | field | optional, advanced | |
FACILITY | Facility field (on_street / off_street) | field | optional, advanced | |
UNAVAILABLE | Unavailable windows field | field | optional, advanced | |
TIME_LIMIT | Posted time limit field (min) | field | optional | |
COUNTS | Occupancy counts (CSV or table) | source | ||
COUNT_FACE | Face id column | field | face_id | |
COUNT_TIME | Beat column | field | beat | |
COUNT_DATE | Date column (for clock times) | field | optional, advanced | |
COUNT_VALUE | Vehicles column | field | vehicles | |
TARGET | Target occupancy (85 percent rule) | number | 0.85 | |
ON_STREET_FACTOR | Practical capacity factor, on-street | number | 0.85 | advanced |
OFF_STREET_FACTOR | Practical capacity factor, off-street | number | 0.9 | advanced |
BEAT_MINUTES | Beat length (min; empty: inferred) | number | optional, advanced | |
SIGHTINGS | Plate sightings (CSV or table) | source | ||
SIGHT_FACE | Face id column | field | face_id | |
SIGHT_TIME | Beat column | field | beat | |
SIGHT_DATE | Date column (for clock times) | field | optional, advanced | |
SIGHT_TOKEN | Token column (hashed plates) | string | token | optional |
RAW_PLATE | Raw plate column (hashed in memory; needs a salt) | string | plate | optional, advanced |
SALT | Salt for raw plates (at least 16 bytes) | string | optional, advanced | |
SALT_FILE | Salt file (first line; for raw plates) | file | optional | |
MAX_GAP | Missed beats bridged inside one stay | number | 0 | advanced |
OVERSTAY_BASIS | Overstay basis | enum: Minimum duration / Estimated duration | Minimum duration | advanced |
OUTPUT | Turnover per block face | sink | ||
STAYS_CSV | Stays (hashed, CSV) | fileDestination | optional |
| Name | Description | Type |
|---|---|---|
OUTPUT | Turnover per block face | outputVector |
STAYS_CSV | Stays (hashed, CSV) | outputFile |
STAYS | Stays | outputNumber |
Rate recommendations from the mean occupancy in the rate period, at the block-face, zone or study level. SFMTA policy (5 Dec 2017): mean occupancy \(\bar{o} \ge 0.80\): \(+0.25\); \(0.60 \le \bar{o} < 0.80\): hold; \(\bar{o} < 0.60\): \(-0.25\); rates kept in \([0.50,\ 8.00]\). SFpark pilot: the pilot's occupancy bands. Both are configurable examples, not rules for another city.
Block faces are lines or polygons with an id and the number of legal spaces (and optionally a zone, space type, facility on_street / off_street, posted time limit in minutes, unavailable windows "07:00-09:00;16:00-18:00" and the hourly rate). The count table holds one row per face and beat: face id, beat time (date-time, or clock time plus a date column) and vehicles counted.
Output: block faces with mean_occ, rate, price_occ (mean occupancy used), rec_rate and rate_change.
| Name | Description | Type | Default | |
|---|---|---|---|---|
FACES | Block faces | source | ||
FACE_ID | Face id field | field | face_id | |
SPACES | Legal spaces field | field | spaces | |
ZONE | Zone field | field | optional | |
SPACE_TYPE | Space type field | field | optional, advanced | |
FACILITY | Facility field (on_street / off_street) | field | optional, advanced | |
UNAVAILABLE | Unavailable windows field | field | optional, advanced | |
RATE | Hourly rate field | field | rate | |
COUNTS | Occupancy counts (CSV or table) | source | ||
COUNT_FACE | Face id column | field | face_id | |
COUNT_TIME | Beat column | field | beat | |
COUNT_DATE | Date column (for clock times) | field | optional, advanced | |
COUNT_VALUE | Vehicles column | field | vehicles | |
TARGET | Target occupancy (85 percent rule) | number | 0.85 | |
ON_STREET_FACTOR | Practical capacity factor, on-street | number | 0.85 | advanced |
OFF_STREET_FACTOR | Practical capacity factor, off-street | number | 0.9 | advanced |
BEAT_MINUTES | Beat length (min; empty: inferred) | number | optional, advanced | |
POLICY | Pricing policy | enum: SFMTA (2017) / SFpark pilot | SFMTA (2017) | |
RATE_PERIOD | Rate period (HH:MM-HH:MM; empty: all beats) | string | optional | |
LEVEL | Recommendation level | enum: Block face / Zone / Whole study | Block face | |
OUTPUT | Rate recommendations | sink |
| Name | Description | Type |
|---|---|---|
OUTPUT | Rate recommendations | outputVector |
RAISED | Faces with a rate increase | outputNumber |
LOWERED | Faces with a rate decrease | outputNumber |
For each destination, the block faces whose midpoint lies within the walking radius (straight line, or along the street network when streets are given) and their spare capacity at one beat: \(\text{spare} = \sum_f \max(0,\ C_{\mathrm{eff},f} - V_f)\) over the faces \(f\) in reach (eff_cap and occupied at that beat). The beat defaults to the study-wide peak (the beat with the most vehicles).
Input: the occupancy by beat output of the occupancy tool. Output fields: dest_fid, faces_in_reach, spaces, occupied_at_beat, eff_cap, spare, beat, reach.
| Name | Description | Type | Default | |
|---|---|---|---|---|
DESTINATIONS | Destinations (points) | source | ||
BEATS | Occupancy by beat (from the occupancy tool) | source | ||
RADIUS | Walking radius (m) | number | 300.0 | |
STREETS | Streets (network distance; empty: straight line) | source | optional | |
BEAT | Beat (YYYY-MM-DDTHH:MM; empty: study-wide peak) | string | optional | |
OUTPUT | Spare capacity near destinations | sink |
| Name | Description | Type |
|---|---|---|
OUTPUT | Spare capacity near destinations | outputVector |
SPARE_TOTAL | Sum of spare spaces | outputNumber |
Copies a CSV of plate sightings with the plate column replaced by a token: the plate is normalised (NFKC, upper case, letters and digits only) and hashed with HMAC-SHA256 (RFC 2104) under a secret salt of at least 16 bytes, truncated to 16 hex characters. The same plate and salt always give the same token, so stays can be built; another salt gives unlinkable tokens. The file is streamed row by row; the raw plates never enter a QGIS layer.
Keep the salt secret and outside the project. Processing history records parameter values: prefer the salt file (only its path is recorded). Plates are personal data under GDPR and KVKK.
| Name | Description | Type | Default | |
|---|---|---|---|---|
INPUT | Raw sightings CSV | file | ||
PLATE_COLUMN | Plate column | string | plate | |
TOKEN_COLUMN | Token column written | string | token | |
SALT | Salt (at least 16 bytes) | string | optional | |
SALT_FILE | Salt file (first line) | file | optional | |
OUTPUT | Hashed sightings CSV | fileDestination |
| Name | Description | Type |
|---|---|---|
OUTPUT | Hashed sightings CSV | outputFile |
ROWS | Rows written | outputNumber |
A deterministic synthetic district (EPSG:32635) with planted values for every module: 8 stations with residents, jobs, land use, streets, transit stops and a GTFS feed for Wed 12 Mar 2025 (07:00-09:00); 6 continuous and 4 short count stations with a full 2025 hourly table and 60 road segments; 12 block faces in 3 zones with hourly beats 08:00-17:00 and hashed plate sightings. The same tables feed the dock's demo and the test suites.
| Name | Description | Type | Default | |
|---|---|---|---|---|
STATIONS | Demo stations | sink | ||
POPULATION | Demo residents | sink | ||
JOBS | Demo jobs | sink | ||
LANDUSE | Demo land use | sink | ||
STREETS | Demo streets | sink | ||
STOPS | Demo transit stops | sink | ||
DESTINATIONS | Demo destinations | sink | ||
COUNT_STATIONS | Demo count stations | sink | ||
COUNTS | Demo hourly counts | sink | ||
SEGMENTS | Demo road segments | sink | ||
FACES | Demo block faces | sink | ||
PARKING_COUNTS | Demo parking counts | sink | ||
SIGHTINGS | Demo plate sightings (hashed) | sink | ||
PARKING_DESTINATIONS | Demo parking destinations | sink | ||
GTFS | Demo GTFS feed | fileDestination |
| Name | Description | Type |
|---|---|---|
STATIONS | Demo stations | outputVector |
POPULATION | Demo residents | outputVector |
JOBS | Demo jobs | outputVector |
LANDUSE | Demo land use | outputVector |
STREETS | Demo streets | outputVector |
STOPS | Demo transit stops | outputVector |
DESTINATIONS | Demo destinations | outputVector |
COUNT_STATIONS | Demo count stations | outputVector |
COUNTS | Demo hourly counts | outputVector |
SEGMENTS | Demo road segments | outputVector |
FACES | Demo block faces | outputVector |
PARKING_COUNTS | Demo parking counts | outputVector |
SIGHTINGS | Demo plate sightings (hashed) | outputVector |
PARKING_DESTINATIONS | Demo parking destinations | outputVector |
GTFS | Demo GTFS feed | outputFile |
SERVICE_DATE | GTFS service date | outputString |
Runs every module whose inputs are given, in the dock's order, and writes the HTML report: TOD (stations; buffers and pedsheds, 5D indicators, GTFS node indicators, node-place model and composite index with equal weights), AADT (count stations, hourly table and road segments), motorised LOS and pedestrian and bicycle LOS on the AADT segments, and the parking survey (faces, counts, optional hashed sightings, pricing when a rate field is given). Indicator names for the node-place model and the composite index are the output field names of the indicator step, e.g. departures, routes and activity_density_400, landuse_entropy_800.
Each module's formulas are in the help of its own tool and in the report.
Geographic or non-metric input is reprojected to the UTM zone of the layer centre; the outputs are written in that working CRS and the log says so.
| Name | Description | Type | Default | |
|---|---|---|---|---|
STATIONS | TOD: stations | source | optional | |
STATION_ID | TOD: station id field | field | station_id | optional |
RADII | TOD: buffer radii (m) | string | 400, 800 | optional |
NETWORK_RADII | TOD: network pedshed budgets (m; needs streets) | string | optional | |
STREETS | TOD: streets | source | optional | |
PEDESTRIAN_FIELD | TOD: street type field | field | optional, advanced | |
POPULATION | TOD: residents | source | optional | |
POPULATION_FIELD | TOD: residents field | field | optional | |
JOBS | TOD: jobs | source | optional | |
JOBS_FIELD | TOD: jobs field | field | optional | |
LANDUSE | TOD: land use | source | optional | |
LANDUSE_FIELD | TOD: land-use category field | field | optional | |
DESTINATIONS | TOD: destinations | source | optional | |
DESTINATION_WEIGHT_FIELD | TOD: destination weight field | field | optional | |
GRAVITY_BETA | TOD: Hansen gravity \(\beta\) (per m; 0: off) | number | 0.0 | advanced |
TRANSIT_STOPS | TOD: transit stops | source | optional | |
GTFS | TOD: GTFS feed (zip) | file | optional | |
GTFS_DATE | TOD: GTFS service date (YYYY-MM-DD) | string | optional | |
GTFS_WINDOW | TOD: GTFS window | string | 07:00-09:00 | optional |
NODE_FIELDS | TOD: node indicators (comma-separated) | string | optional | |
PLACE_FIELDS | TOD: place indicators | string | optional | |
COMPOSITE_FIELDS | TOD: composite indicators | string | optional | |
COST_FIELDS | TOD: cost indicators among them | string | optional | |
COUNT_STATIONS | AADT: count stations | source | optional | |
COUNT_STATION_ID | AADT: station id field | field | station | optional |
KIND_FIELD | AADT: kind field | field | optional | |
GROUP_FIELD | AADT: factor group field | field | optional | |
COUNTS | AADT: hourly count table | source | optional | |
COUNT_STATION | AADT: station column | field | station | optional |
COUNT_DATETIME | AADT: date-time column | field | datetime | optional |
COUNT_VOLUME | AADT: volume column | field | volume | optional |
COUNT_DIRECTION | AADT: direction column | field | optional | |
COUNT_CLASS | AADT: vehicle class column | field | optional, advanced | |
COUNT_DATE | AADT: date column (for clock times) | field | optional, advanced | |
HOUR_ENDING | AADT: stamps mark the end of the hour | boolean | False | advanced |
SEGMENTS | AADT: road segments | source | optional | |
MODEL_FIELDS | AADT: model covariates | field | optional | |
FACILITY_FIELD | LOS: facility field | field | optional | |
LANES_FIELD | LOS: lanes per direction field | field | lanes | optional |
FFS_FIELD | LOS: free-flow speed field (km/h) | field | optional | |
SPEED_LIMIT_FIELD | LOS: speed limit field (km/h) | field | optional | |
SPEED_FIELD | LOS: observed travel speed field (km/h) | field | optional | |
PEDBIKE_MAP | LOS: pedestrian and bicycle mapping (column=field; ...) | string | optional | |
FACES | Parking: block faces | source | optional | |
FACE_ID | Parking: face id field | field | face_id | optional |
SPACES | Parking: spaces field | field | spaces | optional |
ZONE | Parking: zone field | field | optional | |
TIME_LIMIT | Parking: time limit field (min) | field | optional | |
RATE | Parking: hourly rate field | field | optional | |
PARKING_COUNTS | Parking: occupancy counts | source | optional | |
SIGHTINGS | Parking: hashed plate sightings | source | optional | |
RATE_PERIOD | Parking: rate period (HH:MM-HH:MM) | string | optional | |
TOD_STATIONS | TOD stations | sink | optional | |
TOD_CATCHMENTS | TOD catchments | sink | optional | |
AADT_SEGMENTS | Segments with AADT and LOS | sink | optional | |
AADT_STATIONS | Count stations with AADT | sink | optional | |
PARKING_FACES | Parking block faces | sink | optional | |
PARKING_BEATS | Parking occupancy by beat | sink | optional | |
REPORT | HTML report | fileDestination | optional |
| Name | Description | Type |
|---|---|---|
TOD_STATIONS | TOD stations | outputVector |
TOD_CATCHMENTS | TOD catchments | outputVector |
AADT_SEGMENTS | Segments with AADT and LOS | outputVector |
AADT_STATIONS | Count stations with AADT | outputVector |
PARKING_FACES | Parking block faces | outputVector |
PARKING_BEATS | Parking occupancy by beat | outputVector |
REPORT | HTML report | outputHtml |
MODULES | Modules run | outputString |
The numbers below come from running every module on the demo district with the settings of the test suites (TOD: buffers of 400 and 800 m and an 800 m pedshed, node = departures and routes, place = activity density 400 and land-use entropy 800, composite of activity density 400, departures and mean distance 400 as a cost; AADT: kind and group fields, model covariates fclass and lanes; parking: rate period 09:00-12:00). The demo generator plants the values the analysis must recover.
Activity density 400 \(= (P + J) / A_C\) with \(A_C = \pi\,(400\,\mathrm{m})^2 = 50.27\,\mathrm{ha}\). The node-place columns here use two node and two place indicators, so their classes differ from the planted ones, which are defined on departures and activity density 400 alone; the test suites check the planted classes with that choice.
| Station | Residents 400 | Jobs 400 | Activity density 400 (/ha) | Departures 07-09 | Node | Place | Class | Planted class (departures / density) | TOD score | Rank |
|---|---|---|---|---|---|---|---|---|---|---|
| S1 | 2,760 | 1,840 | 91.51 | 120 | 1.000 | 0.700 | unsustained node | stress | 0.633 | 2 |
| S2 | 3,000 | 2,000 | 99.47 | 105 | 0.758 | 0.750 | stress | stress | 0.950 | 1 |
| S3 | 1,800 | 1,200 | 59.68 | 70 | 0.583 | 0.500 | balanced | balanced | 0.500 | 3 |
| S4 | 1,680 | 1,120 | 55.70 | 80 | 0.467 | 0.475 | balanced | balanced | 0.350 | 6 |
| S5 | 600 | 400 | 19.89 | 30 | 0.050 | 0.250 | dependency | dependency | 0.200 | 8 |
| S6 | 1,080 | 720 | 35.81 | 90 | 0.517 | 0.350 | balanced | unsustained node | 0.467 | 4 |
| S7 | 2,400 | 1,600 | 79.58 | 35 | 0.075 | 0.625 | unsustained place | unsustained place | 0.467 | 4 |
| S8 | 1,560 | 1,040 | 51.73 | 20 | 0.000 | 0.450 | unsustained place | unsustained place | 0.300 | 7 |
Continuous station C1: AADT 5,504.6 (planted 5,504.6), \(K = 0.0986\), \(D = 0.55\), method hourly_weighted. Short count K1 expanded with its group: AADT 3,564.6 (planted 3,564.6), 95 % interval 3,564.6-3,564.6 (zero width here: every urban counter of the demo carries the same seasonal pattern, so the group factors have no spread; real groups give a real interval). Segments: 10 counted, 49 modelled; model \(n = 10\), adjusted \(R^2 = 0.909\), LOOCV \(\mathrm{MAPE} = 12.6\,\%\), smearing factor \(S = 1.0032\). One segment of the unseen class service stays NULL, and count station U1 (40 m from any road, tolerance 25 m) is reported unmatched.
Motorised LOS letters on the 60 segments: A 4, B 7, C 13, D 11, E 16, F 8, none 1. A hand check: \(\mathrm{AADT} = 20\,000\), \(K = 0.10\), \(D = 0.55\), \(\mathrm{PHF} = 0.92\), \(N = 2\) lanes, \(P_T = 0.05\), \(\mathrm{FFS} = 100\,\mathrm{km/h}\) freeway gives \(f_{HV} = 1/1.05\), \[ v_p = \frac{20\,000 \times 0.10 \times 0.55}{0.92 \times 2 \times (1/1.05)} = 627.72\,\mathrm{pc/h/ln}, \] density \(\rho = v_p/\mathrm{FFS} = 10.10\,\mathrm{pc/mi/ln}\) (\(6.28\,\mathrm{pc/km/ln}\)), LOS A.
| Face | Zone | Spaces | Peak occupied | Peak rate | Above 85 % | Turnover | Mean duration (min) | Overstays | Recommended rate |
|---|---|---|---|---|---|---|---|---|---|
| F01 | Z1 | 10 | 11 | 1.100 | 1 | 0.400 | 195.0 | 2 | 2.25 |
| F02 | Z1 | 13 | 7 | 0.538 | 0 | 0.308 | 135.0 | 0 | 1.75 |
| F03 | Z1 | 16 | 8 | 0.500 | 0 | 0.250 | 195.0 | 2 | 1.75 |
| F04 | Z1 | 19 | 21 | 1.105 | 1 | 0.211 | 180.0 | 2 | 2.25 |
| F05 | Z2 | 11 | 6 | 0.545 | 0 | 0.273 | 180.0 | NULL | 1.75 |
| F06 | Z2 | 14 | 8 | 0.571 | 0 | 0.214 | 180.0 | NULL | 1.75 |
| F07 | Z2 | 17 | 18 | 1.059 | 1 | 0.176 | 120.0 | NULL | 2.25 |
| F08 | Z2 | 20 | 10 | 0.500 | 0 | 0.150 | 240.0 | NULL | 1.75 |
| F09 | Z3 | 12 | 6 | 0.500 | 0 | 0.250 | 160.0 | NULL | 0.75 |
| F10 | Z3 | 15 | 16 | 1.067 | 1 | 0.200 | 180.0 | NULL | 1.25 |
| F11 | Z3 | 18 | 10 | 0.556 | 0 | 0.167 | 200.0 | NULL | 0.75 |
| F12 | Z3 | 10 | 6 | 0.600 | 0 | 0.300 | 120.0 | NULL | 0.75 |
Study-wide peak beat: 2025-03-12T12:00.
Licence plates are personal data under the GDPR and the Turkish KVKK (Law No. 6698). Plates are normalised (NFKC, upper case, letters and digits only) and replaced by HMAC-SHA256 (RFC 2104) with a secret salt of at least 16 bytes, truncated to 16 hex characters. In the dock the salt lives only in memory; it is never written to the project, the settings, the log or the report, and a raw plate column is never loaded into a QGIS layer. Processing history records parameter values, so in Processing prefer the salt file parameter (only its path is recorded).
Eminoğlu, Y. (2026). 02TODLab - TOD and Traffic Lab (version 0.1.2) [QGIS plugin]. https://gitlab.com/geophilo1/zero2todlab. https://doi.org/10.5281/zenodo.24263644. The DOI 10.5281/zenodo.24263644 always resolves to the latest version; version 0.1.2 has DOI https://doi.org/10.5281/zenodo.24263645. Please also cite the method papers above.
GPL-2.0-or-later. Copyright (C) 2026 Yusuf Eminoğlu (Geophilo). The vendored todindex, aadtkit, streetlos, parkingstudy and transitfreq packages are MIT-licensed. Repository: https://gitlab.com/geophilo1/zero2todlab; issues: https://gitlab.com/geophilo1/zero2todlab/-/work_items; homepage: https://geophilo.com/zero2todlab/.