IES Light Profiles

Using IES Light Profiles in Unreal Engine 4

Windows
MacOS
Linux

The Illuminating Engineering Society (IES) has defined a file format which describes a light's distribution from a light source using real world measured data. These IES Photometric files, or IES Profiles, are a lighting industry standard method of diagramming the brightness and falloff of light as it exists a particular real world light fixture. It enables them to account for reflective surfaces in the light fixture, the shape of the light bulb, and any lensing effects that happens. This type of photometric lighting is primarily used in Enterprise fields (such as Media and Entertainment or Architecture and Manufacturing), but is often used in games production to achieve realistic lighting effects, too.

In Unreal Engine 4 (UE4), IES Light Profiles are a 1D texture (gradient). However, they are not actual texture files. The curve defines light intensity in an arc that "sweeps" around an axis to make Point, Spot, and Rect Lights appear to be casting light realistically based on the provided real-world data. The curve works like a multiplier for the overall brightness of the light, as if you were projecting a texture from a light, but without the overhead of using a texture, or the errors that can occur at some angles.

In the examples below, the IES Profile is assigned to a Point Light and the diagram in the top left of each panel shows the shape of the given IES Profile.

Click the image for full size.

If you were to open an IES Profile in a text editor, you would find that it is an ASCII file containing a wide array of metadata, like this example for a Lithonia TE_150S_E17_C:

IESNA:LM-63-2002
[TEST] 11915
[TESTDATE] 1/31/2008
[ISSUEDATE] 1/24/2014
[TESTLAB] ACUITY BRANDS LIGHTING CONYERS LAB
[TESTMETHOD] IES LM-46:2004
[MANUFAC] Lithonia Lighting
[LUMCAT] TE 150S E17 C (SC=1.0)
[LUMINAIRE] PREMIUM ENCLOSED HIGHBAY INDUSTRIAL WITH ALUMINUM REFLECTOR, CLEAR TEMPERED GLASS LENS, AND CONCENTRATING DISTRIBUTION
[LAMPCAT] LU150
[LAMP] ONE 150-WATT CLEAR ET-23.5 HIGH PRESSURE SODIUM, VERTICAL BASE-UP POSITION
[BALLAST] 
[BALLASTCAT] 
[DISTRIBUTION] DIRECT, SC-0=1.05, SC-90=1.05
[_LAMPPOSITION] 0 , 0
[_LAMPTYPE] HIGH PRESSURE SODIUM
[_LAMPWATTAGE] 150
[_LAMPLUMENS] 16000
[_MOUNTING] Suspended
[_FAMILY] TE E17
[_PRODUCTID] 69f8c24f-2e1c-4665-820d-92d61687bd9f
[_INFOLINK] www.lithonia.com/visual/ies/ies.asp?vfile=
[_PRODUCTGROUP] INDOOR HID
[_TERCAT] Highbay, Nonlinear                                
[_TER] 41
TILT=NONE
1  16000  1  11  1  1  1  -1.4  0  0
1  1  189
0  5  15  25  35  45  55  65  75  85  90
0
8461  8664  10082  7108  4474  1272  330  106  54  39  35

Usage

Use the following steps to use your own IES Profiles in UE4:

Importing and Assigning to Lights

  1. Import an IES Profile by using one of the available import methods for textures: using the Add New button, drag-and-drop, or right-click menu.

  2. Select a Point, Spot, or Rect Light from your scene. Under the Details panel, assign the light profile to the IES Texture slot under Light Profiles.

    IESProfiles_Details.png

Using a light profile with precomputed Static lighting builds can potentially produce poor results due to the light profile's mask and a low lightmap resolution. Increasing the lightmap resolution of the receiving surface or using Stationary or Movable Lights produce the best result.

Profile Light Intensity

Optionally, you can choose to use IES Profile's light intensity over the Light's Intensity:

IESProfiles_Details2.png

  • Use IES Intensity uses the light brightness from the profile, and when disabled will use the selected light's intensity value.

  • IES Intensity Scale globally scales the profile's brightness contribution. This value can only be set when Ues IES Intensity is enabled.

Texture Properties

When opening an IES Profile, the Texture Editor provides a couple of options under Texture Light Profiles that you can set:

IES_TextureEditorProperties.png

Property

Description

Brightness

The light brightness in candelas imported from the IES Profile. When enabling Use IES Intensity on the light and this value is less than or equal to 0, the profile will be used for masking only, causing the light to be completely masked by the profile. Also, this should be used in conjunction with the light's setting for Inverse Squared Falloff.

Texture Multiplier

This uneditable value is the multiplier used to map texture value to a result that is integrated over a sphere to 1.0f.

3D Light Profile Visualization

When selecting a light that has an IES Texture assigned, a visualization of the light's representation will be shown.

Without Light Selected

With Light Selected

Additional Notes

Performance

IES Profiles render very fast and do not have a significant effect on performance, making them a more ideal option for shaping your light than a Light Function.

Spot Lights

Using IES Profiles on any Point or Rect Lights turns them—visually speaking—into Spot Lights and using them on a Spot Light will operate the same way except the Spot Light's cones will mask the IES Profile effect. However, since the projection area of a Spot Light is a 179 degree arc (at its maximum), any IES data past that point is lost.

Lights Selected

Lights Unselected

In this comparison, the IES profile emits light in all directions. When used by a Spot Light, the IES data is clipped to the Spot Light's Cone Angle. When used by a Point Light, the IES profile is unclipped.

Acquiring and Previewing Light Profiles

The easiest way to acquire IES Profiles is to visit the manufacturer's website and download them, as almost all major lighting manufacturers provide them free of charge. A couple of links are provided below:

To visualize the light's IES Profile, you can use photometric viewers, such as IESviewer, which is freely available. With it, you can select a light profile, visualize the profile and preview what it would look like before you decide to import it into UE4.

IESviewer

Image credit to Andrey Legotin.

Some manufacturer sites, such as Lithonia's site, have a built-in profile viewer that can be used in your web broswer without needing to download the profile to preview it.

Select Skin
Light
Dark

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback