IES Candela Lookup

Inspect a supported Type C IES candela grid and interpolate directional intensity within its recorded horizontal and vertical angles.

Inspect recorded Type C candela data and estimate intensity within its stored angle range. Supports LM-63-2002 with TILT=NONE and unity ballast fields. Files stay in your browser.

Results update as you edit.

Calculating needs JavaScript. The form becomes available when its script is ready; the guide below is always readable.

Calculation inputs

Calculation inputs
Paste the complete supported file, or choose a local .ies file below. Maximum 1 MiB; 2–2,000 vertical angles, 1–1,000 horizontal planes and 100,000 candela samples. Other formats need a suitable photometric application.
Use a direction within the horizontal angles actually recorded in this file. No reflected or rotated plane is inferred.
Use a direction within the recorded vertical angles. In Type C photometry, 0° is nadir, 90° horizontal and 180° zenith; these are luminaire coordinates, not the receiving surface incidence angle.
Optional alternative to pasting. The file is read on this device and is never uploaded. Supported format and limits are stated above.

Continue your task

Keep the file identity, requested angles, multiplier and sample/interpolation status with the intensity. Stored angles are not automatically room directions.

If this answers your question within the model’s limits, record the original inputs, unrounded result and conditions. Otherwise choose an action only when its condition applies:

See this task in the decision tree

Opening another tool does not transfer or store your entries. Keep the original values, units and conditions with the next calculation.

Find intensity in a particular direction

An IES photometric file records how luminous intensity varies with direction. That is useful when a calculation needs candela towards a particular point, rather than total lumens from a luminaire. Two lights with the same lumens can have different directional intensities because they distribute their output differently.

This lookup reads a declared subset of LM-63-2002 Type C files: TILT=NONE, with both ballast fields equal to 1. Choose a local file or paste its complete text; processing stays in your browser. Other versions, Type A or B photometry, TILT corrections and non-unity ballast fields need an application that supports those cases.

The LM-63 field description places the vertical angles first, then horizontal planes, followed by one block of candela samples for each horizontal plane. The explicit candela multiplier applies once to those samples. The result keeps file identity, requested direction and interpolation method together.

Read the coordinates before using the number

The horizontal C angle identifies a photometric plane; the vertical gamma angle identifies a direction in that plane. In this Type C representation, gamma 0° is downward along the luminaire’s photometric axis, 90° is horizontal and 180° is upward. These coordinates belong to the photometric file. They do not automatically identify north in a room or the tilt of an installed fitting.

Before carrying a value into the point-source illuminance estimate, establish how the installed luminaire is oriented and which file direction points towards the receiver. The receiver’s incidence angle is a separate angle measured from its surface normal. Entering the file’s gamma angle as the incidence angle generally describes a different geometry.

Use data for the exact product, optic, operating setting and test basis. A similarly named file may describe a different lens or dimming state.

Interpolate only inside the recorded grid

At a recorded horizontal and vertical angle, the result is the stored sample multiplied by the file multiplier. Between angles, the lookup linearly interpolates in gamma in each neighbouring C plane, then between those two planes. This is an approximation between samples, rather than another measurement.

The artificial example contains these unscaled values:

Vertical gamma angle C 0° C 90°
0° 100 100
45° 60 20
90° 0 0

At gamma 22.5°, the halfway values are 80 in C 0° and 60 in C 90°. At C 45°, their halfway value is 70. With the multiplier of 2, the result is 140 cd. At the recorded C 0° / gamma 45° point, the result is 60 × 2 = 120 cd. These invented values illustrate the method; they are not product ratings.

The curve and table show recorded vertical samples in a selected horizontal plane, after applying the multiplier. The plotted line joins those samples. Its axes are intensity and gamma angle; it is not a polar plot or a floor illuminance map. The largest stored sample is useful for inspecting the grid, but a sparse grid can miss a higher intensity between measurements.

A missing direction is unavailable here

Many legitimate IES files store only part of a distribution and rely on symmetry rules. This lookup limits queries to the angle rectangle actually stored in the file. It does not reflect quadrants, infer rotational symmetry, map 360° onto 0°, or fill an omitted hemisphere with zeros.

A file with C planes from 0° to 90° can be queried within that range. C 180° is unavailable here even if another application could expand the file using an applicable symmetry rule. A single-plane file permits queries only at that recorded C angle. Use a fuller photometric application when the required direction needs expansion.

Keep candela, lamp lumens and watts separate

The file may use positive reference lamp lumens, or −1 to identify absolute photometry. As Lighting Analysts explains, a relative file can use a test-lumen basis such as 1,000 rather than a current product’s advertised lumens. The lookup reports that field without using it to rescale the candela grid. It does not multiply the grid by the lamp count a second time.

Reported input watts and dimension units remain file metadata. Neither supplies missing directional output. Total luminaire lumens require an appropriate integration of the distribution, with its coverage and conventions understood; they cannot be read directly from a lamp-reference field. This tool does not calculate total flux or lm/W.

If samples at gamma 0° or 180° differ between planes, a warning identifies the inconsistency because they describe the same physical direction. Original values remain visible. The lookup does not average, repair or choose a preferred pole value; check the source file before relying on that direction.

What the lookup can support next

A matching directional candela value can be one input to a conditional direct point-source calculation. It does not by itself establish surface illuminance, uniformity, glare, maintained output or Australian compliance. Nearby large luminaires, obstructions and reflected light may require a different model.

For an idealised constant-intensity cone without a real file, use Uniform Cone Flux. Its constant-candela assumption should not replace the varying samples in an actual IES file.

Related tools

Lighting Product Comparison

Compare two products and calculate luminaire efficacy, or convert lumens and input watts using a supplied matching efficacy.

Inputs and results
Inputs
Product specifications; conversion requires a supplied luminaire lm/W value, known lm or W and matching-data conditions.
Results
A side-by-side record and conditional lm/W; a separate conversion calculates lm or W under your supplied efficacy.

Uniform Cone Luminous Flux

Calculate solid angle and luminous flux inside an ideal circular cone with constant intensity throughout it.

Inputs and results
Inputs
Full circular cone angle in degrees and constant intensity in cd, with an explicit uniform-model declaration.
Results
Solid angle in sr and ideal cone flux in lm; not real total lumens from a peak-candela rating.

Point-source Illuminance

Estimate direct point illuminance from directional candela, add compatible sources, or scale a measured direct contribution by distance.

Inputs and results
Inputs
Directional intensity in cd, source-to-point distance in m and incidence angle from the normal in degrees.
Results
Direct illuminance in lx at the specified point, with model conditions.

Browse all lighting tools