2006-11-21

Example 1: whistle s9_1s code explained

s9_1s is the name (aka. "text" near the bottom of the code in the post below) for the whistle and is what is typed by the human user to emit that whistle and what is displayed in the Message window when a dolphin emits a similar whistle (a whistle that matches this one).

hz10ps means that the frequency (hz) sampling rate is 10 per second (ps). If the program uses a frequency sampling rate of 40 samples per second instead of 10 samples per second, then the program will internally convert the whistle to that rate (40 per second) by calculating the intermediate frequency values automatically.

length="10" means that there are 10 values in the array or list (each value is a frequency value in Hz or cycle per second) and because the frequency sampling rate is 10 per second (hz10ps) then this means that the whistle will last 1 second when emitted, and that it will match an acquired signal of that duration at the given frequencies (9 kHz).

index="0" means that the frequency value is at position 0 in the list. The first position in this list is always zero.

<double>9000.0</double> means that the frequency value is 9000.0 cycles per second, or 9000.0 Hz or 9.0 kHz.

Copyright (c) 2006 Serge Masse.
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation. A copy of the license is included in http://www.gnu.org/licenses/fdl.txt

Example 1: xml code for whistle s9_1s = 9 kHz tone lasting 1 second

Like all whistles, you insert this xml code in file signals_to_read.xml before the last line </java>:

<object class="org.leafyseadragon.jse.signal.StoredSignal">
<void property="hz10ps">
<array class="java.lang.Double" length="10">
<void index="0">
<double>9000.0</double>
</void>
<void index="1">
<double>9000.0</double>
</void>
<void index="2">
<double>9000.0</double>
</void>
<void index="3">
<double>9000.0</double>
</void>
<void index="4">
<double>9000.0</double>
</void>
<void index="5">
<double>9000.0</double>
</void>
<void index="6">
<double>9000.0</double>
</void>
<void index="7">
<double>9000.0</double>
</void>
<void index="8">
<double>9000.0</double>
</void>
<void index="9">
<double>9000.0</double>
</void>
</array>
</void>
<void property="signalType">
<string>LEX_SIGNAL</string>
</void>
<void property="text">
<string>s9_1s</string>
</void>
<void property="uid">
<string>s9_1s</string>
</void>
</object>

Copyright (c) 2006 Serge Masse.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation. A copy of the license is included in http://www.gnu.org/licenses/fdl.txt

First Post

This blog will contain whistles usable by the free Seadragon program to research dolphin communication.

The current version of the Seadragon program is 2.1. Future versions will probably include additional properties in the xml code for a whistle, such as human_source, cetacean_source, program_version, creation_date, etc.