Home

Introduction

The CPG_CityScope_GAMA pedestrian simulation currently relies on GIS (Geographic Information System) data. In order to successfully run the CPG_CityScope_GAMA on an area of interest, it is necessary to properly gather and format the relevant GIS data. The following should provide a detailed documentation on how to gather and label the five GIS data layers required to successfully run the CPG_CityScope_GAMA simulation on any real world area of your choice.

GIS Editor: We recommend using QGIS software (see http://www.qgis.org/en/site/) to manipulate your GIS data

GIS Data: For detailled GIS data http://download.geofabrik.de/

Basic GIS Layer Structure

In order to create a GIS Map compatible with the CPG_CityScope_GAMA simulation, you will need 5 GIS data ‘layers’.

File Type	Definition
layer.shp	The main shapefile containing the actual geometry of the layer
layer.shx	A file containing the positional index of each shape in the main shapefile
layer.dbf	A file containing the attribute table for each shape in the main shapefile
layer.prj	A file containing coordinate system and projection format for the main shapefile
layer.cpg	A file containing the character encoding for the .dbf file

• Multiple application domains : Use GAMA for whatever application domain you want.

The files for each GIS layer can be obtained online either for free or through a purchase. Many online datasets do not provide complete data, so gathering and editing your own might be necessary in order to model the area you are interested in. For detailed information on the file extensions mentioned above, please refer to https://en.wikipedia.org/wiki/Shapefile.

File Type	Definition
Buildings
Roads
Table Bounds
Amenities
Bounds

Building

This layer represents the buildings present in the area you wish to model. This layer is a polygon type GIS vector dataset.

File Name

Buildings.extension (.shp, .shx, etc.)

Attribute Table

Attribute Name	Input Type	Input Length	Description
Usage	String	‘O’: office, ‘R’: Residential
Scale	String	'S': small, 'M': Medium, 'L': large
Floors	int	From 0 to 10
Capicity	int	From 0 to 10

Road

This layer represents the traffic network of the area you wish to model. This layer is a line type GIS vector dataset. The CPG_CityScope_GAMA simulation models pedestrian traffic flow, so any walkable pathway should be represented in this GIS layer.

File Name

Roads.extension (.shp, .shx, etc.)

Attribute Table

The “Roads” layer has an empty attribute table.

Overview

This layer represents the bounds of the CityMatrix grid inside of the simulation. This layer is a polygon type GIS vector dataset. If you wish to use the CityMatrix grid in your simulation, then choose the specific area you would like to modify using the CityMatrix grid during the simulation. If not, then choose any arbitrary space within the area of interest you have bounded, and draw a single polygon inside.

File Names

table_bounds.extension (.shp, .shx, etc.)

Attribute Table

The “table_bounds” layer has an empty attribute table.

Amenities

This layer represents lunch/dinner break options for each agent in the simulation. Each point will represent the location of a restaurant, convenience store, or supermarket for example - anywhere someone can sit down and eat. This layer is a point type GIS vector dataset.

File Name

amenities.extension (.shp, .shx, etc.)

Attribute Table

Attribute Name	Input Type	Input Length	Description
Type	String (text)	20 characters long	The type of amenity this is (e.g. ‘restaurant’, ‘pub’, ‘fast food’)
Name	String (text)	100 characters long	The name of the amenity (e.g. ‘Saul’s Deli’, ‘In-N-Out Burger’)
Usage	String (text)	1 character long	Each object should have this set to 'A'
Scale	String (text)	1 character long	TBD

Bound

This layer represents the bounds of the simulation. Agents will not be able to exit this perimeter. This layer is a polygon type GIS vector dataset.

File Names

Bounds.extension (.shp, .shx, etc.)

Attribute Table

The “Bounds” layer has an empty attribute table.