group_job()
supports single IDF input with multiple EPW inputs (#185).Idf$last_job()
has been added to enable getting the last simulation job created using Idf$run()
(#187)./usr/local/EnergyPlus-X-Y-0
, but instead extracting all files directly into /usr/local
(NREL/EnergyPlus#7256) (#193).group_ext
has been added in Idf$to_table()
and IdfObject$to_table()
, with default value being "none"
. If "group"
, values from extensible fields will be grouped by the extensible group they belong to. For example, coordinate values of each vertex in class BuildingSurface:Detailed
will be put into a list. If "index"
, values from extensible fields will be grouped by the extensible field indices they belong to. For example, coordinate values of all x coordinates will be put into a list (#74).EplusSql$tabular_data()
has been improved (#190).EplusSql$tabular_data()
keeps the original column order when wide
is TRUE
(#186).eplus_config()
will always return the expanded EnergyPlus path (#196).group_job()
will return more informative error messages when input contains Idf
objects that havn’t been saved (#204).EplusGroupJob$run()
when custom dir
is specified (#205).A new method $models()
has been added in ParametricJob
class. It returns a list of all parametric models generated after a measure has been applied. If no measure is applied, NULL
is returned (#59). Thanks @yidan1214 for this feature request.
A new method $save()
has been added in ParametricJob
class. It saves all generated parametric models and weather file into specified directory. You can use separate
argument to determine whether each model is to be saved in a separate folder (#58). Thanks @yidan1214 for this feature request.
New arguments align
and all
have been added to $to_table()
method in Idf
class. Setting align
to TRUE
will make sure that all returned object data per class have the same field number. The number of fields is the same as the object that have the most fields among those you specified. Setting all
to TRUE
will return all available fields in that class definition in IDD.
Now the weather
argument in $run()
method in Idf
class can be set to NULL
. If so, design-day-only simulation is performed. Note that this needs at least one Sizing:DesignDay
object exists in the Idf
object (#80).
Similar as above, the epw
argument in eplus_job()
and param_job()
can also be NULL
to force a design-day-only simulation.
Now $status()
in ParametricJob
class includes a new member named job_status
which is data.table containing detailed information on each simulation job (#70).
Now $print()
in ParametricJob
will give you more informative details on each simulation job status, especially when wait
is set to FALSE
in $run()
.
A new column index
is added in the returned RddFile
and MddFile
. It contains index of each variable.
Two new methods $read_rdd()
and $read_mdd()
have been added in EplusJob
class. $read_rdd()
and $read_mdd()
which parse the simulation RDD and MDD file (#84).
Two new function rdd_to_load()
and mdd_to_load()
have been added, which format RddFile
and MddFile
into a data.table in acceptable format for $load()
method in Idf
class.
Similar as Output:SQLite
, when $run()
in Idf
object is called, an object in class Output:VariableDictionary
is automatically created with Key Field
being IDF
(#85).
A new argument echo
has been added in $run()
in Idf
, EplusJob
and ParametricJob
class. It is only applicable when wait
is TRUE
. If FALSE
, the simulation will be run silently without echoing any message from EnergyPlus.
A new function transition()
has been added. Basically it is an R implementation of IDFVersionUpdater. Currently the lowest version of IDF is v7.2. It should be much faster than IDFVersionUpdater.
Now the way of find IDD file has been changed to take advantage of IDD files distributed along with IDFVersionUpdater. This update makes it possible to directly read IDF of most versions without downloading corresponding IDD.
A new option autocomplete
with default value being interactive()
has been added. It is used to control whether to turn on autocompletion on class and field names. Underneath, makeActiveBinding()
is used to add or move active bindings in Idf
and IdfObject
s to directly return objects in class or field values. This will make it possible to dynamically show current class and field names in both RStudio and in the terminal. However, this process does come in with a penalty on the performance. It can make adding or modifying large mounts of [Idf] and [IdfObject]s extremely slow. Default value make sure autocompletion works in interactive mode.
A new syntax class := list(field = value)
in $set()
has been added. Note the use of :=
instead of =
. The main difference is that, unlike =
, the left hand side of :=
should be a valid class name in current Idf
object. It will set the field of all objects in specified class to specified value.
A new function dt_to_load()
has been added, which formats a data.table from Idf$to_table()
and IdfObject$to_table()
with wide
being to TRUE
into a data.table in acceptable format for Idf$load()
method and Idf$update()
method.
Now read_epw()
support EPW files with non-integer timezones fail to load (#113). $location()
in Epw
class also support setting the timezone to non-integer one.
A new method $parent()
has been added in IddObject
and IdfObject
class to get parent Idd
and Idf
object, respectively (#76).
Simulation status will be updated in the progress message in run_multi()
and $run()
method in ParametricJob
class, instead of only showing COMPLETED
(#124, #125).
EplusJob
class now will parse and store input IDF and EPW. It will also add Output:SQLite
and Output:VariableDictionary
object if necessary. This change makes sure using EplusJob
can always have the ability to extract simulation results instead of totally relying on the input IDF (#118).
As a result of previous change, the $run()
method in EplusJob
now takes the same parameters as $run()
method in Idf
, i.e. you can also change the EPW file to use and output directory using epw
and dir
argument (#118).
A new class EplusGroupJob
is added. It can be created using group_job()
. EplusGroupJob
provides a wrapper of run_multi()
to group multiple EnergyPlus simulations together for running and collecting different EnergyPlus outputs (#117).
A new parameter named .empty
has been added in $set()
, $insert()
, $load()
, $update()
, $paste()
methods in Idf
class and $set()
method in IdfObject
class (#133).
EnergyPlus v9.2 support has been added (#138).
Now required objects and unique objects can be deleted in $del()
when .force
is set to TRUE
(#149).
Now for Windows and Linux, install_eplus()
supports to install EnergyPlus to your home directory or your customized directory without requiring administrator privileges (#167).
# install to your home directory
install_eplus(8.8, local = TRUE)
# install to custom directory
install_eplus(8.8, local = TRUE, dir = "~/MyPrograms")
Please see ?install_eplus
for details.
All documentation in R6 classes have been update thanks to roxyten2 R6 support (#156).
Deprecated methods in each class have all been remove (#156).
New parameter case
has been added in EplusSql$tabular_data()
. Similar like case
parameter in EplusSql$report_data()
, it lets you to add a case
column to indicate the case of simulation. This brings some changes in the returned results of EplusSql$tabular_data()
. Compared to previous version, there will always be a case
column, unless case
parameter is set to NULL
(#182).
New parameter wide
and string_value
have been added in EplusSql$tabular_data()
and EplusGroupJob$tabular_data()
. When wide
is TRUE
, each table will be converted into the similar format as it is shown in EnergyPlus HTML output file. And when string_value
is FALSE
, values in possible numeric columns are converted into numbers (#182).
$set()
when $add_unit()
is performed in Epw class (#56).$ref_to_object()
and $ref_by_object()
can give correct results when class
argument is specified.ErrFile
objects returned from $errors()
in ParametricJob
can be successfully printed."Output:Surfaces:List,,;\n"
, can be successfully parsed (#88).$to_table()
when no arguments were provided (#103).$update()
now works for class Schedule:Compact
with type checking on (#111).$ref_to_node()
when no objects in specified class is found (#110).leading
and sep_at
argument work as expected in Idf$to_string()
(#160).Idf$to_table()
matches object names case-insensitively (#157).Version
object with trailing comments can be successfully parsed, e.g. Version, 8.6; !- ABC
(#170).$apply_measure()
(#57). Thanks @yidan1214 for pointing this out.echo
argument in run_idf()
and run_multi()
will only take effect when wait
is TRUE
. This makes it possible to remove the dependency on the later package.verbose_info
option to FALSE
.$delete()
method in Epw
class has been deprecatd in flavor of $del()
to provide a similar API as Idf
class.all
is TRUE
in $report_data()
in EplusSql
, EplusJob
and ParametricJob
class, an extra column environment_period_index
is returned which contains the indices of each run period environment. This helps to distinguish different run period environment when no name is assigned.param_job()
now gives more informative error message if input Idf
object and Epw
object is not created from a local file (#112).param_job()
now preserve parametric model names from argument .names
in $apply_measure()
instead of calling make.name()
to convert them into valid R names (#115).$save()
works if weather was not given during initialization for ParametricJob
(#120).IdfObject
are now marked with *
when printing (#135).This is a bug fix release which make sure eplusr is compatible with new version of R6 #164. No new feature is included.
Idd
and Idf
objects, and field names of IdfObject
class in RStudio.[[<-.Idf
and $<-.Idf
now can work with unique-object classes as well.$update()
is added in Idf
class which makes it possible to directly modify existing objects using character vectors and data.frames.wide
is added in $to_table()
method in Idf
class, similar to $to_table()
method in IdfObject
class.read_rdd()
and read_mdd()
are added to help to directly parse .rdd
and .mdd
file.$rename()
will not give an error if input name is the same as the old one.$version()
is added in EplusJob
and ParametricJob
class, which returns the version of IDF it uses.by_group
is added in $class_index()
, $class_name()
in Idd
class and $class_name()
in Idf
class. If TRUE
, a list is returned which separate class indexes/names by the group they belong to.$object_relation()
in Idf
class, and $value_relation()
, $ref_to_object()
, $ref_by_object()
in IdfObject
class. All type of relations can be searched recursively by setting newly added argument recursive
to TRUE
. There is also a new argument called depth
to control how many recursive searching steps should be performed.$value_possible()
in IdfObject
class, i.e. if specified fields are nodes, all nodes are returned in the source
component."node"
has been added to the direction
argument in $object_relation
, $objects_in_relation()
in Idf
class and $value_relation()
in IdfObject
class. New methods $ref_to_node()
and $has_ref_node()
have been added in IdfObject
class. Now $has_ref()
in IdfObject
class will return FALSE
only when all $has_ref_to()
, $has_ref_by()
and $has_ref_node()
are all FALSE
.data.table
s are correctly copied when calling $clone()
in Idf
and Epw
class.$add()
method and other methods that modify field values can correctly convert field values to numbers if necessary..err
file when there is no warning nor error.$errors()
error in ParametricJob
class.$data()
, $abnormal_data()
and $redundant_data()
now have correct values (#44).read_epw()
(#44).paste()
(#45).$report_data()
in EplusSql
(#46).hours_8_to_4_12.8_20.6
is zero..err
file are parsed correctly in ErrFile
.get_value_reference_map()
(#50).$value_possible()
(#51)..ref_to
argument in $del()
in Idf
class did not take effect.$update()
in Idf
class.Schedule:File
class are now only copied once when copy_external
is TRUE
in $save()
in Idf
class..ref_to
or .ref_by
is TRUE
in $del()
in Idf
class, objects whose class names are referenced by input will not be deleted, except all objects in referenced class are detected by field value reference or there is only one object in referenced class..ref_to
and .ref_by
in $del()
in Idf
class can now be successfully deleted, even if they still have relations with other objects.$value_possible()
returns correct source values when fields refer to class names rather than field values.$del()
method in Idf
class works correctly with multiple inputs.read_idf()
.$to_table()
in Idf
class will keep the input object order.$set()
method in IdfObject
can successfully delete fields when field values are set to NULL
.$run()
method in Idf
will use the correct model path to run simulation.$ref_to_object()
and $ref_by_object()
in IdfObject
.ErrFile
is stored as a data.table
with additional attributes instead of a list..unqiue
is TRUE
in $insert()
, $load()
and $paste()
in Idf
class, object comparison are performed case-insensitively."."
of dir
in download_idd()
is add.This is a patch update mainly to fix CRAN check errors on a strict Latin locale, with a bug fix.
$report_data()
method in EplusSql
class now correctly returns data if even if key_value
is not given (#37)This is a patch update mainly to fix CRAN check errors, with few bug fixes.
$set()
method in Idf
class now does not try to convert all input strings into numbers (#32)$del()
method in Idf
class now also respects validation settings. You should be able to delete any object if current validation level does not include reference checking$del()
method in Idf
class now will only print object relation only if .ref_to
or .ref_by
is TRUE
$set()
method in Epw
class will correctly reset leap year flag in the header (#32)$save()
method in Epw
class returns the path of saved file invisiblyeplusr v0.10.0 introduces dozens of improvements, unfortunately also has some break changes. Detailed updates per class are as follow:
Idd
Class$object()
now takes a single class name and returns an IddObject
.
New method $objects()
is added as the successor of $object()
in previous versions.
New method $object_relation()
and $objects_in_relation()
are added to get all objects that have relation (one refer to others or one referred by others).
$object_in_group()
has been deprecated in flavor of $objects_in_group()
.
New method $to_table()
and $to_string()
are added to help easily extract internal IDD data in data.table
format and string format respectively.
$clone()
method is now deprecated.
S3 method str.Idd()
, format.Idd()
are added.
IddObject
ClassA constructor idd_object()
has been added to help directly create IddObject
. It takes a parent IDD version or an Idd
object and a valid class name or class index, e.g. idd_object(8.8, "Material")
, idd_object(use_idd(8.8), "Construction")
New method $version()
is added to extract the version of parent IDD.
New method $field_relation()
is added to extract the field relation in current class with other class fields.
New method $has_ref()
, $has_ref_to()
, and $has_ref_by()
are added to help to detect field relations
New method $is_real_field()
is added to detect if specified fields should have values of real numbers but not integers.
New method $has_ref()
, $has_ref_by()
, $has_ref_to()
are added to detect if specified fields refer to other fields or can be referred by other field in other classes.
New method $to_table()
and $to_string()
are added to help easily extract internal IDD data in data.table
format and string format respectively.
field_possible()
now does not need IdfObject
data to run.
Argument lower
in $field_name()
has been deprecated.
$field_reference()
in IddObject
class has been deprecated in flavor of $field_relation()
.
A brief
argument is added in $print()
with default value of FALSE
. If TRUE
, only the class name of the IddObject
is printed.
$clone()
method is now deprecated.
S3 method format.IddObject()
, as.character.IddObject()
and str.IddObject()
are added which calls $to_string()
and $print()
.
Idf
ClassAn argument sorted
is added in $class_name()
and $group_name()
to control whether to sort the returned value according to the occurrence in IDD or not.
$definition()
now only accepts one class name and returns a single IddObject
, not a list of IddObject
.
$object()
now takes a single object ID or name and returns an IdfObject
.
New method $objects()
is added as the successor of $object()
in previous versions.
New method $object_unique()
is added which returns an IdfObject
in unique-object class, e.g. SimulaSimulationContrl
. This makes it easy to directly extract and modify those objects, e.g. model$object_unique("SimulationContrl")$set(...)
.
$object_in_class()
now is deprecated in flavor of $objects_in_class()
.
New method $objects_in_group()
is added to get all objects in specified group.
$search_object()
, $search_value()
and $replace_value()
now can take same arguments as base::grepl()
to further control the way it searches objects.
$replace_value()
now will perform validations when replacing value.
Now all methods in Idf
class that return IdfObject
s will not convert object names into valid R names. The former conversion behavior is unnecessary and a little bit confusing.
$add_object()
, $set_object()
, $del_object()
, $ins_object()
and $del_object()
are now all deprecated. Please use $add()
, $set()
, $del()
and insert()
instead, which provide much cleaner syntax.
New method $rename()
is added which helps to modify only object names.
New method $paste()
is added which will parse contents that copied from IDF Editor using the Copy Obj
button and directly insert them into current Idf
.
$validate()
and $is_valid()
now accepts an argument level
. Also, a helper custom_validate()
is added to customize what kind of validations to check.
$string()
is deprecated in flavor of $to_string()
in Idf
class.
New method $to_table()
is added which can extract object data into a data.table
.
The default value of deep
argument in $clone()
method is set to TRUE
. As in almost all cases, a total cloned object is desired when calling $clone()
.
plain
argument is deprecated in $print()
in IDF class. Because the same thing can be achieved using $to_string()
and base::cat()
. New argument zoom
and order
are added, which give more control on how detailed should the model be printed.
New method $object_relation()
and $objects_in_relation()
are added to extract all objects in relation.
IdfObject
ClassNew constructor idf_object()
is added.
New method $version()
is added to get the underlying version of IDD.
$get_comment()
, $get_value()
now have been deprecated in flavor of $comment()
and $value()
$comment()
(former $get_comment()
) now returns NULL
if the object does not have any comment.
$set_value()
now has been deprecated in flavor of $set()
$possible_value()
now has been deprecated in flavor of $value_possible()
.
$ref_from_object()
and $has_ref_from()
now have been deprecated in flavor of $ref_to_object()
and $has_ref_to()
.
$has_ref_by()
, $has_ref_to()
and $has_ref()
now return a logical vector of the same length as field numbers.
$validate()
and $is_valid()
now accepts an argument level
. Also, a helper custom_validate()
is added to customize what kind of validations to check.
$string()
and $table()
are now deprecated in flavor of $to_string()
and $to_table()
.
$clone()
method is now deprecated.
S3 methods format.IdfObject()
, as.character.IdfObject()
and str.IdfObject()
are added, which calls $to_string()
and $value()
.
Epw
ClassEpw
class has been totally rewritten which provides much more functionalities. Please refer to package documentation for details. All headers are parsed and can be retrieve in Epw
class.
The default value of deep
in $clone()
has been change to TRUE
.
EplusSql
ClassNew method $path_idf()
is added to return the parent IDF file path.
New arguments period
, month
, day
, hour
, minute
, interval
, simulation_days
, day_type
and environment_name
are added in $report_data()
which provide extra subsetting on the SQL file.
New arguments report_name
, report_for
, table_name
, column_name
and row_name
are added in $tabular_data()
which provide extra subsetting on the SQL file.
$clone()
method is now deprecated.
EplusJob
ClassNew method $path()
is added to return the path of IDF and/or EPW file of the job.
New method $list_table()
, $read_table()
are added which provide the same functionalities as they are in EplusSql
class.
$clone()
is now deprecated.
New arguments period
, month
, day
, hour
, minute
, interval
, simulation_days
, day_type
and environment_name
are added in $report_data()
which provide extra subsetting on the SQL file.
New arguments report_name
, report_for
, table_name
, column_name
and row_name
are added in $tabular_data()
which provide extra subsetting on the SQL file.
$clone()
method is now deprecated.
ParametricJob
ClassNew arguments force
and copy_external
are added in $run()
which have the same effect as in $run()
method in Idf
class.
New arguments period
, month
, day
, hour
, minute
, interval
, simulation_days
, day_type
and environment_name
are added in $report_data()
which provide extra subsetting on the SQL file.
New arguments report_name
, report_for
, table_name
, column_name
and row_name
are added in $tabular_data()
which provide extra subsetting on the SQL file.
$clone()
method is now deprecated.
Function read_err()
is added which takes a path of an .err
file, parses it and returns an ErrFile
object.
Functions is_eplus_ver()
, is_idd_ver()
, is_eplus_path()
, is_idd()
, is_idf()
, is_iddobject()
, is_idfobject()
and is_epw()
are now exported.
Function custom_validate()
and level_checks()
are added to customize validation.
Right now, all returned object and field names will remain what they are as in the IDF, instead of converting them into underscore
style names in the returned lists.
The num_digits
option has been deprecated as formatting of numeric fields are now handled by R itself.
Error will be given instead of warning if there is no build tag or multiple build tags found in input IDD.
eplusr_option()
accepts custom validate level using newly-added function custom_validate()
.
download_weather()
. It takes a regular expression as input, searches through EnergyPlus weather data base (stored in this package), download corresponding files and return the saved paths. Below are some examples:
Search locations that contains string "los angeles"
and "tmy"
, return a menu to select which one(s) to download. Once selected, download both corresponding weather file(s) and design day file(s):
Same as above, expect that all files will be renamed to la.epw(ddy)
, la_1.epw(ddy)
, la_2.epw(ddy)
:
Search locations that contains string "beijing"
and "cswd"
. If no more than 3 results found, directly download all weather files and save them to temporary directory.
clean_wd()
is run before every call to EnergyPlus.$clone()
method has been refactored for Idf
and Idd
class. This fix the issue that internal shared environments were not cloned in version 0.9.3.
Fix the error that $save()
and $string()
in Idf
class did not respect format
argument.
Fix the error that $apply_measure()
in ParametricJob
class did not respect .names
argument.
$clone()
method in R6 in order to be compatible with (#19). After this, deep
has to be set to TRUE
if a completed cloned copy is desired. Also, documentations on $clone()
method in Epw
, EplusJob
, ParametricJob
have been added.clean_wd()
is called internally when running EnergyPlus models. This guarantees that the old output file from last simulation is cleaned up before the new simulation starts.A new class EplusSql
has been added. This makes it possible to directly retrieve simulation results without creating an EplusJob
object which can only get simulation outputs after the job was successfully run before. It can be easily created using eplus_sql()
function. However, it should be noted that, unlike EplusJob
, there is no checking on whether the simulation is terminated or completed unsuccessfully, or the parent Idf has been changed since last simulation. This means that you may encounter some problems when retrieve data from an unsuccessful simulation. It is suggested to carefully go through the .err
file to make sure the output data in the SQLite is correct and reliable. Currently, there are only few methods in EplusSql
class which have some overlaps with theses in EplusJob
, but more methods may be added in the future. For more details, please see the documentation of EplusSql
.
A new method $is_double_field()
is added to IddObject
class to check if specified fields should be double numbers
dir
is not NULL
in $run()
in Idf
class.Fix the error when checking invalid extensible fields in value validation.
Fix the error that value references did not get updated when setting values to NA
in $set_value()
in IdfObject
and $set_object()
in Idf
.
parallel_backend
argument in run_multi()
has been removed, due to the reason that supporting remote parallel computing is out of the scope of this package. This makes it possible to remove both future
and furrr
package dependencies. The default behavior of run_multi()
does not change if running on local machine, as it still runs multiple EnergyPlus instances in parallel.
In run_idf()
and run_multi()
, eplus
argument has been moved to be the last argument with default value setting to NULL
. This will make them a little bit more convenient to run EnergyPlus without explicitly specify the version. If NULL
, the version of EnergyPlus is automatically detected using the version field of input model. For example: ```r # before run_idf(8.8, model.idf, weather.epw)
# after run_idf(model.idf, weather.epw) ```
Both argument echo
and wait
have been added to run_idf()
and run_multi()
. Unlike the behavior in eplusr 0.8.3 when echo
is TRUE
in run_idf()
, right now echo
only control whether to show the output from EnergyPlus command line interface. Please use wait
to control whether to wait until the simulation is complete or not.
Package documentation has been heavily updated. Examples of every exported class and most functions have been added. Also, an example IDF file "1ZoneUncontrolled.idf"
from EnergyPlus v8.8.0 is included in the package, which makes it possible to run most examples without installing EnergyPlus. Of cause, for examples in EplusJob
and ParametricJob
class, EnergyPlus installation is needed to run them successfully.
The brilliant package crayon is used to support colorful printing of Idd
, Idf
, IddObject
, IdfObject
, Epw
, EplusJob
and ParametricJob
classes.
A new type of "character"
validation has been added, which will check if field values should be characters but are not.
A new option copy_external
has been added in $run()
in Idf
class. If TRUE
, the external files will also be copied into the output directory. Currently, only Schedule:File
class is supported. This ensures that the output directory will have all files needed for the model to run.
$validate()
in Idf
and IdfObject
class will also check incomplete extensible groups. Extensible groups that only contain any empty field are treated as invalid.
New methods $field_reference()
and $field_possible()
have been added into IddObject
class. $field_possible()
is basically the same as the $possible_value()
in IdfObject
class. This makes it possible to show all available references for a class that does not have any object yet. $field_reference()
only returns all available reference values for specified fields. NOTE: $field_reference()
and $field_possible()
can only be used in IddObject
s that are created using $definition()
in Idf
class and IdfObject
class, and cannot be used in IddObject
s that are created using $object()
or equivalent in Idd
class. This is because both methods need shared Idf value data to collect all reference values.
use_eplus()
now returns an invisible list of EnergyPlus configure data instead of NULL
.
The default value of dir
argument in download_eplus()
has been removed, which enforce the user to explicitly specify the directory to save EnergyPlus installer file, as per CRAN reviewer comment.
A new option "auto"
for download
argument in use_idd()
has been added, which will automatically download corresponding EnergyPlus IDD file if the file or Idd object is currently not available.
The dir
argument in install_eplus()
has been removed, as per CRAN reviewer comments. The EnergyPlus installer file will be saved into tempdir()
.
The default value of dir
argument in $run()
in Idf
class has been removed, as per CRAN reviewer comments. Users can explicitly set dir
to NULL
if they want to use the directory of input IDF file.
The default value of echo
in run_idf()
has been changed to TRUE
, which will always show EnergyPlus simulation process to the console.
Fix the error of output_dir
argument checking in rum_multi()
.
Now an informative error message is given when there is no SQL output found when trying to read simulation output using $report_data()
, $report_data_dict
and tabular_data()
in EplusJob
class.
run_idf()
and run_multi()
now does not call clean_wd()
as this is automatically handled by EnergyPlus itself.
Fix errors when try to get units $field_name()
, $field_unit()
and $field_default()
in IddObject
class.
Fix the error that $get_value()
and $table()
in IdfObject
class did not return all field values even all
was set to TRUE
.
Fix the error that $table()
in IdfObject
class did not return field units even unit
was set to TRUE
.
Fix the error that $replace_value()
in Idf
class did not update object names.
Fix the error when unit
is set to TRUE
in $get_data()
in Epw
class.
Fix the error that $state_province
in Epw
class always returns NULL
.
Fix the error of missing expanded IDF files which occurred randomly in run_multi()
.
A new method $possible_value()
has been added into IdfObject
class, which will return all possible values for selected fields, including auto-value (autosize or autocalculate), default, range, choices and references.
New parameter dir
has been added to install_eplus()
, which makes it possible for keeping the downloaded EnergyPlus installation file.
$dup_object()
in Idf
class now can duplicate one object multiple times.
The names of returned list of $get_value()
in IdfObject
is “underscore” name, not lower name. This makes its behavior being consistent with $object()
in Idf
class.
When wait
is FALSE
, $run()
in EplusJob
and ParametricJob
will return itself instead of the time when simulation started.
A clear message will be given when trying to run $kill()
in ParametricJob
, which inform the user that currently $kill()
does not for parametric simulations.
A warning will be given if no configuration data found in eplus_config()
.
Now the names of returned list from $search_object()
in Idf
class will also be underscore-style object names, which makes its behavior being consistent with $object()
and $object_in_class()
. Also, if no results found, $search_object()
now will return invisible NULL
and give a message.
$dup_object()
will give an error if given new_name
is the an existing object name.
Fix errors in $status()
, $output_dir()
and $locate_output()
in ParametricJob
class when which
arg is not given (#12).
Fix idf input version parsing in param_job
(#13).
Fix EnergyPlus downloading and installing errors on Linux and macOS (#14, #17).
Fix run_idf()
and run_multi()
errors on Linux and macOS (#14).
Fix missing name attribute in class NodeList
(#16).
Fix errors in use_eplus()
when input is an EnergyPlus installation path (#18).
$get_value()
in IdfObject
class new has a new argument simplify
. If TRUE
, a character vector will be returned instead of a named list. Default is FALSE
.$get_value()
in IdfObject
is “underscore” name, not lower name. This makes its behavior being consistent with $object()
in Idf
class.Fix warning messages of column type coercion from data.table in Idf
and IdfObject
.
$set_value()
in IdfObject
and $set_object()
in Idf
now will delete empty fields with empty value. This fix the error when trying to reassign only some empty fields which have been deleted before.