Package 'mrcommons'

Description

Calculates projections of first generation biofuels demand,including biogas, bioethamol and biodiesel, from IEA database. The unit is Petajoule.

Usage

calc1stBioDem(subtype = "all")

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Xiaoxi Wang, David Klein

See Also

calc1stBioenergyPast()

Examples

## Not run: 
calcOutput("1stBioDem")

## End(Not run)

Description

Calculates first generation biofuels production, imports, exports for biogas, bioethanol and biodiesel from IEA database. The unit is Petajoule.

Usage

calc1stBioenergyPast()

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Xiaoxi Wang, Isabelle Weindl

Examples

## Not run: 
calcOutput("1stBioenergyPast")

## End(Not run)

Description

reads in the ACCMIP atmospheric deposition database. Speeds up caching

Usage

calcACCMIP(glo_incl_oceans = FALSE)

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcAtmosphericDeposition()

Examples

## Not run: 
calcOutput("ACCMIP")

## End(Not run)

Description

Calculates the carbon emission adjustement factors as derived by Grassi et al. 2021 Adjustement factors are provided in GtCO2 yr-1. Positive and negative values possible.

Usage

calcAdjustGrassi2021()

Value

magpie object with emission adjustement factors weighted by country C removals 2000 to 2015.

Author(s)

Michael Windisch, Florian Humpenoeder

Examples

## Not run: 
calcOutput("AdjustGrassi2021")

## End(Not run)

Description

Calculate FAO Value Of Production

Usage

calcAgProductionValue(datasource = "FAO")

Arguments

Value

FAO Value Of Production as a list of MAgPIE objects

Author(s)

Roman Popov, Mishko Stevanovic, Patrick v. Jeetze

See Also

calcOutput(), readFAO(), convertFAO(), readSource()

Examples

## Not run: 
a <- calcOutput("AgProductionValue", datasource = "FAO")

## End(Not run)

Description

calculates stocks of animals of different categories.

Usage

calcAnimalStocks(grouping = "IPCC")

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcExcretionIPCC(), readIPCC()

Examples

## Not run: 
calcOutput("AnimalStocks")

## End(Not run)

Description

Computes Atmospheric (nitrogen) deposition on different land-use types. It distinguishes ammonia (Nh3) and Nitrogen oxides (NOx) as well

Usage

calcAtmosphericDeposition(
  datasource = "ACCMIP",
  glo_incl_oceans = FALSE,
  cellular = FALSE,
  cells = "lpjcell",
  emission = FALSE,
  scenario = NULL
)

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcNitrogenBudgetCropland()

Examples

## Not run: 
calcOutput("AtmosphericDeposition")

## End(Not run)

Description

Calculates share of volatilised nitrogen emissions that is redeposited on different land types.

Usage

calcAtmosphericRedepositionShare(
  cellular = FALSE,
  maxshare = 0.8,
  scenario = "rcp45"
)

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

Examples

## Not run: 
calcOutput("AtmosphericRedepositionShare")

## End(Not run)

Description

Calculates share of volatilised nitrogen emissions that is redeposited on different land types.

Usage

calcAtmosphericTransboundaryRedepositionShare(
  maxshare = 0.8,
  scenario = "rcp45"
)

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

Examples

## Not run: 
calcOutput("AtmosphericRedepositionShare")

## End(Not run)

Description

calculates the share of manure managed in different animal waste management systems in confinements. Starting with IPCC 2005 values, turning into scenarios for the future.

Usage

calcAWMSconfShr(rev = 0.1)

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky. Modifications by Edna J. Molina Bacca

See Also

calcAWMSconfShrPast()

Examples

## Not run: 
calcOutput("AWMSconfShr")

## End(Not run)

Description

calculates the share of manure excreted in different types of animal waste management systems in confinements in the year 2005 using the IPCC Guidelines excretion rates.

Usage

calcAWMSconfShrPast(products = "magpie")

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcAWMSconfShr(), calcExcretionIPCC()

Examples

## Not run: 
calcOutput("AWMSconfShrPast")

## End(Not run)

Description

