A tool for manually creating ground truth masks from images where a significant amount of detail is required. Particularily suited for large images of plant roots.
An in-depth installation guide can be found here The latest release of the project can be downloaded here.
A windows executable can be downloaded here.
You should be able to just download and run it. You may need administrator privileges.
NOTE: If windows gives a popup saying that "it protected you from a file", click on "more info", and then "run anyways".
An Ubuntu version of the app can be downloaded here.
The zip file contains an executable binary file, an image, and a bash script that will install the application.
wget https://github.com/p2irc/friendly_ground_truth/releases/latest/download/friendly_gt-ubuntu.zip
unzip friendly_gt-ubuntu.zip
cd friendly_gt_ubuntu
bash install_friendly_gt.sh
At this point, if no prompt appears, the application has been installed.
Otherwise:
Add ~/bin to your path? (Y/N): yes
Specify bash profile file (blank uses ~/.bashrc): ~/.bash_profile # This can be left blank if you prefer
wget https://github.com/p2irc/friendly_ground_truth/releases/latest/download/friendly_gt-ubuntu.zip
unzip friendly_gt-ubuntu.zip
cd friendly_gt_ubuntu
chmod u+x friendly_gt_ubuntu-latest
./friendly_gt_ubuntu-latest
A MacOs binary can be downloaded here.
You will need to change the permissions of the binary file to be executable, and then you can run it by double clicking it in the file browser, or by navigating to it in the terminal and typing ./friendly_gt_macos-latest.
Copy-pasta:
wget https://github.com/p2irc/friendly_ground_truth/releases/latest/download/friendly_gt_macos-latest
chmod u+x friendly_gt_macos-latest
./friendly_gt_macos-latest
An experimental MacOs application bundle can be downloaded here. This bundle has not been fully tested, and may not work at all. It should be runnable just like any other mac app bundle once you have unzipped it. If you encounter problems with this bundle, please leave a Bug Report.
A user manual can be found in the wiki
Please report any software bugs on the issues page.
Thanks in advance for helping out!
Detailed information about development for this application can be found on the Wiki
This application is developed using python3 and virtualenv. Dependencies are found in requirements.txt. To get started:
python -m venv env
source ./venv/bin/activate
pip install -r requirements.txt
The main entrypoint for the application is run.py. To run it, simply do python run.py -debug. The -debug flag is optional and enables logging.
Tests have been developed using pytest, with the mocker and coverage modules. All tests can be found in the tests/ directory. To run tests, make sure you are in the main repository folder:
pytest --cov=friendly_ground_truth ./tests --cov-branch --cov-report=term-missing
This will run all tests and print a coverage report specifying any missed lines. A coverage check is run as part of all pull-requests.
Please refer to the Wiki for more details about the development process.
Documentation can be generated with pdoc. Make sure to pip install pdoc3
cd doc
pdoc --html ../friendly_ground_truth/
Internal documentation that has been generated by pdoc and can be found here