Skip to main content

MareArts ANPR (Automatic Number Plate Recognition) library

Project description

MareArts ANPR SDK

๐Ÿ‡ช๐Ÿ‡บ ANPR EU (European Union)

Auto Number Plate Recognition for EU countries

๐Ÿฆ‹ Available Countries: (We are adding more countries.)

๐Ÿ‡ฆ๐Ÿ‡ฑ Albania  ๐Ÿ‡จ๐Ÿ‡ฟ Czechia  ๐Ÿ‡ฆ๐Ÿ‡ฉ Andorra  ๐Ÿ‡ฉ๐Ÿ‡ฐ Denmark  ๐Ÿ‡ฆ๐Ÿ‡น Austria  ๐Ÿ‡ซ๐Ÿ‡ฎ Finland
๐Ÿ‡ง๐Ÿ‡ช Belgium  ๐Ÿ‡ซ๐Ÿ‡ท France   ๐Ÿ‡ง๐Ÿ‡ฆ Bosnia and Herzegovina  
๐Ÿ‡ฉ๐Ÿ‡ช Germany  ๐Ÿ‡ง๐Ÿ‡ฌ Bulgaria ๐Ÿ‡ฌ๐Ÿ‡ท Greece   ๐Ÿ‡ญ๐Ÿ‡ท Croatia  ๐Ÿ‡ญ๐Ÿ‡บ Hungary  ๐Ÿ‡จ๐Ÿ‡พ Cyprus   ๐Ÿ‡ฎ๐Ÿ‡ช Ireland

๐Ÿฆ‹ Recognisable Characters:

char_list = [
    "-", ".", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9",
    "A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N",
    "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X", "Y", "Z", "a", "d", "i", 
    "m", "o", "ร–", "รœ", "ฤ†", "ฤŒ", "ฤ", "ล ", "ลฝ", "ะŸ"
]

๐Ÿ‡ฐ๐Ÿ‡ท ANPR Korea

ํ•œ๊ตญ ์ž๋™์ฐจ ๋ฒˆํ˜ธํŒ ์ธ์‹ ์†”๋ฃจ์…˜

์ธ์‹ ๊ฐ€๋Šฅ ๋ฌธ์ž:

char_list = [
    '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 
    '๊ฐ€', '๊ฐ•', '๊ฑฐ', '๊ฒฝ', '๊ณ ', '๊ด‘', '๊ตฌ', '๊ธฐ',
    '๋‚˜', '๋‚จ', '๋„ˆ', '๋…ธ', '๋ˆ„',
    '๋‹ค', '๋Œ€', '๋”', '๋„', '๋™', '๋‘',
    '๋ผ', '๋Ÿฌ', '๋กœ', '๋ฃจ',
    '๋งˆ', '๋จธ', '๋ชจ', '๋ฌด', '๋ฌธ',
    '๋ฐ”', '๋ฐฐ', '๋ฒ„', '๋ณด', '๋ถ€', '๋ถ',
    '์‚ฌ', '์‚ฐ', '์„œ', '์„ธ', '์†Œ', '์ˆ˜',
    '์•„', '์–ด', '์˜ค', '์šฐ', '์šธ', '์›', '์œก', '์ธ',
    '์ž', '์ €', '์ „', '์ œ', '์กฐ', '์ข…', '์ฃผ',
    '์ฒœ', '์ถฉ',
    'ํ•˜', 'ํ—ˆ', 'ํ˜ธ'
]

Installation

To install the MareArts ANPR package, use the following pip command:

pip install marearts-anpr

๐Ÿชช License Key

For private keys, please visit MareArts ANPR Solution. For inquiries about private keys, contact us at hello@marearts.com.

๐Ÿค– Live Test

MareArts ๐ŸŽฌ Live

๐Ÿ“บ ANPR Result Videos

Check here to see the license plate recognition results in YouTube videos.

๐Ÿ“ Using SDK

๐Ÿ”ฌ SDK Usage

Here's an example of how to use the updated SDK:

# pip install marearts-anpr
import cv2
from PIL import Image
from marearts_anpr import ma_anpr_detector
from marearts_anpr import ma_anpr_ocr
from marearts_anpr import marearts_anpr_from_pil
from marearts_anpr import marearts_anpr_from_image_file
from marearts_anpr import marearts_anpr_from_cv2

