geoloc

Code for image geolocalization

Quick start

Set-up

Clone the project:

git clone --recurse-submodules git@github.com:IIIA-ML/geoloc.git
cd geoloc

Create the etc/geoloc.env file and edit the default values:

cp etc/geoloc.env.default etc/geoloc.env

Before every run

Run the initialization script:

source bin/init-local.sh

Data preparation

To crawl Flickr data into flickr_raw.csv run the script:

python3 flickr_crawler.py

To download Flickr images run the script:

python3 flickr_downloader.py

To crawl Mapillary data into mapillary_raw.csv run the script:

python3 mapillary_crawler.py

To download Mapillary images run the script:

python3 mapillary_downloader.py

For further interest, please follow Data preparation for cleaning, downloading and visualizing the crawled image data from multiple sources (Flickr, Mapillary).

To run FocalNets

Please follow FocalNets' README for installation, data preparation and classification steps.

Development routines

Note for contributors

Branching workflow

We follow the master-develop workflow. That is, we work on the develop until it is stable to be merged into master. You can also use short-lived local branches that diverges from the develop and later merged into it. See the git docs for further reading.

Pulling changes from the repository

git pull --recurse-submodules

Committing changes to the repository

• Use git status to determine the files that you have changed.
• For each of the modified submodules:
  • Go inside the submodule and use git add to include every file you have changed in a commit.
  • Use git commit -m "<my commit message here>" to commit changes to the local repository.
  • Use git push origin develop to send the changes in the module to the repo.
• Use git add to include every file you have changed in the commit. Do not forget to add the directories of the modified submodules.
• Use git commit -m "<my commit message here>" to commit changes to the local repo.
• Use git push to send the changes to the remote repo.

Merging develop into master

Create a new pull request with base:master and compare:develop setting.

Adding new env vars

If you need a new variable in the etc/geoloc.env, be sure to add it to the etc/geoloc.env.default with a non-secret default value too.