Skip to main content

A shape detection module for Python

Project description

PyShapes:A Shape detection module for Python

Build Status

PyShapes is a python package that allows to detect and extract the basic shapes(polygons and circles) present in an image. It also has some in-built attributes and functions to get basic information and perform basic operations on those shapes.

This module uses Python OpenCV as dependency

Installation

Installation is very simple through pip

For pip

pip install PyShapes

For pip3

pip3 install PyShapes

Usage

Importing the package

from PyShapes import *

Creating PyShape objects(Note : Object creation must be on PyShape class !)

shapes = PyShape("C:\\path\\to\\image")

Useful functions in PyShape -

  • Getting all the shapes detected in an image :

    shapes_dictionary = shapes.get_all_shapes()
    

    Gets all the shapes in the image and returns a dictionary !

  • Displaying the shapes detected by providing coloured boundaries to them in original image :

    shapes.show_shapes()
    

    Creates the coloured boundaries on top of the original image and displays the shape names along with the indexes

  • Getting the coordinates of the corners of a particular shape :

    numpy_array = shapes.get_corners("name of shape", index_of_shape)
    

    Returns the coordinates of the corners of the shape in form of a numpy array

    Returns None if there is no shape with that name/index

  • Getting the area of a particular shape :

    area_of_shape = shapes.get_area("name of shape", index_of_shape)
    

    Returns the area of a particular shape in pixel2 units; return type : double

    Returns -1 if there is no shape with that name/index

  • Finally, don't forget to close the running object !

    shapes.close()
    

    Closes the object and the binded dependencies

About

The source is in the PyShape.py file.

Created By Richeek. Copyright 2020

Project details


Download files

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

Files for PyShapes, version 1.1.4
Filename, size File type Python version Upload date Hashes
Filename, size PyShapes-1.1.4-py3-none-any.whl (5.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size PyShapes-1.1.4.tar.gz (4.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page