Difference between revisions of "Eyesis4pi Post-Processing"
From ElphelWiki
(→Links) |
(→Instructions) |
||
| (7 intermediate revisions by the same user not shown) | |||
| Line 10: | Line 10: | ||
==Requirements== | ==Requirements== | ||
* Linux OS (Kubuntu preferably). | * Linux OS (Kubuntu preferably). | ||
| − | * [[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|ImageJ and Elphel plugins]] (most of the post-processing). |
| − | * [http://hugin.sourceforge.net/ Hugin tools] - ''enblend''. | + | * [http://hugin.sourceforge.net/ Hugin tools] - ''enblend'' (for simple stitching). |
| − | * [http://www.imagemagick.org/script/index.php ImageMagick] - ''convert''. | + | * [http://www.imagemagick.org/script/index.php ImageMagick] - ''convert'' (for converting). |
* [http://php.net/ PHP] | * [http://php.net/ PHP] | ||
* 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).--> | * 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).--> | ||
| Line 30: | Line 30: | ||
{| | {| | ||
|- valign="top" | |- valign="top" | ||
| − | |[[File: | + | |[[File:Eyesis correction.png|thumb|800px|Eyesis corrections plugin interface]] |
|} | |} | ||
| − | * '''Restore''' button | + | * '''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 52: | Line 52: | ||
* '''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. | * '''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 ~ | + | * '''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_393_Footage_Procedures_page#Step_3|WebGUI]] |
| − | **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: | + | **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] | ||
Latest revision as of 16:43, 24 April 2017
Contents
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.
- 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
- Eyesis4Pi 393 Main Article
- Workflow
- User Guide: Recording
- User Guide: Downloading footage
- User Guide: Post-Processing selected few panoramas
- User Guide - Post-processing: ImageJ
