{"id":13585292,"url":"https://github.com/andrewekhalel/sewar","last_synced_at":"2025-04-08T08:14:16.478Z","repository":{"id":41423605,"uuid":"145829544","full_name":"andrewekhalel/sewar","owner":"andrewekhalel","description":"All image quality metrics you need in one package.","archived":false,"fork":false,"pushed_at":"2023-10-04T01:06:05.000Z","size":2824,"stargazers_count":604,"open_issues_count":12,"forks_count":71,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-04-01T05:34:06.576Z","etag":null,"topics":["image-processing","quality-metrics","super-resolution"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andrewekhalel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-08-23T09:11:28.000Z","updated_at":"2025-03-06T01:38:06.000Z","dependencies_parsed_at":"2022-08-31T03:23:14.284Z","dependency_job_id":null,"html_url":"https://github.com/andrewekhalel/sewar","commit_stats":{"total_commits":90,"total_committers":5,"mean_commits":18.0,"dds":"0.18888888888888888","last_synced_commit":"d2fd6805e8dc812483a86ae231d8a5685dffdf38"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrewekhalel%2Fsewar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrewekhalel%2Fsewar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrewekhalel%2Fsewar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrewekhalel%2Fsewar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andrewekhalel","download_url":"https://codeload.github.com/andrewekhalel/sewar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247801169,"owners_count":20998339,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["image-processing","quality-metrics","super-resolution"],"created_at":"2024-08-01T15:04:51.244Z","updated_at":"2025-04-08T08:14:16.444Z","avatar_url":"https://github.com/andrewekhalel.png","language":"Python","funding_links":["https://www.buymeacoffee.com/khalel"],"categories":["Python","Tools"],"sub_categories":["General-purpose image quality estimation"],"readme":"\u003ca href=\"https://www.buymeacoffee.com/khalel\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" style=\"height: 60px !important;width: 217px !important;\" \u003e\u003c/a\u003e\n\n# Sewar\n\n[![Downloads](https://static.pepy.tech/badge/sewar)](https://pepy.tech/project/sewar)\n[![Build Status](https://github.com/andrewekhalel/sewar/actions/workflows/workflow.yaml/badge.svg\n)](https://github.com/andrewekhalel/sewar/actions/workflows/workflow.yaml)\n[![codecov](https://codecov.io/gh/andrewekhalel/sewar/graph/badge.svg?token=D4SH5yVpYZ)](https://codecov.io/gh/andrewekhalel/sewar)\n[![PyPI version](https://badge.fury.io/py/sewar.svg)](https://badge.fury.io/py/sewar)\n\nSewar is a python package for image quality assessment using different metrics. You can check documentation [here](http://sewar.readthedocs.io/).\n\n\n## Implemented metrics\n- [x] Mean Squared Error (MSE) \n- [x] Root Mean Squared Error (RMSE)\n- [x] Peak Signal-to-Noise Ratio (PSNR) [[1]](https://ieeexplore.ieee.org/abstract/document/1284395/)\n- [x] Structural Similarity Index (SSIM) [[1]](https://ieeexplore.ieee.org/abstract/document/1284395/)\n- [x] Universal Quality Image Index (UQI) [[2]](https://ieeexplore.ieee.org/document/995823/)\n- [x] Multi-scale Structural Similarity Index (MS-SSIM) [[3]](https://ieeexplore.ieee.org/abstract/document/1292216/)\n- [x] Erreur Relative Globale Adimensionnelle de Synthèse (ERGAS) [[4]](https://hal.archives-ouvertes.fr/hal-00395027/)\n- [x] Spatial Correlation Coefficient (SCC) [[5]](https://www.tandfonline.com/doi/abs/10.1080/014311698215973)\n- [x] Relative Average Spectral Error (RASE) [[6]](https://ieeexplore.ieee.org/document/1304896/)\n- [x] Spectral Angle Mapper (SAM) [[7]](https://ntrs.nasa.gov/search.jsp?R=19940012238)\n- [x] Spectral Distortion Index (D_lambda) [[8]](https://www.ingentaconnect.com/content/asprs/pers/2008/00000074/00000002/art00003)\n- [x] Spatial Distortion Index (D_S) [[8]](https://www.ingentaconnect.com/content/asprs/pers/2008/00000074/00000002/art00003)\n- [x] Quality with No Reference (QNR) [[8]](https://www.ingentaconnect.com/content/asprs/pers/2008/00000074/00000002/art00003)\n- [x] Visual Information Fidelity (VIF) [[9]](https://ieeexplore.ieee.org/abstract/document/1576816/)\n- [x] Block Sensitive - Peak Signal-to-Noise Ratio (PSNR-B) [[10]](https://ieeexplore.ieee.org/abstract/document/5535179/)\n\n## Todo\n- [ ] Add command-line support for No-reference metrics\n\n## Installation\nJust as simple as\n```\npip install sewar\n```\n## Example usage\na simple example to use UQI\n```python\n\u003e\u003e\u003e from sewar.full_ref import uqi\n\u003e\u003e\u003e uqi(img1,img2)\n0.9586952304831419\n```\n\n## Example usage for command line interface\n```\nsewar [metric] [GT path] [P path] (any extra parameters)\n```\nAn example to use SSIM\n```shell\nfoo@bar:~$ sewar ssim images/ground_truth.tif images/deformed.tif -ws 13\nssim : 0.8947009811410856\n```\nAvailable metrics list\n```\nmse, rmse, psnr, rmse_sw, uqi, ssim, ergas, scc, rase, sam, msssim, vifp, psnrb \n```\n\n## Contributors\nSpecial thanks to @sachinpuranik99 and @sunwj.\n\n## References\n[1] \"Image quality assessment: from error visibility to structural similarity.\" 2004)\u003cbr/\u003e\n[2] \"A universal image quality index.\" (2002)\u003cbr/\u003e\n[3] \"Multiscale structural similarity for image quality assessment.\" (2003)\u003cbr/\u003e\n[4] \"Quality of high resolution synthesised images: Is there a simple criterion?.\" (2000)\u003cbr/\u003e\n[5] \"A wavelet transform method to merge Landsat TM and SPOT panchromatic data.\" (1998)\u003cbr/\u003e\n[6] \"Fusion of multispectral and panchromatic images using improved IHS and PCA mergers based on wavelet decomposition.\" (2004)\u003cbr/\u003e\n[7] \"Discrimination among semi-arid landscape endmembers using the spectral angle mapper (SAM) algorithm.\" (1992)\u003cbr/\u003e\n[8] \"Multispectral and panchromatic data fusion assessment without reference.\" (2008)\u003cbr/\u003e\n[9] \"Image information and visual quality.\" (2006)\u003cbr/\u003e\n[10] \"Quality Assessment of Deblocked Images\" (2011)\u003cbr/\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrewekhalel%2Fsewar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandrewekhalel%2Fsewar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrewekhalel%2Fsewar/lists"}