Skip to main content

National Renewable Energy Laboratory's (NREL's) Geospatial Analysis Pipelines (GAPs) framework

Project description

https://github.com/NREL/gaps/workflows/Documentation/badge.svg https://github.com/NREL/gaps/workflows/Pytests/badge.svg https://github.com/NREL/gaps/workflows/Lint%20Code%20Base/badge.svg https://img.shields.io/pypi/pyversions/NREL-gaps.svg https://badge.fury.io/py/NREL-gaps.svg https://codecov.io/gh/NREL/gaps/branch/main/graph/badge.svg?token=6VZK0Q2QNQ

Geospatial Analysis Pipelines (GAPs) is a framework designed to assist users in scaling their geospatial models to a High-Performance Computing (HPC) environment. In particular, GAPs automatically distributes the execution of a single-location model (such as the System Advisor Model) over a large geospatial extent (e.g. CONUS) across many parallel HPC nodes. 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 configuration file generation, job status monitoring, CLI Documentation, and more.

To get started, take a look at the documentation (examples coming soon!)

Installing gaps

NOTE: The installation instruction below assume that you have python installed on your machine and are using conda as your package/environment manager.

  1. Clone the gaps repository.
    • Using ssh: git clone git@github.com:NREL/gaps.git

    • Using https: git clone https://github.com/NREL/gaps.git

  2. Create and activate the gaps environment and install the package:
    1. Create a conda env: conda create -n gaps python=3.10

    2. Activate the newly-created conda env: conda activate gaps

    3. Change directories into the repository: cd gaps

    4. Prior to running pip below, make sure the branch is correct (install from main!): git branch -vv

    5. Install gaps and its dependencies by running: pip install -e . (or pip install -e .[dev] if running a dev branch or working on the source code)

Development

This repository uses pylint to lint the code and black to format it (check out the black formatting style). If you wish to contribute to this repository, your code will have to adhere to both of these guidelines and pass all existing tests.

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

NREL-gaps-0.3.4.tar.gz (66.2 kB view hashes)

Uploaded Source

Built Distribution

NREL_gaps-0.3.4-py3-none-any.whl (77.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page