Get and set eplusr options which affect the way in which eplusr computes and displays its results.

eplusr_option(...)

Arguments

...

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.

Value

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.

Details

  • 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_bottom". 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.

Examples

# list all current options eplusr_option() # a named list
#> $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$autofield #> [1] FALSE #> #> $validate_level$type #> [1] FALSE #> #> $validate_level$choice #> [1] FALSE #> #> $validate_level$range #> [1] FALSE #> #> $validate_level$reference #> [1] FALSE #> #> #> $view_in_ip #> [1] FALSE #> #> $save_format #> [1] "asis" #> #> $num_parallel #> [1] 2 #> #> $verbose_info #> [1] TRUE #>
# 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 #>