captest.capdata.CapData.rep_cond

CapData.rep_cond(func=None, w_vel=None, irr_bal=False, percent_filter=20, front_poa='poa', rc_kwargs={})

Calculate reporting conditions for the current regression formula.

The calculation is formula-agnostic: the right-hand-side variables of self.regression_formula drive which columns are aggregated.

The test setups defined in captest.TEST_SETUPS define values for the arguments of this method. For example, the e2848_default setup defines reporting conditions per ASTM E2939 - the POA irradiance value that exceeds 60 % of the filtered irradiance data, the mean ambient temperature, and the mean wind speed.

Use rep_cond_freq for seasonal/monthly outputs.

Parameters:

  • func (dict, str, callable, or None, default None) – When None, defaults to calculating the mean for each term on right hand side of the regression formula. Passed to df.agg(...). A dict maps rhs variable names to aggregation functions (e.g. {'poa': perc_wrap(60), 't_amb': 'mean'}).

  • w_vel (numeric or None, default None) – If not None, overrides the calculated wind speed reporting condition with this value.

  • irr_bal (bool, default False) – If True, uses ReportingIrradiance to determine the reporting irradiance (front_poa). When True, the other reporting conditions are aggregated from the subset of data within the balanced irradiance band.

  • percent_filter (int, default 20) – Percentage used to define the irradiance band around the reporting irradiance when irr_bal is True. Has no effect when irr_bal is False.

  • front_poa (str, default 'poa') – Key in self.regression_cols whose column is used as the irradiance driver when irr_bal is True.

  • rc_kwargs (dict) – Passed to ReportingIrradiance when irr_bal is True.

Returns:

Reporting conditions are stored on self.rc as a one-row DataFrame.

Return type:

None