scikit-diveMove Documentation#

scikit-diveMove is a Python interface to R package diveMove for scientific data analysis, with a focus on diving behaviour analysis. It has utilities to represent, visualize, filter, analyse, and summarize time-depth recorder (TDR) data. Miscellaneous functions for handling location data are also provided.

scikit-diveMove is hosted at spluque/scikit-diveMove

scikit-diveMove also provides useful tools for processing signals from tri-axial Inertial Measurement Units (IMU), such as thermal calibration, corrections for shifts in coordinate frames, as well as computation of orientation using a variety of current methods. Analyses are fully tractable by encouraging the use of xarray data structures that can be read from and written to NetCDF file format. Using these data structures, meta-data attributes can be easily appended at all layers as analyses progress.

Installation#

Type the following at a terminal command line:

pip install scikit-diveMove

Or install from source tree by typing the following at the command line:

python setup.py install

Once installed, skdiveMove can be easily imported as:

import skdiveMove as skdive

Dependencies#

skdiveMove depends primarily on R package diveMove, which must be installed and available to the user running Python. If needed, install diveMove at the R prompt:

install.packages("diveMove")

Testing#

The skdiveMove package can be tested with unittest:

python -m unittest -v skdiveMove/tests

or pytest:

pytest -v skdiveMove/tests

Development#

Developers can clone the project from Github:

git clone https://github.com/spluque/scikit-diveMove.git .

and then install with:

pip install -e .["dev"]

Indices and tables#