facebookresearch/graphlog

API for accessing the GraphLog dataset

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 | Dataset

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
• If you have any questions or topics related to this project to discuss, please contact koustuvs[at]meta.com.

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 Issues

您好，数据集链接https://www.cs.mcgill.ca/~ksinha4/data/graphlog_icml_data.zip无效

Data not available

The url https://www.cs.mcgill.ca/~ksinha4/data/graphlog_v1.1.zip in the repository.json file seems to be no longer available. Would it be possible for the author to update it or upload the graphlog data?

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"
    }
}