Difference between revisions of "Eyesis4pi Post-Processing"

From ElphelWiki
Jump to: navigation, search
(Instructions)
 
(27 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
==Procedures==
 +
* Applying pixel mapping information
 +
* Aberration correction
 +
* Distortion correction
 +
* Vignetting correction
 +
* Color correction
 +
* Denoising
 +
* Sharpening
 +
 
==Requirements==
 
==Requirements==
 
* Linux OS (Kubuntu preferably).
 
* Linux OS (Kubuntu preferably).
* [http://rsbweb.nih.gov/ij/download.html ImageJ].
+
* [[Elphel_Software_Kit_for_Ubuntu#ImageJ_and_Elphel_plugins_for_imageJ|ImageJ and Elphel plugins]] (most of the post-processing).
* [[Elphel_Software_Kit_for_Ubuntu#ImageJ_and_Elphel_plugins_for_imageJ|Elphel ImageJ Plugins]].
+
* [http://hugin.sourceforge.net/ Hugin tools] - ''enblend'' (for simple stitching).
* Put [http://eyesisbox.elphel.com/post-processing/ImageJ/plugins/loci_tools.jar loci_tools.jar] into '''ImageJ/plugins/'''.
+
* [http://www.imagemagick.org/script/index.php ImageMagick] - ''convert'' (for converting).
* Put [http://eyesisbox.elphel.com/post-processing/ImageJ/plugins/tiff_tags.jar tiff_tags.jar] into '''ImageJ/plugins/'''.
 
* [http://hugin.sourceforge.net/ Hugin tools] - ''enblend''.
 
* [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 (come on a HDD with a camera).<!--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].
 
+
-->
 
 
  
 
==Instructions==
 
==Instructions==
* Launch ImageJ -> Plugins -> Compile & Run. Find and select '''Eyesis_Correction.java'''.
+
* Launch ImageJ from Eclipse
 +
<font size='2'>
 +
* Go to '''Plugins''' -> '''ImageJ-Elphel''' -> '''Eyesis Correction'''
 +
'''Note''': if plugin needs to be recompiled - '''Plugins''' -> '''Compile & Run'''. Find and select '''Eyesis_Correction.java'''.
 +
</font>
 
{|
 
{|
 
|- valign="top"
 
|- valign="top"
|[[File:Eyesis_corrections_plugin.jpeg|thumb|800px|Eyesis corrections plugin interface]]
+
|[[File:Eyesis correction.png|thumb|800px|Eyesis corrections plugin interface]]
 
|}
 
|}
* '''Restore''' button -> browse for default_config.corr-xml.
+
* '''Restore''' button > browse for ''default-config.corr-xml'' (should be located on the drive with calibration data, 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):
+
* '''Configure correction''' button - make sure that the following paths are set correctly (if not - edit or mark the checkboxes - a dialog for each path will pop up):
 
<font size='2'>
 
<font size='2'>
 
  '''Source files directory'''                - directory with the footage images
 
  '''Source files directory'''                - directory with the footage images
Line 30: Line 40:
 
  '''Aberration kernels (smooth) directory''' - [YOUR-PATH]/calibration/aberration_kernels/smooth
 
  '''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)
 
  '''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'''
 +
 
</font>
 
</font>
* '''Configure warping''' -> rebuild map files - this will create maps in [YOUR-PATH]/calibration/equirectangular_maps. Will take ~5-10 minutes.
+
* '''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.
 
* '''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.
+
* '''Process files''' to start the processing. Depending on the PC power can take ~20 minutes for a panorama of (24+2) images.
 +
* The last 2 rows of the UI are experimental and not related to Eyesis4Pi. No need to use.
 
* After processing is done there is only the blending step. It can be launched manually or from the WebGUI:
 
* After processing is done there is only the blending step. It can be launched manually or from the WebGUI:
**[[Eyesis4Pi_Footage_Procedures_page#Step_3|WebGUI]]
+
**[[Eyesis4Pi_393_Footage_Procedures_page#Step_3|WebGUI]]
**Manual blending: [http://eyesisbox.elphel.com/post-processing/post-processing/stitch.php 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:
+
**Manual blending: [http://community.elphel.com/files/eyesis4pi/post-processing/stitch.php 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:
 
<font size='2'>
 
<font size='2'>
 
  php stitch.php [source_directory] [destination_directory]
 
  php stitch.php [source_directory] [destination_directory]
 
  ''- no slashes in the end of the paths''
 
  ''- no slashes in the end of the paths''
 
</font>
 
</font>
 +
 +
== Links ==
 +
 +
*[[Eyesis4Pi_393|Eyesis4Pi 393 Main Article]]
 +
*[[Eyesis4Pi_393_workflow|Workflow]]
 +
*[[Eyesis4Pi_393_User_Guide_-_Recording|User Guide: Recording]]
 +
*[[Eyesis4Pi_393_Downloading_footage|User Guide: Downloading footage]]
 +
*[[Eyesis4Pi_393_Footage_Procedures_page|User Guide: Post-Processing selected few panoramas]]
 +
*[[Eyesis4pi Post-Processing|User Guide - Post-processing: ImageJ]]
 +
<!--
 +
*[[Eyesis4Pi data structure|Data Structure Description]]
 +
*[[Eyesis4Pi Calibration|Calibration Process]]
 +
-->
 +
[[Category:Eyesis4Pi393]]
 +
[[Category:User Guide]]

Latest revision as of 17:43, 24 April 2017

Procedures

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

Requirements

  • Linux OS (Kubuntu preferably).
  • ImageJ and Elphel plugins (most of the post-processing).
  • Hugin tools - enblend (for simple stitching).
  • ImageMagick - convert (for converting).
  • PHP
  • Get calibration kernels for the current Eyesis4Pi (come on a HDD with a camera).
  • Get default-config.corr-xml (come on a HDD with a camera).
  • Download footage from the camera.

Instructions

  • Launch ImageJ from Eclipse

  • 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 (should be located on the drive with calibration data, restores parameters for Configure correction)
  • Configure correction button - make sure that the following paths are set correctly (if not - edit or 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 ~20 minutes for a panorama of (24+2) images.
  • The last 2 rows of the UI are experimental and not related to Eyesis4Pi. No need to use.
  • 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