Welcome to Ketos’s documentation!


Ketos provides a unified, high-level interface for working with acoustic data and deep neural networks. Its main purpose is to support the development of deep learning models for solving challenging detection and classification problems in underwater acoustics.

Ketos is written in Python and utilizes a number of powerful software packages including NumPy, HDF5, and Tensorflow. It is licensed under the GNU GPLv3 license and hence freely available for anyone to use and modify. The project is hosted on GitLab at https://gitlab.meridian.cs.dal.ca/public_projects/ketos .

Ketos was developed by the MERIDIAN Data Analytics Team at the Institute for Big Data Analytics at Dalhousie University. We are greatful to Amalis Riera and Francis Juanes at the University of Victoria, Kim Davies and Chris Taggart at Dalhousie University, and Kristen Kanes at Ocean Networks Canada for providing us with annotated acoustic data sets, which played a key role in the early phases of the project. The first version of Ketos was released in April 2019.

The intended users of Ketos are primarily researchers and data scientists working with (underwater) acoustics data. While Ketos comes with complete documentation and comprehensive step-by-step tutorials, some familiarity with Python and especially the NumPy package would be beneficial. A basic understanding of the fundamentals of machine learning and neural networks would also be an advantage.

To get started with Ketos, follow the Installation instructions and then proceed to the Tutorials section. For an example application of Ketos, see Kirsebom, Frazao, et al., Performance of a deep neural network at detecting North Atlantic right whale upcalls, JASA, 147, 2636 (2020) (preprint).

The name Ketos was chosen to highlight the package’s main intended application, underwater acoustics. In Ancient Greek, the word ketos denotes a large fish, whale, shark, or sea monster. The word ketos is also the origin of the scientific term for whales, cetacean.

Indices and tables