ScaleCounter

A package to count scales on reptiles.


License
MIT
Install
pip install ScaleCounter==0.0.3

Documentation

ScaleCount

ScaleCount 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 ScaleCount_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)

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.

  1. Performs Otsu threshold and uses results to determine blocksize and iterations.
  2. Performs adaptive thresholding using selected blocksize and iterations. Removes noise.
  3. Calculates a score for the result based on scale size variation and uniformity of distribution. The lower the score, the better.
  4. 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.

Screenshot 2021-04-19 at 4 48 56 PM

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:

  1. Runs count_scales on each subimage.
  2. Finally, choose the subimages with the best scores.
  3. Estimates total count using the selected subimages.

Screenshot 2021-04-19 at 4 49 13 PM

display_results():

display_results(results_list, output_name="ScaleCount_results_display", best_indices_lst=None, estimated_total=None)

Displays pdf showing labeled and counted images.


Examples (using count_scales):

Screenshot 2021-04-16 at 12 48 31 AM