Skip to content
This repository has been archived by the owner on Oct 5, 2024. It is now read-only.

Commit

Permalink
Merge branch 'master' of github.com:hotosm/underpass
Browse files Browse the repository at this point in the history
  • Loading branch information
emi420 committed Oct 23, 2023
2 parents 443b849 + e09ff21 commit 26cf694
Showing 1 changed file with 3 additions and 39 deletions.
42 changes: 3 additions & 39 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@

# Underpass

Underpass is a customizable **data engine** that processes **OpenStreetMap** data.
Underpass is a customizable **data engine** that processes **mapping** data.

It **updates a local copy of the OSM database** in near real-time, and provides customizable **statistics** and **validation** reports. It is designed to be **high performance** on modest hardware.

Expand All @@ -14,42 +14,11 @@ It **updates a local copy of the OSM database** in near real-time, and provides
We've deployed a rudimentary demo that keeps a database up-to-date for (some country),
rendering buildings and highlighting the ones identified as "un-squared":

[See the demo](https://underpass.hotosm.org/_renderer.html?_fixtureId=%7B%22path%22%3A%22src%2Ffixtures%2FDemo.fixture.jsx%22%7D)
[See The demo](https://underpass.hotosm.org)

## Getting started

If you want to get started really quick and easy, use the [Docker installation](https://github.com/hotosm/underpass/blob/master/docs/install-docker.md) and skip the next steps.

### 1. Install

Install the software on your platform of preference.

* [Linux](https://github.com/hotosm/underpass/blob/master/docs/install.md)
* MacOS (docs in progress ...)

### 2. Setup

Select the region you want to work with and bootstrap the database with data.

* [Using the bootstrap.sh script](https://github.com/hotosm/underpass/blob/master/docs/bootstrapsh.md)

### 3. Run

For keeping the database up-to-date, you must run underpass:

`./underpass -t $(date +%Y-%m-%dT%H:%M:%S -d "2 days ago")'`

On MacOS, the date command works different:

`./underpass -t $(date -v -2d +%Y-%m-%dT%H:%M:%S)`

A process will start downloading and processing OSM data until lastest data
is reached, and then it will continue updating every minute.

## Using the data

* [Install & run the Underpass Python REST API](https://github.com/hotosm/underpass/blob/master/docs/python-rest-api.md)
* [Use the Underpass UI components](https://github.com/hotosm/underpass/blob/master/docs/ui-components.md)
Check [The docs](https://hotosm.github.io/underpass/)!

## Get involved!

Expand All @@ -65,11 +34,6 @@ where we need help, some of them are:
* Data models for semantic validation
* Tests for everything

### Documentation

* Check the [docs](https://github.com/hotosm/underpass/tree/master/docs) folder.
* For internal documentation of all the C++ classes: [docs](https://hotosm.github.io/underpass/annotated.html)

### License

Underpass is free software! you may use any Underpass project under the terms of
Expand Down

0 comments on commit 26cf694

Please sign in to comment.