Package 'mrtransport'

Title: Input data generation for the EDGE-Transport model
Description: The mrtransport package contains data preprocessing for the EDGE-Transport model.
Authors: Johanna Hoppe [aut, cre] , Jarusch Muessel [aut], Alois Dirnaichner [aut]
Maintainer: Johanna Hoppe <[email protected]>
License: LGPL-3 | file LICENSE
Version: 0.10.1
Built: 2024-12-19 10:25:24 UTC
Source: https://github.com/pik-piam/mrtransport

Help Index

mrtransport: Input data generation for the EDGE-Transport model

Description

The mrtransport package contains data preprocessing for the EDGE-Transport model.

Author(s)

Maintainer: Johanna Hoppe [email protected] (ORCID)

Authors:

See Also

Useful links:

Provide EDGE-Transport input parameters

Description

Provide EDGE-Transport input parameters

Usage

calcEdgeTransportSAinputs(subtype, SSPscen = "SSP2", IEAharm = TRUE)

Arguments

subtype

one of the parameters required for EDGE-T SA
SSPscen

shared socioeconomic pathway
IEAharm

switch IEA harmonization of energy intensity on and off

Author(s)

Johanna Hoppe

Calc Input Output

Description

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

Usage

calcIEAOutputTransport()

Details

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

Value

IEA data as MAgPIE object aggregated to country level

Author(s)

Falk Benke

Convert Eurostat road transportation data to iso country.

Description

Convert Eurostat road transportation data to iso country.

Usage

convertEurostatEnergyCountryDataSheets(x, subtype)

Arguments

x

a magpie data object
subtype

One of the possible subtypes, see default argument.

Value

magpie object

Author(s)

Johanna Hoppe

See Also

readSource

Examples

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

## End(Not run)

Convert GCAM transportation data to iso country level.

Description

Convert GCAM transportation data to iso country level.

Usage

convertGCAM(x, subtype)

Arguments

x

a magpie data object
subtype

One of the possible subtypes, see default argument.

Value

magpie object

Author(s)

Johanna Hoppe, Alois Dirnaichner

See Also

readSource

Examples

## Not run: 
a <- readSource("GCAM", subtype = "esDemand")

## End(Not run)

Convert PSI data to iso country.

Description

Convert PSI data to iso country.

Usage

convertPSI(x, subtype)

Arguments

x

a magpie data object
subtype

One of the possible subtypes, see default argument.

Value

magpie object

Author(s)

Johanna Hoppe

See Also

readSource

Examples

## Not run: 
a <- readSource("PSI", subtype = "costs")

## End(Not run)

Convert TRACCS road transportation data to iso country.

Description

Convert TRACCS road transportation data to iso country.

Usage

convertTRACCS(x, subtype)

Arguments

x

a magpie data object
subtype

One of the possible subtypes, see default argument.

Value

magpie object

Author(s)

Johanna Hoppe, Alois Dirnaichner

See Also

readSource

Examples

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

## End(Not run)

Converts transport subsidies data

Description

Converts transport subsidies data

Usage

convertTransportPurchasePriceSubsidies(x)

Arguments

x

MAgPIE object to be converted

Value

A MAgPIE object containing transport subsidies per technology

Author(s)

Caroline Cronjaeger

Examples

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

Converts transport subsidies data

Description

Converts transport subsidies data

Usage

convertTransportSubsidies(x)

Arguments

x

MAgPIE object to be converted

Value

A MAgPIE object containing transport subsidies per technology

Author(s)

Renato Rodrigues

Examples

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

## End(Not run)

Convert UCD road transportation data to iso country.

Description

Convert UCD road transportation data to iso country.

Usage

convertUCD(x, subtype)

Arguments

x

a magpie data object
subtype

One of the possible subtypes, see default argument.

Value

magpie object

Author(s)

Johanna Hoppe, Alois Dirnaichner

See Also

readSource

Examples

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

## End(Not run)

Correct GCAM road transportation data to iso country.

Description

Correct GCAM road transportation data to iso country.

Usage

correctGCAM(x, subtype)

Arguments

x

a magpie data object
subtype

One of the possible subtypes, see default argument.

Value

