User guide


First it’s necessary to load the package:


You need to set the path to an Antares study in “input” mode:

antaresRead::setSimulationPath(path = "path/to/study", simulation = "input")

Or you can simply create a new study:


Save study

Before modifying your study, you can save it in an archive:

backupStudy(what = "input")

This will create a .tar.gz file in your study folder.

Create a new area

You can create a new area with:

createArea(name = "myarea")

# The new area should appear here:

You can specify the localization of the area on the map, and also its color.

There are two helper functions for area parameters:

Create a new cluster

You can initialize a cluster with some parameters:

  area = "myarea", 
  cluster_name = "myareacluster",
  group = "other",
  unitcount = 1,
  nominalcapacity = 8400,
  `min-down-time` = 0,
  `marginal-cost` = 0.010000,
  `market-bid-cost` = 0.010000

You can also edit the settings of an existing cluster:

  area = "myarea", 
  cluster_name = "myareacluster", 
  nominalcapacity = 10600.000

Create a binding constraint

  name = "myconstraint", 
  values = matrix(data = c(rep(c(19200, 0, 0), each = 366)), ncol = 3), 
  enabled = FALSE, 
  timeStep = "daily",
  operator = "both",
  coefficients = c("fr%myarea" = 1)

Create several Pumped Storage Power plant (PSP)

pspData <- data.frame(
  area = c("a", "b"), 
  installedCapacity = c(800,900)

  areasAndCapacities = pspData, 
  efficiency = 0.75

Create several Demand Side Response (DSR)

dsrData <- data.frame(
  area = c("a", "b"),
  unit = c(10,20), 
  nominalCapacity = c(100, 120),
  marginalCost = c(52, 65),
  hour = c(3, 7)

Update general settings

For example, set the output of simulation year by year, and limit the number of Monte-Carlo years to 10:

updateGeneralSettings( = TRUE, nbyears = 10)

Remove methods

You can remove areas, links, clusters and binding constraints from input folder with remove* functions, e.g.:


Run Time-Series Generator

First, update general settings to activate time series to generate:

updateGeneralSettings(generate = "thermal")

Then run TS-generator:

  path_solver = "C:/path/to/antares-solver.exe", 
  show_output_on_console = TRUE

Run an Antares simulation

Launch an Antares simulation from R:

  name = "myAwesomeSimulation", 
  mode = "economy",
  path_solver = "C:/path/to/antares-solver.exe", 
  show_output_on_console = TRUE