mapzen/osm-history-tools-vm

Name: osm-history-tools-vm

Owner: Mapzen

Description: A Vagrant config for building VMs with some tools for manipulating OSM history built.

Created: 2015-09-24 18:35:03.0

Updated: 2016-06-24 18:52:48.0

Pushed: 2015-09-24 18:36:45.0

Homepage: null

Size: 112

Language: null

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

OSM History Tools VM

This repository contains a vagrant configuration file which will install some tools which are useful for dealing with OSM history dumps. The software packages currently built are:

• Osmium Tool, a “kitchen aid” with various different attachments for dealing with OSM data. (It slices! It dices!) One of the more important ones for dealing with history data is osmium time-filter for generating a planet file at a given point in time from a history dump.
• OSM History Splitter, a tool for generating history files containing all the elements which ever intersected a bounding box. This is extremely useful for cutting the data down into manageable chunks.

Requirements

You will need to download and install vagrant.

Installation

From the directory where you checked out the source for this project, you should be able to run something like:

ant up

Which might take a while to run, as it might have to download the base image, install a whole bunch of development tools, checkout various sources and build them. After it has completed you should be able to run:

ant ssh

Which will give you a login shell on the built VM.

Usage notes

Some binaries and libraries are installed on the VM in the /usr/local directory, so you sould either put this in one of your login configuration files, or run as appropriate before commands:

rt LD_LIBRARY_PATH=/usr/local/lib
rt PATH=$PATH:/usr/local/bin