Skip to main content

🖼️ Get image shapes, analyze type, get preprocessing recommendations & check model compatibility

Project description

🖼️ imgshape — Smart Image Analysis & Preprocessing Toolkit (v2.0.1)

imgshape is a lightweight Python toolkit designed for image shape detection, dataset inspection, preprocessing recommendation, and AI model compatibility checks — all optimized for ML/DL workflows, both in research and production.

alt text

⚡️ Why use imgshape?

  • 🔍 Automatically detect shape, dominant color, entropy, and type of an image.
  • 🧠 Recommend preprocessing steps like resize dims, normalization, and suitable model types.
  • 🖬 Analyze entire datasets to get size/shape distribution and dimension scatter plots.
  • ✅ Check model compatibility (e.g. with mobilenet_v2, resnet18, etc.).
  • 🌐 Supports CLI, Python API, and even a Gradio-based GUI for visual workflows.

🚀 Installation

pip install imgshape

Requires Python 3.8+ and packages: Pillow, matplotlib, seaborn, numpy, scikit-image, gradio


💻 CLI Usage

imgshape --path ./sample.jpg                  # Get image shape
imgshape --path ./sample.jpg --analyze        # Analyze image type and entropy
imgshape --path ./sample.jpg --recommend      # Recommend preprocessing steps
imgshape --dir ./images --check mobilenet_v2  # Check dataset compatibility with a model
imgshape --batch --path ./folder              # Batch mode shape detection
imgshape --viz ./images                       # Visualize size/shape distribution
imgshape --web                                # Launch Gradio GUI

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

imgshape-2.0.1.tar.gz (10.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

imgshape-2.0.1-py3-none-any.whl (10.3 kB view details)

Uploaded Python 3

File details

Details for the file imgshape-2.0.1.tar.gz.

File metadata

  • Download URL: imgshape-2.0.1.tar.gz
  • Upload date:
  • Size: 10.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.8

File hashes

Hashes for imgshape-2.0.1.tar.gz
Algorithm Hash digest
SHA256 9271961f2b707cd341225e5f7ff5227de111aa7619a18da3861ccda66b001304
MD5 9d29e274f49e05fdc7ee93f79eb2bcb4
BLAKE2b-256 b519b170606394fc03bc321cb27e225d228918f4ab58a3875ba143cabc1370db

See more details on using hashes here.

File details

Details for the file imgshape-2.0.1-py3-none-any.whl.

File metadata

  • Download URL: imgshape-2.0.1-py3-none-any.whl
  • Upload date:
  • Size: 10.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.8

File hashes

Hashes for imgshape-2.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 03429084017423edee346d8cdaf04fde5e56e5599522489a0e2daedca41bddf7
MD5 748e7a549838be63d8511bc96bf412f5
BLAKE2b-256 e9b3da4842c14f956a498b1cf81993d2355635cee5342c51ac49bf945f713dc6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page