Learn R Programming

antaresViz

antaresViz is the package to visualize the results of your Antares simulations that you have imported in the R session with package antaresRead. It provides some functions that generate interactive visualisations. Moreover, by default, these functions launch a shiny widget that provides some controls to dynamically choose what data is displayed in the graphics.

Installation

You can install stable version from CRAN with:

install.packages("antaresViz")

To install the last development version:

devtools::install_github("rte-antares-rpackage/antaresViz")

To display the help of the package and see all the functions it provides, use:

help(package="antaresViz")

Basic plots

antaresViz provides a plot method for tables generated with antaresRead. This method is for visualizing a single variable in different formats (times series, barplot, monotone, distribution and cumulative distribution). For instance, the following code displays the distribution of marginal price in different areas.

mydata <- readAntares(areas = "all")
plot(mydata, variable = "MRG. PRICE")

For more information, run:

?plot.antaresDataTable

Stacks

Function prodStack generates a production stack for a set of areas. Different stacks have been defined. One can see their definition with command productionStackAliases().

With function exchangesStack, one can visualize the evolution and origin/destination of imports and exports for a given area.

Maps

The construction of maps first requires to associate geographic coordinates to the areas of a study. antaresViz provides function mapLayout to do interactively this association.

# Get the coordinates of the areas as they have been placed in the antaresSoftware
layout <- readLayout()

# Associate geographical coordinates
myMapLayout <- mapLayout(layout)

# This mapping should be done once and the result be saved on disk.
save(myMapLayout, file = "myMapLayout.rda")

Then map can be generated with function plotMap:

myData <- readAntares(areas = "all", links = "all")
plotMap(myData, myMapLayout)

You can use spMaps to set a map background or download some files at https://gadm.org/download_country_v3.html.

Contributing:

Contributions to the library are welcome and can be submitted in the form of pull requests to this repository.

ANTARES :

Antares is a powerful software developed by RTE to simulate and study electric power systems (more information about Antares here : https://antares-simulator.org/).

ANTARES is now an open-source project (since 2018), you can download the sources here if you want to use this package.

License Information:

Copyright 2015-2016 RTE (France)

This Source Code is subject to the terms of the GNU General Public License, version 2 or any higher version. If a copy of the GPL-v2 was not distributed with this file, You can obtain one at https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html.

Copy Link

Version

Install

install.packages('antaresViz')

Monthly Downloads

604

Version

0.18.3

License

GPL (>= 3)

Issues

Pull Requests

Stars

Forks

Maintainer

Tatiana Vargas

Last Published

December 2nd, 2024

Functions in antaresViz (0.18.3)

addShadows

Add a shadow to map layers
exchangesStack

Plot the exchanges of an area
plotMapOptions

Graphical options for plotMap
plotThermalGroupCapacities

Plot for Thermal Group Capacities
limitSizeGraph

Use to change limit size of graph (in Mb)
mapLayout

Place areas of a study on a map
runAppAntaresViz

Run app antaresViz
savePlotAsPng

Save interactive plot as a png image
plotMapLayout

Visualize mapLayout output.
placeGeoPoints-shiny

Shiny bindings for placeGeoPoints
plotMap

Display results of a simulation on a map
modXY

Make X-Y bockey plot, interactive version
modRpart

Make rpart from antares data
plot.mapLayout

Plot method for map layout
setInteractivity

Get and set interactivity mode
prodStackExchangesLegend

Plot an interactive legend for time series plots
plotXY

Plot density between X et Y with ggplot2 and plotly
prodStackAliases

Visualize the production stack of an area
stackMap

plot stack and map
tsPlot

plot time series contained in an antaresData object