main

honeybee-radiance-postprocess

honeybee radiance postprocess commands.

honeybee-radiance-postprocess [OPTIONS] COMMAND [ARGS]...

Options

--version

Show the version and exit.

grid

Commands for generating and modifying sensor grids.

honeybee-radiance-postprocess grid [OPTIONS] COMMAND [ARGS]...

merge-folder

Restructure files in a distributed folder.

Args:
input_folder: Path to input folder.
output_folder: Path to the new restructured folder
extension: Extension of the files to collect data from. It will be pts for
sensor files. Another common extension is ill for the results of daylight
studies.
honeybee-radiance-postprocess grid merge-folder [OPTIONS] INPUT_FOLDER
                                                OUTPUT_FOLDER EXTENSION

Options

-di, --dist-info <dist_info>

An optional input for distribution information to put the grids back together . Alternatively, the command will look for a _redist_info.json file inside the folder.

-oe, --output-extension <output_extension>

Output file extension. This is only used if as_text is set to True. Otherwise the output extension will be npy.

-at, --as-text <as_text>

Set to True if the output files should be saved as text instead of NumPy files.

--fmt <fmt>

Format for the output files when saved as text.

--delimiter <delimiter>

Delimiter for the output files when saved as text.

Options

space | tab

Arguments

INPUT_FOLDER

Required argument

OUTPUT_FOLDER

Required argument

EXTENSION

Required argument

merge-folder-metrics

Restructure annual daylight metrics in a distributed folder.

Since this command redistributes metrics it is expected that the input folder has sub folder

Args:
input_folder: Path to input folder.
output_folder: Path to the new restructured folder
honeybee-radiance-postprocess grid merge-folder-metrics [OPTIONS] INPUT_FOLDER
                                                        OUTPUT_FOLDER

Options

-di, --dist-info <dist_info>

An optional input for distribution information to put the grids back together . Alternatively, the command will look for a _redist_info.json file inside the folder.

-gi, --grids-info <grids_info>

An optional input for grid information that will be copied to each metric folder. This file is usually called grids_info.json.

Arguments

INPUT_FOLDER

Required argument

OUTPUT_FOLDER

Required argument

mtxop

Commands to work with Radiance matrices using NumPy.

honeybee-radiance-postprocess mtxop [OPTIONS] COMMAND [ARGS]...

operate-three

Operations between three Radiance matrices.

The input matrices must be Radiance binary matrices. The operations will be performed elementwise for the matrices.

Args:
first-mtx: Path to fist matrix.
second-mtx: Path to second matrix.
third-mtx: Path to third matrix.
honeybee-radiance-postprocess mtxop operate-three [OPTIONS] FIRST_MTX
                                                  SECOND_MTX THIRD_MTX

Options

--operator-one <operator_one>

Operation between the two matrices.

Options
  • - | / | *
--operator-two <operator_two>

Operation between the two matrices.

Options
  • - | / | *
--conversion <conversion>

Conversion as a string. This option is useful to post-process the results from 3 RGB components into one as part of this command.

--binary, --ascii

Switch between binary and ascii input matrices. Default is binary.

-n, --name <name>

Output file name.

Default

output

-of, --output-folder <output_folder>

Output folder.

Arguments

FIRST_MTX

Required argument

SECOND_MTX

Required argument

THIRD_MTX

Required argument

operate-two

Operations between two Radiance matrices.

The input matrices must be Radiance binary matrices. The operations will be performed elementwise for the matrices.

Args:
first-mtx: Path to fist matrix.
second-mtx: Path to second matrix.
honeybee-radiance-postprocess mtxop operate-two [OPTIONS] FIRST_MTX SECOND_MTX

Options

--operator <operator>

Operation between the two matrices.

Options
  • - | / | *
--conversion <conversion>

Conversion as a string. This option is useful to post-process the results from 3 RGB components into one as part of this command.

--binary, --ascii

Switch between binary and ascii input matrices. Default is binary.

-n, --name <name>

