GUI to track rod-like particles on multiple cameras
Project description
RodTracker
This package provides 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 placement and assignment mistakes of the automated processes.
Please refer to the documentation for more detailed information.
Installation
Refer to the documentation for more details on the installation process.
Installation as a standalone program
Use the provided executable installer for your operating system provided in the repository releases:
RodTracker-Setup.exe
- WindowsRodTracker-Setup.deb
- LinuxRodTracker-Setup.dmg
- macOS
Note: There might not always be a version provided for macOS.
Installation as a python package
Requirements:
- Python
>=3.8
- pip
Install the default version using pip:
pip install RodTracker
Or use one of the options described in the documentation.
pip install RodTracker[OPTION]
Install it from source by:
- Cloning the repository containing the RodTracker. Do NOT just copy the
RodTracker
folder. This will lead to a missing dependency during the installation. - Install it using
pip
.YOUR/REPO/PATH/RodTracker$ pip install .
It is also possible to install it directly from GitHub (requires Git
to be installed):
pip install 'git+https://github.com/ANP-Granular/ParticleTracking.git#egg=rodtracker&subdirectory=RodTracker'
pip install 'rodtracker[DOCS] @ git+https://github.com/ANP-Granular/ParticleTracking.git#egg=RodTracker&s
ubdirectory=RodTracker'
Running the RodTracker
Run the RodTracker GUI using one of the possibilities:
- (Standalone Program) Run the executable installed by the installer.
- (Python Package) Run
main.py
manually:YOUR/REPO/PATH/RodTracker/src/RodTracker$ python main.py
- (Python Package) Use the registered command:
ARBITRARY/PATH$ RodTracker
Keyboard shortcuts
Feature | Shortcut |
---|---|
Open images | Ctrl + O |
Save rod position data | Ctrl + S |
Switch to next/previous view | Ctrl+Tab |
Zoom in/out | + /- Ctrl+Wheel |
Fit image to available space | F |
Show in original size | Ctrl + R |
Next/previous image | Right /Left |
Undo | Ctrl + Z |
Lengthen/Shorten a rod | A /S |
Lengthen/Shorten all rods in current view | R /T |
Delete a selected rod | Del |
Toggle automatic rod selection mode | G |
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for rodtracker-0.6.3.dev23-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 36cf4ef873018b4fc160a3eac36cf31ecc5a5739627c0403daf80247a3a42a05 |
|
MD5 | 3f0ffd9caa544b9973ae19b78afdbfa1 |
|
BLAKE2b-256 | 46b08d13edae09b0aef666addacbd0c9277fab4e29fb5100626299cc15d05170 |