Get and Set eplusr options — eplusr

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_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.

Author

Hongyuan Jia

Examples

# 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
#>