Output file name.

Default

output

-of, --output-folder <output_folder>

Output folder.

Arguments

FIRST_MTX

Required argument

SECOND_MTX

Required argument

post-process

Commands to post-process Radiance results.

honeybee-radiance-postprocess post-process [OPTIONS] COMMAND [ARGS]...

annual-daylight

Compute annual metrics in a folder and write them in a subfolder.

This command generates 5 files for each input grid.
da/{grid-name}.da -> Daylight Autonomy
cda/{grid-name}.cda -> Continuos Daylight Autonomy
udi/{grid-name}.udi -> Useful Daylight Illuminance
udi_lower/{grid-name}_upper.udi -> Upper Useful Daylight Illuminance
udi_upper/{grid-name}_lower.udi -> Lower Useful Daylight Illuminance
Args:
folder: Results folder. This folder is an output folder of annual
daylight recipe. Folder should include grids_info.json and
sun-up-hours.txt.
honeybee-radiance-postprocess post-process annual-daylight 
    [OPTIONS] FOLDER

Options

-sch, --schedule <schedule>

Path to an annual schedule file. Values should be 0-1 separated by new line. If not provided an 8-5 annual schedule will be created.

-t, --threshold <threshold>

Threshold illuminance level for daylight autonomy.

Default

300

-lt, --lower-threshold <lower_threshold>

Minimum threshold for useful daylight illuminance.

Default

100

-ut, --upper-threshold <upper_threshold>

Maximum threshold for useful daylight illuminance.

Default

3000

-st, --states <states>

A JSON file with a dictionary of states. If states are not provided the default states will be used for any aperture groups.

-gf, --grids-filter <grids_filter>

A pattern to filter the grids.

Default

*

-sf, --sub-folder <sub_folder>

Optional relative path for subfolder to write output metric files.

Arguments

FOLDER

Required argument

annual-daylight-en17037

Compute annual EN 17037 metrics in a folder and write them in a subfolder.

This command generates multiple files for each input grid. Files for target
illuminance and minimum illuminance will be calculated for three levels of
recommendation: minimum, medium, high.
Args:
folder: Results folder. This folder is an output folder of annual
daylight recipe. Folder should include grids_info.json and
sun-up-hours.txt.
schedule: Path to an annual schedule file. Values should be 0-1
separated by new line. This should be a daylight hours schedule.
honeybee-radiance-postprocess post-process annual-daylight-en17037 
    [OPTIONS] FOLDER SCHEDULE

Options

-st, --states <states>

A JSON file with a dictionary of states. If states are not provided the default states will be used for any aperture groups.

-gf, --grids-filter <grids_filter>

A pattern to filter the grids.

Default

*

-sf, --sub_folder <sub_folder>

Optional relative path for subfolder to write output metric files.

Arguments

FOLDER

Required argument

SCHEDULE

Required argument

annual-daylight-file

Compute annual metrics for a single file and write the metrics in a subfolder.

This command generates 5 files for each input grid.
da/{grid-name}.da -> Daylight Autonomy
cda/{grid-name}.cda -> Continuos Daylight Autonomy
udi/{grid-name}.udi -> Useful Daylight Illuminance
udi_lower/{grid-name}_upper.udi -> Upper Useful Daylight Illuminance
udi_upper/{grid-name}_lower.udi -> Lower Useful Daylight Illuminance
Args:
file: Annual illuminance file. This can be either a NumPy file or a
binary Radiance file.
sun_up_hours: A file with the sun up hours of the study.
honeybee-radiance-postprocess post-process annual-daylight-file 
    [OPTIONS] FILE SUN_UP_HOURS

Options

-sch, --schedule <schedule>

Path to an annual schedule file. Values should be 0-1 separated by new line. If not provided an 8-5 annual schedule will be created.

-t, --threshold <threshold>

Threshold illuminance level for daylight autonomy.

Default

300

-lt, --lower-threshold <lower_threshold>

Minimum threshold for useful daylight illuminance.

