Package 'mrremind'

Description

The mrremind packages contains data preprocessing for the REMIND model.

Author(s)

Maintainer: Lavinia Baumstark [email protected]

Authors:

• Renato Rodrigues

• Antoine Levesque

• Julian Oeser

• Christoph Bertram

• Ioanna Mouratiadou

• Aman Malik

• Felix Schreyer

• Bjoern Soergel

• Marianna Rottoli

• Abhijeet Mishra

• Alois Dirnaichner

• Michaja Pehl

• Anastasis Giannousakis

• David Klein

• Jessica Strefler

• Lukas Feldhaus

• Regina Brecha

• Sebastian Rauner

• Jan Philipp Dietrich

• Stephen Bi

• Falk Benke

• Pascal Weigmann

• Oliver Richters

• Robin Hasse

• Sophie Fuchs

• Rahel Mandaroux

• Johannes Koch

See Also

Useful links:

• https://github.com/pik-piam/mrremind

Description

Calculate REMIND final energy variables from historical AGEB values

Usage

calcAGEB(subtype = "balances")

Arguments

Value

A magpie object.

Author(s)

Falk Benke

Description

read biomass supply curves from Magpie emulator

Usage

calcBiomassPrices()

Value

Magpie object with two parameters determining linear biomass supply curve

Description

Calculate REMIND variables from historical BP values

Usage

calcBP()

Author(s)

Falk Benke

Description

provides historical capacity values in TW

Usage

calcCapacity(subtype)

Arguments

Value

magpie object of capacity data

Author(s)

Renato Rodrigues, Stephen Bi

Examples

## Not run: 
calcOutput("Capacity", subtype = "capacityByTech")

## End(Not run)

Description

provides capacity factor values

Usage

calcCapacityFactor()

Value

magpie object of the capacity factor data

Author(s)

Renato Rodrigues, Stephen Bi

Examples

## Not run: 
calcOutput("CapacityFactor")

## End(Not run)

Description

provides capacity factor values

Usage

calcCapacityFactorHist(subtype)

Arguments

Value

magpie object of the capacity factor data

Author(s)

Renato Rodrigues, Stephen Bi

Examples

## Not run:  
calcOutput("CapacityFactor")

## End(Not run)

Description

The capacity targets (GW) at regional level are produced from two different databases- UNFCCC_NDC database, an update of the Rogelj 2017 paper (see readme in inputdata), and REN21 Global Renewables report The UNFCCC_NDC capacity targets are further broken down to conditional and unconditional targets.

Usage

calcCapTarget(sources)

Arguments

Author(s)

Aman Malik, Oliver Richters

Description

Calculate CCS bound indicator for 2025 and 2030

Usage

calcCCSbounds()

Author(s)

Jessica Strefler, Lavinia Baumstark

See Also

calcOutput, readSource

Description

Calculate CCS capacity from IEA CCUS data

Usage

calcCCScapacity(subtype)

Arguments

Author(s)

Anne Merfort, Falk Benke

Description

This function merges the output of two other functions that calculate REMIND input data for the shares of cooling types per electricity technology and REMIND region, using as initial information the Davies (2013) data per electricity technology and GCAM region. The two other functions separately calculate data for the base year and for future time steps. The source data provide most required information but some assumptions on missing data are also made.

Usage

calcCoolingSharesAll()

Value

MAgPIE object on cooling type shares per elecricity technology and REMIND region

Author(s)

Ioanna Mouratiadou

See Also

calcOutput, readDaviesCooling, convertDaviesCooling, calcCoolingSharesBase,calcCoolingSharesFuture

Examples

## Not run: 

a <- calcOutput("CoolingSharesAll")

## End(Not run)

Description

This function calculates REMIND input data for the shares of cooling types per electricity technology and REMIND region in 2005, using as initial information the Davies (2013) data per electricity technology and GCAM region. The source data provide most required information but some assumptions on missing data are also made.

Usage

calcCoolingSharesBase()

Value

MAgPIE object on cooling type shares per elecricity technology and REMIND region

Author(s)

Lavinia Baumstark, Ioanna Mouratiadou

See Also

calcOutput, readDaviesCooling, convertDaviesCooling, calcCoolingSharesAll,calcCoolingSharesFuture

Examples

## Not run: 
a <- calcOutput("CoolingSharesBase")

## End(Not run)

Description

This function calculates REMIND input data for the shares of cooling types per electricity technology and REMIND region in post-2020, using as initial information the Davies (2013) data per electricity technology and GCAM region. The source data provide most required information but some assumptions on missing data are also made.

Usage

calcCoolingSharesFuture()

Value

MAgPIE object on cooling type shares per elecricity technology and REMIND region

Author(s)

Ioanna Mouratiadou

See Also

calcOutput, readDaviesCooling, convertDaviesCooling, calcCoolingSharesAll,calcCoolingSharesBase

Examples

## Not run: 
a <- calcOutput("CoolingSharesFuture")

## End(Not run)

Description

Provides REMIND data for PE tradecosts (energy losses on import).

Usage

calcCostsTrade()

Value

REMIND data forPE tradecosts (energy losses on import) and corresonding weights (1) as a list of two MAgPIE objects

Author(s)

Lavinia Baumstark

See Also

calcOutput, readSource

Examples

## Not run: 
calcOutput("calcCostsTrade")

## End(Not run)

Description

Provides REMIND data for PE trade cost (energy losses on import, export and use).

Usage

calcCostsTradePeFinancial()

Author(s)

Regina Brecha, Lavinia Baumstark

See Also

calcOutput, readSource

Examples

## Not run: 
calcOutput("CostsTradePeFinancial")

## End(Not run)

Description

Calculate costs of transport of enhanced weathering

Usage

calcCostsWeathering()

Value

transport costs of spreading rock on the fields

See Also

calcOutput

Examples

## Not run: 
calcOutput("CostsWeathering")

## End(Not run)

Description

Disaggregated investment cost data is aggregated and technologies renamed to REMIND names

Usage

calcDiffInvestCosts(subtype)

Arguments

Details

REMIND does not have a classification of coal power plants e.g., sub-critical. Therefore, countries are given coal plant costs assuming what type of coal plants are expected to develop there. For other technologies, certain assumptions are taken to change to REMIND convention.

Value

Magpie object with aggregated but differentiated investment costs for some technologies.

Author(s)

Aman Malik

Description

Calculates the share of distributed solar pv, wind-onshore/offshore, hydro-small/large from 2015 to 2050. For spv - Only includes grid-connected pv.

Usage

calcDspvShare(subtype)

Arguments

Details

Known limitations - source for distributed spv (IEA Renewables 2019) is different than source for total spv (IRENA 2019)

Value

magpie object with REMIND-aggregated regions

Author(s)

Aman Malik

Description

provides the extra retirement rate to account for relatively old fleet technologies retirement

Usage

calcEarlyRetirementAdjFactor(subtype = "none")

Arguments

Value

magpie object of additional adjusment percentage to be added to the fraction of the early retired capital in countries to account for relatively old technologies fleet

Author(s)

Renato Rodrigues

See Also

calcOutput

Examples

## Not run: 
calcOutput(type = "EarlyRetirementAdjFactor")

## End(Not run)

Description

Provides REMIND data for CO2 parameters to calculate baseline emissions of waste from population and investment.

Usage

calcEconometricEmiParameter()

Value

REMIND data for CO2 parameters to calculate baseline emissions of waste from population and investment and corresponding weights (population) as a list of two MAgPIE objects

Author(s)

Lavinia Baumstark

See Also

calcOutput, readSource

Examples

## Not run: 
calcOutput("calcEconometricEmiParameter")

## End(Not run)

Description

calcEDGAR7Fgases

Usage

calcEDGAR7Fgases()

Author(s)

Gabriel Abrahao

Description

Prepare EDGETransport inputs

Usage

calcEDGETransport(subtype)

Arguments

Value

