Difference between revisions of "NC353L-PHG Post-Processing"

From ElphelWiki
Jump to: navigation, search
(Instructions)
(Instructions)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Procedures done at post-processing stage==
+
==Procedures done at the post-processing stage==
 
* Applying pixel mapping information
 
* Applying pixel mapping information
 
* Aberration correction
 
* Aberration correction
Line 10: Line 10:
 
==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]].
* [[Elphel_Software_Kit_for_Ubuntu#ImageJ_and_Elphel_plugins_for_imageJ|Elphel ImageJ Plugins]].
 
 
<!--
 
<!--
 
* Place [http://eyesisbox.elphel.com/post-processing/ImageJ/plugins/loci_tools.jar loci_tools.jar] into '''ImageJ/plugins/'''.
 
* Place [http://eyesisbox.elphel.com/post-processing/ImageJ/plugins/loci_tools.jar loci_tools.jar] into '''ImageJ/plugins/'''.
Line 20: Line 19:
  
 
==Instructions==
 
==Instructions==
* Open terminal window:
+
* Launch ImageJ from Eclipse
<font size='2'>
 
cd /data/ImageJ
 
./run
 
 
* Go to '''Plugins''' -> '''ImageJ-Elphel''' -> '''Eyesis Correction'''
 
* Go to '''Plugins''' -> '''ImageJ-Elphel''' -> '''Eyesis Correction'''
 
  '''Note''': if plugin needs to be recompiled - '''Plugins''' -> '''Compile & Run'''. Find and select '''Eyesis_Correction.java'''.
 
  '''Note''': if plugin needs to be recompiled - '''Plugins''' -> '''Compile & Run'''. Find and select '''Eyesis_Correction.java'''.
</font>
+
 
 
{|
 
{|
 
|- valign="top"
 
|- valign="top"

Latest revision as of 11:33, 16 June 2016

Procedures done at the post-processing stage

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

Requirements

  • Linux OS (Kubuntu preferably).
  • ImageJ and Elphel plugins.
  • Calibration data (come with camera)
  • default-config.corr-xml (comes with 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 (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.

Links