https://github.com/brawer/geosmell

Compute signals for the the “smell” of a geographic area, such as how touristy it is
https://github.com/brawer/geosmell

Last synced: 29 days ago
JSON representation

Compute signals for the the “smell” of a geographic area, such as how touristy it is

• Host: GitHub
• URL: https://github.com/brawer/geosmell
• Owner: brawer
• License: mit
• Created: 2019-09-20T10:46:20.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2019-09-26T15:06:39.000Z (about 5 years ago)
• Last Synced: 2023-02-28T03:35:45.931Z (almost 2 years ago)
• Language: Go
• Size: 82 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Build Status](https://travis-ci.org/brawer/geosmell.svg?branch=master)](https://travis-ci.org/brawer/geosmell)

# GeoSmell

Experimental code for computing signals about geographic areas.

To identify geographic areas, we use [S2 cells](http://s2geometry.io/).

You can choose the desired

[aggregation level](https://s2geometry.io/resources/s2cell_statistics);

`--level=17` aggregates to cells of about 70×70 meters in size.

To visualize the geographic region of an S2 cell on a map, you can use

the [Sidewalk Labs Region Coverer](https://s2.sidewalklabs.com/regioncoverer/).

Enter the S2 cell ID into the “cells” field and press the circular button.

Currently, we process the following datasets:

* **wikicommons**: geo-tagged pictures at

  [Wikimedia Commons](https://commons.wikimedia.org/)

* **chpopstat**: [Swiss Population Statistics](https://www.bfs.admin.ch/bfs/de/home/dienstleistungen/geostat/geodaten-bundesstatistik/gebaeude-wohnungen-haushalte-personen/bevoelkerung-haushalte-ab-2010.assetdetail.9606372.html)

## Building and running

```sh

git clone https://github.com/brawer/geosmell.git ; cd geosmell

go build ; go test

./geosmell --dataset=wikicommons --level=17

```

## Storage

If you pass the access keys to an S3-compatible cloud storage system,

the tool will store its output into a cloud storage bucket “geosmell”.

Also, if you pass the storage keys, the tool will check what data version

is in storage; if the stored data version is still current, the tool will

exit early without doing work. This makes it convenient to use geosmell

as a daily running cronjob. For `--keys`, pass the location of a JSON file

with the following content:

```json

{

    "S3Host": "your.preferred.cloud.storage.example.com",

    "S3AccessKey": "YourAccessKey",

    "S3SecretKey": "YourSecret"

}

```

## Future work

It would be nice to collect additional signals about geographic areas.

Feel free to send pull requests.

## License

The code in this repository is Copyright 2019 by Sascha Brawer,

licensed under the MIT license.  The processed data sets have

their own licences.