-
Notifications
You must be signed in to change notification settings - Fork 0
Bus Data
A diagram of the bus data schema is shown below. Arrows show relationships between data.

As a refresher, the primary key🔑 for nodes is NODE, while the primary key🔑 for links is ABB. See Highway Data for more information.
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 | 255 | Description of bus route, for base/current formatted ROUTE_ID LONGNAME: DIRECTION TO TERMINAL | |
| 3 | MODE | TEXT | 1 | BUSMODE | Bus mode code |
| 4 | VEHICLE_TYPE | TEXT | 2 | CTVEH | Bus vehicle type code |
| 5 | HEADWAY | SHORT | POSITIVE | Headway (minutes) | |
| 6 | SPEED | SHORT | POSITIVE | Average speed (mph) |
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 | CARDINAL | Cardinal direction of travel (NORTH/SOUTH/EAST/WEST) |
| 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 | ||
| 14 | FEEDLINE | TEXT | 20 | Unique ID based on raw GTFS data |
These fields are specific to bus future:
| # | NAME | TYPE | LENGTH | DEFAULT | NOTE |
|---|---|---|---|---|---|
| 7 | SCENARIO | TEXT | 10 | Scenarios bus line will be used in (ex. 234) | |
| 8 | REPLACE | TEXT | 50 | MODE-ROUTE_ID (s) which will be replaced by the future project, separated by colons. Only affects specified TOD | |
| 9 | REROUTE | TEXT | 50 | MODE-ROUTE_ID (s) which will be rerouted by the future project, separated by colons. Only affects specified TOD | |
| 10 | TOD | TEXT | 10 | 0 | Text string of affected time periods |
| 11 | NOTES | TEXT | 50 | Optional additional information (such as TIPID) |
There are 3 bus itinerary feature classes- base, present, and future.
The fields in the following table are present for all 3 bus run feature classes.
| # | NAME | TYPE | LENGTH | DOMAIN | DEFAULT | NOTE |
|---|---|---|---|---|---|---|
| 1 | TRANSIT_LINE🔑🔗 | TEXT | 6 | CMAP unique bus run ID | ||
| 2 | ITIN_ORDER🔑 | SHORT | POSITIVE | 0 | Order number of bus segment in itinerary, beginning with 1 | |
| 3 | ITIN_A🔗 | LONG | NODE | 0 | CMAP node number bus travels from | |
| 4 | ITIN_B🔗 | LONG | NODE | 0 | CMAP node number bus travels to | |
| 5 | ABB🔗 | TEXT | 13 | Unique link ID that bus travels on | ||
| 6 | LAYOVER | SHORT | POSITIVE | 0 | Layover time (minutes) applied to ITIN_B | |
| 7 | DWELL_CODE | TEXT | 1 | DWELLCODE | 0 | Code for stops (corresponding Emme code), applied to ITIN_B |
| 8 | ZONE_FARE | SHORT | POSITIVE | 0 | Incremental zone fare in cents | |
| 9 | LINE_SERV_TIME | FLOAT | 0 | Itinerary segment travel time (minutes) | ||
| 10 | TTF | TEXT | 1 | TTF | 1 | Emme transit time function code |
| 15 | F_MEAS | DOUBLE | 0 | Percentage of route already passed at ITIN_A (0-100) | ||
| 16 | T_MEAS | DOUBLE | 0 | Percentage of route already passed at ITIN_B (0-100) |
These fields are specific to bus base/current and are derived from GTFS input:
| # | NAME | TYPE | LENGTH | DOMAIN | DEFAULT | NOTE |
|---|---|---|---|---|---|---|
| 11 | LINK_STOPS | SHORT | POSITIVE | 0 | Number of GTFS stops along link | |
| 12 | IMPUTED | TEXT | 1 | IMPUTED | 0 | Flag indicating segment was imputed by shortest path algorithm |
| 13 | DEP_TIME | LONG | 0 | Time departing from ITIN_A (seconds since midnight) | ||
| 14 | ARR_TIME | LONG | 0 | Time arriving to ITIN_B (seconds since midnight) |
This table stores information about park-n-ride locations serving Pace and CTA bus riders.
| # | NAME | TYPE | LENGTH | DOMAIN | NOTE |
|---|---|---|---|---|---|
| 1 | FACILITY | TEXT | 255 | Name of park-n-ride facility | |
| 2 | NODE🔗 | LONG | NODE | CMAP node number | |
| 3 | COST | SHORT | POSITIVE | Daily cost of parking at facility (in cents) | |
| 4 | SPACES | SHORT | POSITIVE | Number of parking spaces at facility | |
| 5 | ESTIMATE | SHORT | BINARY | If data is verified (0) or just an estimate (1) | |
| 6 | SCENARIO | TEXT | 20 | Scenarios park-n-ride lot will be used in. Cannot be blank |