IESNA TM-27-2014 IES Standard Format for the Electronic Transfer of Spectral Data.pdf

1、IES TM-27-14IES Standard Format forthe Electronic Transfer of Spectral Data IES TM-27-14IES Standard Format for the Electronic Transfer of Spectral DataPublication of this reporthas been approved by IES.Suggestions for revisionsshould be directed to IES.Prepared by:The File Format Subcommittee of th

2、e IES Computer CommitteeIES TM-27-14Copyright 2014 by the Illuminating Engineering Society of North America.Approved by the IES Board of Directors, June 9, 2014 , as a Transaction of the Illuminating Engineering Society of North America.All rights reserved. No part of this publication may be reprodu

3、ced in any form, in any electronic retrieval system or otherwise, without prior written permission of the IES.Published by the Illuminating Engineering Society of North America, 120 Wall Street, New York, New York 10005.IES Standards and Guides are developed through committee consensus and produced

4、by the IES Office in New York. Careful attention is given to style and accuracy. If any errors are noted in this document, please forward them to Rita Harrold, Director of Technology, at the above address for verification and correction. The IES welcomes and urges feedback and comments. ISBN # 978-0

5、-87995-295-2Printed in the United States of America.DISCLAIMERIES publications are developed through the consensus standards development process approved by the American National Standards Institute. This process brings together volunteers representing varied viewpoints and interests to achieve cons

6、ensus on lighting recommendations. While the IES administers the process and establishes policies and procedures to promote fairness in the development of consensus, it makes no guaranty or warranty as to the accuracy or completeness of any information published herein.The IES disclaims liability fo

7、r any injury to persons or property or other damages of any nature whatsoever, whether special, indirect, consequential or compensatory, directly or indirectly resulting from the publication, use of, or reliance on this documentIn issuing and making this document available, the IES is not undertakin

8、g to render professional or other services for or on behalf of any person or entity. Nor is the IES undertaking to perform any duty owed by any person or entity to someone else. Anyone using this document should rely on his or her own independent judgment or, as appropriate, seek the advice of a com

9、petent professional in determining the exercise of reasonable care in any given circumstances.The IES has no power, nor does it undertake, to police or enforce compliance with the contents of this document. Nor does the IES list, certify, test or inspect products, designs, or installations for compl

10、iance with this document. Any certification or statement of compliance with the requirements of this document shall not be attributable to the IES and is solely the responsibility of the certifier or maker of the statement.IES TM-27-14Prepared by the File Format Subcommittee of the IES Computer Comm

11、itteeTM-27-14 Working GroupJianzhong Jiao, Technical CoordinatorIES File Format Sub-CommitteeJianzhong Jiao, ChairIES Computer CommitteePaul Ericson, ChairI. Ashdown E. BretschneiderR. DaubachM. Gauvin R. KelleyR. LeeS. RobledoI. AshdownW. BrandenburgD. Chabaud*O. DrossS. GangadharaK. GarciaM. Gauvi

12、nG. GregoryD. HansenK. HaraguchiG. HauserR. KelleyR. KoshelJ. Muschaweck*I. AshdownW. DauD. DiLaura*M. GauvinG. HauserR. Heinisch*R. KelleyR. King L. LivingstonJ. McHugh*A. MorD. RandolphK. Reifers*T. SaemischD. SmithJ. Zhang* Advisory Member* Honorary MemberIES TM-27-14IES TM-27-14ContentsIntroduct

13、ion.11.0 Scope .12.0 Normative References 13.0 Definitions13.1. Bandpass Correction 13.2. Document13.3. Spectral Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14.0 XML Schema for Spectral Data Transfer 24.1. Hea

14、der Element .24.1.1. Manufacturer Element .24.1.2. Catalog Number Element.24.1.3. Description Element .24.1.4. Document Creator Element .24.1.5. Unique Identifier Element .24.1.6. Measurement Equipment Element 24.1.7. Laboratory Element .24.1.8. Report Number Element .34.1.9. Report Date Element 34.

15、1.10. Document Creation Date Element 34.1.11. Comments Element .34.2. Spectral Distribution Element34.2.1. Spectral Quantity Element 34.2.2. Reflection Geometry Element34.2.3. Transmission Geometry Element .34.2.4. Bandwidth FWHM Element .34.2.5. Bandwidth Corrected Element .34.2.6. Spectral Data 34

16、.3. XML Schema .55.0 Branding Logo and Name6Informative References6Annex A Sample XML Document.7Annex B Sample XSL For CSV Presentation .7Annex C Sample XSL for HTML Presentation.8IES TM-27-141IES TM-27-14INTRODUCTIONThe architectural lighting community has long relied on standardized file formats f

