Difference between revisions of "Eyesis4Pi workflow"

From ElphelWiki
Jump to: navigation, search
 
(20 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Preface==
 
The following page describes the Eyesis4Pi camera software and post-processing procedures.
 
 
 
==Actual Workflow==
 
==Actual Workflow==
  
Line 11: Line 8:
 
|align="center"                    | 1
 
|align="center"                    | 1
 
|style="padding:0px 15px 0px 15px;"| Mounting on a vehicle  
 
|style="padding:0px 15px 0px 15px;"| Mounting on a vehicle  
|align="center"                    | 15  
+
|align="center"                    | 15
 
|style="padding:0px 15px 0px 15px;"| We do not provide racks or backpacks yet
 
|style="padding:0px 15px 0px 15px;"| We do not provide racks or backpacks yet
 
|-
 
|-
 
|align="center"                    | 2
 
|align="center"                    | 2
 
|style="padding:0px 15px 0px 15px;"| Power on and boot  
 
|style="padding:0px 15px 0px 15px;"| Power on and boot  
|align="center"                    | 1  
+
|align="center"                    | 1-2
 
|style="padding:0px 15px 0px 15px;"|
 
|style="padding:0px 15px 0px 15px;"|
 
|-
 
|-
 
|align="center"                    | 3
 
|align="center"                    | 3
|style="padding:0px 15px 0px 15px;"| Network setup  
+
|style="padding:0px 15px 0px 15px;"| Network setup
|align="center"                    | 0-1  
+
|align="center"                    | 0-1
|style="padding:0px 15px 0px 15px;"|  
+
|style="padding:0px 15px 0px 15px;"| Needed only once. [http://linuxlibrary.org/kubuntu-network-configuration/  Kubuntu Network Configuration].
 
|-
 
|-
 
|align="center"                    | 4
 
|align="center"                    | 4
|style="padding:0px 15px 0px 15px;"| Accessing the WebGUI  
+
|style="padding:0px 15px 0px 15px;"| [[Eyesis4Pi_User_Guide_-_Recording|Accessing the WebGUI]]
 
|align="center"                    | 0-1  
 
|align="center"                    | 0-1  
 
|style="padding:0px 15px 0px 15px;"|The camera is controlled through a WebGUI  
 
|style="padding:0px 15px 0px 15px;"|The camera is controlled through a WebGUI  
Line 42: Line 39:
 
|style="padding:0px 15px 0px 15px;"| Setting up paths and shooting parameters  
 
|style="padding:0px 15px 0px 15px;"| Setting up paths and shooting parameters  
 
|align="center"                    | 0-1  
 
|align="center"                    | 0-1  
|style="padding:0px 15px 0px 15px;"| Initial settings can take longer time of course
+
|style="padding:0px 15px 0px 15px;"| Initial settings can take longer time
 
|-
 
|-
 
|align="center"                    | 8
 
|align="center"                    | 8
Line 52: Line 49:
 
|style="padding:0px 15px 0px 15px;"| Stop recording  
 
|style="padding:0px 15px 0px 15px;"| Stop recording  
 
|align="center"                    | -  
 
|align="center"                    | -  
|style="padding:0px 15px 0px 15px;"|
+
|style="padding:0px 15px 0px 15px;"| Output:
 +
* Images in a [[JP4|JP4]] format (a RAW format with a better quality than JPEG)
 +
* Binary log with the IMU,GPS and Internal Timestamp records.
 
|-
 
|-
 
|align="center"                    | 10
 
|align="center"                    | 10
Line 73: Line 72:
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
! Step !! Description !! Time, min !! Comment
+
! Step !! Description !! Time, min !! Program !! Comment
 
|-
 
|-
 
|align="center"                    | 1
 
|align="center"                    | 1
|style="padding:0px 15px 0px 15px;"|Copying footage to the PCs for processing
+
|style="padding:0px 15px 0px 15px;"| Copying footage from SSDs to the PC
 
|align="center"                    | 10-30
 
|align="center"                    | 10-30
 +
|align="center" style="padding:0px 15px 0px 15px;"| Manual
 
|style="padding:0px 15px 0px 15px;"|
 
|style="padding:0px 15px 0px 15px;"|
 
|-
 
|-
 
|align="center"                    | 2
 
|align="center"                    | 2
 
|style="padding:0px 15px 0px 15px;"| Selecting images for post-processing
 
|style="padding:0px 15px 0px 15px;"| Selecting images for post-processing
|align="center"                    | ?
+
|align="center"                    | -
 +
|align="center" style="padding:0px 15px 0px 15px;"| WebGUI - [[Eyesis4Pi_Panorama_Previewer|Panorama Previewer]]
 
|style="padding:0px 15px 0px 15px;"| Optional, if not all the images are needed
 
|style="padding:0px 15px 0px 15px;"| Optional, if not all the images are needed
 
|-
 
|-
 
|align="center"                    | 3
 
|align="center"                    | 3
|style="padding:0px 15px 0px 15px;"| Copying images for post-processing  
+
|style="padding:0px 15px 0px 15px;"| Copying selected or all the images for post-processing  
 
|align="center"                    | 10-30  
 
|align="center"                    | 10-30  
 +
|align="center" style="padding:0px 15px 0px 15px;"| WebGUI - [[Eyesis4Pi_Footage_Procedures_page|Footage Procedures]]
 
|style="padding:0px 15px 0px 15px;"|
 
|style="padding:0px 15px 0px 15px;"|
 
|-
 
|-
Line 93: Line 95:
 
|style="padding:0px 15px 0px 15px;"| Post-processing in ImageJ
 
|style="padding:0px 15px 0px 15px;"| Post-processing in ImageJ
 
|align="center"                    | 20-30<sup>1</sup>  
 
|align="center"                    | 20-30<sup>1</sup>  
|style="padding:5px 15px 5px 15px;"| Output: transformed according pixel map images ready for stitching and blending
+
|align="center" style="padding:0px 15px 0px 15px;"| [[Eyesis4pi_Post-Processing|ImageJ]]
 +
|style="padding:5px 15px 5px 15px;"| Output: transformed according pixel map images ready for stitching and blending.
 +
Procedures performed:
 
* Applying pixel mapping information
 
* Applying pixel mapping information
 
* Aberration correction
 
* Aberration correction
Line 105: Line 109:
 
|style="padding:0px 15px 0px 15px;"| Stitching and blending
 
|style="padding:0px 15px 0px 15px;"| Stitching and blending
 
|align="center"                    | 2-5<sup>1</sup>
 
|align="center"                    | 2-5<sup>1</sup>
 +
|style="padding:0px 15px 0px 15px;"| WebGUI - [[Eyesis4Pi_Footage_Procedures_page|Footage Procedures]]
 
|style="padding:0px 15px 0px 15px;"| Output panoramas in equirectangular projection
 
|style="padding:0px 15px 0px 15px;"| Output panoramas in equirectangular projection
 
|-
 
|-
Line 110: Line 115:
 
|style="padding:0px 15px 0px 15px;"| Preparing panoramas for WebGL Viewer
 
|style="padding:0px 15px 0px 15px;"| Preparing panoramas for WebGL Viewer
 
|align="center"                    | 2-5<sup>1</sup>
 
|align="center"                    | 2-5<sup>1</sup>
 +
|style="padding:0px 15px 0px 15px;"| WebGUI - [[Eyesis4Pi_Footage_Procedures_page|Footage Procedures]]
 
|style="padding:0px 15px 0px 15px;"| Optional
 
|style="padding:0px 15px 0px 15px;"| Optional
 
|}
 
|}
<sup>1</sup>- per single panorama images set
+
<sup>1</sup>- per single scene
 +