Default

100

-ut, --upper-threshold <upper_threshold>

Maximum threshold for useful daylight illuminance.

Default

3000

--study-info <study_info>

Optional study info file. This option is needed if the time step is larger than 1.

-gn, --grid-name <grid_name>

Optional name of each metric file.

-sf, --sub-folder <sub_folder>

Optional relative path for subfolder to write output metric files.

Arguments

FILE

Required argument

SUN_UP_HOURS

Required argument

annual-irradiance

Compute irradiance metrics in a folder and write them in a subfolder.

This command generates 3 files for each input grid.
average_irradiance/{grid-name}.res -> Average Irradiance (W/m2)
peak_irradiance/{grid-name}.res -> Peak Irradiance (W/m2)
cumulative_radiation/{grid-name}.res -> Cumulative Radiation (kWh/m2)
Args:
folder: Results folder. This folder is an output folder of annual
irradiance recipe. Folder should include grids_info.json and
sun-up-hours.txt.
honeybee-radiance-postprocess post-process annual-irradiance 
    [OPTIONS] FOLDER

Options

-sch, --schedule <schedule>

Path to an annual schedule file. Values should be 0-1 separated by new line. If not provided an 8-5 annual schedule will be created.

-st, --states <states>

A JSON file with a dictionary of states. If states are not provided the default states will be used for any aperture groups.

-gf, --grids-filter <grids_filter>

A pattern to filter the grids.

Default

*

-sf, --sub-folder <sub_folder>

Optional relative path for subfolder to write output metric files.

Arguments

FOLDER

Required argument

annual-sunlight-exposure

Compute annual sunlight exposure in a folder and write them in a subfolder.

This command generates 2 files for each input grid.
ase/{grid-name}.ase -> Annual Sunlight Exposure
hours_above/{grid-name}.hours -> Number of overlit hours for each sensor
Args:
folder: Results folder. This folder is an output folder of annual
daylight recipe. Folder should include grids_info.json and
sun-up-hours.txt.
honeybee-radiance-postprocess post-process annual-sunlight-exposure 
    [OPTIONS] FOLDER

Options

-sch, --schedule <schedule>

Path to an annual schedule file. Values should be 0-1 separated by new line. If not provided an 8-5 annual schedule will be created.

-dt, --direct-threshold <direct_threshold>

The threshold that determines if a sensor is overlit.

Default

1000

-oh, --occ_hours <occ_hours>

The number of occupied hours that cannot receive more than the direct_threshold.

Default

250

-st, --states <states>

A JSON file with a dictionary of states. If states are not provided the default states will be used for any aperture groups.

-gf, --grids-filter <grids_filter>

A pattern to filter the grids.

Default

*

-sf, --sub-folder <sub_folder>

Optional relative path for subfolder to write output metric files.

Arguments

FOLDER

Required argument

annual-to-data

Get annual data collections as JSON files.

Args:
folder: Results folder. This folder is an output folder of annual daylight
recipe. Folder should include grids_info.json and sun-up-hours.txt. The
command uses the list in grids_info.json to find the result files for each
sensor grid.
honeybee-radiance-postprocess post-process annual-to-data [OPTIONS] FOLDER

Options

-st, --states <states>

A JSON file with a dictionary of states. If states are not provided the default states will be used for any aperture groups.

-gf, --grids-filter <grids_filter>

A pattern to filter the grids.

Default

*

-si, --sensor-index <sensor_index>

A JSON file with a dictionary of sensor indices for each grid. If not provided all sensors will be used.

--total, --direct

Switch between total and direct results. Default is total.

-f, --output-file <output_file>

Optional file to output the JSON strings of the data collections. By default, it will be printed to stdout

Default

-

Arguments

FOLDER

Required argument

annual-uniformity-ratio

Calculate annual uniformity ratio and write it to a folder.

Args:
folder: Results folder. This folder is an output folder of annual
daylight recipe. Folder should include grids_info.json and
sun-up-hours.txt.
honeybee-radiance-postprocess post-process annual-uniformity-ratio 
    [OPTIONS] FOLDER

