Skip to main content

ies chart

ies chart​

Export an SVG or PNG photometric chart; PNG rasterization is 2D and needs no WebGL

Usage​

ies chart <file> [--help] [--version] [--format <format>] [--lamp-set <lamp-set>] --output <output> [--type <type>] [--width <width>] [--height <height>] [--axis <axis>] [--angle <angle>] [--log-scale] [--up-axis <up-axis>] [--mounting-height <mounting-height>] [--extent <extent>] [--resolution <resolution>] [--contours <contours>] [--min-contour <min-contour>] [--color-scale <color-scale>] [--max-distance <max-distance>] [--unit <unit>] [--max-columns <max-columns>] [--max-rows <max-rows>] [--json]
ArgumentTypeRequiredDescription
filestringYesIES (.ies) or EULUMDAT (.ldt) input file
FlagTypeRequiredDescription
--formatstringNoOverride extension and content detection of the input format; Choices: ies, ldt
--lamp-setnumberNoSelect one alternative LDT lamp configuration (1-based)
--outputstringYesOutput .svg or .png file; Aliases: o
--typestringNoChart type; cone, luminance and intensity-table are Type C tables; Choices: polar, cartesian, topology, isolux, cone, luminance, intensity-table; Default: polar
--widthnumberNoImage width in pixels; maximum 8192; Default: 900
--heightnumberNoImage height in pixels; maximum 8192; Default: 700
--axisstringNoSweep axis; Choices: vertical, horizontal; Default: vertical
--anglenumberNoFixed plane angle in degrees; omit for both principal planes on a vertical sweep
--log-scalebooleanNoPolar and Cartesian: log intensity scale spanning three decades below the peak; Default: false
--up-axisstringNoTopology orientation; Choices: x, y, z; Default: y
--mounting-heightnumberNoIsolux mounting height in meters; Default: 2
--extentnumberNoIsolux ground extent in meters; Default: 10
--resolutionnumberNoIsolux grid resolution (2–201); Default: 61
--contoursstringNoIsolux contour levels in lux, comma-separated (for example 1,2,5,10); default is a 1-2-5 series
--min-contournumberNoLowest automatic 1-2-5 isolux contour in lux; ignored with --contours; Default: 1
--color-scalestringNoIsolux heatmap colour mapping; log keeps low-light spill visible; Choices: log, linear; Default: log
--max-distancenumberNoCone diagram distances 1…N in meters (integer 1–50); Default: 5
--unitstringNoIntensity table unit; cd/klm needs a declared lamp flux; Choices: cd, cd/klm; Default: cd
--max-columnsnumberNoIntensity table: keep at most N evenly spaced C columns
--max-rowsnumberNoIntensity table: keep at most N evenly spaced γ rows
--jsonbooleanNoPrint a JSON output report; table chart types include their values
Exit codeStatusDescription
1BAD_USER_INPUT_ERRORInvalid arguments or unreadable input

Examples​

Polar SVG​

ies chart luminaire.ies -o polar.svg

Isolux PNG​

ies chart luminaire.ies -o isolux.png --type isolux --mounting-height 3

Isolux with explicit contours​

ies chart luminaire.ies -o isolux.svg --type isolux --extent 30 --contours 1,2,5,10 --color-scale linear