Difference between revisions of "Eyesis4Pi Footage Procedures page"

From ElphelWiki
Jump to: navigation, search
m (Step 3)
(Links)
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<br/><br/>
 
<br/><br/>
 
==Procedures==
 
==Procedures==
 +
* This will work if dealing with few panoramas. For many the best option is to use scripts w/o ui.
 
* Copying images before processing.
 
* Copying images before processing.
 
* Extracting GPS coordinates from the images' EXIF headers.
 
* Extracting GPS coordinates from the images' EXIF headers.
Line 23: Line 24:
 
Available for direct downloading from the [http://elphel.git.sourceforge.net/git/gitweb.cgi?p=elphel/footage_procedures;a=tree SourceForge.net] or from a terminal window provided the GIT is installed:
 
Available for direct downloading from the [http://elphel.git.sourceforge.net/git/gitweb.cgi?p=elphel/footage_procedures;a=tree SourceForge.net] or from a terminal window provided the GIT is installed:
 
<font size='2'>
 
<font size='2'>
  git clone git://elphel.git.sourceforge.net/gitroot/elphel/footage_procedures
+
  git clone git://git.code.sf.net/p/elphel/footage_procedures
 
</font>
 
</font>
  
Line 48: Line 49:
 
* '''Processing folder'''-input
 
* '''Processing folder'''-input
 
  A folder at "/data/footage" with the acquired images in the indexed subfolders.
 
  A folder at "/data/footage" with the acquired images in the indexed subfolders.
 +
* '''Split All *.movs'''-button ('''If equipped with internal SSDs''')
 +
Splits all '''*.mov''' files in '''/data/footage/FOOTAGE1/mov/N/''', where directory N contains *.movs  from the N-th camera starting from 1 ->
 +
N=1..9 for Eyesis4Pi-26 model. 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
 
* '''Filter Out Images with Non-Matching Timestamps'''-button
 
  Filters out uncomplete panoramas (missing files).
 
  Filters out uncomplete panoramas (missing files).
Line 54: Line 58:
 
'''Note:''' '''''/data/footage/FOOTAGE1''' directory should have r/w rights for the map could be saved in there.''
 
'''Note:''' '''''/data/footage/FOOTAGE1''' directory should have r/w rights for the map could be saved in there.''
 
* '''Copy All'''-button
 
* '''Copy All'''-button
  Copies all the images into the specified directory for further processing in ImageJ.
+
  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 copiying.
 +
* '''[[Eyesis4Pi_Panorama_Previewer|Eyesis Panorama Previewer]]'''-link
 +
Alternatively to '''Copy All''' allows to preview and copy selected panoramas for processing
 
</font>
 
</font>
 
<br/><br/>
 
<br/><br/>
Line 119: Line 126:
 
* '''Path prefix inside KML'''-input
 
* '''Path prefix inside KML'''-input
 
  Adds this prefix to the file name to make the final http link.
 
  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
 
* '''Visibility'''-input
Line 129: Line 137:
 
  1. map.kml -> '''/<webgl_editor_path>/kml_files/'''
 
  1. map.kml -> '''/<webgl_editor_path>/kml_files/'''
 
  2. Splitted images -> '''/<webgl_editor_path>/images/'''
 
  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 - [[Eyesis_Panorama_Database|guide]].
  
 
</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 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 data structure|Data Structure Description]]  
 +
*[[Eyesis4Pi Calibration|Calibration Process]]
 +
-->
 +
[[Category:Eyesis4Pi393]]
 
[[Category:User Guide]]
 
[[Category:User Guide]]

Latest revision as of 15:59, 24 April 2017



Procedures

  • This will work if dealing with few panoramas. For many the best option is to use scripts w/o ui.
  • 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 SourceForge.net or from a terminal window provided the GIT is installed:

git clone git://git.code.sf.net/p/elphel/footage_procedures

Installation

  • Download the source files.
  • 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 acquired images in the indexed subfolders.
  • Split All *.movs-button (If equipped with internal SSDs)
Splits all *.mov files in /data/footage/FOOTAGE1/mov/N/, where directory N contains *.movs  from the N-th camera starting from 1 -> 
N=1..9 for Eyesis4Pi-26 model. 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 copiying.
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
  • Split images for WebGL Editor (<1min/set)
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