antaresProcessing (version 0.18.3)

addUpwardMargin: Add upward margin of areas

Description

This function computes isolated and interconnected upward margins of areas and add them to an antaresData object.

Usage

addUpwardMargin(x)

Value

The function modifies its input by adding to it two new columns isolatedUpwardMargin and interconnectedUpwardMargin. For convenience it invisibly returns x.

Arguments

x

An object of class antaresData created with readAntares

Details

For a given area and time step, isolated upward margin is the difference between the available production capacity plus the fatal productions and the load. More formally it is equal to:

isolatedUpwardMargin = (`AVL DTG` + generatingMaxPower + storageCapacity) + (`H. ROR` + WIND + SOLAR + `MISC. NDG`) - LOAD

NB: in Antares v6 (and earlier versions) generatingMaxPower is replaced by hstorPMaxAvg.

The variable storageCapacity is automatically created when pumped storage areas are removed with function removeVirtualAreas. If there is not any such area, storageCapacity is assumed to be equal to 0.

Interconnected upward margin is the isolated upward margin plus the imports and minus the exports:

interconnectedUpwardMargin = isolatedUpwardMargin - BALANCE + `ROW BAL.`

Examples

if (FALSE) {
# Data required by the function
showAliases("upwardMargin")

mydata <- readAntares(select = "upwardMargin")
mydata <- removeVirtualAreas(mydata, getAreas(c("pump", "stor")))

addUpwardMargin(mydata)
}