Difference between revisions of "Eyesis4Pi User Guide - Recording"

From ElphelWiki
Jump to: navigation, search
(→‎Links)
m (→‎Power On)
 
(17 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
==Equipment/Package==
+
== Download ==
−
* Eyesis4Pi
+
<font size='2'>
−
* Switch 3CRDSF9PWR / Netgear FS726TP
+
The GUI for recording is installed on the Eyesisbox PC by default.
−
* PC / Laptop
 
−
<br>
 
−
<br>
 
−
==Power On==
 
  
−
* Turn the switch on.
+
There are several ways to install a newer version:
−
* Connect the camera's ethernet cables to the PoE enabled ports. The camera boot takes about 1 min.
+
 
−
{|
+
Terminal:
−
|-
+
cd <any-path>
−
|[[File:Switch panel comments.jpeg|600px|thumb|Fig.1 Netgear FS726TP]]
+
git clone git://elphel.git.sourceforge.net/gitroot/elphel/eyesis4pi_gui (initial checkout)
−
|}
+
git pull (update)
−
<br>
+
SF.net:
−
<br>
+
http://elphel.git.sourceforge.net/git/gitweb.cgi?p=elphel/eyesis4pi_gui;a=tree
−
==Network Set Up==
+
</font>
−
* 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]):
+
Follow the instructions in INSTALL.txt:
−
<font size=2>
+
1. Install the following packages, terminal:
 +
  sudo apt-get install php5 apache2
 +
 +
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/eysisgui"
 +
2b. Or copy all the files to /var/www/eyesisgui.
 +
Note: "/var/www" is the (apache2) web server's document root folder.
 +
 +
3. Make the footage root folder "/data/footage" writable for everyone.
 +
 
 +
 
 +
== Equipment/Package ==
 +
 
 +
*Eyesis4Pi
 +
*Switch
 +
*PC / Laptop
 +
 
 +
<br> <br>
 +
 
 +
== Power On ==
 +
 
 +
*Turn the switch on.  
 +
*Connect the camera's ethernet cables to the power enabled ports. The camera boot takes about 1 min.
 +
<font size='2'><b>
 +
Important Notice: Use a fan to cool the camera's pole when shooting indoors.
 +
</b></font>
 +
<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)
 
  IP address: 192.168.0.68 (example)
 
  Mask:      255.255.255.0
 
  Mask:      255.255.255.0
 
</font>
 
</font>
−
'''''Note:''' Eyesis4Pi's default IP addresses: 192.168.0.221-229''
+
 
−
<br>
+
<font size="2"></font> '''''Note:''' Eyesis4Pi's default IP addresses: 192.168.0.221-229'' <br> <br>  
−
<br>
+
 
−
==System Tests==
+
== System Tests ==
−
* Open the GUI page (the address is bookmarked in the Firefox and in the Chrome). The GUI address is:
+
 
−
<font size=2>
+
*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
 
  http://127.0.0.1/eyesisgui/index.html
 
</font>
 
</font>
 +
 +
<font size="2"></font>
 +
 
{|
 
{|
 
|- valign="top"
 
|- valign="top"
−
|[[File:Recording gui settings.jpeg|thumb|500px|WebGUI]]
+
| [[Image:Recording gui settings.jpeg|thumb|500px]]
 
|}
 
|}
  
−
* Go to the "Settings" -> "Test"-tab:
+
*Go to the "Settings" -&gt; "Test"-tab:
  
−
* Follow the '''Open the test page'''-link, the tests are:
+
*Follow the '''Open the test page'''-link, the tests are:
−
<font size='2'>
+
 
 +
<font size="2"></font>
 +
 
 +
<font size="2">
 
  1. All the modules are online.
 
  1. All the modules are online.
 
  2. GPS locked
 
  2. GPS locked
Line 44: Line 85:
 
  4. Internal CF cards are present
 
  4. Internal CF cards are present
 
</font>
 
</font>
−
<!--
+
 
 +
<font size="2"></font> <!--
 
