edit¶
honeybee-energy edit¶
Commands for editing model energy properties.
honeybee-energy edit [OPTIONS] COMMAND [ARGS]...
lighting-from-daylight¶
Assign HB-energy lighting schedules using Radiance annual-daylight results.
Note that the honeybee-radiance extension must be installed in order for this command to be run successfully.
Also note that the Honeybee model must have sensor grids with room_identifiers assigned to them for them to affect the HB-Energy lighting schedules. If such grids are found, the lighting schedules of the Rooms will be adjusted according to whether the illuminance values at the sensor locations are at a target illuminance setpoint.
Each grid should have sensors at the locations in space where daylight dimming sensors are located. Grids with two or more sensors can be used to model setups where fractions of each room are controlled by different sensors. If the sensor grids are distributed over the entire floor of the rooms, the resulting schedules will be idealized, where light dimming has been optimized to supply the minimum illuminance setpoint everywhere in the room.
honeybee-energy edit lighting-from-daylight [OPTIONS] MODEL_FILE
DAYLIGHT_FOLDER
Options
- -i, --ill-setpoint <ill_setpoint>¶
A number for the illuminance setpoint in lux beyond which electric lights are dimmed if there is sufficient daylight.
- Default:
300
- -p, --min-power-in <min_power_in>¶
A number between 0 and 1 for the the lowest power the lighting system can dim down to, expressed as a fraction of maximum input power.
- Default:
0.3
- -l, --min-light-out <min_light_out>¶
A number between 0 and 1 the lowest lighting output the lighting system can dim down to, expressed as a fraction of maximum light output. Note that setting this to 1 means lights are not dimmed at all until the illuminance setpoint is reached. This can be used to approximate manual light-switching behavior when used in conjunction with the off_at_min_ output below.
- Default:
0.2
- --on-at-min, -oam, --off-at-min¶
Flag to note whether lights should switch off completely when they get to the minimum power input.
- Default:
True
- -f, --output-file <output_file>¶
Optional hbjson file to output the JSON string of the converted model. By default this will be printed out to stdout
- Default:
'-'
Arguments
- MODEL_FILE¶
Required argument
- DAYLIGHT_FOLDER¶
Required argument
modifiers-from-constructions¶
Assign honeybee Radiance modifiers based on energy construction properties.
Note that the honeybee-radiance extension must be installed in order for this command to be run successfully.
Also note that setting the –exterior-offset to a non-zero value will add the offset faces as orphaned faces, which changes how the model simulates in EnergyPlus.
honeybee-energy edit modifiers-from-constructions [OPTIONS] MODEL_FILE
Options
- --solar, -v, --visible¶
Flag to note whether the assigned radiance modifiers should follow the solar properties of the constructions or the visible properties.
- --dynamic-groups, -sg, --static-groups¶
Flag to note whether dynamic window constructions and shaded window constructions should be translated to dynamic aperture groups or just the static (bare) construction should be used.
- --dynamic-shade, -ss, --static-shade¶
Flag to note whether dynamic shade transmittance schedules should be translated to dynamic shade groups or just a static, fully-opaque construction should be used.
- -o, --exterior-offset <exterior_offset>¶
A number for the distance at which the exterior Room faces should be offset in meters. This is used to account for the fact that the exterior material layer of the construction usually needs a different modifier from the interior. If set to 0, no offset will occur and all assigned modifiers will be interior.
- Default:
0
- -f, --output-file <output_file>¶
Optional hbjson file to output the JSON string of the converted model. By default this will be printed out to stdout
- Default:
'-'
Arguments
- MODEL_FILE¶
Required argument
reset-resource-ids¶
Reset the identifiers of resource objects in a Model file.
This is useful when human-readable names are needed when the model is exported to other formats like IDF and OSM and the uniqueness of the identifiers is less of a concern.
honeybee-energy edit reset-resource-ids [OPTIONS] MODEL_FILE
Options
- --by-name, -uuid, --by-name-and-uuid¶
Flag to note whether newly-generated resource object IDs should be derived only from a cleaned display_name or whether this new ID should also have a unique set of 8 characters appended to it to guarantee uniqueness.
- --reset-materials, -m, --keep-materials¶
Flag to note whether the IDs of all materials in the model should be reset.
- Default:
True
- --reset-constructions, -c, --keep-constructions¶
Flag to note whether the IDs of all constructions in the model should be reset.
- Default:
True
- --reset-construction-sets, -cs, --keep-construction-sets¶
Flag to note whether the IDs of all construction sets in the model should be reset.
- Default:
True
- --reset-schedules, -s, --keep-schedules¶
Flag to note whether the IDs of all schedules in the model should be reset.
- Default:
True
- --reset-programs, -p, --keep-programs¶
Flag to note whether the IDs of all programs in the model should be reset. This will also include resetting the IDs of all load objects in the program.
- Default:
True
- -f, --output-file <output_file>¶
Optional hbjson file to output the JSON string of the converted model. By default this will be printed out to stdout
- Default:
'-'
Arguments
- MODEL_FILE¶
Required argument