3.1
merge_spaces_from_external_file
e439a1a9-d075-4a25-9f83-2dca79d2826e
71ac22f4-54ee-4480-ba2e-56e6c36d696f
2024-05-20T07:54:35Z
D8922A73
MergeSpacesFromExternalFile
Merge Spaces from External File
The measure lets you merge the contents from spaces in an external file into spaces in your current model. Spaces are identifed by the space name being the same in the two models. If a space is in the current model but not the external model they will be deleted. If a space is in both models the selecd elments willl be udpated based on the external model. If a space is not in the current model but is in the external model it will be cloned into the current model.
A string argument is used to identify the external model that is being merged into the current model. user agrument determine which kind of objets are brought over from the external model. Some characteristics that can be merged are surfaces, shading surface groups, interior partition groups, daylight controls, and internal loads. Additionally thermal zone, space space type, building story, construction set, and schedule set assignments names will can taken from the space, but objets they represent won't be cloned if objects by that name already exist in the current model.
external_model_name
External OSM File Name
Name of the model to merge into current model. This is the filename with the extension (e.g. MyModel.osm). Optionally this can inclucde the full file path, but for most use cases should just be file name.
String
true
false
merge_geometry
Merge Geometry from External Model
Replace geometry in current model with geometry from external model.
Boolean
true
false
true
true
true
false
false
merge_loads
Merge Internal Loads from External Model
Replace internal loads directly assigned so spaces in current model with internal loads directly assigned to spaces frp, external model. If a schedule is hard assigned to a load instance, it will be brought over as well.
Boolean
true
false
true
true
true
false
false
merge_attribute_names
Merge Space Attribute names from External Model
Replace space attribute names in current model with space attribute names from external models. When external model has unkown attribute name that object will be cloned into the current model.
Boolean
true
false
true
true
true
false
false
add_spaces
Add Spaces to Current Model
Add spaces to current model that exist in external model but do not exist in current model.
Boolean
true
false
true
true
true
false
false
remove_spaces
Remove Spaces from Current Model
Remove spaces from current model that do not exist in externa model.
Boolean
true
false
true
true
true
false
false
merge_schedules
Merge Schedules from External Model
This isn't limited to spaces, this will replace any scheules in the current model with schedules of the same name in the external model. It will not replace schedule named 'a' from an internal load in th emodel with a schedule named 'b' from an internal load by that same name in the external model, to perform that task currently, you must merge loads.
Boolean
true
false
true
true
true
false
false
compact_to_ruleset
Convert Merged Schedule Compact objects to Schedule Ruleset.
Will convert any imported schedules to Schedule Ruleset instead of Schedule Compact and will connect them to objects that had previously refered to the Schedule Compact object.
Boolean
true
false
true
true
true
false
false
Whole Building.Space Types
Measure Type
ModelMeasure
string
Intended Software Tool
Apply Measure Now
string
Intended Software Tool
OpenStudio Application
string
Intended Software Tool
Parametric Analysis Tool
string
LICENSE.md
md
license
BFFB1AA6
README.md
md
readme
90DBF164
README.md.erb
erb
readmeerb
703C9964
OpenStudio
2.0.4
3.8.0
measure.rb
rb
script
C7B7CC3E
ScheduleTranslator.rb
rb
resource
8EB6C501
current_model_test.osm
osm
test
2F818B1A
external_model_test.osm
osm
test
637A1436
measure_test.osw
osw
test
F5FABCCF
merge_spaces_from_external_file_test.rb
rb
test
3C0F04D5