{|
 
{|
 
|-
 
|-
Line 61: Line 103:
 
|[[File:Cf cards.jpeg|thumb|Fig.5 CF cards]]
 
|[[File:Cf cards.jpeg|thumb|Fig.5 CF cards]]
 
|}
 
|}
−
-->
+
--> <br> <br>  
−
<br>
+
 
−
<br>
+
== Setting recording parameters: storage paths ==
 +
 
 +
*Check paths at the '''Settings''' -&gt; '''Recording'''-tab
  
−
==Setting recording parameters: storage paths==
+
<font size="2"></font>
  
−
* Check paths at the '''Settings''' -> '''Recording'''-tab
+
<font size="2">
−
<font size='2'>
 
 
  '''Absolute footage path''' - the path to the folder where all the footage series are stored. '''Must be writable to everyone.'''
 
  '''Absolute footage path''' - the path to the folder where all the footage series are stored. '''Must be writable to everyone.'''
 
  '''Series subfolder''' - created automatically
 
  '''Series subfolder''' - created automatically
 
  '''Files limit in a subfodler''' - number of files stored in a subfolder inside '''Series subfolder'''
 
  '''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
+
  '''CF card device name''' - GPS/IMU log is saved to the internal CF cards. On the master camera they are /dev/hda1 &amp; /dev/hdb1
 
  '''GPS/IMU log file name''' - absolute path (in the master camera)+ log base name
 
  '''GPS/IMU log file name''' - absolute path (in the master camera)+ log base name
 
  '''Starting index''' - logs are named as follows - '''[base_name]-[index]'''
 
  '''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.
 
  '''Records per file''' - number of records per log file. New file: an incremented index is added to the base name.
 
</font>
 
</font>
 +
 +
<font size="2"></font>
 +
 
{|
 
{|
 
|-
 
|-
−
|[[File:Recording tab.jpeg|500px|thumb|Fig.6 Recording-tab]]
+
| [[Image:Recording tab.jpeg|thumb|500px]]
 
|}
 
|}
−
<br><br>
 
−
==Setting recording parameters: camera settings==
 
−
* Check camera settings at the '''Settings''' -> '''Camera'''-tab
 
  
−
<font size='2'>
+
<br><br>
 +
 
 +
== Setting recording parameters: camera settings ==
 +
 
 +
*Check camera settings at the '''Settings''' -&gt; '''Camera'''-tab
 +
 
 +
<font size="2"></font>
 +
 
 +
<font size="2">
 
  '''Trigger period,ms ''' - 1/FPS.
 
  '''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.
 
  '''Skip frames mask''' - hex 0x1ff - bit[8]=enable, bits[7:0] - '''1''' - record frame, '''0''' - skip frame - in an 8-frame sequence.
Line 97: Line 148:
  
 
  '''HDR mode''' - at the fps rate the dark and the bright images alternate.
 
  '''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>
 +
 +
<font size="2"></font>
 +
 
{|
 
{|
 
|-
 
|-
−
|[[File:Camera tab.jpeg|500px|thumb|Fig.7 Camera-tab]]
+
| [[Image:Camera tab.jpeg|thumb|500px]]
 
|}
 
|}
 +
 
<br><br>
 
<br><br>
−
==Recording==
+
 
−
* '''Record'''-button to start recording
+
== Recording ==
 +
 
 +
*'''Record'''-button to start recording
 +
 
 
{|
 
{|
−
|[[File:Rec.jpeg|thumb|Fig.8 REC|300px]]
+
|-
 +
| [[Image:Rec.jpeg|thumb|300px]]
 
|}
 
|}
−
<br><br>
+
 
−
==Stopping==
+
<br><br>  
−
* '''Stop'''-button for stop.
+
 
 +
== Stopping ==
 +
 
 +
*'''Stop'''-button for stop.
 +
 
 
{|
 
{|
−
|[[File:Rec.jpeg|thumb|Fig.9 STOP|300px]]
+
|-
 +
| [[Image:Rec.jpeg|thumb|300px]]
 
|}
 
|}
−
<br><br>
+
 