if __name__ == '__main__':
    
    #################################
    ## Initiate MareArts ANPR
    print("EU ANPR")
    user_name = "your_email"
    serial_key = "your_serial_key"
    detector_model_version = "middle" # Options: middle, v10_small, v10_middle, v10_large
    ocr_model_version = "eu" # Options: eu, kr

    # MareArts ANPR Detector Inference
    anpr_d = ma_anpr_detector(detector_model_version, user_name, serial_key, conf_thres=0.3, iou_thres=0.5)
    # MareArts ANPR OCR Inference
    anpr_r = ma_anpr_ocr(ocr_model_version, user_name, serial_key)
    #################################

    #################################
    # Routine Task 1 - Predict from File
    image_path = './sample_images/eu_test1.jpg'
    output = marearts_anpr_from_image_file(anpr_d, anpr_r, image_path)
    print(output)

    # Routine Task 2 - Predict from cv2
    img = cv2.imread(image_path)
    output = marearts_anpr_from_cv2(anpr_d, anpr_r, img)
    print(output)

    # Routine Task 3 - Predict from Pillow
    pil_img = Image.open(image_path)
    output = marearts_anpr_from_pil(anpr_d, anpr_r, pil_img)
    print(output)
    #################################


    #################################
    ## Initiate MareArts ANPR for Korea
    print("ANPR Korean")
    # user_name, serial_key are already defined
    # anpr_d is also already initiated before
    ocr_model_version = "kr"
    # MareArts ANPR OCR Inference
    anpr_r = ma_anpr_ocr(ocr_model_version, user_name, serial_key)

    #################################
    # Routine Task 1 - Predict from File
    image_path = './sample_images/kr_test2.jpg'
    output = marearts_anpr_from_image_file(anpr_d, anpr_r, image_path)
    print(output)

    # Routine Task 2 - Predict from cv2
    img = cv2.imread(image_path)
    output = marearts_anpr_from_cv2(anpr_d, anpr_r, img)
    print(output)

    # Routine Task 3 - Predict from Pillow
    pil_img = Image.open(image_path)
    output = marearts_anpr_from_pil(anpr_d, anpr_r, pil_img)
    print(output)
    #################################

๐Ÿ”ฌ Returns

The output from the ANPR will be similar to:

{
    'results': [
        {'ocr': 'SL593LM', 'ocr_conf': 99, 'ltrb': [819, 628, 1085, 694], 'ltrb_conf': 90}
        ], 
    'ltrb_proc_sec': 0.22, 
    'ocr_proc_sec': 0.15
}
{
    'results': [
        {'ocr': '123๊ฐ€4568', 'ocr_conf': 99, 'ltrb': [181, 48, 789, 186], 'ltrb_conf': 83}, 
        {'ocr': '123๊ฐ€4568', 'ocr_conf': 99, 'ltrb': [154, 413, 774, 557], 'ltrb_conf': 82}, 
        {'ocr': '123๊ฐ€4568', 'ocr_conf': 99, 'ltrb': [154, 601, 763, 746], 'ltrb_conf': 80}, 
        {'ocr': '123๊ฐ€4568', 'ocr_conf': 99, 'ltrb': [156, 217, 773, 369], 'ltrb_conf': 80}
        ],
    'ltrb_proc_sec': 0.23, 
    'ocr_proc_sec': 0.6
}
  • Results: Contains OCR text, probabilities, and detection coordinate(left, top, right, bottom).
  • Processing Speeds: Provided for license plate detection and OCR.

API for testing

This is for testing purposes

API key limits: 1000 requests per day.
User ID: marearts@public
X-API-Key: J4K9L2Wory34@G7T1Y8rt-PP83uSSvkV3Z6ioSTR!

API Call for EU

To make an API call for EU ANPR, use the following command:

#!bin/bash
curl -X POST https://we303v9ck8.execute-api.eu-west-1.amazonaws.com/Prod/marearts_anpr_eu \
     -H "Content-Type: image/jpeg" \
     -H "x-api-key: your-api-key" \
     -H "user-id: your-user-id" \
     --data-binary "@./path/upload.jpg"

API Call for Korea

To make an API call for Korean ANPR, use the following command:

#!bin/bash
curl -X POST https://we303v9ck8.execute-api.eu-west-1.amazonaws.com/Prod/marearts_anpr \
     -H "Content-Type: image/jpeg" \
     -H "x-api-key: your-api-key" \
     -H "user-id: your-user-id" \
     --data-binary "@./path/upload.jpg"

More Detail

email : hello@marearts.com
home page : https://marearts.com
blog : http://study.marearts.com
paypal : https://study.marearts.com/p/anpr-lpr-solution.html
live test : http://live.marearts.com

๐Ÿ™‡๐Ÿปโ€โ™‚๏ธ Thank you!

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

marearts_anpr-0.0.1007.4-cp311-cp311-win_amd64.whl (190.1 kB view details)

Uploaded CPython 3.11 Windows x86-64

marearts_anpr-0.0.1007.4-cp311-cp311-macosx_10_9_universal2.whl (399.7 kB view details)

Uploaded CPython 3.11 macOS 10.9+ universal2 (ARM64, x86-64)

marearts_anpr-0.0.1007.4-cp310-cp310-win_amd64.whl (189.5 kB view details)

Uploaded CPython 3.10 Windows x86-64

marearts_anpr-0.0.1007.4-cp310-cp310-macosx_10_9_universal2.whl (399.6 kB view details)

Uploaded CPython 3.10 macOS 10.9+ universal2 (ARM64, x86-64)

marearts_anpr-0.0.1007.4-cp39-cp39-win_amd64.whl (213.1 kB view details)

Uploaded CPython 3.9 Windows x86-64