Options

-sch, --schedule <schedule>

Path to an annual schedule file. Values should be 0-1 separated by new line. If not provided an 8-5 annual schedule will be created.

-t, --threshold <threshold>

A threshold for the uniformity ratio. Defaults to 0.5.

Default

0.5

-st, --states <states>

A JSON file with a dictionary of states. If states are not provided the default states will be used for any aperture groups.

-gf, --grids-filter <grids_filter>

A pattern to filter the grids.

Default

*

-sf, --sub-folder <sub_folder>

Optional relative path for subfolder to write annual uniformity ratio.

Arguments

FOLDER

Required argument

average-values

Get average values for each sensor over a given period.

Args:
folder: Results folder. This folder is an output folder of annual daylight
recipe. Folder should include grids_info.json and sun-up-hours.txt. The
command uses the list in grids_info.json to find the result files for each
sensor grid.
honeybee-radiance-postprocess post-process average-values [OPTIONS] FOLDER

Options

-h, --hoys-file <hoys_file>

Path to an HOYs file. Values must be separated by new line. If not provided the data will not be filtered by HOYs.

-st, --states <states>

A JSON file with a dictionary of states. If states are not provided the default states will be used for any aperture groups.

-gf, --grids-filter <grids_filter>

A pattern to filter the grids.

Default

*

--total, --direct

Switch between total and direct results. Default is total.

-sf, --sub-folder <sub_folder>

Optional relative path for subfolder to write output metric files.

Arguments

FOLDER

Required argument

convert-to-binary

Postprocess a Radiance matrix and convert it to 0-1 values.

This command is useful for translating Radiance results to outputs like
sunlight hours. Input matrix must be in ASCII or binary format. The input
Radiance file must have a header.
Args:

input-matrix: A Radiance matrix file.

honeybee-radiance-postprocess post-process convert-to-binary 
    [OPTIONS] INPUT_MATRIX

Options

--minimum <minimum>

Minimum range for values to be converted to 1.

--maximum <maximum>

Maximum range for values to be converted to 1.

--include-max, --exclude-max

A flag to include the maximum threshold itself. By default the threshold value will be included.

--include-min, --exclude-min

A flag to include the minimum threshold itself. By default the threshold value will be included.

--comply, --reverse

A flag to reverse the selection logic. This is useful for cases that you want to all the values outside a certain range to be converted to 1. By default the input logic will be used as is.

-n, --name <name>

Name of output file.

Default

binary

-of, --output-folder <output_folder>

Output folder.

Arguments

INPUT_MATRIX

Required argument

cumulative-values

Get cumulative values for each sensor over a given period.

Args:
folder: Results folder. This folder is an output folder of annual daylight
recipe. Folder should include grids_info.json and sun-up-hours.txt. The
command uses the list in grids_info.json to find the result files for each
sensor grid.
honeybee-radiance-postprocess post-process cumulative-values 
    [OPTIONS] FOLDER

Options

-h, --hoys-file <hoys_file>

Path to an HOYs file. Values must be separated by new line. If not provided the data will not be filtered by HOYs.

-st, --states <states>

A JSON file with a dictionary of states. If states are not provided the default states will be used for any aperture groups.

-gf, --grids-filter <grids_filter>

A pattern to filter the grids.

Default

*

--total, --direct

Switch between total and direct results. Default is total.

-sf, --sub-folder <sub_folder>

Optional relative path for subfolder to write output metric files.

Arguments

FOLDER

Required argument

direct-sun-hours

Post-process a Radiance matrix to direct sun hours and cumulative direct sun hours.

This command will convert values in the Radiance matrix file to 0-1 values.
The output will be a direct sun hours file, and a cumulative direct sun hours
file where the values are the summed values for each row.
Args:

input-matrix: A Radiance matrix file.

honeybee-radiance-postprocess post-process direct-sun-hours 
    [OPTIONS] INPUT_MATRIX

