From 843e958494ce84370884575bbb5b7805ff4da890 Mon Sep 17 00:00:00 2001 From: Jeff Kessler <31969870+jeffkessler-keolis@users.noreply.github.com> Date: Mon, 19 Aug 2024 18:13:52 -0400 Subject: [PATCH 1/8] Add calendar supplements and trip_service_id --- docs/spec/index.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/spec/index.md b/docs/spec/index.md index b9fef7f..98624d8 100644 --- a/docs/spec/index.md +++ b/docs/spec/index.md @@ -20,6 +20,8 @@ There are two types of files used in the TODS standard: | stops_supplement.txt | Supplement | Supplements and modifies GTFS [stops.txt](https://github.com/google/transit/blob/master/gtfs/spec/en/reference.md#stopstxt) with internal stop locations, waypoints, and other non-public stop information.| | stop_times_supplement.txt | Supplement | Supplements and modifies GTFS [stop_times.txt](https://github.com/google/transit/blob/master/gtfs/spec/en/reference.md#stop_timestxt) with non-public times at which trips stop at locations, `stop_times` entries for non-public trips, and related information. | | routes_supplement.txt | Supplement | Supplements and modifies GTFS [routes.txt](https://github.com/google/transit/blob/master/gtfs/spec/en/reference.md#routestxt) with internal route identifiers and other non-public route identification. | +| calendar_supplement.txt | Supplement | Supplements and modifies GTFS [calendar.txt](https://github.com/google/transit/blob/master/gtfs/spec/en/reference.md#calendartxt) to adjust days for which existing `service_id`s are in effect, and add additional `service_id`s where crew and/or deadhead information is distinct from revenue trips. | +| calendar_dates_supplement.txt | Supplement | Supplements and modifies GTFS [calendar_dates.txt](https://github.com/google/transit/blob/master/gtfs/spec/en/reference.md#calendar_datestxt) to adjust dates for which existing `service_id`s are in effect, and add additional `service_id`s where crew and/or deadhead information is distinct from revenue trips. | | run_events.txt | TODS-Specific | Lists all trips and other scheduled activities to be performed by a member of personnel during a run. | _The use of the Supplement standard to modify other GTFS files is not yet formally adopted into the specification and remains subject to change. Other files may be formally adopted in the future._ @@ -106,7 +108,8 @@ Primary Key: (`service_id`, `run_id`, `event_sequence`) | **Field Name** | **Type** | **Required** | **Description** | | --- | --- | --- | --- | -| `service_id` | ID referencing `calendar.service_id` or `calendar_dates.service_id` | Required | Identifies a set of dates when the run is scheduled to take place. | +| `service_id` | ID referencing `calendar.service_id` or `calendar_dates.service_id` | Required | Identifies a set of dates when the run is scheduled to take place. Can be distinct from `trip_service_id`. | +| `trip_service_id` | ID referencing `calendar.service_id` or `calendar_dates.service_id` | Optional | If an operation has distinct vehicle and crew schedules, identifies the vehicle schedule relating to the identified set of runs.

If `trip_service_id` is not set, the `service_id` field will be used to refer to both an operation's vehicle and crew schedules. When an event's `trip_service_id` is active, its `service_id` must also be in effect. | | `run_id` | ID | Required | A run is uniquely determined by a `service_id`, `run_id` pair. Runs with the same `run_id` on different `service_id`s are considered different runs. | | `event_sequence` | Non-negative integer | Required | The order of this event within a run. Must be unique within one (`service_id`, `run_id`). See [more detail below](#event_sequence-and-event-times) about how order is defined. | | `piece_id` | ID | Optional | Identifies the piece within the run that the event takes place.

May be blank if the event takes place out of a piece, like a break, or if the agency does not use piece IDs. | @@ -121,6 +124,10 @@ Primary Key: (`service_id`, `run_id`, `event_sequence`) | `end_time` | Time | Required | Identifies the time when the employee stops working this event.

If `trip_id` is set (and `mid_trip_end` is not `1`), this corresponds to the time of the last stop of the trip in `stop_times.txt` (after applying any trip supplement). If `end_mid_trip` is `1`, this time corresponds to a stop time in the middle of the supplemented trip, when the employee stops working on the trip. Note that this time may not exactly match `stop_times.txt` `arrival_time` or `departure_time` if the employee is considered to be working for a couple minutes after the trip finishes. This field is about when the employee is working, and consumers who care about the the trip times should check `stop_times.txt` instead. | | `end_mid_trip` | Enum | Optional | Indicates whether the event ends at the end of the trip or in the middle of the trip (after applying any trip supplement).

`0` (or blank) - Run event is not associated with a trip, or no information about whether the run event ends mid-trip
`1` - Run event ends mid-trip
`2` - Run event does not end mid-trip | +#### `service_id` and `trip_service_id` + +`service_id` is a required field that identifies when the corresponding run is in effect. In operations where crew schedules are uncoupled from the underlying trips (such that multiple crew schedules can apply to the same underlying sets of trips), `trip_service_id` can be used to link a run event with a trip in its specific `service_id.` Note that, in order for crew schedules and vehicle/trip schedules to be represented in a distinct fashion, the IDs used for `service_id` and `trip_service_id` must be different. Otherwise, the ID used will represent a set of trips, in addition to the runs in effect at that time, which creates an inherent conflict in use. + #### `event_sequence` and Event Times `event_sequence` is required and unique within a run so it can be used in the Primary Key to uniquely identify events. From 3e43450c95e30d94a33bbbf93a2579ac4efa26c0 Mon Sep 17 00:00:00 2001 From: Jeff Kessler <31969870+jeffkessler-keolis@users.noreply.github.com> Date: Mon, 19 Aug 2024 22:03:23 -0400 Subject: [PATCH 2/8] Add split service_id examples Extra staffing for a special event Different runs mapping to the same set of trips Variations of runs by day of the week Jobs of entirely nonrevenue operations --- docs/spec/examples.md | 240 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 240 insertions(+) diff --git a/docs/spec/examples.md b/docs/spec/examples.md index d20a6f2..ddcde5f 100644 --- a/docs/spec/examples.md +++ b/docs/spec/examples.md @@ -168,3 +168,243 @@ weekday,10000,20,BLOCK-A,deadhead ,,garage,08:50:00,stop-1,09:00:00 weekday,10000,30,BLOCK-A,run-as-directed,,stop-1,09:00:00,stop-1,12:00:00 weekday,10000,30,BLOCK-A,deadhead ,,stop-1,12:00:00,garage,12:10:00 ``` + +## Distinct Crew and Trip schedule scenarios + +The below examples identify how to use the distinct `trip_service_id` feature of `run_events.txt` to model instances in which crew schedules may be decoupled from trips, forming a many:many relationship of runs and trips. + + +### Extra staffing for a special event + +Due to a baseball game, an additional ticket collector will be assigned to supplement the existing crew on train 101, serving the ballpark. + +#### `run_events.txt` + +_Note that the `run_id` of 1 maps to the combination of `(service_id, trip_service_id)`, meaning other runs with the same `run_id` of `1` can be in effect at the same time provided they existin other combinations of `(service_id, trip_service_id)`._ + +```csv +service_id,trip_service_id,run_id,event_sequence,event_type,trip_id,start_location,start_time,end_location,end_time +gameday,weekday,1,1,signup,,main_terminal,14:00:00,main_terminal,14:15:00 +gameday,weekday,1,2,collector,train_101,main_terminal,14:45:00,ballpark,15:30:00 +gameday,weekday,1,3,work_as_directed,train_101,ballpark,15:30:00,main_terminal,22:00:00 +gameday,weekday,1,4,signoff,,main_terminal,22:00:00,main_terminal,22:15:00 +``` + +#### `calendar_dates_supplement.txt` + +The added position can be added on the applicable gamedays via `calendar_dates_supplement.txt`. + +```csv +service_id,date,exception_type +gameday,20240820,1 +gameday,20240821,1 +gameday,20240827,1 +gameday,20240903,1 +``` + + +### Different runs mapping to the same set of trips + +Consider a bus network between West City, Eastland, and Northingdon. Route 1 runs between West City and Eastland via Northingdon, whereas Route 2 runs directly between the two cities. + +To improve on-time performance, the driver working the 10:45am Route 1 departure and the driver of the 11am Route 2 departure will exchange these trips effective September 2024. + +#### `trips.txt` + +```csv +route_id,service_id,trip_id,trip_headsign,direction_id +1,weekday,10001,Eastland via Northingdon,1 +2,weekday,20001,Eastland,1 +1,weekday,10002,West City via Northingdon,0 +2,weekday,20002,West City,0 +``` + +#### `calendar.txt` + +Assume these trips run daily on weekdays in the defined date range. + +```csv +service_id,monday,tuesday,wednesday,thursday,friday,saturday,sunday,start_date,end_date +weekday,1,1,1,1,1,0,0,20240101,20241231 +``` + +#### `run_events.txt` + +The current runs can be modeled with service_id `current`, and mapped to the existing `weekday` trips. The future runs can be modeled with service_id `future`, also mapped to the existing `weekday` trips. The service_id `weekday` is already defined in `calendar.txt`, but neither `current` nor `future` are. + +```csv +service_id ,trip_service_id ,run_id ,event_sequence ,block_id ,event_type ,trip_id ,start_location ,start_time ,end_location ,end_time +current ,weekday ,1 ,10 ,A ,report , ,garage ,08:00:00 ,garage ,08:20:00 +current ,weekday ,1 ,20 ,A ,drive ,10001 ,westcity ,09:00:00 ,eastland ,10:30:00 +current ,weekday ,1 ,30 ,A ,drive ,10002 ,eastland ,10:45:00 ,westcity ,12:15:00 +current ,weekday ,1 ,40 ,A ,signoff , ,garage ,12:45:00 ,garage ,13:00:00 + +current ,weekday ,2 ,10 ,B ,report , ,garage ,08:00:00 ,garage ,08:20:00 +current ,weekday ,2 ,20 ,B ,drive ,20001 ,westcity ,09:00:00 ,eastland ,10:00:00 +current ,weekday ,2 ,30 ,B ,drive ,20002 ,eastland ,11:00:00 ,westcity ,12:00:00 +current ,weekday ,2 ,40 ,B ,signoff , ,garage ,12:30:00 ,garage ,12:45:00 + +future ,weekday ,1 ,10 ,A ,report , ,garage ,08:00:00 ,garage ,08:20:00 +future ,weekday ,1 ,20 ,A ,drive ,10001 ,westcity ,09:00:00 ,eastland ,10:30:00 +future ,weekday ,1 ,30 ,A ,drive ,20002 ,eastland ,11:00:00 ,westcity ,12:00:00 +future ,weekday ,1 ,40 ,A ,signoff , ,garage ,12:30:00 ,garage ,12:45:00 + +future ,weekday ,2 ,10 ,B ,report , ,garage ,08:00:00 ,garage ,08:20:00 +future ,weekday ,2 ,20 ,B ,drive ,20001 ,westcity ,09:00:00 ,eastland ,10:00:00 +future ,weekday ,2 ,30 ,B ,drive ,10002 ,eastland ,10:45:00 ,westcity ,12:15:00 +future ,weekday ,2 ,40 ,B ,signoff , ,garage ,12:45:00 ,garage ,13:00:00 +``` + +#### `calendar_supplement.txt` + +To detail the presence of the new `service_id`s and assign them to their applicable days of the week, the runs can be added to the calendar via `calendar_supplement.txt`: + +```csv +service_id,monday,tuesday,wednesday,thursday,friday,saturday,sunday,start_date,end_date +current,1,1,1,1,1,0,0,20240101,20240831 +future ,1,1,1,1,1,0,0,20240901,20241231 +``` + +### Variations of runs by day of the week + +Consider a commuter train line that operates three daily round-trips: two morning inbound trains from the suburbs to the city, two evening return trips from the city to the suburbs, plus one reverse-peak trip for day-trippers to the outlying village and back. + +Every day, the same six trips are operated from the public perspective, with the crew of the earlier morning inbound rush-hour trip always working the earlier evening outbound rush-hour trip (trains 102 and 101, respectively), and the other crew working the later of the two (trains 104 and 103, respectively). To more evenly distribute fatigue and rest, the midday round-trip (trains 191 and 192) is split between the early and late crews by day-of-week, and switching halfway through the year. Whichever crew works the midday trip takes their break in the suburban village, whereas the other crew takes their break in the city. + + +#### `trips.txt` + +Rather than listing these trips as varying by day-of-week in a public-facing schedule, these can indeed be maintained as a single service_id in `trips.txt`. + +```csv +route_id,service_id,trip_id,trip_headsign,direction_id,trip_short_name +commuter_line,spring_train_schedule,spring-city_train_102,City ,1,102 +commuter_line,spring_train_schedule,spring-city_train_104,City ,1,104 +commuter_line,spring_train_schedule,spring-city_train_191,Suburbs,0,191 +commuter_line,spring_train_schedule,spring-city_train_192,City ,1,192 +commuter_line,spring_train_schedule,spring-city_train_101,Suburbs,0,101 +commuter_line,spring_train_schedule,spring-city_train_103,Suburbs,0,103 +``` + +#### `calendar.txt` + +Assume these trips run daily on weekdays in the defined date range. + +```csv +service_id,monday,tuesday,wednesday,thursday,friday,saturday,sunday,start_date,end_date +spring_train_schedule,1,1,1,1,1,0,0,20240101,20241231 +``` + +#### `run_events.txt` + +The individual runs can be broken into two run-based service_ids: `spring_train_latelong` represents the days where the late job works the midday trip (and has its break in the village), whereas `spring_train_earlylong` represents the days where the early job works the midday trip. + +Note that in all circumstances, the trips all reference those with `service_id` matching `spring_train_schedule`; there are not any trips defined under `service_id` `spring_train_latelong` nor `spring_train_earlylong`. + +```csv +service_id,trip_service_id,run_id,event_sequence,block_id,event_type,trip_id,start_location,start_time,end_location,end_time + +spring_train_latelong ,spring_train_schedule,early_job,10,BLOCK-A,sign-in , ,yard ,06:00:00,yard ,06:15:00 +spring_train_latelong ,spring_train_schedule,early_job,20,BLOCK-A,conductor,spring-city_train_102,village,06:30:00,city ,07:30:00 +spring_train_latelong ,spring_train_schedule,early_job,30,BLOCK-A,release , ,city ,07:45:00,city ,16:00:00 +spring_train_latelong ,spring_train_schedule,early_job,40,BLOCK-A,conductor,spring-city_train_101,city ,16:30:00,village,17:30:00 +spring_train_latelong ,spring_train_schedule,early_job,50,BLOCK-A,sign-off , ,yard ,17:30:00,yard ,17:45:00 + +spring_train_latelong ,spring_train_schedule,later_job,10,BLOCK-B,sign-in , ,yard ,07:00:00,yard ,07:15:00 +spring_train_latelong ,spring_train_schedule,later_job,20,BLOCK-B,conductor,spring-city_train_104,village,07:30:00,city ,08:30:00 +spring_train_latelong ,spring_train_schedule,later_job,30,BLOCK-B,conductor,spring-city_train_191,city ,09:00:00,village,10:00:00 +spring_train_latelong ,spring_train_schedule,later_job,40,BLOCK-B,break , ,village,10:00:00,village,15:00:00 +spring_train_latelong ,spring_train_schedule,later_job,50,BLOCK-B,conductor,spring-city_train_190,village,15:00:00,city ,16:00:00 +spring_train_latelong ,spring_train_schedule,later_job,60,BLOCK-B,conductor,spring-city_train_103,city ,17:30:00,village,18:30:00 +spring_train_latelong ,spring_train_schedule,later_job,70,BLOCK-B,sign-off , ,yard ,18:30:00,yard ,18:45:00 + +spring_train_earlylong,spring_train_schedule,early_job,10,BLOCK-A,sign-in , ,yard ,06:00:00,yard ,06:15:00 +spring_train_earlylong,spring_train_schedule,early_job,20,BLOCK-A,conductor,spring-city_train_102,village,06:30:00,city ,07:30:00 +spring_train_earlylong,spring_train_schedule,early_job,30,BLOCK-A,conductor,spring-city_train_191,city ,09:00:00,village,10:00:00 +spring_train_earlylong,spring_train_schedule,early_job,40,BLOCK-A,break , ,village,10:00:00,village,15:00:00 +spring_train_earlylong,spring_train_schedule,early_job,50,BLOCK-A,conductor,spring-city_train_190,village,15:00:00,city ,16:00:00 +spring_train_earlylong,spring_train_schedule,early_job,60,BLOCK-A,conductor,spring-city_train_101,city ,16:30:00,village,17:30:00 +spring_train_earlylong,spring_train_schedule,early_job,70,BLOCK-A,sign-off , ,yard ,17:30:00,yard ,17:45:00 + +spring_train_earlylong,spring_train_schedule,later_job,10,BLOCK-B,sign-in , ,yard ,07:00:00,yard ,07:15:00 +spring_train_earlylong,spring_train_schedule,later_job,20,BLOCK-B,conductor,spring-city_train_104,village,07:30:00,city ,08:30:00 +spring_train_earlylong,spring_train_schedule,later_job,30,BLOCK-B,release , ,city ,08:45:00,city ,17:00:00 +spring_train_earlylong,spring_train_schedule,later_job,40,BLOCK-B,conductor,spring-city_train_103,city ,17:30:00,village,18:30:00 +spring_train_earlylong,spring_train_schedule,later_job,50,BLOCK-B,sign-off , ,yard ,18:30:00,yard ,18:45:00 + +``` + +#### `calendar_supplement.txt` + +To detail the presence of the new `service_id`s and assign them to their applicable days of the week, the runs can be added to the calendar via `calendar_supplement.txt`: + +```csv +service_id,monday,tuesday,wednesday,thursday,friday,saturday,sunday,start_date,end_date +spring_train_latelong ,1,0,1,0,1,0,0,20240101,20240630 +spring_train_earlylong,0,1,0,1,0,0,0,20240101,20240630 +spring_train_earlylong,1,0,1,0,1,0,0,20240701,20241231 +spring_train_latelong ,0,1,0,1,0,0,0,20240701,20241231 +``` + +### Jobs of entirely nonrevenue operations + +A special track inspection train is being operated on a particular day, supported by an extra crew position. + +_Note: The deadhead trips themselves could be defined in their own new `service_id` even without definining corresponding run data in `run_events.txt` using the `calendar_supplement.txt` or `calendar_dates_supplement.txt` files._ + + +#### `trips_supplement.txt` + +```csv +route_id,service_id,trip_id,TODS_trip_type,direction_id +line1,inspection_train,inspection_line1_ob,deadhead,0 +line1,inspection_train,inspection_line1_ib,deadhead,1 +line1,inspection_train,inspection_line2_ob,deadhead,0 +line1,inspection_train,inspection_line2_ib,deadhead,1 +line1,inspection_train,inspection_line3_ob,deadhead,0 +line1,inspection_train,inspection_line3_ib,deadhead,1 +``` + +#### `stop_times_supplement.txt` + +```csv +trip_id,arrival_time,stop_id +inspection_line1_ob,downtown,08:00:00 +inspection_line1_ob,anytown,09:00:00 +inspection_line1_ib,anytown,09:15:00 +inspection_line1_ib,downtown,10:15:00 +inspection_line2_ob,downtown,11:00:00 +inspection_line2_ob,busyville,12:30:00 +inspection_line2_ib,busyville,13:00:00 +inspection_line2_ib,downtown,14:30:00 +inspection_line3_ob,downtown,15:00:00 +inspection_line3_ob,centerton,15:45:00 +inspection_line3_ib,centerton,16:00:00 +inspection_line3_ib,downtown,16:45:00 +``` + + +#### `calendar_dates_supplement.txt` + +```csv +service_id,date,exception_type +inspection_train,20240901 +``` + + +#### `run_events.txt` + +Here a run can be defined alongside entirely deadhead trips added via `trips_supplement.txt` using the same `service_id` defined and assigned in `calendar_dates_supplement.txt`. + +```csv +service_id,run_id,event_sequence,event_type,trip_id,start_location,start_time,end_location,end_time +inspection_train ,1 ,1 ,signup , ,main_terminal ,07:15:00 ,main_terminal ,07:45:00 +inspection_train ,1 ,2 ,operator ,inspection_line1_ob ,downtown ,08:00:00 ,anytown ,09:00:00 +inspection_train ,1 ,3 ,operator ,inspection_line1_ib ,anytown ,09:15:00 ,downtown ,10:15:00 +inspection_train ,1 ,4 ,operator ,inspection_line2_ob ,downtown ,11:00:00 ,busyville ,12:30:00 +inspection_train ,1 ,5 ,operator ,inspection_line2_ib ,busyville ,13:00:00 ,downtown ,14:30:00 +inspection_train ,1 ,6 ,operator ,inspection_line3_ob ,downtown ,15:00:00 ,centerton ,15:45:00 +inspection_train ,1 ,7 ,operator ,inspection_line3_ib ,centerton ,16:00:00 ,downtown ,16:45:00 +gameday ,1 ,8 ,signoff , ,main_terminal ,17:00:00 ,main_terminal ,17:30:00 + +``` From 3c9097e1879f9d52c0d9e93e1f3796dff49a362e Mon Sep 17 00:00:00 2001 From: Jeff Kessler <31969870+jeffkessler-keolis@users.noreply.github.com> Date: Mon, 19 Aug 2024 22:05:28 -0400 Subject: [PATCH 3/8] Clarifies run_events PK includes trip_service_id --- docs/spec/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/spec/index.md b/docs/spec/index.md index 98624d8..4935910 100644 --- a/docs/spec/index.md +++ b/docs/spec/index.md @@ -104,7 +104,7 @@ In addition to the fields defined in GTFS, specific fields for use within TODS a ### `run_events.txt` -Primary Key: (`service_id`, `run_id`, `event_sequence`) +Primary Key: (`service_id`, `trip_service_id`, `run_id`, `event_sequence`) | **Field Name** | **Type** | **Required** | **Description** | | --- | --- | --- | --- | From 683e3b7cf7816537cf10ad61d4713f36fcc67dbe Mon Sep 17 00:00:00 2001 From: Jeff Kessler <31969870+jeffkessler-keolis@users.noreply.github.com> Date: Mon, 19 Aug 2024 22:27:09 -0400 Subject: [PATCH 4/8] Adds storm schedule activation example and clarifies many:1 relationship --- docs/spec/examples.md | 34 +++++++++++++++++++++++++++++++++- 1 file changed, 33 insertions(+), 1 deletion(-) diff --git a/docs/spec/examples.md b/docs/spec/examples.md index ddcde5f..0a4467e 100644 --- a/docs/spec/examples.md +++ b/docs/spec/examples.md @@ -171,7 +171,7 @@ weekday,10000,30,BLOCK-A,deadhead ,,stop-1,12:00:00,garage,12:10:00 ## Distinct Crew and Trip schedule scenarios -The below examples identify how to use the distinct `trip_service_id` feature of `run_events.txt` to model instances in which crew schedules may be decoupled from trips, forming a many:many relationship of runs and trips. +The below examples identify how to use the distinct `trip_service_id` feature of `run_events.txt` to model instances in which crew schedules may be decoupled from trips, forming a many:1 relationship of runs and trips. ### Extra staffing for a special event @@ -408,3 +408,35 @@ inspection_train ,1 ,7 ,operator ,inspection_line3_ib ,centerton ,16:00:00 , gameday ,1 ,8 ,signoff , ,main_terminal ,17:00:00 ,main_terminal ,17:30:00 ``` + +### Activating a storm schedule + +Assume a public GTFS file includes a set of trips with service_id `storm_schedule`, with no normal assignment in the calendar. + +#### `calendar.txt` + +```csv +service_id,monday,tuesday,wednesday,thursday,friday,saturday,sunday,start_date,end_date +normal,1,1,1,1,1,0,0,20240101,20241231 +storm_schedule,0,0,0,0,0,0,0,20240101,20241231 +``` + +#### `calendar_dates.txt` + +This storm schedule could be activated whenever inclement weather is encountered by updating `calendar_dates.txt` to include: + +```csv +service_id,date,exception_type +normal,20240901,2 +storm_schedule,20240901,1 +``` + +#### `calendar_dates_supplement.txt` + +While waiting for the GTFS data to propagate through one's system, this could also be reflected in the TODS `calendar_dates_supplement.txt` file to activate the change in any operational systems, alongside any runs associated with the `storm_schedule` service_id. + +```csv +service_id,date,exception_type +normal,20240901,2 +storm_schedule,20240901,1 +``` From ee99911d2528e09105b0e25b4c78f21d7fb46d6b Mon Sep 17 00:00:00 2001 From: Jeff Kessler <31969870+jeffkessler-keolis@users.noreply.github.com> Date: Mon, 19 Aug 2024 22:55:29 -0400 Subject: [PATCH 5/8] Whitespace cleanup per lint style capture --- docs/spec/examples.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/docs/spec/examples.md b/docs/spec/examples.md index 0a4467e..3803720 100644 --- a/docs/spec/examples.md +++ b/docs/spec/examples.md @@ -173,7 +173,6 @@ weekday,10000,30,BLOCK-A,deadhead ,,stop-1,12:00:00,garage,12:10:00 The below examples identify how to use the distinct `trip_service_id` feature of `run_events.txt` to model instances in which crew schedules may be decoupled from trips, forming a many:1 relationship of runs and trips. - ### Extra staffing for a special event Due to a baseball game, an additional ticket collector will be assigned to supplement the existing crew on train 101, serving the ballpark. @@ -202,7 +201,6 @@ gameday,20240827,1 gameday,20240903,1 ``` - ### Different runs mapping to the same set of trips Consider a bus network between West City, Eastland, and Northingdon. Route 1 runs between West City and Eastland via Northingdon, whereas Route 2 runs directly between the two cities. @@ -271,7 +269,6 @@ Consider a commuter train line that operates three daily round-trips: two mornin Every day, the same six trips are operated from the public perspective, with the crew of the earlier morning inbound rush-hour trip always working the earlier evening outbound rush-hour trip (trains 102 and 101, respectively), and the other crew working the later of the two (trains 104 and 103, respectively). To more evenly distribute fatigue and rest, the midday round-trip (trains 191 and 192) is split between the early and late crews by day-of-week, and switching halfway through the year. Whichever crew works the midday trip takes their break in the suburban village, whereas the other crew takes their break in the city. - #### `trips.txt` Rather than listing these trips as varying by day-of-week in a public-facing schedule, these can indeed be maintained as a single service_id in `trips.txt`. @@ -352,7 +349,6 @@ A special track inspection train is being operated on a particular day, supporte _Note: The deadhead trips themselves could be defined in their own new `service_id` even without definining corresponding run data in `run_events.txt` using the `calendar_supplement.txt` or `calendar_dates_supplement.txt` files._ - #### `trips_supplement.txt` ```csv @@ -383,7 +379,6 @@ inspection_line3_ib,centerton,16:00:00 inspection_line3_ib,downtown,16:45:00 ``` - #### `calendar_dates_supplement.txt` ```csv @@ -391,7 +386,6 @@ service_id,date,exception_type inspection_train,20240901 ``` - #### `run_events.txt` Here a run can be defined alongside entirely deadhead trips added via `trips_supplement.txt` using the same `service_id` defined and assigned in `calendar_dates_supplement.txt`. From d8ba9b582cd5e847cff564e6b6837172e96dcbd6 Mon Sep 17 00:00:00 2001 From: Sky Rose Date: Mon, 16 Sep 2024 16:54:38 -0400 Subject: [PATCH 6/8] remove run_events.trip_service_id from spec and trim examples --- docs/spec/examples.md | 248 +++--------------- .../examples/different-runs-same-trips.png | Bin 0 -> 131556 bytes docs/spec/index.md | 19 +- 3 files changed, 55 insertions(+), 212 deletions(-) create mode 100644 docs/spec/examples/different-runs-same-trips.png diff --git a/docs/spec/examples.md b/docs/spec/examples.md index 3803720..ddac7f7 100644 --- a/docs/spec/examples.md +++ b/docs/spec/examples.md @@ -171,28 +171,30 @@ weekday,10000,30,BLOCK-A,deadhead ,,stop-1,12:00:00,garage,12:10:00 ## Distinct Crew and Trip schedule scenarios -The below examples identify how to use the distinct `trip_service_id` feature of `run_events.txt` to model instances in which crew schedules may be decoupled from trips, forming a many:1 relationship of runs and trips. +These examples show situations where the crew schedules in `run_events.txt` use different service IDs than the trips they work on, as is allowed by [the spec](/docs/spec/#service_id-crew-schedules-and-trip-schedules). Most agencies will not need to model a situation like this. + +In all these cases, the trips and service IDs in the public GTFS file are not modified. New service IDs are created in the calendar supplement files, and runs that operate on those dates are described in `run_events.txt`. ### Extra staffing for a special event Due to a baseball game, an additional ticket collector will be assigned to supplement the existing crew on train 101, serving the ballpark. -#### `run_events.txt` +#### `calendar.txt` -_Note that the `run_id` of 1 maps to the combination of `(service_id, trip_service_id)`, meaning other runs with the same `run_id` of `1` can be in effect at the same time provided they existin other combinations of `(service_id, trip_service_id)`._ +```csv +service_id,monday,tuesday,wednesday,thursday,friday,saturday,sunday,start_date,end_date +weekday,1,1,1,1,1,0,0,20240101,20241231 +``` + +#### `trips.txt` ```csv -service_id,trip_service_id,run_id,event_sequence,event_type,trip_id,start_location,start_time,end_location,end_time -gameday,weekday,1,1,signup,,main_terminal,14:00:00,main_terminal,14:15:00 -gameday,weekday,1,2,collector,train_101,main_terminal,14:45:00,ballpark,15:30:00 -gameday,weekday,1,3,work_as_directed,train_101,ballpark,15:30:00,main_terminal,22:00:00 -gameday,weekday,1,4,signoff,,main_terminal,22:00:00,main_terminal,22:15:00 +route_id,service_id,trip_id,block_id +route,weekday,101,BLOCK-A ``` #### `calendar_dates_supplement.txt` -The added position can be added on the applicable gamedays via `calendar_dates_supplement.txt`. - ```csv service_id,date,exception_type gameday,20240820,1 @@ -201,134 +203,41 @@ gameday,20240827,1 gameday,20240903,1 ``` -### Different runs mapping to the same set of trips - -Consider a bus network between West City, Eastland, and Northingdon. Route 1 runs between West City and Eastland via Northingdon, whereas Route 2 runs directly between the two cities. - -To improve on-time performance, the driver working the 10:45am Route 1 departure and the driver of the 11am Route 2 departure will exchange these trips effective September 2024. - -#### `trips.txt` - -```csv -route_id,service_id,trip_id,trip_headsign,direction_id -1,weekday,10001,Eastland via Northingdon,1 -2,weekday,20001,Eastland,1 -1,weekday,10002,West City via Northingdon,0 -2,weekday,20002,West City,0 -``` - -#### `calendar.txt` - -Assume these trips run daily on weekdays in the defined date range. - -```csv -service_id,monday,tuesday,wednesday,thursday,friday,saturday,sunday,start_date,end_date -weekday,1,1,1,1,1,0,0,20240101,20241231 -``` - #### `run_events.txt` -The current runs can be modeled with service_id `current`, and mapped to the existing `weekday` trips. The future runs can be modeled with service_id `future`, also mapped to the existing `weekday` trips. The service_id `weekday` is already defined in `calendar.txt`, but neither `current` nor `future` are. - ```csv -service_id ,trip_service_id ,run_id ,event_sequence ,block_id ,event_type ,trip_id ,start_location ,start_time ,end_location ,end_time -current ,weekday ,1 ,10 ,A ,report , ,garage ,08:00:00 ,garage ,08:20:00 -current ,weekday ,1 ,20 ,A ,drive ,10001 ,westcity ,09:00:00 ,eastland ,10:30:00 -current ,weekday ,1 ,30 ,A ,drive ,10002 ,eastland ,10:45:00 ,westcity ,12:15:00 -current ,weekday ,1 ,40 ,A ,signoff , ,garage ,12:45:00 ,garage ,13:00:00 - -current ,weekday ,2 ,10 ,B ,report , ,garage ,08:00:00 ,garage ,08:20:00 -current ,weekday ,2 ,20 ,B ,drive ,20001 ,westcity ,09:00:00 ,eastland ,10:00:00 -current ,weekday ,2 ,30 ,B ,drive ,20002 ,eastland ,11:00:00 ,westcity ,12:00:00 -current ,weekday ,2 ,40 ,B ,signoff , ,garage ,12:30:00 ,garage ,12:45:00 - -future ,weekday ,1 ,10 ,A ,report , ,garage ,08:00:00 ,garage ,08:20:00 -future ,weekday ,1 ,20 ,A ,drive ,10001 ,westcity ,09:00:00 ,eastland ,10:30:00 -future ,weekday ,1 ,30 ,A ,drive ,20002 ,eastland ,11:00:00 ,westcity ,12:00:00 -future ,weekday ,1 ,40 ,A ,signoff , ,garage ,12:30:00 ,garage ,12:45:00 - -future ,weekday ,2 ,10 ,B ,report , ,garage ,08:00:00 ,garage ,08:20:00 -future ,weekday ,2 ,20 ,B ,drive ,20001 ,westcity ,09:00:00 ,eastland ,10:00:00 -future ,weekday ,2 ,30 ,B ,drive ,10002 ,eastland ,10:45:00 ,westcity ,12:15:00 -future ,weekday ,2 ,40 ,B ,signoff , ,garage ,12:45:00 ,garage ,13:00:00 +service_id,run_id,event_sequence,block_id,job_type,event_type,trip_id,start_location,start_time,end_location,end_time +weekday,1,1, ,collector,sign-in , ,main_terminal,14:00:00,main_terminal,14:15:00 +weekday,1,2,BLOCK-A,collector,collector ,101,main_terminal,14:45:00,ballpark ,15:30:00 +gameday,2,1, ,collector,sign-in , ,main_terminal,14:00:00,main_terminal,14:15:00 +gameday,2,2,BLOCK-A,collector,extra collector,101,main_terminal,14:45:00,ballpark ,15:30:00 ``` -#### `calendar_supplement.txt` +### Trip worked by different runs on different dates -To detail the presence of the new `service_id`s and assign them to their applicable days of the week, the runs can be added to the calendar via `calendar_supplement.txt`: - -```csv -service_id,monday,tuesday,wednesday,thursday,friday,saturday,sunday,start_date,end_date -current,1,1,1,1,1,0,0,20240101,20240831 -future ,1,1,1,1,1,0,0,20240901,20241231 -``` - -### Variations of runs by day of the week - -Consider a commuter train line that operates three daily round-trips: two morning inbound trains from the suburbs to the city, two evening return trips from the city to the suburbs, plus one reverse-peak trip for day-trippers to the outlying village and back. - -Every day, the same six trips are operated from the public perspective, with the crew of the earlier morning inbound rush-hour trip always working the earlier evening outbound rush-hour trip (trains 102 and 101, respectively), and the other crew working the later of the two (trains 104 and 103, respectively). To more evenly distribute fatigue and rest, the midday round-trip (trains 191 and 192) is split between the early and late crews by day-of-week, and switching halfway through the year. Whichever crew works the midday trip takes their break in the suburban village, whereas the other crew takes their break in the city. +Consider a bus network between West City, Eastland, and Northingdon. Route 1 runs between West City and Eastland via Northingdon, whereas Route 2 runs directly between the two cities. -#### `trips.txt` +To lengthen a short layover and improve on-time performance, the driver working the 10:45am Route 1 departure and the driver of the 11am Route 2 departure will exchange these trips effective September 2024. -Rather than listing these trips as varying by day-of-week in a public-facing schedule, these can indeed be maintained as a single service_id in `trips.txt`. +The public-facing schedule will not change. The trips remain on the service `weekday`. The runs are scheduled on new services `summer` and `fall`, which together cover all of the dates in `weekday`. -```csv -route_id,service_id,trip_id,trip_headsign,direction_id,trip_short_name -commuter_line,spring_train_schedule,spring-city_train_102,City ,1,102 -commuter_line,spring_train_schedule,spring-city_train_104,City ,1,104 -commuter_line,spring_train_schedule,spring-city_train_191,Suburbs,0,191 -commuter_line,spring_train_schedule,spring-city_train_192,City ,1,192 -commuter_line,spring_train_schedule,spring-city_train_101,Suburbs,0,101 -commuter_line,spring_train_schedule,spring-city_train_103,Suburbs,0,103 -``` +![Diagram showing four trips on two runs, with the assignments rearranged in the fall.](different-runs-same-trips.png) #### `calendar.txt` -Assume these trips run daily on weekdays in the defined date range. - ```csv service_id,monday,tuesday,wednesday,thursday,friday,saturday,sunday,start_date,end_date -spring_train_schedule,1,1,1,1,1,0,0,20240101,20241231 +weekday,1,1,1,1,1,0,0,20240601,20241231 ``` -#### `run_events.txt` - -The individual runs can be broken into two run-based service_ids: `spring_train_latelong` represents the days where the late job works the midday trip (and has its break in the village), whereas `spring_train_earlylong` represents the days where the early job works the midday trip. - -Note that in all circumstances, the trips all reference those with `service_id` matching `spring_train_schedule`; there are not any trips defined under `service_id` `spring_train_latelong` nor `spring_train_earlylong`. +#### `trips.txt` ```csv -service_id,trip_service_id,run_id,event_sequence,block_id,event_type,trip_id,start_location,start_time,end_location,end_time - -spring_train_latelong ,spring_train_schedule,early_job,10,BLOCK-A,sign-in , ,yard ,06:00:00,yard ,06:15:00 -spring_train_latelong ,spring_train_schedule,early_job,20,BLOCK-A,conductor,spring-city_train_102,village,06:30:00,city ,07:30:00 -spring_train_latelong ,spring_train_schedule,early_job,30,BLOCK-A,release , ,city ,07:45:00,city ,16:00:00 -spring_train_latelong ,spring_train_schedule,early_job,40,BLOCK-A,conductor,spring-city_train_101,city ,16:30:00,village,17:30:00 -spring_train_latelong ,spring_train_schedule,early_job,50,BLOCK-A,sign-off , ,yard ,17:30:00,yard ,17:45:00 - -spring_train_latelong ,spring_train_schedule,later_job,10,BLOCK-B,sign-in , ,yard ,07:00:00,yard ,07:15:00 -spring_train_latelong ,spring_train_schedule,later_job,20,BLOCK-B,conductor,spring-city_train_104,village,07:30:00,city ,08:30:00 -spring_train_latelong ,spring_train_schedule,later_job,30,BLOCK-B,conductor,spring-city_train_191,city ,09:00:00,village,10:00:00 -spring_train_latelong ,spring_train_schedule,later_job,40,BLOCK-B,break , ,village,10:00:00,village,15:00:00 -spring_train_latelong ,spring_train_schedule,later_job,50,BLOCK-B,conductor,spring-city_train_190,village,15:00:00,city ,16:00:00 -spring_train_latelong ,spring_train_schedule,later_job,60,BLOCK-B,conductor,spring-city_train_103,city ,17:30:00,village,18:30:00 -spring_train_latelong ,spring_train_schedule,later_job,70,BLOCK-B,sign-off , ,yard ,18:30:00,yard ,18:45:00 - -spring_train_earlylong,spring_train_schedule,early_job,10,BLOCK-A,sign-in , ,yard ,06:00:00,yard ,06:15:00 -spring_train_earlylong,spring_train_schedule,early_job,20,BLOCK-A,conductor,spring-city_train_102,village,06:30:00,city ,07:30:00 -spring_train_earlylong,spring_train_schedule,early_job,30,BLOCK-A,conductor,spring-city_train_191,city ,09:00:00,village,10:00:00 -spring_train_earlylong,spring_train_schedule,early_job,40,BLOCK-A,break , ,village,10:00:00,village,15:00:00 -spring_train_earlylong,spring_train_schedule,early_job,50,BLOCK-A,conductor,spring-city_train_190,village,15:00:00,city ,16:00:00 -spring_train_earlylong,spring_train_schedule,early_job,60,BLOCK-A,conductor,spring-city_train_101,city ,16:30:00,village,17:30:00 -spring_train_earlylong,spring_train_schedule,early_job,70,BLOCK-A,sign-off , ,yard ,17:30:00,yard ,17:45:00 - -spring_train_earlylong,spring_train_schedule,later_job,10,BLOCK-B,sign-in , ,yard ,07:00:00,yard ,07:15:00 -spring_train_earlylong,spring_train_schedule,later_job,20,BLOCK-B,conductor,spring-city_train_104,village,07:30:00,city ,08:30:00 -spring_train_earlylong,spring_train_schedule,later_job,30,BLOCK-B,release , ,city ,08:45:00,city ,17:00:00 -spring_train_earlylong,spring_train_schedule,later_job,40,BLOCK-B,conductor,spring-city_train_103,city ,17:30:00,village,18:30:00 -spring_train_earlylong,spring_train_schedule,later_job,50,BLOCK-B,sign-off , ,yard ,18:30:00,yard ,18:45:00 - +route_id,service_id,trip_id,trip_headsign,direction_id +1,weekday,101,Eastland via Northingdon,1 +2,weekday,201,Eastland,1 +1,weekday,102,West City via Northingdon,0 +2,weekday,202,West City,0 ``` #### `calendar_supplement.txt` @@ -337,100 +246,27 @@ To detail the presence of the new `service_id`s and assign them to their applica ```csv service_id,monday,tuesday,wednesday,thursday,friday,saturday,sunday,start_date,end_date -spring_train_latelong ,1,0,1,0,1,0,0,20240101,20240630 -spring_train_earlylong,0,1,0,1,0,0,0,20240101,20240630 -spring_train_earlylong,1,0,1,0,1,0,0,20240701,20241231 -spring_train_latelong ,0,1,0,1,0,0,0,20240701,20241231 -``` - -### Jobs of entirely nonrevenue operations - -A special track inspection train is being operated on a particular day, supported by an extra crew position. - -_Note: The deadhead trips themselves could be defined in their own new `service_id` even without definining corresponding run data in `run_events.txt` using the `calendar_supplement.txt` or `calendar_dates_supplement.txt` files._ - -#### `trips_supplement.txt` - -```csv -route_id,service_id,trip_id,TODS_trip_type,direction_id -line1,inspection_train,inspection_line1_ob,deadhead,0 -line1,inspection_train,inspection_line1_ib,deadhead,1 -line1,inspection_train,inspection_line2_ob,deadhead,0 -line1,inspection_train,inspection_line2_ib,deadhead,1 -line1,inspection_train,inspection_line3_ob,deadhead,0 -line1,inspection_train,inspection_line3_ib,deadhead,1 -``` - -#### `stop_times_supplement.txt` - -```csv -trip_id,arrival_time,stop_id -inspection_line1_ob,downtown,08:00:00 -inspection_line1_ob,anytown,09:00:00 -inspection_line1_ib,anytown,09:15:00 -inspection_line1_ib,downtown,10:15:00 -inspection_line2_ob,downtown,11:00:00 -inspection_line2_ob,busyville,12:30:00 -inspection_line2_ib,busyville,13:00:00 -inspection_line2_ib,downtown,14:30:00 -inspection_line3_ob,downtown,15:00:00 -inspection_line3_ob,centerton,15:45:00 -inspection_line3_ib,centerton,16:00:00 -inspection_line3_ib,downtown,16:45:00 -``` - -#### `calendar_dates_supplement.txt` - -```csv -service_id,date,exception_type -inspection_train,20240901 +summer,1,1,1,1,1,0,0,20240601,20240831 +fall ,1,1,1,1,1,0,0,20240901,20241231 ``` #### `run_events.txt` -Here a run can be defined alongside entirely deadhead trips added via `trips_supplement.txt` using the same `service_id` defined and assigned in `calendar_dates_supplement.txt`. +The current runs can be modeled with service_id `summer`, and mapped to the existing `weekday` trips. The future runs can be modeled with service_id `fall`, also mapped to the existing `weekday` trips. The service_id `weekday` is already defined in `calendar.txt`, but neither `summer` nor `fall` are. ```csv -service_id,run_id,event_sequence,event_type,trip_id,start_location,start_time,end_location,end_time -inspection_train ,1 ,1 ,signup , ,main_terminal ,07:15:00 ,main_terminal ,07:45:00 -inspection_train ,1 ,2 ,operator ,inspection_line1_ob ,downtown ,08:00:00 ,anytown ,09:00:00 -inspection_train ,1 ,3 ,operator ,inspection_line1_ib ,anytown ,09:15:00 ,downtown ,10:15:00 -inspection_train ,1 ,4 ,operator ,inspection_line2_ob ,downtown ,11:00:00 ,busyville ,12:30:00 -inspection_train ,1 ,5 ,operator ,inspection_line2_ib ,busyville ,13:00:00 ,downtown ,14:30:00 -inspection_train ,1 ,6 ,operator ,inspection_line3_ob ,downtown ,15:00:00 ,centerton ,15:45:00 -inspection_train ,1 ,7 ,operator ,inspection_line3_ib ,centerton ,16:00:00 ,downtown ,16:45:00 -gameday ,1 ,8 ,signoff , ,main_terminal ,17:00:00 ,main_terminal ,17:30:00 +service_id ,run_id ,event_sequence ,block_id ,event_type ,trip_id ,start_location ,start_time ,end_location ,end_time +summer ,1 ,20 ,A ,drive ,101 ,westcity ,09:00:00 ,eastland ,10:30:00 +summer ,1 ,30 ,A ,drive ,102 ,eastland ,10:45:00 ,westcity ,12:15:00 -``` - -### Activating a storm schedule +summer ,2 ,20 ,B ,drive ,201 ,westcity ,09:00:00 ,eastland ,10:00:00 +summer ,2 ,30 ,B ,drive ,202 ,eastland ,11:00:00 ,westcity ,12:00:00 -Assume a public GTFS file includes a set of trips with service_id `storm_schedule`, with no normal assignment in the calendar. +fall ,1 ,20 ,A ,drive ,101 ,westcity ,09:00:00 ,eastland ,10:30:00 +fall ,1 ,30 ,A ,drive ,202 ,eastland ,11:00:00 ,westcity ,12:00:00 -#### `calendar.txt` - -```csv -service_id,monday,tuesday,wednesday,thursday,friday,saturday,sunday,start_date,end_date -normal,1,1,1,1,1,0,0,20240101,20241231 -storm_schedule,0,0,0,0,0,0,0,20240101,20241231 +fall ,2 ,20 ,B ,drive ,201 ,westcity ,09:00:00 ,eastland ,10:00:00 +fall ,2 ,30 ,B ,drive ,102 ,eastland ,10:45:00 ,westcity ,12:15:00 ``` -#### `calendar_dates.txt` - -This storm schedule could be activated whenever inclement weather is encountered by updating `calendar_dates.txt` to include: - -```csv -service_id,date,exception_type -normal,20240901,2 -storm_schedule,20240901,1 -``` - -#### `calendar_dates_supplement.txt` - -While waiting for the GTFS data to propagate through one's system, this could also be reflected in the TODS `calendar_dates_supplement.txt` file to activate the change in any operational systems, alongside any runs associated with the `storm_schedule` service_id. - -```csv -service_id,date,exception_type -normal,20240901,2 -storm_schedule,20240901,1 -``` +(In this example, block IDs are listed in `run_events.txt` but not `trips.txt` because the blocks would also change with the schedule change.) diff --git a/docs/spec/examples/different-runs-same-trips.png b/docs/spec/examples/different-runs-same-trips.png new file mode 100644 index 0000000000000000000000000000000000000000..d2d662c3cb4f67b9e74b54df56dca0fc99f333a6 GIT binary patch literal 131556 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
If `trip_service_id` is not set, the `service_id` field will be used to refer to both an operation's vehicle and crew schedules. When an event's `trip_service_id` is active, its `service_id` must also be in effect. | +| `service_id` | ID referencing `calendar.service_id` or `calendar_dates.service_id` | Required | Identifies a set of dates when the run is scheduled to take place. | | `run_id` | ID | Required | A run is uniquely determined by a `service_id`, `run_id` pair. Runs with the same `run_id` on different `service_id`s are considered different runs. | | `event_sequence` | Non-negative integer | Required | The order of this event within a run. Must be unique within one (`service_id`, `run_id`). See [more detail below](#event_sequence-and-event-times) about how order is defined. | | `piece_id` | ID | Optional | Identifies the piece within the run that the event takes place.

May be blank if the event takes place out of a piece, like a break, or if the agency does not use piece IDs. | | `block_id` | ID referencing `trips.block_id` | Optional | Identifies the block to which the run event belongs.

This field is always optional. May exist even if `trip_id` does not (e.g. if an event represents a run-as-directed block with no scheduled trips). May exist even if `trip_id` exists and the associated trip in `trips.txt` doesn't have a `block_id`. May be omitted even if `trip_id` exists and the associated trip in `trips.txt` has a `block_id`.

If `block_id` is set, `trip_id` is set, and the associated trip in `trips.txt` has a `block_id`, then the two `block_id`s must not be different. | | `job_type` | Text | Optional | The type of job that the employee is doing, in a human-readable format. e.g. "Assistant Conductor". Producers may use any values, but should be consistent.

A single run may include more than one `job_type` throughout the day if the employee has multiple responsibilities, e.g. an "Operator" in the morning and a "Shifter" in the afternoon. | | `event_type` | Text | Required | The type of event that the employee is doing, in a human-readable format. e.g. "Sign-in". Producers may use any values, but should be consistent. Consumers may ignore events with an `event_type` that they don't recognize. | -| `trip_id` | ID referencing `trips.trip_id` | Optional | If this run event corresponds to working on a trip, identifies that trip. | +| `trip_id` | ID referencing `trips.trip_id` | Optional | If this run event corresponds to working on a trip, identifies that trip. Note that the trip may be on a different `service_id` than the run, see [`service_id`, Crew Schedules, and Trip Schedules](#service_id-crew-schedules-and-trip-schedules). | | `start_location` | ID referencing `stops.stop_id` | Required | Identifies where the employee starts working this event.

If `trip_id` is set (and `mid_trip_start` is not `1`), this should be the `stop_id` of the first stop of the trip in `stop_times.txt` (after applying any trip supplement). If `start_mid_trip` is `1`, this should be the location where the employee starts working, matching a `stop_id` in the middle of the supplemented trip. | | `start_time` | Time | Required | Identifies the time when the employee starts working this event.

If `trip_id` is set (and `mid_trip_start` is not `1`), this corresponds to the time of the first stop of the trip in `stop_times.txt` (after applying any trip supplement). If `start_mid_trip` is `1`, this time corresponds to a stop time in the middle of the supplemented trip, when the employee starts working on the trip. Note that this time may not exactly match `stop_times.txt` `arrival_time` or `departure_time` if the employee is considered to be working for a couple minutes before the trip departs. This field is about when the employee is working, and consumers who care about the the trip times should check `stop_times.txt` instead. | | `start_mid_trip` | Enum | Optional | Indicates whether the event begins at the start of the trip or in the middle of the trip (after applying any trip supplement).

`0` (or blank) - Run event is not associated with a trip, or no information about whether the run event starts mid-trip
`1` - Run event starts mid-trip
`2` - Run event does not start mid-trip | @@ -124,9 +123,17 @@ Primary Key: (`service_id`, `trip_service_id`, `run_id`, `event_sequence`) | `end_time` | Time | Required | Identifies the time when the employee stops working this event.

If `trip_id` is set (and `mid_trip_end` is not `1`), this corresponds to the time of the last stop of the trip in `stop_times.txt` (after applying any trip supplement). If `end_mid_trip` is `1`, this time corresponds to a stop time in the middle of the supplemented trip, when the employee stops working on the trip. Note that this time may not exactly match `stop_times.txt` `arrival_time` or `departure_time` if the employee is considered to be working for a couple minutes after the trip finishes. This field is about when the employee is working, and consumers who care about the the trip times should check `stop_times.txt` instead. | | `end_mid_trip` | Enum | Optional | Indicates whether the event ends at the end of the trip or in the middle of the trip (after applying any trip supplement).

`0` (or blank) - Run event is not associated with a trip, or no information about whether the run event ends mid-trip
`1` - Run event ends mid-trip
`2` - Run event does not end mid-trip | -#### `service_id` and `trip_service_id` +#### `service_id`, Crew Schedules, and Trip Schedules -`service_id` is a required field that identifies when the corresponding run is in effect. In operations where crew schedules are uncoupled from the underlying trips (such that multiple crew schedules can apply to the same underlying sets of trips), `trip_service_id` can be used to link a run event with a trip in its specific `service_id.` Note that, in order for crew schedules and vehicle/trip schedules to be represented in a distinct fashion, the IDs used for `service_id` and `trip_service_id` must be different. Otherwise, the ID used will represent a set of trips, in addition to the runs in effect at that time, which creates an inherent conflict in use. +For most agencies, crew schedules will use the same schedule as trips do. The `service_id` in `run_events.txt` will be the same `service_id` as is in `trips.txt` for all the trips that run works on, and the TODS feed won't need any additional entries in `calendar_supplement.txt`. + +Some agencies schedule crew schedules separately from vehicle/trip schedules, and runs and trips may occur on different `service_id`s. For example, a trip that occurs on service ID `weekday` may be worked by run `1` on service ID `monday`, and by run `2` on service ID `tuesday`. See the [examples](/spec/examples) for some situations where this may happen. In that case, `trips.txt:service_id` refers to dates when the trip occurs, and `run_events.txt:service_id` refers to the dates where the run works that trip. This means that producers do not need to rewrite the calendar for their public GTFS trip schedules in order to publish complex crew schedules in TODS. + +Consumers who care about the dates that a trip occurs should use the `trip_id` (which is unique even across different services) to look up the trip in `trips.txt`, and get the `service_id` there. + +Producers who create separate services for their crew schedules will likely need to add those services into `calendar_supplement.txt` and `calendar_dates_supplement.txt`. + +If the run's `service_id` and the trip's `service_id` are different, the run's `service_id` must not occur on any dates that the trip's `service_id` doesn't (after combining data from `calendar.txt`, `calendar_supplement.txt`, `calendar_dates.txt`, and `calendar_dates_supplement.txt`). #### `event_sequence` and Event Times From 5017c7aaab3844c124e3c7b4f2d48f4996c53e07 Mon Sep 17 00:00:00 2001 From: Sky Rose Date: Mon, 11 Nov 2024 13:27:49 -0500 Subject: [PATCH 7/8] add back nonrevenue job example --- docs/spec/examples.md | 41 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) diff --git a/docs/spec/examples.md b/docs/spec/examples.md index ddac7f7..d3dcaa1 100644 --- a/docs/spec/examples.md +++ b/docs/spec/examples.md @@ -169,6 +169,47 @@ weekday,10000,30,BLOCK-A,run-as-directed,,stop-1,09:00:00,stop-1,12:00:00 weekday,10000,30,BLOCK-A,deadhead ,,stop-1,12:00:00,garage,12:10:00 ``` +## Jobs of entirely nonrevenue operations + +A track inspection train operates once per week, with a separate crew. It's scheduled and operated separately from other service, so is given its own service ID separate from any trips in the public GTFS file. In this example, the route and stops are assumed to be defined in the public GTFS. + +### `calendar_supplement.txt` + +```csv +service_id,monday,tuesday,wednesday,thursday,friday,saturday,sunday,start_date,end_date +inspection_train,0,0,0,0,0,0,1,20240601,20241231 +``` + +### `trips_supplement.txt` + +```csv +route_id,service_id,trip_id,TODS_trip_type,direction_id +line1,inspection_train,inspection_line1_ob,deadhead,0 +line1,inspection_train,inspection_line1_ib,deadhead,1 +``` + +### `stop_times_supplement.txt` + +```csv +trip_id,stop_id,arrival_time +inspection_line1_ob,downtown,01:00:00 +inspection_line1_ob,anytown,01:45:00 +inspection_line1_ib,anytown,02:00:00 +inspection_line1_ib,downtown,02:45:00 +``` + +### `run_events.txt` + +This file references the service ID and trip ID defined in the other supplement files. + +```csv +service_id,run_id,event_sequence,event_type,trip_id,start_location,start_time,end_location,end_time +inspection_train ,1 ,1 ,sign-in , ,main_terminal ,00:45:00 ,main_terminal ,00:45:00 +inspection_train ,1 ,2 ,operator ,inspection_line1_ob ,downtown ,01:00:00 ,anytown ,01:45:00 +inspection_train ,1 ,3 ,operator ,inspection_line1_ib ,anytown ,02:00:00 ,downtown ,02:45:00 +inspection_train ,1 ,4 ,sign-off , ,main_terminal ,03:00:00 ,main_terminal ,03:00:00 +``` + ## Distinct Crew and Trip schedule scenarios These examples show situations where the crew schedules in `run_events.txt` use different service IDs than the trips they work on, as is allowed by [the spec](/docs/spec/#service_id-crew-schedules-and-trip-schedules). Most agencies will not need to model a situation like this. From 6778a931090ce39dd7ad066a6e367f45f88370b5 Mon Sep 17 00:00:00 2001 From: Sky Rose Date: Mon, 11 Nov 2024 13:41:06 -0500 Subject: [PATCH 8/8] add more prominent note about non-unique run ids --- docs/spec/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/spec/index.md b/docs/spec/index.md index e6fa559..7036a8d 100644 --- a/docs/spec/index.md +++ b/docs/spec/index.md @@ -149,6 +149,7 @@ Because some events may overlap in time, it may not be possible to choose a sing #### `run_events` Notes +- Run IDs may be reused between different service IDs. A run is uniquely determined by a `service_id`, `run_id` pair. Runs with the same `run_id` on different `service_id`s are considered different unrelated runs. - Multiple `run_event`s may refer to the same `trip_id`, if multiple employees work on that trip. - Events may have gaps between the end time of one event and the start time of the next. e.g. if an operator's layovers aren't represented by an event. - `start_time` may equal `end_time` for an event that's a single point in time (such as a report time) without any duration.