Difference between revisions of "Eyesis4Pi Footage Procedures page"

From ElphelWiki
Jump to: navigation, search
m (Step 3)
(Step 1)
Line 48: Line 48:
 
* '''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 56:
 
'''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
 
* '''[[Eyesis4Pi_Panorama_Previewer|Eyesis 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

Revision as of 18:16, 29 May 2013



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 SourceForge.net or from a terminal window provided the GIT is installed:

git clone git://elphel.git.sourceforge.net/gitroot/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/

Links