| Name | NREL-rex JSON |
| Version |
0.4.3
JSON |
| download |
| home_page | None |
| Summary | National Renewable Energy Laboratory's (NREL's) REsource eXtraction tool: rex |
| upload_time | 2025-07-11 23:20:33 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | None |
| keywords |
rex
nrel
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
**********************************************
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>`_. Note that the highest version of Python currently supported by ``hsds`` is Python 3.11.
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>`_
Raw data
{
"_id": null,
"home_page": null,
"name": "NREL-rex",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "Grant Buster <gbuster@nrel.gov>, Paul Pinchuk <ppinchuk@nrel.gov>, Brandon Benton <brandon.benton@nrel.gov>",
"keywords": "rex, NREL",
"author": null,
"author_email": "Michael Rossol <michael.rossol@nrel.gov>",
"download_url": "https://files.pythonhosted.org/packages/4c/4e/28f828fb5999f9d495a68b4705422747a3641a536667fbc9b97c57662437/nrel_rex-0.4.3.tar.gz",
"platform": null,
"description": "**********************************************\nWelcome to The REsource eXtraction (rex) tool!\n**********************************************\n\n|Docs| |Tests| |Linter| |PyPi| |PythonV| |Conda| |Licence| |CodeCov| |Zeonodo|\n\n.. |Docs| image:: https://github.com/NREL/rex/workflows/Documentation/badge.svg\n :target: https://nrel.github.io/rex/\n\n.. |Tests| image:: https://github.com/NREL/rex/workflows/Pytests/badge.svg\n :target: https://github.com/NREL/rex/actions?query=workflow%3A%22Pytests%22\n\n.. |Linter| image:: https://github.com/NREL/rex/workflows/Lint%20Code%20Base/badge.svg\n :target: https://github.com/NREL/rex/actions?query=workflow%3A%22Lint+Code+Base%22\n\n.. |PyPi| image:: https://img.shields.io/pypi/pyversions/NREL-rex.svg\n :target: https://pypi.org/project/NREL-rex/\n\n.. |PythonV| image:: https://badge.fury.io/py/NREL-rex.svg\n :target: https://badge.fury.io/py/NREL-rex\n\n.. |Conda| image:: https://anaconda.org/nrel/nrel-rex/badges/version.svg\n :target: https://anaconda.org/nrel/nrel-rex\n\n.. |Licence| image:: https://anaconda.org/nrel/nrel-rex/badges/license.svg\n :target: https://anaconda.org/nrel/nrel-rex\n\n.. |CodeCov| image:: https://codecov.io/gh/nrel/rex/branch/main/graph/badge.svg?token=WQ95L11SRS\n :target: https://codecov.io/gh/nrel/rex\n\n.. |Zeonodo| image:: https://zenodo.org/badge/253541811.svg\n :target: https://zenodo.org/badge/latestdoi/253541811\n\n.. inclusion-intro\n\nWhat is rex?\n=============\n``rex`` stands for **REsource eXtraciton** tool.\n\n``rex`` enables the efficient and scalable extraction, manipulation, and\ncomputation with NRELs flagship renewable resource datasets such as: the Wind\nIntegration National Dataset (WIND Toolkit), the National Solar Radiation\nDatabase (NSRDB), the Ocean Surface Wave Hindcast (US Wave) Data, and the\nHigh-resolution downscaled climate change data (Sup3rCC).\n\nTo get started accessing NREL's datasets, see the primer on `NREL Renewable\nEnergy Resource Data\n<https://nrel.github.io/rex/misc/examples.nrel_data.html>`_ or the\n`installation instructions <https://nrel.github.io/rex/#installing-rex>`_.\n\nYou might also want to check out the basic `Resource Class\n<https://nrel.github.io/rex/_autosummary/rex.resource.Resource.html>`_ that\ncan be used to efficiently query NREL data, or our various `example use cases\n<https://nrel.github.io/rex/misc/examples.html>`_.\n\nInstalling rex\n==============\n\nNOTE: The installation instruction below assume that you have python installed\non your machine and are using `conda <https://docs.conda.io/en/latest/index.html>`_\nas your package/environment manager.\n\nOption 1: Install from PIP or Conda (recommended for analysts):\n---------------------------------------------------------------\n\n1. Create a new environment:\n ``conda create --name rex``\n\n2. Activate directory:\n ``conda activate rex``\n\n3. Basic ``rex`` install:\n 1) ``pip install NREL-rex``\n 2) or ``conda install nrel-rex --channel=nrel``\n\n4. 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>`_:\n 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>`_. Note that the highest version of Python currently supported by ``hsds`` is Python 3.11.\n\nOption 2: Clone repo (recommended for developers)\n-------------------------------------------------\n\n1. from home dir, ``git clone git@github.com:NREL/rex.git``\n\n2. Create ``rex`` environment and install package\n 1) Create a conda env: ``conda create -n rex``\n 2) Run the command: ``conda activate rex``\n 3) cd into the repo cloned in 1.\n 4) prior to running ``pip`` below, make sure the branch is correct (install\n from main!)\n 5) Install ``rex`` and its dependencies by running:\n ``pip install .`` (or ``pip install -e .`` if running a dev branch\n or working on the source code)\n\n3. Check that ``rex`` was installed successfully\n 1) From any directory, run the following commands. This should return the\n help pages for the CLI's.\n\n - ``rex``\n - ``NSRDBX``\n - ``WINDX``\n - ``US-wave``\n\nrex command line tools\n======================\n\n- `rex <https://nrel.github.io/rex/_cli/rex.html#rex>`_\n- `NSRDBX <https://nrel.github.io/rex/_cli/NSRDBX.html#NSRDBX>`_\n- `WINDX <https://nrel.github.io/rex/_cli/WINDX.html#WINDX>`_\n- `US-wave <https://nrel.github.io/rex/_cli/US-wave.html#US-wave>`_\n- `WaveX <https://nrel.github.io/rex/_cli/WaveX.html#Wavex>`_\n- `MultiYearX <https://nrel.github.io/rex/_cli/MultiYearX.html#MultiYearX>`_\n- `rechunk <https://nrel.github.io/rex/_cli/rechunk.html#rechunk>`_\n- `temporal-stats <https://nrel.github.io/rex/_cli/temporal-stats.html#temporal-stats>`_\n- `wind-rose <https://nrel.github.io/rex/_cli/wind-rose.html#wind-rose>`_\n",
"bugtrack_url": null,
"license": null,
"summary": "National Renewable Energy Laboratory's (NREL's) REsource eXtraction tool: rex",
"version": "0.4.3",
"project_urls": {
"documentation": "https://nrel.github.io/rex/",
"homepage": "https://www2.nrel.gov/gis/renewable-energy-potential",
"repository": "https://github.com/NREL/rex"
},
"split_keywords": [
"rex",
" nrel"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a066404e1cea32ebd39f519d757b7c0c9e5a71e0ce2bac4a70d2098d3ab248f3",
"md5": "e14da7664427acb17a6e9dc8bcbabec7",
"sha256": "9e44813f5f022990d3d33a7aab0685522b40c651539b227e29ce9aaa239ac886"
},
"downloads": -1,
"filename": "nrel_rex-0.4.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e14da7664427acb17a6e9dc8bcbabec7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 177518,
"upload_time": "2025-07-11T23:20:31",
"upload_time_iso_8601": "2025-07-11T23:20:31.779063Z",
"url": "https://files.pythonhosted.org/packages/a0/66/404e1cea32ebd39f519d757b7c0c9e5a71e0ce2bac4a70d2098d3ab248f3/nrel_rex-0.4.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "4c4e28f828fb5999f9d495a68b4705422747a3641a536667fbc9b97c57662437",
"md5": "a8840e0c5b83d28d25d17c744d9d7213",
"sha256": "64d99795e7c9a901252321af288000c6d5bccea8e80fa47ad540f39b2a507ba7"
},
"downloads": -1,
"filename": "nrel_rex-0.4.3.tar.gz",
"has_sig": false,
"md5_digest": "a8840e0c5b83d28d25d17c744d9d7213",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 152135,
"upload_time": "2025-07-11T23:20:33",
"upload_time_iso_8601": "2025-07-11T23:20:33.246272Z",
"url": "https://files.pythonhosted.org/packages/4c/4e/28f828fb5999f9d495a68b4705422747a3641a536667fbc9b97c57662437/nrel_rex-0.4.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-11 23:20:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "NREL",
"github_project": "rex",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "nrel-rex"
}
