TXT File Format

As an example, TXT file can be generated with a camera.

Note: The format of the ASCII file is the same for import and export. ASCII data are converted to XMP ones.

MapType
ValueType Intensitytype UnitType AxisUnit XMin XMax YMin YMax NbX NbY WMin WMax NbW (Spectral map) SourceNb Ratio0 Ratio1... RatioNb (Extended map) x0y0 x1y0 x2y0 ... xny0 x0y1 x1y1 x2y1 ... xny1 x0y2 x1y2 x2y2 ... xny2 ... x0yn x1yn x2yn ... xnyn

Elements of the .txt file are related to a specific value determining their types.


Map Type
0 = Basic Map 1 = Laser Map 2 = Spectral Map 3 = Extended Map 4 = Unknown Map	5 = Gain Matrix Map 6 = Rays Map 7 = FTM Map 8 = Speos360 Map


Value Type
0 = Irradiance 1 = Intensity 2 = Radiance 3 = Visual 4 = Sel 5 = Laser Phase 6 = Laser Phase Plane 7 = Directional Irradiance 8 = Gain 9 = Wave Front 10 = FTM 11 = RP 12 = Power Density	13 = Population 14 = Temperature 15 = Angle 16 = Curvature 17 = Curvature Product 18 = Percentage 19 = Unknown 20 = Refractive Power 21 = Fly Through 22 = Colorimetric Error 23 = Conoscopic Radiance 24 = SNR 25 = SNR Intensity	26 = SNR Directional Irradiance 27 = Precision 28 = Precision Intensity 29 = Precision Directional Irradiance 30 = Distance 31 = Eye Sensor Radiance 32 = Spherical Probability Density 33 = RSE 34 = RSE Intensity 35 = Exposure


Intensity Type
0 = Optis Intensity Note: The OPTIS Intensity XMP map type is in end of life as of version 2023 R2, and no longer available in the user interface 1 = SAE Type A 2 = SAE Type B 3 = Conoscopic

Warning: If ValueType is not equal to 1, the IntensityType value is not taken into account.

Warning: For Intensity Conoscopic format, you must be aware that transformation takes into account following formulas. TetaX = Teta.cos Phi TetaY = Teta.sin Phi

For intensity maps, XMin XMax YMin YMax has to be replaced by ThetaXMin ThetaXMax ThetaYMin ThetaYMax.


Unit Type
0 = Radiometric 1 = Photometric 2 = Temperature 3 = Unknown 4 = FTM 5 = Degree	6 = Inverse Meter 7 = Inverse Square Meter 8 = Percent 9 = Diopter 10 = Meter 11 = 1/sr

Warning: When exporting a XMP map to a .txt file, the prefix of the unit of measure may differ between the xmp data and the data in the .txt file. Example: the xmp map unit is in millidiopter and the .txt file unit is in diopter.


Axis Unit
0 = Default 1 = Millimeter 2 = Degree 3 = Radian 4 = Feet 5 = Micrometer 6 = Nanometer	7 = Meter 8 = Percent 9 = dB 10 = Invert Millimeter 11 = No Unit 12 = Wave

Advanced:

Before exporting data to a .txt file, you have to deactivate the filtering and set the level as default (max value put as max to have the complete dynamic).

In case of an export from a colorimetric map, data are split as follows: X (raw value), Y (luminance), Y2 (radiometric), Z (raw value).

Note: Chromatic values expressed in the colorimetric system XYZ provided in the Measures tool are normalized, unlike th exported value that are raw data. The relation between the normalized and raw values is:

Note: If needed you can also transform these data into xyY coordinates format, following this formula: - x= X(raw) / (X+Y+Z) (raw) - y= Y(raw) / (X+Y+Z) (raw) - Y= Y(raw) / Luminance max of the map * 100