Eyesis4pi Post-Processing

From ElphelWiki
Revision as of 17:04, 30 August 2012 by Oleg (talk | contribs)
Jump to: navigation, search

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 convert them into jpegs, in terminal:

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