{"id":15356369,"url":"https://github.com/saravanabalagi/imshowtools","last_synced_at":"2025-04-15T06:40:09.134Z","repository":{"id":57437866,"uuid":"172528554","full_name":"saravanabalagi/imshowtools","owner":"saravanabalagi","description":"View images in Jupyter notebooks in a much simpler and intuitive way. Ships with a better 'imshow' function with Smart Wrap and BGR support with 'cvshow'!","archived":false,"fork":false,"pushed_at":"2020-05-28T14:12:08.000Z","size":4192,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-15T06:40:03.917Z","etag":null,"topics":["automatic-layout","image-grid","image-gridding","image-layout","images","imshow","imshowtools","matplotlib-figures","mulitple-images","multiple-imageview","opencv-image-viewer","smart-wrap","wrap-images"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/imshowtools/","language":"Jupyter Notebook","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/saravanabalagi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-02-25T15:09:21.000Z","updated_at":"2023-05-09T15:56:50.000Z","dependencies_parsed_at":"2022-09-15T14:12:55.117Z","dependency_job_id":null,"html_url":"https://github.com/saravanabalagi/imshowtools","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saravanabalagi%2Fimshowtools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saravanabalagi%2Fimshowtools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saravanabalagi%2Fimshowtools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saravanabalagi%2Fimshowtools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/saravanabalagi","download_url":"https://codeload.github.com/saravanabalagi/imshowtools/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249023722,"owners_count":21199958,"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":["automatic-layout","image-grid","image-gridding","image-layout","images","imshow","imshowtools","matplotlib-figures","mulitple-images","multiple-imageview","opencv-image-viewer","smart-wrap","wrap-images"],"created_at":"2024-10-01T12:28:31.037Z","updated_at":"2025-04-15T06:40:09.104Z","avatar_url":"https://github.com/saravanabalagi.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# imshowtools\n\n![](https://img.shields.io/pypi/v/imshowtools)\n![](https://img.shields.io/pypi/wheel/imshowtools)\n![](https://img.shields.io/pypi/l/imshowtools)\n![](https://img.shields.io/pypi/dm/imshowtools)\n\nThis library lets you view images in Jupyter notebooks in a much simpler and intuitive way. Ships with a better 'imshow' function with Multi Images, Smart Wrap and BGR support!.\n\n## Installation\n\nTo install `imshowtools`, simply do\n\n```py\npip install imshowtools\n```\n\n## Quick Plot\n\nImport `imshow` from `imshowtools` and use it:\n\n```py\nfrom imshowtools import imshow\nimport tensorflow as tf\n(x_train, y_train), (x_test, y_test) = tf.keras.datasets.mnist.load_data()\n\nimshow(x_train[0])\nimshow(x_train[0], x_train[1], x_train[2])\nimshow(*x_train[:20], cmap='binary')\nimshow(*x_train[:100], cmap='binary', size=(10, 10))\n```\n\nYou can use any matplotlib compatible `cmap`\n\n![mnist](https://github.com/saravanabalagi/imshowtools/raw/master/example/mnist_intro.png)\n\nExample [ipynb](https://github.com/saravanabalagi/imshowtools/blob/master/example/example.ipynb) notebook and [Python](https://github.com/saravanabalagi/imshowtools/blob/master/example/example.py) along with test images\nprovided in the example folder.\n\n## Get Numpy Image\n\nYou can use obtain numpy image in any of `['RGB', 'RGBA', 'ARGB', 'BW', 'L', \"BGR\", \"BGRA\", \"ABGR\"]` colorspaces.\n\n```py\nimage = imshow(*x_train[:100], return_image=True)\nimage = imshow(*x_train[:100], return_image=\"RGBA\")\nimage = imshow(*x_train[:100], return_image=\"RGB\")\nimage = imshow(*x_train[:100], return_image=\"BW\")\nprint(image.shape)\n\n# cv2.imwrite(\"saved_sample.png\", image)\n# do stuff with 'image' or even\n# imshow(image)\n```\n\nOutput:\n```py\n(288, 432, 3)\n(288, 432, 4)\n(288, 432, 3)\n(288, 432)\n```\n\n## Rows and Columns\n\n```py\nimshow(*x_train[:15], cmap='Purples', rows=1)\nimshow(*x_train[:24], cmap='Greens', columns=4)\n```\n\n![mnist](https://github.com/saravanabalagi/imshowtools/raw/master/example/mnist_rc.png)\n\n## Open CV Images\n\n```py\nlenna = cv2.imread('example/lenna.png')\nimshow(lenna)\ncvshow(lenna)\nimshow(lenna, mode='BGR')\n\nimage = imshow(*[lenna for _ in range(12)], return_image=\"BW\")\nprint(image.shape)\nimshow(image)\n```\n![lenna](https://github.com/saravanabalagi/imshowtools/raw/master/example/lenna_collage.png)\n\n## Namespaces\nIf you do not want to use `imshow` directly in your app (maybe you have another function named imshow), you shall use it like\n\n```py\nimport imshowtools\nimshowtools.imshow(your_image)\n```\n\nor if you like to use a custom namespace\n```py\nimport imshowtools as my_namespace\nmy_namespace.imshow(your_image)\n```\n\n## Contributing\n\nPull requests are very welcome.\n\n1. Fork the repo\n1. Create new branch with feature name as branch name\n1. Check if things work with a jupyter notebook\n1. Raise a pull request\n\n## Licence\n\nPlease see attached [Licence](https://github.com/saravanabalagi/imshowtools/blob/master/LICENCE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaravanabalagi%2Fimshowtools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsaravanabalagi%2Fimshowtools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaravanabalagi%2Fimshowtools/lists"}