search

alishiba14 / WorldKG-Knowledge-Graph

This repository contains the details and codes to reproduce the WorldKG knowledge graph.
MIT License
1 stars 0 forks source link

readme

WorldKG-Knowledge-Graph

This repository contains code to reproduce the WorldKG knowledge graph. The WorldKG knowledge graph is a comprehensive large-scale geospatial knowledge graph based on OpenStreetMap that provides semantic representation of geographic entities from over 188 countries. WorldKG contains higher representation of geographic entities compared to other knowledge graph and can be used as an underlying data source for various applications such as geospatial question answering, geospatial data retrieval, and other cross-domain semantic data-driven applications.

Prerequisites

Setup

Steps to create the WorldKG triples for the particular OSM snapshot.

  1. Clone the repository git clone https://github.com/alishiba14/WorldKG-Knowledge-Graph.git
    cd WorldKG-Knowledge-Graph
  2. Install the Python Requirements pip install -r requirements.txt
  3. Download the specific OpenStreetMap snapshot, e.g., from https://download.geofabrik.de/. We recommend using the osm.pbf format.
  4. Run the CreateTriples.py: python3 CreateTriples.py /path-to-pbf-file /path-to-the-ttl-file-to-save-triples Example: python3 CreateTriples.py italy-latest.osm.pbf italyTriples.ttl

File Structure

  • Create a Key_List.csv file which should contain list of OSM keys with valid OSM wiki page.
  • Create a OSM_Ontology_map_features.csv which should contain tags collected from OSM map features (https://wiki.openstreetmap.org/wiki/Map_features). The columns are key value sameAsDB sameAsWiki camel keyCamel appendedClass. Please see the paper for more description
  • requirements.txt - Contains versions of python libraries used.
  • CreateTriples.py - Main python file to create the WorldKG instance triples.
  • WorldKG_Ontology.ttl - WorldKG ontology triples in .ttl format.

    • Reference:

    If you find our work useful in your research, please consider citing our paper.

    @inproceedings{dsouza2021worldkg,
   title={{WorldKG: A World-Scale Geographic Knowledge Graph}},
   author={Dsouza, Alishiba and Tempelmeier, Nicolas and Yu, Ran and Gottschalk, Simon and Demidova, Elena},
   booktitle={{CIKM} '21: The 30th {ACM} International Conference on Information and Knowledge Management},
   year={2021},
   publisher={{ACM}},
   doi={10.1145/3459637.3482023}
}

    License

    MIT License

    Copyright (c) 2021 Alishiba Dsouza

    Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

    The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.