Options

--divisor <divisor>

An optional number, that the summed row will be divided by. For example, this can be a timestep, which can be used to ensure that a summed row of irradiance yields cumulative radiation over the entire time period of the matrix.

-of, --output-folder <output_folder>

Output folder.

Arguments

INPUT_MATRIX

Required argument

grid-summary

Calculate a grid summary.

Args:
folder: A folder with results.
honeybee-radiance-postprocess post-process grid-summary [OPTIONS] FOLDER

Options

-m, --model <model>

An optional HBJSON model file. This will be used to find the area of the grids. The area is used when calculating percentages of floor area.

-gi, --grids-info <grids_info>

An optional JSON file with grid information. If no file is provided the command will look for a file in the folder.

-n, --name <name>

Optional filename of grid summary.

Default

grid_summary

-gm, --grid-metrics <grid_metrics>

An optional JSON file with additional custom metrics to calculate.

--sub-folder, --main-folder

If sub-folder is selected it will look for any sub-folders in the folder argument. If main-folder is selected it will look for result files in the folder argument.

Arguments

FOLDER

Required argument

leed

Commands for LEED post-processing of Radiance results.

honeybee-radiance-postprocess post-process leed [OPTIONS] COMMAND [ARGS]...
daylight-option-one

Calculate credits for LEED v4.1 Daylight Option 1.

Use the shade-transmittance option to set a shade transmittance values for aperture groups. The shade-transmittance-file option takes precedence over the shade-transmittance, however, if any aperture groups are missing in the JSON file given to the shade-transmittance-file option, the value from shade-transmittance will be used for those aperture groups.

Args:
folder: Results folder. This folder is an output folder of annual daylight
recipe. The daylight simulation must include aperture groups.
honeybee-radiance-postprocess post-process leed daylight-option-one 
    [OPTIONS] FOLDER

Options

-gf, --grids-filter <grids_filter>

A pattern to filter the grids.

Default

*

-st, --shade-transmittance <shade_transmittance>

A value to use as a multiplier in place of solar shading. Value for shade transmittance must be 1 > value > 0.

Default

0.05

-stf, --shade-transmittance-file <shade_transmittance_file>

A JSON file with a dictionary where aperture groups are keys, and the value for each key is the shade transmittance. Values for shade transmittance must be 1 > value > 0. If any aperture groups are missing in the JSON file, its shade transmittance value will be set to the value of the shade transmittance option (0.05 by default).

-sf, --sub-folder <sub_folder>

Relative path for subfolder to write output files.

Arguments

FOLDER

Required argument

median-values

Get median values for each sensor over a given period.

Args:
folder: Results folder. This folder is an output folder of annual daylight
recipe. Folder should include grids_info.json and sun-up-hours.txt. The
command uses the list in grids_info.json to find the result files for each
sensor grid.
honeybee-radiance-postprocess post-process median-values [OPTIONS] FOLDER

Options

-h, --hoys-file <hoys_file>

Path to an HOYs file. Values must be separated by new line. If not provided the data will not be filtered by HOYs.

-st, --states <states>

A JSON file with a dictionary of states. If states are not provided the default states will be used for any aperture groups.

-gf, --grids-filter <grids_filter>

A pattern to filter the grids.

Default

*

--total, --direct

Switch between total and direct results. Default is total.

-sf, --sub-folder <sub_folder>

Optional relative path for subfolder to write output metric files.

Arguments

FOLDER

Required argument

peak-values

Get peak values for each sensor over a given period.

Args:
folder: Results folder. This folder is an output folder of annual daylight
recipe. Folder should include grids_info.json and sun-up-hours.txt. The
command uses the list in grids_info.json to find the result files for each
sensor grid.
honeybee-radiance-postprocess post-process peak-values [OPTIONS] FOLDER

Options

-h, --hoys-file <hoys_file>

Path to an HOYs file. Values must be separated by new line. If not provided the data will not be filtered by HOYs.

