** Jump to: Setup | Directory Structure | Data Acquisition | Sample Tutorial | Acknowledgments | License
Mapping electrical infrastructure can support measuring access to electricity and can help identify opportunities to improve or extend exisiting power infrastructure. High resolution orthorectified imagery (such as drone imagery) can be used to map power distribution infrastructure. The figure below shows a sample power distribution network that can be mapped using this repository. Here, power infrastructure mapping across the distribution network is done by i) detecting electrical poles and ii) segmenting power distribution lines.
Clone this repo and install the conda environment
cd <REPO-NAME>
conda env create -f environment.yml
conda activate gridmapper
.
├── environment.yml
├── LICENSE.md
├── README.md
├── TUTORIAL.md
└── src
├── figures
│ └── power_infrastructure_examples.png
├── lines
│ ├── data
│ │ ├── dataloader_line.py
│ │ ├── line_dataprep.py
│ │ ├── line_tile_dataset.py
│ │ └── streaming_line_dataset.py
│ ├── line_config.yaml
│ ├── line_inference.py
│ ├── lineseg
│ │ ├── base_network.py
│ │ ├── line_tasks.py
│ │ └── unet.py
│ ├── line_train.py
│ └──notebooks
│ └── 01-00-visualize_patches.ipynb
└── poles
├── data
│ ├── dataloader_pole.py
│ ├── pole_dataprep.py
│ ├── pole_tile_dataset.py
│ └── streaming_pole_dataset.py
├── pole_config.yaml
├── poledetect
│ ├── fcn8_resnet.py
│ ├── lcfcn_loss.py
│ ├── pole_metrics.py
│ ├── pole_tasks.py
├── pole_inference.py
└── pole_train.py
This project uses TIFF files of aerial imagery, corresponding point vector labels (for electrical poles) and linestring vector labels (for electrical lines), as GeoJSON or GeoPackage files. You can request a small sample dataset hosted on Azure blob storage, collected by USA for UNHCR and the Humanitarian OpenStreetMap Team:
-
Request a data download URL from USA for UNHCR.
-
Once you have the URL, you can use it to access the data on Azure blob storage. Here's an example of how you can download the data with
azcopy
:
azcopy copy --recursive <AZURE_BLOB_URL> <DESTINATION_PATH>
The downloaded raw data folder contains power_infrastructure_demo
data that can be used to follow the sample tutorial.
- After downloading the data, set the right paths in the config files as described in the tutorial.
A sample tutorial walking through the project can be found in TUTORIAL.md.
This project was made possible through the collaboration of several organizations: USA for UNHCR, UNHCR, Humanitarian OpenStreetMap Team, and the Microsoft AI for Good Lab.
This project is licensed under the MIT License - see the LICENSE.md file for details.