Home

Awesome

DeepPVMapper

Overview

DeepPVMapper is a deep learning-based mapping algorithm developped to map rooftop PV installations over France. This algorithm is still under development and the repository hosts the latest release of the algorithm.

The latest version of the Zenodo repository with the data necessary for the replication of the results is accessible here : DOI

This algorithm is used in the following papers:

Approach

Our detection is summarized by the following diagram, based on 3D-PV-Locator:

<p align="center"> <img src="https://github.com/gabrielkasmi/dsfrance/blob/main/figs/flowchart.png" width=700px> </p>

The installations' characteristics that we extract are the following: surface, tilt, installed capacity. In order to assess the accuracy of the estimation of the installed capacity over the whole deployment area, we introduce a metric based on the <i> registre national d'installations </i> (RNI). This measure consists in reaggregating the installations's installed capacities for each city and to compare the aggregation with the reference value. The main advantage of this approach is that it is unsupervised, fast to compute and available over the whole territory of deployment. This accuracy tracking tool enables practitioner to monitor all the outputs produced by the algorithm, thus improving its accountability. We trained our classification and segmentation models on a new training database called BDAPPV, which you can access here.

Usage

Data

To replicate the results, you'll need to download the data and the models' weights. This can be downloaded on our Zenodo repository (see the latest release above)

This repository contains all the necessary data to run the pipeline over a small area of 120 km². If you want to run the pipeline over larger areas, you'll only have to download the corresponding aerial images here and the topological data here. Also make sure to download the RNI for the correct year, accessible here.

Set-up

Clone the repository and enter it.

git clone https://github.com/gabrielkasmi/deeppvmapper.git
cd deeppvmapper

Then, create the environment :

conda env create --file deeppvmapper.yml
conda activate deeppvmapper

Replication

We recommend that you follow our hands-on.ipynb notebook, located in the folder notebooks. This notebook will present you how to set up the configuration file, run the initialization script, the main pipeline and the evaluation script. This notebook maps an area of approximately 600 km². You can also directly run the scripts from the terminal, without going through the notebook.

Evaluating the accuracy

To evaluate the accuracy, you can execute the script evaluate.py. In addition, you can go through the visualization.ipynb notebook, located in the folder notebooks. In this notebook, you will explore the registry that you will have generated in the hands-on.ipynb notebook.

License and citation

License

This software is provided under GPL-3.0 license.

Citation:

@article{kasmi2022deepsolar,
  title={Towards unsupervised assessment with open-source data of the accuracy of deep learning-based distributed PV mapping},
  author={Kasmi, Gabriel and Dubus, Laurent and Blanc, Philippe and Saint-Drenan, Yves-Marie},
  journal={arXiv preprint arXiv:2207.07466},
  year={2022}
}

Like this work ? Do not hesitate to <a class="github-button" href="https://github.com/gabrielkasmi/deeppvmapper" data-icon="octicon-star" aria-label="Star gabrielkasmi/deeppvmapper on GitHub">star</a> us !