Wiki Ubuntu-it

Indice
Partecipa
FAQ
Wiki Blog
------------------
Ubuntu-it.org
Forum
Chiedi
Chat
Cerca
Planet
  • Pagina non alterabile
  • Informazioni
  • Allegati
  • Differenze per "Programmazione/Mapnik"
Differenze tra le versioni 44 e 58 (in 14 versioni)
Versione 44 del 20/10/2008 09.14.06
Dimensione: 9808
Commento:
Versione 58 del 23/11/2008 10.00.05
Dimensione: 3801
Commento: tolta guida alla compilazione
Le cancellazioni sono segnalate in questo modo. Le aggiunte sono segnalate in questo modo.
Linea 9: Linea 9:
'''Mapnik''' è un toolkit per la realizzazione di mappe a partire da dati vettoriali e raster ed è un'ottima alternativa ai più famosi [http://mapserver.gis.umn.edu/ Mapserver] e [http://geoserver.org/display/GEOS/Welcome Geoserver]. E' scritto in C++, permette un render molto veloce e utilizza Python bindings che supportano uno sviluppo semplice e veloce delle mappe. Grazie all'ottima [http://mapnik.org/documentation/ documentazione] e ai numerosi [http://trac.mapnik.org/wiki/ExampleCode esempi di codice] l'uso di Mapnik non è precluso a chi non ha conoscenze di programmazione. Mapnik viene usato normalmente per lo sviluppo di applicazioni web ma è adatto anche per la creazione di mappe a livello desktop. Questa guida contiene le istruzioni necessarie per l'installazione di '''Mapnik''', uno strumento utile alla realizzazione di mappe a partire da dati vettoriali e raster.
Linea 11: Linea 11:
Mapnik inoltre è il renderer "ufficiale" del progetto di cartografia libera [http://openstreetmap.org openstreetmap].
= Installazione da Repository =
= Preparativi =
Linea 14: Linea 13:
Per installare '''Mapnik''' è necessario [:AmministrazioneSistema/InstallareProgrammi:installare] il pacchetto ''python-mapnik'', reperibile dal [:Repository/Componenti:componente] '''universe''' dei [:Repository:repository ufficiali].  Abilitare i [:Repository/Componenti:componenti] '''universe''' e '''multiverse''' dei [:Repository:repository] ufficiali.
Linea 16: Linea 15:
Per installare una versione più aggiornata non presente nei repository ufficiali si deve procedere tramite la [:AmministrazioneSistema/InstallareProgrammi/DaSorgenti:compilare dei sorgenti]. = Installazione da repository =
Linea 18: Linea 17:
= Installazione tramite sorgenti = [:AmministrazioneSistema/InstallareProgrammi:Installare] il pacchetto ''python-mapnik''.
Linea 20: Linea 19:
== Installazione dipendenze == = Esempio con Mapnik =
Linea 22: Linea 21:
 * Installazione delle dipendenze boost richieste tramite:{{{
sudo aptitude install binutils cpp-3.3 g++-3.3 gcc-3.3 gcc-3.3-base libboost-dev libboost-filesystem-dev libboost-filesystem1.34.1 libboost-iostreams-dev libboost-iostreams1.34.1 libboost-program-options-dev libboost-program-options1.34.1 libboost-python-dev libboost-python1.34.1 libboost-regex-dev libboost-regex1.34.1 libboost-serialization-dev libboost-serialization1.34.1 libboost-thread-dev libboost-thread1.34.1 libicu-dev libicu38 libstdc++5 libstdc++5-3.3-dev python2.5-dev libfreetype6 libfreetype6-dev libjpeg62 libjpeg62-dev libltdl3 libltdl3-dev libpng12-0 libpng12-dev libtiff4 libtiff4-dev libtiffxx0c2 python-imaging python-imaging-dbg proj
}}}
Di seguito viene mostrato un primo esempio di utilizzo di '''Mapnik'''.
Linea 26: Linea 23:
 * Opzionale: Cairo Renderer: {{{
sudo aptitude install libcairo2 libcairo2-dev python-cairo python-cairo-dev libcairomm-1.0-1 libcairomm-1.0-dev libglib2.0-0 libpixman-1-0 libpixman-1-dev libpthread-stubs0 libpthread-stubs0-dev ttf-dejavu ttf-dejavu-core ttf-dejavu-extra
}}}
 0. Scaricare a [http://mappinghacks.com/data/world_borders.zip questo indirizzo] un dataset vettoriale in formato [http://it.wikipedia.org/wiki/Shapefile ESRI Shapefile], decomprimerlo e salvarlo all'interno della propria '''Home'''.
Linea 30: Linea 25:
 * Opzionale: Installazione di altri strumenti [:UbuntuGis:GIS]:{{{
sudo aptitude install libgdal-dev python2.5-gdal postgresql-8.3-postgis postgresql-8.3 postgresql-server-dev-8.3 postgresql-contrib-8.3
}}}

== Compilazione e installazione ==
=== Installazione senza supporto WMS ===
Se non si sono installati i programmi '''Postgis''', '''Gdal''' e non si ha intenzione di usare '''Mapnik''' come server WMS è suffiente dare i seguenti comandi all'interno di una finestra di terminale:{{{
mkdir ~/src
cd ~/src
svn co svn://svn.mapnik.org/trunk mapnik
cd mapnik
python scons/scons.py
sudo python scons/scons.py install
}}}

=== Installazione con supporto WMS ===

Se invece si sono istallati '''Postgis''', '''Gdal''' e si ha intenzione di usare il supporto WMS è necessario specificare il percorso alle librerie necessarie, digitando i seguenti comandi all'interno di una finestra di terminale:{{{
python scons/scons.py DEBUG=y PGSQL_INCLUDES=/usr/include/postgresql/ PGSQL_LIBS=/usr/lib/postgresql/8.3/lib GDAL_INCLUDES=/usr/local/include GDAL_LIBS=/usr/local/lib XMLPARSER=libxml2
sudo python scons/scons.py install DEBUG=y PGSQL_INCLUDES=/usr/include/postgresql/ PGSQL_LIBS=/usr/lib/postgresql/8.3/lib GDAL_INCLUDES=/usr/local/include GDAL_LIBS=/usr/local/lib XMLPARSER=libxml2
}}}
Digitare il seguente comando all'interno di una finestra di terminale:{{{
sudo ldconfig
}}}

= Test dell'installazione =
 0. Aprire una console di python digitando all'interno di una finestra di terminale il seguente comando:{{{
python
}}}
 0. Iniziare le operazioni di verifica tramite il seguente comando:{{{
import mapnik
}}}
Se non dovesse essere restituito nessun output l'installazione è andata bene e si può passare al [http://trac.mapnik.org/wiki/GettingStarted tutorial]

= Primi passi con Mapnik =
Vedremo ora come ottenere una mappa con Mapnik. Innanzitutto bisogna scaricare un semplice dataset vettoriale in formato [http://it.wikipedia.org/wiki/Shapefile ESRI Shapefile] e salvarlo in un punto qualsiasi nel filesystem.

Adesso scriviamo un semplice script in python che punti a questo file ne definisca lo stile e l'estensione geografica.
Per fare questo salvare il seguente script nella propria home in un file chiamato `mappa.py`.
L'estensione geografica dello script rende l'area realtiva al mediterraneo. Modificare le coordinate se si desidera rendere un'altra zona geografica
 * Non dimenticare di modificare il percorso allo shapefile!
{{{
 0. Scrivere uno script in python che punti a questo file ne definisca lo stile e l'estensione geografica. Per fare questo salvare il seguente script all'interno della propria '''Home''' in un file chiamato `mappa.py`. L'estensione geografica dello script rende l'area relativa al mediterraneo. Modificare le coordinate se si desidera rendere un'altra zona geografica, non dimenticando di modificare il percorso allo shapefile: {{{
Linea 76: Linea 30:
#qui definiamo la mappa da rendere con le sue dimensioni e il sistema di riferimento geografico (latlon WGS84) # Definizione delle dimensioni della mappa
#
e il sistema di riferimento geografico (latlon WGS84)
Linea 79: Linea 34:
#colore dello sfondo # Colore dello sfondo
Linea 82: Linea 37:
# Qui viene creato un stile # Creazione di uno stile
Linea 85: Linea 40:
# Adesso deve venir definito lo stile. Questo puo' avere una o piu' rule (regole). Una rule puo' comprendere un filtro, la definizione di scale minima e
# massima, uno o piu' Symbolizers (PolygonSymbolizer e LineSymbolizer)
# Definizione dello stile, possono esserci una o più regole.
# Una regola può comprendere un filtro, la definizione di scale minima e massima,
# uno o più Symbolizers (PolygonSymbolizer e LineSymbolizer)
Linea 89: Linea 45:
# colore di riempimento dei poligoni # Colore di riempimento dei poligoni
Linea 92: Linea 48:
# colore e spessore delle linee di contorno # Colore e spessore delle linee di contorno
Linea 96: Linea 52:
# Aggiungiamo lo stile alla mappa e gli diamo un nome da usare nella definizione del layer (livello) # Aggiunta dello stile alla mappa e definizione di un nome  # da usare nella definizione del livello
Linea 99: Linea 56:
# Adesso vengono definiti uno o piu' layer (livelli). Innanzitutto definiamo il nome dello stesso # Vengono definiti i nomi di uno o più livelli
Linea 102: Linea 59:
# # # # # # # # # # # # # # # # # #
#
Percorso allo shapefile. --> DA CAMBIARE!
# Lo shapefile deve essere indicato SENZA ESTENSIONE (senza .shp)
# # # # # # # # # # # # # # # # #
# Percorso allo shapefile.
# Lo shapefile deve essere indicato senza esenzione!
Linea 108: Linea 63:
# aggiungiamo lo stile al layer # Aggiunta dello stile al livello
Linea 111: Linea 66:
# aggiungiamo il layer alla mappa da rendere # Aggiunta del livello della mappa
Linea 114: Linea 69:
# Definiamo l'estensione geografica. Le due coppie di coordinate corrispondono ai due angoli basso-sinistro e alto-destro della
#
mappa
# Definizione dell'estensione geografica, le due coppie di coordinate  # corrispondono ai due angoli basso-sinistro e alto-destro della mappa
Linea 118: Linea 73:
# zoomiamo all'estensione geografica definita prima # Ingrandimento all'estensione geografica definita prima
Linea 121: Linea 76:
# rendiamo la mappa m nel file mediterraneo.png con formato png
render_to_file(m,'mediterraneo.png', 'png')
# Conversione la mappa m nel file italia.png con formato .png
render_to_file(m,'italia.png', 'png')
Linea 126: Linea 81:
Una volta salvato il file bisogna dargli permessi si esecuzione
{{{
 0. Una volta salvato il file bisogna impostare i [:AmministrazioneSistema/PermessiFile:permessi] d'esecuzione, digitando all'interno di una finestra di terminale il seguente comando:{{{
Linea 130: Linea 84:
Adesso lo script può essere lanciano
{{{
 0. Avviare lo script lanciando il seguente comando all'interno di una finestra di terminale:{{{
Linea 135: Linea 88:
Il risultato dovrebbe essere il file mediterraneo.png che rappresenta la nostra mappa.

= Compilazione del Viewer =
'''Mapnik''' comprende un visualizzatore per la vedere i mapfile di tipo `.xml`. Il Viewer permette le seguenti funzioni:
 * Visualizzare on-the-fly dei tiles
 * Leggere nel terminale i livelli di zoom e envelope
 * Fare lo zoom tramite query
 * Leggere eventuali errori di configurazione della mappa
 * Esportare in diversi formati tra cui `.tif`
||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%>[[Immagine(Icone/Piccole/note.png,,center)]] ||<style="padding:0.5em; border:none;">''Il '''Viewer''' è non è presente nel pacchetto installabile da repository. Se si ha intenzione di usarlo è necessario installare '''Mapnik''' da sorgenti''||

== Compilazione e installazione ==
Il codice sorgente del '''Viewer''' è contenuto in una sotto cartella del sorgente di '''Mapnik''' e deve essere compilato a parte. Per la compilazione sono necessari Qt4 (compreso il pacchtto dev) e qmake.
 0. Entrare della cartella che contiene il '''Viewer''':{{{
cd ~/src/mapnik/dem/viewer
}}}
 0. E' necessario adattare alcuni file al proprio sistema, quindi aprire il file `viewer.pro` con un [:Ufficio/EditorDiTesto:editor di testo] e modificarlo il percorso di '''INCLUDEPATH''' la riga '''unix.LIBS''' come segue:{{{
INCLUDEPATH += /usr/local/include/mapnik
INCLUDEPATH += /usr/include/boost-1_34_1
INCLUDEPATH += /usr/include/freetype2
INCLUDEPATH +=
unix:LIBS += -L/usr/local/lib -lmapnik
}}}
 0. Aprire il file `main.cpp` con un [:Ufficio/EditorDiTesto:editor di testo] e modificarlo specificando il percorso ai font a ai plugin di '''Mapnik''':{{{
datasource_cache::instance()->register_datasources("/usr/local/lib/mapnik/input");
freetype_engine::register_font("/usr/local/lib/mapnik/fonts/DejaVuSans.ttf");
freetype_engine::register_font("/usr/local/lib/mapnik/fonts/DejaVuSans-Bold.ttf");
freetype_engine::register_font("/usr/local/lib/mapnik/fonts/DejaVuSansMono.ttf");
}}}
 0. Compilare e installare il '''Viewer''' digitando all'interno di una finestra di terminale i seguenti comandi:{{{
/usr/bin/qmake-qt4 -makefile
make
}}}

== Lanciare il Viewer ==
Restando nella stessa cartella digitare il seguente comando sempre da una finestra di termiale:{{{
./viewer
}}}
Per visualizzare un mapfile lanciare il viewer aggiungendo il percorso dello stesso
{{{
./viewer /percorso/mapfile.xml
}}}
 0. Il risultato dovrebbe essere il file `italia.png` che rappresenta la mappa.
Linea 179: Linea 91:
Linea 180: Linea 93:
 * [http://trac.mapnik.org/ wiki di Mapnik]
 * [http://mike.teczno.com/notes/mapnik.html consigli stilistici]
 * [:UbuntuGis: guida all'installazione di altri strumenti GIS]
## da questo punto in poi non modificare!
 * [http://mapnik.org/documentation/ Documentazione ufficiale]
 * [http://trac.mapnik.org/wiki/ExampleCode Esempi di codice]
 * [:UbuntuGis:Guida all'installazione di Ubuntu GIS]
 * [http://trac.mapnik.org/wiki/InstallationTroubleshooting/ Risoluzione dei problemi in fase di compilazione]

BR Indice()

Introduzione

Questa guida contiene le istruzioni necessarie per l'installazione di Mapnik, uno strumento utile alla realizzazione di mappe a partire da dati vettoriali e raster.

Preparativi

Abilitare i [:Repository/Componenti:componenti] universe e multiverse dei [:Repository:repository] ufficiali.

Installazione da repository

[:AmministrazioneSistema/InstallareProgrammi:Installare] il pacchetto python-mapnik.

Esempio con Mapnik

Di seguito viene mostrato un primo esempio di utilizzo di Mapnik.

  1. Scaricare a [http://mappinghacks.com/data/world_borders.zip questo indirizzo] un dataset vettoriale in formato [http://it.wikipedia.org/wiki/Shapefile ESRI Shapefile], decomprimerlo e salvarlo all'interno della propria Home.

  2. Scrivere uno script in python che punti a questo file ne definisca lo stile e l'estensione geografica. Per fare questo salvare il seguente script all'interno della propria Home in un file chiamato mappa.py. L'estensione geografica dello script rende l'area relativa al mediterraneo. Modificare le coordinate se si desidera rendere un'altra zona geografica, non dimenticando di modificare il percorso allo shapefile:

    from mapnik import *
    
    # Definizione delle dimensioni della mappa
    # e il sistema di riferimento geografico (latlon WGS84)
    m = Map(500,300,"+proj=latlong +datum=WGS84")
    
    # Colore dello sfondo
    m.background = Color('steelblue')
    
    # Creazione di uno stile
    s = Style()
    
    # Definizione dello stile, possono esserci una o più regole.  
    # Una regola può comprendere un filtro, la definizione di scale minima e massima, 
    # uno o più Symbolizers (PolygonSymbolizer e LineSymbolizer)
    r=Rule()
    
    # Colore di riempimento dei poligoni
    r.symbols.append(PolygonSymbolizer(Color('#f2eff9')))
    
    # Colore e spessore delle linee di contorno
    r.symbols.append(LineSymbolizer(Color('rgb(50%,50%,50%)'),0.1))
    s.rules.append(r)
    
    # Aggiunta dello stile alla mappa e definizione di un nome 
    # da usare nella definizione del livello
    m.append_style('My Style',s)
    
    # Vengono definiti i nomi di uno o più livelli 
    lyr = Layer('world')
    
    # Percorso allo shapefile.
    # Lo shapefile deve essere indicato senza esenzione!
    lyr.datasource = Shapefile(file='/percorso/ai/dati/world_borders')
    
    # Aggiunta dello stile al livello
    lyr.styles.append('My Style')
    
    # Aggiunta del livello della mappa
    m.layers.append(lyr)
    
    # Definizione dell'estensione geografica, le due coppie di coordinate 
    # corrispondono ai due angoli basso-sinistro e alto-destro della mappa
    bbox = Envelope(Coord(6, 34), Coord(22, 48)) 
    
    # Ingrandimento all'estensione geografica definita prima
    m.zoom_to_box(bbox)
    
    # Conversione la mappa m nel file italia.png con formato .png
    render_to_file(m,'italia.png', 'png')
  3. Una volta salvato il file bisogna impostare i [:AmministrazioneSistema/PermessiFile:permessi] d'esecuzione, digitando all'interno di una finestra di terminale il seguente comando:

    chmod +x ~/mappa.py
  4. Avviare lo script lanciando il seguente comando all'interno di una finestra di terminale:

    ./mappa.py
  5. Il risultato dovrebbe essere il file italia.png che rappresenta la mappa.

Ulteriori risorse


CategoryHomepage