| Name | NREL-gaps JSON |
| Version |
0.8.11
JSON |
| download |
| home_page | None |
| Summary | National Renewable Energy Laboratory's (NREL's) Geospatial Analysis Pipelines (GAPs) framework |
| upload_time | 2025-08-12 03:02:24 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | None |
| keywords |
gaps
nrel
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
================================================
Welcome to Geospatial Analysis Pipelines (GAPs)!
================================================
|Docs| |Tests| |Linter| |Codecov|
|PyPi| |PythonV| |Ruff| |Pixi|
|License| |SWR|
.. |Docs| image:: https://github.com/NREL/gaps/workflows/Documentation/badge.svg
:target: https://nrel.github.io/gaps/
.. |Tests| image:: https://github.com/NREL/gaps/workflows/Pytests/badge.svg
:target: https://github.com/NREL/gaps/actions?query=workflow%3A%22Pytests%22
.. |Linter| image:: https://github.com/NREL/gaps/workflows/Lint%20Code%20Base/badge.svg
:target: https://github.com/NREL/gaps/actions?query=workflow%3A%22Lint+Code+Base%22
.. |PyPi| image:: https://img.shields.io/pypi/pyversions/NREL-gaps.svg
:target: https://pypi.org/project/NREL-gaps/
.. |PythonV| image:: https://badge.fury.io/py/NREL-gaps.svg
:target: https://badge.fury.io/py/NREL-gaps
.. |Codecov| image:: https://codecov.io/gh/NREL/gaps/branch/main/graph/badge.svg?token=6VZK0Q2QNQ
:target: https://codecov.io/gh/NREL/gaps
.. |Ruff| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
:target: https://github.com/astral-sh/ruff
.. |License| image:: https://img.shields.io/badge/License-BSD_3--Clause-blue.svg
:target: https://opensource.org/licenses/BSD-3-Clause
.. |Pixi| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/prefix-dev/pixi/main/assets/badge/v0.json
:target: https://pixi.sh
.. |SWR| image:: https://img.shields.io/badge/SWR--23--28_-blue?label=NREL
:alt: Static Badge
.. inclusion-intro
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 <https://github.com/NREL/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 <https://sam.nrel.gov>`_).
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 <https://pages.github.nrel.gov/viz/wms/index.html#/>`_.
To get started, take a look at the examples for
`analysts <https://nrel.github.io/gaps/misc/examples.users.html>`_ or
`model developers <https://nrel.github.io/gaps/misc/examples.developers.html>`_
or dive straight into the full `documentation <https://nrel.github.io/gaps/>`_.
Installing GAPs
===============
The quickest way to install GAPs for users is from PyPi:
.. code-block:: shell
pip install nrel-gaps
If you are a developer contributing to GAPs, we recommend using `pixi <https://pixi.sh/latest/>`_:
.. code-block:: shell
pixi shell
For detailed instructions, see the `installation documentation <https://nrel.github.io/gaps/misc/installation.html>`_.
Development
===========
Please see the `Development Guidelines <https://nrel.github.io/gaps/dev/index.html>`_
if you wish to contribute code to this repository.
Acknowledgments
===============
.. inclusion-ack
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.
Raw data
{
"_id": null,
"home_page": null,
"name": "NREL-gaps",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "Paul Pinchuk <ppinchuk@nrel.gov>, Grant Buster <gbuster@nrel.gov>",
"keywords": "gaps, NREL",
"author": null,
"author_email": "Paul Pinchuk <ppinchuk@nrel.gov>",
"download_url": "https://files.pythonhosted.org/packages/03/e1/1130bb62f3b7f7ef952ac4d7951629728f26d03c625076988ee647cfd015/nrel_gaps-0.8.11.tar.gz",
"platform": null,
"description": "================================================\nWelcome to Geospatial Analysis Pipelines (GAPs)!\n================================================\n\n|Docs| |Tests| |Linter| |Codecov|\n|PyPi| |PythonV| |Ruff| |Pixi|\n|License| |SWR|\n\n.. |Docs| image:: https://github.com/NREL/gaps/workflows/Documentation/badge.svg\n :target: https://nrel.github.io/gaps/\n\n.. |Tests| image:: https://github.com/NREL/gaps/workflows/Pytests/badge.svg\n :target: https://github.com/NREL/gaps/actions?query=workflow%3A%22Pytests%22\n\n.. |Linter| image:: https://github.com/NREL/gaps/workflows/Lint%20Code%20Base/badge.svg\n :target: https://github.com/NREL/gaps/actions?query=workflow%3A%22Lint+Code+Base%22\n\n.. |PyPi| image:: https://img.shields.io/pypi/pyversions/NREL-gaps.svg\n :target: https://pypi.org/project/NREL-gaps/\n\n.. |PythonV| image:: https://badge.fury.io/py/NREL-gaps.svg\n :target: https://badge.fury.io/py/NREL-gaps\n\n.. |Codecov| image:: https://codecov.io/gh/NREL/gaps/branch/main/graph/badge.svg?token=6VZK0Q2QNQ\n :target: https://codecov.io/gh/NREL/gaps\n\n.. |Ruff| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json\n :target: https://github.com/astral-sh/ruff\n\n.. |License| image:: https://img.shields.io/badge/License-BSD_3--Clause-blue.svg\n :target: https://opensource.org/licenses/BSD-3-Clause\n\n.. |Pixi| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/prefix-dev/pixi/main/assets/badge/v0.json\n :target: https://pixi.sh\n\n.. |SWR| image:: https://img.shields.io/badge/SWR--23--28_-blue?label=NREL\n :alt: Static Badge\n\n.. inclusion-intro\n\nGeospatial Analysis Pipelines (GAPs) is a framework designed\nto assist researchers and software developers add execution\ntools to their geospatial python models. Born from the\nopen-source `reV <https://github.com/NREL/reV>`_ model, GAPs is a\nrobust and easy-to-use engine that provides a rich set of features\nsuch as command-line interface (CLI) generation and documentation,\nbasic High-Performance Computing (HPC) scaling capabilities,\nconfiguration file generation, job status monitoring, and more.\n\n\nWho should use GAPs\n===================\nGAPs is intended to be used by researchers and/or software developers\nwho have implemented a working python model but have not yet added any\nexternal model execution tools. Within minimal effort, developers can\nuse GAPs to add a variety of utility for end-users, including a complete\nset of CLI commands and documentation pulled from the model run function\ndocstrings. In addition, GAPs provides basic HPC execution capabilities,\nparticularly catered towards embarrassingly parallel geospatial models\n(e.g. single-location models such as the `System Advisor Model <https://sam.nrel.gov>`_).\nGAPs can automatically distribute the execution of such models over a large\ngeospatial extent (e.g. CONUS) across many parallel HPC nodes.\n\nGAPs is **NOT** a workflow management system (WMS), and therefore does not\nprovide any of the in-depth tools/capabilities expected from a proper WMS.\nHowever, GAPs-supported models can sometimes be included as part of the workflow in\nWMS tools like `Torc <https://pages.github.nrel.gov/viz/wms/index.html#/>`_.\n\nTo get started, take a look at the examples for\n`analysts <https://nrel.github.io/gaps/misc/examples.users.html>`_ or\n`model developers <https://nrel.github.io/gaps/misc/examples.developers.html>`_\nor dive straight into the full `documentation <https://nrel.github.io/gaps/>`_.\n\n\nInstalling GAPs\n===============\n\nThe quickest way to install GAPs for users is from PyPi:\n\n.. code-block:: shell\n\n pip install nrel-gaps\n\nIf you are a developer contributing to GAPs, we recommend using `pixi <https://pixi.sh/latest/>`_:\n\n.. code-block:: shell\n\n pixi shell\n\nFor detailed instructions, see the `installation documentation <https://nrel.github.io/gaps/misc/installation.html>`_.\n\nDevelopment\n===========\nPlease see the `Development Guidelines <https://nrel.github.io/gaps/dev/index.html>`_\nif you wish to contribute code to this repository.\n\n\nAcknowledgments\n===============\n.. inclusion-ack\n\nPaul Pinchuk and Grant Buster. Geospatial Analysis Pipelines. 2023. https://doi.org/10.11578/dc.20230426.7\n\nThe authors of this code would like to thank ExxonMobil Corporation for their contributions to this effort.\n",
"bugtrack_url": null,
"license": null,
"summary": "National Renewable Energy Laboratory's (NREL's) Geospatial Analysis Pipelines (GAPs) framework",
"version": "0.8.11",
"project_urls": {
"documentation": "https://nrel.github.io/gaps/",
"homepage": "https://github.com/NREL/gaps",
"repository": "https://github.com/NREL/gaps"
},
"split_keywords": [
"gaps",
" nrel"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b828028777aa1da14d073cadbb87a413ba7e727ca786f64a1c70e0c7d4c13fd8",
"md5": "62c2baad38a65a1dc6afaa5f871586f5",
"sha256": "097d35a65ce3c7f3dc3d49f035f67dea77685a0f9480ff6b25d799079ec88b8e"
},
"downloads": -1,
"filename": "nrel_gaps-0.8.11-py3-none-any.whl",
"has_sig": false,
"md5_digest": "62c2baad38a65a1dc6afaa5f871586f5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 93376,
"upload_time": "2025-08-12T03:02:23",
"upload_time_iso_8601": "2025-08-12T03:02:23.477386Z",
"url": "https://files.pythonhosted.org/packages/b8/28/028777aa1da14d073cadbb87a413ba7e727ca786f64a1c70e0c7d4c13fd8/nrel_gaps-0.8.11-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "03e11130bb62f3b7f7ef952ac4d7951629728f26d03c625076988ee647cfd015",
"md5": "f979739f89d09f0dd4a502a5a0dce387",
"sha256": "a7030b53d567bd53248117b8b3c751ffc45ae5717105d6c3571395808d872b6d"
},
"downloads": -1,
"filename": "nrel_gaps-0.8.11.tar.gz",
"has_sig": false,
"md5_digest": "f979739f89d09f0dd4a502a5a0dce387",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 165273,
"upload_time": "2025-08-12T03:02:24",
"upload_time_iso_8601": "2025-08-12T03:02:24.874203Z",
"url": "https://files.pythonhosted.org/packages/03/e1/1130bb62f3b7f7ef952ac4d7951629728f26d03c625076988ee647cfd015/nrel_gaps-0.8.11.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-12 03:02:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "NREL",
"github_project": "gaps",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "nrel-gaps"
}
