Recent changes to Installation_Instructions

Installation_Instructions modified by Dominic Letourneau

Dominic Letourneau — Fri, 25 Sep 2015 14:27:37 -0000

--- v14
+++ v15
@@ -56,8 +56,9 @@
 # General Information

 The main processing loop contains the following elements : 
-
-[[img src=ProcessingLoop.png]] 
+
+[[img src=ProcessingLoop.png width=640]] 
+

 ## [openStreamManyEars](http://manyears.svn.sourceforge.net/viewvc/manyears/trunk/manyears/src/openStream.cc?revision=HEAD&view=markup)

@@ -168,8 +169,9 @@

 Default microphone configuration is defined in file [cube_mic_pos.mat](http://manyears.svn.sourceforge.net/viewvc/manyears/trunk/manyears/config/cube_mic_pos.mat?revision=HEAD&view=markup) : 

+
 [[img src=Cube.jpg]] 
-
+
   * Microphone #1 x=-18cm y=16cm z=-15.5cm 
   * Microphone #2 x=-18cm y=16cm z=15.5cm 
   * Microphone #3 x=18cm y=16cm z=-15.5cm

Installation_Instructions modified by Dominic Letourneau

Dominic Letourneau — Wed, 28 May 2014 12:20:05 -0000

Installation_Instructions modified by Dominic Letourneau

Dominic Letourneau — Wed, 28 May 2014 12:20:05 -0000

Installation_Instructions modified by Dominic Letourneau

Dominic Letourneau — Wed, 28 May 2014 12:20:05 -0000

--- v11
+++ v12
@@ -86,3 +86,106 @@
   1. **float x[3]** Contains x,y,z coordinates of the detected source. This is related to the origin of the microphone array positions. 
   2. **float strength** Strength of the source. 
   3. **int source_id** Id of the source (unique). 
+
+## ToString
+
+  * Transform the Vector<ObjectRef> output of SourceTrack containing source informations into a FlowDesigner serialized string. 
+
+## QtSendString
+
+  * Will send the string to a TCP socket on port 30000. This is the port of the audioviewer application for displaying live sources. 
+
+## Constant (CONDITION)
+
+  * This is the loop condition. The constant is set to "TRUE" for infinite looping. 
+
+## [SaveWavWin32](http://manyears.svn.sourceforge.net/viewvc/manyears/trunk/manyears/src/SaveWavWin32.cc?revision=HEAD&view=markup)
+
+  * Separated streams will be saved in WAV format. 
+
+## [UDPOSCOut](http://manyears.svn.sourceforge.net/viewvc/manyears/trunk/manyears/src/UDPOSCOut.cc?revision=HEAD&view=markup)
+
+[Open Sound Control](http://opensoundcontrol.org/) output using UDP sockets. 
+
+  * OSC format for ManyEars is the following : 
+    
+    
+    "/manyears\0\0\0,iffffff\0\0\0\0" 
+    + source_id (4 bytes)
+    + x (4 bytes)
+    + y (4 bytes)
+    + z (4 bytes)
+    + strength (4 bytes)
+    + theta (4 bytes)
+    + phi (4 bytes)
+    
+
+The resulting code is : 
+    
+    
+    int id = info->source_id;
+    float x = info->x[0];
+    float y = info->x[1];
+    float z = info->x[2];
+    float strength = info->strength;
+    float phi = -180.0 * atan2(info->x[2], info->x[1]) / M_PI;;
+    float theta = 180.0 * atan2(info->x[1],info->x[0]) / M_PI;
+                                  
+    stringstream outputString;
+                      
+    char header[12] = {'/','m','a','n','y','e','a','r','s', '\0', '\0','\0'};
+    char tags[12] = {',','i','f','f','f','f','f','f','\0','\0','\0','\0'};
+                      
+    outputString.write(header,12);
+    outputString.write(tags,12);
+                      
+    BinIO::write<int>(outputString,&id,1);
+    BinIO::write<float>(outputString,&x,1);
+    BinIO::write<float>(outputString,&y,1);
+    BinIO::write<float>(outputString,&z,1);
+    BinIO::write<float>(outputString,&strength,1);
+    BinIO::write<float>(outputString,θ,1);
+    BinIO::write<float>(outputString,φ,1);
+                      
+                      
+    //write to the socket
+    socket.writeDatagram(outputString.str().c_str(),outputString.str().size(),
+    QHostAddress(hostname.c_str()),portnumber);
+                           
+    
+
+### Important Notes
+
+  * Phi and Theta can be calculated from x,y,z. We have decided to transmit them anyway for ease of use. 
+    * float phi = -180.0 * atan2(info->x[2], info->x[1]) / M_PI;; 
+    * float theta = 180.0 * atan2(info->x[1],info->x[0]) / M_PI; 
+  * Data must be aligned on 32 bits with OSC. 
+  * tags[12] = {',','i','f','f','f','f','f','f','\0','\0','\0','\0'}; describes the format of the OSC packet. Binary data is written using big endian (network order). 
+  * We send N separated packets, one for each of the active source. 
+  * We should consider writing a generic OSC FlowDesigner Node. 
+
+## Microphones Configuration
+
+Default microphone configuration is defined in file [cube_mic_pos.mat](http://manyears.svn.sourceforge.net/viewvc/manyears/trunk/manyears/config/cube_mic_pos.mat?revision=HEAD&view=markup) : 
+
+[[img src=Cube.jpg]] 
+
+  * Microphone #1 x=-18cm y=16cm z=-15.5cm 
+  * Microphone #2 x=-18cm y=16cm z=15.5cm 
+  * Microphone #3 x=18cm y=16cm z=-15.5cm 
+  * Microphone #4 x=18cm y=16cm z=15.5cm 
+  * Microphone #5 x=-18cm y=-16cm z=-15.5cm 
+  * Microphone #6 x=-18cm y=-16cm z=15.5cm 
+  * Microphone #7 x=18cm y=-16cm z=-15.5cm 
+  * Microphone #8 x=18cm y=-16cm z=15.5cm 
+
+  
+
+
+### Important Notes
+
+  1. Microphones must be ** connected in the correct order ** in the sound card inputs. Microphone #1 goes into input #1, Microphone #2 goes into input #2, etc. 
+  2. Microphones positions can be changed to fit your setup. **It is mandatory that you configure the microphone positions otherwise the algorithm won't work.**
+  3. Sampling time for each audio input must be **synchronized** by hardware. 
+
+## Audioviewer

Installation_Instructions modified by Dominic Letourneau