Returns fraction of spatial unit (cell) belonging to a biome type of each biogeographic realm. The classification is based on data from 'the nature conservancy' (https://geospatial.tnc.org/datasets/b1636d640ede4d6ca8f5e369f2dc368b/about) originally developed by Olson et al. (2001), BioScience.

Usage

calcBiomeType(cells = "lpjcell")

Arguments

Value

List with a magpie object

Author(s)

Patrick v. Jeetze

See Also

readTNC2019

Examples

## Not run: 
calcOutput("BiomeType", aggregate = FALSE)

## End(Not run)

Description

calculates conversion factors from bioplastic demand to demand of biomass needed for the production, taking into account the average share of different biomass sources (glycerol, starch, sugars, cellulose, oils) for bioplastic production and corresponding content in the different crop types

Usage

calcBioplasticToBiomass()

Value

List of magpie objects with global conversion factors, unit and description.

Author(s)

Debbora Leip

Examples

## Not run: 
calcOutput("BioplasticToBiomass")

## End(Not run)

Description

reads in the Lutz et al dataset. Aggregates the age structure. Population is divided by sex male (M) , female (F) and both (B) and divided by 8 age classes: 0-4, 5-9, 10-14, 15-19, AG1 (20-29), AG2 (30-59), AG3(60-79), AG4(80+)

Usage

calcBodyHeight(convert = TRUE)

Arguments

Description

Calculates future central feed shares for all livestock categories based on the results of a non-linear regression between historical central feed shares and livestock productivity and using Koeppen- Geiger climate zones

Usage

calcCentralFeedshares()

Value

Central feed shares and weights as list of two MAgPIE-objects

Author(s)

Isabelle Weindl, Benjamin Bodirsky, Stephen Wirth, Jan Philipp Dietrich

Examples

## Not run: 
calcOutput("CentralFeedshares")

## End(Not run)

Description

fraction of a cell belonging to a given climate classification based on different climate cliassification schemes

Usage

calcClimateClass(datasource = "koeppen", cells = "magpiecell")

Arguments

Value

Clustered MAgPIE object on requested resolution

Author(s)

Abhijeet Mishra, Kristine Karstens

Examples

## Not run: 
calcOutput("ClimateClass", aggregate = FALSE)

## End(Not run)

Description

Carbon losses for livestock confinements

Usage

calcClossConfinement()

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Kristine Karstens

Examples

## Not run: 
calcOutput("ClossConfinement")

## End(Not run)

Description

Calculates the demand of construction wood from Galina et al. 2020 data. See

Usage

calcConstructionWoodDemand()

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Abhijeet Mishra

See Also

calcFAOmassbalance_pre()

Examples

## Not run: 
calcOutput("ConstructionWoodDemand")

## End(Not run)

Description

reads in the Lutz et al dataset. Aggregates the age structure. Population is divided by sex male (M) , female (F) and both (B) and divided by 8 age classes: 0-4, 5-9, 10-14, 15-19, AG1 (20-29), AG2 (30-59), AG3(60-79), AG4(80+)

Usage

calcDemography(convert = TRUE, education = TRUE)

Arguments

Description

Provides development state of a country or region. We use worldbank definitions by default: above 12746 USD per capita, its a high-income country, below 1045 its a low-income country, in between its a medium-income country.

Usage

calcDevelopmentState(upper = 12746, lower = 1045)

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky, Kristine Karstens

See Also

calcGDPpc()

Examples

## Not run: 
calcOutput("DevelopmentState")

## End(Not run)

Description

Creates an emission inventory based on the EDGAR5 and EDGAR6 database.

Usage

calcEDGAR6(non_country = FALSE, nutrient = TRUE)

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

Description

Emission factors for nitrogenous emissions in livestock confinements

Usage

calcEF3confinement(products = "magpie", selection = "n_pollutants_direct")

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

Examples

## Not run: 
calcOutput("EF3confinement")

## End(Not run)

Description

Returns emission factor for manure excreted during pasture range and paddock. Differs depending on the share of small ruminants.

Usage

calcEF3prp(select_years = "y2005")

Arguments

Value

list of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

Examples

## Not run: 
calcOutput("EF3prp")

## End(Not run)

Description

Provides REMIND data for baseline emissions for maccs.

Usage

calcEmiMac()

Value

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

Author(s)

Lavinia Baumstark

See Also

calcOutput(), readSource()

Examples

## Not run: 
calcOutput("calcEmiMac")

## End(Not run)

Description

calculates nitrogenous emissions from animal waste management systems in the historical period

Usage

calcEmisNitrogenAWMSPast()

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

Examples

## Not run: 
calcOutput("EmisNitrogenAWMSPast")

## End(Not run)

Description

calculates nitrogenous emissions from croplands in the historical period.

Usage

calcEmisNitrogenCroplandPast(method = "IPCC")

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

Examples

## Not run: 
calcOutput("EmisNitrogenCroplandPast")

## End(Not run)

Description

Calculates nitrogenous emissions from non-agricultural land for the historical period

Usage

calcEmisNitrogenNonaglandPast(method = "Nsurplus")

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcEmisNitrogenPast(), calcExcretion()

Examples

## Not run: 
calcOutput("EmisNitrogenPasturePast")

## End(Not run)

Description

Conputes (nitrogen) emissions of Oceans.

Usage

calcEmisNitrogenOceans(method = "ACCMIP")

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcAtmosphericDeposition(), calcNitrogenBudgetCropland()

Examples

## Not run: 
calcOutput("EmisNitrogenOceans")

## End(Not run)

Description

Calculates nitrogenous emissions from all emission sources for the historical period. Complements own estimates with Edgar esimtates for the historical period.

Usage

calcEmisNitrogenPast(method = "IPCC")

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

Examples

## Not run: 
calcOutput("EmisNitrogenPast")

## End(Not run)

Description

Calculates nitrogenous emissions from pastures for the historical period

Usage

calcEmisNitrogenPasturePast(method = "IPCC")

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcEmisNitrogenPast(), calcExcretion()

Examples

## Not run: 
calcOutput("EmisNitrogenPasturePast")

## End(Not run)

Description

Calculates nitrogenous emissions Nitrogen emissions from soils under 100% natural cover (even for crop and urban) assuming a pre-agricultural time.

Usage

calcEmisNitrogenPreagriculture(cellular = FALSE, deposition = TRUE)

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcEmisNitrogenPast(), calcExcretion()

Examples

## Not run: 
calcOutput("EmisNitrogenPreagriculture")

## End(Not run)

Description

Calculates Nitrogen Budgets for surface Water on country levels.

Usage

calcEmisNitrogenWater(method = "Nsurplus")

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

Examples

## Not run: 
calcOutput("EmisNitrogenWater")

## End(Not run)

Description

providees an emission inventory for the past, either from external data or own estimates.

Usage

calcEmissionInventory(
  datasource = "CEDS",
  targetResolution = "sectoral",
  from = "CEDS59",
  to = "Sectors"
)

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky, Michael S. Crawford

Examples

## Not run: 
calcOutput("EmisNitrogenCroplandPast")

## End(Not run)

Description

calculates excretion during grazing, cropland-grazing, confinement and collected for fuel. Based on MAgPIE Feed baskets, slaughter biomass and simple allocation rules.

Usage

calcExcretion(cellular = FALSE, cells = "lpjcell", attributes = "npk")

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcExcretionIPCC()

Examples

## Not run: 
calcOutput("Excretion")

## End(Not run)

Description

calculates excretion in the year 2005 using the IPCC Guidelines excretion rates.

Usage

calcExcretionIPCC(products = "IPCC")

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcExcretion(), calcAnimalStocks()

Examples

## Not run: 
calcOutput("ExcretionIPCC")

## End(Not run)

Description

Distribute massbalanced or FAOSTAT staple production to monthly or quarterly interval based on GGCMI crop calendar. Only national level implemented for now as cellular production only available on 5 year time steps due to memory. Assume rainfed crop calendar date for now.

Usage

calcFAOIntraYearProd(
  day = "harvest_day",
  products = "kcr",
  frequency = "monthly",
  attribute = "dm"
)

Arguments

Author(s)

David Chen

Description

Calculates a massbalance dataset of agricultural production, processing and use out of the combined data of calcFAOharmonized(). Covers dry matter (DM), reactive nitrogen (Nr), Phosphorus (P), Generalizable Energy (GE) and wet matter (WM). New products are added to the Food Balance Sheets, and many processing conversions are made more explicit using simple assumptions. The first part of this function is the calcFAOmassbalance_pre.

Usage

calcFAOmassbalance()

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky, Xiaoxi Wang

See Also

calcFAOmassbalance_pre()

Examples

## Not run: 
calcOutput("FAOmassbalance")

## End(Not run)

Description

calculates the yield based on FAO data

Usage

calcFAOYield(
  physical = TRUE,
  attributes = "dm",
  irrigation = FALSE,
  cellular = FALSE,
  cut = FALSE,
  average = 5,
  areaSource = "FAO"
)

Arguments

Value

MAgPIE object of yields

Author(s)

Debbora Leip, Jan Philipp Dietrich, Kristine Karstens, Felicitas Beier

Description

Calculates feed balanceflows from MAgPIE-Feed model to meet FAO data

Usage

calcFeedBalanceflow(
  per_livestock_unit = FALSE,
  cellular = FALSE,
  cells = "lpjcell",
  products = "kall",
  future = "constant"
)

Arguments

Value

List of magpie objects with results on country or cellular level, unit and description.

Author(s)

Isabelle Weindl, Kristine Karstens

Examples

## Not run: 
calcOutput("FeedBalanceflow")

## End(Not run)

Description

Combines feed baskets of the past with scenario-dependent future feed baskets.

Usage

calcFeedBaskets(non_eaten_food = FALSE, fadeout = FALSE, method = "new")

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Isabelle Weindl, Benjamin Leon Bodirsky, Stephen Wirth, Jan Philipp Dietrich

Examples

## Not run: 
calcOutput("FeedBaskets")

## End(Not run)

Description

Calculate historical feed baskets based on output of MAgPIE_FEED model as DM feed biomass (different types of feed) needed per DM livestock products

Usage

calcFeedBasketsPast(non_eaten_food = TRUE)

Arguments

Value

Historical feed baskets and corresponding weights as a list of two MAgPIE objects

Author(s)

Isabelle Weindl, Benjamin Bodirsky

See Also

calcOutput(), readFeedModel()

Examples

## Not run: 
calcOutput("FeedBasketsPast")

## End(Not run)

Description

Calculate historical system-specific feed baskets based on output of MAgPIE_FEED model as DM feed biomass (different types of feed) needed per DM livestock products of respective systems

Usage

calcFeedBasketsSysPast()

Value

Historical system-specific feed baskets and corresonding weights as a list of two MAgPIE objects

Author(s)

Isabelle Weindl, Benjamin Bodirsky, Jan Philipp Dietrich

See Also

calcOutput(), readFeedModel(), calcFeedBasketsPast()

Examples

## Not run: 
calcOutput("FeedBasketsSysPast")

## End(Not run)

Description

Combines uncalibrated feed baskets of the past with scenario-dependent future feed baskets.

Usage

calcFeedBasketsUncalibrated()

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Isabelle Weindl, Benjamin Leon Bodirsky, Stephen Wirth, Jan Philipp Dietrich

Examples

## Not run: 
calcOutput("FeedBasketsUncalibrated")

## End(Not run)

Description

Calculates future central feed shares for all livestock categories based on the results of a non-linear regression between historical central feed shares and livestock productivity and using Koeppen- Geiger climate zones

Usage

calcFeedEfficiencyFuture()

Value

Central feed shares and weights as list of two MAgPIE-objects

Author(s)

Isabelle Weindl, Benjamin Bodirsky, Stephen Wirth

Examples

## Not run: 
calcOutput("FeedEfficiencyFuture")

## End(Not run)

Description

Combines feed baskets of the past with livestock production to get total feed demand

Usage

calcFeedPast(
  balanceflow = TRUE,
  cellular = FALSE,
  cells = "lpjcell",
  products = "kall",
  nutrients = "all"
)

Arguments

Value

List of magpie objects with results on country or cellular level, unit and description.

Author(s)

Isabelle Weindl, Benjamin Leon Bodirsky, Kristine Karstems

Examples

## Not run: 
calcOutput("FeedPast")

## End(Not run)

Description

calculates the crop-specific use of different N inputs

Usage

calcFertilizerByCrop(
  indicator = "total",
  deposition = "Nsurplus2",
  cellular = FALSE
)

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcNitrogenBudgetCropland()

Examples

## Not run: 
calcOutput("FertilizerByCrop")

## End(Not run)

Description

Provides FertN data for N.No changes to the content have been done.

Usage

calcFertN(
  appliedto = "total",
  cellular = FALSE,
  deposition = "CEDS",
  max_snupe = 0.85
)

Arguments

Value

Fertilizer data for N and corresonding weights as a list of two MAgPIE objects

Author(s)

Lavinia Baumstark

See Also

calcOutput(), readIFA(), convertIFA(), readSource()

Examples

## Not run: 
calcOutput("FertN")

## End(Not run)

Description

Calculates the food supply (as defined by FAO, including intake and household waste) for the past.

Usage

calcFoodSupplyPast(
  per_capita = TRUE,
  products = NULL,
  product_aggr = FALSE,
  populationweight = "PopulationPast",
  attributes = c("kcal", "protein", "wm")
)

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky, Xiaoxi Wang

See Also

calcFAOharmonized()

Examples

## Not run: 
calcOutput("FoodSupplyPast")

## End(Not run)

Description

returns governance indicator from Andrijevic et al. 2019

Usage

calcGovernanceIndicator()

Value

magpie object at iso-country level

Author(s)

Felicitas Beier

Examples

## Not run: 
calcOutput("GovernanceIndicator", aggregate = FALSE)

## End(Not run)

Description

Calculates the growing stocks on FAO data.

Usage

calcGrowingStock()

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Abhijeet Mishra

Examples

## Not run: 
calcOutput("GrowingStock", aggregate = TRUE)

## End(Not run)

Description

Calculates the growing stocks on FAO data.

Usage

calcGrowingStockNatVegAbsolute()

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Abhijeet Mishra

Examples

## Not run: 
calcOutput("GrowingStockNatVegAbsolute", aggregate = TRUE)

## End(Not run)

Description

Calculates the growing stocks from FAO data for naturally regenerating forests i.e. primary forests and secondary forests.

Usage

calcGrowingStockNRF()

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Abhijeet Mishra

Examples

## Not run: 
calcOutput("GrowingStockNRF", aggregate = TRUE)

## End(Not run)

Description

Calculates the growing stocks on FAO data.

Usage

calcGrowingStockpha()

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Abhijeet Mishra

Examples

## Not run: 
calcOutput("GrowingStockpha", aggregate = TRUE)

## End(Not run)

Description

Calculates the growing stocks on FAO data.

Usage

calcGrowingStockPlantAbsolute()

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Abhijeet Mishra

Examples

## Not run: 
calcOutput("GrowingStockPlantAbsolute", aggregate = TRUE)

## End(Not run)

Description

Calculates the growing stocks on FAO data.

Usage

calcGrowingStockPlantations()

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Abhijeet Mishra

Examples

## Not run: 
calcOutput("GrowingStockPlantations", aggregate = TRUE)

## End(Not run)

Description

Calculates iso-level total global transport costs from GTAP for GTAP food commodities

Usage

calcGTAPTotalTransportCosts(costType = "transport", version = "9")

Arguments

Value

List of magpie object with results on country level, unit and description.

Author(s)

David M Chen

Examples

## Not run: 
calcOutput("GTAPTotalTransportCosts")

## End(Not run)

Description

calculates historic bioplastic production based on data and linear extrapolation

Usage

calcHistBioplasticProd()

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Debbora Leip

Examples

## Not run: 
calcOutput("HistBioplasticProd")

## End(Not run)

Description

Provides historical emissions values per economic sector or per mac sector. For now it only includes European data.

Usage

calcHistEmissions(subtype = "sector")

Arguments

Value

magpie object of historical emissions data

Author(s)

Renato Rodrigues

Examples

## Not run: 
calcOutput("HistEmissions")

## End(Not run)

Description

provides global prices from the IMPACT model projections for MAgPIE commodities for the initialization of the flexible demand model.

Usage

calcIniFoodPrice(datasource = "FAO", year = "y2005", products = "kfo")

Arguments

Value

List with a magpie object with commodity prices on global level in $17/tDM.

Note

The IMPACT projections start in 2005 and the prices are taken from that year.

Author(s)

Mishko Stevanovic, Benjamin Leon Bodirsky

See Also

readIMPACT3.2.2World_Price()

Examples

## Not run: 
calcOutput("IniFoodPrice", aggregate = FALSE)

## End(Not run)

Description

it computes the total intake kcal/day procapita through the population dataset by Lutz 2014, height and BMI data of NCDrisc, and phyiscal inactivity levels based on Halal et al.

Usage

calcIntake(
  convert = TRUE,
  modelinput = FALSE,
  standardize = FALSE,
  method = "FAO_WHO_UNU1985"
)

Arguments

Value

total "healthy" intake kcal/day procap for each countries divided by sex and 8 age groups.

Author(s)

Benjamin Leon Bodirsky

Description

it computes the food intake pro capita through the bodyweight and the activity level. First it computes the basal metabolic rate (bmr) through the Schofield equation and then the estimated energy required (eer) depending on the activitiy level by FAO/WHO/UNU tables (Human Energy Requirments, Rome 2004)

Usage

calcIntakeBodyweight(
  bodyweight,
  bodyheight = NULL,
  inactivity,
  tmean = NULL,
  method = NULL
)

Arguments

Author(s)

Eleonora Martinelli

Description

Calculates buildings-related energy flows from the IEA energy balances. 'output_EDGE_buildings' is a key input to EDGE-Buildings providing the historic final energy demand from buildings. 'output_EDGE' does the same for buildings and industry together.

Usage

calcIOEdgeBuildings(
  subtype = c("output_EDGE", "output_EDGE_buildings"),
  ieaVersion = c("default", "latest")
)

Arguments

Value

IEA data as MAgPIE object aggregated to country level

Author(s)

Pascal Sauer, Anastasis Giannousakis, Robin Hasse

See Also

calcOutput

Examples

## Not run: 
a <- calcOutput("IOEdgeBuildings", subtype = "output_EDGE_buildings")

## End(Not run)

Description

Emission factors for croplands based on IPCC using a country-level leaching fraction

Usage

calcIPCCefNSoil()

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

Examples

## Not run: 
calcOutput("IPCCefNSoil")

## End(Not run)

Description

calculates the leaching rate FRAC_LEACH as defined by the IPCC Guidelines for National Greenhouse Gas Inventories 2006. We use the approach used by Canada, see Velthof, Gerardus Lambertus, and J. Mosquera Losada. 2011. Calculation of Nitrous Oxide Emission from Agriculture in the Netherlands: Update of Emission Factors and Leaching Fraction. Alterra. http://library.wur.nl/WebQuery/wurpubs/406284.

Usage

calcIPCCfracLeach(cellular = TRUE)

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcOutput()

Examples

## Not run: 
a <- calcOutput("IPCCfracLeach", cellular = FALSE)

## End(Not run)

Description

total land area in a cell

Usage

calcLandArea(cells = "lpjcell")

Arguments

Value

magpie object in cellular resolution

Author(s)

Jan Philipp Dietrich, Felicitas Beier

Examples

## Not run: 
calcOutput("LandArea", aggregate = FALSE)

## End(Not run)

Description

Land emission data. This function was originally called calcValidEmissions and located in mrvalidation.

Usage

calcLandEmissions(datasource = "CEDS")

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky, Michael S. Crawford

Examples

## Not run: 
calcOutput("LandEmissions")

## End(Not run)

Description

This function prepares total tau values for use. As the source data already provides all required information this function purely removes unrequired data and moves the xref values to the weighting object which is required for aggregation.

Usage

calcLanduseIntensity(sectoral = "kcr", rescale = TRUE)

Arguments

Value

Total tau data and corresponding weights as a list of two MAgPIE objects

Author(s)

Benjamin Leon Bodirsky, Kristine Karstens, Felicitas Beier

See Also

calcTauTotal(), readTau(), convertTau()

Examples

## Not run: 
calcOutput("LanduseIntensity")

## End(Not run)

Description

Distributes crop, pasture and livestock production in space to 0.5 degree

Usage

calcLivestockGridded(details = FALSE)

Arguments

Value

List of magpie objects with results on cellular level, weights on cellular level, unit and description.

Author(s)

Kristine Karstens

Examples

## Not run: 
calcOutput("calcLivestockGridded")

## End(Not run)

Description

Provides MAgPIE-FEED data for livestock-yields calculated in the regression for feed (calcRegressionFEED).. No changes to the content have been done, besides renaming and providing weights.

Usage

calcLivestockProductivity(future = TRUE)

Arguments

Value

MAgPIE-FEED data for livestock-yields and corresonding weights as a list of two MAgPIE objects

Author(s)

Isabelle Weindl, Lavinia Baumstark, Stephen Wirth

See Also

calcOutput(), readSource()

Examples

## Not run: 
calcOutput("LivestockProductivity")

## End(Not run)

Description

calcMacBase calculate MacBase

Usage

calcMacBaseLandUse(subtype)

Arguments

Value

magpie object

Author(s)

David Klein, Julian Oeser

See Also

calcOutput()

Examples

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

## End(Not run)

Description

Calculation of the CH4 relative costcurves (subtypes: Energy Industry and Landuse) weighted by the baseline emissions. Sources: CH4 coal losses/leakages, CH4 oil losses/leakages, CH4 natural gas losses/leakages, CH4 Landfills, CH4 Domestic Sewage, CH4 Wetland rice, CH4 Animals, CH4 Animal waste divided in classes 1-201.

Usage

calcMACCsCH4(sector = "all", source = "ImageMacc")

Arguments

Value

MAgPIE object

Author(s)

Nele Steinmetz, Florian Humpenoeder, Michael Windisch

See Also

calcOutput(), readImageMacc(), convertImageMacc()

Examples

## Not run: 
calcOutput("MACCsCH4")

## End(Not run)

Description

Calculation of the N2O relative costcurves (subtypes: Energy Industry and Landuse) weighted by the baseline emissions. Sources: N2O Transport, N2O Adipic acid production, N2O Nitric acid production, N2O Fertilizer, N2O Animal waste, N2O Domestic sewage divided in classes 1-201.

Usage

calcMACCsN2O(sector = "all", source = "ImageMacc")

Arguments

Value

MAgPIE object

Author(s)

Nele Steinmetz, Florian Humpenoeder, Michael Windisch

See Also

calcOutput(), readImageMacc(), convertImageMacc()

Examples

## Not run: 
calcOutput("MACCsN2O")

## End(Not run)

Description

calculates the share of Manure excreted during grazing which is collected for fuel. For the future, we assume that with the development, the fuel share reaches 0.

Usage

calcManureFuelShr(products = "magpie")

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcExcretion()

Examples

## Not run: 
calcOutput("ManureFuelShr")

## End(Not run)

Description

calculates manure recycling to cropland based on excretions, animal waste management types (and their shares per country) and emission factors for nitrogenous emissions in livestock confinements

Usage

calcManureRecyclingCroplandPast(
  products = "sum",
  cellular = FALSE,
  cells = "lpjcell"
)

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky, Kristine Karstens

See Also

calcExcretion()

Examples

## Not run: 
calcOutput("calcManureRecyclingCroplandPast")

## End(Not run)

Description

calculates fixation from freeliving bacteria and from nitrogen-fixing crops and natural vegetation

Usage

calcNitrogenBNF(cellular = FALSE)

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcNitrogenFixationPast()

Examples

## Not run: 
calcOutput("NitrogenBNF")

## End(Not run)

Description

Calculates Nitrogen Budgets for Cropland soils on country levels.

Usage

calcNitrogenBudgetCropland(
  cellular = FALSE,
  deposition = "CEDS",
  include_fertilizer = TRUE,
  max_snupe = 0.85
)

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

Examples

## Not run: 
calcOutput("NitrogenBudgetCropland")

## End(Not run)

Description

Calculates Nitrogen Budgets for Non-agricultural land on country levels.

Usage

calcNitrogenBudgetNonagland(
  deposition = "CEDS",
  max_nue = 0.95,
  cellular = FALSE
)

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

Examples

## Not run: 
calcOutput("NitrogenBudgetNonagland")

## End(Not run)

Description

Calculates Nitrogen Budgets for Oceans on global level. Values are placed in Antarcica (ATA)

Usage

calcNitrogenBudgetOcean(deposition = "ACCMIP", leaching = "Nsurplus")

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

Examples

## Not run: 
calcOutput("NitrogenBudgetOcean")

## End(Not run)

Description

Calculates Nitrogen Budgets for Pasture soils on country levels.

Usage

calcNitrogenBudgetPasture(
  cellular = FALSE,
  include_fertilizer = TRUE,
  deposition = "CEDS",
  max_nue = 0.9
)

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

Examples

## Not run: 
calcOutput("NitrogenBudgetPasture")

## End(Not run)

Description

calculates fixation from freeliving bacteria and from nitrogen-fixing crops

Usage

calcNitrogenFixationPast(
  fixation_types = "both",
  sum_plantparts = TRUE,
  cellular = FALSE,
  irrigation = FALSE
)

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcNitrogenFixationPast()

Examples

## Not run: 
calcOutput("calcNitrogenFixationPast")

## End(Not run)

Description

calculates fixation rates from natural ecosystems based on evapostranspiration

Usage

calcNitrogenFixationRateNatural(cells = "lpjcell")

Arguments

Value

List of magpie objects with results on global level, empty weight, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcNitrogenFixationPast() readHerridge()

Examples

## Not run: 
calcOutput("NitrogenFixationRateNatural")

## End(Not run)

Description

calculates the crop-specific withdrawals of nutrients from soils

Usage

calcNitrogenWithdrawalByCrop(
  indicator = "total",
  cellular = FALSE,
  irrigation = FALSE
)

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcNitrogenBudgetCropland()

Examples

## Not run: 
calcOutput("NitrogenWithdrawalByCrop")

## End(Not run)

Description

calculates the soil nitrogen uptake efficiency of pastures. # This is the nitrogen taken up from the soil (N in crop biomass minus biological fixation minus seed N) divided by the soil N inputs (fertilizer, manure etc). For the future, NUE scenarios are added.

Usage

calcNuePasture(cellular = FALSE, maccbase = TRUE)

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcSNUpE() calcNitrogenBudgetPasture()

Examples

## Not run: 
calcOutput("NuePasture")

## End(Not run)

Description

Nutrient Budget for Wastewater treatment and sewage

Usage

calcNutrientBudgetSewage(historic = TRUE)

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcNitrogenBudgetCropland()

Examples

## Not run: 
calcOutput("NutrientBudgetSewage")

## End(Not run)

Description

physical inactivity level estimate based on Hallal, Pedro C, Lars Bo Andersen, Fiona C Bull, Regina Guthold, William Haskell, and Ulf Ekelund. 2012. "Global Physical Activity Levels: Surveillance Progress, Pitfalls, and Prospects." The Lancet 380 (9838):247-57. https://doi.org/10.1016/S0140-6736(12)60646-1.

Usage

calcPhysicalInactivity(update = TRUE)

Arguments

Description

Calculates the cellular plantation area based on carbon densities

Usage

calcPlantationCellular()

Value

List of magpie object with results on cellular level, weight on cellular level, unit and description.

Author(s)

Abhijeet Mishra

Examples

## Not run: 
calcOutput("PlantationCellular")

## End(Not run)

Description

Calculates the calibration factors for plantation establishment globally

Usage

calcPlantEstablishCalib()

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Abhijeet Mishra

Examples

## Not run: 
calcOutput("PlantEstablishCalib", aggregate = TRUE)

## End(Not run)

Description

provides global prices from the IMPACT model projections, World Bank observations, and FAO observations for MAgPIE commodities in $/tDM

Usage

calcPriceAgriculture(datasource = "IMPACT3.2.2World_Price", unit = "US$17/tDM")

Arguments

Value

List with a magpie object with commodity prices

Author(s)

Mishko Stevanovic, Xiaoxi Wang, Felicitas Beier

See Also

readIMPACT3.2.2World_Price(), calcWBGEM(), readWBGEM()

Examples

## Not run: 
calcOutput("PriceAgriculture", datasource = "IMPACT3.2.2World_Price", aggregate = FALSE)
calcOutput("PriceAgriculture", datasource = "FAO")
calcOutput("PriceAgriculture", datasource = "WBGEM", aggregate = FALSE)

## End(Not run)

Description

Calculate historical distribution of livestock production across different systems based on output of MAgPIE_FEED model

Usage

calcProdSysRatioPast()

Value

Historical distribution of livestock production across different systems and corresponding weights as a list of two MAgPIE objects

Author(s)

Isabelle Weindl

See Also

calcOutput(), readFeedModel()

Examples

## Not run: 
calcOutput("ProdSysRatioPast")

## End(Not run)

Description

Distributes crop, pasture and livestock production in space to 0.5 degree

Usage

calcProduction(
  products = "kcr",
  cellular = FALSE,
  cells = "lpjcell",
  calibrated = TRUE,
  attributes = "all",
  irrigation = FALSE
)

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcLanduseInitialisation(), calcCroparea()

Examples

## Not run: 
calcOutput("Production")

## End(Not run)

Description

Writes down the equation parameters from various data sources

Usage

calcRegressionParameters(regression = "bmi_shr")

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

Examples

## Not run: 
calcOutput("RegressionParameters")

## End(Not run)

Description

Provides MAgPIE-FEED data for aboveground and belowground residues biomass

Usage

calcResBiomass(
  cellular = FALSE,
  cells = "lpjcell",
  plantparts = "both",
  irrigation = FALSE,
  attributes = "all",
  scenario = "default"
)

Arguments

Value

MAgPIE-FEED data for ProdResAg and corresonding weights as a list of two MAgPIE objects

Author(s)

Lavinia Baumstark, Isabelle Weindl, Benjamin Bodirsky

See Also

calcOutput(), readSource()

Examples

## Not run: 
calcOutput("ResBiomass")

## End(Not run)

Description

Calculates the demand for Crop Residues

Usage

calcResDemand(cellular = FALSE, scenario = "dafault")

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

See Also

calcResBiomass()

Examples

## Not run: 
calcOutput("ResDemand")

## End(Not run)

Description

Calculates data for aboveground and belowground residues production with other usage

Usage

calcResFieldBalancePast(
  cellular = FALSE,
  products = "sum",
  scenario = "default"
)

Arguments

Value

data

Author(s)

Benjamin Bodirsky

See Also

calcOutput(), readSource()

Examples

## Not run: 
calcOutput("ResFieldBalancePast")

## End(Not run)

Description

Calculates the supply potential of Crop Residues for 2nd generation bioenergy for future and different ssp scenarios

Usage

calcResFor2ndBioengery(products = "all", product_aggr = TRUE, add_off = FALSE)

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Kristine Karstens

See Also

calcResFor2ndBioengery()

Examples

## Not run: 
calcOutput("ResFor2ndBioengery")

## End(Not run)

Description

calculates amount of yearly N from rock weathering by country or global total, disaggregated by land use type (LUH2v2 6 class, with FAO forest correction)

Usage

calcRockNWeathering()

Value

MAgPIE object of amount of N (Mt)

Author(s)

David M Chen

Description

Calculates Seed demand

Usage

calcSeed(
  cellular = FALSE,
  cells = "lpjcell",
  products = "kall",
  irrigation = FALSE,
  attributes = "all"
)

Arguments

Value

List of magpie object with results and weight on country or cellular level, unit and description.

Author(s)

Benjamin Leon Bodirsky

Examples

## Not run: 
calcOutput("Seed")

## End(Not run)

Description

calculates the soil nitrogen uptake efficiency. This is the nitrogen taken up from the soil (N in crop biomass minus biological fixation minus seed N) divided by the soil N inputs (fertilizer, manure etc). For the future, SNuPE scenarios are added.

Usage

calcSNUpE(max_snupe = 0.85, cellular = FALSE, rev = 0.1, maccbase = TRUE)

Arguments

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky, Xiaoxi Wang

See Also

calcNitrogenBudgetCropland()

Examples

## Not run: 
calcOutput("SNUpE")

## End(Not run)

Description

Calculates soil organic carbon loss share on cellular level

Usage

calcSOCLossShare(
  subsystems = FALSE,
  rate = "change",
  factor = "ipccReduced",
  cells = "lpjcell"
)

Arguments

Value

List of magpie objects with results on cellular level, weight, unit and description.

Author(s)

Kristine Karstens

Examples

## Not run: 
calcOutput("SOCLossShare", aggregate = FALSE)

## End(Not run)

Description

calculates Soil Organic Matter Pool, accounting for the management history. We assume carbon Stocks from LPJml natural vegetation as a starting point. Here we use the upper 30cm soil layer (0-20cm of + 1/3 of 30-50 cm). We then correct carbon pools by lost c-share depending on the climate region, using default factors of IPCC Guidelines 2006 table 5.5. We assume that this IPCC-corrected value is the target long-term equilibrium value for the soil stocks. Because soil decline and build-up slowly, we assume that in every year, the carbon pools move 15% towards this new equilibrium. This assumption is in line with IPCC saying that the process will take 20 years: with our assumption, after 5 years 44% of the carbon pool is gone, after 10 years 80% and after 20 years 96%. We determine a carbon stock for cropland soils and non-cropland soils in every cell. If the cropland area expands, the carbon stock of noncropland is proportionally assigned to the cropland pool and vice versa. The outputs of the function are the soilc stocks for cropland and non-cropland. Relevant for the release of N by SOM loss is also the change in carbon stocks per ha, as this relases or binds N. This is done in delta cropland soilc.

Usage

calcSOM(climatetype = "historical", subtype = "stock", cells = "lpjcell")

Arguments

Value

List of magpie object with results on country or cellular level, weight on cellular level, unit and description.

Author(s)

Benjamin Leon Bodirsky, Kristine Karstens

Examples

## Not run: 
calcOutput("SOM2")

## End(Not run)

Description

calculates effect on N from Soil Organic Matter loss

Usage

calcSOMlossN(cellular = FALSE, cells = "lpjcell")

Arguments

Value

List of magpie object with results on country or cellular level, weight on cellular level, unit and description.

Author(s)

Benjamin Leon Bodirsky,

Examples

## Not run: 
calcOutput("SOMlossN")

## End(Not run)

Description

calculates stock levels of magpie commodities based on FAO data. FAO data only has stock variation so we assume lowest level for each product/country as 0 level USDA data to be potentially included in future second data source

Usage

calcStorage(datasource = "FAO")

Arguments

Value

List with a magpie object with stock level in tonnes

Author(s)

David Chen

Examples

## Not run: 
calcOutput("Storage", datasource = "FAO")

## End(Not run)

Description

calculates average monthly temperature on different landuse types

Usage

calcTemperature(landusetypes = "all", months = FALSE, convert = TRUE)

Arguments

Value

List of magpie object with results on country level, weight on country level, unit and description.

Author(s)

Benjamin Leon Bodirsky

Examples

## Not run: 
calcOutput("Temperature")

## End(Not run)

Description

Calculates the demand of timber from FAO data (including intermediate products).

Usage

calcTimberDemand()

Value

List of magpie objects with results on country level, weight on country level, unit and description.

Author(s)

Abhijeet Mishra

See Also

calcFAOmassbalance_pre()

Examples

## Not run: 
calcOutput("TimberDemand")

## End(Not run)

Description

recover world price of commodity in terms of real 2005 USD per metric ton

Usage

calcWBGEM()

Value

magpie object of time series of world price of commodities

Author(s)

Xiaoxi Wang

See Also

readSource(), readWBGEM()

Examples

## Not run: 
calcOutput("WBGEM")

## End(Not run)

Description

function to convert ACCMIP data to isocountry resolution

Usage

convertACCMIP(x)

Arguments

Value

MAgPIE object

Author(s)

Roman Popov, Felicitas Beier

Examples

## Not run: 
readSource("ACCMIP", subtype = "nhx_1850")

## End(Not run)

Description

Reads in regression parameters estimated using mrregression, and reads in some scenario based on Bodirsky et al not yet published

Usage

convertBodirsky2018(x, subtype)

Arguments

Value

magpie object

See Also

readBodirsky2018()

Description

converts emission data from the CEDS database

Usage

convertCEDS2021(x)

Arguments

Value

MAgPIE object

Author(s)

Benjamin Leon Bodirsky, David Klein

Description

converts emission data from the CEDS database

Usage

convertCEDS2024(x)

Arguments

Value

MAgPIE object

Author(s)

Benjamin Leon Bodirsky, David Klein

Description

Read-in European Environment Agency (EEA) data on ETS emissions as magclass object

Usage

convertEEA_EuropeanEnvironmentAgency(x, subtype)

Arguments

Value

magpie object of European Environment Agency (EEA) ETS emissions (GtCO2)

Author(s)

Renato Rodrigues, Robin Hasse

See Also

readSource

Examples

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

## End(Not run)

Description

Converts EU Reference Scenario magpie object into appropriate form for the REMIND model

Usage

convertEU_ReferenceScenario(x, subtype)

Arguments

Value

converted EU Reference Scenario magpie object

Author(s)

Renato Rodrigues, Falk Benke, Robin Hasse

Examples

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

## End(Not run)

Description

Read Eurostat historical emissions (env_air_gge)

Usage

convertEurostat(x, subtype)

Arguments

Value

A MAgPIE object containing the Eurostat historical emissions (MtCO2)

Author(s)

Renato Rodrigues

Examples

## Not run: 
a <- convertEurostat(x, subtype = "emissions")

## End(Not run)

Description

convert the Expert Guesses for future Livestock Production for the SSP Scenarios

Usage

convertExpertGuessSSPLivestockProduction(x)

Arguments

Value

magpie object containing converted expert guesses

Author(s)

Stephen Wirth

See Also

readSource()

Examples

## Not run: 
a <- readSource("ExpertGuessSSPLivestockProduction","ssp1")

## End(Not run)

Description

Convert production system distribution and feed basket data to ISO country level.

Usage

convertFeedModel(x, subtype = "FeedBaskets")

Arguments

Value

Production system distribution and feed basket data as MAgPIE object on ISO country level

Author(s)

Isabelle Weindl, Jan Philipp Dietrich

Description

disaggregates country groups from GTAP according to GDP share

Usage

convertGTAPv8v9(x, subtype)

Arguments

Value

Data as MAgPIE object with common country list

Author(s)

Debbora Leip, David M. Chen

Examples

## Not run: 
a <- readSource("convertGTAPv8v9", "81:SF01", convert = TRUE)

## End(Not run)

Description

Converts the Data from Herridge et al. to fit the common country list. Source: Herridge D. F., Peoples M. B., Boddey R. M.: Global inputs of biological nitrogen fixation in agricultural systems

Usage

convertHerridge(x)

Arguments

Value

A MAgPIE object containing the share of Nr derived from fixation for each country and each commodity.

Author(s)

Stephen Wirth

Examples

## Not run: 
x <- readSource("Herridge")

## End(Not run)

Description

converts data of World Bank ICP round, downloaded from here: https://databank.worldbank.org/source/icp-2017 mainly a currency conversion to MER2017. Assume that in the original dataset, 2011 values are in 2011MER and 2017 in 2017MER, given the ICP rounds

Usage

convertICP2017(x, subtype = "per_cap_expMER")

Arguments

Value

magpie object of relative price levels (world = 100) or per capita expenditure (USD17 MER)

Author(s)

David M Chen

Examples

## Not run: 
a <- convertSource("ICP2017", "per_cap_exp")

## End(Not run)

Description

Convert IEA energy data to data on ISO country level.

Usage

convertIEA(x, subtype)

Arguments

Value

IEA data as MAgPIE object aggregated to country level

Author(s)

Anastasis Giannousakis, Renato Rodrigues, Falk Benke

Description

Convert IEA End Uses and Efficiency Indicators data to data on ISO country level.

Usage

convertIEA_EEI(x)

Arguments

Author(s)

Falk Benke

Description

Convert IFADavies (2013) data to ISO country level.

Usage

convertIFA(x)

Arguments

Value

MAgPIE object of the IFA data disaggregated to country level

Author(s)

Lavinia Baumstark

Examples

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

## End(Not run)

Description

Convert subtypes from ImageMacc to data on ISO country level. Correct values for N2O of the subtype "baseline_sources" from N to N2O (factor: 44/28).

Usage

convertImageMacc(x, subtype)

Arguments

Value

ImageMacc data as MAgPIE object for all subtypes aggregated to country level

Author(s)

Nele Steinmetz

See Also

readSource()

Examples

## Not run: 
a <- readSource("ImageMacc", "CH4_Energy_Industry")
a <- readSource("ImageMacc", "CH4_Landuse")
a <- readSource("ImageMacc", "N2O_Energy_Industry")
a <- readSource("ImageMacc", "N2O_Landuse")
a <- readSource("ImageMacc", "HFC_tot")
a <- readSource("ImageMacc", "SF6_tot")
a <- readSource("ImageMacc", "PFC_tot")
a <- readSource("ImageMacc", "baseline_sources")

## End(Not run)

Description

Convert subtypes on ISO country level.

Usage

convertIPCC(x, subtype)

Arguments

Value

IPCC data as MAgPIE object for all subtypes on country level

Author(s)

Nele Steinmetz

See Also

readSource()

Examples

## Not run: 
a <- readSource("IPCC", "awmsShr")
a <- readSource("IPCC", "awmsEfCh4")
a <- readSource("IPCC", "awmsParCh4")
a <- readSource("IPCC", "nExcrRate")

## End(Not run)

Description

convert data to ISO country level

Usage

convertISIMIP(x, subtype)

Arguments

Value

MAgPIE object on country level

Author(s)

Jan Philipp Dietrich, Felicitas Beier

See Also

readSource()

Examples

## Not run: 
a <- readSource("ISIMIP", convert = TRUE)

## End(Not run)

Description

Missing data for EU-28 countries is added, by distributing the difference of EU28 and the sum of country-values based on countries share in EU-28 GDP.

Usage

convertJRC_IDEES(x)

Arguments

Value

A magpie object.

Author(s)

Michaja Pehl

See Also

readJRC_IDEES()

Description

Convert Koeppen climate zones on iso-country level

Usage

convertKoeppen(x, subtype = "iso")

Arguments

Value

List of magpie objects with results on country level

Author(s)

Kristine Karstens

Examples

## Not run: 
readSource("Koeppen", subtype = "iso", convert = TRUE)

## End(Not run)

Description

converts the dataset of Lassaletta, L., G. Billen, B. Grizzetti, J. Angalde, and J. Garnier. 2014. 50 Year Trends in Nitrogen Use Efficiency of World Cropping Systems: The Relationship between Yield and Nitrogen Input to Cropland. Environmental Research Letters. into a dataset including all countries. Replacing Soviet Union by Russia and Yugoslavia by Serbia without detailed disaggregation.

Usage

convertLassaletta2014(x, subtype)

Arguments

Value

Magpie object with results on country level.

Author(s)

Benjamin Leon Bodirsky

See Also

readLassaletta2014(), readSource()

Examples

## Not run: 
readSource("Lassaletta2014", convert = TRUE)

## End(Not run)

Description

Converts the Data from Lotze Campen et al. 2014. to fit the common country list. Source: Lotze Campen et al. 2014. "Impacts of increased bioenergy demand on global food markets: an AgMIP economic model intercomparison" Agricultural Economics 45 (103-116). doi:10.1111/agec.12092.

Usage

convertLotzeCampenBiofuel(x)

Arguments

Value

A MAgPIE object containing future trends in first generation bioenergy demand in Petajoules as magpie object for each country for biodiesel and ethanol.

Author(s)

Ewerton Araujo

Examples

## Not run: 
x <- readSource("LotzeCampenBiofuel")

## End(Not run)

Description

It fills the missing values of the output of readLutz2014 through the weighted average of the values of two countries with similar characteristics to the one that has na values.

Usage

convertLutz2014(x)

Arguments

See Also

readLutz2014()

Description

Convert MAgPIE data to country-level.

Usage

convertMAgPIE(x, subtype)

Arguments

Value

magpie object

Author(s)

David Klein, Felix Schreyer

Description

Converts data from the NCD risc consortium body height: Collaboration (NCD-RisC), NCD Risk Factor. 2016. "A Century of Trends in Adult Human Height." ELife 5 (July):e13410. https://doi.org/10.7554/eLife.13410.

Usage

convertNCDrisc(x, subtype)

Arguments

Value

magpie object with a completed dataset.

See Also

convertNCDrisc()

Description

Convert subtypes from PBL_MACC_2019 to data on ISO country level.#'

Usage

convertPBL_MACC_2019(x, subtype)

Arguments

Value

PBL_MACC_2019 data as MAgPIE object for all subtypes aggregated to country level

Author(s)

Florian Humpenoeder

See Also

readSource()

Description

Convert subtypes from PBL_MACC_2022 to data on ISO country level.#'

Usage

convertPBL_MACC_2022(x)

Arguments

Value

PBL_MACC_2022 data as MAgPIE object for all subtypes aggregated to country level

Author(s)

Michael Windisch, Florian Humpenoeder

See Also

readSource()

Description

Convert subtypes from PBL_MACC_SSP2_2022 to data on ISO country level.#'

Usage

convertPBL_MACC_SSP2_2022(x)

Arguments

Value

PBL_MACC_SSP2_2022 data as MAgPIE object for all subtypes aggregated to country level

Author(s)

Michael Windisch, Florian Humpenoeder

See Also

readSource()

Description

function to convert PRIMAP-hist data to isocountry resolution

Usage

convertPRIMAPhist(x)

Arguments

Value

MAgPIE object

Author(s)

Roman Popov

Examples

## Not run: 
readSource("PRIMAPhist", subtype = "hist")

## End(Not run)

Description

Convert old ReMIND use of residues for 2nd generation bioenergy to country level data

Usage

convertResFor2ndBE(x, subtype = subtype)

Arguments

Value

List of magpie objects with results on country level

Author(s)

Kristine Karstens

See Also

readSource()

Examples

## Not run: 
a <- readSource("ResFor2ndBE", subtype = "oldReMIND", convert = TRUE)

## End(Not run)

Description

Convert SoilGrids content

Usage

convertSoilGrids(x)

Arguments

Value

List of magpie objects with results on cellular level, weight, unit and description.

Author(s)

Kristine Karstens

See Also

readSoilGrids()

Examples

## Not run: 
readSource("SoilGrids", subtype = "cstock_0_30", convert = TRUE)

## End(Not run)

Description

Disagregates from SSP regions to ISO countries

Usage

convertSSPResults(x)

Arguments

Value

MAgPIE object with ISO countries with all indicators for which disaggregation weight was found

Author(s)

Abhijeet Mishra, Benjamin Leon Bodirsky, Florian Humpenoeder

See Also

readSource()

Examples

## Not run: 
readSource("SSPResults", aggregate = TRUE)

## End(Not run)

Description

Reads a dataset containing values for sewage

Usage

convertVanDrecht2009(x)

Arguments

Value

A MAgPIE object containing sewage quantities and losses

Author(s)

Benjamin Leon Bodirksy

Examples

## Not run: 
x <- readSource("VanDerWerf2010")

## End(Not run)

Description

Converts data from the WHO

Usage

convertWHO(x)

Arguments

Value

magpie object with a completed dataset.

See Also

convertWHO()

Description

correct Andrijevic governance data

Usage

correctAndrijevic2019(x, subtype)

Arguments

Value

corrected magpie object iso-level

Author(s)

Felicitas Beier

See Also

readAndrijevic2019()

Description

correct Edgar-food data

Usage

correctEDGARfood(x, subtype)

Arguments

Value

corrected magpie object

Author(s)

David Hoetten

See Also

readEDGARfood

Description

Correct FoodSystemsDashboard values that are questionable

Usage

correctFoodSystemsDashboard(x, subtype)

Arguments

Value

List of magpie objects

Author(s)

David Chen

Description

Correct IPCC climate classification

Usage

correctIPCCClimate(x)

Arguments

Value

Magpie object with results on cellular level for 12 IPCC climate zone types

Author(s)

Kristine Karstens

Examples

## Not run: 
readSource("IPCCClimate", convert = "onlycorrect")

## End(Not run)

Description

Correct Koeppen climate zones on cellular level

Usage

correctKoeppen(x, subtype = "iso")

Arguments

Value

List of magpie objects with results on cellular level

Author(s)

Kristine Karstens

Examples

## Not run: 
readSource("Koeppen", subtype = "cellular", convert = "onlycorrect")

## End(Not run)

Description

Correct SoilGrids content

Usage

correctSoilGrids(x)

Arguments

Value

List of magpie objects with results on cellular level, weight, unit and description.

Author(s)

Kristine Karstens

See Also

readSoilGrids()

Examples

## Not run: 
readSource("SoilGrids", subtype = "cstock_0_30", convert = "onlycorrect")

## End(Not run)

Description

correct biome data

Usage

correctTNC2019(x)

Arguments

Value

magpie object on cellular level

Author(s)

Patrick v. Jeetze

See Also

readTNC2019

Examples

## Not run: 
readSource("TNC2019", convert = "onlycorrect")

## End(Not run)

Description

This function downloads the governance indicator data available at https://github.com/marina-andrijevic/governance2019

Usage

downloadAndrijevic2019(subtype = "governance_obs_project")

Arguments

Author(s)

Felicitas Beier

See Also

readAndrijevic2019()

Examples

## Not run: 
downloadSource("Andrijevic2019", subtype = "governance_obs_project")

## End(Not run)

Description

download EDGAR emission data

Usage

downloadEDGAR6(subtype = "n2o")

Arguments

Value

List of magpie objects with results on cellular level, weight, unit and description.

Author(s)

Benjamin Leon Bodirsky

Description

download Edgar-food v6 food system emission data

Usage

downloadEDGARfood()

Author(s)

David Hötten

Description

Downloads the latest data and meta data form the Eurostat website.

Usage

downloadEurostatLivestock(subtype)

Arguments

Description

Download the GFED (Global Fire Emissions Database) dataset for all years not labeled as beta, in addition to the emission factors.

Usage

downloadGFED()

Author(s)

Michael S. Crawford

See Also

downloadSource() readGFED()

Examples

## Not run: 
a <- downloadSource()

## End(Not run)

Description

Download ISIMIP GGCMI crop calendar information and harvest area masks

Usage

downloadGGCMICropCalendar()

Author(s)

David M Chen, Edna Molina Bacca

Description

Download IPCC climate classification

Usage

downloadIPCCClimate()

Value

Meta information on downloaded data

Author(s)

Kristine Karstens

Examples

## Not run: 
readSource("IPCCClimate", convert="onlycorrect")

## End(Not run)

Description

Downloads the latest data from ISIMIP.

Usage

downloadISIMIP(subtype)

Arguments

Author(s)

Jan Philipp Dietrich

Description

Download he grid-level regional nitrogen boundary datasets from Schulte-Uebbing et al. (2022)

Usage

downloadNitrogenBoundariesGridded()

Author(s)

Michael S. Crawford

See Also

downloadSource()

Examples

## Not run: 
 a <- downloadSource("NitrogenBoundariesGridded")

## End(Not run)

Description

This function downloads the raw SoilGrids data (available at https://files.isric.org/soilgrids/data/recent) or, if available, the preprocessed raster layers.

Usage

downloadSoilGrids(subtype = "cstock_0_30")

Arguments

Value

magpie object in cellular resolution

Author(s)

Kristine Karstens

See Also

readSoilGrids()

Examples

## Not run: 
downloadSource("SoilGrids", subtype = "carbon0_30")

## End(Not run)

Description

Download UN_PopDiv dataset (World Population Prospects)

Usage

downloadUN_PopDiv()

Author(s)

Michael Crawford, Debbora Leip

See Also

downloadSource() readUN_PopDiv()

Examples

## Not run: 
a <- downloadSource()

## End(Not run)

Description

Read in data from the Atmospheric Chemistry and Climate Model Intercomparison Project

Usage

readACCMIP(subtype = NULL)

Arguments

Value

magpie object of the ACCMIP data. Unit is t NO2-N per ha per year, or t NH3-N per ha per year,...

Author(s)

Roman Popov

See Also

readSource()

Examples

## Not run: 
a <- readACCMIP("ACCMIP", "nhx_2000")
a <- readACCMIP("ACCMIP", "sox_26_2030")

## End(Not run)

Description

Read in data from Grassi et al. 2021. Adjustement factors for emission in GtCO2 yr-1.

Usage

readAdjustGrassi2021(subtype)

Arguments

Value

Adjustement factors or weight as MAgPIE object

Author(s)

Michael Windisch, Florian Humpenoeder

Examples

## Not run: 
readSource("AdjustGrassi2021", subtype = "data")

## End(Not run)

Description

read in governance index data from Andrijevic et al. 2019

Usage

readAndrijevic2019(subtype)

Arguments

Value

governance index data at iso-country level

Author(s)

Felicitas Beier

See Also

readSource()

Examples

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

## End(Not run)

Description

Reads in regression parameters estimated using mrregression, and reads in some scenario based on Bodirsky et al not yet published

Usage

readBodirsky2018(subtype = "bmi_shr")

Arguments

Value

magpie object

See Also

readNCDrisc()

Description

Read-in an Long term carbon storage data for historical period.

Usage

readCarbonLTS(subtype)

Arguments

Value

magpie object of the FRA 2015 data

Author(s)

Abhijeet Mishra

See Also

readSource()

Examples

## Not run: 
a <- readSource("CarbonLTS", "Lauk_et_al")

## End(Not run)

Description

reads in emission data from the CEDS database

Usage

readCEDS2021()

Value

MAgPIE object

Author(s)

Benjamin Leon Bodirsky, David Klein

Description

reads in emission data from the CEDS database

Usage

readCEDS2024()

Value

MAgPIE object

Author(s)

Pascal Weigmann

Description

Read-in EDGAR_LU csv file as magclass object

Usage

readEDGAR_LU(subtype = "CO2")

Arguments

Value

magpie object EDGAR_LU data

Author(s)

Florian Humpenoeder

See Also

readSource()

Examples

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

## End(Not run)

Description

download EDGAR 5 and 6 emission data

Usage

readEDGAR6(subtype)

Arguments

Value

List of magpie objects with results on country level, weight, unit and description.

Author(s)

Benjamin Leon Bodirsky, Michael S. Crawford

Description

read Edgar-food v6 food system emission data

Usage

readEDGARfood(subtype)

Arguments

Value

A magpie object with foodsystem total emissions, emission shares or sector and substance specific emission, depending on subtype

Author(s)

David Hötten

Description

read EDGAR GHG emission data

Usage

readEDGARghg()

Value

magpie objects of EDGAR historical emissions (MtCO2eq)

Author(s)

Pascal Weigmann

See Also

readSource

Description

Read-in European Environment Agency (EEA) data on ETS emissions as magclass object

Usage

readEEA_EuropeanEnvironmentAgency(subtype)

Arguments

Value

magpie object of European Environment Agency (EEA) ETS emissions (GtCO2)

Author(s)

Renato Rodrigues, Falk Benke, Robin Hasse

See Also

readSource

Examples

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

## End(Not run)

Description

Read EU Reference Scenario .xlsx file as magpie object

Usage

readEU_ReferenceScenario(subtype)

Arguments

Value

magpie object of EU reference scenario data by country. Units follow REMIND report conventions and conversion factor is defined in EU_ReferenceScenario2REMIND.xlsx file.

Author(s)

Renato Rodrigues, Falk Benke, Robin Hasse

Examples

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

## End(Not run)

Description

Read-in Eurostat historical emissions csv files as magclass object

Usage

readEurostat(subtype = "emissions")

Arguments

Value

magpie object of Eurostat historical emissions (MtCO2)

Author(s)

Renato Rodrigues

See Also

readSource

Examples

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

## End(Not run)

Description

Read in EUROSTAT livestock data

Usage

readEurostatLivestock(subtype)

Arguments

Value

EUROSTAT livestock data as MAgPIE object

Author(s)

David Hötten

See Also

readSource()

Examples

## Not run: 
a <- readSource("EurostatLivestock", "MeatProd")

## End(Not run)

Description

Read the Expert Guesses for future Livestock Production for the SSP Scenarios

Usage

readExpertGuessSSPLivestockProduction(subtype)

Arguments

Value

magpie object containing the expert guesses

Author(s)

Stephen Wirth

See Also

readSource()

Examples

## Not run: 
a <- readSource("ExpertGuessSSPLivestockProduction","ssp1")

## End(Not run)

Description

Read in csv file containing coefficients of non-linear regression analysis for the calculation of future feed efficiencies of feed baskets dependent on livestock productivity trends

Usage

readFeedEfficiencyReg()

Value

MAgPIE object containing regression coefficients

Author(s)

Isabelle Weindl

See Also

readSource()

Examples

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

## End(Not run)

Description

Read in csv files containing data on production system distribution and system-specific feed baskets from the FeedModel "MAgPIE_FEED"

Usage

readFeedModel(subtype = "FeedBaskets")

Arguments

Value

magpie object of feed basket data

Author(s)

Isabelle Weindl

See Also

readSource()

Examples

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

## End(Not run)

Description

Read in csv file containing coefficients of non-linear regression analysis for the calculation of future central feed shares in feed baskets dependent on livestock productivity trends

Usage

readFeedShareReg()

Value

MAgPIE object containing regression coefficients

Author(s)

Isabelle Weindl

See Also

readSource()

Examples

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

## End(Not run)

Description

read in Food Systems Dashboard indicators

Usage

readFoodSystemsDashboard(subtype)

Arguments

Value

governance index data at iso-country level

Author(s)

David Chen

See Also

readSource()

Examples

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

## End(Not run)

Description

Publication Froehle, Andrew W. 2008 "Climate Variables as Predictors of Basal Metabolic Rate: New Equations" American Journal of Human Biology: The Official Journal of the Human Biology Council 20 (5): 510-29. doi: 10.1002/ajhb.20769.

Usage

readFroehle()

Value

MAgPIE object

Author(s)

Benjamin Bodirsky

See Also

readSource()

Examples

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

## End(Not run)

Description

Read the Global Fire Emissions Database over the available years and store them in a MAgPIE object with two sub-dimensions: Species (e.g. DM, CO2, CH4, or N2O), and Partition (e.g. SAVA, BORF, TEMF, DEFO, PEAT, AGRI). Emissions are reported in Mt X. For more information, see: https://globalfiredata.org/pages/data/. Due to runtime considerations, this function only calculates a small sample of the total emissions (CH4, N2O, NOx, NH3) and burning partitions (AGRI), which are currently being used for validation.

Usage

readGFED()

Value

A MAgPIE object with the GFED emissions data and sub-dimensions Partition and Species.

Author(s)

Michael S. Crawford

See Also

readSource()

Examples

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

## End(Not run)

Description

Reads in GGCMI fraction of Harvested Area masks for rice 1 and rice 2 (other crops available too, see path in download function), or other variables available in the GGCMI crop calendar.

Usage

readGGCMICropCalendar(subtype = "fraction_of_harvested_area")

Arguments

Value

MAgPIE object with the requested data

Author(s)

David M Chen, Edna Molina Bacca

Description

Read in data from GTAP 8.1 baseyears 2007 and 2004. All values in mio. current US$MER.

Usage

readGTAPv8v9(subtype)

Arguments

Value

GTAP data as MAgPIE object

Author(s)

Debbora Leip, David M. Chen

Examples

## Not run: 
readSource("GTAPv8v9", subtype = "81:SF01")

## End(Not run)

Description

Reads a dataset containing values for biological nitrogen fixation in agricultural systems. Source: Herridge D. F., Peoples M. B., Boddey R. M.: Global inputs of biological nitrogen fixation in agricultural systems

Usage

readHerridge(subtype = NULL)

Arguments

Details

Availables Subtypes:

• ndfa: National values for Plant associated fixation

• freeliving: Global values for free living agents