17、or the electronic trans-fer of photometric data and related information. These file formats include ANSI/IESNA LM-63-02/R20081, EULUMDAT3, and CIBSE TM-14.2Recognizing the need to distribute non-photomet-ric data related to luminaires, the IES Computer Committee developed IES LM-74-05 IES Standard F

18、ile Format for the Electronic Transfer of Luminaire Component Data4.There is however also a need to distribute spectral data. Such data is pertinent, but not limited to, the spectral radiant flux of lamps and other light sources, the spectral transmittance of color filters, and the spectral reflecta

19、nce of paint and other finishes. This data may be obtained when testing a light source, luminaire or material and may then be used in light-ing application software, rendering software, analy-sis software or optical design software.Generally, the document will contain a single spec-tral power distri

20、bution. Future formats that contain multiple spectra, including spectra as a function of angle are planned, with this document being a stepping stone in that direction, while also creating a format that still has widespread usability across industries.The data is formatted in accordance with W3C Ext

21、ensible Markup Language (XML) 1.1 Recommendation and the W3C XML Schema Definition Language (XSD). This allows end users to utilize and view the data directly without the need for proprietary software.In the event of any ambiguity or discrepancy with respect to the description of XML or XML Schema i

22、n this document, the W3C Recommendations take precedence.1.0 SCOPEThis document specifies an electronic (XML based) data format for the transfer of spectral data. This doc-ument may be used for the transfer of spectral data of optical radiation including light sources, lamps, and luminaires, as well

23、 as reflectance and transmit-tance spectra of materials. The document is limited to containing a single spectral data set.Details about the XML document format, XML Schema, XSLT transforms and more can be found at the W3Cs website, the authority for the XML document format. This document is intended

24、 as a description of a spe-cific implementation of an XML document and not as a tutorial on the XML document format itself.2.0 NORMATIVE REFERENCES2.1 ANSI/IES RP-16-10 Nomenclature and Definitions for Illuminating Engineering. New York: Illuminating Engineering Society of North America, 2010. 2.2 C

25、IE 15:2004. Colorimetry. Commission Internationale de lEclairage, Vienna, Austria.2.3 W3C Extensible Markup Language (XML) 1.0, Fifth Edition (http:/www.w3.org/TR/REC-xml).2.4 W3C XML Schema Definition Language (XSD) 1.1 Part 1: Structures (http:/www.w3.org/TR/xmlschema11-1).2.5 W3C XML Schema Defin

26、ition Language (XSD) 1.1 Part 2: Datatypes (http:/www.w3.org/TR/xmlschema11-2).3.0 DEFINITIONS3.1 Bandpass CorrectionThe correction of measured spectral data to account for the bandpass width of the detector element and the scanning interval. There are several methods of bandpass correction, and thi

27、s correction is usu-ally performed either in the measurement equipment itself or by the data processing software.3.2 DocumentInstead of using “file” as the description for this data storage mechanism, the term document will be used. Document is more appropriate when the information may not actually

28、exist as a physical file, but may be generated dynamically and transmitted. 3.3 Spectral DataRadiometric power as a function of wavelength, typi-cally represented as a table of wavelength and cor-responding radiometric power.2IES TM-27-144.0 XML SCHEMA FOR SPECTRAL DATA TRANSFERThe spectral power di

29、stribution XML document is defined in terms of the W3C XML Schema presented in Section 4.3.Descriptions of the intended use of each XML ele-ment and attribute in the schema are contained in Sections 4.1 and 4.2.The XML document is separated into a Header Element (Sections 4.1) and a Spectral Distrib

30、ution Element (Section 4.2). The Header element contains all generic information about the data set; the Spectral Distribution Element contains the specific data.4.1 Header ElementThe Header element is the parent of the document header section.This section contains information that is not specific t

31、o the spectral data. Many of the header elements are optional. The intent is for the document to contain as much header information as possible so that the ori-gin and purpose of the document is clear in the future. Specific elements may not be appropriate for a given document. For example, a docume

32、nt containing stel-lar spectra wouldnt need the Manufacturer element, but may still have the Laboratory element. Header Elements are listed in Table 1.4.1.1 Manufacturer Element The optional Manufacturer element identifies the manufacturer of the device under test.4.1.2 Catalog Number Element The op

33、tional CatalogNumber element identifies the manufac-turers product catalog number.4.1.3 Description Element The required Description element contains a text description of the spectral data in the document.4.1.4 Document Creator Element The required DocumentCreator element identifies the creator of

34、the document, which may be a test lab, a research group, a standard body, a company or an individual.4.1.5 Unique Identifier Element The optional UniqueIdentifier element contains a unique identifier to the product under test or the spectral data in the document.4.1.6 Measurement Equipment Element T

35、he optional MeasurementEquipment element contains a description of the equipment used to measure the spectral data.4.1.7 Laboratory Element The optional Laboratory element identifies the testing laboratory name that performed the spectral data measurements. If the data is generated and not tested at

