antaresProcessing (version 0.18.3)

addDownwardMargin: Add downward margins of areas

Description

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

Usage

addDownwardMargin(x)

Value

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

Arguments

x

An object of class antaresData created with readAntares

Details

For a given area, downward margin is equal to the thermal minimum production (due must run production and minimum stable power of production units) plus the fatal productions minus the load and the pumping capacity. More formally it is equal to:

isolatedDownwardMargin = thermalPMin + `H. ROR` + WIND + SOLAR + `MISC. NDG` - LOAD - pumpingCapacity

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

Interconnected downward margin is the isolated downward margin plus the exports minus the imports:

interconnectedDownwardMargin = isolatedDownwardMargin + BALANCE - `ROW BAL.`

Examples

if (FALSE) {
# data required by the function
showAliases("downwardMargin")

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

addDownwardMargin(mydata)
names(mydata$areas)
}