Methods for Creating, Accessing and Assigning Spider
objects
Spider-methods.Rd
The Spider
function is used both to create and modify an Spider-class()
object.
and to access and assign Spider
for an object of class Slick-class()
.
See Details
.
Usage
Spider(
Code = "",
Label = "",
Description = "",
Value = array(),
Preset = list()
)
Spider(Slick) <- value
# S4 method for class 'missing'
Spider()
# S4 method for class 'character'
Spider(
Code = "",
Label = "",
Description = "",
Value = array(),
Preset = list()
)
# S4 method for class 'list'
Spider(
Code = "",
Label = "",
Description = "",
Value = array(),
Preset = list()
)
# S4 method for class 'Slick'
Spider(Code)
# S4 method for class 'Slick'
Spider(Slick) <- value
Arguments
- Code
A short code for the Performance Indicators for this object. A character string length
nPI
or a named list for multi-language support. SeeDetails
- Label
A short label for the Performance Indicators for this object. Used to label axes on charts. Can be longer than
Code
but recommended to keep short as possible so it shows clearly in plots and tables. A character string lengthnPI
or a named list for multi-language support. SeeDetails
- Description
A description for the Performance Indicators for this object. Can include Markdown, see
Examples
. A character string lengthnPI
or a named list for multi-language support. SeeDetails
- Value
A numeric array with the stochastic performance indicator values for each operating model (OM), management procedure (MP), and performance indicator (PI). Dimensions: c(
nOM
,nMP
, andnPI
). All PI values must range between 0 and 1 or 0 and 100. If all values are <= 1, they will be multiplied by 100 in the plot.- Preset
An optional named list for the preset buttons in the
App()
. The name of the list element will appear as a button in theApp()
.- Slick
A
Slick-class()
object- value
A
Spider-class()
object
Details
Objects of class Spider
are created with Spider()
Use the Code()
, Label()
, Description()
, Value()
, Preset()
functions to
access and assign the values for an existing Spider
object, see Examples
Functions
Spider(missing)
: Create an emptySpider
objectSpider(character)
: Create a populatedSpider
objectSpider(list)
: Create a populatedSpider
objectSpider(Slick)
: ReturnSpider
from aSlick-class()
objectSpider(Slick) <- value
: Assign aSpider-class()
object to aSlick-class()
object
Examples
# Generate dummy values
nOM <- 2
nMP <- 4
nPI <- 4
values <- array(NA, dim=c(nOM, nMP, nPI))
# Note: PI values must be between 0 and 1, with 1 indicating better performance
pi_means <- runif(nPI, 0, 1)
for (om in 1:nOM) {
for (mp in 1:nMP) {
for (pi in 1:nPI) {
values[om, mp, pi] <- runif(1, pi_means[pi])
}
}
}
# Create and populate Object
spider <- Spider(Code=c('PI1', 'PI2', 'PI3', 'PI4'),
Label=c('Performance Indicator 1',
'Performance Indicator 2',
'Performance Indicator 3',
'Performance Indicator 4'),
Description = c('This is the description for PI 1',
'This is the description for PI 2',
'This is the description for PI 3',
'This is the description for PI 4'),
Value=values)
# Check
Check(spider)
#>
#> ── Checking: "Spider" ──
#>
#> ✔ Complete
# Add to `Slick` object
slick <- Slick()
Spider(slick) <- spider
# Plots
plotSpider(slick)
#> ℹ Note: `MPs` is empty. Using default MP names and colors
plotSpider(slick, fill=TRUE)
#> ℹ Note: `MPs` is empty. Using default MP names and colors
plotSpider(slick, byMP=TRUE)
#> ℹ Note: `MPs` is empty. Using default MP names and colors
plotSpider(slick, byOM=TRUE)
#> ℹ Note: `MPs` is empty. Using default MP names and colors