-st, --states <states>

A JSON file with a dictionary of states. If states are not provided the default states will be used for any aperture groups.

-gf, --grids-filter <grids_filter>

A pattern to filter the grids.

Default

*

--total, --direct

Switch between total and direct results. Default is total.

--coincident, --non-coincident

Boolean to indicate whether output values represent the the peak value for each sensor throughout the entire analysis (False) or they represent the highest overall value across each sensor grid at a particular timestep (True).

Default

False

-sf, --sub-folder <sub_folder>

Optional relative path for subfolder to write output metric files.

Arguments

FOLDER

Required argument

point-in-time

Get point in time values.

Args:
folder: Results folder. This folder is an output folder of annual daylight
recipe. Folder should include grids_info.json and sun-up-hours.txt. The
command uses the list in grids_info.json to find the result files for each
sensor grid.
hoy: An HOY (point-in-time) for which to get the point-in-time values.
honeybee-radiance-postprocess post-process point-in-time [OPTIONS] FOLDER HOY

Options

-st, --states <states>

A JSON file with a dictionary of states. If states are not provided the default states will be used for any aperture groups.

-gf, --grids-filter <grids_filter>

A pattern to filter the grids.

Default

*

--total, --direct

Switch between total and direct results. Default is total.

-sf, --sub-folder <sub_folder>

Optional relative path for subfolder to write output metric files.

Arguments

FOLDER

Required argument

HOY

Required argument

two-phase

Commands to work with two phase Radiance matrices using NumPy.

honeybee-radiance-postprocess post-process two-phase [OPTIONS] COMMAND
                                                     [ARGS]...
add-remove-sky-matrix

Process results of two phase simulations (total, direct, direct sunlight).

The function will replace the direct values with the direct sunlight values: total - direct + direct_sunlight.

The function has two output files. One for the results of the above calculation, and one for the direct sunlight values.

Args:
total-mtx: Path to total matrix.
direct-mtx: Path to direct matrix.
direct-sunlight-mtx: Path to direct sunlight matrix.
honeybee-radiance-postprocess post-process two-phase add-remove-sky-matrix 
    [OPTIONS] TOTAL_MTX DIRECT_MTX DIRECT_SUNLIGHT_MTX

Options

--binary, --ascii

Switch between binary and ascii input matrices. Default is binary.

-n, --total-name <total_name>

Total output file name.

Default

total

-n, --direct-name <direct_name>

Direct output file name.

Default

direct

-of, --output-folder <output_folder>

Output folder.

Arguments

TOTAL_MTX

Required argument

DIRECT_MTX

Required argument

DIRECT_SUNLIGHT_MTX

Required argument

rgb-to-illuminance

Process results of two phase simulations (total, direct, direct sunlight).

The function will replace the direct illuminance with the direct sunlight illuminance: total - direct + direct_sunlight.

The function has two output files. One for the illuminance of the above calculation, and one for the direct sunlight illuminance. In both cases the conversion from RGB to illuminance is executed.

Args:
total-mtx: Path to total matrix.
direct-mtx: Path to direct matrix.
direct-sunlight-mtx: Path to direct sunlight matrix.
honeybee-radiance-postprocess post-process two-phase rgb-to-illuminance 
    [OPTIONS] TOTAL_MTX DIRECT_MTX DIRECT_SUNLIGHT_MTX

Options

--binary, --ascii

Switch between binary and ascii input matrices. Default is binary.

-n, --total-name <total_name>

Total output file name.

Default

total

-n, --direct-name <direct_name>

Direct output file name.

Default

direct

-of, --output-folder <output_folder>

Output folder.

Arguments

TOTAL_MTX

Required argument

DIRECT_MTX

Required argument

DIRECT_SUNLIGHT_MTX

Required argument

rgb-to-illuminance-file

Convert a RGB Radiance matrix to illuminance and save the array as a NumPy file.

Args:
mtx-file: Path to matrix file to convert.
honeybee-radiance-postprocess post-process two-phase rgb-to-illuminance-file 
    [OPTIONS] MTX_FILE

