From e72b7b345b0598978a89e64c21dcd894ad72c6d6 Mon Sep 17 00:00:00 2001 From: Aaron Antrim Date: Sun, 8 Jan 2017 19:19:20 -0500 Subject: [PATCH 1/8] block_id + service day --- gtfs/spec/en/reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md index 7614d9ff6..5eeb40e64 100644 --- a/gtfs/spec/en/reference.md +++ b/gtfs/spec/en/reference.md @@ -166,7 +166,7 @@ File: **Required** | | | * `trip_id,...,trip_headsign,direction_id` | | | | * `1234,...,to Airport,0` | | | | * `1505,...,to Downtown,1` | -| block_id | Optional | The **block_id** field identifies the block to which the trip belongs. A block consists of two or more sequential trips made using the same vehicle, where a passenger can transfer from one trip to the next just by staying in the vehicle. The **block_id** must be referenced by two or more trips in trips.txt. | +| block_id | Optional | The **block_id** field identifies the block to which the trip belongs. A block consists of two or more sequential trips made using the same vehicle, defined by shared service day and block_id. The block_id must be referenced by two or more trips in trips.txt. A block_id can have trips with different service days, making distinct blocks. | | shape_id | Optional | The **shape_id** field contains an ID that defines a shape for the trip. This value is referenced from the [shapes.txt](#shapestxt) file. The shapes.txt file allows you to define how a line should be drawn on the map to represent a trip. | | wheelchair_accessible | Optional | * **0** (or empty) - indicates that there is no accessibility information for the trip | | | | * **1** - indicates that the vehicle being used on this particular trip can accommodate at least one rider in a wheelchair | From 99d6691ec96a090a09f4ff06cc59b13eba0ccf19 Mon Sep 17 00:00:00 2001 From: Aaron Antrim Date: Sun, 8 Jan 2017 19:26:50 -0500 Subject: [PATCH 2/8] example table showing blocks and service day --- gtfs/spec/en/reference.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md index 5eeb40e64..30e343545 100644 --- a/gtfs/spec/en/reference.md +++ b/gtfs/spec/en/reference.md @@ -166,7 +166,7 @@ File: **Required** | | | * `trip_id,...,trip_headsign,direction_id` | | | | * `1234,...,to Airport,0` | | | | * `1505,...,to Downtown,1` | -| block_id | Optional | The **block_id** field identifies the block to which the trip belongs. A block consists of two or more sequential trips made using the same vehicle, defined by shared service day and block_id. The block_id must be referenced by two or more trips in trips.txt. A block_id can have trips with different service days, making distinct blocks. | +| block_id | Optional | The **block_id** field identifies the block to which the trip belongs. A block consists of two or more sequential trips made using the same vehicle, defined by shared service day and block_id. The block_id must be referenced by two or more trips in trips.txt. A block_id can have trips with different service days, making distinct blocks. (See [example below](#example-showing-blocks-and-service-day)) | | shape_id | Optional | The **shape_id** field contains an ID that defines a shape for the trip. This value is referenced from the [shapes.txt](#shapestxt) file. The shapes.txt file allows you to define how a line should be drawn on the map to represent a trip. | | wheelchair_accessible | Optional | * **0** (or empty) - indicates that there is no accessibility information for the trip | | | | * **1** - indicates that the vehicle being used on this particular trip can accommodate at least one rider in a wheelchair | @@ -175,6 +175,22 @@ File: **Required** | | | * **1** - indicates that the vehicle being used on this particular trip can accommodate at least one bicycle | | | | * **2** - indicates that no bicycles are allowed on this trip | +The example below is valid, with distinct blocks every day of the week. + +#### Example showing blocks and service day + +| route_id | trip_id | service_id | block_id | first stop time [not part of trips.txt] | last stop time [not part of trips.txt] | +|----------|---------|--------------------------------|----------|-----------------------------------------|-------------------------| +| red | trip_1 | mon-tues-wed-thurs-fri-sat-sun | red_loop | 22:00:00 | 22:55:00 | +| red | trip_2 | fri-sat-sun | red_loop | 23:00:00 | 23:55:00 | +| red | trip_3 | fri-sat | red_loop | 24:00:00 | 24:55:00 | +| red | trip_4 | mon-tues-wed-thurs | red_loop | 20:00:00 | 20:50:00 | +| red | trip_5 | mon-tues-wed-thurs | red_loop | 21:00:00 | 21:50:00 | + +Notes on above table: +* On Friday into Saturday morning, for example, a single vehicle operates trip_1, trip_2, and trip_3 (10:00 PM through 12:55 AM). Note that the last trip occurs on Saturday, 12:00 AM to 12:55 AM, but is part of the Friday “service day” because the times are 24:00:00 to 24:55:00. +* On Monday, Tuesday, Wednesday, and Thursday, a single vehicle operates trip_1, trip_4, and trip_5 in a block from 8:00 PM to 10:55 PM. + ### stop_times.txt File: **Required** From 38e518afaf603aba1a1aad3f2c4a8e960298b12a Mon Sep 17 00:00:00 2001 From: Aaron Antrim Date: Sat, 21 Jan 2017 17:35:14 -0800 Subject: [PATCH 3/8] modifications to block & service day table --- gtfs/spec/en/reference.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md index 30e343545..57629d503 100644 --- a/gtfs/spec/en/reference.md +++ b/gtfs/spec/en/reference.md @@ -175,11 +175,11 @@ File: **Required** | | | * **1** - indicates that the vehicle being used on this particular trip can accommodate at least one bicycle | | | | * **2** - indicates that no bicycles are allowed on this trip | -The example below is valid, with distinct blocks every day of the week. - #### Example showing blocks and service day -| route_id | trip_id | service_id | block_id | first stop time [not part of trips.txt] | last stop time [not part of trips.txt] | +The example below is valid, with distinct blocks every day of the week. + +| route_id | trip_id | service_id | block_id | *(first stop time)* | *(last stop time)* | |----------|---------|--------------------------------|----------|-----------------------------------------|-------------------------| | red | trip_1 | mon-tues-wed-thurs-fri-sat-sun | red_loop | 22:00:00 | 22:55:00 | | red | trip_2 | fri-sat-sun | red_loop | 23:00:00 | 23:55:00 | From 464b4bd79bb38106db4653254c9da95817131545 Mon Sep 17 00:00:00 2001 From: Aaron Antrim Date: Sat, 21 Jan 2017 17:39:44 -0800 Subject: [PATCH 4/8] remove "block_id must be referenced by two or more trips" --- gtfs/spec/en/reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md index 57629d503..19fa3e204 100644 --- a/gtfs/spec/en/reference.md +++ b/gtfs/spec/en/reference.md @@ -166,7 +166,7 @@ File: **Required** | | | * `trip_id,...,trip_headsign,direction_id` | | | | * `1234,...,to Airport,0` | | | | * `1505,...,to Downtown,1` | -| block_id | Optional | The **block_id** field identifies the block to which the trip belongs. A block consists of two or more sequential trips made using the same vehicle, defined by shared service day and block_id. The block_id must be referenced by two or more trips in trips.txt. A block_id can have trips with different service days, making distinct blocks. (See [example below](#example-showing-blocks-and-service-day)) | +| block_id | Optional | The **block_id** field identifies the block to which the trip belongs. A block consists of two or more sequential trips made using the same vehicle, defined by shared service day and block_id. A block_id can have trips with different service days, making distinct blocks. (See [example below](#example-showing-blocks-and-service-day)) | | shape_id | Optional | The **shape_id** field contains an ID that defines a shape for the trip. This value is referenced from the [shapes.txt](#shapestxt) file. The shapes.txt file allows you to define how a line should be drawn on the map to represent a trip. | | wheelchair_accessible | Optional | * **0** (or empty) - indicates that there is no accessibility information for the trip | | | | * **1** - indicates that the vehicle being used on this particular trip can accommodate at least one rider in a wheelchair | From 75daa59aee1012cca87b275636fc53c45aab6163 Mon Sep 17 00:00:00 2001 From: Aaron Antrim Date: Sat, 21 Jan 2017 17:44:25 -0800 Subject: [PATCH 5/8] Revert "remove "block_id must be referenced by two or more trips"" This reverts commit 464b4bd79bb38106db4653254c9da95817131545. --- gtfs/spec/en/reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md index 19fa3e204..57629d503 100644 --- a/gtfs/spec/en/reference.md +++ b/gtfs/spec/en/reference.md @@ -166,7 +166,7 @@ File: **Required** | | | * `trip_id,...,trip_headsign,direction_id` | | | | * `1234,...,to Airport,0` | | | | * `1505,...,to Downtown,1` | -| block_id | Optional | The **block_id** field identifies the block to which the trip belongs. A block consists of two or more sequential trips made using the same vehicle, defined by shared service day and block_id. A block_id can have trips with different service days, making distinct blocks. (See [example below](#example-showing-blocks-and-service-day)) | +| block_id | Optional | The **block_id** field identifies the block to which the trip belongs. A block consists of two or more sequential trips made using the same vehicle, defined by shared service day and block_id. The block_id must be referenced by two or more trips in trips.txt. A block_id can have trips with different service days, making distinct blocks. (See [example below](#example-showing-blocks-and-service-day)) | | shape_id | Optional | The **shape_id** field contains an ID that defines a shape for the trip. This value is referenced from the [shapes.txt](#shapestxt) file. The shapes.txt file allows you to define how a line should be drawn on the map to represent a trip. | | wheelchair_accessible | Optional | * **0** (or empty) - indicates that there is no accessibility information for the trip | | | | * **1** - indicates that the vehicle being used on this particular trip can accommodate at least one rider in a wheelchair | From 4668445af548ed555d82d5ec25bab898325a2a50 Mon Sep 17 00:00:00 2001 From: Aaron Antrim Date: Sat, 21 Jan 2017 17:45:50 -0800 Subject: [PATCH 6/8] remove statement block_id must have more than 1 trips --- gtfs/spec/en/reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md index 57629d503..78c312185 100644 --- a/gtfs/spec/en/reference.md +++ b/gtfs/spec/en/reference.md @@ -166,7 +166,7 @@ File: **Required** | | | * `trip_id,...,trip_headsign,direction_id` | | | | * `1234,...,to Airport,0` | | | | * `1505,...,to Downtown,1` | -| block_id | Optional | The **block_id** field identifies the block to which the trip belongs. A block consists of two or more sequential trips made using the same vehicle, defined by shared service day and block_id. The block_id must be referenced by two or more trips in trips.txt. A block_id can have trips with different service days, making distinct blocks. (See [example below](#example-showing-blocks-and-service-day)) | +| block_id | Optional | The **block_id** field identifies the block to which the trip belongs. A block consists of a single trip or or many sequential trips made using the same vehicle, defined by shared service day and block_id. The block_id must be referenced by two or more trips in trips.txt. A block_id can have trips with different service days, making distinct blocks. (See [example below](#example-showing-blocks-and-service-day)) | | shape_id | Optional | The **shape_id** field contains an ID that defines a shape for the trip. This value is referenced from the [shapes.txt](#shapestxt) file. The shapes.txt file allows you to define how a line should be drawn on the map to represent a trip. | | wheelchair_accessible | Optional | * **0** (or empty) - indicates that there is no accessibility information for the trip | | | | * **1** - indicates that the vehicle being used on this particular trip can accommodate at least one rider in a wheelchair | From 11edd314baeb49871a7fe45bd6e4fdad4e251c55 Mon Sep 17 00:00:00 2001 From: Aaron Antrim Date: Sat, 21 Jan 2017 17:47:23 -0800 Subject: [PATCH 7/8] remove "The block_id must be referenced by two or more trips in trips.txt." --- gtfs/spec/en/reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md index 78c312185..0fb1230fa 100644 --- a/gtfs/spec/en/reference.md +++ b/gtfs/spec/en/reference.md @@ -166,7 +166,7 @@ File: **Required** | | | * `trip_id,...,trip_headsign,direction_id` | | | | * `1234,...,to Airport,0` | | | | * `1505,...,to Downtown,1` | -| block_id | Optional | The **block_id** field identifies the block to which the trip belongs. A block consists of a single trip or or many sequential trips made using the same vehicle, defined by shared service day and block_id. The block_id must be referenced by two or more trips in trips.txt. A block_id can have trips with different service days, making distinct blocks. (See [example below](#example-showing-blocks-and-service-day)) | +| block_id | Optional | The **block_id** field identifies the block to which the trip belongs. A block consists of a single trip or or many sequential trips made using the same vehicle, defined by shared service day and block_id. A block_id can have trips with different service days, making distinct blocks. (See [example below](#example-showing-blocks-and-service-day)) | | shape_id | Optional | The **shape_id** field contains an ID that defines a shape for the trip. This value is referenced from the [shapes.txt](#shapestxt) file. The shapes.txt file allows you to define how a line should be drawn on the map to represent a trip. | | wheelchair_accessible | Optional | * **0** (or empty) - indicates that there is no accessibility information for the trip | | | | * **1** - indicates that the vehicle being used on this particular trip can accommodate at least one rider in a wheelchair | From f64f770d66463a7caa21276930137554e0390846 Mon Sep 17 00:00:00 2001 From: Aaron Antrim Date: Thu, 26 Jan 2017 18:45:17 -0800 Subject: [PATCH 8/8] correction (remove duplicate "or") thanks @barbeau ! --- gtfs/spec/en/reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md index 0fb1230fa..184e28b49 100644 --- a/gtfs/spec/en/reference.md +++ b/gtfs/spec/en/reference.md @@ -166,7 +166,7 @@ File: **Required** | | | * `trip_id,...,trip_headsign,direction_id` | | | | * `1234,...,to Airport,0` | | | | * `1505,...,to Downtown,1` | -| block_id | Optional | The **block_id** field identifies the block to which the trip belongs. A block consists of a single trip or or many sequential trips made using the same vehicle, defined by shared service day and block_id. A block_id can have trips with different service days, making distinct blocks. (See [example below](#example-showing-blocks-and-service-day)) | +| block_id | Optional | The **block_id** field identifies the block to which the trip belongs. A block consists of a single trip or many sequential trips made using the same vehicle, defined by shared service day and block_id. A block_id can have trips with different service days, making distinct blocks. (See [example below](#example-showing-blocks-and-service-day)) | | shape_id | Optional | The **shape_id** field contains an ID that defines a shape for the trip. This value is referenced from the [shapes.txt](#shapestxt) file. The shapes.txt file allows you to define how a line should be drawn on the map to represent a trip. | | wheelchair_accessible | Optional | * **0** (or empty) - indicates that there is no accessibility information for the trip | | | | * **1** - indicates that the vehicle being used on this particular trip can accommodate at least one rider in a wheelchair |