graphlog's Introduction

GraphLog

API to interface with the GraphLog Dataset. GraphLog is a multi-purpose, multi-relational graph dataset built using rules grounded in first-order logic.

Homepage | Paper | API Docs

News

Core Generator logic of GraphLog is now released in its own repository, GLC! This repository will contain the specific instantiations of GLC which can be used to create various setups of GraphLog. Stay tuned for more updates!

Installation

Supported Python Version: 3.6, 3.7, 3.8
Install PyTorch from https://pytorch.org/get-started/locally/
Install pytorch-geometric (and other dependencies) from https://github.com/rusty1s/pytorch_geometric#installation. Make sure that cpu/cuda versions for pytorch and pytorch-geometric etc matches.
pip install graphlog

QuickStart

Check out the notebooks on Basic Usage and Advanced Usage to quickly start playing with GraphLog.

Dev Setup

pip install -e ".[dev]"
Install pre-commit hooks pre-commit install
The code is linted using:
- black
- flake8
- mypy
All the tests can be run locally using nox

Experiments

Code for experiments used in our paper are available in experiments/ folder.

Questions

If you have questions, open an Issue
Or, join our Slack channel and post your questions / comments!
To contribute, open a Pull Request (PR)

Contributing

Please open a Pull Request (PR).

Citation

If our work is useful for your research, consider citing it using the following bibtex:

@article{sinha2020graphlog,
  Author = {Koustuv Sinha and Shagun Sodhani and Joelle Pineau and William L. Hamilton},
  Title = {Evaluating Logical Generalization in Graph Neural Networks},
  Year = {2020},
  arxiv = {https://arxiv.org/abs/2003.06560}
}

License

CC-BY-NC 4.0 (Attr Non-Commercial Inter.)

Terms of Use

https://opensource.facebook.com/legal/terms

Privacy Policy

https://opensource.facebook.com/legal/privacy

graphlog's People

Contributors

Stargazers

Watchers

graphlog's Issues

Data Unavailable

Hi, I am encounter the same HTTP 404 issue as other people. However, the URL you shared in other posts is an empty zip file. Can you share again? Thank you.

Importing Graphlog runs into `Exception: HTTP Error 404`

from graphlog import GraphLog
gl = GraphLog()

Importing Graphlog runs into Exception: HTTP Error 404: Not Found, (OR cannot connect remotely to retrieve metadata), while trying to retrieve URLs from repository.json.

This is due to the fact the dataset URLs listed in repository.json also result in Error 404. Can you please help with this?

Repository.json file:

    "graphlog_v1.0": {
        "name": "GraphLog v1.0",
        "description": "GraphLog suite consisting of 57 datasets.",
        "url": "https://www.cs.mcgill.ca/~ksinha4/data/graphlog_icml_data.zip",
        "md5hash": "6aeda25d56251328dcdca0b23b4abe0a",
        "data_filename": "comp_r10_n100_ov",
        "difficulty": {
            "easy": [9,12,18,19,20,24,27,31,34,35,36,37,38,39,
                46,47,48,49,51],
            "moderate": [4,7,8,10,11,21,22,26,28,32,33,40,41,
                43,45,50,52,54,55,56],
            "hard": [0, 1, 2, 3, 5, 6, 13, 14, 15, 16, 17, 23, 
                25, 29, 30, 42, 44, 53]
        }
    },
    "graphlog_v1.1": {
        "name": "GraphLog v1.1",
        "description": "GraphLog suite consisting of 57 datasets. New generation pipeline with explanable resolution paths.",
        "url": "https://www.cs.mcgill.ca/~ksinha4/data/graphlog_v1.1.zip",
        "md5hash": "b206d3463b6a31a77f86c1e9ace22dc6",
        "data_filename": "graphlog_v1.1"
    }
}

facebookresearch / graphlog Goto Github PK