Relational Functional Gradient Boosting (rfgb)

rfgb: Relational Functional Gradient Boosting (in Python).

• Documentation: https://rfgb.readthedocs.io/en/latest/
• Questions? Contact Alexander L. Hayes (hayesall)

Installation

Stable builds may be installed from PyPi

pip install rfgb

Or develop further by cloning the repository

git clone https://github.com/hayesall/rfgb.git
cd rfgb/
python setup.py develop

Quick-Start

Learning with a relational dependency network.

cd testDomains/Logistics/
rfgb init
rfgb learn rdn -target unload

Additional options for each subcommand may be viewed by passing -h as a parameter.

rfgb -h
rfgb learn rdn -h

Classification with Expert Advice (-advice)

Preferred and non-preferred labels may be provided as advice during classification via logical rules. This advice may be specified in a file named advice.txt in the train directory for a dataset.

Four datasets (BlocksWorld, HeartAttack, Logistics, and MoodDisorder) have an advice file included for demonstration

1. Logistics

cd testDomains/Logistics/
rfgb init
rfgb learn rdn -advice -target unload

2. HeartAttack

cd testDomains/HeartAttack/
rfgb init
rfgb learn rdn -advice -target ha

Targets

"Targets" specify what is learned, examples of the target are provided in pos.txt, neg.txt, or examples.txt (for regression). These are specified here for convenience.

In Development

• Test cases (codecov >90%)
• General interaction improvements for commandline and library
• Learning Markov Logic Networks

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

A full copy of the license is available in the base of this repository. For more information, see https://www.gnu.org/licenses/