Skip to content

rencal.calibration.calibrator

rencal.calibration.calibrator defines the abstract calibration interface used by intermittent technology-specific calibrators.

Calibrator is responsible for loading plant, generation, and ERA5 resource datasets required by a concrete calibrator implementation, then exposing the required workflow steps as abstract methods.

Because this class inherits from ABC, instantiate a concrete subclass such as WindCalibrator rather than Calibrator directly.

from rencal.calibration.wind.wind_calibrator import WindCalibrator
calibrator = WindCalibrator(
data_path="data",
plant_id_col="plant_id",
output_path="outputs",
)
calibrator.calibrate()
class Calibrator(
data_path: str = None,
plant_id_col: str = None,
loader: DataLoader | None = None,
): Calibrator

Initializes a local loader (LocalDataLoader) and materializes plant, generation, and resource datasets.

  • data_path str

    Path to input data directory.

  • plant_id_col str

    Name of the ID column designating a power plant in the input.

  • loader DataLoader | None

    Optional pre-configured data loader. When supplied it is used as-is (overriding data_path), allowing inputs to be read from non-default locations or sources (e.g. a cloud loader reading directly from Blob storage) instead of the default LocalDataLoader layout.

Returns Calibrator

calibrate() -> None

Triggers calibration workflow.

Returns None

Calibrator.extract_resource_timeseries_for_plants

Section titled “Calibrator.extract_resource_timeseries_for_plants”
extract_resource_timeseries_for_plants() -> None

Extracts resource time series for plants.

Returns None

Calibrator.calculate_historical_load_factors

Section titled “Calibrator.calculate_historical_load_factors”
calculate_historical_load_factors() -> None

Calculates historical load factors.

Returns None

Calibrator.fit_historical_load_factor_distribution

Section titled “Calibrator.fit_historical_load_factor_distribution”
fit_historical_load_factor_distribution() -> None

Fits a distribution to historical load factors.

Returns None

Calibrator.estimate_load_factors_for_resource

Section titled “Calibrator.estimate_load_factors_for_resource”
estimate_load_factors_for_resource() -> None

Estimates load factors from historical distribution and full resource history.

Returns None

generate_resource_streams() -> None

Generates resource/load-factor streams for downstream simulation.

Returns None

Calibrator.output_historical_load_factor_distribution_parameters

Section titled “Calibrator.output_historical_load_factor_distribution_parameters”
output_historical_load_factor_distribution_parameters() -> None

Writes historical distribution parameters.

Returns None

output_resource_per_plant() -> None

Writes plant-wise resource time series output.

Returns None

output_resource_streams() -> None

Writes resource streams output.

Returns None

Calibrator.output_estimated_load_factors_tabular

Section titled “Calibrator.output_estimated_load_factors_tabular”
output_estimated_load_factors_tabular() -> None

Writes tabular estimated load-factor output.

Returns None

Calibrator.output_estimated_load_factors_visual

Section titled “Calibrator.output_estimated_load_factors_visual”
output_estimated_load_factors_visual() -> None

Writes visual estimated load-factor and fitted-curve outputs.

Returns None