LTI Optics is always striving to improve customer support and provide you timely product updates and information to increase your productivity. If you have questions about your software, we invite you to review the sections below and check for new product downloads.

You may email support inquiries to us at the follow address: support email

Should you need to call us, our support hours are 8 AM - 5 PM MST. Please review the technical support policy. Our technical support staff can be reached at 720-891-0030.

For photopia | reports, our technical support is intended to answer any questions you may have about the use of the software, or how to apply a specific configuration item to a report, plot or table.

It is beyond the scope of standard technical support to create a full custom template or report for you. You can create a custom template yourself using the information on this page. It will be helpful if you have a knowledge of HTML and XML as these are the languages of the reports.

If you're not comfortable editing the HTML and XML configuration files to create a custom report, we are happy to offer this as a service. You'll just provide us with a template to match and we'll create all the custom files for your report. Email support email for a quote.

Install

photopia | reports is installed by default with Photopia and Photopia for SOLIDWORKS. photopia | reports can also be installed on its own. To obtain the installer, contact LTI Optics.

Licensing

photopia | reports will be automatically licensed if Photopia is on the same machine. For standalone installs, a license must be purchased from LTI Optics.

  • Saving to PNG
  • Saving to SVG
  • Saving to HTML
  • Print to PDF
  • photopia | reports creates vector plots and html tables, which allow you to export web and print ready reports directly into your page layout software like Adobe InDesign.

    Plots can be saved as SVG and PNG files.

    Reports can be saved as PNG and HTML files.

    Both Plots and Reports can be printed to PDF files.

    Saving to PNG

    When viewing a plot or report, choose the Save button and specify the file name for the PNG file. By default the export will be at the window resolution. To modify the resolution, before exporting, choose Settings > Image Resolution and set the pixel value for the smallest side of the image.

    Saving to SVG

    When viewing a plot, choose the Save button and specify the file name for the SVG file.

    Saving to HTML

    When viewing a plot or report, choose the Save button and specify the file name for the HTML file. By default the export will be at the window resolution. The HTML file was designed for the Microsoft Edge browser, so if it is opened in another browser it may not render the same.

    Printing to PDF

    Right click in the plot or report window and choose Print. You'll need to set the page margins and page scale to ensure that you fit the data onto the page.

    In Windows 10 you can print directly to a PDF. In earlier versions you'll need a PDF print driver, like Adobe Acrobat, CutePDF, or the DiaLUX PDF printer.

    You can customize any of the plots or data tables by creating a new style. The easiest way to do this is by copying an existing item that is similar and modifying it.

    Location

    All default style documents are stored here:

    C:\Program Files (x86)\LTI Optics\Reports\Style\

    Copy Files

    Custom styles need to be placed in this location:

    C:\ProgramData\LTI Optics\Reports\CustomStyle\
    .

    In the Program Files folder for each style, there will be an .xml file that specifies the configuration and a .png file that is a preview of the plot used in the program display. To create a new style, copy both of these files and give them a new name in your ProgramData folder. Note that the first part of the name IntensityPlot - must remain since it defines the particular plot or table type that the files apply to.

    Modify Files

    Open the xml file in a text editor and edit the values based on what you want to change. This page contains details of what most elements do.

    You can manually create a preview image, or you can export an image from the tool and use that as the preview image.

    Pixels, Points and Vectors

    The Photometric Reports software generates all graphics as vector artwork, so they can be scaled to very high resolution.

    Throughout the configuration, some items will be referenced as pixel values (either thickness or position) and fonts as point values. These are not actual pixels, but coordinates used to create the vectors. Some items are referenced as a percentage of the overall plot size.

    Color Systems

    Colors can be specified in the following formats:

      - CIE_RGB: scaled 0-255

    <type>CIE_RGB</type>
    <value>255,255,255</value>

      - sRGB: scaled 0-255

    <type>sRGB</type>
    <value>255,255,255</value>

      - HSL: scaled 0-1

    <type>HSL</type>
    <value>0.5,0.25,0.1</value>

      - NULL_COLOR: can be used to turn off an element or make it fully transparent

    <type>NULL_COLOR</type>
    <value>0,0,0</value>

    Font Settings

    Fonts are specified using the following block. Font family is similar to html/css referencing. Font size is specified in points.

    <fontstyle>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0.5,0.25,0.1</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0.5,0.25,0.1</value>
    	</strokecolor>
    	<strokewidth>2</strokewidth>
    	<fontsize>10</fontsize>
    </fontstyle>

    Common Elements

    Fill Color: sets the color of the fill, using any of the Color Systems above

    <fillcolor>
    	<type>HSL</type>
    	<value>0.5,0.25,0.1</value>
    </fillcolor>

    Opacity: sets the opacity of the fill, scaled 0-1

    <opacity>0.5</opacity>

    Stroke Color: sets the color of the stroke, using any of the Color Systems above

    <strokecolor>
    	<type>HSL</type>
    	<value>0.5,0.25,0.1</value>
    </strokecolor>

    Stroke Width: sets the width of the stroke in pixels

    <strokewidth>3</strokewidth>

    Hiding or Turning Off Items

    Within plots, the best way to turn off or hide a particular item is to set the color of that item to NULL_COLOR.

    <type>NULL_COLOR</type>
    	<value>0,0,0</value>

    File Naming & Thumbnail Image

    The file name must begin with the words "IESReport" and can be followed by any other text. A thumbnail image with a square aspect ratio should be placed alongside the xml file with the same name.

    Example

    An IES Report is a collection of plots and tables that is rendered as HTML. The file contains style directives as well as information for each plot and table.

    <report>
    	<style>
    		body {
    			font-family: "Century Gothic Bold";
    		}
    	
    		#IntensityTable,
    		#LuminaireLuminance {
    			table-layout: auto;
    		}		  
    	</style>
    	<fragment><![CDATA[<h1>Photometric Report</h1>]]></fragment>	
    	<HeaderTableConfiguration>
    		<id>HeaderTable</id>	
    		<columnlabels></columnlabels>	
    		<includekeys>TESTLAB,MANUFAC</includekeys>			
    	</HeaderTableConfiguration>
    	...
    	other reports and plots
    	...
    
    </report>

    Style

    The Style element is filled with CSS3 styles for formatting the report.

    <style>
    	body {
    		font-family: "Century Gothic Bold";
    	}
    	
    	#IntensityTable,
    	#LuminaireLuminance {
    		table-layout: auto;
    	}		  
    </style>

    Fragment

    The fragment element is used for direct HTML entities that will be placed into the report. Use this element for any formatting or static text. Items within a fragment should be contained within a CData entity to preserve characters.

    <fragment><![CDATA[<h1>Photometric Report</h1>]]></fragment>

    CData

    The CData element allows proper transfer of HTML from the report file to the final display.

    <![CDATA[<h1>Photometric Report</h1>]]>

    File Naming & Thumbnail Image

    The file name must begin with the words "IntensityPlot" and can be followed by any other text. A thumbnail image with a square aspect ratio should be placed alongside the xml file with the same name.

    View Size

    The size, in pixels, of the view.

    <viewdimensions>1000,1000<viewdimensions/>

    Interpolation

    Controls the interpolation of the plotted candela data between values in the data file.

    • 0 = No interpolation
    • 1 = Linear
    • 2 = Hermite (default)
    • 3 = Cosine
    • 4 = Catmull Rom
    <interpolation>2<interpolation/>

    View Style

    Controls the overall window background and border.

    <viewstyle>
    	<fillcolor>
    		<type>sRGB</type>
    		<value>255,255,255</value>
    	</fillcolor>
    	<strokecolor>
    		<type>sRGB</type>
    		<value>128,128,128</value>
    	</strokecolor>
    	<strokewidth>0</strokewidth>
    	<opacity>0</opacity>
    </viewstyle>

    Border Style

    Controls the plot background and border.

    <borderstyle>
    	<fillcolor>
    		<type>sRGB</type>
    		<value>255,255,255</value>
    	</fillcolor>
    	<strokecolor>
    		<type>sRGB</type>
    		<value>128,128,128</value>
    	</strokecolor>
    	<strokewidth>0</strokewidth>
    	<opacity>0</opacity>
    </borderstyle>

    Legend

    Controls the plot background and border.

    The legend position can be left,right,top, or bottom.

    The legend offset is a value in percent of the view extents that the legend is offset from the base position.

    The columnwidths are in percent of the view extents. The first number is the angle text, the second is the line illustration.

    <showlegend>true</showlegend>
    <legend>
    	<position>right</position>
    	<offset>0,-0.3</offset>
    	<columnwidths>0.08,0.04</columnwidths>
    	<borderstyle>
    		<fillcolor>
    			<type>NULL_COLOR</type>
    			<value>0,0,0</value>
    		</fillcolor>
    		<strokecolor>
    			<type>SRGB</type>
    			<value>0,0,0</value>
    		</strokecolor>
    		<strokewidth>1</strokewidth>
    		<opacity>1</opacity>
    	</borderstyle>
    	<fontstyle>
    		<family>Tahoma</family>
    		<fillcolor>
    			<type>CIE_RGB</type>
    			<value>0,0,0</value>
    		</fillcolor>
    		<strokecolor>
    			<type>CIE_RGB</type>
    			<value>0,0,0</value>
    		</strokecolor>
    		<strokewidth>0</strokewidth>
    		<fontsize>10</fontsize>
    	</fontstyle>
    </legend>

    Half Plane

    When set to true, all data is displayed on the right half of the plot. When set to false, the data is plotted on the left and right half in full plane pairs.

    <halfplane>true<halfplane/>

    Uplight

    When set to true, uplight and downlight data is plotted. When set to false, only downlight data is plotted.

    <uplight>true<uplight/>

    Zoom To Data

    When set to 0.0, the plots boundaries will be circular. When set to anything from 0.0 to 1.0, the plot will be zoomed to fit the data. At 1.0 the plot exactly fits the data, at 0.9, there is a 10% padding.

    <zoomtofit>0.0<zoomtofit/>

    Data Style Gradient

    The style gradient specifies the start and end horizontal angle styles and then creates a gradient between this.

    <seriesstylegradient>
    	<dataseriesstyle>
    		<fillcolor>
    			<type>HSL</type>
    			<value>0,1,0.5</value>
    		</fillcolor>
    		<strokecolor>
    			<type>HSL</type>
    			<value>0,1,0.5</value>
    		</strokecolor>
    		<strokewidth>2</strokewidth>
    		<opacity>0</opacity>
    	</dataseriesstyle>
    	<dataseriesstyle>
    		<fillcolor>
    			<type>HSL</type>
    			<value>0.83,1,0.5</value>
    		</fillcolor>
    		<strokecolor>
    			<type>HSL</type>
    			<value>0.83,1,0.5</value>
    		</strokecolor>
    		<strokewidth>2</strokewidth>
    		<opacity>0</opacity>
    	</dataseriesstyle>
    </seriesstylegradient>

    Data Style Override

    The series style override allows you to explicitly set the style for individual horizontal planes of data. This element is not necessary. The <key> is the horizontal plane in degrees.

    <seriesstyleoverride>
    	<dataseriesstyle>
    		<key>0</key>
    		<value>
    			<fillcolor>
    				<type>SRGB</type>
    				<value>255,230,0</value>
    			</fillcolor>
    			<strokecolor>
    				<type>sRGB</type>
    				<value>255,204,0</value>
    			</strokecolor>
    			<strokewidth>2</strokewidth>
    			<opacity>.5</opacity>
    		</value>
    	</dataseriesstyle>
    </seriesstyleoverride>

    Title

    The plot title text and style.

    <title>Polar Plot</title>
    <titlefont>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</strokecolor>
    	<strokewidth>1</strokewidth>
    	<fontsize>20</fontsize>
    </titlefont>

    Radius Markers

    The radius markers are the circles at certain candela values.

    <radiusmarkerstart>0.0</radiusmarkerstart>
    <radiusmarkerincrement>0.0</radiusmarkerincrement>
    <radiusmarkermajordivisor>1</radiusmarkermajordivisor>
    <radiusmarkerminordivisor>1</radiusmarkerminordivisor>
    <radiusminorfontstyle>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</strokecolor>
    	<strokewidth>0</strokewidth>
    	<fontsize>12</fontsize>
    </radiusminorfontstyle>
    <radiusminorlinestyle>
    	<fillcolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</strokecolor>
    	<strokewidth>0.5</strokewidth>
    	<opacity>1</opacity>
    </radiusminorlinestyle>
    <radiusmajorfontstyle>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</strokecolor>
    	<strokewidth>0</strokewidth>
    	<fontsize>12</fontsize>
    </radiusmajorfontstyle>
    <radiusmajorlinestyle>
    	<fillcolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,.5</value>
    	</strokecolor>
    	<strokewidth>0.7</strokewidth>
    	<opacity>1</opacity>
    </radiusmajorlinestyle>

    Angle Markers

    The angle markers are the lines from the center of the plot for each vertical angle.

    <anglemarkerincrement>0.174533</anglemarkerincrement>
    <anglemarkermajordivisor>1</anglemarkermajordivisor>
    <anglemarkerminordivisor>1</anglemarkerminordivisor>
    <angleminorfontstyle>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0.5</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.5</value>
    	</strokecolor>
    	<strokewidth>0</strokewidth>
    	<fontsize>12</fontsize>
    </angleminorfontstyle>
    <angleminorlinestyle>
    	<fillcolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.5</value>
    	</strokecolor>
    	<strokewidth>0.5</strokewidth>
    	<opacity>1</opacity>
    </angleminorlinestyle>
    <anglemajorfontstyle>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0.7</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.7</value>
    	</strokecolor>
    	<strokewidth>0</strokewidth>
    	<fontsize>12</fontsize>
    </anglemajorfontstyle>
    <anglemajorlinestyle>
    	<fillcolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.7</value>
    	</strokecolor>
    	<strokewidth>0.7</strokewidth>
    	<opacity>1</opacity>
    </anglemajorlinestyle>

    File Naming & Thumbnail Image

    The file name must begin with the words "IntensityXYPlot" and can be followed by any other text. A thumbnail image with a square aspect ratio should be placed alongside the xml file with the same name.

    Within a report the main keyword is:

    <IntensityXYPlotConfiguration>

    Interpolation

    Controls the interpolation of the plotted candela data between values in the data file.

    • 0 = No interpolation
    • 1 = Linear
    • 2 = Hermite (default)
    • 3 = Cosine
    • 4 = Catmull Rom
    <interpolation>2<interpolation/>

    View Dimensions

    The size, in pixels, of the view.

    <viewdimensions>500,500<viewdimensions/>

    Padding

    The padding around the plot inside the View Dimensions, in %.

    <padding>0.04,0.04<padding/>

    Plot Dimensions

    The % size of the View Dimensions that the plot occupies.

    <plotdimensions>.7,.8<plotdimensions/>

    Plot Position

    The % offset inside the View Dimension from the lower left hand corner.

    <plotposition>.1,.07<plotposition/>

    View Style

    Controls the overall window background and border.

    <viewstyle>
    	<fillcolor>
    		<type>sRGB</type>
    		<value>255,255,255</value>
    	</fillcolor>
    	<strokecolor>
    		<type>sRGB</type>
    		<value>128,128,128</value>
    	</strokecolor>
    	<strokewidth>0</strokewidth>
    	<opacity>0</opacity>
    </viewstyle>

    Border Style

    Controls the plot background and border.

    <borderstyle>
    	<fillcolor>
    		<type>sRGB</type>
    		<value>255,255,255</value>
    	</fillcolor>
    	<strokecolor>
    		<type>sRGB</type>
    		<value>128,128,128</value>
    	</strokecolor>
    	<strokewidth>0</strokewidth>
    	<opacity>0</opacity>
    </borderstyle>

    Legend

    Controls the plot background and border.

    The legend position can be left,right,top, or bottom.

    The legend offset is a value in percent of the view extents that the legend is offset from the base position.

    The columnwidths are in percent of the view extents. The first number is the angle text, the second is the line illustration.

    <showlegend>true</showlegend>
    <legend>
    	<position>right</position>
    	<offset>0,-0.3</offset>
    	<columnwidths>0.08,0.04</columnwidths>
    	<borderstyle>
    		<fillcolor>
    			<type>NULL_COLOR</type>
    			<value>0,0,0</value>
    		</fillcolor>
    		<strokecolor>
    			<type>SRGB</type>
    			<value>0,0,0</value>
    		</strokecolor>
    		<strokewidth>1</strokewidth>
    		<opacity>1</opacity>
    	</borderstyle>
    	<fontstyle>
    		<family>Tahoma</family>
    		<fillcolor>
    			<type>CIE_RGB</type>
    			<value>0,0,0</value>
    		</fillcolor>
    		<strokecolor>
    			<type>CIE_RGB</type>
    			<value>0,0,0</value>
    		</strokecolor>
    		<strokewidth>0</strokewidth>
    		<fontsize>10</fontsize>
    	</fontstyle>
    </legend>

    Data Style Gradient

    The style gradient specifies the start and end horizontal angle styles and then creates a gradient between this.

    <seriesstylegradient>
    	<dataseriesstyle>
    		<fillcolor>
    			<type>HSL</type>
    			<value>0,1,0.5</value>
    		</fillcolor>
    		<strokecolor>
    			<type>HSL</type>
    			<value>0,1,0.5</value>
    		</strokecolor>
    		<strokewidth>2</strokewidth>
    		<opacity>0</opacity>
    	</dataseriesstyle>
    	<dataseriesstyle>
    		<fillcolor>
    			<type>HSL</type>
    			<value>0.83,1,0.5</value>
    		</fillcolor>
    		<strokecolor>
    			<type>HSL</type>
    			<value>0.83,1,0.5</value>
    		</strokecolor>
    		<strokewidth>2</strokewidth>
    		<opacity>0</opacity>
    	</dataseriesstyle>
    </seriesstylegradient>

    Data Style Override

    The series style override allows you to explicitly set the style for individual horizontal planes of data. This element is not necessary. The <key> is the horizontal plane in degrees.

    <seriesstyleoverride>
    	<dataseriesstyle>
    		<key>0</key>
    		<value>
    			<fillcolor>
    				<type>SRGB</type>
    				<value>255,230,0</value>
    			</fillcolor>
    			<strokecolor>
    				<type>sRGB</type>
    				<value>255,204,0</value>
    			</strokecolor>
    			<strokewidth>2</strokewidth>
    			<opacity>.5</opacity>
    		</value>
    	</dataseriesstyle>
    </seriesstyleoverride>

    Title

    The plot title text and style.

    <title>X-Y Intensity Plot</title>
    <titlefont>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</strokecolor>
    	<strokewidth>1</strokewidth>
    	<fontsize>20</fontsize>
    </titlefont>

    Axis Markers

    The axis markers for the x and y axis. The x and y axis can have unique intervals, but share formatting.

    <xmarkerstart>0.0</xmarkerstart>
    <xmarkerincrement>0.0</xmarkerincrement>
    <xmarkermajordivisor>1</xmarkermajordivisor>
    <xmarkerminordivisor>1</xmarkerminordivisor>
    <ymarkerstart>0.0</ymarkerstart>
    <ymarkerincrement>0.0</ymarkerincrement>
    <ymarkermajordivisor>1</ymarkermajordivisor>
    <ymarkerminordivisor>1</ymarkerminordivisor>
    
    <minorMarkerFontStyle>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</strokecolor>
    	<strokewidth>0</strokewidth>
    	<fontsize>12</fontsize>
    </minorMarkerFontStyle>
    <minorMarkerLineStyle>
    	<fillcolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</strokecolor>
    	<strokewidth>0.5</strokewidth>
    	<opacity>1</opacity>
    </minorMarkerLineStyle>
    
    <majorMarkerFontStyle>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</strokecolor>
    	<strokewidth>0</strokewidth>
    	<fontsize>12</fontsize>
    </majorMarkerFontStyle>
    <majorMarkerLineStyle>
    	<fillcolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</strokecolor>
    	<strokewidth>0.5</strokewidth>
    	<opacity>1</opacity>
    </majorMarkerLineStyle>

    File Naming & Thumbnail Image

    The file name must begin with the words "CUXYPlot" and can be followed by any other text. A thumbnail image with a square aspect ratio should be placed alongside the xml file with the same name.

    Within a report the main keyword is:

    <CUXYPlotConfiguration>

    Interpolation

    Controls the interpolation of the plotted CU data between values in the data file.

    • 0 = No interpolation
    • 1 = Linear
    • 2 = Hermite (default)
    • 3 = Cosine
    • 4 = Catmull Rom
    <interpolation>2<interpolation/>

    View Dimensions

    The size, in pixels, of the view.

    <viewdimensions>500,500<viewdimensions/>

    Padding

    The padding around the plot inside the View Dimensions, in %.

    <padding>0.04,0.04<padding/>

    Plot Dimensions

    The % size of the View Dimensions that the plot occupies.

    <plotdimensions>.7,.8<plotdimensions/>

    Plot Position

    The % offset inside the View Dimension from the lower left hand corner.

    <plotposition>.1,.07<plotposition/>

    View Style

    Controls the overall window background and border.

    <viewstyle>
    	<fillcolor>
    		<type>sRGB</type>
    		<value>255,255,255</value>
    	</fillcolor>
    	<strokecolor>
    		<type>sRGB</type>
    		<value>128,128,128</value>
    	</strokecolor>
    	<strokewidth>0</strokewidth>
    	<opacity>0</opacity>
    </viewstyle>

    Border Style

    Controls the plot background and border.

    <borderstyle>
    	<fillcolor>
    		<type>sRGB</type>
    		<value>255,255,255</value>
    	</fillcolor>
    	<strokecolor>
    		<type>sRGB</type>
    		<value>128,128,128</value>
    	</strokecolor>
    	<strokewidth>0</strokewidth>
    	<opacity>0</opacity>
    </borderstyle>

    Legend

    Controls the plot background and border.

    The legend position can be left,right,top, or bottom.

    The legend offset is a value in percent of the view extents that the legend is offset from the base position.

    The columnwidths are in percent of the view extents. The first number is the angle text, the second is the line illustration.

    <showlegend>true</showlegend>
    <legend>
    	<position>right</position>
    	<offset>0,-0.3</offset>
    	<columnwidths>0.08,0.04</columnwidths>
    	<borderstyle>
    		<fillcolor>
    			<type>NULL_COLOR</type>
    			<value>0,0,0</value>
    		</fillcolor>
    		<strokecolor>
    			<type>SRGB</type>
    			<value>0,0,0</value>
    		</strokecolor>
    		<strokewidth>1</strokewidth>
    		<opacity>1</opacity>
    	</borderstyle>
    	<fontstyle>
    		<family>Tahoma</family>
    		<fillcolor>
    			<type>CIE_RGB</type>
    			<value>0,0,0</value>
    		</fillcolor>
    		<strokecolor>
    			<type>CIE_RGB</type>
    			<value>0,0,0</value>
    		</strokecolor>
    		<strokewidth>0</strokewidth>
    		<fontsize>10</fontsize>
    	</fontstyle>
    </legend>

    Street Side Style

    Specifies the style of the street side data line.

    <streetSideStyle>
    		<fillcolor>
    			<type>HSL</type>
    			<value>0,1,0.5</value>
    		</fillcolor>
    		<strokecolor>
    			<type>HSL</type>
    			<value>0,1,0.5</value>
    		</strokecolor>
    		<strokewidth>2</strokewidth>
    		<opacity>0</opacity>
    	</streetSideStyle>
    <streetSideLabel>Street side</streetSideLabel>

    House Side Style

    Specifies the house side style

    <houseSideStyle>
    		<fillcolor>
    			<type>HSL</type>
    			<value>0,1,0.5</value>
    		</fillcolor>
    		<strokecolor>
    			<type>HSL</type>
    			<value>0,1,0.5</value>
    		</strokecolor>
    		<strokewidth>2</strokewidth>
    		<opacity>0</opacity>
    	</houseSideStyle>
    <houseSideLabel>House side</houseSideLabel>

    Mounting Heights

    Specifies the spacing to mounting height ratios to compute and plot.

    <mountingheights>0,1,2,3,4,5,6,7,8,9,10</mountingheights>

    Title

    The plot title text and style.

    <title>Roadway CU Plot</title>
    <titlefont>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</strokecolor>
    	<strokewidth>1</strokewidth>
    	<fontsize>20</fontsize>
    </titlefont>

    X Axis Labels

    The style for the x axis.

    <xaxisposition>0.0</xaxisposition>
    <xaxisstyle>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</strokecolor>
    	<strokewidth>1</strokewidth>
    	<opacity>0</opacity>
    </xaxisstyle>
    <xaxislabel>Street width / Mounting height</xaxislabel>
    <xaxislabeloffset>0.05</xaxislabeloffset>
    <xaxislabelfont>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</strokecolor>
    	<strokewidth>1</strokewidth>
    	<fontsize>20</fontsize>
    </xaxislabelfont>

    Y Axis Labels

    The style for the y axis.

    <yaxisposition>0.0</yaxisposition>
    <yaxisstyle>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</strokecolor>
    	<strokewidth>1</strokewidth>
    	<opacity>0</opacity>
    </yaxisstyle>
    <yaxislabel>Coefficient of Utilization</yaxislabel>
    <yaxislabeloffset>0.05</yaxislabeloffset>
    <yaxislabelfont>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</strokecolor>
    	<strokewidth>1</strokewidth>
    	<fontsize>20</fontsize>
    </yaxislabelfont>

    Axis Markers

    The axis markers for the x and y axis. The x and y axis can have unique intervals, but share formatting.

    <xmarkerstart>0.0</xmarkerstart>
    <xmarkerincrement>0.0</xmarkerincrement>
    <xmarkermajordivisor>1</xmarkermajordivisor>
    <xmarkerminordivisor>1</xmarkerminordivisor>
    <ymarkerstart>0.0</ymarkerstart>
    <ymarkerincrement>0.0</ymarkerincrement>
    <ymarkermajordivisor>1</ymarkermajordivisor>
    <ymarkerminordivisor>1</ymarkerminordivisor>
    
    <minorMarkerFontStyle>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</strokecolor>
    	<strokewidth>0</strokewidth>
    	<fontsize>12</fontsize>
    </minorMarkerFontStyle>
    <minorMarkerLineStyle>
    	<fillcolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</strokecolor>
    	<strokewidth>0.5</strokewidth>
    	<opacity>1</opacity>
    </minorMarkerLineStyle>
    
    <majorMarkerFontStyle>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</strokecolor>
    	<strokewidth>0</strokewidth>
    	<fontsize>12</fontsize>
    </majorMarkerFontStyle>
    <majorMarkerLineStyle>
    	<fillcolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</strokecolor>
    	<strokewidth>0.5</strokewidth>
    	<opacity>1</opacity>
    </majorMarkerLineStyle>

    File Naming & Thumbnail Image

    The file name must begin with the words "LCSPlot" and can be followed by any other text. A thumbnail image with a square aspect ratio should be placed alongside the xml file with the same name.

    Within a report the main keyword is:

    <CUPlotConfiguration>

    View Dimensions

    The size, in pixels, of the view.

    <viewdimensions>1000,1000</viewdimensions/>

    Padding

    The size padding around the plot, in a fraction.

    <padding>.08,.08</padding/>

    Value Type

    0 to plot lumens(energy), 1 for % of lamp, 2 for % of luminaire.

    <valuetype>0</valuetype/>

    Series Style

    Specifies for each zone the fill and stroke. The valid zones are BVH, BH, BM, VL, FVH, FH, FM, FL, UH and UL.

    <seriesStyles>
    	<BH>
    		<fillcolor>
    			<type>sRGB</type>
    			<value>255,255,255</value>
    		</fillcolor>
    		<strokecolor>
    			<type>sRGB</type>
    			<value>128,128,128</value>
    		</strokecolor>
    		<strokewidth>0</strokewidth>
    		<opacity>0</opacity>
    	</BH>
    	<BL>
    		<fillcolor>
    			<type>sRGB</type>
    			<value>255,255,255</value>
    		</fillcolor>
    		<strokecolor>
    			<type>sRGB</type>
    			<value>128,128,128</value>
    		</strokecolor>
    		<strokewidth>0</strokewidth>
    		<opacity>0</opacity>
    	</BL>
    </seriesStyles>

    Title

    The plot title text and style.

    <title>Polar Plot</title>
    <titlefont>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</strokecolor>
    	<strokewidth>1</strokewidth>
    	<fontsize>20</fontsize>
    </titlefont>

    Radius Markers

    The radius markers are the circles at certain candela values.

    <radiusmarkerstart>0.0</radiusmarkerstart>
    <radiusmarkerincrement>0.0</radiusmarkerincrement>
    <radiusmarkermajordivisor>1</radiusmarkermajordivisor>
    <radiusmarkerminordivisor>1</radiusmarkerminordivisor>
    <radiusminorfontstyle>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</strokecolor>
    	<strokewidth>0</strokewidth>
    	<fontsize>12</fontsize>
    </radiusminorfontstyle>
    <radiusminorlinestyle>
    	<fillcolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</strokecolor>
    	<strokewidth>0.5</strokewidth>
    	<opacity>1</opacity>
    </radiusminorlinestyle>
    <radiusmajorfontstyle>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.8</value>
    	</strokecolor>
    	<strokewidth>0</strokewidth>
    	<fontsize>12</fontsize>
    </radiusmajorfontstyle>
    <radiusmajorlinestyle>
    	<fillcolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,.5</value>
    	</strokecolor>
    	<strokewidth>0.7</strokewidth>
    	<opacity>1</opacity>
    </radiusmajorlinestyle>
    <radiusmarkerunit>lm</radiusmarkerunit>
    <radiusmarkerlabelposition>RIGHT|BOTTOM</radiusmarkerlabelposition>
    <radiusmarkerlabelangleposition>0</radiusmarkerlabelangleposition>
    

    Angle Markers

    The angle markers are the lines from the center of the plot for each vertical angle.

    <anglefontstyle>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0.5</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.5</value>
    	</strokecolor>
    	<strokewidth>0</strokewidth>
    	<fontsize>12</fontsize>
    </anglefontstyle>
    <anglelinestyle>
    	<fillcolor>
    		<type>NULL_COLOR</type>
    		<value>0,0,0</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.5</value>
    	</strokecolor>
    	<strokewidth>0.5</strokewidth>
    	<opacity>1</opacity>
    </anglelinestyle>

    Zone Labels

    The angle markers are the lines from the center of the plot for each vertical angle.

    <showvalueLabels>true</showvalueLabels>
    	<valueLabelUnit> lm</valueLabelUnit>
    	<decimalRoundingValue>1</decimalRoundingValue>
    	<valueLabels>
    	<BH>BH 60-80</BH>
    	<BL>BL 0-30</BL>
    	<BM>BM 30-60</BM>
    	<BVH>BVH 80-90</BVH>
    	<FH>FH 60-80</FH>
    	<FL>FL 0-30</FL>
    	<FM>FM 30-60</FM>
    	<FVH>FVH 80-90</FVH>
    	<UH>UH 100-180</UH>
    	<UL>UL 90-100</UL>
    </valueLabels>
    <labelFontStyle>
    	<family>Tahoma</family>
    	<fillcolor>
    		<type>HSL</type>
    		<value>0,0,0.5</value>
    	</fillcolor>
    	<strokecolor>
    		<type>HSL</type>
    		<value>0,0,0.5</value>
    	</strokecolor>
    	<strokewidth>0</strokewidth>
    	<fontsize>12</fontsize>
    </labelFontStyle>

    Example

    <HeaderTableConfiguration>
    	<id>HeaderTable</id>
    	<Columnlabels/>
    	<IncludeKeys>TESTLAB,ISSUEDATE,OTHER,_CUSTOMONE</IncludeKeys>
    </HeaderTableConfiguration>

    Include Keys

    Specifies which keys from the IES file to display in the table. If left blank, all keys will be displayed.

    Example

    <IntensityTableConfiguration>
    	<id>IntensityTable</id>
    	<showcolumnheaders>true</showcolumnheaders>
    	<showrowheaders>true</showrowheaders>
    	<datanumerictype>1</datanumerictype>
    	<multiplier>true</multiplier>
    	<swaprows>0</swaprows>
    	<rangeclasses>
    		<entry>
    			<key>over0</key>
    			<value>0.0,0.1</value>
    		</entry>
    		<entry>
    			<key>over10</key>
    			<value>0.1,0.2</value>
    		</entry>
    	</rangeclasses>
    </IntensityTableConfiguration>

    Show Column Headers

    Controls the display of the column header values.

    Show Row Headers

    Controls the display of the row header values.

    Data Numeric Type

    ?

    Multiplier

    A number multiplied by the candela values in the IES file before they are displayed in the table.

    Swap Rows/Columns

    Set to 0 the columns are horizontal angles, set to 1, the columns are vertical angles.

    Range Classes

    If this keyword is included, each cell in the table will be assigned a class based on the intensity value matching one of the zones. The zones are defined by a class (key) and then a value range. These numbers are a % of the peak intensity. This class can then be styled. This allows you to highlight certain candela values.

    Example

    <ZonalEnergyTableConfiguration>
    	<id>ZonalSummaryTable</id>
    	<verticalzones>
    		<entry>
    			<key>0</key>
    			<value>30</value>
    		</entry>
    		<entry>
    			<key>0</key>
    			<value>40</value>
    		</entry>
    	</verticalzones>
    	<decimalRoundingAngles>0.01</decimalRoundingAngles>
    	<decimalRoundingValues>0.01</decimalRoundingValues>
    	<columnHeaderZoneCenters>Cone</columnHeaderZoneCenters>
    	<columnHeaderZoneRanges>Zone</columnHeaderZoneRanges>
    	<columnHeaderenergy>Lumens</columnHeaderenergy>
    	<columnHeaderenergyoverinput>% Lamp</columnHeaderenergyoverinput>
    	<columnHeaderenergyoveroutput>% Luminaire</columnHeaderenergyoveroutput>
    	<displayZoneCenters>false</displayZoneCenters>
    	<displayZoneRanges>true</displayZoneRanges>
    	<displayenergy>true</displayenergy>
    	<displayenergy>false</displayenergy>
    	<displayenergyoveroutput>true</displayenergyoveroutput>
    </ZonalEnergyTableConfiguration>

    Zones

    Custom zones are created by using the key as the start angle and the value as the end angle.

    Angle Rounding

    Decimal rounding for the angle display.

    Data Rounding

    Decimal rounding for the data display.

    Columns

    There are 5 columns that can be displayed and labeled. Zone Centers is the angle value at the zone center, Zone Range is the start-end range, Energy is the total lumens in the zone, Energy over Input is the lumens over the total lamp lumens, and Energy over Output is the lumens over the total output lumens.

    Example

    <RoadwayCUTableConfiguration>
    	<id>RoadwayCU</id>
    	<mountingHeights>1,2,3,4,5,6,7,8,9,10</mountingHeights>
    	<rowlabels>Mounting Heights,House Side CU,Street Side CU</rowlabels>
    	<decimalRounding>0.01</decimalRounding>
    </RoadwayCUTableConfiguration>

    Mounting Heights

    Specify the spacing over mounting height ratios to include.

    Row Labels

    Label used for each of the 3 rows, separated by a comma.

    Rounding

    Decimal rounding for the data display.

    Example

    <LuminaireLuminanceConfiguration>
    	<id>LuminaireLuminance</id>
    	<verticalangles>0,45,55,65,70</verticalangles>
    	<horizontalangles></horizontalangles>
    	<datanumerictype>1</datanumerictype>
    	<decimalRounding>0.01</decimalRounding>
    </LuminaireLuminanceConfiguration>

    Vertical Angles

    Vertical angles to display, empty will display all.

    Horizontal Angles

    Horizontal angles to display, empty will display all.

    Data Type

    ?

    Rounding

    Decimal rounding for the data display.

    Example

    <ConeofLightTableConfiguration>
    	<id>ConeOfLight</id>
    	<mountingheights>1,2,3,4,5,6,7,8,9,10</mountingheights>
    	<showMountHeights>true</showMountHeights>
    	<showFluxPerUnitArea>true</showFluxPerUnitArea>
    	<showBeam0180Diameter>true</showBeam0180Diameter>
    	<showBeam90270Diameter>true</showBeam90270Diameter>
    	<columnHeaderMountingHeight>Mtg H</columnHeaderMountingHeight>
    	<columnHeaderFluxPerUnitArea>Illuminance</columnHeaderFluxPerUnitArea>
    	<columnHeaderBeam0180Diameter>0-180 Beam Width</columnHeaderBeam0180Diameter>
    	<columnHeaderBeam90270Diameter>90-270 Beam Width</columnHeaderBeam90270Diameter>
    	<unitMountHeights>ft</unitMountHeights>
    	<unitFluxPerUnitArea>fc</unitFluxPerUnitArea>
    	<unitDiameter>ft</unitDiameter>
    	<decimalRoundingHeight>1</decimalRoundingHeight>
    	<decimalRoundingFluxPerUnitArea>1</decimalRoundingFluxPerUnitArea>
    	<decimalRoundingDiameter>1</decimalRoundingDiameter>
    </ConeofLightTableConfiguration>

    Mounting Heights

    Mounting Heights to display.

    Columns

    Columns for mounting height, illuminance, 0-180 and 90-270 beam diameter can be displayed, labeled, and rounded individually.

    Rounding

    Decimal rounding for the data display.

    Example

    <IndoorCUTableConfiguration>
    	<id>IndoorCU</id>
    	<rcr>1,2,3,4,5,6,7,8,9,10</rcr>
    	<reflectances>
    		<values>
    			<floor>0.2</floor>
    			<ceiling>0.8</ceiling>
    			<wall>0.4</wall>
    		</values>
    		<values>
    			<floor>0.0</floor>
    			<ceiling>0.2</ceiling>
    			<wall>0.7</wall>
    		</values>
    	</reflectances>
    	<valueType>0</valueType>
    	<rowHeaderReflectances>Reflectances</rowHeaderReflectances>
    	<rowHeaderFloorReflectance>rfc</rowHeaderFloorReflectance>
    	<rowHeaderCeilingReflectance>rcc</rowHeaderCeilingReflectance>
    	<rowHeaderWallReflectance>rw</rowHeaderWallReflectance>
    	<rowHeaderRCR>RCR</rowHeaderRCR>
    	<unitReflectances>%</unitReflectances>
    	<unitRcr></unitRcr>
    	<unitCu> lm</unitCu>
    	<decimalRoundingReflectances>1</decimalRoundingReflectances>
    	<decimalRoundingRcr>1</decimalRoundingRcr>
    	<decimalRoundingCu>.01</decimalRoundingCu>
    </IndoorCUTableConfiguration>

    RCRs

    Specify the RCRs to display (Room Cavity Ratio).

    Reflectances

    Specify the reflectance groups to display.

    Value Type

    0 displays % luminiare, 1 displays % lamp, 2 displays lumens.

    Labels

    Set unit labels and column labels for the table.

    Rounding

    Decimal rounding for the data display.

    Example

    <RoadwaySummaryConfiguration>
    	<html>
    		<![CDATA[
    			<p>Total Luminaire Optical Efficiency = %efficiency%%</p>
    		<p>Lateral Classification = %lateralclassification%%</p>
    		<p>Vertical Classification = %verticalclassification%%</p>
    		]]>
    	</html>
    	<decimalRoundingEfficiency>0.01</decimalRoundingEfficiency>
    	<decimalRoundingCandela>0.01</decimalRoundingCandela>
    	<decimalRoundingAngles>0.01</decimalRoundingAngles>
    	<decimalRoundingSide>0.1</decimalRoundingSide>
    </RoadwaySummaryConfiguration>

    HTML

    Within this section, you can use a CDATA element to write HTML that will be injected with the variable values you specify.

    Variables

    %efficiency% = Efficiency

    %lateralClassification% = IES lateral classification

    %verticalClassification% = IES vertical classification

    %cutoffClassification% = IES cutoff classification

    %bugRatingB% = B portion of the BUG rating

    %bugRatingU% = U portion of the BUG rating

    %bugRatingG% = G portion of the BUG rating

    %maxCandela% = peak candela value

    %maxHorizontal% = horizontal angle of peak candela

    %maxVertical% = vertical angle of peak candela

    %houseSide% = House side CU value

    %streetSide% = Street side CU Value

    Value Type

    Specify the rounding for each variable.

    Example

    <IndoorSummaryConfiguration>
    	<html>
    		<![CDATA[
    			<p>Total Luminaire Optical Efficiency = %efficiency%%</p>
    		<p>SC 0deg = %twoluminaires0%%</p>
    		<p>SC 90dg = %twoluminaires90%%</p>
    		<p>Beam Angle 0dg = %beamAngle0180%%</p>
    		<p>Beam Angle 90dg = %beamAngle90270%%</p>
    		]]>
    	</html>
    	<decimalRoundingEfficiency>0.01</decimalRoundingEfficiency>
    	<decimalRoundingLuminaire>0.01</decimalRoundingLuminaire>
    	<decimalRoundingBeamAngle>0.01</decimalRoundingBeamAngle>
    </IndoorSummaryConfiguration>

    HTML

    Within this section, you can use a CDATA element to write HTML that will be injected with the variable values you specify.

    Variables

    %efficiency% = Efficiency

    %twoluminaires0% = Spacing criterion in the 0/180 plane

    %twoluminaires90% = Spacing criterion in the 90/270 plane

    %beamangle0180% = Beam angle in the 0/180 plane

    %beamangle90270% = Beam angle in the 90/270 plane

    Value Type

    Specify the rounding for each variable.

    Conventions

    Having the correct Photometric Settings is critical to obtaining accurate results from Photopia. When you send a product for testing, the laboratory often determines the correct photometric angles, but when you are running Photopia it is something you must always be aware of. The angle sets are often broken down to vertical and horizontal angles, described below.

    Vertical Angles

    Vertical photometric angles go from directly below the fixture at 0 degrees to directly above at 180 degrees. The vertical angles that you choose are governed by the vertical distribution of your product. See the table below for information on the correct choice of vertical angles.

    Direct Indirect Direct/Indirect
    Distribution Light Directed Downward Light Directed Upward Light Directed Upward and Downward
    Orientation Beam in -z direction Beam in +z direction Beam in -z direction
    Vertical Angles 0-90 degrees 90-180 degrees 0-180 degrees

    Horizontal Angles

    The horizontal photometric angles that you will choose depend on the horizontal symmetric of your product. Fixtures can have four types of symmetry, as outlined in the table below. In Photopia it is important to choose the correct angle set based on the fixture symmetry because otherwise the output can become incorrect. Photopia always has data for the full 0-360 degrees, but averages down to the angle set that you choose. In the extreme case all 360 degrees are averaged together when you choose a horizontal angle of "0" only.

    Axially Symmetric Quadrilaterally Symmetric Bilaterally Symmetric Completely Asymmetric
    Examples Revolved Downlights Louvered Fluorescent "Asymmetric" Fluorescent Wallwash, Roadway Directional Tunnel Lighting
    Lamp Orientation Along y axis
    Outside U.S. Along x axis
    Beam Direction Along +y axis
    Horizontal Angles 0 degrees only 0-90 degrees 0-180 degrees 0-360 degrees

    photometric angle conventions - North America

    photometric angle conventions - World

    Distribution

    As Photopia has come to be more widely used in the architectural lighting industry, an increasing number of Photopia generated photometric files are being distributed by lighting manufacturers to their customers. By photometric files, we are referring to IES files in North America and TM-14 or EULUMDAT in other regions of the world.

    The original intent of Photopia was to allow manufacturers to develop new designs more quickly and more cost effectively by evaluating their design ideas on their computer instead of building and testing each and every design alternative. Once the predicted design performance met the desired criteria, a prototype was built and physically tested. If the physical test did not meet the design requirements, then modifications would be made until the requirements were met. In many cases, this involved troubleshooting the design to ensure it was built to specifications, so that it matched what was modeled in Photopia.

    Photopia is no longer only used in the development of new standard products. It is also used to model the performance of custom luminaires where the time from concept to installation does not allow for the classic product development cycle. Additionally, it is being used to model some existing products for which photometric testing was never before required. In these cases and others, some manufactures will distribute photometric files generated by Photopia.

    Whenever a photometric file generated by Photopia is distributed to a customer, the data should be as accurate as possible. The consequences of the photometric data not being accurate can be very costly if you are called out to fix an installed job. The distribution of inaccurate data also hurts Photopia's reputation and therefore its overall value. So it is in everyone's interest to ensure photometric data generated by Photopia is as accurate as possible.

    While Photopia's accuracy has been confirmed by our own experience as well as that of our customers, the accuracy is dependent upon several critical factors, including but not limited to the following:

  • You need to build exactly what you have modeled. If you compromise and choose a similar lamp or materials to the ones you will actually use, then you can expect differences between the predicted and measured photometry.
  • You need to understand your manufacturing tolerances for all of the parts in your design. You can create a range of Photopia models for the expected range of part configurations to gain a better understanding of the expected range of photometric performance.
  • You need to understand how to use Photopia well enough to properly setup your analysis so you get accurate results. This means properly orienting your luminaire, using the proper angle set in the candela distribution, using the proper number of reflections and the proper number of rays. See this link for more information about photometric standards.
  • Some issues such as thermal effects are completely ignored by Photopia, so if you have thermally sensitive lamps then you know that there will be differences between the simulated and measured efficiencies.
  • Anisotropic materials are only supported in Version 3.0. So if you use a material with a significant grained texture such as Alanod Miro 5, then the anisotropic properties need to be accurately modeled within Version 3.0.
  • For more information about the factors that affect the accuracy, see Appendix C of the User's Guide.

    Guidelines for Distributing Photometric Files:

    If you do distribute IES files generated by Photopia, then please follow this advice:

  • Leave the [TESTLAB] keyword in the IES file exactly how Photopia has defined it. This will ensure that your customers know that the file is the result of a simulation and not a physical test.
  • Remove all lines with the [OTHER] keyword. This information is useful to the optical designer, but not necessarily to your customers. This data could invite questions from your customers about details of the analysis that are not important. You can edit the IES file in Notepad.
  • You should review the total luminaire watts as defined in the IES file. This value is set according to the default lamp and assumed ballast wattage for the Photopia lamp model. If you have more accurate information about the total luminaire watts, then use it. See the end of Appendix B of the User's Guide for the IES file format.
  • Be sure to let your customers know that the data is simulated when you distribute the files either in your e-mail or on your website so that there is no misunderstanding about this issue later on.
  • Thank you for your attention to this issue.

    The Photopia Product Support Team

    Labs

    While Photopia is excellent for simulating photometry, there are often times when you must use a physical lab. These may include:

  • Confirmation of Photopia results
  • Significant thermal effects
  • Lamps or materials not available in Photopia Library
  • Physical testing required by code or specifying engineer
  • There are many labs available for photometric testing. We would recommend the following labs:

  • LightLab International - Phoenix, Arizona & Brisbane, Australia
  • Independent Testing Lab - Boulder, Colorado
  • LightLab Allentown - Allentown, Pennsylvania