antaresProcessing (version 0.18.3)

externalDependency: External Dependencies in imports and exports

Description

This function computes the dependency in imports and export for each area or districts at a given time step. Dependency in imports represents moments where imports are required to have no loss of load. Dependency in exports represents moments where exports are required to have no spilled energy.

Usage

externalDependency(x, timeStep = "annual", synthesis = FALSE, opts = NULL)

Value

A data.table of class antaresDataTable with the following columns:

area

Area name.

timeId

Time id and other time columns.

pumping

capacity of pumping

storage

capacity of storage

exportsLevel

netLoad + pumping

importsLevel

netLoad - `AVL DTG` - hydroStorageMaxPower - storage > 0

exportsFrequency

number of time step where this criteria is satisfied

criteria : netLoad + pumping < 0

importsFrequency

number of time step where this criteria is satisfied

criteria : netLoad - `AVL DTG` - hydroStorageMaxPower - storage > 0

Arguments

x

An object created with function readAntares. It must contain data for areas and/or districts. More specifically this function requires the columns generatingMaxPower (or hstorPMaxAvg for Antares v6 and earlier), and netLoad. To get these columns, one has to invoke readAntares with the parameter hydroStorageMaxPower = TRUE and addNetLoad (see examples).

Moreover it needs to have a hourly time step.

This object must also contain linkCapacity if there was virtual areas remove by removeVirtualAreas to be able to calculate pumping and storage capacities.

timeStep

Desired time step for the result.

synthesis

If TRUE, average external dependencies are returned. Else the function returns external dependencies per Monte-Carlo scenario.

opts

opts

Examples

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

mydata <- readAntares(select = "externalDependency")
addNetLoad(mydata)
externalDependency(mydata)

# if there are some virtual pumping/storage areas, remove them with
# removeVirtualAreas
mydata <- removeVirtualAreas(mydata, c("pumping", "storage"))
externalDependency(mydata, ignoreMustRun = TRUE)
}