Geospatial Analysis Pipelines (GAPs) is a framework designed to assist researchers and software developers add execution tools to their geospatial python models. Born from the open-source reV model, GAPs is a robust and easy-to-use engine that provides a rich set of features such as command-line interface (CLI) generation and documentation, basic High-Performance Computing (HPC) scaling capabilities, configuration file generation, job status monitoring, and more.
Who should use GAPs
GAPs is intended to be used by researchers and/or software developers who have implemented a working python model but have not yet added any external model execution tools. Within minimal effort, developers can use GAPs to add a variety of utility for end-users, including a complete set of CLI commands and documentation pulled from the model run function docstrings. In addition, GAPs provides basic HPC execution capabilities, particularly catered towards embarrassingly parallel geospatial models (e.g. single-location models such as the System Advisor Model). GAPs can automatically distribute the execution of such models over a large geospatial extent (e.g. CONUS) across many parallel HPC nodes.
GAPs is NOT a workflow management system (WMS), and therefore does not provide any of the in-depth tools/capabilities expected from a proper WMS. However, GAPs-supported models can sometimes be included as part of the workflow in WMS tools like Torc.
To get started, take a look at the examples for analysts or model developers or dive straight into the full documentation.
Installing GAPs
The quickest way to install GAPs for users is from PyPi:
pip install nrel-gapsIf you are a developer contributing to GAPs, we recommend using pixi:
pixi shellFor detailed instructions, see the installation documentation.
Development
Please see the Development Guidelines if you wish to contribute code to this repository.
Acknowledgments
Paul Pinchuk and Grant Buster. Geospatial Analysis Pipelines. 2023. https://doi.org/10.11578/dc.20230426.7
The authors of this code would like to thank ExxonMobil Corporation for their contributions to this effort.
2 maintainers
Release files for NREL-gaps 0.8.11
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nrel_gaps-0.8.11.tar.gz | 165.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nrel_gaps-0.8.11-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 258.6 kB
Release files / nrel_gaps-0.8.11.tar.gz
| Download URL | nrel_gaps-0.8.11.tar.gz |
|---|---|
| Size | 165.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a7030b53d567bd53248117b8b3c751ffc45ae5717105d6c3571395808d872b6d
|
|
BLAKE2b-256 checksum How to use checksums |
03e11130bb62f3b7f7ef952ac4d7951629728f26d03c625076988ee647cfd015
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.5
|
Release files / nrel_gaps-0.8.11-py3-none-any.whl
| Download URL | nrel_gaps-0.8.11-py3-none-any.whl |
|---|---|
| Size | 93.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
097d35a65ce3c7f3dc3d49f035f67dea77685a0f9480ff6b25d799079ec88b8e
|
|
BLAKE2b-256 checksum How to use checksums |
b828028777aa1da14d073cadbb87a413ba7e727ca786f64a1c70e0c7d4c13fd8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.5
|
