Difference between revisions of "Eyesis4pi Post-Processing"
From ElphelWiki
(→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] | ||
| − | * | + | * 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 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
Contents
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.
- 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
- Eyesis4Pi Main Article
- Workflow
- User Guide - Recording
- User Guide - Post-Processing: Footage Procedures
- User Guide - Post-processing: ImageJ
- Data Structure Description
- Calibration Process
