This is the 0.0.1.00015 version of the package lczexplore.
The code of this package is under the LGPL-3 licence as described in https://www.r-project.org/Licenses/LGPL-3
The lczexplore library has been originally developed within the following research projects: * PAENDORA2 (Pour la gestion du confort estival : Donnees, Outils et Recherche-Action) (2022 -2025), * funded by ADEME
lczexplore is described in the following paper :
Matthieu Gousseff, Erwan Bocher, Jérémy Bernard, Elisabeth Le Saux Wiederhold. lczexplore: an R package to explore Local Climate Zone classifications. Journal of Open Source Software, 2023, 8 (91), pp.5445. ⟨10.21105/joss.05445⟩. ⟨halshs-04293878⟩
If you are kind enough to cite this package, please check in the /inst directory for the CITATION file (in cff style without the extension)
This package can be installed from github using the install_github function of the devtools package.
# library(remotes)
# remotes::install_github("orbisgis/lczexplore")This package relies on the sf and s2
spatial libraries, which require external system tools to compile on
macOS. Before installing lczexplore, please ensure you have
the following dependencies installed : cmake, openssl, abseil.
The goal of lczexplore is to explore and compare Local Climate Zone classifications of urban areas.
Climate change is a growing concern for city planners with a special focus on Urban Heat Island phenomenons. Stewardt and Oke [ref] have proposed a classification of Local Climate Zones (LCZ) that describe rural and urban areas, with 10 built types and 7 land cover types.
Several approaches classify land units into LCZ and may produce different results. For instance, the GeoClimate geospatial toolbox use GIS layers from OpenStreetMap or the french BD Topo whereas the WUDAPT platform uses remotely sensed information and local expert knowledge.
The lczexplore packages allows to easily : - load these classification from GIS layers - produce maps of these LCZ classification - compare these classifications
In order to compare two LCZ classifications the compareLCZ function proceeds the following steps : ## Plot the two classifications Two maps are produced and allow a visual comparison of the two classifications.
This steps returns geometries on which the two classifications either totally agree either totally disagree, and plot them on a map.
The areas of all the geometries where the classifications agree are summed and give the general percentage of agreement.
A confusion matrix shows how a given level of LCZ for the first classification is broken down into the levels of the other classification.
Some LCZ classifications come with a confidence level for each spatial unit. For instance, the GeoClimate toolbox sets a LCZ level to a spatial unit according to the values of urban canopy parameters, and computes a uniqueness value that indicates if other levels of LCZ could also have been set to this spatial unit. This uniqueness value can be seen as a confidence measurement of the LCZ level.
The lczexplore package allows to see how this confidence value impacts the general agreement between two LCZ classification.
The following functions are the core of this package :
importLCZvect : imports the LCZ layer from a GIS (tested
with geojson and shapefile files)
importLCZwudapt : imports LCZ from the wudapt Europe
Tiff. You’ll have to use importLCZvect first to create the
Bounding box of your zone of interest
showLCZ : plots the map of your LCZ
compareLCZ : compares two LCZ classifications of the
same areas, output plots and data if this comparison
confidSensib : explores how the agreement between two
LCZ varies according to a confidence indicator associated for the LCZ
value of each geom (sensibility analysis) 
These functions are used in the PAENDORA 2 project but may not be
generic enough or robust enough for other uses. groupLCZ :
allows to group some LCZ levels into a level named by the user (for
instance to group all compact LCZ, or all vegetation LCZ…) See example
and vignettes to allow on-the-fly LCZ types grouping.
Since version 0.1.0, lczexplore includes functions to
compare more than 2 maps. It allows to produce pairwise agreements,
consensus among workflows for each LCZ type and a chord diagram to
visualize how types of a workflow break up in types of the others.
importMultipleLCZvectimport LCZ layers from multiple
maps. Its use require a given folder tree.
createIntersect intersects the geometries (spatial
units) of all maps, and allows more control before comparison. As more
than 2 workflows and multiple locations can be compared, intersection is
a step on its own.
compareMultipleLCZ compare the multiple maps and produce
pairwise agreements, a consensus indicator among workflows for each LCZ
type and a chord diagram to visualize the correspondences between
workflows.
