get_margins: Compute generation margin in a given area on an Antares...
In rte-antares-rpackage/antaresXpansion: Antares Expansion Planning Tool

Description Usage Arguments

- A positive generation margin means that the generation fleet of the area is over-sized and the LOLD (Loss Of Load Duration) is below the adequacy criteria (typically 3h/y). In that case, the margin corresponds to the extra constant load that the generation fleet can still supply while respecting strictly the adequacy criteria.

- A negative generation margin means that the generation fleet is under-sized and the LOLD is above the adequacy criteria. In that case, the margin corresponds to the extra "perfect" production capacity required to meet the adequacy criteria. A "perfect" capacity is a capacity which is available all the time (i.e. without maintenance/outages).

get_margins(area = "fr", cluster_name = "gas_pcomp_peak", LOLD = 3,
  tolerance = 0.1, unit_size = 100, abaque = function(c) {    
  return(-3627 * log(c) + 3723.4) }, initial_margin = 0, path_solver,
  display = TRUE, clean = TRUE, parallel = TRUE,
  opts = antaresRead::simOptions())

`area`	Area in which the margin is computed
`cluster_name`	Name of the complementary cluster if the margin is negative (lack of production). The cluster can already exist, otherwise it will be created. (example : If cluster_name = "gas_pcomp_peak" and area = "fr", the final name of the cluster will be "fr_gas_pcomp_peak")
`LOLD`	Adequacy criteria of the area in terms of Loss of Load Duration (given in h/year)
`tolerance`	Algorithmic tolerance about the adequacy criteria. Used as stop criterion. (example : if tolerance = 0.5 and LOLD = 3.0, the aimed range of LOLD is between 2h30 and 3h30)
`unit_size`	Minimal step of the generation margin. Given in MW.
`abaque`	Function abaque : marge = f(LOLE)
`initial_margin`	First margin tested in the function. Given in MW.
`path_solver`	Character containing the Antares Solver path
`display`	Logical. If `TRUE` the advancement of the function if displayed in the console
`clean`	Logical. If `TRUE` the output of the ANTARES simulations run by the package will be deleted (except for the output of the simulation which brings to the best solution).
`parallel`	Logical. If `TRUE` the ANTARES simulations will be run in parallel mode (Work only with ANTARES v6.0.0 or more). In that case, the number of cores used by the simulation is the one set in advanced_settings/simulation_cores (see ANTARES interface).
`opts`	list of simulation parameters returned by the function `antaresRead::setSimulationPath`