<br><br>
 +
==GUIs Overview==
  
== WebGUI (recording)==
+
=== WebGUI (recording)===
 
* PHP+JavaScript+HTML.
 
* PHP+JavaScript+HTML.
 
* Installed on the laptop or PC used for recording.
 
* Installed on the laptop or PC used for recording.
Line 128: Line 136:
 
|[[File:Recording gui pattern.jpeg|thumb|700px|Recording WebGUI, preview - test pattern]]
 
|[[File:Recording gui pattern.jpeg|thumb|700px|Recording WebGUI, preview - test pattern]]
 
|}
 
|}
 
==Output==
 
* Images in a [[JP4|JP4]] format(a RAW format with a better quality than *.jpeg).
 
* Binary log with the IMU,GPS and Internal Timestamp records.
 
 
[[Eyesis4Pi_data_structure|More info...]]
 
  
 
<!--
 
<!--
Line 145: Line 147:
 
-->
 
-->
  
== Post-Processing==
+
=== Post-Processing===
  
 
====A. WebGUI part (PHP + JavaScript + HTML)====
 
====A. WebGUI part (PHP + JavaScript + HTML)====
Line 172: Line 174:
  
 
==Links==
 
==Links==
* [[Eyesis4Pi_User_Guide|User Guide]]
+
* [[Elphel_Eyesis4Pi|Eyesis4Pi Main Article]]
* [[Eyesis4Pi_data_structure|Data Structure]]
+
* [[Eyesis4Pi_workflow|Workflow]]
* [[Eyesis4Pi_Footage_Procedures_page|Footage Procedures]]
+
* [[Eyesis4Pi_User_Guide|User Guide - Recording]]
* [[Eyesis4pi_Post-Processing|Post-processing in ImageJ]]
+
* [[Eyesis4Pi_Footage_Procedures_page|User Guide - Post-Processing: Footage Procedures]]
 +
