Metadata-Version: 2.1
Name: NREL-gaps
Version: 0.1.0
Summary: National Renewable Energy Laboratory's (NREL's) Geospatial Analysis Pipelines (GAPs) framework
Home-page: https://nrel.github.io/gaps/
Author: Paul Pinchuk
Maintainer-email: ppinchuk@nrel.gov
License: BSD 3-Clause
Keywords: gaps
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click (>=8.1.3)
Requires-Dist: colorama (>=0.4.6)
Requires-Dist: NREL-rex (>=0.2.76)
Requires-Dist: numpy (>=1.21.5)
Requires-Dist: numpydoc (>=1.5.0)
Requires-Dist: pandas (>=1.3.5)
Requires-Dist: psutil (>=5.9.2)
Requires-Dist: setuptools (>=65.4.0)
Requires-Dist: sphinx (>=5.3.0)
Requires-Dist: sphinx-copybutton (>=0.5.1)
Requires-Dist: sphinx-click (>=4.4.0)
Requires-Dist: sphinx-tabs (>=3.4.1)
Requires-Dist: tabulate (>=0.9.0)
Provides-Extra: dev
Requires-Dist: pytest ; extra == 'dev'
Requires-Dist: pytest-cov ; extra == 'dev'
Requires-Dist: h5py ; extra == 'dev'
Requires-Dist: black ; extra == 'dev'
Requires-Dist: pylint ; extra == 'dev'
Requires-Dist: jupyter ; extra == 'dev'
Requires-Dist: pipreqs ; extra == 'dev'
Provides-Extra: docs
Requires-Dist: pytest ; extra == 'docs'
Requires-Dist: pytest-cov ; extra == 'docs'
Requires-Dist: h5py ; extra == 'docs'
Requires-Dist: black ; extra == 'docs'
Requires-Dist: pylint ; extra == 'docs'
Requires-Dist: jupyter ; extra == 'docs'
Requires-Dist: pipreqs ; extra == 'docs'
Requires-Dist: make ; extra == 'docs'
Requires-Dist: ghp-import ; extra == 'docs'
Requires-Dist: numpydoc ; extra == 'docs'
Requires-Dist: pandoc ; extra == 'docs'
Requires-Dist: sphinx-rtd-theme (>=0.5.1) ; extra == 'docs'
Provides-Extra: test
Requires-Dist: pytest ; extra == 'test'
Requires-Dist: pytest-cov ; extra == 'test'
Requires-Dist: h5py ; extra == 'test'

================================================
Welcome to Geospatial Analysis Pipelines (GAPs)!
================================================

.. inclusion-intro

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 <https://sam.nrel.gov>`_)
over a large geospatial extent (e.g. CONUS) across many parallel
HPC nodes. 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 configuration file generation, job status monitoring,
CLI Documentation, and more.


Installing gaps
===============

NOTE: The installation instruction below assume that you have python installed
on your machine and are using `conda <https://docs.conda.io/en/latest/index.html>`_
as your package/environment manager.


1. Clone the `gaps` repository.
    - Using ssh: :code:`git clone git@github.com:NREL/gaps.git`
    - Using https: :code:`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 <https://pylint.pycqa.org/en/latest/>`_ to lint the code and
`black <https://black.readthedocs.io/en/stable/index.html>`_ to format it (check out the
`black formatting style <https://black.readthedocs.io/en/stable/the_black_code_style/current_style.html>`_).
If you wish to contribute to this repository, your code will have to adhere to both of these guidelines and pass all existing tests.
