PVWatts V6

GET {{nrel_developer_url}}/pvwatts/v6.json?lat=40&lon=-105&system_capacity=4&azimuth=180&tilt=40&array_type=1&module_type=1&losses=10

PVWatts V6 (GET /api/pvwatts/v6) PVWatts Version 6 is is the current version of the PVWatts API. Updates from Version 5 include access to the Physical Solar Model (PSM) TMY and SUNY South Asia solar resource data from the NREL National Solar Radiation Database (NSRDB) by default, with optional access to the legacy solar resource data: NSRDB MTS2 1991-2005 Update (TMY3), NSRDB MTS1 1961-1990 (TMY2), and NREL international station data. PVWatts Version 6 also sets the default DC-to-AC ratio to 1.2 instead of 1.1, but you can specify a different DC to AC ratio for your simulation. For a complete description of PVWatts V6, see the description on the PVWatts website

The algorithms used to calculate energy output are the same as in Version 5. For a technical description of the model, see Dobos, A. P. PVWatts Version 5 Manual. NREL/TP-6A20-62641, 2014.

Response Fields The response is composed of service-related informational fields and the results of the data query.

FieldValueDescription
inputsType: collectionThe input parameters received in the request.
errorsType: array of stringsAny error messages resulting from the request.
warningsType: array of stringsAny warning messages resulting from the request.
versionType: stringThe current version of the web service.
ssc_infoType: collectionInformation about the SSC library.
station_infoType: collectionInformation about the climate data used in the simulation. (see station info fields for more detail)
outputsType: collectionThe data outputs from the simulation. (see output fields for more detail)
latType: decimalLatitude of the climate station.
lonType: decimalLongitude of the climate station.
elevType: decimalElevation of the climate station. (meters)
tzType: decimalTimezone offset from GMT.
locationType: stringID of the climate station.
cityType: stringCity where climate station is located.
stateType: stringState where climate station is located.
solarresourcefileType: stringSolar resource filename.
distanceType: integerDistance between the input location and the climate station. (meters)
poa_monthlyType: array of decimalMonthly plane of array irradiance values. (kWh/m2) The array of values represents the value for each month, with the first element being for January and the last element being for December.
dc_monthlyType: array of decimalMonthly DC array output. (kWhdc) The array of values represents the value for each month, with the first element being for January and the last element being for December.
ac_monthlyType: array of decimal
ac_annualType: decimalAnnual AC system output. (kWhac)
solrad_monthlyType: array of decimalMonthly solar radiation values. (kWh/m2/day) The array of values represents the value for each month, with the first element being for January and the last element being for December.
solrad_annualType: decimalAnnual solar radiation values. (kWh/m2/day)
capacity_factorType: decimalThe ratio of the system's predicted electrical output in the first year of operation to the nameplate output, which is equivalent to the quantity of energy the system would generate if it operated at its nameplate capacity for every hour of the year. (AC-to-DC)
acType: array of decimalHourly AC system output (only when timeframe=hourly). (Wac)
poaType: array of decimalHourly plane of array irradiance (only when timeframe=hourly). (W/m2)
dnType: array of decimalHourly beam normal irradiance (only when timeframe=hourly). (W/m2)
dcType: array of decimalHourly DC array output (only when timeframe=hourly). (Wdc)
dfType: array of decimalHourly diffuse irradiance (only when timeframe=hourly). (W/m2)
tambType: array of decimalHourly ambient temperature (only when timeframe=hourly). (C)
tcellType: array of decimalHourly module temperature (only when timeframe=hourly) (C)
wspdType: array of decimalHourly windspeed (only when timeframe=hourly). (m/s)

Request Params

KeyDatatypeRequiredDescription
latnumber
lonnumber
system_capacitynumber
azimuthnumberType: decimal
Default: None
Min: 0
Max: < 360
tiltnumberType: decimal
Default: None
Range: 0 to 90
Tilt angle (degrees).
array_typenumber
module_typenumber
lossesnumber
addressnullType: string
Default: None
The address to use. Required if lat/lon or file_id not specified.
datasetnullType: string
Default: nsrdb
Options: nsrdb, tmy2, tmy3, intl
The climate dataset to use. Should not be passed in if using file_id to specify the climate data file.