* [[Eyesis4pi_Post-Processing|User Guide - Post-processing: ImageJ]]
 +
* [[Eyesis4Pi_data_structure|Data Structure Description]]
 +
* [[Eyesis4Pi_Calibration|Calibration Process]]
  
 
<!--
 
<!--
Line 216: Line 221:
 
* '''<nowiki>http://127.0.0.1/scripts/convert_images_for_webgl.php?dir=<results_dir></nowiki>''' - rescale results using [http://www.imagemagick.org/script/index.php ImageMagick].
 
* '''<nowiki>http://127.0.0.1/scripts/convert_images_for_webgl.php?dir=<results_dir></nowiki>''' - rescale results using [http://www.imagemagick.org/script/index.php ImageMagick].
 
-->
 
-->
 +
[[Category:Eyesis4Pi]]
 +
[[Category:User Guide]]

Latest revision as of 13:20, 21 May 2018

Actual Workflow

Footage Acquisition

Step Description Time, min Comment
1 Mounting on a vehicle 15 We do not provide racks or backpacks yet
2 Power on and boot 1-2
3 Network setup 0-1 Needed only once. Kubuntu Network Configuration.
4 Accessing the WebGUI 0-1 The camera is controlled through a WebGUI
5 System tests 0-1 Optional
6 Waiting for GPS lock 0-10 Cold start can take up to 10 min
7 Setting up paths and shooting parameters 0-1 Initial settings can take longer time
8 Start recording -
9 Stop recording - Output:
  • Images in a JP4 format (a RAW format with a better quality than JPEG)
  • Binary log with the IMU,GPS and Internal Timestamp records.
10 Downloading GPS/IMU log 0-10 Download onto recording PC, depends on the file size.
11 Camera power off 0-1 Power off the switch, unplug cables
12 Taking the camera off the vehicle 10 If needed

Post-Processing

Step Description Time, min Program Comment
1 Copying footage from SSDs to the PC 10-30 Manual
2 Selecting images for post-processing - WebGUI - Panorama Previewer Optional, if not all the images are needed
3 Copying selected or all the images for post-processing 10-30 WebGUI - Footage Procedures
4 Post-processing in ImageJ 20-301 ImageJ Output: transformed according pixel map images ready for stitching and blending.

Procedures performed:

  • Applying pixel mapping information
  • Aberration correction
  • Distortion correction
  • Vignetting correction
  • Color correction
  • Denoising
  • Sharpening
5 Stitching and blending 2-51 WebGUI - Footage Procedures Output panoramas in equirectangular projection
6 Preparing panoramas for WebGL Viewer 2-51 WebGUI - Footage Procedures Optional

1- per single scene

GUIs Overview

WebGUI (recording)

  • PHP+JavaScript+HTML.
  • Installed on the laptop or PC used for recording.

More info...

Recording WebGUI, settings
Recording WebGUI, preview - test pattern


Post-Processing

A. WebGUI part (PHP + JavaScript + HTML)

  • Copying images before processing.
  • Extracting GPS coordinates from images.
  • Stitching (after ImageJ).
  • Formatting/resizing the results.

More info...

Footage procedures WebGUI

B. ImageJ part (Java)

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

More info...

Eyesis corrections plugin interface

Links