Questions regarding pvwattsfunc in SSC

First, thank you for making the SDK available! Some background on what I'm doing: I'm currently creating a Simulink interface to the pvwattsfunc module of SSC so that PV output calculations can be embedded within Simulink simulations. To do this, I need to understand the pvwattsfunc inputs and outputs in detail. I have three questions (at the moment) regarding the way the pvwattsfunc module works: 1. How exactly is the time zone input 'tz' specified? (For mountain date time, I tried -6 (for GMT -6), but this gave zero outputs at a time of 12 noon. Using +6 instead gave the expected result, but as a result I don't understand how the time zones are numbered.) 2. How does pvwattsfunc window the input data to calculate average power? I assume it calculates performance over the time window [start time] -> [start time + time step], i.e. from 12:00 PM to 12:30 PM for a start time of 12:00 and a time step of 0.5 hours. 3. How exactly does pvwattsfunc use the Input/Output variables 'tcell' (cell temperature) and 'poa' (Place of array irradiance)? From experimentation, it appears that: i. Adjusting the input value of 'tcell' has no effect on simulation results, but ii. Adjusting the input value of 'poa' affects the output values of 'tcell', 'dc' (DC power), and 'ac' (AC power). It seems that the input value of 'poa' is somehow used to estimate an initial cell temperature and the initial cell temperature specified by 'tcell' is ignored? Could you clarify this? Thank you! Steve Frank FYI: I did check the existing literature on PVWatts from sam.nrel.gov/reference and from the SAM help. It is not enlightening on these points since it all describes running a full year simulation in PVWatts.

Hi Paul,

Thank you for the replies, especially confirming my initial interpretation of the timezone. After further investigation, it was a sign error in the longitude that was causing the zero output.

I'm afraid I still do not understand your explanation of Tcell:
"The Tcell input is the cell temperature in the preceding time step. The Tcell output is the cell temperature in the current time step." -- This makes sense to me.
"Adjusting the Tcell input in the current time step has no effect on any results in the current time step because it only affects results in the next time step." -- This, however, does not. It would seem that with any short timestep model of cell thermal mass, the cell temperature in the previous time step should affect the final temperature of this time step. IE, if I ran the module sequentially, then the cell temperature output from one time step should logically be the input for the next. Saving that the temperature "has no effect on any results in the current time step" implies some type of internal memory buffer to the module such that if I set a temperature now and run the module, I will see no change, but if I then reset the values in the Tcell and poa fields and run the module a second time, I should see a change?

Thanks,

Steve

Hi Paul,

Thanks for the clarification. It sounds like I do have the right interpretation of what is happening. Still, its odd: changing the input value of 'tcell' to any number prior to calling the module has no effect on the returned output power or cell temperature---out to at least 6 decimal places. (The exception is inputting physically impossible values, that is, less than absolute zero. Those produce NaN's in the output). I'm using a very small time step (1 minute), so I would expect the input cell temperature to have a noticeable impact on the output cell temperature.

On the other hand, changing the input value of 'poa' has a very noticeable effect on the output powers and cell temperature. (I assume the direct effect is on cell temperature and power is affected indirectly.)

Understanding this behavior is probably not critical to my application, since I plan to feed it the previous time steps values of 'tcell' and 'poa' anyway. However, I'm curious as to what's happening behind the scenes.

I have a minimal example written for the MATLAB interface, but I haven't found a good way to upload the file. Instead, I will copy it into a separate comment.

Thanks,

Steve

%% PVWatts function module in SSC (pvwattsfunc) - example
% This is the MATLAB example that accompanies my previous comment
% (Sorry that it does not display monospaced in the forum.)

% Load SSC
SSC.ssccall('load');

% Create & populate data container
data = SSC.ssccall('data_create');
SSC.ssccall('data_set_number', data, 'year', 2012);
SSC.ssccall('data_set_number', data, 'month', 6);
SSC.ssccall('data_set_number', data, 'day', 21);
SSC.ssccall('data_set_number', data, 'hour', 12);
SSC.ssccall('data_set_number', data, 'minute', 0);
SSC.ssccall('data_set_number', data, 'lat', 39.742);
SSC.ssccall('data_set_number', data, 'lon', -105.18);
SSC.ssccall('data_set_number', data, 'tz', -6); % UTC offset
SSC.ssccall('data_set_number', data, 'beam', 970); % W/m2
SSC.ssccall('data_set_number', data, 'diffuse', 86); % W/m2
SSC.ssccall('data_set_number', data, 'tamb', 25.4); % deg C
SSC.ssccall('data_set_number', data, 'wspd', 3.6); % m/s
SSC.ssccall('data_set_number', data, 'time_step', 1/60); % 1 min
SSC.ssccall('data_set_number', data, 'system_size', 100); % kW
SSC.ssccall('data_set_number', data, 'track_mode', 0); % Fixed
SSC.ssccall('data_set_number', data, 'azimuth', 180); % South facing
SSC.ssccall('data_set_number', data, 'tilt', 40); % deg
SSC.ssccall('data_set_number', data, 'derate', 0.95);

% Initialize IN/OUT variables - modify here to see effect on cell temp
SSC.ssccall('data_set_number', data, 'tcell', 25); % deg C
SSC.ssccall('data_set_number', data, 'poa', 1000); % W/m2

% Create pvwattsfunc module
module = SSC.ssccall('module_create', 'pvwattsfunc');

% Run the simulation
ok = SSC.ssccall('module_exec', module, data);

% Check for errors
if ~ok
% Get error messages
i = 0;
msg = '';
while true,
err = SSC.ssccall('module_log', module, i);
if strcmp(err,''),
break;
else
msg = [msg err '\n'];
i = i + 1;
end
end

% Throw error
error('runSSC:sscError', );
end

% Display results
fprintf('%s:\t%f\t(%s)\n', 'dc', ...
SSC.ssccall('data_get_number', data, 'dc'), 'W');
fprintf('%s:\t%f\t(%s)\n', 'ac', ...
SSC.ssccall('data_get_number', data, 'ac'), 'W');
fprintf('%s:\t%f\t(%s)\n', 'tcell', ...
SSC.ssccall('data_get_number', data, 'tcell'), 'deg C');
fprintf('%s:\t%f\t(%s)\n', 'poa', ...
SSC.ssccall('data_get_number', data, 'poa'), 'W/m2');
disp(' ');

% Clean up
SSC.ssccall('module_free', module);
SSC.ssccall('data_free', data);
SSC.ssccall('unload');