mirror of
https://github.com/ultralytics/yolov5.git
synced 2025-06-03 14:49:29 +08:00
Update banners for YOLOv8 release v8.1.0 (#12605)
* Auto-format by Ultralytics actions * updated git banner * Update README.md Signed-off-by: Glenn Jocher <glenn.jocher@ultralytics.com> * Update README.zh-CN.md Signed-off-by: Glenn Jocher <glenn.jocher@ultralytics.com> --------- Signed-off-by: Glenn Jocher <glenn.jocher@ultralytics.com> Co-authored-by: UltralyticsAssistant <web@ultralytics.com> Co-authored-by: Glenn Jocher <glenn.jocher@ultralytics.com>
This commit is contained in:
parent
4733b4df90
commit
9abbef522f
@ -1,7 +1,7 @@
|
|||||||
<div align="center">
|
<div align="center">
|
||||||
<p>
|
<p>
|
||||||
<a href="https://yolovision.ultralytics.com/" target="_blank">
|
<a href="http://www.ultralytics.com/blog/ultralytics-yolov8-turns-one-a-year-of-breakthroughs-and-innovations" target="_blank">
|
||||||
<img width="100%" src="https://raw.githubusercontent.com/ultralytics/assets/main/im/banner-yolo-vision-2023.png"></a>
|
<img width="100%" src="https://raw.githubusercontent.com/ultralytics/assets/main/yolov8/banner-yolov8.png"></a>
|
||||||
<!--
|
<!--
|
||||||
<a align="center" href="https://ultralytics.com/yolov5" target="_blank">
|
<a align="center" href="https://ultralytics.com/yolov5" target="_blank">
|
||||||
<img width="100%" src="https://raw.githubusercontent.com/ultralytics/assets/main/yolov5/v70/splash.png"></a>
|
<img width="100%" src="https://raw.githubusercontent.com/ultralytics/assets/main/yolov5/v70/splash.png"></a>
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
<div align="center">
|
<div align="center">
|
||||||
<p>
|
<p>
|
||||||
<a href="https://yolovision.ultralytics.com/" target="_blank">
|
<a href="http://www.ultralytics.com/blog/ultralytics-yolov8-turns-one-a-year-of-breakthroughs-and-innovations" target="_blank">
|
||||||
<img width="100%" src="https://raw.githubusercontent.com/ultralytics/assets/main/im/banner-yolo-vision-2023.png"></a>
|
<img width="100%" src="https://raw.githubusercontent.com/ultralytics/assets/main/yolov8/banner-yolov8.png"></a>
|
||||||
<!--
|
<!--
|
||||||
<a align="center" href="https://ultralytics.com/yolov5" target="_blank">
|
<a align="center" href="https://ultralytics.com/yolov5" target="_blank">
|
||||||
<img width="100%" src="https://raw.githubusercontent.com/ultralytics/assets/main/yolov5/v70/splash.png"></a>
|
<img width="100%" src="https://raw.githubusercontent.com/ultralytics/assets/main/yolov5/v70/splash.png"></a>
|
||||||
|
@ -1,8 +1,6 @@
|
|||||||
# Flask REST API
|
# Flask REST API
|
||||||
|
|
||||||
[REST](https://en.wikipedia.org/wiki/Representational_state_transfer) [API](https://en.wikipedia.org/wiki/API)s are
|
[REST](https://en.wikipedia.org/wiki/Representational_state_transfer) [API](https://en.wikipedia.org/wiki/API)s are commonly used to expose Machine Learning (ML) models to other services. This folder contains an example REST API created using Flask to expose the YOLOv5s model from [PyTorch Hub](https://pytorch.org/hub/ultralytics_yolov5/).
|
||||||
commonly used to expose Machine Learning (ML) models to other services. This folder contains an example REST API
|
|
||||||
created using Flask to expose the YOLOv5s model from [PyTorch Hub](https://pytorch.org/hub/ultralytics_yolov5/).
|
|
||||||
|
|
||||||
## Requirements
|
## Requirements
|
||||||
|
|
||||||
@ -69,5 +67,4 @@ The model inference results are returned as a JSON response:
|
|||||||
]
|
]
|
||||||
```
|
```
|
||||||
|
|
||||||
An example python script to perform inference using [requests](https://docs.python-requests.org/en/master/) is given
|
An example python script to perform inference using [requests](https://docs.python-requests.org/en/master/) is given in `example_request.py`
|
||||||
in `example_request.py`
|
|
||||||
|
@ -34,15 +34,15 @@ Either sign up for free to the [ClearML Hosted Service](https://cutt.ly/yolov5-t
|
|||||||
|
|
||||||
1. Install the `clearml` python package:
|
1. Install the `clearml` python package:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pip install clearml
|
pip install clearml
|
||||||
```
|
```
|
||||||
|
|
||||||
1. Connect the ClearML SDK to the server by [creating credentials](https://app.clear.ml/settings/workspace-configuration) (go right top to Settings -> Workspace -> Create new credentials), then execute the command below and follow the instructions:
|
2. Connect the ClearML SDK to the server by [creating credentials](https://app.clear.ml/settings/workspace-configuration) (go right top to Settings -> Workspace -> Create new credentials), then execute the command below and follow the instructions:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
clearml-init
|
clearml-init
|
||||||
```
|
```
|
||||||
|
|
||||||
That's it! You're done 😎
|
That's it! You're done 😎
|
||||||
|
|
||||||
@ -58,8 +58,7 @@ pip install clearml>=1.2.0
|
|||||||
|
|
||||||
This will enable integration with the YOLOv5 training script. Every training run from now on, will be captured and stored by the ClearML experiment manager.
|
This will enable integration with the YOLOv5 training script. Every training run from now on, will be captured and stored by the ClearML experiment manager.
|
||||||
|
|
||||||
If you want to change the `project_name` or `task_name`, use the `--project` and `--name` arguments of the `train.py` script, by default the project will be called `YOLOv5` and the task `Training`.
|
If you want to change the `project_name` or `task_name`, use the `--project` and `--name` arguments of the `train.py` script, by default the project will be called `YOLOv5` and the task `Training`. PLEASE NOTE: ClearML uses `/` as a delimiter for subprojects, so be careful when using `/` in your project name!
|
||||||
PLEASE NOTE: ClearML uses `/` as a delimiter for subprojects, so be careful when using `/` in your project name!
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python train.py --img 640 --batch 16 --epochs 3 --data coco128.yaml --weights yolov5s.pt --cache
|
python train.py --img 640 --batch 16 --epochs 3 --data coco128.yaml --weights yolov5s.pt --cache
|
||||||
@ -86,8 +85,7 @@ This will capture:
|
|||||||
- Validation images per epoch
|
- Validation images per epoch
|
||||||
- ...
|
- ...
|
||||||
|
|
||||||
That's a lot right? 🤯
|
That's a lot right? 🤯 Now, we can visualize all of this information in the ClearML UI to get an overview of our training progress. Add custom columns to the table view (such as e.g. mAP_0.5) so you can easily sort on the best performing model. Or select multiple experiments and directly compare them!
|
||||||
Now, we can visualize all of this information in the ClearML UI to get an overview of our training progress. Add custom columns to the table view (such as e.g. mAP_0.5) so you can easily sort on the best performing model. Or select multiple experiments and directly compare them!
|
|
||||||
|
|
||||||
There even more we can do with all of this information, like hyperparameter optimization and remote execution, so keep reading if you want to see how that works!
|
There even more we can do with all of this information, like hyperparameter optimization and remote execution, so keep reading if you want to see how that works!
|
||||||
|
|
||||||
@ -181,8 +179,7 @@ python utils/loggers/clearml/hpo.py
|
|||||||
|
|
||||||
## 🤯 Remote Execution (advanced)
|
## 🤯 Remote Execution (advanced)
|
||||||
|
|
||||||
Running HPO locally is really handy, but what if we want to run our experiments on a remote machine instead? Maybe you have access to a very powerful GPU machine on-site, or you have some budget to use cloud GPUs.
|
Running HPO locally is really handy, but what if we want to run our experiments on a remote machine instead? Maybe you have access to a very powerful GPU machine on-site, or you have some budget to use cloud GPUs. This is where the ClearML Agent comes into play. Check out what the agent can do here:
|
||||||
This is where the ClearML Agent comes into play. Check out what the agent can do here:
|
|
||||||
|
|
||||||
- [YouTube video](https://youtu.be/MX3BrXnaULs)
|
- [YouTube video](https://youtu.be/MX3BrXnaULs)
|
||||||
- [Documentation](https://clear.ml/docs/latest/docs/clearml_agent)
|
- [Documentation](https://clear.ml/docs/latest/docs/clearml_agent)
|
||||||
|
@ -8,8 +8,7 @@ This guide will cover how to use YOLOv5 with [Comet](https://bit.ly/yolov5-readm
|
|||||||
|
|
||||||
Comet builds tools that help data scientists, engineers, and team leaders accelerate and optimize machine learning and deep learning models.
|
Comet builds tools that help data scientists, engineers, and team leaders accelerate and optimize machine learning and deep learning models.
|
||||||
|
|
||||||
Track and visualize model metrics in real time, save your hyperparameters, datasets, and model checkpoints, and visualize your model predictions with [Comet Custom Panels](https://www.comet.com/docs/v2/guides/comet-dashboard/code-panels/about-panels/?utm_source=yolov5&utm_medium=partner&utm_campaign=partner_yolov5_2022&utm_content=github)!
|
Track and visualize model metrics in real time, save your hyperparameters, datasets, and model checkpoints, and visualize your model predictions with [Comet Custom Panels](https://www.comet.com/docs/v2/guides/comet-dashboard/code-panels/about-panels/?utm_source=yolov5&utm_medium=partner&utm_campaign=partner_yolov5_2022&utm_content=github)! Comet makes sure you never lose track of your work and makes it easy to share results and collaborate across teams of all sizes!
|
||||||
Comet makes sure you never lose track of your work and makes it easy to share results and collaborate across teams of all sizes!
|
|
||||||
|
|
||||||
# Getting Started
|
# Getting Started
|
||||||
|
|
||||||
@ -84,8 +83,7 @@ By default, Comet will log the following items
|
|||||||
|
|
||||||
# Configure Comet Logging
|
# Configure Comet Logging
|
||||||
|
|
||||||
Comet can be configured to log additional data either through command line flags passed to the training script
|
Comet can be configured to log additional data either through command line flags passed to the training script or through environment variables.
|
||||||
or through environment variables.
|
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
export COMET_MODE=online # Set whether to run Comet in 'online' or 'offline' mode. Defaults to online
|
export COMET_MODE=online # Set whether to run Comet in 'online' or 'offline' mode. Defaults to online
|
||||||
@ -100,8 +98,7 @@ export COMET_LOG_PREDICTIONS=true # Set this to false to disable logging model p
|
|||||||
|
|
||||||
## Logging Checkpoints with Comet
|
## Logging Checkpoints with Comet
|
||||||
|
|
||||||
Logging Models to Comet is disabled by default. To enable it, pass the `save-period` argument to the training script. This will save the
|
Logging Models to Comet is disabled by default. To enable it, pass the `save-period` argument to the training script. This will save the logged checkpoints to Comet based on the interval value provided by `save-period`
|
||||||
logged checkpoints to Comet based on the interval value provided by `save-period`
|
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
python train.py \
|
python train.py \
|
||||||
@ -176,14 +173,11 @@ python train.py \
|
|||||||
--upload_dataset
|
--upload_dataset
|
||||||
```
|
```
|
||||||
|
|
||||||
You can find the uploaded dataset in the Artifacts tab in your Comet Workspace
|
You can find the uploaded dataset in the Artifacts tab in your Comet Workspace <img width="1073" alt="artifact-1" src="https://user-images.githubusercontent.com/7529846/186929193-162718bf-ec7b-4eb9-8c3b-86b3763ef8ea.png">
|
||||||
<img width="1073" alt="artifact-1" src="https://user-images.githubusercontent.com/7529846/186929193-162718bf-ec7b-4eb9-8c3b-86b3763ef8ea.png">
|
|
||||||
|
|
||||||
You can preview the data directly in the Comet UI.
|
You can preview the data directly in the Comet UI. <img width="1082" alt="artifact-2" src="https://user-images.githubusercontent.com/7529846/186929215-432c36a9-c109-4eb0-944b-84c2786590d6.png">
|
||||||
<img width="1082" alt="artifact-2" src="https://user-images.githubusercontent.com/7529846/186929215-432c36a9-c109-4eb0-944b-84c2786590d6.png">
|
|
||||||
|
|
||||||
Artifacts are versioned and also support adding metadata about the dataset. Comet will automatically log the metadata from your dataset `yaml` file
|
Artifacts are versioned and also support adding metadata about the dataset. Comet will automatically log the metadata from your dataset `yaml` file <img width="963" alt="artifact-3" src="https://user-images.githubusercontent.com/7529846/186929256-9d44d6eb-1a19-42de-889a-bcbca3018f2e.png">
|
||||||
<img width="963" alt="artifact-3" src="https://user-images.githubusercontent.com/7529846/186929256-9d44d6eb-1a19-42de-889a-bcbca3018f2e.png">
|
|
||||||
|
|
||||||
### Using a saved Artifact
|
### Using a saved Artifact
|
||||||
|
|
||||||
@ -205,8 +199,7 @@ python train.py \
|
|||||||
--weights yolov5s.pt
|
--weights yolov5s.pt
|
||||||
```
|
```
|
||||||
|
|
||||||
Artifacts also allow you to track the lineage of data as it flows through your Experimentation workflow. Here you can see a graph that shows you all the experiments that have used your uploaded dataset.
|
Artifacts also allow you to track the lineage of data as it flows through your Experimentation workflow. Here you can see a graph that shows you all the experiments that have used your uploaded dataset. <img width="1391" alt="artifact-4" src="https://user-images.githubusercontent.com/7529846/186929264-4c4014fa-fe51-4f3c-a5c5-f6d24649b1b4.png">
|
||||||
<img width="1391" alt="artifact-4" src="https://user-images.githubusercontent.com/7529846/186929264-4c4014fa-fe51-4f3c-a5c5-f6d24649b1b4.png">
|
|
||||||
|
|
||||||
## Resuming a Training Run
|
## Resuming a Training Run
|
||||||
|
|
||||||
@ -214,7 +207,7 @@ If your training run is interrupted for any reason, e.g. disrupted internet conn
|
|||||||
|
|
||||||
The Run Path has the following format `comet://<your workspace name>/<your project name>/<experiment id>`.
|
The Run Path has the following format `comet://<your workspace name>/<your project name>/<experiment id>`.
|
||||||
|
|
||||||
This will restore the run to its state before the interruption, which includes restoring the model from a checkpoint, restoring all hyperparameters and training arguments and downloading Comet dataset Artifacts if they were used in the original run. The resumed run will continue logging to the existing Experiment in the Comet UI
|
This will restore the run to its state before the interruption, which includes restoring the model from a checkpoint, restoring all hyperparameters and training arguments and downloading Comet dataset Artifacts if they were used in the original run. The resumed run will continue logging to the existing Experiment in the Comet UI
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
python train.py \
|
python train.py \
|
||||||
@ -234,8 +227,7 @@ python utils/loggers/comet/hpo.py \
|
|||||||
--comet_optimizer_config "utils/loggers/comet/optimizer_config.json"
|
--comet_optimizer_config "utils/loggers/comet/optimizer_config.json"
|
||||||
```
|
```
|
||||||
|
|
||||||
The `hpo.py` script accepts the same arguments as `train.py`. If you wish to pass additional arguments to your sweep simply add them after
|
The `hpo.py` script accepts the same arguments as `train.py`. If you wish to pass additional arguments to your sweep simply add them after the script.
|
||||||
the script.
|
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
python utils/loggers/comet/hpo.py \
|
python utils/loggers/comet/hpo.py \
|
||||||
|
Loading…
x
Reference in New Issue
Block a user