sij/mapnik
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

touch up INSTALL doc

Browse source
This commit is contained in:
Dane Springmeyer 2009-03-31 17:46:05 +00:00
parent c8340e7161
commit 1a03c2d655
1 changed files with 23 additions and 14 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

37
INSTALL
View file

@ -6,6 +6,10 @@ INSTALLATION INSTRUCTIONS
Quick Start Quick Start
----------- -----------
For platform specific install guides see:
http://trac.mapnik.org/wiki/MapnikInstallation
Install needed dependencies:: Install needed dependencies::
$ sudo apt-get install libboost* libicu* libfreetype* proj # see below for full list $ sudo apt-get install libboost* libicu* libfreetype* proj # see below for full list
@ -35,7 +39,7 @@ If you get this error ensure that Mapnik in is your PYTHONPATH.
Otherwise your setup is ready. You can now visit http://trac.mapnik.org/wiki/GettingStarted for a basic tutorial. Otherwise your setup is ready. You can now visit http://trac.mapnik.org/wiki/GettingStarted for a basic tutorial.
For help with using SCons see: trac.mapnik.org/wiki/UsingScons For help with using SCons see: http://trac.mapnik.org/wiki/UsingScons
For troubleshooting errors see: http://trac.mapnik.org/wiki/InstallationTroubleshooting. For troubleshooting errors see: http://trac.mapnik.org/wiki/InstallationTroubleshooting.
@ -76,14 +80,16 @@ Second, here are the optional software dependencies:
- libpq - PostgreSQL libraries (For PostGIS plugin support) - libpq - PostgreSQL libraries (For PostGIS plugin support)
- libgdal - GDAL/OGR input (For gdal and ogr plugin support) - libgdal - GDAL/OGR input (For gdal and ogr plugin support)
- libsqlite3 - SQLite input (needs RTree support) (sqlite plugin support) - libsqlite3 - SQLite input (needs RTree support) (sqlite plugin support)
- libocci - Oracle input plugin support
On Linux and Mac OS, package management systems (such as apt for debian or macports for darwin) can be used to install all required and optional dependencies, but source installs may be preferrable. - libcurl - OSM input plugin support
Instructions for installing many of these dependencies on various platforms can be found at the Mapnik Community Wiki (http://trac.mapnik.org/wiki/MapnikInstallation).
If your system does NOT have one of these installed, you will need to install the mandatory ones at the very least before proceeding further. If your system does NOT have one of these installed, you will need to install the mandatory ones at the very least before proceeding further.
Also, a minimum of 256MB of RAM is recommended for the build process. Instructions for installing many of these dependencies on various platforms can be found at the Mapnik Community Wiki (http://trac.mapnik.org/wiki/MapnikInstallation).
On Linux and Mac OS, package management systems (such as apt for debian or macports for darwin) can be used to install most or all dependencies, but source installs may be preferrable. This is particularly true for libraries that a required for the Python bindings, where source installs may be the best way to ensure that the same python version us linked to Boost, Cairo, and Mapnik.
Note: a minimum of 256MB of RAM is recommended for the build process.
Building Building
@ -92,7 +98,8 @@ Building
Once you've installed the required software packages, the simplest way to build Mapnik is to run SCons (The software builder) without any options:: Once you've installed the required software packages, the simplest way to build Mapnik is to run SCons (The software builder) without any options::
$ cd ~/src/mapnik $ cd ~/src/mapnik
$ python scons/scons.py $ python scons/scons.py configure
$ python scons/scons.py # will build sources
This should compile and link the mapnik library as well as the input plugins and the python language binding (if possible). If any mandatory dependencies are not found the build will fail, and you will need to specify custom paths to your libraries and include files. This should compile and link the mapnik library as well as the input plugins and the python language binding (if possible). If any mandatory dependencies are not found the build will fail, and you will need to specify custom paths to your libraries and include files.
@ -102,15 +109,17 @@ To see the list of available options, from the root of the source distribution,
$ python scons/scons.py -h $ python scons/scons.py -h
Note that the python used to run SCons does NOT have to be the same as the one used for the python bindings.
For example, if you compiled your own set of Boost libraries, you might use:: For example, if you compiled your own set of Boost libraries, you might use::
$ python scons/scons.py configure BOOST_TOOLKIT=gcc43 BOOST_INCLUDES=/usr/local/include/boost-1_35 BOOST_LIBS=/usr/local/lib $ python scons/scons.py configure BOOST_TOOLKIT=gcc43 BOOST_INCLUDES=/usr/local/include/boost-1_38 BOOST_LIBS=/usr/local/lib
Or if you installed Postgres and Gdal from source and you'd like to build Mapnik in Debug mode you might use:: Or if you installed ICU from source and you'd like to build Mapnik in Debug mode you might use::
$ python scons/scons.py configure DEBUG=True PGSQL_INCLUDES=/usr/local/pgsql/include PGSQL_LIBS=/usr/local/pgsql/lib GDAL_INCLUDES=/usr/local/include GDAL_LIBS=/usr/local/lib $ python scons/scons.py configure DEBUG=True ICU_INCLUDES=/usr/local/include ICU_LIBS=/usr/local/lib
For more details on all the options see: http://trac.mapnik.org/wiki/UsingScons
Note: the Python used to run SCons does NOT have to be the same as the one used for the python bindings.
Installation Installation
@ -122,7 +131,7 @@ Once the build has successfully completed, you can install the various files on
By default, everything will be installed under the PREFIX '/usr/local' as such:: By default, everything will be installed under the PREFIX '/usr/local' as such::
$PREFIX/lib: libmapnik.so $PREFIX/lib: libmapnik.so (.dylib on mac os)
$PREFIX/lib/mapnik/input: input plug-ins $PREFIX/lib/mapnik/input: input plug-ins
$PREFIX/include: mapnik include files $PREFIX/include: mapnik include files
$PREFIX/bin: shapeindex utility $PREFIX/bin: shapeindex utility
@ -189,7 +198,7 @@ Here is an example on how to use it::
>>> p = Projection('+init=epsg:27700') # British National Grid >>> p = Projection('+init=epsg:27700') # British National Grid
>>> p.forward(Coord(-1.125,51.75)) >>> p.forward(Coord(-1.125,51.75))
Coord(460396.920899,206113.214203) # reprojected coordinate x, y pair Coord(460396.920899,206113.214203) # reprojected coordinate x, y pair
>>> p.forward(Envelope(Coord(-1.125,51.75),Coord(-1.0,50.75))) >>> p.forward(Envelope(-1.125,51.75,-1.0,50.75))
Envelope(461721.365661,94917.0749406,469024.861457,206224.090767) # reprojected extent Envelope(461721.365661,94917.0749406,469024.861457,206224.090767) # reprojected extent