REMIND/iterative EDGE-T input data for all scenario combinations

Author(s)

Johanna Hoppe

See Also

readSource

Examples

## Not run: 
a <- calcOutput(type = "EDGETransport", subtype = "CAPEXandNonFuelOPEX", aggregate = F)

## End(Not run)

Description

Calculate EEA emission projections from the two projections sources provided by EEA

Usage

calcEEAGHGProjections()

Value

A magpie object.

Author(s)

Falk Benke

Description

provides region specific Effort Sharing Reference Emissions

Usage

calcEffortSharingRefEmi(subtype)

Arguments

Value

2005 reference emissions to calculate effort sharing decision targets

Author(s)

Renato Rodrigues

Examples

## Not run: 
calcOutput("EffortSharingRefEmi",subtype="Eurostat_GHG")

## End(Not run)

Description

provides region specific Effort Sharing Emission target

Usage

calcEffortSharingTarget()

Value

target data magpie object

Author(s)

Renato Rodrigues

Examples

## Not run:  
calcOutput("EffortSharingTarget")

## End(Not run)

Description

prepare the yearly Ember electricity data set To use only a part of the Ember data, call calcOutput("Ember", subtype = "...") and convert to TW if you want to use capacities as input data to REMIND.

Usage

calcEmber(subtype = "all")

Arguments

Value

A ['magpie'][magclass::magclass] object.

Author(s)

Pascal Weigmann

See Also

['calcOutput()']

Description

calcEmiAirPoll calculate Air Pollution Emissions

Usage

calcEmiAirPollLandUse()

Value

magpie object

Author(s)

Julian Oeser

See Also

calcOutput

Examples

## Not run:  a <- calcOutput(type="EmiAirPollLandUse")

Description

EmiCO2LandUse calculate co2 emissions from land use change

Usage

calcEmiCO2LandUse()

Value

magpie object

Author(s)

Julian Oeser

See Also

calcOutput

Examples

## Not run:  a <- calcOutput(type="EmiCO2LandUse")

Description

hisorical LULUCF emissions following country accounting

Usage

calcEmiLULUCFCountryAcc(subtype)

Arguments

Value

Magpie object with historical LULUCF emissions

Author(s)

Felix Schreyer

Description

Provides REMIND data for baseline emissions for maccs for 1990.

Usage

calcEmiMac1990()

Value

REMIND data for baseline emissions for maccs for 1990 and corresonding weights (NULL) as a list of two MAgPIE objects

Author(s)

Lavinia Baumstark

See Also

calcOutput, readSource

Examples

## Not run:  
calcOutput("calcEmiMac1990")

## End(Not run)

Description

calcEmiPollutantExo calculate EmiPollutantExo based on RCP data

Usage

calcEmiPollutantExo(subtype, aviationshippingsource = "RCP")

Arguments

Value

magpie object

Author(s)

Julian Oeser

See Also

calcOutput

Examples

## Not run:  a <- calcOutput(type="EmiPollutantExo")

Description

provides European 2030 emission targets in relation to 1990 and 2005 emissions

Usage

calcEmiReference()

Value

2030 emission reductions tragets for 40

Author(s)

Falk Benke and Renato Rodrigues

Examples

## Not run: 
calcOutput("EmiReference")

## End(Not run)

Description

calcEmissions

Usage

calcEmissions(datasource = "CEDS16")

Arguments

Value

magpie object with historical emissions

Author(s)

Steve Smith, Pascal Weigmann

Description

Output for 2 policy cases

Usage

calcEmiTarget(sources, subtype)

Arguments

Author(s)

Aman Malik, Christoph Bertram, Oliver Richters

Description

provides region specific ETS Reference Emissions

Usage

calcETSRefEmi(subtype)

Arguments

Value

2005 reference emissions to calculate ETS targets

Author(s)

Renato Rodrigues

Examples

## Not run:  
calcOutput("ETSRefEmi",subtype="EEA_GHG")

## End(Not run)

Description

Calculate REMIND variables from European Energy Datasheets

Usage

calcEuropeanEnergyDatasheets(subtype)

Arguments

Value

A magpie object.

Author(s)

Falk Benke

Description

Calculate REMIND emission variables from historical Eurostat (env_air_gge) values

Usage

calcEurostatEmissions()

Author(s)

Falk Benke

Description

prepare data for exogenuous FE and ES demand pathways that do not come from EDGE models but from other sources and/or scenario literature. REMIND can be fixed to those demand pathways if the switch cm_exogDem_scen is activated.

Usage

calcExogDemScen()

Value

A ['magpie'][magclass::magclass] object.

Author(s)

Felix Schreyer

Description

Calculate expert guesses

Usage

calcExpertGuess(subtype)

Arguments

Author(s)

Falk Benke

Description

Calculates FE historical from IEA energy balances, projections from EDGE, and historical values from IEA WEO 2019

Usage

calcFE(source = "IEA", scenario_proj = "SSP2", ieaVersion = "default")

Arguments

Author(s)

Lavinia Baumstark, Aman Malik

Description

Calculates Final Energy Demand for Industry, Buildings and Transport

Usage

calcFEdemand()

Author(s)

Falk Benke

Description

Returns the EDGE-Buildings data as REMIND variables

Usage

calcFeDemandBuildings(subtype)

Arguments

Author(s)

Robin Hasse

Description

Calculates FE demand in transport as REMIND variables

Usage

calcFeDemandTransport()

Author(s)

Alois Dirnaicher, Johanna Hoppe

Description

FE Share parameters used in REMIND

Usage

calcFEShares(subtype)

Arguments

Author(s)

Antoine Levesque

Description

Reads in the data of the source IIASA_subs_taxes, by country. and calculate taxes at the final energy delivery level to the end-use sectors (industry, buildings and transport). Regional aggregation is done via the respective energy quantities as weights.

Usage

calcFETaxes(subtype = "taxes")

Arguments

Value

MAgPIE object

Author(s)

Christoph Bertram and Renato Rodrigues

See Also

calcOutput, readIIASA_subs_taxes, convertIIASA_subs_taxes

Examples

## Not run: 
calcOutput("FETaxes")

## End(Not run)

Description

generate F-Gases based on IMAGE data

Usage

calcFGas(subtype = "interpolate2025")

Arguments

Value

magpie object with F-gases information

Author(s)

Lavinia Baumstark

See Also

calcOutput, readSource

Examples

## Not run: 
x <- calcOutput("FGas")

## End(Not run)

Description

Residential, commercial and total floor space from EDGE-B. Set

Usage

calcFloorspace(onlyTotal = FALSE)

Arguments

Value

MAgPIE object with buildings floor space

Author(s)

Antoine Levesque, Robin Hasse

Description

provides coefficients for fossil fuels (oil, gas and coal) and uranium extraction cost equations.

Usage

calcFossilExtraction(subtype = "FossilExtraction")

Arguments

Value

magpie object of the coefficients for fossil fuels and uranium extraction cost equations

Author(s)

Renato Rodrigues, Felix Schreyer

See Also

calcOutput

Examples

## Not run: 
calcOutput(type = "FossilExtraction", subtype = "FossilExtraction")

## End(Not run)

Description

Calculates air pollutant emissions and emission factors (user can choose) based on GAINS emissions and activity data. Result is given on GAINS sector level. User can choose between aggregated and extended sectoral resolution. Results are given for multiple scenarios. Scenario design is partly taken from the GAINS data and partly created in this function (particularly the SSPs).

Usage

calcGAINS(subtype = "emission_factors", sectoral_resolution = "extended")

Arguments

Description

Provides input data for exoGAINSAirpollutants.R

Usage

calcGAINSEmi(subtype = "emissions")

Arguments

Value

Emissions and emission factors

Author(s)

Sebastian Rauner

See Also

calcOutput

Examples

## Not run: 
calcOutput("calcGAINSEmi")

## End(Not run)

Description

Extracts oil, gas and coal data from the GEA 2012 into a scenario- and time-dependent grade structure

