NetLogo banner

 NetLogo Publications
 Contact Us

 Modeling Commons

 User Manuals:


NetLogo User Community Models

(back to the NetLogo User Community Models)

[screen shot]

If clicking does not initiate a download, try right clicking or control clicking and choosing "Save" or "Download".(The run link is disabled because this model uses extensions.)


This model demonstrates land use patterns that may arise as a result of land-use compatibilities stablished in urban development plans and conditions present in the territory where they apply.


The model begins by representing the surface of a territory of finite dimension through a grid and without any urbanization. Each cell in this grid starts with a potential value of 1 or -1 assigned randomly and with the interest in developing one of 7 possible land uses that is also assigned at random. At each step, the model updates the potential value of each cell according to the potential values ​​of the neighboring cells and adjacent roads (roads increase the potential value of neighboring cells). If the new potential value passes a certain threshold, the cell becomes potentially developable. Next, the cell seeks that its interest in developing a land use is not incompatible with the surrounding land uses within a tolerance radius specified by the user. If it is not incompatible, the cell is urbanized with the intended land use. If not, the cell remains undeveloped and again its potential value is estimated successively in each generation of the model.

The following land uses are considered incompatible, so they must be at a distance equal to TOLERANCE-RADIUS to co-exist:

Residential and Industrial
Residential and Commercial-Industrial
Industrial and Tourism
Industrial and Residential-Commercial
Tourism and Commercial-Industrial
Tourism and Equipment
Residential-Commercial and Commercial-Industrial


Position the RESTRICTIONS? switch ON or OFF. If ON is chosen, the model will place natural restrictions on urbanization randomly over the territory. These can be interpreted as hills, bodies of water, protected natural areas, etc.

Select the tolerance radius of the land uses with the TOLERANCE-RADIUS slider. This is a distance after which the coexistence of two incompatible land uses is possible. The greater the value, the greater the distance between them so that they can coexist.

Assign % of projected land uses. Under the PROJECTED column, the planned percentages of each of the 7 land uses are entered. The total sum must be 100%.

(Optional) Paint roads and land use. Under the BRUSHES column, press the button for land use or road that you want to represent in the territory. While the active button is kept, hover the cursor with the left mouse button pressed on the territory to paint. When finished painting, deactivate the button before proceeding with the simulation.

Press the SETUP button. This will assign a random value of 1 or -1 to each of the cells.

Press the GROW button to start the simulation.

At any time during the simulation, the GROW button can be pressed to pause the simulation and paint land uses, roads or change the TOLERANCE-RADIUS value. Press again to resume the simulation.


At the beginning of the simulation, groups of land uses are formed, where the accommodation of each use with the rest will depend on its compatibility and tolerance radius. If there are roads, these will attract land uses forming urban corridors along with them and at their intersections.

The actual behavior of the percentage of projected land uses varies according to the relationship between the amount of the percentage, compatibilities, and tolerance radius among all uses. This can be verified under the % OF LAND USES column, where PROJECTED vs. REAL percentage are compared, and in the % OF LAND USES OVER TIME chart.

The resulting land-use patterns may be similar to those found in real urban regions.


Try the following options:

a) Start the simulation without roads. After clusters of urbanization are formed, pause the simulation and connect them with roads. Resume the simulation and observe how the land use pattern is modified by the attraction of the new roads. Pause the simulation again and connect the new clusters, and so on. Observe how road network and land-use patterns are formed as a result of this feedback process.

b) Draw land-use patterns before starting the simulation and observe how new urban growth adapts to it. Use land-use patterns of your neighborhood, city or region.


The model can be extended including a self-regulation process, in which the growth of land uses beyond its projected growth is not allowed.


The simulation takes its growth algorithm from a model called "Structure from randomness 2" found in the Netlogo model library. This model in turn is based on another model found in the book "Cities and Complexity" by Michael Batty.

(back to the NetLogo User Community Models)