<!-- logo -->
<p align="center">
<img src="https://github.com/GispoCoding/eis_toolkit/assets/113038549/e25b6d40-2785-4e21-bf74-221e8b096c64" align="center"/>
</p>
<h1 align="center">EIS Toolkit</h2>
<p align="center">Python package for mineral prospectivity mapping</p>
<!-- badges -->
<p align="center">
<img src="https://github.com/GispoCoding/eis_toolkit/workflows/Tests/badge.svg"/>
<a href="https://github.com/GispoCoding/eis_toolkit/actions/workflows/pre-commit.yaml">
<img src="https://github.com/GispoCoding/eis_toolkit/actions/workflows/pre-commit.yaml/badge.svg"
/></a>
<a href="http://perso.crans.org/besson/LICENSE.html">
<img src="https://img.shields.io/badge/License-EUPL1.2-blue.svg"
/></a>
</p>
<!-- links to sections / TOC -->
<p align="center">
<a href="#installation">Installation</a>
·
<a href="#usage">Usage</a>
·
<a href="#roadmap">Roadmap</a>
·
<a href="#contributing">Contributing</a>
·
<a href="#license">License</a>
</p>
EIS Toolkit is a comprehensive Python package for mineral prospectivity mapping and analysis. EIS Toolkit is developed as part of [EIS Horizon EU project](https://eis-he.eu/), which aims to aid EU's efforts in the green transition by securing critical raw materials. EIS Toolkit serves both as a standalone library that brings together and implements relevant tools for mineral prospectivity mapping and as a computational backend for [EIS QGIS Plugin](https://github.com/GispoCoding/eis_qgis_plugin).
> [!NOTE]
> This repository is still in development. Check the [wiki page of EIS Toolkit](https://github.com/GispoCoding/eis_toolkit/wiki) for list of tools and [roadmap](#roadmap) for more details about the project.
## Installation
We recommend installing EIS Toolkit in an empty virtual environment to ensure compatibility between package versions.
EIS Toolkit is available in conda-forge and PyPI and can be installed with one of the following commands.
```console
pip install eis_toolkit
```
```console
conda install -c conda-forge eis_toolkit
```
A Python wheel can be downloaded also from the [releases page](https://github.com/GispoCoding/eis_toolkit/releases) of this GitHub repository.
> [!TIP]
> GDAL needs to be installed separately on Windows when using pip / PyPI. If you have trouble installing EIS Toolkit due to GDAL, you can download a compatible GDAL wheel (for example from [this repository](https://github.com/cgohlke/geospatial-wheels/releases)), install it first, and then attempt to install EIS Toolkit again.
## Usage
EIS Toolkit can be used in Python scripts, Jupyter notebooks or via the CLI. At the moment, most tools have their own module and are imported like this:
```python
# In general
from eis_toolkit.category.module import module_function
# Some examples
from eis_toolkit.raster_processing.reprojecting import reproject_raster
from eis_toolkit.exploratory_analyses.pca import compute_pca
```
The documentation of EIS Toolkit can be read [here](https://gispocoding.github.io/eis_toolkit/). You can find several Jupyter notebooks in this repostiory that demonstrate how tools of EIS Toolkit can be used.
### EIS QGIS Plugin
For those that prefer using tools of EIS Toolkit via a graphical user interface, check [EIS QGIS Plugin](https://github.com/GispoCoding/eis_qgis_plugin). The plugin includes the main GUI application called EIS Wizard and all individual EIS Toolkit tools as QGIS processing algorithms.
The plugin is developed by the same core team that develops EIS Toolkit.
### CLI
EIS Toolkit includes a [Typer](https://typer.tiangolo.com/) command-line interface that serves as a common interface for integrating the toolkit with external applications, such as QGIS. The CLI can be used directly too, for example
```console
eis resample-raster-cli --input-raster path/to/raster.tif --output-raster path/to/output.tif --resolution 50 --resampling-method bilinear
```
For general help, use
```console
eis --help
```
or help for a tool
```console
eis <tool-name> --help
```
> [!NOTE]
> Please note that the CLI has been primarily designed to communicate with external programs and may be clunky in direct use.
## Roadmap
- Milestone 1: **Beta release 0.1** (November 2023). The toolkit should have the basic funtionalities required for a full MPM workflow. Official testing phase begins. The plugin will be still under active development.
- Milestone 2: **Release 1.0** (May 2024). Most features should be incorporated at this time and the toolkit useful for actual MPM work. Testing will continue, more advanced methods added and the user experience refined.
## Contributing
We welcome contributions to EIS Toolkit in various forms:
- ✨ Developing new tools
- 🐞 Fixing bugs in the code
- 📝 Bug and other reporting
- 💡 Feature suggestions
To contribute with code or documentation, you'll need a local development environment and a copy of the repository. Please refer to the **For developers** section below for detailed setup instructions. If you're interested in bug reporting or making feature suggestions, you can familiarize yourself with the toolkit and test it as described in the **Usage** section. When you encounter bugs or have ideas for new features, you can create an issue in this repository.
### For developers
All contributing developers need Git and a copy of the repository.
```console
git clone https://github.com/GispoCoding/eis_toolkit.git
```
After this you have three options for setting up your local development environment.
1. Docker - [instructions](./instructions/dev_setup_with_docker.md)
2. Poetry - [instructions](./instructions/dev_setup_without_docker.md)
3. Conda - [instructions](./instructions/dev_setup_without_docker_with_conda.md)
*For general contributing guidelines, see [CONTRIBUTING](./CONTRIBUTING.md).*
## License
Licensed under the EUPL-1.2 or later.
Raw data
{
"_id": null,
"home_page": "https://eis-he.eu",
"name": "eis_toolkit",
"maintainer": "Gispo Ltd.",
"docs_url": null,
"requires_python": "<3.11,>=3.9",
"maintainer_email": "info@gispo.fi",
"keywords": "Development Status :: 4 - Beta, Topic :: Scientific/Engineering :: GIS, Programming Language :: Python :: 3 :: Only",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/1d/25/48fc3f6accde1689f6c118547de0cfadb272e376b5d8d56cf7ddc04c692b/eis_toolkit-1.1.2.tar.gz",
"platform": null,
"description": "<!-- logo -->\n<p align=\"center\">\n <img src=\"https://github.com/GispoCoding/eis_toolkit/assets/113038549/e25b6d40-2785-4e21-bf74-221e8b096c64\" align=\"center\"/>\n</p>\n\n<h1 align=\"center\">EIS Toolkit</h2>\n<p align=\"center\">Python package for mineral prospectivity mapping</p>\n\n<!-- badges -->\n<p align=\"center\">\n <img src=\"https://github.com/GispoCoding/eis_toolkit/workflows/Tests/badge.svg\"/>\n <a href=\"https://github.com/GispoCoding/eis_toolkit/actions/workflows/pre-commit.yaml\">\n <img src=\"https://github.com/GispoCoding/eis_toolkit/actions/workflows/pre-commit.yaml/badge.svg\"\n /></a>\n <a href=\"http://perso.crans.org/besson/LICENSE.html\">\n <img src=\"https://img.shields.io/badge/License-EUPL1.2-blue.svg\"\n /></a>\n</p>\n\n<!-- links to sections / TOC -->\n<p align=\"center\">\n <a href=\"#installation\">Installation</a>\n \u00b7\n <a href=\"#usage\">Usage</a>\n \u00b7\n <a href=\"#roadmap\">Roadmap</a>\n \u00b7\n <a href=\"#contributing\">Contributing</a>\n \u00b7\n <a href=\"#license\">License</a>\n</p>\n\n\nEIS Toolkit is a comprehensive Python package for mineral prospectivity mapping and analysis. EIS Toolkit is developed as part of [EIS Horizon EU project](https://eis-he.eu/), which aims to aid EU's efforts in the green transition by securing critical raw materials. EIS Toolkit serves both as a standalone library that brings together and implements relevant tools for mineral prospectivity mapping and as a computational backend for [EIS QGIS Plugin](https://github.com/GispoCoding/eis_qgis_plugin).\n\n> [!NOTE] \n> This repository is still in development. Check the [wiki page of EIS Toolkit](https://github.com/GispoCoding/eis_toolkit/wiki) for list of tools and [roadmap](#roadmap) for more details about the project.\n\n\n## Installation\nWe recommend installing EIS Toolkit in an empty virtual environment to ensure compatibility between package versions. \n\nEIS Toolkit is available in conda-forge and PyPI and can be installed with one of the following commands.\n\n```console\npip install eis_toolkit\n```\n\n```console\nconda install -c conda-forge eis_toolkit\n```\n\nA Python wheel can be downloaded also from the [releases page](https://github.com/GispoCoding/eis_toolkit/releases) of this GitHub repository.\n\n> [!TIP]\n> GDAL needs to be installed separately on Windows when using pip / PyPI. If you have trouble installing EIS Toolkit due to GDAL, you can download a compatible GDAL wheel (for example from [this repository](https://github.com/cgohlke/geospatial-wheels/releases)), install it first, and then attempt to install EIS Toolkit again.\n\n\n## Usage\nEIS Toolkit can be used in Python scripts, Jupyter notebooks or via the CLI. At the moment, most tools have their own module and are imported like this:\n```python\n# In general\nfrom eis_toolkit.category.module import module_function\n\n# Some examples\nfrom eis_toolkit.raster_processing.reprojecting import reproject_raster\nfrom eis_toolkit.exploratory_analyses.pca import compute_pca\n```\n\nThe documentation of EIS Toolkit can be read [here](https://gispocoding.github.io/eis_toolkit/). You can find several Jupyter notebooks in this repostiory that demonstrate how tools of EIS Toolkit can be used. \n\n\n### EIS QGIS Plugin\nFor those that prefer using tools of EIS Toolkit via a graphical user interface, check [EIS QGIS Plugin](https://github.com/GispoCoding/eis_qgis_plugin). The plugin includes the main GUI application called EIS Wizard and all individual EIS Toolkit tools as QGIS processing algorithms.\n\nThe plugin is developed by the same core team that develops EIS Toolkit.\n\n### CLI\nEIS Toolkit includes a [Typer](https://typer.tiangolo.com/) command-line interface that serves as a common interface for integrating the toolkit with external applications, such as QGIS. The CLI can be used directly too, for example\n\n```console\neis resample-raster-cli --input-raster path/to/raster.tif --output-raster path/to/output.tif --resolution 50 --resampling-method bilinear\n```\n\nFor general help, use\n\n```console\neis --help\n```\n\nor help for a tool\n\n```console\neis <tool-name> --help\n```\n\n> [!NOTE] \n> Please note that the CLI has been primarily designed to communicate with external programs and may be clunky in direct use.\n\n## Roadmap\n\n- Milestone 1: **Beta release 0.1** (November 2023). The toolkit should have the basic funtionalities required for a full MPM workflow. Official testing phase begins. The plugin will be still under active development.\n- Milestone 2: **Release 1.0** (May 2024). Most features should be incorporated at this time and the toolkit useful for actual MPM work. Testing will continue, more advanced methods added and the user experience refined.\n\n## Contributing\n\nWe welcome contributions to EIS Toolkit in various forms:\n- \u2728 Developing new tools\n- \ud83d\udc1e Fixing bugs in the code\n- \ud83d\udcdd Bug and other reporting\n- \ud83d\udca1 Feature suggestions\n\nTo contribute with code or documentation, you'll need a local development environment and a copy of the repository. Please refer to the **For developers** section below for detailed setup instructions. If you're interested in bug reporting or making feature suggestions, you can familiarize yourself with the toolkit and test it as described in the **Usage** section. When you encounter bugs or have ideas for new features, you can create an issue in this repository.\n\n### For developers\n\nAll contributing developers need Git and a copy of the repository.\n\n```console\ngit clone https://github.com/GispoCoding/eis_toolkit.git\n```\n\nAfter this you have three options for setting up your local development environment.\n1. Docker - [instructions](./instructions/dev_setup_with_docker.md)\n2. Poetry - [instructions](./instructions/dev_setup_without_docker.md)\n3. Conda - [instructions](./instructions/dev_setup_without_docker_with_conda.md)\n\n*For general contributing guidelines, see [CONTRIBUTING](./CONTRIBUTING.md).*\n\n## License\n\nLicensed under the EUPL-1.2 or later.\n",
"bugtrack_url": null,
"license": "EUPL-1.2",
"summary": "EIS Toolkit is a comprehensive collection of tools suitable for mineral prospectivity mapping. This toolkit has been developed as part of the Exploration Information System project which has been funded by European Union.",
"version": "1.1.2",
"project_urls": {
"Homepage": "https://eis-he.eu",
"Repository": "https://github.com/GispoCoding/eis_toolkit",
"issues": "https://github.com/GispoCoding/eis_toolkit/issues"
},
"split_keywords": [
"development status :: 4 - beta",
" topic :: scientific/engineering :: gis",
" programming language :: python :: 3 :: only"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e156739ddcab9e52224c8cc4b691ba82c6a6595b0f287de1cd3766b698104f37",
"md5": "eaf3dba479a5616e3bdbe22ea585ef3b",
"sha256": "d68dabe2e96f042d0e1eb0bb90479cb8fea2bdc05db1d66ff9b99c4a743a676a"
},
"downloads": -1,
"filename": "eis_toolkit-1.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "eaf3dba479a5616e3bdbe22ea585ef3b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.11,>=3.9",
"size": 172697,
"upload_time": "2024-12-09T07:23:44",
"upload_time_iso_8601": "2024-12-09T07:23:44.803732Z",
"url": "https://files.pythonhosted.org/packages/e1/56/739ddcab9e52224c8cc4b691ba82c6a6595b0f287de1cd3766b698104f37/eis_toolkit-1.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1d2548fc3f6accde1689f6c118547de0cfadb272e376b5d8d56cf7ddc04c692b",
"md5": "cae62ce920677392564caa76bb84211e",
"sha256": "228aa342967a9be9584b963faf4ce8c606f3c8da9d45edb0ec6baf1ffaf78a4d"
},
"downloads": -1,
"filename": "eis_toolkit-1.1.2.tar.gz",
"has_sig": false,
"md5_digest": "cae62ce920677392564caa76bb84211e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.11,>=3.9",
"size": 123340,
"upload_time": "2024-12-09T07:23:47",
"upload_time_iso_8601": "2024-12-09T07:23:47.265538Z",
"url": "https://files.pythonhosted.org/packages/1d/25/48fc3f6accde1689f6c118547de0cfadb272e376b5d8d56cf7ddc04c692b/eis_toolkit-1.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-09 07:23:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "GispoCoding",
"github_project": "eis_toolkit",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "eis_toolkit"
}
JSON
