Metadata-Version: 2.1
Name: TrackPal
Version: 1.2.0
Summary: TrackPal: Tracking Python AnaLyzer
Home-page: https://git.ist.ac.at/csommer/trackpal
Author: Christoph Sommer
Author-email: christoph.sommer23@gmail.com
License: BSD
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: BSD License
Description-Content-Type: text/markdown
Requires-Dist: numpy
Requires-Dist: pandas (>=1.0.4)
Requires-Dist: scikit-image
Requires-Dist: scikit-learn (==0.21.1)
Requires-Dist: tifffile
Requires-Dist: tqdm
Requires-Dist: scipy
Requires-Dist: statsmodels
Requires-Dist: matplotlib
Requires-Dist: rdp
Requires-Dist: tqdm
Requires-Dist: pingouin

# TrackPal: Tracking Python AnaLyzer

A modular library for the analysis of object trackings in Python with pandas.

## Overview
### Main features
* Read Imaris / TrackMate files
* Simulate tracks with different motion types
* Compute track feature descriptors (~50 available features)
* Mean squared displacement curves for single tracks and ensembles
* Velocity autocorrelation curves for single tracks and ensembles
* Visualization utilities

For most computations TrackPal relies on pandas `groupby` and `apply` mechanism.

TrackPal does not track or link objects. It analyzes already tracked objects.
For obtaining object trackings from images or detections see for instance the
excellent projects [TrackMate](https://imagej.net/TrackMate),
[trackpy](http://soft-matter.github.io/trackpy) or [ilastik](ilastik.org)


## Examples

#### Simple simulation and plotting

```python
import trackpal as tp

trj = tp.simulate.brownian_linear(n_tracks=10)

trj.groupby("TrackID").apply(
    tp.visu.plot_trj, coords=["Position X", "Position Y"], line_fmt=".-",
)
```

Output:
![Output](doc/img/bl_tracks_01.png)


#### Track features

* Simulate different motion types and compute track feautures
    * [Features](examples/01_track_features.ipynb)

#### Mean squared displacement curves

* Calculate diffusion constant and velocity from different simulated motion types
    * [MSD](examples/02_mean_square_displacement_curves.ipynb)

## Installation

Anaconda Python (>=3.6) and a new environment are recommended

0. Install Anaconda Python (>=3.6)

```shell
conda create --name trackpal_env --python=3.7
conda activate trackpal_env
```

## Dependencies

* numpy
* pandas
* scikit_image
* scikit_learn
* tifffile
* tqdm
* scipy
* statsmodels
* matplotlib
* rdp
* tqdm

#### From PyPi:

1. `pip install TrackPal`

#### For development

1. `git clone` this repository
2. `cd trackpal`
3. `pip install -e .`


## Documentation

* [GitHub mirror](https://github.com/sommerc/trackpal)
* [GitLab IST](https://git.ist.ac.at/csommer/trackpal)
* [API documentation](https://trackpal.github.io/trackpal)



