sunpeek.core_methods.pc_method.main.PCSettings

class sunpeek.core_methods.pc_method.main.PCSettings(method, formula, **kwargs)

Bases: object

PC Method settings: Holds defaults, parses and validates a PC method settings dictionary, replacing None or missing settings with defaults.

safety_pipesfloat (optional)

Safety factor considering heat losses from pipes etc. in the collector loop. To be estimated based on an evaluation of the pipe losses - normally only a few %. Default: None (0.98)

safety_uncertaintyfloat (optional)

Safety factor considering measurement uncertainty. To be estimated - with the requirements given in 6.1, a factor of 0.9 - 0.95 could be recommended depending on accuracy level. Default: None (will be set according to plant_measurement_accuracy)

safety_others: float (optional)

Safety factor for other uncertainties e.g. related to non-ideal conditions such as: • non-ideal flow distribution. To be estimated - should be close to one. • unforeseen heat losses. To be estimated - should be close to one. • uncertainties in the model/procedure itself. To be estimated - should be close to one. Note - it is recommended to put fO ≤ 1 when eq. (1) is used, as eq. (1) does not consider the influence of incidence angle modifiers. Default: None (will be set according to used formula)

accuracy_level{“I”, “II”, “III”} (optional)

Level of accuracy of sensor as specified in ISO chapter 6. Will only be used for reporting and does not influence the output of the pc method.

interval_lengthdt.datetime (optional)

Length of the interval over which single data records are averaged. This is set to 1 hour in the ISO 24194 standard, but can be changed for PCMethodExtended.

max_nan_densityfloat (optional)

maximum percentage of missing data allowed per interval. Intervals which have higher nan density will be discarded. 0 = no NaNs allowed, 1 = all NaNs is ok.

min_data_in_intervalint (optional)

Minimum non-NaN values per interval (defined by self.settings.interval_length). The default value of 20 is stated in ISO 24194 chapter 6.2. Explanation: Independently of NaNs, the situation could arise where there are only a few values in an interval, and it doesn’t make much sense to include such intervals.

max_gap_in_intervaldt.timedelta

Even if an interval has a minimum number of intervals (at least min_data_in_interval), those records might be clustered e.g. at the beginning or end of the interval, with large gaps without data records in between.

Notes

Some settings for the Performance Check calculations depend on the chosen method (ISO | extended) and formula. That is why method and formula must be known at __init__ time.

Methods

__init__(method, formula, **kwargs)