Oleg K Dzhimiev committed changes to the Elphel git project :
Initial commit

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..."

New page

<br/><br/>
==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.''
{|
|[[File:Footage procedures.png|thumb|400px|Footage procedures WebGUI]]
|}

==System requirements==
* Linux OS ([http://www.kubuntu.org/ Kubuntu] preferably).
* [http://www.apache.org/ Apache2] web server.
* [http://php.net/ PHP] (5.6.x, not 7)
* [http://www.imagemagick.org/script/index.php ImageMagick] - ''convert''.
* [http://hugin.sourceforge.net/ Hugin tools] - ''enblend''.

==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:
<font size='2'>
git clone https://github.com/Elphel/eyesis4pi393-footage-procedures.git footage_procedures
</font>

==Installation==
* Clone the repository.
* Install the required software.
* Create a link from the web server root path to the source folder. Terminal window example:
<font size="2">
sudo ln -sf /<PATH_TO_FOOTAGE_PROCEDURES>/footage_procedures /<WEB_SERVER_ROOT_DIR>/footage_procedures
</font>
* It is assumed that the footage series are located at:
<font size='2'>
'''/data/footage/FOOTAGE1'''
'''/data/footage/FOOTAGE2'''
...
</font>

==Working==
===Step 1===
{|
|[[File:Fpstep1.jpeg|thumb|820px|Step 1]]
|}
<font size='2'>
* '''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.
* '''[[Eyesis4Pi_Panorama_Previewer|Eyesis Panorama Previewer]]'''-link
Alternatively to '''Copy All''' allows to preview and copy selected panoramas for processing
</font>
<br/><br/>

===Step 2===
{|
|[[File:Fpstep2.jpeg|thumb|820px|Step 2]]
|}

* N/A means only that it's not available in the WebGUI
* Please read an article about [[Eyesis4pi_Post-Processing|Post-Processing in ImageJ]].

<!--
====Manual launch instructions (subject to changes soon)====
* Launch ImageJ -> Plugins -> Compile & Run. Find and select '''EyesisCorrections.java'''.
{|
|- valign="top"
|[[File:Eyesis_corrections_plugin.jpeg|thumb|800px|Eyesis corrections plugin interface]]
|}
* '''Restore''' button -> browse for default.corr-xml.
* '''Configure correction''' button - make sure that the following paths are set correctly:
<font size='2'>
'''Source files directory''' - directory with the footage images
'''Sensor calibration directory''' - [YOUR-PATH]/sensor_calibration_files
'''Aberration kernels (sharp) directory''' - [YOUR-PATH]/kernels/sharp
'''Aberration kernels (smooth) directory''' - [YOUR-PATH]/kernels/smooth
'''Equirectangular maps directory(may be empty)''' - [YOUR-PATH]/kernels/eqr (it should be created automatically if the w/r rights of [YOUR-PATH]/kernels allow)

* '''Configure warping''' -> rebuild map files - this will create maps in [YOUR-PATH]/kernels/eqr. 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 ~30 minutes for a panorama of 19 images.
-->
<br/><br/>
===Step 3===
{|
|[[File:Fpstep3.jpeg|thumb|820px|Step 3]]
|}
<font size="2">
* '''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.
{|
|[[File:Testcut.jpeg|thumb|400px|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 - [[Eyesis_Panorama_Database|guide]].

</font>

==Links==
* [[Elphel_Eyesis4Pi|Eyesis4Pi Main Article]]
* [[Eyesis4Pi_workflow|Workflow]]
* [[Eyesis4Pi_User_Guide|User Guide - Recording]]
* [[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]]
[[Category:Eyesis4Pi]]
[[Category:User Guide]] Oleg

Oleg K Dzhimiev committed changes to the Elphel git project :
Update README.md

Oleg Dzhimiev committed changes to the Elphel git project :
initial

Oleg K Dzhimiev committed changes to the Elphel git project :
Initial commit

AndreyFilippov committed changes to the Elphel git project :
typo fix

AndreyFilippov committed changes to the Elphel git project :
typo fix

AndreyFilippov committed changes to the Elphel git project :
cluster texture output

AndreyFilippov committed changes to the Elphel git project :
cluster texture output

AndreyFilippov committed changes to the Elphel git project :
split large class

AndreyFilippov committed changes to the Elphel git project :
split large class

AndreyFilippov committed changes to the Elphel git project :
snapshot before splitting EyesisDCT

AndreyFilippov committed changes to the Elphel git project :
snapshot before splitting EyesisDCT

Mikhail Karpenko committed changes to the Elphel git project :
Add USB audio support to kernel config

Mikhail Karpenko committed changes to the Elphel git project :
Add USB audio support to kernel config

Notes:

← Older revision Revision as of 02:01, 4 March 2017 Line 300: Line 300: ==<font color="blue">Notes</font>== ==<font color="blue">Notes</font>== * In case rootfs is on flash, it might make sense (or maybe not as the history is updated only once on session exit) to disable bash sessions command history - [http://stackoverflow.com/questions/18663078/disable-history-in-linux disable bash history] * In case rootfs is on flash, it might make sense (or maybe not as the history is updated only once on session exit) to disable bash sessions command history - [http://stackoverflow.com/questions/18663078/disable-history-in-linux disable bash history]  +  +* When using '''overlays''', deleting, existing in the lower layer, dirs can cause errors (hopefully it gets fixed someday), example:  +** /mnt/sda1 exists in lower layer: /tmp/rootfs.ro/tmp  +** upper layer is mounted to "/"  + # rmdir /mnt/sda1  + # mkdir /mnt/sda1  + mkdir: cannot create directory '/mnt/sda1': Operation not supported [[Category:393]] [[Category:393]] Oleg

Oleg Dzhimiev committed changes to the Elphel git project :
more comments

Oleg Dzhimiev committed changes to the Elphel git project :
more comments

Oleg Dzhimiev committed changes to the Elphel git project :
more comments

Oleg Dzhimiev committed changes to the Elphel git project :
more comments