Difference between revisions of "Eyesis4pi Post-Processing"

Revision as of 09:01, 5 October 2012

Procedures

• Applying pixel mapping information
• Aberration correction
• Distortion correction
• Vignetting correction
• Color correction
• Denoising
• Sharpening

Requirements

• Linux OS (Kubuntu preferably).
• ImageJ.
• Elphel ImageJ Plugins.
• Put loci_tools.jar into ImageJ/plugins/.
• Put tiff_tags.jar into ImageJ/plugins/.
• Hugin tools - enblend.
• ImageMagick - convert.
• PHP
• Download calibration kernels for the current Eyesis4Pi. Example kernels and sensor files can be found here(~78GB, download everything).
• Download default-config.corr-xml from the same location.
• Download footage samples from here.
• Processed files are available for downloading from here (ready for the stitching step).
• Stitched results are found here.

Instructions

• Launch ImageJ -> Plugins -> Compile & Run. Find and select Eyesis_Correction.java.

Eyesis corrections plugin interface

• Restore button -> browse for default_config.corr-xml.
• Configure correction button - make sure that the following paths are set correctly (if not - mark the checkboxes - a dialog for each path will pop up):

Source files directory                - directory with the footage images
Sensor calibration directory          - [YOUR-PATH]/calibration/sensors
Aberration kernels (sharp) directory  - [YOUR-PATH]/calibration/aberration_kernels/sharp
Aberration kernels (smooth) directory - [YOUR-PATH]/calibration/aberration_kernels/smooth
Equirectangular maps directory(may be empty) - [YOUR-PATH]/calibration/equirectangular_maps (it should be created automatically if the w/r rights of [YOUR-PATH]/calibration allow)

• Configure warping -> rebuild map files - this will create maps in [YOUR-PATH]/calibration/equirectangular_maps. Will take ~5-10 minutes.
• Select source files -> select all the footage files to be processed.
• Process files to start the processing. Depending on the PC power can take ~40 minutes for a panorama of (24+2) images.
• After processing is done there is only the blending step. It can be launched manually or from the WebGUI:
  • WebGUI
  • Manual blending: the following script scans directory for *.tiffs from ImageJ and uses enblend(to stitch into 16-bit tiffs) and converts them into jpegs, in terminal:

php stitch.php [source_directory] [destination_directory]
- no slashes in the end of the paths

Links

• Eyesis4Pi Main Article
• Workflow
• User Guide - Recording
• User Guide - Post-Processing: Footage Procedures
• User Guide - Post-processing: ImageJ
• Data Structure Description
• Calibration Process