When enabled, an event message is output from the SMART Controller's serial port in response to a triggered event, such as a nearby bat vocalization or other ultrasonic noise.
Optional Leading String
Each event message may begin with a static string, entered into the Prepend to Event Line field on the Serial Output tab. By default, the optional string is empty.
Event Fields
After the optional leading string, the event message contains any selected fields from the most recent line in the results.csv file, separated by commas.
| Abbreviation | Full Name | Format or Unit | Definition |
|---|---|---|---|
| Prefix | Microphone prefix | Prefix or name assigned to the microphone that recorded the event. | |
| Date | YYYY-MM-DD | Date on which the event began. | |
| Time | hh:mm:ss.uuuuuu, where uuuuuu are microseconds | Time at which the event began. | |
| Duration | s | Duration of the event. | |
| N | Number of Pulses | Number of detected bat pulses in the event. Other call parameters are averaged across N pulses in each event. | |
| Fc | Average Characteristic Frequency | Hz | The frequency of the flattest point of each pulse, where slope has its absolute minimum value, averaged across N pulses. |
| Sc | Average Characteristic Slope | octaves per second (OPS) | The minimum slope of each pulse, which defines the call body, averaged across N pulses. |
| Fmax | Average Maximum Frequency | Hz | The maximum frequency detected in each pulse, averaged across N pulses. |
| Fmin | Average Minimum Frequency | Hz | The minimum frequency detected in each pulse, averaged across N pulses. |
| Fmean | Average Mean Frequency | Hz | The mean frequency of each pulse, averaged across N pulses. |
| TBC | Average Time Between Calls | s | If N > 1, the average period from the start of one pulse to the start of the next. |
| Fk | Average Knee Frequency | Hz | The frequency at the beginning of each pulse's call body, averaged across N pulses. |
| Tk | Average Time to Knee | s | The time from the beginning of each pulse to the call body, averaged across N pulses. |
| S1 | Average Initial Slope | OPS | The slope from the beginning of each pulse to the knee, averaged across N pulses. |
| Tc | Average Time to Characteristic | s | The duration from the beginning of each pulse to the end of the call body, averaged across N pulses. |
| Dur | Average Pulse Duration | s | The full duration of each pulse, averaged across N pulses. |
| CRC7 | two hexidecimal characters | Optional checksum. |
Optional Terminating String
Each event message may end with a static string, entered into the End
Event Line With field on the Serial Output tab. By default, this
string is \r\n, corresponding to a Carriage Return followed by a
Line Feed.
Serial Port Event Message
In this example, the leading string for event messages was set to
EVENT. The triggering sound source was a series of 40 kHz beeps
emitted by a signal generator.
EVENT,9c.25.be.01.00.56,2024-11-05,13:24:51.530642,0.401,9,39903,0.05,40619,39802,40012,0.328976,40002,0.000350,166.17,0.048,0.048,31| Field | Example Value |
|---|---|
| Leading String | EVENT |
| Prefix | 9c.25.be.01.00.56 |
| Date | 2024-11-05 |
| Time | 13:24:51.530642 |
| Duration | 0.401 s |
| N | 9 |
| Fc | 39903 Hz |
| Sc | 0.05 OPS |
| Fmax | 40619 Hz |
| Fmin | 39802 Hz |
| Fmean | 40012 Hz |
| TBC | 0.328976 s |
| Fk | 40002 Hz |
| Tk | 0.000350 s |
| S1 | 166.17 OPS |
| Tc | 0.048 s |
| Dur | 0.048 s |
| CRC7 | 31 |