Right Track Core Library

node module: right-track-core
GitHub repo: right-track/right-track-core

This Node module contains the core data classes and functionality of the Right Track Library. It can query a Right Track Database (a combination of GTFS data and additional custom data) that is built using the right-track-db-build module and create data classes representing the queried data.

This module is a requirement for the right-track-server, the right-track-online website and the planned upcoming right track mobile apps.

Agency specific functionality (such as real-time feed information) is added through the various right-track-agency-{id} modules.

Features and Functionality

This project is still very much a work in progress and is being actively developed. Functionality may be added and/or removed without notice.

Currently, the module supports the following features:

GTFS Data Models:
- Agency
- Route
- Service (from gtfs calendar.txt)
- ServiceException (from gtfs calendar_dates.txt)
- Stop
- StopTime
- Trip
Right Track Data Models:
- About (database metadata)
- Favorite (Class for User favorites - station and trips)
- Holiday (service information for holidays)
- Link (links for additional transit resources)
Right Track Database queries
Trip Search Classes and Query Functions
- Trip Search
- Trip Search Result
- GTFS schedule search functions (including transfers)
General purpose utility functions

Documentation

Full documentation can be found in the /doc/ directory in this repository or online at https://docs.righttrack.io/right-track-core

Module Structure

This module is essentially a bundled group of sub-modules representing each of the supported data types. To import the entire collection, require the right-track-core module. The returned Object will be a collection of all of the sub-modules that follows a package-like structure mirroring the module paths.

For example, to get the GTFS Agency class from the collection:

const core = require('right-track-core');
const Agency = core.gtfs.Agency;

Sub-modules can also be loaded individually by requiring the specific module:

const Agency = require('right-track-core/modules/gtfs/Agency');

Refer to the Documentation for the complete module structure.

Usage

Create a GTFS data class

const core = require('right-track-core');
const Agency = core.gtfs.Agency;
const Route = core.gtfs.Route;

// Create a new Agency for Metro North Railroad
let metroNorth = new Agency('Metro North Railroad', 'https://mta.info/mnr', 'America/New_York', 'mnr');
console.log(metroNorth);
// Agency {
//   name: 'Metro North Railroad',
//   url: 'https://mta.info/mnr',
//   timezone: 'America/New_York',
//   id: 'mnr' 
// }


// Create a new Route for the New Haven Line
let newHavenLine = new Route('nh', 'new haven', 'New Haven Line', Route.ROUTE_TYPE_RAIL, metroNorth, 'ff0000', '000000');
console.log(newHavenLine);
// Route {
//   id: 'nh',
//   shortName: 'new haven',
//   longName: 'New Haven Line',
//   type: 2,
//   agency:
//     Agency {
//       name: 'Metro North Railroad',
//       url: 'https://mta.info/mnr',
//       timezone: 'America/New_York',
//       id: 'mnr' 
//     },
//   color: 'ff0000',
//   textColor: '000000' 
// }

Query a Right Track Database

The query functions of this module query a specific type of SQLite database (Right Track Database) that contains the GTFS data and additional Right Track data. In order to make a query, there are two additional dependencies:

A RightTrackDB Class Object. This acts as a SQLite wrapper that provides the actual SQLite functionality. The right-track-db-sqlite3 module provides this functionality using the node-sqlite3 module and should work in any environment supported by node-sqlite3.
A Right Track Agency implementation. This provides the agency-specific configuration properties as well as the agency's Right Track Database (or the location of the database).

The following example queries the information for a Stop with id 110 from a Right Track Database for Metro North Railroad.

const core = require('right-track-core');
const RightTrackDB = require('right-track-db-sqlite3');
const MNR = require('right-track-agency-mnr');

// Create the Right Track DB using the MNR Right Track Agency
let db = new RightTrackDB(MNR);

// Query the database for the stop with ID == '110'
core.query.stops.getStop(db, '110', function(err, stop) {
  console.log(stop);
});

// Returns Stop:
// Stop {
//   id: '110',
//   name: 'Larchmont',
//   lat: 40.933394,
//   lon: -73.759792,
//   url: 'http://as0.mta.info/mnr/stations/station_detail.cfm?key=208',
//   wheelchairBoarding: 1,
//   statusID: '110',
//   transferWeight: 1171 
// }

Schedule Trip Search

The search functions of this module can query the GTFS schedule to build a set of Trip Search Results that connect the Origin and Destination Stops together with either a direct Trip or one that includes one or more transfers.

The Search parameters can be customized with the following options:

Option Name	Default Value	Description
`allowTransfers`	`true`	Enable to allow a Trip Search Result to include one or more transfers to a different Trip at a Transfer Stop.
`allowChangeInDirection`	`true`	Enable to allow transfers to a Trip running in the opposite direction.
`preDepartureHours`	`3`	The number of hours before the specified departure date/time to include in the results.
`postDepartureHours`	`6`	The number of hours after the specified departure date/time to include in the results.
`maxLayoverMins`	`30`	The maximum number of minutes to layover at a transfer Stop.
`minLayoverMins`	`0`	The minimum number of minutes to layover at a transfer Stop.
`maxTransfers`	`2`	The maximum number of transfers allowed per Trip Search Result.

Trip Search Example

The following example searches the GTFS schedule for Long Island Rail Road between the Patchogue and Atlantic Terminal Stops with a desired departure of 1:30 PM on Jan 16, 2018.

The default options were changed to allow search results up to 8 hours after the desired departure.

const core = require('right-track-core');
const RightTrackDB = require('right-track-db-sqlite3');
const LIRR = require('right-track-agency-lirr');

