message_ix_models.model.material.demand.read_hist_mat_demand

message_ix_models.model.material.demand.read_hist_mat_demand(material: Literal['cement', 'steel', 'aluminum'])

Read historical material demand data for a specified commodity.

This function retrieves historical data on material consumption, population, and GDP for the specified material. It processes the data from various sources and formats it into a consistent structure.

Parameters:

material – Commodity for which historical demand data is being read.

Returns:

DataFrame containing historical material demand data with the following columns: - region: Region name. - reg_no: Region number. - year: Year of the data. - consumption: Material consumption. - pop: Population data. - gdp_pcap: GDP per capita. - cons_pcap: Consumption per capita. - del_t: Time difference from the base year (2010).

Return type:

pd.DataFrame