magclass object

Author(s)

Johanna Hoppe, Alois Dirnaichner

See Also

readSource

Examples

## Not run: 
a <- readSource("GCAM", subtype="histESdemand")

## End(Not run)

Read Eurostat data.

Description

Read Eurostat data.

Usage

readEurostatEnergyCountryDataSheets(subtype = c("feDemand", "LDVfleet"))

Arguments

subtype

One of the possible subtypes, see default argument.

Value

magclass object

Author(s)

Johanna Hoppe

See Also

readSource

Examples

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

## End(Not run)

Read GCAM transportation data.

Description

Read GCAM transportation data.

Usage

readGCAM(
  subtype = c("energyIntensity", "loadFactor", "histESdemand", "speedMotorized",
    "speedNonMotorized", "valueOfTimeMultiplier")
)

Arguments

subtype

One of the possible subtypes, see default argument.

Value

magpie object

Author(s)

Johnna Hoppe, Alois Dirnaichner

See Also

readSource

Examples

## Not run: 
a <- readSource("GCAM", subtype = "histEDsemand")

## End(Not run)

Read PSI data.

Description

Read PSI data.

Usage

readPSI(subtype = c("CAPEX", "energyIntensity"))

Arguments

subtype

One of the possible subtypes, see default argument.

Value

magpie object

Author(s)

Johnna Hoppe

See Also

readSource

Examples

## Not run: 
a <- readSource("PSI", subtype = "energyIntensity")

## End(Not run)

Load fuel prices from a REMIND fulldata.gdx in USD/MJ

Description

Load fuel prices from a REMIND fulldata.gdx in USD/MJ

Usage

readREMINDinputForTransportStandalone()

Read TRACCS road transportation data.

Description

Read TRACCS road transportation data.

Usage

readTRACCS(
  subtype = c("fuelEnDensity", "roadFuelConsumption", "energyIntensity", "loadFactor",
    "annualMileage", "roadESdemand", "histESdemand", "railFeDemand", "vehPopulation")
)

Arguments

subtype

One of the possible subtypes, see default argument.

Value

magclass object

Author(s)

Alois Dirnaichner

See Also

readSource

Examples

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

## End(Not run)

Read transport subsidies data

Description

Read-in transport subsidies csv files as magclass object

Usage

readTransportPurchasePriceSubsidies()

Value

magpie object of the transport subsidies for BEV, FCEV and PHEV (euros/car) for private and legal entities

Author(s)

Caroline Cronjaeger

See Also

readSource

Examples

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

Read transport subsidies data

Description

Read-in transport subsidies csv files as magclass object

Usage

readTransportSubsidies()

Value

magpie object of the transport subsidies for BEV, FCEV and PHEV (euros/car) for private and legal entities

Author(s)

Renato Rodrigues

See Also

readSource

Examples

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

Read UCD road transportation data.

Description

Read UCD road transportation data.

Usage

readUCD(
  subtype = c("energyIntensity", "feDemand", "loadFactor", "annualMileage",
    "nonMotorizedDemand", "speed", "CAPEX", "nonFuelOPEX", "CAPEXandNonFuelOPEX",
    "OperatingSubsidies")
)

Arguments

subtype

One of the possible subtypes, see default argument.

Value

magclass object

Author(s)

Johanna Hoppe, Alois Dirnaichner

See Also

readSource

Examples

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

## End(Not run)

Perform parameter specific adjustments on the input data

Description

Perform parameter specific adjustments on the input data

Usage

toolAdjustAnnualMileage(dt, completeData, filter, ariadneAdjustments = TRUE)

Arguments

dt

calculated raw data without adjustments
completeData

All combinations of region, period, univocalName and technology in EDGE-T decision tree
filter

list of filters for specific branches in the upper decision tree, containing all associated univocalNames
ariadneAdjustments

switch on and off adjustments according to ARIADNE model intercomparison in 2022

Value

a quitte object

Author(s)

Johanna Hoppe

Perform parameter specific adjustments on the input data

Description

Perform parameter specific adjustments on the input data

Usage

toolAdjustCAPEXother(dt, ISOcountries, yrs, completeData, GDPpcMER, filter)