36、 a laboratory, this field shall contain the name of the company generat-ing the data.Table 1: Header Element FieldsElement Description Element Name Data Type Required Document SectionManufacturer Manufacturer String No 4.1.1Catalog Number CatalogNumber String No 4.1.2Description Description String Y

37、e s 4.1.3Document Creator DocumentCreator String Ye s 4.1.4Unique Identifier UniqueIdentifier String No 4.1.5Measurement Equipment MeasurementEquipment String No 4.1.6Laboratory Laboratory String No 4.1.7Report Number ReportNumber String No 4.1.8Report Date ReportDate XML DateTime No 4.1.9Document C

38、reation Date DocumentCreationDate XML DateTime Ye s 4.1.10Comments Comments String No 4.1.113IES TM-27-144.1.8 Report Number Element The optional ReportNumber element identifies the testing labora-tory report number.4.1.9 Report Date Element The optional ReportDate element identifies the testing lab

39、oratory report date using the XML DateTime Data Type, YYYY-MM-DDThh:mm:ss.4.1.10 Document Creation Date Element The required DocumentCreationDate element identifies the document creation date using the XML DateTime Data Type, YYYY-MM-DDThh:mm:ss.4.1.11 Comments Element The optional Comments element

40、provides additional information relating to the tested and reported data.4.2 Spectral Distribution Element The SpectralDistribution element is the parent of the spectral distribution data. This element contains information that is specific to the spectral data. Elements are detailed in Table 2.4.2.1

41、 Spectral Quantity Element The SpectralQuantity attribute provides the quantity of measurement for each element of the spectral data. Valid SpectralQuantity attributes are identified in Table 3.All wavelengths shall be specified in nanometers. Relative measurements (i.e., absorptance, trans-mittance

42、, reflectance, R-Factor, T-Factor and rela-tive) shall be specified in a range 0-1.0, not as a percentage.4.2.2 Reflection Geometry Element Spectral reflectance factors require specification of the geo-metric conditions. Valid ReflectionGeometry attri-butes in accordance with CIE 15:2004, Colorimetr

43、y are in Table 4.4.2.3 Transmission Geometry Element Spectral transmittance factors require specification of the geo-metric conditions. Valid TransmissionGeometry attri-butes in accordance with CIE 15:2004, Colorimetry are in Table 5.4.2.4 Bandwidth FWHM Element The optional BandwidthFWHM attribute

44、specifies the spectroradi-ometer full-width half-maximum bandwidth in nano-meters.4.2.5 Bandwidth Corrected Element The optional BandwidthCorrected attribute specifies that bandwidth correction has been applied to the measured data.If necessary, the bandwidth correction method should be documented i

45、n the optional Comments element (Section 4.1.11).4.2.6 Spectral Data The SpectralData element specifies the spectral data for the identified wave-length. The element contains the value to be report-ed and there is an attribute for the wavelength this value occurs at.Table 2: Spectral Distribution Fi

46、eldsElement Description Element Name Data Type Required Document SectionSpectral Quantity SpectralQuantity String Ye s 4.2.1Reflection Geometry ReflectionGeometry String Yes, only if Spectral Quantity = “reflectance”4.2.2Transmission Geometry TransmissionGeometry String Yes, only if Spectral Quantit

47、y = “transmittance”4.2.3Bandwidth FWHM BandwidthFWHM Decimal No 4.2.4Bandwidth Corrected BandwidthCorrected Boolean No 4.2.5Spectral Data SpectralData String Ye s 4.2.64IES TM-27-14Table 3: Spectral Quantity Element AttributesAttribute Spectral Quantity Symbols Units“flux” Radiant flux Wnm-1“absorpt

48、ance” Absorptance“transmittance” Transmittance“reflectance” Reflectance“intensity” Radiant intensity Wsr-1nm-1“irradiance” Irradiance Wm-2nm-1“radiance” Radiance Wm-2nm-1“exitance” Radiant exitance Wm-2nm-1“R-Factor” Reflectance factor nm-1“T-Factor” Transmittance factor nm-1“relative” Relative spec

49、tral power distribution nm-1“other” User-specified in Comments in 4.1.11User-specified in Comments in 4.1.11Table 4: Reflection Geometry Element AttributesAttribute Geometry“di:8” Diffuse / eight-degree, specular component included“de:8” Diffuse / eight-degree, specular component excluded“8:di” Eight-degree / diffuse, specular component included“8:de” Eight-degree / diffuse, specular component excluded“d:d” Diffuse / diffuse“d:0” Alternative diffuse“45a:0” Forty-five degree annular / normal“45c:0” Forty-five degree circumferential / normal“0:45a” Normal / forty-five degree