Usage

calcGEA2012(subtype, datatype)

Arguments

Value

MAgPIE object containing regionally aggregated GEA 2012 data

Author(s)

Stephen Bi

See Also

calcOutput

Examples

## Not run: 
a <- calcOutput("GEA2012")

## End(Not run)

Description

Calculate near-term expectations of capacities for use in fullVALIDATION.R

Usage

calcGlobalEnergyMonitor()

Value

A magpie object.

Author(s)

Falk Benke

Description

Gather reference data from various sources.

Usage

calcHistorical()

Description

Calculate Final Energy for the buildings sector from Heat Roadmap Europe scenarios

Usage

calcHRE()

Value

A magpie object.

Author(s)

Pascal Weigmann

Description

Calculate REMIND emission variables from IEA ETP values

Usage

calcIEA_ETP()

Value

A magpie object.

Author(s)

Falk Benke

Description

Calculate REMIND variables from IEA Global EV Outlook data

Usage

calcIEA_EVOutlook()

Author(s)

Falk Benke

Description

Calculate REMIND variables from IEA World Energy Outlook data.

Usage

calcIEA_WorldEnergyOutlook()

Author(s)

Falk Benke

Description

Computes IEA-based model data for different "subtypes" by use of raw IEA "Energy Balances" data and a mapping that corresponds to the structure of "products" and "flows" of IEA.

Usage

calcIO(
  subtype = c("input", "output", "output_biomass", "trade", "input_Industry_subsectors",
    "output_Industry_subsectors", "IEA_input"),
  ieaVersion = "default"
)

Arguments

Details

Mapping structure example: IEA product ANTCOAL used for IEA flow TPATFUEL, contributes via REMIND technology coaltr for generating sesofos from pecoal (REMIND names)

When using subtype output_Industry_subsectors, additional corrections are applied to the IEA data in tool_fix_IEA_data_for_Industry_subsectors.

Value

IEA data as MAgPIE object aggregated to country level

Author(s)

Anastasis Giannousakis

See Also

calcOutput

Examples

## Not run: 
a <- calcOutput("IO", subtype = "output")

## End(Not run)

Description

Calculate REMIND variables from historical IRENA capacities.

Usage

calcIRENA()

Author(s)

Falk Benke

Description

Calculate selected REMIND energy and emission variables from historical JRC IDEES values

Usage

calcJRC_IDEES(subtype)

Arguments

Value

A magpie object.

Author(s)

Falk Benke

Description

write KLW damage parameters (from Kotz et al. 2024) into input data they are country-specific and should not be aggregated to the regional level at all

Usage

calcKLWdamage(subtype)

Arguments

Value

MAgPIE object of damage parameters for KLW damage function on country level and for 1000 boostrapping samples

Author(s)

Franziska Piontek

Description

Rrange of possible abatement between maximum and minimum emission level in a year

Usage

calcMACCsCO2()

Value

MAgPIE object

Author(s)

David Klein

Examples

## Not run: 
calcOutput("MACCsCO2")

## End(Not run)

Description

This is used in remind2 reporting as input data to calculate additional capacity and secondary energy variables.

Usage

calcOtherFossilInElectricity()

Details

The projection focuses on a tight mitigation scenario and assumes that all fossil emissions from waste burning / other fossil processes can be reduced to 0 by 2050. Should be replaced in the future by actual modeling of waste / other fossil plants, or at least connected to RCP scenario assumptions.

Value

A list with a magpie object x, weight, unit, description.

Author(s)

Robert Pietzcker, Falk Benke

See Also

calcOutput()

Description

Computes Primary Energy variables

Usage

calcPE(subtype = "IEA", ieaVersion = "default")

Arguments

Value

a magclass object

Description

Reads in the data of the source IIASA_subs_taxes, by country. and calculate taxes at primary energy level. Regional aggregation is done via the respective energy quantities as weights.

Usage

calcPETaxes(subtype = "subsidies")

Arguments

Value

MAgPIE object

Author(s)

Christoph Bertram and Renato Rodrigues

See Also

calcOutput, readIIASA_subs_taxes, convertIIASA_subs_taxes

Examples

## Not run: 
calcOutput("PETaxes")

## End(Not run)

Description

calculates projections for the end of life fate of plastic waste in particular, calculates the share that is incinerated

Usage

calcPlasticsEoL()

Value

A list with a magpie object x, weight, unit, description.

Author(s)

Falk Benke, Simón Moreno Leiva

See Also

calcOutput()

Description

Provides geothermal potential data

Usage

calcPotentialGeothermal()

Value

geothermal potential data MAgPIE object

Author(s)

Renato Rodrigues

See Also

calcOutput

Examples

## Not run:  
calcOutput("PotentialGeothermal")


## End(Not run)

Description

Provides hydro potential data

Usage

calcPotentialHydro()

Value

hydro potential data and corresonding weights as a list of two MAgPIE objects

Author(s)

Lavinia Baumstark

See Also

calcOutput, readWGBU, convertWGBU, readSource

Examples

## Not run:  
calcOutput("PotentialHydro")


## End(Not run)

Description

Provides weathering potential data

Usage

calcPotentialWeathering()

Value

weathering potential data and corresonding weights as a list of two MAgPIE objects

Author(s)

Lavinia Baumstark

See Also

calcOutput

Examples

## Not run:  
calcOutput("PotentialWeathering")


## End(Not run)

Description

Provides wind offshore potential data

Usage

calcPotentialWindOff()

Value

wind offshore potential data and corresonding weights as a list of two MAgPIE objects

Author(s)

Chen Chris Gong

See Also

calcOutput, readNREL, convertNREL, readSource

Examples

## Not run:  
calcOutput("PotentialWindOff")


## End(Not run)

Description

Provides wind onshore potential data

Usage

calcPotentialWindOn()

Value

wind onshore potential data and corresonding weights as a list of two MAgPIE objects

Author(s)

Lavinia Baumstark

See Also

calcOutput, readNREL, convertNREL, readSource

Examples

## Not run:  
calcOutput("PotentialWindOn")


## End(Not run)

Description

Shares of world manufacture for spv modules and wind turbines for 2018 and 2019

Usage

calcProdShares()

Value

magpie object with REMIND-aggregated region

Author(s)

Aman Malik

Description

Calculate the expected near-term deployment of technologies based on projects that are currently either being built or in a planning stage for some technologies multiple sources are available. Output object currently needs to contain years 2020, 2025 and 2030.

Usage

calcProjectPipelines(subtype)

Arguments

Details

Discussions on sources and assumptions: https://github.com/pik-piam/mrremind/discussions

Author(s)

Pascal Weigmann

Description

provides RLDC coefficients values

Usage

calcRLDCCoefficients(subtype = "LoB")

Arguments

Value

magpie object of the RLDC coefficients data

Author(s)

Renato Rodrigues

See Also

calcOutput

calcOutput

Examples

## Not run:  
calcOutput(type="RLDCCoefficients",subtype='LoB')

## End(Not run)

Description

provides region specific target

Usage

calcSharedTarget(subtype)

Arguments

Value

target data magpie object

Author(s)

Renato Rodrigues

Examples

## Not run: 
calcOutput("SharedTarget",subtype="FErenewablesShare")

## End(Not run)

Description

calcSolar calculate Area, Capacity and Energy for photovoltaics (PV) and contentrated solar power (CSP)

Usage

calcSolar()

Value

magpie object

Author(s)

Julian Oeser, modified by Renato Rodrigues

See Also

calcOutput

Examples

## Not run:  a <- calcOutput(type="Solar")

Description

provides capacity factor values

Usage

calcStorageFactor()

Value

magpie object of the capacity factor data

Author(s)

Lavinia Baumstark

See Also

calcOutput

Examples

## Not run: 
calcOutput("StorageFactor")

## End(Not run)

Description

tax convergence levels for specific regions

Usage

calcTaxConvergence(subtype)