Arguments

dt

calculated raw data without adjustments
ISOcountries

list of iso countries
yrs

temporal resolution of EDGE-T model
completeData

All combinations of region, period, univocalName and technology in EDGE-T decision tree
GDPpcMER

GDP per capita based on market exchange rate
filter

list of filters for specific branches in the upper decision tree, containing all associated univocalNames

Value

a quitte object

Author(s)

Johanna Hoppe

Perform parameter specific adjustments on the input data

Description

Perform parameter specific adjustments on the input data

Usage

toolAdjustCAPEXtrackedFleet(
  dt,
  ISOcountries,
  yrs,
  completeData,
  GDPpcMER,
  filter
)

Arguments

dt

calculated raw data without adjustments
ISOcountries

list of iso countries
yrs

temporal resolution of EDGE-T model
completeData

All combinations of region, period, univocalName and technology in EDGE-T decision tree
GDPpcMER

GDP per capita based on market exchange rate
filter

list of filters for specific branches in the upper decision tree, containing all associated univocalNames

Value

a quitte object

Author(s)

Johanna Hoppe

Perform parameter specific adjustments on the input data

Description

Perform parameter specific adjustments on the input data

Usage

toolAdjustEnergyIntensity(
  dt,
  regionTRACCS,
  TrendsEnIntPSI,
  filter,
  ariadneAdjustments = TRUE
)

Arguments

dt

calculated raw data without adjustments
regionTRACCS

iso countries included in TRACCS database
TrendsEnIntPSI

Energy intensity trends from PSI
filter

list of filters for specific branches in the upper decision tree, containing all associated univocalNames
ariadneAdjustments

optional parameter adjustements according to ARIADNE model intercomparison in 2022

Value

a quitte object

Author(s)

Johanna Hoppe

Perform parameter specific adjustments on the input data

Description

Perform parameter specific adjustments on the input data

Usage

toolAdjustEsDemand(dt, mapIso2region, completeData, filter)

Arguments

dt

calculated raw data without adjustments
mapIso2region

map iso countries to regions
completeData

All combinations of region, period, univocalName and technology in EDGE-T decision tree
filter

list of filters for specific branches in the upper decision tree, containing all associated univocalNames

Value

a quitte object

Author(s)

Johanna Hoppe

Perform parameter specific adjustments on the input data

Description

Perform parameter specific adjustments on the input data

Usage

toolAdjustLoadFactor(dt, completeData, TRACCScountries, filter)

Arguments

dt

calculated raw data without adjustments
completeData

All combinations of region, period, univocalName and technology in EDGE-T decision tree
TRACCScountries

countries included in TRACCS database
filter

list of filters for specific branches in the upper decision tree, containing all associated univocalNames

Value

a quitte object

Author(s)

Johanna Hoppe

Perform parameter specific adjustments on the input data

Description

Perform parameter specific adjustments on the input data

Usage

toolAdjustNonFuelOPEXother(dt, ISOcountries, yrs, completeData, filter)

Arguments

dt

calculated raw data without adjustments
ISOcountries

list of iso countries
yrs

temporal resolution of EDGE-T model
completeData

All combinations of region, period, univocalName and technology in EDGE-T decision tree
filter

list of filters for specific branches in the upper decision tree, containing all associated univocalNames

Value

a quitte object

Author(s)

Johanna Hoppe

Perform parameter specific adjustments on the input data

Description

Perform parameter specific adjustments on the input data

Usage

toolAdjustNonFuelOPEXtrackedFleet(dt, yrs, completeData, filter)

Arguments

dt

calculated raw data without adjustments
yrs

temporal resolution of EDGE-T model
completeData

All combinations of region, period, univocalName and technology in EDGE-T decision tree
filter

list of filters for specific branches in the upper decision tree, containing all associated univocalNames

Value

a quitte object

Author(s)

Johanna Hoppe

Perform parameter specific adjustments on the input data

Description

Perform parameter specific adjustments on the input data

Usage

toolAdjustSpeedOfModes(dt, completeData, filter)

Arguments

dt

calculated raw data without adjustments
completeData

All combinations of region, period, univocalName and technology in EDGE-T decision tree
filter

