Skip to content

Intro

This site is the home for open source technical documentation from the Low Carbon Contracts Company.

Our first featured project is RenCal, a Python package for renewable energy calibration and weather-driven simulation workflows. RenCal helps turn plant data, generation history, and ERA5 weather data into calibrated outputs and simulation-ready load factor streams.


RenCal is designed for renewable energy analysis workflows where historical generation and weather data need to be transformed into calibrated model inputs.

At a high level, RenCal helps with:

  • downloading and organizing source data,
  • loading and validating local datasets,
  • calibrating wind generation relationships,
  • producing historical weather-conditioned streams,
  • preparing outputs for simulation and forecasting workflows.
External APIs
-> Local data artifacts
-> Dataset validation
-> Calibration
-> Simulation-ready load factor streams

You’ll need:

  1. Python 3.12
  2. A local Python environment manager such as uv
  3. Input data for plant metadata, generation history, and ERA5 weather files

If you are working with ERA5 data, make sure NetCDF support is available through packages such as xarray and netCDF4.


Install RenCal from PyPI once releases are available:

Terminal window
python -m pip install rencal

Or with uv:

Terminal window
uv add rencal

For local development from source:

Terminal window
git clone https://github.com/LCCC-Tech/rencal.git
cd rencal
uv sync --group notebook

RenCal calibration workflows expect local input data to be organized by source.

data/
plant/
plant_data.csv
generation/
generation_data.parquet
era5/
*.nc
outputs/
wind_calibration/

The key input datasets are:

Dataset Purpose
Plant data Plant metadata and CfD/BMU mapping
Generation data Historical generation by plant
ERA5 weather data Hourly reanalysis weather in NetCDF format

Create a WindCalibrator with your input and output paths.

from pathlib import Path
from rencal.calibration.wind.wind_calibrator import WindCalibrator
calibrator = WindCalibrator(
data_path="data",
output_path=Path("outputs/wind_calibration"),
visual_output=True,
stream_npy_output=True,
)

Then run calibration:

calibrator.calibrate()

RenCal will run the wind calibration workflow and write outputs to your configured output directory.


Use SolarCalibrator when your renewable asset mix includes solar PV generation and you want to estimate plant-level gamma/NOCT parameters from irradiance, temperature, and historical output.

from pathlib import Path
from rencal.calibration.solar.solar_calibrator import SolarCalibrator
solar_calibrator = SolarCalibrator(
data_path="data",
output_path=Path("outputs/solar_calibration"),
visual_output=True,
stream_npy_output=True,
)
solar_calibrator.calibrate()

RenCal writes plantwise solar resource tables plus the calibrated PV-curve summary and long-term load-factor streams.


After calibration, you should see outputs similar to:

outputs/
wind_calibration/
Weibull Params.csv
Calibration Summary.csv
Wind Speeds.csv
Wind Streams.parquet
PowerCurveFit_*.png
Wind Streams.npy

You can inspect these outputs with pandas:

import pandas as pd
weibull = pd.read_csv("outputs/wind_calibration/Weibull Params.csv")
summary = pd.read_csv("outputs/wind_calibration/Calibration Summary.csv")
speeds = pd.read_csv("outputs/wind_calibration/Wind Speeds.csv")
streams = pd.read_parquet("outputs/wind_calibration/Wind Streams.parquet")

  1. Learn the full RenCal data and simulation pipeline.
  2. Follow the Wind Calibration Tutorial.
  3. Work through the Solar Calibration Tutorial.
  4. Explore the RenCal API reference.