Tiff file format for pre-processed quad-stereo sets

Image sets

Example tree of a single set:

1527256903_350165/
├── 1527256903_350165.kml
├── jp4 (source files directory)
│   ├── 1527256903_350165_0.jp4
│   ├── ...
│   ├── 1527256903_350165_3.jp4
│   ├── 1527256903_350165_4.jp4
│   ├── ...
│   └── 1527256903_350165_7.jp4
├── rating.txt
├── thumb.jpeg
└── v03 (model version)
    ├── 1527256903_350165-00-D0.0.jpeg
    ├── ...
    ├── 1527256903_350165-07-D0.0.jpeg
    ├── 1527256903_350165.corr-xml
    ├── 1527256903_350165-DSI_COMBO.tiff
    ├── 1527256903_350165-EXTRINSICS.corr-xml
    ├── 1527256903_350165-img1-texture.png
    ├── ...
    ├── 1527256903_350165-img2001-texture.png
    ├── 1527256903_350165-img_infinity-texture.png
    ├── 1527256903_350165.mtl
    ├── 1527256903_350165.obj
    ├── 1527256903_350165.x3d
    └── ml (directory with processed data files for ML)
        ├── 1527256903_350165-ML_DATA-08B-O-FZ0.05-OFFS-2.00000.tiff
        ├── 1527256903_350165-ML_DATA-08B-O-FZ0.05-OFFS-1.00000.tiff
        ├── 1527256903_350165-ML_DATA-08B-O-FZ0.05-OFFS0.00000.tiff
        ├── 1527256903_350165-ML_DATA-08B-O-FZ0.05-OFFS1.00000.tiff
        └── 1527256903_350165-ML_DATA-08B-O-FZ0.05-OFFS2.00000.tiff

where:

• *.jp4 - source files, 0..3 - quad stereo camera #1, 4..7 - quad stereo camera #2, and so on if there are more cameras in the system.
• *-D0.0.jpeg - disparity = 0, images are undistorted to a distortion polynom common for each image
• *.corr-xml - ImageJ plugin's settings file?
• *-DSI_COMBO.tiff - Disparity Space Image - tiff stack
• *-EXTRINSICS.corr-xml - extrinsic parameters of the multicamera system
• *.x3d, *.png - X3D format model with textures. The textures are shared with the OBJ format model
• *.obj, *.mtl, *.png - OBJ format model with textures
• *.tiff - TIFF stack of pre-processed images for ML

• *.kml, rating.txt, thumb.jpeg - files, related to the online viewer only

TIFF stacks for ML

• What's in each stack is described in the presentation for CVPR2018, pp.19-21:
  • 5 layers in the stack: [diagm-pair, diago-pair, hor-pairs, vert-pairs, other]
    • diagm-pair
    • diago-pair
    • hor-pairs
    • vert-pairs
    • other - encoded values
• The source files are processed using a plugin for ImageJ, the output file for each set is a tiff stack
• There are a few ways to view the stack:
  • Open with ImageJ - it has a native support for stacks, each stack has a name label stored (along with related xml info) in the ImageJ tiff tags. To read tiff tags in ImageJ, go Image > Show Info...
  • Use imagej_tiff.py from python3-imagej-tiff