Skip to content

Latest commit

 

History

History
82 lines (56 loc) · 1.85 KB

File metadata and controls

82 lines (56 loc) · 1.85 KB

01 — Basic usage

eulumdat-plot generates publication-ready photometric polar diagrams from EULUMDAT (.ldt) files — suitable for product datasheets and PDF or online documentation.

For scientific / interactive plots with axis labels and legends, see the eulumdat-py polar diagram example.


Minimal

from eulumdat_plot import plot_ldt

svg = plot_ldt("luminaire.ldt")
# → luminaire.svg  (next to the source file)

With a distribution code

The code parameter is displayed in the centre of the top banner.

svg = plot_ldt("luminaire.ldt", code="D53")

Custom output path

svg = plot_ldt("luminaire.ldt", "output/diagram.svg", code="D53")

Interpolation

EULUMDAT files typically store I(γ) at 5° steps. Resampling to 1° produces visibly smoother curves.

# Linear interpolation — default, always available
svg = plot_ldt("luminaire.ldt", interpolate=True, interp_method="linear")

# Cubic spline — smoother result, requires:
# pip install "eulumdat-plot[cubic]"
svg = plot_ldt("luminaire.ldt", interpolate=True, interp_method="cubic")

# Disable — plot raw data points only
svg = plot_ldt("luminaire.ldt", interpolate=False)

Debug mode

Colour-codes each C-plane to validate symmetry expansion visually: C0 → red, C180 → blue, C90 → green, C270 → orange.

svg = plot_ldt("luminaire.ldt", debug=True)

Diagram conventions

Element Description
Solid curve C0 / C180 plane pair
Dotted curve C90 / C270 plane pair
Radial scale cd/klm, dynamic (3–6 circles)
Banner left LED
Banner centre code parameter
Banner right cd / klm
γ = 0° Nadir (bottom of diagram)
γ = 180° Zenith (top of diagram)