Import, Manipulate and Explore the Results of an 'Antares' Simulation

Import, manipulate and explore results generated by 'Antares', a powerful open source software developed by RTE (Réseau de Transport d’Électricité) to simulate and study electric power systems (more information about 'Antares' here : < https://github.com/AntaresSimulatorTeam/Antares_Simulator>). You can see the results of several ANTARES studies here : < http://bpnumerique.rte-france.com/>.


News

Copyright © 2016 RTE Réseau de transport d’électricité

Changes in version 2.2.3 (2019-02-13) BUGFIXES:

  • Error with next data.table release

Changes in version 2.2.2 (2019-01-15) BUGFIXES:

  • Duplicated vignette title

Changes in version 2.2.1 (2018-10-16) BUGFIXES:

  • ".getStartDate()" : was not working correctly with a first-month not equal to "July" (#121)
  • ".getStartDate()" : was not working correctly when a user wants to change options with an opts (#122)

Changes in version 2.2.0 (2018-09-28)

BREAKING CHANGES:

  • "removeVirtualAres()" : as a new logical parameter rowBal, if is TRUE (default) then BALANCE will be corrected by ROW. BAL (#antaresProcessing33)

NEW FEATURES:

  • "removeVirtualAres()" : now correct BALANCE, COST and production of disticts.(#119)

BUGFIXES:

  • "readLayout()" : prevent bug reading multiple studies
  • "readAntares()" : prevent bug dealing with integer64
  • "writeAntaresH5()" was not working anymore due to a new version of rhdf5 (h5close() does not work anymore). (#110)

Changes in version 2.1.2 (2018-06-01)

BUGFIXES:

  • getLinks() was sending an error when there are no links in the study.

Changes in version 2.1.1 (2018-04-28)

BUGFIXES:

  • readInputTS() was sending bad values for hydroStorage. (#58)
  • changeTimeStep() will print a warning if the user want to aggregate data. (#54)
  • readAntares() will print warnings when a user want to aggregate mustRun data (#54)

Changes in version 2.1.0 (2018-02-23)

NEW FEATURES:

  • readInputTS() has a new parameter "thermalOutages" that permits to read thermal outages characteristics
  • Call removeVirtualAreas several times in writeAntaresH5()

BUGFIXES:

  • Correction of some bugs in removeVirtualAreas when there is several virtual nodes of production and storageFlexibility
  • Correction of some bugs due to the new lubridate version

Changes in version 2.0.2 (2017-11-21)

BUGFIXES:

  • Some tests failed in some platforms on CRAN.

Changes in version 2.0.1 (2017-11-14)

BUGFIXES:

  • readLayout() was not taking a list of simOptions.

Changes in version 2.0.0 (2017-11-03)

NEW FEATURES:

  • New function "writeAntaresH5()" convert ANTARES outputs to h5 files.
  • The path parameter of "setSimulationPath()" can be a h5 file.
  • New function "isH5Opts()" test if the value returned by setSimulationPath() is referring to an h5 file.
  • New function "readOptimCriteria()" read the value of the criteria optimized by ANTARES.
  • New function "setRam()" specify RAM limit (in Go) of the value returned by readAntares, initially it is 10Go.
  • New vignette "antaresH5" is available.

BUGFIXES:

  • removeVirtualAreas() was not moving clusters from virtual production area to the real area.
  • antaresRead() sometimes returned a antaresDataList with element "thermalModulation". (#51)

Changes in version 1.1.4 (2017-07-07)

BUGFIXES:

  • setSimulation() was crashing with antares v6.0 because of the folder "maps". (#49)

Changes in version 1.1.3 (2017-05-30)

BUGFIXES:

  • readInputTS was crashing when trying to import cluster data and some clusters were disabled.

Changes in version 1.1.2 (2017-04-18)

BUGFIXES:

  • Fixed an issue that caused compilation to crash on mac OS X

Changes in version 1.1.0 (2017-03-31)

NEW FEATURES:

  • The 'select' parameter of readAntares() has been improved. It now accepts new keywords "areas", "links", "clusters", "districts" to indicate which type of data to read,"mcYears" to import detailed results, "misc", "mustRun", etc. to import the corresponding input data.
  • A new function setAlias() has been added. It permits to packages developers to define new aliases to use in the 'select' parameter of readAntares() in order to help their users to import the required data.
  • readBindingConstraints() has been improved and returns an object of class 'bindingConstraints' which is a named list where each element has the same structure.
  • A summary method has been added for objects of class 'bindingConstraints'. It is useful to quickly look at the binding contraints defined in a study.
  • readAntares(mustRun = TRUE) now adds a new column "thermalPmin". It is similar to mustRunTotal, except it also takes into account the minimum stable power of the cluster units.

BUGFIXES:

  • Columns 'pumpingCapacity' and 'storageCapacity' created by removeVirtualAreas() were reversed.
  • setSimulationPath() was sometimes setting a start data that was not consistent with parameters "1st january" and "leap year".
  • setSimulationPath() was not working if synthetic results and the first Monte-Carlo scenario were not saved in a given Antares simulation.
  • readAntares(clusters = "all") was not working in some situations.

Changes in version 1.0.0 (2017-02-23)

BUGFIXES:

  • In some specific situations, date columns could be filled with NA values. (#26)
  • Many small problems that were detected by R CMD CHECK.

Changes in version 0.15 (2017-01-25)

BREAKING CHANGES:

  • Parameter "synthesis" has been removed from readAntares. The new behavior is now to import synthetic results when "mcYears" is NULL and to import detailed results when "mcYears" is set.

NEW FEATURES:

  • New function "getIdCols()" returns the Id columns of an antaresDataTable object.
  • New method "subset()" for antaresDataList objects permits to quickly extract the data for a given area or a given Monte-Carlo scenario.

BUGFIXES:

  • In "input" mode, getLinks() could return links that did not exist anymore.
  • removeVirtualAreas was requiring some data that was not necesary. It should be OK now.
  • setSimulationPath() was crashing when one wanted to read the input data of a study before having run any simulation.
  • Variable "timeId" is now always numeric. Before it was numeric except for annual data where it could be character or factor.

Changes in version 0.14 (2016-11-14)

NEW FEATURES:

  • readAntares() has been significantly improved. Depending on the query, the time needed to import data is decreased by 20% up to 95%. In particular, importing data for clusters is now 20 times faster than before. Moreover, the progress bar is now more precise.
  • removeVirtualAreas() has a new parameter "newCols" that permits to choose whether to create new columns containing the production of the virtual areas or to update the existing ones.
  • removeVirtualAreas() now also removes virtual links from the data. Before it was removing virtual areas but keeping the virtual links.
  • If the transmission capacity of the links is present in the data, removeVirtualAreas() now creates two new columns containing the capacity of pumping and storage of areas. These columns are used to compute upward and downward margins.
  • New functions as.antaresDataTable and as.antaresDataList have been added to convert compatible objects to these classes.

Changes in version 0.13 (2016-10-06)

BREAKING CHANGES:

  • add a file LICENSE and copyright to sources files

Changes in version 0.12 (2016-08-17)

BREAKING CHANGES:

  • The object returned by 'setSimulationPath' and 'simOptions' has been modified. In particular, paths have been renamed to make their utility clearer. Moreover a new element named 'linksDef' contains a table with the specification of each link of the study.

NEW FEATURES:

  • getLinks() can now return a table with the specification of the links, thanks to two new parameters "namesOnly" and "withDirection"
  • It is now possible to import several times the same Monte-Carlo scenario. This can be useful for performance test or to use bootstrap methods.

BUGFIXES:

  • readClusterDesc was not working in input mode.
  • Sometimes setSimulationPath changed working directory.
  • Solved some performance issues in readAntares() and removeVirtualAreas().

Changes in version 0.11 (2016-08-01)

BREAKING CHANGES:

  • The parameters of 'getLinks' have been modified because they were unclear. Now user has to to explicitly specify areas to include and/or exclude.

BUGFIXES:

  • setSimulationPath was crashing if parameter 'horizon' was not set in Antares.
  • changeTimeStep sometimes generated NA values because of integer overflow.

Changes in version 0.10 (2016-07-18)

BREAKING CHANGES:

  • Variable mustRunModuction has been renamed minGenModulation for consistency with Antares
  • Similarly in the object returned by setSimulationPath and simOptions, "setList" has been renamed "districtList"

NEW FEATURES:

  • Now, when one filters, add, remove or update columns of an object of class 'antaresDataTable', the result is still of class 'antaresDataTable'.

Changes in version 0.9.1 (2016-07-05)

BUGFIXES:

  • readAntares was incorrectly setting attributes of its ouput. This resulted in errors when using functions of the antaresProcessing package.

Changes in version 0.9 (2016-07-04)

BREAKING CHANGES:

  • The columns returned by readAntares when 'hydroStorageMaxPower = TRUE' have been renamed.

NEW FEATURES:

  • readAntares has a new parameter "thermalModulation" to import modulation time series.
  • New aliases have been added. One can inspect them with "showAliases()".

Changes in version 0.8 (2016-06-20)

NEW FEATURES:

  • setSimulationPath nows reads costs of unsupplied et spilled energy.
  • ReadLayout computes coordinates for districts and link between them.
  • getAreas has a new parameter "district" to get areas in a set of districts.
  • getLinks has new parameter "areas" to get links connected to a set of areas.

BUGFIXES:

  • Small bug fixes that avoid useless warning messages/

Changes in version 0.7 (2016-06-07)

BREAKING CHANGES:

  • The package has been renamed "antaresRead".

NEW FEATURES:

  • changeTimeStep accepts two new functions : min and max.
  • readAntares now computes the number of available units.

BUGFIXES:

  • setSimulationPath was crashing if parameter "horizon" was not set in Antares.
  • setSimulationPath throws a warning when two simulations have same name and it uses the most recent one.
  • In presence of hubs and production nodes, removeVirtualAreas treated production nodes two times.
  • Column "month" was sometimes numeric and other times character.
  • setSimulationPath was not recognising option "apply-filter = add-all" when retrieving district definition.

Changes in version 0.6 (2016-05-27)

NEW FEATURES:

  • readAntares and readInputTS always add time columns (time, day, month, hour). changeTimeStep now keeps them if they are present.

BUGFIXES:

  • readAntares may not work when some MC years were not exported by Antares.
  • The construction of the weeks was wrong when a year did not start on january.
  • The import of inputs was wrong when the study was not conducted on a whole year but on a smaller period.
  • In removeVirtualNodes, option "reassignCosts" was not working correctly.

Changes in version 0.5 (2016-05-11)

BREAKING CHANGES:

  • To be consistent with Antares, 'node' has been replaced by 'area' everywhere in the package.
  • Column 'MWh' is now named 'production' when reading clusters output.

NEW FEATURES:

  • new function 'readInputTS' to read input time series (without output time series)
  • 'setSimulationPath' now accepts two new values for the argument "simulation": 0 and "input". These values indicate that the user is not interested by the results of any simulation and only wants to read input data.
  • changeTimeStep now accepts for parameter 'fun' a vector of function names that indicate how to aggregate/disagregate each column.
  • getAreas has a new argument "withClustersOnly" to select areas containing clusters
  • readAntares can now also add input time series to districts like it does for areas

BUGFIXES:

  • 'copyToClipboard' was copying the word "txt" instead of copying data
  • 'removeVirtualNodes' was not creating some columns for production virtual nodes.
  • The option 'mustRun' in readAntares was not functionning correctly

Changes in version 0.4 (2016-04-29)

BREAKING CHANGES:

  • The parameters and the output of "readAntares" have been modified. The output has now only three components: nodes, links and clusters. If the user asks other information like hydro storage or links capacities, they are added to the corresponding component. The corresponding parameters now expect TRUE/ FALSE instead of a vector of node or link names.
  • "getLinks" has now same parameters and behavior than "getNodes"
  • Parameter "trace" has been removed in "setSimulationPath".

NEW FEATURES:

  • "readAntares" has a new argument "mustRun"
  • "removeVirtualNodes" has been finalised
  • New function "simOptions" to get either global simulation options or simulation options used by "readAntares" to create a given object
  • New alias "nosum" to remove "min", "max", and "std" columns when "synthesis=TRUE" in "readAntares"
  • "setSimulationPath" has a new argument "simulation" to choose a simulation by name or by order inside an antares project
  • New function "getDistricts"
  • New function "copyToClipboard"
  • Added package vignette

Changes in version 0.3 (2016-04-14)

NEW FEATURES:

  • "readAntares" can now read hydro storage, hydro storage maximum power, reserve and links capacity
  • New function "readAntaresNodes": read all the desired data for a set of nodes
  • New function "readBindingConstraints"
  • New function "changeTimeStep": change the timestep of an "antaresOutput" object or any table containing a variable timeId
  • New function "getNodes": select and filter nodes of an antares study
  • "extractDataList" has been improved for better compatibility with PPSE scripts
  • Improved documentation
  • New function removeVirtualNodes (still experimental)
  • Added this NEWS file :)

Changes in version 0.2 (2016-04-05)

BREAKING CHANGES:

  • "readOutput" has been renamed "readAntares"

NEW FEATURES:

  • "readAntares" can now read thermal availabilities
  • "setSimulationPath" now reads simulation parameters
  • "setSimulationPath" now accepts path to a study and eventually asks the user to choose an output
  • Nodes and sets are now separated in "readAntares" and "setSimulationPath"
  • aliases for groups of variables in parameter "select" of "readAntares"

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("antaresRead")

2.2.3 by Frederic Breant, 2 months ago


https://github.com/rte-antares-rpackage/antaresRead


Report a bug at https://github.com/rte-antares-rpackage/antaresRead/issues


Browse source code at https://github.com/cran/antaresRead


Authors: Jalal-Edine ZAWAM [aut] , Frederic Breant [aut, cre] , Francois Guillem [aut] , Benoit Thieurmel [aut] , Titouan Robert [aut] , RTE [cph]


Documentation:   PDF Manual  


GPL (>= 2) | file LICENSE license


Imports data.table, bit64, lubridate, plyr, methods, stats, stringr, shiny

Suggests rhdf5, testthat, knitr, rmarkdown, foreach, parallel, DT, htmltools


Depended on by antaresEditObject, antaresProcessing, antaresViz.


See at CRAN