Quick Start

One page summary of how to start using KNOT.

Requirements

KNOT requires a KNIME installation, and has been tested on KNIME 4.5.2. The default implementations of the Map Matcher and Trajectory Manipulator nodes require also a running instance of the Open Source Routing Machine (OSRM). These nodes have been tested with OSRM 5.24.

Download and install KNIME for your platform.
Download and install OSRM for your platform.

Install KNOT

At the moment, the easiest way to install KNOT is to copy the most recent JAR files for the KNOT nodes (which you can download here) in the dropins directory of your KNIME installation. On Windows systems, the path to the dropins directory should look like this: C:\Program Files\KNIME\dropins.

Start KNIME

That’s it! Next time you start KNIME, the KNOT nodes will be available in the node repository.

Run OSRM

If you plan to use the default implementation of the Trajectory Manipulator and/or the Map Matcher node, you need an OSRM instance running and ready to serve routing requests on the geographical area you intend to analyze.

Download relevant OpenStreetMap data

A number of alternatives exist to download OpenStreetMap (OSM) data (check the wiki). The most practical one is probably to use OSM extracts in PBF format provided by third parties such as GeoFabrik or BBBike.org.

💡

If the available extracts are too large with respect to the area on which you want to carry-on your analyses, it might be a good idea performance-wise to further restrict the extracts by using tools like OSMConvert.

Prepare OSRM

Before running OSRM, you need to extract a routing graph from the OSM data. To do so, run the following commands.

osrm-extract  --profile /path/to/osmr/profiles/car.lua \
              --with-osm-metadata yourdata.pbf

The above command creates .osmr named like the PBF you supplied as input. Then, issue the following:

osrm-contract yourdata.osrm

Start the OSRM server

After this preprocessing step, you’re ready to start the OSRM router server by running the following command:

osrm-routed --max-matching-size 3000 /path/to/osrm/data/yourdata.osrm

After that, you should see an output like the following and your OSRM instance should be up and running.

[info] starting up engines, v5.24.0
[info] Threads: 4
[info] IP address: 0.0.0.0
[info] IP port: 5000
[info] http 1.1 compression handled by zlib version 1.2.11
[info] Listening on: 0.0.0.0:5000
[info] running and waiting for requests

Quick Start

Requirements#

Install KNOT#

Start KNIME#

Run OSRM#

Download relevant OpenStreetMap data#

Prepare OSRM#

Start the OSRM server#