gtfs-to-html 2.6.12 → 2.7.1

package/CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.7.1] - 2024-08-13
+
+### Fixed
+- Handle MultiLineString geojson
+
+### Updated
+- Warning about invalid timetable start/end dates
+- Deduplicate timetablePage agency_ids
+- Don't show drop_off_type info for first stoptime of a trip, don't show pickup_type info for last stoptime of a trip.
+- Dependency updates
+
+## [2.7.0] - 2024-07-27
+
+### Fixed
+- Fixes for horizontal orientation labels
+
+### Updated
+- Better date format documentation
+- Better default for timetable_page_label
+- Larger map on desktop
+- Improved button styles
+- Serve static assets from templatePath
+- Move static js and css to views/default
+- Dependency updates
+
 ## [2.6.12] - 2024-07-26
 
 ### Updated

package/app/index.js

@@ -4,9 +4,9 @@ import { readFileSync } from 'node:fs';
 import { map } from 'lodash-es';
 import yargs from 'yargs';
 import { openDb } from 'gtfs';
-
 import express from 'express';
 import logger from 'morgan';
+import untildify from 'untildify';
 
 import { formatTimetableLabel } from '../lib/formatters.js';
 import {
@@ -44,7 +44,7 @@ try {
 } catch (error) {
   if (error instanceof Error && error.code === 'SQLITE_CANTOPEN') {
     config.logError(
-      `Unable to open sqlite database "${config.sqlitePath}" defined as \`sqlitePath\` config.json. Ensure the parent directory exists or remove \`sqlitePath\` from config.json.`
+      `Unable to open sqlite database "${config.sqlitePath}" defined as \`sqlitePath\` config.json. Ensure the parent directory exists or remove \`sqlitePath\` from config.json.`,
     );
   }
 
@@ -59,14 +59,14 @@ router.get('/', async (request, response, next) => {
     const timetablePages = [];
     const timetablePageIds = map(
       getTimetablePagesForAgency(config),
-      'timetable_page_id'
+      'timetable_page_id',
     );
 
     for (const timetablePageId of timetablePageIds) {
       // eslint-disable-next-line no-await-in-loop
       const timetablePage = await getFormattedTimetablePage(
         timetablePageId,
-        config
+        config,
       );
 
       if (
@@ -74,7 +74,7 @@ router.get('/', async (request, response, next) => {
         timetablePage.consolidatedTimetables.length === 0
       ) {
         console.error(
-          `No timetables found for timetable_page_id=${timetablePage.timetable_page_id}`
+          `No timetables found for timetable_page_id=${timetablePage.timetable_page_id}`,
         );
       }
 
@@ -107,7 +107,7 @@ router.get('/timetables/:timetablePageId', async (request, response, next) => {
   try {
     const timetablePage = await getFormattedTimetablePage(
       timetablePageId,
-      config
+      config,
     );
 
     const html = await generateTimetableHTML(timetablePage, config);
@@ -121,9 +121,14 @@ app.set('views', path.join(fileURLToPath(import.meta.url), '../../views'));
 app.set('view engine', 'pug');
 
 app.use(logger('dev'));
-app.use(
-  express.static(path.join(fileURLToPath(import.meta.url), '../../public'))
-);
+
+// Serve static assets
+const staticAssetPath =
+  config.templatePath === undefined
+    ? path.join(fileURLToPath(import.meta.url), '../../views/default')
+    : untildify(config.templatePath);
+
+app.use(express.static(staticAssetPath));
 
 app.use('/', router);
 app.set('port', process.env.PORT || 3000);

package/lib/file-utils.js

@@ -66,18 +66,12 @@ function getTemplatePath(templateFileName, config) {
     fullTemplateFileName += '_full';
   }
 
-  if (config.templatePath !== undefined) {
-    return path.join(
-      untildify(config.templatePath),
-      `${fullTemplateFileName}.pug`,
-    );
-  }
+  const templatePath =
+    config.templatePath === undefined
+      ? path.join(fileURLToPath(import.meta.url), '../../views/default')
+      : untildify(config.templatePath);
 
-  return path.join(
-    fileURLToPath(import.meta.url),
-    '../../views/default',
-    `${fullTemplateFileName}.pug`,
-  );
+  return path.join(templatePath, `${fullTemplateFileName}.pug`);
 }
 
 /*
@@ -101,11 +95,12 @@ export async function prepDirectory(exportPath) {
 /*
  * Copy needed CSS and JS to export path.
  */
-export function copyStaticAssets(exportPath) {
-  const staticAssetPath = path.join(
-    fileURLToPath(import.meta.url),
-    '../../public',
-  );
+export function copyStaticAssets(config, exportPath) {
+  const staticAssetPath =
+    config.templatePath === undefined
+      ? path.join(fileURLToPath(import.meta.url), '../../views/default')
+      : untildify(config.templatePath);
+
   copydir.sync(path.join(staticAssetPath, 'css'), path.join(exportPath, 'css'));
   copydir.sync(path.join(staticAssetPath, 'js'), path.join(exportPath, 'js'));
 }

package/lib/formatters.js

@@ -247,20 +247,6 @@ export function formatTrip(trip, timetable, calendars, config) {
   return trip;
 }
 
-/*
- * Format a route name.
- */
-export function formatRouteName(route) {
-  let routeName = 'Route ';
-  if (!isNullOrEmpty(route.route_short_name)) {
-    routeName += route.route_short_name;
-  } else if (!isNullOrEmpty(route.route_long_name)) {
-    routeName += route.route_long_name;
-  }
-
-  return routeName;
-}
-
 /*
  * Format a frequency.
  */
@@ -327,6 +313,16 @@ export function formatStops(timetable, config) {
         continue;
       }
 
+      // If first stoptime of the trip, remove drop_off_type information
+      if (idx === 0) {
+        stoptime.drop_off_type = 0;
+      }
+
+      // If last stoptime of the trip, remove pickup_type information
+      if (idx === trip.stoptimes.length - 1) {
+        stoptime.pickup_type = 0;
+      }
+
       // If showing arrival and departure times as separate columns/rows, add
       // trip to the departure stop, unless it is the last stoptime of the trip.
       if (stop.type === 'arrival' && idx < trip.stoptimes.length - 1) {
@@ -384,7 +380,7 @@ export function formatStopName(stop) {
 }
 
 /*
- * Formats trip "Contines from".
+ * Formats trip "Continues from".
  */
 export function formatTripContinuesFrom(trip) {
   return trip.continues_from_route
@@ -393,7 +389,7 @@ export function formatTripContinuesFrom(trip) {
 }
 
 /*
- * Formats trip "Contines as".
+ * Formats trip "Continues as".
  */
 export function formatTripContinuesAs(trip) {
   return trip.continues_as_route
@@ -500,33 +496,6 @@ export function formatTimetableLabel(timetable) {
   return timetableLabel;
 }
 
-/*
- * Format a label for a timetable page.
- */
-export function formatTimetablePageLabel(timetablePage) {
-  if (!isNullOrEmpty(timetablePage.timetable_page_label)) {
-    return timetablePage.timetable_page_label;
-  }
-
-  if (
-    timetablePage.consolidatedTimetables &&
-    timetablePage.consolidatedTimetables.length > 0
-  ) {
-    // Use route names from all timetables
-    const routes = uniqBy(
-      flatMap(
-        timetablePage.consolidatedTimetables,
-        (timetable) => timetable.routes,
-      ),
-      'route_id',
-    );
-
-    return routes.map((route) => formatRouteName(route)).join(' and ');
-  }
-
-  return 'Unknown';
-}
-
 /*
  * Merge timetables with same `timetable_id`.
  */

package/lib/geojson-utils.js

@@ -1,7 +1,7 @@
 import { getShapesAsGeoJSON, getStopsAsGeoJSON } from 'gtfs';
 import { flatMap } from 'lodash-es';
 import simplify from '@turf/simplify';
-import { featureCollection } from '@turf/helpers';
+import { featureCollection, round } from '@turf/helpers';
 
 /*
  * Merge any number of geojson objects into one. Only works for `FeatureCollection`.
@@ -9,14 +9,6 @@ import { featureCollection } from '@turf/helpers';
 const mergeGeojson = (...geojsons) =>
   featureCollection(flatMap(geojsons, (geojson) => geojson.features));
 
-/*
- * Truncate a coordinate to a specific number of decimal places.
- */
-const truncateCoordinate = (coordinate, precision) => [
-  Math.round(coordinate[0] * 10 ** precision) / 10 ** precision,
-  Math.round(coordinate[1] * 10 ** precision) / 10 ** precision,
-];
-
 /*
  * Truncate a geojson coordinates to a specific number of decimal places.
  */
@@ -24,14 +16,24 @@ const truncateGeoJSONDecimals = (geojson, config) => {
   for (const feature of geojson.features) {
     if (feature.geometry.coordinates) {
       if (feature.geometry.type.toLowerCase() === 'point') {
-        feature.geometry.coordinates = truncateCoordinate(
-          feature.geometry.coordinates,
-          config.coordinatePrecision
+        feature.geometry.coordinates = feature.geometry.coordinates.map(
+          (number) => round(number, config.coordinatePrecision),
         );
       } else if (feature.geometry.type.toLowerCase() === 'linestring') {
         feature.geometry.coordinates = feature.geometry.coordinates.map(
           (coordinate) =>
-            truncateCoordinate(coordinate, config.coordinatePrecision)
+            coordinate.map((number) =>
+              round(number, config.coordinatePrecision),
+            ),
+        );
+      } else if (feature.geometry.type.toLowerCase() === 'multilinestring') {
+        feature.geometry.coordinates = feature.geometry.coordinates.map(
+          (linestring) =>
+            linestring.map((coordinate) =>
+              coordinate.map((number) =>
+                round(number, config.coordinatePrecision),
+              ),
+            ),
         );
       }
     }
@@ -67,7 +69,7 @@ export function getTimetableGeoJSON(timetable, config) {
       route_id: routeId,
       direction_id: timetable.direction_id,
       trip_id: timetable.orderedTrips.map((trip) => trip.trip_id),
-    })
+    }),
   );
 
   const stopsGeojsons = timetable.route_ids.map((routeId) =>
@@ -75,7 +77,7 @@ export function getTimetableGeoJSON(timetable, config) {
       route_id: routeId,
       direction_id: timetable.direction_id,
       trip_id: timetable.orderedTrips.map((trip) => trip.trip_id),
-    })
+    }),
   );
 
   const geojson = mergeGeojson(...shapesGeojsons, ...stopsGeojsons);

package/lib/gtfs-to-html.js

@@ -89,7 +89,7 @@ const gtfsToHtml = async (initialConfig) => {
   await prepDirectory(exportPath);
 
   if (config.noHead !== true && ['html', 'pdf'].includes(config.outputFormat)) {
-    copyStaticAssets(exportPath);
+    copyStaticAssets(config, exportPath);
   }
 
   const bar = progressBar(
@@ -134,7 +134,7 @@ const gtfsToHtml = async (initialConfig) => {
       );
 
       if (config.outputFormat === 'csv') {
-        for (const timetable of timetablePage.timetables) {
+        for (const timetable of timetablePage.consolidatedTimetables) {
           const csv = await generateTimetableCSV(timetable);
           const csvPath = path.join(
             exportPath,

package/lib/utils.js

@@ -58,7 +58,6 @@ import {
   formatStops,
   formatTimetableId,
   formatTimetableLabel,
-  formatTimetablePageLabel,
   formatTrip,
   formatTripContinuesAs,
   formatTripContinuesFrom,
@@ -824,10 +823,24 @@ const getCalendarsFromTimetable = (timetable) => {
   const whereClauses = [];
 
   if (timetable.end_date) {
+    // Validate timetable.end_date is a valid date
+    if (!moment(timetable.end_date, 'YYYYMMDD', true).isValid()) {
+      throw new Error(
+        `Invalid end_date=${timetable.end_date} for timetable_id=${timetable.timetable_id}`,
+      );
+    }
+
     whereClauses.push(`start_date <= ${sqlString.escape(timetable.end_date)}`);
   }
 
   if (timetable.start_date) {
+    // Validate timetable.start_date is a valid date
+    if (!moment(timetable.start_date, 'YYYYMMDD', true).isValid()) {
+      throw new Error(
+        `Invalid start_date=${timetable.start_date} for timetable_id=${timetable.timetable_id}`,
+      );
+    }
+
     whereClauses.push(`end_date >= ${sqlString.escape(timetable.start_date)}`);
   }
 
@@ -1505,7 +1518,6 @@ export function getFormattedTimetablePage(timetablePageId, config) {
     timetablePage.timetables,
     config,
   );
-  timetablePage.timetable_page_label = formatTimetablePageLabel(timetablePage);
   timetablePage.dayList = formatDays(
     getDaysFromCalendars(timetablePage.consolidatedTimetables),
     config,
@@ -1521,11 +1533,11 @@ export function getFormattedTimetablePage(timetablePageId, config) {
     {
       route_id: timetablePage.route_ids,
     },
-    ['route_color', 'route_text_color', 'agency_id'],
+    ['agency_id'],
   );
 
-  timetablePage.agency_ids = compact(
-    timetableRoutes.map((route) => route.agency_id),
+  timetablePage.agency_ids = uniq(
+    compact(timetableRoutes.map((route) => route.agency_id)),
   );
 
   // Set default filename.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gtfs-to-html",
-  "version": "2.6.12",
+  "version": "2.7.1",
   "private": false,
   "description": "Build human readable transit timetables as HTML, PDF or CSV from GTFS",
   "keywords": [
@@ -35,23 +35,23 @@
     "start": "node ./app"
   },
   "dependencies": {
-    "@turf/helpers": "^7.0.0",
-    "@turf/simplify": "^7.0.0",
+    "@turf/helpers": "^7.1.0",
+    "@turf/simplify": "^7.1.0",
     "archiver": "^7.0.1",
     "cli-table": "^0.3.11",
     "copy-dir": "^1.3.0",
-    "csv-stringify": "^6.5.0",
+    "csv-stringify": "^6.5.1",
     "express": "^4.19.2",
-    "gtfs": "^4.13.1",
+    "gtfs": "^4.13.4",
     "insane": "^2.6.2",
     "js-beautify": "^1.15.1",
     "lodash-es": "^4.17.21",
-    "marked": "^13.0.2",
+    "marked": "^14.0.0",
     "moment": "^2.30.1",
     "morgan": "^1.10.0",
     "pretty-error": "^4.0.0",
     "pug": "^3.0.3",
-    "puppeteer": "^22.14.0",
+    "puppeteer": "^23.0.2",
     "sanitize-filename": "^1.6.3",
     "sqlstring": "^2.3.3",
     "timer-machine": "^1.1.0",
@@ -61,8 +61,8 @@
     "yoctocolors": "^2.1.1"
   },
   "devDependencies": {
-    "husky": "^9.1.3",
-    "lint-staged": "^15.2.7",
+    "husky": "^9.1.4",
+    "lint-staged": "^15.2.9",
     "prettier": "^3.3.3"
   },
   "engines": {

package/{public → views/default}/css/overview_styles.css

@@ -117,7 +117,7 @@ a:hover {
 
 .timetable-overview .btn-blue {
   color: rgb(255 255 255);
-  padding: 0.75rem 2rem;
+  padding: 0.75rem 1.5rem;
   background-color: rgb(37 99 235);
   border-radius: 0.375rem;
   justify-content: center;

package/{public → views/default}/css/timetable_styles.css

@@ -180,7 +180,7 @@ a:hover {
 
 .timetable-page .btn-blue {
   color: rgb(255 255 255);
-  padding: 0.75rem 2rem;
+  padding: 0.75rem 1.5rem;
   background-color: rgb(37 99 235);
   border-radius: 0.375rem;
   justify-content: center;
@@ -197,7 +197,7 @@ a:hover {
 
 .timetable-page .btn-gray {
   color: rgb(75 85 99);
-  padding: 0.75rem 2rem;
+  padding: 0.75rem 1.5rem;
   background-color: rgb(209 213 219);
   border-radius: 0.375rem;
   justify-content: center;
@@ -221,7 +221,7 @@ a:hover {
   margin-bottom: 2.5rem;
 }
 
-.timetable-page .timetable .stop-header {
+.timetable-page .timetable .table-vertical .stop-header {
   text-align: center;
 }
 
@@ -354,7 +354,13 @@ a:hover {
 }
 
 .timetable-page .table-horizontal tbody tr th.stop-name-container {
-  min-width: 250px;
+  min-width: 175px;
+}
+
+@media screen and (min-width: 768px) {
+  .timetable-page .table-horizontal tbody tr th.stop-name-container {
+    min-width: 250px;
+  }
 }
 
 .timetable-page .table-hourly {
@@ -392,18 +398,18 @@ a:hover {
   flex-shrink: 0;
 }
 
-@media screen and (max-width: 767px) {
-  .timetable-page .table-horizontal tbody tr th.stop-name-container {
-    min-width: 175px;
-  }
-}
-
 /* Map Styles */
 
 .timetable-page .map {
   min-height: 350px;
 }
 
+@media screen and (min-width: 768px) {
+  .timetable-page .map {
+    min-height: 450px;
+  }
+}
+
 .timetable-page .map .mapboxgl-popup-content .popup-title {
   margin: 0 20px 5px 0;
   font-size: 1rem;

package/views/default/formatting_functions.pug

@@ -1,11 +1,11 @@
 -
   function getTimetableSummary(timetable) {
     let summary = `This table shows schedules for a selection of key stops on the route for ${timetable.timetable_label} ${timetable.dayList}.`;
-    if (timetable.orientation = 'vertical') {
+    if (timetable.orientation === 'vertical') {
       summary += ' Stops and their schedule times are listed in the columns.';
-    } else if (timetable.orientation = 'horizontal') {
+    } else if (timetable.orientation === 'horizontal') {
       summary += ' Schedule times are listed in rows, starting with the stop name in the first cell of the row.';
-    } else if (timetable.orientation = 'hourly') {
+    } else if (timetable.orientation === 'hourly') {
       summary += ' Schedule times are listed in rows, starting with the stop name in the first cell of the row and the minutes after the hour in the second row.';
     }
     return summary;
@@ -68,12 +68,7 @@
     }
 
     for (const feature of timetable.geojson.features) {
-      if (feature.geometry.type === 'LineString') {
-        feature.properties = {
-          route_color: feature.properties.route_color
-        }
-        minifiedGeojson.features.push(feature)
-      } else if (feature.geometry.type === 'Point') {
+      if (feature.geometry.type.toLowerCase() === 'point') {
         for (const route of feature.properties.routes) {
           routes[route.route_id] = route
         }
@@ -81,6 +76,16 @@
         feature.properties.routes = feature.properties.routes.map(route => route.route_id)
 
         minifiedGeojson.features.push(_.omit(feature, ['location_type', 'tts_stop_name']))
+      } else if (feature.geometry.type.toLowerCase() === 'linestring') {
+        feature.properties = {
+          route_color: feature.properties.route_color
+        }
+        minifiedGeojson.features.push(feature)
+      } else if (feature.geometry.type.toLowerCase() === 'multilinestring') {
+        feature.properties = {
+          route_color: feature.properties.route_color
+        }
+        minifiedGeojson.features.push(feature)
       }
     }
     
@@ -98,3 +103,11 @@
 
     return ''
   }
+
+  function formatRouteName(route) {
+    if (isNullOrEmpty(route.route_long_name)) {
+      return `Route ${route.route_short_name}`;
+    }
+
+    return route.route_long_name;
+  }

package/{public → views/default}/js/system-map.js

@@ -96,12 +96,18 @@ function formatStopPopup(feature) {
 function getBounds(geojson) {
   const bounds = new mapboxgl.LngLatBounds();
   for (const feature of geojson.features) {
-    if (feature.geometry.type === 'Point') {
+    if (feature.geometry.type.toLowerCase() === 'point') {
       bounds.extend(feature.geometry.coordinates);
-    } else if (feature.geometry.type === 'LineString') {
+    } else if (feature.geometry.type.toLowerCase() === 'linestring') {
       for (const coordinate of feature.geometry.coordinates) {
         bounds.extend(coordinate);
       }
+    } else if (feature.geometry.type.toLowerCase() === 'multilinestring') {
+      for (const linestring of feature.geometry.coordinates) {
+        for (const coordinate of linestring) {
+          bounds.extend(coordinate);
+        }
+      }
     }
   }
 

package/{public → views/default}/js/timetable-map.js

@@ -84,12 +84,18 @@ function formatStopPopup(feature, routes) {
 function getBounds(geojson) {
   const bounds = new mapboxgl.LngLatBounds();
   for (const feature of geojson.features) {
-    if (feature.geometry.type === 'Point') {
+    if (feature.geometry.type.toLowerCase() === 'point') {
       bounds.extend(feature.geometry.coordinates);
-    } else if (feature.geometry.type === 'LineString') {
+    } else if (feature.geometry.type.toLowerCase() === 'linestring') {
       for (const coordinate of feature.geometry.coordinates) {
         bounds.extend(coordinate);
       }
+    } else if (feature.geometry.type.toLowerCase() === 'multilinestring') {
+      for (const linestring of feature.geometry.coordinates) {
+        for (const coordinate of linestring) {
+          bounds.extend(coordinate);
+        }
+      }
     }
   }
 

package/views/default/overview.pug

@@ -10,10 +10,11 @@ include formatting_functions.pug
         each timetablePage in timetablePageGroup.timetablePages
           if config.allowEmptyTimetables || timetablePage.consolidatedTimetables.length > 0
             a.timetable-page-link(href=`${timetablePage.relativePath}` data-route-ids=`${timetablePage.route_ids ? timetablePage.route_ids.join(',') : ''}`)
-              each route in _.uniqBy(_.flatMap(timetablePage.consolidatedTimetables, timetable => timetable.routes), 'route_id')
+              - const timetableRouteList = _.uniqBy(_.flatMap(timetablePage.consolidatedTimetables, timetable => timetable.routes), 'route_id')
+              each route in timetableRouteList
                 .route-color-swatch-large(style=`background-color: ${formatRouteColor(route)}; color: ${formatRouteTextColor(route)};`)= route.route_short_name || ''
               div
-                .timetable-page-label= timetablePage.timetable_page_label
+                .timetable-page-label= timetablePage.timetable_page_label || timetableRouteList.map(route => formatRouteName(route)).join(' and ')
                 .badge-gray= timetablePage.dayList
     if config.showMap
       #system_map.overview-map

package/views/default/timetablepage.pug

@@ -3,10 +3,11 @@ include formatting_functions.pug
 <!-- Timetable generated on #{new Date().toISOString()} using GTFS-to-HTML version #{config.gtfsToHtmlVersion} -->
 .timetable-page(class=`menu-type-${config.menuType}`)
   if config.showRouteTitle
+    - const timetableRouteList = _.uniqBy(_.flatMap(timetablePage.consolidatedTimetables, timetable => timetable.routes), 'route_id')
     h1
-      each route in _.uniqBy(_.flatMap(timetablePage.consolidatedTimetables, timetable => timetable.routes), 'route_id')
+      each route in timetableRouteList
         .route-color-swatch-large(style=`background-color: ${formatRouteColor(route)}; color: ${formatRouteTextColor(route)};`)= route.route_short_name || ''
-      div= timetablePage.timetable_page_label
+      div= timetablePage.timetable_page_label || timetableRouteList.map(route => formatRouteName(route)).join(' and ')
     if config.effectiveDate
       .effective-date= `Effective ${config.effectiveDate}`
 

package/www/docs/configuration.md

@@ -235,7 +235,7 @@ API along with your API token.
 
 ### endDate
 
-\{String\} A date in ISO 8601 format to use to control which calendars are used for the timetables. Can be used with [startDate](#startdate) configuration options. Can be formatted as `YYYY-MM-DD` or `YYYYMMDD`.
+\{String\} A date in `YYYYMMDD` format to use to control which calendars are used for the timetables. Can be used with [startDate](#startdate) configuration options.
 
 Optional, defaults to using all available calendars if not defined. Overridden by `start_date` and `end_date` defined in `timetables.txt`.
 
@@ -519,7 +519,7 @@ The default trip-sorting algorithm is `common`.
 
 ### startDate
 
-\{String\} A date in ISO 8601 format to use to control which calendars are used for the timetables. Can be used with [endDate](#enddate) configuration options. Can be formatted as `YYYY-MM-DD` or `YYYYMMDD`.
+\{String\} A date in `YYYYMMDD` format to use to control which calendars are used for the timetables. Can be used with [endDate](#enddate) configuration options.
 
 Optional, defaults to using all available calendars if not defined. Overridden by `start_date` and `end_date` defined in `timetables.txt`.