reskit.wind.economic.onshore_cost_model
=======================================

.. py:module:: reskit.wind.economic.onshore_cost_model


Functions
---------

.. autoapisummary::

   reskit.wind.economic.onshore_cost_model.onshore_turbine_capex
   reskit.wind.economic.onshore_cost_model.onshore_tcc
   reskit.wind.economic.onshore_cost_model.onshore_bos


Module Contents
---------------

.. py:function:: onshore_turbine_capex(capacity, hub_height, rotor_diam, base_capex=None, base_capacity=None, base_hub_height=None, base_rotor_diam=None, tcc_share=None, bos_share=None)

   A cost and scaling model (CSM) to calculate the total cost of a 3-bladed, direct drive onshore wind turbine according to Fingersh et al. [1] and Maples et al. [2].
   A CSM normalization is done such that a chosen baseline turbine, with a capacity of 4200 kW, hub height of 120 m, and rotor diameter of 136 m, corresponds to a expected typical specific cost of 1100 Eur/kW in a 2050 European context according to Ryberg et al. [4]
   The turbine cost includes the turbine capital cost (TCC) and balance of system costs (BOS), amounting to 67.3% and 22.9% respectively [3], as well as finantial costs equivalent to the the complementary percentage.


   :param capacity: Turbine's nominal capacity in kW.
   :type capacity: numeric or array-like
   :param hub_height: Turbine's hub height in m.
   :type hub_height: numeric or array-like
   :param rotor_diam: Turbine's hub height in m.
   :type rotor_diam: numeric or array-like
   :param base_capex: The baseline turbine's capital costs in €, by default 1100*4200 [€/kW * kW]
   :type base_capex: numeric, optional
   :param base_capacity: The baseline turbine's capacity in kW, by default 4200
   :type base_capacity: int, optional
   :param base_hub_height: The baseline turbine's hub height in m, by default 120
   :type base_hub_height: int, optional
   :param base_rotor_diam: The baseline turbine's rotor diameter in m, by default 136
   :type base_rotor_diam: int, optional
   :param tcc_share: The baseline turbine's turbine capital cost (TCC) percentage contribution in the total cost, by default 0.673
   :type tcc_share: float, optional
   :param bos_share: The baseline turbine's balance of system costs (BOS) percentage contribution in the total cost, by default 0.229
   :type bos_share: float, optional

   :returns: Onshore turbine total cost
   :rtype: numeric or array-like

   .. rubric:: Notes

   The expected turbine cost shares by Stehly et al. [3] are claimed to be derived from real cost data and valid until 10 MW capacity.

   Sources
   -------
   [1] Fingersh, L., Hand, M., & Laxson, A. (2006). Wind Turbine Design Cost and Scaling Model. NREL. https://www.nrel.gov/docs/fy07osti/40566.pdf
   [2] Maples, B., Hand, M., & Musial, W. (2010). Comparative Assessment of Direct Drive High Temperature Superconducting Generators in Multi-Megawatt Class Wind Turbines. Energy. https://doi.org/10.2172/991560
   [3] Stehly, T., Heimiller, D., & Scott, G. (2016). Cost of Wind Energy Review. Technical Report. https://www.nrel.gov/docs/fy18osti/70363.pdf
   [4] Ryberg, D. S., Caglayan, D. G., Schmitt, S., Linßen, J., Stolten, D., & Robinius, M. (2019). The future of European onshore wind energy potential: Detailed distribution and simulation of advanced turbine designs. Energy. https://doi.org/10.1016/j.energy.2019.06.052


.. py:function:: onshore_tcc(cp, hh, rd, gdp_escalator=None, blade_material_escalator=None, blades=None)

   A function to determine the turbine capital cost (TCC) of a 3 blade standard onshore wind turbine based capacity, hub height and rotor diameter values according to the cost model by Fingersh et al. [1].

   :param cp: Turbine's capacity in kW
   :type cp: numeric or array-like
   :param hh: Turbine's hub height in m
   :type hh: numeric or array-like
   :param rd: Turbine's rotor diameter in m
   :type rd: numeric or array-like
   :param gdp_escalator: Labor cost escalator, by default 1
   :type gdp_escalator: int, optional
   :param blade_material_escalator: Blade material cost escalator, by default 1
   :type blade_material_escalator: int, optional
   :param blades: Number of blades, by default 3
   :type blades: int, optional

   :returns: Turbine's turbine capital cost (TCC) in monetary units.
   :rtype: numeric or array-like

   .. rubric:: References

   [1] Fingersh, L., Hand, M., & Laxson, A. (2006). Wind Turbine Design Cost and Scaling Model. NREL. https://www.nrel.gov/docs/fy07osti/40566.pdf


.. py:function:: onshore_bos(cp, hh, rd)

   A function to determine the balance of the system cost (BOS) of an onshore turbine based on the capacity, hub height and rotor diameter values according to Fingersh et al. [1].

   :param cp: Turbine's capacity in kW
   :type cp: numeric or array-like
   :param hh: Turbine's hub height in m
   :type hh: numeric or array-like
   :param rd: Turbine's rotor diameter in m
   :type rd: numeric or array-like

   :returns: Turbine's balance of system costs (BOS) in monetary units.
   :rtype: numeric or array-like

   .. rubric:: References

   [1] Fingersh, L., Hand, M., & Laxson, A. (2006). Wind Turbine Design Cost and Scaling Model. NREL. https://www.nrel.gov/docs/fy07osti/40566.pdf


