honeybee_radiance.lightsource.ground module

Radiance ground.

Ground is usually used as part of the sky definition.

class honeybee_radiance.lightsource.ground.Ground(modifier='skyfunc')

Bases: object

Radiance ground.

Ground definition relies on skyfunc and must be used with one of the Radiance skies generated by gendaylit, gensky, etc. You can adjust the ground reflection using -g option in gensky / gendaylit. The default value in gensky is %20.

skyfunc glow ground_glow
0
0
4 1 1 1 0
ground_glow source ground
0
0
4 0 0 -1 180

oconv some.sky ground.rad scene.rad > scene.oct

Note

For more information see Chapter 6.3.4 The Ground “Glow”: An “Upside-Down” Sky in Rendering with Radiance. The chapter is also accessible online at the

link below. https://www.radiance-online.org/community/workshops/2003-berkeley/presentations/Mardaljevic/rwr_ch6.pdf

Properties:

• r_emittance

• g_emittance

• b_emittance

• modifier

classmethod from_dict(input_dict)

Create ground from_dict.

Parameters:

input_dict – A python dictionary in the following format

{
'type': 'Ground',
'r_emittance': r_emittance,
'g_emittance': g_emittance,
'b_emittance': b_emittance,
'modifier': modifier
}

to_dict()

Translate ground to a dictionary.

to_file(folder='.', name=None, mkdir=False)

Write ground to a .ground Radiance file.

Returns:

Full path to the newly created file.

to_radiance()

Get ground as a Radiance input string.

property b_emittance

1.0).

Type:

Ground emittance values for blue channel (Default

property g_emittance

1.0).

Type:

Ground emittance values for green channel (Default

property modifier

Ground modifier.

property r_emittance

1.0).

Type:

Ground emittance values for red channel (Default