riggsd / zcant

Myotisoft ZCANT, a zero-crossing analysis tool for bat echolocation data
MIT License
3 stars 1 forks source link
anabat bat-acoustics bat-detector bats echolocation zero-cross

Myotisoft ZCANT

ZCANT is a tool for analyzing bat echolocation calls. Specifically, it extracts the echolocation signal using the zero-crossing technique pioneered by Chris Corben, with a few modern twists:

ZCANT Screenshot

License

ZCANT is Free / Open Source Software, cross-platform, and written in the Python programming language. It can serve as the base for your own bat acoustics software projects! See the file LICENSE.txt for details of the MIT License.

Copyright (C) 2012-2017 by Myotisoft LLC http://myotisoft.com

Requirements

Installation

  1. Download and install Python 2.7, or verify that your existing version is 2.7 with with python --version.

  2. Install wxPython "classic" 3.0.2.0. See https://wiki.wxpython.org/How%20to%20install%20wxPython for details, or use the following direct links: Window 32-bit Windows 64-bit Mac OSX

  3. Download the ZCANT source code, either by downloading the latest ZCANT release .zip, or by cloning your own copy of the source repository with the commands:

    $> git clone https://github.com/riggsd/zcant.git
    $> cd zcant

  4. The remainder of the dependency libraries can be installed using pip:

    $> pip -r requirements.txt

  5. Start ZCANT:

    $> python zcant.py

Usage

Runtime settings which tweak the display of data are found under the View menu.

Settings which control how full-spectrum data is converted into zero-cross data are found under the Conversion menu.

At this time, most functionality is controlled with your keyboard. Refer to the file docs/keybindings.txt for a full list of keybindings, but the following quick-start guide should get you up and running:

Credits

ZCANT was written by David A. Riggs of Myotisoft LLC. Inspiration for zero-cross analysis of bat echolocation, as well as the Anabat file format by Chris Corben.

Free / Open Source software utilized: Python, NumPy, MatPlotLib, and wxPython for the core of the application. Sound playback thanks to the sounddevice / PortAudio library. Graphic icons by Open Iconic.