antaresEditObject (version 0.1.6)

createLink: Create a link between two areas

Description

Create a link between two areas

Usage

createLink(from, to, propertiesLink = propertiesLinkOptions(),
  dataLink = NULL, overwrite = FALSE,
  opts = antaresRead::simOptions())

Arguments

from

The first area from which to create a link

to

The second one

propertiesLink

a named list containing the link properties, e.g. hurdles-cost or transmission-capacities for example. See propertiesLinkOptions.

dataLink

For Antares v7, a matrix with eight column corresponding to : trans. capacity (direct) trans. capacity (indirect), hurdles cost (direct), hurdles cost (indirect), impedances, loop flow, PST min, PST max. If NULL (default), a matrix whose rows are equal to 1, 1, 0, 0, 0, 0, 0, 0 is set. See Details

overwrite

Logical, overwrite the previous between the two areas if exist

opts

List of simulation parameters returned by the function antaresRead::setSimulationPath

Value

An updated list containing various information about the simulation.

Details

The eight times-series are:

• "NTC direct"the upstream-to-downstream capacity, in MW

• "NTC indirect"the downstream-to-upstream capacity, in MW

• "Hurdle cost direct"an upstream-to-downstream transmission fee, in euro/MWh

• "Hurdle cost indirect"a downstream-to-upstream transmission fee, in euro/MWh

• "Impedances"virtual impedances that are used in economy simulations to give a physical meaning to raw outputs, when no binding constraints have been defined to enforce Kirchhoff's laws.

• "Loop flow"amount of power flowing circularly though the grid when all <U+201C>nodes<U+201D> are perfectly balanced (no import and no export).

• "PST min"lower bound of phase-shifting that can be reached by a PST installed on the link, if any.

• "PST max"upper bound of phase-shifting that can be reached by a PST installed on the link, if any.

NB: For Antares v7 the eight columns must conform to above order. For Antares v6, only five columns are expected, and they must follow this other order: NTC direct, NTC indirect, Impedances, Hurdle cost direct, Hurdle cost indirect.

Examples

# NOT RUN {
createLink(from = "myarea", to  = "myarea2")
# }