lib/measures/TimeseriesObjectiveFunction/README.md in openstudio-calibration-0.5.0 vs lib/measures/TimeseriesObjectiveFunction/README.md in openstudio-calibration-0.5.1

- old
+ new

@@ -1,28 +1,194 @@ ###### (Automatically generated documentation) -# +# TimeSeries Objective Function ## Description +Creates Objective Function from Timeseries Data - ## Modeler Description +Creates Objective Function from Timeseries Data. The measure applies a Norm at each timestep between the difference of CSV metered data and SQL model data. A timeseries plot can also be created. Possible outputs are 'cvrmse', 'nmbe', 'simdata' = sum of the simulated data, 'csvdata' = sum of metered data, 'diff' = P Norm between the metered and simulated data if Norm is 1 or 2, else its just the Difference. - ## Measure Type -ModelMeasure +ReportingMeasure ## Taxonomy ## Arguments +### Path to CSV file for the metered data +Path to CSV file including file name. +**Name:** csv_name, +**Type:** String, +**Units:** , +**Required:** true, +**Model Dependent:** false +### CSV Time Header +CSV Time Header Value. Used to determine the timestamp column in the CSV file +**Name:** csv_time_header, +**Type:** String, +**Units:** , +**Required:** true, +**Model Dependent:** false -This measure does not have any user arguments +### CSV variable name +CSV variable name. Used to determine the variable column in the CSV file +**Name:** csv_var, +**Type:** String, +**Units:** , +**Required:** true, +**Model Dependent:** false + +### Convert Units +Convert Units in Metered Data +**Name:** convert_data, +**Type:** Choice, +**Units:** , +**Required:** true, +**Model Dependent:** false + +### CSV variable display name +CSV variable display name. Not yet Implemented +**Name:** csv_var_dn, +**Type:** String, +**Units:** , +**Required:** true, +**Model Dependent:** false + +### Year in csv data timestamp +Is the Year in the csv data timestamp => mm:dd:yy or mm:dd (true/false) +**Name:** year, +**Type:** Boolean, +**Units:** , +**Required:** true, +**Model Dependent:** false + +### Seconds in csv data timestamp +Is the Seconds in the csv data timestamp => hh:mm:ss or hh:mm (true/false) +**Name:** seconds, +**Type:** Boolean, +**Units:** , +**Required:** true, +**Model Dependent:** false + +### SQL key value +SQL key value for the SQL query to find the variable in the SQL file +**Name:** key_value, +**Type:** String, +**Units:** , +**Required:** true, +**Model Dependent:** false + +### TimeSeries Name +TimeSeries Name for the SQL query to find the variable in the SQL file +**Name:** timeseries_name, +**Type:** String, +**Units:** , +**Required:** true, +**Model Dependent:** false + +### Reporting Frequency +Reporting Frequency for SQL Query +**Name:** reporting_frequency, +**Type:** Choice, +**Units:** , +**Required:** true, +**Model Dependent:** false + +### Environment Period +Environment Period for SQL query +**Name:** environment_period, +**Type:** String, +**Units:** , +**Required:** true, +**Model Dependent:** false + +### Norm of the difference of csv and sql +Norm of the difference of csv and sql. 1 is absolute value. 2 is euclidean distance. 3 is raw difference. +**Name:** norm, +**Type:** Double, +**Units:** , +**Required:** true, +**Model Dependent:** false + +### Scale factor to apply to the difference +Scale factor to apply to the difference (1 is no scale) +**Name:** scale, +**Type:** Double, +**Units:** , +**Required:** true, +**Model Dependent:** false + +### Find Available data in the SQL file +Will RegisterInfo all the 'EnvPeriod', 'ReportingFrequencies', 'VariableNames', 'KeyValues' in the SQL file. Useful for debugging SQL issues. +**Name:** find_avail, +**Type:** Boolean, +**Units:** , +**Required:** true, +**Model Dependent:** false + +### algorithm_download +Make JSON data available for algorithm_download (true/false) +**Name:** algorithm_download, +**Type:** Boolean, +**Units:** , +**Required:** true, +**Model Dependent:** false + +### plot_flag timeseries data +Create plot of timeseries data (true/false) +**Name:** plot_flag, +**Type:** Boolean, +**Units:** , +**Required:** true, +**Model Dependent:** false + +### Plot name +Name to include in reporting file name. +**Name:** plot_name, +**Type:** String, +**Units:** , +**Required:** true, +**Model Dependent:** false + +### verbose_messages +verbose messages. Useful for debugging but MAJOR Performance Hit. +**Name:** verbose_messages, +**Type:** Boolean, +**Units:** , +**Required:** true, +**Model Dependent:** false + +### warning_messages +Warn on missing data. +**Name:** warning_messages, +**Type:** Boolean, +**Units:** , +**Required:** true, +**Model Dependent:** false + +### add_first_zero_for_plots +Add a point of zero value to the plot at the beginning of the runperiod. +**Name:** add_first_zero_for_plots, +**Type:** Boolean, +**Units:** , +**Required:** true, +**Model Dependent:** false + +### add_last_zero_for_plots +Add a point of zero value to the plot at the end of the runperiod. +**Name:** add_last_zero_for_plots, +**Type:** Boolean, +**Units:** , +**Required:** true, +**Model Dependent:** false + + ## Outputs