Option Description nsrdb NREL Physical Solar Model (PSM) TMY from the NREL National Solar Radiation Database (NSRDB) (see nsrdb.nrel.gov/about)

tmy2 TMY2 station data (see Typical Meteorological Year, version 2)

tmy3 TMY3 station data (see Typical Meteorological Year version 3)

intl International station data | | radius | number | | Type: integer Default: 100 The search radius to use when searching for the closest climate data station (miles). Pass in radius=0 to use the closest station regardless of the distance. | | timeframe | string | | Type: string Default: monthly Options: monthly, hourly Granularity of the output response. | | dc_ac_ratio | string | | Type: decimal Default: 1.2 Range: must be positive DC to AC ratio. | | gcr | string | | Type: decimal Default: 0.4 Range: 0 - 3 Ground coverage ratio. | | inv_eff | number | | Type: decimal Default: 96 Range: 90 - 99.5 Inverter efficiency at rated power. | | callback | null | | Type: string Default: None Return the data using JSONP and the given callback function (only applicable when using the json format). |

RESPONSES

status: OK

{&quot;inputs&quot;:{&quot;lat&quot;:&quot;40&quot;,&quot;lon&quot;:&quot;-105&quot;,&quot;system_capacity&quot;:&quot;4&quot;,&quot;azimuth&quot;:&quot;180&quot;,&quot;tilt&quot;:&quot;40&quot;,&quot;array_type&quot;:&quot;1&quot;,&quot;module_type&quot;:&quot;1&quot;,&quot;losses&quot;:&quot;10&quot;},&quot;errors&quot;:[],&quot;warnings&quot;:[],&quot;version&quot;:&quot;1.0.2&quot;,&quot;ssc_info&quot;:{&quot;version&quot;:45,&quot;build&quot;:&quot;Linux 64 bit GNU/C++ Jul  7 2015 14:24:09&quot;},&quot;station_info&quot;:{&quot;lat&quot;:40.0099983215332,&quot;lon&quot;:-105.0199966430664,&quot;elev&quot;:1581.839965820312,&quot;tz&quot;:-7,&quot;location&quot;:&quot;None&quot;,&quot;city&quot;:&quot;&quot;,&quot;state&quot;:&quot;Colorado&quot;,&quot;solar_resource_file&quot;:&quot;W10502N4001.csv&quot;,&quot;distance&quot;:2029},&quot;outputs&quot;:{&quot;ac_monthly&quot;:[474.4326171875,484.3903503417969,595.7704467773438,592.0599365234375,591.2662353515625,589.3538208007812,583.2352905273438,586.4593505859375,584.8131713867188,561.72314453125,486.1260375976562,445.6881713867188],&quot;poa_monthly&quot;:[141.4809417724609,145.5711975097656,184.7876434326172,181.5513763427734,186.4280853271484,190.5132904052734,188.7499694824219,190.5398101806641,188.2213134765625,175.4444122314453,146.3170471191406,131.1568298339844],&quot;solrad_monthly&quot;:[4.563901424407959,5.198971271514893,5.960891723632812,6.051712512969971,6.013809204101562,6.350442886352539,6.088708877563477,6.146445274353027,6.274043560028076,5.659497261047363,4.877234935760498,4.230865478515625],&quot;dc_monthly&quot;:[497.9421081542969,511.1524963378906,634.3223266601562,623.7313842773438,617.8812866210938,615.4278564453125,609.3965454101562,612.7506713867188,610.5584106445312,588.6157836914062,508.0747680664062,465.4272155761719],&quot;ac_annual&quot;:6575.31884765625,&quot;solrad_annual&quot;:5.618043899536133,&quot;capacity_factor&quot;:18.76517868041992}}