Get and set eplusr options which affect the way in which eplusr computes and displays its results.
eplusr_option(...)Any available options to define, using name = value. All
available options are shown below. If no options are given, all values of
current options are returned. If a single option name, its value is returned.
If called directly, a named list of input option values. If input is a single option name, a length-one vector whose type is determined by that option. If input is new option values, a named list of newly set option values.
validate_level: The strictness level of validation during field value
modification and model error checking. Possible value: "none",
"draft" and "final" or a custom validation level using
custom_validate(). Default: "final". For what validation
components each level contains, see level_checks().
view_in_ip: Whether models should be presented in IP units. Default:
FALSE. It is not recommended to set this option to TRUE as currently
IP-units support in eplusr is not fully tested.
save_format: The default format to use when saving Idf objects to .idf files.
Possible values: "asis", "sorted", "new_top" and "new_bot".
The later three have the same effect as Save Options settings
"Sorted", "Original with New at Top" and "Original with New at Bottom" in IDF Editor, respectively. For "asis", the saving format
will be set according to the header of IDF file. If no header found,
"sorted" is used. Default: "asis".
num_parallel: Maximum number of parallel simulations to run. Default:
parallel::detectCores().
verbose_info: Whether to show information messages. Default: TRUE.
autocomplete: Deprecated. Whether to turn on autocompletion on class
and field names. Now autocompletion is enabled all the time.
# list all current options
eplusr_option() # a named list
#> $num_parallel
#> [1] 4
#>
#> $save_format
#> [1] "asis"
#>
#> $validate_level
#> $validate_level$required_object
#> [1] FALSE
#>
#> $validate_level$unique_object
#> [1] FALSE
#>
#> $validate_level$unique_name
#> [1] TRUE
#>
#> $validate_level$extensible
#> [1] FALSE
#>
#> $validate_level$required_field
#> [1] FALSE
#>
#> $validate_level$auto_field
#> [1] FALSE
#>
#> $validate_level$type
#> [1] FALSE
#>
#> $validate_level$choice
#> [1] FALSE
#>
#> $validate_level$range
#> [1] FALSE
#>
#> $validate_level$reference
#> [1] FALSE
#>
#>
#> $verbose_info
#> [1] TRUE
#>
#> $view_in_ip
#> [1] FALSE
#>
# get a specific option value
eplusr_option("verbose_info")
#> [1] TRUE
# set options
eplusr_option(verbose_info = TRUE, view_in_ip = FALSE)
#> $verbose_info
#> [1] TRUE
#>
#> $view_in_ip
#> [1] FALSE
#>