NC353L-PHG Post-Processing - Revision history

Oleg: /* Instructions */

2016-06-16T19:33:00Z

Instructions

← Older revision		Revision as of 19:33, 16 June 2016
Line 22:		Line 22:
	* 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"

Oleg: /* Instructions */

2016-06-16T19:32:14Z

Instructions

← Older revision		Revision as of 19:32, 16 June 2016
Line 19:		Line 19:

	==Instructions==		==Instructions==
	* ~~launch~~ ImageJ from Eclipse		* Launch ImageJ from Eclipse
	* 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'''.

Oleg: /* Instructions */

2016-06-16T19:30:03Z

Instructions

← Older revision		Revision as of 19:30, 16 June 2016
Line 19:		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'''.

Oleg: /* Requirements */

2016-06-16T19:29:08Z

Requirements

← Older revision		Revision as of 19:29, 16 June 2016
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/'''.

Oleg: /* Procedures done at post-processing stage */

2015-07-20T19:15:50Z

Procedures done at post-processing stage

← Older revision		Revision as of 19:15, 20 July 2015
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

Oleg: /* Instructions */

2015-07-20T19:15:00Z

Instructions

← Older revision		Revision as of 19:15, 20 July 2015
Line 52:		Line 52:
	* '''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.		* '''Process files''' to start the processing.
	~~</font>~~

	==Links==		==Links==
	[[Category:User Guide]]		[[Category:User Guide]]
	[[Category:ImageJ]]		[[Category:ImageJ]]

Oleg: /* Instructions */

2015-07-20T19:14:39Z

Instructions

← Older revision		Revision as of 19:14, 20 July 2015
Line 51:		Line 51:
	* '''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 ~40 minutes for a panorama of (24+2) images.~~		* '''Process files''' to start the processing.
	* 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]]
	*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 converts them into jpegs, in terminal:
	~~<font size='2'>~~
	~~php stitch.php [source_directory] [destination_directory]~~
	~~''- no slashes in the end of the paths''~~
	</font>		</font>

Oleg: /* Requirements */

2015-07-20T19:13:48Z

Requirements

← Older revision		Revision as of 19:13, 20 July 2015
Line 12:		Line 12:
	* [http://rsbweb.nih.gov/ij/download.html ImageJ].		* [http://rsbweb.nih.gov/ij/download.html ImageJ].
	* [[Elphel_Software_Kit_for_Ubuntu#ImageJ_and_Elphel_plugins_for_imageJ\|Elphel ImageJ 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/'''.
	* Place [http://eyesisbox.elphel.com/post-processing/ImageJ/plugins/tiff_tags.jar tiff_tags.jar] into '''ImageJ/plugins/'''.		* Place [http://eyesisbox.elphel.com/post-processing/ImageJ/plugins/tiff_tags.jar tiff_tags.jar] into '''ImageJ/plugins/'''.
			-->
	* Calibration data (come with camera)		* Calibration data (come with camera)
	* default-config.corr-xml (comes with camera)		* default-config.corr-xml (comes with camera)

Oleg: /* Requirements */

2015-07-20T19:11:18Z

Requirements

← Older revision		Revision as of 19:11, 20 July 2015
Line 14:		Line 14:
	* 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/'''.
	* Place [http://eyesisbox.elphel.com/post-processing/ImageJ/plugins/tiff_tags.jar tiff_tags.jar] into '''ImageJ/plugins/'''.		* Place [http://eyesisbox.elphel.com/post-processing/ImageJ/plugins/tiff_tags.jar tiff_tags.jar] into '''ImageJ/plugins/'''.
	* Calibration ~~kernels~~ (come with ~~the~~ camera)		* Calibration data (come with camera)
	* default-config.corr-xml		* default-config.corr-xml (comes with camera)

	==Instructions==		==Instructions==

Oleg: Created page with "==Procedures done at post-processing stage== * Applying pixel mapping information * Aberration correction * Distortion correction * Vignetting correction * Color correction * Den..."

2015-07-20T19:10:41Z

Created page with "==Procedures done at post-processing stage== * Applying pixel mapping information * Aberration correction * Distortion correction * Vignetting correction * Color correction * Den..."

New page

==Procedures done at post-processing stage==
* Applying pixel mapping information
* Aberration correction
* Distortion correction
* Vignetting correction
* Color correction
* Denoising
* Sharpening

==Requirements==
* Linux OS (Kubuntu preferably).
* [http://rsbweb.nih.gov/ij/download.html ImageJ].
* [[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/tiff_tags.jar tiff_tags.jar] into '''ImageJ/plugins/'''.
* Calibration kernels (come with the camera)
* default-config.corr-xml

==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'''.

{|
|- valign="top"
|[[File:Eyesis_corrections_plugin.jpeg|thumb|800px|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:
**[[Eyesis4Pi_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 converts them into jpegs, in terminal:

php stitch.php [source_directory] [destination_directory]
''- no slashes in the end of the paths''


==Links==
[[Category:User Guide]]
[[Category:ImageJ]]