Callmark is a Matlab GUI tool for marking calls or other sounds in multi-recording from animals. It allow user to switch between different channels while editing the marked call locations. The marked call locations can then be saved as a separate file and loaded again for further editing.

Input to the program can be a WAV or a MAT file. If a MAT file, it should contain sig (sound recording) and fs (sampling frequency in Hz). Below is an example of the structure of an input file that has 32 channels, 4 seconds of recording, sampled at 250 kHz:

Name         Size          Bytes       Class     Attributes
  fs           1x1              8      double              
  sig    1000002x32     256000512      double        

• Load []
  Load data file in WAV or MAT format. If this is the first time you load a particular file, you will see two file/folder selection windows with prompts

  1. Select the folder containing the recording files and
  2. Select the folder containing *_detect.mat files. [this needs to be a different folder than the above]

  These windows won't pop up if you try to load another recording file in the same folder.

  After selecting these paths, you will see another window popping up for you to select the actual recording file you want to analyze. [Once selected, a waveform window will pop up, choose channel and press select to allow starting the detection process]

  If you load a xxx_detect.mat file instead of a signal (e.g., xxx.mat or xxx.wav), you have to press the Detect calls to bring up the spectrogram and previously saved marked calls.

• Detect calls
  Initialize simple energy detection of calls. This button will also bring up the (spectrogram and) time series display. [in time series display, click the threshold you like in it, and the detections will be shown in red asterisks. Accept the new threshold if you like the results]. Note that there is usually a bit of lag after you accept the simple threshold detection until [] the spectrogram shows up, so don't be alarmed if nothing seems to be happening for a few seconds.

• Add mark
  Add a call mark on where you click.

• Remove mark
  Remove all marks enclosed in a dragged rectangular area on the spectrogram.

• Done & Save
  Save the marked calls in a new file with default filename: xxx_detect.mat, where xxx is the filename of the loaded data file. Therefore, the call marking results and the raw data are kept as separate files.

• Channel ++/--
  Change the source of the displayed spectrogram and time series to another channel. The call marks will not change location.

• Current ch#
  Enter a specific channel number to change the source of the displayed spectrogram and time series to another channel. The call marks will not change location.

• The MATLAB figure tools Zoom in, Zoom out, and Pan are active in this program so that you can move around easily in the recorded time series.
• The scroll bar on the right-hand side of the spectrogram is used to control the coloraxis of spectrogram.
• After saving xxx_detect.mat, you can use Load file to load either xxx_detect.mat or xxx.mat to review what has been saved.
• Ignore the button Load track and the Video fps (Hz) box as they are used in a specific case when the sound recording is accompanied by a current movement trajectory.