Options

--binary, --ascii

Switch between binary and ascii input matrices. Default is binary.

-n, --name <name>

Name of output file.

Default

illuminance

-of, --output-folder <output_folder>

Output folder.

Arguments

MTX_FILE

Required argument

schedule

Commands to create schedules for Radiance results.

honeybee-radiance-postprocess schedule [OPTIONS] COMMAND [ARGS]...

control-schedules

Generate electric lighting schedules from annual daylight results.

Args:
folder: Results folder. This folder is an output folder of annual daylight
recipe. Folder should include grids_info.json and sun-up-hours.txt. The
command uses the list in grids_info.json to find the result files for each
sensor grid.
honeybee-radiance-postprocess schedule control-schedules [OPTIONS] FOLDER

Options

-bs, --base-schedule-file <base_schedule_file>

Path to a schedule file. A list of 8760 fractional values for the lighting schedule representing the usage of lights without any daylight controls. The values of this schedule will be multiplied by the hourly dimming fraction to yield the output lighting schedules. If None, a schedule from 9AM to 5PM on weekdays will be used.

-st, --states <states>

A JSON file with a dictionary of states. If states are not provided the default states will be used for any aperture groups.

-gf, --grids-filter <grids_filter>

A pattern to filter the grids.

Default

*

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

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

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

Default

0.2

--off-at-min

Boolean to note whether lights should switch off completely when they get to the minimum power input.

-sf, --sub-folder <sub_folder>

Optional relative path for subfolder to write output schedule files.

Arguments

FOLDER

Required argument

translate

Commands to translate objects.

honeybee-radiance-postprocess translate [OPTIONS] COMMAND [ARGS]...

annual-daylight-npy-to-ill

Convert an annual daylight results folder to older version.

This command reads an annual daylight results folder with results saved as npy files (NumPy), and converts the npy files to text files in the old results folder format.

Args:
folder: Results folder. This folder is an output folder of annual
daylight recipe. Folder should include grids_info.json and
sun-up-hours.txt.
honeybee-radiance-postprocess translate annual-daylight-npy-to-ill 
    [OPTIONS] FOLDER

Options

-of, --output-folder <output_folder>

Output folder. If not provided the output folder will be created in the same directory as the results folder. The new folder will be called results_ill.

Arguments

FOLDER

Required argument

binary-to-npy

Convert a binary Radiance file to a npy file.

This command reads a binary Radiance matrix file and saves it as a NumPy file.

Args:
mtx-file: Path to binary Radiance file.
honeybee-radiance-postprocess translate binary-to-npy [OPTIONS] MTX_FILE

Options

--conversion <conversion>

Conversion as a string. This option is useful to post-process the results from 3 RGB components into one as part of this command.

-n, --name <name>

Output file name.

Default

output

-of, --output-folder <output_folder>

Output folder.

Arguments

MTX_FILE

Required argument

npy-to-txt

Convert a npy file to text file.

This command reads a NumPy array from a npy file and saves it as readable file. The converted file is tab separated.

Args:
npy-file: Path to npy file.
honeybee-radiance-postprocess translate npy-to-txt [OPTIONS] NPY_FILE

Options

-n, --name <name>

Output file name.

Default

output

-of, --output-folder <output_folder>

Output folder.

-ext, --extension <extension>

Output file extension

Default

.txt

-fmt, --output-format <output_format>

Output format for each element in the array

Default

%.7e

Arguments

NPY_FILE

Required argument

txt-to-npy

Convert a text file to npy file.

This command reads a space or tab separated text file saves it as a NumPy file. As an example the input file could be the annual illuminance values.

Args:
txt-file: Path to text file.
honeybee-radiance-postprocess translate txt-to-npy [OPTIONS] TXT_FILE

Options

-n, --name <name>

Output file name.

Default

output

-of, --output-folder <output_folder>

Output folder.

Arguments

TXT_FILE

Required argument