eulumdat-rs

A Rust workspace for parsing, writing, and analyzing photometric files: EULUMDAT (LDT), IES (LM-63), and ATLA/TM-33 formats.

Internally uses ATLA-S001 as the unified photometric data model - the most comprehensive and permissive format that supports spectral data, greenhouse metrics, and seamless conversion between all formats.

Crates

Applications

macOS QuickLook Extension

Preview LDT files directly in Finder with polar diagrams - no need to open an app!

• Finder Preview: Select any .ldt file and press Space for instant preview
• Quick Look: Beautiful polar diagram visualization in Finder's preview pane
• Universal Binary: Native support for Apple Silicon and Intel Macs

Features

• Parse LDT/IES files - Full EULUMDAT and IESNA LM-63 format support
• Full LM-63-2019 Support - Latest IES standard with all features:
  • File generation types (accredited lab, simulation, scaled, interpolated)
  • 15 luminous opening shapes from negative dimensions
  • TILT=INCLUDE parsing with lamp geometry
  • [MORE] continuation for multi-line keywords
  • 71 IES-specific validation rules
• Write LDT files - Roundtrip-tested output generation
• Export to IES - LM-63-2019 (default) or LM-63-2002 format
• Batch conversion - Efficient bulk processing of multiple files
• Validation - 44 LDT + 71 IES validation constraints
• Symmetry handling - 5 symmetry types with automatic data expansion
• Photometric calculations - CIE flux codes, beam/field angles, spacing criteria, zonal lumens, UGR
• GLDF integration - Full DescriptivePhotometry population from IES/LDT
• BUG Rating - IESNA TM-15-11 Backlight-Uplight-Glare calculations
• Diagram generation - Polar, Butterfly, Cartesian, Heatmap, Spectral with SVG export

ATLA-S001 & TM-33-23 Support

The library internally uses ATLA-S001 (Advanced Transfer Language for photometric Applications) as the unified data model. This provides:

• Spectral data support - Full wavelength-based intensity distributions (380-780nm)
• Horticultural metrics - PPF, PPFD, YPF, phytochrome ratios for grow lights
• TM-33-23 compatibility - IES TM-33-23 XML format for horticultural lighting
• Lossless conversion - Convert between LDT, IES, and ATLA formats without data loss
• Extended metadata - Manufacturer info, test conditions, spectral characteristics

use atla::{Atla, SpectralData};

// Parse TM-33-23 XML
let atla = Atla::from_xml(xml_content)?;

// Access spectral data
if let Some(spectral) = &atla.spectral {
    println!("PPF: {:.1} μmol/s", spectral.ppf());
    println!("CCT: {}K", spectral.cct());
}

// Convert to/from EULUMDAT
let ldt = atla.to_eulumdat()?;
let atla2 = Atla::from_eulumdat(&ldt)?;

Installation

Rust Library

[dependencies]
eulumdat = "0.4"

Command-Line Tool

cargo install eulumdat-cli

Desktop GUI

cargo install eulumdat-egui
eulumdat-egui  # Launch the GUI

Python

pip install eulumdat

Swift (SPM)

// Package.swift
dependencies: [
    .package(url: "https://github.com/holg/eulumdat-rs", from: "0.4.0")
]

Quick Start

Rust

use eulumdat::{Eulumdat, BugDiagram, diagram::SvgTheme};

// Parse from file
let ldt = Eulumdat::from_file("luminaire.ldt")?;

// Access data
println!("Luminaire: {}", ldt.luminaire_name);
println!("Max intensity: {:.1} cd/klm", ldt.max_intensity());

// Validate
for warning in ldt.validate() {
    println!("[{}] {}", warning.code, warning.message);
}

// Generate polar diagram SVG
let polar = eulumdat::diagram::PolarDiagram::from_eulumdat(&ldt);
let svg = polar.to_svg(500.0, 500.0, &SvgTheme::light());

// Calculate BUG rating
let bug = BugDiagram::from_eulumdat(&ldt);
println!("BUG Rating: {}", bug.rating);

Python

import eulumdat

# Parse from file or string
ldt = eulumdat.Eulumdat.from_file("luminaire.ldt")

# Access data
print(f"Luminaire: {ldt.luminaire_name}")
print(f"Max intensity: {ldt.max_intensity():.1f} cd/klm")

# Generate SVG diagrams
polar_svg = ldt.polar_svg(width=500, height=500)
bug_svg = ldt.bug_svg()

# Calculate BUG rating
rating = ldt.bug_rating()
print(f"BUG Rating: {rating}")

# NEW: Photometric calculations
summary = ldt.photometric_summary()
print(summary.to_text())  # Full report
print(summary.to_compact())  # One-liner

# NEW: Individual calculations
cie = ldt.cie_flux_codes()
print(f"CIE Flux Code: {cie}")  # e.g., "100 77 43 0 0"
print(f"Beam angle: {ldt.beam_angle():.1f}°")
print(f"Field angle: {ldt.field_angle():.1f}°")
print(f"Spacing: {ldt.spacing_criteria()}")  # (S/H C0, S/H C90)

# NEW: GLDF export
gldf = ldt.gldf_data()
print(gldf.to_dict())  # For JSON serialization

# Batch conversion (efficient bulk processing)
from eulumdat import BatchInput, ConversionFormat, batch_convert

