Skip to content

Bus Data

ccai-cmap edited this page Dec 1, 2025 · 72 revisions

A diagram of the MHN is shown below, with data unrelated to buses grayed out.

A diagram showing the bus data relationships.

Nodes and Links

As a refresher, the primary key🔑 for nodes is NODE, while the primary key🔑 for links is ABB. See Highway Data for more information.

Bus Runs (Polyline Feature Classes)

There are 3 bus run feature classes- base, present, and future. The bus runs are defined by their CMAP unique bus run ID (Lowercase mode + 5-digit number, starting at 00000 for base, 50000 for current, and 99000 for future).

The fields in the following table are present for all 3 bus run feature classes.

# NAME TYPE LENGTH DOMAIN NOTE
1 TRANSIT_LINE🔑 TEXT 6 CMAP unique bus run ID
2 DESCRIPTION TEXT 50 Description of bus route
3 MODE TEXT 1 BUSMODE Bus mode code
4 VEHICLE_TYPE TEXT 2 CTVEH Bus vehicle type code
5 HEADWAY SHORT POSITIVE Headway (minutes) - see note below table
6 SPEED SHORT POSITIVE Average speed (mph)

Note: for base/current runs, HEADWAY describes the length of the TOD period that the run falls into. For example, if it's TOD 1 (8 PM - 6 AM), then the headway is 10 hours, or 600 minutes. The actual headway (duration of time between buses) is calculated later. However, for future runs, HEADWAY describes the actual headway during AM/PM peak time periods.

These fields are specific to bus base/current and are derived from GTFS input:

# NAME TYPE LENGTH DOMAIN NOTE
7 ROUTE_ID TEXT 5 Actual CTA/Pace route number
8 LONGNAME TEXT 50 CTA/Pace route name
9 DIRECTION TEXT 5 Direction of travel
10 TERMINAL TEXT 50 Name of bus destination
11 START LONG Start time (seconds after midnight)
12 STARTHOUR SHORT HOUR Hour of the day in which the run begins (0-23)
13 AM_SHARE DOUBLE Proportion of run falling within the AM peak period (7 AM - 9 AM)
14 FEEDLINE TEXT 20 Unique ID based on raw GTFS data

Clone this wiki locally