22[ ![ Pylint] ( https://github.com/TimoK93/ctc-metrics/actions/workflows/pylint.yml/badge.svg )] ( https://github.com/TimoK93/ctc-metrics/actions/workflows/pylint.yml )
33[ ![ Python package] ( https://github.com/TimoK93/ctc-metrics/actions/workflows/python-package.yml/badge.svg )] ( https://github.com/TimoK93/ctc-metrics/actions/workflows/python-package.yml )
44
5- # CTC-Metrics
6- A python implementation of the metrics used in the
7- [ Cell-Tracking-Challenge] ( https://celltrackingchallenge.net/ ) . Additionally,
8- [ CHOTA] ( ... ) ,
9- and the metrics of the
10- [ MOTChallenge] ( https://motchallenge.net/ ) are implemented.
5+ # Py-CTCMetrics
6+ A python implementation of the metrics used in the paper
7+ [ CHOTA: A Higher Order Accuracy Metric for Cell Tracking] ( ... ) by
8+ * Kaiser et al.* . The code is
9+ designed to evaluate tracking results in the format of the
10+ [ Cell-Tracking-Challenge] ( https://celltrackingchallenge.net/ ) but can also be used
11+ for custom results.
12+ The repository contains the metrics of the
13+ [ Cell-Tracking-Challenge] ( https://celltrackingchallenge.net/ ) ,
14+ the [ MOTChallenge] ( https://motchallenge.net/ ) , and the
15+ [ CHOTA] ( ... ) metric.
16+
17+ Detailed descriptions of the metrics can be found in the [ paper] ( ... ) .
1118
19+ ---
20+
21+ # Features at a Glance
1222
23+ - ** Validation** : Check if the tracking results are correctly formatted.
24+ - ** Evaluation** : Evaluate the tracking results with respect to the ground truth using CTC, MotChallenge, and CHOTA metrics.
25+ - ** Visualization** : Visualize the tracking results.
26+ - ** Video Creation** : Create a video of the visualized tracking results for presentation purposes.
27+ - ** Noise Evaluation** : Evaluate the impact of specific errors on the evaluation metrics.
28+
1329---
1430
15- ### Requirements
31+ ## Requirements
1632
1733We tested the code with ** Python 3.10** . Additional packages that will be
1834installed automatically are listed in the [ requirements.txt] ( requirements.txt ) .
1935
36+ ---
37+
2038## Installation
2139
2240The package can be installed via pip:
2341
2442``` bash
25- pip install git+https://github.com/TimoK93/ctc-metrics .git
43+ pip install git+https://github.com/CellTrackingChallenge/py-ctcmetrics .git
2644```
2745
2846or from the source code:
2947
3048``` bash
31- git clone https://github.com/TimoK93/ctc-metrics
32- cd ctc-metrics
49+ git clone https://github.com/CellTrackingChallenge/py-ctcmetrics
50+ cd py-ctcmetrics
3351pip install .
3452```
3553
54+ ---
55+
3656## Usage
3757
3858
@@ -99,7 +119,8 @@ The ```gt``` argument specifies the path to the ground truth directory, and the
99119recursively evaluates all sequences in the directory.
100120
101121Per default, the code is executed using multiple processes with one process per
102- available CPU core. Multiprocessing increases the execution time but also
122+ available CPU core. Multiprocessing decreases the execution time but also
123+ increases
103124the memory consumption. If you need to set the maximal number of processes,
104125the number of processes can be specified with the argument
105126``` --num-threads ``` or ``` -n ``` :
@@ -259,13 +280,17 @@ The following table shows the available arguments:
259280| -- save-after | Save the intermediate results after a specific number of runs. | 100 |
260281
261282
283+ ---
284+
262285## Notes
263286
264287- If you only have segmentation results and want to evaluate the * SEG* metric,
265288it is important that you pass the * --seg* flag to the evaluation command.
266289Otherwise, the code could flag your input as invalid, because the
267290* res_track.txt* file is missing or inconsistent.
268291
292+ ---
293+
269294## Contributing
270295
271296Contributions are welcome! For bug reports or requests please
@@ -280,14 +305,16 @@ pip install pre-commit, pylint
280305pre-commit run --all-files
281306```
282307
308+ ---
309+
283310## Acknowledgement and Citations
284311
285312The code was developed by Timo Kaiser on behalf of the [ Institute of Information
286313Processing] ( https://www.tnt.uni-hannover.de/ ) at the Leibniz University Hanover in conjunction with the
287314organizers of the [ Cell-Tracking-Challenge] ( https://celltrackingchallenge.net/ ) .
288315
289316
290- If you use this code or the [ CHOTA] ( ) metric in your research, please cite the following paper:
317+ If you use this code or the CHOTA metric in your research, please cite the following paper:
291318``` bibtex
292319@inproceedings{kaiser2024chota,
293320 author = {Kaiser, Timo and Ulman, Vladimír and Rosenhahn, Bodo},
@@ -363,6 +390,8 @@ If you use the MOTA metric in your research, please cite the following paper:
363390}
364391```
365392
393+ ---
394+
366395## License
367396
368397This project is licensed under the BSD 2-Clause License - see the
0 commit comments