shading_device

Modules

shading_device_system module

class ShadingDeviceSystem(**kwargs)

Bases: System

A shading device system model for controlling solar heat gain.

This model represents window blinds, shades, or other devices that control solar heat gain through windows. The model acts as a pass-through for shade position control signals, allowing other systems to control the shading device.

The model simply passes through the shade position from input to output, allowing for control of the shading device by other systems.

The shade position is typically represented as a value between 0 and 1, where: - 0 represents fully closed/blocked - 1 represents fully open/transparent

Parameters:

**kwargs – Additional keyword arguments passed to the parent System class.

do_step(secondTime, dateTime, step_size, stepIndex)

Perform one simulation step.

This method passes through the shade position from input to output. The shade position is typically controlled by a schedule or control system.

Parameters:

• secondTime (float, optional) – Current simulation time in seconds.

• dateTime (datetime, optional) – Current simulation date and time.

• step_size (float, optional) – Time step size in seconds.

• stepIndex (int, optional) – Current simulation step index.

Return type:

None

initialize(start_time, end_time, step_size, simulator)

Initialize the shading device system.

This method is a no-op as the shading device system does not require initialization. The system has no internal state to initialize and simply passes through the shade position from input to output.

Parameters:

• start_time (datetime.datetime) – Start time of the simulation period.

• end_time (datetime.datetime) – End time of the simulation period.

• step_size (int) – Time step size in seconds.

• simulator (core.Simulator) – Simulation model object.

Return type:

None