Source

osm-rendering-workshop / getting_started.rst

Full commit
.. _getting_started:

Getting Started
***************

This `workshop <http://2010.foss4g.org/workshop03.php>`_ will walk you through getting raw OpenStreetMap data, importing the data into PostGIS using osm2pgsql, rendering map tiles with Mapnik, and displaying them with OpenLayers.

.. note::

  If you are reading this documentation after September 2010, you should check for updated documentation available at http://dbsgeo.com/foss4g2010/.


.. image:: _static/images/barcelona-old-sm.png


Learning the Toolchain
======================

You will learn how to install and configure a mimic of the official OpenStreetMap toolchain, using the same technologies, that can be later customized to render different map styles or pull from other datasets. The OSM rendering toolchain consists of the following technologies; all of them will be touched upon in the workshop:

Technologies
============

* `Planet.osm  <http://wiki.openstreetmap.org/wiki/Planet.osm>`_ - XML based dump format of the OSM database
* `PostGIS <http://postgis.refractions.net/>`_ - Spatial Database (part of PostgreSQL)
* `osm2pgsql <http://wiki.openstreetmap.org/wiki/Osm2pgsql>`_ - Tool for importing OSM data into PostGIS
* `Mapnik <http://mapnik.org/>`_ - Rendering library
* `OpenLayers <http://openlayers.org/>`_ - Javascript mapping interface
* `mod_tile <http://wiki.openstreetmap.org/wiki/Mod_tile>`_ - high performance tile serving, on-demand rendering, and caching

Extra friends along the way
===========================

We will also expose you to a few other useful tools:

* `QuantumGIS <http://qgis.org/>`_ - User friendly data viewer with powerful python plugins
* `Nik2img <http://code.google.com/p/mapnik-utils/wiki/Nik2Img>`_ - Command line stylesheet renderer
* `TileLite <http://bitbucket.org/springmeyer/tilelite/>`_ - lightweight development tile server
* Custom Mapnik stylesheets (`Spreadnik <http://wiki.openstreetmap.org/wiki/Spreadnik>`_, `Quantumnik <http://bitbucket.org/springmeyer/quantumnik>`_, and `Cascadenik <http://code.google.com/p/mapnik-utils/wiki/Cascadenik>`_)


More Help
=========
During the course of this workshop if you get stuck, you can find more details online at the `OpenStreetMap/Mapnik wiki page <http://wiki.openstreetmap.org/wiki/Mapnik>`_. IRC (Internet Relay Chat) is also a great place to ask questions. Try the #mapnik channel on irc://irc.freenode.net/mapnik and the #osm channel on irc://irc.oftc.net/osm.

.. and at the OpenStreetMap `stylesheet guide <http://svn.openstreetmap.org/applications/rendering/mapnik/README>`_.


Ready?
------

This plan sound good? Great, then lets begin by :ref:`installing`.

If you are running linux first check out :ref:`virtualbox-intro`.