pvlib.inverter.adr¶
-
pvlib.inverter.
adr
(v_dc, p_dc, inverter, vtol=0.1)[source]¶ Converts DC power and voltage to AC power using Anton Driesse’s grid-connected inverter efficiency model.
Parameters: - v_dc (numeric) – DC voltage input to the inverter, should be >= 0. [V]
- p_dc (numeric) – DC power input to the inverter, should be >= 0. [W]
- inverter (dict-like) – Defines parameters for the inverter model in [1]. See Notes for
required model parameters. A parameter database is provided with pvlib
and may be read using
pvlib.pvsystem.retrieve_sam()
. - vtol (numeric, default 0.1) – Fraction of DC voltage that determines how far the efficiency model is extrapolated beyond the inverter’s normal input voltage operating range. 0.0 <= vtol <= 1.0. [unitless]
Returns: power_ac (numeric) – AC power output. [W]
Notes
Determines the AC power output of an inverter given the DC voltage and DC power. Output AC power is bounded above by the parameter
Pacmax
, to represent inverter “clipping”. AC power is bounded below by-Pnt
(negative when power is consumed rather than produced) which represents self-consumption. power_ac is not adjusted for maximum power point tracking (MPPT) voltage windows or maximum current limits of the inverter.Required model parameters are:
Column Description Pnom Nominal DC power, typically the DC power needed to produce maximum AC power output. [W] Vnom Nominal DC input voltage. Typically the level at which the highest efficiency is achieved. [V] Vmax Maximum DC input voltage. [V] Vmin Minimum DC input voltage. [V] Vdcmax Maximum voltage supplied from DC array. [V] MPPTHi Maximum DC voltage for MPPT range. [V] MPPTLow Minimum DC voltage for MPPT range. [V] Pacmax Maximum AC output power, used to clip the output power if needed. [W] ADRCoefficients A list of 9 coefficients that capture the influence of input voltage and power on inverter losses, and thereby efficiency. Corresponds to terms from [1] (in order): :math: b_{0,0}, b_{1,0}, b_{2,0}, b_{0,1}, b_{1,1}, b_{2,1}, b_{0,2}, b_{1,2}, b_{2,2}. See [1] for the use of each coefficient and its associated unit. Pnt AC power consumed by inverter at night (night tare) to maintain circuitry required to sense the PV array voltage. [W] AC power output is set to NaN where the input DC voltage exceeds a limit M = max(Vmax, Vdcmax, MPPTHi) x (1 + vtol), and where the input DC voltage is less than a limit m = max(Vmin, MPPTLow) x (1 - vtol)
References
[1] (1, 2, 3) A. Driesse, “Beyond the Curves: Modeling the Electrical Efficiency of Photovoltaic Inverters”, 33rd IEEE Photovoltaic Specialist Conference (PVSC), June 2008