ParticleTracking/CITATION.cff at main · ANP-Granular/ParticleTracking · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
cff-version: 1.2.0
title: ParticleTracking
message: >-
  If you use this software, please cite it using the
  metadata from this file.
type: software
authors:
  - given-names: Adrian
    family-names: Niemann
    email: adrian.niemann@gmx.de
    orcid: 'https://orcid.org/0009-0008-2025-1946'
  - given-names: Dmitry
    family-names: Puzyrev
    orcid: 'https://orcid.org/0000-0002-9269-3224'
identifiers:
  - type: url
    value: 'https://github.com/ANP-Granular/ParticleTracking'
repository-code: 'https://github.com/ANP-Granular/ParticleTracking'
abstract: >-
  ParticleTracking is a repository containing two Python
  packages for extracting 3D particle coordinate data from
  the experimental video footage.

  In these experiments a granular gas (dilute ensemble of
  macroscopic particles) was observed with a 2-view stereo
  camera system.

  The current version of the program is used for experiments
  with rod-like particles. Each particle is parametrized by
  2 endpoint coordinates.

  ParticleTracking's goal is to automatically extract the
  coordinate data and provide a Graphical User Interface
  (GUI) to correct detection errors manually in an efficient
  way.

  Then, the corrected particle data can be tracked and
  ensemble statistics (average velocity/kinetic energy,
  local packing fractions, etc.) can be extracted.


  The first part is the ParticleDetection package that
  enables:

  - training of Mask-RCNN models for detecting particles in
  stereo-camera images

  - assignment of particle correspondences between both
  images of the stereo setup

  - reconstruction of 3D coordinates and orientations for
  particles identified in both stereo images

  - tracking of particles over the course of an experiment


  The RodTracker package is a GUI encapsulating the most
  used functionality of the ParticleDetection package. It
  enables users to carry out the aforementioned tasks,
  except for training a model. Additionally, it provides the
  means to manually correct object localization, 3D
  assignment and tracking errors in the automatic detection
  processes.
keywords:
  - physics
  - object-detection
  - 3D-reconstruction
  - microgravity
license: GPL-3.0
commit: 9e319201440b9c7fae455117b18023e7bf82beb7