Difference between revisions of "Eyesis4Pi 393 Footage Procedures page"

From ElphelWiki
Jump to: navigation, search
(Created page with "<br/><br/> ==Procedures== * Copying images before processing. * Extracting GPS coordinates from the images' EXIF headers. * Stitching the panorama sets processed in ImageJ into e...")
 
(Links)
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
<br/><br/>
 
<br/><br/>
 +
==Note==
 +
* Use scripts to process in bulk
 
==Procedures==
 
==Procedures==
 
* Copying images before processing.
 
* Copying images before processing.
Line 20: Line 22:
  
 
==Download==
 
==Download==
Available for direct downloading from the [https://github.com/Elphel/eyesis4pi393-footage-procedures.git GitHub] or from a terminal window provided the GIT is installed:
+
Available for direct downloading from the [https://git.elphel.com/Elphel/eyesis4pi-393-footage-procedures.git Elphel Git] or from a terminal window provided the GIT is installed:
 
<font size='2'>
 
<font size='2'>
  git clone https://github.com/Elphel/eyesis4pi393-footage-procedures.git footage_procedures
+
  git clone https://git.elphel.com/Elphel/eyesis4pi-393-footage-procedures.git footage_procedures
 
</font>
 
</font>
  
Line 57: Line 59:
 
  Copies all the images into the specified directory for further processing in ImageJ. The source images can be selected for processing right at  
 
  Copies all the images into the specified directory for further processing in ImageJ. The source images can be selected for processing right at  
 
  their own directory w/o copying.
 
  their own directory w/o copying.
* '''[[Eyesis4Pi_Panorama_Previewer|Eyesis Panorama Previewer]]'''-link
+
* '''[[Eyesis4Pi_393_Panorama_Previewer#Requirements|Eyesis4Pi 393 Panorama Previewer]]'''-link
 
  Alternatively to '''Copy All''' allows to preview and copy selected panoramas for processing
 
  Alternatively to '''Copy All''' allows to preview and copy selected panoramas for processing
 
</font>
 
</font>
Line 109: Line 111:
 
   ''enblend -l 10 --no-optimize --fine-mask -a -v -w -o result.tif 1334546768_780764-*_EQR.tiff 1334546768_780764-*_EQR-*.tiff''
 
   ''enblend -l 10 --no-optimize --fine-mask -a -v -w -o result.tif 1334546768_780764-*_EQR.tiff 1334546768_780764-*_EQR-*.tiff''
  
* Split images for WebGL Editor (<1min/set)
+
'''Note:''' The output is an equirectangular projection of the whole panorama in jpeg format. Quick previews:
  Cuts stitched panoramas into 8 pieces for the WebGL Editor.
+
* Drag and drop to [http://community.elphel.com/files/eyesis4pi-393/demos/threejs/index.html?file=result_1343349274_575238-0-25-1.jpeg threejs demo]
 +
 
 +
* Split images for [https://git.elphel.com/Elphel/eyesis4pi-393-panorama-editor WebGL Editor] (<1min/set)
 +
  Cuts stitched panoramas into 8 pieces for the [https://git.elphel.com/Elphel/eyesis4pi-393-panorama-editor WebGL Editor].
 
{|
 
{|
 
|[[File:Testcut.jpeg|thumb|400px|Tiles for the WebGL Editor]]
 
|[[File:Testcut.jpeg|thumb|400px|Tiles for the WebGL Editor]]
Line 139: Line 144:
 
</font>
 
</font>
  
==Links==
+
== Links ==
* [[Elphel_Eyesis4Pi|Eyesis4Pi Main Article]]
+
 
* [[Eyesis4Pi_workflow|Workflow]]
+
*[[Eyesis4Pi_393|Eyesis4Pi 393 Main Article]]  
* [[Eyesis4Pi_User_Guide|User Guide - Recording]]
+
*[[Eyesis4Pi_393_workflow|Workflow]]
* [[Eyesis4Pi_Footage_Procedures_page|User Guide - Post-Processing: Footage Procedures]]
+
*[[Eyesis4Pi_393_User_Guide_-_Recording|User Guide: Recording]]
* [[Eyesis4pi_Post-Processing|User Guide - Post-processing: ImageJ]]
+
*[[Eyesis4Pi_393_Downloading_footage|User Guide: Downloading footage]]
* [[Eyesis4Pi_data_structure|Data Structure Description]]
+
*[[Eyesis4Pi_393_Footage_Procedures_page|User Guide: Post-Processing selected few panoramas]]
* [[Eyesis4Pi_Calibration|Calibration Process]]
+
*[[Eyesis4pi Post-Processing|User Guide - Post-processing: ImageJ]]  
[[Category:Eyesis4Pi]]
+
* [[Eyesis4Pi_393_Panorama_Previewer| Panorama Previewer]]
 +
* [[Stitched_panoramas_editor_viewer| Panorama Editor/Viewer]]
 +
 
 +
<!--
 +
*[[Eyesis4Pi data structure|Data Structure Description]]  
 +
*[[Eyesis4Pi Calibration|Calibration Process]]
 +
-->
 +
[[Category:Eyesis4Pi393]]
 
[[Category:User Guide]]
 
[[Category:User Guide]]

Latest revision as of 11:53, 27 April 2017



Note

  • Use scripts to process in bulk

Procedures

  • Copying images before processing.
  • Extracting GPS coordinates from the images' EXIF headers.
  • Stitching the panorama sets processed in ImageJ into equirectangular projection format.
  • Formatting/resizing the results.

WebGUI screenshot

Note: ImageJ is not included into the WebGUI at the moment because it's not yet modified for launching from a browser.

Footage procedures WebGUI

System requirements

Download

Available for direct downloading from the Elphel Git or from a terminal window provided the GIT is installed:

git clone https://git.elphel.com/Elphel/eyesis4pi-393-footage-procedures.git footage_procedures

Installation

  • Clone the repository.
  • Install the required software.
  • Create a link from the web server root path to the source folder. Terminal window example:

sudo ln -sf /<PATH_TO_FOOTAGE_PROCEDURES>/footage_procedures /<WEB_SERVER_ROOT_DIR>/footage_procedures

  • It is assumed that the footage series are located at:

/data/footage/FOOTAGE1
/data/footage/FOOTAGE2
...

Working

Step 1

Step 1

  • Processing folder-input
A folder at "/data/footage" with the footage in subfolders. Normally a one subfolder per SSD will be created by the downloading script. The splitting script will search one directory down 
  • Split All *.movs-button (If footage is recorded to the SSDs, internal or external)
Splits all *.mov files in /data/footage/FOOTAGE1/N/, where directory N contains *.movs, *.imgs or *.bins from the N-th SSD. The results are placed into /data/footage/FOOTAGE1/0 as if the footage was recorded onto PC.
  • Filter Out Images with Non-Matching Timestamps-button
Filters out uncomplete panoramas (missing files).
  • Generate KML-button
Creates a KML file (map_points.kml in the /data/footage/FOOTAGE1) for the Eyesis Panorama Previewer.

Note: /data/footage/FOOTAGE1 directory should have r/w rights for the map could be saved in there.

  • Copy All-button
Copies all the images into the specified directory for further processing in ImageJ. The source images can be selected for processing right at 
their own directory w/o copying.
Alternatively to Copy All allows to preview and copy selected panoramas for processing



Step 2

Step 2



Step 3

Step 3

  • Processing root folder-input
A root folder for post-processing - absolute path
  • Sources subfolder-input
A folder with the JP4 source images in the Processing root folder - the sources are used for GPS data extraction.
  • ImageJ-processed subfolder-input
A folder with the ImageJ plugin post-processing results to be stitched.
  • Stitch-button (~3min/set)
Launches "enblend" from a stitch.php script for all panoramas in ImageJ-processed subfolder:
 enblend -l 10 --no-optimize --fine-mask -a -v -w -o result.tif 1334546768_780764-*_EQR.tiff 1334546768_780764-*_EQR-*.tiff

Note: The output is an equirectangular projection of the whole panorama in jpeg format. Quick previews:

* Drag and drop to threejs demo
Cuts stitched panoramas into 8 pieces for the WebGL Editor.
Tiles for the WebGL Editor
  • Compress images for Google Earth-button (~5sec/set)
Creates rescaled low resolution panoramas - so the KML file could be opened from Google Earth.
  • Generate KML for the WebGL Editor-button (quick)
Scans all the source images in the Sources subfolder and creates a KML file with the GPS data. The file is saved into the Processing root folder
  • Path prefix inside KML-input
Adds this prefix to the file name to make the final http link.
Note: "published" images should be accessible at this path (locally /<web_server_root>/panoramas/ = /<webgl-editor-path>/images/)
  • Visibility-input
Tag inside the KML telling the Editor whether to show the panorama as a camera model ("1") or not ("0"). Use "1".
  • Starting Index-input
KML records names.
  • After images are split and KML is generated the results will be in the Processing root folder ready to be copied to the WebGL editor.
1. map.kml -> /<webgl_editor_path>/kml_files/
2. Splitted images -> /<webgl_editor_path>/images/
3. In the browser go to <webgl_editor_web_path>/pano_index.html
4. Don't forget to set up the database for the WebGL Editor - guide.

Links