−
==Downloading IMU/GPS Log==
+
<br><br>  
−
* After stopping - go to the '''Settings''' -> '''Recording'''-tab to download the IMU/GPS log.
+
 
−
<br><br>
+
== Downloading IMU/GPS Log ==
−
==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):
+
*After stopping - go to the '''Settings''' -&gt; '''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):
 +
 
 
{|
 
{|
−
|[[File:Footage folder structure.jpeg|thumb|300px]]
+
|-
 +
| [[Image:Footage folder structure.jpeg|thumb|300px|Footage folder structure.jpeg]]
 
|}
 
|}
−
'''''Note:''' Missing files most likely means that the FPS is too high''.
 
  
−
==Links==
+
'''''Note:''' Missing files most likely means that the FPS is too high''.
−
* [[Elphel_Eyesis4Pi|Eyesis4Pi Main Article]]
+
 
−
* [[Eyesis4Pi_workflow|Workflow]]
+
== Links ==
−
* [[Eyesis4Pi_User_Guide|User Guide - Recording]]
+
 
−
* [[Eyesis4Pi_Footage_Procedures_page|User Guide - Post-Processing: Footage Procedures]]
+
*[[Elphel Eyesis4Pi|Eyesis4Pi Main Article]]  
−
* [[Eyesis4pi_Post-Processing|User Guide - Post-processing: ImageJ]]
+
*[[Eyesis4Pi workflow|Workflow]]  
−
* [[Eyesis4Pi_data_structure|Data Structure Description]]
+
*[[Eyesis4Pi User Guide|User Guide - Recording]]  
−
* [[Eyesis4Pi_Calibration|Calibration Process]]
+
*[[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]]

Latest revision as of 11:41, 11 March 2013

Download

The GUI for recording is installed on the Eyesisbox PC by default.

There are several ways to install a newer version:

Terminal: 

cd <any-path>
git clone git://elphel.git.sourceforge.net/gitroot/elphel/eyesis4pi_gui (initial checkout)
git pull (update)

SF.net: 

http://elphel.git.sourceforge.net/git/gitweb.cgi?p=elphel/eyesis4pi_gui;a=tree

Follow the instructions in INSTALL.txt: 

1. Install the following packages, terminal:
 sudo apt-get install php5 apache2

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/eysisgui"
2b. Or copy all the files to /var/www/eyesisgui.
Note: "/var/www" is the (apache2) web server's document root folder.

3. Make the footage root folder "/data/footage" writable for everyone.


Equipment/Package

  • Eyesis4Pi
  • Switch
  • PC / Laptop



Power On

  • Turn the switch on.
  • Connect the camera's ethernet cables to the power enabled ports. The camera boot takes about 1 min.

Important Notice: Use a fan to cool the camera's pole when shooting indoors.



Network Set Up

IP address: 192.168.0.68 (example)
Mask:       255.255.255.0

Note: Eyesis4Pi's default IP addresses: 192.168.0.221-229

System Tests

  • Open the GUI page (the address is bookmarked in the Firefox and in the Chrome). The GUI address is:

http://127.0.0.1/eyesisgui/index.html

Recording gui settings.jpeg
  • Go to the "Settings" -> "Test"-tab:
  • Follow the Open the test page-link, the tests are:

1. All the modules are online.
2. GPS locked
3. IMU detected
4. Internal CF cards are present



Setting recording parameters: storage paths

  • Check paths at the Settings -> Recording-tab

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.

Recording tab.jpeg



Setting recording parameters: camera settings

  • Check camera settings at the Settings -> Camera-tab

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

Camera tab.jpeg



Recording

  • Record-button to start recording
Rec.jpeg



Stopping

  • Stop-button for stop.
Rec.jpeg



Downloading IMU/GPS Log

  • After stopping - go to the Settings -> Recording-tab to download the IMU/GPS log.



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):
Footage folder structure.jpeg

Note: Missing files most likely means that the FPS is too high.

Links

Retrieved from "https://wiki.elphel.com/index.php?title=Eyesis4Pi_User_Guide_-_Recording&oldid=12867"