baseline

honeybee-energy baseline

Commands for creating baseline buildings conforming to standards.

honeybee-energy baseline [OPTIONS] COMMAND [ARGS]...

constructions-2004

Convert a Model’s constructions to be conformant with ASHRAE 90.1-2004 appendix G.

This includes assigning a ConstructionSet that is compliant with Table 5.5 to all rooms in the model.

Args:
model_json: Full path to a Model JSON file.
climate_zone: Text indicating the ASHRAE climate zone. This can be a single
integer (in which case it is interpreted as A) or it can include the
A, B, or C qualifier (eg. 3C).
honeybee-energy baseline constructions-2004 [OPTIONS] MODEL_JSON CLIMATE_ZONE

Options

-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_JSON

Required argument

CLIMATE_ZONE

Required argument

geometry-2004

Convert a Model’s geometry to be conformant with ASHRAE 90.1-2004 appendix G.

This includes stripping out all attached shades (leaving detached shade as context), reducing the vertical glazing ratio to 40% it it’s above this value, and reducing the skylight ratio to 5% of it’s above this value.

Args:
model_json: Full path to a Model JSON file.
honeybee-energy baseline geometry-2004 [OPTIONS] MODEL_JSON

Options

-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_JSON

Required argument

hvac-2004

Convert a Model’s HVAC to be conformant with ASHRAE 90.1-2004 appendix G.

This includes the selection of the correct Appendix G template HVAC based on the inputs and the application of this HVAC to all conditioned spaces in the model.

Args:
model_json: Full path to a Model JSON file.
climate_zone: Text indicating the ASHRAE climate zone. This can be a single
integer (in which case it is interpreted as A) or it can include the
A, B, or C qualifier (eg. 3C).
honeybee-energy baseline hvac-2004 [OPTIONS] MODEL_JSON CLIMATE_ZONE

Options

--nonresidential, -r, --residential

Flag to note whether the model represents a residential or nonresidential building.

Default

True

--fuel, -e, --electric

Flag to note whether the available energy source is fossil fuel based or all-electric.

Default

True

-a, --floor-area <floor_area>

A number for the floor area of the building that the model is a part of in m2. If None, the model floor area will be used.

Default

0

-s, --story-count <story_count>

An integer for the number of stories of the building that the model is a part of. If None, the model stories will be used.

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_JSON

Required argument

CLIMATE_ZONE

Required argument

lighting-2004

Convert a Model’s lighting to be conformant with ASHRAE 90.1-2004 appendix G.

This includes determining whether an ASHRAE 2004 equivalent exists for each program type in the model. If none is found, the baseline_watts_per_area on the room’s program’s lighting will be used, which will default to a typical office if none has been specified.

Args:
model_json: Full path to a Model JSON file.
honeybee-energy baseline lighting-2004 [OPTIONS] MODEL_JSON

Options

-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_JSON

Required argument

remove-ecms

Remove energy conservation strategies (ECMs) not associated with baseline models.

This includes removing the opening behavior of all operable windows, daylight controls, etc.

Args:
model_json: Full path to a Model JSON file.
honeybee-energy baseline remove-ecms [OPTIONS] MODEL_JSON

Options

-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_JSON

Required argument