You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This guide is intended to assist users who wish to update to LDAR-Sim V4 by providing instructions on transferring as much of the existing V3 parameters to V4 format. Do note that new behavior has been introduced in V4 and some existing behavior has been changed, thus, it is impossible to transfer all parameter files and inputs.
What changed between V3 and V4
The majority of the LDAR-Sim parameters from V3 still exist in V4, but many of them have been renamed or reworked. Some parameters have been removed entirely. There are many new input files users can provide to define the modelled infrastructure in more granularity and previously existing input files have mostly been removed or reworked.
Guidance on moving from V3 to V4
When moving from V3 to V4, it is advised to read the updated user manual to get an initial understanding of the scope of all the changes that have occurred. Users will need to make new input files in order to run V4 simulations: Critically users will need a sites file and the new emissions file to run any simulations. Many parameters have been changed or renamed. Reference the Parameter File Changes section for more detailed information. It may be easier for users to attempt to parameterize the V4 parameters while referencing the user manual for aid instead of attempting to "migrate" V3 simulation parameters.
No new parameters were introduced in simulation settings.
Virtual World
Virtual World: Renamed Parameters
V3 Parameter
V4 Parameter
Notes
infrastructure_file
infrastructure: sites_file
The infrastructure_file is now just one of the files that define the virtual world. See the user_manual on new infrastructure parameters in the virtual world for more information
repair_delay
repairs: delay
repair_delay was moved under the repairs heading and renamed to delay
Not quite just a rename, but the functionality is very similar. See the relevant section in the user manual for more details.
NRD
emissions: repairable_emissions: duration
Not quite just a rename, but the functionality is very similar. See the relevant section in the user manual for more details.
Virtual World: Removed Parameters
V3 Parameter
Notes
weather_is_hourly
Weather functionality has been streamlined
emissions: consider_venting
Emissions granularity has been reworked. See emissions section and all emissions relating parameters in the user manual for more information
emissions: leak_dist_params
Effectively moved this functionality into the emissions file
emissions: leak_dist_type
Effectively moved this functionality into the emissions file
leak_file
Effectively moved this functionality into the emissions file
emissions: leak_file_use
Fit functionality has been removed. This is to avoid scenarios where emissions rates an incorrectly fit to a lognormal distribution when the data is not lognormal
emissions: max_leak_rate
Effectively moved this functionality into the emissions file
emissions: units
Effectively moved this functionality into the emissions file
n_init_leaks_prob
Removed. To be reintroduced in later updates as needed
n_init_days
Removed. To be reintroduced in later updates as needed
Note there are now two default method parameter files: One for mobile deployment_type methods and one for stationary deployment_type methods. See method parameters in the user manual for more details.
Methods: Changes To Existing Parameters
V3 Parameter
Notes
parameter_level
The default value for parameter_level for method parameters has been changed from method to methods
Methods: Renamed Parameters
V3 Parameter
V4 Parameter
Notes
label
method_name
sensor: MDL
sensor: minimum_detection_limit
n_crews
crew_count
RS
surveys_per_year
time
survey_time
t_bt_sites
time_between_sites
weather_envs
weather_envelopes
weather_envs: precip
weather_envelopes: precipitation
weather_envs: temp
weather_envelopes: temperature
weather_envs: wind
weather_envelopes: wind
Methods: Removed Parameters
V3 Parameter
Notes
sensor: QE
Replaced with quantification_error heading, under which are new quantification error parameters.
mod_loc
Removed as with new object oriented structure type can support this when new sensor types are properly implemented
cost: per_hour
Removed as it was misleading, LDAR-SIm functions on a day timescale
scheduling: LDAR_crew_init_location
Removed all routing parameters as it was not fully functional
scheduling: home_base-files
Removed all routing parameters as it was not fully functional
scheduling: travel_speeds
Removed all routing parameters as it was not fully functional
scheduling: min_time_bt_surveys
New scheduling algorithm uses queue based scheduling, removing the need for this parameter
stationary methods only. See relevant section in the user manual
rolling_average : large_window
stationary methods only. See relevant section in the user manual
rolling_average : small_window_threshold
stationary methods only. See relevant section in the user manual
rolling_average : large_window_threshold
stationary methods only. See relevant section in the user manual
Input Files
Unchanged Input Files
The weather file has remained unchanged from V3 to V4.
Infrastructure
A new, much more granular infrastructure design has been introduced. See infrastructure and virtual world defining files sections in the user manual for more information.
Emissions File (New to V4)
New to V4 is a new file called the Emissions Fie. This file is mandatory to run any V4 simulations. Read more about it in the User Manual here. It must be set in the virtual world parameters, see the relevant section here.