translate

ladybug translate

Commands for translating between various file types.

ladybug translate [OPTIONS] COMMAND [ARGS]...

epw-to-ddy

Get a DDY file with a heating + cooling design day from this EPW.

This command will first check if there is a heating or cooling design day that meets the input percentile within the EPW itself. If None is found, the heating and cooling design days will be derived from analysis of the annual data within the EPW, which is usually less accurate.

Args:

epw_file: Path to an .epw file.

ladybug translate epw-to-ddy [OPTIONS] EPW_FILE

Options

-p, --percentile <percentile>

A number between 0 and 50 for the percentile difference from the most extreme conditions within the EPW to be used for the design day. Typical values are 0.4 and 1.0.

Default:

0.4

-f, --output-file <output_file>

Optional .wea file path to output the Wea string of the translation. By default this will be printed out to stdout

Arguments

EPW_FILE

Required argument

epw-to-wea

Translate an .epw file to a .wea file.

Args:

epw_file: Path to an .epw file.

ladybug translate epw-to-wea [OPTIONS] EPW_FILE

Options

-ap, --analysis-period <analysis_period>

An AnalysisPeriod string to filter the datetimes in the resulting Wea (eg. “6/21 to 9/21 between 8 and 16 @1”). If unspecified, the Wea will be annual.

-t, --timestep <timestep>

An optional integer to set the number of time steps per hour. Default is 1 for one value per hour. Note that this input will only do a linear interpolation over the data in the EPW file.

Default:

1

-f, --output-file <output_file>

Optional .wea file path to output the Wea string of the translation. By default this will be printed out to stdout

Arguments

EPW_FILE

Required argument

wea-to-constant

Convert a Wea or an EPW file to have a constant value for each datetime.

This is useful in workflows where hourly irradiance values are inconsequential to the analysis and one is only using the Wea as a format to pass location and datetime information (eg. for direct sun hours).

Args:

wea_file: Full path to .wea file. This can also be an .epw file.

ladybug translate wea-to-constant [OPTIONS] WEA_FILE

Options

-v, --value <value>

The direct and diffuse irradiance value that will be written in for all datetimes of the Wea.

Default:

1000

-f, --output-file <output_file>

Optional .wea file path to output the Wea string of the translation. By default this will be printed out to stdout

Arguments

WEA_FILE

Required argument