Metadata-Version: 2.4
Name: NREL-rex
Version: 0.2.100
Summary: National Renewable Energy Laboratory's (NREL's) REsource eXtraction tool: rex
Author-email: Michael Rossol <michael.rossol@nrel.gov>
Maintainer-email: Grant Buster <gbuster@nrel.gov>, Paul Pinchuk <ppinchuk@nrel.gov>, Brandon Benton <brandon.benton@nrel.gov>
License-Expression: BSD-3-Clause
Project-URL: homepage, https://www2.nrel.gov/gis/renewable-energy-potential
Project-URL: documentation, https://nrel.github.io/rex/
Project-URL: repository, https://github.com/NREL/rex
Keywords: rex,NREL
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: click<9,>=8.1.8
Requires-Dist: fsspec<2025,>=2021.09.0
Requires-Dist: dask<2025,>=2024.8.0
Requires-Dist: h5py!=3.0.0,>=2.10.0
Requires-Dist: h5pyd<1,>=0.18.0
Requires-Dist: numpy>=1.16
Requires-Dist: pandas<3,>=2.0.0
Requires-Dist: packaging<25,>=24.2
Requires-Dist: psutil<8,>=7.0.0
Requires-Dist: PyYAML<7,>=6.0.2
Requires-Dist: s3fs<2024,>=2023.6.0
Requires-Dist: scikit-learn<2,>=1.6.1
Requires-Dist: scipy<2,>=1.3
Requires-Dist: toml<0.11,>=0.10.2
Requires-Dist: xarray<2026,>=2024.07.0
Provides-Extra: test
Requires-Dist: pytest<9,>=8.3.3; extra == "test"
Requires-Dist: pytest-timeout<3,>=2.3.1; extra == "test"
Requires-Dist: flaky<4,>=3.8.1; extra == "test"
Provides-Extra: dev
Requires-Dist: flake8; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: pylint; extra == "dev"
Provides-Extra: hsds
Requires-Dist: hsds<1,>=0.8.4; extra == "hsds"
Provides-Extra: build
Requires-Dist: build<1,>=0.10; extra == "build"
Requires-Dist: pkginfo<2,>=1.10.0; extra == "build"
Requires-Dist: twine<7,>=6.1.0; extra == "build"
Dynamic: license-file

**********************************************
Welcome to The REsource eXtraction (rex) tool!
**********************************************

|Docs| |Tests| |Linter| |PyPi| |PythonV| |Conda| |Licence| |CodeCov| |Zeonodo|

.. |Docs| image:: https://github.com/NREL/rex/workflows/Documentation/badge.svg
    :target: https://nrel.github.io/rex/

.. |Tests| image:: https://github.com/NREL/rex/workflows/Pytests/badge.svg
    :target: https://github.com/NREL/rex/actions?query=workflow%3A%22Pytests%22

.. |Linter| image:: https://github.com/NREL/rex/workflows/Lint%20Code%20Base/badge.svg
    :target: https://github.com/NREL/rex/actions?query=workflow%3A%22Lint+Code+Base%22

.. |PyPi| image:: https://img.shields.io/pypi/pyversions/NREL-rex.svg
    :target: https://pypi.org/project/NREL-rex/

.. |PythonV| image:: https://badge.fury.io/py/NREL-rex.svg
    :target: https://badge.fury.io/py/NREL-rex

.. |Conda| image:: https://anaconda.org/nrel/nrel-rex/badges/version.svg
    :target: https://anaconda.org/nrel/nrel-rex

.. |Licence| image:: https://anaconda.org/nrel/nrel-rex/badges/license.svg
    :target: https://anaconda.org/nrel/nrel-rex

.. |CodeCov| image:: https://codecov.io/gh/nrel/rex/branch/main/graph/badge.svg?token=WQ95L11SRS
    :target: https://codecov.io/gh/nrel/rex

.. |Zeonodo| image:: https://zenodo.org/badge/253541811.svg
   :target: https://zenodo.org/badge/latestdoi/253541811

.. inclusion-intro

What is rex?
=============
``rex`` stands for **REsource eXtraciton** tool.

``rex`` enables the efficient and scalable extraction, manipulation, and
computation with NRELs flagship renewable resource datasets such as: the Wind
Integration National Dataset (WIND Toolkit), the National Solar Radiation
Database (NSRDB), the Ocean Surface Wave Hindcast (US Wave) Data, and the
High-resolution downscaled climate change data (Sup3rCC).

To get started accessing NREL's datasets, see the primer on `NREL Renewable
Energy Resource Data
<https://nrel.github.io/rex/misc/examples.nrel_data.html>`_ or the
`installation instructions <https://nrel.github.io/rex/#installing-rex>`_.

You might also want to check out the basic `Resource Class
<https://nrel.github.io/rex/_autosummary/rex.resource.Resource.html>`_ that
can be used to efficiently query NREL data, or our various `example use cases
<https://nrel.github.io/rex/misc/examples.html>`_.

Installing rex
==============

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.

Option 1: Install from PIP or Conda (recommended for analysts):
---------------------------------------------------------------

1. Create a new environment:
    ``conda create --name rex``

2. Activate directory:
    ``conda activate rex``

3. Basic ``rex`` install:
    1) ``pip install NREL-rex``
    2) or ``conda install nrel-rex --channel=nrel``

4. Install for users outside of NREL that want to access data via HSDS or S3 as per the instructions `here <https://nrel.github.io/rex/misc/examples.nrel_data.html#data-location-external-users>`_:
    1) ``pip install NREL-rex[hsds]`` for more performant access of the data on HSDS with slightly more setup as per `this hsds example <https://nrel.github.io/rex/misc/examples.hsds.html>`_

Option 2: Clone repo (recommended for developers)
-------------------------------------------------

1. from home dir, ``git clone git@github.com:NREL/rex.git``

2. Create ``rex`` environment and install package
    1) Create a conda env: ``conda create -n rex``
    2) Run the command: ``conda activate rex``
    3) cd into the repo cloned in 1.
    4) prior to running ``pip`` below, make sure the branch is correct (install
       from main!)
    5) Install ``rex`` and its dependencies by running:
       ``pip install .`` (or ``pip install -e .`` if running a dev branch
       or working on the source code)

3. Check that ``rex`` was installed successfully
    1) From any directory, run the following commands. This should return the
       help pages for the CLI's.

        - ``rex``
        - ``NSRDBX``
        - ``WINDX``
        - ``US-wave``

rex command line tools
======================

- `rex <https://nrel.github.io/rex/_cli/rex.html#rex>`_
- `NSRDBX <https://nrel.github.io/rex/_cli/NSRDBX.html#NSRDBX>`_
- `WINDX <https://nrel.github.io/rex/_cli/WINDX.html#WINDX>`_
- `US-wave <https://nrel.github.io/rex/_cli/US-wave.html#US-wave>`_
- `WaveX <https://nrel.github.io/rex/_cli/WaveX.html#Wavex>`_
- `MultiYearX <https://nrel.github.io/rex/_cli/MultiYearX.html#MultiYearX>`_
- `rechunk <https://nrel.github.io/rex/_cli/rechunk.html#rechunk>`_
- `temporal-stats <https://nrel.github.io/rex/_cli/temporal-stats.html#temporal-stats>`_
- `wind-rose <https://nrel.github.io/rex/_cli/wind-rose.html#wind-rose>`_
