# Feature Relevance Intervals - FRI



[](https://doi.org/10.5281/zenodo.1188749)
[](https://colab.research.google.com/github/lpfann/fri/blob/master/doc/source/notebooks/Guide.ipynb)



__FRI__ is a Python 3 package for analytical feature selection
purposes. It allows superior feature selection in the sense that all
important features are conserved. At the moment we support multiple
linear models for solving Classification, Regression and Ordinal
Regression Problems. We also support LUPI paradigm where at learning
time, privileged information is available.
# Usage
Please refer to the [documentation](https://lpfann.github.io/fri/) for advice.
For a quick start we provide a simple guide which leads through the main functions.
## Installation
`FRI` requires __Python 3.6+__.
For a __stable__ version from `PyPI` use
```shell
$ pip install fri
```
or with new versions of `pip` (>=19?) you can clone the repository and run
```shell
$ pip install .
```
in the folder on the `master` or `dev` branch.
## Documentation
Check out our online documentation [here](https://lpfann.github.io/fri/).
There you can find a quick start guide and more background information.
You can also run the guide directly online without setup [here](https://colab.research.google.com/github/lpfann/fri/blob/master/doc/source/notebooks/Guide.ipynb).
# Development
For dependency management we use the newly released [poetry](https://python-poetry.org/) tool.
If you have `poetry` installed, use
```shell
$ poetry install
```
inside the project folder to create a new `venv` and to install all dependencies.
To enter the newly created `venv` use
```shell
$ poetry env
```
to open a new shell inside.
Or alternatively run commands inside the `venv` with `poetry run ...`.
#### Docs
The [documentation](https://lpfann.github.io/fri/) is compiled using [portray](https://github.com/timothycrosley/portray/).
If the dependencies are installed with `poetry install` you should be able to run
```shell
$ poetry run portray in_browser
```
to compile the files into html and launch a browser to preview changes.
(Be sure not to mix up `poetry` != `portray`.)
The documentation files are generated from `Python` docstrings inside the source files
and from Markdown located in the `docs` folder.
#### Releases
To create a new release:
1. Create a new GitHub release with a version tag (e.g., `v8.2.0` or `8.2.0`)
2. The version will be automatically extracted from the tag and updated in `pyproject.toml`
3. The package will be built and published to PyPI automatically via GitHub Actions
## References
[1] Göpfert C, Pfannschmidt L, Hammer B. Feature Relevance Bounds for Linear Classification. In: Proceedings of the ESANN. 25th European Symposium on Artificial Neural Networks, Computational Intelligence and Machine Learning;
<https://pub.uni-bielefeld.de/publication/2908201>
[2] Göpfert C, Pfannschmidt L, Göpfert JP, Hammer B. Interpretation of Linear Classifiers by Means of Feature Relevance Bounds. Neurocomputing.
<https://pub.uni-bielefeld.de/publication/2915273>
[3] Lukas Pfannschmidt, Jonathan Jakob, Michael Biehl, Peter Tino, Barbara Hammer: Feature Relevance Bounds for Ordinal Regression. Proceedings of the ESANN. 27th European Symposium on Artificial Neural Networks, Computational Intelligence and Machine Learning; Accepted.
<https://pub.uni-bielefeld.de/record/2933893>
[4] Pfannschmidt L, Göpfert C, Neumann U, Heider D, Hammer B: FRI - Feature Relevance Intervals for Interpretable and Interactive Data Exploration. Presented at the 16th IEEE International Conference on Computational Intelligence in Bioinformatics and Computational Biology, Certosa di Pontignano, Siena - Tuscany, Italy. <https://ieeexplore.ieee.org/document/8791489>
Raw data
{
"_id": null,
"home_page": "https://fri.lpfann.me",
"name": "fri",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "feature selection, linear models, machine learning",
"author": "Lukas Pfannschmidt",
"author_email": "lukas@lpfann.me",
"download_url": "https://files.pythonhosted.org/packages/ca/64/66d5e813cf5bc1d50214efc27fec406251f37519715772457c80f7e6fae9/fri-9.0.0.tar.gz",
"platform": null,
"description": "# Feature Relevance Intervals - FRI\n\n\n\n\n\n\n[](https://doi.org/10.5281/zenodo.1188749)\n[](https://colab.research.google.com/github/lpfann/fri/blob/master/doc/source/notebooks/Guide.ipynb)\n\n\n\n\n__FRI__ is a Python 3 package for analytical feature selection\npurposes. It allows superior feature selection in the sense that all\nimportant features are conserved. At the moment we support multiple\nlinear models for solving Classification, Regression and Ordinal\nRegression Problems. We also support LUPI paradigm where at learning\ntime, privileged information is available.\n\n# Usage\nPlease refer to the [documentation](https://lpfann.github.io/fri/) for advice.\nFor a quick start we provide a simple guide which leads through the main functions.\n\n## Installation\n`FRI` requires __Python 3.6+__. \n\nFor a __stable__ version from `PyPI` use\n```shell\n$ pip install fri\n```\nor with new versions of `pip` (>=19?) you can clone the repository and run\n```shell\n$ pip install .\n```\nin the folder on the `master` or `dev` branch.\n## Documentation\nCheck out our online documentation [here](https://lpfann.github.io/fri/).\nThere you can find a quick start guide and more background information.\n\nYou can also run the guide directly online without setup [here](https://colab.research.google.com/github/lpfann/fri/blob/master/doc/source/notebooks/Guide.ipynb).\n\n\n\n\n# Development\nFor dependency management we use the newly released [poetry](https://python-poetry.org/) tool.\n\nIf you have `poetry` installed, use\n```shell\n$ poetry install\n``` \ninside the project folder to create a new `venv` and to install all dependencies.\nTo enter the newly created `venv` use \n```shell \n$ poetry env\n```\nto open a new shell inside.\nOr alternatively run commands inside the `venv` with `poetry run ...`.\n\n#### Docs\nThe [documentation](https://lpfann.github.io/fri/) is compiled using [portray](https://github.com/timothycrosley/portray/).\nIf the dependencies are installed with `poetry install` you should be able to run \n```shell\n$ poetry run portray in_browser\n```\nto compile the files into html and launch a browser to preview changes.\n\n(Be sure not to mix up `poetry` != `portray`.)\n\nThe documentation files are generated from `Python` docstrings inside the source files\n and from Markdown located in the `docs` folder.\n\n#### Releases\nTo create a new release:\n1. Create a new GitHub release with a version tag (e.g., `v8.2.0` or `8.2.0`)\n2. The version will be automatically extracted from the tag and updated in `pyproject.toml`\n3. The package will be built and published to PyPI automatically via GitHub Actions\n \n\n## References \n\n[1] G\u00f6pfert C, Pfannschmidt L, Hammer B. Feature Relevance Bounds for Linear Classification. In: Proceedings of the ESANN. 25th European Symposium on Artificial Neural Networks, Computational Intelligence and Machine Learning;\n<https://pub.uni-bielefeld.de/publication/2908201>\n\n[2] G\u00f6pfert C, Pfannschmidt L, G\u00f6pfert JP, Hammer B. Interpretation of Linear Classifiers by Means of Feature Relevance Bounds. Neurocomputing.\n<https://pub.uni-bielefeld.de/publication/2915273>\n\n[3] Lukas Pfannschmidt, Jonathan Jakob, Michael Biehl, Peter Tino, Barbara Hammer: Feature Relevance Bounds for Ordinal Regression. Proceedings of the ESANN. 27th European Symposium on Artificial Neural Networks, Computational Intelligence and Machine Learning; Accepted.\n<https://pub.uni-bielefeld.de/record/2933893>\n\n[4] Pfannschmidt L, G\u00f6pfert C, Neumann U, Heider D, Hammer B: FRI - Feature Relevance Intervals for Interpretable and Interactive Data Exploration. Presented at the 16th IEEE International Conference on Computational Intelligence in Bioinformatics and Computational Biology, Certosa di Pontignano, Siena - Tuscany, Italy. <https://ieeexplore.ieee.org/document/8791489>\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Implementation of Feature Relevance Bounds method to perform Feature Selection and further analysis.",
"version": "9.0.0",
"project_urls": {
"Homepage": "https://fri.lpfann.me",
"Repository": "https://github.com/lpfann/fri"
},
"split_keywords": [
"feature selection",
" linear models",
" machine learning"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6d675a701f365f920bca240658928cc2e56d0323e747a14038593ad48a9bbc40",
"md5": "5117bf2e3867d1b8da1996ecca1efa34",
"sha256": "0d18a14a88bc7cb7a7573bcf1f894096a3697f85f8545b279595e016c0c39049"
},
"downloads": -1,
"filename": "fri-9.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5117bf2e3867d1b8da1996ecca1efa34",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 41648,
"upload_time": "2025-08-02T14:54:41",
"upload_time_iso_8601": "2025-08-02T14:54:41.757714Z",
"url": "https://files.pythonhosted.org/packages/6d/67/5a701f365f920bca240658928cc2e56d0323e747a14038593ad48a9bbc40/fri-9.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ca6466d5e813cf5bc1d50214efc27fec406251f37519715772457c80f7e6fae9",
"md5": "ee5b1d092a60bf1d255751904e347536",
"sha256": "5ff2766432707f390c9c1785227b20e1b919dc966e210916cccd8a75469840a0"
},
"downloads": -1,
"filename": "fri-9.0.0.tar.gz",
"has_sig": false,
"md5_digest": "ee5b1d092a60bf1d255751904e347536",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 28947,
"upload_time": "2025-08-02T14:54:43",
"upload_time_iso_8601": "2025-08-02T14:54:43.013155Z",
"url": "https://files.pythonhosted.org/packages/ca/64/66d5e813cf5bc1d50214efc27fec406251f37519715772457c80f7e6fae9/fri-9.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-02 14:54:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "lpfann",
"github_project": "fri",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "fri"
}