A package to count scales on reptiles.
Project description
ScaleCounter
ScaleCounter allows users to count scales easily. The script has methods that can estimate the scales in a large area where scales are overall uniform but in some places difficult to count by hand. It can also count the total scales in smaller good quality images. There are two different methods that can handle for these cases. This should save time and tedium in laboratory settings, providing even results. The main code is in ScaleCounter_Public_Functions.py
Image Requirements
Works best for:
- scales and colonies that are not overlapping and instead are distinct
- images taken without flash
- scales and colonies that contrast their background/medium and are paler than the background
- scales with overall uniform color
- skin/background that has uniform color in image
*It is okay if there is uneven lighting in someplaces (as long as no flash)
- Example Image Sets: [Anolis-cristatellus-Imgs]((https://github.com/tanyasarkinjain/ScaleCount.git/test_images/Anolis_cristatellus_images) Anolis-Guanica-County-Imgs
Other Requirements
- numpy
- matplotlib
- opencv2
- IPython.display
- pandas
- image_slicer
- statistics
- datascience
Method Frameworks
count_scales():
count_scales(img_name, check_invert='auto', noise_thresh=1/7)
Ideal for smaller images that have very clearly defined scales. Image should be good quality and mostly countable by hand.
- Performs Otsu threshold and uses results to determine blocksize and iterations.
- Performs adaptive thresholding using selected blocksize and iterations. Removes noise.
- Calculates a score for the result based on scale size variation and uniformity of distribution. The lower the score, the better.
- If the score is too high, repeat steps 1-3 on inverted image and see if the score for the inverted image is lower. Keep the one with lower score.
count_scales_directory():
count_scales_directory(dirname)
Runs count_scales on each image in the directory.
split_count_select: Green boxes indicate steps unique to split_count_select()
split_count_select(img_path, num_subimages=0, num_to_keep=0)
Ideal for images that are large with scales/spots that are unclear in some regions.
For each subimage:
- Runs count_scales on each subimage.
- Finally, choose the subimages with the best scores.
- Estimates total count using the selected subimages.
display_results():
display_results(results_list, output_name="ScaleCounter_results_display", best_indices_lst=None, estimated_total=None)
Displays pdf showing labeled and counted images.
Examples (using count_scales):
Project details
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 ScaleCounter-0.0.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6455aa3b2bba8dc831bf5f358abaa1892b704903b7ef1202d1417ece8b91ea53 |
|
MD5 | b1c3f660e66e052c7bbbee70196c5b65 |
|
BLAKE2b-256 | 522c564137f00ffe8eef3c8e581dfcdb3f2701e689efedad05a03efba4f2c1d3 |