Arguments

Value

magpie object of the tax convergence levels

Author(s)

Renato Rodrigues

Examples

## Not run: 
calcOutput("TaxConvergence")

## End(Not run)

Description

tax and subsidies maximum levels. The tax limits serve as a work around to avoid excess of subsidy levels that could cause problems on the REMIND model solution. These files should be removed or replaced once a better way to handle this issue is introduced to the REMIND model formulation or once better yearly and country subsidy level data is available for the primary and final energies.

Usage

calcTaxLimits(subtype)

Arguments

Value

magpie object of the subtype tax limit

Author(s)

Renato Rodrigues

Examples

## Not run: 
calcOutput("TaxLimits")

## End(Not run)

Description

write TC damage parameters into input data they are country-specific and should not be aggregated to the regional level at all

Usage

calcTCdamage(subtype)

Arguments

Value

MAgPIE object of damage parameters for country level tropical cyclone damage function

Author(s)

Franziska Piontek

Description

To calculate the regional Theil-T index (= correction to welfare function for a lognormal income distribution) we do the following: (1) convert country-level Gini coefficients to Theil (2) calculate contribution to Theil-T index that includes both between-countries and within-country inequality (see e.g. https://en.wikipedia.org/wiki/Theil_index). The latter can then be aggregated with calcOutput().

Usage

calcTheil()

Details

NB 1: the aggregation depends on the region mapping. It is implemented such that the regionmapping specified in getConfig()$regionmapping is used.

NB 2: the result of calcOutput('Theil', aggregate = FALSE), is NOT the country Theil-T, but the unweighted contribution from a given country to the regional value.

Value

magpie objects of unweighted contribution to Theil, weights (= country shares of regional GDP)

Author(s)

Bjoern Soergel

See Also

calcOutput convertGini,readGini

Examples

## Not run: 
  calcOutput("Theil")

## End(Not run)

Description

Computes Trade variables based on latest IEA data available

Usage

calcTrade()

Value

a magclass object

Description

provides transport share in GDP to resize edge-t transportation purchase costs

Usage

calcTransportGDPshare()

Value

magpie object of transport shares in GDP

Author(s)

Renato Rodrigues

Examples

## Not run: 
calcOutput("TransportGDPshare")

## End(Not run)

Description

Calculate REMIND final energy variables from historical UBA values

Usage

calcUBA()

Value

A magpie object.

Author(s)

Falk Benke

Description

Calculate REMIND emission variables from historical UNFCCC values

Usage

calcUNFCCC()

Value

A magpie object.

Author(s)

Falk Benke, Pascal Weigmann

Description

The output of this function is used in remind2 for reporting purposes.

Usage

calcWasteEnergyUseShares()

Author(s)

Robert Pietzcker, Falk Benke

Description

This function calculates REMIND input data on water consumption coefficients per electricity technology, using as initial information the Macknick (2011) data per electricity technology. The source data provide most required information but some assumptions on missing data are also made.

Usage

calcWaterConsCoef()

Value

MAgPIE object on water consumption coefficients per electricity technology

Author(s)

Ioanna Mouratiadou

See Also

calcOutput, readMacknickIntensities, calcWaterWithCoef

Examples

## Not run: 
calcOutput("WaterConsCoef")

## End(Not run)

Description

This function calculates REMIND input data on water withdrawal coefficients per electricity technology, using as initial information the Macknick (2011) data per electricity technology. The source data provide most required information but some assumptions on missing data are also made.

Usage

calcWaterWithCoef()

Value

MAgPIE object on water withdrawal coefficients per elecricity technology

Author(s)

Ioanna Mouratiadou

See Also

calcOutput, readMacknickIntensities, calcWaterConsCoef

Examples

## Not run: 
calcOutput("WaterWithCoeff")

## End(Not run)

Description

Convert AGEB data

Usage

convertAGEB(x)

Arguments

Value

A magpie object.

Author(s)

Falk Benke

Description

convert Ariadne database data

Usage

convertAriadneDB(x)

Arguments

Value

A ['magpie'][magclass::magclass] object.

Author(s)

Felix Schreyer

Description

Converts BGR oil, gas, coal and uranium reserves data

Usage

convertBGR(x, subtype)

Arguments

Value

A MAgPIE object containing BGR (Federal Institute for Geosciences and Natural Resources) country reserves disaggregated data of oil, gas, coal and uranium.

Author(s)

Renato Rodrigues

Examples

## Not run: 
a <- convertBGR(x, subtype = "oil")

## End(Not run)

Description

Disaggregates and cleans BP data.

Usage

convertBP(x, subtype)

Arguments

Value

A ['magpie'][magclass::magclass] object.

Author(s)

Aman Malik, Falk Benke

Description

Convert Davies (2013) data on on shares of cooling types using mapping from GCAM regions to ISO country level.

Usage

convertDaviesCooling(x)

Arguments

Value

MAgPIE object of the Davies (2013) data disaggregated to country level

Author(s)

Lavinia Baumstark, Ioanna Mouratiadou

See Also

readDaviesCooling

Examples

## Not run:  a <- convertDaviesCooling(x)

Description

Converts Dylan's Australian gas cost to magpie

Usage

convertDylanAusGasCost(x)

Arguments

Value

magpie object of the CEMO data

Author(s)

Felix Schreyer

See Also

readSource

Description

convertEDGAR7Fgases

Usage

convertEDGAR7Fgases(x)

Arguments

Author(s)

Gabriel Abrahao

Description

Convert EDGE Buildings data to data on ISO country level.

Usage

convertEdgeBuildings(x, subtype = "FE")

Arguments

Value

EDGE data as MAgPIE object aggregated to country level

Author(s)

Antoine Levesque, Robin Hasse

Description

Convert EDGEtransport

Usage

convertEDGETransport(x, subtype)

Arguments

Value

REMIND/iterative EDGE-T input data as MAgPIE object disaggregated to ISO level

Author(s)

Johanna Hoppe

Description

Convert Ember data

Usage

convertEmber(x)

Arguments

Value

A magpie object.

Author(s)

Pascal Weigmann

Description

Convert European Energy Datasheets

Usage

convertEuropeanEnergyDatasheets(x, subtype)

Arguments

Value

converted European Energy Datasheets magpie object

Author(s)

Renato Rodrigues and Atreya Shankar

Source

European Energy Datasheets public database https://energy.ec.europa.eu/data-and-analysis/eu-energy-statistical-pocketbook-and-country-datasheets_en

Examples

## Not run: 
test <- readSource("EuropeanEnergyDatasheets", subtype = "EU27", convert = TRUE)

## End(Not run)

Description

Converts EU Effort Sharing targets and historical emissions

Usage

convertEurostat_EffortSharing(x, subtype)

Arguments

Value

A MAgPIE object containing the EU Effort Sharing targets (

Author(s)

Renato Rodrigues

Examples

## Not run:  a <- convertEurostat_EffortSharing(x,subtype="target")

Description

Converts data from expert guess

Usage

convertExpertGuess(x, subtype)

Arguments

Value

magpie object with a completed dataset.

See Also

convertExpertGuess

Description

Converts oil, gas and coal data from the Global Energy Assessment 2012 to country-level aggregation

Usage

convertGEA2012(x, subtype)

Arguments

Value

MAgPIE object containing country-level disaggregation of GEA 2012 data

Author(s)

Stephen Bi

See Also

readSource

Examples

## Not run: 
a <- readSource("GEA2012")

## End(Not run)

Description

Convert GGDC 10-Sector Database - https://www.rug.nl/ggdc/structuralchange/previous-sector-database/10-sector-2014

Usage

convertGGDC10(x)

Arguments

Value

A MAgPIE object containing GGDC disaggregated data

Author(s)

Renato Rodrigues

Examples

## Not run: 
a <- convertGGDC10(x)

## End(Not run)

Description

Converts Gini data from readGini() to ISO country level. Countries missing in the original data set will have their Gini set to zero ( a very small number for numerical reasons to be precise). The original data range is 2011-2100 in one-year steps, here we extend it to 2000-2150 in 5-year steps. Values before (after) the original range are held fixed at 2011 (2100) levels. Gini values for the SDP scenario are taken from the SSP1 scenario

Usage

convertGini(x)

Arguments

Value

MAgPIE object of the Gini data in ISO countries, range 0-1

Author(s)

Bjoern Soergel

See Also

readSource readGini

Examples

## Not run: 
a <- convertGini(x)

## End(Not run)

Description

Convert Global CCS Institute Project Database

Usage

convertGlobalCCSinstitute(x, subtype = "08-09-2017")

Arguments

Value

A magpie object.

Description

Convert Global Energy Monitor data

Usage

convertGlobalEnergyMonitor(x)

Arguments

Author(s)

Rahel Mandaroux, Falk Benke

Description

Convert HRE data

Usage

convertHRE(x)

Arguments

Value

A magpie object.

Author(s)

Pascal Weigmann

Description

Data on currently operating and under-construction nuclear power plants, reactors planned and proposed, electricity generation from nuclear

Usage

convertIAEA(x)

Arguments

Author(s)

Christoph Bertram

Description

convert IAEA Power Reactor Information System

Usage

convertIAEA_PRIS(x)

Arguments

Author(s)

Pascal Weigmann

Description

Convert IEA CCUS data

Usage

convertIEA_CCUS(x)

Arguments

Value

A magclass object.

Author(s)

Anne Merfort, Falk Benke

Description

Convert IEA ETP projections

Usage

convertIEA_ETP(x, subtype)

Arguments

Author(s)

Falk Benke, Robin Hasse

Description

Convert IEA EV Outlook

Usage

convertIEA_EVOutlook(x)

Arguments

Author(s)

Falk Benke

Description

convert IEA Hydro Special Market Report

Usage

convertIEA_HSMR(x)

Arguments

Author(s)

Pascal Weigmann

Description

maps to iso countries

Usage

convertIEA_PVPS(x)

Arguments

Value

Magpie object with IEA PVPS investment cost per country

Author(s)

Felix Schreyer

Description

Reads the distributed solar pv capacity from IEA Renewables report (2019).

Usage

convertIEA_REN(x)

Arguments

Details

Capacity in GW. Distributed solar, defined in the IEA Renewables (2019), includes rooftop residential (0-10 kW, grid-connected), rooftop and ground-mounted commercial and industrial (10-1000kW, grid-connected), and off-grid (8W - 100 kW)

Value

magpie object with country-wise distributed solar pv capacity

Author(s)

Aman Malik

Description

Converts IEA World Energy Outlook data

Usage

convertIEA_WEO(x, subtype)

Arguments

Value

magpie object of the WEO data on generation (TWh), capacities (GW), emissions (Mt CO2) or disaggregated investment cost as magpie object

Author(s)

Renato Rodrigues and Aman Malik

See Also

readSource

Examples

## Not run: 
a <- convertWEO(x, subtype = "Capacity")

## End(Not run)

Description

Convert IEA World Energy Outlook Data from 2023

Usage

convertIEA_WorldEnergyOutlook(x)

Arguments

Author(s)

Falk Benke

Description

Convert IIASA subsidy and taxes data on ISO country level (removes countries not part of 249 oficial ISO countries and fills missing with zeros).

Usage

convertIIASA_subs_taxes(x, subtype)

Arguments

Value

IIASA_subs_taxes data as MAgPIE object aggregated to country level

Author(s)

Christoph Bertram

Examples

## Not run: 
a <- convertIIASA_subs_taxes(x)

## End(Not run)

Description

Converts IRENA Regional data

Usage

convertIRENA(x, subtype)

Arguments

Value

A MAgPIE object containing IRENA country disaggregated data with historical electricity renewable capacities (MW) or generation levels (GWh)

Author(s)

Renato Rodrigues

Examples

## Not run: 
a <- convertIRENA(x, subtype = "Capacity")

## End(Not run)

Description

convert KLW damage fills in countries for which no damage parameters are provided, setting parameters to zero

Usage

convertKLWdamage(x)

Arguments

Value

MAgPIE object containing values for all 249 ISO countries

Author(s)

Franziska Piontek

Description

Converts Final energy demand for feedstocks (non-energy use)

Usage

convertnonEnergyDemand(x)

Arguments

Value

A MAgPIE object containing country disaggregated data

Author(s)

Renato Rodrigues

Examples

## Not run: 
a <- convertnonEnergyDemand(x)

## End(Not run)

Description

Convert NREL data on ISO country level.

Usage

convertNREL(x)

Arguments

Value

NRELWirsenius data as MAgPIE object aggregated to country level

Author(s)

Lavinia Baumstark

Examples

## Not run: 
a <- convertNREL(x, subtype = "onshore")

## End(Not run)

Description

Converts Openmod capacities data

Usage

convertOpenmod(x)

Arguments

Value

A MAgPIE object containing openmod EU country disaggregated data with 2010 and 2015 electricity capacities (GW)

Author(s)

Renato Rodrigues

Examples

## Not run: 
a <- convertOpenmod(x)

## End(Not run)

Description

Reads shares of world manufacture for spv modules and wind turbines.

Usage

convertProdShares(x)

Arguments

Value

magpie object with shares

Author(s)

Aman Malik

Description

convertRCP convert RCP data

Usage

convertRCP(x, subtype)

Arguments

Value

magpie object of the RCP data

Author(s)

Julian Oeser

Description

Converts REMIND regional data

Usage

convertREMIND_11Regi(x, subtype)

Arguments

Value

A MAgPIE object containing country disaggregated data

Author(s)

original: not defined - capacity factor, tax, fossil and RLDC changes: Renato Rodrigues

Examples

## Not run:  a <- convertREMIND_11Regi(x,subtype="capacityFactorGlobal")

Description

Converts CES derivatives/prices from former REMIND runs to ISO level

Usage

convertRemindCesPrices(x, subtype = "ccd632d33a")

Arguments

Value

magpie object of REMIND prices

Author(s)

Antoine Levesque

See Also

readSource

Description

This code aggregates and homogenises different types of renewable energy targets into total installed capacity targets (in GW).

Usage

convertREN21(x, subtype)

Arguments

Details

Policy database accessible in "inputdata/sources/REN21/README"

Value

Magpie object with Total Installed Capacity targets. The target years differ depending upon the database.

Author(s)

Aman Malik

Description

Convert Stationary data to data on ISO country level.

Usage

convertStationary(x)

Arguments

Author(s)

Antoine Levesque, Robin Hasse

Description

Converts data on enhanced weathering

Usage

convertStrefler(x, subtype)

Arguments

Value

magpie object with a completed dataset

Description

Convert TCdamage fills in countries not affected by tropical cyclones (TC), setting parameters to zero

Usage

convertTCdamageKrichene(x)

Arguments

Value

MAgPIE object containing values for all 249 ISO countries

Author(s)

Franziska Piontek

Description

Convert UBA data

Usage

convertUBA(x)

Arguments

Value

A magpie object.

Author(s)

Falk Benke

Description

Convert UNFCCC data

Usage

convertUNFCCC(x)

Arguments

Value

A magpie object.

Author(s)

Falk Benke

Description

Converts conditional and unconditional capacity targets into total capacity (GW) in target year the Generation targets are similar to the capacity targets but include the capacity factors, the Emissions targets are the total (except land CO2) emissions in the target year

Usage

convertUNFCCC_NDC(x, subtype)

Arguments

Value

Magpie object with Total Installed Capacity (GW) targets, target years differ depending upon the database.

Author(s)

Aman Malik, Christoph Bertram, Oliver Richters

Description

Convert WGBU data on ISO country level.

Usage

convertWGBU(x)

Arguments

Value

WGBU data as MAgPIE object aggregated to country level

Author(s)

Lavinia Baumstark

Examples

## Not run: 
a <- convertWGBU(x)

## End(Not run)

Description

Function that produces the complete regional data set required for the DECENT model.

Usage

fullDECENT(rev = 0)

Arguments

Author(s)

Lavinia Baumstark, Lukas Feldhaus

See Also

readSource,getCalculations,calcOutput

Examples

## Not run: 
fullDECENT()

## End(Not run)

Description

Function that produces the complete regional data set required for the REMIND model.

Usage

fullREMIND()

Author(s)

Lavinia Baumstark

See Also

readSource,getCalculations,calcOutput

Examples

## Not run: 
fullREMIND()

## End(Not run)

Description

assemble near-term thresholds from project pipelines and potentially other data sources and export them to a file

Usage

fullTHRESHOLDS(type = "config")

Arguments

Author(s)

Pascal Weigmann

Description

Function that generates the historical regional dataset against which the REMIND model results can be compared.

Usage

fullVALIDATIONREMIND(rev = 0)

Arguments

Author(s)

David Klein, Falk Benke

See Also

fullREMIND(), readSource(), getCalculations(), calcOutput()

Examples

## Not run: 
fullVALIDATIONREMIND()

## End(Not run)

Description

Read AGEB

Usage

readAGEB(subtype = "balances")

Arguments

Value

A magpie object.

Author(s)

Falk Benke

Description

Read GWP (or other metrics) from the AR6 WGIII Table SM7 per GHG species

Usage

readAR6GWP(subtype = "GWP100")

Arguments

Value

A data.frame with two columns, "Gas", with the common name of the GHG species, and "GWP", with the selected GWP

Author(s)

Gabriel Abrahao

Description

Scenario data from the Ariadne modeling intercomparison project for Germany. See README in input file for more details.

Usage

readAriadneDB()

Value

A ['magpie'][magclass::magclass] object.

Author(s)

Felix Schreyer

Description

Read-in BGR csv files as magclass object

Usage

readBGR(subtype)

Arguments

Value

magpie object of the BGR (Federal Institute for Geosciences and Natural Resources) data of reserves of oil, gas, coal and uranium per country.

Author(s)

Renato Rodrigues

See Also

readSource

Examples

## Not run: 
a <- readSource(type = "BGR", subtype = "oil")

## End(Not run)

Description

BP Capacity and Generation Data

Usage

readBP(subtype)

Arguments

Value

A ['magpie'][magclass::magclass] object.

Author(s)

Aman Malik, Falk Benke

Description

Read Employment factors and cumulative jobs for RE techs (for India)

Usage

readCEEW(subtype)

Arguments

Details

Reports published by CEEW et al. See README.txt in the source folder for more information.

Author(s)

Aman Malik

Examples

## Not run: 
a <- readSource("CEEW",convert=F,subtype="Employment")

## End(Not run)

Description

Read in Davies (2013) data on shares of cooling types per electricity technology and GCAM region

Usage

readDaviesCooling(subtype)

Arguments

Value

MAgPIE object of the Davies (2013) data

Author(s)

Lavinia Baumstark, Ioanna Mouratiadou

See Also

readSource

Examples

## Not run: 
a <- readSource(type = "DaviesCooling")

## End(Not run)

Description

read-in power Australian gas extraction cost curve based on Dylan's data Australian contact: Dylan McConnell, dylan.mcconnell(at)unimelb.edu.au

Usage

readDylanAusGasCost()

Value

magpie object of the cemo database data

Author(s)

Felix Schreyer

See Also

readSource

Description

Read EDGAR7 emissions data for F-gases per species, in kt of each gas

Usage

readEDGAR7Fgases()

Value

A magpie object with F-gases emissions per gas species and per country

Author(s)

Gabriel Abrahao

Description

Load an EDGE Buildings file as magclass object.

Usage

readEdgeBuildings(subtype = c("FE", "Floorspace"))

Arguments

Value

magclass object

Author(s)

Antoine Levesque, Robin Hasse

Description

Run EDGE-Transport Standalone in all used scenario combinations to supply input data to REMIND and the iterative EDGE-T script

Usage

readEDGETransport(subtype)

Arguments

Value

magpie object of EDGEtransport iterative inputs

Author(s)

Johanna Hoppe

See Also

readSource

Examples

## Not run: 
a <- readSource(type = "EDGETransport")

## End(Not run)

Description

Read Ember Yearly Electricity Data

Usage

readEmber()

Value

A ['magpie'][magclass::magclass] object.

Author(s)

Pascal Weigmann

Source

https://ember-climate.org/data-catalogue/yearly-electricity-data/

See Also

['readSource()']

Description

Read European Energy Datasheets .xlsx file as magpie object.

Usage

readEuropeanEnergyDatasheets(subtype)

Arguments

Value

magpie object of European Energy Datasheets

Author(s)

Renato Rodrigues, Atreya Shankar, Falk Benke

Source

European Energy Datasheets public database https://energy.ec.europa.eu/data-and-analysis/eu-energy-statistical-pocketbook-and-country-datasheets_en

Examples

## Not run: 
test <- readSource("EuropeanEnergyDatasheet", subtype = "EU27", convert = FALSE)

## End(Not run)

Description

Read-in EU Effort Sharing targets and historical emissions csv files as magclass object

Usage

readEurostat_EffortSharing(subtype)

Arguments

Value

magpie object of the EU Effort Sharing targets (

Author(s)

Renato Rodrigues

See Also

readSource

Examples

## Not run: 
a <- readSource(type = "Eurostat_EffortSharing", subtype = "target")

## End(Not run)

Description

Read-in data that are based on expert guess

Usage

readExpertGuess(subtype)

Arguments

Value

magpie object of the data

Author(s)

Lavinia Baumstark

See Also

readSource

Examples

## Not run: 
a <- readSource(type = "ExpertGuess", subtype = "ies")

## End(Not run)

Description

Historical data of operating, under-construction, planned and announced Coal Plants by country (in MW) from the Global Energy Monitor's Global Coal Plant Tracker, and extrapolations for 2025 capacity scenarios

Usage

readGCPT(subtype)

Arguments

Author(s)

Stephen Bi

Description

Read in datafiles comprising fossil fuel data from the Global Energy Assessment 2012

Usage

readGEA2012(subtype)

Arguments

Value

MAgPIE object of the GEA data

Author(s)

Stephen Bi

See Also

readSource

Examples

## Not run: 
a <- readSource("GEA2012", "coal")

## End(Not run)

Description

Read GGDC 10-Sector Database - https://www.rug.nl/ggdc/structuralchange/previous-sector-database/10-sector-2014

Usage

readGGDC10()

Author(s)

Renato Rodrigues

Examples

## Not run: 
a <- readSource("GGDC10",convert=F)

## End(Not run)

Description

Read Gini coefficients for SSP scenarios from Rao et al., Futures, 2018. Data has been provided by the authors, but will be made publicly available as well. This contains data for 184 countries and from 2011 onwards.

Usage

readGini()

Details

Copied from the documentation provided by the authors: This sheet contains the original Gini projections for 43 countries from the underlying empirical model (See reference to RSP 2016 in the main paper) and the extrapolations to all countries using the methodology described in the article. The country codes are the World Bank codes.

Value

magpie object of the Gini data

Author(s)

Bjoern Soergel

See Also

readSource convertGini

Examples

## Not run:  a <- readSource(type="Gini")

Description

Read Global CCS Institute Project Database

Usage

readGlobalCCSinstitute(subtype = "08-09-2017")

Arguments

Value

A magpie object.

Description

read GEM data for all available technologies and relevant statuses

Usage

readGlobalEnergyMonitor()

Author(s)

Rahel Mandaroux, Falk Benke, Pascal Weigmann

Description

Read Heat Roadmap Europe data

Usage

readHRE()

Value

A ['magpie'][magclass::magclass] object.

Author(s)

Pascal Weigmann

Source

https://heatroadmap.eu/roadmaps/

See Also

['readSource()']

Description

Data on currently operating and under-construction nuclear power plants, reactors planned and proposed, electricity generation from nuclear

Usage

readIAEA()

Author(s)

Christoph Bertram

Description

read Nuclear capacities and near-term outlook from data scraped from https://pris.iaea.org/PRIS/CountryStatistics/CountryStatisticsLandingPage.aspx

Usage

readIAEA_PRIS()

Author(s)

Pascal Weigmann

Description

Reads in capacities from projects in IEA CCUS database

Usage

readIEA_CCUS(subtype)

Arguments

Author(s)

Anne Merfort, Falk Benke

Description

Read IEA ETP projections

Usage

readIEA_ETP(subtype)

Arguments

Author(s)

Falk Benke

Description

Read IEA EV Outlook

Usage

readIEA_EVOutlook()

Author(s)

Falk Benke

Description

read Hydro capacities and near-term outlook from data scraped from https://www.iea.org/data-and-statistics/data-tools/hydropower-data-explorer

Usage

readIEA_HSMR()

Author(s)

Pascal Weigmann

Description

reads excel sheet with PV investment cost data

Usage

readIEA_PVPS()

Value

magpie object with PV investment cost data

Author(s)

Felix Schreyer

Description

Reads the distributed solar pv capacity from IEA Renewables report (2019).

Usage

readIEA_REN()

Details

Capacity in GW. Distributed solar, defined in the IEA Renewables (2019), includes rooftop residential (0-10 kW, grid-connected), tooftop and ground-mounted commercial and industrial (10-1000kW, grid-connected), and off-grid (8W - 100 kW)

Author(s)

Aman Malik

Description

Read projected 2014-20 investments into industry energy efficiency from the [IEA World Energy Investment Outlook (2014)](http://www.iea.org/publications/freepublications/publication/weo-2014-special-report—investment.html)

Usage

readIEA_WEIO_2014()

Value

A [madrat_mule()] with a list containing the [tibble] 'data' with 2014–20 average annual investments into 'Energy intensive' and 'Non-energy intensive' industry, in $bn 2012, and the [tibble] 'country_groups' with 'IEA region's and corresponding 'iso3c' country codes.

Description

Read-in IEA WEO 2016 data for investment costs, O&M costs and Efficiency of different technologies, and WEO 2017 data for historical electricity capacities (GW), generation (TWh) or emissions (Mt CO2). WEO 2019 data for PE and FE (Mtoe).

Usage

readIEA_WEO(subtype)

Arguments

Value

magpie object of the WEO data on generation (TWh), capacities (GW), emissions (Mt CO2) or disaggregated investment cost as magpie object

Author(s)

Renato Rodrigues, Aman Malik, and Jerome Hilaire

See Also

readSource

Examples

## Not run: 
a <- readSource(type = "WEO", subtype = "Capacity")

## End(Not run)

Description

Read in IEA World Energy Outlook Data from 2023

Usage

readIEA_WorldEnergyOutlook()

Author(s)

Falk Benke

Description

Read-in country level data on final energy taxes and subsidies as provided from IIASA from .csv file as magclass object

Usage

readIIASA_subs_taxes(subtype)

Arguments

Value

magpie object of the IIASA_subs_taxes data

Author(s)

Christoph Bertram

See Also

readSource

Examples

## Not run: 
a <- readSource(type = "IIASA_subs_taxes", "tax_rate")

## End(Not run)

Description

Read-in an IRENA csv file as magclass object

Usage

readIRENA(subtype)

Arguments

Value

magpie object of the IRENA data with historical electricity renewable capacities (MW) or generation levels (GWh)

Author(s)

Renato Rodrigues

See Also

readSource

Examples

## Not run: 
a <- readSource(type = "IRENA", subtype = "Capacity")

## End(Not run)

Description

Reads country-specific damage coefficients for the damage function presented in Kotz et al. (2024). Data has been provided by the authors. This contains data for all countries and for 1000 boostrapping realizations per country, capturing uncertainty from climate and empirical modeling. Subtypes are the temperature and temperature^2 coefficients and the maximum temperature per country for which the function is defined.

Usage

readKLWdamage(subtype)

Arguments

Value

KLW damage coefficients

Author(s)

Franziska Piontek

Description

readLee Read in Aviation emission data from Lee

Usage

readLee(subtype)

Arguments

Value

magpie object of Aviation emission / emission factors data

Author(s)

Julian Oeser

See Also

readSource

Examples

## Not run: 
a <- readSource(type = "", subtype = "Waste")

## End(Not run)

Description

Read in Macknick (2011) data on water consumption and withdrawal coefficients per electricity technology

Usage

readMacknickIntensities(subtype)

Arguments

Value

MAgPIE object of the Macknick (2011) data

Author(s)

Ioanna Mouratiadou

See Also

readSource

Examples

## Not run: 
a <- readSource(type = "MacknickIntensities", convert = FALSE)

## End(Not run)

Description

Read-in NREL xlsx file as magclass object

Usage

readNREL(subtype)

Arguments

Value

magpie object of NREL

Author(s)

Lavinia Baumstark

See Also

readSource

Examples

## Not run: 
a <- readSource(type = "NREL", subtype = "onshore")

## End(Not run)

Description

Read-in risk premium

Usage

readOECD()

convertOECD(x)

Arguments

Value

The read-in data, usually a magpie object. If supplementary is TRUE a list including the data and metadata is returned instead. The temporal and data dimensionality should match the source data. The spatial dimension should either match the source data or, if the convert argument is set to TRUE, should be on ISO code country level.

See Also

[madrat::readSource()]

Examples

## Not run: 
readSource("OECD")

## End(Not run)

Description

Read-in an modified openmod capacities data file as magclass object

Usage

readOpenmod()

Value

magpie object of the LIMES team updated Openmod data on capacities (GW)

See Also

readSource

Examples

## Not run: 
a <- readSource(type = "Openmod")

## End(Not run)

Description

Reads shares of world manufacture for spv modules and wind turbines.

Usage

readProdShares()

Author(s)

Aman Malik

Description

Read-in PWT data as magclass object

Usage

readPWT()

convertPWT(x)

Arguments

Value

The read-in data, usually a magpie object. If supplementary is TRUE a list including the data and metadata is returned instead. The temporal and data dimensionality should match the source data. The spatial dimension should either match the source data or, if the convert argument is set to TRUE, should be on ISO code country level.

See Also

[madrat::readSource()]

Examples

## Not run: 
readSource("PWT")

## End(Not run)

Description

Read RCP Read in RCP data

Usage

readRCP(subtype)

Arguments

Value

magpie object of the RCP data

Author(s)

Julian Oeser

See Also

readSource

Examples

## Not run:  a <- readSource(type="RCP", subtype="Waste")

Description

Read-in an csv files that contains regional data

Usage

readREMIND_11Regi(subtype)

Arguments

Value

magpie object of region dependent data

Author(s)

original: not defined, capacity factor, tax, fossil and RLDC changes: Renato Rodrigues

See Also

readSource

Examples

## Not run: 
a <- readSource(type = "REMIND_11Regi", subtype = "capacityFactorGlobal")

## End(Not run)

Description

Reads excel sheet with data on proposed policies, on Renewable energy capacity targets (which are broken down into Total Installed Capacity (TIC-Absolute), Additional Installed Capacity (AC-Absolute), and Production Absolute targets) or regional technology costs

Usage

readREN21(subtype)

Arguments

Details

Country name is ISO coded. Capacity/Additional Capacity targets are in GW. Generation/Production targets are in GWh.

Value

magpie object with Total Installed Capacity targets in GW for different target years

Author(s)

Aman Malik, Lavinia Baumstark

Description

Load Stationary File as magclass object

Usage

readStationary()

Value

magclass object

Author(s)

Antoine Levesque, Robin Hasse

Description

Get data on enhanced weathering

Usage

readStrefler(subtype)

Arguments

Value

magpie object of region dependent data

See Also

readSource

Examples

## Not run: 
a <- readSource(type="Strefler", subtype="weathering_graderegi")

## End(Not run)

Description

Reads country-specific damage coefficients for tropical cyclones from Krichene et al. (in prep.). Data has been provided by the authors, but will be made publicly available as well. This contains data for 41 countries (those exposed to tropical cyclones), and two coefficients (constant and linear temperature)

Usage

readTCdamageKrichene(subtype)

Arguments

Value

TC damage coefficients

Author(s)

Franziska Piontek

Description

Read UBA

Usage

readUBA()

Value

A magpie object.

Author(s)

Falk Benke

Description

Read UNFCCC data

Usage

readUNFCCC()

Value

A ['magpie'][magclass::magclass] object.

Author(s)

Falk Benke

See Also

['readSource()']

Description

Reads excel sheet with NDC (Nationally Determined Contributions) data on different policy targets (capacity, emission, and share targets) with different variations

Usage

readUNFCCC_NDC(subtype)

Arguments

Details

Country name is ISO coded. Capacity/Additional Capacity targets are in GW. Generation/Production targets are in GWh.

Value

magpie object

Author(s)

Aman Malik, Christoph Bertram, Oliver Richters, Sophie Fuchs, Rahel Mandaroux

Description

Read-in an WGBU xlsx file as magclass object

Usage

readWGBU()

Value

magpie object of WGBU

Author(s)

Lavinia Baumstark

See Also

readSource

Examples

## Not run: 
a <- readSource(type = "WGBU")

## End(Not run)

Description

Wrapper around magclass::add_dimension supporting more than one value for the new dimension. For each value, the input magclass object is copied, extended by the new dimension and appended to the output.

Usage

toolAddDimensions(x, dimVals, dimName, dimCode)

Arguments

Value

the extended magclass object

Description

Aggregate values to n-year averages to suppress volatility

Usage

toolAggregateTimeSteps(x, nYears = 5)

Arguments

Value

magclass object with averages

Author(s)

Robin Hasse

Description

toolBiomassSupplyAggregate The function aggregates biomass supply curves to regionmapping different from H12. It only works if all regions are subregions of H12 regions. The offset parameter (a) is taken from the H12 region. The slope parameter (b) is multiplied by a weight. The weight is the inverse of the share of agricultural area of the subregion in the H12 region.

Usage

toolBiomassSupplyAggregate(
  x,
  rel = NULL,
  weight = calcOutput("FAOLand", aggregate = F)[, , "6610", pmatch = TRUE][, "y2010", ]
)

Arguments

Value

return: returns region aggregated biomass supply curve data

Author(s)

Felix Schreyer

Description

Estimates the function that represents the sum of cubic function inverses (sum in the x-axis)

Usage

toolCubicFunctionAggregate(
  x,
  rel = NULL,
  xLowerBound = 0,
  xUpperBound = 100,
  returnMagpie = TRUE,
  returnCoeff = TRUE,
  returnChart = FALSE,
  returnSample = FALSE,
  numberOfSamples = 1000,
  unirootLowerBound = -10,
  unirootUpperBound = 1e+100,
  colourPallete = FALSE,
  label = list(x = "x", y = "y", legend = "legend"),
  steepCurve = list()
)

Arguments

Details

Use case: aggregate country cubic cost functions to a single function that represents the entire region.

input: coefficients of the n-th country level cubic cost function.

Description of the problem: the aggregation of functions that represent unit costs, or prices in the y-axis, and quantities in the x-axis require operations with the inverse of the original functions. As complex functions present analytically challenging inverse function derivations, we adopt a sampling method to derive the function that corresponds to the sum of cubic function inverses.

Further extensions: the R function can be extended to support more complex curve estimations (beyonf third degree), whenever the mathematical function have a well defined inverse function in the selected boundaries.

Value

return: returns a list of magpie objects containing the coefficients for the aggregate function. If returnMagpie is FALSE, returns a list containing the coefficients for the aggregate function (returnCoeff=TRUE), charts (returnChart=FALSE) and/or samples used in the estimation (returnSample=FALSE).

Author(s)

Renato Rodrigues

See Also

toolCubicFunctionDisaggregate

Examples

# Example
# data
EUR <- setNames(data.frame(30, 50, 0.123432, 2), c("c1", "c2", "c3", "c4"))
NEU <- setNames(data.frame(30, 50, 1.650330, 2), c("c1", "c2", "c3", "c4"))
df <- rbind(EUR, NEU)
row.names(df) <- c("EUR", "NEU")
# maxExtraction (upper limit for function estimation)
maxExtraction <- 23
# output
output <- toolCubicFunctionAggregate(df,
  xUpperBound = maxExtraction,
  returnMagpie = FALSE, returnChart = TRUE, returnSample = TRUE,
  label = list(x = "Cumulated Extraction", y = "Cost", legend = "Region Fuel Functions")
)
output$coeff
output$chart

Description

Estimates cubic function inverses based on a weight factor that sum up to the original cubic function (sum in the x-axis)

Usage

toolCubicFunctionDisaggregate(
  x,
  weight,
  rel = NULL,
  xLowerBound = 0,
  xUpperBound = 100,
  returnMagpie = TRUE,
  returnCoeff = TRUE,
  returnChart = FALSE,
  returnSample = FALSE,
  numberOfSamples = 1000,
  unirootLowerBound = -10,
  unirootUpperBound = 1e+100,
  colourPallete = FALSE,
  label = list(x = "x", y = "y", legend = "legend")
)

Arguments

Details

Use case: disaggregate a single region cubic cost function to multiple country cubic functions weighted by a contribution factor. The sum of the countries function output is equal to the original regional function.

input: coefficients of the n-th country level cubic cost function.

Description of the problem: the disaggregation of functions that represent unit costs (or prices) in the y-axis and quantities in the x-axis require operations with the inverse of the original functions. As complex functions present analytically challenging inverse function derivations, we adopt a sampling method to derive the function that corresponds to the sum of cubic function inverses.

Further extensions: the R function can be extended to support more complex curve estimations (beyond third degree), whenever the mathematical function have a well defined inverse function in the selected boundaries.

Value

return: returns a list of magpie objects containing the coefficients for the aggregate function. If returnMagpie is FALSE, returns a list containing the coefficients for the aggregate function (returnCoeff=TRUE), charts (returnChart=FALSE) and/or samples used in the estimation (returnSample=FALSE).

Author(s)

Renato Rodrigues

See Also

toolCubicFunctionAggregate

Examples

# Example
# LAM coefficients
df <- setNames(data.frame(30, 50, 0.34369, 2), c("c1", "c2", "c3", "c4"))
row.names(df) <- "LAM"
# weight
weight <- setNames(c(21, 0, 579, 3, 228), c("ARG", "BOL", "BRA", "CHL", "COL"))
# maxExtraction (upper limit for function estimation)
maxExtraction <- 100
# output
output <- toolCubicFunctionDisaggregate(df, weight,
  xUpperBound = maxExtraction,
  returnMagpie = FALSE, returnChart = TRUE, returnSample = TRUE,
  label = list(x = "Cumulated Extraction", y = "Cost", legend = "Region Fuel Functions")
) #' output$chart
output$coeff
output$chart

Description

Sets values for 6 EU countries not belonging to EU 28 but EU 34 to zero if they are NA. Used to avoid EUR region yielding NA because of these countries.

Usage

toolFillEU34Countries(x)

Arguments

Author(s)

Falk Benke

Description

Aggregate Solar data into regions

Usage

toolSolarFunctionAggregate(
  x,
  rel = NULL,
  weight = calcOutput("FE", aggregate = FALSE)[, "y2015", "FE|Electricity (EJ/yr)"]
)

Arguments

Value

return: returns region aggregated solar data

Author(s)

Felix Schreyer, Renato Rodrigues, Julian Oeser