Skip to content

Commit b06c839

Browse files
committed
Adds illustrations to readme, closes #11
1 parent e36412b commit b06c839

4 files changed

Lines changed: 9 additions & 4 deletions

File tree

README.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -47,25 +47,30 @@ Features can be anything visually distinguishable in the imagery for example: bu
4747
Have a look at [this OpenStreetMap diary post](https://www.openstreetmap.org/user/daniel-j-h/diary/44145) where we first introduced RoboSat and show some results.
4848

4949
The tools RoboSat comes with can be categorized as follows:
50-
- pre-processing: preparing a dataset for training feature extraction models
51-
- modelling: training segmentation models for feature extraction in images
50+
- data preparation: creating a dataset for training feature extraction models
51+
- training and modeling: segmentation models for feature extraction in images
5252
- post-processing: turning segmentation results into cleaned and simple geometries
5353

5454
Tools work with the [Slippy Map](https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames) tile format to abstract away geo-referenced imagery behind tiles of the same size.
5555

56-
The pre-processing tools help you with getting started creating a dataset for training feature extraction models.
56+
![](./assets/pipeline-01.png)
57+
58+
The data preparation tools help you with getting started creating a dataset for training feature extraction models.
5759
Such a dataset consists of aerial or satellite imagery and corresponding masks for the features you want to extract.
5860
We provide convenient tools to automatically create these datasets downloading aerial imagery from the [Mapbox](mapbox.com) Maps API and generating masks from [OpenStreetMap](openstreetmap.org) geometries but we are not bound to these sources.
5961

62+
![](./assets/pipeline-02.png)
63+
6064
The modelling tools help you with training fully convolutional neural nets for segmentation.
6165
We recommend using (potentially multiple) GPUs for these tools: we are running RoboSat on AWS p2/p3 instances and GTX 1080 TI GPUs.
6266
After you trained a model you can save its checkpoint and run prediction either on GPUs or CPUs.
6367

68+
![](./assets/pipeline-03.png)
69+
6470
The post-processing tools help you with cleaning up the segmentation model's results.
6571
They are responsible for denoising, simplifying geometries, transforming from pixels in Slippy Map tiles to world coordinates (GeoJSON features), and properly handling tile boundaries.
6672

6773
If this sounds almost like what you need, see the [extending section](#extending) for more details about extending RoboSat.
68-
6974
If you want to contribute, see the [contributing section](#contributing) for more details about getting involved with RoboSat.
7075

7176

assets/pipeline-01.png

99.6 KB
Loading

assets/pipeline-02.png

182 KB
Loading

assets/pipeline-03.png

59.6 KB
Loading

0 commit comments

Comments
 (0)