The DLC’s LUNA Pre-submission tool validates .ies files and .spdx documents against the LUNA Technical Requirements as well as against many of the ANSI/IES LM-63 requirements, for .ies files, and many of the ANSI/IES TM-27 requirements for .spdx documents. This tool is was created to assist submitters in preparing their data files for submittal to the LUNA program, and to be able to successfully generate spatial and spectral distribution images to submit in their LUNA application. Missing information or typos in the data will cause the tool to return an error message.  Please see the following most common errors from submitted files that prevent the LUNA Pre-submission tool from generating SPD or luminous intensity images.

Common .ies file errors

Error messageIES file validation error
[TESTDATE] keyword is required by LUNA V1, and was not found in the submitted file. This must be resolved before a photometric image can be created.
 
[LUMINAIRE] keyword is required by LUNA V1, and was not found in the submitted file. This must be resolved before a photometric image can be created.
.ies files that are missing required keywords, or have blank keywords, will produce an error indicating which keyword is missing or blank. Per the LUNA V1.0 Technical Requirements, the following keywords are required and may not be blank: [TEST], [TESTLAB], [TESTDATE], [MANUFAC], [LUMCAT], [LUMINAIRE], and [ISSUEDATE]. The following keywords are frequently missing:

[TESTDATE] is a commonly missing keyword. This is a required keyword in the LUNA V1.0 Technical Requirements and indicates the date the photometric report was generated.

[LUMINAIRE] is a commonly missing keyword. This is a required keyword in the LUNA V1.0 Technical Requirements and must provide a description of the luminaire.
Luminous opening length and/or width must not be zero. This must be resolved before a photometric image can be created.The length or width of the luminous opening is zero. Per the SSL V5.1 and LUNA V1.0 Technical Requirements, neither the length nor width of the luminous opening may be zero.
Submitted .ies files must be in LM-63-2002 or LM-63-2019 format.The .ies file is not in the required 2002 or 2009 format. The very first line in the IES file must be “IESNA: LM-63-2002” or “IES:LM-63-2019”. Files that begin with the line “IESNA: LM-63-1995” will not be accepted.
Intensity scaling is not allowed by LUNA V1, and the multiplier value must be 1.0. This must be resolved before a photometric image can be created.The Candela Multiplier value must be 1 (or 1.0). Intensity scaling is not allowed per the SSL V5.1 and LUNA V1.0 Technical Requirements.

Common .spdx file errors

In general, typos in the element names are a leading cause of errors. Specifically, if there is a typo in the opening or closing element name that doesn’t occur on the other side, the file is not recognized as a valid XML file, and an error will be generated that says “The uploaded file does not comply with the IESTM2714 document format and therefore cannot be used with this pre-submission tool. Please refer to the TM-27 standard and DLC supplemental documentation for more information on how to format your .spdx document.” The example below shows “SpectralQuantity” is entered as “SpectalQuantity” in the closing side instead:

If there is a typo on both the opening and closing sides of the element name in the example below “SpectralQuantity” is misspelled as “SpectalQuantity”, the element will be shown as missing.

When a typo causes an error, the file cannot be evaluated until the typo is fixed. This may result in submitters having to first fix the typo(s), and then addressing additional validation errors that may arise from an erroneous value within the file.

These are additional common errors that may occur:

Error messageSPDX file validation error
DocumentCreator is required by LUNA V1, and was not found in the correct location in the submitted file. This must be resolved before an SPD image can be created.
 
DocumentCreationDate is required by LUNA V1, and was not found in the correct location in the submitted file. This must be resolved before an SPD image can be created.
.spdx files that are missing required header elements, or have blank header elements, will produce an error indicating which element is missing or blank. Common header element errors include:

The <DocumentCreator> element is missing or blank. This is a required keyword in TM-27 and in the LUNA V1 Technical Requirements and indicates the creator of the .spdx file (e.g. the lab name, company name, etc.). This error may also occur if the element name is misspelled or if substituted with another undefined element (e.g. the file includes a <FileCreator> element instead of a <DocumentCreator> element.

The <DocumentCreationDate> element is missing or blank. This is a required keyword in TM-27 and in the LUNA V1.0 Technical Requirements and indicates the .spdx file creation date. It should be in YYYY-MM-DD:hh:mm:ss format per TM-27.
The URL in the IESTM2714 element is incorrect. For the SPD to be plotted, the URL must be http://www.ies.org/iestm2714The TM-27 XML schema URL is incorrect. Per TM-27, the XML Schema URL must be http://www.ies.org/iestm2714Schema. Here is an example of the wrong schema URL:
SpectralQuantity is required by LUNA V1, and was not found in the correct location in the submitted file. This must be resolved before an SPD image can be created.The Spectral Quantity element <SpectralQuantity> is often missing. This error often occurs because the element name is misspelled in both the opening and closing elements or is missing.
The Spectral Quantity must be either Flux or Relative. This must be resolved before an SPD image can be created.The Spectral Quantity <SpectralQuantity> element value is incorrect. The <SpectralQuantity> element value must be “flux” or “relative” for the LUNA Pre-submission tool to generate images. If the spectral quantity is invalid, an error will be produced. In the example below, the spectral quantity is “5nm” which causes an error:
Multiple sets of spectral data were found in the submitted file. For an SPD image to be created, the file must contain one set of data with wavelengths ranging from smallest to largest.

Multiple sets of spectral data were found in the submitted file. For an SPD image to be created, the file must contain one set of data with wavelengths ranging from smallest to largest.

The uploaded file does not comply with the IESTM2714 document format and therefore cannot be used with this pre-submission tool. Please refer to the TM-27 standard and DLC supplemental documentation for more information on how to format your .spdx document.
These are common spectral data errors:

The .spdx file contains more than one array of wavelength data in the <SpectralDistribution> element. Each .spdx file can only have one data set in the <SpectralDistribution> element. Multiple data sets in one file will generate an error.

The last wavelength value in the <SpectralData> element array is zero, leading to the error on the right. The last wavelength value must be 780 nm or higher. Here is an example where the wavelength values increase by one nm until 847 nm, and then an additional <SpectralData> line at 0 nm is added, causing an error:


The wavelength value inside the opening <SpectralData> element is not bracketed by quotation marks, leading to the error on the right. The wavelength value must be bracketed by quotation marks (see the example above for a correct way to represent the wavelength value).  Here is an example of incorrect wavelength value representation, leading to an error:

For errors that are not listed or for other questions about using the LUNA Pre-submission Tool, please contact us at applications@designlights.org.