NRWAL

A library of offshore wind cost equations.
https://github.com/NREL/NRWAL

Category: Renewable Energy
Sub Category: Wind Energy

Keywords from Contributors

climate-data renewable-energy solar-energy

Last synced: about 16 hours ago
JSON representation

Repository metadata

The National Renewable Energy Laboratory Wind Analysis Libray (NRWAL)

• Host: GitHub
• URL: https://github.com/NREL/NRWAL
• Owner: NREL
• License: bsd-3-clause
• Created: 2020-12-07T16:23:18.000Z (about 5 years ago)
• Default Branch: main
• Last Pushed: 2025-08-13T22:21:11.000Z (4 months ago)
• Last Synced: 2025-12-07T17:53:27.548Z (19 days ago)
• Language: Python
• Homepage: https://nrel.github.io/NRWAL/
• Size: 3.03 MB
• Stars: 21
• Watchers: 4
• Forks: 14
• Open Issues: 1
• Releases: 12
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

README.rst

          *****************
Welcome to NRWAL!
*****************

.. image:: https://github.com/NREL/NRWAL/workflows/Documentation/badge.svg
    :target: https://nrel.github.io/NRWAL/

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

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

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

.. image:: https://badge.fury.io/py/NREL-NRWAL.svg
    :target: https://badge.fury.io/py/NREL-NRWAL

.. image:: https://anaconda.org/nrel/nrel-NRWAL/badges/version.svg
    :target: https://anaconda.org/nrel/nrel-NRWAL

.. image:: https://anaconda.org/nrel/nrel-NRWAL/badges/license.svg
    :target: https://anaconda.org/nrel/nrel-NRWAL

.. image:: https://codecov.io/gh/nrel/NRWAL/branch/main/graph/badge.svg?token=NB29X039VU
   :target: https://codecov.io/gh/nrel/NRWAL

.. image:: https://zenodo.org/badge/319377095.svg
   :target: https://zenodo.org/badge/latestdoi/319377095

.. image:: https://mybinder.org/badge_logo.svg
    :target: https://mybinder.org/v2/gh/NREL/NRWAL/HEAD


.. inclusion-intro

The National Renewable Energy Laboratory Wind Analysis Library (NRWAL):

#. A library of offshore wind cost equations (plus new energy technologies like marine hydro!)
#. Easy equation manipulation without editing source code
#. Full continental-scale integration with the NREL Renewable Energy Potential Model (reV)
#. Ready-to-use configs for basic users
#. Dynamic python tools for intuitive equation handling
#. One seriously badass sea unicorn

To get started with NRWAL, check out the `NRWAL Config documentation `_ or the `NRWAL example notebook `_. You can also launch the notebook in an interactive jupyter shell right in your browser without any downloads or software using `binder `_. 

Ready to build a model with NRWAL but don't want to contribute to the library? No problem! Check out the example getting started project `here `_.

Here is the important stuff:

 - `The NRWAL Equation Library `_.
 - `Default NRWAL Configs `_.

Installing NRWAL
================

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

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

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

3. Install reVX:
    1) ``pip install NREL-NRWAL`` or
    2) ``conda install nrel-nrwal --channel=nrel``

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

1. from home dir, ``git clone https://github.com/NREL/NRWAL.git``
    1) enter github username
    2) enter github password

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

NRWAL Variables for Offshore Wind (OSW)
=======================================

.. list-table:: NRWAL Inputs
    :widths: auto
    :header-rows: 1

    * - Variable Name
      - Long Name
      - Source
      - Units
    * - `aeff`
      - Array Efficiency
      - `array_efficiency` input layer, computed from ORBIT
      - `%`
    * - `capex_multi`
      - CAPEX Multiplier
      - Supplied by user
      - unit-less
    * - `depth`
      - Water depth (positive values)
      - `bathymetry` input layer
      - m
    * - `dist_a_to_s`
      - Distance from assembly area to site
      - Computed from `assembly_area` input layer
      - km
    * - `dist_op_to_s`
      - Distance from operating port to site
      - `ports_operations` input layer
      - km
    * - `dist_p_to_a`
      - Distance from port (construction no-limit) to assembly area
      - `assembly_area` input layer
      - km
    * - `dist_p_to_s`
      - Distance from construction port to site
      - `ports_construction` input layer
      - km
    * - `dist_p_to_s_nolimit`
      - Distance from no-limit construction port to site
      - `ports_construction_nolimit` input layer
      - km
    * - `dist_s_to_l`
      - Distance site to nearest land
      - `dist_to_coast` input layer
      - km
    * - `fixed_downtime`
      - Average weather downtime for fixed structure turbines
      - `weather_downtime_fixed_bottom` input layer
      - fraction
    * - `floating_downtime`
      - Average weather downtime for floating structure turbines
      - `weather_downtime_floating` input layer
      - fraction
    * - `gcf`
      - Gross capacity factor
      - Computed by reV / SAM with losses == 0
      - unit-less
    * - `hs_average`
      - Significant wave height to determine weather downtime
      - `weather_downtime_mean_wave_height_buoy` input layer
      - m
    * - `num_turbines`
      - Number of turbines in array
      - Supplied by user
      - unit-less
    * - `transmission_multi`
      - Tranmission cost multiplier
      - Supplied by user
      - unit-less
    * - `turbine_capacity`
      - Capacity of each turbine in the array
      - Supplied by user
      - MW

