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

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 message	SPDX 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/iestm2714	The 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.