Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Create a point-in-time climate-based sky from a Wea.
north
A number between 0 and 360 that represents the degrees off from the y-axis to make North. This can also be a vector to set the North. Default is 0. The default North direction is the Y-axis (0 degrees).
wea [Required]
A Ladybug Wea object.
month
An integer between 1 and 12 for the month of the year (default: 6).
day
An integer between 1 and 31 for the day of the month (default: 21).
hour
A number between 0 and 23.999.. for the hour of the day (default: 12).
colored
Boolean to note whether the sky will be rendered in full color (True) or it will simple be a grey sky with the same average value as the colored sky (False). (Default: False).
sky
A Honeybee sky that can be used to create a point-in-time recipe.
-
Create a point-in-time standard Radiance CIE sky.
north
A number between 0 and 360 that represents the degrees off from the y-axis to make North. This can also be a vector to set the North. Default is 0. The default North direction is the Y-axis (0 degrees).
location [Required]
A Ladybug location object.
month
An integer between 1 and 12 for the month of the year (default: 6).
day
An integer between 1 and 31 for the day of the month (default: 21).
hour
A number between 0 and 23.999 for the hour of the day (default: 12).
type
An integer between 0..5 to indicate CIE Sky Type (default: 0).
0 = Sunny with sun
1 = sunny without sun
2 = intermediate with sun
3 = intermediate without sun
4 = cloudy sky
5 = uniform sky
sky
A honeybee sky that can be used to create a point-in-time recipe.
-
Create a Custom sky from direct and diffuse irradiance.
north
A number between 0 and 360 that represents the degrees off from the y-axis to make North. This can also be a vector to set the North. Default is 0. The default North direction is the Y-axis (0 degrees).
location [Required]
A Ladybug location object.
dir_rad [Required]
Direct normal irradiance (W/m2).
diff_rad [Required]
Diffuse horizontal irradiance (W/m2).
month
An integer between 1 and 12 for the month of the year (default: 6).
day
An integer between 1 and 31 for the day of the month (default: 21).
hour
A number between 0 and 23.999 for the hour of the day (default: 12).
colored
Boolean to note whether the sky will be rendered in full color (True) or it will simple be a grey sky with the same average value as the colored sky (False). (Default: False).
sky
Honeybee sky. You can use this sky to create a daylight recipe.
Create a uniform sky that yields a certain illuminance.
value
Desired value for sky horizontal illuminance in lux. (Default: 10000).
sky
A honeybee sky that can be used to create a point-in-time recipe.
Create a WEA object using the original ASHRAE Clear Sky formula.
location [Required]
A Ladybug Location object which will set the sun poisition for the clear sky Wea. Locations can be obtained from the "LB Import EPW" or the "LB Construct Location" component.
clearness
A factor to be multiplied by the output of the clear sky model. This is to help account for locations where clear, dry skies predominate (e.g., at high elevations) or, conversely, where hazy and humid conditions are frequent. See Threlkeld and Jordan (1958) for recommended values. Typical values range from 0.95 to 1.05 and are usually never more than 1.2. (Default: 1.0).
hoys
An optional list of hours of the year (numbers from 0 to 8759) for which the Wea will be filtered. HOYs can be generated from the "LB Analysis Period" component or they can be obtained through other means like analysis of the values in an occupancy schedule. By default, the Wea will be generated for the whole year.
timestep
An integer representing the timestep with which to make the WEA object. (Default: 1, for 1 step per hour of the year).
wea
A wea object from stat file. This wea object represents an original ASHRAE Clear Sky, which is intended to determine peak solar load and sizing parmeters for HVAC systems.
-
Create a Wea object from an EPW file.
epw_file [Required]
Full path to an .epw weather file.
hoys
An optional list of hours of the year (numbers from 0 to 8759) for which the Wea will be filtered. HOYs can be generated from the "LB Analysis Period" component or they can be obtained through other means like analysis of the values in an occupancy schedule. By default, the Wea will be generated for the whole year.
timestep
An integer representing the timestep with which to make the WEA object. Default is set to 1 for 1 step per hour of the year.
wea
A wea object from epw file.
Construct a WEA from hourly data collections and the Zhang-Huang Solar Model.
location [Required]
A Ladybug Location object.
cloud_cover [Required]
Hourly DataCollection with the fraction of total sky cover (tenths of coverage). (eg. 1 is 1/10 covered. 10 is total coverage)
rel_humidity [Required]
Hourly DataCollection with relative humidity [%].
dry_bulb_temp [Required]
Hourly DataCollection with dry bulb temperature [C].
wind_speed [Required]
Hourly DataCollection with wind speed [m/s].
atmos_pressure
Hourly DataCollection with amtospheric pressure [Pa]. If no value is connected here, pressure at sea level will be assumed (101,325 Pa).
wea
A wea object from the input data collections and the Zhang-Huang solar model.
Create a WEA object for an ASHRAE Revised Clear Sky (Tau Model) using a STAT file.
stat_file [Required]
Full path to .stat file that will be used to make the clear sky Wea. Note that an error will be raised if no atmospheric optical data is found in the file. In this case, the "HB Wea from Clear Sky" component can be used.
hoys
An optional list of hours of the year (numbers from 0 to 8759) for which the Wea will be filtered. HOYs can be generated from the "LB Analysis Period" component or they can be obtained through other means like analysis of the values in an occupancy schedule. By default, the Wea will be generated for the whole year.
timestep
An integer representing the timestep with which to make the WEA object. Default is set to 1 for 1 step per hour of the year.
wea
A wea object from stat file. This wea object represents an ASHRAE Revised Clear Sky ("Tau Model"), which is intended to determine peak solar load and sizing parmeters for HVAC systems. The "Tau Model" uses monthly optical depths found within a .stat file.
Visualize a sky as a High Dynamic Range (HDR) image file.
sky [Required]
A Radiance sky from any of the sky components under the "Light Sources" tab. Text string representations of skies are also acceptable.
size
A number for the X and Y dimension of the imgae in pixles. (Default: 500 px)
hdr
Path to the High Dynamic Range (HDR) image file of the sky. This can be plugged into the Ladybug "Image Viewer" component to preview the image. It can also be plugged into the "HB False Color" component to convert the image into a false color version. Lastly, it can be connected to the "HB HDR to GIF" component to get a GIF image that is more portable and easily previewed by different software.
ghi
The global horizontal irradiance (W/m2) for an upstructed test point under the sky.
Deconstruct a Wea object into data collections of direct, diffuse, and golbal irradiance at each timestep of the file.
wea [Required]
A Honeybee WEA object.
dir
A data collection of direct normal irradiance values at each timestep of the Wea.
diff
A data collection of diffuse sky solar irradiance values at each timestep of the Wea.
glob
A data collection of global horizontal irradiance values at each timestep of the Wea.
