Skip to content
This repository was archived by the owner on Jul 2, 2019. It is now read-only.

Commit d852d74

Browse files
authored
Merge pull request #76 from SpaceNetChallenge/dlindenbaum-readme-update
download instructions readme update
2 parents 2d2afcd + 03919c1 commit d852d74

1 file changed

Lines changed: 7 additions & 100 deletions

File tree

Lines changed: 7 additions & 100 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
## Hosting
2-
[SpaceNet](https://aws.amazon.com/public-datasets/spacenet/) is a corpus of commercial satellite imagery and labeled training data to use for machine learning research. The dataset is currently hosted as an [Amazon Web Services (AWS) Public Dataset](https://aws.amazon.com/public-datasets/).
2+
[SpaceNet](https://spacenetchallenge.github.io/) is a corpus of commercial satellite imagery and labeled training data to use for machine learning research. The dataset is currently hosted as an [Amazon Web Services (AWS) Public Dataset](https://aws.amazon.com/public-datasets/spacenet/).
3+
4+
For additonal information about the datasets visit the [SpaceNet Challenge Website](https://spacenetchallenge.github.io/)
35

46
## Catalog
57
1. Area of Interest 1 (AOI 1) - Location: Rio de Janeiro. 50cm imagery collected from DigitalGlobe’s [WorldView-2 satellite](http://satimagingcorp.s3.amazonaws.com/site/pdf/WorldView-2_datasheet.pdf). The dataset includes building footprints and 8-band multispectral data.
@@ -12,108 +14,13 @@
1214
## Dependencies
1315
The [AWS Command Line Interface (CLI)](https://aws.amazon.com/cli/) must be installed with an active AWS account. Configure the AWS CLI using 'aws configure'
1416

17+
## [The SpaceNet Roads Dataset](https://spacenetchallenge.github.io/datasets/spacenetRoads_summary.html)
18+
Visit the [SpaceNet Roads Dataset website](https://spacenetchallenge.github.io/datasets/spacenetRoads_summary.html) for additional information about the dataset including instructions on how to access and download the data.
1519

16-
## SpaceNet Simple Storage Service (S3) Directory Structure (AOI 1)
17-
```
18-
s3://spacenet-dataset/
19-
-- AOI_1_Rio
20-
|-- processedData
21-
| -- processedBuildingLabels.tar.gz # Compressed 3band and 8band 200m x 200m tiles with associated building foot print labels # This dataset is the Training Dataset for the first Top Coder Competition
22-
`-- srcData
23-
|-- rasterData
24-
| |-- 3-Band.tar.gz # 3band (RGB) Raster Mosaic for Rio De Jenairo area (2784 sq KM) collected by WorldView-2
25-
| -- 8-Band.tar.gz # 8band Raster Mosaic for Rio De Jenairo area (2784 sq KM) collected by WorldView-2
26-
-- vectorData
27-
|-- Rio_BuildingLabels.tar.gz # Source Dataset that contains Building the building foot prints traced from the Mosaic
28-
|-- Rio_HGIS_Metro.gdb.tar.gz # Source Point of Interest Dataset in GeoDatabase Format. Best if Used with ESRI
29-
-- Rio_HGIS_Metro_extract.tar # Source Point of Interest Dataset in GeoJSON with associated .jpg. Easy to Use without ESRI toolset
30-
-- AOI_1_Rio
31-
|-- processedData
32-
| -- processedBuildingLabels.tar.gz # Compressed 3band and 8band 200m x 200m tiles with associated building foot print labels # This dataset is the Training Dataset for the first Top Coder Competition
33-
`-- srcData
34-
|-- rasterData
35-
| |-- 3-Band.tar.gz # 3band (RGB) Raster Mosaic for Rio De Jenairo area (2784 sq KM) collected by WorldView-2
36-
| -- 8-Band.tar.gz # 8band Raster Mosaic for Rio De Jenairo area (2784 sq KM) collected by WorldView-2
37-
-- vectorData
38-
|-- Rio_BuildingLabels.tar.gz # Source Dataset that contains Building the building foot prints traced from the Mosaic
39-
|-- Rio_HGIS_Metro.gdb.tar.gz # Source Point of Interest Dataset in GeoDatabase Format. Best if Used with ESRI
40-
-- Rio_HGIS_Metro_extract.tar # Source Point of Interest Dataset in GeoJSON with associated .jpg. Easy to Use without ESRI toolset
41-
-- AOI_1_Rio
42-
|-- processedData
43-
| -- processedBuildingLabels.tar.gz # Compressed 3band and 8band 200m x 200m tiles with associated building foot print labels # This dataset is the Training Dataset for the first Top Coder Competition
44-
`-- srcData
45-
|-- rasterData
46-
| |-- 3-Band.tar.gz # 3band (RGB) Raster Mosaic for Rio De Jenairo area (2784 sq KM) collected by WorldView-2
47-
| -- 8-Band.tar.gz # 8band Raster Mosaic for Rio De Jenairo area (2784 sq KM) collected by WorldView-2
48-
-- vectorData
49-
|-- Rio_BuildingLabels.tar.gz # Source Dataset that contains Building the building foot prints traced from the Mosaic
50-
|-- Rio_HGIS_Metro.gdb.tar.gz # Source Point of Interest Dataset in GeoDatabase Format. Best if Used with ESRI
51-
-- Rio_HGIS_Metro_extract.tar # Source Point of Interest Dataset in GeoJSON with associated .jpg. Easy to Use without ESRI toolset
52-
```
53-
54-
## SpaceNet Simple Storage Service (S3) Directory Structure (AOI 2-5)
55-
```
56-
├── AOI_[Num]_[City]_Train
57-
│ ├── geojson
58-
│ │ └── buildings # Contains GeoJson labels of buildings for each tile
59-
│ ├── MUL # Contains Tiles of 8-Band Multi-Spectral raster data from WorldView-3
60-
│ ├── MUL-PanSharpen # Contains Tiles of 8-Band Multi-Spectral raster data pansharpened to 0.3m
61-
│ ├── PAN # Contains Tiles of Panchromatic raster data from Worldview-3
62-
│ ├── RGB-PanSharpen # Contains Tiles of RGB raster data from Worldview-3
63-
│ └── summaryData # Contains CSV with pixel based labels for each building in the Tile Set.
64-
```
65-
66-
## Download instructions
67-
68-
### AOI 1 - Rio de Janeiro
69-
To download processed 200mx200m tiles of AOI 1 (3.4 GB) with associated building footprints do the following:
70-
```
71-
aws s3api get-object --bucket spacenet-dataset --key AOI_1_Rio/processedData/processedBuildingLabels.tar.gz --request-payer requester processedBuildingLabels.tar.gz
72-
```
73-
To download the Source Imagery Mosaic (3-band = 2.3 GB and 8-band = 6.5 GB):
74-
```
75-
aws s3api get-object --bucket spacenet-dataset --key AOI_1_Rio/srcData/rasterData/3-Band.tar.gz --request-payer requester 3-Band.tar.gz
76-
aws s3api get-object --bucket spacenet-dataset --key AOI_1_Rio/srcData/rasterData/8-Band.tar.gz --request-payer requester 8-Band.tar.gz
77-
```
78-
To download the Source Vector Data (0.18 GB):
79-
```
80-
aws s3api get-object --bucket spacenet-dataset --key AOI_1_Rio/srcData/vectorData/Rio_BuildingLabels.tar.gz --request-payer requester Rio_BuildingLabels.tar.gz
81-
```
82-
83-
### AOI 2 - Vegas
84-
To download processed 200mx200m tiles of AOI 2 (23 GB) with associated building footprints do the following:
85-
```
86-
aws s3api get-object --bucket spacenet-dataset --key AOI_2_Vegas/AOI_2_Vegas_Train.tar.gz --request-payer requester AOI_2_Vegas_Train.tar.gz
87-
```
88-
89-
### AOI 3 - Paris
90-
To download processed 200mx200m tiles of AOI 3 (5 GB) with associated building footprints do the following:
91-
```
92-
## Warning this file is 5 GB
93-
aws s3api get-object --bucket spacenet-dataset --key AOI_3_Paris/AOI_3_Paris_Train.tar.gz --request-payer requester AOI_3_Paris_Train.tar.gz
94-
```
95-
96-
### AOI 4 - Shanghai
97-
To download processed 200mx200m tiles of AOI 4 (23 GB) with associated building footprints do the following:
98-
```
99-
aws s3api get-object --bucket spacenet-dataset --key AOI_4_Shanghai/AOI_4_Shanghai_Train.tar.gz --request-payer requester AOI_4_Shanghai_Train.tar.gz
100-
```
101-
102-
### AOI 5 - Khartoum
103-
To download processed 200mx200m tiles of AOI 5 (4 GB) with associated building footprints do the following:
104-
```
105-
aws s3api get-object --bucket spacenet-dataset --key AOI_5_Khartoum/AOI_5_Khartoum_Train.tar.gz --request-payer requester AOI_5_Khartoum_Train.tar.gz
106-
```
10720

108-
### Point of Interest Dataset in ESRI GeoDatabase Form (31 GB)
109-
```
110-
aws s3api get-object --bucket spacenet-dataset --key AOI_1_Rio/srcData/vectorData/Rio_HGIS_Metro.gdb.tar.gz --request-payer requester Rio_HGIS_Metro.gdb.tar.gz
111-
```
21+
## [The SpaceNet Catalog](https://spacenetchallenge.github.io/datasets/datasetHomePage.html)
22+
Visit the [SpaceNet Data Corpus website](https://spacenetchallenge.github.io/datasets/spacenetRoads_summary.html) for additional information about all SpaceNet datasets including instructions on how to access and download the data.
11223

113-
### Point of Interest Dataset Extracted into GeoJSONs with associated .jpg (29 GB)
114-
```
115-
aws s3api get-object --bucket spacenet-dataset --key AOI_1_Rio/srcData/vectorData/Rio_HGIS_Metro_extract.tar --request-payer requester Rio_HGIS_Metro_extract.tar
116-
```
11724

11825

11926

0 commit comments

Comments
 (0)