Library for fast prototyping of GNN
Project description
IGNNITION: Fast prototyping of Graph Neural Networks for Communication Networks
IGNNITION is the ideal framework for users with no experience in neural network programming (e.g., TensorFlow, PyTorch). With this framework, users can design and run their own Graph Neural Networks (GNN) in a matter of a few hours.
Website: https://ignnition.net
Documentation: https://ignnition.net/doc/
IGNNITION is especially for you if:
You are a scientist or engineer that wants to build custom GNNs adapted to your problem (e.g., computer networks, biology, physics, chemistry, recommender systems…)
Learn more at IGNNITION at a Glance.
How it works?
Create your own GNN model in three simple steps:
- Define a GNN architecture with an intuitive YAML interface
- Adapt your dataset
- Execute the training with just 3 lines of code
IGNNITION produces an optimized implementation of your GNN without writing a single line of TensorFlow.
Quick Start
Installation
Recommended: Conda environment
A conda environment definition is available in environment.yml
. Using it is recommended, as it
ensures that an appropriate Python version and the necessary packages are installed. To use it, first install
miniconda and then run the following:
conda env create -f environment.yml --name ignnition
conda activate ignnition
This will create the conda environment with ignnition
name and will activate it.
Recommended: Python 3.7
Please, ensure you use Python 3.7. Otherwise, we do not guarantee the correct installation of dependencies.
You can install IGNNITION with the following command using PyPI.
pip install ignnition
Alternatively, you can install it from the source code, using the following commands. These commands first download the source code, then prepare the environment, and finally install the library:
wget 'https://github.com/knowledgedefinednetworking/ignnition'
pip install -r requirements.txt
python setup.py install
Please, find more details in our installation guide.
Tutorial
To get started with IGNNITION, we have prepared a step-by-step tutorial that explains in detail how to design a basic GNN from scratch. Click here to start this tutorial.
After this tutorial, you should be prepared to:
- Start designing your own GNN model from scratch.
- Reuse any model from our examples library and adapt it to your needs.
Please, follow the documentation to know all the details of this framework.
Main Contributors
D. Pujol-Perich, J. Suárez-Varela, Miquel Ferriol, A. Cabellos-Aparicio, P. Barlet-Ros.
Barcelona Neural Networking center, Universitat Politècnica de Catalunya
This software is part of a project that has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement No 871528.
License
See LICENSE for full of the license text.
Copyright Copyright 2020 Universitat Politècnica de Catalunya
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ignnition-1.3.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6601ce8e65f8aaec22824a94e47b26b667136f362282b63182392460d8bf6e61 |
|
MD5 | cf3daa1824559944cb2bfde362cbc26b |
|
BLAKE2b-256 | c5f8d4737e30f9e5bdf2ac4d3d826bb4e1cae8e9827ed9943ffe244c16972c0d |