29/12/2016

pvl_singlediode

pvl_singlediode
SolvethesinglediodeequationtoobtainaphotovoltaicIVcurve.

Contents
Syntax
Description
Inputs
Output
Notes
Example
References:
Seealso

Syntax
[Result]=pvl_singlediode(IL,I0,Rs,Rsh,nNsVth)
[Result]=pvl_singlediode(IL,I0,Rs,Rsh,nNsVth,NumPoints)
Description
pvl_singlediodesolvesthesinglediodeequation[1]:
$$I=I_LI_0\left(\exp\left({\frac{V+IR_s}{nNsVth}}\right)1\right){\frac{V+IR_s}{R_{sh}}}$$
forIandVwhengivenIL,I0,Rs,Rsh,andnNsVth(nNsVth=nNsVth).Thenumericalsolutionusesaformulation[2]
ofthesinglediodeequationintermsoftheLambertWfunction.pvl_singlediodereturnsastructwhichcontainsthefive
pointsontheIVcurvespecifiedintheSandiaArrayPerformanceModel[3],andcanoptionallyreturnvectorsofIandV
describingthefullIVcurvewithauserdefinednumberofpoints.IfIL,I0,Rs,Rsh,andnNsVtharescalars,asingleIVcurve
willbereturnedifanyinputsarevectors(ofthesamelength),multipleIVcurveswillbecalculated.

Inputs
ILLightgeneratedcurrent(photocurrent)inamperesunderdesiredIVcurveconditions.Maybeascalarorvector,but
vectorsmustbeofsamelengthasallotherinputvectors.

I0DiodesaturationcurrentinamperesunderdesiredIVcurveconditions.Maybeascalarorvector,butvectorsmustbeof
samelengthasallotherinputvectors.

RsSeriesresistanceinohmsunderdesiredIVcurveconditions.Maybeascalarorvector,butvectorsmustbeofsame
lengthasallotherinputvectors.

RshShuntresistanceinohmsunderdesiredIVcurveconditions.Maybeascalarorvector,butvectorsmustbeofsame
lengthasallotherinputvectors.

nNsVththeproductofthreecomponents.1)Theusualdiodeidealfactor(n),2)thenumberofcellsinseries(Ns),and3)
thecellthermalvoltageunderthedesiredIVcurveconditions(Vth).Thethermalvoltageofthecell(involts)maybe
calculatedasVth=k*Tcell/q,wherekisBoltzmann'sconstant(J/K),TcellisthetemperatureofthepnjunctioninKelvin,andq
istheelementarychargeofanelectron(coulombs).nNsVthmaybeascalarorvector,butvectorsmustbeofsamelengthas
allotherinputvectors.

NumPointsNumberofpointsinthedesiredIVcurve.Mustbeafinitescalarvalue.Nonintegervalueswillberoundedto
thenexthighestinteger(ceil).IfNumPointsis>1,pvl_singlediodecomputesNumPointspointsontheIVcurvethat
areevenlyspacedinvoltagebetween0andVoc.

https://pvpmc.sandia.gov/PVLIB_Matlab_Help/html/pvl_singlediode_help.html

1/3

29/12/2016

pvl_singlediode

Output
ResultAstructurewiththefollowingfields.Allfieldshavethesamenumberofrowsasthelargestinputvector.
Result.IscColumnvectorofshortcircuitcurrentinamperes.
Result.VocColumnvectorofopencircuitvoltageinvolts.
Result.ImpColumnvectorofcurrentatmaximumpowerpointinamperes.
Result.VmpColumnvectorofvoltageatmaximumpowerpointinvolts.
Result.PmpColumnvectorofpoweratmaximumpowerpointinwatts.
Result.IxColumnvectorofcurrent,inamperes,atV=0.5*Voc.
Result.IxxColumnvectorofcurrent,inamperes,atV=0.5*(Voc+Vmp).
Result.VArrayofvoltagesinvolts.RowncorrespondstoIVcurven,withV=0intheleftmostcolumnandV=Vocinthe
rightmostcolumn.Voltagepointsareequallyspaced(involtage)between0andVoc.

Result.IArrayofcurrentsinamperes.RowncorrespondstoIVcurven,withI=IscintheleftmostcolumnandI=0inthe
rightmostcolumn.

Notes
1.ToplottheithIVcurve,use:plot(Result.V(i,:),Result.I(i,:))
2.ToplotallIVcurvesonthesameplot:plot(Result.V',Result.I')
3.GeneratingIVcurvesusingNumPointswillslowdownfunctionoperation.

Example
Exampleparametersforatypical210WcSimodule

IL=5.658;%photocurrent(A)
I0=4.629E11;%darkcurrent(A)
Rsh=269.68;%shuntresistance(ohms)
Rs=.386;%seriesresistance(ohms)
n=1.0134;%idealityfactor(diodefactor)
Ns=72;%numberofcellsinseries
k=1.3806488E23;%Boltzman'sconstantinunitsofJ/K
Tcell=25;%degC
q=1.60217646E19;%Electronchargeincoulombs
nVth=n*Ns*k*(Tcell+273.15)/q;
NumPoints=1000;
[IVResult]=pvl_singlediode(IL,I0,Rs,Rsh,nVth,NumPoints);
figure
plot(IVResult.V,IVResult.I)
holdon
scatter(IVResult.Vmp,IVResult.Imp,'filled')
xlabel('Voltage(V)')
ylabel('Current(A)')
title('ExampleIVCurvefromSingleDiodeModel','FontSize',14)
Pmax=IVResult.Pmp%MaxPowerofModule

Pmax=
210.0013

https://pvpmc.sandia.gov/PVLIB_Matlab_Help/html/pvl_singlediode_help.html

2/3

29/12/2016

pvl_singlediode

References:
[1]S.R.Wenham,M.A.Green,M.E.Watt,"AppliedPhotovoltaics"ISBN0867589094
[2]A.Jain,A.Kapoor,2004.ExactanalyticalsolutionsoftheparametersofrealsolarcellsusingLambertWfunction,Solar
EnergyMaterialsandSolarCells,81(2004)269277.
[3]D.Kingetal,"SandiaPhotovoltaicArrayPerformanceModel",SAND20043535,SandiaNationalLaboratories,Albuquerque,
NM

Seealso
pvl_calcparams_desoto,pvl_calcparams_PVsyst,pvl_calcparams_CEC,pvl_lambertw,pvl_sapm.
Copyright2014SandiaNationalLaboratories

PublishedwithMATLABR2015b

https://pvpmc.sandia.gov/PVLIB_Matlab_Help/html/pvl_singlediode_help.html

3/3