Skip to content
Computer Vision framework for GeoSpatial Imagery
PLpgSQL Other
  1. PLpgSQL 98.8%
  2. Other 1.2%
Branch: master
Clone or download
Pull request Compare This branch is 842 commits ahead, 4 commits behind ocourtin:master.
Latest commit c7c10fd Jan 20, 2020
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs CLI cleanup Jan 20, 2020
robosat_pink bump to 0.6.1 Jan 20, 2020
sql add context doc Dec 26, 2019
tests rsp train config clean. Mostly da/dap Jan 17, 2020
.gitignore cleanup Nov 29, 2018
LICENSE Update copyright to 2020 Dec 22, 2019
MANIFEST.in Switch from VERSION to __version__ Aug 17, 2019
Makefile add 101 tar Jan 20, 2020
README.md link back doc to master Jan 20, 2020
config.toml weight comment Jan 17, 2020
requirements.txt Latest torch(vision) releases Jan 16, 2020
setup.py Update description Sep 17, 2019

README.md

RoboSat.pink

Computer Vision framework for GeoSpatial imagery

RoboSat.pink buildings segmentation from Imagery

Purposes:

  • DataSet Quality Analysis
  • Change Detection highlighter
  • Features extraction and completion

Main Features:

  • Provides several command line tools, you can combine together to build your own workflow
  • Follows geospatial standards to ease interoperability and data preparation
  • Build-in cutting edge Computer Vision model, Data Augmentation and Loss implementations (and allows to replace by your owns)
  • Support either RGB and multibands imagery, and allows Data Fusion
  • Web-UI tools to easily display, hilight or select results (and allow to use your own templates)
  • High performances
  • Eeasily extensible by design

Draw me RoboSat.pink

Documentation:

Tutorial:

Config file:

Tools:

  • rsp cover Generate a tiles covering, in csv format: X,Y,Z
  • rsp download Downloads tiles from a remote server (XYZ, WMS, or TMS)
  • rsp extract Extracts GeoJSON features from OpenStreetMap .pbf
  • rsp rasterize Rasterize vector features (GeoJSON or PostGIS), to raster tiles
  • rsp subset Filter images in a slippy map dir using a csv tiles cover
  • rsp tile Tile raster coverage
  • rsp train Trains a model on a dataset
  • rsp export Export a model to ONNX or Torch JIT
  • rsp predict Predict masks, from given inputs and an already trained model
  • rsp compare Compute composite images and/or metrics to compare several XYZ dirs
  • rsp vectorize Extract simplified GeoJSON features from segmentation masks
  • rsp info Print RoboSat.pink version informations

Presentations slides:

Installs:

With PIP:

pip3 install RoboSat.pink

With Ubuntu 19.10, from scratch:

# RoboSat.pink [mandatory]
sudo sh -c "apt update && apt install -y build-essential python3-pip
pip3 install RoboSat.pink && export PATH=$PATH:~/.local/bin

# NVIDIA GPU Drivers [needed for rsp train]
wget http://us.download.nvidia.com/XFree86/Linux-x86_64/435.21/NVIDIA-Linux-x86_64-435.21.run
sudo sh NVIDIA-Linux-x86_64-435.21.run -a -q --ui=none

# Extra CLI tools [used in tutorials and integration tests]
sudo apt install -y gdal-bin osmium-tool

# HTTP Server [for WebUI rendering]
sudo apt install -y apache2 && sudo ln -s ~ /var/www/html/rsp

NOTAS:

  • Requires: Python 3.6 or 3.7
  • GPU is mandatory, for rsp train
  • To test RoboSat.pink install, launch in a new terminal: rsp info
  • If needed, to remove pre-existing Nouveau driver: sudo sh -c "echo blacklist nouveau > /etc/modprobe.d/blacklist-nvidia-nouveau.conf && update-initramfs -u && reboot"

Architecture:

RoboSat.pink use cherry-picked Open Source libs among Deep Learning, Computer Vision and GIS stacks.

Stacks

GeoSpatial OpenDataSets:

Bibliography:

Contributions and Services:

  • Pull Requests are welcome ! Feel free to send code... Don't hesitate either to initiate a prior discussion via gitter or ticket on any implementation question. And give also a look at Makefile rules.

  • If you want to collaborate through code production and maintenance on a long term basis, please get in touch, co-edition with an ad hoc governance can be considered.

  • If you want a new feature, but don't want to implement it, DataPink provide core-dev services.

  • Expertise, assistance and training on RoboSat.pink are also provided by DataPink.

  • And if you want to support the whole project, because it means for your own business, funding is also welcome.

Requests for funding:

We've already identified several new features and research papers able to improve again RoboSat.pink, your funding would make a difference to implement them on a coming release:

  • Increase (again) prediction accuracy :

    • on low resolution imagery
    • even with few labels (aka Weakly Supervised)
    • feature extraction when they are (really) close (aka Instance Segmentation)
  • Add support for :

    • Linear features extraction
    • Time Series Imagery
    • StreetView Imagery
  • Improve (again) performances

Authors:

Citing:

  @Manual{,
    title = {{RoboSat.pink} Computer Vision framework for GeoSpatial Imagery},
    author = {Olivier Courtin, Daniel J. Hofmann},
    organization = {DataPink},
    year = {2019},
    url = {http://RoboSat.pink},
  }
You can’t perform that action at this time.