Eyesis4Pi 393 User Guide - Download
Eyesis4Pi 393 User Guide - Download
Eyesis4Pi 393 User Guide - Download
Created page with "===Internal SSDs=== # int_ssd_download.py will connect to the cameras over ssh a few times ssh-copy-id root@192.168.0.161 ssh-copy-id root@192.168.0.162 ssh-copy-id root@1..."
New page
===Internal SSDs===# int_ssd_download.py will connect to the cameras over ssh a few times
ssh-copy-id root@192.168.0.161
ssh-copy-id root@192.168.0.162
ssh-copy-id root@192.168.0.163
# skip ''12x''10GB from beginning, download ''3x''10GB
./int_ssd_download.py -m eyesis4pi /data/footage/test_20170308a/ -s 12 -n 3
# change cables if there's only one eSATA port in PC otherwise modify the script. Oleg
Eyesis4Pi 393
Eyesis4Pi 393 workflow
Eyesis4Pi 393 workflow
Created page with "==Actual Workflow== ===Footage Acquisition=== {| class="wikitable" |- ! Step !! Description !! Time, min !! Comment |- |align="center" | 1 |style="padding..."
New page
==Actual Workflow=====Footage Acquisition===
{| class="wikitable"
|-
! Step !! Description !! Time, min !! Comment
|-
|align="center" | 1
|style="padding:0px 15px 0px 15px;"| Mounting on a vehicle
|align="center" | 15
|style="padding:0px 15px 0px 15px;"| We do not provide racks or backpacks yet
|-
|align="center" | 2
|style="padding:0px 15px 0px 15px;"| Power on and boot
|align="center" | 1-2
|style="padding:0px 15px 0px 15px;"|
|-
|align="center" | 3
|style="padding:0px 15px 0px 15px;"| Network setup
|align="center" | 0-1
|style="padding:0px 15px 0px 15px;"| Needed only once. [http://linuxlibrary.org/kubuntu-network-configuration/ Kubuntu Network Configuration].
|-
|align="center" | 4
|style="padding:0px 15px 0px 15px;"| [[Eyesis4Pi_User_Guide_-_Recording|Accessing the WebGUI]]
|align="center" | 0-1
|style="padding:0px 15px 0px 15px;"|The camera is controlled through a WebGUI
|-
|align="center" | 5
|style="padding:0px 15px 0px 15px;"| System tests
|align="center" | 0-1
|style="padding:0px 15px 0px 15px;"| Optional
|-
|align="center" | 6
|style="padding:0px 15px 0px 15px;"| Waiting for GPS lock
|align="center" | 0-10
|style="padding:0px 15px 0px 15px;"| Cold start can take up to 10 min
|-
|align="center" | 7
|style="padding:0px 15px 0px 15px;"| Setting up paths and shooting parameters
|align="center" | 0-1
|style="padding:0px 15px 0px 15px;"| Initial settings can take longer time of course
|-
|align="center" | 8
|style="padding:0px 15px 0px 15px;"| Start recording
|align="center" | -
|style="padding:0px 15px 0px 15px;"|
|-
|align="center" | 9
|style="padding:0px 15px 0px 15px;"| Stop recording
|align="center" | -
|style="padding:0px 15px 0px 15px;"| Output:
* Images in a [[JP4|JP4]] format (a RAW format with a better quality than JPEG)
* Binary log with the IMU,GPS and Internal Timestamp records.
|-
|align="center" | 10
|style="padding:0px 15px 0px 15px;"| Downloading GPS/IMU log
|align="center" | 0-10
|style="padding:0px 15px 0px 15px;"| Download onto recording PC, depends on the file size.
|-
|align="center" | 11
|style="padding:0px 15px 0px 15px;"| Camera power off
|align="center" | 0-1
|style="padding:0px 15px 0px 15px;"| Power off the switch, unplug cables
|-
|align="center" | 12
|style="padding:0px 15px 0px 15px;"| Taking the camera off the vehicle
|align="center" | 10
|style="padding:0px 15px 0px 15px;"| If needed
|}
===Post-Processing===
{| class="wikitable"
|-
! Step !! Description !! Time, min !! Program !! Comment
|-
|align="center" | 1
|style="padding:0px 15px 0px 15px;"| Copying footage from SSDs to the PC
|align="center" | 10-30
|align="center" style="padding:0px 15px 0px 15px;"| Manual
|style="padding:0px 15px 0px 15px;"|
|-
|align="center" | 2
|style="padding:0px 15px 0px 15px;"| Selecting images for post-processing
|align="center" | -
|align="center" style="padding:0px 15px 0px 15px;"| WebGUI - [[Eyesis4Pi_Panorama_Previewer|Panorama Previewer]]
|style="padding:0px 15px 0px 15px;"| Optional, if not all the images are needed
|-
|align="center" | 3
|style="padding:0px 15px 0px 15px;"| Copying selected or all the images for post-processing
|align="center" | 10-30
|align="center" style="padding:0px 15px 0px 15px;"| WebGUI - [[Eyesis4Pi_Footage_Procedures_page|Footage Procedures]]
|style="padding:0px 15px 0px 15px;"|
|-
|align="center" | 4
|style="padding:0px 15px 0px 15px;"| Post-processing in ImageJ
|align="center" | 20-30<sup>1</sup>
|align="center" style="padding:0px 15px 0px 15px;"| [[Eyesis4pi_Post-Processing|ImageJ]]
|style="padding:5px 15px 5px 15px;"| Output: transformed according pixel map images ready for stitching and blending.
Procedures performed:
* Applying pixel mapping information
* Aberration correction
* Distortion correction
* Vignetting correction
* Color correction
* Denoising
* Sharpening
|-
|align="center" | 5
|style="padding:0px 15px 0px 15px;"| Stitching and blending
|align="center" | 2-5<sup>1</sup>
|style="padding:0px 15px 0px 15px;"| WebGUI - [[Eyesis4Pi_Footage_Procedures_page|Footage Procedures]]
|style="padding:0px 15px 0px 15px;"| Output panoramas in equirectangular projection
|-
|align="center" | 6
|style="padding:0px 15px 0px 15px;"| Preparing panoramas for WebGL Viewer
|align="center" | 2-5<sup>1</sup>
|style="padding:0px 15px 0px 15px;"| WebGUI - [[Eyesis4Pi_Footage_Procedures_page|Footage Procedures]]
|style="padding:0px 15px 0px 15px;"| Optional
|}
<sup>1</sup>- per single scene
<br><br>
==GUIs Overview==
=== WebGUI (recording)===
* PHP+JavaScript+HTML.
* Installed on the laptop or PC used for recording.
[[Eyesis4Pi_User_Guide|More info...]]
<!--
* [http://wiki.elphel.com/index.php?title=Eyesis_gui elphel-eyesis-gui] - camera GUI
-->
{|
|- valign="top"
|[[File:Recording gui settings.jpeg|thumb|500px|Recording WebGUI, settings]]
|[[File:Recording gui pattern.jpeg|thumb|700px|Recording WebGUI, preview - test pattern]]
|}
<!--
* The modules haveindividual IP address:
192.168.0.221-229
* 192.168.0.221 - master camera, sends sync signals to others.
* A single image format is JP4 (a RAW format with a better quality than *.jpeg).
* Corresponding frames have the same time stamps generated by the master camera.
* The master camera frames are geotagged.
* The IMU log is stored on 1 of the 2 Compact Flash cards (non-removable) attached to the master camera.
-->
=== Post-Processing===
====A. WebGUI part (PHP + JavaScript + HTML)====
* Copying images before processing.
* Extracting GPS coordinates from images.
* Stitching (after ImageJ).
* Formatting/resizing the results.
[[Eyesis4Pi_Footage_Procedures_page|More info...]]
{|
|[[File:Footage procedures.png|thumb|400px|Footage procedures WebGUI]]
|}
====B. ImageJ part (Java)====
* Applying pixel mapping information
* Aberration correction
* Distortion correction
* Vignetting correction
* Color correction
* Denoising
* Sharpening
[[Eyesis4pi_Post-Processing|More info...]]
{|
|- valign="top"
|[[File:Eyesis_corrections_plugin.jpeg|thumb|800px|Eyesis corrections plugin interface]]
|}
==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]]
<!--
<font size='2'>
sudo apt-get install apache2 php5 ufraw dcraw libjpeg-progs imagemagick hugin
</font>
* Apache web server + php
* [http://wiki.elphel.com/index.php?title=Movie2dng Movie2DNG] - extracting JP4 (JP4 is the Elphel raw image format) images from *.MOVs.
* [[Elphel_Software_Kit_for_Ubuntu#ImageJ_and_Elphel_plugins_for_imageJ|ImageJ]] (by 3rd party) - ImageJ with Elphel plugins (image quality enhancement, aberration correction, color balance, stitching) for processing JP4s to create TIFF/JPEG output;
* [http://www.imagemagick.org/script/index.php ImageMagick] # (by 3rd party), also with a PHP scrip by Elphel is used for converting/modifying panorama JPEGs - scaling for WebGL panorama viewer/editor;
# other pre-installed PHP scripts:
** exif2kml.php - extract the GPS data from images and put it all to a KML file of the route.
** create_links_xml_file.php - read the KML file and create file with records-links of the route points. It is used in [http://eyesisbox.elphel.net/webgl-pano/geo_tests.html Elphel WebGL Viewer]
Other:
* [http://ufraw.sourceforge.net/ Ufraw] (by 3rd party) - to view/process DNG/TIFF
* [http://www.cybercom.net/~dcoffin/dcraw/ Dcraw] (by 3rd party) - for converting JPEGs
* cjpeg
=====Verify installation=====
In a terminal window type & enter commands ("command not found" == not installed):
<font size='2'>
movie2dng
convert
nona
enblend
cjpeg --help
dcraw
</font>
== Post processing workflow==
* Copy all the *.mov or *.jp4 files to certain locations (folders must have the r/w rights enabled for everyone):
<font size='2'>
/data/footage/<folder>
</font>
All the php scripts are launched from a single page - [[Eyesis4Pi_Footage_Procedures_page|Footage Procedures]]:
* '''<nowiki>http://127.0.0.1/scripts/split_mov.php?dir=<footage_name></nowiki>''' - (usage TBA) - it applies [http://wiki.elphel.com/index.php?title=Movie2dng Movie2DNG] to all the footage files. The output is JP4 files. (if needed)
* '''<nowiki>http://127.0.0.1/scripts/exif2kml.php?dir=<footage_name></nowiki>''' - it extracts the GPS data from images and puts it all to a KML file of the route. The output is a KML file.
* Launch [http://rsbweb.nih.gov/ij/ ImageJ] and process the files. The output are enhanced, stitched JPEGs (optionally TIFFs).
* '''<nowiki>http://127.0.0.1/scripts/convert_images_for_webgl.php?dir=<results_dir></nowiki>''' - rescale results using [http://www.imagemagick.org/script/index.php ImageMagick].
-->
[[Category:Eyesis4Pi]]
[[Category:User Guide]] Oleg
Eyesis4Pi 393
Operation
← Older revision Revision as of 20:31, 16 March 2017 Line 72: Line 72: ==Operation== ==Operation== −* The system is controlled from a laptop via a [[Eyesis4Pi User Guide - Recording|web-based interface (Eyesis4Pi GUI)]]. Which also displays real-time previews and parameters.+* The system is controlled from a laptop via a [[Eyesis4Pi_393_User_Guide_-_Recording|web-based interface (Eyesis4Pi GUI)]]. Which also displays real-time previews and parameters. * Power consumption is about 50W. * Power consumption is about 50W. * Power supply: * Power supply: OlegEyesis4Pi 393 User Guide - Recording
Eyesis4Pi 393 User Guide - Recording
Eyesis4Pi 393 User Guide - Recording
Eyesis4Pi 393 User Guide - Recording
Created page with "== Download & Install== Install GUI to the device that will be used for recording. There are several ways to install it: Terminal: cd <any-path> git clone https://github.co..."
New page
== Download & Install==Install GUI to the device that will be used for recording. There are several ways to install it:
Terminal:
cd <any-path>
git clone https://github.com/Elphel/eyesis4pi-393-gui.git
git pull (repeat any time to get the latest)
GitHub.com:
https://github.com/Elphel/eyesis4pi-393-gui
Follow the instructions in INSTALL.txt:
1. (For Kubuntu 16.04) Install the following packages, terminal:
sudo apt-get install apache2 php5.6 php5.6-curl
2. Make the src folder visible to the web server:
2a. Create a link, terminal: "sudo ln -sf <path-to-eyesis4pi_gui-folder> /var/www/eyesisgui"
2b. Or copy all the files to /var/www/eyesisgui.
Note: "/var/www" is the (apache2) web server's document root folder.
(for recording to the device over network only)
2c. Make the footage root folder "/data/footage" writable for everyone.
== Equipment/Package ==
* Eyesis4Pi 393
* Switch
* PC / Laptop
<br/><br/>
== Power On ==
*Turn the switch on.
*Connect the camera's ethernet cables to the switch. Boot takes about 1 min.
<b>
Important Notice: Use a fan to cool the camera's pole when shooting indoors.
</b>
<br/><br/>
== Network Set Up ==
*Connect the PC to the Gigabit port of the switch.
*Configure the PC's network settings ([http://linuxlibrary.org/kubuntu-network-configuration/ Kubuntu Network Configuration Guide]):
<font size="2"></font>
<font size="2">
IP address: 192.168.0.68 (example)
Mask: 255.255.255.0
</font>
<font size="2"></font> '''''Note:''' Eyesis4Pi 393 default IP addresses: 192.168.0.161-163'' <br><br>
== System Tests ==
*Open the GUI page (the address is bookmarked in the Firefox and in the Chrome). The GUI address is:
<font size="2"></font>
<font size="2">
http://127.0.0.1/eyesisgui/index.html
</font>
<font size="2"></font>
{|
|- valign="top"
| [[Image:Recording gui settings.jpeg|thumb|500px]]
|}
*Go to the "Settings" -> "Test"-tab:
*Follow the '''Open the test page'''-link, the tests are:
<font size="2"></font>
<font size="2">
1. All the modules are online.
2. GPS locked
3. IMU detected
4. Internal CF cards are present
</font>
<font size="2"></font> <!--
{|
|-
|[[File:Other tab.jpeg|400px|thumb|Fig.2 Other-tab]]
|}
{|
|-
|[[File:Eyesis4pi test pattern.jpeg|600px|thumb|Fig.3 Eyesis4Pi Test Pattern]]
|}
{|
|-
|[[File:Gps coords.jpeg|400px|thumb|Fig.4 GPS coordinates]]
|}
{|
|-
|[[File:Cf cards.jpeg|thumb|Fig.5 CF cards]]
|}
--> <br> <br>
== Setting recording parameters: storage paths ==
*Check paths at the '''Settings''' -> '''Recording'''-tab
<font size="2"></font>
<font size="2">
'''Absolute footage path''' - the path to the folder where all the footage series are stored. '''Must be writable to everyone.'''
'''Series subfolder''' - created automatically
'''Files limit in a subfodler''' - number of files stored in a subfolder inside '''Series subfolder'''
'''CF card device name''' - GPS/IMU log is saved to the internal CF cards. On the master camera they are /dev/hda1 & /dev/hdb1
'''GPS/IMU log file name''' - absolute path (in the master camera)+ log base name
'''Starting index''' - logs are named as follows - '''[base_name]-[index]'''
'''Records per file''' - number of records per log file. New file: an incremented index is added to the base name.
</font>
<font size="2"></font>
{|
|-
| [[Image:Recording tab.jpeg|thumb|500px]]
|}
<br><br>
== Setting recording parameters: camera settings ==
*Check camera settings at the '''Settings''' -> '''Camera'''-tab
<font size="2"></font>
<font size="2">
'''Trigger period,ms ''' - 1/FPS.
'''Skip frames mask''' - hex 0x1ff - bit[8]=enable, bits[7:0] - '''1''' - record frame, '''0''' - skip frame - in an 8-frame sequence.
'''HDRVexpos''' - in the HDR mode - the darker frame multiplication coefficient to get exposure for the lighter frame.
'''AutoExp max, ms''' - the autoexposure value limit.
'''AutoExp level''' - value of a pixel at which the autoexposure works.
'''AutoExp fracpix''' - number of pixels below the Autoexp level.
'''AutoExp frame ahead''' - number of previous frames used for calculatin the current frame exposure.
'''Compression quality''' - JP4/JPEG compression quality.
'''HDR mode''' - at the fps rate the dark and the bright images alternate.
'''Skip Frames Mask''':
0x1ff - frames are not skipped, camera is triggered at '''Trigger period'''.
0x155 - the camera is triggered at '''Trigger period'''/2 but only every other frame is recorded. It makes autoexposure adapt quicker and in the '''HDR mode''' records only normally exposed images skipping the underexposed ones.
Recommended values for 1 fps:
'''Trigger period''' = 1000 (ms)
'''Skip Frames Mask''' = 0x155
'''HDR mode''' = '''On'''
</font>
<font size="2"></font>
{|
|-
| [[Image:Camera tab.jpeg|thumb|500px]]
|}
<br><br>
== Recording ==
*'''Record'''-button to start recording
{|
|-
| [[Image:Rec.jpeg|thumb|300px]]
|}
<br><br>
== Stopping ==
*'''Stop'''-button for stop.
{|
|-
| [[Image:Rec.jpeg|thumb|300px]]
|}
<br><br>
== Downloading IMU/GPS Log ==
*After stopping - go to the '''Settings''' -> '''Recording'''-tab to download the IMU/GPS log.
<br><br>
== Checking the Recorded Footage ==
*Check the footage at the '''Absolute footage path''' - each panorama set should consist of 9 images named with a timestamp of when it was taken plus the index of the camera (seconds_microseconds_index.jp4):
{|
|-
| [[Image:Footage folder structure.jpeg|thumb|300px|Footage folder structure.jpeg]]
|}
'''''Note:''' Missing files most likely means that the FPS is too high''.
== 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
Eyesis4Pi 393
3D Model
← Older revision Revision as of 18:52, 16 March 2017 Line 116: Line 116: {| border="0" cellpadding="3" style="border:1px solid lightgray;border-collapse:collapse;" {| border="0" cellpadding="3" style="border:1px solid lightgray;border-collapse:collapse;" |- |- −| <span class="plainlinks" title="View model in the Web X3D Viewer">[http://community.elphel.com/x3d/index.html?nobuttons&animate&model=/x3d/x3d_model_files/x3d/EYESIS4PI-26-393-ASSY.x3d http://community.elphel.com/pictures/eyesis4pi/EYESIS4PI-26-393_resized_2.jpeg]</span>+| <span class="plainlinks" title="View model in the Web X3D Viewer">[https://community.elphel.com/x3d/index.html?nobuttons&animate&model=/x3d/x3d_model_files/x3d/EYESIS4PI-26-393-ASSY.x3d https://community.elphel.com/pictures/eyesis4pi/EYESIS4PI-26-393_resized_2.jpeg]</span> |- |- −| [http://community.elphel.com/x3d/index.html?nobuttons&animate&model=/x3d/x3d_model_files/x3d/EYESIS4PI-26-393-ASSY.x3d Eyesis4PI-26-393 3D]+| [https://community.elphel.com/x3d/index.html?nobuttons&animate&model=/x3d/x3d_model_files/x3d/EYESIS4PI-26-393-ASSY.x3d Eyesis4PI-26-393 3D] |} |} |} |} Oleg