Skip to content

Source code for the paper "GeoWINE: Geolocation based Wiki, Image, News and Events Retrieval"

License

Notifications You must be signed in to change notification settings

cleopatra-itn/GeoWINE

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GeoWINE: Geolocation based Wiki, Image, News and Events Retrieval

In the context of social media, geolocation inference on news or events has become a very important task. In this paper, we present the GeoWINE (Geolocation-based Wiki-Image-News-Event retrieval) demonstrator, an effective modular system for multimodal retrieval which expects only a single image as input. The GeoWINE system consists of five modules in order to retrieve related information from various sources. The first module is a state-of-the-art model for geolocation estimation of images. The second module performs a geospatial-based query for entity retrieval using the Wikidata knowledge graph. The third module exploits four different image embedding representations, which are used to retrieve most similar entities compared to the input image. The embeddings are derived from the tasks of geolocation estimation, place recognition, ImageNet-based image classification, and their combination. The last two modules perform news and event retrieval from EventRegistry and the Open Event Knowledge Graph (OEKG). GeoWINE provides an intuitive interface for end-users and is insightful for experts for reconfiguration to individual setups. The GeoWINE achieves promising results in entity label prediction for images on Google Landmarks dataset. The demonstrator is publicly available at cleopatra.ijs.si/geowine/.

GeoWINE

Overview of the GeoWINE architecture.

Requirements

Frontend

The frontend was built using React JS (JavaScript), an open-source JavaScript library for user interface components. The following packages are arrequired:

Backend

We serve our Flask backend using Waitress pure-Python WSGI server. The following libraries are required:

  • Python version >= 3.7
  • PyTorch version = 1.5.1
# clone the repository
git clone https://github.com/cleopatra-itn/GeoWINE

cd GeoWINE/api/

# create a virtual environment
python3 -m venv venv
source venv/bin/activate

# install requirements
pip install -r requirements.txt

Run GeoWINE

Frontend

You can start the frontend using the yarn package:

# start frontend
yarn start

On package.json, we have configured the proxy address for redirecting all requests to the backend.

Backend

Similarly, we can run our backend using the yarn package:

# start backend
yarn start-api

In order to run the backend properly, you will need to cache the entity embeddings. To do so, please run all the files on the scripts folder.

License

The repository is under MIT License.

Cite

@inproceedings{tahmasebzadeh2021geowine,
  title={GeoWINE: Geolocation based Wiki, Image, News and Event Retrieval},
  author={Tahmasebzadeh, Golsa and Kacupaj, Endri and M{\"u}ller-Budack, Eric and Hakimov, Sherzod and Lehmann, Jens and Ewerth, Ralph},
  booktitle={Proceedings of the 44th International ACM SIGIR Conference on Research and Development in Information Retrieval},
  pages={2565--2569},
  year={2021}
}