newImport: Create new export object

In olugovoy/energyRt: Energy systems modeling toolbox in R, development version

Create new export object

Description

Import object to represent commodity import from the Rest of the World (RoW).

Usage

newImport(
  name,
  desc = "",
  commodity = "",
  unit = NULL,
  reserve = Inf,
  imp = data.frame(),
  misc = list(),
  ...
)

Arguments

name	character. Name of the import object, used in sets.
desc	character. Description of the import object.
commodity	character. Name of the imported commodity.
unit	character. Unit of the imported commodity.
reserve	numeric. Total accumulated limit through the model horizon.
imp	data.frame. Import parameters. region character. Region name to apply the parameter; use NA to apply to all regions. year integer. Year to apply the parameter; use NA to apply to all years. slice character. Time slice to apply the parameter; use NA to apply to all slices. imp.lo numeric. Lower bound on the import volume. imp.up numeric. Upper bound on the import volume. imp.fx numeric. Fixed import volume, ignored if NA. This parameter overrides imp.lo and imp.up.
misc	list. Additional information.

Details

Constructor for import object.

Import object adds an "external" source of commodity to the model. The RoW is not modeled explicitly as a region, export and import objects define and control the exchange with the RoW. The operation is similar to the demand object, but the two ideas distinguishes between internal and external final consumption. This exchange can be exogenously defined (imp.fx) or optimized by the model within the given limits (imp.lo, imp.up). The price column is used to define the price of the imported commodity. "Reserve" sets the total amount that can be imported over the model horizon.

Value

import object with given specifications.

Examples

IMPOIL <- newImport(
  name = "IMPOIL", # used in sets
  desc = "Oil import to the model to the RoW", # for own reference
  commodity = "OIL", # must match the commodity name in the model
  unit = "Mtoe", # for own reference
  imp = data.frame(
    region = rep(c("R1", "R2"), each = 2), # import region(s)
    year = rep(c(2020, 2050)), # import years
    price = 600, # import price in MUSD/Mtoe (USD/t),
    imp.up = rep(c(1e4, 1e6), each = 2), # upper bound for import in each year
    imp.lo = rep(c(1e4, 1e5), each = 2) # lower bound for import in each year
  )
)
draw(IMPOIL)

olugovoy/energyRt documentation built on Nov. 21, 2024, 2:24 a.m.