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

marearts_anpr/_version.py

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

marearts_anpr/cli.py

@@ -623,33 +623,77 @@ def cmd_test_api(args):
     # List models option
     if hasattr(args, 'list_models') and args.list_models:
         print("Available Test API Models (Public Cloud Service):")
-        print("=" * 50)
+        print("=" * 70)
         
-        print("\n📍 DETECTOR MODELS (Legacy only - no V14 on public API):")
-        print("-" * 40)
-        print("  v10 Series:")
-        print("    - v10_nano, v10_small, v10_middle, v10_large, v10_xlarge")
-        print("  v11 Series:")
-        print("    - v11_nano, v11_small, v11_middle, v11_large")
-        print("  v13 Series (Recommended):")
-        print("    - v13_nano, v13_small, v13_middle, v13_large")
+        print("\n🚀 V14 DETECTOR MODELS (Recommended):")
+        print("-" * 70)
+        print("  640p FP32 (Standard Precision):")
+        print("    • v14_pico_640p_fp32    - Fastest, good for real-time")
+        print("    • v14_micro_640p_fp32   - Balanced speed/accuracy")
+        print("    • v14_small_640p_fp32   - Good accuracy")
+        print("    • v14_medium_640p_fp32  - ⭐ Best overall (DEFAULT)")
+        print("    • v14_large_640p_fp32   - Highest accuracy")
         
-        print("\n🔤 OCR MODELS:")
-        print("-" * 40)
-        print("  Base Models:")
-        print("    - eu, euplus, kr, cn, univ")
-        print("  v11 Series:")
-        print("    - v11_eu, v11_euplus, v11_kr, v11_cn, v11_univ")
-        print("  v13 Series (Recommended):")
-        print("    - v13_eu, v13_euplus, v13_kr, v13_cn, v13_univ")
+        print("\n  640p FP16 (Half Precision - Faster on GPU):")
+        print("    • v14_pico_640p_fp16")
+        print("    • v14_micro_640p_fp16")
+        print("    • v14_small_640p_fp16")
+        print("    • v14_medium_640p_fp16")
+        print("    • v14_large_640p_fp16")
         
-        print("\n📝 NOTES:")
-        print("-" * 40)
-        print("• Daily limit: 1000 requests")
-        print("• No authentication required")
-        print("• V14 models NOT available on public API")
-        print("• For V14 models, use local processing with V2 license")
-        print("\n💡 Recommended: v13_middle + v13_euplus")
+        print("\n  320p FP32 (Lower Resolution - Faster):")
+        print("    • v14_pico_320p_fp32")
+        print("    • v14_micro_320p_fp32")
+        print("    • v14_small_320p_fp32")
+        print("    • v14_medium_320p_fp32")
+        print("    • v14_large_320p_fp32")
+        
+        print("\n  320p FP16:")
+        print("    • v14_pico_320p_fp16")
+        print("    • v14_micro_320p_fp16")
+        print("    • v14_small_320p_fp16")
+        print("    • v14_medium_320p_fp16")
+        print("    • v14_large_320p_fp16")
+        
+        print("\n🔤 V14 OCR MODELS:")
+        print("-" * 70)
+        print("  FP32 (Standard Precision):")
+        print("    • v14_pico_fp32")
+        print("    • v14_micro_fp32")
+        print("    • v14_small_fp32    - ⭐ Good balance (DEFAULT)")
+        print("    • v14_medium_fp32   - Better accuracy")
+        print("    • v14_large_fp32    - Highest accuracy")
+        
+        print("\n🌍 REGIONS (Required for V14 OCR):")
+        print("-" * 70)
+        print("    • kr    - Korean plates")
+        print("    • eup   - European+ plates (EU countries + more)")
+        print("    • na    - North American plates")
+        print("    • cn    - Chinese plates")
+        print("    • univ  - Universal (all regions)")
+        
+        print("\n💡 RECOMMENDED COMBINATIONS:")
+        print("-" * 70)
+        print("  European plates:  --detector v14_medium_640p_fp32 --ocr v14_small_fp32 --region eup")
+        print("  Korean plates:    --detector v14_medium_640p_fp32 --ocr v14_small_fp32 --region kr")
+        print("  Fast processing:  --detector v14_micro_640p_fp32  --ocr v14_micro_fp32 --region eup")
+        print("  Best accuracy:    --detector v14_large_640p_fp32  --ocr v14_large_fp32 --region eup")
+        
+        print("\n📝 USAGE NOTES:")
+        print("-" * 70)
+        print("  • Daily limit: 1000 requests (resets at midnight UTC)")
+        print("  • No authentication required (public test API)")
+        print("  • V14 models with region-specific vocabulary")
+        print("  • FP16 models faster on GPU, FP32 better for CPU")
+        print("  • 320p faster but may miss distant/small plates")
+        print("  • 640p recommended for best detection")
+        
+        print("\n📚 EXAMPLES:")
+        print("-" * 70)
+        print("  ma-anpr test-api image.jpg")
+        print("  ma-anpr test-api image.jpg --region kr")
+        print("  ma-anpr test-api *.jpg --detector v14_small_640p_fp32 --region eup")
+        print("  ma-anpr test-api image.jpg --json results.json")
         return
     
     # Check if input files are provided
