Difference between revisions of "ManyEarsPackages"

From IntRoLab
(OSX Packages)
(Packages (Test OSX, June 18 2010))
 
(32 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
= Packages (Test OSX, June 18 2010) =
 +
'''Note : This package is for internal testing only. They are made for Mac OSX Snow Leopard (10.6)'''
 +
# First, install Qt from here : http://qt.nokia.com/downloads/sdk-mac-os-cpp. You only need this if you want to run the test GUI (recommended).
 +
# Download the package here : [[File:ManyEarsBetaPackageOSX.dmg]]
 +
# Run the test program "ManyEars.app"
 +
# Have a look at the example, lib, include directories. You should have everything you need there for integration with MAX/MSP.
 +
# Email [mailto:dominic.letourneau@usherbrooke.ca Dominic Létourneau] for more informations!
 +
 
= Packages =
 
= Packages =
 +
 +
After installing the WIN32 or OSX package, please go to the [[ManyEarsPackages#Configuration | Configuration]] section for more details for configuring the microphone array.
  
 
== WIN32 Packages ==
 
== WIN32 Packages ==
Line 9: Line 19:
 
## Download and install [[File:ManyEars-0.2.rar]]
 
## Download and install [[File:ManyEars-0.2.rar]]
 
# Run FlowDesigner from the start menu
 
# Run FlowDesigner from the start menu
# (optional) run audioviewer from C:\Program Files\FlowDesigner\bin
+
# (Optional) run audioviewer from C:\Program Files\FlowDesigner\bin
  
 
<pre>
 
<pre>
 
Notes :
 
Notes :
  
 +
July 23 2009. Updated phi for package ManyEars.
 
June 5 2009. Packages uploaded.
 
June 5 2009. Packages uploaded.
  
Line 19: Line 30:
  
 
== OSX Packages ==
 
== OSX Packages ==
* Download and mount this image :
+
# Download & Install Qt
** [[File:FlowDesigner-0.10.0-RW.dmg]]
+
## http://get.qtsoftware.com/qt/source/qt-mac-opensource-4.5.1.dmg
** Run FlowDesigner from the mounted image
+
# Download and mount this image :
 +
## [[File:FlowDesigner-0.10.0-RW.dmg]]
 +
## Run FlowDesigner from the mounted image
 +
## Open and run the FlowDesigner network described in the Configuration section.
 
If you want to run the audioviewer (after the image is mounted) :
 
If you want to run the audioviewer (after the image is mounted) :
 
# Start the terminal
 
# Start the terminal
Line 30: Line 44:
 
# (Optional) Start audioviewer
 
# (Optional) Start audioviewer
 
## audioviewer
 
## audioviewer
 +
 +
<pre>
 +
Notes :
 +
 +
July 23 2009. Updated phi for package.
 +
June 5 2009. Packages uploaded.
 +
 +
</pre>
  
 
= Configuration =  
 
= Configuration =  
Line 44: Line 66:
 
== Microphone Array Configuration ==
 
== Microphone Array Configuration ==
  
Here is an example of cube configuration. <b>Each microphone configuration must be ordered the same way they are connected to the sound card.</b>
+
* [http://apps.sourceforge.net/mediawiki/manyears/index.php?title=Installation_Instructions#Microphones_Configuration  See microphone coordinates here]
 +
 
 +
 
 +
<b>Each microphone configuration must be ordered the same way they are connected to the sound card. Values are in cm.</b>
  
 +
Here is an example of the cube configuration :
 
<pre>
 
<pre>
 
<Matrix
 
<Matrix
Line 61: Line 87:
 
18 -16 -15.5
 
18 -16 -15.5
 
18 -16 15.5
 
18 -16 15.5
 +
>
 +
>
 +
 +
</pre>
 +
 +
Here is an example of the planar octogonal configuration :
 +
 +
<pre>
 +
<Matrix
 +
 +
<rows 8>
 +
<cols 3>
 +
<data
 +
12.5 30 0
 +
-12.5 30 0
 +
-30 12.5 0
 +
-30 -12.5 0
 +
-12.5 -30 0
 +
12.5 -30 0
 +
30 -12.5 0
 +
30 12.5 0
 
>
 
>
 
>
 
>
Line 76: Line 123:
 
** [[File:LocalizeOSC.n]]
 
** [[File:LocalizeOSC.n]]
  
== OSC Format ==
+
== OSC Format (Updated) ==
 +
* Data is transmitted with Network byte order (MSB first)
 
<pre>
 
<pre>
  
Line 96: Line 144:
 
//TOTAL = 56 BYTES
 
//TOTAL = 56 BYTES
 
</pre>
 
</pre>
 +
 +
== Output with OSC to more than one destination ==
 +
To add an output do the following steps :
 +
# Open the Tracking3D.n file
 +
# Click on the "MAIN_LOOP" tab.
 +
# Add the node : ManyEars->UDPOSCOut
 +
# Add the node : General->NOP
 +
# Connect the nodes to  (like the original ones) to "node_SourceTrack_1"
 +
# Hold Shift and mouse click on the output of the new UDPOSCOut
 +
## Name the output with a different name than SOURCE_INFO
 +
# Click on the "MAIN" tab.
 +
#Hold Shift and mouse click on the output previously added to "MAIN_LOOP"
 +
## You can keep the output name as suggested
 +
# Save your document with a different name if required
 +
# Run the document
 +
 +
Here is an example :
 +
 +
* [[File:Tracking3D_2Out.n]]

Latest revision as of 13:40, 18 June 2010

Packages (Test OSX, June 18 2010)

Note : This package is for internal testing only. They are made for Mac OSX Snow Leopard (10.6)
  1. First, install Qt from here : http://qt.nokia.com/downloads/sdk-mac-os-cpp. You only need this if you want to run the test GUI (recommended).
  2. Download the package here : File:ManyEarsBetaPackageOSX.dmg
  3. Run the test program "ManyEars.app"
  4. Have a look at the example, lib, include directories. You should have everything you need there for integration with MAX/MSP.
  5. Email Dominic Létourneau for more informations!

Packages

After installing the WIN32 or OSX package, please go to the Configuration section for more details for configuring the microphone array.

WIN32 Packages

  1. Install the FlowDesigner Package
    1. Download and install File:FlowDesigner-0.10.0-win32.rar
    2. FlowDesigner must be added to the PATH with the installer (when asked)
  2. Install the ManyEars Package
    1. Download and install File:ManyEars-0.2.rar
  3. Run FlowDesigner from the start menu
  4. (Optional) run audioviewer from C:\Program Files\FlowDesigner\bin
Notes :

July 23 2009. Updated phi for package ManyEars.
June 5 2009. Packages uploaded.

OSX Packages

  1. Download & Install Qt
    1. http://get.qtsoftware.com/qt/source/qt-mac-opensource-4.5.1.dmg
  2. Download and mount this image :
    1. File:FlowDesigner-0.10.0-RW.dmg
    2. Run FlowDesigner from the mounted image
    3. Open and run the FlowDesigner network described in the Configuration section.

If you want to run the audioviewer (after the image is mounted) :

  1. Start the terminal
  2. Enter the following commands :
    1. export PATH=/Volumes/FlowDesigner-0.10.0/FlowDesigner.app/Contents/Resources/bin:$PATH
    2. export DYLD_LIBRARY_PATH=/Volumes/FlowDesigner-0.10.0/FlowDesigner.app/Contents/Resources/lib/
    3. export DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:/Volumes/FlowDesigner-0.10.0/FlowDesigner.app/Contents/Resources/lib/flowdesigner/toolbox/ManyEars/lib/
  3. (Optional) Start audioviewer
    1. audioviewer
Notes :

July 23 2009. Updated phi for package.
June 5 2009. Packages uploaded.

Configuration

The following examples will output localization with OSC with the following configuration :

  • host = 127.0.0.1
  • port= 5678

Those settings can be changed by editing the .n files with FlowDesigner.


Microphone Array Configuration


Each microphone configuration must be ordered the same way they are connected to the sound card. Values are in cm.

Here is an example of the cube configuration :

<Matrix

<rows 8>
<cols 3>
<data

-18 16 -15.5
-18 16 15.5
18 16 -15.5
18 16 15.5
-18 -16 -15.5
-18 -16 15.5
18 -16 -15.5
18 -16 15.5
>
>

Here is an example of the planar octogonal configuration :

<Matrix

<rows 8>
<cols 3>
<data
12.5 30 0
-12.5 30 0
-30 12.5 0
-30 -12.5 0
-12.5 -30 0
12.5 -30 0
30 -12.5 0
30 12.5 0
>
>

Planar Array Configuration for 3D (with distance approximation)

  • Run This file for 3D localization
    • File:Tracking3D.n
    • Notice that the z value for all microphones in this example is 0 meaning that all microphones are in the same plane.

Standard Array Configuration (without distance approximation)

OSC Format (Updated)

  • Data is transmitted with Network byte order (MSB first)

//HEADER CONTAINS 24 BYTES
char header[12] = {'/','m','a','n','y','e','a','r','s', '\0', '\0','\0'};
char tags[12] = {',','i','f','f','f','f','f','f','f','\0','\0','\0'};

//DATA CONTAINS 32 BYTES
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,&theta,1);
BinIO::write<float>(outputString,&phi,1);
BinIO::write<float>(outputString,&distance,1);


//TOTAL = 56 BYTES

Output with OSC to more than one destination

To add an output do the following steps :

  1. Open the Tracking3D.n file
  2. Click on the "MAIN_LOOP" tab.
  3. Add the node : ManyEars->UDPOSCOut
  4. Add the node : General->NOP
  5. Connect the nodes to (like the original ones) to "node_SourceTrack_1"
  6. Hold Shift and mouse click on the output of the new UDPOSCOut
    1. Name the output with a different name than SOURCE_INFO
  7. Click on the "MAIN" tab.
  8. Hold Shift and mouse click on the output previously added to "MAIN_LOOP"
    1. You can keep the output name as suggested
  9. Save your document with a different name if required
  10. Run the document

Here is an example :