> For the complete documentation index, see [llms.txt](https://docs.ladybug.tools/hb-energy-primer/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ladybug.tools/hb-energy-primer/components/3_loads/lighting.md).

# Lighting

![](/files/-MihpfEo2uc6eo-vb72O)

![](/files/-MihpeMf_53IYMlPzrME) - [\[source code\]](https://github.com/ladybug-tools/honeybee-grasshopper-energy/blob/master/honeybee_grasshopper_energy/src//HB%20Lighting.py)

Create a Lighting object that can be used to create a ProgramType or be assigned directly to a Room.

## Inputs

* **name**

  Text to set the name for the Lighting and to be incorporated into a unique Lighting identifier. If None, a unique name will be generated.&#x20;
* **watts\_per\_area \[Required]**

  A numerical value for the lighting power density in Watts per square meter of floor area.&#x20;
* **schedule \[Required]**

  A fractional for the use of lights over the course of the year. The fractional values will get multiplied by the \_watts\_per\_area to yield a complete lighting profile.&#x20;
* **radiant\_fract**

  A number between 0 and 1 for the fraction of the total lighting load given off as long wave radiant heat.&#x20;
* **visible\_fract**

  A number between 0 and 1 for the fraction of the total lighting load given off as short wave visible light.&#x20;
* **return\_fract**

  A number between 0 and 1 for the fraction of the total lighting load that goes into the zone return air (into the zone outlet node). Default: 0.0 (representative of pendant lighting).&#x20;
* **baseline**

  An optional number for the baseline lighting power density in W/m2 of floor area. This baseline is useful to track how much better the installed lights are in comparison to a standard like ASHRAE 90.1. If set to None, it will default to 11.84029 W/m2, which is that ASHRAE 90.1-2004 baseline for an office.&#x20;

## Outputs

* **lighting**

  A Lighting object that can be used to create a ProgramType or be assigned directly to a Room.&#x20;