@@ -687,7 +731,8 @@ def cmd_test_api(args):
                 'x-api-key': PUBLIC_API_KEY,
                 'user-id': PUBLIC_USER_ID,
                 'detector_model_version': args.detector,
-                'ocr_model_version': args.ocr
+                'ocr_model_version': args.ocr,
+                'region': args.region
             }
             
             # Make API request with security settings
@@ -907,10 +952,13 @@ def main():
     # Test API command
     test_api_parser = subparsers.add_parser('test-api', help='Test ANPR using public API (no credentials required)')
     test_api_parser.add_argument('input', nargs='*', help='Input image file(s)')
-    test_api_parser.add_argument('--detector', default='v13_middle',
-                                 help='Detector model (default: v13_middle)')
-    test_api_parser.add_argument('--ocr', default='v13_euplus',
-                                 help='OCR model (default: v13_euplus)')
+    test_api_parser.add_argument('--detector', default='v14_medium_640p_fp32',
+                                 help='Detector model (default: v14_medium_640p_fp32)')
+    test_api_parser.add_argument('--ocr', default='v14_medium_fp32',
+                                 help='OCR model (default: v14_medium_fp32)')
+    test_api_parser.add_argument('--region', default='eup',
+                                 choices=['kr', 'eup', 'na', 'cn', 'univ'],
+                                 help='Region for OCR (default: eup)')
     test_api_parser.add_argument('--list-models', action='store_true',
                                  help='List available models for test API')
     test_api_parser.add_argument('--json', help='Save results to JSON file')

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: marearts-anpr
-Version: 3.7.3
+Version: 3.7.6
 Summary: MareArts ANPR (Automatic Number Plate Recognition) library with multi-region support
 Home-page: https://www.marearts.com
 Author: MareArts
@@ -20,13 +20,16 @@ License-File: LICENSE
 Requires-Dist: marearts-crystal==2.4.2
 Requires-Dist: onnxruntime>=1.0
 Requires-Dist: opencv-python>=4.0
-Requires-Dist: numpy>=1.19
 Requires-Dist: tqdm>=4.0
 Requires-Dist: requests>=2.0
 Requires-Dist: PyYAML>=6.0
 Requires-Dist: pillow>=10.0
 Requires-Dist: imageio>=2.0
 Requires-Dist: dotmap>=1.3
+Requires-Dist: numpy<2.0,>=1.23.0; python_version == "3.10"
+Requires-Dist: numpy<2.0,>=1.23.0; python_version == "3.11"
+Requires-Dist: numpy<2.0,>=1.21.6; python_version == "3.9"
+Requires-Dist: numpy<2.0,>=1.26.0; python_version >= "3.12"
 Provides-Extra: all-gpu
 Requires-Dist: onnxruntime-gpu>=1.15.0; extra == "all-gpu"
 Requires-Dist: onnxruntime-directml>=1.15.0; extra == "all-gpu"