inputs = [
    BatchInput("file1.ldt", ldt_content1),
    BatchInput("file2.ldt", ldt_content2),
]
outputs, stats = batch_convert(inputs, ConversionFormat.Ies)
print(f"Converted {stats.successful}/{stats.total} files")

Swift

import Eulumdat

// Parse LDT content
let ldt = try parseLdt(content: ldtString)

// Access data
print("Luminaire: \(ldt.luminaireName)")
print("Max intensity: \(ldt.maxIntensity) cd/klm")

// Generate SVG diagrams
let polarSvg = generatePolarSvg(ldt: ldt, width: 500, height: 500, theme: .light)
let bugSvg = generateBugSvg(ldt: ldt, width: 400, height: 350, theme: .dark)

// Calculate BUG rating
let rating = calculateBugRating(ldt: ldt)
print("BUG Rating: B\(rating.b) U\(rating.u) G\(rating.g)")

CLI

# Display file information
eulumdat info luminaire.ldt

# Validate
eulumdat validate luminaire.ldt

# Convert LDT to IES
eulumdat convert luminaire.ldt output.ies

# Generate diagram
eulumdat diagram luminaire.ldt -t polar -o polar.svg

# Calculate BUG rating
eulumdat bug outdoor_luminaire.ldt --svg bug.svg

# Batch convert multiple files
eulumdat batch input_folder/ -o output_folder/ -f ies

# NEW: Photometric summary (text, compact, or JSON)
eulumdat summary luminaire.ldt
eulumdat summary luminaire.ldt -f json -o summary.json

# NEW: GLDF-compatible export
eulumdat gldf luminaire.ldt --pretty -o gldf_data.json

# NEW: Specific calculations
eulumdat calc luminaire.ldt -t cie-codes      # CIE flux codes
eulumdat calc luminaire.ldt -t beam-angles    # Beam/field angles
eulumdat calc luminaire.ldt -t spacing        # S/H ratios
eulumdat calc luminaire.ldt -t zonal-lumens   # 30° zone distribution
eulumdat calc luminaire.ldt -t all            # Everything

macOS / iOS

Native SwiftUI app available in the EulumdatApp directory.

# Build and run with Xcode
cd EulumdatApp
open EulumdatApp.xcodeproj

Features:

• Universal app - Single binary for macOS (Intel + Apple Silicon) and iOS
• QuickLook Extension - Preview .ldt files directly in Finder (press Space)
• All diagram types - Polar, Butterfly, Cartesian, Heatmap, BUG, LCS
• Interactive 3D view - Rotate and zoom butterfly diagrams
• Template library - Built-in sample luminaires for testing
• Full validation - All 44 specification constraints checked
• Export options - SVG, IES, LDT formats
• Intensity table - Copy as CSV, toggle color highlighting

Android

Native Jetpack Compose app available in the EulumdatAndroid directory.

# Build with Gradle
cd EulumdatAndroid
./gradlew assembleDebug

Features:

• Material 3 design - Modern Android UI following latest guidelines
• All diagram types - Polar, Butterfly, Cartesian, Heatmap, BUG, LCS
• Interactive 3D view - Touch gestures to rotate butterfly diagrams
• Template library - Sample luminaires included
• File picker - Open .ldt/.ies from device storage
• Share & Export - SVG export with Android share sheet
• Multi-architecture - ARM64, ARMv7, x86_64 native libraries

Diagram Types

LM-63-2019 IES Support

Full support for the latest ANSI/IES LM-63-2019 standard:

use eulumdat::{IesParser, IesData, FileGenerationType, LuminousShape, IesMetadata};

// Parse IES with full metadata
let ies_data: IesData = IesParser::parse_to_ies_data(content)?;

// Access LM-63-2019 specific fields
println!("Version: {:?}", ies_data.version);           // IesVersion::Lm63_2019
println!("Test Lab: {}", ies_data.test_lab);           // From [TESTLAB]
println!("Issue Date: {}", ies_data.issue_date);       // From [ISSUEDATE]
println!("Accredited: {}", ies_data.file_generation_type.is_accredited());
println!("Shape: {:?}", ies_data.luminous_shape);      // Circular, Rectangular, etc.

// TILT data if present
if let Some(tilt) = &ies_data.tilt_data {
    println!("Lamp geometry: {}", tilt.lamp_geometry);
    println!("Tilt angles: {:?}", tilt.angles);
}

// Convert to IesMetadata for GLDF integration
let meta = IesMetadata::from_ies_data(&ies_data);
let (shape, width_mm, length_mm, diameter_mm) = meta.to_gldf_emitter_geometry();

File Generation Types

IES Validation

use eulumdat::{validate_ies, validate_ies_strict, IesValidationSeverity};

// Get all warnings
for warning in validate_ies(&ies_data) {
    println!("[{}] {}: {}", warning.code, warning.severity, warning.message);
}

// Strict validation (returns error if critical issues)
validate_ies_strict(&ies_data)?;

References

• EULUMDAT Format (Paul Bourke)
• ANSI/IES LM-63-2019 - Current IES standard
• IESNA LM-63-2002 - Legacy format reference
• IES TM-33-23 - Luminaire optical data format for horticultural lighting
• ATLA-S001 - Advanced Transfer Language for photometric Applications
• IES TM-15-11 BUG Ratings

License

MIT OR Apache-2.0