yupi 1.0.2

A package for tracking and analysing objects trajectories

Standing for Yet Underused Path Instruments, yupi is a set of tools designed for collecting, generating and processing trajectory data.

Main features

• Convert raw data to trajectories ... different input manners
• I/O operations with trajectories ... json and csv serializers
• Trajectory extraction from video inputs ... even with moving camera
• Artificial trajectory generation ... several models implemented
• Trajectory basic operations ... rotation, shift, scaling, ...
• Trajectory transformations ... filters, resamplers, ...
• Statistical analysis from trajectories ensembles ... turning angles histogram, velocity autocorrelation function, power spectral density, and much more ...
• Results visualization ... each statistical observable has a related plot function
• Spacial projection of trajectories ... for 2D and 3D trajectories

Installation

Current recommended installation method is via PyPI:

pip install yupi

Compatibility

• Python 3.10 or later
• Ubuntu 18.04 or later
• Windows 7 or later
• macOS 10.12.6 (Sierra) or later.

Getting Started

In the official documentation there are some resources to start using the library: Tutorials, Examples and a detailed description of the API.

Examples

Code examples (with additional multimedia resources) can be found in this repository. Additionally, in the Examples section of the documentation, you can find the same examples with additional comments and expected execution results in order to inspect the examples without actually executing them.