# wheresmycar
First attempt at utilizing YOLOv8 model for vehicle number plate detection.
> [!NOTE]
> This project is for education and skills presentation purposes.
# Motivation
Gain practical knowledge with machine learning technologies in real-world example.
The main goal was to gain hands-on experience in machine learning project utilizing PyTorch library and several technologies to improve software engineering skills.
# About the project
Small Python package providing a class for object detection, utilizing YOLOv8 model which was trained to detect number plates on vehicles.
# Documentation
<a id="plate_detector"></a>
# plate\_detector
plate_detector module
<a id="plate_detector.PlateDetector"></a>
## PlateDetector Objects
```python
class PlateDetector()
```
Class for Vehicle Number Plate Detection based on pretrained YOLOv8 model.
<a id="plate_detector.PlateDetector.load_model"></a>
#### load\_model
```python
def load_model(device: str) -> YOLO
```
Function to load pretrained model.
params:
- device <str>: device on which the model should run
returns:
- <ultralytics.YOLO>: pretrained YOLOv8 model
<a id="plate_detector.PlateDetector.model"></a>
#### model
```python
@property
def model() -> YOLO
```
Access pretrained model
returns:
- <ultralytics.YOLO>: pretrained YOLOv8 model
<a id="plate_detector.PlateDetector.get_device"></a>
#### get\_device
```python
def get_device(enable_cuda: bool) -> str
```
Gets target device for inference.
params:
- enable_cude <bool>: if True, will return cuda if available
returns:
- <str> either cuda or cpu
<a id="plate_detector.PlateDetector.detect"></a>
#### detect
```python
def detect(target_path: str, conf: float = 0.5, **kwargs) -> Results
```
Get predictions on given input.
params:
- target_path <str>: path to directory with images or image's file path
- conf <float>: minimum confidence threshold for detection
returns:
- <ultralytics.engine.results.Results>: inference results
Raw data
{
"_id": null,
"home_page": null,
"name": "wheresmycar",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "machine learning, object detection, educational",
"author": null,
"author_email": "Micha\u0142 Do\u0142bniak <michal.dolbniak@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/f1/f7/73c3687384608ae01ee41de62027e04da6056e1871c066caeb43557e97c4/wheresmycar-0.0.2.5.tar.gz",
"platform": null,
"description": "# wheresmycar\n\nFirst attempt at utilizing YOLOv8 model for vehicle number plate detection.\n\n> [!NOTE]\n> This project is for education and skills presentation purposes.\n\n\n# Motivation\n\nGain practical knowledge with machine learning technologies in real-world example.\n\nThe main goal was to gain hands-on experience in machine learning project utilizing PyTorch library and several technologies to improve software engineering skills.\n\n# About the project\n\nSmall Python package providing a class for object detection, utilizing YOLOv8 model which was trained to detect number plates on vehicles.\n\n# Documentation\n\n<a id=\"plate_detector\"></a>\n\n# plate\\_detector\n\nplate_detector module\n\n<a id=\"plate_detector.PlateDetector\"></a>\n\n## PlateDetector Objects\n\n```python\nclass PlateDetector()\n```\n\nClass for Vehicle Number Plate Detection based on pretrained YOLOv8 model.\n\n<a id=\"plate_detector.PlateDetector.load_model\"></a>\n\n#### load\\_model\n\n```python\ndef load_model(device: str) -> YOLO\n```\n\nFunction to load pretrained model.\nparams:\n- device <str>: device on which the model should run\nreturns:\n- <ultralytics.YOLO>: pretrained YOLOv8 model\n\n<a id=\"plate_detector.PlateDetector.model\"></a>\n\n#### model\n\n```python\n@property\ndef model() -> YOLO\n```\n\nAccess pretrained model\nreturns:\n- <ultralytics.YOLO>: pretrained YOLOv8 model\n\n<a id=\"plate_detector.PlateDetector.get_device\"></a>\n\n#### get\\_device\n\n```python\ndef get_device(enable_cuda: bool) -> str\n```\n\nGets target device for inference.\nparams:\n- enable_cude <bool>: if True, will return cuda if available\nreturns:\n- <str> either cuda or cpu\n\n<a id=\"plate_detector.PlateDetector.detect\"></a>\n\n#### detect\n\n```python\ndef detect(target_path: str, conf: float = 0.5, **kwargs) -> Results\n```\n\nGet predictions on given input.\nparams:\n- target_path <str>: path to directory with images or image's file path\n- conf <float>: minimum confidence threshold for detection\nreturns:\n- <ultralytics.engine.results.Results>: inference results\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Detect vehicle license plates",
"version": "0.0.2.5",
"project_urls": {
"Homepage": "https://github.com/michdol/wheresmycar"
},
"split_keywords": [
"machine learning",
" object detection",
" educational"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d568d215cd32b16a242a84be27c8c5ac11f0e58909cafd876521f688e0e265cc",
"md5": "6710f89d5cd6d0e81faef12244a4349f",
"sha256": "9d594c96c33ce7acd47f58ba018b9143dfe857d00d09c5bf7088780b2fa1a8dd"
},
"downloads": -1,
"filename": "wheresmycar-0.0.2.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6710f89d5cd6d0e81faef12244a4349f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 4098,
"upload_time": "2024-07-01T11:19:06",
"upload_time_iso_8601": "2024-07-01T11:19:06.514392Z",
"url": "https://files.pythonhosted.org/packages/d5/68/d215cd32b16a242a84be27c8c5ac11f0e58909cafd876521f688e0e265cc/wheresmycar-0.0.2.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f1f773c3687384608ae01ee41de62027e04da6056e1871c066caeb43557e97c4",
"md5": "5970cfc49a74ce6fdc9dc80bd1c245b9",
"sha256": "e1042fec1a66d3a0429c4f5e4516180bb2e61441a4b332cef915e81b4022eb83"
},
"downloads": -1,
"filename": "wheresmycar-0.0.2.5.tar.gz",
"has_sig": false,
"md5_digest": "5970cfc49a74ce6fdc9dc80bd1c245b9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 3948,
"upload_time": "2024-07-01T11:19:07",
"upload_time_iso_8601": "2024-07-01T11:19:07.377101Z",
"url": "https://files.pythonhosted.org/packages/f1/f7/73c3687384608ae01ee41de62027e04da6056e1871c066caeb43557e97c4/wheresmycar-0.0.2.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-01 11:19:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "michdol",
"github_project": "wheresmycar",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "wheresmycar"
}