Geoclimate documentation


This is the official Geoclimate documentation.

The climate modelling is based on the type, the use and the shape of the studied area. At the urban scale, the type of land surface (pervious, impervious), the shape and the distribution of the buildings and the streets as well as the building use are the determinant parameters affecting the urban climate. Thus it is necessary to described accurately the urban fabric in order to apply the right energy balance.

Geoclimate is a Groovy library that implements algorithms to compute geospatial indicators (e.g. density of building, skyview factor, building compactness, road distance, …) based on vector GIS layers.

The geospatial indicators are computed at three spatial units:

  • the building,

  • the block, defined as an aggregation of buildings that are in contact,

  • the Reference Spatial Unit (RSU).

More than 60 urban indicators are yet available. At a first stage, those indicators have been selected:

  • to feed the TEB climate model developed by Météo France,

  • to classify the urban tissues and build the Local Climate Zones (LCZ).

Even if Geoclimate has been developed for climate studies, the indicators can be used for other topics such as landscape ecology, land use, habitat conservation planning or any environmental or territory applications.

It can be freely used either for research and education, as well as by experts in a professional use.

This library is distributed under GPL 3 license by the DECIDE GIS team of the Lab-STICC (CNRS).


Research projects:

The Geoclimate library has been developed within the two following research projects:

  • URCLIM , part of ERA4CS, a project initiated by JPI Climate and co-funded by the European Union under grant agreement No 690462

  • PAENDORA , funded by ADEME

Institutional (public) fundings:


  • The official documentation is available in English only.

  • If you observe some mistakes or errors, please contact us at or let an issue here.

  • You are welcome to contribute, improve the documentation