Python implementation of two measures of visual clutter (Feature Congestion and Subband Entropy)
Project description
visual-clutter
Python Implementation of two measures of visual clutter (Feature Congestion and Subband Entropy), Matlab Version, + library dependency.
Pre-requisites
-
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).
How to Install visual_clutter
pip install visual-clutter
How to use (Examples)
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)
Reference
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.
Citing
visual_clutter python package is now part of AIM2. AIM2 developed and supported by User Interfaces Research Group at Aalto University. If you use any part of this library in your research, please cite it using the following BibTex entry.
@inproceedings{oulasvirta2018aalto,
title={Aalto Interface Metrics (AIM) A Service and Codebase for Computational GUI Evaluation},
author={Oulasvirta, Antti and De Pascale, Samuli and Koch, Janin and Langerak, Thomas and Jokinen, Jussi and Todi, Kashyap and Laine, Markku and Kristhombuge, Manoj and Zhu, Yuxi and Miniukovich, Aliaksei and others},
booktitle={The 31st Annual ACM Symposium on User Interface Software and Technology Adjunct Proceedings},
pages={16--19},
year={2018}
}
@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}},
}
Related Repositories
Project details
Release history Release notifications | RSS feed
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 visual_clutter-1.0.6-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 45ae4a57530ab7dce254ee34c327fa6a60c92fc02f31b7edae51ceafeaf3f664 |
|
MD5 | 4117876c1c1d1c669849aac5b572c7e8 |
|
BLAKE2b-256 | c293c8e0edbc3ba893bd170d9868e29048bc8d387e142bacc38de6d24d62fa56 |