Mikhail Karpenko committed changes to the Elphel git project :
Fix 'invalid blocks on device' error during disk formatting

Oleg Dzhimiev committed changes to the Elphel git project :
initial -db support

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

Step 3:

← Older revision Revision as of 02:26, 7 March 2017 (2 intermediate revisions not shown)Line 57: Line 57:   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 108: Line 108:   Launches "enblend" from a stitch.php script for all panoramas in '''ImageJ-processed subfolder''':   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''    ''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 [http://community.elphel.com/files/eyesis4pi-393/demos/threejs/index.html?file=result_1343349274_575238-0-25-1.jpeg threejs demo] * Split images for WebGL Editor (<1min/set) * Split images for WebGL Editor (<1min/set) Oleg

Requirements:

New page

==Description==
This WebUI made for previewing unstitched Eyesis4Pi footage - JP4s or JPEGs. It can be used for selecting panoramas - if all the panoramas are to be processed than using it is not necessary.
{|
|- valign="top"
|[[File:Previewer_snapshot1.jpeg|thumb|500px|Previewer snapshot. 24 head sensors]]
|}

==Requirements==
* Linux OS ([http://www.kubuntu.org/ Kubuntu] preferably).
* [http://www.apache.org/ Apache2] web server.
* PHP

==Source==
Available for direct downloading from the [https://github.com/Elphel/eyesis4pi393-panorama-previewer.git GitHub] or from a terminal window provided GIT client is installed:
<font size='2'>
git clone https://github.com/Elphel/eyesis4pi393-panorama-previewer.git panorama_preview
</font>

==User Guide==
===Install===
* Clone the repository.
* Install the required software.
* Create a link from the web server root path to the source folder.
* Place footage to '''/data/footage/FOOTAGE_NAME'''.
* Extract a KML file from the '''Footage Procedures''' page.

===Work===
* Select the footage series in the '''Choose Date''' drop down menu.
* Use map and '''Image number''' for navigation.
* Use copy button to move the selected preview to the processing directory.

[[Category:Eyesis4Pi 393]]
[[Category:User Guide]] Oleg

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