Intro
Low Carbon Contracts Open Source
Section titled “Low Carbon Contracts Open Source”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.
What is RenCal?
Section titled “What is RenCal?”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 streamsGet started with RenCal
Section titled “Get started with RenCal”Prerequisites
Section titled “Prerequisites”You’ll need:
- Python 3.12
- A local Python environment manager such as
uv - 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
Section titled “Install”Install RenCal from PyPI once releases are available:
python -m pip install rencalOr with uv:
uv add rencalFor local development from source:
git clone https://github.com/LCCC-Tech/rencal.gitcd rencaluv sync --group notebookPrepare your data
Section titled “Prepare your data”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 |
Run a wind calibration
Section titled “Run a wind calibration”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.
Run a solar calibration
Section titled “Run a solar calibration”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.
Inspect the outputs
Section titled “Inspect the outputs”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.npyYou 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")Next steps
Section titled “Next steps”- Learn the full RenCal data and simulation pipeline.
- Follow the Wind Calibration Tutorial.
- Work through the Solar Calibration Tutorial.
- Explore the RenCal API reference.

