Skip to main content
Version: 1.8.1

Manipulate OSM Datas

This section will be presented as a quick tutorial, showing how to proceed to manipulate OSM (Open street map) data, clean them and load them into GAMA. We will use the software QGIS to change the attributes of the OSM file.

Note that GAMA can read and import OpenStreetMap data natively and create agents from them. An example model is provided in the Model Library (Data Importation / OSM File Import.gaml). In this case, you will have to write a model to import, select data from OpenStreetMap before creating agents and then could export them into shapefiles, much easier to use in GAMA.

From the website, we will choose a place (in this example, we will take a neighborhood in New York City). Directly from the website, you can export the chosen area in the osm format.

OpenStreetMap website to select a place.

We have now to manipulate the attributes for the exported osm file. Several softwares can be used, but we will focus on QGIS, which is totally free and provides a lot of possibilities in term of manipulation of data.

Once you have installed correctly QGIS, launch QGIS Desktop, and start to import the topology from the osm file.

Import OpenStreetMap data into QGIS.

Import OpenStreetMap data into QGIS 2.

A message indicates that the import was successful. An output file .osm.db is created. You have now to export the topology to SpatiaLite.

Export the data to SpatiaLite (through QGIS).

Specify the path for your DataBase file, then choose the export type (in your case, we will choose the type "Polygons (closed ways)"), choose an output layer name. If you want to use the open street maps attributes values, click on "Load from DB", and select the attributes you want to keep. Click OK then.

Select the OSM attribute before importation.

A message indicates that the export was successful, and you have now a new layer created.

Display of OSM data imported in QGIS.

We will now manipulate the attributes of your datafile. Right-click on the layer, and select "Open Attribute Table".

Open attribute table to display all the agents.

The table of attribute appears. Select the little pencil on the top-left corner of the window to modify the table.

Attribute tables.

We will add an attribute manually. Click on the button "new column", choose a name and a type (we will choose the type "text").

Add an attribute to the attribute table.

A new column appears at the end of the table. Let's fill some values (for instance blue/red). Once you finish, click on the "save edit" button.

Fill the new attribute with values.

Our file is now ready to be exported. Right-click on the layer, and click on "Save As".

Open the save data window.

Choose "shapefile" as format, choose a save path and click ok.

Save the data in a shapefile.

Copy passed all the .shp created in the include folder of your GAMA project. You are now ready to write the model.

model HowToUseOpenStreetMap

global {
// Global variables related to the Management units
file shapeFile <- file('../includes/new_york.shp');

//definition of the environment size from the shapefile.
//Note that is possible to define it from several files by using: geometry shape <- envelope(envelope(file1) + envelope(file2) + ...);
geometry shape <- envelope(shapeFile);

init {
//Creation of elementOfNewYork agents from the shapefile (and reading some of the shapefile attributes)
create elementOfNewYork from: shapeFile
with: [elementId::int(read('id')), elementHeight::int(read('height')), elementColor::string(read('attrForGama'))] ;

species elementOfNewYork{
int elementId;
int elementHeight;
string elementColor;

aspect basic{
draw shape color: (elementColor = "blue") ? #blue : ( (elementColor = "red") ? #red : #yellow ) depth: elementHeight;

experiment main type: gui {
output {
display HowToUseOpenStreetMap type:opengl {
species elementOfNewYork aspect: basic;

Here is the result, with a special colorization of the different elements regarding the value of the attribute "attrForGama", and an elevation regarding the value of the attribute "height".