View source for PTX file format

==PTX in General==
PTX is an ASCII based format for saving point cloud data, typically from LIDAR scanners. Conceptually, information about each 3D point is saved as 4 or 7 values (depending on whether color information is stored or not). The coordinates for each point are saved untransformed in their own coordinate system and the transformation matrix is provided as a header of the file.
PTX cannot be used on unordered or unified clouds. All points, even those in shadows where no coordinates have been calculated, are saved.
===PTX Header===
The header of PTX file contains 10 following rows:
{| class="wikitable"
|-
! Line #
! colspan="4" |Data
|-
| 1
| colspan="4" style="text-align:left; padding-left:20px;" |Number of rows
|-
| 2
| colspan="4" style="text-align:left; padding-left:20px;" |Number of columns
|-
| 3
| style="width:50px; text-align:center;"| st1
| style="width:50px; text-align:center;"| st2
| style="width:50px; text-align:center;"| st3
| style="width:50px; text-align:center;"| -
|-
| 4
| style="width:50px; text-align:center;"| sx1
| style="width:50px; text-align:center;"| sx2
| style="width:50px; text-align:center;"| sx3
| style="width:50px; text-align:center;"| -
|-
| 5
| style="width:50px; text-align:center;"| sy1
| style="width:50px; text-align:center;"| sy2
| style="width:50px; text-align:center;"| sy3
| style="width:50px; text-align:center;"| -
|-
| 6
| style="width:50px; text-align:center;"| sz1
| style="width:50px; text-align:center;"| sz2
| style="width:50px; text-align:center;"| sz3
| style="width:50px; text-align:center;"| -
|-
| 7
| style="width:50px; text-align:center;"| r11
| style="width:50px; text-align:center;"| r12
| style="width:50px; text-align:center;"| r13
| style="width:50px; text-align:center;"| 0
|-
| 8
| style="width:50px; text-align:center;"| r21
| style="width:50px; text-align:center;"| r22
| style="width:50px; text-align:center;"| r23
| style="width:50px; text-align:center;"| 0
|-
| 9
| style="width:50px; text-align:center;"| r31
| style="width:50px; text-align:center;"| r32
| style="width:50px; text-align:center;"| r33
| style="width:50px; text-align:center;"| 0
|-
| 10
| style="width:50px; text-align:center;"| tr1
| style="width:50px; text-align:center;"| tr2
| style="width:50px; text-align:center;"| tr3
| style="width:50px; text-align:center;"| 1
|}
Lines 3-6 of the header are the position of point of origin and primary axes (X, Y, Z) of the scanner. Lines 7-10 are the transformation matrix, where lines 7-9 contain the rotation matrix and line 10 the translation vector. The values of lines 3-10 are double precision.
===PTX Body===
Each line following PTX header contains information about one measured point. If the point cloud does not include information about color the line has 4 values - (x, y, z, intensity). The x, y, z coordinates are usually in meters. Intensity is in decimal range [0, 1]. 
Point clouds containing color information have 3 additional numbers per line where the R, G, B values in the [0, 255] range are stated. Sometimes the color can be saved as floats in the range [0, 1]. 
==Photoneo PTX File==
In PTX files saved in PhoXi Control the header contains identity matrices in place of the scanner coordinate system and transformation matrix. For any chosen coordinate space the header has the following look:
{| style="width:300px; background:#f9f9f9; border: 1px solid #f4f4f4;" 
|- 
| <kbd>1544</kbd>
|-
| <kbd>2064</kbd>
|-
| <kbd>0 0 0</kbd> 
|-
| <kbd>1 0 0</kbd>
|-
| <kbd>0 1 0</kbd>
|-
| <kbd>0 0 1</kbd>
|-
| <kbd>1 0 0 0</kbd>
|-
| <kbd>0 1 0 0</kbd>
|-
| <kbd>0 0 1 0</kbd>
|-
| <kbd>0 0 0 1</kbd>
|}
The positions of the points are saved transformed in the chosen coordinate space (camera space, marker space, etc.). The values of the coordinates are in millimeters. The 4th number that usually contains intensity is always set to 1 and the greyscale information from texture is instead saved as the RGB values in the three following numbers.

[[File:PTX-options.PNG|thumb|right|Saving options for PTX files.]]PhoXi Control allows to save the PTX file in five ways with additional option to scale the coordinates by a chosen factor:
# Texture
# Flip X
# Flip Y
# Flip Z
# Swap YZ
===Texture===
The texture option saves the greyscale information as RGB values. If this option is not selected the last three numbers in the lines following the header are set to 1.
===Flip X===
This option saves the X value of point coordinate as their negative.
{| style="width:300px; background:#f9f9f9; border: 1px solid #f4f4f4;" 
|-
! style="text-align:left;"| Original
|- 
| <kbd>-96.8908 -159.717 49.0486 1 6 6 6</kbd>
|}

{| style="width:300px; background:#f9f9f9; border: 1px solid #f4f4f4;" 
|-
! style="text-align:left;"| Flip X
|-
| <kbd>96.8908 -159.717 49.0486 1 6 6 6</kbd>
|}
===Flip Y===
This option saves the Y value of point coordinates as their negative.
{| style="width:300px; background:#f9f9f9; border: 1px solid #f4f4f4;" 
|-
! style="text-align:left;"| Original
|- 
| <kbd>-96.8908 -159.717 49.0486 1 6 6 6</kbd>
|}

{| style="width:300px; background:#f9f9f9; border: 1px solid #f4f4f4;" 
|-
! style="text-align:left;"| Flip Y
|-
| <kbd>-96.8908 159.717 49.0486 1 6 6 6</kbd>
|}
===Flip Z===
This option saves the Z value of point coordinates as their negative.
{| style="width:300px; background:#f9f9f9; border: 1px solid #f4f4f4;" 
|-
! style="text-align:left;"| Original
|- 
| <kbd>-96.8908 -159.717 49.0486 1 6 6 6</kbd>
|}

{| style="width:300px; background:#f9f9f9; border: 1px solid #f4f4f4;" 
|-
! style="text-align:left;"| Flip Z
|-
| <kbd>-96.8908 -159.717 -49.0486 1 6 6 6</kbd>
|}
===Swap YZ===
This option changes the position of Y and Z coordinates in the line. When this number is selected the numbers in line are in the following order: X, Z, Y, intensity, R, G, B.
{| style="width:300px; background:#f9f9f9; border: 1px solid #f4f4f4;" 
|-
! style="text-align:left;"| Original
|- 
| <kbd>-96.8908 -159.717 49.0486 1 6 6 6</kbd>
|}

{| style="width:300px; background:#f9f9f9; border: 1px solid #f4f4f4;" 
|-
! style="text-align:left;"| Swap YZ
|-
| <kbd>-96.8908 49.0486 -159.717 1 6 6 6</kbd>
|}
===Scale===
Scale allows to multiply the X, Y, Z coordinates by a selected number. By default this number is set to 1 and the X, Y, Z are in millimeters.
{| style="width:300px; background:#f9f9f9; border: 1px solid #f4f4f4;" 
|-
! style="text-align:left;"| Scale 1.0000
|- 
| <kbd>-96.8908 -159.717 49.0486 1 6 6 6</kbd>
|}

{| style="width:300px; background:#f9f9f9; border: 1px solid #f4f4f4;" 
|-
! style="text-align:left;"| Scale 1000.0000
|-
| <kbd>-96890.8 -159717.0 49048.6 1 6 6 6</kbd>
|}