Metadata-Version: 2.4
Name: cpforager
Version: 1.1.3
Summary: Python package to handle data gathered from biologgers (GPS, TDR, AXY) attached to central-place foraging seabirds. The idea is to make movement ecology data a bit easier to process.
Project-URL: Homepage, https://github.com/AdrienBrunel/cpforager
Project-URL: Repository, https://github.com/AdrienBrunel/cpforager
Project-URL: Documentation, https://adrienbrunel.github.io/cpforager/
Project-URL: Issues, https://github.com/AdrienBrunel/cpforager/issues
Author-email: Adrien Brunel <adrien.brunel.pro@protonmail.com>
Maintainer-email: Adrien Brunel <adrien.brunel.pro@protonmail.com>
License-Expression: AGPL-3.0
License-File: LICENSE
Keywords: accelerometer,biologging,central-place,ecology,foraging,gps,movement,movement-ecology,seabird,tdr,telemetry
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.11
Requires-Dist: branca>=0.8.1
Requires-Dist: cartopy>=0.24.0
Requires-Dist: folium>=0.19.5
Requires-Dist: matplotlib>=3.10.3
Requires-Dist: numpy>=2.2.5
Requires-Dist: pandas>=2.2.3
Requires-Dist: pytz>=2025.2
Requires-Dist: scipy>=1.16.1
Requires-Dist: suntime>=1.3.2
Description-Content-Type: text/markdown

<h1 align="center">
  <img src="https://github.com/AdrienBrunel/cpforager/raw/master/docs/_static/images/logo_cpforager_text_color.png" alt="cpforager text logo with colors" width="600">
</h1><br>

<div align="center">
  <a href="https://github.com/AdrienBrunel/cpforager/stargazers"><img alt="github stars" src="https://img.shields.io/github/stars/AdrienBrunel/cpforager"></a>
  <a href="https://github.com/AdrienBrunel/cpforager/forks"><img alt="github forks" src="https://img.shields.io/github/forks/AdrienBrunel/cpforager"></a>
  <a href="https://github.com/AdrienBrunel/cpforager/issues"><img alt="github issues" src="https://img.shields.io/github/issues/AdrienBrunel/cpforager"></a>
  <a href="https://github.com/AdrienBrunel/cpforager/pulls"><img alt="github pull request" src="https://img.shields.io/github/issues-pr/AdrienBrunel/cpforager"></a>
  <a href="https://github.com/AdrienBrunel/cpforager/commits/main"><img alt="github last commit" src="https://img.shields.io/github/last-commit/AdrienBrunel/cpforager"></a>
</div>
<div align="center">
  <a href="https://github.com/AdrienBrunel/cpforager/blob/master/LICENSE"><img alt="license" src="https://img.shields.io/badge/license-AGPLv3-blue"></a>
  <a href="https://www.python.org/downloads/"><img alt="python 3.11+" src="https://img.shields.io/badge/Python-3.11+-blue.svg"></a>
</div>
<div align="center">
  <a href="https://badge.fury.io/py/cpforager"><img alt="pypi version" src="https://badge.fury.io/py/cpforager.svg"></a>
  <a href="https://pypi.org/project/cpforager/"><img alt="pypi downloads" src="https://img.shields.io/pypi/dm/cpforager.svg"></a>
</div><br>

<br>

Are you a scientist involved in movement ecology working with biologging data collected from central-place foraging seabirds? **cpforager** is a Python package designed to help you manipulate, process, analyse and visualise the biologging datasets with ease.

<br>

The main objectives of **cpforager** are :  
1. Efficiently handle large-scale biologging datasets, including high-resolution sensor data (*e.g.* accelerometers).
2. Provide a modular and extensible architecture, allowing users to tailor the code to their specific research needs.
3. Facilitate a smooth transition to Python for movement ecology researchers familiar with other languages (*e.g.* R).

<br>

**cpforager** package supports various biologging sensor types commonly used in movement ecology and provides the following core classes:
* `GPS` : for handling position recordings. 
* `TDR` : for handling pressure recordings.
* `AXY` : for handling tri-axial acceleration recordings at high resolution combined with lower resolution position and pressure recordings.
* `GPS_TDR` : for handling position and pressure recordings.

**cpforager** also allows to deal with a list of sensors using the following classes:
* `GPS_Collection` : for working with datasets composed of multiple GPS loggers.
* `TDR_Collection` : for working with datasets composed of multiple TDR loggers.
* `AXY_Collection` : for working with datasets composed of multiple AXY loggers.
* `GPS_TDR_Collection` : for working with datasets composed of multiple GPS_TDR loggers.

Each class automatically enhances raw data but also computes key features specific to each biologger (*e.g.* trip segmentation for GPS, dive segmentation for TDR, ODBA calculation for AXY). They are also accompanied with methods for data processing and visualisation.

<br>

<div align="center">
  <img src="https://github.com/AdrienBrunel/cpforager/raw/master/docs/_static/images/logo_cpforager_color.png" alt="cpforager logo with colors" width="200">
</div>

<br>