Transformer thermal model

transformer-thermal-model is a library for modelling the transformer top-oil and hot-spot temperature based on the transformer specifications, a load profile and an ambient temperature profile. The model is an implementation according to the standard IEC 60076-7, also known as de Loading Guide.

Quick Start

Install from PyPI:

pip install transformer-thermal-model

Simple example:

import pandas as pd
from transformer_thermal_model.model import Model
from transformer_thermal_model.cooler import CoolerType
from transformer_thermal_model.schemas import UserTransformerSpecifications, InputProfile
from transformer_thermal_model.transformer import PowerTransformer

# Create transformer specs
tr_specs = UserTransformerSpecifications(
    load_loss=1000, nom_load_sec_side=1500, no_load_loss=200, amb_temp_surcharge=20
)
transformer = PowerTransformer(user_specs=tr_specs, cooling_type=CoolerType.ONAF)

# Create load and ambient temperature profiles
datetime_index = pd.date_range("2020-01-01", periods=168, freq="15min")
profile_input = InputProfile.create(
    datetime_index=datetime_index,
    load_profile=pd.Series([1250] * 168, index=datetime_index),
    ambient_temperature_profile=pd.Series([21] * 168, index=datetime_index),
)

# Run the model
model = Model(temperature_profile=profile_input, transformer=transformer)
results = model.run()

For more examples, see the documentation.

Features

• Temperature modeling: Calculate top-oil and hot-spot temperatures according to IEC 60076-7
• Multiple transformer types: Power, distribution, and three-winding transformers are supported
• ONAN/ONAF modelling: Model with different cooling types
• Hot-spot calibration: Automatic calibration of hot-spot factors
• Aging calculations: Analyze transformer aging

Documentation

• Getting Started
• API Reference
• Examples
• Technical Documentation

License

This project is licensed under the Mozilla Public License, version 2.0 - see LICENSE for details.

Licenses third-party libraries

This project includes third-party libraries, which are licensed under their own respective Open-Source licenses. SPDX-License-Identifier headers are used to show which license is applicable.

The concerning license files can be found in the LICENSES directory.

Contributing

Please read CODE_OF_CONDUCT, CONTRIBUTING and PROJECT GOVERNANCE for details on the process for submitting pull requests to us.

Contact

Please read SUPPORT for how to get in touch with the Transformer Thermal Model project.