Recommended Citation
====================

If using the NRWAL software (replace with current version and DOI):

 - Grant Buster, Jake Nunemaker, and Michael Rossol. The National Renewable Energy Laboratory Wind Analysis Library (NRWAL). https://github.com/NREL/NRWAL (version v0.0.2), 2021. https://doi.org/10.5281/zenodo.4705961.

If using the Offshore Wind (OSW) cost equations:

 - Beiter, Philipp, Walter Musial, Aaron Smith, Levi Kilcher, Rick Damiani, Michael Maness, Senu Sirnivas, Tyler Stehly, Vahan Gevorgian, Meghan Mooney, and George Scott. “A Spatial-Economic Cost-Reduction Pathway Analysis for U.S. Offshore Wind Energy Development from 2015–2030.” National Renewable Energy Lab. (NREL), Golden, CO (United States), September 1, 2016. https://doi.org/10.2172/1324526. https://www.nrel.gov/docs/fy16osti/66579.pdf.

If using the marine energy reference model (RM) cost models:

 - https://energy.sandia.gov/programs/renewable-energy/water-power/projects/reference-model-project-rmp/
 - Jenne, D. S., Y. H. Yu, and V. Neary. “Levelized Cost of Energy Analysis of Marine and Hydrokinetic Reference Models: Preprint.” National Renewable Energy Lab. (NREL), Golden, CO (United States), April 24, 2015. https://www.osti.gov/biblio/1215196-levelized-cost-energy-analysis-marine-hydrokinetic-reference-models-preprint.

        

---

Owner metadata

• Name: National Renewable Energy Laboratory
• Login: NREL
• Email:
• Kind: organization
• Description:
• Website: http://www.nrel.gov
• Location: Golden, CO
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/1906800?v=4
• Repositories: 599
• Last ynced at: 2024-12-18T09:41:07.898Z
• Profile URL: https://github.com/NREL

---

GitHub Events

Total

• Watch event: 2
• Member event: 1
• Push event: 10
• Pull request event: 1
• Fork event: 9
• Create event: 2

Last Year

• Member event: 1
• Push event: 10
• Pull request event: 1
• Fork event: 9
• Create event: 2

---

Committers metadata

Last synced: 4 days ago

Name	Email	Commits
grantbuster	g****r@n****v	118
Jake Nunemaker	j****r@g****m	30
ppinchuk	p****k@n****v	22
Michael Rossol	m****l@g****m	17
Patrick Duffy	P****y@n****v	15
Gabriel Zuckerman	g****m@e****v	11
Travis Williams	t****s@n****v	9
Rebecca Rolph	r****h@e****v	7
Gabriel Zuckerman	g****m@e****v	7
Pavlo Pinchuk	p****k@e****v	6
Pavlo Pinchuk	p****k@e****v	5
Gabriel Zuckerman	g****m@e****v	4
Gabe Zuckerman	g****n@b****u	1

Committer domains:

• nrel.gov: 4
• el3.ib0.cm.hpc.nrel.gov: 3
• el1.ib0.cm.hpc.nrel.gov: 2
• berkeley.edu: 1
• el2.ib0.cm.hpc.nrel.gov: 1

---

Issue and Pull Request metadata

Last synced: 3 months ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/NREL/NRWAL

---

---

---

Package metadata

• Total packages: 3
• Total downloads:
  • pypi: 1,117 last-month
• Total dependent packages: 1 (may contain duplicates)
• Total dependent repositories: 1 (may contain duplicates)
• Total versions: 35
• Total maintainers: 3

---

Dependencies

Score: 12.678859896902495