Sid: image processing for seed images¶
Author: Yoav Ram
Source code: GitHub
Sid is an open-source Python package for image processing of plant seed images, specifically Lamium amplexicaule.
- pywin32 (on Windows)
For testing and documentation:
- Install the Anaconda Python distribution.
- Update all Python packages using conda:
>>> conda update --all --yes
- Install Sid using pip:
>>> pip install Sid
- Check that Sid was installed properly by running the take_cover script:
>>> take_cover --version Sid, version x.x.x
x.x.x will be replaced by the current version (0.2.4+7.g9d5396b).
When installing on Windows, if you get an error trying to install pywin32 or pypiwin32, try to run:
>>> conda install pywin32 --yes
To upgrade to the newest version of Sid (0.2.4+7.g9d5396b):
>>> conda update --all --yes >>> pip install --upgrade Sid >>> take_cover --version Sid, version x.x.x
Use by running:
The script will first ask for a folder name - this will be the working directory from which the script will read
.jpg files and to which it will write
The script will then ask if the folder should be processed Continuously or once.
For more options, see the help message:
>>> take_cover --help
In this case the script will wait for new
.jpg files in the folder. When a new
.jpg file is created, the script will process it, creating
.png files with the color spaces and the segmentation checkpoints, open the segmentation image, and will print the final stats to the screen.
In this case the script will go over all
.jpg files in the folder and process them. It will produce
.png files with the color spaces and the segmentation checkpoints and two
.csv files: one with the final stats for each
.jpg file and one with the histograms that were used to find the features on the seed (background, eliosom, cover).
take_cover.json is the configuration file which includes values of different parameters of the algorithm, including segmentation thresholds.
Please contact Yoav Ram with questions and comments.
Bugs and feature requests can be opened on GitHub Issues
Developers should clone the repository from GitHub and install it in editable mode:
>>> git clone https://github.com/yoavram/Sid.git >>> cd Sid >>> pip install -e .
Sid source code and examples are licensed under the terms of the MIT license.
Sid documentation, examples, and other materials are licensed under the terms of the Creative Commons Attribution 4.0 International (CC BY 4.0) license