@@ -50,6 +53,9 @@ Requires-Dist: pycuda>=2022.1; platform_system == "Linux" and extra == "tensorrt
 [![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](https://www.marearts.com/products/anpr)
 [![Live Demo](https://img.shields.io/badge/demo-live-brightgreen.svg)](http://live.marearts.com)
 
+[![Python SDK](https://img.shields.io/github/v/release/MareArts/MareArts-ANPR?filter=marearts-anpr-python-sdk-*&label=Python%20SDK&color=blue)](https://pypi.org/project/marearts-anpr/)
+[![iOS App](https://img.shields.io/github/v/release/MareArts/MareArts-ANPR?filter=marearts-anpr-mobile-app-ios-*&label=iOS%20App&color=green)](https://apps.apple.com/app/marearts-anpr/id6753904859)
+
 <div align="center">
 
 | ANPR Detection | Road Objects Detection | Mobile App |
@@ -117,15 +123,14 @@ pip install marearts-anpr[directml]   # Windows GPU (AMD/Intel/NVIDIA)
 
 ### Basic Usage
 
-💡 **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(
-    "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
+    "micro_320p_fp32",
+    # 320p models (Fast): 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,
@@ -150,6 +155,7 @@ result = marearts_anpr_from_image_file(detector, ocr, "image.jpg")
 print(result)
 # Output: {'results': [{'ocr': 'ABC123', 'ocr_conf': 99, ...}], ...}
 ```
+💡 🔄 [Learn more about usage](https://github.com/MareArts/MareArts-ANPR/blob/main/docs/usage.md#dynamic-region-switching)
 
 #### Dynamic Region Switching
 
@@ -193,8 +199,6 @@ ma-anpr validate                     # Validate license
 
 ### Detector Performance
 
-*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 |
@@ -223,7 +227,7 @@ ma-anpr validate                     # Validate license
 
 **Supported Regions**: Korean (`kr`), Europe+ (`eup`), North America (`na`), China (`cn`), Universal (`univ`)
 
-📊 [See all detailed benchmarks and region-based performance](https://github.com/MareArts/MareArts-ANPR/blob/main/docs/models.md)
+📊 [See all models and benchmarks](https://github.com/MareArts/MareArts-ANPR/blob/main/docs/models.md)
 
 <br>
 
@@ -286,3 +290,11 @@ Explore our AI toolkit:
 © 2024 MareArts. All rights reserved.
 
 This software requires a valid license key. Visit [MareArts ANPR Solution](https://www.marearts.com/products/anpr) for licensing options.
+
+---
+
+<div align="center">
+
+<a href='https://clustrmaps.com/site/1c8t6' title='Visit tracker'><img src='https://clustrmaps.com/map_v2.png?cl=080808&w=600&t=t&d=I-__iZrXFcHfzEXPbD_E0f9ipSE8cNnANPUFRBu-c2Q&co=ffffff&ct=808080' alt='Visitor Map' width='300'/></a>
+
+</div>

marearts_anpr-3.7.6.dist-info/RECORD

@@ -0,0 +1,20 @@
+marearts_anpr/__init__.py,sha256=YzrK3DFACnJ-JOQjHnV0Lj0YTzeWpHGAqTIWhptuudg,845
+marearts_anpr/_version.py,sha256=zGNGpkQjSytGALD5hcAdD8jzB1hkyGf8rY7GMtr8uwA,75
+marearts_anpr/cli.py,sha256=JzIF-nYSjbWrm6fzWYZ6H9V1pI71CqcxQj9JvKFpJCA,40663
+marearts_anpr/image_processor.cpython-312-x86_64-linux-gnu.so,sha256=Oo4UWJ3vltrwrEuFZZlZxszyaXf3bTp0Jw8aFx-PEfA,848904
+marearts_anpr/license.cpython-312-x86_64-linux-gnu.so,sha256=G4JCH7L-OaUVT9BodK0yIMoLqa9p7phtAn3-Tvj0bDM,688448
+marearts_anpr/marearts_anpr.py,sha256=OSSOZnODYscVPGLcw6Qw4btE_b_6qCbeWOUZA2vi150,3308
+marearts_anpr/marearts_anpr_d.cpython-312-x86_64-linux-gnu.so,sha256=LDqQaZm45k2ptC1cHDtfbhS0c183u3Qr_XjxeKaJt1U,952376
+marearts_anpr/marearts_anpr_d_v14.cpython-312-x86_64-linux-gnu.so,sha256=HDrL3wg_gPZ9oWJVHJ5WvgxpbzhpXazv3oXTFTthAxA,1053792
+marearts_anpr/marearts_anpr_p.cpython-312-x86_64-linux-gnu.so,sha256=EMXOrfSP0M3Dg3glsP8e0-zjfoURMfrSg0AWy3wZG40,1170256
+marearts_anpr/marearts_anpr_r.cpython-312-x86_64-linux-gnu.so,sha256=44XtUeHzIK8kyogQAzJ_Oq-k-GbIvO1Bq89QQ_fzpdQ,1156408
+marearts_anpr/marearts_anpr_r_v14.cpython-312-x86_64-linux-gnu.so,sha256=P_BDPBRlScWHshuzaWq3Kr1-Ou85QavhsZQe_pKyP_g,778440
+marearts_anpr/secret.cpython-312-x86_64-linux-gnu.so,sha256=qjR8Uf2kg6SuE4k5KbI31mPc9m41O0aXxls-7OJ_qRE,796160
+marearts_anpr/tokenizer.cpython-312-x86_64-linux-gnu.so,sha256=Uhsumz5_8uvP2pUi7H7gbUEXlFnnyqGZMSNVymxKWhU,813200
+marearts_anpr/utils.cpython-312-x86_64-linux-gnu.so,sha256=mwCVzeYNbfJufHgI9oagTEDe4r1WMgZTGCQoXqPyWhA,1110880
+marearts_anpr-3.7.6.dist-info/LICENSE,sha256=-QowWRBizXxzIyeIKvORInIIG3pjTHtImpvy4alJ9H4,1693
+marearts_anpr-3.7.6.dist-info/METADATA,sha256=NQLpnzzCfZ4XgyH5OysTgEiInvhxpzC55PqjS4oFoBA,13708
+marearts_anpr-3.7.6.dist-info/WHEEL,sha256=H_7U0lK8Ggeo7Wed152JxiCsTSTuFzJRrTRQ2duoo5E,105
+marearts_anpr-3.7.6.dist-info/entry_points.txt,sha256=4_q2PbsRTMUIMxt7BWxZdt9yuw-4bepqGyZl4jBLgfU,90
+marearts_anpr-3.7.6.dist-info/top_level.txt,sha256=DX3y7nst7V7YBYS7dHQIIZxROhrheWGRsl2aCOLErEA,14
+marearts_anpr-3.7.6.dist-info/RECORD,,

marearts_anpr-3.7.3.dist-info/RECORD

@@ -1,20 +0,0 @@
-marearts_anpr/__init__.py,sha256=YzrK3DFACnJ-JOQjHnV0Lj0YTzeWpHGAqTIWhptuudg,845
-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
-marearts_anpr/marearts_anpr.py,sha256=OSSOZnODYscVPGLcw6Qw4btE_b_6qCbeWOUZA2vi150,3308
-marearts_anpr/marearts_anpr_d.cpython-312-x86_64-linux-gnu.so,sha256=xEYTQ5jt1IMzLohv8nuv5iQqxKTVoldBs4LiIp83cg8,190208
-marearts_anpr/marearts_anpr_d_v14.cpython-312-x86_64-linux-gnu.so,sha256=fIM7bQ2Ag4xfwca8z5DiHygWXrI453-Yz8XUVKAY0Zk,205912
-marearts_anpr/marearts_anpr_p.cpython-312-x86_64-linux-gnu.so,sha256=8ErwWRsIHvjjpjHKRGD2_MH7e_HIh5-J9_NAhP6JOOM,221184
-marearts_anpr/marearts_anpr_r.cpython-312-x86_64-linux-gnu.so,sha256=ERsDzbd8Cpv0CKLXTQ5E-M8P0kgMHXQkcqDniJUPEb0,220704
-marearts_anpr/marearts_anpr_r_v14.cpython-312-x86_64-linux-gnu.so,sha256=Ytt7ezDQ8Tq5UeVZupsOte4_8tpFwzAXcsU1kX8lQTM,147392
-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.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,,