const DateTime = core.utils.DateTime;
const TripSearch = core.search.TripSearch;

// Set up a Right Track DB for LIRR
let db = new RightTrackDB(LIRR);

// Get the Origin and Destination Stops by their IDs
core.query.stops.getStop(db, '124', function(err, origin) {
  core.query.stops.getStop(db, '12', function(err, destination) {

    // Set Search Paramters
    let dt = DateTime.create("1:30 PM", 20180116);
    let options = {
      postDepartureHours: 8
    };

    // Set up the Trip Search
    let search = new TripSearch(origin, destination, dt, options);

    // Perform the Trip Search
    search.search(db, function(err, results) {

      // Print the Results
      console.log("==== TRIP SEARCH RESULTS: ===");
      console.log("ORIGIN: " + origin.name);
      console.log("DESTINATION: " + destination.name);
      console.log("DEPARTURE: " + dt.toString());
      console.log("RESULTS: " + results.length);
      console.log("=============================");

      // Parse each Result
      for ( let i = 0; i < results.length; i++ ) {
        let result = results[i];

        console.log(result.origin.stop.name + " @ " + result.origin.departure.getTimeReadable() + " --> " + result.destination.stop.name + " @ " + result.destination.arrival.getTimeReadable());

        // Parse segments when a transfer is required
        if ( result.length > 1 ) {
          let segments = result.segments;
          for ( let j = 0; j < segments.length; j++ ) {
            let segment = segments[j];
            console.log("  " + segment.enter.stop.name + " @ " + segment.enter.departure.getTimeReadable() + " --> " + segment.exit.stop.name + " @ " + segment.exit.arrival.getTimeReadable());
          }
        }

      }

    });

  });
});

The resulting output, which prints the Trip Search Results to the console:

==== TRIP SEARCH RESULTS: ===
ORIGIN: Patchogue
DESTINATION: Atlantic Terminal
DEPARTURE: 2018-01-16 @ 13:30:00
RESULTS: 9
=============================
Patchogue @ 11:25 AM --> Atlantic Terminal @ 1:33 PM
  Patchogue @ 11:25 AM --> Babylon @ 11:55 AM
  Babylon @ 12:00 PM --> Jamaica @ 12:48 PM
  Jamaica @ 1:13 PM --> Atlantic Terminal @ 1:33 PM
Patchogue @ 1:07 PM --> Atlantic Terminal @ 2:33 PM
  Patchogue @ 1:07 PM --> Jamaica @ 2:12 PM
  Jamaica @ 2:13 PM --> Atlantic Terminal @ 2:33 PM
Patchogue @ 1:25 PM --> Atlantic Terminal @ 3:33 PM
  Patchogue @ 1:25 PM --> Babylon @ 1:55 PM
  Babylon @ 2:00 PM --> Jamaica @ 2:48 PM
  Jamaica @ 3:13 PM --> Atlantic Terminal @ 3:33 PM
Patchogue @ 2:30 PM --> Atlantic Terminal @ 4:03 PM
  Patchogue @ 2:30 PM --> Jamaica @ 3:36 PM
  Jamaica @ 3:43 PM --> Atlantic Terminal @ 4:03 PM
Patchogue @ 3:32 PM --> Atlantic Terminal @ 5:10 PM
  Patchogue @ 3:32 PM --> Babylon @ 4:02 PM
  Babylon @ 4:06 PM --> Jamaica @ 4:44 PM
  Jamaica @ 4:52 PM --> Atlantic Terminal @ 5:10 PM
Patchogue @ 4:43 PM --> Atlantic Terminal @ 6:23 PM
  Patchogue @ 4:43 PM --> Jamaica @ 5:50 PM
  Jamaica @ 6:05 PM --> Atlantic Terminal @ 6:23 PM
Patchogue @ 5:26 PM --> Atlantic Terminal @ 7:10 PM
  Patchogue @ 5:26 PM --> Babylon @ 5:58 PM
  Babylon @ 6:03 PM --> Jamaica @ 6:40 PM
  Jamaica @ 6:52 PM --> Atlantic Terminal @ 7:10 PM
Patchogue @ 6:30 PM --> Atlantic Terminal @ 8:21 PM
  Patchogue @ 6:30 PM --> Babylon @ 7:03 PM
  Babylon @ 7:09 PM --> Jamaica @ 8:01 PM
  Jamaica @ 8:03 PM --> Atlantic Terminal @ 8:21 PM
Patchogue @ 7:39 PM --> Atlantic Terminal @ 9:53 PM
  Patchogue @ 7:39 PM --> Babylon @ 8:09 PM
  Babylon @ 8:13 PM --> Jamaica @ 9:04 PM
  Jamaica @ 9:33 PM --> Atlantic Terminal @ 9:53 PM

right-track-core

Right Track Core Library

Features and Functionality

Documentation

Module Structure

Usage

Create a GTFS data class

Query a Right Track Database

Schedule Trip Search

Trip Search Example

Dependencies (3)

Dev Dependencies (2)

Package Sidebar

Install

Repository

Homepage

Weekly Downloads

Version

License

Unpacked Size

Total Files

Last publish

Collaborators

right-track-core

Right Track Core Library

Features and Functionality

Documentation

Module Structure

Usage

Create a GTFS data class

Query a Right Track Database

Schedule Trip Search

Trip Search Example

Dependencies (3)

Dev Dependencies (2)

Package Sidebar

Install

Repository

Homepage

DownloadsWeekly Downloads

Version

License

Unpacked Size

Total Files

Last publish

Collaborators

Weekly Downloads