Overview
rrstools is an R package for analyzing data from RoboCupRescue Simulation (RRS), a disaster response simulation platform where autonomous agents work together to rescue civilians and minimize damage in a simulated urban earthquake disaster. This package aims to support both competitors developing rescue agents and researchers studying multi-agent systems, by providing tools to read, visualize, and analyze RRS data such as map data and scenario configurations.
Installation
You can install the development version of rrstools using the following methods:
Using install.packages() (R-universe)
# Enable the R-universe
options(repos = c(
nononoexe = "https://nononoexe.r-universe.dev",
cran = "https://cloud.r-project.org"
))
# Install the package
install.packages("rrstools")Using pak
# install.packages("pak")
pak::pak("nononoexe/rrstools")Usage
Reading and plotting map data
This package provides functions to read and plot RRS map data.
library(rrstools)
# Sample GML file bundled with the package
gml <- system.file("extdata", "map-test.gml", package = "rrstools")
# Read the map data from the GML file
map <- read_rrs_map(gml)
# Print the map data
map
#> RoboCupRescue Simulation map object
#> Number of elements: nodes: 315 edges: 413 faces: 95
#> Bounding box: xmin: -30.000000 ymin: -20.000000 xmax: 135.000000 ymax: 121.000000
# Plot the map data
plot(map)
Overlaying scenario data
It is possible to overlay scenario data on the map.
# Sample scenario file bundled with the package
xml <- system.file("extdata", "scenario-test.xml", package = "rrstools")
# Read the scenario data from the XML file
scenario <- read_rrs_scenario(xml)
# Print the scenario data
scenario
#> RoboCupRescue Simulation scenario object
#> Number of entities: 35
#> Entities by type:
#> Type Count
#> ambulancecentre 1
#> ambulanceteam 4
#> civilian 20
#> firebrigade 6
#> firestation 1
#> policeforce 1
#> refuge 2
# Plot the map with the scenario data
plot(map, scenario)
Code of Conduct
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.