def solve_adjacency(model_json, surface, no_intersect, output_file):
"""Solve adjacency between Room2Ds of a Model JSON file.
This involves setting Surface or Adiabatic boundary conditions for all matching
segments across each Story.
\b
If the --intersect option is selected, this will involve involve the following.
1. Remove colinear vertices from the Room2D polygons.
2. Intersect adjacent segments of the same Story with one another.
Note that the --intersect option removes all existing boundary_conditions,
window_parameters, and shading_parameters.
\b
Args:
model_json: Full path to a Model JSON file.
"""
try:
# serialize the Model and check tolerance
parsed_model = Model.from_file(model_json)
assert parsed_model.tolerance != 0, \
'Model must have a non-zero tolerance to use solve-adjacency.'
tol = parsed_model.tolerance
# intersect adjacencies if requested
if not no_intersect:
for bldg in parsed_model.buildings:
for story in bldg.unique_stories:
story.remove_room_2d_colinear_vertices(tol)
story.intersect_room_2d_adjacency(tol)
# solve the adjacency of each story
for bldg in parsed_model.buildings:
for story in bldg.unique_stories:
adj_info = story.solve_room_2d_adjacency(tol)
if not surface and ad_bc:
for face_pair in adj_info:
face_pair[0][0].set_boundary_condition(
face_pair[0][1], ad_bc)
face_pair[1][0].set_boundary_condition(
face_pair[1][1], ad_bc)
# write the new model out to the file or stdout
output_file.write(json.dumps(parsed_model.to_dict()))
except Exception as e:
_logger.exception('Model solve adjacency failed.\n{}'.format(e))
sys.exit(1)
else:
sys.exit(0)
def windows_by_ratio(model_json, ratio, output_file):
"""Add windows to all outdoor walls of a model given a ratio.
Note that this method removes any existing WindowParameters.
\b
Args:
model_json: Full path to a Dragonfly DFJSON or DFpkl file.
ratio: A number between 0 and 1 (but not perfectly equal to 1) for the
desired ratio between window area and wall area. If multiple values
are input here, different WindowParameters will be assigned based on
cardinal direction, starting with north and moving clockwise.
"""
try:
# serialize the Model and convert ratios to window parameters
model = Model.from_file(model_json)
win_par = [SimpleWindowRatio(rat) for rat in ratio]
# add the window parameters
if len(win_par) == 1: # one window parameter for all
model.set_outdoor_window_parameters(win_par[0])
else: # different window parameters by cardinal direction
angles = angles_from_num_orient(len(win_par))
rooms = [
room for bldg in model.buildings
for room in bldg.unique_room_2ds
]
for rm in rooms:
room_win_par = []
for bc, orient in zip(rm.boundary_conditions,
rm.segment_orientations()):
orient_i = orient_index(orient, angles)
win_p = win_par[orient_i] if isinstance(bc,
Outdoors) else None
room_win_par.append(win_p)
rm.window_parameters = room_win_par
# write the new model out to the file or stdout
output_file.write(json.dumps(model.to_dict()))
except Exception as e:
_logger.exception('Model windows by ratio failed.\n{}'.format(e))
sys.exit(1)
else:
sys.exit(0)
def convert_units(model_json, units, scale, output_file):
"""Convert a Model to a given units system.
\b
Args:
model_json: Full path to a Model JSON file.
units: Text for the units system to which the model will be converted.
Choose from (Meters, Millimeters, Feet, Inches, Centimeters).
"""
try:
# serialize the Model and convert the units
parsed_model = Model.from_file(model_json)
if scale:
parsed_model.convert_to_units(units)
else:
parsed_model.units = units
# write the new model out to the file or stdout
output_file.write(json.dumps(parsed_model.to_dict()))
except Exception as e:
_logger.exception('Model unit conversion failed.\n{}'.format(e))
sys.exit(1)
else:
sys.exit(0)