diff --git a/.nojekyll b/.nojekyll index 49302e7..c6cf56d 100644 --- a/.nojekyll +++ b/.nojekyll @@ -1 +1 @@ -7603784b \ No newline at end of file +944c6dcc \ No newline at end of file diff --git a/docs/tutorials/index.html b/docs/tutorials/index.html index 0fb62c0..a892beb 100644 --- a/docs/tutorials/index.html +++ b/docs/tutorials/index.html @@ -291,7 +291,7 @@

Requirements

Working With GTFS

Let’s import the necessary dependencies:

-
+
import datetime
 import os
 import pathlib
@@ -313,7 +313,7 @@ 

Working With GTFS

You may wish to manually download at least one GTFS feed and store somewhere in your file system. Alternatively you may programmatically download the data, as in the solution here.

-
+
BUS_URL = "<INSERT_SOME_URL_TO_BUS_GTFS>"
 RAIL_URL = "<INSERT_SOME_URL_TO_RAIL_GTFS>"
 
@@ -325,7 +325,7 @@ 

Working With GTFS

-
+
BUS_URL = "https://tsvc.pilote4.cityway.fr/api/Export/v1/GetExportedDataFile?ExportFormat=Gtfs&OperatorCode=RTM"
 RAIL_URL = "https://eu.ftp.opendatasoft.com/sncf/gtfs/export-intercites-gtfs-last.zip"
 # using tmp for tutorial but not necessary
@@ -337,13 +337,13 @@ 

Working With GTFS

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                  Dload  Upload   Total   Spent    Left  Speed
-  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0  1 4723k    1 92351    0     0  80773      0  0:00:59  0:00:01  0:00:58 80726100 4723k  100 4723k    0     0  2534k      0  0:00:01  0:00:01 --:--:-- 2534k
+  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0  0 4723k    0 35879    0     0  33209      0  0:02:25  0:00:01  0:02:24 33221100 4723k  100 4723k    0     0  2510k      0  0:00:01  0:00:01 --:--:-- 2511k
   % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                  Dload  Upload   Total   Spent    Left  Speed
-  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0100 86239  100 86239    0     0   192k      0 --:--:-- --:--:-- --:--:--  192k
+ 0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0 0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0100 86239 100 86239 0 0 196k 0 --:--:-- --:--:-- --:--:-- 196k
-
CompletedProcess(args=['curl', 'https://eu.ftp.opendatasoft.com/sncf/gtfs/export-intercites-gtfs-last.zip', '-o', '/tmp/tmpzz1v5nxn/intercity_rail_gtfs.zip'], returncode=0)
+
CompletedProcess(args=['curl', 'https://eu.ftp.opendatasoft.com/sncf/gtfs/export-intercites-gtfs-last.zip', '-o', '/tmp/tmp1tbkmx7n/intercity_rail_gtfs.zip'], returncode=0)
@@ -359,14 +359,14 @@

Working With GTFS

Instantiate a feed object by pointing the MultiGtfsInstance class at a path to the GTFS feed(s) that you have downloaded. Once you have successfully instantiated feed, inspect the correct attribute in order to confirm the number of separate feeds instances contained within it.

-
+
gtfs_pth = "<INSERT_PATH_TO_GTFS>"
 feed = MultiGtfsInstance(path=gtfs_pth)
 print(len(feed.<INSERT_CORRECT_ATTRIBUTE>))
-
+
gtfs_pth = pathlib.Path(tmp_path.name) # need to use pathlib for tmp_path
 feed = MultiGtfsInstance(path=gtfs_pth)
 print(f"There are {len(feed.instances)} feed instances")
@@ -385,14 +385,14 @@

Working With GTFS

By accessing the appropriate attribute, print out the first 5 stops of the first instance within the feed object.

-
+
feed.<INSERT_CORRECT_ATTR>[0].feed.stops.<INSERT_CORRECT_METHOD>(5)

These records will match the contents of the stops.txt file within the feed that you downloaded.


-
+
feed.instances[0].feed.stops.head(5)
@@ -487,7 +487,7 @@

Working With GTFS

Checking Validity

Transport routing operations require services that run upon a specified date. It is a useful sanity check to confirm that the dates that you expect to perform routing on exist within the GTFS feed. To do this, we can use the get_dates() method to print out the first and last date in the available date range, as below.

-
+
s0, e0 = feed.get_dates()
 print(f"Feed starts at: {s0}\nFeed ends at: {e0}")
@@ -506,7 +506,7 @@

Checking Validity

