uwg.solarcalcs module

Class for solar calculations.

class uwg.solarcalcs.SolarCalcs(UCM, BEM, simTime, RSM, forc, parameter, rural)

Bases: object

Solar calculations.

Parameters:

• UCM – Urban Canopy - Building Energy Model object.

• BEM – Building Energy Model object.

• simTime – Simulation time object

• RSM – Rural Site & Vertical Diffusion Model Object.

• forc – Forcing object.

• parameter – Param Object.

• rural – Rural road Element object.

Properties:

• # Properties added from solarcalcs

• dir – direct sunlight (perpendicular to the sun’s ray)

• dif – diffuse sunlight

• tanzen – tangente of solar zenithal angle

• critOrient – critical canyon angle for which solar radiation reaches the road

• horSol – direct horizontal radiation

• Kw_term – fractional terms for wall

• Kr_term – fractional terms for road

• mr – fractional terms for wall

• mw – fractional terms for road

• ut – elapsed hours on current day

• ad – fractional year in radians

• eqtime – time variable

• decsol – solar declination angle

• zenith – Angle between normal to earth’s surface and sun position

solarangles()

Solves for zenith angle, tangent of zenithal angle, and critical canyon angle.

Calculation based on NOAA from:

• canAspect – aspect Ratio of canyon

• simTime – simulation time parameters

• RSM.lon – longitude (deg)

• RSM.lat – latitude (deg)

• RSM.GMT – GMT hour correction

solarcalcs()

Solar Calculation.

Mutates RSM, BEM, and UCM objects based on following parameters:

• UCM – Urban Canopy - Building Energy Model object

• BEM – Building Energy Model object

• simTime – Simulation time object

• RSM – Rural Site & Vertical Diffusion Model Object

• forc – Forcing object

• parameter – Geo Param Object

• rural – Rural road Element object