Source code for pyml_datasets.datasets.combined_cycle_power_plant

"""Combined Cycle Power Plant: net hourly electrical energy output of a power plant."""

from typing import Final

from .._loader import load_npz
from .._types import Dataset, DatasetInfo

INFO: Final = DatasetInfo(
    name="combined_cycle_power_plant",
    title="Combined Cycle Power Plant",
    task="regression",
    summary=(
        "Net hourly electrical energy output of a combined cycle power plant, to be predicted "
        "from four hourly average ambient variables: the temperature, the exhaust vacuum, the "
        "ambient pressure and the relative humidity. The 9568 data points were collected over "
        "6 years (2006-2011), while the plant was set to work with full load."
    ),
    license="CC-BY-4.0",
    license_url="https://creativecommons.org/licenses/by/4.0/",
    source="UCI Machine Learning Repository",
    source_url="https://archive.ics.uci.edu/dataset/294/combined+cycle+power+plant",
    doi="10.24432/C5002N",
    creators=("Pınar Tüfekci", "Heysem Kaya"),
    citation=(
        "Tfekci, P. & Kaya, H. (2014). Combined Cycle Power Plant [Dataset]. UCI Machine "
        "Learning Repository. https://doi.org/10.24432/C5002N."
    ),
    obtained_from=(
        "UCI Machine Learning Repository, dataset 294, downloaded with the ucimlrepo package: "
        "all 9568 examples with 4 inputs. The ucimlrepo version is recorded in the file."
    ),
    changes=(
        "Converted to the NumPy NPZ format. Features and the target are stored as float64.",
        "The columns are named after their descriptions in the variables table of the source, "
        "written in lower case with underscores: AT is stored as temperature, V as "
        "exhaust_vacuum, AP as ambient_pressure, RH as relative_humidity and the target PE as "
        "net_hourly_electrical_energy_output. The features are stored in the order AT, V, AP, "
        "RH.",
    ),
    verified_on="2026-10-26",
    references=(
        "Tüfekci, P. (2014). Prediction of full load electrical power output of a base load "
        "operated combined cycle power plant using machine learning methods. International "
        "Journal of Electrical Power & Energy Systems, Volume 60, September 2014, "
        "Pages 126-140. https://doi.org/10.1016/j.ijepes.2014.02.027",
        "Kaya, H., Tüfekci, P., Gürgen, S. F. (2012). Local and Global Learning Methods for "
        "Predicting Power of a Combined Gas & Steam Turbine. Proceedings of the International "
        "Conference on Emerging Trends in Computer and Electronics Engineering ICETCEE 2012, "
        "pp. 13-18, Dubai.",
    ),
    notes=(
        "The features are hourly averages of ambient variables. The averages are taken from "
        "various sensors located around the plant that record the variables every second. The "
        "source gives the variables without normalization.",
        "Units: the temperature is in degrees Celsius, the exhaust vacuum in cm Hg, the ambient "
        "pressure in millibar, the relative humidity in percent and the net hourly electrical "
        "energy output in MW. The source documents the ranges 1.81 to 37.11 for the "
        "temperature, 25.36 to 81.56 for the exhaust vacuum, 992.89 to 1033.30 for the "
        "ambient pressure, 25.56 to 100.16 for the relative humidity and 420.26 to 495.76 "
        "for the output. The relative humidity goes above 100 percent in the source and is "
        "stored as it is.",
        "According to the source the exhaust vacuum is collected from and has an effect on the "
        "steam turbine, and the other three variables affect the performance of the gas "
        "turbine.",
        "To allow 5x2 fold statistical tests, the source provides the data shuffled five "
        "times. This dataset holds the rows in the order of the table that UCI serves through "
        "ucimlrepo.",
        "UCI prints the citation, and the name of the first creator on its page, without the "
        "letters of the name Tüfekci that are not in the English alphabet. The citation is "
        "given here as UCI prints it, the name of the creator as it is written in the papers "
        "of the source.",
    ),
)


[docs] def load_combined_cycle_power_plant() -> Dataset: """Load the Combined Cycle Power Plant dataset (regression, 9568 samples, 4 features). Returns ------- Dataset Dataset with the temperature, the exhaust vacuum, the ambient pressure and the relative humidity as features and the net hourly electrical energy output in MW as target. ``Dataset.info`` holds the license, the source and the citation. Examples -------- >>> from pyml_datasets import load_combined_cycle_power_plant >>> X, y = load_combined_cycle_power_plant() >>> X.shape, y.shape ((9568, 4), (9568,)) """ return load_npz(INFO)