Difference between revisions of "Eyesis4pi Post-Processing"

From ElphelWiki
Jump to: navigation, search
(Requirements)
(Requirements)
Line 17: Line 17:
 
* [http://www.imagemagick.org/script/index.php ImageMagick] - ''convert''.
 
* [http://www.imagemagick.org/script/index.php ImageMagick] - ''convert''.
 
* [http://php.net/ PHP]
 
* [http://php.net/ PHP]
* Download calibration kernels for the current Eyesis4Pi. Example kernels and sensor files can be found [http://eyesisbox.elphel.com/post-processing/calibration/ here]('''~78GB''', download everything).
+
* Get calibration kernels for the current Eyesis4Pi (come on a HDD with a camera).<!--Example kernels and sensor files can be found [http://eyesisbox.elphel.com/post-processing/calibration/ here]('''~78GB''', download everything).-->
* Download default-config.corr-xml from the same [http://eyesisbox.elphel.com/post-processing/calibration/ location].
+
* Get default-config.corr-xml (HDD).<!--from the same [http://eyesisbox.elphel.com/post-processing/calibration/ location].-->
* Download footage samples from [http://eyesisbox.elphel.com/post-processing/post-processing/src/ here].
+
* Download footage from the camera.<!--Download footage samples from [http://eyesisbox.elphel.com/post-processing/post-processing/src/ here].-->
 
* '''Processed''' files are available for downloading from [http://eyesisbox.elphel.com/post-processing/post-processing/imagej_processed/ here] (ready for the stitching step).
 
* '''Processed''' files are available for downloading from [http://eyesisbox.elphel.com/post-processing/post-processing/imagej_processed/ here] (ready for the stitching step).
 
* '''Stitched''' results are found [http://eyesisbox.elphel.com/post-processing/post-processing/results/ here].
 
* '''Stitched''' results are found [http://eyesisbox.elphel.com/post-processing/post-processing/results/ here].

Revision as of 14:09, 16 May 2016

Procedures

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

Requirements

  • Linux OS (Kubuntu preferably).
  • ImageJ.
  • Elphel ImageJ Plugins.
  • place loci_tools.jar into ImageJ/plugins/.
  • Place tiff_tags.jar into ImageJ/plugins/.
  • Hugin tools - enblend.
  • ImageMagick - convert.
  • PHP
  • Get calibration kernels for the current Eyesis4Pi (come on a HDD with a camera).
  • Get default-config.corr-xml (HDD).
  • Download footage from the camera.
  • Processed files are available for downloading from here (ready for the stitching step).
  • Stitched results are found here.

Instructions

  • Open terminal window:

cd /data/ImageJ
./run
  • Go to Plugins -> ImageJ-Elphel -> Eyesis Correction
Note: if plugin needs to be recompiled - Plugins -> Compile & Run. Find and select Eyesis_Correction.java.

Eyesis corrections plugin interface
  • Restore button -> browse for default_config.corr-xml (restores parameters for Configure correction)
  • 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)

Source file suffix - .jp4 if jp4 files are processed
Sensor files prefix - the format is <prefix>NN.calib-tiff - <prefix> is blank if the files are just NN.calib-tiff. For XXX-NN.calib-tiff the prefix would be XXX-
Sensor files suffix - default is .calib-tiff
Kernel files (sharp)/(smooth) prefix - same rule as for the sensor files
Kernel files (sharp)/(smooth) suffix - default is .kernel-tiff
Equirectangular maps prefix - same rule as for the sensor files
Equirectangular maps suffix - default is .eqr-tiff

  • Configure warping (Skip if the files already exist) -> 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