Python Implementation of two measures of visual clutter (Feature Congestion and Subband Entropy), Matlab Version, + library dependency.
-
This utility is written in Python 3. You will need a Python 3 interpreter installed or you will have to package this into a self contained executable.
-
This utility uses Pyrtools. So you will need to run it on Linux or on OSX. Windows is NOT supported because of issues with the C compiler (gcc isn't necessarily installed).
pip install visual-clutter
# install from git
pip install git+https://github.com/kargaranamir/visual-clutter
from visual_clutter import Vlc
# make visual clutter object and load test map and set parameters
clt = Vlc('./tests/test.jpg', numlevels=3, contrast_filt_sigma=1, contrast_pool_sigma=3, color_pool_sigma=3)
# get Feature Congestion clutter of a test map:
clutter_scalar_fc, clutter_map_fc = clt.getClutter_FC(p=1, pix=1)
# get Subband Entropy clutter of the test map:
clutter_scalar_se = clt.getClutter_SE(wlevels=3, wght_chrom=0.0625)
print(f'clutter_scalar_fc: {clutter_scalar_fc}')
print(f'clutter_scalar_se: {clutter_scalar_se}')
# just compute and display color clutter map(s)
color_clutter = clt.colorClutter(color_pix=1)
# just compute and display contrast clutter map(s)
contrast_clutter = clt.contrastClutter(contrast_pix=1)
# just compute and display orientation clutter map(s)
orientation_clutter = clt.orientationClutter(orient_pix=1)
Ruth Rosenholtz, Yuanzhen Li, and Lisa Nakano. "Measuring Visual Clutter".
Journal of Vision, 7(2), 2007. http://www.journalofvision.com/7/2/
Ruth Rosenholtz, Yuanzhen Li, and Lisa Nakano, May 2007.
visual_clutter python package is now part of AIM2. If you use any part of this library in your research, please cite it using the following BibTex entry. Bibtex entry for AIM2 will be added once it is released.
@misc{visual_clutter,
author = {Kargaran, Amir Hossein},
title = {Visual Clutter Python Library},
year = {2021},
publisher = {GitHub},
journal = {GitHub Repository},
howpublished = {\url{https://github.com/kargaranamir/visual-clutter}},
}
- Master Thesis: Unveiling the Inner Structures of the Montreux Jazz Festival Concert
- Proceedings of the Human Factors and Ergonomics Society Annual Meeting: Evaluating the Usability of Common Warnings across Industries Using the System Usability Scale