marearts_anpr-0.0.1007.4-cp39-cp39-macosx_10_9_universal2.whl (402.5 kB view details)

Uploaded CPython 3.9 macOS 10.9+ universal2 (ARM64, x86-64)

File details

Details for the file marearts_anpr-0.0.1007.4-cp311-cp311-win_amd64.whl.

File metadata

File hashes

Hashes for marearts_anpr-0.0.1007.4-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 95b166ed045602dd3e1ff8f9e4deeba5c8f3c0775bc1231f8b6e57954a83370a
MD5 b349a61d3bbdc0e00418764ce219c35a
BLAKE2b-256 fa9f6c1e7b9e516d646e840b5c4902756f26270b79eea1ea692a944e48326077

See more details on using hashes here.

File details

Details for the file marearts_anpr-0.0.1007.4-cp311-cp311-manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for marearts_anpr-0.0.1007.4-cp311-cp311-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 7d1b5e2f06f3e991a358e32dc27b80e41cf719a527842c293930d21ccf63959c
MD5 a79512c8fe101b832bf53d236a3afe03
BLAKE2b-256 d3d8654a5e477c5cbd548febc96524fe8a00de9f1844c6e3270845f2a3243b7b

See more details on using hashes here.

File details

Details for the file marearts_anpr-0.0.1007.4-cp311-cp311-macosx_10_9_universal2.whl.

File metadata

File hashes

Hashes for marearts_anpr-0.0.1007.4-cp311-cp311-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 3b94b9de420e3a0ee6d691da8a78d8197a2ce4f5fe951eef6036fcc24bf22754
MD5 64d4861a164b57a0c2a6033b37d0d3b6
BLAKE2b-256 d60d54c5ba073b7f04bad12256338dde8287c7753da02d43fdedeab5dcfe9768

See more details on using hashes here.

File details

Details for the file marearts_anpr-0.0.1007.4-cp310-cp310-win_amd64.whl.

File metadata

File hashes

Hashes for marearts_anpr-0.0.1007.4-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 da691f0f8dae410888cfa8f9269220730dd66a35867e3b508adf5decea45774c
MD5 a96f896bef59e808314ac219607acfad
BLAKE2b-256 0c6391db690864168c146150186358e4f2e781dfb735d3ebd1a6ee1a53f9f1e9

See more details on using hashes here.

File details

Details for the file marearts_anpr-0.0.1007.4-cp310-cp310-manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for marearts_anpr-0.0.1007.4-cp310-cp310-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 549487781e1a49b0f19c88b73cf79c38f84f8a09b6898f6e24016fed4e972b96
MD5 81879d081a575424d8c17cc34cf70c19
BLAKE2b-256 69a689f056af186496b34a9f4bd0761fd28ab7182ebe980316326c51242f4970

See more details on using hashes here.

File details

Details for the file marearts_anpr-0.0.1007.4-cp310-cp310-macosx_10_9_universal2.whl.

File metadata

File hashes

Hashes for marearts_anpr-0.0.1007.4-cp310-cp310-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 a264398daa76534da3d38823127121abd9ab84207ae62b2b5d8fb722fafd29f2
MD5 c272fb27a6dffc6298e24b0fe253eeb7
BLAKE2b-256 a640ff86a9ad0da59c9c13b16b8f7d2f5f23d80723b756fd348cbdc14fef70cb

See more details on using hashes here.

File details

Details for the file marearts_anpr-0.0.1007.4-cp39-cp39-win_amd64.whl.

File metadata

File hashes

Hashes for marearts_anpr-0.0.1007.4-cp39-cp39-win_amd64.whl
Algorithm Hash digest
SHA256 16f5da37a5e9340e6d5fd35f4bc85d18230863ee02337ff0b8bd8c014b165473
MD5 8919fd45151f6c92e98fbaa1e459f430
BLAKE2b-256 99ee201632143db98f00a33078b9ede03c7e3885280215ab6f3cd9da13b7b431

See more details on using hashes here.

File details

Details for the file marearts_anpr-0.0.1007.4-cp39-cp39-manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for marearts_anpr-0.0.1007.4-cp39-cp39-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 4ff2e4c97fa8a4b10437a9c97ea82f57063787a4fd03d967408e6aae9ff2d6c2
MD5 8625ccadaebac1625e46c2b8c1f3b1cd
BLAKE2b-256 4cf7cc0c593bb8290f1907451a24d157038ea704902fc1ff86beda9991d1216a

See more details on using hashes here.

File details

Details for the file marearts_anpr-0.0.1007.4-cp39-cp39-macosx_10_9_universal2.whl.

File metadata

File hashes

Hashes for marearts_anpr-0.0.1007.4-cp39-cp39-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 cdf493f73c151c077d4aced09f5a2a587b452b0df56cde39353d0b0aade19ead
MD5 be4c5a0ed87b96944d5c7db277eebf3f
BLAKE2b-256 d30885e3ef854b6c23f68fad69a5e09761d6d6951b5e5e84800e8d6aef5aa127

See more details on using hashes here.

Supported by

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