list of filters for specific branches in the upper decision tree, containing all associated univocalNames

Value

a quitte object

Author(s)

Johanna Hoppe

Perform parameter specific adjustments on the input data

Description

Perform parameter specific adjustments on the input data

Usage

toolAdjustValueOfTimeMultiplier(dt, completeData, filter)

Arguments

dt

calculated raw data without adjustments
completeData

All combinations of region, period, univocalName and technology in EDGE-T decision tree
filter

list of filters for specific branches in the upper decision tree, containing all associated univocalNames

Value

a quitte object

Author(s)

Johanna Hoppe

Aggregate vehicle types so that vehicle types that are only available in certain iso countries of a region are not lost and still appear in the aggregated region

Description

Aggregate vehicle types so that vehicle types that are only available in certain iso countries of a region are not lost and still appear in the aggregated region

Usage

toolAggregateVehicleTypes(...)

Arguments

...

magpie object to be aggregated

Value

a magpie object

Author(s)

Johanna Hoppe

Harmonize the energy intensities to match the IEA energy balances regarding final energy.

Description

We provide energy service trajectories. IEA energy balances have to be met and are not consistent with GCAM intensities and energy service trajectories. Therefore we have to adjust energy intensities and set the energy service demand to zero, where the IEA does not report the energy service demand

Usage

toolIEAharmonization(...)

Arguments

...

data to harmonize: Either the energy intensity or the energy service demnand

Merge source data for energy intensity

Description

Merge source data for energy intensity

Usage

toolMergeEnergyIntensity(data, filterEntries, countriesTRACCS)

Arguments

data

source data
filterEntries

helper to filter for univocalNames
countriesTRACCS

countries included in the TRACCS database

Author(s)

Johanna Hoppe

Merge source data for historical energy service demand

Description

Merge source data for historical energy service demand

Usage

toolMergeHistESdemand(data, filterEntries, countriesTRACCS)

Arguments

data

source data
filterEntries

helper to filter for univocalNames
countriesTRACCS

countries included in the TRACCS database

Author(s)

Johanna Hoppe

Perform source specific transformations to ensure a compatible structure.

Description

Map the source categories to the EDGE-T categories. Apply the full structure of the decision tree.

Usage

toolPrepareEurostatEnergyCountryDataSheets(x)

Arguments

x

the input data read via readSource, a magpie object

Value

a quitte object

Author(s)

Johanna Hoppe

Perform source specific transformations to ensure a compatible structure.

Description

Map the source categories to the EDGE-T categories. Apply the full structure of the decision tree.

Usage

toolPrepareGCAM(x, subtype)

Arguments

x

the input data read via readSource, a magpie object
subtype

one of the different EDGE-T inputdata subtypes

Value

a quitte object

Author(s)

Johanna Hoppe

Perform source specific transformations to ensure a compatible structure.

Description

Map the source categories to the EDGE-T categories. Apply the full logit structure.

Usage

toolPreparePSI(x)

Arguments

x

the input data read via readSource, a magpie object

Value

a quitte object

Author(s)

Johanna Hoppe

Perform source specific transformations to ensure a compatible structure.

Description

Map the source categories to the EDGE-T categories. Apply the full structure of the decision tree.

Usage

toolPreparePurchasePriceSubsidies(x)

Arguments

x

the input data read via readSource, a magpie object

Value

a quitte object

Author(s)

Caroline Cronjaeger

Perform source specific transformations to ensure a compatible structure.

Description

Map the source categories to the EDGE-T categories. Apply the full structure of the decision tree.

Usage

toolPrepareTRACCS(x, subtype)

Arguments

x

the input data read via readSource, a magpie object
subtype

one of the different EDGE-T inputdata subtypes

Value

a quitte object

Author(s)

Johanna Hoppe

Perform source specific transformations to ensure a compatible structure.

Description

Map the source categories to the EDGE-T categories. Apply the full structure of the decision tree.

Usage

toolPrepareUCD(x, subtype)

Arguments

x

the input data read via readSource, a magpie object
subtype

one of the different EDGE-T inputdata subtypes

Value

a quitte object

Author(s)

Johanna Hoppe