-
+
feed.get_dates(return_range=False)
['20240623',
@@ -619,10 +619,10 @@ 

Checking Validity

-
+
feed.is_valid(validation_kwargs={"far_stops": False})
-
  0%|          | 0/2 [00:00<?, ?it/s]Validating GTFS from path /tmp/tmpzz1v5nxn/intercity_rail_gtfs.zip:   0%|          | 0/2 [00:00<?, ?it/s]Validating GTFS from path /tmp/tmpzz1v5nxn/intercity_rail_gtfs.zip:  50%|█████     | 1/2 [00:00<00:00,  4.96it/s]Validating GTFS from path /tmp/tmpzz1v5nxn/rtm_gtfs.zip:  50%|█████     | 1/2 [00:00<00:00,  4.96it/s]           Validating GTFS from path /tmp/tmpzz1v5nxn/rtm_gtfs.zip: 100%|██████████| 2/2 [00:03<00:00,  2.12s/it]Validating GTFS from path /tmp/tmpzz1v5nxn/rtm_gtfs.zip: 100%|██████████| 2/2 [00:03<00:00,  1.83s/it]
+
  0%|          | 0/2 [00:00<?, ?it/s]Validating GTFS from path /tmp/tmp1tbkmx7n/intercity_rail_gtfs.zip:   0%|          | 0/2 [00:00<?, ?it/s]Validating GTFS from path /tmp/tmp1tbkmx7n/intercity_rail_gtfs.zip:  50%|█████     | 1/2 [00:00<00:00,  4.85it/s]Validating GTFS from path /tmp/tmp1tbkmx7n/rtm_gtfs.zip:  50%|█████     | 1/2 [00:00<00:00,  4.85it/s]           Validating GTFS from path /tmp/tmp1tbkmx7n/rtm_gtfs.zip: 100%|██████████| 2/2 [00:03<00:00,  2.06s/it]Validating GTFS from path /tmp/tmp1tbkmx7n/rtm_gtfs.zip: 100%|██████████| 2/2 [00:03<00:00,  1.78s/it]
@@ -646,7 +646,7 @@

Checking Validity

Unrecognized column feed_id feed_info [] -/tmp/tmpzz1v5nxn/intercity_rail_gtfs.zip +/tmp/tmp1tbkmx7n/intercity_rail_gtfs.zip 1 @@ -654,7 +654,7 @@

Checking Validity

Unrecognized column conv_rev feed_info [] -/tmp/tmpzz1v5nxn/intercity_rail_gtfs.zip +/tmp/tmp1tbkmx7n/intercity_rail_gtfs.zip 2 @@ -662,7 +662,7 @@

Checking Validity

Unrecognized column plan_rev feed_info [] -/tmp/tmpzz1v5nxn/intercity_rail_gtfs.zip +/tmp/tmp1tbkmx7n/intercity_rail_gtfs.zip 3 @@ -670,7 +670,7 @@

Checking Validity

Repeated pair (trip_id, departure_time) stop_times [236, 239, 241, 243, 245, 248, 251, 253, 254, ... -/tmp/tmpzz1v5nxn/rtm_gtfs.zip +/tmp/tmp1tbkmx7n/rtm_gtfs.zip 4 @@ -678,7 +678,7 @@

Checking Validity

Stop has no stop times stops [2135] -/tmp/tmpzz1v5nxn/rtm_gtfs.zip +/tmp/tmp1tbkmx7n/rtm_gtfs.zip @@ -704,12 +704,12 @@

Viz Stops

Inspect the MultiGtfsInstance docstring for the appropriate method.

-
+
feed.viz_...()
-
+
feed.viz_stops()
Make this Notebook Trusted to load map: File -> Trust Notebook
@@ -1051,10 +1051,10 @@

By Bounding Box

Pass the BBOX list in [xmin, ymin, xmax, ymax] order to the filter_to_bbox() method.

-
+
feed.filter_to_bbox(BBOX)
-
  0%|          | 0/2 [00:00<?, ?it/s]Filtering GTFS from path /tmp/tmpzz1v5nxn/intercity_rail_gtfs.zip:   0%|          | 0/2 [00:00<?, ?it/s]Filtering GTFS from path /tmp/tmpzz1v5nxn/rtm_gtfs.zip:   0%|          | 0/2 [00:00<?, ?it/s]           Filtering GTFS from path /tmp/tmpzz1v5nxn/rtm_gtfs.zip: 100%|██████████| 2/2 [00:00<00:00,  6.40it/s]Filtering GTFS from path /tmp/tmpzz1v5nxn/rtm_gtfs.zip: 100%|██████████| 2/2 [00:00<00:00,  6.39it/s]
+
  0%|          | 0/2 [00:00<?, ?it/s]Filtering GTFS from path /tmp/tmp1tbkmx7n/intercity_rail_gtfs.zip:   0%|          | 0/2 [00:00<?, ?it/s]Filtering GTFS from path /tmp/tmp1tbkmx7n/intercity_rail_gtfs.zip:  50%|█████     | 1/2 [00:00<00:00,  9.31it/s]Filtering GTFS from path /tmp/tmp1tbkmx7n/rtm_gtfs.zip:  50%|█████     | 1/2 [00:00<00:00,  9.31it/s]           Filtering GTFS from path /tmp/tmp1tbkmx7n/rtm_gtfs.zip: 100%|██████████| 2/2 [00:00<00:00,  5.10it/s]Filtering GTFS from path /tmp/tmp1tbkmx7n/rtm_gtfs.zip: 100%|██████████| 2/2 [00:00<00:00,  5.46it/s]
@@ -1062,7 +1062,7 @@

By Bounding Box

Notice that a progress bar confirms the number of successful filter operations performed depending on the number of separate GTFS zip files passed to MultiGtfsInstance.

Below I plot the filtered feed stop locations in relation to the bounding box used to restrict the feed’s extent.

-
+
imap = feed.viz_stops()
 poly_gdf.explore(m=imap)
@@ -1093,7 +1093,7 @@

By Bounding Box