marearts-anpr 3.7.2__cp312-cp312-manylinux2014_x86_64.whl → 3.7.3__cp312-cp312-manylinux2014_x86_64.whl

marearts_anpr/_version.py

@@ -1,3 +1,3 @@
 """Version information for marearts-anpr package."""
 
-__version__ = "3.7.2"
+__version__ = "3.7.3"

{marearts_anpr-3.7.2.dist-info → marearts_anpr-3.7.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: marearts-anpr
-Version: 3.7.2
+Version: 3.7.3
 Summary: MareArts ANPR (Automatic Number Plate Recognition) library with multi-region support
 Home-page: https://www.marearts.com
 Author: MareArts
@@ -54,7 +54,7 @@ Requires-Dist: pycuda>=2022.1; platform_system == "Linux" and extra == "tensorrt
 
 | ANPR Detection | Road Objects Detection | Mobile App |
 |:---:|:---:|:---:|
-| <img src="promotion_image/anpr_result.png" alt="ANPR Results" width="280"/> | <img src="promotion_image/robj_result.png" alt="Road Objects Results" width="280"/> | <img src="mobile_app/scan_page.png" alt="Mobile App" width="280"/> |
+| <img src="https://raw.githubusercontent.com/MareArts/MareArts-ANPR/main/promotion_image/anpr_result.png" alt="ANPR Results" width="280"/> | <img src="https://raw.githubusercontent.com/MareArts/MareArts-ANPR/main/promotion_image/robj_result.png" alt="Road Objects Results" width="280"/> | <img src="https://raw.githubusercontent.com/MareArts/MareArts-ANPR/main/mobile_app/scan_page.png" alt="Mobile App" width="280"/> |
 
 </div>
 
@@ -80,13 +80,15 @@ Experience the power of MareArts ANPR directly on your mobile device! Fast, accu
 - ✅ Whitelist/Blacklist management
 - 🌍 Multi-region support
 
-📖 **[Read the complete Mobile App Guide →](mobile_app/APP_GUIDE.md)**
+📖 **[Read the complete Mobile App Guide →](https://github.com/MareArts/MareArts-ANPR/blob/main/mobile_app/APP_GUIDE.md)**
 
 > **🎁 Special Offer:** Use the mobile app as your ANPR license - no additional purchase required!  
 > Get your license at [marearts.com/products/anpr](https://www.marearts.com/products/anpr)
 
 ---
 
+<br>
+
 ## Features
 
 - 🌍 **Multi-Region Support**: Korean, Europe+, North America, China, and Universal license plates
@@ -96,6 +98,8 @@ Experience the power of MareArts ANPR directly on your mobile device! Fast, accu
 - 📦 **Batch Processing**: Process multiple plates simultaneously
 - 🐳 **Production Ready**: Docker API with smart model caching and multi-architecture support
 
+<br>
+
 ## Quick Start
 
 ### Installation
@@ -109,18 +113,20 @@ pip install marearts-anpr[gpu]        # NVIDIA CUDA
 pip install marearts-anpr[directml]   # Windows GPU (AMD/Intel/NVIDIA)
 ```
 
-📦 [See complete installation guide](docs/installation.md)
+📦 [See complete installation guide](https://github.com/MareArts/MareArts-ANPR/blob/main/docs/installation.md)
 
 ### Basic Usage
 
-💡 **Model names**: See [models and benchmarks](docs/models.md) (e.g., `small_640p_fp32`, `small_fp32`)
+💡 **Recommended:** `micro_320p_fp32` (best overall) or `micro_320p_fp16` (best mobile). [See all models](https://github.com/MareArts/MareArts-ANPR/blob/main/docs/models.md)
 
 ```python
 from marearts_anpr import ma_anpr_detector_v14, ma_anpr_ocr_v14, marearts_anpr_from_image_file
 
 # Initialize detector
 detector = ma_anpr_detector_v14(
-    "small_640p_fp32",  # pico_640p_fp32, micro_640p_fp32, small_640p_fp32, medium_640p_fp32, large_640p_fp32
+    "micro_320p_fp32",  # 🏆 BEST: 97.13% detection, 128 FPS
+    # 320p models (Best): pico_320p_fp32/fp16, micro_320p_fp32/fp16, small_320p_fp32/fp16, medium_320p_fp32/fp16, large_320p_fp32/fp16
+    # 640p models (High detection): pico_640p_fp32/fp16, micro_640p_fp32/fp16, small_640p_fp32/fp16, medium_640p_fp32/fp16, large_640p_fp32/fp16
     user_name,
     serial_key,
     signature,
@@ -153,9 +159,11 @@ Switch regions without reinitialization:
 ocr.set_region('eup')  # Europe+
 ocr.set_region('kr')   # Korean
 ocr.set_region('na')   # North America
+ocr.set_region('cn')   # China
+ocr.set_region('univ') # Universal (all regions)
 ```
 
-🔄 [Learn more about dynamic region switching](docs/usage.md#dynamic-region-switching-370)
+🔄 [Learn more about dynamic region switching](https://github.com/MareArts/MareArts-ANPR/blob/main/docs/usage.md#dynamic-region-switching)
 
 #### Multiple Input Formats & CLI
 
@@ -177,35 +185,47 @@ ma-anpr test-api image.jpg           # Test API (1000/day limit)
 ma-anpr validate                     # Validate license
 ```
 
-🔧 [See complete usage examples and CLI reference](docs/usage.md)
+🔧 [See complete usage examples and CLI reference](https://github.com/MareArts/MareArts-ANPR/blob/main/docs/usage.md)
+
+<br>
 
 ## Model Performance
 
 ### Detector Performance
 
-| Model Name | F1 Score | Speed CUDA | Speed CPU | Notes |
-|-------|----------|------------|-----------|-------|
-| pico_640p_fp32 | 93.08% | 68.7 FPS (14.5ms) | - | Fastest, smallest model |
-| micro_640p_fp32 | 93.39% | 69.5 FPS (14.4ms) | - | Fast with good accuracy |
-| small_640p_fp32 | 92.58% | 69.5 FPS (14.4ms) | - | Balanced performance |
-| medium_640p_fp32 | 92.27% | 62.1 FPS (16.1ms) | - | Higher accuracy |
-| large_640p_fp32 | 93.77% | 57.4 FPS (17.4ms) | - | 🎯 Highest F1 score |
+*Tested on 33% validation set (12,583 images) with NVIDIA RTX 4090*
+
+| Model Name | Detection Rate | Speed (GPU) | Notes |
+|------------|----------------|-------------|-------|
+| **micro_320p_fp32** | **97.13%** | **128 FPS** (7.8ms) | 🏆 Best overall |
+| **micro_320p_fp16** | **97.13%** | **56 FPS** (17.9ms) | 🏆 Best mobile (50% smaller) |
+| micro_640p_fp32 | 98.99% | 68 FPS (14.6ms) | Highest detection |
+| small_320p_fp32 | 98.00% | 142 FPS (7.0ms) | ⚡ Fastest |
+| medium_320p_fp32 | 98.06% | 136 FPS (7.4ms) | High detection |
+| pico_320p_fp32 | 96.02% | 129 FPS (7.8ms) | Smallest + fast |
+| pico_640p_fp32 | 98.54% | 66 FPS (15.2ms) | Balanced |
+
+**Note:** 320p models are 2× faster than 640p. FP16 models are 50% smaller with same detection rate.
+
+<br>
 
 ### OCR Performance
 
 *Average across all regions*
 
-| Model Name | Exact Match | Char Accuracy | Speed CUDA | Notes |
-|-------|-------------|---------------|------------|-------|
-| pico_fp32 | 91.78% | 96.65% | 270 FPS (3.7ms) | Fastest, smallest |
+| Model Name | Exact Match | Character Accuracy | Speed (GPU) | Notes |
+|------------|-------------|-------------------|-------------|-------|
+| **large_fp32** | **91.70%** | **96.27%** | 262 FPS (3.8ms) | 🎯 Best accuracy |
 | micro_fp32 | 91.86% | 96.50% | 262 FPS (3.8ms) | Fast with good accuracy |
+| pico_fp32 | 91.78% | 96.65% | 270 FPS (3.7ms) | Fastest, smallest |
 | small_fp32 | 91.54% | 96.64% | 300 FPS (3.3ms) | ⚡ Fastest inference |
 | medium_fp32 | 90.36% | 96.45% | 270 FPS (3.7ms) | Balanced performance |
-| **large_fp32** | **91.70%** | **96.27%** | 262 FPS (3.8ms) | 🎯 Best accuracy |
 
 **Supported Regions**: Korean (`kr`), Europe+ (`eup`), North America (`na`), China (`cn`), Universal (`univ`)
 
-📊 [See detailed benchmarks by region](docs/models.md)
+📊 [See all detailed benchmarks and region-based performance](https://github.com/MareArts/MareArts-ANPR/blob/main/docs/models.md)
+
+<br>
 
 ## Regional Support
 
@@ -213,36 +233,42 @@ MareArts ANPR supports license plates from multiple regions with specialized voc
 
 - 🇰🇷 **Korean (`kr`)** - Korean license plates with Hangul characters (best accuracy: 99.27%)
 - 🇪🇺 **Europe+ (`eup`)** - EU countries + Albania, Andorra, Bosnia & Herzegovina, Indonesia, and more
-- 🇺🇸 **North America (`na`)** - USA and Canada license plates
+- 🇺🇸🇨🇦🇲🇽 **North America (`na`)** - USA, Canada, and Mexico license plates
 - 🇨🇳 **China (`cn`)** - Chinese license plates with province codes
 - 🌍 **Universal (`univ`)** - All regions (default, but choose specific region for best accuracy)
 
 💡 **Dynamic Region Switching**: Use `ocr.set_region('kr')` to switch regions instantly without reloading the model, saving ~180 MB per additional region.
 
-🌍 [See complete regional support and character sets](docs/regional-support.md)
+🌍 [See complete regional support and character sets](https://github.com/MareArts/MareArts-ANPR/blob/main/docs/regional-support.md)
+
+<br>
 
 ## Documentation
 
-- 📦 [Installation Guide](docs/installation.md) - Detailed installation options and requirements
-- 🔧 [Usage Examples](docs/usage.md) - Python SDK, CLI usage, dynamic region switching, and environment variables
-- 💻 [Example Code](example_code/) - Basic, advanced, and batch processing examples
-- 🚀 [Model Versions](docs/models.md) - Available models, benchmarks, and performance metrics
-- 🌍 [Regional Support](docs/regional-support.md) - Supported countries and character sets
-- 🐳 [Docker Deployment](docs/docker.md) - Container setup, API server, and multi-architecture builds
-- 🧪 [Try ANPR](docs/api-testing.md) - Test our ANPR without license (1000 requests/day)
-- ❓ [FAQ](docs/faq.md) - Licensing, regions, features, and troubleshooting
+- 📦 [Installation Guide](https://github.com/MareArts/MareArts-ANPR/blob/main/docs/installation.md) - Detailed installation options and requirements
+- 🔧 [Usage Examples](https://github.com/MareArts/MareArts-ANPR/blob/main/docs/usage.md) - Python SDK, CLI usage, dynamic region switching, and environment variables
+- 💻 [Example Code](https://github.com/MareArts/MareArts-ANPR/tree/main/example_code) - Basic, advanced, and batch processing examples
+- 🚀 [Model Versions](https://github.com/MareArts/MareArts-ANPR/blob/main/docs/models.md) - Available models, benchmarks, and performance metrics
+- 🌍 [Regional Support](https://github.com/MareArts/MareArts-ANPR/blob/main/docs/regional-support.md) - Supported countries and character sets
+- 🐳 [Docker Deployment](https://github.com/MareArts/MareArts-ANPR/blob/main/docs/docker.md) - Container setup, API server, and multi-architecture builds
+- 🧪 [Try ANPR](https://github.com/MareArts/MareArts-ANPR/blob/main/docs/api-testing.md) - Test our ANPR without license (1000 requests/day)
+- ❓ [FAQ](https://github.com/MareArts/MareArts-ANPR/blob/main/docs/faq.md) - Licensing, regions, features, and troubleshooting
+
+<br>
 
 ## MareArts Ecosystem
 
 Explore our AI toolkit:
 
 - **marearts-anpr** - Automatic Number Plate Recognition ([GitHub](https://github.com/MareArts/MareArts-ANPR))
-- **🎉 marearts-anpr Mobile App** - ANPR on iOS & Android ([App Store](https://apps.apple.com/us/app/marearts-anpr/id6753904859) | [Guide](mobile_app/APP_GUIDE.md))
+- **🎉 marearts-anpr Mobile App** - ANPR on iOS & Android ([App Store](https://apps.apple.com/us/app/marearts-anpr/id6753904859) | [Guide](https://github.com/MareArts/MareArts-ANPR/blob/main/mobile_app/APP_GUIDE.md))
 - **marearts-road-objects** - Road object detection for persons, vehicles, and 2-wheelers ([GitHub](https://github.com/MareArts/MareArts-Road-Objects))
 - **marearts-xcolor** - Color extraction and similarity analysis ([GitHub](https://github.com/MareArts/MareArts-Xcolor))
 - **marearts-mast** - Real-time panoramic stitching ([GitHub](https://github.com/MareArts/MareArts-MAST))
 - **marearts-crystal** - Encryption and decryption toolkit ([PyPI](https://pypi.org/project/marearts-crystal/))
 
+<br>
+
 ## Support & Resources
 
 | Resource | Link |
@@ -253,6 +279,8 @@ Explore our AI toolkit:
 | 🎮 **Live Demo** | [http://live.marearts.com](http://live.marearts.com) |
 | 📺 **Video Examples** | [YouTube Playlist](https://www.youtube.com/playlist?list=PLvX6vpRszMkxJBJf4EjQ5VCnmkjfE59-J) |
 
+<br>
+
 ## License
 
 © 2024 MareArts. All rights reserved.

{marearts_anpr-3.7.2.dist-info → marearts_anpr-3.7.3.dist-info}/RECORD

@@ -1,5 +1,5 @@
 marearts_anpr/__init__.py,sha256=YzrK3DFACnJ-JOQjHnV0Lj0YTzeWpHGAqTIWhptuudg,845
-marearts_anpr/_version.py,sha256=5tP65Hw7ZPtJrPnVib19duCPPG5ipbcnjBQD9ehxFi8,75
+marearts_anpr/_version.py,sha256=AM_i0cYt4HijPDCkmPINYjsPO7nolURCrZ3qvFs_lfA,75
 marearts_anpr/cli.py,sha256=J1T6OWpk6cuqKW_dVbsukK_C2XBLHvLHjp4mUG0zi0g,38119
 marearts_anpr/image_processor.cpython-312-x86_64-linux-gnu.so,sha256=kK64GCU8XGEUZfNkdSCdfoOvE3yqLvG8hC2Wvam-NJ8,166480
 marearts_anpr/license.cpython-312-x86_64-linux-gnu.so,sha256=i9Hx4VBAofrJ4g-LJYSH8NemUsWhoe2DG8HwFrUr5q8,132784
@@ -12,9 +12,9 @@ marearts_anpr/marearts_anpr_r_v14.cpython-312-x86_64-linux-gnu.so,sha256=Ytt7ezD
 marearts_anpr/secret.cpython-312-x86_64-linux-gnu.so,sha256=vlQe60HJoLlN4SiEc7Zj5Agdxs9hQ3ibxKZR5iQarDU,152984
 marearts_anpr/tokenizer.cpython-312-x86_64-linux-gnu.so,sha256=VeyHB_Yrs2HNvGcRiunx6CbKPO57X4443tvfY5qRayk,145552
 marearts_anpr/utils.cpython-312-x86_64-linux-gnu.so,sha256=hm6C-1Co0KBKP5PkkcklS6RZ6FtbKOP3L0wse3Tt_tg,214936
-marearts_anpr-3.7.2.dist-info/LICENSE,sha256=-QowWRBizXxzIyeIKvORInIIG3pjTHtImpvy4alJ9H4,1693
-marearts_anpr-3.7.2.dist-info/METADATA,sha256=DW8nFkLImVEtVwe0veoCZh2ZzbP6AJXu2-PZhXzKoY0,11296
-marearts_anpr-3.7.2.dist-info/WHEEL,sha256=H_7U0lK8Ggeo7Wed152JxiCsTSTuFzJRrTRQ2duoo5E,105
-marearts_anpr-3.7.2.dist-info/entry_points.txt,sha256=4_q2PbsRTMUIMxt7BWxZdt9yuw-4bepqGyZl4jBLgfU,90
-marearts_anpr-3.7.2.dist-info/top_level.txt,sha256=DX3y7nst7V7YBYS7dHQIIZxROhrheWGRsl2aCOLErEA,14
-marearts_anpr-3.7.2.dist-info/RECORD,,
+marearts_anpr-3.7.3.dist-info/LICENSE,sha256=-QowWRBizXxzIyeIKvORInIIG3pjTHtImpvy4alJ9H4,1693
+marearts_anpr-3.7.3.dist-info/METADATA,sha256=E8hyiwg9VVdj1HGaUjeQMHlQAGJJ33QgBYkLtfybGbE,13028
+marearts_anpr-3.7.3.dist-info/WHEEL,sha256=H_7U0lK8Ggeo7Wed152JxiCsTSTuFzJRrTRQ2duoo5E,105
+marearts_anpr-3.7.3.dist-info/entry_points.txt,sha256=4_q2PbsRTMUIMxt7BWxZdt9yuw-4bepqGyZl4jBLgfU,90
+marearts_anpr-3.7.3.dist-info/top_level.txt,sha256=DX3y7nst7V7YBYS7dHQIIZxROhrheWGRsl2aCOLErEA,14
+marearts_anpr-3.7.3.dist-info/RECORD,,