From 9d7dd957984d83db761c180b9aeef3f44ca359a6 Mon Sep 17 00:00:00 2001 From: up-up-up-up <1079796482@qq.com> Date: Sat, 18 May 2024 11:08:32 +0800 Subject: [PATCH] sub --- .../.github/ISSUE_TEMPLATE/config.yml | 11 - ultralytics-main/.github/workflows/ci.yaml | 288 ---- ultralytics-main/.github/workflows/cla.yml | 37 - .../.github/workflows/codeql.yaml | 42 - .../.github/workflows/docker.yaml | 159 -- ultralytics-main/.github/workflows/format.yml | 28 - .../.github/workflows/greetings.yml | 58 - ultralytics-main/.github/workflows/links.yml | 90 -- .../.github/workflows/publish.yml | 113 -- ultralytics-main/.github/workflows/stale.yml | 47 - ultralytics-main/.gitignore | 166 --- ultralytics-main/.pre-commit-config.yaml | 86 -- ultralytics-main/Author_advice.txt | 7 - ultralytics-main/CITATION.cff | 26 - .../Instance Segmentation-camera.py | 37 - .../Instance Segmentation-pic-video.py | 66 - .../Instance Segmentation-track-camera.py | 42 - .../Instance Segmentation-track-pic-video.py | 67 - .../train2017/image_BS1_456_00_42_15.jpg | Bin 232956 -> 0 bytes .../train2017/image_BS1_457_00_42_15.jpg | Bin 233217 -> 0 bytes .../train2017/image_BS1_458_00_42_15.jpg | Bin 233233 -> 0 bytes .../train2017/image_BS1_459_00_42_15.jpg | Bin 233596 -> 0 bytes .../train2017/image_BS1_460_00_42_15.jpg | Bin 233722 -> 0 bytes .../train2017/image_BS1_461_00_42_15.jpg | Bin 233908 -> 0 bytes .../train2017/image_BS1_462_00_42_15.jpg | Bin 233728 -> 0 bytes .../train2017/image_BS1_463_00_42_15.jpg | Bin 234216 -> 0 bytes .../train2017/image_BS1_464_00_42_16.jpg | Bin 233919 -> 0 bytes .../train2017/image_BS1_465_00_42_16.jpg | Bin 234158 -> 0 bytes .../dataset/coco128/labels/train2017.cache | Bin 3475 -> 0 bytes .../train2017/image_BS1_456_00_42_15.txt | 3 - .../train2017/image_BS1_457_00_42_15.txt | 3 - .../train2017/image_BS1_458_00_42_15.txt | 3 - .../train2017/image_BS1_459_00_42_15.txt | 3 - .../train2017/image_BS1_460_00_42_15.txt | 3 - .../train2017/image_BS1_461_00_42_15.txt | 3 - .../train2017/image_BS1_462_00_42_15.txt | 3 - .../train2017/image_BS1_463_00_42_15.txt | 3 - .../train2017/image_BS1_464_00_42_16.txt | 3 - .../train2017/image_BS1_465_00_42_16.txt | 3 - ultralytics-main/docker/Dockerfile | 85 -- ultralytics-main/docker/Dockerfile-arm64 | 51 - ultralytics-main/docker/Dockerfile-conda | 40 - ultralytics-main/docker/Dockerfile-cpu | 57 - ultralytics-main/docker/Dockerfile-jetson | 50 - ultralytics-main/docker/Dockerfile-python | 54 - ultralytics-main/docker/Dockerfile-runner | 38 - ultralytics-main/docs/README.md | 140 -- ultralytics-main/docs/build_docs.py | 141 -- ultralytics-main/docs/build_reference.py | 130 -- ultralytics-main/docs/coming_soon_template.md | 34 - ultralytics-main/docs/en/CNAME | 1 - .../docs/en/guides/azureml-quickstart.md | 152 -- .../docs/en/guides/conda-quickstart.md | 132 -- .../guides/coral-edge-tpu-on-raspberry-pi.md | 140 -- .../docs/en/guides/distance-calculation.md | 107 -- .../docs/en/guides/docker-quickstart.md | 119 -- ultralytics-main/docs/en/guides/heatmaps.md | 301 ---- .../docs/en/guides/hyperparameter-tuning.md | 206 --- ultralytics-main/docs/en/guides/index.md | 65 - .../instance-segmentation-and-tracking.md | 140 -- .../guides/isolating-segmentation-objects.md | 325 ----- .../docs/en/guides/kfold-cross-validation.md | 278 ---- .../en/guides/model-deployment-options.md | 305 ---- .../docs/en/guides/object-blurring.md | 91 -- .../docs/en/guides/object-counting.md | 246 ---- .../docs/en/guides/object-cropping.md | 102 -- ...ng-openvino-latency-vs-throughput-modes.md | 69 - .../docs/en/guides/raspberry-pi.md | 196 --- .../docs/en/guides/region-counting.md | 86 -- .../docs/en/guides/sahi-tiled-inference.md | 185 --- .../docs/en/guides/security-alarm-system.md | 166 --- .../docs/en/guides/speed-estimation.md | 110 -- .../docs/en/guides/triton-inference-server.md | 137 -- .../en/guides/view-results-in-terminal.md | 146 -- ultralytics-main/docs/en/guides/vision-eye.md | 177 --- .../docs/en/guides/workouts-monitoring.md | 134 -- .../docs/en/guides/yolo-common-issues.md | 276 ---- .../en/guides/yolo-performance-metrics.md | 176 --- .../en/guides/yolo-thread-safe-inference.md | 108 -- ultralytics-main/docs/en/help/CI.md | 61 - ultralytics-main/docs/en/help/CLA.md | 28 - ultralytics-main/docs/en/help/FAQ.md | 39 - .../docs/en/help/code_of_conduct.md | 85 -- ultralytics-main/docs/en/help/contributing.md | 131 -- .../en/help/environmental-health-safety.md | 37 - ultralytics-main/docs/en/help/index.md | 19 - .../en/help/minimum_reproducible_example.md | 78 - ultralytics-main/docs/en/help/privacy.md | 137 -- ultralytics-main/docs/en/help/security.md | 36 - ultralytics-main/docs/en/hub/api/index.md | 34 - ultralytics-main/docs/en/hub/app/android.md | 100 -- ultralytics-main/docs/en/hub/app/index.md | 48 - ultralytics-main/docs/en/hub/app/ios.md | 90 -- .../docs/en/hub/cloud-training.md | 89 -- ultralytics-main/docs/en/hub/datasets.md | 146 -- ultralytics-main/docs/en/hub/index.md | 61 - ultralytics-main/docs/en/hub/inference-api.md | 480 ------ ultralytics-main/docs/en/hub/integrations.md | 62 - ultralytics-main/docs/en/hub/models.md | 130 -- .../docs/en/hub/on-premise/index.md | 34 - ultralytics-main/docs/en/hub/projects.md | 180 --- ultralytics-main/docs/en/hub/quickstart.md | 58 - ultralytics-main/docs/en/index.md | 81 -- .../docs/en/integrations/amazon-sagemaker.md | 169 --- .../docs/en/integrations/clearml.md | 189 --- .../docs/en/integrations/comet.md | 178 --- .../docs/en/integrations/coreml.md | 126 -- ultralytics-main/docs/en/integrations/dvc.md | 171 --- .../docs/en/integrations/edge-tpu.md | 118 -- .../docs/en/integrations/gradio.md | 106 -- .../docs/en/integrations/index.md | 104 -- .../docs/en/integrations/mlflow.md | 117 -- ultralytics-main/docs/en/integrations/ncnn.md | 120 -- .../docs/en/integrations/neural-magic.md | 165 --- ultralytics-main/docs/en/integrations/onnx.md | 134 -- .../docs/en/integrations/openvino.md | 284 ---- .../docs/en/integrations/paddlepaddle.md | 122 -- .../docs/en/integrations/ray-tune.md | 179 --- .../docs/en/integrations/roboflow.md | 243 ---- .../docs/en/integrations/tensorboard.md | 153 -- .../docs/en/integrations/tensorrt.md | 128 -- .../docs/en/integrations/tflite.md | 122 -- .../docs/en/integrations/torchscript.md | 126 -- .../docs/en/integrations/weights-biases.md | 156 -- ultralytics-main/docs/en/models/fast-sam.md | 203 --- ultralytics-main/docs/en/models/index.md | 96 -- ultralytics-main/docs/en/models/mobile-sam.md | 119 -- ultralytics-main/docs/en/models/rtdetr.md | 92 -- ultralytics-main/docs/en/models/sam.md | 227 --- ultralytics-main/docs/en/models/yolo-nas.md | 120 -- ultralytics-main/docs/en/models/yolo-world.md | 216 --- ultralytics-main/docs/en/models/yolov3.md | 98 -- ultralytics-main/docs/en/models/yolov4.md | 70 - ultralytics-main/docs/en/models/yolov5.md | 114 -- ultralytics-main/docs/en/models/yolov6.md | 106 -- ultralytics-main/docs/en/models/yolov7.md | 65 - ultralytics-main/docs/en/models/yolov8.md | 186 --- ultralytics-main/docs/en/models/yolov9.md | 152 -- ultralytics-main/docs/en/modes/benchmark.md | 106 -- ultralytics-main/docs/en/modes/export.md | 111 -- ultralytics-main/docs/en/modes/index.md | 73 - ultralytics-main/docs/en/modes/predict.md | 795 ---------- ultralytics-main/docs/en/modes/track.md | 360 ----- ultralytics-main/docs/en/modes/train.md | 328 ----- ultralytics-main/docs/en/modes/val.md | 128 -- ultralytics-main/docs/en/quickstart.md | 328 ----- .../docs/en/reference/cfg/__init__.md | 64 - .../docs/en/reference/data/annotator.md | 16 - .../docs/en/reference/data/augment.md | 84 -- .../docs/en/reference/data/base.md | 16 - .../docs/en/reference/data/build.md | 40 - .../docs/en/reference/data/converter.md | 40 - .../docs/en/reference/data/dataset.md | 32 - .../en/reference/data/explorer/explorer.md | 21 - .../en/reference/data/explorer/gui/dash.md | 57 - .../docs/en/reference/data/explorer/utils.md | 33 - .../docs/en/reference/data/loaders.md | 44 - .../docs/en/reference/data/split_dota.md | 44 - .../docs/en/reference/data/utils.md | 68 - .../docs/en/reference/engine/exporter.md | 32 - .../docs/en/reference/engine/model.md | 16 - .../docs/en/reference/engine/predictor.md | 16 - .../docs/en/reference/engine/results.md | 40 - .../docs/en/reference/engine/trainer.md | 16 - .../docs/en/reference/engine/tuner.md | 16 - .../docs/en/reference/engine/validator.md | 16 - .../docs/en/reference/hub/__init__.md | 40 - .../docs/en/reference/hub/auth.md | 16 - .../docs/en/reference/hub/session.md | 16 - .../docs/en/reference/hub/utils.md | 28 - .../docs/en/reference/models/fastsam/model.md | 16 - .../en/reference/models/fastsam/predict.md | 16 - .../en/reference/models/fastsam/prompt.md | 16 - .../docs/en/reference/models/fastsam/utils.md | 20 - .../docs/en/reference/models/fastsam/val.md | 16 - .../docs/en/reference/models/nas/model.md | 16 - .../docs/en/reference/models/nas/predict.md | 16 - .../docs/en/reference/models/nas/val.md | 16 - .../docs/en/reference/models/rtdetr/model.md | 16 - .../en/reference/models/rtdetr/predict.md | 16 - .../docs/en/reference/models/rtdetr/train.md | 16 - .../docs/en/reference/models/rtdetr/val.md | 20 - .../docs/en/reference/models/sam/amg.md | 56 - .../docs/en/reference/models/sam/build.md | 36 - .../docs/en/reference/models/sam/model.md | 16 - .../reference/models/sam/modules/decoders.md | 20 - .../reference/models/sam/modules/encoders.md | 52 - .../en/reference/models/sam/modules/sam.md | 16 - .../models/sam/modules/tiny_encoder.md | 56 - .../models/sam/modules/transformer.md | 24 - .../docs/en/reference/models/sam/predict.md | 16 - .../docs/en/reference/models/utils/loss.md | 20 - .../docs/en/reference/models/utils/ops.md | 20 - .../reference/models/yolo/classify/predict.md | 16 - .../reference/models/yolo/classify/train.md | 16 - .../en/reference/models/yolo/classify/val.md | 16 - .../reference/models/yolo/detect/predict.md | 16 - .../en/reference/models/yolo/detect/train.md | 16 - .../en/reference/models/yolo/detect/val.md | 16 - .../docs/en/reference/models/yolo/model.md | 20 - .../en/reference/models/yolo/obb/predict.md | 16 - .../en/reference/models/yolo/obb/train.md | 16 - .../docs/en/reference/models/yolo/obb/val.md | 16 - .../en/reference/models/yolo/pose/predict.md | 16 - .../en/reference/models/yolo/pose/train.md | 16 - .../docs/en/reference/models/yolo/pose/val.md | 16 - .../reference/models/yolo/segment/predict.md | 16 - .../en/reference/models/yolo/segment/train.md | 16 - .../en/reference/models/yolo/segment/val.md | 16 - .../docs/en/reference/nn/autobackend.md | 24 - .../docs/en/reference/nn/modules/block.md | 140 -- .../docs/en/reference/nn/modules/conv.md | 68 - .../docs/en/reference/nn/modules/head.md | 40 - .../en/reference/nn/modules/transformer.md | 52 - .../docs/en/reference/nn/modules/utils.md | 32 - .../docs/en/reference/nn/tasks.md | 80 - .../docs/en/reference/solutions/ai_gym.md | 16 - .../solutions/distance_calculation.md | 16 - .../docs/en/reference/solutions/heatmap.md | 16 - .../en/reference/solutions/object_counter.md | 16 - .../reference/solutions/speed_estimation.md | 16 - .../docs/en/reference/trackers/basetrack.md | 20 - .../docs/en/reference/trackers/bot_sort.md | 20 - .../en/reference/trackers/byte_tracker.md | 20 - .../docs/en/reference/trackers/track.md | 24 - .../docs/en/reference/trackers/utils/gmc.md | 16 - .../reference/trackers/utils/kalman_filter.md | 20 - .../en/reference/trackers/utils/matching.md | 28 - .../docs/en/reference/utils/__init__.md | 160 -- .../docs/en/reference/utils/autobatch.md | 20 - .../docs/en/reference/utils/benchmarks.md | 20 - .../docs/en/reference/utils/callbacks/base.md | 120 -- .../en/reference/utils/callbacks/clearml.md | 40 - .../en/reference/utils/callbacks/comet.md | 108 -- .../docs/en/reference/utils/callbacks/dvc.md | 48 - .../docs/en/reference/utils/callbacks/hub.md | 44 - .../en/reference/utils/callbacks/mlflow.md | 28 - .../en/reference/utils/callbacks/neptune.md | 44 - .../en/reference/utils/callbacks/raytune.md | 16 - .../reference/utils/callbacks/tensorboard.md | 36 - .../docs/en/reference/utils/callbacks/wb.md | 40 - .../docs/en/reference/utils/checks.md | 112 -- .../docs/en/reference/utils/dist.md | 28 - .../docs/en/reference/utils/downloads.md | 52 - .../docs/en/reference/utils/errors.md | 16 - .../docs/en/reference/utils/files.md | 44 - .../docs/en/reference/utils/instance.md | 24 - .../docs/en/reference/utils/loss.md | 52 - .../docs/en/reference/utils/metrics.md | 96 -- .../docs/en/reference/utils/ops.md | 136 -- .../docs/en/reference/utils/patches.md | 28 - .../docs/en/reference/utils/plotting.md | 56 - .../docs/en/reference/utils/tal.md | 36 - .../docs/en/reference/utils/torch_utils.md | 120 -- .../docs/en/reference/utils/triton.md | 16 - .../docs/en/reference/utils/tuner.md | 16 - ultralytics-main/docs/en/robots.txt | 16 - ultralytics-main/docs/en/tasks/classify.md | 181 --- ultralytics-main/docs/en/tasks/detect.md | 182 --- ultralytics-main/docs/en/tasks/index.md | 57 - ultralytics-main/docs/en/tasks/obb.md | 191 --- ultralytics-main/docs/en/tasks/pose.md | 185 --- ultralytics-main/docs/en/tasks/segment.md | 187 --- ultralytics-main/docs/en/usage/callbacks.md | 101 -- ultralytics-main/docs/en/usage/cfg.md | 269 ---- ultralytics-main/docs/en/usage/cli.md | 231 --- ultralytics-main/docs/en/usage/engine.md | 91 -- ultralytics-main/docs/en/usage/python.md | 325 ----- .../docs/en/usage/simple-utilities.md | 429 ------ .../environments/aws_quickstart_tutorial.md | 95 -- .../azureml_quickstart_tutorial.md | 94 -- .../docker_image_quickstart_tutorial.md | 71 - .../google_cloud_quickstart_tutorial.md | 87 -- ultralytics-main/docs/en/yolov5/index.md | 93 -- .../docs/en/yolov5/quickstart_tutorial.md | 72 - .../tutorials/architecture_description.md | 224 --- .../tutorials/clearml_logging_integration.md | 237 --- .../tutorials/comet_logging_integration.md | 256 ---- .../tutorials/hyperparameter_evolution.md | 166 --- .../en/yolov5/tutorials/model_ensembling.md | 147 -- .../docs/en/yolov5/tutorials/model_export.md | 247 ---- .../tutorials/model_pruning_and_sparsity.md | 110 -- .../en/yolov5/tutorials/multi_gpu_training.md | 190 --- .../neural_magic_pruning_quantization.md | 264 ---- .../tutorials/pytorch_hub_model_loading.md | 372 ----- .../roboflow_datasets_integration.md | 73 - .../tutorials/running_on_jetson_nano.md | 319 ---- .../tutorials/test_time_augmentation.md | 164 --- .../tips_for_best_training_results.md | 65 - .../en/yolov5/tutorials/train_custom_data.md | 224 --- .../transfer_learning_with_frozen_layers.md | 155 -- .../docs/overrides/assets/favicon.ico | Bin 9662 -> 0 bytes .../docs/overrides/javascript/extra.js | 69 - ultralytics-main/docs/overrides/main.html | 12 - .../docs/overrides/partials/comments.html | 51 - .../docs/overrides/partials/source-file.html | 26 - .../docs/overrides/stylesheets/style.css | 57 - ultralytics-main/examples/README.md | 36 - .../YOLOv8-CPP-Inference/CMakeLists.txt | 28 - .../examples/YOLOv8-CPP-Inference/README.md | 50 - .../YOLOv8-CPP-Inference/inference.cpp | 185 --- .../examples/YOLOv8-CPP-Inference/inference.h | 52 - .../examples/YOLOv8-CPP-Inference/main.cpp | 70 - .../CMakeLists.txt | 47 - .../YOLOv8-LibTorch-CPP-Inference/README.md | 35 - .../YOLOv8-LibTorch-CPP-Inference/main.cc | 259 ---- .../YOLOv8-ONNXRuntime-CPP/CMakeLists.txt | 96 -- .../examples/YOLOv8-ONNXRuntime-CPP/README.md | 107 -- .../YOLOv8-ONNXRuntime-CPP/inference.cpp | 363 ----- .../YOLOv8-ONNXRuntime-CPP/inference.h | 93 -- .../examples/YOLOv8-ONNXRuntime-CPP/main.cpp | 193 --- .../YOLOv8-ONNXRuntime-Rust/Cargo.toml | 21 - .../YOLOv8-ONNXRuntime-Rust/README.md | 221 --- .../YOLOv8-ONNXRuntime-Rust/src/cli.rs | 87 -- .../YOLOv8-ONNXRuntime-Rust/src/lib.rs | 119 -- .../YOLOv8-ONNXRuntime-Rust/src/main.rs | 28 - .../YOLOv8-ONNXRuntime-Rust/src/model.rs | 642 -------- .../src/ort_backend.rs | 534 ------- .../src/yolo_result.rs | 235 --- .../examples/YOLOv8-ONNXRuntime/README.md | 43 - .../examples/YOLOv8-ONNXRuntime/main.py | 231 --- .../YOLOv8-OpenCV-ONNX-Python/README.md | 19 - .../YOLOv8-OpenCV-ONNX-Python/main.py | 130 -- .../README.md | 65 - .../YOLOv8-OpenCV-int8-tflite-Python/main.py | 299 ---- .../examples/YOLOv8-Region-Counter/readme.md | 123 -- .../yolov8_region_counter.py | 251 ---- .../YOLOv8-SAHI-Inference-Video/readme.md | 69 - .../yolov8_sahi.py | 111 -- .../README.md | 63 - .../main.py | 342 ----- ultralytics-main/examples/heatmaps.ipynb | 145 -- ultralytics-main/examples/hub.ipynb | 106 -- .../examples/object_counting.ipynb | 147 -- .../examples/object_tracking.ipynb | 203 --- ultralytics-main/examples/tutorial.ipynb | 649 --------- ultralytics-main/main.py | 56 - ultralytics-main/mkdocs.yml | 675 --------- ultralytics-main/pyproject.toml | 178 --- ultralytics-main/requirements.txt | 47 - ultralytics-main/setup.py | 102 -- ultralytics-main/stereo-speed.py | 98 -- ultralytics-main/stereo/dianyuntu_yolo.py | 194 --- ultralytics-main/stereo/stereo.py | 206 --- ultralytics-main/stereo/stereoconfig_040_2.py | 42 - ultralytics-main/ultralytics/__init__.py | 26 - ultralytics-main/ultralytics/bus.jpg | Bin 487438 -> 0 bytes ultralytics-main/ultralytics/cfg/__init__.py | 587 -------- ultralytics-main/ultralytics/cfg/default.yaml | 125 -- .../ultralytics/cfg/models/README.md | 40 - .../cfg/models/rt-detr/rtdetr-l.yaml | 50 - .../cfg/models/rt-detr/rtdetr-resnet101.yaml | 42 - .../cfg/models/rt-detr/rtdetr-resnet50.yaml | 42 - .../cfg/models/rt-detr/rtdetr-x.yaml | 54 - .../ultralytics/cfg/models/v3/yolov3-spp.yaml | 46 - .../cfg/models/v3/yolov3-tiny.yaml | 37 - .../ultralytics/cfg/models/v3/yolov3.yaml | 46 - .../ultralytics/cfg/models/v5/yolov5-p6.yaml | 59 - .../ultralytics/cfg/models/v5/yolov5.yaml | 48 - .../ultralytics/cfg/models/v6/yolov6.yaml | 53 - .../cfg/models/v8/yolov8-cls-resnet101.yaml | 25 - .../cfg/models/v8/yolov8-cls-resnet50.yaml | 25 - .../ultralytics/cfg/models/v8/yolov8-cls.yaml | 29 - .../cfg/models/v8/yolov8-ghost-p2.yaml | 54 - .../cfg/models/v8/yolov8-ghost-p6.yaml | 56 - .../cfg/models/v8/yolov8-ghost.yaml | 47 - .../ultralytics/cfg/models/v8/yolov8-obb.yaml | 46 - .../ultralytics/cfg/models/v8/yolov8-p2.yaml | 54 - .../ultralytics/cfg/models/v8/yolov8-p6.yaml | 56 - .../cfg/models/v8/yolov8-pose-p6.yaml | 57 - .../cfg/models/v8/yolov8-pose.yaml | 47 - .../cfg/models/v8/yolov8-rtdetr.yaml | 46 - .../cfg/models/v8/yolov8-seg-p6.yaml | 56 - .../ultralytics/cfg/models/v8/yolov8-seg.yaml | 46 - .../cfg/models/v8/yolov8-world.yaml | 48 - .../cfg/models/v8/yolov8-worldv2.yaml | 46 - .../ultralytics/cfg/models/v8/yolov8.yaml | 46 - .../ultralytics/cfg/models/v9/yolov9c.yaml | 36 - .../ultralytics/cfg/models/v9/yolov9e.yaml | 60 - .../ultralytics/cfg/trackers/botsort.yaml | 18 - .../ultralytics/cfg/trackers/bytetrack.yaml | 11 - ultralytics-main/ultralytics/data/__init__.py | 15 - .../ultralytics/data/annotator.py | 50 - ultralytics-main/ultralytics/data/augment.py | 1250 ---------------- ultralytics-main/ultralytics/data/base.py | 311 ---- ultralytics-main/ultralytics/data/build.py | 186 --- .../ultralytics/data/converter.py | 542 ------- ultralytics-main/ultralytics/data/dataset.py | 382 ----- .../ultralytics/data/explorer/__init__.py | 5 - .../ultralytics/data/explorer/explorer.py | 472 ------ .../ultralytics/data/explorer/gui/__init__.py | 1 - .../ultralytics/data/explorer/gui/dash.py | 268 ---- .../ultralytics/data/explorer/utils.py | 166 --- ultralytics-main/ultralytics/data/loaders.py | 555 ------- .../data/scripts/download_weights.sh | 18 - .../ultralytics/data/scripts/get_coco.sh | 60 - .../ultralytics/data/scripts/get_imagenet.sh | 51 - .../ultralytics/data/split_dota.py | 288 ---- ultralytics-main/ultralytics/data/utils.py | 651 --------- .../ultralytics/engine/__init__.py | 1 - .../ultralytics/engine/exporter.py | 1141 --------------- ultralytics-main/ultralytics/engine/model.py | 821 ----------- .../ultralytics/engine/predictor.py | 397 ----- .../ultralytics/engine/results.py | 728 ---------- .../ultralytics/engine/trainer.py | 758 ---------- ultralytics-main/ultralytics/engine/tuner.py | 241 --- .../ultralytics/engine/validator.py | 338 ----- ultralytics-main/ultralytics/hub/__init__.py | 128 -- ultralytics-main/ultralytics/hub/auth.py | 136 -- ultralytics-main/ultralytics/hub/session.py | 355 ----- ultralytics-main/ultralytics/hub/utils.py | 247 ---- .../ultralytics/models/__init__.py | 7 - .../ultralytics/models/fastsam/__init__.py | 8 - .../ultralytics/models/fastsam/model.py | 33 - .../ultralytics/models/fastsam/predict.py | 86 -- .../ultralytics/models/fastsam/prompt.py | 357 ----- .../ultralytics/models/fastsam/utils.py | 67 - .../ultralytics/models/fastsam/val.py | 40 - .../ultralytics/models/nas/__init__.py | 7 - .../ultralytics/models/nas/model.py | 83 -- .../ultralytics/models/nas/predict.py | 60 - .../ultralytics/models/nas/val.py | 50 - .../ultralytics/models/rtdetr/__init__.py | 7 - .../ultralytics/models/rtdetr/model.py | 54 - .../ultralytics/models/rtdetr/predict.py | 86 -- .../ultralytics/models/rtdetr/train.py | 101 -- .../ultralytics/models/rtdetr/val.py | 135 -- .../ultralytics/models/sam/__init__.py | 6 - .../ultralytics/models/sam/amg.py | 187 --- .../ultralytics/models/sam/build.py | 160 -- .../ultralytics/models/sam/model.py | 114 -- .../models/sam/modules/__init__.py | 1 - .../models/sam/modules/decoders.py | 190 --- .../models/sam/modules/encoders.py | 603 -------- .../ultralytics/models/sam/modules/sam.py | 65 - .../models/sam/modules/tiny_encoder.py | 742 ---------- .../models/sam/modules/transformer.py | 274 ---- .../ultralytics/models/sam/predict.py | 474 ------ .../ultralytics/models/utils/__init__.py | 1 - .../ultralytics/models/utils/loss.py | 345 ----- .../ultralytics/models/utils/ops.py | 263 ---- .../ultralytics/models/yolo/__init__.py | 7 - .../models/yolo/classify/__init__.py | 7 - .../models/yolo/classify/predict.py | 61 - .../ultralytics/models/yolo/classify/train.py | 158 -- .../ultralytics/models/yolo/classify/val.py | 113 -- .../models/yolo/detect/__init__.py | 7 - .../ultralytics/models/yolo/detect/predict.py | 43 - .../ultralytics/models/yolo/detect/train.py | 143 -- .../ultralytics/models/yolo/detect/val.py | 299 ---- .../ultralytics/models/yolo/model.py | 106 -- .../ultralytics/models/yolo/obb/__init__.py | 7 - .../ultralytics/models/yolo/obb/predict.py | 53 - .../ultralytics/models/yolo/obb/train.py | 42 - .../ultralytics/models/yolo/obb/val.py | 185 --- .../ultralytics/models/yolo/pose/__init__.py | 7 - .../ultralytics/models/yolo/pose/predict.py | 58 - .../ultralytics/models/yolo/pose/train.py | 79 - .../ultralytics/models/yolo/pose/val.py | 248 ---- .../models/yolo/segment/__init__.py | 7 - .../models/yolo/segment/predict.py | 57 - .../ultralytics/models/yolo/segment/train.py | 62 - .../ultralytics/models/yolo/segment/val.py | 277 ---- ultralytics-main/ultralytics/nn/__init__.py | 29 - .../ultralytics/nn/autobackend.py | 628 -------- .../ultralytics/nn/modules/__init__.py | 138 -- .../ultralytics/nn/modules/block.py | 698 --------- .../ultralytics/nn/modules/conv.py | 333 ----- .../ultralytics/nn/modules/head.py | 482 ------ .../ultralytics/nn/modules/transformer.py | 426 ------ .../ultralytics/nn/modules/utils.py | 85 -- ultralytics-main/ultralytics/nn/tasks.py | 1037 ------------- .../ultralytics/solutions/__init__.py | 1 - .../ultralytics/solutions/ai_gym.py | 158 -- .../solutions/distance_calculation.py | 181 --- .../ultralytics/solutions/heatmap.py | 281 ---- .../ultralytics/solutions/object_counter.py | 278 ---- .../ultralytics/solutions/speed.py | 164 --- .../ultralytics/solutions/speed_estimation.py | 198 --- .../ultralytics/trackers/README.md | 321 ---- .../ultralytics/trackers/__init__.py | 7 - .../ultralytics/trackers/basetrack.py | 105 -- .../ultralytics/trackers/bot_sort.py | 200 --- .../ultralytics/trackers/byte_tracker.py | 444 ------ .../ultralytics/trackers/track.py | 89 -- .../ultralytics/trackers/utils/__init__.py | 1 - .../ultralytics/trackers/utils/gmc.py | 363 ----- .../trackers/utils/kalman_filter.py | 360 ----- .../ultralytics/trackers/utils/matching.py | 138 -- .../ultralytics/utils/__init__.py | 1049 -------------- .../ultralytics/utils/autobatch.py | 88 -- .../ultralytics/utils/benchmarks.py | 402 ----- .../ultralytics/utils/callbacks/__init__.py | 5 - .../ultralytics/utils/callbacks/base.py | 219 --- .../ultralytics/utils/callbacks/clearml.py | 152 -- .../ultralytics/utils/callbacks/comet.py | 375 ----- .../ultralytics/utils/callbacks/dvc.py | 145 -- .../ultralytics/utils/callbacks/hub.py | 108 -- .../ultralytics/utils/callbacks/mlflow.py | 133 -- .../ultralytics/utils/callbacks/neptune.py | 112 -- .../ultralytics/utils/callbacks/raytune.py | 29 - .../utils/callbacks/tensorboard.py | 106 -- .../ultralytics/utils/callbacks/wb.py | 163 --- ultralytics-main/ultralytics/utils/checks.py | 729 ---------- ultralytics-main/ultralytics/utils/dist.py | 71 - .../ultralytics/utils/downloads.py | 500 ------- ultralytics-main/ultralytics/utils/errors.py | 22 - ultralytics-main/ultralytics/utils/files.py | 188 --- .../ultralytics/utils/instance.py | 407 ------ ultralytics-main/ultralytics/utils/loss.py | 715 --------- ultralytics-main/ultralytics/utils/metrics.py | 1289 ----------------- ultralytics-main/ultralytics/utils/ops.py | 849 ----------- ultralytics-main/ultralytics/utils/patches.py | 88 -- .../ultralytics/utils/plotting.py | 1048 -------------- ultralytics-main/ultralytics/utils/tal.py | 344 ----- .../ultralytics/utils/torch_utils.py | 608 -------- ultralytics-main/ultralytics/utils/triton.py | 92 -- ultralytics-main/ultralytics/utils/tuner.py | 146 -- ultralytics-main/ultralytics/zidane.jpg | Bin 168949 -> 0 bytes ultralytics-main/yolov8-stereo.py | 69 - yolov5_Monocular_social_ranging/.dockerignore | 222 +++ .../.gitattributes | 2 + .../.github/FUNDING.yml | 5 + .../.github/ISSUE_TEMPLATE/bug-report.yml | 45 +- .../.github/ISSUE_TEMPLATE/config.yml | 8 + .../ISSUE_TEMPLATE/feature-request.yml | 14 +- .../.github/ISSUE_TEMPLATE/question.yml | 8 +- .../.github/PULL_REQUEST_TEMPLATE.md | 7 + .../.github/dependabot.yml | 6 +- .../.github/workflows/ci-testing.yml | 93 ++ .../.github/workflows/codeql-analysis.yml | 54 + .../.github/workflows/greetings.yml | 59 + .../.github/workflows/rebase.yml | 21 + .../.github/workflows/stale.yml | 38 + yolov5_Monocular_social_ranging/.gitignore | 256 ++++ .../.pre-commit-config.yaml | 66 + .../0.8.1' | 0 .../CONTRIBUTING.md | 94 ++ yolov5_Monocular_social_ranging/Dockerfile | 64 + .../LICENSE | 153 +- yolov5_Monocular_social_ranging/README.md | 304 ++++ .../data/Argoverse.yaml | 67 + .../data/GlobalWheat2020.yaml | 53 + .../data/Objects365.yaml | 112 ++ .../data/SKU-110K.yaml | 52 + yolov5_Monocular_social_ranging/data/VOC.yaml | 80 + .../data/VisDrone.yaml | 61 + .../data/coco.yaml | 44 + .../data/coco128.yaml | 30 + .../data/hyps/hyp.Objects365.yaml | 34 + .../data/hyps/hyp.VOC.yaml | 40 + .../data/hyps/hyp.scratch-high.yaml | 34 + .../data/hyps/hyp.scratch-low.yaml | 34 + .../data/hyps/hyp.scratch-med.yaml | 34 + .../data/scripts/download_weights.sh | 20 + .../data/scripts/get_coco.sh | 27 + .../data/scripts/get_coco128.sh | 6 +- .../data/xView.yaml | 102 ++ yolov5_Monocular_social_ranging/detect.py | 332 +++++ yolov5_Monocular_social_ranging/distance.py | 18 + yolov5_Monocular_social_ranging/export.py | 559 +++++++ yolov5_Monocular_social_ranging/hubconf.py | 143 ++ .../models/__init__.py | 0 .../models/common.py | 677 +++++++++ .../models/experimental.py | 120 ++ .../models/hub/anchors.yaml | 59 + .../models/hub/yolov3-spp.yaml | 51 + .../models/hub/yolov3-tiny.yaml | 41 + .../models/hub/yolov3.yaml | 51 + .../models/hub/yolov5-bifpn.yaml | 48 + .../models/hub/yolov5-fpn.yaml | 42 + .../models/hub/yolov5-p2.yaml | 54 + .../models/hub/yolov5-p34.yaml | 41 + .../models/hub/yolov5-p6.yaml | 56 + .../models/hub/yolov5-p7.yaml | 67 + .../models/hub/yolov5-panet.yaml | 48 + .../models/hub/yolov5l6.yaml | 60 + .../models/hub/yolov5m6.yaml | 60 + .../models/hub/yolov5n6.yaml | 60 + .../models/hub/yolov5s-ghost.yaml | 48 + .../models/hub/yolov5s-transformer.yaml | 48 + .../models/hub/yolov5s6.yaml | 60 + .../models/hub/yolov5x6.yaml | 60 + yolov5_Monocular_social_ranging/models/tf.py | 464 ++++++ .../models/yolo.py | 329 +++++ .../models/yolov5l.yaml | 48 + .../models/yolov5m.yaml | 48 + .../models/yolov5n.yaml | 48 + .../models/yolov5s.yaml | 48 + .../models/yolov5x.yaml | 48 + .../requirements.txt | 37 + yolov5_Monocular_social_ranging/setup.cfg | 45 + yolov5_Monocular_social_ranging/train.py | 643 ++++++++ .../tutorial.ipynb | 1102 ++++++++++++++ .../utils/__init__.py | 37 + .../utils/activations.py | 101 ++ .../utils/augmentations.py | 277 ++++ .../utils/autoanchor.py | 165 +++ .../utils/autobatch.py | 57 + .../utils/aws/__init__.py | 0 .../utils/aws/mime.sh | 26 + .../utils/aws/resume.py | 40 + .../utils/aws/userdata.sh | 27 + .../utils/benchmarks.py | 92 ++ .../utils/callbacks.py | 78 + .../utils/datasets.py | 1037 +++++++++++++ .../utils/downloads.py | 153 ++ .../utils/flask_rest_api/README.md | 73 + .../utils/flask_rest_api/example_request.py | 13 + .../utils/flask_rest_api/restapi.py | 37 + .../utils/general.py | 880 +++++++++++ .../utils/google_app_engine/Dockerfile | 25 + .../additional_requirements.txt | 4 + .../utils/google_app_engine/app.yaml | 14 + .../utils/loggers/__init__.py | 168 +++ .../utils/loggers/wandb/README.md | 152 ++ .../utils/loggers/wandb/__init__.py | 0 .../utils/loggers/wandb/log_dataset.py | 27 + .../utils/loggers/wandb/sweep.py | 41 + .../utils/loggers/wandb/sweep.yaml | 143 ++ .../utils/loggers/wandb/wandb_utils.py | 562 +++++++ yolov5_Monocular_social_ranging/utils/loss.py | 222 +++ .../utils/metrics.py | 342 +++++ .../utils/plots.py | 471 ++++++ .../utils/torch_utils.py | 329 +++++ yolov5_Monocular_social_ranging/val.py | 383 +++++ 626 files changed, 13871 insertions(+), 71617 deletions(-) delete mode 100644 ultralytics-main/.github/ISSUE_TEMPLATE/config.yml delete mode 100644 ultralytics-main/.github/workflows/ci.yaml delete mode 100644 ultralytics-main/.github/workflows/cla.yml delete mode 100644 ultralytics-main/.github/workflows/codeql.yaml delete mode 100644 ultralytics-main/.github/workflows/docker.yaml delete mode 100644 ultralytics-main/.github/workflows/format.yml delete mode 100644 ultralytics-main/.github/workflows/greetings.yml delete mode 100644 ultralytics-main/.github/workflows/links.yml delete mode 100644 ultralytics-main/.github/workflows/publish.yml delete mode 100644 ultralytics-main/.github/workflows/stale.yml delete mode 100644 ultralytics-main/.gitignore delete mode 100644 ultralytics-main/.pre-commit-config.yaml delete mode 100644 ultralytics-main/Author_advice.txt delete mode 100644 ultralytics-main/CITATION.cff delete mode 100644 ultralytics-main/Instance Segmentation-camera.py delete mode 100644 ultralytics-main/Instance Segmentation-pic-video.py delete mode 100644 ultralytics-main/Instance Segmentation-track-camera.py delete mode 100644 ultralytics-main/Instance Segmentation-track-pic-video.py delete mode 100644 ultralytics-main/dataset/coco128/images/train2017/image_BS1_456_00_42_15.jpg delete mode 100644 ultralytics-main/dataset/coco128/images/train2017/image_BS1_457_00_42_15.jpg delete mode 100644 ultralytics-main/dataset/coco128/images/train2017/image_BS1_458_00_42_15.jpg delete mode 100644 ultralytics-main/dataset/coco128/images/train2017/image_BS1_459_00_42_15.jpg delete mode 100644 ultralytics-main/dataset/coco128/images/train2017/image_BS1_460_00_42_15.jpg delete mode 100644 ultralytics-main/dataset/coco128/images/train2017/image_BS1_461_00_42_15.jpg delete mode 100644 ultralytics-main/dataset/coco128/images/train2017/image_BS1_462_00_42_15.jpg delete mode 100644 ultralytics-main/dataset/coco128/images/train2017/image_BS1_463_00_42_15.jpg delete mode 100644 ultralytics-main/dataset/coco128/images/train2017/image_BS1_464_00_42_16.jpg delete mode 100644 ultralytics-main/dataset/coco128/images/train2017/image_BS1_465_00_42_16.jpg delete mode 100644 ultralytics-main/dataset/coco128/labels/train2017.cache delete mode 100644 ultralytics-main/dataset/coco128/labels/train2017/image_BS1_456_00_42_15.txt delete mode 100644 ultralytics-main/dataset/coco128/labels/train2017/image_BS1_457_00_42_15.txt delete mode 100644 ultralytics-main/dataset/coco128/labels/train2017/image_BS1_458_00_42_15.txt delete mode 100644 ultralytics-main/dataset/coco128/labels/train2017/image_BS1_459_00_42_15.txt delete mode 100644 ultralytics-main/dataset/coco128/labels/train2017/image_BS1_460_00_42_15.txt delete mode 100644 ultralytics-main/dataset/coco128/labels/train2017/image_BS1_461_00_42_15.txt delete mode 100644 ultralytics-main/dataset/coco128/labels/train2017/image_BS1_462_00_42_15.txt delete mode 100644 ultralytics-main/dataset/coco128/labels/train2017/image_BS1_463_00_42_15.txt delete mode 100644 ultralytics-main/dataset/coco128/labels/train2017/image_BS1_464_00_42_16.txt delete mode 100644 ultralytics-main/dataset/coco128/labels/train2017/image_BS1_465_00_42_16.txt delete mode 100644 ultralytics-main/docker/Dockerfile delete mode 100644 ultralytics-main/docker/Dockerfile-arm64 delete mode 100644 ultralytics-main/docker/Dockerfile-conda delete mode 100644 ultralytics-main/docker/Dockerfile-cpu delete mode 100644 ultralytics-main/docker/Dockerfile-jetson delete mode 100644 ultralytics-main/docker/Dockerfile-python delete mode 100644 ultralytics-main/docker/Dockerfile-runner delete mode 100644 ultralytics-main/docs/README.md delete mode 100644 ultralytics-main/docs/build_docs.py delete mode 100644 ultralytics-main/docs/build_reference.py delete mode 100644 ultralytics-main/docs/coming_soon_template.md delete mode 100644 ultralytics-main/docs/en/CNAME delete mode 100644 ultralytics-main/docs/en/guides/azureml-quickstart.md delete mode 100644 ultralytics-main/docs/en/guides/conda-quickstart.md delete mode 100644 ultralytics-main/docs/en/guides/coral-edge-tpu-on-raspberry-pi.md delete mode 100644 ultralytics-main/docs/en/guides/distance-calculation.md delete mode 100644 ultralytics-main/docs/en/guides/docker-quickstart.md delete mode 100644 ultralytics-main/docs/en/guides/heatmaps.md delete mode 100644 ultralytics-main/docs/en/guides/hyperparameter-tuning.md delete mode 100644 ultralytics-main/docs/en/guides/index.md delete mode 100644 ultralytics-main/docs/en/guides/instance-segmentation-and-tracking.md delete mode 100644 ultralytics-main/docs/en/guides/isolating-segmentation-objects.md delete mode 100644 ultralytics-main/docs/en/guides/kfold-cross-validation.md delete mode 100644 ultralytics-main/docs/en/guides/model-deployment-options.md delete mode 100644 ultralytics-main/docs/en/guides/object-blurring.md delete mode 100644 ultralytics-main/docs/en/guides/object-counting.md delete mode 100644 ultralytics-main/docs/en/guides/object-cropping.md delete mode 100644 ultralytics-main/docs/en/guides/optimizing-openvino-latency-vs-throughput-modes.md delete mode 100644 ultralytics-main/docs/en/guides/raspberry-pi.md delete mode 100644 ultralytics-main/docs/en/guides/region-counting.md delete mode 100644 ultralytics-main/docs/en/guides/sahi-tiled-inference.md delete mode 100644 ultralytics-main/docs/en/guides/security-alarm-system.md delete mode 100644 ultralytics-main/docs/en/guides/speed-estimation.md delete mode 100644 ultralytics-main/docs/en/guides/triton-inference-server.md delete mode 100644 ultralytics-main/docs/en/guides/view-results-in-terminal.md delete mode 100644 ultralytics-main/docs/en/guides/vision-eye.md delete mode 100644 ultralytics-main/docs/en/guides/workouts-monitoring.md delete mode 100644 ultralytics-main/docs/en/guides/yolo-common-issues.md delete mode 100644 ultralytics-main/docs/en/guides/yolo-performance-metrics.md delete mode 100644 ultralytics-main/docs/en/guides/yolo-thread-safe-inference.md delete mode 100644 ultralytics-main/docs/en/help/CI.md delete mode 100644 ultralytics-main/docs/en/help/CLA.md delete mode 100644 ultralytics-main/docs/en/help/FAQ.md delete mode 100644 ultralytics-main/docs/en/help/code_of_conduct.md delete mode 100644 ultralytics-main/docs/en/help/contributing.md delete mode 100644 ultralytics-main/docs/en/help/environmental-health-safety.md delete mode 100644 ultralytics-main/docs/en/help/index.md delete mode 100644 ultralytics-main/docs/en/help/minimum_reproducible_example.md delete mode 100644 ultralytics-main/docs/en/help/privacy.md delete mode 100644 ultralytics-main/docs/en/help/security.md delete mode 100644 ultralytics-main/docs/en/hub/api/index.md delete mode 100644 ultralytics-main/docs/en/hub/app/android.md delete mode 100644 ultralytics-main/docs/en/hub/app/index.md delete mode 100644 ultralytics-main/docs/en/hub/app/ios.md delete mode 100644 ultralytics-main/docs/en/hub/cloud-training.md delete mode 100644 ultralytics-main/docs/en/hub/datasets.md delete mode 100644 ultralytics-main/docs/en/hub/index.md delete mode 100644 ultralytics-main/docs/en/hub/inference-api.md delete mode 100644 ultralytics-main/docs/en/hub/integrations.md delete mode 100644 ultralytics-main/docs/en/hub/models.md delete mode 100644 ultralytics-main/docs/en/hub/on-premise/index.md delete mode 100644 ultralytics-main/docs/en/hub/projects.md delete mode 100644 ultralytics-main/docs/en/hub/quickstart.md delete mode 100644 ultralytics-main/docs/en/index.md delete mode 100644 ultralytics-main/docs/en/integrations/amazon-sagemaker.md delete mode 100644 ultralytics-main/docs/en/integrations/clearml.md delete mode 100644 ultralytics-main/docs/en/integrations/comet.md delete mode 100644 ultralytics-main/docs/en/integrations/coreml.md delete mode 100644 ultralytics-main/docs/en/integrations/dvc.md delete mode 100644 ultralytics-main/docs/en/integrations/edge-tpu.md delete mode 100644 ultralytics-main/docs/en/integrations/gradio.md delete mode 100644 ultralytics-main/docs/en/integrations/index.md delete mode 100644 ultralytics-main/docs/en/integrations/mlflow.md delete mode 100644 ultralytics-main/docs/en/integrations/ncnn.md delete mode 100644 ultralytics-main/docs/en/integrations/neural-magic.md delete mode 100644 ultralytics-main/docs/en/integrations/onnx.md delete mode 100644 ultralytics-main/docs/en/integrations/openvino.md delete mode 100644 ultralytics-main/docs/en/integrations/paddlepaddle.md delete mode 100644 ultralytics-main/docs/en/integrations/ray-tune.md delete mode 100644 ultralytics-main/docs/en/integrations/roboflow.md delete mode 100644 ultralytics-main/docs/en/integrations/tensorboard.md delete mode 100644 ultralytics-main/docs/en/integrations/tensorrt.md delete mode 100644 ultralytics-main/docs/en/integrations/tflite.md delete mode 100644 ultralytics-main/docs/en/integrations/torchscript.md delete mode 100644 ultralytics-main/docs/en/integrations/weights-biases.md delete mode 100644 ultralytics-main/docs/en/models/fast-sam.md delete mode 100644 ultralytics-main/docs/en/models/index.md delete mode 100644 ultralytics-main/docs/en/models/mobile-sam.md delete mode 100644 ultralytics-main/docs/en/models/rtdetr.md delete mode 100644 ultralytics-main/docs/en/models/sam.md delete mode 100644 ultralytics-main/docs/en/models/yolo-nas.md delete mode 100644 ultralytics-main/docs/en/models/yolo-world.md delete mode 100644 ultralytics-main/docs/en/models/yolov3.md delete mode 100644 ultralytics-main/docs/en/models/yolov4.md delete mode 100644 ultralytics-main/docs/en/models/yolov5.md delete mode 100644 ultralytics-main/docs/en/models/yolov6.md delete mode 100644 ultralytics-main/docs/en/models/yolov7.md delete mode 100644 ultralytics-main/docs/en/models/yolov8.md delete mode 100644 ultralytics-main/docs/en/models/yolov9.md delete mode 100644 ultralytics-main/docs/en/modes/benchmark.md delete mode 100644 ultralytics-main/docs/en/modes/export.md delete mode 100644 ultralytics-main/docs/en/modes/index.md delete mode 100644 ultralytics-main/docs/en/modes/predict.md delete mode 100644 ultralytics-main/docs/en/modes/track.md delete mode 100644 ultralytics-main/docs/en/modes/train.md delete mode 100644 ultralytics-main/docs/en/modes/val.md delete mode 100644 ultralytics-main/docs/en/quickstart.md delete mode 100644 ultralytics-main/docs/en/reference/cfg/__init__.md delete mode 100644 ultralytics-main/docs/en/reference/data/annotator.md delete mode 100644 ultralytics-main/docs/en/reference/data/augment.md delete mode 100644 ultralytics-main/docs/en/reference/data/base.md delete mode 100644 ultralytics-main/docs/en/reference/data/build.md delete mode 100644 ultralytics-main/docs/en/reference/data/converter.md delete mode 100644 ultralytics-main/docs/en/reference/data/dataset.md delete mode 100644 ultralytics-main/docs/en/reference/data/explorer/explorer.md delete mode 100644 ultralytics-main/docs/en/reference/data/explorer/gui/dash.md delete mode 100644 ultralytics-main/docs/en/reference/data/explorer/utils.md delete mode 100644 ultralytics-main/docs/en/reference/data/loaders.md delete mode 100644 ultralytics-main/docs/en/reference/data/split_dota.md delete mode 100644 ultralytics-main/docs/en/reference/data/utils.md delete mode 100644 ultralytics-main/docs/en/reference/engine/exporter.md delete mode 100644 ultralytics-main/docs/en/reference/engine/model.md delete mode 100644 ultralytics-main/docs/en/reference/engine/predictor.md delete mode 100644 ultralytics-main/docs/en/reference/engine/results.md delete mode 100644 ultralytics-main/docs/en/reference/engine/trainer.md delete mode 100644 ultralytics-main/docs/en/reference/engine/tuner.md delete mode 100644 ultralytics-main/docs/en/reference/engine/validator.md delete mode 100644 ultralytics-main/docs/en/reference/hub/__init__.md delete mode 100644 ultralytics-main/docs/en/reference/hub/auth.md delete mode 100644 ultralytics-main/docs/en/reference/hub/session.md delete mode 100644 ultralytics-main/docs/en/reference/hub/utils.md delete mode 100644 ultralytics-main/docs/en/reference/models/fastsam/model.md delete mode 100644 ultralytics-main/docs/en/reference/models/fastsam/predict.md delete mode 100644 ultralytics-main/docs/en/reference/models/fastsam/prompt.md delete mode 100644 ultralytics-main/docs/en/reference/models/fastsam/utils.md delete mode 100644 ultralytics-main/docs/en/reference/models/fastsam/val.md delete mode 100644 ultralytics-main/docs/en/reference/models/nas/model.md delete mode 100644 ultralytics-main/docs/en/reference/models/nas/predict.md delete mode 100644 ultralytics-main/docs/en/reference/models/nas/val.md delete mode 100644 ultralytics-main/docs/en/reference/models/rtdetr/model.md delete mode 100644 ultralytics-main/docs/en/reference/models/rtdetr/predict.md delete mode 100644 ultralytics-main/docs/en/reference/models/rtdetr/train.md delete mode 100644 ultralytics-main/docs/en/reference/models/rtdetr/val.md delete mode 100644 ultralytics-main/docs/en/reference/models/sam/amg.md delete mode 100644 ultralytics-main/docs/en/reference/models/sam/build.md delete mode 100644 ultralytics-main/docs/en/reference/models/sam/model.md delete mode 100644 ultralytics-main/docs/en/reference/models/sam/modules/decoders.md delete mode 100644 ultralytics-main/docs/en/reference/models/sam/modules/encoders.md delete mode 100644 ultralytics-main/docs/en/reference/models/sam/modules/sam.md delete mode 100644 ultralytics-main/docs/en/reference/models/sam/modules/tiny_encoder.md delete mode 100644 ultralytics-main/docs/en/reference/models/sam/modules/transformer.md delete mode 100644 ultralytics-main/docs/en/reference/models/sam/predict.md delete mode 100644 ultralytics-main/docs/en/reference/models/utils/loss.md delete mode 100644 ultralytics-main/docs/en/reference/models/utils/ops.md delete mode 100644 ultralytics-main/docs/en/reference/models/yolo/classify/predict.md delete mode 100644 ultralytics-main/docs/en/reference/models/yolo/classify/train.md delete mode 100644 ultralytics-main/docs/en/reference/models/yolo/classify/val.md delete mode 100644 ultralytics-main/docs/en/reference/models/yolo/detect/predict.md delete mode 100644 ultralytics-main/docs/en/reference/models/yolo/detect/train.md delete mode 100644 ultralytics-main/docs/en/reference/models/yolo/detect/val.md delete mode 100644 ultralytics-main/docs/en/reference/models/yolo/model.md delete mode 100644 ultralytics-main/docs/en/reference/models/yolo/obb/predict.md delete mode 100644 ultralytics-main/docs/en/reference/models/yolo/obb/train.md delete mode 100644 ultralytics-main/docs/en/reference/models/yolo/obb/val.md delete mode 100644 ultralytics-main/docs/en/reference/models/yolo/pose/predict.md delete mode 100644 ultralytics-main/docs/en/reference/models/yolo/pose/train.md delete mode 100644 ultralytics-main/docs/en/reference/models/yolo/pose/val.md delete mode 100644 ultralytics-main/docs/en/reference/models/yolo/segment/predict.md delete mode 100644 ultralytics-main/docs/en/reference/models/yolo/segment/train.md delete mode 100644 ultralytics-main/docs/en/reference/models/yolo/segment/val.md delete mode 100644 ultralytics-main/docs/en/reference/nn/autobackend.md delete mode 100644 ultralytics-main/docs/en/reference/nn/modules/block.md delete mode 100644 ultralytics-main/docs/en/reference/nn/modules/conv.md delete mode 100644 ultralytics-main/docs/en/reference/nn/modules/head.md delete mode 100644 ultralytics-main/docs/en/reference/nn/modules/transformer.md delete mode 100644 ultralytics-main/docs/en/reference/nn/modules/utils.md delete mode 100644 ultralytics-main/docs/en/reference/nn/tasks.md delete mode 100644 ultralytics-main/docs/en/reference/solutions/ai_gym.md delete mode 100644 ultralytics-main/docs/en/reference/solutions/distance_calculation.md delete mode 100644 ultralytics-main/docs/en/reference/solutions/heatmap.md delete mode 100644 ultralytics-main/docs/en/reference/solutions/object_counter.md delete mode 100644 ultralytics-main/docs/en/reference/solutions/speed_estimation.md delete mode 100644 ultralytics-main/docs/en/reference/trackers/basetrack.md delete mode 100644 ultralytics-main/docs/en/reference/trackers/bot_sort.md delete mode 100644 ultralytics-main/docs/en/reference/trackers/byte_tracker.md delete mode 100644 ultralytics-main/docs/en/reference/trackers/track.md delete mode 100644 ultralytics-main/docs/en/reference/trackers/utils/gmc.md delete mode 100644 ultralytics-main/docs/en/reference/trackers/utils/kalman_filter.md delete mode 100644 ultralytics-main/docs/en/reference/trackers/utils/matching.md delete mode 100644 ultralytics-main/docs/en/reference/utils/__init__.md delete mode 100644 ultralytics-main/docs/en/reference/utils/autobatch.md delete mode 100644 ultralytics-main/docs/en/reference/utils/benchmarks.md delete mode 100644 ultralytics-main/docs/en/reference/utils/callbacks/base.md delete mode 100644 ultralytics-main/docs/en/reference/utils/callbacks/clearml.md delete mode 100644 ultralytics-main/docs/en/reference/utils/callbacks/comet.md delete mode 100644 ultralytics-main/docs/en/reference/utils/callbacks/dvc.md delete mode 100644 ultralytics-main/docs/en/reference/utils/callbacks/hub.md delete mode 100644 ultralytics-main/docs/en/reference/utils/callbacks/mlflow.md delete mode 100644 ultralytics-main/docs/en/reference/utils/callbacks/neptune.md delete mode 100644 ultralytics-main/docs/en/reference/utils/callbacks/raytune.md delete mode 100644 ultralytics-main/docs/en/reference/utils/callbacks/tensorboard.md delete mode 100644 ultralytics-main/docs/en/reference/utils/callbacks/wb.md delete mode 100644 ultralytics-main/docs/en/reference/utils/checks.md delete mode 100644 ultralytics-main/docs/en/reference/utils/dist.md delete mode 100644 ultralytics-main/docs/en/reference/utils/downloads.md delete mode 100644 ultralytics-main/docs/en/reference/utils/errors.md delete mode 100644 ultralytics-main/docs/en/reference/utils/files.md delete mode 100644 ultralytics-main/docs/en/reference/utils/instance.md delete mode 100644 ultralytics-main/docs/en/reference/utils/loss.md delete mode 100644 ultralytics-main/docs/en/reference/utils/metrics.md delete mode 100644 ultralytics-main/docs/en/reference/utils/ops.md delete mode 100644 ultralytics-main/docs/en/reference/utils/patches.md delete mode 100644 ultralytics-main/docs/en/reference/utils/plotting.md delete mode 100644 ultralytics-main/docs/en/reference/utils/tal.md delete mode 100644 ultralytics-main/docs/en/reference/utils/torch_utils.md delete mode 100644 ultralytics-main/docs/en/reference/utils/triton.md delete mode 100644 ultralytics-main/docs/en/reference/utils/tuner.md delete mode 100644 ultralytics-main/docs/en/robots.txt delete mode 100644 ultralytics-main/docs/en/tasks/classify.md delete mode 100644 ultralytics-main/docs/en/tasks/detect.md delete mode 100644 ultralytics-main/docs/en/tasks/index.md delete mode 100644 ultralytics-main/docs/en/tasks/obb.md delete mode 100644 ultralytics-main/docs/en/tasks/pose.md delete mode 100644 ultralytics-main/docs/en/tasks/segment.md delete mode 100644 ultralytics-main/docs/en/usage/callbacks.md delete mode 100644 ultralytics-main/docs/en/usage/cfg.md delete mode 100644 ultralytics-main/docs/en/usage/cli.md delete mode 100644 ultralytics-main/docs/en/usage/engine.md delete mode 100644 ultralytics-main/docs/en/usage/python.md delete mode 100644 ultralytics-main/docs/en/usage/simple-utilities.md delete mode 100644 ultralytics-main/docs/en/yolov5/environments/aws_quickstart_tutorial.md delete mode 100644 ultralytics-main/docs/en/yolov5/environments/azureml_quickstart_tutorial.md delete mode 100644 ultralytics-main/docs/en/yolov5/environments/docker_image_quickstart_tutorial.md delete mode 100644 ultralytics-main/docs/en/yolov5/environments/google_cloud_quickstart_tutorial.md delete mode 100644 ultralytics-main/docs/en/yolov5/index.md delete mode 100644 ultralytics-main/docs/en/yolov5/quickstart_tutorial.md delete mode 100644 ultralytics-main/docs/en/yolov5/tutorials/architecture_description.md delete mode 100644 ultralytics-main/docs/en/yolov5/tutorials/clearml_logging_integration.md delete mode 100644 ultralytics-main/docs/en/yolov5/tutorials/comet_logging_integration.md delete mode 100644 ultralytics-main/docs/en/yolov5/tutorials/hyperparameter_evolution.md delete mode 100644 ultralytics-main/docs/en/yolov5/tutorials/model_ensembling.md delete mode 100644 ultralytics-main/docs/en/yolov5/tutorials/model_export.md delete mode 100644 ultralytics-main/docs/en/yolov5/tutorials/model_pruning_and_sparsity.md delete mode 100644 ultralytics-main/docs/en/yolov5/tutorials/multi_gpu_training.md delete mode 100644 ultralytics-main/docs/en/yolov5/tutorials/neural_magic_pruning_quantization.md delete mode 100644 ultralytics-main/docs/en/yolov5/tutorials/pytorch_hub_model_loading.md delete mode 100644 ultralytics-main/docs/en/yolov5/tutorials/roboflow_datasets_integration.md delete mode 100644 ultralytics-main/docs/en/yolov5/tutorials/running_on_jetson_nano.md delete mode 100644 ultralytics-main/docs/en/yolov5/tutorials/test_time_augmentation.md delete mode 100644 ultralytics-main/docs/en/yolov5/tutorials/tips_for_best_training_results.md delete mode 100644 ultralytics-main/docs/en/yolov5/tutorials/train_custom_data.md delete mode 100644 ultralytics-main/docs/en/yolov5/tutorials/transfer_learning_with_frozen_layers.md delete mode 100644 ultralytics-main/docs/overrides/assets/favicon.ico delete mode 100644 ultralytics-main/docs/overrides/javascript/extra.js delete mode 100644 ultralytics-main/docs/overrides/main.html delete mode 100644 ultralytics-main/docs/overrides/partials/comments.html delete mode 100644 ultralytics-main/docs/overrides/partials/source-file.html delete mode 100644 ultralytics-main/docs/overrides/stylesheets/style.css delete mode 100644 ultralytics-main/examples/README.md delete mode 100644 ultralytics-main/examples/YOLOv8-CPP-Inference/CMakeLists.txt delete mode 100644 ultralytics-main/examples/YOLOv8-CPP-Inference/README.md delete mode 100644 ultralytics-main/examples/YOLOv8-CPP-Inference/inference.cpp delete mode 100644 ultralytics-main/examples/YOLOv8-CPP-Inference/inference.h delete mode 100644 ultralytics-main/examples/YOLOv8-CPP-Inference/main.cpp delete mode 100644 ultralytics-main/examples/YOLOv8-LibTorch-CPP-Inference/CMakeLists.txt delete mode 100644 ultralytics-main/examples/YOLOv8-LibTorch-CPP-Inference/README.md delete mode 100644 ultralytics-main/examples/YOLOv8-LibTorch-CPP-Inference/main.cc delete mode 100644 ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/CMakeLists.txt delete mode 100644 ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/README.md delete mode 100644 ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/inference.cpp delete mode 100644 ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/inference.h delete mode 100644 ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/main.cpp delete mode 100644 ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/Cargo.toml delete mode 100644 ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/README.md delete mode 100644 ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/cli.rs delete mode 100644 ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/lib.rs delete mode 100644 ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/main.rs delete mode 100644 ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/model.rs delete mode 100644 ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/ort_backend.rs delete mode 100644 ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/yolo_result.rs delete mode 100644 ultralytics-main/examples/YOLOv8-ONNXRuntime/README.md delete mode 100644 ultralytics-main/examples/YOLOv8-ONNXRuntime/main.py delete mode 100644 ultralytics-main/examples/YOLOv8-OpenCV-ONNX-Python/README.md delete mode 100644 ultralytics-main/examples/YOLOv8-OpenCV-ONNX-Python/main.py delete mode 100644 ultralytics-main/examples/YOLOv8-OpenCV-int8-tflite-Python/README.md delete mode 100644 ultralytics-main/examples/YOLOv8-OpenCV-int8-tflite-Python/main.py delete mode 100644 ultralytics-main/examples/YOLOv8-Region-Counter/readme.md delete mode 100644 ultralytics-main/examples/YOLOv8-Region-Counter/yolov8_region_counter.py delete mode 100644 ultralytics-main/examples/YOLOv8-SAHI-Inference-Video/readme.md delete mode 100644 ultralytics-main/examples/YOLOv8-SAHI-Inference-Video/yolov8_sahi.py delete mode 100644 ultralytics-main/examples/YOLOv8-Segmentation-ONNXRuntime-Python/README.md delete mode 100644 ultralytics-main/examples/YOLOv8-Segmentation-ONNXRuntime-Python/main.py delete mode 100644 ultralytics-main/examples/heatmaps.ipynb delete mode 100644 ultralytics-main/examples/hub.ipynb delete mode 100644 ultralytics-main/examples/object_counting.ipynb delete mode 100644 ultralytics-main/examples/object_tracking.ipynb delete mode 100644 ultralytics-main/examples/tutorial.ipynb delete mode 100644 ultralytics-main/main.py delete mode 100644 ultralytics-main/mkdocs.yml delete mode 100644 ultralytics-main/pyproject.toml delete mode 100644 ultralytics-main/requirements.txt delete mode 100644 ultralytics-main/setup.py delete mode 100644 ultralytics-main/stereo-speed.py delete mode 100644 ultralytics-main/stereo/dianyuntu_yolo.py delete mode 100644 ultralytics-main/stereo/stereo.py delete mode 100644 ultralytics-main/stereo/stereoconfig_040_2.py delete mode 100644 ultralytics-main/ultralytics/__init__.py delete mode 100644 ultralytics-main/ultralytics/bus.jpg delete mode 100644 ultralytics-main/ultralytics/cfg/__init__.py delete mode 100644 ultralytics-main/ultralytics/cfg/default.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/README.md delete mode 100644 ultralytics-main/ultralytics/cfg/models/rt-detr/rtdetr-l.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/rt-detr/rtdetr-resnet101.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/rt-detr/rtdetr-resnet50.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/rt-detr/rtdetr-x.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v3/yolov3-spp.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v3/yolov3-tiny.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v3/yolov3.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v5/yolov5-p6.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v5/yolov5.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v6/yolov6.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v8/yolov8-cls-resnet101.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v8/yolov8-cls-resnet50.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v8/yolov8-cls.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v8/yolov8-ghost-p2.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v8/yolov8-ghost-p6.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v8/yolov8-ghost.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v8/yolov8-obb.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v8/yolov8-p2.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v8/yolov8-p6.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v8/yolov8-pose-p6.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v8/yolov8-pose.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v8/yolov8-rtdetr.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v8/yolov8-seg-p6.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v8/yolov8-seg.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v8/yolov8-world.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v8/yolov8-worldv2.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v8/yolov8.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v9/yolov9c.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/models/v9/yolov9e.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/trackers/botsort.yaml delete mode 100644 ultralytics-main/ultralytics/cfg/trackers/bytetrack.yaml delete mode 100644 ultralytics-main/ultralytics/data/__init__.py delete mode 100644 ultralytics-main/ultralytics/data/annotator.py delete mode 100644 ultralytics-main/ultralytics/data/augment.py delete mode 100644 ultralytics-main/ultralytics/data/base.py delete mode 100644 ultralytics-main/ultralytics/data/build.py delete mode 100644 ultralytics-main/ultralytics/data/converter.py delete mode 100644 ultralytics-main/ultralytics/data/dataset.py delete mode 100644 ultralytics-main/ultralytics/data/explorer/__init__.py delete mode 100644 ultralytics-main/ultralytics/data/explorer/explorer.py delete mode 100644 ultralytics-main/ultralytics/data/explorer/gui/__init__.py delete mode 100644 ultralytics-main/ultralytics/data/explorer/gui/dash.py delete mode 100644 ultralytics-main/ultralytics/data/explorer/utils.py delete mode 100644 ultralytics-main/ultralytics/data/loaders.py delete mode 100644 ultralytics-main/ultralytics/data/scripts/download_weights.sh delete mode 100644 ultralytics-main/ultralytics/data/scripts/get_coco.sh delete mode 100644 ultralytics-main/ultralytics/data/scripts/get_imagenet.sh delete mode 100644 ultralytics-main/ultralytics/data/split_dota.py delete mode 100644 ultralytics-main/ultralytics/data/utils.py delete mode 100644 ultralytics-main/ultralytics/engine/__init__.py delete mode 100644 ultralytics-main/ultralytics/engine/exporter.py delete mode 100644 ultralytics-main/ultralytics/engine/model.py delete mode 100644 ultralytics-main/ultralytics/engine/predictor.py delete mode 100644 ultralytics-main/ultralytics/engine/results.py delete mode 100644 ultralytics-main/ultralytics/engine/trainer.py delete mode 100644 ultralytics-main/ultralytics/engine/tuner.py delete mode 100644 ultralytics-main/ultralytics/engine/validator.py delete mode 100644 ultralytics-main/ultralytics/hub/__init__.py delete mode 100644 ultralytics-main/ultralytics/hub/auth.py delete mode 100644 ultralytics-main/ultralytics/hub/session.py delete mode 100644 ultralytics-main/ultralytics/hub/utils.py delete mode 100644 ultralytics-main/ultralytics/models/__init__.py delete mode 100644 ultralytics-main/ultralytics/models/fastsam/__init__.py delete mode 100644 ultralytics-main/ultralytics/models/fastsam/model.py delete mode 100644 ultralytics-main/ultralytics/models/fastsam/predict.py delete mode 100644 ultralytics-main/ultralytics/models/fastsam/prompt.py delete mode 100644 ultralytics-main/ultralytics/models/fastsam/utils.py delete mode 100644 ultralytics-main/ultralytics/models/fastsam/val.py delete mode 100644 ultralytics-main/ultralytics/models/nas/__init__.py delete mode 100644 ultralytics-main/ultralytics/models/nas/model.py delete mode 100644 ultralytics-main/ultralytics/models/nas/predict.py delete mode 100644 ultralytics-main/ultralytics/models/nas/val.py delete mode 100644 ultralytics-main/ultralytics/models/rtdetr/__init__.py delete mode 100644 ultralytics-main/ultralytics/models/rtdetr/model.py delete mode 100644 ultralytics-main/ultralytics/models/rtdetr/predict.py delete mode 100644 ultralytics-main/ultralytics/models/rtdetr/train.py delete mode 100644 ultralytics-main/ultralytics/models/rtdetr/val.py delete mode 100644 ultralytics-main/ultralytics/models/sam/__init__.py delete mode 100644 ultralytics-main/ultralytics/models/sam/amg.py delete mode 100644 ultralytics-main/ultralytics/models/sam/build.py delete mode 100644 ultralytics-main/ultralytics/models/sam/model.py delete mode 100644 ultralytics-main/ultralytics/models/sam/modules/__init__.py delete mode 100644 ultralytics-main/ultralytics/models/sam/modules/decoders.py delete mode 100644 ultralytics-main/ultralytics/models/sam/modules/encoders.py delete mode 100644 ultralytics-main/ultralytics/models/sam/modules/sam.py delete mode 100644 ultralytics-main/ultralytics/models/sam/modules/tiny_encoder.py delete mode 100644 ultralytics-main/ultralytics/models/sam/modules/transformer.py delete mode 100644 ultralytics-main/ultralytics/models/sam/predict.py delete mode 100644 ultralytics-main/ultralytics/models/utils/__init__.py delete mode 100644 ultralytics-main/ultralytics/models/utils/loss.py delete mode 100644 ultralytics-main/ultralytics/models/utils/ops.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/__init__.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/classify/__init__.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/classify/predict.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/classify/train.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/classify/val.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/detect/__init__.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/detect/predict.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/detect/train.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/detect/val.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/model.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/obb/__init__.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/obb/predict.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/obb/train.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/obb/val.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/pose/__init__.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/pose/predict.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/pose/train.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/pose/val.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/segment/__init__.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/segment/predict.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/segment/train.py delete mode 100644 ultralytics-main/ultralytics/models/yolo/segment/val.py delete mode 100644 ultralytics-main/ultralytics/nn/__init__.py delete mode 100644 ultralytics-main/ultralytics/nn/autobackend.py delete mode 100644 ultralytics-main/ultralytics/nn/modules/__init__.py delete mode 100644 ultralytics-main/ultralytics/nn/modules/block.py delete mode 100644 ultralytics-main/ultralytics/nn/modules/conv.py delete mode 100644 ultralytics-main/ultralytics/nn/modules/head.py delete mode 100644 ultralytics-main/ultralytics/nn/modules/transformer.py delete mode 100644 ultralytics-main/ultralytics/nn/modules/utils.py delete mode 100644 ultralytics-main/ultralytics/nn/tasks.py delete mode 100644 ultralytics-main/ultralytics/solutions/__init__.py delete mode 100644 ultralytics-main/ultralytics/solutions/ai_gym.py delete mode 100644 ultralytics-main/ultralytics/solutions/distance_calculation.py delete mode 100644 ultralytics-main/ultralytics/solutions/heatmap.py delete mode 100644 ultralytics-main/ultralytics/solutions/object_counter.py delete mode 100644 ultralytics-main/ultralytics/solutions/speed.py delete mode 100644 ultralytics-main/ultralytics/solutions/speed_estimation.py delete mode 100644 ultralytics-main/ultralytics/trackers/README.md delete mode 100644 ultralytics-main/ultralytics/trackers/__init__.py delete mode 100644 ultralytics-main/ultralytics/trackers/basetrack.py delete mode 100644 ultralytics-main/ultralytics/trackers/bot_sort.py delete mode 100644 ultralytics-main/ultralytics/trackers/byte_tracker.py delete mode 100644 ultralytics-main/ultralytics/trackers/track.py delete mode 100644 ultralytics-main/ultralytics/trackers/utils/__init__.py delete mode 100644 ultralytics-main/ultralytics/trackers/utils/gmc.py delete mode 100644 ultralytics-main/ultralytics/trackers/utils/kalman_filter.py delete mode 100644 ultralytics-main/ultralytics/trackers/utils/matching.py delete mode 100644 ultralytics-main/ultralytics/utils/__init__.py delete mode 100644 ultralytics-main/ultralytics/utils/autobatch.py delete mode 100644 ultralytics-main/ultralytics/utils/benchmarks.py delete mode 100644 ultralytics-main/ultralytics/utils/callbacks/__init__.py delete mode 100644 ultralytics-main/ultralytics/utils/callbacks/base.py delete mode 100644 ultralytics-main/ultralytics/utils/callbacks/clearml.py delete mode 100644 ultralytics-main/ultralytics/utils/callbacks/comet.py delete mode 100644 ultralytics-main/ultralytics/utils/callbacks/dvc.py delete mode 100644 ultralytics-main/ultralytics/utils/callbacks/hub.py delete mode 100644 ultralytics-main/ultralytics/utils/callbacks/mlflow.py delete mode 100644 ultralytics-main/ultralytics/utils/callbacks/neptune.py delete mode 100644 ultralytics-main/ultralytics/utils/callbacks/raytune.py delete mode 100644 ultralytics-main/ultralytics/utils/callbacks/tensorboard.py delete mode 100644 ultralytics-main/ultralytics/utils/callbacks/wb.py delete mode 100644 ultralytics-main/ultralytics/utils/checks.py delete mode 100644 ultralytics-main/ultralytics/utils/dist.py delete mode 100644 ultralytics-main/ultralytics/utils/downloads.py delete mode 100644 ultralytics-main/ultralytics/utils/errors.py delete mode 100644 ultralytics-main/ultralytics/utils/files.py delete mode 100644 ultralytics-main/ultralytics/utils/instance.py delete mode 100644 ultralytics-main/ultralytics/utils/loss.py delete mode 100644 ultralytics-main/ultralytics/utils/metrics.py delete mode 100644 ultralytics-main/ultralytics/utils/ops.py delete mode 100644 ultralytics-main/ultralytics/utils/patches.py delete mode 100644 ultralytics-main/ultralytics/utils/plotting.py delete mode 100644 ultralytics-main/ultralytics/utils/tal.py delete mode 100644 ultralytics-main/ultralytics/utils/torch_utils.py delete mode 100644 ultralytics-main/ultralytics/utils/triton.py delete mode 100644 ultralytics-main/ultralytics/utils/tuner.py delete mode 100644 ultralytics-main/ultralytics/zidane.jpg delete mode 100644 ultralytics-main/yolov8-stereo.py create mode 100644 yolov5_Monocular_social_ranging/.dockerignore create mode 100644 yolov5_Monocular_social_ranging/.gitattributes create mode 100644 yolov5_Monocular_social_ranging/.github/FUNDING.yml rename {ultralytics-main => yolov5_Monocular_social_ranging}/.github/ISSUE_TEMPLATE/bug-report.yml (54%) create mode 100644 yolov5_Monocular_social_ranging/.github/ISSUE_TEMPLATE/config.yml rename {ultralytics-main => yolov5_Monocular_social_ranging}/.github/ISSUE_TEMPLATE/feature-request.yml (58%) rename {ultralytics-main => yolov5_Monocular_social_ranging}/.github/ISSUE_TEMPLATE/question.yml (55%) create mode 100644 yolov5_Monocular_social_ranging/.github/PULL_REQUEST_TEMPLATE.md rename {ultralytics-main => yolov5_Monocular_social_ranging}/.github/dependabot.yml (65%) create mode 100644 yolov5_Monocular_social_ranging/.github/workflows/ci-testing.yml create mode 100644 yolov5_Monocular_social_ranging/.github/workflows/codeql-analysis.yml create mode 100644 yolov5_Monocular_social_ranging/.github/workflows/greetings.yml create mode 100644 yolov5_Monocular_social_ranging/.github/workflows/rebase.yml create mode 100644 yolov5_Monocular_social_ranging/.github/workflows/stale.yml create mode 100644 yolov5_Monocular_social_ranging/.gitignore create mode 100644 yolov5_Monocular_social_ranging/.pre-commit-config.yaml rename ultralytics-main/ultralytics/solutions/d_speed.py => yolov5_Monocular_social_ranging/0.8.1' (100%) create mode 100644 yolov5_Monocular_social_ranging/CONTRIBUTING.md create mode 100644 yolov5_Monocular_social_ranging/Dockerfile rename {ultralytics-main => yolov5_Monocular_social_ranging}/LICENSE (86%) create mode 100644 yolov5_Monocular_social_ranging/README.md create mode 100644 yolov5_Monocular_social_ranging/data/Argoverse.yaml create mode 100644 yolov5_Monocular_social_ranging/data/GlobalWheat2020.yaml create mode 100644 yolov5_Monocular_social_ranging/data/Objects365.yaml create mode 100644 yolov5_Monocular_social_ranging/data/SKU-110K.yaml create mode 100644 yolov5_Monocular_social_ranging/data/VOC.yaml create mode 100644 yolov5_Monocular_social_ranging/data/VisDrone.yaml create mode 100644 yolov5_Monocular_social_ranging/data/coco.yaml create mode 100644 yolov5_Monocular_social_ranging/data/coco128.yaml create mode 100644 yolov5_Monocular_social_ranging/data/hyps/hyp.Objects365.yaml create mode 100644 yolov5_Monocular_social_ranging/data/hyps/hyp.VOC.yaml create mode 100644 yolov5_Monocular_social_ranging/data/hyps/hyp.scratch-high.yaml create mode 100644 yolov5_Monocular_social_ranging/data/hyps/hyp.scratch-low.yaml create mode 100644 yolov5_Monocular_social_ranging/data/hyps/hyp.scratch-med.yaml create mode 100644 yolov5_Monocular_social_ranging/data/scripts/download_weights.sh create mode 100644 yolov5_Monocular_social_ranging/data/scripts/get_coco.sh rename {ultralytics-main/ultralytics => yolov5_Monocular_social_ranging}/data/scripts/get_coco128.sh (80%) create mode 100644 yolov5_Monocular_social_ranging/data/xView.yaml create mode 100644 yolov5_Monocular_social_ranging/detect.py create mode 100644 yolov5_Monocular_social_ranging/distance.py create mode 100644 yolov5_Monocular_social_ranging/export.py create mode 100644 yolov5_Monocular_social_ranging/hubconf.py create mode 100644 yolov5_Monocular_social_ranging/models/__init__.py create mode 100644 yolov5_Monocular_social_ranging/models/common.py create mode 100644 yolov5_Monocular_social_ranging/models/experimental.py create mode 100644 yolov5_Monocular_social_ranging/models/hub/anchors.yaml create mode 100644 yolov5_Monocular_social_ranging/models/hub/yolov3-spp.yaml create mode 100644 yolov5_Monocular_social_ranging/models/hub/yolov3-tiny.yaml create mode 100644 yolov5_Monocular_social_ranging/models/hub/yolov3.yaml create mode 100644 yolov5_Monocular_social_ranging/models/hub/yolov5-bifpn.yaml create mode 100644 yolov5_Monocular_social_ranging/models/hub/yolov5-fpn.yaml create mode 100644 yolov5_Monocular_social_ranging/models/hub/yolov5-p2.yaml create mode 100644 yolov5_Monocular_social_ranging/models/hub/yolov5-p34.yaml create mode 100644 yolov5_Monocular_social_ranging/models/hub/yolov5-p6.yaml create mode 100644 yolov5_Monocular_social_ranging/models/hub/yolov5-p7.yaml create mode 100644 yolov5_Monocular_social_ranging/models/hub/yolov5-panet.yaml create mode 100644 yolov5_Monocular_social_ranging/models/hub/yolov5l6.yaml create mode 100644 yolov5_Monocular_social_ranging/models/hub/yolov5m6.yaml create mode 100644 yolov5_Monocular_social_ranging/models/hub/yolov5n6.yaml create mode 100644 yolov5_Monocular_social_ranging/models/hub/yolov5s-ghost.yaml create mode 100644 yolov5_Monocular_social_ranging/models/hub/yolov5s-transformer.yaml create mode 100644 yolov5_Monocular_social_ranging/models/hub/yolov5s6.yaml create mode 100644 yolov5_Monocular_social_ranging/models/hub/yolov5x6.yaml create mode 100644 yolov5_Monocular_social_ranging/models/tf.py create mode 100644 yolov5_Monocular_social_ranging/models/yolo.py create mode 100644 yolov5_Monocular_social_ranging/models/yolov5l.yaml create mode 100644 yolov5_Monocular_social_ranging/models/yolov5m.yaml create mode 100644 yolov5_Monocular_social_ranging/models/yolov5n.yaml create mode 100644 yolov5_Monocular_social_ranging/models/yolov5s.yaml create mode 100644 yolov5_Monocular_social_ranging/models/yolov5x.yaml create mode 100644 yolov5_Monocular_social_ranging/requirements.txt create mode 100644 yolov5_Monocular_social_ranging/setup.cfg create mode 100644 yolov5_Monocular_social_ranging/train.py create mode 100644 yolov5_Monocular_social_ranging/tutorial.ipynb create mode 100644 yolov5_Monocular_social_ranging/utils/__init__.py create mode 100644 yolov5_Monocular_social_ranging/utils/activations.py create mode 100644 yolov5_Monocular_social_ranging/utils/augmentations.py create mode 100644 yolov5_Monocular_social_ranging/utils/autoanchor.py create mode 100644 yolov5_Monocular_social_ranging/utils/autobatch.py create mode 100644 yolov5_Monocular_social_ranging/utils/aws/__init__.py create mode 100644 yolov5_Monocular_social_ranging/utils/aws/mime.sh create mode 100644 yolov5_Monocular_social_ranging/utils/aws/resume.py create mode 100644 yolov5_Monocular_social_ranging/utils/aws/userdata.sh create mode 100644 yolov5_Monocular_social_ranging/utils/benchmarks.py create mode 100644 yolov5_Monocular_social_ranging/utils/callbacks.py create mode 100644 yolov5_Monocular_social_ranging/utils/datasets.py create mode 100644 yolov5_Monocular_social_ranging/utils/downloads.py create mode 100644 yolov5_Monocular_social_ranging/utils/flask_rest_api/README.md create mode 100644 yolov5_Monocular_social_ranging/utils/flask_rest_api/example_request.py create mode 100644 yolov5_Monocular_social_ranging/utils/flask_rest_api/restapi.py create mode 100644 yolov5_Monocular_social_ranging/utils/general.py create mode 100644 yolov5_Monocular_social_ranging/utils/google_app_engine/Dockerfile create mode 100644 yolov5_Monocular_social_ranging/utils/google_app_engine/additional_requirements.txt create mode 100644 yolov5_Monocular_social_ranging/utils/google_app_engine/app.yaml create mode 100644 yolov5_Monocular_social_ranging/utils/loggers/__init__.py create mode 100644 yolov5_Monocular_social_ranging/utils/loggers/wandb/README.md create mode 100644 yolov5_Monocular_social_ranging/utils/loggers/wandb/__init__.py create mode 100644 yolov5_Monocular_social_ranging/utils/loggers/wandb/log_dataset.py create mode 100644 yolov5_Monocular_social_ranging/utils/loggers/wandb/sweep.py create mode 100644 yolov5_Monocular_social_ranging/utils/loggers/wandb/sweep.yaml create mode 100644 yolov5_Monocular_social_ranging/utils/loggers/wandb/wandb_utils.py create mode 100644 yolov5_Monocular_social_ranging/utils/loss.py create mode 100644 yolov5_Monocular_social_ranging/utils/metrics.py create mode 100644 yolov5_Monocular_social_ranging/utils/plots.py create mode 100644 yolov5_Monocular_social_ranging/utils/torch_utils.py create mode 100644 yolov5_Monocular_social_ranging/val.py diff --git a/ultralytics-main/.github/ISSUE_TEMPLATE/config.yml b/ultralytics-main/.github/ISSUE_TEMPLATE/config.yml deleted file mode 100644 index 9018a62..0000000 --- a/ultralytics-main/.github/ISSUE_TEMPLATE/config.yml +++ /dev/null @@ -1,11 +0,0 @@ -blank_issues_enabled: true -contact_links: - - name: 📄 Docs - url: https://docs.ultralytics.com/ - about: Full Ultralytics YOLOv8 Documentation - - name: 💬 Forum - url: https://community.ultralytics.com/ - about: Ask on Ultralytics Community Forum - - name: 🎧 Discord - url: https://ultralytics.com/discord - about: Ask on Ultralytics Discord diff --git a/ultralytics-main/.github/workflows/ci.yaml b/ultralytics-main/.github/workflows/ci.yaml deleted file mode 100644 index 4eadc3b..0000000 --- a/ultralytics-main/.github/workflows/ci.yaml +++ /dev/null @@ -1,288 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLO Continuous Integration (CI) GitHub Actions tests - -name: Ultralytics CI - -on: - push: - branches: [main] - paths-ignore: - - "docs/**" - - "mkdocs.yml" - pull_request: - branches: [main] - paths-ignore: - - "docs/**" - schedule: - - cron: "0 0 * * *" # runs at 00:00 UTC every day - workflow_dispatch: - inputs: - hub: - description: "Run HUB" - default: false - type: boolean - benchmarks: - description: "Run Benchmarks" - default: false - type: boolean - tests: - description: "Run Tests" - default: false - type: boolean - gpu: - description: "Run GPU" - default: false - type: boolean - conda: - description: "Run Conda" - default: false - type: boolean - -jobs: - HUB: - if: github.repository == 'ultralytics/ultralytics' && (github.event_name == 'schedule' || github.event_name == 'push' || (github.event_name == 'workflow_dispatch' && github.event.inputs.hub == 'true')) - runs-on: ${{ matrix.os }} - strategy: - fail-fast: false - matrix: - os: [ubuntu-latest] - python-version: ["3.11"] - steps: - - uses: actions/checkout@v4 - - uses: actions/setup-python@v5 - with: - python-version: ${{ matrix.python-version }} - cache: "pip" # caching pip dependencies - - name: Install requirements - shell: bash # for Windows compatibility - run: | - python -m pip install --upgrade pip wheel - pip install -e . --extra-index-url https://download.pytorch.org/whl/cpu - - name: Check environment - run: | - yolo checks - pip list - - name: Test HUB training - shell: python - env: - API_KEY: ${{ secrets.ULTRALYTICS_HUB_API_KEY }} - MODEL_ID: ${{ secrets.ULTRALYTICS_HUB_MODEL_ID }} - run: | - import os - from ultralytics import YOLO, hub - api_key, model_id = os.environ['API_KEY'], os.environ['MODEL_ID'] - hub.login(api_key) - hub.reset_model(model_id) - model = YOLO('https://hub.ultralytics.com/models/' + model_id) - model.train() - - name: Test HUB inference API - shell: python - env: - API_KEY: ${{ secrets.ULTRALYTICS_HUB_API_KEY }} - MODEL_ID: ${{ secrets.ULTRALYTICS_HUB_MODEL_ID }} - run: | - import os - import requests - import json - api_key, model_id = os.environ['API_KEY'], os.environ['MODEL_ID'] - url = f"https://api.ultralytics.com/v1/predict/{model_id}" - headers = {"x-api-key": api_key} - data = {"size": 320, "confidence": 0.25, "iou": 0.45} - with open("ultralytics/assets/zidane.jpg", "rb") as f: - response = requests.post(url, headers=headers, data=data, files={"image": f}) - assert response.status_code == 200, f'Status code {response.status_code}, Reason {response.reason}' - print(json.dumps(response.json(), indent=2)) - - Benchmarks: - if: github.event_name != 'workflow_dispatch' || github.event.inputs.benchmarks == 'true' - runs-on: ${{ matrix.os }} - strategy: - fail-fast: false - matrix: - os: [ubuntu-latest, macos-14] - python-version: ["3.11"] - model: [yolov8n] - steps: - - uses: actions/checkout@v4 - - uses: actions/setup-python@v5 - with: - python-version: ${{ matrix.python-version }} - cache: "pip" # caching pip dependencies - - name: Install requirements - shell: bash # for Windows compatibility - run: | - python -m pip install --upgrade pip wheel - pip install -e ".[export]" "coverage[toml]" --extra-index-url https://download.pytorch.org/whl/cpu - # yolo export format=tflite imgsz=32 || true - - name: Check environment - run: | - yolo checks - pip list - - name: Benchmark YOLOWorld DetectionModel - shell: bash - run: coverage run -a --source=ultralytics -m ultralytics.cfg.__init__ benchmark model='path with spaces/yolov8s-worldv2.pt' imgsz=160 verbose=0.318 - - name: Benchmark SegmentationModel - shell: bash - run: coverage run -a --source=ultralytics -m ultralytics.cfg.__init__ benchmark model='path with spaces/${{ matrix.model }}-seg.pt' imgsz=160 verbose=0.281 - - name: Benchmark ClassificationModel - shell: bash - run: coverage run -a --source=ultralytics -m ultralytics.cfg.__init__ benchmark model='path with spaces/${{ matrix.model }}-cls.pt' imgsz=160 verbose=0.166 - - name: Benchmark PoseModel - shell: bash - run: coverage run -a --source=ultralytics -m ultralytics.cfg.__init__ benchmark model='path with spaces/${{ matrix.model }}-pose.pt' imgsz=160 verbose=0.183 - - name: Benchmark OBBModel - shell: bash - run: coverage run -a --source=ultralytics -m ultralytics.cfg.__init__ benchmark model='path with spaces/${{ matrix.model }}-obb.pt' imgsz=160 verbose=0.472 - - name: Merge Coverage Reports - run: | - coverage xml -o coverage-benchmarks.xml - - name: Upload Coverage Reports to CodeCov - if: github.repository == 'ultralytics/ultralytics' - uses: codecov/codecov-action@v4 - with: - flags: Benchmarks - env: - CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }} - - name: Benchmark Summary - run: | - cat benchmarks.log - echo "$(cat benchmarks.log)" >> $GITHUB_STEP_SUMMARY - - Tests: - if: github.event_name != 'workflow_dispatch' || github.event.inputs.tests == 'true' - timeout-minutes: 60 - runs-on: ${{ matrix.os }} - strategy: - fail-fast: false - matrix: - os: [ubuntu-latest, macos-14] - python-version: ["3.11"] - torch: [latest] - include: - - os: ubuntu-latest - python-version: "3.8" # torch 1.8.0 requires python >=3.6, <=3.8 - torch: "1.8.0" # min torch version CI https://pypi.org/project/torchvision/ - steps: - - uses: actions/checkout@v4 - - uses: actions/setup-python@v5 - with: - python-version: ${{ matrix.python-version }} - cache: "pip" # caching pip dependencies - - name: Install requirements - shell: bash # for Windows compatibility - run: | - # CoreML must be installed before export due to protobuf error from AutoInstall - python -m pip install --upgrade pip wheel - torch="" - if [ "${{ matrix.torch }}" == "1.8.0" ]; then - torch="torch==1.8.0 torchvision==0.9.0" - fi - pip install -e . $torch pytest-cov "coremltools>=7.0; platform_system != 'Windows' and python_version <= '3.11'" --extra-index-url https://download.pytorch.org/whl/cpu - - name: Check environment - run: | - yolo checks - pip list - - name: Pytest tests - shell: bash # for Windows compatibility - run: | - slow="" - if [[ "${{ github.event_name }}" == "schedule" ]] || [[ "${{ github.event_name }}" == "workflow_dispatch" ]]; then - pip install mlflow pycocotools 'ray[tune]' - slow="--slow" - fi - pytest $slow --cov=ultralytics/ --cov-report xml tests/ - - name: Upload Coverage Reports to CodeCov - if: github.repository == 'ultralytics/ultralytics' # && matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11' - uses: codecov/codecov-action@v4 - with: - flags: Tests - env: - CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }} - - GPU: - if: github.repository == 'ultralytics/ultralytics' && (github.event_name != 'workflow_dispatch' || github.event.inputs.gpu == 'true') - timeout-minutes: 60 - runs-on: gpu-latest - steps: - - uses: actions/checkout@v4 - - name: Install requirements - run: pip install -e . - - name: Check environment - run: | - yolo checks - pip list - - name: Pytest tests - run: pytest --cov=ultralytics/ --cov-report xml tests/test_cuda.py - - name: Upload Coverage Reports to CodeCov - uses: codecov/codecov-action@v4 - with: - flags: GPU - env: - CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }} - - Conda: - if: github.repository == 'ultralytics/ultralytics' && (github.event_name == 'schedule_disabled' || github.event.inputs.conda == 'true') - runs-on: ${{ matrix.os }} - strategy: - fail-fast: false - matrix: - os: [ubuntu-latest] - python-version: ["3.11"] - defaults: - run: - shell: bash -el {0} - steps: - - uses: conda-incubator/setup-miniconda@v3 - with: - python-version: ${{ matrix.python-version }} - mamba-version: "*" - channels: conda-forge,defaults - channel-priority: true - activate-environment: anaconda-client-env - - name: Install Libmamba - run: | - conda config --set solver libmamba - - name: Install Ultralytics package from conda-forge - run: | - conda install -c pytorch -c conda-forge pytorch torchvision ultralytics openvino - - name: Install pip packages - run: | - # CoreML must be installed before export due to protobuf error from AutoInstall - pip install pytest "coremltools>=7.0; platform_system != 'Windows' and python_version <= '3.11'" - - name: Check environment - run: | - conda list - - name: Test CLI - run: | - yolo predict model=yolov8n.pt imgsz=320 - yolo train model=yolov8n.pt data=coco8.yaml epochs=1 imgsz=32 - yolo val model=yolov8n.pt data=coco8.yaml imgsz=32 - yolo export model=yolov8n.pt format=torchscript imgsz=160 - - name: Test Python - run: | - python -c " - from ultralytics import YOLO - model = YOLO('yolov8n.pt') - results = model.train(data='coco8.yaml', epochs=3, imgsz=160) - results = model.val(imgsz=160) - results = model.predict(imgsz=160) - results = model.export(format='onnx', imgsz=160) - " - - name: PyTest - run: | - git clone https://github.com/ultralytics/ultralytics - pytest ultralytics/tests - - Summary: - runs-on: ubuntu-latest - needs: [HUB, Benchmarks, Tests, GPU, Conda] # Add job names that you want to check for failure - if: always() # This ensures the job runs even if previous jobs fail - steps: - - name: Check for failure and notify - if: (needs.HUB.result == 'failure' || needs.Benchmarks.result == 'failure' || needs.Tests.result == 'failure' || needs.GPU.result == 'failure' || needs.Conda.result == 'failure') && github.repository == 'ultralytics/ultralytics' && (github.event_name == 'schedule' || github.event_name == 'push') - uses: slackapi/slack-github-action@v1.25.0 - with: - payload: | - {"text": " GitHub Actions error for ${{ github.workflow }} ❌\n\n\n*Repository:* https://github.com/${{ github.repository }}\n*Action:* https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}\n*Author:* ${{ github.actor }}\n*Event:* ${{ github.event_name }}\n"} - env: - SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL_YOLO }} diff --git a/ultralytics-main/.github/workflows/cla.yml b/ultralytics-main/.github/workflows/cla.yml deleted file mode 100644 index a11ee19..0000000 --- a/ultralytics-main/.github/workflows/cla.yml +++ /dev/null @@ -1,37 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -name: CLA Assistant -on: - issue_comment: - types: - - created - pull_request_target: - types: - - reopened - - opened - - synchronize - -jobs: - CLA: - if: github.repository == 'ultralytics/ultralytics' - runs-on: ubuntu-latest - steps: - - name: CLA Assistant - if: (github.event.comment.body == 'recheck' || github.event.comment.body == 'I have read the CLA Document and I sign the CLA') || github.event_name == 'pull_request_target' - uses: contributor-assistant/github-action@v2.3.1 - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} - # must be repository secret token - PERSONAL_ACCESS_TOKEN: ${{ secrets.PERSONAL_ACCESS_TOKEN }} - with: - path-to-signatures: "signatures/version1/cla.json" - path-to-document: "https://docs.ultralytics.com/help/CLA" # CLA document - # branch should not be protected - branch: "main" - allowlist: dependabot[bot],github-actions,[pre-commit*,pre-commit*,bot* - - remote-organization-name: ultralytics - remote-repository-name: cla - custom-pr-sign-comment: "I have read the CLA Document and I sign the CLA" - custom-allsigned-prcomment: All Contributors have signed the CLA. ✅ - #custom-notsigned-prcomment: 'pull request comment with Introductory message to ask new contributors to sign' diff --git a/ultralytics-main/.github/workflows/codeql.yaml b/ultralytics-main/.github/workflows/codeql.yaml deleted file mode 100644 index e6e3e85..0000000 --- a/ultralytics-main/.github/workflows/codeql.yaml +++ /dev/null @@ -1,42 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -name: "CodeQL" - -on: - schedule: - - cron: "0 0 1 * *" - workflow_dispatch: - -jobs: - analyze: - name: Analyze - runs-on: ${{ 'ubuntu-latest' }} - permissions: - actions: read - contents: read - security-events: write - - strategy: - fail-fast: false - matrix: - language: ["python"] - # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ] - - steps: - - name: Checkout repository - uses: actions/checkout@v4 - - # Initializes the CodeQL tools for scanning. - - name: Initialize CodeQL - uses: github/codeql-action/init@v3 - with: - languages: ${{ matrix.language }} - # If you wish to specify custom queries, you can do so here or in a config file. - # By default, queries listed here will override any specified in a config file. - # Prefix the list here with "+" to use these queries and those in the config file. - # queries: security-extended,security-and-quality - - - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v3 - with: - category: "/language:${{matrix.language}}" diff --git a/ultralytics-main/.github/workflows/docker.yaml b/ultralytics-main/.github/workflows/docker.yaml deleted file mode 100644 index afd2a66..0000000 --- a/ultralytics-main/.github/workflows/docker.yaml +++ /dev/null @@ -1,159 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# Builds ultralytics/ultralytics:latest images on DockerHub https://hub.docker.com/r/ultralytics - -name: Publish Docker Images - -on: - push: - branches: [main] - paths-ignore: - - "docs/**" - - "mkdocs.yml" - workflow_dispatch: - inputs: - Dockerfile: - type: boolean - description: Use Dockerfile - default: true - Dockerfile-cpu: - type: boolean - description: Use Dockerfile-cpu - Dockerfile-arm64: - type: boolean - description: Use Dockerfile-arm64 - Dockerfile-jetson: - type: boolean - description: Use Dockerfile-jetson - Dockerfile-python: - type: boolean - description: Use Dockerfile-python - Dockerfile-conda: - type: boolean - description: Use Dockerfile-conda - push: - type: boolean - description: Push images to Docker Hub - default: true - -jobs: - docker: - if: github.repository == 'ultralytics/ultralytics' - name: Push - runs-on: ubuntu-latest - strategy: - fail-fast: false - max-parallel: 6 - matrix: - include: - - dockerfile: "Dockerfile" - tags: "latest" - platforms: "linux/amd64" - - dockerfile: "Dockerfile-cpu" - tags: "latest-cpu" - platforms: "linux/amd64" - - dockerfile: "Dockerfile-arm64" - tags: "latest-arm64" - platforms: "linux/arm64" - - dockerfile: "Dockerfile-jetson" - tags: "latest-jetson" - platforms: "linux/arm64" - - dockerfile: "Dockerfile-python" - tags: "latest-python" - platforms: "linux/amd64" - # - dockerfile: "Dockerfile-conda" - # tags: "latest-conda" - # platforms: "linux/amd64" - steps: - - name: Checkout repo - uses: actions/checkout@v4 - with: - fetch-depth: 0 # copy full .git directory to access full git history in Docker images - - - name: Set up QEMU - uses: docker/setup-qemu-action@v3 - - - name: Set up Docker Buildx - uses: docker/setup-buildx-action@v3 - - - name: Login to Docker Hub - uses: docker/login-action@v3 - with: - username: ${{ secrets.DOCKERHUB_USERNAME }} - password: ${{ secrets.DOCKERHUB_TOKEN }} - - - name: Retrieve Ultralytics version - id: get_version - run: | - VERSION=$(grep "^__version__ =" ultralytics/__init__.py | awk -F'"' '{print $2}') - echo "Retrieved Ultralytics version: $VERSION" - echo "version=$VERSION" >> $GITHUB_OUTPUT - - VERSION_TAG=$(echo "${{ matrix.tags }}" | sed "s/latest/${VERSION}/") - echo "Intended version tag: $VERSION_TAG" - echo "version_tag=$VERSION_TAG" >> $GITHUB_OUTPUT - - - name: Check if version tag exists on DockerHub - id: check_tag - run: | - RESPONSE=$(curl -s https://hub.docker.com/v2/repositories/ultralytics/ultralytics/tags/$VERSION_TAG) - MESSAGE=$(echo $RESPONSE | jq -r '.message') - if [[ "$MESSAGE" == "null" ]]; then - echo "Tag $VERSION_TAG already exists on DockerHub." - echo "exists=true" >> $GITHUB_OUTPUT - elif [[ "$MESSAGE" == *"404"* ]]; then - echo "Tag $VERSION_TAG does not exist on DockerHub." - echo "exists=false" >> $GITHUB_OUTPUT - else - echo "Unexpected response from DockerHub. Please check manually." - echo "exists=false" >> $GITHUB_OUTPUT - fi - env: - VERSION_TAG: ${{ steps.get_version.outputs.version_tag }} - - - name: Build Image - if: github.event_name == 'push' || github.event.inputs[matrix.dockerfile] == 'true' - uses: nick-invision/retry@v3 - with: - timeout_minutes: 60 - retry_wait_seconds: 30 - max_attempts: 2 # retry once - command: | - docker build \ - --platform ${{ matrix.platforms }} \ - -f docker/${{ matrix.dockerfile }} \ - -t ultralytics/ultralytics:${{ matrix.tags }} \ - -t ultralytics/ultralytics:${{ steps.get_version.outputs.version_tag }} \ - . - - - name: Run Tests - if: (github.event_name == 'push' || github.event.inputs[matrix.dockerfile] == 'true') && matrix.platforms == 'linux/amd64' && matrix.dockerfile != 'Dockerfile-conda' # arm64 images not supported on GitHub CI runners - run: docker run ultralytics/ultralytics:${{ matrix.tags }} /bin/bash -c "pip install pytest && pytest tests" - - - name: Run Benchmarks - # WARNING: Dockerfile (GPU) error on TF.js export 'module 'numpy' has no attribute 'object'. - if: (github.event_name == 'push' || github.event.inputs[matrix.dockerfile] == 'true') && matrix.platforms == 'linux/amd64' && matrix.dockerfile != 'Dockerfile' && matrix.dockerfile != 'Dockerfile-conda' # arm64 images not supported on GitHub CI runners - run: docker run ultralytics/ultralytics:${{ matrix.tags }} yolo benchmark model=yolov8n.pt imgsz=160 verbose=0.318 - - - name: Push Docker Image with Ultralytics version tag - if: (github.event_name == 'push' || (github.event.inputs[matrix.dockerfile] == 'true' && github.event.inputs.push == 'true')) && steps.check_tag.outputs.exists == 'false' && matrix.dockerfile != 'Dockerfile-conda' - run: | - docker push ultralytics/ultralytics:${{ steps.get_version.outputs.version_tag }} - - - name: Push Docker Image with latest tag - if: github.event_name == 'push' || (github.event.inputs[matrix.dockerfile] == 'true' && github.event.inputs.push == 'true') - run: | - docker push ultralytics/ultralytics:${{ matrix.tags }} - if [[ "${{ matrix.tags }}" == "latest" ]]; then - t=ultralytics/ultralytics:latest-runner - docker build -f docker/Dockerfile-runner -t $t . - docker push $t - fi - - - name: Notify on failure - if: github.event_name == 'push' && failure() # do not notify on cancelled() as cancelling is performed by hand - uses: slackapi/slack-github-action@v1.25.0 - with: - payload: | - {"text": " GitHub Actions error for ${{ github.workflow }} ❌\n\n\n*Repository:* https://github.com/${{ github.repository }}\n*Action:* https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}\n*Author:* ${{ github.actor }}\n*Event:* ${{ github.event_name }}\n"} - env: - SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL_YOLO }} diff --git a/ultralytics-main/.github/workflows/format.yml b/ultralytics-main/.github/workflows/format.yml deleted file mode 100644 index 470d4f3..0000000 --- a/ultralytics-main/.github/workflows/format.yml +++ /dev/null @@ -1,28 +0,0 @@ -# Ultralytics 🚀 - AGPL-3.0 license -# Ultralytics Actions https://github.com/ultralytics/actions -# This workflow automatically formats code and documentation in PRs to official Ultralytics standards - -name: Ultralytics Actions - -on: - push: - branches: [main] - pull_request_target: - branches: [main] - types: [opened, closed, synchronize] - -jobs: - format: - runs-on: ubuntu-latest - steps: - - name: Run Ultralytics Formatting - uses: ultralytics/actions@main - with: - token: ${{ secrets.GITHUB_TOKEN }} # automatically generated, do not modify - python: true # format Python code and docstrings - markdown: true # format Markdown and YAML - spelling: true # check spelling - links: false # check broken links - summary: true # print PR summary with GPT4 (requires 'openai_api_key' or 'openai_azure_api_key' and 'openai_azure_endpoint') - openai_azure_api_key: ${{ secrets.OPENAI_AZURE_API_KEY }} - openai_azure_endpoint: ${{ secrets.OPENAI_AZURE_ENDPOINT }} diff --git a/ultralytics-main/.github/workflows/greetings.yml b/ultralytics-main/.github/workflows/greetings.yml deleted file mode 100644 index 00e0f9d..0000000 --- a/ultralytics-main/.github/workflows/greetings.yml +++ /dev/null @@ -1,58 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -name: Greetings - -on: - pull_request_target: - types: [opened] - issues: - types: [opened] - -jobs: - greeting: - runs-on: ubuntu-latest - steps: - - uses: actions/first-interaction@v1 - with: - repo-token: ${{ secrets.GITHUB_TOKEN }} - pr-message: | - 👋 Hello @${{ github.actor }}, thank you for submitting an Ultralytics YOLOv8 🚀 PR! To allow your work to be integrated as seamlessly as possible, we advise you to: - - - ✅ Verify your PR is **up-to-date** with `ultralytics/ultralytics` `main` branch. If your PR is behind you can update your code by clicking the 'Update branch' button or by running `git pull` and `git merge main` locally. - - ✅ Verify all YOLOv8 Continuous Integration (CI) **checks are passing**. - - ✅ Update YOLOv8 [Docs](https://docs.ultralytics.com) for any new or updated features. - - ✅ Reduce changes to the absolute **minimum** required for your bug fix or feature addition. _"It is not daily increase but daily decrease, hack away the unessential. The closer to the source, the less wastage there is."_ — Bruce Lee - - See our [Contributing Guide](https://docs.ultralytics.com/help/contributing) for details and let us know if you have any questions! - - issue-message: | - 👋 Hello @${{ github.actor }}, thank you for your interest in Ultralytics YOLOv8 🚀! We recommend a visit to the [Docs](https://docs.ultralytics.com) for new users where you can find many [Python](https://docs.ultralytics.com/usage/python/) and [CLI](https://docs.ultralytics.com/usage/cli/) usage examples and where many of the most common questions may already be answered. - - If this is a 🐛 Bug Report, please provide a [minimum reproducible example](https://docs.ultralytics.com/help/minimum_reproducible_example/) to help us debug it. - - If this is a custom training ❓ Question, please provide as much information as possible, including dataset image examples and training logs, and verify you are following our [Tips for Best Training Results](https://docs.ultralytics.com/yolov5/tutorials/tips_for_best_training_results/). - - Join the vibrant [Ultralytics Discord](https://ultralytics.com/discord) 🎧 community for real-time conversations and collaborations. This platform offers a perfect space to inquire, showcase your work, and connect with fellow Ultralytics users. - - ## Install - - Pip install the `ultralytics` package including all [requirements](https://github.com/ultralytics/ultralytics/blob/main/pyproject.toml) in a [**Python>=3.8**](https://www.python.org/) environment with [**PyTorch>=1.8**](https://pytorch.org/get-started/locally/). - - ```bash - pip install ultralytics - ``` - - ## Environments - - YOLOv8 may be run in any of the following up-to-date verified environments (with all dependencies including [CUDA](https://developer.nvidia.com/cuda)/[CUDNN](https://developer.nvidia.com/cudnn), [Python](https://www.python.org/) and [PyTorch](https://pytorch.org/) preinstalled): - - - **Notebooks** with free GPU: Run on Gradient Open In Colab Open In Kaggle - - **Google Cloud** Deep Learning VM. See [GCP Quickstart Guide](https://docs.ultralytics.com/yolov5/environments/google_cloud_quickstart_tutorial/) - - **Amazon** Deep Learning AMI. See [AWS Quickstart Guide](https://docs.ultralytics.com/yolov5/environments/aws_quickstart_tutorial/) - - **Docker Image**. See [Docker Quickstart Guide](https://docs.ultralytics.com/yolov5/environments/docker_image_quickstart_tutorial/) Docker Pulls - - ## Status - - Ultralytics CI - - If this badge is green, all [Ultralytics CI](https://github.com/ultralytics/ultralytics/actions/workflows/ci.yaml?query=event%3Aschedule) tests are currently passing. CI tests verify correct operation of all YOLOv8 [Modes](https://docs.ultralytics.com/modes/) and [Tasks](https://docs.ultralytics.com/tasks/) on macOS, Windows, and Ubuntu every 24 hours and on every commit. diff --git a/ultralytics-main/.github/workflows/links.yml b/ultralytics-main/.github/workflows/links.yml deleted file mode 100644 index 73542b3..0000000 --- a/ultralytics-main/.github/workflows/links.yml +++ /dev/null @@ -1,90 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# Continuous Integration (CI) GitHub Actions tests broken link checker using https://github.com/lycheeverse/lychee -# Ignores the following status codes to reduce false positives: -# - 403(OpenVINO, 'forbidden') -# - 429(Instagram, 'too many requests') -# - 500(Zenodo, 'cached') -# - 502(Zenodo, 'bad gateway') -# - 999(LinkedIn, 'unknown status code') - -name: Check Broken links - -on: - workflow_dispatch: - schedule: - - cron: "0 0 * * *" # runs at 00:00 UTC every day - -jobs: - Links: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v4 - - - name: Download and install lychee - run: | - LYCHEE_URL=$(curl -s https://api.github.com/repos/lycheeverse/lychee/releases/latest | grep "browser_download_url" | grep "x86_64-unknown-linux-gnu.tar.gz" | cut -d '"' -f 4) - curl -L $LYCHEE_URL -o lychee.tar.gz - tar xzf lychee.tar.gz - sudo mv lychee /usr/local/bin - - - name: Test Markdown and HTML links with retry - uses: nick-invision/retry@v3 - with: - timeout_minutes: 5 - retry_wait_seconds: 60 - max_attempts: 3 - command: | - lychee \ - --scheme https \ - --timeout 60 \ - --insecure \ - --accept 403,429,500,502,999 \ - --exclude-all-private \ - --exclude 'https?://(www\.)?(linkedin\.com|twitter\.com|instagram\.com|kaggle\.com|fonts\.gstatic\.com|url\.com)' \ - --exclude-path docs/zh \ - --exclude-path docs/es \ - --exclude-path docs/ru \ - --exclude-path docs/pt \ - --exclude-path docs/fr \ - --exclude-path docs/de \ - --exclude-path docs/ja \ - --exclude-path docs/ko \ - --exclude-path docs/hi \ - --exclude-path docs/ar \ - --github-token ${{ secrets.GITHUB_TOKEN }} \ - './**/*.md' \ - './**/*.html' - - - name: Test Markdown, HTML, YAML, Python and Notebook links with retry - if: github.event_name == 'workflow_dispatch' - uses: nick-invision/retry@v3 - with: - timeout_minutes: 5 - retry_wait_seconds: 60 - max_attempts: 3 - command: | - lychee \ - --scheme https \ - --timeout 60 \ - --insecure \ - --accept 429,999 \ - --exclude-all-private \ - --exclude 'https?://(www\.)?(linkedin\.com|twitter\.com|instagram\.com|kaggle\.com|fonts\.gstatic\.com|url\.com)' \ - --exclude-path '**/ci.yaml' \ - --exclude-path docs/zh \ - --exclude-path docs/es \ - --exclude-path docs/ru \ - --exclude-path docs/pt \ - --exclude-path docs/fr \ - --exclude-path docs/de \ - --exclude-path docs/ja \ - --exclude-path docs/ko \ - --exclude-path docs/hi \ - --exclude-path docs/ar \ - --github-token ${{ secrets.GITHUB_TOKEN }} \ - './**/*.md' \ - './**/*.html' \ - './**/*.yml' \ - './**/*.yaml' \ - './**/*.py' \ - './**/*.ipynb' diff --git a/ultralytics-main/.github/workflows/publish.yml b/ultralytics-main/.github/workflows/publish.yml deleted file mode 100644 index ca2980f..0000000 --- a/ultralytics-main/.github/workflows/publish.yml +++ /dev/null @@ -1,113 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# Publish pip package to PyPI https://pypi.org/project/ultralytics/ and Docs to https://docs.ultralytics.com - -name: Publish to PyPI and Deploy Docs - -on: - push: - branches: [main] - workflow_dispatch: - inputs: - pypi: - type: boolean - description: Publish to PyPI - docs: - type: boolean - description: Deploy Docs - -jobs: - publish: - if: github.repository == 'ultralytics/ultralytics' && github.actor == 'glenn-jocher' - name: Publish - runs-on: ubuntu-latest - steps: - - name: Checkout code - uses: actions/checkout@v4 - with: - fetch-depth: "0" # pulls all commits (needed correct last updated dates in Docs) - - name: Set up Python environment - uses: actions/setup-python@v5 - with: - python-version: "3.11" - cache: "pip" # caching pip dependencies - - name: Install dependencies - run: | - python -m pip install --upgrade pip wheel build twine - pip install -e ".[dev]" --extra-index-url https://download.pytorch.org/whl/cpu - - name: Check PyPI version - shell: python - run: | - import os - import ultralytics - from ultralytics.utils.checks import check_latest_pypi_version - - v_local = tuple(map(int, ultralytics.__version__.split('.'))) - v_pypi = tuple(map(int, check_latest_pypi_version().split('.'))) - print(f'Local version is {v_local}') - print(f'PyPI version is {v_pypi}') - d = [a - b for a, b in zip(v_local, v_pypi)] # diff - increment = (d[0] == d[1] == 0) and (0 < d[2] < 3) # only publish if patch version increments by 1 or 2 - os.system(f'echo "increment={increment}" >> $GITHUB_OUTPUT') - os.system(f'echo "version={ultralytics.__version__}" >> $GITHUB_OUTPUT') - if increment: - print('Local version is higher than PyPI version. Publishing new version to PyPI ✅.') - id: check_pypi - - name: Publish to PyPI - continue-on-error: true - if: (github.event_name == 'push' || github.event.inputs.pypi == 'true') && steps.check_pypi.outputs.increment == 'True' - env: - PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }} - run: | - python -m build - python -m twine upload dist/* -u __token__ -p $PYPI_TOKEN - - name: Deploy Docs - continue-on-error: true - if: (github.event_name == 'push' || github.event.inputs.docs == 'true') && github.repository == 'ultralytics/ultralytics' && github.actor == 'glenn-jocher' - env: - PERSONAL_ACCESS_TOKEN: ${{ secrets.PERSONAL_ACCESS_TOKEN }} - INDEXNOW_KEY: ${{ secrets.INDEXNOW_KEY_DOCS }} - run: | - export JUPYTER_PLATFORM_DIRS=1 - python docs/build_docs.py - git config --global user.name "Glenn Jocher" - git config --global user.email "glenn.jocher@ultralytics.com" - git clone https://github.com/ultralytics/docs.git docs-repo - cd docs-repo - git checkout gh-pages || git checkout -b gh-pages - rm -rf * - cp -R ../site/* . - echo "$INDEXNOW_KEY" > "$INDEXNOW_KEY.txt" - git add . - LATEST_HASH=$(git rev-parse --short=7 HEAD) - git commit -m "Update Docs for 'ultralytics ${{ steps.check_pypi.outputs.version }} - $LATEST_HASH'" - git push https://$PERSONAL_ACCESS_TOKEN@github.com/ultralytics/docs.git gh-pages - - name: Extract PR Details - run: | - if [ "${{ github.event_name }}" = "pull_request" ]; then - PR_JSON=$(curl -s -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" https://api.github.com/repos/${{ github.repository }}/pulls/${{ github.event.pull_request.number }}) - PR_NUMBER=${{ github.event.pull_request.number }} - PR_TITLE=$(echo $PR_JSON | jq -r '.title') - else - COMMIT_SHA=${{ github.event.after }} - PR_JSON=$(curl -s -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" "https://api.github.com/search/issues?q=repo:${{ github.repository }}+is:pr+is:merged+sha:$COMMIT_SHA") - PR_NUMBER=$(echo $PR_JSON | jq -r '.items[0].number') - PR_TITLE=$(echo $PR_JSON | jq -r '.items[0].title') - fi - echo "PR_NUMBER=$PR_NUMBER" >> $GITHUB_ENV - echo "PR_TITLE=$PR_TITLE" >> $GITHUB_ENV - - name: Notify on Slack (Success) - if: success() && github.event_name == 'push' && steps.check_pypi.outputs.increment == 'True' - uses: slackapi/slack-github-action@v1.25.0 - with: - payload: | - {"text": " GitHub Actions success for ${{ github.workflow }} ✅\n\n\n*Repository:* https://github.com/${{ github.repository }}\n*Action:* https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}\n*Author:* ${{ github.actor }}\n*Event:* NEW 'ultralytics ${{ steps.check_pypi.outputs.version }}' pip package published 😃\n*Job Status:* ${{ job.status }}\n*Pull Request:* ${{ env.PR_TITLE }}\n"} - env: - SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL_YOLO }} - - name: Notify on Slack (Failure) - if: failure() - uses: slackapi/slack-github-action@v1.25.0 - with: - payload: | - {"text": " GitHub Actions error for ${{ github.workflow }} ❌\n\n\n*Repository:* https://github.com/${{ github.repository }}\n*Action:* https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}\n*Author:* ${{ github.actor }}\n*Event:* ${{ github.event_name }}\n*Job Status:* ${{ job.status }}\n*Pull Request:* ${{ env.PR_TITLE }}\n"} - env: - SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL_YOLO }} diff --git a/ultralytics-main/.github/workflows/stale.yml b/ultralytics-main/.github/workflows/stale.yml deleted file mode 100644 index dd85035..0000000 --- a/ultralytics-main/.github/workflows/stale.yml +++ /dev/null @@ -1,47 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -name: Close stale issues -on: - schedule: - - cron: "0 0 * * *" # Runs at 00:00 UTC every day - -jobs: - stale: - runs-on: ubuntu-latest - steps: - - uses: actions/stale@v9 - with: - repo-token: ${{ secrets.GITHUB_TOKEN }} - - stale-issue-message: | - 👋 Hello there! We wanted to give you a friendly reminder that this issue has not had any recent activity and may be closed soon, but don't worry - you can always reopen it if needed. If you still have any questions or concerns, please feel free to let us know how we can help. - - For additional resources and information, please see the links below: - - - **Docs**: https://docs.ultralytics.com - - **HUB**: https://hub.ultralytics.com - - **Community**: https://community.ultralytics.com - - Feel free to inform us of any other **issues** you discover or **feature requests** that come to mind in the future. Pull Requests (PRs) are also always welcomed! - - Thank you for your contributions to YOLO 🚀 and Vision AI ⭐ - - stale-pr-message: | - 👋 Hello there! We wanted to let you know that we've decided to close this pull request due to inactivity. We appreciate the effort you put into contributing to our project, but unfortunately, not all contributions are suitable or aligned with our product roadmap. - - We hope you understand our decision, and please don't let it discourage you from contributing to open source projects in the future. We value all of our community members and their contributions, and we encourage you to keep exploring new projects and ways to get involved. - - For additional resources and information, please see the links below: - - - **Docs**: https://docs.ultralytics.com - - **HUB**: https://hub.ultralytics.com - - **Community**: https://community.ultralytics.com - - Thank you for your contributions to YOLO 🚀 and Vision AI ⭐ - - days-before-issue-stale: 30 - days-before-issue-close: 10 - days-before-pr-stale: 90 - days-before-pr-close: 30 - exempt-issue-labels: "documentation,tutorial,TODO" - operations-per-run: 300 # The maximum number of operations per run, used to control rate limiting. diff --git a/ultralytics-main/.gitignore b/ultralytics-main/.gitignore deleted file mode 100644 index 0854267..0000000 --- a/ultralytics-main/.gitignore +++ /dev/null @@ -1,166 +0,0 @@ -# Byte-compiled / optimized / DLL files -__pycache__/ -*.py[cod] -*$py.class - -# C extensions -*.so - -# Distribution / packaging -.Python -build/ -develop-eggs/ -dist/ -downloads/ -eggs/ -.eggs/ -lib/ -lib64/ -parts/ -sdist/ -var/ -wheels/ -pip-wheel-metadata/ -share/python-wheels/ -*.egg-info/ -.installed.cfg -*.egg -MANIFEST - -# PyInstaller -# Usually these files are written by a python script from a template -# before PyInstaller builds the exe, so as to inject date/other info into it. -*.manifest -*.spec - -# Installer logs -pip-log.txt -pip-delete-this-directory.txt - -# Unit test / coverage reports -htmlcov/ -.tox/ -.nox/ -.coverage -.coverage.* -.cache -nosetests.xml -coverage.xml -*.cover -*.py,cover -.hypothesis/ -.pytest_cache/ -mlruns/ - -# Translations -*.mo -*.pot - -# Django stuff: -*.log -local_settings.py -db.sqlite3 -db.sqlite3-journal - -# Flask stuff: -instance/ -.webassets-cache - -# Scrapy stuff: -.scrapy - -# Sphinx documentation -docs/_build/ - -# PyBuilder -target/ - -# Jupyter Notebook -.ipynb_checkpoints - -# IPython -profile_default/ -ipython_config.py - -# Profiling -*.pclprof - -# pyenv -.python-version - -# pipenv -# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control. -# However, in case of collaboration, if having platform-specific dependencies or dependencies -# having no cross-platform support, pipenv may install dependencies that don't work, or not -# install all needed dependencies. -#Pipfile.lock - -# PEP 582; used by e.g. github.com/David-OConnor/pyflow -__pypackages__/ - -# Celery stuff -celerybeat-schedule -celerybeat.pid - -# SageMath parsed files -*.sage.py - -# Environments -.env -.venv -.idea -env/ -venv/ -ENV/ -env.bak/ -venv.bak/ - -# Spyder project settings -.spyderproject -.spyproject - -# VSCode project settings -.vscode/ - -# Rope project settings -.ropeproject - -# mkdocs documentation -/site -mkdocs_github_authors.yaml - -# mypy -.mypy_cache/ -.dmypy.json -dmypy.json - -# Pyre type checker -.pyre/ - -# datasets and projects -datasets/ -runs/ -wandb/ -tests/ -.DS_Store - -# Neural Network weights ----------------------------------------------------------------------------------------------- -weights/ -*.weights -*.pt -*.pb -*.onnx -*.engine -*.mlmodel -*.mlpackage -*.torchscript -*.tflite -*.h5 -*_saved_model/ -*_web_model/ -*_openvino_model/ -*_paddle_model/ -pnnx* - -# Autogenerated files for tests -/ultralytics/assets/ diff --git a/ultralytics-main/.pre-commit-config.yaml b/ultralytics-main/.pre-commit-config.yaml deleted file mode 100644 index 03461f1..0000000 --- a/ultralytics-main/.pre-commit-config.yaml +++ /dev/null @@ -1,86 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# Pre-commit hooks. For more information see https://github.com/pre-commit/pre-commit-hooks/blob/main/README.md -# Optionally remove from local hooks with 'rm .git/hooks/pre-commit' - -# Define bot property if installed via https://github.com/marketplace/pre-commit-ci -ci: - autofix_prs: true - autoupdate_commit_msg: "[pre-commit.ci] pre-commit suggestions" - autoupdate_schedule: monthly - submodules: true - -# Exclude directories (optional) -# exclude: 'docs/' - -# Define repos to run -repos: - - repo: https://github.com/pre-commit/pre-commit-hooks - rev: v4.5.0 - hooks: - - id: end-of-file-fixer - - id: trailing-whitespace - - id: check-case-conflict - # - id: check-yaml - - id: check-docstring-first - - id: detect-private-key - - - repo: https://github.com/asottile/pyupgrade - rev: v3.15.0 - hooks: - - id: pyupgrade - name: Upgrade code - - - repo: https://github.com/astral-sh/ruff-pre-commit - rev: v0.1.11 - hooks: - - id: ruff - args: [--fix] - - - repo: https://github.com/executablebooks/mdformat - rev: 0.7.17 - hooks: - - id: mdformat - name: MD formatting - additional_dependencies: - - mdformat-gfm - - mdformat-frontmatter - - mdformat-mkdocs - args: - - --wrap=no - - --number - exclude: 'docs/.*\.md' - # exclude: "README.md|README.zh-CN.md|CONTRIBUTING.md" - - - repo: https://github.com/codespell-project/codespell - rev: v2.2.6 - hooks: - - id: codespell - exclude: "docs/de|docs/fr|docs/pt|docs/es|docs/mkdocs_de.yml" - args: - - --ignore-words-list=crate,nd,ned,strack,dota,ane,segway,fo,gool,winn,commend,bloc,nam,afterall - - - repo: https://github.com/hadialqattan/pycln - rev: v2.4.0 - hooks: - - id: pycln - args: [--all] -# -# - repo: https://github.com/PyCQA/docformatter -# rev: v1.7.5 -# hooks: -# - id: docformatter - -# - repo: https://github.com/asottile/yesqa -# rev: v1.4.0 -# hooks: -# - id: yesqa - -# - repo: https://github.com/asottile/dead -# rev: v1.5.0 -# hooks: -# - id: dead - -# - repo: https://github.com/ultralytics/pre-commit -# rev: bd60a414f80a53fb8f593d3bfed4701fc47e4b23 -# hooks: -# - id: capitalize-comments diff --git a/ultralytics-main/Author_advice.txt b/ultralytics-main/Author_advice.txt deleted file mode 100644 index 22b6129..0000000 --- a/ultralytics-main/Author_advice.txt +++ /dev/null @@ -1,7 +0,0 @@ - -# 双目测距运行yolov8-stereo.py文件即可 - -# 测量速度运行stereo-speed.py文件 - - -具体操作步骤见播客主页：https://blog.csdn.net/qq_45077760 \ No newline at end of file diff --git a/ultralytics-main/CITATION.cff b/ultralytics-main/CITATION.cff deleted file mode 100644 index bee0abe..0000000 --- a/ultralytics-main/CITATION.cff +++ /dev/null @@ -1,26 +0,0 @@ -# This CITATION.cff file was generated with https://bit.ly/cffinit - -cff-version: 1.2.0 -title: Ultralytics YOLO -message: >- - If you use this software, please cite it using the - metadata from this file. -type: software -authors: - - given-names: Glenn - family-names: Jocher - affiliation: Ultralytics - orcid: 'https://orcid.org/0000-0001-5950-6979' - - given-names: Ayush - family-names: Chaurasia - affiliation: Ultralytics - orcid: 'https://orcid.org/0000-0002-7603-6750' - - family-names: Qiu - given-names: Jing - affiliation: Ultralytics - orcid: 'https://orcid.org/0000-0003-3783-7069' -repository-code: 'https://github.com/ultralytics/ultralytics' -url: 'https://ultralytics.com' -license: AGPL-3.0 -version: 8.0.0 -date-released: '2023-01-10' diff --git a/ultralytics-main/Instance Segmentation-camera.py b/ultralytics-main/Instance Segmentation-camera.py deleted file mode 100644 index 5cc4e88..0000000 --- a/ultralytics-main/Instance Segmentation-camera.py +++ /dev/null @@ -1,37 +0,0 @@ -import cv2 -from ultralytics import YOLO -from ultralytics.utils.plotting import Annotator, colors - -model = YOLO("yolov8n-seg.pt") # segmentation model -names = model.model.names -cap = cv2.VideoCapture(0) -w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - -out = cv2.VideoWriter('instance-segmentation.avi', cv2.VideoWriter_fourcc(*'MJPG'), fps, (w, h)) - -while True: - ret, im0 = cap.read() - if not ret: - print("Video frame is empty or video processing has been successfully completed.") - break - - results = model.predict(im0) - annotator = Annotator(im0, line_width=2) - - if results[0].masks is not None: - clss = results[0].boxes.cls.cpu().tolist() - masks = results[0].masks.xy - for mask, cls in zip(masks, clss): - annotator.seg_bbox(mask=mask, - mask_color=colors(int(cls), True), - det_label=names[int(cls)]) - - out.write(im0) - cv2.imshow("instance-segmentation", im0) - - if cv2.waitKey(1) & 0xFF == ord('q'): - break - -out.release() -cap.release() -cv2.destroyAllWindows() \ No newline at end of file diff --git a/ultralytics-main/Instance Segmentation-pic-video.py b/ultralytics-main/Instance Segmentation-pic-video.py deleted file mode 100644 index 8aa8b1e..0000000 --- a/ultralytics-main/Instance Segmentation-pic-video.py +++ /dev/null @@ -1,66 +0,0 @@ -from ultralytics import YOLO -import cv2 -import os -from ultralytics.utils.plotting import Annotator, colors -if __name__ == '__main__': -# 实例分割检测文件夹里所有图片视频（实例分割和掩码分割不同）： - model = YOLO('yolov8n-seg.pt') - names = model.model.names - input_folder = 'ultralytics/assets' # 输入文件夹 - output_folder = 'runs/detect/test' # 输出文件夹 - - if not os.path.exists(output_folder): - os.makedirs(output_folder) - - # 获取输入文件夹中所有文件的文件名 - all_files = [f for f in os.listdir(input_folder)] - - for file_name in all_files: - file_path = os.path.join(input_folder, file_name) - if file_name.endswith('.jpg') or file_name.endswith('.png'): - # 处理图片 - im0 = cv2.imread(file_path) - results = model.predict(im0) - annotator = Annotator(im0, line_width=2) - - if results[0].masks is not None: - clss = results[0].boxes.cls.cpu().tolist() - masks = results[0].masks.xy - for mask, cls in zip(masks, clss): - annotator.seg_bbox(mask=mask, - mask_color=colors(int(cls), True), - det_label=names[int(cls)]) - - output_path = os.path.join(output_folder, file_name) - cv2.imwrite(output_path, im0) - - elif file_name.endswith('.mp4') or file_name.endswith('.avi'): - # 处理视频 - cap = cv2.VideoCapture(file_path) - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - out = cv2.VideoWriter(os.path.join(output_folder, file_name + '_segmented.avi'), cv2.VideoWriter_fourcc(*'MJPG'), - fps, (w, h)) - - while True: - ret, im0 = cap.read() - if not ret: - print(f"视频 {file_name} 处理完成") - break - - results = model.predict(im0) - annotator = Annotator(im0, line_width=2) - - if results[0].masks is not None: - clss = results[0].boxes.cls.cpu().tolist() - masks = results[0].masks.xy - for mask, cls in zip(masks, clss): - annotator.seg_bbox(mask=mask, - mask_color=colors(int(cls), True), - det_label=names[int(cls)]) - - out.write(im0) - cv2.imshow("instance-segmentation", im0) - - out.release() - cap.release() diff --git a/ultralytics-main/Instance Segmentation-track-camera.py b/ultralytics-main/Instance Segmentation-track-camera.py deleted file mode 100644 index 61b18ac..0000000 --- a/ultralytics-main/Instance Segmentation-track-camera.py +++ /dev/null @@ -1,42 +0,0 @@ -import cv2 -from ultralytics import YOLO -from ultralytics.utils.plotting import Annotator, colors - -from collections import defaultdict - -track_history = defaultdict(lambda: []) - -model = YOLO("yolov8n-seg.pt") # segmentation model -cap = cv2.VideoCapture(0) -w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - -out = cv2.VideoWriter('instance-segmentation-object-tracking.avi', cv2.VideoWriter_fourcc(*'MJPG'), fps, (w, h)) - -while True: - ret, im0 = cap.read() - if not ret: - print("Video frame is empty or video processing has been successfully completed.") - break - - annotator = Annotator(im0, line_width=2) - - results = model.track(im0, persist=True) - - if results[0].boxes.id is not None and results[0].masks is not None: - masks = results[0].masks.xy - track_ids = results[0].boxes.id.int().cpu().tolist() - - for mask, track_id in zip(masks, track_ids): - annotator.seg_bbox(mask=mask, - mask_color=colors(track_id, True), - track_label=str(track_id)) - - out.write(im0) - cv2.imshow("instance-segmentation-object-tracking", im0) - - if cv2.waitKey(1) & 0xFF == ord('q'): - break - -out.release() -cap.release() -cv2.destroyAllWindows() \ No newline at end of file diff --git a/ultralytics-main/Instance Segmentation-track-pic-video.py b/ultralytics-main/Instance Segmentation-track-pic-video.py deleted file mode 100644 index ceaef95..0000000 --- a/ultralytics-main/Instance Segmentation-track-pic-video.py +++ /dev/null @@ -1,67 +0,0 @@ -from ultralytics import YOLO -import cv2 -import os -from ultralytics.utils.plotting import Annotator, colors -from collections import defaultdict -if __name__ == '__main__': -# 实例分割检测文件夹里所有图片视频（实例分割和掩码分割不同）： - model = YOLO('yolov8n-seg.pt') - names = model.model.names - input_folder = 'ultralytics/assets' # 输入文件夹 - output_folder = 'runs/detect/test1' # 输出文件夹 - - if not os.path.exists(output_folder): - os.makedirs(output_folder) - - # 获取输入文件夹中所有文件的文件名 - all_files = [f for f in os.listdir(input_folder)] - - for file_name in all_files: - file_path = os.path.join(input_folder, file_name) - if file_name.endswith('.jpg') or file_name.endswith('.png'): - # 处理图片 - im0 = cv2.imread(file_path) - results = model.track(im0) - annotator = Annotator(im0, line_width=2) - - if results[0].boxes.id is not None and results[0].masks is not None: - masks = results[0].masks.xy - track_ids = results[0].boxes.id.int().cpu().tolist() - for mask, track_id in zip(masks, track_ids): - annotator.seg_bbox(mask=mask, - mask_color=colors(track_id, True), - track_label=str(track_id)) - - output_path = os.path.join(output_folder, file_name) - cv2.imwrite(output_path, im0) - - elif file_name.endswith('.mp4') or file_name.endswith('.avi'): - # 处理视频 - cap = cv2.VideoCapture(file_path) - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - out = cv2.VideoWriter(os.path.join(output_folder, file_name + '_segmented.avi'), cv2.VideoWriter_fourcc(*'MJPG'), - fps, (w, h)) - - while True: - ret, im0 = cap.read() - if not ret: - print(f"视频 {file_name} 处理完成") - break - - results = model.track(im0) - annotator = Annotator(im0, line_width=2) - - if results[0].boxes.id is not None and results[0].masks is not None: - masks = results[0].masks.xy - track_ids = results[0].boxes.id.int().cpu().tolist() - for mask, track_id in zip(masks, track_ids): - annotator.seg_bbox(mask=mask, - mask_color=colors(track_id, True), - track_label=str(track_id)) - - out.write(im0) - cv2.imshow("instance-segmentation", im0) - - out.release() - cap.release() diff --git a/ultralytics-main/dataset/coco128/images/train2017/image_BS1_456_00_42_15.jpg b/ultralytics-main/dataset/coco128/images/train2017/image_BS1_456_00_42_15.jpg deleted file mode 100644 index bef0dcb50ef31f3d60abeed72fcc9e63f89c41cb..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 232956 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 E*~;{dAOHXW diff --git a/ultralytics-main/dataset/coco128/images/train2017/image_BS1_457_00_42_15.jpg b/ultralytics-main/dataset/coco128/images/train2017/image_BS1_457_00_42_15.jpg deleted file mode 100644 index 3de1ae955a9b224d8edee7086c9fbf1d22659d00..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 233217 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

lA zZVZp{Wux@qIgBToI8IsEF)$F1D0RsCX*Tf*)lNRdxkXGZP3Y2-#jC&Yy zG*whD>At9Hi+EJ|TyqkI>K3TfCCubeJfGM%#y2aUPMC!xEGn;710TkZh$zn&82>Tf z0K>Slp`w8Ir^i%06+aco84oLOBR(OyJP%=qyKVz>J>9U!~7#CR#qvPnbv%EiWBxms!NgW8pJ!8++wEFts#m`c&_#@+=1~hHxRC-7xr_YqQ#K^Du zxTNgaluWP1upUuR@Y%D0@o!1m7t>LF%z=F=0IqJ~tw>s6o=a1?yC0A#sNSKru2KCR zuV#~%(g!c@V^2u!^LqCgoYD#&Yw-cVY8zmi>(}9{>Ys>k1nVwRS}LSmYx4C`_($Li zlor-)hveb}uV0#E?0$H@P?krOJJHr6M{um2B+Kx8Eh}bfW(gJ^Rs|77Yoy^zR#O-k z>8$t75dlR{Kur4Xd^uD^3l)9;OWFJ3*_#^pi&d*)u zg~#b~CI6}Q8^)&}s8K1~RoJeOvB@;t*XyWYzsfJ6B$C~%qxAp#D4L{x;uMjFhb)hU zQB3_f1?&g3(vRzr!tybhmcIAh`Y?pu0rlz-AEQ4)xt!~tT<%1wwzV()E9%F@p&zcd zH`SI82Ybb_OwNua01tc4_NDFF7SY$*m6zr#{E2_`j5TF+8kZKC)pIm%V$<4Wd$ zlGmOYGR)iOr$5PQ3q9O8QC_tzwpjNX^SH&Gqe?L1*sA)2K6=E-HPQU>W?Ps`Pq;=O z(k^|I5RuHWJg-@)OWrtQXjpxrmcU7l79X%PG|@|;-Nw=MJitgOBWN+q|V%r%_*AK$o0d)%WLAeUU;x)L*ojY9uP>I zZDyKGP$EQm1kLL%8Bk-q)j&?uu0dF_8px!3U$I>S{?A1US#39T8N4`{g`{l1C)__- zuc0L%P|^>DyzI9;(&Sy4Z3cnF=jtyUM+T9!S#MT;-W>jjAVV!i-H2j=!@WH1T;AOY z&jvkQLf|ep3{ntboVNaQ)kK|9n5fE4^Kl}ZpEcUx>8X=RI*GuW(gx6w|C}ww{j_sx_x`W zsQsygz#)Yu(Tl8&*GJ);>h~OmJaT0ZlLv?bG}R|=ch2$5rq)zrlZF_7Hro6aewFze z9W&9EFIDR6YQev=v?-~tg z#nIr)XT0(0iS-mVcuL}w6?=f2(kC15=*6ujlJfSMv$-bFvh%zvxB_)(GAVT~ZC4zh z-iU#7F|2pRfg8)`@YiCe&EK2$F9$@#iX9~#A0ju?<*L)i`n9y|pOZ(NjNGfN>e!DlzLs$uuXgtGZn&~b5XshMhyW}zQ|KqO7vd; z#f3%5dGBoBt!^*1I2?w;2HdOzyN3FD+?^kA+i;Z--35XZ%Jp!XxN<6tWub*smWf$DNt5;D%5K24>uRZ=ul zbch7s*Wu}V9so^+QsIN;lZ1&KLB0~PY&S}7Gq*Jf3TJC2Kh|;--V!M397qDlAkJ9y zjUa^m?o%(zDsD)X1vR-bl%UZJrM@+CEUWbnbYv{z6%MM4e&v2L{Us`G-MW{Qz;zrJ zxmgUQ#-j)}SiRRXyWMzMq4s>tpCOS1`SIb|Pv38uN5%OpKLAgqy;e;lOonV9$4{a; z=cu>>dodB9e|o>xW4xWR(-!bwz{-&B(A=8O`k5SS1gyTQVPUh=YAe$XmOVjB@^+;p zgI9>%nVz;Q#u^)0C<$PO@z%o?gLp@5oDq65C)bzz^GndfpNAaXVwOU>!|~H*)4T$Sd)>h8 zzBmA7w=2ClD`Hv=Q?^z(vF|xeI17Ikl^yIH_0#xmMw{fZ$>A0NWwMdRIvurzwE|Y{ zhn8K&3ZRq`seQpESE78;(@7vwb4or3{VdCnY5k4qo=;qIP^n753@U zG1ula*{xs;ia6nj0iF=(I+vp&X95g=A&(h-IP_TkoW@GGV?3&z>T?6}c`n}H5uI>r zhQ>8+PE%r|7pGj3jDNNnKlZ=p0-8v6ZsewYkp4rGgOV5lK)vq!efdMJ&G1;w8BK=y zf;PR*?i-lo5iVpJV0x8Nw>mBP#2qRR7QM|6N7akX4(~ZgRmmMFFx`KL@?J4d>I{v@ z`=^|Uty;+C3w8nAGESTKVZ(1oA?(=4WgbhyY*_Cbg98P=v4CJ5hEig-c*_E({|LZK zTKGwu0d)dHap6c?P`Ma)homZS@Md|&yGru+6qDnxa`|rltQ&_1(*Zp2CK)??3pjN7 z5R-@{{icp~99E2syO`jjLAb9I&x<)&0J|pkjaP0Y9n}saev!N>;b&od?I25h?v10= z#f~hh%52p%ju@xAsU%oVy%bC5G z-QE2tGl#e8$+W;>(ZxA*WDfsKEp~pC5)MHae43TLg-ZU9qVw>l>i^@oq9`kSy9!BG zvNLYTP7>MNtc>g0+jTF>ULl0I$93XS-(hy@ZSFet+lp58TJ+an8N>^B&LF z>s5vk1|O9#1_ixUrDj$0EVuV10!iO|@w`&Z-EAT1imD6`MGni$0kA*Pr_&m+vCZ z^w0WVjZMob!Drrl^YyCH19~h$2iJ%q8SG?7wX+##y}`}ROD$K7e{7Y{@fsK-G*&9p^1INNE&!Tj6F9B#T2s#sC~%a3rW@s}N@hK<39M2S|5wIE zD422GUtU+AJC;mYth=vNCet56Yjz1HQs!YSX)&A-GO#V` z?lAA95))h~f(`bd|J1P0(p~rtDA|zu{n;@()D9(cbxke-S{cA1x(y;!Sx(~baHeX8L zhcPAs^4sN}u|jC1SjUy%K-l3t7h}AW*=W7#M;z2u_cfa z!(f0TE9Vtr=3b~tv^I6~2o@Pgy2Cq_gUaUbjuoOehTiD!rE!{pG1abV@jvhH2tg?G zY}}MT`7`}zp?{fAng@yb9;be4&ZHU#2 zcL$@&OMN`3XSl6aY?c*PI-|nMYAC35PUB36?cL;rPylauOv>>S0bbXqci48)9yS1Q zA7Tzk*CK%3HpOe)jx5+U(}>EaE?%%S6E-iT%70mSuZ;E9{B7URc@*}l7ep)Stts4M zjTw0qoUlIpqS-t;=bcH~9dwwWT;Fg5;G8yeZNT&jt!3ys@;8N;b4?NXI6iagO8(3i zhw3^?T)z49C(gK2kwK4}v%%!w)e`rXs^p!YoDzd$f;^8PEvjj*>UU>b=XaNRv4^>! zuog=Uiq^^>@@8CQS?hh2u8>7qe4$E_0?8{?dcS*Jz~RXNiG}zogcM(Q)D5PoUDD8= z+?Y2|t81}-fAUB+-~-Q?emK{Y+nS?+N3kpQVxbCdm{`TfBH-6CTU@X8wuHjx+f3CB zNj8obsy(uQNc6y^tv{_-$rkOeUVwsO`0QGH$2nB4)lFPqI2^cBcG-`@%5CbZ8f(}k z)0sW;R;z2;(*~)Wzu6|_`;0!{BT(bK^v0#+yn~dz+$f_JnzJqP7W!8faizWa@q&rckAxES#98TH(aXgRl*z#MSWcf|Y(-M@HUu~V3Zm3H+VYZksQ zlVtRoqk2k&t(M&!(0c|~_}=8DgQ3TdoUirZR|paFzXrR3=TUG)59-l+P8JrYvxRU< zH{lE*A9wy&#oMu0zDWf2Hbs2RmBR|KN1!X;KV72Py6n>UJjXYS>$P$mFnIVzO3md_ zX9)Qqc?na8zaH@}Q$V4av-v+LG&Xj@z$Hc`_U6|drFV21uYvH8wHBeZ#GY7iluWvp zvMoPqUMzk}<>BH&R0mm39+!CB`_>lJN1-?AqM|I8)Vnt8Z&1y7N;?xk*Z6&f#??%Z z!g2X-q*hR@O%kM~FZ?aHsl7!h^9^P046YN4?L@>wf&_jt80xmJYcu<5%3DaDgNvaz zO~SQ7$DL^Ri;B4KN)s*~Ur|P}1G(joxV(In@16OQ#U^*3_UJqpQRHr-AJKZzw z(?(iyTLg+?^~tGX0rT3`slvq?bbo1l*O+}fQj+$bGeV?g(k@4bqqG2vNOz2_lRHPO zU9N7V{!)6U@)W`)J$uW~0m&UM0Hm*YdGJ+N1*LyxS^8Sju-g+o>VK$fgr3>fGP4$3 zs12i7Jp)o)?m^G>9M1g3_=bNlee&kbCCBz{L$p*r6b{QJY0J7D<==5~;Jpa{Ip|N` zP4&TgP^*VfEKP3)Lk8?wz@agIR*$`>7&yJl)TZ=Onf#mD+cQ z2VpfG2$sc*Cc-jnb7xnXsgBK{p0Urc#x6fy=4L^dj??lTbvD)r^5O@r^;*}-2m$BJ z>fKDmYBPm5cNi^e1cqspIaD3^Jd9ePSL_6>Y4l!ekT!du`Lg!=yR-Z+T>3;C7ZUEs zo;_&wy-16+@b*(+phRV+ve^dzq8)6FB(gTIr6ElJwX2U1pCIo^;0-+yy(`Q*E(r^- zJXye^MW7P_CT9C3Zl`=``b=O8`)3wi&T;KT&VKj)L1iQIDzclj=wMRZ`OCz0NSC6- zIwBp$+IFS12|Vsgf7$&`+1f{!s6p7DcfBIyS$`k1-r_bpKvYd`tQqH zg}a%CKL`01x2Y6HWo_=P^PH_!l}H6;OuCgQ6*>P_DWzBV5H`Xd|AUrPDVr8=q<9*p z>nV^aO<&CB74rOGHcb3qc_ppYJe16_vS4Iu0GgV{7M4Be)fjs9ONcI^buY*S`yMTw zR8*LqH|EKF+w|sbUiqleXPzWGK>7+wzAaKiHM-gdnh$jf&5$_OLcb8Bg+( z1q%s6O0zZR&s5spDti2L)PSXqVIcf`bQgX~5_XXMSz3r6`1XWrP znI`eu&u7tZkIVk;h@+Op<6Lb|&j>$I86Jj9=?qMd6zQLRH#zL}vp#!! zVaqlwX0BJ_>rGGEKs?wg;i{88t?KQKUJd;e56R=$6ba zz7ulOZL&K$q%dpM>{2$IQHQE4({)7$j6<);(_SGr`a*P>=|Z!UuaQAM z3rlmT*hUpcw*Re`pPF}?L++IQ@mUGKl=&scVl>fS4Kvep{kJ)dF7bmzZ`#N8aRjK# zr}HEV7Z12Adumno)5an>;kp<~v73Z9c>5n3x01#u=4!9%S#)k~@UMM!^=OGui-c}y z-b~E$Jgk^KOSmqP0)!$M>iTGfTi={7^|c_O71gW7 zX^N3sDNd;bu~X;z+L*0#$f{2Z##5f(>rn3o!FLiN>+c*aXsq*F62IP1*Dxt5f0nER z&9Y@0?emRR>#`6|ew=FLYbf+}H8CFP42gwMw{YR)yTP}BMZ^zF-7+ah_R(E=CQ|w? zs@TYQV_Lc-zXTbo2$HiD`Kw>doYP zS}z5UJYik;dCRlHtGmzAs-wef_}-pC!cdg$m?i~{HMf}mNLUH}Gtc}!)CO7VnNL+7 zxk$#E-gkO4{vfE=Fl-pZm?(OuAccDK*HPx#Pt&(A`L%*H9Lt*ldup1;4GlAy)m8h_ z$Qri;@&bQZxDGZo{p=`w9W8U|Tjc>I{nPPOQ~fA4i`#04E9UFB=td3-keC1HM3*HV zCbaBYKZWMv9R7W<$n^fBf(u6jPpO?poTrzSBK8CEuGAG1aTr;h*1no8(G8~cxdv;6 z9e8Jxb^#K0t85+p=5S_t^QcqB$G>Z-H+A^xb!1YX1Sr(1EI>`*K>S`Jk<$sx;_6a+ zpu&aJxKbM}DCAXjb7#fmJUZj;&7E2gEFlg1_Q5#3G(P8nehHn?JM|MN9jnM?e)ZOo-XUpoyNnK0{x7w7^Up=VJ1L*lLJ&Z_ju?Go!1Dhb&duF(F~ z>$o$ z4izOjM=4T z->b$xfUV_^qLEZ!2kM$gVp+_L&r&ZaKCQ;(q^^4+hF9p{_|`F}!FXJl%%}GtS`pp) zCEf*9y;JKrAtvH&VEWmP)iZ3urFX2bS^aH_Q!-E-`C_!3oAKPo=keZ24n?0*L*&?c?HtBPZvS?FmJ8L*6(t}L=*+q&PrT`JV|6c=CjlJ+Gi1GyRt zqCr}_0h;aF-c}HSiB@G?RDsEFwej7!fk|CMbFC%hAgzEZ)|nLu#yn&V^gF}Xi8F0o)X_mP^zEr*{|f*}@wjx~1N_g1j4#UcUI zs`&VSV%Q%XLE$;87v%lZhXvw8n@zIn=5aD<9cNYZZ+~|6z{Rd!Su6nzv~K%#BoJDL zx>LKP-f{5ogV`)W&Ne_KbsqLqL3H-<9)*qV0QE8bu#&GD;UwBWh#F=8y6Z}YU(_vF z`;PkPe53Q)mB_yR9kk)~tNQC|I3@OjUOS$D4IJ|XUuua*BK=Tw3dY6$HEV7OaQ@<*%De@9;N+`m zVYmJ1k&k}D6B@4L8KMv9TAp4Au~+w;v-tf1V~yfv))FJ&OjnN)Gt1A$%P@7=oJ3?H zp2&vow@rF5B}sjbYW?&HgBTFF)4KANYF*Z@g)O8LQxfFVNB7L5+UV8YS?2-1@~z9$ zXW5#^#VfChBmm*U5`kwD>44($A3F2H>2=BnA=!|fBDQPgdfl_kya#n=J_MtcxyzRm z_t>PrrRnj}Gb>Bn%N@^2>;N7CFt&RQr!I3|mct$q7#LOy`m)z_E-G9if5jVhnNMxG zDb6^dS(^NZv^Q=yJbEib_fwGdijsIoA4l5J&Q>ng_871JZ;XMUh&_m#=;28w!3`7_ zcDqMa);;=Wi+*mDlzt?1-yy3<-MYR34q~CSPZf6!`a*GR)B%fIYZ#h^YG7vXj$;@*Snr= zMRL|L>?A>FPRu*p>Fk8$MT?vQILBXBa{e5>?--+1>zT=NaQ{kdch-*`2rZfqTt73J z^_HKDXodw~CJ@&L=m@TEc>`!j&OM0gnXYkH}o8v z9*-u+zGN>bY_zK0gZ_shRC>AtsAepsv&?FQQeFM5?Y3k)OLp$87@4|8!6<|0VURs2J# zm_ZlQ#r#Ty+LY1JmSSU)zG_KBhR#FV z$_S$PAOE^DYB6KL;ZCl0Nbxy^eN(+jMQY9i{L|v3y6ncg9;0UM4xSCGiO!dc(&nK< zjz45IAN3BYeV_B5W2;@;AEUt)^ppc_hfgaF@lwd~-$6kBl4mJ5HiiCnAlFdnuBXtp z*j@ZNMy4B(d<23%5P5ahxGYVqz>!i=&|@wou7z8}RxXbnZiV%-ai#k6-6T;=CouM{ zG1p)<&Lr>$IEU^wRwyM5WIoA1=|c^+)$(y%nd{he`+A^ctIIM{e;8)$HjES^vN(ge z+wI$9=TQVkmesA$wK2{eB|+>pI-vkoftPt()q*9Yn7bIZ*CZ^fa#DJ+w|J@Bg;{qt zxN8#w5-~qct5O|Cpi8~iJ`4SqoXpm&%F03@Z^B#r#Tu9z{$iRylIfG*q}KX70<-Uu z$8cT!DA{SL;-P08onILvPT1#2kc$$V*VX{-_{;ll2!}c{|-ExK~oBTW+NxtP3j| zD;n~lAK0YZdO7i2*Vmfr2e3cT-;)i}7W ztnfvoX?@NzWgcS%V_MFgxy?BHFJ^i76sny)7c8e&dE@##6uyLsLv^3(~4u` zz;frIOoyTYAR6ouLecx@XomcL@EB7;*SKSHt%1mHz6#-@fh<;*k8$T8l`!8q!4UTMQ z5`&8)i-!+g(SjeDjlIU?m1HEnmPbgRVA7^I8~L+#hK}g=0{0 z1&wSp)4a5e>wT&TC-nH=dbPfVdrM>drqro*sfqK8^F)!T0q@#vbcy4v7DkNX?`B@C zHp39(J=c3c0AoK7CmniJep{;VFE{^$k5+|(T zO=B~*t{@LD(dETadR1E^qj&#!Gs(37{S9(iO?z0wI*Bb?-!E?Q>&nwH8iF^zl_k1h z=4chW{jtTs>-Hx=o1acrUZinrQ6ARw^WMN_e%G)|Qq{-U`}19EKfU?mNBKhvTTht; zDudB55xv~5QAYQ+`AY=2Pz-RUjqceE>D}F`nA8P}2@~wbH3LpS`@`7QB+D zWoi8pT*n;bb@TeinqK>s?ct{Y>b=v-Q8D~uNGBIdFQ}Hes&H?atEy?L#S|x?H7Sf1 zt1hemX`*4jJ@~0v&~a8?=0;K+ZUpg5CQ|a6T({vFcTVo0M47h7mMrJZU_4vppx(UK zS}l?l3>~92akgTYX31nKMEjNRlnP|RDh<2d7jNo+{`xdkR_?B5?+sS{L614^XHPSy z3lHliAtRi}JqE+hhQ)dIg{WDA_yVz$TLA~zZ@%KOBKBNDx*B|d@@;t!28uq)F3+_s z9#iP@$ul2m(b&HA*!07XjdgjbDv?4F17Y*Ga*OBYotC5!A%NE)Olm>jtxQb1pimDl zikyiZn+U$R7fkPJ<$cA(Cgmz+r!)7umbs>UvOzBr%(Gz90p-@xq}xfh@85#{=5Kr= zxd@v5f$We2Lo4S}&WwQRBMbZ~V2>%ZgJ79~>tQT4EUME@lJX*ymA;Rlw->4(-gLzB z*^iCXyQ}j~m&XlzG3J5;8r4Lk(HqMsjM<+P=Qnw3@|G3=(6d?zVZcm)S3fP2Vns75 z)e8S3>2zXkYHYAsutC?Ob9UdTE4d8*=HY}-kp3b|oYEuvm5B`f7t3V%UF0Ddb9jzyl8py7z8eK%ey zMc|KcUF+#xkVvZsK+%H?nLn%-jn3QEfLUhyyne#ADwV|p}v1=L6sQM z0(C2Z8(z1;jjx^(C}za=;r8DYGEcKxq|>FvJMJpbp?g~Qz9r~Z53nb3+++Q@A!LkJ z#nuz=wyxgNHPFGI1g}xtzsR4cG|)+k>RVczsjB&R@KCP=@KCq*V9e9j?~&f$JQ_Js z3X+<9k*vjUe=_y&aW5UJ`IhZMCE$)^X%0NSz9pH?6_yq#G!O5B=a!G%i+{xmD_<~> z6;{}${7?%@@qOx%pa$Q*dI6MX{BWr&JGc#SYdcm_5+}!%#i9kmkTvsvG=jPEJ`IKff}46>(fdC>+}hg$%zM&)G`Up!2@DV33m7w4ZY|;*SAO-z1AW?Jb#{36 zdn@*%eO*x!f%!U#{~86H2NDCRNlZXIP-^BvbqXnJ%a4e4`JMEC8Vc|XMGUaai}JZ8 zzk0B8oz5B%Cb?#Pgka zY^A=wdlDBjdYuVpaR4S=IkLDmU~0J1@oC4*H>;q_|MJu9!)W5DD7R2F-^saIYR271 z3Nji4 z@e3Mg5dr_3=}D^0!d)Js$~U6Su$A+D2G^0mub6QTs2JMI<{fW@0xqnJK5=60t_{G+zqHL=iTVZ8Mk?OdW^^{h{@w5AJMjMiCP$5G&= zB)yg}$|0GjnndQ&ry?rS;Q5QNp^of|Eln> zLwWuTzm{b~b0>ia_BIsm_B@99`UR@V9NN%*z~&yJ%_RFCB)W(~AvoY<*rWZ^^>!+P z)wHz?%jGL{(3Y}rZViJO>#DpluV2=EvTa$jD*=pKEZAWQsy@*ofy9(^=$l^)#(#~q z`DS9C?=o5=*Y|nknN?7I5+3_cKp=p7aPeS-8F}|1`tVGn`8aL*jFsDy=d-|{Go?M65Tc5n=mQ9Y^H!+o}FvI+|AaK zE&SbD3lYARWQl@^@;g?Sppx#e#>(w1BIN-Nj6ogT2Y{5@Z4G!Wk*z{WT3T~|&l7{% zxFM)dkdw%8IweDKhe;gKfDW~+CI%Kk^uk|USGRcN!ez$A6cjPkTt2NqFEbq)n%X~i z6n;I3@3v7`^h$o+0`@!d>f6#w1g?b~C8oBBt;4ZC?g!>`TAy~GrFL3!L~HTYR;w55 zi1XD@C7XQpE&GYjWO2)|yv%z0anW0ewjM9`9sUAG`>}=Gr(85vBt3H2_$jr>p~)b( zX`8odW#u4|Hx&07#=|7`qQvQ+xt zgSU^WU)Yk+ijO||mdZ2*m=iq0O($mgVAvGE$P$Vy`|0#JQJAa3X!k|hqi_HIBS~wU zJF;{DzOb<CC>Noy`#%po%6kvk~$?W8)$Wj5xxx9{pM_yTw_(gZb%I(OzG}!HJ6T8eji5V=N^?sGdfhfzf!2 zoOH&zTR7qwI$_~Wa8$S)<0CebZE(gmYEQT-xg^bCyJ)Vt zB6Ci1x%HB}P3*?U&Q&KZEx7^9{H(er%LByjJm?$pXL{$7TPN|}3_^?m!B&)DkZky( zwZnp9f53uXpKi(0Vke0WZSMFVi61XxRHsOJ9dGLO=t!i8)a(vWw~ocMlM-()z^x|R z?cwsphe~~`(Ty%E zc{Ocmhq_ckJ(vSFdEaYa1u@JvfjR3}J9+IDAa_)`j*=2_do|^wX!ak8N!5&016ieL z-eX-JlfsW=QPovE34T<50$oaSz?G~a)t-oAI)XzTuoEIeDuxkUlwHO$Ya32!CH62^ zSa&nyGuKemVcgM%PYD>{R6hc>d!m*#L}%FDEiYYg$GFeM8C=_i~XL8`XZuX@v@(wXT$8u)#3>M!(gXjXzGeFBJUF>xZ+NMhGr;J- zU3@o0HgrF#@2batQP3b+$(X04S8obT(!QG1PNj60I6FUkzyef5Y-*w@9wkb-`FJN7 zi%)phV9HP0a~0uE-O#u0;RaO#f3nRCMRc{#iA`Uno=kYQ1cE^Rh1=^a2f+04Ru$f7 z%`N)!;QIU{oCODY1G#IWl5b-2$LTj@IORbCS+Zhzv)26~@L(ea9m|H^0!z2_O5NCj zvb9*k4B&m%jt}2hBv*Hw?>u@NrzNpr_o!Y0K&6CECxO&6>`R~xZNH0jR)heXcO=)} zgZ%bTxUSpxIjgb9i)xk5Z#uCrcdI_%Q;C&)7Y3ns0Eq)?KrW<>*!;=aD{fE=9$kSC zGMNywd0ew2L+dVLCX#1c`$_#*_MlbGS@0HP^)b{6d>l9rz5{Os-VfE%B5oqHEgRO!2-9Dxot>hnl4 zhEo9oN9EOHf*`(m4H>&EgRjJX@3NYxU1CrHm_vs(^GB{2)9eb@iu8d`PnI?dzjWY6 z-D#Bjh5~ac3-Bp#ph$W=xi*93rd?A_{jnWiotCh8PQZ5NHSn0jL2Z!_zVCP{C$omDPO^9JNN=W&F8x)qh8k;6>7Rb! z6Cx2~?bYOf1fHB=ibIAek@(AZ&IY0)-wXO=j z?3D?uHcAa$-%ZL+i%I??#<~M2R@dC3B66SkyTUXMe1BT6r#+M;LB@jV)lzubIr0nsy zZ+N{zeIp41ot5ikrWRgOH(k4#t*p@Bm*`6Eab@8ngOd=%28&72?8mr^cb!)rC<#7?Ps{n?CO)j zjpXC1p=3P)kx@OfD`*F|5Eiu$K)<&M(6IT1D|y4~?+9_LIWs;7@06WOTmG^O0dUi3 z=3WA7MsP68{CZMP7Q~7AED+Uf`aDMk11}Z*uA?{ByPuKp7dau9vUG`TWt5PJng0Vn=+vCHoZIa8F4{G&O+rG)< ztmI@2A;FCmhyaV78v9BHrz)NDAvZTL#qIOH?Ks~Gn=|{`2D<(XHSp77HgLQ*dqG`( z_-5K-xPBVXR%0nfI59QRLx9AmtibnFQl}BI(hYg9&)>wf9WIh-s^Ia14~086Bt4EA z72g+96fUG=69_5!EBhneX!B{qQ9oCym;+0r7N5_&Ufe158_50_b`7K0Te0+BU(e48 zPDWcWutCD*x~VE334QLx*hJ&e9aA-AiAbHhM;hOHk!pBVOuTVzXsZ_9Xxd;qC zRnI{c{cG$ctrcptu5fxgQcL&2n!umfaC-34w!+=9KXVBiXR-$55CaX< zss}5++%*YnRDjQ|U(7(AQST?0HFND2@4AvE1UrY%)V*7vs=g;aR&G{gy_DS->*hTo zW*VzGq4J}PL?_Z{kz4swpW?Byg2zM&M(BLq1!IYd7H%dawBoD#udOiD35AK z5nHcssy~avB_N-n-TVrjxapf(LZ?Q8c%r-)i(7KCB}|M3G0m}_DllI*SXX=CZoFht zil0(J*q&A0yzR732;xwVFrs~#kn1Oq70l=*%k}>G94P7si`h)Hby857>HJq3Q8!*d zUc27?RvmZ#Va+;`X&#&#<{`GZd02kIw&D$=-EW;sS4Hzjju2znu00IQSLSw#)e2Eg z^c%^acE+hta4~TFJ6bMBgZMh9k|k+bP06hEr9QW%^%E)Kz{3*Rk;IS|4N=4nOx%{7 zc;&9KsWWF7^pLZE$Gdsy@$O2H$sY|Fo@n9ka_4eZNX{8avylZWK4a8-#~I}&sp@D$ zs(&{OVceZ1Z6)hZksE3Ww@5xPI9jI)cA@U8vm(U9~g+Wxm)wn}2x>>hdB%vcF63v#&-mp_$HV#}C%~)_$RS>*Cqk zB1DR+eiHnP5!@29LqP^pFXI9*)%$5My{>#8lnsvgGqEJ&kw)^$mb@IgAlVO?F z&^`s*N$%FYfmw}d{s!m}ihJ)!A!9|-&wWAOZX@sI^+cCh zKOd~b%jO(Q704a)5y`ze^VkA6X)ERZcEMFoxjrrlJw0YMjBz&W8I)6lwYHaMXIDi=6CS3&@fBWEt z({}ZqLXjxj{^vtCLwy-SzmkqQpNK{Inw>@CZcpJS^)faaA0O9#{M@J?^4uNaDyvBQ zGBlI-nP=cr3)2}h2>yfKWN!6ji^Rqcl^^VT`dRNtXn>RkabiCrdvAoO1o0nUob!*k zJRTLG+|;L z3xmO2oU+2E1sHg{?g_Kr6b~b}xEvQWn5#B~NR4q;VI5-Ox<%&BV>po67mHujg5kDt z)}Oh_UOyV!wt)2LkwKO2B~P5ZZk=+4ul9(#d4dE#gv)Xz1R75Qaiu|Pi8t{^V_ncn z;oqj64?gzixm*1@=wJ1~8z|_limyc_gP0tf-sdv%wW#3OQfZ!OUU=k8(-_uC)h1F^ zUFZ0e{+R(NNa9FBJ*#!np+`%cw%IQ??z3A z$ck5uw2lL3vL_S`l>8luF@Xoaba{UnELM?(zxko3w7vZE^WVuCUEa5BLw5dRU2Y-l z55r3a)<)w77)9~potsK?z#t;@Nz z*NEC?juQWtO4T+DQV%L~e6Eg*yQc{je9#t-k6s=7$bAcI1Z;$OyPu)r?V2W*bp>=L z2;#-hVQwF*NS&lcrj&E;ybCxR%#G7yeZypDq!)zO$EBZ1Vg)*ADRkFq!!HXP*Ztw* z?{fGv_tZ6~oNboHy$2_MUc6kuzP_iyiw^h`*D)F6UL**q{*Od4;fwWyiXZYI)Cv{& zefW5rpiUWHN!Lb<-pTLg*~Fx3l@Z$Rvy1i5o~-~;K1aKk>vrKC`wwk97LwzAw>i%O5uX=v}JCV{IOW0nx6j9*NQ*l;`z#u;bC4y*6QN zea~3r^6i>&F*rl<&;v7-MwsfWR9_48;lZ1qZu6`0geTn?xD~oaBqL5(iD413Ya(FP z*$QEPoN-L0&w;Xc*n_S`VO6#_cSCqNMM-wFeLT>PCn|TJ63^;p`#lQ6<4$3f4So^r zs~^s!5v)_j>$C?l9+-w49S@i-%?CGy6zv~)n&hWVU%KcLKf$*J;*2Z(4OTU}RwxMc z*z{lEn{W-B+J7Wxuq0*Vk3Sk5BV;uS5fWsk6vh1aNrtlX#s5Nk2|;{yd%ci2MoqSs>P9+7@zP3*(V^h~1~_GdLuv~KWh*cL*^x>dzDw?0n>Cu<=y zmR`v^wHb5V=LI?yAw8VAMN88p*vWi_Mps^Bu^#-#I?l>2_Uq54xKA=wvO}Ei`I#|d zc%D~P#mZ15W^947mtiNf*7x|Y-*$)gPN4nkLHAkQ>b9_W^WCAefl9TXwYbQhcD6tG z(jFAkp$P1tv;EAI4gQH-wSIUZS(C^BaUndxUtuFL#v!ArIGHt0iHKO{9qP|x_bu~2 zCh+@#L)Li<;D=zju_tL879;=k&EN+mJNg~=2UbQJ-AG#S>Oy;z*nvLwOXw*rsU-n~z17?3Q$!8co&7!` zlAH6p#9%wx1aR1Vdh^I4VqSB{>c*8C!3ztCwGEbE1upT}T7IWksUdvK?yb~Uo@Dy{ zcQ;bLuFG|hmj{f6pv9t}{5A0RdyXGjGgq!6j-DX|+CxQjPVHV~QD|+fb41JSItxyY ziT`|Cs$@0L@vv$DvypuE?(# ztuAPbb|vPT>5oNwY-zAhZY+QEgbua<)eYGhJ|4TVfX`9|u%b0E9p8M6vea~CM11w3 z%^#2GuAl1yT%TlD3B%%K-wdogf9@dh`u=0}7 z%z=nad)==K1bbU@M;;x(z^k0N{2xljLV-DAI4CAD0qj&6WhT>|2qNg4NTO)fOT6-( zGrb0V%w-y!HbNGAcldwg81{c`I8nA>Vs$(4!=7M#(O4Os*t0;q^>=@c*As^VP6q^; zHA}xY(2~M%n=9ok{di_cLn@OOBh80xh}TLRz?7ykl>0ueAUrV&*sZvc=@w#alLc!} zX}-Plxul6`!{A|8kBGmBGUJ$8Z_r#~2irTgsNX!oWg1>F$Ln7VN@9Rm@X5M?h13hD zqLpLG%FqIp82I8)69lV&p<0F*MKOY5pm~keqXW7tUjL>6A25x-x%!k3Esbh^S1|Ou zRsU8{o}U;02Gx0)gHMK$H1gjIw*H50fLBXc4zUl(igZEZ`DY@rkd8pbk)qhzN(M(6 z<{1&^l)gu#Ucgrwa$V_N!EEXUKA=M5CidTGy z&T|l@64)t+dxBu*6VwP-zdy2PukGZuAXZdSgSCPU?_8RjIzRBumb#ue^I=dEbWwsqmX zr>->k)x3Sa-ttnZe}UFaI}fUdCm#rO*arrHxBSQ5&_hBiF{oQUJ`ie)9?X(h7jtG$ zYrf3FKzN0bMdxlue{j1@f7Wx7L)-}Dj0!k?GG4Fa{De5&)EDY=2i*YD9VZS|)*9;z zho-4T0DY3E-S(r>X43kiLzSJG@1Vz$f12HI;t~tImO1befDI@6L0=4z5>g9gc~{-{zE#|;{_)$1qB6T$tEwEw0<3B(N#~@jWAlN14^g6@jn{4!}79ps&drQ97&%( zu@k7`>Iqh(u-O@pb6}jmK*ViiJ83m5(xQ;7Wgr?j6V8ix=M*P^De9J-1*y+?HwOjv z!zIX`?mpc*zFD=vHySn3eCsV$;Ll$IB!rT}$^+XU_{3LJ

J6#yDKw+J-F-A%WfX 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

YU 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 z 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%0A*n`W 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 d_$&K4e$f8_AA~m_489Is&1B@Pn$_|9 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

#($B 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 z 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 R%DC*xPB48(dLqQp|JmpG_=o@i diff --git a/ultralytics-main/dataset/coco128/images/train2017/image_BS1_459_00_42_15.jpg b/ultralytics-main/dataset/coco128/images/train2017/image_BS1_459_00_42_15.jpg deleted file mode 100644 index 92c7011e4be4165464d9e3f2c4df6a22bf85e3e0..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 233596 zcmbTdWmH>D)IS=Edx7Fw0;PC?V#Nv+FJ4?*oDkf#MTTY%@v@=EdmG&BGJ?dbz}Tm{Gio}v9$ z{%fE8S1{23YcVk}&@r$uv9SK9V&mdqVdG+BVd3E8;NtyPp1u*_;}QIK@!y~P@6>0Q z=;)Yu*jU*AGvxnM^VkC*!Ffi9-h+?bntp9VBOe-U-C&~k!gO$W_EeO|1B{e2Pjk9ORhBy zXA$_~8jOoaK}khT!}^NtH9N;!K_Oug(RZ>RFDa|8yH$xT3OrJ+S$9g zdw67?f)Y#k|$ix{@VlW|8Su_ z^Lnc2Bp8@4`LIZ(HL*XtkTLUr!+9Z-m|xqA3lz|TlYeoY#-m_)3uQ(82kn25{l5bi z{QnEt{|)T_;93C?prbu)9y$p?3Q)!a_TUU?>K|_>IDYOByQ`pnRX>ZUGI27V=jF1R z5d?i??c-P4eL2MxW5FiAm^OIlX$pF0KT#g|yA2#8H2hmh3JSEt-%1RY9Kz8;yXT1M zhHF$V%w4R%o4xW@WXc}Bns1q7$rR;l28bCI$_BqtW6@wd$racQ&?@w$KOdOQ)1K?X z_bxTa>s@FvtlF@-G7j(a@fF%ya|BW`(V@j`=>-KA^smEI8px7~fKR*eXZUnV>`RyBiO7*4ISFWMA)xO!?|ChC*p>G&?pFCJGyCsd@< z2TU1}dRGSoEk;xxBhWhm`sES4F%AE0qJKX7XzJLn#Tvi_?o8=|Q!S4GYxR{@Nn8-S z#|vw33&su|b2aIIO1BSz^M5zqJpzIwkWo{g5ERAm2(6ZxxW)=2vsAz%p!#`{wtvg8 zq+#yzC>vW8sw@5hkLTfeEs1g9cx^XJ=P1HdI5}kamii#u+(onZ5rAnrt1B0`e`TOG zoS-)-q3|(ixKwZm>4$CD+?e7a*4=b4hR1C>w#ps96d$q)|MUnTv440r@6U}uSG)6U zS#b|h%bXxET4KNX5fZP4MO;b^tb}`^C_+V-#32-4B(; z$O#C((<|P%s<}m>44a;y^dO!3uMul2fxmyJYuXUxa=u3cQnCFjt?k`f%nuxU1T;~` z2eNxp8n(gB{yhRp?K1-)-&xbdjJm0RFf7>VSe~U*eB?{BCi2`#qdGN790O^Uj;m>@ zlyvX8D0dN6t+jG>as?*)f4Z+~01I3}%wi=m;w)@-Wa>EcWnCC%sGhqVBdY^we+Kn_ z?6%=tmt=1=(LG!6)ZF{vuolL)hKDjjMnAENbD@joD9JWZ@;-rg<8T${X^#*N{3UN_ zcb#4;QHkCa-sFhgRBk$uVYF+K6MVM!^^jy_!1WQn^b5MsfIWKvpfRuP{8;H zd~G|_IBY+fb)8;#v7E+@4km|^bjsK^`Q>f`!@pg-4~Cne$RoCN3j=RGy9tl0d+X2t43b!iZ|_0?18OEM7H)sFR?x=xNloIy?e=_^Hr(HAlpEqEOc9u>COZ-1&du z`PSf!AMNpimYPfXpBosU`Zh;~vw^FUWbpQ)%*|k%d7&~Z5VoIZ%5!;u6Q2^jOKV_b ztQrGEH@+^_?(DYEUcaMLJyS#F^bsI%jjnbN39|n2mc?7#4~!@Ovw`{VkUTaUX2h7- zJ!fx_qk41@{sTKwesN&)*~4oCBP2v^nTubA)<^GZFd_r&tW7}Pw?#*x_4C-g7<4Y% zF9p|(UoO;Zq6w@m@J?3sd4-QZiXk8`&riN0imRO+_d{Z&TJOFi$g-PYMPj2-Dsn!i zXl)c+*wN!_GtOo^49F(peC-?^lhRq}d8VMlWsR3|vweAK^Ov`8b9HKKKRS@a)Snlb zs~&>-T=cOX>8CMI!qQ9=W7oD~nV}>A1s5-f_T=EsE)u8yhPk(%0+vojOL`5rLXD&FoelIy_U~~{B-`p zN^j>i?#W^4Pg)+bqO9wjJQWA0dx(r69SqbtwGb3)2G>}pm5)-#@m|!8quTZ)QBLmo zUcMx6$#onod0_F?dy>!**?sl%KBvP7^4AbCXC9(8z1CP$4LTdQ7Zr`1b9P;_6z5OV zdZQZnS^Dnd!&F;Mx?jZ#G0pm_U6h%2`>a2Hg^Bc+!b)`(ike@%9ih6cdB+oXbgFIm z#8E3PdW>(pb!zM(A{2Ufu3a{3k~@@gE{>PFOYU}AsDIyqqTR+{jVA!z z?&Yvnr9sWxwJZ#1y{PwD7+`Q<<_tXjI2pd$D@l=iq?U%2MoDy4pu76|ud=08V9wOX zOUP)Y)QZ!U+gwBOe8UujNe7vz{)Q2IAx6A)JWF8i<(xP1RR+?ad@Yu^FOZYes434S zNbq0U890c^3Z{?r>N|0O$W(Ns4cZum<%r(dXsMYjsnCDRk+Q+zl#Dnc?tcWV_Csk` zWFG;z@-2vUGsXsmCdPH<5ibtMNnF6UQ{a# zkrMSSu^Q+MyT6-Wk{p>dMC~tz0GJsm+0n1z(`o&(E$YYC;mo$Goeg&Ofdt*BO4$;J zbdezjv%F!0x^U_!iS!llT2(6$O>K>SjeyS8C1w%pooF~sSiWXMn^BNy)xN$1x%|ea z1o14|_K{VqkqJLm>zCg((_37YbaY7p-Y~&t8?URf(DwJ(Ckeh$NCns<07ZWEfV&I@ z%lWfG0{;j-Ff4Lm9a(r3o2^*1=p^)z^bU)#`o`pfYLISEuZxi<5pHxCNZ-_gU_7qf z3J`);2< zxXrV$^qv0nmXXZ1i)H#Hf+5y*#=uyHHP|!kkGQ4f8zQt`x{x?I?}z-S_4uFGb3dR7 zy;ZBd^YUk`YirCXXlv?3#+S&l@RVX2m^yz7nWMQ&nblK3pI*-0l=CirlKq7bxbvR* z)j>}2!Dr9-h5R*V)ESW^Mv^b?pLCEf-SkJE4>WM8V?TJe!CcK+aYmcwQK>(i@59>@zY1(s~38biHW(ZZy7a^x{03Zx4ay z>^-udIAwnmb4JVI+VS2T^arM^@3sTXV168N&Y5>lhaxbXVJ2bznzV?yE z?dgBc@0QCqOP=rB)Qn4z?mYOC1v6Fhz-f^ouhXtqApSM+oLRD(y&!P4`0> ztGx5`@(~VtXJXnVL=tGW@K@CKXy&Fq5mGdDiF8Z?5d{-8;^yqTQjzMPug}xXNu?3x zk!eV5_&Peu3jHhGc~-4+r{nu ziWjNB;@Mo*GUM@~J$z}*Dp6RKrlXQpfVANE+Dol|JDrs`E;=YL&^9ryeb@78NgBD& zZw>c42DciUWnZP7)bYP9>%p?l4(<&n{!JTo!MLI_U`hS?Ykciecs9oSu`UTB-DfM z4?F_UH~#YVZ5{Z=hkIDq?y+O`jZ+YLmah!l`00cqVcmbEh`MbEvHK_}G>i_lsoam6 zGv`K7Kb8&r!%damQ*Dttzj?<2v*-^bsGmWBoal$6E|v`(@&XFBMfY2@^7nA`^SF|B zUXK`m#l>p;44=>Gjud1h&k3Y0>S&H53^q#we5*s_de71}n5`%GQ>QO$w;2>Sv2{mGYI)#WiuhiNymhZVckQ zVHrp_L~>uQaPCy^l_^nIv`L%ajd_UXFQI>M!?h~49s$Rly4S9f79$u~!+s#E`_OBe zI(rHTW@n5i!eHa!aAS3h3w_8Xltq~BK5>|Q|H&-)&h`ihrPM>LU;Rv4H#k(kk0|rj zI{c&h7S~y^@#D=mnlG_rX}uQRsUpCsek%jxg2OvWot0D7KhL{zLf2ck%~#ftkMrWHPUYTlGq&lPxf0^( z@^>6Qb*~-)KOFA{zd3a`B=~x$m!hN)kgwbg>&on>%<~R}z2SR&0=#2bv~-S`J;QFf zErO9gg(z__gA*XAPYHy1Fk_W_5}>*OY6WYGm$P!I?e_DZxNQQnlMP_4WmC&FI^e2P zr$Nr>Odg{gv%W|+L{2H{mEn5Bg3R6u(~46r%k#0~XmV#C?RFp&gAV{<8eL*C{LaTk zmN}H(w4)G8W4poF(fCJ@-hTO{Smw_do9ay1R;!#f2QG$Xt}+8kugb{uAo?z)EA-d# z9>LA`5^BVWzFlfX&5shHkjYOS}!ThR(778jO{p;%p?lfssl)BaWW+b)_0N4kq?1qU_} z76gS=`QK0#?1Jm!m9j3bS@XgqE$&mA#v(CO&&oM+=UFZdi#^U6Ik~?~M8%Yd5$xqw z6R^E9FZ^|2e29#~?zj`mcm4G)b~^o~EWst+x$ZGrbBB|tQ_|;_ee??mQ98N#k@8$B z>LmThHHV#h!loq{Dx@G~$}grTTFe*^q^QTcNyfU~KFCeCYIOF%E=F9ZVa<9DADL)JnGN!&dbxZl3sY4aN~v{BT_ zwIaZpG5PvrVj{B7ydkp98nql{J$QTS1BXw_g3x*3^8GK37Fo;E@_%>DS)(#XO}z1igLbc^gc)1jv4%ei;-)=_D zL{OSY_U+Ti2O4BFyn8UypTaYU!rulnWzpKe`qOMdFxAfYzGV5EBz(JYWQJ$M>UWN? z_}Lp{3+4hpT3pLG1MV+2Q8EYtCRVCod}7&Pd4=+VPrK}F0b%(!S$BFty);3VQp?x9 zOQ+DB3oDB_*_!4mQc*!1@1 zIHK#BPd8L8xAE(OC=0yT1z-P9EvyE(byGC1OZ7|PcPMOgYoW0=#)WxF3^<5b>g)fK z(%?K3-lA@TU;jHUI26`|c~lS1TDtv?b9MWJ>bU2;xVzd!STzR+Svr01Vr}iEcp&X~ z#vim$|KSrG3SR^TI_HE5$MXsjFYkEIaAT{_$Rb51(`YPNnL^*P6adt`F|m~Py6S<( zEx7GY68Dsk00;j)w^xU9!ui{#oCwblI7Fr)8QN5c)k*ko0UvX+*iojTSuyE%yB_1= zhSCeN#qsqKrmP34X>k=;P;4M6+%XSkqM$n4s7kX9(`cM6QruzX`5ERp+U)8`%;W6K zH0UhJ)7Vlw%>$)dD<4ghp9^&^t9YX}xJ7KZmTBZyx#jqhq!LiP zEWPsVs}e)b$UUcx20Y+tUL%BH<8Pqu&o2wdS-Q_hybR?dSt6Ol)c#m%v_~bL^SC4_ zq-X6Vj{i!^xjzzutWDv|G#Vad8hQ$Je|B1`Q{|sLG$S```PI%{F7xX92y2>Z(zA%K zWBlGCR90L2@nv0Pfm5EojKL6p(YNrdO}^4u>VlE@z0Wa-RB>{uks;CQdoiPFK?t^y zEHr&=*eLgd>cE}51~FxHwn3lDvMhl%%?Jcu&nGLIf54bKY$TL&Ghj2~;Atm9LguHf{ZZx$qt z=t)TaMHkmg_ZLQp=W;j9JTMy{oDGBNe{?oC`~3KqCW@Uh2DnKbKW59#j&qgzJdDV- ziSAuVi?+V@x>#nEqQk`V@X2x-zm;b@PJZ&S__HA(AwLm}t0%k7GZ%JWhttwYi{#DA zMC9*oH2>U#rg*ICrvs&sxqFM>#WCRpgzuKsQFS?6Yl;^)Mc8L$53i6;2HzS$gccg9 zr3?P1nS&>AuXm_{@S}51aw@hOzCrWf56p;?S_G{bd?=cApo?PxD4!%artr+it|NE! z45GcJx4z>OUpLNFs-3Z_d)v;7WFzz-H)yAG8jdXfBV`>F(M|l}Z#{SSDvzc*&+qKo zN5D7H%X`lK;~5$8Wjc#&G}F~PEqnOXcG*RC2vM?S(^g1dw&hn)|8@&lMLTL4_L8;b zgSZ9Y7vor`Q^Zeycp z5b*lDpsVl5SVZRbxO*Tyyt66YPSg~mSu2B%I3R&-->l7-ONR3WRqv2ujf1KJjZ6I0 z=|kdqa#3yTyg~qT%9G#6)%xR#$r|u?#@Au1ibWTR-+f9fqUh+E%L~MK0vmOEmRdTB zQ^wY<2jf|8(ex2v)UFC&Vh5Dv0pjizc{b{TXvR%$x~H#Jb_o0!m4oM3RD#$13qwp2 z+9IKlNVe(`qhoY=XpGY6in ziDJa?nzHvASF{-b*#@rpRLg&*_LvD!v;C^nI!s))+txSXTRi^@!X98}(ON5SiDikR zU>RBCG{1z>H4OuS>JJK}=CiY0Nq?zFI(wy-FdOyntrG-XIl|5JsB(Pz5 zL+j}M@BAsYFBue4fgjf17<7-;@IE=`7~bNKSa*a?Z=4)(L!I6LhFcgT1kZVgE6YzM znPoOO7M+sz)#Nq7pA#A7I3~_=U6)6J@ChaOqWo-Fc;PlZzkH4ZRBN1d`bPh(M(1vbI(mno z@K$=~?S0r~cR$=5Ho`9D>)JXm?Xf+9uac}0L^vTZMdkU*@|i@x^Q1bRpNknV@XsRv z9|gYq@bE{d%_Ab&In6LGnW(nprr(`Lxov`LfB}bV<`vqM8t0*yS&V09TvDdN{8o-r zzEjboUVVYxD;ZJa$WYL0(pz#=Eh9IxHF2^ZXzYH0rE zK^$vJJfqk5z}7Uw6ns#_lX*jJ)kaLkS0-{8EdM1&l&e!{E^{#gr3B**TWst4R%8m| z2YHU#d0ywTc~PcSQ%CMJ@d17br=1*qsa_? zbE0A)%YFlfvFYEyRgF%xtBq@(AEytvOFQd_!L;P^zYk-XE3&DHuzwEW{(T_(yTbN8 zkoC}v#GTtvEC=g~iuxGXy1{TF%xbAs6kC;qHNuv9t4E7C*Fg~X#XqyVexO6>bYBHV z6!IiWt$;(*jY_;ztg=q)&9SJkliWsYAXl#Q1@I@oy<9V*vB+qrt)*p#ut8;a#bB7u zj+7K|h;_n`1sfewkImbzePLOuTvEMRS`(2UnvbnK6CShQy;U-bU>kk}5WB~RbmKON zMRzJcP}kr__K-X~dY+OTgFo|j@yDyI#f8l1vIks?2rdSmxUGR$2@6XV+@EU($W z3kb>j?uV*~)zlN>m!W+fHdzaHF*E4zurMR%t(cB- z3Dw!%U%1VtLgf)_xuj(MIfDe}!CN~h@0_F&?V5i|^FDUR8Hs`I*Qy5_r#m$I#}n1i zDaX=aPA`8cPB9`Zpi|!^@%&j9#C>3!gpU9lWQ6e|59wfyxU5Hjcp}foI;kumM|#Fw z>`xaY+LhNo7`$E!=>Q13f5hw*3Thr%@4zv28&a-;MA}pVdrlXcMuEb+gL}D-+`8L$M*jikcBR*Az zb0e*-tW)x8Du_5VR-BTjx)baH%8PGP|NeHgFeOLFiHDa-F9j>!|9#CHAyjW|%s!BM zUwk2<+lio{A+v#BDZq=q9V_7rpms!3jwNULb;l0jx`bqH3u3BgLPaxAy9>^fdA8P2 zw?-Sw`YLAfxP9s@!~fUTi71{F6KC;^f$%{s3qSh#-QIQvMQa7K{Y zCXv^Dsrqvg)tWFt(QrG6XORxk5;y<17%y=y%HD%zR@FBbx5j(6pK>L;dBy+Qm;8^# zU6xo==8A0GZ=~gD@5?$-DdpZpai48!ZVK87L+Tz8jOPaV)W=7P3zH|urg zp~Bsa9!M*5d?kvQn7ECWvq?e=@A?N^D4b%vf6*`^G*I-&Fcqaq(ex{TUnI?XYJEcw zf3xPDZo`45s=fWe7{2z-s9>vQ!q|zZD2t2PmnS`y@!@q%9zuA~j6e{-aQDbpT==R? z-&_^+YG~`)vgLSA;UDLazr-D%w>4}?=z)IDe39;LJI|ME?JA}R|w+Vz-#9@)B zPRi+)Z4u`xb^)1TjJ#z?g&cY^5Fkzm#}!L_D2zy~w#J)$WMhaos?Oxmj)Kvsrk-`I zZZD$97@?Gd0oI#Zc~?n!s;!NoJ&5jb*>JSTotvW=%X>TJPllqew`$$@ZEA1k1m)1N zKGJz$qd;y04DaA2^(8AtcDZQ3rfaxioGxyq_LQ#C{X_H%dv-Fy7~A~O=Zxv!;_Db6 zaOUAByG;fUiwR7_s3v&uBS5MdubLM{;?_S|TrK6G%3XVZietfOY?imXQs)?Z>h|Zh z*bKNWv;Z?}S$}9`ZG!k0HCFet|5faP)IIsff`tsKW?0M`P2(HM6*JWd-&K7LR-$SX z8Ny*Y<4`4jz&Uj_ux`396&K)gd$o(LoIrjplJf0fb*4e*^{OsgX!XqSlo`&YeqknU zrzfXHlk4bf7Nx`(A+b24xQC_vbt&lUX-BRXLH2#006M9)v!#Jj1dR3v>L^miVcQM0 z*gGX}=~TcCYp@5#txJ2{`rSfjDT*utCKX!EoUDT!+%o#{IT_9TPSMzWE2xr6atFqQ zw^fZJY9c^wesp@9YsUNi#E}KJxN?le0a%G;oE)=H-6Ik3tqSaB(lS#d^Z=aaZa!Xr z;q2(?ERbtNcT4n?7vMJ#R7*LCt6USmJw?zFtebG!o}s};_l((5-j^W8tHy7b5&m&% zg?A{a`s5o-3Um1FM;yv`seKXXEFlkZYc`3)P=ldNCs$pHZl^)Ux8BLyLE-;As2w)@ zGzLXP{UV!(e!Jvl=wUEyLfrI|{SE3`5{$bNN_0%}+B!T~{k|%RGHOn8{-yVNz@@&^ z2k{3KoDXzi<*G?~ATY-nODAk`sL1z&UUY9|1vT*Y;ru)CH*kS2L_JtX;Z_OSBw(Y9 zI1Ch7y2EN~mb8l6QZIe~=p~`_ZnE*D^S$@h8;J=wxx-MlszZ6sTa|9tA%J&r9p+xl z`P1Sy+r(H$pi*QwyQV2~tIIhi=UJVwJasR<^f37x>h*oBq=3I1!o7{SKgUQeU2hgD zOe)P&_SsV7jvv2-n2qWYaI{ze%By8N#(s)p5hcT60~=^FtaH3unR_!6f@Loao;|lp zT5)Rc2-pj&J&K{9FO1Qe4=L7KC4@&Dva6acfMCO^OEVzYG|X(H)EH&-C|OcD_M^;!IT0QygeW&3@)q`+Ud zad`EG?eS$h?S4`pXXV_t75=cLll2Bm9-WXE4*pfDCQ@+q?iIX~*QXG1Z1UaJ;VuKC z0g4J1i>27rW+HyKDG9!)edSDWB8?!+Nun9lYWJZvUzUFNfc4yk`PWoBHQo=@?6*Tu z1~LSpXqUO#UlLxQ#`*}5OQIMJJzX>KL+_NepqKOW>g!$x!6s^={h)>LhZSyn{J}Wy z*d0HHXQ2g7#NlFDVkz0~Kye)jw+Gx^#QBiXP%D&~HT0Btf8f=MOpMUN%MljBCED+z z!-m@_zfh++OY0id(*jBG_+!Qrqh+~DZw1A)zLO#CD>0ikGP&oeuyb@MrMuif9cIsK zx{Bs8&O<7HD<9ZYm|pH%WDv-cy731D#m`&lNr*4oq+giqY)7IfV)3;YuDAQDOSkjs zsrL?CVjyhKJXJ)hydC9|XJ-!4ZuC?`J_3w-VdAj-Cs57*rs1?#W5|!=@T0*;0LH25 z81>Ag(y`O=iu%jzUzwCjR9uOtW2yaoaW9-wy2Kr3ab;Zgi)NcW)JKfE9@~xN?Kij{3 zHJDDQBOTF450;lDxGkrzyZ{;BCv`jV#^ez=c92&E_RtJRUYzpDT~PQA#zZ@R;bP9j zEpoRtdL{&p;$QuWj^EthD205fjv{9>TZ9On;s*{G?q!u2Z>X@wX-M};#kb2d%Mlho4jd86qz1Oe6xWUMRvY5HRQL; z=>tIt&#=uU)CjFd>(4-a{;?VWBzhp(-CJFGINde}Qs$8Fj{xc}ATp?bA(vxDT#5t9 zIk0Hx9<)Mo7)oYmgW03ad|zOt=-(0MB%C|o%Z4IhgO(nn!O0$QkG8s(&#$tPZhp`_ za-`BFzI5r@I6==+)^btfXD(7DT1NJH#r1?wh!`@^1HRH72TI|-R%$D|o1_cZ9|&&; zF|c=-@M^+OveQXEEK=$k<`i$m8tQ(~8b^ox?(tum5;Vvmu2Rd+_ZokDaXfd3GNoD&gBrZ$ZGl2Gc? z(gdjV{^!6ni5rU*kSw9%u!Xaip6DsT1w--a-l{Tk%rsj94Y9EIoKrFjklB`Tw%a$34NQW9SUJM*c%>Lpx|4Io?zIcmeoJh{jlcXv(5dIZ$wv= zBvZ({-;rkThhZa}=j{VGw{=b9x-YlGg`dP&*t>Y>eD1e9!Gm`a*TWg&KzQKHD)e%& zF=-8@5i#I3tH!8nSH1BXIPJ)K_Mw;oJW~WF{a6J|CSe}E-c74@+E&Lj@oqOkMtc3U zH>K;8&7oPDIRneDnQ(D}-xB9SCg4K9eHAhq``4Ttzku>P5z8yfk0EC@^E#39hw6LiMWT`GBUu`T6616%KePzH^& zmtZwsYEXJ}gk})^61(M`!^_;y__X+XPEBfGY*RNZwJFoW$j7kFCcIZeL7&-&sVZgE zD4IE3(=#14%_8`f7f#%#tCfpdS@Df-{|3y0p+Vs^T(`nuEYqus&J{uR)g5=`)iobU zhZ2TG0K{tpmfXbyjyMbCV&o3xdJNx~FvK+j+%5na(lj{8>{ zGFIy@@KHGy&t7jh)gX1SD%Rvn@Cy84c;s3hzY>c*C zXLX0ME`3mHCE5%g>>ae7-jfp~y&$;mY)^S*Dgj4%Ui01OK*K%4UoQ>sHsH~FCg9zK z`VW&QZcl~ibz@1gd5dkcrd8M2I@`AyuLzZvtPFE^mJ@eY%}kAduWsBir@H2&-G0T& z*nuTcnyS+$j2HP7w*xyas@$ON;>6e58KeasHlL-tEOgTE!Gc5!PQv3{;S1I z=7W&_cM-ARw~;JeiPPL&QxfezOx@2gzAM+N{*^}OlN$`|>k@3d&+4M~2449i_qV1f z4J08hf`*I>#?i2-u)VI` zRqYT}{<=%2{A3#9tWkE`I+m#x>TfE)_M(kSmRrERjFGkQN@IBZz!c5lv&Byc0xv_Wp`^fZ zo;>=xKJxq|qN+jq=q6knE-aVOg+N}U@W2DlOtlr=fm&SeV;c2(^Y@;%Y8k zztF%J7d$&9J0~GXV8yN2|2as zzU^HZ1zr9+E)@qP4Vj%`vE}ujoZc}Tx*}G|JqBu+)~eLa@_WWoxrm!esr!mji?Ta6 zz3h0sa`)VEu&vXfP2BY(VKZWPdWP{n0lQnRHED|0y93B)@5S*{ z<+j+`sr?~nkIPjc*05e>7k~S-I57gpdsYYO1YJZ36&FVG zlmvo%(pYuWQ;JI?JH+n9{^p9b=!cgV*hRVsb)v<2Q|QEwd@;s4gC$7=foIRo3_?WL z;9f%$%2USmO$fr!>#IPXaD$TCG*|Oxf}bs6J_JAOD$3A*Yw7d7?(H&T%#bJjwC{Ip znby63lX3%Ix~aeViImPicuL~+SJ-Am_vfEJ_2BkWj$1EoMc~dd6Z&!4UL}|e{m4C2 z8Bz$=v&~_hW5F3=wc9!idQvGEDf~Y>*&+N)kO2&d+m$Rc$L?aZj87VJpKO2?hCs+$ zkk|@odNdH-P2j$CBEo*?@I%HG;>qba-o=T`D?*V!t-buQi)^tGztf&ul~-$3t}RJ8 zL7DBDk)?YQJ8*dqP}DZu*o@v<_^=R2gV-n!C`R#j#G6k4Q(oNw{k96;UU@&-kz$)~ zt9Ev%iJtT8>oDOrkjNywwv@&_Tc`6tnFrO*T3Oe2)^23W!B;xr7syy%3g^6XUqqp8 z=aGA7sn1@h<0C@`yUA-BIaMh*T}q9QbTteH=?IpBHtI)sUU|N^uwcS;>%BOo@yCQO zR3#$)1|A6JcA_R~tmaG~`o!ABZj8(2y)8+(#z`=~Z*t&;FDDdx1!DhgGy5*CfK^%| zlXk0?L()>$LL%_C&dJlf%XYwlJ|&gzf*w$HihcCJjBMRj$N6hU;&jUGk>TM}1D2Zk z^1XpC4NX0@^_A909p`7pYfx&u8`JBpTsPeuW&gEXZiZ2ohL6V)^`(@h8M}F;9fa^N zM}vAn&rt!}m3JczN`^C&eOEU+(>pdk;DY9!xHo6z2?bxzFqu$MiPf87-Bcau2%=k9 zpA<$1n`OGDDtB77Oa2Yzq9l0`udCohJ(wcCqhx3GHMmNNmX@K{=}yRQgB9L*nHTwm z(zm$e=QYK3W>{UiU0;fwMr^UtjzzX3QySGUFBB5dbnWFONsAEfjsB51{c2uZy=16~ zQt*I%f@$nl5?4Ju}{v)xrxxi?Nr6T=LJyv%~{HIFtJ^M+iI zoT~a40YU+9oZbyAHqFTVZvV~`wHoIZjuEG@|EcSZdX?Q3je8eHUHIhQ&>macomJ=} z9$1ApV^@J}X!2j7t=M<%QTd_SZaBvS<8u^E!(721h|9eD86y~Ykzw$|ajkkp&VA!+hk#q2(Cq)EFW_LD&X1a&S8c z6In3UcSA!jiHf$foEOA=W26>iC<0G^h>E9@LAn+fol_;6X-pv684_E<|{GP=Vi$L+bAfl$etUXJx;#FeO3b#R|2v2^fEF zx9M{+a^|a~c1;CH%IkZs*4z9XtUMq!=8bfys$rh1No8W*eu|jqrG6?o!S)9b@%t_o z+s&Xq53}e&Z-rol^h*&piqZ~xzMCwxDYH8h?QYR8vT6RX7V&zC;~#yWVugz9m=bM7 zi=A(3veB?OrPz!drje&NFzP}CpS0{#USk=A({_d8m4vG3rv@v^mSJPPT?mT2?iyzE z@AQtvJE&KRB*+eQEH=mhMCNl3*5pH-s19lTuiv>Fg3uUtGaMNmHk3TRr>rx5sR#|b zS5_kZv`+g>q7o{FG$ihwn(Xg8*P1f^DzXW_Y}OvL%G0D2NLat-j((n zsk8uR1BJc2Fxr35C|duJ#;4ljWag}@LE5fiqj3%dIZ6=(u5H$C21_!al%J9zgMCx>A-qJo<1RlTUsF~rp)g`8Vx%fz< z5?kl2rQoDtjX4$vy5K-*BDLO}pK;3v{+v+tutz|H&GF{;=JM=S1X37&KA6i0R}Y5f z_4)=(MpOLEbnzQ9N_BId!T8aCpF0Trgi}+vw{DP87zi*q&F`*X-K(cas$ZCwYt`g%H;tzi&c1G02_MS;Y;BliD0qeV%d?OHb(!CYWz`#KB#I`T~cWj=vqt2R>gxb|-t|WWO z!kDTwY;S`iJH6`eyl)A_97k;IL&G*hEwW77W{)qTC*&OCxUYuJaLGUMX9$1mx$8I| zbcH4rv%C3gB|inGk-V~$)PfUWVqK&M0=r*|tN~YC2TJ(fL_eTwZ$T{Vu1=h^fuH<} zC{7A*v!p=QF$*XsM=hfHO}VOi?3a}Ci6JTX3(ZexazaX^EWAJfVDwdeA)-0N`cHL- zCULa;@GLJLzJ#0;?2Vd9(@!O|mDR|e-W~XBrOwb5<$tpUPxe-n)bj>NSQlX4KcKQf zQa;OeX4@|{jJl1ZA-3qQ^R2cqrMqE)IY0Y5#y~Z<7X-QBlaxh})Uvhi z>%XiT7*W(}bO0*z>x!LpHi?GLF3UURz}ckRm8-LNnXe0q>h~c?_S0~GBUty+(Lf%N zKU#^zN#iztv>3PK3^Tf->TiesT)$G?Vp|Lzfa!wESyPYE~| zX2=ijN}<<*7MS0whL}H)>{3y(eI#RP#qU`lYG>n~P>1P$nATCOZc1x|@C z2!ruEm{+VV*NW&!DMbWt@NFP9`FF-kM?>JFlEdviC8O;7v=w=Rpe;Y2TfKR!lVb5M z61CA*l{2$DyL0_p*W6cH_6v2FN4L2V+q`6lk}u2%4>ssBN$#7s<(j{Yv0yF7BsCFJ zi^-$=x|znpt^0yVP+-LUmNr|epN-Y?6S>Z8bjItsw;eh%&7ftps7_aL0`$8lsf7OZsXpCa=bp2Ch9#-fvvqmbU&F5;sCEiXIY0WP?o?YC2Yr}tN$RI0V4vE|A z&S-%Qidx*4P~f^AHg`q*+2WT|n@ydR>b9xz$EY$(3a$37*ML-E$F3sYq1kNd&uGzspCGx?hvwS*8 zM%=+G9M;|79?2GY%+hA}GogeEi{;qKw4@tZH| zS@7n82hO-tqmC#Q5l2=#UI*2BAA$6YkBN2JJUF_ez$BkZHxs>xKtgYIRiq$8ScSp1 zE#2xty!jDTbii;XBKQS*qZ*dHJl~(}`{O8|1L354ZoOg2BMC0lMD0aq=E>xhRJ0}r(Dhmbd5 zO5X)vK9?>%*qhvTyas${Gk@ zJ946vn-7f!^ZC*09Uvd*XQnT8?Bd~cUs^krmm#nG2B?^h-*2SeqeWzCDv+~{<1<5I zcEVSvj<;jcg$!27$Agtvz>_}1_O+0W4oc?9Bb7T@vL3QGFMZv<9T{yf!0GoYp-l*x z11%$?qM9oGTEg8jYalS&()|)5FVGcXm=r6azQ&6bqJ+}rzPJy&oQe`|+ERs?(XWr< zUvN9wmV>Bn9pkhwEzHU^AgMUCzIZoJer-aytv|uj`^^u%{$Lvo*^?B?wlB=zT&-5{umuDhe#44UFUpx7)?%}G_84Zzo_+>O*P z+h#&A*X-T;sPby1-JXe-xaEtAf;I+S$-o&kd5Qa3e)e&z9~Y7-$0RhMj8`lPg^YrF zEmi^+K2V>^6>3EX!)+UY*gp4x$+7DILd!L+czojFebigpA7P`{5Ze2q2kxh%gu+dK z#HHzD2k@R{VChUD0{Dgn4|16hrm-{~&PNoz&~G~&Y}6P;VvD=`#{q~(z+l~IuRIIQ9YVF+4TZ!ME_;*`2k1~7lYkfsha-2t* zEVf{w_JDe3%M=78j(v+W|x{!_-?NJ_XVD+BemYatV>GhY1sCyyl>S z#-mfy(Vd%8lB$sF;c|Q`9_P*b>x&c@XE#&|G84FP8;*ynx=k!pL%<(SONKK0)=zC0 z$eGw#vNX5NzKraT|#7`#~TH=%&xd5er6zBZH#bynhPYKjTw%nCD0Eb_!4AP1t?JOWH}CfgCb{hRQJ^`%4K zhon*0vw(tKndX%|0&;2T$=x9w>XB>6R%p1>64Ng zbSFFPOMvf^zw~xt#;%sbXk!&iAb(`U=?789KXuV(#N^1VPZ9k|YxYfNf_wEg;OgO* zXHOwg;xX_S*6Zx#B)-014%xaAd4rYfdeEB4JEyE6SF7=u@M;m9rUok#!&# z-Fj@Z0Cq6p-TEbI)UL$tVF1A1)xr6hAPk<;6>OKRtTgp5k#O981pE%*H-NmQ+7Wx9 zSfKujzleSn{h80u7IC9@Map&4A+3&PmyKge)LTxzp;XyGB zJd3E$upEZT?Q^A8`0-vb{Tk)}1qea+zSGJIFk7XUa`{EKyl$ss50r%KgI=be39fZ} zo7a=#e34t;t27p7ANcZVK2>BPh7LwTV;heGwLC3z;{N~y_^VdYrAryKOJX9>L{Jd$ zMs~Br<#^h%G`JYS7|G2$ZG)G>96P!!o@qba{mApzAX4__IHk5HV+Zr>gL1j;jNVYs%?zIJU9Tp z2JDyle(p{bbK~AT_>b_b_Ku!gPa13YR{k9DtOHZNd$;nUy=S<x=@BWpE{j#g0fUz+jMT+RO8}WY}5JgS6+omj3|P`JC186zkMd zZ*G>*>wFXOGS63Gt$oP&z7zNH7q4qV4q+dty`^PfrD!^&_kRDGzbCb8XVoLi42R&-_gvBLX zC(3cq)J9kq4VD&(IpTGAzfLEr}*srrn!`Nesk z#5-TK_)_ZT)&lnyn{KV}I=o~z@~)e~-YACGQPR9oZy_-(kxjTa{IfXEf9{&4Htfw~ z7`Qm2xYM;gUs3SqfjoBlq^muQFQ@7%RZ7nAkr6M(Lt$8gFgZT8)A*9%@?3C_(D5pk@US*En3PT23jeT42ns?A%l7km~wN*yLg>7trEig!8CGt zTVxWZ-*7z-aYU}dm6J5TwuP<0V&7BNqr353QJu&O5JAQVv?;@NWMkLq zSo*%G*9hKA5;~ALtdtvO)hj5SMx(64>{=m}Je|$d^O29sn$5NG5qO#Y(d9Pmq6Wp^X2M@UL54WfP z0IIfI#LeZT*HZ3JENnaj_>TVoO3qYeeMj}1qtP_)9$MVoID$0}P7Y5k?gekz>(Sjp z5KFLuoD;~e5YctvZK_-n_$kb4Ph;u&{#Dj!eku-KVk?!wBsNbysGT<*i=$mPso!5~ zGeCUAxB!j^HIu6APpfHj={NJT31ehpFi6NFBRRq6Iqh8Z{w%dJysbDnKQJA5{a#>zlqzMn30j&V}Mu0tiuq(zm4d=tPYo+>Zx5q7NymNu{| z;B+}3;Y~@SpV~&&B-Jjh{8gjb>({qTe7Ho=To)yy2Lz1$Mt-8Yp8@!a=U36i-jk`c z;nyg!$XYVX{oH%;TvvmknlC>|7d~i&nH5h(T!HxU$x=b}D=_-gu;*APc@qt7MHvb4BFVy-!2F@jgC zob%g`E8cuH@PEbrCDKyj;UE^owZvCUpj@#;DJ8S2w<){l869!St{>okhIJe75i~LC zEd=n$+h-0u#VfV8ardx5&u|V874)yd>!GG=uAVEMJm%djMItQ}pn#rU-il8xgYU*M zUj>`yHL1zEZ(qdr@OWBtigQK>hQDPiI}H|Tbp1~5?A=>Q^6Dt*B#a~utMZYzlptq0 zS2@l(aVF(mG*OeAvit0Ku=PuKYo6W|vYI zh|x(B#?ZJ6<`v*$=t=xfwRwld4;9<#7V=wZ{vI>jT;4bDpAWPU`^d=~a&i7meBC_P zFr1p^dY;57P=&1&eHrk3S<-wDphstId}N93l*ZdOgWovq-nzKHG1`mNwm1mGbMeR- z>t7z|Ul&e|q#p^&?C%CmS%fHWvgkT8=fOG6I{Od_ucWU|X z;pfH84(GwX9@Xx(h~SRdmZ z%Nqv@_EJq*F1jBPj={?bQrn{4HdC-~Ex_we2O}b@>UNKNWi7l{O#`|RlP6R?kH6Bs znyjS=Hx+l-;9Hq6YO{Ef`dd49yRjBmTPBWJBV@ZmJ05sG*dw^@Um5r};g6607=OW3 zucz@>h_q;|^^FSaS<#Xm0VP?j8cRDv9B8as(p8kHX>vhPC*2Nl^?tMPmsY*f8Vxtb zSFv76bZ%1lE}admr3l{`Q}ZZeksO=T85qTRFONJ2tY{y#-@@-0c(YW~^`8-H9}hfD z;rOmwMriFWH6cEkeQh%;nGLqcZEway4aQP4oq&8is^>NE?P94oR8HyM@qLw(ZuZke zwbtitHA*h&-D~Q7BL-PA&AUAExTrNdQFCb|KkEKmq>6b{>MNS?pTpftM%AwTQLK26 zQn zo8w+palkm|Z`QqNW2HPYh9aM{a!%Khzizg7*Qeie7X+Q+?_+`Sx5WK#O}&dw8rO$l z@hy&^_S!sNBfm>XwF1z2gsH)N`CG}@q>n6|ZOE>B<5$F=hL)Z$(R6=`dhLVWSjQH# zr|JHBGkn3(B+fTF2@t4dUK?ROf$skRXm5j>FT~9v3)QoRZC6cnlF!Tu`@~tJc_aC_ z`H>j`JOaS>t~%@Xe(+wU;hVo3-Rah8s2;U=S-K4yedM&Tt!=^uGZ767bi9Eo^l7d@rY7!DptHy_RcKX$9T^5~BcLE#L4x zb5i&h!jG%`Gtd*pbA7f*Z6g9ph6okPk1#sq3<3@~2jvH?d{s*LjJhdNoATDpetI5- zsjJ0my%8UV?Z1sK^-P^Uzlf@EgK@DDd5;li}-+7F^wFO4^KeR@eGl`IE&R z!3fVQXJW>KWM?>)8CYjLdQ?;CZ$JDcb4eT#+pEPKhB6vORv?TKmISCEFDD#lH1IWZ zIA$=#&HMM!w4MCb_O|DrS`^li)eGUT8)~;cIoC9c-v`{lmUmId1^1Y*6~s>xKbV;S zg$zm%GxH;TPVAG~6D6hn%S)Bdl+p3YBzD2*e=5Q7=C!8ZrS7$944!q}z>FE9k~RfK z0)yQU_Jg`>&koCH;x83l*jia>(n)t7op{SU>hkbc9PUz!w1a_?4;A&5 zxSe3Ie7K3Z-M7nUrQXdeEw$>A$f>*CBhvg;saW`5L2Jo0aL_4HA|y(F^92NkARb7~ zc(0E>H~5#so;0-aO`eOQ+FN*Y&U@>fLseUUGTKq{LStZd?jke0leusJ83v!jpNQJW zh&(m_00`HPyfLZW>2`5RBzM}5q%Us_yNN2{BxjMAa|K|aZ2;!5zAAhq@twbkA&cPE zhllJgBDxxl;PG@bOC9?aDisO_Sk-qK3~8|CS8ySN4~)cSGOLY_BMUBGS9P|Q>utX? zwiMyX@16Fa`(6Av)g{w!t-K#AO>(Ur)t#N3MB1{**beN-0`-#^+(QBvB#Ncu{{W6q z_`gzxtu&oJ$4@#ev)pR3SqbhITxS-{RI8AiST@#DSOP&^r^zfn7E!zqlNLdiCB5_yw-~Owpq8cD;Ws{f*o!ZZ9-_anIXh zhY&xV`?SDg4q2Bf-EcEiM={T{pKnTqNlmYQc1r%Y&~*N-8GFZ5pP7zY^S;GEa1_!L-6V`C#|@SDv&Ok#O$RUR1#9${RJuIvIx z>+e|FKZYUj{)c_2YBrI;xAQ`6Y@=KVNR3qTxGYO65_^N(S3{!REMQ*ED3dnee(&xx z4{o6I`Bi1H#9*sN(zE$r@HL+-;bdq>aPnSHZ6%BENBM3U2h1DhI5_qC_NOJ>I&3ma zBr#iCi~zs^mONzQv28p<=lGmDN(4-HGl+O354*cQ{{V@mYF;_Bnq`YkhwUHfMl%^+ zm;@8gAm@tu30ISsG^MGRu$|JeHOhfz^dOUK>bCuv@9CPiSl_i`y-L3Oj zS{T|DXPM&KLo}?!oSwrcKZZNhYMssfj8f>%QuE_f@c4#J0rfF$cGf%KhC3-FW7J?BY~Ns_m3Wa+TMcZ0D6aTckvbpy~b_ZxHDkb-$H+Jc4QBk)fHK zGb=L(Mmv?m3}=j<E<{$*CA8vHDls9)%rU{p>t1j1PsBP`guFLmE%YWf!&Hqf ztswH1VBQ$4q;ZkFFW|)TKnKu#H4U=b#w{TdC|{Q>Ngtg&vk_TiBkbkAiR*vB=bUuZ z)V$TC(=6U+m<5hDciIUc0h7Sw{VV6ckD8Bzd{wO2#d)f%*IppKvbQ46)Om=u(!7Z6 zyOOcIg~(I8aaAh;}-h{w9ee zx3rS#(@+-b@km?bQ_P62NFXxqR$v1G!8P@`%x*Gxh|#GxWv!ckmqAdc2Ai?;=YwSU zhk0smu6$RbO&(7R;k%o6#s^UM2R~d_%ipy!`1iv<3U$BR1NL(9?XQLWPalb|ZMFXZ z65MGCBhREltrW3Fv&V4?A(GPGQ6!3?Q4U!$O>6u)_@D8P#lNwa<9CALvwbpqi6LJH zshJ4IF(PZsqk?eWRz6;RD+l&np3CAd!>W+r_#shb;U)m*E{v#l7k{vXA#ka}B%51fOy6vB{9N`dj-L_zz9^ zSNkmZ8{w9R;ZG6hntz9UJqDYnY2Ge2$5M{o74qY2kFvYOBxO}%6}a8VQn z@Uy^wwx5H1A)sjX(MzGta4a8C)HLZXW-wh{Tg3kW@i5YEE=C2i#tp6HEX^K357+h+ zAG_)WeN8yd3f$L6EM+I7JY)9U@de(y`yzPrN$@tIESH+zm3QI$N$hQ2;iH~rYdJ_r z{$gV$LUG9Q&!r!*zlS_K@YnV{@K?j%23$#aJU8LE^!ewwww42PdjKhLqGw)~0_2hwyv+&DI z@J5;No?Sn~{x*s|D(dF=SZi=yz{`nlW+F)3gBu*SSAwSlf-A$Fe9Ae59Adqkmt7t0 z_!_j5wagEP-x>U2;(ytH!@m@KTYaa#ui_N@L=C0IBEd39?<685l~PQ3J4ei+_{kZm z{5$d99VJ>H7ECN9+NDxx*cJz&0OX!{<0IaDu+x)|cV-iXA^y zHwBEoMX8A-cR_|M7@tB;dsi>ue~h{xi?8(?o0yd@BDeW&r6jH}HsrQ_`1U_a{BOkU z(=^NYk`=JEX9pN1c)M=j$^FNE3Y;efq>pKj_Mh-5@omR~t^8l6OQ=}vZBEba@tJIq zz-4(*9mohEg1~n5uSnATQKf2dM|btuIjt~Ub)4jw3K*%>b=6H8o7Gy^#8U>pm_0 zo$Z$6T(FuMZY@$h(#>bPY{E9r$jS(E*e7Z*01_B{?cyJRfACQ+j~}wff_ypguT{`w z*IUGv(%flZ*f!(rsDv~+h1m?ziDD{W%7_FG>cj4;uej@fv|q*#415;5@dtr^0bls? z{{T;x1bsJ6)nm4jYi4!xTr}XRWQ4l~C+1`dcIR;CJU{;c1y=YSuXxhi!|$ZtY4(z6 z6KXeuQo4pa`zMWxn^~;`785bqu~nOTzTv>H-ts;w%dy#2JWV*Oy?yK5X}3+ERrjAi zjLWIitldWYZtea@NBe(#UhwC`580Pj@TZ8aBk>Q2HLWGBH2o6aQHst>>54X7Z*P$a zM&M+*A|(vY0qVRh@vruN_$m7~_-n=*myUFu3&QE9TUqF`YI^K=xRcAocCkwA5>`vsiZ;@h>ppAQ)jRRy!?6O>0dy&U}FzKuF#gg1{&|M$Nbk9DLPo zFRATiP7C*GzrSm*yYV)?K4j9@YoD!t7yYQTFA;c_Ee>x7>RNrh&|k6M-n2+1QZwdb zcM11EJxO3TjEwqpHwip`Vq|?qerW68v_zj3JV_snZSP^xErLaBZKP?c;bgb+(~*+O zu1@?PyZ1BeUr&C>{{XaihxILQSMV;cbFQep)gyfcHFlQrbGkAlk9r5$5}3Dw=Lx*4 zHw&ITr;9zdX)G=xYR_kDYwNfC6QL_3%Krf1v0f6i_@@2`@O{Po(1TBw?)=ATw+3&K z6fr$MUEiI274e_p2Z6p2{21{ki!6K@rNeuwK+u0`Tp^a`CYD5no;Q$@5yNs<8OJ%V zQ2zjepMSwc{5t;tw9k#c5BO(J)*k!9*Dz_?WyP#;!D}7DDL1QdawU*9^$5}O2qcmB zYvnyp_Rsiz{qQOPYl-M=!NUOTqbwJ)=_wH#(iR3F|Fv6ekf0U&-A^=IrQ;q4p4 z{xCB5y2s3YSUh$bg{|3!L;zvpl^6rG@W7P=%CsiGVv{jo`TsSc}qGu z-Lys-!xw#|0#s*%Uo*xy=UXbADc;R%ZT|pE8q><_VdSM!-+%l$`iY|WhHFwhzZ07{ ztsjbJ#&t6Tn>}*$Khm8{hxDj zqJM2!Mv`CY_BzaSnAH8*3P+Q*xEMJZ<0rc>ek%Ac#Tsa~@Slg)Lvtdm)7xz;9ApN_ zUioMKDnB~h2gmvA=9eDON zqv9_WUWBvKbsrE!vb4b=i9;wD#tYzrImg#HuMVybQ+7v6dTMr7-X@iGDc<7xC1eL= zWQ=8Uai4tk?NoK27R}+k7E6f$mgupPIOAcB%yYMs&}9At+PMv6S=n5{b*5iO6tWW* z>$1gM5x?cmHi8u7b>p@vb#D}Dnqxz#>RMa3mb+L&*)a}&Y!U$+0o>${G0k=1a1v5n zx|r3HNa?gc8r~N+{w~zxfw8(sdJOp(aO zI&~Gyd_~Z8zYytmdiRC(dsaid&lT;q;Sym;U^|jWAoU$PRI2fKAH$M(mqxk!Mf2LA zZP<+&^V0<7LCNi3Lqh`US}@$>b8*z_Kj9v43u&`k#h{jW%et7EbJL*pJoP+R#-Fx_ z!2bYXV8d3WtC<8RqxRQ~{id|P~f zyR(+!U1!7h8n1+|v<+qDj^=2W=Mu*t7>YLvB^V$!6&SNAuh=+0h4HvNeL9m{tLU5g zbYG#viK$Ma|A#<3B>q2>l5phQ&w009RB zzrA{Ihri&YzXu;fmVX-R(_3Dvke0UA5ff}t?IEedCA>cu^>mLs zh-6e4{1=MmAL2*Gjdt`$sQgIRB+2=S)Z`iM)Ed!H%IUso%5UyC{-v5Ia>7xH`TqdJ zAJWFV{{RJF_yM5bGQOLAGN?OoaRg+O>K;IA&b)X300pb~J7mm|Y1U9+{Hb}Z!W;1m zlhVHnwci5hmj3_%BJmaPiuKFS6zV#RG24dKAIOFcrQ{_`W&TwQlimAw@+tf?s7-dU z&npp}62~|njcZF6m9@H>1IhY?pjQK7_WlAV?Tx83+#Rs>fR;s?}co2 z8=K8lqSNQPh_l3z!U+g7j22^)f=OI-;=b~}_yhj{1d9EcJ_R?#zuKez3HaKYYMvX4 z`Mh1Gc)DAw4Px$Bk)wx3Epr<@j1n?h6i+E1GWkfzWX2p#m#jmh^?g>C(ckZ5r^D2( zc~zImf51E&U;hAt!Tc$gS-RHKUDvK|Zb4a@Vr`@ooGS7F`d1I)U-&84!tHIEQSj38 z{5x*V*x;P?Agz3d@e&^bc&Fkfx#EuocoY5+tqSv0n&U_C>R!Fq_GPO!V}Q*605ru{ z0J+9bVZf_HONQFU7KX$Ku3#?#GNT029E4duV!ShPfI$TG7&+-( z5b)oLhmE56b>fX$-Vr_gF-v&U2_cPGkKTq+^9`&|AN^|a>tOKHgp`)+Ugi5Jr*?j( zcpt^T4nJruA4K@M;GKF?u4wbkcWq~MjSOsFCK6g6iz03zNkVW`9xDgNc7F-JKKxzL zZ9W?OSGb2!UoI_2!@eHVN0+E<^L(&Og<37F(>~G8*q;FBb$t8qcj1ri2jSm`bNnUI zz9?GRE}=ZKcwb1;HC0>9aziFrPFOS{qC3~g!~FjMGXs%c$NvBX>}x-UpA>KW3*yZM zG>eC@mhW4=)FWn@W{z}<-NAg7RB4QRfdB_$PB}l6F0I%E&85? z89Bz%T6O-DN2vH$;LY#B4Nh-`x>t_8P2w$Y#46ux)a}qoZ)(v^8@0nI06-B)05LnT zM?+m!v*XBgJxa^r5!O;&TUS#hx7s$tHpwJy@-(fIt$_GIMnV(NW~+Q*Z8uNwUyRCl z(%tTLi))Q9!h4w`l2dre8%-I08)yWp9Dq6G_2E1L`zL&3_>U=00jepaM)j(s^eOltBIApRj&U454iLx(~8my?mmO~-*v0_ zZ^M2bp6A3#Yik~>6JJGh|wk%4kfyz1g+Z%JwZY!-mIlb02dr5TrMHiPa!ey6g z`BAGk%;ibW)#ZpB;Ck1cd`bA9@b^LSC5MNlX(aI$n`G89%7|9h*_{RgyMP(86r6U> zPh#ym#OnpcmZrBbi6*vW8iT?@%?M?7Dt=Lg49%XL<2B(zouZpZTBPrxTgLj~wee-X znJvuhhy=FdO@XnfOS=clDZq$lJBc~S@6B>Q6aFn=Yq z^v_!OhxV1zJazE)OWz21bK`7U292!w+MSK{t)#cQ?enCM_I)}P-IstMk95n>$GEl$ zucFE6M;BdFdV1gV*YF)`Ud|lJ{)c(+&-Sp>Exz4l;^|`2^!u3z77<*(ogJxV=_`aC z0bHob=B3m>Z?A^_AA#(&*JiR}WVN+`lOs9k?nvVp$G^5QUz&Qaiu_|VNiMN{J1#=T zjKuOkg-6$ndgiiQQq)x?hF?5L=VJ*$7#SJJJr5Q7Y&bs!R!UVQ{T9cQD%BD6-^cIU za>L`+sSdNQ_;fV(S26zpWWfxr8rsDh24@@)%^~jHHiCHqywAj+6{q-tsz)}zdhkUJ zymqj}j8#$vU7`S=4&AN8+!KzZ`rY;AlL1B)$#5vzi-eOcr)mCTOFaF^)&v zLhZ=dcCo`S2dJ(t*Y^7H$dO{Y@Rx@f3v$NFag6ukYUi|%irRLk@B;q;!kWIDJkx1* z5?ZwJZ9ln|b(Y6`xm05;B1sHBSdqEF>Clf(D;0&a&>W`T zton1|ukAOi_$R?v{wmRYKVg3q(kkCsUPjCy3eEG!f(YTTdFThGY0&=w!Adm?MG%jI z{vLG)1ANX{jQ1?9UQ_!pUD^1P#*OgTQJEDryIG>MSLr3!mP$l()6B<~5BHgChxm!$ z{X@Y%D7nyYAd)tT{{VO9DN9Z{FBW_U)d#P8olj3Tq1jm1?Qz&$fOQ{@41)#2*{~0BzfRIkbjr-65^+ zEG~7HWS$i$cW24QM;I79Zsc_xwzKiy#CmiQ#d+}d%`Kcal?q*)1DtMF^80S!WAWy` zANUdRdHg%^8%4RA1d0W|jys*F2qSV)i1gu@NCZtRWUt+IN#i?C4jd81dB&CEN&F4toioJtURjFT z<2Mn@0F_xtD#K%NepWniayU7!NBDvJO?)l!U+n9vd=Aw0tGnBm@m8C!_+I8s0!w)9 zCW;HYYq;IoL$FB<*5LpI7KyXBf_&=AwHnb;jniuSbS>9%r*_@WPgeMy;O&1+@|VN6 zHn#|wXzNdeUBsj;-%Ar+^=aRvFUbxKJbo>sJz;&7wZv>gB*KFQ=H&+;~DSY z+O2p$<6puJ0#f?ViuC~;q@9UlBN)#Z`G6s?KA%eReOtsWe;zKORR~Gnvj?2>n#;I_ zVUNyL4HE)O=Ky{@)^kuwz^c@_?%Jov4}!X$rMpb=9oxjG<|e{q-{?r$_2<2HUL5gv z!%r31+CV&8JQChpO4d=E37gGyV7qq&+Pv}e5!W^HgnFHUxdtbUI3odAXC9-mA4=NO zF0}YbRuM=faLMJ#w6N*O&MPFT^+l@Hd!I(%TfwL6No{+nPafB05xuM7v)2ubbsfFy zLf-RCvAj0XYDRN{$+9;)fEmEZ82oWwD}8l)c(&=K>Qea;+i%!rE6dczq)NE@SvObRReV>3eX_r#)kBG$H zY7oX)nl~$u2q1tDI6P!=*1cEZ$AzQRZh^Fh8B|33MR=bhq19522UBvDOj2_+V*WmHR zx@j=YbX9d}Uu*`=!B>m-rAy;DaAM9n4dWegUR$U5m%$pon+3+Xuce%msEL|6V^j{z z*jYggQMQISIrh(ftax_fEmKd9!u-hvyr@m$M$9%GFU$~i4YX$%=ia_28kI+Pq3_}5 z(zWh-O@_T^t((Nu{Cw75W{N2m=ISvdd3=8Y6(|Nk&ravxqrM&t@wSsJu=s`>sjO8- zU~F>v3-Z6-2M6&6yj#S+6SVMGhxMH!#QOZ!@oSb7TL>*Ce=xvRL&m;RmL~+2AZG}8 z<2B5>>z)Gf7m9UldBydu)|8Uy@Y(7K_G_s~Syp9v4%mP@l*p;OaUg+;@}){Gb48s# z+m=Uvccek0YVBz>vAV^>%jWP7cyD3&@m_D@-3wG*Y45cCX4V%B;vx2c4*ci2=b-1O zHK2YcS=?Qy)I1>-%-67j&kezmW-YWUu>@co4nmxOeRE$l{7e0)JPD+0`kC>xP+4j4 zi4BF+QY3410%9k4+0sy~@r;C5193cZwd-JL)sw#|%ZbK9E6n$w7W`oGUxj`YYW^FW zQIq9(?qHS)6zz0y`?5IXWcA|%>0fsK&7ZX|g#2N94~?}weL%j@VT?oet?n6HaNdLE zQ-VhRo~N~bA?hCx^#1@Fd_&S*bXX_TuJvnX+a$r`p3qK)Y{psQAg1;?&jYA9Bi8;s zdqh0uz+mU~BpxKyU&gLprBqgv19G*xg0>6}aKj5Wbx95hmpY2N@+n3`I zRmM^NBOR}kYUEmiuoweDs#?n322bssA! z7&u@E&lUXH{0{xBe`|k@+8(Rnj{^Kg_=BqIwzI9?+Yb|8%QP^vj$_Qn%L^t5B;b6w z9C7-+{{RGZ{i`mu@7eppzZZTY>iXWbbsvtR_t&lI{qe zR>Y0GmdK3P;+c;M=h$3FJsRoDnR6~}Qg24@X4BW!+9T7aR+U#}(I0thJ_Ma?G+lp7 z)!Hpi#FFyDtq{B_3~iKCmQH@@Bp$tRYHtl+d_i~~#^=Gdx^zbI_Rj_KF<8etm^VUB zMg~a8`q$^j$DjBpKaai>{{X>Z{CWE?{6f@zB`%#L8ce?ryfxwdS5KD0^Ut%6Qqm>B zibzY(6UM6?(r(`4U~RST7vHweg}fu<%~M0Vweg$yl5HAGokvKy@Xn!eBgbzP+ioC= zINNkZ<9N)Gj5COoDKbV|^8O{rvka#*lodBAa`QzdmDg6frGG6pZsxGX#&Fkj=xd*e zI`4$MYiHn{8^c0TP}&+MJ!OD#`S)@^OA*Tna* zTHC^xQ*DCcc_I=?Xk8BFNn$brzd9-gkb9P$<6D1+x)dK7zAX6a(_itfoi?E!y>;Q+ zH@Ke0%g+rg3k*#AMXI&5ZtbuIR(IIaHh05U%rHE)vl=cgDJa1>%I$WuYkOV2-*<8w zQjUtpyWD9>X&c??UM$t_qSX9RE6&#TOFS_bke!U6Zdlh~h_F0oCj^!pX0h-~NATvS zcYCJmI@Y79T(pg4b*fz`OE?Omm_))NVuXcI6+tC{B;=D>zp{7jC*Ysj14q&?{s#O_ z@YbcI>o0$CVIG-0O>WlE$@57Pt|V`r)mexH88TF41Hybt{kwc&;eXn%Mg5)MSkq)p zYUk`@P17ZYOSqrOxSiylGDMI@BJ%$LdZn-}1TU4W49fRhn2}bT$NYKOuxo7*e-CP@z1t$urkEbScol^uV0yBYAzK2}uf;Oe(34feg( zn(Ufa*RT8#sfmoz<&v@9_!D06$HX&X;mP&MQv6uNnuN`~+9`M-EEYHURZk0n!w^)Q zuOC?aJZJ~QdsA;2jTY64?_Vz?k{gbI=QZ&M>@nhBh#$45iTqdKpN+oRcm+?sq z5?V!W@>$Chf1{A0mf_c9DVOB~pg=a3`{zy4thD_#bQ^d-(crgOm00H}7jHj+uiX48 z;f!VqolJdZtx`O;x_zGOOL`pj>eG~C%I^IR15?xtR&YO;B+L#lPUc`c0)L;qPMXAa zOfBTnQ4&?mvb>xpZcpR<>l0GcZ*Dvp{{RUa>M_G|mjVeRWhxQIGJ`$x2+wg`U7y7( z-74OBZ~RSfZn$Jyd*F(*6P#>jz$YDv?_V*Az}Lg#Tqd3*?5wD zV$VxW_r*=r(7y;(3aL@+jAZx6wPR>Ho%W>_&Ee6mUDoMR%IGUGn>hKl;2!<@RCazQ zx$xs1OIg)z)Jt*?l^7cx4p<@Dcpx6xtxp7eO1beSyK~`>3*TD{&nn&EF|vY@wCJqi zSe?oc-37quBB@UMog-@~mekeQxeIFQlv)bjg^<$wV}H8{K@!_CvSsr5Edr%_!U#+|8Z zdd-c*vg!s1iv)<60gw{MzkG~iiq%bH!}4FHt@O~xa$_YUlL5*Oq<6~%DNplO0u!q zmS+k&jl}-|I`~KSiTI`BFA(S#I`_g4i7?vun@@_?fA~i9&3@cZ6}_$0cP%x}Tae-} zD1dhbm9dk+`gd3O(XRMsTei{R(I&lgw^=WX$K3v20rSCrpisuqAC& z95BK9WC2q6XW?JNeFw%cc<)N^)KKcy+H95<_n&Byid#t{$nk*8R|VBhah^KY!GG{V ze-D1upAxPnAvfhiu@b>ramfv!BjtIy*E(tufh+B z-xYj4@W)BhqqvIZ%HA=ip)skHEc4sRhLYvoa2p%nf!KcAd;-%o?IYlagtY$v6?m&q z*7Zd2<(brVjZ#Hxi_3!wnI({-s_tea;Z;D+003gX+X*<%f|6VB>TymLV3#@ZulyE| z;MJYa{1cbLzX+_p4awszUrX^GhhgE3I^GvHwzqM@@cHt_fUlBa6GN99P~0nJ8CBP_ z{iwfX9|-(6{{VthjjY(nLN~YOG~;Vi?DaFx))> z_HWx?!hS39&+OOY4-0rs&g$mk=G~Iy+DjTtumxi7zGuov!1;N|Bw*x+E0IyN=xY`iJ;{LBSCls8t z-|VeDE&W`zHlbwCH29103&6h$KVUC~=F3a6(k$=vZ5|yfPM#I8Fd?$@3P%|WN7JSpMd6l;1`wWaA(YWKE=!B{dyZ(}P) zv+g^yzXxjo0BmBtr%3qaYvLaZ!G3I>CBFIO)9#`Uj32CEhrlFrjAV4$abE-f0Kqao zD8=Hvcj5<)E-u|~LozDOH!RYeS~KKSBALyUQZe7G6;&L-j6P{Lub(T}|wuFF?{)ZT@8 z#&YI9gZL%!7A;rd=Zo~~t2ME*TM&}m%QzYH3q}}mw*^S&uNY+qBEK;I0BS#iU$oc2 zZwL6>;xEN71!|Ty5=m`q;4c#D)|WbjH!7|6No{0v4lJHy94`@=MF9W^d65+UxOgM> zbMXHFiv9)JSZTL9r-v?lLmri>YJyc$cWx3`?w-_;6s}I_&-Zr{25X)F0D_Nx*&hRc zXAgs#w}3o#t6E(6lf@bp%vv9ZWz)^rm=$F6rcI8C2y6|~3^QRsCpG$41@N{n1BHz$ z^X6?NqMhxn-n#Ge(DLz)6`wSnlHbqoKMB8L?}{4UvGG1j%a{(SX9O>7`h#jN7flSV z2bZ=tQtZRaRAy20oO9Fa%~Rq>gM3f$n^V+;+AYZN-iLhQEboWfWu7=3$+)mbW>Tz5 z71|Vmle-n;zZXAfpMyRz@gBQ>@pn-0-kGT0TwC6Fb5PLyJZ=WZb!OKEKq;Xo0L zC?!b^lk-=T_*3HVi9A>0tG|OE2)s{Vnh%RSB|JZ2k|vWE(tx)zBLqfEf;WZE7d^*3{{Zau{{RIo_&edB+N;3+6Q9L*%V!>{=TMr;*_q>Z zwz^Lt=9WcYE6iw#CpklqMl0u!jz6{E!rvZ#&b}V_cYCN_X&zsQ?k?w=3!^0K14Rlj zSB(`U1Ivw3iYdTc;j^DB{e?eZT|@o~1M#BY;Qs)@Pai=Y*Vt}#9}(T_I$XvLGfqij zj9u@*Tdy^y+K`QsZd1PqcaJwM@cMX}%DyIio7>6jt^B$qc1ICYOKw&DqP`}>@niO+ z_>J*q&w01;4~_MGM^1`J$dExL+^rh0I0b}dG6$jS*1YG%J~z6sRr?mGW0mC2V{wO4 zI)9v3?azb1;M_mh@52$Nhj092Z>9;5$dY)_X z&-VBImpn=P4Svv?_w4!Owp+{XF_L==^@9tj*vwqPc9_Ur;YeiQqpPnWLm#=LhJ`4o zMpscuecBzf#aEPdXPRq1Dbzo(pwyQB=gxVaGJM6@*um%*Il&y}tJ-`+@qPRYq+NKU zP-{SbTNb*1AbOCQ+gSSEsd6+OGTKO25;W4NVbC)w=O6GI&eSz1tZb!t7Y>lIjSKSa zkGt)f+NC;f7Lq*bl_xFP_NVMW@t<93E&MCtpASKLV3GdUBo|8*&*n+~wo^Ju6M!3F z8!}ji1f193`d7zahkp-zEn#5NHLTM4abH?n!mbkG#&$DC6c!}pvVaZ=I3ok$e~iB# zzh!TPU$TG03!m7N!hRRJ_>NN2Pl&!Lv(kieURcMc2+G|DKe~AM0A}jYTqN*MaUHN?#Fh>Y z?Fuj6Npl9w*ms^zBS6(&_r2*w#@QEfmH?V5BJ|oZyZ+b6*2|8z1mc zFBg1d_;nY>j}Gd3C61qScX2M4JT`A}HM>~d$_wey%(p@0`5}P30Ry}(xTvqZ{{Udm z*%RX*#7nJf#O?7C4KGWuyR%&~dyfpwELzMPL1uF~ife0#WLcq--bE5C09)lK$KtAR z1|ed7jX6cswe8L4ZTp^;JWW>)X+_()*LZis`j)=hmY=F>Hj*X0#%luv;zpWAX)_xg z-@7;|!S!K`R)@q*Ufbd4!zR^yabu;<%Quw-H*>6Z@RGq2R%49v%brF_;O4M=YvaF% z-wu3l64`2taWK`dZ0?&)-q2i29P$GiXXXU?atz}IlWMU%9|`{ef}H$w@fU%uJ{8&O zT0XI;cxqn*%c=N|^G9e5kxg_STW>Z3M2?@ijf-P!VC3ZDxiXFp%rV%BQ=D8}Ue?~* z*^agCY$A1Y7K9H9D5x_%peByQD1VuE3^^!i>R;8Jum(WCGl_K z9;M*V33!gm(sH_p`$gB5NrQ2H%Zy~GlWc&3tTIM$#1FK;;F$javEP7yZhzWx&*BH| zGvb+bIDQvs@Lg!W6S`md4_wPB%=1aoNG-$`+u>ZZw9xsaMncW{hDpGfd=$O4c)O={ z{d7Ef*t(T!dpLG8Kj5}n#rJ@JV4s7Z1$3QO;wYu?$M%)fGRuO^*LRn*M{WIsPjuhw$Pigtyq$e;E2oV95xEhxUrf79f7 zckNg4BjPW?kN6@t!7C)yY~k@I#cPdsN7g(;2A+wl+!UQ5@h! zprnA(jpTsQIa)!wq?MXVD=D3$k?!tMQf?#Wgt7l~o>#owhqH6ee)n}>*Y(Bf>$VmO z`!4|wB+JJ?@!R+KKMlARzKi|mfccv82WK1_dH0if(dzRPoXQuqj}awHvymt(N``Jm ztSrXqHeJNYQ9mxS;hcS(@Bpo9Hetx3C=)tk2b$C2z(d z)Ew>uCK;&APU>>cQDVi;4zv20Y2d9FUW;|es#&K6$F-!!gi%E)amwG8huzy5i}52s z^9JQEABtNPuh(7Ek#MDiz;N`DLtry&o|lR0ltH0Bk#dGu>V>uQ??B_5KDE_qm=&5o z+0#8M(jF?ge|C`hus8$p;++TQ@hrGT?kMj9z$rT)zD6?*eY!kh8#?ztlX>z&Q0w1v zL*4G}j&+vHXd#Qd>-5gy;o!4CJlrrJ>$E*I|5RS=@x3JN=f_ZjNUMb;Bn7}AGf)&v zDLD`Iv3ZY*>@zgS(k=>>>PtBv`D922Be!6)ZSVwza7^aciQ4s^u!Q~dUHg7T;NV4Z zV?q@tIe&y%{Ug;A$h65nJMMXkR^uU=&wM|}e;q+T^#Dp)?Hrsl^4a0JQ-B_QNah;4 zRuxORW61QuuC3!8&nOWC&sWc2z}uo`&DR3qXnEhnQ6F{PT+5O1WIKyEndb6QQ!1r` z1^e7U9hE>D2w7%{P;8k!0wN$}s zQ1?7d#7qY7vVq{6O?l~8qk@EQN!CKMjlj4 zgECBi>jya_eM;9xBK)FLs)fb*^<@xDY_fxQL^d6$(p9x2>I08oa&Tkp0}5w?wGFWe3Z-{e!5hE zMcQButD)q23xBQ@lWt9VDGNW;FAJNT^NJe5(%(Of9rxT4a)Jy-t|^k8V@&R&}-6~=#c%Ue;s-$6{Rf$F+81GNgLWE!rq|p!`f)m zz7%pjTgr9eKvN6eRNi=Z!;7cM=b0af6yxnJTWdq+0wNzkb&T|hfgoc9M}FURYBoiK zRj{(-RNxfbXjSWBG^`+JeRT63j(mG+)wTzJA8mXXugvahdTj!GRGa&)KLjypp2e=z z`;qZj{EIg|#kt=i&gQmFiF8+=+}u^9cx%v)u|$+2;n5J&-%xGt{rn6)=p@s$!;T+C zG)Meki+28g_*Dxca600wBqA0{J1#|%oH9^wD}-J$zOC)FE`Hv8&2Y8K z4Rm`p8<0^Bw*6TzxH!@JieH7%Tw2>Go*5eIENL;C4Q{@2Qz1?-C@Pe)3D>8tzp|Ce zyHr?|H~hH|(pMI>bdfc^M#cktG|{GCBK#dmXBVQscr*XH?Cv`WWjiGMK1jVnZw$rcT9lU<6kE4g|%ymFDR8fz+lXw@`xaWCc@8~$q-?mY<5|GGW z4lDU}%VUdCQ@by(3UiYKbSx>=)SBw+XTn@vdDtq>UUa*!sUtV`b6z}AVY3n!3<+cU z;>Ltl5ku|?Its@l&uck+u*PQ~!}bSskJlRH*4JR5l+a788e!azvnMS~*a8L#v%*^c zkdpSlF*p#y+HlC!;^`7KI3Q4ot91DbDaVlh3i1y%DrV{v9gA4%eJLx3iIhDB`aJv( zlGZ#ev&J)7BvJT55Qk+j?_LNy=6g>2+@QC!s5s$HJI!nbG|i?hW9<~vl9pg}AE=z0 zgSi9!W947tyhGOyLr(0oylrepl_$W$Mb3z-XQ2xxx{TgyqBYOm9p&Gu9G1N_{`vW| z`m^yxSHugETcm|~fKWa&4X^#aM3c(Ne*}xQ>ViX3aJAlU#_>#Olo!RO4`V%8I@4D! z$Z83pM)JM>VFI`^P?rViVU1&cn~HteaoGs(LF1 zp=e$D?=w>@tG{}Z#d%t}*>6mzVO;)M*fjv8h}|u<7{*|tJ==M#J8De#v)&PGrymd~ z5Z7=-I>3|CVbUW0=SE<>Y8~dfDFoba$zi)w9s@?TBtM;=w(4NJ+&bVpP<>ZvRXK{8 zq}m!2P_`Z^EbvVG^jMwB7pA>}YP&J{T=9FnO|tjkWhPE*>M(f;T!Ejmky{MVLMrim z(+zz)C%aO^!!8L<8)lwx!GgDmQ*qM1vshTasmWm6wL%uqY(c^^9liNoa@x&;Q|m!M zu4|ypKy=z7{3V_hqK1g;O%byVG|9QqP)~n1auH=0SHDhDo8cJ=2DrfX3r{DgP%7Tz zZ*#|dGqOPnHFO0*NL#IlUown~@cYtSaov2a8JlvR{5qBiR8sUmGNYHPVun2z=E!E= zNL01$e4WC=H8TzdQ>sVQ)ryQ{xzw!u@tp8D|Jma^ueEq33I7F5SfJz<4;HULBx62) zPjATY@VW-l+o!$rOV5C3+d(rt!0H{jIt%_oQO|cudU=9}??yrSi-cGkOs7Zl(`71w zy^`SbG*JR)$6oRRpymZgt^ew(H|L|%B~K71lIR%%sY+Z{!>KmcAi_`0pH{xgut*a% zDh z=`?Nm7(7F(s`;5p!GB5`4)I)?<}DdYEvEVqR-Rc@d^AXl)v%nau?yXzvg)JAci13h zaTuCehPkcGQWXZ2+6p%tsQ3{k>I9v$EE+wIuH+6YXVc^-IOD0-c>3v2D(JOVhDm)} zn*lZ1m-kIjc`lfRru&BnU5y!ZG(H2>8N}rr9f%UN?1!caOGC(n%<3OAb9JRgMPE7O zsSrRAz7n#Q;OUwv5n(3l=|;$Jr$=Lro?hoP%jwhoZqBKDHc>tAtQqqvG(E*dX$R&XInB?6cECwurvbrADx9C`bJFR}57)^Cr;`hCUEbj;Jj99DwL8cm zTVh+R^PQrHEpwe6v5a#pf&T`m+tUgt3Q(GZVGj|6q1$Kr=07z%#|lO9mdre9f|)}N z;#$5WdlkJzYYdCf`;>;moHR>(3jql^YwN4j(IvSP2PwZ`Z8P>cZ4QXRT?UH%mTf{Yjt>=}x)wFq=d%``55stv*)e#_M=> zVnD(EB#$euXv;+NN<@#bwK@LijQwljz%XI#TQb=PdpWNe^tL7w@Lbr$^GOc=!E5VH znA?m_Mtyw>mlRBMDd06-Gz`;XwkH*^;3oMoiDE9Ng# zj$enQLXAgRONONP9eoeU_wRn03Xb-OqkYU7$m(1brM~AVduOlQSnpa#?#K>t@bx}D zi+C1l*3guF8LF%7vYm$$7sl)SMEdvK>+Hl;b}+MiC#?<>p6Mo>U@R{y%k$6x zwRYe{yS5<&3nOif{wD%1nSDy@@-wy@!(&k6QlFw14V13`x;Y&&#`Y_Ki{+>#??Xn@ z*2>v_{Dk8QVYa@&D3ob6Fznp{}-v8nPdih8(Ob{7^0 zo-1jaz0{SVFIx2wdogdLB_diK(=?pRo59Bq`C$KJKNf7{UO3FN>$RGRnCj;u344WR z>a9&w7RWcep{gY^Tko~cH`AgJ&9{-Z(jv{JPWHST#aub*b=q-bh)n`!KHFrQyEFfX zEDSJl5_h9L6R2Qbn84Qg%e9!C1DD;DMgCR~nG3_rF^Ts2hLmQ8l-I$-K#nP92EW0{ zi{=`POtDeS8Ph^}rny!?@=9;daxx*jB9B&v$v1xr%YbPrIj!i%xJ_t!ka-wXuo0>u z^ZOY?OGF&yD}x_zTs;r#&GD0@TM4h}H*Sq$s!w$CH2VN1(8x)T z=YN~f_D|@KEpu-fG;;^wFG|E2!DlVB>|dKRlqUH)Uel^v+jmCpFyZLI7^&M&AjjL# zK2{q57e2rmk;ySV<1a?`5&@~NI5vGfP`_q1TzO>jp|4NCG3N+;et2JvRo(LK5*LS( zEt+~KClj4|y*UgJeiT5kfXXAgZ!PV_QRtyxsnH?L)4!RizR;-CHp@U0hDyTcF9Vxq zpe?Z&$O?=I*qc4*wB1f|>wi5Rz>Lf95LiTzDm#rb$T8o1_*bYdDRcN`c+!RsJzyi2 zUh9RR(epJ^r&@CN*3;rn{q$St$cqc7w9u`vF|`e+BC+e3D{T{9n$6PuW<7Qx&pc@a zBn1Bjvvbww4%}bZnG?O55M9=nND(~@?ksqxrMM{d5!BcHt>Cv|%)x1J%0X)3XQuIJ29OL1T3YQX9KC*=|iYu`UJBvNm*J<%j) zAy`7B0S)w|VdhvrbU$#5&|HcoDARO#a1CAumeL2B{(aad*M&K@7XPHv$@~(*l!!9)j zvg4i~HI7Q+Jg~2|i!iK=?5<55P?rJ_yBLF_H5;! zM$y{E%xjMQ$pjG&z=SP=Q@)MCvq#LXUcyjD&xl{Pp>&6%N|Rosnfz?;YO*%7S)k#S(DP2&XtM0^sJRaL?W&*6*DMH3=D%zt zvHIKaHDn)=L2E}NS{OuKJpZ_>t})#?k*_mHNS^02!NdNwEs7tWuPC-94?%d+-5W4Y z5?-I^MT4_h3W%g#bu(oO`rCeL__!#^;c?^Z>VdyYnj+ORd5fD14kjr{+KHW>(kXy= z_3{XH0taN)I2*xfHvRdBUNPSNl2)&VR#Lia0|ZhX=&E9vtvu}5gx{N;I=PFZZOQO+ zs|S^6HobYc-4>P~)O$;HJ$!mTSOei?{Mp%B-~RmPE0lbp%@g{4?>_yHQgwuhwTA^7 z{aCBNg5|OPYX%2@=f5(LE7xeBJv(h_uIiJ@ZEP+-Ho&iRlVKGdLQy(a*rINMr7(x8 zqaaSUnZ`4azDh~o#rI717=%H|ut1`!j&KE=H-8!>@WpLG<1m?6UC1`qN+iakfwgH0 zsP{af!$#{hOxx((Ca}f`DSH~qrdFGWs2R76aSZ}!F$FpR`5uA|OUMI`DKD$c6E1vj5 zxfR~b#D?~t7XBMo3PyQnr!+e5^acU@;A4sH#M%rGhQJbP+~d}S z{co@yy0MwUt@pIc^B;boWz?6CfBoAMv?G=T+OEVCE=p6gK|}GR`6zX0O{ac^mQT4Q z?%qOGQw{~Fb%UezC+xOZ=<>ms+aKo6AY&>4My5wNK8i?@++-5fvj z%$&9eGvuY2F~u=2!(LKQXjc&YGX4Hhxg>2@qmLAKm4?WT)3H=_YE!FzPVpu>>Xh8c zG_^eOmWlF1|4?~zvWI|IbBAm55as!%!0!mkNI+9|RJ2`D!ywV%L9TbUB$sLTdds0> zeVI^Oi|Modxsuu9rR|(m(sx=W^5)WtmaPX`(W?ym9wT551o_^nPc-y=jf60?K*)MD*#cYQJGy&O?zk9m%@(n7bJhydD=ao0^mR|J-kg zat=OK%vCE&fAjGP{5@aHi@0T-{j;H7F` zSwDKhIQhzagZHOxdH}uHfztiwi5$8EzqAh|XbYRJGba0A)9lwxgUi{uY=_{i@a;Jf zaKADIDs6~Taj0c6Px(ic8|&lAT(8QXy(0T{i96&ktfB=IEM3<=l2e>7+$d)8a3@~l zl&#;7{r+yI`J`{`<+l}o3$gTkT}7$>PDqf`cc`D$OzofIrZl~!&%c=D)W@UXo>c_wO90Le78e zg#R7hTJb{E0B=!X1NCfYivhc)ftHQit)KT$dbxdOst=zo&Dbz>I?M9bd?DbS!0Y#7 zRz>jA>Fq#7z$fnsU?b4bRU5>1b*>yol$LBan*LXRur_s*2lY2Cpf;}lNG9_)Cf6<3 zU}a_KXHtc|)_!1-v*X+MD>HW$Wd`<_V+q5fF(N?t!xEklVm;0&&H1>k3w3q=vbGn@ z>+F%arWAiPIw-2S#j-lKpIq^)HXY=S1W;kL-5mHnPC9HZSM*sE2N;ps{j{>FT9u_( zCWmf$B7k*d4>vnH`%S$z%5Yp0BVnutG!vsdY6n1xo8-6O@ed=Wx*wuM1}ym6cJjOY z)L0jikJwqeIx*8$pY{XpHlp+_%!bTkzS9!t=(0HL$A6`+D$7i*w1&)FTTWMb@)XJm zbszrzj{rwUy&aCv-4;vC?dCxn{j@r^WewBf^@8|yIOR{V4HHs+tSb1j`|vrz*(z}d zwxMq|qW*{LqPQ7JRduy1)&kzTA(eX|Y@`cJdq%yiwnl5jwIhEXgABehkPWf1X#;sf9)lz`)bhvvaB| z!akcL;Lc6meZWTGERmtM$0+oUtZ;Y&(N0EN`KBp+qdn3_gO9PXaxCYDMfusnl?bOJ zs`kTWSwNEZg<~vp&_4qyJMrLNHnZJzc2lmMsRu{b1xv~t3uO?<2CxY)E1i2#-EmLr z8L2!dHFR-mPz%{9RpElCM2#OHU$^P-`0);uq}KA>2b?I1+@G7%{v=ZnrA;AOBbJLE zq7H|-k{@6bcg^6@{dgMmE6nPvcFZrw@Mqjz(N6G{=3cREc6g_I-7?~3Cil|7&J!Ju z{4qjZn-cqyDvR+g1 zEAShUKS?Ft4;lom@$aUcfl(1-JEtf}yY2f%B%P&t`+GFU#`&i8Ki~LMzK%yEhj%?h z$R66IoR-j1U&_kHUWWD{1Ih=69Lc#|de@&(g_>^J$*FM|k~+@jc^<9&aP=_0k_Rmc z`U{@7T8Et6hNaQp7Um9?%}NB*K$R!qkk*eJ__tjC(KBraa5?yPr7iI#H50H-ua1jX zdRDgO1`zquN{#{*66SIsCnCy!tU^pf7W3jJWR?=`8c9woc3SPC8}}TO z-_lIzKN;SG{?>+=%JXM4(s|`o+-{!&{$+worw6WpT@yc_d zH9&jiJo{Q-WFxrfE$4Kv44UPWfWbJ2sS?&~p{;`Q zfCiusfGJCs5fQ3bn#i1e*Uo@kEhSzOcgN2rxMCt`=l=sD(CeJtjabqzvV?Z`mHSn> z8@*k-exIBiE(8G93%HtzPv>q#BSvh=m6`D~F#5(RvJ;?`G4^YXg-mt(6WghI=F{Nj zU?1hj$@cCUB~PP4N#lQ!!(J?iN!Q*3f`+FlJ2z~QyDQ~Kr#w1S&#H^T&g4yDBj^UN z$Ffqe-{66I+d+}+&0IiR4)$~MyZLF#9iiGi6i}S)bn$&jx^UGd5SM%7Ol`hFhK(%h)<`C(G< zWa8+c8fEuen`lqnF!YUDWG`Q*0B{bsS&DR-B8!-p=;u!m<%W&c|4h9Waw%>}CHZEO z8b}fBbAd*-9|*^gMP(Xu+qEse&%WQ7ow{3Ja;pF1<=@MqEzP=b zK)_G@dx|<@=05^LJULWI`?e?m$zf^T6c>jyG-`y;i3$(6vM6r>7G zfxu$-EnPv)rYTC`a@Qg`6!3%KQ0{8d0tu6D`}%P$DS@Xgec+~AGdr**!i43Yuh5Y# zJI)YWyt5%8ofZdY>LjWjqiq-gS7RffHJ%R~_Ou?hy^bTQOum|w8}xSgIWFq)WQ@VY zG|}>DZMoOEjDf!+lH=-R`5d-9hnYlKm&b+qD7WqY*kWCQDqQHydWNZd8Rj@uEH!Y5 zXRfo(oRB!Y7yse@eN~Dg!y7vsQ1t_Hv((i9ngekpc{jTr zto(+eK}Fu2Nsx*Ap|e%kkIEZ8U?_We#YG=RkM`=~Lu(Ovw_ba6s~w^*x)DY3ZqqRZ=7{L-!#aGA7|*MptM=+7-)_dlM-c?njoF;}*@sBp?&+dCAa1lo^Nyo);!vU|zLf*vy+Hy=Lo9Jhw=;Iz? zv#3&Iqvrc&=ww8965&9A#AUD#nJL5;%M`+F+$-ogi*zV+~{hg=YDq@@ObctS)$-k@a=LKZEct}eV{8kYV#aK zeoQJD9K@7<%w)Q$R^dK$-peED`1TWvFY}j3)qIS{ZDB31dSnc%m3uT-yCh%47a7vO zkE*eBm~bo`Y7U|P9_`o1dEZ5PiV`Am9P;Ytac1Y6@x)&$y32yU&IN$}U!J>no+W;s zykE*ht`(N6#tPM*uAG?gk0@ij=Vv=5i({HYnD*f^~MLxWK98^^ZG78IOpUGryg z`H^6clbC=cw{pMz<)oE9og2yAN)t)4r6nHQ8wyqQA2e!biHinoIfA7&-1!G z-7T#DRUhBrH>uZ$I`rB+OdGF_w?*lL?jMU=ZLC6<2GVUc2iFYeJx$JPc%Rvr^U&<4 zYKe@D@UwsP>$k6P`_~k?^p9p_^>ju+wjiG<7fipzb0k|f>GTvyo< z`OS13(0C~$F(fxal>R4@3bdUY@c>B5x-&uM z^7i-nqUL7;F2y}Nm52KJh{$EwutJ#c2383ha${g-Io8pDPT45!&19#w)i);QjvRY4 zR~=wWjQ_usVE_l;hD_O_T4FCZ)a90SeZE*72QmfD=%rR4P`27zy8N5|!Jg4CC*9@l z=zWPCEraQt!!rR_O|6twi>O(rL5lYGf`Ba}T%&HSrBrAiyq>EE{yuL3-dDRC)VB#j zNq_t8<0e}V9UUdlC-J`t)to)o5peHMN+|hA%#BAY&BgC3X4hiVFuo|;-V_ttIDlSe z+AE@)Z-!b`V;bNPJQrca3w;vxaBS5qdhrO7{AlR0cQ^PmPmOA9rY)WfP>1eG+!lje z{v(KcjeQ2UV><)&qc$xjD$O9xDM3NpI$0T-A22p=V>lcL+QDQIZ~dCP!6?8Aqi8fqv{jm7<@72D;6Ok_hY}uodANCGwrs3OP0e*=xMHqE70$+F|fQ^2= zs04BH366BAg1lLyWW+D5@;Bxzb9)cIDK+h(6G)Cz{MoH`b05D5Trb!lk^q``qlw)@ zY)}v61?;E7Jh%p|^%NW1*1vTA*3@`tm6iV2j(kX;N@^MBh?PR;A&nG<`;pO$KV5St zGaoNzSM@D1={7z%Mr900>F_j20y7j{`Y)^;xUJi~puP3Gc#3&|SI+2SQ~sQe3lhS= zWL6vt9Tid6+sKVC<`y*FpfE~PHHqch7G>x4>$uBnkeo2&6Xa~cIG8lKK)*= zf9Jcpxmh+(L5%`C)^r$zeS(3b4-tchDb*2dmPf3tRpKtntgW4vUrSd@v%BCciylc` z$;eestqIz&LW>euj*z?4Od2QuawPDOnnn{h^;}RM%1)5xnWo0`Jry& z>OIGzfP|78xyd^@FF)QNev?|(b%J?@-A8lv+A`w^caV3E?XI3_AYgH)L*L>}%#@cZ zEtX%6f7z~0SNi&X`|DekJ=584+W!cm!y;X4f%5}x7zj{DiSV;U#6=$DCQb8Sa{eRG z=t%ze@zu{@b)adLT|j+=$UV7K-|+Hp4+zWa)lVI@)y&s&qXmr|n$aq?cJsA8QfAVT z284|8{?W`j>S@7o-c=e?k~g53q)@7A1xiB$xYK_GRNf2yTBB%XMYIucxPiNaup)8& zwe&c>MI^G5e|su%H7kPtXWXN{F}=C3@X!1y8h5m87B@;i?!yE-ngs=MDL3}m*g4Gn zZFvMIxMic!W`#ZlpmTe{2vr!2PALcNu;R4=$k94KqhCVYqH&M>}ySKSOriL zx#6{9xf3*qq{G>uTLxh<3V~fEuI-F5J7)@01A(tMdic`+)Oco&X33BwK9h+4J1OZc!R0M@w_!I58k&ak3Dw@86%=^(*a-nx#eZ`{qpRrrZ2U zoz&Zrw9t&h0j9h&bbFEYOGr`WJ0J3((T7nR>l-=yZWZA*0C| z(c1ERD}BWWlZ9@a`r*JB04{|I)z27DH|JP~-?WY%~Bdq#5C%VVwEb8}$=da{E|xDpzi=O>}z z5yGd<7j?$q0}8(!S(xN|V5}`)>BNj2==P*}7H?hDD2IiE8pq3H%4V)ZfwA-zw&@!- z(iD4k69oOXOsTj--1m8(J!*D+qhaz_8@K05`M2Z(m?Fo?MKl67(4{jNQrX?n>H0XV zbGCsIoSkZw5zL#Rr+LWNy@oPP>g2h32K?rBUmvb`SnACKFov{b*&LIZzMc_fSeb&w zx??kPgX?sK9$-UFvA2MVTAI(Tt?H;oCG`#tLAN2T##Kl1vO)a+BKu>=BvPK{0=Jv~ z+|{wl<8i!nLcB;U?c8lvZP9Zv8NW<%{M8 z(Z?c0j$*GNoWUHFl81@@%eK}9&F<=c?lt^&)crfw(0i|v4ec1nvyyvT)) zyZ4tIp4qk^TaxCaMpH`E7NdHnvkH%{YU2k;rtZ3bC=iq~%7E?~niF0$Q=lH~a&Bo) zB~Ch!x}N<4^`{#hChS_bUhn3O%q6$52PxbN4du3H!B)hje$vZlMyf4eU0s&k7_EAi zNby~mJfYco;~MUtQ~oqyD2F1@yqS1Q?IAEVxCQ((AS{) z1qB65!vve=>n9O#G#xB^hPo_gmB6>xl_AsWhge8g7hkqS2sJV$&OPaIC%5z4o-y4ez zF&8NpnAjh~o$FnBGz@xbt~fjGEA*@K-{#C}tDZ-y7*)ostYK@Ay0ceijp6)`t`vYJ zKc%HA!=IP)pAve|NLEyfZHi&kb+zAWqFtW!$(9h^F95gK7ErS;6khany}y7kukz)C zKbvK%$G@zxcB z-Q^dge@Fc6NiyN;Q1|2-_2#h+Ao|@e6kM$ImA<;LO*? z`HF>78mOj;Q`*WLj8lTT`gYQY+$DcvZxI*86e;(EL*ASb`Dc)try1&EhR071m#Pb$ ztj#nDCrRXQUz&TU8Fl+ERb(_1@EM!@!o7Ucw)9komhr~AvE{Au*~Fd?tVe?7yVov~ zc&$k34TPWlA6-J^CFM}dJ~(`)QT6l{6}U&yVX?N&JzLTRsRu8HK%)T7E+>P7A^sYgA;GOk0uJ#}6E#t!LLL1ko_5K!vJj^jhi1>?skRr3^L)$9(-JbZzrUCW9%r4Z$PD zKxLxjb4j16P42*&46Zn3Wz?RF{X*3q>4S@67!4^~H%Z{yG8J`~M}lWf9KdSw=aK@} zH^1#vaK~q5afth`?Pd_hO0juQ4XAI=7n1hk3>^!r9k}#oF3-Gl^v|X^+FwdWKQ0j; zd1!J>zwgs#Irr7-u+%3{3KVnJsola_ePR<1a}*(pIQsUuZYn+d-Y0hUfWNgbf$X?y zU3<<+|MjJemhb*SGsz9dwI^HPDStQN-J(LR3$ge`g+EEVH*~u?ES#3*hCK3*MH$Sf z*g$eUEWe-gaQl~hH_RE&z8_$+gnu~O_)GZd6lFei_U?-tr_1pVgvrd!-*;CmnUOX= z=*|BKhP?b75W3o!1$H9($dx)~)icGRodf0F44(r3+Ao*-6sx)(^q9Jpdl}+0ve|IK z5C>@ugnn;jHy_p?8glU_l|I$(sjmvjdKDqNCr2+&#fe&>a#gn8Y};;N1S#4!@oB5H z6q?+;P?X!8zW=B6!*|afy*Fu{N{qO_(8;-&oBQ|gMN-O|sOK{Bp0{`P`(=Q;5!4H( z4%6L^Br}JCZ#?*-MrqhZ_+;-9zf(nd%WW5BP0?aml=MBD@j^3~6Y3=SAumJO>I@>| z!&-?MsQg3oo;38G!ok+QXN>1lZ{QiSx+9oE>%gDsy{lH>#KYPM_LpLbQ?Xb1LuqHZ z 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%0D9`D~<5$15RRLKpb~fLX zs%IZs$NNl{vMTLe;YSBN9CgpFGEG8B$w`LbSYu$@kMqS!T9i9enO;LEk(ryY=cWhp zr^j(|Dgd#_Rrn2n2d5dSeE1-PD+-YPo1bo@@TeueXq8qp5s{LtGxKsd>C>%lldu}z z8(%wFw6>CVjTzT2LHT}Rlg2ZTYW1%eYWgLnfn#Z;XhLuFgm#(XU?&W4T!J?8%DfJk zKDFdJET;N+E#5%lNt6_X1tmcl!Rih_JXg2)x8Y8uZK7GWnXK5{*~4uW)ydQD)?$K9 zffR+w1ve1ex)8qg^BLQMsSbHtai!#YZ-TU+1bF`d;nZFc)Nl1I8s-}%d9KoA-*7^( zH&MdexK`QA96N5|S9z>Yi2neyw}>UtrPefEO78N`7@qFqOuN(qz2qQZ%pDO#Mu1_K3jBb3I%M8zZ>1F z=vo$$;h%`tLf=?hVI=oDgx1qTDJ*7^>wQsj zm6nDFgZ}_yO*i2dkq!5UHGNM|*7ddf4gB(3TRa*>FAKEkBqn8H5PYM^gv%lb!g*}$ zMGuSGCyBH+J|vgoCAW%i^ypgNFA^Ox;t#jQ9PXy(LL+6kUz%Sl1>DA@94Za6-25ND z@n!V3Hy3fPk7;t2dWH68IKa?;AycQ)T;8kfxEq1l#wq_D^Uo#P`cYt;3B3wXZ6UyDuC zF0F*oUBDXV@);nC+#x4=$YTmrv+g@ta3WH~<%1f+e$b-9G+iR#L8R%{zH3jfK^>&G zatR(V(U68UfnSXIu0n+lLv3S;tNd5^hv9uvCisJUYZTIHcNf2Gwp9>ZBn4D1#bz;* zR7O~hth>*c4=3jFe%}*a`xP5@-}E<7vb4878$|J>nw<7l-Wt$lEp57M^`7S0BApZ} z#PG{KyDJCGj0WXUVJtxmr1IaiZix?uwC@N!+H^^%-)M1OU!OWbB(q8uW^$!Kjhw$J z^9~ofa1N6_TBJz zg!O+7=^F2bY^^Ruor(syw7!OKHa{p0#Kki#hY^6Uf_MR4l}&z`;iezzSm!y#E3SrE zicVD7@#XZIrQ}yhe;hEGcNKwS8&wbRoP`Qh9=Rm-BBFM(TYoZrAj9O5<%~9P03not zp1B)GpzB>njyx+ik*CFdiAr6=g^Fo6lGwovylopv`B?o=IIdFQU&Cy+*7nM;7$68D z430B}`A0%VI2}3WzoMzmGlFRGY}By(RM;j~X&d^J6c_8P2aoV&fkz~1&R*+YQs!wXO7BP)K2g#F@uFP{90%s#A`}QiFP&%+@l; zb%QZbd*h{Au#Vyf+ZEa#azMy6tE}ldjk{u0k0c+P%RKb=thk}Ow3p6XRb?&6^D+Gn zD%-jUnvq*-4#H0>Jax@a<+*^zHk{0J$qm+}v%YCzQY;@FXKlzl{{Y`2u0wsM*?gD3 zYTW!rqTLvNeqjDp#@44oZKEa#ZXp?1O7r|p%|m-Jw|%asrg$9Uw&m3=fF&UzN&C`8 z&rd}yS(i83dpKuc+3)sgfghR*sJk+3*+^Zq>*ipPM;nDwnc@EHdx6kag}$SrLRqe7 zSkoP4aKHKy7^-)-+5S)aFR?|Sw`kZTN;%2-Y9kaZzd2k3 z$p@uLb8)5Qgt}Ef-8@xETG~Jw8`$~(0Bmzwsa+Yg(MM6Rib7f;(DW6S*3AUP%MjV@ zde+6%j1-YF9(d-mFBq0!93Brt(yHaf6_xb+J$ByrQ-^iCv00e5Hs_4-{&=qMPw>`> zYFyG8NtV;bshupEc0ngV=cflTac%49FE7n zfBM|hgq7?nv2AE{66g;ambTO;Tpj>^)W*{9_j0W3`?e9?A zYZ1JpNgn|6NH{;^Tkeb!Xlh#OjJsC&3=@D-sXSW!tlO4oPd#vXt!KZtXY&=lqcq7c zqMU!M3P)CXFTm{yB+ncs$w&NfxyNo9pmML zsZq{BrtVTjb=NLYHcg~S*Qgv)F0C5M9%~ttW1(D%vaG7v^Kv=hoN-fT%&v0BjsQ8Q z9Z*>mhPz}=)@c<-s!%oCRRAX*vBWWg7O(h+<{WZlBJf>=rB* zy;#CWgM;f&3vnXl(=1Qj&lQ~W>(Mqwo46k8f2B99sl_~dq_B}&9Ga~9gk)vXPCGJnq*~l$dXuRL$LrS> zrDuN93^sB-O=8Wd+cDb_VS~@fQN^y>q@Gc^*n4GhpQR$~Z@tX!+mrx3DU-;rZ?@qT z(YPZupANZdqimOH>_O(4E};~Me0Pd-(=A!cL8oIcSkqq0W||koEKV0ZilQFbmvXao z?OT(}49Vro7;t&Xtn1wsE!*w3P`4-NLI!{O^@B#SmCDxln-1LPo-#UA+4Ea5x71@4 zkhQ$%8BpYPQ`A#gnQ$;h(SX2I+Q!7$j5p4wjw)}IL>??Mp17*cCJN%y8ZfF+{b2)t_TVCcU4l3HvQ53 zL;=$Wfu5B$jl&t!ZQ}0`C6)G)W>_qQGEE$hJc_JA zAc77Eaz{J?+PSJpN8)H#>du!&(rn?ANw&1s^$2H$6<%4cqYJ#TciL1dF#r>caHH`Z zc8foZZTw4r;GJ_*x3Rp_?N65ltmyv$X+XKiBw&Uecmx$W_wslr(e%R6_<}iQp5j3E z*DrB!%wow<3Hh2&%%8o~@HVaV?-tp3wD@CAiWj|-MHhEzsXe+%C3R+0o>03KB$>z@ zVEy7Y*O!T*2{(4O8*zFw)ve(0cZoDertvqzuZlhx_&zNz%T>Cu)inFXhVkH?)xOT5WR652mH?GQmMmB|&AT|RQp?6t zYTh7@IlN66yN=Z@VYGtdn2c)M%VPkz1%Yqk+7D4%lKf)Q^_Zl!@jKnZTt^nH?m%p* zRWX8+5C#D!Xe!@!ym>;jB(%EhIeR3uRx#x9MVG{n8%M49gU!3Ogh_RKJ+_~+NmwCZ zirf?P5rMQQ0P)V{?9PkepBDIX9ahKT@&3y1$l5qK-YPkR7`fnTFCq55Na@ zSm&R;)VvMieLBa(mQtm^+9LDKq}D!UvKY>HrgMVPl_iJF0!xAb$i}wQ-set_#J(83 z)-QB%1-!bYj+42hg49a!M6v87?^P&vs)q&GlY$7=qJ+|ExHYoXFVMnLirDKuANb$F z-VOMZec{7laR#L_HLa{Vj13`K-ZenYhZq}~fL7q_Ry^QV-+}yBqj+!PCDpE-;e9DC zqSHcZx{-P9R!3dTRPAOUZ9)jo7(9)?HyPkh5crlW*SFL3DI%U(e$RILlm!~h!;+>z z#3ITAD`C0A0i2Otr-yu1s?G66Ya0y?H2&Gv;#M|xVda4#gvk_>w7G|Wmn6znLCBSP zCl%-7X+C*fZoixSjp@!YNu7?pstr=BWbGnEIc6|dW|mH>G;3M))dcr zj~%P+9&03opEqoxMkSk)5d6V+957f2(yX=S?3*HZn020W5HKa=%rrp+N*zy1*Dh3p(0IL^l^dCR`clg;SjXomkI`)k%qkXb%*B24n z6(N@(V}PV%o(4UD#bkU`_|Jdh_!`FM>7y%mB#^}uC`e#ok0}5xv|#P)xTpcU)?dSG zTRXRHdh0|t5X4=i`$fA*fq(;XU@?)rJ_!VcI0nB&%W`}!1$}CC(v`MDbth4K#^=G0 zg_`e(ykDhVzMV5eJ<*<;O4At_L;)-1#t8?C*zs-59wqpHr|4Hd3j*m{mZNWJplTQTY@Pega&ErGt6R-A zo!dz~Fu{89nNq>o7;k8xjFwQWuBU_Y%A+gBU$h1P0E%_pOH9{wJughSo$cz5Qq+?wXx|xbH2(k*Y91=Lwu!YeQY*P^Y|X8j!z70@G;N={ zRRGRO$mz=tuS?YYeR#>L-4C`vZiks}vPTmosw(YN^8w_1y~ihmSO)0dcxu|mPSI_3 z4I1utg8t1N)XnzAyz=utFp)-~7c3hanSmHqU0)IE@@YOPmr1qN;k11^?rFZw11zm^ zZE*tqh_ex}$Rl9KX&i%qaI7a0PMunxyNtId zXW>0R#y8sjqO#gtSP5aZ)Zn-QEp2l9O0$8ni5pz}#FhuABhY+1WpN+;BpNTohtNDP zsA;;Q-dx;V>t^2W2nz#?c;nA1&<&sf%69$M#Yd%lPK(9fCKo!pTFrAM(_2aQkdnM& zXGlI~Q@t3VayBW;VO(IG@zI@X6K*&2*YfCRQ<_a^U~6Yc@kX0$x@dr`7wt;NY{{YH+siRpunB_ScRyZy4 zs)5yy%u1XZ>@IvK;!g_vMDuO5$ZjLkp}B_c4PGXJZPl7t(&Z!bJhS$9NQT3?O3Lkm z!{zUEpNIM-wbzQZZy9_Y(Qf3tj=|eZy1!`RMV1LR&1&e;mqLgcf~f;6aG{y2v+LC8 z!K$gduKMrh{$|wN=FUsS8b^jTokaM3{BL7%1QvU4^nE(Z%!+wW%7mx@IU-yrKu8Er zIXiZIIpFKPW5w3K1@Qj>iRaKE(rqKRmVH9PNDaR9+F7CpcgX($X8_1XRmWn$_mN;X55N#WlE+NHqN-%n@ia5;SV5hK~WjD40J!ur}VZ*QzwX%SBarLglKY;sDgm)hU}N66r+{HJ|&)~?{x@a?3$?Z17y7fOn^ zzE|;Xsi0b2Lv!K}gEu!&Op#A+Z?yvmVdO<8%CWg%5112XRlZWive+L!e$!tSb)9bF z?@h5?D%##w5Z%G2A&4_3JjMmSb|s=w%P}KvS%BPnzuGs%TCa!X)I3-`LM6L{SG8F# zrMPKc+5r?$05AgX;x;=+-;5|AXLriq7Cdcruj)?~_4s*h?pzPtY}`u>@!KS1=jeM^ z*KoE|?c}Syy<7au=T*gWrDS9HhgGl|gwiZVF#Da=BqVP+1fAI=^UpoH)_dym#--3n zDj(uj$US|2qw=h~twhLK)+`X1EPLm_HJzz=ni$5$neT7lDIBtzM@YJz zoz#9zz$V5209e@1u0JZsxwnxo4AICjzddoDdh_(nV8yPRqFUc}bByiab4qoaxZ7cj zxF-aHeMM`?(Tkngy*1UuX^G=U40#IOJ?a?LDGsXTSA_%vpUlEr`U*v} zwo*e9>z|r77!A{oDtne#EfsALD*{U3@s6EOCln~y2A4FF%&j4o^V1$?e{(!yLiUO)V=c)-suc(XfHB;4 z_vW;WK#|gTN{ggWf$-Qpe-Cf-(xibB`M${&!Oxf(V|LrQyK$a4^{Ua9pXPZysW%2i z4}ha5w|>;e=Po-YMPUi22^tr9?qWfIy01^z#jGX6#_+#AHrF=uz z^;4qTXqtYALc$ly5x1Gj^B~}4DFqKsKpgy{ythrbj^gGded^5Wq^bL)kTcDDm&GkA z)5D(+wC#4+S!Z$>J6&PeJ1+E3Fcn}zh5qELC%Hh<0ptT)`tcpyswb4WM`rQSrZrbRQjfg4KLWrb{Z@Tlj3W znuf1D!Z=#iXIqRW^@=vard~;Ink+P%18LszPD2rxoMA;kr{-xv9p9MuKCKy56yr*D(AvH&i#G1{PgQHJz1W+aZuXxwj(>$#+ z#cecJ4z}&Jp=XYKb2@}#;Hvzr@bJb>#YW3}r?2(obU{>c(IeWgem8g*$DR*OBF|Z$ zPZwoF&u6V)>{nwHamJSkm5q+m4%TH?4l|N*Ts4E)>pJb^w)TE??XH-S>DL$1Dmh}p zK_=!3yCZgxGP0}46-bbBYl?&6ebwf#XQKEv^2uycNv5#VuXUHP1g_?2jPk4OImQOo zKsi?6k*VOX4ftnDvunK%#mQ-?TVEi#(X}L!d196_;bdaR2u>K6Tq)m!^8;DO1BJrH zxKwY;x813H@|KMq{{X;!7g+Hp#XBUr()5Te;kb1@37Y63KjN)~I6G{}PmV^tvokl#>zNYngJ;$H&l zGnAKDyPnzPoa;7EBRoqWl@VcQX=U>8OmUB#mH~2kuhTdHyFf(0I-{ipHn(R=r_Dv9 z^P62B71llxC|zPz)b#a7dp+UWB3Oc41}BvOfB+jtcW^-STie@Dl))5>A~t--86bhd zIQ8TX-Fc>sI!h-FbAY!zMb7NwB#@_`KMG*9xp0z( z*d0NH7GucCAgMS!4@`>nRg*E?s@8Ja-a3##@}F+_!!qpy01|tXjP^gIp>+4mp`{HM z-gG!1l6!UJah?x8)i{R!OKGmI*?iF%Wr^e@vu_K9>;?%ueLB=8^HjOI0_N~aHjF%E zvJruW+)2S1JbP7cg!Uo0TOBJ|v$?a0B3!xHoP(b)KiBGWUb&_CZrOCSzO=*niW?|? z_x}J|ygOgiv8+L2yrd>lPgA%Q7zKN&f3rKY=_+70s9SUCg+WACwX}U@L0! zXEz&SjY#fDuBbb$&S@(#$*atf?w-eJ1MdlQ$K_Qnd|PX7`6x?gjAFD+jg+vmN^_q> z(x}~db4hmEcQD3sO;WlNQR-Kl#IS7h$R1zu9!*%b@kN_}Rzg!9Hkz?%r|GuP2qS@Z zk&H0SO=)dq9}z%{p4i1Zwl~Yrfi>+tfh|7Vo;Ms+_L`Nsa|oC=Mn^y4PHS5-+<*z{ zb5W+9r7Yznw}gYp&MH*N<%w_YGD!abDzG5*6?W5Dc#hWHlgHMn+e2v+kRetbuzG$q zGh5q}`>`Nl*h*>pL2{wmo%fxGkA^*mYNpza!nPxrgWo5bv-Wvz0Y$lydmW%3=T+p< z-X=16uh*$iXw+#AZC++fJ^=%!+NFDb(}I$0>B{4SQcY^|osH#lz$7>HVNqP@GPpmv z4}p>+n6KrPH4>G}j7kw*9Xd>j7i*9PGx%1ej;_)W9zV-HDS=RE+HrDZc+7TU5z!~K~- z{Vc)O4WiwSKWXYs71iW{wz#ikJ zIvAu(DY-5Q{u9!z%`)r(Sdx02)Jqa>4-2N+P>d+F~Sn zgI7M+ac-t5loW1{(w?`;A19vtjP}srFM@qY)XxfZ6S5nKT-H9fd9@gg!sTMPb&M7lh1^4Dm{m-%F;WK3GnOO|l=3?h zSt&v4!%m^9Po!LEB0VcjNp}=wg)7um~OJ?aJ?F`O}6rA&e%J6fF#;4V!zj<%G zFB@t}rfZi1!L|KT*4EhVmCVv9+|leRSg`}uPBIV7I$%}J8^(SJ@dlD!ODl-&jq1Ic zNDT8uB8-g8#BGOg=yQ>PMKwGT;-3?ECs)_bgDjSowqPuApo~f$XjCfW9%Jr)Nc+2a zARJW`_+{cx2zWACwXHS{J_omHZtZU`K$0?wi7Dr{Ys=R)4yeyC@Y!H(s!-WNb2c6X?jP*?u$9C2pCDE>; zvw<|&jJEo0Aq~)J+vanzaI2Bbyy1yv%I2~>8pFg>=^inU#W7e!Z5r$BH!kkMpvpIx z&&vX15(PggEDr*$OR4CZz1`)7-o2>mn$_w{CI0}~Yy_(mQV4<|8%pG&Ig=nD+<`!P z@N38S?cLpfU5wVd8oK`ghkO~MNe_r6)9>TdEg#O(E#;46K?IPHB0`x*B^pA`4tBC& zsBSHMKD_ZBo=mzN*7pAZYtmBMM2g@KvTt(A;Q&={-tADtu?2X*;N9@lQG7zyv@J7I z)@NI2FKz6tWs_rK;mC}nWya1@Rt7z!frU^81$2KBw5<;3Sd+sxI>5e~TcI7Ka9OB$ zgdhcrakq-;8FDhTALJQeW{U%Q^5)wO0PiR93HQR0nT#24DVwwr(eHH#W!EFKU4DIFMQIXG5MY8N4qeru zoV0~->k%Q>03MIv_rb4-9wyMQyf>rTX*TN(mD1W@+`wLW!n#|s0NL_D5l{1d-!4XS z%Z1&+d`SJBb*QZF^-U|qkiMZ4xSGx@VH_5AYY32ToXW(?e$YI%Sist3ZQ!_5ohq0r z()zsWC2MK_01f_N`C^WAXr5 zlCB2!Y>u; z*JgVyBKq`3O93;eQCpqUu_+T3w~yopE_>4a9gzq)Fa&CvnLlHA9|^ z-N^)Qrn}thK{ClD5H&;Fz(XM2NO_3yJ7v&0>V~C&tnBtintKecNS9V7m zKMQTVU*InhYCaM8iQ$%uS-XXFnJ#SP62W&gPdlVV&&=+!`Qk?`<&{^bmX)32Uk-SO zN7wv8;vWt^pB1Dc+3YS5d1mI)NnBgcA_77(?gXJ24va>6*N0m$l}f(OHtEXWp8o)U zkoli2(UIbBg!*o`Can*H?`|~<$m}m{gis0mA@d87;J{Mer-c zm){Qj7Dm-hG>;G4EueBe|2@3F3@qZRIj~D5l zC%W;5i({-_D85!(i_D1{dxAu!CX9&CyCGHp`Z97SuQM1#mFB;I# zs9tH?+fMS!;U+OU7UZcc8#{vGx)a?x73G1vnrZicdhhuTpF7o_!EZIbqpoRQB)afX z@aCVRYD(*MZ6bd85=5F9g0yQM1gwZt=PdICF`~xCuG{Ip7SbV(^?V(E!uMO$HH)<= zCD--E zfbD42Wh=4*?7$D4x!<^-kecW92>$?RNqiOJ4+81;gITniVWLGPo!iR}jIlF3_i?_} zUo63IG-2E+3QJ>iEL|teyFWkAf05Rl6n*0NgZyjon@{m?igf<~6L_}z z{yVs0w9r{+R*7vKsq-382k#t{Avgh00o>;-wS}LBRB6*4KGqpN*L|i%BTj~9oJkU_ zoMDV;yV$ccWzGN~4>I^^;VWxfyS;D3kZPJ@={HQjYPrx}RGQlX69}ZblEW2<_u|&^k_4NNoQ4Oa=ZlUy}u^sJZaZ z!haiBX*#{c(AsZ-lUvg@8*Py!P~vB0EZ8Zt_beF{ZkGoom4_Sf`@=pdxbZ6L6YDU| zX)D8ZE#1Y@mD=ykkmZ?4&-$&zvFb1f-8G@(zYX|#z8ypH4?xr`=hfp+F6Q9auw;b{ zn~|H1nez~mhXeu7apYnx?bK<>r?!p1zTpa~y-#t`F8m1(hfK?)-CH|qHxt9H$#E?9 z>m9=7Z5=>p;z<0bZSKQj5UfscFL=uD;qrKCbpHSn_}oRQM}KMM+T2c&G-X+Q*jEl1 z294)nj7B`f8;Um`1Ms`YUlJ~SF(#aJd;5f*HM*V{E>p;enIKqi86N}55vwj;f-dmK zAS%_}SK&X2d^xAh;}076Ni|!0fU=E3e-SK(+(JI?A5@@`t+ zzO8R0({Jx<@H*XirDU#lk$ipd{*9}6pThRbdvU8;*ylmH($QY#+{nZTm@2vhzHUm7 z;KKIXF0129e-LRtB)-;eb#Dt=-rt=%<~ymRwua_0B#-;=GbuB>1UU_YBMRKPqv1B6 zr}%eRTMcVimK&`&BeYs1kvbMJ%QR+oIVTc4p&L7uq-+47*Qa>8&%&1e8nDv5STq;Y z(m8LUu)SYCd07m8SqewZ<%ap20ack!Gs)z|SHa;Xp-wIBcm7LnGU=&KH)ot^9ufFy z<6SAVPYHO+9d1!PKwL#K4)@I%1RPyLPHbki^NB!WwQV&8hnaI<}$ zBxiJGc~vAb239>DO~HZrcQpS132EBTf$r?$)}m3T-_LH>T8+4lXIq#fc8y}%%^+cL z%EzKCY^~6;bIX#vxuWFPnp%C=H{`kMI={n-{0C$_QK=L~yFy%ul z5_u1|H^y^mF-@vAnd04c^G?*XNvyW&HGEH^&l7}#E!Q^hh{Lc#s!+D}05Bs3x^mp37dnda=S}u& z`umBgD8GdApW3V9cZx19*TdG{G_=%&aZfz5ti;4%mO~&^MjKIsA$G<-Ve*`H`OjIu zdsS<{JIyXjFm9RT@$a6;(z?%xUMG{qI{f;Mrm;2D%w>}Z6L#WVhslA|o&e(FeJ(mdL(?B_KtMoZ1{Zy-pZ6YZ1!AEi)- zNYSRal3UA`kQLxC#tA)h^y0U!G>ds08DYRHfwX5GJ$bvuW#~eKsCIO2qSKaKxfE3`qS0Ts(EtT zV;---8T`E}WVbTNw=%$GTyionNB;m=`c`Q(OK4|}<-uEUHoguz9Dn-xrMR`08Ic6h z^cX6~AQAd-dS#X&*iI^$2js|WCUBy7-pyM5=ZsjQH za-h-0^7%G#FVEB*hsf)U=ia2W(28A%^$Ac%yaoV`-n<<1$4=dAUe|0dyy8~_Y2NwI zBLrl9YDnz$SCsz%qZtv99m-DC2ap(!JNNYzB-mLQH?|EUW;8`#UWXrsO+mij?S)A| zpbs#F$XxO`9OL}+TT-+xkgQTdt&Ow!&%rt1;1EFR-m|auYq?czVt+O`@(?%5264EB z?VJx@m8^CqNLy$TVv=c~je`(C*~eeu$l!J0;+3aBRw<%guDE9_jlA~h*PmbKRG#+Y zHwz zK|t4s=?+NL*UkV}d1;4~eB}JKh%R7Z;c-#aCu@lRo1p5FEFhQ>yu)na9 z=_Ls4M1ewQlhgF(y?4ex4(@F}4rx9$(&Y&P#%#Ed@@#E|_eOT9Pq?5J!P*%? z@N-T@QXJB?*d-pPr+&@XejHsLHQRsL>2(cdw6}@1_0}%pOZZ}e!r8KUq9k=eSqOlcR){WZE?(5R- z-*MGSQI4+H7sa0$blrExce*}_p{AESlf^Nx@buC}YOf3t!lDE#`>`Vyk$`7l`@ns? z4&zC_(L6V$X*T+Hm~|^T?j{#gLv=UDI8=T1UM%VL`)L#(zHROwA zap_va%`Lf-I0)WycSka)ky+#;bU=q<0RZMJ_&mawdS&b?ZzBynuISHqBv6NTjG!#> zg20y>hutL<=XWl@3nP;Co-5m3Te(~8%D8uI3!Ijf3yLlMG6savLU+@x}t1S`qr|dW3 zF>B(hzlqF}-rLz(J(RDiCA!>38Hn1ntNqDB1zucyCBD6TOR={7BYUG8TSZ{erL>aC z9Fbwd$@|A${QR%E&~EbjsD29EPo-RIdj6-X=+WL>tkERXX{h>8jt?cJ^Q50`;gyo! zHDcGPNF{O@ zqe!e-fGZOe+^nO^Y^Vq;=WmG~A72aj_fgU=k+k(|zug2Hr^`RdA|d3|371$icIa!#^0!7Mtk@f6se9>XwS-eWE^@NgO2p* z=9*ZI(UFXPX4V+ac>F&+bC0ckJZ^bySY^ykZbU{@+qpoRGq?ai-S~r_%Bap}SuytK zlmJe}U~__Z`k#M5M!Mq7Xbji=?$PQLZU zc#?T$CQmV68BM|XY>a{Lg&&O`71eGnbtvbJ^2l<%Pd|lYR-d$sxp0$A`bSlsJDXu5 z!0E?UU*}v8iuBm-{L5m5s}c?eQC&BNb*Xiq4~b@+5)%glzvo##BUeS;3!XtB?i>-? zyxK34b~c*2JhDqqu)FEYD}&C>{-4*SOQhZ+L~U;3Rv9^vpSzP+yjf#3WBW=(4Y%(Q z-3PC|V#4icrgV|856oGK{Y`rjw4#n>qcsF;7$Ikqo|rWhhz1JE{PitPwwYQHCd1D? zGfcR`Cz`P_=b+CNlGL&ZAecD@@Q&mj;-0R^HikGH@y$o)i6v6}9AE>+Xm2H0vNL4< zMy(_#u@&vXVi-0-JmZR|G?B5&fVF1iNaN*W&tI3NR%>IN61{PZ(@cWA@&Nmk{V6A# z&5S5~1K-k~E%&}QMbdsD3H%!K%?KD}vj|?n?1ioHTLyq0b$0 zigrRHX{EMxG05Sw(4Mt)O1BXQS2$s!1x5KC;a=BW^zR{LcW`}5U zcm#g6xFxod9)y+a^HmG9ws}0nl&K#70M3h)os69&9vMs*3$?)Idm7n+LpIirc6-)# zp=T%`YqptLha@nm^bJ-k$e9=wb!I>S~R4vVf){)>Mr3Ft9(MH58WD3y&jHg@^k@ul|GuMQ1$h zcB+ArGm}~i4ZP8i%n`A`H7?~9C4%kaVD}d9$J|@E+w{#-jc%h>X>Hk&da&meruuXe zt{I2>)dJ|yA>ZX-{{VOnO+##YA2?~Ns|%zssF%+%#VEjSj!44b{{R+7GC1enx*Ze1 z_FAXfR`TBDi+J-DvdF4#2|=_Cz?>eZvB$qI@D76pv#b4@;`GG=Gf0!PFZ0T!fEgcm zX;sO_NjrGvyP0)sy&B_BzVNoCJa;oB$OyGXjT$z>Dl=f=l~ZWpuugW0{3f+@-z;9I zZ02%4C-|vpqF=?~y(3w>pH6}}+fA100T%eik(M#KE*(ZV01!`5X_g-dJTv1Kj@5NHy4NLzE^aMjwK2gI zI~UAMf=e>W*etjhKE}I$f!_&i?5w;<)n((Yk^Z+N7+U8Kht1ze)S#D^pO zdhv|corwCiICEc9E@)fKkHlXNbsL>h*Ws1Nhcvdow$7n#t=h7bxr7MZ0@>WkLNElJ zlOrf3R2LUo#P27BPKRTq+eN6Px{JW66p9h!EjUF{xeDdE>QAoYT?z4gI<~26;VlzD zF!++u?=3Yui6lTR^vKa95-UnZB*adtNFZc$mI99vFOGaQqa~+^wKml>p9;0g__or5W4M$;qwF?-2M~!#*i(cf>vb@sPH)(RBH* z;I-7$PSF?%c&$}gNAILWjkbWu6@llaa@QU=*Su1bzN-c4GrUQ1%?pn*L$P-V!tTQ` z7{F1qdJ$RrRlcw!iq}q-??kqJS^;=&cg-9&>2Vv0rt-tNi9+C%4#guXp}14&*D_i7 zJ4o>r?zyK$u3jdw0-I1ih`lPz1zP+mf9S@ zi@Y=Ai~S)r8T>af(=>r~ZD6r#PaU*OJgw1`Q-QEcZ!QVi`B1=>%r3Kw#(8%a zL~k+~qh;8LxU@lKQB?Q%a5>)Ni#q@2NXr)5AD1)ZR6W3 zohw3{Sy&M#zlQG7JkPTiCFTU5EoVspWjG@ndhWpVtrNmi_+!H#@RaHv5xfs=VfHg~ zdJ&%19r3-aWUwJ|7>wr}blrtfRrLP=3HaK_#(KTCfV?-QY4)0h!s%A_R}!kdsE*nx zCX_5{%21gJ1iwEn0cWm3V)%pb_Rmtf@ukH2gSM|Fx?Ad&(hDg3xT5{+Ho*dL6ycZ^ z{oG|kVa<5BitiOt)Y@BU-mmV^wIuf}cs}a$;jW7>i;cofOqB)Vu~YYkTJ1ao<5wm?K>aPAgxr(q*$-Pdh=t@}j$M$&azAn@mf ztnI9!jyTSw(J()0o;BL7&Oq9S0|$(D>0KY~1M#XIA6lEidIj8CgIIZ1*7}=7Vms4% z`H_Oe;{_D%$t;Z7!*k*~M}f7E7i;laW@&_y?>OM?-N;<}jQ&;j96OTI!!NDY(b;v- z!ano3niqj@yg{g#<&sFCaHLD*7r|n7MOz`dQhpy?mjq@$V#f+~X*~^P~)!4LuC>d4}pkUv1k0a#@JpTaR z$_iCop1NrN03lzxJHHrdx1K1IQ}GUm;)%uWkB3(7&KrB#ru$s;O?MQriGyY-LWxmM z11=dzAgfd!6Yz$Ktm>W~z45ZHskY(X{!4~ycb>>0j4P(?pe@Nn-o&t%C3dJNa}S91 z?H|C<>q~uP_r4{0E~2}IHWhfv!qLmU+sX)m@oR5yvES}oR{ad6U@ z{I5K{#M59%>^#pg%M+dGpK>^W>HJBg*gfRFHM{Vhp`vI7?qGuE^2Qr$cpT30TSUH8 zulwKJ+ys+qWk_&x#jBq9Z>9J*T)ngKmVu^f9(J>73_-6@#D*r5lA)LPYRwimIVDl| zbx=o5I?z;`l5fBK9+xz5aeEymx$!H)_MR!bw$wZ{HESo+;heHu8*95uakNPA$rdI~ zNm98|%oGFAS2^Q7Cs@|4X4iZXplAtod!>0ZS?H0ii?g|D{P5*W*Ag-(mID{S5)k=z z6=TN`KB;#c-`G~M>esieb}y|NBZ_$9xl-zgr2gyWjrXxENoN=YRUJnA#XckPYIu_F z$jf5(gH5%DArud7wMUeIge>ThI3ZbAhC#a_s;JFVk2DsZZ$mywNXLCQ!w8aCd|%UU zbiHC1wz|_T?2OCh`H`wX!d9L_QB!K6Di9UM0|K?#{7(3BqG)#ZI_{n{iIYy0TuM;G z_M6EiREee`6?U{FInT@wnhpm_^WA3d`%k!wPt*15`wJVLTIn?+nvNSRk}LvD3>-5C zA->^Kp!1r);eQYKpG-u%ovyDSzKhDcmAD6a-0sZTEcEG&PBd0hz^KH-0; z_%!LVf5Ic-8;G?_DeRj?yuB)I;}Xh+qY<+YHOP)9Y-B3N!M5b*#kC&pu?sJK|gUG&?IJeQzCRTS-Ris^sBJ23PiZ+N<|;494<>%`v- z+FfH)jspyLH)vvtJ83+okp}#ii)?$hWQM~9k#g0=_}}7>fOIQ4yf3fX#Tbpe;~kQD z(JQM)>i7d2OC}6UmBTP#ak{$ijB9&wr?#c={{X{xQ(RmHI*tA7suh+;4p~tSLL^Hw zzYCx5F*vSQN%$M#--#MH@nkxB{kG!b8Pe+8QE5E5QZfW`C?yqL;g>RgK;&o0!_N_ zFh@%2yfN`U9Zy}8z`iQe^*u87(irUH)s5}CSkB7IW<_Zg-(yLF%F+eIWTK6w!;iw$ z@GQ}`k)ptd?00khi0dfVODb#-ff*no7Fh|H{Hz~22M=6N#D4|Z%rvP@+&Y+%rH4_q zv6RCdsw|9=eVcM0HRWkS6;%iKjB;BFJL%!@7~0&Bx=*iF_}C*U!RmUpr~6HOCGbs# zqu`BC#i4Di@8f7LtU_E!FgGYyjJRE{&UUsy<8vsCftjfI{{Y}7rQ$tT?K<7|nW1Zp zx1Jx9NPz7=V|j}O$^GA$tudc?QmS|3Xj0kv`VWO3Bi1}8CEdQ46`Zj=k;o03$IDzS zQ6}#!DCSZKVhF)IPdMuQUHd)!RMWMaPZ0Q_J0(3W<65i>9!vbH0@$-L98ZtY_23L zYkTE0%0Va>XPYx76rH3M$>5(6{id5<_*>$&@U`3)aZRAb4UML&r`WBma@&NB?Sii* z5lc8y#1=U?4VvXVZ}H2=-W2hLrPjZ$Y4huLkwl4QrrZdYAgzga`6vP(Fh1?LBLptc z0k1Xjzr>sUcJL*JsV&5ETcTYw<+C)waO}q?a0HM$00uBC-pIIr9ZIT{=A2BYHOO+h z>q&R0&8bZbER*oVXWem(^ga0}6^N@1%#L7&IOHP|l<23Af2T^*xV=PYw7IlkK?OrM zCxSEes1r^yz%JGV2<|~IkC}!KbDv868k9LwM;x`(r)OgX8km~ohW*h#S^0x}yc78I z>BcDk0EB*9xi<@AAyMW?(n`4iV{tt6oh;eHJ@V*H$Scj0p;@CIB6Y=hGvKqL-Ie%+cLl>{)jicBbYej@cb^O_{Z+ zdRSwCjmZGQoJe1Az{ff0dr_k5nrcTh65T@T_$DI1eEM|b{{XL9cXz2O3r1-O4qPc8 zDxN)gAO5bi+gn+!Esf2=jwmEMVrg7wIqB+nq-d6gz2wF@Q|xz-Zv%oc7t9Fh#t$Q} z>s1fhBc40PwDXj=5)+((jl($@=s2oCtY^)8fgm{nP-J!Q&j;W1t9Dn0<-()^ml+EA z#xgnUjPZ=p^)%TR@9yobr-mf*{IZ~VoPf>1EJsn;{uMdbCur6iiOa|U54R*KJpP%- z;Z%~=2ri`pG%f+!JirK3!Q}daDh*Omr(7tsTq~&C=3tBvJ-)x>Q%_P08m08oMIu86 z=Rn(v^T)C6z%_;TgLNRDMrBY&$Bf{0{{RfumA14?kot-+12RVb!x;_zJ@+L)^)t`n}>oZi6MV>R!k}Do_lZ( zexB963nQXQ8lXwy-<6DRUP|pb8O}#;$362^Cw&#AbmA9G;bM%O4toLg=ciw#CdQ)K zW5c!^wJ4`~2vlHpFeEVa-I3R(efw9^zAlOUEBh(iORDL&pW52B^I0#M0v2m^RiDgB z8AO3ySq?)oxMlzW6BhZJ+xtr1L`zu6Qb6;S56*j!{0*@p>kgXXHY5_j>mL{&!}DBS3tOmXzA;+d%RG%3 zNBzU2mA4a*DddlFaLNf(uVV41DhrTJ*yg{aThf}g!c~UK2d;LxrJn2>wz2QST zN~;*R4d!h`MJpP(c-zeU?>3eOo;pH7A+bLH8s ztc@GQcSUh5sD{z!#DF_w1dx+~zdM)j-thLBrB4!Tns(rUc>u4_-fZi@uJD$Nc7D+Q@6HD z!!zF7N%py$3m#m#E@P0(=COQ!_S`Er;#Z=c7M&|jQg?b<=;*^m%2w)qtMISmPM4s3 zCGf_PrTCgJ4B7aN=DCK>C4(B7xiW2vNwo%!c94mgz_kKE<1SJpP}(K@cc|)V@cw19 zu)2;hkA3i98B>vUX zB>O$YyWj{2NSZ(Z#FDm1W4!#M8&{TU`s2iUFT+0*_)b3)S@_RL@eR(dlj(Xb#jdo{ z-RcuZ0!X&dPa2q-Fp3BYpL+Ij(=eYofAR&E4R!{{ss7-4<0n(pmwj-_i2+-z8Z&eiH`&aY3Be8%vd(Usy0 z7!)*X<{vO}bHJ`zSQxC9g#aU?W36`D`p%YM!v^+2%9h3lb6jq+v0KQOQ4E4ka&wMr zqJ*!ZEfLvIw0SPSGISvItBBi|_l(#Bmd{GWy12QH^j%w~QNHjk-nQ+tCAyc7U}2tX zduwqNX0fwLP2^;jWAiX#X^yeR+)2%oWj3CD~QsgSJ z4H?KiO(CR{F#JJj4a5$l=OeXA;Tvc*D`(TEnSY)w z+77oJ_uY(~NLTx(u6~>!!i4P0lDuqo);cUn5s9UI(RUd0rWg(U0EQcf4 z2a)V}=A9M9skS(j6ZNU1d#F<+ah&jRR!K6AS~$F$n`mDH0Hf#mfmLL;x`gkN0qj8s z`qjv<8bP?65!WZJOPGu0;?6-h27oe!$yO-#t`zmmc?0njsecH31u8uXnz=0YYDq1Q z+?s?-3*c?w^lCK$=(eI?GtW`Gp!7eDP4;-4l9ETjVx_UiAaVH9QZX9@F5P$`jZTI12`uEb zVJRC)JTT2M;fi8ej!rrO-`1unAp|_`R~!<@GIhKm|?-Obc1AyUyW1zC9pt;=MrnE>)XTEeo_-$JPA2r{=*^~FJPYZOGf<2}e6Vx^N%wT;A&v!2R$r?uUT(CjXoTc|CM^VX%J zk&?+2pTq&rEGlR%ZPKy6l1qCT9FPj0%nuaQffV7S&N&U9Yd0I3r(tB$mRusE zrakJV&XX#P2@hWNqLY_hp|VFz&?aSEd27)3sc~f{Vx^SuGZMh$=L5AYf4qE1#c}W6 zwPcI|=0q1Kj(?R>>kFCLCkw><}dhTPj0Fl=m4D!l*^MT2)OBQ|> zywxo)CedWmn9l{h?d{dZ{{XWRSTunFeTtkGI1TN<$B=5iEdKz6gIHUrbopSpx^>-c zY{8ezVlY_oxEciQ|#!G9XHX>PPDTX~yLiW?0%&Lp>*Mv45*%EKl%2!OdE3loE!*P?hA z#rk%&bvMJQw0WV9Yx~=+OHi~}?rtrnm6=PV#gpv-luii;us9))&o&zDx|H_*DO;;; zPUhqmn&M^ox3A3pX5pQ=+zvZ11Mb&dq4={&(WJKU{{Vx$Qr7lU-}#SpC3RGt!WIlr z?;+*PM2u}r5s-NK+*JydD!IM%UvWICtxrktKf|pq@5A~H;PFMR#q3tHu-2B}c`(do zjpCaOLn|~m3<<$gmLr2p$Nna~)9lkvwMaDfu(xeCcvf-bYBKq#Nz1;+btIf~&IWj?@cZIc zqkCnj$KpQ*-QL{mQ_j2?IQV=_SntFHz-^9 zi&D_;Kelw+%|gW71%^AxE*2!7E>2Z8hTJ8DFp%MKyB$F$mv4Kh=k4Amd$T*o9qEQg z3m}SEWX9q_4pAcjebvYrB|xlAQ^)sut1g|WXjd?u9>Cf`Z*y@Y?qP|~MIAMjS;I)`RASrF z9*-8e@ef$>&Zntg-NV07x0)EQFRvtLe=SMqT($IO@CC5&rgmumrcH&WoEaS z$fPr2i8&H0up89m4%nxBGVr{&I%8_OcZhXQwrDb2rP^9uFcCe&$cvl+TsxORoT2%S zGHc~(NmFe~7Ppap#%bzjc&ks=JU`+2tn@z-Y4OXWL?$~XSOnI=gt6L6&$IV_Xprp% zw{eq}CbE7R-+UYK2ZD-t-^Ch2c#_T(N#NF{G9=}X$sAG;4#pe4KuJuJa=0hHzW8n8 z?-g1{;>`k07Q*lC(VLx6s{?gyA#k#f-Gb~kj4Kr!I5^u}55&uFg*v{4ePQ6Ww2>?l zZ?#1nTUUDgujVmb%8@%@asUkY3Yb%RIV`-#n?S2yC z;o=g!s^GKWt1O@g!7aa_JbdNgzYl8qrkSYB(8Hx-MW2N4_1!;9xz%Ng;_BiSS*^B+-+E6eEMp)`ByF{~vr14fX2IVd zl*`>wmaD71&D)G)p-06sT4}%9UNQ0RnztWph&(#@61ehQe73P80E-DtrvRM3S8)R; zocN9VQ7wjnbaa?n2fDS2C?Sdvl9!JO=I$JWj2@>U0N`<4H;?`)NugUOhc!cgduL^* zTF+r^_JR^?pD29nry~P z-9v-O0=;9#J_^)675Lvs*0eu}YX*s`Xs1$=GZZbSNoO)Y+B4-VI6$#0I2mEpa7Q}l zIh6+=sl#`-ow_R_Cu4dKjD9Fj6xoj)_!8Y@f@ns$eKH2Mo?$f5tEg?cwLV?C?|A|U zt=n-UHPZZN@YjU=FFo9T7+Wax{Ut3Wl4U zYSyvp)_O**bJk! z7tuj%SIAXk3z58!nRm>OkCd`EKEBQqEsYBIlTWvQzqsWZNh=U7-m7omJz6xr(%>=% z((SbPE+%Kujw9OAvvAxr!ZHqJzw21gzk&d8k z5)qP47d&T=N$~V{5o#9l_;bNgLE+tPqkAn=RT0P|V4FiTtYj%C&XC6$MpYmOU_l!{ z2tFFz>snTw73PwfHko+O5^6BueVXDYRE{^^!I_>lxFCGQKi%47$n~L)p@XMCb$spr z00&b_aFnI)oX>#`#*L;}__J2knBC11G}gi?OmZg8$V%r5Q2`h^z-%71-1wiwo+$Aq zjb@s~!4c{@L=)W44WxGW7BzN^Es80?5%x z68Xv$>~h)3Zs-o)akvsQ?cNIbGoX0t2{r8<*G5AmwwD(AEuWSiN#>R-a*U-+L74^{ zJBlD+Gm~10@Z-jsJ?5vNO=A=m8iuQFrNwclrLwdWjnK8kgLqxi2^LV{N8VBiVj8_^ zXIVu%MN>*%fAGf?xz_0LpAP6+&Cibpk*w&>x^=bJ+k8hXjM6~@I3{TrMBltWK15-+ zZYVf4*=SxnPZ&bFUazNWc9wd6r*RLR9g&9CIGz_#7)4wX9fRXM2^5~2tDf-RjWmx2 z{7}8swfj5k>+`A3ucq3PhJTnukjj!F10cD^-h<^iAdT%~U)Ow1q|14wcw*N@`$oJQ zT9h=tOqQ<$?vVo%<)}VLBn{cdTjkqbwQ9<|ljX9u_XOJ2nVOf1bnOqr(>I6o2%yw1 zCN~<04D(56YYcp5tls>gr#Qy*ayngy)c!Nr~h@>}DT1PzYO1wXO0^3O|lnz%LiDA&>jgN-j z6}$LpG*(*Xl^C?t-Bq=XcEu$LG%&Gtg;qjT0d$~)#w3ZkAlBbk!22u8(tnAxYR#<< zuT1#CblNf2?0zEM-D?v%BpLv-cZ@@`CSu@lO8|Cc;64cXhBLHp+E>Ni2=NN(9vS#y zbE0YOr6hLRe9%b^ys-hh&nnEOL%6yjEJ7~T;kOFk@JELJ5@^q6Bk^6uq|seZErs5Y z1F?=#62iH10-UUdGc}FOQ+=Lih%8GKjlX~H z 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 Uw@Wl`Nmo?oxMR+LodD7Q*_pD>h5!Hn diff --git a/ultralytics-main/dataset/coco128/images/train2017/image_BS1_460_00_42_15.jpg b/ultralytics-main/dataset/coco128/images/train2017/image_BS1_460_00_42_15.jpg deleted file mode 100644 index 952aa4a4770fe637fc84cdfda186380748405524..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 233722 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%0AjskP?L3skF4DQ`9;o} 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�o{t#aZs7>u#Y9DZ9UAu@1q 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 IB2!az0e2L89Gnu&tjbBw3gn#eo8#R^ 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 diff --git a/ultralytics-main/dataset/coco128/images/train2017/image_BS1_461_00_42_15.jpg b/ultralytics-main/dataset/coco128/images/train2017/image_BS1_461_00_42_15.jpg deleted file mode 100644 index 25c523e38c2b5e030076999189724a3cb5cc35d3..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 233908 zcmbTdWmH>F)IJ)DdvS*rDHNy0wLtMA#XT)9#ft}0ptwWPBE^drcXxLS7QA=@1p)-P z`MvL2_y6U7xc5%h%t~@5ll`2T*=O%(?|E8&f&!kaDyk>~(9i$?G}H_5vF0o{^bfP*_x4^1HOGwywURv8lPGwYRT-U~p)7WOR0J zeqnKGc?Ghyy|cTwfAIJ42!3(-@9O#naeMb4E;Io8|H4AG|BtvxP`IA`HwW1N;X-@n zjjHG*7?>{wut;S;Vt;lcV}28aLoSz?SJQ*b@>Uy0Vc|Z5N69L<#RmTm+W#Q?e+Ml1 z{};0V8`%HB1pyGCqoF1bodh5QC~opH&La3zuHe%K5#owP{JW|Mur;1P`*$l?sofv3 zrx-cHw3<8o`t+ws-4h_P$Um8lEfgxrirT&hWSTp~rk6 z0iwVttykE~cwji?-)dN0%a0rl`ac-o#IevzWH&m{KQ4Z0z`m@6Y83=e%-?}?{cgiQ zJp5)wm{t3v^=Ibx&Ib?mYxjI@{Yu+!ph6!4sP`tRnl+>xtqr4pMpfy&5eVs|m`6&z zYRdz0C*3KgMdLd;vD{0Lx*K_=a7de@Nj8DoKI))zjPCz{!-5wN)|hIa0H?ZL7!5_u zhO~Ame@4YV&(SA8D)<@1$w2dI&wiF6LOvp-N~a2A9X~d9uKwAXcpkBTtK7{#CZ7|V zob#@F>@OIazqmpCNBOMF`jFiApcPE!I#dmS1pVbFb`Ef$egZ(t{V<$s)&s{$8x<{w zA_1(nL5~HQTWLgFTzc2FaTVu}kP=ajQ3?Cn<%dXw%o6}pYq237?I?#D5mNHdWE>!^ zH@DF*$URPu9GAVJClF!GU@3={ASqe8A!*@Avh8f8t(-cd+$x(@bAelTwc^PNOON{J zRtlak65htiZFf;tbU~}liD75I(!9FrSW7){Mt{H^cyTd4<<>C{W%(@y+;crHn~NfH zp#jc7^uQ@$zs78*ZQNoL$6VTn>{GUMT-xW-gU~9&+ODzeA(j`(s|3XzoL(hjh3!v( z@vW3E3`Q;PhliH`3buz%fd%%t4Hif{7{(i+j4%=oS4+qA>#bTMet&ScLI6V^xJRwa z7Jm$y5s76knBT(kcX#(u(A_K&qW;VTQ`@l zo#Cg0v-sJTY6NJhN165Fyvy1tP#Alk36>~31bz4D87f&qq3EnzyuESncvBo(5B2Q)mQ#%aM#poYu5hKHNMF{>g--XuJNnP({m%FxdGW0(BBtA?;{=sEse*@4CD~ zttT#IDBnq&f74^9(&=>(YJ7@^bTw8#rT%D@8%vLndcJvK9GP&$5;`3J5l{VI($GY~ z_m|JGsU|_MQdF-n@tGNo>>%!8l5e+I_0atkfbz8tO}RtcTp_7(!b5tXRq0sYbreJ&G-&ylC(+TTGx_RILb;=|GK+pI4< z7q)qNqN0;%yT>E<4n7in+_9Ai@nfyej1P-!zkDfb0eS(@oRV|mN^5DRYW?`y6yFPE zSFxiKORWY_nsg#gd6;A&-KPD z1R>l&y%BC5slsfufQ(gKuDwmr&Y1o$p9=%?PhhVZ-5 zeeXk5LhIa=DYhigvX=F7l{K-BFx>`ys-5Cq9l^3~I}lIi7{~)B?__L?)(!q#p!Tx4 zHq3?ZOURhSn^^7-NZY-H=lrhHbW1YM=gUB|=D5ec0ott=0+tMCkdP=9E};?9{I18oK&#*I3dHW=cyOj&WzTEcZ9L8Z9$Cu z<3o)3jY!A)4}p`99B|4I)ZVg}$0{ipHec1RyS1suASL)vAejmocBfG*rIvjBRB|eI zFAB6z6VG&D>9(S%vj2_x08Mf(;H(y^Ll3a**6sqB&1u%t-oB6G-R7-s?@(3YwNoXv$zK8&_@q>t&nZw%YY&X?HLF zl;>XDLHyG~{ZxbjsVqxElDah~LC6##wM?-TeB$dP#zT=b^^rGr-y=EPcm&;kiR$tQ z)lX5OHJQ~Rmn)0+W_X7K%e`A)uh~K?w?0KhjJLvl=o6df%HV7E>4(oSs?$~2cZggk zHykbM?BCCb-hqfj(>!eibuFR3ZNAlz8lo7A4YLf*v(t6rO$F|Gd2kD3Rs3At4@{SdKK+$$ zV!wD{CLzI<4sU!zByFKQB&okwv;--*d8sg7n4`}w=_`*<@hej*uS@|Y&l;F{k$nR;6uxm!*7Ycc0o^|2%)qE9E3jbrq@tg~ckUOzB&I~%`0 zlYo(Z#-;rjKOJN7=9RF5&+xEYGkSfT>|X`n51X)$xd`^F$~8#9`Dq(0b7Ol$F>V__ zH^TUf3t32TMI}F{>=9wWsC{`s(BG3OoBZ~urAIvUd+bfXBCxT#*C^<452P?hcdKba zi+u{de}$;l3zvg+ol3!Ov^$&GPp-Wf-_~RrxfaFEtEhYdXrljm6~=45_768ldzD37 z1~NnuU1@%lpd_HCwMCwoJRRq+=OZlyVri?bUvQFsg$Q)y`m1fiwcLeZIrIyy?O16t$y!Ynz+guwcsDXE6<&pD4=ifv9bg+LsbPQi z{;#?Ev+vWdf2 z)jviZcWT;&sG=R}Q|7D3O1O^4Q#R6^_bb_S)Nx8$P1Xg+K6@})SkQ`Da_WY}h3CSn z84z`_93YjEsZVvEw|AwtKTmCIeKf0EZ*86{i?!G&R}~udhBBuwW4_?O=6Vm8@<>*| zzCH^pG037hR(nhp*3ku#X5^_{ta+`Q#NN{5lc{Az!_H`{jds3@v9wSBF>=tdxa_xR zVf|iG3dBnTvRX9T@^{PN)zIXl6v7DZ--Ct(7ajY>l$RU{tSLEmO@cFhQg$!KNdGp5 zxoZ8vvotGnSI~hkq(vZ^$`BIr2oLL$HKi)YTSqm~`H>>!t#xB73HK?t`ajl?z)x!i z1&_0tO=0a^4AqfHO?bI{tvcH`I97N-xm*s2Oz|U&M>c$GS(z@j`?<1t7FEw`bGs9~ z9^o=*ypS6GD*m%mDMEpdXNKZM+9`?2=s2si-RlhK0XK=`nz;q50I=1|Er>d9$h(A`%6VHZAvl#qQO zb;^6&Ok9Pf!A(#go>wh8s0kEA6G@WFD|gvctXzqMd`;LC?a4Q#5niDsQZ>04tSB1twB8a{%8M?I`w~<*D;5`%AOv-Sc-9t&Fq1&^G@;vUk0dcd;&RoTb z*4IUN+naZht7Z5|(<3v>A)7O2QnIwNVilRG5}zUF>Ws^I8vSp zoxRWb@T=yFC@Y0TGnCO60F$CpZ;7+I*j532TsR(;CV|)oGPc%FH!x_dttp3}%tmU_ z1jkS<(?o>?ztNO%Ty(1XLgJ<5Ny1V^Z*a0fBi`Wt1aRa~B-Y)8WKVN^}$r z^9$74jBrWT3Y?C^==G$O%}M~}#+x+6KRgzk#I=n+VYm8p(6xUsI}<#1Ni ztqq86(%wqplf~$IwJvn5|7kJG$Lr(heJ9Hls=(XyNpCyz>sonp%>7bs!~{QQROxAw zrrB)kZG5Wwa&66W0@dDe_qjHUJjqCkt``GWPJI7!bw8eJUP>Br=Xd=CaYNNYHV`{L zx+$s=&T}z{0Kyz4h5E zjL|503P=Hg?CrM~iC2})4WbxhfQVEne$fH5XDpXaG*XULRg|f|W7=fqJE!2(EgDff z->!j8T)V`-NseBAtlH*M^Xl9|B7(p8>D3B*osOK7j%=b=xV*g17Ob7}3px_24JG1)5yp)g?L1HbTCKRnBAyQNjEL7-^DQ}U*Q{FWw&?haW zW4F)`1GNtRZo%C$S-c_bmdQ%F%(x7O$N0LRos`nNh|z7 zTC(Jc)CD>0Sjs%bWA6{c(qufAoCAip|lGc2d*7DIfeRzsX%nF^JtldgN`W3AU=3<88?13II2h1egdFBi{dEe&yV5& z{GTd5jV%UuF{^hbEB4av;&>#x#p zqWczVS=&Gg!2;A3_sx+Pmd@T)rLO8`ZO@E;;fE zk7_r`1F=t^>?8a=owjkRt!tEdJ@K_kc3W`H@UTWWX8Gx#0NCbNc{>kO13AKonJpmJ z-yHt=ucs0pXKY*MKh0&3EIG}SyrM7VY8KqQ8KT~ACMI7QOq0feA?Y$j;20mEe6Su8 zQRx-*i)u4iKjo4P6Yb%M&1^eiaeoZlcm%8C)uAqH3_O~wU&F{iX z29V;WEkwiX+2aptj+I_stv(x$#T#3N?9P^QM505^4UXGQ!4~k)&Z4bqw8KXI)8B?i z{Kf<1azdK*8d&{$0Qcx`QlUKd+Fa!6zS(xY4Km&YDL z!4~25O>IB>7jHNq3?p(e`97c4a3^1Z8WFDDZEa{}wkj`niG zF;*}=j%@!EHuY#$@Goc#-e19W$9GGTWVXcL;oQ%=y{MHV3q(g0nR@%2ajq-PsQSG+ z8AOuIW%njCL3TNopek>%o_{Q2Q^j1j?2(9j;c+;x`_FjZ8MB!iA5%6QCFNYHz{O3h z(*|{S`C<~*X@}_uvpgN@SY%`3h|IcjqR(GVs84Q0E=+TZ0Hg~8Mzh0;tL+QNcAQ>u z(T$a>Vd^O_S)AdOguU+iz1yj&dI#JI56gUXBsA}v5+U9f9K#|A)Oa(lD1E)%`~>(K z)q@DY$OMU-6%Djk`hKyBx?r^^n4t6hv^@NG<95Qj5A-=>dQhH(rmaKVv+0(0+iv#S z>!Y;%{8yAC3&d*pnHwG`2>X)aw6ei=kj>9aHR zNCvAQ9eGvi9Z+U&oHS^}llN}Jk3aePZ}+|xXp{&xT>P~NT;33% zlEDEvZBctZ0h&xzC{qeG%0jF}h4=K|+L6k+Gvd^E?v z=OBfxY*NQkN%isybyhpo0p}d!H1_(kW|!Pt_mi{=JzrI8Mtd;s0R4uAyB%l^`*y}JJ+g=gPA@q zNR23_j8=+y;DvSv+MqI1B*pgY*Ylo&ja=U|_bj!Q-kC6kQye~gUP?UPq75a~P&`*% zB3#3!>4{HZ!Oa?Xdf`-uE z?ZiM0Vl+KEHE?9)6_hVjht$PNhcbtjz%YfbFgK6^${9=o3C|UMA9KmySabAtz;bPz z7K_Ps5zChe1uNg_Rm`p^FaGslai_NEdfo+H0*0z>YeML@`36nOwMVw52u$p~YEvZM zH)-F-B2K;q5&~Prxux}zpq{toxnz2SS(cagn@E96PmT&34>76yA7K1PcN^V1y>XT| zpWjK9HLUSS<|`#+7ocaZEYg1?XY5=^V<8|_+B5yPDSbdB9K)fOBtgzQgBJ>}a?`{7 zP4)|&wNd4|+JD7Y75O5{yVuvpb_}d*~P&&tL;F}i*~i2m{u3uJ`pgy z8d3IgD^jHvhceZd~nG5huHGCL+e(}gOHPn}<-u*b1ADr|CL zzu+5{AnarRvkNzOgiQ_6GA2Un=gvU5m;(cy$qc)fvdqIt;Tefq3DO4ZSwXq2eqXEN zdmd#PU<;v-rQ7xv-_1>xB;`-;@k%FUhq&K$(|>)|B|h1%m`bWaZD&@kIeiUVA*7;s z-G+=S=9(h6Yt>CV-})I@*b?t^yF}tlgAwcljk;yOjz)ak0Ycth2i4D=>;!LfsjI1k z8_q34eN*pLn=|dNhKHCE&C3i97Q7FcKPfh@TW z2S_r@tq5*|oo9C1_H`S{xQQ7HXI6=W+MiUmj1BDN7Ur+a*07PEx z;kcac-@P4{PJEk?kQXv8DjiZ{G7r)hyB(7|cguVu+EYMh;9i@s}IiVHaI6|>Iac;c%3pN8#9;t zz6X8(a=|1j&$U)>EmUFoX=_Hzljb}vlk%L3J(1a`X@BEDWl6-TQUD>3Dm^x zxH{H*G``bK;TYa(mQw0)lVS3VCqc5oq_fL?!2ONYpMTkv7OhJSBxJ%Q<4JjqI^ixq zMAjc!vS^RHY{phmRx6Jo$lj6Mx{5tl@j@5pl)E5~HPY}KmMU`PwE4oV8If_#*}*-)4`OW;_IAcar^`+i>s;ZNK5$Z4JUpCE@;_#7{1f zBL@AX=Yo$kft7TlC>TH6zVl~){o<-Ex3b^Rab?T(X$Z1}`s_K0l zGo257ldWN~$Mf&ki}v&|vVm?f04V%xI9E;tu`71+d%`)fn!QzhZArqL(>2 zX~_D0#Os*=o?f7pmIwgrjY(E^^W7Q!4uK-C8ona#Ac;Zp`QpPQL7-+>x#*~Rxs&CX zH2w%Ytq0tM!9*_}|9p4s3nfs(3J=(_S3M-KgkG2(mz5ixK)E9LxbM1;SEB8U)I!i8c zfTYx!_cfkvJIb^PjsMNpV~t(a3*w3`!Nz9ILWG~{!Bz*KP{F&w`|7Yj`lT1*>>&-S zY>TlYwjTBjHO*<3Xg9IFDl}T+#r&=cKIs~qMrqGS3-+|4ZgR?w_%u7}){DN!N>Vf| znavs0+@cjb-hm=nFCFsFw$Ij$M!xbr=ZfFD4U+Vn0$gU!-CJ*ly)Y`AXHGj^nvqX> z0&uJThMugc*o?hk!LHWSEO!Q(z^Jr3bG2Jxj0sC3iYmNTxeAfflM`)|hB5vWA*8Oq z_+(=U3_ce6>|84~!Hi%PU3KAojz7Z|=|1L~%u8Zgd%Es@|9N_?W&>5o5QQ9#k`wtY zmB_WP-fX#KN>OIFK5W7?!x;~+{7qt+kC=Hanha8fsV_fSo5FMQM#N|aHH+Ntl=?+~ zE#NlA@EPtI?tP+<`xcBvOm7+2!F5I)ok@JMRfS+TTIgi*q3VOYs%D3r>lz;F^p6|M zGeh1(<2l!#W5iKie#Bl|RwLU15`rzB04q(~GT~2vExtBH+cqKdqgsakxw;xoQQRv6 zSJ{=MiZ(-cXsj;X-s|X_jbgk@gXy_DqesXDs%wywm-F&l(z9+RN}+CPEoYVhki; zVFz&tYufQD0Q>(Mr99&5z?4iTDEoNBkzy1!tGw%uHbt>Qr6JC*YpwsY<_O%#6!N9I zVNCtY`;t>H3F;jgNvHS+jOslgAaMF5QzlL$g(2cQtLia_Gn+m-Hp3rz;=YE!c%;Vk zsnCP!P*0!?VyH;=ZFACqlO%=r{#g5SK!UlXkCfXtpQ&f*F=|Ih`C$@4D=ozc^TB49;qY){)1IBms^Q`Pl zgQ}@B?yqY?cq@ePOZ8z;!pSsJmA%AZu-9mb+pQ1v{mU+B%m#Y;_R@7n9mb6dUa3sl zDyClUBTjiCS?kz!&&=x51T1H>+X6A)GUI$BMO-%TXU0S(T-6rE9WK3J*tl?BU~!!m zQ;-L7JW)XfB4ahlXIX&_yup(7I-M>=qm&c`yR`mRv6 zI4kb9`r9;TsX&h>z;W62kILp8(#lpQX(aRf>7t>t(D11uFMeUqZ~}@!o?=NJ6ua)3 zYGWd`n>*|iFQnEZsN6qAXTTMMUe5ii3hja>Y?3CV3u;0ndOk#8Egw+5ZaWP9q~K_X zS}UTRB0k!qVnV>EM~s#z8XSC#CQblL3^9jC4w5J&3R;OHX7=_q^tcQ0)i--7l9wGz zic>#JSz~Ck?MDuUVeyf(Gp+K7bWBK!REHmYq(Y^W zXJtLNp)+a2p=xt|Q=Fk4o`l14#I*@hcmiM~JXAJBsxNHRK*u6cta$aL%3tw@KilmG z+i6HL|LaJEEJgNajN-SKof-K}sbdEAim;Zxz`stzlW&(O)-_Tn=DR){bLkAftUeIKaux)83x427~KGObD0pMDt6x>{E2F+dpXQdYo=%iif(Y z*GyYX5Q%N#z6mD%rAL~;IT>;g1-SIEZ=?yv_?x9>Va*wfN0r5m5)t=qjZ)uiXjh8s zU_?^ua~t!@=Wkq}4+nia{$JtPN%GYYj)deJW#Z;P!y~M=*f{{n zBf*_lt80^joJ|uJe4$I;t&ib&W*eVc93vIq*1iozMeHq0?)4@R_uCnBo+B)CG$*e@ zl^c9ab2-jOKH+q~oR>yXZ~iX5@hj0g4aMR9TQ>-Q0>60?hcwD3fYS$R0;_x%;xI9% z)gQTXZ;kFYkz|`Yo6#G}S6x`*qu=?n&1K$V+d-DUh%s$+Pl`QjDdNO4zn`05`B;f8 z5rCdU)HE8KXq!U5uADfZ>{;46u?=TZf1jX90q)Xmy}7L_59Oe9$o)Zk7q~Qd1AHz` zx#=^sHEL#iug`@tI28iu5-jYn5G)DOhdNx}4ybMW2wq!WWTT{5y6%NJ?Kb(z^m3JM zr?Su|4){Bdw@C4`LSvr2J&bc)1KUgm%QU+5ekShQqy}Nlvo!|mHu`>U5873>UVER= zDp58IwHhFIo;|KO_u+7yU{~Tc))66ye^J;^6H{UsF_w8p_5q^xsECMKZ37tydnR`^z zP4WX+?jWeY*IVr$a_Vp0BW@);)dfQQh6g-$L=bh>6>V8?R=J5zsrFc?>o|86LXk4$Y|QmRBr(ye1)BCf>Vk3~N* zMb^5>dN<~P;iyg=pG4d}bd!5-4t~q%?@^+ydY?NkbP!Rwm$7)XK@+wu?b9=i^e~^g zXOe}*Z|D5lL~s8LHIZUG*PEvV5`x~(=EXst02&L=s2cx})dyPhi&6qH^53dGdY^iO}E;=0Rm7QBx z=EU2!REi7HsdME7-3uQ2nH>yy!Mb{asDiD6`^}NsKyrsAk>|12B~3oiXoVadJXO8I zv2XB-;bZ!!7q^c{Gi?`AAK~+XyWE)lX(1QlwY&&JqgB(!a_1&4yj3+4IU1X&_fc{^ zdV$ldnBOLRmQG4h^Q89BfO1e|`ZlSMD9Q+v8crN6L|w6|yU;FChHzF}oFyBx_Sy9> zFR|fzPGI?IhU<5?Q&1e=i4tt8A6REQVB#p{qT2`$Yzy#l*&H%9wjq?)2=@I>Dir!N z(c5*po^y)Z&SLrJ`(hz$;ZsYBYfdAJfr?UB!16=%OQ9?;oGRmcDn{ zb`dX6ZEMo0{6^_B6SmNpy9%w=)e)gy&ecASSku=(@-Z>Kk+{EI%7Y2Fz$qQM;%N<$ zFWVXyt{9YTs)T%LF&#y1vn@S)Ma~Hnn5YL$c@>Eyqqmu&kn*rLS$JB%ktEu-RN%U# zk{GNr*|N|~aMqOJSD_=uo8hC&fM0cGHFz;fV~t(>)k;E@)LYO(WYyw%NgDL4YNoe6 zt6#v)kQ5<^!Fzl7jCrQ7sB zraq48H3+9JzOq-H`hJ-b{$rEd@J$f&Dfh3KGu_plu3GTGImDxX1J?|H+q=8NTYj;j z($nQif+>QLma?w*k5oGqJ^|;dWaBqnDrfSrAJr2Vi?)%{1XD1_ZI|zz%n--S#c-nP z0=0bLvdQ~t6Hf6qV|+PgX2>;vF;72oS|Ik_8s0f~StFKqs9H}|w3$Ef0_R>aNlj<4 z^DPn|p?CidBo9k1_=OZ~MnrC9gNKei%d4aRMLq#)CFwrfyU+t|VhdtL;UJ(l(|4>+zUDpNO*x&xkF70aDgJDRu}kYmWO zon+0=^$RlIX~Af4P$wxH7cm9sCGDf@VNKySs+|xeU=AyV$%~I;lV%t%z7B8$a1xDjf@yoYS#lfSEqE?RLYK2WK6)y zH&d~ln6R_R9i~tjsxM5se=?W)uJxrU;Ec)sC94CRV|FuB46wFTvBFp?tFqEA$8W3d zgnlXEJzdX1CJ3V{AEj+zoXbxA0#cS@F~hAO(Ox(!bqoiKJ-ob*MZimJZTA}y|Eb4z zT5!AB4iBAjZVzo>Ug1cwn&Wl(gZ{{NL!x!ed&2sP54{GSI7cg&6uNmw61n(CemRv; zQK0}*36n8O-fJe?QAG>fh@W=4R;=G7Yg=>@SA`DtX&PBbB4XbcR#i4unm>4M98b5* z#W>Hv!%wqO``-nDc`pPCOun{6+<5=?(djcb3;l6N9A!K6YW~y0#``2O_c=QPT)k2Ac71|tb~Z&>TiO5kd~bDjHTV~+4~c&@8eS9FJ>%8FW02$ zo>+Z$E$^ibajIaKXy~$+`7T2PwtE6Z=rdu|yAb(w^)2lfG`6<@+8>a-eU)jn z8)0gciuoz+WHxq$t^LaYFP=yh(h$ZTA^kjX-26Er09InkS8V?#3=X=Bi>5raRR2?d zk5_zB`zmq*XdH!qEQgJk3<0k_hD6 zdl|bxu>_W*Oy0~i1KO)LR+x)nc95RbWu}y&eF1IV{VP8so_|RH)KjtpVo2InY+MFh zrr-Pp4A>{drM-xn3pz2|4!GQ5S^kC3JVYLZ?wb~NI#anju1U8!`derGt->xN$wSoR zTSVF9-1b=;l;*1@`N}}CkzFHYr$}1ANMkD8H1PI)?}Bm%srW;&edy$8EtX_y`)U_3 zif`11YxY;NK&yMRWi(n*d4QVzR5yMTokeW33i)P|PMl-=i9D?;^fk(DpoNu7Zfg_2 z#p~>Qb04)qNL-#RZ0KV>94o%Wf@|H2#^_ajqAHcdGeubT_}}5O6K$q+WVimGiMnwH zQMp(~Goj?@F5VG`Sp%~xMLvnIiRUq2Q&KKP8@(lE%1J1J)-yX0NpnbNgkap6T z>YbUP!tCv3&$Hb~t=u;%lJaqXxV-6=kYVb1A8|||CL+>b=KCXokNLQ1Wq%`W%6^nZ zXEUtr$6BsKlMGMc&rxSNYXWpq#aZlfH+vv22inNVhU~IUB zEsj0h`DdVX9{kU9~<$ql9G}R$rmzQMcUd;u$oR+%qFp?T@ z)65t}Vq^&`e~FViN*g#{xBM{2Z3AQbA)Kb~O(HeAVKgEB)1q4}N;HFJE$Ex~XH7N} zYKbSnvj#daDTtw=GeoX)&Z*Eyp{TJUE=kZNZi(w9H~AG^3ro%wdl*PIf8{ulXLRDt zuk>t1J!!)qe@1IWafo)Bn0V0+qVCo>!y8KQqLrK;H0+B;4dw$Gea5!=`o@-w%CyJcu3WuaZ9M$79o%yZRRtCE>T7Y~_> zJ}aY27s^Mkk|m$r%Dk51moDs5qi9tr%rHtK9Syp8$9^8b)zj_<2w{+9xluxFz6c4bv5J#epXBAoEmEkqYkvW@|I%c zu~bjBh7WyzVkz5Mq3q|5rsCM$q zU3JJ!-t~Gp$wB+x*5fn&of_@`;?WT-s?+Su)pkzoI@>@e(iCUM8#4Hp#<0_!_=7<~ zw_&dJ>wBZ}Hs@)$fSRt|Xq5$LwzBAc7cUrEA>K7KwK8?BGA&65$G`s3HYcgKEfYCs zx@wNl8T7u^nJOMA{zDRWslWZME+SJQ0%M)SqO4`;NL)Gj)$W&&Lm&>g$EFit9yn|M z+@F2EU4-Z-w1bhWtznV5S;Ud&sweDKosTI-LPN98K3BmrSqx{2I~(D$66$%4QB)w2 zKR@|*6{w@iIB*S2+D-^79|Gfn)Cl*gs$oZqx7vL>Q_-K*_H1p9_6$#Pqx6mVw~d(g zSFiR?)moD z4?AM!zCw3sD0BI1Q(N}X_v(tOg7BVP{Q3@}mu^Af;&DYR1m&;U$DUiI54z$=Ue5a1 zc6Z^*pq^~2X#?Oo+fyo-=GILVNCpbV?2`%pdR)mPg!#vy-Kv?u))&J)y|Y`D`Imwx zw%3_JDUgg?ozLcB$p6OAey+>1jKY3ST~#;$#h0!iGCc0TK5lvw7`v|ljvihER^KZZyH{JP~H;A6YPKHw5#E(lMHXt(tQ`+~i^iRrh;1A+vTRLrr2@7G+F9VC+gsiir##XZ0Xy;Wr6~8?pXb;PLKd7{Z z)r2Im-7&-OgD)d4_3FBs8yceC23QhAEph)wA08fvu=%7ht!ZA|-gI5@kWY8bj={O5*FDV-&7Ihq@Rdhe zppOP>4|^B)6aqJg+;>g}EWAlyp#2!8CqkpsaLgri0F4643sGz$s3L|orKK|OXp`vi zg^%U7P4FWpEU=LG-(`TC6Gbmm3IvyyM)>aA-##h0$^7t6FhnYmd9Z-pAqGuDUw_Y# zsmQBR@Ok}51uabSmEtIz@j6jGEw#7w0BpaBMtD<56;j4=dkjo|cv@_Ja?kbzfK1B^ zUr;=&5oJvRFsSTQ3jQQR<-lhC&?oM%X0itoAn{9m4)g`mzusHE8sVj6^ZHw6*8I*e zs2TP)XF&&A-7lrIUERA*HFUQWnk(NvUn#O-|Hh1ae^JjOo;oqm2w*MxIVOglU~V^! zT}D0fI^kfqvu$is|;Z zI9YWDfOV#?Hpz|{Nr8li=8UOq;!6>!GwXBX4?UYKpROin`V8_x)PK_YfwX}yfXww_ z602OSLmzjIWQV2&ClJZz@)AQRKA&o86Ch9M4CUw) zy0XVe%2(Ro4P?!s@H%?>`@LvavZ_hi(xzGQc&r$r_mzqq!j3Y`a*|}A(f!#N&RweN z^-*ebYpLfr+oaF2-1INM@@3C&Wn+Jx{r3~h1K6TsA8V$N_$*>VMV6>Yl)gybR!eK} zz4D@ST>4Bu9tBQR%h34f=y)NhJGR^Z;WbnSZ*v6#sh`G$c1F~hy;pp9RKOrQwZY() z<)P>NNIk*ZMFzpJOZ7I%?@mR}B3TZ(fS)OU8RoS@udYnD1et#J|sE!)~J*z(ki`>3DY=Hx&72!GpavTE83jj0i|0Y1@XR~|2R z;SX$Y=@*tT@CMM^HFMFMmqRs4)(}yH$13)VtYIHH<$FhcR+Ic=TssdMY>s6J+2c zqG!WC^ebOcqh{>x%2(e~JC0ezkHk2}lsN3`dFUex+^u!dDiW21%lhhGQ}_wc+Oqj3 z!%~b+L$1p*$@e((2;~HTdm+G{qG=&IZd1kmC3Sx+!&El^YN4eU0J%JXl`U7?)jx1V zJ5y10u=9!28r{$DqK+VfHz5sfkG?`X<{XO+#AttM&9gnMW;AZz@WhbHCdAhZaR2&8 z7tne|agB)CTZ#%5lX@T`wj3*$tTsmQz%GpusDo3u1f4j|^9|ZK^>0w@cSK<=T7$G@ z{JS@PIg;qtP4Fi`xHP%R$W}JKg6my=MLfA$L^0_3jnm-ti8nI`l-nu>Q)|;7BwU+j zG{aNnQgJ%4KJefRfGWh11 zQlr3NTvA#3d}6Em=wz>!7x~9-yvZkkSuaiK2QMc)PrALRqxJe#xTwGnNdD>4@GbUG z4%?rF2C=ix-xIm-qgpUR8JerOJ~{?K0l$(Hh-E^J7I=34wDC{TkfKMTNroJn?&mqO zjmLZ9CqP5BHc?EY%w*Ru*9H1dZnHO^ElOhcf~jXWIOcLQM&r;XJfyu;dSf0L8~7sl zGU3qtdnW-0KsnQ>?{ygJ^6HK_MuaWN{j=5oy?P6v_s@Gj`R{+6Cw(6qtW zCQO+r#1@KrW=uhE`dUuM4L0U-xms9v7R$b;LSs=>YPcJyeQqFyFRwCP_={8+6uNkDhS9mJ9`?tMsa_b)kKG9HZG4q!A% zw`d@?EL$htV&lXc^hZy?rjMNf@;Ne5u+Jc=9Jy=TiT%mLjA&fzUPCFQ{s0)t(_ps! z<+0+*)$#E!8lo2M*_-ChT%H9KD{B4vZPT}7haN{Pzt}F#TpCsWJ%y8Z_OXqzii{Y? z(dBqQFvbTCVlNwWt2Eg(!Y`R)iPw+2+8n*m3tJi)HdyPJdihSOd|#6e(KcxQ5@vRf z@b7iBcjURWuQ7L44$;s#$G{+W%}XyG!F2W017m~qzzi$);XwG+Wb9{pKAwTf79EC# z(cjA#63?(^D^NP3A*Vya$zxmb`vy_Vp9N2K)}p2K8*et<$hBaAzWE8>*0)IyVAf}N zODfQ3Df#E^U;o5d@xXyXfWZL+V6K48xGg0cjK5d)^PbO@13PSz>31!GH8gV=Xm^(miYV0Uf5VanA*0rj;dzG{?56C zvyRSM9hJ_-FDpS!**(?8ilpSqC5g;7viGi?zxq4)yfE=77Yjsaxx-)q#04ot(J-5d zC9R{*QL{CrD?7!6bI{q1V9T^Irj%DBRDswH)jjx|5mTk>rj7zdDHH1%@BMvWT>O-p*{atRKb*iG8}?HhjjW2+qph{-8WUZgJfV80|+{FOzCL-b~_ zk@renQwuJ-SXE7H{m1vLUOA&*m7Y6CH7i(SVsv6sghSFG(pYct<;vme_}}2df~pc< zN7$HhvW7HmV^@>Enc(moH%Co#Yof13;F&P8Lrk;+rA-kggE@2yk`ho&9E32-uVs7v zEj~UM;W6@>kOl$;ui9^=qcxIQF$B5XaGA*V09#LMIM%t@Lf003-9?z1 z2*ec|kAk{Uyf#11ow(?)GzR(Vz~c6>rE8WztG53v(VJX??5kZpHR*|rGUDH^jV$=RjL@8t`v?& zdzN2HQ?LK2@!f?)d=xQ5(QInecsE+@TF>)>FaZ6*?u%eUw;}Ny@^-jpaJxaNoy-3P zH9^Y09-l6cWws3i%D34iyez8HM8yU+EQU-BdICwwr+j$$rQtsaYBstqve4;q8Ex+7 zzX%#ba$*KJU>NyWhJ3N)a0fh(qj{}t!fT^lwfzW=776Zi9~HhU=pVD*wdg`F7bIqxOE z`5g7~>UF9qC%1i$&%qxQtaVwLyg3}Q-+3QsY3?OM907{}bCy=;(41qarcbY0_$vLp zXRcq`tUhsTiDkP963E5eupK^TcVbE8u&*2O#oxo(6oaXMwG>%?;%uNz^cA zKpC(G4mce%(-q?X0JPujF{;|!!SLqm?AokxUaiAvvDt_sySJ0)jo6S%sLMn;5*Ii) z)Pxe;)6y=Skh5Tne-X$(T-H8^dcO|*b0(BkR?Ab`VI_yl$=i>kZd`gY zp4E26*(Ou7J;6z{()dHg5L)V5SBY($h*DUk zW*y=<-TwfNlUk{FDJ0_Jj^j?$HGA(3_#4M7tH_dA+cux6Miq8kJT2vA@-nT%5J4S! z5nVruZr(j*10u zo;_nA$I6wh?r#c$+jp{e?b5m1{{R|mR?EJ4m^%&NEBoYg`eM4_LTwx~#jb6S zYF`+~5Dg}za^vL;zynqv#_Mlt;7-7lIA8%B*NfYDy5emxOLiGl5M*L;wY%ff`qtIQ zi5XQUxB!6|^4mB#>zawtX_fV_bo5O($Ci^^x7pQ0oQ5piu=F2~t#lS%AzPS7%%Qz9 zIIj-SwdJPCG5$;Ym1r|>4fb*bq80BX_o7oB8Z z-K26BOpNCkKT%w7gCMw$IrNb@kzj4=j6Ue&raN*!$*aEwJSngEYs6CcUV8%CV%`g@ zSs0M57VcxuW1RH$`Wol0J4Lq5p!vEVKzufRN#%mx=SZB~TdT_ZV{#b%>|+Fv;yFH} z)1P6Uyl__G$|l(@T~wT?BtPBjj!5god=K#5{qKm{8+}CD z+(PVp{o~B}NINl+yOGzZ8O?nw@V4o6y=qh9%c#VdX<`Wz80W|dy7R=-%{`^mS5VFleE8sz1E$=apoASyJI)*BHT4Ddy&B0Tq4uR{WQ}5y zJO$iAz{eOM5`L$>d4I(Z7FcPJv^JUvp6cT0fh(|LxedIGk+&xuKdpS^b6m!4r6;ND z)1ilhR*F82_&ciU9tH69R#x}INZQ$UHo`NWbB^8Xtb^ku340y8xDl|+5-@S=UmoZ` z7!H%AuZ3l2k`Iw>NoL;?ZNX2N5yKJz$@+0x7C#>?t-}eOmVYd&+7{zDz#QY{&OVs0 zCNy&zb-Cj=@@94N>>eU+Q{A6Jg>D)m%0Q7%Dt&9|t4?sH+!fzrfo^2S zt3Qcvrm(b<=FnMOgu0G9UbWPBpKE0{ ztjIv}_TVxCauQAIMn*7kUR&e81ka*=)jtiqRpTivHJ=pfegp9ig=eTfp7Gi}^3A8- z!p1S?7%>&S+26cprzMmRg{_FrtKpi&QIsktbndxdm6LA$EV}D+zLKLEd{Q;Yhw0HuD&eP?(o>cZCxxWbb8(q@%8=nz)gT(jq++HYQU@r?>S}{cq zv5XDFa3mHP8RHz~d^h6X4SlMA2`|Jn)U|6DX>TmdsBWW2bF+L)^932&4msP`t$P&l z(yN6~#8PzJlio`I0E@l-FK*{Nprb3r-p32$KZ$zIpL+#})qFc2i0pL-wb9}67Ns4W zckIx4grViL<#~kcRzJIAjk&I8<8Q=ohc=!o(KO$R+UA?~yA_LA)AZ-LLP;kM0bL}I-x*M0Jdw3z5Sj% z5vcff^T(3uR;#NG0$W`lShr8~h%J28oW?-`Nb@6BC`Jh!*W$cEmg6bnUKYM0q^<8c zb7=NT>0ilj`JS#9>h3)4+4i=-nVo&{j?=^*9n>^S=Egm z9PoZ(0V|R=o+rUR2l$b!ctXqKb zstLw9JoFX8{08u+i99oHqTWUINtu@S1+~HZJkdmt!jfj5ih{(&3 zMm;TO(xkZ_E}mH7OJtHLrDVf64TfA1k_kXSUQRpKm>Sufa|q)qKYsc)lli3fw*LUB z=U0V4hC2@M$BlJ6uN>=|UH5}-?bgcfIIZv5gT-+h#T)O8ummV4YXOiQ8nzvnPBi%#7)lazFR#m z_GxLhy-~&N-R_a;J|w==yfvW7JLsXIQmZ6M3Y_j>xgm%IbCc{V#e8@1zh3a?jV%04 zWua)+w%!|gj-hjXt0WukU2C)7td?WF#rnwOKGo|=?+U0J>qj~=T38GId zcjT_!s#G|Q2JbPWk7E*vxDY|Fjl^ai(-|B_7JR&}>ekZVhvs%d3zy#29)V-~T6{6T zn@qm8@N>1r;Arlwtn6ZDwq=p<9hj(9;iMdHV8E)9aa8<$@wU&!`jissx+a@vVA@2} zTZ;{mK7v3J%G-2E5ad#x5S&RpE96%qzxMb^$o+SUw)`%o-Pm zZ#6wbP8Lh4O$oQtvOm$-M5@DbADos}JBK75;<{ZH=pu{xyHwQMNEfq}{Aq0jZNpq3(T zT+)`NYY$PoSg~<=sl_$KI-UG3O9LEm4nkvvAoG*S@0#Vc?K@l5ZsOEowURq{M%01` znL{?=xVnyb!Q(mSKGm&b;n_~I`qhHE%_05~fsA^eOw`t~>lRm!V{8%O4)aSHTsun4 zNy+Jqob>6%X778O`v|3N4p&h4<29bR`YhVCcDH8F%z_lOX&sa@4T^zTi945oGH`L6 zR5}uB7Y}?QxVTGOi-*0u`$EoTY5c-Wepyv9A;2JmwB&-km64|MGt#5#|RCBJpl zwIsJUH)V$g6xxv>7%G65J4atJ^TEYtXx<&Nw(&%=Y8O`!Y8R=ueaTje<7|I0g&3Wf z36i}!o=#0|TNzi`s%}lMHs9QH%AF;uLL_0KT)y03Q3pP}_@W*3us_HvFWyIQ;45*ox7`$Jxt&TmA<%NPD`Pw|cwj zmXAEMDy(s{wgET*WSkC7eEIR~QSgU~wW|f6SXnN$`|B%n_A7kIt8Fv7Gj2I49FiA1 zPVA`1L!Wrp5tm1vX=VF6c}xW9le2?{#t+xMe4p`uOYvo=#A^*wEv2NFcA9~= z4-}iQibwAeT#!IzEUa*>2Lzw1#ba@`F%hFuZp&Lee?d{F3pZow?*~os3ijAv$>MDa zNO;||!`Co5}$uN%-NXT8%bujs6HrC)2Jac%tw-`KrTjNf%ylyf@x4 z;1QFKm4o{#rH90Cg`OAvjeK#hL#*k(FZg}p8{ZR2ZF*Mm5_^c_Y)H9|U`5&e>|sI@ zm<_vieuIKY1ezEf!poAb3Z#JfXY`NuEAS?n@UQk&@E^ks55qnt z(lq}74tR3kP1EdrWG#lMut1_X+TdErBtk}23_`c@aunr9=2wsWAMl63zqa3lJP)C0 zwkdU?O*?5{+IpUp_fmNmcaX-)x{jN1dGd=;o2_nRB*%~gabK{w9$Cj>#w+Tm##Gaf zHSBV!Hnu!h_T}*vM3K1$GC^#P2*~6fYs8i#GFbRE73}1??|Xh9aix{5eM}z& zd|>g1h<|2{2jWkQ@3hG^eS0%P+BWvKl^#cUgg#=Uy7?hS;-H*v#Y^GOj?igH@OY-- zY$RCKg3gS)ff)rs89z~x=xc`krJKUv1bz#AI`GsUBDuKJ^f_ZoJy*;hzA)OD(cPmP za@)zk!jgTfmhdmeO$){PhM{?IyKW=5+AiFj72^Pt(>|Rz&$WIr;%;f1<@`$u_)3zC zj3TcWWUk-I{l|U=l{%E#l0C5g)1C-V7hHHHd|9QwqhJxWJ1@5$E6W~tB9X`} z25ZrD-xFzClrhN#&F*mnjiHDzr|*CBx(>uUzm}v*KMB!1nOAyLoXU+a?u*e54}fcMO$ZW6##Qa9nkr zWVi|#s+ApeQ%0w{YS-m!ZChI13RqaqPAfya{l7d{@zcRyvrez#{{Y$c&|Pa5Gr=X@ zszh2@tc&fKMnU-)0vxv_D!wpCBj-(j;E((iPvhV0soD_LgJzp!Ek z$RjJms9hCyiDZjoH@(E?dASQ zL;HXHTJYz?Z`qqw@Q;ZslV8_0?J=yZw2N&<8z;J#%Vud$nEwDQeEVJmR25g%v7jR^D_bf>^=$o zs{a6Ke}}&oJ|)fL_tR{yb%?E`wbMivaZ7h^2xoXAlWA@0tgRtj;6Cnp8u1MW#Tv(p z+6^P(HRiP1j+--T@#)%znJu1|VQ@|npg0YZ8TO3v8@52^zGAl**7nk;75k*$-?i7> zZ7;7(XtIVG-;LZSKo3&fU~!*MigcPY zB4_ch%^iRChi{60D38VV_i*Tz$|AG2(yWqCp4-Y!6q3lUSQC@-<7Rsr`h)gL{iHlM zs_R<6fVErgbNwe(M$iVXWxJh&MTd`i@7ofX%L2yXr+@HK-wjFoOnB4b z7lv&0m%i|w{Clj}uA8a+Cir)$ z7~gW<>-sjKsm=kt*EmSr16m{cc@ahm$G_7U**i{bwO8k6GfHJam9R$B}EOT!F^HsRow zGlR9VtO*#(9FhnJ`460_}bYS-QTZ1_3b~g zSM4+5eN)DEJ{<8ZdhOn`XB!wGvC`1nh+a&xJ{w>_&A7YmATd$UHGJ0?W1VcKq$%Fb zYi<7kLrPg*BM&tyi7%bc)J+q_w-$sXJ}LVgQ7J7L0Y(%Ioc{n%YDoSqOQZR-YJMoQ zkR{&WKw|z$9mpKu?jW3GWOl9#O!(LEvfnm052G%zXBs{3on@@WIgL*OPcAZBYh-=w zjGS&g;=TBx;BOV_g4e=Y0Cu`%S!A{dQ4oMh+yUcnJ9ExOe5|wF6P=2}|{VIt? zE1s?Y014)yCECqlGRmtW?kWRtz>(8}D`wxs*B5pY++JOX7p;+#%1F4oPAO0FHx9-qMi?J&nKUGA*h$Vy zeSQA`#MUXI_~uKkJ`0D`B#~KONnyYM@KYpUjAJ505p}ETB zqOQ)I=ndgrE=x%CM&6s5JeFLJ2LNZ2&wBXR_SN_y@e^C{-ly>r#_ve8(WQPZB)Q>HktuRLe*o8hO!PuVil<7dU+58Xq5s@zLzjTO|mfx|E| zGXuBFSl4;T$@`-x73H6_uZ#ZxWnEAH3H5F9{{U09npt&y0)1D)cNzw^^Fwtkai1_s zk^#0Tp8`?00O3`O6|dO1JB6{>Jasyi7fa}y-=|OVJp4skbtA}r9eB3=rzaaS>fsLP7z7 zo^U#j_4@=VD7z+~qc~v+cF^-UWs_0YzS8kz#>J06!ZX*3`uD>h3LjMX72uBxHlDz0 zT5H^DY=}vXZzm*{z~c~=C;tGgUoU(%y&f9YlI{%_+f}}n;y7)s?_e(;U6oV?3^y@j zj2w=gdRN!qwT`3W-+AP6v_U<+#8#I6O|pd##_hg<0N5W&^>A2vQmM~3vB!*^ zS^nxBPu6dTfACN{FAZxNhKppde`8pbx6sImw!OM2RmKK$fu4I;rg(q;3On#_O$tk& z8tU^~UaX`?X>DO7o0kIzAP_$iEBT<+e`)^!+E-AC?XA8qYSG3V?hvvrM?J#-0GwAb zFU22?n$_o*sr*jYrB-aQ{?m2;0MJOSKChKieAATQ+;RO!G>kc5;}!G&0ER!My>tEw zt@}Udx2zja)FucH+(`^)KBPN?UT@={_$?>F%Mw!8O|ywX;9hHRspHvmUxk|g0D?4& ze}IwrmiNXw<>!hu9Yz@7kNZu$h+*2&NJ^8rjy8bV##DwIrh3`+ei&_8%Zne1o?3%l%>4iDN66cJV}69hfC`Fb>Cl`MN{GGFXF8$`W_dr z{{X>Y{t`*8-D^qWeSYHR>}``4%ti?(Xk4&feJg|UH~bXK;ZC~DTjAaApd036cAPQw zA%;CG{$*Do$Wb4!v6q)?7tDeYi|$y zc8&=&j{%z)bkbBr(_?q1%9y|v=k4Qzad2m}(-=Ln?^wfQ80Q%0JpTYX=4|7<(V_b= zoGLo3ToK z{{RDcj#)Lm5?QXTtnOlXqIHrM4{E`HZh^HL83S)Ta1XWAPKk9wFDfMa9OW3@aoS&kX48a8zJIu_;g$n=V6o@z!d-J6#h| zviL~)tXCSYulw6mF36?wq?Lq{JdgKJ4t%kUgeM#dgW~PRo2U3I#&2)qcue}OwZ@g< zznNl|;9fdH@}Y7A;2fzr7&+%SJQsk!Wgm>+5xh-paV3_qYZr&^ji$M%c$)CDYO@55 z)>x!aTWAH;fHvUpPJUmStILU|>f&c->AU`satX*$ z*8`9%&VD2ON%(o8_?J)6-JQHirr9>0WQ8$pZtkN28O93&6r3F6IXq&Yr+BVATdO@r z+U5p%t(iXB(H*xCf{scz0|Rk69Cpokbm=}t%)j8Be#zeH75sCrMQ7sceJ}0vgo_eH zH0a4&`9Z<*c5&t4=Q%mYb6l6i&x*H@L8;k%UD9+p?=2^qYdc8{W_X|l2HnRJDJ%TJD^-qW&5cQD}NhmaxKPzrKRoGcJ!-B_I*AfxHHADMqX7X1}v57Mayqt1#(MK!W8!a$l6db_OPyxrt>cc`J7|(G zmt+XLLg%SHNj=H>W6h$}B7iiCK4Ni<^H=;isML?^FnA0- z2u2Z(i(}8LDa%`s_^0-Q_}Ae-1KW7^XgnRL+0SonGh5o*+?k<{aCSR}U@?#o?JNTv zXOUcGukH8aMs)Xt$9_1h78WV!7n^#s>A!{_w8pRC zZw6m@t4Z+IpQ&5U=(>fK;u0;wmignr^lnFSjz%g${{RIlp3z0K{1MQeHONxeFOog- zhx5&OFYL>CZQ@@TpN6`Vs9kOeVzWkHmP?;4jB$Njjf35VaX%4!C4Jzp6kT|J`rbq_ zIr7$3D#d$bAM>2meO?#U7OPZ_iL>cd{{VuMSYMNGd+=9BjyF=SBfMfdW2cqJ;fj|- z{kd)a9{6uh@T8v!wCz^f3nlVz=F|#2ksR#=2uR>zdh!Qq`4n~ghx4wQ_UzvHF2hlb zpEky3w|xHqbo|TxMPJovv>w*4HTjRXeir`NdY8lx8UFxm*!(rMid*d=t?q0tHG<1J zDO0>3By{xWBX>MkX|4Qu@dbow70<)VG_=N6-7d}*fg>Td( zyFDvhxwwN)yo&uNNu+^dd1EC{%F46C+glBZ0UUE)bEkNgZv%MeOYuE{gvAWyr%CO^ zp^$>Dlw*eZSe$Tp;EMFmh#$1y!v6pk{?3}$z}-j0vtM0F;=MOr@Xf<$Hx|*`$rLwM z_i?+(=U|cPGoz z55OF7LpFPL6<1R6Hjw&sLVHWOR5vY%oN_VLRMgYVK1|r!GrS&8*Vpi- zX+AoJ)+uZ?4M9UNQn5Z>FH-{X{fc?AY$cI#z#zK5=Y`I%wNSevrV_{36eQPZ*NiURohpV z+T>iqft6dFr#R20DMBozQfTz6e;@cqOVmvIs$YdG_aabAl6ntO*NVH~zm0zg^c#aN zuj1Rqib6?2XDc!ugCr>pf#^kfHm%}D)RQ+b0ke|(3ZCcsn#s6;LYtL0#z7^zD*ph5 zV>riPRjMQ2buW#-1vL#%cAMg>i6ch&$g!O_dJ+l@bDnx|Ij*O}z9{%_;)^RN7sb=Z zaeD-Y&M~J<{%nZbb_P`12t0B}P;2Da^&LHKcg3&}0Qo>XcRqw;Kb>!BS2hs7$&602 z9Dy8w79QaJ1!ZboQEIhU)cQL46HM0<*7s0&_B*GSBoBj}4y0i6I*j8Lb{ow$%Iw-f zsWrjI`p>Bk&;pHcX4;eYKb#gZ7Jm3*gHk|xVDf4kjA8#o82<6k*`&ptc1 z)S;Hu>?DF4P+ocW9j?D90CU4_;NWNFUP#V9p!j9toi&ZNswKINVN)bYI6J{0?J96V z$T{HPgM*Bk`OLsJ{F_EF=9&t@&{ZXe7rvM6}a z#tVJZl^|ye(~9O^O?SY)DDif?;un(c*6&Lb=<8{z#@6>UH}6(>-OrZ~CBsOl8+Qx< z10H9yi}#Z{6?Ye7&@VJ)(Y0r_nbE{;wVcb4IXFL0L?ysrN?l+*`{7FUacQ!xP&hC%!g=+P?1nn?Gs44tUby4!PK14?K-ISl%J&Z%t9l1R-I_M&La#iBc- zzYp}sxv*a{3DZtZ>xWRx8yN>?c^JUWdlSi)E0%QS z$u-q~!=7b)bX_+Jkxu9B%l^~e2(r{I^y&2_N0oOvImt!IUT`=&l#Cxwdi0$eR<+jj z=(Q_XSs|V<@w%L=DH#NMf;q3{cg9JnXqeG-J6Ypd(np>+3mxh}13hv`1OwLsynn}E zwD-qvh5CrH@NdT78tE}y67LR`hA6kMue84PG(_t9ioP z9>CY~#qh)S&HbwUQ*}MOU$tk&h@^rr;9LAu*9Jj2B>w=V`-<-LKiYrxub*38Kg1uk zZ^diqW*azZhu%89%+Hr)s#uF z>@UzaY}Y05+e`R`XW?k0_@}Pub9kAp$iKMo{gH|lC77vIkh2g68Ey^syU3aU6zxjEs*;cC~EWd(M>ywcaxuWs9w6wlc6Up2zU}#`oIJuPoP= zcZ(nvcQZszz-5x^-Zqf!bLJe6lNI=;XTq888xhY&y5{Cw-u9_Cblvr{?bg~O(S>St zUn*S>y>+hy-@~V9+V-2Px@uN`>m;|{i*{5LZPBUR>(k{YusPzF!&;Y)1*x zcz*u?PL{&^&$W(H?z4!bgtXB-Y7$v@d5!`rfnL{t`)c?v!rnL4w2QOjL*fgK8cUn~ z68FP8jl_(W@k~VU#S~0hBIwZ>BLP{~HNi4OU-I52$TKXfGL#e?pDL7W?RC|zseHVi zrqISlaMyn`=xeWuI`4$MXJ_C|E5mw(*7}9qvufJYLoD{`E1k;#Abf*qA2$n-MnN3) zIzq#$_@_s^w!6G&%U#{g1;nhXP%5BbE%10|LNY#F9Ah=`7sD_3E0>GBa5TRQ_-po4 z@y(X0t7_KJTEpT?m@RGMOPRJ?&peU&k7ec|+^al6{{Xy!14zE(W8=l}KZb2SHGEg` z#h$n09X8`qhg_e-R+C*%V`gSwIvC)9xj$vatWq%wsukVBG=!dkK3olJ{bL| zv|ric>i+;v+pSJ5QpZkcp5+`xJn}rTmRTS{7nl3hFNX3?&?O?ZsYtEYb;6I8rN&Gbr#w`~2Qqm+_Yu!4>T(_T5ONN#0ztSxgm_~w76imf4BccJ9K-?w& z0FJyrd7;^#7I3j~96N_Pg<4iu@7ro8Zo=;5DHwTj*3vXUnP0u(aOASmi&%7y0$2F>4n>6$%;nWZO(t)f3>g562+341m^f~brY0fd_cllW0H61{~We1xZ$k{4E%P|A6Kh~#B zVjDL5D`_f;D(-otf0YkTeLwwmjj3NSgpI+0y?9I|-)Y$-O?-$P2g_e~)oou)t7H9jbA7IbrHLeO89FPXqN!vX4g{ztudx5f=4NVV6r@AyXiD|vZk48`Q~eBUZ7Wf=0w z3dI5Bobpb2$t*ng33F(!&S>EkdW~Mk(Xp?AJ|J4PmED{dutRXUj(GPdkr)tgeFz8e z2D%M5NU^Y0j?Ca^k+__i_)qqR_^aZd5qNrk5quZ;ixszsY*N}$;jJ%QxAWq+wYy7) zp67FLuCaLpXCO{<2mC8u0a*{ zIX-2D!NxT)R3hY_@v>`g&!vtk*=8zJZ(6 z+L()8@TQ${0!9+XIim;59FhP&{+^WE-E;mI2ZJ?_0?Do4=+|1Vk3F~Bbea6Sn-MH+ zADaxLg_R3#R_wqU{1E>Df|dBI_RIZ>KWhumfv|qxKNfsLVWwK8{*`k-jj!O9Ae>|* zra4EL!H|q(fD~XZ>{q`30JFH885MIe(~IPNpWSn$WgABTDmiXicpli~G;QMRy>%HHJNO4}fj)!72G73Gyq zah^KY!9VaqjTiQ~_?_?r#NV|~#s2`>hhOm)nXPIUHl7&p=An8nl^Vh2wvnf4t)!AI z(<2-}=W^h%-Gv`Ee&4^eZ~PS-<9F>_s%gKnABp}V!Ke5)Ot;cC`(K5LsGT+qOc^GZ z%~@^ZEg+6)LuE1*MmpsBRC3JMF2+GQLuT)LC2KCK?)SFDK5CJYO|*~IAAsKmJ{J5$ z@D`o%2VU^(vR}=qYL4p7h;M$3F?aEBsRM=feFO!EPeGw6Kf&GA1y_WW@8^In0+%>wv_0kAMeC{k!-J zruc(O_$A?69~JnoP}en8@b#l=TE?izZZ7T`6=@`YEmbmDlZ8;Dpa2T{Y$T&93B_B# zub-L2HB}|f?tEwe00pM_HKttu0KqtXEAWOdgYDxDQ%mtKgQs|7OokUWmiK8BLFY>v z4Zcs4=R=npP|l1BGOI6T`%wPL{tWnG{{RHu@Yli1Z5HoQ@UOysBTt(0%E~96>h9A| zvv|mgC06sDi40@L7;XS`73}{2w%3JxRpUR|r^Fr_@V%AQ%+tWa=-M=5RDo5DjG^$a zz`;&;D;2@X6%WS`3VcIv*vDV+N5PE{-Rmvjd9>{>PqCasBePohDzM4D1WW^ETO$QV z2t1FT#$nbY7N|{0q@1+hc%^6e`Ii~B3taOr9{B$Nz<&$>0N|hB3%@vWYteWP4o!jj2veRi{_$OajrjhKzd z04}7A9Fd+Y>|ffC_E^)tIeyKSo)o(APOYG7o*B{Py3%g+(2{JrTSt#SJiFqKF&Qhwg-8|ioJ+%w zmJ`j+lIiB>=iL}=5x0;> zKG+~)zcBv*YCnSi0JOirZwC0w;$Ot?3F>w>5_vYB1@R`cZ*_ki%u4HLEu4;F0@39O z8Hmgyg@Hau`PEzXx4}QNhKJ&>fp&IUbhvRgE zYcSd}ax3(%4B>oc0|^>9iE}oRQCg*~-$%LSV;pL}cI=j~%={?*i#{p%gIoBV+J)RN zs#`$=TMN^E*waHRfwO8bcV=HLQHqb8<0ihT*1jP4GsM3MbuCfm(e4++dL{ILS?V9@ za!(vAWZqkA7E-KyvNr8JXCMzC_`&-{{1EY%iFM2Gj1qW5Ley^VEw21KsrYX~Hg|Tb z3uGh9ZEp}@6;%e+UzD8u-!*wJg+4F%gT($PyZABif5cj7@b`-RB|JvS<7dV6yH@5z zbWqXU5F`LLP)2|N2vU7MAmFTRd`hoQ%GT2DY1jI)JbE~oMZR0x%=_oSehl#Dllw3D zbH#omm<#LZ6HXSQV(>~5$tE*y#`xSUk%FoSP*0%F5A5y#00k`gHQ`U%x4`}mo5eSa zWSX3xZl2E7X%wX@oQIi zi9emXK&IX$3%)QB({xaxzR=2>NdbX1>c7S+xO$0pTS>&UNEze%i-wtuMumS zy`-xSk#0hs1Wj#fH*!VyG4ZQu4{52YQe^B^`TS9WzQ4-!(X%}z573S@GaHumgzl(^29=F7Bg-zU7_Rv!A|7hqpPPo zcOST?g^f62N*Jc+4@BnP!j&qK+ zUdQ4Oi?5&>JpL!YdqN7E7rTEXsp>XoZas1<6I<2i{=n019ubKonotSgWQEQ>!ivw- zbv3fHmRKUhixDxaH{WbbSu@{AWF@5nKNbP0#jpAD?6%i{k4f{1)Uy7+4chBU1bOV1jAYfn7aNnnbQ!ZwJuBBApcLpTM9 z+EG~V3{`(B;w})co7Yuv@%LNrXXf9Rp}iX3#wy3^mxjJ9TX?Hl)AT4bIHuFJe-J13 zcC!`oTtPhXT8C!cxJaxTITAgqBA+YnSDR1Njhalcozco< zLI%)DJdksaM^*=R$#mO^{5>qNYj)*#J3CCV zO>c1wf@oy6kyb=u^L)NrpNXl!IJn~djX6cnmiFfJw*B@!8d#?|-K`G8!rmIy_2$%c z{bK&zzRM|^!J)Yl8QhsacFY_1d~M+W0C@UVr^G#84~PE%4Bu4oo}Z@NNG=vDYio;v z91*iHM3I=|JduzH&T*Xe=lo~muZN!w{A!R`YbkSZnx);X+G$SGLp-s~Dzc!)?4K?{ zoM5u;QcnlMf8eKoA9areTKq4t)pUJU{{X`G9s`?E@eS^g)4NTeC1aFK$ilDpV0NXAIX733fAQGePy!JZZPRc+u;6It#aCDq?dMAJ1B2B8#1 zWL3C?0DQz(8(if=8az^#ni1oXAR7+_$_|5seC*AgT4;@71A|J zpsnGL?MtZSl7JUglU2>$?rYy2ktngBtlcyr*Ekz;-v z1AWcPLmkOJyABsLIKDVQ4 z{v)@sRMqZ0C#Ky@EOf@a{{UFl>I?%J<}n<9a20Qre`**$)8d=!+gBh;_VQ&<2XrV; zPTc)ESJGebTpb|%D)3M2$NM4M76ake?E9y^?YpncmzRN3Qr@JSFn=8PubnUemwVm?sKkl#i)>0(s!1vl_~0;_$w}(g(?PPCDK#~U*qL}1j(w=&`Pyy zKpm{lexZn#Q;@zbhCWzt{V`625i?4k-`zChGykQq+R}A>gDeT^Qfsrku9>WJEWWBb z78EL4T*a#G9Rh38wOlr~fS{OMZcOTSHUje$Z8y@z9~R2hNS63QcRJNUA^%>X-|FFS z&p?z=9AEKYi^h~RA?|_qL^1Ds+s(>}4TJ>mEuwm6yMqZUqphZx zeDTQ&8u6f6>K@M1P)JS`T(~sKCph&Z<*?76vYVZF1hNLv{Tw{Bb@Yk&_>`?<6Df&# zuH8CWrxoXoLSE`?ZI!!^JYGbPe)z}JyLa8U9El^g3qr+lb^oyqXC#Vyt5f_RLHR$P zjwfi|`6V&9jXl*5k%n&X^Zi}RFf?<|Lv|uXPdNsW;7!_1hi!cRNmYVbIB5{UYF;e- zFwlvQBftEGb+GVa_5QA@+T9!h3NY$WmJYQ3IK2mcR}4fnv~IF!+VUHGR;XK(i`wn( zfgj)F{JDX=H`M{S*@gVW>L_6~C_90O)5Y$ouxS`AlsB5EGBM=A)`)5xr_W0FjP&`b z=t|LT8kD&d_xTpl!3d>HUJ?EA7hBcyu1$R=WfT0a{%VXuBICyw(S$4Tv85K!Rd`@~ z+%TR1n=)gA;fOPt2&erl#dfk`ZQ}18#{#ysI{sBOr@1tYxZA_yV0E>4Z#d4IR^|^)ogTk+geP+o=Nu zs*BpmK2}uB70<8!ejeL)2eaQPA>$AQ10t-Pupa9le>F`C=4^*~Ka|}}%{7!YVo9zt zX|cJt!tW&?&|_MQ73zaAp%0Pa;sR`pTut-ae=gtZ7RHu)F+7Ps($YwLxS9o!Az)K0 z_t2EFLUL;89j%V(y2}NOW1>al--0H~1YzM2_oOgZg8iX!E8w$lp(SH+;toY>g?o?8 zpA`r)IS%S3@P|Z&m^5>2ez{b8+Cl$v9p}wSbDPc1cU*~hJdyu=$bNhR5rG#+!{fcQ zVvZmAimb?Li|mbxWmE}lQ1tMQa>R8C|E#_@6QBREW%Uluv<8hYd=}&A`Xs9Hu&E=F znA`bKPjSQjIY{S6^?-%dMGq!C;jUu7)iP1C2*-zx3y=B!M}SJ`Nr=5ntMTnIZk+ZK zpjhZ0QNt7#R9*5o*G4@j$?H_?t@-vzb)NQ%GO)S-Clhz({-%4+BiDw8dQklxq1)S> za%G)aL6!SM0i2>a=))N}sHvk_zG3GNY4DrxYY#?0rKhEbz5*!Q6%SEhZhO(TW`G9nw>)6Tud(wN zu2~7L9A(+w@Z(F!W{ZgRd=FKwTGD`A7z?h7^xu2%&qy95v}2{KOgVTdon3XLrxkE> zl_o1IZ9de*!z#LZa#`MxDZdRH5Adq5$?4tnr-GZ7x_CIdcqbc+pkw`y_TR$wa>r<* z2Bio-uyxe`>la|u(eF~AH&>I4v_p@ceiZmP2I2ARXZ-d(VVyUx$`s-dVie-aNWtJw zwb1@s>ox`U+$l5tA}!7-ZAt~Dcu`S0=27s0Wiwv(#sI+t1A?xo>)jq%?64d~y(<-E$BeCXL8PZYM*h*I6hRNoJZ z99J}DW55z`B#z9Z6MfkyEQ+VMb<0P&;WjtN+n`qd_G5@6n^Y`~FqwKUc0ErwMD<{P9Qy z$&@>HEiO5TpTQ5l*w9vYwd<_!L>_hg0h|@nJck#3)Oa^Ha?79nM=)LJ#x$X&&xG*| zn~XpmGUiUy7aW8Uaef+8a|c@7DhVA*r%#W?kV*yv+WCNgGBTuKZfmaIie$voU3}z; zU6;uBVPQ26wzi}zL(0e<%MgpCuhYxX0i=S=7{^4vN4w|BoFF|@7gBRAS$#IKzxdusV2J!6M1{>oNQp7mfQ z;O07fs;so?GVNV32m!b7r{DQt_wC1XPB{sXU@BZ8LTQr4B8JoaNn?h}WXeskc?4mD z=%|~i=}@5aZ@Sl?8H7{U5_T68{2^E!<6pUS9q6q;CW-gST~#;6hl%%eweEY_nM0`J+6XyBSdyaS|k0lhfHEFF;oAZ?VYH18C?b&c{?-L z(@*OjnGQLhG^V!M*>dvAgQ|G&K*(%s=^or|+C_*v?3;`6m&GJx^;BJ5tGp6Y+qjAQC>A2hiAHaOYGYEl9@(s_EV5O!*N954!=i$0}c15W(1Hj z)Z$e+1+LxKUqs{*_3Hd;fbHMyVcgA~{cDD8n8KgPIwmPM1%?jYdwzc-9%m!I=>sFh z(Eiyikq@o=(({I7!+iq|MS|srcXPQyE#D`SYHT!g4Gg_PJ@RF2N1{iN!hgoRI_9JVxOk{tvRZ8Ubg7a+mtrGlsXjeYDO2I3D+#98xoCNWItExMx_Btfd zY0VPl6?HDfTK56t%+{?x6tB*7>xagRe+##pvfdaYF7;tj&Y-|a=CcmKF&nhxzeL?1|iao$a9q&IBb^C0=r(A1DDNDD2` zf_$F|uF88z>A~A@WuMN_I`u4Db=nss)Rz--Shmu|p zSoa9-9f81<3;Bk(MKJ0GY|1+ROBFbmcl!9}3=UGTvN|NWK)0~q_-9W3UVk)7k0k1& za58kX$PgVg+j3IM9K=B8o>l(W?1wfPhQU7m#Ju8eBYl=g$! zn&^$;)RiYY?cM5Kn&pGT5!qiFHxd@oQOF)3Y*-UR*%cIR$rGqicWX*l+Zyxs9v}b9 z!6wJqPZ&meUxuY-GUkWBL3Tn53B9043PezAY~VVA{9h&v0qVI0lG9l$!)h0a>&Ycv zAw^$Pi}X%6WCWHDKFa5TNM$)3B?@IgS+Gt)u5eo4P*g-eh^0O}W8LEEqV8P1+2RQK z)A@A~?w?9X=TbMPzppuMMMgLbPu7#ZR6`!5>W~^*P8mioHuuSymWvNp2Hvm@IowF$ zCoSxTPb(KQMTpqwt+o+mEsf;J~CGSlH=$}m@) zGHf9&-;2gE?RQaO!FeGl`n`zS3tdU_RERQf!%t~Qj zZ>q7!6f@-B`okMpFVc*Jq zq_f+Z>_1%02v1*MTPO#O9jB|pdT(~3>MPy9Mq>)kF-w*rLIHscA)aYZ#bqsOg8iN| zu-N>#+mV9(f<86GZn%R&1T_%KlLWHTA&7eVO2?hxJ;HSRL8Bz2M|jb|DJ9P9anCA2pHA^QRFkc4=_`tkQ} z!(H(&a6-2^ZS?Eo)c@WsTbk{&u}!T1YHIpCT~$CO+F53+G+BN0H+7K30dS$dk;iu< z=oOf8u4u{LICd2KS2sir&Z=lni#0yqb9*oisjJQLI(c51HQIelnkD+S`YDUWH$-5gR@77W^*0a7)hk0D?73ef zr>x5-%YFN`l+$#x4NEG~%Ba=8>QMh2WUK-ew&U{kjP;}6OD18mv&O+y6^s@hJ6j*r z#IFJP=ixBaX`+J*r-BW;VZ*trd0|t?5iw^m70%%LIEAyNH;Vtb?0oGlg&RgAK2ZJv z60Q>>tbR3qL4ZfS7x5%9KmU37@}72i^!yZTWbNxqzd$SsX!?aLO5F}-hjN_s14hlH zR(3&Ma&7>|kqNq|z>WX2!iyC}k?Uw>)g5mMQ+v*Q5{bgePb*!;nhVt>y?yRQx*9# zDsD36GJ_`f?D8{EiKp9YIm2dK=pd}XKr{kO8Pc$F|Mok`exK;vY&?2}Zq60htUIjl za?ez`B(24JB|x@}3oz-q%^c4ps(pa>>-FE9o80;1e_s6Z(g$;6hC zX9{kqj9boZ{oCUK?Q0-8F;}Xod;3KFl4yLe>_37JL0u+w)zOwLXv6{h#tM7cbK%~z zPEM*j-3Cjj?4gOyjEKOEbhTr>6u~^*Za#Z7Hsa$cpWd2<^-LM;u&9*w4{>GFX4NN8 z=g*$+d3jb@YVBUKT;iDh&_SwzFT5w}I9TBsR@;p-t^i#KkFK|RJZ^{2vME~SZu~2j zVaGwU5TfyhlS7@`nP70-YRxSQv{snQfIvdMih!acpg>~z5<`*a<>|copk7XI_*=T|3LxJF7hcQ{x^$wm`1M|3xo$;_5#*3BIg?!Ii--+NaOlE|Re3~37 zRi$F#El;9(S@ZV?PhwsVAMdRJ1mm`DaHGQt@2$LR*bp9bjo& z8;@Au-?hQ8#uu**J~t8P(GpkymlZkwY@`?dQw;`EQEh(bKWIEbybE$-Ur1PY=v|GY z#*zYpg5MqWC~dZ*1$oeWY%`?X6cO>E79hZAh!8U@6<9Ng-!9r~P)rey1<4>>6Xvrn zJkYD5I4~4X9P_?*&gEhLTA#c-aEDzWXU*dP zNmn|XrR|t)Zh4_CHKZw26(?))_xofy1P?DgPscGw-B{w(ZmZ8%V_V?8akhbticM3T z#?IV*sl$VpJBPZjP#OY%q9a+g|BN(?vVSYKgXPQ0?A?{4W@6cKV-?(8lH47jnMU#)Dh&uIhC_y*UBPduEmedYlIQW2^*6KZnS#m@kWFTSpL_bHtyY zribC&&{+ekR7amd#8B0gUjMSDRx2_H9o4|Y9JT|}lD5AF#Y@9AAytC~4>^M=0Y%gU zaqO2eC>8K_NH9LtJK&xWAn?)2)b1!sY_8Rid7m~!DXH?02AA7o4YIvr z$nk@Sos0-F6yFB#cqXznA-C0!T{&c+o90SS0gbK1Agv~#epOIe7p5r}rny6#*39mC zI$cj1-Eq+&xeDFX`>{jp>A#&_ZS4*3$j4mpVq?~TWOMrzk6d9Z>J>|@_k~p3>jzo= zzYjB4)HG=9K730$RqZo@R?rd>K)>ABL2a;M=*x>o=wg6Yj#Uv5mxrLz5NzMBw|{Vd zH8s|;5%}{_nO@}0RN2qLhwo%ml@H%5@ByzB5~_~P0d~CQD0YC|fnt9!%9d1#bvo{4 zdNLv*DiL-GqQM&J z%!$j(>V#@Pnm3!*=H3Jg4-a}DzUz!%yHzWM0$Y#!qS(?Z-;oO`3@BL6y3kUm461-F z4_wdD((|*ZI_JS<@r}epEjJuF?zCs#?RkY-Rq$qDy{mC>UnH-_IoGY| zu~`tU>oHWc1gt=X1`PH~mJ5@bzzls{Up7COy#O`e|6{~T&(QCFb-Mvtr0ivq>_3i4 z!wbsPZ#70hc~Ds;Vm?SEvyo>xEcA&V?>ODpbJlR@3^B4Hrc>==rw#2HXU-bAqYcBn z*4V48T4+ef>lvo`l)G>Z1Et8X;z_7bmF(-|J>*(_GVOVz+N7?6g+cC=$_$@lhaNM^MFs*I3)9mS~Io3zPjk~Z=nZBfbg~_C8j2@LLC5sqU*6``w}UJu>-LxR`w�b9no4 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

mi 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%0AqZB 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

Im73$kD2T?5)IS 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

?$3m7R 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 diff --git a/ultralytics-main/dataset/coco128/images/train2017/image_BS1_463_00_42_15.jpg b/ultralytics-main/dataset/coco128/images/train2017/image_BS1_463_00_42_15.jpg deleted file mode 100644 index 463d928e9fe5114f9e14ffa2284bc709e90862b3..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 234216 zcmbTdWmH>T)CL%eOL2EC4yCvkTA)CILUAp{p|}Niw*m!PEKs17BEj7)IK|z96;IG$ zVe)?8S~K%we$33tx@RRT=jQI`?sN9t&vSO37N0f&#A?c_$^bMp000g30z9n%-T&zi5#Zwy{P*F%ANk)? zpJAe-W8z_BVgJvN|4-dhH-H4^89jP8IvOkB83`IX3EERXfC*(M=Kq+7GWLHP+B0+v zOe}1a8ThCH4a6w((a}*xW1=iZjSfP655OS7BxMm&z#`MO#AbCTe-)Nmh{L8>(?g*% z1!EWf>=BNOM@dCZL(B1klZ%^2L{v;%LQ?9@TP0>V6E zy}W&VfqwoGkx|hxv2pQf>EALkv%dex{#jI9@~iZB*`M0F`i91)=9bppzW#wh$k6b} z^vvws{KDeW@)mS^XLoP^-@zgL{NnQJ`UY`(_a81a0Q&#JLiPWTxJXdAp8e+o?Ei3~ zJ@Z8!=p-1JEJ9eM3fkC~?qsa5!f?nHQwwW)aM^@)U=*J{rtm1)MYcHL|3Uj7WdHAg zh5!FT_J0EVzi=%B2++|`&O;{w$OC@6d=a!{T?=fhCm3!gX-|2xA)_zW06z3>)N#nJ z{Q7P$smM9j19_ePp zWyyhGLZ1L$3t3l2m$JCfLfI<+tR4`VIK$oH!=6Psa5)(6}dXy>Y8#&!S)od8(5hhun#;#~lc>>ic`w;xy&h+u+ zOtEFC$_^>r+4Cs1lq?BZEyi!9;or>evu7ZRbgTC<*Vd1Jwh%-(SzoC`tHT;Fm-e{Hk_WM3# zE`fL{4McB?2*KwYCYnNoU>nHlB53%1xfUR{y!~c(^hKUqsg>AYg;a{cSM9kw1P0LE ztOtslUPk&^w)TkY~I?4kL5+H-EYpgLb{20~%8n`7|(XT%LOC0sNo1p_%LMq8EV z1Rmw{xd|3MXKzTeQ6+fu_`HWn_+?0zBpbbfjm)103FB|YX%|lb;cz{ex1*%QlE2Bh zyjn0Ha_&wn=Uxvym;!*X)Sv$}BAG2~NpPWKqxZZk38E_q=}~_I*xn!El+1aTm#dB- zuc_*->K|3Gx+sy%Pk2QIyHMlZ6WOCsN5DIxncKK3v84`D29pVaF zN+bZqeoc12P~5)z$b`hhzUS+2D?#Mgx7-($2X1Kc!X{9@J3B6tI%!5c-~Jc3nJyX! z*$tSS&Y^msXuH;$v*qf-YY(8jh|-H6O1)iw0+{od5zIdU20{>cPXOkSCH*P&yIZEF zR?q|a$Lr4{kdlYDO}W;tZY7E#?Q|HyY+a?I-GOgVv-ex@ByCW=0WEf7CKSruJ|EwM z<9gjx#C5FoK79zV*TpOlvRP^|^@>#561}_UdN);@rK3l9%=g5M-|5bEESRTN>M= zb?=Da?IRn!+lZ(VC0adwZheA3M)awIMinBl+VBk#++b`z;=S*hbxSurXfp*8DMQ+w zTxZ>zA;(kgxn-OB@pa?K$%xxllBKRT@n9({S=NfVs28yt5R)D?dm=`qNm ze13)R+!siNDQ81K9@s+Nk>oit?w3)95@DYmJw zaP{vHB+`4v&$_OZUMs=oidGNrKyeG6nb{`Jw5s90bd9GF?1*lO3T_yPZ?>Z-gxy*)f2|#UsgYQ|e;b@-(m@P^PYM&Y_9^Cgx zNsaYYwrs+z* zu+hKbN*u@w*Dv=ik%(Tp~>LjH?Vc@xup6b z6{R`e>?vy<;0Z8l7eALt^3Sv?z_ymZ%Y|uiReEJ9(6kfd{74`Ph<0bY`YcFt+(Rqk zUu*m2p_~nZwoj;=+g#fs>jC`=Wc=7J!vLi_N+EE%L*_acH)vCg3|Scj-blBG+{IQ3 zVh1li0iMgyY&j*2()~7m_gyCQ=V$%*glc3n$!kN~qPOCf_v*-r?Bv|+~2AA3EKx-NRKcXCEzLR3}TY$mPL&UO2jvum9i{Acllha-<4= zp8E{jG}pjyYh#(MJ6Jw*JW!}&z^#cYTJp1--WI^)-QA|Yr^Qz}Cd3A;ygxfo7!d*` z-B^|__I1Ot%!qi4V0~*=oWW7keK>apss%yLBG#$lbGiAV@Tht$8&$sXSxwSU@4BBS zGHh`1xDOBV#?TQ!@D>05UNuk;dB1m8g;$)jvKO2+yiI2kkm^)w(lL|8v&ZM07?JWl zO=yy$#lg$vV7W@Q&l^9g`|h`%N4dz~=TE?c#j@@moC#LQ^ZF0@ue zfk9K6l*q~~rB5Eg-}OLxV+>nsnCQB9dytx`8u_E;6auB*@^*(@HJNngRdL6h?AH(zkDJ}f$oPf%jtzq` z<3_c#ru)*zu71i~$q5zA&>tgQL&Yo_A-$?i1Sx`0vF}R{rIoHk$VE`CN`k0U5PEM{ z15;mzCh{PDdC37OTAl3>tJBZJUh+LkUxqL=e^%VmQ>Epfr%eB?I}7&xBD6*{Va<45 zQcaR`FN4_>;(FqhO=?f{qWyD&EIPcvFqs_355Oi4;iW+I?N*%e@0FW7*Z zpl1F2pngh6TaBrZk^%uKYtNw@iVMjTZma5@s38{l|rvwMwdOis6fNJ zWu@XnvDh1sje5kj$9o0b?!K=rJB;1ixdhO9uvKG=VM%keIQ!bqJh3QbT=g z_Z)KMp;ug05^N%1Fn{1FE9$$ttjd#Zufo4$u#T$ik7k>ZBPhYOjysK@`O=ly? zL|-Lzil5`Z48dQie*zE%k9t>VG?f&CBVfXjQjoFLzRx~RN*r@aHs`=$4Pe8R^ib$X(SSen5~ zk0lKjLLEb0(jS8 zDeMW5c$L7wav4D9{IS>ed`VjeSEFD5f^t1@j{DX3#niTuV084RzV5$chx1Wtvoq=% zE;((rCTAg&a}0ImxE&Tyg-weH@h-9kS*@+JelYr>Iirc6Jk+2J=%h+?K-bu#{LjG&qD)lcvD+=`ZHATY z5!^y66_ywEl*<(Zx6A~g!e$M%rcPy(-?h!h<-NK6T+3Z|YX&4gx=hvd2Y#7-;M}Z~ z6zMA)FI`=GTS-2@{AH%Tnk|CeJ$Ck?|C1H-$!CRa(Xl{DM9&rx?dl>zZl%{Z#;i>$ zavpl~UaVkcd5vAur;ci;6*JH>mQRY_A4A{Mfpq*2UAZcAL*2X2^=;bZVuLR}F;FK8 zydlWl-leA4XXKc#`U%sl+b&-j5O2&*1TFe!MHSawlr*W12IapT)Tk8Fj~li8p0%rq zv)Q+6r1$oaC$PNX$|4VWzQsx5**1R#CIr4ws_V?^2N$dSt}Xs!=Mk*(1xEZGG9LZe z06*n49+EPUPk;!#ZuMz`CYXKfpFdY@x*<7OO0_s1-dD@%bj{)T5q<2k=;l`ydupC;&w_=!35smULL}1vTBSe77%j>uGKU@T=u2^f= zRlmgTs=oZ}E3jZQnmU`mFPbmDqFr`eI8xbIxdK?%yOtOcBl z)_&!LF-Pn18OC5|NH-5*=fD0ZOQqhbx_!Q#{F?X^)qtNtuc6lo*5SgN*(-HVPd>kJ zZC0!wx&Vt$wmgJ5!!j9H&<^wEy&mi=hSj$b;poW?_kz(nU=zXX+Q?5=8s+9eA5YV? zG$!R~XUbY^hAI&A~|wy|sk<$R$Lx4JqsHzsC!dE*Ua)wy$WqBVzI6h|$=TD$5N1pcKyiMx-OHYI zM=RYHt%c%DYEO#VE<@=c7t?SKGl;aZJRY12u20&g_RTd!qziwwR88GeuZp=@v1WXB zJHqrdqtL`5`|7%^!R*v-m7Ruw$}y>w;WcyWRb_Jnwah@Q!tjX!-kaPE(*+w-QJE9v zVml`9>#jqRES7x>%0QMvm10$}iG9tm&y8FCL`}4VuEZ_j^#|eJeHl9mS)!jNnC~*k ziJv7B_5Sd-Dm5=izMiJZFqNwKO^t=ke6dRMH9&VsiQ#qCLl@s&l+m!LgNf3wjXm!1 zarW-i#04t2+J@n5yULac1MA$ble6{4#Gjbw^x9Gs{9i*sA|%b{2BGd5CkhzWAK$zE zz$hWF4X23Ru>+qoW%%ncA1V(oM#x?zePAf+^@VJVM?3+N4JItekoZ6_v@|N1BTxv= zU!kwRLD6o51>&D-ZO*WofrjJk#tzU=y%Xv<3Ip5Md`!x8cZbA1SQS^{j-o|3-qDQ}z4jD3}FiF{@u*@&c#WM@`XU%USOXO zp?jhob@w3mx&*=owgL5ylrrcC#oTemIy;w=t*kg@>x#P%a8Z-;j8ssBa;8p-Hqg8G zhf93r`HiNh44`nt&)(eG;nw41_dNPA{>$Np%57uSsQ+Tc`{tZ>v zSl;42BqOk_U^mAnMUKAio8JWl;^onRJ^H5Wg|iVqbm-t-5WK-bW>^y3_#0EDh5?JBMzqTwo@zZDu7)k}=n zZ_$w0sSrsFu#TKn2xM6+zTF94-kVQ29q9D?V4gNJ&eQw1iJ_kZD@I#52k#4Ufz9*e zu0Dv`W}t~BZYxYY#`%JE7~E~aFpon`b~!|Gluw^bgOnHD;)7_w7t)b@zs+{oP6M_As{b@8V{1vg(+CQv5~O94>%hkdY~UJbPg5?@V<>c>NtWVyTMpXd z10Ln`LbV>qP`53FQicZF^1xQLbRdkFR88(ZKV9z8)8SZb(bW-a9EYrSY6S7ZNBf@t z9=7`90JUuiI%Dk>SN<$h_Y(b#iZ|uv-GC(!ORPFUy*``Ux~;*Fwf!xJ!goxXPa6?L zU<%N4xQ|WDU>^z1;pM^n#*Wu#hmY4jHRmr1e?8D5gepuQq~JbXVue+}fcG=?bh7da z^=TR@EjohopDb}!UV0cNQ+p3lEF-K2TQl3X-XlV~{avF4Do%^)rq2Xkm=yhvnmEw> zTY$v|aFHuzKz{<*w;hFGIU*$xF$M!EhO zY^2C^v@}i0$s_Vl32*|@VEG%Gp@L{HfcRpva(*h*le^l1s((de7v9#)omt;&wn1m- zT}i%WdVk4!zObkNsrfXhoX`i3opc3?U1x#KM~U|5bIoIr%DAV+xs;Ikyt_5PYtQ|Z zYT=!3ivZqhHmK8Ezy4N`()`G@f>OoSA7fV_*TvN4lu=ix|3}Oe|?xKHY zo}E`r|DjI~{fc6?oz+Jp`{mJTQTVw@6RG8#v7B>)^~2Dl3D(Sa@o};*wYK$lT34b_ zLCU=5UKi0iqun|q5`fEgUJ2#gVGbJvJcNO1vQGlXBHCuMc?49Agnwq}>Cn&1HKVwh zK%j68bm4(KeXB7?CfKGkF2KEVt>FDb<6miIf1e+PqL1tcKGPabEMd6oZk~fEii~{j zi!gZt;1Zn>!I`!>=2ER;XHh5hZK~hh($>bT-H572y`KP`GeYbViMR1g)WBAB8`(!afEz2o*|6vd# zoUBqp`7V35{!3~q)Ty{-&T!~nC8tSlbikrzj>4k+($iahK7>>q~kv=DmmY42!5B+wzi zW}WJla^i2COW`D&uWFc?&g|H?e^ZwRiv9hP^?p|LQ9va_1fj2tvj=r^`xIr!)UJ9w?w17J|X1Mw>E(y?5u=HqGhiV2~K%l%TZ{SI5bHC~; zH1>yOJO}Vh`g3+zhVai5bD#Hd7SN}My6<&8mvJw$&&M`#e$zuaqv2Wt@%9w0ALY?x z^ifhYD6&hF9GqC=ErEek_}YbCL&|{p@3yEsAW~t3z36s{SGI%Ln$H&YjTU0ldR6;~ z=o&U$yKkz0U`ncFdq^cXzZsxa&Jeu^>Ok$9HTr)LMA1QDE`Locho732httmpeP{wGJ^EHsqK(M_U+T}-n&C2#8s^9lN5ANT&m zf)?~&$Ml52P1;M7HU_HekjF%kv*-V8Rq{vsGM9tu=l{tEu>U3-)7!2xn*6(vj+_oA zp6wI{@~VM)8M*4F3!)FI1YdL|WvZ6|&tr?xM`C=q`qD;cCW0RjufWE*N7OI1_=Eo^NV6*#lJ}9hMDv3| zYsv%BxwyQ|B=N=~5RaF^VBk9Xe7z@|U#KE~{as~|bB!=fczyhDpC5#P?X#fmsRxcJ zkq%F&c^MpCan34TVfJ&AU5)Auc3aZ-@?BL-BkSiq_uW^}=B|`%NUR(=f>Ud@T^0&t zul`$aGhL-IkUi?#YLN7rZ^JKV_xTKy(9pOys4lqFd21uu0TnUw+O>bUa5hh4)O{ow6}3#F(o_wV{uKH^In;d% zAO zib`+zBjQN0IMU6%L+W>yee8`-MB>PVO8pu*l3zD2>o2<6;syS@BMG}9+@ILEM!N*R zc&vI*feUx%;~@v?{vL~faKB_vjF|X_b}ZtJk^el82UvzBp54~ETbT9bT3S$jJgone zYf0f}0XDh2l&Dz}qbx4s7OU_x=!roLZ-Q2$SGIjh3q+P}3+Wp_I1!&TH{_f|_}{uD zg$`6lbwxg_Ag|p|Ml`@K`a`hgh@Iq#gPDP!&7>{n8_LqU%@LXV+Sz)yiM7p{%7&w3 z|AJqmt<5w9f$qg01ZE%5Vf$(`qE4d@uAf)@yglt$`ftd7{vb{(hF2>}#8ueEEp9 zI#LravS;o+5suV*&T2GKkH;UX9h##kB|ScnWd?pTWyJEc(5i5ev4L^w&f3kL%HWrD zjBl&*&#c!(jIYy>A6d=q+HiB>%MF2mXuqm+J{&ln{@B0BU+CNGGxGttNc` zlvG6=j`6iNRK>h7uICWTe}V32;G1v;t+9CG(r+31%5+0WQk)?f_hexUw+D+Uc{~1q z9@=&AraY!Stw1H)+996E38Uds!aHlq>Sksom)~M41o@5y_hGoUuG9$Edurr(7pWII zwEQfglX(if+ma#ZHB|9AQ^eZ^ujc)UWkU>mQokK*2YcCsRD7wRo<_!A(uq~6fgTcT9|i`%V>bgrA{(J;8o zTOPrga=hyvkkhq{ZW^tO&d(TGk-SDkJ(9oQBwNljApf5h9F`p%;T^JNk-Xel5=3rO zd3oz)9cA|=CChIMILSF(U#gaN=)k2W4dNQEtgkRCM(5na50$^0yQX>|C4)x#Sdcwv z!v>M20~P;jES95Xa4W4BRp!!AVQ`}r4kAL1F;cg{zcJFyhBVQ6Z3$R4+3VXcAiiUp zicMXR48HDWlLQwb>4FCt@g6}}u}G;ve#G`~^YwpZ8O`eBXfogzde&}JaeA@KT5v)) z&s4KNx<4CuL^zCdnywIxrT3qJDjMx@%&Ml{X9CVIA@taZ+qW+t$~Og<8D>=BM+ZO0 z6s@9+to5G&#+4K9$uB*4FC(BXVWo%!gIbtta;Lz-UzxO+ndyaIDhm2fhfu(CH1aEVHHDUY1+KU@m z%&4-R!1v4DoX_3|r0bX*8C2HZ}(Xi?Cd)v9-^#Y4${U(5o9u;I$ z(*XaRCM$7T%!FyScu{o#n2eT!u~mC7WM91D%xzZb-R zKhPcJ(8bn)2RQEWM7hAa<}I4Ag=hsRleME<^X`r)52GGOjI40vtxa ztP8gkTIB{V_N?-J2tO28`)NW1vp6B!M(H?m;Hp5G$C6HNpzwz|uljo#xo30Py!^%= zjNVIq3voyY+x_%YC{i#i*{!w>mjsrzzbsC4h9GH&j`z`g2lBMs|h#1KGuOL|e3UTUSi<`ANFh zG(+%T-Wr)Qv>Qqq8d)M4ctm)V#Bk#ctB9j`00F`*s0>eA=7nNX9&(N$RxEYt5YyOa4*r7Xm4O|^MuYYS{e=+ z56jEqs}SW3=?adas&?ueNW@X21M4Z1-23Iim)cy%4G;$P@HtDx?o&~nSTTVqWF zK=!Tv4HEYN6%VD(1IDSgo)7eUyq!`dr@B6Wb@>GNl}pld&BmZWaf+%!>3#yN@NS7% zZJi|`pRKDqyUO^uzA{xjuOP*C6{Ax5$_v>O!`pr#p&e${54_DJjVzkfC_S9|_o38? z*Q4&+W2wyZGN<%kbtU6|?&XJ5Y~!D^6By1F6QitDV+lvAA7Xt&iAF7?CdJC}#ZoHq z6Wl%NSX48&iu6m|wM4g~-m@pbX7mP3*Mih(!T&5u-g1NFVA*W$IK|3Jtfq8tnRVZh z^o9q5AC`tDF@dc>qc0ZzxVlT>D)Iy{L89kllhLftKgbK;@t_upbU>e|2UF`|oSn1tu~^)V+fp zcfleN`GxvUN8L6t#lmg_|D1os8MWUCgxGnB8~1S=sF zP;NtsqTw-t?6BmPO|7_%YV3Yl&%RE%8ZmR0x@oJLfHg`euHNON=2${HeR}_(j@8!+ z54Kt=(><_ApMGVyTPfVZNmjq@cFD=EXzA2JEpbKPKzeeiNPXHhSh^`njzB~XBMo1v z15t$H26A9`8SSGNP|A2}FQZ){_NpZAS3Ke!%*r)IBt(b*++-Sa$xNhx71#-fu6swyTWGwmb?XP?Lw6b&>;}tN{CfYtlYw<}H zdX$H%g@$f2c2I>iY{UsKngV-gHXrAz%6}i4cw3gM{pB@Qk{P8>h;&`2j+euMOi;05 zGb+G|`qw!SmW7BuC|^Df{6z-<&d>+6Q>~spT~=wn4e_PzBdGc}gS(VR5v$AY9{*5I z@kRuUvvp7=Ti<5VnR$RYk(+LfrHl8zg_8^OAJ6>#CkT&Ys67ac8X@`E%P1&V*P4Uxo364tNgpk zB5QND3k%5({0P+tl{-nXOZ`d}NcwGPyi!j&!eF|LugE%3d2C5wl0#SMNsSKVo#Lx) z#BJ7XXV22`J_#9O8|Sc2p+U^SQ1wBOE_#H4_B4_~6;9PBb<;0#+F<`+QS`o5CBo}o z-7Devfc2-Ay~Xf{o<8NziR_^vRe@bmPk_3!0ix#*ObeYjt3X1Cas6Kz6JRGv-dX-M zZxY89%?oE%X#@TAp~m_bCcsnc%(r&m*l^}3I@+#lVxVhP*=K*uj*OotO~gHBF-4uW zTR9Y|itbdUt_0;9GW<-_JExf0m@@_|-dl1_smJlkmJTy=Ert(@#uHQX1+Rk!K-#vCKZ z4d(v26Y|cn(U2p;_XVT3tFpEiEpF>@ zOgqk2l5ZzeqNgfQ4`z|jZdSCYwOJ{xGYwMDTsaZXuKX6~%rj0Mr&K?Aeg)&AiObs6v$YQJh7^|y$ zwHb7o`MSD9rzf(WrX1d@s!!9{ z*X@XVVsa6*8FM_ftrgZqBBI5Fc)y6?ka7QYlr3{@YeE;KtMc14 zhnt4OCQM)*N{(r@!Z1IoI#S(odlTXy82$vH?Xm|k7zWb(ZI|CBB3yp~cJlO-``Q?e zpCIb6lc`$85pzOm^Vg3w!6EwJPPCY<>a}>~gAPo&4rX_43Ip|lqI?g;ew4gKCE>M4 zdedyL9J7O>n(Jvu2Ypvv;uqP%*}W6|>*&cY4W+(0d@^&?&b4FzmL7c8=A#S><=trg)Sngfanrk$<~Paa|4!RAtHDyXMvv@p!R>J(T|V^MyfQ zStE<`AfX^);^H+-tDh47s|YsPcaA9fFs(n=VCz6BcswOwB(uR0PA1d+4awh~dHWj7 zOAG|{Jplk-T8tA`$oZ+uxz?72E&KhZ3k;VHVPd)wRd&LmO=9w$Iv39x6jw~nx<<0r z)-D{Ebk)Ekh1I?kx4ghX0}Qd!hnKhW{6b4r%FM^L%3%1}zK zyrV_b2Zs={b`_`==7Z?8sM$xeDQLZ)Yx@V0E$X&BlFCo*IK3uKZC(L>_=>RMARc9d z31O34s>rU-pd?1_nG-odr+oA*Ww>mju~}7urQLR%%$oow49`6q(gY>e%Xix+!fFD( zZ|apdZ+~2G-@iqUAh{43#Sdf%)l!Enw%&Z^uJ-wYIpYJ%DVKGzZ>oDBv1Lh}cO_;& zwd?i_dmFb*?(9xHw*=`Ov!g+<(T_E7tb|f1?^^J@o$B!qBmBH@iFLA$A9!3oytr#U z-MSZFF0k?3OOzlQHe7Az$C=;^GvE0YX~OK%$+5YG(nH4wf=5uh`X&=GqNx8aIK3EQ zX95==P|rCEV#L>b)z5 zEvtHq{a%jFVHij*Vo$6{gpKaS>64|gxx7Mm9>Q=5B>wA_LJZ8`_&9S?6!Ct#NLw_3yO>p&4S33HzYO%ULc+ z##O3eV6LvW--WrgoOFpZcXKD$8wB^?*Pp%|mveo#_{PrN!JEuHsCC3)=6E3HyHzr$ zvhSytgvaQ^`h&b7o92biP^O6ag}?T`+0ONy_6<#QR@Pr3%_r$!5)FBSwwia617S5ua!P6YYkvnd#fC`BMF9=$ZqBbcA-svCD1^&YpkfW$vtmOkeZL`jyFPK`B7 zKF`;vI(zQ1$Ko{}!&E5#!6-RCv0Bk@M70s|g% zL##nW2o)&j34?D5qP!nO{-U|50|rV0AD1@Ie4e4k>GLa-j>=WEHmuGmAy6z6y-TiT zk87c0o9`q+WzA!OXl;+h?X1@p%X0MbkRD?`UtiwxlAbow4bxlV9I>d-WX0<(Vb77f|Unf7^tq? zdNqXF3H|ow%buhWyPi#^a-Z_io~5uk@4cJ+1Bw&Mz*PFqVsE-&+MqaN&;wscqnVNY zvTO3yTPa;_oLuGO1Hg10;FJ4BH6kA%(or5d6VM~}XCP(8@W z)P3+O8T%8Uv1?FoxO)jMuBULz2kk-$I-4<+NI5vsG5QuLv5P|P6=HNSp9P*b_qcnq zksnBk?`bNrYT04k7G&B&)*PU08 z-=X1WccORyM*W^V5DUI>!cmUEyYKH^Fs^r!#p^v`$=sg|kY-0)C61@gVvjfvcVGU2 za^AyZwZId=MLuli!8>a!=`7MRy`Ree3$5(qxoPvgkm0%lD^EB<7z913RAxbdb~g80 zC$}oH@z%(n{`8eo_A+B7Y#&M#h2*r?L4bRf5* z?h4L~Lq&!Q>|4s%9g=3IHq=ZdzWgG@_1a1wFv-*2rLv?cqrD#HtgiUiZnK4ZsUAY6 z0L_!UT&WFT_@KTxMn>seUemL@BtyWcMb5sMqwc8|-;2oDUK8E|g?Y=_i9 zxbGv8d+Vo+r3ge%Ov4O9X#tq!h#06A266()I2|YqH5nH$a~hDhYsnrwDfA6<{$;E2 z?+rk6BGO=op{fI=L!CHSR-OrnoLHTBjz|j3H`Wff$xb|W_=75gG|dk`j&5d-k65Ik zBpj{pW84$JxJR8hE{^W?AKOAR&NDV!PU5{G*EQu2V6hGDb8WF%ZPPDUZLlV%&Wrh8p(I zSJjg&s3-9^M6Ps?;oXGfpR5pqlIDfNw0Y_=RtL&sA&xY3vUje4EQ$Ka4c0O&(l${J{paNZQEkf7P_{}8Q zin`B?!i&|H`oqh}W^gauaA=|^R|@p@_jx&6!dyE#R2ocXw07_UxSfpa3nAUImH9*| zV{H|6>Um()3h6URVDQz0GgBqJ06iP3iA0~s9W3uTR>WY^Ht&)vD_YwyF~Zij-&xJE zpff~|pMbxem-@M864YGyjoL%%ne?XjUgO9G%`}+u?v;~vLiB#0aY!E%DWco-$k*nC zziQXd^*DIqy)WjjK5&tqfT02x!hTr=>fOL@7c6<8)4?+(3AkSOcUGC}u#Yo)@U@m~$iQLN^SB#ux z{?cIS>83^On$|GfS#QgvJbSEs@GS`BQI(M_{8tz8M==qu!pNG@n98vN4?XRfBMvP5 zyeic6{07`7&Fu{$T3J1$6oVcQA(~0JxGA^pziP1r>v870$?{&rAn};CHpme75dW*D zNXmzQ!L)y~x5oqY-$7Gtb?q~9_JT&t`a>hRS^yY!u9ce)gN@P>QBq0gkT#dKF0vFF z%~>W;>N!qGMd2aJoobx$*w2xAt6EwwPe(d{H-dcVJ|ljp z^ta_8Z_X@pz;OQIt2aS&I$H1j4KA@5i;JEU(z<4fDY?>&K5xgxzzeP6J0_GTs`U6b z7Gm!C5g2_r;CZcHDRfHTH1yL)2m3wjxhv4K+t(i)1L~i006RO=pC(Qig)N4C-wB&x zdvKbHQl2lhHrBn7M=4aBi&~MMz>n873&C7##$obF?E!v#d4^xq8v{ z!P0_f74u{FfrVg54@>ZKqOc8^mPG`rbf2^7994zw-Edm)z2{zONSu_EDCnGiVKxi< zvzrrvE?BP!GAi$YQeP(nMHb+o!k&LM&?AP=*xnfP$@mC9r zi4R@N1g0LjpTvRWaNP^!Rxd8P*xu)NAD6S<5Xp|EOG@j0iayg5SRo4~^a0E0Cr7d- z_f&DX6>gNf5BQF7zlH0%@~dY-zR>9iWwLk#9SuGK90cQU)=Awz3d9d;*Y{PPLOcu&0Z*t@rOK z1LMe^xo5C50+uDN?hN?1h~j){t$IRG%H}0yjnO#Y{56&Mz0&A6JTa^rA_`i{w^7kL;F`2uS>u&LjFpff_+aek8jy3&rYflNl7qgFVu%O)~wBM%}0 z8NqS!qsU?!a2hw*GEah$na6y9%^lyle-+L6yW#HOyxTogEbvl$Dz@KmTZ=dwYk5Y%QLa%+pxhJvaY>p!1u-v zB(riXsOme?GzF%Wj&AG_to)hM^(1juGrA;z1=~4yVDc= zsDs?fkFcib2iL6*i#{YKEGzO;5Zws0zjquEag4Zm{p^&i16>cz4Gk~(5TZToBR zDiSM%(jPbz{|^8eLFT@Zf$OQ^OTQL)GsT*ojUw4iq*)IqKzOaT$pl0Ok|rz0!0jgh zbDn8_JA6>^zk~1X^qpcDG{_9FUCpR0V9EB6EEwW|0rI(0$32b!`Hg)G%&Oz+q?MXp zznTc)VBOpM&THb=#jg$i&j{8n;;X$-*fqbKYRo5^NSVB_9{|1vOBWdBGJZfo@xL8> zM)+6zNKY+~j66kgXW_pH+ODUl$$b7qcVQk#$l1CoT`jDo$thV;q2Yp!eF zH-ge_I@4Q*=E~;s(6m>N0gqyn-A@@L^j!BVgp@`?-F343`T!Fm{ypYghhX@aHvbx)tgvC%1i$$H9LStaV3b z@bGuOSXytiO(HZH;F*72^lduox1o$fAXy;O`l?~#~ikC~m= zl20ezylcmIz5@6UVI9`DEaKivXSdR{N0GeQ)IR1#3`*lC8NeTS_OBNGr$1?(O44|~ z9M3(rtrS|2xEg$Ro=kT((kPNPe1cI&F#*A4P1rq01_J?K8Cuk?qWroSDJn|Oq4Jz3 zWP4WUaP6M7d9udj?jW8C1GPbH?61F)J;hmJ<_+x^PPnhwY>!qH(t4UYJ=D{F>QxRg z$YGp(>9MR)!EBynpTgdd_mB>N^B8YOQ|59 zKo1f+A1%JQUA%T-;(J*Kma@eub?9SkXX}+Ftxf1!w<}2QbbUur zzwp0-yllF>zGj^P)3p%6PoB`Xm6piP@0FMkd-GjKiSCSAyUe4BK$C<1d)EglW4z={EQW&~_PNEsVXQUE_(*1Y~Ex7G9u4M8H697VQ7mLj;%J;y!% zn59v>TvVlYUK+%9(t;R*dSksd^ThDQjAe-X%Z_UT>gj|=u*JY+Ks;ZcG29M@!M$)ko?wR76j#xO^)NvMOrgaq(Ux9L+$ z<7BtDW=Tmq2;8Tq<6bds;`^!e(Q|RRQy)G^`CGUioxe)hxbZBZ5=(=)Z23qySiL|Tt z`6Y~_v0RLvGmlU+SQB`%-PxGk1|agk=cQD*)!}&z>mk}kLNV=8sx+xm5<`3srQCRW z>r=QFD^eQW7oh4-nZ zYcn^Bt`+9m^F)zCS~>E8e676{oNnhC=b!?<4>-)LQg@o1Sv^nn#e#tg= z8bsGNI+fMgyR(xK>H*`DMiK^5^5Dis#!zV=8V>3x`ZM6>v!nPU!|__$ z-T?_FF!8Lg7`J9!yGH!a(bUuyXKK={6NjU0GVb0m-{MYLkfUO4uE zRF=+8?BM62>BVSRe0#LES6SJXa~{>UX8WfED9;}*anEY=Axki&SDG@H-bH-71&EWJ z_h;Sq`mL0=7Oxb$yy(bAQIL2CKHWcB(pKHtzIpg}@pDF#!P*9~bF9S#(Q6Rf%q6($ z92Dc!5=R|6SH48|22 zxrhVn)|?J%4Mx?j?IeXRS{7tGWmC!?#=e%csYtdIQhOeRw0duZ+AK@TF1p zw0KwKA#)qARX(D*zX^B~Thi~YJV)XW6JO7DcBhdwCo$jXor6T7BdejjDKd9}w8;4{M{x;vGgiNUxos^A5v;+q|zZ zkcz~4WaDmYnfTrD6XC6|inKj9;-La(si3yvvY56=B(y3oB}+^)wUit4n=+~#2Icbo+05Y*QqOe&Rp7TlDgNjPhU;X zR|>H1Jnh-`xBL?$Q~1MY;x7%~XqT~GtaHv58_g}Co_S$%>%1cYvj>cQ<^Yw+8&4PD zp96eJ)%+o6@j~n3uCJm!+AaJ-&e{jLk8+eZ1wsU5U`|n!2PEwWn)I&#{0#7~gYB$s z6T-T6^fuaYd->!1e1lfqX3{weZJ4{{V!}aeUEQM5!diF4x*T zz~dkg2;%@_XgzD=9wQZ&B&p5mw??-74@D|zw4Ko(hOcJ$pW-#v^*ss;OK7Z-uN+xI zKG^s>T)5mw7-9e2zX3cO z;-3my>0TJP@od+6Ol_z|XKj6_Ihx`q?g&PCSe=U+fQWiXjI28G=_xLh*GuBL=8D}d z(c*>KcC>&KmBASxl>`Ok!2_>)^N-pV{!5PyO>M9E#`jIMv(wz)4L<0k zvaFL~N|DH5%DYJ5WP`yq^_94mI4m2EB5rqWsM+avvrA32>tl^U-$Z&}iSP8!4QNks zCW@^Bm02Q4ROfRA&ItgFk(%)@9ei`v^dA@6c(+f{v`brW49hsbp8Hlya_~xkqy{zw zDRLn@`5>+U!64W8dGQ-t*Zefz9Pzh?H7m_B$t96>4Np-QcP}RLO2`sMa>H{4`9RtS zZY!Vot?-Y=wz~9C{2J4|KWlRx$kcBKjMjM){O#HmSylYBT<>I$V`UR?!OeVbBQcd+ zY;hP_^76Z_v}?<6%9EIA!wz3lABoTw; zT7SbY75qWa?!iSL z^x)A8i7i6BGB6%tT#T;l0&&+hhoJao*Fey3^((stv`s>2jlGCKrXsPbo>2V6l_w*T z4^k_m(XN&>`)snTgY4jb>A!Z&J-UO>~q^vw-4DH>Mj=zbh z^$#6dNa8&@++2U97}*#M05~U}`S$g%p_O`^+|rh&Uc#exu{Fikq>|jjs%j9iX3SAR z_myxqsRy~|*R^u~A+px>TbQ*7Eo6q;1;kLmi~~0Bn6iu$fDak(pK8~!@cTBj`pt^G zb4$}`z#tD_Z1kyZVb*MJ+QQVuBq5$>h^`;aX35FvjFNv&^_I7}x3P*=(B*HwHodmF zCXI8d$7^UO-m7b!bRX7dhX z^2(`&4gmxlWRO>!p0iK*ccy5*B-DIoCDTQy>WcxnyA9AnyHX^^3dRdNZSG`z@NhD; zKMmMJ;#nV3xSAX5#o8ph3ejAJPnbfDpDX}?mFRgqoSNRYDy*p}IbC_T_#E=3Njs!9 zV(|5!habdRUYh}m`d1TNMC}aB;h9;ONTh~G3;@nXPpK8@8g0s@ylHPb%B+Bg0DQw7 z9E$UQiaP$C;a?5eM{VKuHp{A_-C9NEs=>c;5|BE8`+x7O^#C70@XQwLZ6Dbq^A~8^ zcjq6SEVjL9;^XY)zRz3!ALL_FD#oSWt0tLh^Gh&QNZH#NH~?gv4o!Uf@%H}!!QLy? z>><0=5^J9jUfDoC#cCQvTWOv}cHDASH;}mscV$6ee|Of^mr0&iacssX0%ZBNaB$p? z-$P$0{9V$#Rj2$#vD9unNRi2HXC>XPq4r?#$XnzGnGsx&R243)akvf%udK!6v6I9` zjY^KoTQ=Y3MH+BvyB|$>I)8|F_P=g#6lhXKz&m_7b#D9)czOQ-rF^^lP!EV63;0>$ zAKMT1b@9wvABq#jH`dzUh%WSaq>^1CB{9haD=c!tBl9gSY8VbJ|6gr_ry(actzqzHN;VzN~6k~D|Szt8mLlJh7G#ELCNt^uLwbxyiKBh&R-q>0BH?dQ}73gbqy}x#hO2btaKxP8nT<4d)05UC@`hO zR_`eDctS$QA^9uxpY|*87M1X)_EhjE!wm<+9wpKA{{Rkna^FqU?7UzthNiGWfg@{y zYb22g8B{R}-T4Y~qw_c7Cxt!|cmwv-@Lz*8EgH%@-40pCnA)bNq{(wIx4OH6Hwmce zliqx*Xcu*@%w+5*Xd=I0ar?9EIIpUu89_D8bCNP`9x?lGc#iv5{gFI-ruY)}Sub_H zChx=ccNR8MT|86H?PV*7;`!UkEh8{qN0i(gVw?L2_-Dhv3x8v81N=JhZ1P^OhI}<1 zpK(0)^1yDdUo8oxz!GHI=;hkl zM0p+K5c#Vcy7@sy;-H*v#Yy4sj<9JFw0x4|ER zzYhF44!=FlpP@|}S?Y#Q^`;wR8c6LJ+DmWGVUwQK%J>uG27%)}Ls7oFRr^d(;V$JQ zjB$WVXB~P2j;Gqc8}TzW&2s)Er&|kBP;r7+i?y!aot^y-{1rNLrqq$`U+~ku27|@d z9ta*U(%(|DDB7KwzmLwdM^MW0$DPQe9D=}Cq-lO8(zQ6FXfF}VuHaPgN40zz`$oa2 z_z%M#AlG~sr$ZLK@eV6(8f&tR9n4a1&)b$ok#~7<7Wq}8b`dTZkfObR!MewZbZ-K{ z4!L=CB3mX@tKo2iE4XB+_9UOLTGs`~SwYc$pKQg}wPP$2Tw6wj%O#%tP31OzMgWE_fqc@Wn*d5e@HlnY&>z}lb#cv9H z7`yQ&gMVlJN5|LJ62h`+dRC_tGEHpKAeHk!1(G8pZ71d^7v9re}W4^L@Tq9abW*E4fmO_Z7i=!7GDzP8DEi~b4)@pHq!4S!}$Tf%-K)4$;&*LB@A+1Ti|dW1G| z-Am=MGXC+##Q6`(Hy2{DsAg~vS>aEN-vGV|{>^?H@s_LOeKSJvtU6t-u9Y^euE+b= z^1zPSC6$MrGZiYTK4xG*8Q^>q`&53@UI6&D@g=-@ai&>KtP4kjO-OAap6=QeEbv1n z!rQ{IE>tm4<*?lic$S6YU0cS24L9N~?y)|jrcBzhSl{WgTIseI1mZITV>uwWQJy0$ zyB{#Go2|w5J+r46{^>XO?RDj+mgceKa!qfw&(^OD{?vL0h`di8hcAS6I}2-ohSK`< z#ET$cPVzVWsCWSNEO0>MKAjZlG<(;NV_%vcBK@IT;J zV^6quGOLma41Qc~?m-_=e#yVIuZOjLcUbU7v#4vBywziqK^nu!cRAk~4<6(Vwjg6J zrH&KKD$T-{N*{{RH&X{er4{{RJy@QtU%2Jkn8uJtRGx6`G& zzcE_@hnoo+hHl>}em(2ppNroJJO}WP;NOV6TW8?yEiZ52XvV8_9$T22Mp)R!%yAhZ zxhsw{oQ&tyf8eLz@KJvbKkYH&Z-f3CvDKdc0K%6rY5HW=(8C3?T%zv0TZS#>xNYNO zN5~^2j+OGBtNUsA?_1NCPSm~;d_L5Cw#wajhfCBoS(G38`o4J7XP=fe!8Q7p8#IU2 zDaGuU;NAZKQ_YrHj>J@RjCAvM{LK4*9zm*Vt84wS3N+HHC^GPyj~Utt$G#1HTl)!k zYew+@0F4Xyw@zoDS5`|MLelM_kp=*GWsSgXrvZT~2g*iBIIoWEKWdMPejk=6@cbGc znk_Ajv{6`SajZ!e{rh$tuiodUbLwl_zhaNtXTv(5j_h;~6ODHBS+$RR5Ls!<_HQBN z!A8UE*cpM|`$!o<#w+G{#~kbBH6u>;Yg=#n8&k_`VdSM%CG)@epQw5diEgbh6U5(T zjwB?akf4Peoc{n%YI1y6eK0(?UM96+9meK-F_6XYw0ja5^%dv(XU4yU@T*%~HjcW* zoH5CJr`l@q%vEuLA&xT5wT3u3Cw+=Ry z>`nkrvBL|@d zwLC%MtLUP$(lrkd#}7GUT~s;HgFle2J6LO5JD6wEZ{v<>T*JEU zn8v`a{{WXgGqmy7Beg$N@jjJc@L%fMOp*msAIdrMfXUoJAQ9WS{&mxZz)ekZnN*Td zI&BxmH*K~b73wiU;Y-aEj0Db3H+uT>P(SuRj-mi;y>utgq$Wj?V#z}5iG2{+ARNuMqFNUP?K9O_wi^FPw z#-JiI0tPT}RCVVcg?%Lq9I9DU+~vP6tm%KSAHv#9mg%E2Iu>LxGV#Yj>Ur*em3(dc zX?za&ldpJpRQQEweWY3F)5R28&ZBdAAh?Nt)vQ7wFv#WCBof(QKm~ny<1dV#4E`AY z$#%aQel7TZ;tfYtxR%l)mvRp#Rc8iL!M6EgH1iJ`>N)B>xAvFuckHXF{{X>1?f(F1 z8|bB$O=m%$Rq&10fv&vJ-AfvL!c}~2iZ%dB3g9*s8*?pw!NL43jltuo)tcR3MBm8s z@fB&+T$eu${8yivAE4)e{$^jW$6EtKlIu1w7pR_K9 zmR}OJ+j0A%nyi@v2N~xB9Yzg)!3s$`CZD4?V+n6<4>N(})wRF0$p|7cNFe9s9<}xN zhCUR&r|=uV{v4A{a&-+ZORYvkj1wAOTrtV*#3eYdm%bX_4-IRnb#0?s>X-L3q&CoB zz+No705}XXcORvFb^BRrJ}CGJ;Vakhr;I$Ch%O?ugUYv1q4D$W2Rsd}kHWot4j!DR z&nLG-lN&md{nQrc>rcb~0Qe{lpW%IbQqZ*V189~7Ewm>PKF5MI2sZE!I0v7ldS8dX z;G`c0Aq>oZ|*pLrJ2T`BphPCXY{wO z{{X>N{s3rKg`ZEb*;h=;um%+@Vi^^ zR)=l-KMxUV9xB(bd|9b#ki}{nS8pO1Hkl+cTVUpbGQf z82zHd<+>M?Z^6kJ7#b{fvGV{4KNiTdVk|;unN$b$hGLO{3GK zy+&q*B9E0o2mlviN$Pg{3j4}m+28&N5&JlN34e*-wU7K0_U`F59}dNLH;b&iS1rwk zuX!`OM{T5TxsBwN{IE}#8hJ=q%jF{{nS^+k0I@ET!|m65{p_lIKSS+SmHjY{u0ZsU27@geR|^N>nkoIVx>vlfHFYm)29`}c$@wTZSbR9-=Bv!x`=bX7fZoE z-oaDtUm<)&hrk{t_?51BufW~|lfynAzSU=+NATy{+Ud0GQpCprnSe5tTms|_p4h7k zrz93Iymll-bpd#svYZY^TLhIk?0Nom+dS@~_-Vy_w){@TkzpY8oS)%;!1iB>f3@C$ z@!A+4NAMTeq0=`HEY3hbg5!_tUVh#<^RA7>wwB7)qjI7WF|_9$$*yM3JM9`1Znptr zl035Q01?xZih}a&`OP#p{#y}(Bap5^>zr4GjIUD_E6C`E7M(R@&tCA~?RDbqAH&+7 zk!7Ljk;|#btg>8LtiDmh24&ryt%HG%gy$S!r+~j`h&(gnI}Z?ekHLdj()7Erac$x2 zyTXw9xcOTu0r^;N0OTBCj8~9p@ZQOKmiE|ZlO9u?Dz`YuEyoA0dSKT_ABVh3JZ~Sv zuM%oD_U|^K3=`cM)>xt5REaky-vAu&e_HXYV6e^-O>VXBY3!pFx%!#le;0f>`2PT< zXrC6m5#mRaT+rv5_Sa9jMuj9vAYmn`4UOtwXla_+{~0 zSa0zZT9<~rJEnrVfI~4wFDBNHYso9^>Jm8!2XQsv9|gV}{?eK!!%4moXnzqc?Gol^ zo5T7(k*T9y>nvY$sXL26uMS;WA|K}Ym>k!zf5AH+PWX56PWQncCef2fyq?YOwXH)@ z4AU&J$|JX6&yoU}%5KO3U5PjuugbC5NMIc5(y4bHlC#s!>tB-JsozFYsULl5{dQ>e zFAIDb)V>Sqa{MdP{v!CF#Cq?ERgC(C5Q(krOfw_3%P8CAq-s%c%nNO9dE=|qJa)Q1 zr)BV=HFcj?)WDL@&j}RUB$>R)3&?OA@1HDS5Qnhhx5bHc{WHNnGkZT9#Me5dwEB02 ziWEsFH;$1sk(N7L0CKI!$2`{u@cZ^s_|Net#8%gBW35`QgLc+_Aiwc0pvCoBLd7c0 z6o@hh&mx_;Rlx&>8-8N1CL#`|B56N0YrA~3=z0|62x(3~*WP^v@wRr`MB5O zx3h;+h~C)g*8Xsvwk%;#C^<)97~>pg921_r_}=4I(d{SFtPovX!4pX?#qv>DjJX-% z21z*PyyxOK#LtJ`AMp;KqBG0?00}0UWA+IeB`a%c%)D)97-k0B+@%UlYD6Y7wrhY4L+c&?djOmRanq=6HnAL6iYFB1OxL zHJ;8&^qL->{O%f_ArlTCv_(w@%V+2p^zwY!lgSdY$G8W{%MsNu3e?d|a&?J=kL z@8R*k@OOrOG(({1+Q-^;8x2h@t~CvFP}tIapH7KG29`f8A!(Oz9#-PSWLMGUG$V?x zsqFrLrQhIHNJbFnZ14UU{?)o&fWNl!S&vN8=a2}j(swgOZMhpe*dQDNzb;_Il=>sY>>lObbgb~$1E zAfM&dvE*Q!PqLYQ>iBWmdBGivyR8ppC7+%%MXv5 zggU0V;q&KN+``&S5J>T@q;arzan2o`hgQ!_^#Z)d#J?48JbkMz&bf8uBv#Q{#TpX0 zffs6~bCbq$bIB&W(hKTM(?52j=MuyhXS!a>~x zvaGh`g2RaJQ8V9bag)V(yG@rY2>g93-m8PAo`<6f^&4rQTxlP*--xa+9^*;yzJq%J zlq0kjQ@B%(GFj9N@s0`S)MlBee%pHV*H^wDy6`@X&@2qajAf&eHBLatJ@PZb;=WO} z*7a*BTHeo6mN?zA=@g|^k4&6(tFU;c=>8nj^(ZBgR{F;FHg6y)Z<#TU&Nw|l9E?#H{1l?%&3?|m1vD9B93hh7 z!(-f)Z|7c9`!U~Jc$daU;l85jw^+B9J0*Sumpd4wUd8_4B;YYx;r=3cPf+k*iLP`j z$Yf70L*@C4f>*XjuWzWQ^?FU}idCvb+UL^C{{RIhvAkBdzW6DlMHGlqK@HKy2*JSe zxcUm0Mg6(p_;caSKf;rID6rM-;j>?}-%os1wT{!~DGJ>ahUbvQNgaP0_8xz zIPq`8o4ZXbTe-P|PrSFkN#mAS78aH=%6?W=o)+4{TMh^WSDa~{B%i>(Inz8*W3$S) zn=_=b2Mnc3u-bSdYaTk}0th_UrF=mBrv4cCxAt?@z6WZ)CZ6(l@lKhpcw$4L&jePI z!wu!V;yXy+yAne^xJ&{IKyp`%`L)$bHKQ0p>Aigo9d{~ix2ec#-xB;A;tem#k3+k* zxGr|g7+{XUfjzq9bKB`lQt>8``gBP(rR1ScI3VQXu5-u#0A9TR094cl^0xAQ(ZL6t zWcTk)(tL3RoKxx7*Wp=;5gd$9)O!*LImRo~j9`|AKGH{}=zc%&)}I5zeWu*Y6o^)6 z*eJ-y1bp3j?@wQe{s?PW>}{>J7P&Z8TZIi79Wl5c<^_3#-YU1AbDNE%jD$u9k5EUg zLi)s(_djZZN6K@OxjlN+xJ8Xrl07EZ$Nmx0wI-icj`XW83~^wPbDR!21D^f;u~$4D z@vGq`gDV|l#dp43r2LCxD>O$q86ik+2S7!6KC9w6H4%y7QMaAyHn%>tk#TO2r^_4{%Sfy5~dLHqr{A~CoscJrEm*TsoiBCW16QOS4kYnS&Jr5k$SK*%( zd^7P?g{8RhZ1GKbZzI{E({30_>Ok4KQ)nQZa!0Rf`7t#c1i23pj2!LxG52%Sb|Z@0 z(=K%ASoz*mf=3LSBmlS66NLnAh(L&?g70(Aa33pA%G*H z99KsLzl^*!;Mg_)01)_e$7Ujdt*@)`7@0P6E5tKlCIq^4NDb2M&_6Cf2}zypE@BaS-y`lrLs3$CSnrrJ0q z0v8P=Yx9%->Bi;z+4dc}*Uq1_zm6^S2(D4I_JS*ant65NX9|NYv*$slY(g;)*4Dl9-Z*jXV5k1^{Xqu zvO_SE?cJ1Qw0w`4{Mq9N^RHiv#@5m4miHF~MXWo8w_8S5St7*6e8MtSfsCAI1A61B z1IskO5_l(F)9voHy?z@RE>uQZ2@y~^XCWmRB^zq7!*&Go&2_Ee%ZN37HVX^UBoIo3 z-w2DZmVQE5Cm9EB8vt|fUk{9oYEJUp_ptM_vOOl##1`7zcedJx#4oWV5yd*(-Jp2# zz+;7AP;v(x9yezI9*Xim26)>{l1qJlE17H&bL6&g&ycxR##E5suQlTyB=D3T4e<80 zqR@SAl)f9BxSUjCk9_f0#m^S_U*TS@;pwksEgMI5Z!8RlV1U03`$I-S0qajL33z`Tn2Wfth^cVr^b3hT``hKw4WPlR-1q%24%OnMH$Wj z#(4LyXDYyEcuCr>A=HcL*1slsHPs2m^y6=t{f3Y>?M4faO7Z^y+Fr+3gW})7?-S@t z5c@C0>Fu>gk-+}|Lb%X1WGbV%GmB&Y00A}puzWTBvVUr?7Tr&7zqMb*m}G`EWm|8G zy6W+qbN-q1uJ1torax+Vb(GWmMf+ELSG`DWr?}IGsqrILxLZ5O;gU;xgc4j3vLuM5 zAF7@~uWo5yRC6dxbNa%#^GpscnS9NsVSbtIn&dtjX+IIHyfGYK6?{peT=+pWq-xp!jq$O@|SK@A{!gOP~kjC?rQJ%;YFFQiy=YtuBtzE`c)!P2^ zOJ7ajZpB47s~^$l?GN!GJR$KPLGcxp^~J^Br5fq_oYz+=<(p)ZMukx$Z!L_HIowAl zE0y1l1q3?j2Oq7b_J6d$-v-_gpbva_#?;dVRPb7fPNSF zx$z5I)-`$m0O31};r{@QZ*_f5q`kAdSrl1Z&mRf8SuUWBm2k}hDg){6f zBid1{oVk}WQg=!9ch=AEcF`V`D^sfZQs{l>toRb<8!a2edSXtu#coe9;+6oZS zugvL>;V0gt@W!Fz+lzOzm%%XUsMoF*Xm3&35OcYe#{`}*GDb(%zdt@bf5Ab%AbcnP z0D{B#>-J#r{;BaUEil;WbNC0tJ|4f*rm?;gS)|O;B;q+BEi^A0gqBU-WP@N}we6aZ z?X%$D40zvF(WieJH;C@Em%6^t?>sZ8+{j~sDM+}2D4}9vERPv<05hy=0~sSN`G*o@ zIgVACN}OQi+*G2Iwbiw2W|zy?Q)pu2C~LX&Md!qwbHZLTweTj9;k`m=FYcwERo2=m zXSa?8Gjg_nJ(0@Jn&0_?uO_i&XJU zk1NGwv%v{@5ANAVD;Vwvghp`;BSt4PK`gnuZX@G)U^F<-`!ZQmwObJ&20?7yp|xK zJN)uSti%pv+(5|B1@R~L?D2<%e`;+L_H??w)0uU-{>u%9oba{OZXvjx-c)8;A&f>N z%&K1v~`j(@kNS3$SW|^gQxO zyPn{)vqwJVNmmjnLjM3WkCvSZxLTakq0P0vCEsOb<*wh03Yd;`xn*Q`o(9(ZIq?VV zJ{F(E632h`7~<5VEauU7K?^Wgo8=0?sK-Xe-2A+KXYlvQkKxU?*t47pIf zkbI@S{nGS%9WP2v0@@??crDfy401|^+t1)D_g@NlUloF8cc|KJ=IrOY;LsGlC z@K^jKjeQh1NjQd8bt)ra)j7e=K^gB{RiDLsohI6OH7^p{z?)t%Z++#WOiw_J_yv!l zJ?rLiI2yDuE)!a&(eF^B?P=aWnbz3p5?XkcU1HZrQ1{HH>R99$LaI?pj+ww2_2RL# zJ!0ojx45`{BITu9wOc!&tj28Pox4HLKZP>K#J8RvQK;)0jjU-c#_ugKRn(HfPSb!u zJ+oTA2>6k8;w^IH!(JD=wl`u6cY&g11~}eiR&XD7R3Y4W=tp)H)q=|2KN$*5w41S| zS1ddnt+$xle-`SH+sk(-xQIa@LmZ=NA1F8-Yfjf%O=Jn|WO#Ow`~LtqIe$_4=bGWX zH>_It{@+)>i&D9g1l8t=%1l-V*yDEA1eO5hayZB%vBmvTY5XDKm>RPg+_vD)6x0$hm65y^o22U0W6GHV;dbJ|Z7H>$)!>g@6f4+m}-4^#dIyiel( ziKE+V+GBWg!nc=p5ZvySq7wNq+bAkgimMd_jl^{%b;%@o&N9A==QMC?y+<3^`Y}&{ z{vld5o!yPS{19BO=;w?wtcbys;QBBGeF3h6P10;E3dd#gfz)K0_)qqQ_^aZN5a<^^ zBKR@!8arJL#|CGWw{hjVHI)5Ja#({63i0$E2qVYUvXKs~eAe~mW(09yY5 zg~Q;TXTYznUud^Fu8(nR_RS{a%et`=#?kq)NGa!ykoKOj_5#`fO~$hUK>a@-T7fz^Obf@SEY6 zhx}m&kMy4mBs#UWn=YSkd-jP~rM!|Xj+b`SPWXl5j}Ek&jJl?*%=Xvw+eIq2 zqj`mr7+qtOVada*a(8v+y~acaGJtg${VVWi_L%s;{{RJ0{hsve{{R{MC-|%JPs9HJ z4D_o7x{Bt;$}jBL*u)0N*8}$B;1-$U4JY7-gzP+3;_X9T)ljX&VDe+D$mkN76{ zg}x8R@PzooRnq)Lpy~b@(;&BIw1VD2FARJp(d;L@v$95>?(Wx5vyw6*i4^(H#D?t6%Wfg{<$cW}XHYM#1A*mH>=hlsN&o7%Tihk%BTRKaKts_>TVov5vjquY)=} zUF%YK9$h<2u+!&Tc^#hD$pRU7Ac>SVoFHr_200v8 z&awET!Yz2N2KX>A6I@qM1+W>yO_k-jV--o>zt9EBPAN5^sJ4C68Q+8B&HT&|RC zlXkYZdRZ-ZFAFM(G?mX>_#5$uTlm-U{{X_i9q~4)qw4xrnI^A!Y-~~YtXB3iGAzZ3 zIp2e{fC9EF+O(gJR=W3xVbmhBmMHGUAfG~Uv{W3B4O?(gk00hqXpq?$) zym{lRy+xWxv<+HW;70PGwfjOGBt@9*TyD#8&~?UZ>#axOH;OI(4Bh-@wz0Ue(rs)T z#Sf%u(n#`N$8N$xp%*)*-xN^@jyRBl0LFfQi8ygl!eMZ#KJveo?*9O(wF>iu<;;B( z@K53#dY{A37wPj^3mZXV1h-O5GxP3@Fc`)P;|JRXK?GOkN9{}SL-v~Z4d7oGd{OwN z;rrV?I$;H$fV@Mi#d)Zt=pXEJSjt)v_BWU!G$v5C><{j+T~z+Gcq8_2(R@$vD$2)6 zxzxNlapDxxwJk_oMy+*j5?HRJv^Wd5Bs^#PrHR4ldGGir_w9@DFZOo$H>`X*@z$|r zb>eRn_ zwN_;xF~&&a>dj-~AA=ZM~3uE*$A<|2J%aY;Bz2y#ayzLY{ozvPZ`a5 z2gUyY+9%+Dj66}U-F#fQ@UDY@c|EP)hIJne=uc;PXpo z@=pnTUGWEsyj64XZ{YWfEKY;sp9;?k*v^e6Z{-8+E{-EsTY|oB(8Q|7fj|XSkEfsT zRzAKX+tRdcZ7*#){{U7ziWrDSO-AfdC-xZ0UF7~rpKK}saW4bt*=#am(SH#HvD}L1f01|#I zS-hn*<3xw$La!(8$zU)!Cz||r{k^|s z?-TyRzqB^J`#yX@kuNn3F_PlS{bJg>jg-aA7m194yekGysOam?+@H3ig@rh%McqXu z_h@$1#MW@!^L=Z@I*8CMwV3bcS)`fc&zieV+#Y~uI3uaYUMdS8i2gCXwi-RpinRu_ z&-{2bJhFg#09XKh^NOLU>ZxUEG`7$X=?O8RZe(Hn zJ*#?@>GCwu=Tx0Z?%O`o{fB-uYlh|@3;26Lj`^XP&D^%PLOEQ@{L3kxIU;2nih;K! zzF^tNuh0!EQIyPg5a9}IkB`1AWI zd>8$bei%ROMd2?CUVKP)wV&cYifn9lOLt)wowIGyI8zz8yMHq{1W9PYO9jPwWMA-5 z--s8V4lVpIrs%R>c-CEB;%ROpv5jMnAQ#K>(GZymhin2sUnnzVHqrS<5pack;=i?_ zA9cR=ey_4RDAjb5Y25u&@VCXgUlnUQc7tuBM=g%EuPbSqymwK}Z#>aktCrooNu9{z zHdS>#SPaT>n?5c0nc@Ec6nKK~O}}N9O*>Tk8c*e8%bA@R3T0vYvJnrR`A}jplPOayt9y7OXq3LZ*nDRq+=#gn|32V zcZ0~@asUFfz9H(?pAY^T{{U%t;>S(8b2pI;7Z)oO5wT#2BQeH#VV*`$eruochmHOo z{5$ciLdRAYGp?z3XM6pUUR!zOj(J0(WEKbaQh>x@vTakI4}^cgPQE?s-Uzq&RcESb z`nB(dE<6V|qv8wA8_07F#n6^}PdXN5k(2i^F>Sk1PI);4iz(p@#~q24IYGyj>!$YJ z!>x&eN75cR__d|@N5POdqkF1E9XezBg&DTo63SpkUNphc^CW?Z}yGw zUxoe^+jtwq`g*YO9?~m1Uvi8M#Ce-s9l?h0LUHz={1ZF&KJY*7-}_Bj{6qbwyjwP< zZ}7WGhVMu4eaZg-knP0N9L+Nx9^L^BxOkW5cA76Vgdt}AOC;br7%4jSlTAG}{dyin zY)x9S*zU0Bf6+i7r_7&R~_kr25y|pYT_Y*;C*L?Hlj| zMuXyqiEK0tb5HRdrk~)ALgFN@BI$K&;84CUrN`IApvzFB6T(-9&f7jx2Ri*5CR9|KNec#rnnEuqC z6FwvS5&r;!BzzQ#Jz~Z`6ns>lThVoI5y4=qtK9fYO}MyQJvHwzU9Hp@1~bflS`U;E z-zomn*6lxwH4EEeg_Z4O486l!p+Bi3@UNvm;J6w|_*>w=*^~A}6kTOllYbjUL6DY| z?od)%athKV-3$q7CS9XbIs~LeT1vW^w19wg$3{tS#27I4fA@acKJB`mXTLc2xzBx0 zb9y9N_My1trZ-agHX8|l@}<2~G7ta^x?S4|?*DPvmKUx6lJZ}kw1BS3JswW=%{t@7 zk64yx(T2uN+7OHXa57YW=J2V9S%l>#-m{`OSeY<$m`CvIf$jl0UD6H2G>dXmD;87# z`vzdR7Dl}!NSvw=cc*0h&Tw`HL%PS|rhXxVoVM@X&R`!fARy!$suw0qx4s@J^>sY~az7>u;x#kvw% z?juN@PhQKj{_W&9Tpv;z>y+)kvGyd6VpUx}m*?iAc)i(iatPyMJ^`sHUii(gWP*NO z=;tlduGZk>R~%W6d3yr`D;R+>jw+VQL!c^l!TQL(EJ1TbZKs~NLJgX=Q6}&Tx`Q^I zx7}Sn$pyvduUa;P!fFW$5W**|+r7Fwai_QNiS3dYvKVJrH}P>JwS6X87D>)&f#=Uj zJi2^lI;;dy3e->~7z1e+v9{=T}=ZYDIPi^3gT{W|h6znCL@{px~)xe?V-~jza zuqVj9d?Ubr(DUEo$AC*bgU{9~osL`{{?@vRgdUw^+j4;oXx=5c=M}DVN0in_ZBGT= z93p?Kg1A2Q%_S$5MM^%?Wn;;e_zhNgXzt@cNkKO|;dxtwcOOg31G2sx`Ca^C`%@BO zW>oV2S2$4&-V4$+(U%IW0j1D|#W>IhY&xT6>WLJ-Q_QihK<497uM+)dOe{%do>Myf z`+IT2immGN9+UqvFVGVI9G^I?l%8y@q>ezy6=YFlqgn{v0cI*q7Up!jxdtDL(ZKK8 zRce7;g8Vi@(p(~Tf9rygIn~FTG(Ecb0nGzJPnKe@xcy$-g#k zL}mXbr~?y1$yZ%}g+4~OpU3wxE+5G_BtE&ga%v!7-tW*$=NcLzM7|e&C4F23f!&-= zY_l?;^e5C4wdMuS>=u+K)EV7zZyYqLHaZH@R(80^0%+iYDQ{DUVEN?)ju1H`XC?aasC?a7JGFAd{V3e zY$nV-^|Op*ZC-3;P2wn(KqGO61`nB+Aw~CpI7`Q)#Q^fg%bU)nl7;I9ZEn}%%CP5d zK4$0F*dD0Y{_3%5EPsB?^Gh~0doNBEz1FN8wgQT&x%H({2-Y6foqt0LCLkHKndlk( zp=|vjZn7^y{$fPqHa}awW+3SW9pjr3QSV8qlRuw3oE`-sa#t}qP}YqPF1I3zZawb_|wxQ|9a3UHo=t@ z?KA?w;>}` z{x6luN4qmllQAVK;9b%mlN+hhmD<(o zX2VQwxTmW`DZ3Z0e^cVbujQzq;6t8n;h3`}3Rg)l)3LPIevIGc?lc;UvGU&!ue6Y} zs%`IV8;XXQSof?~DllVVRIMSJ_qxh$nt|->qpR&aPo?#r;xX+cbnb*LufdG#V8nG{ zstLa=thF3)Pr2|u?&WZQdZj+v#=rEXAbqj6EP&;21s zXVA4tWi&P_WN&ezPJwSQe`U177%=pQ|KTu+=bH}Sq$hh)7!h{p8|&lX*!;Z2VI6qD zca3LlyctGe0%`>a=?{POkM1uV7L&NOrp7AJ6%SxU<{-YF>{2uAl-1mRq-FMAA_c6_ zNk^%PPBCnJq2t7?a$_gmK~-G?F=WkWLrE2M>kQf-Ek3V&jc&HeuDh2H*fE?x=!O?X zN$f>wZ8;W+%sWP0<1!hi#`Zl9*cp@(6#m>J;q7LL>p^s}8u@NHmzalHKC* z8lZpNtjaG;_CvAAaEG(1p$uZT#_tM>3d+F(2udr79?$iuY=bd2%TdwYaPKsuiBQ|N z7$?(_F7L{cs2x)F-9|fi$x#)ipVRaQspX!RP7Fy}bDDnK22;#9oT+tYa0A!mT9-bG zj*iYeo9Ia9a*;2xbm873YUmn*A+O^g`Q1G0x^i{Ui%-)9XiRjq9P4ajwZ4>S`AfkG znb!6!%6Ox~w_^@CG1IuO4^5Z+L?-zr1U#4n9S>7=WE0llrw?t7$wb;5AG0;B#>BP5JeByKUx|@gmQ|#u4 z1J&XUY(PuYX~Es%bzS$SVpAK%-w%Hq#y7mxd1EA!Wnfex(6#s|HCm3vA%|4PxBqlo z-TxhE7i;vHxtFzfMvVo7*2M&>GzAjW2t4p-#ZsaT)&JC#dER}^d&x3zw(VwXWD;)V zjk?2pSrz~%It$w8_I&SG{TitEunCY0aRE{X7+B5w8u!i#3hhSBQ#7hsrjYag<9moH zD#8E4(Kl;J_sisA-|uq7i=VdKE3@l$7?o3Y+s`piXMZNj!2AefPF&t^tW!-s*qTl2 zX$xk~w?OJ_fpISkWOsUQ1xRjT4l~kYPRZNBCEGM6_B&ne4BmRu;zvx5bk^Lm8lnX# zdcM;?B2a=BCoIyozpR+3)5RrD9;ab+mcFmc#w{u;YF#u#rRsF{q-?Hk=zpYi{|`si zh-sL3Y* zr)l-`>~t!#g@-(?uY{t5DpSBO>ou!gE;tWo*T%Cm4<0Okc$Lai(|}XmZW?&%$zE4& z9)vJpMkG}?Xp7qDntk@2RKgF~&^>~bAw0&Cl>FsCsMNzUVupI%-A>?V8 zhqkUsPn>$9`HY-|U|UnVi%j06e2=!x%w&$I$otyPaK5v_Gl5cE;@bt@L0x*_D5w-w z{0{Q7J!8dP4$!bk$lkb-F=N_OD_56s_JNoZCk=0-5o5_pk5)#dLQ~^k!g^&b^H$}} z2Uab*Ee0%^tA6UbbJ^n!8La&&-6JV~g!k$K22`7IB}* zp``I0=rdV&?ebbro_0kchmvO~v$`E|Q*1gJP5wun1=4VQmzerSc+EQ$xin-J&{W4@ z+8~ZKwsm)T4;s4Y8kre-_fa;-VQudeF9(lyN_7XTaAi&2a?{(D1BU>Q zRH}eXSlDneQ*TQC_9^X>!Q!>%aW^T?#y8ROymvP#jcaDbSvvYJ9Wq@5KdEgeAmM?A za9{hQZe{nal3_XXY6%CAgGRIerz5tI#cl7Qa-jU=r{^SzO8y^yOgj*p4vIoHUwH3#$w7+=y}!Z7~6ar=4H6`OvbP88X1?1WpgvCb4bT_LmI;|(Q1Qv;B~ z4_^Tey3Ydm<}6Vm4ToKZQdsdgTErX1{I*q4@r*7*RyO{cndkRcQ&q7^pG>-aQudVB zH*`x*U|)nuY9G_T|8VF$P6d4Fd>>e+I~T;$;Hw+E;ns8soFgSOZRbWdulb&e!?O^r zB2+PIt1tf{I}l!j_gD;1d~c3^ivUGjuQ5K5>wm60t98`;%9@_#z$Uc$KAnA+qTtbL zpC>{$WgC&y;2T1oE6+I4+NQ{_21KjRWgm@w7M3qYJf6!3|5xvFXDH&3J1h~jamko%*_=Nz3){? zKNt|pZ<0wxaknUtF95c`K?vpK5d?z_9OTQZ677aMXStU*ikB|e;DDp)~B$a^B&-p?A5cEWly=< z-i+EZc}E@bBP)@E54~7gSeO~}+q@VnwIW?d)ms4#?`2KvJE5)<0S+C(0fp5fBCw9umfasrHeJN%EoK;4oUJxrn`% z)se!WC8}qG81tV2iYvilV7~Kyufgy2Et%^p z$-vXL3NgMl`-U^{1;g9Dv0u-GJkDytMg-v;^C=~jtC~!Ihd^8@Q-(#a$PnDU`$TR3 z?$9N%N33w2tu-+yvXy8W){xk>*a>sxzdiG)Z*`TD493rH@fUDBI;r4Qy$z~-~>-b%MG)R&2j&%E|Ewg@LwWO~W1 z_L_58PWb+va}(-r;24Q5uOdCblCARs%4KlZq8GDu=X*c9lL)e4qMKszIO7>=<7fT` zonJx&hk5|f(_UXcY`oOW&)?FIHWaw)bREBG+8iPBPCBi=D<(LN*ba-72|4e#vKTcF zZLJMxFqz$lZ^o4UL+X(VNej_fzu8xt&-TsT0VDYEZ#AFEJ;xAx!hox~+Y80vVGidj zePa?9kc2+kMP3Acp+kwfP^q_Dsz+woJM}a(9>v{QA$G52AG}A! z)LCOQON6nPceQgn3oADAUR&6pvAbE-l`%M0sBM@*9Y)ckyZarV;=s1_Aqv}9cAmu! zLOKoro8nGAcP43PWy1)Zf?|tzN+i2UysGBKNpCtcfLQ}|Wn13CopLXZEpK_BIG`-$ zg==*r4s;|n#)d77?0fF|dUYC{S*$G%7Yeq}j39WXGV0MzDjgUXAv_@K1a`vEHY1E{ zV8MwbKvU>MJMIoJgl~7IAEQ6CK~SaJ)jiAk z(DOLAgKT>6Z<6$hsu3C{KK^tP+7pc`BFmCN{zumi?Zc25|L@+;2+p^eCo}XyibwEF zO0wEP|MAyHu2)HtRHXFx4vZQWy+Y^)$C5a)L}!=O{%O<;{}a&jlg9g?fOgo@2?7pL zgQv~*0HMJRWG-FgtF`r49X)SB@-0#pH0aLw`O|u6(aWe&E-8L&1cWi+cz`!D=^+OM z5|Y@8DsE|kH1$DBHYQjg?*33>Gg!V}L1T}M`N*6~+m?$uu7x%~xLHj@G%-y0ngCh+ z@B>2wRzuAQN64|?zjoQ=o&}Y}=`1LSSh!?kr}JF3lf|2~`s^hBc;fty9vS@O-4b&< zec*UHaW96MVqt~nBufy$wSwwmyB!|Nw`=az&cyHUnf3S8-nHvo#6C}}%oUhrzfGCT z=v-H@knMNKt>8AOlPsF?^bE<=5!FvTF4bA`JK|RK+kXHU9J8XN$dP@h)O+A@7~MIB z^O*OvkF{9sElpBKQ z87X732yI%&w^G(0c&kEdE=Y6I<))+~^anfZPrqq?w8^y8B75B0lB%1b$VD&}giLD@_XH(;FMh;r)TSS09P#`2Hlk z;c~=5Zov)0SY5(!A$F`Oth7B!B_SzmnhPyswV|gGu9A0mJStfaf z@nINT0L<9P@x;3ZG&S$`NII;TU&Pt9;WI4^s`NEaKDYNYtB&!mp)H&y>`H^O5is8hT81i`@wK&%3rE6bxe&DKoS z_D%{*OEdFtxgMpTd2&~sO-B?#AJv8&M5tp`*drSnF~blFIf81i&a8(!+O~+Jy9a)K z^~p7DO*A)4NH9;?7uQW6f0dbR(SYuW>RYT%;4}vj2O}74SQZ;7rrsK$T}^36r~<8C zw$>>-#IGJ+E^GQTjL%T)Ys|7G+vAGVjKr8$DeVB@?m0t{gd$4p%4Ek(EAYVG5Kdi? zm~*+e-;zD1pvKJBtHA+6;A*qCf}T(M13Bf|SL}G5Qz`|H_%)iJ2>!%;Z< zD?dFPO53>T%g8JvDDt5>a@JYsyV)`YI}TqgK}s}}-&I3CWIMK)=6aewbhPg!TsTQQ zf9x8B12*b|FIHDg@Jno#e)`bV(^2H_=HYbEoA-E7He;TtlRN*g2CKDqwPs&JCqLel zwIZh+WxmP|#;gcutBa%{k}@Hjp4N{HGWQWiPv?+Xj3x^Z&Ky$nPdS2DDyl>Bc7`+7 z0FnS*b#Bhto)z{4QjAv8auT9|qIHbCfG$L_?yWYDL0F5B zjk<4kRl4GXe_ACkX(?{|HL~50I=7iiH8D?Bp{Wcg+nXKTc;8-pI&oo&fFF#Lw8-%( zepjq?(AZV8Ea62u-UoeRrR2n7u_ZsbWBuSQ@&JFm#g;;5?vB>E%A(CjwhDfxD_NdM zyD>Jh;vDm9T@)|xsXz9bn1D3-4@}1bS^&d^R0Da_31IH3V?W`V#`Z{%gPQ$Ii&EeRqyc?~XsE+-7 z8$i`>E(9TsLJbJFPRlmCr7RMgojC}mN9CI1;cR=P2jQqaD8mgYmIFA|8&mfvoZoXq zEkB(%xg0|@V-pct$WNs!HnD&?rh4Pp`Y8$oJ>-EuWL4yKH2&nKJfF_ql=SnZ)1FIj zpP+x4?fpO$kVmRWoJia&WR%PS68dB!ot&^suG__b9Ma=e+gARu!O<_L5TZ1pS>(by z1cd8{t?BOAoBK!h5nx6`+4JwiMvBDet{R?gu9&as_?(Kuj#f9l4rQ`QW-L36<3UO+ zJK+_5@u*|O;0|yQ7^lFAFd1lw$UAG6j49hHZ!I&P(O7!!%plP``WTQe@Gcve<}r5P zLC;Eqg7mKvi~!e&ham*mBH=uNg*ksXlx6|=zF7HhkM3jOzdse+qOVLum1CXme#AHu z=>#-j;d6{57OC07DMx=`3rnW6>tzn<5WWj}J{8XUPFK?vxa?=|qWwM~VN8Rz{ufUV zr2FOcCK&1L(xPrAm}BKH&(K);yv!))dL6koy{c-83b|K2+{BJQ?5tS{4`v2X(l?}3 zQcEHS4aPolI2y4v?YaxM$2@u~4Ui3;1;EvrsgNV6$%fFsn@kTCc5V4X{?D`ox975v zvTCsQ6uJ^)&4@JGSL!6vymXU5L=Kvob0;97^6~SSGtT<^R5am$oi@dtaxP>sJNff2^{; z-uABwSrWZWgHvcFF8(i*u(wvtttn;wE<*7IyVXlT< zO)@UreWSF7_pE126AX?K5c~gd;)^)C5P)G2^Tt1-E}|`Si)DVzR zZ@JuDqRHRipd{9kCYzZE1gf{PeD(gr;rTR8%A~j#99Ym-b1#QxM&(yI$>@%fla7`+ zE3n(q7Go&|lb@@Jw5wB*r{LD)CEWdxh&~f(>nDL8sc>Rw!%6GCYJYt|*pL@0W#`u> ze_vzQLg`CIs1Ys`xPk(qFjc?mY3uR1}SjnzgS8_(Isprs7VC0YfF$~96ma6G* zy1omjJDuTjCjABGXlBn=#q)T#T9*VX!Mfxe!o>!yS>T%yWne0Jb~?!>XYBGY^qz`| zXQgM6uz#(k>b(xW`VRf$UUYkci0PdWT{k3S?OggGNAFvmb}=8O->;Y)dvMJ5F{5%2 zL9R|GV6jSUNJrp)vwNOeo;=jZ->Y_o(X+4&&VNXb;xHK&CPHE5#hwVs%VB4lNU(Wp zcj~}W)#09%)o9iFRv;PfN2v@#vot$`-@d!b7Lf@lxQ6KJAur-&W$39Bk)4w{Id~gxN*f)Rr zCVTeiZq}mOgO&$3D{+cK1TPt(Au73a;y6UUCOmS-J6K11If!{SGtyq~+%(B`BNJUg z`nrhIH(oWr$oq>h`NsV^;x-*Yg&{nETA&=enh*!^vv-!iC73mw&RAf!>WM>LE_yF`9nC9Yc+o?GjGz zp?Ahl#4o8{MNN$mp46UvXiWClYY8@;u+-#A81%*57)91dgdJ@u}8v5+Y5E$oGFA|H9W!MZJteQ%@r!9?JR{ z-$Kp)!?8I&m3o_Sv}mO=0c;CS95L)t=Suc)mx?!9WFxLP{{oG`OSo;oGR$y2ZPj=1 z^)>|=l+{jR0Cb)^U&D%Xn5u7iFFjA$*#M8)csU{T{g2N6F+lEt=I6@fLanx9dHLFn zrMgV*87D`F%i%Bms2Vj!q;BrMUIdO=Qb2Sg3F zng{iSRJ#b$4A19T67p0#eco%PNgcPauxjka4&YH`TKQv*mP!GX7*aGXD~%6iMQP|R zwsD8}r3CS@yvh5NS$Pg5J$Fp)ZupPR95-Q}H!L}&#w-F4WAY~3BL)v~U*a17CZ zI74k1(|wC%F|*J0LQKLWv9yA*!ki*DPuI)#-g0hNAFQ;Q6v}+<5=k}_T-$3}%bwhF zbvk!&mssL61=c}N>E&fYyIGjwHyC0g_$5>!H)OjZ9{6*=y59M&sIulrrY^g&Ztb(R zm5NcGk?F^1J{2oobJ%w2-RNj)!jiSbTpxXZ**}p{(zY0AVoiA`W~xP# zKRB#8u=|bg7V&Qdy&FVICjfLFv(>VdsK7Ph3rh_*=?d9T{+OoLxV1LPHS@$cx!5f_ zsxc=;6B<>qC10ud zUNvB9eEGh0Zht*0vgq9`KAxSk+pf=@Y(Fa;1Ua>Wcf+is5X1wlEy9Dhdw+d{<#jgd zua19Ta#0Dy(k2m@s1oUYma9oKyav1nKf*qrGFk#9c>lq*xWzvX?MR&`KUHxTn+lC? z)AzaEG(BJgJkrCq>xfDT8v_O%m$OXuG>Rq8J{b*a==bQR%UM-{ogW&*wp)Q@62%D& zr>8ejU@C;GK9F$vO^lnsNy|Usef0%Z7PnN_M;R&;l8TYf_)^mVZpD=5n6htO#hPw@~a2G}api0Fn+r}*TGSA%I_ zUuNCTJ?vBVz;CN3iTnAV#D8m#6_K;q%fE@<&VG&cQYk*szPG`QI}Wyo(P6XVj%BP) z+?l)&r9eJ{)@&k-;%V=GWf)fD7O+H{)I^QUBw6}s*H~O%fAoEIx$oTu3A@4uPH+G0 zTA2U1i>9Yd#yYj?Fed>ytK{lPEyQ87Y=0Sz`f$ZC?gA;lP5Wd|Z?8VBAA_G#1SQ&cP>ltV z1QU5hb)~3OJy!q)SbjF+V?kVZbKA4uf3SvsNsbx13a$54*x3U!ln7Q=8w2?Xh>>%s z{C8=#g;pVjO&as34ZOS8|JE8`@+#JqgB^Hv>RgImc~KI13rP?yM9#)Es#;*vHh?(&4(8r9YWA65c#2m&lQ7)bI;P z8^GGHz>ARIiU;*5g&}kI1p74AMG4-BMf|lfIXg!`KNwchdPuqgJsIW@-{eL`*?HL5 z5IUW1clHQJP0^fwmkoy|_)NJXK!)&5QtQXRgCCc&Wx-Rtiq3 zObUvBp+!QT;kgi~3%=Q*JJR+9Qld3LmAa&3)x~r;)zqRC(>>C-3a*p-Fr3mKoE72@56~1+u#wLt#}MW) z5G%Ds@yR)sSSAwUws~c4kw38X#DJHvr&peuWcPNtVTv`On9`S=+Ql^_3_Sa15PZ>0 zX`hv1Z>!6dJE?MMlwJ-wE&A^FViG&3B4~y+lf7SBBQ!%uIi;AT$Izs*+@f*Ryp1n!7$S$v%@! zO!xIGPkBWsT^}`=hsHr9NC z$DIr6j4dmULw9c44U_KfuN?F)CD(0s(k&NuYn(mz#zjk-{H_5Sn+xvOFA^sOm>yle z8l{=EKF?6vtM^)ebZDl&-chQuHlzt+&GpEar!K&>)a}%11M&51rtrXatIegY{_P)& zNLZp$TJ>GMIu#YZF^tVcZO~@rE;(C^L+00=;GgNu#d0=-4jK+La-PeC*5+IuKPtk_ z)_s-Dd${^jj@OlRze2FLNe%SY|7) zVmxpn*<^weurd0rwvdK7_OqK~p&6`2n#GKl>l0w4tUd27-|YwRi1B-i`;~3-KgN#8 z&dC1C1ZkT57mRerW|znAPif~gjDm$^jDFbcxu+Zqx0@TM*Q%EO>v$JS!92+CLC*G? zS6Z%srND?FcS3TEfTeP&^3bxcuqLE>V)Uh~?)an$@8X$MVnB{JMaG*WPeWL|cD|i4 z&R6=e@igk7`-Q;s-6AClt%$Uz5`|=~O!~1|CZ9&ssvQ>c;PmBbZewy}3SU%kkP9K^^X})aAYYmql?-o&<)LplK_oAJA(@P%=Ftv=s@qOGmSGdf zb`S+R!tRzR5-X>snW}fxC0cC+rYY13juA+Yi3~up!&nwFOU+^4745S5R#*l~(|PIH z5Z4$Fmv&vzHbv@?xAK2D5#pyRJi^Y5B1sKj$BviSm{>Mc0=82yz7hwCzc{e`Na&h; z=ya*2nksDS5&8#L<|vs7MyT~Jh*+NC=_s@#!!=+g-@NoW_e>%AKp~#fT~Py+J(xkW z^vJC(CS0~|>!zmN^DxII0Bs@FX!rqp?wz>Z$Lp`JNyz` zS)$Ng^-)kk9c_i9?Z9?gb8v=A<0K0ctuo&?5#BZ2R(}(~ z9hAyBtZM5>iWn=q-mrhQ5*6cK+Bg{^yPXwb5>OM2B9kc}{ncC$&p*m8mXYGAigoPIz5 zF*(OeVx;V=jVh}Ux=6Y{^alDjXSj0EymjZDhog~Zv|u=%JG)&HlRX}r&&U3Mu7~+* z-)G%tM;Q5i)ZTM>{%9onW`m9U=~yh2O-p&6Un!2|vyxCEn^iwC0Dm=32B~WST=xS;ld)pE=z{M@4(3`r= zWJ%d<`%Ar{hdvom^NXD{Q`W4Se}H&vQk3epE`f`=NhDgc3N=|dYoDowrJ+e&Udh*8 zj8P^^3kj7lZf6s8tciMD6mc6f+MDQxptKP=NKv?IKPw?13EP6qn@*-0G}eUqcm3^Y zN!7pLxPNc(Np* zgZ0T2U|rV`*wa&eKwf}NKuM&L4W%yUWVTh@O~M?1kmClxsd!avKxXJ(>Wq#r)v%ESVSn`D48R2?MB>r=}y!^*~G`t=CEOd5h zFfS7A@KCV_pQqGxN4ma{1K`b0bCi8u&yZ>QdXwJ1H?@<^OwbUZx~)2Rj*ljVr~YEa z1FIt>E)UyOq#*OPoXO>}W_bn_k+1xI1lB&o?QHvy8iY8HXHcj^#96f>NUs<6{`_5Q zu?|_!kUbUbX8$bzfL-PO1A$;AxL3frPo0ZIz;c$E|1&RA$20y_i zW_tS-gL~0XJbFOCPql41-IRbn2@?M#9menR8x;q=K{Ey;#DIVI7lg6mFqxvyK6Tu^ zEha3)om48nwzKikPjI%u-4UZupbI$gA)ji91s?*(n%rTp)wmm(y~U!u(BcNwa*ILv zwvCSB$xo-9=|n%ynIsAEY>rRGt^2Wr$%0Xr#^o7zHF)>?=&NP*-P4iad4t&Cq>38j z9AW$I29y}z7x)iwqjLk#(!YSMfpZi$Xw)j~mpRq|Y7TkU27i*Bz9ZJbZ?=! z8d@q}+Gp;tTsFky;CcCCH{Duq=N!e`J_Lz92f=!Ikr7L1jb>o2_xdWz;^bB^gNZ`K zkI8T3(ey;ZJ|ihK*HvKUKWZZ<+e#^+MOpjcX_Ad~OC`ovCfOSmJr|sXk7OM#zLvQEawL(G zGunYX2P^l%J#w(`H)_={(_wp3XEQjshV;d|>^=LW+)okIGTYP+@2mPvAN!qN8*Bq9 zm8e$2+?_8}3}X^c)M}y%lH5n+dnbJ%Wa7f)PLy0S=Mg^g#v29nHW_n7s#-WWJM_#o zO}#`y-y2>?Ysi{m@|haHSKM0Gd5`o7VcR|t_c~zpSp_!K4JB(2wbl$L&o6eLy$+USXs!5a}no5t{fH57aH4aLV@s4)Q|cP zlgJ)5bYK`T2O_i zc8z%C>xS%EeI*(4>_umX`#}yldq)XmSVSlt_!Y{xGMOKG5YbY|vi?j<#y#U5;fSbT ziq7l$INOMD{>5Jo%SjSCzIv}OF3NH=H(VDt<8q{DSBdxUim?i}ewzO`b5{M4S`RU2 z3eUkIGd`sJ!;rP-nE`>Pwr0$34zbdLi?^k0lU&|oUOj2=G#NbG`a%%?XsRd-v3K>c zu*AWs-o4yWwuy);&0gJ2jIYyk8~35`lu+-?%rvs+5eW}Q7imI&)zGfHVTr7)SWjB) zsJ}FnbtMrh-yv)`ybDhIA=XbKkgCy(>lA~JXVw5kj? z{i;3Q`K+t(4=cS5jbFG}_ozhJvKWR)6$&Caq6}SFt&Ef)^zA6tnh70l`08P+t|ai8 zgpxPclb7v#{fS*#(9)Tr^J3!DgxAOybnm0+?o4E%kjVdV$mPW9*8}R8lwIp=4>hK1 zT?|?$XB55nYBMP9Qsp_dtK|73?9GzTvH)Fw7VMm_O#ot$?IKqAJ9(+0Rg0src2Hz% zV4a+l-IL0}Udf&Jv9qo|f}Gl)LPy2a>F*2n$LMRtn3>ERv;S=Jj+1}QpOKPDc zS;8ijMx$w8^iDPFD_@m>sHqKAc&Nb~6|!MoPO0)pk`))j`7e}Vt_42ZglZpbM1{Xz zHRdFokETs~^2UlguswEdk7urUc0))y!Vp=;NeRjK3c;l zj4FU*rNYSJ`TG%C?aCi#{o5G3MjF^buCbJ84FO)KUF%v`h+C$$MKf41$k1T_2&{A; zYHfkNK+-WR*49`VtkuI-9M~uOt_DS}_jji!_H2^U#!)r%q~7>U*2f__lGk7_IYxaD zyRib$k5HX}(-=D#mTx6P)j*fUYmyE0+gcFfcki-`G*>l0em8FE%uteLOcis|6?i5( z96q`Qg#QU6bMK>`gs18x?D-(m9h!^wp%r=K4(|-JdF`@%mWc}Bs!(I>-l2v&{+b9L zyXw`!oN2Bsm|vRoiD}@9M$mmcvAjCYAb9i5fuy4DrLqQpP6Jxv?n~n7lzlMy zPq$WgZFg~3EQIHr%8m9{;aYFhY;Kq+csy&aUr*22glEITZtSDaH z0U&mFF|-d&oPWk!L95M3m#7GNonmJyE7?3Dgy=b!&wa z8HUg^>v;>mqu(Qp;;@>g4S}aT@&1HON5Dq=m9=IsoxCPmaKW^=}z4CRL@5U zc$tTTC)o5V3T0A+$Bz-O?yiJ?bl#?K3oqLlBA6pk)d+s*VjK*JgNkJg(YV-wA`3tD zy_l;v_VL_*E0>`hNVnFxDsE~wwS+@HbQ@9vt zwTrwf-(;F*zs*&0=MLX!_Z;QCoJRh7s6;!|fY}jREH6*LS;OvTiX%%x5X?;TO*ryk({oT)ORLW4fj$lcIqTYL2&7s3RJnmp&sZ>E&TE`@elkJhGrHs6>6$!jhm{yfR`!@ zFNW`i!_uKp#OvF(WA*m^5blbwemw>8|50?-VNJbl97j+PDe07{l!AbCGm94Z0n()c zA}vxA#zqK8mw+Il(mA?ebV%oD*y!HK0b{=B{r_CMcFy%&&t2d9^Sut=hrUEZqyRm( zOIh`#LQ9%@hlq0dmB)0Aq683iIq~+t+vcVK(MT?T#*;g?tw`*8m(g>k&*KWOY!(!b zO0!;C0Yy7TpmQW5ji#6IAnPvSD$-Ojq`qOyt&~B-J9G}|6eMt!18RzaNDV@t0n}tx zoy1P?-93Rs4GBs&o-ogckTLf1Zm||$26BmN+eC}g&rqg6QyfMx?QB#BO271$nTzVq znX&hdFU8*amG{SUU^4w*3;Zk*>(+J1_Hl`{sm{+utiO)m8AU=-Ee{Zg;f&t^wY3Wxn6|O49KW@?C<&z3Pxb;nYvw(mi*UyUUN% zrT#*UF^kD_gDK3)^YK8Bzo0ZVWm4Pv6s@B|+i?9?cHR4y*N`vm?4! zo&GD^u%v+4P zDH=FjfvwEN={e^|AhmSq)Xnukzd%)GKd+1df-Od!>k+02Wu`1j0!;U?AD~`TFUFj zrAGg*c=0c4cgjMTpOcV~>~?ZDufkvAxYB&W5H(0r$2#MuG*YF2sK5rBQbMxd-4wVgT{B8Sr~Zr43_rwfC={I&EKHaf_ocXK*gkcF>) zk#iHpd{kD5)$RUAQfU-lh_}J`1UtLr*3`C6{wDryOn~r4f2*IdOMdjDlIQ;W|Cp)2 zo+5q?2#q=cY`AM!SXgA|FtbRM8x@dAKhNsaxR?KpaIbXmJtrS!32(0YDq8|C@8x*yd#0-(I-{mQ5gaY+f_|ljHm$(87t+AANi6W15cPQAkqM7h&ST!Pf zg>q-V$s2gp_KOrmf^GyB`oLKG@aB6(L(JXH1x(42G;#PnTDkpsMbxyxUvcN2h(gVs z>#U3PWsB}nZ~Ltgpzd(h4d#|82QFlMMy_ei_X%@{>2re%=d)soFZ%BScs|$ed9k;5 zdtO@i{=fDMq{@Tpje&qU19>4U&w}f)@*kuO*vUG~$C^@E(Fshw_rZ=sxaBKD51j@_ z$CA;Aj>iLmnAV!jvsQt|x(6Q~n7G%Ad^x{YoSZ`aZg<@9(UiC2uFB-phS$UWN5xs? zG@u|wV~RPuy6T1(kjCmnMB zh~`$tLU(=8v3I}R@|DyRBy!!bN<{lle*Ai_044tU@E^XjhiO-vqfr z72kumohCr^@^RflwfOcUhX$u9gwpQoUX3Y^R&{b~n(WCq# zCw>Yu(s2JSSb4z~?Hsy42PjB$)@tlz`^f{ga8`&d0z+Z(`Q)^1*yRSh_ z`M|54I)q=8<@QQIcFbuC_6j(B)u6p8cbet4EE#9ey zvUH&q9lz*f#I=2u<1rv|NaN%(9@Hc6T736v`Ryc6d`i?&kq@ns%99vu`oVp_DAZ5m zTVY-86I~Mqu?~){8!r3n&Aia|D@|avvre>En0OE0i__AzRDL$L2)M6vnM>7&mvhLy zb{?09X0O|gkj)q`E@O2-ctQA{^_3K?6Gnz7!Tq~IaTcL-|S%XgvD zVYy;iJ$0ds!ky?OYDJ~*hQyo6#DZ`gFTO7dNQqQDAiKY{j+6Q7Dxe$s)VkkKcztrb zHW$vdkrW82ZHa42Af=qmXl6RM+(rkMXrLwsS(jN_WIUbR%w%Q0V^NrYEC~ZSAjx6( zp#Y-$Yb1ue4x`O#P#z(u6YO3Pk7RgC?ruqJ@#W5vH&0bbNFAY*#)+08X! zKfDTujhLKvw{B9)qwtR1w zlK1B8iM^0NJLivGg-fUT=u4uCt3{s&cKeQW4l#7TzzxNI`yd#ZPbo6t&ehMPGZsLn zZy|aQz*{T_n495LGxGKq&Sm0xxc$oei2x%oF~p)juVo6=Ks?5WVS$FnabNFR5 z70;ruVEL8I8~F!SMN$u^^W&Tt)ZATnpP;p^x?~S5WMj<)F({1!9*D9bMCdFS`+InH)JXsuiE?1<+Zbp~Cr}min{ey_^}( zddI6%v?eU0zP?Nx9?iOTECW_!4)@ln$Jf9ABPq53WG>T%$O@5ClHk4+<$w?6?iy)1 z5%TNlXIsTNH$&n*HaE%vK{w;hrSQSWtIMSFkWKe8aG$goj}C9 z^P!Dm7r{J9_YERnu0^Wq#IIg!btIQ@c1Bz+RB7%Xf5`cXSufq|aX8U1=1DT507W}1 ze|2^tG`Nhbx<2hspVUQD$-Nc!%6nC!fM6r27)zQe5A)q7z;mnv>1JK^JkCGSfip}1 zB_IFk*T{^S5yeSLbVx9CT3TR@{Yftm`;LSj+_qma0tY*En0xj*$lpoEzCtri($in{ zuS4?O>|~XA*Up0InD(_Wb&H?Fq?1E{O)6Z}KW>zDf1m~=>P z6tgFwTtH2a=7lJbC|+g$I01Mw=WNqeXPnku!(@l7At zx*3|8h%XR1ZT(SjFav0g=2Pirt6@#1us(3PSB{W7FnwfvZ`;;Zi{-e>^jW$(#Vz)4 zwR0;eu`|t+U*PkSfe_TKn&0X zwRZ50B9kz2^hVtLD-k`BDw0xIMLg_S zde}PD+(7+eeyLWIYvoq@(_T|mIc)5=Rx&`x4vEmcjZf}17(eyz=4`D&){x^I!5SaS^@BJX{*8$T%#On$?RV-{see`S{5L}|`2WwYh4tn+l6(^4lPU25wdkP40^QafuDd8X{nJvc*_%~9XF&TEmQ zr;VY}Z6Kaj;uBZR^GJoXPH7h1EY(KsFO6N$qO`=(Ofi+j z&N)y-o)No&Gm84_+qVZ~u1azxMJt5{R@bjuwBK2koCPZ=fzdgA_ynJLkMkclvRt2+ z4v128v-aIz3>=M_`iVvaB5Q8Pf0#7d>A7{k$uX_uPL4g-TE#s-Oe3eC3uk*`FSrXl z2WmI7PI+oy?eC}%t|RvSG4*SYc@VMa*s(+rM)}y+GDFPEx0uRh&0u$VIs?Z;q|&_-$Dhgl#-?=YhWj$-l<%v%3Re&C8v#bVR~g7GJVeUf zbTHRZ*4Py|LF<dKXYni_p;g7 zRy%*Y4n-3fyk2ey-ozEn9q#*Mb-R2gQA@%&>1TXvL|hkfyiq&{ z@yBH3uu$<1f42QjF|us}$Br-29?N_Yi?xdaVT-+i^2k195$06v^=@|F^_KS&1XEJO z>ty+e9S1G6Fbwyjr9I^K>ic~_rFJKwv(0^bcSDV1K*(P7@c`ptrr=k2wLl23TiU^V z48~?;%W)8XuUUe}X5V|}^tkt^8#FtUbf)nogof zJuAXCC+fhFmKo~>h1Rb-dF~Z7ud?mVMN6PtetxfSX#EtQo+WqWf3a^mfb;7tqRNT* zCG%tuIVdH)x~d#2_m1#KKcK%8=;Y!W9(%}+HD*V_WCgzvSuHgZ~ zJ|lG_DSfq2Nhm%N6B_N?lx+Hb^A@jR-}!|J4#oT)#D#|jZ#e#yn3RMF5CmB)%{bd5 zcgwTpr1(W8;(4FlSdjKGm`SeEf8b5Bc~C21!n#b~{MdGv_p;j0v^>|wyMK3vBTe+1 zGOdLFcPDzDRoO>>!QxLpLNp7Zq6Z?fMexCB`2??+&<7oy+VweBJO+!EZ8AK*3056E`e03IlMy_()u&K8IT82)UJ` z2Z>Bg^RpuAQ~M8h>UaCOXG`p~;vF4}A3G28PY>@r=!znjvtuK}4*6FA^MG?a6)vS~ z8V5mjbBj!tC@NNl)l`WdTdpFkUSwJQBZ+Y`IP(FjN%I|f*K8MzTXf@^InUeGmlZeK zdE$8EaItovX#b2qAJg2zPPROwANC9H@2^ra>6MWN&KRedlUAHE34lC`o#1@L4_RiO zZ!av@fKZ9&O_qmBi`~YIPz5F$1jm?+k6A5JD=8{T-Er*a_Hb#c$PK1ONFAg0D6T}? zuavrRLKY2G4Xl|$_|y`sUa1|#59jW+JZ615vE(l~7Dum|*N$Le*=$>axw>f@K`#73 z5#)YjW_<5%G3mV~jd=8ntkiv(Nl}I_92gXGj+Q~+UfOD4ewz0NafM6Wa5h5=2i{{H zj1aIH)|WOoud<9*6Mt4xrNNQVEJWWoEDuXc$INi4wOI;uU0MepoPt0DH!q2~2uH>p zAC{T99g&=vMO6|uE!!ZmKmxlQZ{otmm`@zc>t1PeZu&zi$cqBrRRr(a={bMS(=MI; zVCAU{S)E4|q;xOn#^VyN2gd@6yb&vcJe~v7i};g`GW{TY!1n-fXxhZ9W-!Q%1ta}7 zJxJ}vV_Oxw2St3Y)}D8KHrNercP0)CMYdu~7e``Tq?r0*6lQYnpL86-le`n=FYE<% zlnRrdYY)G&M+($HRTU_n7&&QruRCg7<{WsBc4=sL>x?x(;C+ys-Xk1Uy6*(riyH*rTkWc6WT?StCq zTso!6&l$4ch6oO}d6JjGCXm%KUD~>5PLs;iQ1z;W9lw3u*BsupK-a{Y%Xn0C`#~G^ zJbfsxpVyUrZTs8Vfu3i^z7vu4<9Zmcb+aq0U&i2}vT6QTQ#`yjz zNz`;tw*M;NT>++4bVHZ=sl9xM8KGU6acDgFNs(n&kV-%L{BzhHTatzdgY^;0Cvbo6 zhh=bk6+I)Qbegq$;Z)Rk&Dhz<-VGduE>>V~QTROEMOf0o6C4cVyfWN-w((_d`V;T_ z;wJY*3Nl%7_i3aY@*^B*f#h3%GX_Ih<6i_x-|4-9 z{(?5IWWq+Ud9gSJ46^kYDg2|zAJ8m4aAeS4Jb16d{I%5 ztkumZWm*VDPwQ=5|D>WoVScF8!#TsXqi!eIvRxd>kNd@9ZFe+`_+C^o-1;JC303iB z{Jj3Tb=h$l<=X4qQ1Dk?0bGx>#y>bHwZoEOod1#BgIdgeHgmGk7y}}#*B4UrZI*Lm zR&uTB&ut>q>f-8bit)kLg~*yG%QeX0X3JcH9^PO@o3&e+CF17sDTtCn8`jU6&>>(S zM4Z9Cenu|WC-}^lKmcyfPq0DOEPCSIxx7f+ovUZllFPIX6%IqUjystzwWygw~S5w?AL(XoY$qrTQpG zZtX_;k*+}723y0_XC40Q}R_5K%Z2MS|}>>7z?J??k0qv*_V95yN4 zFs4;$tG!tq!*(5AuJ)ox=hH0@Yc}E&GpH|avtyqOL$P=4W&;dVdgYadGjMbrrDqu+ zv+~e)k_95FC|+lyyRQ-D>BX*=Q+rl?z2kXAnuhQ=FKaP)9D5duW@EVv_JKW}8d$COP36c!@0?XHv z;^R|l_VUbMb1eH9+8?hGT@ePB!6sTGU?kYH+&|kX6^`Yq+?xiOw$Gk-Fn%3z-Y2bb zs}>eDijnnF;$B*Rm}D32`jD1>a^1xKH$|M9=Go`LPWG?Sr3YtKMn@C6ZRp|`(UxNb zfa=k%+DwU2@;l4L9mba2PdHlI?2^bq>1DG%=fyoU<398S*m_syo;B?ociy#uj5ma4Gj~ zLZl|s;v)}NfxCEbklJ4b*@KfO+~!EbcQlGtvHC3AmFRlziBc* zd|jz)l{bPlfR2$O+I8QJ zC&~C=fHQ~!BZ&G2ESTcxbhTMAGGQl&cW3`#6f9vK3SGMA(5d$s7Z%*wFjKr=&(ag@ z_icBy8-pW`O!4{0fCKrMAIjssb%(*9 zBv9)DOU+PSYE0p-rlxh^ysk{-xL)1w)1lbC0c^_4R0NR@64{eQQ?`)o0HwrSef#x6 zNo!umHoE=bSAm?AK{uQR=}_nr4i>hqtSmrX053cWszxFud+P*}AT z4?!OT8HEyF$&W#075?>dDeJ*~4e1njCNyL%HTgUTH72j#x+3lAdcF)A$j1?@S6909*<92|=#Pq$#CN3f}!<0&P8$|GoFvG{OGxmn4LMx=#b0t~1A~TU1Y-DdDA0j{*4ACckflrz27?k?!gQPy~pI zAXQeq&^(v?J@PZbhN#RlD+U~|D?g*js@E!XUdzV>Ze+NAC)&yL3b|r_s`#@j>rS&< zwyN!Pvw&xX%ij?WN*=pY>aRgUiS^j^^sr6+uiWH1YMWNc;P=a<5dUbPTZf1w%HX~3 zD*mkqdamXhyJkoX{Wqn|O`L6{e5h@M9_bozS)jTS%X7S?L`KhH&mDr~ zCU#Sw;m%8lr$i^59AENd@Mi#=8o!ZZb*r{{R-ms(ng;YEUC5iKjE=ts27(A`!S811 zn@5`1R@WqJ!R676fcM+m-=9@=w7L25fi^1_idj+1RU?!7*HCE&Hn366T zN3RT;B{1MnZY4LNHV{WM*hl(?bXs~(kKNfrXX+C|x38yry;9 zCi0mZUMNM`rh9EP{2YLIHXz4ub%(6kvMui&B)qsze@l8>_CCtc`Gu!Np=oPoK9>b% zJfR{Br*Ni&&%nl_iAgw4j7ZpZ5_b(`dOFQzL7ZQ&rw5&$ceM&%8>R>)*i`}}FQIYgsM^&R&$!S;$MCv$N z=vf&b$4&VS*y8>2g&Eoj3N&>8r1#V9RhrSoj;CP;n{E=g`REEs-m~(p=Z2gBf>{-Q zGw>+H+V|uOL7^Z!$x{C1Nz{}=G|Lt!lU!f-MHoS7I*DB*$ngD{eX1jf_Q^rmrS?~S zvJoBsOC!U>_C-NEWy81^@Ma&IV}yB%CKPsg|Eb)CW%u6`K+MflIKA$ z;}fgB3L#vYv#cC(2hc@<&PR6ECtF5F>=zwxh9PfXEVW5dBbNC@}fv zYeLn^$#oxi^Q2^(2(T#@N)uYd>6qzgEL~HfIA!lK=nd?7M@5MhF92vmSRjSm|7hRq zqL_Ca;4J({;#VeH3L$vIxLs?;2{L6STRyRk$12nN-p?gm=6Iu6y-mfU>h1^J=p*BX z+E*ue_XqiFp5&KsIQ+-V%9BScv=}O)X(q(&rOCB3?xWPy*=WlOm;fqDa8;W86;D2g z^L~?PzY#l_<0%J<_H?&$au)!AYIaHO=#c$Jo*SqKIYgTy1lfe5VTpra#XKb9jL*8U zVu6dUqiF0^^$IdM(1cK zbJo*5`Br}}=z$__6$1Rg(a~mGrrXH7C2niNN4%M)HYXqvU9=@K2=)l-gjFte$Ro(% z*D+bNi@KlU&AM|T!<$;)s_v3_vx;>^jzZV&lO+aPt5N@raI}zY_Xfagc|m0;@r?$5SA+X*h6{K6N~WP&hM`yx{04^Gms^-ZrS*-J2r% zg5V=7fI_vkMzT z)jeBV>iGB_Ax*kS_VEA0a`gNcF`+=qM+3J7qVwSg($AOdFT7Oyyl?uq^oah>Y zN9ZM7rHRP3+6!FGdCnc_i2fttvmeXi08|3st(lr1-)!7$2QdIiO!Bvod7aAXprt>7 zi8ZgHo5-f_GA^|mqA>MX?>cZO)E<4UtJPZjxsD}8zfp_*bZ#s`?e`Yse!S&$?3Fr{ z7rXwwv8N7q+%t!n`;}k<1?T#wnz+t=X=v1Lq1;eTl`T+Ixw0jYT;~d_b?i%Y_@p`U zWOrjq;a289>*8PDj3iyOiKf+odE3O1y^Xhm3Ec|&&8bGuJ}{u$Uvt4R){7A^TI!$Q z%wI|*3~P3FgJ?0(9sOND-|`?l3-{{N8(|+6Q#yuR9i8poIeB~bATj+NB8Z|qzr?* zzu%Wfml#zkeGtob{}GiougFtUo$X7;Hz0J~H%9ge$f*TrR~t+ReV!?4di(HOI5BDb zx9XiS4fY)e!0preedqgb($F0P0~O-?Y)dD#xXq8sSvbkB|41~4+-~fCQ}*X}yEwzd72!|1+^ku=C4UunU^B)N)dvGlAMv77F z^|hRu^X9ePXDak|O417jteWC~l2qx?;`{qaIg{2e?hW^8{i<{?wouh|D7{ToDeRkL zyPyky`+TNZ!s9TIU8+wczVQBq{SW(ko9o9aWtD6NEsY>kPJ*ME`cLJOJ?h41&iRo~ z+V?bdz-JknbsV1r)x!5pHlthL5*>x2hFjP!PK8Q*-P~~bPtxkwmiizoQ~V_gl0NiH zAqu~7QixiS7n{f38qE9C|44v6nG!YKlbK%PkcHq->1yPlZ}464p#F8884d7GT3MGX zSp;o+-c-%K6Q;@2iGZ~ADv#KodO%_$U5IJLvGZJuunIIT{O-RDMJQOlv?N*o<9sH) z1wJ#27j1s^k7Vb)TCZj8K!DO&poU2kcg8JbxUE82&e3GdpJ!@YUkcNdRL9_BB?oq{ zU%ydqA+p5}{dfwx8bM-d(YA5(_MV6qC zO_ZH~%t{uEdUt3z#D9A15@sk#g(*(amn=TBdlyup{>fjd_+c;FEf(RnHPHVLbS2}B|^i?so9<=tHvXK&0Sl-ic!F8nZ z9ey8E{fsYGDLi4`fdFAEG&l>Gj;|1nkMAc36I-AvPFJrXb9bddj3VU9y5X!ZPo9E~ z1oz-I*0E?iF%3+fawP7d7pSz#9*0QtJbpxwvI7*x?ebG*bVSSSeFzck$V=FELy^T2 zTQsw(d5fN&;VMS#HZM@!am1-iDVvP}nW#=*fi8QY3r@`xBF8|_+fc0$&c_FEw3I2u znoIYi63nGx%961(=z^|hzg1bP!|uu5%oX_M&R?jrN7VN235eK;@71|3Cwwd*bA(BP zfF(bjnxEVkE;ThaSC+fyw^>%ZGNoTGNT+7k6PEPM!24fMOS;xWtZi`04Ip+DXLLaC zcy8n>Urzo{%hsBsH`X;vb#x5)*dCEzpUpexc&IPkWr;O@8rPMlY@Nd0n-Pb!5TTW8 zUMB8*R$kC?xA~WJ8+Zw_0iMb|ahuqS87Vzk4)?VqL^6(Wz3wHEb=!;2Nm!2yA*c8Q`K{1?8hKM$L4<^FbIEZ@@v%1MBbGR6aE<~>}q z5t807q|`oZ(Z|D}Jj5T8LkciE?uK!1J!Kn2g(Youh z1I)gi03T3czc-|=Xq*qaaLnIw>Hva5Ns84Lg!1Yu^*Qus# zP2h*!){7xq2HG_zGR$JV8@og+1mOnYI=LuliDdG7hWn7Le3F&)2f$0P&sd^a`c7>OWxBNes^TCy#%ha6F{&TonAXmzx#o#1AVvNiFmW+ z4G-MmK<>Z8R%r+fnfH_I7|8-1@ZNMIWCuJJPDgy|C?A@Hma{c4m1eVR2=xzaZeX7> zaj}X2F$3zHZWYGIe=;A6Z@uS8{uE|hjVo;m9)X|m#15iFuVi3jM&K%7D<}_wFu^Wm zyJS0dODaJI3iu{oGI!xh7z2`V$w!+)@x2G@KLQ4sb$ireICt-9GF99!Qd4;TsqL<%@SH@0WjvDeP@rYXOU&N!-1T7QmAU%}QK{SW zzcyW#i|=Vxs)m9+nVaLa0EvpOc)8alm!RD!su-Z+O5|!(WmlwGchB;O*lB)_Muu`o z19)sHzc1BWYZ|0GwPGW8`XnmK`<}V#&`R_pGCWnsVYCjr7+r>)&0&~uPlpNU;8*{E zM}HY3MxYnY4t?IjuxvSSFGuZ~W$FXp8{b5NT7F%gP~8;^f^ZEFyWkSyq|{Q+-tiNS z2Hlc0e}^s=?Yh*Cj!++tH!~>_EBw&!{IH;(H^E<5Y6;J{ifAjQ;npVIT_w+Q&tD8- z^)=kctePJQVx#1V6PIQqi{he>AA&(-zU9=*CBM!xl2k*mEkC%V4Zu{EcJ5R^+3ELR zUUT8{;TadYyvQm;(!re&vw)-f^vl;1tvn7KUd_XZ&uQMF<-Ac$B8Q8=`sbMZNtov# zDc#8O<$X@{<7O(H4MsVoY-aJ9YQ01sLZtdYDUd zOXH~TXouEF@?Nh}hj_&133a7V_{paOuorO3R?PCg=`dH>qib5MOc&7W099u7Xk~?2 z36JiNbfo?wdp#{o;2n3o`!^!uM;ayT`F&gafzMAVUO4So8X`YrMIdS3PwJoPazfsp zkyZC{N&HY%NEZAr_Js`DG?KGf2Dgb}4PEr!IbL`HpH@9ethZ@Z14rxHl|p53YT*=7 zl0x&bhTL|ZYRokc(64){6netYHwEg zVNZWqwOY#XWHWu~La5PpMn#1k?WY@1a#@fVX^RY+mB2iJhW&=MQe6K!X+n@fLTG!n z4WCsfHQL#&egyU^cLURnH)~S%RR9<-IDrMXk!X+OeEs!kUJW(@3+xL&8IZP|jG+|ZyXTT@cFBXi!>CzItW|LUN z{=}6Daip=O6tT~PeX}!XVIT+&R}{Nx|43(iPjA_xWoU(+*G1achy>6zVnCzL5;rwo=B(;>*!AvxRemj-Qv)jR7w1D zz%=3GTNI7ol>y-a9{G+o7wyK{Q|DCuQ&{Dz#NNB!zJ*M6E?Wc6E{_$NCE1nG68PMw zq=t-D(KI{0JEP~$V`vZyP#2~t)8nXz3h{K^sKz(H#0>6@Iw$tf`U2;%jraiGt^{|q zz75aY;^rHds#oO{(ehDoW6n8cc7U3ww}!bTGBjBjy9P$^!9L}7tN`LRs4OwP$KIQbhNYusg zXL0;h`q~%flmEc)vrycmJ^mOw2NuQHw+m%eJ$i5|%yIkB1s8vOHz$efTyD3Qc~5_M zRS$NcX=N^vVDeba6T0t*9=SJ57;zILt1#pxT8~$`zQ;w8RM#fZ&Po?}Ttr+NzXWD( zhpVW&yVCM+)1xHyd(TXn;!zpM=^8iW2SkYSqeyt@X>3K`Zjx3(xIwxN1y79oQlpXI z3l77`*uId!@2xDUN1k<=0t@8Rqw zs`g`&^X6;!f#6tjB*f+24!U+c1~EWcaU-Fo+0EGG{M!`CRQwd92lVuPUrbN<@i5LJak%=)=jx$b!%K;jBVTaV>g}y+F7$WV}PGYz1_VG1+NlUE)Qpx z2MxbSX_yjvzgH-|>|_UB(tH>d@bAOKP-(PIe6Wvs_MD+-=B?k`C}V51ZtOB!GYcu+ z4HH@xk04Yu#M?&&&NGDeqAj|72Zhf6u%A2y!b_%9hHR9E4JX}4ma5{gY*RCL-6@Xa zzd}ISFi!y5B)9J1+p{ax5ateP38I{7T^(!i=Ga(*=e5vyGho|$>j~cP(=J^!RH1mr zBT=bD>r;_(K(U|a=3MKm1b=elCCRfF@J3oXbXxLbf@D3zc6&p=08Fip#>(q;q)6eJ z@b>R&u^$nRJG#f#3)MJ!vRZy`5`lh z3I(XsqB5IK;nk4TtSEcvN6P(v#NdQL$kH=oU0aH)sM%|6^Rd$_B~rJVk9Bpmm0tXm zsdAU4Urr%r^ydYJz;$M681v&pmD_TJ{g&O~9^y)D(e>vuZ1oa*qU+5}4xGw<(Hd6} z$-C;!^ceqLDt$a7<{r5!_ig+xhVnO&Q`qrpzaTh*m~O)3wZgns3Z6RkzLY)~Xq@2-&)C*5ovCZxcHqE{Z4!)7aR5bUuaUVgqK)I^s# z_2HL zt&}vhPY%C}PY_7asx}RfrCxu-y}+_UWOjAC1Brg_&@8dRvL+ivkE#XdLN-d#S@a(h zDwniC(o{<8b&*$TdvjI15H#Gps4R-_)M2Z@Cv6n4>8I?0 z@6Qn5To8pI^TzW^XTQ$Z)&7oKu#)(_U4bzbzGPZHWO7;euzyr=m2#08Dk*y>B`MVZ zXPWa8ccs_j#$AQuK7=fY?UYlZ_W1RRs6DuEau;{j!*{(N)fS7nr30oTws>A~xHv{B z)p(xRo4c>nnx1h`qnT$7CPX*v<<@l=<-vs|?#qV&zE@QN6r&pZvvjHAfO| z6;09SJVC5DCo6ik|EevpUV~+P1N|*FgDiI%OJmGOm`%dz-e|muB0|SRBR#_~ytt7|-6k$Zx4T=q_t$FGHZ(2ODK3{XPoMadwgXPzX(K1Qgw=@bLJfC6FXkV7ddJQAz9CZPuB?3pw%X95)hfoBS1hBDA2)1N2H%;4aq!FM;_m0O)`UBu+VRj=vcHLqA34BDcm}bK#V)%iOhWpNv(_txfefS1Xe+lgVV7*tb3Ujcdsn zi*0)HIq&u*%T3tB+FS$L!lS?6%@0vW5?%il$}PTeP@3M(#NpgleWDegzbo0Y62|F7 z7xk7{M3(AonVGA*3b0=vi5Hky1cySBDA_1-A;wW&)h(W(e>+4)q~;shL9*OPX}am( z!MfO245DY}k-YH~OXjw(f$cHJPAdYaJaKTMrqmv?Rr)aosP=0zG}8~zFGA!s9ue>K zD5sR{j1@avdUZbhyR7&u9aK=NB)Fs! zsFlsRG8LQ}hMv695F6jPIBIG}k-EM0TL-U)pi?c?>mDnG;zvj}f+}W-lcVd_?z(+z5Ph22i zkZcS36GyRbRM>sW_|uXa{m>S=VpA{m@Kt@?&X^*_r z`j89gC<84lp^`NM6?Ic0*+l2b>~7^7J)CVaJfms|`q---mXTGBF(byGds0$ack^ze z+{EQUH8QziA_JKI#N`9JN509G_&y1$hTT4@#A_Lmaos}MtRB~n>}t-TI@xdYsG%^I z*6jks3A5O@KcLd z`l#a{F3UhQ!G!a}4(q4_?m2$SDP-=atjx4QwaK75UB9o5>kBS5HZ>l^sqgmxNbLSc z(OE||`TtQIL_#S6L3$_%($dXTqy+>7q(!==n-S76LO>CiN-N#nFdC#gHbQzM2WbemZhmWx`I*1__vqvu6q_kw(f?DXFCSOzK8uxc&fAa= z3pM?%wp*Ki7voD6Bv1h^cl!sTItS25R*e|gChDGy@MT@s$=o`Ye^HSUKZa+_Q?|o| zZ?asUeUXwaNPTuRr4}7P`NaYvs~Zm#pj8B1S-<=N z@CUjveon*{)vBBNROSwUS{P29{!+CEyqK~aAO>Z_+<(~hu@v#$dm?xP37%>Pv}Q0> zT|4`@1dwCh?bg@me71-fk(4=~_;zD7Y>i2NH=V?2xf6(SA?7LD3id+*(cgOe-@n)W zkv;R7&)&Nw-0BCVCi{~S?9PLyI&v^Rw;cF!#XGeO=wR8_=8!P?EF;}29^7h}QI(?w z%k16nhW`<~7TF~%zqsYz-P@&@e+ify`(Bc!q?@r~2i6c{7_5-&e4ll#z&x99pr>Yy zEBhFqzX|`U+F2_&s*^;p2Tt0%$jKI=M18JnNZoT1QNvaaY{U~+u0Z69`8-JHZu#&} zsM`EO9(uvF3Ma%j94wde*nTotLxcTpAfF#zgVzHio|C1gi3{~lQX0}3=R783U1=m5{|JJAJqV4N`}r0g^1Id&j3K@?Q|P!m!Pkh(R-|2FeYtt$ zou_z|cydGXC+?O5D-T(N*gK0vj)Syez;?in&)7Ga=&y{;PS%^)Oq}CL&D0V#bP3T2 zzcIYKCXAjQo?2Ph|Nb?1`J)efgP>o@zrMH*w$?fLWpBcPGrbCzh-Yysv6F2dOH`xU ztF+4Gy6bbD6K<$~`2a<{`rYY4uu46{LC)y>hi5liK}M<|Xs|{qqxLs%-6npC4%Av_ zh_@h|q2%Tq_q@PjaNK~7OsG(_VIQBpKI z7g(o!o%UT}TON)C5FqGN+ zXAqcd^`-ZNl(au;kqRv(@cE_oUgTAu<=uZK!Lst1DP~TO-stg%Bx*wlPj06153t;* zp((^%u=)>^wzIIoC_k6G9%Go**(+Bb|Wz6C@^%HNuWYV`$%KiTgF_1 zRT=u+eW9~ITD}X-zEM77*LJnJerSXiGs3`;!VG51*Pj;a8&W@vc{~~|Wz1CSKAx)F zUT>@efcT|^O~P9P52~NOSQ1%l5?-j-RfTQ*KxbwDm5P^W#aX*JR$Y6ow5pJ?^#u`* zeVXn=aBAzFn*#ZeXsLHT|D327b`i{=)Q`y76aa)XgS>r=eXTs)_4($RHUzzY{?*4^ z=Ih<|7NSKI>4C|O&vxA)!@5y3<@_C$vbiVbT5Q~{q2L|=QGh+-*H@jv@XS+YI1=Xs zq={>weHnvUFQ}7$D5YAYBOyr*YY)(QuucA?z#|JxSj>c50MT4a<4lE3;&Zg}((aTW zc&_edI)Za?=*apk0e?T}mIRnY2=^p_8TNqu$cO|v~ zz5^_p{pm~_=r>k&HWZXJM;lkpjC{l2%<}XLTiZr9P6Jc^V;@G-Mp%lW35NXH>(y;= zFvRzuk$F#gSu$dtbm-#pfVzhy2r)1WBT~W@wpn|Tq%v#F`T3Ekx&O!jC#pByVe}mk zSzr%Y5%SS9w)v+ufS!};+=J}pr1xkpmA*fnh=bIU#tIgsZ7Z_B$oX_&HKAi(e^xv| z{W%c3#y$&7-CQysJzBEuZ*QC2>8n3*;k_sc&*Em<=juk{CDZ5m->@LaojV>Fi_1XvwzHzThfs?Xd zAuHoR)QXS%HFn|abn<@r{(i4&4V>GZ&1VpGb>Z)$^v*PfcAuw zV|2{JoD+?1h4$JydGDleOMPgnoQ7haNkyCXL#m7-#S>18M1p>e_?jr}Zq?f{PK0a* zR957x&*ps0+x^aa`m%9y6S7fi*&y6?vLtnB-Gs}9*iIyOu%hiM5dgd|-Eg*zr@R|t zTdD6^g#MOdfDB`A%45!OdZITY#M#4S%g?n| z5RR_^&p?OUg@IdC2xwC$DogusnQO<~K>|5gfSBt6vkDQ@-q5l0_6e=i4LtTjy*|ka zT_I!_GBw;q6-1aE<`F(=H1pxpA4)3I6*T``Cb!9<=bAXsunJ;znke&+G-%GYY^C*1 zes~xQ{!Be{_CC$rKP-J`Oolzm%iQI2J_O!zV(H|iQs^J0gC(u^D@e>gKJ*v~DN|V) z@kIE1otf?_$Db zaFphaXzfB?mIgP{$oTdmhiuzr-f#I(k6jT!#rMAP`|M3dMiS&`RC?zQAjXXtOo!K* zx|DB%;uR%PxA}{fY5Bj>Q%H;WOFPgEk!aEN5i~rqtgvbC^52(!DezJ02vr~}KB5d0 z)NR4ioN{*>L8>s%gmrHI+ri@CaY$KAaBp8M9?d`hlWCP-tRjbdLIQOa4R!!UP5(#W z7&-x=zhL~a2D;@&?1(YJ<=%M0o`!F+63gdU%lom@0zQ@GU@cT|Cn^~~X-UDrbl){y zx3(&SDDlD}?t}k;Zw`ACV}Bq|OdI*;0-4B?kXLTfoK3_*k>r7*z>t*;Gjgg zwAzK-Nj~sO47pb+)FDh{fXC-z=b$I5ub<7uUp=+1LuExlY+%b18xqB_;y7Ba*)5gE z>=16Fh}Ws_BU?oCcUFpj+t_?KmpC1${)JzF)U3z5d3VO(1zOMy=~kXY+;P9vY*T*l zgmH}sy`yegu@7JB7{dXAx|MKD9zP0_5KOZHqFeJ1gw*wi*t+jtr}8)L7vnw>puHmh zBM_vX>HyU9h^Sy@+@DSx2*Y~}YN4Ta^GMxJ9K6zYdr!3cRTS5T4L^z?T&J(;Q;(aSqLTUZ7E# zzu0B}Uo51UypsYKe=T?Y2=x3v0)J1V>1@>ceE^gE2<%ea-kReSpEDxpQvU^%$v?{!`?kTsIMqk@zD(A&iM@ElX?&YZI3 z-Q-5jp1+qI4VXiESp2v&<+a+`JS%>rs8)EqQKag4Bc53}b4zoBXl~{$ZuZMa6lQj? zB*8!7mrBAjzjvbQCE3wbHtsyxcMZkY?=r&BD6!H+AqcF!;EnOT~@(F%#!fJpK} znISF@3@E>MfEX2Z2cL3zS23p!nz&UAZ`4UUfHJAj<58r|8<2Cp1D7TwJ+D{_$fT;6 zdY;K%=BN6dc46=fo;&5b%+oCOV$976M%iXx#Gqa`Y3$Fp|B`gQ^5DH+ph~Ob>B_%T zA+b!|RC9E>286shq4;SFahmlwBIHUh?)c%SU4>QyCVSW?l~*w}=iTb4?LItwH_vW?)pX7qn1G0&_a)F z6!=I*ut_DfdGF<{SoezbUi?lT(LGaS1cX!B@Kc~$)%idB@`Pz3IB+3!8-jqaoxC z>zSGU&~u}9Ir!gNgXBIzmd@Xb_01^Qp)Im_JwN!xR9TVTCbwPV2W@}c4nMUa&~+uK z$Iym>ph*T$#~aZex>(%cO*cpL;@=xgFoV>ItX}aJK z8LScgm;(Ur?%?`Iz@30x{kUjQL#v?jqIo>@*yBHf1Bt)J_&FGJd6#MDL*?M6Ez8A$ zEj$O2sY*bBltS1)-!8dhfljse+r|rgpt0!+&f^ zfG(Np&c0Pe2$MKm-Ob5Lev)*t@67if0Rj|$5qWz;(f)^B^VLhhRlg*is5Iq$bk-y* zKHoD6t2Q3G^0{m2_>v%$Q@r%o${P_^g|=_3uHU?FvV+es7O3dj*(J_BahrFX8fjkN z*)-M+E@Q1`GfeT** zYyIw03t)t*zm+Kd0csHbZS6AHner2a>s@UVh^{H9Q9<=@Td1fzR6h7`{= zm53gunLui}FD~JIL{$sM^I3C&NXClb(MJ^)Mg2qUTt*@tEk$6Q9w4S!gUXe9Up zi4BJ`Vf>KPJuGoT!Q=?dTe4$GT*dSu-nM;EKZCY!1I|sQwo**WWi4TZF#HC@Wbc0J zE#H?spsZTHOJf{6^*GJ9M49Cs?Wg?k^hBeEwh6##R^WU^J)!&!2Cm>`>02seHMKBr zvTWf>L86J`nl|s`}Y6&uo*zXmd)QZ!=#A{=#q;dIrVJB>QB4gZDl+N{G-oqcvR&rF)yU$Dk{{gmsl^JW`$NG-hO(sCFiW4es zI+Zk2fm~|Ds&A^woJ!DNj@sWC4pTROPkUB3{ujC?+&N4vZk9rJm)gZJZQ0+%%@BcC zgd}rGV}I)$YSHR{t(Upp>*#LACQ-i%Kzi|yhkWJmT45$0&1d4+tpHGht}Vo#?T z@@A?s+EX+;`K!ml?^odO`nBZ0A~gDZ22YlfFx}qz>yaiR{%#24yU&O0w$4S?@~KCe z>(+?T9E3(MGhc-6H9paUoFrx&T6tT?h$aQqyHoD!cxksyN=xD zVbA~nPSzfCxQ!0{cMU^T`q(6f9L**2=c53H;2T>1-PfKD(itLXTb_~h1&2*?$EtH) z(US~`6ZMcCbfL^4RIomtcbtNe>q=r0W8dA#d^F=*6`@&0sM^^cLcHOQ;pv3>Fg%jY zimAj_c?OqskBj9Yr`jRikQzJKhApjBWWDZ_jr6BKxl)gtCpHf(B>81}rwt=pWlJ}C zAOY-P6!cQ5bM}|!n3BGx$4uW_TCas1w575?%cVWQ5V!*rn%>Bl4AQ<5B~kDi)3o1= zJF+IXEn16W^&mu|2l%|F>lfh1uI}i(Kjg5|4WmJ%2WI$m$})WaZ@vckJD;~$1x>X} zRfM!8;Z<-2pFftVr2owHU^4ky1PQgMAMU$3Eq!(sv%PyI2;b8yJc$GR!0;6;B$VzN z7}gJD_o?p#_1D!J_Z*T-gK0|Rz*|y8G&vu6 zoagkY{nfgE_-FM!BQV#6&M-sm-@10^|ABT{2m6a(Vpo7o@Gb1gay=+yo9v!`RO51IX>T;;9Nm8uD@MXiXpgm`MY74)?xc0b5H0T{^T ze?$%_iZgCRp>0n<*UVLq2A1$+zecS~II(KtF#|0f({zs40-g(@0Q7*DR{_E7ZLbXj zh04EP(1~T2Bw)XTNkc;qo|?s6W?^n!T5T~INCVQlBr|p&pNG8PY05w+om&eQ4yCRG zqSL|KV8=k&_mbeXZoGjIOcVpAarBz}h${!&tj3|wFeMLUL}eSK;Y@nOc9_;n4Ce2~ z7_+O!0aCk@VHUS`OU|UdIgPVzo_hkG}2~2@8UvE2*01Bw$IM z4-Dtz?k%fTTX&8MZH@X>0uq1rf-~DactyZRT%bfQ>o&n8ZzEg%zPb3Fe|HP7M8MEAjfMfhK8U*tq*e{@jmf}$xTRDk z#KO=r>zYX$JEA|@A%S1>bOezFYn6?l^1EwBoPVx}TOGMQWH=opy2s(B&dSew#pZ0Z zado7;IYAmM3M^7lu#L_rie@M93X0i<=eqjF}a-s>r1eW zFih?bXW8|xgw{AE8#86ZWg?F>JZq~;9*N01uqdZK@`SZL@dWG7FF#dR>Y3IAU66Js$b?<~G*cO*v`SBC7A6*-v8SAnT^4yknKFfc; z4^m52^;8%Ee$;m?EeepsNw+=uCyuD2C01#djkSE{y4!%5Xs)897Am<#~F3QW&gk0BWigd4N|dywgTYU}cyySxaSjSv$ck z7|w87Q>j4kjw`QQ%OBncz6X#{gks=;uK89lsYStiP_*X2pV`pA%D&6c<9j?DhlRRd}=}&WY#n< zk@P`F9=>bc^;Y&78^I<04)bNMyW1%3p~r-oQIr4jrgBs6Xm-j9^()!HQ_6st1Uws= z!MBRp@QuyR+z={i#^U_c-FLsH7S0y!->)YW5+ut_gX@llGo(lrf8|#Cn{R%JU167g z{D;IBf-uH^sy zur2n~miz~81>s(gG;*#33cxs}0Ey_Tmr`Zwa%pW(Q2$7UDb-k`NHe(LLFlVq`s-=b z*=53fFfYPfuCJlRTW`e5JMC8{XDG@2G`R;r+0Y>iY-vhMsr#>`@zYh&RgBT%p?sT|H?T)!R&2XL}0n+C>k$Ev&9vGv} z&pmJZRF}8UGI;+Z;9Nd)K9k=6Xs_jIXg1QRzhJm~*@8=|jI3)6jE*f6^By+ z>01A{ac_qdY4JB|=_}4;XH|rIH+XR#8J!^<-$7?)vS2<;9_NDh=dzynB!U+^P0+;@ zT9|#^7ox@cAL4Yqe-HC#e?D#%JJfUx7AZ3=-%ePbU@6jj-;lB%`+J_*F#aTF`iEjv zJ`??QZ!uO6R{+?CL&;xRnHCI-S7Ar}x+!G3i9L3*El zT<4EAqyPiD)!LJ(wqOgTuU0>gcoqHqEVuk7N1qu4*VDtkov*Odqt*>SX+?I-~8;!>K&aXuWtL>9|trM;7uf#;@Q z&wbfPI(9e=6`u*GMH)JS6#W6UyAg3hyrxwaI%df#AxQOVIe*$mE`Ph$j~HP_({+n( zt}xj}OdN&WDw>gllRJqy=FcylLh4-v1H)(A7Nk@l8yc|O5M!P`{!xGMPg&0`4Y!Ns~-|&ACv? z#y^bb!H+^}=lgwv#)5h!GySHBz8`VhHe|_+BObcCwRh7aOkxgo(dnClw+G-_d${ov zZDW_BR)%7E^uR|*zq0#DkMc|hM`Ua?n#{+FiWb7=M%+y)fLzy@m|R!3f_{uC&3L|GOmXS8qFyis}YVAwi+=t}p@h!}9YELQer_h}0p8RSl$nmSna zv}2_hy7vru*xvkfCkb`3!1C7AeeIb)PVNk_Aqb_{IN5BQq&(oHhwF}olp;G9*{TNS zSoBOYuC+H0CFfK8|6B$&Pkud&-gv&Pk=t8YBwhKd*IrscwU=LP{7-nLj(6}Sp7IMT z!-V@;wlhW~!%x28gEx`HUdu$(MG)oRA&0cjht-=g*Zp2b4JC8-9+k8^m+! zT?03HnNMvoW`RVBMw&aOM{?hJ_U7_ak-PUj4)p#yHUPGt1tT6#_Z`Qf%@Meaff+6^ z)aP$>Bd44yX=VGJ_okU$mxZOy`cH%@ozZ|z(ldV!Om`cVv+P)b-tlB&KAyLoKmcW|u&_nvu`x57>ue&bR!Mh@Rt*Q}PAX`rMQ(=oaKXp$wQuNeIa?m{0T-%yQ+;-tE88l)5k#4 z(oC25TF;+X2apgsHP7C-I^R@#* zcC)$aF+rQL6RzjOgPC8iqKOWsTb$r5bh_^{Bva#72$X^##bQpRzTk>u8xq zjQNi`E8^@w(6;Mz(qeZp`iGtO#7)CSoaOo!83%S^WTYALF9)EW;nxAc z553t#VINIedbG?|OhQQDhG6~E`v=p;sJ4miB}|rsHqwGBGs^`wOw%}BHaxC%msR{T|6I-O?H5~uCQVpu%)n^^* zPa?T;ub7SbKrVEMTO|DyG#*9PpjWc4KVrI(fotyyqNZaNVzM>;P{snjn6z$`P%^=o zB1JsQ-2;3=O>s730!}aXu%26Ji#G3XgnZVv(!1NmNi;)*zjzL&VAXHjeyOHAuHTn8 zcUTKnd>kQV(@Ub_My=arb!`|Qtbob8+*zWgH@((=DZ*dpu&%qEcz(=3)md|&%32qy z%{x@wSKcEcy{9W6&UNuv`|$J{PaFKY^@F=l0@HAb?(RzMrs@lFo|k*-k9t6{Z|_u9 zWZt$j(?Zba$bGQJ#g{3rP?~^!)xcKgjaBWfh=#P&phOSM)VsZYW?s(TEes3tSZxa7 zHBYnt5@!Zj^hhv;vUczuy5W~wPiH&9Igt|Q<}qQ5kEASv6ziuP@~A~?y6x{yE2_TI z*_)~^waDdiB<2;{J^(K^BKsGBQgAjEH<{C84ry%8>;lA=ddcGaC)8f_BGBsE+Vu?Q7g1Y6*hbK%RW0odP z6f~rHbqt{+?fjQQxDp!=&d@Q?gROTQh>7kiPrT^^*l?>QW$36SbFgA{$DdmntVyF; zcq(ey)Wr|!TKylvlg{^bg0$mc^sLRW-<6a(but9#X>6A@WBR5f>`ln)Sqh1vG8H84TrP$pxNVuXB8+C{RUL0>fXdUUgWH$jkCt~#M_D|FY>U(h^%s)T zDyHOU5`BNaTR+o0w%pPAt?J?(Bp0RoJ9J`=sVR|lh{9L)^UIiGY;YAQ^@h3C`Uh6g zhzmcc$a>$Sna-${9D4P}MtIYV9uWFdDD1c?;j_TP;hIDMaX^~tV;Nh zUpAouL(au1t?!C759Gvlk z!Zp*csIwq;X;jznNLITTtvL7UPOSI|lwByiB~Y?B{DKo^vUb7S&IiU4Lrzs(mCv!- zrEOxj&-nt}Z+VT?t_RoA1wK&y>z zofzhl>FaG~-q-@3>&6?=P#jx|J=g`Ex{RG(Vzs_Ly5yRz8xJPHv&Z}=j?8Y*9xukOsJ7f%YN!aPwjcj`t`m9Vd^wPK@=w7nA>7G$ML?% z`P-1&`8T#En%^`e&+R-tO!&Vj3LIG0g8SEFA7J?~rl@(u+V{IgmT2)7b4$%8BPb)^ z_Z>g|rex#TE>3qDcH{x6jb6$z|Vvef;M+Z}_3SyU`n0Yx-M@XYxoo;}mk7d-- z-E!C)_(LU-@p7@B-hv%VtuL%R- zZ&z`iWS#aWiw_=W>#zr_4{lg%RWV%=EZd)zEkf);ONNL45&Xcf-0=TSR=(;XW26IK z#d=1d(INgl#BO~lp57q+vKz&fSL7aT8po`K? z$<(oyG+jJNOO*LXH>qyCb09*n9kEJ42N!0INAR>3V|>SYg)EL|;6 z!4L)@U3m5@7OVe9K!Lsmi;sGDE`baiUr9d-C29VczaOp~1mGS}a=q+e91IKoX^FW$ zKX9jzs9oMqDpHsJT1M$a^!hV+)P|JkCsBEDN3ig%trEW~X#$?ik|Ojl!Q6LpcO?`X z3K;bMDcBp}ihV!}dxGM*Qk%2ui9(g^pWJ$BOkV0t8AlTw8d5i$GoWm8Lr zzzKL*>KSfm=wJCk1E|I>yj0uuymCpbN3=uxGLPvO))RiGZFyt1_y`Gb3RnSXb7K?| z1M#t<`X02YAlu^}f3qU;y5S}aY?Mr#!WJ9hw?TPp;kIJmS7M z(G&PPpwJvx2&TmoBi+~-u9TCsJ$s3#k1x8%JPiA-Ic8Wnj;6l}2078hYkIE104@j~ z?Smkx0cw-^zqWk)m8Nt<0Lj(#0X_hH2L=U@(|7V5qmQt>pPY`Nw>qI~CQpAr z2iB{ypr4XrTBamGluq$~4r1%2xvUPWMHDk~%kj(E?YNxG^#^zmR%P<>-H>0DrW?sM zC}9f=gQ~m-BvhuOT|_b`#v@D?vN#ibnq}dzQJ@!VV*=2oy-ril@;%^CK4?SL_0~7n z*MKK)F$PxLX=!c*>;P_9@7H(uPbkOWYg#4-6T9v>=S;Nfk?pOt)BN0%WdwDvY3tmV z&(rk|0u0`8!&|w}Db{Q=)J_-93w0+f#-{s2KOI!)9*7JTIaYJ&q{v7Q@)S!5OKsJZ z#&}qCqVB)j=E;`^-n)(5&N{C9Hs-?WITwp0bz=V!Kz~62S%p2c8&vnvAxm<;lghk& zHyrWp*GzdKp&G}Qz_))PicOVfO{mz0q@?l!no_1GPv4QE=m#)GLk8Kz0xXl7si_wg zzXOulomZ1!7yo#5vrTGuDi_x`z{x(K`?;Wjo1O1Jfvkl^2&Z1htj~KyZ%?1=Teugk zNMz!tfI*HBF84MW)Or_TFpGy(sl%o1Ys1XI0xvTseS5+}K1GAOA(Psl)Cs6Uy<9ns zP*O+AfN*1BA?};U`L_(K={7jJ zAiNd9++U(k)$mVV_m{c*eA+EW5wm_XKfo^0(KH=QQ(;jz^>O`m+qap#A)-dsAfpu+ z%Fr22+5;nTG$l;7WN7;ef0Z3FNqXvaJ#T)$G1BE>fB|&0lg^>#@V0>eQ~yiO$aD)= zge$p;olCD=#68Xtp6si3i)U;NWY&tKznXB6H{n;mU)?#BLUq>f9pt)9@M%-;pm zIAka4F=R5mJ>C+x3C-x+Z;;YeZ_c;Hl2!hcHz+ivy#4th$kYF_QUcAM>sHv1L#r*a z){%8DF)^boAcJ>EY-Ggp^{3?302y&g)wiS|2RCXNnTi<0=^Xo!lrYlsz4z&=;(Dx_ z6T$Hp*3v_)C$G4hn;^M6GUICEy&=zugS(S=>8@Xi)v*iOnf5y#x;kv-{gk!ynP9 z<|n*^-Gx_K2PTRzUcmn&FljDC4}|k=e9@zpq2F!k?86BoiI(=cr}d+4tS;MQYh$ly znj)CI5?Q^+<&0iBZh%S32-6W_5g5LjJ=(_;O)HRcf5tLFGR+|NLgw+eYI`y9SYbX- z*JTB$`}l9CDhzpFgK&|vp`=ubT7kN|EdOItDB{E*SQu3?--mw;T>brY&`~XRPliGy zqPk;zRfo4}5gHm zjEVX=U(7ExIxuXVJf|Z>+zjc)Pk3hMpQ;BJ})`#sT9wqz;OMy87Ai;{=3dx$=uF&$AJImpq-hCx<#ls97b6gJ) z`AkAOd(XaOViB4?LSSuY1951qZt(8QmeqBiKU84mQ`=X+eC6^@zRMC8#756_G=WqL zljrt9*Kxy5`14{|x!0*FX76DwCNP+A@YECrhyP9A{X`T*I{5?^*!P!=wdsl z!cWhak3X$$;R;k=ESACEp*~P{~cYtzN z7r6C%p?8;UpHffL+;{O%LepV4yqlV`@8#s~!j=(aZZme8PDAvp9=4Vk5>x9}%mW(S zkq0hi!~_^u#8vY6twp+Olhvrn7aO4vq7r_nr*dG?H{>6jU7wSQMIrslT^qBPpSWJ0 zWN;Zxz#c$=lWMeuFi>tV`61-VW(}7!=NIenx@-F|#Y>OK!AdDmE%=BA<@eUyYcngZ zD2;7h;6`H8h&<2lm5#h`ub#1maXh3M#(5-s_7v$M9x5^RFC-`U<)0Or)9a)OwEfLo z$mQ3T4ID1qGoYu!c^7gAKMiAO1Nml#D$EF0V2k<^F2x(0ESmRaKx$xE1#j)533Qah99%v^)hwY9NYx4J1-Yta_t59pEgt&GuoQLbD&*0Geii! z)x!o?1FB0hpqPXU9cG$%d!H8}CeMkn9N$Tn)>zd&C5;ay!BlExjAjeO8r3MwR=-yC( z8#`fg`X2#(FxkBLm7MtGNS>$%Y!qU0`D|ywsolk6;-2(D^VWX^OX-#94?%iKCNIOr z(%0!5D}v=`#CL7-dep}KuWR2wl9f1TT8e7-SZXIW%$ZBD+ofkM-SSYYJ(f23 zJsJ7R{51(xT8HXK$jt>;D0f@JvHg8T-R$8rk^t?zFL`!4s~o;R>pzIf56SSw_cjYj zmlOrvMz36bXw=E*25wHO;)6fntU0@nYry5Nrd9?QjM-`@)A%=Xa>pe`o@EJc`p=75 zFfeX?0Lqj#Id@}i**{kgfphhv6|`U;lu)z(2y$kAt>NN)U5lHa1>pDszLuqI*X!N; z;zm?NSG>ckRd+9qC@@g(Y56!LK$gM>yrrKvWvpo1!o>EH)!=uW5BDJFnbEdB^rMq< zo)L*cfB1khi;w}t?+NSGozIP(DJQ)&d7rxUcFp0#u?5O!lGir0Bx)|xhEoEYjo~X{ z)L@M%Ek0YV)8mOxqtu&Pl4&J}gval_)MslzeAWVw>tckYWx9qVJTL~gGBo$BS-#+( z5|xWikB9rE#K@ya&;Nkk?|n|Mw3?SluK?T00-H%V#m{?8*Xc4h$%MaVFJh64?iDSB zGn`*`mmQI)k|pP2Jq{wp+|s>*gBsop!5nXC@_8&Dy;J$Iu$@^$=iFv`u!Z1EYRpSw zY#bCDSm)a2g}D7>t;2MXC~JLdVmTN*n?RBjAT{B``n{bdpx=bqwiG&|wcqWz_-eh< z>90Xq$MkLY-{w%AxK0`?7h??E)R1l2J3nQmPS36WVuq*l@Cj zM%|VKPV-lH)W!cJ;0v&i9k6&ynBYaiC$plck4d!8zE!#mz~!CP3rdm$>9C>uOT+sJ`xmcP*_!ucq2OMP@phH7R;TVaRv9jP|&UN%9>%0upk3N zvzzZ{s+WQ(T~z-O=$aKrcHGA-Z+@7pp^$J)KWL)V48) zti=_piVY62O0neI@s*4X5E_y{*$(LD@~t54o1b6mFOdBo08l}%zD)iroL}0<8%Jq8 z2015hR7;MDt=+d>Do1>kK#wO(mYFPXL?&>TwOBA&H{!g%wH>!&m`^{ z9P^(tml1I*)>xSxZx2bkD4#%SZ3d-o!v4=oS5`X=GPW24_r9HblgCPRto{-5-s1Da z&?2lpbW%Or10w9)HjZ~6VbeV;$8MLzL1oq~ymO|-G}|V!(sZb#k~WD~7>vHf60=9< z9oSG?AdoOQ9a2Au5$TEHzY%zoRMe3jnYysO>3vzT*E8C ztifWCrobJcK{#J6ONF;(+ zZb1q&fHjX4@f|g-d-|ku^U(fN>aB9e;9Z24?GCrBPS-MsmT2_FWKs?e_bj0RBomXs zIp_{EXK#RacdKC^j9%fGCdOMR3gnE87nBCZ4@21XubFi%Crs2Y8uI7G(pWgSXszy6 z@x-X0G1(gyJPhCrV)N9K0Kk9Y%-uy7wujeK{4n@Ya}={TiKA48FEQ3@B**{~en3g+4l$hI<2bHiG*5yM zU+lNmrl#SfRBMpcK(4{U+>SIxJd622mfsi2R@ZhssXnz#! z{J6*O3>rkk0CAEt&*z`hGFe*uIl72RZSheg22Hqz%%S)H09my69gTdI9<6<2s=MkM zoPukwHch*ofFvO?=Nw^J;Cd_CBL~F9MsNvs(DR+U2kTR-7rx?egcg53N+c{>0N|5!h=wE6C0AqRggJ zahw9odtmg=4}L4s62`cUKh9SHROA!ik)$s9+IQ6^N%VV0hHk@>hr`G-s_($U(+5=r4JMqQk zyjn_-_VCFvqB7$k{Kpu_IqzQKqIe@m(QG5I(C@6gn7~zAJG6BidZ{A3E5o{d_MM^I z_--@^(8A#(0079UHn2ZTWO|-4S{AyTx@Dck(oT@iy%uDe%(AXkILu{;=VIrf!N+`I zi1AjdlTpL2RkywW002Xe{(&X>vr!Lk)w>XOossNByKq%vYw-$2i~gb)A+jb@ur4R<$2Az8Ar{@ zCnV&I<0sz-p7p}KREzkq-}yKH0BUOSP+K1BXt$+;Slu-2N6Y1%zz=LwX45s>hb(;N zB=x~O*Na_A1=KGdt)|=R6I(h4w;LW_co+u(NXR+Kz?Nv*F-!{z|CG*ck*feh)Wu~9<<&Y*QWsOl>Y#|86VHB5$M{rx{&jbd;Fa% z%rtFlPtz`b+o$-KT(_CBvLqVq=#RHp-cpC4#uVc{YooEf(mYP-{iUtRaLPlXTuRKy z$BqeNM_gcf{uMQRRLSWrXwUHf05e65QrR7fSn6a5t=#80^EP*`m*Q8CHNS(uut&t7 zh@WmNd!a)$<&3Nc$l^FQ9(eoaywQ9&;hVQjHp)2}2;tXIaEBi@KJdZF9D5G+=r$e$ z@aDbn1I6D1yj9}UsKMepbRb?|r2a?@8)@^mf}bkFG3EzAo_y^%HhqA=5{{Us_5u2Ep9nEtoGtNose|;>Ro=N7t zHZO{I_JAW>MgSeu{{W47T$6aOPHE!Qz9%L8k=%2eNXs(kxs4QbInM_;Jc>qZonmOk zuZgZLyu<#n-HLt#oPUY>Ruw!@;hD|UlxFVlqFsJsSeBKKTThKwaIV#}AMgT4^{AWU zmapalmZyWpBqF?{Qt-9bn-G%c;>t9PMim&4c+N4F!QhTL{CKPzUlQxuBDKxOh+~;n zMF|{}E4ydZ00W=>a<4?s+V_nfDE3Ux3;()4n(mkxIX!=2jf@89bZKFb#br1hTxeY z3g$^Kk|Y^mx#x2eoQz;|ReTrwMSM5B@cy3OBTwwvniW?2Me+dT92QXVs3U{GX8j1S zdWRYC&1xL+o3`Hz{R8U}i`AZ!bFArhQoCul8kLldf?0LT%bmW;w-ZSkk6@LHt9aU2 zqGcW?xVe#zPxghaqaptQfTg-0#ICuW{ezeE0FQ zSBB5WJ{b76uxS&`qTJ1EsD#oyvi4UB6@#~$cWrfzhd>DQ&SLQ|k90j&W_8dlqsjnQ z1;{5D=r9LfpRIcrj6Y-z3sSX`5#w9Cs3k(BR@Fctj{KAPSAu*w_$eQVb$=FoGrHE^ z9Z$kKzt|^?$W@-*@M4q$5&Q9nE6-&$^%zQ-J|>;i{vRi`{{Y~e)jqdP>m3ev#hxSZ z=C$E{Q%nBLXoc>VaSrhpK=Cr??|bIH*8c#4w(ItqSAjeOcX49#$2W*>HmC;*e#art z1a`>$YvxZ9e$H}entbnXc^uJ;Ss9&<0*$BC4@}q7zwlLk80!83@I8aE+ZFZ9gaytB zhBOEN03RdquU?G|6-dQWmG0gCUF6wsC_P31{{R}r)cg;ukD4%yqq2fX{VS#z3OCT_`qa60 zIQ@1%3eP9+ttPd_1uW zl+{^BygB~>*{isFLFbr-z6LiA^##li8XeIQo|#(eRPIl;vBJN@s2h>4sL11VIR3R# z=i&U3$WlF07SBRZgZS5Z98u?Vmg+$3lm?-?g2DRRrhRq_J)2?e8Rxe@5ATA0?*7=H zMlH|jRIdCLti;NZPj2P;0c1bnUX=D0uDSA*jPaGK&!*|+{KU6FeMf4qWW(AXcsvo} zE;h#-40RF;o<9U@>4MNG_DMnhwca(9Ll^*HR8rciwgyQ(Ij8I{w=3H_9CG+CT~C={ zKErV5^{d){hWtqzE-fS@Jq2_=Oyuqa`wa0?M-U)_x%C88yd-3-*w!ObUk&(&$DR|D z?Rs7ArDq_<=d`$zBad=~ezoWx8vUfcBUz$HdE@PDM!XemR&p>-Nc+b%z(pOm@!H^e z=B&jXu6IQU&!#`Ea97E&)t|hMh~wuCk?x)u{kA+s;h0UE{9M1bf^rPj*B1{gPReo{ zYlZ=rs9}d0I3t?&&xSwnRy`);!|&lw7kpB(wYY@=(Dh`~=0%Oc<{65%(i~u`9DK`% zCx0IoMz+(&g*K}wz$Aa4@+)ga)ugvnl6!tnM#e{4`TWCza%^h7N_Tto{{SPdmS<6I zWP10Ee`}9}lWW&Ex|fX__VVUun&ou;7E+2U0%S{E-1Js$?F^~62sk|}qD#{2Wx3|;$qrf|d_#TzqXud7Cy4x(4=_ec&Y~%B+ zzp^m+Sg7(zrTyf;D4WL@DxYb6-|$a5hxXO*m>}GICGo^-oNhWaEu8v({{Wia(|$Sl zQ{tYTHkLnU--z1Pro}T`r^D-urP|ynCN1G}jt)k98ugtE#F{}OIka0@bI?2h@%~5Y zUFU^7UvFxU4x16MGX+;`DGVimIRKO(@JT<3^{!gfFz{D}HlO&v;3Ha7lb5|KuS4_a z<8SQW;T=t-*M1uOGx(FETsO@6PO=rmVHLjE0_*^%eVJjgh%rHyHKnT~zam)MP)lRDw9pto4& z9^uqyJf69(DmkVejecbbL3WExea#mvD{$paKU97!d@}u@{y6*s)pvY2_@$^?!yJeA zFx|63AkR>($2c9U>YsyO@Kt-wQ6tj6E_l09(XO0reL-gv!2X;tEWNv9zZLJF6~Ew_ z)^NurvG9`m+U*J4nr-|@lH;&f#t-9)@cBF`@ekl0zJ_lP+-SG9vw4vVojDmv^#RnY zj(x>@HL!Uub4!|L~I^&*{mtPqEANYa%nf@>MV&X%E!fSS0fjvI!=QWk#-`YRmCyaE- zd^`I|{>h#T)n0f^W5pULhi#(2faC9kWgxbB$`$%oFRcE=Uj_asT(#Hit8fl{37tjz`qp> z-x~hSUKZ6AK;L2FO%0yjUO^am*$6-GztkR;?SBn^FaH3+G4*)kwD`aO00h_YPKPTU zvR?Rh@^3HMh*e1k;kb`{W~UXB)}^g0&OOp!mF_w@r8&DzS^3}mj@fl>W=PC2=++Vp z=W|%(=lNAhu5YGX9}Ve;9BvjvHQ)Fj;4l0VFXF6G&+z;9d$FC{=JGV}h+56Gss8`~ z6Dc2+b?5dB{{Vu1UwrHETgH~G2i=e2p140EZfnG;Dij^2+JE8K@o4lTSATq-`%@Z(H#{o|DceiiN4Kk!dK*i17%pQZd@(%5n4X@3^A zBaY|&ZNcN)81}5qQ~n9h`y$@PA=17&{?PhcXCbY=BP56De9+(HQ|++QjohEz{{Y(> zIZI_9>+U?DUwC3ti$B9_BwUQVGB!Z=82+_N^54R@EI{x+&NyhU$RppSdXWDBf^`1Q z7E}3Ce$*edj7rOsaSw`gxe-qsVeOg6e_yRnbN>JY*Z3zow3-j?)A8or)A(n)(5^!J z5had)TIYDGF?vp4bN>J_sLQJS{{YDO@5O%%J{@?%)Y^E9!E1JzAPa&R{%4=a*Oz$j z_8a(3u3J352ZK}4?#aq#{LKgb@J2xTAI`qTpZ*ESq+6&E{@?!q6&5f_2IsG6k&Elr<{e``Ml>QQXLmh<4W_!<8Irh@qG`s7!rxQd=5-NhvQ(wcwzNzC%- zC(TW?`(1vmA3b;r_R0O3z90zg@2>St3id;{?Ao%%6DP2hL0{$gSEX6Y@c!-u)GRNq zu5IPU*)3vO6!+kU!T$j3)>Quh@IfoT5L~vQqyE^Q7lJ3`M!p8R*rOlp+_3_+JT?CS z1ST+oeebe!pT(=S@c#hp0sjC6 z0Pxz4GUwwr?EB&vVBd!yRTQkFaLGTOVmbSqKb!Xb$j-+`w{-rP&0YovM0qP1D0953wD1{hw>H7YCp0M$Mj|se#~DJ zAli8+z(Oz2V*2YIxjlM=IIXMhh{s1%7W57H~;V%&QJ6oT_J}mIQp{D9~tOdn}qh#<+ z9zbD~a0mntM;wL(abGi;(Wyqfy~h~z-p}UG0|{Bqnoe5w>Q$3gg*dkbvE4@l@$FDO z#P?_CjqpFa#Yu@l+9Fu-#vMS%;YzBC+f3PSMOyPyXIil5vPWU(I+66LAhSS9AyB8f zk4~IWw+Vxk@4#s>{&}Uhlmn2>gXz+Xu(BtQOSA+L0VlZ(Mry=1PMb_{2-~|5d8pxc zetvG94L{7iCu}hiG0Q2aa%I~>*wba1aU_U9^kM!r8(Kt}#t+pgAh^3MaQnIWgD*<6 z9pskaw5*H|INSGsN?g)nw2Dt?Z;w7FU*Wg;m_>D z;fO5kY;JXFFYhFcjiI`Lx-$I2_W_&e~!!?D^OGAmG*m$tY~w%_S7 zGazEaI0FEoRt-5ocF>V8uP-pvrl>Oe5k~DSn#B0fB*$g%mrcTde)yE+?JQ{ zTmf@~XJrejM1(QIw15ZP&B-Tm1+ma`z9Nq53ALR%=1EGzBaXt}JP0>RrM7@b$@0bs z$l->5V~$BYJt*BrQ9Nss)PqU!cZxjOHN6u-CGG=BHNs^aj)AVcYIqjncBW$d#B7DjMv!>=d*fvzIKyKBOYh`_<=#c5wTC9o-oWUVb zGI5g8MtMWi95@Tlse)O&QQ`}KI@%35Sx;`wYdxjb+3r|~%C0gB2G0stBmhQ9+A{jY zXQ-AoaoFl@FFb#y++14E@e#DhZti85d}3IPOyrg+w16_?w;2Sp9(q=9iK6kGmXpT1 zwxSSc#* z19S|EPHO$fhjmN6TK%=i?viK(e`bN>X-(33Oj*k*1Rczaf(XKv{{VLh*X4R8_aY~X zb4M3rH;Hub5`CvjcNggF zts}M$EoOn%WlW@u+lY~KyN(B=8nvcccz()jhqckREH^R4(yK@rx2PFq$2*B2H#h^Y z99Z#vyjrD@w$pB9vD4n(D58qsffASABzHJs!vyr_0FHMG;;oO5H@uE%Rc9fq>stNX zo^76@m+rAk6gGE><&|L`&pRL{bG?{nc{@ns3Tl_x^>)=HgG9E7ubA#cQUkXDZjsJ1 zz#?PI=K+t+z!lx;_PQRD^60v(!U@sW%t?ve9)3<7Wp{C$j=QjHF(b9`^~}@H3*5_i z&Z_WPtWB`4LpIjJjib0ZJ9#A5OCJflD4EKnna*ivSQ@l<7k3d`7*$I}J;6Z1g9c68 zM&}NGVb4_hRJNWbI(&BG8>!?mC{?_;xQ&?YIV%4EHg|K4-^GmNR>aauG#MfW;Ziq| zmV3B@ut0fb0G=CgJBR}yfKClf;opY-8oIx@j@I7FM4sTvvaX&KIXDd>w*^iL<7vky zImJJ$Q%l}P5}PSnYY(Uce=Jf%2qgl_qiZ-P__l>Te-e1CX{`0zi_-<9^4zf98bLdt zSz}SVa)lTz_l7bC6L%b%>#cNYd^Z>Nww94xNgc}ziwRldJ(qqTIpKKV1Ht2yS9I-q z?bJj(Jhsald9sL#ZEuz150E|EsPE5O$>OQ4mWC3PjwZ_ARkhRZXV;eCM5av0TuLGg zPSk7xz)W&5Tam^qNwp|6eMH{cdGS00GL%9cCSs@+Il~e|ag)i%TJCHubzMTxY1+4i zZ6%Ink|5Bk$sDh}$~U(LBHh6x4#d)*!CDQTrEc0>wifq`aAvo(xr1PbY@az?Zq5e$ zHUP_lc|7GjRVl5B=9*?YPMVWkUS6`^7}_?IY91L^E09i9ox8J-Tw=8jxosVk7WUR} z8r@E^M)5pnb{hn82`jV~ISPJI05zegXcyNr$#oclAta7vmLx_8X)POL7$KF4kl1XX zVU8-AXnGQAU)k4^!c6kd}=*YOjtLSJx@+!S_Ei0!tiBw0Lfcc1O8Z^pj+0$W5-Iye2{_-J1BP_#gY?O-T#ruENr{p< zeB=TZ4-5R`7UkjE!o&JN+F13fKV$hKu8;j2d)pcbmEUlyNw319C1vjptb;F!z`qX5&&() zV;Id~!1G((`7h!~=V@XO<=deB(F(a-@;NQXUIFyYTuX>=Zd$@C$!;WR%!JP>VG#VI zqMRsfA6_w#4n}QGI^5BwYX_7>4X(6>v%xX3WeP~+0P7!l4gIIL?Md)T67kyyy2qD5^HAx6+QZ)VOhyRkKL!8}O~v~t?( z=gEao&1)*6vtY3d8wBT-`e!4l6;$Upqe8JPS9-9%5NdjClVUfC)=Pxl9GNV+1RSa0 z1CERhSGc;kibhMV3V8QVz87ngjmkFRNH`pQNJig zQd<_k;ULy^E6``s#GnG94A~uW2N)RvyLTC`mr1hm6~s$D%gq!y`GZVIL7p(RhMKQ~ zq?S2Wd%6DrcH&f(85DY8rWldQ{aqf^E&ke9zMR6qS}U=6}OZ%TdCwzjKd{;~Ge?iuh;hlxOyjJ$M&jO>u#Kf!!$t1_d56zF{ zE0pp4_uB7;E?~LQ@8S`Y^Gea}Y&ba#j9(mg1HWFi()cIET1BsdtsysS5rz*gRg&qE z1Mch;=W$VvPkw`n(L6+GD8=*0-s#m|<;N4fIMX)7s4IE$BU zuD~-Kf_-_cD{q7zAG4fk{{Rmog1{>mjvF0i1B{YR)n_^6{{VQNdsTa%7-`r3Y;Z=| zP|_-x*sk%>ckSDran~ZUzqh_4h{I@Fwv_-^NgM4+=D6F+qKsj>u_L!Z-yVhzzA6(} zsMo7zw0)GN?|uigXc7EW@bu$MT~yy%2{uPP_#ueE8<|0UybR-Z2JCaeuL$_B;*a=L zpSQ(?*N{9`KM{N%G!rxdOf9Hc9m>O;=g5n0HjZY_M@H=Q&)YjtgF*iQgj-zD;CUU} zEokh~CgQtB!U)_?7%j9GB#;0V;@`Jtk9;xWzY2J3;^me7&Ca#(`^FZUmFp&z3=vDF z6=8D9(PXKR!5V=fWBb#z4W~b-@Wx}DP{pW9SB#U6x~sLPXT7?fq~$?Uyl3~b+dOA^ ztGEtS_^iX*Hv<|hRbbhE_3%l89CfWNn9HJTO-Y;@KtJ8(~;|A8i`44e1YOe zx3PDULmP4TTkm@we;&2V>b@b>>|KqmlFt~3lA>*r7VNk@V2ec%jL`2k&H(4+rQmT;8pCN<7JQll;H{g+V8ePtLxpF3qUo<9bs};HgRyL=t$< zK))i>Q;u63qtXkRN|JH>Bpg5Ck;PNJk56_XBnLfydcxOrX!QuBj3YAR3_@jp6O0bs zYnPWy@m++1PY-HWasKmrLds@@jGi{J)P>IZ2=dQvzr*e?)@uw+0191L}= zOU0F2Y^j4=t#%#C-b8I4)KEC*H3_gzcP~AL?zLb{=r*9_b;+j7Ch{499DVFntpPnq z8qi|~6P$G|(xN(iaw!0idjVH|S0@jQbR<=2)RqB>1oM%_G&`#l9yX1Sn8XpmH1inY z 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

G@9et`Ax-_{t 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≤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
+jxl-AhK- z92tHc6bp56YB9=h*?ep}KmytiKYS%t_bts~LrKH7Vin9|E={Z7fsNA(>=AXjZc_@`eJ|ClmVL{T>^2ik0RH)8j?xQDa#_SH3CS!Aykked>f%|Dqq+sy z#-^&#YDEy-<>6nQug1(QpiKa&DJx%aQ%EbXQjhOjGs- z6jfWYz$ezL%;kB6dtT4*DYG9U_(u9YG*?EbRjKU;z^6GW&qrXf>*3rA&ycM>xPV*F z9TD(c-qRPctRqrkW8h`L8TW9u4_1^`8!9w1RY-s5r!|zIs`Ii;XTm*S!qMQJ1YTO_ z$zW~t%QS%lTUH{%ckd|<6(&y7-;MS9mx2x6HGX}VgNT{?>+L%8ZLoBK&*!;{D&zDJiz`FTU)*jry8 zuPPuk*j^Ki{;9LxnZr)sA9F@LCO0bL3N08=r#0VEl&U^qh#^924T=_yXT%7|0lw2i z1MUren$RS;@jLUTYL^?7uE=^gi`1;e<9$5k42P9tG1WpA6jCPN7Utdlk0570#U=}& zR(3~aEhA&T%eW08XjXw)FA)7n+IUceL9rsm$do}P5o(Vc5Ot42QP#Ry%RL)@K*R$w z&N5QT(xRyD2BChN*qYaVZljT0uPc+f_Ht|cd6(?@T(c=Dns3)Mowsb0XY6(7f&HE- z;r~q^fzJ*&_(Yw_O{?RKzr-~l=BwG}_rkt@bgdi2V z>`Ycwr0|VhTscL=(P?{1!fdb@e^EjEwS09M`)Huq-n_*5o}C2(<4MebU<XC4*#3cuW zC%wh(SCzezCnl26YS-)gWQl_q z_!%HJnvLLJ20E%kMfB@PD`MN(zZZ^}AEmm|It|GTFpBotn@A>-%a&h~s?fd+-{F>w zFKCnmZOw;^HI!i;(J_^M<^q#PMm1b~T?=GcSr=nqu|tu9q_}ZBWq+9aH6e0szadAI}#H-8P=Pc-~v$@ zIq@2+d$kE}GXYr%_8=ekpkPmxgYn;Tpum-Oz&rOHrlM}$gQqt1@sPH0vJ8D|@A*SK z<}U5_X=!+`3NSGUG~Kf1kFxWL=&x8FI#or3H;qk#!gKB?>H#EPtmU*5 zr5gPJ6MI)Y=if@sDw2$O^c#$pO&}E-$ZmZ0XGE3;eV!`YO!?fB{X`(v^@+6fBe&VX z>x!iR2pk~vw$uJ1HOTUGGbcV7g-u>C}ubKOW>@%DSsx|CAZ~0QsL}NVGQPz{GruCd5=`Q?TIQFeGwz({d9zm4B z6|`RbTe3ftq%3WQGx7lfk9&AiyljkoDQz-J>>DFl5?$^uEfKpFLm+7i1?RhA6mzOf z(GNufJEE4c4!DxQhy1;(B>HphcT_x{S1!8H#hA!OcnX-G(StDie)C0L7&CwR3>sJu zuZmW|yP1z0h=MiXy5=)PlN!vqFFIx&N1PIr6U!52{hY^gH&CGoc@a_k>wyAYde{!5 zOYEzIGgUz+Anif;PGL|Mu#xQ#1lgSihlpAsb*h{;ENBDml(>sHSqMkePpr55S2MX^&_Mi7k zu~e`(G&5D%iA`Fc`n(4ad^sGA7ZoX*NNzGvy>ICyE~xPiRWzXLx3o zJxrbsDh+8J?w4c7{St)=#x)@HnBwkcXeUuPrLjW0TTcL|OX;5H(vtl+ldk9ft49Lj zFC{p06u$K?c5suF6X&S5Vir9Z{#4wi*H8BjXe3kO7r~`_#+c_s> zNHNcCA<_=|9*o?MV$2X2Id>nOh#VuMQm3H?wfF*2 z%JzsN=tWU0Kt0q*QV#xHp^mdB_M?8%!eU$?!Rd9Ut=UnP3g4aB}2zc=bGMG^gl^UDg~$^}W8PpFzpQnMmB zR)u_|{)j0lZl|&+Vpp*$@%=5h+h937_GcjezJtY=HgHeQb0dN-&n>c_rpz{YzK;5Y z``e#Y;K4gB9i;xcbB-3;aR~2mlr`4AyWcW}rSRhA=I2`Lx!ZT1;tdIF{^ff?o*Nq> zir}B+HSebWs$I@9{d_55BuNlzDgfm8`RbU5pmH=aEPB8;lP^mYD%2#K+8zF3vVox! zlKy{+_8y;N%)J zi!9o*P~X^ad4*IDKVz0IU-Tfm$M&xHfRXuHhh#f*;3Ug)WJi?9I+gx@!mw!A)JVDn zMNCM+LWmMe-6gi8E@iG@W8m~JQj@N2`f8{om2n6Tn?4P^)AUEN86qz^M44gT4`K}3 z$c8?|zZ@6KN1`%c&u)?FNZSk>j;tzbg1N2@Zb}S+76&t6>|)x~cG8aasrTnI+3MOW z;R>T_$}o0wPJ)Y_c33o`c1e5RYDz8HfySCsZg#I3cHFj65gAAVXsk4H4+o3o?VZdU z8sqhnJYBwxFoaTvNUXSohK|##Nsl2vh-}L*PdRHXHJj*KT?(M>N;3FUu9XI%4}v!S z<&dL9)ZpXsa&%JuiDsr6HKtN?9~LdZBIfv8mdg?pTy?RqU>8M|z zPefo8j%*%;3GRo>OnB{3i~;~tYvy}p3{(=mf6 zip-+pwH#@=lnn*d!HygQt>O+2FmIIxDVqJnjIMY`-XZo!{R+CA(J!sLgIM}lexe?L z;h-7jkpBqspcg(5Wb=;q#~WC3l#mhlhXIy8chL5T_;7RS{<+!GO%8T|-A?_kXY^R>H7 zzE^CGSAK3mmN!{6G`lCPbR(`^`-g_sBa5$}nj{>jO_!|(Jmrw67+t1_g4U)TC6$Xj z^{-YdP`r6;#FMxz2)Diz&^=@d&Oxmb8pg=czbF1-!ZyL9SeYlNMF(* z5JEhjPvxePb|XCShS|x2Gj?(Y(J41jNDthZJcL=KFlGGuBjK%fqYU_W80m|Y$EOK( z{R{qfNRH!HFCD2F&A#W`?6JW*w@l|c=I9nU>!Km9r_nqv@caCCc$6_{(^t^lF+c9d zVGj!k`qKTEXT#qOyg7{lgb*#ayPc%8b;-?5hF7ef-Yf{W*p$vU-(#oYF{N&mtvyX4 zHIH9^n7OIz_O3{-KRY7CU-(}MAM~FJy>qLMqS-?$=@wAF z1gaS!DNN)oI3INaMPCOOn;%OaQz4Jja62O0*zVz9!vTCl}wq>%hSbohR&r2mSD)MZ8w zrSt7c%U^~gQX-S(0&i2eSER$2j%ml*%w?Z6!BMg(A%WwNCgRqbP3NOYAR4W&!e2K| zzGSdApkj}E@yS_$J?QbLy5`VxqO6A~UdYvRbOo|RGtC5-87QOf6nLh$vKsI!X;1kD zC;0T`1m{%8nw?oUS_=}DICruLraO3T+2AUtKq@}2C-|6cy03#=_ z&ZYR%=YnU$C4;SS8sd8GETtc?CAGgd&c`9XH#y*C&8vDegU~)8k_R&XE3nBUZnk$J zsw8mFV4jr3G0u2Yyhj2{Z1Nk{akSjV@;aGsTU`ko=BbC(d*f)e$iBO+gu+xIMA;kj zBJA5NsFeB3vwKmUvnl_YOsz__P!(8epx|mOmkm;||EakBZK?f)=V6ZhV5>QXaB2VW z*);Eoxe*homkV~h!wzHm234L`vIq+(Sn2T~jqh-lQjQT`jJT^4w$oB@Kp^j8eg~u@ zLmBT|EF=HRY_%!#@?j&7sPW%GTc9IU3RNCPq-I@M(yz>-HBAU`xCo1#5H-EJ4 zF>^70BX=$@^rb_?W1JXmYDCV|u2JNi{?=*ycR5KPw8lAH)W$;0b6{*>UC{B5(o}l{ zX3=hUxQMCi0b789O1NHy073EwbARdL6+(lgC3;iYjuAD@aH zI)`%-C?%520@;P@9{}F*!%=1^AD4#{cF8w=l}3~WkdqyfL>j2VvNee!^PA;-z zAZ3w4l(C^-7jJKYUrScJpKIkVv)w9LF8%HDtku?e91f+Boz81DBu*zi@KklUX)zEHRso^PkjcnVrrmA2m zQDcb@06h?5k$52xl<%0AAGIz70(n`QLrZl{moh9SIi6a?7l8)fIfJ9?mr}aVxMdJ(xN!{5N04V z%f|WVV)J*Nc^|wj;Q6^(5^KzH+*g<5m?_bQNVXe`!SU!*Xt+lGdi6oo9pSV} z)A5Kh9WY;zBUQfc$f7C9KIEL4YK3~U3jf=v~gs3?Zo~9t-@p>Dx6U{7N7Sqx!vmjS$)Uek~BX zODu^)P&Vv0fXeNpD)-&L;{tv5_;O~qU=Hl?TA^=^IH96xF>v`~; zSn75KjCikn()ITx_sZbI8PNET3g?i-DHqIyRFYx6n+BF|VpS_3mL_5?Xw6kF=X2pU zTIG)_WHCQc3<2VnlMRZ7jJt`VDZ=PlOX7uU7J(0$KtYMv4J4l??zKp2@a;%j%q&N z8++DHjQ-TmhI;fn_CEr3*4Rd@;74$$u}Gph$^wey2KcVN`P{yLC#;IJ@2}+>15>zd z=3k0O>(U>nPG7m0$LhBiqy}}zx7Ic4R-xW>Z$xPP?$o!*EfwMJ(7XSoW-@^d~|SeV3s^?dfNNcwVLHAFj5=jNgHn=OtCoTf>BZ zCqC}~5sRaD`1$fI+prPr~ zrZ)YbV^vJf-Xmo!_gh%kZCDrCTp|GkWf_#sZ+SmgfvsnGBPbpm0SOz#{Nev|d+h>= z*r4d+{;i%C#*swAK=<_}&J^0+9yQ%c62mZ4bXA@tkMzo9ZK!TY)fXTpHiY)%n`^Xk zm65aNbDD1-f)^_g+l%Cm$T9p!3ayp~=WPy?(5nx)e-)92&LJl3ne3kpmw2GJq#2l` z&L9FAuT5&k<>gvRp;6b0>qw4UXJfqV<+OpcMZf!MUs|J%hS2 zG|d-sq=xyls$8vt5yZaDcKzxo!{)|MH1QXT@31?@@?&`Yosnq8S+JF9v`&{IDQAzd z*}!T4u$yVgEla2^yitQ&QfWXc_;#*x-b1hd`HV6w_e;AMWuNz8i{itz(hIhr7kTQ{kH0^BlgPr%gZU)YHQU6O{uXP~+Kh`t=LsB6AD4;BhWr**)SRY6Dj3qpf^ zhlk(^Cm#wFRGm{`W!5(?0bw{Fzw~(j$eT!K_Jo%dls{B%w+aBlQ@Hk4kv*Wx-n)y; z(SvJ181@&jc@_W4Ohb1 zy&54)up)AbF_fA?Aqpg;?bP^ks>wB*I4S^jnx(Dm=I1h+vgbi zT@LxBBKGsFM*(|Vu}4j1X8>c~c*{JZ;r;jM#c4ziP2=6bV`vvDL@rEhv!J?aUMtB3 z>DOJ&bui`ac_co~?V1Y|HkPL&iSQ4CHen5ur5zjDruYA(s?5Ns{b}o_x2>7a9CNKc z{Y*-1ubW)P1B@CH@j zj0%R>L_7m*5l`ORQxvDxczy`w^BA9*wZ?t>kKpsoU;T)qU1wqmP5aFH#oz7sJj3!7SsFZ;Sw*ZH&7j$ z#J}(FV%Aiir^^LnK=e9lr;DB_BZ86Upm_dDM&_tQ8QfRy$e;zojfa$6=y}vIWGR<+ zE(j!gqs4UQ#&ZIhNQ&z(09QBkEc?B&G{e00w+o|w#*wxu4t;iamt(j7=W=2oN-mqA ztZ2TtV|#ZUgytD7yflp}uE5aRrNuisW5C{1oElnra(vCN1m|}W9YAB{oZ%hj(SFuB zha2MYA#rN)^p33NOUFvPCO!z~U_1#r0DklT%8NPlwBu7QL3#ck?o9@Y7c5SRTl36F z7#!T|97DYV@x$o*t5qRU4(~E+*}fhw^Wzfea?qyZ9Y)Ny3ZtrGChvznF!Nbs)#o~_ z;$y&%pP>Qs4P2?u_|+QsH&L~``3ubVR3X7CqM@U*q(Lj97{Woe73>3yFupH`cH;At zNCkzzX7wvMAI_F(b_WdnSCDCcW5xZz-VEy=%uXx%|DUfkm7~bZGn$8XLgjH5y+EkS z;0W*@OST;~yZwy6mUzXlj!{AhK?sBv+7Vt9bmw_(G%!?SZ_dPAG-x=gh7G$fb~0Jx zhmi{$a%~>8-!zT1WuQ;;NXe|+z)clDVM3e|BjlPMLB0i5OTY9)nfA^e1H`hg+4wG@ z=v&BQ&s9__eKoH6;(AH$^17Q*{O)bw!IcdD&aaLd@UbMpaNyz^S<>_vS^@#S9;>b! zs?wfoowzv<`q^9n0(VZOZGevw^yEq6+npT%XACF)Y?^M8%r8aVp@w2|{N&m_)%Klu|Y+g zJGK@0vRDwUI{~g$>f(QZeS;?az1N%;&oO=MFEDo|4*(v^L079~QbV)9Z<$W`bA;Xy zg_`pBZJaJYrCX3=^MBHATu=~kIV=yw-iO{?WAWeSL?KH-8o0Q`dDU99hZlmeWT&p3 z&iCKn3@y)NHnT*9dfSo4vjK9J2^C3JvJ1G2+@y+Hn!?n71Z7c0j0P~6DUd_9q#*SU zy^2SYbnl?|9YP0M=T9u#k#a?M^+@#sR6VA9|1TPBrNTm!`O$FI> zkg31KbQ?a%g*6S{*bn2WY@rPmeeoa&M$P+GQ21?Ft(4_@m`Do)p5w6oYLEAlgicrI z$bIp?zGc|QuSD!GeKzJR_3b*4TFiVzZsthRu8h{VZ^09Ra;v!mxwd3cUVrb&>X~JK zP%03G=~BnU{zZ^DWewV&KaFip1HclR^E%2oS9>13pKx`n84Pkv?ET0&mAVlY&s+4T;Vt0EIY9&%8ST` zI*r-?2ppkLj0{xlQABWP@9I68ZyC(;8>tmC65~3FjEs@rNYJe#WY(;1`Vcx3{`ayt z_71fWbzCkm0E4AIhv}w0Zfod`CydY~t*X0@ISbejEnP+7m{$J)IYEFF#M8gKq1@SiVvFS5>}w|q$3 ztQdaP&-x`vZTgFH*5mtwMj@}|+9=w<$GUf$kjMO{=zD&W|DPBD4m73XdrsjB4U^Ug zoN;^Q8}RjtDt7|v`se}XUEd$0WfLq|ry++fYKdH9?LF~5AI2_*@qe<)6$VX6hsV9+ z_5}v8)fksoz#bNVpC@f+E3qgU;lK*TzM;HeE;wAwqFLA&k_onke#;SUMy5{z=!~56 zbsh4g!X?*q-R`#bYXWlMYhjF+;DRp6KSiMr_WLhpWyF!^oo~TJt9o|63egoQmX<|* zJhw5h+!5WAmw>6l$l@CT$*yE=fN3YRPCVM5!ONq1z1NpFr_C`@**5pZ+9wzTk(t~o zEMT}$l!hm@fjxxb!ePDDR9!uUQTR4 zPf?8NCELVjcP0V>f;;WgfQD6UXlH(9fuyPBVh=QpEW@sZhzU%Wzb08v1WTb?`j@h9 zt-oCY=boIAp^bQwSoeeO&Lfx8zJPH6R@t=Kw9|TvtLud-aYnOfw77-T)2V_lgpIXc zxhd51DcqgBN!v80HcnxBl3q2jf!E$y;^N)%(op3l9lUzNy5#Ukh|Po zWs{P`NqdkcT?ck-+P9ELe)MCyD2>XLMF2Q6_onwu9Jw^NMilkGm$5Y-GV$PI#lVe8B9##jqR zndA#LX1nqX1|F~KQYdfd;iyUVd^zv^vw|)eq&;XbN*AYUE|<+k%JuP`{4%i1ZnDiK z;@J!Y?4&*vEtLyIGLn%>4QH143oqiC+<=E`#e0|MLFWY=cFM0**>{x<*KnKI`PpRL1 z@cC?VSouDCNJ}IuBA5EIVsMnrq(S9LK)p9Hv5@OM--7OncouGSAba$?IrE$cl}{!0 z;uIAXeOVw*m)qJyMGC9W3nG(C1AhL0Ta>vL)q4IfE;UL_T#*go-JK{a3`1n>ki=a) zK(9rIE>fU%p$8q*7wa+nj)eiCnm^zI&UgNfQM)i!YL&YTGLR?QM*q2GS*Cp_uO`#;<1xJ#de9vXY9H(c?Z`nJ5e?u z@kg|CBl&(`v2aX?($nZUHa&IkXCT}g!n_6wL3cCYu?A0e2a5G^{iCZ6KAe5fgt#Jg2Z(eVl`5H=(TsWDZT*58>WzbL)Z9c37WMK3Lj3R7+>P7Ejeoda|y_1W=dU zC(#syeE|+>w0Obk*Iy~pp0D%|M6LD?z+$fxstV%0WF;Vtmx1>+BUd`@`H{|EvK zcbS`WQZDF?roP5=SdW6h=Mo1KpTlM_%QgAB0>tE zZO_F(n`Fur6<tqFY{hprWLmrqI zEl9OiA5WhMWff2B6fx#n0V_c9i_UtB%zZt2C0j_Vx@3z>P`3-<&+)D3?pTh1H$=UN zP(?@BzKHdC_R!j>tp;jz34sBB+Vy*ZGq+)V@mRL?C$$Tgq`HJACo;4|%=#201)oM8 z2QlnuaYR6J4hLGWe2Fyt@Vxz=@rJ7#&pHGH#EV|g?&tbNln1&#>ecaQ- z?u_FY-}3m1<#Do-U)v2y-fW!Hx3g82mO|tWhywau8kF&PaFE^lqSKL4dsy+3K6S9r za_v=O42w9y>pj08r`UU#FR@<~s!%Ju1tW?wC>Hbaa;Y-!%j);4Mi&`be!0~-Vsy2$ z=@+dA>P1_2WJ+$eSsLx>)|^B9TSQDOA&v3mS*GZt@3$F#Hq0hY2@y$JcM0c5{sok8GkVWZ zREH>w4yt%;K4E*x(==`YhQEcBlL<^)4-Q}=Zhx5c`=^}m^T-(r{-k*XB>V(?fU$9*pSyuKrY_t-?0x8SY@D`z;_2T<58q-gy zs^47-?iLD`P^&p8k-T6FDAZ4@=Sy;5ymq|crEy$`jVYkSHQYxe&sf>(`_ z(7Ize_i_1nK5w~WUjLxNH@;QMcPBHo8XB4XQeYKM-p3|={{p9>_x(RvF^H-w4u4D_ zM-7uX$hLphqK@03$bWbCewe(}Y@`MDNlECB{?doFW|~%Y-_DwZY;7E4&`{(}GevY<*X8EEUvvG=KIDNYK;c+2q}aojl%+ z#L(z?zG8^#pD>Jps=A{Xawu2(^7n?ncF!4Bbl#Bmncl(b<_{Sl6jKB`ggt>Kj-XeY zbZTY2(nF5x%1e;M;9quGnhGc2=N(+wZfJGV9y zjL6QQ;ewF2>cp)d<#|T#A7^-@cxM<$8{<}XYVHmxdLrgC-lCFnZ0kc)gcAbl)=SEPyx_5W{EPhmo`obzeHO?c3t1wwj8*J4E-2c)ER1dSmU9UxC}Cv^aOHl> z`%3HmASd|vslCA<=$;=^zmHS@xetHgvPkuE(*vL*0S5kEGFK|@lqlvsxJLpi<0u}! z>ob(#dq%8afH8qBLCPlMq+E44!K1r#k z<)M>MRAQqQ(U-NX$kVcs^>6nM*5Xl+O>9!6V<4;Dk1oH1M+nqdKna<_e(`!+BbB4` znwjhCTdO)5>1xC6y6T45y9IW%#(B3%^L2Kp6gVgrcZ!8QrJI7eGXLdH@hdUz3qnPD&puI12#3?PgwVM-F))n48*?e;z3qu`9jNi zGj`;+EL*oytbd&5J+nb3`#gw98} zW?eQoMTm(Y+OGQqME%B|Ix~vbV#WlJ_BtuwJ!X=kn(i3ujO}!*eR_~TSC>ior1@XG z&8`2Lm0C$7i+1#uWAr1jUxX4esdxG5cRH9yy_ch0W-G|F5|6UewgNu<4<13`z85UR zQjW0K=6W5bv88EtuD)iP*B>IoZ4Qj(i+rJ%?*-f$v5b$pc;=(K@tWA(uAg_K>9Nlw zr4k#2WMWlOpCf`8E3Q|!BeigzC%nAYZR67C@kFVAZivxYNdb-CHDj2I1{n?l@Wg_J zc?Xfk*l6||Cx}g!i{d*gE5>c6N##~)IL^a|C3BAX2LxdAUUfbq;yYegnIooHdOX&# z^cI&bwxMcHr*EYPEPS?xVgo2Ycyo+nKK|6Uw_X*BIc2}_^|FM6&WcGd7&N11;jnTE z>BnsJuOIs#h%OA;#-HP@ItgWDn$u0wEvAwY5`sQLLWPx@KQXc}3+@Gg0CC!#zr<0d z#o><-c#Blj!WNgyytz>{(Gbo=Zh}3)Ghk(Ks5aw)T|etL5c27X{6F9sRHsIs==wiL z)jTPGeI>QVn&o4aW05rb#gUb_Z6h0cjx(Hh^v!gZx_`lTic8H~QrC3bXwa~`)ojJQ zZg}}nzBhHoK--=(o-5;RJ5|uMEnd?^YYV$Om%CZuu)4c~c8OSl6q`x}c?61f$TPGO zKJtdGJO2O^{7t@|^G?>hN8&HC**ZydS5TYEgMec@OR{YsoH1NwaHBW_NO4CIL*lJ} zRE}PH3+$g(YgWGlEIhBW>N?c#aW|A6Jv|u^gM+=9Kgq zTY~#Sk!J?h$jI7WP#gaMta{hXnx>1TU*4OG-xSMdnb{$@7fdBkIolCtCysz)0Oa7- zTz?XEJtd_6%X_^=ESMWy=o%GXhOCGic} z#FFnxB)|-Cq-`S%xy}zD6OaMsx;;bUABgOe==&V5Tp;Qs*a(iSG1mD%*Jo1pwQd1STFzA0OXV^Y$HG--fU8RU%eI6vfrQdmLo z-s%uw_^TYDoGB4m7|7}W06lPfj@9y6)Nb_6R!{96LP0gdPbo$cFb8UrA51UGcwFRw zaCpUEuCq%465Jj~%!54Ojsfo`f3tX79$|5bW+J zzq-}tGF;rG5XWx<#!21#u*y`NkVjI(md#wW8tl_U1im0^q-+8tjxZw*M1=qdq!38S zIU_!tS3=|L(wucre<%K8c*s4G^vc2FTcIMaiZtX*ZD^v@BV6aUs9xMHvyl>BcfWdSb8I zYS$WNoY%=LaNK;0I!R__NWoR(C`r!Zi=1Hdj)xdxJXNmb(!;AQz3=z}h9a8kdz{)G z+;S`subAh66~`ygdYV|QE-hT8{p#C;{1Q&1IQp9MLE}9`P`tRa{@jXWR&|ejMF~;z zla|3bU{4@)2CG<0;@g|!bp^l>`Ggn>;I>KUxCCJF&Twna{{V=kCjIOx{{X{q?1V3Cv1@^Vtvmw;`dV|(7Dt!*e~RT)m{)4q+rvC9U?0;&~!%S6F+7LaeEB<(M(!Ad{ZtaqCl4#XP2*b)hfA{LLeZi`gBNb{de3 zMGU;>?-=o2AH=^L>z@ffV4sOU5JsSW+oD4)<&2~O<*<$ohn_GWlkJ-GLE*m(-4xSo zEy0bG@BaX3FhT&%IBbG2JLeKbNTx0iY&ZUb!ueB*&atIPdxzOWPYZ(=i+}2N^Ww5_18qd z&f@ybm6|d^ zTWP>K?^srTAl39>Czr%YFjx6wdx0akJ@9^E+m6{a(}(dRgzLQ=*Q`l+opwC~<0r+x z5Net<4;*_`OasR9?^hV(Ad1Y=?LHiNQEMykkHLcN;|J}qcy`(wkEoV3R|h%d9`)zn z8h$G3`Y*$|_1Ez2w95{|zFYX>T|Ah zeeh7{ILd~FN3Q{xYCvWh-(0^D->d#2N*0ifR5B7B0jhv0qlUu!* zCm8t>d7d>M!7#m-8d*LB{5ACKZ|**s(WAozb!wUXKVZ+CYL!I711)j?7Y zN#&1EdhkDnp9P@Tb-x#UHN4hZ4M)N{*VrXVWMI#2B8G}#`?L3x%-VDOAoMl$7+SeD zCY9qahso{#01k6iSh`Zx9QTVnLE-&#!y2BJ+H8@n_Lp%9VF>wFNSSlX1JSczYJb67 zJV9@!_y@o@Q`niKo5WKx;ZMqb$0iR1bAo!;%$_9uoaNDU%b6`MqmneWkg;Qppds!+ z&*fiFf5BC>kL_;(cp}Bz?TY&5M#AS9g%>{Gc#p=tdNgoTQB>u7-v0o0h7P4w2{|iR z_)_=9z8aqoFNa-UxeVNXJHMy$tX*ST@Wsmh_ez&st!Ip}0K{HPs9S8{Hhw6)PNuwB8Ywn>NzzqV%c>FMH zwbr~NuD}YI`6shh4c?D=YzUEXM_im&r$Y*%vBgso-scUhd_3?hsKVY`wIy;lNkUZHJ1KJkzn5^;aJLPJi}l?b6AknW1ZOoNiJ%>;C}P6%FmXLj#~!{3*O%w}F+F$=zvEXdd^zG9b{Mm46WNFO*GKkdFTGfd z9D$wLzrgyn!BOflzxme(5?bU3x4;LrSdDF!x1=C}>&y z1EA|Gr^tdAU%eE}zbgj=D$G9e;fdYy{Aj*Zs;-zqxWL*ye_Gnn^;sZfl522wobmw# z`-=I@e*|RM#m!O|d*4s;Iw6_VPfH`$JX`x+{2jQ~t~D#~7|(lmb1O?Yu+b$bU7IH! zTw*S#q8+2B6^DEKVf;C_h>ah@o+{LzISFl{GK_kbk(7Q}sk}MyD$*F^iXAy4=m{!0 z{JPh3qWG>0rAL;|IRVEWpPf(kMjs0WA7>_)_m}?wB5fRG>V2j6f5ANJAKN!Wz-ym^ z{yd3$G0`GmfAT;1#dJDH#{Dbeo||!}Mf*4WOxA4zDV_-aAJ24wUmzARmsA9T0VHJP z0&CSYFA?b=2+;9XsoTpn@fOR(ac4MI0s=J2|W9n<*i19 z7w+k_{{Y1Q0N@+boZI)Mr=j`%@wfJ8@V=t7B25`0k6Zke)lolD{Vq2%uL4kIEy z{YmLwSD}1A`1SDXTuocUz7Fwrmwg#K9xWQ~CnG+a0byUSx_87&-5&H$s94+FK+Bi9 z1aHs#dF$)Ad*lpc_7*=7ZKXwVr9jHc3iRpg)c%#zPdKkepCw3huQ&ey4im#dq^_O5 zN9KRS@7ovRt+tpvC-L*(j;*TLJa~OV4JPI(vFg#0wfO2rI&`i_<2QtVWbYQkF2C^0 z;+&ct^Qm{zbuBjS5Vm<4F_5P@92{r${e04OjU!c1w_02qageGzR&R{H4F1o55Ut+d z#Xk$Qxn+CSO{|8}kLd$$NQ5f4X{S@HO>E!O!?Az2*6jP58ay?N3IyJT{^)46tXh zD%oZ0>5L5fSI}P;Kj4}c8zk0#5Z+qdN6RjmsG_W&MQ|{FgbMK4{3r1z;1<6blS8}E zZ*AuiL}su;rH6l=N-+GzdsT3GE^|)sNzde;#~219u~Pc;I6x4k6xkr{&v0uS2iT4e8`#SiW z!}{V2cDR#D)otOky0^i>Lb4E8^u`A~^TEf3Pa>s8ZZ+Jg_I6TVdbi_awdQ>BPLfi6 zuG9Oq{LewsJYS&`=4jqI(e6uq(*~mix%zEmn$m54_V#s^FRUHWa6F|$$GB5pHe383 z(7pxupkMgQ_HFR4stT1le~L6FlG0W*PPe1{5bgC{{RHm)uWEj;~)GJ zPrzC{fp)#;hSEb5dzA>X4u9Uq9GZBXmZdLxmFFJmNAl*lsOFKAwMg>6pZOiCYTEIL z#}<`iDD`VV#C<>d^;Y8RRh0*w;q5tq<0imo>FHhXg8l{n0Kp;tFNB-GU$bt7aVa~D z8gGrYTS?zFqPB1My{}g*&{Didy3Srs$LS*N0Wmp({%1 z{{V;l+C3Q7brsgXGr?|5@xI^qMYPAsD4}bHT zrF(1Pd!jdZB~y+X8^##_02=jJ{{Y~fAG0;2%WW_1A^S%{j5)Z6##RzWqAQji~j&4 z=f4#EG4KzIZT`#RKL)MbeEhSxBz+DtKML~i9sa|g2{qd{e+F6VS{=#c6Q~*D&-<=2 zKLhwz*pvSN!8m+91c&Tjx97$6i$5pY{5#?K%8zokz@N&iKl~HA)d=$c0N|rOJ0qw1 zU&C!N&VBYqp#D|gh0bcw{uO4vQv8x;b#Tm{ zX&Ql$u=k0EdJcdZ#?wD*FBEudT#nP?f5ODOwtz;jrWo4XmQoJlBnK^l++Y)&cCXWU zKj5Di%Ln{Rf8e0Hv6XX%zW7mUz@Ef}E1$rQ^~QWa{{Vt@_^-t_gHG|U?P=jXRvckp zQ1~kCjE?TN$7$em#w*r`5YxmiTvAf=N@@Q9=_fMFBAw|rpKGtxqvsz1{@LHNACBHT zeNN+2&~IM=!K#H3gXkqy+J78Zr&&LMFXD?*({AqWZRT97+C+|oXRhts{{Z#+R&3w! zL6PDKP3D#RWB6_abGSzzfG)NGdkkH%ALokG@Ynnhr{iaWE*DVvefxQMQ%`;2vmb}G z2vxt{QtZ9YP-~XF@>y$35og)Pf1fE(`rI9-3;fslngc}meRBwTCDcLbhPPkn)n4nt zegK_Fo@=eG#(v5({{W#^apCXS1NQas$QoMwb@&D1NEab4wT)L()8{=ph;1EzI?%cO ziT?oLpxS&7a=J(C{j0_@OnOhn4M8PrbjO{i1R3-v@vk@A(o*+or}Jy`Na}>sTOJ** z`~>)Ct}q{HnNgPx9?UjRsKbnU_vW~d6aL2^4=;}E9ZqH^oOuC%t#^MAd|~@Ud?nTA z(LN#m%l45;1MT}omy7qn$NiZ;%2bX!6I_hHwcm+!=%k+e_IhZdQI;dcu@loIhn+d75gjA;yG*pH*i~c_fCdL)bwqa1~Nu_jEvW5;&0h2 z_S~A;=ez#^f^7JvY@R#8K0Lc8r z)qWf;i|rSS$9GacTFANZl+c5^>LNebYWw@eU$OrH?Lm5lH9z;v(3&pd@~D%tVRLFG=_uTu}i7+RW6Nk8#N z{LXrq3X9>_j@_PmuHS`{@`wjlow(LZ|vG2tw@^S>e z44tv3}v+*_-$P5R8H3sDKo+CfuUX(Ko9QLUn{0V=Vi^Ae! zwS)Va=N}S&0C*$7cUKDE6KxENSiz@#molL0sM}oaB zSM5jpJ9zKKo;9@Ad;#F?M^&0@Gaco&p9c4hk-kSGsmOeAIN9%B0pec=c!$Bd^!^y} zcZIL??MBsrxUkf0o*81u1Z7+Uf(Rhv1Q13+74vzW3DU$$&~cAV?EY-Zf(9}{spgSZE+&~ffL=xE$-t=Ovqc}m zeR7;rE$6y2VS1jbR;@*IECBh3Bd^`Y2jxobf<-wk8yim4^xA`pfo(Mem=t}{fs>A> zj`gwqwu_XG%XWLPz(0*eaj7J~F2Nqt{5^h^OHz_#nrvxdvg7SBPTVjIg9F=+^{sOE zcdBNNA1`pucN}~1*15(qPQfFQ*yDm*AN_j2YjJ&JY_a{UpaTP9p1|?sO5!6R;;}3fbq=1o~CYK0QYIZ!+fUQyKY~dD%Gi85P}pI{0}$ zrF62z43n(x1W7a`*$Y%pR)&tZLMsqXVfLVy?9t!J>8-rMTKmP4dmyJdhO2wyMKe9 z47@!Rs_AK`6uY~%EfW2lEyNB~F<``P7z7n%Bp>JL{vFl)E#a*~7`59QolPudL3eos z$RrV}k+`wL5}>huKx`af*XH@p7UCS7DCmy*6k}_&bN>JeG;7ZY-pMWJ!_N!qCGRG; zx8DS|_bcRu4{)vt+@pFf(u3~;xXpb9;a?Nz>uqnY=~@<>4x2n7*$gtGeXc2Ro11Yg z4g`t@cNHA)0rPJXYMMR7mbS-Qwz!O9SW?dM6m1azppla*zT$ptzyuS>#{^`G{Qm$Oi=H;8G}foBPZX&uBz9WQ#|gE| zchj!oP4itid5!F{roehMl9k}FDpW3VFb*+TT6c|gU3D&X*mQ-ow1BEWj#*5D0Fx33 zz*IOObHGqR`LS3!F0-et(YDkfoBbzYwX=pnAFq+n)c**OK-heL@MI}*-I0=q2P`I z$;D$sZK&zm3|6+fqp2+0pqQ>X#&^dN`-Jh17y-|%MR6~Rb^A}YMGl+xDWh{|J-yGD zJnq6aR3jjuecUNikO3Jv0zJHD`VsZnt&XPJ=f}Ej<;A`4#3?k`udZa6gjpgnmpNjA zNWd+V!ERjO)^~{F@t4>oOFeEswX|TZ#FH}-gZxhXmB1r7&*DW>(KUOG@y+5L6vZX+ zNNsLoxlUx-8-5V{kv7w{p9FE0Qgd1ocz02_*6(81BDqNtIM&+PqcVN2F$EyJy((7H+&F}XSU!1;j$0gPdf1l!W0(5$7L+Gw6y#XNBt z0dQM-ftFlyNjTk;fI8!({xGz))$9$OoYL4>y_!c1R}K4>E+2V+l$HnBgN*+GcpBiX zkF=6#=ap7*`qr`H8<`B&8nWKH#UyZ9-$&)_Wk7;#;SLV=VV&98jxZ{#+v?4$O9q7m zWp}$Mi<};Z7g0Hu3BZ3X{#7= zNDU(NC~#97Pp@27j}c97j(N?Q_FC1}po37kh{F;286A|NfA{uT1@Ru3s_o#)PmP#z_Q40=9QV4nQ4F?x5$ttzj%(H1t+^fYi7IKa4$COWela7L^-1s9zhg7zb#cd$Fj`Poo+VTPW zl8!?ZVYr`{%-Y-!-emU9QpHe`>?J7}>m+)E&wp^McjfGN`FISfNZbj^=NqyIV~W%M z+O!sM+gjT?CDftA#LJe$ZT=u~yHu0FBLEEZSMPKSyQ`+SfnbD7D;ZuTjDj<|C&mc* zm53p^$^yI`)j0G`2x={-%_L;WB>qx?jprG1pb!Sua1R|HAH*x4+R}YNO`y5DvX@Gn zM>9%eMtp8(R6rS+kPifHCq0j^Lzm-yZu3sD`*r2*#1JGgg3_}A8t)CTfzW_oX#Vy+ z4QT708MM+Onp=4%7SPOOMYfS+XhOzD6rM(RbJP$IE71JW`%`>xpH#m80EJ`l!%@7N z>UG^K-Lmhsw;&QrN7o-ZlgB_t?xWJna8k!sQHI@ok%d~ksO3H_d_>kiXkUp-@Z(O@ z?vq2an-@|%zbs_nGC2T!+yS_Zkfo1W`m5mfjo@E}J{HpS-9Ja4?FnwN-z1Liid5u+ z`+2}(0m#nP1avjde#&0}bkBz#54FFF!aKXUrCF|Lj|b1e&)xu><9d1=n)S#mG-NO` ztm`rZ0P`V`dB1hoF(3^5fRV`Hj`*$fe9DDLtR^2yars^MW)O_!t1CxiXQ^qh>e5>! zz~F`;0=YxN?c*Hu_VpR7b`NP|Y_M70vzVj_G%|eT3=@x=>&L%($k#NjJ3(l*g~VBa z6D(5oTa7o zHA$vw-2VV*Twkrty@j^#ouu-j0N{CHSaJqHEs%4ZA8hMqNxg+%SB?~zB7$(CiR6wk zzzw*JV;Qb?*qeL9YThMFfh=nvj@?FL!md!ZNXr&KLF65&;TXAW4n%V$Fat;wZ4koqcIk6+ZH=yEUWU4Lo;U>-Oy)`YPo3# zh@-cTc(u|XfGK-96$au7JC(3lb~x>vj;4stU6D=cp)cC?IPSj9d!tP@AZVFnnL`K3 zE09MjcmU(016Aj`zFDP)=Ruhi+-`zHa6sOxv;nZ?a-cC&ftDl#&JA~4w{1?|?R1Og zxJW>b<|&Z`gNz2ljr(}&ncC}ua7ARv;|OlGP1>*8qE?u(UC!w86(<>N<(RJr*C1C# zoR!oFQ=Q9WTh?#&HIV57QV!VBrUW<4a56aPNXYIhrO~WBK`con(@Pvc<&~!_7oMPJ z9<_%Kui&m|}C2$5KJ+DqDXTLwON4wtBQt#0W&12?kFGF=E(~E`ijMmP6MMaFCGp+#yHy_|Vs`=FPk0nrk>6l1{9NPvneD3#hh(Z@5i-rE3fMp?oiqw0rtq(7sqn1 z&B2UxY=PB=KsBcZvuzEky^XG}%=rvj!XtGhtz#;nlAs;H?eyoTBb?&8e}kSJ)>q-KpJ!?>aw}LGr`)Z-L zh$E|AGN5qVcvb!)IP1=PRbLVHbr`m_HRisimG{8^0D(G%;cJhEI%UnsjhX(|BWUB5 zm5`7l`^RIr496gzoofj`5%_l6;WY06TiMt~j!aQl>Z*(j62u@a>)19=9Wk1%H;n9c z12Uq>q$9A5#^qUn;dkxXlhc!)pIXa@U-*WxhtW0tF5k+LWt3dU<}unnRbD$1N$b-B zyYMx!bmp&7{M$9B$tQVV=MjaS< zQ^XofF7mSi_NAT_EI}DU8!S##eJTvin(&FypTljn8`+ZXV z=YBH7MB-XC$Rj1=_r>8kl_E&`V z?t5>IFSRLjNv>hkt&u0wB#03dx!iK$r^hP23mPzXO*c)?A-0! z_CcPb`^LU1@phee;xB@_hlqSPD@$Q};rVYgMJn)SBWo*1Dl6?R&>g^YmBFvA{{Y~t zSNEwmfHeI(R*K$9E%iq7}PO1DuIKY#B~53wfd$5MI2h+Oe*XZ( zlE(tcdw9EDaMHOoEg}K) z5Sx?{>OjD*Tl*`;Hdg{)4eGa0?vr!E>*vBppjSU2{{VET9)`ZN4O^LNc{QoD?2f|o zL$hE=c0zr@2C}a-TX&6uM#O>CV~TS4x+`!~T$tM&0%U*nXX<-?HGX*I^1jg(vlVVu zMa~F5_2|ZG+B21=k;va@$p_E8VY&^q&FgS7-^CxE#aSQaZpR|M2JcO4fF@KU(BqHg zSRNqJ(XL>2LGrTzag5}D^{b{6BIx6;p+sQ8Kj0#%&Wpc@Mm@!J+K!7Qu>}*YV&0_S z;o}3JTHS6m?o}`&Mll~fIW+;Xh_T=g#;o~_pm}GJ)Kg1uz;)xX^sCgO6|_JIk~8() z(xPh^h~ToE@N?R(4W)?ObK0xSjpmKn2d?00tK65NMWHdV-mQ>%=AYz}qDZCW4*lwT zn{y!!hdqef)}UuF4tVXKTC3<6WT+hQUlelyf9w!N(9Z%{-2HOxgMJ2D73Kb1l*j*~K?Gb|D}$W(p9@9kMmlxDR>Mr|Iu zp?prdhi}^Mqz63V`tj4XcN$N`_@{+e?GiA?I_LV=&(Z65afL^fO5>>lv@HBp_Hmde z#ycAGYhWQWuAU-LN78z4#Ij@Z#-S>6)wu??G+!AQ&iiYeWcVK zJD;+fg04S=z5{!T?tC%vg`puXu3bUu3ETnxmBBo^r8jsR{bDj!XG!rp_7(U`;^?K+ zJ{syzpxwDG_Gu(C+cD(eXXZ~%q% zU~u)F){n^elfu8W-^7m#TmJxJ_?TMwlS*P%<4@M(GVfE=D}%XDUUGTr4O+d^{{Us5 zi;&564Dx(F)eZrQ_UFyAb|?4<0IpALC>(X>zO?br?D_jX{An#dso~hHZ{2_6{{T(Q zGG`rF0kyh!AB}hq#gF(WUyr;uZ8od$=I##>*aaloL^j-o$4@MbKj41~^r&MpyiBhd zIy3w~$mX34WhG|0u( zzKOrmY}pz-bC7m0!8sjB>Bein(tl}R1NhDX;r{^IL*U+vsIxBD@fMM%C8ne^j#<=z z!EjE&urXuPz2flri9`LOjB7)>(qDJ^GN?|A{v6yT+3o#$pF;dN{{VuI{4?=Cm1X1Y z9`{7Laf2`dYkd7zl^;=F-Qm9-ctgh)YpD2FUbDZ2*CI<#upOAqZ$`zQFR=hF4x5O`ZuG4FsR zjIlo6r@V4w9QF6-74wyHY_}Aj)Thfo<(1dxujYDD#p5We)?Crh!Q{S|uU;*b(1J{!Y^mpYQb_H9WCIvOwO1@F z=5q`tW0zgmr1^WTSKyA?7|Iovj?c{OB^r`H`Wi^+08+A{#(j4I`czV0UL)%ntjcz-Yd{9?v+2$9^MF8#EpzQq*~&vpj$M5h1v1t7zo5 znTIl3l7#(n*YT^i8t;s>wIJOk)xPDdB zUwGHR`gQDfC&79o#$X%H`(4CQv1TD72XhSM5!WR4u5035r@~(tn{5RC&01cyH1{yZ z`hnM82;kiKGNhY#orC7%9k6n0)?tCD^}7DQuB50|wbHp}y)M76k-~W6{t2t$OZg4Q zgS>BbV#@oXhf;}W2zzaG*vrR$NUna*;GgZ!@GZRm0EWL2FE8!W?!jfQyrUoW%75va z_JRKZ1wQ?g-%*o5_?__U#(oyo;2uo+eygS|Fhw`~^J|=l3C{(Uh~dAxiuwym)BYRy zjvF0QMzo&d#_HZHhqXwed_Bz3+*(TCM#~}m1}nMnU;GsF!`hoeXRB&D zzlK{Qd&>8B7UL(@8NnSn`8(Iwej)IOz&pJu8(7dhP4;_>h~bD{X^A9m&e#B)g&$Ht z9<}8E02%)PV}ICc4I1Ob9xnKM;vF_PrB!>)2TEpT4aktB4oP2Aw1MA@)WyltcDb~CI%c%Q@fA7+;<0{JU- zAMX(E1TtkvU~_^q)rZ4m`K)h&#KpVYmR{_y+TZXFRg0Y$YS6!$)bab@+V0Z%TI<0d z4E%AZO>&-JFRz6d;HjDA(mO>^UIX&x)RW^XB*B@v2_pzu3$ zU!XkN6*PLUG>-x~O*m_7KU1;z6Bw-xS^>2~^Uqu%OQWfXGEI+A~#akl;eywyBGb*tJq zx3QjPc$!22fN*hwdJ=P$1^Yb;Cw1p9$n z_TCWGEP|QdMkA_)3O_pZ0pY3Qh`_gt_dZe>6Z&+l``rXuM#b;PnYWgda!;-Z!Rl+v zm6{(dj#}y;AZ(e{alrtLijoU}v8q6&vC(|d&mZTSk66>76B7FA-T>Q($sgfZ#?Ck= z$-nbS?g#U%`2izp_f@$FA>PUg{lSBi_5T3t)hRD-*aNpX{`Nl#WK(I84871Lh7RHU zg<3vC_e`)Hu>-%oE>e;bGjlXyODlufO;2m5T%+Y+3WupUcjS*(cN}g6F3c1K3PC9@3@mo4~ha|q4ZSJKJ5^x4G zKTbz()mu!lwz*L(SEe;5JNIK8<2C3W3eZGTt(s~(WR@b!FP2Ck^xANH|pH1t#a?f{{V(D+3GQBGCMLxGJM1hu#yILk;&`Ldj^5vYn>)v?b|&d`O(L;TBpkF z3t*9z&m8f<13hzG?}IEgtuzf=S+T{m5|Jq0$b|qo+}!Os&|&n&@;d3u||m(`s7Avh3F^(%drnjl+^MxE~G~WN8luUmUirnzl_muFfs|u*_HH>mfI1Ubq@D>D zYfrb@D7c7z>N}u^ki?ZE1QDEZ`Hl^6wq7{9x3_sUEg3HEY$a5hJ4hF-0qI=@maTC5-Nn@UNLY|8GBYZJxqy>t&rGfxlYxwJit=k=s$XMuD7~4`SZf+G z-$!d~UlI?r2a9xZ?kaJyzu5z!=v&sV>8(26d6Hk;tE?dy5CiQDH*gdjZVGZRSRQgZ z+F*{n{JMj2d>m=s{gYLLfp9PRZP#co{qn?SHL#}AA&gdSI$ za|251$rjVK{IT3ZEDc0^7T=MYG+I z(X@q&D}dPw-!}w+eqT;&snlfDw2d)l)vckmjut~C^57LEfKh^YT#=lP#Pg~h;|X-}E9Hb{J;oVF7#%;1F~Q>)!LC-;IIj}!%S-a* ziX~{JzVjsVoxWilfe8nNd*T*{Y*%D&uJZwy4QFK|6^A=M<4@z971Rbha`{ zXBx=yTumAY5=LOWFk!$v_dbHRZSH&p1#}jyhxxz-N!bx(^Cz z7FxBWdcK=xR67{rn%FY90PVqS40E0jJoYAeSX5;(Pxv(bDW5R$N(I2px~Sgobo%2)Gy&pOpANHO6oY_B+3z@A+i?(rbz^a z&JW64BdMy;_=myzVmvo9-I)^V1%}}wO_?apOD_Gu0)r>ffX7;sQ1LB{^1~h7+=vC15#w%;`{B0@%?ip4mBx8|) z0OKWEHq{}w)3r7%W6Ke>#Ecw}axsh?bA}udfGM`KctYZ9i;I0$-_DVP7DwH+vJc(h z@xab8&wACXo z-dg!;gr&Lj7&73Ury0f+lZ8LZw_(zBO$ps5zcJb|#wCD}w|bIE9D{+3;Nw2kzpQva z#hN*{nCUVlp3W|qW6b$;$i`Qm0X=uwAaSz{CDE3h}TN9xGe+CgOZ~jXYT=Aa7Z4U91d&rKf_v2hV)Mf+G)=!ykY>+ zOJ@L#!Vc`V3D3$w2R!l5HTAiMBA*Xn)(VTgNqlegIAaG|T*oC9)~}^`Z#9qEE+v*k z7Z%RL1m|pwt)G+@=N+ZN&lqj>_P=Qi%W-^?MI>t?4=E4Mpbg4FRzm*(#6IuM^5E{w zo+Q+4p|@ft`QZl*B#DF|V6VxOpS$L1# ze4MIETN|%;Lu&Be>klZh8`FGDyd!4XebiS` z>gd+4u`0Z>5R($8Y@7Md%1#I*e8A_f71~;vPDTe7VS6u^YHK#~nSY)tlk#;PPK!ZW3|hA6q;kVl^pW3 zBQIH5urQzuxg?w`5>F?tc{!U})UTkG4b1HhnQpI|+UDx#%aS}qBb8%a#mD@#kN~V3Xux6Hu4{iyvzBPo7_Ja~o!e!> z`$1d<+Qa4~9!nliPT8+RnMO7_`P*b(9JRKzx?5}O1U8$qzH$s@aX)T~S}Gl7Q4C3^I%=yeYgXtBu++z?zg@+XoTa9t4KpO|2#3XTrq zasl9yG<;OonxZbVJ@gPe9nso+%Oha?sz@bBIU^Z3E6zLC9tiLTp)_||jlg@{VWJnZ zBrI|dC^n-I${#o+9P^GVNmQhg=KlaP8e+GOE-vQ~sry~jiXI4|Bg%p^<^a+wfaH>d zADG~fcposIQ1QOCXQiDtUD9k}mB10sE{Isb!5~7MhEkvmIs2!9oK!Yn4vw7jNfxnm z`->GzyGUm8OAWsygPe82$@|BgU{$+q0$46)(}syUTwKnq@xc*D*q7e2l}ty~w-Lt~ zW5z3WEIV3iPpQQGPCg{kyeoa;C_W@!wUx9bY+(B-Qxa}t**AtelO&t~y!9rt{uX%4 zP_pnOAKKUVa@@@jD|z;LBo^q$3KPm^f#@-X+#n z#jo{Lym?i2+NiSzFnP!%0k;7C;xJAZIU=>}{1>UsV+vhs;5@sGaM`$$Hc(G1y;X_e zXQwrr<6Rp607I~j+2f8=CBnxJ%X1`>ZX_-gNW>hD{d$3)lzCL@;ayeA&d5q=;;nT} zYGFR1tx2p4r8u{a!ENJJBoL-YEW1>Y*}>d01}ihgJ|oclP4M?u@II$)KK(;ZxV3Am zk0wJCGOSA`<#uTZE#?jzIb!5x#dJ^LomW{~S#iXe^gr9J0OAd_!O&#F9k=Gpu4l#d0m>gfS|5ft1K6?r-=i z&Hc%52Pn_>#*c>BYX!5dMt)K}xf>M-aZwAYFL9P9d?uci23 z#~K{(Zn`TpG7FJzO3V}?E=-GdKnhs9Dvz5O{YC!(g4XzhPSE^G;453Gb$5HO4(dV! z96{`vh0TI2bD?p)nWaJ(1dxx7ys-Um4?-UR3PJV0*?5YPdQ`N%FRi{z?W2f=N_$$z z&K@nd(RAAdhRpFTvdUz`?^SLG1TG0;M$kF=tBR5vI~_rc6D(uyq%9FcFLGNf**xPs zbRLxbGve6Q4dfc;lx&Q%I#?`sYSXp4fPC2ks_cBQ7*OD2JIQPayldhg3~Ck^8r|-< zX#`eCrJ%Qvv5nXk0H6fB;P4l75T}kS<|tIe;cKZ=lTCFqoTEL4_@l;tIlQ)Ii^X>i zsuvMmTg1wkI17eS0O0iW1B&Brb?+R!&Tl+TZ3-^XB26*@z$A4M^!BR%0Pvb>15sH? z^CDy=43_dh7#3_OEWC^bIUF3=e2L_SDH*Df2Dm?F%CMWbIyg; ztZ19tOQ<*7M4qE>7&XrLq7gmjnLEzvMdKh0#j}{5yPx)R_*0>iRI^id(!#2vlzy@R z2_R#*D~HeEc&03IT|ghp+C6i~ro}55z}uXTr@b~3%W%=R z8;0Ny>x!Tty3>&xcbZ2WfGQa6_8sEmr{PzoD(F&DKDAt`M%zlBPg($;(C`_qGsiuD zDzal&17HQY$t_u?B}dA$VEgo`A-fPb5+*@jeW_S>(7zSDk+Ck|f;hn()RU}pT9{`{ zso;*aR874+*v>{eP?vddjDBO-QV_P1UBe);x(-ke+{)^3!|UoQ(YFk{!W3{zgR%J8kP+@}l2Csk6}Z&l=pS{{6!cepUye^{$^m_=zN|yw_u=c;4DrK^uePoXel- zUS)i}H@1gmJXN=6(i#WG2~u?fP?M9x2OL+Y_%GvxWTX$NJFvjZ91&j{*?6wSBgO5+ zgoBXkqZPBGd_dE!+$370j6b?SH-ZyRPZq3cfID=S=bbgJY?y zt`=F8d6E08kC{*7UL)~${t1nt_@drzPvKXJ5IzZp$5bOK4>(CjAA=9ZxDO2cVEZM? z%AO^70-jjH&5vvhn)QDH{?V}^OKblC6G0-8lb9vQ=dTKTS3NmqS#$l{cI{_xxVbzo zAzoJfPm4Y;e$L+(z6xpr)5hKqy|q~7-39W*-dd1y9bHZof&m9TMnU5>yWlU|JK`UP z?8k(DCnO#^(2Tf}!^COk&l2Pl<=h{b9ys149@Y9U;a?s26XHFKX!?hUw0rw`BmM22 z@-bHJf{!1$=N06C8o%I{9|V3Tth)aI!o7Oa!&;=7WwjcMHH@u}%6W^QPCcu6=9zvn z(8p7=?!T*`r-rWw%|c(-`J&8cZDW`N@-k_JZ}qPgFPe;Gb5d?T_tUxK`8ax~eLgQVV(b7-KR zN<}6@1K(x=$vt_l%2X<p_qOy>4j&sNu&JBGH`yT%Q!BniR{v~SKkL@p}S?Si- z_CX`L(e(CPPc$)X%MfOG&m;GU+~n>ZG3Hvgioa%Wk58vs{8sQZehJmu=q>MwG#@%h zT}t7kc)81DDZ%wPAP#w7ieIrmjl4IdPvbv>+SQ+pv@T$KRpp548f37~1gg<4 z^k&?CRwb}h;He&>zXr5V68NjZw^vW0-_LC%;HCYu?Rcdf3d;lhj6dE|c?w| zS8s{G3pCv$z`qzgGi9&%Q%{Ur2`nu{S5{H+gBpS(d;!XlxQ>huHSqbD1LN@UbHhng zOQz1>eysJVXK?3Hs;%aJlKecs__gA{AKhCngt|9|tZ@asv*A@Ve%awEAoCuw+r1zCq~#P!b=+G;vphi7#i%odk-5=s^|k}HDI zjlVDe@)^s~nmj2H~OGUJ|^Ci@7Jf)14`HQGQ zkUsYfgPwrrH4M7{0K?5kQfqBLTEEqA>^8jinj~UJ0I3U|>dWc|2^k>m+U+e@-1IQ7gP}QIYv#BA05jlU*{AmN{h&W)tIb>C z$L)LYzv4%Zti1HK)Ah?Bj|>hF{^QP_qKZszQ@I(LN*swUCT&~7=GEl5zS57FCEXZ4TFkHII?EYJRZbglB~R6tzX~*k@Lb+5xbZc;sJl^r zcLCI9e9G&)CM05ki4_S_ z17X|&+k>3fHfvK4m^W6PH3@a)Z7;gbeaOa^8B?axn`@=@Yv$U2iREALOJ9Qt@bgFU zAHg4uJ}SBKZkge|Zsj!S?rtMZKT3vKVY*m;&ZNsd#I8K~4588!wNQt7fcl5_kkC9m zg1=l0n!oc;^&P{1iLFI;OFp_+!ELR^lB}c&60v zwQW+;71MGy?J}2OGBSj*9I*?QAy18m%X7z!c*#NAd#$wH^ta1XiwA?l;3{)-E8hJ( z-@DVx^gkMZ;bDtuNSZrgz`++GfzPG~H0eGh+q^lLFa!`D0(d#=$*(k9ZA2+)8CQ28 z6$kMBDbcOwLz}4=ZyQmtNBQ>kujpkqx}Ps9mpYwm#!#~P(cCjR{{WV<$++j}c&v#& zBI+o+VZW5@z{0O@PfE!C%xPsT_att~A@axa6v3lNB`Q&yo-#4Irc=5(>9tPsSGMNUgO@+7q>;yQ^eDT}XwY19(4$WRe3Ao-*2#2O~oCEdfd)COh+w;k9Dk6Yb zs**_RPtCzT-RsYC;;I@I`xVpJ-AOYqtn!aR%BOnqEKD>4BUB`sAJsV32 zs;n@hh1nA^4gg_*7`Gh;cJ=(LlG3%wufjZT516@x$!UY!Wc=Omc^LW%(~?_zm1`Yi zONJ|PD(#)^g{zT*0ptkA%^xa?H%LWu^C|+ zwhuT18%ZN1;}x-{#cQIs%D?E)+r8V`yb%=h4&qoUCi5e(=np#v6mn~m(=N3ACrp-Y z0TBbBiYVYBACZVs;E=$Q4<{h;*C!(7uZZ6N07`>Th}h~6quA3XdC9T@+kfU)3R8~BInF^zj#Ieo=IO4p# zj`8%}Zt}%76?jQh2*-0shj0Lmr)hi~lfm@HZ-+Fi35$PgWGJ>Vsgc@9l{feLKixc% zMlgDggTr&jquj@?+Fpq65;Re6@i|a&l|OSEzEgroY!U#)aJWVt1mw*x1b=VKV3zvD zq&Dv@)bA9g6#=4T-5g{RNO1WDK|nYh5nUC=yWss-Rfogg54@VnLS?rf+K5>`(s(M) zaH=^31yVT2T-P&gCb^|vN37f1U+!0q-&3-^wMBH3Jju$Vy92atz|IdKf-3KYU&YXs z@n(^!TF(r2ZyYw7qP?)TjUzj}&)x5yZR|!%;ILdV#~x-TEw?M!xYm0eq*nUYm8dit zmZzj%8Gq3%A(cdHI8|u_BD$s~DY%ok0kq%{pqMPYS*u)Xu-@KT>Nb*F%J$a~-CW0I zD*VPbk;yn9umu3d<#AB>J4^8e?}qI(=rma-xYM>R?9tqCCFVvhttR33@}pp1yOJ4~ zcPZlUiv9!mEf%SN@q5R5P28HOF@M4*Xc|pU&JwIuUJNR$F>)BlR~u9@2DmBEt6qGN zk2IdiE3(~L$EoUeGGAY4QrcVT&v$SwC5bhSO;DdO5)s}pkt2ds?F^~tMnDPTe~i~& z1iNnk?(W0I6~TxS%!&=ekb(I{U`&VS%B_5n@eBS6CF6^Y4fJ1z zJ{hvGCTQLrYgD%v7tn-NR9M4hBfvmTT2Rf;YWe%cek$>Q#63{!zB$+Lbz9~HE!LrS zWsm|(9Bw#3PdHo*_OGDJ_!Aq9eE6$Vk8S1tOZw1pr4~TQ6KrKpUptIyynX8UhSu4Fx0qazJC!;5QkyXAuv;Dn%k%a8x>wRm!`zY6 z<@cAJ{{Y|-^_t1v=jmUDe{65rZ&i*N6XFf6r1ona#PFnO1Md>eyqkPazvQ z>(F>(88v`+Z!Wb0@&n^;=J0P8Q`^a>&beg{{YC*Vy5>$V=TO7;H!;0eA+Ff znyk>rEHYb^mEcv{425@PKrH)q<0NoTB<44a{2~7U2@=n!U0hnjq+F}0wbrD!fGms_ zKQ<+mcVup2uDI^FAd38wv(>y)qAW*F*R=~)go6XYc_J8y#sU>1ZZJAxx-B>MgZS&D z-oBw>@k>?{$tL+Eo>4h>;BH|kVCMh;PDlzdj0||yyfVecPub!VUTLrMDdOb1AFn!R ziM%(eUr&E8iR6P(o>Q~^KMf%z0Qp__mIZ=@&&!d($Q6v&-U!g_opo3wy1AP9+B<6t zha?tK03hcHkl0{P`mv0jEAr<{{jq;)4I0 zirVnE?ce)Rcz*G<1F2|Qh>{hFpw=|`C5#{}NeHs9&GRzu>Q{r30}mp%hPm87hd8y_ zHorhvo@c5*M>OvjX^>sb;rF>P+&%0O+iF^?C;-UuD?`I%vi$BtH$5;iD^hDcZtmk! z(e3nYPh-6I5!)%<9l|uGLFB#;Q|9@4ZAVOwYvF$hf5B5cWuS&lTi}O>8fm~6XG^@f zwvOZ?1dDWR(lKOQfaX(>Kr4mAcU}ws0D`t?x&VPSzk{=gVsvGS(^X7F*dkD?A{N@j zk^v=?c^is=E6T)hR}j%xSbO~9{{T|eNOg8T!O^rE`+Z3-36|z*t{E8?iQ?I-br;g`b| zwv*y=UTM}g%w@UNd_Cq$myqo;diW`)>S2)O0z#R`*^X zv2tgY-UWjIaG;EZ3_-!?Ztc8sE1&(Tem>p!_r&MGJ{r`f6I|UG?jVIqJV=19&ylv0 zPnm)T%%lUhB!Nk>A7;C0ywXu z!%)NId2_{A<&9~4I(|DGbukrd&ev@orQlxzcqieGnIFTujUM*KcxE=uJhvqT@dPqE zCp@7>bcxGuJot`_GZ?439*)psS#>gZoJBLw@af*Y*`ag>j z($VF)w!N}2i;#_P<;v`+ugC8R5)fDrNcof=GILG!DYZLss$W}~UA|{%P^5DZaArCC zjQw!OBRI+1xcrq|V#dkNQoDY4E*dKds!MTvvYkp4w0n)MEHajupOH=p&T>MITe9bG z8Lcf3!J6))1+DDf9K4DKJ5}U|3hGAXb#b4RmcTs;PfoeFS`F5ql4=(7xc$RDyGj(R z7C=@^;~`ZJ0SE4u$UGX8Mb|uAr?h%khM{RJWsF47+Q5=WDi!&5IDG9?1B_sYJvN;3 z)p3%vEpgp5U34vC)^hg&qlVhvJA}Am4i_u)9C9(9!`ITcEOf1FQ_$86S%tWoAdtLh zo1++BF(MUgsA1Ei9(z|isQgg)m#3w*mZ_mx+FV>)eXTAY#kNTh+QcRp?Kpl{d1O6T zyb-F ztYKwnA=t7;2Y9^Tw4DiBL34x@Hea)4lhNmHMGd9HKCe-*Xu zM&8d@MRRg*mi`^8pw?q@db1o6m*IV6znP%z(k z466gXr%VdM@eR(Oad`L4bt(L_9jfgqh$p<|LIL9^T{wurq)drZF%UbA? z!+9G0pxH+v%@*V(m~N1dlm+2QJF&*x;}XN-XN&Z0LI%Fo^;m6LrZ@1)%p+ia>jDNg zt8NEzIO7~+9*rEisNGFB>;C`%=bWP5u6q@wv@__7t?C+H)!DTL)M0jD3^&SpbJX*d zKZ}vSvqV>MPLB-GG93mPdOzlElaq|KyE8z(e8X>YkaWT-srHKn3R;2B8}OwGQn9vahx7M#MeHTdQPdT z%B`lPe`sZIG{qcixOM;)Dh>eP5Oc{j#z*m&;dEYAoc<$QJH$XrLcya|NBOWrvj6~L zp2Qw7D#owltz%GVZ1sm`iZY2E(Ip%y!TAUA4aXe^1bY%J1z2m!(BmZ~q1E{f;!CLX z=_43mMoJ3&xDQGvl>-nNH^G;a<{hW_~^`$H87W(>vGx6DBp^u>Aq0E6}a z02Aq2^K8=Y<%&1UODy3wFn*YRcLm0H2a(it*zs4yJ6$$8wOwaJh7?l9Z?_dBcO;$Q z4m**K4@$~-d_$F%tH`wlYm#byJvMh^PSEXQl16?(VUgDbLEz^MJunZwbRQ37)~%jM zwOu(HBtm0ph~DP}fJr>AGr{8o4ucisdPl|I4qa*H&Mh7_vW`;GEuHe*=jcmdouNqQ z*yM71Z42VRhPAH^!xooob7Lx&Hy1aI>z+s?=lFVa(;k2kTGheVrj?@7C2|e@rZi)# z{4Uh5(iH+ov^3ufJ=OirrE-QhC?%cWlE1)&;k|N3a4-i!URC=)d{@8JJTWeZbANkh z1-;8LyOPCbjy(Rs4sg=q%x=k}aYH_H0)M4XTwAmuPfS?3R zX#*r+o(WLQ#O)aQnBeDvPDNq(q+P6nNVWY=@&s^alH%YgV561{P8C7tgOS1dThjb_ z;VWA<5_rq)8$zsU6}g3SR1M4katX=#Ks=65r#IqFR7(K3hg+Io-T@uGybO^^oB{Wn zW0eD|eAvzbCk@AjqSW<|;r{>t(oeAlr{h_*VA^_XGe;C4F^wI`jZ}Gze8y3cv6qA_ z0SnIr3^}zu4C;_vX^ABIlENm9otT^{86<IA`N z3|MAExv&5{9x~ZIIJMymdz}Vs-dYVl*`kH!vb3@VCuIUarbHb{-H?C0Kw!Yv(cz=) z73@Nt-H$5$uRJot#9t1+F6fst#jNPx5HxEIo?%sy4dimix28hN7tNA#CL<~bKcHXm zT#Ylr(EL#NYvPX)_^Q)RYYz_U;?XZIXN6oe_DaEB6{8Qmp##jo#z-ZU3iQdCC?%vTXYZxJs;R z)KQdWWUud8^0jOEx8JGg(xROvms9hu_TR#m8fxoj?8f}4+=axGv}EB+>^@-_$r&Rg z<15fy)-`Vj>Yfx^n;#5aMAsI^OL*dnBGQx%xdD~J?&M{UAOX)gK9Q_^ID6e@S?_IZ z;E=lgt5rme7R>@z^P8Au)C*mK67qQ(%d1I@zmr$@5hHV@Xjl&44 zip>Za#ysf>&QIOkd@5MjR9EKwOp=^avOM7|^y}?$ZnZhCt?y@55!y>UjvxwwhSvL~ zakzY^X*q5>*Q$6kPqUlCQ%R}F-)FHKjl;e+qjF0&a0W@|J?qYN&xN{Z)YnwhCiB`4 z-pVenW zhVl2u@+RHW^dgL3Hm4D)>0@bYD+t*^%1BSsJ^AC%4%N?IX>!Q^WYG-n`9M4XM{(Qy z@@v@je+%d{FP`@otAVvtOuJts5C#d*)N`bdEn?lW!2`4rB#Tt%LMw5-U zIB}pOMV7aWb!_rK8ss(ECDV0nKSsW{2_4R*9Jb6QEWi|XanDbfj-TGIN7W~@j!(1O zT(oP>K~72ie?BXd@gIlu*4FfmRf$t?eh`ITA96M`?i*nQSEYun$uo-+O-?0yy)H|4 z#k(^5hRz42XKGe+5D1ew9OkQPppf++Pc9 zm=5P)LHU1+^yl!Widf(g$W4ARc~{&=EmaQa$P$CRAUu zl^8>X9l-5U%L|c_%>Xu0zmz9|+*28mhBJaVAoZaxaN7%gIHs|cCHvVOr~+h%Coz&a z&N6CcSlDIIXV98~C-R>qi9X{3rdf-8;A7hqoq&=ya=?WIdJ2y1V{BYSfa%psec|c; z6y=^q8`l{0&os#%UKpHU^N~miEpFCC6GJXk^#iq9RuZm2&$p#!ERpH1Zf%PBQb=0m zKqqS+t&YPze>$?*mlNAbxE@a4C`Bf$S!K=?<%iaqVom$D^&Ps?B#J@<#>aPYj8LyE ze>nV4p{HRn-cwtjmRyggBCK0VSp3pt=K$0ZUBuu=beL>#%hH_KjDoIv^*N-{MJ8)n z+|M5ja=GLjkZSF&t}SE-7#ZjWaaeKcO1~=e&rDUg?qQdm*vbCwWjbl0^E7qV8s)3R z9bY-=kykBb(`A>=bpe6)s|)~+Vj=j`wDT4Ivn(*wAVFVK0~tVMdyYFnPGJcuG2UibCX&z*xTI2m6j#|^b9!v018?? z7}IFc(7r5qhedUo+V)kENGm8}59eOh@SFDB*EDyI%f%NaSb)HhhH?4Vfyd$RIPJ5z zMm^IxBAz@os6gY*LO#4=xbZj~9ws)FO)27W6yZnQYG``1<@QqoWczQ58h z;bkYu-4kxd8;5?q2=8B_J{a*`kBRjr@o$9uQGaKsPaJX1f^RWiH7vkva#JIF;NX4k z)z$dp;WxsckNzBMZ;Kup(~|KJFx6qQSnlHaRGqQ`mjf8XWOd`cWey?4VOO)qL!Ea^ zU%Rj1Z1U<@hk7rS`sw%dKRRzdCHx`y%LJNt?FHZo?R8g=WxtGkIUtT<+cLmc5`ovQ zdgIXf=Zk-4zY=LS{{Y*63-xHcYojRK_j*ih9@nqSED!Uc18+Fzo|vz#J~saV!8trl z;k0}I0EGS~)Aid@hDFowV-Q@i>+Ma$YqO7xMqs-A)Xb%TsH%+_|_SQ0||^?%NIpIH?QN+C|0XS-lZ!arJu9E?VUYZnK_*xzUnGFxhe8P>cPG7dad^K>_-*13_*}4Q`ktfZ zOZFAHw%0txc*Fe2$t;`X1Ty4|sPeaCcwGKBc(1}bhKF>P_u56xtF32ud?ry+V z;F1P&#z@UF!{dK}ydxH|u3Fhcq{(S4sV4Irmr}CETgq7S&AEvK4TJL!LywC5J^M(0 z#-FtJg{9EGFxu-r7uRJ#ntaw8WGxM=e|@G<97c|J@wDfY$Q2)p{{Ub=ikAAU9}xcl zWpCOo{8GAYhWmN79bJEXhXC8GzGn77yMb9Za&QWawS4sWZwp3TwdX2N`^!)K3f4V( z8NMR2ydtORqx-c!&+z{M#?JtFhU-t(d`YHWT1TnKiJ>mFr^=~(zN)jeW3=;r(LGn71NoE^|%6^RaJ^ug&A^n>? zOQ2h5UJKN<4Qk!s5(_^G_-^84wo#RpLjk>EQe7ASozW`*FILYG}z{T(f$A19$+gH8tj-T*j z#9kYN!?3l?ZLDecHn!7(Q9Z!`;w4-xo3;wOXrKcK;L zF!3acBe|AX(ld~({{SpZFs{$eKsDv6H97elZ2thR$9!Kpyll;H7wW0w{{V-VI&bX_ zHjQr$>}1CjGg?j{fmjJ3wU$(jvo=@eM+^vD9@Y8t@yqr-{h54OrE7jE@R8O06>p+y z(~WCW*7Yk3tueO(BaA^Dt#KJV43+)n91NC5U#;}Ztyjf5Pl)V35BN(;ves`Sp7!^} zHyU7(Yy)|Y&e5P!@iq_Mbpv=K09CIB_*>#$w`FqQAAe{s3F`VC?wpY68b5|SGc~=` zzc24CnOg2h<+X?~%eXBknYFfsRX)}O6^P3doMz&?YxyMa^Es;0g?Guz&FQLNe$sQp0NtF6)&9 zgTNUWsbab4T;Eb*a#d+0gwzUE)eNJ$R6d{oR z0C{5@Pq!UUHG4>Fn+B2MhtKn(^4MHMn933`7ab4hTJZQ~)qc=yqjW8h@AuVxfa5;r z9{H}*Nw&RPX(NKuXWa#(w+tiaIO~z@bHT4Bz9*MNE?b#CAMkuqKyGZNU?T)b##I|Z zUN+%XfX;D|+upS;{3~f3V&3LW=v>PYNs6N!1CxxNr@!|_U(+-@c;XYSKsb+v!#eiemCFUBE!CYt#@3KQ{wCa0#y}c!^(9c~?V~(|iX09)?l& znaocqQ*(I>`Hw4n%mLarV=8@suGdBIwTudGKF17lC<`MtQ_087z~OKS1QE#3bJC>K z^nFKEnfyJYcs}}RZfD$<7PiJ|WGom0ij2%vfNr349jo8|4*tM@9ehZ!UU;uVvhcQ- zkni^QX)mNFZdqVX5b%Ecj@(x*MOL@Kil;`kS7@WewCObcDhX{g*)441jW@5IcOZr) z0EAa05OPl~kOni?73g0NJ_7t`_^R=MUu z;N*k$Kf+Jh6W}kyDD7@Fj|4^HJx10+Bs!0XBS~5p{`7IT0(d$@Uq^+jg2BU< zl{Ftj7nHa5kLPdg)>q%XhVnUq{v?<-efTviMhbr7#mVk-!LQ#PfA(PgpS*YGTKKEr z2ZFW3G5z7xyd7b1%zbw>MCY%1;Jiuy00hDPgmrmd$5j2AyeXy3sl*;1wUbV9{{VoJ zMilec8T^HIM>3$@nj%?EWwSpLBaZRZtYnkh3Qyz(OA}u&$s}HY<+umwU$5RG{{Vt2 z{=)ttDs+Df__IN59KM_5d&zQ7sJv;{@Bmj8u7AM*eg({q-WUC*e0yf>2}7#bX_u&n zumUJ8$-&1~IUI4;w^-aeTifJwyuT8itbSX(lB;2eQR};dQVWJ8DPVEjHh&8H_r>4v zZ|}q#dzOC${?|Sny++Q+HJ<|9*_G>!(!+aj4{ni)^KTM=!45xeEg-Y#8u!C(Xeq+| zhs9TLNdDz6Y@bjb*27MD=(k|4WWRCO9BmMziZ{n}nPxh|xY^VMbzu9-< zPMV5Hl3Bb3sXS@`B<5J*Xu#vH>`rdkXc zers)nH!ZjN{{WtphBzJk%Y|mgBX)Q{TCQZ=pDZlcIKrMjy*aO;{{Ucb*;m8A8+>5i zFZih}w*D8=<5?hwe2O(|jrcGls`9aqno+q345K`eUQTI`!{vA>;wwEP_rD}K##J4W zx%(1+$MX2#f5Pnei{R(G@b;XdeK$s6F{&;OWPBWmmx2MobI&Tce^~vm{w8=k!|v7| z5z~?NTbpRmBC;@Fm84k}lMD*GaHkjz#~&?vZ|ytrtKpx)&kcQ-!Z1TINIuPM);BW3 z6KBdHP`g1w25=4lP&ou+!M|tEfja*H$8QwP@ju1a>uO???J!!KS20VF?uT-+0U0R6 zA-6FEU~F4_czu#+XG3Lu3PFpDa}v8TXryvfOtPJ=v+o>kE4r=d*2vIBWvyu^ z%AWCAC5@V69I`W&eascq*vL4pgZii3leEV1u7Vp6|yxJ&VN?N@0?JE_+!#=%?mE=DA-it}&M9hB?au*{m%q z#TWX7=Si@d+{oahh>j(lB+9cXM%bzss3UgW%a8?ll%pzlbk?4tbdihUS*E|XxbXeO z=AorcV{lgz+bNPQ%d_PUFcj^OV2lvQ2NaO-fac(Hux5RAOC@La7J<3=`%o6}K>AxaV(UUP-twz|Yv--1V;y#XMTv znw7S)!|h}!v62KSZ0+WsF?WS7yVbW0wL0YnDuxV<%NQiN#(qUXfDTxm zbBb?|HTxUelLy+;J8vxjc+>ZY+qvAJkOoEy;P>lZXX1|$+G-lj=9m4oBg~Pj8Rmjm z)MdsQWhu3=#R~v9>)2;(I>bs=MtAY?*TXu+t*yMs_X6;sxo9R5MtsPF z5UZ3glq0x205@_UnhX8t$Vfl(9L$jnPyG7-B$d<7xS_Msn@E zLw$7|4GyVuZzPuO=Wn||B#JhcSCf}L2;J(SitcoO6KekeVUhK#cngI|KGPd1GNTv9 z6&vpjgz~t+uT@JILN-b-<*AgZsWVeY@CdWDTkG#0OQlTLQvId8IcEfZXl4YXvqtLJ z^(u0C$QT2$)AVa!1i=*7+IFYo8%vadTIOkm%!6caw7dkWvz~HM3E-YN6~t)26Eux4 zRk_o3twsxLxhF+}2Y|2I6lOvrEZ-}E7|6#e2?UOtH{TNVT~fpM7m`IeWHQBhWhAF- z22v7Cs*u0zfXmnAtY=dbwBqgef5H4qv@CS`@52uP+gw4e_%Gq^iK5(HqYK-+4H02! zRDx0DE~v{QmtldH9%ncpgHy#?CY9ksWv^XWrOHH-NiCFGu3(zsK2p)fNl4rsnxEX zn3iD_Pd@x(oU$oW0|)*goQ#ZeHH@3Kt$MPelGxvm#5Nv3@S07b>Q*xNb`@x@yx7{- zb(C)+D7UhL;H&-MS1W)zn)vJXk^QDTBjDT1y(&2-`(nre{{T)cBZc8k17SfWTLX?s z>2MVjlza-bgelYO`*NXL7HS7D| zHb?8Z0Kn&<0|T#a2WtI8f_OrBnrjn?O+%vUVOCdZCVJ(c?RlscmdNQ*G#3m*TgF`# z6!ciw9Io6CT!DfxYuf$<{?__!)x=tT=CqKsNKe@>7vy8NA1f+?1{7sT#xu@wkBKa1 z5y|E=;W3ecTUu77aU6>@GB^>obm zL1_meoMDC-WFroZk}Hk5c2S)2 z)#+ceUw}RtY7^dglULBLwL6P#L-!ZD!BvR@edU7;!FMzFQgOL)gU{r++#O7wHEC5( zOKq+G{R5TGO2=)b&)_XXOcyqqB-Xe0(uc9SORbG3&K1aV6qAQ=6_r2-ki6rY@m`tZ z9SU|jcZhV$iz{eaNvEFDE2NAmY{#}CmnR{MB9+JS01H>8YH8uCsTM08H~Tur%q8sO zw0n%4fN-EWq6}c@K&v;ApZb_pj#_Pwh`y~Wscph%NYZ6?Z7*5L2PH7 zAD_c!bfZ(@e?3i{CCYe}$Hrd@NpvjiJV|ci;^)qm=SG32lGQ=-+)E;Sqa5K>o(?h& z;ax4Qr^cTZX$f!PZv^P`>49VNH8<2|j_O6)>&#_;bVlXngQ+98ZS8kY&^#RX5!t4Z z0$xHq$Xiobr@V}AP*x&X5#Xksrh^@3{JOGyn(@3+c0IeZS z<(RiDF`v3SaD67@;(g7QmmZgMD_yo#-pf*z3dTyV6(S9kzy#&G9+~Jo`&ze}>{^IS z_S3~9yTtK%S2o9K^2!cTfaj>k860Okt{ll|U8S zamXVi0-*HC&z_B0UBw-6#3~(6PSw0er|Q$(YVpN()?!sfl-z_^h{BcGyr6F7n{xm# zHssYEV@&agdssCMZdp*s4ZL@3tkTQ0WfwntmK`!l$mgYbeuJUh{6#?bTEp8yp$)f{ zd~J^MBn87MSsN*UR2&W6@y4*ztiBj(A{%cM>yy3ptZa)ur8U7S#mheV9F3&6-s;M# zIl!*!RVm)d>)PL`YZVHL=+%!&gYA!buc^Gu%;8xOBzzUx06ZR}BxHSS-2M!BPU7Fg z^T;NS!q#X^ke6Vj&p&7x8A-1_h6lo~M zo>zNqDP`R&N*f^pTc4NM=D6RBI(gA7Z11C(75j8W#8EM2`Lnp?M;HWtHS8C*Hs5Le ze?4TQ=<7RvM(9DaB`>y-GNVQX*UOSz@BZO+T&xF82$>cF0PAo}yi72Qg-xzWp7 z3B{cI-&x+q+X-;JNK=9M;;{8oYb%K3RANU!Kh7(o&?1Gj*OEB7MQOE%G8>^qy?G<+@ja#0cwcj+Q$C#+4doJ3F^G}B6 zBP8%fJ^Zd~z7jB$xlbO{tOCouP!ionI@VRpZyDMm2h$bn`gevbbzc(L=;uziX1%#c zBNHGCxyV(?Jvkz}A07VAmwp>WZCgUqBT|w&nC{c=rVDYA(H5{c@w;v^k&(w0 zt$pBKMWQIs-$V~zGSHEq%lg+nrP^xB@-5xG+pX>z8AijjF#Iw&!Tf3+DI;jsrzN8< z8#S4H!6?tttGqIy;0zyn)wR)~l{Y=niH|#1kbb$vNe725F7DS)I-8?8z-G6|&*w+6 zsn|WWF6Ii!B1lHoAao+8LnFS{;}y|e{5HF^1g5VO0sjC@n178|9t_nKpDOOvy$O)y z{*{x9Or=r}sghQ8JCzTpH6(Anu_JUHIsSF5JS(h)!g(*Zx0%=T6&2@$JWwO^Ev!>_ z_k85%@Xl!EW9EzMW;_tca@YXz(~64PB-5^h4KebhIZO|`$4{pmRg3)}#rCkHjSg?T z11iK^{!5yQ>qpj}&DHeVf}1kq%OHW)nv1bq$hEw};4@`O;Nqu_NJ?N};Bb0kxy>r~ zSCGqTb!_S&+8LxxrNQV&Jm(&rdsdyfx!!!FV~p+rNymDdSZKUP{D7dG@JXht6#->T z5Nb5KBm{YIPdE+F{{UL0SrvvEv+wIjvP4vrkr~?F=A2qszFcR5a0M`pqaXo;@|Er? zSf^3~I}z+f8;aK-6yOX4k~3kDN)kiCQ^sp%&sUiOtb7678sgISIeuA}=NQ^YdcUUYen|-?21W)4TIQW1(>)hK z)veXM`9g_y<9JLqI^*eEu-#kApycz=5ngX)tANAIao3J8Yoyb)jEwo&1JSFBq-7nA z;-b#V*3R7H%5?`B!RcBy_K}4Jn1lR9af;`(ty&+v%rlOF*7c3$tKbIDr~46Y2Vd%B#TGvA(=I$NWc}@%ZGOi%Cb%ompZMYpH+Y`qqWFT^&cr3ZiFLb+aT!OF<5hc> z1JH&H_yeZiMstH(*4kggPa9gv;qMpQX}%z`D6FaPq5pV-X{6r3MUGIdxBxt&fyQDr`nFQrPRwJf=JlD=+GI_(_rrrFHUXD3VJhMa| zJ^uiLX!ujd_jBuB0`Yu49sv+qX>AMLMm}7UWHN3X^Yr5azGL{|`zCy4_$N7U7I<&W zv{xcMM^2Z`h>Y=)yr)m%12y^)@ZZKi4mB}r;q7~0eJbwc?@4YgBr!t>^{NV*o6nO8`AHk7~r!ygT4+LIEz4 zE_9oPjl9?|$atOk_HK9|TKzoum-_*HCit~z_s!ucd_Q!DFR5t@6|vz@K3P(a z$2lV>*ERCz#$Wg+SH(X8&vJY`A@OCTXbD|1HxtIBWD*zvPCF?-OlH1^3!G(mr=#|A z^V|H7F1B5ZhTigBw?01A^etA#IU3-jt+5_t@h9%ou;EKD0-E0~c!$Ava#-pbUCpeifi<1|v0cP+1ECmi zTw<{9(@d3~Ic%b{nPbB}lmsc`f>4}ip!so;+PzAYY1W0RB`C9oGI5ug^bdf4;H>`u z6!h;4#o;d){5tT((g{nZuczset>DU$%1j4G}>8?{@&Pcnp=4kGJ<$M zR(Bt$1P=9;VS6^6GU^u5Kba3HA}KW2;-1dalRmhlD&G z{{RIM@Xy2DM$1LEPcQAc}aA0bO zjl2i&LtOBo)x0&~sI}P)tM)6qU2W{1Rl_J#Bs*E+-bVc70HEXLugxpp0eH*dpM&T4 zz3?Z*`qzc@M4h9LO~2Ka_fNW3=X6OFlUl1WRv}9V!a3k%R~MxI-k%$z)-2z2vdxX~G`h93S)2k)(K6bbzowb+OG6%N5gRGF2GkaZ!Qz^!%xW#Kg32 zhnz8Tai4QvSbVkE*zV5qQa64H10Uzwt-{w5kgT`>{J8%B14#wF#E*oP0}?*y&m41C zCKpz)nB!8)pq6C>kug}gW7pBCz{cz45I3DmWF`=k$PVWnA1 zaWslZP~js|!~$|#7#&VAUUgZ@S|Oy{vO8NnQ%Ta5-U72Wc8BuZ5rfV+_8j{DwwJ`( zZ;%sDm^6)y#~~^XaCV+^kb4|gw)_zP0D@P1aPiaI>R%GPN2mBI&v0oiq;Y?Kt#3xA}@1k$e<7+8qp=aG-D zuCZLWHc1xZyztMk-EJ1KgYe&MFr+x0b|e zIn$=R+Z0ahw-bpUfKgclYQ>1akzbH9I*QpR(H@GVqP03J&mU=1U2e5ODJKe3lUY|D zGS_Y-*-;1DbJqfTQR190c68P#k{PxiSQUNHW zvt!o-{5#fWr=xsG*5^s)@Wt~D#6n`y?xa!=JQaivgE-0KHQ(vJ9n~*%>xS1pB%LDO zTX(l*OR*k8^D~7x8`TcX?a1M~3gmU&D^9Q}ZF#Px+sGO_fO>g&JDp#Uz_vbCUXBl~ zWUDnkRlm>tjny=^{=XBSd+!|hMkYFjnzl%&Ly+7z7V?U$rqNXDj7_ZZ5%5|9x&J(n8E66e|k$+ zOG!P7nqTb;Z{r^n{{X@ybqz~O)?!wUZw~4f(%Rf^RT44=^*w!}2)5}0+^k6p9$scQ zEx_R;R>=jxudIF^_&U!?wJ4WqDuKfQ+0R`1fBLH`_2WsTjiW(Io!SS`?%p7w7#wnT zoDascrP8k6e=TEez~B}bADK1Y#SOMLCC^U8V>OwoX>i;JXd!S|9oHrJU-w7<0H{)i zDo=BsczC0pkHhz^0rTfoJ%CVi`qcK?MVtyg)}yaDU8L2$F3RF72o~zjI3(HrscsCr z2Vh$RarMB)dJ;K0x<|vm5qOk{^joo>?I1fx*EOW8Mk?}lF?6&t?KHc6N?{d@3Nh2o zIX{(l9ufFQsp|Iv?XwI+@64lU{JNjQx}O1jB=G*5X0z)J_M6zi^8{ZiXX#y?rTw$R zBr!oHxR2!<(;RzOm59x$$4EQ*nYgv0IL&w9C&S%iOOr_Prj2K>TiilpnjLP*E}#EBifq_dl=XweV_L|c1^ zRaI~mRYnFeU(@f5ylu{}T@mH3nY00lq&k341Zll}^w;tSnX zbiEft)O;nO>sp?)w^6{UV!myoIrE%}Zrkjw5~5&9jrKRr^ogT==8JFLR^#H%pdFYwc`>27BO$%V{1+JBW29@Ic{D zEHU-3#w~xrKMVXkx;>Vmqa~$axXeCi`XkPngVdI38mWfJhs5l^I?IeY^16!2bXa^uG)wT1K^U zi3&VzDk`|1B_<%Fd4HG}$>SjKKqCXhe`bvfz}_D4tU7Ly@lQjtxw?3X5?;WPqM>5( z2&FDmvDl!M!!iyIMmnDg-uRPBzP!@(pNLkMP~F|nHH6x(hHm3ADQOlK^7ds|WEW;) zPXpC{D~a*=tbQs~sZW+L*;%jAno&_m^h;d}!ZWf(;jMQ1{@Tvpp`1Si8*Fm6UpU>2Dzm0r^FPVJwR(Q zX`0k_=+`!uaLZ#FAega0Jjp))0F}2nC(Cq<{KIffSH+$kzH2}2%Ug)9FD+f}Y~@>Z z@}*STR6G2^gN9+fTW;kdLJE`e@ufR^(!cfSbX_BM4~Tl*mWyko>6-L6rYMYycyyAI z2+XarHbo?VssI84=PG_)l`O4)t3zpXbe7vq!;;ZkNV07tF(H`ZHz#l23^Ja=pzx-@ z;aeSc-tD8B_Etn#A-=ULxsYdL>{m#JcJg-&@NfWT+ig$5y6nH&T1D*MW20ble8ol) z;R*rf0#vDT3CTGF6)Fld(Gd0BnKNq_u-q(Kevy9ymz9?O84@T~Qmz1CPDlz>n1BHs zWDMhWe-P@rwSw7d`US;=aLXs!BAw#|pe}_se992*Cy);VBcQ6bQ@9s8e3~`Lk>Zc+ z@J^XoV;Lkmk&U2FGKRq!k#csLp!eE^wS<-;T~5rKcJp9sP!jGD<}$|WjL9Lxf;j*- zSP*kve5u*3$k@-nx7Dxph4D9qE})*-ad4%u$fcw5T5?5ol zbGGFw;gB4Vjl1|<4ll;uJmF^duT(&7$pE9V?b2pw?@n*HGc!*o;){>ZHxIR_W>MMeT zuGEt!D#{A51QCW(4hh@Scz(v?M%AIwmG5;Z=D0?Z?#@3l-Ig+?WLAl}+GPmLsz4kt z;E~>`)2APKYI*mZ-h;FlUgB#=^*v@dq4QKn0_o-2YqDjK?Ip&->ZB`R1w0IeIqS4v z3SCEOZ*c@Ga6HDEB)Pf5IojVNBB&^`ZW-rtki!)OH*2BWwf?c;3)|Bdmak!J7Re!( z%OIW1!FFzPa{K|wI0Te$igq?O*7}s+4R7?T$*hCs)jav7MjtDeMF}Er0ZVTR2>>@M zyNa(owS-MqHO*Age0!#9OQ+4L$7c+V=gZRcCWm3d)I0rnH$=cF1d2S$| zSn&1D%1fyRxS6$C7U4|W6-fZDbHfwYAob5DKHpEf)Gwb{9um55CPB8>?T;A;ApFQ5 z8CM562a%p~b6yMWTU!um8g8u~pKi*;!t%RGISN(SI-WX!M&7ah73a#VFriaqthr{Q^m@bvZ3=3?W_{ zi;pl!-7;!eBZ?+58uGwS;Or{=Yze(5EYuiXV$7uXnbPSMu{a&S+= ze;j@_>)#Ny&+KQ_rJBaY1aJo#=t=5H&t84&>bP5nDrWeVCf_RGb2^jd(Bb|n_^rHa z;)}gjWT+%A4x~M04AtXRp6Cdsw&MYGheNeMmhyu29Omx6bTTbGu^_ zPq6_0wfzf%!bXKC(}sx{qoR)IPl*SU3WJ`8B60Z8Z)V;a1lnI>L&PFrPbNN@; zAF=MU;yr7@mnQ2|mOU~nh8mrl=`A#m10Byfl>wEb!jM;vHx6uaXGh|5T|%48;>SZ zNFHMl#7OIm{oTzQO42+HbsfFmi8Xoc(Y(1~)NWWnoUkEBLhHu_mcrvW%{#(>4U@vY z9ZM*+Mgk(U$pnzxO&DwvsI%NSSigyI3yhVbWLku1n->E5Q5JPNmPXk;cfx zWB1RE=rTHIg&EF9a6CitC&Kzoo$b8W0!R|aY?ju@sT%bJnNAUb@41Em&N&t2UNf`! zuc=(X`iF$o$a{5q;om$^3-TwfQjOr`eCfY^eN4Jvi zOVn?5T}JZgpZJ<6O43ho8C#(AyaPZ;=P;k>rG zE}!9O?%)>d_LCKg$1B1NYOGsu+b(nbUZ<`I?q&U@z7*eTb7+_Mx~`JU?JC80Wa}J* zXe`-{LOOy9ovcsFyqf8!PZdH>+0%0QYH3Q9S?nJUG!GbRo-5NdmeOErF{uweY0D>- z^A9i>RZp4701|n@>tAernoU)}y%ujAR?P}5APDdjaKsGbk(?i30pxfuz@2Boe-geT z+UZ^#jU={WZbgO8!74@O$jat3xr9W50Bj5l6T3C^#;M^gI?B{8qhSzT!GT;VfG_|j z<_Dg=3FoDLfx;Z}gz8QluJ+Y-J^;V)KL9ljRwH{yuI_0VgY*1JEC(cF~h^ zM?F-zS<2~mkUzoh% zy=GjQ7Dm{aIXU@AKc#(M72PA}s;x<-)$9a&9yAWUST-sr@go@gh|?pn$UIhE;eud9 zmi*&_d)9nGi@Gxyz~~jo{43U`jyXWJsQ7|-+vK`AQ=SJy)Ew1qPsTnjl|1OYW2h7> zov(c(4t}j!+Lo6jipCk=o<8}gA=2lUPV&?e$V%=c^IpCYCiOh*OnG)JPvg%T&jZ@r zc&>R7hbton2eA6nFFbeR4-IOsX*R6Sa3c#e>uQB?z#MeRth&1Fc4@yf^zT=iH+})qY-Yr;~0z|RR5DHQ(tDw(MVUzT%)8kEl zN%2e`BGzWKOMP}Gicumq)O5gC+N5nfb?2$|tG*P~7U>!rGN>)$DIc2L{Ku16UNF+3 z)GTGwAh`3s&Yo;93C_m^9CYcL##m}SB6PxfSm_ty#;v1>gJ~A`QT(`&Gkp78wofNK zoF8s0UrhM#rbinK&jHxXtl3qYYi#GSE1%Cb=lXs2n=gh#+FY|wJ1LR|jN&3P4=2AQ zRX4eNSx9I}9CPVSVW{%zzZOqZ(a(%DJ!M{1wDJoQe2~GmjPwVL)fT_g{KK_a4#S$` zt#9FqQ0^EmerE@zS)0T*5s@5s!zZTXIX|UyPLhkz-Un2g)|N84a7R5UV(|rw5w?6_ zjF#i`u1-B~Ph~3C>yh{xihHYPb0X?7y621$#b%=vUn@JIs$0#++J-xVMMn2gtAEGW z2cgY!7W$pL0IPc*dVS$ii>3gWhs^((QD|Pb%dwPe5wio*2`I&lx_TXCk@#jb`#0#IPs;dU03u-xo0+TQ&|l zA6iZep|4t8ryI7^hgybCc8>4dcRbE=C7#)#p{i#hq}P zJ=aM1z2U&BCDj1WZ!LyDO6xSw9{6VN-DHnmv}SCNFYPKH{`n*vSI?R?)tvDJauoXX zCbw*%SiWfH-JWrr;=J0pXs)M3YNUIQ{3IGh)BT=Fp^;DhG*W+^NIV;&<945W8rnaIuTmx0g30dRYLIdQ@<1K99SwOtg{ay} z1-1MU%!RYNb_n9M^$iJbTXZ;GTo$F?oGzF6&f!G;uJNjP&mv{22I6@pC|u!{VRA%`;S$zC)@@0ftz?&O$nn z%Z#2u1Fi*pt?|qL2@9k6l61fL1>za*t_p{1YwM&K2Lp)!!vcSVgN|@`#eHR?c#loi z?b_zT>rcH#fkOFGv0dAa8|9E-@J0@5)}=0{u_PL8^tSAamw0XnS0Q>ZDn{J($IXuQ zI84hMfq%P|muI)!U1}6@3eu0ysrcpbzxH1E@9+~-TYnySBUFkd1TD&1pDl1o^t7ow*LS#&8?O={{Ri#{JJ(4<~E)v0B0TgW2Pz#``Mn<*vjuRkC(|Lg#)-yc>e(P zSEc^aKeFe>pV>cAjvtFY78bTM&LXhaZR8Tz-4n*em2wtO`eyrE&=3i)JWFVG1p7
- Ultralytics GitHub - space - Ultralytics LinkedIn - space - Ultralytics Twitter - space - Ultralytics YouTube - space - Ultralytics TikTok - space - Ultralytics Instagram - space - Ultralytics Discord -
diff --git a/ultralytics-main/docs/build_docs.py b/ultralytics-main/docs/build_docs.py deleted file mode 100644 index 825df80..0000000 --- a/ultralytics-main/docs/build_docs.py +++ /dev/null @@ -1,141 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -""" -This Python script is designed to automate the building and post-processing of MkDocs documentation, particularly for -projects with multilingual content. It streamlines the workflow for generating localized versions of the documentation -and updating HTML links to ensure they are correctly formatted. - -Key Features: -- Automated building of MkDocs documentation: The script compiles both the main documentation and - any localized versions specified in separate MkDocs configuration files. -- Post-processing of generated HTML files: After the documentation is built, the script updates all - HTML files to remove the '.md' extension from internal links. This ensures that links in the built - HTML documentation correctly point to other HTML pages rather than Markdown files, which is crucial - for proper navigation within the web-based documentation. - -Usage: -- Run the script from the root directory of your MkDocs project. -- Ensure that MkDocs is installed and that all MkDocs configuration files (main and localized versions) - are present in the project directory. -- The script first builds the documentation using MkDocs, then scans the generated HTML files in the 'site' - directory to update the internal links. -- It's ideal for projects where the documentation is written in Markdown and needs to be served as a static website. - -Note: -- This script is built to be run in an environment where Python and MkDocs are installed and properly configured. -""" - -import os -import re -import shutil -import subprocess -from pathlib import Path - -from tqdm import tqdm - -DOCS = Path(__file__).parent.resolve() -SITE = DOCS.parent / "site" - - -def build_docs(clone_repos=True): - """Build docs using mkdocs.""" - if SITE.exists(): - print(f"Removing existing {SITE}") - shutil.rmtree(SITE) - - # Get hub-sdk repo - if clone_repos: - repo = "https://github.com/ultralytics/hub-sdk" - local_dir = DOCS.parent / Path(repo).name - if not local_dir.exists(): - os.system(f"git clone {repo} {local_dir}") - os.system(f"git -C {local_dir} pull") # update repo - shutil.rmtree(DOCS / "en/hub/sdk", ignore_errors=True) # delete if exists - shutil.copytree(local_dir / "docs", DOCS / "en/hub/sdk") # for docs - shutil.rmtree(DOCS.parent / "hub_sdk", ignore_errors=True) # delete if exists - shutil.copytree(local_dir / "hub_sdk", DOCS.parent / "hub_sdk") # for mkdocstrings - print(f"Cloned/Updated {repo} in {local_dir}") - - # Build the main documentation - print(f"Building docs from {DOCS}") - subprocess.run(f"mkdocs build -f {DOCS.parent}/mkdocs.yml", check=True, shell=True) - print(f"Site built at {SITE}") - - -def update_page_title(file_path: Path, new_title: str): - """Update the title of an HTML file.""" - - # Read the content of the file - with open(file_path, encoding="utf-8") as file: - content = file.read() - - # Replace the existing title with the new title - updated_content = re.sub(r".*?", f"{new_title}", content) - - # Write the updated content back to the file - with open(file_path, "w", encoding="utf-8") as file: - file.write(updated_content) - - -def update_html_head(script=""): - """Update the HTML head section of each file.""" - html_files = Path(SITE).rglob("*.html") - for html_file in tqdm(html_files, desc="Processing HTML files"): - with html_file.open("r", encoding="utf-8") as file: - html_content = file.read() - - if script in html_content: # script already in HTML file - return - - head_end_index = html_content.lower().rfind("") - if head_end_index != -1: - # Add the specified JavaScript to the HTML file just before the end of the head tag. - new_html_content = html_content[:head_end_index] + script + html_content[head_end_index:] - with html_file.open("w", encoding="utf-8") as file: - file.write(new_html_content) - - -def update_subdir_edit_links(subdir="", docs_url=""): - """Update the HTML head section of each file.""" - from bs4 import BeautifulSoup - - if str(subdir[0]) == "/": - subdir = str(subdir[0])[1:] - html_files = (SITE / subdir).rglob("*.html") - for html_file in tqdm(html_files, desc="Processing subdir files"): - with html_file.open("r", encoding="utf-8") as file: - soup = BeautifulSoup(file, "html.parser") - - # Find the anchor tag and update its href attribute - a_tag = soup.find("a", {"class": "md-content__button md-icon"}) - if a_tag and a_tag["title"] == "Edit this page": - a_tag["href"] = f"{docs_url}{a_tag['href'].split(subdir)[-1]}" - - # Write the updated HTML back to the file - with open(html_file, "w", encoding="utf-8") as file: - file.write(str(soup)) - - -def main(): - """Builds docs, updates titles and edit links, and prints local server command.""" - build_docs() - - # Update titles - update_page_title(SITE / "404.html", new_title="Ultralytics Docs - Not Found") - - # Update edit links - update_subdir_edit_links( - subdir="hub/sdk/", # do not use leading slash - docs_url="https://github.com/ultralytics/hub-sdk/tree/develop/docs/", - ) - - # Update HTML file head section - script = "" - if any(script): - update_html_head(script) - - # Show command to serve built website - print('Serve site at http://localhost:8000 with "python -m http.server --directory site"') - - -if __name__ == "__main__": - main() diff --git a/ultralytics-main/docs/build_reference.py b/ultralytics-main/docs/build_reference.py deleted file mode 100644 index a9ddd07..0000000 --- a/ultralytics-main/docs/build_reference.py +++ /dev/null @@ -1,130 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -""" -Helper file to build Ultralytics Docs reference section. Recursively walks through ultralytics dir and builds an MkDocs -reference section of *.md files composed of classes and functions, and also creates a nav menu for use in mkdocs.yaml. - -Note: Must be run from repository root directory. Do not run from docs directory. -""" - -import re -from collections import defaultdict -from pathlib import Path - -# Get package root i.e. /Users/glennjocher/PycharmProjects/ultralytics/ultralytics -from ultralytics.utils import ROOT as PACKAGE_DIR - -# Constants -REFERENCE_DIR = PACKAGE_DIR.parent / "docs/en/reference" -GITHUB_REPO = "ultralytics/ultralytics" - - -def extract_classes_and_functions(filepath: Path) -> tuple: - """Extracts class and function names from a given Python file.""" - content = filepath.read_text() - class_pattern = r"(?:^|\n)class\s(\w+)(?:\(|:)" - func_pattern = r"(?:^|\n)def\s(\w+)\(" - - classes = re.findall(class_pattern, content) - functions = re.findall(func_pattern, content) - - return classes, functions - - -def create_markdown(py_filepath: Path, module_path: str, classes: list, functions: list): - """Creates a Markdown file containing the API reference for the given Python module.""" - md_filepath = py_filepath.with_suffix(".md") - - # Read existing content and keep header content between first two --- - header_content = "" - if md_filepath.exists(): - existing_content = md_filepath.read_text() - header_parts = existing_content.split("---") - for part in header_parts: - if "description:" in part or "comments:" in part: - header_content += f"---{part}---\n\n" - - module_name = module_path.replace(".__init__", "") - module_path = module_path.replace(".", "/") - url = f"https://github.com/{GITHUB_REPO}/blob/main/{module_path}.py" - edit = f"https://github.com/{GITHUB_REPO}/edit/main/{module_path}.py" - title_content = ( - f"# Reference for `{module_path}.py`\n\n" - f"!!! Note\n\n" - f" This file is available at [{url}]({url}). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request]({edit}) 🛠️. Thank you 🙏!\n\n" - ) - md_content = ["

\n"] + [f"## ::: {module_name}.{class_name}\n\n

\n" for class_name in classes] - md_content.extend(f"## ::: {module_name}.{func_name}\n\n

\n" for func_name in functions) - md_content = header_content + title_content + "\n".join(md_content) - if not md_content.endswith("\n"): - md_content += "\n" - - md_filepath.parent.mkdir(parents=True, exist_ok=True) - md_filepath.write_text(md_content) - - return md_filepath.relative_to(PACKAGE_DIR.parent) - - -def nested_dict() -> defaultdict: - """Creates and returns a nested defaultdict.""" - return defaultdict(nested_dict) - - -def sort_nested_dict(d: dict) -> dict: - """Sorts a nested dictionary recursively.""" - return {key: sort_nested_dict(value) if isinstance(value, dict) else value for key, value in sorted(d.items())} - - -def create_nav_menu_yaml(nav_items: list, save: bool = False): - """Creates a YAML file for the navigation menu based on the provided list of items.""" - nav_tree = nested_dict() - - for item_str in nav_items: - item = Path(item_str) - parts = item.parts - current_level = nav_tree["reference"] - for part in parts[2:-1]: # skip the first two parts (docs and reference) and the last part (filename) - current_level = current_level[part] - - md_file_name = parts[-1].replace(".md", "") - current_level[md_file_name] = item - - nav_tree_sorted = sort_nested_dict(nav_tree) - - def _dict_to_yaml(d, level=0): - """Converts a nested dictionary to a YAML-formatted string with indentation.""" - yaml_str = "" - indent = " " * level - for k, v in d.items(): - if isinstance(v, dict): - yaml_str += f"{indent}- {k}:\n{_dict_to_yaml(v, level + 1)}" - else: - yaml_str += f"{indent}- {k}: {str(v).replace('docs/en/', '')}\n" - return yaml_str - - # Print updated YAML reference section - print("Scan complete, new mkdocs.yaml reference section is:\n\n", _dict_to_yaml(nav_tree_sorted)) - - # Save new YAML reference section - if save: - (PACKAGE_DIR.parent / "nav_menu_updated.yml").write_text(_dict_to_yaml(nav_tree_sorted)) - - -def main(): - """Main function to extract class and function names, create Markdown files, and generate a YAML navigation menu.""" - nav_items = [] - - for py_filepath in PACKAGE_DIR.rglob("*.py"): - classes, functions = extract_classes_and_functions(py_filepath) - - if classes or functions: - py_filepath_rel = py_filepath.relative_to(PACKAGE_DIR) - md_filepath = REFERENCE_DIR / py_filepath_rel - module_path = f"{PACKAGE_DIR.name}.{py_filepath_rel.with_suffix('').as_posix().replace('/', '.')}" - md_rel_filepath = create_markdown(md_filepath, module_path, classes, functions) - nav_items.append(str(md_rel_filepath)) - - create_nav_menu_yaml(nav_items) - - -if __name__ == "__main__": - main() diff --git a/ultralytics-main/docs/coming_soon_template.md b/ultralytics-main/docs/coming_soon_template.md deleted file mode 100644 index f8d7802..0000000 --- a/ultralytics-main/docs/coming_soon_template.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -description: Discover what's next for Ultralytics with our under-construction page, previewing new, groundbreaking AI and ML features coming soon. -keywords: Ultralytics, coming soon, under construction, new features, AI updates, ML advancements, YOLO, technology preview ---- - -# Under Construction 🏗️🌟 - -Welcome to the Ultralytics "Under Construction" page! Here, we're hard at work developing the next generation of AI and ML innovations. This page serves as a teaser for the exciting updates and new features we're eager to share with you! - -## Exciting New Features on the Way 🎉 - -- **Innovative Breakthroughs:** Get ready for advanced features and services that will transform your AI and ML experience. -- **New Horizons:** Anticipate novel products that redefine AI and ML capabilities. -- **Enhanced Services:** We're upgrading our services for greater efficiency and user-friendliness. - -## Stay Updated 🚧 - -This placeholder page is your first stop for upcoming developments. Keep an eye out for: - -- **Newsletter:** Subscribe [here](https://ultralytics.com/#newsletter) for the latest news. -- **Social Media:** Follow us [here](https://www.linkedin.com/company/ultralytics) for updates and teasers. -- **Blog:** Visit our [blog](https://ultralytics.com/blog) for detailed insights. - -## We Value Your Input 🗣️ - -Your feedback shapes our future releases. Share your thoughts and suggestions [here](https://ultralytics.com/contact). - -## Thank You, Community! 🌍 - -Your [contributions](https://docs.ultralytics.com/help/contributing) inspire our continuous [innovation](https://github.com/ultralytics/ultralytics). Stay tuned for the big reveal of what's next in AI and ML at Ultralytics! - ---- - -Excited for what's coming? Bookmark this page and get ready for a transformative AI and ML journey with Ultralytics! 🛠️🤖 diff --git a/ultralytics-main/docs/en/CNAME b/ultralytics-main/docs/en/CNAME deleted file mode 100644 index 339382a..0000000 --- a/ultralytics-main/docs/en/CNAME +++ /dev/null @@ -1 +0,0 @@ -docs.ultralytics.com diff --git a/ultralytics-main/docs/en/guides/azureml-quickstart.md b/ultralytics-main/docs/en/guides/azureml-quickstart.md deleted file mode 100644 index 56b1cea..0000000 --- a/ultralytics-main/docs/en/guides/azureml-quickstart.md +++ /dev/null @@ -1,152 +0,0 @@ ---- -comments: true -description: Step-by-step Quickstart Guide to Running YOLOv8 Object Detection Models on AzureML for Fast Prototyping and Testing -keywords: Ultralytics, YOLOv8, Object Detection, Azure Machine Learning, Quickstart Guide, Prototype, Compute Instance, Terminal, Notebook, IPython Kernel, CLI, Python SDK ---- - -# YOLOv8 🚀 on AzureML - -## What is Azure? - -[Azure](https://azure.microsoft.com/) is Microsoft's cloud computing platform, designed to help organizations move their workloads to the cloud from on-premises data centers. With the full spectrum of cloud services including those for computing, databases, analytics, machine learning, and networking, users can pick and choose from these services to develop and scale new applications, or run existing applications, in the public cloud. - -## What is Azure Machine Learning (AzureML)? - -Azure Machine Learning, commonly referred to as AzureML, is a fully managed cloud service that enables data scientists and developers to efficiently embed predictive analytics into their applications, helping organizations use massive data sets and bring all the benefits of the cloud to machine learning. AzureML offers a variety of services and capabilities aimed at making machine learning accessible, easy to use, and scalable. It provides capabilities like automated machine learning, drag-and-drop model training, as well as a robust Python SDK so that developers can make the most out of their machine learning models. - -## How Does AzureML Benefit YOLO Users? - -For users of YOLO (You Only Look Once), AzureML provides a robust, scalable, and efficient platform to both train and deploy machine learning models. Whether you are looking to run quick prototypes or scale up to handle more extensive data, AzureML's flexible and user-friendly environment offers various tools and services to fit your needs. You can leverage AzureML to: - -- Easily manage large datasets and computational resources for training. -- Utilize built-in tools for data preprocessing, feature selection, and model training. -- Collaborate more efficiently with capabilities for MLOps (Machine Learning Operations), including but not limited to monitoring, auditing, and versioning of models and data. - -In the subsequent sections, you will find a quickstart guide detailing how to run YOLOv8 object detection models using AzureML, either from a compute terminal or a notebook. - -## Prerequisites - -Before you can get started, make sure you have access to an AzureML workspace. If you don't have one, you can create a new [AzureML workspace](https://learn.microsoft.com/azure/machine-learning/concept-workspace?view=azureml-api-2) by following Azure's official documentation. This workspace acts as a centralized place to manage all AzureML resources. - -## Create a compute instance - -From your AzureML workspace, select Compute > Compute instances > New, select the instance with the resources you need. - -

- Create Azure Compute Instance -

- -## Quickstart from Terminal - -Start your compute and open a Terminal: - -

- Open Terminal -

- -### Create virtualenv - -Create your conda virtualenv and install pip in it: - -```bash -conda create --name yolov8env -y -conda activate yolov8env -conda install pip -y -``` - -Install the required dependencies: - -```bash -cd ultralytics -pip install -r requirements.txt -pip install ultralytics -pip install onnx>=1.12.0 -``` - -### Perform YOLOv8 tasks - -Predict: - -```bash -yolo predict model=yolov8n.pt source='https://ultralytics.com/images/bus.jpg' -``` - -Train a detection model for 10 epochs with an initial learning_rate of 0.01: - -```bash -yolo train data=coco128.yaml model=yolov8n.pt epochs=10 lr0=0.01 -``` - -You can find more [instructions to use the Ultralytics CLI here](../quickstart.md#use-ultralytics-with-cli). - -## Quickstart from a Notebook - -### Create a new IPython kernel - -Open the compute Terminal. - -

- Open Terminal -

- -From your compute terminal, you need to create a new ipykernel that will be used by your notebook to manage your dependencies: - -```bash -conda create --name yolov8env -y -conda activate yolov8env -conda install pip -y -conda install ipykernel -y -python -m ipykernel install --user --name yolov8env --display-name "yolov8env" -``` - -Close your terminal and create a new notebook. From your Notebook, you can select the new kernel. - -Then you can open a Notebook cell and install the required dependencies: - -```bash -%%bash -source activate yolov8env -cd ultralytics -pip install -r requirements.txt -pip install ultralytics -pip install onnx>=1.12.0 -``` - -Note that we need to use the `source activate yolov8env` for all the %%bash cells, to make sure that the %%bash cell uses environment we want. - -Run some predictions using the [Ultralytics CLI](../quickstart.md#use-ultralytics-with-cli): - -```bash -%%bash -source activate yolov8env -yolo predict model=yolov8n.pt source='https://ultralytics.com/images/bus.jpg' -``` - -Or with the [Ultralytics Python interface](../quickstart.md#use-ultralytics-with-python), for example to train the model: - -```python -from ultralytics import YOLO - -# Load a model -model = YOLO("yolov8n.pt") # load an official YOLOv8n model - -# Use the model -model.train(data="coco128.yaml", epochs=3) # train the model -metrics = model.val() # evaluate model performance on the validation set -results = model("https://ultralytics.com/images/bus.jpg") # predict on an image -path = model.export(format="onnx") # export the model to ONNX format -``` - -You can use either the Ultralytics CLI or Python interface for running YOLOv8 tasks, as described in the terminal section above. - -By following these steps, you should be able to get YOLOv8 running quickly on AzureML for quick trials. For more advanced uses, you may refer to the full AzureML documentation linked at the beginning of this guide. - -## Explore More with AzureML - -This guide serves as an introduction to get you up and running with YOLOv8 on AzureML. However, it only scratches the surface of what AzureML can offer. To delve deeper and unlock the full potential of AzureML for your machine learning projects, consider exploring the following resources: - -- [Create a Data Asset](https://learn.microsoft.com/azure/machine-learning/how-to-create-data-assets): Learn how to set up and manage your data assets effectively within the AzureML environment. -- [Initiate an AzureML Job](https://learn.microsoft.com/azure/machine-learning/how-to-train-model): Get a comprehensive understanding of how to kickstart your machine learning training jobs on AzureML. -- [Register a Model](https://learn.microsoft.com/azure/machine-learning/how-to-manage-models): Familiarize yourself with model management practices including registration, versioning, and deployment. -- [Train YOLOv8 with AzureML Python SDK](https://medium.com/@ouphi/how-to-train-the-yolov8-model-with-azure-machine-learning-python-sdk-8268696be8ba): Explore a step-by-step guide on using the AzureML Python SDK to train your YOLOv8 models. -- [Train YOLOv8 with AzureML CLI](https://medium.com/@ouphi/how-to-train-the-yolov8-model-with-azureml-and-the-az-cli-73d3c870ba8e): Discover how to utilize the command-line interface for streamlined training and management of YOLOv8 models on AzureML. diff --git a/ultralytics-main/docs/en/guides/conda-quickstart.md b/ultralytics-main/docs/en/guides/conda-quickstart.md deleted file mode 100644 index 5163220..0000000 --- a/ultralytics-main/docs/en/guides/conda-quickstart.md +++ /dev/null @@ -1,132 +0,0 @@ ---- -comments: true -description: Comprehensive guide to setting up and using Ultralytics YOLO models in a Conda environment. Learn how to install the package, manage dependencies, and get started with object detection projects. -keywords: Ultralytics, YOLO, Conda, environment setup, object detection, package installation, deep learning, machine learning, guide ---- - -# Conda Quickstart Guide for Ultralytics - -

- Ultralytics Conda Package Visual -

- -This guide provides a comprehensive introduction to setting up a Conda environment for your Ultralytics projects. Conda is an open-source package and environment management system that offers an excellent alternative to pip for installing packages and dependencies. Its isolated environments make it particularly well-suited for data science and machine learning endeavors. For more details, visit the Ultralytics Conda package on [Anaconda](https://anaconda.org/conda-forge/ultralytics) and check out the Ultralytics feedstock repository for package updates on [GitHub](https://github.com/conda-forge/ultralytics-feedstock/). - -[![Conda Recipe](https://img.shields.io/badge/recipe-ultralytics-green.svg)](https://anaconda.org/conda-forge/ultralytics) [![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/ultralytics.svg)](https://anaconda.org/conda-forge/ultralytics) [![Conda Version](https://img.shields.io/conda/vn/conda-forge/ultralytics.svg)](https://anaconda.org/conda-forge/ultralytics) [![Conda Platforms](https://img.shields.io/conda/pn/conda-forge/ultralytics.svg)](https://anaconda.org/conda-forge/ultralytics) - -## What You Will Learn - -- Setting up a Conda environment -- Installing Ultralytics via Conda -- Initializing Ultralytics in your environment -- Using Ultralytics Docker images with Conda - ---- - -## Prerequisites - -- You should have Anaconda or Miniconda installed on your system. If not, download and install it from [Anaconda](https://www.anaconda.com/) or [Miniconda](https://docs.conda.io/projects/miniconda/en/latest/). - ---- - -## Setting up a Conda Environment - -First, let's create a new Conda environment. Open your terminal and run the following command: - -```bash -conda create --name ultralytics-env python=3.8 -y -``` - -Activate the new environment: - -```bash -conda activate ultralytics-env -``` - ---- - -## Installing Ultralytics - -You can install the Ultralytics package from the conda-forge channel. Execute the following command: - -```bash -conda install -c conda-forge ultralytics -``` - -### Note on CUDA Environment - -If you're working in a CUDA-enabled environment, it's a good practice to install `ultralytics`, `pytorch`, and `pytorch-cuda` together to resolve any conflicts: - -```bash -conda install -c pytorch -c nvidia -c conda-forge pytorch torchvision pytorch-cuda=11.8 ultralytics -``` - ---- - -## Using Ultralytics - -With Ultralytics installed, you can now start using its robust features for object detection, instance segmentation, and more. For example, to predict an image, you can run: - -```python -from ultralytics import YOLO - -model = YOLO('yolov8n.pt') # initialize model -results = model('path/to/image.jpg') # perform inference -results[0].show() # display results for the first image -``` - ---- - -## Ultralytics Conda Docker Image - -If you prefer using Docker, Ultralytics offers Docker images with a Conda environment included. You can pull these images from [DockerHub](https://hub.docker.com/r/ultralytics/ultralytics). - -Pull the latest Ultralytics image: - -```bash -# Set image name as a variable -t=ultralytics/ultralytics:latest-conda - -# Pull the latest Ultralytics image from Docker Hub -sudo docker pull $t -``` - -Run the image: - -```bash -# Run the Ultralytics image in a container with GPU support -sudo docker run -it --ipc=host --gpus all $t # all GPUs -sudo docker run -it --ipc=host --gpus '"device=2,3"' $t # specify GPUs -``` - ---- - -Certainly, you can include the following section in your Conda guide to inform users about speeding up installation using `libmamba`: - ---- - -## Speeding Up Installation with Libmamba - -If you're looking to [speed up the package installation](https://www.anaconda.com/blog/a-faster-conda-for-a-growing-community) process in Conda, you can opt to use `libmamba`, a fast, cross-platform, and dependency-aware package manager that serves as an alternative solver to Conda's default. - -### How to Enable Libmamba - -To enable `libmamba` as the solver for Conda, you can perform the following steps: - -1. First, install the `conda-libmamba-solver` package. This can be skipped if your Conda version is 4.11 or above, as `libmamba` is included by default. - - ```bash - conda install conda-libmamba-solver - ``` - -2. Next, configure Conda to use `libmamba` as the solver: - - ```bash - conda config --set solver libmamba - ``` - -And that's it! Your Conda installation will now use `libmamba` as the solver, which should result in a faster package installation process. - ---- - -Congratulations! You have successfully set up a Conda environment, installed the Ultralytics package, and are now ready to explore its rich functionalities. Feel free to dive deeper into the [Ultralytics documentation](../index.md) for more advanced tutorials and examples. diff --git a/ultralytics-main/docs/en/guides/coral-edge-tpu-on-raspberry-pi.md b/ultralytics-main/docs/en/guides/coral-edge-tpu-on-raspberry-pi.md deleted file mode 100644 index 90f9145..0000000 --- a/ultralytics-main/docs/en/guides/coral-edge-tpu-on-raspberry-pi.md +++ /dev/null @@ -1,140 +0,0 @@ ---- -comments: true -description: Guide on how to use Ultralytics with a Coral Edge TPU on a Raspberry Pi for increased inference performance. -keywords: Ultralytics, YOLOv8, Object Detection, Coral, Edge TPU, Raspberry Pi, embedded, edge compute, sbc, accelerator, mobile ---- - -# Coral Edge TPU on a Raspberry Pi with Ultralytics YOLOv8 🚀 - -

- Raspberry Pi single board computer with USB Edge TPU accelerator -

- -## What is a Coral Edge TPU? - -The Coral Edge TPU is a compact device that adds an Edge TPU coprocessor to your system. It enables low-power, high-performance ML inference for TensorFlow Lite models. Read more at the [Coral Edge TPU home page](https://coral.ai/products/accelerator). - -## Boost Raspberry Pi Model Performance with Coral Edge TPU - -Many people want to run their models on an embedded or mobile device such as a Raspberry Pi, since they are very power efficient and can be used in many different applications. However, the inference performance on these devices is usually poor even when using formats like [onnx](../integrations/onnx.md) or [openvino](../integrations/openvino.md). The Coral Edge TPU is a great solution to this problem, since it can be used with a Raspberry Pi and accelerate inference performance greatly. - -## Edge TPU on Raspberry Pi with TensorFlow Lite (New)⭐ - -The [existing guide](https://coral.ai/docs/accelerator/get-started/) by Coral on how to use the Edge TPU with a Raspberry Pi is outdated, and the current Coral Edge TPU runtime builds do not work with the current TensorFlow Lite runtime versions anymore. In addition to that, Google seems to have completely abandoned the Coral project, and there have not been any updates between 2021 and 2024. This guide will show you how to get the Edge TPU working with the latest versions of the TensorFlow Lite runtime and an updated Coral Edge TPU runtime on a Raspberry Pi single board computer (SBC). - -## Prerequisites - -- [Raspberry Pi 4B](https://www.raspberrypi.com/products/raspberry-pi-4-model-b/) (2GB or more recommended) or [Raspberry Pi 5](https://www.raspberrypi.com/products/raspberry-pi-5/) (Recommended) -- [Raspberry Pi OS](https://www.raspberrypi.com/software/) Bullseye/Bookworm (64-bit) with desktop (Recommended) -- [Coral USB Accelerator](https://coral.ai/products/accelerator/) -- A non-ARM based platform for exporting an Ultralytics PyTorch model - -## Installation Walkthrough - -This guide assumes that you already have a working Raspberry Pi OS install and have installed `ultralytics` and all dependencies. To get `ultralytics` installed, visit the [quickstart guide](../quickstart.md) to get setup before continuing here. - -### Installing the Edge TPU runtime - -First, we need to install the Edge TPU runtime. There are many different versions available, so you need to choose the right version for your operating system. - -| Raspberry Pi OS | High frequency mode | Version to download | -|-----------------|:-------------------:|--------------------------------------------| -| Bullseye 32bit | No | `libedgetpu1-std_ ... .bullseye_armhf.deb` | -| Bullseye 64bit | No | `libedgetpu1-std_ ... .bullseye_arm64.deb` | -| Bullseye 32bit | Yes | `libedgetpu1-max_ ... .bullseye_armhf.deb` | -| Bullseye 64bit | Yes | `libedgetpu1-max_ ... .bullseye_arm64.deb` | -| Bookworm 32bit | No | `libedgetpu1-std_ ... .bookworm_armhf.deb` | -| Bookworm 64bit | No | `libedgetpu1-std_ ... .bookworm_arm64.deb` | -| Bookworm 32bit | Yes | `libedgetpu1-max_ ... .bookworm_armhf.deb` | -| Bookworm 64bit | Yes | `libedgetpu1-max_ ... .bookworm_arm64.deb` | - -[Download the latest version from here](https://github.com/feranick/libedgetpu/releases). - -After downloading the file, you can install it with the following command: - -```bash -sudo dpkg -i path/to/package.deb -``` - -After installing the runtime, you need to plug in your Coral Edge TPU into a USB 3.0 port on your Raspberry Pi. This is because, according to the official guide, a new `udev` rule needs to take effect after installation. - -???+ warning "Important" - - If you already have the Coral Edge TPU runtime installed, uninstall it using the following command. - - ```bash - # If you installed the standard version - sudo apt remove libedgetpu1-std - - # If you installed the high frequency version - sudo apt remove libedgetpu1-max - ``` - -## Export your model to a Edge TPU compatible model - -To use the Edge TPU, you need to convert your model into a compatible format. It is recommended that you run export on Google Colab, x86_64 Linux machine, using the official [Ultralytics Docker container](docker-quickstart.md), or using [Ultralytics HUB](../hub/quickstart.md), since the Edge TPU compiler is not available on ARM. See the [Export Mode](../modes/export.md) for the available arguments. - -!!! Exporting the model - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('path/to/model.pt') # Load a official model or custom model - - # Export the model - model.export(format='edgetpu') - ``` - - === "CLI" - - ```bash - yolo export model=path/to/model.pt format=edgetpu # Export a official model or custom model - ``` - -The exported model will be saved in the `_saved_model/` folder with the name `_full_integer_quant_edgetpu.tflite`. - -## Running the model - -After exporting your model, you can run inference with it using the following code: - -!!! Running the model - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('path/to/edgetpu_model.tflite') # Load a official model or custom model - - # Run Prediction - model.predict("path/to/source.png") - ``` - - === "CLI" - - ```bash - yolo predict model=path/to/edgetpu_model.tflite source=path/to/source.png # Load a official model or custom model - ``` - -Find comprehensive information on the [Predict](../modes/predict.md) page for full prediction mode details. - -???+ warning "Important" - - You should run the model using `tflite-runtime` and not `tensorflow`. - If `tensorflow` is installed, uninstall tensorflow with the following command: - - ```bash - pip uninstall tensorflow tensorflow-aarch64 - ``` - - Then install/update `tflite-runtime`: - - ``` - pip install -U tflite-runtime - ``` - - If you want a `tflite-runtime` wheel for `tensorflow` 2.15.0 download it from [here](https://github.com/feranick/TFlite-builds/releases) and install it using `pip` or your package manager of choice. diff --git a/ultralytics-main/docs/en/guides/distance-calculation.md b/ultralytics-main/docs/en/guides/distance-calculation.md deleted file mode 100644 index c479d5f..0000000 --- a/ultralytics-main/docs/en/guides/distance-calculation.md +++ /dev/null @@ -1,107 +0,0 @@ ---- -comments: true -description: Distance Calculation Using Ultralytics YOLOv8 -keywords: Ultralytics, YOLOv8, Object Detection, Distance Calculation, Object Tracking, Notebook, IPython Kernel, CLI, Python SDK ---- - -# Distance Calculation using Ultralytics YOLOv8 🚀 - -## What is Distance Calculation? - -Measuring the gap between two objects is known as distance calculation within a specified space. In the case of [Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics), the bounding box centroid is employed to calculate the distance for bounding boxes highlighted by the user. - -

-
- -
- Watch: Distance Calculation using Ultralytics YOLOv8 -

- -## Visuals - -| Distance Calculation using Ultralytics YOLOv8 | -|:-----------------------------------------------------------------------------------------------------------------------------------------------:| -| ![Ultralytics YOLOv8 Distance Calculation](https://github.com/RizwanMunawar/RizwanMunawar/assets/62513924/6b6b735d-3c49-4b84-a022-2bf6e3c72f8b) | - -## Advantages of Distance Calculation? - -- **Localization Precision:** Enhances accurate spatial positioning in computer vision tasks. -- **Size Estimation:** Allows estimation of physical sizes for better contextual understanding. -- **Scene Understanding:** Contributes to a 3D understanding of the environment for improved decision-making. - -???+ tip "Distance Calculation" - - - Click on any two bounding boxes with Left Mouse click for distance calculation - -!!! Example "Distance Calculation using YOLOv8 Example" - - === "Video Stream" - - ```python - from ultralytics import YOLO - from ultralytics.solutions import distance_calculation - import cv2 - - model = YOLO("yolov8n.pt") - names = model.model.names - - cap = cv2.VideoCapture("path/to/video/file.mp4") - assert cap.isOpened(), "Error reading video file" - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - # Video writer - video_writer = cv2.VideoWriter("distance_calculation.avi", - cv2.VideoWriter_fourcc(*'mp4v'), - fps, - (w, h)) - - # Init distance-calculation obj - dist_obj = distance_calculation.DistanceCalculation() - dist_obj.set_args(names=names, view_img=True) - - while cap.isOpened(): - success, im0 = cap.read() - if not success: - print("Video frame is empty or video processing has been successfully completed.") - break - - tracks = model.track(im0, persist=True, show=False) - im0 = dist_obj.start_process(im0, tracks) - video_writer.write(im0) - - cap.release() - video_writer.release() - cv2.destroyAllWindows() - - ``` - -???+ tip "Note" - - - Mouse Right Click will delete all drawn points - - Mouse Left Click can be used to draw points - -### Optional Arguments `set_args` - -| Name | Type | Default | Description | -|------------------|--------|-----------------|--------------------------------------------------------| -| `names` | `dict` | `None` | Classes names | -| `view_img` | `bool` | `False` | Display frames with counts | -| `line_thickness` | `int` | `2` | Increase bounding boxes thickness | -| `line_color` | `RGB` | `(255, 255, 0)` | Line Color for centroids mapping on two bounding boxes | -| `centroid_color` | `RGB` | `(255, 0, 255)` | Centroid color for each bounding box | - -### Arguments `model.track` - -| Name | Type | Default | Description | -|-----------|---------|----------------|-------------------------------------------------------------| -| `source` | `im0` | `None` | source directory for images or videos | -| `persist` | `bool` | `False` | persisting tracks between frames | -| `tracker` | `str` | `botsort.yaml` | Tracking method 'bytetrack' or 'botsort' | -| `conf` | `float` | `0.3` | Confidence Threshold | -| `iou` | `float` | `0.5` | IOU Threshold | -| `classes` | `list` | `None` | filter results by class, i.e. classes=0, or classes=[0,2,3] | -| `verbose` | `bool` | `True` | Display the object tracking results | diff --git a/ultralytics-main/docs/en/guides/docker-quickstart.md b/ultralytics-main/docs/en/guides/docker-quickstart.md deleted file mode 100644 index 6c45268..0000000 --- a/ultralytics-main/docs/en/guides/docker-quickstart.md +++ /dev/null @@ -1,119 +0,0 @@ ---- -comments: true -description: Complete guide to setting up and using Ultralytics YOLO models with Docker. Learn how to install Docker, manage GPU support, and run YOLO models in isolated containers. -keywords: Ultralytics, YOLO, Docker, GPU, containerization, object detection, package installation, deep learning, machine learning, guide ---- - -# Docker Quickstart Guide for Ultralytics - -

- Ultralytics Docker Package Visual -

- -This guide serves as a comprehensive introduction to setting up a Docker environment for your Ultralytics projects. [Docker](https://docker.com/) is a platform for developing, shipping, and running applications in containers. It is particularly beneficial for ensuring that the software will always run the same, regardless of where it's deployed. For more details, visit the Ultralytics Docker repository on [Docker Hub](https://hub.docker.com/r/ultralytics/ultralytics). - -[![Docker Pulls](https://img.shields.io/docker/pulls/ultralytics/ultralytics?logo=docker)](https://hub.docker.com/r/ultralytics/ultralytics) - -## What You Will Learn - -- Setting up Docker with NVIDIA support -- Installing Ultralytics Docker images -- Running Ultralytics in a Docker container -- Mounting local directories into the container - ---- - -## Prerequisites - -- Make sure Docker is installed on your system. If not, you can download and install it from [Docker's website](https://www.docker.com/products/docker-desktop). -- Ensure that your system has an NVIDIA GPU and NVIDIA drivers are installed. - ---- - -## Setting up Docker with NVIDIA Support - -First, verify that the NVIDIA drivers are properly installed by running: - -```bash -nvidia-smi -``` - -### Installing NVIDIA Docker Runtime - -Now, let's install the NVIDIA Docker runtime to enable GPU support in Docker containers: - -```bash -# Add NVIDIA package repositories -curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add - -distribution=$(lsb_release -cs) -curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list - -# Install NVIDIA Docker runtime -sudo apt-get update -sudo apt-get install -y nvidia-docker2 - -# Restart Docker service to apply changes -sudo systemctl restart docker -``` - -### Verify NVIDIA Runtime with Docker - -Run `docker info | grep -i runtime` to ensure that `nvidia` appears in the list of runtimes: - -```bash -docker info | grep -i runtime -``` - ---- - -## Installing Ultralytics Docker Images - -Ultralytics offers several Docker images optimized for various platforms and use-cases: - -- **Dockerfile:** GPU image, ideal for training. -- **Dockerfile-arm64:** For ARM64 architecture, suitable for devices like [Raspberry Pi](raspberry-pi.md). -- **Dockerfile-cpu:** CPU-only version for inference and non-GPU environments. -- **Dockerfile-jetson:** Optimized for NVIDIA Jetson devices. -- **Dockerfile-python:** Minimal Python environment for lightweight applications. -- **Dockerfile-conda:** Includes [Miniconda3](https://docs.conda.io/projects/miniconda/en/latest/) and Ultralytics package installed via Conda. - -To pull the latest image: - -```bash -# Set image name as a variable -t=ultralytics/ultralytics:latest - -# Pull the latest Ultralytics image from Docker Hub -sudo docker pull $t -``` - ---- - -## Running Ultralytics in Docker Container - -Here's how to execute the Ultralytics Docker container: - -```bash -# Run with all GPUs -sudo docker run -it --ipc=host --gpus all $t - -# Run specifying which GPUs to use -sudo docker run -it --ipc=host --gpus '"device=2,3"' $t -``` - -The `-it` flag assigns a pseudo-TTY and keeps stdin open, allowing you to interact with the container. The `--ipc=host` flag enables sharing of host's IPC namespace, essential for sharing memory between processes. The `--gpus` flag allows the container to access the host's GPUs. - -### Note on File Accessibility - -To work with files on your local machine within the container, you can use Docker volumes: - -```bash -# Mount a local directory into the container -sudo docker run -it --ipc=host --gpus all -v /path/on/host:/path/in/container $t -``` - -Replace `/path/on/host` with the directory path on your local machine and `/path/in/container` with the desired path inside the Docker container. - ---- - -Congratulations! You're now set up to use Ultralytics with Docker and ready to take advantage of its powerful capabilities. For alternate installation methods, feel free to explore the [Ultralytics quickstart documentation](../quickstart.md). diff --git a/ultralytics-main/docs/en/guides/heatmaps.md b/ultralytics-main/docs/en/guides/heatmaps.md deleted file mode 100644 index 3b8b911..0000000 --- a/ultralytics-main/docs/en/guides/heatmaps.md +++ /dev/null @@ -1,301 +0,0 @@ ---- -comments: true -description: Advanced Data Visualization with Ultralytics YOLOv8 Heatmaps -keywords: Ultralytics, YOLOv8, Advanced Data Visualization, Heatmap Technology, Object Detection and Tracking, Jupyter Notebook, Python SDK, Command Line Interface ---- - -# Advanced Data Visualization: Heatmaps using Ultralytics YOLOv8 🚀 - -## Introduction to Heatmaps - -A heatmap generated with [Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics/) transforms complex data into a vibrant, color-coded matrix. This visual tool employs a spectrum of colors to represent varying data values, where warmer hues indicate higher intensities and cooler tones signify lower values. Heatmaps excel in visualizing intricate data patterns, correlations, and anomalies, offering an accessible and engaging approach to data interpretation across diverse domains. - -

-
- -
- Watch: Heatmaps using Ultralytics YOLOv8 -

- -## Why Choose Heatmaps for Data Analysis? - -- **Intuitive Data Distribution Visualization:** Heatmaps simplify the comprehension of data concentration and distribution, converting complex datasets into easy-to-understand visual formats. -- **Efficient Pattern Detection:** By visualizing data in heatmap format, it becomes easier to spot trends, clusters, and outliers, facilitating quicker analysis and insights. -- **Enhanced Spatial Analysis and Decision-Making:** Heatmaps are instrumental in illustrating spatial relationships, aiding in decision-making processes in sectors such as business intelligence, environmental studies, and urban planning. - -## Real World Applications - -| Transportation | Retail | -|:-----------------------------------------------------------------------------------------------------------------------------------------------:|:---------------------------------------------------------------------------------------------------------------------------------------:| -| ![Ultralytics YOLOv8 Transportation Heatmap](https://github.com/RizwanMunawar/ultralytics/assets/62513924/288d7053-622b-4452-b4e4-1f41aeb764aa) | ![Ultralytics YOLOv8 Retail Heatmap](https://github.com/RizwanMunawar/ultralytics/assets/62513924/edef75ad-50a7-4c0a-be4a-a66cdfc12802) | -| Ultralytics YOLOv8 Transportation Heatmap | Ultralytics YOLOv8 Retail Heatmap | - -!!! tip "Heatmap Configuration" - - - `heatmap_alpha`: Ensure this value is within the range (0.0 - 1.0). - - `decay_factor`: Used for removing heatmap after an object is no longer in the frame, its value should also be in the range (0.0 - 1.0). - -!!! Example "Heatmaps using Ultralytics YOLOv8 Example" - - === "Heatmap" - - ```python - from ultralytics import YOLO - from ultralytics.solutions import heatmap - import cv2 - - model = YOLO("yolov8n.pt") - cap = cv2.VideoCapture("path/to/video/file.mp4") - assert cap.isOpened(), "Error reading video file" - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - # Video writer - video_writer = cv2.VideoWriter("heatmap_output.avi", - cv2.VideoWriter_fourcc(*'mp4v'), - fps, - (w, h)) - - # Init heatmap - heatmap_obj = heatmap.Heatmap() - heatmap_obj.set_args(colormap=cv2.COLORMAP_PARULA, - imw=w, - imh=h, - view_img=True, - shape="circle") - - while cap.isOpened(): - success, im0 = cap.read() - if not success: - print("Video frame is empty or video processing has been successfully completed.") - break - tracks = model.track(im0, persist=True, show=False) - - im0 = heatmap_obj.generate_heatmap(im0, tracks) - video_writer.write(im0) - - cap.release() - video_writer.release() - cv2.destroyAllWindows() - - ``` - - === "Line Counting" - - ```python - from ultralytics import YOLO - from ultralytics.solutions import heatmap - import cv2 - - model = YOLO("yolov8n.pt") - cap = cv2.VideoCapture("path/to/video/file.mp4") - assert cap.isOpened(), "Error reading video file" - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - # Video writer - video_writer = cv2.VideoWriter("heatmap_output.avi", - cv2.VideoWriter_fourcc(*'mp4v'), - fps, - (w, h)) - - line_points = [(20, 400), (1080, 404)] # line for object counting - - # Init heatmap - heatmap_obj = heatmap.Heatmap() - heatmap_obj.set_args(colormap=cv2.COLORMAP_PARULA, - imw=w, - imh=h, - view_img=True, - shape="circle", - count_reg_pts=line_points) - - while cap.isOpened(): - success, im0 = cap.read() - if not success: - print("Video frame is empty or video processing has been successfully completed.") - break - tracks = model.track(im0, persist=True, show=False) - - im0 = heatmap_obj.generate_heatmap(im0, tracks) - video_writer.write(im0) - - cap.release() - video_writer.release() - cv2.destroyAllWindows() - ``` - - === "Region Counting" - - ```python - from ultralytics import YOLO - from ultralytics.solutions import heatmap - import cv2 - - model = YOLO("yolov8n.pt") - cap = cv2.VideoCapture("path/to/video/file.mp4") - assert cap.isOpened(), "Error reading video file" - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - # Video writer - video_writer = cv2.VideoWriter("heatmap_output.avi", - cv2.VideoWriter_fourcc(*'mp4v'), - fps, - (w, h)) - - # Define region points - region_points = [(20, 400), (1080, 404), (1080, 360), (20, 360)] - - # Init heatmap - heatmap_obj = heatmap.Heatmap() - heatmap_obj.set_args(colormap=cv2.COLORMAP_PARULA, - imw=w, - imh=h, - view_img=True, - shape="circle", - count_reg_pts=region_points) - - while cap.isOpened(): - success, im0 = cap.read() - if not success: - print("Video frame is empty or video processing has been successfully completed.") - break - tracks = model.track(im0, persist=True, show=False) - - im0 = heatmap_obj.generate_heatmap(im0, tracks) - video_writer.write(im0) - - cap.release() - video_writer.release() - cv2.destroyAllWindows() - ``` - - === "Im0" - - ```python - from ultralytics import YOLO - from ultralytics.solutions import heatmap - import cv2 - - model = YOLO("yolov8s.pt") # YOLOv8 custom/pretrained model - - im0 = cv2.imread("path/to/image.png") # path to image file - h, w = im0.shape[:2] # image height and width - - # Heatmap Init - heatmap_obj = heatmap.Heatmap() - heatmap_obj.set_args(colormap=cv2.COLORMAP_PARULA, - imw=w, - imh=h, - view_img=True, - shape="circle") - - results = model.track(im0, persist=True) - im0 = heatmap_obj.generate_heatmap(im0, tracks=results) - cv2.imwrite("ultralytics_output.png", im0) - ``` - - === "Specific Classes" - - ```python - from ultralytics import YOLO - from ultralytics.solutions import heatmap - import cv2 - - model = YOLO("yolov8n.pt") - cap = cv2.VideoCapture("path/to/video/file.mp4") - assert cap.isOpened(), "Error reading video file" - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - # Video writer - video_writer = cv2.VideoWriter("heatmap_output.avi", - cv2.VideoWriter_fourcc(*'mp4v'), - fps, - (w, h)) - - classes_for_heatmap = [0, 2] # classes for heatmap - - # Init heatmap - heatmap_obj = heatmap.Heatmap() - heatmap_obj.set_args(colormap=cv2.COLORMAP_PARULA, - imw=w, - imh=h, - view_img=True, - shape="circle") - - while cap.isOpened(): - success, im0 = cap.read() - if not success: - print("Video frame is empty or video processing has been successfully completed.") - break - tracks = model.track(im0, persist=True, show=False, - classes=classes_for_heatmap) - - im0 = heatmap_obj.generate_heatmap(im0, tracks) - video_writer.write(im0) - - cap.release() - video_writer.release() - cv2.destroyAllWindows() - ``` - -### Arguments `set_args` - -| Name | Type | Default | Description | -|-----------------------|----------------|-------------------|-----------------------------------------------------------| -| `view_img` | `bool` | `False` | Display the frame with heatmap | -| `colormap` | `cv2.COLORMAP` | `None` | cv2.COLORMAP for heatmap | -| `imw` | `int` | `None` | Width of Heatmap | -| `imh` | `int` | `None` | Height of Heatmap | -| `heatmap_alpha` | `float` | `0.5` | Heatmap alpha value | -| `count_reg_pts` | `list` | `None` | Object counting region points | -| `count_txt_thickness` | `int` | `2` | Count values text size | -| `count_txt_color` | `RGB Color` | `(0, 0, 0)` | Foreground color for Object counts text | -| `count_color` | `RGB Color` | `(255, 255, 255)` | Background color for Object counts text | -| `count_reg_color` | `RGB Color` | `(255, 0, 255)` | Counting region color | -| `region_thickness` | `int` | `5` | Counting region thickness value | -| `decay_factor` | `float` | `0.99` | Decay factor for heatmap area removal after specific time | -| `shape` | `str` | `circle` | Heatmap shape for display "rect" or "circle" supported | -| `line_dist_thresh` | `int` | `15` | Euclidean Distance threshold for line counter | - -### Arguments `model.track` - -| Name | Type | Default | Description | -|-----------|---------|----------------|-------------------------------------------------------------| -| `source` | `im0` | `None` | source directory for images or videos | -| `persist` | `bool` | `False` | persisting tracks between frames | -| `tracker` | `str` | `botsort.yaml` | Tracking method 'bytetrack' or 'botsort' | -| `conf` | `float` | `0.3` | Confidence Threshold | -| `iou` | `float` | `0.5` | IOU Threshold | -| `classes` | `list` | `None` | filter results by class, i.e. classes=0, or classes=[0,2,3] | - -### Heatmap COLORMAPs - -| Colormap Name | Description | -|---------------------------------|----------------------------------------| -| `cv::COLORMAP_AUTUMN` | Autumn color map | -| `cv::COLORMAP_BONE` | Bone color map | -| `cv::COLORMAP_JET` | Jet color map | -| `cv::COLORMAP_WINTER` | Winter color map | -| `cv::COLORMAP_RAINBOW` | Rainbow color map | -| `cv::COLORMAP_OCEAN` | Ocean color map | -| `cv::COLORMAP_SUMMER` | Summer color map | -| `cv::COLORMAP_SPRING` | Spring color map | -| `cv::COLORMAP_COOL` | Cool color map | -| `cv::COLORMAP_HSV` | HSV (Hue, Saturation, Value) color map | -| `cv::COLORMAP_PINK` | Pink color map | -| `cv::COLORMAP_HOT` | Hot color map | -| `cv::COLORMAP_PARULA` | Parula color map | -| `cv::COLORMAP_MAGMA` | Magma color map | -| `cv::COLORMAP_INFERNO` | Inferno color map | -| `cv::COLORMAP_PLASMA` | Plasma color map | -| `cv::COLORMAP_VIRIDIS` | Viridis color map | -| `cv::COLORMAP_CIVIDIS` | Cividis color map | -| `cv::COLORMAP_TWILIGHT` | Twilight color map | -| `cv::COLORMAP_TWILIGHT_SHIFTED` | Shifted Twilight color map | -| `cv::COLORMAP_TURBO` | Turbo color map | -| `cv::COLORMAP_DEEPGREEN` | Deep Green color map | - -These colormaps are commonly used for visualizing data with different color representations. diff --git a/ultralytics-main/docs/en/guides/hyperparameter-tuning.md b/ultralytics-main/docs/en/guides/hyperparameter-tuning.md deleted file mode 100644 index 4888c34..0000000 --- a/ultralytics-main/docs/en/guides/hyperparameter-tuning.md +++ /dev/null @@ -1,206 +0,0 @@ ---- -comments: true -description: Dive into hyperparameter tuning in Ultralytics YOLO models. Learn how to optimize performance using the Tuner class and genetic evolution. -keywords: Ultralytics, YOLO, Hyperparameter Tuning, Tuner Class, Genetic Evolution, Optimization ---- - -# Ultralytics YOLO Hyperparameter Tuning Guide - -## Introduction - -Hyperparameter tuning is not just a one-time set-up but an iterative process aimed at optimizing the machine learning model's performance metrics, such as accuracy, precision, and recall. In the context of Ultralytics YOLO, these hyperparameters could range from learning rate to architectural details, such as the number of layers or types of activation functions used. - -### What are Hyperparameters? - -Hyperparameters are high-level, structural settings for the algorithm. They are set prior to the training phase and remain constant during it. Here are some commonly tuned hyperparameters in Ultralytics YOLO: - -- **Learning Rate** `lr0`: Determines the step size at each iteration while moving towards a minimum in the loss function. -- **Batch Size** `batch`: Number of images processed simultaneously in a forward pass. -- **Number of Epochs** `epochs`: An epoch is one complete forward and backward pass of all the training examples. -- **Architecture Specifics**: Such as channel counts, number of layers, types of activation functions, etc. - -

- Hyperparameter Tuning Visual -

- -For a full list of augmentation hyperparameters used in YOLOv8 please refer to the [configurations page](../usage/cfg.md#augmentation-settings). - -### Genetic Evolution and Mutation - -Ultralytics YOLO uses genetic algorithms to optimize hyperparameters. Genetic algorithms are inspired by the mechanism of natural selection and genetics. - -- **Mutation**: In the context of Ultralytics YOLO, mutation helps in locally searching the hyperparameter space by applying small, random changes to existing hyperparameters, producing new candidates for evaluation. -- **Crossover**: Although crossover is a popular genetic algorithm technique, it is not currently used in Ultralytics YOLO for hyperparameter tuning. The focus is mainly on mutation for generating new hyperparameter sets. - -## Preparing for Hyperparameter Tuning - -Before you begin the tuning process, it's important to: - -1. **Identify the Metrics**: Determine the metrics you will use to evaluate the model's performance. This could be AP50, F1-score, or others. -2. **Set the Tuning Budget**: Define how much computational resources you're willing to allocate. Hyperparameter tuning can be computationally intensive. - -## Steps Involved - -### Initialize Hyperparameters - -Start with a reasonable set of initial hyperparameters. This could either be the default hyperparameters set by Ultralytics YOLO or something based on your domain knowledge or previous experiments. - -### Mutate Hyperparameters - -Use the `_mutate` method to produce a new set of hyperparameters based on the existing set. - -### Train Model - -Training is performed using the mutated set of hyperparameters. The training performance is then assessed. - -### Evaluate Model - -Use metrics like AP50, F1-score, or custom metrics to evaluate the model's performance. - -### Log Results - -It's crucial to log both the performance metrics and the corresponding hyperparameters for future reference. - -### Repeat - -The process is repeated until either the set number of iterations is reached or the performance metric is satisfactory. - -## Usage Example - -Here's how to use the `model.tune()` method to utilize the `Tuner` class for hyperparameter tuning of YOLOv8n on COCO8 for 30 epochs with an AdamW optimizer and skipping plotting, checkpointing and validation other than on final epoch for faster Tuning. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Initialize the YOLO model - model = YOLO('yolov8n.pt') - - # Tune hyperparameters on COCO8 for 30 epochs - model.tune(data='coco8.yaml', epochs=30, iterations=300, optimizer='AdamW', plots=False, save=False, val=False) - ``` - -## Results - -After you've successfully completed the hyperparameter tuning process, you will obtain several files and directories that encapsulate the results of the tuning. The following describes each: - -### File Structure - -Here's what the directory structure of the results will look like. Training directories like `train1/` contain individual tuning iterations, i.e. one model trained with one set of hyperparameters. The `tune/` directory contains tuning results from all the individual model trainings: - -```plaintext -runs/ -└── detect/ - ├── train1/ - ├── train2/ - ├── ... - └── tune/ - ├── best_hyperparameters.yaml - ├── best_fitness.png - ├── tune_results.csv - ├── tune_scatter_plots.png - └── weights/ - ├── last.pt - └── best.pt -``` - -### File Descriptions - -#### best_hyperparameters.yaml - -This YAML file contains the best-performing hyperparameters found during the tuning process. You can use this file to initialize future trainings with these optimized settings. - -- **Format**: YAML -- **Usage**: Hyperparameter results -- **Example**: - ```yaml - # 558/900 iterations complete ✅ (45536.81s) - # Results saved to /usr/src/ultralytics/runs/detect/tune - # Best fitness=0.64297 observed at iteration 498 - # Best fitness metrics are {'metrics/precision(B)': 0.87247, 'metrics/recall(B)': 0.71387, 'metrics/mAP50(B)': 0.79106, 'metrics/mAP50-95(B)': 0.62651, 'val/box_loss': 2.79884, 'val/cls_loss': 2.72386, 'val/dfl_loss': 0.68503, 'fitness': 0.64297} - # Best fitness model is /usr/src/ultralytics/runs/detect/train498 - # Best fitness hyperparameters are printed below. - - lr0: 0.00269 - lrf: 0.00288 - momentum: 0.73375 - weight_decay: 0.00015 - warmup_epochs: 1.22935 - warmup_momentum: 0.1525 - box: 18.27875 - cls: 1.32899 - dfl: 0.56016 - hsv_h: 0.01148 - hsv_s: 0.53554 - hsv_v: 0.13636 - degrees: 0.0 - translate: 0.12431 - scale: 0.07643 - shear: 0.0 - perspective: 0.0 - flipud: 0.0 - fliplr: 0.08631 - mosaic: 0.42551 - mixup: 0.0 - copy_paste: 0.0 - ``` - -#### best_fitness.png - -This is a plot displaying fitness (typically a performance metric like AP50) against the number of iterations. It helps you visualize how well the genetic algorithm performed over time. - -- **Format**: PNG -- **Usage**: Performance visualization - -

- Hyperparameter Tuning Fitness vs Iteration -

- -#### tune_results.csv - -A CSV file containing detailed results of each iteration during the tuning. Each row in the file represents one iteration, and it includes metrics like fitness score, precision, recall, as well as the hyperparameters used. - -- **Format**: CSV -- **Usage**: Per-iteration results tracking. -- **Example**: - ```csv - fitness,lr0,lrf,momentum,weight_decay,warmup_epochs,warmup_momentum,box,cls,dfl,hsv_h,hsv_s,hsv_v,degrees,translate,scale,shear,perspective,flipud,fliplr,mosaic,mixup,copy_paste - 0.05021,0.01,0.01,0.937,0.0005,3.0,0.8,7.5,0.5,1.5,0.015,0.7,0.4,0.0,0.1,0.5,0.0,0.0,0.0,0.5,1.0,0.0,0.0 - 0.07217,0.01003,0.00967,0.93897,0.00049,2.79757,0.81075,7.5,0.50746,1.44826,0.01503,0.72948,0.40658,0.0,0.0987,0.4922,0.0,0.0,0.0,0.49729,1.0,0.0,0.0 - 0.06584,0.01003,0.00855,0.91009,0.00073,3.42176,0.95,8.64301,0.54594,1.72261,0.01503,0.59179,0.40658,0.0,0.0987,0.46955,0.0,0.0,0.0,0.49729,0.80187,0.0,0.0 - ``` - -#### tune_scatter_plots.png - -This file contains scatter plots generated from `tune_results.csv`, helping you visualize relationships between different hyperparameters and performance metrics. Note that hyperparameters initialized to 0 will not be tuned, such as `degrees` and `shear` below. - -- **Format**: PNG -- **Usage**: Exploratory data analysis - -

- Hyperparameter Tuning Scatter Plots -

- -#### weights/ - -This directory contains the saved PyTorch models for the last and the best iterations during the hyperparameter tuning process. - -- **`last.pt`**: The last.pt are the weights from the last epoch of training. -- **`best.pt`**: The best.pt weights for the iteration that achieved the best fitness score. - -Using these results, you can make more informed decisions for your future model trainings and analyses. Feel free to consult these artifacts to understand how well your model performed and how you might improve it further. - -## Conclusion - -The hyperparameter tuning process in Ultralytics YOLO is simplified yet powerful, thanks to its genetic algorithm-based approach focused on mutation. Following the steps outlined in this guide will assist you in systematically tuning your model to achieve better performance. - -### Further Reading - -1. [Hyperparameter Optimization in Wikipedia](https://en.wikipedia.org/wiki/Hyperparameter_optimization) -2. [YOLOv5 Hyperparameter Evolution Guide](../yolov5/tutorials/hyperparameter_evolution.md) -3. [Efficient Hyperparameter Tuning with Ray Tune and YOLOv8](../integrations/ray-tune.md) - -For deeper insights, you can explore the `Tuner` class source code and accompanying documentation. Should you have any questions, feature requests, or need further assistance, feel free to reach out to us on [GitHub](https://github.com/ultralytics/ultralytics/issues/new/choose) or [Discord](https://ultralytics.com/discord). diff --git a/ultralytics-main/docs/en/guides/index.md b/ultralytics-main/docs/en/guides/index.md deleted file mode 100644 index 62c2ccb..0000000 --- a/ultralytics-main/docs/en/guides/index.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -comments: true -description: In-depth exploration of Ultralytics' YOLO. Learn about the YOLO object detection model, how to train it on custom data, multi-GPU training, exporting, predicting, deploying, and more. -keywords: Ultralytics, YOLO, Deep Learning, Object detection, PyTorch, Tutorial, Multi-GPU training, Custom data training, SAHI, Tiled Inference ---- - -# Comprehensive Tutorials to Ultralytics YOLO - -Welcome to the Ultralytics' YOLO 🚀 Guides! Our comprehensive tutorials cover various aspects of the YOLO object detection model, ranging from training and prediction to deployment. Built on PyTorch, YOLO stands out for its exceptional speed and accuracy in real-time object detection tasks. - -Whether you're a beginner or an expert in deep learning, our tutorials offer valuable insights into the implementation and optimization of YOLO for your computer vision projects. Let's dive in! - -

-
- -
- Watch: Ultralytics YOLOv8 Guides Overview -

- -## Guides - -Here's a compilation of in-depth guides to help you master different aspects of Ultralytics YOLO. - -- [YOLO Common Issues](yolo-common-issues.md) ⭐ RECOMMENDED: Practical solutions and troubleshooting tips to the most frequently encountered issues when working with Ultralytics YOLO models. -- [YOLO Performance Metrics](yolo-performance-metrics.md) ⭐ ESSENTIAL: Understand the key metrics like mAP, IoU, and F1 score used to evaluate the performance of your YOLO models. Includes practical examples and tips on how to improve detection accuracy and speed. -- [Model Deployment Options](model-deployment-options.md): Overview of YOLO model deployment formats like ONNX, OpenVINO, and TensorRT, with pros and cons for each to inform your deployment strategy. -- [K-Fold Cross Validation](kfold-cross-validation.md) 🚀 NEW: Learn how to improve model generalization using K-Fold cross-validation technique. -- [Hyperparameter Tuning](hyperparameter-tuning.md) 🚀 NEW: Discover how to optimize your YOLO models by fine-tuning hyperparameters using the Tuner class and genetic evolution algorithms. -- [SAHI Tiled Inference](sahi-tiled-inference.md) 🚀 NEW: Comprehensive guide on leveraging SAHI's sliced inference capabilities with YOLOv8 for object detection in high-resolution images. -- [AzureML Quickstart](azureml-quickstart.md) 🚀 NEW: Get up and running with Ultralytics YOLO models on Microsoft's Azure Machine Learning platform. Learn how to train, deploy, and scale your object detection projects in the cloud. -- [Conda Quickstart](conda-quickstart.md) 🚀 NEW: Step-by-step guide to setting up a [Conda](https://anaconda.org/conda-forge/ultralytics) environment for Ultralytics. Learn how to install and start using the Ultralytics package efficiently with Conda. -- [Docker Quickstart](docker-quickstart.md) 🚀 NEW: Complete guide to setting up and using Ultralytics YOLO models with [Docker](https://hub.docker.com/r/ultralytics/ultralytics). Learn how to install Docker, manage GPU support, and run YOLO models in isolated containers for consistent development and deployment. -- [Raspberry Pi](raspberry-pi.md) 🚀 NEW: Quickstart tutorial to run YOLO models to the latest Raspberry Pi hardware. -- [Triton Inference Server Integration](triton-inference-server.md) 🚀 NEW: Dive into the integration of Ultralytics YOLOv8 with NVIDIA's Triton Inference Server for scalable and efficient deep learning inference deployments. -- [YOLO Thread-Safe Inference](yolo-thread-safe-inference.md) 🚀 NEW: Guidelines for performing inference with YOLO models in a thread-safe manner. Learn the importance of thread safety and best practices to prevent race conditions and ensure consistent predictions. -- [Isolating Segmentation Objects](isolating-segmentation-objects.md) 🚀 NEW: Step-by-step recipe and explanation on how to extract and/or isolate objects from images using Ultralytics Segmentation. -- [Edge TPU on Raspberry Pi](coral-edge-tpu-on-raspberry-pi.md): [Google Edge TPU](https://coral.ai/products/accelerator) accelerates YOLO inference on [Raspberry Pi](https://www.raspberrypi.com/). -- [View Inference Images in a Terminal](view-results-in-terminal.md): Use VSCode's integrated terminal to view inference results when using Remote Tunnel or SSH sessions. -- [OpenVINO Latency vs Throughput Modes](optimizing-openvino-latency-vs-throughput-modes.md) - Learn latency and throughput optimization techniques for peak YOLO inference performance. - -## Real-World Projects - -- [Object Counting](object-counting.md) 🚀 NEW: Explore the process of real-time object counting with Ultralytics YOLOv8 and acquire the knowledge to effectively count objects in a live video stream. -- [Object Cropping](object-cropping.md) 🚀 NEW: Explore object cropping using YOLOv8 for precise extraction of objects from images and videos. -- [Object Blurring](object-blurring.md) 🚀 NEW: Apply object blurring with YOLOv8 for privacy protection in image and video processing. -- [Workouts Monitoring](workouts-monitoring.md) 🚀 NEW: Discover the comprehensive approach to monitoring workouts with Ultralytics YOLOv8. Acquire the skills and insights necessary to effectively use YOLOv8 for tracking and analyzing various aspects of fitness routines in real time. -- [Objects Counting in Regions](region-counting.md) 🚀 NEW: Explore counting objects in specific regions with Ultralytics YOLOv8 for precise and efficient object detection in varied areas. -- [Security Alarm System](security-alarm-system.md) 🚀 NEW: Discover the process of creating a security alarm system with Ultralytics YOLOv8. This system triggers alerts upon detecting new objects in the frame. Subsequently, you can customize the code to align with your specific use case. -- [Heatmaps](heatmaps.md) 🚀 NEW: Elevate your understanding of data with our Detection Heatmaps! These intuitive visual tools use vibrant color gradients to vividly illustrate the intensity of data values across a matrix. Essential in computer vision, heatmaps are skillfully designed to highlight areas of interest, providing an immediate, impactful way to interpret spatial information. -- [Instance Segmentation with Object Tracking](instance-segmentation-and-tracking.md) 🚀 NEW: Explore our feature on [Object Segmentation](https://docs.ultralytics.com/tasks/segment/) in Bounding Boxes Shape, providing a visual representation of precise object boundaries for enhanced understanding and analysis. -- [VisionEye View Objects Mapping](vision-eye.md) 🚀 NEW: This feature aim computers to discern and focus on specific objects, much like the way the human eye observes details from a particular viewpoint. -- [Speed Estimation](speed-estimation.md) 🚀 NEW: Speed estimation in computer vision relies on analyzing object motion through techniques like [object tracking](https://docs.ultralytics.com/modes/track/), crucial for applications like autonomous vehicles and traffic monitoring. -- [Distance Calculation](distance-calculation.md) 🚀 NEW: Distance calculation, which involves measuring the separation between two objects within a defined space, is a crucial aspect. In the context of Ultralytics YOLOv8, the method employed for this involves using the bounding box centroid to determine the distance associated with user-highlighted bounding boxes. - -## Contribute to Our Guides - -We welcome contributions from the community! If you've mastered a particular aspect of Ultralytics YOLO that's not yet covered in our guides, we encourage you to share your expertise. Writing a guide is a great way to give back to the community and help us make our documentation more comprehensive and user-friendly. - -To get started, please read our [Contributing Guide](../help/contributing.md) for guidelines on how to open up a Pull Request (PR) 🛠️. We look forward to your contributions! - -Let's work together to make the Ultralytics YOLO ecosystem more robust and versatile 🙏! diff --git a/ultralytics-main/docs/en/guides/instance-segmentation-and-tracking.md b/ultralytics-main/docs/en/guides/instance-segmentation-and-tracking.md deleted file mode 100644 index 558ab57..0000000 --- a/ultralytics-main/docs/en/guides/instance-segmentation-and-tracking.md +++ /dev/null @@ -1,140 +0,0 @@ ---- -comments: true -description: Instance Segmentation with Object Tracking using Ultralytics YOLOv8 -keywords: Ultralytics, YOLOv8, Instance Segmentation, Object Detection, Object Tracking, Bounding Box, Computer Vision, Notebook, IPython Kernel, CLI, Python SDK ---- - -# Instance Segmentation and Tracking using Ultralytics YOLOv8 🚀 - -## What is Instance Segmentation? - -[Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics/) instance segmentation involves identifying and outlining individual objects in an image, providing a detailed understanding of spatial distribution. Unlike semantic segmentation, it uniquely labels and precisely delineates each object, crucial for tasks like object detection and medical imaging. - -There are two types of instance segmentation tracking available in the Ultralytics package: - -- **Instance Segmentation with Class Objects:** Each class object is assigned a unique color for clear visual separation. - -- **Instance Segmentation with Object Tracks:** Every track is represented by a distinct color, facilitating easy identification and tracking. - -

-
- -
- Watch: Instance Segmentation with Object Tracking using Ultralytics YOLOv8 -

- -## Samples - -| Instance Segmentation | Instance Segmentation + Object Tracking | -|:---------------------------------------------------------------------------------------------------------------------------------------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------:| -| ![Ultralytics Instance Segmentation](https://github.com/RizwanMunawar/ultralytics/assets/62513924/d4ad3499-1f33-4871-8fbc-1be0b2643aa2) | ![Ultralytics Instance Segmentation with Object Tracking](https://github.com/RizwanMunawar/ultralytics/assets/62513924/2e5c38cc-fd5c-4145-9682-fa94ae2010a0) | -| Ultralytics Instance Segmentation 😍 | Ultralytics Instance Segmentation with Object Tracking 🔥 | - -!!! Example "Instance Segmentation and Tracking" - - === "Instance Segmentation" - - ```python - import cv2 - from ultralytics import YOLO - from ultralytics.utils.plotting import Annotator, colors - - model = YOLO("yolov8n-seg.pt") # segmentation model - names = model.model.names - cap = cv2.VideoCapture("path/to/video/file.mp4") - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - out = cv2.VideoWriter('instance-segmentation.avi', cv2.VideoWriter_fourcc(*'MJPG'), fps, (w, h)) - - while True: - ret, im0 = cap.read() - if not ret: - print("Video frame is empty or video processing has been successfully completed.") - break - - results = model.predict(im0) - annotator = Annotator(im0, line_width=2) - - if results[0].masks is not None: - clss = results[0].boxes.cls.cpu().tolist() - masks = results[0].masks.xy - for mask, cls in zip(masks, clss): - annotator.seg_bbox(mask=mask, - mask_color=colors(int(cls), True), - det_label=names[int(cls)]) - - out.write(im0) - cv2.imshow("instance-segmentation", im0) - - if cv2.waitKey(1) & 0xFF == ord('q'): - break - - out.release() - cap.release() - cv2.destroyAllWindows() - - ``` - - === "Instance Segmentation with Object Tracking" - - ```python - import cv2 - from ultralytics import YOLO - from ultralytics.utils.plotting import Annotator, colors - - from collections import defaultdict - - track_history = defaultdict(lambda: []) - - model = YOLO("yolov8n-seg.pt") # segmentation model - cap = cv2.VideoCapture("path/to/video/file.mp4") - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - out = cv2.VideoWriter('instance-segmentation-object-tracking.avi', cv2.VideoWriter_fourcc(*'MJPG'), fps, (w, h)) - - while True: - ret, im0 = cap.read() - if not ret: - print("Video frame is empty or video processing has been successfully completed.") - break - - annotator = Annotator(im0, line_width=2) - - results = model.track(im0, persist=True) - - if results[0].boxes.id is not None and results[0].masks is not None: - masks = results[0].masks.xy - track_ids = results[0].boxes.id.int().cpu().tolist() - - for mask, track_id in zip(masks, track_ids): - annotator.seg_bbox(mask=mask, - mask_color=colors(track_id, True), - track_label=str(track_id)) - - out.write(im0) - cv2.imshow("instance-segmentation-object-tracking", im0) - - if cv2.waitKey(1) & 0xFF == ord('q'): - break - - out.release() - cap.release() - cv2.destroyAllWindows() - ``` - -### `seg_bbox` Arguments - -| Name | Type | Default | Description | -|---------------|---------|-----------------|----------------------------------------| -| `mask` | `array` | `None` | Segmentation mask coordinates | -| `mask_color` | `tuple` | `(255, 0, 255)` | Mask color for every segmented box | -| `det_label` | `str` | `None` | Label for segmented object | -| `track_label` | `str` | `None` | Label for segmented and tracked object | - -## Note - -For any inquiries, feel free to post your questions in the [Ultralytics Issue Section](https://github.com/ultralytics/ultralytics/issues/new/choose) or the discussion section mentioned below. diff --git a/ultralytics-main/docs/en/guides/isolating-segmentation-objects.md b/ultralytics-main/docs/en/guides/isolating-segmentation-objects.md deleted file mode 100644 index f8e9a7a..0000000 --- a/ultralytics-main/docs/en/guides/isolating-segmentation-objects.md +++ /dev/null @@ -1,325 +0,0 @@ ---- -comments: true -description: A concise guide on isolating segmented objects using Ultralytics. -keywords: Ultralytics, YOLO, segmentation, Python, object detection, inference, dataset, prediction, instance segmentation, contours, binary mask, object mask, image processing ---- - -# Isolating Segmentation Objects - -After performing the [Segment Task](../tasks/segment.md), it's sometimes desirable to extract the isolated objects from the inference results. This guide provides a generic recipe on how to accomplish this using the Ultralytics [Predict Mode](../modes/predict.md). - -

- Example Isolated Object Segmentation -

- -## Recipe Walk Through - -1. Begin with the necessary imports - - ```python - from pathlib import Path - - import cv2 - import numpy as np - from ultralytics import YOLO - ``` - - ???+ tip "Ultralytics Install" - - See the Ultralytics [Quickstart](../quickstart.md/#install-ultralytics) Installation section for a quick walkthrough on installing the required libraries. - - *** - -2. Load a model and run `predict()` method on a source. - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n-seg.pt') - - # Run inference - results = model.predict() - ``` - - !!! question "No Prediction Arguments?" - - Without specifying a source, the example images from the library will be used: - - ``` - 'ultralytics/assets/bus.jpg' - 'ultralytics/assets/zidane.jpg' - ``` - - This is helpful for rapid testing with the `predict()` method. - - For additional information about Segmentation Models, visit the [Segment Task](../tasks/segment.md#models) page. To learn more about `predict()` method, see [Predict Mode](../modes/predict.md) section of the Documentation. - - *** - -3. Now iterate over the results and the contours. For workflows that want to save an image to file, the source image `base-name` and the detection `class-label` are retrieved for later use (optional). - - ```{ .py .annotate } - # (2) Iterate detection results (helpful for multiple images) - for r in res: - img = np.copy(r.orig_img) - img_name = Path(r.path).stem # source image base-name - - # Iterate each object contour (multiple detections) - for ci,c in enumerate(r): - # (1) Get detection class name - label = c.names[c.boxes.cls.tolist().pop()] - - ``` - - 1. To learn more about working with detection results, see [Boxes Section for Predict Mode](../modes/predict.md#boxes). - 2. To learn more about `predict()` results see [Working with Results for Predict Mode](../modes/predict.md#working-with-results) - - ??? info "For-Loop" - - A single image will only iterate the first loop once. A single image with only a single detection will iterate each loop _only_ once. - - *** - -4. Start with generating a binary mask from the source image and then draw a filled contour onto the mask. This will allow the object to be isolated from the other parts of the image. An example from `bus.jpg` for one of the detected `person` class objects is shown on the right. - - ![Binary Mask Image](https://github.com/ultralytics/ultralytics/assets/62214284/59bce684-fdda-4b17-8104-0b4b51149aca){ width="240", align="right" } - - ```{ .py .annotate } - # Create binary mask - b_mask = np.zeros(img.shape[:2], np.uint8) - - # (1) Extract contour result - contour = c.masks.xy.pop() - # (2) Changing the type - contour = contour.astype(np.int32) - # (3) Reshaping - contour = contour.reshape(-1, 1, 2) - - - # Draw contour onto mask - _ = cv2.drawContours(b_mask, - [contour], - -1, - (255, 255, 255), - cv2.FILLED) - - ``` - - 1. For more info on `c.masks.xy` see [Masks Section from Predict Mode](../modes/predict.md#masks). - - 2. Here, the values are cast into `np.int32` for compatibility with `drawContours()` function from OpenCV. - - 3. The OpenCV `drawContours()` function expects contours to have a shape of `[N, 1, 2]` expand section below for more details. - -
- Expand to understand what is happening when defining the contour variable. -

- - - `c.masks.xy` :: Provides the coordinates of the mask contour points in the format `(x, y)`. For more details, refer to the [Masks Section from Predict Mode](../modes/predict.md#masks). - - - `.pop()` :: As `masks.xy` is a list containing a single element, this element is extracted using the `pop()` method. - - - `.astype(np.int32)` :: Using `masks.xy` will return with a data type of `float32`, but this won't be compatible with the OpenCV `drawContours()` function, so this will change the data type to `int32` for compatibility. - - - `.reshape(-1, 1, 2)` :: Reformats the data into the required shape of `[N, 1, 2]` where `N` is the number of contour points, with each point represented by a single entry `1`, and the entry is composed of `2` values. The `-1` denotes that the number of values along this dimension is flexible. - -

-

-
- Expand for an explanation of the drawContours() configuration. -

- - - Encapsulating the `contour` variable within square brackets, `[contour]`, was found to effectively generate the desired contour mask during testing. - - - The value `-1` specified for the `drawContours()` parameter instructs the function to draw all contours present in the image. - - - The `tuple` `(255, 255, 255)` represents the color white, which is the desired color for drawing the contour in this binary mask. - - - The addition of `cv2.FILLED` will color all pixels enclosed by the contour boundary the same, in this case, all enclosed pixels will be white. - - - See [OpenCV Documentation on `drawContours()`](https://docs.opencv.org/4.8.0/d6/d6e/group__imgproc__draw.html#ga746c0625f1781f1ffc9056259103edbc) for more information. - -

-

- - *** - -5. Next the there are 2 options for how to move forward with the image from this point and a subsequent option for each. - - ### Object Isolation Options - - !!! example "" - - === "Black Background Pixels" - - ```py - # Create 3-channel mask - mask3ch = cv2.cvtColor(b_mask, cv2.COLOR_GRAY2BGR) - - # Isolate object with binary mask - isolated = cv2.bitwise_and(mask3ch, img) - - ``` - - ??? question "How does this work?" - - - First, the binary mask is first converted from a single-channel image to a three-channel image. This conversion is necessary for the subsequent step where the mask and the original image are combined. Both images must have the same number of channels to be compatible with the blending operation. - - - The original image and the three-channel binary mask are merged using the OpenCV function `bitwise_and()`. This operation retains only pixel values that are greater than zero `(> 0)` from both images. Since the mask pixels are greater than zero `(> 0)` only within the contour region, the pixels remaining from the original image are those that overlap with the contour. - - ### Isolate with Black Pixels: Sub-options - - ??? info "Full-size Image" - - There are no additional steps required if keeping full size image. - -
- ![Example Full size Isolated Object Image Black Background](https://github.com/ultralytics/ultralytics/assets/62214284/845c00d0-52a6-4b1e-8010-4ba73e011b99){ width=240 } -
Example full-size output
-
- - ??? info "Cropped object Image" - - Additional steps required to crop image to only include object region. - - ![Example Crop Isolated Object Image Black Background](https://github.com/ultralytics/ultralytics/assets/62214284/103dbf90-c169-4f77-b791-76cdf09c6f22){ align="right" } - ``` { .py .annotate } - # (1) Bounding box coordinates - x1, y1, x2, y2 = c.boxes.xyxy.cpu().numpy().squeeze().astype(np.int32) - # Crop image to object region - iso_crop = isolated[y1:y2, x1:x2] - - ``` - - 1. For more information on bounding box results, see [Boxes Section from Predict Mode](../modes/predict.md/#boxes) - - ??? question "What does this code do?" - - - The `c.boxes.xyxy.cpu().numpy()` call retrieves the bounding boxes as a NumPy array in the `xyxy` format, where `xmin`, `ymin`, `xmax`, and `ymax` represent the coordinates of the bounding box rectangle. See [Boxes Section from Predict Mode](../modes/predict.md/#boxes) for more details. - - - The `squeeze()` operation removes any unnecessary dimensions from the NumPy array, ensuring it has the expected shape. - - - Converting the coordinate values using `.astype(np.int32)` changes the box coordinates data type from `float32` to `int32`, making them compatible for image cropping using index slices. - - - Finally, the bounding box region is cropped from the image using index slicing. The bounds are defined by the `[ymin:ymax, xmin:xmax]` coordinates of the detection bounding box. - - === "Transparent Background Pixels" - - ```py - # Isolate object with transparent background (when saved as PNG) - isolated = np.dstack([img, b_mask]) - - ``` - - ??? question "How does this work?" - - - Using the NumPy `dstack()` function (array stacking along depth-axis) in conjunction with the binary mask generated, will create an image with four channels. This allows for all pixels outside of the object contour to be transparent when saving as a `PNG` file. - - ### Isolate with Transparent Pixels: Sub-options - - ??? info "Full-size Image" - - There are no additional steps required if keeping full size image. - -
- ![Example Full size Isolated Object Image No Background](https://github.com/ultralytics/ultralytics/assets/62214284/b1043ee0-369a-4019-941a-9447a9771042){ width=240 } -
Example full-size output + transparent background
-
- - ??? info "Cropped object Image" - - Additional steps required to crop image to only include object region. - - ![Example Crop Isolated Object Image No Background](https://github.com/ultralytics/ultralytics/assets/62214284/5910244f-d1e1-44af-af7f-6dea4c688da8){ align="right" } - ``` { .py .annotate } - # (1) Bounding box coordinates - x1, y1, x2, y2 = c.boxes.xyxy.cpu().numpy().squeeze().astype(np.int32) - # Crop image to object region - iso_crop = isolated[y1:y2, x1:x2] - - ``` - - 1. For more information on bounding box results, see [Boxes Section from Predict Mode](../modes/predict.md/#boxes) - - ??? question "What does this code do?" - - - When using `c.boxes.xyxy.cpu().numpy()`, the bounding boxes are returned as a NumPy array, using the `xyxy` box coordinates format, which correspond to the points `xmin, ymin, xmax, ymax` for the bounding box (rectangle), see [Boxes Section from Predict Mode](../modes/predict.md/#boxes) for more information. - - - Adding `squeeze()` ensures that any extraneous dimensions are removed from the NumPy array. - - - Converting the coordinate values using `.astype(np.int32)` changes the box coordinates data type from `float32` to `int32` which will be compatible when cropping the image using index slices. - - - Finally the image region for the bounding box is cropped using index slicing, where the bounds are set using the `[ymin:ymax, xmin:xmax]` coordinates of the detection bounding box. - - ??? question "What if I want the cropped object **including** the background?" - - This is a built in feature for the Ultralytics library. See the `save_crop` argument for [Predict Mode Inference Arguments](../modes/predict.md/#inference-arguments) for details. - - *** - -6. What to do next is entirely left to you as the developer. A basic example of one possible next step (saving the image to file for future use) is shown. - - - **NOTE:** this step is optional and can be skipped if not required for your specific use case. - - ??? example "Example Final Step" - - ```py - # Save isolated object to file - _ = cv2.imwrite(f'{img_name}_{label}-{ci}.png', iso_crop) - ``` - - - In this example, the `img_name` is the base-name of the source image file, `label` is the detected class-name, and `ci` is the index of the object detection (in case of multiple instances with the same class name). - -## Full Example code - -Here, all steps from the previous section are combined into a single block of code. For repeated use, it would be optimal to define a function to do some or all commands contained in the `for`-loops, but that is an exercise left to the reader. - -```{ .py .annotate } -from pathlib import Path - -import cv2 -import numpy as np -from ultralytics import YOLO - -m = YOLO('yolov8n-seg.pt')#(4)! -res = m.predict()#(3)! - -# iterate detection results (5) -for r in res: - img = np.copy(r.orig_img) - img_name = Path(r.path).stem - - # iterate each object contour (6) - for ci,c in enumerate(r): - label = c.names[c.boxes.cls.tolist().pop()] - - b_mask = np.zeros(img.shape[:2], np.uint8) - - # Create contour mask (1) - contour = c.masks.xy.pop().astype(np.int32).reshape(-1, 1, 2) - _ = cv2.drawContours(b_mask, [contour], -1, (255, 255, 255), cv2.FILLED) - - # Choose one: - - # OPTION-1: Isolate object with black background - mask3ch = cv2.cvtColor(b_mask, cv2.COLOR_GRAY2BGR) - isolated = cv2.bitwise_and(mask3ch, img) - - # OPTION-2: Isolate object with transparent background (when saved as PNG) - isolated = np.dstack([img, b_mask]) - - # OPTIONAL: detection crop (from either OPT1 or OPT2) - x1, y1, x2, y2 = c.boxes.xyxy.cpu().numpy().squeeze().astype(np.int32) - iso_crop = isolated[y1:y2, x1:x2] - - # TODO your actions go here (2) - -``` - -1. The line populating `contour` is combined into a single line here, where it was split to multiple above. -2. {==What goes here is up to you!==} -3. See [Predict Mode](../modes/predict.md) for additional information. -4. See [Segment Task](../tasks/segment.md#models) for more information. -5. Learn more about [Working with Results](../modes/predict.md#working-with-results) -6. Learn more about [Segmentation Mask Results](../modes/predict.md#masks) diff --git a/ultralytics-main/docs/en/guides/kfold-cross-validation.md b/ultralytics-main/docs/en/guides/kfold-cross-validation.md deleted file mode 100644 index 9eb53a1..0000000 --- a/ultralytics-main/docs/en/guides/kfold-cross-validation.md +++ /dev/null @@ -1,278 +0,0 @@ ---- -comments: true -description: An in-depth guide demonstrating the implementation of K-Fold Cross Validation with the Ultralytics ecosystem for object detection datasets, leveraging Python, YOLO, and sklearn. -keywords: K-Fold cross validation, Ultralytics, YOLO detection format, Python, sklearn, object detection ---- - -# K-Fold Cross Validation with Ultralytics - -## Introduction - -This comprehensive guide illustrates the implementation of K-Fold Cross Validation for object detection datasets within the Ultralytics ecosystem. We'll leverage the YOLO detection format and key Python libraries such as sklearn, pandas, and PyYaml to guide you through the necessary setup, the process of generating feature vectors, and the execution of a K-Fold dataset split. - -

- K-Fold Cross Validation Overview -

- -Whether your project involves the Fruit Detection dataset or a custom data source, this tutorial aims to help you comprehend and apply K-Fold Cross Validation to bolster the reliability and robustness of your machine learning models. While we're applying `k=5` folds for this tutorial, keep in mind that the optimal number of folds can vary depending on your dataset and the specifics of your project. - -Without further ado, let's dive in! - -## Setup - -- Your annotations should be in the [YOLO detection format](../datasets/detect/index.md). - -- This guide assumes that annotation files are locally available. - -- For our demonstration, we use the [Fruit Detection](https://www.kaggle.com/datasets/lakshaytyagi01/fruit-detection/code) dataset. - - This dataset contains a total of 8479 images. - - It includes 6 class labels, each with its total instance counts listed below. - -| Class Label | Instance Count | -|:------------|:--------------:| -| Apple | 7049 | -| Grapes | 7202 | -| Pineapple | 1613 | -| Orange | 15549 | -| Banana | 3536 | -| Watermelon | 1976 | - -- Necessary Python packages include: - - - `ultralytics` - - `sklearn` - - `pandas` - - `pyyaml` - -- This tutorial operates with `k=5` folds. However, you should determine the best number of folds for your specific dataset. - -1. Initiate a new Python virtual environment (`venv`) for your project and activate it. Use `pip` (or your preferred package manager) to install: - - - The Ultralytics library: `pip install -U ultralytics`. Alternatively, you can clone the official [repo](https://github.com/ultralytics/ultralytics). - - Scikit-learn, pandas, and PyYAML: `pip install -U scikit-learn pandas pyyaml`. - -2. Verify that your annotations are in the [YOLO detection format](../datasets/detect/index.md). - - - For this tutorial, all annotation files are found in the `Fruit-Detection/labels` directory. - -## Generating Feature Vectors for Object Detection Dataset - -1. Start by creating a new Python file and import the required libraries. - - ```python - import datetime - import shutil - from pathlib import Path - from collections import Counter - - import yaml - import numpy as np - import pandas as pd - from ultralytics import YOLO - from sklearn.model_selection import KFold - ``` - -2. Proceed to retrieve all label files for your dataset. - - ```python - dataset_path = Path('./Fruit-detection') # replace with 'path/to/dataset' for your custom data - labels = sorted(dataset_path.rglob("*labels/*.txt")) # all data in 'labels' - ``` - -3. Now, read the contents of the dataset YAML file and extract the indices of the class labels. - - ```python - yaml_file = 'path/to/data.yaml' # your data YAML with data directories and names dictionary - with open(yaml_file, 'r', encoding="utf8") as y: - classes = yaml.safe_load(y)['names'] - cls_idx = sorted(classes.keys()) - ``` - -4. Initialize an empty `pandas` DataFrame. - - ```python - indx = [l.stem for l in labels] # uses base filename as ID (no extension) - labels_df = pd.DataFrame([], columns=cls_idx, index=indx) - ``` - -5. Count the instances of each class-label present in the annotation files. - - ```python - for label in labels: - lbl_counter = Counter() - - with open(label,'r') as lf: - lines = lf.readlines() - - for l in lines: - # classes for YOLO label uses integer at first position of each line - lbl_counter[int(l.split(' ')[0])] += 1 - - labels_df.loc[label.stem] = lbl_counter - - labels_df = labels_df.fillna(0.0) # replace `nan` values with `0.0` - ``` - -6. The following is a sample view of the populated DataFrame: - - ```pandas - 0 1 2 3 4 5 - '0000a16e4b057580_jpg.rf.00ab48988370f64f5ca8ea4...' 0.0 0.0 0.0 0.0 0.0 7.0 - '0000a16e4b057580_jpg.rf.7e6dce029fb67f01eb19aa7...' 0.0 0.0 0.0 0.0 0.0 7.0 - '0000a16e4b057580_jpg.rf.bc4d31cdcbe229dd022957a...' 0.0 0.0 0.0 0.0 0.0 7.0 - '00020ebf74c4881c_jpg.rf.508192a0a97aa6c4a3b6882...' 0.0 0.0 0.0 1.0 0.0 0.0 - '00020ebf74c4881c_jpg.rf.5af192a2254c8ecc4188a25...' 0.0 0.0 0.0 1.0 0.0 0.0 - ... ... ... ... ... ... ... - 'ff4cd45896de38be_jpg.rf.c4b5e967ca10c7ced3b9e97...' 0.0 0.0 0.0 0.0 0.0 2.0 - 'ff4cd45896de38be_jpg.rf.ea4c1d37d2884b3e3cbce08...' 0.0 0.0 0.0 0.0 0.0 2.0 - 'ff5fd9c3c624b7dc_jpg.rf.bb519feaa36fc4bf630a033...' 1.0 0.0 0.0 0.0 0.0 0.0 - 'ff5fd9c3c624b7dc_jpg.rf.f0751c9c3aa4519ea3c9d6a...' 1.0 0.0 0.0 0.0 0.0 0.0 - 'fffe28b31f2a70d4_jpg.rf.7ea16bd637ba0711c53b540...' 0.0 6.0 0.0 0.0 0.0 0.0 - ``` - -The rows index the label files, each corresponding to an image in your dataset, and the columns correspond to your class-label indices. Each row represents a pseudo feature-vector, with the count of each class-label present in your dataset. This data structure enables the application of K-Fold Cross Validation to an object detection dataset. - -## K-Fold Dataset Split - -1. Now we will use the `KFold` class from `sklearn.model_selection` to generate `k` splits of the dataset. - - - Important: - - Setting `shuffle=True` ensures a randomized distribution of classes in your splits. - - By setting `random_state=M` where `M` is a chosen integer, you can obtain repeatable results. - - ```python - ksplit = 5 - kf = KFold(n_splits=ksplit, shuffle=True, random_state=20) # setting random_state for repeatable results - - kfolds = list(kf.split(labels_df)) - ``` - -2. The dataset has now been split into `k` folds, each having a list of `train` and `val` indices. We will construct a DataFrame to display these results more clearly. - - ```python - folds = [f'split_{n}' for n in range(1, ksplit + 1)] - folds_df = pd.DataFrame(index=indx, columns=folds) - - for idx, (train, val) in enumerate(kfolds, start=1): - folds_df[f'split_{idx}'].loc[labels_df.iloc[train].index] = 'train' - folds_df[f'split_{idx}'].loc[labels_df.iloc[val].index] = 'val' - ``` - -3. Now we will calculate the distribution of class labels for each fold as a ratio of the classes present in `val` to those present in `train`. - - ```python - fold_lbl_distrb = pd.DataFrame(index=folds, columns=cls_idx) - - for n, (train_indices, val_indices) in enumerate(kfolds, start=1): - train_totals = labels_df.iloc[train_indices].sum() - val_totals = labels_df.iloc[val_indices].sum() - - # To avoid division by zero, we add a small value (1E-7) to the denominator - ratio = val_totals / (train_totals + 1E-7) - fold_lbl_distrb.loc[f'split_{n}'] = ratio - ``` - - The ideal scenario is for all class ratios to be reasonably similar for each split and across classes. This, however, will be subject to the specifics of your dataset. - -4. Next, we create the directories and dataset YAML files for each split. - - ```python - supported_extensions = ['.jpg', '.jpeg', '.png'] - - # Initialize an empty list to store image file paths - images = [] - - # Loop through supported extensions and gather image files - for ext in supported_extensions: - images.extend(sorted((dataset_path / 'images').rglob(f"*{ext}"))) - - # Create the necessary directories and dataset YAML files (unchanged) - save_path = Path(dataset_path / f'{datetime.date.today().isoformat()}_{ksplit}-Fold_Cross-val') - save_path.mkdir(parents=True, exist_ok=True) - ds_yamls = [] - - for split in folds_df.columns: - # Create directories - split_dir = save_path / split - split_dir.mkdir(parents=True, exist_ok=True) - (split_dir / 'train' / 'images').mkdir(parents=True, exist_ok=True) - (split_dir / 'train' / 'labels').mkdir(parents=True, exist_ok=True) - (split_dir / 'val' / 'images').mkdir(parents=True, exist_ok=True) - (split_dir / 'val' / 'labels').mkdir(parents=True, exist_ok=True) - - # Create dataset YAML files - dataset_yaml = split_dir / f'{split}_dataset.yaml' - ds_yamls.append(dataset_yaml) - - with open(dataset_yaml, 'w') as ds_y: - yaml.safe_dump({ - 'path': split_dir.as_posix(), - 'train': 'train', - 'val': 'val', - 'names': classes - }, ds_y) - ``` - -5. Lastly, copy images and labels into the respective directory ('train' or 'val') for each split. - - - __NOTE:__ The time required for this portion of the code will vary based on the size of your dataset and your system hardware. - - ```python - for image, label in zip(images, labels): - for split, k_split in folds_df.loc[image.stem].items(): - # Destination directory - img_to_path = save_path / split / k_split / 'images' - lbl_to_path = save_path / split / k_split / 'labels' - - # Copy image and label files to new directory (SamefileError if file already exists) - shutil.copy(image, img_to_path / image.name) - shutil.copy(label, lbl_to_path / label.name) - ``` - -## Save Records (Optional) - -Optionally, you can save the records of the K-Fold split and label distribution DataFrames as CSV files for future reference. - -```python -folds_df.to_csv(save_path / "kfold_datasplit.csv") -fold_lbl_distrb.to_csv(save_path / "kfold_label_distribution.csv") -``` - -## Train YOLO using K-Fold Data Splits - -1. First, load the YOLO model. - - ```python - weights_path = 'path/to/weights.pt' - model = YOLO(weights_path, task='detect') - ``` - -2. Next, iterate over the dataset YAML files to run training. The results will be saved to a directory specified by the `project` and `name` arguments. By default, this directory is 'exp/runs#' where # is an integer index. - - ```python - results = {} - - # Define your additional arguments here - batch = 16 - project = 'kfold_demo' - epochs = 100 - - for k in range(ksplit): - dataset_yaml = ds_yamls[k] - model.train(data=dataset_yaml,epochs=epochs, batch=batch, project=project) # include any train arguments - results[k] = model.metrics # save output metrics for further analysis - ``` - -## Conclusion - -In this guide, we have explored the process of using K-Fold cross-validation for training the YOLO object detection model. We learned how to split our dataset into K partitions, ensuring a balanced class distribution across the different folds. - -We also explored the procedure for creating report DataFrames to visualize the data splits and label distributions across these splits, providing us a clear insight into the structure of our training and validation sets. - -Optionally, we saved our records for future reference, which could be particularly useful in large-scale projects or when troubleshooting model performance. - -Finally, we implemented the actual model training using each split in a loop, saving our training results for further analysis and comparison. - -This technique of K-Fold cross-validation is a robust way of making the most out of your available data, and it helps to ensure that your model performance is reliable and consistent across different data subsets. This results in a more generalizable and reliable model that is less likely to overfit to specific data patterns. - -Remember that although we used YOLO in this guide, these steps are mostly transferable to other machine learning models. Understanding these steps allows you to apply cross-validation effectively in your own machine learning projects. Happy coding! diff --git a/ultralytics-main/docs/en/guides/model-deployment-options.md b/ultralytics-main/docs/en/guides/model-deployment-options.md deleted file mode 100644 index a487ea4..0000000 --- a/ultralytics-main/docs/en/guides/model-deployment-options.md +++ /dev/null @@ -1,305 +0,0 @@ ---- -comments: true -description: A guide to help determine which deployment option to choose for your YOLOv8 model, including essential considerations. -keywords: YOLOv8, Deployment, PyTorch, TorchScript, ONNX, OpenVINO, TensorRT, CoreML, TensorFlow, Export ---- - -# Understanding YOLOv8’s Deployment Options - -## Introduction - -You've come a long way on your journey with YOLOv8. You've diligently collected data, meticulously annotated it, and put in the hours to train and rigorously evaluate your custom YOLOv8 model. Now, it’s time to put your model to work for your specific application, use case, or project. But there's a critical decision that stands before you: how to export and deploy your model effectively. - -This guide walks you through YOLOv8’s deployment options and the essential factors to consider to choose the right option for your project. - -## How to Select the Right Deployment Option for Your YOLOv8 Model - -When it's time to deploy your YOLOv8 model, selecting a suitable export format is very important. As outlined in the [Ultralytics YOLOv8 Modes documentation](../modes/export.md#usage-examples), the model.export() function allows for converting your trained model into a variety of formats tailored to diverse environments and performance requirements. - -The ideal format depends on your model's intended operational context, balancing speed, hardware constraints, and ease of integration. In the following section, we'll take a closer look at each export option, understanding when to choose each one. - -### YOLOv8’s Deployment Options - -Let’s walk through the different YOLOv8 deployment options. For a detailed walkthrough of the export process, visit the [Ultralytics documentation page on exporting](../modes/export.md). - -#### PyTorch - -PyTorch is an open-source machine learning library widely used for applications in deep learning and artificial intelligence. It provides a high level of flexibility and speed, which has made it a favorite among researchers and developers. - -- **Performance Benchmarks**: PyTorch is known for its ease of use and flexibility, which may result in a slight trade-off in raw performance when compared to other frameworks that are more specialized and optimized. - -- **Compatibility and Integration**: Offers excellent compatibility with various data science and machine learning libraries in Python. - -- **Community Support and Ecosystem**: One of the most vibrant communities, with extensive resources for learning and troubleshooting. - -- **Case Studies**: Commonly used in research prototypes, many academic papers reference models deployed in PyTorch. - -- **Maintenance and Updates**: Regular updates with active development and support for new features. - -- **Security Considerations**: Regular patches for security issues, but security is largely dependent on the overall environment it’s deployed in. - -- **Hardware Acceleration**: Supports CUDA for GPU acceleration, essential for speeding up model training and inference. - -#### TorchScript - -TorchScript extends PyTorch’s capabilities by allowing the exportation of models to be run in a C++ runtime environment. This makes it suitable for production environments where Python is unavailable. - -- **Performance Benchmarks**: Can offer improved performance over native PyTorch, especially in production environments. - -- **Compatibility and Integration**: Designed for seamless transition from PyTorch to C++ production environments, though some advanced features might not translate perfectly. - -- **Community Support and Ecosystem**: Benefits from PyTorch’s large community but has a narrower scope of specialized developers. - -- **Case Studies**: Widely used in industry settings where Python’s performance overhead is a bottleneck. - -- **Maintenance and Updates**: Maintained alongside PyTorch with consistent updates. - -- **Security Considerations**: Offers improved security by enabling the running of models in environments without full Python installations. - -- **Hardware Acceleration**: Inherits PyTorch’s CUDA support, ensuring efficient GPU utilization. - -#### ONNX - -The Open Neural Network Exchange (ONNX) is a format that allows for model interoperability across different frameworks, which can be critical when deploying to various platforms. - -- **Performance Benchmarks**: ONNX models may experience a variable performance depending on the specific runtime they are deployed on. - -- **Compatibility and Integration**: High interoperability across multiple platforms and hardware due to its framework-agnostic nature. - -- **Community Support and Ecosystem**: Supported by many organizations, leading to a broad ecosystem and a variety of tools for optimization. - -- **Case Studies**: Frequently used to move models between different machine learning frameworks, demonstrating its flexibility. - -- **Maintenance and Updates**: As an open standard, ONNX is regularly updated to support new operations and models. - -- **Security Considerations**: As with any cross-platform tool, it's essential to ensure secure practices in the conversion and deployment pipeline. - -- **Hardware Acceleration**: With ONNX Runtime, models can leverage various hardware optimizations. - -#### OpenVINO - -OpenVINO is an Intel toolkit designed to facilitate the deployment of deep learning models across Intel hardware, enhancing performance and speed. - -- **Performance Benchmarks**: Specifically optimized for Intel CPUs, GPUs, and VPUs, offering significant performance boosts on compatible hardware. - -- **Compatibility and Integration**: Works best within the Intel ecosystem but also supports a range of other platforms. - -- **Community Support and Ecosystem**: Backed by Intel, with a solid user base especially in the computer vision domain. - -- **Case Studies**: Often utilized in IoT and edge computing scenarios where Intel hardware is prevalent. - -- **Maintenance and Updates**: Intel regularly updates OpenVINO to support the latest deep learning models and Intel hardware. - -- **Security Considerations**: Provides robust security features suitable for deployment in sensitive applications. - -- **Hardware Acceleration**: Tailored for acceleration on Intel hardware, leveraging dedicated instruction sets and hardware features. - -For more details on deployment using OpenVINO, refer to the Ultralytics Integration documentation: [Intel OpenVINO Export](../integrations/openvino.md). - -#### TensorRT - -TensorRT is a high-performance deep learning inference optimizer and runtime from NVIDIA, ideal for applications needing speed and efficiency. - -- **Performance Benchmarks**: Delivers top-tier performance on NVIDIA GPUs with support for high-speed inference. - -- **Compatibility and Integration**: Best suited for NVIDIA hardware, with limited support outside this environment. - -- **Community Support and Ecosystem**: Strong support network through NVIDIA’s developer forums and documentation. - -- **Case Studies**: Widely adopted in industries requiring real-time inference on video and image data. - -- **Maintenance and Updates**: NVIDIA maintains TensorRT with frequent updates to enhance performance and support new GPU architectures. - -- **Security Considerations**: Like many NVIDIA products, it has a strong emphasis on security, but specifics depend on the deployment environment. - -- **Hardware Acceleration**: Exclusively designed for NVIDIA GPUs, providing deep optimization and acceleration. - -#### CoreML - -CoreML is Apple’s machine learning framework, optimized for on-device performance in the Apple ecosystem, including iOS, macOS, watchOS, and tvOS. - -- **Performance Benchmarks**: Optimized for on-device performance on Apple hardware with minimal battery usage. - -- **Compatibility and Integration**: Exclusively for Apple's ecosystem, providing a streamlined workflow for iOS and macOS applications. - -- **Community Support and Ecosystem**: Strong support from Apple and a dedicated developer community, with extensive documentation and tools. - -- **Case Studies**: Commonly used in applications that require on-device machine learning capabilities on Apple products. - -- **Maintenance and Updates**: Regularly updated by Apple to support the latest machine learning advancements and Apple hardware. - -- **Security Considerations**: Benefits from Apple's focus on user privacy and data security. - -- **Hardware Acceleration**: Takes full advantage of Apple's neural engine and GPU for accelerated machine learning tasks. - -#### TF SavedModel - -TF SavedModel is TensorFlow’s format for saving and serving machine learning models, particularly suited for scalable server environments. - -- **Performance Benchmarks**: Offers scalable performance in server environments, especially when used with TensorFlow Serving. - -- **Compatibility and Integration**: Wide compatibility across TensorFlow's ecosystem, including cloud and enterprise server deployments. - -- **Community Support and Ecosystem**: Large community support due to TensorFlow's popularity, with a vast array of tools for deployment and optimization. - -- **Case Studies**: Extensively used in production environments for serving deep learning models at scale. - -- **Maintenance and Updates**: Supported by Google and the TensorFlow community, ensuring regular updates and new features. - -- **Security Considerations**: Deployment using TensorFlow Serving includes robust security features for enterprise-grade applications. - -- **Hardware Acceleration**: Supports various hardware accelerations through TensorFlow's backends. - -#### TF GraphDef - -TF GraphDef is a TensorFlow format that represents the model as a graph, which is beneficial for environments where a static computation graph is required. - -- **Performance Benchmarks**: Provides stable performance for static computation graphs, with a focus on consistency and reliability. - -- **Compatibility and Integration**: Easily integrates within TensorFlow's infrastructure but less flexible compared to SavedModel. - -- **Community Support and Ecosystem**: Good support from TensorFlow's ecosystem, with many resources available for optimizing static graphs. - -- **Case Studies**: Useful in scenarios where a static graph is necessary, such as in certain embedded systems. - -- **Maintenance and Updates**: Regular updates alongside TensorFlow's core updates. - -- **Security Considerations**: Ensures safe deployment with TensorFlow's established security practices. - -- **Hardware Acceleration**: Can utilize TensorFlow's hardware acceleration options, though not as flexible as SavedModel. - -#### TF Lite - -TF Lite is TensorFlow’s solution for mobile and embedded device machine learning, providing a lightweight library for on-device inference. - -- **Performance Benchmarks**: Designed for speed and efficiency on mobile and embedded devices. - -- **Compatibility and Integration**: Can be used on a wide range of devices due to its lightweight nature. - -- **Community Support and Ecosystem**: Backed by Google, it has a robust community and a growing number of resources for developers. - -- **Case Studies**: Popular in mobile applications that require on-device inference with minimal footprint. - -- **Maintenance and Updates**: Regularly updated to include the latest features and optimizations for mobile devices. - -- **Security Considerations**: Provides a secure environment for running models on end-user devices. - -- **Hardware Acceleration**: Supports a variety of hardware acceleration options, including GPU and DSP. - -#### TF Edge TPU - -TF Edge TPU is designed for high-speed, efficient computing on Google's Edge TPU hardware, perfect for IoT devices requiring real-time processing. - -- **Performance Benchmarks**: Specifically optimized for high-speed, efficient computing on Google's Edge TPU hardware. - -- **Compatibility and Integration**: Works exclusively with TensorFlow Lite models on Edge TPU devices. - -- **Community Support and Ecosystem**: Growing support with resources provided by Google and third-party developers. - -- **Case Studies**: Used in IoT devices and applications that require real-time processing with low latency. - -- **Maintenance and Updates**: Continually improved upon to leverage the capabilities of new Edge TPU hardware releases. - -- **Security Considerations**: Integrates with Google's robust security for IoT and edge devices. - -- **Hardware Acceleration**: Custom-designed to take full advantage of Google Coral devices. - -#### TF.js - -TensorFlow.js (TF.js) is a library that brings machine learning capabilities directly to the browser, offering a new realm of possibilities for web developers and users alike. It allows for the integration of machine learning models in web applications without the need for back-end infrastructure. - -- **Performance Benchmarks**: Enables machine learning directly in the browser with reasonable performance, depending on the client device. - -- **Compatibility and Integration**: High compatibility with web technologies, allowing for easy integration into web applications. - -- **Community Support and Ecosystem**: Support from a community of web and Node.js developers, with a variety of tools for deploying ML models in browsers. - -- **Case Studies**: Ideal for interactive web applications that benefit from client-side machine learning without the need for server-side processing. - -- **Maintenance and Updates**: Maintained by the TensorFlow team with contributions from the open-source community. - -- **Security Considerations**: Runs within the browser's secure context, utilizing the security model of the web platform. - -- **Hardware Acceleration**: Performance can be enhanced with web-based APIs that access hardware acceleration like WebGL. - -#### PaddlePaddle - -PaddlePaddle is an open-source deep learning framework developed by Baidu. It is designed to be both efficient for researchers and easy to use for developers. It's particularly popular in China and offers specialized support for Chinese language processing. - -- **Performance Benchmarks**: Offers competitive performance with a focus on ease of use and scalability. - -- **Compatibility and Integration**: Well-integrated within Baidu's ecosystem and supports a wide range of applications. - -- **Community Support and Ecosystem**: While the community is smaller globally, it's rapidly growing, especially in China. - -- **Case Studies**: Commonly used in Chinese markets and by developers looking for alternatives to other major frameworks. - -- **Maintenance and Updates**: Regularly updated with a focus on serving Chinese language AI applications and services. - -- **Security Considerations**: Emphasizes data privacy and security, catering to Chinese data governance standards. - -- **Hardware Acceleration**: Supports various hardware accelerations, including Baidu's own Kunlun chips. - -#### NCNN - -NCNN is a high-performance neural network inference framework optimized for the mobile platform. It stands out for its lightweight nature and efficiency, making it particularly well-suited for mobile and embedded devices where resources are limited. - -- **Performance Benchmarks**: Highly optimized for mobile platforms, offering efficient inference on ARM-based devices. - -- **Compatibility and Integration**: Suitable for applications on mobile phones and embedded systems with ARM architecture. - -- **Community Support and Ecosystem**: Supported by a niche but active community focused on mobile and embedded ML applications. - -- **Case Studies**: Favoured for mobile applications where efficiency and speed are critical on Android and other ARM-based systems. - -- **Maintenance and Updates**: Continuously improved to maintain high performance on a range of ARM devices. - -- **Security Considerations**: Focuses on running locally on the device, leveraging the inherent security of on-device processing. - -- **Hardware Acceleration**: Tailored for ARM CPUs and GPUs, with specific optimizations for these architectures. - -## Comparative Analysis of YOLOv8 Deployment Options - -The following table provides a snapshot of the various deployment options available for YOLOv8 models, helping you to assess which may best fit your project needs based on several critical criteria. For an in-depth look at each deployment option's format, please see the [Ultralytics documentation page on export formats](../modes/export.md#export-formats). - -| Deployment Option | Performance Benchmarks | Compatibility and Integration | Community Support and Ecosystem | Case Studies | Maintenance and Updates | Security Considerations | Hardware Acceleration | -|-------------------|-------------------------------------------------|------------------------------------------------|-----------------------------------------------|--------------------------------------------|---------------------------------------------|---------------------------------------------------|------------------------------------| -| PyTorch | Good flexibility; may trade off raw performance | Excellent with Python libraries | Extensive resources and community | Research and prototypes | Regular, active development | Dependent on deployment environment | CUDA support for GPU acceleration | -| TorchScript | Better for production than PyTorch | Smooth transition from PyTorch to C++ | Specialized but narrower than PyTorch | Industry where Python is a bottleneck | Consistent updates with PyTorch | Improved security without full Python | Inherits CUDA support from PyTorch | -| ONNX | Variable depending on runtime | High across different frameworks | Broad ecosystem, supported by many orgs | Flexibility across ML frameworks | Regular updates for new operations | Ensure secure conversion and deployment practices | Various hardware optimizations | -| OpenVINO | Optimized for Intel hardware | Best within Intel ecosystem | Solid in computer vision domain | IoT and edge with Intel hardware | Regular updates for Intel hardware | Robust features for sensitive applications | Tailored for Intel hardware | -| TensorRT | Top-tier on NVIDIA GPUs | Best for NVIDIA hardware | Strong network through NVIDIA | Real-time video and image inference | Frequent updates for new GPUs | Emphasis on security | Designed for NVIDIA GPUs | -| CoreML | Optimized for on-device Apple hardware | Exclusive to Apple ecosystem | Strong Apple and developer support | On-device ML on Apple products | Regular Apple updates | Focus on privacy and security | Apple neural engine and GPU | -| TF SavedModel | Scalable in server environments | Wide compatibility in TensorFlow ecosystem | Large support due to TensorFlow popularity | Serving models at scale | Regular updates by Google and community | Robust features for enterprise | Various hardware accelerations | -| TF GraphDef | Stable for static computation graphs | Integrates well with TensorFlow infrastructure | Resources for optimizing static graphs | Scenarios requiring static graphs | Updates alongside TensorFlow core | Established TensorFlow security practices | TensorFlow acceleration options | -| TF Lite | Speed and efficiency on mobile/embedded | Wide range of device support | Robust community, Google backed | Mobile applications with minimal footprint | Latest features for mobile | Secure environment on end-user devices | GPU and DSP among others | -| TF Edge TPU | Optimized for Google's Edge TPU hardware | Exclusive to Edge TPU devices | Growing with Google and third-party resources | IoT devices requiring real-time processing | Improvements for new Edge TPU hardware | Google's robust IoT security | Custom-designed for Google Coral | -| TF.js | Reasonable in-browser performance | High with web technologies | Web and Node.js developers support | Interactive web applications | TensorFlow team and community contributions | Web platform security model | Enhanced with WebGL and other APIs | -| PaddlePaddle | Competitive, easy to use and scalable | Baidu ecosystem, wide application support | Rapidly growing, especially in China | Chinese market and language processing | Focus on Chinese AI applications | Emphasizes data privacy and security | Including Baidu's Kunlun chips | -| NCNN | Optimized for mobile ARM-based devices | Mobile and embedded ARM systems | Niche but active mobile/embedded ML community | Android and ARM systems efficiency | High performance maintenance on ARM | On-device security advantages | ARM CPUs and GPUs optimizations | - -This comparative analysis gives you a high-level overview. For deployment, it's essential to consider the specific requirements and constraints of your project, and consult the detailed documentation and resources available for each option. - -## Community and Support - -When you're getting started with YOLOv8, having a helpful community and support can make a significant impact. Here's how to connect with others who share your interests and get the assistance you need. - -### Engage with the Broader Community - -- **GitHub Discussions:** The YOLOv8 repository on GitHub has a "Discussions" section where you can ask questions, report issues, and suggest improvements. - -- **Ultralytics Discord Server:** Ultralytics has a [Discord server](https://ultralytics.com/discord/) where you can interact with other users and developers. - -### Official Documentation and Resources - -- **Ultralytics YOLOv8 Docs:** The [official documentation](../index.md) provides a comprehensive overview of YOLOv8, along with guides on installation, usage, and troubleshooting. - -These resources will help you tackle challenges and stay updated on the latest trends and best practices in the YOLOv8 community. - -## Conclusion - -In this guide, we've explored the different deployment options for YOLOv8. We've also discussed the important factors to consider when making your choice. These options allow you to customize your model for various environments and performance requirements, making it suitable for real-world applications. - -Don't forget that the YOLOv8 and Ultralytics community is a valuable source of help. Connect with other developers and experts to learn unique tips and solutions you might not find in regular documentation. Keep seeking knowledge, exploring new ideas, and sharing your experiences. - -Happy deploying! diff --git a/ultralytics-main/docs/en/guides/object-blurring.md b/ultralytics-main/docs/en/guides/object-blurring.md deleted file mode 100644 index 0b6faa3..0000000 --- a/ultralytics-main/docs/en/guides/object-blurring.md +++ /dev/null @@ -1,91 +0,0 @@ ---- -comments: true -description: Learn to blur objects using Ultralytics YOLOv8 for privacy in images and videos. -keywords: Ultralytics, YOLOv8, Object Detection, Object Blurring, Privacy Protection, Image Processing, Video Analysis, AI, Machine Learning ---- - -# Object Blurring using Ultralytics YOLOv8 🚀 - -## What is Object Blurring? - -Object blurring with [Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics/) involves applying a blurring effect to specific detected objects in an image or video. This can be achieved using the YOLOv8 model capabilities to identify and manipulate objects within a given scene. - -## Advantages of Object Blurring? - -- **Privacy Protection**: Object blurring is an effective tool for safeguarding privacy by concealing sensitive or personally identifiable information in images or videos. -- **Selective Focus**: YOLOv8 allows for selective blurring, enabling users to target specific objects, ensuring a balance between privacy and retaining relevant visual information. -- **Real-time Processing**: YOLOv8's efficiency enables object blurring in real-time, making it suitable for applications requiring on-the-fly privacy enhancements in dynamic environments. - -!!! Example "Object Blurring using YOLOv8 Example" - - === "Object Blurring" - - ```python - from ultralytics import YOLO - from ultralytics.utils.plotting import Annotator, colors - import cv2 - - model = YOLO("yolov8n.pt") - names = model.names - - cap = cv2.VideoCapture("path/to/video/file.mp4") - assert cap.isOpened(), "Error reading video file" - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - # Blur ratio - blur_ratio = 50 - - # Video writer - video_writer = cv2.VideoWriter("object_blurring_output.avi", - cv2.VideoWriter_fourcc(*'mp4v'), - fps, (w, h)) - - while cap.isOpened(): - success, im0 = cap.read() - if not success: - print("Video frame is empty or video processing has been successfully completed.") - break - - results = model.predict(im0, show=False) - boxes = results[0].boxes.xyxy.cpu().tolist() - clss = results[0].boxes.cls.cpu().tolist() - annotator = Annotator(im0, line_width=2, example=names) - - if boxes is not None: - for box, cls in zip(boxes, clss): - annotator.box_label(box, color=colors(int(cls), True), label=names[int(cls)]) - - obj = im0[int(box[1]):int(box[3]), int(box[0]):int(box[2])] - blur_obj = cv2.blur(obj, (blur_ratio, blur_ratio)) - - im0[int(box[1]):int(box[3]), int(box[0]):int(box[2])] = blur_obj - - cv2.imshow("ultralytics", im0) - video_writer.write(im0) - if cv2.waitKey(1) & 0xFF == ord('q'): - break - - cap.release() - video_writer.release() - cv2.destroyAllWindows() - ``` - -### Arguments `model.predict` - -| Name | Type | Default | Description | -|-----------------|----------------|------------------------|----------------------------------------------------------------------------| -| `source` | `str` | `'ultralytics/assets'` | source directory for images or videos | -| `conf` | `float` | `0.25` | object confidence threshold for detection | -| `iou` | `float` | `0.7` | intersection over union (IoU) threshold for NMS | -| `imgsz` | `int or tuple` | `640` | image size as scalar or (h, w) list, i.e. (640, 480) | -| `half` | `bool` | `False` | use half precision (FP16) | -| `device` | `None or str` | `None` | device to run on, i.e. cuda device=0/1/2/3 or device=cpu | -| `max_det` | `int` | `300` | maximum number of detections per image | -| `vid_stride` | `bool` | `False` | video frame-rate stride | -| `stream_buffer` | `bool` | `False` | buffer all streaming frames (True) or return the most recent frame (False) | -| `visualize` | `bool` | `False` | visualize model features | -| `augment` | `bool` | `False` | apply image augmentation to prediction sources | -| `agnostic_nms` | `bool` | `False` | class-agnostic NMS | -| `classes` | `list[int]` | `None` | filter results by class, i.e. classes=0, or classes=[0,2,3] | -| `retina_masks` | `bool` | `False` | use high-resolution segmentation masks | -| `embed` | `list[int]` | `None` | return feature vectors/embeddings from given layers | diff --git a/ultralytics-main/docs/en/guides/object-counting.md b/ultralytics-main/docs/en/guides/object-counting.md deleted file mode 100644 index 0c3ce72..0000000 --- a/ultralytics-main/docs/en/guides/object-counting.md +++ /dev/null @@ -1,246 +0,0 @@ ---- -comments: true -description: Object Counting Using Ultralytics YOLOv8 -keywords: Ultralytics, YOLOv8, Object Detection, Object Counting, Object Tracking, Notebook, IPython Kernel, CLI, Python SDK ---- - -# Object Counting using Ultralytics YOLOv8 🚀 - -## What is Object Counting? - -Object counting with [Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics/) involves accurate identification and counting of specific objects in videos and camera streams. YOLOv8 excels in real-time applications, providing efficient and precise object counting for various scenarios like crowd analysis and surveillance, thanks to its state-of-the-art algorithms and deep learning capabilities. - -

-
- -
- Watch: Object Counting using Ultralytics YOLOv8 -

- -## Advantages of Object Counting? - -- **Resource Optimization:** Object counting facilitates efficient resource management by providing accurate counts, and optimizing resource allocation in applications like inventory management. -- **Enhanced Security:** Object counting enhances security and surveillance by accurately tracking and counting entities, aiding in proactive threat detection. -- **Informed Decision-Making:** Object counting offers valuable insights for decision-making, optimizing processes in retail, traffic management, and various other domains. - -## Real World Applications - -| Logistics | Aquaculture | -|:-------------------------------------------------------------------------------------------------------------------------------------------------------------:|:---------------------------------------------------------------------------------------------------------------------------------------------------:| -| ![Conveyor Belt Packets Counting Using Ultralytics YOLOv8](https://github.com/RizwanMunawar/ultralytics/assets/62513924/70e2d106-510c-4c6c-a57a-d34a765aa757) | ![Fish Counting in Sea using Ultralytics YOLOv8](https://github.com/RizwanMunawar/ultralytics/assets/62513924/c60d047b-3837-435f-8d29-bb9fc95d2191) | -| Conveyor Belt Packets Counting Using Ultralytics YOLOv8 | Fish Counting in Sea using Ultralytics YOLOv8 | - -!!! Example "Object Counting using YOLOv8 Example" - - === "Count in Region" - - ```python - from ultralytics import YOLO - from ultralytics.solutions import object_counter - import cv2 - - model = YOLO("yolov8n.pt") - cap = cv2.VideoCapture("path/to/video/file.mp4") - assert cap.isOpened(), "Error reading video file" - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - # Define region points - region_points = [(20, 400), (1080, 404), (1080, 360), (20, 360)] - - # Video writer - video_writer = cv2.VideoWriter("object_counting_output.avi", - cv2.VideoWriter_fourcc(*'mp4v'), - fps, - (w, h)) - - # Init Object Counter - counter = object_counter.ObjectCounter() - counter.set_args(view_img=True, - reg_pts=region_points, - classes_names=model.names, - draw_tracks=True) - - while cap.isOpened(): - success, im0 = cap.read() - if not success: - print("Video frame is empty or video processing has been successfully completed.") - break - tracks = model.track(im0, persist=True, show=False) - - im0 = counter.start_counting(im0, tracks) - video_writer.write(im0) - - cap.release() - video_writer.release() - cv2.destroyAllWindows() - ``` - - === "Count in Polygon" - - ```python - from ultralytics import YOLO - from ultralytics.solutions import object_counter - import cv2 - - model = YOLO("yolov8n.pt") - cap = cv2.VideoCapture("path/to/video/file.mp4") - assert cap.isOpened(), "Error reading video file" - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - # Define region points as a polygon with 5 points - region_points = [(20, 400), (1080, 404), (1080, 360), (20, 360), (20, 400)] - - # Video writer - video_writer = cv2.VideoWriter("object_counting_output.avi", - cv2.VideoWriter_fourcc(*'mp4v'), - fps, - (w, h)) - - # Init Object Counter - counter = object_counter.ObjectCounter() - counter.set_args(view_img=True, - reg_pts=region_points, - classes_names=model.names, - draw_tracks=True) - - while cap.isOpened(): - success, im0 = cap.read() - if not success: - print("Video frame is empty or video processing has been successfully completed.") - break - tracks = model.track(im0, persist=True, show=False) - - im0 = counter.start_counting(im0, tracks) - video_writer.write(im0) - - cap.release() - video_writer.release() - cv2.destroyAllWindows() - ``` - - === "Count in Line" - - ```python - from ultralytics import YOLO - from ultralytics.solutions import object_counter - import cv2 - - model = YOLO("yolov8n.pt") - cap = cv2.VideoCapture("path/to/video/file.mp4") - assert cap.isOpened(), "Error reading video file" - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - # Define line points - line_points = [(20, 400), (1080, 400)] - - # Video writer - video_writer = cv2.VideoWriter("object_counting_output.avi", - cv2.VideoWriter_fourcc(*'mp4v'), - fps, - (w, h)) - - # Init Object Counter - counter = object_counter.ObjectCounter() - counter.set_args(view_img=True, - reg_pts=line_points, - classes_names=model.names, - draw_tracks=True) - - while cap.isOpened(): - success, im0 = cap.read() - if not success: - print("Video frame is empty or video processing has been successfully completed.") - break - tracks = model.track(im0, persist=True, show=False) - - im0 = counter.start_counting(im0, tracks) - video_writer.write(im0) - - cap.release() - video_writer.release() - cv2.destroyAllWindows() - ``` - - === "Specific Classes" - - ```python - from ultralytics import YOLO - from ultralytics.solutions import object_counter - import cv2 - - model = YOLO("yolov8n.pt") - cap = cv2.VideoCapture("path/to/video/file.mp4") - assert cap.isOpened(), "Error reading video file" - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - line_points = [(20, 400), (1080, 400)] # line or region points - classes_to_count = [0, 2] # person and car classes for count - - # Video writer - video_writer = cv2.VideoWriter("object_counting_output.avi", - cv2.VideoWriter_fourcc(*'mp4v'), - fps, - (w, h)) - - # Init Object Counter - counter = object_counter.ObjectCounter() - counter.set_args(view_img=True, - reg_pts=line_points, - classes_names=model.names, - draw_tracks=True) - - while cap.isOpened(): - success, im0 = cap.read() - if not success: - print("Video frame is empty or video processing has been successfully completed.") - break - tracks = model.track(im0, persist=True, show=False, - classes=classes_to_count) - - im0 = counter.start_counting(im0, tracks) - video_writer.write(im0) - - cap.release() - video_writer.release() - cv2.destroyAllWindows() - ``` - -???+ tip "Region is Movable" - - You can move the region anywhere in the frame by clicking on its edges - -### Optional Arguments `set_args` - -| Name | Type | Default | Description | -|-----------------------|-------------|----------------------------|-----------------------------------------------| -| `view_img` | `bool` | `False` | Display frames with counts | -| `view_in_counts` | `bool` | `True` | Display in-counts only on video frame | -| `view_out_counts` | `bool` | `True` | Display out-counts only on video frame | -| `line_thickness` | `int` | `2` | Increase bounding boxes thickness | -| `reg_pts` | `list` | `[(20, 400), (1260, 400)]` | Points defining the Region Area | -| `classes_names` | `dict` | `model.model.names` | Dictionary of Class Names | -| `region_color` | `RGB Color` | `(255, 0, 255)` | Color of the Object counting Region or Line | -| `track_thickness` | `int` | `2` | Thickness of Tracking Lines | -| `draw_tracks` | `bool` | `False` | Enable drawing Track lines | -| `track_color` | `RGB Color` | `(0, 255, 0)` | Color for each track line | -| `line_dist_thresh` | `int` | `15` | Euclidean Distance threshold for line counter | -| `count_txt_thickness` | `int` | `2` | Thickness of Object counts text | -| `count_txt_color` | `RGB Color` | `(0, 0, 0)` | Foreground color for Object counts text | -| `count_color` | `RGB Color` | `(255, 255, 255)` | Background color for Object counts text | -| `region_thickness` | `int` | `5` | Thickness for object counter region or line | - -### Arguments `model.track` - -| Name | Type | Default | Description | -|-----------|---------|----------------|-------------------------------------------------------------| -| `source` | `im0` | `None` | source directory for images or videos | -| `persist` | `bool` | `False` | persisting tracks between frames | -| `tracker` | `str` | `botsort.yaml` | Tracking method 'bytetrack' or 'botsort' | -| `conf` | `float` | `0.3` | Confidence Threshold | -| `iou` | `float` | `0.5` | IOU Threshold | -| `classes` | `list` | `None` | filter results by class, i.e. classes=0, or classes=[0,2,3] | -| `verbose` | `bool` | `True` | Display the object tracking results | diff --git a/ultralytics-main/docs/en/guides/object-cropping.md b/ultralytics-main/docs/en/guides/object-cropping.md deleted file mode 100644 index 240230a..0000000 --- a/ultralytics-main/docs/en/guides/object-cropping.md +++ /dev/null @@ -1,102 +0,0 @@ ---- -comments: true -description: Learn how to isolate and extract specific objects from images and videos using YOLOv8 object cropping. -keywords: Ultralytics, YOLOv8, Object Detection, Object Cropping, Image Analysis, Video Processing, Data Extraction, Python ---- - -# Object Cropping using Ultralytics YOLOv8 🚀 - -## What is Object Cropping? - -Object cropping with [Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics/) involves isolating and extracting specific detected objects from an image or video. The YOLOv8 model capabilities are utilized to accurately identify and delineate objects, enabling precise cropping for further analysis or manipulation. - -## Advantages of Object Cropping? - -- **Focused Analysis**: YOLOv8 facilitates targeted object cropping, allowing for in-depth examination or processing of individual items within a scene. -- **Reduced Data Volume**: By extracting only relevant objects, object cropping helps in minimizing data size, making it efficient for storage, transmission, or subsequent computational tasks. -- **Enhanced Precision**: YOLOv8's object detection accuracy ensures that the cropped objects maintain their spatial relationships, preserving the integrity of the visual information for detailed analysis. - -## Visuals - -| Airport Luggage | -|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| -| ![Conveyor Belt at Airport Suitcases Cropping using Ultralytics YOLOv8](https://github.com/RizwanMunawar/RizwanMunawar/assets/62513924/648f46be-f233-4307-a8e5-046eea38d2e4) | -| Suitcases Cropping at airport conveyor belt using Ultralytics YOLOv8 | - -!!! Example "Object Cropping using YOLOv8 Example" - - === "Object Cropping" - - ```python - from ultralytics import YOLO - from ultralytics.utils.plotting import Annotator, colors - import cv2 - import os - - model = YOLO("yolov8n.pt") - names = model.names - - cap = cv2.VideoCapture("path/to/video/file.mp4") - assert cap.isOpened(), "Error reading video file" - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - crop_dir_name = "ultralytics_crop" - if not os.path.exists(crop_dir_name): - os.mkdir(crop_dir_name) - - # Video writer - video_writer = cv2.VideoWriter("object_cropping_output.avi", - cv2.VideoWriter_fourcc(*'mp4v'), - fps, (w, h)) - - idx = 0 - while cap.isOpened(): - success, im0 = cap.read() - if not success: - print("Video frame is empty or video processing has been successfully completed.") - break - - results = model.predict(im0, show=False) - boxes = results[0].boxes.xyxy.cpu().tolist() - clss = results[0].boxes.cls.cpu().tolist() - annotator = Annotator(im0, line_width=2, example=names) - - if boxes is not None: - for box, cls in zip(boxes, clss): - idx += 1 - annotator.box_label(box, color=colors(int(cls), True), label=names[int(cls)]) - - crop_obj = im0[int(box[1]):int(box[3]), int(box[0]):int(box[2])] - - cv2.imwrite(os.path.join(crop_dir_name, str(idx)+".png"), crop_obj) - - cv2.imshow("ultralytics", im0) - video_writer.write(im0) - - if cv2.waitKey(1) & 0xFF == ord('q'): - break - - cap.release() - video_writer.release() - cv2.destroyAllWindows() - ``` - -### Arguments `model.predict` - -| Name | Type | Default | Description | -|-----------------|----------------|------------------------|----------------------------------------------------------------------------| -| `source` | `str` | `'ultralytics/assets'` | source directory for images or videos | -| `conf` | `float` | `0.25` | object confidence threshold for detection | -| `iou` | `float` | `0.7` | intersection over union (IoU) threshold for NMS | -| `imgsz` | `int or tuple` | `640` | image size as scalar or (h, w) list, i.e. (640, 480) | -| `half` | `bool` | `False` | use half precision (FP16) | -| `device` | `None or str` | `None` | device to run on, i.e. cuda device=0/1/2/3 or device=cpu | -| `max_det` | `int` | `300` | maximum number of detections per image | -| `vid_stride` | `bool` | `False` | video frame-rate stride | -| `stream_buffer` | `bool` | `False` | buffer all streaming frames (True) or return the most recent frame (False) | -| `visualize` | `bool` | `False` | visualize model features | -| `augment` | `bool` | `False` | apply image augmentation to prediction sources | -| `agnostic_nms` | `bool` | `False` | class-agnostic NMS | -| `classes` | `list[int]` | `None` | filter results by class, i.e. classes=0, or classes=[0,2,3] | -| `retina_masks` | `bool` | `False` | use high-resolution segmentation masks | -| `embed` | `list[int]` | `None` | return feature vectors/embeddings from given layers | diff --git a/ultralytics-main/docs/en/guides/optimizing-openvino-latency-vs-throughput-modes.md b/ultralytics-main/docs/en/guides/optimizing-openvino-latency-vs-throughput-modes.md deleted file mode 100644 index 8231be2..0000000 --- a/ultralytics-main/docs/en/guides/optimizing-openvino-latency-vs-throughput-modes.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -comments: true -description: Learn how to optimize Ultralytics YOLOv8 models with Intel OpenVINO for maximum performance. Discover expert techniques to minimize latency and maximize throughput for real-time object detection applications. -keywords: Ultralytics, YOLOv8, OpenVINO, optimization, latency, throughput, inference, object detection, deep learning, machine learning, guide, Intel ---- - -# Optimizing OpenVINO Inference for Ultralytics YOLO Models: A Comprehensive Guide - -OpenVINO Ecosystem - -## Introduction - -When deploying deep learning models, particularly those for object detection such as Ultralytics YOLO models, achieving optimal performance is crucial. This guide delves into leveraging Intel's OpenVINO toolkit to optimize inference, focusing on latency and throughput. Whether you're working on consumer-grade applications or large-scale deployments, understanding and applying these optimization strategies will ensure your models run efficiently on various devices. - -## Optimizing for Latency - -Latency optimization is vital for applications requiring immediate response from a single model given a single input, typical in consumer scenarios. The goal is to minimize the delay between input and inference result. However, achieving low latency involves careful consideration, especially when running concurrent inferences or managing multiple models. - -### Key Strategies for Latency Optimization: - -- **Single Inference per Device:** The simplest way to achieve low latency is by limiting to one inference at a time per device. Additional concurrency often leads to increased latency. -- **Leveraging Sub-Devices:** Devices like multi-socket CPUs or multi-tile GPUs can execute multiple requests with minimal latency increase by utilizing their internal sub-devices. -- **OpenVINO Performance Hints:** Utilizing OpenVINO's `ov::hint::PerformanceMode::LATENCY` for the `ov::hint::performance_mode` property during model compilation simplifies performance tuning, offering a device-agnostic and future-proof approach. - -### Managing First-Inference Latency: - -- **Model Caching:** To mitigate model load and compile times impacting latency, use model caching where possible. For scenarios where caching isn't viable, CPUs generally offer the fastest model load times. -- **Model Mapping vs. Reading:** To reduce load times, OpenVINO replaced model reading with mapping. However, if the model is on a removable or network drive, consider using `ov::enable_mmap(false)` to switch back to reading. -- **AUTO Device Selection:** This mode begins inference on the CPU, shifting to an accelerator once ready, seamlessly reducing first-inference latency. - -## Optimizing for Throughput - -Throughput optimization is crucial for scenarios serving numerous inference requests simultaneously, maximizing resource utilization without significantly sacrificing individual request performance. - -### Approaches to Throughput Optimization: - -1. **OpenVINO Performance Hints:** A high-level, future-proof method to enhance throughput across devices using performance hints. - - ```python - import openvino.properties as props - import openvino.properties.hint as hints - - config = {hints.performance_mode: hints.PerformanceMode.THROUGHPUT} - compiled_model = core.compile_model(model, "GPU", config) - ``` - -2. **Explicit Batching and Streams:** A more granular approach involving explicit batching and the use of streams for advanced performance tuning. - -### Designing Throughput-Oriented Applications: - -To maximize throughput, applications should: - -- Process inputs in parallel, making full use of the device's capabilities. -- Decompose data flow into concurrent inference requests, scheduled for parallel execution. -- Utilize the Async API with callbacks to maintain efficiency and avoid device starvation. - -### Multi-Device Execution: - -OpenVINO's multi-device mode simplifies scaling throughput by automatically balancing inference requests across devices without requiring application-level device management. - -## Conclusion - -Optimizing Ultralytics YOLO models for latency and throughput with OpenVINO can significantly enhance your application's performance. By carefully applying the strategies outlined in this guide, developers can ensure their models run efficiently, meeting the demands of various deployment scenarios. Remember, the choice between optimizing for latency or throughput depends on your specific application needs and the characteristics of the deployment environment. - -For more detailed technical information and the latest updates, refer to the [OpenVINO documentation](https://docs.openvino.ai/latest/index.html) and [Ultralytics YOLO repository](https://github.com/ultralytics/ultralytics). These resources provide in-depth guides, tutorials, and community support to help you get the most out of your deep learning models. - ---- - -Ensuring your models achieve optimal performance is not just about tweaking configurations; it's about understanding your application's needs and making informed decisions. Whether you're optimizing for real-time responses or maximizing throughput for large-scale processing, the combination of Ultralytics YOLO models and OpenVINO offers a powerful toolkit for developers to deploy high-performance AI solutions. diff --git a/ultralytics-main/docs/en/guides/raspberry-pi.md b/ultralytics-main/docs/en/guides/raspberry-pi.md deleted file mode 100644 index 15c37fc..0000000 --- a/ultralytics-main/docs/en/guides/raspberry-pi.md +++ /dev/null @@ -1,196 +0,0 @@ ---- -comments: true -description: Quick start guide to setting up YOLO on a Raspberry Pi with a Pi Camera using the libcamera stack. Detailed comparison between Raspberry Pi 3, 4 and 5 models. -keywords: Ultralytics, YOLO, Raspberry Pi, Pi Camera, libcamera, quick start guide, Raspberry Pi 4 vs Raspberry Pi 5, YOLO on Raspberry Pi, hardware setup, machine learning, AI ---- - -# Quick Start Guide: Raspberry Pi and Pi Camera with YOLOv5 and YOLOv8 - -This comprehensive guide aims to expedite your journey with YOLO object detection models on a [Raspberry Pi](https://www.raspberrypi.com/) using a [Pi Camera](https://www.raspberrypi.com/products/camera-module-v2/). Whether you're a student, hobbyist, or a professional, this guide is designed to get you up and running in less than 30 minutes. The instructions here are rigorously tested to minimize setup issues, allowing you to focus on utilizing YOLO for your specific projects. - -

-
- -
- Watch: Raspberry Pi 5 updates and improvements. -

- -## Prerequisites - -- Raspberry Pi 3, 4 or 5 -- Pi Camera -- 64-bit Raspberry Pi Operating System - -Connect the Pi Camera to your Raspberry Pi via a CSI cable and install the 64-bit Raspberry Pi Operating System. Verify your camera with the following command: - -```bash -libcamera-hello -``` - -You should see a video feed from your camera. - -## Choose Your YOLO Version: YOLOv5 or YOLOv8 - -This guide offers you the flexibility to start with either [YOLOv5](https://github.com/ultralytics/yolov5) or [YOLOv8](https://github.com/ultralytics/ultralytics). Both versions have their unique advantages and use-cases. The choice is yours, but remember, the guide's aim is not just quick setup but also a robust foundation for your future work in object detection. - -## Hardware Specifics: At a Glance - -To assist you in making an informed hardware decision, we've summarized the key hardware specifics of Raspberry Pi 3, 4, and 5 in the table below: - -| Feature | Raspberry Pi 3 | Raspberry Pi 4 | Raspberry Pi 5 | -|----------------------------|------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------|----------------------------------------------------------------------| -| **CPU** | 1.2GHz Quad-Core ARM Cortex-A53 | 1.5GHz Quad-core 64-bit ARM Cortex-A72 | 2.4GHz Quad-core 64-bit Arm Cortex-A76 | -| **RAM** | 1GB LPDDR2 | 2GB, 4GB or 8GB LPDDR4 | *Details not yet available* | -| **USB Ports** | 4 x USB 2.0 | 2 x USB 2.0, 2 x USB 3.0 | 2 x USB 3.0, 2 x USB 2.0 | -| **Network** | Ethernet & Wi-Fi 802.11n | Gigabit Ethernet & Wi-Fi 802.11ac | Gigabit Ethernet with PoE+ support, Dual-band 802.11ac Wi-Fi® | -| **Performance** | Slower, may require lighter YOLO models | Faster, can run complex YOLO models | *Details not yet available* | -| **Power Requirement** | 2.5A power supply | 3.0A USB-C power supply | *Details not yet available* | -| **Official Documentation** | [Link](https://www.raspberrypi.org/documentation/hardware/raspberrypi/bcm2837/README.md) | [Link](https://www.raspberrypi.org/documentation/hardware/raspberrypi/bcm2711/README.md) | [Link](https://www.raspberrypi.com/news/introducing-raspberry-pi-5/) | - -Please make sure to follow the instructions specific to your Raspberry Pi model to ensure a smooth setup process. - -## Quick Start with YOLOv5 - -This section outlines how to set up YOLOv5 on a Raspberry Pi with a Pi Camera. These steps are designed to be compatible with the libcamera camera stack introduced in Raspberry Pi OS Bullseye. - -### Install Necessary Packages - -1. Update the Raspberry Pi: - - ```bash - sudo apt-get update - sudo apt-get upgrade -y - sudo apt-get autoremove -y - ``` - -2. Clone the YOLOv5 repository: - - ```bash - cd ~ - git clone https://github.com/Ultralytics/yolov5.git - ``` - -3. Install the required dependencies: - - ```bash - cd ~/yolov5 - pip3 install -r requirements.txt - ``` - -4. For Raspberry Pi 3, install compatible versions of PyTorch and Torchvision (skip for Raspberry Pi 4): - - ```bash - pip3 uninstall torch torchvision - pip3 install torch==1.11.0 torchvision==0.12.0 - ``` - -### Modify `detect.py` - -To enable TCP streams via SSH or the CLI, minor modifications are needed in `detect.py`. - -1. Open `detect.py`: - - ```bash - sudo nano ~/yolov5/detect.py - ``` - -2. Find and modify the `is_url` line to accept TCP streams: - - ```python - is_url = source.lower().startswith(('rtsp://', 'rtmp://', 'http://', 'https://', 'tcp://')) - ``` - -3. Comment out the `view_img` line: - - ```python - # view_img = check_imshow(warn=True) - ``` - -4. Save and exit: - - ```bash - CTRL + O -> ENTER -> CTRL + X - ``` - -### Initiate TCP Stream with Libcamera - -1. Start the TCP stream: - - ```bash - libcamera-vid -n -t 0 --width 1280 --height 960 --framerate 1 --inline --listen -o tcp://127.0.0.1:8888 - ``` - -Keep this terminal session running for the next steps. - -### Perform YOLOv5 Inference - -1. Run the YOLOv5 detection: - - ```bash - cd ~/yolov5 - python3 detect.py --source=tcp://127.0.0.1:8888 - ``` - -## Quick Start with YOLOv8 - -Follow this section if you are interested in setting up YOLOv8 instead. The steps are quite similar but are tailored for YOLOv8's specific needs. - -### Install Necessary Packages - -1. Update the Raspberry Pi: - - ```bash - sudo apt-get update - sudo apt-get upgrade -y - sudo apt-get autoremove -y - ``` - -2. Install the `ultralytics` Python package: - - ```bash - pip3 install ultralytics - ``` - -3. Reboot: - - ```bash - sudo reboot - ``` - -### Initiate TCP Stream with Libcamera - -1. Start the TCP stream: - - ```bash - libcamera-vid -n -t 0 --width 1280 --height 960 --framerate 1 --inline --listen -o tcp://127.0.0.1:8888 - ``` - -### Perform YOLOv8 Inference - -To perform inference with YOLOv8, you can use the following Python code snippet: - -```python -from ultralytics import YOLO - -model = YOLO('yolov8n.pt') -results = model('tcp://127.0.0.1:8888', stream=True) - -while True: - for result in results: - boxes = result.boxes - probs = result.probs -``` - -## Next Steps - -Congratulations on successfully setting up YOLO on your Raspberry Pi! For further learning and support, visit [Ultralytics](https://ultralytics.com/) and [Kashmir World Foundation](https://www.kashmirworldfoundation.org/). - -## Acknowledgements and Citations - -This guide was initially created by Daan Eeltink for Kashmir World Foundation, an organization dedicated to the use of YOLO for the conservation of endangered species. We acknowledge their pioneering work and educational focus in the realm of object detection technologies. - -For more information about Kashmir World Foundation's activities, you can visit their [website](https://www.kashmirworldfoundation.org/). diff --git a/ultralytics-main/docs/en/guides/region-counting.md b/ultralytics-main/docs/en/guides/region-counting.md deleted file mode 100644 index 7a922eb..0000000 --- a/ultralytics-main/docs/en/guides/region-counting.md +++ /dev/null @@ -1,86 +0,0 @@ ---- -comments: true -description: Object Counting in Different Region using Ultralytics YOLOv8 -keywords: Ultralytics, YOLOv8, Object Detection, Object Counting, Object Tracking, Notebook, IPython Kernel, CLI, Python SDK ---- - -# Object Counting in Different Regions using Ultralytics YOLOv8 🚀 - -## What is Object Counting in Regions? - -[Object counting](https://docs.ultralytics.com/guides/object-counting/) in regions with [Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics/) involves precisely determining the number of objects within specified areas using advanced computer vision. This approach is valuable for optimizing processes, enhancing security, and improving efficiency in various applications. - -

-
- -
- Watch: Ultralytics YOLOv8 Object Counting in Multiple & Movable Regions -

- -## Advantages of Object Counting in Regions? - -- **Precision and Accuracy:** Object counting in regions with advanced computer vision ensures precise and accurate counts, minimizing errors often associated with manual counting. -- **Efficiency Improvement:** Automated object counting enhances operational efficiency, providing real-time results and streamlining processes across different applications. -- **Versatility and Application:** The versatility of object counting in regions makes it applicable across various domains, from manufacturing and surveillance to traffic monitoring, contributing to its widespread utility and effectiveness. - -## Real World Applications - -| Retail | Market Streets | -|:------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------:| -| ![People Counting in Different Region using Ultralytics YOLOv8](https://github.com/RizwanMunawar/ultralytics/assets/62513924/5ab3bbd7-fd12-4849-928e-5f294d6c3fcf) | ![Crowd Counting in Different Region using Ultralytics YOLOv8](https://github.com/RizwanMunawar/ultralytics/assets/62513924/e7c1aea7-474d-4d78-8d48-b50854ffe1ca) | -| People Counting in Different Region using Ultralytics YOLOv8 | Crowd Counting in Different Region using Ultralytics YOLOv8 | - -## Steps to Run - -### Step 1: Install Required Libraries - -Begin by cloning the Ultralytics repository, installing dependencies, and navigating to the local directory using the provided commands in Step 2. - -```bash -# Clone Ultralytics repo -git clone https://github.com/ultralytics/ultralytics - -# Navigate to the local directory -cd ultralytics/examples/YOLOv8-Region-Counter -``` - -### Step 2: Run Region Counting Using Ultralytics YOLOv8 - -Execute the following basic commands for inference. - -???+ tip "Region is Movable" - - During video playback, you can interactively move the region within the video by clicking and dragging using the left mouse button. - -```bash -# Save results -python yolov8_region_counter.py --source "path/to/video.mp4" --save-img - -# Run model on CPU -python yolov8_region_counter.py --source "path/to/video.mp4" --device cpu - -# Change model file -python yolov8_region_counter.py --source "path/to/video.mp4" --weights "path/to/model.pt" - -# Detect specific classes (e.g., first and third classes) -python yolov8_region_counter.py --source "path/to/video.mp4" --classes 0 2 - -# View results without saving -python yolov8_region_counter.py --source "path/to/video.mp4" --view-img -``` - -### Optional Arguments - -| Name | Type | Default | Description | -|----------------------|--------|--------------|--------------------------------------------| -| `--source` | `str` | `None` | Path to video file, for webcam 0 | -| `--line_thickness` | `int` | `2` | Bounding Box thickness | -| `--save-img` | `bool` | `False` | Save the predicted video/image | -| `--weights` | `str` | `yolov8n.pt` | Weights file path | -| `--classes` | `list` | `None` | Detect specific classes i.e. --classes 0 2 | -| `--region-thickness` | `int` | `2` | Region Box thickness | -| `--track-thickness` | `int` | `2` | Tracking line thickness | diff --git a/ultralytics-main/docs/en/guides/sahi-tiled-inference.md b/ultralytics-main/docs/en/guides/sahi-tiled-inference.md deleted file mode 100644 index 9728703..0000000 --- a/ultralytics-main/docs/en/guides/sahi-tiled-inference.md +++ /dev/null @@ -1,185 +0,0 @@ ---- -comments: true -description: A comprehensive guide on how to use YOLOv8 with SAHI for standard and sliced inference in object detection tasks. -keywords: YOLOv8, SAHI, Sliced Inference, Object Detection, Ultralytics, Large Scale Image Analysis, High-Resolution Imagery ---- - -# Ultralytics Docs: Using YOLOv8 with SAHI for Sliced Inference - -Welcome to the Ultralytics documentation on how to use YOLOv8 with [SAHI](https://github.com/obss/sahi) (Slicing Aided Hyper Inference). This comprehensive guide aims to furnish you with all the essential knowledge you'll need to implement SAHI alongside YOLOv8. We'll deep-dive into what SAHI is, why sliced inference is critical for large-scale applications, and how to integrate these functionalities with YOLOv8 for enhanced object detection performance. - -

- SAHI Sliced Inference Overview -

- -## Introduction to SAHI - -SAHI (Slicing Aided Hyper Inference) is an innovative library designed to optimize object detection algorithms for large-scale and high-resolution imagery. Its core functionality lies in partitioning images into manageable slices, running object detection on each slice, and then stitching the results back together. SAHI is compatible with a range of object detection models, including the YOLO series, thereby offering flexibility while ensuring optimized use of computational resources. - -### Key Features of SAHI - -- **Seamless Integration**: SAHI integrates effortlessly with YOLO models, meaning you can start slicing and detecting without a lot of code modification. -- **Resource Efficiency**: By breaking down large images into smaller parts, SAHI optimizes the memory usage, allowing you to run high-quality detection on hardware with limited resources. -- **High Accuracy**: SAHI maintains the detection accuracy by employing smart algorithms to merge overlapping detection boxes during the stitching process. - -## What is Sliced Inference? - -Sliced Inference refers to the practice of subdividing a large or high-resolution image into smaller segments (slices), conducting object detection on these slices, and then recompiling the slices to reconstruct the object locations on the original image. This technique is invaluable in scenarios where computational resources are limited or when working with extremely high-resolution images that could otherwise lead to memory issues. - -### Benefits of Sliced Inference - -- **Reduced Computational Burden**: Smaller image slices are faster to process, and they consume less memory, enabling smoother operation on lower-end hardware. - -- **Preserved Detection Quality**: Since each slice is treated independently, there is no reduction in the quality of object detection, provided the slices are large enough to capture the objects of interest. - -- **Enhanced Scalability**: The technique allows for object detection to be more easily scaled across different sizes and resolutions of images, making it ideal for a wide range of applications from satellite imagery to medical diagnostics. - - - - - - - - - - -
YOLOv8 without SAHIYOLOv8 with SAHI
YOLOv8 without SAHIYOLOv8 with SAHI
- -## Installation and Preparation - -### Installation - -To get started, install the latest versions of SAHI and Ultralytics: - -```bash -pip install -U ultralytics sahi -``` - -### Import Modules and Download Resources - -Here's how to import the necessary modules and download a YOLOv8 model and some test images: - -```python -from sahi.utils.yolov8 import download_yolov8s_model -from sahi import AutoDetectionModel -from sahi.utils.cv import read_image -from sahi.utils.file import download_from_url -from sahi.predict import get_prediction, get_sliced_prediction, predict -from pathlib import Path -from IPython.display import Image - -# Download YOLOv8 model -yolov8_model_path = "models/yolov8s.pt" -download_yolov8s_model(yolov8_model_path) - -# Download test images -download_from_url('https://raw.githubusercontent.com/obss/sahi/main/demo/demo_data/small-vehicles1.jpeg', 'demo_data/small-vehicles1.jpeg') -download_from_url('https://raw.githubusercontent.com/obss/sahi/main/demo/demo_data/terrain2.png', 'demo_data/terrain2.png') -``` - -## Standard Inference with YOLOv8 - -### Instantiate the Model - -You can instantiate a YOLOv8 model for object detection like this: - -```python -detection_model = AutoDetectionModel.from_pretrained( - model_type='yolov8', - model_path=yolov8_model_path, - confidence_threshold=0.3, - device="cpu", # or 'cuda:0' -) -``` - -### Perform Standard Prediction - -Perform standard inference using an image path or a numpy image. - -```python -# With an image path -result = get_prediction("demo_data/small-vehicles1.jpeg", detection_model) - -# With a numpy image -result = get_prediction(read_image("demo_data/small-vehicles1.jpeg"), detection_model) -``` - -### Visualize Results - -Export and visualize the predicted bounding boxes and masks: - -```python -result.export_visuals(export_dir="demo_data/") -Image("demo_data/prediction_visual.png") -``` - -## Sliced Inference with YOLOv8 - -Perform sliced inference by specifying the slice dimensions and overlap ratios: - -```python -result = get_sliced_prediction( - "demo_data/small-vehicles1.jpeg", - detection_model, - slice_height=256, - slice_width=256, - overlap_height_ratio=0.2, - overlap_width_ratio=0.2 -) -``` - -## Handling Prediction Results - -SAHI provides a `PredictionResult` object, which can be converted into various annotation formats: - -```python -# Access the object prediction list -object_prediction_list = result.object_prediction_list - -# Convert to COCO annotation, COCO prediction, imantics, and fiftyone formats -result.to_coco_annotations()[:3] -result.to_coco_predictions(image_id=1)[:3] -result.to_imantics_annotations()[:3] -result.to_fiftyone_detections()[:3] -``` - -## Batch Prediction - -For batch prediction on a directory of images: - -```python -predict( - model_type="yolov8", - model_path="path/to/yolov8n.pt", - model_device="cpu", # or 'cuda:0' - model_confidence_threshold=0.4, - source="path/to/dir", - slice_height=256, - slice_width=256, - overlap_height_ratio=0.2, - overlap_width_ratio=0.2, -) -``` - -That's it! Now you're equipped to use YOLOv8 with SAHI for both standard and sliced inference. - -## Citations and Acknowledgments - -If you use SAHI in your research or development work, please cite the original SAHI paper and acknowledge the authors: - -!!! Quote "" - - === "BibTeX" - - ```bibtex - @article{akyon2022sahi, - title={Slicing Aided Hyper Inference and Fine-tuning for Small Object Detection}, - author={Akyon, Fatih Cagatay and Altinuc, Sinan Onur and Temizel, Alptekin}, - journal={2022 IEEE International Conference on Image Processing (ICIP)}, - doi={10.1109/ICIP46576.2022.9897990}, - pages={966-970}, - year={2022} - } - ``` - -We extend our thanks to the SAHI research group for creating and maintaining this invaluable resource for the computer vision community. For more information about SAHI and its creators, visit the [SAHI GitHub repository](https://github.com/obss/sahi). diff --git a/ultralytics-main/docs/en/guides/security-alarm-system.md b/ultralytics-main/docs/en/guides/security-alarm-system.md deleted file mode 100644 index c572822..0000000 --- a/ultralytics-main/docs/en/guides/security-alarm-system.md +++ /dev/null @@ -1,166 +0,0 @@ ---- -comments: true -description: Security Alarm System Project Using Ultralytics YOLOv8. Learn How to implement a Security Alarm System Using ultralytics YOLOv8 -keywords: Object Detection, Security Alarm, Object Tracking, YOLOv8, Computer Vision Projects ---- - -# Security Alarm System Project Using Ultralytics YOLOv8 - -Security Alarm System - -The Security Alarm System Project utilizing Ultralytics YOLOv8 integrates advanced computer vision capabilities to enhance security measures. YOLOv8, developed by Ultralytics, provides real-time object detection, allowing the system to identify and respond to potential security threats promptly. This project offers several advantages: - -- **Real-time Detection:** YOLOv8's efficiency enables the Security Alarm System to detect and respond to security incidents in real-time, minimizing response time. -- **Accuracy:** YOLOv8 is known for its accuracy in object detection, reducing false positives and enhancing the reliability of the security alarm system. -- **Integration Capabilities:** The project can be seamlessly integrated with existing security infrastructure, providing an upgraded layer of intelligent surveillance. - -

-
- -
- Watch: Security Alarm System Project with Ultralytics YOLOv8 Object Detection -

- -### Code - -#### Import Libraries - -```python -import torch -import numpy as np -import cv2 -from time import time -from ultralytics import YOLO -from ultralytics.utils.plotting import Annotator, colors -import smtplib -from email.mime.multipart import MIMEMultipart -from email.mime.text import MIMEText -``` - -#### Set up the parameters of the message - -???+ tip "Note" - - App Password Generation is necessary - -- Navigate to [App Password Generator](https://myaccount.google.com/apppasswords), designate an app name such as "security project," and obtain a 16-digit password. Copy this password and paste it into the designated password field as instructed. - -```python -password = "" -from_email = "" # must match the email used to generate the password -to_email = "" # receiver email -``` - -#### Server creation and authentication - -```python -server = smtplib.SMTP('smtp.gmail.com: 587') -server.starttls() -server.login(from_email, password) -``` - -#### Email Send Function - -```python -def send_email(to_email, from_email, object_detected=1): - message = MIMEMultipart() - message['From'] = from_email - message['To'] = to_email - message['Subject'] = "Security Alert" - # Add in the message body - message_body = f'ALERT - {object_detected} objects has been detected!!' - - message.attach(MIMEText(message_body, 'plain')) - server.sendmail(from_email, to_email, message.as_string()) -``` - -#### Object Detection and Alert Sender - -```python -class ObjectDetection: - def __init__(self, capture_index): - # default parameters - self.capture_index = capture_index - self.email_sent = False - - # model information - self.model = YOLO("yolov8n.pt") - - # visual information - self.annotator = None - self.start_time = 0 - self.end_time = 0 - - # device information - self.device = 'cuda' if torch.cuda.is_available() else 'cpu' - - def predict(self, im0): - results = self.model(im0) - return results - - def display_fps(self, im0): - self.end_time = time() - fps = 1 / np.round(self.end_time - self.start_time, 2) - text = f'FPS: {int(fps)}' - text_size = cv2.getTextSize(text, cv2.FONT_HERSHEY_SIMPLEX, 1.0, 2)[0] - gap = 10 - cv2.rectangle(im0, (20 - gap, 70 - text_size[1] - gap), (20 + text_size[0] + gap, 70 + gap), (255, 255, 255), -1) - cv2.putText(im0, text, (20, 70), cv2.FONT_HERSHEY_SIMPLEX, 1.0, (0, 0, 0), 2) - - def plot_bboxes(self, results, im0): - class_ids = [] - self.annotator = Annotator(im0, 3, results[0].names) - boxes = results[0].boxes.xyxy.cpu() - clss = results[0].boxes.cls.cpu().tolist() - names = results[0].names - for box, cls in zip(boxes, clss): - class_ids.append(cls) - self.annotator.box_label(box, label=names[int(cls)], color=colors(int(cls), True)) - return im0, class_ids - - def __call__(self): - cap = cv2.VideoCapture(self.capture_index) - assert cap.isOpened() - cap.set(cv2.CAP_PROP_FRAME_WIDTH, 640) - cap.set(cv2.CAP_PROP_FRAME_HEIGHT, 480) - frame_count = 0 - while True: - self.start_time = time() - ret, im0 = cap.read() - assert ret - results = self.predict(im0) - im0, class_ids = self.plot_bboxes(results, im0) - - if len(class_ids) > 0: # Only send email If not sent before - if not self.email_sent: - send_email(to_email, from_email, len(class_ids)) - self.email_sent = True - else: - self.email_sent = False - - self.display_fps(im0) - cv2.imshow('YOLOv8 Detection', im0) - frame_count += 1 - if cv2.waitKey(5) & 0xFF == 27: - break - cap.release() - cv2.destroyAllWindows() - server.quit() -``` - -#### Call the Object Detection class and Run the Inference - -```python -detector = ObjectDetection(capture_index=0) -detector() -``` - -That's it! When you execute the code, you'll receive a single notification on your email if any object is detected. The notification is sent immediately, not repeatedly. However, feel free to customize the code to suit your project requirements. - -#### Email Received Sample - -Email Received Sample diff --git a/ultralytics-main/docs/en/guides/speed-estimation.md b/ultralytics-main/docs/en/guides/speed-estimation.md deleted file mode 100644 index de3f527..0000000 --- a/ultralytics-main/docs/en/guides/speed-estimation.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -comments: true -description: Speed Estimation Using Ultralytics YOLOv8 -keywords: Ultralytics, YOLOv8, Object Detection, Speed Estimation, Object Tracking, Notebook, IPython Kernel, CLI, Python SDK ---- - -# Speed Estimation using Ultralytics YOLOv8 🚀 - -## What is Speed Estimation? - -Speed estimation is the process of calculating the rate of movement of an object within a given context, often employed in computer vision applications. Using [Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics/) you can now calculate the speed of object using [object tracking](https://docs.ultralytics.com/modes/track/) alongside distance and time data, crucial for tasks like traffic and surveillance. The accuracy of speed estimation directly influences the efficiency and reliability of various applications, making it a key component in the advancement of intelligent systems and real-time decision-making processes. - -

-
- -
- Watch: Speed Estimation using Ultralytics YOLOv8 -

- -## Advantages of Speed Estimation? - -- **Efficient Traffic Control:** Accurate speed estimation aids in managing traffic flow, enhancing safety, and reducing congestion on roadways. -- **Precise Autonomous Navigation:** In autonomous systems like self-driving cars, reliable speed estimation ensures safe and accurate vehicle navigation. -- **Enhanced Surveillance Security:** Speed estimation in surveillance analytics helps identify unusual behaviors or potential threats, improving the effectiveness of security measures. - -## Real World Applications - -| Transportation | Transportation | -|:-------------------------------------------------------------------------------------------------------------------------------------------------------:|:---------------------------------------------------------------------------------------------------------------------------------------------------------:| -| ![Speed Estimation on Road using Ultralytics YOLOv8](https://github.com/RizwanMunawar/ultralytics/assets/62513924/c8a0fd4a-d394-436d-8de3-d5b754755fc7) | ![Speed Estimation on Bridge using Ultralytics YOLOv8](https://github.com/RizwanMunawar/ultralytics/assets/62513924/cee10e02-b268-4304-b73a-5b9cb42da669) | -| Speed Estimation on Road using Ultralytics YOLOv8 | Speed Estimation on Bridge using Ultralytics YOLOv8 | - -!!! Example "Speed Estimation using YOLOv8 Example" - - === "Speed Estimation" - - ```python - from ultralytics import YOLO - from ultralytics.solutions import speed_estimation - import cv2 - - model = YOLO("yolov8n.pt") - names = model.model.names - - cap = cv2.VideoCapture("path/to/video/file.mp4") - assert cap.isOpened(), "Error reading video file" - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - # Video writer - video_writer = cv2.VideoWriter("speed_estimation.avi", - cv2.VideoWriter_fourcc(*'mp4v'), - fps, - (w, h)) - - line_pts = [(0, 360), (1280, 360)] - - # Init speed-estimation obj - speed_obj = speed_estimation.SpeedEstimator() - speed_obj.set_args(reg_pts=line_pts, - names=names, - view_img=True) - - while cap.isOpened(): - - success, im0 = cap.read() - if not success: - print("Video frame is empty or video processing has been successfully completed.") - break - - tracks = model.track(im0, persist=True, show=False) - - im0 = speed_obj.estimate_speed(im0, tracks) - video_writer.write(im0) - - cap.release() - video_writer.release() - cv2.destroyAllWindows() - - ``` - -???+ warning "Speed is Estimate" - - Speed will be an estimate and may not be completely accurate. Additionally, the estimation can vary depending on GPU speed. - -### Optional Arguments `set_args` - -| Name | Type | Default | Description | -|--------------------|--------|----------------------------|---------------------------------------------------| -| `reg_pts` | `list` | `[(20, 400), (1260, 400)]` | Points defining the Region Area | -| `names` | `dict` | `None` | Classes names | -| `view_img` | `bool` | `False` | Display frames with counts | -| `line_thickness` | `int` | `2` | Increase bounding boxes thickness | -| `region_thickness` | `int` | `5` | Thickness for object counter region or line | -| `spdl_dist_thresh` | `int` | `10` | Euclidean Distance threshold for speed check line | - -### Arguments `model.track` - -| Name | Type | Default | Description | -|-----------|---------|----------------|-------------------------------------------------------------| -| `source` | `im0` | `None` | source directory for images or videos | -| `persist` | `bool` | `False` | persisting tracks between frames | -| `tracker` | `str` | `botsort.yaml` | Tracking method 'bytetrack' or 'botsort' | -| `conf` | `float` | `0.3` | Confidence Threshold | -| `iou` | `float` | `0.5` | IOU Threshold | -| `classes` | `list` | `None` | filter results by class, i.e. classes=0, or classes=[0,2,3] | -| `verbose` | `bool` | `True` | Display the object tracking results | diff --git a/ultralytics-main/docs/en/guides/triton-inference-server.md b/ultralytics-main/docs/en/guides/triton-inference-server.md deleted file mode 100644 index 6f3b1d2..0000000 --- a/ultralytics-main/docs/en/guides/triton-inference-server.md +++ /dev/null @@ -1,137 +0,0 @@ ---- -comments: true -description: A step-by-step guide on integrating Ultralytics YOLOv8 with Triton Inference Server for scalable and high-performance deep learning inference deployments. -keywords: YOLOv8, Triton Inference Server, ONNX, Deep Learning Deployment, Scalable Inference, Ultralytics, NVIDIA, Object Detection, Cloud Inference ---- - -# Triton Inference Server with Ultralytics YOLOv8 - -The [Triton Inference Server](https://developer.nvidia.com/nvidia-triton-inference-server) (formerly known as TensorRT Inference Server) is an open-source software solution developed by NVIDIA. It provides a cloud inference solution optimized for NVIDIA GPUs. Triton simplifies the deployment of AI models at scale in production. Integrating Ultralytics YOLOv8 with Triton Inference Server allows you to deploy scalable, high-performance deep learning inference workloads. This guide provides steps to set up and test the integration. - -

-
- -
- Watch: Getting Started with NVIDIA Triton Inference Server. -

- -## What is Triton Inference Server? - -Triton Inference Server is designed to deploy a variety of AI models in production. It supports a wide range of deep learning and machine learning frameworks, including TensorFlow, PyTorch, ONNX Runtime, and many others. Its primary use cases are: - -- Serving multiple models from a single server instance. -- Dynamic model loading and unloading without server restart. -- Ensemble inference, allowing multiple models to be used together to achieve results. -- Model versioning for A/B testing and rolling updates. - -## Prerequisites - -Ensure you have the following prerequisites before proceeding: - -- Docker installed on your machine. -- Install `tritonclient`: - ```bash - pip install tritonclient[all] - ``` - -## Exporting YOLOv8 to ONNX Format - -Before deploying the model on Triton, it must be exported to the ONNX format. ONNX (Open Neural Network Exchange) is a format that allows models to be transferred between different deep learning frameworks. Use the `export` function from the `YOLO` class: - -```python -from ultralytics import YOLO - -# Load a model -model = YOLO('yolov8n.pt') # load an official model - -# Export the model -onnx_file = model.export(format='onnx', dynamic=True) -``` - -## Setting Up Triton Model Repository - -The Triton Model Repository is a storage location where Triton can access and load models. - -1. Create the necessary directory structure: - - ```python - from pathlib import Path - - # Define paths - triton_repo_path = Path('tmp') / 'triton_repo' - triton_model_path = triton_repo_path / 'yolo' - - # Create directories - (triton_model_path / '1').mkdir(parents=True, exist_ok=True) - ``` - -2. Move the exported ONNX model to the Triton repository: - - ```python - from pathlib import Path - - # Move ONNX model to Triton Model path - Path(onnx_file).rename(triton_model_path / '1' / 'model.onnx') - - # Create config file - (triton_model_path / 'config.pbtxt').touch() - ``` - -## Running Triton Inference Server - -Run the Triton Inference Server using Docker: - -```python -import subprocess -import time - -from tritonclient.http import InferenceServerClient - -# Define image https://catalog.ngc.nvidia.com/orgs/nvidia/containers/tritonserver -tag = 'nvcr.io/nvidia/tritonserver:23.09-py3' # 6.4 GB - -# Pull the image -subprocess.call(f'docker pull {tag}', shell=True) - -# Run the Triton server and capture the container ID -container_id = subprocess.check_output( - f'docker run -d --rm -v {triton_repo_path}:/models -p 8000:8000 {tag} tritonserver --model-repository=/models', - shell=True).decode('utf-8').strip() - -# Wait for the Triton server to start -triton_client = InferenceServerClient(url='localhost:8000', verbose=False, ssl=False) - -# Wait until model is ready -for _ in range(10): - with contextlib.suppress(Exception): - assert triton_client.is_model_ready(model_name) - break - time.sleep(1) -``` - -Then run inference using the Triton Server model: - -```python -from ultralytics import YOLO - -# Load the Triton Server model -model = YOLO(f'http://localhost:8000/yolo', task='detect') - -# Run inference on the server -results = model('path/to/image.jpg') -``` - -Cleanup the container: - -```python -# Kill and remove the container at the end of the test -subprocess.call(f'docker kill {container_id}', shell=True) -``` - ---- - -By following the above steps, you can deploy and run Ultralytics YOLOv8 models efficiently on Triton Inference Server, providing a scalable and high-performance solution for deep learning inference tasks. If you face any issues or have further queries, refer to the [official Triton documentation](https://docs.nvidia.com/deeplearning/triton-inference-server/user-guide/docs/index.html) or reach out to the Ultralytics community for support. diff --git a/ultralytics-main/docs/en/guides/view-results-in-terminal.md b/ultralytics-main/docs/en/guides/view-results-in-terminal.md deleted file mode 100644 index d0a00bb..0000000 --- a/ultralytics-main/docs/en/guides/view-results-in-terminal.md +++ /dev/null @@ -1,146 +0,0 @@ ---- -comments: true -description: Learn how to view image results inside a compatible VSCode terminal. -keywords: YOLOv8, VSCode, Terminal, Remote Development, Ultralytics, SSH, Object Detection, Inference, Results, Remote Tunnel, Images, Helpful, Productivity Hack ---- - -# Viewing Inference Results in a Terminal - -

- Sixel example of image in Terminal -

- -Image from the the [libsixel](https://saitoha.github.io/libsixel/) website. - -## Motivation - -When connecting to a remote machine, normally visualizing image results is not possible or requires moving data to a local device with a GUI. The VSCode integrated terminal allows for directly rendering images. This is a short demonstration on how to use this in conjunction with `ultralytics` with [prediction results](../modes/predict.md). - -!!! warning - - Only compatible with Linux and MacOS. Check the VSCode [repository](https://github.com/microsoft/vscode), check [Issue status](https://github.com/microsoft/vscode/issues/198622), or [documentation](https://code.visualstudio.com/docs) for updates about Windows support to view images in terminal with `sixel`. - -The VSCode compatible protocols for viewing images using the integrated terminal are [`sixel`](https://en.wikipedia.org/wiki/Sixel) and [`iTerm`](https://iterm2.com/documentation-images.html). This guide will demonstrate use of the `sixel` protocol. - -## Process - -1. First, you must enable settings `terminal.integrated.enableImages` and `terminal.integrated.gpuAcceleration` in VSCode. - - ```yaml - "terminal.integrated.gpuAcceleration": "auto" # "auto" is default, can also use "on" - "terminal.integrated.enableImages": false - ``` - -

- VSCode enable terminal images setting -

- -1. Install the `python-sixel` library in your virtual environment. This is a [fork](https://github.com/lubosz/python-sixel?tab=readme-ov-file) of the `PySixel` library, which is no longer maintained. - - ```bash - pip install sixel - ``` - -1. Import the relevant libraries - - ```py - import io - - import cv2 as cv - - from ultralytics import YOLO - from sixel import SixelWriter - ``` - -1. Load a model and execute inference, then plot the results and store in a variable. See more about inference arguments and working with results on the [predict mode](../modes/predict.md) page. - - ```{ .py .annotate } - from ultralytics import YOLO - - # Load a model - model = YOLO("yolov8n.pt") - - # Run inference on an image - results = model.predict(source="ultralytics/assets/bus.jpg") - - # Plot inference results - plot = results[0].plot() #(1)! - ``` - - 1. See [plot method parameters](../modes/predict.md#plot-method-parameters) to see possible arguments to use. - -1. Now, use OpenCV to convert the `numpy.ndarray` to `bytes` data. Then use `io.BytesIO` to make a "file-like" object. - - ```{ .py .annotate } - # Results image as bytes - im_bytes = cv.imencode( - ".png", #(1)! - plot, - )[1].tobytes() #(2)! - - # Image bytes as a file-like object - mem_file = io.BytesIO(im_bytes) - ``` - - 1. It's possible to use other image extensions as well. - 2. Only the object at index `1` that is returned is needed. - -1. Create a `SixelWriter` instance, and then use the `.draw()` method to draw the image in the terminal. - - ```py - # Create sixel writer object - w = SixelWriter() - - # Draw the sixel image in the terminal - w.draw(mem_file) - ``` - -## Example Inference Results - -

- View Image in Terminal -

- -!!! danger - - Using this example with videos or animated GIF frames has **not** been tested. Attempt at your own risk. - -## Full Code Example - -```{ .py .annotate } -import io - -import cv2 as cv - -from ultralytics import YOLO -from sixel import SixelWriter - -# Load a model -model = YOLO("yolov8n.pt") - -# Run inference on an image -results = model.predict(source="ultralytics/assets/bus.jpg") - -# Plot inference results -plot = results[0].plot() #(3)! - -# Results image as bytes -im_bytes = cv.imencode( - ".png", #(1)! - plot, - )[1].tobytes() #(2)! - -mem_file = io.BytesIO(im_bytes) -w = SixelWriter() -w.draw(mem_file) -``` - -1. It's possible to use other image extensions as well. -2. Only the object at index `1` that is returned is needed. -3. See [plot method parameters](../modes/predict.md#plot-method-parameters) to see possible arguments to use. - ---- - -!!! tip - - You may need to use `clear` to "erase" the view of the image in the terminal. diff --git a/ultralytics-main/docs/en/guides/vision-eye.md b/ultralytics-main/docs/en/guides/vision-eye.md deleted file mode 100644 index 3001772..0000000 --- a/ultralytics-main/docs/en/guides/vision-eye.md +++ /dev/null @@ -1,177 +0,0 @@ ---- -comments: true -description: VisionEye View Object Mapping using Ultralytics YOLOv8 -keywords: Ultralytics, YOLOv8, Object Detection, Object Tracking, IDetection, VisionEye, Computer Vision, Notebook, IPython Kernel, CLI, Python SDK ---- - -# VisionEye View Object Mapping using Ultralytics YOLOv8 🚀 - -## What is VisionEye Object Mapping? - -[Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics/) VisionEye offers the capability for computers to identify and pinpoint objects, simulating the observational precision of the human eye. This functionality enables computers to discern and focus on specific objects, much like the way the human eye observes details from a particular viewpoint. - -## Samples - -| VisionEye View | VisionEye View With Object Tracking | VisionEye View With Distance Calculation | -|:------------------------------------------------------------------------------------------------------------------------------------------------------------:|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| -| ![VisionEye View Object Mapping using Ultralytics YOLOv8](https://github.com/RizwanMunawar/ultralytics/assets/62513924/7d593acc-2e37-41b0-ad0e-92b4ffae6647) | ![VisionEye View Object Mapping with Object Tracking using Ultralytics YOLOv8](https://github.com/RizwanMunawar/ultralytics/assets/62513924/fcd85952-390f-451e-8fb0-b82e943af89c) | ![VisionEye View with Distance Calculation using Ultralytics YOLOv8](https://github.com/RizwanMunawar/RizwanMunawar/assets/62513924/18c4dafe-a22e-4fa9-a7d4-2bb293562a95) | -| VisionEye View Object Mapping using Ultralytics YOLOv8 | VisionEye View Object Mapping with Object Tracking using Ultralytics YOLOv8 | VisionEye View with Distance Calculation using Ultralytics YOLOv8 | - -!!! Example "VisionEye Object Mapping using YOLOv8" - - === "VisionEye Object Mapping" - - ```python - import cv2 - from ultralytics import YOLO - from ultralytics.utils.plotting import colors, Annotator - - model = YOLO("yolov8n.pt") - names = model.model.names - cap = cv2.VideoCapture("path/to/video/file.mp4") - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - out = cv2.VideoWriter('visioneye-pinpoint.avi', cv2.VideoWriter_fourcc(*'MJPG'), fps, (w, h)) - - center_point = (-10, h) - - while True: - ret, im0 = cap.read() - if not ret: - print("Video frame is empty or video processing has been successfully completed.") - break - - results = model.predict(im0) - boxes = results[0].boxes.xyxy.cpu() - clss = results[0].boxes.cls.cpu().tolist() - - annotator = Annotator(im0, line_width=2) - - for box, cls in zip(boxes, clss): - annotator.box_label(box, label=names[int(cls)], color=colors(int(cls))) - annotator.visioneye(box, center_point) - - out.write(im0) - cv2.imshow("visioneye-pinpoint", im0) - - if cv2.waitKey(1) & 0xFF == ord('q'): - break - - out.release() - cap.release() - cv2.destroyAllWindows() - ``` - - === "VisionEye Object Mapping with Object Tracking" - - ```python - import cv2 - from ultralytics import YOLO - from ultralytics.utils.plotting import colors, Annotator - - model = YOLO("yolov8n.pt") - cap = cv2.VideoCapture("path/to/video/file.mp4") - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - out = cv2.VideoWriter('visioneye-pinpoint.avi', cv2.VideoWriter_fourcc(*'MJPG'), fps, (w, h)) - - center_point = (-10, h) - - while True: - ret, im0 = cap.read() - if not ret: - print("Video frame is empty or video processing has been successfully completed.") - break - - annotator = Annotator(im0, line_width=2) - - results = model.track(im0, persist=True) - boxes = results[0].boxes.xyxy.cpu() - - if results[0].boxes.id is not None: - track_ids = results[0].boxes.id.int().cpu().tolist() - - for box, track_id in zip(boxes, track_ids): - annotator.box_label(box, label=str(track_id), color=colors(int(track_id))) - annotator.visioneye(box, center_point) - - out.write(im0) - cv2.imshow("visioneye-pinpoint", im0) - - if cv2.waitKey(1) & 0xFF == ord('q'): - break - - out.release() - cap.release() - cv2.destroyAllWindows() - ``` - - === "VisionEye with Distance Calculation" - - ```python - import cv2 - import math - from ultralytics import YOLO - from ultralytics.utils.plotting import Annotator, colors - - model = YOLO("yolov8s.pt") - cap = cv2.VideoCapture("Path/to/video/file.mp4") - - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - out = cv2.VideoWriter('visioneye-distance-calculation.avi', cv2.VideoWriter_fourcc(*'MJPG'), fps, (w, h)) - - center_point = (0, h) - pixel_per_meter = 10 - - txt_color, txt_background, bbox_clr = ((0, 0, 0), (255, 255, 255), (255, 0, 255)) - - while True: - ret, im0 = cap.read() - if not ret: - print("Video frame is empty or video processing has been successfully completed.") - break - - annotator = Annotator(im0, line_width=2) - - results = model.track(im0, persist=True) - boxes = results[0].boxes.xyxy.cpu() - - if results[0].boxes.id is not None: - track_ids = results[0].boxes.id.int().cpu().tolist() - - for box, track_id in zip(boxes, track_ids): - annotator.box_label(box, label=str(track_id), color=bbox_clr) - annotator.visioneye(box, center_point) - - x1, y1 = int((box[0] + box[2]) // 2), int((box[1] + box[3]) // 2) # Bounding box centroid - - distance = (math.sqrt((x1 - center_point[0]) ** 2 + (y1 - center_point[1]) ** 2))/pixel_per_meter - - text_size, _ = cv2.getTextSize(f"Distance: {distance:.2f} m", cv2.FONT_HERSHEY_SIMPLEX,1.2, 3) - cv2.rectangle(im0, (x1, y1 - text_size[1] - 10),(x1 + text_size[0] + 10, y1), txt_background, -1) - cv2.putText(im0, f"Distance: {distance:.2f} m",(x1, y1 - 5), cv2.FONT_HERSHEY_SIMPLEX, 1.2,txt_color, 3) - - out.write(im0) - cv2.imshow("visioneye-distance-calculation", im0) - - if cv2.waitKey(1) & 0xFF == ord('q'): - break - - out.release() - cap.release() - cv2.destroyAllWindows() - ``` - -### `visioneye` Arguments - -| Name | Type | Default | Description | -|---------------|---------|------------------|--------------------------------------------------| -| `color` | `tuple` | `(235, 219, 11)` | Line and object centroid color | -| `pin_color` | `tuple` | `(255, 0, 255)` | VisionEye pinpoint color | -| `thickness` | `int` | `2` | pinpoint to object line thickness | -| `pins_radius` | `int` | `10` | Pinpoint and object centroid point circle radius | - -## Note - -For any inquiries, feel free to post your questions in the [Ultralytics Issue Section](https://github.com/ultralytics/ultralytics/issues/new/choose) or the discussion section mentioned below. diff --git a/ultralytics-main/docs/en/guides/workouts-monitoring.md b/ultralytics-main/docs/en/guides/workouts-monitoring.md deleted file mode 100644 index fd4d7e0..0000000 --- a/ultralytics-main/docs/en/guides/workouts-monitoring.md +++ /dev/null @@ -1,134 +0,0 @@ ---- -comments: true -description: Workouts Monitoring Using Ultralytics YOLOv8 -keywords: Ultralytics, YOLOv8, Object Detection, Pose Estimation, PushUps, PullUps, Ab workouts, Notebook, IPython Kernel, CLI, Python SDK ---- - -# Workouts Monitoring using Ultralytics YOLOv8 🚀 - -Monitoring workouts through pose estimation with [Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics/) enhances exercise assessment by accurately tracking key body landmarks and joints in real-time. This technology provides instant feedback on exercise form, tracks workout routines, and measures performance metrics, optimizing training sessions for users and trainers alike. - -## Advantages of Workouts Monitoring? - -- **Optimized Performance:** Tailoring workouts based on monitoring data for better results. -- **Goal Achievement:** Track and adjust fitness goals for measurable progress. -- **Personalization:** Customized workout plans based on individual data for effectiveness. -- **Health Awareness:** Early detection of patterns indicating health issues or over-training. -- **Informed Decisions:** Data-driven decisions for adjusting routines and setting realistic goals. - -## Real World Applications - -| Workouts Monitoring | Workouts Monitoring | -|:----------------------------------------------------------------------------------------------------------------------:|:----------------------------------------------------------------------------------------------------------------------:| -| ![PushUps Counting](https://github.com/RizwanMunawar/ultralytics/assets/62513924/cf016a41-589f-420f-8a8c-2cc8174a16de) | ![PullUps Counting](https://github.com/RizwanMunawar/ultralytics/assets/62513924/cb20f316-fac2-4330-8445-dcf5ffebe329) | -| PushUps Counting | PullUps Counting | - -!!! Example "Workouts Monitoring Example" - - === "Workouts Monitoring" - - ```python - from ultralytics import YOLO - from ultralytics.solutions import ai_gym - import cv2 - - model = YOLO("yolov8n-pose.pt") - cap = cv2.VideoCapture("path/to/video/file.mp4") - assert cap.isOpened(), "Error reading video file" - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - gym_object = ai_gym.AIGym() # init AI GYM module - gym_object.set_args(line_thickness=2, - view_img=True, - pose_type="pushup", - kpts_to_check=[6, 8, 10]) - - frame_count = 0 - while cap.isOpened(): - success, im0 = cap.read() - if not success: - print("Video frame is empty or video processing has been successfully completed.") - break - frame_count += 1 - results = model.predict(im0, verbose=False) - im0 = gym_object.start_counting(im0, results, frame_count) - - cv2.destroyAllWindows() - ``` - - === "Workouts Monitoring with Save Output" - - ```python - from ultralytics import YOLO - from ultralytics.solutions import ai_gym - import cv2 - - model = YOLO("yolov8n-pose.pt") - cap = cv2.VideoCapture("path/to/video/file.mp4") - assert cap.isOpened(), "Error reading video file" - w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS)) - - video_writer = cv2.VideoWriter("workouts.avi", - cv2.VideoWriter_fourcc(*'mp4v'), - fps, - (w, h)) - - gym_object = ai_gym.AIGym() # init AI GYM module - gym_object.set_args(line_thickness=2, - view_img=True, - pose_type="pushup", - kpts_to_check=[6, 8, 10]) - - frame_count = 0 - while cap.isOpened(): - success, im0 = cap.read() - if not success: - print("Video frame is empty or video processing has been successfully completed.") - break - frame_count += 1 - results = model.predict(im0, verbose=False) - im0 = gym_object.start_counting(im0, results, frame_count) - video_writer.write(im0) - - cv2.destroyAllWindows() - video_writer.release() - ``` - -???+ tip "Support" - - "pushup", "pullup" and "abworkout" supported - -### KeyPoints Map - -![keyPoints Order Ultralytics YOLOv8 Pose](https://github.com/ultralytics/ultralytics/assets/62513924/f45d8315-b59f-47b7-b9c8-c61af1ce865b) - -### Arguments `set_args` - -| Name | Type | Default | Description | -|-------------------|--------|----------|----------------------------------------------------------------------------------------| -| `kpts_to_check` | `list` | `None` | List of three keypoints index, for counting specific workout, followed by keypoint Map | -| `view_img` | `bool` | `False` | Display the frame with counts | -| `line_thickness` | `int` | `2` | Increase the thickness of count value | -| `pose_type` | `str` | `pushup` | Pose that need to be monitored, `pullup` and `abworkout` also supported | -| `pose_up_angle` | `int` | `145` | Pose Up Angle value | -| `pose_down_angle` | `int` | `90` | Pose Down Angle value | - -### Arguments `model.predict` - -| Name | Type | Default | Description | -|-----------------|----------------|------------------------|----------------------------------------------------------------------------| -| `source` | `str` | `'ultralytics/assets'` | source directory for images or videos | -| `conf` | `float` | `0.25` | object confidence threshold for detection | -| `iou` | `float` | `0.7` | intersection over union (IoU) threshold for NMS | -| `imgsz` | `int or tuple` | `640` | image size as scalar or (h, w) list, i.e. (640, 480) | -| `half` | `bool` | `False` | use half precision (FP16) | -| `device` | `None or str` | `None` | device to run on, i.e. cuda device=0/1/2/3 or device=cpu | -| `max_det` | `int` | `300` | maximum number of detections per image | -| `vid_stride` | `bool` | `False` | video frame-rate stride | -| `stream_buffer` | `bool` | `False` | buffer all streaming frames (True) or return the most recent frame (False) | -| `visualize` | `bool` | `False` | visualize model features | -| `augment` | `bool` | `False` | apply image augmentation to prediction sources | -| `agnostic_nms` | `bool` | `False` | class-agnostic NMS | -| `classes` | `list[int]` | `None` | filter results by class, i.e. classes=0, or classes=[0,2,3] | -| `retina_masks` | `bool` | `False` | use high-resolution segmentation masks | -| `embed` | `list[int]` | `None` | return feature vectors/embeddings from given layers | diff --git a/ultralytics-main/docs/en/guides/yolo-common-issues.md b/ultralytics-main/docs/en/guides/yolo-common-issues.md deleted file mode 100644 index 71083cf..0000000 --- a/ultralytics-main/docs/en/guides/yolo-common-issues.md +++ /dev/null @@ -1,276 +0,0 @@ ---- -comments: true -description: A comprehensive guide to troubleshooting common issues encountered while working with YOLOv8 in the Ultralytics ecosystem. -keywords: Troubleshooting, Ultralytics, YOLOv8, Installation Errors, Training Data, Model Performance, Hyperparameter Tuning, Deployment ---- - -# Troubleshooting Common YOLO Issues - -

- YOLO Common Issues Image -

- -## Introduction - -This guide serves as a comprehensive aid for troubleshooting common issues encountered while working with YOLOv8 on your Ultralytics projects. Navigating through these issues can be a breeze with the right guidance, ensuring your projects remain on track without unnecessary delays. - -## Common Issues - -### Installation Errors - -Installation errors can arise due to various reasons, such as incompatible versions, missing dependencies, or incorrect environment setups. First, check to make sure you are doing the following: - -- You're using Python 3.8 or later as recommended. - -- Ensure that you have the correct version of PyTorch (1.8 or later) installed. - -- Consider using virtual environments to avoid conflicts. - -- Follow the [official installation guide](../quickstart.md) step by step. - -Additionally, here are some common installation issues users have encountered, along with their respective solutions: - -- Import Errors or Dependency Issues - If you're getting errors during the import of YOLOv8, or you're having issues related to dependencies, consider the following troubleshooting steps: - - - **Fresh Installation**: Sometimes, starting with a fresh installation can resolve unexpected issues. Especially with libraries like Ultralytics, where updates might introduce changes to the file tree structure or functionalities. - - - **Update Regularly**: Ensure you're using the latest version of the library. Older versions might not be compatible with recent updates, leading to potential conflicts or issues. - - - **Check Dependencies**: Verify that all required dependencies are correctly installed and are of the compatible versions. - - - **Review Changes**: If you initially cloned or installed an older version, be aware that significant updates might affect the library's structure or functionalities. Always refer to the official documentation or changelogs to understand any major changes. - - - Remember, keeping your libraries and dependencies up-to-date is crucial for a smooth and error-free experience. - -- Running YOLOv8 on GPU - If you're having trouble running YOLOv8 on GPU, consider the following troubleshooting steps: - - - **Verify CUDA Compatibility and Installation**: Ensure your GPU is CUDA compatible and that CUDA is correctly installed. Use the `nvidia-smi` command to check the status of your NVIDIA GPU and CUDA version. - - - **Check PyTorch and CUDA Integration**: Ensure PyTorch can utilize CUDA by running `import torch; print(torch.cuda.is_available())` in a Python terminal. If it returns 'True', PyTorch is set up to use CUDA. - - - **Environment Activation**: Ensure you're in the correct environment where all necessary packages are installed. - - - **Update Your Packages**: Outdated packages might not be compatible with your GPU. Keep them updated. - - - **Program Configuration**: Check if the program or code specifies GPU usage. In YOLOv8, this might be in the settings or configuration. - -### Model Training Issues - -This section will address common issues faced while training and their respective explanations and solutions. - -#### Verification of Configuration Settings - -**Issue**: You are unsure whether the configuration settings in the `.yaml` file are being applied correctly during model training. - -**Solution**: The configuration settings in the `.yaml` file should be applied when using the `model.train()` function. To ensure that these settings are correctly applied, follow these steps: - -- Confirm that the path to your `.yaml` configuration file is correct. -- Make sure you pass the path to your `.yaml` file as the `data` argument when calling `model.train()`, as shown below: - -```python -model.train(data='/path/to/your/data.yaml', batch=4) -``` - -#### Accelerating Training with Multiple GPUs - -**Issue**: Training is slow on a single GPU, and you want to speed up the process using multiple GPUs. - -**Solution**: Increasing the batch size can accelerate training, but it's essential to consider GPU memory capacity. To speed up training with multiple GPUs, follow these steps: - -- Ensure that you have multiple GPUs available. - -- Modify your .yaml configuration file to specify the number of GPUs to use, e.g., gpus: 4. - -- Increase the batch size accordingly to fully utilize the multiple GPUs without exceeding memory limits. - -- Modify your training command to utilize multiple GPUs: - -```python -# Adjust the batch size and other settings as needed to optimize training speed -model.train(data='/path/to/your/data.yaml', batch=32, multi_scale=True) -``` - -#### Continuous Monitoring Parameters - -**Issue**: You want to know which parameters should be continuously monitored during training, apart from loss. - -**Solution**: While loss is a crucial metric to monitor, it's also essential to track other metrics for model performance optimization. Some key metrics to monitor during training include: - -- Precision -- Recall -- Mean Average Precision (mAP) - -You can access these metrics from the training logs or by using tools like TensorBoard or wandb for visualization. Implementing early stopping based on these metrics can help you achieve better results. - -#### Tools for Tracking Training Progress - -**Issue**: You are looking for recommendations on tools to track training progress. - -**Solution**: To track and visualize training progress, you can consider using the following tools: - -- [TensorBoard](https://www.tensorflow.org/tensorboard): TensorBoard is a popular choice for visualizing training metrics, including loss, accuracy, and more. You can integrate it with your YOLOv8 training process. -- [Comet](https://bit.ly/yolov8-readme-comet): Comet provides an extensive toolkit for experiment tracking and comparison. It allows you to track metrics, hyperparameters, and even model weights. Integration with YOLO models is also straightforward, providing you with a complete overview of your experiment cycle. -- [Ultralytics HUB](https://hub.ultralytics.com): Ultralytics HUB offers a specialized environment for tracking YOLO models, giving you a one-stop platform to manage metrics, datasets, and even collaborate with your team. Given its tailored focus on YOLO, it offers more customized tracking options. - -Each of these tools offers its own set of advantages, so you may want to consider the specific needs of your project when making a choice. - -#### How to Check if Training is Happening on the GPU - -**Issue**: The 'device' value in the training logs is 'null,' and you're unsure if training is happening on the GPU. - -**Solution**: The 'device' value being 'null' typically means that the training process is set to automatically use an available GPU, which is the default behavior. To ensure training occurs on a specific GPU, you can manually set the 'device' value to the GPU index (e.g., '0' for the first GPU) in your .yaml configuration file: - -```yaml -device: 0 -``` - -This will explicitly assign the training process to the specified GPU. If you wish to train on the CPU, set 'device' to 'cpu'. - -Keep an eye on the 'runs' folder for logs and metrics to monitor training progress effectively. - -#### Key Considerations for Effective Model Training - -Here are some things to keep in mind, if you are facing issues related to model training. - -**Dataset Format and Labels** - -- Importance: The foundation of any machine learning model lies in the quality and format of the data it is trained on. - -- Recommendation: Ensure that your custom dataset and its associated labels adhere to the expected format. It's crucial to verify that annotations are accurate and of high quality. Incorrect or subpar annotations can derail the model's learning process, leading to unpredictable outcomes. - -**Model Convergence** - -- Importance: Achieving model convergence ensures that the model has sufficiently learned from the training data. - -- Recommendation: When training a model 'from scratch', it's vital to ensure that the model reaches a satisfactory level of convergence. This might necessitate a longer training duration, with more epochs, compared to when you're fine-tuning an existing model. - -**Learning Rate and Batch Size** - -- Importance: These hyperparameters play a pivotal role in determining how the model updates its weights during training. - -- Recommendation: Regularly evaluate if the chosen learning rate and batch size are optimal for your specific dataset. Parameters that are not in harmony with the dataset's characteristics can hinder the model's performance. - -**Class Distribution** - -- Importance: The distribution of classes in your dataset can influence the model's prediction tendencies. - -- Recommendation: Regularly assess the distribution of classes within your dataset. If there's a class imbalance, there's a risk that the model will develop a bias towards the more prevalent class. This bias can be evident in the confusion matrix, where the model might predominantly predict the majority class. - -**Cross-Check with Pretrained Weights** - -- Importance: Leveraging pretrained weights can provide a solid starting point for model training, especially when data is limited. - -- Recommendation: As a diagnostic step, consider training your model using the same data but initializing it with pretrained weights. If this approach yields a well-formed confusion matrix, it could suggest that the 'from scratch' model might require further training or adjustments. - -### Issues Related to Model Predictions - -This section will address common issues faced during model prediction. - -#### Getting Bounding Box Predictions With Your YOLOv8 Custom Model - -**Issue**: When running predictions with a custom YOLOv8 model, there are challenges with the format and visualization of the bounding box coordinates. - -**Solution**: - -- Coordinate Format: YOLOv8 provides bounding box coordinates in absolute pixel values. To convert these to relative coordinates (ranging from 0 to 1), you need to divide by the image dimensions. For example, let’s say your image size is 640x640. Then you would do the following: - -```python -# Convert absolute coordinates to relative coordinates -x1 = x1 / 640 # Divide x-coordinates by image width -x2 = x2 / 640 -y1 = y1 / 640 # Divide y-coordinates by image height -y2 = y2 / 640 -``` - -- File Name: To obtain the file name of the image you're predicting on, access the image file path directly from the result object within your prediction loop. - -#### Filtering Objects in YOLOv8 Predictions - -**Issue**: Facing issues with how to filter and display only specific objects in the prediction results when running YOLOv8 using the Ultralytics library. - -**Solution**: To detect specific classes use the classes argument to specify the classes you want to include in the output. For instance, to detect only cars (assuming 'cars' have class index 2): - -```shell -yolo task=detect mode=segment model=yolov8n-seg.pt source='path/to/car.mp4' show=True classes=2 -``` - -#### Understanding Precision Metrics in YOLOv8 - -**Issue**: Confusion regarding the difference between box precision, mask precision, and confusion matrix precision in YOLOv8. - -**Solution**: Box precision measures the accuracy of predicted bounding boxes compared to the actual ground truth boxes using IoU (Intersection over Union) as the metric. Mask precision assesses the agreement between predicted segmentation masks and ground truth masks in pixel-wise object classification. Confusion matrix precision, on the other hand, focuses on overall classification accuracy across all classes and does not consider the geometric accuracy of predictions. It's important to note that a bounding box can be geometrically accurate (true positive) even if the class prediction is wrong, leading to differences between box precision and confusion matrix precision. These metrics evaluate distinct aspects of a model's performance, reflecting the need for different evaluation metrics in various tasks. - -#### Extracting Object Dimensions in YOLOv8 - -**Issue**: Difficulty in retrieving the length and height of detected objects in YOLOv8, especially when multiple objects are detected in an image. - -**Solution**: To retrieve the bounding box dimensions, first use the Ultralytics YOLOv8 model to predict objects in an image. Then, extract the width and height information of bounding boxes from the prediction results. - -```python -from ultralytics import YOLO - -# Load a pre-trained YOLOv8 model -model = YOLO('yolov8n.pt') - -# Specify the source image -source = 'https://ultralytics.com/images/bus.jpg' - -# Make predictions -results = model.predict(source, save=True, imgsz=320, conf=0.5) - -# Extract bounding box dimensions -boxes = results[0].boxes.xywh.cpu() -for box in boxes: - x, y, w, h = box - print(f"Width of Box: {w}, Height of Box: {h}") -``` - -### Deployment Challenges - -#### GPU Deployment Issues - -**Issue:** Deploying models in a multi-GPU environment can sometimes lead to unexpected behaviors like unexpected memory usage, inconsistent results across GPUs, etc. - -**Solution:** Check for default GPU initialization. Some frameworks, like PyTorch, might initialize CUDA operations on a default GPU before transitioning to the designated GPUs. To bypass unexpected default initializations, specify the GPU directly during deployment and prediction. Then, use tools to monitor GPU utilization and memory usage to identify any anomalies in real-time. Also, ensure you're using the latest version of the framework or library. - -#### Model Conversion/Exporting Issues - -**Issue:** During the process of converting or exporting machine learning models to different formats or platforms, users might encounter errors or unexpected behaviors. - -**Solution:** - -- Compatibility Check: Ensure that you are using versions of libraries and frameworks that are compatible with each other. Mismatched versions can lead to unexpected errors during conversion. - -- Environment Reset: If you're using an interactive environment like Jupyter or Colab, consider restarting your environment after making significant changes or installations. A fresh start can sometimes resolve underlying issues. - -- Official Documentation: Always refer to the official documentation of the tool or library you are using for conversion. It often contains specific guidelines and best practices for model exporting. - -- Community Support: Check the library or framework's official repository for similar issues reported by other users. The maintainers or community might have provided solutions or workarounds in discussion threads. - -- Update Regularly: Ensure that you are using the latest version of the tool or library. Developers frequently release updates that fix known bugs or improve functionality. - -- Test Incrementally: Before performing a full conversion, test the process with a smaller model or dataset to identify potential issues early on. - -## Community and Support - -Engaging with a community of like-minded individuals can significantly enhance your experience and success in working with YOLOv8. Below are some channels and resources you may find helpful. - -### Forums and Channels for Getting Help - -**GitHub Issues:** The YOLOv8 repository on GitHub has an [Issues tab](https://github.com/ultralytics/ultralytics/issues) where you can ask questions, report bugs, and suggest new features. The community and maintainers are active here, and it’s a great place to get help with specific problems. - -**Ultralytics Discord Server:** Ultralytics has a [Discord server](https://ultralytics.com/discord/) where you can interact with other users and the developers. - -### Official Documentation and Resources - -**Ultralytics YOLOv8 Docs**: The [official documentation](../index.md) provides a comprehensive overview of YOLOv8, along with guides on installation, usage, and troubleshooting. - -These resources should provide a solid foundation for troubleshooting and improving your YOLOv8 projects, as well as connecting with others in the YOLOv8 community. - -## Conclusion - -Troubleshooting is an integral part of any development process, and being equipped with the right knowledge can significantly reduce the time and effort spent in resolving issues. This guide aimed to address the most common challenges faced by users of the YOLOv8 model within the Ultralytics ecosystem. By understanding and addressing these common issues, you can ensure smoother project progress and achieve better results with your computer vision tasks. - -Remember, the Ultralytics community is a valuable resource. Engaging with fellow developers and experts can provide additional insights and solutions that might not be covered in standard documentation. Always keep learning, experimenting, and sharing your experiences to contribute to the collective knowledge of the community. - -Happy troubleshooting! diff --git a/ultralytics-main/docs/en/guides/yolo-performance-metrics.md b/ultralytics-main/docs/en/guides/yolo-performance-metrics.md deleted file mode 100644 index a34f161..0000000 --- a/ultralytics-main/docs/en/guides/yolo-performance-metrics.md +++ /dev/null @@ -1,176 +0,0 @@ ---- -comments: true -description: A comprehensive guide on various performance metrics related to YOLOv8, their significance, and how to interpret them. -keywords: YOLOv8, Performance metrics, Object detection, Intersection over Union (IoU), Average Precision (AP), Mean Average Precision (mAP), Precision, Recall, Validation mode, Ultralytics ---- - -# Performance Metrics Deep Dive - -## Introduction - -Performance metrics are key tools to evaluate the accuracy and efficiency of object detection models. They shed light on how effectively a model can identify and localize objects within images. Additionally, they help in understanding the model's handling of false positives and false negatives. These insights are crucial for evaluating and enhancing the model's performance. In this guide, we will explore various performance metrics associated with YOLOv8, their significance, and how to interpret them. - -

-
- -
- Watch: Ultralytics YOLOv8 Performance Metrics | MAP, F1 Score, Precision, IoU & Accuracy -

- -## Object Detection Metrics - -Let’s start by discussing some metrics that are not only important to YOLOv8 but are broadly applicable across different object detection models. - -- **Intersection over Union (IoU):** IoU is a measure that quantifies the overlap between a predicted bounding box and a ground truth bounding box. It plays a fundamental role in evaluating the accuracy of object localization. - -- **Average Precision (AP):** AP computes the area under the precision-recall curve, providing a single value that encapsulates the model's precision and recall performance. - -- **Mean Average Precision (mAP):** mAP extends the concept of AP by calculating the average AP values across multiple object classes. This is useful in multi-class object detection scenarios to provide a comprehensive evaluation of the model's performance. - -- **Precision and Recall:** Precision quantifies the proportion of true positives among all positive predictions, assessing the model's capability to avoid false positives. On the other hand, Recall calculates the proportion of true positives among all actual positives, measuring the model's ability to detect all instances of a class. - -- **F1 Score:** The F1 Score is the harmonic mean of precision and recall, providing a balanced assessment of a model's performance while considering both false positives and false negatives. - -## How to Calculate Metrics for YOLOv8 Model - -Now, we can explore [YOLOv8's Validation mode](../modes/val.md) that can be used to compute the above discussed evaluation metrics. - -Using the validation mode is simple. Once you have a trained model, you can invoke the model.val() function. This function will then process the validation dataset and return a variety of performance metrics. But what do these metrics mean? And how should you interpret them? - -### Interpreting the Output - -Let's break down the output of the model.val() function and understand each segment of the output. - -#### Class-wise Metrics - -One of the sections of the output is the class-wise breakdown of performance metrics. This granular information is useful when you are trying to understand how well the model is doing for each specific class, especially in datasets with a diverse range of object categories. For each class in the dataset the following is provided: - -- **Class**: This denotes the name of the object class, such as "person", "car", or "dog". - -- **Images**: This metric tells you the number of images in the validation set that contain the object class. - -- **Instances**: This provides the count of how many times the class appears across all images in the validation set. - -- **Box(P, R, mAP50, mAP50-95)**: This metric provides insights into the model's performance in detecting objects: - - - **P (Precision)**: The accuracy of the detected objects, indicating how many detections were correct. - - - **R (Recall)**: The ability of the model to identify all instances of objects in the images. - - - **mAP50**: Mean average precision calculated at an intersection over union (IoU) threshold of 0.50. It's a measure of the model's accuracy considering only the "easy" detections. - - - **mAP50-95**: The average of the mean average precision calculated at varying IoU thresholds, ranging from 0.50 to 0.95. It gives a comprehensive view of the model's performance across different levels of detection difficulty. - -#### Speed Metrics - -The speed of inference can be as critical as accuracy, especially in real-time object detection scenarios. This section breaks down the time taken for various stages of the validation process, from preprocessing to post-processing. - -#### COCO Metrics Evaluation - -For users validating on the COCO dataset, additional metrics are calculated using the COCO evaluation script. These metrics give insights into precision and recall at different IoU thresholds and for objects of different sizes. - -#### Visual Outputs - -The model.val() function, apart from producing numeric metrics, also yields visual outputs that can provide a more intuitive understanding of the model's performance. Here's a breakdown of the visual outputs you can expect: - -- **F1 Score Curve (`F1_curve.png`)**: This curve represents the F1 score across various thresholds. Interpreting this curve can offer insights into the model's balance between false positives and false negatives over different thresholds. - -- **Precision-Recall Curve (`PR_curve.png`)**: An integral visualization for any classification problem, this curve showcases the trade-offs between precision and recall at varied thresholds. It becomes especially significant when dealing with imbalanced classes. - -- **Precision Curve (`P_curve.png`)**: A graphical representation of precision values at different thresholds. This curve helps in understanding how precision varies as the threshold changes. - -- **Recall Curve (`R_curve.png`)**: Correspondingly, this graph illustrates how the recall values change across different thresholds. - -- **Confusion Matrix (`confusion_matrix.png`)**: The confusion matrix provides a detailed view of the outcomes, showcasing the counts of true positives, true negatives, false positives, and false negatives for each class. - -- **Normalized Confusion Matrix (`confusion_matrix_normalized.png`)**: This visualization is a normalized version of the confusion matrix. It represents the data in proportions rather than raw counts. This format makes it simpler to compare the performance across classes. - -- **Validation Batch Labels (`val_batchX_labels.jpg`)**: These images depict the ground truth labels for distinct batches from the validation dataset. They provide a clear picture of what the objects are and their respective locations as per the dataset. - -- **Validation Batch Predictions (`val_batchX_pred.jpg`)**: Contrasting the label images, these visuals display the predictions made by the YOLOv8 model for the respective batches. By comparing these to the label images, you can easily assess how well the model detects and classifies objects visually. - -#### Results Storage - -For future reference, the results are saved to a directory, typically named runs/detect/val. - -## Choosing the Right Metrics - -Choosing the right metrics to evaluate often depends on the specific application. - -- **mAP:** Suitable for a broad assessment of model performance. - -- **IoU:** Essential when precise object location is crucial. - -- **Precision:** Important when minimizing false detections is a priority. - -- **Recall:** Vital when it's important to detect every instance of an object. - -- **F1 Score:** Useful when a balance between precision and recall is needed. - -For real-time applications, speed metrics like FPS (Frames Per Second) and latency are crucial to ensure timely results. - -## Interpretation of Results - -It’s important to understand the metrics. Here's what some of the commonly observed lower scores might suggest: - -- **Low mAP:** Indicates the model may need general refinements. - -- **Low IoU:** The model might be struggling to pinpoint objects accurately. Different bounding box methods could help. - -- **Low Precision:** The model may be detecting too many non-existent objects. Adjusting confidence thresholds might reduce this. - -- **Low Recall:** The model could be missing real objects. Improving feature extraction or using more data might help. - -- **Imbalanced F1 Score:** There's a disparity between precision and recall. - -- **Class-specific AP:** Low scores here can highlight classes the model struggles with. - -## Case Studies - -Real-world examples can help clarify how these metrics work in practice. - -### Case 1 - -- **Situation:** mAP and F1 Score are suboptimal, but while Recall is good, Precision isn't. - -- **Interpretation & Action:** There might be too many incorrect detections. Tightening confidence thresholds could reduce these, though it might also slightly decrease recall. - -### Case 2 - -- **Situation:** mAP and Recall are acceptable, but IoU is lacking. - -- **Interpretation & Action:** The model detects objects well but might not be localizing them precisely. Refining bounding box predictions might help. - -### Case 3 - -- **Situation:** Some classes have a much lower AP than others, even with a decent overall mAP. - -- **Interpretation & Action:** These classes might be more challenging for the model. Using more data for these classes or adjusting class weights during training could be beneficial. - -## Connect and Collaborate - -Tapping into a community of enthusiasts and experts can amplify your journey with YOLOv8. Here are some avenues that can facilitate learning, troubleshooting, and networking. - -### Engage with the Broader Community - -- **GitHub Issues:** The YOLOv8 repository on GitHub has an [Issues tab](https://github.com/ultralytics/ultralytics/issues) where you can ask questions, report bugs, and suggest new features. The community and maintainers are active here, and it’s a great place to get help with specific problems. - -- **Ultralytics Discord Server:** Ultralytics has a [Discord server](https://ultralytics.com/discord/) where you can interact with other users and the developers. - -### Official Documentation and Resources: - -- **Ultralytics YOLOv8 Docs:** The [official documentation](../index.md) provides a comprehensive overview of YOLOv8, along with guides on installation, usage, and troubleshooting. - -Using these resources will not only guide you through any challenges but also keep you updated with the latest trends and best practices in the YOLOv8 community. - -## Conclusion - -In this guide, we've taken a close look at the essential performance metrics for YOLOv8. These metrics are key to understanding how well a model is performing and are vital for anyone aiming to fine-tune their models. They offer the necessary insights for improvements and to make sure the model works effectively in real-life situations. - -Remember, the YOLOv8 and Ultralytics community is an invaluable asset. Engaging with fellow developers and experts can open doors to insights and solutions not found in standard documentation. As you journey through object detection, keep the spirit of learning alive, experiment with new strategies, and share your findings. By doing so, you contribute to the community's collective wisdom and ensure its growth. - -Happy object detecting! diff --git a/ultralytics-main/docs/en/guides/yolo-thread-safe-inference.md b/ultralytics-main/docs/en/guides/yolo-thread-safe-inference.md deleted file mode 100644 index abf7a36..0000000 --- a/ultralytics-main/docs/en/guides/yolo-thread-safe-inference.md +++ /dev/null @@ -1,108 +0,0 @@ ---- -comments: true -description: This guide provides best practices for performing thread-safe inference with YOLO models, ensuring reliable and concurrent predictions in multi-threaded applications. -keywords: thread-safe, YOLO inference, multi-threading, concurrent predictions, YOLO models, Ultralytics, Python threading, safe YOLO usage, AI concurrency ---- - -# Thread-Safe Inference with YOLO Models - -Running YOLO models in a multi-threaded environment requires careful consideration to ensure thread safety. Python's `threading` module allows you to run several threads concurrently, but when it comes to using YOLO models across these threads, there are important safety issues to be aware of. This page will guide you through creating thread-safe YOLO model inference. - -## Understanding Python Threading - -Python threads are a form of parallelism that allow your program to run multiple operations at once. However, Python's Global Interpreter Lock (GIL) means that only one thread can execute Python bytecode at a time. - -

- Single vs Multi-Thread Examples -

- -While this sounds like a limitation, threads can still provide concurrency, especially for I/O-bound operations or when using operations that release the GIL, like those performed by YOLO's underlying C libraries. - -## The Danger of Shared Model Instances - -Instantiating a YOLO model outside your threads and sharing this instance across multiple threads can lead to race conditions, where the internal state of the model is inconsistently modified due to concurrent accesses. This is particularly problematic when the model or its components hold state that is not designed to be thread-safe. - -### Non-Thread-Safe Example: Single Model Instance - -When using threads in Python, it's important to recognize patterns that can lead to concurrency issues. Here is what you should avoid: sharing a single YOLO model instance across multiple threads. - -```python -# Unsafe: Sharing a single model instance across threads -from ultralytics import YOLO -from threading import Thread - -# Instantiate the model outside the thread -shared_model = YOLO("yolov8n.pt") - - -def predict(image_path): - results = shared_model.predict(image_path) - # Process results - - -# Starting threads that share the same model instance -Thread(target=predict, args=("image1.jpg",)).start() -Thread(target=predict, args=("image2.jpg",)).start() -``` - -In the example above, the `shared_model` is used by multiple threads, which can lead to unpredictable results because `predict` could be executed simultaneously by multiple threads. - -### Non-Thread-Safe Example: Multiple Model Instances - -Similarly, here is an unsafe pattern with multiple YOLO model instances: - -```python -# Unsafe: Sharing multiple model instances across threads can still lead to issues -from ultralytics import YOLO -from threading import Thread - -# Instantiate multiple models outside the thread -shared_model_1 = YOLO("yolov8n_1.pt") -shared_model_2 = YOLO("yolov8n_2.pt") - - -def predict(model, image_path): - results = model.predict(image_path) - # Process results - - -# Starting threads with individual model instances -Thread(target=predict, args=(shared_model_1, "image1.jpg")).start() -Thread(target=predict, args=(shared_model_2, "image2.jpg")).start() -``` - -Even though there are two separate model instances, the risk of concurrency issues still exists. If the internal implementation of `YOLO` is not thread-safe, using separate instances might not prevent race conditions, especially if these instances share any underlying resources or states that are not thread-local. - -## Thread-Safe Inference - -To perform thread-safe inference, you should instantiate a separate YOLO model within each thread. This ensures that each thread has its own isolated model instance, eliminating the risk of race conditions. - -### Thread-Safe Example - -Here's how to instantiate a YOLO model inside each thread for safe parallel inference: - -```python -# Safe: Instantiating a single model inside each thread -from ultralytics import YOLO -from threading import Thread - - -def thread_safe_predict(image_path): - # Instantiate a new model inside the thread - local_model = YOLO("yolov8n.pt") - results = local_model.predict(image_path) - # Process results - - -# Starting threads that each have their own model instance -Thread(target=thread_safe_predict, args=("image1.jpg",)).start() -Thread(target=thread_safe_predict, args=("image2.jpg",)).start() -``` - -In this example, each thread creates its own `YOLO` instance. This prevents any thread from interfering with the model state of another, thus ensuring that each thread performs inference safely and without unexpected interactions with the other threads. - -## Conclusion - -When using YOLO models with Python's `threading`, always instantiate your models within the thread that will use them to ensure thread safety. This practice avoids race conditions and makes sure that your inference tasks run reliably. - -For more advanced scenarios and to further optimize your multi-threaded inference performance, consider using process-based parallelism with `multiprocessing` or leveraging a task queue with dedicated worker processes. diff --git a/ultralytics-main/docs/en/help/CI.md b/ultralytics-main/docs/en/help/CI.md deleted file mode 100644 index 033cf71..0000000 --- a/ultralytics-main/docs/en/help/CI.md +++ /dev/null @@ -1,61 +0,0 @@ ---- -comments: true -description: Learn how Ultralytics leverages Continuous Integration (CI) for maintaining high-quality code. Explore our CI tests and the status of these tests for our repositories. -keywords: continuous integration, software development, CI tests, Ultralytics repositories, high-quality code, Docker Deployment, Broken Links, CodeQL, PyPi Publishing ---- - -# Continuous Integration (CI) - -Continuous Integration (CI) is an essential aspect of software development which involves integrating changes and testing them automatically. CI allows us to maintain high-quality code by catching issues early and often in the development process. At Ultralytics, we use various CI tests to ensure the quality and integrity of our codebase. - -## CI Actions - -Here's a brief description of our CI actions: - -- **[CI](https://github.com/ultralytics/ultralytics/actions/workflows/ci.yaml):** This is our primary CI test that involves running unit tests, linting checks, and sometimes more comprehensive tests depending on the repository. -- **[Docker Deployment](https://github.com/ultralytics/ultralytics/actions/workflows/docker.yaml):** This test checks the deployment of the project using Docker to ensure the Dockerfile and related scripts are working correctly. -- **[Broken Links](https://github.com/ultralytics/ultralytics/actions/workflows/links.yml):** This test scans the codebase for any broken or dead links in our markdown or HTML files. -- **[CodeQL](https://github.com/ultralytics/ultralytics/actions/workflows/codeql.yaml):** CodeQL is a tool from GitHub that performs semantic analysis on our code, helping to find potential security vulnerabilities and maintain high-quality code. -- **[PyPi Publishing](https://github.com/ultralytics/ultralytics/actions/workflows/publish.yml):** This test checks if the project can be packaged and published to PyPi without any errors. - -### CI Results - -Below is the table showing the status of these CI tests for our main repositories: - -| Repository | CI | Docker Deployment | Broken Links | CodeQL | PyPi and Docs Publishing | -|-----------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| [yolov3](https://github.com/ultralytics/yolov3) | [![YOLOv3 CI](https://github.com/ultralytics/yolov3/actions/workflows/ci-testing.yml/badge.svg)](https://github.com/ultralytics/yolov3/actions/workflows/ci-testing.yml) | [![Publish Docker Images](https://github.com/ultralytics/yolov3/actions/workflows/docker.yml/badge.svg)](https://github.com/ultralytics/yolov3/actions/workflows/docker.yml) | [![Check Broken links](https://github.com/ultralytics/yolov3/actions/workflows/links.yml/badge.svg)](https://github.com/ultralytics/yolov3/actions/workflows/links.yml) | [![CodeQL](https://github.com/ultralytics/yolov3/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/ultralytics/yolov3/actions/workflows/codeql-analysis.yml) | | -| [yolov5](https://github.com/ultralytics/yolov5) | [![YOLOv5 CI](https://github.com/ultralytics/yolov5/actions/workflows/ci-testing.yml/badge.svg)](https://github.com/ultralytics/yolov5/actions/workflows/ci-testing.yml) | [![Publish Docker Images](https://github.com/ultralytics/yolov5/actions/workflows/docker.yml/badge.svg)](https://github.com/ultralytics/yolov5/actions/workflows/docker.yml) | [![Check Broken links](https://github.com/ultralytics/yolov5/actions/workflows/links.yml/badge.svg)](https://github.com/ultralytics/yolov5/actions/workflows/links.yml) | [![CodeQL](https://github.com/ultralytics/yolov5/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/ultralytics/yolov5/actions/workflows/codeql-analysis.yml) | | -| [ultralytics](https://github.com/ultralytics/ultralytics) | [![ultralytics CI](https://github.com/ultralytics/ultralytics/actions/workflows/ci.yaml/badge.svg)](https://github.com/ultralytics/ultralytics/actions/workflows/ci.yaml) | [![Publish Docker Images](https://github.com/ultralytics/ultralytics/actions/workflows/docker.yaml/badge.svg)](https://github.com/ultralytics/ultralytics/actions/workflows/docker.yaml) | [![Check Broken links](https://github.com/ultralytics/ultralytics/actions/workflows/links.yml/badge.svg)](https://github.com/ultralytics/ultralytics/actions/workflows/links.yml) | [![CodeQL](https://github.com/ultralytics/ultralytics/actions/workflows/codeql.yaml/badge.svg)](https://github.com/ultralytics/ultralytics/actions/workflows/codeql.yaml) | [![Publish to PyPI and Deploy Docs](https://github.com/ultralytics/ultralytics/actions/workflows/publish.yml/badge.svg)](https://github.com/ultralytics/ultralytics/actions/workflows/publish.yml) | -| [hub](https://github.com/ultralytics/hub) | [![HUB CI](https://github.com/ultralytics/hub/actions/workflows/ci.yaml/badge.svg)](https://github.com/ultralytics/hub/actions/workflows/ci.yaml) | | [![Check Broken links](https://github.com/ultralytics/hub/actions/workflows/links.yml/badge.svg)](https://github.com/ultralytics/hub/actions/workflows/links.yml) | | | -| [docs](https://github.com/ultralytics/docs) | | | [![Check Broken links](https://github.com/ultralytics/docs/actions/workflows/links.yml/badge.svg)](https://github.com/ultralytics/docs/actions/workflows/links.yml)[![Check Domains](https://github.com/ultralytics/docs/actions/workflows/check_domains.yml/badge.svg)](https://github.com/ultralytics/docs/actions/workflows/check_domains.yml) | | [![pages-build-deployment](https://github.com/ultralytics/docs/actions/workflows/pages/pages-build-deployment/badge.svg)](https://github.com/ultralytics/docs/actions/workflows/pages/pages-build-deployment) | - -Each badge shows the status of the last run of the corresponding CI test on the `main` branch of the respective repository. If a test fails, the badge will display a "failing" status, and if it passes, it will display a "passing" status. - -If you notice a test failing, it would be a great help if you could report it through a GitHub issue in the respective repository. - -Remember, a successful CI test does not mean that everything is perfect. It is always recommended to manually review the code before deployment or merging changes. - -## Code Coverage - -Code coverage is a metric that represents the percentage of your codebase that is executed when your tests run. It provides insight into how well your tests exercise your code and can be crucial in identifying untested parts of your application. A high code coverage percentage is often associated with a lower likelihood of bugs. However, it's essential to understand that code coverage does not guarantee the absence of defects. It merely indicates which parts of the code have been executed by the tests. - -### Integration with [codecov.io](https://codecov.io/) - -At Ultralytics, we have integrated our repositories with [codecov.io](https://codecov.io/), a popular online platform for measuring and visualizing code coverage. Codecov provides detailed insights, coverage comparisons between commits, and visual overlays directly on your code, indicating which lines were covered. - -By integrating with Codecov, we aim to maintain and improve the quality of our code by focusing on areas that might be prone to errors or need further testing. - -### Coverage Results - -To quickly get a glimpse of the code coverage status of the `ultralytics` python package, we have included a badge and sunburst visual of the `ultralytics` coverage results. These images show the percentage of code covered by our tests, offering an at-a-glance metric of our testing efforts. For full details please see https://codecov.io/github/ultralytics/ultralytics. - -| Repository | Code Coverage | -|-----------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------| -| [ultralytics](https://github.com/ultralytics/ultralytics) | [![codecov](https://codecov.io/gh/ultralytics/ultralytics/branch/main/graph/badge.svg?token=HHW7IIVFVY)](https://codecov.io/gh/ultralytics/ultralytics) | - -In the sunburst graphic below, the innermost circle is the entire project, moving away from the center are folders then, finally, a single file. The size and color of each slice is representing the number of statements and the coverage, respectively. - - - Ultralytics Codecov Image - diff --git a/ultralytics-main/docs/en/help/CLA.md b/ultralytics-main/docs/en/help/CLA.md deleted file mode 100644 index e24e955..0000000 --- a/ultralytics-main/docs/en/help/CLA.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -description: Understand terms governing contributions to Ultralytics projects including source code, bug fixes, documentation and more. Read our Contributor License Agreement. -keywords: Ultralytics, Contributor License Agreement, Open Source Software, Contributions, Copyright License, Patent License, Moral Rights ---- - -# Ultralytics Individual Contributor License Agreement - -Thank you for your interest in contributing to open source software projects (“Projects”) made available by Ultralytics Inc. (“Ultralytics”). This Individual Contributor License Agreement (“Agreement”) sets out the terms governing any source code, object code, bug fixes, configuration changes, tools, specifications, documentation, data, materials, feedback, information or other works of authorship that you submit or have submitted, in any form and in any manner, to Ultralytics in respect of any Projects (collectively “Contributions”). If you have any questions respecting this Agreement, please contact hello@ultralytics.com. - -You agree that the following terms apply to all of your past, present and future Contributions. Except for the licenses granted in this Agreement, you retain all of your right, title and interest in and to your Contributions. - -**Copyright License.** You hereby grant, and agree to grant, to Ultralytics a non-exclusive, perpetual, irrevocable, worldwide, fully-paid, royalty-free, transferable copyright license to reproduce, prepare derivative works of, publicly display, publicly perform, and distribute your Contributions and such derivative works, with the right to sublicense the foregoing rights through multiple tiers of sublicensees. - -**Patent License.** You hereby grant, and agree to grant, to Ultralytics a non-exclusive, perpetual, irrevocable, worldwide, fully-paid, royalty-free, transferable patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer your Contributions, where such license applies only to those patent claims licensable by you that are necessarily infringed by your Contributions alone or by combination of your Contributions with the Project to which such Contributions were submitted, with the right to sublicense the foregoing rights through multiple tiers of sublicensees. - -**Moral Rights.** To the fullest extent permitted under applicable law, you hereby waive, and agree not to assert, all of your “moral rights” in or relating to your Contributions for the benefit of Ultralytics, its assigns, and their respective direct and indirect sublicensees. - -**Third Party Content/Rights.** If your Contribution includes or is based on any source code, object code, bug fixes, configuration changes, tools, specifications, documentation, data, materials, feedback, information or other works of authorship that were not authored by you (“Third Party Content”) or if you are aware of any third party intellectual property or proprietary rights associated with your Contribution (“Third Party Rights”), then you agree to include with the submission of your Contribution full details respecting such Third Party Content and Third Party Rights, including, without limitation, identification of which aspects of your Contribution contain Third Party Content or are associated with Third Party Rights, the owner/author of the Third Party Content and Third Party Rights, where you obtained the Third Party Content, and any applicable third party license terms or restrictions respecting the Third Party Content and Third Party Rights. For greater certainty, the foregoing obligations respecting the identification of Third Party Content and Third Party Rights do not apply to any portion of a Project that is incorporated into your Contribution to that same Project. - -**Representations.** You represent that, other than the Third Party Content and Third Party Rights identified by you in accordance with this Agreement, you are the sole author of your Contributions and are legally entitled to grant the foregoing licenses and waivers in respect of your Contributions. If your Contributions were created in the course of your employment with your past or present employer(s), you represent that such employer(s) has authorized you to make your Contributions on behalf of such employer(s) or such employer(s) has waived all of their right, title or interest in or to your Contributions. - -**Disclaimer.** To the fullest extent permitted under applicable law, your Contributions are provided on an "asis" basis, without any warranties or conditions, express or implied, including, without limitation, any implied warranties or conditions of non-infringement, merchantability or fitness for a particular purpose. You are not required to provide support for your Contributions, except to the extent you desire to provide support. - -**No Obligation.** You acknowledge that Ultralytics is under no obligation to use or incorporate your Contributions into any of the Projects. The decision to use or incorporate your Contributions into any of the Projects will be made at the sole discretion of Ultralytics or its authorized delegates. - -**Disputes.** This Agreement shall be governed by and construed in accordance with the laws of the State of New York, United States of America, without giving effect to its principles or rules regarding conflicts of laws, other than such principles directing application of New York law. The parties hereby submit to venue in, and jurisdiction of the courts located in New York, New York for purposes relating to this Agreement. In the event that any of the provisions of this Agreement shall be held by a court or other tribunal of competent jurisdiction to be unenforceable, the remaining portions hereof shall remain in full force and effect. - -**Assignment.** You agree that Ultralytics may assign this Agreement, and all of its rights, obligations and licenses hereunder. diff --git a/ultralytics-main/docs/en/help/FAQ.md b/ultralytics-main/docs/en/help/FAQ.md deleted file mode 100644 index 8e4430a..0000000 --- a/ultralytics-main/docs/en/help/FAQ.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -comments: true -description: Find solutions to your common Ultralytics YOLO related queries. Learn about hardware requirements, fine-tuning YOLO models, conversion to ONNX/TensorFlow, and more. -keywords: Ultralytics, YOLO, FAQ, hardware requirements, ONNX, TensorFlow, real-time detection, YOLO accuracy ---- - -# Ultralytics YOLO Frequently Asked Questions (FAQ) - -This FAQ section addresses some common questions and issues users might encounter while working with Ultralytics YOLO repositories. - -## 1. What are the hardware requirements for running Ultralytics YOLO? - -Ultralytics YOLO can be run on a variety of hardware configurations, including CPUs, GPUs, and even some edge devices. However, for optimal performance and faster training and inference, we recommend using a GPU with a minimum of 8GB of memory. NVIDIA GPUs with CUDA support are ideal for this purpose. - -## 2. How do I fine-tune a pre-trained YOLO model on my custom dataset? - -To fine-tune a pre-trained YOLO model on your custom dataset, you'll need to create a dataset configuration file (YAML) that defines the dataset's properties, such as the path to the images, the number of classes, and class names. Next, you'll need to modify the model configuration file to match the number of classes in your dataset. Finally, use the `train.py` script to start the training process with your custom dataset and the pre-trained model. You can find a detailed guide on fine-tuning YOLO in the Ultralytics documentation. - -## 3. How do I convert a YOLO model to ONNX or TensorFlow format? - -Ultralytics provides built-in support for converting YOLO models to ONNX format. You can use the `export.py` script to convert a saved model to ONNX format. If you need to convert the model to TensorFlow format, you can use the ONNX model as an intermediary and then use the ONNX-TensorFlow converter to convert the ONNX model to TensorFlow format. - -## 4. Can I use Ultralytics YOLO for real-time object detection? - -Yes, Ultralytics YOLO is designed to be efficient and fast, making it suitable for real-time object detection tasks. The actual performance will depend on your hardware configuration and the complexity of the model. Using a GPU and optimizing the model for your specific use case can help achieve real-time performance. - -## 5. How can I improve the accuracy of my YOLO model? - -Improving the accuracy of a YOLO model may involve several strategies, such as: - -- Fine-tuning the model on more annotated data -- Data augmentation to increase the variety of training samples -- Using a larger or more complex model architecture -- Adjusting the learning rate, batch size, and other hyperparameters -- Using techniques like transfer learning or knowledge distillation - -Remember that there's often a trade-off between accuracy and inference speed, so finding the right balance is crucial for your specific application. - -If you have any more questions or need assistance, don't hesitate to consult the Ultralytics documentation or reach out to the community through GitHub Issues or the official discussion forum. diff --git a/ultralytics-main/docs/en/help/code_of_conduct.md b/ultralytics-main/docs/en/help/code_of_conduct.md deleted file mode 100644 index 46313c4..0000000 --- a/ultralytics-main/docs/en/help/code_of_conduct.md +++ /dev/null @@ -1,85 +0,0 @@ ---- -comments: true -description: Explore Ultralytics community’s Code of Conduct, ensuring a supportive, inclusive environment for contributors & members at all levels. Find our guidelines on acceptable behavior & enforcement. -keywords: Ultralytics, code of conduct, community, contribution, behavior guidelines, enforcement, open source contributions ---- - -# Ultralytics Contributor Covenant Code of Conduct - -## Our Pledge - -We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socioeconomic status, nationality, personal appearance, race, religion, or sexual identity and orientation. - -We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community. - -## Our Standards - -Examples of behavior that contributes to a positive environment for our community include: - -- Demonstrating empathy and kindness toward other people -- Being respectful of differing opinions, viewpoints, and experiences -- Giving and gracefully accepting constructive feedback -- Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience -- Focusing on what is best not just for us as individuals, but for the overall community - -Examples of unacceptable behavior include: - -- The use of sexualized language or imagery, and sexual attention or advances of any kind -- Trolling, insulting or derogatory comments, and personal or political attacks -- Public or private harassment -- Publishing others' private information, such as a physical or email address, without their explicit permission -- Other conduct which could reasonably be considered inappropriate in a professional setting - -## Enforcement Responsibilities - -Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful. - -Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate. - -## Scope - -This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. - -## Enforcement - -Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at hello@ultralytics.com. All complaints will be reviewed and investigated promptly and fairly. - -All community leaders are obligated to respect the privacy and security of the reporter of any incident. - -## Enforcement Guidelines - -Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct: - -### 1. Correction - -**Community Impact**: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community. - -**Consequence**: A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested. - -### 2. Warning - -**Community Impact**: A violation through a single incident or series of actions. - -**Consequence**: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban. - -### 3. Temporary Ban - -**Community Impact**: A serious violation of community standards, including sustained inappropriate behavior. - -**Consequence**: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban. - -### 4. Permanent Ban - -**Community Impact**: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior, harassment of an individual, or aggression toward or disparagement of classes of individuals. - -**Consequence**: A permanent ban from any sort of public interaction within the community. - -## Attribution - -This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 2.0, available at https://www.contributor-covenant.org/version/2/0/code_of_conduct.html. - -Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity). - -For answers to common questions about this code of conduct, see the FAQ at https://www.contributor-covenant.org/faq. Translations are available at https://www.contributor-covenant.org/translations. - -[homepage]: https://www.contributor-covenant.org diff --git a/ultralytics-main/docs/en/help/contributing.md b/ultralytics-main/docs/en/help/contributing.md deleted file mode 100644 index 7874d48..0000000 --- a/ultralytics-main/docs/en/help/contributing.md +++ /dev/null @@ -1,131 +0,0 @@ ---- -comments: true -description: Learn how to contribute to Ultralytics YOLO projects – guidelines for pull requests, reporting bugs, code conduct and CLA signing. -keywords: Ultralytics, YOLO, open-source, contribute, pull request, bug report, coding guidelines, CLA, code of conduct, GitHub ---- - -# Contributing to Ultralytics Open-Source YOLO Repositories - -First of all, thank you for your interest in contributing to Ultralytics open-source YOLO repositories! Your contributions will help improve the project and benefit the community. This document provides guidelines and best practices to get you started. - -## Table of Contents - -1. [Code of Conduct](#code-of-conduct) -2. [Contributing via Pull Requests](#contributing-via-pull-requests) - - [CLA Signing](#cla-signing) - - [Google-Style Docstrings](#google-style-docstrings) - - [GitHub Actions CI Tests](#github-actions-ci-tests) -3. [Reporting Bugs](#reporting-bugs) -4. [License](#license) -5. [Conclusion](#conclusion) - -## Code of Conduct - -All contributors are expected to adhere to the [Code of Conduct](code_of_conduct.md) to ensure a welcoming and inclusive environment for everyone. - -## Contributing via Pull Requests - -We welcome contributions in the form of pull requests. To make the review process smoother, please follow these guidelines: - -1. **[Fork the repository](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo)**: Fork the Ultralytics YOLO repository to your own GitHub account. - -2. **[Create a branch](https://docs.github.com/en/desktop/making-changes-in-a-branch/managing-branches-in-github-desktop)**: Create a new branch in your forked repository with a descriptive name for your changes. - -3. **Make your changes**: Make the changes you want to contribute. Ensure that your changes follow the coding style of the project and do not introduce new errors or warnings. - -4. **[Test your changes](https://github.com/ultralytics/ultralytics/tree/main/tests)**: Test your changes locally to ensure that they work as expected and do not introduce new issues. - -5. **[Commit your changes](https://docs.github.com/en/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop)**: Commit your changes with a descriptive commit message. Make sure to include any relevant issue numbers in your commit message. - -6. **[Create a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)**: Create a pull request from your forked repository to the main Ultralytics YOLO repository. In the pull request description, provide a clear explanation of your changes and how they improve the project. - -### CLA Signing - -Before we can accept your pull request, you need to sign a [Contributor License Agreement (CLA)](CLA.md). This is a legal document stating that you agree to the terms of contributing to the Ultralytics YOLO repositories. The CLA ensures that your contributions are properly licensed and that the project can continue to be distributed under the AGPL-3.0 license. - -To sign the CLA, follow the instructions provided by the CLA bot after you submit your PR and add a comment in your PR saying: - -``` -I have read the CLA Document and I sign the CLA -``` - -### Google-Style Docstrings - -When adding new functions or classes, please include a [Google-style docstring](https://google.github.io/styleguide/pyguide.html) to provide clear and concise documentation for other developers. This will help ensure that your contributions are easy to understand and maintain. - -!!! Example "Example Docstrings" - - === "Google-style" - - This example shows both Google-style docstrings. Note that both input and output `types` must always be enclosed by parentheses, i.e. `(bool)`. - ```python - def example_function(arg1, arg2=4): - """ - Example function that demonstrates Google-style docstrings. - - Args: - arg1 (int): The first argument. - arg2 (int): The second argument. Default value is 4. - - Returns: - (bool): True if successful, False otherwise. - - Examples: - >>> result = example_function(1, 2) # returns False - """ - if arg1 == arg2: - return True - return False - ``` - - === "Google-style with type hints" - - This example shows both Google-style docstrings and argument and return type hints, though both are not required, one can be used without the other. - ```python - def example_function(arg1: int, arg2: int = 4) -> bool: - """ - Example function that demonstrates Google-style docstrings. - - Args: - arg1: The first argument. - arg2: The second argument. Default value is 4. - - Returns: - True if successful, False otherwise. - - Examples: - >>> result = example_function(1, 2) # returns False - """ - if arg1 == arg2: - return True - return False - ``` - - === "Single-line" - - Smaller or simpler functions can utilize a single-line docstring. Note the docstring must use 3 double-quotes, and be a complete sentence starting with a capital letter and ending with a period. - ```python - def example_small_function(arg1: int, arg2: int = 4) -> bool: - """Example function that demonstrates a single-line docstring.""" - return arg1 == arg2 - ``` - -### GitHub Actions CI Tests - -Before your pull request can be merged, all GitHub Actions [Continuous Integration](CI.md) (CI) tests must pass. These tests include linting, unit tests, and other checks to ensure that your changes meet the quality standards of the project. Make sure to review the output of the GitHub Actions and fix any issues - -## Reporting Bugs - -We appreciate bug reports as they play a crucial role in maintaining the project's quality. When reporting bugs it is important to provide a [Minimum Reproducible Example](minimum_reproducible_example.md): a clear, concise code example that replicates the issue. This helps in quick identification and resolution of the bug. - -## License - -Ultralytics embraces the [GNU Affero General Public License v3.0 (AGPL-3.0)](https://github.com/ultralytics/ultralytics/blob/main/LICENSE) for its repositories, promoting openness, transparency, and collaborative enhancement in software development. This strong copyleft license ensures that all users and developers retain the freedom to use, modify, and share the software. It fosters community collaboration, ensuring that any improvements remain accessible to all. - -Users and developers are encouraged to familiarize themselves with the terms of AGPL-3.0 to contribute effectively and ethically to the Ultralytics open-source community. - -## Conclusion - -Thank you for your interest in contributing to [Ultralytics open-source](https://github.com/ultralytics) YOLO projects. Your participation is crucial in shaping the future of our software and fostering a community of innovation and collaboration. Whether you're improving code, reporting bugs, or suggesting features, your contributions make a significant impact. - -We're eager to see your ideas in action and appreciate your commitment to advancing object detection technology. Let's continue to grow and innovate together in this exciting open-source journey. Happy coding! 🚀🌟 diff --git a/ultralytics-main/docs/en/help/environmental-health-safety.md b/ultralytics-main/docs/en/help/environmental-health-safety.md deleted file mode 100644 index 9fee240..0000000 --- a/ultralytics-main/docs/en/help/environmental-health-safety.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -comments: false -description: Discover Ultralytics’ EHS policy principles and implementation measures. Committed to safety, environment, and continuous improvement for a sustainable future. -keywords: Ultralytics policy, EHS, environment, health and safety, compliance, prevention, continuous improvement, risk management, emergency preparedness, resource allocation, communication ---- - -# Ultralytics Environmental, Health and Safety (EHS) Policy - -At Ultralytics, we recognize that the long-term success of our company relies not only on the products and services we offer, but also the manner in which we conduct our business. We are committed to ensuring the safety and well-being of our employees, stakeholders, and the environment, and we will continuously strive to mitigate our impact on the environment while promoting health and safety. - -## Policy Principles - -1. **Compliance**: We will comply with all applicable laws, regulations, and standards related to EHS, and we will strive to exceed these standards where possible. - -2. **Prevention**: We will work to prevent accidents, injuries, and environmental harm by implementing risk management measures and ensuring all our operations and procedures are safe. - -3. **Continuous Improvement**: We will continuously improve our EHS performance by setting measurable objectives, monitoring our performance, auditing our operations, and revising our policies and procedures as needed. - -4. **Communication**: We will communicate openly about our EHS performance and will engage with stakeholders to understand and address their concerns and expectations. - -5. **Education and Training**: We will educate and train our employees and contractors in appropriate EHS procedures and practices. - -## Implementation Measures - -1. **Responsibility and Accountability**: Every employee and contractor working at or with Ultralytics is responsible for adhering to this policy. Managers and supervisors are accountable for ensuring this policy is implemented within their areas of control. - -2. **Risk Management**: We will identify, assess, and manage EHS risks associated with our operations and activities to prevent accidents, injuries, and environmental harm. - -3. **Resource Allocation**: We will allocate the necessary resources to ensure the effective implementation of our EHS policy, including the necessary equipment, personnel, and training. - -4. **Emergency Preparedness and Response**: We will develop, maintain, and test emergency preparedness and response plans to ensure we can respond effectively to EHS incidents. - -5. **Monitoring and Review**: We will monitor and review our EHS performance regularly to identify opportunities for improvement and ensure we are meeting our objectives. - -This policy reflects our commitment to minimizing our environmental footprint, ensuring the safety and well-being of our employees, and continuously improving our performance. - -Please remember that the implementation of an effective EHS policy requires the involvement and commitment of everyone working at or with Ultralytics. We encourage you to take personal responsibility for your safety and the safety of others, and to take care of the environment in which we live and work. diff --git a/ultralytics-main/docs/en/help/index.md b/ultralytics-main/docs/en/help/index.md deleted file mode 100644 index e8f7376..0000000 --- a/ultralytics-main/docs/en/help/index.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -comments: true -description: Find comprehensive guides and documents on Ultralytics YOLO tasks. Includes FAQs, contributing guides, CI guide, CLA, MRE guide, code of conduct & more. -keywords: Ultralytics, YOLO, guides, documents, FAQ, contributing, CI guide, CLA, MRE guide, code of conduct, EHS policy, security policy, privacy policy ---- - -Welcome to the Ultralytics Help page! We are dedicated to providing you with detailed resources to enhance your experience with the Ultralytics YOLO models and repositories. This page serves as your portal to guides and documentation designed to assist you with various tasks and answer questions you may encounter while engaging with our repositories. - -- [Frequently Asked Questions (FAQ)](FAQ.md): Find answers to common questions and issues encountered by the community of Ultralytics YOLO users and contributors. -- [Contributing Guide](contributing.md): Discover the protocols for making contributions, including how to submit pull requests, report bugs, and more. -- [Continuous Integration (CI) Guide](CI.md): Gain insights into the CI processes we employ, complete with status reports for each Ultralytics repository. -- [Contributor License Agreement (CLA)](CLA.md): Review the CLA to understand the rights and responsibilities associated with contributing to Ultralytics projects. -- [Minimum Reproducible Example (MRE) Guide](minimum_reproducible_example.md): Learn the process for creating an MRE, which is crucial for the timely and effective resolution of bug reports. -- [Code of Conduct](code_of_conduct.md): Our community guidelines support a respectful and open atmosphere for all collaborators. -- [Environmental, Health and Safety (EHS) Policy](environmental-health-safety.md): Delve into our commitment to sustainability and the well-being of all our stakeholders. -- [Security Policy](security.md): Familiarize yourself with our security protocols and the procedure for reporting vulnerabilities. -- [Privacy Policy](privacy.md): Read our privacy policy to understand how we protect your data and respect your privacy in all our services and operations. - -We encourage you to review these resources for a seamless and productive experience. Our aim is to foster a helpful and friendly environment for everyone in the Ultralytics community. Should you require additional support, please feel free to reach out via GitHub Issues or our official discussion forums. Happy coding! diff --git a/ultralytics-main/docs/en/help/minimum_reproducible_example.md b/ultralytics-main/docs/en/help/minimum_reproducible_example.md deleted file mode 100644 index 47a0cdf..0000000 --- a/ultralytics-main/docs/en/help/minimum_reproducible_example.md +++ /dev/null @@ -1,78 +0,0 @@ ---- -comments: true -description: Learn how to create minimum reproducible examples (MRE) for efficient bug reporting in Ultralytics YOLO repositories with this step-by-step guide. -keywords: Ultralytics, YOLO, minimum reproducible example, MRE, bug reports, guide, dependencies, code, troubleshooting ---- - -# Creating a Minimum Reproducible Example for Bug Reports in Ultralytics YOLO Repositories - -When submitting a bug report for Ultralytics YOLO repositories, it's essential to provide a [minimum reproducible example](https://docs.ultralytics.com/help/minimum_reproducible_example/) (MRE). An MRE is a small, self-contained piece of code that demonstrates the problem you're experiencing. Providing an MRE helps maintainers and contributors understand the issue and work on a fix more efficiently. This guide explains how to create an MRE when submitting bug reports to Ultralytics YOLO repositories. - -## 1. Isolate the Problem - -The first step in creating an MRE is to isolate the problem. This means removing any unnecessary code or dependencies that are not directly related to the issue. Focus on the specific part of the code that is causing the problem and remove any irrelevant code. - -## 2. Use Public Models and Datasets - -When creating an MRE, use publicly available models and datasets to reproduce the issue. For example, use the 'yolov8n.pt' model and the 'coco8.yaml' dataset. This ensures that the maintainers and contributors can easily run your example and investigate the problem without needing access to proprietary data or custom models. - -## 3. Include All Necessary Dependencies - -Make sure to include all the necessary dependencies in your MRE. If your code relies on external libraries, specify the required packages and their versions. Ideally, provide a `requirements.txt` file or list the dependencies in your bug report. - -## 4. Write a Clear Description of the Issue - -Provide a clear and concise description of the issue you're experiencing. Explain the expected behavior and the actual behavior you're encountering. If applicable, include any relevant error messages or logs. - -## 5. Format Your Code Properly - -When submitting an MRE, format your code properly using code blocks in the issue description. This makes it easier for others to read and understand your code. In GitHub, you can create a code block by wrapping your code with triple backticks (\```) and specifying the language: - -
-```python
-# Your Python code goes here
-```
-
- -## 6. Test Your MRE - -Before submitting your MRE, test it to ensure that it accurately reproduces the issue. Make sure that others can run your example without any issues or modifications. - -## Example of an MRE - -Here's an example of an MRE for a hypothetical bug report: - -**Bug description:** - -When running the `detect.py` script on the sample image from the 'coco8.yaml' dataset, I get an error related to the dimensions of the input tensor. - -**MRE:** - -```python -import torch -from ultralytics import YOLO - -# Load the model -model = YOLO("yolov8n.pt") - -# Load a 0-channel image -image = torch.rand(1, 0, 640, 640) - -# Run the model -results = model(image) -``` - -**Error message:** - -``` -RuntimeError: Expected input[1, 0, 640, 640] to have 3 channels, but got 0 channels instead -``` - -**Dependencies:** - -- torch==2.0.0 -- ultralytics==8.0.90 - -In this example, the MRE demonstrates the issue with a minimal amount of code, uses a public model ('yolov8n.pt'), includes all necessary dependencies, and provides a clear description of the problem along with the error message. - -By following these guidelines, you'll help the maintainers and contributors of Ultralytics YOLO repositories to understand and resolve your issue more efficiently. diff --git a/ultralytics-main/docs/en/help/privacy.md b/ultralytics-main/docs/en/help/privacy.md deleted file mode 100644 index c9bc3a5..0000000 --- a/ultralytics-main/docs/en/help/privacy.md +++ /dev/null @@ -1,137 +0,0 @@ ---- -description: Learn about how Ultralytics collects and uses data to improve user experience, ensure software stability, and address privacy concerns, with options to opt-out. -keywords: Ultralytics, Data Collection, User Privacy, Google Analytics, Sentry, Crash Reporting, Anonymized Data, Privacy Settings, Opt-Out ---- - -# Data Collection for Ultralytics Python Package - -## Overview - -[Ultralytics](https://ultralytics.com) is dedicated to the continuous enhancement of the user experience and the capabilities of our Python package, including the advanced YOLO models we develop. Our approach involves the gathering of anonymized usage statistics and crash reports, helping us identify opportunities for improvement and ensuring the reliability of our software. This transparency document outlines what data we collect, its purpose, and the choice you have regarding this data collection. - -## Anonymized Google Analytics - -[Google Analytics](https://developers.google.com/analytics) is a web analytics service offered by Google that tracks and reports website traffic. It allows us to collect data about how our Python package is used, which is crucial for making informed decisions about design and functionality. - -### What We Collect - -- **Usage Metrics**: These metrics help us understand how frequently and in what ways the package is utilized, what features are favored, and the typical command-line arguments that are used. -- **System Information**: We collect general non-identifiable information about your computing environment to ensure our package performs well across various systems. -- **Performance Data**: Understanding the performance of our models during training, validation, and inference helps us in identifying optimization opportunities. - -For more information about Google Analytics and data privacy, visit [Google Analytics Privacy](https://support.google.com/analytics/answer/6004245). - -### How We Use This Data - -- **Feature Improvement**: Insights from usage metrics guide us in enhancing user satisfaction and interface design. -- **Optimization**: Performance data assist us in fine-tuning our models for better efficiency and speed across diverse hardware and software configurations. -- **Trend Analysis**: By studying usage trends, we can predict and respond to the evolving needs of our community. - -### Privacy Considerations - -We take several measures to ensure the privacy and security of the data you entrust to us: - -- **Anonymization**: We configure Google Analytics to anonymize the data collected, which means no personally identifiable information (PII) is gathered. You can use our services with the assurance that your personal details remain private. -- **Aggregation**: Data is analyzed only in aggregate form. This practice ensures that patterns can be observed without revealing any individual user's activity. -- **No Image Data Collection**: Ultralytics does not collect, process, or view any training or inference images. - -## Sentry Crash Reporting - -[Sentry](https://sentry.io/) is a developer-centric error tracking software that aids in identifying, diagnosing, and resolving issues in real-time, ensuring the robustness and reliability of applications. Within our package, it plays a crucial role by providing insights through crash reporting, significantly contributing to the stability and ongoing refinement of our software. - -!!! Note - - Crash reporting via Sentry is activated only if the `sentry-sdk` Python package is pre-installed on your system. This package isn't included in the `ultralytics` prerequisites and won't be installed automatically by Ultralytics. - -### What We Collect - -If the `sentry-sdk` Python package is pre-installed on your system a crash event may send the following information: - -- **Crash Logs**: Detailed reports on the application's condition at the time of a crash, which are vital for our debugging efforts. -- **Error Messages**: We record error messages generated during the operation of our package to understand and resolve potential issues quickly. - -To learn more about how Sentry handles data, please visit [Sentry's Privacy Policy](https://sentry.io/privacy/). - -### How We Use This Data - -- **Debugging**: Analyzing crash logs and error messages enables us to swiftly identify and correct software bugs. -- **Stability Metrics**: By constantly monitoring for crashes, we aim to improve the stability and reliability of our package. - -### Privacy Considerations - -- **Sensitive Information**: We ensure that crash logs are scrubbed of any personally identifiable or sensitive user data, safeguarding the confidentiality of your information. -- **Controlled Collection**: Our crash reporting mechanism is meticulously calibrated to gather only what is essential for troubleshooting while respecting user privacy. - -By detailing the tools used for data collection and offering additional background information with URLs to their respective privacy pages, users are provided with a comprehensive view of our practices, emphasizing transparency and respect for user privacy. - -## Disabling Data Collection - -We believe in providing our users with full control over their data. By default, our package is configured to collect analytics and crash reports to help improve the experience for all users. However, we respect that some users may prefer to opt out of this data collection. - -To opt out of sending analytics and crash reports, you can simply set `sync=False` in your YOLO settings. This ensures that no data is transmitted from your machine to our analytics tools. - -### Inspecting Settings - -To gain insight into the current configuration of your settings, you can view them directly: - -!!! Example "View settings" - - === "Python" - You can use Python to view your settings. Start by importing the `settings` object from the `ultralytics` module. Print and return settings using the following commands: - ```python - from ultralytics import settings - - # View all settings - print(settings) - - # Return analytics and crash reporting setting - value = settings['sync'] - ``` - - === "CLI" - Alternatively, the command-line interface allows you to check your settings with a simple command: - ```bash - yolo settings - ``` - -### Modifying Settings - -Ultralytics allows users to easily modify their settings. Changes can be performed in the following ways: - -!!! Example "Update settings" - - === "Python" - Within the Python environment, call the `update` method on the `settings` object to change your settings: - ```python - from ultralytics import settings - - # Disable analytics and crash reporting - settings.update({'sync': False}) - - # Reset settings to default values - settings.reset() - ``` - - === "CLI" - If you prefer using the command-line interface, the following commands will allow you to modify your settings: - ```bash - # Disable analytics and crash reporting - yolo settings sync=False - - # Reset settings to default values - yolo settings reset - ``` - -The `sync=False` setting will prevent any data from being sent to Google Analytics or Sentry. Your settings will be respected across all sessions using the Ultralytics package and saved to disk for future sessions. - -## Commitment to Privacy - -Ultralytics takes user privacy seriously. We design our data collection practices with the following principles: - -- **Transparency**: We are open about the data we collect and how it is used. -- **Control**: We give users full control over their data. -- **Security**: We employ industry-standard security measures to protect the data we collect. - -## Questions or Concerns - -If you have any questions or concerns about our data collection practices, please reach out to us via our [contact form](https://ultralytics.com/contact) or via [support@ultralytics.com](mailto:support@ultralytics.com). We are dedicated to ensuring our users feel informed and confident in their privacy when using our package. diff --git a/ultralytics-main/docs/en/help/security.md b/ultralytics-main/docs/en/help/security.md deleted file mode 100644 index 01ea1f8..0000000 --- a/ultralytics-main/docs/en/help/security.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -description: Explore Ultralytics' comprehensive security strategies safeguarding user data and systems. Learn about our diverse security tools, including Snyk, GitHub CodeQL, and Dependabot Alerts. -keywords: Ultralytics, Comprehensive Security, user data protection, Snyk, GitHub CodeQL, Dependabot, vulnerability management, coding security practices ---- - -# Ultralytics Security Policy - -At [Ultralytics](https://ultralytics.com), the security of our users' data and systems is of utmost importance. To ensure the safety and security of our [open-source projects](https://github.com/ultralytics), we have implemented several measures to detect and prevent security vulnerabilities. - -## Snyk Scanning - -We utilize [Snyk](https://snyk.io/advisor/python/ultralytics) to conduct comprehensive security scans on Ultralytics repositories. Snyk's robust scanning capabilities extend beyond dependency checks; it also examines our code and Dockerfiles for various vulnerabilities. By identifying and addressing these issues proactively, we ensure a higher level of security and reliability for our users. - -[![ultralytics](https://snyk.io/advisor/python/ultralytics/badge.svg)](https://snyk.io/advisor/python/ultralytics) - -## GitHub CodeQL Scanning - -Our security strategy includes GitHub's [CodeQL](https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql) scanning. CodeQL delves deep into our codebase, identifying complex vulnerabilities like SQL injection and XSS by analyzing the code's semantic structure. This advanced level of analysis ensures early detection and resolution of potential security risks. - -[![CodeQL](https://github.com/ultralytics/ultralytics/actions/workflows/codeql.yaml/badge.svg)](https://github.com/ultralytics/ultralytics/actions/workflows/codeql.yaml) - -## GitHub Dependabot Alerts - -[Dependabot](https://docs.github.com/en/code-security/dependabot) is integrated into our workflow to monitor dependencies for known vulnerabilities. When a vulnerability is identified in one of our dependencies, Dependabot alerts us, allowing for swift and informed remediation actions. - -## GitHub Secret Scanning Alerts - -We employ GitHub [secret scanning](https://docs.github.com/en/code-security/secret-scanning/managing-alerts-from-secret-scanning) alerts to detect sensitive data, such as credentials and private keys, accidentally pushed to our repositories. This early detection mechanism helps prevent potential security breaches and data exposures. - -## Private Vulnerability Reporting - -We enable private vulnerability reporting, allowing users to discreetly report potential security issues. This approach facilitates responsible disclosure, ensuring vulnerabilities are handled securely and efficiently. - -If you suspect or discover a security vulnerability in any of our repositories, please let us know immediately. You can reach out to us directly via our [contact form](https://ultralytics.com/contact) or via [security@ultralytics.com](mailto:security@ultralytics.com). Our security team will investigate and respond as soon as possible. - -We appreciate your help in keeping all Ultralytics open-source projects secure and safe for everyone 🙏. diff --git a/ultralytics-main/docs/en/hub/api/index.md b/ultralytics-main/docs/en/hub/api/index.md deleted file mode 100644 index f8d7802..0000000 --- a/ultralytics-main/docs/en/hub/api/index.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -description: Discover what's next for Ultralytics with our under-construction page, previewing new, groundbreaking AI and ML features coming soon. -keywords: Ultralytics, coming soon, under construction, new features, AI updates, ML advancements, YOLO, technology preview ---- - -# Under Construction 🏗️🌟 - -Welcome to the Ultralytics "Under Construction" page! Here, we're hard at work developing the next generation of AI and ML innovations. This page serves as a teaser for the exciting updates and new features we're eager to share with you! - -## Exciting New Features on the Way 🎉 - -- **Innovative Breakthroughs:** Get ready for advanced features and services that will transform your AI and ML experience. -- **New Horizons:** Anticipate novel products that redefine AI and ML capabilities. -- **Enhanced Services:** We're upgrading our services for greater efficiency and user-friendliness. - -## Stay Updated 🚧 - -This placeholder page is your first stop for upcoming developments. Keep an eye out for: - -- **Newsletter:** Subscribe [here](https://ultralytics.com/#newsletter) for the latest news. -- **Social Media:** Follow us [here](https://www.linkedin.com/company/ultralytics) for updates and teasers. -- **Blog:** Visit our [blog](https://ultralytics.com/blog) for detailed insights. - -## We Value Your Input 🗣️ - -Your feedback shapes our future releases. Share your thoughts and suggestions [here](https://ultralytics.com/contact). - -## Thank You, Community! 🌍 - -Your [contributions](https://docs.ultralytics.com/help/contributing) inspire our continuous [innovation](https://github.com/ultralytics/ultralytics). Stay tuned for the big reveal of what's next in AI and ML at Ultralytics! - ---- - -Excited for what's coming? Bookmark this page and get ready for a transformative AI and ML journey with Ultralytics! 🛠️🤖 diff --git a/ultralytics-main/docs/en/hub/app/android.md b/ultralytics-main/docs/en/hub/app/android.md deleted file mode 100644 index 7a80474..0000000 --- a/ultralytics-main/docs/en/hub/app/android.md +++ /dev/null @@ -1,100 +0,0 @@ ---- -comments: true -description: Learn about the Ultralytics Android App, enabling real-time object detection using YOLO models. Discover in-app features, quantization methods, and delegate options for optimal performance. -keywords: Ultralytics, Android App, real-time object detection, YOLO models, TensorFlow Lite, FP16 quantization, INT8 quantization, CPU, GPU, Hexagon, NNAPI ---- - -# Ultralytics Android App: Real-time Object Detection with YOLO Models - - - Ultralytics HUB preview image -
-
- Ultralytics GitHub - space - Ultralytics LinkedIn - space - Ultralytics Twitter - space - Ultralytics YouTube - space - Ultralytics TikTok - space - Ultralytics Instagram - space - Ultralytics Discord -
-
- - Google Play store  -
- -The Ultralytics Android App is a powerful tool that allows you to run YOLO models directly on your Android device for real-time object detection. This app utilizes TensorFlow Lite for model optimization and various hardware delegates for acceleration, enabling fast and efficient object detection. - -

-
- -
- Watch: Getting Started with the Ultralytics HUB App (IOS & Android) -

- -## Quantization and Acceleration - -To achieve real-time performance on your Android device, YOLO models are quantized to either FP16 or INT8 precision. Quantization is a process that reduces the numerical precision of the model's weights and biases, thus reducing the model's size and the amount of computation required. This results in faster inference times without significantly affecting the model's accuracy. - -### FP16 Quantization - -FP16 (or half-precision) quantization converts the model's 32-bit floating-point numbers to 16-bit floating-point numbers. This reduces the model's size by half and speeds up the inference process, while maintaining a good balance between accuracy and performance. - -### INT8 Quantization - -INT8 (or 8-bit integer) quantization further reduces the model's size and computation requirements by converting its 32-bit floating-point numbers to 8-bit integers. This quantization method can result in a significant speedup, but it may lead to a slight reduction in mean average precision (mAP) due to the lower numerical precision. - -!!! Tip "mAP Reduction in INT8 Models" - - The reduced numerical precision in INT8 models can lead to some loss of information during the quantization process, which may result in a slight decrease in mAP. However, this trade-off is often acceptable considering the substantial performance gains offered by INT8 quantization. - -## Delegates and Performance Variability - -Different delegates are available on Android devices to accelerate model inference. These delegates include CPU, [GPU](https://www.tensorflow.org/lite/android/delegates/gpu), [Hexagon](https://www.tensorflow.org/lite/android/delegates/hexagon) and [NNAPI](https://www.tensorflow.org/lite/android/delegates/nnapi). The performance of these delegates varies depending on the device's hardware vendor, product line, and specific chipsets used in the device. - -1. **CPU**: The default option, with reasonable performance on most devices. -2. **GPU**: Utilizes the device's GPU for faster inference. It can provide a significant performance boost on devices with powerful GPUs. -3. **Hexagon**: Leverages Qualcomm's Hexagon DSP for faster and more efficient processing. This option is available on devices with Qualcomm Snapdragon processors. -4. **NNAPI**: The Android Neural Networks API (NNAPI) serves as an abstraction layer for running ML models on Android devices. NNAPI can utilize various hardware accelerators, such as CPU, GPU, and dedicated AI chips (e.g., Google's Edge TPU, or the Pixel Neural Core). - -Here's a table showing the primary vendors, their product lines, popular devices, and supported delegates: - -| Vendor | Product Lines | Popular Devices | Delegates Supported | -|-----------------------------------------|--------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------| -| [Qualcomm](https://www.qualcomm.com/) | [Snapdragon (e.g., 800 series)](https://www.qualcomm.com/snapdragon) | [Samsung Galaxy S21](https://www.samsung.com/global/galaxy/galaxy-s21-5g/), [OnePlus 9](https://www.oneplus.com/9), [Google Pixel 6](https://store.google.com/product/pixel_6) | CPU, GPU, Hexagon, NNAPI | -| [Samsung](https://www.samsung.com/) | [Exynos (e.g., Exynos 2100)](https://www.samsung.com/semiconductor/minisite/exynos/) | [Samsung Galaxy S21 (Global version)](https://www.samsung.com/global/galaxy/galaxy-s21-5g/) | CPU, GPU, NNAPI | -| [MediaTek](https://i.mediatek.com/) | [Dimensity (e.g., Dimensity 1200)](https://i.mediatek.com/dimensity-1200) | [Realme GT](https://www.realme.com/global/realme-gt), [Xiaomi Redmi Note](https://www.mi.com/en/phone/redmi/note-list) | CPU, GPU, NNAPI | -| [HiSilicon](https://www.hisilicon.com/) | [Kirin (e.g., Kirin 990)](https://www.hisilicon.com/en/products/Kirin) | [Huawei P40 Pro](https://consumer.huawei.com/en/phones/p40-pro/), [Huawei Mate 30 Pro](https://consumer.huawei.com/en/phones/mate30-pro/) | CPU, GPU, NNAPI | -| [NVIDIA](https://www.nvidia.com/) | [Tegra (e.g., Tegra X1)](https://developer.nvidia.com/content/tegra-x1) | [NVIDIA Shield TV](https://www.nvidia.com/en-us/shield/shield-tv/), [Nintendo Switch](https://www.nintendo.com/switch/) | CPU, GPU, NNAPI | - -Please note that the list of devices mentioned is not exhaustive and may vary depending on the specific chipsets and device models. Always test your models on your target devices to ensure compatibility and optimal performance. - -Keep in mind that the choice of delegate can affect performance and model compatibility. For example, some models may not work with certain delegates, or a delegate may not be available on a specific device. As such, it's essential to test your model and the chosen delegate on your target devices for the best results. - -## Getting Started with the Ultralytics Android App - -To get started with the Ultralytics Android App, follow these steps: - -1. Download the Ultralytics App from the [Google Play Store](https://play.google.com/store/apps/details?id=com.ultralytics.ultralytics_app). - -2. Launch the app on your Android device and sign in with your Ultralytics account. If you don't have an account yet, create one [here](https://hub.ultralytics.com/). - -3. Once signed in, you will see a list of your trained YOLO models. Select a model to use for object detection. - -4. Grant the app permission to access your device's camera. - -5. Point your device's camera at objects you want to detect. The app will display bounding boxes and class labels in real-time as it detects objects. - -6. Explore the app's settings to adjust the detection threshold, enable or disable specific object classes, and more. - -With the Ultralytics Android App, you now have the power of real-time object detection using YOLO models right at your fingertips. Enjoy exploring the app's features and optimizing its settings to suit your specific use cases. diff --git a/ultralytics-main/docs/en/hub/app/index.md b/ultralytics-main/docs/en/hub/app/index.md deleted file mode 100644 index ef962e8..0000000 --- a/ultralytics-main/docs/en/hub/app/index.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -comments: true -description: Explore the Ultralytics HUB App, offering the ability to run YOLOv5 and YOLOv8 models on your iOS and Android devices with optimized performance. -keywords: Ultralytics, HUB App, YOLOv5, YOLOv8, mobile AI, real-time object detection, image recognition, mobile device, hardware acceleration, Apple Neural Engine, Android GPU, NNAPI, custom model training ---- - -# Ultralytics HUB App - - - Ultralytics HUB preview image -
-
- Ultralytics GitHub - space - Ultralytics LinkedIn - space - Ultralytics Twitter - space - Ultralytics YouTube - space - Ultralytics TikTok - space - Ultralytics Instagram - space - Ultralytics Discord -
-
- - Apple App store - - Google Play store  -
- -Welcome to the Ultralytics HUB App! We are excited to introduce this powerful mobile app that allows you to run YOLOv5 and YOLOv8 models directly on your [iOS](https://apps.apple.com/xk/app/ultralytics/id1583935240) and [Android](https://play.google.com/store/apps/details?id=com.ultralytics.ultralytics_app) devices. With the HUB App, you can utilize hardware acceleration features like Apple's Neural Engine (ANE) or Android GPU and Neural Network API (NNAPI) delegates to achieve impressive performance on your mobile device. - -## Features - -- **Run YOLOv5 and YOLOv8 models**: Experience the power of YOLO models on your mobile device for real-time object detection and image recognition tasks. -- **Hardware Acceleration**: Benefit from Apple ANE on iOS devices or Android GPU and NNAPI delegates for optimized performance. -- **Custom Model Training**: Train custom models with the Ultralytics HUB platform and preview them live using the HUB App. -- **Mobile Compatibility**: The HUB App supports both iOS and Android devices, bringing the power of YOLO models to a wide range of users. - -## App Documentation - -- [**iOS**](ios.md): Learn about YOLO CoreML models accelerated on Apple's Neural Engine for iPhones and iPads. -- [**Android**](android.md): Explore TFLite acceleration on Android mobile devices. - -Get started today by downloading the Ultralytics HUB App on your mobile device and unlock the potential of YOLOv5 and YOLOv8 models on-the-go. Don't forget to check out our comprehensive [HUB Docs](../index.md) for more information on training, deploying, and using your custom models with the Ultralytics HUB platform. diff --git a/ultralytics-main/docs/en/hub/app/ios.md b/ultralytics-main/docs/en/hub/app/ios.md deleted file mode 100644 index 41e4b63..0000000 --- a/ultralytics-main/docs/en/hub/app/ios.md +++ /dev/null @@ -1,90 +0,0 @@ ---- -comments: true -description: Execute object detection in real-time on your iOS devices utilizing YOLO models. Leverage the power of the Apple Neural Engine and Core ML for fast and efficient object detection. -keywords: Ultralytics, iOS app, object detection, YOLO models, real time, Apple Neural Engine, Core ML, FP16, INT8, quantization ---- - -# Ultralytics iOS App: Real-time Object Detection with YOLO Models - - - Ultralytics HUB preview image -
-
- Ultralytics GitHub - space - Ultralytics LinkedIn - space - Ultralytics Twitter - space - Ultralytics YouTube - space - Ultralytics TikTok - space - Ultralytics Instagram - space - Ultralytics Discord -
-
- - Apple App store -
- -The Ultralytics iOS App is a powerful tool that allows you to run YOLO models directly on your iPhone or iPad for real-time object detection. This app utilizes the Apple Neural Engine and Core ML for model optimization and acceleration, enabling fast and efficient object detection. - -

-
- -
- Watch: Getting Started with the Ultralytics HUB App (IOS & Android) -

- -## Quantization and Acceleration - -To achieve real-time performance on your iOS device, YOLO models are quantized to either FP16 or INT8 precision. Quantization is a process that reduces the numerical precision of the model's weights and biases, thus reducing the model's size and the amount of computation required. This results in faster inference times without significantly affecting the model's accuracy. - -### FP16 Quantization - -FP16 (or half-precision) quantization converts the model's 32-bit floating-point numbers to 16-bit floating-point numbers. This reduces the model's size by half and speeds up the inference process, while maintaining a good balance between accuracy and performance. - -### INT8 Quantization - -INT8 (or 8-bit integer) quantization further reduces the model's size and computation requirements by converting its 32-bit floating-point numbers to 8-bit integers. This quantization method can result in a significant speedup, but it may lead to a slight reduction in accuracy. - -## Apple Neural Engine - -The Apple Neural Engine (ANE) is a dedicated hardware component integrated into Apple's A-series and M-series chips. It's designed to accelerate machine learning tasks, particularly for neural networks, allowing for faster and more efficient execution of your YOLO models. - -By combining quantized YOLO models with the Apple Neural Engine, the Ultralytics iOS App achieves real-time object detection on your iOS device without compromising on accuracy or performance. - -| Release Year | iPhone Name | Chipset Name | Node Size | ANE TOPs | -|--------------|------------------------------------------------------|-------------------------------------------------------|-----------|----------| -| 2017 | [iPhone X](https://en.wikipedia.org/wiki/IPhone_X) | [A11 Bionic](https://en.wikipedia.org/wiki/Apple_A11) | 10 nm | 0.6 | -| 2018 | [iPhone XS](https://en.wikipedia.org/wiki/IPhone_XS) | [A12 Bionic](https://en.wikipedia.org/wiki/Apple_A12) | 7 nm | 5 | -| 2019 | [iPhone 11](https://en.wikipedia.org/wiki/IPhone_11) | [A13 Bionic](https://en.wikipedia.org/wiki/Apple_A13) | 7 nm | 6 | -| 2020 | [iPhone 12](https://en.wikipedia.org/wiki/IPhone_12) | [A14 Bionic](https://en.wikipedia.org/wiki/Apple_A14) | 5 nm | 11 | -| 2021 | [iPhone 13](https://en.wikipedia.org/wiki/IPhone_13) | [A15 Bionic](https://en.wikipedia.org/wiki/Apple_A15) | 5 nm | 15.8 | -| 2022 | [iPhone 14](https://en.wikipedia.org/wiki/IPhone_14) | [A16 Bionic](https://en.wikipedia.org/wiki/Apple_A16) | 4 nm | 17.0 | - -Please note that this list only includes iPhone models from 2017 onwards, and the ANE TOPs values are approximate. - -## Getting Started with the Ultralytics iOS App - -To get started with the Ultralytics iOS App, follow these steps: - -1. Download the Ultralytics App from the [App Store](https://apps.apple.com/xk/app/ultralytics/id1583935240). - -2. Launch the app on your iOS device and sign in with your Ultralytics account. If you don't have an account yet, create one [here](https://hub.ultralytics.com/). - -3. Once signed in, you will see a list of your trained YOLO models. Select a model to use for object detection. - -4. Grant the app permission to access your device's camera. - -5. Point your device's camera at objects you want to detect. The app will display bounding boxes and class labels in real-time as it detects objects. - -6. Explore the app's settings to adjust the detection threshold, enable or disable specific object classes, and more. - -With the Ultralytics iOS App, you can now leverage the power of YOLO models for real-time object detection on your iPhone or iPad, powered by the Apple Neural Engine and optimized with FP16 or INT8 quantization. diff --git a/ultralytics-main/docs/en/hub/cloud-training.md b/ultralytics-main/docs/en/hub/cloud-training.md deleted file mode 100644 index f774475..0000000 --- a/ultralytics-main/docs/en/hub/cloud-training.md +++ /dev/null @@ -1,89 +0,0 @@ ---- -comments: true -description: Learn how to use Ultralytics HUB for efficient and user-friendly AI model training in the cloud. Follow our detailed guide for easy model creation, training, evaluation, and deployment. -keywords: Ultralytics, HUB Models, AI model training, model creation, model training, model evaluation, model deployment ---- - -# Cloud Training - -[Ultralytics HUB](https://hub.ultralytics.com/) provides a powerful and user-friendly cloud platform to train custom object detection models. Easily select your dataset and the desired training method, then kick off the process with just a few clicks. Ultralytics HUB offers pre-built options and various model architectures to streamline your workflow. - -![cloud training cover](https://github.com/ultralytics/ultralytics/assets/19519529/cbfdb3b8-ad35-44a6-afe6-61ec0b8e8b8d) - -Read more about creating and other details of a Model at our [HUB Models page](models.md) - -

-
- -
- Watch: New Feature 🌟 Introducing Ultralytics HUB Cloud Training -

- -## Selecting an Instance - -For details on picking a model and instances for it, please read our [Instances guide Page](models.md) - -## Steps to Train the Model - -Once the instance has been selected, training a model using Ultralytics HUB is a three-step process, as below: - -1. Picking a Dataset - Read more about datasets, steps to add/remove datasets from the [Dataset page](datasets.md) -2. Picking a Model - Read more about models, steps to create/share and handle a model on the [HUB Models page](models.md) -3. Training the Model on the Chosen Dataset - -Ultralytics HUB offers three training options: - -- **Ultralytics Cloud** - Explained in this page. -- **Google Colab** - Train on Google's popular Colab notebooks. -- **Bring your own agent** - Train models locally on your own hardware or on-premise GPU servers. - -In order to start training your model, follow the instructions presented in these steps. - -## Training via Ultralytics Cloud - -To start training your model using Ultralytics Cloud, simply select the Training Duration, Available Instances, and Payment options. - -**Training Duration** - Ultralytics offers two kinds of training durations: - -1. Training based on `Epochs`: This option allows you to train your model based on the number of times your dataset needs to go through the cycle of train, label, and test. The exact pricing based on the number of epochs is hard to determine. Hence, if the credit gets exhausted before the intended number of epochs, the training pauses, and you get a prompt to top-up and resume training. -2. Timed Training: The timed training feature allows you to fix the time duration of the entire training process and also determines the estimated amount before the start of training. - -![Ultralytics cloud screenshot of training duration options](https://github.com/ultralytics/ultralytics/assets/19519529/47b96f3f-a9ea-441a-b065-cba97edc333f) - -When the training starts, you can click **Done** and monitor the training progress on the Model page. - -## Monitor Your Training - -Once the model and mode of training have been selected, you can monitor the training procedure on the `Train` section with the link provided in the terminal (on your agent/Google Colab) or a button from Ultralytics Cloud. - -![Monitor your Training](https://github.com/ultralytics/ultralytics/assets/19519529/316f8301-0d60-465e-8c99-aa3daf66433c) - -## Stopping and Resuming Your Training - -Once the training has started, you can `Stop` the training, which will also correspondingly pause the credit usage. You can then `Resume` the training from the point where it stopped. - -![Pausing and Resuming Training](https://github.com/ultralytics/ultralytics/assets/19519529/b2707a93-fa5c-4ee2-8443-6be9e1c2857d) - -## Payments and Billing Options - -Ultralytics HUB offers `Pay Now` as upfront and/or using `Ultralytics HUB Account` as a wallet to top up and fulfill the billing. You can choose from two types of accounts: `Free` and `Pro` user. - -To access your profile, click on the profile picture in the bottom left corner. - -![Clicking profile picture](https://github.com/ultralytics/ultralytics/assets/19519529/53e5410e-06f5-4b40-b29d-ef00b5779163) - -Click on the Billing tab to view your current plan and options to upgrade it. - -![Clicking Upgrade button](https://github.com/ultralytics/ultralytics/assets/19519529/361b43c7-a9d4-4d05-b80b-dc1fa8bce829) - -You will be prompted with different available plans, and you can pick from the available plans as shown below. - -![Picking a plan](https://github.com/ultralytics/ultralytics/assets/19519529/4326b01c-0d7d-4850-ac4f-ced2de3339ee) - -Navigate to the Payment page, fill in the details, and complete the payment. - -![Payment Page](https://github.com/ultralytics/ultralytics/assets/19519529/5deebabe-1d8a-485a-b290-e038729c849f) diff --git a/ultralytics-main/docs/en/hub/datasets.md b/ultralytics-main/docs/en/hub/datasets.md deleted file mode 100644 index aadc59d..0000000 --- a/ultralytics-main/docs/en/hub/datasets.md +++ /dev/null @@ -1,146 +0,0 @@ ---- -comments: true -description: Learn how Ultralytics HUB datasets streamline your ML workflow. Upload, format, validate, access, share, edit or delete datasets for Ultralytics YOLO model training. -keywords: Ultralytics, HUB datasets, YOLO model training, upload datasets, dataset validation, ML workflow, share datasets ---- - -# HUB Datasets - -[Ultralytics HUB](https://hub.ultralytics.com/) datasets are a practical solution for managing and leveraging your custom datasets. - -Once uploaded, datasets can be immediately utilized for model training. This integrated approach facilitates a seamless transition from dataset management to model training, significantly simplifying the entire process. - -

-
- -
- Watch: Watch: Upload Datasets to Ultralytics HUB | Complete Walkthrough of Dataset Upload Feature -

- -## Upload Dataset - -Ultralytics HUB datasets are just like YOLOv5 and YOLOv8 🚀 datasets. They use the same structure and the same label formats to keep everything simple. - -Before you upload a dataset to Ultralytics HUB, make sure to **place your dataset YAML file inside the dataset root directory** and that **your dataset YAML, directory and ZIP have the same name**, as shown in the example below, and then zip the dataset directory. - -For example, if your dataset is called "coco8", as our [COCO8](https://docs.ultralytics.com/datasets/detect/coco8) example dataset, then you should have a `coco8.yaml` inside your `coco8/` directory, which will create a `coco8.zip` when zipped: - -```bash -zip -r coco8.zip coco8 -``` - -You can download our [COCO8](https://github.com/ultralytics/hub/blob/main/example_datasets/coco8.zip) example dataset and unzip it to see exactly how to structure your dataset. - -

- COCO8 Dataset Structure -

- -The dataset YAML is the same standard YOLOv5 and YOLOv8 YAML format. - -!!! Example "coco8.yaml" - - ```yaml - --8<-- "ultralytics/cfg/datasets/coco8.yaml" - ``` - -After zipping your dataset, you should validate it before uploading it to Ultralytics HUB. Ultralytics HUB conducts the dataset validation check post-upload, so by ensuring your dataset is correctly formatted and error-free ahead of time, you can forestall any setbacks due to dataset rejection. - -```py -from ultralytics.hub import check_dataset - -check_dataset('path/to/coco8.zip') -``` - -Once your dataset ZIP is ready, navigate to the [Datasets](https://hub.ultralytics.com/datasets) page by clicking on the **Datasets** button in the sidebar. - -![Ultralytics HUB screenshot of the Home page with an arrow pointing to the Datasets button in the sidebar](https://github.com/ultralytics/ultralytics/assets/19519529/2d9f774c-100d-4ff4-a82b-2a38ced33c21) - -Click on the **Upload Dataset** button on the top right of the page. This action will trigger the **Upload Dataset** dialog. - -![Ultralytics HUB screenshot of the Dataset page with an arrow pointing to the Upload Dataset button](https://github.com/ultralytics/ultralytics/assets/19519529/52ac10f5-ce42-483a-ac02-1d37d2cba3de) - -Upload your dataset in the _Dataset .zip file_ field. - -You have the additional option to set a custom name and description for your Ultralytics HUB dataset. - -When you're happy with your dataset configuration, click **Upload**. - -![Ultralytics HUB screenshot of the Upload Dataset dialog with an arrow pointing to the Upload button](https://github.com/ultralytics/ultralytics/assets/19519529/7d210ff6-bdb2-4535-a661-0470274bd7d6) - -After your dataset is uploaded and processed, you will be able to access it from the Datasets page. - -![Ultralytics HUB screenshot of the Datasets page with an arrow pointing to one of the datasets](https://github.com/ultralytics/ultralytics/assets/19519529/a05d9b66-f8ba-4474-b8ac-ebe0dd143831) - -You can view the images in your dataset grouped by splits (Train, Validation, Test). - -![Ultralytics HUB screenshot of the Dataset page with an arrow pointing to the Images tab](https://github.com/ultralytics/ultralytics/assets/19519529/e07468e3-6284-4334-9783-84bfb11130f8) - -!!! tip "Tip" - - Each image can be enlarged for better visualization. - - ![Ultralytics HUB screenshot of the Images tab inside the Dataset page with an arrow pointing to the expand icon](https://github.com/ultralytics/ultralytics/assets/19519529/26f411a0-5153-4805-a8c1-cbd379708e28) - - ![Ultralytics HUB screenshot of the Images tab inside the Dataset page with one of the images expanded](https://github.com/ultralytics/ultralytics/assets/19519529/7d5e0d50-85e5-4014-9f5b-464284e5b291) - -Also, you can analyze your dataset by click on the **Overview** tab. - -![Ultralytics HUB screenshot of the Dataset page with an arrow pointing to the Overview tab](https://github.com/ultralytics/ultralytics/assets/19519529/5eaacd5d-fedf-4332-9091-1418c9f333cb) - -Next, [train a model](https://docs.ultralytics.com/hub/models/#train-model) on your dataset. - -![Ultralytics HUB screenshot of the Dataset page with an arrow pointing to the Train Model button](https://github.com/ultralytics/ultralytics/assets/19519529/cb709e5f-a10b-478f-a81d-a48f61c193fe) - -## Share Dataset - -!!! Info "Info" - - Ultralytics HUB's sharing functionality provides a convenient way to share datasets with others. This feature is designed to accommodate both existing Ultralytics HUB users and those who have yet to create an account. - -!!! note "Note" - - You have control over the general access of your datasets. - - You can choose to set the general access to "Private", in which case, only you will have access to it. Alternatively, you can set the general access to "Unlisted" which grants viewing access to anyone who has the direct link to the dataset, regardless of whether they have an Ultralytics HUB account or not. - -Navigate to the Dataset page of the dataset you want to share, open the dataset actions dropdown and click on the **Share** option. This action will trigger the **Share Dataset** dialog. - -![Ultralytics HUB screenshot of the Dataset page with an arrow pointing to the Share option](https://github.com/ultralytics/ultralytics/assets/19519529/9a0e61e7-2838-42b3-8abe-a22980e6c680) - -!!! tip "Tip" - - You can also share a dataset directly from the [Datasets](https://hub.ultralytics.com/datasets) page. - - ![Ultralytics HUB screenshot of the Datasets page with an arrow pointing to the Share option of one of the datasets](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/datasets/hub_share_dataset_2.jpg) - -Set the general access to "Unlisted" and click **Save**. - -![Ultralytics HUB screenshot of the Share Dataset dialog with an arrow pointing to the dropdown and one to the Save button](https://github.com/ultralytics/ultralytics/assets/19519529/5818b928-19a3-48a8-892d-27ac1dc684dd) - -Now, anyone who has the direct link to your dataset can view it. - -!!! tip "Tip" - - You can easily click on the dataset's link shown in the **Share Dataset** dialog to copy it. - - ![Ultralytics HUB screenshot of the Share Dataset dialog with an arrow pointing to the dataset's link](https://github.com/ultralytics/ultralytics/assets/19519529/8ede7d20-2a68-411d-9de5-3175b5ba7038) - -## Edit / Delete Dataset - -Navigate to the Dataset page of the dataset you want to edit, open the dataset actions dropdown and click on the **Edit** option. This action will trigger the **Update Dataset** dialog. - -![Ultralytics HUB screenshot of the Dataset page with an arrow pointing to the Edit and Delete option](https://github.com/ultralytics/ultralytics/assets/19519529/6c248c8c-29cd-4bd5-b33d-43e90aa1d000) - -Apply the desired modifications to your dataset and then confirm the changes by clicking **Save**. - -Navigate to the Dataset page of the dataset you want to delete, open the dataset actions dropdown and click on the **Delete** option. This action will delete the dataset. - -!!! note "Note" - - If you change your mind, you can restore the dataset from the [Trash](https://hub.ultralytics.com/trash) page. - - ![Ultralytics HUB screenshot of the Trash page with an arrow pointing to the Restore option of one of the datasets](https://github.com/ultralytics/ultralytics/assets/19519529/56a9460c-0e06-4659-989d-715211b9d7ce) diff --git a/ultralytics-main/docs/en/hub/index.md b/ultralytics-main/docs/en/hub/index.md deleted file mode 100644 index 4b40240..0000000 --- a/ultralytics-main/docs/en/hub/index.md +++ /dev/null @@ -1,61 +0,0 @@ ---- -comments: true -description: Gain insights into training and deploying your YOLOv5 and YOLOv8 models with Ultralytics HUB. Explore pre-trained models, templates and various integrations. -keywords: Ultralytics HUB, YOLOv5, YOLOv8, model training, model deployment, pretrained models, model integrations ---- - -# Ultralytics HUB - - - Ultralytics HUB preview image -
-
- Ultralytics GitHub - space - Ultralytics LinkedIn - space - Ultralytics Twitter - space - Ultralytics YouTube - space - Ultralytics TikTok - space - Ultralytics Instagram - space - Ultralytics Discord -
-
- - CI CPU - - Open In Colab -
- -👋 Hello from the [Ultralytics](https://ultralytics.com/) Team! We've been working hard these last few months to launch [Ultralytics HUB](https://bit.ly/ultralytics_hub), a new web tool for training and deploying all your YOLOv5 and YOLOv8 🚀 models from one spot! - -## Introduction - -HUB is designed to be user-friendly and intuitive, with a drag-and-drop interface that allows users to easily upload their data and train new models quickly. It offers a range of pre-trained models and templates to choose from, making it easy for users to get started with training their own models. Once a model is trained, it can be easily deployed and used for real-time object detection, instance segmentation and classification tasks. - -

-
- -
- Watch: Train Your Custom YOLO Models In A Few Clicks with Ultralytics HUB. -

- -We hope that the resources here will help you get the most out of HUB. Please browse the HUB Docs for details, raise an issue on GitHub for support, and join our Discord community for questions and discussions! - -- [**Quickstart**](quickstart.md). Start training and deploying YOLO models with HUB in seconds. -- [**Datasets: Preparing and Uploading**](datasets.md). Learn how to prepare and upload your datasets to HUB in YOLO format. -- [**Projects: Creating and Managing**](projects.md). Group your models into projects for improved organization. -- [**Models: Training and Exporting**](models.md). Train YOLOv5 and YOLOv8 models on your custom datasets and export them to various formats for deployment. -- [**Integrations: Options**](integrations.md). Explore different integration options for your trained models, such as TensorFlow, ONNX, OpenVINO, CoreML, and PaddlePaddle. -- [**Ultralytics HUB App**](app/index.md). Learn about the Ultralytics App for iOS and Android, which allows you to run models directly on your mobile device. - - [**iOS**](app/ios.md). Learn about YOLO CoreML models accelerated on Apple's Neural Engine on iPhones and iPads. - - [**Android**](app/android.md). Explore TFLite acceleration on mobile devices. -- [**Inference API**](inference-api.md). Understand how to use the Inference API for running your trained models in the cloud to generate predictions. diff --git a/ultralytics-main/docs/en/hub/inference-api.md b/ultralytics-main/docs/en/hub/inference-api.md deleted file mode 100644 index 869d21f..0000000 --- a/ultralytics-main/docs/en/hub/inference-api.md +++ /dev/null @@ -1,480 +0,0 @@ ---- -comments: true -description: Access object detection capabilities of YOLOv8 via our RESTful API. Learn how to use the YOLO Inference API with Python or cURL for swift object detection. -keywords: Ultralytics, YOLOv8, Inference API, object detection, RESTful API, Python, cURL, Quickstart ---- - -# YOLO Inference API - -The YOLO Inference API allows you to access the YOLOv8 object detection capabilities via a RESTful API. This enables you to run object detection on images without the need to install and set up the YOLOv8 environment locally. - -![Inference API Screenshot](https://github.com/ultralytics/ultralytics/assets/19519529/a8c00e55-1590-403b-bdee-ed456c60af4d) Screenshot of the Inference API section in the trained model Preview tab. - -

-
- -
- Watch: Ultralytics HUB Inference API Walkthrough -

- -## API URL - -The API URL is the address used to access the YOLO Inference API. In this case, the base URL is: - -``` -https://api.ultralytics.com/v1/predict -``` - -## Example Usage in Python - -To access the YOLO Inference API with the specified model and API key using Python, you can use the following code: - -```python -import requests - -# API URL, use actual MODEL_ID -url = f"https://api.ultralytics.com/v1/predict/MODEL_ID" - -# Headers, use actual API_KEY -headers = {"x-api-key": "API_KEY"} - -# Inference arguments (optional) -data = {"size": 640, "confidence": 0.25, "iou": 0.45} - -# Load image and send request -with open("path/to/image.jpg", "rb") as image_file: - files = {"image": image_file} - response = requests.post(url, headers=headers, files=files, data=data) - -print(response.json()) -``` - -In this example, replace `API_KEY` with your actual API key, `MODEL_ID` with the desired model ID, and `path/to/image.jpg` with the path to the image you want to analyze. - -## Example Usage with cURL - -You can use the YOLO Inference API with client URL (cURL) by utilizing the `curl` command. Replace `API_KEY` with your actual API key, `MODEL_ID` with the desired model ID, and `image.jpg` with the path to the image you want to analyze: - -```bash -curl -X POST "https://api.ultralytics.com/v1/predict/MODEL_ID" \ - -H "x-api-key: API_KEY" \ - -F "image=@/path/to/image.jpg" \ - -F "size=640" \ - -F "confidence=0.25" \ - -F "iou=0.45" -``` - -## Passing Arguments - -This command sends a POST request to the YOLO Inference API with the specified `MODEL_ID` in the URL and the `API_KEY` in the request `headers`, along with the image file specified by `@path/to/image.jpg`. - -Here's an example of passing the `size`, `confidence`, and `iou` arguments via the API URL using the `requests` library in Python: - -```python -import requests - -# API URL, use actual MODEL_ID -url = f"https://api.ultralytics.com/v1/predict/MODEL_ID" - -# Headers, use actual API_KEY -headers = {"x-api-key": "API_KEY"} - -# Inference arguments (optional) -data = {"size": 640, "confidence": 0.25, "iou": 0.45} - -# Load image and send request -with open("path/to/image.jpg", "rb") as image_file: - files = {"image": image_file} - response = requests.post(url, headers=headers, files=files, data=data) - -print(response.json()) -``` - -In this example, the `data` dictionary contains the query arguments `size`, `confidence`, and `iou`, which tells the API to run inference at image size 640 with confidence and IoU thresholds of 0.25 and 0.45. - -This will send the query parameters along with the file in the POST request. See the table below for a full list of available inference arguments. - -| Inference Argument | Default | Type | Notes | -|--------------------|---------|---------|------------------------------------------------| -| `size` | `640` | `int` | valid range is `32` - `1280` pixels | -| `confidence` | `0.25` | `float` | valid range is `0.01` - `1.0` | -| `iou` | `0.45` | `float` | valid range is `0.0` - `0.95` | -| `url` | `''` | `str` | optional image URL if not image file is passed | -| `normalize` | `False` | `bool` | | - -## Return JSON format - -The YOLO Inference API returns a JSON list with the detection results. The format of the JSON list will be the same as the one produced locally by the `results[0].tojson()` command. - -The JSON list contains information about the detected objects, their coordinates, classes, and confidence scores. - -### Detect Model Format - -YOLO detection models, such as `yolov8n.pt`, can return JSON responses from local inference, cURL inference, and Python inference. All of these methods produce the same JSON response format. - -!!! Example "Detect Model JSON Response" - - === "`ultralytics`" - - ```python - from ultralytics import YOLO - - # Load model - model = YOLO('yolov8n.pt') - - # Run inference - results = model('image.jpg') - - # Print image.jpg results in JSON format - print(results[0].tojson()) - ``` - - === "cURL" - - ```bash - curl -X POST "https://api.ultralytics.com/v1/predict/MODEL_ID" \ - -H "x-api-key: API_KEY" \ - -F "image=@/path/to/image.jpg" \ - -F "size=640" \ - -F "confidence=0.25" \ - -F "iou=0.45" - ``` - - === "Python" - - ```python - import requests - - # API URL, use actual MODEL_ID - url = f"https://api.ultralytics.com/v1/predict/MODEL_ID" - - # Headers, use actual API_KEY - headers = {"x-api-key": "API_KEY"} - - # Inference arguments (optional) - data = {"size": 640, "confidence": 0.25, "iou": 0.45} - - # Load image and send request - with open("path/to/image.jpg", "rb") as image_file: - files = {"image": image_file} - response = requests.post(url, headers=headers, files=files, data=data) - - print(response.json()) - ``` - - === "JSON Response" - - ```json - { - "success": True, - "message": "Inference complete.", - "data": [ - { - "name": "person", - "class": 0, - "confidence": 0.8359682559967041, - "box": { - "x1": 0.08974208831787109, - "y1": 0.27418340047200523, - "x2": 0.8706787109375, - "y2": 0.9887352837456598 - } - }, - { - "name": "person", - "class": 0, - "confidence": 0.8189555406570435, - "box": { - "x1": 0.5847355842590332, - "y1": 0.05813225640190972, - "x2": 0.8930277824401855, - "y2": 0.9903111775716146 - } - }, - { - "name": "tie", - "class": 27, - "confidence": 0.2909725308418274, - "box": { - "x1": 0.3433395862579346, - "y1": 0.6070465511745877, - "x2": 0.40964522361755373, - "y2": 0.9849439832899306 - } - } - ] - } - ``` - -### Segment Model Format - -YOLO segmentation models, such as `yolov8n-seg.pt`, can return JSON responses from local inference, cURL inference, and Python inference. All of these methods produce the same JSON response format. - -!!! Example "Segment Model JSON Response" - - === "`ultralytics`" - - ```python - from ultralytics import YOLO - - # Load model - model = YOLO('yolov8n-seg.pt') - - # Run inference - results = model('image.jpg') - - # Print image.jpg results in JSON format - print(results[0].tojson()) - ``` - - === "cURL" - - ```bash - curl -X POST "https://api.ultralytics.com/v1/predict/MODEL_ID" \ - -H "x-api-key: API_KEY" \ - -F "image=@/path/to/image.jpg" \ - -F "size=640" \ - -F "confidence=0.25" \ - -F "iou=0.45" - ``` - - === "Python" - - ```python - import requests - - # API URL, use actual MODEL_ID - url = f"https://api.ultralytics.com/v1/predict/MODEL_ID" - - # Headers, use actual API_KEY - headers = {"x-api-key": "API_KEY"} - - # Inference arguments (optional) - data = {"size": 640, "confidence": 0.25, "iou": 0.45} - - # Load image and send request - with open("path/to/image.jpg", "rb") as image_file: - files = {"image": image_file} - response = requests.post(url, headers=headers, files=files, data=data) - - print(response.json()) - ``` - - === "JSON Response" - - Note `segments` `x` and `y` lengths may vary from one object to another. Larger or more complex objects may have more segment points. - ```json - { - "success": True, - "message": "Inference complete.", - "data": [ - { - "name": "person", - "class": 0, - "confidence": 0.856913149356842, - "box": { - "x1": 0.1064866065979004, - "y1": 0.2798851860894097, - "x2": 0.8738358497619629, - "y2": 0.9894873725043403 - }, - "segments": { - "x": [ - 0.421875, - 0.4203124940395355, - 0.41718751192092896 - ... - ], - "y": [ - 0.2888889014720917, - 0.2916666567325592, - 0.2916666567325592 - ... - ] - } - }, - { - "name": "person", - "class": 0, - "confidence": 0.8512625694274902, - "box": { - "x1": 0.5757311820983887, - "y1": 0.053943040635850696, - "x2": 0.8960096359252929, - "y2": 0.985154045952691 - }, - "segments": { - "x": [ - 0.7515624761581421, - 0.75, - 0.7437499761581421 - ... - ], - "y": [ - 0.0555555559694767, - 0.05833333358168602, - 0.05833333358168602 - ... - ] - } - }, - { - "name": "tie", - "class": 27, - "confidence": 0.6485961675643921, - "box": { - "x1": 0.33911995887756347, - "y1": 0.6057066175672743, - "x2": 0.4081430912017822, - "y2": 0.9916408962673611 - }, - "segments": { - "x": [ - 0.37187498807907104, - 0.37031251192092896, - 0.3687500059604645 - ... - ], - "y": [ - 0.6111111044883728, - 0.6138888597488403, - 0.6138888597488403 - ... - ] - } - } - ] - } - ``` - -### Pose Model Format - -YOLO pose models, such as `yolov8n-pose.pt`, can return JSON responses from local inference, cURL inference, and Python inference. All of these methods produce the same JSON response format. - -!!! Example "Pose Model JSON Response" - - === "`ultralytics`" - - ```python - from ultralytics import YOLO - - # Load model - model = YOLO('yolov8n-seg.pt') - - # Run inference - results = model('image.jpg') - - # Print image.jpg results in JSON format - print(results[0].tojson()) - ``` - - === "cURL" - - ```bash - curl -X POST "https://api.ultralytics.com/v1/predict/MODEL_ID" \ - -H "x-api-key: API_KEY" \ - -F "image=@/path/to/image.jpg" \ - -F "size=640" \ - -F "confidence=0.25" \ - -F "iou=0.45" - ``` - - === "Python" - - ```python - import requests - - # API URL, use actual MODEL_ID - url = f"https://api.ultralytics.com/v1/predict/MODEL_ID" - - # Headers, use actual API_KEY - headers = {"x-api-key": "API_KEY"} - - # Inference arguments (optional) - data = {"size": 640, "confidence": 0.25, "iou": 0.45} - - # Load image and send request - with open("path/to/image.jpg", "rb") as image_file: - files = {"image": image_file} - response = requests.post(url, headers=headers, files=files, data=data) - - print(response.json()) - ``` - - === "JSON Response" - - Note COCO-keypoints pretrained models will have 17 human keypoints. The `visible` part of the keypoints indicates whether a keypoint is visible or obscured. Obscured keypoints may be outside the image or may not be visible, i.e. a person's eyes facing away from the camera. - ```json - { - "success": True, - "message": "Inference complete.", - "data": [ - { - "name": "person", - "class": 0, - "confidence": 0.8439509868621826, - "box": { - "x1": 0.1125, - "y1": 0.28194444444444444, - "x2": 0.7953125, - "y2": 0.9902777777777778 - }, - "keypoints": { - "x": [ - 0.5058594942092896, - 0.5103894472122192, - 0.4920862317085266 - ... - ], - "y": [ - 0.48964157700538635, - 0.4643048942089081, - 0.4465252459049225 - ... - ], - "visible": [ - 0.8726999163627625, - 0.653947651386261, - 0.9130823612213135 - ... - ] - } - }, - { - "name": "person", - "class": 0, - "confidence": 0.7474289536476135, - "box": { - "x1": 0.58125, - "y1": 0.0625, - "x2": 0.8859375, - "y2": 0.9888888888888889 - }, - "keypoints": { - "x": [ - 0.778544008731842, - 0.7976160049438477, - 0.7530890107154846 - ... - ], - "y": [ - 0.27595141530036926, - 0.2378823608160019, - 0.23644638061523438 - ... - ], - "visible": [ - 0.8900790810585022, - 0.789978563785553, - 0.8974530100822449 - ... - ] - } - } - ] - } - ``` diff --git a/ultralytics-main/docs/en/hub/integrations.md b/ultralytics-main/docs/en/hub/integrations.md deleted file mode 100644 index a69da48..0000000 --- a/ultralytics-main/docs/en/hub/integrations.md +++ /dev/null @@ -1,62 +0,0 @@ ---- -comments: true -description: Explore integration options for Ultralytics HUB. Currently featuring Roboflow for dataset integration and multiple export formats for your trained models. -keywords: Ultralytics HUB, Integrations, Roboflow, Dataset, Export, YOLOv5, YOLOv8, ONNX, CoreML, TensorRT, TensorFlow ---- - -# HUB Integrations - -🚧 **Under Construction** 🚧 - -Welcome to the Integrations guide for [Ultralytics HUB](https://hub.ultralytics.com/)! We are in the process of expanding this section to provide you with comprehensive guidance on integrating your YOLOv5 and YOLOv8 models with various platforms and formats. Currently, Roboflow is our available dataset integration, with a wide range of export integrations for your trained models. - -

-
- -
- Watch: Train Your Custom YOLO Models In A Few Clicks with Ultralytics HUB. -

- -## Available Integrations - -### Dataset Integrations - -- **Roboflow**: Seamlessly import your datasets for training. - -### Export Integrations - -| Format | `format` Argument | Model | Metadata | Arguments | -|--------------------------------------------------------------------|-------------------|---------------------------|----------|-----------------------------------------------------| -| [PyTorch](https://pytorch.org/) | - | `yolov8n.pt` | ✅ | - | -| [TorchScript](https://pytorch.org/docs/stable/jit.html) | `torchscript` | `yolov8n.torchscript` | ✅ | `imgsz`, `optimize` | -| [ONNX](https://onnx.ai/) | `onnx` | `yolov8n.onnx` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `opset` | -| [OpenVINO](../integrations/openvino.md) | `openvino` | `yolov8n_openvino_model/` | ✅ | `imgsz`, `half`, `int8` | -| [TensorRT](https://developer.nvidia.com/tensorrt) | `engine` | `yolov8n.engine` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `workspace` | -| [CoreML](https://github.com/apple/coremltools) | `coreml` | `yolov8n.mlpackage` | ✅ | `imgsz`, `half`, `int8`, `nms` | -| [TF SavedModel](https://www.tensorflow.org/guide/saved_model) | `saved_model` | `yolov8n_saved_model/` | ✅ | `imgsz`, `keras`, `int8` | -| [TF GraphDef](https://www.tensorflow.org/api_docs/python/tf/Graph) | `pb` | `yolov8n.pb` | ❌ | `imgsz` | -| [TF Lite](https://www.tensorflow.org/lite) | `tflite` | `yolov8n.tflite` | ✅ | `imgsz`, `half`, `int8` | -| [TF Edge TPU](https://coral.ai/docs/edgetpu/models-intro/) | `edgetpu` | `yolov8n_edgetpu.tflite` | ✅ | `imgsz` | -| [TF.js](https://www.tensorflow.org/js) | `tfjs` | `yolov8n_web_model/` | ✅ | `imgsz`, `half`, `int8` | -| [PaddlePaddle](https://github.com/PaddlePaddle) | `paddle` | `yolov8n_paddle_model/` | ✅ | `imgsz` | -| [NCNN](https://github.com/Tencent/ncnn) | `ncnn` | `yolov8n_ncnn_model/` | ✅ | `imgsz`, `half` | - -## Coming Soon - -- Additional Dataset Integrations -- Detailed Export Integration Guides -- Step-by-Step Tutorials for Each Integration - -## Need Immediate Assistance? - -While we're in the process of creating detailed guides: - -- Browse through other [HUB Docs](https://docs.ultralytics.com/hub/) for detailed guides and tutorials. -- Raise an issue on our [GitHub](https://github.com/ultralytics/hub/) for technical support. -- Join our [Discord Community](https://ultralytics.com/discord/) for live discussions and community support. - -We appreciate your patience as we work to make this section comprehensive and user-friendly. Stay tuned for updates! diff --git a/ultralytics-main/docs/en/hub/models.md b/ultralytics-main/docs/en/hub/models.md deleted file mode 100644 index 6a4bc3e..0000000 --- a/ultralytics-main/docs/en/hub/models.md +++ /dev/null @@ -1,130 +0,0 @@ ---- -comments: true -description: Learn how to efficiently train AI models using Ultralytics HUB, a streamlined solution for model creation, training, evaluation, and deployment. -keywords: Ultralytics, HUB Models, AI model training, model creation, model training, model evaluation, model deployment ---- - -# Ultralytics HUB Models - -[Ultralytics HUB](https://hub.ultralytics.com/) models provide a streamlined solution for training vision AI models on custom datasets. - -The process is user-friendly and efficient, involving a simple three-step creation and accelerated training powered by Ultralytics YOLOv8. Real-time updates on model metrics are available during training, allowing users to monitor progress at each step. Once training is completed, models can be previewed and easily deployed to real-world applications. Therefore, Ultralytics HUB offers a comprehensive yet straightforward system for model creation, training, evaluation, and deployment. - -The entire process of training a model is detailed on our [Cloud Training Page](cloud-training.md). - -![Preview of the Models](https://github.com/ultralytics/ultralytics/assets/19519529/a02e1441-f5f6-4935-ad75-ec18e425d8bd) - -## Train Model - -Navigate to the [Models](https://hub.ultralytics.com/models) page by clicking on the **Models** button in the sidebar. - -Training a model using HUB is a 4-step process: - -- **Execute the pre-requisites script**: Run the provided scripts to prepare the virtual environment. -- **Provide the API and start Training**: Once the model is prepared, provide the API key as instructed and execute the code block. -- **Check the results and Metrics**: Upon successful execution, a link is provided to the Metrics Page. This page offers comprehensive details on the trained model, including specifications, loss metrics, dataset information, and image distributions. Additionally, the 'Deploy' tab provides access to the trained model's documentation and license details. -- **Test your model**: Ultralytics HUB offers testing using custom images, device cameras, or links to test on `iPhone` or `Android` devices. - -![Ultralytics HUB screenshot of the Home page](https://github.com/ultralytics/ultralytics/assets/19519529/61428720-aa93-4689-b209-ead7f06fa488) - -!!! tip "Tip" - - You can also train a model directly from the [Home](https://hub.ultralytics.com/home) page. - - ![Ultralytics HUB screenshot of the Home page with an arrow pointing to the Train Model card](https://github.com/ultralytics/ultralytics/assets/19519529/6f9f06f7-e663-4fa7-800c-98675bf1405b) - -Click on the **Train Model** button on the top right of the page to trigger the **Train Model** dialog. - -The **Train Model** dialog has three simple steps: - -### 1. Dataset - -Select the dataset for training and click **Continue**. - -![Ultralytics HUB screenshot of the Train Model dialog with an arrow pointing to a dataset and one to the Continue button](https://github.com/ultralytics/ultralytics/assets/19519529/7ff90f2a-c61e-472f-a573-f725a5bddc1c) - -### 2. Model - -Choose the project, model name, and architecture. Read more about available architectures in our [YOLOv8](https://docs.ultralytics.com/models/yolov8) (and [YOLOv5](https://docs.ultralytics.com/models/yolov5)) documentation. - -Click **Continue** when satisfied with the configuration. - -![Ultralytics HUB screenshot of the Train Model dialog with an arrow pointing to a model architecture and one to the Continue button](https://github.com/ultralytics/ultralytics/assets/19519529/a7a412b3-3e87-48de-b117-c506338f36fb) - -!!! note "Note" - - By default, your model will use a pre-trained model (trained on the [COCO](https://docs.ultralytics.com/datasets/detect/coco) dataset) to reduce training time. - - Advanced options are available to modify this behavior. - -## Preview Model - -Ultralytics HUB offers various ways to preview trained models. - -You can upload an image in the **Test** card under the **Preview** tab to preview your model. - -![Ultralytics HUB screenshot of the Preview tab (Test card) inside the Model page](https://github.com/ultralytics/ultralytics/assets/19519529/a732d13a-8da9-40a8-9f5e-c766bec3fbe9) - -Use our Ultralytics Cloud API to effortlessly [run inference](inference-api.md) with your custom model. - -![Ultralytics HUB screenshot of the Preview tab (Ultralytics Cloud API card) inside the Model page](https://github.com/ultralytics/ultralytics/assets/19519529/77ae0f6c-d89e-433c-b404-77f71c06def5) - -Preview your model in real-time on your [iOS](https://apps.apple.com/xk/app/ultralytics/id1583935240) or [Android](https://play.google.com/store/apps/details?id=com.ultralytics.ultralytics_app) device by [downloading](https://ultralytics.com/app_install) our [Ultralytics HUB Mobile Application](app/index.md). - -![Ultralytics HUB screenshot of the Deploy tab inside the Model page with an arrow pointing to the Real-Time Preview card](https://github.com/ultralytics/ultralytics/assets/19519529/8d711052-5ab1-43bc-bc25-a8802a24b301) - -## Train the model - -Ultralytics HUB offers three training options: - -- **Ultralytics Cloud** - Learn more about training via the Ultralytics [Cloud Training Page](cloud-training.md) -- **Google Colab** -- **Bring your own agent** - -## Training the Model on Google Colab - -To start training using Google Colab, follow the instructions on the Google Colab notebook. - - - Open In Colab - - -![Google Colab Screenshot](https://github.com/ultralytics/ultralytics/assets/19519529/f19d2e04-d33c-446b-91f9-80396e02b68f) - -## Bring your own Agent - -Create an API endpoint through Ultralytics HUB to train the Model locally. Follow the provided steps, and access training details via the link generated on the Agent terminal. - -![Bring your own agent screenshot](https://github.com/ultralytics/ultralytics/assets/19519529/7d8dcd7a-19ec-4ada-87bf-1a1ba1d01ceb) - -## Deploy Model - -Export your model to 13 different formats, including ONNX, OpenVINO, CoreML, TensorFlow, Paddle, and more. - -![Ultralytics HUB screenshot of the Deploy tab inside the Model page with all formats exported](https://github.com/ultralytics/ultralytics/assets/19519529/083a929d-2bbd-45f8-9dec-2767949caaba) - -## Share Model - -Ultralytics HUB's sharing functionality provides a convenient way to share models. Control the general access of your models, setting them to "Private" or "Unlisted". - -Navigate to the Model page, open the model actions dropdown, and click on the **Share** option. - -![Ultralytics HUB screenshot of the Model page with an arrow pointing to the Share option](https://github.com/ultralytics/ultralytics/assets/19519529/ac98724e-9267-4557-a792-33073c47bbff) - -Set the general access and click **Save**. - -![Ultralytics HUB screenshot of the Share Model dialog with an arrow pointing to the dropdown and one to the Save button](https://github.com/ultralytics/ultralytics/assets/19519529/65afcd99-1f9e-4be8-b287-096a7c74fc0e) - -Now, anyone with the direct link can view your model. - -!!! tip "Tip" - - Easily copy the model's link shown in the **Share Model** dialog by clicking on it. - - ![Ultralytics HUB screenshot of the Share Model dialog with an arrow pointing to the model's link](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/models/hub_share_model_4.jpg) - -## Edit and Delete Model - -Navigate to the Model page, open the model actions dropdown, and click on the **Edit** option to update the model. To delete the model, select the **Delete** option. - -![Ultralytics HUB screenshot of the Model page with an arrow pointing to the Edit option](https://github.com/ultralytics/ultralytics/assets/19519529/5c2db731-45dc-4f04-ac0f-9ad600c140a1) diff --git a/ultralytics-main/docs/en/hub/on-premise/index.md b/ultralytics-main/docs/en/hub/on-premise/index.md deleted file mode 100644 index f8d7802..0000000 --- a/ultralytics-main/docs/en/hub/on-premise/index.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -description: Discover what's next for Ultralytics with our under-construction page, previewing new, groundbreaking AI and ML features coming soon. -keywords: Ultralytics, coming soon, under construction, new features, AI updates, ML advancements, YOLO, technology preview ---- - -# Under Construction 🏗️🌟 - -Welcome to the Ultralytics "Under Construction" page! Here, we're hard at work developing the next generation of AI and ML innovations. This page serves as a teaser for the exciting updates and new features we're eager to share with you! - -## Exciting New Features on the Way 🎉 - -- **Innovative Breakthroughs:** Get ready for advanced features and services that will transform your AI and ML experience. -- **New Horizons:** Anticipate novel products that redefine AI and ML capabilities. -- **Enhanced Services:** We're upgrading our services for greater efficiency and user-friendliness. - -## Stay Updated 🚧 - -This placeholder page is your first stop for upcoming developments. Keep an eye out for: - -- **Newsletter:** Subscribe [here](https://ultralytics.com/#newsletter) for the latest news. -- **Social Media:** Follow us [here](https://www.linkedin.com/company/ultralytics) for updates and teasers. -- **Blog:** Visit our [blog](https://ultralytics.com/blog) for detailed insights. - -## We Value Your Input 🗣️ - -Your feedback shapes our future releases. Share your thoughts and suggestions [here](https://ultralytics.com/contact). - -## Thank You, Community! 🌍 - -Your [contributions](https://docs.ultralytics.com/help/contributing) inspire our continuous [innovation](https://github.com/ultralytics/ultralytics). Stay tuned for the big reveal of what's next in AI and ML at Ultralytics! - ---- - -Excited for what's coming? Bookmark this page and get ready for a transformative AI and ML journey with Ultralytics! 🛠️🤖 diff --git a/ultralytics-main/docs/en/hub/projects.md b/ultralytics-main/docs/en/hub/projects.md deleted file mode 100644 index a512331..0000000 --- a/ultralytics-main/docs/en/hub/projects.md +++ /dev/null @@ -1,180 +0,0 @@ ---- -comments: true -description: Learn how to manage Ultralytics HUB projects. Understand effective strategies to create, share, edit, delete, and compare models in an organized workspace. -keywords: Ultralytics, HUB projects, Create project, Edit project, Share project, Delete project, Compare Models, Model Management ---- - -# Ultralytics HUB Projects - -[Ultralytics HUB](https://hub.ultralytics.com/) projects provide an effective solution for consolidating and managing your models. If you are working with several models that perform similar tasks or have related purposes, Ultralytics HUB projects allow you to group these models together. - -This creates a unified and organized workspace that facilitates easier model management, comparison and development. Having similar models or various iterations together can facilitate rapid benchmarking, as you can compare their effectiveness. This can lead to faster, more insightful iterative development and refinement of your models. - -

-
- -
- Watch: Train YOLOv8 Pose Model on Tiger-Pose Dataset Using Ultralytics HUB -

- -## Create Project - -Navigate to the [Projects](https://hub.ultralytics.com/projects) page by clicking on the **Projects** button in the sidebar. - -![Ultralytics HUB screenshot of the Home page with an arrow pointing to the Projects button in the sidebar](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_create_project_1.jpg) - -??? tip "Tip" - - You can also create a project directly from the [Home](https://hub.ultralytics.com/home) page. - - ![Ultralytics HUB screenshot of the Home page with an arrow pointing to the Create Project card](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_create_project_2.jpg) - -Click on the **Create Project** button on the top right of the page. This action will trigger the **Create Project** dialog, opening up a suite of options for tailoring your project to your needs. - -![Ultralytics HUB screenshot of the Projects page with an arrow pointing to the Create Project button](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_create_project_3.jpg) - -Type the name of your project in the _Project name_ field or keep the default name and finalize the project creation with a single click. - -You have the additional option to enrich your project with a description and a unique image, enhancing its recognizability on the Projects page. - -When you're happy with your project configuration, click **Create**. - -![Ultralytics HUB screenshot of the Create Project dialog with an arrow pointing to the Create button](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_create_project_4.jpg) - -After your project is created, you will be able to access it from the Projects page. - -![Ultralytics HUB screenshot of the Projects page with an arrow pointing to one of the projects](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_create_project_5.jpg) - -Next, [train a model](https://docs.ultralytics.com/hub/models/#train-model) inside your project. - -![Ultralytics HUB screenshot of the Project page with an arrow pointing to the Train Model button](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_create_project_6.jpg) - -## Share Project - -!!! Info "Info" - - Ultralytics HUB's sharing functionality provides a convenient way to share projects with others. This feature is designed to accommodate both existing Ultralytics HUB users and those who have yet to create an account. - -??? note "Note" - - You have control over the general access of your projects. - - You can choose to set the general access to "Private", in which case, only you will have access to it. Alternatively, you can set the general access to "Unlisted" which grants viewing access to anyone who has the direct link to the project, regardless of whether they have an Ultralytics HUB account or not. - -Navigate to the Project page of the project you want to share, open the project actions dropdown and click on the **Share** option. This action will trigger the **Share Project** dialog. - -![Ultralytics HUB screenshot of the Project page with an arrow pointing to the Share option](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_share_project_1.jpg) - -??? tip "Tip" - - You can also share a project directly from the [Projects](https://hub.ultralytics.com/projects) page. - - ![Ultralytics HUB screenshot of the Projects page with an arrow pointing to the Share option of one of the projects](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_share_project_2.jpg) - -Set the general access to "Unlisted" and click **Save**. - -![Ultralytics HUB screenshot of the Share Project dialog with an arrow pointing to the dropdown and one to the Save button](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_share_project_3.jpg) - -!!! Warning "Warning" - - When changing the general access of a project, the general access of the models inside the project will be changed as well. - -Now, anyone who has the direct link to your project can view it. - -??? tip "Tip" - - You can easily click on the project's link shown in the **Share Project** dialog to copy it. - - ![Ultralytics HUB screenshot of the Share Project dialog with an arrow pointing to the project's link](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_share_project_4.jpg) - -## Edit Project - -Navigate to the Project page of the project you want to edit, open the project actions dropdown and click on the **Edit** option. This action will trigger the **Update Project** dialog. - -![Ultralytics HUB screenshot of the Project page with an arrow pointing to the Edit option](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_edit_project_1.jpg) - -??? tip "Tip" - - You can also edit a project directly from the [Projects](https://hub.ultralytics.com/projects) page. - - ![Ultralytics HUB screenshot of the Projects page with an arrow pointing to the Edit option of one of the projects](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_edit_project_2.jpg) - -Apply the desired modifications to your project and then confirm the changes by clicking **Save**. - -![Ultralytics HUB screenshot of the Update Project dialog with an arrow pointing to the Save button](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_edit_project_3.jpg) - -## Delete Project - -Navigate to the Project page of the project you want to delete, open the project actions dropdown and click on the **Delete** option. This action will delete the project. - -![Ultralytics HUB screenshot of the Project page with an arrow pointing to the Delete option](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_delete_project_1.jpg) - -??? tip "Tip" - - You can also delete a project directly from the [Projects](https://hub.ultralytics.com/projects) page. - - ![Ultralytics HUB screenshot of the Projects page with an arrow pointing to the Delete option of one of the projects](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_delete_project_2.jpg) - -!!! Warning "Warning" - - When deleting a project, the models inside the project will be deleted as well. - -??? note "Note" - - If you change your mind, you can restore the project from the [Trash](https://hub.ultralytics.com/trash) page. - - ![Ultralytics HUB screenshot of the Trash page with an arrow pointing to the Restore option of one of the projects](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_delete_project_3.jpg) - -## Compare Models - -Navigate to the Project page of the project where the models you want to compare are located. To use the model comparison feature, click on the **Charts** tab. - -![Ultralytics HUB screenshot of the Project page with an arrow pointing to the Charts tab](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_compare_models_1.jpg) - -This will display all the relevant charts. Each chart corresponds to a different metric and contains the performance of each model for that metric. The models are represented by different colors, and you can hover over each data point to get more information. - -![Ultralytics HUB screenshot of the Charts tab inside the Project page](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_compare_models_2.jpg) - -??? tip "Tip" - - Each chart can be enlarged for better visualization. - - ![Ultralytics HUB screenshot of the Charts tab inside the Project page with an arrow pointing to the expand icon](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_compare_models_3.jpg) - - ![Ultralytics HUB screenshot of the Charts tab inside the Project page with one of the charts expanded](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_compare_models_4.jpg) - -??? tip "Tip" - - You have the flexibility to customize your view by selectively hiding certain models. This feature allows you to concentrate on the models of interest. - - ![Ultralytics HUB screenshot of the Charts tab inside the Project page with an arrow pointing to the hide/unhide icon of one of the model](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_compare_models_5.jpg) - -## Reorder Models - -??? note "Note" - - Ultralytics HUB's reordering functionality works only inside projects you own. - -Navigate to the Project page of the project where the models you want to reorder are located. Click on the designated reorder icon of the model you want to move and drag it to the desired location. - -![Ultralytics HUB screenshot of the Project page with an arrow pointing to the reorder icon](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_reorder_models_1.jpg) - -## Transfer Models - -Navigate to the Project page of the project where the model you want to mode is located, open the project actions dropdown and click on the **Transfer** option. This action will trigger the **Transfer Model** dialog. - -![Ultralytics HUB screenshot of the Project page with an arrow pointing to the Transfer option of one of the models](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_transfer_models_1.jpg) - -??? tip "Tip" - - You can also transfer a model directly from the [Models](https://hub.ultralytics.com/models) page. - - ![Ultralytics HUB screenshot of the Models page with an arrow pointing to the Transfer option of one of the models](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_transfer_models_2.jpg) - -Select the project you want to transfer the model to and click **Save**. - -![Ultralytics HUB screenshot of the Transfer Model dialog with an arrow pointing to the dropdown and one to the Save button](https://raw.githubusercontent.com/ultralytics/assets/main/docs/hub/projects/hub_transfer_models_3.jpg) diff --git a/ultralytics-main/docs/en/hub/quickstart.md b/ultralytics-main/docs/en/hub/quickstart.md deleted file mode 100644 index 7f7253a..0000000 --- a/ultralytics-main/docs/en/hub/quickstart.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -comments: true -description: Kickstart your journey with Ultralytics HUB. Learn how to train and deploy YOLOv5 and YOLOv8 models in seconds with our Quickstart guide. -keywords: Ultralytics HUB, Quickstart, YOLOv5, YOLOv8, model training, quick deployment, drag-and-drop interface, real-time object detection ---- - -# Quickstart Guide for Ultralytics HUB - -HUB is designed to be user-friendly and intuitive, with a drag-and-drop interface that allows users to easily upload their data and train new models quickly. It offers a range of pre-trained models and templates to choose from, making it easy for users to get started with training their own models. Once a model is trained, it can be easily deployed and used for real-time object detection, instance segmentation and classification tasks. - -

-
- -
- Watch: Train Your Custom YOLO Models In A Few Clicks with Ultralytics HUB. -

- -## Creating an Account - -[Ultralytics HUB](https://hub.ultralytics.com/) offers multiple easy account creation options. Users can register and sign in using Google, Apple, GitHub accounts, or a work email address. - -![Creating an Account](https://github.com/ultralytics/ultralytics/assets/19519529/1dcf454a-68ab-4821-9779-ee33a6e300cf) - -## The Dashboard - -Upon logging in, users are directed to the HUB dashboard, providing a comprehensive overview. The left pane conveniently offers links for tasks such as Uploading Datasets, Creating Projects, Training Models, Integrating Third-party Applications, Accessing Support, and Managing Trash. - -![HUB Dashboard](https://github.com/ultralytics/ultralytics/assets/19519529/108de60e-1b21-4f07-8d46-ed51d8439f67) - -## Selecting the Model - -Choose a Dataset and train the model by selecting the Project name, Model name, and Architecture. Ultralytics offers a range of YOLOv8, YOLOv5, and YOLOv5u6 Architectures, including pre-trained and custom options. - -Read more about Models on the [HUB Models page](models.md). - -## Training the Model - -There are three ways to train your model: using Google Colab, training locally, or through Ultralytics Cloud. Learn more about training options on the [Cloud Training Page](cloud-training.md). - -## Integrating the Model - -Integrate your trained model with third-party applications or connect HUB from an external agent. Ultralytics HUB currently supports simple one-click API Integration with Roboflow. Read more about integration on the [Integration Page](integrations.md). - -## Need Help? - -If you encounter any issues or have questions, we're here to assist you. You can report a bug, request a feature, or ask a question. - -![Support Page](https://github.com/ultralytics/ultralytics/assets/19519529/c29bf5c5-72d8-4be4-9f3f-b504968d0bef) - -## Data Management - -Manage your datasets efficiently with options to restore or permanently delete them from the Trash section in the left column. - -![Trash Page](https://github.com/ultralytics/ultralytics/assets/19519529/c3d46107-aa58-4b05-a7a8-44db1ad61bb2) diff --git a/ultralytics-main/docs/en/index.md b/ultralytics-main/docs/en/index.md deleted file mode 100644 index 484f51b..0000000 --- a/ultralytics-main/docs/en/index.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -comments: true -description: Explore a complete guide to Ultralytics YOLOv8, a high-speed, high-accuracy object detection & image segmentation model. Installation, prediction, training tutorials and more. -keywords: Ultralytics, YOLOv8, object detection, image segmentation, machine learning, deep learning, computer vision, YOLOv8 installation, YOLOv8 prediction, YOLOv8 training, YOLO history, YOLO licenses ---- - -
-

- - Ultralytics YOLO banner -

- Ultralytics GitHub - space - Ultralytics LinkedIn - space - Ultralytics Twitter - space - Ultralytics YouTube - space - Ultralytics TikTok - space - Ultralytics Instagram - space - Ultralytics Discord -
-
- Ultralytics CI - Ultralytics Code Coverage - YOLOv8 Citation - Docker Pulls - Discord -
- Run on Gradient - Open In Colab - Open In Kaggle -
- -Introducing [Ultralytics](https://ultralytics.com) [YOLOv8](https://github.com/ultralytics/ultralytics), the latest version of the acclaimed real-time object detection and image segmentation model. YOLOv8 is built on cutting-edge advancements in deep learning and computer vision, offering unparalleled performance in terms of speed and accuracy. Its streamlined design makes it suitable for various applications and easily adaptable to different hardware platforms, from edge devices to cloud APIs. - -Explore the YOLOv8 Docs, a comprehensive resource designed to help you understand and utilize its features and capabilities. Whether you are a seasoned machine learning practitioner or new to the field, this hub aims to maximize YOLOv8's potential in your projects - -## Where to Start - -- **Install** `ultralytics` with pip and get up and running in minutes   [:material-clock-fast: Get Started](quickstart.md){ .md-button } -- **Predict** new images and videos with YOLOv8   [:octicons-image-16: Predict on Images](modes/predict.md){ .md-button } -- **Train** a new YOLOv8 model on your own custom dataset   [:fontawesome-solid-brain: Train a Model](modes/train.md){ .md-button } -- **Tasks** YOLOv8 tasks like segment, classify, pose and track   [:material-magnify-expand: Explore Tasks](tasks/index.md){ .md-button } -- **NEW 🚀 Explore** datasets with advanced semantic and SQL search   [:material-magnify-expand: Explore a Dataset](datasets/explorer/index.md){ .md-button } - -

-
- -
- Watch: How to Train a YOLOv8 model on Your Custom Dataset in Google Colab. -

- -## YOLO: A Brief History - -[YOLO](https://arxiv.org/abs/1506.02640) (You Only Look Once), a popular object detection and image segmentation model, was developed by Joseph Redmon and Ali Farhadi at the University of Washington. Launched in 2015, YOLO quickly gained popularity for its high speed and accuracy. - -- [YOLOv2](https://arxiv.org/abs/1612.08242), released in 2016, improved the original model by incorporating batch normalization, anchor boxes, and dimension clusters. -- [YOLOv3](https://pjreddie.com/media/files/papers/YOLOv3.pdf), launched in 2018, further enhanced the model's performance using a more efficient backbone network, multiple anchors and spatial pyramid pooling. -- [YOLOv4](https://arxiv.org/abs/2004.10934) was released in 2020, introducing innovations like Mosaic data augmentation, a new anchor-free detection head, and a new loss function. -- [YOLOv5](https://github.com/ultralytics/yolov5) further improved the model's performance and added new features such as hyperparameter optimization, integrated experiment tracking and automatic export to popular export formats. -- [YOLOv6](https://github.com/meituan/YOLOv6) was open-sourced by [Meituan](https://about.meituan.com/) in 2022 and is in use in many of the company's autonomous delivery robots. -- [YOLOv7](https://github.com/WongKinYiu/yolov7) added additional tasks such as pose estimation on the COCO keypoints dataset. -- [YOLOv8](https://github.com/ultralytics/ultralytics) is the latest version of YOLO by Ultralytics. As a cutting-edge, state-of-the-art (SOTA) model, YOLOv8 builds on the success of previous versions, introducing new features and improvements for enhanced performance, flexibility, and efficiency. YOLOv8 supports a full range of vision AI tasks, including [detection](tasks/detect.md), [segmentation](tasks/segment.md), [pose estimation](tasks/pose.md), [tracking](modes/track.md), and [classification](tasks/classify.md). This versatility allows users to leverage YOLOv8's capabilities across diverse applications and domains. -- [YOLOv9](models/yolov9.md) Introduces innovative methods like Programmable Gradient Information (PGI) and the Generalized Efficient Layer Aggregation Network (GELAN). - -## YOLO Licenses: How is Ultralytics YOLO licensed? - -Ultralytics offers two licensing options to accommodate diverse use cases: - -- **AGPL-3.0 License**: This [OSI-approved](https://opensource.org/licenses/) open-source license is ideal for students and enthusiasts, promoting open collaboration and knowledge sharing. See the [LICENSE](https://github.com/ultralytics/ultralytics/blob/main/LICENSE) file for more details. -- **Enterprise License**: Designed for commercial use, this license permits seamless integration of Ultralytics software and AI models into commercial goods and services, bypassing the open-source requirements of AGPL-3.0. If your scenario involves embedding our solutions into a commercial offering, reach out through [Ultralytics Licensing](https://ultralytics.com/license). - -Our licensing strategy is designed to ensure that any improvements to our open-source projects are returned to the community. We hold the principles of open source close to our hearts ❤️, and our mission is to guarantee that our contributions can be utilized and expanded upon in ways that are beneficial to all. diff --git a/ultralytics-main/docs/en/integrations/amazon-sagemaker.md b/ultralytics-main/docs/en/integrations/amazon-sagemaker.md deleted file mode 100644 index f57fc2e..0000000 --- a/ultralytics-main/docs/en/integrations/amazon-sagemaker.md +++ /dev/null @@ -1,169 +0,0 @@ ---- -comments: true -Description: Learn how to deploy YOLOv8 models on Amazon SageMaker Endpoints. This guide covers the essentials of AWS environment setup, model preparation, and deployment using AWS CloudFormation and the AWS Cloud Development Kit (CDK). -keywords: YOLOv8, Ultralytics, Amazon SageMaker, AWS, CloudFormation, AWS CDK, PyTorch, Model Deployment, Machine Learning, Computer Vision ---- - -# A Guide to Deploying YOLOv8 on Amazon SageMaker Endpoints - -Deploying advanced computer vision models like [Ultralytics’ YOLOv8](https://github.com/ultralytics/ultralytics) on Amazon SageMaker Endpoints opens up a wide range of possibilities for various machine learning applications. The key to effectively using these models lies in understanding their setup, configuration, and deployment processes. YOLOv8 becomes even more powerful when integrated seamlessly with Amazon SageMaker, a robust and scalable machine learning service by AWS. - -This guide will take you through the process of deploying YOLOv8 PyTorch models on Amazon SageMaker Endpoints step by step. You'll learn the essentials of preparing your AWS environment, configuring the model appropriately, and using tools like AWS CloudFormation and the AWS Cloud Development Kit (CDK) for deployment. - -## Amazon SageMaker - -

- Amazon SageMaker Overview -

- -[Amazon SageMaker](https://aws.amazon.com/sagemaker/) is a machine learning service from Amazon Web Services (AWS) that simplifies the process of building, training, and deploying machine learning models. It provides a broad range of tools for handling various aspects of machine learning workflows. This includes automated features for tuning models, options for training models at scale, and straightforward methods for deploying models into production. SageMaker supports popular machine learning frameworks, offering the flexibility needed for diverse projects. Its features also cover data labeling, workflow management, and performance analysis. - -## Deploying YOLOv8 on Amazon SageMaker Endpoints - -Deploying YOLOv8 on Amazon SageMaker lets you use its managed environment for real-time inference and take advantage of features like autoscaling. Take a look at the AWS architecture below. - -

- AWS Architecture -

- -### Step 1: Setup Your AWS Environment - -First, ensure you have the following prerequisites in place: - -- An AWS Account: If you don't already have one, sign up for an AWS account. - -- Configured IAM Roles: You’ll need an IAM role with the necessary permissions for Amazon SageMaker, AWS CloudFormation, and Amazon S3. This role should have policies that allow it to access these services. - -- AWS CLI: If not already installed, download and install the AWS Command Line Interface (CLI) and configure it with your account details. Follow [the AWS CLI instructions](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) for installation. - -- AWS CDK: If not already installed, install the AWS Cloud Development Kit (CDK), which will be used for scripting the deployment. Follow [the AWS CDK instructions](https://docs.aws.amazon.com/cdk/v2/guide/getting_started.html#getting_started_install) for installation. - -- Adequate Service Quota: Confirm that you have sufficient quotas for two separate resources in Amazon SageMaker: one for `ml.m5.4xlarge` for endpoint usage and another for `ml.m5.4xlarge` for notebook instance usage. Each of these requires a minimum of one quota value. If your current quotas are below this requirement, it's important to request an increase for each. You can request a quota increase by following the detailed instructions in the [AWS Service Quotas documentation](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html#quota-console-increase). - -### Step 2: Clone the YOLOv8 SageMaker Repository - -The next step is to clone the specific AWS repository that contains the resources for deploying YOLOv8 on SageMaker. This repository, hosted on GitHub, includes the necessary CDK scripts and configuration files. - -- Clone the GitHub Repository: Execute the following command in your terminal to clone the host-yolov8-on-sagemaker-endpoint repository: - -```bash -git clone https://github.com/aws-samples/host-yolov8-on-sagemaker-endpoint.git -``` - -- Navigate to the Cloned Directory: Change your directory to the cloned repository: - -```bash -cd host-yolov8-on-sagemaker-endpoint/yolov8-pytorch-cdk -``` - -### Step 3: Set Up the CDK Environment - -Now that you have the necessary code, set up your environment for deploying with AWS CDK. - -- Create a Python Virtual Environment: This isolates your Python environment and dependencies. Run: - -```bash -python3 -m venv .venv -``` - -- Activate the Virtual Environment: - -```bash -source .venv/bin/activate -``` - -- Install Dependencies: Install the required Python dependencies for the project: - -```bash -pip3 install -r requirements.txt -``` - -- Upgrade AWS CDK Library: Ensure you have the latest version of the AWS CDK library: - -```bash -pip install --upgrade aws-cdk-lib -``` - -### Step 4: Create the AWS CloudFormation Stack - -- Synthesize the CDK Application: Generate the AWS CloudFormation template from your CDK code: - -```bash -cdk synth -``` - -- Bootstrap the CDK Application: Prepare your AWS environment for CDK deployment: - -```bash -cdk bootstrap -``` - -- Deploy the Stack: This will create the necessary AWS resources and deploy your model: - -```bash -cdk deploy -``` - -### Step 5: Deploy the YOLOv8 Model - -Before diving into the deployment instructions, be sure to check out the range of [YOLOv8 models offered by Ultralytics](../models/index.md). This will help you choose the most appropriate model for your project requirements. - -After creating the AWS CloudFormation Stack, the next step is to deploy YOLOv8. - -- Open the Notebook Instance: Go to the AWS Console and navigate to the Amazon SageMaker service. Select "Notebook Instances" from the dashboard, then locate the notebook instance that was created by your CDK deployment script. Open the notebook instance to access the Jupyter environment. - -- Access and Modify inference.py: After opening the SageMaker notebook instance in Jupyter, locate the inference.py file. Edit the output_fn function in inference.py as shown below and save your changes to the script, ensuring that there are no syntax errors. - -```python -import json - -def output_fn(prediction_output, content_type): - print("Executing output_fn from inference.py ...") - infer = {} - for result in prediction_output: - if result.boxes is not None: - infer['boxes'] = result.boxes.numpy().data.tolist() - if result.masks is not None: - infer['masks'] = result.masks.numpy().data.tolist() - if result.keypoints is not None: - infer['keypoints'] = result.keypoints.numpy().data.tolist() - if result.obb is not None: - infer['obb'] = result.obb.numpy().data.tolist() - if result.probs is not None: - infer['probs'] = result.probs.numpy().data.tolist() - return json.dumps(infer) -``` - -- Deploy the Endpoint Using 1_DeployEndpoint.ipynb: In the Jupyter environment, open the 1_DeployEndpoint.ipynb notebook located in the sm-notebook directory. Follow the instructions in the notebook and run the cells to download the YOLOv8 model, package it with the updated inference code, and upload it to an Amazon S3 bucket. The notebook will guide you through creating and deploying a SageMaker endpoint for the YOLOv8 model. - -### Step 6: Testing Your Deployment - -Now that your YOLOv8 model is deployed, it's important to test its performance and functionality. - -- Open the Test Notebook: In the same Jupyter environment, locate and open the 2_TestEndpoint.ipynb notebook, also in the sm-notebook directory. - -- Run the Test Notebook: Follow the instructions within the notebook to test the deployed SageMaker endpoint. This includes sending an image to the endpoint and running inferences. Then, you’ll plot the output to visualize the model’s performance and accuracy, as shown below. - -

- Testing Results YOLOv8 -

- -- Clean-Up Resources: The test notebook will also guide you through the process of cleaning up the endpoint and the hosted model. This is an important step to manage costs and resources effectively, especially if you do not plan to use the deployed model immediately. - -### Step 7: Monitoring and Management - -After testing, continuous monitoring and management of your deployed model are essential. - -- Monitor with Amazon CloudWatch: Regularly check the performance and health of your SageMaker endpoint using [Amazon CloudWatch](https://aws.amazon.com/cloudwatch/). - -- Manage the Endpoint: Use the SageMaker console for ongoing management of the endpoint. This includes scaling, updating, or redeploying the model as required. - -By completing these steps, you will have successfully deployed and tested a YOLOv8 model on Amazon SageMaker Endpoints. This process not only equips you with practical experience in using AWS services for machine learning deployment but also lays the foundation for deploying other advanced models in the future. - -## Summary - -This guide took you step by step through deploying YOLOv8 on Amazon SageMaker Endpoints using AWS CloudFormation and the AWS Cloud Development Kit (CDK). The process includes cloning the necessary GitHub repository, setting up the CDK environment, deploying the model using AWS services, and testing its performance on SageMaker. - -For more technical details, refer to [this article](https://aws.amazon.com/blogs/machine-learning/hosting-yolov8-pytorch-model-on-amazon-sagemaker-endpoints/) on the AWS Machine Learning Blog. You can also check out the official [Amazon SageMaker Documentation](https://docs.aws.amazon.com/sagemaker/latest/dg/realtime-endpoints.html) for more insights into various features and functionalities. - -Are you interested in learning more about different YOLOv8 integrations? Visit the [Ultralytics integrations guide page](../integrations/index.md) to discover additional tools and capabilities that can enhance your machine-learning projects. diff --git a/ultralytics-main/docs/en/integrations/clearml.md b/ultralytics-main/docs/en/integrations/clearml.md deleted file mode 100644 index 92b069a..0000000 --- a/ultralytics-main/docs/en/integrations/clearml.md +++ /dev/null @@ -1,189 +0,0 @@ ---- -comments: true -description: Learn how to streamline and optimize your YOLOv8 model training with ClearML. This guide provides insights into integrating ClearML's MLOps tools for efficient model training, from initial setup to advanced experiment tracking and model management. -keywords: Ultralytics, YOLOv8, Object Detection, ClearML, Model Training, MLOps, Experiment Tracking, Workflow Optimization ---- - -# Training YOLOv8 with ClearML: Streamlining Your MLOps Workflow - -MLOps bridges the gap between creating and deploying machine learning models in real-world settings. It focuses on efficient deployment, scalability, and ongoing management to ensure models perform well in practical applications. - -[Ultralytics YOLOv8](https://ultralytics.com) effortlessly integrates with ClearML, streamlining and enhancing your object detection model's training and management. This guide will walk you through the integration process, detailing how to set up ClearML, manage experiments, automate model management, and collaborate effectively. - -## ClearML - -

- ClearML Overview -

- -[ClearML](https://clear.ml/) is an innovative open-source MLOps platform that is skillfully designed to automate, monitor, and orchestrate machine learning workflows. Its key features include automated logging of all training and inference data for full experiment reproducibility, an intuitive web UI for easy data visualization and analysis, advanced hyperparameter optimization algorithms, and robust model management for efficient deployment across various platforms. - -## YOLOv8 Training with ClearML - -You can bring automation and efficiency to your machine learning workflow by improving your training process by integrating YOLOv8 with ClearML. - -## Installation - -To install the required packages, run: - -!!! Tip "Installation" - - === "CLI" - - ```bash - # Install the required packages for YOLOv8 and ClearML - pip install ultralytics clearml - ``` - -For detailed instructions and best practices related to the installation process, be sure to check our [YOLOv8 Installation guide](../quickstart.md). While installing the required packages for YOLOv8, if you encounter any difficulties, consult our [Common Issues guide](../guides/yolo-common-issues.md) for solutions and tips. - -## Configuring ClearML - -Once you have installed the necessary packages, the next step is to initialize and configure your ClearML SDK. This involves setting up your ClearML account and obtaining the necessary credentials for a seamless connection between your development environment and the ClearML server. - -Begin by initializing the ClearML SDK in your environment. The ‘clearml-init’ command starts the setup process and prompts you for the necessary credentials. - -!!! Tip "Initial SDK Setup" - - === "CLI" - - ```bash - # Initialize your ClearML SDK setup process - clearml-init - ``` - -After executing this command, visit the [ClearML Settings page](https://app.clear.ml/settings/workspace-configuration). Navigate to the top right corner and select "Settings." Go to the "Workspace" section and click on "Create new credentials." Use the credentials provided in the "Create Credentials" pop-up to complete the setup as instructed, depending on whether you are configuring ClearML in a Jupyter Notebook or a local Python environment. - -## Usage - -Before diving into the usage instructions, be sure to check out the range of [YOLOv8 models offered by Ultralytics](../models/index.md). This will help you choose the most appropriate model for your project requirements. - -!!! Example "Usage" - - === "Python" - - ```python - from clearml import Task - from ultralytics import YOLO - - # Step 1: Creating a ClearML Task - task = Task.init( - project_name="my_project", - task_name="my_yolov8_task" - ) - - # Step 2: Selecting the YOLOv8 Model - model_variant = "yolov8n" - task.set_parameter("model_variant", model_variant) - - # Step 3: Loading the YOLOv8 Model - model = YOLO(f'{model_variant}.pt') - - # Step 4: Setting Up Training Arguments - args = dict(data="coco128.yaml", epochs=16) - task.connect(args) - - # Step 5: Initiating Model Training - results = model.train(**args) - ``` - -### Understanding the Code - -Let’s understand the steps showcased in the usage code snippet above. - -**Step 1: Creating a ClearML Task**: A new task is initialized in ClearML, specifying your project and task names. This task will track and manage your model's training. - -**Step 2: Selecting the YOLOv8 Model**: The `model_variant` variable is set to 'yolov8n', one of the YOLOv8 models. This variant is then logged in ClearML for tracking. - -**Step 3: Loading the YOLOv8 Model**: The selected YOLOv8 model is loaded using Ultralytics' YOLO class, preparing it for training. - -**Step 4: Setting Up Training Arguments**: Key training arguments like the dataset (`coco128.yaml`) and the number of epochs (`16`) are organized in a dictionary and connected to the ClearML task. This allows for tracking and potential modification via the ClearML UI. For a detailed understanding of the model training process and best practices, refer to our [YOLOv8 Model Training guide](../modes/train.md). - -**Step 5: Initiating Model Training**: The model training is started with the specified arguments. The results of the training process are captured in the `results` variable. - -### Understanding the Output - -Upon running the usage code snippet above, you can expect the following output: - -- A confirmation message indicating the creation of a new ClearML task, along with its unique ID. -- An informational message about the script code being stored, indicating that the code execution is being tracked by ClearML. -- A URL link to the ClearML results page where you can monitor the training progress and view detailed logs. -- Download progress for the YOLOv8 model and the specified dataset, followed by a summary of the model architecture and training configuration. -- Initialization messages for various training components like TensorBoard, Automatic Mixed Precision (AMP), and dataset preparation. -- Finally, the training process starts, with progress updates as the model trains on the specified dataset. For an in-depth understanding of the performance metrics used during training, read [our guide on performance metrics](../guides/yolo-performance-metrics.md). - -### Viewing the ClearML Results Page - -By clicking on the URL link to the ClearML results page in the output of the usage code snippet, you can access a comprehensive view of your model's training process. - -#### Key Features of the ClearML Results Page - -- **Real-Time Metrics Tracking** - - - Track critical metrics like loss, accuracy, and validation scores as they occur. - - Provides immediate feedback for timely model performance adjustments. - -- **Experiment Comparison** - - - Compare different training runs side-by-side. - - Essential for hyperparameter tuning and identifying the most effective models. - -- **Detailed Logs and Outputs** - - - Access comprehensive logs, graphical representations of metrics, and console outputs. - - Gain a deeper understanding of model behavior and issue resolution. - -- **Resource Utilization Monitoring** - - - Monitor the utilization of computational resources, including CPU, GPU, and memory. - - Key to optimizing training efficiency and costs. - -- **Model Artifacts Management** - - - View, download, and share model artifacts like trained models and checkpoints. - - Enhances collaboration and streamlines model deployment and sharing. - -For a visual walkthrough of what the ClearML Results Page looks like, watch the video below: - -

-
- -
- Watch: YOLOv8 MLOps Integration using ClearML -

- -### Advanced Features in ClearML - -ClearML offers several advanced features to enhance your MLOps experience. - -#### Remote Execution - -ClearML's remote execution feature facilitates the reproduction and manipulation of experiments on different machines. It logs essential details like installed packages and uncommitted changes. When a task is enqueued, the ClearML Agent pulls it, recreates the environment, and runs the experiment, reporting back with detailed results. - -Deploying a ClearML Agent is straightforward and can be done on various machines using the following command: - -```bash -clearml-agent daemon --queue [--docker] -``` - -This setup is applicable to cloud VMs, local GPUs, or laptops. ClearML Autoscalers help manage cloud workloads on platforms like AWS, GCP, and Azure, automating the deployment of agents and adjusting resources based on your resource budget. - -### Cloning, Editing, and Enqueuing - -ClearML's user-friendly interface allows easy cloning, editing, and enqueuing of tasks. Users can clone an existing experiment, adjust parameters or other details through the UI, and enqueue the task for execution. This streamlined process ensures that the ClearML Agent executing the task uses updated configurations, making it ideal for iterative experimentation and model fine-tuning. - -


- Cloning, Editing, and Enqueuing with ClearML -

- -## Summary - -This guide has led you through the process of integrating ClearML with Ultralytics' YOLOv8. Covering everything from initial setup to advanced model management, you've discovered how to leverage ClearML for efficient training, experiment tracking, and workflow optimization in your machine learning projects. - -For further details on usage, visit [ClearML's official documentation](https://clear.ml/docs/latest/docs/integrations/yolov8/). - -Additionally, explore more integrations and capabilities of Ultralytics by visiting the [Ultralytics integration guide page](../integrations/index.md), which is a treasure trove of resources and insights. diff --git a/ultralytics-main/docs/en/integrations/comet.md b/ultralytics-main/docs/en/integrations/comet.md deleted file mode 100644 index 95ada28..0000000 --- a/ultralytics-main/docs/en/integrations/comet.md +++ /dev/null @@ -1,178 +0,0 @@ ---- -comments: true -description: Discover how to track and enhance YOLOv8 model training with Comet ML's logging tools, from setup to monitoring key metrics and managing experiments for in-depth analysis. -keywords: Ultralytics, YOLOv8, Object Detection, Comet ML, Model Training, Model Metrics Logging, Experiment Tracking, Offline Experiment Management ---- - -# Elevating YOLOv8 Training: Simplify Your Logging Process with Comet ML - -Logging key training details such as parameters, metrics, image predictions, and model checkpoints is essential in machine learning—it keeps your project transparent, your progress measurable, and your results repeatable. - -[Ultralytics YOLOv8](https://ultralytics.com) seamlessly integrates with Comet ML, efficiently capturing and optimizing every aspect of your YOLOv8 object detection model's training process. In this guide, we'll cover the installation process, Comet ML setup, real-time insights, custom logging, and offline usage, ensuring that your YOLOv8 training is thoroughly documented and fine-tuned for outstanding results. - -## Comet ML - -

- Comet ML Overview -

- -[Comet ML](https://www.comet.ml/) is a platform for tracking, comparing, explaining, and optimizing machine learning models and experiments. It allows you to log metrics, parameters, media, and more during your model training and monitor your experiments through an aesthetically pleasing web interface. Comet ML helps data scientists iterate more rapidly, enhances transparency and reproducibility, and aids in the development of production models. - -## Harnessing the Power of YOLOv8 and Comet ML - -By combining Ultralytics YOLOv8 with Comet ML, you unlock a range of benefits. These include simplified experiment management, real-time insights for quick adjustments, flexible and tailored logging options, and the ability to log experiments offline when internet access is limited. This integration empowers you to make data-driven decisions, analyze performance metrics, and achieve exceptional results. - -## Installation - -To install the required packages, run: - -!!! Tip "Installation" - - === "CLI" - - ```bash - # Install the required packages for YOLOv8 and Comet ML - pip install ultralytics comet_ml torch torchvision - ``` - -## Configuring Comet ML - -After installing the required packages, you’ll need to sign up, get a [Comet API Key](https://www.comet.com/signup), and configure it. - -!!! Tip "Configuring Comet ML" - - === "CLI" - - ```bash - # Set your Comet Api Key - export COMET_API_KEY= - ``` - -Then, you can initialize your Comet project. Comet will automatically detect the API key and proceed with the setup. - -```python -import comet_ml - -comet_ml.init(project_name="comet-example-yolov8-coco128") -``` - -If you are using a Google Colab notebook, the code above will prompt you to enter your API key for initialization. - -## Usage - -Before diving into the usage instructions, be sure to check out the range of [YOLOv8 models offered by Ultralytics](../models/index.md). This will help you choose the most appropriate model for your project requirements. - -!!! Example "Usage" - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO("yolov8n.pt") - - # train the model - results = model.train( - data="coco128.yaml", - project="comet-example-yolov8-coco128", - batch=32, - save_period=1, - save_json=True, - epochs=3 - ) - ``` - -After running the training code, Comet ML will create an experiment in your Comet workspace to track the run automatically. You will then be provided with a link to view the detailed logging of your [YOLOv8 model's training](../modes/train.md) process. - -Comet automatically logs the following data with no additional configuration: metrics such as mAP and loss, hyperparameters, model checkpoints, interactive confusion matrix, and image bounding box predictions. - -## Understanding Your Model's Performance with Comet ML Visualizations - -Let's dive into what you'll see on the Comet ML dashboard once your YOLOv8 model begins training. The dashboard is where all the action happens, presenting a range of automatically logged information through visuals and statistics. Here’s a quick tour: - -**Experiment Panels** - -The experiment panels section of the Comet ML dashboard organize and present the different runs and their metrics, such as segment mask loss, class loss, precision, and mean average precision. - -

- Comet ML Overview -

- -**Metrics** - -In the metrics section, you have the option to examine the metrics in a tabular format as well, which is displayed in a dedicated pane as illustrated here. - -

- Comet ML Overview -

- -**Interactive Confusion Matrix** - -The confusion matrix, found in the Confusion Matrix tab, provides an interactive way to assess the model's classification accuracy. It details the correct and incorrect predictions, allowing you to understand the model's strengths and weaknesses. - -

- Comet ML Overview -

- -**System Metrics** - -Comet ML logs system metrics to help identify any bottlenecks in the training process. It includes metrics such as GPU utilization, GPU memory usage, CPU utilization, and RAM usage. These are essential for monitoring the efficiency of resource usage during model training. - -

- Comet ML Overview -

- -## Customizing Comet ML Logging - -Comet ML offers the flexibility to customize its logging behavior by setting environment variables. These configurations allow you to tailor Comet ML to your specific needs and preferences. Here are some helpful customization options: - -### Logging Image Predictions - -You can control the number of image predictions that Comet ML logs during your experiments. By default, Comet ML logs 100 image predictions from the validation set. However, you can change this number to better suit your requirements. For example, to log 200 image predictions, use the following code: - -```python -import os - -os.environ["COMET_MAX_IMAGE_PREDICTIONS"] = "200" -``` - -### Batch Logging Interval - -Comet ML allows you to specify how often batches of image predictions are logged. The `COMET_EVAL_BATCH_LOGGING_INTERVAL` environment variable controls this frequency. The default setting is 1, which logs predictions from every validation batch. You can adjust this value to log predictions at a different interval. For instance, setting it to 4 will log predictions from every fourth batch. - -```python -import os - -os.environ['COMET_EVAL_BATCH_LOGGING_INTERVAL'] = "4" -``` - -### Disabling Confusion Matrix Logging - -In some cases, you may not want to log the confusion matrix from your validation set after every epoch. You can disable this feature by setting the `COMET_EVAL_LOG_CONFUSION_MATRIX` environment variable to "false." The confusion matrix will only be logged once, after the training is completed. - -```python -import os - -os.environ["COMET_EVAL_LOG_CONFUSION_MATRIX"] = "false" -``` - -### Offline Logging - -If you find yourself in a situation where internet access is limited, Comet ML provides an offline logging option. You can set the `COMET_MODE` environment variable to "offline" to enable this feature. Your experiment data will be saved locally in a directory that you can later upload to Comet ML when internet connectivity is available. - -```python -import os - -os.environ["COMET_MODE"] = "offline" -``` - -## Summary - -This guide has walked you through integrating Comet ML with Ultralytics' YOLOv8. From installation to customization, you've learned to streamline experiment management, gain real-time insights, and adapt logging to your project's needs. - -Explore [Comet ML's official documentation](https://www.comet.com/docs/v2/integrations/third-party-tools/yolov8/) for more insights on integrating with YOLOv8. - -Furthermore, if you're looking to dive deeper into the practical applications of YOLOv8, specifically for image segmentation tasks, this detailed guide on [fine-tuning YOLOv8 with Comet ML](https://www.comet.com/site/blog/fine-tuning-yolov8-for-image-segmentation-with-comet/) offers valuable insights and step-by-step instructions to enhance your model's performance. - -Additionally, to explore other exciting integrations with Ultralytics, check out the [integration guide page](../integrations/index.md), which offers a wealth of resources and information. diff --git a/ultralytics-main/docs/en/integrations/coreml.md b/ultralytics-main/docs/en/integrations/coreml.md deleted file mode 100644 index 5533da5..0000000 --- a/ultralytics-main/docs/en/integrations/coreml.md +++ /dev/null @@ -1,126 +0,0 @@ ---- -comments: true -description: Explore the process of exporting Ultralytics YOLOv8 models to CoreML format, enabling efficient object detection capabilities for iOS and macOS applications on Apple devices. -keywords: Ultralytics, YOLOv8, CoreML Export, Model Deployment, Apple Devices, Object Detection, Machine Learning ---- - -# CoreML Export for YOLOv8 Models - -Deploying computer vision models on Apple devices like iPhones and Macs requires a format that ensures seamless performance. - -The CoreML export format allows you to optimize your [Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics) models for efficient object detection in iOS and macOS applications. In this guide, we'll walk you through the steps for converting your models to the CoreML format, making it easier for your models to perform well on Apple devices. - -## CoreML - -

- CoreML Overview -

- -[CoreML](https://developer.apple.com/documentation/coreml) is Apple's foundational machine learning framework that builds upon Accelerate, BNNS, and Metal Performance Shaders. It provides a machine-learning model format that seamlessly integrates into iOS applications and supports tasks such as image analysis, natural language processing, audio-to-text conversion, and sound analysis. - -Applications can take advantage of Core ML without the need to have a network connection or API calls because the Core ML framework works using on-device computing. This means model inference can be performed locally on the user's device. - -## Key Features of CoreML Models - -Apple's CoreML framework offers robust features for on-device machine learning. Here are the key features that make CoreML a powerful tool for developers: - -- **Comprehensive Model Support**: Converts and runs models from popular frameworks like TensorFlow, PyTorch, scikit-learn, XGBoost, and LibSVM. - -

- CoreML Supported Models -

- -- **On-device Machine Learning**: Ensures data privacy and swift processing by executing models directly on the user's device, eliminating the need for network connectivity. - -- **Performance and Optimization**: Uses the device's CPU, GPU, and Neural Engine for optimal performance with minimal power and memory usage. Offers tools for model compression and optimization while maintaining accuracy. - -- **Ease of Integration**: Provides a unified format for various model types and a user-friendly API for seamless integration into apps. Supports domain-specific tasks through frameworks like Vision and Natural Language. - -- **Advanced Features**: Includes on-device training capabilities for personalized experiences, asynchronous predictions for interactive ML experiences, and model inspection and validation tools. - -## CoreML Deployment Options - -Before we look at the code for exporting YOLOv8 models to the CoreML format, let’s understand where CoreML models are usually used. - -CoreML offers various deployment options for machine learning models, including: - -- **On-Device Deployment**: This method directly integrates CoreML models into your iOS app. It's particularly advantageous for ensuring low latency, enhanced privacy (since data remains on the device), and offline functionality. This approach, however, may be limited by the device's hardware capabilities, especially for larger and more complex models. On-device deployment can be executed in the following two ways. - - - **Embedded Models**: These models are included in the app bundle and are immediately accessible. They are ideal for small models that do not require frequent updates. - - - **Downloaded Models**: These models are fetched from a server as needed. This approach is suitable for larger models or those needing regular updates. It helps keep the app bundle size smaller. - -- **Cloud-Based Deployment**: CoreML models are hosted on servers and accessed by the iOS app through API requests. This scalable and flexible option enables easy model updates without app revisions. It’s ideal for complex models or large-scale apps requiring regular updates. However, it does require an internet connection and may pose latency and security issues​. - -## Exporting YOLOv8 Models to CoreML - -Exporting YOLOv8 to CoreML enables optimized, on-device machine learning performance within Apple's ecosystem, offering benefits in terms of efficiency, security, and seamless integration with iOS, macOS, watchOS, and tvOS platforms. - -### Installation - -To install the required package, run: - -!!! Tip "Installation" - - === "CLI" - - ```bash - # Install the required package for YOLOv8 - pip install ultralytics - ``` - -For detailed instructions and best practices related to the installation process, check our [YOLOv8 Installation guide](../quickstart.md). While installing the required packages for YOLOv8, if you encounter any difficulties, consult our [Common Issues guide](../guides/yolo-common-issues.md) for solutions and tips. - -### Usage - -Before diving into the usage instructions, be sure to check out the range of [YOLOv8 models offered by Ultralytics](../models/index.md). This will help you choose the most appropriate model for your project requirements. - -!!! Example "Usage" - - === "Python" - - ```python - from ultralytics import YOLO - - # Load the YOLOv8 model - model = YOLO('yolov8n.pt') - - # Export the model to CoreML format - model.export(format='coreml') # creates 'yolov8n.mlpackage' - - # Load the exported CoreML model - coreml_model = YOLO('yolov8n.mlpackage') - - # Run inference - results = coreml_model('https://ultralytics.com/images/bus.jpg') - ``` - - === "CLI" - - ```bash - # Export a YOLOv8n PyTorch model to CoreML format - yolo export model=yolov8n.pt format=coreml # creates 'yolov8n.mlpackage'' - - # Run inference with the exported model - yolo predict model=yolov8n.mlpackage source='https://ultralytics.com/images/bus.jpg' - ``` - -For more details about the export process, visit the [Ultralytics documentation page on exporting](../modes/export.md). - -## Deploying Exported YOLOv8 CoreML Models - -Having successfully exported your Ultralytics YOLOv8 models to CoreML, the next critical phase is deploying these models effectively. For detailed guidance on deploying CoreML models in various environments, check out these resources: - -- **[CoreML Tools](https://apple.github.io/coremltools/docs-guides/)**: This guide includes instructions and examples to convert models from TensorFlow, PyTorch, and other libraries to Core ML. - -- **[ML and Vision](https://developer.apple.com/videos/ml-vision)**: A collection of comprehensive videos that cover various aspects of using and implementing CoreML models. - -- **[Integrating a Core ML Model into Your App](https://developer.apple.com/documentation/coreml/integrating_a_core_ml_model_into_your_app)**: A comprehensive guide on integrating a CoreML model into an iOS application, detailing steps from preparing the model to implementing it in the app for various functionalities. - -## Summary - -In this guide, we went over how to export Ultralytics YOLOv8 models to CoreML format. By following the steps outlined in this guide, you can ensure maximum compatibility and performance when exporting YOLOv8 models to CoreML. - -For further details on usage, visit the [CoreML official documentation](https://developer.apple.com/documentation/coreml). - -Also, if you’d like to know more about other Ultralytics YOLOv8 integrations, visit our [integration guide page](../integrations/index.md). You'll find plenty of valuable resources and insights there. diff --git a/ultralytics-main/docs/en/integrations/dvc.md b/ultralytics-main/docs/en/integrations/dvc.md deleted file mode 100644 index 542a91a..0000000 --- a/ultralytics-main/docs/en/integrations/dvc.md +++ /dev/null @@ -1,171 +0,0 @@ ---- -comments: true -description: This guide provides a step-by-step approach to integrating DVCLive with Ultralytics YOLOv8 for advanced experiment tracking. Learn how to set up your environment, run experiments with varied configurations, and analyze results using DVCLive's powerful tracking and visualization tools. -keywords: DVCLive, Ultralytics, YOLOv8, Machine Learning, Experiment Tracking, Data Version Control, ML Workflows, Model Training, Hyperparameter Tuning ---- - -# Advanced YOLOv8 Experiment Tracking with DVCLive - -Experiment tracking in machine learning is critical to model development and evaluation. It involves recording and analyzing various parameters, metrics, and outcomes from numerous training runs. This process is essential for understanding model performance and making data-driven decisions to refine and optimize models. - -Integrating DVCLive with [Ultralytics YOLOv8](https://ultralytics.com) transforms the way experiments are tracked and managed. This integration offers a seamless solution for automatically logging key experiment details, comparing results across different runs, and visualizing data for in-depth analysis. In this guide, we'll understand how DVCLive can be used to streamline the process. - -## DVCLive - -

- DVCLive Overview -

- -[DVCLive](https://dvc.org/doc/dvclive), developed by DVC, is an innovative open-source tool for experiment tracking in machine learning. Integrating seamlessly with Git and DVC, it automates the logging of crucial experiment data like model parameters and training metrics. Designed for simplicity, DVCLive enables effortless comparison and analysis of multiple runs, enhancing the efficiency of machine learning projects with intuitive data visualization and analysis tools. - -## YOLOv8 Training with DVCLive - -YOLOv8 training sessions can be effectively monitored with DVCLive. Additionally, DVC provides integral features for visualizing these experiments, including the generation of a report that enables the comparison of metric plots across all tracked experiments, offering a comprehensive view of the training process. - -## Installation - -To install the required packages, run: - -!!! Tip "Installation" - - === "CLI" - - ```bash - # Install the required packages for YOLOv8 and DVCLive - pip install ultralytics dvclive - ``` - -For detailed instructions and best practices related to the installation process, be sure to check our [YOLOv8 Installation guide](../quickstart.md). While installing the required packages for YOLOv8, if you encounter any difficulties, consult our [Common Issues guide](../guides/yolo-common-issues.md) for solutions and tips. - -## Configuring DVCLive - -Once you have installed the necessary packages, the next step is to set up and configure your environment with the necessary credentials. This setup ensures a smooth integration of DVCLive into your existing workflow. - -Begin by initializing a Git repository, as Git plays a crucial role in version control for both your code and DVCLive configurations. - -!!! Tip "Initial Environment Setup" - - === "CLI" - - ```bash - # Initialize a Git repository - git init -q - - # Configure Git with your details - git config --local user.email "you@example.com" - git config --local user.name "Your Name" - - # Initialize DVCLive in your project - dvc init -q - - # Commit the DVCLive setup to your Git repository - git commit -m "DVC init" - ``` - -In these commands, ensure to replace "you@example.com" with the email address associated with your Git account, and "Your Name" with your Git account username. - -## Usage - -Before diving into the usage instructions, be sure to check out the range of [YOLOv8 models offered by Ultralytics](../models/index.md). This will help you choose the most appropriate model for your project requirements. - -### Training YOLOv8 Models with DVCLive - -Start by running your YOLOv8 training sessions. You can use different model configurations and training parameters to suit your project needs. For instance: - -```bash -# Example training commands for YOLOv8 with varying configurations -yolo train model=yolov8n.pt data=coco8.yaml epochs=5 imgsz=512 -yolo train model=yolov8n.pt data=coco8.yaml epochs=5 imgsz=640 -``` - -Adjust the model, data, epochs, and imgsz parameters according to your specific requirements. For a detailed understanding of the model training process and best practices, refer to our [YOLOv8 Model Training guide](../modes/train.md). - -### Monitoring Experiments with DVCLive - -DVCLive enhances the training process by enabling the tracking and visualization of key metrics. When installed, Ultralytics YOLOv8 automatically integrates with DVCLive for experiment tracking, which you can later analyze for performance insights. For a comprehensive understanding of the specific performance metrics used during training, be sure to explore [our detailed guide on performance metrics](../guides/yolo-performance-metrics.md). - -### Analyzing Results - -After your YOLOv8 training sessions are complete, you can leverage DVCLive's powerful visualization tools for in-depth analysis of the results. DVCLive's integration ensures that all training metrics are systematically logged, facilitating a comprehensive evaluation of your model's performance. - -To start the analysis, you can extract the experiment data using DVC's API and process it with Pandas for easier handling and visualization: - -```python -import dvc.api -import pandas as pd - -# Define the columns of interest -columns = ["Experiment", "epochs", "imgsz", "model", "metrics.mAP50-95(B)"] - -# Retrieve experiment data -df = pd.DataFrame(dvc.api.exp_show(), columns=columns) - -# Clean the data -df.dropna(inplace=True) -df.reset_index(drop=True, inplace=True) - -# Display the DataFrame -print(df) -``` - -The output of the code snippet above provides a clear tabular view of the different experiments conducted with YOLOv8 models. Each row represents a different training run, detailing the experiment's name, the number of epochs, image size (imgsz), the specific model used, and the mAP50-95(B) metric. This metric is crucial for evaluating the model's accuracy, with higher values indicating better performance. - -#### Visualizing Results with Plotly - -For a more interactive and visual analysis of your experiment results, you can use Plotly's parallel coordinates plot. This type of plot is particularly useful for understanding the relationships and trade-offs between different parameters and metrics. - -```python -from plotly.express import parallel_coordinates - -# Create a parallel coordinates plot -fig = parallel_coordinates(df, columns, color="metrics.mAP50-95(B)") - -# Display the plot -fig.show() -``` - -The output of the code snippet above generates a plot that will visually represent the relationships between epochs, image size, model type, and their corresponding mAP50-95(B) scores, enabling you to spot trends and patterns in your experiment data. - -#### Generating Comparative Visualizations with DVC - -DVC provides a useful command to generate comparative plots for your experiments. This can be especially helpful to compare the performance of different models over various training runs. - -```bash -# Generate DVC comparative plots -dvc plots diff $(dvc exp list --names-only) -``` - -After executing this command, DVC generates plots comparing the metrics across different experiments, which are saved as HTML files. Below is an example image illustrating typical plots generated by this process. The image showcases various graphs, including those representing mAP, recall, precision, loss values, and more, providing a visual overview of key performance metrics: - -

- DVCLive Plots -

- -### Displaying DVC Plots - -If you are using a Jupyter Notebook and you want to display the generated DVC plots, you can use the IPython display functionality. - -```python -from IPython.display import HTML - -# Display the DVC plots as HTML -HTML(filename='./dvc_plots/index.html') -``` - -This code will render the HTML file containing the DVC plots directly in your Jupyter Notebook, providing an easy and convenient way to analyze the visualized experiment data. - -### Making Data-Driven Decisions - -Use the insights gained from these visualizations to make informed decisions about model optimizations, hyperparameter tuning, and other modifications to enhance your model's performance. - -### Iterating on Experiments - -Based on your analysis, iterate on your experiments. Adjust model configurations, training parameters, or even the data inputs, and repeat the training and analysis process. This iterative approach is key to refining your model for the best possible performance. - -## Summary - -This guide has led you through the process of integrating DVCLive with Ultralytics' YOLOv8. You have learned how to harness the power of DVCLive for detailed experiment monitoring, effective visualization, and insightful analysis in your machine learning endeavors. - -For further details on usage, visit [DVCLive’s official documentation](https://dvc.org/doc/dvclive/ml-frameworks/yolo). - -Additionally, explore more integrations and capabilities of Ultralytics by visiting the [Ultralytics integration guide page](../integrations/index.md), which is a collection of great resources and insights. diff --git a/ultralytics-main/docs/en/integrations/edge-tpu.md b/ultralytics-main/docs/en/integrations/edge-tpu.md deleted file mode 100644 index aa83c44..0000000 --- a/ultralytics-main/docs/en/integrations/edge-tpu.md +++ /dev/null @@ -1,118 +0,0 @@ ---- -comments: true -description: Discover how to uplift your Ultralytics YOLOv8 model's overall performance with the TFLite Edge TPU export format, which is perfect for mobile and embedded devices. -keywords: Ultralytics, YOLOv8, TFLite edge TPU format, Export YOLOv8, Model Deployment, Flexible Deployment ---- - -# Learn to Export to TFLite Edge TPU Format From YOLOv8 Model - -Deploying computer vision models on devices with limited computational power, such as mobile or embedded systems, can be tricky. Using a model format that is optimized for faster performance simplifies the process. The [TensorFlow Lite](https://www.tensorflow.org/lite) [Edge TPU](https://coral.ai/docs/edgetpu/models-intro/) or TFLite Edge TPU model format is designed to use minimal power while delivering fast performance for neural networks. - -The export to TFLite Edge TPU format feature allows you to optimize your [Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics) models for high-speed and low-power inferencing. In this guide, we'll walk you through converting your models to the TFLite Edge TPU format, making it easier for your models to perform well on various mobile and embedded devices. - -## Why Should You Export to TFLite Edge TPU? - -Exporting models to TensorFlow Edge TPU makes machine learning tasks fast and efficient. This technology suits applications with limited power, computing resources, and connectivity. The Edge TPU is a hardware accelerator by Google. It speeds up TensorFlow Lite models on edge devices. The image below shows an example of the process involved. - -

- TFLite Edge TPU -

- -The Edge TPU works with quantized models. Quantization makes models smaller and faster without losing much accuracy. It is ideal for the limited resources of edge computing, allowing applications to respond quickly by reducing latency and allowing for quick data processing locally, without cloud dependency. Local processing also keeps user data private and secure since it's not sent to a remote server​​​​. - -## Key Features of TFLite Edge TPU - -Here are the key features that make TFLite Edge TPU a great model format choice for developers: - -- **Optimized Performance on Edge Devices**: The TFLite Edge TPU achieves high-speed neural networking performance through quantization, model optimization, hardware acceleration, and compiler optimization. Its minimalistic architecture contributes to its smaller size and cost-efficiency. - -- **High Computational Throughput**: TFLite Edge TPU combines specialized hardware acceleration and efficient runtime execution to achieve high computational throughput. It is well-suited for deploying machine learning models with stringent performance requirements on edge devices. - -- **Efficient Matrix Computations**: The TensorFlow Edge TPU is optimized for matrix operations, which are crucial for neural network computations. This efficiency is key in machine learning models, particularly those requiring numerous and complex matrix multiplications and transformations. - -## Deployment Options with TFLite Edge TPU - -Before we jump into how to export YOLOv8 models to the TFLite Edge TPU format, let’s understand where TFLite Edge TPU models are usually used. - -TFLite Edge TPU offers various deployment options for machine learning models, including: - -- **On-Device Deployment**: TensorFlow Edge TPU models can be directly deployed on mobile and embedded devices. On-device deployment allows the models to execute directly on the hardware, eliminating the need for cloud connectivity. - -- **Edge Computing with Cloud TensorFlow TPUs**: In scenarios where edge devices have limited processing capabilities, TensorFlow Edge TPUs can offload inference tasks to cloud servers equipped with TPUs. - -- **Hybrid Deployment**: A hybrid approach combines on-device and cloud deployment and offers a versatile and scalable solution for deploying machine learning models. Advantages include on-device processing for quick responses and cloud computing for more complex computations. - -## Exporting YOLOv8 Models to TFLite Edge TPU - -You can expand model compatibility and deployment flexibility by converting YOLOv8 models to TensorFlow Edge TPU. - -### Installation - -To install the required package, run: - -!!! Tip "Installation" - - === "CLI" - - ```bash - # Install the required package for YOLOv8 - pip install ultralytics - ``` - -For detailed instructions and best practices related to the installation process, check our [Ultralytics Installation guide](../quickstart.md). While installing the required packages for YOLOv8, if you encounter any difficulties, consult our [Common Issues guide](../guides/yolo-common-issues.md) for solutions and tips. - -### Usage - -Before diving into the usage instructions, it's important to note that while all [Ultralytics YOLOv8 models](../models/index.md) are available for exporting, you can ensure that the model you select supports export functionality [here](../modes/export.md). - -!!! Example "Usage" - - === "Python" - - ```python - from ultralytics import YOLO - - # Load the YOLOv8 model - model = YOLO('yolov8n.pt') - - # Export the model to TFLite Edge TPU format - model.export(format='edgetpu') # creates 'yolov8n_full_integer_quant_edgetpu.tflite’ - - # Load the exported TFLite Edge TPU model - edgetpu_model = YOLO('yolov8n_full_integer_quant_edgetpu.tflite') - - # Run inference - results = edgetpu_model('https://ultralytics.com/images/bus.jpg') - ``` - - === "CLI" - - ```bash - # Export a YOLOv8n PyTorch model to TFLite Edge TPU format - yolo export model=yolov8n.pt format=edgetpu # creates 'yolov8n_full_integer_quant_edgetpu.tflite' - - # Run inference with the exported model - yolo predict model=yolov8n_full_integer_quant_edgetpu.tflite source='https://ultralytics.com/images/bus.jpg' - ``` - -For more details about supported export options, visit the [Ultralytics documentation page on deployment options](../guides/model-deployment-options.md). - -## Deploying Exported YOLOv8 TFLite Edge TPU Models - -After successfully exporting your Ultralytics YOLOv8 models to TFLite Edge TPU format, you can now deploy them. The primary and recommended first step for running a TFLite Edge TPU model is to use the YOLO("model_edgetpu.tflite") method, as outlined in the previous usage code snippet. - -However, for in-depth instructions on deploying your TFLite Edge TPU models, take a look at the following resources: - -- **[Coral Edge TPU on a Raspberry Pi with Ultralytics YOLOv8](../guides/coral-edge-tpu-on-raspberry-pi.md)**: Discover how to integrate Coral Edge TPUs with Raspberry Pi for enhanced machine learning capabilities. - -- **[Code Examples](https://coral.ai/docs/edgetpu/compiler/)**: Access practical TensorFlow Edge TPU deployment examples to kickstart your projects. - -- **[Run Inference on the Edge TPU with Python](https://coral.ai/docs/edgetpu/tflite-python/#overview)**: Explore how to use the TensorFlow Lite Python API for Edge TPU applications, including setup and usage guidelines. - -## Summary - -In this guide, we’ve learned how to export Ultralytics YOLOv8 models to TFLite Edge TPU format. By following the steps mentioned above, you can increase the speed and power of your computer vision applications. - -For further details on usage, visit the [Edge TPU official website](https://cloud.google.com/edge-tpu). - -Also, for more information on other Ultralytics YOLOv8 integrations, please visit our [integration guide page](index.md). There, you'll discover valuable resources and insights. diff --git a/ultralytics-main/docs/en/integrations/gradio.md b/ultralytics-main/docs/en/integrations/gradio.md deleted file mode 100644 index 3845b4f..0000000 --- a/ultralytics-main/docs/en/integrations/gradio.md +++ /dev/null @@ -1,106 +0,0 @@ ---- -comments: true -description: Learn to use Gradio and Ultralytics YOLOv8 for interactive object detection. Upload images and adjust detection parameters in real-time. -keywords: Gradio, Ultralytics YOLOv8, object detection, interactive AI, Python ---- - -# Interactive Object Detection: Gradio & Ultralytics YOLOv8 🚀 - -## Introduction to Interactive Object Detection - -This Gradio interface provides an easy and interactive way to perform object detection using the [Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics/) model. Users can upload images and adjust parameters like confidence threshold and intersection-over-union (IoU) threshold to get real-time detection results. - -## Why Use Gradio for Object Detection? - -* **User-Friendly Interface:** Gradio offers a straightforward platform for users to upload images and visualize detection results without any coding requirement. -* **Real-Time Adjustments:** Parameters such as confidence and IoU thresholds can be adjusted on the fly, allowing for immediate feedback and optimization of detection results. -* **Broad Accessibility:** The Gradio web interface can be accessed by anyone, making it an excellent tool for demonstrations, educational purposes, and quick experiments. - -

- Gradio example screenshot -

- -## How to Install the Gradio - -```bash -pip install gradio -``` - -## How to Use the Interface - -1. **Upload Image:** Click on 'Upload Image' to choose an image file for object detection. -2. **Adjust Parameters:** - * **Confidence Threshold:** Slider to set the minimum confidence level for detecting objects. - * **IoU Threshold:** Slider to set the IoU threshold for distinguishing different objects. -3. **View Results:** The processed image with detected objects and their labels will be displayed. - -## Example Use Cases - -* **Sample Image 1:** Bus detection with default thresholds. -* **Sample Image 2:** Detection on a sports image with default thresholds. - -## Usage Example - -This section provides the Python code used to create the Gradio interface with the Ultralytics YOLOv8 model. Supports classification tasks, detection tasks, segmentation tasks, and key point tasks. - -```python -import PIL.Image as Image -import gradio as gr - -from ultralytics import ASSETS, YOLO - -model = YOLO("yolov8n.pt") - - -def predict_image(img, conf_threshold, iou_threshold): - results = model.predict( - source=img, - conf=conf_threshold, - iou=iou_threshold, - show_labels=True, - show_conf=True, - imgsz=640, - ) - - for r in results: - im_array = r.plot() - im = Image.fromarray(im_array[..., ::-1]) - - return im - - -iface = gr.Interface( - fn=predict_image, - inputs=[ - gr.Image(type="pil", label="Upload Image"), - gr.Slider(minimum=0, maximum=1, value=0.25, label="Confidence threshold"), - gr.Slider(minimum=0, maximum=1, value=0.45, label="IoU threshold") - ], - outputs=gr.Image(type="pil", label="Result"), - title="Ultralytics Gradio", - description="Upload images for inference. The Ultralytics YOLOv8n model is used by default.", - examples=[ - [ASSETS / "bus.jpg", 0.25, 0.45], - [ASSETS / "zidane.jpg", 0.25, 0.45], - ] -) - -if __name__ == '__main__': - iface.launch() -``` - -## Parameters Explanation - -| Parameter Name | Type | Description | -|------------------|---------|----------------------------------------------------------| -| `img` | `Image` | The image on which object detection will be performed. | -| `conf_threshold` | `float` | Confidence threshold for detecting objects. | -| `iou_threshold` | `float` | Intersection-over-union threshold for object separation. | - -### Gradio Interface Components - -| Component | Description | -|--------------|------------------------------------------| -| Image Input | To upload the image for detection. | -| Sliders | To adjust confidence and IoU thresholds. | -| Image Output | To display the detection results. | diff --git a/ultralytics-main/docs/en/integrations/index.md b/ultralytics-main/docs/en/integrations/index.md deleted file mode 100644 index 6195f54..0000000 --- a/ultralytics-main/docs/en/integrations/index.md +++ /dev/null @@ -1,104 +0,0 @@ ---- -comments: true -description: Explore Ultralytics integrations with tools for dataset management, model optimization, ML workflows automation, experiment tracking, version control, and more. Learn about our support for various model export formats for deployment. -keywords: Ultralytics integrations, Roboflow, Neural Magic, ClearML, Comet ML, DVC, Ultralytics HUB, MLFlow, Neptune, Ray Tune, TensorBoard, W&B, model export formats, PyTorch, TorchScript, ONNX, OpenVINO, TensorRT, CoreML, TF SavedModel, TF GraphDef, TF Lite, TF Edge TPU, TF.js, PaddlePaddle, NCNN ---- - -# Ultralytics Integrations - -Welcome to the Ultralytics Integrations page! This page provides an overview of our partnerships with various tools and platforms, designed to streamline your machine learning workflows, enhance dataset management, simplify model training, and facilitate efficient deployment. - -Ultralytics YOLO ecosystem and integrations - -

-
- -
- Watch: Ultralytics YOLOv8 Deployment and Integrations -

- -## Datasets Integrations - -- [Roboflow](roboflow.md): Facilitate seamless dataset management for Ultralytics models, offering robust annotation, preprocessing, and augmentation capabilities. - -## Training Integrations - -- [ClearML](clearml.md): Automate your Ultralytics ML workflows, monitor experiments, and foster team collaboration. - -- [Comet ML](comet.md): Enhance your model development with Ultralytics by tracking, comparing, and optimizing your machine learning experiments. - -- [DVC](dvc.md): Implement version control for your Ultralytics machine learning projects, synchronizing data, code, and models effectively. - -- [MLFlow](mlflow.md): Streamline the entire ML lifecycle of Ultralytics models, from experimentation and reproducibility to deployment. - -- [Ultralytics HUB](https://hub.ultralytics.com): Access and contribute to a community of pre-trained Ultralytics models. - -- [Neptune](https://neptune.ai/): Maintain a comprehensive log of your ML experiments with Ultralytics in this metadata store designed for MLOps. - -- [Ray Tune](ray-tune.md): Optimize the hyperparameters of your Ultralytics models at any scale. - -- [TensorBoard](tensorboard.md): Visualize your Ultralytics ML workflows, monitor model metrics, and foster team collaboration. - -- [Weights & Biases (W&B)](weights-biases.md): Monitor experiments, visualize metrics, and foster reproducibility and collaboration on Ultralytics projects. - -- [Amazon SageMaker](amazon-sagemaker.md): Leverage Amazon SageMaker to efficiently build, train, and deploy Ultralytics models, providing an all-in-one platform for the ML lifecycle. - -## Deployment Integrations - -- [Neural Magic](neural-magic.md): Leverage Quantization Aware Training (QAT) and pruning techniques to optimize Ultralytics models for superior performance and leaner size. - -- [Gradio](gradio.md) 🚀 NEW: Deploy Ultralytics models with Gradio for real-time, interactive object detection demos. - -- [TorchScript](torchscript.md): Developed as part of the [PyTorch](https://pytorch.org/) framework, TorchScript enables efficient execution and deployment of machine learning models in various production environments without the need for Python dependencies. - -- [ONNX](onnx.md): An open-source format created by [Microsoft](https://www.microsoft.com) for facilitating the transfer of AI models between various frameworks, enhancing the versatility and deployment flexibility of Ultralytics models. - -- [OpenVINO](openvino.md): Intel's toolkit for optimizing and deploying computer vision models efficiently across various Intel CPU and GPU platforms. - -- [TensorRT](tensorrt.md): Developed by [NVIDIA](https://www.nvidia.com/), this high-performance deep learning inference framework and model format optimizes AI models for accelerated speed and efficiency on NVIDIA GPUs, ensuring streamlined deployment. - -- [CoreML](coreml.md): CoreML, developed by [Apple](https://www.apple.com/), is a framework designed for efficiently integrating machine learning models into applications across iOS, macOS, watchOS, and tvOS, using Apple's hardware for effective and secure model deployment. - -- [TFLite](tflite.md): Developed by [Google](https://www.google.com), TFLite is a lightweight framework for deploying machine learning models on mobile and edge devices, ensuring fast, efficient inference with minimal memory footprint. - -- [TFLite Edge TPU](edge-tpu.md): Developed by [Google](https://www.google.com) for optimizing TensorFlow Lite models on Edge TPUs, this model format ensures high-speed, efficient edge computing. - -- [PaddlePaddle](paddlepaddle.md): An open-source deep learning platform by [Baidu](https://www.baidu.com/), PaddlePaddle enables the efficient deployment of AI models and focuses on the scalability of industrial applications. - -- [NCNN](ncnn.md): Developed by [Tencent](http://www.tencent.com/), NCNN is an efficient neural network inference framework tailored for mobile devices. It enables direct deployment of AI models into apps, optimizing performance across various mobile platforms. - -### Export Formats - -We also support a variety of model export formats for deployment in different environments. Here are the available formats: - -| Format | `format` Argument | Model | Metadata | Arguments | -|--------------------------------------------------------------------|-------------------|---------------------------|----------|-----------------------------------------------------| -| [PyTorch](https://pytorch.org/) | - | `yolov8n.pt` | ✅ | - | -| [TorchScript](https://pytorch.org/docs/stable/jit.html) | `torchscript` | `yolov8n.torchscript` | ✅ | `imgsz`, `optimize` | -| [ONNX](onnx.md) | `onnx` | `yolov8n.onnx` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `opset` | -| [OpenVINO](openvino.md) | `openvino` | `yolov8n_openvino_model/` | ✅ | `imgsz`, `half`, `int8` | -| [TensorRT](https://developer.nvidia.com/tensorrt) | `engine` | `yolov8n.engine` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `workspace` | -| [CoreML](https://github.com/apple/coremltools) | `coreml` | `yolov8n.mlpackage` | ✅ | `imgsz`, `half`, `int8`, `nms` | -| [TF SavedModel](https://www.tensorflow.org/guide/saved_model) | `saved_model` | `yolov8n_saved_model/` | ✅ | `imgsz`, `keras`, `int8` | -| [TF GraphDef](https://www.tensorflow.org/api_docs/python/tf/Graph) | `pb` | `yolov8n.pb` | ❌ | `imgsz` | -| [TF Lite](https://www.tensorflow.org/lite) | `tflite` | `yolov8n.tflite` | ✅ | `imgsz`, `half`, `int8` | -| [TF Edge TPU](https://coral.ai/docs/edgetpu/models-intro/) | `edgetpu` | `yolov8n_edgetpu.tflite` | ✅ | `imgsz` | -| [TF.js](https://www.tensorflow.org/js) | `tfjs` | `yolov8n_web_model/` | ✅ | `imgsz`, `half`, `int8` | -| [PaddlePaddle](https://github.com/PaddlePaddle) | `paddle` | `yolov8n_paddle_model/` | ✅ | `imgsz` | -| [NCNN](https://github.com/Tencent/ncnn) | `ncnn` | `yolov8n_ncnn_model/` | ✅ | `imgsz`, `half` | - -Explore the links to learn more about each integration and how to get the most out of them with Ultralytics. - -## Contribute to Our Integrations - -We're always excited to see how the community integrates Ultralytics YOLO with other technologies, tools, and platforms! If you have successfully integrated YOLO with a new system or have valuable insights to share, consider contributing to our Integrations Docs. - -By writing a guide or tutorial, you can help expand our documentation and provide real-world examples that benefit the community. It's an excellent way to contribute to the growing ecosystem around Ultralytics YOLO. - -To contribute, please check out our [Contributing Guide](https://docs.ultralytics.com/help/contributing) for instructions on how to submit a Pull Request (PR) 🛠️. We eagerly await your contributions! - -Let's collaborate to make the Ultralytics YOLO ecosystem more expansive and feature-rich 🙏! diff --git a/ultralytics-main/docs/en/integrations/mlflow.md b/ultralytics-main/docs/en/integrations/mlflow.md deleted file mode 100644 index 0dcf4da..0000000 --- a/ultralytics-main/docs/en/integrations/mlflow.md +++ /dev/null @@ -1,117 +0,0 @@ ---- -comments: true -description: Uncover the utility of MLflow for effective experiment logging in your Ultralytics YOLO projects. -keywords: ultralytics docs, YOLO, MLflow, experiment logging, metrics tracking, parameter logging, artifact logging ---- - -# MLflow Integration for Ultralytics YOLO - -MLflow ecosystem - -## Introduction - -Experiment logging is a crucial aspect of machine learning workflows that enables tracking of various metrics, parameters, and artifacts. It helps to enhance model reproducibility, debug issues, and improve model performance. [Ultralytics](https://ultralytics.com) YOLO, known for its real-time object detection capabilities, now offers integration with [MLflow](https://mlflow.org/), an open-source platform for complete machine learning lifecycle management. - -This documentation page is a comprehensive guide to setting up and utilizing the MLflow logging capabilities for your Ultralytics YOLO project. - -## What is MLflow? - -[MLflow](https://mlflow.org/) is an open-source platform developed by [Databricks](https://www.databricks.com/) for managing the end-to-end machine learning lifecycle. It includes tools for tracking experiments, packaging code into reproducible runs, and sharing and deploying models. MLflow is designed to work with any machine learning library and programming language. - -## Features - -- **Metrics Logging**: Logs metrics at the end of each epoch and at the end of the training. -- **Parameter Logging**: Logs all the parameters used in the training. -- **Artifacts Logging**: Logs model artifacts, including weights and configuration files, at the end of the training. - -## Setup and Prerequisites - -Ensure MLflow is installed. If not, install it using pip: - -```bash -pip install mlflow -``` - -Make sure that MLflow logging is enabled in Ultralytics settings. Usually, this is controlled by the settings `mflow` key. See the [settings](https://docs.ultralytics.com/quickstart/#ultralytics-settings) page for more info. - -!!! Example "Update Ultralytics MLflow Settings" - - === "Python" - Within the Python environment, call the `update` method on the `settings` object to change your settings: - ```python - from ultralytics import settings - - # Update a setting - settings.update({'mlflow': True}) - - # Reset settings to default values - settings.reset() - ``` - - === "CLI" - If you prefer using the command-line interface, the following commands will allow you to modify your settings: - ```bash - # Update a setting - yolo settings runs_dir='/path/to/runs' - - # Reset settings to default values - yolo settings reset - ``` - -## How to Use - -### Commands - -1. **Set a Project Name**: You can set the project name via an environment variable: - - ```bash - export MLFLOW_EXPERIMENT_NAME= - ``` - - Or use the `project=` argument when training a YOLO model, i.e. `yolo train project=my_project`. - -2. **Set a Run Name**: Similar to setting a project name, you can set the run name via an environment variable: - - ```bash - export MLFLOW_RUN= - ``` - - Or use the `name=` argument when training a YOLO model, i.e. `yolo train project=my_project name=my_name`. - -3. **Start Local MLflow Server**: To start tracking, use: - - ```bash - mlflow server --backend-store-uri runs/mlflow' - ``` - - This will start a local server at http://127.0.0.1:5000 by default and save all mlflow logs to the 'runs/mlflow' directory. To specify a different URI, set the `MLFLOW_TRACKING_URI` environment variable. - -4. **Kill MLflow Server Instances**: To stop all running MLflow instances, run: - - ```bash - ps aux | grep 'mlflow' | grep -v 'grep' | awk '{print $2}' | xargs kill -9 - ``` - -### Logging - -The logging is taken care of by the `on_pretrain_routine_end`, `on_fit_epoch_end`, and `on_train_end` callback functions. These functions are automatically called during the respective stages of the training process, and they handle the logging of parameters, metrics, and artifacts. - -## Examples - -1. **Logging Custom Metrics**: You can add custom metrics to be logged by modifying the `trainer.metrics` dictionary before `on_fit_epoch_end` is called. - -2. **View Experiment**: To view your logs, navigate to your MLflow server (usually http://127.0.0.1:5000) and select your experiment and run. YOLO MLflow Experiment - -3. **View Run**: Runs are individual models inside an experiment. Click on a Run and see the Run details, including uploaded artifacts and model weights. YOLO MLflow Run - -## Disabling MLflow - -To turn off MLflow logging: - -```bash -yolo settings mlflow=False -``` - -## Conclusion - -MLflow logging integration with Ultralytics YOLO offers a streamlined way to keep track of your machine learning experiments. It empowers you to monitor performance metrics and manage artifacts effectively, thus aiding in robust model development and deployment. For further details please visit the MLflow [official documentation](https://mlflow.org/docs/latest/index.html). diff --git a/ultralytics-main/docs/en/integrations/ncnn.md b/ultralytics-main/docs/en/integrations/ncnn.md deleted file mode 100644 index 835f8fc..0000000 --- a/ultralytics-main/docs/en/integrations/ncnn.md +++ /dev/null @@ -1,120 +0,0 @@ ---- -comments: true -description: Uncover how to improve your Ultralytics YOLOv8 model's performance using the NCNN export format that is suitable for devices with limited computation resources. -keywords: Ultralytics, YOLOv8, NCNN Export, Export YOLOv8, Model Deployment ---- - -# How to Export to NCNN from YOLOv8 for Smooth Deployment - -Deploying computer vision models on devices with limited computational power, such as mobile or embedded systems, can be tricky. You need to make sure you use a format optimized for optimal performance. This makes sure that even devices with limited processing power can handle advanced computer vision tasks well. - -The export to NCNN format feature allows you to optimize your [Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics) models for lightweight device-based applications. In this guide, we'll walk you through how to convert your models to the NCNN format, making it easier for your models to perform well on various mobile and embedded devices. - -## Why should you export to NCNN? - -

- NCNN overview -

- -The [NCNN](https://github.com/Tencent/ncnn) framework, developed by Tencent, is a high-performance neural network inference computing framework optimized specifically for mobile platforms, including mobile phones, embedded devices, and IoT devices. NCNN is compatible with a wide range of platforms, including Linux, Android, iOS, and macOS. - -NCNN is known for its fast processing speed on mobile CPUs and enables rapid deployment of deep learning models to mobile platforms. This makes it easier to build smart apps, putting the power of AI right at your fingertips. - -## Key Features of NCNN Models - -NCNN models offer a wide range of key features that enable on-device machine learning by helping developers run their models on mobile, embedded, and edge devices: - -- **Efficient and High-Performance**: NCNN models are made to be efficient and lightweight, optimized for running on mobile and embedded devices like Raspberry Pi with limited resources. They can also achieve high performance with high accuracy on various computer vision-based tasks. - -- **Quantization**: NCNN models often support quantization which is a technique that reduces the precision of the model's weights and activations. This leads to further improvements in performance and reduces memory footprint. - -- **Compatibility**: NCNN models are compatible with popular deep learning frameworks like [TensorFlow](https://www.tensorflow.org/), [Caffe](https://caffe.berkeleyvision.org/), and [ONNX](https://onnx.ai/). This compatibility allows developers to use existing models and workflows easily. - -- **Easy to Use**: NCNN models are designed for easy integration into various applications, thanks to their compatibility with popular deep learning frameworks. Additionally, NCNN offers user-friendly tools for converting models between different formats, ensuring smooth interoperability across the development landscape. - -## Deployment Options with NCNN - -Before we look at the code for exporting YOLOv8 models to the NCNN format, let’s understand how NCNN models are normally used. - -NCNN models, designed for efficiency and performance, are compatible with a variety of deployment platforms: - -- **Mobile Deployment**: Specifically optimized for Android and iOS, allowing for seamless integration into mobile applications for efficient on-device inference. - -- **Embedded Systems and IoT Devices**: If you find that running inference on a Raspberry Pi with the [Ultralytics Guide](../guides/raspberry-pi.md) isn't fast enough, switching to an NCNN exported model could help speed things up. NCNN is great for devices like Raspberry Pi and NVIDIA Jetson, especially in situations where you need quick processing right on the device. - -- **Desktop and Server Deployment**: Capable of being deployed in desktop and server environments across Linux, Windows, and macOS, supporting development, training, and evaluation with higher computational capacities. - -## Export to NCNN: Converting Your YOLOv8 Model - -You can expand model compatibility and deployment flexibility by converting YOLOv8 models to NCNN format. - -### Installation - -To install the required packages, run: - -!!! Tip "Installation" - - === "CLI" - - ```bash - # Install the required package for YOLOv8 - pip install ultralytics - ``` - -For detailed instructions and best practices related to the installation process, check our [Ultralytics Installation guide](../quickstart.md). While installing the required packages for YOLOv8, if you encounter any difficulties, consult our [Common Issues guide](../guides/yolo-common-issues.md) for solutions and tips. - -### Usage - -Before diving into the usage instructions, it's important to note that while all [Ultralytics YOLOv8 models](../models/index.md) are available for exporting, you can ensure that the model you select supports export functionality [here](../modes/export.md). - -!!! Example "Usage" - - === "Python" - - ```python - from ultralytics import YOLO - - # Load the YOLOv8 model - model = YOLO('yolov8n.pt') - - # Export the model to NCNN format - model.export(format='ncnn') # creates '/yolov8n_ncnn_model' - - # Load the exported NCNN model - ncnn_model = YOLO('./yolov8n_ncnn_model') - - # Run inference - results = ncnn_model('https://ultralytics.com/images/bus.jpg') - ``` - - === "CLI" - - ```bash - # Export a YOLOv8n PyTorch model to NCNN format - yolo export model=yolov8n.pt format=ncnn # creates '/yolov8n_ncnn_model' - - # Run inference with the exported model - yolo predict model='./yolov8n_ncnn_model' source='https://ultralytics.com/images/bus.jpg' - ``` - -For more details about supported export options, visit the [Ultralytics documentation page on deployment options](../guides/model-deployment-options.md). - -## Deploying Exported YOLOv8 NCNN Models - -After successfully exporting your Ultralytics YOLOv8 models to NCNN format, you can now deploy them. The primary and recommended first step for running a NCNN model is to utilize the YOLO("./model_ncnn_model") method, as outlined in the previous usage code snippet. However, for in-depth instructions on deploying your NCNN models in various other settings, take a look at the following resources: - -- **[Android](https://github.com/Tencent/ncnn/wiki/how-to-build#build-for-android)**: This blog explains how to use NCNN models for performing tasks like object detection through Android applications. - -- **[macOS](https://github.com/Tencent/ncnn/wiki/how-to-build#build-for-macos)**: Understand how to use NCNN models for performing tasks through macOS. - -- **[Linux](https://github.com/Tencent/ncnn/wiki/how-to-build#build-for-linux)**: Explore this page to learn how to deploy NCNN models on limited resource devices like Raspberry Pi and other similar devices. - -- **[Windows x64 using VS2017](https://github.com/Tencent/ncnn/wiki/how-to-build#build-for-windows-x64-using-visual-studio-community-2017)**: Explore this blog to learn how to deploy NCNN models on windows x64 using Visual Studio Community 2017. - -## Summary - -In this guide, we've gone over exporting Ultralytics YOLOv8 models to the NCNN format. This conversion step is crucial for improving the efficiency and speed of YOLOv8 models, making them more effective and suitable for limited-resource computing environments. - -For detailed instructions on usage, please refer to the [official NCNN documentation](https://ncnn.readthedocs.io/en/latest/index.html). - -Also, if you're interested in exploring other integration options for Ultralytics YOLOv8, be sure to visit our [integration guide page](index.md) for further insights and information. diff --git a/ultralytics-main/docs/en/integrations/neural-magic.md b/ultralytics-main/docs/en/integrations/neural-magic.md deleted file mode 100644 index 293c199..0000000 --- a/ultralytics-main/docs/en/integrations/neural-magic.md +++ /dev/null @@ -1,165 +0,0 @@ ---- -comments: true -description: Learn how to deploy your YOLOv8 models rapidly using Neural Magic’s DeepSparse. This guide focuses on integrating Ultralytics YOLOv8 with the DeepSparse Engine for high-speed, CPU-based inference, leveraging advanced neural network sparsity techniques. -keywords: YOLOv8, DeepSparse Engine, Ultralytics, CPU Inference, Neural Network Sparsity, Object Detection, Model Optimization ---- - -# Optimizing YOLOv8 Inferences with Neural Magic’s DeepSparse Engine - -When deploying object detection models like [Ultralytics YOLOv8](https://ultralytics.com) on various hardware, you can bump into unique issues like optimization. This is where YOLOv8’s integration with Neural Magic’s DeepSparse Engine steps in. It transforms the way YOLOv8 models are executed and enables GPU-level performance directly on CPUs. - -This guide shows you how to deploy YOLOv8 using Neural Magic's DeepSparse, how to run inferences, and also how to benchmark performance to ensure it is optimized. - -## Neural Magic’s DeepSparse - -

- Neural Magic’s DeepSparse Overview -

- -[Neural Magic’s DeepSparse](https://neuralmagic.com/deepsparse/) is an inference run-time designed to optimize the execution of neural networks on CPUs. It applies advanced techniques like sparsity, pruning, and quantization to dramatically reduce computational demands while maintaining accuracy. DeepSparse offers an agile solution for efficient and scalable neural network execution across various devices. - -## Benefits of Integrating Neural Magic’s DeepSparse with YOLOv8 - -Before diving into how to deploy YOLOV8 using DeepSparse, let’s understand the benefits of using DeepSparse. Some key advantages include: - -- **Enhanced Inference Speed**: Achieves up to 525 FPS (on YOLOv8n), significantly speeding up YOLOv8's inference capabilities compared to traditional methods. - -

- Enhanced Inference Speed -

- -- **Optimized Model Efficiency**: Uses pruning and quantization to enhance YOLOv8's efficiency, reducing model size and computational requirements while maintaining accuracy. - -

- Optimized Model Efficiency -

- -- **High Performance on Standard CPUs**: Delivers GPU-like performance on CPUs, providing a more accessible and cost-effective option for various applications. - -- **Streamlined Integration and Deployment**: Offers user-friendly tools for easy integration of YOLOv8 into applications, including image and video annotation features. - -- **Support for Various Model Types**: Compatible with both standard and sparsity-optimized YOLOv8 models, adding deployment flexibility. - -- **Cost-Effective and Scalable Solution**: Reduces operational expenses and offers scalable deployment of advanced object detection models. - -## How Does Neural Magic's DeepSparse Technology Works? - -Neural Magic’s Deep Sparse technology is inspired by the human brain’s efficiency in neural network computation. It adopts two key principles from the brain as follows: - -- **Sparsity**: The process of sparsification involves pruning redundant information from deep learning networks, leading to smaller and faster models without compromising accuracy. This technique reduces the network's size and computational needs significantly. - -- **Locality of Reference**: DeepSparse uses a unique execution method, breaking the network into Tensor Columns. These columns are executed depth-wise, fitting entirely within the CPU's cache. This approach mimics the brain's efficiency, minimizing data movement and maximizing the CPU's cache use. - -

- How Neural Magic's DeepSparse Technology Works -

- -For more details on how Neural Magic's DeepSparse technology work, check out [their blog post](https://neuralmagic.com/blog/how-neural-magics-deep-sparse-technology-works/). - -## Creating A Sparse Version of YOLOv8 Trained on a Custom Dataset - -SparseZoo, an open-source model repository by Neural Magic, offers [a collection of pre-sparsified YOLOv8 model checkpoints](https://sparsezoo.neuralmagic.com/?modelSet=computer_vision&searchModels=yolo). With SparseML, seamlessly integrated with Ultralytics, users can effortlessly fine-tune these sparse checkpoints on their specific datasets using a straightforward command-line interface. - -Checkout [Neural Magic's SparseML YOLOv8 documentation](https://github.com/neuralmagic/sparseml/tree/main/integrations/ultralytics-yolov8) for more details. - -## Usage: Deploying YOLOV8 using DeepSparse - -Deploying YOLOv8 with Neural Magic's DeepSparse involves a few straightforward steps. Before diving into the usage instructions, be sure to check out the range of [YOLOv8 models offered by Ultralytics](../models/index.md). This will help you choose the most appropriate model for your project requirements. Here's how you can get started. - -### Step 1: Installation - -To install the required packages, run: - -!!! Tip "Installation" - - === "CLI" - - ```bash - # Install the required packages - pip install deepsparse[yolov8] - ``` - -### Step 2: Exporting YOLOv8 to ONNX Format - -DeepSparse Engine requires YOLOv8 models in ONNX format. Exporting your model to this format is essential for compatibility with DeepSparse. Use the following command to export YOLOv8 models: - -!!! Tip "Model Export" - - === "CLI" - - ```bash - # Export YOLOv8 model to ONNX format - yolo task=detect mode=export model=yolov8n.pt format=onnx opset=13 - ``` - -This command will save the `yolov8n.onnx` model to your disk. - -### Step 3: Deploying and Running Inferences - -With your YOLOv8 model in ONNX format, you can deploy and run inferences using DeepSparse. This can be done easily with their intuitive Python API: - -!!! Tip "Deploying and Running Inferences" - - === "Python" - - ```python - from deepsparse import Pipeline - - # Specify the path to your YOLOv8 ONNX model - model_path = "path/to/yolov8n.onnx" - - # Set up the DeepSparse Pipeline - yolo_pipeline = Pipeline.create( - task="yolov8", - model_path=model_path - ) - - # Run the model on your images - images = ["path/to/image.jpg"] - pipeline_outputs = yolo_pipeline(images=images) - ``` - -### Step 4: Benchmarking Performance - -It's important to check that your YOLOv8 model is performing optimally on DeepSparse. You can benchmark your model's performance to analyze throughput and latency: - -!!! Tip "Benchmarking" - - === "CLI" - - ```bash - # Benchmark performance - deepsparse.benchmark model_path="path/to/yolov8n.onnx" --scenario=sync --input_shapes="[1,3,640,640]" - ``` - -### Step 5: Additional Features - -DeepSparse provides additional features for practical integration of YOLOv8 in applications, such as image annotation and dataset evaluation. - -!!! Tip "Additional Features" - - === "CLI" - - ```bash - # For image annotation - deepsparse.yolov8.annotate --source "path/to/image.jpg" --model_filepath "path/to/yolov8n.onnx" - - # For evaluating model performance on a dataset - deepsparse.yolov8.eval --model_path "path/to/yolov8n.onnx" - ``` - -Running the annotate command processes your specified image, detecting objects, and saving the annotated image with bounding boxes and classifications. The annotated image will be stored in an annotation-results folder. This helps provide a visual representation of the model's detection capabilities. - -

- Image Annotation Feature -

- -After running the eval command, you will receive detailed output metrics such as precision, recall, and mAP (mean Average Precision). This provides a comprehensive view of your model's performance on the dataset. This functionality is particularly useful for fine-tuning and optimizing your YOLOv8 models for specific use cases, ensuring high accuracy and efficiency. - -## Summary - -This guide explored integrating Ultralytics’ YOLOv8 with Neural Magic's DeepSparse Engine. It highlighted how this integration enhances YOLOv8's performance on CPU platforms, offering GPU-level efficiency and advanced neural network sparsity techniques. - -For more detailed information and advanced usage, visit [Neural Magic’s DeepSparse documentation](https://docs.neuralmagic.com/products/deepsparse/). Also, check out Neural Magic’s documentation on the integration with YOLOv8 [here](https://github.com/neuralmagic/deepsparse/tree/main/src/deepsparse/yolov8#yolov8-inference-pipelines) and watch a great session on it [here](https://www.youtube.com/watch?v=qtJ7bdt52x8). - -Additionally, for a broader understanding of various YOLOv8 integrations, visit the [Ultralytics integration guide page](../integrations/index.md), where you can discover a range of other exciting integration possibilities. diff --git a/ultralytics-main/docs/en/integrations/onnx.md b/ultralytics-main/docs/en/integrations/onnx.md deleted file mode 100644 index b869b04..0000000 --- a/ultralytics-main/docs/en/integrations/onnx.md +++ /dev/null @@ -1,134 +0,0 @@ ---- -comments: true -description: Explore how to improve your Ultralytics YOLOv8 model's performance and interoperability using the ONNX (Open Neural Network Exchange) export format that is suitable for diverse hardware and software environments. -keywords: Ultralytics, YOLOv8, ONNX Format, Export YOLOv8, CUDA Support, Model Deployment ---- - -# ONNX Export for YOLOv8 Models - -Often, when deploying computer vision models, you’ll need a model format that's both flexible and compatible with multiple platforms. - -Exporting [Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics) models to ONNX format streamlines deployment and ensures optimal performance across various environments. This guide will show you how to easily convert your YOLOv8 models to ONNX and enhance their scalability and effectiveness in real-world applications. - -## ONNX and ONNX Runtime - -[ONNX](https://onnx.ai/), which stands for Open Neural Network Exchange, is a community project that Facebook and Microsoft initially developed. The ongoing development of ONNX is a collaborative effort supported by various organizations like IBM, Amazon (through AWS), and Google. The project aims to create an open file format designed to represent machine learning models in a way that allows them to be used across different AI frameworks and hardware. - -ONNX models can be used to transition between different frameworks seamlessly. For instance, a deep learning model trained in PyTorch can be exported to ONNX format and then easily imported into TensorFlow. - -

- ONNX -

- -Alternatively, ONNX models can be used with ONNX Runtime. [ONNX Runtime](https://onnxruntime.ai/) is a versatile cross-platform accelerator for machine learning models that is compatible with frameworks like PyTorch, TensorFlow, TFLite, scikit-learn, etc. - -ONNX Runtime optimizes the execution of ONNX models by leveraging hardware-specific capabilities. This optimization allows the models to run efficiently and with high performance on various hardware platforms, including CPUs, GPUs, and specialized accelerators. - -

- ONNX with ONNX Runtime -

- -Whether used independently or in tandem with ONNX Runtime, ONNX provides a flexible solution for machine learning model deployment and compatibility. - -## Key Features of ONNX Models - -The ability of ONNX to handle various formats can be attributed to the following key features: - -- **Common Model Representation**: ONNX defines a common set of operators (like convolutions, layers, etc.) and a standard data format. When a model is converted to ONNX format, its architecture and weights are translated into this common representation. This uniformity ensures that the model can be understood by any framework that supports ONNX. - -- **Versioning and Backward Compatibility**: ONNX maintains a versioning system for its operators. This ensures that even as the standard evolves, models created in older versions remain usable. Backward compatibility is a crucial feature that prevents models from becoming obsolete quickly. - -- **Graph-based Model Representation**: ONNX represents models as computational graphs. This graph-based structure is a universal way of representing machine learning models, where nodes represent operations or computations, and edges represent the tensors flowing between them. This format is easily adaptable to various frameworks which also represent models as graphs. - -- **Tools and Ecosystem**: There is a rich ecosystem of tools around ONNX that assist in model conversion, visualization, and optimization. These tools make it easier for developers to work with ONNX models and to convert models between different frameworks seamlessly. - -## Common Usage of ONNX - -Before we jump into how to export YOLOv8 models to the ONNX format, let’s take a look at where ONNX models are usually used. - -### CPU Deployment - -ONNX models are often deployed on CPUs due to their compatibility with ONNX Runtime. This runtime is optimized for CPU execution. It significantly improves inference speed and makes real-time CPU deployments feasible. - -### Supported Deployment Options - -While ONNX models are commonly used on CPUs, they can also be deployed on the following platforms: - -- **GPU Acceleration**: ONNX fully supports GPU acceleration, particularly NVIDIA CUDA. This enables efficient execution on NVIDIA GPUs for tasks that demand high computational power. - -- **Edge and Mobile Devices**: ONNX extends to edge and mobile devices, perfect for on-device and real-time inference scenarios. It's lightweight and compatible with edge hardware. - -- **Web Browsers**: ONNX can run directly in web browsers, powering interactive and dynamic web-based AI applications. - -## Exporting YOLOv8 Models to ONNX - -You can expand model compatibility and deployment flexibility by converting YOLOv8 models to ONNX format. - -### Installation - -To install the required package, run: - -!!! Tip "Installation" - - === "CLI" - - ```bash - # Install the required package for YOLOv8 - pip install ultralytics - ``` - -For detailed instructions and best practices related to the installation process, check our [YOLOv8 Installation guide](../quickstart.md). While installing the required packages for YOLOv8, if you encounter any difficulties, consult our [Common Issues guide](../guides/yolo-common-issues.md) for solutions and tips. - -### Usage - -Before diving into the usage instructions, be sure to check out the range of [YOLOv8 models offered by Ultralytics](../models/index.md). This will help you choose the most appropriate model for your project requirements. - -!!! Example "Usage" - - === "Python" - - ```python - from ultralytics import YOLO - - # Load the YOLOv8 model - model = YOLO('yolov8n.pt') - - # Export the model to ONNX format - model.export(format='onnx') # creates 'yolov8n.onnx' - - # Load the exported ONNX model - onnx_model = YOLO('yolov8n.onnx') - - # Run inference - results = onnx_model('https://ultralytics.com/images/bus.jpg') - ``` - - === "CLI" - - ```bash - # Export a YOLOv8n PyTorch model to ONNX format - yolo export model=yolov8n.pt format=onnx # creates 'yolov8n.onnx' - - # Run inference with the exported model - yolo predict model=yolov8n.onnx source='https://ultralytics.com/images/bus.jpg' - ``` - -For more details about the export process, visit the [Ultralytics documentation page on exporting](../modes/export.md). - -## Deploying Exported YOLOv8 ONNX Models - -Once you've successfully exported your Ultralytics YOLOv8 models to ONNX format, the next step is deploying these models in various environments. For detailed instructions on deploying your ONNX models, take a look at the following resources: - -- **[ONNX Runtime Python API Documentation](https://onnxruntime.ai/docs/api/python/api_summary.html)**: This guide provides essential information for loading and running ONNX models using ONNX Runtime. - -- **[Deploying on Edge Devices](https://onnxruntime.ai/docs/tutorials/iot-edge/)**: Check out this docs page for different examples of deploying ONNX models on edge. - -- **[ONNX Tutorials on GitHub](https://github.com/onnx/tutorials)**: A collection of comprehensive tutorials that cover various aspects of using and implementing ONNX models in different scenarios. - -## Summary - -In this guide, you've learned how to export Ultralytics YOLOv8 models to ONNX format to increase their interoperability and performance across various platforms. You were also introduced to the ONNX Runtime and ONNX deployment options. - -For further details on usage, visit the [ONNX official documentation](https://onnx.ai/onnx/intro/). - -Also, if you’d like to know more about other Ultralytics YOLOv8 integrations, visit our [integration guide page](../integrations/index.md). You'll find plenty of useful resources and insights there. diff --git a/ultralytics-main/docs/en/integrations/openvino.md b/ultralytics-main/docs/en/integrations/openvino.md deleted file mode 100644 index 4234d78..0000000 --- a/ultralytics-main/docs/en/integrations/openvino.md +++ /dev/null @@ -1,284 +0,0 @@ ---- -comments: true -description: Discover the power of deploying your Ultralytics YOLOv8 model using OpenVINO format for up to 10x speedup vs PyTorch. -keywords: ultralytics docs, YOLOv8, export YOLOv8, YOLOv8 model deployment, exporting YOLOv8, OpenVINO, OpenVINO format ---- - -# Intel OpenVINO Export - -OpenVINO Ecosystem - -In this guide, we cover exporting YOLOv8 models to the [OpenVINO](https://docs.openvino.ai/) format, which can provide up to 3x [CPU](https://docs.openvino.ai/2024/openvino-workflow/running-inference/inference-devices-and-modes/cpu-device.html) speedup, as well as accelerating YOLO inference on Intel [GPU](https://docs.openvino.ai/2024/openvino-workflow/running-inference/inference-devices-and-modes/gpu-device.html) and [NPU](https://docs.openvino.ai/2024/openvino-workflow/running-inference/inference-devices-and-modes/npu-device.html) hardware. - -OpenVINO, short for Open Visual Inference & Neural Network Optimization toolkit, is a comprehensive toolkit for optimizing and deploying AI inference models. Even though the name contains Visual, OpenVINO also supports various additional tasks including language, audio, time series, etc. - -

-
- -
- Watch: How To Export and Optimize an Ultralytics YOLOv8 Model for Inference with OpenVINO. -

- -## Usage Examples - -Export a YOLOv8n model to OpenVINO format and run inference with the exported model. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a YOLOv8n PyTorch model - model = YOLO('yolov8n.pt') - - # Export the model - model.export(format='openvino') # creates 'yolov8n_openvino_model/' - - # Load the exported OpenVINO model - ov_model = YOLO('yolov8n_openvino_model/') - - # Run inference - results = ov_model('https://ultralytics.com/images/bus.jpg') - ``` - === "CLI" - - ```bash - # Export a YOLOv8n PyTorch model to OpenVINO format - yolo export model=yolov8n.pt format=openvino # creates 'yolov8n_openvino_model/' - - # Run inference with the exported model - yolo predict model=yolov8n_openvino_model source='https://ultralytics.com/images/bus.jpg' - ``` - -## Arguments - -| Key | Value | Description | -|----------|--------------|------------------------------------------------------| -| `format` | `'openvino'` | format to export to | -| `imgsz` | `640` | image size as scalar or (h, w) list, i.e. (640, 480) | -| `half` | `False` | FP16 quantization | - -## Benefits of OpenVINO - -1. **Performance**: OpenVINO delivers high-performance inference by utilizing the power of Intel CPUs, integrated and discrete GPUs, and FPGAs. -2. **Support for Heterogeneous Execution**: OpenVINO provides an API to write once and deploy on any supported Intel hardware (CPU, GPU, FPGA, VPU, etc.). -3. **Model Optimizer**: OpenVINO provides a Model Optimizer that imports, converts, and optimizes models from popular deep learning frameworks such as PyTorch, TensorFlow, TensorFlow Lite, Keras, ONNX, PaddlePaddle, and Caffe. -4. **Ease of Use**: The toolkit comes with more than [80 tutorial notebooks](https://github.com/openvinotoolkit/openvino_notebooks) (including [YOLOv8 optimization](https://github.com/openvinotoolkit/openvino_notebooks/tree/main/notebooks/230-yolov8-optimization)) teaching different aspects of the toolkit. - -## OpenVINO Export Structure - -When you export a model to OpenVINO format, it results in a directory containing the following: - -1. **XML file**: Describes the network topology. -2. **BIN file**: Contains the weights and biases binary data. -3. **Mapping file**: Holds mapping of original model output tensors to OpenVINO tensor names. - -You can use these files to run inference with the OpenVINO Inference Engine. - -## Using OpenVINO Export in Deployment - -Once you have the OpenVINO files, you can use the OpenVINO Runtime to run the model. The Runtime provides a unified API to inference across all supported Intel hardware. It also provides advanced capabilities like load balancing across Intel hardware and asynchronous execution. For more information on running the inference, refer to the [Inference with OpenVINO Runtime Guide](https://docs.openvino.ai/2024/openvino-workflow/running-inference.html). - -Remember, you'll need the XML and BIN files as well as any application-specific settings like input size, scale factor for normalization, etc., to correctly set up and use the model with the Runtime. - -In your deployment application, you would typically do the following steps: - -1. Initialize OpenVINO by creating `core = Core()`. -2. Load the model using the `core.read_model()` method. -3. Compile the model using the `core.compile_model()` function. -4. Prepare the input (image, text, audio, etc.). -5. Run inference using `compiled_model(input_data)`. - -For more detailed steps and code snippets, refer to the [OpenVINO documentation](https://docs.openvino.ai/) or [API tutorial](https://github.com/openvinotoolkit/openvino_notebooks/blob/main/notebooks/002-openvino-api/002-openvino-api.ipynb). - -## OpenVINO YOLOv8 Benchmarks - -YOLOv8 benchmarks below were run by the Ultralytics team on 4 different model formats measuring speed and accuracy: PyTorch, TorchScript, ONNX and OpenVINO. Benchmarks were run on Intel Flex and Arc GPUs, and on Intel Xeon CPUs at FP32 precision (with the `half=False` argument). - -!!! Note - - The benchmarking results below are for reference and might vary based on the exact hardware and software configuration of a system, as well as the current workload of the system at the time the benchmarks are run. - - All benchmarks run with `openvino` Python package version [2023.0.1](https://pypi.org/project/openvino/2023.0.1/). - -### Intel Flex GPU - -The Intel® Data Center GPU Flex Series is a versatile and robust solution designed for the intelligent visual cloud. This GPU supports a wide array of workloads including media streaming, cloud gaming, AI visual inference, and virtual desktop Infrastructure workloads. It stands out for its open architecture and built-in support for the AV1 encode, providing a standards-based software stack for high-performance, cross-architecture applications. The Flex Series GPU is optimized for density and quality, offering high reliability, availability, and scalability. - -Benchmarks below run on Intel® Data Center GPU Flex 170 at FP32 precision. - -
-Flex GPU benchmarks -
- -| Model | Format | Status | Size (MB) | mAP50-95(B) | Inference time (ms/im) | -|---------|-------------|--------|-----------|-------------|------------------------| -| YOLOv8n | PyTorch | ✅ | 6.2 | 0.3709 | 21.79 | -| YOLOv8n | TorchScript | ✅ | 12.4 | 0.3704 | 23.24 | -| YOLOv8n | ONNX | ✅ | 12.2 | 0.3704 | 37.22 | -| YOLOv8n | OpenVINO | ✅ | 12.3 | 0.3703 | 3.29 | -| YOLOv8s | PyTorch | ✅ | 21.5 | 0.4471 | 31.89 | -| YOLOv8s | TorchScript | ✅ | 42.9 | 0.4472 | 32.71 | -| YOLOv8s | ONNX | ✅ | 42.8 | 0.4472 | 43.42 | -| YOLOv8s | OpenVINO | ✅ | 42.9 | 0.4470 | 3.92 | -| YOLOv8m | PyTorch | ✅ | 49.7 | 0.5013 | 50.75 | -| YOLOv8m | TorchScript | ✅ | 99.2 | 0.4999 | 47.90 | -| YOLOv8m | ONNX | ✅ | 99.0 | 0.4999 | 63.16 | -| YOLOv8m | OpenVINO | ✅ | 49.8 | 0.4997 | 7.11 | -| YOLOv8l | PyTorch | ✅ | 83.7 | 0.5293 | 77.45 | -| YOLOv8l | TorchScript | ✅ | 167.2 | 0.5268 | 85.71 | -| YOLOv8l | ONNX | ✅ | 166.8 | 0.5268 | 88.94 | -| YOLOv8l | OpenVINO | ✅ | 167.0 | 0.5264 | 9.37 | -| YOLOv8x | PyTorch | ✅ | 130.5 | 0.5404 | 100.09 | -| YOLOv8x | TorchScript | ✅ | 260.7 | 0.5371 | 114.64 | -| YOLOv8x | ONNX | ✅ | 260.4 | 0.5371 | 110.32 | -| YOLOv8x | OpenVINO | ✅ | 260.6 | 0.5367 | 15.02 | - -This table represents the benchmark results for five different models (YOLOv8n, YOLOv8s, YOLOv8m, YOLOv8l, YOLOv8x) across four different formats (PyTorch, TorchScript, ONNX, OpenVINO), giving us the status, size, mAP50-95(B) metric, and inference time for each combination. - -### Intel Arc GPU - -Intel® Arc™ represents Intel's foray into the dedicated GPU market. The Arc™ series, designed to compete with leading GPU manufacturers like AMD and Nvidia, caters to both the laptop and desktop markets. The series includes mobile versions for compact devices like laptops, and larger, more powerful versions for desktop computers. - -The Arc™ series is divided into three categories: Arc™ 3, Arc™ 5, and Arc™ 7, with each number indicating the performance level. Each category includes several models, and the 'M' in the GPU model name signifies a mobile, integrated variant. - -Early reviews have praised the Arc™ series, particularly the integrated A770M GPU, for its impressive graphics performance. The availability of the Arc™ series varies by region, and additional models are expected to be released soon. Intel® Arc™ GPUs offer high-performance solutions for a range of computing needs, from gaming to content creation. - -Benchmarks below run on Intel® Arc 770 GPU at FP32 precision. - -
-Arc GPU benchmarks -
- -| Model | Format | Status | Size (MB) | metrics/mAP50-95(B) | Inference time (ms/im) | -|---------|-------------|--------|-----------|---------------------|------------------------| -| YOLOv8n | PyTorch | ✅ | 6.2 | 0.3709 | 88.79 | -| YOLOv8n | TorchScript | ✅ | 12.4 | 0.3704 | 102.66 | -| YOLOv8n | ONNX | ✅ | 12.2 | 0.3704 | 57.98 | -| YOLOv8n | OpenVINO | ✅ | 12.3 | 0.3703 | 8.52 | -| YOLOv8s | PyTorch | ✅ | 21.5 | 0.4471 | 189.83 | -| YOLOv8s | TorchScript | ✅ | 42.9 | 0.4472 | 227.58 | -| YOLOv8s | ONNX | ✅ | 42.7 | 0.4472 | 142.03 | -| YOLOv8s | OpenVINO | ✅ | 42.9 | 0.4469 | 9.19 | -| YOLOv8m | PyTorch | ✅ | 49.7 | 0.5013 | 411.64 | -| YOLOv8m | TorchScript | ✅ | 99.2 | 0.4999 | 517.12 | -| YOLOv8m | ONNX | ✅ | 98.9 | 0.4999 | 298.68 | -| YOLOv8m | OpenVINO | ✅ | 99.1 | 0.4996 | 12.55 | -| YOLOv8l | PyTorch | ✅ | 83.7 | 0.5293 | 725.73 | -| YOLOv8l | TorchScript | ✅ | 167.1 | 0.5268 | 892.83 | -| YOLOv8l | ONNX | ✅ | 166.8 | 0.5268 | 576.11 | -| YOLOv8l | OpenVINO | ✅ | 167.0 | 0.5262 | 17.62 | -| YOLOv8x | PyTorch | ✅ | 130.5 | 0.5404 | 988.92 | -| YOLOv8x | TorchScript | ✅ | 260.7 | 0.5371 | 1186.42 | -| YOLOv8x | ONNX | ✅ | 260.4 | 0.5371 | 768.90 | -| YOLOv8x | OpenVINO | ✅ | 260.6 | 0.5367 | 19 | - -### Intel Xeon CPU - -The Intel® Xeon® CPU is a high-performance, server-grade processor designed for complex and demanding workloads. From high-end cloud computing and virtualization to artificial intelligence and machine learning applications, Xeon® CPUs provide the power, reliability, and flexibility required for today's data centers. - -Notably, Xeon® CPUs deliver high compute density and scalability, making them ideal for both small businesses and large enterprises. By choosing Intel® Xeon® CPUs, organizations can confidently handle their most demanding computing tasks and foster innovation while maintaining cost-effectiveness and operational efficiency. - -Benchmarks below run on 4th Gen Intel® Xeon® Scalable CPU at FP32 precision. - -
-Xeon CPU benchmarks -
- -| Model | Format | Status | Size (MB) | metrics/mAP50-95(B) | Inference time (ms/im) | -|---------|-------------|--------|-----------|---------------------|------------------------| -| YOLOv8n | PyTorch | ✅ | 6.2 | 0.3709 | 24.36 | -| YOLOv8n | TorchScript | ✅ | 12.4 | 0.3704 | 23.93 | -| YOLOv8n | ONNX | ✅ | 12.2 | 0.3704 | 39.86 | -| YOLOv8n | OpenVINO | ✅ | 12.3 | 0.3704 | 11.34 | -| YOLOv8s | PyTorch | ✅ | 21.5 | 0.4471 | 33.77 | -| YOLOv8s | TorchScript | ✅ | 42.9 | 0.4472 | 34.84 | -| YOLOv8s | ONNX | ✅ | 42.8 | 0.4472 | 43.23 | -| YOLOv8s | OpenVINO | ✅ | 42.9 | 0.4471 | 13.86 | -| YOLOv8m | PyTorch | ✅ | 49.7 | 0.5013 | 53.91 | -| YOLOv8m | TorchScript | ✅ | 99.2 | 0.4999 | 53.51 | -| YOLOv8m | ONNX | ✅ | 99.0 | 0.4999 | 64.16 | -| YOLOv8m | OpenVINO | ✅ | 99.1 | 0.4996 | 28.79 | -| YOLOv8l | PyTorch | ✅ | 83.7 | 0.5293 | 75.78 | -| YOLOv8l | TorchScript | ✅ | 167.2 | 0.5268 | 79.13 | -| YOLOv8l | ONNX | ✅ | 166.8 | 0.5268 | 88.45 | -| YOLOv8l | OpenVINO | ✅ | 167.0 | 0.5263 | 56.23 | -| YOLOv8x | PyTorch | ✅ | 130.5 | 0.5404 | 96.60 | -| YOLOv8x | TorchScript | ✅ | 260.7 | 0.5371 | 114.28 | -| YOLOv8x | ONNX | ✅ | 260.4 | 0.5371 | 111.02 | -| YOLOv8x | OpenVINO | ✅ | 260.6 | 0.5371 | 83.28 | - -### Intel Core CPU - -The Intel® Core® series is a range of high-performance processors by Intel. The lineup includes Core i3 (entry-level), Core i5 (mid-range), Core i7 (high-end), and Core i9 (extreme performance). Each series caters to different computing needs and budgets, from everyday tasks to demanding professional workloads. With each new generation, improvements are made to performance, energy efficiency, and features. - -Benchmarks below run on 13th Gen Intel® Core® i7-13700H CPU at FP32 precision. - -
-Core CPU benchmarks -
- -| Model | Format | Status | Size (MB) | metrics/mAP50-95(B) | Inference time (ms/im) | -|---------|-------------|--------|-----------|---------------------|------------------------| -| YOLOv8n | PyTorch | ✅ | 6.2 | 0.4478 | 104.61 | -| YOLOv8n | TorchScript | ✅ | 12.4 | 0.4525 | 112.39 | -| YOLOv8n | ONNX | ✅ | 12.2 | 0.4525 | 28.02 | -| YOLOv8n | OpenVINO | ✅ | 12.3 | 0.4504 | 23.53 | -| YOLOv8s | PyTorch | ✅ | 21.5 | 0.5885 | 194.83 | -| YOLOv8s | TorchScript | ✅ | 43.0 | 0.5962 | 202.01 | -| YOLOv8s | ONNX | ✅ | 42.8 | 0.5962 | 65.74 | -| YOLOv8s | OpenVINO | ✅ | 42.9 | 0.5966 | 38.66 | -| YOLOv8m | PyTorch | ✅ | 49.7 | 0.6101 | 355.23 | -| YOLOv8m | TorchScript | ✅ | 99.2 | 0.6120 | 424.78 | -| YOLOv8m | ONNX | ✅ | 99.0 | 0.6120 | 173.39 | -| YOLOv8m | OpenVINO | ✅ | 99.1 | 0.6091 | 69.80 | -| YOLOv8l | PyTorch | ✅ | 83.7 | 0.6591 | 593.00 | -| YOLOv8l | TorchScript | ✅ | 167.2 | 0.6580 | 697.54 | -| YOLOv8l | ONNX | ✅ | 166.8 | 0.6580 | 342.15 | -| YOLOv8l | OpenVINO | ✅ | 167.0 | 0.0708 | 117.69 | -| YOLOv8x | PyTorch | ✅ | 130.5 | 0.6651 | 804.65 | -| YOLOv8x | TorchScript | ✅ | 260.8 | 0.6650 | 921.46 | -| YOLOv8x | ONNX | ✅ | 260.4 | 0.6650 | 526.66 | -| YOLOv8x | OpenVINO | ✅ | 260.6 | 0.6619 | 158.73 | - -## Reproduce Our Results - -To reproduce the Ultralytics benchmarks above on all export [formats](../modes/export.md) run this code: - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a YOLOv8n PyTorch model - model = YOLO('yolov8n.pt') - - # Benchmark YOLOv8n speed and accuracy on the COCO128 dataset for all all export formats - results= model.benchmarks(data='coco128.yaml') - ``` - === "CLI" - - ```bash - # Benchmark YOLOv8n speed and accuracy on the COCO128 dataset for all all export formats - yolo benchmark model=yolov8n.pt data=coco128.yaml - ``` - - Note that benchmarking results might vary based on the exact hardware and software configuration of a system, as well as the current workload of the system at the time the benchmarks are run. For the most reliable results use a dataset with a large number of images, i.e. `data='coco128.yaml' (128 val images), or `data='coco.yaml'` (5000 val images). - -## Conclusion - -The benchmarking results clearly demonstrate the benefits of exporting the YOLOv8 model to the OpenVINO format. Across different models and hardware platforms, the OpenVINO format consistently outperforms other formats in terms of inference speed while maintaining comparable accuracy. - -For the Intel® Data Center GPU Flex Series, the OpenVINO format was able to deliver inference speeds almost 10 times faster than the original PyTorch format. On the Xeon CPU, the OpenVINO format was twice as fast as the PyTorch format. The accuracy of the models remained nearly identical across the different formats. - -The benchmarks underline the effectiveness of OpenVINO as a tool for deploying deep learning models. By converting models to the OpenVINO format, developers can achieve significant performance improvements, making it easier to deploy these models in real-world applications. - -For more detailed information and instructions on using OpenVINO, refer to the [official OpenVINO documentation](https://docs.openvino.ai/). diff --git a/ultralytics-main/docs/en/integrations/paddlepaddle.md b/ultralytics-main/docs/en/integrations/paddlepaddle.md deleted file mode 100644 index f41116f..0000000 --- a/ultralytics-main/docs/en/integrations/paddlepaddle.md +++ /dev/null @@ -1,122 +0,0 @@ ---- -comments: true -description: This guide explains how to export Ultralytics YOLOv8 models to the PaddlePaddle format for wide device support and harnessing the power of Baidu's ML framework. -keywords: Ultralytics, YOLOv8, PaddlePaddle Export, Model Deployment, Flexible Deployment, Industrial-Grade Deep Learning, Baidu, Cross-Platform Compatibility ---- - -# How to Export to PaddlePaddle Format from YOLOv8 Models - -Bridging the gap between developing and deploying computer vision models in real-world scenarios with varying conditions can be difficult. PaddlePaddle makes this process easier with its focus on flexibility, performance, and its capability for parallel processing in distributed environments. This means you can use your YOLOv8 computer vision models on a wide variety of devices and platforms, from smartphones to cloud-based servers. - -The ability to export to PaddlePaddle model format allows you to optimize your [Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics) models for use within the PaddlePaddle framework. PaddlePaddle is known for facilitating industrial deployments and is a good choice for deploying computer vision applications in real-world settings across various domains. - -## Why should you export to PaddlePaddle? - -

- PaddlePaddle Logo -

- -Developed by Baidu, [PaddlePaddle](https://www.paddlepaddle.org.cn/en) (**PA**rallel **D**istributed **D**eep **LE**arning) is China's first open-source deep learning platform. Unlike some frameworks built mainly for research, PaddlePaddle prioritizes ease of use and smooth integration across industries. - -It offers tools and resources similar to popular frameworks like TensorFlow and PyTorch, making it accessible for developers of all experience levels. From farming and factories to service businesses, PaddlePaddle's large developer community of over 4.77 million is helping create and deploy AI applications. - -By exporting your Ultralytics YOLOv8 models to PaddlePaddle format, you can tap into PaddlePaddle’s strengths in performance optimization. PaddlePaddle prioritizes efficient model execution and reduced memory usage. As a result, your YOLOv8 models can potentially achieve even better performance, delivering top-notch results in practical scenarios. - -## Key Features of PaddlePaddle Models - -PaddlePaddle models offer a range of key features that contribute to their flexibility, performance, and scalability across diverse deployment scenarios: - - - **Dynamic-to-Static Graph**: PaddlePaddle supports [dynamic-to-static compilation](https://www.paddlepaddle.org.cn/documentation/docs/en/guides/jit/index_en.html), where models can be translated into a static computational graph. This enables optimizations that reduce runtime overhead and boost inference performance. - - - **Operator Fusion**: PaddlePaddle, like TensorRT, uses [operator fusion](https://developer.nvidia.com/gtc/2020/video/s21436-vid) to streamline computation and reduce overhead. The framework minimizes memory transfers and computational steps by merging compatible operations, resulting in faster inference. - - - **Quantization**: PaddlePaddle supports [quantization techniques](https://www.paddlepaddle.org.cn/documentation/docs/en/api/paddle/quantization/PTQ_en.html), including post-training quantization and quantization-aware training. These techniques allow for the use of lower-precision data representations, effectively boosting performance and reducing model size. - -## Deployment Options in PaddlePaddle - -Before diving into the code for exporting YOLOv8 models to PaddlePaddle, let's take a look at the different deployment scenarios in which PaddlePaddle models excel. - -PaddlePaddle provides a range of options, each offering a distinct balance of ease of use, flexibility, and performance: - -- **Paddle Serving**: This framework simplifies the deployment of PaddlePaddle models as high-performance RESTful APIs. Paddle Serving is ideal for production environments, providing features like model versioning, online A/B testing, and scalability for handling large volumes of requests. - -- **Paddle Inference API**: The Paddle Inference API gives you low-level control over model execution. This option is well-suited for scenarios where you need to integrate the model tightly within a custom application or optimize performance for specific hardware. - -- **Paddle Lite**: Paddle Lite is designed for deployment on mobile and embedded devices where resources are limited. It optimizes models for smaller sizes and faster inference on ARM CPUs, GPUs, and other specialized hardware. - -- **Paddle.js**: Paddle.js enables you to deploy PaddlePaddle models directly within web browsers. Paddle.js can either load a pre-trained model or transform a model from [paddle-hub](https://github.com/PaddlePaddle/PaddleHub) with model transforming tools provided by Paddle.js. It can run in browsers that support WebGL/WebGPU/WebAssembly. - -## Export to PaddlePaddle: Converting Your YOLOv8 Model - -Converting YOLOv8 models to the PaddlePaddle format can improve execution flexibility and optimize performance for various deployment scenarios. - -### Installation - -To install the required package, run: - -!!! Tip "Installation" - - === "CLI" - - ```bash - # Install the required package for YOLOv8 - pip install ultralytics - ``` - -For detailed instructions and best practices related to the installation process, check our [Ultralytics Installation guide](../quickstart.md). While installing the required packages for YOLOv8, if you encounter any difficulties, consult our [Common Issues guide](../guides/yolo-common-issues.md) for solutions and tips. - -### Usage - -Before diving into the usage instructions, it's important to note that while all [Ultralytics YOLOv8 models](../models/index.md) are available for exporting, you can ensure that the model you select supports export functionality [here](../modes/export.md). - -!!! Example "Usage" - - === "Python" - - ```python - from ultralytics import YOLO - - # Load the YOLOv8 model - model = YOLO('yolov8n.pt') - - # Export the model to PaddlePaddle format - model.export(format='paddle') # creates '/yolov8n_paddle_model' - - # Load the exported PaddlePaddle model - paddle_model = YOLO('./yolov8n_paddle_model') - - # Run inference - results = paddle_model('https://ultralytics.com/images/bus.jpg') - ``` - - === "CLI" - - ```bash - # Export a YOLOv8n PyTorch model to PaddlePaddle format - yolo export model=yolov8n.pt format=paddle # creates '/yolov8n_paddle_model' - - # Run inference with the exported model - yolo predict model='./yolov8n_paddle_model' source='https://ultralytics.com/images/bus.jpg' - ``` - -For more details about supported export options, visit the [Ultralytics documentation page on deployment options](../guides/model-deployment-options.md). - -## Deploying Exported YOLOv8 PaddlePaddle Models - -After successfully exporting your Ultralytics YOLOv8 models to PaddlePaddle format, you can now deploy them. The primary and recommended first step for running a PaddlePaddle model is to use the YOLO("./model_paddle_model") method, as outlined in the previous usage code snippet. - -However, for in-depth instructions on deploying your PaddlePaddle models in various other settings, take a look at the following resources: - -- **[Paddle Serving](https://github.com/PaddlePaddle/Serving/blob/v0.9.0/README_CN.md)**: Learn how to deploy your PaddlePaddle models as performant services using Paddle Serving. - -- **[Paddle Lite](https://github.com/PaddlePaddle/Paddle-Lite/blob/develop/README_en.md)**: Explore how to optimize and deploy models on mobile and embedded devices using Paddle Lite. - -- **[Paddle.js](https://github.com/PaddlePaddle/Paddle.js)**: Discover how to run PaddlePaddle models in web browsers for client-side AI using Paddle.js. - -## Summary - -In this guide, we explored the process of exporting Ultralytics YOLOv8 models to the PaddlePaddle format. By following these steps, you can leverage PaddlePaddle's strengths in diverse deployment scenarios, optimizing your models for different hardware and software environments. - -For further details on usage, visit the [PaddlePaddle official documentation](https://www.paddlepaddle.org.cn/documentation/docs/en/guides/index_en.html) - -Want to explore more ways to integrate your Ultralytics YOLOv8 models? Our [integration guide page](index.md) explores various options, equipping you with valuable resources and insights. diff --git a/ultralytics-main/docs/en/integrations/ray-tune.md b/ultralytics-main/docs/en/integrations/ray-tune.md deleted file mode 100644 index 3825cf7..0000000 --- a/ultralytics-main/docs/en/integrations/ray-tune.md +++ /dev/null @@ -1,179 +0,0 @@ ---- -comments: true -description: Discover how to streamline hyperparameter tuning for YOLOv8 models with Ray Tune. Learn to accelerate tuning, integrate with Weights & Biases, and analyze results. -keywords: Ultralytics, YOLOv8, Ray Tune, hyperparameter tuning, machine learning optimization, Weights & Biases integration, result analysis ---- - -# Efficient Hyperparameter Tuning with Ray Tune and YOLOv8 - -Hyperparameter tuning is vital in achieving peak model performance by discovering the optimal set of hyperparameters. This involves running trials with different hyperparameters and evaluating each trial’s performance. - -## Accelerate Tuning with Ultralytics YOLOv8 and Ray Tune - -[Ultralytics YOLOv8](https://ultralytics.com) incorporates Ray Tune for hyperparameter tuning, streamlining the optimization of YOLOv8 model hyperparameters. With Ray Tune, you can utilize advanced search strategies, parallelism, and early stopping to expedite the tuning process. - -### Ray Tune - -

- Ray Tune Overview -

- -[Ray Tune](https://docs.ray.io/en/latest/tune/index.html) is a hyperparameter tuning library designed for efficiency and flexibility. It supports various search strategies, parallelism, and early stopping strategies, and seamlessly integrates with popular machine learning frameworks, including Ultralytics YOLOv8. - -### Integration with Weights & Biases - -YOLOv8 also allows optional integration with [Weights & Biases](https://wandb.ai/site) for monitoring the tuning process. - -## Installation - -To install the required packages, run: - -!!! Tip "Installation" - - === "CLI" - - ```bash - # Install and update Ultralytics and Ray Tune packages - pip install -U ultralytics "ray[tune]" - - # Optionally install W&B for logging - pip install wandb - ``` - -## Usage - -!!! Example "Usage" - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a YOLOv8n model - model = YOLO('yolov8n.pt') - - # Start tuning hyperparameters for YOLOv8n training on the COCO8 dataset - result_grid = model.tune(data='coco8.yaml', use_ray=True) - ``` - -## `tune()` Method Parameters - -The `tune()` method in YOLOv8 provides an easy-to-use interface for hyperparameter tuning with Ray Tune. It accepts several arguments that allow you to customize the tuning process. Below is a detailed explanation of each parameter: - -| Parameter | Type | Description | Default Value | -|-----------------|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------| -| `data` | `str` | The dataset configuration file (in YAML format) to run the tuner on. This file should specify the training and validation data paths, as well as other dataset-specific settings. | | -| `space` | `dict, optional` | A dictionary defining the hyperparameter search space for Ray Tune. Each key corresponds to a hyperparameter name, and the value specifies the range of values to explore during tuning. If not provided, YOLOv8 uses a default search space with various hyperparameters. | | -| `grace_period` | `int, optional` | The grace period in epochs for the [ASHA scheduler](https://docs.ray.io/en/latest/tune/api/schedulers.html) in Ray Tune. The scheduler will not terminate any trial before this number of epochs, allowing the model to have some minimum training before making a decision on early stopping. | 10 | -| `gpu_per_trial` | `int, optional` | The number of GPUs to allocate per trial during tuning. This helps manage GPU usage, particularly in multi-GPU environments. If not provided, the tuner will use all available GPUs. | None | -| `iterations` | `int, optional` | The maximum number of trials to run during tuning. This parameter helps control the total number of hyperparameter combinations tested, ensuring the tuning process does not run indefinitely. | 10 | -| `**train_args` | `dict, optional` | Additional arguments to pass to the `train()` method during tuning. These arguments can include settings like the number of training epochs, batch size, and other training-specific configurations. | {} | - -By customizing these parameters, you can fine-tune the hyperparameter optimization process to suit your specific needs and available computational resources. - -## Default Search Space Description - -The following table lists the default search space parameters for hyperparameter tuning in YOLOv8 with Ray Tune. Each parameter has a specific value range defined by `tune.uniform()`. - -| Parameter | Value Range | Description | -|-------------------|----------------------------|------------------------------------------| -| `lr0` | `tune.uniform(1e-5, 1e-1)` | Initial learning rate | -| `lrf` | `tune.uniform(0.01, 1.0)` | Final learning rate factor | -| `momentum` | `tune.uniform(0.6, 0.98)` | Momentum | -| `weight_decay` | `tune.uniform(0.0, 0.001)` | Weight decay | -| `warmup_epochs` | `tune.uniform(0.0, 5.0)` | Warmup epochs | -| `warmup_momentum` | `tune.uniform(0.0, 0.95)` | Warmup momentum | -| `box` | `tune.uniform(0.02, 0.2)` | Box loss weight | -| `cls` | `tune.uniform(0.2, 4.0)` | Class loss weight | -| `hsv_h` | `tune.uniform(0.0, 0.1)` | Hue augmentation range | -| `hsv_s` | `tune.uniform(0.0, 0.9)` | Saturation augmentation range | -| `hsv_v` | `tune.uniform(0.0, 0.9)` | Value (brightness) augmentation range | -| `degrees` | `tune.uniform(0.0, 45.0)` | Rotation augmentation range (degrees) | -| `translate` | `tune.uniform(0.0, 0.9)` | Translation augmentation range | -| `scale` | `tune.uniform(0.0, 0.9)` | Scaling augmentation range | -| `shear` | `tune.uniform(0.0, 10.0)` | Shear augmentation range (degrees) | -| `perspective` | `tune.uniform(0.0, 0.001)` | Perspective augmentation range | -| `flipud` | `tune.uniform(0.0, 1.0)` | Vertical flip augmentation probability | -| `fliplr` | `tune.uniform(0.0, 1.0)` | Horizontal flip augmentation probability | -| `mosaic` | `tune.uniform(0.0, 1.0)` | Mosaic augmentation probability | -| `mixup` | `tune.uniform(0.0, 1.0)` | Mixup augmentation probability | -| `copy_paste` | `tune.uniform(0.0, 1.0)` | Copy-paste augmentation probability | - -## Custom Search Space Example - -In this example, we demonstrate how to use a custom search space for hyperparameter tuning with Ray Tune and YOLOv8. By providing a custom search space, you can focus the tuning process on specific hyperparameters of interest. - -!!! Example "Usage" - - ```python - from ultralytics import YOLO - - # Define a YOLO model - model = YOLO("yolov8n.pt") - - # Run Ray Tune on the model - result_grid = model.tune(data="coco128.yaml", - space={"lr0": tune.uniform(1e-5, 1e-1)}, - epochs=50, - use_ray=True) - ``` - -In the code snippet above, we create a YOLO model with the "yolov8n.pt" pretrained weights. Then, we call the `tune()` method, specifying the dataset configuration with "coco128.yaml". We provide a custom search space for the initial learning rate `lr0` using a dictionary with the key "lr0" and the value `tune.uniform(1e-5, 1e-1)`. Finally, we pass additional training arguments, such as the number of epochs directly to the tune method as `epochs=50`. - -## Processing Ray Tune Results - -After running a hyperparameter tuning experiment with Ray Tune, you might want to perform various analyses on the obtained results. This guide will take you through common workflows for processing and analyzing these results. - -### Loading Tune Experiment Results from a Directory - -After running the tuning experiment with `tuner.fit()`, you can load the results from a directory. This is useful, especially if you're performing the analysis after the initial training script has exited. - -```python -experiment_path = f"{storage_path}/{exp_name}" -print(f"Loading results from {experiment_path}...") - -restored_tuner = tune.Tuner.restore(experiment_path, trainable=train_mnist) -result_grid = restored_tuner.get_results() -``` - -### Basic Experiment-Level Analysis - -Get an overview of how trials performed. You can quickly check if there were any errors during the trials. - -```python -if result_grid.errors: - print("One or more trials failed!") -else: - print("No errors!") -``` - -### Basic Trial-Level Analysis - -Access individual trial hyperparameter configurations and the last reported metrics. - -```python -for i, result in enumerate(result_grid): - print(f"Trial #{i}: Configuration: {result.config}, Last Reported Metrics: {result.metrics}") -``` - -### Plotting the Entire History of Reported Metrics for a Trial - -You can plot the history of reported metrics for each trial to see how the metrics evolved over time. - -```python -import matplotlib.pyplot as plt - -for result in result_grid: - plt.plot(result.metrics_dataframe["training_iteration"], result.metrics_dataframe["mean_accuracy"], label=f"Trial {i}") - -plt.xlabel('Training Iterations') -plt.ylabel('Mean Accuracy') -plt.legend() -plt.show() -``` - -## Summary - -In this documentation, we covered common workflows to analyze the results of experiments run with Ray Tune using Ultralytics. The key steps include loading the experiment results from a directory, performing basic experiment-level and trial-level analysis and plotting metrics. - -Explore further by looking into Ray Tune’s [Analyze Results](https://docs.ray.io/en/latest/tune/examples/tune_analyze_results.html) docs page to get the most out of your hyperparameter tuning experiments. diff --git a/ultralytics-main/docs/en/integrations/roboflow.md b/ultralytics-main/docs/en/integrations/roboflow.md deleted file mode 100644 index 9d19c8f..0000000 --- a/ultralytics-main/docs/en/integrations/roboflow.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -comments: true -description: Learn how to use Roboflow with Ultralytics for labeling and managing images for use in training, and for evaluating model performance. -keywords: Ultralytics, YOLOv8, Roboflow, vector analysis, confusion matrix, data management, image labeling ---- - -# Roboflow - -[Roboflow](https://roboflow.com/?ref=ultralytics) has everything you need to build and deploy computer vision models. Connect Roboflow at any step in your pipeline with APIs and SDKs, or use the end-to-end interface to automate the entire process from image to inference. Whether you’re in need of [data labeling](https://roboflow.com/annotate?ref=ultralytics), [model training](https://roboflow.com/train?ref=ultralytics), or [model deployment](https://roboflow.com/deploy?ref=ultralytics), Roboflow gives you building blocks to bring custom computer vision solutions to your project. - -!!! Question "Licensing" - - Ultralytics offers two licensing options: - - - The [AGPL-3.0 License](https://github.com/ultralytics/ultralytics/blob/main/LICENSE), an [OSI-approved](https://opensource.org/licenses/) open-source license ideal for students and enthusiasts. - - The [Enterprise License](https://ultralytics.com/license) for businesses seeking to incorporate our AI models into their products and services. - - For more details see [Ultralytics Licensing](https://ultralytics.com/license). - -In this guide, we are going to showcase how to find, label, and organize data for use in training a custom Ultralytics YOLOv8 model. Use the table of contents below to jump directly to a specific section: - -- Gather data for training a custom YOLOv8 model -- Upload, convert and label data for YOLOv8 format -- Pre-process and augment data for model robustness -- Dataset management for [YOLOv8](https://docs.ultralytics.com/models/yolov8/) -- Export data in 40+ formats for model training -- Upload custom YOLOv8 model weights for testing and deployment -- Gather Data for Training a Custom YOLOv8 Model - -Roboflow provides two services that can help you collect data for YOLOv8 models: [Universe](https://universe.roboflow.com/?ref=ultralytics) and [Collect](https://roboflow.com/collect?ref=ultralytics). - -Universe is an online repository with over 250,000 vision datasets totalling over 100 million images. - -

-Roboflow Universe -

- -With a [free Roboflow account](https://app.roboflow.com/?ref=ultralytics), you can export any dataset available on Universe. To export a dataset, click the "Download this Dataset" button on any dataset. - -

-Roboflow Universe dataset export -

- -For YOLOv8, select "YOLOv8" as the export format: - -

-Roboflow Universe dataset export -

- -Universe also has a page that aggregates all [public fine-tuned YOLOv8 models uploaded to Roboflow](https://universe.roboflow.com/search?q=model:yolov8). You can use this page to explore pre-trained models you can use for testing or [for automated data labeling](https://docs.roboflow.com/annotate/use-roboflow-annotate/model-assisted-labeling) or to prototype with [Roboflow inference](https://roboflow.com/inference?ref=ultralytics). - -If you want to gather images yourself, try [Collect](https://github.com/roboflow/roboflow-collect), an open source project that allows you to automatically gather images using a webcam on the edge. You can use text or image prompts with Collect to instruct what data should be collected, allowing you to capture only the useful data you need to build your vision model. - -## Upload, Convert and Label Data for YOLOv8 Format - -[Roboflow Annotate](https://docs.roboflow.com/annotate/use-roboflow-annotate) is an online annotation tool for use in labeling images for object detection, classification, and segmentation. - -To label data for a YOLOv8 object detection, instance segmentation, or classification model, first create a project in Roboflow. - -

-Create a Roboflow project -

- -Next, upload your images, and any pre-existing annotations you have from other tools ([using one of the 40+ supported import formats](https://roboflow.com/formats?ref=ultralytics)), into Roboflow. - -

-Upload images to Roboflow -

- -Select the batch of images you have uploaded on the Annotate page to which you are taken after uploading images. Then, click "Start Annotating" to label images. - -To label with bounding boxes, press the `B` key on your keyboard or click the box icon in the sidebar. Click on a point where you want to start your bounding box, then drag to create the box: - -

-Annotating an image in Roboflow -

- -A pop-up will appear asking you to select a class for your annotation once you have created an annotation. - -To label with polygons, press the `P` key on your keyboard, or the polygon icon in the sidebar. With the polygon annotation tool enabled, click on individual points in the image to draw a polygon. - -Roboflow offers a SAM-based label assistant with which you can label images faster than ever. SAM (Segment Anything Model) is a state-of-the-art computer vision model that can precisely label images. With SAM, you can significantly speed up the image labeling process. Annotating images with polygons becomes as simple as a few clicks, rather than the tedious process of precisely clicking points around an object. - -To use the label assistant, click the cursor icon in the sidebar, SAM will be loaded for use in your project. - -

-Annotating an image in Roboflow with SAM-powered label assist -

- -Hover over any object in the image and SAM will recommend an annotation. You can hover to find the right place to annotate, then click to create your annotation. To amend your annotation to be more or less specific, you can click inside or outside the annotation SAM has created on the document. - -You can also add tags to images from the Tags panel in the sidebar. You can apply tags to data from a particular area, taken from a specific camera, and more. You can then use these tags to search through data for images matching a tag and generate versions of a dataset with images that contain a particular tag or set of tags. - -

-Adding tags to an image in Roboflow -

- -Models hosted on Roboflow can be used with Label Assist, an automated annotation tool that uses your YOLOv8 model to recommend annotations. To use Label Assist, first upload a YOLOv8 model to Roboflow (see instructions later in the guide). Then, click the magic wand icon in the left sidebar and select your model for use in Label Assist. - -Choose a model, then click "Continue" to enable Label Assist: - -

-Enabling Label Assist -

- -When you open new images for annotation, Label Assist will trigger and recommend annotations. - -

-ALabel Assist recommending an annotation -

- -## Dataset Management for YOLOv8 - -Roboflow provides a suite of tools for understanding computer vision datasets. - -First, you can use dataset search to find images that meet a semantic text description (i.e. find all images that contain people), or that meet a specified label (i.e. the image is associated with a specific tag). To use dataset search, click "Dataset" in the sidebar. Then, input a search query using the search bar and associated filters at the top of the page. - -For example, the following text query finds images that contain people in a dataset: - -

-Searching for an image -

- -You can narrow your search to images with a particular tag using the "Tags" selector: - -

-Filter images by tag -

- -Before you start training a model with your dataset, we recommend using Roboflow [Health Check](https://docs.roboflow.com/datasets/dataset-health-check), a web tool that provides an insight into your dataset and how you can improve the dataset prior to training a vision model. - -To use Health Check, click the "Health Check" sidebar link. A list of statistics will appear that show the average size of images in your dataset, class balance, a heatmap of where annotations are in your images, and more. - -

-Roboflow Health Check analysis -

- -Health Check may recommend changes to help enhance dataset performance. For example, the class balance feature may show that there is an imbalance in labels that, if solved, may boost performance or your model. - -## Export Data in 40+ Formats for Model Training - -To export your data, you will need a dataset version. A version is a state of your dataset frozen-in-time. To create a version, first click "Versions" in the sidebar. Then, click the "Create New Version" button. On this page, you will be able to choose augmentations and preprocessing steps to apply to your dataset: - -

-Creating a dataset version on Roboflow -

- -For each augmentation you select, a pop-up will appear allowing you to tune the augmentation to your needs. Here is an example of tuning a brightness augmentation within specified parameters: - -

-Applying augmentations to a dataset -

- -When your dataset version has been generated, you can export your data into a range of formats. Click the "Export Dataset" button on your dataset version page to export your data: - -

-Exporting a dataset -

- -You are now ready to train YOLOv8 on a custom dataset. Follow this [written guide](https://blog.roboflow.com/how-to-train-yolov8-on-a-custom-dataset/) and [YouTube video](https://www.youtube.com/watch?v=wuZtUMEiKWY) for step-by-step instructions or refer to the [Ultralytics documentation](https://docs.ultralytics.com/modes/train/). - -## Upload Custom YOLOv8 Model Weights for Testing and Deployment - -Roboflow offers an infinitely scalable API for deployed models and SDKs for use with NVIDIA Jetsons, Luxonis OAKs, Raspberry Pis, GPU-based devices, and more. - -You can deploy YOLOv8 models by uploading YOLOv8 weights to Roboflow. You can do this in a few lines of Python code. Create a new Python file and add the following code: - -```python -import roboflow # install with 'pip install roboflow' - -roboflow.login() - -rf = roboflow.Roboflow() - -project = rf.workspace(WORKSPACE_ID).project("football-players-detection-3zvbc") -dataset = project.version(VERSION).download("yolov8") - -project.version(dataset.version).deploy(model_type="yolov8", model_path=f"{HOME}/runs/detect/train/") -``` - -In this code, replace the project ID and version ID with the values for your account and project. [Learn how to retrieve your Roboflow API key](https://docs.roboflow.com/api-reference/authentication#retrieve-an-api-key). - -When you run the code above, you will be asked to authenticate. Then, your model will be uploaded and an API will be created for your project. This process can take up to 30 minutes to complete. - -To test your model and find deployment instructions for supported SDKs, go to the "Deploy" tab in the Roboflow sidebar. At the top of this page, a widget will appear with which you can test your model. You can use your webcam for live testing or upload images or videos. - -

-Running inference on an example image -

- -You can also use your uploaded model as a [labeling assistant](https://docs.roboflow.com/annotate/use-roboflow-annotate/model-assisted-labeling). This feature uses your trained model to recommend annotations on images uploaded to Roboflow. - -## How to Evaluate YOLOv8 Models - -Roboflow provides a range of features for use in evaluating models. - -Once you have uploaded a model to Roboflow, you can access our model evaluation tool, which provides a confusion matrix showing the performance of your model as well as an interactive vector analysis plot. These features can help you find opportunities to improve your model. - -To access a confusion matrix, go to your model page on the Roboflow dashboard, then click "View Detailed Evaluation": - -

-Start a Roboflow model evaluation -

- -A pop-up will appear showing a confusion matrix: - -

-A confusion matrix -

- -Hover over a box on the confusion matrix to see the value associated with the box. Click on a box to see images in the respective category. Click on an image to view the model predictions and ground truth data associated with that image. - -For more insights, click Vector Analysis. This will show a scatter plot of the images in your dataset, calculated using CLIP. The closer images are in the plot, the more similar they are, semantically. Each image is represented as a dot with a color between white and red. The more red the dot, the worse the model performed. - -

-A vector analysis plot -

- -You can use Vector Analysis to: - -- Find clusters of images; -- Identify clusters where the model performs poorly, and; -- Visualize commonalities between images on which the model performs poorly. - -## Learning Resources - -Want to learn more about using Roboflow for creating YOLOv8 models? The following resources may be helpful in your work. - -- [Train YOLOv8 on a Custom Dataset](https://github.com/roboflow/notebooks/blob/main/notebooks/train-yolov8-object-detection-on-custom-dataset.ipynb): Follow our interactive notebook that shows you how to train a YOLOv8 model on a custom dataset. -- [Autodistill](https://autodistill.github.io/autodistill/): Use large foundation vision models to label data for specific models. You can label images for use in training YOLOv8 classification, detection, and segmentation models with Autodistill. -- [Supervision](https://roboflow.github.io/supervision/): A Python package with helpful utilities for use in working with computer vision models. You can use supervision to filter detections, compute confusion matrices, and more, all in a few lines of Python code. -- [Roboflow Blog](https://blog.roboflow.com/): The Roboflow Blog features over 500 articles on computer vision, covering topics from how to train a YOLOv8 model to annotation best practices. -- [Roboflow YouTube channel](https://www.youtube.com/@Roboflow): Browse dozens of in-depth computer vision guides on our YouTube channel, covering topics from training YOLOv8 models to automated image labeling. - -## Project Showcase - -Below are a few of the many pieces of feedback we have received for using YOLOv8 and Roboflow together to create computer vision models. - -

-Showcase image -Showcase image -Showcase image -

diff --git a/ultralytics-main/docs/en/integrations/tensorboard.md b/ultralytics-main/docs/en/integrations/tensorboard.md deleted file mode 100644 index 5e0cbf1..0000000 --- a/ultralytics-main/docs/en/integrations/tensorboard.md +++ /dev/null @@ -1,153 +0,0 @@ ---- -comments: true -description: Walk through the integration of YOLOv8 with TensorBoard to be able to use TensorFlow's visualization toolkit for enhanced model training analysis, offering capabilities like metric tracking, model graph visualization, and more. -keywords: TensorBoard, YOLOv8, Visualization, TensorFlow, Training Analysis, Metric Tracking, Model Graphs, Experimentation, Ultralytics ---- - -# Gain Visual Insights with YOLOv8’s Integration with TensorBoard - -Understanding and fine-tuning computer vision models like [Ultralytics’ YOLOv8](https://ultralytics.com) becomes more straightforward when you take a closer look at their training processes. Model training visualization helps with getting insights into the model's learning patterns, performance metrics, and overall behavior. YOLOv8's integration with TensorBoard makes this process of visualization and analysis easier and enables more efficient and informed adjustments to the model. - -This guide covers how to use TensorBoard with YOLOv8. You'll learn about various visualizations, from tracking metrics to analyzing model graphs. These tools will help you understand your YOLOv8 model's performance better. - -## TensorBoard - -

- Tensorboard Overview -

- -[TensorBoard](https://www.tensorflow.org/tensorboard), TensorFlow's visualization toolkit, is essential for machine learning experimentation. TensorBoard features a range of visualization tools, crucial for monitoring machine learning models. These tools include tracking key metrics like loss and accuracy, visualizing model graphs, and viewing histograms of weights and biases over time. It also provides capabilities for projecting embeddings to lower-dimensional spaces and displaying multimedia data. - -## YOLOv8 Training with TensorBoard - -Using TensorBoard while training YOLOv8 models is straightforward and offers significant benefits. - -## Installation - -To install the required package, run: - -!!! Tip "Installation" - - === "CLI" - - ```bash - # Install the required package for YOLOv8 and Tensorboard - pip install ultralytics - ``` - -TensorBoard is conveniently pre-installed with YOLOv8, eliminating the need for additional setup for visualization purposes. - -For detailed instructions and best practices related to the installation process, be sure to check our [YOLOv8 Installation guide](../quickstart.md). While installing the required packages for YOLOv8, if you encounter any difficulties, consult our [Common Issues guide](../guides/yolo-common-issues.md) for solutions and tips. - -## Configuring TensorBoard for Google Collab - -When using Google Colab, it's important to set up TensorBoard before starting your training code: - -!!! Example "Configure TensorBoard for Google Collab" - - === "Python" - - ```python - %load_ext tensorboard - %tensorboard --logdir path/to/runs - ``` - -## Usage - -Before diving into the usage instructions, be sure to check out the range of [YOLOv8 models offered by Ultralytics](../models/index.md). This will help you choose the most appropriate model for your project requirements. - -!!! Example "Usage" - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a pre-trained model - model = YOLO('yolov8n.pt') - - # Train the model - results = model.train(data='coco128.yaml', epochs=100, imgsz=640) - ``` - -Upon running the usage code snippet above, you can expect the following output: - -```plaintext -TensorBoard: Start with 'tensorboard --logdir path_to_your_tensorboard_logs', view at http://localhost:6006/ -``` - -This output indicates that TensorBoard is now actively monitoring your YOLOv8 training session. You can access the TensorBoard dashboard by visiting the provided URL (http://localhost:6006/) to view real-time training metrics and model performance. For users working in Google Colab, the TensorBoard will be displayed in the same cell where you executed the TensorBoard configuration commands. - -For more information related to the model training process, be sure to check our [YOLOv8 Model Training guide](../modes/train.md). If you are interested in learning more about logging, checkpoints, plotting, and file management, read our [usage guide on configuration](../usage/cfg.md). - -## Understanding Your TensorBoard for YOLOv8 Training - -Now, let’s focus on understanding the various features and components of TensorBoard in the context of YOLOv8 training. The three key sections of the TensorBoard are Time Series, Scalars, and Graphs. - -### Time Series - -The Time Series feature in the TensorBoard offers a dynamic and detailed perspective of various training metrics over time for YOLOv8 models. It focuses on the progression and trends of metrics across training epochs. Here's an example of what you can expect to see. - -![image](https://github.com/ultralytics/ultralytics/assets/25847604/20b3e038-0356-465e-a37e-1ea232c68354) - -#### Key Features of Time Series in TensorBoard - -- **Filter Tags and Pinned Cards**: This functionality allows users to filter specific metrics and pin cards for quick comparison and access. It's particularly useful for focusing on specific aspects of the training process. - -- **Detailed Metric Cards**: Time Series divides metrics into different categories like learning rate (lr), training (train), and validation (val) metrics, each represented by individual cards. - -- **Graphical Display**: Each card in the Time Series section shows a detailed graph of a specific metric over the course of training. This visual representation aids in identifying trends, patterns, or anomalies in the training process. - -- **In-Depth Analysis**: Time Series provides an in-depth analysis of each metric. For instance, different learning rate segments are shown, offering insights into how adjustments in learning rate impact the model's learning curve. - -#### Importance of Time Series in YOLOv8 Training - -The Time Series section is essential for a thorough analysis of the YOLOv8 model's training progress. It lets you track the metrics in real time to promptly identify and solve issues. It also offers a detailed view of each metric's progression, which is crucial for fine-tuning the model and enhancing its performance. - -### Scalars - -Scalars in the TensorBoard are crucial for plotting and analyzing simple metrics like loss and accuracy during the training of YOLOv8 models. They offer a clear and concise view of how these metrics evolve with each training epoch, providing insights into the model's learning effectiveness and stability. Here's an example of what you can expect to see. - -![image](https://github.com/ultralytics/ultralytics/assets/25847604/f9228193-13e9-4768-9edf-8fa15ecd24fa) - -#### Key Features of Scalars in TensorBoard - -- **Learning Rate (lr) Tags**: These tags show the variations in the learning rate across different segments (e.g., `pg0`, `pg1`, `pg2`). This helps us understand the impact of learning rate adjustments on the training process. - -- **Metrics Tags**: Scalars include performance indicators such as: - - - `mAP50 (B)`: Mean Average Precision at 50% Intersection over Union (IoU), crucial for assessing object detection accuracy. - - - `mAP50-95 (B)`: Mean Average Precision calculated over a range of IoU thresholds, offering a more comprehensive evaluation of accuracy. - - - `Precision (B)`: Indicates the ratio of correctly predicted positive observations, key to understanding prediction accuracy. - - - `Recall (B)`: Important for models where missing a detection is significant, this metric measures the ability to detect all relevant instances. - - - To learn more about the different metrics, read our guide on [performance metrics](../guides/yolo-performance-metrics.md). - -- **Training and Validation Tags (`train`, `val`)**: These tags display metrics specifically for the training and validation datasets, allowing for a comparative analysis of model performance across different data sets. - -#### Importance of Monitoring Scalars - -Observing scalar metrics is crucial for fine-tuning the YOLOv8 model. Variations in these metrics, such as spikes or irregular patterns in loss graphs, can highlight potential issues such as overfitting, underfitting, or inappropriate learning rate settings. By closely monitoring these scalars, you can make informed decisions to optimize the training process, ensuring that the model learns effectively and achieves the desired performance. - -### Difference Between Scalars and Time Series - -While both Scalars and Time Series in TensorBoard are used for tracking metrics, they serve slightly different purposes. Scalars focus on plotting simple metrics such as loss and accuracy as scalar values. They provide a high-level overview of how these metrics change with each training epoch. While, the time-series section of the TensorBoard offers a more detailed timeline view of various metrics. It is particularly useful for monitoring the progression and trends of metrics over time, providing a deeper dive into the specifics of the training process. - -### Graphs - -The Graphs section of the TensorBoard visualizes the computational graph of the YOLOv8 model, showing how operations and data flow within the model. It's a powerful tool for understanding the model's structure, ensuring that all layers are connected correctly, and for identifying any potential bottlenecks in data flow. Here's an example of what you can expect to see. - -![image](https://github.com/ultralytics/ultralytics/assets/25847604/039028e0-4ab3-4170-bfa8-f93ce483f615) - -Graphs are particularly useful for debugging the model, especially in complex architectures typical in deep learning models like YOLOv8. They help in verifying layer connections and the overall design of the model. - -## Summary - -This guide aims to help you use TensorBoard with YOLOv8 for visualization and analysis of machine learning model training. It focuses on explaining how key TensorBoard features can provide insights into training metrics and model performance during YOLOv8 training sessions. - -For a more detailed exploration of these features and effective utilization strategies, you can refer to TensorFlow’s official [TensorBoard documentation](https://www.tensorflow.org/tensorboard/get_started) and their [GitHub repository](https://github.com/tensorflow/tensorboard). - -Want to learn more about the various integrations of Ultralytics? Check out the [Ultralytics integrations guide page](../integrations/index.md) to see what other exciting capabilities are waiting to be discovered! diff --git a/ultralytics-main/docs/en/integrations/tensorrt.md b/ultralytics-main/docs/en/integrations/tensorrt.md deleted file mode 100644 index aa89675..0000000 --- a/ultralytics-main/docs/en/integrations/tensorrt.md +++ /dev/null @@ -1,128 +0,0 @@ ---- -comments: true -description: Discover the power and flexibility of exporting Ultralytics YOLOv8 models to TensorRT format for enhanced performance and efficiency on NVIDIA GPUs. -keywords: Ultralytics, YOLOv8, TensorRT Export, Model Deployment, GPU Acceleration, NVIDIA Support, CUDA Deployment ---- - -# TensorRT Export for YOLOv8 Models - -Deploying computer vision models in high-performance environments can require a format that maximizes speed and efficiency. This is especially true when you are deploying your model on NVIDIA GPUs. - -By using the TensorRT export format, you can enhance your [Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics) models for swift and efficient inference on NVIDIA hardware. This guide will give you easy-to-follow steps for the conversion process and help you make the most of NVIDIA's advanced technology in your deep learning projects. - -## TensorRT - -

- TensorRT Overview -

- -[TensorRT](https://developer.nvidia.com/tensorrt), developed by NVIDIA, is an advanced software development kit (SDK) designed for high-speed deep learning inference. It’s well-suited for real-time applications like object detection. - -This toolkit optimizes deep learning models for NVIDIA GPUs and results in faster and more efficient operations. TensorRT models undergo TensorRT optimization, which includes techniques like layer fusion, precision calibration (INT8 and FP16), dynamic tensor memory management, and kernel auto-tuning. Converting deep learning models into the TensorRT format allows developers to realize the potential of NVIDIA GPUs fully. - -TensorRT is known for its compatibility with various model formats, including TensorFlow, PyTorch, and ONNX, providing developers with a flexible solution for integrating and optimizing models from different frameworks. This versatility enables efficient model deployment across diverse hardware and software environments. - -## Key Features of TensorRT Models - -TensorRT models offer a range of key features that contribute to their efficiency and effectiveness in high-speed deep learning inference: - -- **Precision Calibration**: TensorRT supports precision calibration, allowing models to be fine-tuned for specific accuracy requirements. This includes support for reduced precision formats like INT8 and FP16, which can further boost inference speed while maintaining acceptable accuracy levels. - -- **Layer Fusion**: The TensorRT optimization process includes layer fusion, where multiple layers of a neural network are combined into a single operation. This reduces computational overhead and improves inference speed by minimizing memory access and computation. - -

- TensorRT Layer Fusion -

- -- **Dynamic Tensor Memory Management**: TensorRT efficiently manages tensor memory usage during inference, reducing memory overhead and optimizing memory allocation. This results in more efficient GPU memory utilization. - -- **Automatic Kernel Tuning**: TensorRT applies automatic kernel tuning to select the most optimized GPU kernel for each layer of the model. This adaptive approach ensures that the model takes full advantage of the GPU's computational power. - -## Deployment Options in TensorRT - -Before we look at the code for exporting YOLOv8 models to the TensorRT format, let’s understand where TensorRT models are normally used. - -TensorRT offers several deployment options, and each option balances ease of integration, performance optimization, and flexibility differently: - -- **Deploying within TensorFlow**: This method integrates TensorRT into TensorFlow, allowing optimized models to run in a familiar TensorFlow environment. It's useful for models with a mix of supported and unsupported layers, as TF-TRT can handle these efficiently. - -

- TensorRT Overview -

- -- **Standalone TensorRT Runtime API**: Offers granular control, ideal for performance-critical applications. It's more complex but allows for custom implementation of unsupported operators. - -- **NVIDIA Triton Inference Server**: An option that supports models from various frameworks. Particularly suited for cloud or edge inference, it provides features like concurrent model execution and model analysis. - -## Exporting YOLOv8 Models to TensorRT - -You can improve execution efficiency and optimize performance by converting YOLOv8 models to TensorRT format. - -### Installation - -To install the required package, run: - -!!! Tip "Installation" - - === "CLI" - - ```bash - # Install the required package for YOLOv8 - pip install ultralytics - ``` - -For detailed instructions and best practices related to the installation process, check our [YOLOv8 Installation guide](../quickstart.md). While installing the required packages for YOLOv8, if you encounter any difficulties, consult our [Common Issues guide](../guides/yolo-common-issues.md) for solutions and tips. - -### Usage - -Before diving into the usage instructions, be sure to check out the range of [YOLOv8 models offered by Ultralytics](../models/index.md). This will help you choose the most appropriate model for your project requirements. - -!!! Example "Usage" - - === "Python" - - ```python - from ultralytics import YOLO - - # Load the YOLOv8 model - model = YOLO('yolov8n.pt') - - # Export the model to TensorRT format - model.export(format='engine') # creates 'yolov8n.engine' - - # Load the exported TensorRT model - tensorrt_model = YOLO('yolov8n.engine') - - # Run inference - results = tensorrt_model('https://ultralytics.com/images/bus.jpg') - ``` - - === "CLI" - - ```bash - # Export a YOLOv8n PyTorch model to TensorRT format - yolo export model=yolov8n.pt format=engine # creates 'yolov8n.engine'' - - # Run inference with the exported model - yolo predict model=yolov8n.engine source='https://ultralytics.com/images/bus.jpg' - ``` - -For more details about the export process, visit the [Ultralytics documentation page on exporting](../modes/export.md). - -## Deploying Exported YOLOv8 TensorRT Models - -Having successfully exported your Ultralytics YOLOv8 models to TensorRT format, you're now ready to deploy them. For in-depth instructions on deploying your TensorRT models in various settings, take a look at the following resources: - -- **[Deploying Deep Neural Networks with NVIDIA TensorRT](https://developer.nvidia.com/blog/deploying-deep-learning-nvidia-tensorrt/)**: This article explains how to use NVIDIA TensorRT to deploy deep neural networks on GPU-based deployment platforms efficiently. - -- **[End-to-End AI for NVIDIA-Based PCs: NVIDIA TensorRT Deployment](https://developer.nvidia.com/blog/end-to-end-ai-for-nvidia-based-pcs-nvidia-tensorrt-deployment/)**: This blog post explains the use of NVIDIA TensorRT for optimizing and deploying AI models on NVIDIA-based PCs. - -- **[GitHub Repository for NVIDIA TensorRT:](https://github.com/NVIDIA/TensorRT)**: This is the official GitHub repository that contains the source code and documentation for NVIDIA TensorRT. - -## Summary - -In this guide, we focused on converting Ultralytics YOLOv8 models to NVIDIA's TensorRT model format. This conversion step is crucial for improving the efficiency and speed of YOLOv8 models, making them more effective and suitable for diverse deployment environments. - -For more information on usage details, take a look at the [TensorRT official documentation](https://docs.nvidia.com/deeplearning/tensorrt/). - -If you're curious about additional Ultralytics YOLOv8 integrations, our [integration guide page](../integrations/index.md) provides an extensive selection of informative resources and insights. diff --git a/ultralytics-main/docs/en/integrations/tflite.md b/ultralytics-main/docs/en/integrations/tflite.md deleted file mode 100644 index 03fe156..0000000 --- a/ultralytics-main/docs/en/integrations/tflite.md +++ /dev/null @@ -1,122 +0,0 @@ ---- -comments: true -description: Explore how to improve your Ultralytics YOLOv8 model's performance and interoperability using the TFLite export format suitable for edge computing environments. -keywords: Ultralytics, YOLOv8, TFLite Export, Export YOLOv8, Model Deployment ---- - -# A Guide on YOLOv8 Model Export to TFLite for Deployment - -

- TFLite Logo -

- -Deploying computer vision models on edge devices or embedded devices requires a format that can ensure seamless performance. - -The TensorFlow Lite or TFLite export format allows you to optimize your [Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics) models for tasks like object detection and image classification in edge device-based applications. In this guide, we'll walk through the steps for converting your models to the TFLite format, making it easier for your models to perform well on various edge devices. - -## Why should you export to TFLite? - -Introduced by Google in May 2017 as part of their TensorFlow framework, [TensorFlow Lite](https://www.tensorflow.org/lite/guide), or TFLite for short, is an open-source deep learning framework designed for on-device inference, also known as edge computing. It gives developers the necessary tools to execute their trained models on mobile, embedded, and IoT devices, as well as traditional computers. - -TensorFlow Lite is compatible with a wide range of platforms, including embedded Linux, Android, iOS, and MCU. Exporting your model to TFLite makes your applications faster, more reliable, and capable of running offline. - -## Key Features of TFLite Models - -TFLite models offer a wide range of key features that enable on-device machine learning by helping developers run their models on mobile, embedded, and edge devices: - -- **On-device Optimization**: TFLite optimizes for on-device ML, reducing latency by processing data locally, enhancing privacy by not transmitting personal data, and minimizing model size to save space. - -- **Multiple Platform Support**: TFLite offers extensive platform compatibility, supporting Android, iOS, embedded Linux, and microcontrollers. - -- **Diverse Language Support**: TFLite is compatible with various programming languages, including Java, Swift, Objective-C, C++, and Python. - -- **High Performance**: Achieves superior performance through hardware acceleration and model optimization. - -## Deployment Options in TFLite - -Before we look at the code for exporting YOLOv8 models to the TFLite format, let’s understand how TFLite models are normally used. - -TFLite offers various on-device deployment options for machine learning models, including: - -- **Deploying with Android and iOS**: Both Android and iOS applications with TFLite can analyze edge-based camera feeds and sensors to detect and identify objects. TFLite also offers native iOS libraries written in [Swift](https://github.com/tensorflow/tensorflow/tree/master/tensorflow/lite/swift) and [Objective-C](https://github.com/tensorflow/tensorflow/tree/master/tensorflow/lite/objc). The architecture diagram below shows the process of deploying a trained model onto Android and iOS platforms using TensorFlow Lite. - -

- Architecture -

- -- **Implementing with Embedded Linux**: If running inferences on a [Raspberry Pi](https://www.raspberrypi.org/) using the [Ultralytics Guide](../guides/raspberry-pi.md) does not meet the speed requirements for your use case, you can use an exported TFLite model to accelerate inference times. Additionally, it's possible to further improve performance by utilizing a [Coral Edge TPU device](https://coral.withgoogle.com/). - -- **Deploying with Microcontrollers**: TFLite models can also be deployed on microcontrollers and other devices with only a few kilobytes of memory. The core runtime just fits in 16 KB on an Arm Cortex M3 and can run many basic models. It doesn't require operating system support, any standard C or C++ libraries, or dynamic memory allocation. - -## Export to TFLite: Converting Your YOLOv8 Model - -You can improve on-device model execution efficiency and optimize performance by converting them to TFLite format. - -### Installation - -To install the required packages, run: - -!!! Tip "Installation" - - === "CLI" - - ```bash - # Install the required package for YOLOv8 - pip install ultralytics - ``` - -For detailed instructions and best practices related to the installation process, check our [Ultralytics Installation guide](../quickstart.md). While installing the required packages for YOLOv8, if you encounter any difficulties, consult our [Common Issues guide](../guides/yolo-common-issues.md) for solutions and tips. - -### Usage - -Before diving into the usage instructions, it's important to note that while all [Ultralytics YOLOv8 models](../models/index.md) are available for exporting, you can ensure that the model you select supports export functionality [here](../modes/export.md). - -!!! Example "Usage" - - === "Python" - - ```python - from ultralytics import YOLO - - # Load the YOLOv8 model - model = YOLO('yolov8n.pt') - - # Export the model to TFLite format - model.export(format='tflite') # creates 'yolov8n_float32.tflite' - - # Load the exported TFLite model - tflite_model = YOLO('yolov8n_float32.tflite') - - # Run inference - results = tflite_model('https://ultralytics.com/images/bus.jpg') - ``` - - === "CLI" - - ```bash - # Export a YOLOv8n PyTorch model to TFLite format - yolo export model=yolov8n.pt format=tflite # creates 'yolov8n_float32.tflite' - - # Run inference with the exported model - yolo predict model='yolov8n_float32.tflite' source='https://ultralytics.com/images/bus.jpg' - ``` - -For more details about the export process, visit the [Ultralytics documentation page on exporting](../modes/export.md). - -## Deploying Exported YOLOv8 TFLite Models - -After successfully exporting your Ultralytics YOLOv8 models to TFLite format, you can now deploy them. The primary and recommended first step for running a TFLite model is to utilize the YOLO("model.tflite") method, as outlined in the previous usage code snippet. However, for in-depth instructions on deploying your TFLite models in various other settings, take a look at the following resources: - -- **[Android](https://www.tensorflow.org/lite/android/quickstart)**: A quick start guide for integrating TensorFlow Lite into Android applications, providing easy-to-follow steps for setting up and running machine learning models. - -- **[iOS](https://www.tensorflow.org/lite/guide/ios)**: Check out this detailed guide for developers on integrating and deploying TensorFlow Lite models in iOS applications, offering step-by-step instructions and resources. - -- **[End-To-End Examples](https://www.tensorflow.org/lite/examples)**: This page provides an overview of various TensorFlow Lite examples, showcasing practical applications and tutorials designed to help developers implement TensorFlow Lite in their machine learning projects on mobile and edge devices. - -## Summary - -In this guide, we focused on how to export to TFLite format. By converting your Ultralytics YOLOv8 models to TFLite model format, you can improve the efficiency and speed of YOLOv8 models, making them more effective and suitable for edge computing environments. - -For further details on usage, visit [TFLite’s official documentation](https://www.tensorflow.org/lite/guide). - -Also, if you're curious about other Ultralytics YOLOv8 integrations, make sure to check out our [integration guide page](../integrations/index.md). You'll find tons of helpful info and insights waiting for you there. diff --git a/ultralytics-main/docs/en/integrations/torchscript.md b/ultralytics-main/docs/en/integrations/torchscript.md deleted file mode 100644 index f050986..0000000 --- a/ultralytics-main/docs/en/integrations/torchscript.md +++ /dev/null @@ -1,126 +0,0 @@ ---- -comments: true -description: Learn to export your Ultralytics YOLOv8 models to TorchScript format for deployment through platforms like embedded systems, web browsers, and C++ applications. -keywords: Ultralytics, YOLOv8, Export to Torchscript, Model Optimization, Deployment, PyTorch, C++, Faster Inference ---- - -# YOLOv8 Model Export to TorchScript for Quick Deployment - -Deploying computer vision models across different environments, including embedded systems, web browsers, or platforms with limited Python support, requires a flexible and portable solution. TorchScript focuses on portability and the ability to run models in environments where the entire Python framework is unavailable. This makes it ideal for scenarios where you need to deploy your computer vision capabilities across various devices or platforms. - -Export to Torchscript to serialize your [Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics) models for cross-platform compatibility and streamlined deployment. In this guide, we'll show you how to export your YOLOv8 models to the TorchScript format, making it easier for you to use them across a wider range of applications. - -## Why should you export to TorchScript? - -![Torchscript Overview](https://github.com/ultralytics/ultralytics/assets/26833433/6873349d-c2f6-4620-b3cc-7b26b0698d0b) - -Developed by the creators of PyTorch, TorchScript is a powerful tool for optimizing and deploying PyTorch models across a variety of platforms. Exporting YOLOv8 models to [TorchScript](https://pytorch.org/docs/stable/jit.html) is crucial for moving from research to real-world applications. TorchScript, part of the PyTorch framework, helps make this transition smoother by allowing PyTorch models to be used in environments that don't support Python. - -The process involves two techniques: tracing and scripting. Tracing records operations during model execution, while scripting allows for the definition of models using a subset of Python. These techniques ensure that models like YOLOv8 can still work their magic even outside their usual Python environment. - -![TorchScript Script and Trace](https://github.com/ultralytics/ultralytics/assets/26833433/ea9ea24f-a3a9-44bb-aca7-9c358d7490d7) - -TorchScript models can also be optimized through techniques such as operator fusion and refinements in memory usage, ensuring efficient execution. Another advantage of exporting to TorchScript is its potential to accelerate model execution across various hardware platforms. It creates a standalone, production-ready representation of your PyTorch model that can be integrated into C++ environments, embedded systems, or deployed in web or mobile applications. - -## Key Features of TorchScript Models - -TorchScript, a key part of the PyTorch ecosystem, provides powerful features for optimizing and deploying deep learning models. - -![TorchScript Features](https://github.com/ultralytics/ultralytics/assets/26833433/44c7c5e3-1146-42db-952a-9060f070fead) - -Here are the key features that make TorchScript a valuable tool for developers: - -- **Static Graph Execution**: TorchScript uses a static graph representation of the model’s computation, which is different from PyTorch’s dynamic graph execution. In static graph execution, the computational graph is defined and compiled once before the actual execution, resulting in improved performance during inference. - -- **Model Serialization**: TorchScript allows you to serialize PyTorch models into a platform-independent format. Serialized models can be loaded without requiring the original Python code, enabling deployment in different runtime environments. - -- **JIT Compilation**: TorchScript uses Just-In-Time (JIT) compilation to convert PyTorch models into an optimized intermediate representation. JIT compiles the model’s computational graph, enabling efficient execution on target devices. - -- **Cross-Language Integration**: With TorchScript, you can export PyTorch models to other languages such as C++, Java, and JavaScript. This makes it easier to integrate PyTorch models into existing software systems written in different languages. - -- **Gradual Conversion**: TorchScript provides a gradual conversion approach, allowing you to incrementally convert parts of your PyTorch model into TorchScript. This flexibility is particularly useful when dealing with complex models or when you want to optimize specific portions of the code. - -## Deployment Options in TorchScript - -Before we look at the code for exporting YOLOv8 models to the TorchScript format, let’s understand where TorchScript models are normally used. - -TorchScript offers various deployment options for machine learning models, such as: - -- **C++ API**: The most common use case for TorchScript is its C++ API, which allows you to load and execute optimized TorchScript models directly within C++ applications. This is ideal for production environments where Python may not be suitable or available. The C++ API offers low-overhead and efficient execution of TorchScript models, maximizing performance potential. - -- **Mobile Deployment**: TorchScript offers tools for converting models into formats readily deployable on mobile devices. PyTorch Mobile provides a runtime for executing these models within iOS and Android apps. This enables low-latency, offline inference capabilities, enhancing user experience and data privacy. - -- **Cloud Deployment**: TorchScript models can be deployed to cloud-based servers using solutions like TorchServe. It provides features like model versioning, batching, and metrics monitoring for scalable deployment in production environments. Cloud deployment with TorchScript can make your models accessible via APIs or other web services. - -## Export to TorchScript: Converting Your YOLOv8 Model - -Exporting YOLOv8 models to TorchScript makes it easier to use them in different places and helps them run faster and more efficiently. This is great for anyone looking to use deep learning models more effectively in real-world applications. - -### Installation - -To install the required package, run: - -!!! Tip "Installation" - - === "CLI" - - ```bash - # Install the required package for YOLOv8 - pip install ultralytics - ``` - -For detailed instructions and best practices related to the installation process, check our [Ultralytics Installation guide](../quickstart.md). While installing the required packages for YOLOv8, if you encounter any difficulties, consult our [Common Issues guide](../guides/yolo-common-issues.md) for solutions and tips. - -### Usage - -Before diving into the usage instructions, it's important to note that while all [Ultralytics YOLOv8 models](../models/index.md) are available for exporting, you can ensure that the model you select supports export functionality [here](../modes/export.md). - -!!! Example "Usage" - - === "Python" - - ```python - from ultralytics import YOLO - - # Load the YOLOv8 model - model = YOLO('yolov8n.pt') - - # Export the model to TorchScript format - model.export(format='torchscript') # creates 'yolov8n.torchscript' - - # Load the exported TorchScript model - torchscript_model = YOLO('yolov8n.torchscript') - - # Run inference - results = torchscript_model('https://ultralytics.com/images/bus.jpg') - ``` - - === "CLI" - - ```bash - # Export a YOLOv8n PyTorch model to TorchScript format - yolo export model=yolov8n.pt format=torchscript # creates 'yolov8n.torchscript' - - # Run inference with the exported model - yolo predict model=yolov8n.torchscript source='https://ultralytics.com/images/bus.jpg' - ``` - -For more details about the export process, visit the [Ultralytics documentation page on exporting](../modes/export.md). - -## Deploying Exported YOLOv8 TorchScript Models - -After successfully exporting your Ultralytics YOLOv8 models to TorchScript format, you can now deploy them. The primary and recommended first step for running a TorchScript model is to utilize the YOLO("model.torchscript") method, as outlined in the previous usage code snippet. However, for in-depth instructions on deploying your TorchScript models in various other settings, take a look at the following resources: - -- **[Explore Mobile Deployment](https://pytorch.org/mobile/home/)**: The PyTorch Mobile Documentation provides comprehensive guidelines for deploying models on mobile devices, ensuring your applications are efficient and responsive. - -- **[Master Server-Side Deployment](https://pytorch.org/serve/getting_started.html)**: Learn how to deploy models server-side with TorchServe, offering a step-by-step tutorial for scalable, efficient model serving. - -- **[Implement C++ Deployment](https://pytorch.org/tutorials/advanced/cpp_export.html)**: Dive into the Tutorial on Loading a TorchScript Model in C++, facilitating the integration of your TorchScript models into C++ applications for enhanced performance and versatility. - -## Summary - -In this guide, we explored the process of exporting Ultralytics YOLOv8 models to the TorchScript format. By following the provided instructions, you can optimize YOLOv8 models for performance and gain the flexibility to deploy them across various platforms and environments. - -For further details on usage, visit [TorchScript’s official documentation](https://pytorch.org/docs/stable/jit.html). - -Also, if you’d like to know more about other Ultralytics YOLOv8 integrations, visit our [integration guide page](../integrations/index.md). You'll find plenty of useful resources and insights there. diff --git a/ultralytics-main/docs/en/integrations/weights-biases.md b/ultralytics-main/docs/en/integrations/weights-biases.md deleted file mode 100644 index 6a69a18..0000000 --- a/ultralytics-main/docs/en/integrations/weights-biases.md +++ /dev/null @@ -1,156 +0,0 @@ ---- -comments: true -description: Discover how to train your YOLOv8 models efficiently with Weights & Biases. This guide walks through integrating Weights & Biases with YOLOv8 to enable seamless experiment tracking, result visualization, and model explainability. -keywords: Ultralytics, YOLOv8, Object Detection, Weights & Biases, Model Training, Experiment Tracking, Visualizing Results ---- - -# Enhancing YOLOv8 Experiment Tracking and Visualization with Weights & Biases - -Object detection models like [Ultralytics YOLOv8](https://github.com/ultralytics/ultralytics) have become integral to many computer vision applications. However, training, evaluating, and deploying these complex models introduces several challenges. Tracking key training metrics, comparing model variants, analyzing model behavior, and detecting issues require substantial instrumentation and experiment management. - -This guide showcases Ultralytics YOLOv8 integration with Weights & Biases’ for enhanced experiment tracking, model-checkpointing, and visualization of model performance. It also includes instructions for setting up the integration, training, fine-tuning, and visualizing results using Weights & Biases’ interactive features. - -## Weights & Biases - -

- Weights & Biases Overview -

- -[Weights & Biases](https://wandb.ai/site) is a cutting-edge MLOps platform designed for tracking, visualizing, and managing machine learning experiments. It features automatic logging of training metrics for full experiment reproducibility, an interactive UI for streamlined data analysis, and efficient model management tools for deploying across various environments. - -## YOLOv8 Training with Weights & Biases - -You can use Weights & Biases to bring efficiency and automation to your YOLOv8 training process. - -## Installation - -To install the required packages, run: - -!!! Tip "Installation" - - === "CLI" - - ```bash - # Install the required packages for YOLOv8 and Weights & Biases - pip install --upgrade ultralytics==8.0.186 wandb - ``` - -For detailed instructions and best practices related to the installation process, be sure to check our [YOLOv8 Installation guide](../quickstart.md). While installing the required packages for YOLOv8, if you encounter any difficulties, consult our [Common Issues guide](../guides/yolo-common-issues.md) for solutions and tips. - -## Configuring Weights & Biases - -After installing the necessary packages, the next step is to set up your Weights & Biases environment. This includes creating a Weights & Biases account and obtaining the necessary API key for a smooth connection between your development environment and the W&B platform. - -Start by initializing the Weights & Biases environment in your workspace. You can do this by running the following command and following the prompted instructions. - -!!! Tip "Initial SDK Setup" - - === "CLI" - - ```bash - # Initialize your Weights & Biases environment - import wandb - wandb.login() - ``` - -Navigate to the Weights & Biases authorization page to create and retrieve your API key. Use this key to authenticate your environment with W&B. - -## Usage: Training YOLOv8 with Weights & Biases - -Before diving into the usage instructions for YOLOv8 model training with Weights & Biases, be sure to check out the range of [YOLOv8 models offered by Ultralytics](../models/index.md). This will help you choose the most appropriate model for your project requirements. - -!!! Example "Usage: Training YOLOv8 with Weights & Biases" - - === "Python" - ```python - from ultralytics import YOLO - from wandb.integration.ultralytics import add_wandb_callback - import wandb - - # Step 1: Initialize a Weights & Biases run - wandb.init(project="ultralytics", job_type="training") - - # Step 2: Define the YOLOv8 Model and Dataset - model_name = "yolov8n" - dataset_name = "coco128.yaml" - model = YOLO(f"{model_name}.pt") - - # Step 3: Add W&B Callback for Ultralytics - add_wandb_callback(model, enable_model_checkpointing=True) - - # Step 4: Train and Fine-Tune the Model - model.train(project="ultralytics", data=dataset_name, epochs=5, imgsz=640) - - # Step 5: Validate the Model - model.val() - - # Step 6: Perform Inference and Log Results - model(["path/to/image1", "path/to/image2"]) - - # Step 7: Finalize the W&B Run - wandb.finish() - ``` - -### Understanding the Code - -Let’s understand the steps showcased in the usage code snippet above. - -- **Step 1: Initialize a Weights & Biases Run**: Start by initializing a Weights & Biases run, specifying the project name and the job type. This run will track and manage the training and validation processes of your model. - -- **Step 2: Define the YOLOv8 Model and Dataset**: Specify the model variant and the dataset you wish to use. The YOLO model is then initialized with the specified model file. - -- **Step 3: Add Weights & Biases Callback for Ultralytics**: This step is crucial as it enables the automatic logging of training metrics and validation results to Weights & Biases, providing a detailed view of the model's performance. - -- **Step 4: Train and Fine-Tune the Model**: Begin training the model with the specified dataset, number of epochs, and image size. The training process includes logging of metrics and predictions at the end of each epoch, offering a comprehensive view of the model's learning progress. - -- **Step 5: Validate the Model**: After training, the model is validated. This step is crucial for assessing the model's performance on unseen data and ensuring its generalizability. - -- **Step 6: Perform Inference and Log Results**: The model performs predictions on specified images. These predictions, along with visual overlays and insights, are automatically logged in a W&B Table for interactive exploration. - -- **Step 7: Finalize the W&B Run**: This step marks the end of data logging and saves the final state of your model's training and validation process in the W&B dashboard. - -### Understanding the Output - -Upon running the usage code snippet above, you can expect the following key outputs: - -- The setup of a new run with its unique ID, indicating the start of the training process. -- A concise summary of the model’s structure, including the number of layers and parameters. -- Regular updates on important metrics such as box loss, cls loss, dfl loss, precision, recall, and mAP scores during each training epoch. -- At the end of training, detailed metrics including the model's inference speed, and overall accuracy metrics are displayed. -- Links to the Weights & Biases dashboard for in-depth analysis and visualization of the training process, along with information on local log file locations. - -### Viewing the Weights & Biases Dashboard - -After running the usage code snippet, you can access the Weights & Biases (W&B) dashboard through the provided link in the output. This dashboard offers a comprehensive view of your model's training process with YOLOv8. - -## Key Features of the Weights & Biases Dashboard - -- **Real-Time Metrics Tracking**: Observe metrics like loss, accuracy, and validation scores as they evolve during the training, offering immediate insights for model tuning. - - - -- **Hyperparameter Optimization**: Weights & Biases aids in fine-tuning critical parameters such as learning rate, batch size, and more, enhancing the performance of YOLOv8. - -- **Comparative Analysis**: The platform allows side-by-side comparisons of different training runs, essential for assessing the impact of various model configurations. - -- **Visualization of Training Progress**: Graphical representations of key metrics provide an intuitive understanding of the model's performance across epochs. - - - -- **Resource Monitoring**: Keep track of CPU, GPU, and memory usage to optimize the efficiency of the training process. - -- **Model Artifacts Management**: Access and share model checkpoints, facilitating easy deployment and collaboration. - -- **Viewing Inference Results with Image Overlay**: Visualize the prediction results on images using interactive overlays in Weights & Biases, providing a clear and detailed view of model performance on real-world data. For more detailed information on Weights & Biases’ image overlay capabilities, check out this [link](https://docs.wandb.ai/guides/track/log/media#image-overlays). - - - -By using these features, you can effectively track, analyze, and optimize your YOLOv8 model's training, ensuring the best possible performance and efficiency. - -## Summary - -This guide helped you explore Ultralytics’ YOLOv8 integration with Weights & Biases. It illustrates the ability of this integration to efficiently track and visualize model training and prediction results. - -For further details on usage, visit [Weights & Biases' official documentation](https://docs.wandb.ai/guides/integrations/ultralytics). - -Also, be sure to check out the [Ultralytics integration guide page](../integrations/index.md), to learn more about different exciting integrations. diff --git a/ultralytics-main/docs/en/models/fast-sam.md b/ultralytics-main/docs/en/models/fast-sam.md deleted file mode 100644 index e358992..0000000 --- a/ultralytics-main/docs/en/models/fast-sam.md +++ /dev/null @@ -1,203 +0,0 @@ ---- -comments: true -description: Explore FastSAM, a CNN-based solution for real-time object segmentation in images. Enhanced user interaction, computational efficiency and adaptable across vision tasks. -keywords: FastSAM, machine learning, CNN-based solution, object segmentation, real-time solution, Ultralytics, vision tasks, image processing, industrial applications, user interaction ---- - -# Fast Segment Anything Model (FastSAM) - -The Fast Segment Anything Model (FastSAM) is a novel, real-time CNN-based solution for the Segment Anything task. This task is designed to segment any object within an image based on various possible user interaction prompts. FastSAM significantly reduces computational demands while maintaining competitive performance, making it a practical choice for a variety of vision tasks. - -![Fast Segment Anything Model (FastSAM) architecture overview](https://user-images.githubusercontent.com/26833433/248551984-d98f0f6d-7535-45d0-b380-2e1440b52ad7.jpg) - -## Overview - -FastSAM is designed to address the limitations of the [Segment Anything Model (SAM)](sam.md), a heavy Transformer model with substantial computational resource requirements. The FastSAM decouples the segment anything task into two sequential stages: all-instance segmentation and prompt-guided selection. The first stage uses [YOLOv8-seg](../tasks/segment.md) to produce the segmentation masks of all instances in the image. In the second stage, it outputs the region-of-interest corresponding to the prompt. - -## Key Features - -1. **Real-time Solution:** By leveraging the computational efficiency of CNNs, FastSAM provides a real-time solution for the segment anything task, making it valuable for industrial applications that require quick results. - -2. **Efficiency and Performance:** FastSAM offers a significant reduction in computational and resource demands without compromising on performance quality. It achieves comparable performance to SAM but with drastically reduced computational resources, enabling real-time application. - -3. **Prompt-guided Segmentation:** FastSAM can segment any object within an image guided by various possible user interaction prompts, providing flexibility and adaptability in different scenarios. - -4. **Based on YOLOv8-seg:** FastSAM is based on [YOLOv8-seg](../tasks/segment.md), an object detector equipped with an instance segmentation branch. This allows it to effectively produce the segmentation masks of all instances in an image. - -5. **Competitive Results on Benchmarks:** On the object proposal task on MS COCO, FastSAM achieves high scores at a significantly faster speed than [SAM](sam.md) on a single NVIDIA RTX 3090, demonstrating its efficiency and capability. - -6. **Practical Applications:** The proposed approach provides a new, practical solution for a large number of vision tasks at a really high speed, tens or hundreds of times faster than current methods. - -7. **Model Compression Feasibility:** FastSAM demonstrates the feasibility of a path that can significantly reduce the computational effort by introducing an artificial prior to the structure, thus opening new possibilities for large model architecture for general vision tasks. - -## Available Models, Supported Tasks, and Operating Modes - -This table presents the available models with their specific pre-trained weights, the tasks they support, and their compatibility with different operating modes like [Inference](../modes/predict.md), [Validation](../modes/val.md), [Training](../modes/train.md), and [Export](../modes/export.md), indicated by ✅ emojis for supported modes and ❌ emojis for unsupported modes. - -| Model Type | Pre-trained Weights | Tasks Supported | Inference | Validation | Training | Export | -|------------|---------------------------------------------------------------------------------------------|----------------------------------------------|-----------|------------|----------|--------| -| FastSAM-s | [FastSAM-s.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/FastSAM-s.pt) | [Instance Segmentation](../tasks/segment.md) | ✅ | ❌ | ❌ | ✅ | -| FastSAM-x | [FastSAM-x.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/FastSAM-x.pt) | [Instance Segmentation](../tasks/segment.md) | ✅ | ❌ | ❌ | ✅ | - -## Usage Examples - -The FastSAM models are easy to integrate into your Python applications. Ultralytics provides user-friendly Python API and CLI commands to streamline development. - -### Predict Usage - -To perform object detection on an image, use the `predict` method as shown below: - -!!! Example - - === "Python" - - ```python - from ultralytics import FastSAM - from ultralytics.models.fastsam import FastSAMPrompt - - # Define an inference source - source = 'path/to/bus.jpg' - - # Create a FastSAM model - model = FastSAM('FastSAM-s.pt') # or FastSAM-x.pt - - # Run inference on an image - everything_results = model(source, device='cpu', retina_masks=True, imgsz=1024, conf=0.4, iou=0.9) - - # Prepare a Prompt Process object - prompt_process = FastSAMPrompt(source, everything_results, device='cpu') - - # Everything prompt - ann = prompt_process.everything_prompt() - - # Bbox default shape [0,0,0,0] -> [x1,y1,x2,y2] - ann = prompt_process.box_prompt(bbox=[200, 200, 300, 300]) - - # Text prompt - ann = prompt_process.text_prompt(text='a photo of a dog') - - # Point prompt - # points default [[0,0]] [[x1,y1],[x2,y2]] - # point_label default [0] [1,0] 0:background, 1:foreground - ann = prompt_process.point_prompt(points=[[200, 200]], pointlabel=[1]) - prompt_process.plot(annotations=ann, output='./') - ``` - - === "CLI" - - ```bash - # Load a FastSAM model and segment everything with it - yolo segment predict model=FastSAM-s.pt source=path/to/bus.jpg imgsz=640 - ``` - -This snippet demonstrates the simplicity of loading a pre-trained model and running a prediction on an image. - -### Val Usage - -Validation of the model on a dataset can be done as follows: - -!!! Example - - === "Python" - - ```python - from ultralytics import FastSAM - - # Create a FastSAM model - model = FastSAM('FastSAM-s.pt') # or FastSAM-x.pt - - # Validate the model - results = model.val(data='coco8-seg.yaml') - ``` - - === "CLI" - - ```bash - # Load a FastSAM model and validate it on the COCO8 example dataset at image size 640 - yolo segment val model=FastSAM-s.pt data=coco8.yaml imgsz=640 - ``` - -Please note that FastSAM only supports detection and segmentation of a single class of object. This means it will recognize and segment all objects as the same class. Therefore, when preparing the dataset, you need to convert all object category IDs to 0. - -## FastSAM official Usage - -FastSAM is also available directly from the [https://github.com/CASIA-IVA-Lab/FastSAM](https://github.com/CASIA-IVA-Lab/FastSAM) repository. Here is a brief overview of the typical steps you might take to use FastSAM: - -### Installation - -1. Clone the FastSAM repository: - - ```shell - git clone https://github.com/CASIA-IVA-Lab/FastSAM.git - ``` - -2. Create and activate a Conda environment with Python 3.9: - - ```shell - conda create -n FastSAM python=3.9 - conda activate FastSAM - ``` - -3. Navigate to the cloned repository and install the required packages: - - ```shell - cd FastSAM - pip install -r requirements.txt - ``` - -4. Install the CLIP model: - ```shell - pip install git+https://github.com/openai/CLIP.git - ``` - -### Example Usage - -1. Download a [model checkpoint](https://drive.google.com/file/d/1m1sjY4ihXBU1fZXdQ-Xdj-mDltW-2Rqv/view?usp=sharing). - -2. Use FastSAM for inference. Example commands: - - - Segment everything in an image: - - ```shell - python Inference.py --model_path ./weights/FastSAM.pt --img_path ./images/dogs.jpg - ``` - - - Segment specific objects using text prompt: - - ```shell - python Inference.py --model_path ./weights/FastSAM.pt --img_path ./images/dogs.jpg --text_prompt "the yellow dog" - ``` - - - Segment objects within a bounding box (provide box coordinates in xywh format): - - ```shell - python Inference.py --model_path ./weights/FastSAM.pt --img_path ./images/dogs.jpg --box_prompt "[570,200,230,400]" - ``` - - - Segment objects near specific points: - ```shell - python Inference.py --model_path ./weights/FastSAM.pt --img_path ./images/dogs.jpg --point_prompt "[[520,360],[620,300]]" --point_label "[1,0]" - ``` - -Additionally, you can try FastSAM through a [Colab demo](https://colab.research.google.com/drive/1oX14f6IneGGw612WgVlAiy91UHwFAvr9?usp=sharing) or on the [HuggingFace web demo](https://huggingface.co/spaces/An-619/FastSAM) for a visual experience. - -## Citations and Acknowledgements - -We would like to acknowledge the FastSAM authors for their significant contributions in the field of real-time instance segmentation: - -!!! Quote "" - - === "BibTeX" - - ```bibtex - @misc{zhao2023fast, - title={Fast Segment Anything}, - author={Xu Zhao and Wenchao Ding and Yongqi An and Yinglong Du and Tao Yu and Min Li and Ming Tang and Jinqiao Wang}, - year={2023}, - eprint={2306.12156}, - archivePrefix={arXiv}, - primaryClass={cs.CV} - } - ``` - -The original FastSAM paper can be found on [arXiv](https://arxiv.org/abs/2306.12156). The authors have made their work publicly available, and the codebase can be accessed on [GitHub](https://github.com/CASIA-IVA-Lab/FastSAM). We appreciate their efforts in advancing the field and making their work accessible to the broader community. diff --git a/ultralytics-main/docs/en/models/index.md b/ultralytics-main/docs/en/models/index.md deleted file mode 100644 index 70a70ef..0000000 --- a/ultralytics-main/docs/en/models/index.md +++ /dev/null @@ -1,96 +0,0 @@ ---- -comments: true -description: Explore the diverse range of YOLO family, SAM, MobileSAM, FastSAM, YOLO-NAS, YOLO-World and RT-DETR models supported by Ultralytics. Get started with examples for both CLI and Python usage. -keywords: Ultralytics, documentation, YOLO, SAM, MobileSAM, FastSAM, YOLO-NAS, RT-DETR, YOLO-World, models, architectures, Python, CLI ---- - -# Models Supported by Ultralytics - -Welcome to Ultralytics' model documentation! We offer support for a wide range of models, each tailored to specific tasks like [object detection](../tasks/detect.md), [instance segmentation](../tasks/segment.md), [image classification](../tasks/classify.md), [pose estimation](../tasks/pose.md), and [multi-object tracking](../modes/track.md). If you're interested in contributing your model architecture to Ultralytics, check out our [Contributing Guide](../help/contributing.md). - -## Featured Models - -Here are some of the key models supported: - -1. **[YOLOv3](yolov3.md)**: The third iteration of the YOLO model family, originally by Joseph Redmon, known for its efficient real-time object detection capabilities. -2. **[YOLOv4](yolov4.md)**: A darknet-native update to YOLOv3, released by Alexey Bochkovskiy in 2020. -3. **[YOLOv5](yolov5.md)**: An improved version of the YOLO architecture by Ultralytics, offering better performance and speed trade-offs compared to previous versions. -4. **[YOLOv6](yolov6.md)**: Released by [Meituan](https://about.meituan.com/) in 2022, and in use in many of the company's autonomous delivery robots. -5. **[YOLOv7](yolov7.md)**: Updated YOLO models released in 2022 by the authors of YOLOv4. -6. **[YOLOv8](yolov8.md) NEW 🚀**: The latest version of the YOLO family, featuring enhanced capabilities such as instance segmentation, pose/keypoints estimation, and classification. -7. **[YOLOv9](yolov9.md)**: An experimental model trained on the Ultralytics [YOLOv5](yolov5.md) codebase implementing Programmable Gradient Information (PGI). -8. **[Segment Anything Model (SAM)](sam.md)**: Meta's Segment Anything Model (SAM). -9. **[Mobile Segment Anything Model (MobileSAM)](mobile-sam.md)**: MobileSAM for mobile applications, by Kyung Hee University. -10. **[Fast Segment Anything Model (FastSAM)](fast-sam.md)**: FastSAM by Image & Video Analysis Group, Institute of Automation, Chinese Academy of Sciences. -11. **[YOLO-NAS](yolo-nas.md)**: YOLO Neural Architecture Search (NAS) Models. -12. **[Realtime Detection Transformers (RT-DETR)](rtdetr.md)**: Baidu's PaddlePaddle Realtime Detection Transformer (RT-DETR) models. -13. **[YOLO-World](yolo-world.md)**: Real-time Open Vocabulary Object Detection models from Tencent AI Lab. - -

-
- -
- Watch: Run Ultralytics YOLO models in just a few lines of code. -

- -## Getting Started: Usage Examples - -This example provides simple YOLO training and inference examples. For full documentation on these and other [modes](../modes/index.md) see the [Predict](../modes/predict.md), [Train](../modes/train.md), [Val](../modes/val.md) and [Export](../modes/export.md) docs pages. - -Note the below example is for YOLOv8 [Detect](../tasks/detect.md) models for object detection. For additional supported tasks see the [Segment](../tasks/segment.md), [Classify](../tasks/classify.md) and [Pose](../tasks/pose.md) docs. - -!!! Example - - === "Python" - - PyTorch pretrained `*.pt` models as well as configuration `*.yaml` files can be passed to the `YOLO()`, `SAM()`, `NAS()` and `RTDETR()` classes to create a model instance in Python: - - ```python - from ultralytics import YOLO - - # Load a COCO-pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Display model information (optional) - model.info() - - # Train the model on the COCO8 example dataset for 100 epochs - results = model.train(data='coco8.yaml', epochs=100, imgsz=640) - - # Run inference with the YOLOv8n model on the 'bus.jpg' image - results = model('path/to/bus.jpg') - ``` - - === "CLI" - - CLI commands are available to directly run the models: - - ```bash - # Load a COCO-pretrained YOLOv8n model and train it on the COCO8 example dataset for 100 epochs - yolo train model=yolov8n.pt data=coco8.yaml epochs=100 imgsz=640 - - # Load a COCO-pretrained YOLOv8n model and run inference on the 'bus.jpg' image - yolo predict model=yolov8n.pt source=path/to/bus.jpg - ``` - -## Contributing New Models - -Interested in contributing your model to Ultralytics? Great! We're always open to expanding our model portfolio. - -1. **Fork the Repository**: Start by forking the [Ultralytics GitHub repository](https://github.com/ultralytics/ultralytics). - -2. **Clone Your Fork**: Clone your fork to your local machine and create a new branch to work on. - -3. **Implement Your Model**: Add your model following the coding standards and guidelines provided in our [Contributing Guide](../help/contributing.md). - -4. **Test Thoroughly**: Make sure to test your model rigorously, both in isolation and as part of the pipeline. - -5. **Create a Pull Request**: Once you're satisfied with your model, create a pull request to the main repository for review. - -6. **Code Review & Merging**: After review, if your model meets our criteria, it will be merged into the main repository. - -For detailed steps, consult our [Contributing Guide](../help/contributing.md). diff --git a/ultralytics-main/docs/en/models/mobile-sam.md b/ultralytics-main/docs/en/models/mobile-sam.md deleted file mode 100644 index bd97e03..0000000 --- a/ultralytics-main/docs/en/models/mobile-sam.md +++ /dev/null @@ -1,119 +0,0 @@ ---- -comments: true -description: Learn more about MobileSAM, its implementation, comparison with the original SAM, and how to download and test it in the Ultralytics framework. Improve your mobile applications today. -keywords: MobileSAM, Ultralytics, SAM, mobile applications, Arxiv, GPU, API, image encoder, mask decoder, model download, testing method ---- - -![MobileSAM Logo](https://github.com/ChaoningZhang/MobileSAM/blob/master/assets/logo2.png?raw=true) - -# Mobile Segment Anything (MobileSAM) - -The MobileSAM paper is now available on [arXiv](https://arxiv.org/pdf/2306.14289.pdf). - -A demonstration of MobileSAM running on a CPU can be accessed at this [demo link](https://huggingface.co/spaces/dhkim2810/MobileSAM). The performance on a Mac i5 CPU takes approximately 3 seconds. On the Hugging Face demo, the interface and lower-performance CPUs contribute to a slower response, but it continues to function effectively. - -MobileSAM is implemented in various projects including [Grounding-SAM](https://github.com/IDEA-Research/Grounded-Segment-Anything), [AnyLabeling](https://github.com/vietanhdev/anylabeling), and [Segment Anything in 3D](https://github.com/Jumpat/SegmentAnythingin3D). - -MobileSAM is trained on a single GPU with a 100k dataset (1% of the original images) in less than a day. The code for this training will be made available in the future. - -## Available Models, Supported Tasks, and Operating Modes - -This table presents the available models with their specific pre-trained weights, the tasks they support, and their compatibility with different operating modes like [Inference](../modes/predict.md), [Validation](../modes/val.md), [Training](../modes/train.md), and [Export](../modes/export.md), indicated by ✅ emojis for supported modes and ❌ emojis for unsupported modes. - -| Model Type | Pre-trained Weights | Tasks Supported | Inference | Validation | Training | Export | -|------------|-----------------------------------------------------------------------------------------------|----------------------------------------------|-----------|------------|----------|--------| -| MobileSAM | [mobile_sam.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/mobile_sam.pt) | [Instance Segmentation](../tasks/segment.md) | ✅ | ❌ | ❌ | ❌ | - -## Adapting from SAM to MobileSAM - -Since MobileSAM retains the same pipeline as the original SAM, we have incorporated the original's pre-processing, post-processing, and all other interfaces. Consequently, those currently using the original SAM can transition to MobileSAM with minimal effort. - -MobileSAM performs comparably to the original SAM and retains the same pipeline except for a change in the image encoder. Specifically, we replace the original heavyweight ViT-H encoder (632M) with a smaller Tiny-ViT (5M). On a single GPU, MobileSAM operates at about 12ms per image: 8ms on the image encoder and 4ms on the mask decoder. - -The following table provides a comparison of ViT-based image encoders: - -| Image Encoder | Original SAM | MobileSAM | -|---------------|--------------|-----------| -| Parameters | 611M | 5M | -| Speed | 452ms | 8ms | - -Both the original SAM and MobileSAM utilize the same prompt-guided mask decoder: - -| Mask Decoder | Original SAM | MobileSAM | -|--------------|--------------|-----------| -| Parameters | 3.876M | 3.876M | -| Speed | 4ms | 4ms | - -Here is the comparison of the whole pipeline: - -| Whole Pipeline (Enc+Dec) | Original SAM | MobileSAM | -|--------------------------|--------------|-----------| -| Parameters | 615M | 9.66M | -| Speed | 456ms | 12ms | - -The performance of MobileSAM and the original SAM are demonstrated using both a point and a box as prompts. - -![Image with Point as Prompt](https://raw.githubusercontent.com/ChaoningZhang/MobileSAM/master/assets/mask_box.jpg?raw=true) - -![Image with Box as Prompt](https://raw.githubusercontent.com/ChaoningZhang/MobileSAM/master/assets/mask_box.jpg?raw=true) - -With its superior performance, MobileSAM is approximately 5 times smaller and 7 times faster than the current FastSAM. More details are available at the [MobileSAM project page](https://github.com/ChaoningZhang/MobileSAM). - -## Testing MobileSAM in Ultralytics - -Just like the original SAM, we offer a straightforward testing method in Ultralytics, including modes for both Point and Box prompts. - -### Model Download - -You can download the model [here](https://github.com/ChaoningZhang/MobileSAM/blob/master/weights/mobile_sam.pt). - -### Point Prompt - -!!! Example - - === "Python" - - ```python - from ultralytics import SAM - - # Load the model - model = SAM('mobile_sam.pt') - - # Predict a segment based on a point prompt - model.predict('ultralytics/assets/zidane.jpg', points=[900, 370], labels=[1]) - ``` - -### Box Prompt - -!!! Example - - === "Python" - - ```python - from ultralytics import SAM - - # Load the model - model = SAM('mobile_sam.pt') - - # Predict a segment based on a box prompt - model.predict('ultralytics/assets/zidane.jpg', bboxes=[439, 437, 524, 709]) - ``` - -We have implemented `MobileSAM` and `SAM` using the same API. For more usage information, please see the [SAM page](sam.md). - -## Citations and Acknowledgements - -If you find MobileSAM useful in your research or development work, please consider citing our paper: - -!!! Quote "" - - === "BibTeX" - - ```bibtex - @article{mobile_sam, - title={Faster Segment Anything: Towards Lightweight SAM for Mobile Applications}, - author={Zhang, Chaoning and Han, Dongshen and Qiao, Yu and Kim, Jung Uk and Bae, Sung Ho and Lee, Seungkyu and Hong, Choong Seon}, - journal={arXiv preprint arXiv:2306.14289}, - year={2023} - } - ``` diff --git a/ultralytics-main/docs/en/models/rtdetr.md b/ultralytics-main/docs/en/models/rtdetr.md deleted file mode 100644 index 844356e..0000000 --- a/ultralytics-main/docs/en/models/rtdetr.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -comments: true -description: Discover the features and benefits of RT-DETR, Baidu’s efficient and adaptable real-time object detector powered by Vision Transformers, including pre-trained models. -keywords: RT-DETR, Baidu, Vision Transformers, object detection, real-time performance, CUDA, TensorRT, IoU-aware query selection, Ultralytics, Python API, PaddlePaddle ---- - -# Baidu's RT-DETR: A Vision Transformer-Based Real-Time Object Detector - -## Overview - -Real-Time Detection Transformer (RT-DETR), developed by Baidu, is a cutting-edge end-to-end object detector that provides real-time performance while maintaining high accuracy. It leverages the power of Vision Transformers (ViT) to efficiently process multiscale features by decoupling intra-scale interaction and cross-scale fusion. RT-DETR is highly adaptable, supporting flexible adjustment of inference speed using different decoder layers without retraining. The model excels on accelerated backends like CUDA with TensorRT, outperforming many other real-time object detectors. - -![Model example image](https://user-images.githubusercontent.com/26833433/238963168-90e8483f-90aa-4eb6-a5e1-0d408b23dd33.png) **Overview of Baidu's RT-DETR.** The RT-DETR model architecture diagram shows the last three stages of the backbone {S3, S4, S5} as the input to the encoder. The efficient hybrid encoder transforms multiscale features into a sequence of image features through intrascale feature interaction (AIFI) and cross-scale feature-fusion module (CCFM). The IoU-aware query selection is employed to select a fixed number of image features to serve as initial object queries for the decoder. Finally, the decoder with auxiliary prediction heads iteratively optimizes object queries to generate boxes and confidence scores ([source](https://arxiv.org/pdf/2304.08069.pdf)). - -### Key Features - -- **Efficient Hybrid Encoder:** Baidu's RT-DETR uses an efficient hybrid encoder that processes multiscale features by decoupling intra-scale interaction and cross-scale fusion. This unique Vision Transformers-based design reduces computational costs and allows for real-time object detection. -- **IoU-aware Query Selection:** Baidu's RT-DETR improves object query initialization by utilizing IoU-aware query selection. This allows the model to focus on the most relevant objects in the scene, enhancing the detection accuracy. -- **Adaptable Inference Speed:** Baidu's RT-DETR supports flexible adjustments of inference speed by using different decoder layers without the need for retraining. This adaptability facilitates practical application in various real-time object detection scenarios. - -## Pre-trained Models - -The Ultralytics Python API provides pre-trained PaddlePaddle RT-DETR models with different scales: - -- RT-DETR-L: 53.0% AP on COCO val2017, 114 FPS on T4 GPU -- RT-DETR-X: 54.8% AP on COCO val2017, 74 FPS on T4 GPU - -## Usage Examples - -This example provides simple RT-DETR training and inference examples. For full documentation on these and other [modes](../modes/index.md) see the [Predict](../modes/predict.md), [Train](../modes/train.md), [Val](../modes/val.md) and [Export](../modes/export.md) docs pages. - -!!! Example - - === "Python" - - ```python - from ultralytics import RTDETR - - # Load a COCO-pretrained RT-DETR-l model - model = RTDETR('rtdetr-l.pt') - - # Display model information (optional) - model.info() - - # Train the model on the COCO8 example dataset for 100 epochs - results = model.train(data='coco8.yaml', epochs=100, imgsz=640) - - # Run inference with the RT-DETR-l model on the 'bus.jpg' image - results = model('path/to/bus.jpg') - ``` - - === "CLI" - - ```bash - # Load a COCO-pretrained RT-DETR-l model and train it on the COCO8 example dataset for 100 epochs - yolo train model=rtdetr-l.pt data=coco8.yaml epochs=100 imgsz=640 - - # Load a COCO-pretrained RT-DETR-l model and run inference on the 'bus.jpg' image - yolo predict model=rtdetr-l.pt source=path/to/bus.jpg - ``` - -## Supported Tasks and Modes - -This table presents the model types, the specific pre-trained weights, the tasks supported by each model, and the various modes ([Train](../modes/train.md) , [Val](../modes/val.md), [Predict](../modes/predict.md), [Export](../modes/export.md)) that are supported, indicated by ✅ emojis. - -| Model Type | Pre-trained Weights | Tasks Supported | Inference | Validation | Training | Export | -|---------------------|-------------------------------------------------------------------------------------------|----------------------------------------|-----------|------------|----------|--------| -| RT-DETR Large | [rtdetr-l.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/rtdetr-l.pt) | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ✅ | ✅ | -| RT-DETR Extra-Large | [rtdetr-x.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/rtdetr-x.pt) | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ✅ | ✅ | - -## Citations and Acknowledgements - -If you use Baidu's RT-DETR in your research or development work, please cite the [original paper](https://arxiv.org/abs/2304.08069): - -!!! Quote "" - - === "BibTeX" - - ```bibtex - @misc{lv2023detrs, - title={DETRs Beat YOLOs on Real-time Object Detection}, - author={Wenyu Lv and Shangliang Xu and Yian Zhao and Guanzhong Wang and Jinman Wei and Cheng Cui and Yuning Du and Qingqing Dang and Yi Liu}, - year={2023}, - eprint={2304.08069}, - archivePrefix={arXiv}, - primaryClass={cs.CV} - } - ``` - -We would like to acknowledge Baidu and the [PaddlePaddle](https://github.com/PaddlePaddle/PaddleDetection) team for creating and maintaining this valuable resource for the computer vision community. Their contribution to the field with the development of the Vision Transformers-based real-time object detector, RT-DETR, is greatly appreciated. - -_Keywords: RT-DETR, Transformer, ViT, Vision Transformers, Baidu RT-DETR, PaddlePaddle, Paddle Paddle RT-DETR, real-time object detection, Vision Transformers-based object detection, pre-trained PaddlePaddle RT-DETR models, Baidu's RT-DETR usage, Ultralytics Python API_ diff --git a/ultralytics-main/docs/en/models/sam.md b/ultralytics-main/docs/en/models/sam.md deleted file mode 100644 index e931b9e..0000000 --- a/ultralytics-main/docs/en/models/sam.md +++ /dev/null @@ -1,227 +0,0 @@ ---- -comments: true -description: Explore the cutting-edge Segment Anything Model (SAM) from Ultralytics that allows real-time image segmentation. Learn about its promptable segmentation, zero-shot performance, and how to use it. -keywords: Ultralytics, image segmentation, Segment Anything Model, SAM, SA-1B dataset, real-time performance, zero-shot transfer, object detection, image analysis, machine learning ---- - -# Segment Anything Model (SAM) - -Welcome to the frontier of image segmentation with the Segment Anything Model, or SAM. This revolutionary model has changed the game by introducing promptable image segmentation with real-time performance, setting new standards in the field. - -## Introduction to SAM: The Segment Anything Model - -The Segment Anything Model, or SAM, is a cutting-edge image segmentation model that allows for promptable segmentation, providing unparalleled versatility in image analysis tasks. SAM forms the heart of the Segment Anything initiative, a groundbreaking project that introduces a novel model, task, and dataset for image segmentation. - -SAM's advanced design allows it to adapt to new image distributions and tasks without prior knowledge, a feature known as zero-shot transfer. Trained on the expansive [SA-1B dataset](https://ai.facebook.com/datasets/segment-anything/), which contains more than 1 billion masks spread over 11 million carefully curated images, SAM has displayed impressive zero-shot performance, surpassing previous fully supervised results in many cases. - -![Dataset sample image](https://user-images.githubusercontent.com/26833433/238056229-0e8ffbeb-f81a-477e-a490-aff3d82fd8ce.jpg) **SA-1B Example images.** Dataset images overlaid masks from the newly introduced SA-1B dataset. SA-1B contains 11M diverse, high-resolution, licensed, and privacy protecting images and 1.1B high-quality segmentation masks. These masks were annotated fully automatically by SAM, and as verified by human ratings and numerous experiments, are of high quality and diversity. Images are grouped by number of masks per image for visualization (there are ∼100 masks per image on average). - -## Key Features of the Segment Anything Model (SAM) - -- **Promptable Segmentation Task:** SAM was designed with a promptable segmentation task in mind, allowing it to generate valid segmentation masks from any given prompt, such as spatial or text clues identifying an object. -- **Advanced Architecture:** The Segment Anything Model employs a powerful image encoder, a prompt encoder, and a lightweight mask decoder. This unique architecture enables flexible prompting, real-time mask computation, and ambiguity awareness in segmentation tasks. -- **The SA-1B Dataset:** Introduced by the Segment Anything project, the SA-1B dataset features over 1 billion masks on 11 million images. As the largest segmentation dataset to date, it provides SAM with a diverse and large-scale training data source. -- **Zero-Shot Performance:** SAM displays outstanding zero-shot performance across various segmentation tasks, making it a ready-to-use tool for diverse applications with minimal need for prompt engineering. - -For an in-depth look at the Segment Anything Model and the SA-1B dataset, please visit the [Segment Anything website](https://segment-anything.com) and check out the research paper [Segment Anything](https://arxiv.org/abs/2304.02643). - -## Available Models, Supported Tasks, and Operating Modes - -This table presents the available models with their specific pre-trained weights, the tasks they support, and their compatibility with different operating modes like [Inference](../modes/predict.md), [Validation](../modes/val.md), [Training](../modes/train.md), and [Export](../modes/export.md), indicated by ✅ emojis for supported modes and ❌ emojis for unsupported modes. - -| Model Type | Pre-trained Weights | Tasks Supported | Inference | Validation | Training | Export | -|------------|-------------------------------------------------------------------------------------|----------------------------------------------|-----------|------------|----------|--------| -| SAM base | [sam_b.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/sam_b.pt) | [Instance Segmentation](../tasks/segment.md) | ✅ | ❌ | ❌ | ❌ | -| SAM large | [sam_l.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/sam_l.pt) | [Instance Segmentation](../tasks/segment.md) | ✅ | ❌ | ❌ | ❌ | - -## How to Use SAM: Versatility and Power in Image Segmentation - -The Segment Anything Model can be employed for a multitude of downstream tasks that go beyond its training data. This includes edge detection, object proposal generation, instance segmentation, and preliminary text-to-mask prediction. With prompt engineering, SAM can swiftly adapt to new tasks and data distributions in a zero-shot manner, establishing it as a versatile and potent tool for all your image segmentation needs. - -### SAM prediction example - -!!! Example "Segment with prompts" - - Segment image with given prompts. - - === "Python" - - ```python - from ultralytics import SAM - - # Load a model - model = SAM('sam_b.pt') - - # Display model information (optional) - model.info() - - # Run inference with bboxes prompt - model('ultralytics/assets/zidane.jpg', bboxes=[439, 437, 524, 709]) - - # Run inference with points prompt - model('ultralytics/assets/zidane.jpg', points=[900, 370], labels=[1]) - ``` - -!!! Example "Segment everything" - - Segment the whole image. - - === "Python" - - ```python - from ultralytics import SAM - - # Load a model - model = SAM('sam_b.pt') - - # Display model information (optional) - model.info() - - # Run inference - model('path/to/image.jpg') - ``` - - === "CLI" - - ```bash - # Run inference with a SAM model - yolo predict model=sam_b.pt source=path/to/image.jpg - ``` - -- The logic here is to segment the whole image if you don't pass any prompts(bboxes/points/masks). - -!!! Example "SAMPredictor example" - - This way you can set image once and run prompts inference multiple times without running image encoder multiple times. - - === "Prompt inference" - - ```python - from ultralytics.models.sam import Predictor as SAMPredictor - - # Create SAMPredictor - overrides = dict(conf=0.25, task='segment', mode='predict', imgsz=1024, model="mobile_sam.pt") - predictor = SAMPredictor(overrides=overrides) - - # Set image - predictor.set_image("ultralytics/assets/zidane.jpg") # set with image file - predictor.set_image(cv2.imread("ultralytics/assets/zidane.jpg")) # set with np.ndarray - results = predictor(bboxes=[439, 437, 524, 709]) - results = predictor(points=[900, 370], labels=[1]) - - # Reset image - predictor.reset_image() - ``` - - Segment everything with additional args. - - === "Segment everything" - - ```python - from ultralytics.models.sam import Predictor as SAMPredictor - - # Create SAMPredictor - overrides = dict(conf=0.25, task='segment', mode='predict', imgsz=1024, model="mobile_sam.pt") - predictor = SAMPredictor(overrides=overrides) - - # Segment with additional args - results = predictor(source="ultralytics/assets/zidane.jpg", crop_n_layers=1, points_stride=64) - ``` - -- More additional args for `Segment everything` see [`Predictor/generate` Reference](../reference/models/sam/predict.md). - -## SAM comparison vs YOLOv8 - -Here we compare Meta's smallest SAM model, SAM-b, with Ultralytics smallest segmentation model, [YOLOv8n-seg](../tasks/segment.md): - -| Model | Size | Parameters | Speed (CPU) | -|------------------------------------------------|----------------------------|------------------------|----------------------------| -| Meta's SAM-b | 358 MB | 94.7 M | 51096 ms/im | -| [MobileSAM](mobile-sam.md) | 40.7 MB | 10.1 M | 46122 ms/im | -| [FastSAM-s](fast-sam.md) with YOLOv8 backbone | 23.7 MB | 11.8 M | 115 ms/im | -| Ultralytics [YOLOv8n-seg](../tasks/segment.md) | **6.7 MB** (53.4x smaller) | **3.4 M** (27.9x less) | **59 ms/im** (866x faster) | - -This comparison shows the order-of-magnitude differences in the model sizes and speeds between models. Whereas SAM presents unique capabilities for automatic segmenting, it is not a direct competitor to YOLOv8 segment models, which are smaller, faster and more efficient. - -Tests run on a 2023 Apple M2 Macbook with 16GB of RAM. To reproduce this test: - -!!! Example - - === "Python" - - ```python - from ultralytics import FastSAM, SAM, YOLO - - # Profile SAM-b - model = SAM('sam_b.pt') - model.info() - model('ultralytics/assets') - - # Profile MobileSAM - model = SAM('mobile_sam.pt') - model.info() - model('ultralytics/assets') - - # Profile FastSAM-s - model = FastSAM('FastSAM-s.pt') - model.info() - model('ultralytics/assets') - - # Profile YOLOv8n-seg - model = YOLO('yolov8n-seg.pt') - model.info() - model('ultralytics/assets') - ``` - -## Auto-Annotation: A Quick Path to Segmentation Datasets - -Auto-annotation is a key feature of SAM, allowing users to generate a [segmentation dataset](https://docs.ultralytics.com/datasets/segment) using a pre-trained detection model. This feature enables rapid and accurate annotation of a large number of images, bypassing the need for time-consuming manual labeling. - -### Generate Your Segmentation Dataset Using a Detection Model - -To auto-annotate your dataset with the Ultralytics framework, use the `auto_annotate` function as shown below: - -!!! Example - - === "Python" - - ```python - from ultralytics.data.annotator import auto_annotate - - auto_annotate(data="path/to/images", det_model="yolov8x.pt", sam_model='sam_b.pt') - ``` - -| Argument | Type | Description | Default | -|------------|---------------------|---------------------------------------------------------------------------------------------------------|--------------| -| data | str | Path to a folder containing images to be annotated. | | -| det_model | str, optional | Pre-trained YOLO detection model. Defaults to 'yolov8x.pt'. | 'yolov8x.pt' | -| sam_model | str, optional | Pre-trained SAM segmentation model. Defaults to 'sam_b.pt'. | 'sam_b.pt' | -| device | str, optional | Device to run the models on. Defaults to an empty string (CPU or GPU, if available). | | -| output_dir | str, None, optional | Directory to save the annotated results. Defaults to a 'labels' folder in the same directory as 'data'. | None | - -The `auto_annotate` function takes the path to your images, with optional arguments for specifying the pre-trained detection and SAM segmentation models, the device to run the models on, and the output directory for saving the annotated results. - -Auto-annotation with pre-trained models can dramatically cut down the time and effort required for creating high-quality segmentation datasets. This feature is especially beneficial for researchers and developers dealing with large image collections, as it allows them to focus on model development and evaluation rather than manual annotation. - -## Citations and Acknowledgements - -If you find SAM useful in your research or development work, please consider citing our paper: - -!!! Quote "" - - === "BibTeX" - - ```bibtex - @misc{kirillov2023segment, - title={Segment Anything}, - author={Alexander Kirillov and Eric Mintun and Nikhila Ravi and Hanzi Mao and Chloe Rolland and Laura Gustafson and Tete Xiao and Spencer Whitehead and Alexander C. Berg and Wan-Yen Lo and Piotr Dollár and Ross Girshick}, - year={2023}, - eprint={2304.02643}, - archivePrefix={arXiv}, - primaryClass={cs.CV} - } - ``` - -We would like to express our gratitude to Meta AI for creating and maintaining this valuable resource for the computer vision community. - -_keywords: Segment Anything, Segment Anything Model, SAM, Meta SAM, image segmentation, promptable segmentation, zero-shot performance, SA-1B dataset, advanced architecture, auto-annotation, Ultralytics, pre-trained models, SAM base, SAM large, instance segmentation, computer vision, AI, artificial intelligence, machine learning, data annotation, segmentation masks, detection model, YOLO detection model, bibtex, Meta AI._ diff --git a/ultralytics-main/docs/en/models/yolo-nas.md b/ultralytics-main/docs/en/models/yolo-nas.md deleted file mode 100644 index cc041e7..0000000 --- a/ultralytics-main/docs/en/models/yolo-nas.md +++ /dev/null @@ -1,120 +0,0 @@ ---- -comments: true -description: Explore detailed documentation of YOLO-NAS, a superior object detection model. Learn about its features, pre-trained models, usage with Ultralytics Python API, and more. -keywords: YOLO-NAS, Deci AI, object detection, deep learning, neural architecture search, Ultralytics Python API, YOLO model, pre-trained models, quantization, optimization, COCO, Objects365, Roboflow 100 ---- - -# YOLO-NAS - -## Overview - -Developed by Deci AI, YOLO-NAS is a groundbreaking object detection foundational model. It is the product of advanced Neural Architecture Search technology, meticulously designed to address the limitations of previous YOLO models. With significant improvements in quantization support and accuracy-latency trade-offs, YOLO-NAS represents a major leap in object detection. - -![Model example image](https://learnopencv.com/wp-content/uploads/2023/05/yolo-nas_COCO_map_metrics.png) **Overview of YOLO-NAS.** YOLO-NAS employs quantization-aware blocks and selective quantization for optimal performance. The model, when converted to its INT8 quantized version, experiences a minimal precision drop, a significant improvement over other models. These advancements culminate in a superior architecture with unprecedented object detection capabilities and outstanding performance. - -### Key Features - -- **Quantization-Friendly Basic Block:** YOLO-NAS introduces a new basic block that is friendly to quantization, addressing one of the significant limitations of previous YOLO models. -- **Sophisticated Training and Quantization:** YOLO-NAS leverages advanced training schemes and post-training quantization to enhance performance. -- **AutoNAC Optimization and Pre-training:** YOLO-NAS utilizes AutoNAC optimization and is pre-trained on prominent datasets such as COCO, Objects365, and Roboflow 100. This pre-training makes it extremely suitable for downstream object detection tasks in production environments. - -## Pre-trained Models - -Experience the power of next-generation object detection with the pre-trained YOLO-NAS models provided by Ultralytics. These models are designed to deliver top-notch performance in terms of both speed and accuracy. Choose from a variety of options tailored to your specific needs: - -| Model | mAP | Latency (ms) | -|------------------|-------|--------------| -| YOLO-NAS S | 47.5 | 3.21 | -| YOLO-NAS M | 51.55 | 5.85 | -| YOLO-NAS L | 52.22 | 7.87 | -| YOLO-NAS S INT-8 | 47.03 | 2.36 | -| YOLO-NAS M INT-8 | 51.0 | 3.78 | -| YOLO-NAS L INT-8 | 52.1 | 4.78 | - -Each model variant is designed to offer a balance between Mean Average Precision (mAP) and latency, helping you optimize your object detection tasks for both performance and speed. - -## Usage Examples - -Ultralytics has made YOLO-NAS models easy to integrate into your Python applications via our `ultralytics` python package. The package provides a user-friendly Python API to streamline the process. - -The following examples show how to use YOLO-NAS models with the `ultralytics` package for inference and validation: - -### Inference and Validation Examples - -In this example we validate YOLO-NAS-s on the COCO8 dataset. - -!!! Example - - This example provides simple inference and validation code for YOLO-NAS. For handling inference results see [Predict](../modes/predict.md) mode. For using YOLO-NAS with additional modes see [Val](../modes/val.md) and [Export](../modes/export.md). YOLO-NAS on the `ultralytics` package does not support training. - - === "Python" - - PyTorch pretrained `*.pt` models files can be passed to the `NAS()` class to create a model instance in python: - - ```python - from ultralytics import NAS - - # Load a COCO-pretrained YOLO-NAS-s model - model = NAS('yolo_nas_s.pt') - - # Display model information (optional) - model.info() - - # Validate the model on the COCO8 example dataset - results = model.val(data='coco8.yaml') - - # Run inference with the YOLO-NAS-s model on the 'bus.jpg' image - results = model('path/to/bus.jpg') - ``` - - === "CLI" - - CLI commands are available to directly run the models: - - ```bash - # Load a COCO-pretrained YOLO-NAS-s model and validate it's performance on the COCO8 example dataset - yolo val model=yolo_nas_s.pt data=coco8.yaml - - # Load a COCO-pretrained YOLO-NAS-s model and run inference on the 'bus.jpg' image - yolo predict model=yolo_nas_s.pt source=path/to/bus.jpg - ``` - -## Supported Tasks and Modes - -We offer three variants of the YOLO-NAS models: Small (s), Medium (m), and Large (l). Each variant is designed to cater to different computational and performance needs: - -- **YOLO-NAS-s**: Optimized for environments where computational resources are limited but efficiency is key. -- **YOLO-NAS-m**: Offers a balanced approach, suitable for general-purpose object detection with higher accuracy. -- **YOLO-NAS-l**: Tailored for scenarios requiring the highest accuracy, where computational resources are less of a constraint. - -Below is a detailed overview of each model, including links to their pre-trained weights, the tasks they support, and their compatibility with different operating modes. - -| Model Type | Pre-trained Weights | Tasks Supported | Inference | Validation | Training | Export | -|------------|-----------------------------------------------------------------------------------------------|----------------------------------------|-----------|------------|----------|--------| -| YOLO-NAS-s | [yolo_nas_s.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolo_nas_s.pt) | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ❌ | ✅ | -| YOLO-NAS-m | [yolo_nas_m.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolo_nas_m.pt) | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ❌ | ✅ | -| YOLO-NAS-l | [yolo_nas_l.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolo_nas_l.pt) | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ❌ | ✅ | - -## Citations and Acknowledgements - -If you employ YOLO-NAS in your research or development work, please cite SuperGradients: - -!!! Quote "" - - === "BibTeX" - - ```bibtex - @misc{supergradients, - doi = {10.5281/ZENODO.7789328}, - url = {https://zenodo.org/record/7789328}, - author = {Aharon, Shay and {Louis-Dupont} and {Ofri Masad} and Yurkova, Kate and {Lotem Fridman} and {Lkdci} and Khvedchenya, Eugene and Rubin, Ran and Bagrov, Natan and Tymchenko, Borys and Keren, Tomer and Zhilko, Alexander and {Eran-Deci}}, - title = {Super-Gradients}, - publisher = {GitHub}, - journal = {GitHub repository}, - year = {2021}, - } - ``` - -We express our gratitude to Deci AI's [SuperGradients](https://github.com/Deci-AI/super-gradients/) team for their efforts in creating and maintaining this valuable resource for the computer vision community. We believe YOLO-NAS, with its innovative architecture and superior object detection capabilities, will become a critical tool for developers and researchers alike. - -_Keywords: YOLO-NAS, Deci AI, object detection, deep learning, neural architecture search, Ultralytics Python API, YOLO model, SuperGradients, pre-trained models, quantization-friendly basic block, advanced training schemes, post-training quantization, AutoNAC optimization, COCO, Objects365, Roboflow 100_ diff --git a/ultralytics-main/docs/en/models/yolo-world.md b/ultralytics-main/docs/en/models/yolo-world.md deleted file mode 100644 index 116d62d..0000000 --- a/ultralytics-main/docs/en/models/yolo-world.md +++ /dev/null @@ -1,216 +0,0 @@ ---- -comments: true -description: Discover YOLO-World, a YOLOv8-based framework for real-time open-vocabulary object detection in images. It enhances user interaction, boosts computational efficiency, and adapts across various vision tasks. -keywords: YOLO-World, YOLOv8, machine learning, CNN-based framework, object detection, real-time detection, Ultralytics, vision tasks, image processing, industrial applications, user interaction ---- - -# YOLO-World Model - -The YOLO-World Model introduces an advanced, real-time [Ultralytics](https://ultralytics.com) [YOLOv8](yolov8.md)-based approach for Open-Vocabulary Detection tasks. This innovation enables the detection of any object within an image based on descriptive texts. By significantly lowering computational demands while preserving competitive performance, YOLO-World emerges as a versatile tool for numerous vision-based applications. - -![YOLO-World Model architecture overview](https://github.com/ultralytics/ultralytics/assets/26833433/31105058-78c1-43ef-9573-4f41b06df531) - -## Overview - -YOLO-World tackles the challenges faced by traditional Open-Vocabulary detection models, which often rely on cumbersome Transformer models requiring extensive computational resources. These models' dependence on pre-defined object categories also restricts their utility in dynamic scenarios. YOLO-World revitalizes the YOLOv8 framework with open-vocabulary detection capabilities, employing vision-language modeling and pre-training on expansive datasets to excel at identifying a broad array of objects in zero-shot scenarios with unmatched efficiency. - -## Key Features - -1. **Real-time Solution:** Harnessing the computational speed of CNNs, YOLO-World delivers a swift open-vocabulary detection solution, catering to industries in need of immediate results. - -2. **Efficiency and Performance:** YOLO-World slashes computational and resource requirements without sacrificing performance, offering a robust alternative to models like SAM but at a fraction of the computational cost, enabling real-time applications. - -3. **Inference with Offline Vocabulary:** YOLO-World introduces a "prompt-then-detect" strategy, employing an offline vocabulary to enhance efficiency further. This approach enables the use of custom prompts computed apriori, including captions or categories, to be encoded and stored as offline vocabulary embeddings, streamlining the detection process. - -4. **Powered by YOLOv8:** Built upon [Ultralytics YOLOv8](yolov8.md), YOLO-World leverages the latest advancements in real-time object detection to facilitate open-vocabulary detection with unparalleled accuracy and speed. - -5. **Benchmark Excellence:** YOLO-World outperforms existing open-vocabulary detectors, including MDETR and GLIP series, in terms of speed and efficiency on standard benchmarks, showcasing YOLOv8's superior capability on a single NVIDIA V100 GPU. - -6. **Versatile Applications:** YOLO-World's innovative approach unlocks new possibilities for a multitude of vision tasks, delivering speed improvements by orders of magnitude over existing methods. - -## Available Models, Supported Tasks, and Operating Modes - -This section details the models available with their specific pre-trained weights, the tasks they support, and their compatibility with various operating modes such as [Inference](../modes/predict.md), [Validation](../modes/val.md), [Training](../modes/train.md), and [Export](../modes/export.md), denoted by ✅ for supported modes and ❌ for unsupported modes. - -!!! Note - - All the YOLOv8-World weights have been directly migrated from the official [YOLO-World](https://github.com/AILab-CVC/YOLO-World) repository, highlighting their excellent contributions. - -| Model Type | Pre-trained Weights | Tasks Supported | Inference | Validation | Training | Export | -|-----------------|-------------------------------------------------------------------------------------------------------|----------------------------------------|-----------|------------|----------|--------| -| YOLOv8s-world | [yolov8s-world.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8s-world.pt) | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ❌ | ❌ | -| YOLOv8s-worldv2 | [yolov8s-worldv2.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8s-worldv2.pt) | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ❌ | ✅ | -| YOLOv8m-world | [yolov8m-world.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8m-world.pt) | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ❌ | ❌ | -| YOLOv8m-worldv2 | [yolov8m-worldv2.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8m-worldv2.pt) | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ❌ | ✅ | -| YOLOv8l-world | [yolov8l-world.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8l-world.pt) | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ❌ | ❌ | -| YOLOv8l-worldv2 | [yolov8l-worldv2.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8l-worldv2.pt) | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ❌ | ✅ | -| YOLOv8x-world | [yolov8x-world.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8x-world.pt) | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ❌ | ❌ | -| YOLOv8x-worldv2 | [yolov8x-worldv2.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8x-worldv2.pt) | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ❌ | ✅ | - -## Zero-shot Transfer on COCO Dataset - -| Model Type | mAP | mAP50 | mAP75 | -|-----------------|------|-------|-------| -| yolov8s-world | 37.4 | 52.0 | 40.6 | -| yolov8s-worldv2 | 37.7 | 52.2 | 41.0 | -| yolov8m-world | 42.0 | 57.0 | 45.6 | -| yolov8m-worldv2 | 43.0 | 58.4 | 46.8 | -| yolov8l-world | 45.7 | 61.3 | 49.8 | -| yolov8l-worldv2 | 45.8 | 61.3 | 49.8 | -| yolov8x-world | 47.0 | 63.0 | 51.2 | -| yolov8x-worldv2 | 47.1 | 62.8 | 51.4 | - -## Usage Examples - -The YOLO-World models are easy to integrate into your Python applications. Ultralytics provides user-friendly Python API and CLI commands to streamline development. - -### Predict Usage - -Object detection is straightforward with the `predict` method, as illustrated below: - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLOWorld - - # Initialize a YOLO-World model - model = YOLOWorld('yolov8s-world.pt') # or select yolov8m/l-world.pt for different sizes - - # Execute inference with the YOLOv8s-world model on the specified image - results = model.predict('path/to/image.jpg') - - # Show results - results[0].show() - ``` - - === "CLI" - - ```bash - # Perform object detection using a YOLO-World model - yolo predict model=yolov8s-world.pt source=path/to/image.jpg imgsz=640 - ``` - -This snippet demonstrates the simplicity of loading a pre-trained model and running a prediction on an image. - -### Val Usage - -Model validation on a dataset is streamlined as follows: - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Create a YOLO-World model - model = YOLO('yolov8s-world.pt') # or select yolov8m/l-world.pt for different sizes - - # Conduct model validation on the COCO8 example dataset - metrics = model.val(data='coco8.yaml') - ``` - - === "CLI" - - ```bash - # Validate a YOLO-World model on the COCO8 dataset with a specified image size - yolo val model=yolov8s-world.pt data=coco8.yaml imgsz=640 - ``` - -!!! Note - - The YOLO-World models provided by Ultralytics come pre-configured with [COCO dataset](../datasets/detect/coco.md) categories as part of their offline vocabulary, enhancing efficiency for immediate application. This integration allows the YOLOv8-World models to directly recognize and predict the 80 standard categories defined in the COCO dataset without requiring additional setup or customization. - -### Set prompts - -![YOLO-World prompt class names overview](https://github.com/ultralytics/ultralytics/assets/26833433/4f609ec0-ae6d-4a85-a034-c1c1c30968ff) - -The YOLO-World framework allows for the dynamic specification of classes through custom prompts, empowering users to tailor the model to their specific needs **without retraining**. This feature is particularly useful for adapting the model to new domains or specific tasks that were not originally part of the training data. By setting custom prompts, users can essentially guide the model's focus towards objects of interest, enhancing the relevance and accuracy of the detection results. - -For instance, if your application only requires detecting 'person' and 'bus' objects, you can specify these classes directly: - -!!! Example - - === "Custom Inference Prompts" - - ```python - from ultralytics import YOLO - - # Initialize a YOLO-World model - model = YOLO('yolov8s-world.pt') # or choose yolov8m/l-world.pt - - # Define custom classes - model.set_classes(["person", "bus"]) - - # Execute prediction for specified categories on an image - results = model.predict('path/to/image.jpg') - - # Show results - results[0].show() - ``` - -You can also save a model after setting custom classes. By doing this you create a version of the YOLO-World model that is specialized for your specific use case. This process embeds your custom class definitions directly into the model file, making the model ready to use with your specified classes without further adjustments. Follow these steps to save and load your custom YOLOv8 model: - -!!! Example - - === "Persisting Models with Custom Vocabulary" - - First load a YOLO-World model, set custom classes for it and save it: - - ```python - from ultralytics import YOLO - - # Initialize a YOLO-World model - model = YOLO('yolov8s-world.pt') # or select yolov8m/l-world.pt - - # Define custom classes - model.set_classes(["person", "bus"]) - - # Save the model with the defined offline vocabulary - model.save("custom_yolov8s.pt") - ``` - - After saving, the custom_yolov8s.pt model behaves like any other pre-trained YOLOv8 model but with a key difference: it is now optimized to detect only the classes you have defined. This customization can significantly improve detection performance and efficiency for your specific application scenarios. - - ```python - from ultralytics import YOLO - - # Load your custom model - model = YOLO('custom_yolov8s.pt') - - # Run inference to detect your custom classes - results = model.predict('path/to/image.jpg') - - # Show results - results[0].show() - ``` - -### Benefits of Saving with Custom Vocabulary - -- **Efficiency**: Streamlines the detection process by focusing on relevant objects, reducing computational overhead and speeding up inference. -- **Flexibility**: Allows for easy adaptation of the model to new or niche detection tasks without the need for extensive retraining or data collection. -- **Simplicity**: Simplifies deployment by eliminating the need to repeatedly specify custom classes at runtime, making the model directly usable with its embedded vocabulary. -- **Performance**: Enhances detection accuracy for specified classes by focusing the model's attention and resources on recognizing the defined objects. - -This approach provides a powerful means of customizing state-of-the-art object detection models for specific tasks, making advanced AI more accessible and applicable to a broader range of practical applications. - -## Citations and Acknowledgements - -We extend our gratitude to the [Tencent AILab Computer Vision Center](https://ai.tencent.com/) for their pioneering work in real-time open-vocabulary object detection with YOLO-World: - -!!! Quote "" - - === "BibTeX" - - ```bibtex - @article{cheng2024yolow, - title={YOLO-World: Real-Time Open-Vocabulary Object Detection}, - author={Cheng, Tianheng and Song, Lin and Ge, Yixiao and Liu, Wenyu and Wang, Xinggang and Shan, Ying}, - journal={arXiv preprint arXiv:2401.17270}, - year={2024} - } - ``` - -For further reading, the original YOLO-World paper is available on [arXiv](https://arxiv.org/pdf/2401.17270v2.pdf). The project's source code and additional resources can be accessed via their [GitHub repository](https://github.com/AILab-CVC/YOLO-World). We appreciate their commitment to advancing the field and sharing their valuable insights with the community. diff --git a/ultralytics-main/docs/en/models/yolov3.md b/ultralytics-main/docs/en/models/yolov3.md deleted file mode 100644 index f24562f..0000000 --- a/ultralytics-main/docs/en/models/yolov3.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -comments: true -description: Get an overview of YOLOv3, YOLOv3-Ultralytics and YOLOv3u. Learn about their key features, usage, and supported tasks for object detection. -keywords: YOLOv3, YOLOv3-Ultralytics, YOLOv3u, Object Detection, Inference, Training, Ultralytics ---- - -# YOLOv3, YOLOv3-Ultralytics, and YOLOv3u - -## Overview - -This document presents an overview of three closely related object detection models, namely [YOLOv3](https://pjreddie.com/darknet/yolo/), [YOLOv3-Ultralytics](https://github.com/ultralytics/yolov3), and [YOLOv3u](https://github.com/ultralytics/ultralytics). - -1. **YOLOv3:** This is the third version of the You Only Look Once (YOLO) object detection algorithm. Originally developed by Joseph Redmon, YOLOv3 improved on its predecessors by introducing features such as multiscale predictions and three different sizes of detection kernels. - -2. **YOLOv3-Ultralytics:** This is Ultralytics' implementation of the YOLOv3 model. It reproduces the original YOLOv3 architecture and offers additional functionalities, such as support for more pre-trained models and easier customization options. - -3. **YOLOv3u:** This is an updated version of YOLOv3-Ultralytics that incorporates the anchor-free, objectness-free split head used in YOLOv8 models. YOLOv3u maintains the same backbone and neck architecture as YOLOv3 but with the updated detection head from YOLOv8. - -![Ultralytics YOLOv3](https://raw.githubusercontent.com/ultralytics/assets/main/yolov3/banner-yolov3.png) - -## Key Features - -- **YOLOv3:** Introduced the use of three different scales for detection, leveraging three different sizes of detection kernels: 13x13, 26x26, and 52x52. This significantly improved detection accuracy for objects of different sizes. Additionally, YOLOv3 added features such as multi-label predictions for each bounding box and a better feature extractor network. - -- **YOLOv3-Ultralytics:** Ultralytics' implementation of YOLOv3 provides the same performance as the original model but comes with added support for more pre-trained models, additional training methods, and easier customization options. This makes it more versatile and user-friendly for practical applications. - -- **YOLOv3u:** This updated model incorporates the anchor-free, objectness-free split head from YOLOv8. By eliminating the need for pre-defined anchor boxes and objectness scores, this detection head design can improve the model's ability to detect objects of varying sizes and shapes. This makes YOLOv3u more robust and accurate for object detection tasks. - -## Supported Tasks and Modes - -The YOLOv3 series, including YOLOv3, YOLOv3-Ultralytics, and YOLOv3u, are designed specifically for object detection tasks. These models are renowned for their effectiveness in various real-world scenarios, balancing accuracy and speed. Each variant offers unique features and optimizations, making them suitable for a range of applications. - -All three models support a comprehensive set of modes, ensuring versatility in various stages of model deployment and development. These modes include [Inference](../modes/predict.md), [Validation](../modes/val.md), [Training](../modes/train.md), and [Export](../modes/export.md), providing users with a complete toolkit for effective object detection. - -| Model Type | Tasks Supported | Inference | Validation | Training | Export | -|--------------------|----------------------------------------|-----------|------------|----------|--------| -| YOLOv3 | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ✅ | ✅ | -| YOLOv3-Ultralytics | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ✅ | ✅ | -| YOLOv3u | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ✅ | ✅ | - -This table provides an at-a-glance view of the capabilities of each YOLOv3 variant, highlighting their versatility and suitability for various tasks and operational modes in object detection workflows. - -## Usage Examples - -This example provides simple YOLOv3 training and inference examples. For full documentation on these and other [modes](../modes/index.md) see the [Predict](../modes/predict.md), [Train](../modes/train.md), [Val](../modes/val.md) and [Export](../modes/export.md) docs pages. - -!!! Example - - === "Python" - - PyTorch pretrained `*.pt` models as well as configuration `*.yaml` files can be passed to the `YOLO()` class to create a model instance in python: - - ```python - from ultralytics import YOLO - - # Load a COCO-pretrained YOLOv3n model - model = YOLO('yolov3n.pt') - - # Display model information (optional) - model.info() - - # Train the model on the COCO8 example dataset for 100 epochs - results = model.train(data='coco8.yaml', epochs=100, imgsz=640) - - # Run inference with the YOLOv3n model on the 'bus.jpg' image - results = model('path/to/bus.jpg') - ``` - - === "CLI" - - CLI commands are available to directly run the models: - - ```bash - # Load a COCO-pretrained YOLOv3n model and train it on the COCO8 example dataset for 100 epochs - yolo train model=yolov3n.pt data=coco8.yaml epochs=100 imgsz=640 - - # Load a COCO-pretrained YOLOv3n model and run inference on the 'bus.jpg' image - yolo predict model=yolov3n.pt source=path/to/bus.jpg - ``` - -## Citations and Acknowledgements - -If you use YOLOv3 in your research, please cite the original YOLO papers and the Ultralytics YOLOv3 repository: - -!!! Quote "" - - === "BibTeX" - - ```bibtex - @article{redmon2018yolov3, - title={YOLOv3: An Incremental Improvement}, - author={Redmon, Joseph and Farhadi, Ali}, - journal={arXiv preprint arXiv:1804.02767}, - year={2018} - } - ``` - -Thank you to Joseph Redmon and Ali Farhadi for developing the original YOLOv3. diff --git a/ultralytics-main/docs/en/models/yolov4.md b/ultralytics-main/docs/en/models/yolov4.md deleted file mode 100644 index bcc55b0..0000000 --- a/ultralytics-main/docs/en/models/yolov4.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -comments: true -description: Explore our detailed guide on YOLOv4, a state-of-the-art real-time object detector. Understand its architectural highlights, innovative features, and application examples. -keywords: ultralytics, YOLOv4, object detection, neural network, real-time detection, object detector, machine learning ---- - -# YOLOv4: High-Speed and Precise Object Detection - -Welcome to the Ultralytics documentation page for YOLOv4, a state-of-the-art, real-time object detector launched in 2020 by Alexey Bochkovskiy at [https://github.com/AlexeyAB/darknet](https://github.com/AlexeyAB/darknet). YOLOv4 is designed to provide the optimal balance between speed and accuracy, making it an excellent choice for many applications. - -![YOLOv4 architecture diagram](https://user-images.githubusercontent.com/26833433/246185689-530b7fe8-737b-4bb0-b5dd-de10ef5aface.png) **YOLOv4 architecture diagram**. Showcasing the intricate network design of YOLOv4, including the backbone, neck, and head components, and their interconnected layers for optimal real-time object detection. - -## Introduction - -YOLOv4 stands for You Only Look Once version 4. It is a real-time object detection model developed to address the limitations of previous YOLO versions like [YOLOv3](yolov3.md) and other object detection models. Unlike other convolutional neural network (CNN) based object detectors, YOLOv4 is not only applicable for recommendation systems but also for standalone process management and human input reduction. Its operation on conventional graphics processing units (GPUs) allows for mass usage at an affordable price, and it is designed to work in real-time on a conventional GPU while requiring only one such GPU for training. - -## Architecture - -YOLOv4 makes use of several innovative features that work together to optimize its performance. These include Weighted-Residual-Connections (WRC), Cross-Stage-Partial-connections (CSP), Cross mini-Batch Normalization (CmBN), Self-adversarial-training (SAT), Mish-activation, Mosaic data augmentation, DropBlock regularization, and CIoU loss. These features are combined to achieve state-of-the-art results. - -A typical object detector is composed of several parts including the input, the backbone, the neck, and the head. The backbone of YOLOv4 is pre-trained on ImageNet and is used to predict classes and bounding boxes of objects. The backbone could be from several models including VGG, ResNet, ResNeXt, or DenseNet. The neck part of the detector is used to collect feature maps from different stages and usually includes several bottom-up paths and several top-down paths. The head part is what is used to make the final object detections and classifications. - -## Bag of Freebies - -YOLOv4 also makes use of methods known as "bag of freebies," which are techniques that improve the accuracy of the model during training without increasing the cost of inference. Data augmentation is a common bag of freebies technique used in object detection, which increases the variability of the input images to improve the robustness of the model. Some examples of data augmentation include photometric distortions (adjusting the brightness, contrast, hue, saturation, and noise of an image) and geometric distortions (adding random scaling, cropping, flipping, and rotating). These techniques help the model to generalize better to different types of images. - -## Features and Performance - -YOLOv4 is designed for optimal speed and accuracy in object detection. The architecture of YOLOv4 includes CSPDarknet53 as the backbone, PANet as the neck, and YOLOv3 as the detection head. This design allows YOLOv4 to perform object detection at an impressive speed, making it suitable for real-time applications. YOLOv4 also excels in accuracy, achieving state-of-the-art results in object detection benchmarks. - -## Usage Examples - -As of the time of writing, Ultralytics does not currently support YOLOv4 models. Therefore, any users interested in using YOLOv4 will need to refer directly to the YOLOv4 GitHub repository for installation and usage instructions. - -Here is a brief overview of the typical steps you might take to use YOLOv4: - -1. Visit the YOLOv4 GitHub repository: [https://github.com/AlexeyAB/darknet](https://github.com/AlexeyAB/darknet). - -2. Follow the instructions provided in the README file for installation. This typically involves cloning the repository, installing necessary dependencies, and setting up any necessary environment variables. - -3. Once installation is complete, you can train and use the model as per the usage instructions provided in the repository. This usually involves preparing your dataset, configuring the model parameters, training the model, and then using the trained model to perform object detection. - -Please note that the specific steps may vary depending on your specific use case and the current state of the YOLOv4 repository. Therefore, it is strongly recommended to refer directly to the instructions provided in the YOLOv4 GitHub repository. - -We regret any inconvenience this may cause and will strive to update this document with usage examples for Ultralytics once support for YOLOv4 is implemented. - -## Conclusion - -YOLOv4 is a powerful and efficient object detection model that strikes a balance between speed and accuracy. Its use of unique features and bag of freebies techniques during training allows it to perform excellently in real-time object detection tasks. YOLOv4 can be trained and used by anyone with a conventional GPU, making it accessible and practical for a wide range of applications. - -## Citations and Acknowledgements - -We would like to acknowledge the YOLOv4 authors for their significant contributions in the field of real-time object detection: - -!!! Quote "" - - === "BibTeX" - - ```bibtex - @misc{bochkovskiy2020yolov4, - title={YOLOv4: Optimal Speed and Accuracy of Object Detection}, - author={Alexey Bochkovskiy and Chien-Yao Wang and Hong-Yuan Mark Liao}, - year={2020}, - eprint={2004.10934}, - archivePrefix={arXiv}, - primaryClass={cs.CV} - } - ``` - -The original YOLOv4 paper can be found on [arXiv](https://arxiv.org/abs/2004.10934). The authors have made their work publicly available, and the codebase can be accessed on [GitHub](https://github.com/AlexeyAB/darknet). We appreciate their efforts in advancing the field and making their work accessible to the broader community. diff --git a/ultralytics-main/docs/en/models/yolov5.md b/ultralytics-main/docs/en/models/yolov5.md deleted file mode 100644 index af43d32..0000000 --- a/ultralytics-main/docs/en/models/yolov5.md +++ /dev/null @@ -1,114 +0,0 @@ ---- -comments: true -description: Discover YOLOv5u, a boosted version of the YOLOv5 model featuring an improved accuracy-speed tradeoff and numerous pre-trained models for various object detection tasks. -keywords: YOLOv5u, object detection, pre-trained models, Ultralytics, Inference, Validation, YOLOv5, YOLOv8, anchor-free, objectness-free, real-time applications, machine learning ---- - -# YOLOv5 - -## Overview - -YOLOv5u represents an advancement in object detection methodologies. Originating from the foundational architecture of the [YOLOv5](https://github.com/ultralytics/yolov5) model developed by Ultralytics, YOLOv5u integrates the anchor-free, objectness-free split head, a feature previously introduced in the [YOLOv8](yolov8.md) models. This adaptation refines the model's architecture, leading to an improved accuracy-speed tradeoff in object detection tasks. Given the empirical results and its derived features, YOLOv5u provides an efficient alternative for those seeking robust solutions in both research and practical applications. - -![Ultralytics YOLOv5](https://raw.githubusercontent.com/ultralytics/assets/main/yolov5/v70/splash.png) - -## Key Features - -- **Anchor-free Split Ultralytics Head:** Traditional object detection models rely on predefined anchor boxes to predict object locations. However, YOLOv5u modernizes this approach. By adopting an anchor-free split Ultralytics head, it ensures a more flexible and adaptive detection mechanism, consequently enhancing the performance in diverse scenarios. - -- **Optimized Accuracy-Speed Tradeoff:** Speed and accuracy often pull in opposite directions. But YOLOv5u challenges this tradeoff. It offers a calibrated balance, ensuring real-time detections without compromising on accuracy. This feature is particularly invaluable for applications that demand swift responses, such as autonomous vehicles, robotics, and real-time video analytics. - -- **Variety of Pre-trained Models:** Understanding that different tasks require different toolsets, YOLOv5u provides a plethora of pre-trained models. Whether you're focusing on Inference, Validation, or Training, there's a tailor-made model awaiting you. This variety ensures you're not just using a one-size-fits-all solution, but a model specifically fine-tuned for your unique challenge. - -## Supported Tasks and Modes - -The YOLOv5u models, with various pre-trained weights, excel in [Object Detection](../tasks/detect.md) tasks. They support a comprehensive range of modes, making them suitable for diverse applications, from development to deployment. - -| Model Type | Pre-trained Weights | Task | Inference | Validation | Training | Export | -|------------|-----------------------------------------------------------------------------------------------------------------------------|----------------------------------------|-----------|------------|----------|--------| -| YOLOv5u | `yolov5nu`, `yolov5su`, `yolov5mu`, `yolov5lu`, `yolov5xu`, `yolov5n6u`, `yolov5s6u`, `yolov5m6u`, `yolov5l6u`, `yolov5x6u` | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ✅ | ✅ | - -This table provides a detailed overview of the YOLOv5u model variants, highlighting their applicability in object detection tasks and support for various operational modes such as [Inference](../modes/predict.md), [Validation](../modes/val.md), [Training](../modes/train.md), and [Export](../modes/export.md). This comprehensive support ensures that users can fully leverage the capabilities of YOLOv5u models in a wide range of object detection scenarios. - -## Performance Metrics - -!!! Performance - - === "Detection" - - See [Detection Docs](https://docs.ultralytics.com/tasks/detect/) for usage examples with these models trained on [COCO](https://docs.ultralytics.com/datasets/detect/coco/), which include 80 pre-trained classes. - - | Model | YAML | size
(pixels) | mAPval
50-95 | Speed
CPU ONNX
(ms) | Speed
A100 TensorRT
(ms) | params
(M) | FLOPs
(B) | - |---------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------|-----------------------|----------------------|--------------------------------|-------------------------------------|--------------------|-------------------| - | [yolov5nu.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov5nu.pt) | [yolov5n.yaml](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/models/v5/yolov5.yaml) | 640 | 34.3 | 73.6 | 1.06 | 2.6 | 7.7 | - | [yolov5su.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov5su.pt) | [yolov5s.yaml](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/models/v5/yolov5.yaml) | 640 | 43.0 | 120.7 | 1.27 | 9.1 | 24.0 | - | [yolov5mu.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov5mu.pt) | [yolov5m.yaml](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/models/v5/yolov5.yaml) | 640 | 49.0 | 233.9 | 1.86 | 25.1 | 64.2 | - | [yolov5lu.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov5lu.pt) | [yolov5l.yaml](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/models/v5/yolov5.yaml) | 640 | 52.2 | 408.4 | 2.50 | 53.2 | 135.0 | - | [yolov5xu.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov5xu.pt) | [yolov5x.yaml](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/models/v5/yolov5.yaml) | 640 | 53.2 | 763.2 | 3.81 | 97.2 | 246.4 | - | | | | | | | | | - | [yolov5n6u.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov5n6u.pt) | [yolov5n6.yaml](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/models/v5/yolov5-p6.yaml) | 1280 | 42.1 | 211.0 | 1.83 | 4.3 | 7.8 | - | [yolov5s6u.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov5s6u.pt) | [yolov5s6.yaml](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/models/v5/yolov5-p6.yaml) | 1280 | 48.6 | 422.6 | 2.34 | 15.3 | 24.6 | - | [yolov5m6u.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov5m6u.pt) | [yolov5m6.yaml](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/models/v5/yolov5-p6.yaml) | 1280 | 53.6 | 810.9 | 4.36 | 41.2 | 65.7 | - | [yolov5l6u.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov5l6u.pt) | [yolov5l6.yaml](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/models/v5/yolov5-p6.yaml) | 1280 | 55.7 | 1470.9 | 5.47 | 86.1 | 137.4 | - | [yolov5x6u.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov5x6u.pt) | [yolov5x6.yaml](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/models/v5/yolov5-p6.yaml) | 1280 | 56.8 | 2436.5 | 8.98 | 155.4 | 250.7 | - -## Usage Examples - -This example provides simple YOLOv5 training and inference examples. For full documentation on these and other [modes](../modes/index.md) see the [Predict](../modes/predict.md), [Train](../modes/train.md), [Val](../modes/val.md) and [Export](../modes/export.md) docs pages. - -!!! Example - - === "Python" - - PyTorch pretrained `*.pt` models as well as configuration `*.yaml` files can be passed to the `YOLO()` class to create a model instance in python: - - ```python - from ultralytics import YOLO - - # Load a COCO-pretrained YOLOv5n model - model = YOLO('yolov5n.pt') - - # Display model information (optional) - model.info() - - # Train the model on the COCO8 example dataset for 100 epochs - results = model.train(data='coco8.yaml', epochs=100, imgsz=640) - - # Run inference with the YOLOv5n model on the 'bus.jpg' image - results = model('path/to/bus.jpg') - ``` - - === "CLI" - - CLI commands are available to directly run the models: - - ```bash - # Load a COCO-pretrained YOLOv5n model and train it on the COCO8 example dataset for 100 epochs - yolo train model=yolov5n.pt data=coco8.yaml epochs=100 imgsz=640 - - # Load a COCO-pretrained YOLOv5n model and run inference on the 'bus.jpg' image - yolo predict model=yolov5n.pt source=path/to/bus.jpg - ``` - -## Citations and Acknowledgements - -If you use YOLOv5 or YOLOv5u in your research, please cite the Ultralytics YOLOv5 repository as follows: - -!!! Quote "" - - === "BibTeX" - - ```bibtex - @software{yolov5, - title = {Ultralytics YOLOv5}, - author = {Glenn Jocher}, - year = {2020}, - version = {7.0}, - license = {AGPL-3.0}, - url = {https://github.com/ultralytics/yolov5}, - doi = {10.5281/zenodo.3908559}, - orcid = {0000-0001-5950-6979} - } - ``` - -Please note that YOLOv5 models are provided under [AGPL-3.0](https://github.com/ultralytics/ultralytics/blob/main/LICENSE) and [Enterprise](https://ultralytics.com/license) licenses. diff --git a/ultralytics-main/docs/en/models/yolov6.md b/ultralytics-main/docs/en/models/yolov6.md deleted file mode 100644 index 3607917..0000000 --- a/ultralytics-main/docs/en/models/yolov6.md +++ /dev/null @@ -1,106 +0,0 @@ ---- -comments: true -description: Explore Meituan YOLOv6, a state-of-the-art object detection model striking a balance between speed and accuracy. Dive into features, pre-trained models, and Python usage. -keywords: Meituan YOLOv6, object detection, Ultralytics, YOLOv6 docs, Bi-directional Concatenation, Anchor-Aided Training, pretrained models, real-time applications ---- - -# Meituan YOLOv6 - -## Overview - -[Meituan](https://about.meituan.com/) YOLOv6 is a cutting-edge object detector that offers remarkable balance between speed and accuracy, making it a popular choice for real-time applications. This model introduces several notable enhancements on its architecture and training scheme, including the implementation of a Bi-directional Concatenation (BiC) module, an anchor-aided training (AAT) strategy, and an improved backbone and neck design for state-of-the-art accuracy on the COCO dataset. - -![Meituan YOLOv6](https://user-images.githubusercontent.com/26833433/240750495-4da954ce-8b3b-41c4-8afd-ddb74361d3c2.png) -![Model example image](https://user-images.githubusercontent.com/26833433/240750557-3e9ec4f0-0598-49a8-83ea-f33c91eb6d68.png) **Overview of YOLOv6.** Model architecture diagram showing the redesigned network components and training strategies that have led to significant performance improvements. (a) The neck of YOLOv6 (N and S are shown). Note for M/L, RepBlocks is replaced with CSPStackRep. (b) The structure of a BiC module. (c) A SimCSPSPPF block. ([source](https://arxiv.org/pdf/2301.05586.pdf)). - -### Key Features - -- **Bidirectional Concatenation (BiC) Module:** YOLOv6 introduces a BiC module in the neck of the detector, enhancing localization signals and delivering performance gains with negligible speed degradation. -- **Anchor-Aided Training (AAT) Strategy:** This model proposes AAT to enjoy the benefits of both anchor-based and anchor-free paradigms without compromising inference efficiency. -- **Enhanced Backbone and Neck Design:** By deepening YOLOv6 to include another stage in the backbone and neck, this model achieves state-of-the-art performance on the COCO dataset at high-resolution input. -- **Self-Distillation Strategy:** A new self-distillation strategy is implemented to boost the performance of smaller models of YOLOv6, enhancing the auxiliary regression branch during training and removing it at inference to avoid a marked speed decline. - -## Performance Metrics - -YOLOv6 provides various pre-trained models with different scales: - -- YOLOv6-N: 37.5% AP on COCO val2017 at 1187 FPS with NVIDIA Tesla T4 GPU. -- YOLOv6-S: 45.0% AP at 484 FPS. -- YOLOv6-M: 50.0% AP at 226 FPS. -- YOLOv6-L: 52.8% AP at 116 FPS. -- YOLOv6-L6: State-of-the-art accuracy in real-time. - -YOLOv6 also provides quantized models for different precisions and models optimized for mobile platforms. - -## Usage Examples - -This example provides simple YOLOv6 training and inference examples. For full documentation on these and other [modes](../modes/index.md) see the [Predict](../modes/predict.md), [Train](../modes/train.md), [Val](../modes/val.md) and [Export](../modes/export.md) docs pages. - -!!! Example - - === "Python" - - PyTorch pretrained `*.pt` models as well as configuration `*.yaml` files can be passed to the `YOLO()` class to create a model instance in python: - - ```python - from ultralytics import YOLO - - # Build a YOLOv6n model from scratch - model = YOLO('yolov6n.yaml') - - # Display model information (optional) - model.info() - - # Train the model on the COCO8 example dataset for 100 epochs - results = model.train(data='coco8.yaml', epochs=100, imgsz=640) - - # Run inference with the YOLOv6n model on the 'bus.jpg' image - results = model('path/to/bus.jpg') - ``` - - === "CLI" - - CLI commands are available to directly run the models: - - ```bash - # Build a YOLOv6n model from scratch and train it on the COCO8 example dataset for 100 epochs - yolo train model=yolov6n.yaml data=coco8.yaml epochs=100 imgsz=640 - - # Build a YOLOv6n model from scratch and run inference on the 'bus.jpg' image - yolo predict model=yolov6n.yaml source=path/to/bus.jpg - ``` - -## Supported Tasks and Modes - -The YOLOv6 series offers a range of models, each optimized for high-performance [Object Detection](../tasks/detect.md). These models cater to varying computational needs and accuracy requirements, making them versatile for a wide array of applications. - -| Model Type | Pre-trained Weights | Tasks Supported | Inference | Validation | Training | Export | -|------------|---------------------|----------------------------------------|-----------|------------|----------|--------| -| YOLOv6-N | `yolov6-n.pt` | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ✅ | ✅ | -| YOLOv6-S | `yolov6-s.pt` | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ✅ | ✅ | -| YOLOv6-M | `yolov6-m.pt` | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ✅ | ✅ | -| YOLOv6-L | `yolov6-l.pt` | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ✅ | ✅ | -| YOLOv6-L6 | `yolov6-l6.pt` | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ✅ | ✅ | - -This table provides a detailed overview of the YOLOv6 model variants, highlighting their capabilities in object detection tasks and their compatibility with various operational modes such as [Inference](../modes/predict.md), [Validation](../modes/val.md), [Training](../modes/train.md), and [Export](../modes/export.md). This comprehensive support ensures that users can fully leverage the capabilities of YOLOv6 models in a broad range of object detection scenarios. - -## Citations and Acknowledgements - -We would like to acknowledge the authors for their significant contributions in the field of real-time object detection: - -!!! Quote "" - - === "BibTeX" - - ```bibtex - @misc{li2023yolov6, - title={YOLOv6 v3.0: A Full-Scale Reloading}, - author={Chuyi Li and Lulu Li and Yifei Geng and Hongliang Jiang and Meng Cheng and Bo Zhang and Zaidan Ke and Xiaoming Xu and Xiangxiang Chu}, - year={2023}, - eprint={2301.05586}, - archivePrefix={arXiv}, - primaryClass={cs.CV} - } - ``` - -The original YOLOv6 paper can be found on [arXiv](https://arxiv.org/abs/2301.05586). The authors have made their work publicly available, and the codebase can be accessed on [GitHub](https://github.com/meituan/YOLOv6). We appreciate their efforts in advancing the field and making their work accessible to the broader community. diff --git a/ultralytics-main/docs/en/models/yolov7.md b/ultralytics-main/docs/en/models/yolov7.md deleted file mode 100644 index f3d99d5..0000000 --- a/ultralytics-main/docs/en/models/yolov7.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -comments: true -description: Explore the YOLOv7, a real-time object detector. Understand its superior speed, impressive accuracy, and unique trainable bag-of-freebies optimization focus. -keywords: YOLOv7, real-time object detector, state-of-the-art, Ultralytics, MS COCO dataset, model re-parameterization, dynamic label assignment, extended scaling, compound scaling ---- - -# YOLOv7: Trainable Bag-of-Freebies - -YOLOv7 is a state-of-the-art real-time object detector that surpasses all known object detectors in both speed and accuracy in the range from 5 FPS to 160 FPS. It has the highest accuracy (56.8% AP) among all known real-time object detectors with 30 FPS or higher on GPU V100. Moreover, YOLOv7 outperforms other object detectors such as YOLOR, YOLOX, Scaled-YOLOv4, YOLOv5, and many others in speed and accuracy. The model is trained on the MS COCO dataset from scratch without using any other datasets or pre-trained weights. Source code for YOLOv7 is available on GitHub. - -![YOLOv7 comparison with SOTA object detectors](https://github.com/ultralytics/ultralytics/assets/26833433/5e1e0420-8122-4c79-b8d0-2860aa79af92) -**Comparison of state-of-the-art object detectors.** From the results in Table 2 we know that the proposed method has the best speed-accuracy trade-off comprehensively. If we compare YOLOv7-tiny-SiLU with YOLOv5-N (r6.1), our method is 127 fps faster and 10.7% more accurate on AP. In addition, YOLOv7 has 51.4% AP at frame rate of 161 fps, while PPYOLOE-L with the same AP has only 78 fps frame rate. In terms of parameter usage, YOLOv7 is 41% less than PPYOLOE-L. If we compare YOLOv7-X with 114 fps inference speed to YOLOv5-L (r6.1) with 99 fps inference speed, YOLOv7-X can improve AP by 3.9%. If YOLOv7-X is compared with YOLOv5-X (r6.1) of similar scale, the inference speed of YOLOv7-X is 31 fps faster. In addition, in terms the amount of parameters and computation, YOLOv7-X reduces 22% of parameters and 8% of computation compared to YOLOv5-X (r6.1), but improves AP by 2.2% ([Source](https://arxiv.org/pdf/2207.02696.pdf)). - -## Overview - -Real-time object detection is an important component in many computer vision systems, including multi-object tracking, autonomous driving, robotics, and medical image analysis. In recent years, real-time object detection development has focused on designing efficient architectures and improving the inference speed of various CPUs, GPUs, and neural processing units (NPUs). YOLOv7 supports both mobile GPU and GPU devices, from the edge to the cloud. - -Unlike traditional real-time object detectors that focus on architecture optimization, YOLOv7 introduces a focus on the optimization of the training process. This includes modules and optimization methods designed to improve the accuracy of object detection without increasing the inference cost, a concept known as the "trainable bag-of-freebies". - -## Key Features - -YOLOv7 introduces several key features: - -1. **Model Re-parameterization**: YOLOv7 proposes a planned re-parameterized model, which is a strategy applicable to layers in different networks with the concept of gradient propagation path. - -2. **Dynamic Label Assignment**: The training of the model with multiple output layers presents a new issue: "How to assign dynamic targets for the outputs of different branches?" To solve this problem, YOLOv7 introduces a new label assignment method called coarse-to-fine lead guided label assignment. - -3. **Extended and Compound Scaling**: YOLOv7 proposes "extend" and "compound scaling" methods for the real-time object detector that can effectively utilize parameters and computation. - -4. **Efficiency**: The method proposed by YOLOv7 can effectively reduce about 40% parameters and 50% computation of state-of-the-art real-time object detector, and has faster inference speed and higher detection accuracy. - -## Usage Examples - -As of the time of writing, Ultralytics does not currently support YOLOv7 models. Therefore, any users interested in using YOLOv7 will need to refer directly to the YOLOv7 GitHub repository for installation and usage instructions. - -Here is a brief overview of the typical steps you might take to use YOLOv7: - -1. Visit the YOLOv7 GitHub repository: [https://github.com/WongKinYiu/yolov7](https://github.com/WongKinYiu/yolov7). - -2. Follow the instructions provided in the README file for installation. This typically involves cloning the repository, installing necessary dependencies, and setting up any necessary environment variables. - -3. Once installation is complete, you can train and use the model as per the usage instructions provided in the repository. This usually involves preparing your dataset, configuring the model parameters, training the model, and then using the trained model to perform object detection. - -Please note that the specific steps may vary depending on your specific use case and the current state of the YOLOv7 repository. Therefore, it is strongly recommended to refer directly to the instructions provided in the YOLOv7 GitHub repository. - -We regret any inconvenience this may cause and will strive to update this document with usage examples for Ultralytics once support for YOLOv7 is implemented. - -## Citations and Acknowledgements - -We would like to acknowledge the YOLOv7 authors for their significant contributions in the field of real-time object detection: - -!!! Quote "" - - === "BibTeX" - - ```bibtex - @article{wang2022yolov7, - title={{YOLOv7}: Trainable bag-of-freebies sets new state-of-the-art for real-time object detectors}, - author={Wang, Chien-Yao and Bochkovskiy, Alexey and Liao, Hong-Yuan Mark}, - journal={arXiv preprint arXiv:2207.02696}, - year={2022} - } - ``` - -The original YOLOv7 paper can be found on [arXiv](https://arxiv.org/pdf/2207.02696.pdf). The authors have made their work publicly available, and the codebase can be accessed on [GitHub](https://github.com/WongKinYiu/yolov7). We appreciate their efforts in advancing the field and making their work accessible to the broader community. diff --git a/ultralytics-main/docs/en/models/yolov8.md b/ultralytics-main/docs/en/models/yolov8.md deleted file mode 100644 index e793677..0000000 --- a/ultralytics-main/docs/en/models/yolov8.md +++ /dev/null @@ -1,186 +0,0 @@ ---- -comments: true -description: Explore the thrilling features of YOLOv8, the latest version of our real-time object detector! Learn how advanced architectures, pre-trained models and optimal balance between accuracy & speed make YOLOv8 the perfect choice for your object detection tasks. -keywords: YOLOv8, Ultralytics, real-time object detector, pre-trained models, documentation, object detection, YOLO series, advanced architectures, accuracy, speed ---- - -# YOLOv8 - -## Overview - -YOLOv8 is the latest iteration in the YOLO series of real-time object detectors, offering cutting-edge performance in terms of accuracy and speed. Building upon the advancements of previous YOLO versions, YOLOv8 introduces new features and optimizations that make it an ideal choice for various object detection tasks in a wide range of applications. - -![Ultralytics YOLOv8](https://raw.githubusercontent.com/ultralytics/assets/main/yolov8/yolo-comparison-plots.png) - -

-
- -
- Watch: Ultralytics YOLOv8 Model Overview -

- -## Key Features - -- **Advanced Backbone and Neck Architectures:** YOLOv8 employs state-of-the-art backbone and neck architectures, resulting in improved feature extraction and object detection performance. -- **Anchor-free Split Ultralytics Head:** YOLOv8 adopts an anchor-free split Ultralytics head, which contributes to better accuracy and a more efficient detection process compared to anchor-based approaches. -- **Optimized Accuracy-Speed Tradeoff:** With a focus on maintaining an optimal balance between accuracy and speed, YOLOv8 is suitable for real-time object detection tasks in diverse application areas. -- **Variety of Pre-trained Models:** YOLOv8 offers a range of pre-trained models to cater to various tasks and performance requirements, making it easier to find the right model for your specific use case. - -## Supported Tasks and Modes - -The YOLOv8 series offers a diverse range of models, each specialized for specific tasks in computer vision. These models are designed to cater to various requirements, from object detection to more complex tasks like instance segmentation, pose/keypoints detection, oriented object detection, and classification. - -Each variant of the YOLOv8 series is optimized for its respective task, ensuring high performance and accuracy. Additionally, these models are compatible with various operational modes including [Inference](../modes/predict.md), [Validation](../modes/val.md), [Training](../modes/train.md), and [Export](../modes/export.md), facilitating their use in different stages of deployment and development. - -| Model | Filenames | Task | Inference | Validation | Training | Export | -|-------------|----------------------------------------------------------------------------------------------------------------|----------------------------------------------|-----------|------------|----------|--------| -| YOLOv8 | `yolov8n.pt` `yolov8s.pt` `yolov8m.pt` `yolov8l.pt` `yolov8x.pt` | [Detection](../tasks/detect.md) | ✅ | ✅ | ✅ | ✅ | -| YOLOv8-seg | `yolov8n-seg.pt` `yolov8s-seg.pt` `yolov8m-seg.pt` `yolov8l-seg.pt` `yolov8x-seg.pt` | [Instance Segmentation](../tasks/segment.md) | ✅ | ✅ | ✅ | ✅ | -| YOLOv8-pose | `yolov8n-pose.pt` `yolov8s-pose.pt` `yolov8m-pose.pt` `yolov8l-pose.pt` `yolov8x-pose.pt` `yolov8x-pose-p6.pt` | [Pose/Keypoints](../tasks/pose.md) | ✅ | ✅ | ✅ | ✅ | -| YOLOv8-obb | `yolov8n-obb.pt` `yolov8s-obb.pt` `yolov8m-obb.pt` `yolov8l-obb.pt` `yolov8x-obb.pt` | [Oriented Detection](../tasks/obb.md) | ✅ | ✅ | ✅ | ✅ | -| YOLOv8-cls | `yolov8n-cls.pt` `yolov8s-cls.pt` `yolov8m-cls.pt` `yolov8l-cls.pt` `yolov8x-cls.pt` | [Classification](../tasks/classify.md) | ✅ | ✅ | ✅ | ✅ | - -This table provides an overview of the YOLOv8 model variants, highlighting their applicability in specific tasks and their compatibility with various operational modes such as Inference, Validation, Training, and Export. It showcases the versatility and robustness of the YOLOv8 series, making them suitable for a variety of applications in computer vision. - -## Performance Metrics - -!!! Performance - - === "Detection (COCO)" - - See [Detection Docs](https://docs.ultralytics.com/tasks/detect/) for usage examples with these models trained on [COCO](https://docs.ultralytics.com/datasets/detect/coco/), which include 80 pre-trained classes. - - | Model | size
(pixels) | mAPval
50-95 | Speed
CPU ONNX
(ms) | Speed
A100 TensorRT
(ms) | params
(M) | FLOPs
(B) | - | ------------------------------------------------------------------------------------ | --------------------- | -------------------- | ------------------------------ | ----------------------------------- | ------------------ | ----------------- | - | [YOLOv8n](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8n.pt) | 640 | 37.3 | 80.4 | 0.99 | 3.2 | 8.7 | - | [YOLOv8s](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8s.pt) | 640 | 44.9 | 128.4 | 1.20 | 11.2 | 28.6 | - | [YOLOv8m](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8m.pt) | 640 | 50.2 | 234.7 | 1.83 | 25.9 | 78.9 | - | [YOLOv8l](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8l.pt) | 640 | 52.9 | 375.2 | 2.39 | 43.7 | 165.2 | - | [YOLOv8x](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8x.pt) | 640 | 53.9 | 479.1 | 3.53 | 68.2 | 257.8 | - - === "Detection (Open Images V7)" - - See [Detection Docs](https://docs.ultralytics.com/tasks/detect/) for usage examples with these models trained on [Open Image V7](https://docs.ultralytics.com/datasets/detect/open-images-v7/), which include 600 pre-trained classes. - - | Model | size
(pixels) | mAPval
50-95 | Speed
CPU ONNX
(ms) | Speed
A100 TensorRT
(ms) | params
(M) | FLOPs
(B) | - | ----------------------------------------------------------------------------------------- | --------------------- | -------------------- | ------------------------------ | ----------------------------------- | ------------------ | ----------------- | - | [YOLOv8n](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8n-oiv7.pt) | 640 | 18.4 | 142.4 | 1.21 | 3.5 | 10.5 | - | [YOLOv8s](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8s-oiv7.pt) | 640 | 27.7 | 183.1 | 1.40 | 11.4 | 29.7 | - | [YOLOv8m](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8m-oiv7.pt) | 640 | 33.6 | 408.5 | 2.26 | 26.2 | 80.6 | - | [YOLOv8l](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8l-oiv7.pt) | 640 | 34.9 | 596.9 | 2.43 | 44.1 | 167.4 | - | [YOLOv8x](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8x-oiv7.pt) | 640 | 36.3 | 860.6 | 3.56 | 68.7 | 260.6 | - - === "Segmentation (COCO)" - - See [Segmentation Docs](https://docs.ultralytics.com/tasks/segment/) for usage examples with these models trained on [COCO](https://docs.ultralytics.com/datasets/segment/coco/), which include 80 pre-trained classes. - - | Model | size
(pixels) | mAPbox
50-95 | mAPmask
50-95 | Speed
CPU ONNX
(ms) | Speed
A100 TensorRT
(ms) | params
(M) | FLOPs
(B) | - | -------------------------------------------------------------------------------------------- | --------------------- | -------------------- | --------------------- | ------------------------------ | ----------------------------------- | ------------------ | ----------------- | - | [YOLOv8n-seg](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8n-seg.pt) | 640 | 36.7 | 30.5 | 96.1 | 1.21 | 3.4 | 12.6 | - | [YOLOv8s-seg](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8s-seg.pt) | 640 | 44.6 | 36.8 | 155.7 | 1.47 | 11.8 | 42.6 | - | [YOLOv8m-seg](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8m-seg.pt) | 640 | 49.9 | 40.8 | 317.0 | 2.18 | 27.3 | 110.2 | - | [YOLOv8l-seg](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8l-seg.pt) | 640 | 52.3 | 42.6 | 572.4 | 2.79 | 46.0 | 220.5 | - | [YOLOv8x-seg](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8x-seg.pt) | 640 | 53.4 | 43.4 | 712.1 | 4.02 | 71.8 | 344.1 | - - === "Classification (ImageNet)" - - See [Classification Docs](https://docs.ultralytics.com/tasks/classify/) for usage examples with these models trained on [ImageNet](https://docs.ultralytics.com/datasets/classify/imagenet/), which include 1000 pre-trained classes. - - | Model | size
(pixels) | acc
top1 | acc
top5 | Speed
CPU ONNX
(ms) | Speed
A100 TensorRT
(ms) | params
(M) | FLOPs
(B) at 640 | - | -------------------------------------------------------------------------------------------- | --------------------- | ---------------- | ---------------- | ------------------------------ | ----------------------------------- | ------------------ | ------------------------ | - | [YOLOv8n-cls](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8n-cls.pt) | 224 | 69.0 | 88.3 | 12.9 | 0.31 | 2.7 | 4.3 | - | [YOLOv8s-cls](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8s-cls.pt) | 224 | 73.8 | 91.7 | 23.4 | 0.35 | 6.4 | 13.5 | - | [YOLOv8m-cls](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8m-cls.pt) | 224 | 76.8 | 93.5 | 85.4 | 0.62 | 17.0 | 42.7 | - | [YOLOv8l-cls](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8l-cls.pt) | 224 | 76.8 | 93.5 | 163.0 | 0.87 | 37.5 | 99.7 | - | [YOLOv8x-cls](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8x-cls.pt) | 224 | 79.0 | 94.6 | 232.0 | 1.01 | 57.4 | 154.8 | - - === "Pose (COCO)" - - See [Pose Estimation Docs](https://docs.ultralytics.com/tasks/pose/) for usage examples with these models trained on [COCO](https://docs.ultralytics.com/datasets/pose/coco/), which include 1 pre-trained class, 'person'. - - | Model | size
(pixels) | mAPpose
50-95 | mAPpose
50 | Speed
CPU ONNX
(ms) | Speed
A100 TensorRT
(ms) | params
(M) | FLOPs
(B) | - | ---------------------------------------------------------------------------------------------------- | --------------------- | --------------------- | ------------------ | ------------------------------ | ----------------------------------- | ------------------ | ----------------- | - | [YOLOv8n-pose](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8n-pose.pt) | 640 | 50.4 | 80.1 | 131.8 | 1.18 | 3.3 | 9.2 | - | [YOLOv8s-pose](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8s-pose.pt) | 640 | 60.0 | 86.2 | 233.2 | 1.42 | 11.6 | 30.2 | - | [YOLOv8m-pose](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8m-pose.pt) | 640 | 65.0 | 88.8 | 456.3 | 2.00 | 26.4 | 81.0 | - | [YOLOv8l-pose](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8l-pose.pt) | 640 | 67.6 | 90.0 | 784.5 | 2.59 | 44.4 | 168.6 | - | [YOLOv8x-pose](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8x-pose.pt) | 640 | 69.2 | 90.2 | 1607.1 | 3.73 | 69.4 | 263.2 | - | [YOLOv8x-pose-p6](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8x-pose-p6.pt) | 1280 | 71.6 | 91.2 | 4088.7 | 10.04 | 99.1 | 1066.4 | - - === "OBB (DOTAv1)" - - See [Oriented Detection Docs](https://docs.ultralytics.com/tasks/obb/) for usage examples with these models trained on [DOTAv1](https://docs.ultralytics.com/datasets/obb/dota-v2/#dota-v10/), which include 15 pre-trained classes. - - | Model | size
(pixels) | mAPtest
50 | Speed
CPU ONNX
(ms) | Speed
A100 TensorRT
(ms) | params
(M) | FLOPs
(B) | - |----------------------------------------------------------------------------------------------|-----------------------| -------------------- | -------------------------------- | ------------------------------------- | -------------------- | ----------------- | - | [YOLOv8n-obb](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8n-obb.pt) | 1024 | 78.0 | 204.77 | 3.57 | 3.1 | 23.3 | - | [YOLOv8s-obb](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8s-obb.pt) | 1024 | 79.5 | 424.88 | 4.07 | 11.4 | 76.3 | - | [YOLOv8m-obb](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8m-obb.pt) | 1024 | 80.5 | 763.48 | 7.61 | 26.4 | 208.6 | - | [YOLOv8l-obb](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8l-obb.pt) | 1024 | 80.7 | 1278.42 | 11.83 | 44.5 | 433.8 | - | [YOLOv8x-obb](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8x-obb.pt) | 1024 | 81.36 | 1759.10 | 13.23 | 69.5 | 676.7 | - -## Usage Examples - -This example provides simple YOLOv8 training and inference examples. For full documentation on these and other [modes](../modes/index.md) see the [Predict](../modes/predict.md), [Train](../modes/train.md), [Val](../modes/val.md) and [Export](../modes/export.md) docs pages. - -Note the below example is for YOLOv8 [Detect](../tasks/detect.md) models for object detection. For additional supported tasks see the [Segment](../tasks/segment.md), [Classify](../tasks/classify.md), [OBB](../tasks/obb.md) docs and [Pose](../tasks/pose.md) docs. - -!!! Example - - === "Python" - - PyTorch pretrained `*.pt` models as well as configuration `*.yaml` files can be passed to the `YOLO()` class to create a model instance in python: - - ```python - from ultralytics import YOLO - - # Load a COCO-pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Display model information (optional) - model.info() - - # Train the model on the COCO8 example dataset for 100 epochs - results = model.train(data='coco8.yaml', epochs=100, imgsz=640) - - # Run inference with the YOLOv8n model on the 'bus.jpg' image - results = model('path/to/bus.jpg') - ``` - - === "CLI" - - CLI commands are available to directly run the models: - - ```bash - # Load a COCO-pretrained YOLOv8n model and train it on the COCO8 example dataset for 100 epochs - yolo train model=yolov8n.pt data=coco8.yaml epochs=100 imgsz=640 - - # Load a COCO-pretrained YOLOv8n model and run inference on the 'bus.jpg' image - yolo predict model=yolov8n.pt source=path/to/bus.jpg - ``` - -## Citations and Acknowledgements - -If you use the YOLOv8 model or any other software from this repository in your work, please cite it using the following format: - -!!! Quote "" - - === "BibTeX" - - ```bibtex - @software{yolov8_ultralytics, - author = {Glenn Jocher and Ayush Chaurasia and Jing Qiu}, - title = {Ultralytics YOLOv8}, - version = {8.0.0}, - year = {2023}, - url = {https://github.com/ultralytics/ultralytics}, - orcid = {0000-0001-5950-6979, 0000-0002-7603-6750, 0000-0003-3783-7069}, - license = {AGPL-3.0} - } - ``` - -Please note that the DOI is pending and will be added to the citation once it is available. YOLOv8 models are provided under [AGPL-3.0](https://github.com/ultralytics/ultralytics/blob/main/LICENSE) and [Enterprise](https://ultralytics.com/license) licenses. diff --git a/ultralytics-main/docs/en/models/yolov9.md b/ultralytics-main/docs/en/models/yolov9.md deleted file mode 100644 index 51ddfff..0000000 --- a/ultralytics-main/docs/en/models/yolov9.md +++ /dev/null @@ -1,152 +0,0 @@ ---- -comments: true -description: Discover YOLOv9, the latest addition to the real-time object detection arsenal, leveraging Programmable Gradient Information and GELAN architecture for unparalleled performance. -keywords: YOLOv9, real-time object detection, Programmable Gradient Information, GELAN architecture, Ultralytics, MS COCO dataset, open-source, lightweight model, computer vision, AI ---- - -# YOLOv9: A Leap Forward in Object Detection Technology - -YOLOv9 marks a significant advancement in real-time object detection, introducing groundbreaking techniques such as Programmable Gradient Information (PGI) and the Generalized Efficient Layer Aggregation Network (GELAN). This model demonstrates remarkable improvements in efficiency, accuracy, and adaptability, setting new benchmarks on the MS COCO dataset. The YOLOv9 project, while developed by a separate open-source team, builds upon the robust codebase provided by [Ultralytics](https://ultralytics.com) [YOLOv5](yolov5.md), showcasing the collaborative spirit of the AI research community. - -![YOLOv9 performance comparison](https://github.com/ultralytics/ultralytics/assets/26833433/9f41ef7b-6008-43eb-8ba1-0a9b89600100) - -## Introduction to YOLOv9 - -In the quest for optimal real-time object detection, YOLOv9 stands out with its innovative approach to overcoming information loss challenges inherent in deep neural networks. By integrating PGI and the versatile GELAN architecture, YOLOv9 not only enhances the model's learning capacity but also ensures the retention of crucial information throughout the detection process, thereby achieving exceptional accuracy and performance. - -## Core Innovations of YOLOv9 - -YOLOv9's advancements are deeply rooted in addressing the challenges posed by information loss in deep neural networks. The Information Bottleneck Principle and the innovative use of Reversible Functions are central to its design, ensuring YOLOv9 maintains high efficiency and accuracy. - -### Information Bottleneck Principle - -The Information Bottleneck Principle reveals a fundamental challenge in deep learning: as data passes through successive layers of a network, the potential for information loss increases. This phenomenon is mathematically represented as: - -```python -I(X, X) >= I(X, f_theta(X)) >= I(X, g_phi(f_theta(X))) -``` - -where `I` denotes mutual information, and `f` and `g` represent transformation functions with parameters `theta` and `phi`, respectively. YOLOv9 counters this challenge by implementing Programmable Gradient Information (PGI), which aids in preserving essential data across the network's depth, ensuring more reliable gradient generation and, consequently, better model convergence and performance. - -### Reversible Functions - -The concept of Reversible Functions is another cornerstone of YOLOv9's design. A function is deemed reversible if it can be inverted without any loss of information, as expressed by: - -```python -X = v_zeta(r_psi(X)) -``` - -with `psi` and `zeta` as parameters for the reversible and its inverse function, respectively. This property is crucial for deep learning architectures, as it allows the network to retain a complete information flow, thereby enabling more accurate updates to the model's parameters. YOLOv9 incorporates reversible functions within its architecture to mitigate the risk of information degradation, especially in deeper layers, ensuring the preservation of critical data for object detection tasks. - -### Impact on Lightweight Models - -Addressing information loss is particularly vital for lightweight models, which are often under-parameterized and prone to losing significant information during the feedforward process. YOLOv9's architecture, through the use of PGI and reversible functions, ensures that even with a streamlined model, the essential information required for accurate object detection is retained and effectively utilized. - -### Programmable Gradient Information (PGI) - -PGI is a novel concept introduced in YOLOv9 to combat the information bottleneck problem, ensuring the preservation of essential data across deep network layers. This allows for the generation of reliable gradients, facilitating accurate model updates and improving the overall detection performance. - -### Generalized Efficient Layer Aggregation Network (GELAN) - -GELAN represents a strategic architectural advancement, enabling YOLOv9 to achieve superior parameter utilization and computational efficiency. Its design allows for flexible integration of various computational blocks, making YOLOv9 adaptable to a wide range of applications without sacrificing speed or accuracy. - -![YOLOv9 architecture comparison](https://github.com/ultralytics/ultralytics/assets/26833433/286a3971-677b-45e6-a90b-4b6bd565a7af) - -## Performance on MS COCO Dataset - -The performance of YOLOv9 on the [COCO dataset](../datasets/detect/coco.md) exemplifies its significant advancements in real-time object detection, setting new benchmarks across various model sizes. Table 1 presents a comprehensive comparison of state-of-the-art real-time object detectors, illustrating YOLOv9's superior efficiency and accuracy. - -**Table 1. Comparison of State-of-the-Art Real-Time Object Detectors** - -| Model | size
(pixels) | APval
50-95 | APval
50 | APval
75 | params
(M) | FLOPs
(B) | -|---------------------------------------------------------------------------------------|-----------------------|---------------------|------------------|------------------|--------------------|-------------------| -| YOLOv9-S | 640 | 46.8 | 63.4 | 50.7 | 7.2 | 26.7 | -| YOLOv9-M | 640 | 51.4 | 68.1 | 56.1 | 20.1 | 76.8 | -| [YOLOv9-C](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov9c.pt) | 640 | 53.0 | 70.2 | 57.8 | 25.5 | 102.8 | -| [YOLOv9-E](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov9e.pt) | 640 | 55.6 | 72.8 | 60.6 | 58.1 | 192.5 | - -YOLOv9's iterations, ranging from the smaller S variant to the extensive E model, demonstrate improvements not only in accuracy (AP metrics) but also in efficiency with a reduced number of parameters and computational needs (FLOPs). This table underscores YOLOv9's ability to deliver high precision while maintaining or reducing the computational overhead compared to prior versions and competing models. - -Comparatively, YOLOv9 exhibits remarkable gains: - -- **Lightweight Models**: YOLOv9-S surpasses the YOLO MS-S in parameter efficiency and computational load while achieving an improvement of 0.4∼0.6% in AP. -- **Medium to Large Models**: YOLOv9-M and YOLOv9-E show notable advancements in balancing the trade-off between model complexity and detection performance, offering significant reductions in parameters and computations against the backdrop of improved accuracy. - -The YOLOv9-C model, in particular, highlights the effectiveness of the architecture's optimizations. It operates with 42% fewer parameters and 21% less computational demand than YOLOv7 AF, yet it achieves comparable accuracy, demonstrating YOLOv9's significant efficiency improvements. Furthermore, the YOLOv9-E model sets a new standard for large models, with 15% fewer parameters and 25% less computational need than [YOLOv8x](yolov8.md), alongside a substantial 1.7% improvement in AP. - -These results showcase YOLOv9's strategic advancements in model design, emphasizing its enhanced efficiency without compromising on the precision essential for real-time object detection tasks. The model not only pushes the boundaries of performance metrics but also emphasizes the importance of computational efficiency, making it a pivotal development in the field of computer vision. - -## Conclusion - -YOLOv9 represents a pivotal development in real-time object detection, offering significant improvements in terms of efficiency, accuracy, and adaptability. By addressing critical challenges through innovative solutions like PGI and GELAN, YOLOv9 sets a new precedent for future research and application in the field. As the AI community continues to evolve, YOLOv9 stands as a testament to the power of collaboration and innovation in driving technological progress. - -## Usage Examples - -This example provides simple YOLOv9 training and inference examples. For full documentation on these and other [modes](../modes/index.md) see the [Predict](../modes/predict.md), [Train](../modes/train.md), [Val](../modes/val.md) and [Export](../modes/export.md) docs pages. - -!!! Example - - === "Python" - - PyTorch pretrained `*.pt` models as well as configuration `*.yaml` files can be passed to the `YOLO()` class to create a model instance in python: - - ```python - from ultralytics import YOLO - - # Build a YOLOv9c model from scratch - model = YOLO('yolov9c.yaml') - - # Build a YOLOv9c model from pretrained weight - model = YOLO('yolov9c.pt') - - # Display model information (optional) - model.info() - - # Train the model on the COCO8 example dataset for 100 epochs - results = model.train(data='coco8.yaml', epochs=100, imgsz=640) - - # Run inference with the YOLOv9c model on the 'bus.jpg' image - results = model('path/to/bus.jpg') - ``` - - === "CLI" - - CLI commands are available to directly run the models: - - ```bash - # Build a YOLOv9c model from scratch and train it on the COCO8 example dataset for 100 epochs - yolo train model=yolov9c.yaml data=coco8.yaml epochs=100 imgsz=640 - - # Build a YOLOv9c model from scratch and run inference on the 'bus.jpg' image - yolo predict model=yolov9c.yaml source=path/to/bus.jpg - ``` - -## Supported Tasks and Modes - -The YOLOv9 series offers a range of models, each optimized for high-performance [Object Detection](../tasks/detect.md). These models cater to varying computational needs and accuracy requirements, making them versatile for a wide array of applications. - -| Model Type | Pre-trained Weights | Tasks Supported | Inference | Validation | Training | Export | -|------------|-----------------------------------------------------------------------------------------|----------------------------------------|-----------|------------|----------|--------| -| YOLOv9-C | [yolov9c.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov9c.pt) | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ✅ | ✅ | -| YOLOv9-E | [yolov9e.pt](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov9e.pt) | [Object Detection](../tasks/detect.md) | ✅ | ✅ | ✅ | ✅ | - -This table provides a detailed overview of the YOLOv9 model variants, highlighting their capabilities in object detection tasks and their compatibility with various operational modes such as [Inference](../modes/predict.md), [Validation](../modes/val.md), [Training](../modes/train.md), and [Export](../modes/export.md). This comprehensive support ensures that users can fully leverage the capabilities of YOLOv9 models in a broad range of object detection scenarios. - -## Citations and Acknowledgements - -We would like to acknowledge the YOLOv9 authors for their significant contributions in the field of real-time object detection: - -!!! Quote "" - - === "BibTeX" - - ```bibtex - @article{wang2024yolov9, - title={{YOLOv9}: Learning What You Want to Learn Using Programmable Gradient Information}, - author={Wang, Chien-Yao and Liao, Hong-Yuan Mark}, - booktitle={arXiv preprint arXiv:2402.13616}, - year={2024} - } - ``` - -The original YOLOv9 paper can be found on [arXiv](https://arxiv.org/pdf/2402.13616.pdf). The authors have made their work publicly available, and the codebase can be accessed on [GitHub](https://github.com/WongKinYiu/yolov9). We appreciate their efforts in advancing the field and making their work accessible to the broader community. diff --git a/ultralytics-main/docs/en/modes/benchmark.md b/ultralytics-main/docs/en/modes/benchmark.md deleted file mode 100644 index 7f8e457..0000000 --- a/ultralytics-main/docs/en/modes/benchmark.md +++ /dev/null @@ -1,106 +0,0 @@ ---- -comments: true -description: Learn how to profile speed and accuracy of YOLOv8 across various export formats; get insights on mAP50-95, accuracy_top5 metrics, and more. -keywords: Ultralytics, YOLOv8, benchmarking, speed profiling, accuracy profiling, mAP50-95, accuracy_top5, ONNX, OpenVINO, TensorRT, YOLO export formats ---- - -# Model Benchmarking with Ultralytics YOLO - -Ultralytics YOLO ecosystem and integrations - -## Introduction - -Once your model is trained and validated, the next logical step is to evaluate its performance in various real-world scenarios. Benchmark mode in Ultralytics YOLOv8 serves this purpose by providing a robust framework for assessing the speed and accuracy of your model across a range of export formats. - -

-
- -
- Watch: Ultralytics Modes Tutorial: Benchmark -

- -## Why Is Benchmarking Crucial? - -- **Informed Decisions:** Gain insights into the trade-offs between speed and accuracy. -- **Resource Allocation:** Understand how different export formats perform on different hardware. -- **Optimization:** Learn which export format offers the best performance for your specific use case. -- **Cost Efficiency:** Make more efficient use of hardware resources based on benchmark results. - -### Key Metrics in Benchmark Mode - -- **mAP50-95:** For object detection, segmentation, and pose estimation. -- **accuracy_top5:** For image classification. -- **Inference Time:** Time taken for each image in milliseconds. - -### Supported Export Formats - -- **ONNX:** For optimal CPU performance -- **TensorRT:** For maximal GPU efficiency -- **OpenVINO:** For Intel hardware optimization -- **CoreML, TensorFlow SavedModel, and More:** For diverse deployment needs. - -!!! Tip "Tip" - - * Export to ONNX or OpenVINO for up to 3x CPU speedup. - * Export to TensorRT for up to 5x GPU speedup. - -## Usage Examples - -Run YOLOv8n benchmarks on all supported export formats including ONNX, TensorRT etc. See Arguments section below for a full list of export arguments. - -!!! Example - - === "Python" - - ```python - from ultralytics.utils.benchmarks import benchmark - - # Benchmark on GPU - benchmark(model='yolov8n.pt', data='coco8.yaml', imgsz=640, half=False, device=0) - ``` - - === "CLI" - - ```bash - yolo benchmark model=yolov8n.pt data='coco8.yaml' imgsz=640 half=False device=0 - ``` - -## Arguments - -Arguments such as `model`, `data`, `imgsz`, `half`, `device`, and `verbose` provide users with the flexibility to fine-tune the benchmarks to their specific needs and compare the performance of different export formats with ease. - -| Key | Default Value | Description | -|-----------|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------| -| `model` | `None` | Specifies the path to the model file. Accepts both `.pt` and `.yaml` formats, e.g., `"yolov8n.pt"` for pre-trained models or configuration files. | -| `data` | `None` | Path to a YAML file defining the dataset for benchmarking, typically including paths and settings for validation data. Example: `"coco128.yaml"`. | -| `imgsz` | `640` | The input image size for the model. Can be a single integer for square images or a tuple `(width, height)` for non-square, e.g., `(640, 480)`. | -| `half` | `False` | Enables FP16 (half-precision) inference, reducing memory usage and possibly increasing speed on compatible hardware. Use `half=True` to enable. | -| `int8` | `False` | Activates INT8 quantization for further optimized performance on supported devices, especially useful for edge devices. Set `int8=True` to use. | -| `device` | `None` | Defines the computation device(s) for benchmarking, such as `"cpu"`, `"cuda:0"`, or a list of devices like `"cuda:0,1"` for multi-GPU setups. | -| `verbose` | `False` | Controls the level of detail in logging output. A boolean value; set `verbose=True` for detailed logs or a float for thresholding errors. | - -## Export Formats - -Benchmarks will attempt to run automatically on all possible export formats below. - -| Format | `format` Argument | Model | Metadata | Arguments | -|--------------------------------------------------------------------|-------------------|---------------------------|----------|-----------------------------------------------------| -| [PyTorch](https://pytorch.org/) | - | `yolov8n.pt` | ✅ | - | -| [TorchScript](https://pytorch.org/docs/stable/jit.html) | `torchscript` | `yolov8n.torchscript` | ✅ | `imgsz`, `optimize` | -| [ONNX](https://onnx.ai/) | `onnx` | `yolov8n.onnx` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `opset` | -| [OpenVINO](../integrations/openvino.md) | `openvino` | `yolov8n_openvino_model/` | ✅ | `imgsz`, `half`, `int8` | -| [TensorRT](https://developer.nvidia.com/tensorrt) | `engine` | `yolov8n.engine` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `workspace` | -| [CoreML](https://github.com/apple/coremltools) | `coreml` | `yolov8n.mlpackage` | ✅ | `imgsz`, `half`, `int8`, `nms` | -| [TF SavedModel](https://www.tensorflow.org/guide/saved_model) | `saved_model` | `yolov8n_saved_model/` | ✅ | `imgsz`, `keras`, `int8` | -| [TF GraphDef](https://www.tensorflow.org/api_docs/python/tf/Graph) | `pb` | `yolov8n.pb` | ❌ | `imgsz` | -| [TF Lite](https://www.tensorflow.org/lite) | `tflite` | `yolov8n.tflite` | ✅ | `imgsz`, `half`, `int8` | -| [TF Edge TPU](https://coral.ai/docs/edgetpu/models-intro/) | `edgetpu` | `yolov8n_edgetpu.tflite` | ✅ | `imgsz` | -| [TF.js](https://www.tensorflow.org/js) | `tfjs` | `yolov8n_web_model/` | ✅ | `imgsz`, `half`, `int8` | -| [PaddlePaddle](https://github.com/PaddlePaddle) | `paddle` | `yolov8n_paddle_model/` | ✅ | `imgsz` | -| [NCNN](https://github.com/Tencent/ncnn) | `ncnn` | `yolov8n_ncnn_model/` | ✅ | `imgsz`, `half` | - -See full `export` details in the [Export](https://docs.ultralytics.com/modes/export/) page. diff --git a/ultralytics-main/docs/en/modes/export.md b/ultralytics-main/docs/en/modes/export.md deleted file mode 100644 index 5859b18..0000000 --- a/ultralytics-main/docs/en/modes/export.md +++ /dev/null @@ -1,111 +0,0 @@ ---- -comments: true -description: Step-by-step guide on exporting your YOLOv8 models to various format like ONNX, TensorRT, CoreML and more for deployment. Explore now!. -keywords: YOLO, YOLOv8, Ultralytics, Model export, ONNX, TensorRT, CoreML, TensorFlow SavedModel, OpenVINO, PyTorch, export model ---- - -# Model Export with Ultralytics YOLO - -Ultralytics YOLO ecosystem and integrations - -## Introduction - -The ultimate goal of training a model is to deploy it for real-world applications. Export mode in Ultralytics YOLOv8 offers a versatile range of options for exporting your trained model to different formats, making it deployable across various platforms and devices. This comprehensive guide aims to walk you through the nuances of model exporting, showcasing how to achieve maximum compatibility and performance. - -

-
- -
- Watch: How To Export Custom Trained Ultralytics YOLOv8 Model and Run Live Inference on Webcam. -

- -## Why Choose YOLOv8's Export Mode? - -- **Versatility:** Export to multiple formats including ONNX, TensorRT, CoreML, and more. -- **Performance:** Gain up to 5x GPU speedup with TensorRT and 3x CPU speedup with ONNX or OpenVINO. -- **Compatibility:** Make your model universally deployable across numerous hardware and software environments. -- **Ease of Use:** Simple CLI and Python API for quick and straightforward model exporting. - -### Key Features of Export Mode - -Here are some of the standout functionalities: - -- **One-Click Export:** Simple commands for exporting to different formats. -- **Batch Export:** Export batched-inference capable models. -- **Optimized Inference:** Exported models are optimized for quicker inference times. -- **Tutorial Videos:** In-depth guides and tutorials for a smooth exporting experience. - -!!! Tip "Tip" - - * Export to ONNX or OpenVINO for up to 3x CPU speedup. - * Export to TensorRT for up to 5x GPU speedup. - -## Usage Examples - -Export a YOLOv8n model to a different format like ONNX or TensorRT. See Arguments section below for a full list of export arguments. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n.pt') # load an official model - model = YOLO('path/to/best.pt') # load a custom trained model - - # Export the model - model.export(format='onnx') - ``` - - === "CLI" - - ```bash - yolo export model=yolov8n.pt format=onnx # export official model - yolo export model=path/to/best.pt format=onnx # export custom trained model - ``` - -## Arguments - -This table details the configurations and options available for exporting YOLO models to different formats. These settings are critical for optimizing the exported model's performance, size, and compatibility across various platforms and environments. Proper configuration ensures that the model is ready for deployment in the intended application with optimal efficiency. - -| Argument | Type | Default | Description | -|-------------|------------------|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `format` | `str` | `'torchscript'` | Target format for the exported model, such as `'onnx'`, `'torchscript'`, `'tensorflow'`, or others, defining compatibility with various deployment environments. | -| `imgsz` | `int` or `tuple` | `640` | Desired image size for the model input. Can be an integer for square images or a tuple `(height, width)` for specific dimensions. | -| `keras` | `bool` | `False` | Enables export to Keras format for TensorFlow SavedModel, providing compatibility with TensorFlow serving and APIs. | -| `optimize` | `bool` | `False` | Applies optimization for mobile devices when exporting to TorchScript, potentially reducing model size and improving performance. | -| `half` | `bool` | `False` | Enables FP16 (half-precision) quantization, reducing model size and potentially speeding up inference on supported hardware. | -| `int8` | `bool` | `False` | Activates INT8 quantization, further compressing the model and speeding up inference with minimal accuracy loss, primarily for edge devices. | -| `dynamic` | `bool` | `False` | Allows dynamic input sizes for ONNX and TensorRT exports, enhancing flexibility in handling varying image dimensions. | -| `simplify` | `bool` | `False` | Simplifies the model graph for ONNX exports, potentially improving performance and compatibility. | -| `opset` | `int` | `None` | Specifies the ONNX opset version for compatibility with different ONNX parsers and runtimes. If not set, uses the latest supported version. | -| `workspace` | `float` | `4.0` | Sets the maximum workspace size in GB for TensorRT optimizations, balancing memory usage and performance. | -| `nms` | `bool` | `False` | Adds Non-Maximum Suppression (NMS) to the CoreML export, essential for accurate and efficient detection post-processing. | - -Adjusting these parameters allows for customization of the export process to fit specific requirements, such as deployment environment, hardware constraints, and performance targets. Selecting the appropriate format and settings is essential for achieving the best balance between model size, speed, and accuracy. - -## Export Formats - -Available YOLOv8 export formats are in the table below. You can export to any format using the `format` argument, i.e. `format='onnx'` or `format='engine'`. - -| Format | `format` Argument | Model | Metadata | Arguments | -|--------------------------------------------------------------------|-------------------|---------------------------|----------|-----------------------------------------------------| -| [PyTorch](https://pytorch.org/) | - | `yolov8n.pt` | ✅ | - | -| [TorchScript](https://pytorch.org/docs/stable/jit.html) | `torchscript` | `yolov8n.torchscript` | ✅ | `imgsz`, `optimize` | -| [ONNX](https://onnx.ai/) | `onnx` | `yolov8n.onnx` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `opset` | -| [OpenVINO](../integrations/openvino.md) | `openvino` | `yolov8n_openvino_model/` | ✅ | `imgsz`, `half`, `int8` | -| [TensorRT](https://developer.nvidia.com/tensorrt) | `engine` | `yolov8n.engine` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `workspace` | -| [CoreML](https://github.com/apple/coremltools) | `coreml` | `yolov8n.mlpackage` | ✅ | `imgsz`, `half`, `int8`, `nms` | -| [TF SavedModel](https://www.tensorflow.org/guide/saved_model) | `saved_model` | `yolov8n_saved_model/` | ✅ | `imgsz`, `keras`, `int8` | -| [TF GraphDef](https://www.tensorflow.org/api_docs/python/tf/Graph) | `pb` | `yolov8n.pb` | ❌ | `imgsz` | -| [TF Lite](https://www.tensorflow.org/lite) | `tflite` | `yolov8n.tflite` | ✅ | `imgsz`, `half`, `int8` | -| [TF Edge TPU](https://coral.ai/docs/edgetpu/models-intro/) | `edgetpu` | `yolov8n_edgetpu.tflite` | ✅ | `imgsz` | -| [TF.js](https://www.tensorflow.org/js) | `tfjs` | `yolov8n_web_model/` | ✅ | `imgsz`, `half`, `int8` | -| [PaddlePaddle](https://github.com/PaddlePaddle) | `paddle` | `yolov8n_paddle_model/` | ✅ | `imgsz` | -| [NCNN](https://github.com/Tencent/ncnn) | `ncnn` | `yolov8n_ncnn_model/` | ✅ | `imgsz`, `half` | diff --git a/ultralytics-main/docs/en/modes/index.md b/ultralytics-main/docs/en/modes/index.md deleted file mode 100644 index c04aa40..0000000 --- a/ultralytics-main/docs/en/modes/index.md +++ /dev/null @@ -1,73 +0,0 @@ ---- -comments: true -description: From training to tracking, make the most of YOLOv8 with Ultralytics. Get insights and examples for each supported mode including validation, export, and benchmarking. -keywords: Ultralytics, YOLOv8, Machine Learning, Object Detection, Training, Validation, Prediction, Export, Tracking, Benchmarking ---- - -# Ultralytics YOLOv8 Modes - -Ultralytics YOLO ecosystem and integrations - -## Introduction - -Ultralytics YOLOv8 is not just another object detection model; it's a versatile framework designed to cover the entire lifecycle of machine learning models—from data ingestion and model training to validation, deployment, and real-world tracking. Each mode serves a specific purpose and is engineered to offer you the flexibility and efficiency required for different tasks and use-cases. - -

-
- -
- Watch: Ultralytics Modes Tutorial: Train, Validate, Predict, Export & Benchmark. -

- -### Modes at a Glance - -Understanding the different **modes** that Ultralytics YOLOv8 supports is critical to getting the most out of your models: - -- **Train** mode: Fine-tune your model on custom or preloaded datasets. -- **Val** mode: A post-training checkpoint to validate model performance. -- **Predict** mode: Unleash the predictive power of your model on real-world data. -- **Export** mode: Make your model deployment-ready in various formats. -- **Track** mode: Extend your object detection model into real-time tracking applications. -- **Benchmark** mode: Analyze the speed and accuracy of your model in diverse deployment environments. - -This comprehensive guide aims to give you an overview and practical insights into each mode, helping you harness the full potential of YOLOv8. - -## [Train](train.md) - -Train mode is used for training a YOLOv8 model on a custom dataset. In this mode, the model is trained using the specified dataset and hyperparameters. The training process involves optimizing the model's parameters so that it can accurately predict the classes and locations of objects in an image. - -[Train Examples](train.md){ .md-button } - -## [Val](val.md) - -Val mode is used for validating a YOLOv8 model after it has been trained. In this mode, the model is evaluated on a validation set to measure its accuracy and generalization performance. This mode can be used to tune the hyperparameters of the model to improve its performance. - -[Val Examples](val.md){ .md-button } - -## [Predict](predict.md) - -Predict mode is used for making predictions using a trained YOLOv8 model on new images or videos. In this mode, the model is loaded from a checkpoint file, and the user can provide images or videos to perform inference. The model predicts the classes and locations of objects in the input images or videos. - -[Predict Examples](predict.md){ .md-button } - -## [Export](export.md) - -Export mode is used for exporting a YOLOv8 model to a format that can be used for deployment. In this mode, the model is converted to a format that can be used by other software applications or hardware devices. This mode is useful when deploying the model to production environments. - -[Export Examples](export.md){ .md-button } - -## [Track](track.md) - -Track mode is used for tracking objects in real-time using a YOLOv8 model. In this mode, the model is loaded from a checkpoint file, and the user can provide a live video stream to perform real-time object tracking. This mode is useful for applications such as surveillance systems or self-driving cars. - -[Track Examples](track.md){ .md-button } - -## [Benchmark](benchmark.md) - -Benchmark mode is used to profile the speed and accuracy of various export formats for YOLOv8. The benchmarks provide information on the size of the exported format, its `mAP50-95` metrics (for object detection, segmentation and pose) or `accuracy_top5` metrics (for classification), and the inference time in milliseconds per image across various export formats like ONNX, OpenVINO, TensorRT and others. This information can help users choose the optimal export format for their specific use case based on their requirements for speed and accuracy. - -[Benchmark Examples](benchmark.md){ .md-button } diff --git a/ultralytics-main/docs/en/modes/predict.md b/ultralytics-main/docs/en/modes/predict.md deleted file mode 100644 index d3a9d47..0000000 --- a/ultralytics-main/docs/en/modes/predict.md +++ /dev/null @@ -1,795 +0,0 @@ ---- -comments: true -description: Discover how to use YOLOv8 predict mode for various tasks. Learn about different inference sources like images, videos, and data formats. -keywords: Ultralytics, YOLOv8, predict mode, inference sources, prediction tasks, streaming mode, image processing, video processing, machine learning, AI ---- - -# Model Prediction with Ultralytics YOLO - -Ultralytics YOLO ecosystem and integrations - -## Introduction - -In the world of machine learning and computer vision, the process of making sense out of visual data is called 'inference' or 'prediction'. Ultralytics YOLOv8 offers a powerful feature known as **predict mode** that is tailored for high-performance, real-time inference on a wide range of data sources. - -

-
- -
- Watch: How to Extract the Outputs from Ultralytics YOLOv8 Model for Custom Projects. -

- -## Real-world Applications - -| Manufacturing | Sports | Safety | -|:-------------------------------------------------:|:----------------------------------------------------:|:-------------------------------------------:| -| ![Vehicle Spare Parts Detection][car spare parts] | ![Football Player Detection][football player detect] | ![People Fall Detection][human fall detect] | -| Vehicle Spare Parts Detection | Football Player Detection | People Fall Detection | - -## Why Use Ultralytics YOLO for Inference? - -Here's why you should consider YOLOv8's predict mode for your various inference needs: - -- **Versatility:** Capable of making inferences on images, videos, and even live streams. -- **Performance:** Engineered for real-time, high-speed processing without sacrificing accuracy. -- **Ease of Use:** Intuitive Python and CLI interfaces for rapid deployment and testing. -- **Highly Customizable:** Various settings and parameters to tune the model's inference behavior according to your specific requirements. - -### Key Features of Predict Mode - -YOLOv8's predict mode is designed to be robust and versatile, featuring: - -- **Multiple Data Source Compatibility:** Whether your data is in the form of individual images, a collection of images, video files, or real-time video streams, predict mode has you covered. -- **Streaming Mode:** Use the streaming feature to generate a memory-efficient generator of `Results` objects. Enable this by setting `stream=True` in the predictor's call method. -- **Batch Processing:** The ability to process multiple images or video frames in a single batch, further speeding up inference time. -- **Integration Friendly:** Easily integrate with existing data pipelines and other software components, thanks to its flexible API. - -Ultralytics YOLO models return either a Python list of `Results` objects, or a memory-efficient Python generator of `Results` objects when `stream=True` is passed to the model during inference: - -!!! Example "Predict" - - === "Return a list with `stream=False`" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n.pt') # pretrained YOLOv8n model - - # Run batched inference on a list of images - results = model(['im1.jpg', 'im2.jpg']) # return a list of Results objects - - # Process results list - for result in results: - boxes = result.boxes # Boxes object for bounding box outputs - masks = result.masks # Masks object for segmentation masks outputs - keypoints = result.keypoints # Keypoints object for pose outputs - probs = result.probs # Probs object for classification outputs - result.show() # display to screen - result.save(filename='result.jpg') # save to disk - ``` - - === "Return a generator with `stream=True`" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n.pt') # pretrained YOLOv8n model - - # Run batched inference on a list of images - results = model(['im1.jpg', 'im2.jpg'], stream=True) # return a generator of Results objects - - # Process results generator - for result in results: - boxes = result.boxes # Boxes object for bounding box outputs - masks = result.masks # Masks object for segmentation masks outputs - keypoints = result.keypoints # Keypoints object for pose outputs - probs = result.probs # Probs object for classification outputs - result.show() # display to screen - result.save(filename='result.jpg') # save to disk - ``` - -## Inference Sources - -YOLOv8 can process different types of input sources for inference, as shown in the table below. The sources include static images, video streams, and various data formats. The table also indicates whether each source can be used in streaming mode with the argument `stream=True` ✅. Streaming mode is beneficial for processing videos or live streams as it creates a generator of results instead of loading all frames into memory. - -!!! Tip "Tip" - - Use `stream=True` for processing long videos or large datasets to efficiently manage memory. When `stream=False`, the results for all frames or data points are stored in memory, which can quickly add up and cause out-of-memory errors for large inputs. In contrast, `stream=True` utilizes a generator, which only keeps the results of the current frame or data point in memory, significantly reducing memory consumption and preventing out-of-memory issues. - -| Source | Argument | Type | Notes | -|----------------|--------------------------------------------|-----------------|---------------------------------------------------------------------------------------------| -| image | `'image.jpg'` | `str` or `Path` | Single image file. | -| URL | `'https://ultralytics.com/images/bus.jpg'` | `str` | URL to an image. | -| screenshot | `'screen'` | `str` | Capture a screenshot. | -| PIL | `Image.open('im.jpg')` | `PIL.Image` | HWC format with RGB channels. | -| OpenCV | `cv2.imread('im.jpg')` | `np.ndarray` | HWC format with BGR channels `uint8 (0-255)`. | -| numpy | `np.zeros((640,1280,3))` | `np.ndarray` | HWC format with BGR channels `uint8 (0-255)`. | -| torch | `torch.zeros(16,3,320,640)` | `torch.Tensor` | BCHW format with RGB channels `float32 (0.0-1.0)`. | -| CSV | `'sources.csv'` | `str` or `Path` | CSV file containing paths to images, videos, or directories. | -| video ✅ | `'video.mp4'` | `str` or `Path` | Video file in formats like MP4, AVI, etc. | -| directory ✅ | `'path/'` | `str` or `Path` | Path to a directory containing images or videos. | -| glob ✅ | `'path/*.jpg'` | `str` | Glob pattern to match multiple files. Use the `*` character as a wildcard. | -| YouTube ✅ | `'https://youtu.be/LNwODJXcvt4'` | `str` | URL to a YouTube video. | -| stream ✅ | `'rtsp://example.com/media.mp4'` | `str` | URL for streaming protocols such as RTSP, RTMP, TCP, or an IP address. | -| multi-stream ✅ | `'list.streams'` | `str` or `Path` | `*.streams` text file with one stream URL per row, i.e. 8 streams will run at batch-size 8. | - -Below are code examples for using each source type: - -!!! Example "Prediction sources" - - === "image" - - Run inference on an image file. - ```python - from ultralytics import YOLO - - # Load a pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Define path to the image file - source = 'path/to/image.jpg' - - # Run inference on the source - results = model(source) # list of Results objects - ``` - - === "screenshot" - - Run inference on the current screen content as a screenshot. - ```python - from ultralytics import YOLO - - # Load a pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Define current screenshot as source - source = 'screen' - - # Run inference on the source - results = model(source) # list of Results objects - ``` - - === "URL" - - Run inference on an image or video hosted remotely via URL. - ```python - from ultralytics import YOLO - - # Load a pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Define remote image or video URL - source = 'https://ultralytics.com/images/bus.jpg' - - # Run inference on the source - results = model(source) # list of Results objects - ``` - - === "PIL" - - Run inference on an image opened with Python Imaging Library (PIL). - ```python - from PIL import Image - from ultralytics import YOLO - - # Load a pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Open an image using PIL - source = Image.open('path/to/image.jpg') - - # Run inference on the source - results = model(source) # list of Results objects - ``` - - === "OpenCV" - - Run inference on an image read with OpenCV. - ```python - import cv2 - from ultralytics import YOLO - - # Load a pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Read an image using OpenCV - source = cv2.imread('path/to/image.jpg') - - # Run inference on the source - results = model(source) # list of Results objects - ``` - - === "numpy" - - Run inference on an image represented as a numpy array. - ```python - import numpy as np - from ultralytics import YOLO - - # Load a pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Create a random numpy array of HWC shape (640, 640, 3) with values in range [0, 255] and type uint8 - source = np.random.randint(low=0, high=255, size=(640, 640, 3), dtype='uint8') - - # Run inference on the source - results = model(source) # list of Results objects - ``` - - === "torch" - - Run inference on an image represented as a PyTorch tensor. - ```python - import torch - from ultralytics import YOLO - - # Load a pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Create a random torch tensor of BCHW shape (1, 3, 640, 640) with values in range [0, 1] and type float32 - source = torch.rand(1, 3, 640, 640, dtype=torch.float32) - - # Run inference on the source - results = model(source) # list of Results objects - ``` - - === "CSV" - - Run inference on a collection of images, URLs, videos and directories listed in a CSV file. - ```python - import torch - from ultralytics import YOLO - - # Load a pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Define a path to a CSV file with images, URLs, videos and directories - source = 'path/to/file.csv' - - # Run inference on the source - results = model(source) # list of Results objects - ``` - - === "video" - - Run inference on a video file. By using `stream=True`, you can create a generator of Results objects to reduce memory usage. - ```python - from ultralytics import YOLO - - # Load a pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Define path to video file - source = 'path/to/video.mp4' - - # Run inference on the source - results = model(source, stream=True) # generator of Results objects - ``` - - === "directory" - - Run inference on all images and videos in a directory. To also capture images and videos in subdirectories use a glob pattern, i.e. `path/to/dir/**/*`. - ```python - from ultralytics import YOLO - - # Load a pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Define path to directory containing images and videos for inference - source = 'path/to/dir' - - # Run inference on the source - results = model(source, stream=True) # generator of Results objects - ``` - - === "glob" - - Run inference on all images and videos that match a glob expression with `*` characters. - ```python - from ultralytics import YOLO - - # Load a pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Define a glob search for all JPG files in a directory - source = 'path/to/dir/*.jpg' - - # OR define a recursive glob search for all JPG files including subdirectories - source = 'path/to/dir/**/*.jpg' - - # Run inference on the source - results = model(source, stream=True) # generator of Results objects - ``` - - === "YouTube" - - Run inference on a YouTube video. By using `stream=True`, you can create a generator of Results objects to reduce memory usage for long videos. - ```python - from ultralytics import YOLO - - # Load a pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Define source as YouTube video URL - source = 'https://youtu.be/LNwODJXcvt4' - - # Run inference on the source - results = model(source, stream=True) # generator of Results objects - ``` - - === "Streams" - - Run inference on remote streaming sources using RTSP, RTMP, TCP and IP address protocols. If multiple streams are provided in a `*.streams` text file then batched inference will run, i.e. 8 streams will run at batch-size 8, otherwise single streams will run at batch-size 1. - ```python - from ultralytics import YOLO - - # Load a pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Single stream with batch-size 1 inference - source = 'rtsp://example.com/media.mp4' # RTSP, RTMP, TCP or IP streaming address - - # Multiple streams with batched inference (i.e. batch-size 8 for 8 streams) - source = 'path/to/list.streams' # *.streams text file with one streaming address per row - - # Run inference on the source - results = model(source, stream=True) # generator of Results objects - ``` - -## Inference Arguments - -`model.predict()` accepts multiple arguments that can be passed at inference time to override defaults: - -!!! Example - - ```python - from ultralytics import YOLO - - # Load a pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Run inference on 'bus.jpg' with arguments - model.predict('bus.jpg', save=True, imgsz=320, conf=0.5) - ``` - -Inference arguments: - -| Argument | Type | Default | Description | -|-----------------|----------------|------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `source` | `str` | `'ultralytics/assets'` | Specifies the data source for inference. Can be an image path, video file, directory, URL, or device ID for live feeds. Supports a wide range of formats and sources, enabling flexible application across different types of input. | -| `conf` | `float` | `0.25` | Sets the minimum confidence threshold for detections. Objects detected with confidence below this threshold will be disregarded. Adjusting this value can help reduce false positives. | -| `iou` | `float` | `0.7` | Intersection Over Union (IoU) threshold for Non-Maximum Suppression (NMS). Higher values result in fewer detections by eliminating overlapping boxes, useful for reducing duplicates. | -| `imgsz` | `int or tuple` | `640` | Defines the image size for inference. Can be a single integer `640` for square resizing or a (height, width) tuple. Proper sizing can improve detection accuracy and processing speed. | -| `half` | `bool` | `False` | Enables half-precision (FP16) inference, which can speed up model inference on supported GPUs with minimal impact on accuracy. | -| `device` | `str` | `None` | Specifies the device for inference (e.g., `cpu`, `cuda:0` or `0`). Allows users to select between CPU, a specific GPU, or other compute devices for model execution. | -| `max_det` | `int` | `300` | Maximum number of detections allowed per image. Limits the total number of objects the model can detect in a single inference, preventing excessive outputs in dense scenes. | -| `vid_stride` | `int` | `1` | Frame stride for video inputs. Allows skipping frames in videos to speed up processing at the cost of temporal resolution. A value of 1 processes every frame, higher values skip frames. | -| `stream_buffer` | `bool` | `False` | Determines if all frames should be buffered when processing video streams (`True`), or if the model should return the most recent frame (`False`). Useful for real-time applications. | -| `visualize` | `bool` | `False` | Activates visualization of model features during inference, providing insights into what the model is "seeing". Useful for debugging and model interpretation. | -| `augment` | `bool` | `False` | Enables test-time augmentation (TTA) for predictions, potentially improving detection robustness at the cost of inference speed. | -| `agnostic_nms` | `bool` | `False` | Enables class-agnostic Non-Maximum Suppression (NMS), which merges overlapping boxes of different classes. Useful in multi-class detection scenarios where class overlap is common. | -| `classes` | `list[int]` | `None` | Filters predictions to a set of class IDs. Only detections belonging to the specified classes will be returned. Useful for focusing on relevant objects in multi-class detection tasks. | -| `retina_masks` | `bool` | `False` | Uses high-resolution segmentation masks if available in the model. This can enhance mask quality for segmentation tasks, providing finer detail. | -| `embed` | `list[int]` | `None` | Specifies the layers from which to extract feature vectors or embeddings. Useful for downstream tasks like clustering or similarity search. | - -Visualization arguments: - -| Argument | Type | Default | Description | -|---------------|---------------|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `show` | `bool` | `False` | If `True`, displays the annotated images or videos in a window. Useful for immediate visual feedback during development or testing. | -| `save` | `bool` | `False` | Enables saving of the annotated images or videos to file. Useful for documentation, further analysis, or sharing results. | -| `save_frames` | `bool` | `False` | When processing videos, saves individual frames as images. Useful for extracting specific frames or for detailed frame-by-frame analysis. | -| `save_txt` | `bool` | `False` | Saves detection results in a text file, following the format `[class] [x_center] [y_center] [width] [height] [confidence]`. Useful for integration with other analysis tools. | -| `save_conf` | `bool` | `False` | Includes confidence scores in the saved text files. Enhances the detail available for post-processing and analysis. | -| `save_crop` | `bool` | `False` | Saves cropped images of detections. Useful for dataset augmentation, analysis, or creating focused datasets for specific objects. | -| `show_labels` | `bool` | `True` | Displays labels for each detection in the visual output. Provides immediate understanding of detected objects. | -| `show_conf` | `bool` | `True` | Displays the confidence score for each detection alongside the label. Gives insight into the model's certainty for each detection. | -| `show_boxes` | `bool` | `True` | Draws bounding boxes around detected objects. Essential for visual identification and location of objects in images or video frames. | -| `line_width` | `None or int` | `None` | Specifies the line width of bounding boxes. If `None`, the line width is automatically adjusted based on the image size. Provides visual customization for clarity. | - -## Image and Video Formats - -YOLOv8 supports various image and video formats, as specified in [ultralytics/data/utils.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/utils.py). See the tables below for the valid suffixes and example predict commands. - -### Images - -The below table contains valid Ultralytics image formats. - -| Image Suffixes | Example Predict Command | Reference | -|----------------|----------------------------------|-------------------------------------------------------------------------------| -| `.bmp` | `yolo predict source=image.bmp` | [Microsoft BMP File Format](https://en.wikipedia.org/wiki/BMP_file_format) | -| `.dng` | `yolo predict source=image.dng` | [Adobe DNG](https://www.adobe.com/products/photoshop/extend.displayTab2.html) | -| `.jpeg` | `yolo predict source=image.jpeg` | [JPEG](https://en.wikipedia.org/wiki/JPEG) | -| `.jpg` | `yolo predict source=image.jpg` | [JPEG](https://en.wikipedia.org/wiki/JPEG) | -| `.mpo` | `yolo predict source=image.mpo` | [Multi Picture Object](https://fileinfo.com/extension/mpo) | -| `.png` | `yolo predict source=image.png` | [Portable Network Graphics](https://en.wikipedia.org/wiki/PNG) | -| `.tif` | `yolo predict source=image.tif` | [Tag Image File Format](https://en.wikipedia.org/wiki/TIFF) | -| `.tiff` | `yolo predict source=image.tiff` | [Tag Image File Format](https://en.wikipedia.org/wiki/TIFF) | -| `.webp` | `yolo predict source=image.webp` | [WebP](https://en.wikipedia.org/wiki/WebP) | -| `.pfm` | `yolo predict source=image.pfm` | [Portable FloatMap](https://en.wikipedia.org/wiki/Netpbm#File_formats) | - -### Videos - -The below table contains valid Ultralytics video formats. - -| Video Suffixes | Example Predict Command | Reference | -|----------------|----------------------------------|----------------------------------------------------------------------------------| -| `.asf` | `yolo predict source=video.asf` | [Advanced Systems Format](https://en.wikipedia.org/wiki/Advanced_Systems_Format) | -| `.avi` | `yolo predict source=video.avi` | [Audio Video Interleave](https://en.wikipedia.org/wiki/Audio_Video_Interleave) | -| `.gif` | `yolo predict source=video.gif` | [Graphics Interchange Format](https://en.wikipedia.org/wiki/GIF) | -| `.m4v` | `yolo predict source=video.m4v` | [MPEG-4 Part 14](https://en.wikipedia.org/wiki/M4V) | -| `.mkv` | `yolo predict source=video.mkv` | [Matroska](https://en.wikipedia.org/wiki/Matroska) | -| `.mov` | `yolo predict source=video.mov` | [QuickTime File Format](https://en.wikipedia.org/wiki/QuickTime_File_Format) | -| `.mp4` | `yolo predict source=video.mp4` | [MPEG-4 Part 14 - Wikipedia](https://en.wikipedia.org/wiki/MPEG-4_Part_14) | -| `.mpeg` | `yolo predict source=video.mpeg` | [MPEG-1 Part 2](https://en.wikipedia.org/wiki/MPEG-1) | -| `.mpg` | `yolo predict source=video.mpg` | [MPEG-1 Part 2](https://en.wikipedia.org/wiki/MPEG-1) | -| `.ts` | `yolo predict source=video.ts` | [MPEG Transport Stream](https://en.wikipedia.org/wiki/MPEG_transport_stream) | -| `.wmv` | `yolo predict source=video.wmv` | [Windows Media Video](https://en.wikipedia.org/wiki/Windows_Media_Video) | -| `.webm` | `yolo predict source=video.webm` | [WebM Project](https://en.wikipedia.org/wiki/WebM) | - -## Working with Results - -All Ultralytics `predict()` calls will return a list of `Results` objects: - -!!! Example "Results" - - ```python - from ultralytics import YOLO - - # Load a pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Run inference on an image - results = model('bus.jpg') # list of 1 Results object - results = model(['bus.jpg', 'zidane.jpg']) # list of 2 Results objects - ``` - -`Results` objects have the following attributes: - -| Attribute | Type | Description | -|--------------|-----------------------|------------------------------------------------------------------------------------------| -| `orig_img` | `numpy.ndarray` | The original image as a numpy array. | -| `orig_shape` | `tuple` | The original image shape in (height, width) format. | -| `boxes` | `Boxes, optional` | A Boxes object containing the detection bounding boxes. | -| `masks` | `Masks, optional` | A Masks object containing the detection masks. | -| `probs` | `Probs, optional` | A Probs object containing probabilities of each class for classification task. | -| `keypoints` | `Keypoints, optional` | A Keypoints object containing detected keypoints for each object. | -| `obb` | `OBB, optional` | An OBB object containing oriented bounding boxes. | -| `speed` | `dict` | A dictionary of preprocess, inference, and postprocess speeds in milliseconds per image. | -| `names` | `dict` | A dictionary of class names. | -| `path` | `str` | The path to the image file. | - -`Results` objects have the following methods: - -| Method | Return Type | Description | -|---------------|-----------------|-------------------------------------------------------------------------------------| -| `update()` | `None` | Update the boxes, masks, and probs attributes of the Results object. | -| `cpu()` | `Results` | Return a copy of the Results object with all tensors on CPU memory. | -| `numpy()` | `Results` | Return a copy of the Results object with all tensors as numpy arrays. | -| `cuda()` | `Results` | Return a copy of the Results object with all tensors on GPU memory. | -| `to()` | `Results` | Return a copy of the Results object with tensors on the specified device and dtype. | -| `new()` | `Results` | Return a new Results object with the same image, path, and names. | -| `plot()` | `numpy.ndarray` | Plots the detection results. Returns a numpy array of the annotated image. | -| `show()` | `None` | Show annotated results to screen. | -| `save()` | `None` | Save annotated results to file. | -| `verbose()` | `str` | Return log string for each task. | -| `save_txt()` | `None` | Save predictions into a txt file. | -| `save_crop()` | `None` | Save cropped predictions to `save_dir/cls/file_name.jpg`. | -| `tojson()` | `str` | Convert the object to JSON format. | - -For more details see the [`Results` class documentation](../reference/engine/results.md). - -### Boxes - -`Boxes` object can be used to index, manipulate, and convert bounding boxes to different formats. - -!!! Example "Boxes" - - ```python - from ultralytics import YOLO - - # Load a pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Run inference on an image - results = model('bus.jpg') # results list - - # View results - for r in results: - print(r.boxes) # print the Boxes object containing the detection bounding boxes - ``` - -Here is a table for the `Boxes` class methods and properties, including their name, type, and description: - -| Name | Type | Description | -|-----------|---------------------------|--------------------------------------------------------------------| -| `cpu()` | Method | Move the object to CPU memory. | -| `numpy()` | Method | Convert the object to a numpy array. | -| `cuda()` | Method | Move the object to CUDA memory. | -| `to()` | Method | Move the object to the specified device. | -| `xyxy` | Property (`torch.Tensor`) | Return the boxes in xyxy format. | -| `conf` | Property (`torch.Tensor`) | Return the confidence values of the boxes. | -| `cls` | Property (`torch.Tensor`) | Return the class values of the boxes. | -| `id` | Property (`torch.Tensor`) | Return the track IDs of the boxes (if available). | -| `xywh` | Property (`torch.Tensor`) | Return the boxes in xywh format. | -| `xyxyn` | Property (`torch.Tensor`) | Return the boxes in xyxy format normalized by original image size. | -| `xywhn` | Property (`torch.Tensor`) | Return the boxes in xywh format normalized by original image size. | - -For more details see the [`Boxes` class documentation](../reference/engine/results.md#ultralytics.engine.results.Boxes). - -### Masks - -`Masks` object can be used index, manipulate and convert masks to segments. - -!!! Example "Masks" - - ```python - from ultralytics import YOLO - - # Load a pretrained YOLOv8n-seg Segment model - model = YOLO('yolov8n-seg.pt') - - # Run inference on an image - results = model('bus.jpg') # results list - - # View results - for r in results: - print(r.masks) # print the Masks object containing the detected instance masks - ``` - -Here is a table for the `Masks` class methods and properties, including their name, type, and description: - -| Name | Type | Description | -|-----------|---------------------------|-----------------------------------------------------------------| -| `cpu()` | Method | Returns the masks tensor on CPU memory. | -| `numpy()` | Method | Returns the masks tensor as a numpy array. | -| `cuda()` | Method | Returns the masks tensor on GPU memory. | -| `to()` | Method | Returns the masks tensor with the specified device and dtype. | -| `xyn` | Property (`torch.Tensor`) | A list of normalized segments represented as tensors. | -| `xy` | Property (`torch.Tensor`) | A list of segments in pixel coordinates represented as tensors. | - -For more details see the [`Masks` class documentation](../reference/engine/results.md#ultralytics.engine.results.Masks). - -### Keypoints - -`Keypoints` object can be used index, manipulate and normalize coordinates. - -!!! Example "Keypoints" - - ```python - from ultralytics import YOLO - - # Load a pretrained YOLOv8n-pose Pose model - model = YOLO('yolov8n-pose.pt') - - # Run inference on an image - results = model('bus.jpg') # results list - - # View results - for r in results: - print(r.keypoints) # print the Keypoints object containing the detected keypoints - ``` - -Here is a table for the `Keypoints` class methods and properties, including their name, type, and description: - -| Name | Type | Description | -|-----------|---------------------------|-------------------------------------------------------------------| -| `cpu()` | Method | Returns the keypoints tensor on CPU memory. | -| `numpy()` | Method | Returns the keypoints tensor as a numpy array. | -| `cuda()` | Method | Returns the keypoints tensor on GPU memory. | -| `to()` | Method | Returns the keypoints tensor with the specified device and dtype. | -| `xyn` | Property (`torch.Tensor`) | A list of normalized keypoints represented as tensors. | -| `xy` | Property (`torch.Tensor`) | A list of keypoints in pixel coordinates represented as tensors. | -| `conf` | Property (`torch.Tensor`) | Returns confidence values of keypoints if available, else None. | - -For more details see the [`Keypoints` class documentation](../reference/engine/results.md#ultralytics.engine.results.Keypoints). - -### Probs - -`Probs` object can be used index, get `top1` and `top5` indices and scores of classification. - -!!! Example "Probs" - - ```python - from ultralytics import YOLO - - # Load a pretrained YOLOv8n-cls Classify model - model = YOLO('yolov8n-cls.pt') - - # Run inference on an image - results = model('bus.jpg') # results list - - # View results - for r in results: - print(r.probs) # print the Probs object containing the detected class probabilities - ``` - -Here's a table summarizing the methods and properties for the `Probs` class: - -| Name | Type | Description | -|------------|---------------------------|-------------------------------------------------------------------------| -| `cpu()` | Method | Returns a copy of the probs tensor on CPU memory. | -| `numpy()` | Method | Returns a copy of the probs tensor as a numpy array. | -| `cuda()` | Method | Returns a copy of the probs tensor on GPU memory. | -| `to()` | Method | Returns a copy of the probs tensor with the specified device and dtype. | -| `top1` | Property (`int`) | Index of the top 1 class. | -| `top5` | Property (`list[int]`) | Indices of the top 5 classes. | -| `top1conf` | Property (`torch.Tensor`) | Confidence of the top 1 class. | -| `top5conf` | Property (`torch.Tensor`) | Confidences of the top 5 classes. | - -For more details see the [`Probs` class documentation](../reference/engine/results.md#ultralytics.engine.results.Probs). - -### OBB - -`OBB` object can be used to index, manipulate, and convert oriented bounding boxes to different formats. - -!!! Example "OBB" - - ```python - from ultralytics import YOLO - - # Load a pretrained YOLOv8n model - model = YOLO('yolov8n-obb.pt') - - # Run inference on an image - results = model('bus.jpg') # results list - - # View results - for r in results: - print(r.obb) # print the OBB object containing the oriented detection bounding boxes - ``` - -Here is a table for the `OBB` class methods and properties, including their name, type, and description: - -| Name | Type | Description | -|-------------|---------------------------|-----------------------------------------------------------------------| -| `cpu()` | Method | Move the object to CPU memory. | -| `numpy()` | Method | Convert the object to a numpy array. | -| `cuda()` | Method | Move the object to CUDA memory. | -| `to()` | Method | Move the object to the specified device. | -| `conf` | Property (`torch.Tensor`) | Return the confidence values of the boxes. | -| `cls` | Property (`torch.Tensor`) | Return the class values of the boxes. | -| `id` | Property (`torch.Tensor`) | Return the track IDs of the boxes (if available). | -| `xyxy` | Property (`torch.Tensor`) | Return the horizontal boxes in xyxy format. | -| `xywhr` | Property (`torch.Tensor`) | Return the rotated boxes in xywhr format. | -| `xyxyxyxy` | Property (`torch.Tensor`) | Return the rotated boxes in xyxyxyxy format. | -| `xyxyxyxyn` | Property (`torch.Tensor`) | Return the rotated boxes in xyxyxyxy format normalized by image size. | - -For more details see the [`OBB` class documentation](../reference/engine/results.md#ultralytics.engine.results.OBB). - -## Plotting Results - -The `plot()` method in `Results` objects facilitates visualization of predictions by overlaying detected objects (such as bounding boxes, masks, keypoints, and probabilities) onto the original image. This method returns the annotated image as a NumPy array, allowing for easy display or saving. - -!!! Example "Plotting" - - ```python - from PIL import Image - from ultralytics import YOLO - - # Load a pretrained YOLOv8n model - model = YOLO('yolov8n.pt') - - # Run inference on 'bus.jpg' - results = model(['bus.jpg', 'zidane.jpg']) # results list - - # Visualize the results - for i, r in enumerate(results): - # Plot results image - im_bgr = r.plot() # BGR-order numpy array - im_rgb = Image.fromarray(im_bgr[..., ::-1]) # RGB-order PIL image - - # Show results to screen (in supported environments) - r.show() - - # Save results to disk - r.save(filename=f'results{i}.jpg') - ``` - -### `plot()` Method Parameters - -The `plot()` method supports various arguments to customize the output: - -| Argument | Type | Description | Default | -|--------------|-----------------|----------------------------------------------------------------------------|---------------| -| `conf` | `bool` | Include detection confidence scores. | `True` | -| `line_width` | `float` | Line width of bounding boxes. Scales with image size if `None`. | `None` | -| `font_size` | `float` | Text font size. Scales with image size if `None`. | `None` | -| `font` | `str` | Font name for text annotations. | `'Arial.ttf'` | -| `pil` | `bool` | Return image as a PIL Image object. | `False` | -| `img` | `numpy.ndarray` | Alternative image for plotting. Uses the original image if `None`. | `None` | -| `im_gpu` | `torch.Tensor` | GPU-accelerated image for faster mask plotting. Shape: (1, 3, 640, 640). | `None` | -| `kpt_radius` | `int` | Radius for drawn keypoints. | `5` | -| `kpt_line` | `bool` | Connect keypoints with lines. | `True` | -| `labels` | `bool` | Include class labels in annotations. | `True` | -| `boxes` | `bool` | Overlay bounding boxes on the image. | `True` | -| `masks` | `bool` | Overlay masks on the image. | `True` | -| `probs` | `bool` | Include classification probabilities. | `True` | -| `show` | `bool` | Display the annotated image directly using the default image viewer. | `False` | -| `save` | `bool` | Save the annotated image to a file specified by `filename`. | `False` | -| `filename` | `str` | Path and name of the file to save the annotated image if `save` is `True`. | `None` | - -## Thread-Safe Inference - -Ensuring thread safety during inference is crucial when you are running multiple YOLO models in parallel across different threads. Thread-safe inference guarantees that each thread's predictions are isolated and do not interfere with one another, avoiding race conditions and ensuring consistent and reliable outputs. - -When using YOLO models in a multi-threaded application, it's important to instantiate separate model objects for each thread or employ thread-local storage to prevent conflicts: - -!!! Example "Thread-Safe Inference" - - Instantiate a single model inside each thread for thread-safe inference: - ```python - from ultralytics import YOLO - from threading import Thread - - def thread_safe_predict(image_path): - # Instantiate a new model inside the thread - local_model = YOLO("yolov8n.pt") - results = local_model.predict(image_path) - # Process results - - - # Starting threads that each have their own model instance - Thread(target=thread_safe_predict, args=("image1.jpg",)).start() - Thread(target=thread_safe_predict, args=("image2.jpg",)).start() - ``` - -For an in-depth look at thread-safe inference with YOLO models and step-by-step instructions, please refer to our [YOLO Thread-Safe Inference Guide](../guides/yolo-thread-safe-inference.md). This guide will provide you with all the necessary information to avoid common pitfalls and ensure that your multi-threaded inference runs smoothly. - -## Streaming Source `for`-loop - -Here's a Python script using OpenCV (`cv2`) and YOLOv8 to run inference on video frames. This script assumes you have already installed the necessary packages (`opencv-python` and `ultralytics`). - -!!! Example "Streaming for-loop" - - ```python - import cv2 - from ultralytics import YOLO - - # Load the YOLOv8 model - model = YOLO('yolov8n.pt') - - # Open the video file - video_path = "path/to/your/video/file.mp4" - cap = cv2.VideoCapture(video_path) - - # Loop through the video frames - while cap.isOpened(): - # Read a frame from the video - success, frame = cap.read() - - if success: - # Run YOLOv8 inference on the frame - results = model(frame) - - # Visualize the results on the frame - annotated_frame = results[0].plot() - - # Display the annotated frame - cv2.imshow("YOLOv8 Inference", annotated_frame) - - # Break the loop if 'q' is pressed - if cv2.waitKey(1) & 0xFF == ord("q"): - break - else: - # Break the loop if the end of the video is reached - break - - # Release the video capture object and close the display window - cap.release() - cv2.destroyAllWindows() - ``` - -This script will run predictions on each frame of the video, visualize the results, and display them in a window. The loop can be exited by pressing 'q'. - -[car spare parts]: https://github.com/RizwanMunawar/ultralytics/assets/62513924/a0f802a8-0776-44cf-8f17-93974a4a28a1 - -[football player detect]: https://github.com/RizwanMunawar/ultralytics/assets/62513924/7d320e1f-fc57-4d7f-a691-78ee579c3442 - -[human fall detect]: https://github.com/RizwanMunawar/ultralytics/assets/62513924/86437c4a-3227-4eee-90ef-9efb697bdb43 diff --git a/ultralytics-main/docs/en/modes/track.md b/ultralytics-main/docs/en/modes/track.md deleted file mode 100644 index 22e9c0a..0000000 --- a/ultralytics-main/docs/en/modes/track.md +++ /dev/null @@ -1,360 +0,0 @@ ---- -comments: true -description: Learn how to use Ultralytics YOLO for object tracking in video streams. Guides to use different trackers and customise tracker configurations. -keywords: Ultralytics, YOLO, object tracking, video streams, BoT-SORT, ByteTrack, Python guide, CLI guide ---- - -# Multi-Object Tracking with Ultralytics YOLO - -Multi-object tracking examples - -Object tracking in the realm of video analytics is a critical task that not only identifies the location and class of objects within the frame but also maintains a unique ID for each detected object as the video progresses. The applications are limitless—ranging from surveillance and security to real-time sports analytics. - -## Why Choose Ultralytics YOLO for Object Tracking? - -The output from Ultralytics trackers is consistent with standard object detection but has the added value of object IDs. This makes it easy to track objects in video streams and perform subsequent analytics. Here's why you should consider using Ultralytics YOLO for your object tracking needs: - -- **Efficiency:** Process video streams in real-time without compromising accuracy. -- **Flexibility:** Supports multiple tracking algorithms and configurations. -- **Ease of Use:** Simple Python API and CLI options for quick integration and deployment. -- **Customizability:** Easy to use with custom trained YOLO models, allowing integration into domain-specific applications. - -

-
- -
- Watch: Object Detection and Tracking with Ultralytics YOLOv8. -

- -## Real-world Applications - -| Transportation | Retail | Aquaculture | -|:----------------------------------:|:--------------------------------:|:----------------------------:| -| ![Vehicle Tracking][vehicle track] | ![People Tracking][people track] | ![Fish Tracking][fish track] | -| Vehicle Tracking | People Tracking | Fish Tracking | - -## Features at a Glance - -Ultralytics YOLO extends its object detection features to provide robust and versatile object tracking: - -- **Real-Time Tracking:** Seamlessly track objects in high-frame-rate videos. -- **Multiple Tracker Support:** Choose from a variety of established tracking algorithms. -- **Customizable Tracker Configurations:** Tailor the tracking algorithm to meet specific requirements by adjusting various parameters. - -## Available Trackers - -Ultralytics YOLO supports the following tracking algorithms. They can be enabled by passing the relevant YAML configuration file such as `tracker=tracker_type.yaml`: - -- [BoT-SORT](https://github.com/NirAharon/BoT-SORT) - Use `botsort.yaml` to enable this tracker. -- [ByteTrack](https://github.com/ifzhang/ByteTrack) - Use `bytetrack.yaml` to enable this tracker. - -The default tracker is BoT-SORT. - -## Tracking - -To run the tracker on video streams, use a trained Detect, Segment or Pose model such as YOLOv8n, YOLOv8n-seg and YOLOv8n-pose. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load an official or custom model - model = YOLO('yolov8n.pt') # Load an official Detect model - model = YOLO('yolov8n-seg.pt') # Load an official Segment model - model = YOLO('yolov8n-pose.pt') # Load an official Pose model - model = YOLO('path/to/best.pt') # Load a custom trained model - - # Perform tracking with the model - results = model.track(source="https://youtu.be/LNwODJXcvt4", show=True) # Tracking with default tracker - results = model.track(source="https://youtu.be/LNwODJXcvt4", show=True, tracker="bytetrack.yaml") # Tracking with ByteTrack tracker - ``` - - === "CLI" - - ```bash - # Perform tracking with various models using the command line interface - yolo track model=yolov8n.pt source="https://youtu.be/LNwODJXcvt4" # Official Detect model - yolo track model=yolov8n-seg.pt source="https://youtu.be/LNwODJXcvt4" # Official Segment model - yolo track model=yolov8n-pose.pt source="https://youtu.be/LNwODJXcvt4" # Official Pose model - yolo track model=path/to/best.pt source="https://youtu.be/LNwODJXcvt4" # Custom trained model - - # Track using ByteTrack tracker - yolo track model=path/to/best.pt tracker="bytetrack.yaml" - ``` - -As can be seen in the above usage, tracking is available for all Detect, Segment and Pose models run on videos or streaming sources. - -## Configuration - -### Tracking Arguments - -Tracking configuration shares properties with Predict mode, such as `conf`, `iou`, and `show`. For further configurations, refer to the [Predict](../modes/predict.md#inference-arguments) model page. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Configure the tracking parameters and run the tracker - model = YOLO('yolov8n.pt') - results = model.track(source="https://youtu.be/LNwODJXcvt4", conf=0.3, iou=0.5, show=True) - ``` - - === "CLI" - - ```bash - # Configure tracking parameters and run the tracker using the command line interface - yolo track model=yolov8n.pt source="https://youtu.be/LNwODJXcvt4" conf=0.3, iou=0.5 show - ``` - -### Tracker Selection - -Ultralytics also allows you to use a modified tracker configuration file. To do this, simply make a copy of a tracker config file (for example, `custom_tracker.yaml`) from [ultralytics/cfg/trackers](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/trackers) and modify any configurations (except the `tracker_type`) as per your needs. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load the model and run the tracker with a custom configuration file - model = YOLO('yolov8n.pt') - results = model.track(source="https://youtu.be/LNwODJXcvt4", tracker='custom_tracker.yaml') - ``` - - === "CLI" - - ```bash - # Load the model and run the tracker with a custom configuration file using the command line interface - yolo track model=yolov8n.pt source="https://youtu.be/LNwODJXcvt4" tracker='custom_tracker.yaml' - ``` - -For a comprehensive list of tracking arguments, refer to the [ultralytics/cfg/trackers](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/trackers) page. - -## Python Examples - -### Persisting Tracks Loop - -Here is a Python script using OpenCV (`cv2`) and YOLOv8 to run object tracking on video frames. This script still assumes you have already installed the necessary packages (`opencv-python` and `ultralytics`). The `persist=True` argument tells the tracker that the current image or frame is the next in a sequence and to expect tracks from the previous image in the current image. - -!!! Example "Streaming for-loop with tracking" - - ```python - import cv2 - from ultralytics import YOLO - - # Load the YOLOv8 model - model = YOLO('yolov8n.pt') - - # Open the video file - video_path = "path/to/video.mp4" - cap = cv2.VideoCapture(video_path) - - # Loop through the video frames - while cap.isOpened(): - # Read a frame from the video - success, frame = cap.read() - - if success: - # Run YOLOv8 tracking on the frame, persisting tracks between frames - results = model.track(frame, persist=True) - - # Visualize the results on the frame - annotated_frame = results[0].plot() - - # Display the annotated frame - cv2.imshow("YOLOv8 Tracking", annotated_frame) - - # Break the loop if 'q' is pressed - if cv2.waitKey(1) & 0xFF == ord("q"): - break - else: - # Break the loop if the end of the video is reached - break - - # Release the video capture object and close the display window - cap.release() - cv2.destroyAllWindows() - ``` - -Please note the change from `model(frame)` to `model.track(frame)`, which enables object tracking instead of simple detection. This modified script will run the tracker on each frame of the video, visualize the results, and display them in a window. The loop can be exited by pressing 'q'. - -### Plotting Tracks Over Time - -Visualizing object tracks over consecutive frames can provide valuable insights into the movement patterns and behavior of detected objects within a video. With Ultralytics YOLOv8, plotting these tracks is a seamless and efficient process. - -In the following example, we demonstrate how to utilize YOLOv8's tracking capabilities to plot the movement of detected objects across multiple video frames. This script involves opening a video file, reading it frame by frame, and utilizing the YOLO model to identify and track various objects. By retaining the center points of the detected bounding boxes and connecting them, we can draw lines that represent the paths followed by the tracked objects. - -!!! Example "Plotting tracks over multiple video frames" - - ```python - from collections import defaultdict - - import cv2 - import numpy as np - - from ultralytics import YOLO - - # Load the YOLOv8 model - model = YOLO('yolov8n.pt') - - # Open the video file - video_path = "path/to/video.mp4" - cap = cv2.VideoCapture(video_path) - - # Store the track history - track_history = defaultdict(lambda: []) - - # Loop through the video frames - while cap.isOpened(): - # Read a frame from the video - success, frame = cap.read() - - if success: - # Run YOLOv8 tracking on the frame, persisting tracks between frames - results = model.track(frame, persist=True) - - # Get the boxes and track IDs - boxes = results[0].boxes.xywh.cpu() - track_ids = results[0].boxes.id.int().cpu().tolist() - - # Visualize the results on the frame - annotated_frame = results[0].plot() - - # Plot the tracks - for box, track_id in zip(boxes, track_ids): - x, y, w, h = box - track = track_history[track_id] - track.append((float(x), float(y))) # x, y center point - if len(track) > 30: # retain 90 tracks for 90 frames - track.pop(0) - - # Draw the tracking lines - points = np.hstack(track).astype(np.int32).reshape((-1, 1, 2)) - cv2.polylines(annotated_frame, [points], isClosed=False, color=(230, 230, 230), thickness=10) - - # Display the annotated frame - cv2.imshow("YOLOv8 Tracking", annotated_frame) - - # Break the loop if 'q' is pressed - if cv2.waitKey(1) & 0xFF == ord("q"): - break - else: - # Break the loop if the end of the video is reached - break - - # Release the video capture object and close the display window - cap.release() - cv2.destroyAllWindows() - ``` - -### Multithreaded Tracking - -Multithreaded tracking provides the capability to run object tracking on multiple video streams simultaneously. This is particularly useful when handling multiple video inputs, such as from multiple surveillance cameras, where concurrent processing can greatly enhance efficiency and performance. - -In the provided Python script, we make use of Python's `threading` module to run multiple instances of the tracker concurrently. Each thread is responsible for running the tracker on one video file, and all the threads run simultaneously in the background. - -To ensure that each thread receives the correct parameters (the video file, the model to use and the file index), we define a function `run_tracker_in_thread` that accepts these parameters and contains the main tracking loop. This function reads the video frame by frame, runs the tracker, and displays the results. - -Two different models are used in this example: `yolov8n.pt` and `yolov8n-seg.pt`, each tracking objects in a different video file. The video files are specified in `video_file1` and `video_file2`. - -The `daemon=True` parameter in `threading.Thread` means that these threads will be closed as soon as the main program finishes. We then start the threads with `start()` and use `join()` to make the main thread wait until both tracker threads have finished. - -Finally, after all threads have completed their task, the windows displaying the results are closed using `cv2.destroyAllWindows()`. - -!!! Example "Streaming for-loop with tracking" - - ```python - import threading - import cv2 - from ultralytics import YOLO - - - def run_tracker_in_thread(filename, model, file_index): - """ - Runs a video file or webcam stream concurrently with the YOLOv8 model using threading. - - This function captures video frames from a given file or camera source and utilizes the YOLOv8 model for object - tracking. The function runs in its own thread for concurrent processing. - - Args: - filename (str): The path to the video file or the identifier for the webcam/external camera source. - model (obj): The YOLOv8 model object. - file_index (int): An index to uniquely identify the file being processed, used for display purposes. - - Note: - Press 'q' to quit the video display window. - """ - video = cv2.VideoCapture(filename) # Read the video file - - while True: - ret, frame = video.read() # Read the video frames - - # Exit the loop if no more frames in either video - if not ret: - break - - # Track objects in frames if available - results = model.track(frame, persist=True) - res_plotted = results[0].plot() - cv2.imshow(f"Tracking_Stream_{file_index}", res_plotted) - - key = cv2.waitKey(1) - if key == ord('q'): - break - - # Release video sources - video.release() - - - # Load the models - model1 = YOLO('yolov8n.pt') - model2 = YOLO('yolov8n-seg.pt') - - # Define the video files for the trackers - video_file1 = "path/to/video1.mp4" # Path to video file, 0 for webcam - video_file2 = 0 # Path to video file, 0 for webcam, 1 for external camera - - # Create the tracker threads - tracker_thread1 = threading.Thread(target=run_tracker_in_thread, args=(video_file1, model1, 1), daemon=True) - tracker_thread2 = threading.Thread(target=run_tracker_in_thread, args=(video_file2, model2, 2), daemon=True) - - # Start the tracker threads - tracker_thread1.start() - tracker_thread2.start() - - # Wait for the tracker threads to finish - tracker_thread1.join() - tracker_thread2.join() - - # Clean up and close windows - cv2.destroyAllWindows() - ``` - -This example can easily be extended to handle more video files and models by creating more threads and applying the same methodology. - -## Contribute New Trackers - -Are you proficient in multi-object tracking and have successfully implemented or adapted a tracking algorithm with Ultralytics YOLO? We invite you to contribute to our Trackers section in [ultralytics/cfg/trackers](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/trackers)! Your real-world applications and solutions could be invaluable for users working on tracking tasks. - -By contributing to this section, you help expand the scope of tracking solutions available within the Ultralytics YOLO framework, adding another layer of functionality and utility for the community. - -To initiate your contribution, please refer to our [Contributing Guide](https://docs.ultralytics.com/help/contributing) for comprehensive instructions on submitting a Pull Request (PR) 🛠️. We are excited to see what you bring to the table! - -Together, let's enhance the tracking capabilities of the Ultralytics YOLO ecosystem 🙏! - -[fish track]: https://github.com/RizwanMunawar/ultralytics/assets/62513924/a5146d0f-bfa8-4e0a-b7df-3c1446cd8142 - -[people track]: https://github.com/RizwanMunawar/ultralytics/assets/62513924/93bb4ee2-77a0-4e4e-8eb6-eb8f527f0527 - -[vehicle track]: https://github.com/RizwanMunawar/ultralytics/assets/62513924/ee6e6038-383b-4f21-ac29-b2a1c7d386ab diff --git a/ultralytics-main/docs/en/modes/train.md b/ultralytics-main/docs/en/modes/train.md deleted file mode 100644 index 820ff4b..0000000 --- a/ultralytics-main/docs/en/modes/train.md +++ /dev/null @@ -1,328 +0,0 @@ ---- -comments: true -description: Step-by-step guide to train YOLOv8 models with Ultralytics YOLO including examples of single-GPU and multi-GPU training -keywords: Ultralytics, YOLOv8, YOLO, object detection, train mode, custom dataset, GPU training, multi-GPU, hyperparameters, CLI examples, Python examples ---- - -# Model Training with Ultralytics YOLO - -Ultralytics YOLO ecosystem and integrations - -## Introduction - -Training a deep learning model involves feeding it data and adjusting its parameters so that it can make accurate predictions. Train mode in Ultralytics YOLOv8 is engineered for effective and efficient training of object detection models, fully utilizing modern hardware capabilities. This guide aims to cover all the details you need to get started with training your own models using YOLOv8's robust set of features. - -

-
- -
- Watch: How to Train a YOLOv8 model on Your Custom Dataset in Google Colab. -

- -## Why Choose Ultralytics YOLO for Training? - -Here are some compelling reasons to opt for YOLOv8's Train mode: - -- **Efficiency:** Make the most out of your hardware, whether you're on a single-GPU setup or scaling across multiple GPUs. -- **Versatility:** Train on custom datasets in addition to readily available ones like COCO, VOC, and ImageNet. -- **User-Friendly:** Simple yet powerful CLI and Python interfaces for a straightforward training experience. -- **Hyperparameter Flexibility:** A broad range of customizable hyperparameters to fine-tune model performance. - -### Key Features of Train Mode - -The following are some notable features of YOLOv8's Train mode: - -- **Automatic Dataset Download:** Standard datasets like COCO, VOC, and ImageNet are downloaded automatically on first use. -- **Multi-GPU Support:** Scale your training efforts seamlessly across multiple GPUs to expedite the process. -- **Hyperparameter Configuration:** The option to modify hyperparameters through YAML configuration files or CLI arguments. -- **Visualization and Monitoring:** Real-time tracking of training metrics and visualization of the learning process for better insights. - -!!! Tip "Tip" - - * YOLOv8 datasets like COCO, VOC, ImageNet and many others automatically download on first use, i.e. `yolo train data=coco.yaml` - -## Usage Examples - -Train YOLOv8n on the COCO128 dataset for 100 epochs at image size 640. The training device can be specified using the `device` argument. If no argument is passed GPU `device=0` will be used if available, otherwise `device=cpu` will be used. See Arguments section below for a full list of training arguments. - -!!! Example "Single-GPU and CPU Training Example" - - Device is determined automatically. If a GPU is available then it will be used, otherwise training will start on CPU. - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n.yaml') # build a new model from YAML - model = YOLO('yolov8n.pt') # load a pretrained model (recommended for training) - model = YOLO('yolov8n.yaml').load('yolov8n.pt') # build from YAML and transfer weights - - # Train the model - results = model.train(data='coco128.yaml', epochs=100, imgsz=640) - ``` - - === "CLI" - - ```bash - # Build a new model from YAML and start training from scratch - yolo detect train data=coco128.yaml model=yolov8n.yaml epochs=100 imgsz=640 - - # Start training from a pretrained *.pt model - yolo detect train data=coco128.yaml model=yolov8n.pt epochs=100 imgsz=640 - - # Build a new model from YAML, transfer pretrained weights to it and start training - yolo detect train data=coco128.yaml model=yolov8n.yaml pretrained=yolov8n.pt epochs=100 imgsz=640 - ``` - -### Multi-GPU Training - -Multi-GPU training allows for more efficient utilization of available hardware resources by distributing the training load across multiple GPUs. This feature is available through both the Python API and the command-line interface. To enable multi-GPU training, specify the GPU device IDs you wish to use. - -!!! Example "Multi-GPU Training Example" - - To train with 2 GPUs, CUDA devices 0 and 1 use the following commands. Expand to additional GPUs as required. - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n.pt') # load a pretrained model (recommended for training) - - # Train the model with 2 GPUs - results = model.train(data='coco128.yaml', epochs=100, imgsz=640, device=[0, 1]) - ``` - - === "CLI" - - ```bash - # Start training from a pretrained *.pt model using GPUs 0 and 1 - yolo detect train data=coco128.yaml model=yolov8n.pt epochs=100 imgsz=640 device=0,1 - ``` - -### Apple M1 and M2 MPS Training - -With the support for Apple M1 and M2 chips integrated in the Ultralytics YOLO models, it's now possible to train your models on devices utilizing the powerful Metal Performance Shaders (MPS) framework. The MPS offers a high-performance way of executing computation and image processing tasks on Apple's custom silicon. - -To enable training on Apple M1 and M2 chips, you should specify 'mps' as your device when initiating the training process. Below is an example of how you could do this in Python and via the command line: - -!!! Example "MPS Training Example" - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n.pt') # load a pretrained model (recommended for training) - - # Train the model with 2 GPUs - results = model.train(data='coco128.yaml', epochs=100, imgsz=640, device='mps') - ``` - - === "CLI" - - ```bash - # Start training from a pretrained *.pt model using GPUs 0 and 1 - yolo detect train data=coco128.yaml model=yolov8n.pt epochs=100 imgsz=640 device=mps - ``` - -While leveraging the computational power of the M1/M2 chips, this enables more efficient processing of the training tasks. For more detailed guidance and advanced configuration options, please refer to the [PyTorch MPS documentation](https://pytorch.org/docs/stable/notes/mps.html). - -### Resuming Interrupted Trainings - -Resuming training from a previously saved state is a crucial feature when working with deep learning models. This can come in handy in various scenarios, like when the training process has been unexpectedly interrupted, or when you wish to continue training a model with new data or for more epochs. - -When training is resumed, Ultralytics YOLO loads the weights from the last saved model and also restores the optimizer state, learning rate scheduler, and the epoch number. This allows you to continue the training process seamlessly from where it was left off. - -You can easily resume training in Ultralytics YOLO by setting the `resume` argument to `True` when calling the `train` method, and specifying the path to the `.pt` file containing the partially trained model weights. - -Below is an example of how to resume an interrupted training using Python and via the command line: - -!!! Example "Resume Training Example" - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('path/to/last.pt') # load a partially trained model - - # Resume training - results = model.train(resume=True) - ``` - - === "CLI" - - ```bash - # Resume an interrupted training - yolo train resume model=path/to/last.pt - ``` - -By setting `resume=True`, the `train` function will continue training from where it left off, using the state stored in the 'path/to/last.pt' file. If the `resume` argument is omitted or set to `False`, the `train` function will start a new training session. - -Remember that checkpoints are saved at the end of every epoch by default, or at fixed interval using the `save_period` argument, so you must complete at least 1 epoch to resume a training run. - -## Train Settings - -The training settings for YOLO models encompass various hyperparameters and configurations used during the training process. These settings influence the model's performance, speed, and accuracy. Key training settings include batch size, learning rate, momentum, and weight decay. Additionally, the choice of optimizer, loss function, and training dataset composition can impact the training process. Careful tuning and experimentation with these settings are crucial for optimizing performance. - -| Argument | Default | Description | -|-------------------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `model` | `None` | Specifies the model file for training. Accepts a path to either a `.pt` pretrained model or a `.yaml` configuration file. Essential for defining the model structure or initializing weights. | -| `data` | `None` | Path to the dataset configuration file (e.g., `coco128.yaml`). This file contains dataset-specific parameters, including paths to training and validation data, class names, and number of classes. | -| `epochs` | `100` | Total number of training epochs. Each epoch represents a full pass over the entire dataset. Adjusting this value can affect training duration and model performance. | -| `time` | `None` | Maximum training time in hours. If set, this overrides the `epochs` argument, allowing training to automatically stop after the specified duration. Useful for time-constrained training scenarios. | -| `patience` | `100` | Number of epochs to wait without improvement in validation metrics before early stopping the training. Helps prevent overfitting by stopping training when performance plateaus. | -| `batch` | `16` | Batch size for training, indicating how many images are processed before the model's internal parameters are updated. AutoBatch (`batch=-1`) dynamically adjusts the batch size based on GPU memory availability. | -| `imgsz` | `640` | Target image size for training. All images are resized to this dimension before being fed into the model. Affects model accuracy and computational complexity. | -| `save` | `True` | Enables saving of training checkpoints and final model weights. Useful for resuming training or model deployment. | -| `save_period` | `-1` | Frequency of saving model checkpoints, specified in epochs. A value of -1 disables this feature. Useful for saving interim models during long training sessions. | -| `cache` | `False` | Enables caching of dataset images in memory (`True`/`ram`), on disk (`disk`), or disables it (`False`). Improves training speed by reducing disk I/O at the cost of increased memory usage. | -| `device` | `None` | Specifies the computational device(s) for training: a single GPU (`device=0`), multiple GPUs (`device=0,1`), CPU (`device=cpu`), or MPS for Apple silicon (`device=mps`). | -| `workers` | `8` | Number of worker threads for data loading (per `RANK` if Multi-GPU training). Influences the speed of data preprocessing and feeding into the model, especially useful in multi-GPU setups. | -| `project` | `None` | Name of the project directory where training outputs are saved. Allows for organized storage of different experiments. | -| `name` | `None` | Name of the training run. Used for creating a subdirectory within the project folder, where training logs and outputs are stored. | -| `exist_ok` | `False` | If True, allows overwriting of an existing project/name directory. Useful for iterative experimentation without needing to manually clear previous outputs. | -| `pretrained` | `True` | Determines whether to start training from a pretrained model. Can be a boolean value or a string path to a specific model from which to load weights. Enhances training efficiency and model performance. | -| `optimizer` | `'auto'` | Choice of optimizer for training. Options include `SGD`, `Adam`, `AdamW`, `NAdam`, `RAdam`, `RMSProp` etc., or `auto` for automatic selection based on model configuration. Affects convergence speed and stability. | -| `verbose` | `False` | Enables verbose output during training, providing detailed logs and progress updates. Useful for debugging and closely monitoring the training process. | -| `seed` | `0` | Sets the random seed for training, ensuring reproducibility of results across runs with the same configurations. | -| `deterministic` | `True` | Forces deterministic algorithm use, ensuring reproducibility but may affect performance and speed due to the restriction on non-deterministic algorithms. | -| `single_cls` | `False` | Treats all classes in multi-class datasets as a single class during training. Useful for binary classification tasks or when focusing on object presence rather than classification. | -| `rect` | `False` | Enables rectangular training, optimizing batch composition for minimal padding. Can improve efficiency and speed but may affect model accuracy. | -| `cos_lr` | `False` | Utilizes a cosine learning rate scheduler, adjusting the learning rate following a cosine curve over epochs. Helps in managing learning rate for better convergence. | -| `close_mosaic` | `10` | Disables mosaic data augmentation in the last N epochs to stabilize training before completion. Setting to 0 disables this feature. | -| `resume` | `False` | Resumes training from the last saved checkpoint. Automatically loads model weights, optimizer state, and epoch count, continuing training seamlessly. | -| `amp` | `True` | Enables Automatic Mixed Precision (AMP) training, reducing memory usage and possibly speeding up training with minimal impact on accuracy. | -| `fraction` | `1.0` | Specifies the fraction of the dataset to use for training. Allows for training on a subset of the full dataset, useful for experiments or when resources are limited. | -| `profile` | `False` | Enables profiling of ONNX and TensorRT speeds during training, useful for optimizing model deployment. | -| `freeze` | `None` | Freezes the first N layers of the model or specified layers by index, reducing the number of trainable parameters. Useful for fine-tuning or transfer learning. | -| `lr0` | `0.01` | Initial learning rate (i.e. `SGD=1E-2`, `Adam=1E-3`) . Adjusting this value is crucial for the optimization process, influencing how rapidly model weights are updated. | -| `lrf` | `0.01` | Final learning rate as a fraction of the initial rate = (`lr0 * lrf`), used in conjunction with schedulers to adjust the learning rate over time. | -| `momentum` | `0.937` | Momentum factor for SGD or beta1 for Adam optimizers, influencing the incorporation of past gradients in the current update. | -| `weight_decay` | `0.0005` | L2 regularization term, penalizing large weights to prevent overfitting. | -| `warmup_epochs` | `3.0` | Number of epochs for learning rate warmup, gradually increasing the learning rate from a low value to the initial learning rate to stabilize training early on. | -| `warmup_momentum` | `0.8` | Initial momentum for warmup phase, gradually adjusting to the set momentum over the warmup period. | -| `warmup_bias_lr` | `0.1` | Learning rate for bias parameters during the warmup phase, helping stabilize model training in the initial epochs. | -| `box` | `7.5` | Weight of the box loss component in the loss function, influencing how much emphasis is placed on accurately predicting bounding box coordinates. | -| `cls` | `0.5` | Weight of the classification loss in the total loss function, affecting the importance of correct class prediction relative to other components. | -| `dfl` | `1.5` | Weight of the distribution focal loss, used in certain YOLO versions for fine-grained classification. | -| `pose` | `12.0` | Weight of the pose loss in models trained for pose estimation, influencing the emphasis on accurately predicting pose keypoints. | -| `kobj` | `2.0` | Weight of the keypoint objectness loss in pose estimation models, balancing detection confidence with pose accuracy. | -| `label_smoothing` | `0.0` | Applies label smoothing, softening hard labels to a mix of the target label and a uniform distribution over labels, can improve generalization. | -| `nbs` | `64` | Nominal batch size for normalization of loss. | -| `overlap_mask` | `True` | Determines whether segmentation masks should overlap during training, applicable in instance segmentation tasks. | -| `mask_ratio` | `4` | Downsample ratio for segmentation masks, affecting the resolution of masks used during training. | -| `dropout` | `0.0` | Dropout rate for regularization in classification tasks, preventing overfitting by randomly omitting units during training. | -| `val` | `True` | Enables validation during training, allowing for periodic evaluation of model performance on a separate dataset. | -| `plots` | `False` | Generates and saves plots of training and validation metrics, as well as prediction examples, providing visual insights into model performance and learning progression. | - -## Augmentation Settings and Hyperparameters - -Augmentation techniques are essential for improving the robustness and performance of YOLO models by introducing variability into the training data, helping the model generalize better to unseen data. The following table outlines the purpose and effect of each augmentation argument: - -| Argument | Type | Default | Range | Description | -|----------------|---------|---------------|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `hsv_h` | `float` | `0.015` | `0.0 - 1.0` | Adjusts the hue of the image by a fraction of the color wheel, introducing color variability. Helps the model generalize across different lighting conditions. | -| `hsv_s` | `float` | `0.7` | `0.0 - 1.0` | Alters the saturation of the image by a fraction, affecting the intensity of colors. Useful for simulating different environmental conditions. | -| `hsv_v` | `float` | `0.4` | `0.0 - 1.0` | Modifies the value (brightness) of the image by a fraction, helping the model to perform well under various lighting conditions. | -| `degrees` | `float` | `0.0` | `-180 - +180` | Rotates the image randomly within the specified degree range, improving the model's ability to recognize objects at various orientations. | -| `translate` | `float` | `0.1` | `0.0 - 1.0` | Translates the image horizontally and vertically by a fraction of the image size, aiding in learning to detect partially visible objects. | -| `scale` | `float` | `0.5` | `>=0.0` | Scales the image by a gain factor, simulating objects at different distances from the camera. | -| `shear` | `float` | `0.0` | `-180 - +180` | Shears the image by a specified degree, mimicking the effect of objects being viewed from different angles. | -| `perspective` | `float` | `0.0` | `0.0 - 0.001` | Applies a random perspective transformation to the image, enhancing the model's ability to understand objects in 3D space. | -| `flipud` | `float` | `0.0` | `0.0 - 1.0` | Flips the image upside down with the specified probability, increasing the data variability without affecting the object's characteristics. | -| `fliplr` | `float` | `0.5` | `0.0 - 1.0` | Flips the image left to right with the specified probability, useful for learning symmetrical objects and increasing dataset diversity. | -| `mosaic` | `float` | `1.0` | `0.0 - 1.0` | Combines four training images into one, simulating different scene compositions and object interactions. Highly effective for complex scene understanding. | -| `mixup` | `float` | `0.0` | `0.0 - 1.0` | Blends two images and their labels, creating a composite image. Enhances the model's ability to generalize by introducing label noise and visual variability. | -| `copy_paste` | `float` | `0.0` | `0.0 - 1.0` | Copies objects from one image and pastes them onto another, useful for increasing object instances and learning object occlusion. | -| `auto_augment` | `str` | `randaugment` | - | Automatically applies a predefined augmentation policy (`randaugment`, `autoaugment`, `augmix`), optimizing for classification tasks by diversifying the visual features. | -| `erasing` | `float` | `0.4` | `0.0 - 1.0` | Randomly erases a portion of the image during classification training, encouraging the model to focus on less obvious features for recognition. | - -These settings can be adjusted to meet the specific requirements of the dataset and task at hand. Experimenting with different values can help find the optimal augmentation strategy that leads to the best model performance. - -!!! info - - For more information about training augmentation operations, see the [reference section](../reference/data/augment.md). - -## Logging - -In training a YOLOv8 model, you might find it valuable to keep track of the model's performance over time. This is where logging comes into play. Ultralytics' YOLO provides support for three types of loggers - Comet, ClearML, and TensorBoard. - -To use a logger, select it from the dropdown menu in the code snippet above and run it. The chosen logger will be installed and initialized. - -### Comet - -[Comet](../integrations/comet.md) is a platform that allows data scientists and developers to track, compare, explain and optimize experiments and models. It provides functionalities such as real-time metrics, code diffs, and hyperparameters tracking. - -To use Comet: - -!!! Example - - === "Python" - - ```python - # pip install comet_ml - import comet_ml - - comet_ml.init() - ``` - -Remember to sign in to your Comet account on their website and get your API key. You will need to add this to your environment variables or your script to log your experiments. - -### ClearML - -[ClearML](https://www.clear.ml/) is an open-source platform that automates tracking of experiments and helps with efficient sharing of resources. It is designed to help teams manage, execute, and reproduce their ML work more efficiently. - -To use ClearML: - -!!! Example - - === "Python" - - ```python - # pip install clearml - import clearml - - clearml.browser_login() - ``` - -After running this script, you will need to sign in to your ClearML account on the browser and authenticate your session. - -### TensorBoard - -[TensorBoard](https://www.tensorflow.org/tensorboard) is a visualization toolkit for TensorFlow. It allows you to visualize your TensorFlow graph, plot quantitative metrics about the execution of your graph, and show additional data like images that pass through it. - -To use TensorBoard in [Google Colab](https://colab.research.google.com/github/ultralytics/ultralytics/blob/main/examples/tutorial.ipynb): - -!!! Example - - === "CLI" - - ```bash - load_ext tensorboard - tensorboard --logdir ultralytics/runs # replace with 'runs' directory - ``` - -To use TensorBoard locally run the below command and view results at http://localhost:6006/. - -!!! Example - - === "CLI" - - ```bash - tensorboard --logdir ultralytics/runs # replace with 'runs' directory - ``` - -This will load TensorBoard and direct it to the directory where your training logs are saved. - -After setting up your logger, you can then proceed with your model training. All training metrics will be automatically logged in your chosen platform, and you can access these logs to monitor your model's performance over time, compare different models, and identify areas for improvement. diff --git a/ultralytics-main/docs/en/modes/val.md b/ultralytics-main/docs/en/modes/val.md deleted file mode 100644 index 0c77425..0000000 --- a/ultralytics-main/docs/en/modes/val.md +++ /dev/null @@ -1,128 +0,0 @@ ---- -comments: true -description: Guide for Validating YOLOv8 Models. Learn how to evaluate the performance of your YOLO models using validation settings and metrics with Python and CLI examples. -keywords: Ultralytics, YOLO Docs, YOLOv8, validation, model evaluation, hyperparameters, accuracy, metrics, Python, CLI ---- - -# Model Validation with Ultralytics YOLO - -Ultralytics YOLO ecosystem and integrations - -## Introduction - -Validation is a critical step in the machine learning pipeline, allowing you to assess the quality of your trained models. Val mode in Ultralytics YOLOv8 provides a robust suite of tools and metrics for evaluating the performance of your object detection models. This guide serves as a complete resource for understanding how to effectively use the Val mode to ensure that your models are both accurate and reliable. - -

-
- -
- Watch: Ultralytics Modes Tutorial: Validation -

- -## Why Validate with Ultralytics YOLO? - -Here's why using YOLOv8's Val mode is advantageous: - -- **Precision:** Get accurate metrics like mAP50, mAP75, and mAP50-95 to comprehensively evaluate your model. -- **Convenience:** Utilize built-in features that remember training settings, simplifying the validation process. -- **Flexibility:** Validate your model with the same or different datasets and image sizes. -- **Hyperparameter Tuning:** Use validation metrics to fine-tune your model for better performance. - -### Key Features of Val Mode - -These are the notable functionalities offered by YOLOv8's Val mode: - -- **Automated Settings:** Models remember their training configurations for straightforward validation. -- **Multi-Metric Support:** Evaluate your model based on a range of accuracy metrics. -- **CLI and Python API:** Choose from command-line interface or Python API based on your preference for validation. -- **Data Compatibility:** Works seamlessly with datasets used during the training phase as well as custom datasets. - -!!! Tip "Tip" - - * YOLOv8 models automatically remember their training settings, so you can validate a model at the same image size and on the original dataset easily with just `yolo val model=yolov8n.pt` or `model('yolov8n.pt').val()` - -## Usage Examples - -Validate trained YOLOv8n model accuracy on the COCO128 dataset. No argument need to passed as the `model` retains it's training `data` and arguments as model attributes. See Arguments section below for a full list of export arguments. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n.pt') # load an official model - model = YOLO('path/to/best.pt') # load a custom model - - # Validate the model - metrics = model.val() # no arguments needed, dataset and settings remembered - metrics.box.map # map50-95 - metrics.box.map50 # map50 - metrics.box.map75 # map75 - metrics.box.maps # a list contains map50-95 of each category - ``` - - === "CLI" - - ```bash - yolo detect val model=yolov8n.pt # val official model - yolo detect val model=path/to/best.pt # val custom model - ``` - -## Arguments for YOLO Model Validation - -When validating YOLO models, several arguments can be fine-tuned to optimize the evaluation process. These arguments control aspects such as input image size, batch processing, and performance thresholds. Below is a detailed breakdown of each argument to help you customize your validation settings effectively. - -| Argument | Type | Default | Description | -|---------------|---------|---------|---------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `data` | `str` | `None` | Specifies the path to the dataset configuration file (e.g., `coco128.yaml`). This file includes paths to validation data, class names, and number of classes. | -| `imgsz` | `int` | `640` | Defines the size of input images. All images are resized to this dimension before processing. | -| `batch` | `int` | `16` | Sets the number of images per batch. Use `-1` for AutoBatch, which automatically adjusts based on GPU memory availability. | -| `save_json` | `bool` | `False` | If `True`, saves the results to a JSON file for further analysis or integration with other tools. | -| `save_hybrid` | `bool` | `False` | If `True`, saves a hybrid version of labels that combines original annotations with additional model predictions. | -| `conf` | `float` | `0.001` | Sets the minimum confidence threshold for detections. Detections with confidence below this threshold are discarded. | -| `iou` | `float` | `0.6` | Sets the Intersection Over Union (IoU) threshold for Non-Maximum Suppression (NMS). Helps in reducing duplicate detections. | -| `max_det` | `int` | `300` | Limits the maximum number of detections per image. Useful in dense scenes to prevent excessive detections. | -| `half` | `bool` | `True` | Enables half-precision (FP16) computation, reducing memory usage and potentially increasing speed with minimal impact on accuracy. | -| `device` | `str` | `None` | Specifies the device for validation (`cpu`, `cuda:0`, etc.). Allows flexibility in utilizing CPU or GPU resources. | -| `dnn` | `bool` | `False` | If `True`, uses the OpenCV DNN module for ONNX model inference, offering an alternative to PyTorch inference methods. | -| `plots` | `bool` | `False` | When set to `True`, generates and saves plots of predictions versus ground truth for visual evaluation of the model's performance. | -| `rect` | `bool` | `False` | If `True`, uses rectangular inference for batching, reducing padding and potentially increasing speed and efficiency. | -| `split` | `str` | `val` | Determines the dataset split to use for validation (`val`, `test`, or `train`). Allows flexibility in choosing the data segment for performance evaluation. | - -Each of these settings plays a vital role in the validation process, allowing for a customizable and efficient evaluation of YOLO models. Adjusting these parameters according to your specific needs and resources can help achieve the best balance between accuracy and performance. - -### Example Validation with Arguments - -The below examples showcase YOLO model validation with custom arguments in Python and CLI. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n.pt') - - # Customize validation settings - validation_results = model.val(data='coco8.yaml', - imgsz=640, - batch=16, - conf=0.25, - iou=0.6, - device='0') - ``` - - === "CLI" - - ```bash - yolo val model=yolov8n.pt data=coco8.yaml imgsz=640 batch=16 conf=0.25 iou=0.6 device=0 - ``` diff --git a/ultralytics-main/docs/en/quickstart.md b/ultralytics-main/docs/en/quickstart.md deleted file mode 100644 index cf54217..0000000 --- a/ultralytics-main/docs/en/quickstart.md +++ /dev/null @@ -1,328 +0,0 @@ ---- -comments: true -description: Explore various methods to install Ultralytics using pip, conda, git and Docker. Learn how to use Ultralytics with command line interface or within your Python projects. -keywords: Ultralytics installation, pip install Ultralytics, Docker install Ultralytics, Ultralytics command line interface, Ultralytics Python interface ---- - -## Install Ultralytics - -Ultralytics provides various installation methods including pip, conda, and Docker. Install YOLOv8 via the `ultralytics` pip package for the latest stable release or by cloning the [Ultralytics GitHub repository](https://github.com/ultralytics/ultralytics) for the most up-to-date version. Docker can be used to execute the package in an isolated container, avoiding local installation. - -

-
- -
- Watch: Ultralytics YOLO Quick Start Guide -

- -!!! Example "Install" - - === "Pip install (recommended)" - - Install the `ultralytics` package using pip, or update an existing installation by running `pip install -U ultralytics`. Visit the Python Package Index (PyPI) for more details on the `ultralytics` package: [https://pypi.org/project/ultralytics/](https://pypi.org/project/ultralytics/). - - [![PyPI version](https://badge.fury.io/py/ultralytics.svg)](https://badge.fury.io/py/ultralytics) [![Downloads](https://static.pepy.tech/badge/ultralytics)](https://pepy.tech/project/ultralytics) - - ```bash - # Install the ultralytics package from PyPI - pip install ultralytics - ``` - - You can also install the `ultralytics` package directly from the GitHub [repository](https://github.com/ultralytics/ultralytics). This might be useful if you want the latest development version. Make sure to have the Git command-line tool installed on your system. The `@main` command installs the `main` branch and may be modified to another branch, i.e. `@my-branch`, or removed entirely to default to `main` branch. - - ```bash - # Install the ultralytics package from GitHub - pip install git+https://github.com/ultralytics/ultralytics.git@main - ``` - - === "Conda install" - - Conda is an alternative package manager to pip which may also be used for installation. Visit Anaconda for more details at [https://anaconda.org/conda-forge/ultralytics](https://anaconda.org/conda-forge/ultralytics). Ultralytics feedstock repository for updating the conda package is at [https://github.com/conda-forge/ultralytics-feedstock/](https://github.com/conda-forge/ultralytics-feedstock/). - - - [![Conda Recipe](https://img.shields.io/badge/recipe-ultralytics-green.svg)](https://anaconda.org/conda-forge/ultralytics) [![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/ultralytics.svg)](https://anaconda.org/conda-forge/ultralytics) [![Conda Version](https://img.shields.io/conda/vn/conda-forge/ultralytics.svg)](https://anaconda.org/conda-forge/ultralytics) [![Conda Platforms](https://img.shields.io/conda/pn/conda-forge/ultralytics.svg)](https://anaconda.org/conda-forge/ultralytics) - - ```bash - # Install the ultralytics package using conda - conda install -c conda-forge ultralytics - ``` - - !!! Note - - If you are installing in a CUDA environment best practice is to install `ultralytics`, `pytorch` and `pytorch-cuda` in the same command to allow the conda package manager to resolve any conflicts, or else to install `pytorch-cuda` last to allow it override the CPU-specific `pytorch` package if necessary. - ```bash - # Install all packages together using conda - conda install -c pytorch -c nvidia -c conda-forge pytorch torchvision pytorch-cuda=11.8 ultralytics - ``` - - ### Conda Docker Image - - Ultralytics Conda Docker images are also available from [DockerHub](https://hub.docker.com/r/ultralytics/ultralytics). These images are based on [Miniconda3](https://docs.conda.io/projects/miniconda/en/latest/) and are an simple way to start using `ultralytics` in a Conda environment. - - ```bash - # Set image name as a variable - t=ultralytics/ultralytics:latest-conda - - # Pull the latest ultralytics image from Docker Hub - sudo docker pull $t - - # Run the ultralytics image in a container with GPU support - sudo docker run -it --ipc=host --gpus all $t # all GPUs - sudo docker run -it --ipc=host --gpus '"device=2,3"' $t # specify GPUs - ``` - - === "Git clone" - Clone the `ultralytics` repository if you are interested in contributing to the development or wish to experiment with the latest source code. After cloning, navigate into the directory and install the package in editable mode `-e` using pip. - ```bash - # Clone the ultralytics repository - git clone https://github.com/ultralytics/ultralytics - - # Navigate to the cloned directory - cd ultralytics - - # Install the package in editable mode for development - pip install -e . - ``` - - === "Docker" - - Utilize Docker to effortlessly execute the `ultralytics` package in an isolated container, ensuring consistent and smooth performance across various environments. By choosing one of the official `ultralytics` images from [Docker Hub](https://hub.docker.com/r/ultralytics/ultralytics), you not only avoid the complexity of local installation but also benefit from access to a verified working environment. Ultralytics offers 5 main supported Docker images, each designed to provide high compatibility and efficiency for different platforms and use cases: - - Docker Pulls - - - **Dockerfile:** GPU image recommended for training. - - **Dockerfile-arm64:** Optimized for ARM64 architecture, allowing deployment on devices like Raspberry Pi and other ARM64-based platforms. - - **Dockerfile-cpu:** Ubuntu-based CPU-only version suitable for inference and environments without GPUs. - - **Dockerfile-jetson:** Tailored for NVIDIA Jetson devices, integrating GPU support optimized for these platforms. - - **Dockerfile-python:** Minimal image with just Python and necessary dependencies, ideal for lightweight applications and development. - - **Dockerfile-conda:** Based on Miniconda3 with conda installation of ultralytics package. - - Below are the commands to get the latest image and execute it: - - ```bash - # Set image name as a variable - t=ultralytics/ultralytics:latest - - # Pull the latest ultralytics image from Docker Hub - sudo docker pull $t - - # Run the ultralytics image in a container with GPU support - sudo docker run -it --ipc=host --gpus all $t # all GPUs - sudo docker run -it --ipc=host --gpus '"device=2,3"' $t # specify GPUs - ``` - - The above command initializes a Docker container with the latest `ultralytics` image. The `-it` flag assigns a pseudo-TTY and maintains stdin open, enabling you to interact with the container. The `--ipc=host` flag sets the IPC (Inter-Process Communication) namespace to the host, which is essential for sharing memory between processes. The `--gpus all` flag enables access to all available GPUs inside the container, which is crucial for tasks that require GPU computation. - - Note: To work with files on your local machine within the container, use Docker volumes for mounting a local directory into the container: - - ```bash - # Mount local directory to a directory inside the container - sudo docker run -it --ipc=host --gpus all -v /path/on/host:/path/in/container $t - ``` - - Alter `/path/on/host` with the directory path on your local machine, and `/path/in/container` with the desired path inside the Docker container for accessibility. - - For advanced Docker usage, feel free to explore the [Ultralytics Docker Guide](https://docs.ultralytics.com/guides/docker-quickstart/). - -See the `ultralytics` [requirements.txt](https://github.com/ultralytics/ultralytics/blob/main/pyproject.toml) file for a list of dependencies. Note that all examples above install all required dependencies. - -!!! Tip "Tip" - - PyTorch requirements vary by operating system and CUDA requirements, so it's recommended to install PyTorch first following instructions at [https://pytorch.org/get-started/locally](https://pytorch.org/get-started/locally). - - - PyTorch Installation Instructions - - -## Use Ultralytics with CLI - -The Ultralytics command line interface (CLI) allows for simple single-line commands without the need for a Python environment. CLI requires no customization or Python code. You can simply run all tasks from the terminal with the `yolo` command. Check out the [CLI Guide](usage/cli.md) to learn more about using YOLOv8 from the command line. - -!!! Example - - === "Syntax" - - Ultralytics `yolo` commands use the following syntax: - ```bash - yolo TASK MODE ARGS - ``` - - - `TASK` (optional) is one of ([detect](tasks/detect.md), [segment](tasks/segment.md), [classify](tasks/classify.md), [pose](tasks/pose.md)) - - `MODE` (required) is one of ([train](modes/train.md), [val](modes/val.md), [predict](modes/predict.md), [export](modes/export.md), [track](modes/track.md)) - - `ARGS` (optional) are `arg=value` pairs like `imgsz=640` that override defaults. - - See all `ARGS` in the full [Configuration Guide](usage/cfg.md) or with the `yolo cfg` CLI command. - - === "Train" - - Train a detection model for 10 epochs with an initial learning_rate of 0.01 - ```bash - yolo train data=coco128.yaml model=yolov8n.pt epochs=10 lr0=0.01 - ``` - - === "Predict" - - Predict a YouTube video using a pretrained segmentation model at image size 320: - ```bash - yolo predict model=yolov8n-seg.pt source='https://youtu.be/LNwODJXcvt4' imgsz=320 - ``` - - === "Val" - - Val a pretrained detection model at batch-size 1 and image size 640: - ```bash - yolo val model=yolov8n.pt data=coco128.yaml batch=1 imgsz=640 - ``` - - === "Export" - - Export a YOLOv8n classification model to ONNX format at image size 224 by 128 (no TASK required) - ```bash - yolo export model=yolov8n-cls.pt format=onnx imgsz=224,128 - ``` - - === "Special" - - Run special commands to see version, view settings, run checks and more: - ```bash - yolo help - yolo checks - yolo version - yolo settings - yolo copy-cfg - yolo cfg - ``` - -!!! Warning "Warning" - - Arguments must be passed as `arg=val` pairs, split by an equals `=` sign and delimited by spaces between pairs. Do not use `--` argument prefixes or commas `,` between arguments. - - - `yolo predict model=yolov8n.pt imgsz=640 conf=0.25` ✅ - - `yolo predict model yolov8n.pt imgsz 640 conf 0.25` ❌ (missing `=`) - - `yolo predict model=yolov8n.pt, imgsz=640, conf=0.25` ❌ (do not use `,`) - - `yolo predict --model yolov8n.pt --imgsz 640 --conf 0.25` ❌ (do not use `--`) - -[CLI Guide](usage/cli.md){ .md-button } - -## Use Ultralytics with Python - -YOLOv8's Python interface allows for seamless integration into your Python projects, making it easy to load, run, and process the model's output. Designed with simplicity and ease of use in mind, the Python interface enables users to quickly implement object detection, segmentation, and classification in their projects. This makes YOLOv8's Python interface an invaluable tool for anyone looking to incorporate these functionalities into their Python projects. - -For example, users can load a model, train it, evaluate its performance on a validation set, and even export it to ONNX format with just a few lines of code. Check out the [Python Guide](usage/python.md) to learn more about using YOLOv8 within your Python projects. - -!!! Example - - ```python - from ultralytics import YOLO - - # Create a new YOLO model from scratch - model = YOLO('yolov8n.yaml') - - # Load a pretrained YOLO model (recommended for training) - model = YOLO('yolov8n.pt') - - # Train the model using the 'coco128.yaml' dataset for 3 epochs - results = model.train(data='coco128.yaml', epochs=3) - - # Evaluate the model's performance on the validation set - results = model.val() - - # Perform object detection on an image using the model - results = model('https://ultralytics.com/images/bus.jpg') - - # Export the model to ONNX format - success = model.export(format='onnx') - ``` - -[Python Guide](usage/python.md){.md-button .md-button--primary} - -## Ultralytics Settings - -The Ultralytics library provides a powerful settings management system to enable fine-grained control over your experiments. By making use of the `SettingsManager` housed within the `ultralytics.utils` module, users can readily access and alter their settings. These are stored in a YAML file and can be viewed or modified either directly within the Python environment or via the Command-Line Interface (CLI). - -### Inspecting Settings - -To gain insight into the current configuration of your settings, you can view them directly: - -!!! Example "View settings" - - === "Python" - You can use Python to view your settings. Start by importing the `settings` object from the `ultralytics` module. Print and return settings using the following commands: - ```python - from ultralytics import settings - - # View all settings - print(settings) - - # Return a specific setting - value = settings['runs_dir'] - ``` - - === "CLI" - Alternatively, the command-line interface allows you to check your settings with a simple command: - ```bash - yolo settings - ``` - -### Modifying Settings - -Ultralytics allows users to easily modify their settings. Changes can be performed in the following ways: - -!!! Example "Update settings" - - === "Python" - Within the Python environment, call the `update` method on the `settings` object to change your settings: - ```python - from ultralytics import settings - - # Update a setting - settings.update({'runs_dir': '/path/to/runs'}) - - # Update multiple settings - settings.update({'runs_dir': '/path/to/runs', 'tensorboard': False}) - - # Reset settings to default values - settings.reset() - ``` - - === "CLI" - If you prefer using the command-line interface, the following commands will allow you to modify your settings: - ```bash - # Update a setting - yolo settings runs_dir='/path/to/runs' - - # Update multiple settings - yolo settings runs_dir='/path/to/runs' tensorboard=False - - # Reset settings to default values - yolo settings reset - ``` - -### Understanding Settings - -The table below provides an overview of the settings available for adjustment within Ultralytics. Each setting is outlined along with an example value, the data type, and a brief description. - -| Name | Example Value | Data Type | Description | -|--------------------|-----------------------|-----------|------------------------------------------------------------------------------------------------------------------| -| `settings_version` | `'0.0.4'` | `str` | Ultralytics _settings_ version (different from Ultralytics [pip](https://pypi.org/project/ultralytics/) version) | -| `datasets_dir` | `'/path/to/datasets'` | `str` | The directory where the datasets are stored | -| `weights_dir` | `'/path/to/weights'` | `str` | The directory where the model weights are stored | -| `runs_dir` | `'/path/to/runs'` | `str` | The directory where the experiment runs are stored | -| `uuid` | `'a1b2c3d4'` | `str` | The unique identifier for the current settings | -| `sync` | `True` | `bool` | Whether to sync analytics and crashes to HUB | -| `api_key` | `''` | `str` | Ultralytics HUB [API Key](https://hub.ultralytics.com/settings?tab=api+keys) | -| `clearml` | `True` | `bool` | Whether to use ClearML logging | -| `comet` | `True` | `bool` | Whether to use [Comet ML](https://bit.ly/yolov8-readme-comet) for experiment tracking and visualization | -| `dvc` | `True` | `bool` | Whether to use [DVC for experiment tracking](https://dvc.org/doc/dvclive/ml-frameworks/yolo) and version control | -| `hub` | `True` | `bool` | Whether to use [Ultralytics HUB](https://hub.ultralytics.com) integration | -| `mlflow` | `True` | `bool` | Whether to use MLFlow for experiment tracking | -| `neptune` | `True` | `bool` | Whether to use Neptune for experiment tracking | -| `raytune` | `True` | `bool` | Whether to use Ray Tune for hyperparameter tuning | -| `tensorboard` | `True` | `bool` | Whether to use TensorBoard for visualization | -| `wandb` | `True` | `bool` | Whether to use Weights & Biases logging | - -As you navigate through your projects or experiments, be sure to revisit these settings to ensure that they are optimally configured for your needs. diff --git a/ultralytics-main/docs/en/reference/cfg/__init__.md b/ultralytics-main/docs/en/reference/cfg/__init__.md deleted file mode 100644 index b8db12c..0000000 --- a/ultralytics-main/docs/en/reference/cfg/__init__.md +++ /dev/null @@ -1,64 +0,0 @@ ---- -description: Explore Ultralytics cfg functions like cfg2dict, handle_deprecation, merge_equal_args & more to handle YOLO settings and configurations efficiently. -keywords: Ultralytics, YOLO, Configuration, cfg2dict, handle_deprecation, merge_equals_args, handle_yolo_settings, copy_default_cfg, Image Detection ---- - -# Reference for `ultralytics/cfg/__init__.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/__init__.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/__init__.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/cfg/__init__.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.cfg.cfg2dict - -

- -## ::: ultralytics.cfg.get_cfg - -

- -## ::: ultralytics.cfg.get_save_dir - -

- -## ::: ultralytics.cfg._handle_deprecation - -

- -## ::: ultralytics.cfg.check_dict_alignment - -

- -## ::: ultralytics.cfg.merge_equals_args - -

- -## ::: ultralytics.cfg.handle_yolo_hub - -

- -## ::: ultralytics.cfg.handle_yolo_settings - -

- -## ::: ultralytics.cfg.handle_explorer - -

- -## ::: ultralytics.cfg.parse_key_value_pair - -

- -## ::: ultralytics.cfg.smart_value - -

- -## ::: ultralytics.cfg.entrypoint - -

- -## ::: ultralytics.cfg.copy_default_cfg - -

diff --git a/ultralytics-main/docs/en/reference/data/annotator.md b/ultralytics-main/docs/en/reference/data/annotator.md deleted file mode 100644 index ab685b2..0000000 --- a/ultralytics-main/docs/en/reference/data/annotator.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Enhance your machine learning model with Ultralytics’ auto_annotate function. Simplify data annotation for improved model training. -keywords: Ultralytics, Auto-Annotate, Machine Learning, AI, Annotation, Data Processing, Model Training ---- - -# Reference for `ultralytics/data/annotator.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/annotator.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/annotator.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/data/annotator.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.data.annotator.auto_annotate - -

diff --git a/ultralytics-main/docs/en/reference/data/augment.md b/ultralytics-main/docs/en/reference/data/augment.md deleted file mode 100644 index 1d4099f..0000000 --- a/ultralytics-main/docs/en/reference/data/augment.md +++ /dev/null @@ -1,84 +0,0 @@ ---- -description: Detailed exploration into Ultralytics data augmentation methods including BaseTransform, MixUp, LetterBox, ToTensor, and more for enhancing model performance. -keywords: Ultralytics, Data Augmentation, BaseTransform, MixUp, RandomHSV, LetterBox, Albumentations, classify_transforms, classify_albumentations ---- - -# Reference for `ultralytics/data/augment.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/augment.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/augment.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/data/augment.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.data.augment.BaseTransform - -

- -## ::: ultralytics.data.augment.Compose - -

- -## ::: ultralytics.data.augment.BaseMixTransform - -

- -## ::: ultralytics.data.augment.Mosaic - -

- -## ::: ultralytics.data.augment.MixUp - -

- -## ::: ultralytics.data.augment.RandomPerspective - -

- -## ::: ultralytics.data.augment.RandomHSV - -

- -## ::: ultralytics.data.augment.RandomFlip - -

- -## ::: ultralytics.data.augment.LetterBox - -

- -## ::: ultralytics.data.augment.CopyPaste - -

- -## ::: ultralytics.data.augment.Albumentations - -

- -## ::: ultralytics.data.augment.Format - -

- -## ::: ultralytics.data.augment.ClassifyLetterBox - -

- -## ::: ultralytics.data.augment.CenterCrop - -

- -## ::: ultralytics.data.augment.ToTensor - -

- -## ::: ultralytics.data.augment.v8_transforms - -

- -## ::: ultralytics.data.augment.classify_transforms - -

- -## ::: ultralytics.data.augment.classify_augmentations - -

diff --git a/ultralytics-main/docs/en/reference/data/base.md b/ultralytics-main/docs/en/reference/data/base.md deleted file mode 100644 index c98a7c3..0000000 --- a/ultralytics-main/docs/en/reference/data/base.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Explore BaseDataset in Ultralytics docs. Learn how this implementation simplifies dataset creation and manipulation. -keywords: Ultralytics, docs, BaseDataset, data manipulation, dataset creation ---- - -# Reference for `ultralytics/data/base.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/base.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/base.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/data/base.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.data.base.BaseDataset - -

diff --git a/ultralytics-main/docs/en/reference/data/build.md b/ultralytics-main/docs/en/reference/data/build.md deleted file mode 100644 index 811c11d..0000000 --- a/ultralytics-main/docs/en/reference/data/build.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -description: Explore the Ultralytics YOLO v3 data build procedures, including the InfiniteDataLoader, seed_worker, build_dataloader, and load_inference_source. -keywords: Ultralytics, YOLO v3, Data build, DataLoader, InfiniteDataLoader, seed_worker, build_dataloader, load_inference_source ---- - -# Reference for `ultralytics/data/build.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/build.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/build.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/data/build.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.data.build.InfiniteDataLoader - -

- -## ::: ultralytics.data.build._RepeatSampler - -

- -## ::: ultralytics.data.build.seed_worker - -

- -## ::: ultralytics.data.build.build_yolo_dataset - -

- -## ::: ultralytics.data.build.build_dataloader - -

- -## ::: ultralytics.data.build.check_source - -

- -## ::: ultralytics.data.build.load_inference_source - -

diff --git a/ultralytics-main/docs/en/reference/data/converter.md b/ultralytics-main/docs/en/reference/data/converter.md deleted file mode 100644 index 1d456b3..0000000 --- a/ultralytics-main/docs/en/reference/data/converter.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -description: Explore Ultralytics data converter functions like coco91_to_coco80_class, merge_multi_segment, rle2polygon for efficient data handling. -keywords: Ultralytics, Data Converter, coco91_to_coco80_class, merge_multi_segment, rle2polygon ---- - -# Reference for `ultralytics/data/converter.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/converter.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/converter.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/data/converter.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.data.converter.coco91_to_coco80_class - -

- -## ::: ultralytics.data.converter.coco80_to_coco91_class - -

- -## ::: ultralytics.data.converter.convert_coco - -

- -## ::: ultralytics.data.converter.convert_dota_to_yolo_obb - -

- -## ::: ultralytics.data.converter.min_index - -

- -## ::: ultralytics.data.converter.merge_multi_segment - -

- -## ::: ultralytics.data.converter.yolo_bbox2segment - -

diff --git a/ultralytics-main/docs/en/reference/data/dataset.md b/ultralytics-main/docs/en/reference/data/dataset.md deleted file mode 100644 index 242a054..0000000 --- a/ultralytics-main/docs/en/reference/data/dataset.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -description: Explore the YOLODataset and SemanticDataset classes in YOLO data. Learn how to efficiently handle and manipulate your data with Ultralytics. -keywords: Ultralytics, YOLO, YOLODataset, SemanticDataset, data handling, data manipulation ---- - -# Reference for `ultralytics/data/dataset.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/dataset.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/dataset.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/data/dataset.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.data.dataset.YOLODataset - -

- -## ::: ultralytics.data.dataset.ClassificationDataset - -

- -## ::: ultralytics.data.dataset.SemanticDataset - -

- -## ::: ultralytics.data.dataset.load_dataset_cache_file - -

- -## ::: ultralytics.data.dataset.save_dataset_cache_file - -

diff --git a/ultralytics-main/docs/en/reference/data/explorer/explorer.md b/ultralytics-main/docs/en/reference/data/explorer/explorer.md deleted file mode 100644 index d860863..0000000 --- a/ultralytics-main/docs/en/reference/data/explorer/explorer.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -comments: true -description: Comprehensive reference for the Explorer API. Get a brief description of all the main classes utilised for creating and handling the data in the Ultralytics data explorer project. -keywords: Ultralytics, explorer.py, data explorer, Semantic search, vector similarity search, class reference, documentation, ExplorerDataset, Explorer, data handling ---- - -# Reference for `ultralytics/data/explorer/explorer.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/explorer/explorer.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/explorer/explorer.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/data/explorer/explorer.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.data.explorer.explorer.ExplorerDataset - -

- -## ::: ultralytics.data.explorer.explorer.Explorer - -

diff --git a/ultralytics-main/docs/en/reference/data/explorer/gui/dash.md b/ultralytics-main/docs/en/reference/data/explorer/gui/dash.md deleted file mode 100644 index fd241d9..0000000 --- a/ultralytics-main/docs/en/reference/data/explorer/gui/dash.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -comments: true -description: Detailed reference for the Explorer GUI. Includes brief descriptions for all the major functions used in the dashboard demo of Explorer API. -keywords: Ultralytics, data explorer, gui, function reference, documentation, AI queries, image similarity, SQL queries, streamlit, semantic search ---- - -# Reference for `ultralytics/data/explorer/gui/dash.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/explorer/gui/dash.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/explorer/gui/dash.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/data/explorer/gui/dash.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.data.explorer.gui.dash._get_explorer - -

- -## ::: ultralytics.data.explorer.gui.dash.init_explorer_form - -

- -## ::: ultralytics.data.explorer.gui.dash.query_form - -

- -## ::: ultralytics.data.explorer.gui.dash.ai_query_form - -

- -## ::: ultralytics.data.explorer.gui.dash.find_similar_imgs - -

- -## ::: ultralytics.data.explorer.gui.dash.similarity_form - -

- -## ::: ultralytics.data.explorer.gui.dash.run_sql_query - -

- -## ::: ultralytics.data.explorer.gui.dash.run_ai_query - -

- -## ::: ultralytics.data.explorer.gui.dash.reset_explorer - -

- -## ::: ultralytics.data.explorer.gui.dash.utralytics_explorer_docs_callback - -

- -## ::: ultralytics.data.explorer.gui.dash.layout - -

diff --git a/ultralytics-main/docs/en/reference/data/explorer/utils.md b/ultralytics-main/docs/en/reference/data/explorer/utils.md deleted file mode 100644 index d1769c5..0000000 --- a/ultralytics-main/docs/en/reference/data/explorer/utils.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -comments: true -description: Detailed reference for the Explorer utils. Provides descriptions and details on important utility functions for managing and interacting with data in the Ultralytics explorer project. -keywords: Ultralytics, data explorer, function reference, documentation, get table schema, get sim index schema, sanitize batch, plot query result, prompt SQL query ---- - -# Reference for `ultralytics/data/explorer/utils.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/explorer/utils.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/explorer/utils.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/data/explorer/utils.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.data.explorer.utils.get_table_schema - -

- -## ::: ultralytics.data.explorer.utils.get_sim_index_schema - -

- -## ::: ultralytics.data.explorer.utils.sanitize_batch - -

- -## ::: ultralytics.data.explorer.utils.plot_query_result - -

- -## ::: ultralytics.data.explorer.utils.prompt_sql_query - -

diff --git a/ultralytics-main/docs/en/reference/data/loaders.md b/ultralytics-main/docs/en/reference/data/loaders.md deleted file mode 100644 index 99d7749..0000000 --- a/ultralytics-main/docs/en/reference/data/loaders.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -description: Find detailed guides on Ultralytics YOLO data loaders, including LoadStreams, LoadImages and LoadTensor. Learn how to get the best YouTube URLs. -keywords: Ultralytics, data loaders, LoadStreams, LoadImages, LoadTensor, YOLO, YouTube URLs ---- - -# Reference for `ultralytics/data/loaders.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/loaders.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/loaders.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/data/loaders.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.data.loaders.SourceTypes - -

- -## ::: ultralytics.data.loaders.LoadStreams - -

- -## ::: ultralytics.data.loaders.LoadScreenshots - -

- -## ::: ultralytics.data.loaders.LoadImagesAndVideos - -

- -## ::: ultralytics.data.loaders.LoadPilAndNumpy - -

- -## ::: ultralytics.data.loaders.LoadTensor - -

- -## ::: ultralytics.data.loaders.autocast_list - -

- -## ::: ultralytics.data.loaders.get_best_youtube_url - -

diff --git a/ultralytics-main/docs/en/reference/data/split_dota.md b/ultralytics-main/docs/en/reference/data/split_dota.md deleted file mode 100644 index ae3dfaa..0000000 --- a/ultralytics-main/docs/en/reference/data/split_dota.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -description: Detailed guide on using YOLO with DOTA dataset for object detection, including dataset preparation, image splitting, and label handling. -keywords: Ultralytics, YOLO, DOTA dataset, object detection, image processing, python, dataset preparation, image splitting, label handling, YOLO with DOTA, computer vision, AI, machine learning ---- - -# Reference for `ultralytics/data/split_dota.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/split_dota.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/split_dota.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/data/split_dota.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.data.split_dota.bbox_iof - -

- -## ::: ultralytics.data.split_dota.load_yolo_dota - -

- -## ::: ultralytics.data.split_dota.get_windows - -

- -## ::: ultralytics.data.split_dota.get_window_obj - -

- -## ::: ultralytics.data.split_dota.crop_and_save - -

- -## ::: ultralytics.data.split_dota.split_images_and_labels - -

- -## ::: ultralytics.data.split_dota.split_trainval - -

- -## ::: ultralytics.data.split_dota.split_test - -

diff --git a/ultralytics-main/docs/en/reference/data/utils.md b/ultralytics-main/docs/en/reference/data/utils.md deleted file mode 100644 index af06ce8..0000000 --- a/ultralytics-main/docs/en/reference/data/utils.md +++ /dev/null @@ -1,68 +0,0 @@ ---- -description: Uncover a detailed guide to Ultralytics data utilities. Learn functions from img2label_paths to autosplit, all boosting your YOLO model’s efficiency. -keywords: Ultralytics, data utils, YOLO, img2label_paths, exif_size, polygon2mask, polygons2masks_overlap, check_cls_dataset, delete_dsstore, autosplit ---- - -# Reference for `ultralytics/data/utils.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/utils.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/data/utils.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/data/utils.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.data.utils.HUBDatasetStats - -

- -## ::: ultralytics.data.utils.img2label_paths - -

- -## ::: ultralytics.data.utils.get_hash - -

- -## ::: ultralytics.data.utils.exif_size - -

- -## ::: ultralytics.data.utils.verify_image - -

- -## ::: ultralytics.data.utils.verify_image_label - -

- -## ::: ultralytics.data.utils.polygon2mask - -

- -## ::: ultralytics.data.utils.polygons2masks - -

- -## ::: ultralytics.data.utils.polygons2masks_overlap - -

- -## ::: ultralytics.data.utils.find_dataset_yaml - -

- -## ::: ultralytics.data.utils.check_det_dataset - -

- -## ::: ultralytics.data.utils.check_cls_dataset - -

- -## ::: ultralytics.data.utils.compress_one_image - -

- -## ::: ultralytics.data.utils.autosplit - -

diff --git a/ultralytics-main/docs/en/reference/engine/exporter.md b/ultralytics-main/docs/en/reference/engine/exporter.md deleted file mode 100644 index e8daeac..0000000 --- a/ultralytics-main/docs/en/reference/engine/exporter.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -description: Explore the exporter functionality of Ultralytics. Learn about exporting formats, IOSDetectModel, and try exporting with examples. -keywords: Ultralytics, Exporter, IOSDetectModel, Export Formats, Try export ---- - -# Reference for `ultralytics/engine/exporter.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/engine/exporter.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/engine/exporter.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/engine/exporter.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.engine.exporter.Exporter - -

- -## ::: ultralytics.engine.exporter.IOSDetectModel - -

- -## ::: ultralytics.engine.exporter.export_formats - -

- -## ::: ultralytics.engine.exporter.gd_outputs - -

- -## ::: ultralytics.engine.exporter.try_export - -

diff --git a/ultralytics-main/docs/en/reference/engine/model.md b/ultralytics-main/docs/en/reference/engine/model.md deleted file mode 100644 index 5579d75..0000000 --- a/ultralytics-main/docs/en/reference/engine/model.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Explore the detailed guide on using the Ultralytics YOLO Engine Model. Learn better ways to implement, train and evaluate YOLO models. -keywords: Ultralytics, YOLO, engine model, documentation, guide, implementation, training, evaluation ---- - -# Reference for `ultralytics/engine/model.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/engine/model.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/engine/model.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/engine/model.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.engine.model.Model - -

diff --git a/ultralytics-main/docs/en/reference/engine/predictor.md b/ultralytics-main/docs/en/reference/engine/predictor.md deleted file mode 100644 index ad50352..0000000 --- a/ultralytics-main/docs/en/reference/engine/predictor.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Learn about Ultralytics BasePredictor, an essential component of our engine that serves as the foundation for all prediction operations. -keywords: Ultralytics, BasePredictor, YOLO, prediction, engine ---- - -# Reference for `ultralytics/engine/predictor.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/engine/predictor.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/engine/predictor.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/engine/predictor.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.engine.predictor.BasePredictor - -

diff --git a/ultralytics-main/docs/en/reference/engine/results.md b/ultralytics-main/docs/en/reference/engine/results.md deleted file mode 100644 index 9b389ee..0000000 --- a/ultralytics-main/docs/en/reference/engine/results.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -description: Master Ultralytics engine results including base tensors, boxes, and keypoints with our thorough documentation. -keywords: Ultralytics, engine, results, base tensor, boxes, keypoints ---- - -# Reference for `ultralytics/engine/results.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/engine/results.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/engine/results.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/engine/results.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.engine.results.BaseTensor - -

- -## ::: ultralytics.engine.results.Results - -

- -## ::: ultralytics.engine.results.Boxes - -

- -## ::: ultralytics.engine.results.Masks - -

- -## ::: ultralytics.engine.results.Keypoints - -

- -## ::: ultralytics.engine.results.Probs - -

- -## ::: ultralytics.engine.results.OBB - -

diff --git a/ultralytics-main/docs/en/reference/engine/trainer.md b/ultralytics-main/docs/en/reference/engine/trainer.md deleted file mode 100644 index 7c74b04..0000000 --- a/ultralytics-main/docs/en/reference/engine/trainer.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Learn about the BaseTrainer class in the Ultralytics library. From training control, customization to advanced usage. -keywords: Ultralytics, BaseTrainer, Machine Learning, Training Control, Python library ---- - -# Reference for `ultralytics/engine/trainer.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/engine/trainer.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/engine/trainer.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/engine/trainer.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.engine.trainer.BaseTrainer - -

diff --git a/ultralytics-main/docs/en/reference/engine/tuner.md b/ultralytics-main/docs/en/reference/engine/tuner.md deleted file mode 100644 index 7882b8c..0000000 --- a/ultralytics-main/docs/en/reference/engine/tuner.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Explore the Ultralytics Tuner, a powerful tool designed for hyperparameter tuning of YOLO models to optimize performance across various tasks like object detection, image classification, and more. -keywords: Ultralytics, Tuner, YOLO, hyperparameter tuning, optimization, object detection, image classification, instance segmentation, pose estimation, multi-object tracking ---- - -# Reference for `ultralytics/engine/tuner.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/engine/tuner.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/engine/tuner.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/engine/tuner.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.engine.tuner.Tuner - -

diff --git a/ultralytics-main/docs/en/reference/engine/validator.md b/ultralytics-main/docs/en/reference/engine/validator.md deleted file mode 100644 index 5c0f4cd..0000000 --- a/ultralytics-main/docs/en/reference/engine/validator.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Learn about the Ultralytics BaseValidator module. Understand its principles, uses, and how it interacts with other components. -keywords: Ultralytics, BaseValidator, Ultralytics engine, module, components ---- - -# Reference for `ultralytics/engine/validator.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/engine/validator.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/engine/validator.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/engine/validator.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.engine.validator.BaseValidator - -

diff --git a/ultralytics-main/docs/en/reference/hub/__init__.md b/ultralytics-main/docs/en/reference/hub/__init__.md deleted file mode 100644 index 912de06..0000000 --- a/ultralytics-main/docs/en/reference/hub/__init__.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -description: Explore Ultralytics hub functions for model resetting, checking datasets, model exporting and more. Easy-to-follow instructions provided. -keywords: Ultralytics, hub functions, model export, dataset check, reset model, YOLO Docs ---- - -# Reference for `ultralytics/hub/__init__.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/hub/__init__.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/hub/__init__.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/hub/__init__.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.hub.login - -

- -## ::: ultralytics.hub.logout - -

- -## ::: ultralytics.hub.reset_model - -

- -## ::: ultralytics.hub.export_fmts_hub - -

- -## ::: ultralytics.hub.export_model - -

- -## ::: ultralytics.hub.get_export - -

- -## ::: ultralytics.hub.check_dataset - -

diff --git a/ultralytics-main/docs/en/reference/hub/auth.md b/ultralytics-main/docs/en/reference/hub/auth.md deleted file mode 100644 index 964dc73..0000000 --- a/ultralytics-main/docs/en/reference/hub/auth.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Dive into the Ultralytics Auth API documentation & learn how to manage authentication in your AI & ML projects easily and effectively. -keywords: Ultralytics, Auth, API documentation, User Authentication, AI, Machine Learning ---- - -# Reference for `ultralytics/hub/auth.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/hub/auth.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/hub/auth.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/hub/auth.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.hub.auth.Auth - -

diff --git a/ultralytics-main/docs/en/reference/hub/session.md b/ultralytics-main/docs/en/reference/hub/session.md deleted file mode 100644 index fb30715..0000000 --- a/ultralytics-main/docs/en/reference/hub/session.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Explore details about the HUBTrainingSession in Ultralytics framework. Learn to utilize this functionality for effective model training. -keywords: Ultralytics, HUBTrainingSession, Documentation, Model Training, AI, Machine Learning, YOLO ---- - -# Reference for `ultralytics/hub/session.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/hub/session.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/hub/session.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/hub/session.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.hub.session.HUBTrainingSession - -

diff --git a/ultralytics-main/docs/en/reference/hub/utils.md b/ultralytics-main/docs/en/reference/hub/utils.md deleted file mode 100644 index e310a01..0000000 --- a/ultralytics-main/docs/en/reference/hub/utils.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -description: Explore Ultralytics docs for various Events, including "request_with_credentials" and "requests_with_progress". Also, understand the use of the "smart_request". -keywords: Ultralytics, Events, request_with_credentials, smart_request, Ultralytics hub utils, requests_with_progress ---- - -# Reference for `ultralytics/hub/utils.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/hub/utils.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/hub/utils.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/hub/utils.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.hub.utils.Events - -

- -## ::: ultralytics.hub.utils.request_with_credentials - -

- -## ::: ultralytics.hub.utils.requests_with_progress - -

- -## ::: ultralytics.hub.utils.smart_request - -

diff --git a/ultralytics-main/docs/en/reference/models/fastsam/model.md b/ultralytics-main/docs/en/reference/models/fastsam/model.md deleted file mode 100644 index 0e99a8c..0000000 --- a/ultralytics-main/docs/en/reference/models/fastsam/model.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Learn all about Ultralytics FastSAM model. Dive into our comprehensive guide for seamless integration and efficient model training. -keywords: Ultralytics, FastSAM model, Model documentation, Efficient model training ---- - -# Reference for `ultralytics/models/fastsam/model.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/fastsam/model.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/fastsam/model.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/fastsam/model.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.fastsam.model.FastSAM - -

diff --git a/ultralytics-main/docs/en/reference/models/fastsam/predict.md b/ultralytics-main/docs/en/reference/models/fastsam/predict.md deleted file mode 100644 index 7c7196e..0000000 --- a/ultralytics-main/docs/en/reference/models/fastsam/predict.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Get detailed insights about Ultralytics FastSAMPredictor. Learn to predict and optimize your AI models with our properly documented guidelines. -keywords: Ultralytics, FastSAMPredictor, predictive modeling, AI optimization, machine learning, deep learning, Ultralytics documentation ---- - -# Reference for `ultralytics/models/fastsam/predict.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/fastsam/predict.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/fastsam/predict.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/fastsam/predict.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.fastsam.predict.FastSAMPredictor - -

diff --git a/ultralytics-main/docs/en/reference/models/fastsam/prompt.md b/ultralytics-main/docs/en/reference/models/fastsam/prompt.md deleted file mode 100644 index 0a37023..0000000 --- a/ultralytics-main/docs/en/reference/models/fastsam/prompt.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Learn to effectively utilize FastSAMPrompt model from Ultralytics. Detailed guide to help you get the most out of your machine learning models. -keywords: Ultralytics, FastSAMPrompt, machine learning, model, guide, documentation ---- - -# Reference for `ultralytics/models/fastsam/prompt.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/fastsam/prompt.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/fastsam/prompt.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/fastsam/prompt.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.fastsam.prompt.FastSAMPrompt - -

diff --git a/ultralytics-main/docs/en/reference/models/fastsam/utils.md b/ultralytics-main/docs/en/reference/models/fastsam/utils.md deleted file mode 100644 index 0ba33ab..0000000 --- a/ultralytics-main/docs/en/reference/models/fastsam/utils.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -description: Learn how to adjust bounding boxes to image borders in Ultralytics models using the bbox_iou utility. Enhance your object detection performance. -keywords: Ultralytics, bounding boxes, Bboxes, image borders, object detection, bbox_iou, model utilities ---- - -# Reference for `ultralytics/models/fastsam/utils.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/fastsam/utils.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/fastsam/utils.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/fastsam/utils.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.fastsam.utils.adjust_bboxes_to_image_border - -

- -## ::: ultralytics.models.fastsam.utils.bbox_iou - -

diff --git a/ultralytics-main/docs/en/reference/models/fastsam/val.md b/ultralytics-main/docs/en/reference/models/fastsam/val.md deleted file mode 100644 index 4064f05..0000000 --- a/ultralytics-main/docs/en/reference/models/fastsam/val.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Learn about FastSAMValidator in Ultralytics models. Comprehensive guide to enhancing AI capabilities with Ultralytics. -keywords: Ultralytics, FastSAMValidator, model, synthetic, AI, machine learning, validation ---- - -# Reference for `ultralytics/models/fastsam/val.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/fastsam/val.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/fastsam/val.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/fastsam/val.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.fastsam.val.FastSAMValidator - -

diff --git a/ultralytics-main/docs/en/reference/models/nas/model.md b/ultralytics-main/docs/en/reference/models/nas/model.md deleted file mode 100644 index 9536e54..0000000 --- a/ultralytics-main/docs/en/reference/models/nas/model.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Learn how our NAS model operates in Ultralytics. Comprehensive guide with detailed examples. Master the nuances of Ultralytics NAS model. -keywords: Ultralytics, NAS model, NAS guide, machine learning, model documentation ---- - -# Reference for `ultralytics/models/nas/model.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/nas/model.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/nas/model.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/nas/model.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.nas.model.NAS - -

diff --git a/ultralytics-main/docs/en/reference/models/nas/predict.md b/ultralytics-main/docs/en/reference/models/nas/predict.md deleted file mode 100644 index 3dcc0fd..0000000 --- a/ultralytics-main/docs/en/reference/models/nas/predict.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Explore Ultralytics NASPredictor. Understand high-level architecture of the model for effective implementation and efficient predictions. -keywords: NASPredictor, Ultralytics, Ultralytics model, model architecture, efficient predictions ---- - -# Reference for `ultralytics/models/nas/predict.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/nas/predict.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/nas/predict.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/nas/predict.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.nas.predict.NASPredictor - -

diff --git a/ultralytics-main/docs/en/reference/models/nas/val.md b/ultralytics-main/docs/en/reference/models/nas/val.md deleted file mode 100644 index 5d0adf6..0000000 --- a/ultralytics-main/docs/en/reference/models/nas/val.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Explore the utilities and functions of the Ultralytics NASValidator. Find out how it benefits allocation and optimization in AI models. -keywords: Ultralytics, NASValidator, models.nas.val.NASValidator, AI models, allocation, optimization ---- - -# Reference for `ultralytics/models/nas/val.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/nas/val.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/nas/val.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/nas/val.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.nas.val.NASValidator - -

diff --git a/ultralytics-main/docs/en/reference/models/rtdetr/model.md b/ultralytics-main/docs/en/reference/models/rtdetr/model.md deleted file mode 100644 index a4578b2..0000000 --- a/ultralytics-main/docs/en/reference/models/rtdetr/model.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Explore the specifics of using the RTDETR model in Ultralytics. Detailed documentation layered with explanations and examples. -keywords: Ultralytics, RTDETR model, Ultralytics models, object detection, Ultralytics documentation ---- - -# Reference for `ultralytics/models/rtdetr/model.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/rtdetr/model.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/rtdetr/model.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/rtdetr/model.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.rtdetr.model.RTDETR - -

diff --git a/ultralytics-main/docs/en/reference/models/rtdetr/predict.md b/ultralytics-main/docs/en/reference/models/rtdetr/predict.md deleted file mode 100644 index 4763381..0000000 --- a/ultralytics-main/docs/en/reference/models/rtdetr/predict.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Learn how to use the RTDETRPredictor model of the Ultralytics package. Detailed documentation, usage instructions, and advice. -keywords: Ultralytics, RTDETRPredictor, model documentation, guide, real-time object detection ---- - -# Reference for `ultralytics/models/rtdetr/predict.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/rtdetr/predict.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/rtdetr/predict.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/rtdetr/predict.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.rtdetr.predict.RTDETRPredictor - -

diff --git a/ultralytics-main/docs/en/reference/models/rtdetr/train.md b/ultralytics-main/docs/en/reference/models/rtdetr/train.md deleted file mode 100644 index 4f9faaa..0000000 --- a/ultralytics-main/docs/en/reference/models/rtdetr/train.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Get insights into RTDETRTrainer, a crucial component of Ultralytics for effective model training. Explore detailed documentation at Ultralytics. -keywords: Ultralytics, RTDETRTrainer, model training, Ultralytics models, PyTorch models, neural networks, machine learning, deep learning ---- - -# Reference for `ultralytics/models/rtdetr/train.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/rtdetr/train.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/rtdetr/train.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/rtdetr/train.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.rtdetr.train.RTDETRTrainer - -

diff --git a/ultralytics-main/docs/en/reference/models/rtdetr/val.md b/ultralytics-main/docs/en/reference/models/rtdetr/val.md deleted file mode 100644 index d31bc86..0000000 --- a/ultralytics-main/docs/en/reference/models/rtdetr/val.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -description: Explore RTDETRDataset in Ultralytics Models. Learn about the RTDETRValidator function, understand its usage in real-time object detection. -keywords: Ultralytics, RTDETRDataset, RTDETRValidator, real-time object detection, models documentation ---- - -# Reference for `ultralytics/models/rtdetr/val.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/rtdetr/val.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/rtdetr/val.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/rtdetr/val.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.rtdetr.val.RTDETRDataset - -

- -## ::: ultralytics.models.rtdetr.val.RTDETRValidator - -

diff --git a/ultralytics-main/docs/en/reference/models/sam/amg.md b/ultralytics-main/docs/en/reference/models/sam/amg.md deleted file mode 100644 index dea35e4..0000000 --- a/ultralytics-main/docs/en/reference/models/sam/amg.md +++ /dev/null @@ -1,56 +0,0 @@ ---- -description: Explore Ultralytics methods for mask data processing, transformation and encoding. Deepen your understanding of RLE encoding, image cropping and more. -keywords: Ultralytics, Mask Data, Transformation, Encoding, RLE encoding, Image cropping, Pytorch, SAM, AMG, Ultralytics model ---- - -# Reference for `ultralytics/models/sam/amg.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/sam/amg.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/sam/amg.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/sam/amg.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.sam.amg.is_box_near_crop_edge - -

- -## ::: ultralytics.models.sam.amg.batch_iterator - -

- -## ::: ultralytics.models.sam.amg.calculate_stability_score - -

- -## ::: ultralytics.models.sam.amg.build_point_grid - -

- -## ::: ultralytics.models.sam.amg.build_all_layer_point_grids - -

- -## ::: ultralytics.models.sam.amg.generate_crop_boxes - -

- -## ::: ultralytics.models.sam.amg.uncrop_boxes_xyxy - -

- -## ::: ultralytics.models.sam.amg.uncrop_points - -

- -## ::: ultralytics.models.sam.amg.uncrop_masks - -

- -## ::: ultralytics.models.sam.amg.remove_small_regions - -

- -## ::: ultralytics.models.sam.amg.batched_mask_to_box - -

diff --git a/ultralytics-main/docs/en/reference/models/sam/build.md b/ultralytics-main/docs/en/reference/models/sam/build.md deleted file mode 100644 index 9adeeb4..0000000 --- a/ultralytics-main/docs/en/reference/models/sam/build.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -description: Master building SAM ViT models with Ultralytics. Discover steps to leverage the power of SAM and Vision Transformer sessions. -keywords: Ultralytics, SAM, build sam, vision transformer, vits, build_sam_vit_l, build_sam_vit_b, build_sam ---- - -# Reference for `ultralytics/models/sam/build.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/sam/build.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/sam/build.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/sam/build.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.sam.build.build_sam_vit_h - -

- -## ::: ultralytics.models.sam.build.build_sam_vit_l - -

- -## ::: ultralytics.models.sam.build.build_sam_vit_b - -

- -## ::: ultralytics.models.sam.build.build_mobile_sam - -

- -## ::: ultralytics.models.sam.build._build_sam - -

- -## ::: ultralytics.models.sam.build.build_sam - -

diff --git a/ultralytics-main/docs/en/reference/models/sam/model.md b/ultralytics-main/docs/en/reference/models/sam/model.md deleted file mode 100644 index 32444bc..0000000 --- a/ultralytics-main/docs/en/reference/models/sam/model.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Dive into the SAM model details in the Ultralytics YOLO documentation. Understand, implement, and optimize your model use. -keywords: Ultralytics, YOLO, SAM Model, Documentations, Machine Learning, AI, Convolutional neural network ---- - -# Reference for `ultralytics/models/sam/model.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/sam/model.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/sam/model.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/sam/model.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.sam.model.SAM - -

diff --git a/ultralytics-main/docs/en/reference/models/sam/modules/decoders.md b/ultralytics-main/docs/en/reference/models/sam/modules/decoders.md deleted file mode 100644 index 215b832..0000000 --- a/ultralytics-main/docs/en/reference/models/sam/modules/decoders.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -description: Explore MaskDecoder, a part of the Ultralytics models. Gain insights on how to utilize it effectively in the SAM modules decoders MLP. -keywords: Ultralytics, MaskDecoder, SAM modules, decoders, MLP, YOLO, machine learning, image recognition ---- - -# Reference for `ultralytics/models/sam/modules/decoders.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/sam/modules/decoders.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/sam/modules/decoders.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/sam/modules/decoders.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.sam.modules.decoders.MaskDecoder - -

- -## ::: ultralytics.models.sam.modules.decoders.MLP - -

diff --git a/ultralytics-main/docs/en/reference/models/sam/modules/encoders.md b/ultralytics-main/docs/en/reference/models/sam/modules/encoders.md deleted file mode 100644 index ffcbf44..0000000 --- a/ultralytics-main/docs/en/reference/models/sam/modules/encoders.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -description: Discover detailed information on ImageEncoderViT, PositionEmbeddingRandom, Attention, window_partition, get_rel_pos and more in Ultralytics models encoders documentation. -keywords: Ultralytics, Encoders, Modules, Documentation, ImageEncoderViT, PositionEmbeddingRandom, Attention, window_partition, get_rel_pos ---- - -# Reference for `ultralytics/models/sam/modules/encoders.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/sam/modules/encoders.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/sam/modules/encoders.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/sam/modules/encoders.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.sam.modules.encoders.ImageEncoderViT - -

- -## ::: ultralytics.models.sam.modules.encoders.PromptEncoder - -

- -## ::: ultralytics.models.sam.modules.encoders.PositionEmbeddingRandom - -

- -## ::: ultralytics.models.sam.modules.encoders.Block - -

- -## ::: ultralytics.models.sam.modules.encoders.Attention - -

- -## ::: ultralytics.models.sam.modules.encoders.PatchEmbed - -

- -## ::: ultralytics.models.sam.modules.encoders.window_partition - -

- -## ::: ultralytics.models.sam.modules.encoders.window_unpartition - -

- -## ::: ultralytics.models.sam.modules.encoders.get_rel_pos - -

- -## ::: ultralytics.models.sam.modules.encoders.add_decomposed_rel_pos - -

diff --git a/ultralytics-main/docs/en/reference/models/sam/modules/sam.md b/ultralytics-main/docs/en/reference/models/sam/modules/sam.md deleted file mode 100644 index d309e24..0000000 --- a/ultralytics-main/docs/en/reference/models/sam/modules/sam.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Explore the Sam module of Ultralytics. Discover detailed methods, classes, and information for efficient deep-learning model training!. -keywords: Ultralytics, Sam module, deep learning, model training, Ultralytics documentation ---- - -# Reference for `ultralytics/models/sam/modules/sam.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/sam/modules/sam.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/sam/modules/sam.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/sam/modules/sam.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.sam.modules.sam.Sam - -

diff --git a/ultralytics-main/docs/en/reference/models/sam/modules/tiny_encoder.md b/ultralytics-main/docs/en/reference/models/sam/modules/tiny_encoder.md deleted file mode 100644 index 1d945be..0000000 --- a/ultralytics-main/docs/en/reference/models/sam/modules/tiny_encoder.md +++ /dev/null @@ -1,56 +0,0 @@ ---- -description: Get in-depth insights about Ultralytics Tiny Encoder Modules such as Conv2d_BN, MBConv, ConvLayer, Attention, BasicLayer, and TinyViT. Improve your understanding of machine learning model components. -keywords: Ultralytics, Tiny Encoder, Conv2d_BN, MBConv, ConvLayer, Attention, BasicLayer, TinyViT, Machine learning modules, Ultralytics models ---- - -# Reference for `ultralytics/models/sam/modules/tiny_encoder.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/sam/modules/tiny_encoder.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/sam/modules/tiny_encoder.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/sam/modules/tiny_encoder.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.sam.modules.tiny_encoder.Conv2d_BN - -

- -## ::: ultralytics.models.sam.modules.tiny_encoder.PatchEmbed - -

- -## ::: ultralytics.models.sam.modules.tiny_encoder.MBConv - -

- -## ::: ultralytics.models.sam.modules.tiny_encoder.PatchMerging - -

- -## ::: ultralytics.models.sam.modules.tiny_encoder.ConvLayer - -

- -## ::: ultralytics.models.sam.modules.tiny_encoder.Mlp - -

- -## ::: ultralytics.models.sam.modules.tiny_encoder.Attention - -

- -## ::: ultralytics.models.sam.modules.tiny_encoder.TinyViTBlock - -

- -## ::: ultralytics.models.sam.modules.tiny_encoder.BasicLayer - -

- -## ::: ultralytics.models.sam.modules.tiny_encoder.LayerNorm2d - -

- -## ::: ultralytics.models.sam.modules.tiny_encoder.TinyViT - -

diff --git a/ultralytics-main/docs/en/reference/models/sam/modules/transformer.md b/ultralytics-main/docs/en/reference/models/sam/modules/transformer.md deleted file mode 100644 index d36a31e..0000000 --- a/ultralytics-main/docs/en/reference/models/sam/modules/transformer.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -description: Learn about TwoWayTransformer and Attention modules in Ultralytics. Leverage these tools to enhance your AI models. -keywords: Ultralytics, TwoWayTransformer, Attention, AI models, transformers ---- - -# Reference for `ultralytics/models/sam/modules/transformer.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/sam/modules/transformer.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/sam/modules/transformer.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/sam/modules/transformer.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.sam.modules.transformer.TwoWayTransformer - -

- -## ::: ultralytics.models.sam.modules.transformer.TwoWayAttentionBlock - -

- -## ::: ultralytics.models.sam.modules.transformer.Attention - -

diff --git a/ultralytics-main/docs/en/reference/models/sam/predict.md b/ultralytics-main/docs/en/reference/models/sam/predict.md deleted file mode 100644 index ae4c788..0000000 --- a/ultralytics-main/docs/en/reference/models/sam/predict.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Master the ultralytics.models.sam.predict.Predictor class with our comprehensive guide. Discover techniques to enhance your model predictions. -keywords: Ultralytics, predictor, models, sam.predict.Predictor, AI, machine learning, predictive models ---- - -# Reference for `ultralytics/models/sam/predict.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/sam/predict.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/sam/predict.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/sam/predict.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.sam.predict.Predictor - -

diff --git a/ultralytics-main/docs/en/reference/models/utils/loss.md b/ultralytics-main/docs/en/reference/models/utils/loss.md deleted file mode 100644 index 567308e..0000000 --- a/ultralytics-main/docs/en/reference/models/utils/loss.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -description: Learn to use the DETRLoss function provided by Ultralytics YOLO. Understand how to utilize loss in RTDETR detection models to improve accuracy. -keywords: Ultralytics, YOLO, Documentation, DETRLoss, Detection Loss, Loss function, DETR, RTDETR Detection Models ---- - -# Reference for `ultralytics/models/utils/loss.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/utils/loss.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/utils/loss.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/utils/loss.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.utils.loss.DETRLoss - -

- -## ::: ultralytics.models.utils.loss.RTDETRDetectionLoss - -

diff --git a/ultralytics-main/docs/en/reference/models/utils/ops.md b/ultralytics-main/docs/en/reference/models/utils/ops.md deleted file mode 100644 index 4ca7614..0000000 --- a/ultralytics-main/docs/en/reference/models/utils/ops.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -description: Discover details for "HungarianMatcher" & "inverse_sigmoid" functions in Ultralytics YOLO, advanced tools supporting detection models. -keywords: Ultralytics, YOLO, HungarianMatcher, inverse_sigmoid, detection models, model utilities, ops ---- - -# Reference for `ultralytics/models/utils/ops.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/utils/ops.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/utils/ops.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/utils/ops.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.utils.ops.HungarianMatcher - -

- -## ::: ultralytics.models.utils.ops.get_cdn_group - -

diff --git a/ultralytics-main/docs/en/reference/models/yolo/classify/predict.md b/ultralytics-main/docs/en/reference/models/yolo/classify/predict.md deleted file mode 100644 index 581107b..0000000 --- a/ultralytics-main/docs/en/reference/models/yolo/classify/predict.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Explore the Ultralytics ClassificationPredictor guide for model prediction and visualization. Build powerful AI models with YOLO. -keywords: Ultralytics, classification predictor, predict, YOLO, AI models, model visualization ---- - -# Reference for `ultralytics/models/yolo/classify/predict.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/classify/predict.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/classify/predict.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/yolo/classify/predict.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.yolo.classify.predict.ClassificationPredictor - -

diff --git a/ultralytics-main/docs/en/reference/models/yolo/classify/train.md b/ultralytics-main/docs/en/reference/models/yolo/classify/train.md deleted file mode 100644 index e4b9ea8..0000000 --- a/ultralytics-main/docs/en/reference/models/yolo/classify/train.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Delve into Classification Trainer at Ultralytics YOLO docs and optimize your model's training process with insights from the masters!. -keywords: Ultralytics, YOLO, Classification Trainer, deep learning, training process, AI models, documentation ---- - -# Reference for `ultralytics/models/yolo/classify/train.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/classify/train.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/classify/train.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/yolo/classify/train.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.yolo.classify.train.ClassificationTrainer - -

diff --git a/ultralytics-main/docs/en/reference/models/yolo/classify/val.md b/ultralytics-main/docs/en/reference/models/yolo/classify/val.md deleted file mode 100644 index 27f64ff..0000000 --- a/ultralytics-main/docs/en/reference/models/yolo/classify/val.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Explore YOLO ClassificationValidator, a key element of Ultralytics YOLO models. Learn how it validates and fine-tunes model outputs. -keywords: Ultralytics, YOLO, ClassificationValidator, model validation, model fine-tuning, deep learning, computer vision ---- - -# Reference for `ultralytics/models/yolo/classify/val.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/classify/val.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/classify/val.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/yolo/classify/val.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.yolo.classify.val.ClassificationValidator - -

diff --git a/ultralytics-main/docs/en/reference/models/yolo/detect/predict.md b/ultralytics-main/docs/en/reference/models/yolo/detect/predict.md deleted file mode 100644 index 4b6cafd..0000000 --- a/ultralytics-main/docs/en/reference/models/yolo/detect/predict.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Explore the guide to using the DetectionPredictor in Ultralytics YOLO. Learn how to predict, detect and analyze objects accurately. -keywords: Ultralytics, YOLO, DetectionPredictor, detect, predict, object detection, analysis ---- - -# Reference for `ultralytics/models/yolo/detect/predict.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/detect/predict.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/detect/predict.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/yolo/detect/predict.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.yolo.detect.predict.DetectionPredictor - -

diff --git a/ultralytics-main/docs/en/reference/models/yolo/detect/train.md b/ultralytics-main/docs/en/reference/models/yolo/detect/train.md deleted file mode 100644 index bca6faf..0000000 --- a/ultralytics-main/docs/en/reference/models/yolo/detect/train.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Maximize your model's potential with Ultralytics YOLO Detection Trainer. Learn advanced techniques, tips, and tricks for training. -keywords: Ultralytics YOLO, YOLO, Detection Trainer, Model Training, Machine Learning, Deep Learning, Computer Vision ---- - -# Reference for `ultralytics/models/yolo/detect/train.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/detect/train.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/detect/train.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/yolo/detect/train.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.yolo.detect.train.DetectionTrainer - -

diff --git a/ultralytics-main/docs/en/reference/models/yolo/detect/val.md b/ultralytics-main/docs/en/reference/models/yolo/detect/val.md deleted file mode 100644 index c5333d0..0000000 --- a/ultralytics-main/docs/en/reference/models/yolo/detect/val.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Discover function valuation of your YOLO models with the Ultralytics Detection Validator. Enhance precision and recall rates today. -keywords: Ultralytics, YOLO, Detection Validator, model valuation, precision, recall ---- - -# Reference for `ultralytics/models/yolo/detect/val.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/detect/val.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/detect/val.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/yolo/detect/val.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.yolo.detect.val.DetectionValidator - -

diff --git a/ultralytics-main/docs/en/reference/models/yolo/model.md b/ultralytics-main/docs/en/reference/models/yolo/model.md deleted file mode 100644 index 6df6b73..0000000 --- a/ultralytics-main/docs/en/reference/models/yolo/model.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -description: Discover the Ultralytics YOLO model class. Learn advanced techniques, tips, and tricks for training. -keywords: Ultralytics YOLO, YOLO, YOLO model, Model Training, Machine Learning, Deep Learning, Computer Vision ---- - -# Reference for `ultralytics/models/yolo/model.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/model.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/model.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/yolo/model.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.yolo.model.YOLO - -

- -## ::: ultralytics.models.yolo.model.YOLOWorld - -

diff --git a/ultralytics-main/docs/en/reference/models/yolo/obb/predict.md b/ultralytics-main/docs/en/reference/models/yolo/obb/predict.md deleted file mode 100644 index 159f59a..0000000 --- a/ultralytics-main/docs/en/reference/models/yolo/obb/predict.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Discover OBBPredictor for YOLO, specializing in Oriented Bounding Box predictions. Essential for advanced object detection with Ultralytics YOLO. -keywords: Ultralytics, OBBPredictor, YOLO, Oriented Bounding Box, object detection, advanced object detection, YOLO model, deep learning, AI, machine learning, computer vision, OBB detection ---- - -# Reference for `ultralytics/models/yolo/obb/predict.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/obb/predict.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/obb/predict.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/yolo/obb/predict.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.yolo.obb.predict.OBBPredictor - -

diff --git a/ultralytics-main/docs/en/reference/models/yolo/obb/train.md b/ultralytics-main/docs/en/reference/models/yolo/obb/train.md deleted file mode 100644 index 1a9c8ec..0000000 --- a/ultralytics-main/docs/en/reference/models/yolo/obb/train.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Master the Ultralytics YOLO OBB Trainer: A specialized tool for training YOLO models using Oriented Bounding Boxes. Features detailed usage, model initialization, and training processes. -keywords: Ultralytics, YOLO OBB Trainer, Oriented Bounding Box, OBB model training, YOLO model training, computer vision, deep learning, machine learning, YOLO object detection, model initialization, YOLO training process ---- - -# Reference for `ultralytics/models/yolo/obb/train.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/obb/train.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/obb/train.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/yolo/obb/train.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.yolo.obb.train.OBBTrainer - -

diff --git a/ultralytics-main/docs/en/reference/models/yolo/obb/val.md b/ultralytics-main/docs/en/reference/models/yolo/obb/val.md deleted file mode 100644 index b18db7e..0000000 --- a/ultralytics-main/docs/en/reference/models/yolo/obb/val.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Learn about Ultralytics' advanced OBBValidator, an extension of YOLO object detection for oriented bounding box validation. -keywords: Ultralytics, YOLO, OBBValidator, object detection, oriented bounding box, OBB, machine learning, AI, deep learning, Python, YOLO model, image processing, computer vision, YOLO object detection ---- - -# Reference for `ultralytics/models/yolo/obb/val.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/obb/val.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/obb/val.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/yolo/obb/val.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.yolo.obb.val.OBBValidator - -

diff --git a/ultralytics-main/docs/en/reference/models/yolo/pose/predict.md b/ultralytics-main/docs/en/reference/models/yolo/pose/predict.md deleted file mode 100644 index 9eb4af4..0000000 --- a/ultralytics-main/docs/en/reference/models/yolo/pose/predict.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Discover how to use PosePredictor in the Ultralytics YOLO model. Includes detailed guides, code examples, and explanations. -keywords: Ultralytics, YOLO, PosePredictor, machine learning, AI, predictive models ---- - -# Reference for `ultralytics/models/yolo/pose/predict.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/pose/predict.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/pose/predict.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/yolo/pose/predict.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.yolo.pose.predict.PosePredictor - -

diff --git a/ultralytics-main/docs/en/reference/models/yolo/pose/train.md b/ultralytics-main/docs/en/reference/models/yolo/pose/train.md deleted file mode 100644 index 1d02bf2..0000000 --- a/ultralytics-main/docs/en/reference/models/yolo/pose/train.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Explore Ultralytics PoseTrainer for YOLO models. Get a step-by-step guide on how to train on custom pose data for more accurate AI modeling. -keywords: Ultralytics, YOLO, PoseTrainer, pose training, AI modeling, custom data training ---- - -# Reference for `ultralytics/models/yolo/pose/train.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/pose/train.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/pose/train.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/yolo/pose/train.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.yolo.pose.train.PoseTrainer - -

diff --git a/ultralytics-main/docs/en/reference/models/yolo/pose/val.md b/ultralytics-main/docs/en/reference/models/yolo/pose/val.md deleted file mode 100644 index 77207be..0000000 --- a/ultralytics-main/docs/en/reference/models/yolo/pose/val.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Explore the PoseValidator—review how Ultralytics YOLO validates poses for object detection. Improve your understanding of YOLO. -keywords: PoseValidator, Ultralytics, YOLO, Object detection, Pose validation ---- - -# Reference for `ultralytics/models/yolo/pose/val.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/pose/val.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/pose/val.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/yolo/pose/val.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.yolo.pose.val.PoseValidator - -

diff --git a/ultralytics-main/docs/en/reference/models/yolo/segment/predict.md b/ultralytics-main/docs/en/reference/models/yolo/segment/predict.md deleted file mode 100644 index a92b6f6..0000000 --- a/ultralytics-main/docs/en/reference/models/yolo/segment/predict.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Discover how to utilize the YOLO Segmentation Predictor in Ultralytics. Enhance your objects detection skills with us. -keywords: YOLO, Ultralytics, object detection, segmentation predictor ---- - -# Reference for `ultralytics/models/yolo/segment/predict.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/segment/predict.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/segment/predict.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/yolo/segment/predict.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.yolo.segment.predict.SegmentationPredictor - -

diff --git a/ultralytics-main/docs/en/reference/models/yolo/segment/train.md b/ultralytics-main/docs/en/reference/models/yolo/segment/train.md deleted file mode 100644 index 1b5c3d5..0000000 --- a/ultralytics-main/docs/en/reference/models/yolo/segment/train.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Maximize your YOLO model's performance with our SegmentationTrainer. Explore comprehensive guides and tutorials on ultralytics.com. -keywords: Ultralytics, YOLO, SegmentationTrainer, image segmentation, object detection, model training, YOLO model ---- - -# Reference for `ultralytics/models/yolo/segment/train.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/segment/train.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/segment/train.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/yolo/segment/train.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.yolo.segment.train.SegmentationTrainer - -

diff --git a/ultralytics-main/docs/en/reference/models/yolo/segment/val.md b/ultralytics-main/docs/en/reference/models/yolo/segment/val.md deleted file mode 100644 index 745b22c..0000000 --- a/ultralytics-main/docs/en/reference/models/yolo/segment/val.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Get practical insights about our SegmentationValidator in YOLO Ultralytics models. Discover functionality details, methods, inputs, and outputs. -keywords: Ultralytics, YOLO, SegmentationValidator, model segmentation, image classification, object detection ---- - -# Reference for `ultralytics/models/yolo/segment/val.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/segment/val.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/models/yolo/segment/val.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/models/yolo/segment/val.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.models.yolo.segment.val.SegmentationValidator - -

diff --git a/ultralytics-main/docs/en/reference/nn/autobackend.md b/ultralytics-main/docs/en/reference/nn/autobackend.md deleted file mode 100644 index 3e8c2f7..0000000 --- a/ultralytics-main/docs/en/reference/nn/autobackend.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -description: Get to know more about Ultralytics nn.autobackend.check_class_names functionality. Optimize your YOLO models seamlessly. -keywords: Ultralytics, AutoBackend, check_class_names, YOLO, YOLO models, optimization ---- - -# Reference for `ultralytics/nn/autobackend.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/nn/autobackend.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/nn/autobackend.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/nn/autobackend.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.nn.autobackend.AutoBackend - -

- -## ::: ultralytics.nn.autobackend.check_class_names - -

- -## ::: ultralytics.nn.autobackend.default_class_names - -

diff --git a/ultralytics-main/docs/en/reference/nn/modules/block.md b/ultralytics-main/docs/en/reference/nn/modules/block.md deleted file mode 100644 index e94da5a..0000000 --- a/ultralytics-main/docs/en/reference/nn/modules/block.md +++ /dev/null @@ -1,140 +0,0 @@ ---- -description: Explore Ultralytics YOLO neural network modules, Proto to BottleneckCSP. Detailed explanation of each module with easy-to-follow code examples. -keywords: YOLO, Ultralytics, neural network, nn.modules.block, Proto, HGBlock, SPPF, C2, C3, RepC3, C3Ghost, Bottleneck, BottleneckCSP ---- - -# Reference for `ultralytics/nn/modules/block.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/nn/modules/block.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/nn/modules/block.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/nn/modules/block.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.nn.modules.block.DFL - -

- -## ::: ultralytics.nn.modules.block.Proto - -

- -## ::: ultralytics.nn.modules.block.HGStem - -

- -## ::: ultralytics.nn.modules.block.HGBlock - -

- -## ::: ultralytics.nn.modules.block.SPP - -

- -## ::: ultralytics.nn.modules.block.SPPF - -

- -## ::: ultralytics.nn.modules.block.C1 - -

- -## ::: ultralytics.nn.modules.block.C2 - -

- -## ::: ultralytics.nn.modules.block.C2f - -

- -## ::: ultralytics.nn.modules.block.C3 - -

- -## ::: ultralytics.nn.modules.block.C3x - -

- -## ::: ultralytics.nn.modules.block.RepC3 - -

- -## ::: ultralytics.nn.modules.block.C3TR - -

- -## ::: ultralytics.nn.modules.block.C3Ghost - -

- -## ::: ultralytics.nn.modules.block.GhostBottleneck - -

- -## ::: ultralytics.nn.modules.block.Bottleneck - -

- -## ::: ultralytics.nn.modules.block.BottleneckCSP - -

- -## ::: ultralytics.nn.modules.block.ResNetBlock - -

- -## ::: ultralytics.nn.modules.block.ResNetLayer - -

- -## ::: ultralytics.nn.modules.block.MaxSigmoidAttnBlock - -

- -## ::: ultralytics.nn.modules.block.C2fAttn - -

- -## ::: ultralytics.nn.modules.block.ImagePoolingAttn - -

- -## ::: ultralytics.nn.modules.block.ContrastiveHead - -

- -## ::: ultralytics.nn.modules.block.BNContrastiveHead - -

- -## ::: ultralytics.nn.modules.block.RepBottleneck - -

- -## ::: ultralytics.nn.modules.block.RepCSP - -

- -## ::: ultralytics.nn.modules.block.RepNCSPELAN4 - -

- -## ::: ultralytics.nn.modules.block.ADown - -

- -## ::: ultralytics.nn.modules.block.SPPELAN - -

- -## ::: ultralytics.nn.modules.block.Silence - -

- -## ::: ultralytics.nn.modules.block.CBLinear - -

- -## ::: ultralytics.nn.modules.block.CBFuse - -

diff --git a/ultralytics-main/docs/en/reference/nn/modules/conv.md b/ultralytics-main/docs/en/reference/nn/modules/conv.md deleted file mode 100644 index 6c9fb35..0000000 --- a/ultralytics-main/docs/en/reference/nn/modules/conv.md +++ /dev/null @@ -1,68 +0,0 @@ ---- -description: Explore various Ultralytics convolution modules including Conv2, DWConv, ConvTranspose, GhostConv, Channel Attention and more. -keywords: Ultralytics, Convolution Modules, Conv2, DWConv, ConvTranspose, GhostConv, ChannelAttention, CBAM, autopad ---- - -# Reference for `ultralytics/nn/modules/conv.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/nn/modules/conv.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/nn/modules/conv.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/nn/modules/conv.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.nn.modules.conv.Conv - -

- -## ::: ultralytics.nn.modules.conv.Conv2 - -

- -## ::: ultralytics.nn.modules.conv.LightConv - -

- -## ::: ultralytics.nn.modules.conv.DWConv - -

- -## ::: ultralytics.nn.modules.conv.DWConvTranspose2d - -

- -## ::: ultralytics.nn.modules.conv.ConvTranspose - -

- -## ::: ultralytics.nn.modules.conv.Focus - -

- -## ::: ultralytics.nn.modules.conv.GhostConv - -

- -## ::: ultralytics.nn.modules.conv.RepConv - -

- -## ::: ultralytics.nn.modules.conv.ChannelAttention - -

- -## ::: ultralytics.nn.modules.conv.SpatialAttention - -

- -## ::: ultralytics.nn.modules.conv.CBAM - -

- -## ::: ultralytics.nn.modules.conv.Concat - -

- -## ::: ultralytics.nn.modules.conv.autopad - -

diff --git a/ultralytics-main/docs/en/reference/nn/modules/head.md b/ultralytics-main/docs/en/reference/nn/modules/head.md deleted file mode 100644 index 6dc3e44..0000000 --- a/ultralytics-main/docs/en/reference/nn/modules/head.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -description: Explore docs covering Ultralytics YOLO detection, pose & RTDETRDecoder. Comprehensive guides to help you understand Ultralytics nn modules. -keywords: Ultralytics, YOLO, Detection, Pose, RTDETRDecoder, nn modules, guides ---- - -# Reference for `ultralytics/nn/modules/head.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/nn/modules/head.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/nn/modules/head.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/nn/modules/head.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.nn.modules.head.Detect - -

- -## ::: ultralytics.nn.modules.head.Segment - -

- -## ::: ultralytics.nn.modules.head.OBB - -

- -## ::: ultralytics.nn.modules.head.Pose - -

- -## ::: ultralytics.nn.modules.head.Classify - -

- -## ::: ultralytics.nn.modules.head.WorldDetect - -

- -## ::: ultralytics.nn.modules.head.RTDETRDecoder - -

diff --git a/ultralytics-main/docs/en/reference/nn/modules/transformer.md b/ultralytics-main/docs/en/reference/nn/modules/transformer.md deleted file mode 100644 index 91904be..0000000 --- a/ultralytics-main/docs/en/reference/nn/modules/transformer.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -description: Learn about Ultralytics transformer encoder, layer, MLP block, LayerNorm2d and the deformable transformer decoder layer. Expand your understanding of these crucial AI modules. -keywords: Ultralytics, Ultralytics documentation, TransformerEncoderLayer, TransformerLayer, MLPBlock, LayerNorm2d, DeformableTransformerDecoderLayer ---- - -# Reference for `ultralytics/nn/modules/transformer.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/nn/modules/transformer.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/nn/modules/transformer.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/nn/modules/transformer.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.nn.modules.transformer.TransformerEncoderLayer - -

- -## ::: ultralytics.nn.modules.transformer.AIFI - -

- -## ::: ultralytics.nn.modules.transformer.TransformerLayer - -

- -## ::: ultralytics.nn.modules.transformer.TransformerBlock - -

- -## ::: ultralytics.nn.modules.transformer.MLPBlock - -

- -## ::: ultralytics.nn.modules.transformer.MLP - -

- -## ::: ultralytics.nn.modules.transformer.LayerNorm2d - -

- -## ::: ultralytics.nn.modules.transformer.MSDeformAttn - -

- -## ::: ultralytics.nn.modules.transformer.DeformableTransformerDecoderLayer - -

- -## ::: ultralytics.nn.modules.transformer.DeformableTransformerDecoder - -

diff --git a/ultralytics-main/docs/en/reference/nn/modules/utils.md b/ultralytics-main/docs/en/reference/nn/modules/utils.md deleted file mode 100644 index 22b813e..0000000 --- a/ultralytics-main/docs/en/reference/nn/modules/utils.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -description: Explore Ultralytics neural network utils, such as bias_init_with_prob, inverse_sigmoid and multi_scale_deformable_attn_pytorch functions. -keywords: Ultralytics, neural network, nn.modules.utils, bias_init_with_prob, inverse_sigmoid, multi_scale_deformable_attn_pytorch ---- - -# Reference for `ultralytics/nn/modules/utils.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/nn/modules/utils.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/nn/modules/utils.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/nn/modules/utils.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.nn.modules.utils._get_clones - -

- -## ::: ultralytics.nn.modules.utils.bias_init_with_prob - -

- -## ::: ultralytics.nn.modules.utils.linear_init - -

- -## ::: ultralytics.nn.modules.utils.inverse_sigmoid - -

- -## ::: ultralytics.nn.modules.utils.multi_scale_deformable_attn_pytorch - -

diff --git a/ultralytics-main/docs/en/reference/nn/tasks.md b/ultralytics-main/docs/en/reference/nn/tasks.md deleted file mode 100644 index 66d2e0e..0000000 --- a/ultralytics-main/docs/en/reference/nn/tasks.md +++ /dev/null @@ -1,80 +0,0 @@ ---- -description: Dive into the intricacies of YOLO tasks.py. Learn about DetectionModel, PoseModel and more for powerful AI development. -keywords: Ultralytics, YOLO, nn tasks, DetectionModel, PoseModel, RTDETRDetectionModel, model weights, parse model, AI development ---- - -# Reference for `ultralytics/nn/tasks.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/nn/tasks.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/nn/tasks.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/nn/tasks.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.nn.tasks.BaseModel - -

- -## ::: ultralytics.nn.tasks.DetectionModel - -

- -## ::: ultralytics.nn.tasks.OBBModel - -

- -## ::: ultralytics.nn.tasks.SegmentationModel - -

- -## ::: ultralytics.nn.tasks.PoseModel - -

- -## ::: ultralytics.nn.tasks.ClassificationModel - -

- -## ::: ultralytics.nn.tasks.RTDETRDetectionModel - -

- -## ::: ultralytics.nn.tasks.WorldModel - -

- -## ::: ultralytics.nn.tasks.Ensemble - -

- -## ::: ultralytics.nn.tasks.temporary_modules - -

- -## ::: ultralytics.nn.tasks.torch_safe_load - -

- -## ::: ultralytics.nn.tasks.attempt_load_weights - -

- -## ::: ultralytics.nn.tasks.attempt_load_one_weight - -

- -## ::: ultralytics.nn.tasks.parse_model - -

- -## ::: ultralytics.nn.tasks.yaml_model_load - -

- -## ::: ultralytics.nn.tasks.guess_model_scale - -

- -## ::: ultralytics.nn.tasks.guess_model_task - -

diff --git a/ultralytics-main/docs/en/reference/solutions/ai_gym.md b/ultralytics-main/docs/en/reference/solutions/ai_gym.md deleted file mode 100644 index eb3e634..0000000 --- a/ultralytics-main/docs/en/reference/solutions/ai_gym.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Explore Ultralytics YOLO's advanced AI Gym feature for real-time pose estimation and gym exercise tracking using cutting-edge machine learning technology. -keywords: Ultralytics, YOLO, AI Gym, pose estimation, real-time tracking, machine learning, exercise counting, AI fitness, computer vision, gym workout analysis, YOLOv8, artificial intelligence, fitness technology ---- - -# Reference for `ultralytics/solutions/ai_gym.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/solutions/ai_gym.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/solutions/ai_gym.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/solutions/ai_gym.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.solutions.ai_gym.AIGym - -

diff --git a/ultralytics-main/docs/en/reference/solutions/distance_calculation.md b/ultralytics-main/docs/en/reference/solutions/distance_calculation.md deleted file mode 100644 index 4361885..0000000 --- a/ultralytics-main/docs/en/reference/solutions/distance_calculation.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Explore Ultralytics YOLO's distance calculation feature designed for advance analytics, providing an immediate, impactful way to interpret computer vision data. -keywords: Ultralytics, YOLO, distance calculation, object tracking, data visualization, real-time tracking, machine learning, object counting, computer vision, vehicle analytics, YOLOv8, artificial intelligence ---- - -# Reference for `ultralytics/solutions/distance_calculation.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/solutions/distance_calculation.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/solutions/distance_calculation.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/solutions/distance_calculation.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.solutions.distance_calculation.DistanceCalculation - -

diff --git a/ultralytics-main/docs/en/reference/solutions/heatmap.md b/ultralytics-main/docs/en/reference/solutions/heatmap.md deleted file mode 100644 index 133125c..0000000 --- a/ultralytics-main/docs/en/reference/solutions/heatmap.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Explore Ultralytics YOLO's advanced Heatmaps feature designed to highlight areas of interest, providing an immediate, impactful way to interpret spatial information. -keywords: Ultralytics, YOLO, heatmaps, object tracking, data visualization, real-time tracking, machine learning, object counting, computer vision, retail analytics, YOLOv8, artificial intelligence ---- - -# Reference for `ultralytics/solutions/heatmap.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/solutions/heatmap.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/solutions/heatmap.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/solutions/heatmap.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.solutions.heatmap.Heatmap - -

diff --git a/ultralytics-main/docs/en/reference/solutions/object_counter.md b/ultralytics-main/docs/en/reference/solutions/object_counter.md deleted file mode 100644 index 6cd3e00..0000000 --- a/ultralytics-main/docs/en/reference/solutions/object_counter.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Transform object tracking with Ultralytics YOLO Object Counter featuring cutting-edge technology for precise real-time counting in video streams. -keywords: Ultralytics YOLO, object tracking software, real-time counting solutions, video stream analysis, YOLOv8 object detection, AI surveillance, smart counting technology, computer vision, AI-powered tracking, object counting accuracy, video analytics tools, automated monitoring. ---- - -# Reference for `ultralytics/solutions/object_counter.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/solutions/object_counter.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/solutions/object_counter.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/solutions/object_counter.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.solutions.object_counter.ObjectCounter - -

diff --git a/ultralytics-main/docs/en/reference/solutions/speed_estimation.md b/ultralytics-main/docs/en/reference/solutions/speed_estimation.md deleted file mode 100644 index 93cc87e..0000000 --- a/ultralytics-main/docs/en/reference/solutions/speed_estimation.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Transform speed estimation with Ultralytics YOLO speed estimation featuring cutting-edge technology for precise real-time counting in video streams. -keywords: Ultralytics YOLO, speed estimation software, real-time vehicle tracking solutions, video stream analysis, YOLOv8 object detection, smart counting technology, computer vision, AI-powered tracking, video analytics tools, automated monitoring. ---- - -# Reference for `ultralytics/solutions/speed_estimation.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/solutions/speed_estimation.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/solutions/speed_estimation.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/solutions/speed_estimation.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.solutions.speed_estimation.SpeedEstimator - -

diff --git a/ultralytics-main/docs/en/reference/trackers/basetrack.md b/ultralytics-main/docs/en/reference/trackers/basetrack.md deleted file mode 100644 index 97f5c4a..0000000 --- a/ultralytics-main/docs/en/reference/trackers/basetrack.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -description: Get familiar with TrackState in Ultralytics. Learn how it is used in the BaseTrack of the Ultralytics tracker for enhanced functionality. -keywords: Ultralytics, TrackState, BaseTrack, Ultralytics tracker, Ultralytics documentation ---- - -# Reference for `ultralytics/trackers/basetrack.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/trackers/basetrack.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/trackers/basetrack.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/trackers/basetrack.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.trackers.basetrack.TrackState - -

- -## ::: ultralytics.trackers.basetrack.BaseTrack - -

diff --git a/ultralytics-main/docs/en/reference/trackers/bot_sort.md b/ultralytics-main/docs/en/reference/trackers/bot_sort.md deleted file mode 100644 index 85dfeee..0000000 --- a/ultralytics-main/docs/en/reference/trackers/bot_sort.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -description: Master the use of Ultralytics BOTrack, a key component of the powerful Ultralytics tracking system. Learn to integrate and use BOTSORT in your projects. -keywords: Ultralytics, BOTSORT, BOTrack, tracking system, official documentation, machine learning, AI tracking ---- - -# Reference for `ultralytics/trackers/bot_sort.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/trackers/bot_sort.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/trackers/bot_sort.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/trackers/bot_sort.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.trackers.bot_sort.BOTrack - -

- -## ::: ultralytics.trackers.bot_sort.BOTSORT - -

diff --git a/ultralytics-main/docs/en/reference/trackers/byte_tracker.md b/ultralytics-main/docs/en/reference/trackers/byte_tracker.md deleted file mode 100644 index e240d44..0000000 --- a/ultralytics-main/docs/en/reference/trackers/byte_tracker.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -description: Step-in to explore in-depth the functionalities of Ultralytics BYTETracker under STrack. Gain advanced feature insights to streamline your operations. -keywords: STrack, Ultralytics, BYTETracker, documentation, Ultralytics tracker, object tracking, YOLO ---- - -# Reference for `ultralytics/trackers/byte_tracker.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/trackers/byte_tracker.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/trackers/byte_tracker.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/trackers/byte_tracker.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.trackers.byte_tracker.STrack - -

- -## ::: ultralytics.trackers.byte_tracker.BYTETracker - -

diff --git a/ultralytics-main/docs/en/reference/trackers/track.md b/ultralytics-main/docs/en/reference/trackers/track.md deleted file mode 100644 index 7f15130..0000000 --- a/ultralytics-main/docs/en/reference/trackers/track.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -description: Explore Ultralytics documentation on prediction function starters & register trackers. Understand our code & its applications better. -keywords: Ultralytics, YOLO, on predict start, register tracker, prediction functions, documentation ---- - -# Reference for `ultralytics/trackers/track.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/trackers/track.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/trackers/track.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/trackers/track.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.trackers.track.on_predict_start - -

- -## ::: ultralytics.trackers.track.on_predict_postprocess_end - -

- -## ::: ultralytics.trackers.track.register_tracker - -

diff --git a/ultralytics-main/docs/en/reference/trackers/utils/gmc.md b/ultralytics-main/docs/en/reference/trackers/utils/gmc.md deleted file mode 100644 index fa51e8e..0000000 --- a/ultralytics-main/docs/en/reference/trackers/utils/gmc.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Explore the Ultralytics GMC tool in our comprehensive documentation. Learn how it works, best practices, and implementation advice. -keywords: Ultralytics, GMC utility, Ultralytics documentation, Ultralytics tracker, machine learning tools ---- - -# Reference for `ultralytics/trackers/utils/gmc.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/trackers/utils/gmc.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/trackers/utils/gmc.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/trackers/utils/gmc.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.trackers.utils.gmc.GMC - -

diff --git a/ultralytics-main/docs/en/reference/trackers/utils/kalman_filter.md b/ultralytics-main/docs/en/reference/trackers/utils/kalman_filter.md deleted file mode 100644 index 11063ef..0000000 --- a/ultralytics-main/docs/en/reference/trackers/utils/kalman_filter.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -description: Explore KalmanFilterXYAH, a key component of Ultralytics trackers. Understand its utilities and learn to leverage it in your own projects. -keywords: Ultralytics, KalmanFilterXYAH, tracker, documentation, guide ---- - -# Reference for `ultralytics/trackers/utils/kalman_filter.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/trackers/utils/kalman_filter.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/trackers/utils/kalman_filter.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/trackers/utils/kalman_filter.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.trackers.utils.kalman_filter.KalmanFilterXYAH - -

- -## ::: ultralytics.trackers.utils.kalman_filter.KalmanFilterXYWH - -

diff --git a/ultralytics-main/docs/en/reference/trackers/utils/matching.md b/ultralytics-main/docs/en/reference/trackers/utils/matching.md deleted file mode 100644 index fb7d326..0000000 --- a/ultralytics-main/docs/en/reference/trackers/utils/matching.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -description: Explore in-depth guidance for using Ultralytics trackers utils matching, including merge_matches, linear_assignment, iou_distance, embedding_distance, fuse_motion, and fuse_score. -keywords: Ultralytics, Trackers Utils, Matching, merge_matches, linear_assignment, iou_distance, embedding_distance, fuse_motion, fuse_score, documentation ---- - -# Reference for `ultralytics/trackers/utils/matching.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/trackers/utils/matching.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/trackers/utils/matching.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/trackers/utils/matching.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.trackers.utils.matching.linear_assignment - -

- -## ::: ultralytics.trackers.utils.matching.iou_distance - -

- -## ::: ultralytics.trackers.utils.matching.embedding_distance - -

- -## ::: ultralytics.trackers.utils.matching.fuse_score - -

diff --git a/ultralytics-main/docs/en/reference/utils/__init__.md b/ultralytics-main/docs/en/reference/utils/__init__.md deleted file mode 100644 index fc4c9a7..0000000 --- a/ultralytics-main/docs/en/reference/utils/__init__.md +++ /dev/null @@ -1,160 +0,0 @@ ---- -description: Explore the Ultralytics Utils package, with handy functions like colorstr, yaml_save, set_logging & more, designed to enhance your coding experience. -keywords: Ultralytics, Utils, utilitarian functions, colorstr, yaml_save, set_logging, is_kaggle, is_docker, clean_url ---- - -# Reference for `ultralytics/utils/__init__.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/__init__.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/__init__.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/__init__.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.TQDM - -

- -## ::: ultralytics.utils.SimpleClass - -

- -## ::: ultralytics.utils.IterableSimpleNamespace - -

- -## ::: ultralytics.utils.ThreadingLocked - -

- -## ::: ultralytics.utils.TryExcept - -

- -## ::: ultralytics.utils.Retry - -

- -## ::: ultralytics.utils.SettingsManager - -

- -## ::: ultralytics.utils.plt_settings - -

- -## ::: ultralytics.utils.set_logging - -

- -## ::: ultralytics.utils.emojis - -

- -## ::: ultralytics.utils.yaml_save - -

- -## ::: ultralytics.utils.yaml_load - -

- -## ::: ultralytics.utils.yaml_print - -

- -## ::: ultralytics.utils.is_ubuntu - -

- -## ::: ultralytics.utils.is_colab - -

- -## ::: ultralytics.utils.is_kaggle - -

- -## ::: ultralytics.utils.is_jupyter - -

- -## ::: ultralytics.utils.is_docker - -

- -## ::: ultralytics.utils.is_online - -

- -## ::: ultralytics.utils.is_pip_package - -

- -## ::: ultralytics.utils.is_dir_writeable - -

- -## ::: ultralytics.utils.is_pytest_running - -

- -## ::: ultralytics.utils.is_github_action_running - -

- -## ::: ultralytics.utils.is_git_dir - -

- -## ::: ultralytics.utils.get_git_dir - -

- -## ::: ultralytics.utils.get_git_origin_url - -

- -## ::: ultralytics.utils.get_git_branch - -

- -## ::: ultralytics.utils.get_default_args - -

- -## ::: ultralytics.utils.get_ubuntu_version - -

- -## ::: ultralytics.utils.get_user_config_dir - -

- -## ::: ultralytics.utils.colorstr - -

- -## ::: ultralytics.utils.remove_colorstr - -

- -## ::: ultralytics.utils.threaded - -

- -## ::: ultralytics.utils.set_sentry - -

- -## ::: ultralytics.utils.deprecation_warn - -

- -## ::: ultralytics.utils.clean_url - -

- -## ::: ultralytics.utils.url2file - -

diff --git a/ultralytics-main/docs/en/reference/utils/autobatch.md b/ultralytics-main/docs/en/reference/utils/autobatch.md deleted file mode 100644 index 4dc132b..0000000 --- a/ultralytics-main/docs/en/reference/utils/autobatch.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -description: Explore Ultralytics documentation for check_train_batch_size utility in the autobatch module. Understand how it could improve your machine learning process. -keywords: Ultralytics, check_train_batch_size, autobatch, utility, machine learning, documentation ---- - -# Reference for `ultralytics/utils/autobatch.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/autobatch.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/autobatch.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/autobatch.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.autobatch.check_train_batch_size - -

- -## ::: ultralytics.utils.autobatch.autobatch - -

diff --git a/ultralytics-main/docs/en/reference/utils/benchmarks.md b/ultralytics-main/docs/en/reference/utils/benchmarks.md deleted file mode 100644 index 76d4885..0000000 --- a/ultralytics-main/docs/en/reference/utils/benchmarks.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -description: Discover how to profile your models using Ultralytics utilities. Enhance performance, optimize your benchmarks, and learn best practices. -keywords: Ultralytics, ProfileModels, benchmarks, model profiling, performance optimization ---- - -# Reference for `ultralytics/utils/benchmarks.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/benchmarks.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/benchmarks.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/benchmarks.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.benchmarks.ProfileModels - -

- -## ::: ultralytics.utils.benchmarks.benchmark - -

diff --git a/ultralytics-main/docs/en/reference/utils/callbacks/base.md b/ultralytics-main/docs/en/reference/utils/callbacks/base.md deleted file mode 100644 index 609e34b..0000000 --- a/ultralytics-main/docs/en/reference/utils/callbacks/base.md +++ /dev/null @@ -1,120 +0,0 @@ ---- -description: Explore how to use the on-train, on-validation, on-pretrain, and on-predict callbacks in Ultralytics. Learn to update params, save models, and add integration callbacks. -keywords: Ultralytics, Callbacks, On-train, On-validation, On-pretrain, On-predict, Parameters update, Model saving, Integration callbacks ---- - -# Reference for `ultralytics/utils/callbacks/base.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/base.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/base.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/callbacks/base.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.callbacks.base.on_pretrain_routine_start - -

- -## ::: ultralytics.utils.callbacks.base.on_pretrain_routine_end - -

- -## ::: ultralytics.utils.callbacks.base.on_train_start - -

- -## ::: ultralytics.utils.callbacks.base.on_train_epoch_start - -

- -## ::: ultralytics.utils.callbacks.base.on_train_batch_start - -

- -## ::: ultralytics.utils.callbacks.base.optimizer_step - -

- -## ::: ultralytics.utils.callbacks.base.on_before_zero_grad - -

- -## ::: ultralytics.utils.callbacks.base.on_train_batch_end - -

- -## ::: ultralytics.utils.callbacks.base.on_train_epoch_end - -

- -## ::: ultralytics.utils.callbacks.base.on_fit_epoch_end - -

- -## ::: ultralytics.utils.callbacks.base.on_model_save - -

- -## ::: ultralytics.utils.callbacks.base.on_train_end - -

- -## ::: ultralytics.utils.callbacks.base.on_params_update - -

- -## ::: ultralytics.utils.callbacks.base.teardown - -

- -## ::: ultralytics.utils.callbacks.base.on_val_start - -

- -## ::: ultralytics.utils.callbacks.base.on_val_batch_start - -

- -## ::: ultralytics.utils.callbacks.base.on_val_batch_end - -

- -## ::: ultralytics.utils.callbacks.base.on_val_end - -

- -## ::: ultralytics.utils.callbacks.base.on_predict_start - -

- -## ::: ultralytics.utils.callbacks.base.on_predict_batch_start - -

- -## ::: ultralytics.utils.callbacks.base.on_predict_batch_end - -

- -## ::: ultralytics.utils.callbacks.base.on_predict_postprocess_end - -

- -## ::: ultralytics.utils.callbacks.base.on_predict_end - -

- -## ::: ultralytics.utils.callbacks.base.on_export_start - -

- -## ::: ultralytics.utils.callbacks.base.on_export_end - -

- -## ::: ultralytics.utils.callbacks.base.get_default_callbacks - -

- -## ::: ultralytics.utils.callbacks.base.add_integration_callbacks - -

diff --git a/ultralytics-main/docs/en/reference/utils/callbacks/clearml.md b/ultralytics-main/docs/en/reference/utils/callbacks/clearml.md deleted file mode 100644 index a05b08c..0000000 --- a/ultralytics-main/docs/en/reference/utils/callbacks/clearml.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -description: Uncover the specifics of Ultralytics ClearML callbacks, from pretrain routine start to training end. Boost your ML model performance. -keywords: Ultralytics, clearML, callbacks, pretrain routine start, validation end, train epoch end, training end ---- - -# Reference for `ultralytics/utils/callbacks/clearml.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/clearml.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/clearml.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/callbacks/clearml.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.callbacks.clearml._log_debug_samples - -

- -## ::: ultralytics.utils.callbacks.clearml._log_plot - -

- -## ::: ultralytics.utils.callbacks.clearml.on_pretrain_routine_start - -

- -## ::: ultralytics.utils.callbacks.clearml.on_train_epoch_end - -

- -## ::: ultralytics.utils.callbacks.clearml.on_fit_epoch_end - -

- -## ::: ultralytics.utils.callbacks.clearml.on_val_end - -

- -## ::: ultralytics.utils.callbacks.clearml.on_train_end - -

diff --git a/ultralytics-main/docs/en/reference/utils/callbacks/comet.md b/ultralytics-main/docs/en/reference/utils/callbacks/comet.md deleted file mode 100644 index 2ba62fa..0000000 --- a/ultralytics-main/docs/en/reference/utils/callbacks/comet.md +++ /dev/null @@ -1,108 +0,0 @@ ---- -description: Explore comprehensive documentation for utilising Comet Callbacks in Ultralytics. Learn to optimise training, logging, and experiment workflows. -keywords: Ultralytics, Comet Callbacks, Training optimisation, Logging, Experiment Workflows ---- - -# Reference for `ultralytics/utils/callbacks/comet.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/comet.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/comet.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/callbacks/comet.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.callbacks.comet._get_comet_mode - -

- -## ::: ultralytics.utils.callbacks.comet._get_comet_model_name - -

- -## ::: ultralytics.utils.callbacks.comet._get_eval_batch_logging_interval - -

- -## ::: ultralytics.utils.callbacks.comet._get_max_image_predictions_to_log - -

- -## ::: ultralytics.utils.callbacks.comet._scale_confidence_score - -

- -## ::: ultralytics.utils.callbacks.comet._should_log_confusion_matrix - -

- -## ::: ultralytics.utils.callbacks.comet._should_log_image_predictions - -

- -## ::: ultralytics.utils.callbacks.comet._get_experiment_type - -

- -## ::: ultralytics.utils.callbacks.comet._create_experiment - -

- -## ::: ultralytics.utils.callbacks.comet._fetch_trainer_metadata - -

- -## ::: ultralytics.utils.callbacks.comet._scale_bounding_box_to_original_image_shape - -

- -## ::: ultralytics.utils.callbacks.comet._format_ground_truth_annotations_for_detection - -

- -## ::: ultralytics.utils.callbacks.comet._format_prediction_annotations_for_detection - -

- -## ::: ultralytics.utils.callbacks.comet._fetch_annotations - -

- -## ::: ultralytics.utils.callbacks.comet._create_prediction_metadata_map - -

- -## ::: ultralytics.utils.callbacks.comet._log_confusion_matrix - -

- -## ::: ultralytics.utils.callbacks.comet._log_images - -

- -## ::: ultralytics.utils.callbacks.comet._log_image_predictions - -

- -## ::: ultralytics.utils.callbacks.comet._log_plots - -

- -## ::: ultralytics.utils.callbacks.comet._log_model - -

- -## ::: ultralytics.utils.callbacks.comet.on_pretrain_routine_start - -

- -## ::: ultralytics.utils.callbacks.comet.on_train_epoch_end - -

- -## ::: ultralytics.utils.callbacks.comet.on_fit_epoch_end - -

- -## ::: ultralytics.utils.callbacks.comet.on_train_end - -

diff --git a/ultralytics-main/docs/en/reference/utils/callbacks/dvc.md b/ultralytics-main/docs/en/reference/utils/callbacks/dvc.md deleted file mode 100644 index a325989..0000000 --- a/ultralytics-main/docs/en/reference/utils/callbacks/dvc.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -description: Browse through Ultralytics YOLO docs to learn about important logging and callback functions used in training and pretraining models. -keywords: Ultralytics, YOLO, callbacks, logger, training, pretraining, machine learning, models ---- - -# Reference for `ultralytics/utils/callbacks/dvc.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/dvc.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/dvc.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/callbacks/dvc.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.callbacks.dvc._log_images - -

- -## ::: ultralytics.utils.callbacks.dvc._log_plots - -

- -## ::: ultralytics.utils.callbacks.dvc._log_confusion_matrix - -

- -## ::: ultralytics.utils.callbacks.dvc.on_pretrain_routine_start - -

- -## ::: ultralytics.utils.callbacks.dvc.on_pretrain_routine_end - -

- -## ::: ultralytics.utils.callbacks.dvc.on_train_start - -

- -## ::: ultralytics.utils.callbacks.dvc.on_train_epoch_start - -

- -## ::: ultralytics.utils.callbacks.dvc.on_fit_epoch_end - -

- -## ::: ultralytics.utils.callbacks.dvc.on_train_end - -

diff --git a/ultralytics-main/docs/en/reference/utils/callbacks/hub.md b/ultralytics-main/docs/en/reference/utils/callbacks/hub.md deleted file mode 100644 index 3735e90..0000000 --- a/ultralytics-main/docs/en/reference/utils/callbacks/hub.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -description: Explore the detailed information on key Ultralytics callbacks such as on_pretrain_routine_end, on_model_save, on_train_start, and on_predict_start. -keywords: Ultralytics, callbacks, on_pretrain_routine_end, on_model_save, on_train_start, on_predict_start, hub, training ---- - -# Reference for `ultralytics/utils/callbacks/hub.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/hub.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/hub.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/callbacks/hub.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.callbacks.hub.on_pretrain_routine_end - -

- -## ::: ultralytics.utils.callbacks.hub.on_fit_epoch_end - -

- -## ::: ultralytics.utils.callbacks.hub.on_model_save - -

- -## ::: ultralytics.utils.callbacks.hub.on_train_end - -

- -## ::: ultralytics.utils.callbacks.hub.on_train_start - -

- -## ::: ultralytics.utils.callbacks.hub.on_val_start - -

- -## ::: ultralytics.utils.callbacks.hub.on_predict_start - -

- -## ::: ultralytics.utils.callbacks.hub.on_export_start - -

diff --git a/ultralytics-main/docs/en/reference/utils/callbacks/mlflow.md b/ultralytics-main/docs/en/reference/utils/callbacks/mlflow.md deleted file mode 100644 index e3fab6c..0000000 --- a/ultralytics-main/docs/en/reference/utils/callbacks/mlflow.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -description: Understand routines at the end of pre-training and training in Ultralytics. Elevate your MLflow callbacks expertise. -keywords: Ultralytics, MLflow, Callbacks, on_pretrain_routine_end, on_train_end, Machine Learning, Training ---- - -# Reference for `ultralytics/utils/callbacks/mlflow.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/mlflow.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/mlflow.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/callbacks/mlflow.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.callbacks.mlflow.on_pretrain_routine_end - -

- -## ::: ultralytics.utils.callbacks.mlflow.on_train_epoch_end - -

- -## ::: ultralytics.utils.callbacks.mlflow.on_fit_epoch_end - -

- -## ::: ultralytics.utils.callbacks.mlflow.on_train_end - -

diff --git a/ultralytics-main/docs/en/reference/utils/callbacks/neptune.md b/ultralytics-main/docs/en/reference/utils/callbacks/neptune.md deleted file mode 100644 index 82906ac..0000000 --- a/ultralytics-main/docs/en/reference/utils/callbacks/neptune.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -description: Explore exhaustive details about Ultralytics callbacks in Neptune, with specifics about scalar logging, routine start, and more. -keywords: Ultralytics, Neptune callbacks, on_train_epoch_end, on_val_end, _log_plot, _log_images, on_pretrain_routine_start, on_fit_epoch_end, on_train_end ---- - -# Reference for `ultralytics/utils/callbacks/neptune.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/neptune.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/neptune.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/callbacks/neptune.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.callbacks.neptune._log_scalars - -

- -## ::: ultralytics.utils.callbacks.neptune._log_images - -

- -## ::: ultralytics.utils.callbacks.neptune._log_plot - -

- -## ::: ultralytics.utils.callbacks.neptune.on_pretrain_routine_start - -

- -## ::: ultralytics.utils.callbacks.neptune.on_train_epoch_end - -

- -## ::: ultralytics.utils.callbacks.neptune.on_fit_epoch_end - -

- -## ::: ultralytics.utils.callbacks.neptune.on_val_end - -

- -## ::: ultralytics.utils.callbacks.neptune.on_train_end - -

diff --git a/ultralytics-main/docs/en/reference/utils/callbacks/raytune.md b/ultralytics-main/docs/en/reference/utils/callbacks/raytune.md deleted file mode 100644 index 2ed6191..0000000 --- a/ultralytics-main/docs/en/reference/utils/callbacks/raytune.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Discover the functionality of the on_fit_epoch_end callback in the Ultralytics YOLO framework. Learn how to end an epoch in your deep learning projects. -keywords: Ultralytics, YOLO, on_fit_epoch_end, callbacks, documentation, deep learning, YOLO framework ---- - -# Reference for `ultralytics/utils/callbacks/raytune.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/raytune.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/raytune.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/callbacks/raytune.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.callbacks.raytune.on_fit_epoch_end - -

diff --git a/ultralytics-main/docs/en/reference/utils/callbacks/tensorboard.md b/ultralytics-main/docs/en/reference/utils/callbacks/tensorboard.md deleted file mode 100644 index 74fb3b1..0000000 --- a/ultralytics-main/docs/en/reference/utils/callbacks/tensorboard.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -description: Explore Ultralytics YOLO Docs for a deep understanding of log_scalars, on_batch_end & other callback utilities embedded in the tensorboard module. -keywords: Ultralytics, YOLO, documentation, callback utilities, log_scalars, on_batch_end, tensorboard ---- - -# Reference for `ultralytics/utils/callbacks/tensorboard.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/tensorboard.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/tensorboard.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/callbacks/tensorboard.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.callbacks.tensorboard._log_scalars - -

- -## ::: ultralytics.utils.callbacks.tensorboard._log_tensorboard_graph - -

- -## ::: ultralytics.utils.callbacks.tensorboard.on_pretrain_routine_start - -

- -## ::: ultralytics.utils.callbacks.tensorboard.on_train_start - -

- -## ::: ultralytics.utils.callbacks.tensorboard.on_train_epoch_end - -

- -## ::: ultralytics.utils.callbacks.tensorboard.on_fit_epoch_end - -

diff --git a/ultralytics-main/docs/en/reference/utils/callbacks/wb.md b/ultralytics-main/docs/en/reference/utils/callbacks/wb.md deleted file mode 100644 index 59a2088..0000000 --- a/ultralytics-main/docs/en/reference/utils/callbacks/wb.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -description: Deep dive into Ultralytics callbacks. Learn how to use the _log_plots, on_fit_epoch_end, and on_train_end functions effectively. -keywords: Ultralytics, callbacks, _log_plots, on_fit_epoch_end, on_train_end ---- - -# Reference for `ultralytics/utils/callbacks/wb.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/wb.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/wb.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/callbacks/wb.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.callbacks.wb._custom_table - -

- -## ::: ultralytics.utils.callbacks.wb._plot_curve - -

- -## ::: ultralytics.utils.callbacks.wb._log_plots - -

- -## ::: ultralytics.utils.callbacks.wb.on_pretrain_routine_start - -

- -## ::: ultralytics.utils.callbacks.wb.on_fit_epoch_end - -

- -## ::: ultralytics.utils.callbacks.wb.on_train_epoch_end - -

- -## ::: ultralytics.utils.callbacks.wb.on_train_end - -

diff --git a/ultralytics-main/docs/en/reference/utils/checks.md b/ultralytics-main/docs/en/reference/utils/checks.md deleted file mode 100644 index f2e4ed9..0000000 --- a/ultralytics-main/docs/en/reference/utils/checks.md +++ /dev/null @@ -1,112 +0,0 @@ ---- -description: Learn about our routine checks that safeguard Ultralytics operations including ASCII, font, YOLO file, YAML, Python and torchvision checks. -keywords: Ultralytics, utility checks, ASCII, check_version, pip_update, check_python, check_torchvision, check_yaml, YOLO filename ---- - -# Reference for `ultralytics/utils/checks.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/checks.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/checks.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/checks.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.checks.parse_requirements - -

- -## ::: ultralytics.utils.checks.parse_version - -

- -## ::: ultralytics.utils.checks.is_ascii - -

- -## ::: ultralytics.utils.checks.check_imgsz - -

- -## ::: ultralytics.utils.checks.check_version - -

- -## ::: ultralytics.utils.checks.check_latest_pypi_version - -

- -## ::: ultralytics.utils.checks.check_pip_update_available - -

- -## ::: ultralytics.utils.checks.check_font - -

- -## ::: ultralytics.utils.checks.check_python - -

- -## ::: ultralytics.utils.checks.check_requirements - -

- -## ::: ultralytics.utils.checks.check_torchvision - -

- -## ::: ultralytics.utils.checks.check_suffix - -

- -## ::: ultralytics.utils.checks.check_yolov5u_filename - -

- -## ::: ultralytics.utils.checks.check_model_file_from_stem - -

- -## ::: ultralytics.utils.checks.check_file - -

- -## ::: ultralytics.utils.checks.check_yaml - -

- -## ::: ultralytics.utils.checks.check_is_path_safe - -

- -## ::: ultralytics.utils.checks.check_imshow - -

- -## ::: ultralytics.utils.checks.check_yolo - -

- -## ::: ultralytics.utils.checks.collect_system_info - -

- -## ::: ultralytics.utils.checks.check_amp - -

- -## ::: ultralytics.utils.checks.git_describe - -

- -## ::: ultralytics.utils.checks.print_args - -

- -## ::: ultralytics.utils.checks.cuda_device_count - -

- -## ::: ultralytics.utils.checks.cuda_is_available - -

diff --git a/ultralytics-main/docs/en/reference/utils/dist.md b/ultralytics-main/docs/en/reference/utils/dist.md deleted file mode 100644 index 1ca18e3..0000000 --- a/ultralytics-main/docs/en/reference/utils/dist.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -description: Discover the role of dist.find_free_network_port & dist.generate_ddp_command in Ultralytics DDP utilities. Use our guide for efficient deployment. -keywords: Ultralytics, DDP, DDP utility functions, Distributed Data Processing, find free network port, generate DDP command ---- - -# Reference for `ultralytics/utils/dist.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/dist.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/dist.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/dist.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.dist.find_free_network_port - -

- -## ::: ultralytics.utils.dist.generate_ddp_file - -

- -## ::: ultralytics.utils.dist.generate_ddp_command - -

- -## ::: ultralytics.utils.dist.ddp_cleanup - -

diff --git a/ultralytics-main/docs/en/reference/utils/downloads.md b/ultralytics-main/docs/en/reference/utils/downloads.md deleted file mode 100644 index aeef4c9..0000000 --- a/ultralytics-main/docs/en/reference/utils/downloads.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -description: Learn about the download utilities in Ultralytics YOLO, featuring functions like is_url, check_disk_space, get_github_assets, and download. -keywords: Ultralytics, YOLO, download utilities, is_url, check_disk_space, get_github_assets, download, documentation ---- - -# Reference for `ultralytics/utils/downloads.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/downloads.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/downloads.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/downloads.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.downloads.is_url - -

- -## ::: ultralytics.utils.downloads.delete_dsstore - -

- -## ::: ultralytics.utils.downloads.zip_directory - -

- -## ::: ultralytics.utils.downloads.unzip_file - -

- -## ::: ultralytics.utils.downloads.check_disk_space - -

- -## ::: ultralytics.utils.downloads.get_google_drive_file_info - -

- -## ::: ultralytics.utils.downloads.safe_download - -

- -## ::: ultralytics.utils.downloads.get_github_assets - -

- -## ::: ultralytics.utils.downloads.attempt_download_asset - -

- -## ::: ultralytics.utils.downloads.download - -

diff --git a/ultralytics-main/docs/en/reference/utils/errors.md b/ultralytics-main/docs/en/reference/utils/errors.md deleted file mode 100644 index 816328a..0000000 --- a/ultralytics-main/docs/en/reference/utils/errors.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Learn about the HUBModelError in Ultralytics. Enhance your understanding, troubleshoot errors and optimize your machine learning projects. -keywords: Ultralytics, HUBModelError, Machine Learning, Error troubleshooting, Ultralytics documentation ---- - -# Reference for `ultralytics/utils/errors.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/errors.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/errors.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/errors.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.errors.HUBModelError - -

diff --git a/ultralytics-main/docs/en/reference/utils/files.md b/ultralytics-main/docs/en/reference/utils/files.md deleted file mode 100644 index e9bd16d..0000000 --- a/ultralytics-main/docs/en/reference/utils/files.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -description: Discover how to use Ultralytics utility functions for file-related operations including incrementing paths, finding file age, checking file size and creating directories. -keywords: Ultralytics, utility functions, file operations, working directory, file age, file size, create directories ---- - -# Reference for `ultralytics/utils/files.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/files.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/files.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/files.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.files.WorkingDirectory - -

- -## ::: ultralytics.utils.files.spaces_in_path - -

- -## ::: ultralytics.utils.files.increment_path - -

- -## ::: ultralytics.utils.files.file_age - -

- -## ::: ultralytics.utils.files.file_date - -

- -## ::: ultralytics.utils.files.file_size - -

- -## ::: ultralytics.utils.files.get_latest_run - -

- -## ::: ultralytics.utils.files.update_models - -

diff --git a/ultralytics-main/docs/en/reference/utils/instance.md b/ultralytics-main/docs/en/reference/utils/instance.md deleted file mode 100644 index 6771cd8..0000000 --- a/ultralytics-main/docs/en/reference/utils/instance.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -description: Dive into Ultralytics detailed utility guide. Learn about Bboxes, _ntuple and more from Ultralytics utils.instance module. -keywords: Ultralytics, Bboxes, _ntuple, utility, ultralytics utils.instance ---- - -# Reference for `ultralytics/utils/instance.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/instance.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/instance.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/instance.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.instance.Bboxes - -

- -## ::: ultralytics.utils.instance.Instances - -

- -## ::: ultralytics.utils.instance._ntuple - -

diff --git a/ultralytics-main/docs/en/reference/utils/loss.md b/ultralytics-main/docs/en/reference/utils/loss.md deleted file mode 100644 index 94ae791..0000000 --- a/ultralytics-main/docs/en/reference/utils/loss.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -description: Explore Ultralytics' versatile loss functions - VarifocalLoss, BboxLoss, v8DetectionLoss, v8PoseLoss. Improve your accuracy on YOLO implementations. -keywords: Ultralytics, Loss functions, VarifocalLoss, BboxLoss, v8DetectionLoss, v8PoseLoss, YOLO, Ultralytics Documentation ---- - -# Reference for `ultralytics/utils/loss.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/loss.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/loss.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/loss.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.loss.VarifocalLoss - -

- -## ::: ultralytics.utils.loss.FocalLoss - -

- -## ::: ultralytics.utils.loss.BboxLoss - -

- -## ::: ultralytics.utils.loss.RotatedBboxLoss - -

- -## ::: ultralytics.utils.loss.KeypointLoss - -

- -## ::: ultralytics.utils.loss.v8DetectionLoss - -

- -## ::: ultralytics.utils.loss.v8SegmentationLoss - -

- -## ::: ultralytics.utils.loss.v8PoseLoss - -

- -## ::: ultralytics.utils.loss.v8ClassificationLoss - -

- -## ::: ultralytics.utils.loss.v8OBBLoss - -

diff --git a/ultralytics-main/docs/en/reference/utils/metrics.md b/ultralytics-main/docs/en/reference/utils/metrics.md deleted file mode 100644 index 21c8506..0000000 --- a/ultralytics-main/docs/en/reference/utils/metrics.md +++ /dev/null @@ -1,96 +0,0 @@ ---- -description: Explore Ultralytics YOLO metrics tools - from confusion matrix, detection metrics, pose metrics to box IoU. Learn how to compute and plot precision-recall curves. -keywords: Ultralytics, YOLO, YOLOv3, YOLOv4, metrics, confusion matrix, detection metrics, pose metrics, box IoU, mask IoU, plot precision-recall curves, compute average precision ---- - -# Reference for `ultralytics/utils/metrics.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/metrics.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/metrics.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/metrics.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.metrics.ConfusionMatrix - -

- -## ::: ultralytics.utils.metrics.Metric - -

- -## ::: ultralytics.utils.metrics.DetMetrics - -

- -## ::: ultralytics.utils.metrics.SegmentMetrics - -

- -## ::: ultralytics.utils.metrics.PoseMetrics - -

- -## ::: ultralytics.utils.metrics.ClassifyMetrics - -

- -## ::: ultralytics.utils.metrics.OBBMetrics - -

- -## ::: ultralytics.utils.metrics.bbox_ioa - -

- -## ::: ultralytics.utils.metrics.box_iou - -

- -## ::: ultralytics.utils.metrics.bbox_iou - -

- -## ::: ultralytics.utils.metrics.mask_iou - -

- -## ::: ultralytics.utils.metrics.kpt_iou - -

- -## ::: ultralytics.utils.metrics._get_covariance_matrix - -

- -## ::: ultralytics.utils.metrics.probiou - -

- -## ::: ultralytics.utils.metrics.batch_probiou - -

- -## ::: ultralytics.utils.metrics.smooth_BCE - -

- -## ::: ultralytics.utils.metrics.smooth - -

- -## ::: ultralytics.utils.metrics.plot_pr_curve - -

- -## ::: ultralytics.utils.metrics.plot_mc_curve - -

- -## ::: ultralytics.utils.metrics.compute_ap - -

- -## ::: ultralytics.utils.metrics.ap_per_class - -

diff --git a/ultralytics-main/docs/en/reference/utils/ops.md b/ultralytics-main/docs/en/reference/utils/ops.md deleted file mode 100644 index 4cd9d5f..0000000 --- a/ultralytics-main/docs/en/reference/utils/ops.md +++ /dev/null @@ -1,136 +0,0 @@ ---- -description: Explore detailed documentation for Ultralytics utility operations. Learn about methods like segment2box, make_divisible, clip_boxes, and many more. -keywords: Ultralytics YOLO, Utility Operations, segment2box, make_divisible, clip_boxes, scale_image, xywh2xyxy, xyxy2xywhn, xywh2ltwh, ltwh2xywh, segments2boxes, crop_mask, process_mask, scale_masks, masks2segments ---- - -# Reference for `ultralytics/utils/ops.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/ops.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/ops.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/ops.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.ops.Profile - -

- -## ::: ultralytics.utils.ops.segment2box - -

- -## ::: ultralytics.utils.ops.scale_boxes - -

- -## ::: ultralytics.utils.ops.make_divisible - -

- -## ::: ultralytics.utils.ops.nms_rotated - -

- -## ::: ultralytics.utils.ops.non_max_suppression - -

- -## ::: ultralytics.utils.ops.clip_boxes - -

- -## ::: ultralytics.utils.ops.clip_coords - -

- -## ::: ultralytics.utils.ops.scale_image - -

- -## ::: ultralytics.utils.ops.xyxy2xywh - -

- -## ::: ultralytics.utils.ops.xywh2xyxy - -

- -## ::: ultralytics.utils.ops.xywhn2xyxy - -

- -## ::: ultralytics.utils.ops.xyxy2xywhn - -

- -## ::: ultralytics.utils.ops.xywh2ltwh - -

- -## ::: ultralytics.utils.ops.xyxy2ltwh - -

- -## ::: ultralytics.utils.ops.ltwh2xywh - -

- -## ::: ultralytics.utils.ops.xyxyxyxy2xywhr - -

- -## ::: ultralytics.utils.ops.xywhr2xyxyxyxy - -

- -## ::: ultralytics.utils.ops.ltwh2xyxy - -

- -## ::: ultralytics.utils.ops.segments2boxes - -

- -## ::: ultralytics.utils.ops.resample_segments - -

- -## ::: ultralytics.utils.ops.crop_mask - -

- -## ::: ultralytics.utils.ops.process_mask_upsample - -

- -## ::: ultralytics.utils.ops.process_mask - -

- -## ::: ultralytics.utils.ops.process_mask_native - -

- -## ::: ultralytics.utils.ops.scale_masks - -

- -## ::: ultralytics.utils.ops.scale_coords - -

- -## ::: ultralytics.utils.ops.regularize_rboxes - -

- -## ::: ultralytics.utils.ops.masks2segments - -

- -## ::: ultralytics.utils.ops.convert_torch2numpy_batch - -

- -## ::: ultralytics.utils.ops.clean_str - -

diff --git a/ultralytics-main/docs/en/reference/utils/patches.md b/ultralytics-main/docs/en/reference/utils/patches.md deleted file mode 100644 index fdcf394..0000000 --- a/ultralytics-main/docs/en/reference/utils/patches.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -description: Learn about Ultralytics utils patches including imread, imshow and torch_save. Enhance your image processing skills. -keywords: Ultralytics, Utils, Patches, imread, imshow, torch_save, image processing ---- - -# Reference for `ultralytics/utils/patches.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/patches.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/patches.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/patches.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.patches.imread - -

- -## ::: ultralytics.utils.patches.imwrite - -

- -## ::: ultralytics.utils.patches.imshow - -

- -## ::: ultralytics.utils.patches.torch_save - -

diff --git a/ultralytics-main/docs/en/reference/utils/plotting.md b/ultralytics-main/docs/en/reference/utils/plotting.md deleted file mode 100644 index bf00d2f..0000000 --- a/ultralytics-main/docs/en/reference/utils/plotting.md +++ /dev/null @@ -1,56 +0,0 @@ ---- -description: Master advanced plotting utils from Ultralytics including color annotations, label and image plotting, and feature visualization. -keywords: Ultralytics, plotting, utils, color annotation, label plotting, image plotting, feature visualization ---- - -# Reference for `ultralytics/utils/plotting.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/plotting.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/plotting.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/plotting.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.plotting.Colors - -

- -## ::: ultralytics.utils.plotting.Annotator - -

- -## ::: ultralytics.utils.plotting.plot_labels - -

- -## ::: ultralytics.utils.plotting.save_one_box - -

- -## ::: ultralytics.utils.plotting.plot_images - -

- -## ::: ultralytics.utils.plotting.plot_results - -

- -## ::: ultralytics.utils.plotting.plt_color_scatter - -

- -## ::: ultralytics.utils.plotting.plot_tune_results - -

- -## ::: ultralytics.utils.plotting.output_to_target - -

- -## ::: ultralytics.utils.plotting.output_to_rotated_target - -

- -## ::: ultralytics.utils.plotting.feature_visualization - -

diff --git a/ultralytics-main/docs/en/reference/utils/tal.md b/ultralytics-main/docs/en/reference/utils/tal.md deleted file mode 100644 index 9f832aa..0000000 --- a/ultralytics-main/docs/en/reference/utils/tal.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -description: Explore Ultralytics utilities for optimized task assignment, bounding box creation, and distance calculation. Learn more about algorithm implementations. -keywords: Ultralytics, task aligned assigner, select highest overlaps, make anchors, dist2bbox, bbox2dist, utilities, algorithm ---- - -# Reference for `ultralytics/utils/tal.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/tal.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/tal.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/tal.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.tal.TaskAlignedAssigner - -

- -## ::: ultralytics.utils.tal.RotatedTaskAlignedAssigner - -

- -## ::: ultralytics.utils.tal.make_anchors - -

- -## ::: ultralytics.utils.tal.dist2bbox - -

- -## ::: ultralytics.utils.tal.bbox2dist - -

- -## ::: ultralytics.utils.tal.dist2rbox - -

diff --git a/ultralytics-main/docs/en/reference/utils/torch_utils.md b/ultralytics-main/docs/en/reference/utils/torch_utils.md deleted file mode 100644 index 5c88f29..0000000 --- a/ultralytics-main/docs/en/reference/utils/torch_utils.md +++ /dev/null @@ -1,120 +0,0 @@ ---- -description: Explore Ultralytics-tailored torch utility features like Model EMA, early stopping, smart inference, image scaling, get_flops, and many more. -keywords: Ultralytics, Torch Utils, Model EMA, Early Stopping, Smart Inference, Get CPU Info, Time Sync, Fuse Deconv and bn, Get num params, Get FLOPs, Scale img, Copy attr, Intersect dicts, De_parallel, Init seeds, Profile ---- - -# Reference for `ultralytics/utils/torch_utils.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/torch_utils.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/torch_utils.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/torch_utils.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.torch_utils.ModelEMA - -

- -## ::: ultralytics.utils.torch_utils.EarlyStopping - -

- -## ::: ultralytics.utils.torch_utils.torch_distributed_zero_first - -

- -## ::: ultralytics.utils.torch_utils.smart_inference_mode - -

- -## ::: ultralytics.utils.torch_utils.get_cpu_info - -

- -## ::: ultralytics.utils.torch_utils.select_device - -

- -## ::: ultralytics.utils.torch_utils.time_sync - -

- -## ::: ultralytics.utils.torch_utils.fuse_conv_and_bn - -

- -## ::: ultralytics.utils.torch_utils.fuse_deconv_and_bn - -

- -## ::: ultralytics.utils.torch_utils.model_info - -

- -## ::: ultralytics.utils.torch_utils.get_num_params - -

- -## ::: ultralytics.utils.torch_utils.get_num_gradients - -

- -## ::: ultralytics.utils.torch_utils.model_info_for_loggers - -

- -## ::: ultralytics.utils.torch_utils.get_flops - -

- -## ::: ultralytics.utils.torch_utils.get_flops_with_torch_profiler - -

- -## ::: ultralytics.utils.torch_utils.initialize_weights - -

- -## ::: ultralytics.utils.torch_utils.scale_img - -

- -## ::: ultralytics.utils.torch_utils.make_divisible - -

- -## ::: ultralytics.utils.torch_utils.copy_attr - -

- -## ::: ultralytics.utils.torch_utils.get_latest_opset - -

- -## ::: ultralytics.utils.torch_utils.intersect_dicts - -

- -## ::: ultralytics.utils.torch_utils.is_parallel - -

- -## ::: ultralytics.utils.torch_utils.de_parallel - -

- -## ::: ultralytics.utils.torch_utils.one_cycle - -

- -## ::: ultralytics.utils.torch_utils.init_seeds - -

- -## ::: ultralytics.utils.torch_utils.strip_optimizer - -

- -## ::: ultralytics.utils.torch_utils.profile - -

diff --git a/ultralytics-main/docs/en/reference/utils/triton.md b/ultralytics-main/docs/en/reference/utils/triton.md deleted file mode 100644 index 6a86de6..0000000 --- a/ultralytics-main/docs/en/reference/utils/triton.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Deploy ML models effortlessly with Ultralytics TritonRemoteModel. Simplify serving with our comprehensive utils guide. -keywords: Ultralytics, YOLO, TritonRemoteModel, machine learning, model serving, deployment, utils, documentation ---- - -# Reference for `ultralytics/utils/triton.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/triton.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/triton.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/triton.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.triton.TritonRemoteModel - -

diff --git a/ultralytics-main/docs/en/reference/utils/tuner.md b/ultralytics-main/docs/en/reference/utils/tuner.md deleted file mode 100644 index d05f83d..0000000 --- a/ultralytics-main/docs/en/reference/utils/tuner.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -description: Learn to utilize the run_ray_tune function with Ultralytics. Make your machine learning tuning process easier and more efficient. -keywords: Ultralytics, run_ray_tune, machine learning tuning, machine learning efficiency ---- - -# Reference for `ultralytics/utils/tuner.py` - -!!! Note - - This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/tuner.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/tuner.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/utils/tuner.py) 🛠️. Thank you 🙏! - -

- -## ::: ultralytics.utils.tuner.run_ray_tune - -

diff --git a/ultralytics-main/docs/en/robots.txt b/ultralytics-main/docs/en/robots.txt deleted file mode 100644 index 9436a7a..0000000 --- a/ultralytics-main/docs/en/robots.txt +++ /dev/null @@ -1,16 +0,0 @@ -User-agent: * -Sitemap: https://docs.ultralytics.com/sitemap.xml -Sitemap: https://docs.ultralytics.com/ar/sitemap.xml -Sitemap: https://docs.ultralytics.com/de/sitemap.xml -Sitemap: https://docs.ultralytics.com/es/sitemap.xml -Sitemap: https://docs.ultralytics.com/fr/sitemap.xml -Sitemap: https://docs.ultralytics.com/hi/sitemap.xml -Sitemap: https://docs.ultralytics.com/it/sitemap.xml -Sitemap: https://docs.ultralytics.com/ja/sitemap.xml -Sitemap: https://docs.ultralytics.com/ko/sitemap.xml -Sitemap: https://docs.ultralytics.com/nl/sitemap.xml -Sitemap: https://docs.ultralytics.com/pt/sitemap.xml -Sitemap: https://docs.ultralytics.com/ru/sitemap.xml -Sitemap: https://docs.ultralytics.com/tr/sitemap.xml -Sitemap: https://docs.ultralytics.com/vi/sitemap.xml -Sitemap: https://docs.ultralytics.com/zh/sitemap.xml diff --git a/ultralytics-main/docs/en/tasks/classify.md b/ultralytics-main/docs/en/tasks/classify.md deleted file mode 100644 index 4a54750..0000000 --- a/ultralytics-main/docs/en/tasks/classify.md +++ /dev/null @@ -1,181 +0,0 @@ ---- -comments: true -description: Learn about YOLOv8 Classify models for image classification. Get detailed information on List of Pretrained Models & how to Train, Validate, Predict & Export models. -keywords: Ultralytics, YOLOv8, Image Classification, Pretrained Models, YOLOv8n-cls, Training, Validation, Prediction, Model Export ---- - -# Image Classification - -Image classification examples - -Image classification is the simplest of the three tasks and involves classifying an entire image into one of a set of predefined classes. - -The output of an image classifier is a single class label and a confidence score. Image classification is useful when you need to know only what class an image belongs to and don't need to know where objects of that class are located or what their exact shape is. - -

-
- -
- Watch: Explore Ultralytics YOLO Tasks: Image Classification using Ultralytics HUB -

- -!!! Tip "Tip" - - YOLOv8 Classify models use the `-cls` suffix, i.e. `yolov8n-cls.pt` and are pretrained on [ImageNet](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/ImageNet.yaml). - -## [Models](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/models/v8) - -YOLOv8 pretrained Classify models are shown here. Detect, Segment and Pose models are pretrained on the [COCO](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/coco.yaml) dataset, while Classify models are pretrained on the [ImageNet](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/ImageNet.yaml) dataset. - -[Models](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/models) download automatically from the latest Ultralytics [release](https://github.com/ultralytics/assets/releases) on first use. - -| Model | size
(pixels) | acc
top1 | acc
top5 | Speed
CPU ONNX
(ms) | Speed
A100 TensorRT
(ms) | params
(M) | FLOPs
(B) at 640 | -|----------------------------------------------------------------------------------------------|-----------------------|------------------|------------------|--------------------------------|-------------------------------------|--------------------|--------------------------| -| [YOLOv8n-cls](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8n-cls.pt) | 224 | 69.0 | 88.3 | 12.9 | 0.31 | 2.7 | 4.3 | -| [YOLOv8s-cls](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8s-cls.pt) | 224 | 73.8 | 91.7 | 23.4 | 0.35 | 6.4 | 13.5 | -| [YOLOv8m-cls](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8m-cls.pt) | 224 | 76.8 | 93.5 | 85.4 | 0.62 | 17.0 | 42.7 | -| [YOLOv8l-cls](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8l-cls.pt) | 224 | 76.8 | 93.5 | 163.0 | 0.87 | 37.5 | 99.7 | -| [YOLOv8x-cls](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8x-cls.pt) | 224 | 79.0 | 94.6 | 232.0 | 1.01 | 57.4 | 154.8 | - -- **acc** values are model accuracies on the [ImageNet](https://www.image-net.org/) dataset validation set.
Reproduce by `yolo val classify data=path/to/ImageNet device=0` -- **Speed** averaged over ImageNet val images using an [Amazon EC2 P4d](https://aws.amazon.com/ec2/instance-types/p4/) instance.
Reproduce by `yolo val classify data=path/to/ImageNet batch=1 device=0|cpu` - -## Train - -Train YOLOv8n-cls on the MNIST160 dataset for 100 epochs at image size 64. For a full list of available arguments see the [Configuration](../usage/cfg.md) page. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n-cls.yaml') # build a new model from YAML - model = YOLO('yolov8n-cls.pt') # load a pretrained model (recommended for training) - model = YOLO('yolov8n-cls.yaml').load('yolov8n-cls.pt') # build from YAML and transfer weights - - # Train the model - results = model.train(data='mnist160', epochs=100, imgsz=64) - ``` - - === "CLI" - - ```bash - # Build a new model from YAML and start training from scratch - yolo classify train data=mnist160 model=yolov8n-cls.yaml epochs=100 imgsz=64 - - # Start training from a pretrained *.pt model - yolo classify train data=mnist160 model=yolov8n-cls.pt epochs=100 imgsz=64 - - # Build a new model from YAML, transfer pretrained weights to it and start training - yolo classify train data=mnist160 model=yolov8n-cls.yaml pretrained=yolov8n-cls.pt epochs=100 imgsz=64 - ``` - -### Dataset format - -YOLO classification dataset format can be found in detail in the [Dataset Guide](../datasets/classify/index.md). - -## Val - -Validate trained YOLOv8n-cls model accuracy on the MNIST160 dataset. No argument need to passed as the `model` retains it's training `data` and arguments as model attributes. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n-cls.pt') # load an official model - model = YOLO('path/to/best.pt') # load a custom model - - # Validate the model - metrics = model.val() # no arguments needed, dataset and settings remembered - metrics.top1 # top1 accuracy - metrics.top5 # top5 accuracy - ``` - === "CLI" - - ```bash - yolo classify val model=yolov8n-cls.pt # val official model - yolo classify val model=path/to/best.pt # val custom model - ``` - -## Predict - -Use a trained YOLOv8n-cls model to run predictions on images. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n-cls.pt') # load an official model - model = YOLO('path/to/best.pt') # load a custom model - - # Predict with the model - results = model('https://ultralytics.com/images/bus.jpg') # predict on an image - ``` - === "CLI" - - ```bash - yolo classify predict model=yolov8n-cls.pt source='https://ultralytics.com/images/bus.jpg' # predict with official model - yolo classify predict model=path/to/best.pt source='https://ultralytics.com/images/bus.jpg' # predict with custom model - ``` - -See full `predict` mode details in the [Predict](https://docs.ultralytics.com/modes/predict/) page. - -## Export - -Export a YOLOv8n-cls model to a different format like ONNX, CoreML, etc. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n-cls.pt') # load an official model - model = YOLO('path/to/best.pt') # load a custom trained model - - # Export the model - model.export(format='onnx') - ``` - === "CLI" - - ```bash - yolo export model=yolov8n-cls.pt format=onnx # export official model - yolo export model=path/to/best.pt format=onnx # export custom trained model - ``` - -Available YOLOv8-cls export formats are in the table below. You can predict or validate directly on exported models, i.e. `yolo predict model=yolov8n-cls.onnx`. Usage examples are shown for your model after export completes. - -| Format | `format` Argument | Model | Metadata | Arguments | -|--------------------------------------------------------------------|-------------------|-------------------------------|----------|-----------------------------------------------------| -| [PyTorch](https://pytorch.org/) | - | `yolov8n-cls.pt` | ✅ | - | -| [TorchScript](https://pytorch.org/docs/stable/jit.html) | `torchscript` | `yolov8n-cls.torchscript` | ✅ | `imgsz`, `optimize` | -| [ONNX](https://onnx.ai/) | `onnx` | `yolov8n-cls.onnx` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `opset` | -| [OpenVINO](../integrations/openvino.md) | `openvino` | `yolov8n-cls_openvino_model/` | ✅ | `imgsz`, `half`, `int8` | -| [TensorRT](https://developer.nvidia.com/tensorrt) | `engine` | `yolov8n-cls.engine` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `workspace` | -| [CoreML](https://github.com/apple/coremltools) | `coreml` | `yolov8n-cls.mlpackage` | ✅ | `imgsz`, `half`, `int8`, `nms` | -| [TF SavedModel](https://www.tensorflow.org/guide/saved_model) | `saved_model` | `yolov8n-cls_saved_model/` | ✅ | `imgsz`, `keras` | -| [TF GraphDef](https://www.tensorflow.org/api_docs/python/tf/Graph) | `pb` | `yolov8n-cls.pb` | ❌ | `imgsz` | -| [TF Lite](https://www.tensorflow.org/lite) | `tflite` | `yolov8n-cls.tflite` | ✅ | `imgsz`, `half`, `int8` | -| [TF Edge TPU](https://coral.ai/docs/edgetpu/models-intro/) | `edgetpu` | `yolov8n-cls_edgetpu.tflite` | ✅ | `imgsz` | -| [TF.js](https://www.tensorflow.org/js) | `tfjs` | `yolov8n-cls_web_model/` | ✅ | `imgsz`, `half`, `int8` | -| [PaddlePaddle](https://github.com/PaddlePaddle) | `paddle` | `yolov8n-cls_paddle_model/` | ✅ | `imgsz` | -| [NCNN](https://github.com/Tencent/ncnn) | `ncnn` | `yolov8n-cls_ncnn_model/` | ✅ | `imgsz`, `half` | - -See full `export` details in the [Export](https://docs.ultralytics.com/modes/export/) page. diff --git a/ultralytics-main/docs/en/tasks/detect.md b/ultralytics-main/docs/en/tasks/detect.md deleted file mode 100644 index b5d2700..0000000 --- a/ultralytics-main/docs/en/tasks/detect.md +++ /dev/null @@ -1,182 +0,0 @@ ---- -comments: true -description: Official documentation for YOLOv8 by Ultralytics. Learn how to train, validate, predict and export models in various formats. Including detailed performance stats. -keywords: YOLOv8, Ultralytics, object detection, pretrained models, training, validation, prediction, export models, COCO, ImageNet, PyTorch, ONNX, CoreML ---- - -# Object Detection - -Object detection examples - -Object detection is a task that involves identifying the location and class of objects in an image or video stream. - -The output of an object detector is a set of bounding boxes that enclose the objects in the image, along with class labels and confidence scores for each box. Object detection is a good choice when you need to identify objects of interest in a scene, but don't need to know exactly where the object is or its exact shape. - -

-
- -
- Watch: Object Detection with Pre-trained Ultralytics YOLOv8 Model. -

- -!!! Tip "Tip" - - YOLOv8 Detect models are the default YOLOv8 models, i.e. `yolov8n.pt` and are pretrained on [COCO](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/coco.yaml). - -## [Models](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/models/v8) - -YOLOv8 pretrained Detect models are shown here. Detect, Segment and Pose models are pretrained on the [COCO](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/coco.yaml) dataset, while Classify models are pretrained on the [ImageNet](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/ImageNet.yaml) dataset. - -[Models](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/models) download automatically from the latest Ultralytics [release](https://github.com/ultralytics/assets/releases) on first use. - -| Model | size
(pixels) | mAPval
50-95 | Speed
CPU ONNX
(ms) | Speed
A100 TensorRT
(ms) | params
(M) | FLOPs
(B) | -|--------------------------------------------------------------------------------------|-----------------------|----------------------|--------------------------------|-------------------------------------|--------------------|-------------------| -| [YOLOv8n](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8n.pt) | 640 | 37.3 | 80.4 | 0.99 | 3.2 | 8.7 | -| [YOLOv8s](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8s.pt) | 640 | 44.9 | 128.4 | 1.20 | 11.2 | 28.6 | -| [YOLOv8m](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8m.pt) | 640 | 50.2 | 234.7 | 1.83 | 25.9 | 78.9 | -| [YOLOv8l](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8l.pt) | 640 | 52.9 | 375.2 | 2.39 | 43.7 | 165.2 | -| [YOLOv8x](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8x.pt) | 640 | 53.9 | 479.1 | 3.53 | 68.2 | 257.8 | - -- **mAPval** values are for single-model single-scale on [COCO val2017](https://cocodataset.org) dataset.
Reproduce by `yolo val detect data=coco.yaml device=0` -- **Speed** averaged over COCO val images using an [Amazon EC2 P4d](https://aws.amazon.com/ec2/instance-types/p4/) instance.
Reproduce by `yolo val detect data=coco128.yaml batch=1 device=0|cpu` - -## Train - -Train YOLOv8n on the COCO128 dataset for 100 epochs at image size 640. For a full list of available arguments see the [Configuration](../usage/cfg.md) page. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n.yaml') # build a new model from YAML - model = YOLO('yolov8n.pt') # load a pretrained model (recommended for training) - model = YOLO('yolov8n.yaml').load('yolov8n.pt') # build from YAML and transfer weights - - # Train the model - results = model.train(data='coco128.yaml', epochs=100, imgsz=640) - ``` - === "CLI" - - ```bash - # Build a new model from YAML and start training from scratch - yolo detect train data=coco128.yaml model=yolov8n.yaml epochs=100 imgsz=640 - - # Start training from a pretrained *.pt model - yolo detect train data=coco128.yaml model=yolov8n.pt epochs=100 imgsz=640 - - # Build a new model from YAML, transfer pretrained weights to it and start training - yolo detect train data=coco128.yaml model=yolov8n.yaml pretrained=yolov8n.pt epochs=100 imgsz=640 - ``` - -### Dataset format - -YOLO detection dataset format can be found in detail in the [Dataset Guide](../datasets/detect/index.md). To convert your existing dataset from other formats (like COCO etc.) to YOLO format, please use [JSON2YOLO](https://github.com/ultralytics/JSON2YOLO) tool by Ultralytics. - -## Val - -Validate trained YOLOv8n model accuracy on the COCO128 dataset. No argument need to passed as the `model` retains it's training `data` and arguments as model attributes. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n.pt') # load an official model - model = YOLO('path/to/best.pt') # load a custom model - - # Validate the model - metrics = model.val() # no arguments needed, dataset and settings remembered - metrics.box.map # map50-95 - metrics.box.map50 # map50 - metrics.box.map75 # map75 - metrics.box.maps # a list contains map50-95 of each category - ``` - === "CLI" - - ```bash - yolo detect val model=yolov8n.pt # val official model - yolo detect val model=path/to/best.pt # val custom model - ``` - -## Predict - -Use a trained YOLOv8n model to run predictions on images. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n.pt') # load an official model - model = YOLO('path/to/best.pt') # load a custom model - - # Predict with the model - results = model('https://ultralytics.com/images/bus.jpg') # predict on an image - ``` - === "CLI" - - ```bash - yolo detect predict model=yolov8n.pt source='https://ultralytics.com/images/bus.jpg' # predict with official model - yolo detect predict model=path/to/best.pt source='https://ultralytics.com/images/bus.jpg' # predict with custom model - ``` - -See full `predict` mode details in the [Predict](https://docs.ultralytics.com/modes/predict/) page. - -## Export - -Export a YOLOv8n model to a different format like ONNX, CoreML, etc. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n.pt') # load an official model - model = YOLO('path/to/best.pt') # load a custom trained model - - # Export the model - model.export(format='onnx') - ``` - === "CLI" - - ```bash - yolo export model=yolov8n.pt format=onnx # export official model - yolo export model=path/to/best.pt format=onnx # export custom trained model - ``` - -Available YOLOv8 export formats are in the table below. You can predict or validate directly on exported models, i.e. `yolo predict model=yolov8n.onnx`. Usage examples are shown for your model after export completes. - -| Format | `format` Argument | Model | Metadata | Arguments | -|--------------------------------------------------------------------|-------------------|---------------------------|----------|-----------------------------------------------------| -| [PyTorch](https://pytorch.org/) | - | `yolov8n.pt` | ✅ | - | -| [TorchScript](https://pytorch.org/docs/stable/jit.html) | `torchscript` | `yolov8n.torchscript` | ✅ | `imgsz`, `optimize` | -| [ONNX](https://onnx.ai/) | `onnx` | `yolov8n.onnx` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `opset` | -| [OpenVINO](../integrations/openvino.md) | `openvino` | `yolov8n_openvino_model/` | ✅ | `imgsz`, `half`, `int8` | -| [TensorRT](https://developer.nvidia.com/tensorrt) | `engine` | `yolov8n.engine` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `workspace` | -| [CoreML](https://github.com/apple/coremltools) | `coreml` | `yolov8n.mlpackage` | ✅ | `imgsz`, `half`, `int8`, `nms` | -| [TF SavedModel](https://www.tensorflow.org/guide/saved_model) | `saved_model` | `yolov8n_saved_model/` | ✅ | `imgsz`, `keras`, `int8` | -| [TF GraphDef](https://www.tensorflow.org/api_docs/python/tf/Graph) | `pb` | `yolov8n.pb` | ❌ | `imgsz` | -| [TF Lite](https://www.tensorflow.org/lite) | `tflite` | `yolov8n.tflite` | ✅ | `imgsz`, `half`, `int8` | -| [TF Edge TPU](https://coral.ai/docs/edgetpu/models-intro/) | `edgetpu` | `yolov8n_edgetpu.tflite` | ✅ | `imgsz` | -| [TF.js](https://www.tensorflow.org/js) | `tfjs` | `yolov8n_web_model/` | ✅ | `imgsz`, `half`, `int8` | -| [PaddlePaddle](https://github.com/PaddlePaddle) | `paddle` | `yolov8n_paddle_model/` | ✅ | `imgsz` | -| [NCNN](https://github.com/Tencent/ncnn) | `ncnn` | `yolov8n_ncnn_model/` | ✅ | `imgsz`, `half` | - -See full `export` details in the [Export](https://docs.ultralytics.com/modes/export/) page. diff --git a/ultralytics-main/docs/en/tasks/index.md b/ultralytics-main/docs/en/tasks/index.md deleted file mode 100644 index 2cf4696..0000000 --- a/ultralytics-main/docs/en/tasks/index.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -comments: true -description: Learn about the cornerstone computer vision tasks YOLOv8 can perform including detection, segmentation, classification, and pose estimation. Understand their uses in your AI projects. -keywords: Ultralytics, YOLOv8, Detection, Segmentation, Classification, Pose Estimation, Oriented Object Detection, AI Framework, Computer Vision Tasks ---- - -# Ultralytics YOLOv8 Tasks - -
-Ultralytics YOLO supported tasks - -YOLOv8 is an AI framework that supports multiple computer vision **tasks**. The framework can be used to perform [detection](detect.md), [segmentation](segment.md), [obb](obb.md), [classification](classify.md), and [pose](pose.md) estimation. Each of these tasks has a different objective and use case. - -

-
- -
- Watch: Explore Ultralytics YOLO Tasks: Object Detection, Segmentation, OBB, Tracking, and Pose Estimation. -

- -## [Detection](detect.md) - -Detection is the primary task supported by YOLOv8. It involves detecting objects in an image or video frame and drawing bounding boxes around them. The detected objects are classified into different categories based on their features. YOLOv8 can detect multiple objects in a single image or video frame with high accuracy and speed. - -[Detection Examples](detect.md){ .md-button } - -## [Segmentation](segment.md) - -Segmentation is a task that involves segmenting an image into different regions based on the content of the image. Each region is assigned a label based on its content. This task is useful in applications such as image segmentation and medical imaging. YOLOv8 uses a variant of the U-Net architecture to perform segmentation. - -[Segmentation Examples](segment.md){ .md-button } - -## [Classification](classify.md) - -Classification is a task that involves classifying an image into different categories. YOLOv8 can be used to classify images based on their content. It uses a variant of the EfficientNet architecture to perform classification. - -[Classification Examples](classify.md){ .md-button } - -## [Pose](pose.md) - -Pose/keypoint detection is a task that involves detecting specific points in an image or video frame. These points are referred to as keypoints and are used to track movement or pose estimation. YOLOv8 can detect keypoints in an image or video frame with high accuracy and speed. - -[Pose Examples](pose.md){ .md-button } - -## [OBB](obb.md) - -Oriented object detection goes a step further than regular object detection with introducing an extra angle to locate objects more accurate in an image. YOLOv8 can detect rotated objects in an image or video frame with high accuracy and speed. - -[Oriented Detection](obb.md){ .md-button } - -## Conclusion - -YOLOv8 supports multiple tasks, including detection, segmentation, classification, oriented object detection and keypoints detection. Each of these tasks has different objectives and use cases. By understanding the differences between these tasks, you can choose the appropriate task for your computer vision application. diff --git a/ultralytics-main/docs/en/tasks/obb.md b/ultralytics-main/docs/en/tasks/obb.md deleted file mode 100644 index aa75d51..0000000 --- a/ultralytics-main/docs/en/tasks/obb.md +++ /dev/null @@ -1,191 +0,0 @@ ---- -comments: true -description: Learn how to use oriented object detection models with Ultralytics YOLO. Instructions on training, validation, image prediction, and model export. -keywords: yolov8, oriented object detection, Ultralytics, DOTA dataset, rotated object detection, object detection, model training, model validation, image prediction, model export ---- - -# Oriented Bounding Boxes Object Detection - - - -Oriented object detection goes a step further than object detection and introduce an extra angle to locate objects more accurate in an image. - -The output of an oriented object detector is a set of rotated bounding boxes that exactly enclose the objects in the image, along with class labels and confidence scores for each box. Object detection is a good choice when you need to identify objects of interest in a scene, but don't need to know exactly where the object is or its exact shape. - - - -!!! Tip "Tip" - - YOLOv8 OBB models use the `-obb` suffix, i.e. `yolov8n-obb.pt` and are pretrained on [DOTAv1](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/DOTAv1.yaml). - -

-
- -
- Watch: Object Detection using Ultralytics YOLOv8 Oriented Bounding Boxes (YOLOv8-OBB) -

- -## Visual Samples - -| Ships Detection using OBB | Vehicle Detection using OBB | -|:-------------------------------------------------------------------------------------------------------------------------------:|:---------------------------------------------------------------------------------------------------------------------------------:| -| ![Ships Detection using OBB](https://github.com/RizwanMunawar/ultralytics/assets/62513924/5051d324-416f-4b58-ab62-f1bf9d7134b0) | ![Vehicle Detection using OBB](https://github.com/RizwanMunawar/ultralytics/assets/62513924/9a366262-910a-403b-a5e2-9c68b75700d3) | - -## [Models](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/models/v8) - -YOLOv8 pretrained OBB models are shown here, which are pretrained on the [DOTAv1](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/DOTAv1.yaml) dataset. - -[Models](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/models) download automatically from the latest Ultralytics [release](https://github.com/ultralytics/assets/releases) on first use. - -| Model | size
(pixels) | mAPtest
50 | Speed
CPU ONNX
(ms) | Speed
A100 TensorRT
(ms) | params
(M) | FLOPs
(B) | -|----------------------------------------------------------------------------------------------|-----------------------|--------------------|--------------------------------|-------------------------------------|--------------------|-------------------| -| [YOLOv8n-obb](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8n-obb.pt) | 1024 | 78.0 | 204.77 | 3.57 | 3.1 | 23.3 | -| [YOLOv8s-obb](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8s-obb.pt) | 1024 | 79.5 | 424.88 | 4.07 | 11.4 | 76.3 | -| [YOLOv8m-obb](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8m-obb.pt) | 1024 | 80.5 | 763.48 | 7.61 | 26.4 | 208.6 | -| [YOLOv8l-obb](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8l-obb.pt) | 1024 | 80.7 | 1278.42 | 11.83 | 44.5 | 433.8 | -| [YOLOv8x-obb](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8x-obb.pt) | 1024 | 81.36 | 1759.10 | 13.23 | 69.5 | 676.7 | - -- **mAPtest** values are for single-model multiscale on [DOTAv1 test](https://captain-whu.github.io/DOTA/index.html) dataset.
Reproduce by `yolo val obb data=DOTAv1.yaml device=0 split=test` and submit merged results to [DOTA evaluation](https://captain-whu.github.io/DOTA/evaluation.html). -- **Speed** averaged over DOTAv1 val images using an [Amazon EC2 P4d](https://aws.amazon.com/ec2/instance-types/p4/) instance.
Reproduce by `yolo val obb data=DOTAv1.yaml batch=1 device=0|cpu` - -## Train - -Train YOLOv8n-obb on the `dota8.yaml` dataset for 100 epochs at image size 640. For a full list of available arguments see the [Configuration](../usage/cfg.md) page. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n-obb.yaml') # build a new model from YAML - model = YOLO('yolov8n-obb.pt') # load a pretrained model (recommended for training) - model = YOLO('yolov8n-obb.yaml').load('yolov8n.pt') # build from YAML and transfer weights - - # Train the model - results = model.train(data='dota8.yaml', epochs=100, imgsz=640) - ``` - === "CLI" - - ```bash - # Build a new model from YAML and start training from scratch - yolo obb train data=dota8.yaml model=yolov8n-obb.yaml epochs=100 imgsz=640 - - # Start training from a pretrained *.pt model - yolo obb train data=dota8.yaml model=yolov8n-obb.pt epochs=100 imgsz=640 - - # Build a new model from YAML, transfer pretrained weights to it and start training - yolo obb train data=dota8.yaml model=yolov8n-obb.yaml pretrained=yolov8n-obb.pt epochs=100 imgsz=640 - ``` - -### Dataset format - -OBB dataset format can be found in detail in the [Dataset Guide](../datasets/obb/index.md). - -## Val - -Validate trained YOLOv8n-obb model accuracy on the DOTA8 dataset. No argument need to passed as the `model` -retains it's training `data` and arguments as model attributes. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n-obb.pt') # load an official model - model = YOLO('path/to/best.pt') # load a custom model - - # Validate the model - metrics = model.val(data='dota8.yaml') # no arguments needed, dataset and settings remembered - metrics.box.map # map50-95(B) - metrics.box.map50 # map50(B) - metrics.box.map75 # map75(B) - metrics.box.maps # a list contains map50-95(B) of each category - ``` - === "CLI" - - ```bash - yolo obb val model=yolov8n-obb.pt data=dota8.yaml # val official model - yolo obb val model=path/to/best.pt data=path/to/data.yaml # val custom model - ``` - -## Predict - -Use a trained YOLOv8n-obb model to run predictions on images. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n-obb.pt') # load an official model - model = YOLO('path/to/best.pt') # load a custom model - - # Predict with the model - results = model('https://ultralytics.com/images/bus.jpg') # predict on an image - ``` - === "CLI" - - ```bash - yolo obb predict model=yolov8n-obb.pt source='https://ultralytics.com/images/bus.jpg' # predict with official model - yolo obb predict model=path/to/best.pt source='https://ultralytics.com/images/bus.jpg' # predict with custom model - ``` - -See full `predict` mode details in the [Predict](https://docs.ultralytics.com/modes/predict/) page. - -## Export - -Export a YOLOv8n-obb model to a different format like ONNX, CoreML, etc. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n-obb.pt') # load an official model - model = YOLO('path/to/best.pt') # load a custom trained model - - # Export the model - model.export(format='onnx') - ``` - === "CLI" - - ```bash - yolo export model=yolov8n-obb.pt format=onnx # export official model - yolo export model=path/to/best.pt format=onnx # export custom trained model - ``` - -Available YOLOv8-obb export formats are in the table below. You can predict or validate directly on exported models, i.e. `yolo predict model=yolov8n-obb.onnx`. Usage examples are shown for your model after export completes. - -| Format | `format` Argument | Model | Metadata | Arguments | -|--------------------------------------------------------------------|-------------------|-------------------------------|----------|-----------------------------------------------------| -| [PyTorch](https://pytorch.org/) | - | `yolov8n-obb.pt` | ✅ | - | -| [TorchScript](https://pytorch.org/docs/stable/jit.html) | `torchscript` | `yolov8n-obb.torchscript` | ✅ | `imgsz`, `optimize` | -| [ONNX](https://onnx.ai/) | `onnx` | `yolov8n-obb.onnx` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `opset` | -| [OpenVINO](../integrations/openvino.md) | `openvino` | `yolov8n-obb_openvino_model/` | ✅ | `imgsz`, `half`, `int8` | -| [TensorRT](https://developer.nvidia.com/tensorrt) | `engine` | `yolov8n-obb.engine` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `workspace` | -| [CoreML](https://github.com/apple/coremltools) | `coreml` | `yolov8n-obb.mlpackage` | ✅ | `imgsz`, `half`, `int8`, `nms` | -| [TF SavedModel](https://www.tensorflow.org/guide/saved_model) | `saved_model` | `yolov8n-obb_saved_model/` | ✅ | `imgsz`, `keras` | -| [TF GraphDef](https://www.tensorflow.org/api_docs/python/tf/Graph) | `pb` | `yolov8n-obb.pb` | ❌ | `imgsz` | -| [TF Lite](https://www.tensorflow.org/lite) | `tflite` | `yolov8n-obb.tflite` | ✅ | `imgsz`, `half`, `int8` | -| [TF Edge TPU](https://coral.ai/docs/edgetpu/models-intro/) | `edgetpu` | `yolov8n-obb_edgetpu.tflite` | ✅ | `imgsz` | -| [TF.js](https://www.tensorflow.org/js) | `tfjs` | `yolov8n-obb_web_model/` | ✅ | `imgsz`, `half`, `int8` | -| [PaddlePaddle](https://github.com/PaddlePaddle) | `paddle` | `yolov8n-obb_paddle_model/` | ✅ | `imgsz` | -| [NCNN](https://github.com/Tencent/ncnn) | `ncnn` | `yolov8n-obb_ncnn_model/` | ✅ | `imgsz`, `half` | - -See full `export` details in the [Export](https://docs.ultralytics.com/modes/export/) page. diff --git a/ultralytics-main/docs/en/tasks/pose.md b/ultralytics-main/docs/en/tasks/pose.md deleted file mode 100644 index 431164b..0000000 --- a/ultralytics-main/docs/en/tasks/pose.md +++ /dev/null @@ -1,185 +0,0 @@ ---- -comments: true -description: Learn how to use Ultralytics YOLOv8 for pose estimation tasks. Find pretrained models, learn how to train, validate, predict, and export your own. -keywords: Ultralytics, YOLO, YOLOv8, pose estimation, keypoints detection, object detection, pre-trained models, machine learning, artificial intelligence ---- - -# Pose Estimation - -Pose estimation examples - -Pose estimation is a task that involves identifying the location of specific points in an image, usually referred to as keypoints. The keypoints can represent various parts of the object such as joints, landmarks, or other distinctive features. The locations of the keypoints are usually represented as a set of 2D `[x, y]` or 3D `[x, y, visible]` coordinates. - -The output of a pose estimation model is a set of points that represent the keypoints on an object in the image, usually along with the confidence scores for each point. Pose estimation is a good choice when you need to identify specific parts of an object in a scene, and their location in relation to each other. - -

-
- -
- Watch: Pose Estimation with Ultralytics YOLOv8. -

- -!!! Tip "Tip" - - YOLOv8 _pose_ models use the `-pose` suffix, i.e. `yolov8n-pose.pt`. These models are trained on the [COCO keypoints](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/coco-pose.yaml) dataset and are suitable for a variety of pose estimation tasks. - -## [Models](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/models/v8) - -YOLOv8 pretrained Pose models are shown here. Detect, Segment and Pose models are pretrained on the [COCO](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/coco.yaml) dataset, while Classify models are pretrained on the [ImageNet](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/ImageNet.yaml) dataset. - -[Models](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/models) download automatically from the latest Ultralytics [release](https://github.com/ultralytics/assets/releases) on first use. - -| Model | size
(pixels) | mAPpose
50-95 | mAPpose
50 | Speed
CPU ONNX
(ms) | Speed
A100 TensorRT
(ms) | params
(M) | FLOPs
(B) | -|------------------------------------------------------------------------------------------------------|-----------------------|-----------------------|--------------------|--------------------------------|-------------------------------------|--------------------|-------------------| -| [YOLOv8n-pose](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8n-pose.pt) | 640 | 50.4 | 80.1 | 131.8 | 1.18 | 3.3 | 9.2 | -| [YOLOv8s-pose](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8s-pose.pt) | 640 | 60.0 | 86.2 | 233.2 | 1.42 | 11.6 | 30.2 | -| [YOLOv8m-pose](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8m-pose.pt) | 640 | 65.0 | 88.8 | 456.3 | 2.00 | 26.4 | 81.0 | -| [YOLOv8l-pose](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8l-pose.pt) | 640 | 67.6 | 90.0 | 784.5 | 2.59 | 44.4 | 168.6 | -| [YOLOv8x-pose](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8x-pose.pt) | 640 | 69.2 | 90.2 | 1607.1 | 3.73 | 69.4 | 263.2 | -| [YOLOv8x-pose-p6](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8x-pose-p6.pt) | 1280 | 71.6 | 91.2 | 4088.7 | 10.04 | 99.1 | 1066.4 | - -- **mAPval** values are for single-model single-scale on [COCO Keypoints val2017](https://cocodataset.org) dataset.
Reproduce by `yolo val pose data=coco-pose.yaml device=0` -- **Speed** averaged over COCO val images using an [Amazon EC2 P4d](https://aws.amazon.com/ec2/instance-types/p4/) instance.
Reproduce by `yolo val pose data=coco8-pose.yaml batch=1 device=0|cpu` - -## Train - -Train a YOLOv8-pose model on the COCO128-pose dataset. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n-pose.yaml') # build a new model from YAML - model = YOLO('yolov8n-pose.pt') # load a pretrained model (recommended for training) - model = YOLO('yolov8n-pose.yaml').load('yolov8n-pose.pt') # build from YAML and transfer weights - - # Train the model - results = model.train(data='coco8-pose.yaml', epochs=100, imgsz=640) - ``` - - === "CLI" - - ```bash - # Build a new model from YAML and start training from scratch - yolo pose train data=coco8-pose.yaml model=yolov8n-pose.yaml epochs=100 imgsz=640 - - # Start training from a pretrained *.pt model - yolo pose train data=coco8-pose.yaml model=yolov8n-pose.pt epochs=100 imgsz=640 - - # Build a new model from YAML, transfer pretrained weights to it and start training - yolo pose train data=coco8-pose.yaml model=yolov8n-pose.yaml pretrained=yolov8n-pose.pt epochs=100 imgsz=640 - ``` - -### Dataset format - -YOLO pose dataset format can be found in detail in the [Dataset Guide](../datasets/pose/index.md). To convert your existing dataset from other formats (like COCO etc.) to YOLO format, please use [JSON2YOLO](https://github.com/ultralytics/JSON2YOLO) tool by Ultralytics. - -## Val - -Validate trained YOLOv8n-pose model accuracy on the COCO128-pose dataset. No argument need to passed as the `model` -retains it's training `data` and arguments as model attributes. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n-pose.pt') # load an official model - model = YOLO('path/to/best.pt') # load a custom model - - # Validate the model - metrics = model.val() # no arguments needed, dataset and settings remembered - metrics.box.map # map50-95 - metrics.box.map50 # map50 - metrics.box.map75 # map75 - metrics.box.maps # a list contains map50-95 of each category - ``` - === "CLI" - - ```bash - yolo pose val model=yolov8n-pose.pt # val official model - yolo pose val model=path/to/best.pt # val custom model - ``` - -## Predict - -Use a trained YOLOv8n-pose model to run predictions on images. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n-pose.pt') # load an official model - model = YOLO('path/to/best.pt') # load a custom model - - # Predict with the model - results = model('https://ultralytics.com/images/bus.jpg') # predict on an image - ``` - === "CLI" - - ```bash - yolo pose predict model=yolov8n-pose.pt source='https://ultralytics.com/images/bus.jpg' # predict with official model - yolo pose predict model=path/to/best.pt source='https://ultralytics.com/images/bus.jpg' # predict with custom model - ``` - -See full `predict` mode details in the [Predict](https://docs.ultralytics.com/modes/predict/) page. - -## Export - -Export a YOLOv8n Pose model to a different format like ONNX, CoreML, etc. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n-pose.pt') # load an official model - model = YOLO('path/to/best.pt') # load a custom trained model - - # Export the model - model.export(format='onnx') - ``` - === "CLI" - - ```bash - yolo export model=yolov8n-pose.pt format=onnx # export official model - yolo export model=path/to/best.pt format=onnx # export custom trained model - ``` - -Available YOLOv8-pose export formats are in the table below. You can predict or validate directly on exported models, i.e. `yolo predict model=yolov8n-pose.onnx`. Usage examples are shown for your model after export completes. - -| Format | `format` Argument | Model | Metadata | Arguments | -|--------------------------------------------------------------------|-------------------|--------------------------------|----------|-----------------------------------------------------| -| [PyTorch](https://pytorch.org/) | - | `yolov8n-pose.pt` | ✅ | - | -| [TorchScript](https://pytorch.org/docs/stable/jit.html) | `torchscript` | `yolov8n-pose.torchscript` | ✅ | `imgsz`, `optimize` | -| [ONNX](https://onnx.ai/) | `onnx` | `yolov8n-pose.onnx` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `opset` | -| [OpenVINO](../integrations/openvino.md) | `openvino` | `yolov8n-pose_openvino_model/` | ✅ | `imgsz`, `half`, `int8` | -| [TensorRT](https://developer.nvidia.com/tensorrt) | `engine` | `yolov8n-pose.engine` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `workspace` | -| [CoreML](https://github.com/apple/coremltools) | `coreml` | `yolov8n-pose.mlpackage` | ✅ | `imgsz`, `half`, `int8`, `nms` | -| [TF SavedModel](https://www.tensorflow.org/guide/saved_model) | `saved_model` | `yolov8n-pose_saved_model/` | ✅ | `imgsz`, `keras` | -| [TF GraphDef](https://www.tensorflow.org/api_docs/python/tf/Graph) | `pb` | `yolov8n-pose.pb` | ❌ | `imgsz` | -| [TF Lite](https://www.tensorflow.org/lite) | `tflite` | `yolov8n-pose.tflite` | ✅ | `imgsz`, `half`, `int8` | -| [TF Edge TPU](https://coral.ai/docs/edgetpu/models-intro/) | `edgetpu` | `yolov8n-pose_edgetpu.tflite` | ✅ | `imgsz` | -| [TF.js](https://www.tensorflow.org/js) | `tfjs` | `yolov8n-pose_web_model/` | ✅ | `imgsz`, `half`, `int8` | -| [PaddlePaddle](https://github.com/PaddlePaddle) | `paddle` | `yolov8n-pose_paddle_model/` | ✅ | `imgsz` | -| [NCNN](https://github.com/Tencent/ncnn) | `ncnn` | `yolov8n-pose_ncnn_model/` | ✅ | `imgsz`, `half` | - -See full `export` details in the [Export](https://docs.ultralytics.com/modes/export/) page. diff --git a/ultralytics-main/docs/en/tasks/segment.md b/ultralytics-main/docs/en/tasks/segment.md deleted file mode 100644 index 921378a..0000000 --- a/ultralytics-main/docs/en/tasks/segment.md +++ /dev/null @@ -1,187 +0,0 @@ ---- -comments: true -description: Learn how to use instance segmentation models with Ultralytics YOLO. Instructions on training, validation, image prediction, and model export. -keywords: yolov8, instance segmentation, Ultralytics, COCO dataset, image segmentation, object detection, model training, model validation, image prediction, model export ---- - -# Instance Segmentation - -Instance segmentation examples - -Instance segmentation goes a step further than object detection and involves identifying individual objects in an image and segmenting them from the rest of the image. - -The output of an instance segmentation model is a set of masks or contours that outline each object in the image, along with class labels and confidence scores for each object. Instance segmentation is useful when you need to know not only where objects are in an image, but also what their exact shape is. - -

-
- -
- Watch: Run Segmentation with Pre-Trained Ultralytics YOLOv8 Model in Python. -

- -!!! Tip "Tip" - - YOLOv8 Segment models use the `-seg` suffix, i.e. `yolov8n-seg.pt` and are pretrained on [COCO](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/coco.yaml). - -## [Models](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/models/v8) - -YOLOv8 pretrained Segment models are shown here. Detect, Segment and Pose models are pretrained on the [COCO](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/coco.yaml) dataset, while Classify models are pretrained on the [ImageNet](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/ImageNet.yaml) dataset. - -[Models](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/models) download automatically from the latest Ultralytics [release](https://github.com/ultralytics/assets/releases) on first use. - -| Model | size
(pixels) | mAPbox
50-95 | mAPmask
50-95 | Speed
CPU ONNX
(ms) | Speed
A100 TensorRT
(ms) | params
(M) | FLOPs
(B) | -|----------------------------------------------------------------------------------------------|-----------------------|----------------------|-----------------------|--------------------------------|-------------------------------------|--------------------|-------------------| -| [YOLOv8n-seg](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8n-seg.pt) | 640 | 36.7 | 30.5 | 96.1 | 1.21 | 3.4 | 12.6 | -| [YOLOv8s-seg](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8s-seg.pt) | 640 | 44.6 | 36.8 | 155.7 | 1.47 | 11.8 | 42.6 | -| [YOLOv8m-seg](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8m-seg.pt) | 640 | 49.9 | 40.8 | 317.0 | 2.18 | 27.3 | 110.2 | -| [YOLOv8l-seg](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8l-seg.pt) | 640 | 52.3 | 42.6 | 572.4 | 2.79 | 46.0 | 220.5 | -| [YOLOv8x-seg](https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8x-seg.pt) | 640 | 53.4 | 43.4 | 712.1 | 4.02 | 71.8 | 344.1 | - -- **mAPval** values are for single-model single-scale on [COCO val2017](https://cocodataset.org) dataset.
Reproduce by `yolo val segment data=coco.yaml device=0` -- **Speed** averaged over COCO val images using an [Amazon EC2 P4d](https://aws.amazon.com/ec2/instance-types/p4/) instance.
Reproduce by `yolo val segment data=coco128-seg.yaml batch=1 device=0|cpu` - -## Train - -Train YOLOv8n-seg on the COCO128-seg dataset for 100 epochs at image size 640. For a full list of available arguments see the [Configuration](../usage/cfg.md) page. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n-seg.yaml') # build a new model from YAML - model = YOLO('yolov8n-seg.pt') # load a pretrained model (recommended for training) - model = YOLO('yolov8n-seg.yaml').load('yolov8n.pt') # build from YAML and transfer weights - - # Train the model - results = model.train(data='coco128-seg.yaml', epochs=100, imgsz=640) - ``` - === "CLI" - - ```bash - # Build a new model from YAML and start training from scratch - yolo segment train data=coco128-seg.yaml model=yolov8n-seg.yaml epochs=100 imgsz=640 - - # Start training from a pretrained *.pt model - yolo segment train data=coco128-seg.yaml model=yolov8n-seg.pt epochs=100 imgsz=640 - - # Build a new model from YAML, transfer pretrained weights to it and start training - yolo segment train data=coco128-seg.yaml model=yolov8n-seg.yaml pretrained=yolov8n-seg.pt epochs=100 imgsz=640 - ``` - -### Dataset format - -YOLO segmentation dataset format can be found in detail in the [Dataset Guide](../datasets/segment/index.md). To convert your existing dataset from other formats (like COCO etc.) to YOLO format, please use [JSON2YOLO](https://github.com/ultralytics/JSON2YOLO) tool by Ultralytics. - -## Val - -Validate trained YOLOv8n-seg model accuracy on the COCO128-seg dataset. No argument need to passed as the `model` -retains it's training `data` and arguments as model attributes. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n-seg.pt') # load an official model - model = YOLO('path/to/best.pt') # load a custom model - - # Validate the model - metrics = model.val() # no arguments needed, dataset and settings remembered - metrics.box.map # map50-95(B) - metrics.box.map50 # map50(B) - metrics.box.map75 # map75(B) - metrics.box.maps # a list contains map50-95(B) of each category - metrics.seg.map # map50-95(M) - metrics.seg.map50 # map50(M) - metrics.seg.map75 # map75(M) - metrics.seg.maps # a list contains map50-95(M) of each category - ``` - === "CLI" - - ```bash - yolo segment val model=yolov8n-seg.pt # val official model - yolo segment val model=path/to/best.pt # val custom model - ``` - -## Predict - -Use a trained YOLOv8n-seg model to run predictions on images. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n-seg.pt') # load an official model - model = YOLO('path/to/best.pt') # load a custom model - - # Predict with the model - results = model('https://ultralytics.com/images/bus.jpg') # predict on an image - ``` - === "CLI" - - ```bash - yolo segment predict model=yolov8n-seg.pt source='https://ultralytics.com/images/bus.jpg' # predict with official model - yolo segment predict model=path/to/best.pt source='https://ultralytics.com/images/bus.jpg' # predict with custom model - ``` - -See full `predict` mode details in the [Predict](https://docs.ultralytics.com/modes/predict/) page. - -## Export - -Export a YOLOv8n-seg model to a different format like ONNX, CoreML, etc. - -!!! Example - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n-seg.pt') # load an official model - model = YOLO('path/to/best.pt') # load a custom trained model - - # Export the model - model.export(format='onnx') - ``` - === "CLI" - - ```bash - yolo export model=yolov8n-seg.pt format=onnx # export official model - yolo export model=path/to/best.pt format=onnx # export custom trained model - ``` - -Available YOLOv8-seg export formats are in the table below. You can predict or validate directly on exported models, i.e. `yolo predict model=yolov8n-seg.onnx`. Usage examples are shown for your model after export completes. - -| Format | `format` Argument | Model | Metadata | Arguments | -|--------------------------------------------------------------------|-------------------|-------------------------------|----------|-----------------------------------------------------| -| [PyTorch](https://pytorch.org/) | - | `yolov8n-seg.pt` | ✅ | - | -| [TorchScript](https://pytorch.org/docs/stable/jit.html) | `torchscript` | `yolov8n-seg.torchscript` | ✅ | `imgsz`, `optimize` | -| [ONNX](https://onnx.ai/) | `onnx` | `yolov8n-seg.onnx` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `opset` | -| [OpenVINO](../integrations/openvino.md) | `openvino` | `yolov8n-seg_openvino_model/` | ✅ | `imgsz`, `half`, `int8` | -| [TensorRT](https://developer.nvidia.com/tensorrt) | `engine` | `yolov8n-seg.engine` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `workspace` | -| [CoreML](https://github.com/apple/coremltools) | `coreml` | `yolov8n-seg.mlpackage` | ✅ | `imgsz`, `half`, `int8`, `nms` | -| [TF SavedModel](https://www.tensorflow.org/guide/saved_model) | `saved_model` | `yolov8n-seg_saved_model/` | ✅ | `imgsz`, `keras` | -| [TF GraphDef](https://www.tensorflow.org/api_docs/python/tf/Graph) | `pb` | `yolov8n-seg.pb` | ❌ | `imgsz` | -| [TF Lite](https://www.tensorflow.org/lite) | `tflite` | `yolov8n-seg.tflite` | ✅ | `imgsz`, `half`, `int8` | -| [TF Edge TPU](https://coral.ai/docs/edgetpu/models-intro/) | `edgetpu` | `yolov8n-seg_edgetpu.tflite` | ✅ | `imgsz` | -| [TF.js](https://www.tensorflow.org/js) | `tfjs` | `yolov8n-seg_web_model/` | ✅ | `imgsz`, `half`, `int8` | -| [PaddlePaddle](https://github.com/PaddlePaddle) | `paddle` | `yolov8n-seg_paddle_model/` | ✅ | `imgsz` | -| [NCNN](https://github.com/Tencent/ncnn) | `ncnn` | `yolov8n-seg_ncnn_model/` | ✅ | `imgsz`, `half` | - -See full `export` details in the [Export](https://docs.ultralytics.com/modes/export/) page. diff --git a/ultralytics-main/docs/en/usage/callbacks.md b/ultralytics-main/docs/en/usage/callbacks.md deleted file mode 100644 index 275492e..0000000 --- a/ultralytics-main/docs/en/usage/callbacks.md +++ /dev/null @@ -1,101 +0,0 @@ ---- -comments: true -description: Learn how to utilize callbacks in the Ultralytics framework during train, val, export, and predict modes for enhanced functionality. -keywords: Ultralytics, YOLO, callbacks guide, training callback, validation callback, export callback, prediction callback ---- - -## Callbacks - -Ultralytics framework supports callbacks as entry points in strategic stages of train, val, export, and predict modes. Each callback accepts a `Trainer`, `Validator`, or `Predictor` object depending on the operation type. All properties of these objects can be found in Reference section of the docs. - -

-
- -
- Watch: Mastering Ultralytics YOLOv8: Callbacks -

- -## Examples - -### Returning additional information with Prediction - -In this example, we want to return the original frame with each result object. Here's how we can do that - -```python -from ultralytics import YOLO - - -def on_predict_batch_end(predictor): - # Retrieve the batch data - _, image, _, _ = predictor.batch - - # Ensure that image is a list - image = image if isinstance(image, list) else [image] - - # Combine the prediction results with the corresponding frames - predictor.results = zip(predictor.results, image) - - -# Create a YOLO model instance -model = YOLO(f'yolov8n.pt') - -# Add the custom callback to the model -model.add_callback("on_predict_batch_end", on_predict_batch_end) - -# Iterate through the results and frames -for (result, frame) in model.predict(): # or model.track() - pass -``` - -## All callbacks - -Here are all supported callbacks. See callbacks [source code](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/base.py) for additional details. - -### Trainer Callbacks - -| Callback | Description | -|-----------------------------|---------------------------------------------------------| -| `on_pretrain_routine_start` | Triggered at the beginning of pre-training routine | -| `on_pretrain_routine_end` | Triggered at the end of pre-training routine | -| `on_train_start` | Triggered when the training starts | -| `on_train_epoch_start` | Triggered at the start of each training epoch | -| `on_train_batch_start` | Triggered at the start of each training batch | -| `optimizer_step` | Triggered during the optimizer step | -| `on_before_zero_grad` | Triggered before gradients are zeroed | -| `on_train_batch_end` | Triggered at the end of each training batch | -| `on_train_epoch_end` | Triggered at the end of each training epoch | -| `on_fit_epoch_end` | Triggered at the end of each fit epoch | -| `on_model_save` | Triggered when the model is saved | -| `on_train_end` | Triggered when the training process ends | -| `on_params_update` | Triggered when model parameters are updated | -| `teardown` | Triggered when the training process is being cleaned up | - -### Validator Callbacks - -| Callback | Description | -|----------------------|-------------------------------------------------| -| `on_val_start` | Triggered when the validation starts | -| `on_val_batch_start` | Triggered at the start of each validation batch | -| `on_val_batch_end` | Triggered at the end of each validation batch | -| `on_val_end` | Triggered when the validation ends | - -### Predictor Callbacks - -| Callback | Description | -|------------------------------|---------------------------------------------------| -| `on_predict_start` | Triggered when the prediction process starts | -| `on_predict_batch_start` | Triggered at the start of each prediction batch | -| `on_predict_postprocess_end` | Triggered at the end of prediction postprocessing | -| `on_predict_batch_end` | Triggered at the end of each prediction batch | -| `on_predict_end` | Triggered when the prediction process ends | - -### Exporter Callbacks - -| Callback | Description | -|-------------------|------------------------------------------| -| `on_export_start` | Triggered when the export process starts | -| `on_export_end` | Triggered when the export process ends | diff --git a/ultralytics-main/docs/en/usage/cfg.md b/ultralytics-main/docs/en/usage/cfg.md deleted file mode 100644 index 4b8b291..0000000 --- a/ultralytics-main/docs/en/usage/cfg.md +++ /dev/null @@ -1,269 +0,0 @@ ---- -comments: true -description: Master YOLOv8 settings and hyperparameters for improved model performance. Learn to use YOLO CLI commands, adjust training settings, and optimize YOLO tasks & modes. -keywords: YOLOv8, settings, hyperparameters, YOLO CLI commands, YOLO tasks, YOLO modes, Ultralytics documentation, model optimization, YOLOv8 training ---- - -YOLO settings and hyperparameters play a critical role in the model's performance, speed, and accuracy. These settings and hyperparameters can affect the model's behavior at various stages of the model development process, including training, validation, and prediction. - -

-
- -
- Watch: Mastering Ultralytics YOLOv8: Configuration -

- -Ultralytics commands use the following syntax: - -!!! Example - - === "CLI" - - ```bash - yolo TASK MODE ARGS - ``` - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a YOLOv8 model from a pre-trained weights file - model = YOLO('yolov8n.pt') - - # Run MODE mode using the custom arguments ARGS (guess TASK) - model.MODE(ARGS) - ``` - -Where: - -- `TASK` (optional) is one of ([detect](../tasks/detect.md), [segment](../tasks/segment.md), [classify](../tasks/classify.md), [pose](../tasks/pose.md)) -- `MODE` (required) is one of ([train](../modes/train.md), [val](../modes/val.md), [predict](../modes/predict.md), [export](../modes/export.md), [track](../modes/track.md)) -- `ARGS` (optional) are `arg=value` pairs like `imgsz=640` that override defaults. - -Default `ARG` values are defined on this page from the `cfg/defaults.yaml` [file](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/default.yaml). - -#### Tasks - -YOLO models can be used for a variety of tasks, including detection, segmentation, classification and pose. These tasks differ in the type of output they produce and the specific problem they are designed to solve. - -- **Detect**: For identifying and localizing objects or regions of interest in an image or video. -- **Segment**: For dividing an image or video into regions or pixels that correspond to different objects or classes. -- **Classify**: For predicting the class label of an input image. -- **Pose**: For identifying objects and estimating their keypoints in an image or video. -- **OBB**: Oriented (i.e. rotated) bounding boxes suitable for satellite or medical imagery. - -| Argument | Default | Description | -|----------|------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `task` | `'detect'` | Specifies the YOLO task to be executed. Options include `detect` for object detection, `segment` for segmentation, `classify` for classification, `pose` for pose estimation and `OBB` for oriented bounding boxes. Each task is tailored to specific types of output and problems within image and video analysis. | - -[Tasks Guide](../tasks/index.md){ .md-button } - -#### Modes - -YOLO models can be used in different modes depending on the specific problem you are trying to solve. These modes include: - -- **Train**: For training a YOLOv8 model on a custom dataset. -- **Val**: For validating a YOLOv8 model after it has been trained. -- **Predict**: For making predictions using a trained YOLOv8 model on new images or videos. -- **Export**: For exporting a YOLOv8 model to a format that can be used for deployment. -- **Track**: For tracking objects in real-time using a YOLOv8 model. -- **Benchmark**: For benchmarking YOLOv8 exports (ONNX, TensorRT, etc.) speed and accuracy. - -| Argument | Default | Description | -|----------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `mode` | `'train'` | Specifies the mode in which the YOLO model operates. Options are `train` for model training, `val` for validation, `predict` for inference on new data, `export` for model conversion to deployment formats, `track` for object tracking, and `benchmark` for performance evaluation. Each mode is designed for different stages of the model lifecycle, from development through deployment. | - -[Modes Guide](../modes/index.md){ .md-button } - -## Train Settings - -The training settings for YOLO models encompass various hyperparameters and configurations used during the training process. These settings influence the model's performance, speed, and accuracy. Key training settings include batch size, learning rate, momentum, and weight decay. Additionally, the choice of optimizer, loss function, and training dataset composition can impact the training process. Careful tuning and experimentation with these settings are crucial for optimizing performance. - -| Argument | Default | Description | -|-------------------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `model` | `None` | Specifies the model file for training. Accepts a path to either a `.pt` pretrained model or a `.yaml` configuration file. Essential for defining the model structure or initializing weights. | -| `data` | `None` | Path to the dataset configuration file (e.g., `coco128.yaml`). This file contains dataset-specific parameters, including paths to training and validation data, class names, and number of classes. | -| `epochs` | `100` | Total number of training epochs. Each epoch represents a full pass over the entire dataset. Adjusting this value can affect training duration and model performance. | -| `time` | `None` | Maximum training time in hours. If set, this overrides the `epochs` argument, allowing training to automatically stop after the specified duration. Useful for time-constrained training scenarios. | -| `patience` | `100` | Number of epochs to wait without improvement in validation metrics before early stopping the training. Helps prevent overfitting by stopping training when performance plateaus. | -| `batch` | `16` | Batch size for training, indicating how many images are processed before the model's internal parameters are updated. AutoBatch (`batch=-1`) dynamically adjusts the batch size based on GPU memory availability. | -| `imgsz` | `640` | Target image size for training. All images are resized to this dimension before being fed into the model. Affects model accuracy and computational complexity. | -| `save` | `True` | Enables saving of training checkpoints and final model weights. Useful for resuming training or model deployment. | -| `save_period` | `-1` | Frequency of saving model checkpoints, specified in epochs. A value of -1 disables this feature. Useful for saving interim models during long training sessions. | -| `cache` | `False` | Enables caching of dataset images in memory (`True`/`ram`), on disk (`disk`), or disables it (`False`). Improves training speed by reducing disk I/O at the cost of increased memory usage. | -| `device` | `None` | Specifies the computational device(s) for training: a single GPU (`device=0`), multiple GPUs (`device=0,1`), CPU (`device=cpu`), or MPS for Apple silicon (`device=mps`). | -| `workers` | `8` | Number of worker threads for data loading (per `RANK` if Multi-GPU training). Influences the speed of data preprocessing and feeding into the model, especially useful in multi-GPU setups. | -| `project` | `None` | Name of the project directory where training outputs are saved. Allows for organized storage of different experiments. | -| `name` | `None` | Name of the training run. Used for creating a subdirectory within the project folder, where training logs and outputs are stored. | -| `exist_ok` | `False` | If True, allows overwriting of an existing project/name directory. Useful for iterative experimentation without needing to manually clear previous outputs. | -| `pretrained` | `True` | Determines whether to start training from a pretrained model. Can be a boolean value or a string path to a specific model from which to load weights. Enhances training efficiency and model performance. | -| `optimizer` | `'auto'` | Choice of optimizer for training. Options include `SGD`, `Adam`, `AdamW`, `NAdam`, `RAdam`, `RMSProp` etc., or `auto` for automatic selection based on model configuration. Affects convergence speed and stability. | -| `verbose` | `False` | Enables verbose output during training, providing detailed logs and progress updates. Useful for debugging and closely monitoring the training process. | -| `seed` | `0` | Sets the random seed for training, ensuring reproducibility of results across runs with the same configurations. | -| `deterministic` | `True` | Forces deterministic algorithm use, ensuring reproducibility but may affect performance and speed due to the restriction on non-deterministic algorithms. | -| `single_cls` | `False` | Treats all classes in multi-class datasets as a single class during training. Useful for binary classification tasks or when focusing on object presence rather than classification. | -| `rect` | `False` | Enables rectangular training, optimizing batch composition for minimal padding. Can improve efficiency and speed but may affect model accuracy. | -| `cos_lr` | `False` | Utilizes a cosine learning rate scheduler, adjusting the learning rate following a cosine curve over epochs. Helps in managing learning rate for better convergence. | -| `close_mosaic` | `10` | Disables mosaic data augmentation in the last N epochs to stabilize training before completion. Setting to 0 disables this feature. | -| `resume` | `False` | Resumes training from the last saved checkpoint. Automatically loads model weights, optimizer state, and epoch count, continuing training seamlessly. | -| `amp` | `True` | Enables Automatic Mixed Precision (AMP) training, reducing memory usage and possibly speeding up training with minimal impact on accuracy. | -| `fraction` | `1.0` | Specifies the fraction of the dataset to use for training. Allows for training on a subset of the full dataset, useful for experiments or when resources are limited. | -| `profile` | `False` | Enables profiling of ONNX and TensorRT speeds during training, useful for optimizing model deployment. | -| `freeze` | `None` | Freezes the first N layers of the model or specified layers by index, reducing the number of trainable parameters. Useful for fine-tuning or transfer learning. | -| `lr0` | `0.01` | Initial learning rate (i.e. `SGD=1E-2`, `Adam=1E-3`) . Adjusting this value is crucial for the optimization process, influencing how rapidly model weights are updated. | -| `lrf` | `0.01` | Final learning rate as a fraction of the initial rate = (`lr0 * lrf`), used in conjunction with schedulers to adjust the learning rate over time. | -| `momentum` | `0.937` | Momentum factor for SGD or beta1 for Adam optimizers, influencing the incorporation of past gradients in the current update. | -| `weight_decay` | `0.0005` | L2 regularization term, penalizing large weights to prevent overfitting. | -| `warmup_epochs` | `3.0` | Number of epochs for learning rate warmup, gradually increasing the learning rate from a low value to the initial learning rate to stabilize training early on. | -| `warmup_momentum` | `0.8` | Initial momentum for warmup phase, gradually adjusting to the set momentum over the warmup period. | -| `warmup_bias_lr` | `0.1` | Learning rate for bias parameters during the warmup phase, helping stabilize model training in the initial epochs. | -| `box` | `7.5` | Weight of the box loss component in the loss function, influencing how much emphasis is placed on accurately predicting bounding box coordinates. | -| `cls` | `0.5` | Weight of the classification loss in the total loss function, affecting the importance of correct class prediction relative to other components. | -| `dfl` | `1.5` | Weight of the distribution focal loss, used in certain YOLO versions for fine-grained classification. | -| `pose` | `12.0` | Weight of the pose loss in models trained for pose estimation, influencing the emphasis on accurately predicting pose keypoints. | -| `kobj` | `2.0` | Weight of the keypoint objectness loss in pose estimation models, balancing detection confidence with pose accuracy. | -| `label_smoothing` | `0.0` | Applies label smoothing, softening hard labels to a mix of the target label and a uniform distribution over labels, can improve generalization. | -| `nbs` | `64` | Nominal batch size for normalization of loss. | -| `overlap_mask` | `True` | Determines whether segmentation masks should overlap during training, applicable in instance segmentation tasks. | -| `mask_ratio` | `4` | Downsample ratio for segmentation masks, affecting the resolution of masks used during training. | -| `dropout` | `0.0` | Dropout rate for regularization in classification tasks, preventing overfitting by randomly omitting units during training. | -| `val` | `True` | Enables validation during training, allowing for periodic evaluation of model performance on a separate dataset. | -| `plots` | `False` | Generates and saves plots of training and validation metrics, as well as prediction examples, providing visual insights into model performance and learning progression. | - -[Train Guide](../modes/train.md){ .md-button } - -## Predict Settings - -The prediction settings for YOLO models encompass a range of hyperparameters and configurations that influence the model's performance, speed, and accuracy during inference on new data. Careful tuning and experimentation with these settings are essential to achieve optimal performance for a specific task. Key settings include the confidence threshold, Non-Maximum Suppression (NMS) threshold, and the number of classes considered. Additional factors affecting the prediction process are input data size and format, the presence of supplementary features such as masks or multiple labels per box, and the particular task the model is employed for. - -Inference arguments: - -| Argument | Type | Default | Description | -|-----------------|----------------|------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `source` | `str` | `'ultralytics/assets'` | Specifies the data source for inference. Can be an image path, video file, directory, URL, or device ID for live feeds. Supports a wide range of formats and sources, enabling flexible application across different types of input. | -| `conf` | `float` | `0.25` | Sets the minimum confidence threshold for detections. Objects detected with confidence below this threshold will be disregarded. Adjusting this value can help reduce false positives. | -| `iou` | `float` | `0.7` | Intersection Over Union (IoU) threshold for Non-Maximum Suppression (NMS). Higher values result in fewer detections by eliminating overlapping boxes, useful for reducing duplicates. | -| `imgsz` | `int or tuple` | `640` | Defines the image size for inference. Can be a single integer `640` for square resizing or a (height, width) tuple. Proper sizing can improve detection accuracy and processing speed. | -| `half` | `bool` | `False` | Enables half-precision (FP16) inference, which can speed up model inference on supported GPUs with minimal impact on accuracy. | -| `device` | `str` | `None` | Specifies the device for inference (e.g., `cpu`, `cuda:0` or `0`). Allows users to select between CPU, a specific GPU, or other compute devices for model execution. | -| `max_det` | `int` | `300` | Maximum number of detections allowed per image. Limits the total number of objects the model can detect in a single inference, preventing excessive outputs in dense scenes. | -| `vid_stride` | `int` | `1` | Frame stride for video inputs. Allows skipping frames in videos to speed up processing at the cost of temporal resolution. A value of 1 processes every frame, higher values skip frames. | -| `stream_buffer` | `bool` | `False` | Determines if all frames should be buffered when processing video streams (`True`), or if the model should return the most recent frame (`False`). Useful for real-time applications. | -| `visualize` | `bool` | `False` | Activates visualization of model features during inference, providing insights into what the model is "seeing". Useful for debugging and model interpretation. | -| `augment` | `bool` | `False` | Enables test-time augmentation (TTA) for predictions, potentially improving detection robustness at the cost of inference speed. | -| `agnostic_nms` | `bool` | `False` | Enables class-agnostic Non-Maximum Suppression (NMS), which merges overlapping boxes of different classes. Useful in multi-class detection scenarios where class overlap is common. | -| `classes` | `list[int]` | `None` | Filters predictions to a set of class IDs. Only detections belonging to the specified classes will be returned. Useful for focusing on relevant objects in multi-class detection tasks. | -| `retina_masks` | `bool` | `False` | Uses high-resolution segmentation masks if available in the model. This can enhance mask quality for segmentation tasks, providing finer detail. | -| `embed` | `list[int]` | `None` | Specifies the layers from which to extract feature vectors or embeddings. Useful for downstream tasks like clustering or similarity search. | - -Visualization arguments: - -| Argument | Type | Default | Description | -|---------------|---------------|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `show` | `bool` | `False` | If `True`, displays the annotated images or videos in a window. Useful for immediate visual feedback during development or testing. | -| `save` | `bool` | `False` | Enables saving of the annotated images or videos to file. Useful for documentation, further analysis, or sharing results. | -| `save_frames` | `bool` | `False` | When processing videos, saves individual frames as images. Useful for extracting specific frames or for detailed frame-by-frame analysis. | -| `save_txt` | `bool` | `False` | Saves detection results in a text file, following the format `[class] [x_center] [y_center] [width] [height] [confidence]`. Useful for integration with other analysis tools. | -| `save_conf` | `bool` | `False` | Includes confidence scores in the saved text files. Enhances the detail available for post-processing and analysis. | -| `save_crop` | `bool` | `False` | Saves cropped images of detections. Useful for dataset augmentation, analysis, or creating focused datasets for specific objects. | -| `show_labels` | `bool` | `True` | Displays labels for each detection in the visual output. Provides immediate understanding of detected objects. | -| `show_conf` | `bool` | `True` | Displays the confidence score for each detection alongside the label. Gives insight into the model's certainty for each detection. | -| `show_boxes` | `bool` | `True` | Draws bounding boxes around detected objects. Essential for visual identification and location of objects in images or video frames. | -| `line_width` | `None or int` | `None` | Specifies the line width of bounding boxes. If `None`, the line width is automatically adjusted based on the image size. Provides visual customization for clarity. | - -[Predict Guide](../modes/predict.md){ .md-button } - -## Validation Settings - -The val (validation) settings for YOLO models involve various hyperparameters and configurations used to evaluate the model's performance on a validation dataset. These settings influence the model's performance, speed, and accuracy. Common YOLO validation settings include batch size, validation frequency during training, and performance evaluation metrics. Other factors affecting the validation process include the validation dataset's size and composition, as well as the specific task the model is employed for. - -| Argument | Type | Default | Description | -|---------------|---------|---------|---------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `data` | `str` | `None` | Specifies the path to the dataset configuration file (e.g., `coco128.yaml`). This file includes paths to validation data, class names, and number of classes. | -| `imgsz` | `int` | `640` | Defines the size of input images. All images are resized to this dimension before processing. | -| `batch` | `int` | `16` | Sets the number of images per batch. Use `-1` for AutoBatch, which automatically adjusts based on GPU memory availability. | -| `save_json` | `bool` | `False` | If `True`, saves the results to a JSON file for further analysis or integration with other tools. | -| `save_hybrid` | `bool` | `False` | If `True`, saves a hybrid version of labels that combines original annotations with additional model predictions. | -| `conf` | `float` | `0.001` | Sets the minimum confidence threshold for detections. Detections with confidence below this threshold are discarded. | -| `iou` | `float` | `0.6` | Sets the Intersection Over Union (IoU) threshold for Non-Maximum Suppression (NMS). Helps in reducing duplicate detections. | -| `max_det` | `int` | `300` | Limits the maximum number of detections per image. Useful in dense scenes to prevent excessive detections. | -| `half` | `bool` | `True` | Enables half-precision (FP16) computation, reducing memory usage and potentially increasing speed with minimal impact on accuracy. | -| `device` | `str` | `None` | Specifies the device for validation (`cpu`, `cuda:0`, etc.). Allows flexibility in utilizing CPU or GPU resources. | -| `dnn` | `bool` | `False` | If `True`, uses the OpenCV DNN module for ONNX model inference, offering an alternative to PyTorch inference methods. | -| `plots` | `bool` | `False` | When set to `True`, generates and saves plots of predictions versus ground truth for visual evaluation of the model's performance. | -| `rect` | `bool` | `False` | If `True`, uses rectangular inference for batching, reducing padding and potentially increasing speed and efficiency. | -| `split` | `str` | `val` | Determines the dataset split to use for validation (`val`, `test`, or `train`). Allows flexibility in choosing the data segment for performance evaluation. | - -Careful tuning and experimentation with these settings are crucial to ensure optimal performance on the validation dataset and detect and prevent overfitting. - -[Val Guide](../modes/val.md){ .md-button } - -## Export Settings - -Export settings for YOLO models encompass configurations and options related to saving or exporting the model for use in different environments or platforms. These settings can impact the model's performance, size, and compatibility with various systems. Key export settings include the exported model file format (e.g., ONNX, TensorFlow SavedModel), the target device (e.g., CPU, GPU), and additional features such as masks or multiple labels per box. The export process may also be affected by the model's specific task and the requirements or constraints of the destination environment or platform. - -| Argument | Type | Default | Description | -|-------------|------------------|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `format` | `str` | `'torchscript'` | Target format for the exported model, such as `'onnx'`, `'torchscript'`, `'tensorflow'`, or others, defining compatibility with various deployment environments. | -| `imgsz` | `int` or `tuple` | `640` | Desired image size for the model input. Can be an integer for square images or a tuple `(height, width)` for specific dimensions. | -| `keras` | `bool` | `False` | Enables export to Keras format for TensorFlow SavedModel, providing compatibility with TensorFlow serving and APIs. | -| `optimize` | `bool` | `False` | Applies optimization for mobile devices when exporting to TorchScript, potentially reducing model size and improving performance. | -| `half` | `bool` | `False` | Enables FP16 (half-precision) quantization, reducing model size and potentially speeding up inference on supported hardware. | -| `int8` | `bool` | `False` | Activates INT8 quantization, further compressing the model and speeding up inference with minimal accuracy loss, primarily for edge devices. | -| `dynamic` | `bool` | `False` | Allows dynamic input sizes for ONNX and TensorRT exports, enhancing flexibility in handling varying image dimensions. | -| `simplify` | `bool` | `False` | Simplifies the model graph for ONNX exports, potentially improving performance and compatibility. | -| `opset` | `int` | `None` | Specifies the ONNX opset version for compatibility with different ONNX parsers and runtimes. If not set, uses the latest supported version. | -| `workspace` | `float` | `4.0` | Sets the maximum workspace size in GB for TensorRT optimizations, balancing memory usage and performance. | -| `nms` | `bool` | `False` | Adds Non-Maximum Suppression (NMS) to the CoreML export, essential for accurate and efficient detection post-processing. | - -It is crucial to thoughtfully configure these settings to ensure the exported model is optimized for the intended use case and functions effectively in the target environment. - -[Export Guide](../modes/export.md){ .md-button } - -## Augmentation Settings - -Augmentation techniques are essential for improving the robustness and performance of YOLO models by introducing variability into the training data, helping the model generalize better to unseen data. The following table outlines the purpose and effect of each augmentation argument: - -| Argument | Type | Default | Range | Description | -|----------------|---------|---------------|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `hsv_h` | `float` | `0.015` | `0.0 - 1.0` | Adjusts the hue of the image by a fraction of the color wheel, introducing color variability. Helps the model generalize across different lighting conditions. | -| `hsv_s` | `float` | `0.7` | `0.0 - 1.0` | Alters the saturation of the image by a fraction, affecting the intensity of colors. Useful for simulating different environmental conditions. | -| `hsv_v` | `float` | `0.4` | `0.0 - 1.0` | Modifies the value (brightness) of the image by a fraction, helping the model to perform well under various lighting conditions. | -| `degrees` | `float` | `0.0` | `-180 - +180` | Rotates the image randomly within the specified degree range, improving the model's ability to recognize objects at various orientations. | -| `translate` | `float` | `0.1` | `0.0 - 1.0` | Translates the image horizontally and vertically by a fraction of the image size, aiding in learning to detect partially visible objects. | -| `scale` | `float` | `0.5` | `>=0.0` | Scales the image by a gain factor, simulating objects at different distances from the camera. | -| `shear` | `float` | `0.0` | `-180 - +180` | Shears the image by a specified degree, mimicking the effect of objects being viewed from different angles. | -| `perspective` | `float` | `0.0` | `0.0 - 0.001` | Applies a random perspective transformation to the image, enhancing the model's ability to understand objects in 3D space. | -| `flipud` | `float` | `0.0` | `0.0 - 1.0` | Flips the image upside down with the specified probability, increasing the data variability without affecting the object's characteristics. | -| `fliplr` | `float` | `0.5` | `0.0 - 1.0` | Flips the image left to right with the specified probability, useful for learning symmetrical objects and increasing dataset diversity. | -| `mosaic` | `float` | `1.0` | `0.0 - 1.0` | Combines four training images into one, simulating different scene compositions and object interactions. Highly effective for complex scene understanding. | -| `mixup` | `float` | `0.0` | `0.0 - 1.0` | Blends two images and their labels, creating a composite image. Enhances the model's ability to generalize by introducing label noise and visual variability. | -| `copy_paste` | `float` | `0.0` | `0.0 - 1.0` | Copies objects from one image and pastes them onto another, useful for increasing object instances and learning object occlusion. | -| `auto_augment` | `str` | `randaugment` | - | Automatically applies a predefined augmentation policy (`randaugment`, `autoaugment`, `augmix`), optimizing for classification tasks by diversifying the visual features. | -| `erasing` | `float` | `0.4` | `0.0 - 1.0` | Randomly erases a portion of the image during classification training, encouraging the model to focus on less obvious features for recognition. | - -These settings can be adjusted to meet the specific requirements of the dataset and task at hand. Experimenting with different values can help find the optimal augmentation strategy that leads to the best model performance. - -## Logging, Checkpoints and Plotting Settings - -Logging, checkpoints, plotting, and file management are important considerations when training a YOLO model. - -- Logging: It is often helpful to log various metrics and statistics during training to track the model's progress and diagnose any issues that may arise. This can be done using a logging library such as TensorBoard or by writing log messages to a file. -- Checkpoints: It is a good practice to save checkpoints of the model at regular intervals during training. This allows you to resume training from a previous point if the training process is interrupted or if you want to experiment with different training configurations. -- Plotting: Visualizing the model's performance and training progress can be helpful for understanding how the model is behaving and identifying potential issues. This can be done using a plotting library such as matplotlib or by generating plots using a logging library such as TensorBoard. -- File management: Managing the various files generated during the training process, such as model checkpoints, log files, and plots, can be challenging. It is important to have a clear and organized file structure to keep track of these files and make it easy to access and analyze them as needed. - -Effective logging, checkpointing, plotting, and file management can help you keep track of the model's progress and make it easier to debug and optimize the training process. - -| Argument | Default | Description | -|------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `project` | `'runs'` | Specifies the root directory for saving training runs. Each run will be saved in a separate subdirectory within this directory. | -| `name` | `'exp'` | Defines the name of the experiment. If not specified, YOLO automatically increments this name for each run, e.g., `exp`, `exp2`, etc., to avoid overwriting previous experiments. | -| `exist_ok` | `False` | Determines whether to overwrite an existing experiment directory if one with the same name already exists. Setting this to `True` allows overwriting, while `False` prevents it. | -| `plots` | `False` | Controls the generation and saving of training and validation plots. Set to `True` to create plots such as loss curves, precision-recall curves, and sample predictions. Useful for visually tracking model performance over time. | -| `save` | `False` | Enables the saving of training checkpoints and final model weights. Set to `True` to periodically save model states, allowing training to be resumed from these checkpoints or models to be deployed. | diff --git a/ultralytics-main/docs/en/usage/cli.md b/ultralytics-main/docs/en/usage/cli.md deleted file mode 100644 index c71d7d0..0000000 --- a/ultralytics-main/docs/en/usage/cli.md +++ /dev/null @@ -1,231 +0,0 @@ ---- -comments: true -description: Learn how to use Ultralytics YOLO through Command Line, train models, run predictions and exports models to different formats easily using terminal commands. -keywords: Ultralytics, YOLO, CLI, train, validation, prediction, command line interface, YOLO CLI, YOLO terminal, model training, prediction, exporting ---- - -# Command Line Interface Usage - -The YOLO command line interface (CLI) allows for simple single-line commands without the need for a Python environment. CLI requires no customization or Python code. You can simply run all tasks from the terminal with the `yolo` command. - -

-
- -
- Watch: Mastering Ultralytics YOLOv8: CLI -

- -!!! Example - - === "Syntax" - - Ultralytics `yolo` commands use the following syntax: - ```bash - yolo TASK MODE ARGS - - Where TASK (optional) is one of [detect, segment, classify] - MODE (required) is one of [train, val, predict, export, track] - ARGS (optional) are any number of custom 'arg=value' pairs like 'imgsz=320' that override defaults. - ``` - See all ARGS in the full [Configuration Guide](cfg.md) or with `yolo cfg` - - === "Train" - - Train a detection model for 10 epochs with an initial learning_rate of 0.01 - ```bash - yolo train data=coco128.yaml model=yolov8n.pt epochs=10 lr0=0.01 - ``` - - === "Predict" - - Predict a YouTube video using a pretrained segmentation model at image size 320: - ```bash - yolo predict model=yolov8n-seg.pt source='https://youtu.be/LNwODJXcvt4' imgsz=320 - ``` - - === "Val" - - Val a pretrained detection model at batch-size 1 and image size 640: - ```bash - yolo val model=yolov8n.pt data=coco128.yaml batch=1 imgsz=640 - ``` - - === "Export" - - Export a YOLOv8n classification model to ONNX format at image size 224 by 128 (no TASK required) - ```bash - yolo export model=yolov8n-cls.pt format=onnx imgsz=224,128 - ``` - - === "Special" - - Run special commands to see version, view settings, run checks and more: - ```bash - yolo help - yolo checks - yolo version - yolo settings - yolo copy-cfg - yolo cfg - ``` - -Where: - -- `TASK` (optional) is one of `[detect, segment, classify]`. If it is not passed explicitly YOLOv8 will try to guess the `TASK` from the model type. -- `MODE` (required) is one of `[train, val, predict, export, track]` -- `ARGS` (optional) are any number of custom `arg=value` pairs like `imgsz=320` that override defaults. For a full list of available `ARGS` see the [Configuration](cfg.md) page and `defaults.yaml` - GitHub [source](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/default.yaml). - -!!! Warning "Warning" - - Arguments must be passed as `arg=val` pairs, split by an equals `=` sign and delimited by spaces ` ` between pairs. Do not use `--` argument prefixes or commas `,` between arguments. - - - `yolo predict model=yolov8n.pt imgsz=640 conf=0.25`   ✅ - - `yolo predict model yolov8n.pt imgsz 640 conf 0.25`   ❌ - - `yolo predict --model yolov8n.pt --imgsz 640 --conf 0.25`   ❌ - -## Train - -Train YOLOv8n on the COCO128 dataset for 100 epochs at image size 640. For a full list of available arguments see the [Configuration](cfg.md) page. - -!!! Example "Example" - - === "Train" - - Start training YOLOv8n on COCO128 for 100 epochs at image-size 640. - ```bash - yolo detect train data=coco128.yaml model=yolov8n.pt epochs=100 imgsz=640 - ``` - - === "Resume" - - Resume an interrupted training. - ```bash - yolo detect train resume model=last.pt - ``` - -## Val - -Validate trained YOLOv8n model accuracy on the COCO128 dataset. No argument need to passed as the `model` retains it's training `data` and arguments as model attributes. - -!!! Example "Example" - - === "Official" - - Validate an official YOLOv8n model. - ```bash - yolo detect val model=yolov8n.pt - ``` - - === "Custom" - - Validate a custom-trained model. - ```bash - yolo detect val model=path/to/best.pt - ``` - -## Predict - -Use a trained YOLOv8n model to run predictions on images. - -!!! Example "Example" - - === "Official" - - Predict with an official YOLOv8n model. - ```bash - yolo detect predict model=yolov8n.pt source='https://ultralytics.com/images/bus.jpg' - ``` - - === "Custom" - - Predict with a custom model. - ```bash - yolo detect predict model=path/to/best.pt source='https://ultralytics.com/images/bus.jpg' - ``` - -## Export - -Export a YOLOv8n model to a different format like ONNX, CoreML, etc. - -!!! Example "Example" - - === "Official" - - Export an official YOLOv8n model to ONNX format. - ```bash - yolo export model=yolov8n.pt format=onnx - ``` - - === "Custom" - - Export a custom-trained model to ONNX format. - ```bash - yolo export model=path/to/best.pt format=onnx - ``` - -Available YOLOv8 export formats are in the table below. You can export to any format using the `format` argument, i.e. `format='onnx'` or `format='engine'`. - -| Format | `format` Argument | Model | Metadata | Arguments | -|--------------------------------------------------------------------|-------------------|---------------------------|----------|-----------------------------------------------------| -| [PyTorch](https://pytorch.org/) | - | `yolov8n.pt` | ✅ | - | -| [TorchScript](https://pytorch.org/docs/stable/jit.html) | `torchscript` | `yolov8n.torchscript` | ✅ | `imgsz`, `optimize` | -| [ONNX](https://onnx.ai/) | `onnx` | `yolov8n.onnx` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `opset` | -| [OpenVINO](../integrations/openvino.md) | `openvino` | `yolov8n_openvino_model/` | ✅ | `imgsz`, `half`, `int8` | -| [TensorRT](https://developer.nvidia.com/tensorrt) | `engine` | `yolov8n.engine` | ✅ | `imgsz`, `half`, `dynamic`, `simplify`, `workspace` | -| [CoreML](https://github.com/apple/coremltools) | `coreml` | `yolov8n.mlpackage` | ✅ | `imgsz`, `half`, `int8`, `nms` | -| [TF SavedModel](https://www.tensorflow.org/guide/saved_model) | `saved_model` | `yolov8n_saved_model/` | ✅ | `imgsz`, `keras`, `int8` | -| [TF GraphDef](https://www.tensorflow.org/api_docs/python/tf/Graph) | `pb` | `yolov8n.pb` | ❌ | `imgsz` | -| [TF Lite](https://www.tensorflow.org/lite) | `tflite` | `yolov8n.tflite` | ✅ | `imgsz`, `half`, `int8` | -| [TF Edge TPU](https://coral.ai/docs/edgetpu/models-intro/) | `edgetpu` | `yolov8n_edgetpu.tflite` | ✅ | `imgsz` | -| [TF.js](https://www.tensorflow.org/js) | `tfjs` | `yolov8n_web_model/` | ✅ | `imgsz`, `half`, `int8` | -| [PaddlePaddle](https://github.com/PaddlePaddle) | `paddle` | `yolov8n_paddle_model/` | ✅ | `imgsz` | -| [NCNN](https://github.com/Tencent/ncnn) | `ncnn` | `yolov8n_ncnn_model/` | ✅ | `imgsz`, `half` | - -## Overriding default arguments - -Default arguments can be overridden by simply passing them as arguments in the CLI in `arg=value` pairs. - -!!! Tip "" - - === "Train" - - Train a detection model for `10 epochs` with `learning_rate` of `0.01` - ```bash - yolo detect train data=coco128.yaml model=yolov8n.pt epochs=10 lr0=0.01 - ``` - - === "Predict" - - Predict a YouTube video using a pretrained segmentation model at image size 320: - ```bash - yolo segment predict model=yolov8n-seg.pt source='https://youtu.be/LNwODJXcvt4' imgsz=320 - ``` - - === "Val" - - Validate a pretrained detection model at batch-size 1 and image size 640: - ```bash - yolo detect val model=yolov8n.pt data=coco128.yaml batch=1 imgsz=640 - ``` - -## Overriding default config file - -You can override the `default.yaml` config file entirely by passing a new file with the `cfg` arguments, i.e. `cfg=custom.yaml`. - -To do this first create a copy of `default.yaml` in your current working dir with the `yolo copy-cfg` command. - -This will create `default_copy.yaml`, which you can then pass as `cfg=default_copy.yaml` along with any additional args, like `imgsz=320` in this example: - -!!! Example - - === "CLI" - - ```bash - yolo copy-cfg - yolo cfg=default_copy.yaml imgsz=320 - ``` diff --git a/ultralytics-main/docs/en/usage/engine.md b/ultralytics-main/docs/en/usage/engine.md deleted file mode 100644 index 7d6964e..0000000 --- a/ultralytics-main/docs/en/usage/engine.md +++ /dev/null @@ -1,91 +0,0 @@ ---- -comments: true -description: Discover how to customize and extend base Ultralytics YOLO Trainer engines. Support your custom model and dataloader by overriding built-in functions. -keywords: Ultralytics, YOLO, trainer engines, BaseTrainer, DetectionTrainer, customizing trainers, extending trainers, custom model, custom dataloader ---- - -Both the Ultralytics YOLO command-line and Python interfaces are simply a high-level abstraction on the base engine executors. Let's take a look at the Trainer engine. - -

-
- -
- Watch: Mastering Ultralytics YOLOv8: Advanced Customization -

- -## BaseTrainer - -BaseTrainer contains the generic boilerplate training routine. It can be customized for any task based over overriding the required functions or operations as long the as correct formats are followed. For example, you can support your own custom model and dataloader by just overriding these functions: - -- `get_model(cfg, weights)` - The function that builds the model to be trained -- `get_dataloader()` - The function that builds the dataloader More details and source code can be found in [`BaseTrainer` Reference](../reference/engine/trainer.md) - -## DetectionTrainer - -Here's how you can use the YOLOv8 `DetectionTrainer` and customize it. - -```python -from ultralytics.models.yolo.detect import DetectionTrainer - -trainer = DetectionTrainer(overrides={...}) -trainer.train() -trained_model = trainer.best # get best model -``` - -### Customizing the DetectionTrainer - -Let's customize the trainer **to train a custom detection model** that is not supported directly. You can do this by simply overloading the existing the `get_model` functionality: - -```python -from ultralytics.models.yolo.detect import DetectionTrainer - - -class CustomTrainer(DetectionTrainer): - def get_model(self, cfg, weights): - ... - - -trainer = CustomTrainer(overrides={...}) -trainer.train() -``` - -You now realize that you need to customize the trainer further to: - -- Customize the `loss function`. -- Add `callback` that uploads model to your Google Drive after every 10 `epochs` Here's how you can do it: - -```python -from ultralytics.models.yolo.detect import DetectionTrainer -from ultralytics.nn.tasks import DetectionModel - - -class MyCustomModel(DetectionModel): - def init_criterion(self): - ... - - -class CustomTrainer(DetectionTrainer): - def get_model(self, cfg, weights): - return MyCustomModel(...) - - -# callback to upload model weights -def log_model(trainer): - last_weight_path = trainer.last - print(last_weight_path) - - -trainer = CustomTrainer(overrides={...}) -trainer.add_callback("on_train_epoch_end", log_model) # Adds to existing callback -trainer.train() -``` - -To know more about Callback triggering events and entry point, checkout our [Callbacks Guide](callbacks.md) - -## Other engine components - -There are other components that can be customized similarly like `Validators` and `Predictors`. See Reference section for more information on these. diff --git a/ultralytics-main/docs/en/usage/python.md b/ultralytics-main/docs/en/usage/python.md deleted file mode 100644 index db4fd2e..0000000 --- a/ultralytics-main/docs/en/usage/python.md +++ /dev/null @@ -1,325 +0,0 @@ ---- -comments: true -description: Boost your Python projects with object detection, segmentation and classification using YOLOv8. Explore how to load, train, validate, predict, export, track and benchmark models with ease. -keywords: YOLOv8, Ultralytics, Python, object detection, segmentation, classification, model training, validation, prediction, model export, benchmark, real-time tracking ---- - -# Python Usage - -Welcome to the YOLOv8 Python Usage documentation! This guide is designed to help you seamlessly integrate YOLOv8 into your Python projects for object detection, segmentation, and classification. Here, you'll learn how to load and use pretrained models, train new models, and perform predictions on images. The easy-to-use Python interface is a valuable resource for anyone looking to incorporate YOLOv8 into their Python projects, allowing you to quickly implement advanced object detection capabilities. Let's get started! - -

-
- -
- Watch: Mastering Ultralytics YOLOv8: Python -

- -For example, users can load a model, train it, evaluate its performance on a validation set, and even export it to ONNX format with just a few lines of code. - -!!! Example "Python" - - ```python - from ultralytics import YOLO - - # Create a new YOLO model from scratch - model = YOLO('yolov8n.yaml') - - # Load a pretrained YOLO model (recommended for training) - model = YOLO('yolov8n.pt') - - # Train the model using the 'coco128.yaml' dataset for 3 epochs - results = model.train(data='coco128.yaml', epochs=3) - - # Evaluate the model's performance on the validation set - results = model.val() - - # Perform object detection on an image using the model - results = model('https://ultralytics.com/images/bus.jpg') - - # Export the model to ONNX format - success = model.export(format='onnx') - ``` - -## [Train](../modes/train.md) - -Train mode is used for training a YOLOv8 model on a custom dataset. In this mode, the model is trained using the specified dataset and hyperparameters. The training process involves optimizing the model's parameters so that it can accurately predict the classes and locations of objects in an image. - -!!! Example "Train" - - === "From pretrained(recommended)" - - ```python - from ultralytics import YOLO - - model = YOLO('yolov8n.pt') # pass any model type - results = model.train(epochs=5) - ``` - - === "From scratch" - - ```python - from ultralytics import YOLO - - model = YOLO('yolov8n.yaml') - results = model.train(data='coco128.yaml', epochs=5) - ``` - - === "Resume" - - ```python - model = YOLO("last.pt") - results = model.train(resume=True) - ``` - -[Train Examples](../modes/train.md){ .md-button } - -## [Val](../modes/val.md) - -Val mode is used for validating a YOLOv8 model after it has been trained. In this mode, the model is evaluated on a validation set to measure its accuracy and generalization performance. This mode can be used to tune the hyperparameters of the model to improve its performance. - -!!! Example "Val" - - === "Val after training" - - ```python - from ultralytics import YOLO - - model = YOLO('yolov8n.yaml') - model.train(data='coco128.yaml', epochs=5) - model.val() # It'll automatically evaluate the data you trained. - ``` - - === "Val independently" - - ```python - from ultralytics import YOLO - - model = YOLO("model.pt") - # It'll use the data YAML file in model.pt if you don't set data. - model.val() - # or you can set the data you want to val - model.val(data='coco128.yaml') - ``` - -[Val Examples](../modes/val.md){ .md-button } - -## [Predict](../modes/predict.md) - -Predict mode is used for making predictions using a trained YOLOv8 model on new images or videos. In this mode, the model is loaded from a checkpoint file, and the user can provide images or videos to perform inference. The model predicts the classes and locations of objects in the input images or videos. - -!!! Example "Predict" - - === "From source" - - ```python - from ultralytics import YOLO - from PIL import Image - import cv2 - - model = YOLO("model.pt") - # accepts all formats - image/dir/Path/URL/video/PIL/ndarray. 0 for webcam - results = model.predict(source="0") - results = model.predict(source="folder", show=True) # Display preds. Accepts all YOLO predict arguments - - # from PIL - im1 = Image.open("bus.jpg") - results = model.predict(source=im1, save=True) # save plotted images - - # from ndarray - im2 = cv2.imread("bus.jpg") - results = model.predict(source=im2, save=True, save_txt=True) # save predictions as labels - - # from list of PIL/ndarray - results = model.predict(source=[im1, im2]) - ``` - - === "Results usage" - - ```python - # results would be a list of Results object including all the predictions by default - # but be careful as it could occupy a lot memory when there're many images, - # especially the task is segmentation. - # 1. return as a list - results = model.predict(source="folder") - - # results would be a generator which is more friendly to memory by setting stream=True - # 2. return as a generator - results = model.predict(source=0, stream=True) - - for result in results: - # Detection - result.boxes.xyxy # box with xyxy format, (N, 4) - result.boxes.xywh # box with xywh format, (N, 4) - result.boxes.xyxyn # box with xyxy format but normalized, (N, 4) - result.boxes.xywhn # box with xywh format but normalized, (N, 4) - result.boxes.conf # confidence score, (N, 1) - result.boxes.cls # cls, (N, 1) - - # Segmentation - result.masks.data # masks, (N, H, W) - result.masks.xy # x,y segments (pixels), List[segment] * N - result.masks.xyn # x,y segments (normalized), List[segment] * N - - # Classification - result.probs # cls prob, (num_class, ) - - # Each result is composed of torch.Tensor by default, - # in which you can easily use following functionality: - result = result.cuda() - result = result.cpu() - result = result.to("cpu") - result = result.numpy() - ``` - -[Predict Examples](../modes/predict.md){ .md-button } - -## [Export](../modes/export.md) - -Export mode is used for exporting a YOLOv8 model to a format that can be used for deployment. In this mode, the model is converted to a format that can be used by other software applications or hardware devices. This mode is useful when deploying the model to production environments. - -!!! Example "Export" - - === "Export to ONNX" - - Export an official YOLOv8n model to ONNX with dynamic batch-size and image-size. - ```python - from ultralytics import YOLO - - model = YOLO('yolov8n.pt') - model.export(format='onnx', dynamic=True) - ``` - - === "Export to TensorRT" - - Export an official YOLOv8n model to TensorRT on `device=0` for acceleration on CUDA devices. - ```python - from ultralytics import YOLO - - model = YOLO('yolov8n.pt') - model.export(format='onnx', device=0) - ``` - -[Export Examples](../modes/export.md){ .md-button } - -## [Track](../modes/track.md) - -Track mode is used for tracking objects in real-time using a YOLOv8 model. In this mode, the model is loaded from a checkpoint file, and the user can provide a live video stream to perform real-time object tracking. This mode is useful for applications such as surveillance systems or self-driving cars. - -!!! Example "Track" - - === "Python" - - ```python - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n.pt') # load an official detection model - model = YOLO('yolov8n-seg.pt') # load an official segmentation model - model = YOLO('path/to/best.pt') # load a custom model - - # Track with the model - results = model.track(source="https://youtu.be/LNwODJXcvt4", show=True) - results = model.track(source="https://youtu.be/LNwODJXcvt4", show=True, tracker="bytetrack.yaml") - ``` - -[Track Examples](../modes/track.md){ .md-button } - -## [Benchmark](../modes/benchmark.md) - -Benchmark mode is used to profile the speed and accuracy of various export formats for YOLOv8. The benchmarks provide information on the size of the exported format, its `mAP50-95` metrics (for object detection and segmentation) or `accuracy_top5` metrics (for classification), and the inference time in milliseconds per image across various export formats like ONNX, OpenVINO, TensorRT and others. This information can help users choose the optimal export format for their specific use case based on their requirements for speed and accuracy. - -!!! Example "Benchmark" - - === "Python" - - Benchmark an official YOLOv8n model across all export formats. - ```python - from ultralytics.utils.benchmarks import benchmark - - # Benchmark - benchmark(model='yolov8n.pt', data='coco8.yaml', imgsz=640, half=False, device=0) - ``` - -[Benchmark Examples](../modes/benchmark.md){ .md-button } - -## Explorer - -Explorer API can be used to explore datasets with advanced semantic, vector-similarity and SQL search among other features. It also enabled searching for images based on their content using natural language by utilizing the power of LLMs. The Explorer API allows you to write your own dataset exploration notebooks or scripts to get insights into your datasets. - -!!! Example "Semantic Search Using Explorer" - - === "Using Images" - - ```python - from ultralytics import Explorer - - # create an Explorer object - exp = Explorer(data='coco128.yaml', model='yolov8n.pt') - exp.create_embeddings_table() - - similar = exp.get_similar(img='https://ultralytics.com/images/bus.jpg', limit=10) - print(similar.head()) - - # Search using multiple indices - similar = exp.get_similar( - img=['https://ultralytics.com/images/bus.jpg', - 'https://ultralytics.com/images/bus.jpg'], - limit=10 - ) - print(similar.head()) - ``` - - === "Using Dataset Indices" - - ```python - from ultralytics import Explorer - - # create an Explorer object - exp = Explorer(data='coco128.yaml', model='yolov8n.pt') - exp.create_embeddings_table() - - similar = exp.get_similar(idx=1, limit=10) - print(similar.head()) - - # Search using multiple indices - similar = exp.get_similar(idx=[1,10], limit=10) - print(similar.head()) - ``` - -[Explorer](../datasets/explorer/index.md){ .md-button } - -## Using Trainers - -`YOLO` model class is a high-level wrapper on the Trainer classes. Each YOLO task has its own trainer that inherits from `BaseTrainer`. - -!!! Tip "Detection Trainer Example" - - ```python - from ultralytics.models.yolo import DetectionTrainer, DetectionValidator, DetectionPredictor - - # trainer - trainer = DetectionTrainer(overrides={}) - trainer.train() - trained_model = trainer.best - - # Validator - val = DetectionValidator(args=...) - val(model=trained_model) - - # predictor - pred = DetectionPredictor(overrides={}) - pred(source=SOURCE, model=trained_model) - - # resume from last weight - overrides["resume"] = trainer.last - trainer = detect.DetectionTrainer(overrides=overrides) - ``` - -You can easily customize Trainers to support custom tasks or explore R&D ideas. Learn more about Customizing `Trainers`, `Validators` and `Predictors` to suit your project needs in the Customization Section. - -[Customization tutorials](engine.md){ .md-button } diff --git a/ultralytics-main/docs/en/usage/simple-utilities.md b/ultralytics-main/docs/en/usage/simple-utilities.md deleted file mode 100644 index c170f51..0000000 --- a/ultralytics-main/docs/en/usage/simple-utilities.md +++ /dev/null @@ -1,429 +0,0 @@ ---- -comments: true -description: Discover how to extend the utility of the Ultralytics package to support your development process. -keywords: Ultralytics, YOLO, custom, function, workflow, utility, support, ---- - -# Simple Utilities - -

- code with perspective -

- -The `ultralytics` package comes with a myriad of utilities that can support, enhance, and speed up your workflows. There are many more available, but here are some that will be useful for most developers. They're also a great reference point to use when learning to program. - -## Data - -### YOLO Data Explorer - -[YOLO Explorer](../datasets/explorer/index.md) was added in the `8.1.0` anniversary update and is a powerful tool you can use to better understand your dataset. One of the key functions that YOLO Explorer provides, is the ability to use text queries to find object instances in your dataset. - -### Auto Labeling / Annotations - -Dataset annotation is a very resource intensive and time-consuming process. If you have a YOLO object detection model trained on a reasonable amount of data, you can use it and [SAM](../models/sam.md) to auto-annotate additional data (segmentation format). - -```{ .py .annotate } -from ultralytics.data.annotator import auto_annotate - -auto_annotate(#(1)! - data='path/to/new/data', - det_model='yolov8n.pt', - sam_model='mobile_sam.pt', - device="cuda", - output_dir="path/to/save_labels", -) -``` - -1. Nothing returns from this function - -- [See the reference section for `annotator.auto_annotate`](../reference/data/annotator.md#ultralytics.data.annotator.auto_annotate) for more insight on how the function operates. - -- Use in combination with the [function `segments2boxes`](#convert-segments-to-bounding-boxes) to generate object detection bounding boxes as well - -### Convert COCO into YOLO Format - -Use to convert COCO JSON annotations into proper YOLO format. For object detection (bounding box) datasets, `use_segments` and `use_keypoints` should both be `False` - -```{ .py .annotate } -from ultralytics.data.converter import convert_coco - -convert_coco(#(1)! - '../datasets/coco/annotations/', - use_segments=False, - use_keypoints=False, - cls91to80=True, -) -``` - -1. Nothing returns from this function - -For additional information about the `convert_coco` function, [visit the reference page](../reference/data/converter.md#ultralytics.data.converter.convert_coco) - -### Convert Bounding Boxes to Segments - -With existing `x y w h` bounding box data, convert to segments using the `yolo_bbox2segment` function. The files for images and annotations need to be organized like this: - -``` -data -|__ images - ├─ 001.jpg - ├─ 002.jpg - ├─ .. - └─ NNN.jpg -|__ labels - ├─ 001.txt - ├─ 002.txt - ├─ .. - └─ NNN.txt -``` - -```{ .py .annotate } -from ultralytics.data.converter import yolo_bbox2segment - -yolo_bbox2segment(#(1)! - im_dir="path/to/images", - save_dir=None, # saved to "labels-segment" in images directory - sam_model="sam_b.pt" -) -``` - -1. Nothing returns from this function - -[Visit the `yolo_bbox2segment` reference page](../reference/data/converter.md#ultralytics.data.converter.yolo_bbox2segment) for more information regarding the function. - -### Convert Segments to Bounding Boxes - -If you have a dataset that uses the [segmentation dataset format](../datasets/segment/index.md) you can easily convert these into up-right (or horizontal) bounding boxes (`x y w h` format) with this function. - -```python -from ultralytics.utils.ops import segments2boxes - -segments = np.array( - [[805, 392, 797, 400, ..., 808, 714, 808, 392], - [115, 398, 113, 400, ..., 150, 400, 149, 298], - [267, 412, 265, 413, ..., 300, 413, 299, 412], - ] -) - -segments2boxes([s.reshape(-1,2) for s in segments]) ->>> array([[ 741.66, 631.12, 133.31, 479.25], - [ 146.81, 649.69, 185.62, 502.88], - [ 281.81, 636.19, 118.12, 448.88]], - dtype=float32) # xywh bounding boxes -``` - -To understand how this function works, visit the [reference page](../reference/utils/ops.md#ultralytics.utils.ops.segments2boxes) - -## Utilities - -### Image Compression - -Compresses a single image file to reduced size while preserving its aspect ratio and quality. If the input image is smaller than the maximum dimension, it will not be resized. - -```{ .py .annotate } -from pathlib import Path -from ultralytics.data.utils import compress_one_image - -for f in Path('path/to/dataset').rglob('*.jpg'): - compress_one_image(f)#(1)! -``` - -1. Nothing returns from this function - -### Auto-split Dataset - -Automatically split a dataset into `train`/`val`/`test` splits and save the resulting splits into `autosplit_*.txt` files. This function will use random sampling, which is not included when using [`fraction` argument for training](../modes/train.md#arguments). - -```{ .py .annotate } -from ultralytics.data.utils import autosplit - -autosplit( #(1)! - path="path/to/images", - weights=(0.9, 0.1, 0.0), # (train, validation, test) fractional splits - annotated_only=False # split only images with annotation file when True -) -``` - -1. Nothing returns from this function - -See the [Reference page](../reference/data/utils.md#ultralytics.data.utils.autosplit) for additional details on this function. - -### Segment-polygon to Binary Mask - -Convert a single polygon (as list) to a binary mask of the specified image size. Polygon in the form of `[N, 2]` with `N` as the number of `(x, y)` points defining the polygon contour. - -!!! warning - - `N` must always be even. - -```python -import numpy as np -from ultralytics.data.utils import polygon2mask - -imgsz = (1080, 810) -polygon = np.array( - [805, 392, 797, 400, ..., 808, 714, 808, 392], # (238, 2) -) - -mask = polygon2mask( - imgsz, # tuple - [polygon], # input as list - color=255, # 8-bit binary - downsample_ratio=1 -) -``` - -## Bounding Boxes - -### Bounding Box (horizontal) Instances - -To manage bounding box data, the `Bboxes` class will help to convert between box coordinate formatting, scale box dimensions, calculate areas, include offsets, and more! - -```python -from ultralytics.utils.instance import Bboxes - -boxes = Bboxes( - bboxes=np.array( - [[ 22.878, 231.27, 804.98, 756.83,], - [ 48.552, 398.56, 245.35, 902.71,], - [ 669.47, 392.19, 809.72, 877.04,], - [ 221.52, 405.8, 344.98, 857.54,], - [ 0, 550.53, 63.01, 873.44,], - [ 0.0584, 254.46, 32.561, 324.87,]] - ), - format="xyxy", -) - -boxes.areas() ->>> array([ 4.1104e+05, 99216, 68000, 55772, 20347, 2288.5]) -boxes.convert("xywh") -boxes.bboxes ->>> array( - [[ 413.93, 494.05, 782.1, 525.56], - [ 146.95, 650.63, 196.8, 504.15], - [ 739.6, 634.62, 140.25, 484.85], - [ 283.25, 631.67, 123.46, 451.74], - [ 31.505, 711.99, 63.01, 322.91], - [ 16.31, 289.67, 32.503, 70.41]] -) -``` - -See the [`Bboxes` reference section](../reference/utils/instance.md#ultralytics.utils.instance.Bboxes) for more attributes and methods available. - -!!! tip - Many of the following functions (and more) can be accessed using the [`Bboxes` class](#bounding-box-horizontal-instances) but if you prefer to work with the functions directly, see the next subsections on how to import these independently. - -### Scaling Boxes - -When scaling and image up or down, corresponding bounding box coordinates can be appropriately scaled to match using `ultralytics.utils.ops.scale_boxes`. - -```{ .py .annotate } -import cv2 as cv -import numpy as np -from ultralytics.utils.ops import scale_boxes - -image = cv.imread("ultralytics/assets/bus.jpg") -*(h, w), c = image.shape -resized = cv.resize(image, None, (), fx=1.2, fy=1.2) -*(new_h, new_w), _ = resized.shape - -xyxy_boxes = np.array( - [[ 22.878, 231.27, 804.98, 756.83,], - [ 48.552, 398.56, 245.35, 902.71,], - [ 669.47, 392.19, 809.72, 877.04,], - [ 221.52, 405.8, 344.98, 857.54,], - [ 0, 550.53, 63.01, 873.44,], - [ 0.0584, 254.46, 32.561, 324.87,]] -) - -new_boxes = scale_boxes( - img1_shape=(h, w), # original image dimensions - boxes=xyxy_boxes, # boxes from original image - img0_shape=(new_h, new_w), # resized image dimensions (scale to) - ratio_pad=None, - padding=False, - xywh=False, -) - -new_boxes#(1)! ->>> array( - [[ 27.454, 277.52, 965.98, 908.2], - [ 58.262, 478.27, 294.42, 1083.3], - [ 803.36, 470.63, 971.66, 1052.4], - [ 265.82, 486.96, 413.98, 1029], - [ 0, 660.64, 75.612, 1048.1], - [ 0.0701, 305.35, 39.073, 389.84]] -) -``` - -1. Bounding boxes scaled for the new image size - -### Bounding Box Format Conversions - -#### XYXY → XYWH - -Convert bounding box coordinates from (x1, y1, x2, y2) format to (x, y, width, height) format where (x1, y1) is the top-left corner and (x2, y2) is the bottom-right corner. - -```python -import numpy as np -from ultralytics.utils.ops import xyxy2xywh - -xyxy_boxes = np.array( - [[ 22.878, 231.27, 804.98, 756.83,], - [ 48.552, 398.56, 245.35, 902.71,], - [ 669.47, 392.19, 809.72, 877.04,], - [ 221.52, 405.8, 344.98, 857.54,], - [ 0, 550.53, 63.01, 873.44,], - [ 0.0584, 254.46, 32.561, 324.87,]] -) -xywh = xyxy2xywh(xyxy_boxes) - -xywh ->>> array( - [[ 413.93, 494.05, 782.1, 525.56], - [ 146.95, 650.63, 196.8, 504.15], - [ 739.6, 634.62, 140.25, 484.85], - [ 283.25, 631.67, 123.46, 451.74], - [ 31.505, 711.99, 63.01, 322.91], - [ 16.31, 289.67, 32.503, 70.41]] -) -``` - -### All Bounding Box Conversions - -```python -from ultralytics.utils.ops import xywh2xyxy -from ultralytics.utils.ops import xywhn2xyxy # normalized → pixel -from ultralytics.utils.ops import xyxy2xywhn # pixel → normalized -from ultralytics.utils.ops import xywh2ltwh # xywh → top-left corner, w, h -from ultralytics.utils.ops import xyxy2ltwh # xyxy → top-left corner, w, h -from ultralytics.utils.ops import ltwh2xywh -from ultralytics.utils.ops import ltwh2xyxy -``` - -See docstring for each function or visit the `ultralytics.utils.ops` [reference page](../reference/utils/ops.md) to read more about each function. - -## Plotting - -### Drawing Annotations - -Ultralytics includes an Annotator class that can be used to annotate any kind of data. It's easiest to use with [object detection bounding boxes](../modes/predict.md#boxes), [pose key points](../modes/predict.md#keypoints), and [oriented bounding boxes](../modes/predict.md#obb). - -#### Horizontal Bounding Boxes - -```{ .py .annotate } -import cv2 as cv -import numpy as np -from ultralytics.utils.plotting import Annotator, colors - -names { #(1)! - 0: "person", - 5: "bus", - 11: "stop sign", -} - -image = cv.imread("ultralytics/assets/bus.jpg") -ann = Annotator( - image, - line_width=None, # default auto-size - font_size=None, # default auto-size - font="Arial.ttf", # must be ImageFont compatible - pil=False, # use PIL, otherwise uses OpenCV -) - -xyxy_boxes = np.array( - [[ 5, 22.878, 231.27, 804.98, 756.83,], # class-idx x1 y1 x2 y2 - [ 0, 48.552, 398.56, 245.35, 902.71,], - [ 0, 669.47, 392.19, 809.72, 877.04,], - [ 0, 221.52, 405.8, 344.98, 857.54,], - [ 0, 0, 550.53, 63.01, 873.44,], - [11, 0.0584, 254.46, 32.561, 324.87,]] -) - -for nb, box in enumerate(xyxy_boxes): - c_idx, *box = box - label = f"{str(nb).zfill(2)}:{names.get(int(c_idx))}" - ann.box_label(box, label, color=colors(c_idx, bgr=True)) - -image_with_bboxes = ann.result() -``` - -1. Names can be used from `model.names` when [working with detection results](../modes/predict.md#working-with-results) - -#### Oriented Bounding Boxes (OBB) -```python -import cv2 as cv -import numpy as np -from ultralytics.utils.plotting import Annotator, colors - -obb_names = {10: "small vehicle"} -obb_image = cv.imread("datasets/dota8/images/train/P1142__1024__0___824.jpg") -obb_boxes = np.array( - [[ 0, 635, 560, 919, 719, 1087, 420, 803, 261,], # class-idx x1 y1 x2 y2 x3 y2 x4 y4 - [ 0, 331, 19, 493, 260, 776, 70, 613, -171,], - [ 9, 869, 161, 886, 147, 851, 101, 833, 115,] - ] -) -ann = Annotator( - obb_image, - line_width=None, # default auto-size - font_size=None, # default auto-size - font="Arial.ttf", # must be ImageFont compatible - pil=False, # use PIL, otherwise uses OpenCV -) -for obb in obb_boxes: - c_idx, *obb = obb - obb = np.array(obb).reshape(-1, 4, 2).squeeze() - label = f"{names.get(int(c_idx))}" - ann.box_label( - obb, - label, - color=colors(c_idx, True), - rotated=True, - ) - -image_with_obb = ann.result() -``` - -See the [`Annotator` Reference Page](../reference/utils/plotting.md#ultralytics.utils.plotting.Annotator) for additional insight. - -## Miscellaneous - -### Code Profiling - -Check duration for code to run/process either using `with` or as a decorator. - -```python -from ultralytics.utils.ops import Profile - -with Profile(device=device) as dt: - pass # operation to measure - -print(dt) ->>> "Elapsed time is 9.5367431640625e-07 s" -``` - -### Ultralytics Supported Formats - -Want or need to use the formats of [images or videos types supported](../modes/predict.md#image-and-video-formats) by Ultralytics programmatically? Use these constants if you need. - -```python -from ultralytics.data.utils import IMG_FORMATS -from ultralytics.data.utils import VID_FORMATS - -print(IMG_FORMATS) ->>> ('bmp', 'dng', 'jpeg', 'jpg', 'mpo', 'png', 'tif', 'tiff', 'webp', 'pfm') -``` - -### Make Divisible - -Calculates the nearest whole number to `x` to make evenly divisible when divided by `y`. - -```python -from ultralytics.utils.ops import make_divisible - -make_divisible(7, 3) ->>> 9 -make_divisible(7, 2) ->>> 8 -``` diff --git a/ultralytics-main/docs/en/yolov5/environments/aws_quickstart_tutorial.md b/ultralytics-main/docs/en/yolov5/environments/aws_quickstart_tutorial.md deleted file mode 100644 index 2bf3240..0000000 --- a/ultralytics-main/docs/en/yolov5/environments/aws_quickstart_tutorial.md +++ /dev/null @@ -1,95 +0,0 @@ ---- -comments: true -description: Follow this comprehensive guide to set up and operate YOLOv5 on an AWS Deep Learning instance for object detection tasks. Get started with model training and deployment. -keywords: YOLOv5, AWS Deep Learning AMIs, object detection, machine learning, AI, model training, instance setup, Ultralytics ---- - -# YOLOv5 🚀 on AWS Deep Learning Instance: Your Complete Guide - -Setting up a high-performance deep learning environment can be daunting for newcomers, but fear not! 🛠️ With this guide, we'll walk you through the process of getting YOLOv5 up and running on an AWS Deep Learning instance. By leveraging the power of Amazon Web Services (AWS), even those new to machine learning can get started quickly and cost-effectively. The AWS platform's scalability is perfect for both experimentation and production deployment. - -Other quickstart options for YOLOv5 include our [Colab Notebook](https://colab.research.google.com/github/ultralytics/yolov5/blob/master/tutorial.ipynb) Open In Colab Open In Kaggle, [GCP Deep Learning VM](https://docs.ultralytics.com/yolov5/environments/google_cloud_quickstart_tutorial), and our Docker image at [Docker Hub](https://hub.docker.com/r/ultralytics/yolov5) Docker Pulls. - -## Step 1: AWS Console Sign-In - -Start by creating an account or signing in to the AWS console at [https://aws.amazon.com/console/](https://aws.amazon.com/console/). Once logged in, select the **EC2** service to manage and set up your instances. - -![Console](https://user-images.githubusercontent.com/26833433/106323804-debddd00-622c-11eb-997f-b8217dc0e975.png) - -## Step 2: Launch Your Instance - -In the EC2 dashboard, you'll find the **Launch Instance** button which is your gateway to creating a new virtual server. - -![Launch](https://user-images.githubusercontent.com/26833433/106323950-204e8800-622d-11eb-915d-5c90406973ea.png) - -### Selecting the Right Amazon Machine Image (AMI) - -Here's where you choose the operating system and software stack for your instance. Type 'Deep Learning' into the search field and select the latest Ubuntu-based Deep Learning AMI, unless your needs dictate otherwise. Amazon's Deep Learning AMIs come pre-installed with popular frameworks and GPU drivers to streamline your setup process. - -![Choose AMI](https://user-images.githubusercontent.com/26833433/106326107-c9e34880-6230-11eb-97c9-3b5fc2f4e2ff.png) - -### Picking an Instance Type - -For deep learning tasks, selecting a GPU instance type is generally recommended as it can vastly accelerate model training. For instance size considerations, remember that the model's memory requirements should never exceed what your instance can provide. - -**Note:** The size of your model should be a factor in selecting an instance. If your model exceeds an instance's available RAM, select a different instance type with enough memory for your application. - -For a list of available GPU instance types, visit [EC2 Instance Types](https://aws.amazon.com/ec2/instance-types/), specifically under Accelerated Computing. - -![Choose Type](https://user-images.githubusercontent.com/26833433/106324624-52141e80-622e-11eb-9662-1a376d9c887d.png) - -For more information on GPU monitoring and optimization, see [GPU Monitoring and Optimization](https://docs.aws.amazon.com/dlami/latest/devguide/tutorial-gpu.html). For pricing, see [On-Demand Pricing](https://aws.amazon.com/ec2/pricing/on-demand/) and [Spot Pricing](https://aws.amazon.com/ec2/spot/pricing/). - -### Configuring Your Instance - -Amazon EC2 Spot Instances offer a cost-effective way to run applications as they allow you to bid for unused capacity at a fraction of the standard cost. For a persistent experience that retains data even when the Spot Instance goes down, opt for a persistent request. - -![Spot Request](https://user-images.githubusercontent.com/26833433/106324835-ac14e400-622e-11eb-8853-df5ec9b16dfc.png) - -Remember to adjust the rest of your instance settings and security configurations as needed in Steps 4-7 before launching. - -## Step 3: Connect to Your Instance - -Once your instance is running, select its checkbox and click Connect to access the SSH information. Use the displayed SSH command in your preferred terminal to establish a connection to your instance. - -![Connect](https://user-images.githubusercontent.com/26833433/106325530-cf8c5e80-622f-11eb-9f64-5b313a9d57a1.png) - -## Step 4: Running YOLOv5 - -Logged into your instance, you're now ready to clone the YOLOv5 repository and install dependencies within a Python 3.8 or later environment. YOLOv5's models and datasets will automatically download from the latest [release](https://github.com/ultralytics/yolov5/releases). - -```bash -git clone https://github.com/ultralytics/yolov5 # clone repository -cd yolov5 -pip install -r requirements.txt # install dependencies -``` - -With your environment set up, you can begin training, validating, performing inference, and exporting your YOLOv5 models: - -```bash -# Train a model on your data -python train.py - -# Validate the trained model for Precision, Recall, and mAP -python val.py --weights yolov5s.pt - -# Run inference using the trained model on your images or videos -python detect.py --weights yolov5s.pt --source path/to/images - -# Export the trained model to other formats for deployment -python export.py --weights yolov5s.pt --include onnx coreml tflite -``` - -## Optional Extras - -To add more swap memory, which can be a savior for large datasets, run: - -```bash -sudo fallocate -l 64G /swapfile # allocate 64GB swap file -sudo chmod 600 /swapfile # modify permissions -sudo mkswap /swapfile # set up a Linux swap area -sudo swapon /swapfile # activate swap file -free -h # verify swap memory -``` - -And that's it! 🎉 You've successfully created an AWS Deep Learning instance and run YOLOv5. Whether you're just starting with object detection or scaling up for production, this setup can help you achieve your machine learning goals. Happy training, validating, and deploying! If you encounter any hiccups along the way, the robust AWS documentation and the active Ultralytics community are here to support you. diff --git a/ultralytics-main/docs/en/yolov5/environments/azureml_quickstart_tutorial.md b/ultralytics-main/docs/en/yolov5/environments/azureml_quickstart_tutorial.md deleted file mode 100644 index 9f87f59..0000000 --- a/ultralytics-main/docs/en/yolov5/environments/azureml_quickstart_tutorial.md +++ /dev/null @@ -1,94 +0,0 @@ ---- -comments: true -description: Azure Machine Learning YOLOv5 quickstart -keywords: Ultralytics, YOLO, Deep Learning, Object detection, quickstart, Azure, AzureML ---- - -# YOLOv5 🚀 on AzureML - -This guide provides a quickstart to use YOLOv5 from an AzureML compute instance. - -Note that this guide is a quickstart for quick trials. If you want to unlock the full power AzureML, you can find the documentation to: - -- [Create a data asset](https://learn.microsoft.com/azure/machine-learning/how-to-create-data-assets) -- [Create an AzureML job](https://learn.microsoft.com/azure/machine-learning/how-to-train-model) -- [Register a model](https://learn.microsoft.com/azure/machine-learning/how-to-manage-models) - -## Prerequisites - -You need an [AzureML workspace](https://learn.microsoft.com/azure/machine-learning/concept-workspace?view=azureml-api-2). - -## Create a compute instance - -From your AzureML workspace, select Compute > Compute instances > New, select the instance with the resources you need. - -create-compute-arrow - -## Open a Terminal - -Now from the Notebooks view, open a Terminal and select your compute. - -![open-terminal-arrow](https://github.com/ouphi/ultralytics/assets/17216799/c4697143-7234-4a04-89ea-9084ed9c6312) - -## Setup and run YOLOv5 - -Now you can, create a virtual environment: - -```bash -conda create --name yolov5env -y -conda activate yolov5env -conda install pip -y -``` - -Clone YOLOv5 repository with its submodules: - -```bash -git clone https://github.com/ultralytics/yolov5 -cd yolov5 -git submodule update --init --recursive # Note that you might have a message asking you to add your folder as a safe.directory just copy the recommended command -``` - -Install the required dependencies: - -```bash -pip install -r yolov5/requirements.txt -pip install onnx>=1.10.0 -``` - -Train the YOLOv5 model: - -```bash -python train.py -``` - -Validate the model for Precision, Recall, and mAP - -```bash -python val.py --weights yolov5s.pt -``` - -Run inference on images and videos: - -```bash -python detect.py --weights yolov5s.pt --source path/to/images -``` - -Export models to other formats: - -```bash -python detect.py --weights yolov5s.pt --source path/to/images -``` - -## Notes on using a notebook - -Note that if you want to run these commands from a Notebook, you need to [create a new Kernel](https://learn.microsoft.com/en-us/azure/machine-learning/how-to-access-terminal?view=azureml-api-2#add-new-kernels) and select your new Kernel on the top of your Notebook. - -If you create Python cells it will automatically use your custom environment, but if you add bash cells, you will need to run `source activate ` on each of these cells to make sure it uses your custom environment. - -For example: - -```bash -%%bash -source activate newenv -python val.py --weights yolov5s.pt -``` diff --git a/ultralytics-main/docs/en/yolov5/environments/docker_image_quickstart_tutorial.md b/ultralytics-main/docs/en/yolov5/environments/docker_image_quickstart_tutorial.md deleted file mode 100644 index 2e2bd81..0000000 --- a/ultralytics-main/docs/en/yolov5/environments/docker_image_quickstart_tutorial.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -comments: true -description: Learn how to set up and run YOLOv5 in a Docker container. This tutorial includes the prerequisites and step-by-step instructions. -keywords: YOLOv5, Docker, Ultralytics, Image Detection, YOLOv5 Docker Image, Docker Container, Machine Learning, AI ---- - -# Get Started with YOLOv5 🚀 in Docker - -This tutorial will guide you through the process of setting up and running YOLOv5 in a Docker container. - -You can also explore other quickstart options for YOLOv5, such as our [Colab Notebook](https://colab.research.google.com/github/ultralytics/yolov5/blob/master/tutorial.ipynb) Open In Colab Open In Kaggle, [GCP Deep Learning VM](https://docs.ultralytics.com/yolov5/environments/google_cloud_quickstart_tutorial), and [Amazon AWS](https://docs.ultralytics.com/yolov5/environments/aws_quickstart_tutorial). - -## Prerequisites - -1. **Nvidia Driver**: Version 455.23 or higher. Download from [Nvidia's website](https://www.nvidia.com/Download/index.aspx). -2. **Nvidia-Docker**: Allows Docker to interact with your local GPU. Installation instructions are available on the [Nvidia-Docker GitHub repository](https://github.com/NVIDIA/nvidia-docker). -3. **Docker Engine - CE**: Version 19.03 or higher. Download and installation instructions can be found on the [Docker website](https://docs.docker.com/install/). - -## Step 1: Pull the YOLOv5 Docker Image - -The Ultralytics YOLOv5 DockerHub repository is available at [https://hub.docker.com/r/ultralytics/yolov5](https://hub.docker.com/r/ultralytics/yolov5). Docker Autobuild ensures that the `ultralytics/yolov5:latest` image is always in sync with the most recent repository commit. To pull the latest image, run the following command: - -```bash -sudo docker pull ultralytics/yolov5:latest -``` - -## Step 2: Run the Docker Container - -### Basic container: - -Run an interactive instance of the YOLOv5 Docker image (called a "container") using the `-it` flag: - -```bash -sudo docker run --ipc=host -it ultralytics/yolov5:latest -``` - -### Container with local file access: - -To run a container with access to local files (e.g., COCO training data in `/datasets`), use the `-v` flag: - -```bash -sudo docker run --ipc=host -it -v "$(pwd)"/datasets:/usr/src/datasets ultralytics/yolov5:latest -``` - -### Container with GPU access: - -To run a container with GPU access, use the `--gpus all` flag: - -```bash -sudo docker run --ipc=host -it --gpus all ultralytics/yolov5:latest -``` - -## Step 3: Use YOLOv5 🚀 within the Docker Container - -Now you can train, test, detect, and export YOLOv5 models within the running Docker container: - -```bash -# Train a model on your data -python train.py - -# Validate the trained model for Precision, Recall, and mAP -python val.py --weights yolov5s.pt - -# Run inference using the trained model on your images or videos -python detect.py --weights yolov5s.pt --source path/to/images - -# Export the trained model to other formats for deployment -python export.py --weights yolov5s.pt --include onnx coreml tflite -``` - -

GCP running Docker

diff --git a/ultralytics-main/docs/en/yolov5/environments/google_cloud_quickstart_tutorial.md b/ultralytics-main/docs/en/yolov5/environments/google_cloud_quickstart_tutorial.md deleted file mode 100644 index fd96e84..0000000 --- a/ultralytics-main/docs/en/yolov5/environments/google_cloud_quickstart_tutorial.md +++ /dev/null @@ -1,87 +0,0 @@ ---- -comments: true -description: Discover how to deploy YOLOv5 on a GCP Deep Learning VM for seamless object detection. Ideal for ML beginners and cloud learners. Get started with our easy-to-follow tutorial! -keywords: YOLOv5, Google Cloud Platform, GCP, Deep Learning VM, ML model training, object detection, AI tutorial, cloud-based AI, machine learning setup ---- - -# Mastering YOLOv5 🚀 Deployment on Google Cloud Platform (GCP) Deep Learning Virtual Machine (VM) ⭐ - -Embarking on the journey of artificial intelligence and machine learning can be exhilarating, especially when you leverage the power and flexibility of a cloud platform. Google Cloud Platform (GCP) offers robust tools tailored for machine learning enthusiasts and professionals alike. One such tool is the Deep Learning VM that is preconfigured for data science and ML tasks. In this tutorial, we will navigate through the process of setting up YOLOv5 on a GCP Deep Learning VM. Whether you’re taking your first steps in ML or you’re a seasoned practitioner, this guide is designed to provide you with a clear pathway to implementing object detection models powered by YOLOv5. - -🆓 Plus, if you're a fresh GCP user, you’re in luck with a [$300 free credit offer](https://cloud.google.com/free/docs/gcp-free-tier#free-trial) to kickstart your projects. - -In addition to GCP, explore other accessible quickstart options for YOLOv5, like our [Colab Notebook](https://colab.research.google.com/github/ultralytics/yolov5/blob/master/tutorial.ipynb) Open In Colab for a browser-based experience, or the scalability of [Amazon AWS](https://docs.ultralytics.com/yolov5/environments/aws_quickstart_tutorial). Furthermore, container aficionados can utilize our official Docker image at [Docker Hub](https://hub.docker.com/r/ultralytics/yolov5) Docker Pulls for an encapsulated environment. - -## Step 1: Create and Configure Your Deep Learning VM - -Let’s begin by creating a virtual machine that’s tuned for deep learning: - -1. Head over to the [GCP marketplace](https://console.cloud.google.com/marketplace/details/click-to-deploy-images/deeplearning) and select the **Deep Learning VM**. -2. Opt for a **n1-standard-8** instance; it offers a balance of 8 vCPUs and 30 GB of memory, ideally suited for our needs. -3. Next, select a GPU. This depends on your workload; even a basic one like the Tesla T4 will markedly accelerate your model training. -4. Tick the box for 'Install NVIDIA GPU driver automatically on first startup?' for hassle-free setup. -5. Allocate a 300 GB SSD Persistent Disk to ensure you don't bottleneck on I/O operations. -6. Hit 'Deploy' and let GCP do its magic in provisioning your custom Deep Learning VM. - -This VM comes loaded with a treasure trove of preinstalled tools and frameworks, including the [Anaconda](https://www.anaconda.com/) Python distribution, which conveniently bundles all the necessary dependencies for YOLOv5. - -![GCP Marketplace illustration of setting up a Deep Learning VM](https://user-images.githubusercontent.com/26833433/105811495-95863880-5f61-11eb-841d-c2f2a5aa0ffe.png) - -## Step 2: Ready the VM for YOLOv5 - -Following the environment setup, let's get YOLOv5 up and running: - -```bash -# Clone the YOLOv5 repository -git clone https://github.com/ultralytics/yolov5 - -# Change the directory to the cloned repository -cd yolov5 - -# Install the necessary Python packages from requirements.txt -pip install -r requirements.txt -``` - -This setup process ensures you're working with a Python environment version 3.8.0 or newer and PyTorch 1.8 or above. Our scripts smoothly download [models](https://github.com/ultralytics/yolov5/tree/master/models) and [datasets](https://github.com/ultralytics/yolov5/tree/master/data) rending from the latest YOLOv5 [release](https://github.com/ultralytics/yolov5/releases), making it hassle-free to start model training. - -## Step 3: Train and Deploy Your YOLOv5 Models 🌐 - -With the setup complete, you're ready to delve into training and inference with YOLOv5 on your GCP VM: - -```bash -# Train a model on your data -python train.py - -# Validate the trained model for Precision, Recall, and mAP -python val.py --weights yolov5s.pt - -# Run inference using the trained model on your images or videos -python detect.py --weights yolov5s.pt --source path/to/images - -# Export the trained model to other formats for deployment -python export.py --weights yolov5s.pt --include onnx coreml tflite -``` - -With just a few commands, YOLOv5 allows you to train custom object detection models tailored to your specific needs or utilize pre-trained weights for quick results on a variety of tasks. - -![Terminal command image illustrating model training on a GCP Deep Learning VM](https://user-images.githubusercontent.com/26833433/142223900-275e5c9e-e2b5-43f7-a21c-35c4ca7de87c.png) - -## Allocate Swap Space (optional) - -For those dealing with hefty datasets, consider amplifying your GCP instance with an additional 64GB of swap memory: - -```bash -sudo fallocate -l 64G /swapfile -sudo chmod 600 /swapfile -sudo mkswap /swapfile -sudo swapon /swapfile -free -h # confirm the memory increment -``` - -### Concluding Thoughts - -Congratulations! You are now empowered to harness the capabilities of YOLOv5 with the computational prowess of Google Cloud Platform. This combination provides scalability, efficiency, and versatility for your object detection tasks. Whether for personal projects, academic research, or industrial applications, you have taken a pivotal step into the world of AI and machine learning on the cloud. - -Do remember to document your journey, share insights with the Ultralytics community, and leverage the collaborative arenas such as [GitHub discussions](https://github.com/ultralytics/yolov5/discussions) to grow further. Now, go forth and innovate with YOLOv5 and GCP! 🌟 - -Want to keep improving your ML skills and knowledge? Dive into our [documentation and tutorials](https://docs.ultralytics.com/) for more resources. Let your AI adventure continue! diff --git a/ultralytics-main/docs/en/yolov5/index.md b/ultralytics-main/docs/en/yolov5/index.md deleted file mode 100644 index 826df5b..0000000 --- a/ultralytics-main/docs/en/yolov5/index.md +++ /dev/null @@ -1,93 +0,0 @@ ---- -comments: true -description: Deep dive into Ultralytics' YOLOv5. Learn about object detection model - YOLOv5, how to train it on custom data, multi-GPU training and more. -keywords: YOLOv5, object detection, computer vision, CUDA, PyTorch tutorial, multi-GPU training, custom dataset, model export, deployment, CI tests ---- - -# Comprehensive Guide to Ultralytics YOLOv5 - -
-

- - Ultralytics YOLOv5 v7.0 banner -

- -YOLOv5 CI -YOLOv5 Citation -Docker Pulls -
-Run on Gradient -Open In Colab -Open In Kaggle -
-
- -Welcome to the Ultralytics' YOLOv5🚀 Documentation! YOLOv5, the fifth iteration of the revolutionary "You Only Look Once" object detection model, is designed to deliver high-speed, high-accuracy results in real-time. - -

- -Built on PyTorch, this powerful deep learning framework has garnered immense popularity for its versatility, ease of use, and high performance. Our documentation guides you through the installation process, explains the architectural nuances of the model, showcases various use-cases, and provides a series of detailed tutorials. These resources will help you harness the full potential of YOLOv5 for your computer vision projects. Let's get started! - -
- -## Explore and Learn - -Here's a compilation of comprehensive tutorials that will guide you through different aspects of YOLOv5. - -- [Train Custom Data](tutorials/train_custom_data.md) 🚀 RECOMMENDED: Learn how to train the YOLOv5 model on your custom dataset. -- [Tips for Best Training Results](tutorials/tips_for_best_training_results.md) ☘️: Uncover practical tips to optimize your model training process. -- [Multi-GPU Training](tutorials/multi_gpu_training.md): Understand how to leverage multiple GPUs to expedite your training. -- [PyTorch Hub](tutorials/pytorch_hub_model_loading.md) 🌟 NEW: Learn to load pre-trained models via PyTorch Hub. -- [TFLite, ONNX, CoreML, TensorRT Export](tutorials/model_export.md) 🚀: Understand how to export your model to different formats. -- [NVIDIA Jetson platform Deployment](tutorials/running_on_jetson_nano.md) 🌟 NEW: Learn how to deploy your YOLOv5 model on NVIDIA Jetson platform. -- [Test-Time Augmentation (TTA)](tutorials/test_time_augmentation.md): Explore how to use TTA to improve your model's prediction accuracy. -- [Model Ensembling](tutorials/model_ensembling.md): Learn the strategy of combining multiple models for improved performance. -- [Model Pruning/Sparsity](tutorials/model_pruning_and_sparsity.md): Understand pruning and sparsity concepts, and how to create a more efficient model. -- [Hyperparameter Evolution](tutorials/hyperparameter_evolution.md): Discover the process of automated hyperparameter tuning for better model performance. -- [Transfer Learning with Frozen Layers](tutorials/transfer_learning_with_frozen_layers.md): Learn how to implement transfer learning by freezing layers in YOLOv5. -- [Architecture Summary](tutorials/architecture_description.md) 🌟 Delve into the structural details of the YOLOv5 model. -- [Roboflow for Datasets](tutorials/roboflow_datasets_integration.md): Understand how to utilize Roboflow for dataset management, labeling, and active learning. -- [ClearML Logging](tutorials/clearml_logging_integration.md) 🌟 Learn how to integrate ClearML for efficient logging during your model training. -- [YOLOv5 with Neural Magic](tutorials/neural_magic_pruning_quantization.md) Discover how to use Neural Magic's Deepsparse to prune and quantize your YOLOv5 model. -- [Comet Logging](tutorials/comet_logging_integration.md) 🌟 NEW: Explore how to utilize Comet for improved model training logging. - -## Supported Environments - -Ultralytics provides a range of ready-to-use environments, each pre-installed with essential dependencies such as [CUDA](https://developer.nvidia.com/cuda), [CUDNN](https://developer.nvidia.com/cudnn), [Python](https://www.python.org/), and [PyTorch](https://pytorch.org/), to kickstart your projects. - -- **Free GPU Notebooks**: Run on Gradient Open In Colab Open In Kaggle -- **Google Cloud**: [GCP Quickstart Guide](environments/google_cloud_quickstart_tutorial.md) -- **Amazon**: [AWS Quickstart Guide](environments/aws_quickstart_tutorial.md) -- **Azure**: [AzureML Quickstart Guide](environments/azureml_quickstart_tutorial.md) -- **Docker**: [Docker Quickstart Guide](environments/docker_image_quickstart_tutorial.md) Docker Pulls - -## Project Status - -YOLOv5 CI - -This badge indicates that all [YOLOv5 GitHub Actions](https://github.com/ultralytics/yolov5/actions) Continuous Integration (CI) tests are successfully passing. These CI tests rigorously check the functionality and performance of YOLOv5 across various key aspects: [training](https://github.com/ultralytics/yolov5/blob/master/train.py), [validation](https://github.com/ultralytics/yolov5/blob/master/val.py), [inference](https://github.com/ultralytics/yolov5/blob/master/detect.py), [export](https://github.com/ultralytics/yolov5/blob/master/export.py), and [benchmarks](https://github.com/ultralytics/yolov5/blob/master/benchmarks.py). They ensure consistent and reliable operation on macOS, Windows, and Ubuntu, with tests conducted every 24 hours and upon each new commit. - -
-
- Ultralytics GitHub - space - Ultralytics LinkedIn - space - Ultralytics Twitter - space - Ultralytics YouTube - space - Ultralytics TikTok - space - Ultralytics Instagram - space - Ultralytics Discord -
- -## Connect and Contribute - -Your journey with YOLOv5 doesn't have to be a solitary one. Join our vibrant community on [GitHub](https://github.com/ultralytics/yolov5), connect with professionals on [LinkedIn](https://www.linkedin.com/company/ultralytics/), share your results on [Twitter](https://twitter.com/ultralytics), and find educational resources on [YouTube](https://youtube.com/ultralytics). Follow us on [TikTok](https://www.tiktok.com/@ultralytics) and [Instagram](https://www.instagram.com/ultralytics/) for more engaging content. - -Interested in contributing? We welcome contributions of all forms; from code improvements and bug reports to documentation updates. Check out our [contributing guidelines](https://github.com/ultralytics/yolov5/blob/master/CONTRIBUTING.md) for more information. - -We're excited to see the innovative ways you'll use YOLOv5. Dive in, experiment, and revolutionize your computer vision projects! 🚀 diff --git a/ultralytics-main/docs/en/yolov5/quickstart_tutorial.md b/ultralytics-main/docs/en/yolov5/quickstart_tutorial.md deleted file mode 100644 index e5a379c..0000000 --- a/ultralytics-main/docs/en/yolov5/quickstart_tutorial.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -comments: true -description: Dive into YOLOv5 for object detection with our easy-to-follow guide on setup, model training, and image inference using PyTorch. Get started now! -keywords: YOLOv5 Tutorial, Object Detection Guide, PyTorch Model Training, Inference with YOLOv5, Ultralytics YOLOv5 Setup ---- - -# YOLOv5 Quickstart 🚀 - -Embark on your journey into the dynamic realm of real-time object detection with YOLOv5! This guide is crafted to serve as a comprehensive starting point for AI enthusiasts and professionals aiming to master YOLOv5. From initial setup to advanced training techniques, we've got you covered. By the end of this guide, you'll have the knowledge to implement YOLOv5 into your projects confidently. Let's ignite the engines and soar into YOLOv5! - -## Install - -Prepare for launch by cloning the repository and establishing the environment. This ensures that all the necessary [requirements](https://github.com/ultralytics/yolov5/blob/master/requirements.txt) are installed. Check that you have [**Python>=3.8.0**](https://www.python.org/) and [**PyTorch>=1.8**](https://pytorch.org/get-started/locally/) ready for takeoff. - -```bash -git clone https://github.com/ultralytics/yolov5 # clone repository -cd yolov5 -pip install -r requirements.txt # install dependencies -``` - -## Inference with PyTorch Hub - -Experience the simplicity of YOLOv5 [PyTorch Hub](https://docs.ultralytics.com/yolov5/tutorials/pytorch_hub_model_loading) inference, where [models](https://github.com/ultralytics/yolov5/tree/master/models) are seamlessly downloaded from the latest YOLOv5 [release](https://github.com/ultralytics/yolov5/releases). - -```python -import torch - -# Model loading -model = torch.hub.load("ultralytics/yolov5", "yolov5s") # Can be 'yolov5n' - 'yolov5x6', or 'custom' - -# Inference on images -img = "https://ultralytics.com/images/zidane.jpg" # Can be a file, Path, PIL, OpenCV, numpy, or list of images - -# Run inference -results = model(img) - -# Display results -results.print() # Other options: .show(), .save(), .crop(), .pandas(), etc. -``` - -## Inference with detect.py - -Harness `detect.py` for versatile inference on various sources. It automatically fetches [models](https://github.com/ultralytics/yolov5/tree/master/models) from the latest YOLOv5 [release](https://github.com/ultralytics/yolov5/releases) and saves results with ease. - -```bash -python detect.py --weights yolov5s.pt --source 0 # webcam - img.jpg # image - vid.mp4 # video - screen # screenshot - path/ # directory - list.txt # list of images - list.streams # list of streams - 'path/*.jpg' # glob - 'https://youtu.be/LNwODJXcvt4' # YouTube - 'rtsp://example.com/media.mp4' # RTSP, RTMP, HTTP stream -``` - -## Training - -Replicate the YOLOv5 [COCO](https://github.com/ultralytics/yolov5/blob/master/data/scripts/get_coco.sh) benchmarks with the instructions below. The necessary [models](https://github.com/ultralytics/yolov5/tree/master/models) and [datasets](https://github.com/ultralytics/yolov5/tree/master/data) are pulled directly from the latest YOLOv5 [release](https://github.com/ultralytics/yolov5/releases). Training YOLOv5n/s/m/l/x on a V100 GPU should typically take 1/2/4/6/8 days respectively (note that [Multi-GPU](https://docs.ultralytics.com/yolov5/tutorials/multi_gpu_training) setups work faster). Maximize performance by using the highest possible `--batch-size` or use `--batch-size -1` for the YOLOv5 [AutoBatch](https://github.com/ultralytics/yolov5/pull/5092) feature. The following batch sizes are ideal for V100-16GB GPUs. - -```bash -python train.py --data coco.yaml --epochs 300 --weights '' --cfg yolov5n.yaml --batch-size 128 - yolov5s 64 - yolov5m 40 - yolov5l 24 - yolov5x 16 -``` - -YOLO training curves - -To conclude, YOLOv5 is not only a state-of-the-art tool for object detection but also a testament to the power of machine learning in transforming the way we interact with the world through visual understanding. As you progress through this guide and begin applying YOLOv5 to your projects, remember that you are at the forefront of a technological revolution, capable of achieving remarkable feats. Should you need further insights or support from fellow visionaries, you're invited to our [GitHub repository](https://github.com/ultralytics/yolov5) home to a thriving community of developers and researchers. Keep exploring, keep innovating, and enjoy the marvels of YOLOv5. Happy detecting! 🌠🔍 diff --git a/ultralytics-main/docs/en/yolov5/tutorials/architecture_description.md b/ultralytics-main/docs/en/yolov5/tutorials/architecture_description.md deleted file mode 100644 index 59a6e40..0000000 --- a/ultralytics-main/docs/en/yolov5/tutorials/architecture_description.md +++ /dev/null @@ -1,224 +0,0 @@ ---- -comments: true -description: Explore the architecture of YOLOv5, an object detection algorithm by Ultralytics. Understand the model structure, data augmentation methods, training strategies, and loss computation techniques. -keywords: Ultralytics, YOLOv5, Object Detection, Architecture, Model Structure, Data Augmentation, Training Strategies, Loss Computation ---- - -# Ultralytics YOLOv5 Architecture - -YOLOv5 (v6.0/6.1) is a powerful object detection algorithm developed by Ultralytics. This article dives deep into the YOLOv5 architecture, data augmentation strategies, training methodologies, and loss computation techniques. This comprehensive understanding will help improve your practical application of object detection in various fields, including surveillance, autonomous vehicles, and image recognition. - -## 1. Model Structure - -YOLOv5's architecture consists of three main parts: - -- **Backbone**: This is the main body of the network. For YOLOv5, the backbone is designed using the `New CSP-Darknet53` structure, a modification of the Darknet architecture used in previous versions. -- **Neck**: This part connects the backbone and the head. In YOLOv5, `SPPF` and `New CSP-PAN` structures are utilized. -- **Head**: This part is responsible for generating the final output. YOLOv5 uses the `YOLOv3 Head` for this purpose. - -The structure of the model is depicted in the image below. The model structure details can be found in `yolov5l.yaml`. - -![yolov5](https://user-images.githubusercontent.com/31005897/172404576-c260dcf9-76bb-4bc8-b6a9-f2d987792583.png) - -YOLOv5 introduces some minor changes compared to its predecessors: - -1. The `Focus` structure, found in earlier versions, is replaced with a `6x6 Conv2d` structure. This change boosts efficiency [#4825](https://github.com/ultralytics/yolov5/issues/4825). -2. The `SPP` structure is replaced with `SPPF`. This alteration more than doubles the speed of processing. - -To test the speed of `SPP` and `SPPF`, the following code can be used: - -
-SPP vs SPPF speed profiling example (click to open) - -```python -import time -import torch -import torch.nn as nn - - -class SPP(nn.Module): - def __init__(self): - super().__init__() - self.maxpool1 = nn.MaxPool2d(5, 1, padding=2) - self.maxpool2 = nn.MaxPool2d(9, 1, padding=4) - self.maxpool3 = nn.MaxPool2d(13, 1, padding=6) - - def forward(self, x): - o1 = self.maxpool1(x) - o2 = self.maxpool2(x) - o3 = self.maxpool3(x) - return torch.cat([x, o1, o2, o3], dim=1) - - -class SPPF(nn.Module): - def __init__(self): - super().__init__() - self.maxpool = nn.MaxPool2d(5, 1, padding=2) - - def forward(self, x): - o1 = self.maxpool(x) - o2 = self.maxpool(o1) - o3 = self.maxpool(o2) - return torch.cat([x, o1, o2, o3], dim=1) - - -def main(): - input_tensor = torch.rand(8, 32, 16, 16) - spp = SPP() - sppf = SPPF() - output1 = spp(input_tensor) - output2 = sppf(input_tensor) - - print(torch.equal(output1, output2)) - - t_start = time.time() - for _ in range(100): - spp(input_tensor) - print(f"SPP time: {time.time() - t_start}") - - t_start = time.time() - for _ in range(100): - sppf(input_tensor) - print(f"SPPF time: {time.time() - t_start}") - - -if __name__ == '__main__': - main() -``` - -result: - -``` -True -SPP time: 0.5373051166534424 -SPPF time: 0.20780706405639648 -``` - -
- -## 2. Data Augmentation Techniques - -YOLOv5 employs various data augmentation techniques to improve the model's ability to generalize and reduce overfitting. These techniques include: - -- **Mosaic Augmentation**: An image processing technique that combines four training images into one in ways that encourage object detection models to better handle various object scales and translations. - - ![mosaic](https://user-images.githubusercontent.com/31005897/159109235-c7aad8f2-1d4f-41f9-8d5f-b2fde6f2885e.png) - -- **Copy-Paste Augmentation**: An innovative data augmentation method that copies random patches from an image and pastes them onto another randomly chosen image, effectively generating a new training sample. - - ![copy-paste](https://user-images.githubusercontent.com/31005897/159116277-91b45033-6bec-4f82-afc4-41138866628e.png) - -- **Random Affine Transformations**: This includes random rotation, scaling, translation, and shearing of the images. - - ![random-affine](https://user-images.githubusercontent.com/31005897/159109326-45cd5acb-14fa-43e7-9235-0f21b0021c7d.png) - -- **MixUp Augmentation**: A method that creates composite images by taking a linear combination of two images and their associated labels. - - ![mixup](https://user-images.githubusercontent.com/31005897/159109361-3b24333b-f481-478b-ae00-df7838f0b5cd.png) - -- **Albumentations**: A powerful library for image augmenting that supports a wide variety of augmentation techniques. - -- **HSV Augmentation**: Random changes to the Hue, Saturation, and Value of the images. - - ![hsv](https://user-images.githubusercontent.com/31005897/159109407-83d100ba-1aba-4f4b-aa03-4f048f815981.png) - -- **Random Horizontal Flip**: An augmentation method that randomly flips images horizontally. - - ![horizontal-flip](https://user-images.githubusercontent.com/31005897/159109429-0d44619a-a76a-49eb-bfc0-6709860c043e.png) - -## 3. Training Strategies - -YOLOv5 applies several sophisticated training strategies to enhance the model's performance. They include: - -- **Multiscale Training**: The input images are randomly rescaled within a range of 0.5 to 1.5 times their original size during the training process. -- **AutoAnchor**: This strategy optimizes the prior anchor boxes to match the statistical characteristics of the ground truth boxes in your custom data. -- **Warmup and Cosine LR Scheduler**: A method to adjust the learning rate to enhance model performance. -- **Exponential Moving Average (EMA)**: A strategy that uses the average of parameters over past steps to stabilize the training process and reduce generalization error. -- **Mixed Precision Training**: A method to perform operations in half-precision format, reducing memory usage and enhancing computational speed. -- **Hyperparameter Evolution**: A strategy to automatically tune hyperparameters to achieve optimal performance. - -## 4. Additional Features - -### 4.1 Compute Losses - -The loss in YOLOv5 is computed as a combination of three individual loss components: - -- **Classes Loss (BCE Loss)**: Binary Cross-Entropy loss, measures the error for the classification task. -- **Objectness Loss (BCE Loss)**: Another Binary Cross-Entropy loss, calculates the error in detecting whether an object is present in a particular grid cell or not. -- **Location Loss (CIoU Loss)**: Complete IoU loss, measures the error in localizing the object within the grid cell. - -The overall loss function is depicted by: - -![loss](https://latex.codecogs.com/svg.image?Loss=\lambda_1L_{cls}+\lambda_2L_{obj}+\lambda_3L_{loc}) - -### 4.2 Balance Losses - -The objectness losses of the three prediction layers (`P3`, `P4`, `P5`) are weighted differently. The balance weights are `[4.0, 1.0, 0.4]` respectively. This approach ensures that the predictions at different scales contribute appropriately to the total loss. - -![obj_loss](https://latex.codecogs.com/svg.image?L_{obj}=4.0\cdot&space;L_{obj}^{small}+1.0\cdot&space;L_{obj}^{medium}+0.4\cdot&space;L_{obj}^{large}) - -### 4.3 Eliminate Grid Sensitivity - -The YOLOv5 architecture makes some important changes to the box prediction strategy compared to earlier versions of YOLO. In YOLOv2 and YOLOv3, the box coordinates were directly predicted using the activation of the last layer. - -![b_x]() -![b_y]() -![b_w](https://latex.codecogs.com/svg.image?b_w=p_w\cdot&space;e^{t_w}) -![b_h](https://latex.codecogs.com/svg.image?b_h=p_h\cdot&space;e^{t_h}) - -YOLOv5 grid computation - -However, in YOLOv5, the formula for predicting the box coordinates has been updated to reduce grid sensitivity and prevent the model from predicting unbounded box dimensions. - -The revised formulas for calculating the predicted bounding box are as follows: - -![bx]() -![by]() -![bw]() -![bh]() - -Compare the center point offset before and after scaling. The center point offset range is adjusted from (0, 1) to (-0.5, 1.5). Therefore, offset can easily get 0 or 1. - -YOLOv5 grid scaling - -Compare the height and width scaling ratio(relative to anchor) before and after adjustment. The original yolo/darknet box equations have a serious flaw. Width and Height are completely unbounded as they are simply out=exp(in), which is dangerous, as it can lead to runaway gradients, instabilities, NaN losses and ultimately a complete loss of training. [refer this issue](https://github.com/ultralytics/yolov5/issues/471#issuecomment-662009779) - -YOLOv5 unbounded scaling - -### 4.4 Build Targets - -The build target process in YOLOv5 is critical for training efficiency and model accuracy. It involves assigning ground truth boxes to the appropriate grid cells in the output map and matching them with the appropriate anchor boxes. - -This process follows these steps: - -- Calculate the ratio of the ground truth box dimensions and the dimensions of each anchor template. - -![rw](https://latex.codecogs.com/svg.image?r_w=w_{gt}/w_{at}) - -![rh](https://latex.codecogs.com/svg.image?r_h=h_{gt}/h_{at}) - -![rwmax]() - -![rhmax]() - -![rmax]() - -![match](https://latex.codecogs.com/svg.image?r^{max}<{\rm&space;anchor_t}) - -YOLOv5 IoU computation - -- If the calculated ratio is within the threshold, match the ground truth box with the corresponding anchor. - -YOLOv5 grid overlap - -- Assign the matched anchor to the appropriate cells, keeping in mind that due to the revised center point offset, a ground truth box can be assigned to more than one anchor. Because the center point offset range is adjusted from (0, 1) to (-0.5, 1.5). GT Box can be assigned to more anchors. - -YOLOv5 anchor selection - -This way, the build targets process ensures that each ground truth object is properly assigned and matched during the training process, allowing YOLOv5 to learn the task of object detection more effectively. - -## Conclusion - -In conclusion, YOLOv5 represents a significant step forward in the development of real-time object detection models. By incorporating various new features, enhancements, and training strategies, it surpasses previous versions of the YOLO family in performance and efficiency. - -The primary enhancements in YOLOv5 include the use of a dynamic architecture, an extensive range of data augmentation techniques, innovative training strategies, as well as important adjustments in computing losses and the process of building targets. All these innovations significantly improve the accuracy and efficiency of object detection while retaining a high degree of speed, which is the trademark of YOLO models. diff --git a/ultralytics-main/docs/en/yolov5/tutorials/clearml_logging_integration.md b/ultralytics-main/docs/en/yolov5/tutorials/clearml_logging_integration.md deleted file mode 100644 index 48fce1e..0000000 --- a/ultralytics-main/docs/en/yolov5/tutorials/clearml_logging_integration.md +++ /dev/null @@ -1,237 +0,0 @@ ---- -comments: true -description: Learn how ClearML can enhance your YOLOv5 pipeline – track your training runs, version your data, remotely monitor your models and optimize performance. -keywords: ClearML, YOLOv5, Ultralytics, AI toolbox, training data, remote training, hyperparameter optimization, YOLOv5 model ---- - -# ClearML Integration - -Clear|MLClear|ML - -## About ClearML - -[ClearML](https://clear.ml/) is an [open-source](https://github.com/allegroai/clearml) toolbox designed to save you time ⏱️. - -🔨 Track every YOLOv5 training run in the experiment manager - -🔧 Version and easily access your custom training data with the integrated ClearML Data Versioning Tool - -🔦 Remotely train and monitor your YOLOv5 training runs using ClearML Agent - -🔬 Get the very best mAP using ClearML Hyperparameter Optimization - -🔭 Turn your newly trained YOLOv5 model into an API with just a few commands using ClearML Serving - -
-And so much more. It's up to you how many of these tools you want to use, you can stick to the experiment manager, or chain them all together into an impressive pipeline! -
-
- -![ClearML scalars dashboard](https://github.com/thepycoder/clearml_screenshots/raw/main/experiment_manager_with_compare.gif) - -
-
- -## 🦾 Setting Things Up - -To keep track of your experiments and/or data, ClearML needs to communicate to a server. You have 2 options to get one: - -Either sign up for free to the [ClearML Hosted Service](https://clear.ml/) or you can set up your own server, see [here](https://clear.ml/docs/latest/docs/deploying_clearml/clearml_server). Even the server is open-source, so even if you're dealing with sensitive data, you should be good to go! - -- Install the `clearml` python package: - - ```bash - pip install clearml - ``` - -- 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 - clearml-init - ``` - -That's it! You're done 😎 - -
- -## 🚀 Training YOLOv5 With ClearML - -To enable ClearML experiment tracking, simply install the ClearML pip package. - -```bash -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. - -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! - -```bash -python train.py --img 640 --batch 16 --epochs 3 --data coco128.yaml --weights yolov5s.pt --cache -``` - -or with custom project and task name: - -```bash -python train.py --project my_project --name my_training --img 640 --batch 16 --epochs 3 --data coco128.yaml --weights yolov5s.pt --cache -``` - -This will capture: - -- Source code + uncommitted changes -- Installed packages -- (Hyper)parameters -- Model files (use `--save-period n` to save a checkpoint every n epochs) -- Console output -- Scalars (mAP_0.5, mAP_0.5:0.95, precision, recall, losses, learning rates, ...) -- General info such as machine details, runtime, creation date etc. -- All produced plots such as label correlogram and confusion matrix -- Images with bounding boxes per epoch -- Mosaic per epoch -- Validation images per epoch - -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! - -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! - -### 🔗 Dataset Version Management - -Versioning your data separately from your code is generally a good idea and makes it easy to acquire the latest version too. This repository supports supplying a dataset version ID, and it will make sure to get the data if it's not there yet. Next to that, this workflow also saves the used dataset ID as part of the task parameters, so you will always know for sure which data was used in which experiment! - -![ClearML Dataset Interface](https://github.com/thepycoder/clearml_screenshots/raw/main/clearml_data.gif) - -### Prepare Your Dataset - -The YOLOv5 repository supports a number of different datasets by using YAML files containing their information. By default datasets are downloaded to the `../datasets` folder in relation to the repository root folder. So if you downloaded the `coco128` dataset using the link in the YAML or with the scripts provided by yolov5, you get this folder structure: - -``` -.. -|_ yolov5 -|_ datasets - |_ coco128 - |_ images - |_ labels - |_ LICENSE - |_ README.txt -``` - -But this can be any dataset you wish. Feel free to use your own, as long as you keep to this folder structure. - -Next, ⚠️**copy the corresponding YAML file to the root of the dataset folder**⚠️. This YAML files contains the information ClearML will need to properly use the dataset. You can make this yourself too, of course, just follow the structure of the example YAMLs. - -Basically we need the following keys: `path`, `train`, `test`, `val`, `nc`, `names`. - -``` -.. -|_ yolov5 -|_ datasets - |_ coco128 - |_ images - |_ labels - |_ coco128.yaml # <---- HERE! - |_ LICENSE - |_ README.txt -``` - -### Upload Your Dataset - -To get this dataset into ClearML as a versioned dataset, go to the dataset root folder and run the following command: - -```bash -cd coco128 -clearml-data sync --project YOLOv5 --name coco128 --folder . -``` - -The command `clearml-data sync` is actually a shorthand command. You could also run these commands one after the other: - -```bash -# Optionally add --parent if you want to base -# this version on another dataset version, so no duplicate files are uploaded! -clearml-data create --name coco128 --project YOLOv5 -clearml-data add --files . -clearml-data close -``` - -### Run Training Using A ClearML Dataset - -Now that you have a ClearML dataset, you can very simply use it to train custom YOLOv5 🚀 models! - -```bash -python train.py --img 640 --batch 16 --epochs 3 --data clearml:// --weights yolov5s.pt --cache -``` - -
- -### 👀 Hyperparameter Optimization - -Now that we have our experiments and data versioned, it's time to take a look at what we can build on top! - -Using the code information, installed packages and environment details, the experiment itself is now **completely reproducible**. In fact, ClearML allows you to clone an experiment and even change its parameters. We can then just rerun it with these new parameters automatically, this is basically what HPO does! - -To **run hyperparameter optimization locally**, we've included a pre-made script for you. Just make sure a training task has been run at least once, so it is in the ClearML experiment manager, we will essentially clone it and change its hyperparameters. - -You'll need to fill in the ID of this `template task` in the script found at `utils/loggers/clearml/hpo.py` and then just run it :) You can change `task.execute_locally()` to `task.execute()` to put it in a ClearML queue and have a remote agent work on it instead. - -```bash -# To use optuna, install it first, otherwise you can change the optimizer to just be RandomSearch -pip install optuna -python utils/loggers/clearml/hpo.py -``` - -![HPO](https://github.com/thepycoder/clearml_screenshots/raw/main/hpo.png) - -## 🤯 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. This is where the ClearML Agent comes into play. Check out what the agent can do here: - -- [YouTube video](https://youtu.be/MX3BrXnaULs) -- [Documentation](https://clear.ml/docs/latest/docs/clearml_agent) - -In short: every experiment tracked by the experiment manager contains enough information to reproduce it on a different machine (installed packages, uncommitted changes etc.). So a ClearML agent does just that: it listens to a queue for incoming tasks and when it finds one, it recreates the environment and runs it while still reporting scalars, plots etc. to the experiment manager. - -You can turn any machine (a cloud VM, a local GPU machine, your own laptop ... ) into a ClearML agent by simply running: - -```bash -clearml-agent daemon --queue [--docker] -``` - -### Cloning, Editing And Enqueuing - -With our agent running, we can give it some work. Remember from the HPO section that we can clone a task and edit the hyperparameters? We can do that from the interface too! - -🪄 Clone the experiment by right-clicking it - -🎯 Edit the hyperparameters to what you wish them to be - -⏳ Enqueue the task to any of the queues by right-clicking it - -![Enqueue a task from the UI](https://github.com/thepycoder/clearml_screenshots/raw/main/enqueue.gif) - -### Executing A Task Remotely - -Now you can clone a task like we explained above, or simply mark your current script by adding `task.execute_remotely()` and on execution it will be put into a queue, for the agent to start working on! - -To run the YOLOv5 training script remotely, all you have to do is add this line to the training.py script after the clearml logger has been instantiated: - -```python -# ... -# Loggers -data_dict = None -if RANK in {-1, 0}: - loggers = Loggers(save_dir, weights, opt, hyp, LOGGER) # loggers instance - if loggers.clearml: - loggers.clearml.task.execute_remotely(queue="my_queue") # <------ ADD THIS LINE - # Data_dict is either None is user did not choose for ClearML dataset or is filled in by ClearML - data_dict = loggers.clearml.data_dict -# ... -``` - -When running the training script after this change, python will run the script up until that line, after which it will package the code and send it to the queue instead! - -### Autoscaling workers - -ClearML comes with autoscalers too! This tool will automatically spin up new remote machines in the cloud of your choice (AWS, GCP, Azure) and turn them into ClearML agents for you whenever there are experiments detected in the queue. Once the tasks are processed, the autoscaler will automatically shut down the remote machines, and you stop paying! - -Check out the autoscalers getting started video below. - -[![Watch the video](https://img.youtube.com/vi/j4XVMAaUt3E/0.jpg)](https://youtu.be/j4XVMAaUt3E) diff --git a/ultralytics-main/docs/en/yolov5/tutorials/comet_logging_integration.md b/ultralytics-main/docs/en/yolov5/tutorials/comet_logging_integration.md deleted file mode 100644 index ae88411..0000000 --- a/ultralytics-main/docs/en/yolov5/tutorials/comet_logging_integration.md +++ /dev/null @@ -1,256 +0,0 @@ ---- -comments: true -description: Learn how to set up and use Comet to enhance your YOLOv5 model training, metrics tracking and visualization. Includes a step by step guide to integrate Comet with YOLOv5. -keywords: YOLOv5, Comet, Machine Learning, Ultralytics, Real time metrics tracking, Hyperparameters, Model checkpoints, Model predictions, YOLOv5 training, Comet Credentials ---- - -![Comet](https://cdn.comet.ml/img/notebook_logo.png) - -# YOLOv5 with Comet - -This guide will cover how to use YOLOv5 with [Comet](https://bit.ly/yolov5-readme-comet2) - -## About Comet - -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)! 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 - -### Install Comet - -```shell -pip install comet_ml -``` - -### Configure Comet Credentials - -There are two ways to configure Comet with YOLOv5. - -You can either set your credentials through environment variables - -**Environment Variables** - -```shell -export COMET_API_KEY= -export COMET_PROJECT_NAME= # This will default to 'yolov5' -``` - -Or create a `.comet.config` file in your working directory and set your credentials there. - -**Comet Configuration File** - -``` -[comet] -api_key= -project_name= # This will default to 'yolov5' -``` - -### Run the Training Script - -```shell -# Train YOLOv5s on COCO128 for 5 epochs -python train.py --img 640 --batch 16 --epochs 5 --data coco128.yaml --weights yolov5s.pt -``` - -That's it! Comet will automatically log your hyperparameters, command line arguments, training and validation metrics. You can visualize and analyze your runs in the Comet UI - -yolo-ui - -## Try out an Example! - -Check out an example of a [completed run here](https://www.comet.com/examples/comet-example-yolov5/a0e29e0e9b984e4a822db2a62d0cb357?experiment-tab=chart&showOutliers=true&smoothing=0&transformY=smoothing&xAxis=step&utm_source=yolov5&utm_medium=partner&utm_campaign=partner_yolov5_2022&utm_content=github) - -Or better yet, try it out yourself in this Colab Notebook - -[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1RG0WOQyxlDlo5Km8GogJpIEJlg_5lyYO?usp=sharing) - -## Log automatically - -By default, Comet will log the following items - -## Metrics - -- Box Loss, Object Loss, Classification Loss for the training and validation data -- mAP_0.5, mAP_0.5:0.95 metrics for the validation data. -- Precision and Recall for the validation data - -## Parameters - -- Model Hyperparameters -- All parameters passed through the command line options - -## Visualizations - -- Confusion Matrix of the model predictions on the validation data -- Plots for the PR and F1 curves across all classes -- Correlogram of the Class Labels - -## Configure Comet Logging - -Comet can be configured to log additional data either through command line flags passed to the training script or through environment variables. - -```shell -export COMET_MODE=online # Set whether to run Comet in 'online' or 'offline' mode. Defaults to online -export COMET_MODEL_NAME= #Set the name for the saved model. Defaults to yolov5 -export COMET_LOG_CONFUSION_MATRIX=false # Set to disable logging a Comet Confusion Matrix. Defaults to true -export COMET_MAX_IMAGE_UPLOADS= # Controls how many total image predictions to log to Comet. Defaults to 100. -export COMET_LOG_PER_CLASS_METRICS=true # Set to log evaluation metrics for each detected class at the end of training. Defaults to false -export COMET_DEFAULT_CHECKPOINT_FILENAME= # Set this if you would like to resume training from a different checkpoint. Defaults to 'last.pt' -export COMET_LOG_BATCH_LEVEL_METRICS=true # Set this if you would like to log training metrics at the batch level. Defaults to false. -export COMET_LOG_PREDICTIONS=true # Set this to false to disable logging model predictions -``` - -## 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 logged checkpoints to Comet based on the interval value provided by `save-period` - -```shell -python train.py \ ---img 640 \ ---batch 16 \ ---epochs 5 \ ---data coco128.yaml \ ---weights yolov5s.pt \ ---save-period 1 -``` - -## Logging Model Predictions - -By default, model predictions (images, ground truth labels and bounding boxes) will be logged to Comet. - -You can control the frequency of logged predictions and the associated images by passing the `bbox_interval` command line argument. Predictions can be visualized using Comet's Object Detection Custom Panel. This frequency corresponds to every Nth batch of data per epoch. In the example below, we are logging every 2nd batch of data for each epoch. - -**Note:** The YOLOv5 validation dataloader will default to a batch size of 32, so you will have to set the logging frequency accordingly. - -Here is an [example project using the Panel](https://www.comet.com/examples/comet-example-yolov5?shareable=YcwMiJaZSXfcEXpGOHDD12vA1&utm_source=yolov5&utm_medium=partner&utm_campaign=partner_yolov5_2022&utm_content=github) - -```shell -python train.py \ ---img 640 \ ---batch 16 \ ---epochs 5 \ ---data coco128.yaml \ ---weights yolov5s.pt \ ---bbox_interval 2 -``` - -### Controlling the number of Prediction Images logged to Comet - -When logging predictions from YOLOv5, Comet will log the images associated with each set of predictions. By default a maximum of 100 validation images are logged. You can increase or decrease this number using the `COMET_MAX_IMAGE_UPLOADS` environment variable. - -```shell -env COMET_MAX_IMAGE_UPLOADS=200 python train.py \ ---img 640 \ ---batch 16 \ ---epochs 5 \ ---data coco128.yaml \ ---weights yolov5s.pt \ ---bbox_interval 1 -``` - -### Logging Class Level Metrics - -Use the `COMET_LOG_PER_CLASS_METRICS` environment variable to log mAP, precision, recall, f1 for each class. - -```shell -env COMET_LOG_PER_CLASS_METRICS=true python train.py \ ---img 640 \ ---batch 16 \ ---epochs 5 \ ---data coco128.yaml \ ---weights yolov5s.pt -``` - -## Uploading a Dataset to Comet Artifacts - -If you would like to store your data using [Comet Artifacts](https://www.comet.com/docs/v2/guides/data-management/using-artifacts/#learn-more?utm_source=yolov5&utm_medium=partner&utm_campaign=partner_yolov5_2022&utm_content=github), you can do so using the `upload_dataset` flag. - -The dataset be organized in the way described in the [YOLOv5 documentation](train_custom_data.md). The dataset config `yaml` file must follow the same format as that of the `coco128.yaml` file. - -```shell -python train.py \ ---img 640 \ ---batch 16 \ ---epochs 5 \ ---data coco128.yaml \ ---weights yolov5s.pt \ ---upload_dataset -``` - -You can find the uploaded dataset in the Artifacts tab in your Comet Workspace artifact-1 - -You can preview the data directly in the Comet UI. artifact-2 - -Artifacts are versioned and also support adding metadata about the dataset. Comet will automatically log the metadata from your dataset `yaml` file artifact-3 - -### Using a saved Artifact - -If you would like to use a dataset from Comet Artifacts, set the `path` variable in your dataset `yaml` file to point to the following Artifact resource URL. - -``` -# contents of artifact.yaml file -path: "comet:///:" -``` - -Then pass this file to your training script in the following way - -```shell -python train.py \ ---img 640 \ ---batch 16 \ ---epochs 5 \ ---data artifact.yaml \ ---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. artifact-4 - -## Resuming a Training Run - -If your training run is interrupted for any reason, e.g. disrupted internet connection, you can resume the run using the `resume` flag and the Comet Run Path. - -The Run Path has the following format `comet:////`. - -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 -python train.py \ ---resume "comet://" -``` - -## Hyperparameter Search with the Comet Optimizer - -YOLOv5 is also integrated with Comet's Optimizer, making is simple to visualize hyperparameter sweeps in the Comet UI. - -### Configuring an Optimizer Sweep - -To configure the Comet Optimizer, you will have to create a JSON file with the information about the sweep. An example file has been provided in `utils/loggers/comet/optimizer_config.json` - -```shell -python utils/loggers/comet/hpo.py \ - --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 script. - -```shell -python utils/loggers/comet/hpo.py \ - --comet_optimizer_config "utils/loggers/comet/optimizer_config.json" \ - --save-period 1 \ - --bbox_interval 1 -``` - -### Running a Sweep in Parallel - -```shell -comet optimizer -j utils/loggers/comet/hpo.py \ - utils/loggers/comet/optimizer_config.json" -``` - -## Visualizing Results - -Comet provides a number of ways to visualize the results of your sweep. Take a look at a [project with a completed sweep here](https://www.comet.com/examples/comet-example-yolov5/view/PrlArHGuuhDTKC1UuBmTtOSXD/panels?utm_source=yolov5&utm_medium=partner&utm_campaign=partner_yolov5_2022&utm_content=github) - -hyperparameter-yolo diff --git a/ultralytics-main/docs/en/yolov5/tutorials/hyperparameter_evolution.md b/ultralytics-main/docs/en/yolov5/tutorials/hyperparameter_evolution.md deleted file mode 100644 index 13e29ca..0000000 --- a/ultralytics-main/docs/en/yolov5/tutorials/hyperparameter_evolution.md +++ /dev/null @@ -1,166 +0,0 @@ ---- -comments: true -description: Learn how to optimize YOLOv5 with hyperparameter evolution using Genetic Algorithm. This guide provides steps to initialize, define, evolve and visualize hyperparameters for top performance. -keywords: Ultralytics, YOLOv5, Hyperparameter Optimization, Genetic Algorithm, Machine Learning, Deep Learning, AI, Object Detection, Image Classification, Python ---- - -📚 This guide explains **hyperparameter evolution** for YOLOv5 🚀. Hyperparameter evolution is a method of [Hyperparameter Optimization](https://en.wikipedia.org/wiki/Hyperparameter_optimization) using a [Genetic Algorithm](https://en.wikipedia.org/wiki/Genetic_algorithm) (GA) for optimization. - -Hyperparameters in ML control various aspects of training, and finding optimal values for them can be a challenge. Traditional methods like grid searches can quickly become intractable due to 1) the high dimensional search space 2) unknown correlations among the dimensions, and 3) expensive nature of evaluating the fitness at each point, making GA a suitable candidate for hyperparameter searches. - -## Before You Start - -Clone repo and install [requirements.txt](https://github.com/ultralytics/yolov5/blob/master/requirements.txt) in a [**Python>=3.8.0**](https://www.python.org/) environment, including [**PyTorch>=1.8**](https://pytorch.org/get-started/locally/). [Models](https://github.com/ultralytics/yolov5/tree/master/models) and [datasets](https://github.com/ultralytics/yolov5/tree/master/data) download automatically from the latest YOLOv5 [release](https://github.com/ultralytics/yolov5/releases). - -```bash -git clone https://github.com/ultralytics/yolov5 # clone -cd yolov5 -pip install -r requirements.txt # install -``` - -## 1. Initialize Hyperparameters - -YOLOv5 has about 30 hyperparameters used for various training settings. These are defined in `*.yaml` files in the `/data/hyps` directory. Better initial guesses will produce better final results, so it is important to initialize these values properly before evolving. If in doubt, simply use the default values, which are optimized for YOLOv5 COCO training from scratch. - -```yaml -# YOLOv5 🚀 by Ultralytics, AGPL-3.0 license -# Hyperparameters for low-augmentation COCO training from scratch -# python train.py --batch 64 --cfg yolov5n6.yaml --weights '' --data coco.yaml --img 640 --epochs 300 --linear -# See tutorials for hyperparameter evolution https://github.com/ultralytics/yolov5#tutorials - -lr0: 0.01 # initial learning rate (SGD=1E-2, Adam=1E-3) -lrf: 0.01 # final OneCycleLR learning rate (lr0 * lrf) -momentum: 0.937 # SGD momentum/Adam beta1 -weight_decay: 0.0005 # optimizer weight decay 5e-4 -warmup_epochs: 3.0 # warmup epochs (fractions ok) -warmup_momentum: 0.8 # warmup initial momentum -warmup_bias_lr: 0.1 # warmup initial bias lr -box: 0.05 # box loss gain -cls: 0.5 # cls loss gain -cls_pw: 1.0 # cls BCELoss positive_weight -obj: 1.0 # obj loss gain (scale with pixels) -obj_pw: 1.0 # obj BCELoss positive_weight -iou_t: 0.20 # IoU training threshold -anchor_t: 4.0 # anchor-multiple threshold -# anchors: 3 # anchors per output layer (0 to ignore) -fl_gamma: 0.0 # focal loss gamma (efficientDet default gamma=1.5) -hsv_h: 0.015 # image HSV-Hue augmentation (fraction) -hsv_s: 0.7 # image HSV-Saturation augmentation (fraction) -hsv_v: 0.4 # image HSV-Value augmentation (fraction) -degrees: 0.0 # image rotation (+/- deg) -translate: 0.1 # image translation (+/- fraction) -scale: 0.5 # image scale (+/- gain) -shear: 0.0 # image shear (+/- deg) -perspective: 0.0 # image perspective (+/- fraction), range 0-0.001 -flipud: 0.0 # image flip up-down (probability) -fliplr: 0.5 # image flip left-right (probability) -mosaic: 1.0 # image mosaic (probability) -mixup: 0.0 # image mixup (probability) -copy_paste: 0.0 # segment copy-paste (probability) -``` - -## 2. Define Fitness - -Fitness is the value we seek to maximize. In YOLOv5 we define a default fitness function as a weighted combination of metrics: `mAP@0.5` contributes 10% of the weight and `mAP@0.5:0.95` contributes the remaining 90%, with [Precision `P` and Recall `R`](https://en.wikipedia.org/wiki/Precision_and_recall) absent. You may adjust these as you see fit or use the default fitness definition in utils/metrics.py (recommended). - -```python -def fitness(x): - # Model fitness as a weighted combination of metrics - w = [0.0, 0.0, 0.1, 0.9] # weights for [P, R, mAP@0.5, mAP@0.5:0.95] - return (x[:, :4] * w).sum(1) -``` - -## 3. Evolve - -Evolution is performed about a base scenario which we seek to improve upon. The base scenario in this example is finetuning COCO128 for 10 epochs using pretrained YOLOv5s. The base scenario training command is: - -```bash -python train.py --epochs 10 --data coco128.yaml --weights yolov5s.pt --cache -``` - -To evolve hyperparameters **specific to this scenario**, starting from our initial values defined in **Section 1.**, and maximizing the fitness defined in **Section 2.**, append `--evolve`: - -```bash -# Single-GPU -python train.py --epochs 10 --data coco128.yaml --weights yolov5s.pt --cache --evolve - -# Multi-GPU -for i in 0 1 2 3 4 5 6 7; do - sleep $(expr 30 \* $i) && # 30-second delay (optional) - echo 'Starting GPU '$i'...' && - nohup python train.py --epochs 10 --data coco128.yaml --weights yolov5s.pt --cache --device $i --evolve > evolve_gpu_$i.log & -done - -# Multi-GPU bash-while (not recommended) -for i in 0 1 2 3 4 5 6 7; do - sleep $(expr 30 \* $i) && # 30-second delay (optional) - echo 'Starting GPU '$i'...' && - "$(while true; do nohup python train.py... --device $i --evolve 1 > evolve_gpu_$i.log; done)" & -done -``` - -The default evolution settings will run the base scenario 300 times, i.e. for 300 generations. You can modify generations via the `--evolve` argument, i.e. `python train.py --evolve 1000`. - -The main genetic operators are **crossover** and **mutation**. In this work mutation is used, with an 80% probability and a 0.04 variance to create new offspring based on a combination of the best parents from all previous generations. Results are logged to `runs/evolve/exp/evolve.csv`, and the highest fitness offspring is saved every generation as `runs/evolve/hyp_evolved.yaml`: - -```yaml -# YOLOv5 Hyperparameter Evolution Results -# Best generation: 287 -# Last generation: 300 -# metrics/precision, metrics/recall, metrics/mAP_0.5, metrics/mAP_0.5:0.95, val/box_loss, val/obj_loss, val/cls_loss -# 0.54634, 0.55625, 0.58201, 0.33665, 0.056451, 0.042892, 0.013441 - -lr0: 0.01 # initial learning rate (SGD=1E-2, Adam=1E-3) -lrf: 0.2 # final OneCycleLR learning rate (lr0 * lrf) -momentum: 0.937 # SGD momentum/Adam beta1 -weight_decay: 0.0005 # optimizer weight decay 5e-4 -warmup_epochs: 3.0 # warmup epochs (fractions ok) -warmup_momentum: 0.8 # warmup initial momentum -warmup_bias_lr: 0.1 # warmup initial bias lr -box: 0.05 # box loss gain -cls: 0.5 # cls loss gain -cls_pw: 1.0 # cls BCELoss positive_weight -obj: 1.0 # obj loss gain (scale with pixels) -obj_pw: 1.0 # obj BCELoss positive_weight -iou_t: 0.20 # IoU training threshold -anchor_t: 4.0 # anchor-multiple threshold -# anchors: 3 # anchors per output layer (0 to ignore) -fl_gamma: 0.0 # focal loss gamma (efficientDet default gamma=1.5) -hsv_h: 0.015 # image HSV-Hue augmentation (fraction) -hsv_s: 0.7 # image HSV-Saturation augmentation (fraction) -hsv_v: 0.4 # image HSV-Value augmentation (fraction) -degrees: 0.0 # image rotation (+/- deg) -translate: 0.1 # image translation (+/- fraction) -scale: 0.5 # image scale (+/- gain) -shear: 0.0 # image shear (+/- deg) -perspective: 0.0 # image perspective (+/- fraction), range 0-0.001 -flipud: 0.0 # image flip up-down (probability) -fliplr: 0.5 # image flip left-right (probability) -mosaic: 1.0 # image mosaic (probability) -mixup: 0.0 # image mixup (probability) -copy_paste: 0.0 # segment copy-paste (probability) -``` - -We recommend a minimum of 300 generations of evolution for best results. Note that **evolution is generally expensive and time-consuming**, as the base scenario is trained hundreds of times, possibly requiring hundreds or thousands of GPU hours. - -## 4. Visualize - -`evolve.csv` is plotted as `evolve.png` by `utils.plots.plot_evolve()` after evolution finishes with one subplot per hyperparameter showing fitness (y-axis) vs hyperparameter values (x-axis). Yellow indicates higher concentrations. Vertical distributions indicate that a parameter has been disabled and does not mutate. This is user selectable in the `meta` dictionary in train.py, and is useful for fixing parameters and preventing them from evolving. - -![evolve](https://user-images.githubusercontent.com/26833433/89130469-f43e8e00-d4b9-11ea-9e28-f8ae3622516d.png) - -## Supported Environments - -Ultralytics provides a range of ready-to-use environments, each pre-installed with essential dependencies such as [CUDA](https://developer.nvidia.com/cuda), [CUDNN](https://developer.nvidia.com/cudnn), [Python](https://www.python.org/), and [PyTorch](https://pytorch.org/), to kickstart your projects. - -- **Free GPU Notebooks**: Run on Gradient Open In Colab Open In Kaggle -- **Google Cloud**: [GCP Quickstart Guide](../environments/google_cloud_quickstart_tutorial.md) -- **Amazon**: [AWS Quickstart Guide](../environments/aws_quickstart_tutorial.md) -- **Azure**: [AzureML Quickstart Guide](../environments/azureml_quickstart_tutorial.md) -- **Docker**: [Docker Quickstart Guide](../environments/docker_image_quickstart_tutorial.md) Docker Pulls - -## Project Status - -YOLOv5 CI - -This badge indicates that all [YOLOv5 GitHub Actions](https://github.com/ultralytics/yolov5/actions) Continuous Integration (CI) tests are successfully passing. These CI tests rigorously check the functionality and performance of YOLOv5 across various key aspects: [training](https://github.com/ultralytics/yolov5/blob/master/train.py), [validation](https://github.com/ultralytics/yolov5/blob/master/val.py), [inference](https://github.com/ultralytics/yolov5/blob/master/detect.py), [export](https://github.com/ultralytics/yolov5/blob/master/export.py), and [benchmarks](https://github.com/ultralytics/yolov5/blob/master/benchmarks.py). They ensure consistent and reliable operation on macOS, Windows, and Ubuntu, with tests conducted every 24 hours and upon each new commit. diff --git a/ultralytics-main/docs/en/yolov5/tutorials/model_ensembling.md b/ultralytics-main/docs/en/yolov5/tutorials/model_ensembling.md deleted file mode 100644 index 25fd218..0000000 --- a/ultralytics-main/docs/en/yolov5/tutorials/model_ensembling.md +++ /dev/null @@ -1,147 +0,0 @@ ---- -comments: true -description: Learn how to ensemble YOLOv5 models for improved mAP and Recall! Clone the repo, install requirements, and start testing and inference. -keywords: YOLOv5, object detection, ensemble learning, mAP, Recall ---- - -📚 This guide explains how to use YOLOv5 🚀 **model ensembling** during testing and inference for improved mAP and Recall. - -From [https://en.wikipedia.org/wiki/Ensemble_learning](https://en.wikipedia.org/wiki/Ensemble_learning): - -> Ensemble modeling is a process where multiple diverse models are created to predict an outcome, either by using many different modeling algorithms or using different training data sets. The ensemble model then aggregates the prediction of each base model and results in once final prediction for the unseen data. The motivation for using ensemble models is to reduce the generalization error of the prediction. As long as the base models are diverse and independent, the prediction error of the model decreases when the ensemble approach is used. The approach seeks the wisdom of crowds in making a prediction. Even though the ensemble model has multiple base models within the model, it acts and performs as a single model. - -## Before You Start - -Clone repo and install [requirements.txt](https://github.com/ultralytics/yolov5/blob/master/requirements.txt) in a [**Python>=3.8.0**](https://www.python.org/) environment, including [**PyTorch>=1.8**](https://pytorch.org/get-started/locally/). [Models](https://github.com/ultralytics/yolov5/tree/master/models) and [datasets](https://github.com/ultralytics/yolov5/tree/master/data) download automatically from the latest YOLOv5 [release](https://github.com/ultralytics/yolov5/releases). - -```bash -git clone https://github.com/ultralytics/yolov5 # clone -cd yolov5 -pip install -r requirements.txt # install -``` - -## Test Normally - -Before ensembling we want to establish the baseline performance of a single model. This command tests YOLOv5x on COCO val2017 at image size 640 pixels. `yolov5x.pt` is the largest and most accurate model available. Other options are `yolov5s.pt`, `yolov5m.pt` and `yolov5l.pt`, or you own checkpoint from training a custom dataset `./weights/best.pt`. For details on all available models please see our README [table](https://github.com/ultralytics/yolov5#pretrained-checkpoints). - -```bash -python val.py --weights yolov5x.pt --data coco.yaml --img 640 --half -``` - -Output: - -```shell -val: data=./data/coco.yaml, weights=['yolov5x.pt'], batch_size=32, imgsz=640, conf_thres=0.001, iou_thres=0.65, task=val, device=, single_cls=False, augment=False, verbose=False, save_txt=False, save_hybrid=False, save_conf=False, save_json=True, project=runs/val, name=exp, exist_ok=False, half=True -YOLOv5 🚀 v5.0-267-g6a3ee7c torch 1.9.0+cu102 CUDA:0 (Tesla P100-PCIE-16GB, 16280.875MB) - -Fusing layers... -Model Summary: 476 layers, 87730285 parameters, 0 gradients - -val: Scanning '../datasets/coco/val2017' images and labels...4952 found, 48 missing, 0 empty, 0 corrupted: 100% 5000/5000 [00:01<00:00, 2846.03it/s] -val: New cache created: ../datasets/coco/val2017.cache - Class Images Labels P R mAP@.5 mAP@.5:.95: 100% 157/157 [02:30<00:00, 1.05it/s] - all 5000 36335 0.746 0.626 0.68 0.49 -Speed: 0.1ms pre-process, 22.4ms inference, 1.4ms NMS per image at shape (32, 3, 640, 640) # <--- baseline speed - -Evaluating pycocotools mAP... saving runs/val/exp/yolov5x_predictions.json... -... - Average Precision (AP) @[ IoU=0.50:0.95 | area= all | maxDets=100 ] = 0.504 # <--- baseline mAP - Average Precision (AP) @[ IoU=0.50 | area= all | maxDets=100 ] = 0.688 - Average Precision (AP) @[ IoU=0.75 | area= all | maxDets=100 ] = 0.546 - Average Precision (AP) @[ IoU=0.50:0.95 | area= small | maxDets=100 ] = 0.351 - Average Precision (AP) @[ IoU=0.50:0.95 | area=medium | maxDets=100 ] = 0.551 - Average Precision (AP) @[ IoU=0.50:0.95 | area= large | maxDets=100 ] = 0.644 - Average Recall (AR) @[ IoU=0.50:0.95 | area= all | maxDets= 1 ] = 0.382 - Average Recall (AR) @[ IoU=0.50:0.95 | area= all | maxDets= 10 ] = 0.628 - Average Recall (AR) @[ IoU=0.50:0.95 | area= all | maxDets=100 ] = 0.681 # <--- baseline mAR - Average Recall (AR) @[ IoU=0.50:0.95 | area= small | maxDets=100 ] = 0.524 - Average Recall (AR) @[ IoU=0.50:0.95 | area=medium | maxDets=100 ] = 0.735 - Average Recall (AR) @[ IoU=0.50:0.95 | area= large | maxDets=100 ] = 0.826 -``` - -## Ensemble Test - -Multiple pretrained models may be ensembled together at test and inference time by simply appending extra models to the `--weights` argument in any existing val.py or detect.py command. This example tests an ensemble of 2 models together: - -- YOLOv5x -- YOLOv5l6 - -```bash -python val.py --weights yolov5x.pt yolov5l6.pt --data coco.yaml --img 640 --half -``` - -Output: - -```shell -val: data=./data/coco.yaml, weights=['yolov5x.pt', 'yolov5l6.pt'], batch_size=32, imgsz=640, conf_thres=0.001, iou_thres=0.6, task=val, device=, single_cls=False, augment=False, verbose=False, save_txt=False, save_hybrid=False, save_conf=False, save_json=True, project=runs/val, name=exp, exist_ok=False, half=True -YOLOv5 🚀 v5.0-267-g6a3ee7c torch 1.9.0+cu102 CUDA:0 (Tesla P100-PCIE-16GB, 16280.875MB) - -Fusing layers... -Model Summary: 476 layers, 87730285 parameters, 0 gradients # Model 1 -Fusing layers... -Model Summary: 501 layers, 77218620 parameters, 0 gradients # Model 2 -Ensemble created with ['yolov5x.pt', 'yolov5l6.pt'] # Ensemble notice - -val: Scanning '../datasets/coco/val2017.cache' images and labels... 4952 found, 48 missing, 0 empty, 0 corrupted: 100% 5000/5000 [00:00<00:00, 49695545.02it/s] - Class Images Labels P R mAP@.5 mAP@.5:.95: 100% 157/157 [03:58<00:00, 1.52s/it] - all 5000 36335 0.747 0.637 0.692 0.502 -Speed: 0.1ms pre-process, 39.5ms inference, 2.0ms NMS per image at shape (32, 3, 640, 640) # <--- ensemble speed - -Evaluating pycocotools mAP... saving runs/val/exp3/yolov5x_predictions.json... -... - Average Precision (AP) @[ IoU=0.50:0.95 | area= all | maxDets=100 ] = 0.515 # <--- ensemble mAP - Average Precision (AP) @[ IoU=0.50 | area= all | maxDets=100 ] = 0.699 - Average Precision (AP) @[ IoU=0.75 | area= all | maxDets=100 ] = 0.557 - Average Precision (AP) @[ IoU=0.50:0.95 | area= small | maxDets=100 ] = 0.356 - Average Precision (AP) @[ IoU=0.50:0.95 | area=medium | maxDets=100 ] = 0.563 - Average Precision (AP) @[ IoU=0.50:0.95 | area= large | maxDets=100 ] = 0.668 - Average Recall (AR) @[ IoU=0.50:0.95 | area= all | maxDets= 1 ] = 0.387 - Average Recall (AR) @[ IoU=0.50:0.95 | area= all | maxDets= 10 ] = 0.638 - Average Recall (AR) @[ IoU=0.50:0.95 | area= all | maxDets=100 ] = 0.689 # <--- ensemble mAR - Average Recall (AR) @[ IoU=0.50:0.95 | area= small | maxDets=100 ] = 0.526 - Average Recall (AR) @[ IoU=0.50:0.95 | area=medium | maxDets=100 ] = 0.743 - Average Recall (AR) @[ IoU=0.50:0.95 | area= large | maxDets=100 ] = 0.844 -``` - -## Ensemble Inference - -Append extra models to the `--weights` argument to run ensemble inference: - -```bash -python detect.py --weights yolov5x.pt yolov5l6.pt --img 640 --source data/images -``` - -Output: - -```bash -YOLOv5 🚀 v5.0-267-g6a3ee7c torch 1.9.0+cu102 CUDA:0 (Tesla P100-PCIE-16GB, 16280.875MB) - -Fusing layers... -Model Summary: 476 layers, 87730285 parameters, 0 gradients -Fusing layers... -Model Summary: 501 layers, 77218620 parameters, 0 gradients -Ensemble created with ['yolov5x.pt', 'yolov5l6.pt'] - -image 1/2 /content/yolov5/data/images/bus.jpg: 640x512 4 persons, 1 bus, 1 tie, Done. (0.063s) -image 2/2 /content/yolov5/data/images/zidane.jpg: 384x640 3 persons, 2 ties, Done. (0.056s) -Results saved to runs/detect/exp2 -Done. (0.223s) -``` - -YOLO inference result - -## Supported Environments - -Ultralytics provides a range of ready-to-use environments, each pre-installed with essential dependencies such as [CUDA](https://developer.nvidia.com/cuda), [CUDNN](https://developer.nvidia.com/cudnn), [Python](https://www.python.org/), and [PyTorch](https://pytorch.org/), to kickstart your projects. - -- **Free GPU Notebooks**: Run on Gradient Open In Colab Open In Kaggle -- **Google Cloud**: [GCP Quickstart Guide](../environments/google_cloud_quickstart_tutorial.md) -- **Amazon**: [AWS Quickstart Guide](../environments/aws_quickstart_tutorial.md) -- **Azure**: [AzureML Quickstart Guide](../environments/azureml_quickstart_tutorial.md) -- **Docker**: [Docker Quickstart Guide](../environments/docker_image_quickstart_tutorial.md) Docker Pulls - -## Project Status - -YOLOv5 CI - -This badge indicates that all [YOLOv5 GitHub Actions](https://github.com/ultralytics/yolov5/actions) Continuous Integration (CI) tests are successfully passing. These CI tests rigorously check the functionality and performance of YOLOv5 across various key aspects: [training](https://github.com/ultralytics/yolov5/blob/master/train.py), [validation](https://github.com/ultralytics/yolov5/blob/master/val.py), [inference](https://github.com/ultralytics/yolov5/blob/master/detect.py), [export](https://github.com/ultralytics/yolov5/blob/master/export.py), and [benchmarks](https://github.com/ultralytics/yolov5/blob/master/benchmarks.py). They ensure consistent and reliable operation on macOS, Windows, and Ubuntu, with tests conducted every 24 hours and upon each new commit. diff --git a/ultralytics-main/docs/en/yolov5/tutorials/model_export.md b/ultralytics-main/docs/en/yolov5/tutorials/model_export.md deleted file mode 100644 index abc5730..0000000 --- a/ultralytics-main/docs/en/yolov5/tutorials/model_export.md +++ /dev/null @@ -1,247 +0,0 @@ ---- -comments: true -description: Learn how to export a trained YOLOv5 model from PyTorch to different formats including TorchScript, ONNX, OpenVINO, TensorRT, and CoreML, and how to use these models. -keywords: Ultralytics, YOLOv5, model export, PyTorch, TorchScript, ONNX, OpenVINO, TensorRT, CoreML, TensorFlow ---- - -# TFLite, ONNX, CoreML, TensorRT Export - -📚 This guide explains how to export a trained YOLOv5 🚀 model from PyTorch to ONNX and TorchScript formats. - -## Before You Start - -Clone repo and install [requirements.txt](https://github.com/ultralytics/yolov5/blob/master/requirements.txt) in a [**Python>=3.8.0**](https://www.python.org/) environment, including [**PyTorch>=1.8**](https://pytorch.org/get-started/locally/). [Models](https://github.com/ultralytics/yolov5/tree/master/models) and [datasets](https://github.com/ultralytics/yolov5/tree/master/data) download automatically from the latest YOLOv5 [release](https://github.com/ultralytics/yolov5/releases). - -```bash -git clone https://github.com/ultralytics/yolov5 # clone -cd yolov5 -pip install -r requirements.txt # install -``` - -For [TensorRT](https://developer.nvidia.com/tensorrt) export example (requires GPU) see our Colab [notebook](https://colab.research.google.com/github/ultralytics/yolov5/blob/master/tutorial.ipynb#scrollTo=VTRwsvA9u7ln&line=2&uniqifier=1) appendix section. Open In Colab - -## Formats - -YOLOv5 inference is officially supported in 11 formats: - -💡 ProTip: Export to ONNX or OpenVINO for up to 3x CPU speedup. See [CPU Benchmarks](https://github.com/ultralytics/yolov5/pull/6613). 💡 ProTip: Export to TensorRT for up to 5x GPU speedup. See [GPU Benchmarks](https://github.com/ultralytics/yolov5/pull/6963). - -| Format | `export.py --include` | Model | -|:---------------------------------------------------------------------------|:----------------------|:--------------------------| -| [PyTorch](https://pytorch.org/) | - | `yolov5s.pt` | -| [TorchScript](https://pytorch.org/docs/stable/jit.html) | `torchscript` | `yolov5s.torchscript` | -| [ONNX](https://onnx.ai/) | `onnx` | `yolov5s.onnx` | -| [OpenVINO](https://docs.openvino.ai/latest/index.html) | `openvino` | `yolov5s_openvino_model/` | -| [TensorRT](https://developer.nvidia.com/tensorrt) | `engine` | `yolov5s.engine` | -| [CoreML](https://github.com/apple/coremltools) | `coreml` | `yolov5s.mlmodel` | -| [TensorFlow SavedModel](https://www.tensorflow.org/guide/saved_model) | `saved_model` | `yolov5s_saved_model/` | -| [TensorFlow GraphDef](https://www.tensorflow.org/api_docs/python/tf/Graph) | `pb` | `yolov5s.pb` | -| [TensorFlow Lite](https://www.tensorflow.org/lite) | `tflite` | `yolov5s.tflite` | -| [TensorFlow Edge TPU](https://coral.ai/docs/edgetpu/models-intro/) | `edgetpu` | `yolov5s_edgetpu.tflite` | -| [TensorFlow.js](https://www.tensorflow.org/js) | `tfjs` | `yolov5s_web_model/` | -| [PaddlePaddle](https://github.com/PaddlePaddle) | `paddle` | `yolov5s_paddle_model/` | - -## Benchmarks - -Benchmarks below run on a Colab Pro with the YOLOv5 tutorial notebook Open In Colab. To reproduce: - -```bash -python benchmarks.py --weights yolov5s.pt --imgsz 640 --device 0 -``` - -### Colab Pro V100 GPU - -``` -benchmarks: weights=/content/yolov5/yolov5s.pt, imgsz=640, batch_size=1, data=/content/yolov5/data/coco128.yaml, device=0, half=False, test=False -Checking setup... -YOLOv5 🚀 v6.1-135-g7926afc torch 1.10.0+cu111 CUDA:0 (Tesla V100-SXM2-16GB, 16160MiB) -Setup complete ✅ (8 CPUs, 51.0 GB RAM, 46.7/166.8 GB disk) - -Benchmarks complete (458.07s) - Format mAP@0.5:0.95 Inference time (ms) -0 PyTorch 0.4623 10.19 -1 TorchScript 0.4623 6.85 -2 ONNX 0.4623 14.63 -3 OpenVINO NaN NaN -4 TensorRT 0.4617 1.89 -5 CoreML NaN NaN -6 TensorFlow SavedModel 0.4623 21.28 -7 TensorFlow GraphDef 0.4623 21.22 -8 TensorFlow Lite NaN NaN -9 TensorFlow Edge TPU NaN NaN -10 TensorFlow.js NaN NaN -``` - -### Colab Pro CPU - -``` -benchmarks: weights=/content/yolov5/yolov5s.pt, imgsz=640, batch_size=1, data=/content/yolov5/data/coco128.yaml, device=cpu, half=False, test=False -Checking setup... -YOLOv5 🚀 v6.1-135-g7926afc torch 1.10.0+cu111 CPU -Setup complete ✅ (8 CPUs, 51.0 GB RAM, 41.5/166.8 GB disk) - -Benchmarks complete (241.20s) - Format mAP@0.5:0.95 Inference time (ms) -0 PyTorch 0.4623 127.61 -1 TorchScript 0.4623 131.23 -2 ONNX 0.4623 69.34 -3 OpenVINO 0.4623 66.52 -4 TensorRT NaN NaN -5 CoreML NaN NaN -6 TensorFlow SavedModel 0.4623 123.79 -7 TensorFlow GraphDef 0.4623 121.57 -8 TensorFlow Lite 0.4623 316.61 -9 TensorFlow Edge TPU NaN NaN -10 TensorFlow.js NaN NaN -``` - -## Export a Trained YOLOv5 Model - -This command exports a pretrained YOLOv5s model to TorchScript and ONNX formats. `yolov5s.pt` is the 'small' model, the second-smallest model available. Other options are `yolov5n.pt`, `yolov5m.pt`, `yolov5l.pt` and `yolov5x.pt`, along with their P6 counterparts i.e. `yolov5s6.pt` or you own custom training checkpoint i.e. `runs/exp/weights/best.pt`. For details on all available models please see our README [table](https://github.com/ultralytics/yolov5#pretrained-checkpoints). - -```bash -python export.py --weights yolov5s.pt --include torchscript onnx -``` - -💡 ProTip: Add `--half` to export models at FP16 half precision for smaller file sizes - -Output: - -```bash -export: data=data/coco128.yaml, weights=['yolov5s.pt'], imgsz=[640, 640], batch_size=1, device=cpu, half=False, inplace=False, train=False, keras=False, optimize=False, int8=False, dynamic=False, simplify=False, opset=12, verbose=False, workspace=4, nms=False, agnostic_nms=False, topk_per_class=100, topk_all=100, iou_thres=0.45, conf_thres=0.25, include=['torchscript', 'onnx'] -YOLOv5 🚀 v6.2-104-ge3e5122 Python-3.8.0 torch-1.12.1+cu113 CPU - -Downloading https://github.com/ultralytics/yolov5/releases/download/v6.2/yolov5s.pt to yolov5s.pt... -100% 14.1M/14.1M [00:00<00:00, 274MB/s] - -Fusing layers... -YOLOv5s summary: 213 layers, 7225885 parameters, 0 gradients - -PyTorch: starting from yolov5s.pt with output shape (1, 25200, 85) (14.1 MB) - -TorchScript: starting export with torch 1.12.1+cu113... -TorchScript: export success ✅ 1.7s, saved as yolov5s.torchscript (28.1 MB) - -ONNX: starting export with onnx 1.12.0... -ONNX: export success ✅ 2.3s, saved as yolov5s.onnx (28.0 MB) - -Export complete (5.5s) -Results saved to /content/yolov5 -Detect: python detect.py --weights yolov5s.onnx -Validate: python val.py --weights yolov5s.onnx -PyTorch Hub: model = torch.hub.load('ultralytics/yolov5', 'custom', 'yolov5s.onnx') -Visualize: https://netron.app/ -``` - -The 3 exported models will be saved alongside the original PyTorch model: - -

YOLO export locations

- -[Netron Viewer](https://github.com/lutzroeder/netron) is recommended for visualizing exported models: - -

YOLO model visualization

- -## Exported Model Usage Examples - -`detect.py` runs inference on exported models: - -```bash -python detect.py --weights yolov5s.pt # PyTorch - yolov5s.torchscript # TorchScript - yolov5s.onnx # ONNX Runtime or OpenCV DNN with dnn=True - yolov5s_openvino_model # OpenVINO - yolov5s.engine # TensorRT - yolov5s.mlmodel # CoreML (macOS only) - yolov5s_saved_model # TensorFlow SavedModel - yolov5s.pb # TensorFlow GraphDef - yolov5s.tflite # TensorFlow Lite - yolov5s_edgetpu.tflite # TensorFlow Edge TPU - yolov5s_paddle_model # PaddlePaddle -``` - -`val.py` runs validation on exported models: - -```bash -python val.py --weights yolov5s.pt # PyTorch - yolov5s.torchscript # TorchScript - yolov5s.onnx # ONNX Runtime or OpenCV DNN with dnn=True - yolov5s_openvino_model # OpenVINO - yolov5s.engine # TensorRT - yolov5s.mlmodel # CoreML (macOS Only) - yolov5s_saved_model # TensorFlow SavedModel - yolov5s.pb # TensorFlow GraphDef - yolov5s.tflite # TensorFlow Lite - yolov5s_edgetpu.tflite # TensorFlow Edge TPU - yolov5s_paddle_model # PaddlePaddle -``` - -Use PyTorch Hub with exported YOLOv5 models: - -```python -import torch - -# Model -model = torch.hub.load('ultralytics/yolov5', 'custom', 'yolov5s.pt') -model = torch.hub.load('ultralytics/yolov5', 'custom', 'yolov5s.torchscript ') # TorchScript -model = torch.hub.load('ultralytics/yolov5', 'custom', 'yolov5s.onnx') # ONNX Runtime -model = torch.hub.load('ultralytics/yolov5', 'custom', 'yolov5s_openvino_model') # OpenVINO -model = torch.hub.load('ultralytics/yolov5', 'custom', 'yolov5s.engine') # TensorRT -model = torch.hub.load('ultralytics/yolov5', 'custom', 'yolov5s.mlmodel') # CoreML (macOS Only) -model = torch.hub.load('ultralytics/yolov5', 'custom', 'yolov5s_saved_model') # TensorFlow SavedModel -model = torch.hub.load('ultralytics/yolov5', 'custom', 'yolov5s.pb') # TensorFlow GraphDef -model = torch.hub.load('ultralytics/yolov5', 'custom', 'yolov5s.tflite') # TensorFlow Lite -model = torch.hub.load('ultralytics/yolov5', 'custom', 'yolov5s_edgetpu.tflite') # TensorFlow Edge TPU -model = torch.hub.load('ultralytics/yolov5', 'custom', 'yolov5s_paddle_model') # PaddlePaddle - -# Images -img = 'https://ultralytics.com/images/zidane.jpg' # or file, Path, PIL, OpenCV, numpy, list - -# Inference -results = model(img) - -# Results -results.print() # or .show(), .save(), .crop(), .pandas(), etc. -``` - -## OpenCV DNN inference - -OpenCV inference with ONNX models: - -```bash -python export.py --weights yolov5s.pt --include onnx - -python detect.py --weights yolov5s.onnx --dnn # detect -python val.py --weights yolov5s.onnx --dnn # validate -``` - -## C++ Inference - -YOLOv5 OpenCV DNN C++ inference on exported ONNX model examples: - -- [https://github.com/Hexmagic/ONNX-yolov5/blob/master/src/test.cpp](https://github.com/Hexmagic/ONNX-yolov5/blob/master/src/test.cpp) -- [https://github.com/doleron/yolov5-opencv-cpp-python](https://github.com/doleron/yolov5-opencv-cpp-python) - -YOLOv5 OpenVINO C++ inference examples: - -- [https://github.com/dacquaviva/yolov5-openvino-cpp-python](https://github.com/dacquaviva/yolov5-openvino-cpp-python) -- [https://github.com/UNeedCryDear/yolov5-seg-opencv-dnn-cpp](https://github.com/UNeedCryDear/yolov5-seg-opencv-dnn-cpp) - -## TensorFlow.js Web Browser Inference - -- [https://aukerul-shuvo.github.io/YOLOv5_TensorFlow-JS/](https://aukerul-shuvo.github.io/YOLOv5_TensorFlow-JS/) - -## Supported Environments - -Ultralytics provides a range of ready-to-use environments, each pre-installed with essential dependencies such as [CUDA](https://developer.nvidia.com/cuda), [CUDNN](https://developer.nvidia.com/cudnn), [Python](https://www.python.org/), and [PyTorch](https://pytorch.org/), to kickstart your projects. - -- **Free GPU Notebooks**: Run on Gradient Open In Colab Open In Kaggle -- **Google Cloud**: [GCP Quickstart Guide](../environments/google_cloud_quickstart_tutorial.md) -- **Amazon**: [AWS Quickstart Guide](../environments/aws_quickstart_tutorial.md) -- **Azure**: [AzureML Quickstart Guide](../environments/azureml_quickstart_tutorial.md) -- **Docker**: [Docker Quickstart Guide](../environments/docker_image_quickstart_tutorial.md) Docker Pulls - -## Project Status - -YOLOv5 CI - -This badge indicates that all [YOLOv5 GitHub Actions](https://github.com/ultralytics/yolov5/actions) Continuous Integration (CI) tests are successfully passing. These CI tests rigorously check the functionality and performance of YOLOv5 across various key aspects: [training](https://github.com/ultralytics/yolov5/blob/master/train.py), [validation](https://github.com/ultralytics/yolov5/blob/master/val.py), [inference](https://github.com/ultralytics/yolov5/blob/master/detect.py), [export](https://github.com/ultralytics/yolov5/blob/master/export.py), and [benchmarks](https://github.com/ultralytics/yolov5/blob/master/benchmarks.py). They ensure consistent and reliable operation on macOS, Windows, and Ubuntu, with tests conducted every 24 hours and upon each new commit. diff --git a/ultralytics-main/docs/en/yolov5/tutorials/model_pruning_and_sparsity.md b/ultralytics-main/docs/en/yolov5/tutorials/model_pruning_and_sparsity.md deleted file mode 100644 index fddd1c6..0000000 --- a/ultralytics-main/docs/en/yolov5/tutorials/model_pruning_and_sparsity.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -comments: true -description: Improve YOLOv5 model efficiency by pruning with Ultralytics. Understand the process, conduct tests and view the impact on accuracy and sparsity. Test-maintained API environments. -keywords: YOLOv5, YOLO, Ultralytics, model pruning, PyTorch, machine learning, deep learning, computer vision, object detection ---- - -📚 This guide explains how to apply **pruning** to YOLOv5 🚀 models. - -## Before You Start - -Clone repo and install [requirements.txt](https://github.com/ultralytics/yolov5/blob/master/requirements.txt) in a [**Python>=3.8.0**](https://www.python.org/) environment, including [**PyTorch>=1.8**](https://pytorch.org/get-started/locally/). [Models](https://github.com/ultralytics/yolov5/tree/master/models) and [datasets](https://github.com/ultralytics/yolov5/tree/master/data) download automatically from the latest YOLOv5 [release](https://github.com/ultralytics/yolov5/releases). - -```bash -git clone https://github.com/ultralytics/yolov5 # clone -cd yolov5 -pip install -r requirements.txt # install -``` - -## Test Normally - -Before pruning we want to establish a baseline performance to compare to. This command tests YOLOv5x on COCO val2017 at image size 640 pixels. `yolov5x.pt` is the largest and most accurate model available. Other options are `yolov5s.pt`, `yolov5m.pt` and `yolov5l.pt`, or you own checkpoint from training a custom dataset `./weights/best.pt`. For details on all available models please see our README [table](https://github.com/ultralytics/yolov5#pretrained-checkpoints). - -```bash -python val.py --weights yolov5x.pt --data coco.yaml --img 640 --half -``` - -Output: - -```shell -val: data=/content/yolov5/data/coco.yaml, weights=['yolov5x.pt'], batch_size=32, imgsz=640, conf_thres=0.001, iou_thres=0.65, task=val, device=, workers=8, single_cls=False, augment=False, verbose=False, save_txt=False, save_hybrid=False, save_conf=False, save_json=True, project=runs/val, name=exp, exist_ok=False, half=True, dnn=False -YOLOv5 🚀 v6.0-224-g4c40933 torch 1.10.0+cu111 CUDA:0 (Tesla V100-SXM2-16GB, 16160MiB) - -Fusing layers... -Model Summary: 444 layers, 86705005 parameters, 0 gradients -val: Scanning '/content/datasets/coco/val2017.cache' images and labels... 4952 found, 48 missing, 0 empty, 0 corrupt: 100% 5000/5000 [00:00 - -30% pruned output: - -```bash -val: data=/content/yolov5/data/coco.yaml, weights=['yolov5x.pt'], batch_size=32, imgsz=640, conf_thres=0.001, iou_thres=0.65, task=val, device=, workers=8, single_cls=False, augment=False, verbose=False, save_txt=False, save_hybrid=False, save_conf=False, save_json=True, project=runs/val, name=exp, exist_ok=False, half=True, dnn=False -YOLOv5 🚀 v6.0-224-g4c40933 torch 1.10.0+cu111 CUDA:0 (Tesla V100-SXM2-16GB, 16160MiB) - -Fusing layers... -Model Summary: 444 layers, 86705005 parameters, 0 gradients -Pruning model... 0.3 global sparsity -val: Scanning '/content/datasets/coco/val2017.cache' images and labels... 4952 found, 48 missing, 0 empty, 0 corrupt: 100% 5000/5000 [00:00Run on Gradient Open In Colab Open In Kaggle -- **Google Cloud**: [GCP Quickstart Guide](../environments/google_cloud_quickstart_tutorial.md) -- **Amazon**: [AWS Quickstart Guide](../environments/aws_quickstart_tutorial.md) -- **Azure**: [AzureML Quickstart Guide](../environments/azureml_quickstart_tutorial.md) -- **Docker**: [Docker Quickstart Guide](../environments/docker_image_quickstart_tutorial.md) Docker Pulls - -## Project Status - -YOLOv5 CI - -This badge indicates that all [YOLOv5 GitHub Actions](https://github.com/ultralytics/yolov5/actions) Continuous Integration (CI) tests are successfully passing. These CI tests rigorously check the functionality and performance of YOLOv5 across various key aspects: [training](https://github.com/ultralytics/yolov5/blob/master/train.py), [validation](https://github.com/ultralytics/yolov5/blob/master/val.py), [inference](https://github.com/ultralytics/yolov5/blob/master/detect.py), [export](https://github.com/ultralytics/yolov5/blob/master/export.py), and [benchmarks](https://github.com/ultralytics/yolov5/blob/master/benchmarks.py). They ensure consistent and reliable operation on macOS, Windows, and Ubuntu, with tests conducted every 24 hours and upon each new commit. diff --git a/ultralytics-main/docs/en/yolov5/tutorials/multi_gpu_training.md b/ultralytics-main/docs/en/yolov5/tutorials/multi_gpu_training.md deleted file mode 100644 index 35c17fd..0000000 --- a/ultralytics-main/docs/en/yolov5/tutorials/multi_gpu_training.md +++ /dev/null @@ -1,190 +0,0 @@ ---- -comments: true -description: Learn how to train datasets on single or multiple GPUs using YOLOv5. Includes setup, training modes and result profiling for efficient leveraging of multiple GPUs. -keywords: YOLOv5, multi-GPU Training, YOLOv5 training, deep learning, machine learning, object detection, Ultralytics ---- - -📚 This guide explains how to properly use **multiple** GPUs to train a dataset with YOLOv5 🚀 on single or multiple machine(s). - -## Before You Start - -Clone repo and install [requirements.txt](https://github.com/ultralytics/yolov5/blob/master/requirements.txt) in a [**Python>=3.8.0**](https://www.python.org/) environment, including [**PyTorch>=1.8**](https://pytorch.org/get-started/locally/). [Models](https://github.com/ultralytics/yolov5/tree/master/models) and [datasets](https://github.com/ultralytics/yolov5/tree/master/data) download automatically from the latest YOLOv5 [release](https://github.com/ultralytics/yolov5/releases). - -```bash -git clone https://github.com/ultralytics/yolov5 # clone -cd yolov5 -pip install -r requirements.txt # install -``` - -💡 ProTip! **Docker Image** is recommended for all Multi-GPU trainings. See [Docker Quickstart Guide](https://docs.ultralytics.com/yolov5/environments/docker_image_quickstart_tutorial/) Docker Pulls - -💡 ProTip! `torch.distributed.run` replaces `torch.distributed.launch` in **PyTorch>=1.9**. See [docs](https://pytorch.org/docs/stable/distributed.html) for details. - -## Training - -Select a pretrained model to start training from. Here we select [YOLOv5s](https://github.com/ultralytics/yolov5/blob/master/models/yolov5s.yaml), the smallest and fastest model available. See our README [table](https://github.com/ultralytics/yolov5#pretrained-checkpoints) for a full comparison of all models. We will train this model with Multi-GPU on the [COCO](https://github.com/ultralytics/yolov5/blob/master/data/scripts/get_coco.sh) dataset. - -

YOLOv5 Models

- -### Single GPU - -```bash -python train.py --batch 64 --data coco.yaml --weights yolov5s.pt --device 0 -``` - -### Multi-GPU [DataParallel](https://pytorch.org/docs/stable/nn.html#torch.nn.DataParallel) Mode (⚠️ not recommended) - -You can increase the `device` to use Multiple GPUs in DataParallel mode. - -```bash -python train.py --batch 64 --data coco.yaml --weights yolov5s.pt --device 0,1 -``` - -This method is slow and barely speeds up training compared to using just 1 GPU. - -### Multi-GPU [DistributedDataParallel](https://pytorch.org/docs/stable/nn.html#torch.nn.parallel.DistributedDataParallel) Mode (✅ recommended) - -You will have to pass `python -m torch.distributed.run --nproc_per_node`, followed by the usual arguments. - -```bash -python -m torch.distributed.run --nproc_per_node 2 train.py --batch 64 --data coco.yaml --weights yolov5s.pt --device 0,1 -``` - -`--nproc_per_node` specifies how many GPUs you would like to use. In the example above, it is 2. -`--batch ` is the total batch-size. It will be divided evenly to each GPU. In the example above, it is 64/2=32 per GPU. - -The code above will use GPUs `0... (N-1)`. - -
- Use specific GPUs (click to expand) - -You can do so by simply passing `--device` followed by your specific GPUs. For example, in the code below, we will use GPUs `2,3`. - -```bash -python -m torch.distributed.run --nproc_per_node 2 train.py --batch 64 --data coco.yaml --cfg yolov5s.yaml --weights '' --device 2,3 -``` - -
- -
- Use SyncBatchNorm (click to expand) - -[SyncBatchNorm](https://pytorch.org/docs/master/generated/torch.nn.SyncBatchNorm.html) could increase accuracy for multiple gpu training, however, it will slow down training by a significant factor. It is **only** available for Multiple GPU DistributedDataParallel training. - -It is best used when the batch-size on **each** GPU is small (<= 8). - -To use SyncBatchNorm, simple pass `--sync-bn` to the command like below, - -```bash -python -m torch.distributed.run --nproc_per_node 2 train.py --batch 64 --data coco.yaml --cfg yolov5s.yaml --weights '' --sync-bn -``` - -
- -
- Use Multiple machines (click to expand) - -This is **only** available for Multiple GPU DistributedDataParallel training. - -Before we continue, make sure the files on all machines are the same, dataset, codebase, etc. Afterward, make sure the machines can communicate to each other. - -You will have to choose a master machine(the machine that the others will talk to). Note down its address(`master_addr`) and choose a port(`master_port`). I will use `master_addr = 192.168.1.1` and `master_port = 1234` for the example below. - -To use it, you can do as the following, - -```bash -# On master machine 0 -python -m torch.distributed.run --nproc_per_node G --nnodes N --node_rank 0 --master_addr "192.168.1.1" --master_port 1234 train.py --batch 64 --data coco.yaml --cfg yolov5s.yaml --weights '' -``` - -```bash -# On machine R -python -m torch.distributed.run --nproc_per_node G --nnodes N --node_rank R --master_addr "192.168.1.1" --master_port 1234 train.py --batch 64 --data coco.yaml --cfg yolov5s.yaml --weights '' -``` - -where `G` is number of GPU per machine, `N` is the number of machines, and `R` is the machine number from `0...(N-1)`. Let's say I have two machines with two GPUs each, it would be `G = 2` , `N = 2`, and `R = 1` for the above. - -Training will not start until all `N` machines are connected. Output will only be shown on master machine! - -
- -### Notes - -- Windows support is untested, Linux is recommended. -- `--batch ` must be a multiple of the number of GPUs. -- GPU 0 will take slightly more memory than the other GPUs as it maintains EMA and is responsible for checkpointing etc. -- If you get `RuntimeError: Address already in use`, it could be because you are running multiple trainings at a time. To fix this, simply use a different port number by adding `--master_port` like below, - -```bash -python -m torch.distributed.run --master_port 1234 --nproc_per_node 2 ... -``` - -## Results - -DDP profiling results on an [AWS EC2 P4d instance](https://docs.ultralytics.com/yolov5/environments/aws_quickstart_tutorial/) with 8x A100 SXM4-40GB for YOLOv5l for 1 COCO epoch. - -
- Profiling code - -```bash -# prepare -t=ultralytics/yolov5:latest && sudo docker pull $t && sudo docker run -it --ipc=host --gpus all -v "$(pwd)"/coco:/usr/src/coco $t -pip3 install torch==1.9.0+cu111 torchvision==0.10.0+cu111 -f https://download.pytorch.org/whl/torch_stable.html -cd .. && rm -rf app && git clone https://github.com/ultralytics/yolov5 -b master app && cd app -cp data/coco.yaml data/coco_profile.yaml - -# profile -python train.py --batch-size 16 --data coco_profile.yaml --weights yolov5l.pt --epochs 1 --device 0 -python -m torch.distributed.run --nproc_per_node 2 train.py --batch-size 32 --data coco_profile.yaml --weights yolov5l.pt --epochs 1 --device 0,1 -python -m torch.distributed.run --nproc_per_node 4 train.py --batch-size 64 --data coco_profile.yaml --weights yolov5l.pt --epochs 1 --device 0,1,2,3 -python -m torch.distributed.run --nproc_per_node 8 train.py --batch-size 128 --data coco_profile.yaml --weights yolov5l.pt --epochs 1 --device 0,1,2,3,4,5,6,7 -``` - -
- -| GPUs
A100 | batch-size | CUDA_mem
device0 (G) | COCO
train | COCO
val | -|--------------|------------|------------------------------|--------------------|------------------| -| 1x | 16 | 26GB | 20:39 | 0:55 | -| 2x | 32 | 26GB | 11:43 | 0:57 | -| 4x | 64 | 26GB | 5:57 | 0:55 | -| 8x | 128 | 26GB | 3:09 | 0:57 | - -## FAQ - -If an error occurs, please read the checklist below first! (It could save your time) - -
- Checklist (click to expand) - -
    -
  • Have you properly read this post?
    • -
  • Have you tried to re-clone the codebase? The code changes daily.
    • -
  • Have you tried to search for your error? Someone may have already encountered it in this repo or in another and have the solution.
    • -
  • Have you installed all the requirements listed on top (including the correct Python and Pytorch versions)?
    • -
  • Have you tried in other environments listed in the "Environments" section below?
    • -
  • Have you tried with another dataset like coco128 or coco2017? It will make it easier to find the root cause.
    • -
- -If you went through all the above, feel free to raise an Issue by giving as much detail as possible following the template. - -
- -## Supported Environments - -Ultralytics provides a range of ready-to-use environments, each pre-installed with essential dependencies such as [CUDA](https://developer.nvidia.com/cuda), [CUDNN](https://developer.nvidia.com/cudnn), [Python](https://www.python.org/), and [PyTorch](https://pytorch.org/), to kickstart your projects. - -- **Free GPU Notebooks**: Run on Gradient Open In Colab Open In Kaggle -- **Google Cloud**: [GCP Quickstart Guide](../environments/google_cloud_quickstart_tutorial.md) -- **Amazon**: [AWS Quickstart Guide](../environments/aws_quickstart_tutorial.md) -- **Azure**: [AzureML Quickstart Guide](../environments/azureml_quickstart_tutorial.md) -- **Docker**: [Docker Quickstart Guide](../environments/docker_image_quickstart_tutorial.md) Docker Pulls - -## Project Status - -YOLOv5 CI - -This badge indicates that all [YOLOv5 GitHub Actions](https://github.com/ultralytics/yolov5/actions) Continuous Integration (CI) tests are successfully passing. These CI tests rigorously check the functionality and performance of YOLOv5 across various key aspects: [training](https://github.com/ultralytics/yolov5/blob/master/train.py), [validation](https://github.com/ultralytics/yolov5/blob/master/val.py), [inference](https://github.com/ultralytics/yolov5/blob/master/detect.py), [export](https://github.com/ultralytics/yolov5/blob/master/export.py), and [benchmarks](https://github.com/ultralytics/yolov5/blob/master/benchmarks.py). They ensure consistent and reliable operation on macOS, Windows, and Ubuntu, with tests conducted every 24 hours and upon each new commit. - -## Credits - -We would like to thank @MagicFrogSJTU, who did all the heavy lifting, and @glenn-jocher for guiding us along the way. diff --git a/ultralytics-main/docs/en/yolov5/tutorials/neural_magic_pruning_quantization.md b/ultralytics-main/docs/en/yolov5/tutorials/neural_magic_pruning_quantization.md deleted file mode 100644 index 37c89c1..0000000 --- a/ultralytics-main/docs/en/yolov5/tutorials/neural_magic_pruning_quantization.md +++ /dev/null @@ -1,264 +0,0 @@ ---- -comments: true -description: Explore how to achieve exceptional AI performance with DeepSparse's incredible inference speed. Discover how to deploy YOLOv5, and learn about model sparsification and fine-tuning with SparseML. -keywords: YOLOv5, DeepSparse, Ultralytics, Neural Magic, sparsification, inference runtime, deep learning, deployment, model fine-tuning, SparseML, AI performance, GPU-class performance ---- - - - -Welcome to software-delivered AI. - -This guide explains how to deploy YOLOv5 with Neural Magic's DeepSparse. - -DeepSparse is an inference runtime with exceptional performance on CPUs. For instance, compared to the ONNX Runtime baseline, DeepSparse offers a 5.8x speed-up for YOLOv5s, running on the same machine! - -

- YOLOv5 speed improvement -

- -For the first time, your deep learning workloads can meet the performance demands of production without the complexity and costs of hardware accelerators. Put simply, DeepSparse gives you the performance of GPUs and the simplicity of software: - -- **Flexible Deployments**: Run consistently across cloud, data center, and edge with any hardware provider from Intel to AMD to ARM -- **Infinite Scalability**: Scale vertically to 100s of cores, out with standard Kubernetes, or fully-abstracted with Serverless -- **Easy Integration**: Clean APIs for integrating your model into an application and monitoring it in production - -### How Does DeepSparse Achieve GPU-Class Performance? - -DeepSparse takes advantage of model sparsity to gain its performance speedup. - -Sparsification through pruning and quantization is a broadly studied technique, allowing order-of-magnitude reductions in the size and compute needed to execute a network, while maintaining high accuracy. DeepSparse is sparsity-aware, meaning it skips the zeroed out parameters, shrinking amount of compute in a forward pass. Since the sparse computation is now memory bound, DeepSparse executes the network depth-wise, breaking the problem into Tensor Columns, vertical stripes of computation that fit in cache. - -

- YOLO model pruning -

- -Sparse networks with compressed computation, executed depth-wise in cache, allows DeepSparse to deliver GPU-class performance on CPUs! - -### How Do I Create A Sparse Version of YOLOv5 Trained on My Data? - -Neural Magic's open-source model repository, SparseZoo, contains pre-sparsified checkpoints of each YOLOv5 model. Using SparseML, which is integrated with Ultralytics, you can fine-tune a sparse checkpoint onto your data with a single CLI command. - -[Checkout Neural Magic's YOLOv5 documentation for more details](https://docs.neuralmagic.com/computer-vision/object-detection/). - -## DeepSparse Usage - -We will walk through an example benchmarking and deploying a sparse version of YOLOv5s with DeepSparse. - -### Install DeepSparse - -Run the following to install DeepSparse. We recommend you use a virtual environment with Python. - -```bash -pip install "deepsparse[server,yolo,onnxruntime]" -``` - -### Collect an ONNX File - -DeepSparse accepts a model in the ONNX format, passed either as: - -- A SparseZoo stub which identifies an ONNX file in the SparseZoo -- A local path to an ONNX model in a filesystem - -The examples below use the standard dense and pruned-quantized YOLOv5s checkpoints, identified by the following SparseZoo stubs: - -```bash -zoo:cv/detection/yolov5-s/pytorch/ultralytics/coco/base-none -zoo:cv/detection/yolov5-s/pytorch/ultralytics/coco/pruned65_quant-none -``` - -### Deploy a Model - -DeepSparse offers convenient APIs for integrating your model into an application. - -To try the deployment examples below, pull down a sample image and save it as `basilica.jpg` with the following: - -```bash -wget -O basilica.jpg https://raw.githubusercontent.com/neuralmagic/deepsparse/main/src/deepsparse/yolo/sample_images/basilica.jpg -``` - -#### Python API - -`Pipelines` wrap pre-processing and output post-processing around the runtime, providing a clean interface for adding DeepSparse to an application. The DeepSparse-Ultralytics integration includes an out-of-the-box `Pipeline` that accepts raw images and outputs the bounding boxes. - -Create a `Pipeline` and run inference: - -```python -from deepsparse import Pipeline - -# list of images in local filesystem -images = ["basilica.jpg"] - -# create Pipeline -model_stub = "zoo:cv/detection/yolov5-s/pytorch/ultralytics/coco/pruned65_quant-none" -yolo_pipeline = Pipeline.create( - task="yolo", - model_path=model_stub, -) - -# run inference on images, receive bounding boxes + classes -pipeline_outputs = yolo_pipeline(images=images, iou_thres=0.6, conf_thres=0.001) -print(pipeline_outputs) -``` - -If you are running in the cloud, you may get an error that open-cv cannot find `libGL.so.1`. Running the following on Ubuntu installs it: - -``` -apt-get install libgl1 -``` - -#### HTTP Server - -DeepSparse Server runs on top of the popular FastAPI web framework and Uvicorn web server. With just a single CLI command, you can easily setup a model service endpoint with DeepSparse. The Server supports any Pipeline from DeepSparse, including object detection with YOLOv5, enabling you to send raw images to the endpoint and receive the bounding boxes. - -Spin up the Server with the pruned-quantized YOLOv5s: - -```bash -deepsparse.server \ - --task yolo \ - --model_path zoo:cv/detection/yolov5-s/pytorch/ultralytics/coco/pruned65_quant-none -``` - -An example request, using Python's `requests` package: - -```python -import requests, json - -# list of images for inference (local files on client side) -path = ['basilica.jpg'] -files = [('request', open(img, 'rb')) for img in path] - -# send request over HTTP to /predict/from_files endpoint -url = 'http://0.0.0.0:5543/predict/from_files' -resp = requests.post(url=url, files=files) - -# response is returned in JSON -annotations = json.loads(resp.text) # dictionary of annotation results -bounding_boxes = annotations["boxes"] -labels = annotations["labels"] -``` - -#### Annotate CLI - -You can also use the annotate command to have the engine save an annotated photo on disk. Try --source 0 to annotate your live webcam feed! - -```bash -deepsparse.object_detection.annotate --model_filepath zoo:cv/detection/yolov5-s/pytorch/ultralytics/coco/pruned65_quant-none --source basilica.jpg -``` - -Running the above command will create an `annotation-results` folder and save the annotated image inside. - -

-annotated -

- -## Benchmarking Performance - -We will compare DeepSparse's throughput to ONNX Runtime's throughput on YOLOv5s, using DeepSparse's benchmarking script. - -The benchmarks were run on an AWS `c6i.8xlarge` instance (16 cores). - -### Batch 32 Performance Comparison - -#### ONNX Runtime Baseline - -At batch 32, ONNX Runtime achieves 42 images/sec with the standard dense YOLOv5s: - -```bash -deepsparse.benchmark zoo:cv/detection/yolov5-s/pytorch/ultralytics/coco/base-none -s sync -b 32 -nstreams 1 -e onnxruntime - -> Original Model Path: zoo:cv/detection/yolov5-s/pytorch/ultralytics/coco/base-none -> Batch Size: 32 -> Scenario: sync -> Throughput (items/sec): 41.9025 -``` - -#### DeepSparse Dense Performance - -While DeepSparse offers its best performance with optimized sparse models, it also performs well with the standard dense YOLOv5s. - -At batch 32, DeepSparse achieves 70 images/sec with the standard dense YOLOv5s, a **1.7x performance improvement over ORT**! - -```bash -deepsparse.benchmark zoo:cv/detection/yolov5-s/pytorch/ultralytics/coco/base-none -s sync -b 32 -nstreams 1 - -> Original Model Path: zoo:cv/detection/yolov5-s/pytorch/ultralytics/coco/base-none -> Batch Size: 32 -> Scenario: sync -> Throughput (items/sec): 69.5546 -``` - -#### DeepSparse Sparse Performance - -When sparsity is applied to the model, DeepSparse's performance gains over ONNX Runtime is even stronger. - -At batch 32, DeepSparse achieves 241 images/sec with the pruned-quantized YOLOv5s, a **5.8x performance improvement over ORT**! - -```bash -deepsparse.benchmark zoo:cv/detection/yolov5-s/pytorch/ultralytics/coco/pruned65_quant-none -s sync -b 32 -nstreams 1 - -> Original Model Path: zoo:cv/detection/yolov5-s/pytorch/ultralytics/coco/pruned65_quant-none -> Batch Size: 32 -> Scenario: sync -> Throughput (items/sec): 241.2452 -``` - -### Batch 1 Performance Comparison - -DeepSparse is also able to gain a speed-up over ONNX Runtime for the latency-sensitive, batch 1 scenario. - -#### ONNX Runtime Baseline - -At batch 1, ONNX Runtime achieves 48 images/sec with the standard, dense YOLOv5s. - -```bash -deepsparse.benchmark zoo:cv/detection/yolov5-s/pytorch/ultralytics/coco/base-none -s sync -b 1 -nstreams 1 -e onnxruntime - -> Original Model Path: zoo:cv/detection/yolov5-s/pytorch/ultralytics/coco/base-none -> Batch Size: 1 -> Scenario: sync -> Throughput (items/sec): 48.0921 -``` - -#### DeepSparse Sparse Performance - -At batch 1, DeepSparse achieves 135 items/sec with a pruned-quantized YOLOv5s, **a 2.8x performance gain over ONNX Runtime!** - -```bash -deepsparse.benchmark zoo:cv/detection/yolov5-s/pytorch/ultralytics/coco/pruned65_quant-none -s sync -b 1 -nstreams 1 - -> Original Model Path: zoo:cv/detection/yolov5-s/pytorch/ultralytics/coco/pruned65_quant-none -> Batch Size: 1 -> Scenario: sync -> Throughput (items/sec): 134.9468 -``` - -Since `c6i.8xlarge` instances have VNNI instructions, DeepSparse's throughput can be pushed further if weights are pruned in blocks of 4. - -At batch 1, DeepSparse achieves 180 items/sec with a 4-block pruned-quantized YOLOv5s, a **3.7x performance gain over ONNX Runtime!** - -```bash -deepsparse.benchmark zoo:cv/detection/yolov5-s/pytorch/ultralytics/coco/pruned35_quant-none-vnni -s sync -b 1 -nstreams 1 - -> Original Model Path: zoo:cv/detection/yolov5-s/pytorch/ultralytics/coco/pruned35_quant-none-vnni -> Batch Size: 1 -> Scenario: sync -> Throughput (items/sec): 179.7375 -``` - -## Get Started With DeepSparse - -**Research or Testing?** DeepSparse Community is free for research and testing. Get started with our [Documentation](https://docs.neuralmagic.com/). diff --git a/ultralytics-main/docs/en/yolov5/tutorials/pytorch_hub_model_loading.md b/ultralytics-main/docs/en/yolov5/tutorials/pytorch_hub_model_loading.md deleted file mode 100644 index 4cc828d..0000000 --- a/ultralytics-main/docs/en/yolov5/tutorials/pytorch_hub_model_loading.md +++ /dev/null @@ -1,372 +0,0 @@ ---- -comments: true -description: Detailed guide on loading YOLOv5 from PyTorch Hub. Includes examples & tips on inference settings, multi-GPU inference, training and more. -keywords: Ultralytics, YOLOv5, PyTorch, loading YOLOv5, PyTorch Hub, inference, multi-GPU inference, training ---- - -📚 This guide explains how to load YOLOv5 🚀 from PyTorch Hub at [https://pytorch.org/hub/ultralytics_yolov5](https://pytorch.org/hub/ultralytics_yolov5). - -## Before You Start - -Install [requirements.txt](https://github.com/ultralytics/yolov5/blob/master/requirements.txt) in a [**Python>=3.8.0**](https://www.python.org/) environment, including [**PyTorch>=1.8**](https://pytorch.org/get-started/locally/). [Models](https://github.com/ultralytics/yolov5/tree/master/models) and [datasets](https://github.com/ultralytics/yolov5/tree/master/data) download automatically from the latest YOLOv5 [release](https://github.com/ultralytics/yolov5/releases). - -```bash -pip install -r https://raw.githubusercontent.com/ultralytics/yolov5/master/requirements.txt -``` - -💡 ProTip: Cloning [https://github.com/ultralytics/yolov5](https://github.com/ultralytics/yolov5) is **not** required 😃 - -## Load YOLOv5 with PyTorch Hub - -### Simple Example - -This example loads a pretrained YOLOv5s model from PyTorch Hub as `model` and passes an image for inference. `'yolov5s'` is the lightest and fastest YOLOv5 model. For details on all available models please see the [README](https://github.com/ultralytics/yolov5#pretrained-checkpoints). - -```python -import torch - -# Model -model = torch.hub.load('ultralytics/yolov5', 'yolov5s') - -# Image -im = 'https://ultralytics.com/images/zidane.jpg' - -# Inference -results = model(im) - -results.pandas().xyxy[0] -# xmin ymin xmax ymax confidence class name -# 0 749.50 43.50 1148.0 704.5 0.874023 0 person -# 1 433.50 433.50 517.5 714.5 0.687988 27 tie -# 2 114.75 195.75 1095.0 708.0 0.624512 0 person -# 3 986.00 304.00 1028.0 420.0 0.286865 27 tie -``` - -### Detailed Example - -This example shows **batched inference** with **PIL** and **OpenCV** image sources. `results` can be **printed** to console, **saved** to `runs/hub`, **showed** to screen on supported environments, and returned as **tensors** or **pandas** dataframes. - -```python -import cv2 -import torch -from PIL import Image - -# Model -model = torch.hub.load('ultralytics/yolov5', 'yolov5s') - -# Images -for f in 'zidane.jpg', 'bus.jpg': - torch.hub.download_url_to_file('https://ultralytics.com/images/' + f, f) # download 2 images -im1 = Image.open('zidane.jpg') # PIL image -im2 = cv2.imread('bus.jpg')[..., ::-1] # OpenCV image (BGR to RGB) - -# Inference -results = model([im1, im2], size=640) # batch of images - -# Results -results.print() -results.save() # or .show() - -results.xyxy[0] # im1 predictions (tensor) -results.pandas().xyxy[0] # im1 predictions (pandas) -# xmin ymin xmax ymax confidence class name -# 0 749.50 43.50 1148.0 704.5 0.874023 0 person -# 1 433.50 433.50 517.5 714.5 0.687988 27 tie -# 2 114.75 195.75 1095.0 708.0 0.624512 0 person -# 3 986.00 304.00 1028.0 420.0 0.286865 27 tie -``` - -YOLO inference results on zidane.jpg -YOLO inference results on bus.jpg - -For all inference options see YOLOv5 `AutoShape()` forward [method](https://github.com/ultralytics/yolov5/blob/30e4c4f09297b67afedf8b2bcd851833ddc9dead/models/common.py#L243-L252). - -### Inference Settings - -YOLOv5 models contain various inference attributes such as **confidence threshold**, **IoU threshold**, etc. which can be set by: - -```python -model.conf = 0.25 # NMS confidence threshold -iou = 0.45 # NMS IoU threshold -agnostic = False # NMS class-agnostic -multi_label = False # NMS multiple labels per box -classes = None # (optional list) filter by class, i.e. = [0, 15, 16] for COCO persons, cats and dogs -max_det = 1000 # maximum number of detections per image -amp = False # Automatic Mixed Precision (AMP) inference - -results = model(im, size=320) # custom inference size -``` - -### Device - -Models can be transferred to any device after creation: - -```python -model.cpu() # CPU -model.cuda() # GPU -model.to(device) # i.e. device=torch.device(0) -``` - -Models can also be created directly on any `device`: - -```python -model = torch.hub.load('ultralytics/yolov5', 'yolov5s', device='cpu') # load on CPU -``` - -💡 ProTip: Input images are automatically transferred to the correct model device before inference. - -### Silence Outputs - -Models can be loaded silently with `_verbose=False`: - -```python -model = torch.hub.load('ultralytics/yolov5', 'yolov5s', _verbose=False) # load silently -``` - -### Input Channels - -To load a pretrained YOLOv5s model with 4 input channels rather than the default 3: - -```python -model = torch.hub.load('ultralytics/yolov5', 'yolov5s', channels=4) -``` - -In this case the model will be composed of pretrained weights **except for** the very first input layer, which is no longer the same shape as the pretrained input layer. The input layer will remain initialized by random weights. - -### Number of Classes - -To load a pretrained YOLOv5s model with 10 output classes rather than the default 80: - -```python -model = torch.hub.load('ultralytics/yolov5', 'yolov5s', classes=10) -``` - -In this case the model will be composed of pretrained weights **except for** the output layers, which are no longer the same shape as the pretrained output layers. The output layers will remain initialized by random weights. - -### Force Reload - -If you run into problems with the above steps, setting `force_reload=True` may help by discarding the existing cache and force a fresh download of the latest YOLOv5 version from PyTorch Hub. - -```python -model = torch.hub.load('ultralytics/yolov5', 'yolov5s', force_reload=True) # force reload -``` - -### Screenshot Inference - -To run inference on your desktop screen: - -```python -import torch -from PIL import ImageGrab - -# Model -model = torch.hub.load('ultralytics/yolov5', 'yolov5s') - -# Image -im = ImageGrab.grab() # take a screenshot - -# Inference -results = model(im) -``` - -### Multi-GPU Inference - -YOLOv5 models can be loaded to multiple GPUs in parallel with threaded inference: - -```python -import torch -import threading - - -def run(model, im): - results = model(im) - results.save() - - -# Models -model0 = torch.hub.load('ultralytics/yolov5', 'yolov5s', device=0) -model1 = torch.hub.load('ultralytics/yolov5', 'yolov5s', device=1) - -# Inference -threading.Thread(target=run, args=[model0, 'https://ultralytics.com/images/zidane.jpg'], daemon=True).start() -threading.Thread(target=run, args=[model1, 'https://ultralytics.com/images/bus.jpg'], daemon=True).start() -``` - -### Training - -To load a YOLOv5 model for training rather than inference, set `autoshape=False`. To load a model with randomly initialized weights (to train from scratch) use `pretrained=False`. You must provide your own training script in this case. Alternatively see our YOLOv5 [Train Custom Data Tutorial](https://docs.ultralytics.com/yolov5/tutorials/train_custom_data) for model training. - -```python -import torch - -model = torch.hub.load('ultralytics/yolov5', 'yolov5s', autoshape=False) # load pretrained -model = torch.hub.load('ultralytics/yolov5', 'yolov5s', autoshape=False, pretrained=False) # load scratch -``` - -### Base64 Results - -For use with API services. See https://github.com/ultralytics/yolov5/pull/2291 and [Flask REST API](https://github.com/ultralytics/yolov5/tree/master/utils/flask_rest_api) example for details. - -```python -results = model(im) # inference - -results.ims # array of original images (as np array) passed to model for inference -results.render() # updates results.ims with boxes and labels -for im in results.ims: - buffered = BytesIO() - im_base64 = Image.fromarray(im) - im_base64.save(buffered, format="JPEG") - print(base64.b64encode(buffered.getvalue()).decode('utf-8')) # base64 encoded image with results -``` - -### Cropped Results - -Results can be returned and saved as detection crops: - -```python -results = model(im) # inference -crops = results.crop(save=True) # cropped detections dictionary -``` - -### Pandas Results - -Results can be returned as [Pandas DataFrames](https://pandas.pydata.org/): - -```python -results = model(im) # inference -results.pandas().xyxy[0] # Pandas DataFrame -``` - -
- Pandas Output (click to expand) - -```python -print(results.pandas().xyxy[0]) -# xmin ymin xmax ymax confidence class name -# 0 749.50 43.50 1148.0 704.5 0.874023 0 person -# 1 433.50 433.50 517.5 714.5 0.687988 27 tie -# 2 114.75 195.75 1095.0 708.0 0.624512 0 person -# 3 986.00 304.00 1028.0 420.0 0.286865 27 tie -``` - -
- -### Sorted Results - -Results can be sorted by column, i.e. to sort license plate digit detection left-to-right (x-axis): - -```python -results = model(im) # inference -results.pandas().xyxy[0].sort_values('xmin') # sorted left-right -``` - -### Box-Cropped Results - -Results can be returned and saved as detection crops: - -```python -results = model(im) # inference -crops = results.crop(save=True) # cropped detections dictionary -``` - -### JSON Results - -Results can be returned in JSON format once converted to `.pandas()` dataframes using the `.to_json()` method. The JSON format can be modified using the `orient` argument. See pandas `.to_json()` [documentation](https://pandas.pydata.org/docs/reference/api/pandas.DataFrame.to_json.html) for details. - -```python -results = model(ims) # inference -results.pandas().xyxy[0].to_json(orient="records") # JSON img1 predictions -``` - -
- JSON Output (click to expand) - -```json -[ - { - "xmin": 749.5, - "ymin": 43.5, - "xmax": 1148.0, - "ymax": 704.5, - "confidence": 0.8740234375, - "class": 0, - "name": "person" - }, - { - "xmin": 433.5, - "ymin": 433.5, - "xmax": 517.5, - "ymax": 714.5, - "confidence": 0.6879882812, - "class": 27, - "name": "tie" - }, - { - "xmin": 115.25, - "ymin": 195.75, - "xmax": 1096.0, - "ymax": 708.0, - "confidence": 0.6254882812, - "class": 0, - "name": "person" - }, - { - "xmin": 986.0, - "ymin": 304.0, - "xmax": 1028.0, - "ymax": 420.0, - "confidence": 0.2873535156, - "class": 27, - "name": "tie" - } -] -``` - -
- -## Custom Models - -This example loads a custom 20-class [VOC](https://github.com/ultralytics/yolov5/blob/master/data/VOC.yaml)-trained YOLOv5s model `'best.pt'` with PyTorch Hub. - -```python -import torch - -model = torch.hub.load('ultralytics/yolov5', 'custom', path='path/to/best.pt') # local model -model = torch.hub.load('path/to/yolov5', 'custom', path='path/to/best.pt', source='local') # local repo -``` - -## TensorRT, ONNX and OpenVINO Models - -PyTorch Hub supports inference on most YOLOv5 export formats, including custom trained models. See [TFLite, ONNX, CoreML, TensorRT Export tutorial](https://docs.ultralytics.com/yolov5/tutorials/model_export) for details on exporting models. - -💡 ProTip: **TensorRT** may be up to 2-5X faster than PyTorch on [**GPU benchmarks**](https://github.com/ultralytics/yolov5/pull/6963) -💡 ProTip: **ONNX** and **OpenVINO** may be up to 2-3X faster than PyTorch on [**CPU benchmarks**](https://github.com/ultralytics/yolov5/pull/6613) - -```python -import torch - -model = torch.hub.load('ultralytics/yolov5', 'custom', path='yolov5s.pt') # PyTorch -model = torch.hub.load('ultralytics/yolov5', 'custom', path='yolov5s.torchscript') # TorchScript -model = torch.hub.load('ultralytics/yolov5', 'custom', path='yolov5s.onnx') # ONNX -model = torch.hub.load('ultralytics/yolov5', 'custom', path='yolov5s_openvino_model/') # OpenVINO -model = torch.hub.load('ultralytics/yolov5', 'custom', path='yolov5s.engine') # TensorRT -model = torch.hub.load('ultralytics/yolov5', 'custom', path='yolov5s.mlmodel') # CoreML (macOS-only) -model = torch.hub.load('ultralytics/yolov5', 'custom', path='yolov5s.tflite') # TFLite -model = torch.hub.load('ultralytics/yolov5', 'custom', path='yolov5s_paddle_model/') # PaddlePaddle -``` - -## Supported Environments - -Ultralytics provides a range of ready-to-use environments, each pre-installed with essential dependencies such as [CUDA](https://developer.nvidia.com/cuda), [CUDNN](https://developer.nvidia.com/cudnn), [Python](https://www.python.org/), and [PyTorch](https://pytorch.org/), to kickstart your projects. - -- **Free GPU Notebooks**: Run on Gradient Open In Colab Open In Kaggle -- **Google Cloud**: [GCP Quickstart Guide](../environments/google_cloud_quickstart_tutorial.md) -- **Amazon**: [AWS Quickstart Guide](../environments/aws_quickstart_tutorial.md) -- **Azure**: [AzureML Quickstart Guide](../environments/azureml_quickstart_tutorial.md) -- **Docker**: [Docker Quickstart Guide](../environments/docker_image_quickstart_tutorial.md) Docker Pulls - -## Project Status - -YOLOv5 CI - -This badge indicates that all [YOLOv5 GitHub Actions](https://github.com/ultralytics/yolov5/actions) Continuous Integration (CI) tests are successfully passing. These CI tests rigorously check the functionality and performance of YOLOv5 across various key aspects: [training](https://github.com/ultralytics/yolov5/blob/master/train.py), [validation](https://github.com/ultralytics/yolov5/blob/master/val.py), [inference](https://github.com/ultralytics/yolov5/blob/master/detect.py), [export](https://github.com/ultralytics/yolov5/blob/master/export.py), and [benchmarks](https://github.com/ultralytics/yolov5/blob/master/benchmarks.py). They ensure consistent and reliable operation on macOS, Windows, and Ubuntu, with tests conducted every 24 hours and upon each new commit. diff --git a/ultralytics-main/docs/en/yolov5/tutorials/roboflow_datasets_integration.md b/ultralytics-main/docs/en/yolov5/tutorials/roboflow_datasets_integration.md deleted file mode 100644 index c3a83be..0000000 --- a/ultralytics-main/docs/en/yolov5/tutorials/roboflow_datasets_integration.md +++ /dev/null @@ -1,73 +0,0 @@ ---- -comments: true -description: Learn how to use Roboflow for organizing, labelling, preparing, and hosting your datasets for YOLOv5 models. Enhance your model deployments with our platform. -keywords: Ultralytics, YOLOv5, Roboflow, data organization, data labelling, data preparation, model deployment, active learning, machine learning pipeline ---- - -# Roboflow Datasets - -You can now use Roboflow to organize, label, prepare, version, and host your datasets for training YOLOv5 🚀 models. Roboflow is free to use with YOLOv5 if you make your workspace public. - -!!! Question "Licensing" - - Ultralytics offers two licensing options: - - - The [AGPL-3.0 License](https://github.com/ultralytics/ultralytics/blob/main/LICENSE), an [OSI-approved](https://opensource.org/licenses/) open-source license ideal for students and enthusiasts. - - The [Enterprise License](https://ultralytics.com/license) for businesses seeking to incorporate our AI models into their products and services. - - For more details see [Ultralytics Licensing](https://ultralytics.com/license). - -## Upload - -You can upload your data to Roboflow via [web UI](https://docs.roboflow.com/adding-data), [REST API](https://docs.roboflow.com/adding-data/upload-api), or [Python](https://docs.roboflow.com/python). - -## Labeling - -After uploading data to Roboflow, you can label your data and review previous labels. - -[![Roboflow Annotate](https://roboflow-darknet.s3.us-east-2.amazonaws.com/roboflow-annotate.gif)](https://roboflow.com/annotate) - -## Versioning - -You can make versions of your dataset with different preprocessing and offline augmentation options. YOLOv5 does online augmentations natively, so be intentional when layering Roboflow's offline augmentations on top. - -![Roboflow Preprocessing](https://roboflow-darknet.s3.us-east-2.amazonaws.com/robolfow-preprocessing.png) - -## Exporting Data - -You can download your data in YOLOv5 format to quickly begin training. - -``` -from roboflow import Roboflow -rf = Roboflow(api_key="YOUR API KEY HERE") -project = rf.workspace().project("YOUR PROJECT") -dataset = project.version("YOUR VERSION").download("yolov5") -``` - -## Custom Training - -We have released a custom training tutorial demonstrating all of the above capabilities. You can access the code here: - -[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/roboflow-ai/yolov5-custom-training-tutorial/blob/main/yolov5-custom-training.ipynb) - -## Active Learning - -The real world is messy and your model will invariably encounter situations your dataset didn't anticipate. Using [active learning](https://blog.roboflow.com/what-is-active-learning/) is an important strategy to iteratively improve your dataset and model. With the Roboflow and YOLOv5 integration, you can quickly make improvements on your model deployments by using a battle tested machine learning pipeline. - -

Roboflow active learning

- -## Supported Environments - -Ultralytics provides a range of ready-to-use environments, each pre-installed with essential dependencies such as [CUDA](https://developer.nvidia.com/cuda), [CUDNN](https://developer.nvidia.com/cudnn), [Python](https://www.python.org/), and [PyTorch](https://pytorch.org/), to kickstart your projects. - -- **Free GPU Notebooks**: Run on Gradient Open In Colab Open In Kaggle -- **Google Cloud**: [GCP Quickstart Guide](../environments/google_cloud_quickstart_tutorial.md) -- **Amazon**: [AWS Quickstart Guide](../environments/aws_quickstart_tutorial.md) -- **Azure**: [AzureML Quickstart Guide](../environments/azureml_quickstart_tutorial.md) -- **Docker**: [Docker Quickstart Guide](../environments/docker_image_quickstart_tutorial.md) Docker Pulls - -## Project Status - -YOLOv5 CI - -This badge indicates that all [YOLOv5 GitHub Actions](https://github.com/ultralytics/yolov5/actions) Continuous Integration (CI) tests are successfully passing. These CI tests rigorously check the functionality and performance of YOLOv5 across various key aspects: [training](https://github.com/ultralytics/yolov5/blob/master/train.py), [validation](https://github.com/ultralytics/yolov5/blob/master/val.py), [inference](https://github.com/ultralytics/yolov5/blob/master/detect.py), [export](https://github.com/ultralytics/yolov5/blob/master/export.py), and [benchmarks](https://github.com/ultralytics/yolov5/blob/master/benchmarks.py). They ensure consistent and reliable operation on macOS, Windows, and Ubuntu, with tests conducted every 24 hours and upon each new commit. diff --git a/ultralytics-main/docs/en/yolov5/tutorials/running_on_jetson_nano.md b/ultralytics-main/docs/en/yolov5/tutorials/running_on_jetson_nano.md deleted file mode 100644 index 8db446c..0000000 --- a/ultralytics-main/docs/en/yolov5/tutorials/running_on_jetson_nano.md +++ /dev/null @@ -1,319 +0,0 @@ ---- -comments: true -description: Detailed guide on deploying trained models on NVIDIA Jetson using TensorRT and DeepStream SDK. Optimize the inference performance on Jetson with Ultralytics. -keywords: TensorRT, NVIDIA Jetson, DeepStream SDK, deployment, Ultralytics, YOLO, Machine Learning, AI, Deep Learning, model optimization, inference performance ---- - -# Deploy on NVIDIA Jetson using TensorRT and DeepStream SDK - -📚 This guide explains how to deploy a trained model into NVIDIA Jetson Platform and perform inference using TensorRT and DeepStream SDK. Here we use TensorRT to maximize the inference performance on the Jetson platform. - -## Hardware Verification - -We have tested and verified this guide on the following Jetson devices - -- [Seeed reComputer J1010 built with Jetson Nano module](https://www.seeedstudio.com/Jetson-10-1-A0-p-5336.html) -- [Seeed reComputer J2021 built with Jetson Xavier NX module](https://www.seeedstudio.com/reComputer-J2021-p-5438.html) - -## Before You Start - -Make sure you have properly installed **JetPack SDK** with all the **SDK Components** and **DeepStream SDK** on the Jetson device as this includes CUDA, TensorRT and DeepStream SDK which are needed for this guide. - -JetPack SDK provides a full development environment for hardware-accelerated AI-at-the-edge development. All Jetson modules and developer kits are supported by JetPack SDK. - -There are two major installation methods including, - -1. SD Card Image Method -2. NVIDIA SDK Manager Method - -You can find a very detailed installation guide from NVIDIA [official website](https://developer.nvidia.com/jetpack-sdk-461). You can also find guides corresponding to the above-mentioned [reComputer J1010](https://wiki.seeedstudio.com/reComputer_J1010_J101_Flash_Jetpack) and [reComputer J2021](https://wiki.seeedstudio.com/reComputer_J2021_J202_Flash_Jetpack). - -## Install Necessary Packages - -- **Step 1.** Access the terminal of Jetson device, install pip and upgrade it - -```sh -sudo apt update -sudo apt install -y python3-pip -pip3 install --upgrade pip -``` - -- **Step 2.** Clone the following repo - -```sh -git clone https://github.com/ultralytics/yolov5 -``` - -- **Step 3.** Open **requirements.txt** - -```sh -cd yolov5 -vi requirements.txt -``` - -- **Step 5.** Edit the following lines. Here you need to press **i** first to enter editing mode. Press **ESC**, then type **:wq** to save and quit - -```sh -# torch>=1.8.0 -# torchvision>=0.9.0 -``` - -**Note:** torch and torchvision are excluded for now because they will be installed later. - -- **Step 6.** install the below dependency - -```sh -sudo apt install -y libfreetype6-dev -``` - -- **Step 7.** Install the necessary packages - -```sh -pip3 install -r requirements.txt -``` - -## Install PyTorch and Torchvision - -We cannot install PyTorch and Torchvision from pip because they are not compatible to run on Jetson platform which is based on **ARM aarch64 architecture**. Therefore, we need to manually install pre-built PyTorch pip wheel and compile/ install Torchvision from source. - -Visit [this page](https://forums.developer.nvidia.com/t/pytorch-for-jetson) to access all the PyTorch and Torchvision links. - -Here are some of the versions supported by JetPack 4.6 and above. - -**PyTorch v1.10.0** - -Supported by JetPack 4.4 (L4T R32.4.3) / JetPack 4.4.1 (L4T R32.4.4) / JetPack 4.5 (L4T R32.5.0) / JetPack 4.5.1 (L4T R32.5.1) / JetPack 4.6 (L4T R32.6.1) with Python 3.6 - -- **file_name:** torch-1.10.0-cp36-cp36m-linux_aarch64.whl -- **URL:** [https://nvidia.box.com/shared/static/fjtbno0vpo676a25cgvuqc1wty0fkkg6.whl](https://nvidia.box.com/shared/static/fjtbno0vpo676a25cgvuqc1wty0fkkg6.whl) - -**PyTorch v1.12.0** - -Supported by JetPack 5.0 (L4T R34.1.0) / JetPack 5.0.1 (L4T R34.1.1) / JetPack 5.0.2 (L4T R35.1.0) with Python 3.8 - -- **file_name:** torch-1.12.0a0+2c916ef.nv22.3-cp38-cp38-linux_aarch64.whl -- **URL:** [https://developer.download.nvidia.com/compute/redist/jp/v50/pytorch/torch-1.12.0a0+2c916ef.nv22.3-cp38-cp38-linux_aarch64.whl](https://developer.download.nvidia.com/compute/redist/jp/v50/pytorch/torch-1.12.0a0+2c916ef.nv22.3-cp38-cp38-linux_aarch64.whl) - -- **Step 1.** Install torch according to your JetPack version in the following format - -```sh -wget -O -pip3 install -``` - -For example, here we are running **JP4.6.1**, and therefore we choose **PyTorch v1.10.0** - -```sh -cd ~ -sudo apt-get install -y libopenblas-base libopenmpi-dev -wget https://nvidia.box.com/shared/static/fjtbno0vpo676a25cgvuqc1wty0fkkg6.whl -O torch-1.10.0-cp36-cp36m-linux_aarch64.whl -pip3 install torch-1.10.0-cp36-cp36m-linux_aarch64.whl -``` - -- **Step 2.** Install torchvision depending on the version of PyTorch that you have installed. For example, we chose **PyTorch v1.10.0**, which means, we need to choose **Torchvision v0.11.1** - -```sh -sudo apt install -y libjpeg-dev zlib1g-dev -git clone --branch v0.11.1 https://github.com/pytorch/vision torchvision -cd torchvision -sudo python3 setup.py install -``` - -Here a list of the corresponding torchvision version that you need to install according to the PyTorch version: - -- PyTorch v1.10 - torchvision v0.11.1 -- PyTorch v1.12 - torchvision v0.13.0 - -## DeepStream Configuration for YOLOv5 - -- **Step 1.** Clone the following repo - -```sh -cd ~ -git clone https://github.com/marcoslucianops/DeepStream-Yolo -``` - -- **Step 2.** Copy **gen_wts_yoloV5.py** from **DeepStream-Yolo/utils** into **yolov5** directory - -```sh -cp DeepStream-Yolo/utils/gen_wts_yoloV5.py yolov5 -``` - -- **Step 3.** Inside the yolov5 repo, download **pt file** from YOLOv5 releases (example for YOLOv5s 6.1) - -```sh -cd yolov5 -wget https://github.com/ultralytics/yolov5/releases/download/v6.1/yolov5s.pt -``` - -- **Step 4.** Generate the **cfg** and **wts** files - -```sh -python3 gen_wts_yoloV5.py -w yolov5s.pt -``` - -**Note**: To change the inference size (default: 640) - -```sh --s SIZE ---size SIZE --s HEIGHT WIDTH ---size HEIGHT WIDTH - -Example for 1280: - --s 1280 -or --s 1280 1280 -``` - -- **Step 5.** Copy the generated **cfg** and **wts** files into the **DeepStream-Yolo** folder - -```sh -cp yolov5s.cfg ~/DeepStream-Yolo -cp yolov5s.wts ~/DeepStream-Yolo -``` - -- **Step 6.** Open the **DeepStream-Yolo** folder and compile the library - -```sh -cd ~/DeepStream-Yolo -CUDA_VER=11.4 make -C nvdsinfer_custom_impl_Yolo # for DeepStream 6.1 -CUDA_VER=10.2 make -C nvdsinfer_custom_impl_Yolo # for DeepStream 6.0.1 / 6.0 -``` - -- **Step 7.** Edit the **config_infer_primary_yoloV5.txt** file according to your model - -```sh -[property] -... -custom-network-config=yolov5s.cfg -model-file=yolov5s.wts -... -``` - -- **Step 8.** Edit the **deepstream_app_config** file - -```sh -... -[primary-gie] -... -config-file=config_infer_primary_yoloV5.txt -``` - -- **Step 9.** Change the video source in **deepstream_app_config** file. Here a default video file is loaded as you can see below - -```sh -... -[source0] -... -uri=file:///opt/nvidia/deepstream/deepstream/samples/streams/sample_1080p_h264.mp4 -``` - -## Run the Inference - -```sh -deepstream-app -c deepstream_app_config.txt -``` - -
YOLOv5 with deepstream FP32
- -The above result is running on **Jetson Xavier NX** with **FP32** and **YOLOv5s 640x640**. We can see that the **FPS** is around **30**. - -## INT8 Calibration - -If you want to use INT8 precision for inference, you need to follow the steps below - -- **Step 1.** Install OpenCV - -```sh -sudo apt-get install libopencv-dev -``` - -- **Step 2.** Compile/recompile the **nvdsinfer_custom_impl_Yolo** library with OpenCV support - -```sh -cd ~/DeepStream-Yolo -CUDA_VER=11.4 OPENCV=1 make -C nvdsinfer_custom_impl_Yolo # for DeepStream 6.1 -CUDA_VER=10.2 OPENCV=1 make -C nvdsinfer_custom_impl_Yolo # for DeepStream 6.0.1 / 6.0 -``` - -- **Step 3.** For COCO dataset, download the [val2017](https://drive.google.com/file/d/1gbvfn7mcsGDRZ_luJwtITL-ru2kK99aK/view?usp=sharing), extract, and move to **DeepStream-Yolo** folder - -- **Step 4.** Make a new directory for calibration images - -```sh -mkdir calibration -``` - -- **Step 5.** Run the following to select 1000 random images from COCO dataset to run calibration - -```sh -for jpg in $(ls -1 val2017/*.jpg | sort -R | head -1000); do \ - cp ${jpg} calibration/; \ -done -``` - -**Note:** NVIDIA recommends at least 500 images to get a good accuracy. On this example, 1000 images are chosen to get better accuracy (more images = more accuracy). Higher INT8_CALIB_BATCH_SIZE values will result in more accuracy and faster calibration speed. Set it according to you GPU memory. You can set it from **head -1000**. For example, for 2000 images, **head -2000**. This process can take a long time. - -- **Step 6.** Create the **calibration.txt** file with all selected images - -```sh -realpath calibration/*jpg > calibration.txt -``` - -- **Step 7.** Set environment variables - -```sh -export INT8_CALIB_IMG_PATH=calibration.txt -export INT8_CALIB_BATCH_SIZE=1 -``` - -- **Step 8.** Update the **config_infer_primary_yoloV5.txt** file - -From - -```sh -... -model-engine-file=model_b1_gpu0_fp32.engine -#int8-calib-file=calib.table -... -network-mode=0 -... -``` - -To - -```sh -... -model-engine-file=model_b1_gpu0_int8.engine -int8-calib-file=calib.table -... -network-mode=1 -... -``` - -- **Step 9.** Run the inference - -```sh -deepstream-app -c deepstream_app_config.txt -``` - -
YOLOv5 with deepstream INT8
- -The above result is running on **Jetson Xavier NX** with **INT8** and **YOLOv5s 640x640**. We can see that the **FPS** is around **60**. - -## Benchmark results - -The following table summarizes how different models perform on **Jetson Xavier NX**. - -| Model Name | Precision | Inference Size | Inference Time (ms) | FPS | -|------------|-----------|----------------|---------------------|-----| -| YOLOv5s | FP32 | 320x320 | 16.66 | 60 | -| | FP32 | 640x640 | 33.33 | 30 | -| | INT8 | 640x640 | 16.66 | 60 | -| YOLOv5n | FP32 | 640x640 | 16.66 | 60 | - -### Additional - -This tutorial is written by our friends at seeed @lakshanthad and Elaine diff --git a/ultralytics-main/docs/en/yolov5/tutorials/test_time_augmentation.md b/ultralytics-main/docs/en/yolov5/tutorials/test_time_augmentation.md deleted file mode 100644 index 6a585ef..0000000 --- a/ultralytics-main/docs/en/yolov5/tutorials/test_time_augmentation.md +++ /dev/null @@ -1,164 +0,0 @@ ---- -comments: true -description: Boost your YOLOv5 performance with our step-by-step guide on Test-Time Augmentation (TTA). Learn to enhance your model's mAP and Recall during testing and inference. -keywords: YOLOv5, Ultralytics, Test-Time Augmentation, TTA, mAP, Recall, model performance, guide ---- - -# Test-Time Augmentation (TTA) - -📚 This guide explains how to use Test Time Augmentation (TTA) during testing and inference for improved mAP and Recall with YOLOv5 🚀. - -## Before You Start - -Clone repo and install [requirements.txt](https://github.com/ultralytics/yolov5/blob/master/requirements.txt) in a [**Python>=3.8.0**](https://www.python.org/) environment, including [**PyTorch>=1.8**](https://pytorch.org/get-started/locally/). [Models](https://github.com/ultralytics/yolov5/tree/master/models) and [datasets](https://github.com/ultralytics/yolov5/tree/master/data) download automatically from the latest YOLOv5 [release](https://github.com/ultralytics/yolov5/releases). - -```bash -git clone https://github.com/ultralytics/yolov5 # clone -cd yolov5 -pip install -r requirements.txt # install -``` - -## Test Normally - -Before trying TTA we want to establish a baseline performance to compare to. This command tests YOLOv5x on COCO val2017 at image size 640 pixels. `yolov5x.pt` is the largest and most accurate model available. Other options are `yolov5s.pt`, `yolov5m.pt` and `yolov5l.pt`, or you own checkpoint from training a custom dataset `./weights/best.pt`. For details on all available models please see our README [table](https://github.com/ultralytics/yolov5#pretrained-checkpoints). - -```bash -python val.py --weights yolov5x.pt --data coco.yaml --img 640 --half -``` - -Output: - -```shell -val: data=./data/coco.yaml, weights=['yolov5x.pt'], batch_size=32, imgsz=640, conf_thres=0.001, iou_thres=0.65, task=val, device=, single_cls=False, augment=False, verbose=False, save_txt=False, save_hybrid=False, save_conf=False, save_json=True, project=runs/val, name=exp, exist_ok=False, half=True -YOLOv5 🚀 v5.0-267-g6a3ee7c torch 1.9.0+cu102 CUDA:0 (Tesla P100-PCIE-16GB, 16280.875MB) - -Fusing layers... -Model Summary: 476 layers, 87730285 parameters, 0 gradients - -val: Scanning '../datasets/coco/val2017' images and labels...4952 found, 48 missing, 0 empty, 0 corrupted: 100% 5000/5000 [00:01<00:00, 2846.03it/s] -val: New cache created: ../datasets/coco/val2017.cache - Class Images Labels P R mAP@.5 mAP@.5:.95: 100% 157/157 [02:30<00:00, 1.05it/s] - all 5000 36335 0.746 0.626 0.68 0.49 -Speed: 0.1ms pre-process, 22.4ms inference, 1.4ms NMS per image at shape (32, 3, 640, 640) # <--- baseline speed - -Evaluating pycocotools mAP... saving runs/val/exp/yolov5x_predictions.json... -... - Average Precision (AP) @[ IoU=0.50:0.95 | area= all | maxDets=100 ] = 0.504 # <--- baseline mAP - Average Precision (AP) @[ IoU=0.50 | area= all | maxDets=100 ] = 0.688 - Average Precision (AP) @[ IoU=0.75 | area= all | maxDets=100 ] = 0.546 - Average Precision (AP) @[ IoU=0.50:0.95 | area= small | maxDets=100 ] = 0.351 - Average Precision (AP) @[ IoU=0.50:0.95 | area=medium | maxDets=100 ] = 0.551 - Average Precision (AP) @[ IoU=0.50:0.95 | area= large | maxDets=100 ] = 0.644 - Average Recall (AR) @[ IoU=0.50:0.95 | area= all | maxDets= 1 ] = 0.382 - Average Recall (AR) @[ IoU=0.50:0.95 | area= all | maxDets= 10 ] = 0.628 - Average Recall (AR) @[ IoU=0.50:0.95 | area= all | maxDets=100 ] = 0.681 # <--- baseline mAR - Average Recall (AR) @[ IoU=0.50:0.95 | area= small | maxDets=100 ] = 0.524 - Average Recall (AR) @[ IoU=0.50:0.95 | area=medium | maxDets=100 ] = 0.735 - Average Recall (AR) @[ IoU=0.50:0.95 | area= large | maxDets=100 ] = 0.826 -``` - -## Test with TTA - -Append `--augment` to any existing `val.py` command to enable TTA, and increase the image size by about 30% for improved results. Note that inference with TTA enabled will typically take about 2-3X the time of normal inference as the images are being left-right flipped and processed at 3 different resolutions, with the outputs merged before NMS. Part of the speed decrease is simply due to larger image sizes (832 vs 640), while part is due to the actual TTA operations. - -```bash -python val.py --weights yolov5x.pt --data coco.yaml --img 832 --augment --half -``` - -Output: - -```shell -val: data=./data/coco.yaml, weights=['yolov5x.pt'], batch_size=32, imgsz=832, conf_thres=0.001, iou_thres=0.6, task=val, device=, single_cls=False, augment=True, verbose=False, save_txt=False, save_hybrid=False, save_conf=False, save_json=True, project=runs/val, name=exp, exist_ok=False, half=True -YOLOv5 🚀 v5.0-267-g6a3ee7c torch 1.9.0+cu102 CUDA:0 (Tesla P100-PCIE-16GB, 16280.875MB) - -Fusing layers... -/usr/local/lib/python3.7/dist-packages/torch/nn/functional.py:718: UserWarning: Named tensors and all their associated APIs are an experimental feature and subject to change. Please do not use them for anything important until they are released as stable. (Triggered internally at /pytorch/c10/core/TensorImpl.h:1156.) - return torch.max_pool2d(input, kernel_size, stride, padding, dilation, ceil_mode) -Model Summary: 476 layers, 87730285 parameters, 0 gradients -val: Scanning '../datasets/coco/val2017' images and labels...4952 found, 48 missing, 0 empty, 0 corrupted: 100% 5000/5000 [00:01<00:00, 2885.61it/s] -val: New cache created: ../datasets/coco/val2017.cache - Class Images Labels P R mAP@.5 mAP@.5:.95: 100% 157/157 [07:29<00:00, 2.86s/it] - all 5000 36335 0.718 0.656 0.695 0.503 -Speed: 0.2ms pre-process, 80.6ms inference, 2.7ms NMS per image at shape (32, 3, 832, 832) # <--- TTA speed - -Evaluating pycocotools mAP... saving runs/val/exp2/yolov5x_predictions.json... -... - Average Precision (AP) @[ IoU=0.50:0.95 | area= all | maxDets=100 ] = 0.516 # <--- TTA mAP - Average Precision (AP) @[ IoU=0.50 | area= all | maxDets=100 ] = 0.701 - Average Precision (AP) @[ IoU=0.75 | area= all | maxDets=100 ] = 0.562 - Average Precision (AP) @[ IoU=0.50:0.95 | area= small | maxDets=100 ] = 0.361 - Average Precision (AP) @[ IoU=0.50:0.95 | area=medium | maxDets=100 ] = 0.564 - Average Precision (AP) @[ IoU=0.50:0.95 | area= large | maxDets=100 ] = 0.656 - Average Recall (AR) @[ IoU=0.50:0.95 | area= all | maxDets= 1 ] = 0.388 - Average Recall (AR) @[ IoU=0.50:0.95 | area= all | maxDets= 10 ] = 0.640 - Average Recall (AR) @[ IoU=0.50:0.95 | area= all | maxDets=100 ] = 0.696 # <--- TTA mAR - Average Recall (AR) @[ IoU=0.50:0.95 | area= small | maxDets=100 ] = 0.553 - Average Recall (AR) @[ IoU=0.50:0.95 | area=medium | maxDets=100 ] = 0.744 - Average Recall (AR) @[ IoU=0.50:0.95 | area= large | maxDets=100 ] = 0.833 -``` - -## Inference with TTA - -`detect.py` TTA inference operates identically to `val.py` TTA: simply append `--augment` to any existing `detect.py` command: - -```bash -python detect.py --weights yolov5s.pt --img 832 --source data/images --augment -``` - -Output: - -```bash -YOLOv5 🚀 v5.0-267-g6a3ee7c torch 1.9.0+cu102 CUDA:0 (Tesla P100-PCIE-16GB, 16280.875MB) - -Downloading https://github.com/ultralytics/yolov5/releases/download/v5.0/yolov5s.pt to yolov5s.pt... -100% 14.1M/14.1M [00:00<00:00, 81.9MB/s] - -Fusing layers... -Model Summary: 224 layers, 7266973 parameters, 0 gradients -image 1/2 /content/yolov5/data/images/bus.jpg: 832x640 4 persons, 1 bus, 1 fire hydrant, Done. (0.029s) -image 2/2 /content/yolov5/data/images/zidane.jpg: 480x832 3 persons, 3 ties, Done. (0.024s) -Results saved to runs/detect/exp -Done. (0.156s) -``` - -YOLOv5 test time augmentations - -### PyTorch Hub TTA - -TTA is automatically integrated into all [YOLOv5 PyTorch Hub](https://pytorch.org/hub/ultralytics_yolov5) models, and can be accessed by passing `augment=True` at inference time. - -```python -import torch - -# Model -model = torch.hub.load('ultralytics/yolov5', 'yolov5s') # or yolov5m, yolov5x, custom - -# Images -img = 'https://ultralytics.com/images/zidane.jpg' # or file, PIL, OpenCV, numpy, multiple - -# Inference -results = model(img, augment=True) # <--- TTA inference - -# Results -results.print() # or .show(), .save(), .crop(), .pandas(), etc. -``` - -### Customize - -You can customize the TTA ops applied in the YOLOv5 `forward_augment()` method [here](https://github.com/ultralytics/yolov5/blob/8c6f9e15bfc0000d18b976a95b9d7c17d407ec91/models/yolo.py#L125-L137). - -## Supported Environments - -Ultralytics provides a range of ready-to-use environments, each pre-installed with essential dependencies such as [CUDA](https://developer.nvidia.com/cuda), [CUDNN](https://developer.nvidia.com/cudnn), [Python](https://www.python.org/), and [PyTorch](https://pytorch.org/), to kickstart your projects. - -- **Free GPU Notebooks**: Run on Gradient Open In Colab Open In Kaggle -- **Google Cloud**: [GCP Quickstart Guide](../environments/google_cloud_quickstart_tutorial.md) -- **Amazon**: [AWS Quickstart Guide](../environments/aws_quickstart_tutorial.md) -- **Azure**: [AzureML Quickstart Guide](../environments/azureml_quickstart_tutorial.md) -- **Docker**: [Docker Quickstart Guide](../environments/docker_image_quickstart_tutorial.md) Docker Pulls - -## Project Status - -YOLOv5 CI - -This badge indicates that all [YOLOv5 GitHub Actions](https://github.com/ultralytics/yolov5/actions) Continuous Integration (CI) tests are successfully passing. These CI tests rigorously check the functionality and performance of YOLOv5 across various key aspects: [training](https://github.com/ultralytics/yolov5/blob/master/train.py), [validation](https://github.com/ultralytics/yolov5/blob/master/val.py), [inference](https://github.com/ultralytics/yolov5/blob/master/detect.py), [export](https://github.com/ultralytics/yolov5/blob/master/export.py), and [benchmarks](https://github.com/ultralytics/yolov5/blob/master/benchmarks.py). They ensure consistent and reliable operation on macOS, Windows, and Ubuntu, with tests conducted every 24 hours and upon each new commit. diff --git a/ultralytics-main/docs/en/yolov5/tutorials/tips_for_best_training_results.md b/ultralytics-main/docs/en/yolov5/tutorials/tips_for_best_training_results.md deleted file mode 100644 index 10dcff3..0000000 --- a/ultralytics-main/docs/en/yolov5/tutorials/tips_for_best_training_results.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -comments: true -description: Our comprehensive guide provides insights on how to train your YOLOv5 system to get the best mAP. Master dataset preparation, model selection, training settings, and more. -keywords: Ultralytics, YOLOv5, Training guide, dataset preparation, model selection, training settings, mAP results, Machine Learning, Object Detection ---- - -📚 This guide explains how to produce the best mAP and training results with YOLOv5 🚀. - -Most of the time good results can be obtained with no changes to the models or training settings, **provided your dataset is sufficiently large and well labelled**. If at first you don't get good results, there are steps you might be able to take to improve, but we always recommend users **first train with all default settings** before considering any changes. This helps establish a performance baseline and spot areas for improvement. - -If you have questions about your training results **we recommend you provide the maximum amount of information possible** if you expect a helpful response, including results plots (train losses, val losses, P, R, mAP), PR curve, confusion matrix, training mosaics, test results and dataset statistics images such as labels.png. All of these are located in your `project/name` directory, typically `yolov5/runs/train/exp`. - -We've put together a full guide for users looking to get the best results on their YOLOv5 trainings below. - -## Dataset - -- **Images per class.** ≥ 1500 images per class recommended -- **Instances per class.** ≥ 10000 instances (labeled objects) per class recommended -- **Image variety.** Must be representative of deployed environment. For real-world use cases we recommend images from different times of day, different seasons, different weather, different lighting, different angles, different sources (scraped online, collected locally, different cameras) etc. -- **Label consistency.** All instances of all classes in all images must be labelled. Partial labelling will not work. -- **Label accuracy.** Labels must closely enclose each object. No space should exist between an object and it's bounding box. No objects should be missing a label. -- **Label verification.** View `train_batch*.jpg` on train start to verify your labels appear correct, i.e. see [example](https://docs.ultralytics.com/yolov5/tutorials/train_custom_data#local-logging) mosaic. -- **Background images.** Background images are images with no objects that are added to a dataset to reduce False Positives (FP). We recommend about 0-10% background images to help reduce FPs (COCO has 1000 background images for reference, 1% of the total). No labels are required for background images. - -COCO Analysis - -## Model Selection - -Larger models like YOLOv5x and [YOLOv5x6](https://github.com/ultralytics/yolov5/releases/tag/v5.0) will produce better results in nearly all cases, but have more parameters, require more CUDA memory to train, and are slower to run. For **mobile** deployments we recommend YOLOv5s/m, for **cloud** deployments we recommend YOLOv5l/x. See our README [table](https://github.com/ultralytics/yolov5#pretrained-checkpoints) for a full comparison of all models. - -

YOLOv5 Models

- -- **Start from Pretrained weights.** Recommended for small to medium-sized datasets (i.e. [VOC](https://github.com/ultralytics/yolov5/blob/master/data/VOC.yaml), [VisDrone](https://github.com/ultralytics/yolov5/blob/master/data/VisDrone.yaml), [GlobalWheat](https://github.com/ultralytics/yolov5/blob/master/data/GlobalWheat2020.yaml)). Pass the name of the model to the `--weights` argument. Models download automatically from the [latest YOLOv5 release](https://github.com/ultralytics/yolov5/releases). - -```shell -python train.py --data custom.yaml --weights yolov5s.pt - yolov5m.pt - yolov5l.pt - yolov5x.pt - custom_pretrained.pt -``` - -- **Start from Scratch.** Recommended for large datasets (i.e. [COCO](https://github.com/ultralytics/yolov5/blob/master/data/coco.yaml), [Objects365](https://github.com/ultralytics/yolov5/blob/master/data/Objects365.yaml), [OIv6](https://storage.googleapis.com/openimages/web/index.html)). Pass the model architecture YAML you are interested in, along with an empty `--weights ''` argument: - -```bash -python train.py --data custom.yaml --weights '' --cfg yolov5s.yaml - yolov5m.yaml - yolov5l.yaml - yolov5x.yaml -``` - -## Training Settings - -Before modifying anything, **first train with default settings to establish a performance baseline**. A full list of train.py settings can be found in the [train.py](https://github.com/ultralytics/yolov5/blob/master/train.py) argparser. - -- **Epochs.** Start with 300 epochs. If this overfits early then you can reduce epochs. If overfitting does not occur after 300 epochs, train longer, i.e. 600, 1200 etc. epochs. -- **Image size.** COCO trains at native resolution of `--img 640`, though due to the high amount of small objects in the dataset it can benefit from training at higher resolutions such as `--img 1280`. If there are many small objects then custom datasets will benefit from training at native or higher resolution. Best inference results are obtained at the same `--img` as the training was run at, i.e. if you train at `--img 1280` you should also test and detect at `--img 1280`. -- **Batch size.** Use the largest `--batch-size` that your hardware allows for. Small batch sizes produce poor batchnorm statistics and should be avoided. -- **Hyperparameters.** Default hyperparameters are in [hyp.scratch-low.yaml](https://github.com/ultralytics/yolov5/blob/master/data/hyps/hyp.scratch-low.yaml). We recommend you train with default hyperparameters first before thinking of modifying any. In general, increasing augmentation hyperparameters will reduce and delay overfitting, allowing for longer trainings and higher final mAP. Reduction in loss component gain hyperparameters like `hyp['obj']` will help reduce overfitting in those specific loss components. For an automated method of optimizing these hyperparameters, see our [Hyperparameter Evolution Tutorial](https://docs.ultralytics.com/yolov5/tutorials/hyperparameter_evolution). - -## Further Reading - -If you'd like to know more, a good place to start is Karpathy's 'Recipe for Training Neural Networks', which has great ideas for training that apply broadly across all ML domains: [https://karpathy.github.io/2019/04/25/recipe/](https://karpathy.github.io/2019/04/25/recipe/) - -Good luck 🍀 and let us know if you have any other questions! diff --git a/ultralytics-main/docs/en/yolov5/tutorials/train_custom_data.md b/ultralytics-main/docs/en/yolov5/tutorials/train_custom_data.md deleted file mode 100644 index c6e501c..0000000 --- a/ultralytics-main/docs/en/yolov5/tutorials/train_custom_data.md +++ /dev/null @@ -1,224 +0,0 @@ ---- -comments: true -description: Learn how to train your data on custom datasets using YOLOv5. Simple and updated guide on collection and organization of images, labelling, model training and deployment. -keywords: YOLOv5, train on custom dataset, image collection, model training, object detection, image labelling, Ultralytics, PyTorch, machine learning ---- - -📚 This guide explains how to train your own **custom dataset** with [YOLOv5](https://github.com/ultralytics/yolov5) 🚀. - -## Before You Start - -Clone repo and install [requirements.txt](https://github.com/ultralytics/yolov5/blob/master/requirements.txt) in a [**Python>=3.8.0**](https://www.python.org/) environment, including [**PyTorch>=1.8**](https://pytorch.org/get-started/locally/). [Models](https://github.com/ultralytics/yolov5/tree/master/models) and [datasets](https://github.com/ultralytics/yolov5/tree/master/data) download automatically from the latest YOLOv5 [release](https://github.com/ultralytics/yolov5/releases). - -```bash -git clone https://github.com/ultralytics/yolov5 # clone -cd yolov5 -pip install -r requirements.txt # install -``` - -## Train On Custom Data - - -Ultralytics active learning -
-
- -Creating a custom model to detect your objects is an iterative process of collecting and organizing images, labeling your objects of interest, training a model, deploying it into the wild to make predictions, and then using that deployed model to collect examples of edge cases to repeat and improve. - -!!! Question "Licensing" - - Ultralytics offers two licensing options: - - - The [AGPL-3.0 License](https://github.com/ultralytics/ultralytics/blob/main/LICENSE), an [OSI-approved](https://opensource.org/licenses/) open-source license ideal for students and enthusiasts. - - The [Enterprise License](https://ultralytics.com/license) for businesses seeking to incorporate our AI models into their products and services. - - For more details see [Ultralytics Licensing](https://ultralytics.com/license). - -YOLOv5 models must be trained on labelled data in order to learn classes of objects in that data. There are two options for creating your dataset before you start training: - -## Option 1: Create a Roboflow Dataset - -### 1.1 Collect Images - -Your model will learn by example. Training on images similar to the ones it will see in the wild is of the utmost importance. Ideally, you will collect a wide variety of images from the same configuration (camera, angle, lighting, etc.) as you will ultimately deploy your project. - -If this is not possible, you can start from [a public dataset](https://universe.roboflow.com/?ref=ultralytics) to train your initial model and then [sample images from the wild during inference](https://blog.roboflow.com/computer-vision-active-learning-tips/?ref=ultralytics) to improve your dataset and model iteratively. - -### 1.2 Create Labels - -Once you have collected images, you will need to annotate the objects of interest to create a ground truth for your model to learn from. - -

YOLOv5 accuracies

- -[Roboflow Annotate](https://roboflow.com/annotate?ref=ultralytics) is a simple web-based tool for managing and labeling your images with your team and exporting them in [YOLOv5's annotation format](https://roboflow.com/formats/yolov5-pytorch-txt?ref=ultralytics). - -### 1.3 Prepare Dataset for YOLOv5 - -Whether you [label your images with Roboflow](https://roboflow.com/annotate?ref=ultralytics) or not, you can use it to convert your dataset into YOLO format, create a YOLOv5 YAML configuration file, and host it for importing into your training script. - -[Create a free Roboflow account](https://app.roboflow.com/?model=yolov5&ref=ultralytics) and upload your dataset to a `Public` workspace, label any unannotated images, then generate and export a version of your dataset in `YOLOv5 Pytorch` format. - -Note: YOLOv5 does online augmentation during training, so we do not recommend applying any augmentation steps in Roboflow for training with YOLOv5. But we recommend applying the following preprocessing steps: - -

Recommended Preprocessing Steps

- -- **Auto-Orient** - to strip EXIF orientation from your images. -- **Resize (Stretch)** - to the square input size of your model (640x640 is the YOLOv5 default). - -Generating a version will give you a snapshot of your dataset, so you can always go back and compare your future model training runs against it, even if you add more images or change its configuration later. - -

Export in YOLOv5 Format

- -Export in `YOLOv5 Pytorch` format, then copy the snippet into your training script or notebook to download your dataset. - -

Roboflow dataset download snippet

- -## Option 2: Create a Manual Dataset - -### 2.1 Create `dataset.yaml` - -[COCO128](https://www.kaggle.com/ultralytics/coco128) is an example small tutorial dataset composed of the first 128 images in [COCO](https://cocodataset.org/) train2017. These same 128 images are used for both training and validation to verify our training pipeline is capable of overfitting. [data/coco128.yaml](https://github.com/ultralytics/yolov5/blob/master/data/coco128.yaml), shown below, is the dataset config file that defines 1) the dataset root directory `path` and relative paths to `train` / `val` / `test` image directories (or `*.txt` files with image paths) and 2) a class `names` dictionary: - -```yaml -# Train/val/test sets as 1) dir: path/to/imgs, 2) file: path/to/imgs.txt, or 3) list: [path/to/imgs1, path/to/imgs2, ..] -path: ../datasets/coco128 # dataset root dir -train: images/train2017 # train images (relative to 'path') 128 images -val: images/train2017 # val images (relative to 'path') 128 images -test: # test images (optional) - -# Classes (80 COCO classes) -names: - 0: person - 1: bicycle - 2: car - # ... - 77: teddy bear - 78: hair drier - 79: toothbrush -``` - -### 2.2 Create Labels - -After using an annotation tool to label your images, export your labels to **YOLO format**, with one `*.txt` file per image (if no objects in image, no `*.txt` file is required). The `*.txt` file specifications are: - -- One row per object -- Each row is `class x_center y_center width height` format. -- Box coordinates must be in **normalized xywh** format (from 0 to 1). If your boxes are in pixels, divide `x_center` and `width` by image width, and `y_center` and `height` by image height. -- Class numbers are zero-indexed (start from 0). - -

Roboflow annotations

- -The label file corresponding to the above image contains 2 persons (class `0`) and a tie (class `27`): - -

Roboflow dataset preprocessing

- -### 2.3 Organize Directories - -Organize your train and val images and labels according to the example below. YOLOv5 assumes `/coco128` is inside a `/datasets` directory **next to** the `/yolov5` directory. **YOLOv5 locates labels automatically for each image** by replacing the last instance of `/images/` in each image path with `/labels/`. For example: - -```bash -../datasets/coco128/images/im0.jpg # image -../datasets/coco128/labels/im0.txt # label -``` - -

YOLOv5 dataset structure

- -## 3. Select a Model - -Select a pretrained model to start training from. Here we select [YOLOv5s](https://github.com/ultralytics/yolov5/blob/master/models/yolov5s.yaml), the second-smallest and fastest model available. See our README [table](https://github.com/ultralytics/yolov5#pretrained-checkpoints) for a full comparison of all models. - -

YOLOv5 models

- -## 4. Train - -Train a YOLOv5s model on COCO128 by specifying dataset, batch-size, image size and either pretrained `--weights yolov5s.pt` (recommended), or randomly initialized `--weights '' --cfg yolov5s.yaml` (not recommended). Pretrained weights are auto-downloaded from the [latest YOLOv5 release](https://github.com/ultralytics/yolov5/releases). - -```bash -python train.py --img 640 --epochs 3 --data coco128.yaml --weights yolov5s.pt -``` - -!!! Tip "Tip" - - 💡 Add `--cache ram` or `--cache disk` to speed up training (requires significant RAM/disk resources). - -!!! Tip "Tip" - - 💡 Always train from a local dataset. Mounted or network drives like Google Drive will be very slow. - -All training results are saved to `runs/train/` with incrementing run directories, i.e. `runs/train/exp2`, `runs/train/exp3` etc. For more details see the Training section of our tutorial notebook. Open In Colab Open In Kaggle - -## 5. Visualize - -### Comet Logging and Visualization 🌟 NEW - -[Comet](https://bit.ly/yolov5-readme-comet) is now fully integrated with YOLOv5. 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://bit.ly/yolov5-colab-comet-panels)! 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 is easy: - -```shell -pip install comet_ml # 1. install -export COMET_API_KEY= # 2. paste API key -python train.py --img 640 --epochs 3 --data coco128.yaml --weights yolov5s.pt # 3. train -``` - -To learn more about all the supported Comet features for this integration, check out the [Comet Tutorial](https://docs.ultralytics.com/yolov5/tutorials/comet_logging_integration). If you'd like to learn more about Comet, head over to our [documentation](https://bit.ly/yolov5-colab-comet-docs). Get started by trying out the Comet Colab Notebook: [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1RG0WOQyxlDlo5Km8GogJpIEJlg_5lyYO?usp=sharing) - -YOLO UI - -### ClearML Logging and Automation 🌟 NEW - -[ClearML](https://clear.ml/) is completely integrated into YOLOv5 to track your experimentation, manage dataset versions and even remotely execute training runs. To enable ClearML: - -- `pip install clearml` -- run `clearml-init` to connect to a ClearML server - -You'll get all the great expected features from an experiment manager: live updates, model upload, experiment comparison etc. but ClearML also tracks uncommitted changes and installed packages for example. Thanks to that ClearML Tasks (which is what we call experiments) are also reproducible on different machines! With only 1 extra line, we can schedule a YOLOv5 training task on a queue to be executed by any number of ClearML Agents (workers). - -You can use ClearML Data to version your dataset and then pass it to YOLOv5 simply using its unique ID. This will help you keep track of your data without adding extra hassle. Explore the [ClearML Tutorial](https://docs.ultralytics.com/yolov5/tutorials/clearml_logging_integration) for details! - - -ClearML Experiment Management UI - -### Local Logging - -Training results are automatically logged with [Tensorboard](https://www.tensorflow.org/tensorboard) and [CSV](https://github.com/ultralytics/yolov5/pull/4148) loggers to `runs/train`, with a new experiment directory created for each new training as `runs/train/exp2`, `runs/train/exp3`, etc. - -This directory contains train and val statistics, mosaics, labels, predictions and augmented mosaics, as well as metrics and charts including precision-recall (PR) curves and confusion matrices. - -Local logging results - -Results file `results.csv` is updated after each epoch, and then plotted as `results.png` (below) after training completes. You can also plot any `results.csv` file manually: - -```python -from utils.plots import plot_results - -plot_results('path/to/results.csv') # plot 'results.csv' as 'results.png' -``` - -

results.png

- -## Next Steps - -Once your model is trained you can use your best checkpoint `best.pt` to: - -- Run [CLI](https://github.com/ultralytics/yolov5#quick-start-examples) or [Python](https://docs.ultralytics.com/yolov5/tutorials/pytorch_hub_model_loading) inference on new images and videos -- [Validate](https://github.com/ultralytics/yolov5/blob/master/val.py) accuracy on train, val and test splits -- [Export](https://docs.ultralytics.com/yolov5/tutorials/model_export) to TensorFlow, Keras, ONNX, TFlite, TF.js, CoreML and TensorRT formats -- [Evolve](https://docs.ultralytics.com/yolov5/tutorials/hyperparameter_evolution) hyperparameters to improve performance -- [Improve](https://docs.roboflow.com/adding-data/upload-api?ref=ultralytics) your model by sampling real-world images and adding them to your dataset - -## Supported Environments - -Ultralytics provides a range of ready-to-use environments, each pre-installed with essential dependencies such as [CUDA](https://developer.nvidia.com/cuda), [CUDNN](https://developer.nvidia.com/cudnn), [Python](https://www.python.org/), and [PyTorch](https://pytorch.org/), to kickstart your projects. - -- **Free GPU Notebooks**: Run on Gradient Open In Colab Open In Kaggle -- **Google Cloud**: [GCP Quickstart Guide](../environments/google_cloud_quickstart_tutorial.md) -- **Amazon**: [AWS Quickstart Guide](../environments/aws_quickstart_tutorial.md) -- **Azure**: [AzureML Quickstart Guide](../environments/azureml_quickstart_tutorial.md) -- **Docker**: [Docker Quickstart Guide](../environments/docker_image_quickstart_tutorial.md) Docker Pulls - -## Project Status - -YOLOv5 CI - -This badge indicates that all [YOLOv5 GitHub Actions](https://github.com/ultralytics/yolov5/actions) Continuous Integration (CI) tests are successfully passing. These CI tests rigorously check the functionality and performance of YOLOv5 across various key aspects: [training](https://github.com/ultralytics/yolov5/blob/master/train.py), [validation](https://github.com/ultralytics/yolov5/blob/master/val.py), [inference](https://github.com/ultralytics/yolov5/blob/master/detect.py), [export](https://github.com/ultralytics/yolov5/blob/master/export.py), and [benchmarks](https://github.com/ultralytics/yolov5/blob/master/benchmarks.py). They ensure consistent and reliable operation on macOS, Windows, and Ubuntu, with tests conducted every 24 hours and upon each new commit. diff --git a/ultralytics-main/docs/en/yolov5/tutorials/transfer_learning_with_frozen_layers.md b/ultralytics-main/docs/en/yolov5/tutorials/transfer_learning_with_frozen_layers.md deleted file mode 100644 index 8fb0da8..0000000 --- a/ultralytics-main/docs/en/yolov5/tutorials/transfer_learning_with_frozen_layers.md +++ /dev/null @@ -1,155 +0,0 @@ ---- -comments: true -description: Learn to freeze YOLOv5 layers for efficient transfer learning. Optimize your model retraining with less resources and faster training times. -keywords: YOLOv5, freeze layers, transfer learning, model retraining, Ultralytics ---- - -📚 This guide explains how to **freeze** YOLOv5 🚀 layers when **transfer learning**. Transfer learning is a useful way to quickly retrain a model on new data without having to retrain the entire network. Instead, part of the initial weights are frozen in place, and the rest of the weights are used to compute loss and are updated by the optimizer. This requires less resources than normal training and allows for faster training times, though it may also result in reductions to final trained accuracy. - -## Before You Start - -Clone repo and install [requirements.txt](https://github.com/ultralytics/yolov5/blob/master/requirements.txt) in a [**Python>=3.8.0**](https://www.python.org/) environment, including [**PyTorch>=1.8**](https://pytorch.org/get-started/locally/). [Models](https://github.com/ultralytics/yolov5/tree/master/models) and [datasets](https://github.com/ultralytics/yolov5/tree/master/data) download automatically from the latest YOLOv5 [release](https://github.com/ultralytics/yolov5/releases). - -```bash -git clone https://github.com/ultralytics/yolov5 # clone -cd yolov5 -pip install -r requirements.txt # install -``` - -## Freeze Backbone - -All layers that match the train.py `freeze` list in train.py will be frozen by setting their gradients to zero before training starts. - -```python -# Freeze -freeze = [f'model.{x}.' for x in range(freeze)] # layers to freeze -for k, v in model.named_parameters(): - v.requires_grad = True # train all layers - if any(x in k for x in freeze): - print(f'freezing {k}') - v.requires_grad = False -``` - -To see a list of module names: - -```python -for k, v in model.named_parameters(): - print(k) - -"""Output: -model.0.conv.conv.weight -model.0.conv.bn.weight -model.0.conv.bn.bias -model.1.conv.weight -model.1.bn.weight -model.1.bn.bias -model.2.cv1.conv.weight -model.2.cv1.bn.weight -... -model.23.m.0.cv2.bn.weight -model.23.m.0.cv2.bn.bias -model.24.m.0.weight -model.24.m.0.bias -model.24.m.1.weight -model.24.m.1.bias -model.24.m.2.weight -model.24.m.2.bias -""" -``` - -Looking at the model architecture we can see that the model backbone is layers 0-9: - -```yaml -# YOLOv5 v6.0 backbone -backbone: - # [from, number, module, args] - - [-1, 1, Conv, [64, 6, 2, 2]] # 0-P1/2 - - [-1, 1, Conv, [128, 3, 2]] # 1-P2/4 - - [-1, 3, C3, [128]] - - [-1, 1, Conv, [256, 3, 2]] # 3-P3/8 - - [-1, 6, C3, [256]] - - [-1, 1, Conv, [512, 3, 2]] # 5-P4/16 - - [-1, 9, C3, [512]] - - [-1, 1, Conv, [1024, 3, 2]] # 7-P5/32 - - [-1, 3, C3, [1024]] - - [-1, 1, SPPF, [1024, 5]] # 9 - - -# YOLOv5 v6.0 head -head: - - [-1, 1, Conv, [512, 1, 1]] - - [-1, 1, nn.Upsample, [None, 2, 'nearest']] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, C3, [512, False]] # 13 - - - [-1, 1, Conv, [256, 1, 1]] - - [-1, 1, nn.Upsample, [None, 2, 'nearest']] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 3, C3, [256, False]] # 17 (P3/8-small) - - - [-1, 1, Conv, [256, 3, 2]] - - [[-1, 14], 1, Concat, [1]] # cat head P4 - - [-1, 3, C3, [512, False]] # 20 (P4/16-medium) - - - [-1, 1, Conv, [512, 3, 2]] - - [[-1, 10], 1, Concat, [1]] # cat head P5 - - [-1, 3, C3, [1024, False]] # 23 (P5/32-large) - - - [[17, 20, 23], 1, Detect, [nc]] # Detect(P3, P4, P5) -``` - -so we can define the freeze list to contain all modules with 'model.0.' - 'model.9.' in their names: - -```bash -python train.py --freeze 10 -``` - -## Freeze All Layers - -To freeze the full model except for the final output convolution layers in Detect(), we set freeze list to contain all modules with 'model.0.' - 'model.23.' in their names: - -```bash -python train.py --freeze 24 -``` - -## Results - -We train YOLOv5m on VOC on both of the above scenarios, along with a default model (no freezing), starting from the official COCO pretrained `--weights yolov5m.pt`: - -```bash -train.py --batch 48 --weights yolov5m.pt --data voc.yaml --epochs 50 --cache --img 512 --hyp hyp.finetune.yaml -``` - -### Accuracy Comparison - -The results show that freezing speeds up training, but reduces final accuracy slightly. - -![Freezing training mAP50 results](https://user-images.githubusercontent.com/26833433/98394454-11579f80-205b-11eb-8e57-d8318e1cc2f8.png) - -![Freezing training mAP50-95 results](https://user-images.githubusercontent.com/26833433/98394459-13216300-205b-11eb-871b-49e20691a423.png) - -Table results - -### GPU Utilization Comparison - -Interestingly, the more modules are frozen the less GPU memory is required to train, and the lower GPU utilization. This indicates that larger models, or models trained at larger --image-size may benefit from freezing in order to train faster. - -![Training GPU memory allocated percent](https://user-images.githubusercontent.com/26833433/98394920-c2f6d080-205b-11eb-9611-fd68522b4e0e.png) - -![Training GPU memory utilization percent](https://user-images.githubusercontent.com/26833433/98394918-bf634980-205b-11eb-948d-311036ef9325.png) - -## Supported Environments - -Ultralytics provides a range of ready-to-use environments, each pre-installed with essential dependencies such as [CUDA](https://developer.nvidia.com/cuda), [CUDNN](https://developer.nvidia.com/cudnn), [Python](https://www.python.org/), and [PyTorch](https://pytorch.org/), to kickstart your projects. - -- **Free GPU Notebooks**: Run on Gradient Open In Colab Open In Kaggle -- **Google Cloud**: [GCP Quickstart Guide](../environments/google_cloud_quickstart_tutorial.md) -- **Amazon**: [AWS Quickstart Guide](../environments/aws_quickstart_tutorial.md) -- **Azure**: [AzureML Quickstart Guide](../environments/azureml_quickstart_tutorial.md) -- **Docker**: [Docker Quickstart Guide](../environments/docker_image_quickstart_tutorial.md) Docker Pulls - -## Project Status - -YOLOv5 CI - -This badge indicates that all [YOLOv5 GitHub Actions](https://github.com/ultralytics/yolov5/actions) Continuous Integration (CI) tests are successfully passing. These CI tests rigorously check the functionality and performance of YOLOv5 across various key aspects: [training](https://github.com/ultralytics/yolov5/blob/master/train.py), [validation](https://github.com/ultralytics/yolov5/blob/master/val.py), [inference](https://github.com/ultralytics/yolov5/blob/master/detect.py), [export](https://github.com/ultralytics/yolov5/blob/master/export.py), and [benchmarks](https://github.com/ultralytics/yolov5/blob/master/benchmarks.py). They ensure consistent and reliable operation on macOS, Windows, and Ubuntu, with tests conducted every 24 hours and upon each new commit. diff --git a/ultralytics-main/docs/overrides/assets/favicon.ico b/ultralytics-main/docs/overrides/assets/favicon.ico deleted file mode 100644 index 7aa5066187ae0bb3179a5bc13c282e481871404d..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 9662 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 C#gL)^ diff --git a/ultralytics-main/docs/overrides/javascript/extra.js b/ultralytics-main/docs/overrides/javascript/extra.js deleted file mode 100644 index 3233a64..0000000 --- a/ultralytics-main/docs/overrides/javascript/extra.js +++ /dev/null @@ -1,69 +0,0 @@ -// Function that applies light/dark theme based on the user's preference -const applyAutoTheme = () => { - // Determine the user's preferred color scheme - const prefersLight = window.matchMedia("(prefers-color-scheme: light)").matches; - const prefersDark = window.matchMedia("(prefers-color-scheme: dark)").matches; - - // Apply the appropriate attributes based on the user's preference - if (prefersLight) { - document.body.setAttribute("data-md-color-scheme", "default"); - document.body.setAttribute("data-md-color-primary", "indigo"); - } else if (prefersDark) { - document.body.setAttribute("data-md-color-scheme", "slate"); - document.body.setAttribute("data-md-color-primary", "black"); - } -}; - -// Function that checks and applies light/dark theme based on the user's preference (if auto theme is enabled) -function checkAutoTheme() { - // Array of supported language codes -> each language has its own palette (stored in local storage) - const supportedLangCodes = ["en", "zh", "ko", "ja", "ru", "de", "fr", "es", "pt", "it", "tr", "vi", "nl"]; - // Get the URL path - const path = window.location.pathname; - // Extract the language code from the URL (assuming it's in the format /xx/...) - const langCode = path.split("/")[1]; - // Check if the extracted language code is in the supported languages - const isValidLangCode = supportedLangCodes.includes(langCode); - // Construct the local storage key based on the language code if valid, otherwise default to the root key - const localStorageKey = isValidLangCode ? `/${langCode}/.__palette` : "/.__palette"; - // Retrieve the palette from local storage using the constructed key - const palette = localStorage.getItem(localStorageKey); - if (palette) { - // Check if the palette's index is 0 (auto theme) - const paletteObj = JSON.parse(palette); - if (paletteObj && paletteObj.index === 0) { - applyAutoTheme(); - } - } -} - -// Run function when the script loads -checkAutoTheme(); - -// Re-run the function when the user's preference changes (when the user changes their system theme) -window.matchMedia("(prefers-color-scheme: light)").addEventListener("change", checkAutoTheme); -window.matchMedia("(prefers-color-scheme: dark)").addEventListener("change", checkAutoTheme); - -// Re-run the function when the palette changes (e.g. user switched from dark theme to auto theme) -// ! We can't use window.addEventListener("storage", checkAutoTheme) because it will NOT be triggered on the current tab -// ! So we have to use the following workaround: -// Get the palette input for auto theme -var autoThemeInput = document.getElementById("__palette_1"); -if (autoThemeInput) { - // Add a click event listener to the input - autoThemeInput.addEventListener("click", function () { - // Check if the auto theme is selected - if (autoThemeInput.checked) { - // Re-run the function after a short delay (to ensure that the palette has been updated) - setTimeout(applyAutoTheme); - } - }); -} - -// Add iframe navigation -window.onhashchange = function() { - window.parent.postMessage({ - type: 'navigation', - hash: window.location.pathname + window.location.search + window.location.hash - }, '*'); -}; diff --git a/ultralytics-main/docs/overrides/main.html b/ultralytics-main/docs/overrides/main.html deleted file mode 100644 index bc088ce..0000000 --- a/ultralytics-main/docs/overrides/main.html +++ /dev/null @@ -1,12 +0,0 @@ - - -{% extends "base.html" %} - -{% block announce %} - -{% endblock %} diff --git a/ultralytics-main/docs/overrides/partials/comments.html b/ultralytics-main/docs/overrides/partials/comments.html deleted file mode 100644 index a99f4f8..0000000 --- a/ultralytics-main/docs/overrides/partials/comments.html +++ /dev/null @@ -1,51 +0,0 @@ -{% if page.meta.comments %} -

{{ lang.t("meta.comments") }}

- - - - - - -{% endif %} diff --git a/ultralytics-main/docs/overrides/partials/source-file.html b/ultralytics-main/docs/overrides/partials/source-file.html deleted file mode 100644 index 84e2ab1..0000000 --- a/ultralytics-main/docs/overrides/partials/source-file.html +++ /dev/null @@ -1,26 +0,0 @@ -{% import "partials/language.html" as lang with context %} - - - -
-
- - - - {% if page.meta.git_revision_date_localized %} - 📅 {{ lang.t("source.file.date.updated") }}: - {{ page.meta.git_revision_date_localized }} - {% if page.meta.git_creation_date_localized %} -
- 🎂 {{ lang.t("source.file.date.created") }}: - {{ page.meta.git_creation_date_localized }} - {% endif %} - - - {% elif page.meta.revision_date %} - 📅 {{ lang.t("source.file.date.updated") }}: - {{ page.meta.revision_date }} - {% endif %} - -
diff --git a/ultralytics-main/docs/overrides/stylesheets/style.css b/ultralytics-main/docs/overrides/stylesheets/style.css deleted file mode 100644 index 6607002..0000000 --- a/ultralytics-main/docs/overrides/stylesheets/style.css +++ /dev/null @@ -1,57 +0,0 @@ -/* Table format like GitHub ----------------------------------------------------------------------------------------- */ -th, -td { - border: 1px solid var(--md-typeset-table-color); - border-spacing: 0; - border-bottom: none; - border-left: none; - border-top: none; -} - -.md-typeset__table { - line-height: 1; -} - -.md-typeset__table table:not([class]) { - font-size: 0.74rem; - border-right: none; -} - -.md-typeset__table table:not([class]) td, -.md-typeset__table table:not([class]) th { - padding: 9px; -} - -/* light mode alternating table bg colors */ -.md-typeset__table tr:nth-child(2n) { - background-color: #f6f8fa; -} - -/* dark mode alternating table bg colors */ -[data-md-color-scheme="slate"] .md-typeset__table tr:nth-child(2n) { - background-color: #161b22; -} -/* Table format like GitHub ----------------------------------------------------------------------------------------- */ - -/* Code block vertical scroll */ -div.highlight { - max-height: 20rem; - overflow-y: auto; /* for adding a scrollbar when needed */ -} - -/* Set content width */ -.md-grid { - max-width: 1440px; -} - -/* Set language dropdown maximum height to screen height */ -.md-header .md-select:hover .md-select__inner { - max-height: 75vh; -} - -/* Update the background of the banner (same as the one on the Ultralytics website) */ -.md-banner { - background-image: url(https://uploads-ssl.webflow.com/646dd1f1a3703e451ba81ecc/65e60cd6a4080bba757850a3_banner_ct.webp); - background-size: cover; - background-position: center; -} diff --git a/ultralytics-main/examples/README.md b/ultralytics-main/examples/README.md deleted file mode 100644 index 42c3bd5..0000000 --- a/ultralytics-main/examples/README.md +++ /dev/null @@ -1,36 +0,0 @@ -## Ultralytics YOLOv8 Example Applications - -This repository features a collection of real-world applications and walkthroughs, provided as either Python files or notebooks. Explore the examples below to see how YOLOv8 can be integrated into various applications. - -### Ultralytics YOLO Example Applications - -| Title | Format | Contributor | -| ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------- | -| [YOLO ONNX Detection Inference with C++](./YOLOv8-CPP-Inference) | C++/ONNX | [Justas Bartnykas](https://github.com/JustasBart) | -| [YOLO OpenCV ONNX Detection Python](./YOLOv8-OpenCV-ONNX-Python) | OpenCV/Python/ONNX | [Farid Inawan](https://github.com/frdteknikelektro) | -| [YOLOv8 .NET ONNX ImageSharp](https://github.com/dme-compunet/YOLOv8) | C#/ONNX/ImageSharp | [Compunet](https://github.com/dme-compunet) | -| [YOLO .Net ONNX Detection C#](https://www.nuget.org/packages/Yolov8.Net) | C# .Net | [Samuel Stainback](https://github.com/sstainba) | -| [YOLOv8 on NVIDIA Jetson(TensorRT and DeepStream)](https://wiki.seeedstudio.com/YOLOv8-DeepStream-TRT-Jetson/) | Python | [Lakshantha](https://github.com/lakshanthad) | -| [YOLOv8 ONNXRuntime Python](./YOLOv8-ONNXRuntime) | Python/ONNXRuntime | [Semih Demirel](https://github.com/semihhdemirel) | -| [YOLOv8 ONNXRuntime CPP](./YOLOv8-ONNXRuntime-CPP) | C++/ONNXRuntime | [DennisJcy](https://github.com/DennisJcy), [Onuralp Sezer](https://github.com/onuralpszr) | -| [RTDETR ONNXRuntime C#](https://github.com/Kayzwer/yolo-cs/blob/master/RTDETR.cs) | C#/ONNX | [Kayzwer](https://github.com/Kayzwer) | -| [YOLOv8 SAHI Video Inference](https://github.com/RizwanMunawar/ultralytics/blob/main/examples/YOLOv8-SAHI-Inference-Video/yolov8_sahi.py) | Python | [Muhammad Rizwan Munawar](https://github.com/RizwanMunawar) | -| [YOLOv8 Region Counter](https://github.com/RizwanMunawar/ultralytics/blob/main/examples/YOLOv8-Region-Counter/yolov8_region_counter.py) | Python | [Muhammad Rizwan Munawar](https://github.com/RizwanMunawar) | -| [YOLOv8 Segmentation ONNXRuntime Python](./YOLOv8-Segmentation-ONNXRuntime-Python) | Python/ONNXRuntime | [jamjamjon](https://github.com/jamjamjon) | -| [YOLOv8 LibTorch CPP](./YOLOv8-LibTorch-CPP-Inference) | C++/LibTorch | [Myyura](https://github.com/Myyura) | -| [YOLOv8 OpenCV INT8 TFLite Python](./YOLOv8-OpenCV-int8-tflite-Python) | Python | [Wamiq Raza](https://github.com/wamiqraza) | - -### How to Contribute - -We greatly appreciate contributions from the community, including examples, applications, and guides. If you'd like to contribute, please follow these guidelines: - -1. Create a pull request (PR) with the title prefix `[Example]`, adding your new example folder to the `examples/` directory within the repository. -2. Make sure your project adheres to the following standards: - - Makes use of the `ultralytics` package. - - Includes a `README.md` with clear instructions for setting up and running the example. - - Refrains from adding large files or dependencies unless they are absolutely necessary for the example. - - Contributors should be willing to provide support for their examples and address related issues. - -For more detailed information and guidance on contributing, please visit our [contribution documentation](https://docs.ultralytics.com/help/contributing). - -If you encounter any questions or concerns regarding these guidelines, feel free to open a PR or an issue in the repository, and we will assist you in the contribution process. diff --git a/ultralytics-main/examples/YOLOv8-CPP-Inference/CMakeLists.txt b/ultralytics-main/examples/YOLOv8-CPP-Inference/CMakeLists.txt deleted file mode 100644 index bc2f33f..0000000 --- a/ultralytics-main/examples/YOLOv8-CPP-Inference/CMakeLists.txt +++ /dev/null @@ -1,28 +0,0 @@ -cmake_minimum_required(VERSION 3.5) - -project(Yolov8CPPInference VERSION 0.1) - -set(CMAKE_INCLUDE_CURRENT_DIR ON) - -# CUDA -set(CUDA_TOOLKIT_ROOT_DIR "/usr/local/cuda") -find_package(CUDA 11 REQUIRED) - -set(CMAKE_CUDA_STANDARD 11) -set(CMAKE_CUDA_STANDARD_REQUIRED ON) -# !CUDA - -# OpenCV -find_package(OpenCV REQUIRED) -include_directories(${OpenCV_INCLUDE_DIRS}) -# !OpenCV - -set(PROJECT_SOURCES - main.cpp - - inference.h - inference.cpp -) - -add_executable(Yolov8CPPInference ${PROJECT_SOURCES}) -target_link_libraries(Yolov8CPPInference ${OpenCV_LIBS}) diff --git a/ultralytics-main/examples/YOLOv8-CPP-Inference/README.md b/ultralytics-main/examples/YOLOv8-CPP-Inference/README.md deleted file mode 100644 index 601c1d0..0000000 --- a/ultralytics-main/examples/YOLOv8-CPP-Inference/README.md +++ /dev/null @@ -1,50 +0,0 @@ -# YOLOv8/YOLOv5 Inference C++ - -This example demonstrates how to perform inference using YOLOv8 and YOLOv5 models in C++ with OpenCV's DNN API. - -## Usage - -```bash -git clone ultralytics -cd ultralytics -pip install . -cd examples/YOLOv8-CPP-Inference - -# Add a **yolov8\_.onnx** and/or **yolov5\_.onnx** model(s) to the ultralytics folder. -# Edit the **main.cpp** to change the **projectBasePath** to match your user. - -# Note that by default the CMake file will try and import the CUDA library to be used with the OpenCVs dnn (cuDNN) GPU Inference. -# If your OpenCV build does not use CUDA/cuDNN you can remove that import call and run the example on CPU. - -mkdir build -cd build -cmake .. -make -./Yolov8CPPInference -``` - -## Exporting YOLOv8 and YOLOv5 Models - -To export YOLOv8 models: - -```commandline -yolo export model=yolov8s.pt imgsz=480,640 format=onnx opset=12 -``` - -To export YOLOv5 models: - -```commandline -python3 export.py --weights yolov5s.pt --img 480 640 --include onnx --opset 12 -``` - -yolov8s.onnx: - -![image](https://user-images.githubusercontent.com/40023722/217356132-a4cecf2e-2729-4acb-b80a-6559022d7707.png) - -yolov5s.onnx: - -![image](https://user-images.githubusercontent.com/40023722/217357005-07464492-d1da-42e3-98a7-fc753f87d5e6.png) - -This repository utilizes OpenCV's DNN API to run ONNX exported models of YOLOv5 and YOLOv8. In theory, it should work for YOLOv6 and YOLOv7 as well, but they have not been tested. Note that the example networks are exported with rectangular (640x480) resolutions, but any exported resolution will work. You may want to use the letterbox approach for square images, depending on your use case. - -The **main** branch version uses Qt as a GUI wrapper. The primary focus here is the **Inference** class file, which demonstrates how to transpose YOLOv8 models to work as YOLOv5 models. diff --git a/ultralytics-main/examples/YOLOv8-CPP-Inference/inference.cpp b/ultralytics-main/examples/YOLOv8-CPP-Inference/inference.cpp deleted file mode 100644 index 12c2607..0000000 --- a/ultralytics-main/examples/YOLOv8-CPP-Inference/inference.cpp +++ /dev/null @@ -1,185 +0,0 @@ -#include "inference.h" - -Inference::Inference(const std::string &onnxModelPath, const cv::Size &modelInputShape, const std::string &classesTxtFile, const bool &runWithCuda) -{ - modelPath = onnxModelPath; - modelShape = modelInputShape; - classesPath = classesTxtFile; - cudaEnabled = runWithCuda; - - loadOnnxNetwork(); - // loadClassesFromFile(); The classes are hard-coded for this example -} - -std::vector Inference::runInference(const cv::Mat &input) -{ - cv::Mat modelInput = input; - if (letterBoxForSquare && modelShape.width == modelShape.height) - modelInput = formatToSquare(modelInput); - - cv::Mat blob; - cv::dnn::blobFromImage(modelInput, blob, 1.0/255.0, modelShape, cv::Scalar(), true, false); - net.setInput(blob); - - std::vector outputs; - net.forward(outputs, net.getUnconnectedOutLayersNames()); - - int rows = outputs[0].size[1]; - int dimensions = outputs[0].size[2]; - - bool yolov8 = false; - // yolov5 has an output of shape (batchSize, 25200, 85) (Num classes + box[x,y,w,h] + confidence[c]) - // yolov8 has an output of shape (batchSize, 84, 8400) (Num classes + box[x,y,w,h]) - if (dimensions > rows) // Check if the shape[2] is more than shape[1] (yolov8) - { - yolov8 = true; - rows = outputs[0].size[2]; - dimensions = outputs[0].size[1]; - - outputs[0] = outputs[0].reshape(1, dimensions); - cv::transpose(outputs[0], outputs[0]); - } - float *data = (float *)outputs[0].data; - - float x_factor = modelInput.cols / modelShape.width; - float y_factor = modelInput.rows / modelShape.height; - - std::vector class_ids; - std::vector confidences; - std::vector boxes; - - for (int i = 0; i < rows; ++i) - { - if (yolov8) - { - float *classes_scores = data+4; - - cv::Mat scores(1, classes.size(), CV_32FC1, classes_scores); - cv::Point class_id; - double maxClassScore; - - minMaxLoc(scores, 0, &maxClassScore, 0, &class_id); - - if (maxClassScore > modelScoreThreshold) - { - confidences.push_back(maxClassScore); - class_ids.push_back(class_id.x); - - float x = data[0]; - float y = data[1]; - float w = data[2]; - float h = data[3]; - - int left = int((x - 0.5 * w) * x_factor); - int top = int((y - 0.5 * h) * y_factor); - - int width = int(w * x_factor); - int height = int(h * y_factor); - - boxes.push_back(cv::Rect(left, top, width, height)); - } - } - else // yolov5 - { - float confidence = data[4]; - - if (confidence >= modelConfidenceThreshold) - { - float *classes_scores = data+5; - - cv::Mat scores(1, classes.size(), CV_32FC1, classes_scores); - cv::Point class_id; - double max_class_score; - - minMaxLoc(scores, 0, &max_class_score, 0, &class_id); - - if (max_class_score > modelScoreThreshold) - { - confidences.push_back(confidence); - class_ids.push_back(class_id.x); - - float x = data[0]; - float y = data[1]; - float w = data[2]; - float h = data[3]; - - int left = int((x - 0.5 * w) * x_factor); - int top = int((y - 0.5 * h) * y_factor); - - int width = int(w * x_factor); - int height = int(h * y_factor); - - boxes.push_back(cv::Rect(left, top, width, height)); - } - } - } - - data += dimensions; - } - - std::vector nms_result; - cv::dnn::NMSBoxes(boxes, confidences, modelScoreThreshold, modelNMSThreshold, nms_result); - - std::vector detections{}; - for (unsigned long i = 0; i < nms_result.size(); ++i) - { - int idx = nms_result[i]; - - Detection result; - result.class_id = class_ids[idx]; - result.confidence = confidences[idx]; - - std::random_device rd; - std::mt19937 gen(rd()); - std::uniform_int_distribution dis(100, 255); - result.color = cv::Scalar(dis(gen), - dis(gen), - dis(gen)); - - result.className = classes[result.class_id]; - result.box = boxes[idx]; - - detections.push_back(result); - } - - return detections; -} - -void Inference::loadClassesFromFile() -{ - std::ifstream inputFile(classesPath); - if (inputFile.is_open()) - { - std::string classLine; - while (std::getline(inputFile, classLine)) - classes.push_back(classLine); - inputFile.close(); - } -} - -void Inference::loadOnnxNetwork() -{ - net = cv::dnn::readNetFromONNX(modelPath); - if (cudaEnabled) - { - std::cout << "\nRunning on CUDA" << std::endl; - net.setPreferableBackend(cv::dnn::DNN_BACKEND_CUDA); - net.setPreferableTarget(cv::dnn::DNN_TARGET_CUDA); - } - else - { - std::cout << "\nRunning on CPU" << std::endl; - net.setPreferableBackend(cv::dnn::DNN_BACKEND_OPENCV); - net.setPreferableTarget(cv::dnn::DNN_TARGET_CPU); - } -} - -cv::Mat Inference::formatToSquare(const cv::Mat &source) -{ - int col = source.cols; - int row = source.rows; - int _max = MAX(col, row); - cv::Mat result = cv::Mat::zeros(_max, _max, CV_8UC3); - source.copyTo(result(cv::Rect(0, 0, col, row))); - return result; -} diff --git a/ultralytics-main/examples/YOLOv8-CPP-Inference/inference.h b/ultralytics-main/examples/YOLOv8-CPP-Inference/inference.h deleted file mode 100644 index dc6149f..0000000 --- a/ultralytics-main/examples/YOLOv8-CPP-Inference/inference.h +++ /dev/null @@ -1,52 +0,0 @@ -#ifndef INFERENCE_H -#define INFERENCE_H - -// Cpp native -#include -#include -#include -#include - -// OpenCV / DNN / Inference -#include -#include -#include - -struct Detection -{ - int class_id{0}; - std::string className{}; - float confidence{0.0}; - cv::Scalar color{}; - cv::Rect box{}; -}; - -class Inference -{ -public: - Inference(const std::string &onnxModelPath, const cv::Size &modelInputShape = {640, 640}, const std::string &classesTxtFile = "", const bool &runWithCuda = true); - std::vector runInference(const cv::Mat &input); - -private: - void loadClassesFromFile(); - void loadOnnxNetwork(); - cv::Mat formatToSquare(const cv::Mat &source); - - std::string modelPath{}; - std::string classesPath{}; - bool cudaEnabled{}; - - std::vector classes{"person", "bicycle", "car", "motorcycle", "airplane", "bus", "train", "truck", "boat", "traffic light", "fire hydrant", "stop sign", "parking meter", "bench", "bird", "cat", "dog", "horse", "sheep", "cow", "elephant", "bear", "zebra", "giraffe", "backpack", "umbrella", "handbag", "tie", "suitcase", "frisbee", "skis", "snowboard", "sports ball", "kite", "baseball bat", "baseball glove", "skateboard", "surfboard", "tennis racket", "bottle", "wine glass", "cup", "fork", "knife", "spoon", "bowl", "banana", "apple", "sandwich", "orange", "broccoli", "carrot", "hot dog", "pizza", "donut", "cake", "chair", "couch", "potted plant", "bed", "dining table", "toilet", "tv", "laptop", "mouse", "remote", "keyboard", "cell phone", "microwave", "oven", "toaster", "sink", "refrigerator", "book", "clock", "vase", "scissors", "teddy bear", "hair drier", "toothbrush"}; - - cv::Size2f modelShape{}; - - float modelConfidenceThreshold {0.25}; - float modelScoreThreshold {0.45}; - float modelNMSThreshold {0.50}; - - bool letterBoxForSquare = true; - - cv::dnn::Net net; -}; - -#endif // INFERENCE_H diff --git a/ultralytics-main/examples/YOLOv8-CPP-Inference/main.cpp b/ultralytics-main/examples/YOLOv8-CPP-Inference/main.cpp deleted file mode 100644 index 6d1ba98..0000000 --- a/ultralytics-main/examples/YOLOv8-CPP-Inference/main.cpp +++ /dev/null @@ -1,70 +0,0 @@ -#include -#include -#include - -#include - -#include "inference.h" - -using namespace std; -using namespace cv; - -int main(int argc, char **argv) -{ - std::string projectBasePath = "/home/user/ultralytics"; // Set your ultralytics base path - - bool runOnGPU = true; - - // - // Pass in either: - // - // "yolov8s.onnx" or "yolov5s.onnx" - // - // To run Inference with yolov8/yolov5 (ONNX) - // - - // Note that in this example the classes are hard-coded and 'classes.txt' is a place holder. - Inference inf(projectBasePath + "/yolov8s.onnx", cv::Size(640, 480), "classes.txt", runOnGPU); - - std::vector imageNames; - imageNames.push_back(projectBasePath + "/ultralytics/assets/bus.jpg"); - imageNames.push_back(projectBasePath + "/ultralytics/assets/zidane.jpg"); - - for (int i = 0; i < imageNames.size(); ++i) - { - cv::Mat frame = cv::imread(imageNames[i]); - - // Inference starts here... - std::vector output = inf.runInference(frame); - - int detections = output.size(); - std::cout << "Number of detections:" << detections << std::endl; - - for (int i = 0; i < detections; ++i) - { - Detection detection = output[i]; - - cv::Rect box = detection.box; - cv::Scalar color = detection.color; - - // Detection box - cv::rectangle(frame, box, color, 2); - - // Detection box text - std::string classString = detection.className + ' ' + std::to_string(detection.confidence).substr(0, 4); - cv::Size textSize = cv::getTextSize(classString, cv::FONT_HERSHEY_DUPLEX, 1, 2, 0); - cv::Rect textBox(box.x, box.y - 40, textSize.width + 10, textSize.height + 20); - - cv::rectangle(frame, textBox, color, cv::FILLED); - cv::putText(frame, classString, cv::Point(box.x + 5, box.y - 10), cv::FONT_HERSHEY_DUPLEX, 1, cv::Scalar(0, 0, 0), 2, 0); - } - // Inference ends here... - - // This is only for preview purposes - float scale = 0.8; - cv::resize(frame, frame, cv::Size(frame.cols*scale, frame.rows*scale)); - cv::imshow("Inference", frame); - - cv::waitKey(-1); - } -} diff --git a/ultralytics-main/examples/YOLOv8-LibTorch-CPP-Inference/CMakeLists.txt b/ultralytics-main/examples/YOLOv8-LibTorch-CPP-Inference/CMakeLists.txt deleted file mode 100644 index 2cbd796..0000000 --- a/ultralytics-main/examples/YOLOv8-LibTorch-CPP-Inference/CMakeLists.txt +++ /dev/null @@ -1,47 +0,0 @@ -cmake_minimum_required(VERSION 3.18 FATAL_ERROR) - -project(yolov8_libtorch_example) - -set(CMAKE_CXX_STANDARD 17) -set(CMAKE_CXX_STANDARD_REQUIRED ON) -set(CMAKE_CXX_EXTENSIONS OFF) - - -# -------------- OpenCV -------------- -set(OpenCV_DIR "/path/to/opencv/lib/cmake/opencv4") -find_package(OpenCV REQUIRED) - -message(STATUS "OpenCV library status:") -message(STATUS " config: ${OpenCV_DIR}") -message(STATUS " version: ${OpenCV_VERSION}") -message(STATUS " libraries: ${OpenCV_LIBS}") -message(STATUS " include path: ${OpenCV_INCLUDE_DIRS}") - -include_directories(${OpenCV_INCLUDE_DIRS}) - -# -------------- libtorch -------------- -list(APPEND CMAKE_PREFIX_PATH "/path/to/libtorch") -set(Torch_DIR "/path/to/libtorch/share/cmake/Torch") - -find_package(Torch REQUIRED) -set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${TORCH_CXX_FLAGS}") -message("${TORCH_LIBRARIES}") -message("${TORCH_INCLUDE_DIRS}") - -# The following code block is suggested to be used on Windows. -# According to https://github.com/pytorch/pytorch/issues/25457, -# the DLLs need to be copied to avoid memory errors. -# if (MSVC) -# file(GLOB TORCH_DLLS "${TORCH_INSTALL_PREFIX}/lib/*.dll") -# add_custom_command(TARGET yolov8_libtorch_example -# POST_BUILD -# COMMAND ${CMAKE_COMMAND} -E copy_if_different -# ${TORCH_DLLS} -# $) -# endif (MSVC) - -include_directories(${TORCH_INCLUDE_DIRS}) - -add_executable(yolov8_libtorch_inference "${CMAKE_CURRENT_SOURCE_DIR}/main.cc") -target_link_libraries(yolov8_libtorch_inference ${TORCH_LIBRARIES} ${OpenCV_LIBS}) -set_property(TARGET yolov8_libtorch_inference PROPERTY CXX_STANDARD 17) diff --git a/ultralytics-main/examples/YOLOv8-LibTorch-CPP-Inference/README.md b/ultralytics-main/examples/YOLOv8-LibTorch-CPP-Inference/README.md deleted file mode 100644 index 930c3cd..0000000 --- a/ultralytics-main/examples/YOLOv8-LibTorch-CPP-Inference/README.md +++ /dev/null @@ -1,35 +0,0 @@ -# YOLOv8 LibTorch Inference C++ - -This example demonstrates how to perform inference using YOLOv8 models in C++ with LibTorch API. - -## Dependencies - -| Dependency | Version | -| ------------ | -------- | -| OpenCV | >=4.0.0 | -| C++ Standard | >=17 | -| Cmake | >=3.18 | -| Libtorch | >=1.12.1 | - -## Usage - -```bash -git clone ultralytics -cd ultralytics -pip install . -cd examples/YOLOv8-LibTorch-CPP-Inference - -mkdir build -cd build -cmake .. -make -./yolov8_libtorch_inference -``` - -## Exporting YOLOv8 - -To export YOLOv8 models: - -```commandline -yolo export model=yolov8s.pt imgsz=640 format=torchscript -``` diff --git a/ultralytics-main/examples/YOLOv8-LibTorch-CPP-Inference/main.cc b/ultralytics-main/examples/YOLOv8-LibTorch-CPP-Inference/main.cc deleted file mode 100644 index ebb1a75..0000000 --- a/ultralytics-main/examples/YOLOv8-LibTorch-CPP-Inference/main.cc +++ /dev/null @@ -1,259 +0,0 @@ -#include - -#include -#include -#include -#include -#include - -using torch::indexing::Slice; -using torch::indexing::None; - - -float generate_scale(cv::Mat& image, const std::vector& target_size) { - int origin_w = image.cols; - int origin_h = image.rows; - - int target_h = target_size[0]; - int target_w = target_size[1]; - - float ratio_h = static_cast(target_h) / static_cast(origin_h); - float ratio_w = static_cast(target_w) / static_cast(origin_w); - float resize_scale = std::min(ratio_h, ratio_w); - return resize_scale; -} - - -float letterbox(cv::Mat &input_image, cv::Mat &output_image, const std::vector &target_size) { - if (input_image.cols == target_size[1] && input_image.rows == target_size[0]) { - if (input_image.data == output_image.data) { - return 1.; - } else { - output_image = input_image.clone(); - return 1.; - } - } - - float resize_scale = generate_scale(input_image, target_size); - int new_shape_w = std::round(input_image.cols * resize_scale); - int new_shape_h = std::round(input_image.rows * resize_scale); - float padw = (target_size[1] - new_shape_w) / 2.; - float padh = (target_size[0] - new_shape_h) / 2.; - - int top = std::round(padh - 0.1); - int bottom = std::round(padh + 0.1); - int left = std::round(padw - 0.1); - int right = std::round(padw + 0.1); - - cv::resize(input_image, output_image, - cv::Size(new_shape_w, new_shape_h), - 0, 0, cv::INTER_AREA); - - cv::copyMakeBorder(output_image, output_image, top, bottom, left, right, - cv::BORDER_CONSTANT, cv::Scalar(114.)); - return resize_scale; -} - - -torch::Tensor xyxy2xywh(const torch::Tensor& x) { - auto y = torch::empty_like(x); - y.index_put_({"...", 0}, (x.index({"...", 0}) + x.index({"...", 2})).div(2)); - y.index_put_({"...", 1}, (x.index({"...", 1}) + x.index({"...", 3})).div(2)); - y.index_put_({"...", 2}, x.index({"...", 2}) - x.index({"...", 0})); - y.index_put_({"...", 3}, x.index({"...", 3}) - x.index({"...", 1})); - return y; -} - - -torch::Tensor xywh2xyxy(const torch::Tensor& x) { - auto y = torch::empty_like(x); - auto dw = x.index({"...", 2}).div(2); - auto dh = x.index({"...", 3}).div(2); - y.index_put_({"...", 0}, x.index({"...", 0}) - dw); - y.index_put_({"...", 1}, x.index({"...", 1}) - dh); - y.index_put_({"...", 2}, x.index({"...", 0}) + dw); - y.index_put_({"...", 3}, x.index({"...", 1}) + dh); - return y; -} - - -// Reference: https://github.com/pytorch/vision/blob/main/torchvision/csrc/ops/cpu/nms_kernel.cpp -torch::Tensor nms(const torch::Tensor& bboxes, const torch::Tensor& scores, float iou_threshold) { - if (bboxes.numel() == 0) - return torch::empty({0}, bboxes.options().dtype(torch::kLong)); - - auto x1_t = bboxes.select(1, 0).contiguous(); - auto y1_t = bboxes.select(1, 1).contiguous(); - auto x2_t = bboxes.select(1, 2).contiguous(); - auto y2_t = bboxes.select(1, 3).contiguous(); - - torch::Tensor areas_t = (x2_t - x1_t) * (y2_t - y1_t); - - auto order_t = std::get<1>( - scores.sort(/*stable=*/true, /*dim=*/0, /* descending=*/true)); - - auto ndets = bboxes.size(0); - torch::Tensor suppressed_t = torch::zeros({ndets}, bboxes.options().dtype(torch::kByte)); - torch::Tensor keep_t = torch::zeros({ndets}, bboxes.options().dtype(torch::kLong)); - - auto suppressed = suppressed_t.data_ptr(); - auto keep = keep_t.data_ptr(); - auto order = order_t.data_ptr(); - auto x1 = x1_t.data_ptr(); - auto y1 = y1_t.data_ptr(); - auto x2 = x2_t.data_ptr(); - auto y2 = y2_t.data_ptr(); - auto areas = areas_t.data_ptr(); - - int64_t num_to_keep = 0; - - for (int64_t _i = 0; _i < ndets; _i++) { - auto i = order[_i]; - if (suppressed[i] == 1) - continue; - keep[num_to_keep++] = i; - auto ix1 = x1[i]; - auto iy1 = y1[i]; - auto ix2 = x2[i]; - auto iy2 = y2[i]; - auto iarea = areas[i]; - - for (int64_t _j = _i + 1; _j < ndets; _j++) { - auto j = order[_j]; - if (suppressed[j] == 1) - continue; - auto xx1 = std::max(ix1, x1[j]); - auto yy1 = std::max(iy1, y1[j]); - auto xx2 = std::min(ix2, x2[j]); - auto yy2 = std::min(iy2, y2[j]); - - auto w = std::max(static_cast(0), xx2 - xx1); - auto h = std::max(static_cast(0), yy2 - yy1); - auto inter = w * h; - auto ovr = inter / (iarea + areas[j] - inter); - if (ovr > iou_threshold) - suppressed[j] = 1; - } - } - return keep_t.narrow(0, 0, num_to_keep); -} - - -torch::Tensor non_max_supperession(torch::Tensor& prediction, float conf_thres = 0.25, float iou_thres = 0.45, int max_det = 300) { - auto bs = prediction.size(0); - auto nc = prediction.size(1) - 4; - auto nm = prediction.size(1) - nc - 4; - auto mi = 4 + nc; - auto xc = prediction.index({Slice(), Slice(4, mi)}).amax(1) > conf_thres; - - prediction = prediction.transpose(-1, -2); - prediction.index_put_({"...", Slice({None, 4})}, xywh2xyxy(prediction.index({"...", Slice(None, 4)}))); - - std::vector output; - for (int i = 0; i < bs; i++) { - output.push_back(torch::zeros({0, 6 + nm}, prediction.device())); - } - - for (int xi = 0; xi < prediction.size(0); xi++) { - auto x = prediction[xi]; - x = x.index({xc[xi]}); - auto x_split = x.split({4, nc, nm}, 1); - auto box = x_split[0], cls = x_split[1], mask = x_split[2]; - auto [conf, j] = cls.max(1, true); - x = torch::cat({box, conf, j.toType(torch::kFloat), mask}, 1); - x = x.index({conf.view(-1) > conf_thres}); - int n = x.size(0); - if (!n) { continue; } - - // NMS - auto c = x.index({Slice(), Slice{5, 6}}) * 7680; - auto boxes = x.index({Slice(), Slice(None, 4)}) + c; - auto scores = x.index({Slice(), 4}); - auto i = nms(boxes, scores, iou_thres); - i = i.index({Slice(None, max_det)}); - output[xi] = x.index({i}); - } - - return torch::stack(output); -} - - -torch::Tensor clip_boxes(torch::Tensor& boxes, const std::vector& shape) { - boxes.index_put_({"...", 0}, boxes.index({"...", 0}).clamp(0, shape[1])); - boxes.index_put_({"...", 1}, boxes.index({"...", 1}).clamp(0, shape[0])); - boxes.index_put_({"...", 2}, boxes.index({"...", 2}).clamp(0, shape[1])); - boxes.index_put_({"...", 3}, boxes.index({"...", 3}).clamp(0, shape[0])); - return boxes; -} - - -torch::Tensor scale_boxes(const std::vector& img1_shape, torch::Tensor& boxes, const std::vector& img0_shape) { - auto gain = (std::min)((float)img1_shape[0] / img0_shape[0], (float)img1_shape[1] / img0_shape[1]); - auto pad0 = std::round((float)(img1_shape[1] - img0_shape[1] * gain) / 2. - 0.1); - auto pad1 = std::round((float)(img1_shape[0] - img0_shape[0] * gain) / 2. - 0.1); - - boxes.index_put_({"...", 0}, boxes.index({"...", 0}) - pad0); - boxes.index_put_({"...", 2}, boxes.index({"...", 2}) - pad0); - boxes.index_put_({"...", 1}, boxes.index({"...", 1}) - pad1); - boxes.index_put_({"...", 3}, boxes.index({"...", 3}) - pad1); - boxes.index_put_({"...", Slice(None, 4)}, boxes.index({"...", Slice(None, 4)}).div(gain)); - return boxes; -} - - -int main() { - // Device - torch::Device device(torch::cuda::is_available() ? torch::kCUDA :torch::kCPU); - - // Note that in this example the classes are hard-coded - std::vector classes {"person", "bicycle", "car", "motorcycle", "airplane", "bus", "train", "truck", "boat", "traffic light", "fire hydrant", - "stop sign", "parking meter", "bench", "bird", "cat", "dog", "horse", "sheep", "cow", "elephant", "bear", "zebra", - "giraffe", "backpack", "umbrella", "handbag", "tie", "suitcase", "frisbee", "skis", "snowboard", "sports ball", "kite", - "baseball bat", "baseball glove", "skateboard", "surfboard", "tennis racket", "bottle", "wine glass", "cup", "fork", "knife", - "spoon", "bowl", "banana", "apple", "sandwich", "orange", "broccoli", "carrot", "hot dog", "pizza", "donut", "cake", "chair", - "couch", "potted plant", "bed", "dining table", "toilet", "tv", "laptop", "mouse", "remote", "keyboard", "cell phone", - "microwave", "oven", "toaster", "sink", "refrigerator", "book", "clock", "vase", "scissors", "teddy bear", "hair drier", "toothbrush"}; - - try { - // Load the model (e.g. yolov8s.torchscript) - std::string model_path = "/path/to/yolov8s.torchscript"; - torch::jit::script::Module yolo_model; - yolo_model = torch::jit::load(model_path); - yolo_model.eval(); - yolo_model.to(device, torch::kFloat32); - - // Load image and preprocess - cv::Mat image = cv::imread("/path/to/bus.jpg"); - cv::Mat input_image; - letterbox(image, input_image, {640, 640}); - - torch::Tensor image_tensor = torch::from_blob(input_image.data, {input_image.rows, input_image.cols, 3}, torch::kByte).to(device); - image_tensor = image_tensor.toType(torch::kFloat32).div(255); - image_tensor = image_tensor.permute({2, 0, 1}); - image_tensor = image_tensor.unsqueeze(0); - std::vector inputs {image_tensor}; - - // Inference - torch::Tensor output = yolo_model.forward(inputs).toTensor().cpu(); - - // NMS - auto keep = non_max_supperession(output)[0]; - auto boxes = keep.index({Slice(), Slice(None, 4)}); - keep.index_put_({Slice(), Slice(None, 4)}, scale_boxes({input_image.rows, input_image.cols}, boxes, {image.rows, image.cols})); - - // Show the results - for (int i = 0; i < keep.size(0); i++) { - int x1 = keep[i][0].item().toFloat(); - int y1 = keep[i][1].item().toFloat(); - int x2 = keep[i][2].item().toFloat(); - int y2 = keep[i][3].item().toFloat(); - float conf = keep[i][4].item().toFloat(); - int cls = keep[i][5].item().toInt(); - std::cout << "Rect: [" << x1 << "," << y1 << "," << x2 << "," << y2 << "] Conf: " << conf << " Class: " << classes[cls] << std::endl; - } - } catch (const c10::Error& e) { - std::cout << e.msg() << std::endl; - } - - return 0; -} diff --git a/ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/CMakeLists.txt b/ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/CMakeLists.txt deleted file mode 100644 index 86232cc..0000000 --- a/ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/CMakeLists.txt +++ /dev/null @@ -1,96 +0,0 @@ -cmake_minimum_required(VERSION 3.5) - -set(PROJECT_NAME Yolov8OnnxRuntimeCPPInference) -project(${PROJECT_NAME} VERSION 0.0.1 LANGUAGES CXX) - - -# -------------- Support C++17 for using filesystem ------------------# -set(CMAKE_CXX_STANDARD 17) -set(CMAKE_CXX_STANDARD_REQUIRED ON) -set(CMAKE_CXX_EXTENSIONS ON) -set(CMAKE_INCLUDE_CURRENT_DIR ON) - - -# -------------- OpenCV ------------------# -find_package(OpenCV REQUIRED) -include_directories(${OpenCV_INCLUDE_DIRS}) - - -# -------------- Compile CUDA for FP16 inference if needed ------------------# -option(USE_CUDA "Enable CUDA support" ON) -if (NOT APPLE AND USE_CUDA) - find_package(CUDA REQUIRED) - include_directories(${CUDA_INCLUDE_DIRS}) - add_definitions(-DUSE_CUDA) -else () - set(USE_CUDA OFF) -endif () - -# -------------- ONNXRUNTIME ------------------# - -# Set ONNXRUNTIME_VERSION -set(ONNXRUNTIME_VERSION 1.15.1) - -if (WIN32) - if (USE_CUDA) - set(ONNXRUNTIME_ROOT "${CMAKE_CURRENT_SOURCE_DIR}/onnxruntime-win-x64-gpu-${ONNXRUNTIME_VERSION}") - else () - set(ONNXRUNTIME_ROOT "${CMAKE_CURRENT_SOURCE_DIR}/onnxruntime-win-x64-${ONNXRUNTIME_VERSION}") - endif () -elseif (LINUX) - if (USE_CUDA) - set(ONNXRUNTIME_ROOT "${CMAKE_CURRENT_SOURCE_DIR}/onnxruntime-linux-x64-gpu-${ONNXRUNTIME_VERSION}") - else () - set(ONNXRUNTIME_ROOT "${CMAKE_CURRENT_SOURCE_DIR}/onnxruntime-linux-x64-${ONNXRUNTIME_VERSION}") - endif () -elseif (APPLE) - set(ONNXRUNTIME_ROOT "${CMAKE_CURRENT_SOURCE_DIR}/onnxruntime-osx-arm64-${ONNXRUNTIME_VERSION}") - # Apple X64 binary - # set(ONNXRUNTIME_ROOT "${CMAKE_CURRENT_SOURCE_DIR}/onnxruntime-osx-x64-${ONNXRUNTIME_VERSION}") - # Apple Universal binary - # set(ONNXRUNTIME_ROOT "${CMAKE_CURRENT_SOURCE_DIR}/onnxruntime-osx-universal2-${ONNXRUNTIME_VERSION}") -endif () - -include_directories(${PROJECT_NAME} ${ONNXRUNTIME_ROOT}/include) - -set(PROJECT_SOURCES - main.cpp - inference.h - inference.cpp -) - -add_executable(${PROJECT_NAME} ${PROJECT_SOURCES}) - -if (WIN32) - target_link_libraries(${PROJECT_NAME} ${OpenCV_LIBS} ${ONNXRUNTIME_ROOT}/lib/onnxruntime.lib) - if (USE_CUDA) - target_link_libraries(${PROJECT_NAME} ${CUDA_LIBRARIES}) - endif () -elseif (LINUX) - target_link_libraries(${PROJECT_NAME} ${OpenCV_LIBS} ${ONNXRUNTIME_ROOT}/lib/libonnxruntime.so) - if (USE_CUDA) - target_link_libraries(${PROJECT_NAME} ${CUDA_LIBRARIES}) - endif () -elseif (APPLE) - target_link_libraries(${PROJECT_NAME} ${OpenCV_LIBS} ${ONNXRUNTIME_ROOT}/lib/libonnxruntime.dylib) -endif () - -# For windows system, copy onnxruntime.dll to the same folder of the executable file -if (WIN32) - add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD - COMMAND ${CMAKE_COMMAND} -E copy_if_different - "${ONNXRUNTIME_ROOT}/lib/onnxruntime.dll" - $) -endif () - -# Download https://raw.githubusercontent.com/ultralytics/ultralytics/main/ultralytics/cfg/datasets/coco.yaml -# and put it in the same folder of the executable file -configure_file(coco.yaml ${CMAKE_CURRENT_BINARY_DIR}/coco.yaml COPYONLY) - -# Copy yolov8n.onnx file to the same folder of the executable file -configure_file(yolov8n.onnx ${CMAKE_CURRENT_BINARY_DIR}/yolov8n.onnx COPYONLY) - -# Create folder name images in the same folder of the executable file -add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD - COMMAND ${CMAKE_COMMAND} -E make_directory ${CMAKE_CURRENT_BINARY_DIR}/images -) diff --git a/ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/README.md b/ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/README.md deleted file mode 100644 index 1cb6eb3..0000000 --- a/ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/README.md +++ /dev/null @@ -1,107 +0,0 @@ -# YOLOv8 OnnxRuntime C++ - -C++ Onnx-runtime - -This example demonstrates how to perform inference using YOLOv8 in C++ with ONNX Runtime and OpenCV's API. - -## Benefits ✨ - -- Friendly for deployment in the industrial sector. -- Faster than OpenCV's DNN inference on both CPU and GPU. -- Supports FP32 and FP16 CUDA acceleration. - -## Note ☕ - -1. Benefit for Ultralytics' latest release, a `Transpose` op is added to the YOLOv8 model, while make v8 and v5 has the same output shape. Therefore, you can run inference with YOLOv5/v7/v8 via this project. - -## Exporting YOLOv8 Models 📦 - -To export YOLOv8 models, use the following Python script: - -```python -from ultralytics import YOLO - -# Load a YOLOv8 model -model = YOLO("yolov8n.pt") - -# Export the model -model.export(format="onnx", opset=12, simplify=True, dynamic=False, imgsz=640) -``` - -Alternatively, you can use the following command for exporting the model in the terminal - -```bash -yolo export model=yolov8n.pt opset=12 simplify=True dynamic=False format=onnx imgsz=640,640 -``` - -## Exporting YOLOv8 FP16 Models 📦 - -```python -import onnx -from onnxconverter_common import float16 - -model = onnx.load(R'YOUR_ONNX_PATH') -model_fp16 = float16.convert_float_to_float16(model) -onnx.save(model_fp16, R'YOUR_FP16_ONNX_PATH') -``` - -## Download COCO.yaml file 📂 - -In order to run example, you also need to download coco.yaml. You can download the file manually from [here](https://raw.githubusercontent.com/ultralytics/ultralytics/main/ultralytics/cfg/datasets/coco.yaml) - -## Dependencies ⚙️ - -| Dependency | Version | -| -------------------------------- | -------------- | -| Onnxruntime(linux,windows,macos) | >=1.14.1 | -| OpenCV | >=4.0.0 | -| C++ Standard | >=17 | -| Cmake | >=3.5 | -| Cuda (Optional) | >=11.4 \<12.0 | -| cuDNN (Cuda required) | =8 | - -Note: The dependency on C++17 is due to the usage of the C++17 filesystem feature. - -Note (2): Due to ONNX Runtime, we need to use CUDA 11 and cuDNN 8. Keep in mind that this requirement might change in the future. - -## Build 🛠️ - -1. Clone the repository to your local machine. - -2. Navigate to the root directory of the repository. - -3. Create a build directory and navigate to it: - - ```console - mkdir build && cd build - ``` - -4. Run CMake to generate the build files: - - ```console - cmake .. - ``` - -5. Build the project: - - ```console - make - ``` - -6. The built executable should now be located in the `build` directory. - -## Usage 🚀 - -```c++ -//change your param as you like -//Pay attention to your device and the onnx model type(fp32 or fp16) -DL_INIT_PARAM params; -params.rectConfidenceThreshold = 0.1; -params.iouThreshold = 0.5; -params.modelPath = "yolov8n.onnx"; -params.imgSize = { 640, 640 }; -params.cudaEnable = true; -params.modelType = YOLO_DETECT_V8; -yoloDetector->CreateSession(params); -Detector(yoloDetector); -``` diff --git a/ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/inference.cpp b/ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/inference.cpp deleted file mode 100644 index 0bf07de..0000000 --- a/ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/inference.cpp +++ /dev/null @@ -1,363 +0,0 @@ -#include "inference.h" -#include - -#define benchmark -#define min(a,b) (((a) < (b)) ? (a) : (b)) -YOLO_V8::YOLO_V8() { - -} - - -YOLO_V8::~YOLO_V8() { - delete session; -} - -#ifdef USE_CUDA -namespace Ort -{ - template<> - struct TypeToTensorType { static constexpr ONNXTensorElementDataType type = ONNX_TENSOR_ELEMENT_DATA_TYPE_FLOAT16; }; -} -#endif - - -template -char* BlobFromImage(cv::Mat& iImg, T& iBlob) { - int channels = iImg.channels(); - int imgHeight = iImg.rows; - int imgWidth = iImg.cols; - - for (int c = 0; c < channels; c++) - { - for (int h = 0; h < imgHeight; h++) - { - for (int w = 0; w < imgWidth; w++) - { - iBlob[c * imgWidth * imgHeight + h * imgWidth + w] = typename std::remove_pointer::type( - (iImg.at(h, w)[c]) / 255.0f); - } - } - } - return RET_OK; -} - - -char* YOLO_V8::PreProcess(cv::Mat& iImg, std::vector iImgSize, cv::Mat& oImg) -{ - if (iImg.channels() == 3) - { - oImg = iImg.clone(); - cv::cvtColor(oImg, oImg, cv::COLOR_BGR2RGB); - } - else - { - cv::cvtColor(iImg, oImg, cv::COLOR_GRAY2RGB); - } - - switch (modelType) - { - case YOLO_DETECT_V8: - case YOLO_POSE: - case YOLO_DETECT_V8_HALF: - case YOLO_POSE_V8_HALF://LetterBox - { - if (iImg.cols >= iImg.rows) - { - resizeScales = iImg.cols / (float)iImgSize.at(0); - cv::resize(oImg, oImg, cv::Size(iImgSize.at(0), int(iImg.rows / resizeScales))); - } - else - { - resizeScales = iImg.rows / (float)iImgSize.at(0); - cv::resize(oImg, oImg, cv::Size(int(iImg.cols / resizeScales), iImgSize.at(1))); - } - cv::Mat tempImg = cv::Mat::zeros(iImgSize.at(0), iImgSize.at(1), CV_8UC3); - oImg.copyTo(tempImg(cv::Rect(0, 0, oImg.cols, oImg.rows))); - oImg = tempImg; - break; - } - case YOLO_CLS://CenterCrop - { - int h = iImg.rows; - int w = iImg.cols; - int m = min(h, w); - int top = (h - m) / 2; - int left = (w - m) / 2; - cv::resize(oImg(cv::Rect(left, top, m, m)), oImg, cv::Size(iImgSize.at(0), iImgSize.at(1))); - break; - } - } - return RET_OK; -} - - -char* YOLO_V8::CreateSession(DL_INIT_PARAM& iParams) { - char* Ret = RET_OK; - std::regex pattern("[\u4e00-\u9fa5]"); - bool result = std::regex_search(iParams.modelPath, pattern); - if (result) - { - Ret = "[YOLO_V8]:Your model path is error.Change your model path without chinese characters."; - std::cout << Ret << std::endl; - return Ret; - } - try - { - rectConfidenceThreshold = iParams.rectConfidenceThreshold; - iouThreshold = iParams.iouThreshold; - imgSize = iParams.imgSize; - modelType = iParams.modelType; - env = Ort::Env(ORT_LOGGING_LEVEL_WARNING, "Yolo"); - Ort::SessionOptions sessionOption; - if (iParams.cudaEnable) - { - cudaEnable = iParams.cudaEnable; - OrtCUDAProviderOptions cudaOption; - cudaOption.device_id = 0; - sessionOption.AppendExecutionProvider_CUDA(cudaOption); - } - sessionOption.SetGraphOptimizationLevel(GraphOptimizationLevel::ORT_ENABLE_ALL); - sessionOption.SetIntraOpNumThreads(iParams.intraOpNumThreads); - sessionOption.SetLogSeverityLevel(iParams.logSeverityLevel); - -#ifdef _WIN32 - int ModelPathSize = MultiByteToWideChar(CP_UTF8, 0, iParams.modelPath.c_str(), static_cast(iParams.modelPath.length()), nullptr, 0); - wchar_t* wide_cstr = new wchar_t[ModelPathSize + 1]; - MultiByteToWideChar(CP_UTF8, 0, iParams.modelPath.c_str(), static_cast(iParams.modelPath.length()), wide_cstr, ModelPathSize); - wide_cstr[ModelPathSize] = L'\0'; - const wchar_t* modelPath = wide_cstr; -#else - const char* modelPath = iParams.modelPath.c_str(); -#endif // _WIN32 - - session = new Ort::Session(env, modelPath, sessionOption); - Ort::AllocatorWithDefaultOptions allocator; - size_t inputNodesNum = session->GetInputCount(); - for (size_t i = 0; i < inputNodesNum; i++) - { - Ort::AllocatedStringPtr input_node_name = session->GetInputNameAllocated(i, allocator); - char* temp_buf = new char[50]; - strcpy(temp_buf, input_node_name.get()); - inputNodeNames.push_back(temp_buf); - } - size_t OutputNodesNum = session->GetOutputCount(); - for (size_t i = 0; i < OutputNodesNum; i++) - { - Ort::AllocatedStringPtr output_node_name = session->GetOutputNameAllocated(i, allocator); - char* temp_buf = new char[10]; - strcpy(temp_buf, output_node_name.get()); - outputNodeNames.push_back(temp_buf); - } - options = Ort::RunOptions{ nullptr }; - WarmUpSession(); - return RET_OK; - } - catch (const std::exception& e) - { - const char* str1 = "[YOLO_V8]:"; - const char* str2 = e.what(); - std::string result = std::string(str1) + std::string(str2); - char* merged = new char[result.length() + 1]; - std::strcpy(merged, result.c_str()); - std::cout << merged << std::endl; - delete[] merged; - return "[YOLO_V8]:Create session failed."; - } - -} - - -char* YOLO_V8::RunSession(cv::Mat& iImg, std::vector& oResult) { -#ifdef benchmark - clock_t starttime_1 = clock(); -#endif // benchmark - - char* Ret = RET_OK; - cv::Mat processedImg; - PreProcess(iImg, imgSize, processedImg); - if (modelType < 4) - { - float* blob = new float[processedImg.total() * 3]; - BlobFromImage(processedImg, blob); - std::vector inputNodeDims = { 1, 3, imgSize.at(0), imgSize.at(1) }; - TensorProcess(starttime_1, iImg, blob, inputNodeDims, oResult); - } - else - { -#ifdef USE_CUDA - half* blob = new half[processedImg.total() * 3]; - BlobFromImage(processedImg, blob); - std::vector inputNodeDims = { 1,3,imgSize.at(0),imgSize.at(1) }; - TensorProcess(starttime_1, iImg, blob, inputNodeDims, oResult); -#endif - } - - return Ret; -} - - -template -char* YOLO_V8::TensorProcess(clock_t& starttime_1, cv::Mat& iImg, N& blob, std::vector& inputNodeDims, - std::vector& oResult) { - Ort::Value inputTensor = Ort::Value::CreateTensor::type>( - Ort::MemoryInfo::CreateCpu(OrtDeviceAllocator, OrtMemTypeCPU), blob, 3 * imgSize.at(0) * imgSize.at(1), - inputNodeDims.data(), inputNodeDims.size()); -#ifdef benchmark - clock_t starttime_2 = clock(); -#endif // benchmark - auto outputTensor = session->Run(options, inputNodeNames.data(), &inputTensor, 1, outputNodeNames.data(), - outputNodeNames.size()); -#ifdef benchmark - clock_t starttime_3 = clock(); -#endif // benchmark - - Ort::TypeInfo typeInfo = outputTensor.front().GetTypeInfo(); - auto tensor_info = typeInfo.GetTensorTypeAndShapeInfo(); - std::vector outputNodeDims = tensor_info.GetShape(); - auto output = outputTensor.front().GetTensorMutableData::type>(); - delete[] blob; - switch (modelType) - { - case YOLO_DETECT_V8: - case YOLO_DETECT_V8_HALF: - { - int strideNum = outputNodeDims[1];//8400 - int signalResultNum = outputNodeDims[2];//84 - std::vector class_ids; - std::vector confidences; - std::vector boxes; - cv::Mat rawData; - if (modelType == YOLO_DETECT_V8) - { - // FP32 - rawData = cv::Mat(strideNum, signalResultNum, CV_32F, output); - } - else - { - // FP16 - rawData = cv::Mat(strideNum, signalResultNum, CV_16F, output); - rawData.convertTo(rawData, CV_32F); - } - //Note: - //ultralytics add transpose operator to the output of yolov8 model.which make yolov8/v5/v7 has same shape - //https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8n.pt - //rowData = rowData.t(); - - float* data = (float*)rawData.data; - - for (int i = 0; i < strideNum; ++i) - { - float* classesScores = data + 4; - cv::Mat scores(1, this->classes.size(), CV_32FC1, classesScores); - cv::Point class_id; - double maxClassScore; - cv::minMaxLoc(scores, 0, &maxClassScore, 0, &class_id); - if (maxClassScore > rectConfidenceThreshold) - { - confidences.push_back(maxClassScore); - class_ids.push_back(class_id.x); - float x = data[0]; - float y = data[1]; - float w = data[2]; - float h = data[3]; - - int left = int((x - 0.5 * w) * resizeScales); - int top = int((y - 0.5 * h) * resizeScales); - - int width = int(w * resizeScales); - int height = int(h * resizeScales); - - boxes.push_back(cv::Rect(left, top, width, height)); - } - data += signalResultNum; - } - std::vector nmsResult; - cv::dnn::NMSBoxes(boxes, confidences, rectConfidenceThreshold, iouThreshold, nmsResult); - for (int i = 0; i < nmsResult.size(); ++i) - { - int idx = nmsResult[i]; - DL_RESULT result; - result.classId = class_ids[idx]; - result.confidence = confidences[idx]; - result.box = boxes[idx]; - oResult.push_back(result); - } - -#ifdef benchmark - clock_t starttime_4 = clock(); - double pre_process_time = (double)(starttime_2 - starttime_1) / CLOCKS_PER_SEC * 1000; - double process_time = (double)(starttime_3 - starttime_2) / CLOCKS_PER_SEC * 1000; - double post_process_time = (double)(starttime_4 - starttime_3) / CLOCKS_PER_SEC * 1000; - if (cudaEnable) - { - std::cout << "[YOLO_V8(CUDA)]: " << pre_process_time << "ms pre-process, " << process_time << "ms inference, " << post_process_time << "ms post-process." << std::endl; - } - else - { - std::cout << "[YOLO_V8(CPU)]: " << pre_process_time << "ms pre-process, " << process_time << "ms inference, " << post_process_time << "ms post-process." << std::endl; - } -#endif // benchmark - - break; - } - case YOLO_CLS: - { - DL_RESULT result; - for (int i = 0; i < this->classes.size(); i++) - { - result.classId = i; - result.confidence = output[i]; - oResult.push_back(result); - } - break; - } - default: - std::cout << "[YOLO_V8]: " << "Not support model type." << std::endl; - } - return RET_OK; - -} - - -char* YOLO_V8::WarmUpSession() { - clock_t starttime_1 = clock(); - cv::Mat iImg = cv::Mat(cv::Size(imgSize.at(0), imgSize.at(1)), CV_8UC3); - cv::Mat processedImg; - PreProcess(iImg, imgSize, processedImg); - if (modelType < 4) - { - float* blob = new float[iImg.total() * 3]; - BlobFromImage(processedImg, blob); - std::vector YOLO_input_node_dims = { 1, 3, imgSize.at(0), imgSize.at(1) }; - Ort::Value input_tensor = Ort::Value::CreateTensor( - Ort::MemoryInfo::CreateCpu(OrtDeviceAllocator, OrtMemTypeCPU), blob, 3 * imgSize.at(0) * imgSize.at(1), - YOLO_input_node_dims.data(), YOLO_input_node_dims.size()); - auto output_tensors = session->Run(options, inputNodeNames.data(), &input_tensor, 1, outputNodeNames.data(), - outputNodeNames.size()); - delete[] blob; - clock_t starttime_4 = clock(); - double post_process_time = (double)(starttime_4 - starttime_1) / CLOCKS_PER_SEC * 1000; - if (cudaEnable) - { - std::cout << "[YOLO_V8(CUDA)]: " << "Cuda warm-up cost " << post_process_time << " ms. " << std::endl; - } - } - else - { -#ifdef USE_CUDA - half* blob = new half[iImg.total() * 3]; - BlobFromImage(processedImg, blob); - std::vector YOLO_input_node_dims = { 1,3,imgSize.at(0),imgSize.at(1) }; - Ort::Value input_tensor = Ort::Value::CreateTensor(Ort::MemoryInfo::CreateCpu(OrtDeviceAllocator, OrtMemTypeCPU), blob, 3 * imgSize.at(0) * imgSize.at(1), YOLO_input_node_dims.data(), YOLO_input_node_dims.size()); - auto output_tensors = session->Run(options, inputNodeNames.data(), &input_tensor, 1, outputNodeNames.data(), outputNodeNames.size()); - delete[] blob; - clock_t starttime_4 = clock(); - double post_process_time = (double)(starttime_4 - starttime_1) / CLOCKS_PER_SEC * 1000; - if (cudaEnable) - { - std::cout << "[YOLO_V8(CUDA)]: " << "Cuda warm-up cost " << post_process_time << " ms. " << std::endl; - } -#endif - } - return RET_OK; -} diff --git a/ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/inference.h b/ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/inference.h deleted file mode 100644 index 3174ae9..0000000 --- a/ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/inference.h +++ /dev/null @@ -1,93 +0,0 @@ -#pragma once - -#define RET_OK nullptr - -#ifdef _WIN32 -#include -#include -#include -#endif - -#include -#include -#include -#include -#include "onnxruntime_cxx_api.h" - -#ifdef USE_CUDA -#include -#endif - - -enum MODEL_TYPE -{ - //FLOAT32 MODEL - YOLO_DETECT_V8 = 1, - YOLO_POSE = 2, - YOLO_CLS = 3, - - //FLOAT16 MODEL - YOLO_DETECT_V8_HALF = 4, - YOLO_POSE_V8_HALF = 5, -}; - - -typedef struct _DL_INIT_PARAM -{ - std::string modelPath; - MODEL_TYPE modelType = YOLO_DETECT_V8; - std::vector imgSize = { 640, 640 }; - float rectConfidenceThreshold = 0.6; - float iouThreshold = 0.5; - int keyPointsNum = 2;//Note:kpt number for pose - bool cudaEnable = false; - int logSeverityLevel = 3; - int intraOpNumThreads = 1; -} DL_INIT_PARAM; - - -typedef struct _DL_RESULT -{ - int classId; - float confidence; - cv::Rect box; - std::vector keyPoints; -} DL_RESULT; - - -class YOLO_V8 -{ -public: - YOLO_V8(); - - ~YOLO_V8(); - -public: - char* CreateSession(DL_INIT_PARAM& iParams); - - char* RunSession(cv::Mat& iImg, std::vector& oResult); - - char* WarmUpSession(); - - template - char* TensorProcess(clock_t& starttime_1, cv::Mat& iImg, N& blob, std::vector& inputNodeDims, - std::vector& oResult); - - char* PreProcess(cv::Mat& iImg, std::vector iImgSize, cv::Mat& oImg); - - std::vector classes{}; - -private: - Ort::Env env; - Ort::Session* session; - bool cudaEnable; - Ort::RunOptions options; - std::vector inputNodeNames; - std::vector outputNodeNames; - - MODEL_TYPE modelType; - std::vector imgSize; - float rectConfidenceThreshold; - float iouThreshold; - float resizeScales;//letterbox scale -}; diff --git a/ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/main.cpp b/ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/main.cpp deleted file mode 100644 index 6e4ef1d..0000000 --- a/ultralytics-main/examples/YOLOv8-ONNXRuntime-CPP/main.cpp +++ /dev/null @@ -1,193 +0,0 @@ -#include -#include -#include "inference.h" -#include -#include -#include - -void Detector(YOLO_V8*& p) { - std::filesystem::path current_path = std::filesystem::current_path(); - std::filesystem::path imgs_path = current_path / "images"; - for (auto& i : std::filesystem::directory_iterator(imgs_path)) - { - if (i.path().extension() == ".jpg" || i.path().extension() == ".png" || i.path().extension() == ".jpeg") - { - std::string img_path = i.path().string(); - cv::Mat img = cv::imread(img_path); - std::vector res; - p->RunSession(img, res); - - for (auto& re : res) - { - cv::RNG rng(cv::getTickCount()); - cv::Scalar color(rng.uniform(0, 256), rng.uniform(0, 256), rng.uniform(0, 256)); - - cv::rectangle(img, re.box, color, 3); - - float confidence = floor(100 * re.confidence) / 100; - std::cout << std::fixed << std::setprecision(2); - std::string label = p->classes[re.classId] + " " + - std::to_string(confidence).substr(0, std::to_string(confidence).size() - 4); - - cv::rectangle( - img, - cv::Point(re.box.x, re.box.y - 25), - cv::Point(re.box.x + label.length() * 15, re.box.y), - color, - cv::FILLED - ); - - cv::putText( - img, - label, - cv::Point(re.box.x, re.box.y - 5), - cv::FONT_HERSHEY_SIMPLEX, - 0.75, - cv::Scalar(0, 0, 0), - 2 - ); - - - } - std::cout << "Press any key to exit" << std::endl; - cv::imshow("Result of Detection", img); - cv::waitKey(0); - cv::destroyAllWindows(); - } - } -} - - -void Classifier(YOLO_V8*& p) -{ - std::filesystem::path current_path = std::filesystem::current_path(); - std::filesystem::path imgs_path = current_path;// / "images" - std::random_device rd; - std::mt19937 gen(rd()); - std::uniform_int_distribution dis(0, 255); - for (auto& i : std::filesystem::directory_iterator(imgs_path)) - { - if (i.path().extension() == ".jpg" || i.path().extension() == ".png") - { - std::string img_path = i.path().string(); - //std::cout << img_path << std::endl; - cv::Mat img = cv::imread(img_path); - std::vector res; - char* ret = p->RunSession(img, res); - - float positionY = 50; - for (int i = 0; i < res.size(); i++) - { - int r = dis(gen); - int g = dis(gen); - int b = dis(gen); - cv::putText(img, std::to_string(i) + ":", cv::Point(10, positionY), cv::FONT_HERSHEY_SIMPLEX, 1, cv::Scalar(b, g, r), 2); - cv::putText(img, std::to_string(res.at(i).confidence), cv::Point(70, positionY), cv::FONT_HERSHEY_SIMPLEX, 1, cv::Scalar(b, g, r), 2); - positionY += 50; - } - - cv::imshow("TEST_CLS", img); - cv::waitKey(0); - cv::destroyAllWindows(); - //cv::imwrite("E:\\output\\" + std::to_string(k) + ".png", img); - } - - } -} - - - -int ReadCocoYaml(YOLO_V8*& p) { - // Open the YAML file - std::ifstream file("coco.yaml"); - if (!file.is_open()) - { - std::cerr << "Failed to open file" << std::endl; - return 1; - } - - // Read the file line by line - std::string line; - std::vector lines; - while (std::getline(file, line)) - { - lines.push_back(line); - } - - // Find the start and end of the names section - std::size_t start = 0; - std::size_t end = 0; - for (std::size_t i = 0; i < lines.size(); i++) - { - if (lines[i].find("names:") != std::string::npos) - { - start = i + 1; - } - else if (start > 0 && lines[i].find(':') == std::string::npos) - { - end = i; - break; - } - } - - // Extract the names - std::vector names; - for (std::size_t i = start; i < end; i++) - { - std::stringstream ss(lines[i]); - std::string name; - std::getline(ss, name, ':'); // Extract the number before the delimiter - std::getline(ss, name); // Extract the string after the delimiter - names.push_back(name); - } - - p->classes = names; - return 0; -} - - -void DetectTest() -{ - YOLO_V8* yoloDetector = new YOLO_V8; - ReadCocoYaml(yoloDetector); - DL_INIT_PARAM params; - params.rectConfidenceThreshold = 0.1; - params.iouThreshold = 0.5; - params.modelPath = "yolov8n.onnx"; - params.imgSize = { 640, 640 }; -#ifdef USE_CUDA - params.cudaEnable = true; - - // GPU FP32 inference - params.modelType = YOLO_DETECT_V8; - // GPU FP16 inference - //Note: change fp16 onnx model - //params.modelType = YOLO_DETECT_V8_HALF; - -#else - // CPU inference - params.modelType = YOLO_DETECT_V8; - params.cudaEnable = false; - -#endif - yoloDetector->CreateSession(params); - Detector(yoloDetector); -} - - -void ClsTest() -{ - YOLO_V8* yoloDetector = new YOLO_V8; - std::string model_path = "cls.onnx"; - ReadCocoYaml(yoloDetector); - DL_INIT_PARAM params{ model_path, YOLO_CLS, {224, 224} }; - yoloDetector->CreateSession(params); - Classifier(yoloDetector); -} - - -int main() -{ - //DetectTest(); - ClsTest(); -} diff --git a/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/Cargo.toml b/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/Cargo.toml deleted file mode 100644 index 101f72e..0000000 --- a/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/Cargo.toml +++ /dev/null @@ -1,21 +0,0 @@ -[package] -name = "yolov8-rs" -version = "0.1.0" -edition = "2021" - -# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html - -[dependencies] -clap = { version = "4.2.4", features = ["derive"] } -image = { version = "0.24.7", default-features = false, features = ["jpeg", "png", "webp-encoder"] } -imageproc = { version = "0.23.0", default-features = false } -ndarray = { version = "0.15.6" } -ort = {version = "1.16.3", default-features = false, features = ["load-dynamic", "copy-dylibs", "half"]} -rusttype = { version = "0.9", default-features = false } -anyhow = { version = "1.0.75"} -regex = { version = "1.5.4" } -rand = { version ="0.8.5" } -chrono = { version = "0.4.30" } -half = { version = "2.3.1" } -dirs = { version = "5.0.1" } -ureq = { version = "2.9.1" } diff --git a/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/README.md b/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/README.md deleted file mode 100644 index 8961d9c..0000000 --- a/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/README.md +++ /dev/null @@ -1,221 +0,0 @@ -# YOLOv8-ONNXRuntime-Rust for All the Key YOLO Tasks - -This repository provides a Rust demo for performing YOLOv8 tasks like `Classification`, `Segmentation`, `Detection` and `Pose Detection` using ONNXRuntime. - -## Features - -- Support `Classification`, `Segmentation`, `Detection`, `Pose(Keypoints)-Detection` tasks. -- Support `FP16` & `FP32` ONNX models. -- Support `CPU`, `CUDA` and `TensorRT` execution provider to accelerate computation. -- Support dynamic input shapes(`batch`, `width`, `height`). - -## Installation - -### 1. Install Rust - -Please follow the Rust official installation. (https://www.rust-lang.org/tools/install) - -### 2. Install ONNXRuntime - -This repository use `ort` crate, which is ONNXRuntime wrapper for Rust. (https://docs.rs/ort/latest/ort/) - -You can follow the instruction with `ort` doc or simply do this: - -- step1: Download ONNXRuntime(https://github.com/microsoft/onnxruntime/releases) -- setp2: Set environment variable `PATH` for linking. - -On ubuntu, You can do like this: - -``` -vim ~/.bashrc - -# Add the path of ONNXRUntime lib -export LD_LIBRARY_PATH=/home/qweasd/Documents/onnxruntime-linux-x64-gpu-1.16.3/lib${LD_LIBRARY_PATH:+:${LD_LIBRARY_PATH}} - -source ~/.bashrc -``` - -### 3. \[Optional\] Install CUDA & CuDNN & TensorRT - -- CUDA execution provider requires CUDA v11.6+. -- TensorRT execution provider requires CUDA v11.4+ and TensorRT v8.4+. - -## Get Started - -### 1. Export the YOLOv8 ONNX Models - -```bash -pip install -U ultralytics - -# export onnx model with dynamic shapes -yolo export model=yolov8m.pt format=onnx simplify dynamic -yolo export model=yolov8m-cls.pt format=onnx simplify dynamic -yolo export model=yolov8m-pose.pt format=onnx simplify dynamic -yolo export model=yolov8m-seg.pt format=onnx simplify dynamic - - -# export onnx model with constant shapes -yolo export model=yolov8m.pt format=onnx simplify -yolo export model=yolov8m-cls.pt format=onnx simplify -yolo export model=yolov8m-pose.pt format=onnx simplify -yolo export model=yolov8m-seg.pt format=onnx simplify -``` - -### 2. Run Inference - -It will perform inference with the ONNX model on the source image. - -``` -cargo run --release -- --model --source -``` - -Set `--cuda` to use CUDA execution provider to speed up inference. - -``` -cargo run --release -- --cuda --model --source -``` - -Set `--trt` to use TensorRT execution provider, and you can set `--fp16` at the same time to use TensorRT FP16 engine. - -``` -cargo run --release -- --trt --fp16 --model --source -``` - -Set `--device_id` to select which device to run. When you have only one GPU, and you set `device_id` to 1 will not cause program panic, the `ort` would automatically fall back to `CPU` EP. - -``` -cargo run --release -- --cuda --device_id 0 --model --source -``` - -Set `--batch` to do multi-batch-size inference. - -If you're using `--trt`, you can also set `--batch-min` and `--batch-max` to explicitly specify min/max/opt batch for dynamic batch input.(https://onnxruntime.ai/docs/execution-providers/TensorRT-ExecutionProvider.html#explicit-shape-range-for-dynamic-shape-input).(Note that the ONNX model should exported with dynamic shapes) - -``` -cargo run --release -- --cuda --batch 2 --model --source -``` - -Set `--height` and `--width` to do dynamic image size inference. (Note that the ONNX model should exported with dynamic shapes) - -``` -cargo run --release -- --cuda --width 480 --height 640 --model --source -``` - -Set `--profile` to check time consumed in each stage.(Note that the model usually needs to take 1~3 times dry run to warmup. Make sure to run enough times to evaluate the result.) - -``` -cargo run --release -- --trt --fp16 --profile --model --source -``` - -Results: (yolov8m.onnx, batch=1, 3 times, trt, fp16, RTX 3060Ti) - -``` -==> 0 -[Model Preprocess]: 12.75788ms -[ORT H2D]: 237.118µs -[ORT Inference]: 507.895469ms -[ORT D2H]: 191.655µs -[Model Inference]: 508.34589ms -[Model Postprocess]: 1.061122ms -==> 1 -[Model Preprocess]: 13.658655ms -[ORT H2D]: 209.975µs -[ORT Inference]: 5.12372ms -[ORT D2H]: 182.389µs -[Model Inference]: 5.530022ms -[Model Postprocess]: 1.04851ms -==> 2 -[Model Preprocess]: 12.475332ms -[ORT H2D]: 246.127µs -[ORT Inference]: 5.048432ms -[ORT D2H]: 187.117µs -[Model Inference]: 5.493119ms -[Model Postprocess]: 1.040906ms -``` - -And also: - -`--conf`: confidence threshold \[default: 0.3\] - -`--iou`: iou threshold in NMS \[default: 0.45\] - -`--kconf`: confidence threshold of keypoint \[default: 0.55\] - -`--plot`: plot inference result with random RGB color and save - -you can check out all CLI arguments by: - -``` -git clone https://github.com/ultralytics/ultralytics -cd ultralytics/examples/YOLOv8-ONNXRuntime-Rust -cargo run --release -- --help -``` - -## Examples - -### Classification - -Running dynamic shape ONNX model on `CPU` with image size `--height 224 --width 224`. Saving plotted image in `runs` directory. - -``` -cargo run --release -- --model ../assets/weights/yolov8m-cls-dyn.onnx --source ../assets/images/dog.jpg --height 224 --width 224 --plot --profile -``` - -You will see result like: - -``` -Summary: -> Task: Classify (Ultralytics 8.0.217) -> EP: Cpu -> Dtype: Float32 -> Batch: 1 (Dynamic), Height: 224 (Dynamic), Width: 224 (Dynamic) -> nc: 1000 nk: 0, nm: 0, conf: 0.3, kconf: 0.55, iou: 0.45 - -[Model Preprocess]: 16.363477ms -[ORT H2D]: 50.722µs -[ORT Inference]: 16.295808ms -[ORT D2H]: 8.37µs -[Model Inference]: 16.367046ms -[Model Postprocess]: 3.527µs -[ - YOLOResult { - Probs(top5): Some([(208, 0.6950566), (209, 0.13823675), (178, 0.04849795), (215, 0.019029364), (212, 0.016506357)]), - Bboxes: None, - Keypoints: None, - Masks: None, - }, -] - -``` - -![2023-11-25-22-02-02-156623351](https://github.com/jamjamjon/ultralytics/assets/51357717/ef75c2ae-c5ab-44cc-9d9e-e60b51e39662) - -### Object Detection - -Using `CUDA` EP and dynamic image size `--height 640 --width 480` - -``` -cargo run --release -- --cuda --model ../assets/weights/yolov8m-dynamic.onnx --source ../assets/images/bus.jpg --plot --height 640 --width 480 -``` - -![det](https://github.com/jamjamjon/ultralytics/assets/51357717/5d89a19d-0c96-4a59-875c-defab6887a2c) - -### Pose Detection - -using `TensorRT` EP - -``` -cargo run --release -- --trt --model ../assets/weights/yolov8m-pose.onnx --source ../assets/images/bus.jpg --plot -``` - -![2023-11-25-22-31-45-127054025](https://github.com/jamjamjon/ultralytics/assets/51357717/157b5ba7-bfcf-47cf-bee7-68b62e0de1c4) - -### Instance Segmentation - -using `TensorRT` EP and FP16 model `--fp16` - -``` -cargo run --release -- --trt --fp16 --model ../assets/weights/yolov8m-seg.onnx --source ../assets/images/0172.jpg --plot -``` - -![seg](https://github.com/jamjamjon/ultralytics/assets/51357717/cf046f4f-9533-478a-adc7-4de22443a641) diff --git a/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/cli.rs b/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/cli.rs deleted file mode 100644 index 2ba0dd4..0000000 --- a/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/cli.rs +++ /dev/null @@ -1,87 +0,0 @@ -use clap::Parser; - -use crate::YOLOTask; - -#[derive(Parser, Clone)] -#[command(author, version, about, long_about = None)] -pub struct Args { - /// ONNX model path - #[arg(long, required = true)] - pub model: String, - - /// input path - #[arg(long, required = true)] - pub source: String, - - /// device id - #[arg(long, default_value_t = 0)] - pub device_id: u32, - - /// using TensorRT EP - #[arg(long)] - pub trt: bool, - - /// using CUDA EP - #[arg(long)] - pub cuda: bool, - - /// input batch size - #[arg(long, default_value_t = 1)] - pub batch: u32, - - /// trt input min_batch size - #[arg(long, default_value_t = 1)] - pub batch_min: u32, - - /// trt input max_batch size - #[arg(long, default_value_t = 32)] - pub batch_max: u32, - - /// using TensorRT --fp16 - #[arg(long)] - pub fp16: bool, - - /// specify YOLO task - #[arg(long, value_enum)] - pub task: Option, - - /// num_classes - #[arg(long)] - pub nc: Option, - - /// num_keypoints - #[arg(long)] - pub nk: Option, - - /// num_masks - #[arg(long)] - pub nm: Option, - - /// input image width - #[arg(long)] - pub width: Option, - - /// input image height - #[arg(long)] - pub height: Option, - - /// confidence threshold - #[arg(long, required = false, default_value_t = 0.3)] - pub conf: f32, - - /// iou threshold in NMS - #[arg(long, required = false, default_value_t = 0.45)] - pub iou: f32, - - /// confidence threshold of keypoint - #[arg(long, required = false, default_value_t = 0.55)] - pub kconf: f32, - - /// plot inference result and save - #[arg(long)] - pub plot: bool, - - /// check time consumed in each stage - #[arg(long)] - pub profile: bool, -} diff --git a/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/lib.rs b/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/lib.rs deleted file mode 100644 index 1af7f7c..0000000 --- a/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/lib.rs +++ /dev/null @@ -1,119 +0,0 @@ -#![allow(clippy::type_complexity)] - -use std::io::{Read, Write}; - -pub mod cli; -pub mod model; -pub mod ort_backend; -pub mod yolo_result; -pub use crate::cli::Args; -pub use crate::model::YOLOv8; -pub use crate::ort_backend::{Batch, OrtBackend, OrtConfig, OrtEP, YOLOTask}; -pub use crate::yolo_result::{Bbox, Embedding, Point2, YOLOResult}; - -pub fn non_max_suppression( - xs: &mut Vec<(Bbox, Option>, Option>)>, - iou_threshold: f32, -) { - xs.sort_by(|b1, b2| b2.0.confidence().partial_cmp(&b1.0.confidence()).unwrap()); - - let mut current_index = 0; - for index in 0..xs.len() { - let mut drop = false; - for prev_index in 0..current_index { - let iou = xs[prev_index].0.iou(&xs[index].0); - if iou > iou_threshold { - drop = true; - break; - } - } - if !drop { - xs.swap(current_index, index); - current_index += 1; - } - } - xs.truncate(current_index); -} - -pub fn gen_time_string(delimiter: &str) -> String { - let offset = chrono::FixedOffset::east_opt(8 * 60 * 60).unwrap(); // Beijing - let t_now = chrono::Utc::now().with_timezone(&offset); - let fmt = format!( - "%Y{}%m{}%d{}%H{}%M{}%S{}%f", - delimiter, delimiter, delimiter, delimiter, delimiter, delimiter - ); - t_now.format(&fmt).to_string() -} - -pub const SKELETON: [(usize, usize); 16] = [ - (0, 1), - (0, 2), - (1, 3), - (2, 4), - (5, 6), - (5, 11), - (6, 12), - (11, 12), - (5, 7), - (6, 8), - (7, 9), - (8, 10), - (11, 13), - (12, 14), - (13, 15), - (14, 16), -]; - -pub fn check_font(font: &str) -> rusttype::Font<'static> { - // check then load font - - // ultralytics font path - let font_path_config = match dirs::config_dir() { - Some(mut d) => { - d.push("Ultralytics"); - d.push(font); - d - } - None => panic!("Unsupported operating system. Now support Linux, MacOS, Windows."), - }; - - // current font path - let font_path_current = std::path::PathBuf::from(font); - - // check font - let font_path = if font_path_config.exists() { - font_path_config - } else if font_path_current.exists() { - font_path_current - } else { - println!("Downloading font..."); - let source_url = "https://ultralytics.com/assets/Arial.ttf"; - let resp = ureq::get(source_url) - .timeout(std::time::Duration::from_secs(500)) - .call() - .unwrap_or_else(|err| panic!("> Failed to download font: {source_url}: {err:?}")); - - // read to buffer - let mut buffer = vec![]; - let total_size = resp - .header("Content-Length") - .and_then(|s| s.parse::().ok()) - .unwrap(); - let _reader = resp - .into_reader() - .take(total_size) - .read_to_end(&mut buffer) - .unwrap(); - - // save - let _path = std::fs::File::create(font).unwrap(); - let mut writer = std::io::BufWriter::new(_path); - writer.write_all(&buffer).unwrap(); - println!("Font saved at: {:?}", font_path_current.display()); - font_path_current - }; - - // load font - let buffer = std::fs::read(font_path).unwrap(); - rusttype::Font::try_from_vec(buffer).unwrap() -} diff --git a/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/main.rs b/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/main.rs deleted file mode 100644 index 8dd1567..0000000 --- a/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/main.rs +++ /dev/null @@ -1,28 +0,0 @@ -use clap::Parser; - -use yolov8_rs::{Args, YOLOv8}; - -fn main() -> Result<(), Box> { - let args = Args::parse(); - - // 1. load image - let x = image::io::Reader::open(&args.source)? - .with_guessed_format()? - .decode()?; - - // 2. model support dynamic batch inference, so input should be a Vec - let xs = vec![x]; - - // You can test `--batch 2` with this - // let xs = vec![x.clone(), x]; - - // 3. build yolov8 model - let mut model = YOLOv8::new(args)?; - model.summary(); // model info - - // 4. run - let ys = model.run(&xs)?; - println!("{:?}", ys); - - Ok(()) -} diff --git a/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/model.rs b/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/model.rs deleted file mode 100644 index 1c0e5e4..0000000 --- a/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/model.rs +++ /dev/null @@ -1,642 +0,0 @@ -#![allow(clippy::type_complexity)] - -use anyhow::Result; -use image::{DynamicImage, GenericImageView, ImageBuffer}; -use ndarray::{s, Array, Axis, IxDyn}; -use rand::{thread_rng, Rng}; -use std::path::PathBuf; - -use crate::{ - check_font, gen_time_string, non_max_suppression, Args, Batch, Bbox, Embedding, OrtBackend, - OrtConfig, OrtEP, Point2, YOLOResult, YOLOTask, SKELETON, -}; - -pub struct YOLOv8 { - // YOLOv8 model for all yolo-tasks - engine: OrtBackend, - nc: u32, - nk: u32, - nm: u32, - height: u32, - width: u32, - batch: u32, - task: YOLOTask, - conf: f32, - kconf: f32, - iou: f32, - names: Vec, - color_palette: Vec<(u8, u8, u8)>, - profile: bool, - plot: bool, -} - -impl YOLOv8 { - pub fn new(config: Args) -> Result { - // execution provider - let ep = if config.trt { - OrtEP::Trt(config.device_id) - } else if config.cuda { - OrtEP::Cuda(config.device_id) - } else { - OrtEP::Cpu - }; - - // batch - let batch = Batch { - opt: config.batch, - min: config.batch_min, - max: config.batch_max, - }; - - // build ort engine - let ort_args = OrtConfig { - ep, - batch, - f: config.model, - task: config.task, - trt_fp16: config.fp16, - image_size: (config.height, config.width), - }; - let engine = OrtBackend::build(ort_args)?; - - // get batch, height, width, tasks, nc, nk, nm - let (batch, height, width, task) = ( - engine.batch(), - engine.height(), - engine.width(), - engine.task(), - ); - let nc = engine.nc().or(config.nc).unwrap_or_else(|| { - panic!("Failed to get num_classes, make it explicit with `--nc`"); - }); - let (nk, nm) = match task { - YOLOTask::Pose => { - let nk = engine.nk().or(config.nk).unwrap_or_else(|| { - panic!("Failed to get num_keypoints, make it explicit with `--nk`"); - }); - (nk, 0) - } - YOLOTask::Segment => { - let nm = engine.nm().or(config.nm).unwrap_or_else(|| { - panic!("Failed to get num_masks, make it explicit with `--nm`"); - }); - (0, nm) - } - _ => (0, 0), - }; - - // class names - let names = engine.names().unwrap_or(vec!["Unknown".to_string()]); - - // color palette - let mut rng = thread_rng(); - let color_palette: Vec<_> = names - .iter() - .map(|_| { - ( - rng.gen_range(0..=255), - rng.gen_range(0..=255), - rng.gen_range(0..=255), - ) - }) - .collect(); - - Ok(Self { - engine, - names, - conf: config.conf, - kconf: config.kconf, - iou: config.iou, - color_palette, - profile: config.profile, - plot: config.plot, - nc, - nk, - nm, - height, - width, - batch, - task, - }) - } - - pub fn scale_wh(&self, w0: f32, h0: f32, w1: f32, h1: f32) -> (f32, f32, f32) { - let r = (w1 / w0).min(h1 / h0); - (r, (w0 * r).round(), (h0 * r).round()) - } - - pub fn preprocess(&mut self, xs: &Vec) -> Result> { - let mut ys = - Array::ones((xs.len(), 3, self.height() as usize, self.width() as usize)).into_dyn(); - ys.fill(144.0 / 255.0); - for (idx, x) in xs.iter().enumerate() { - let img = match self.task() { - YOLOTask::Classify => x.resize_exact( - self.width(), - self.height(), - image::imageops::FilterType::Triangle, - ), - _ => { - let (w0, h0) = x.dimensions(); - let w0 = w0 as f32; - let h0 = h0 as f32; - let (_, w_new, h_new) = - self.scale_wh(w0, h0, self.width() as f32, self.height() as f32); // f32 round - x.resize_exact( - w_new as u32, - h_new as u32, - if let YOLOTask::Segment = self.task() { - image::imageops::FilterType::CatmullRom - } else { - image::imageops::FilterType::Triangle - }, - ) - } - }; - - for (x, y, rgb) in img.pixels() { - let x = x as usize; - let y = y as usize; - let [r, g, b, _] = rgb.0; - ys[[idx, 0, y, x]] = (r as f32) / 255.0; - ys[[idx, 1, y, x]] = (g as f32) / 255.0; - ys[[idx, 2, y, x]] = (b as f32) / 255.0; - } - } - - Ok(ys) - } - - pub fn run(&mut self, xs: &Vec) -> Result> { - // pre-process - let t_pre = std::time::Instant::now(); - let xs_ = self.preprocess(xs)?; - if self.profile { - println!("[Model Preprocess]: {:?}", t_pre.elapsed()); - } - - // run - let t_run = std::time::Instant::now(); - let ys = self.engine.run(xs_, self.profile)?; - if self.profile { - println!("[Model Inference]: {:?}", t_run.elapsed()); - } - - // post-process - let t_post = std::time::Instant::now(); - let ys = self.postprocess(ys, xs)?; - if self.profile { - println!("[Model Postprocess]: {:?}", t_post.elapsed()); - } - - // plot and save - if self.plot { - self.plot_and_save(&ys, xs, Some(&SKELETON)); - } - Ok(ys) - } - - pub fn postprocess( - &self, - xs: Vec>, - xs0: &[DynamicImage], - ) -> Result> { - if let YOLOTask::Classify = self.task() { - let mut ys = Vec::new(); - let preds = &xs[0]; - for batch in preds.axis_iter(Axis(0)) { - ys.push(YOLOResult::new( - Some(Embedding::new(batch.into_owned())), - None, - None, - None, - )); - } - Ok(ys) - } else { - const CXYWH_OFFSET: usize = 4; // cxcywh - const KPT_STEP: usize = 3; // xyconf - let preds = &xs[0]; - let protos = { - if xs.len() > 1 { - Some(&xs[1]) - } else { - None - } - }; - let mut ys = Vec::new(); - for (idx, anchor) in preds.axis_iter(Axis(0)).enumerate() { - // [bs, 4 + nc + nm, anchors] - // input image - let width_original = xs0[idx].width() as f32; - let height_original = xs0[idx].height() as f32; - let ratio = (self.width() as f32 / width_original) - .min(self.height() as f32 / height_original); - - // save each result - let mut data: Vec<(Bbox, Option>, Option>)> = Vec::new(); - for pred in anchor.axis_iter(Axis(1)) { - // split preds for different tasks - let bbox = pred.slice(s![0..CXYWH_OFFSET]); - let clss = pred.slice(s![CXYWH_OFFSET..CXYWH_OFFSET + self.nc() as usize]); - let kpts = { - if let YOLOTask::Pose = self.task() { - Some(pred.slice(s![pred.len() - KPT_STEP * self.nk() as usize..])) - } else { - None - } - }; - let coefs = { - if let YOLOTask::Segment = self.task() { - Some(pred.slice(s![pred.len() - self.nm() as usize..]).to_vec()) - } else { - None - } - }; - - // confidence and id - let (id, &confidence) = clss - .into_iter() - .enumerate() - .reduce(|max, x| if x.1 > max.1 { x } else { max }) - .unwrap(); // definitely will not panic! - - // confidence filter - if confidence < self.conf { - continue; - } - - // bbox re-scale - let cx = bbox[0] / ratio; - let cy = bbox[1] / ratio; - let w = bbox[2] / ratio; - let h = bbox[3] / ratio; - let x = cx - w / 2.; - let y = cy - h / 2.; - let y_bbox = Bbox::new( - x.max(0.0f32).min(width_original), - y.max(0.0f32).min(height_original), - w, - h, - id, - confidence, - ); - - // kpts - let y_kpts = { - if let Some(kpts) = kpts { - let mut kpts_ = Vec::new(); - // rescale - for i in 0..self.nk() as usize { - let kx = kpts[KPT_STEP * i] / ratio; - let ky = kpts[KPT_STEP * i + 1] / ratio; - let kconf = kpts[KPT_STEP * i + 2]; - if kconf < self.kconf { - kpts_.push(Point2::default()); - } else { - kpts_.push(Point2::new_with_conf( - kx.max(0.0f32).min(width_original), - ky.max(0.0f32).min(height_original), - kconf, - )); - } - } - Some(kpts_) - } else { - None - } - }; - - // data merged - data.push((y_bbox, y_kpts, coefs)); - } - - // nms - non_max_suppression(&mut data, self.iou); - - // decode - let mut y_bboxes: Vec = Vec::new(); - let mut y_kpts: Vec> = Vec::new(); - let mut y_masks: Vec> = Vec::new(); - for elem in data.into_iter() { - if let Some(kpts) = elem.1 { - y_kpts.push(kpts) - } - - // decode masks - if let Some(coefs) = elem.2 { - let proto = protos.unwrap().slice(s![idx, .., .., ..]); - let (nm, nh, nw) = proto.dim(); - - // coefs * proto -> mask - let coefs = Array::from_shape_vec((1, nm), coefs)?; // (n, nm) - let proto = proto.to_owned().into_shape((nm, nh * nw))?; // (nm, nh*nw) - let mask = coefs.dot(&proto).into_shape((nh, nw, 1))?; // (nh, nw, n) - - // build image from ndarray - let mask_im: ImageBuffer, Vec> = - match ImageBuffer::from_raw(nw as u32, nh as u32, mask.into_raw_vec()) { - Some(image) => image, - None => panic!("can not create image from ndarray"), - }; - let mut mask_im = image::DynamicImage::from(mask_im); // -> dyn - - // rescale masks - let (_, w_mask, h_mask) = - self.scale_wh(width_original, height_original, nw as f32, nh as f32); - let mask_cropped = mask_im.crop(0, 0, w_mask as u32, h_mask as u32); - let mask_original = mask_cropped.resize_exact( - // resize_to_fill - width_original as u32, - height_original as u32, - match self.task() { - YOLOTask::Segment => image::imageops::FilterType::CatmullRom, - _ => image::imageops::FilterType::Triangle, - }, - ); - - // crop-mask with bbox - let mut mask_original_cropped = mask_original.into_luma8(); - for y in 0..height_original as usize { - for x in 0..width_original as usize { - if x < elem.0.xmin() as usize - || x > elem.0.xmax() as usize - || y < elem.0.ymin() as usize - || y > elem.0.ymax() as usize - { - mask_original_cropped.put_pixel( - x as u32, - y as u32, - image::Luma([0u8]), - ); - } - } - } - y_masks.push(mask_original_cropped.into_raw()); - } - y_bboxes.push(elem.0); - } - - // save each result - let y = YOLOResult { - probs: None, - bboxes: if !y_bboxes.is_empty() { - Some(y_bboxes) - } else { - None - }, - keypoints: if !y_kpts.is_empty() { - Some(y_kpts) - } else { - None - }, - masks: if !y_masks.is_empty() { - Some(y_masks) - } else { - None - }, - }; - ys.push(y); - } - - Ok(ys) - } - } - - pub fn plot_and_save( - &self, - ys: &[YOLOResult], - xs0: &[DynamicImage], - skeletons: Option<&[(usize, usize)]>, - ) { - // check font then load - let font = check_font("Arial.ttf"); - for (_idb, (img0, y)) in xs0.iter().zip(ys.iter()).enumerate() { - let mut img = img0.to_rgb8(); - - // draw for classifier - if let Some(probs) = y.probs() { - for (i, k) in probs.topk(5).iter().enumerate() { - let legend = format!("{} {:.2}%", self.names[k.0], k.1); - let scale = 32; - let legend_size = img.width().max(img.height()) / scale; - let x = img.width() / 20; - let y = img.height() / 20 + i as u32 * legend_size; - imageproc::drawing::draw_text_mut( - &mut img, - image::Rgb([0, 255, 0]), - x as i32, - y as i32, - rusttype::Scale::uniform(legend_size as f32 - 1.), - &font, - &legend, - ); - } - } - - // draw bboxes & keypoints - if let Some(bboxes) = y.bboxes() { - for (_idx, bbox) in bboxes.iter().enumerate() { - // rect - imageproc::drawing::draw_hollow_rect_mut( - &mut img, - imageproc::rect::Rect::at(bbox.xmin() as i32, bbox.ymin() as i32) - .of_size(bbox.width() as u32, bbox.height() as u32), - image::Rgb(self.color_palette[bbox.id()].into()), - ); - - // text - let legend = format!("{} {:.2}%", self.names[bbox.id()], bbox.confidence()); - let scale = 40; - let legend_size = img.width().max(img.height()) / scale; - imageproc::drawing::draw_text_mut( - &mut img, - image::Rgb(self.color_palette[bbox.id()].into()), - bbox.xmin() as i32, - (bbox.ymin() - legend_size as f32) as i32, - rusttype::Scale::uniform(legend_size as f32 - 1.), - &font, - &legend, - ); - } - } - - // draw kpts - if let Some(keypoints) = y.keypoints() { - for kpts in keypoints.iter() { - for kpt in kpts.iter() { - // filter - if kpt.confidence() < self.kconf { - continue; - } - - // draw point - imageproc::drawing::draw_filled_circle_mut( - &mut img, - (kpt.x() as i32, kpt.y() as i32), - 2, - image::Rgb([0, 255, 0]), - ); - } - - // draw skeleton if has - if let Some(skeletons) = skeletons { - for &(idx1, idx2) in skeletons.iter() { - let kpt1 = &kpts[idx1]; - let kpt2 = &kpts[idx2]; - if kpt1.confidence() < self.kconf || kpt2.confidence() < self.kconf { - continue; - } - imageproc::drawing::draw_line_segment_mut( - &mut img, - (kpt1.x(), kpt1.y()), - (kpt2.x(), kpt2.y()), - image::Rgb([233, 14, 57]), - ); - } - } - } - } - - // draw mask - if let Some(masks) = y.masks() { - for (mask, _bbox) in masks.iter().zip(y.bboxes().unwrap().iter()) { - let mask_nd: ImageBuffer, Vec> = - match ImageBuffer::from_vec(img.width(), img.height(), mask.to_vec()) { - Some(image) => image, - None => panic!("can not crate image from ndarray"), - }; - - for _x in 0..img.width() { - for _y in 0..img.height() { - let mask_p = imageproc::drawing::Canvas::get_pixel(&mask_nd, _x, _y); - if mask_p.0[0] > 0 { - let mut img_p = imageproc::drawing::Canvas::get_pixel(&img, _x, _y); - // img_p.0[2] = self.color_palette[bbox.id()].2 / 2; - // img_p.0[1] = self.color_palette[bbox.id()].1 / 2; - // img_p.0[0] = self.color_palette[bbox.id()].0 / 2; - img_p.0[2] /= 2; - img_p.0[1] = 255 - (255 - img_p.0[2]) / 2; - img_p.0[0] /= 2; - imageproc::drawing::Canvas::draw_pixel(&mut img, _x, _y, img_p) - } - } - } - } - } - - // mkdir and save - let mut runs = PathBuf::from("runs"); - if !runs.exists() { - std::fs::create_dir_all(&runs).unwrap(); - } - runs.push(gen_time_string("-")); - let saveout = format!("{}.jpg", runs.to_str().unwrap()); - let _ = img.save(saveout); - } - } - - pub fn summary(&self) { - println!( - "\nSummary:\n\ - > Task: {:?}{}\n\ - > EP: {:?} {}\n\ - > Dtype: {:?}\n\ - > Batch: {} ({}), Height: {} ({}), Width: {} ({})\n\ - > nc: {} nk: {}, nm: {}, conf: {}, kconf: {}, iou: {}\n\ - ", - self.task(), - match self.engine.author().zip(self.engine.version()) { - Some((author, ver)) => format!(" ({} {})", author, ver), - None => String::from(""), - }, - self.engine.ep(), - if let OrtEP::Cpu = self.engine.ep() { - "" - } else { - "(May still fall back to CPU)" - }, - self.engine.dtype(), - self.batch(), - if self.engine.is_batch_dynamic() { - "Dynamic" - } else { - "Const" - }, - self.height(), - if self.engine.is_height_dynamic() { - "Dynamic" - } else { - "Const" - }, - self.width(), - if self.engine.is_width_dynamic() { - "Dynamic" - } else { - "Const" - }, - self.nc(), - self.nk(), - self.nm(), - self.conf, - self.kconf, - self.iou, - ); - } - - pub fn engine(&self) -> &OrtBackend { - &self.engine - } - - pub fn conf(&self) -> f32 { - self.conf - } - - pub fn set_conf(&mut self, val: f32) { - self.conf = val; - } - - pub fn conf_mut(&mut self) -> &mut f32 { - &mut self.conf - } - - pub fn kconf(&self) -> f32 { - self.kconf - } - - pub fn iou(&self) -> f32 { - self.iou - } - - pub fn task(&self) -> &YOLOTask { - &self.task - } - - pub fn batch(&self) -> u32 { - self.batch - } - - pub fn width(&self) -> u32 { - self.width - } - - pub fn height(&self) -> u32 { - self.height - } - - pub fn nc(&self) -> u32 { - self.nc - } - - pub fn nk(&self) -> u32 { - self.nk - } - - pub fn nm(&self) -> u32 { - self.nm - } - - pub fn names(&self) -> &Vec { - &self.names - } -} diff --git a/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/ort_backend.rs b/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/ort_backend.rs deleted file mode 100644 index 5be93bd..0000000 --- a/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/ort_backend.rs +++ /dev/null @@ -1,534 +0,0 @@ -use anyhow::Result; -use clap::ValueEnum; -use half::f16; -use ndarray::{Array, CowArray, IxDyn}; -use ort::execution_providers::{CUDAExecutionProviderOptions, TensorRTExecutionProviderOptions}; -use ort::tensor::TensorElementDataType; -use ort::{Environment, ExecutionProvider, Session, SessionBuilder, Value}; -use regex::Regex; - -#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord, ValueEnum)] -pub enum YOLOTask { - // YOLO tasks - Classify, - Detect, - Pose, - Segment, -} - -#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord)] -pub enum OrtEP { - // ONNXRuntime execution provider - Cpu, - Cuda(u32), - Trt(u32), -} - -#[derive(Debug)] -pub struct Batch { - pub opt: u32, - pub min: u32, - pub max: u32, -} - -impl Default for Batch { - fn default() -> Self { - Self { - opt: 1, - min: 1, - max: 1, - } - } -} - -#[derive(Debug, Default)] -pub struct OrtInputs { - // ONNX model inputs attrs - pub shapes: Vec>, - pub dtypes: Vec, - pub names: Vec, - pub sizes: Vec>, -} - -impl OrtInputs { - pub fn new(session: &Session) -> Self { - let mut shapes = Vec::new(); - let mut dtypes = Vec::new(); - let mut names = Vec::new(); - for i in session.inputs.iter() { - let shape: Vec = i - .dimensions() - .map(|x| if let Some(x) = x { x as i32 } else { -1i32 }) - .collect(); - shapes.push(shape); - dtypes.push(i.input_type); - names.push(i.name.clone()); - } - Self { - shapes, - dtypes, - names, - ..Default::default() - } - } -} - -#[derive(Debug)] -pub struct OrtConfig { - // ORT config - pub f: String, - pub task: Option, - pub ep: OrtEP, - pub trt_fp16: bool, - pub batch: Batch, - pub image_size: (Option, Option), -} - -#[derive(Debug)] -pub struct OrtBackend { - // ORT engine - session: Session, - task: YOLOTask, - ep: OrtEP, - batch: Batch, - inputs: OrtInputs, -} - -impl OrtBackend { - pub fn build(args: OrtConfig) -> Result { - // build env & session - let env = Environment::builder() - .with_name("YOLOv8") - .with_log_level(ort::LoggingLevel::Verbose) - .build()? - .into_arc(); - let session = SessionBuilder::new(&env)?.with_model_from_file(&args.f)?; - - // get inputs - let mut inputs = OrtInputs::new(&session); - - // batch size - let mut batch = args.batch; - let batch = if inputs.shapes[0][0] == -1 { - batch - } else { - assert_eq!( - inputs.shapes[0][0] as u32, batch.opt, - "Expected batch size: {}, got {}. Try using `--batch {}`.", - inputs.shapes[0][0] as u32, batch.opt, inputs.shapes[0][0] as u32 - ); - batch.opt = inputs.shapes[0][0] as u32; - batch - }; - - // input size: height and width - let height = if inputs.shapes[0][2] == -1 { - match args.image_size.0 { - Some(height) => height, - None => panic!("Failed to get model height. Make it explicit with `--height`"), - } - } else { - inputs.shapes[0][2] as u32 - }; - let width = if inputs.shapes[0][3] == -1 { - match args.image_size.1 { - Some(width) => width, - None => panic!("Failed to get model width. Make it explicit with `--width`"), - } - } else { - inputs.shapes[0][3] as u32 - }; - inputs.sizes.push(vec![height, width]); - - // build provider - let (ep, provider) = match args.ep { - OrtEP::Cuda(device_id) => Self::set_ep_cuda(device_id), - OrtEP::Trt(device_id) => Self::set_ep_trt(device_id, args.trt_fp16, &batch, &inputs), - _ => (OrtEP::Cpu, ExecutionProvider::CPU(Default::default())), - }; - - // build session again with the new provider - let session = SessionBuilder::new(&env)? - // .with_optimization_level(ort::GraphOptimizationLevel::Level3)? - .with_execution_providers([provider])? - .with_model_from_file(args.f)?; - - // task: using given one or guessing - let task = match args.task { - Some(task) => task, - None => match session.metadata() { - Err(_) => panic!("No metadata found. Try making it explicit by `--task`"), - Ok(metadata) => match metadata.custom("task") { - Err(_) => panic!("Can not get custom value. Try making it explicit by `--task`"), - Ok(value) => match value { - None => panic!("No correspoing value of `task` found in metadata. Make it explicit by `--task`"), - Some(task) => match task.as_str() { - "classify" => YOLOTask::Classify, - "detect" => YOLOTask::Detect, - "pose" => YOLOTask::Pose, - "segment" => YOLOTask::Segment, - x => todo!("{:?} is not supported for now!", x), - }, - }, - }, - }, - }; - - Ok(Self { - session, - task, - ep, - batch, - inputs, - }) - } - - pub fn fetch_inputs_from_session( - session: &Session, - ) -> (Vec>, Vec, Vec) { - // get inputs attrs from ONNX model - let mut shapes = Vec::new(); - let mut dtypes = Vec::new(); - let mut names = Vec::new(); - for i in session.inputs.iter() { - let shape: Vec = i - .dimensions() - .map(|x| if let Some(x) = x { x as i32 } else { -1i32 }) - .collect(); - shapes.push(shape); - dtypes.push(i.input_type); - names.push(i.name.clone()); - } - (shapes, dtypes, names) - } - - pub fn set_ep_cuda(device_id: u32) -> (OrtEP, ExecutionProvider) { - // set CUDA - if ExecutionProvider::CUDA(Default::default()).is_available() { - ( - OrtEP::Cuda(device_id), - ExecutionProvider::CUDA(CUDAExecutionProviderOptions { - device_id, - ..Default::default() - }), - ) - } else { - println!("> CUDA is not available! Using CPU."); - (OrtEP::Cpu, ExecutionProvider::CPU(Default::default())) - } - } - - pub fn set_ep_trt( - device_id: u32, - fp16: bool, - batch: &Batch, - inputs: &OrtInputs, - ) -> (OrtEP, ExecutionProvider) { - // set TensorRT - if ExecutionProvider::TensorRT(Default::default()).is_available() { - let (height, width) = (inputs.sizes[0][0], inputs.sizes[0][1]); - - // dtype match checking - if inputs.dtypes[0] == TensorElementDataType::Float16 && !fp16 { - panic!( - "Dtype mismatch! Expected: Float32, got: {:?}. You should use `--fp16`", - inputs.dtypes[0] - ); - } - - // dynamic shape: input_tensor_1:dim_1xdim_2x...,input_tensor_2:dim_3xdim_4x...,... - let mut opt_string = String::new(); - let mut min_string = String::new(); - let mut max_string = String::new(); - for name in inputs.names.iter() { - let s_opt = format!("{}:{}x3x{}x{},", name, batch.opt, height, width); - let s_min = format!("{}:{}x3x{}x{},", name, batch.min, height, width); - let s_max = format!("{}:{}x3x{}x{},", name, batch.max, height, width); - opt_string.push_str(s_opt.as_str()); - min_string.push_str(s_min.as_str()); - max_string.push_str(s_max.as_str()); - } - let _ = opt_string.pop(); - let _ = min_string.pop(); - let _ = max_string.pop(); - ( - OrtEP::Trt(device_id), - ExecutionProvider::TensorRT(TensorRTExecutionProviderOptions { - device_id, - fp16_enable: fp16, - timing_cache_enable: true, - profile_min_shapes: min_string, - profile_max_shapes: max_string, - profile_opt_shapes: opt_string, - ..Default::default() - }), - ) - } else { - println!("> TensorRT is not available! Try using CUDA..."); - Self::set_ep_cuda(device_id) - } - } - - pub fn fetch_from_metadata(&self, key: &str) -> Option { - // fetch value from onnx model file by key - match self.session.metadata() { - Err(_) => None, - Ok(metadata) => match metadata.custom(key) { - Err(_) => None, - Ok(value) => value, - }, - } - } - - pub fn run(&self, xs: Array, profile: bool) -> Result>> { - // ORT inference - match self.dtype() { - TensorElementDataType::Float16 => self.run_fp16(xs, profile), - TensorElementDataType::Float32 => self.run_fp32(xs, profile), - _ => todo!(), - } - } - - pub fn run_fp16(&self, xs: Array, profile: bool) -> Result>> { - // f32->f16 - let t = std::time::Instant::now(); - let xs = xs.mapv(f16::from_f32); - if profile { - println!("[ORT f32->f16]: {:?}", t.elapsed()); - } - - // h2d - let t = std::time::Instant::now(); - let xs = CowArray::from(xs); - let xs = vec![Value::from_array(self.session.allocator(), &xs)?]; - if profile { - println!("[ORT H2D]: {:?}", t.elapsed()); - } - - // run - let t = std::time::Instant::now(); - let ys = self.session.run(xs)?; - if profile { - println!("[ORT Inference]: {:?}", t.elapsed()); - } - - // d2h - Ok(ys - .iter() - .map(|x| { - // d2h - let t = std::time::Instant::now(); - let x = x.try_extract::<_>().unwrap().view().clone().into_owned(); - if profile { - println!("[ORT D2H]: {:?}", t.elapsed()); - } - - // f16->f32 - let t_ = std::time::Instant::now(); - let x = x.mapv(f16::to_f32); - if profile { - println!("[ORT f16->f32]: {:?}", t_.elapsed()); - } - x - }) - .collect::>>()) - } - - pub fn run_fp32(&self, xs: Array, profile: bool) -> Result>> { - // h2d - let t = std::time::Instant::now(); - let xs = CowArray::from(xs); - let xs = vec![Value::from_array(self.session.allocator(), &xs)?]; - if profile { - println!("[ORT H2D]: {:?}", t.elapsed()); - } - - // run - let t = std::time::Instant::now(); - let ys = self.session.run(xs)?; - if profile { - println!("[ORT Inference]: {:?}", t.elapsed()); - } - - // d2h - Ok(ys - .iter() - .map(|x| { - let t = std::time::Instant::now(); - let x = x.try_extract::<_>().unwrap().view().clone().into_owned(); - if profile { - println!("[ORT D2H]: {:?}", t.elapsed()); - } - x - }) - .collect::>>()) - } - - pub fn output_shapes(&self) -> Vec> { - let mut shapes = Vec::new(); - for o in &self.session.outputs { - let shape: Vec<_> = o - .dimensions() - .map(|x| if let Some(x) = x { x as i32 } else { -1i32 }) - .collect(); - shapes.push(shape); - } - shapes - } - - pub fn output_dtypes(&self) -> Vec { - let mut dtypes = Vec::new(); - self.session - .outputs - .iter() - .for_each(|x| dtypes.push(x.output_type)); - dtypes - } - - pub fn input_shapes(&self) -> &Vec> { - &self.inputs.shapes - } - - pub fn input_names(&self) -> &Vec { - &self.inputs.names - } - - pub fn input_dtypes(&self) -> &Vec { - &self.inputs.dtypes - } - - pub fn dtype(&self) -> TensorElementDataType { - self.input_dtypes()[0] - } - - pub fn height(&self) -> u32 { - self.inputs.sizes[0][0] - } - - pub fn width(&self) -> u32 { - self.inputs.sizes[0][1] - } - - pub fn is_height_dynamic(&self) -> bool { - self.input_shapes()[0][2] == -1 - } - - pub fn is_width_dynamic(&self) -> bool { - self.input_shapes()[0][3] == -1 - } - - pub fn batch(&self) -> u32 { - self.batch.opt - } - - pub fn is_batch_dynamic(&self) -> bool { - self.input_shapes()[0][0] == -1 - } - - pub fn ep(&self) -> &OrtEP { - &self.ep - } - - pub fn task(&self) -> YOLOTask { - self.task.clone() - } - - pub fn names(&self) -> Option> { - // class names, metadata parsing - // String format: `{0: 'person', 1: 'bicycle', 2: 'sports ball', ..., 27: "yellow_lady's_slipper"}` - match self.fetch_from_metadata("names") { - Some(names) => { - let re = Regex::new(r#"(['"])([-()\w '"]+)(['"])"#).unwrap(); - let mut names_ = vec![]; - for (_, [_, name, _]) in re.captures_iter(&names).map(|x| x.extract()) { - names_.push(name.to_string()); - } - Some(names_) - } - None => None, - } - } - - pub fn nk(&self) -> Option { - // num_keypoints, metadata parsing: String `nk` in onnx model: `[17, 3]` - match self.fetch_from_metadata("kpt_shape") { - None => None, - Some(kpt_string) => { - let re = Regex::new(r"([0-9]+), ([0-9]+)").unwrap(); - let caps = re.captures(&kpt_string).unwrap(); - Some(caps.get(1).unwrap().as_str().parse::().unwrap()) - } - } - } - - pub fn nc(&self) -> Option { - // num_classes - match self.names() { - // by names - Some(names) => Some(names.len() as u32), - None => match self.task() { - // by task calculation - YOLOTask::Classify => Some(self.output_shapes()[0][1] as u32), - YOLOTask::Detect => { - if self.output_shapes()[0][1] == -1 { - None - } else { - // cxywhclss - Some(self.output_shapes()[0][1] as u32 - 4) - } - } - YOLOTask::Pose => { - match self.nk() { - None => None, - Some(nk) => { - if self.output_shapes()[0][1] == -1 { - None - } else { - // cxywhclss3*kpt - Some(self.output_shapes()[0][1] as u32 - 4 - 3 * nk) - } - } - } - } - YOLOTask::Segment => { - if self.output_shapes()[0][1] == -1 { - None - } else { - // cxywhclssnm - Some((self.output_shapes()[0][1] - self.output_shapes()[1][1]) as u32 - 4) - } - } - }, - } - } - - pub fn nm(&self) -> Option { - // num_masks - match self.task() { - YOLOTask::Segment => Some(self.output_shapes()[1][1] as u32), - _ => None, - } - } - - pub fn na(&self) -> Option { - // num_anchors - match self.task() { - YOLOTask::Segment | YOLOTask::Detect | YOLOTask::Pose => { - if self.output_shapes()[0][2] == -1 { - None - } else { - Some(self.output_shapes()[0][2] as u32) - } - } - _ => None, - } - } - - pub fn author(&self) -> Option { - self.fetch_from_metadata("author") - } - - pub fn version(&self) -> Option { - self.fetch_from_metadata("version") - } -} diff --git a/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/yolo_result.rs b/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/yolo_result.rs deleted file mode 100644 index 2fcc6d8..0000000 --- a/ultralytics-main/examples/YOLOv8-ONNXRuntime-Rust/src/yolo_result.rs +++ /dev/null @@ -1,235 +0,0 @@ -use ndarray::{Array, Axis, IxDyn}; - -#[derive(Clone, PartialEq, Default)] -pub struct YOLOResult { - // YOLO tasks results of an image - pub probs: Option, - pub bboxes: Option>, - pub keypoints: Option>>, - pub masks: Option>>, -} - -impl std::fmt::Debug for YOLOResult { - fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { - f.debug_struct("YOLOResult") - .field( - "Probs(top5)", - &format_args!("{:?}", self.probs().map(|probs| probs.topk(5))), - ) - .field("Bboxes", &self.bboxes) - .field("Keypoints", &self.keypoints) - .field( - "Masks", - &format_args!("{:?}", self.masks().map(|masks| masks.len())), - ) - .finish() - } -} - -impl YOLOResult { - pub fn new( - probs: Option, - bboxes: Option>, - keypoints: Option>>, - masks: Option>>, - ) -> Self { - Self { - probs, - bboxes, - keypoints, - masks, - } - } - - pub fn probs(&self) -> Option<&Embedding> { - self.probs.as_ref() - } - - pub fn keypoints(&self) -> Option<&Vec>> { - self.keypoints.as_ref() - } - - pub fn masks(&self) -> Option<&Vec>> { - self.masks.as_ref() - } - - pub fn bboxes(&self) -> Option<&Vec> { - self.bboxes.as_ref() - } - - pub fn bboxes_mut(&mut self) -> Option<&mut Vec> { - self.bboxes.as_mut() - } -} - -#[derive(Debug, PartialEq, Clone, Default)] -pub struct Point2 { - // A point2d with x, y, conf - x: f32, - y: f32, - confidence: f32, -} - -impl Point2 { - pub fn new_with_conf(x: f32, y: f32, confidence: f32) -> Self { - Self { x, y, confidence } - } - - pub fn new(x: f32, y: f32) -> Self { - Self { - x, - y, - ..Default::default() - } - } - - pub fn x(&self) -> f32 { - self.x - } - - pub fn y(&self) -> f32 { - self.y - } - - pub fn confidence(&self) -> f32 { - self.confidence - } -} - -#[derive(Debug, Clone, PartialEq, Default)] -pub struct Embedding { - // An float32 n-dims tensor - data: Array, -} - -impl Embedding { - pub fn new(data: Array) -> Self { - Self { data } - } - - pub fn data(&self) -> &Array { - &self.data - } - - pub fn topk(&self, k: usize) -> Vec<(usize, f32)> { - let mut probs = self - .data - .iter() - .enumerate() - .map(|(a, b)| (a, *b)) - .collect::>(); - probs.sort_by(|a, b| b.1.partial_cmp(&a.1).unwrap()); - let mut topk = Vec::new(); - for &(id, confidence) in probs.iter().take(k) { - topk.push((id, confidence)); - } - topk - } - - pub fn norm(&self) -> Array { - let std_ = self.data.mapv(|x| x * x).sum_axis(Axis(0)).mapv(f32::sqrt); - self.data.clone() / std_ - } - - pub fn top1(&self) -> (usize, f32) { - self.topk(1)[0] - } -} - -#[derive(Debug, Clone, PartialEq, Default)] -pub struct Bbox { - // a bounding box around an object - xmin: f32, - ymin: f32, - width: f32, - height: f32, - id: usize, - confidence: f32, -} - -impl Bbox { - pub fn new_from_xywh(xmin: f32, ymin: f32, width: f32, height: f32) -> Self { - Self { - xmin, - ymin, - width, - height, - ..Default::default() - } - } - - pub fn new(xmin: f32, ymin: f32, width: f32, height: f32, id: usize, confidence: f32) -> Self { - Self { - xmin, - ymin, - width, - height, - id, - confidence, - } - } - - pub fn width(&self) -> f32 { - self.width - } - - pub fn height(&self) -> f32 { - self.height - } - - pub fn xmin(&self) -> f32 { - self.xmin - } - - pub fn ymin(&self) -> f32 { - self.ymin - } - - pub fn xmax(&self) -> f32 { - self.xmin + self.width - } - - pub fn ymax(&self) -> f32 { - self.ymin + self.height - } - - pub fn tl(&self) -> Point2 { - Point2::new(self.xmin, self.ymin) - } - - pub fn br(&self) -> Point2 { - Point2::new(self.xmax(), self.ymax()) - } - - pub fn cxcy(&self) -> Point2 { - Point2::new(self.xmin + self.width / 2., self.ymin + self.height / 2.) - } - - pub fn id(&self) -> usize { - self.id - } - - pub fn confidence(&self) -> f32 { - self.confidence - } - - pub fn area(&self) -> f32 { - self.width * self.height - } - - pub fn intersection_area(&self, another: &Bbox) -> f32 { - let l = self.xmin.max(another.xmin); - let r = (self.xmin + self.width).min(another.xmin + another.width); - let t = self.ymin.max(another.ymin); - let b = (self.ymin + self.height).min(another.ymin + another.height); - (r - l + 1.).max(0.) * (b - t + 1.).max(0.) - } - - pub fn union(&self, another: &Bbox) -> f32 { - self.area() + another.area() - self.intersection_area(another) - } - - pub fn iou(&self, another: &Bbox) -> f32 { - self.intersection_area(another) / self.union(another) - } -} diff --git a/ultralytics-main/examples/YOLOv8-ONNXRuntime/README.md b/ultralytics-main/examples/YOLOv8-ONNXRuntime/README.md deleted file mode 100644 index b206b2e..0000000 --- a/ultralytics-main/examples/YOLOv8-ONNXRuntime/README.md +++ /dev/null @@ -1,43 +0,0 @@ -# YOLOv8 - ONNX Runtime - -This project implements YOLOv8 using ONNX Runtime. - -## Installation - -To run this project, you need to install the required dependencies. The following instructions will guide you through the installation process. - -### Installing Required Dependencies - -You can install the required dependencies by running the following command: - -```bash -pip install -r requirements.txt -``` - -### Installing `onnxruntime-gpu` - -If you have an NVIDIA GPU and want to leverage GPU acceleration, you can install the onnxruntime-gpu package using the following command: - -```bash -pip install onnxruntime-gpu -``` - -Note: Make sure you have the appropriate GPU drivers installed on your system. - -### Installing `onnxruntime` (CPU version) - -If you don't have an NVIDIA GPU or prefer to use the CPU version of onnxruntime, you can install the onnxruntime package using the following command: - -```bash -pip install onnxruntime -``` - -### Usage - -After successfully installing the required packages, you can run the YOLOv8 implementation using the following command: - -```bash -python main.py --model yolov8n.onnx --img image.jpg --conf-thres 0.5 --iou-thres 0.5 -``` - -Make sure to replace yolov8n.onnx with the path to your YOLOv8 ONNX model file, image.jpg with the path to your input image, and adjust the confidence threshold (conf-thres) and IoU threshold (iou-thres) values as needed. diff --git a/ultralytics-main/examples/YOLOv8-ONNXRuntime/main.py b/ultralytics-main/examples/YOLOv8-ONNXRuntime/main.py deleted file mode 100644 index e1e83f3..0000000 --- a/ultralytics-main/examples/YOLOv8-ONNXRuntime/main.py +++ /dev/null @@ -1,231 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import argparse - -import cv2 -import numpy as np -import onnxruntime as ort -import torch - -from ultralytics.utils import ASSETS, yaml_load -from ultralytics.utils.checks import check_requirements, check_yaml - - -class YOLOv8: - """YOLOv8 object detection model class for handling inference and visualization.""" - - def __init__(self, onnx_model, input_image, confidence_thres, iou_thres): - """ - Initializes an instance of the YOLOv8 class. - - Args: - onnx_model: Path to the ONNX model. - input_image: Path to the input image. - confidence_thres: Confidence threshold for filtering detections. - iou_thres: IoU (Intersection over Union) threshold for non-maximum suppression. - """ - self.onnx_model = onnx_model - self.input_image = input_image - self.confidence_thres = confidence_thres - self.iou_thres = iou_thres - - # Load the class names from the COCO dataset - self.classes = yaml_load(check_yaml("coco128.yaml"))["names"] - - # Generate a color palette for the classes - self.color_palette = np.random.uniform(0, 255, size=(len(self.classes), 3)) - - def draw_detections(self, img, box, score, class_id): - """ - Draws bounding boxes and labels on the input image based on the detected objects. - - Args: - img: The input image to draw detections on. - box: Detected bounding box. - score: Corresponding detection score. - class_id: Class ID for the detected object. - - Returns: - None - """ - - # Extract the coordinates of the bounding box - x1, y1, w, h = box - - # Retrieve the color for the class ID - color = self.color_palette[class_id] - - # Draw the bounding box on the image - cv2.rectangle(img, (int(x1), int(y1)), (int(x1 + w), int(y1 + h)), color, 2) - - # Create the label text with class name and score - label = f"{self.classes[class_id]}: {score:.2f}" - - # Calculate the dimensions of the label text - (label_width, label_height), _ = cv2.getTextSize(label, cv2.FONT_HERSHEY_SIMPLEX, 0.5, 1) - - # Calculate the position of the label text - label_x = x1 - label_y = y1 - 10 if y1 - 10 > label_height else y1 + 10 - - # Draw a filled rectangle as the background for the label text - cv2.rectangle( - img, (label_x, label_y - label_height), (label_x + label_width, label_y + label_height), color, cv2.FILLED - ) - - # Draw the label text on the image - cv2.putText(img, label, (label_x, label_y), cv2.FONT_HERSHEY_SIMPLEX, 0.5, (0, 0, 0), 1, cv2.LINE_AA) - - def preprocess(self): - """ - Preprocesses the input image before performing inference. - - Returns: - image_data: Preprocessed image data ready for inference. - """ - # Read the input image using OpenCV - self.img = cv2.imread(self.input_image) - - # Get the height and width of the input image - self.img_height, self.img_width = self.img.shape[:2] - - # Convert the image color space from BGR to RGB - img = cv2.cvtColor(self.img, cv2.COLOR_BGR2RGB) - - # Resize the image to match the input shape - img = cv2.resize(img, (self.input_width, self.input_height)) - - # Normalize the image data by dividing it by 255.0 - image_data = np.array(img) / 255.0 - - # Transpose the image to have the channel dimension as the first dimension - image_data = np.transpose(image_data, (2, 0, 1)) # Channel first - - # Expand the dimensions of the image data to match the expected input shape - image_data = np.expand_dims(image_data, axis=0).astype(np.float32) - - # Return the preprocessed image data - return image_data - - def postprocess(self, input_image, output): - """ - Performs post-processing on the model's output to extract bounding boxes, scores, and class IDs. - - Args: - input_image (numpy.ndarray): The input image. - output (numpy.ndarray): The output of the model. - - Returns: - numpy.ndarray: The input image with detections drawn on it. - """ - - # Transpose and squeeze the output to match the expected shape - outputs = np.transpose(np.squeeze(output[0])) - - # Get the number of rows in the outputs array - rows = outputs.shape[0] - - # Lists to store the bounding boxes, scores, and class IDs of the detections - boxes = [] - scores = [] - class_ids = [] - - # Calculate the scaling factors for the bounding box coordinates - x_factor = self.img_width / self.input_width - y_factor = self.img_height / self.input_height - - # Iterate over each row in the outputs array - for i in range(rows): - # Extract the class scores from the current row - classes_scores = outputs[i][4:] - - # Find the maximum score among the class scores - max_score = np.amax(classes_scores) - - # If the maximum score is above the confidence threshold - if max_score >= self.confidence_thres: - # Get the class ID with the highest score - class_id = np.argmax(classes_scores) - - # Extract the bounding box coordinates from the current row - x, y, w, h = outputs[i][0], outputs[i][1], outputs[i][2], outputs[i][3] - - # Calculate the scaled coordinates of the bounding box - left = int((x - w / 2) * x_factor) - top = int((y - h / 2) * y_factor) - width = int(w * x_factor) - height = int(h * y_factor) - - # Add the class ID, score, and box coordinates to the respective lists - class_ids.append(class_id) - scores.append(max_score) - boxes.append([left, top, width, height]) - - # Apply non-maximum suppression to filter out overlapping bounding boxes - indices = cv2.dnn.NMSBoxes(boxes, scores, self.confidence_thres, self.iou_thres) - - # Iterate over the selected indices after non-maximum suppression - for i in indices: - # Get the box, score, and class ID corresponding to the index - box = boxes[i] - score = scores[i] - class_id = class_ids[i] - - # Draw the detection on the input image - self.draw_detections(input_image, box, score, class_id) - - # Return the modified input image - return input_image - - def main(self): - """ - Performs inference using an ONNX model and returns the output image with drawn detections. - - Returns: - output_img: The output image with drawn detections. - """ - # Create an inference session using the ONNX model and specify execution providers - session = ort.InferenceSession(self.onnx_model, providers=["CUDAExecutionProvider", "CPUExecutionProvider"]) - - # Get the model inputs - model_inputs = session.get_inputs() - - # Store the shape of the input for later use - input_shape = model_inputs[0].shape - self.input_width = input_shape[2] - self.input_height = input_shape[3] - - # Preprocess the image data - img_data = self.preprocess() - - # Run inference using the preprocessed image data - outputs = session.run(None, {model_inputs[0].name: img_data}) - - # Perform post-processing on the outputs to obtain output image. - return self.postprocess(self.img, outputs) # output image - - -if __name__ == "__main__": - # Create an argument parser to handle command-line arguments - parser = argparse.ArgumentParser() - parser.add_argument("--model", type=str, default="yolov8n.onnx", help="Input your ONNX model.") - parser.add_argument("--img", type=str, default=str(ASSETS / "bus.jpg"), help="Path to input image.") - parser.add_argument("--conf-thres", type=float, default=0.5, help="Confidence threshold") - parser.add_argument("--iou-thres", type=float, default=0.5, help="NMS IoU threshold") - args = parser.parse_args() - - # Check the requirements and select the appropriate backend (CPU or GPU) - check_requirements("onnxruntime-gpu" if torch.cuda.is_available() else "onnxruntime") - - # Create an instance of the YOLOv8 class with the specified arguments - detection = YOLOv8(args.model, args.img, args.conf_thres, args.iou_thres) - - # Perform object detection and obtain the output image - output_image = detection.main() - - # Display the output image in a window - cv2.namedWindow("Output", cv2.WINDOW_NORMAL) - cv2.imshow("Output", output_image) - - # Wait for a key press to exit - cv2.waitKey(0) diff --git a/ultralytics-main/examples/YOLOv8-OpenCV-ONNX-Python/README.md b/ultralytics-main/examples/YOLOv8-OpenCV-ONNX-Python/README.md deleted file mode 100644 index c9076fa..0000000 --- a/ultralytics-main/examples/YOLOv8-OpenCV-ONNX-Python/README.md +++ /dev/null @@ -1,19 +0,0 @@ -# YOLOv8 - OpenCV - -Implementation YOLOv8 on OpenCV using ONNX Format. - -Just simply clone and run - -```bash -pip install -r requirements.txt -python main.py --model yolov8n.onnx --img image.jpg -``` - -If you start from scratch: - -```bash -pip install ultralytics -yolo export model=yolov8n.pt imgsz=640 format=onnx opset=12 -``` - -_\*Make sure to include "opset=12"_ diff --git a/ultralytics-main/examples/YOLOv8-OpenCV-ONNX-Python/main.py b/ultralytics-main/examples/YOLOv8-OpenCV-ONNX-Python/main.py deleted file mode 100644 index 8d9c7a5..0000000 --- a/ultralytics-main/examples/YOLOv8-OpenCV-ONNX-Python/main.py +++ /dev/null @@ -1,130 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import argparse - -import cv2.dnn -import numpy as np - -from ultralytics.utils import ASSETS, yaml_load -from ultralytics.utils.checks import check_yaml - -CLASSES = yaml_load(check_yaml("coco128.yaml"))["names"] -colors = np.random.uniform(0, 255, size=(len(CLASSES), 3)) - - -def draw_bounding_box(img, class_id, confidence, x, y, x_plus_w, y_plus_h): - """ - Draws bounding boxes on the input image based on the provided arguments. - - Args: - img (numpy.ndarray): The input image to draw the bounding box on. - class_id (int): Class ID of the detected object. - confidence (float): Confidence score of the detected object. - x (int): X-coordinate of the top-left corner of the bounding box. - y (int): Y-coordinate of the top-left corner of the bounding box. - x_plus_w (int): X-coordinate of the bottom-right corner of the bounding box. - y_plus_h (int): Y-coordinate of the bottom-right corner of the bounding box. - """ - label = f"{CLASSES[class_id]} ({confidence:.2f})" - color = colors[class_id] - cv2.rectangle(img, (x, y), (x_plus_w, y_plus_h), color, 2) - cv2.putText(img, label, (x - 10, y - 10), cv2.FONT_HERSHEY_SIMPLEX, 0.5, color, 2) - - -def main(onnx_model, input_image): - """ - Main function to load ONNX model, perform inference, draw bounding boxes, and display the output image. - - Args: - onnx_model (str): Path to the ONNX model. - input_image (str): Path to the input image. - - Returns: - list: List of dictionaries containing detection information such as class_id, class_name, confidence, etc. - """ - # Load the ONNX model - model: cv2.dnn.Net = cv2.dnn.readNetFromONNX(onnx_model) - - # Read the input image - original_image: np.ndarray = cv2.imread(input_image) - [height, width, _] = original_image.shape - - # Prepare a square image for inference - length = max((height, width)) - image = np.zeros((length, length, 3), np.uint8) - image[0:height, 0:width] = original_image - - # Calculate scale factor - scale = length / 640 - - # Preprocess the image and prepare blob for model - blob = cv2.dnn.blobFromImage(image, scalefactor=1 / 255, size=(640, 640), swapRB=True) - model.setInput(blob) - - # Perform inference - outputs = model.forward() - - # Prepare output array - outputs = np.array([cv2.transpose(outputs[0])]) - rows = outputs.shape[1] - - boxes = [] - scores = [] - class_ids = [] - - # Iterate through output to collect bounding boxes, confidence scores, and class IDs - for i in range(rows): - classes_scores = outputs[0][i][4:] - (minScore, maxScore, minClassLoc, (x, maxClassIndex)) = cv2.minMaxLoc(classes_scores) - if maxScore >= 0.25: - box = [ - outputs[0][i][0] - (0.5 * outputs[0][i][2]), - outputs[0][i][1] - (0.5 * outputs[0][i][3]), - outputs[0][i][2], - outputs[0][i][3], - ] - boxes.append(box) - scores.append(maxScore) - class_ids.append(maxClassIndex) - - # Apply NMS (Non-maximum suppression) - result_boxes = cv2.dnn.NMSBoxes(boxes, scores, 0.25, 0.45, 0.5) - - detections = [] - - # Iterate through NMS results to draw bounding boxes and labels - for i in range(len(result_boxes)): - index = result_boxes[i] - box = boxes[index] - detection = { - "class_id": class_ids[index], - "class_name": CLASSES[class_ids[index]], - "confidence": scores[index], - "box": box, - "scale": scale, - } - detections.append(detection) - draw_bounding_box( - original_image, - class_ids[index], - scores[index], - round(box[0] * scale), - round(box[1] * scale), - round((box[0] + box[2]) * scale), - round((box[1] + box[3]) * scale), - ) - - # Display the image with bounding boxes - cv2.imshow("image", original_image) - cv2.waitKey(0) - cv2.destroyAllWindows() - - return detections - - -if __name__ == "__main__": - parser = argparse.ArgumentParser() - parser.add_argument("--model", default="yolov8n.onnx", help="Input your ONNX model.") - parser.add_argument("--img", default=str(ASSETS / "bus.jpg"), help="Path to input image.") - args = parser.parse_args() - main(args.model, args.img) diff --git a/ultralytics-main/examples/YOLOv8-OpenCV-int8-tflite-Python/README.md b/ultralytics-main/examples/YOLOv8-OpenCV-int8-tflite-Python/README.md deleted file mode 100644 index ea14e44..0000000 --- a/ultralytics-main/examples/YOLOv8-OpenCV-int8-tflite-Python/README.md +++ /dev/null @@ -1,65 +0,0 @@ -# YOLOv8 - Int8-TFLite Runtime - -Welcome to the YOLOv8 Int8 TFLite Runtime for efficient and optimized object detection project. This README provides comprehensive instructions for installing and using our YOLOv8 implementation. - -## Installation - -Ensure a smooth setup by following these steps to install necessary dependencies. - -### Installing Required Dependencies - -Install all required dependencies with this simple command: - -```bash -pip install -r requirements.txt -``` - -### Installing `tflite-runtime` - -To load TFLite models, install the `tflite-runtime` package using: - -```bash -pip install tflite-runtime -``` - -### Installing `tensorflow-gpu` (For NVIDIA GPU Users) - -Leverage GPU acceleration with NVIDIA GPUs by installing `tensorflow-gpu`: - -```bash -pip install tensorflow-gpu -``` - -**Note:** Ensure you have compatible GPU drivers installed on your system. - -### Installing `tensorflow` (CPU Version) - -For CPU usage or non-NVIDIA GPUs, install TensorFlow with: - -```bash -pip install tensorflow -``` - -## Usage - -Follow these instructions to run YOLOv8 after successful installation. - -Convert the YOLOv8 model to Int8 TFLite format: - -```bash -yolo export model=yolov8n.pt imgsz=640 format=tflite int8 -``` - -Locate the Int8 TFLite model in `yolov8n_saved_model`. Choose `best_full_integer_quant` or verify quantization at [Netron](https://netron.app/). Then, execute the following in your terminal: - -```bash -python main.py --model yolov8n_full_integer_quant.tflite --img image.jpg --conf-thres 0.5 --iou-thres 0.5 -``` - -Replace `best_full_integer_quant.tflite` with your model file's path, `image.jpg` with your input image, and adjust the confidence (conf-thres) and IoU thresholds (iou-thres) as necessary. - -### Output - -The output is displayed as annotated images, showcasing the model's detection capabilities: - -![image](https://github.com/wamiqraza/Attribute-recognition-and-reidentification-Market1501-dataset/blob/main/img/bus.jpg) diff --git a/ultralytics-main/examples/YOLOv8-OpenCV-int8-tflite-Python/main.py b/ultralytics-main/examples/YOLOv8-OpenCV-int8-tflite-Python/main.py deleted file mode 100644 index 53fba1f..0000000 --- a/ultralytics-main/examples/YOLOv8-OpenCV-int8-tflite-Python/main.py +++ /dev/null @@ -1,299 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import argparse - -import cv2 -import numpy as np -from tflite_runtime import interpreter as tflite - -from ultralytics.utils import ASSETS, yaml_load -from ultralytics.utils.checks import check_yaml - -# Declare as global variables, can be updated based trained model image size -img_width = 640 -img_height = 640 - - -class LetterBox: - def __init__( - self, new_shape=(img_width, img_height), auto=False, scaleFill=False, scaleup=True, center=True, stride=32 - ): - self.new_shape = new_shape - self.auto = auto - self.scaleFill = scaleFill - self.scaleup = scaleup - self.stride = stride - self.center = center # Put the image in the middle or top-left - - def __call__(self, labels=None, image=None): - """Return updated labels and image with added border.""" - - if labels is None: - labels = {} - img = labels.get("img") if image is None else image - shape = img.shape[:2] # current shape [height, width] - new_shape = labels.pop("rect_shape", self.new_shape) - if isinstance(new_shape, int): - new_shape = (new_shape, new_shape) - - # Scale ratio (new / old) - r = min(new_shape[0] / shape[0], new_shape[1] / shape[1]) - if not self.scaleup: # only scale down, do not scale up (for better val mAP) - r = min(r, 1.0) - - # Compute padding - ratio = r, r # width, height ratios - new_unpad = int(round(shape[1] * r)), int(round(shape[0] * r)) - dw, dh = new_shape[1] - new_unpad[0], new_shape[0] - new_unpad[1] # wh padding - if self.auto: # minimum rectangle - dw, dh = np.mod(dw, self.stride), np.mod(dh, self.stride) # wh padding - elif self.scaleFill: # stretch - dw, dh = 0.0, 0.0 - new_unpad = (new_shape[1], new_shape[0]) - ratio = new_shape[1] / shape[1], new_shape[0] / shape[0] # width, height ratios - - if self.center: - dw /= 2 # divide padding into 2 sides - dh /= 2 - - if shape[::-1] != new_unpad: # resize - img = cv2.resize(img, new_unpad, interpolation=cv2.INTER_LINEAR) - top, bottom = int(round(dh - 0.1)) if self.center else 0, int(round(dh + 0.1)) - left, right = int(round(dw - 0.1)) if self.center else 0, int(round(dw + 0.1)) - img = cv2.copyMakeBorder( - img, top, bottom, left, right, cv2.BORDER_CONSTANT, value=(114, 114, 114) - ) # add border - if labels.get("ratio_pad"): - labels["ratio_pad"] = (labels["ratio_pad"], (left, top)) # for evaluation - - if len(labels): - labels = self._update_labels(labels, ratio, dw, dh) - labels["img"] = img - labels["resized_shape"] = new_shape - return labels - else: - return img - - def _update_labels(self, labels, ratio, padw, padh): - """Update labels.""" - - labels["instances"].convert_bbox(format="xyxy") - labels["instances"].denormalize(*labels["img"].shape[:2][::-1]) - labels["instances"].scale(*ratio) - labels["instances"].add_padding(padw, padh) - return labels - - -class Yolov8TFLite: - def __init__(self, tflite_model, input_image, confidence_thres, iou_thres): - """ - Initializes an instance of the Yolov8TFLite class. - - Args: - tflite_model: Path to the TFLite model. - input_image: Path to the input image. - confidence_thres: Confidence threshold for filtering detections. - iou_thres: IoU (Intersection over Union) threshold for non-maximum suppression. - """ - - self.tflite_model = tflite_model - self.input_image = input_image - self.confidence_thres = confidence_thres - self.iou_thres = iou_thres - - # Load the class names from the COCO dataset - self.classes = yaml_load(check_yaml("coco128.yaml"))["names"] - - # Generate a color palette for the classes - self.color_palette = np.random.uniform(0, 255, size=(len(self.classes), 3)) - - def draw_detections(self, img, box, score, class_id): - """ - Draws bounding boxes and labels on the input image based on the detected objects. - - Args: - img: The input image to draw detections on. - box: Detected bounding box. - score: Corresponding detection score. - class_id: Class ID for the detected object. - - Returns: - None - """ - - # Extract the coordinates of the bounding box - x1, y1, w, h = box - - # Retrieve the color for the class ID - color = self.color_palette[class_id] - - # Draw the bounding box on the image - cv2.rectangle(img, (int(x1), int(y1)), (int(x1 + w), int(y1 + h)), color, 2) - - # Create the label text with class name and score - label = f"{self.classes[class_id]}: {score:.2f}" - - # Calculate the dimensions of the label text - (label_width, label_height), _ = cv2.getTextSize(label, cv2.FONT_HERSHEY_SIMPLEX, 0.5, 1) - - # Calculate the position of the label text - label_x = x1 - label_y = y1 - 10 if y1 - 10 > label_height else y1 + 10 - - # Draw a filled rectangle as the background for the label text - cv2.rectangle( - img, - (int(label_x), int(label_y - label_height)), - (int(label_x + label_width), int(label_y + label_height)), - color, - cv2.FILLED, - ) - - # Draw the label text on the image - cv2.putText(img, label, (int(label_x), int(label_y)), cv2.FONT_HERSHEY_SIMPLEX, 0.5, (0, 0, 0), 1, cv2.LINE_AA) - - def preprocess(self): - """ - Preprocesses the input image before performing inference. - - Returns: - image_data: Preprocessed image data ready for inference. - """ - - # Read the input image using OpenCV - self.img = cv2.imread(self.input_image) - - print("image before", self.img) - # Get the height and width of the input image - self.img_height, self.img_width = self.img.shape[:2] - - letterbox = LetterBox(new_shape=[img_width, img_height], auto=False, stride=32) - image = letterbox(image=self.img) - image = [image] - image = np.stack(image) - image = image[..., ::-1].transpose((0, 3, 1, 2)) - img = np.ascontiguousarray(image) - # n, h, w, c - image = img.astype(np.float32) - return image / 255 - - def postprocess(self, input_image, output): - """ - Performs post-processing on the model's output to extract bounding boxes, scores, and class IDs. - - Args: - input_image (numpy.ndarray): The input image. - output (numpy.ndarray): The output of the model. - - Returns: - numpy.ndarray: The input image with detections drawn on it. - """ - - boxes = [] - scores = [] - class_ids = [] - for pred in output: - pred = np.transpose(pred) - for box in pred: - x, y, w, h = box[:4] - x1 = x - w / 2 - y1 = y - h / 2 - boxes.append([x1, y1, w, h]) - idx = np.argmax(box[4:]) - scores.append(box[idx + 4]) - class_ids.append(idx) - - indices = cv2.dnn.NMSBoxes(boxes, scores, self.confidence_thres, self.iou_thres) - - for i in indices: - # Get the box, score, and class ID corresponding to the index - box = boxes[i] - gain = min(img_width / self.img_width, img_height / self.img_height) - pad = ( - round((img_width - self.img_width * gain) / 2 - 0.1), - round((img_height - self.img_height * gain) / 2 - 0.1), - ) - box[0] = (box[0] - pad[0]) / gain - box[1] = (box[1] - pad[1]) / gain - box[2] = box[2] / gain - box[3] = box[3] / gain - score = scores[i] - class_id = class_ids[i] - if score > 0.25: - print(box, score, class_id) - # Draw the detection on the input image - self.draw_detections(input_image, box, score, class_id) - - return input_image - - def main(self): - """ - Performs inference using a TFLite model and returns the output image with drawn detections. - - Returns: - output_img: The output image with drawn detections. - """ - - # Create an interpreter for the TFLite model - interpreter = tflite.Interpreter(model_path=self.tflite_model) - self.model = interpreter - interpreter.allocate_tensors() - - # Get the model inputs - input_details = interpreter.get_input_details() - output_details = interpreter.get_output_details() - - # Store the shape of the input for later use - input_shape = input_details[0]["shape"] - self.input_width = input_shape[1] - self.input_height = input_shape[2] - - # Preprocess the image data - img_data = self.preprocess() - img_data = img_data - # img_data = img_data.cpu().numpy() - # Set the input tensor to the interpreter - print(input_details[0]["index"]) - print(img_data.shape) - img_data = img_data.transpose((0, 2, 3, 1)) - - scale, zero_point = input_details[0]["quantization"] - interpreter.set_tensor(input_details[0]["index"], img_data) - - # Run inference - interpreter.invoke() - - # Get the output tensor from the interpreter - output = interpreter.get_tensor(output_details[0]["index"]) - scale, zero_point = output_details[0]["quantization"] - output = (output.astype(np.float32) - zero_point) * scale - - output[:, [0, 2]] *= img_width - output[:, [1, 3]] *= img_height - print(output) - # Perform post-processing on the outputs to obtain output image. - return self.postprocess(self.img, output) - - -if __name__ == "__main__": - # Create an argument parser to handle command-line arguments - parser = argparse.ArgumentParser() - parser.add_argument( - "--model", type=str, default="yolov8n_full_integer_quant.tflite", help="Input your TFLite model." - ) - parser.add_argument("--img", type=str, default=str(ASSETS / "bus.jpg"), help="Path to input image.") - parser.add_argument("--conf-thres", type=float, default=0.5, help="Confidence threshold") - parser.add_argument("--iou-thres", type=float, default=0.5, help="NMS IoU threshold") - args = parser.parse_args() - - # Create an instance of the Yolov8TFLite class with the specified arguments - detection = Yolov8TFLite(args.model, args.img, args.conf_thres, args.iou_thres) - - # Perform object detection and obtain the output image - output_image = detection.main() - - # Display the output image in a window - cv2.imshow("Output", output_image) - - # Wait for a key press to exit - cv2.waitKey(0) diff --git a/ultralytics-main/examples/YOLOv8-Region-Counter/readme.md b/ultralytics-main/examples/YOLOv8-Region-Counter/readme.md deleted file mode 100644 index 2acf0a5..0000000 --- a/ultralytics-main/examples/YOLOv8-Region-Counter/readme.md +++ /dev/null @@ -1,123 +0,0 @@ -# Regions Counting Using YOLOv8 (Inference on Video) - -- Region counting is a method employed to tally the objects within a specified area, allowing for more sophisticated analyses when multiple regions are considered. These regions can be adjusted interactively using a Left Mouse Click, and the counting process occurs in real time. -- Regions can be adjusted to suit the user's preferences and requirements. - -
-

- YOLOv8 region counting visual 1 - YOLOv8 region counting visual 2 -

-
- -## Table of Contents - -- [Step 1: Install the Required Libraries](#step-1-install-the-required-libraries) -- [Step 2: Run the Region Counting Using Ultralytics YOLOv8](#step-2-run-the-region-counting-using-ultralytics-yolov8) -- [Usage Options](#usage-options) -- [FAQ](#faq) - -## Step 1: Install the Required Libraries - -Clone the repository, install dependencies and `cd` to this local directory for commands in Step 2. - -```bash -# Clone ultralytics repo -git clone https://github.com/ultralytics/ultralytics - -# cd to local directory -cd ultralytics/examples/YOLOv8-Region-Counter -``` - -## Step 2: Run the Region Counting Using Ultralytics YOLOv8 - -Here are the basic commands for running the inference: - -### Note - -After the video begins playing, you can freely move the region anywhere within the video by simply clicking and dragging using the left mouse button. - -```bash -# If you want to save results -python yolov8_region_counter.py --source "path/to/video.mp4" --save-img --view-img - -# If you want to run model on CPU -python yolov8_region_counter.py --source "path/to/video.mp4" --save-img --view-img --device cpu - -# If you want to change model file -python yolov8_region_counter.py --source "path/to/video.mp4" --save-img --weights "path/to/model.pt" - -# If you want to detect specific class (first class and third class) -python yolov8_region_counter.py --source "path/to/video.mp4" --classes 0 2 --weights "path/to/model.pt" - -# If you dont want to save results -python yolov8_region_counter.py --source "path/to/video.mp4" --view-img -``` - -## Usage Options - -- `--source`: Specifies the path to the video file you want to run inference on. -- `--device`: Specifies the device `cpu` or `0` -- `--save-img`: Flag to save the detection results as images. -- `--weights`: Specifies a different YOLOv8 model file (e.g., `yolov8n.pt`, `yolov8s.pt`, `yolov8m.pt`, `yolov8l.pt`, `yolov8x.pt`). -- `--classes`: Specifies the class to be detected -- `--line-thickness`: Specifies the bounding box thickness -- `--region-thickness`: Specifies the region boxes thickness -- `--track-thickness`: Specifies the track line thickness - -## FAQ - -**1. What Does Region Counting Involve?** - -Region counting is a computational method utilized to ascertain the quantity of objects within a specific area in recorded video or real-time streams. This technique finds frequent application in image processing, computer vision, and pattern recognition, facilitating the analysis and segmentation of objects or features based on their spatial relationships. - -**2. Is Friendly Region Plotting Supported by the Region Counter?** - -The Region Counter offers the capability to create regions in various formats, such as polygons and rectangles. You have the flexibility to modify region attributes, including coordinates, colors, and other details, as demonstrated in the following code: - -```python -from shapely.geometry import Polygon - -counting_regions = [ - { - "name": "YOLOv8 Polygon Region", - "polygon": Polygon( - [(50, 80), (250, 20), (450, 80), (400, 350), (100, 350)] - ), # Polygon with five points (Pentagon) - "counts": 0, - "dragging": False, - "region_color": (255, 42, 4), # BGR Value - "text_color": (255, 255, 255), # Region Text Color - }, - { - "name": "YOLOv8 Rectangle Region", - "polygon": Polygon( - [(200, 250), (440, 250), (440, 550), (200, 550)] - ), # Rectangle with four points - "counts": 0, - "dragging": False, - "region_color": (37, 255, 225), # BGR Value - "text_color": (0, 0, 0), # Region Text Color - }, -] -``` - -**3. Why Combine Region Counting with YOLOv8?** - -YOLOv8 specializes in the detection and tracking of objects in video streams. Region counting complements this by enabling object counting within designated areas, making it a valuable application of YOLOv8. - -**4. How Can I Troubleshoot Issues?** - -To gain more insights during inference, you can include the `--debug` flag in your command: - -```bash -python yolov8_region_counter.py --source "path to video file" --debug -``` - -**5. Can I Employ Other YOLO Versions?** - -Certainly, you have the flexibility to specify different YOLO model weights using the `--weights` option. - -**6. Where Can I Access Additional Information?** - -For a comprehensive guide on using YOLOv8 with Object Tracking, please refer to [Multi-Object Tracking with Ultralytics YOLO](https://docs.ultralytics.com/modes/track/). diff --git a/ultralytics-main/examples/YOLOv8-Region-Counter/yolov8_region_counter.py b/ultralytics-main/examples/YOLOv8-Region-Counter/yolov8_region_counter.py deleted file mode 100644 index b7e9c3b..0000000 --- a/ultralytics-main/examples/YOLOv8-Region-Counter/yolov8_region_counter.py +++ /dev/null @@ -1,251 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import argparse -from collections import defaultdict -from pathlib import Path - -import cv2 -import numpy as np -from shapely.geometry import Polygon -from shapely.geometry.point import Point - -from ultralytics import YOLO -from ultralytics.utils.files import increment_path -from ultralytics.utils.plotting import Annotator, colors - -track_history = defaultdict(list) - -current_region = None -counting_regions = [ - { - "name": "YOLOv8 Polygon Region", - "polygon": Polygon([(50, 80), (250, 20), (450, 80), (400, 350), (100, 350)]), # Polygon points - "counts": 0, - "dragging": False, - "region_color": (255, 42, 4), # BGR Value - "text_color": (255, 255, 255), # Region Text Color - }, - { - "name": "YOLOv8 Rectangle Region", - "polygon": Polygon([(200, 250), (440, 250), (440, 550), (200, 550)]), # Polygon points - "counts": 0, - "dragging": False, - "region_color": (37, 255, 225), # BGR Value - "text_color": (0, 0, 0), # Region Text Color - }, -] - - -def mouse_callback(event, x, y, flags, param): - """ - Handles mouse events for region manipulation. - - Parameters: - event (int): The mouse event type (e.g., cv2.EVENT_LBUTTONDOWN). - x (int): The x-coordinate of the mouse pointer. - y (int): The y-coordinate of the mouse pointer. - flags (int): Additional flags passed by OpenCV. - param: Additional parameters passed to the callback (not used in this function). - - Global Variables: - current_region (dict): A dictionary representing the current selected region. - - Mouse Events: - - LBUTTONDOWN: Initiates dragging for the region containing the clicked point. - - MOUSEMOVE: Moves the selected region if dragging is active. - - LBUTTONUP: Ends dragging for the selected region. - - Notes: - - This function is intended to be used as a callback for OpenCV mouse events. - - Requires the existence of the 'counting_regions' list and the 'Polygon' class. - - Example: - >>> cv2.setMouseCallback(window_name, mouse_callback) - """ - global current_region - - # Mouse left button down event - if event == cv2.EVENT_LBUTTONDOWN: - for region in counting_regions: - if region["polygon"].contains(Point((x, y))): - current_region = region - current_region["dragging"] = True - current_region["offset_x"] = x - current_region["offset_y"] = y - - # Mouse move event - elif event == cv2.EVENT_MOUSEMOVE: - if current_region is not None and current_region["dragging"]: - dx = x - current_region["offset_x"] - dy = y - current_region["offset_y"] - current_region["polygon"] = Polygon( - [(p[0] + dx, p[1] + dy) for p in current_region["polygon"].exterior.coords] - ) - current_region["offset_x"] = x - current_region["offset_y"] = y - - # Mouse left button up event - elif event == cv2.EVENT_LBUTTONUP: - if current_region is not None and current_region["dragging"]: - current_region["dragging"] = False - - -def run( - weights="yolov8n.pt", - source=None, - device="cpu", - view_img=False, - save_img=False, - exist_ok=False, - classes=None, - line_thickness=2, - track_thickness=2, - region_thickness=2, -): - """ - Run Region counting on a video using YOLOv8 and ByteTrack. - - Supports movable region for real time counting inside specific area. - Supports multiple regions counting. - Regions can be Polygons or rectangle in shape - - Args: - weights (str): Model weights path. - source (str): Video file path. - device (str): processing device cpu, 0, 1 - view_img (bool): Show results. - save_img (bool): Save results. - exist_ok (bool): Overwrite existing files. - classes (list): classes to detect and track - line_thickness (int): Bounding box thickness. - track_thickness (int): Tracking line thickness - region_thickness (int): Region thickness. - """ - vid_frame_count = 0 - - # Check source path - if not Path(source).exists(): - raise FileNotFoundError(f"Source path '{source}' does not exist.") - - # Setup Model - model = YOLO(f"{weights}") - model.to("cuda") if device == "0" else model.to("cpu") - - # Extract classes names - names = model.model.names - - # Video setup - videocapture = cv2.VideoCapture(source) - frame_width, frame_height = int(videocapture.get(3)), int(videocapture.get(4)) - fps, fourcc = int(videocapture.get(5)), cv2.VideoWriter_fourcc(*"mp4v") - - # Output setup - save_dir = increment_path(Path("ultralytics_rc_output") / "exp", exist_ok) - save_dir.mkdir(parents=True, exist_ok=True) - video_writer = cv2.VideoWriter(str(save_dir / f"{Path(source).stem}.mp4"), fourcc, fps, (frame_width, frame_height)) - - # Iterate over video frames - while videocapture.isOpened(): - success, frame = videocapture.read() - if not success: - break - vid_frame_count += 1 - - # Extract the results - results = model.track(frame, persist=True, classes=classes) - - if results[0].boxes.id is not None: - boxes = results[0].boxes.xyxy.cpu() - track_ids = results[0].boxes.id.int().cpu().tolist() - clss = results[0].boxes.cls.cpu().tolist() - - annotator = Annotator(frame, line_width=line_thickness, example=str(names)) - - for box, track_id, cls in zip(boxes, track_ids, clss): - annotator.box_label(box, str(names[cls]), color=colors(cls, True)) - bbox_center = (box[0] + box[2]) / 2, (box[1] + box[3]) / 2 # Bbox center - - track = track_history[track_id] # Tracking Lines plot - track.append((float(bbox_center[0]), float(bbox_center[1]))) - if len(track) > 30: - track.pop(0) - points = np.hstack(track).astype(np.int32).reshape((-1, 1, 2)) - cv2.polylines(frame, [points], isClosed=False, color=colors(cls, True), thickness=track_thickness) - - # Check if detection inside region - for region in counting_regions: - if region["polygon"].contains(Point((bbox_center[0], bbox_center[1]))): - region["counts"] += 1 - - # Draw regions (Polygons/Rectangles) - for region in counting_regions: - region_label = str(region["counts"]) - region_color = region["region_color"] - region_text_color = region["text_color"] - - polygon_coords = np.array(region["polygon"].exterior.coords, dtype=np.int32) - centroid_x, centroid_y = int(region["polygon"].centroid.x), int(region["polygon"].centroid.y) - - text_size, _ = cv2.getTextSize( - region_label, cv2.FONT_HERSHEY_SIMPLEX, fontScale=0.7, thickness=line_thickness - ) - text_x = centroid_x - text_size[0] // 2 - text_y = centroid_y + text_size[1] // 2 - cv2.rectangle( - frame, - (text_x - 5, text_y - text_size[1] - 5), - (text_x + text_size[0] + 5, text_y + 5), - region_color, - -1, - ) - cv2.putText( - frame, region_label, (text_x, text_y), cv2.FONT_HERSHEY_SIMPLEX, 0.7, region_text_color, line_thickness - ) - cv2.polylines(frame, [polygon_coords], isClosed=True, color=region_color, thickness=region_thickness) - - if view_img: - if vid_frame_count == 1: - cv2.namedWindow("Ultralytics YOLOv8 Region Counter Movable") - cv2.setMouseCallback("Ultralytics YOLOv8 Region Counter Movable", mouse_callback) - cv2.imshow("Ultralytics YOLOv8 Region Counter Movable", frame) - - if save_img: - video_writer.write(frame) - - for region in counting_regions: # Reinitialize count for each region - region["counts"] = 0 - - if cv2.waitKey(1) & 0xFF == ord("q"): - break - - del vid_frame_count - video_writer.release() - videocapture.release() - cv2.destroyAllWindows() - - -def parse_opt(): - """Parse command line arguments.""" - parser = argparse.ArgumentParser() - parser.add_argument("--weights", type=str, default="yolov8n.pt", help="initial weights path") - parser.add_argument("--device", default="", help="cuda device, i.e. 0 or 0,1,2,3 or cpu") - parser.add_argument("--source", type=str, required=True, help="video file path") - parser.add_argument("--view-img", action="store_true", help="show results") - parser.add_argument("--save-img", action="store_true", help="save results") - parser.add_argument("--exist-ok", action="store_true", help="existing project/name ok, do not increment") - parser.add_argument("--classes", nargs="+", type=int, help="filter by class: --classes 0, or --classes 0 2 3") - parser.add_argument("--line-thickness", type=int, default=2, help="bounding box thickness") - parser.add_argument("--track-thickness", type=int, default=2, help="Tracking line thickness") - parser.add_argument("--region-thickness", type=int, default=4, help="Region thickness") - - return parser.parse_args() - - -def main(opt): - """Main function.""" - run(**vars(opt)) - - -if __name__ == "__main__": - opt = parse_opt() - main(opt) diff --git a/ultralytics-main/examples/YOLOv8-SAHI-Inference-Video/readme.md b/ultralytics-main/examples/YOLOv8-SAHI-Inference-Video/readme.md deleted file mode 100644 index f24df30..0000000 --- a/ultralytics-main/examples/YOLOv8-SAHI-Inference-Video/readme.md +++ /dev/null @@ -1,69 +0,0 @@ -# YOLOv8 with SAHI (Inference on Video) - -[SAHI](https://docs.ultralytics.com/guides/sahi-tiled-inference/) is designed to optimize object detection algorithms for large-scale and high-resolution imagery. It partitions images into manageable slices, performs object detection on each slice, and then stitches the results back together. This tutorial will guide you through the process of running YOLOv8 inference on video files with the aid of SAHI. - -## Table of Contents - -- [Step 1: Install the Required Libraries](#step-1-install-the-required-libraries) -- [Step 2: Run the Inference with SAHI using Ultralytics YOLOv8](#step-2-run-the-inference-with-sahi-using-ultralytics-yolov8) -- [Usage Options](#usage-options) -- [FAQ](#faq) - -## Step 1: Install the Required Libraries - -Clone the repository, install dependencies and `cd` to this local directory for commands in Step 2. - -```bash -# Clone ultralytics repo -git clone https://github.com/ultralytics/ultralytics - -# Install dependencies -pip install sahi ultralytics - -# cd to local directory -cd ultralytics/examples/YOLOv8-SAHI-Inference-Video -``` - -## Step 2: Run the Inference with SAHI using Ultralytics YOLOv8 - -Here are the basic commands for running the inference: - -```bash -#if you want to save results -python yolov8_sahi.py --source "path/to/video.mp4" --save-img - -#if you want to change model file -python yolov8_sahi.py --source "path/to/video.mp4" --save-img --weights "yolov8n.pt" -``` - -## Usage Options - -- `--source`: Specifies the path to the video file you want to run inference on. -- `--save-img`: Flag to save the detection results as images. -- `--weights`: Specifies a different YOLOv8 model file (e.g., `yolov8n.pt`, `yolov8s.pt`, `yolov8m.pt`, `yolov8l.pt`, `yolov8x.pt`). - -## FAQ - -**1. What is SAHI?** - -SAHI stands for Slicing, Analysis, and Healing of Images. It is a library designed to optimize object detection algorithms for large-scale and high-resolution images. The library source code is available on [GitHub](https://github.com/obss/sahi). - -**2. Why use SAHI with YOLOv8?** - -SAHI can handle large-scale images by slicing them into smaller, more manageable sizes without compromising the detection quality. This makes it a great companion to YOLOv8, especially when working with high-resolution videos. - -**3. How do I debug issues?** - -You can add the `--debug` flag to your command to print out more information during inference: - -```bash -python yolov8_sahi.py --source "path to video file" --debug -``` - -**4. Can I use other YOLO versions?** - -Yes, you can specify different YOLO model weights using the `--weights` option. - -**5. Where can I find more information?** - -For a full guide to YOLOv8 with SAHI see [https://docs.ultralytics.com/guides/sahi-tiled-inference](https://docs.ultralytics.com/guides/sahi-tiled-inference/). diff --git a/ultralytics-main/examples/YOLOv8-SAHI-Inference-Video/yolov8_sahi.py b/ultralytics-main/examples/YOLOv8-SAHI-Inference-Video/yolov8_sahi.py deleted file mode 100644 index f2b8274..0000000 --- a/ultralytics-main/examples/YOLOv8-SAHI-Inference-Video/yolov8_sahi.py +++ /dev/null @@ -1,111 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import argparse -from pathlib import Path - -import cv2 -from sahi import AutoDetectionModel -from sahi.predict import get_sliced_prediction -from sahi.utils.yolov8 import download_yolov8s_model - -from ultralytics.utils.files import increment_path - - -def run(weights="yolov8n.pt", source="test.mp4", view_img=False, save_img=False, exist_ok=False): - """ - Run object detection on a video using YOLOv8 and SAHI. - - Args: - weights (str): Model weights path. - source (str): Video file path. - view_img (bool): Show results. - save_img (bool): Save results. - exist_ok (bool): Overwrite existing files. - """ - - # Check source path - if not Path(source).exists(): - raise FileNotFoundError(f"Source path '{source}' does not exist.") - - yolov8_model_path = f"models/{weights}" - download_yolov8s_model(yolov8_model_path) - detection_model = AutoDetectionModel.from_pretrained( - model_type="yolov8", model_path=yolov8_model_path, confidence_threshold=0.3, device="cpu" - ) - - # Video setup - videocapture = cv2.VideoCapture(source) - frame_width, frame_height = int(videocapture.get(3)), int(videocapture.get(4)) - fps, fourcc = int(videocapture.get(5)), cv2.VideoWriter_fourcc(*"mp4v") - - # Output setup - save_dir = increment_path(Path("ultralytics_results_with_sahi") / "exp", exist_ok) - save_dir.mkdir(parents=True, exist_ok=True) - video_writer = cv2.VideoWriter(str(save_dir / f"{Path(source).stem}.mp4"), fourcc, fps, (frame_width, frame_height)) - - while videocapture.isOpened(): - success, frame = videocapture.read() - if not success: - break - - results = get_sliced_prediction( - frame, detection_model, slice_height=512, slice_width=512, overlap_height_ratio=0.2, overlap_width_ratio=0.2 - ) - object_prediction_list = results.object_prediction_list - - boxes_list = [] - clss_list = [] - for ind, _ in enumerate(object_prediction_list): - boxes = ( - object_prediction_list[ind].bbox.minx, - object_prediction_list[ind].bbox.miny, - object_prediction_list[ind].bbox.maxx, - object_prediction_list[ind].bbox.maxy, - ) - clss = object_prediction_list[ind].category.name - boxes_list.append(boxes) - clss_list.append(clss) - - for box, cls in zip(boxes_list, clss_list): - x1, y1, x2, y2 = box - cv2.rectangle(frame, (int(x1), int(y1)), (int(x2), int(y2)), (56, 56, 255), 2) - label = str(cls) - t_size = cv2.getTextSize(label, 0, fontScale=0.6, thickness=1)[0] - cv2.rectangle( - frame, (int(x1), int(y1) - t_size[1] - 3), (int(x1) + t_size[0], int(y1) + 3), (56, 56, 255), -1 - ) - cv2.putText( - frame, label, (int(x1), int(y1) - 2), 0, 0.6, [255, 255, 255], thickness=1, lineType=cv2.LINE_AA - ) - - if view_img: - cv2.imshow(Path(source).stem, frame) - if save_img: - video_writer.write(frame) - - if cv2.waitKey(1) & 0xFF == ord("q"): - break - video_writer.release() - videocapture.release() - cv2.destroyAllWindows() - - -def parse_opt(): - """Parse command line arguments.""" - parser = argparse.ArgumentParser() - parser.add_argument("--weights", type=str, default="yolov8n.pt", help="initial weights path") - parser.add_argument("--source", type=str, required=True, help="video file path") - parser.add_argument("--view-img", action="store_true", help="show results") - parser.add_argument("--save-img", action="store_true", help="save results") - parser.add_argument("--exist-ok", action="store_true", help="existing project/name ok, do not increment") - return parser.parse_args() - - -def main(opt): - """Main function.""" - run(**vars(opt)) - - -if __name__ == "__main__": - opt = parse_opt() - main(opt) diff --git a/ultralytics-main/examples/YOLOv8-Segmentation-ONNXRuntime-Python/README.md b/ultralytics-main/examples/YOLOv8-Segmentation-ONNXRuntime-Python/README.md deleted file mode 100644 index 9327f1f..0000000 --- a/ultralytics-main/examples/YOLOv8-Segmentation-ONNXRuntime-Python/README.md +++ /dev/null @@ -1,63 +0,0 @@ -# YOLOv8-Segmentation-ONNXRuntime-Python Demo - -This repository provides a Python demo for performing segmentation with YOLOv8 using ONNX Runtime, highlighting the interoperability of YOLOv8 models without the need for the full PyTorch stack. - -## Features - -- **Framework Agnostic**: Runs segmentation inference purely on ONNX Runtime without importing PyTorch. -- **Efficient Inference**: Supports both FP32 and FP16 precision for ONNX models, catering to different computational needs. -- **Ease of Use**: Utilizes simple command-line arguments for model execution. -- **Broad Compatibility**: Leverages Numpy and OpenCV for image processing, ensuring broad compatibility with various environments. - -## Installation - -Install the required packages using pip. You will need `ultralytics` for exporting YOLOv8-seg ONNX model and using some utility functions, `onnxruntime-gpu` for GPU-accelerated inference, and `opencv-python` for image processing. - -```bash -pip install ultralytics -pip install onnxruntime-gpu # For GPU support -# pip install onnxruntime # Use this instead if you don't have an NVIDIA GPU -pip install numpy -pip install opencv-python -``` - -## Getting Started - -### 1. Export the YOLOv8 ONNX Model - -Export the YOLOv8 segmentation model to ONNX format using the provided `ultralytics` package. - -```bash -yolo export model=yolov8s-seg.pt imgsz=640 format=onnx opset=12 simplify -``` - -### 2. Run Inference - -Perform inference with the exported ONNX model on your images. - -```bash -python main.py --model-path --source -``` - -### Example Output - -After running the command, you should see segmentation results similar to this: - -Segmentation Demo - -## Advanced Usage - -For more advanced usage, including real-time video processing, please refer to the `main.py` script's command-line arguments. - -## Contributing - -We welcome contributions to improve this demo! Please submit issues and pull requests for bug reports, feature requests, or submitting a new algorithm enhancement. - -## License - -This project is licensed under the AGPL-3.0 License - see the [LICENSE](https://github.com/ultralytics/ultralytics/blob/main/LICENSE) file for details. - -## Acknowledgments - -- The YOLOv8-Segmentation-ONNXRuntime-Python demo is contributed by GitHub user [jamjamjon](https://github.com/jamjamjon). -- Thanks to the ONNX Runtime community for providing a robust and efficient inference engine. diff --git a/ultralytics-main/examples/YOLOv8-Segmentation-ONNXRuntime-Python/main.py b/ultralytics-main/examples/YOLOv8-Segmentation-ONNXRuntime-Python/main.py deleted file mode 100644 index 141d21b..0000000 --- a/ultralytics-main/examples/YOLOv8-Segmentation-ONNXRuntime-Python/main.py +++ /dev/null @@ -1,342 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import argparse - -import cv2 -import numpy as np -import onnxruntime as ort - -from ultralytics.utils import ASSETS, yaml_load -from ultralytics.utils.checks import check_yaml -from ultralytics.utils.plotting import Colors - - -class YOLOv8Seg: - """YOLOv8 segmentation model.""" - - def __init__(self, onnx_model): - """ - Initialization. - - Args: - onnx_model (str): Path to the ONNX model. - """ - - # Build Ort session - self.session = ort.InferenceSession( - onnx_model, - providers=["CUDAExecutionProvider", "CPUExecutionProvider"] - if ort.get_device() == "GPU" - else ["CPUExecutionProvider"], - ) - - # Numpy dtype: support both FP32 and FP16 onnx model - self.ndtype = np.half if self.session.get_inputs()[0].type == "tensor(float16)" else np.single - - # Get model width and height(YOLOv8-seg only has one input) - self.model_height, self.model_width = [x.shape for x in self.session.get_inputs()][0][-2:] - - # Load COCO class names - self.classes = yaml_load(check_yaml("coco128.yaml"))["names"] - - # Create color palette - self.color_palette = Colors() - - def __call__(self, im0, conf_threshold=0.4, iou_threshold=0.45, nm=32): - """ - The whole pipeline: pre-process -> inference -> post-process. - - Args: - im0 (Numpy.ndarray): original input image. - conf_threshold (float): confidence threshold for filtering predictions. - iou_threshold (float): iou threshold for NMS. - nm (int): the number of masks. - - Returns: - boxes (List): list of bounding boxes. - segments (List): list of segments. - masks (np.ndarray): [N, H, W], output masks. - """ - - # Pre-process - im, ratio, (pad_w, pad_h) = self.preprocess(im0) - - # Ort inference - preds = self.session.run(None, {self.session.get_inputs()[0].name: im}) - - # Post-process - boxes, segments, masks = self.postprocess( - preds, - im0=im0, - ratio=ratio, - pad_w=pad_w, - pad_h=pad_h, - conf_threshold=conf_threshold, - iou_threshold=iou_threshold, - nm=nm, - ) - return boxes, segments, masks - - def preprocess(self, img): - """ - Pre-processes the input image. - - Args: - img (Numpy.ndarray): image about to be processed. - - Returns: - img_process (Numpy.ndarray): image preprocessed for inference. - ratio (tuple): width, height ratios in letterbox. - pad_w (float): width padding in letterbox. - pad_h (float): height padding in letterbox. - """ - - # Resize and pad input image using letterbox() (Borrowed from Ultralytics) - shape = img.shape[:2] # original image shape - new_shape = (self.model_height, self.model_width) - r = min(new_shape[0] / shape[0], new_shape[1] / shape[1]) - ratio = r, r - new_unpad = int(round(shape[1] * r)), int(round(shape[0] * r)) - pad_w, pad_h = (new_shape[1] - new_unpad[0]) / 2, (new_shape[0] - new_unpad[1]) / 2 # wh padding - if shape[::-1] != new_unpad: # resize - img = cv2.resize(img, new_unpad, interpolation=cv2.INTER_LINEAR) - top, bottom = int(round(pad_h - 0.1)), int(round(pad_h + 0.1)) - left, right = int(round(pad_w - 0.1)), int(round(pad_w + 0.1)) - img = cv2.copyMakeBorder(img, top, bottom, left, right, cv2.BORDER_CONSTANT, value=(114, 114, 114)) - - # Transforms: HWC to CHW -> BGR to RGB -> div(255) -> contiguous -> add axis(optional) - img = np.ascontiguousarray(np.einsum("HWC->CHW", img)[::-1], dtype=self.ndtype) / 255.0 - img_process = img[None] if len(img.shape) == 3 else img - return img_process, ratio, (pad_w, pad_h) - - def postprocess(self, preds, im0, ratio, pad_w, pad_h, conf_threshold, iou_threshold, nm=32): - """ - Post-process the prediction. - - Args: - preds (Numpy.ndarray): predictions come from ort.session.run(). - im0 (Numpy.ndarray): [h, w, c] original input image. - ratio (tuple): width, height ratios in letterbox. - pad_w (float): width padding in letterbox. - pad_h (float): height padding in letterbox. - conf_threshold (float): conf threshold. - iou_threshold (float): iou threshold. - nm (int): the number of masks. - - Returns: - boxes (List): list of bounding boxes. - segments (List): list of segments. - masks (np.ndarray): [N, H, W], output masks. - """ - x, protos = preds[0], preds[1] # Two outputs: predictions and protos - - # Transpose the first output: (Batch_size, xywh_conf_cls_nm, Num_anchors) -> (Batch_size, Num_anchors, xywh_conf_cls_nm) - x = np.einsum("bcn->bnc", x) - - # Predictions filtering by conf-threshold - x = x[np.amax(x[..., 4:-nm], axis=-1) > conf_threshold] - - # Create a new matrix which merge these(box, score, cls, nm) into one - # For more details about `numpy.c_()`: https://numpy.org/doc/1.26/reference/generated/numpy.c_.html - x = np.c_[x[..., :4], np.amax(x[..., 4:-nm], axis=-1), np.argmax(x[..., 4:-nm], axis=-1), x[..., -nm:]] - - # NMS filtering - x = x[cv2.dnn.NMSBoxes(x[:, :4], x[:, 4], conf_threshold, iou_threshold)] - - # Decode and return - if len(x) > 0: - # Bounding boxes format change: cxcywh -> xyxy - x[..., [0, 1]] -= x[..., [2, 3]] / 2 - x[..., [2, 3]] += x[..., [0, 1]] - - # Rescales bounding boxes from model shape(model_height, model_width) to the shape of original image - x[..., :4] -= [pad_w, pad_h, pad_w, pad_h] - x[..., :4] /= min(ratio) - - # Bounding boxes boundary clamp - x[..., [0, 2]] = x[:, [0, 2]].clip(0, im0.shape[1]) - x[..., [1, 3]] = x[:, [1, 3]].clip(0, im0.shape[0]) - - # Process masks - masks = self.process_mask(protos[0], x[:, 6:], x[:, :4], im0.shape) - - # Masks -> Segments(contours) - segments = self.masks2segments(masks) - return x[..., :6], segments, masks # boxes, segments, masks - else: - return [], [], [] - - @staticmethod - def masks2segments(masks): - """ - It takes a list of masks(n,h,w) and returns a list of segments(n,xy) (Borrowed from - https://github.com/ultralytics/ultralytics/blob/465df3024f44fa97d4fad9986530d5a13cdabdca/ultralytics/utils/ops.py#L750) - - Args: - masks (numpy.ndarray): the output of the model, which is a tensor of shape (batch_size, 160, 160). - - Returns: - segments (List): list of segment masks. - """ - segments = [] - for x in masks.astype("uint8"): - c = cv2.findContours(x, cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_NONE)[0] # CHAIN_APPROX_SIMPLE - if c: - c = np.array(c[np.array([len(x) for x in c]).argmax()]).reshape(-1, 2) - else: - c = np.zeros((0, 2)) # no segments found - segments.append(c.astype("float32")) - return segments - - @staticmethod - def crop_mask(masks, boxes): - """ - It takes a mask and a bounding box, and returns a mask that is cropped to the bounding box. (Borrowed from - https://github.com/ultralytics/ultralytics/blob/465df3024f44fa97d4fad9986530d5a13cdabdca/ultralytics/utils/ops.py#L599) - - Args: - masks (Numpy.ndarray): [n, h, w] tensor of masks. - boxes (Numpy.ndarray): [n, 4] tensor of bbox coordinates in relative point form. - - Returns: - (Numpy.ndarray): The masks are being cropped to the bounding box. - """ - n, h, w = masks.shape - x1, y1, x2, y2 = np.split(boxes[:, :, None], 4, 1) - r = np.arange(w, dtype=x1.dtype)[None, None, :] - c = np.arange(h, dtype=x1.dtype)[None, :, None] - return masks * ((r >= x1) * (r < x2) * (c >= y1) * (c < y2)) - - def process_mask(self, protos, masks_in, bboxes, im0_shape): - """ - Takes the output of the mask head, and applies the mask to the bounding boxes. This produces masks of higher quality - but is slower. (Borrowed from https://github.com/ultralytics/ultralytics/blob/465df3024f44fa97d4fad9986530d5a13cdabdca/ultralytics/utils/ops.py#L618) - - Args: - protos (numpy.ndarray): [mask_dim, mask_h, mask_w]. - masks_in (numpy.ndarray): [n, mask_dim], n is number of masks after nms. - bboxes (numpy.ndarray): bboxes re-scaled to original image shape. - im0_shape (tuple): the size of the input image (h,w,c). - - Returns: - (numpy.ndarray): The upsampled masks. - """ - c, mh, mw = protos.shape - masks = np.matmul(masks_in, protos.reshape((c, -1))).reshape((-1, mh, mw)).transpose(1, 2, 0) # HWN - masks = np.ascontiguousarray(masks) - masks = self.scale_mask(masks, im0_shape) # re-scale mask from P3 shape to original input image shape - masks = np.einsum("HWN -> NHW", masks) # HWN -> NHW - masks = self.crop_mask(masks, bboxes) - return np.greater(masks, 0.5) - - @staticmethod - def scale_mask(masks, im0_shape, ratio_pad=None): - """ - Takes a mask, and resizes it to the original image size. (Borrowed from - https://github.com/ultralytics/ultralytics/blob/465df3024f44fa97d4fad9986530d5a13cdabdca/ultralytics/utils/ops.py#L305) - - Args: - masks (np.ndarray): resized and padded masks/images, [h, w, num]/[h, w, 3]. - im0_shape (tuple): the original image shape. - ratio_pad (tuple): the ratio of the padding to the original image. - - Returns: - masks (np.ndarray): The masks that are being returned. - """ - im1_shape = masks.shape[:2] - if ratio_pad is None: # calculate from im0_shape - gain = min(im1_shape[0] / im0_shape[0], im1_shape[1] / im0_shape[1]) # gain = old / new - pad = (im1_shape[1] - im0_shape[1] * gain) / 2, (im1_shape[0] - im0_shape[0] * gain) / 2 # wh padding - else: - pad = ratio_pad[1] - - # Calculate tlbr of mask - top, left = int(round(pad[1] - 0.1)), int(round(pad[0] - 0.1)) # y, x - bottom, right = int(round(im1_shape[0] - pad[1] + 0.1)), int(round(im1_shape[1] - pad[0] + 0.1)) - if len(masks.shape) < 2: - raise ValueError(f'"len of masks shape" should be 2 or 3, but got {len(masks.shape)}') - masks = masks[top:bottom, left:right] - masks = cv2.resize( - masks, (im0_shape[1], im0_shape[0]), interpolation=cv2.INTER_LINEAR - ) # INTER_CUBIC would be better - if len(masks.shape) == 2: - masks = masks[:, :, None] - return masks - - def draw_and_visualize(self, im, bboxes, segments, vis=False, save=True): - """ - Draw and visualize results. - - Args: - im (np.ndarray): original image, shape [h, w, c]. - bboxes (numpy.ndarray): [n, 4], n is number of bboxes. - segments (List): list of segment masks. - vis (bool): imshow using OpenCV. - save (bool): save image annotated. - - Returns: - None - """ - - # Draw rectangles and polygons - im_canvas = im.copy() - for (*box, conf, cls_), segment in zip(bboxes, segments): - # draw contour and fill mask - cv2.polylines(im, np.int32([segment]), True, (255, 255, 255), 2) # white borderline - cv2.fillPoly(im_canvas, np.int32([segment]), self.color_palette(int(cls_), bgr=True)) - - # draw bbox rectangle - cv2.rectangle( - im, - (int(box[0]), int(box[1])), - (int(box[2]), int(box[3])), - self.color_palette(int(cls_), bgr=True), - 1, - cv2.LINE_AA, - ) - cv2.putText( - im, - f"{self.classes[cls_]}: {conf:.3f}", - (int(box[0]), int(box[1] - 9)), - cv2.FONT_HERSHEY_SIMPLEX, - 0.7, - self.color_palette(int(cls_), bgr=True), - 2, - cv2.LINE_AA, - ) - - # Mix image - im = cv2.addWeighted(im_canvas, 0.3, im, 0.7, 0) - - # Show image - if vis: - cv2.imshow("demo", im) - cv2.waitKey(0) - cv2.destroyAllWindows() - - # Save image - if save: - cv2.imwrite("demo.jpg", im) - - -if __name__ == "__main__": - # Create an argument parser to handle command-line arguments - parser = argparse.ArgumentParser() - parser.add_argument("--model", type=str, required=True, help="Path to ONNX model") - parser.add_argument("--source", type=str, default=str(ASSETS / "bus.jpg"), help="Path to input image") - parser.add_argument("--conf", type=float, default=0.25, help="Confidence threshold") - parser.add_argument("--iou", type=float, default=0.45, help="NMS IoU threshold") - args = parser.parse_args() - - # Build model - model = YOLOv8Seg(args.model) - - # Read image by OpenCV - img = cv2.imread(args.source) - - # Inference - boxes, segments, _ = model(img, conf_threshold=args.conf, iou_threshold=args.iou) - - # Draw bboxes and polygons - if len(boxes) > 0: - model.draw_and_visualize(img, boxes, segments, vis=False, save=True) diff --git a/ultralytics-main/examples/heatmaps.ipynb b/ultralytics-main/examples/heatmaps.ipynb deleted file mode 100644 index 0cc520c..0000000 --- a/ultralytics-main/examples/heatmaps.ipynb +++ /dev/null @@ -1,145 +0,0 @@ -{ - "nbformat": 4, - "nbformat_minor": 0, - "metadata": { - "colab": { - "provenance": [], - "gpuType": "T4" - }, - "kernelspec": { - "name": "python3", - "display_name": "Python 3" - }, - "language_info": { - "name": "python" - }, - "accelerator": "GPU" - }, - "cells": [ - { - "cell_type": "markdown", - "source": [ - "
\n", - "\n", - " \n", - " \n", - "\n", - " [中文](https://docs.ultralytics.com/zh/) | [한국어](https://docs.ultralytics.com/ko/) | [日本語](https://docs.ultralytics.com/ja/) | [Русский](https://docs.ultralytics.com/ru/) | [Deutsch](https://docs.ultralytics.com/de/) | [Français](https://docs.ultralytics.com/fr/) | [Español](https://docs.ultralytics.com/es/) | [Português](https://docs.ultralytics.com/pt/) | [हिन्दी](https://docs.ultralytics.com/hi/) | [العربية](https://docs.ultralytics.com/ar/)\n", - "\n", - " \"Open\n", - "\n", - "Welcome to the Ultralytics YOLOv8 🚀 notebook! YOLOv8 is the latest version of the YOLO (You Only Look Once) AI models developed by Ultralytics. This notebook serves as the starting point for exploring the heatmaps and understand its features and capabilities.\n", - "\n", - "YOLOv8 models are fast, accurate, and easy to use, making them ideal for various object detection and image segmentation tasks. They can be trained on large datasets and run on diverse hardware platforms, from CPUs to GPUs.\n", - "\n", - "We hope that the resources in this notebook will help you get the most out of Ultralytics Heatmaps. Please browse the YOLOv8 Docs for details, raise an issue on GitHub for support, and join our Discord community for questions and discussions!\n", - "\n", - "
" - ], - "metadata": { - "id": "PN1cAxdvd61e" - } - }, - { - "cell_type": "markdown", - "source": [ - "# Setup\n", - "\n", - "Pip install `ultralytics` and [dependencies](https://github.com/ultralytics/ultralytics/blob/main/pyproject.toml) and check software and hardware." - ], - "metadata": { - "id": "o68Sg1oOeZm2" - } - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "id": "9dSwz_uOReMI" - }, - "outputs": [], - "source": [ - "!pip install ultralytics" - ] - }, - { - "cell_type": "markdown", - "source": [ - "# Ultralytics Heatmaps\n", - "\n", - "Heatmap is color-coded matrix, generated by Ultralytics YOLOv8, simplifies intricate data by using vibrant colors. This visual representation employs warmer hues for higher intensities and cooler tones for lower values. Heatmaps are effective in illustrating complex data patterns, correlations, and anomalies, providing a user-friendly and engaging way to interpret data across various domains." - ], - "metadata": { - "id": "m7VkxQ2aeg7k" - } - }, - { - "cell_type": "code", - "source": [ - "from ultralytics import YOLO\n", - "from ultralytics.solutions import heatmap\n", - "import cv2\n", - "\n", - "model = YOLO(\"yolov8n.pt\")\n", - "cap = cv2.VideoCapture(\"path/to/video/file.mp4\")\n", - "assert cap.isOpened(), \"Error reading video file\"\n", - "w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS))\n", - "\n", - "# Video writer\n", - "video_writer = cv2.VideoWriter(\"heatmap_output.avi\",\n", - " cv2.VideoWriter_fourcc(*'mp4v'),\n", - " fps,\n", - " (w, h))\n", - "\n", - "# Init heatmap\n", - "heatmap_obj = heatmap.Heatmap()\n", - "heatmap_obj.set_args(colormap=cv2.COLORMAP_PARULA,\n", - " imw=w,\n", - " imh=h,\n", - " view_img=True,\n", - " shape=\"circle\")\n", - "\n", - "while cap.isOpened():\n", - " success, im0 = cap.read()\n", - " if not success:\n", - " print(\"Video frame is empty or video processing has been successfully completed.\")\n", - " break\n", - " tracks = model.track(im0, persist=True, show=False)\n", - "\n", - " im0 = heatmap_obj.generate_heatmap(im0, tracks)\n", - " video_writer.write(im0)\n", - "\n", - "cap.release()\n", - "video_writer.release()\n", - "cv2.destroyAllWindows()" - ], - "metadata": { - "id": "Cx-u59HQdu2o" - }, - "execution_count": null, - "outputs": [] - }, - { - "cell_type": "markdown", - "source": [ - "#Community Support\n", - "\n", - "For more information, you can explore Ultralytics Heatmaps Docs\n", - "\n", - "Ultralytics ⚡ resources\n", - "- About Us – https://ultralytics.com/about\n", - "- Join Our Team – https://ultralytics.com/work\n", - "- Contact Us – https://ultralytics.com/contact\n", - "- Discord – https://discord.gg/2wNGbc6g9X\n", - "- Ultralytics License – https://ultralytics.com/license\n", - "\n", - "YOLOv8 🚀 resources\n", - "- GitHub – https://github.com/ultralytics/ultralytics\n", - "- Docs – https://docs.ultralytics.com/" - ], - "metadata": { - "id": "QrlKg-y3fEyD" - } - } - ] -} \ No newline at end of file diff --git a/ultralytics-main/examples/hub.ipynb b/ultralytics-main/examples/hub.ipynb deleted file mode 100644 index 29d8ff1..0000000 --- a/ultralytics-main/examples/hub.ipynb +++ /dev/null @@ -1,106 +0,0 @@ -{ - "nbformat": 4, - "nbformat_minor": 0, - "metadata": { - "colab": { - "name": "Ultralytics HUB", - "provenance": [] - }, - "kernelspec": { - "name": "python3", - "display_name": "Python 3" - }, - "language_info": { - "name": "python" - }, - "accelerator": "GPU" - }, - "cells": [ - { - "cell_type": "markdown", - "metadata": { - "id": "FIzICjaph_Wy" - }, - "source": [ - "\n", - "\n", - "\n", - "
\n", - "\n", - "[中文](https://docs.ultralytics.com/zh/) | [한국어](https://docs.ultralytics.com/ko/) | [日本語](https://docs.ultralytics.com/ja/) | [Русский](https://docs.ultralytics.com/ru/) | [Deutsch](https://docs.ultralytics.com/de/) | [Français](https://docs.ultralytics.com/fr/) | [Español](https://docs.ultralytics.com/es/) | [Português](https://docs.ultralytics.com/pt/) | [हिन्दी](https://docs.ultralytics.com/hi/) | [العربية](https://docs.ultralytics.com/ar/)\n", - "\n", - " \n", - " \"CI\n", - " \n", - " \"Open\n", - "\n", - "Welcome to the [Ultralytics](https://ultralytics.com/) HUB notebook!\n", - "\n", - "This notebook allows you to train [YOLOv5](https://github.com/ultralytics/yolov5) and [YOLOv8](https://github.com/ultralytics/ultralytics) 🚀 models using [HUB](https://hub.ultralytics.com/). Please browse the HUB Docs for details, raise an issue on GitHub for support, and join our Discord community for questions and discussions!\n", - "
" - ] - }, - { - "cell_type": "markdown", - "metadata": { - "id": "eRQ2ow94MiOv" - }, - "source": [ - "# Setup\n", - "\n", - "Pip install `ultralytics` and [dependencies](https://github.com/ultralytics/ultralytics/blob/main/pyproject.toml) and check software and hardware." - ] - }, - { - "cell_type": "code", - "metadata": { - "id": "FyDnXd-n4c7Y", - "colab": { - "base_uri": "https://localhost:8080/" - }, - "outputId": "01e34b44-a26f-4dbc-a5a1-6e29bca01a1b" - }, - "source": [ - "%pip install ultralytics # install\n", - "from ultralytics import YOLO, checks, hub\n", - "checks() # checks" - ], - "execution_count": null, - "outputs": [ - { - "output_type": "stream", - "name": "stderr", - "text": [ - "Ultralytics YOLOv8.0.210 🚀 Python-3.10.12 torch-2.0.1+cu118 CUDA:0 (Tesla T4, 15102MiB)\n", - "Setup complete ✅ (2 CPUs, 12.7 GB RAM, 24.4/78.2 GB disk)\n" - ] - } - ] - }, - { - "cell_type": "markdown", - "metadata": { - "id": "cQ9BwaAqxAm4" - }, - "source": [ - "# Start\n", - "\n", - "Login with your [API key](https://hub.ultralytics.com/settings?tab=api+keys), select your YOLO 🚀 model and start training!" - ] - }, - { - "cell_type": "code", - "metadata": { - "id": "XSlZaJ9Iw_iZ" - }, - "source": [ - "hub.login('API_KEY') # use your API key\n", - "\n", - "model = YOLO('https://hub.ultralytics.com/MODEL_ID') # use your model URL\n", - "results = model.train() # train model" - ], - "execution_count": null, - "outputs": [] - } - ] -} diff --git a/ultralytics-main/examples/object_counting.ipynb b/ultralytics-main/examples/object_counting.ipynb deleted file mode 100644 index ce11044..0000000 --- a/ultralytics-main/examples/object_counting.ipynb +++ /dev/null @@ -1,147 +0,0 @@ -{ - "nbformat": 4, - "nbformat_minor": 0, - "metadata": { - "colab": { - "provenance": [], - "gpuType": "T4" - }, - "kernelspec": { - "name": "python3", - "display_name": "Python 3" - }, - "language_info": { - "name": "python" - }, - "accelerator": "GPU" - }, - "cells": [ - { - "cell_type": "markdown", - "source": [ - "
\n", - "\n", - " \n", - " \n", - "\n", - " [中文](https://docs.ultralytics.com/zh/) | [한국어](https://docs.ultralytics.com/ko/) | [日本語](https://docs.ultralytics.com/ja/) | [Русский](https://docs.ultralytics.com/ru/) | [Deutsch](https://docs.ultralytics.com/de/) | [Français](https://docs.ultralytics.com/fr/) | [Español](https://docs.ultralytics.com/es/) | [Português](https://docs.ultralytics.com/pt/) | [हिन्दी](https://docs.ultralytics.com/hi/) | [العربية](https://docs.ultralytics.com/ar/)\n", - "\n", - " \"Open\n", - "\n", - "Welcome to the Ultralytics YOLOv8 🚀 notebook! YOLOv8 is the latest version of the YOLO (You Only Look Once) AI models developed by Ultralytics. This notebook serves as the starting point for exploring the Object Counting and understand its features and capabilities.\n", - "\n", - "YOLOv8 models are fast, accurate, and easy to use, making them ideal for various object detection and image segmentation tasks. They can be trained on large datasets and run on diverse hardware platforms, from CPUs to GPUs.\n", - "\n", - "We hope that the resources in this notebook will help you get the most out of Ultralytics Object Counting. Please browse the YOLOv8 Docs for details, raise an issue on GitHub for support, and join our Discord community for questions and discussions!\n", - "\n", - "
" - ], - "metadata": { - "id": "PN1cAxdvd61e" - } - }, - { - "cell_type": "markdown", - "source": [ - "# Setup\n", - "\n", - "Pip install `ultralytics` and [dependencies](https://github.com/ultralytics/ultralytics/blob/main/pyproject.toml) and check software and hardware." - ], - "metadata": { - "id": "o68Sg1oOeZm2" - } - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "id": "9dSwz_uOReMI" - }, - "outputs": [], - "source": [ - "!pip install ultralytics" - ] - }, - { - "cell_type": "markdown", - "source": [ - "# Ultralytics Object Counting\n", - "\n", - "Counting objects using Ultralytics YOLOv8 entails the precise detection and enumeration of specific objects within videos and camera streams. YOLOv8 demonstrates exceptional performance in real-time applications, delivering efficient and accurate object counting across diverse scenarios such as crowd analysis and surveillance. This is attributed to its advanced algorithms and deep learning capabilities." - ], - "metadata": { - "id": "m7VkxQ2aeg7k" - } - }, - { - "cell_type": "code", - "source": [ - "from ultralytics import YOLO\n", - "from ultralytics.solutions import object_counter\n", - "import cv2\n", - "\n", - "model = YOLO(\"yolov8n.pt\")\n", - "cap = cv2.VideoCapture(\"path/to/video/file.mp4\")\n", - "assert cap.isOpened(), \"Error reading video file\"\n", - "w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS))\n", - "\n", - "# Define region points\n", - "region_points = [(20, 400), (1080, 404), (1080, 360), (20, 360)]\n", - "\n", - "# Video writer\n", - "video_writer = cv2.VideoWriter(\"object_counting_output.avi\",\n", - " cv2.VideoWriter_fourcc(*'mp4v'),\n", - " fps,\n", - " (w, h))\n", - "\n", - "# Init Object Counter\n", - "counter = object_counter.ObjectCounter()\n", - "counter.set_args(view_img=True,\n", - " reg_pts=region_points,\n", - " classes_names=model.names,\n", - " draw_tracks=True)\n", - "\n", - "while cap.isOpened():\n", - " success, im0 = cap.read()\n", - " if not success:\n", - " print(\"Video frame is empty or video processing has been successfully completed.\")\n", - " break\n", - " tracks = model.track(im0, persist=True, show=False)\n", - "\n", - " im0 = counter.start_counting(im0, tracks)\n", - " video_writer.write(im0)\n", - "\n", - "cap.release()\n", - "video_writer.release()\n", - "cv2.destroyAllWindows()" - ], - "metadata": { - "id": "Cx-u59HQdu2o" - }, - "execution_count": null, - "outputs": [] - }, - { - "cell_type": "markdown", - "source": [ - "#Community Support\n", - "\n", - "For more information, you can explore Ultralytics Object Counting Docs\n", - "\n", - "Ultralytics ⚡ resources\n", - "- About Us – https://ultralytics.com/about\n", - "- Join Our Team – https://ultralytics.com/work\n", - "- Contact Us – https://ultralytics.com/contact\n", - "- Discord – https://discord.gg/2wNGbc6g9X\n", - "- Ultralytics License – https://ultralytics.com/license\n", - "\n", - "YOLOv8 🚀 resources\n", - "- GitHub – https://github.com/ultralytics/ultralytics\n", - "- Docs – https://docs.ultralytics.com/" - ], - "metadata": { - "id": "QrlKg-y3fEyD" - } - } - ] -} \ No newline at end of file diff --git a/ultralytics-main/examples/object_tracking.ipynb b/ultralytics-main/examples/object_tracking.ipynb deleted file mode 100644 index e1a0d4e..0000000 --- a/ultralytics-main/examples/object_tracking.ipynb +++ /dev/null @@ -1,203 +0,0 @@ -{ - "nbformat": 4, - "nbformat_minor": 0, - "metadata": { - "colab": { - "provenance": [], - "gpuType": "T4" - }, - "kernelspec": { - "name": "python3", - "display_name": "Python 3" - }, - "language_info": { - "name": "python" - }, - "accelerator": "GPU" - }, - "cells": [ - { - "cell_type": "markdown", - "source": [ - "
\n", - "\n", - " \n", - " \n", - "\n", - " [中文](https://docs.ultralytics.com/zh/) | [한국어](https://docs.ultralytics.com/ko/) | [日本語](https://docs.ultralytics.com/ja/) | [Русский](https://docs.ultralytics.com/ru/) | [Deutsch](https://docs.ultralytics.com/de/) | [Français](https://docs.ultralytics.com/fr/) | [Español](https://docs.ultralytics.com/es/) | [Português](https://docs.ultralytics.com/pt/) | [हिन्दी](https://docs.ultralytics.com/hi/) | [العربية](https://docs.ultralytics.com/ar/)\n", - "\n", - " \"Open\n", - "\n", - "Welcome to the Ultralytics YOLOv8 🚀 notebook! YOLOv8 is the latest version of the YOLO (You Only Look Once) AI models developed by Ultralytics. This notebook serves as the starting point for exploring the Object Tracking and understand its features and capabilities.\n", - "\n", - "YOLOv8 models are fast, accurate, and easy to use, making them ideal for various object detection and image segmentation tasks. They can be trained on large datasets and run on diverse hardware platforms, from CPUs to GPUs.\n", - "\n", - "We hope that the resources in this notebook will help you get the most out of Ultralytics Object Tracking. Please browse the YOLOv8 Docs for details, raise an issue on GitHub for support, and join our Discord community for questions and discussions!\n", - "\n", - "
" - ], - "metadata": { - "id": "PN1cAxdvd61e" - } - }, - { - "cell_type": "markdown", - "source": [ - "# Setup\n", - "\n", - "Pip install `ultralytics` and [dependencies](https://github.com/ultralytics/ultralytics/blob/main/pyproject.toml) and check software and hardware." - ], - "metadata": { - "id": "o68Sg1oOeZm2" - } - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "id": "9dSwz_uOReMI" - }, - "outputs": [], - "source": [ - "!pip install ultralytics" - ] - }, - { - "cell_type": "markdown", - "source": [ - "# Ultralytics Object Tracking\n", - "\n", - "Within the domain of video analytics, object tracking stands out as a crucial undertaking. It goes beyond merely identifying the location and class of objects within the frame; it also involves assigning a unique ID to each detected object as the video unfolds. The applications of this technology are vast, spanning from surveillance and security to real-time sports analytics." - ], - "metadata": { - "id": "m7VkxQ2aeg7k" - } - }, - { - "cell_type": "markdown", - "source": [ - "## CLI" - ], - "metadata": { - "id": "-ZF9DM6e6gz0" - } - }, - { - "cell_type": "code", - "source": [ - "!yolo track source=\"/path/to/video/file.mp4\" save=True" - ], - "metadata": { - "id": "-XJqhOwo6iqT" - }, - "execution_count": null, - "outputs": [] - }, - { - "cell_type": "markdown", - "source": [ - "## Python\n", - "\n", - "- Draw Object tracking trails" - ], - "metadata": { - "id": "XRcw0vIE6oNb" - } - }, - { - "cell_type": "code", - "source": [ - "import cv2\n", - "import numpy as np\n", - "from ultralytics import YOLO\n", - "\n", - "from ultralytics.utils.checks import check_imshow\n", - "from ultralytics.utils.plotting import Annotator, colors\n", - "\n", - "from collections import defaultdict\n", - "\n", - "track_history = defaultdict(lambda: [])\n", - "model = YOLO(\"yolov8n.pt\")\n", - "names = model.model.names\n", - "\n", - "video_path = \"/path/to/video/file.mp4\"\n", - "cap = cv2.VideoCapture(video_path)\n", - "assert cap.isOpened(), \"Error reading video file\"\n", - "\n", - "w, h, fps = (int(cap.get(x)) for x in (cv2.CAP_PROP_FRAME_WIDTH, cv2.CAP_PROP_FRAME_HEIGHT, cv2.CAP_PROP_FPS))\n", - "\n", - "result = cv2.VideoWriter(\"object_tracking.avi\",\n", - " cv2.VideoWriter_fourcc(*'mp4v'),\n", - " fps,\n", - " (w, h))\n", - "\n", - "while cap.isOpened():\n", - " success, frame = cap.read()\n", - " if success:\n", - " results = model.track(frame, persist=True, verbose=False)\n", - " boxes = results[0].boxes.xyxy.cpu()\n", - "\n", - " if results[0].boxes.id is not None:\n", - "\n", - " # Extract prediction results\n", - " clss = results[0].boxes.cls.cpu().tolist()\n", - " track_ids = results[0].boxes.id.int().cpu().tolist()\n", - " confs = results[0].boxes.conf.float().cpu().tolist()\n", - "\n", - " # Annotator Init\n", - " annotator = Annotator(frame, line_width=2)\n", - "\n", - " for box, cls, track_id in zip(boxes, clss, track_ids):\n", - " annotator.box_label(box, color=colors(int(cls), True), label=names[int(cls)])\n", - "\n", - " # Store tracking history\n", - " track = track_history[track_id]\n", - " track.append((int((box[0] + box[2]) / 2), int((box[1] + box[3]) / 2)))\n", - " if len(track) > 30:\n", - " track.pop(0)\n", - "\n", - " # Plot tracks\n", - " points = np.array(track, dtype=np.int32).reshape((-1, 1, 2))\n", - " cv2.circle(frame, (track[-1]), 7, colors(int(cls), True), -1)\n", - " cv2.polylines(frame, [points], isClosed=False, color=colors(int(cls), True), thickness=2)\n", - "\n", - " result.write(frame)\n", - " if cv2.waitKey(1) & 0xFF == ord(\"q\"):\n", - " break\n", - " else:\n", - " break\n", - "\n", - "result.release()\n", - "cap.release()\n", - "cv2.destroyAllWindows()" - ], - "metadata": { - "id": "Cx-u59HQdu2o" - }, - "execution_count": null, - "outputs": [] - }, - { - "cell_type": "markdown", - "source": [ - "#Community Support\n", - "\n", - "For more information, you can explore Ultralytics Object Tracking Docs\n", - "\n", - "Ultralytics ⚡ resources\n", - "- About Us – https://ultralytics.com/about\n", - "- Join Our Team – https://ultralytics.com/work\n", - "- Contact Us – https://ultralytics.com/contact\n", - "- Discord – https://discord.gg/2wNGbc6g9X\n", - "- Ultralytics License – https://ultralytics.com/license\n", - "\n", - "YOLOv8 🚀 resources\n", - "- GitHub – https://github.com/ultralytics/ultralytics\n", - "- Docs – https://docs.ultralytics.com/" - ], - "metadata": { - "id": "QrlKg-y3fEyD" - } - } - ] -} diff --git a/ultralytics-main/examples/tutorial.ipynb b/ultralytics-main/examples/tutorial.ipynb deleted file mode 100644 index 51e5c8f..0000000 --- a/ultralytics-main/examples/tutorial.ipynb +++ /dev/null @@ -1,649 +0,0 @@ -{ - "nbformat": 4, - "nbformat_minor": 0, - "metadata": { - "colab": { - "name": "YOLOv8 Tutorial", - "provenance": [], - "toc_visible": true - }, - "kernelspec": { - "name": "python3", - "display_name": "Python 3" - }, - "accelerator": "GPU" - }, - "cells": [ - { - "cell_type": "markdown", - "metadata": { - "id": "t6MPjfT5NrKQ" - }, - "source": [ - "
\n", - "\n", - " \n", - " \n", - "\n", - " [中文](https://docs.ultralytics.com/zh/) | [한국어](https://docs.ultralytics.com/ko/) | [日本語](https://docs.ultralytics.com/ja/) | [Русский](https://docs.ultralytics.com/ru/) | [Deutsch](https://docs.ultralytics.com/de/) | [Français](https://docs.ultralytics.com/fr/) | [Español](https://docs.ultralytics.com/es/) | [Português](https://docs.ultralytics.com/pt/) | [हिन्दी](https://docs.ultralytics.com/hi/) | [العربية](https://docs.ultralytics.com/ar/)\n", - "\n", - " \"Run\n", - " \"Open\n", - " \"Open\n", - "\n", - "Welcome to the Ultralytics YOLOv8 🚀 notebook! YOLOv8 is the latest version of the YOLO (You Only Look Once) AI models developed by Ultralytics. This notebook serves as the starting point for exploring the various resources available to help you get started with YOLOv8 and understand its features and capabilities.\n", - "\n", - "YOLOv8 models are fast, accurate, and easy to use, making them ideal for various object detection and image segmentation tasks. They can be trained on large datasets and run on diverse hardware platforms, from CPUs to GPUs.\n", - "\n", - "We hope that the resources in this notebook will help you get the most out of YOLOv8. Please browse the YOLOv8 Docs for details, raise an issue on GitHub for support, and join our Discord community for questions and discussions!\n", - "\n", - "
" - ] - }, - { - "cell_type": "markdown", - "metadata": { - "id": "7mGmQbAO5pQb" - }, - "source": [ - "# Setup\n", - "\n", - "Pip install `ultralytics` and [dependencies](https://github.com/ultralytics/ultralytics/blob/main/pyproject.toml) and check software and hardware." - ] - }, - { - "cell_type": "code", - "metadata": { - "id": "wbvMlHd_QwMG", - "colab": { - "base_uri": "https://localhost:8080/" - }, - "outputId": "51d15672-e688-4fb8-d9d0-00d1916d3532" - }, - "source": [ - "%pip install ultralytics\n", - "import ultralytics\n", - "ultralytics.checks()" - ], - "execution_count": 1, - "outputs": [ - { - "output_type": "stream", - "name": "stdout", - "text": [ - "Ultralytics YOLOv8.1.23 🚀 Python-3.10.12 torch-2.1.0+cu121 CUDA:0 (Tesla T4, 15102MiB)\n", - "Setup complete ✅ (2 CPUs, 12.7 GB RAM, 26.3/78.2 GB disk)\n" - ] - } - ] - }, - { - "cell_type": "markdown", - "metadata": { - "id": "4JnkELT0cIJg" - }, - "source": [ - "# 1. Predict\n", - "\n", - "YOLOv8 may be used directly in the Command Line Interface (CLI) with a `yolo` command for a variety of tasks and modes and accepts additional arguments, i.e. `imgsz=640`. See a full list of available `yolo` [arguments](https://docs.ultralytics.com/usage/cfg/) and other details in the [YOLOv8 Predict Docs](https://docs.ultralytics.com/modes/train/).\n" - ] - }, - { - "cell_type": "code", - "metadata": { - "id": "zR9ZbuQCH7FX", - "colab": { - "base_uri": "https://localhost:8080/" - }, - "outputId": "37738db7-4284-47de-b3ed-b82f2431ed23" - }, - "source": [ - "# Run inference on an image with YOLOv8n\n", - "!yolo predict model=yolov8n.pt source='https://ultralytics.com/images/zidane.jpg'" - ], - "execution_count": 2, - "outputs": [ - { - "output_type": "stream", - "name": "stdout", - "text": [ - "Downloading https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8n.pt to 'yolov8n.pt'...\n", - "100% 6.23M/6.23M [00:00<00:00, 72.6MB/s]\n", - "Ultralytics YOLOv8.1.23 🚀 Python-3.10.12 torch-2.1.0+cu121 CUDA:0 (Tesla T4, 15102MiB)\n", - "YOLOv8n summary (fused): 168 layers, 3151904 parameters, 0 gradients, 8.7 GFLOPs\n", - "\n", - "Downloading https://ultralytics.com/images/zidane.jpg to 'zidane.jpg'...\n", - "100% 165k/165k [00:00<00:00, 7.05MB/s]\n", - "image 1/1 /content/zidane.jpg: 384x640 2 persons, 1 tie, 162.0ms\n", - "Speed: 13.9ms preprocess, 162.0ms inference, 1259.5ms postprocess per image at shape (1, 3, 384, 640)\n", - "Results saved to \u001b[1mruns/detect/predict\u001b[0m\n", - "💡 Learn more at https://docs.ultralytics.com/modes/predict\n" - ] - } - ] - }, - { - "cell_type": "markdown", - "metadata": { - "id": "hkAzDWJ7cWTr" - }, - "source": [ - "        \n", - "" - ] - }, - { - "cell_type": "markdown", - "metadata": { - "id": "0eq1SMWl6Sfn" - }, - "source": [ - "# 2. Val\n", - "Validate a model's accuracy on the [COCO](https://docs.ultralytics.com/datasets/detect/coco/) dataset's `val` or `test` splits. The latest YOLOv8 [models](https://github.com/ultralytics/ultralytics#models) are downloaded automatically the first time they are used. See [YOLOv8 Val Docs](https://docs.ultralytics.com/modes/val/) for more information." - ] - }, - { - "cell_type": "code", - "metadata": { - "id": "WQPtK1QYVaD_" - }, - "source": [ - "# Download COCO val\n", - "import torch\n", - "torch.hub.download_url_to_file('https://ultralytics.com/assets/coco2017val.zip', 'tmp.zip') # download (780M - 5000 images)\n", - "!unzip -q tmp.zip -d datasets && rm tmp.zip # unzip" - ], - "execution_count": null, - "outputs": [] - }, - { - "cell_type": "code", - "metadata": { - "id": "X58w8JLpMnjH", - "outputId": "61001937-ccd2-4157-a373-156a57495231", - "colab": { - "base_uri": "https://localhost:8080/" - } - }, - "source": [ - "# Validate YOLOv8n on COCO8 val\n", - "!yolo val model=yolov8n.pt data=coco8.yaml" - ], - "execution_count": 3, - "outputs": [ - { - "output_type": "stream", - "name": "stdout", - "text": [ - "Ultralytics YOLOv8.1.23 🚀 Python-3.10.12 torch-2.1.0+cu121 CUDA:0 (Tesla T4, 15102MiB)\n", - "YOLOv8n summary (fused): 168 layers, 3151904 parameters, 0 gradients, 8.7 GFLOPs\n", - "\n", - "Dataset 'coco8.yaml' images not found ⚠️, missing path '/content/datasets/coco8/images/val'\n", - "Downloading https://ultralytics.com/assets/coco8.zip to '/content/datasets/coco8.zip'...\n", - "100% 433k/433k [00:00<00:00, 12.5MB/s]\n", - "Unzipping /content/datasets/coco8.zip to /content/datasets/coco8...: 100% 25/25 [00:00<00:00, 4546.38file/s]\n", - "Dataset download success ✅ (0.9s), saved to \u001b[1m/content/datasets\u001b[0m\n", - "\n", - "Downloading https://ultralytics.com/assets/Arial.ttf to '/root/.config/Ultralytics/Arial.ttf'...\n", - "100% 755k/755k [00:00<00:00, 17.8MB/s]\n", - "\u001b[34m\u001b[1mval: \u001b[0mScanning /content/datasets/coco8/labels/val... 4 images, 0 backgrounds, 0 corrupt: 100% 4/4 [00:00<00:00, 275.94it/s]\n", - "\u001b[34m\u001b[1mval: \u001b[0mNew cache created: /content/datasets/coco8/labels/val.cache\n", - " Class Images Instances Box(P R mAP50 mAP50-95): 100% 1/1 [00:02<00:00, 2.23s/it]\n", - " all 4 17 0.621 0.833 0.888 0.63\n", - " person 4 10 0.721 0.5 0.519 0.269\n", - " dog 4 1 0.37 1 0.995 0.597\n", - " horse 4 2 0.751 1 0.995 0.631\n", - " elephant 4 2 0.505 0.5 0.828 0.394\n", - " umbrella 4 1 0.564 1 0.995 0.995\n", - " potted plant 4 1 0.814 1 0.995 0.895\n", - "Speed: 0.3ms preprocess, 56.9ms inference, 0.0ms loss, 222.8ms postprocess per image\n", - "Results saved to \u001b[1mruns/detect/val\u001b[0m\n", - "💡 Learn more at https://docs.ultralytics.com/modes/val\n" - ] - } - ] - }, - { - "cell_type": "markdown", - "metadata": { - "id": "ZY2VXXXu74w5" - }, - "source": [ - "# 3. Train\n", - "\n", - "

\n", - "\n", - "Train YOLOv8 on [Detect](https://docs.ultralytics.com/tasks/detect/), [Segment](https://docs.ultralytics.com/tasks/segment/), [Classify](https://docs.ultralytics.com/tasks/classify/) and [Pose](https://docs.ultralytics.com/tasks/pose/) datasets. See [YOLOv8 Train Docs](https://docs.ultralytics.com/modes/train/) for more information." - ] - }, - { - "cell_type": "code", - "source": [ - "#@title Select YOLOv8 🚀 logger {run: 'auto'}\n", - "logger = 'Comet' #@param ['Comet', 'TensorBoard']\n", - "\n", - "if logger == 'Comet':\n", - " %pip install -q comet_ml\n", - " import comet_ml; comet_ml.init()\n", - "elif logger == 'TensorBoard':\n", - " %load_ext tensorboard\n", - " %tensorboard --logdir ." - ], - "metadata": { - "id": "ktegpM42AooT" - }, - "execution_count": null, - "outputs": [] - }, - { - "cell_type": "code", - "metadata": { - "id": "1NcFxRcFdJ_O", - "outputId": "1ec62d53-41eb-444f-e2f7-cef5c18b9a27", - "colab": { - "base_uri": "https://localhost:8080/" - } - }, - "source": [ - "# Train YOLOv8n on COCO8 for 3 epochs\n", - "!yolo train model=yolov8n.pt data=coco8.yaml epochs=3 imgsz=640" - ], - "execution_count": 4, - "outputs": [ - { - "output_type": "stream", - "name": "stdout", - "text": [ - "Ultralytics YOLOv8.1.23 🚀 Python-3.10.12 torch-2.1.0+cu121 CUDA:0 (Tesla T4, 15102MiB)\n", - "\u001b[34m\u001b[1mengine/trainer: \u001b[0mtask=detect, mode=train, model=yolov8n.pt, data=coco8.yaml, epochs=3, time=None, patience=100, batch=16, imgsz=640, save=True, save_period=-1, cache=False, device=None, workers=8, project=None, name=train, exist_ok=False, pretrained=True, optimizer=auto, verbose=True, seed=0, deterministic=True, single_cls=False, rect=False, cos_lr=False, close_mosaic=10, resume=False, amp=True, fraction=1.0, profile=False, freeze=None, multi_scale=False, overlap_mask=True, mask_ratio=4, dropout=0.0, val=True, split=val, save_json=False, save_hybrid=False, conf=None, iou=0.7, max_det=300, half=False, dnn=False, plots=True, source=None, vid_stride=1, stream_buffer=False, visualize=False, augment=False, agnostic_nms=False, classes=None, retina_masks=False, embed=None, show=False, save_frames=False, save_txt=False, save_conf=False, save_crop=False, show_labels=True, show_conf=True, show_boxes=True, line_width=None, format=torchscript, keras=False, optimize=False, int8=False, dynamic=False, simplify=False, opset=None, workspace=4, nms=False, lr0=0.01, lrf=0.01, momentum=0.937, weight_decay=0.0005, warmup_epochs=3.0, warmup_momentum=0.8, warmup_bias_lr=0.1, box=7.5, cls=0.5, dfl=1.5, pose=12.0, kobj=1.0, label_smoothing=0.0, nbs=64, hsv_h=0.015, hsv_s=0.7, hsv_v=0.4, degrees=0.0, translate=0.1, scale=0.5, shear=0.0, perspective=0.0, flipud=0.0, fliplr=0.5, mosaic=1.0, mixup=0.0, copy_paste=0.0, auto_augment=randaugment, erasing=0.4, crop_fraction=1.0, cfg=None, tracker=botsort.yaml, save_dir=runs/detect/train\n", - "\n", - " from n params module arguments \n", - " 0 -1 1 464 ultralytics.nn.modules.conv.Conv [3, 16, 3, 2] \n", - " 1 -1 1 4672 ultralytics.nn.modules.conv.Conv [16, 32, 3, 2] \n", - " 2 -1 1 7360 ultralytics.nn.modules.block.C2f [32, 32, 1, True] \n", - " 3 -1 1 18560 ultralytics.nn.modules.conv.Conv [32, 64, 3, 2] \n", - " 4 -1 2 49664 ultralytics.nn.modules.block.C2f [64, 64, 2, True] \n", - " 5 -1 1 73984 ultralytics.nn.modules.conv.Conv [64, 128, 3, 2] \n", - " 6 -1 2 197632 ultralytics.nn.modules.block.C2f [128, 128, 2, True] \n", - " 7 -1 1 295424 ultralytics.nn.modules.conv.Conv [128, 256, 3, 2] \n", - " 8 -1 1 460288 ultralytics.nn.modules.block.C2f [256, 256, 1, True] \n", - " 9 -1 1 164608 ultralytics.nn.modules.block.SPPF [256, 256, 5] \n", - " 10 -1 1 0 torch.nn.modules.upsampling.Upsample [None, 2, 'nearest'] \n", - " 11 [-1, 6] 1 0 ultralytics.nn.modules.conv.Concat [1] \n", - " 12 -1 1 148224 ultralytics.nn.modules.block.C2f [384, 128, 1] \n", - " 13 -1 1 0 torch.nn.modules.upsampling.Upsample [None, 2, 'nearest'] \n", - " 14 [-1, 4] 1 0 ultralytics.nn.modules.conv.Concat [1] \n", - " 15 -1 1 37248 ultralytics.nn.modules.block.C2f [192, 64, 1] \n", - " 16 -1 1 36992 ultralytics.nn.modules.conv.Conv [64, 64, 3, 2] \n", - " 17 [-1, 12] 1 0 ultralytics.nn.modules.conv.Concat [1] \n", - " 18 -1 1 123648 ultralytics.nn.modules.block.C2f [192, 128, 1] \n", - " 19 -1 1 147712 ultralytics.nn.modules.conv.Conv [128, 128, 3, 2] \n", - " 20 [-1, 9] 1 0 ultralytics.nn.modules.conv.Concat [1] \n", - " 21 -1 1 493056 ultralytics.nn.modules.block.C2f [384, 256, 1] \n", - " 22 [15, 18, 21] 1 897664 ultralytics.nn.modules.head.Detect [80, [64, 128, 256]] \n", - "Model summary: 225 layers, 3157200 parameters, 3157184 gradients, 8.9 GFLOPs\n", - "\n", - "Transferred 355/355 items from pretrained weights\n", - "\u001b[34m\u001b[1mTensorBoard: \u001b[0mStart with 'tensorboard --logdir runs/detect/train', view at http://localhost:6006/\n", - "Freezing layer 'model.22.dfl.conv.weight'\n", - "\u001b[34m\u001b[1mAMP: \u001b[0mrunning Automatic Mixed Precision (AMP) checks with YOLOv8n...\n", - "\u001b[34m\u001b[1mAMP: \u001b[0mchecks passed ✅\n", - "\u001b[34m\u001b[1mtrain: \u001b[0mScanning /content/datasets/coco8/labels/train... 4 images, 0 backgrounds, 0 corrupt: 100% 4/4 [00:00<00:00, 43351.98it/s]\n", - "\u001b[34m\u001b[1mtrain: \u001b[0mNew cache created: /content/datasets/coco8/labels/train.cache\n", - "\u001b[34m\u001b[1malbumentations: \u001b[0mBlur(p=0.01, blur_limit=(3, 7)), MedianBlur(p=0.01, blur_limit=(3, 7)), ToGray(p=0.01), CLAHE(p=0.01, clip_limit=(1, 4.0), tile_grid_size=(8, 8))\n", - "\u001b[34m\u001b[1mval: \u001b[0mScanning /content/datasets/coco8/labels/val.cache... 4 images, 0 backgrounds, 0 corrupt: 100% 4/4 [00:00\n" - ], - "metadata": { - "id": "Phm9ccmOKye5" - } - }, - { - "cell_type": "markdown", - "source": [ - "## 1. Detection\n", - "\n", - "YOLOv8 _detection_ models have no suffix and are the default YOLOv8 models, i.e. `yolov8n.pt` and are pretrained on COCO. See [Detection Docs](https://docs.ultralytics.com/tasks/detect/) for full details.\n" - ], - "metadata": { - "id": "yq26lwpYK1lq" - } - }, - { - "cell_type": "code", - "source": [ - "# Load YOLOv8n, train it on COCO128 for 3 epochs and predict an image with it\n", - "from ultralytics import YOLO\n", - "\n", - "model = YOLO('yolov8n.pt') # load a pretrained YOLOv8n detection model\n", - "model.train(data='coco128.yaml', epochs=3) # train the model\n", - "model('https://ultralytics.com/images/bus.jpg') # predict on an image" - ], - "metadata": { - "id": "8Go5qqS9LbC5" - }, - "execution_count": null, - "outputs": [] - }, - { - "cell_type": "markdown", - "source": [ - "## 2. Segmentation\n", - "\n", - "YOLOv8 _segmentation_ models use the `-seg` suffix, i.e. `yolov8n-seg.pt` and are pretrained on COCO. See [Segmentation Docs](https://docs.ultralytics.com/tasks/segment/) for full details.\n" - ], - "metadata": { - "id": "7ZW58jUzK66B" - } - }, - { - "cell_type": "code", - "source": [ - "# Load YOLOv8n-seg, train it on COCO128-seg for 3 epochs and predict an image with it\n", - "from ultralytics import YOLO\n", - "\n", - "model = YOLO('yolov8n-seg.pt') # load a pretrained YOLOv8n segmentation model\n", - "model.train(data='coco128-seg.yaml', epochs=3) # train the model\n", - "model('https://ultralytics.com/images/bus.jpg') # predict on an image" - ], - "metadata": { - "id": "WFPJIQl_L5HT" - }, - "execution_count": null, - "outputs": [] - }, - { - "cell_type": "markdown", - "source": [ - "## 3. Classification\n", - "\n", - "YOLOv8 _classification_ models use the `-cls` suffix, i.e. `yolov8n-cls.pt` and are pretrained on ImageNet. See [Classification Docs](https://docs.ultralytics.com/tasks/classify/) for full details.\n" - ], - "metadata": { - "id": "ax3p94VNK9zR" - } - }, - { - "cell_type": "code", - "source": [ - "# Load YOLOv8n-cls, train it on mnist160 for 3 epochs and predict an image with it\n", - "from ultralytics import YOLO\n", - "\n", - "model = YOLO('yolov8n-cls.pt') # load a pretrained YOLOv8n classification model\n", - "model.train(data='mnist160', epochs=3) # train the model\n", - "model('https://ultralytics.com/images/bus.jpg') # predict on an image" - ], - "metadata": { - "id": "5q9Zu6zlL5rS" - }, - "execution_count": null, - "outputs": [] - }, - { - "cell_type": "markdown", - "source": [ - "## 4. Pose\n", - "\n", - "YOLOv8 _pose_ models use the `-pose` suffix, i.e. `yolov8n-pose.pt` and are pretrained on COCO Keypoints. See [Pose Docs](https://docs.ultralytics.com/tasks/pose/) for full details." - ], - "metadata": { - "id": "SpIaFLiO11TG" - } - }, - { - "cell_type": "code", - "source": [ - "# Load YOLOv8n-pose, train it on COCO8-pose for 3 epochs and predict an image with it\n", - "from ultralytics import YOLO\n", - "\n", - "model = YOLO('yolov8n-pose.pt') # load a pretrained YOLOv8n pose model\n", - "model.train(data='coco8-pose.yaml', epochs=3) # train the model\n", - "model('https://ultralytics.com/images/bus.jpg') # predict on an image" - ], - "metadata": { - "id": "si4aKFNg19vX" - }, - "execution_count": null, - "outputs": [] - }, - { - "cell_type": "markdown", - "source": [ - "## 4. Oriented Bounding Boxes (OBB)\n", - "\n", - "YOLOv8 _OBB_ models use the `-obb` suffix, i.e. `yolov8n-obb.pt` and are pretrained on the DOTA dataset. See [OBB Docs](https://docs.ultralytics.com/tasks/obb/) for full details." - ], - "metadata": { - "id": "cf5j_T9-B5F0" - } - }, - { - "cell_type": "code", - "source": [ - "# Load YOLOv8n-obb, train it on DOTA8 for 3 epochs and predict an image with it\n", - "from ultralytics import YOLO\n", - "\n", - "model = YOLO('yolov8n-obb.pt') # load a pretrained YOLOv8n OBB model\n", - "model.train(data='coco8-dota.yaml', epochs=3) # train the model\n", - "model('https://ultralytics.com/images/bus.jpg') # predict on an image" - ], - "metadata": { - "id": "IJNKClOOB5YS" - }, - "execution_count": null, - "outputs": [] - }, - { - "cell_type": "markdown", - "metadata": { - "id": "IEijrePND_2I" - }, - "source": [ - "# Appendix\n", - "\n", - "Additional content below." - ] - }, - { - "cell_type": "code", - "source": [ - "# Pip install from source\n", - "!pip install git+https://github.com/ultralytics/ultralytics@main" - ], - "metadata": { - "id": "pIdE6i8C3LYp" - }, - "execution_count": null, - "outputs": [] - }, - { - "cell_type": "code", - "source": [ - "# Git clone and run tests on updates branch\n", - "!git clone https://github.com/ultralytics/ultralytics -b main\n", - "%pip install -qe ultralytics" - ], - "metadata": { - "id": "uRKlwxSJdhd1" - }, - "execution_count": null, - "outputs": [] - }, - { - "cell_type": "code", - "source": [ - "# Run tests (Git clone only)\n", - "!pytest ultralytics/tests" - ], - "metadata": { - "id": "GtPlh7mcCGZX" - }, - "execution_count": null, - "outputs": [] - }, - { - "cell_type": "code", - "source": [ - "# Validate multiple models\n", - "for x in 'nsmlx':\n", - " !yolo val model=yolov8{x}.pt data=coco.yaml" - ], - "metadata": { - "id": "Wdc6t_bfzDDk" - }, - "execution_count": null, - "outputs": [] - } - ] -} diff --git a/ultralytics-main/main.py b/ultralytics-main/main.py deleted file mode 100644 index a58649a..0000000 --- a/ultralytics-main/main.py +++ /dev/null @@ -1,56 +0,0 @@ -from ultralytics import YOLO -import cv2 -import os -from ultralytics.utils.plotting import Annotator, colors -if __name__ == '__main__': - # Load a model - # 直接使用预训练模型创建模型 - # model = YOLO('yolov8n.pt') - # model.train(**{'cfg':'ultralytics/cfg/default.yaml', 'data':'ultralytics/models/yolo/detect/mydata/traffic.yaml'}, epochs=10, imgsz=640, batch=32) - - - - # #使用yaml配置文件来创建模型，并导入预训练权重 - #model = YOLO('ultralytics/cfg/models/v8/yolov8n.yaml') # build a new model from YAML - #model.load('yolov8n.pt') - #model.train(**{'cfg': 'ultralytics/cfg/default.yaml', 'data': 'ultralytics/models/yolo/detect/mydata/traffic.yaml'}, - # epochs=10, imgsz=640, batch=32, name='train') # name：是此次训练结果保存的文件夹 数据集是我自己的数据集 - -# # # 模型验证：用验证集 -# model = YOLO('runs/detect/train/weights/best.pt') -# model.val(**{'data':'ultralytics/models/yolo/detect/mydata/traffic.yaml', 'name':'val', 'batch':32}) #模型验证用验证集 -# model.val(**{'data':'ultralytics/models/yolo/detect/mydata/traffic.yaml', 'split':'test', 'iou':0.9}) #模型验证用测试集 - -# # 推理： - '''model = YOLO('yolov8n.pt') - model.predict(source='ultralytics/assets', show=True, save=True)''' - # model.predict(source='ultralytics/assets', name='predict', **{'save':True}) # 写法二 - - # 分割： - model = YOLO('yolov8n-seg.pt') - model.predict(source='ultralytics/assets', show=True, save=True, classes=[2]) - - # 跟踪： - '''model = YOLO('yolov8n.pt') - model.track(source="ultralytics/assets", show=True, save=True)''' - - # 姿态估计： - '''model = YOLO('yolov8n-pose.pt') - model.predict(source="ultralytics/assets", show=True, save=True)''' - - # 检测、跟踪、分割： - '''model = YOLO('yolov8n-seg.pt') # 加载一个官方的分割模型 - model.track(source="ultralytics/assets", show=True, save=True)''' - - # 检测、跟踪、姿态估计： - '''model = YOLO('yolov8n-pose.pt') # 加载一个官方的分割模型 - model.track(source="ultralytics/assets", show=True, save=True)''' - #results = model.track(source="ultralytics/assets", show=True, tracker="bytetrack.yaml") # 使用ByteTrack追踪器进行追踪 （写法二） - - # model = YOLO('ultralytics/cfg/models/v8/yolov8n.yaml').load('yolov8n.pt') - # # Train the model - # model.train(data='ultralytics/cfg/datasets/coco.yaml', epochs=100, imgsz=640, save_period=5, device='cpu',batch=2) - '''model = YOLO('best.pt') - model.predict(source='ultralytics/assets', show=True, save=True)''' - - diff --git a/ultralytics-main/mkdocs.yml b/ultralytics-main/mkdocs.yml deleted file mode 100644 index e66b6a5..0000000 --- a/ultralytics-main/mkdocs.yml +++ /dev/null @@ -1,675 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -site_name: Ultralytics YOLOv8 Docs -site_description: Explore Ultralytics YOLOv8, a cutting-edge real-time object detection and image segmentation model for various applications and hardware platforms. -site_url: https://docs.ultralytics.com -site_author: Ultralytics -repo_url: https://github.com/ultralytics/ultralytics -edit_uri: https://github.com/ultralytics/ultralytics/tree/main/docs/en/ -repo_name: ultralytics/ultralytics -remote_name: https://github.com/ultralytics/docs -docs_dir: "docs/en/" # where to find the markdown files -site_dir: "site/" # where to publish to - -theme: - name: material - language: en - custom_dir: docs/overrides/ - logo: https://github.com/ultralytics/assets/raw/main/logo/Ultralytics_Logotype_Reverse.svg - favicon: assets/favicon.ico - icon: - repo: fontawesome/brands/github - # font: # disabled for faster page load times - # text: Helvetica - # code: Roboto Mono - palette: - - media: "(prefers-color-scheme)" - toggle: - icon: material/brightness-auto - name: Switch to light mode - - media: "(prefers-color-scheme: dark)" - scheme: slate - primary: black - accent: indigo - toggle: - icon: material/brightness-4 - name: Switch to system preference - - media: "(prefers-color-scheme: light)" - scheme: default - primary: indigo - accent: indigo - toggle: - icon: material/brightness-7 - name: Switch to dark mode - features: - # - announce.dismiss - - content.action.edit - - content.code.annotate - - content.code.copy - - content.tooltips - - search.highlight - - search.share - - search.suggest - - toc.follow - - navigation.top - - navigation.tabs - - navigation.tabs.sticky - - navigation.prune - - navigation.footer - - navigation.tracking - - navigation.instant - - navigation.instant.progress - - navigation.indexes - - navigation.sections # navigation.expand or navigation.sections - - content.tabs.link # all code tabs change simultaneously - -# Customization -copyright: © 2024 Ultralytics Inc. All rights reserved. -extra: # version: - # provider: mike # version drop-down menu - robots: robots.txt - analytics: - provider: google - property: G-2M5EHKC0BH - # alternate: # language drop-down - # - name: 🇬🇧 English - # link: / - # lang: en - # - name: 🇨🇳 简体中文 - # link: /zh/ - # lang: zh - # - name: 🇰🇷 한국어 - # link: /ko/ - # lang: ko - # - name: 🇯🇵 日本語 - # link: /ja/ - # lang: ja - # - name: 🇷🇺 Русский - # link: /ru/ - # lang: ru - # - name: 🇩🇪 Deutsch - # link: /de/ - # lang: de - # - name: 🇫🇷 Français - # link: /fr/ - # lang: fr - # - name: 🇪🇸 Español - # link: /es/ - # lang: es - # - name: 🇵🇹 Português - # link: /pt/ - # lang: pt - # - name: 🇮🇳 हिन्दी - # link: /hi/ - # lang: hi - # - name: 🇸🇦 العربية - # link: /ar/ - # lang: ar - social: - - icon: fontawesome/brands/github - link: https://github.com/ultralytics - - icon: fontawesome/brands/linkedin - link: https://www.linkedin.com/company/ultralytics/ - - icon: fontawesome/brands/x-twitter - link: https://twitter.com/ultralytics - - icon: fontawesome/brands/youtube - link: https://www.youtube.com/ultralytics - - icon: fontawesome/brands/docker - link: https://hub.docker.com/r/ultralytics/ultralytics/ - - icon: fontawesome/brands/python - link: https://pypi.org/project/ultralytics/ - - icon: fontawesome/brands/discord - link: https://ultralytics.com/discord - -extra_css: - - stylesheets/style.css -extra_javascript: - - javascript/extra.js - -markdown_extensions: - - admonition - - md_in_html - - tables - - attr_list - - def_list - - pymdownx.critic - - pymdownx.caret - - pymdownx.keys - - pymdownx.mark - - pymdownx.tilde - - pymdownx.details - - pymdownx.superfences - - pymdownx.inlinehilite - - pymdownx.highlight: - anchor_linenums: true - - pymdownx.snippets: - base_path: ./ - - pymdownx.emoji: - emoji_index: !!python/name:material.extensions.emoji.twemoji - emoji_generator: !!python/name:material.extensions.emoji.to_svg - - pymdownx.tabbed: - alternate_style: true - -# Primary navigation --------------------------------------------------------------------------------------------------- -nav: - - Home: - - Home: index.md - - Quickstart: quickstart.md - - Modes: - - modes/index.md - - Train: modes/train.md - - Val: modes/val.md - - Predict: modes/predict.md - - Export: modes/export.md - - Track: modes/track.md - - Benchmark: modes/benchmark.md - - Tasks: - - tasks/index.md - - Detect: tasks/detect.md - - Segment: tasks/segment.md - - Classify: tasks/classify.md - - Pose: tasks/pose.md - - OBB: tasks/obb.md - - Models: - - models/index.md - - Datasets: - - datasets/index.md - - Guides: - - guides/index.md - - NEW 🚀 Explorer: - - datasets/explorer/index.md - - Languages: - - 🇬🇧  English: https://ultralytics.com/docs/ - - 🇨🇳  简体中文: https://docs.ultralytics.com/zh/ - - 🇰🇷  한국어: https://docs.ultralytics.com/ko/ - - 🇯🇵  日本語: https://docs.ultralytics.com/ja/ - - 🇷🇺  Русский: https://docs.ultralytics.com/ru/ - - 🇩🇪  Deutsch: https://docs.ultralytics.com/de/ - - 🇫🇷  Français: https://docs.ultralytics.com/fr/ - - 🇪🇸  Español: https://docs.ultralytics.com/es/ - - 🇵🇹  Português: https://docs.ultralytics.com/pt/ - - 🇮🇳  हिन्दी: https://docs.ultralytics.com/hi/ - - 🇸🇦  العربية: https://docs.ultralytics.com/ar/ - - Quickstart: - - quickstart.md - - Usage: - - CLI: usage/cli.md - - Python: usage/python.md - - Callbacks: usage/callbacks.md - - Configuration: usage/cfg.md - - Simple Utilities: usage/simple-utilities.md - - Advanced Customization: usage/engine.md - - Modes: - - modes/index.md - - Train: modes/train.md - - Val: modes/val.md - - Predict: modes/predict.md - - Export: modes/export.md - - Track: modes/track.md - - Benchmark: modes/benchmark.md - - Tasks: - - tasks/index.md - - Detect: tasks/detect.md - - Segment: tasks/segment.md - - Classify: tasks/classify.md - - Pose: tasks/pose.md - - OBB: tasks/obb.md - - Models: - - models/index.md - - YOLOv3: models/yolov3.md - - YOLOv4: models/yolov4.md - - YOLOv5: models/yolov5.md - - YOLOv6: models/yolov6.md - - YOLOv7: models/yolov7.md - - YOLOv8: models/yolov8.md - - YOLOv9: models/yolov9.md - - SAM (Segment Anything Model): models/sam.md - - MobileSAM (Mobile Segment Anything Model): models/mobile-sam.md - - FastSAM (Fast Segment Anything Model): models/fast-sam.md - - YOLO-NAS (Neural Architecture Search): models/yolo-nas.md - - RT-DETR (Realtime Detection Transformer): models/rtdetr.md - - YOLO-World (Real-Time Open-Vocabulary Object Detection): models/yolo-world.md - - Datasets: - - datasets/index.md - - NEW 🚀 Explorer: - - datasets/explorer/index.md - - Explorer API: datasets/explorer/api.md - - Explorer Dashboard: datasets/explorer/dashboard.md - - VOC Exploration Example: datasets/explorer/explorer.ipynb - - Detection: - - datasets/detect/index.md - - Argoverse: datasets/detect/argoverse.md - - COCO: datasets/detect/coco.md - - COCO8: datasets/detect/coco8.md - - GlobalWheat2020: datasets/detect/globalwheat2020.md - - Objects365: datasets/detect/objects365.md - - OpenImagesV7: datasets/detect/open-images-v7.md - - SKU-110K: datasets/detect/sku-110k.md - - VisDrone: datasets/detect/visdrone.md - - VOC: datasets/detect/voc.md - - xView: datasets/detect/xview.md - - Roboflow 100: datasets/detect/roboflow-100.md - - Brain-tumor: datasets/detect/brain-tumor.md - - Segmentation: - - datasets/segment/index.md - - COCO: datasets/segment/coco.md - - COCO8-seg: datasets/segment/coco8-seg.md - - Crack-seg: datasets/segment/crack-seg.md - - Carparts-seg: datasets/segment/carparts-seg.md - - Package-seg: datasets/segment/package-seg.md - - Pose: - - datasets/pose/index.md - - COCO: datasets/pose/coco.md - - COCO8-pose: datasets/pose/coco8-pose.md - - Tiger-pose: datasets/pose/tiger-pose.md - - Classification: - - datasets/classify/index.md - - Caltech 101: datasets/classify/caltech101.md - - Caltech 256: datasets/classify/caltech256.md - - CIFAR-10: datasets/classify/cifar10.md - - CIFAR-100: datasets/classify/cifar100.md - - Fashion-MNIST: datasets/classify/fashion-mnist.md - - ImageNet: datasets/classify/imagenet.md - - ImageNet-10: datasets/classify/imagenet10.md - - Imagenette: datasets/classify/imagenette.md - - Imagewoof: datasets/classify/imagewoof.md - - MNIST: datasets/classify/mnist.md - - Oriented Bounding Boxes (OBB): - - datasets/obb/index.md - - DOTAv2: datasets/obb/dota-v2.md - - DOTA8: datasets/obb/dota8.md - - Multi-Object Tracking: - - datasets/track/index.md - - NEW 🚀 Explorer: - - datasets/explorer/index.md - - Explorer API: datasets/explorer/api.md - - Explorer Dashboard Demo: datasets/explorer/dashboard.md - - VOC Exploration Example: datasets/explorer/explorer.ipynb - - Guides: - - guides/index.md - - YOLO Common Issues: guides/yolo-common-issues.md - - YOLO Performance Metrics: guides/yolo-performance-metrics.md - - YOLO Thread-Safe Inference: guides/yolo-thread-safe-inference.md - - Model Deployment Options: guides/model-deployment-options.md - - K-Fold Cross Validation: guides/kfold-cross-validation.md - - Hyperparameter Tuning: guides/hyperparameter-tuning.md - - SAHI Tiled Inference: guides/sahi-tiled-inference.md - - AzureML Quickstart: guides/azureml-quickstart.md - - Conda Quickstart: guides/conda-quickstart.md - - Docker Quickstart: guides/docker-quickstart.md - - Raspberry Pi: guides/raspberry-pi.md - - Triton Inference Server: guides/triton-inference-server.md - - Isolating Segmentation Objects: guides/isolating-segmentation-objects.md - - Edge TPU on Raspberry Pi: guides/coral-edge-tpu-on-raspberry-pi.md - - Viewing Inference Images in a Terminal: guides/view-results-in-terminal.md - - OpenVINO Latency vs Throughput modes: guides/optimizing-openvino-latency-vs-throughput-modes.md - - Real-World Projects: - - Object Counting: guides/object-counting.md - - Object Cropping: guides/object-cropping.md - - Object Blurring: guides/object-blurring.md - - Workouts Monitoring: guides/workouts-monitoring.md - - Objects Counting in Regions: guides/region-counting.md - - Security Alarm System: guides/security-alarm-system.md - - Heatmaps: guides/heatmaps.md - - Instance Segmentation with Object Tracking: guides/instance-segmentation-and-tracking.md - - VisionEye Mapping: guides/vision-eye.md - - Speed Estimation: guides/speed-estimation.md - - Distance Calculation: guides/distance-calculation.md - - YOLOv5: - - yolov5/index.md - - Quickstart: yolov5/quickstart_tutorial.md - - Environments: - - Amazon Web Services (AWS): yolov5/environments/aws_quickstart_tutorial.md - - Google Cloud (GCP): yolov5/environments/google_cloud_quickstart_tutorial.md - - AzureML: yolov5/environments/azureml_quickstart_tutorial.md - - Docker Image: yolov5/environments/docker_image_quickstart_tutorial.md - - Tutorials: - - Train Custom Data: yolov5/tutorials/train_custom_data.md - - Tips for Best Training Results: yolov5/tutorials/tips_for_best_training_results.md - - Multi-GPU Training: yolov5/tutorials/multi_gpu_training.md - - PyTorch Hub: yolov5/tutorials/pytorch_hub_model_loading.md - - TFLite, ONNX, CoreML, TensorRT Export: yolov5/tutorials/model_export.md - - NVIDIA Jetson Nano Deployment: yolov5/tutorials/running_on_jetson_nano.md - - Test-Time Augmentation (TTA): yolov5/tutorials/test_time_augmentation.md - - Model Ensembling: yolov5/tutorials/model_ensembling.md - - Pruning/Sparsity Tutorial: yolov5/tutorials/model_pruning_and_sparsity.md - - Hyperparameter evolution: yolov5/tutorials/hyperparameter_evolution.md - - Transfer learning with frozen layers: yolov5/tutorials/transfer_learning_with_frozen_layers.md - - Architecture Summary: yolov5/tutorials/architecture_description.md - - Roboflow Datasets: yolov5/tutorials/roboflow_datasets_integration.md - - Neural Magic's DeepSparse: yolov5/tutorials/neural_magic_pruning_quantization.md - - Comet Logging: yolov5/tutorials/comet_logging_integration.md - - Clearml Logging: yolov5/tutorials/clearml_logging_integration.md - - Integrations: - - integrations/index.md - - TorchScript: integrations/torchscript.md - - ONNX: integrations/onnx.md - - OpenVINO: integrations/openvino.md - - TensorRT: integrations/tensorrt.md - - CoreML: integrations/coreml.md - - TFLite: integrations/tflite.md - - TFLite Edge TPU: integrations/edge-tpu.md - - PaddlePaddle: integrations/paddlepaddle.md - - NCNN: integrations/ncnn.md - - Comet ML: integrations/comet.md - - Ray Tune: integrations/ray-tune.md - - Roboflow: integrations/roboflow.md - - MLflow: integrations/mlflow.md - - ClearML: integrations/clearml.md - - DVC: integrations/dvc.md - - Weights & Biases: integrations/weights-biases.md - - Neural Magic: integrations/neural-magic.md - - Gradio: integrations/gradio.md - - TensorBoard: integrations/tensorboard.md - - Amazon SageMaker: integrations/amazon-sagemaker.md - - HUB: - - Cloud: - - hub/index.md - - Quickstart: hub/quickstart.md - - Datasets: hub/datasets.md - - Projects: hub/projects.md - - Models: hub/models.md - - Cloud Training: hub/cloud-training.md - - Integrations: hub/integrations.md - - Inference API: hub/inference-api.md - - On-Premise: - - hub/on-premise/index.md - - App: - - hub/app/index.md - - iOS: hub/app/ios.md - - Android: hub/app/android.md - - Python SDK: - - hub/sdk/index.md - - Quickstart: hub/sdk/quickstart.md - - Model: hub/sdk/model.md - - Dataset: hub/sdk/dataset.md - - Project: hub/sdk/project.md - - Reference: - - base: - - api_client: hub/sdk/reference/base/api_client.md - - auth: hub/sdk/reference/base/auth.md - - crud_client: hub/sdk/reference/base/crud_client.md - - paginated_list: hub/sdk/reference/base/paginated_list.md - - server_clients: hub/sdk/reference/base/server_clients.md - - helpers: - - error_handler: hub/sdk/reference/helpers/error_handler.md - - exceptions: hub/sdk/reference/helpers/exceptions.md - - logger: hub/sdk/reference/helpers/logger.md - - utils: hub/sdk/reference/helpers/utils.md - - hub_client: hub/sdk/reference/hub_client.md - - modules: - - datasets: hub/sdk/reference/modules/datasets.md - - models: hub/sdk/reference/modules/models.md - - projects: hub/sdk/reference/modules/projects.md - - teams: hub/sdk/reference/modules/teams.md - - users: hub/sdk/reference/modules/users.md - - REST API: - - hub/api/index.md - - - Reference: - - cfg: - - __init__: reference/cfg/__init__.md - - data: - - annotator: reference/data/annotator.md - - augment: reference/data/augment.md - - base: reference/data/base.md - - build: reference/data/build.md - - converter: reference/data/converter.md - - dataset: reference/data/dataset.md - - explorer: - - explorer: reference/data/explorer/explorer.md - - gui: - - dash: reference/data/explorer/gui/dash.md - - utils: reference/data/explorer/utils.md - - loaders: reference/data/loaders.md - - split_dota: reference/data/split_dota.md - - utils: reference/data/utils.md - - engine: - - exporter: reference/engine/exporter.md - - model: reference/engine/model.md - - predictor: reference/engine/predictor.md - - results: reference/engine/results.md - - trainer: reference/engine/trainer.md - - tuner: reference/engine/tuner.md - - validator: reference/engine/validator.md - - hub: - - __init__: reference/hub/__init__.md - - auth: reference/hub/auth.md - - session: reference/hub/session.md - - utils: reference/hub/utils.md - - models: - - fastsam: - - model: reference/models/fastsam/model.md - - predict: reference/models/fastsam/predict.md - - prompt: reference/models/fastsam/prompt.md - - utils: reference/models/fastsam/utils.md - - val: reference/models/fastsam/val.md - - nas: - - model: reference/models/nas/model.md - - predict: reference/models/nas/predict.md - - val: reference/models/nas/val.md - - rtdetr: - - model: reference/models/rtdetr/model.md - - predict: reference/models/rtdetr/predict.md - - train: reference/models/rtdetr/train.md - - val: reference/models/rtdetr/val.md - - sam: - - amg: reference/models/sam/amg.md - - build: reference/models/sam/build.md - - model: reference/models/sam/model.md - - modules: - - decoders: reference/models/sam/modules/decoders.md - - encoders: reference/models/sam/modules/encoders.md - - sam: reference/models/sam/modules/sam.md - - tiny_encoder: reference/models/sam/modules/tiny_encoder.md - - transformer: reference/models/sam/modules/transformer.md - - predict: reference/models/sam/predict.md - - utils: - - loss: reference/models/utils/loss.md - - ops: reference/models/utils/ops.md - - yolo: - - classify: - - predict: reference/models/yolo/classify/predict.md - - train: reference/models/yolo/classify/train.md - - val: reference/models/yolo/classify/val.md - - detect: - - predict: reference/models/yolo/detect/predict.md - - train: reference/models/yolo/detect/train.md - - val: reference/models/yolo/detect/val.md - - model: reference/models/yolo/model.md - - obb: - - predict: reference/models/yolo/obb/predict.md - - train: reference/models/yolo/obb/train.md - - val: reference/models/yolo/obb/val.md - - pose: - - predict: reference/models/yolo/pose/predict.md - - train: reference/models/yolo/pose/train.md - - val: reference/models/yolo/pose/val.md - - segment: - - predict: reference/models/yolo/segment/predict.md - - train: reference/models/yolo/segment/train.md - - val: reference/models/yolo/segment/val.md - - nn: - - autobackend: reference/nn/autobackend.md - - modules: - - block: reference/nn/modules/block.md - - conv: reference/nn/modules/conv.md - - head: reference/nn/modules/head.md - - transformer: reference/nn/modules/transformer.md - - utils: reference/nn/modules/utils.md - - tasks: reference/nn/tasks.md - - solutions: - - ai_gym: reference/solutions/ai_gym.md - - distance_calculation: reference/solutions/distance_calculation.md - - heatmap: reference/solutions/heatmap.md - - object_counter: reference/solutions/object_counter.md - - speed_estimation: reference/solutions/speed_estimation.md - - trackers: - - basetrack: reference/trackers/basetrack.md - - bot_sort: reference/trackers/bot_sort.md - - byte_tracker: reference/trackers/byte_tracker.md - - track: reference/trackers/track.md - - utils: - - gmc: reference/trackers/utils/gmc.md - - kalman_filter: reference/trackers/utils/kalman_filter.md - - matching: reference/trackers/utils/matching.md - - utils: - - __init__: reference/utils/__init__.md - - autobatch: reference/utils/autobatch.md - - benchmarks: reference/utils/benchmarks.md - - callbacks: - - base: reference/utils/callbacks/base.md - - clearml: reference/utils/callbacks/clearml.md - - comet: reference/utils/callbacks/comet.md - - dvc: reference/utils/callbacks/dvc.md - - hub: reference/utils/callbacks/hub.md - - mlflow: reference/utils/callbacks/mlflow.md - - neptune: reference/utils/callbacks/neptune.md - - raytune: reference/utils/callbacks/raytune.md - - tensorboard: reference/utils/callbacks/tensorboard.md - - wb: reference/utils/callbacks/wb.md - - checks: reference/utils/checks.md - - dist: reference/utils/dist.md - - downloads: reference/utils/downloads.md - - errors: reference/utils/errors.md - - files: reference/utils/files.md - - instance: reference/utils/instance.md - - loss: reference/utils/loss.md - - metrics: reference/utils/metrics.md - - ops: reference/utils/ops.md - - patches: reference/utils/patches.md - - plotting: reference/utils/plotting.md - - tal: reference/utils/tal.md - - torch_utils: reference/utils/torch_utils.md - - triton: reference/utils/triton.md - - tuner: reference/utils/tuner.md - - - Help: - - Help: help/index.md - - Frequently Asked Questions (FAQ): help/FAQ.md - - Contributing Guide: help/contributing.md - - Continuous Integration (CI) Guide: help/CI.md - - Contributor License Agreement (CLA): help/CLA.md - - Minimum Reproducible Example (MRE) Guide: help/minimum_reproducible_example.md - - Code of Conduct: help/code_of_conduct.md - - Environmental, Health and Safety (EHS) Policy: help/environmental-health-safety.md - - Security Policy: help/security.md - - Privacy Policy: help/privacy.md - -# Plugins including 301 redirects navigation --------------------------------------------------------------------------- -plugins: - - search: - lang: en - - mkdocstrings: - enabled: true - default_handler: python - handlers: - python: - options: - docstring_style: google - show_root_heading: true - show_source: true - - ultralytics: - add_desc: False - add_image: True - add_authors: True - add_json_ld: True - add_share_buttons: True - default_image: https://github.com/ultralytics/assets/blob/main/yolov8/banner-yolov8.png - - mkdocs-jupyter - - redirects: - redirect_maps: - callbacks.md: usage/callbacks.md - cfg.md: usage/cfg.md - cli.md: usage/cli.md - config.md: usage/cfg.md - engine.md: usage/engine.md - environments/AWS-Quickstart.md: yolov5/environments/aws_quickstart_tutorial.md - environments/Docker-Quickstart.md: yolov5/environments/docker_image_quickstart_tutorial.md - environments/GCP-Quickstart.md: yolov5/environments/google_cloud_quickstart_tutorial.md - FAQ/augmentation.md: yolov5/tutorials/tips_for_best_training_results.md - package-framework.md: index.md - package-framework/mock_detector.md: index.md - predict.md: modes/predict.md - python.md: usage/python.md - quick-start.md: quickstart.md - app.md: hub/app/index.md - sdk.md: index.md - hub/inference_api.md: hub/inference-api.md - usage/hyperparameter_tuning.md: integrations/ray-tune.md - reference/base_pred.md: reference/engine/predictor.md - reference/base_trainer.md: reference/engine/trainer.md - reference/exporter.md: reference/engine/exporter.md - reference/model.md: reference/engine/model.md - reference/nn.md: reference/nn/modules/head.md - reference/ops.md: reference/utils/ops.md - reference/results.md: reference/engine/results.md - reference/base_val.md: index.md - tasks/classification.md: tasks/classify.md - tasks/detection.md: tasks/detect.md - tasks/segmentation.md: tasks/segment.md - tasks/keypoints.md: tasks/pose.md - tasks/tracking.md: modes/track.md - SECURITY.md: help/security.md - tutorials/architecture-summary.md: yolov5/tutorials/architecture_description.md - tutorials/clearml-logging.md: yolov5/tutorials/clearml_logging_integration.md - tutorials/comet-logging.md: yolov5/tutorials/comet_logging_integration.md - tutorials/hyperparameter-evolution.md: yolov5/tutorials/hyperparameter_evolution.md - tutorials/model-ensembling.md: yolov5/tutorials/model_ensembling.md - tutorials/multi-gpu-training.md: yolov5/tutorials/multi_gpu_training.md - tutorials/nvidia-jetson.md: yolov5/tutorials/running_on_jetson_nano.md - tutorials/pruning-sparsity.md: yolov5/tutorials/model_pruning_and_sparsity.md - tutorials/pytorch-hub.md: yolov5/tutorials/pytorch_hub_model_loading.md - tutorials/roboflow.md: yolov5/tutorials/roboflow_datasets_integration.md - tutorials/test-time-augmentation.md: yolov5/tutorials/test_time_augmentation.md - tutorials/torchscript-onnx-coreml-export.md: yolov5/tutorials/model_export.md - tutorials/train-custom-datasets.md: yolov5/tutorials/train_custom_data.md - tutorials/training-tips-best-results.md: yolov5/tutorials/tips_for_best_training_results.md - tutorials/transfer-learning-froze-layers.md: yolov5/tutorials/transfer_learning_with_frozen_layers.md - tutorials/weights-and-biasis-logging.md: yolov5/tutorials/comet_logging_integration.md - yolov5/pytorch_hub.md: yolov5/tutorials/pytorch_hub_model_loading.md - yolov5/hyp_evolution.md: yolov5/tutorials/hyperparameter_evolution.md - yolov5/pruning_sparsity.md: yolov5/tutorials/model_pruning_and_sparsity.md - yolov5/roboflow.md: yolov5/tutorials/roboflow_datasets_integration.md - yolov5/comet.md: yolov5/tutorials/comet_logging_integration.md - yolov5/clearml.md: yolov5/tutorials/clearml_logging_integration.md - yolov5/tta.md: yolov5/tutorials/test_time_augmentation.md - yolov5/multi_gpu_training.md: yolov5/tutorials/multi_gpu_training.md - yolov5/ensemble.md: yolov5/tutorials/model_ensembling.md - yolov5/jetson_nano.md: yolov5/tutorials/running_on_jetson_nano.md - yolov5/transfer_learn_frozen.md: yolov5/tutorials/transfer_learning_with_frozen_layers.md - yolov5/neural_magic.md: yolov5/tutorials/neural_magic_pruning_quantization.md - yolov5/train_custom_data.md: yolov5/tutorials/train_custom_data.md - yolov5/architecture.md: yolov5/tutorials/architecture_description.md - yolov5/export.md: yolov5/tutorials/model_export.md - yolov5/yolov5_quickstart_tutorial.md: yolov5/quickstart_tutorial.md - yolov5/tips_for_best_training_results.md: yolov5/tutorials/tips_for_best_training_results.md - yolov5/tutorials/yolov5_neural_magic_tutorial.md: yolov5/tutorials/neural_magic_pruning_quantization.md - yolov5/tutorials/model_ensembling_tutorial.md: yolov5/tutorials/model_ensembling.md - yolov5/tutorials/pytorch_hub_tutorial.md: yolov5/tutorials/pytorch_hub_model_loading.md - yolov5/tutorials/yolov5_architecture_tutorial.md: yolov5/tutorials/architecture_description.md - yolov5/tutorials/multi_gpu_training_tutorial.md: yolov5/tutorials/multi_gpu_training.md - yolov5/tutorials/yolov5_pytorch_hub_tutorial.md: yolov5/tutorials/pytorch_hub_model_loading.md - yolov5/tutorials/model_export_tutorial.md: yolov5/tutorials/model_export.md - yolov5/tutorials/jetson_nano_tutorial.md: yolov5/tutorials/running_on_jetson_nano.md - yolov5/tutorials/yolov5_model_ensembling_tutorial.md: yolov5/tutorials/model_ensembling.md - yolov5/tutorials/roboflow_integration.md: yolov5/tutorials/roboflow_datasets_integration.md - yolov5/tutorials/pruning_and_sparsity_tutorial.md: yolov5/tutorials/model_pruning_and_sparsity.md - yolov5/tutorials/yolov5_transfer_learning_with_frozen_layers_tutorial.md: yolov5/tutorials/transfer_learning_with_frozen_layers.md - yolov5/tutorials/transfer_learning_with_frozen_layers_tutorial.md: yolov5/tutorials/transfer_learning_with_frozen_layers.md - yolov5/tutorials/yolov5_model_export_tutorial.md: yolov5/tutorials/model_export.md - yolov5/tutorials/neural_magic_tutorial.md: yolov5/tutorials/neural_magic_pruning_quantization.md - yolov5/tutorials/yolov5_clearml_integration_tutorial.md: yolov5/tutorials/clearml_logging_integration.md - yolov5/tutorials/yolov5_train_custom_data.md: yolov5/tutorials/train_custom_data.md - yolov5/tutorials/comet_integration_tutorial.md: yolov5/tutorials/comet_logging_integration.md - yolov5/tutorials/yolov5_pruning_and_sparsity_tutorial.md: yolov5/tutorials/model_pruning_and_sparsity.md - yolov5/tutorials/yolov5_jetson_nano_tutorial.md: yolov5/tutorials/running_on_jetson_nano.md - yolov5/tutorials/yolov5_roboflow_integration.md: yolov5/tutorials/roboflow_datasets_integration.md - yolov5/tutorials/hyperparameter_evolution_tutorial.md: yolov5/tutorials/hyperparameter_evolution.md - yolov5/tutorials/yolov5_hyperparameter_evolution_tutorial.md: yolov5/tutorials/hyperparameter_evolution.md - yolov5/tutorials/clearml_integration_tutorial.md: yolov5/tutorials/clearml_logging_integration.md - yolov5/tutorials/test_time_augmentation_tutorial.md: yolov5/tutorials/test_time_augmentation.md - yolov5/tutorials/yolov5_test_time_augmentation_tutorial.md: yolov5/tutorials/test_time_augmentation.md - yolov5/environments/yolov5_amazon_web_services_quickstart_tutorial.md: yolov5/environments/aws_quickstart_tutorial.md - yolov5/environments/yolov5_google_cloud_platform_quickstart_tutorial.md: yolov5/environments/google_cloud_quickstart_tutorial.md - yolov5/environments/yolov5_docker_image_quickstart_tutorial.md: yolov5/environments/docker_image_quickstart_tutorial.md diff --git a/ultralytics-main/pyproject.toml b/ultralytics-main/pyproject.toml deleted file mode 100644 index 6929457..0000000 --- a/ultralytics-main/pyproject.toml +++ /dev/null @@ -1,178 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -# Overview: -# This pyproject.toml file manages the build, packaging, and distribution of the Ultralytics library. -# It defines essential project metadata, dependencies, and settings used to develop and deploy the library. - -# Key Sections: -# - [build-system]: Specifies the build requirements and backend (e.g., setuptools, wheel). -# - [project]: Includes details like name, version, description, authors, dependencies and more. -# - [project.optional-dependencies]: Provides additional, optional packages for extended features. -# - [tool.*]: Configures settings for various tools (pytest, yapf, etc.) used in the project. - -# Installation: -# The Ultralytics library can be installed using the command: 'pip install ultralytics' -# For development purposes, you can install the package in editable mode with: 'pip install -e .' -# This approach allows for real-time code modifications without the need for re-installation. - -# Documentation: -# For comprehensive documentation and usage instructions, visit: https://docs.ultralytics.com - -[build-system] -requires = ["setuptools>=43.0.0", "wheel"] -build-backend = "setuptools.build_meta" - -# Project settings ----------------------------------------------------------------------------------------------------- -[project] -name = "ultralytics" -dynamic = ["version"] -description = "Ultralytics YOLOv8 for SOTA object detection, multi-object tracking, instance segmentation, pose estimation and image classification." -readme = "README.md" -requires-python = ">=3.8" -license = { "text" = "AGPL-3.0" } -keywords = ["machine-learning", "deep-learning", "computer-vision", "ML", "DL", "AI", "YOLO", "YOLOv3", "YOLOv5", "YOLOv8", "HUB", "Ultralytics"] -authors = [ - { name = "Glenn Jocher" }, - { name = "Ayush Chaurasia" }, - { name = "Jing Qiu" } -] -maintainers = [ - { name = "Glenn Jocher" }, - { name = "Ayush Chaurasia" }, - { name = "Jing Qiu" } -] -classifiers = [ - "Development Status :: 4 - Beta", - "Intended Audience :: Developers", - "Intended Audience :: Education", - "Intended Audience :: Science/Research", - "License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)", - "Programming Language :: Python :: 3", - "Programming Language :: Python :: 3.8", - "Programming Language :: Python :: 3.9", - "Programming Language :: Python :: 3.10", - "Programming Language :: Python :: 3.11", - "Programming Language :: Python :: 3.12", - "Topic :: Software Development", - "Topic :: Scientific/Engineering", - "Topic :: Scientific/Engineering :: Artificial Intelligence", - "Topic :: Scientific/Engineering :: Image Recognition", - "Operating System :: POSIX :: Linux", - "Operating System :: MacOS", - "Operating System :: Microsoft :: Windows", -] - -# Required dependencies ------------------------------------------------------------------------------------------------ -dependencies = [ - "matplotlib>=3.3.0", - "opencv-python>=4.6.0", - "pillow>=7.1.2", - "pyyaml>=5.3.1", - "requests>=2.23.0", - "scipy>=1.4.1", - "torch>=1.8.0", - "torchvision>=0.9.0", - "tqdm>=4.64.0", # progress bars - "psutil", # system utilization - "py-cpuinfo", # display CPU info - "thop>=0.1.1", # FLOPs computation - "pandas>=1.1.4", - "seaborn>=0.11.0", # plotting -] - -# Optional dependencies ------------------------------------------------------------------------------------------------ -[project.optional-dependencies] -dev = [ - "ipython", - "check-manifest", - "pre-commit", - "pytest", - "pytest-cov", - "coverage[toml]", - "mkdocs-material>=9.5.9", - "mkdocstrings[python]", - "mkdocs-jupyter", # for notebooks - "mkdocs-redirects", # for 301 redirects - "mkdocs-ultralytics-plugin>=0.0.44", # for meta descriptions and images, dates and authors -] -export = [ - "onnx>=1.12.0", # ONNX export - "coremltools>=7.0; platform_system != 'Windows' and python_version <= '3.11'", # CoreML supported on macOS and Linux - "openvino>=2024.0.0", # OpenVINO export - "tensorflow<=2.13.1; python_version <= '3.11'", # TF bug https://github.com/ultralytics/ultralytics/issues/5161 - "tensorflowjs>=3.9.0; python_version <= '3.11'", # TF.js export, automatically installs tensorflow -] -explorer = [ - "lancedb", # vector search - "duckdb<=0.9.2", # SQL queries, duckdb==0.10.0 bug https://github.com/ultralytics/ultralytics/pull/8181 - "streamlit", # visualizing with GUI -] -# tensorflow>=2.4.1,<=2.13.1 # TF exports (-cpu, -aarch64, -macos) -# tflite-support # for TFLite model metadata -# nvidia-pyindex # TensorRT export -# nvidia-tensorrt # TensorRT export -logging = [ - "comet", # https://docs.ultralytics.com/integrations/comet/ - "tensorboard>=2.13.0", - "dvclive>=2.12.0", -] -extra = [ - "hub-sdk>=0.0.2", # Ultralytics HUB - "ipython", # interactive notebook - "albumentations>=1.0.3", # training augmentations - "pycocotools>=2.0.7", # COCO mAP -] - -[project.urls] -"Bug Reports" = "https://github.com/ultralytics/ultralytics/issues" -"Funding" = "https://ultralytics.com" -"Source" = "https://github.com/ultralytics/ultralytics/" - -[project.scripts] -yolo = "ultralytics.cfg:entrypoint" -ultralytics = "ultralytics.cfg:entrypoint" - -# Tools settings ------------------------------------------------------------------------------------------------------- -[tool.setuptools] # configuration specific to the `setuptools` build backend. -packages = { find = { where = ["."], include = ["ultralytics", "ultralytics.*"] } } -package-data = { "ultralytics" = ["**/*.yaml"], "ultralytics.assets" = ["*.jpg"] } - -[tool.setuptools.dynamic] -version = { attr = "ultralytics.__version__" } - -[tool.pytest] -norecursedirs = [".git", "dist", "build"] -addopts = "--doctest-modules --durations=30 --color=yes" - -[tool.coverage.run] -source = ["ultralytics/"] -data_file = "tests/.coverage" -omit = ["ultralytics/utils/callbacks/*"] - -[tool.isort] -line_length = 120 -multi_line_output = 0 - -[tool.yapf] -based_on_style = "pep8" -spaces_before_comment = 2 -column_limit = 120 -coalesce_brackets = true -spaces_around_power_operator = true -space_between_ending_comma_and_closing_bracket = true -split_before_closing_bracket = false -split_before_first_argument = false - -[tool.ruff] -line-length = 120 - -[tool.docformatter] -wrap-summaries = 120 -wrap-descriptions = 120 -in-place = true -pre-summary-newline = true -close-quotes-on-newline = true - -[tool.codespell] -ignore-words-list = "crate,nd,ned,strack,dota,ane,segway,fo,gool,winn,commend,bloc,nam,afterall" -skip = '*.pt,*.pth,*.torchscript,*.onnx,*.tflite,*.pb,*.bin,*.param,*.mlmodel,*.engine,*.npy,*.data*,*.csv,*pnnx*,*venv*,*translat*,__pycache__*,*.ico,*.jpg,*.png,*.mp4,*.mov,/runs,/.git,./docs/??/*.md,./docs/mkdocs_??.yml' diff --git a/ultralytics-main/requirements.txt b/ultralytics-main/requirements.txt deleted file mode 100644 index fde5c44..0000000 --- a/ultralytics-main/requirements.txt +++ /dev/null @@ -1,47 +0,0 @@ -# Ultralytics requirements -# Example: pip install -r requirements.txt - -# Base ---------------------------------------- -matplotlib>=3.3.0 -numpy>=1.22.2 # pinned by Snyk to avoid a vulnerability -opencv-python>=4.6.0 -pillow>=7.1.2 -pyyaml>=5.3.1 -requests>=2.23.0 -scipy>=1.4.1 -# torch>=1.8.0 -# torchvision>=0.9.0 -tqdm>=4.64.0 - -# Logging ------------------------------------- -# tensorboard>=2.13.0 -# dvclive>=2.12.0 -# clearml -# comet - -# Plotting ------------------------------------ -pandas>=1.1.4 -seaborn>=0.11.0 - -# Export -------------------------------------- -# coremltools>=7.0 # CoreML export -# onnx>=1.12.0 # ONNX export -# onnxsim>=0.4.1 # ONNX simplifier -# nvidia-pyindex # TensorRT export -# nvidia-tensorrt # TensorRT export -# scikit-learn==0.19.2 # CoreML quantization -# tensorflow>=2.4.1,<=2.13.1 # TF exports (-cpu, -aarch64, -macos) -# tflite-support -# jax<=0.4.21 # tensorflowjs bug https://github.com/google/jax/issues/18978 -# jaxlib<=0.4.21 # tensorflowjs bug https://github.com/google/jax/issues/18978 -# tensorflowjs>=3.9.0 # TF.js export -# openvino-dev>=2023.0 # OpenVINO export - -# Extras -------------------------------------- -psutil # system utilization -py-cpuinfo # display CPU info -thop>=0.1.1 # FLOPs computation -# ipython # interactive notebook -# albumentations>=1.0.3 # training augmentations -# pycocotools>=2.0.6 # COCO mAP -# roboflow diff --git a/ultralytics-main/setup.py b/ultralytics-main/setup.py deleted file mode 100644 index 2b01df8..0000000 --- a/ultralytics-main/setup.py +++ /dev/null @@ -1,102 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import re -from pathlib import Path - -from setuptools import setup - -# Settings -FILE = Path(__file__).resolve() -PARENT = FILE.parent # root directory -README = (PARENT / 'README.md').read_text(encoding='utf-8') - - -def get_version(): - """ - Retrieve the version number from the 'ultralytics/__init__.py' file. - Returns: - (str): The version number extracted from the '__version__' attribute in the 'ultralytics/__init__.py' file. - """ - file = PARENT / 'ultralytics/__init__.py' - return re.search(r'^__version__ = [\'"]([^\'"]*)[\'"]', file.read_text(encoding='utf-8'), re.M)[1] - - -def parse_requirements(file_path: Path): - """ - Parse a requirements.txt file, ignoring lines that start with '#' and any text after '#'. - Args: - file_path (str | Path): Path to the requirements.txt file. - Returns: - (List[str]): List of parsed requirements. - """ - - requirements = [] - for line in Path(file_path).read_text().splitlines(): - line = line.strip() - if line and not line.startswith('#'): - requirements.append(line.split('#')[0].strip()) # ignore inline comments - - return requirements - - -setup( - name='ultralytics', # name of pypi package - version=get_version(), # version of pypi package - python_requires='>=3.8', - license='AGPL-3.0', - description=('Ultralytics YOLOv8 for SOTA object detection, multi-object tracking, instance segmentation, ' - 'pose estimation and image classification.'), - long_description=README, - long_description_content_type='text/markdown', - url='https://github.com/ultralytics/ultralytics', - project_urls={ - 'Bug Reports': 'https://github.com/ultralytics/ultralytics/issues', - 'Funding': 'https://ultralytics.com', - 'Source': 'https://github.com/ultralytics/ultralytics'}, - author='Ultralytics', - author_email='hello@ultralytics.com', - packages=['ultralytics'] + [str(x) for x in Path('ultralytics').rglob('*/') if x.is_dir() and '__' not in str(x)], - package_data={ - '': ['*.yaml'], - 'ultralytics.assets': ['*.jpg']}, - include_package_data=True, - install_requires=parse_requirements(PARENT / 'requirements.txt'), - extras_require={ - 'dev': [ - 'ipython', - 'check-manifest', - 'pre-commit', - 'pytest', - 'pytest-cov', - 'coverage', - 'mkdocs-material', - 'mkdocstrings[python]', - 'mkdocs-redirects', # for 301 redirects - 'mkdocs-ultralytics-plugin>=0.0.30', # for meta descriptions and images, dates and authors - ], - 'export': [ - 'coremltools>=7.0', - 'openvino-dev>=2023.0', - 'tensorflow<=2.13.1', - 'tensorflowjs', # automatically installs tensorflow - ], }, - classifiers=[ - 'Development Status :: 4 - Beta', - 'Intended Audience :: Developers', - 'Intended Audience :: Education', - 'Intended Audience :: Science/Research', - 'License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)', - 'Programming Language :: Python :: 3', - 'Programming Language :: Python :: 3.8', - 'Programming Language :: Python :: 3.9', - 'Programming Language :: Python :: 3.10', - 'Programming Language :: Python :: 3.11', - 'Topic :: Software Development', - 'Topic :: Scientific/Engineering', - 'Topic :: Scientific/Engineering :: Artificial Intelligence', - 'Topic :: Scientific/Engineering :: Image Recognition', - 'Operating System :: POSIX :: Linux', - 'Operating System :: MacOS', - 'Operating System :: Microsoft :: Windows', ], - keywords='machine-learning, deep-learning, vision, ML, DL, AI, YOLO, YOLOv3, YOLOv5, YOLOv8, HUB, Ultralytics', - entry_points={'console_scripts': ['yolo = ultralytics.cfg:entrypoint', 'ultralytics = ultralytics.cfg:entrypoint']}) \ No newline at end of file diff --git a/ultralytics-main/stereo-speed.py b/ultralytics-main/stereo-speed.py deleted file mode 100644 index b464b80..0000000 --- a/ultralytics-main/stereo-speed.py +++ /dev/null @@ -1,98 +0,0 @@ -import time -import cv2 -import numpy as np - -from ultralytics import YOLO -from stereo import stereoconfig_040_2 -from stereo.stereo import stereo_40 -from stereo.stereo import stereo_threading, MyThread -from stereo.dianyuntu_yolo import preprocess, undistortion, getRectifyTransform, draw_line, rectifyImage, \ - stereoMatchSGBM -from collections import defaultdict - -def detect(): - - model = YOLO("yolov8n.pt") - cv2.namedWindow('Speed Estimation', cv2.WINDOW_NORMAL) - cv2.resizeWindow('Speed Estimation', 1280, 360) # 设置宽高 - cap = cv2.VideoCapture('ultralytics/assets/a2.mp4') - out_video = cv2.VideoWriter('output.avi', cv2.VideoWriter_fourcc(*'XVID'), 30, (2560, 720)) - previous_positions = {} - track_history = defaultdict(lambda: []) - assert cap.isOpened(), "Error reading video file" - while cap.isOpened(): - success, im0 = cap.read() - if not success: - print("Video frame is empty or video processing has been successfully completed.") - break - # start_time = time.time() - im0 = cv2.resize(im0, (2560, 720)) - config = stereoconfig_040_2.stereoCamera() - map1x, map1y, map2x, map2y, Q = getRectifyTransform(720, 1280, config) - thread = MyThread(stereo_threading, args=(config, im0, map1x, map1y, map2x, map2y, Q)) - thread.start() - start_time = time.time() - tracks = model.track(im0, persist=True) - track_ids = tracks[0].boxes.id.int().cpu().tolist() - annotated_frame = tracks[0].plot() - boxes = tracks[0].boxes.xywh.cpu() - - # for i, box in enumerate(boxes): - for i, (box, track_id) in enumerate(zip(boxes, track_ids)): - - x_center, y_center, width, height = box.tolist() - x1 = x_center - width / 2 - y1 = y_center - height / 2 - x2 = x_center + width / 2 - y2 = y_center + height / 2 - if (0 < x2 < 1280): - thread.join() - points_3d = thread.get_result() - a = points_3d[int(y_center), int(x_center), 0] / 1000 - b = points_3d[int(y_center), int(x_center), 1] / 1000 - c = points_3d[int(y_center), int(x_center), 2] / 1000 - distance = ((a ** 2 + b ** 2 + c ** 2) ** 0.5) - bbox_center_3d = (float(a), float(b), float(c)) - current_position = (a, b, c) - if i not in previous_positions: - previous_positions[i] = current_position - continue - tracks.append(bbox_center_3d) - previous_x, previous_y, previous_z = previous_positions[i] - displacement = ((a - previous_x) ** 2 + (b - previous_y) ** 2 + + (c - previous_z) ** 2) ** 0.5 - end_time = time.time() - run_time = end_time-start_time - speed = displacement / run_time - print(run_time) - # 更新上一帧位置 - previous_positions[i] = current_position - # 在这里使用速度进行你想要的操作，比如打印出来 - # print("目标 {} 的速度为: {} m/s".format(i, speed)) - print("速度为: {} m/s".format(speed)) - - track = track_history[track_id] - track.append((float(x_center), float(y_center))) # x, y center point - if len(track) > 30: # retain 90 tracks for 90 frames - track.pop(0) - - # Draw the tracking lines - points = np.hstack(track).astype(np.int32).reshape((-1, 1, 2)) - cv2.polylines(annotated_frame, [points], isClosed=False, color=(0, 0, 255), thickness=3) - - if (distance != 0): - text_dis_avg = "dis:%0.2fm" % distance - cv2.putText(annotated_frame, text_dis_avg, (int(x2 + 5), int(y1 + 30)), cv2.FONT_ITALIC, 1.0, - (0, 255, 255), 2) - text_speed = "v:%0.2fm/s" % speed - cv2.putText(annotated_frame, text_speed, (int(x2 + 5), int(y1 + 60)), cv2.FONT_ITALIC, 1.0, - (255, 255, 0), 2) - - cv2.imshow("Speed Estimation", annotated_frame) - out_video.write(annotated_frame) - if cv2.waitKey(1) == ord('q'): - break - out_video.release() - cap.release() - cv2.destroyAllWindows() -if __name__ == '__main__': - detect() \ No newline at end of file diff --git a/ultralytics-main/stereo/dianyuntu_yolo.py b/ultralytics-main/stereo/dianyuntu_yolo.py deleted file mode 100644 index 56099ea..0000000 --- a/ultralytics-main/stereo/dianyuntu_yolo.py +++ /dev/null @@ -1,194 +0,0 @@ - # -*- coding: utf-8 -*- -import cv2 -import numpy as np -import stereo.stereoconfig_040_2 #导入相机标定的参数 -#import pcl -#import pcl.pcl_visualization - - -# 预处理 -def preprocess(img1, img2): - # 彩色图->灰度图 - if(img1.ndim == 3):#判断为三维数组 - img1 = cv2.cvtColor(img1, cv2.COLOR_BGR2GRAY) # 通过OpenCV加载的图像通道顺序是BGR - if(img2.ndim == 3): - img2 = cv2.cvtColor(img2, cv2.COLOR_BGR2GRAY) - - # 直方图均衡 - img1 = cv2.equalizeHist(img1) - img2 = cv2.equalizeHist(img2) - - return img1, img2 - - -# 消除畸变 -def undistortion(image, camera_matrix, dist_coeff): - undistortion_image = cv2.undistort(image, camera_matrix, dist_coeff) - - return undistortion_image - - -# 获取畸变校正和立体校正的映射变换矩阵、重投影矩阵 -# @param：config是一个类，存储着双目标定的参数:config = stereoconfig.stereoCamera() -def getRectifyTransform(height, width, config): - # 读取内参和外参 - left_K = config.cam_matrix_left - right_K = config.cam_matrix_right - left_distortion = config.distortion_l - right_distortion = config.distortion_r - R = config.R - T = config.T - - # 计算校正变换 - R1, R2, P1, P2, Q, roi1, roi2 = cv2.stereoRectify(left_K, left_distortion, right_K, right_distortion, - (width, height), R, T, alpha=0) - - map1x, map1y = cv2.initUndistortRectifyMap(left_K, left_distortion, R1, P1, (width, height), cv2.CV_32FC1) - map2x, map2y = cv2.initUndistortRectifyMap(right_K, right_distortion, R2, P2, (width, height), cv2.CV_32FC1) - - return map1x, map1y, map2x, map2y, Q - - -# 畸变校正和立体校正 -def rectifyImage(image1, image2, map1x, map1y, map2x, map2y): - rectifyed_img1 = cv2.remap(image1, map1x, map1y, cv2.INTER_AREA) - rectifyed_img2 = cv2.remap(image2, map2x, map2y, cv2.INTER_AREA) - - return rectifyed_img1, rectifyed_img2 - - -# 立体校正检验----画线 -def draw_line(image1, image2): - # 建立输出图像 - height = max(image1.shape[0], image2.shape[0]) - width = image1.shape[1] + image2.shape[1] - - output = np.zeros((height, width, 3), dtype=np.uint8) - output[0:image1.shape[0], 0:image1.shape[1]] = image1 - output[0:image2.shape[0], image1.shape[1]:] = image2 - - # 绘制等间距平行线 - line_interval = 50 # 直线间隔：50 - for k in range(height // line_interval): - cv2.line(output, (0, line_interval * (k + 1)), (2 * width, line_interval * (k + 1)), (0, 255, 0), thickness=2, lineType=cv2.LINE_AA) - - return output - - -# 视差计算 -def stereoMatchSGBM(left_image, right_image, down_scale=False): - # SGBM匹配参数设置 - if left_image.ndim == 2: - img_channels = 1 - else: - img_channels = 3 - blockSize = 5 - paraml = {'minDisparity': 0, - 'numDisparities': 128, - 'blockSize': blockSize, - 'P1': 8 * img_channels * blockSize ** 2, - 'P2': 32 * img_channels * blockSize ** 2, - 'disp12MaxDiff': 5, - 'preFilterCap': 63, - 'uniquenessRatio': 15, - 'speckleWindowSize': 100, - 'speckleRange': 1, - 'mode': cv2.STEREO_SGBM_MODE_SGBM_3WAY - } - - # 构建SGBM对象 - left_matcher = cv2.StereoSGBM_create(**paraml) - paramr = paraml - paramr['minDisparity'] = -paraml['numDisparities'] - right_matcher = cv2.StereoSGBM_create(**paramr) - - # 计算视差图 - size = (left_image.shape[1], left_image.shape[0]) - if down_scale == False: - disparity_left = left_matcher.compute(left_image, right_image) - disparity_right = right_matcher.compute(right_image, left_image) - - else: - left_image_down = cv2.pyrDown(left_image) - right_image_down = cv2.pyrDown(right_image) - factor = left_image.shape[1] / left_image_down.shape[1] - - disparity_left_half = left_matcher.compute(left_image_down, right_image_down) - disparity_right_half = right_matcher.compute(right_image_down, left_image_down) - disparity_left = cv2.resize(disparity_left_half, size, interpolation=cv2.INTER_AREA) - disparity_right = cv2.resize(disparity_right_half, size, interpolation=cv2.INTER_AREA) - disparity_left = factor * disparity_left - disparity_right = factor * disparity_right - - # 真实视差（因为SGBM算法得到的视差是×16的） - trueDisp_left = disparity_left.astype(np.float32) / 16. - trueDisp_right = disparity_right.astype(np.float32) / 16. - - return trueDisp_left, trueDisp_right - - -# 将h×w×3数组转换为N×3的数组 -def hw3ToN3(points): - height, width = points.shape[0:2] - - points_1 = points[:, :, 0].reshape(height * width, 1) - points_2 = points[:, :, 1].reshape(height * width, 1) - points_3 = points[:, :, 2].reshape(height * width, 1) - - points_ = np.hstack((points_1, points_2, points_3)) - - return points_ - - -# 深度、颜色转换为点云 -def DepthColor2Cloud(points_3d, colors): - rows, cols = points_3d.shape[0:2] - size = rows * cols - - points_ = hw3ToN3(points_3d) - colors_ = hw3ToN3(colors).astype(np.int64) - - # 颜色信息 - blue = colors_[:, 0].reshape(size, 1) - green = colors_[:, 1].reshape(size, 1) - red = colors_[:, 2].reshape(size, 1) - - rgb = np.left_shift(blue, 0) + np.left_shift(green, 8) + np.left_shift(red, 16) - - # 将坐标+颜色叠加为点云数组 - pointcloud = np.hstack((points_, rgb)).astype(np.float32) - - # 删掉一些不合适的点 - X = pointcloud[:, 0] - Y = pointcloud[:, 1] - Z = pointcloud[:, 2] - - remove_idx1 = np.where(Z <= 0) - remove_idx2 = np.where(Z > 10000) - remove_idx3 = np.where(X > 10000) - remove_idx4 = np.where(X < -10000) - remove_idx5 = np.where(Y > 10000) - remove_idx6 = np.where(Y < -10000) - remove_idx = np.hstack((remove_idx1[0], remove_idx2[0], remove_idx3[0], remove_idx4[0], remove_idx5[0], remove_idx6[0])) - - pointcloud_1 = np.delete(pointcloud, remove_idx, 0) - - return pointcloud_1 - - - -# 点云显示 -def view_cloud(pointcloud): - cloud = pcl.PointCloud_PointXYZRGBA() - cloud.from_array(pointcloud) - - try: - visual = pcl.pcl_visualization.CloudViewing() - visual.ShowColorACloud(cloud) - v = True - while v: - v = not (visual.WasStopped()) - except: - pass - - diff --git a/ultralytics-main/stereo/stereo.py b/ultralytics-main/stereo/stereo.py deleted file mode 100644 index f233288..0000000 --- a/ultralytics-main/stereo/stereo.py +++ /dev/null @@ -1,206 +0,0 @@ - # -*- coding: utf-8 -*- -import cv2 -import numpy as np - -#import numba - -import threading -from threading import Thread - -import stereo.stereoconfig_040_2 #导入相机标定的参数 -#import pcl -#import pcl.pcl_visualization - -#@cuda.jit -#@jit -#from numba import cuda, vectorize -#from numba import njit -#@cuda.jit -#@njit -#@vectorize(["float32 (float32 , float32 )"], target='cuda') -class stereo_40: - def __init__(self,imgl,imgr): - self.left = imgl - self.right = imgr - - # 预处理 - def preprocess(self, img1, img2): - # 彩色图->灰度图 - if(img1.ndim == 3):#判断为三维数组 - img1 = cv2.cvtColor(img1, cv2.COLOR_BGR2GRAY) # 通过OpenCV加载的图像通道顺序是BGR - if(img2.ndim == 3): - img2 = cv2.cvtColor(img2, cv2.COLOR_BGR2GRAY) - - # 直方图均衡 - img1 = cv2.equalizeHist(img1) - img2 = cv2.equalizeHist(img2) - - return img1, img2 - - ''' - # 消除畸变 - def undistortion(self, image, camera_matrix, dist_coeff): - undistortion_image = cv2.undistort(image, camera_matrix, dist_coeff) - - return undistortion_image - ''' - # 消除畸变 - def undistortion(self, imagleft,imagright, camera_matrix_left, camera_matrix_right, dist_coeff_left,dist_coeff_right): - undistortion_imagleft = cv2.undistort(imagleft, camera_matrix_left, dist_coeff_left ) - undistortion_imagright = cv2.undistort(imagright, camera_matrix_right, dist_coeff_right) - - return undistortion_imagleft, undistortion_imagright - - - - - # 畸变校正和立体校正 - def rectifyImage(self, image1, image2, map1x, map1y, map2x, map2y): - rectifyed_img1 = cv2.remap(image1, map1x, map1y, cv2.INTER_AREA) - rectifyed_img2 = cv2.remap(image2, map2x, map2y, cv2.INTER_AREA) - - return rectifyed_img1, rectifyed_img2 - - - # 立体校正检验----画线 - def draw_line(self, image1, image2): - # 建立输出图像 - height = max(image1.shape[0], image2.shape[0]) - width = image1.shape[1] + image2.shape[1] - - output = np.zeros((height, width, 3), dtype=np.uint8) - output[0:image1.shape[0], 0:image1.shape[1]] = image1 - output[0:image2.shape[0], image1.shape[1]:] = image2 - - # 绘制等间距平行线 - line_interval = 50 # 直线间隔：50 - for k in range(height // line_interval): - cv2.line(output, (0, line_interval * (k + 1)), (2 * width, line_interval * (k + 1)), (0, 255, 0), thickness=2, lineType=cv2.LINE_AA) - - return output - - - # 视差计算 - def stereoMatchSGBM(self, left_image, right_image, down_scale=False): - # SGBM匹配参数设置 - if left_image.ndim == 2: - img_channels = 1 - else: - img_channels = 3 - blockSize = 3 - paraml = {'minDisparity': 0, - 'numDisparities': 128, - 'blockSize': blockSize, - 'P1': 8 * img_channels * blockSize ** 2, - 'P2': 32 * img_channels * blockSize ** 2, - 'disp12MaxDiff': -1, - 'preFilterCap': 63, - 'uniquenessRatio': 10, - 'speckleWindowSize': 100, - 'speckleRange': 1, - 'mode': cv2.STEREO_SGBM_MODE_SGBM_3WAY - } - - # 构建SGBM对象 - left_matcher = cv2.StereoSGBM_create(**paraml) - paramr = paraml - paramr['minDisparity'] = -paraml['numDisparities'] - right_matcher = cv2.StereoSGBM_create(**paramr) - - # 计算视差图 - size = (left_image.shape[1], left_image.shape[0]) - if down_scale == False: - disparity_left = left_matcher.compute(left_image, right_image) - disparity_right = right_matcher.compute(right_image, left_image) - - else: - left_image_down = cv2.pyrDown(left_image) - right_image_down = cv2.pyrDown(right_image) - factor = left_image.shape[1] / left_image_down.shape[1] - - disparity_left_half = left_matcher.compute(left_image_down, right_image_down) - disparity_right_half = right_matcher.compute(right_image_down, left_image_down) - disparity_left = cv2.resize(disparity_left_half, size, interpolation=cv2.INTER_AREA) - disparity_right = cv2.resize(disparity_right_half, size, interpolation=cv2.INTER_AREA) - disparity_left = factor * disparity_left - disparity_right = factor * disparity_right - - # 真实视差（因为SGBM算法得到的视差是×16的） - trueDisp_left = disparity_left.astype(np.float32) / 16. - trueDisp_right = disparity_right.astype(np.float32) / 16. - - return trueDisp_left, trueDisp_right - - -def get_median(data): - data.sort() - half = len(data) // 2 - #return (data[half] + data[~half]) / 2 - return data[half] - -class MyThread(threading.Thread): - def __init__(self, func, args=()): - super(MyThread, self).__init__() - self.func = func - self.args = args - - def run(self): - self.result = self.func(*self.args) # 在执行函数的同时，把结果赋值给result, - # 然后通过get_result函数获取返回的结果 - - def get_result(self): - try: - return self.result - except Exception as e: - return None - - - -def stereo_threading(config,im0,map1x, map1y, map2x, map2y,Q): - height_0, width_0 = im0.shape[0:2] - - width_1 = width_0/2 - iml = im0[0:int(height_0), 0:int(width_0/2)] - imr = im0[0:int(height_0), int(width_0/2):int(width_0) ] - - stereo_test = stereo_40(iml,imr) - height, width = iml.shape[0:2] - - - - - #t6 = time_synchronized() #O.506s - - #print("Print Q!") - #print("Q[2,3]:%.3f"%Q[2,3]) - - #t6 = time_synchronized()#0.450s - iml_rectified, imr_rectified = stereo_test.rectifyImage(iml, imr, map1x, map1y, map2x, map2y) - - - #t6 = time_synchronized()#0.410s - # 消除畸变as - iml, imr = stereo_test.undistortion(iml,imr, config.cam_matrix_left, config.cam_matrix_right, config.distortion_l,config.distortion_r) - #t6 = time_synchronized()#0.299s - # 立体匹配 - iml_, imr_ = stereo_test.preprocess(iml, imr) # 预处理，一般可以削弱光照不均的影响，不做也可以 - - iml_rectified_l, imr_rectified_r = stereo_test.rectifyImage(iml_, imr_, map1x, map1y, map2x, map2y) - #t6 = time_synchronized()#0.260s - disp, _ = stereo_test.stereoMatchSGBM(iml_rectified_l, imr_rectified_r, True) - #cv2.imwrite('./yolo/%s视差%d.png' %(string,p), disp) - - #t6 = time_synchronized()#0.010s - # 计算像素点的3D坐标（左相机坐标系下） - points_3d = cv2.reprojectImageTo3D(disp, Q) # 可以使用上文的stereo_config.py给出的参数 - return points_3d - #t7 = time_synchronized() - #print(f'3D MATCH Done. ({t7 - t3:.3f}s)') - #print() - #print("############## Frame is %d !##################" %accel_frame) - - #t4 = time.time() # stereo time end - #print(f'{s}Stereo Done. ({t4 - t3:.3f}s)') - - - diff --git a/ultralytics-main/stereo/stereoconfig_040_2.py b/ultralytics-main/stereo/stereoconfig_040_2.py deleted file mode 100644 index 4148d73..0000000 --- a/ultralytics-main/stereo/stereoconfig_040_2.py +++ /dev/null @@ -1,42 +0,0 @@ -import numpy as np - - -####################仅仅是一个示例################################### - - -# 双目相机参数 -class stereoCamera(object): - def __init__(self): - # 左相机内参 - self.cam_matrix_left = np.array([[1060.3700, 0, 1124.9100], - [0, 1059.7600, 623.3810], - [0, 0, 1] - ]) - # 右相机内参 - self.cam_matrix_right = np.array([[1049.2200, 0, 1124.6899], - [0, 1049.0800, 619.5950], - [0, 0, 1] - ]) - - # 左右相机畸变系数:[k1, k2, p1, p2, k3] - self.distortion_l = np.array([[-0.0424, 0.0126, -0.0002, 0.0003, -0.0060]]) - self.distortion_r = np.array([[-0.0411, 0.0089, -0.0002, 0.0003, -0.0060]]) - - # 旋转矩阵 - self.R = np.array([[1.0000, -0.0006, 0.0028], - [0.0006, 1.0000, -0.0003], - [-0.0028, 0.0003, 1.0000] - ]) - - # 平移矩阵 - self.T = np.array([[119.7550], [-0.1684], [0.4651]]) - - # 焦距 - self.focal_length = 859.367 # 默认值，一般取立体校正后的重投影矩阵Q中的 Q[2,3] - - # 基线距离 - self.baseline = 119.9578 # 单位：mm， 为平移向量的第一个参数（取绝对值） - - - - diff --git a/ultralytics-main/ultralytics/__init__.py b/ultralytics-main/ultralytics/__init__.py deleted file mode 100644 index 1a38daf..0000000 --- a/ultralytics-main/ultralytics/__init__.py +++ /dev/null @@ -1,26 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -__version__ = "8.1.30" - -from ultralytics.data.explorer.explorer import Explorer -from ultralytics.models import RTDETR, SAM, YOLO, YOLOWorld -from ultralytics.models.fastsam import FastSAM -from ultralytics.models.nas import NAS -from ultralytics.utils import ASSETS, SETTINGS as settings -from ultralytics.utils.checks import check_yolo as checks -from ultralytics.utils.downloads import download - -__all__ = ( - "__version__", - "ASSETS", - "YOLO", - "YOLOWorld", - "NAS", - "SAM", - "FastSAM", - "RTDETR", - "checks", - "download", - "settings", - "Explorer", -) diff --git a/ultralytics-main/ultralytics/bus.jpg b/ultralytics-main/ultralytics/bus.jpg deleted file mode 100644 index b43e311165c785f000eb7493ff8fb662d06a3f83..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 487438 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

L*Ns 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±R>MFOp7JM4pD#r*Z9T}X!IUIE8D;^=LFcP@ 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

wcVd9TWT)t}<5p825`(7@t>InCF68vSmf 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

v4oLeD|uyN41evsX-b8Td)J^9v_hclwJ# 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 z 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
|11H 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 tP=2vWpJ7Z List[str]: - """ - Merges arguments around isolated '=' args in a list of strings. The function considers cases where the first - argument ends with '=' or the second starts with '=', as well as when the middle one is an equals sign. - - Args: - args (List[str]): A list of strings where each element is an argument. - - Returns: - (List[str]): A list of strings where the arguments around isolated '=' are merged. - """ - new_args = [] - for i, arg in enumerate(args): - if arg == "=" and 0 < i < len(args) - 1: # merge ['arg', '=', 'val'] - new_args[-1] += f"={args[i + 1]}" - del args[i + 1] - elif arg.endswith("=") and i < len(args) - 1 and "=" not in args[i + 1]: # merge ['arg=', 'val'] - new_args.append(f"{arg}{args[i + 1]}") - del args[i + 1] - elif arg.startswith("=") and i > 0: # merge ['arg', '=val'] - new_args[-1] += arg - else: - new_args.append(arg) - return new_args - - -def handle_yolo_hub(args: List[str]) -> None: - """ - Handle Ultralytics HUB command-line interface (CLI) commands. - - This function processes Ultralytics HUB CLI commands such as login and logout. - It should be called when executing a script with arguments related to HUB authentication. - - Args: - args (List[str]): A list of command line arguments - - Example: - ```bash - python my_script.py hub login your_api_key - ``` - """ - from ultralytics import hub - - if args[0] == "login": - key = args[1] if len(args) > 1 else "" - # Log in to Ultralytics HUB using the provided API key - hub.login(key) - elif args[0] == "logout": - # Log out from Ultralytics HUB - hub.logout() - - -def handle_yolo_settings(args: List[str]) -> None: - """ - Handle YOLO settings command-line interface (CLI) commands. - - This function processes YOLO settings CLI commands such as reset. - It should be called when executing a script with arguments related to YOLO settings management. - - Args: - args (List[str]): A list of command line arguments for YOLO settings management. - - Example: - ```bash - python my_script.py yolo settings reset - ``` - """ - url = "https://docs.ultralytics.com/quickstart/#ultralytics-settings" # help URL - try: - if any(args): - if args[0] == "reset": - SETTINGS_YAML.unlink() # delete the settings file - SETTINGS.reset() # create new settings - LOGGER.info("Settings reset successfully") # inform the user that settings have been reset - else: # save a new setting - new = dict(parse_key_value_pair(a) for a in args) - check_dict_alignment(SETTINGS, new) - SETTINGS.update(new) - - LOGGER.info(f"💡 Learn about settings at {url}") - yaml_print(SETTINGS_YAML) # print the current settings - except Exception as e: - LOGGER.warning(f"WARNING ⚠️ settings error: '{e}'. Please see {url} for help.") - - -def handle_explorer(): - """Open the Ultralytics Explorer GUI.""" - checks.check_requirements("streamlit") - LOGGER.info("💡 Loading Explorer dashboard...") - subprocess.run(["streamlit", "run", ROOT / "data/explorer/gui/dash.py", "--server.maxMessageSize", "2048"]) - - -def parse_key_value_pair(pair): - """Parse one 'key=value' pair and return key and value.""" - k, v = pair.split("=", 1) # split on first '=' sign - k, v = k.strip(), v.strip() # remove spaces - assert v, f"missing '{k}' value" - return k, smart_value(v) - - -def smart_value(v): - """Convert a string to an underlying type such as int, float, bool, etc.""" - v_lower = v.lower() - if v_lower == "none": - return None - elif v_lower == "true": - return True - elif v_lower == "false": - return False - else: - with contextlib.suppress(Exception): - return eval(v) - return v - - -def entrypoint(debug=""): - """ - This function is the ultralytics package entrypoint, it's responsible for parsing the command line arguments passed - to the package. - - This function allows for: - - passing mandatory YOLO args as a list of strings - - specifying the task to be performed, either 'detect', 'segment' or 'classify' - - specifying the mode, either 'train', 'val', 'test', or 'predict' - - running special modes like 'checks' - - passing overrides to the package's configuration - - It uses the package's default cfg and initializes it using the passed overrides. - Then it calls the CLI function with the composed cfg - """ - args = (debug.split(" ") if debug else sys.argv)[1:] - if not args: # no arguments passed - LOGGER.info(CLI_HELP_MSG) - return - - special = { - "help": lambda: LOGGER.info(CLI_HELP_MSG), - "checks": checks.collect_system_info, - "version": lambda: LOGGER.info(__version__), - "settings": lambda: handle_yolo_settings(args[1:]), - "cfg": lambda: yaml_print(DEFAULT_CFG_PATH), - "hub": lambda: handle_yolo_hub(args[1:]), - "login": lambda: handle_yolo_hub(args), - "copy-cfg": copy_default_cfg, - "explorer": lambda: handle_explorer(), - } - full_args_dict = {**DEFAULT_CFG_DICT, **{k: None for k in TASKS}, **{k: None for k in MODES}, **special} - - # Define common misuses of special commands, i.e. -h, -help, --help - special.update({k[0]: v for k, v in special.items()}) # singular - special.update({k[:-1]: v for k, v in special.items() if len(k) > 1 and k.endswith("s")}) # singular - special = {**special, **{f"-{k}": v for k, v in special.items()}, **{f"--{k}": v for k, v in special.items()}} - - overrides = {} # basic overrides, i.e. imgsz=320 - for a in merge_equals_args(args): # merge spaces around '=' sign - if a.startswith("--"): - LOGGER.warning(f"WARNING ⚠️ '{a}' does not require leading dashes '--', updating to '{a[2:]}'.") - a = a[2:] - if a.endswith(","): - LOGGER.warning(f"WARNING ⚠️ '{a}' does not require trailing comma ',', updating to '{a[:-1]}'.") - a = a[:-1] - if "=" in a: - try: - k, v = parse_key_value_pair(a) - if k == "cfg" and v is not None: # custom.yaml passed - LOGGER.info(f"Overriding {DEFAULT_CFG_PATH} with {v}") - overrides = {k: val for k, val in yaml_load(checks.check_yaml(v)).items() if k != "cfg"} - else: - overrides[k] = v - except (NameError, SyntaxError, ValueError, AssertionError) as e: - check_dict_alignment(full_args_dict, {a: ""}, e) - - elif a in TASKS: - overrides["task"] = a - elif a in MODES: - overrides["mode"] = a - elif a.lower() in special: - special[a.lower()]() - return - elif a in DEFAULT_CFG_DICT and isinstance(DEFAULT_CFG_DICT[a], bool): - overrides[a] = True # auto-True for default bool args, i.e. 'yolo show' sets show=True - elif a in DEFAULT_CFG_DICT: - raise SyntaxError( - f"'{colorstr('red', 'bold', a)}' is a valid YOLO argument but is missing an '=' sign " - f"to set its value, i.e. try '{a}={DEFAULT_CFG_DICT[a]}'\n{CLI_HELP_MSG}" - ) - else: - check_dict_alignment(full_args_dict, {a: ""}) - - # Check keys - check_dict_alignment(full_args_dict, overrides) - - # Mode - mode = overrides.get("mode") - if mode is None: - mode = DEFAULT_CFG.mode or "predict" - LOGGER.warning(f"WARNING ⚠️ 'mode' is missing. Valid modes are {MODES}. Using default 'mode={mode}'.") - elif mode not in MODES: - raise ValueError(f"Invalid 'mode={mode}'. Valid modes are {MODES}.\n{CLI_HELP_MSG}") - - # Task - task = overrides.pop("task", None) - if task: - if task not in TASKS: - raise ValueError(f"Invalid 'task={task}'. Valid tasks are {TASKS}.\n{CLI_HELP_MSG}") - if "model" not in overrides: - overrides["model"] = TASK2MODEL[task] - - # Model - model = overrides.pop("model", DEFAULT_CFG.model) - if model is None: - model = "yolov8n.pt" - LOGGER.warning(f"WARNING ⚠️ 'model' is missing. Using default 'model={model}'.") - overrides["model"] = model - stem = Path(model).stem.lower() - if "rtdetr" in stem: # guess architecture - from ultralytics import RTDETR - - model = RTDETR(model) # no task argument - elif "fastsam" in stem: - from ultralytics import FastSAM - - model = FastSAM(model) - elif "sam" in stem: - from ultralytics import SAM - - model = SAM(model) - else: - from ultralytics import YOLO - - model = YOLO(model, task=task) - if isinstance(overrides.get("pretrained"), str): - model.load(overrides["pretrained"]) - - # Task Update - if task != model.task: - if task: - LOGGER.warning( - f"WARNING ⚠️ conflicting 'task={task}' passed with 'task={model.task}' model. " - f"Ignoring 'task={task}' and updating to 'task={model.task}' to match model." - ) - task = model.task - - # Mode - if mode in ("predict", "track") and "source" not in overrides: - overrides["source"] = DEFAULT_CFG.source or ASSETS - LOGGER.warning(f"WARNING ⚠️ 'source' is missing. Using default 'source={overrides['source']}'.") - elif mode in ("train", "val"): - if "data" not in overrides and "resume" not in overrides: - overrides["data"] = DEFAULT_CFG.data or TASK2DATA.get(task or DEFAULT_CFG.task, DEFAULT_CFG.data) - LOGGER.warning(f"WARNING ⚠️ 'data' is missing. Using default 'data={overrides['data']}'.") - elif mode == "export": - if "format" not in overrides: - overrides["format"] = DEFAULT_CFG.format or "torchscript" - LOGGER.warning(f"WARNING ⚠️ 'format' is missing. Using default 'format={overrides['format']}'.") - - # Run command in python - getattr(model, mode)(**overrides) # default args from model - - # Show help - LOGGER.info(f"💡 Learn more at https://docs.ultralytics.com/modes/{mode}") - - -# Special modes -------------------------------------------------------------------------------------------------------- -def copy_default_cfg(): - """Copy and create a new default configuration file with '_copy' appended to its name.""" - new_file = Path.cwd() / DEFAULT_CFG_PATH.name.replace(".yaml", "_copy.yaml") - shutil.copy2(DEFAULT_CFG_PATH, new_file) - LOGGER.info( - f"{DEFAULT_CFG_PATH} copied to {new_file}\n" - f"Example YOLO command with this new custom cfg:\n yolo cfg='{new_file}' imgsz=320 batch=8" - ) - - -if __name__ == "__main__": - # Example: entrypoint(debug='yolo predict model=yolov8n.pt') - entrypoint(debug="") diff --git a/ultralytics-main/ultralytics/cfg/default.yaml b/ultralytics-main/ultralytics/cfg/default.yaml deleted file mode 100644 index 5ddd257..0000000 --- a/ultralytics-main/ultralytics/cfg/default.yaml +++ /dev/null @@ -1,125 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# Default training settings and hyperparameters for medium-augmentation COCO training - -task: detect # (str) YOLO task, i.e. detect, segment, classify, pose -mode: train # (str) YOLO mode, i.e. train, val, predict, export, track, benchmark - -# Train settings ------------------------------------------------------------------------------------------------------- -model: # (str, optional) path to model file, i.e. yolov8n.pt, yolov8n.yaml -data: # (str, optional) path to data file, i.e. coco128.yaml -epochs: 100 # (int) number of epochs to train for -time: # (float, optional) number of hours to train for, overrides epochs if supplied -patience: 100 # (int) epochs to wait for no observable improvement for early stopping of training -batch: 16 # (int) number of images per batch (-1 for AutoBatch) -imgsz: 640 # (int | list) input images size as int for train and val modes, or list[w,h] for predict and export modes -save: True # (bool) save train checkpoints and predict results -save_period: -1 # (int) Save checkpoint every x epochs (disabled if < 1) -cache: False # (bool) True/ram, disk or False. Use cache for data loading -device: # (int | str | list, optional) device to run on, i.e. cuda device=0 or device=0,1,2,3 or device=cpu -workers: 8 # (int) number of worker threads for data loading (per RANK if DDP) -project: # (str, optional) project name -name: # (str, optional) experiment name, results saved to 'project/name' directory -exist_ok: False # (bool) whether to overwrite existing experiment -pretrained: True # (bool | str) whether to use a pretrained model (bool) or a model to load weights from (str) -optimizer: auto # (str) optimizer to use, choices=[SGD, Adam, Adamax, AdamW, NAdam, RAdam, RMSProp, auto] -verbose: True # (bool) whether to print verbose output -seed: 0 # (int) random seed for reproducibility -deterministic: True # (bool) whether to enable deterministic mode -single_cls: False # (bool) train multi-class data as single-class -rect: False # (bool) rectangular training if mode='train' or rectangular validation if mode='val' -cos_lr: False # (bool) use cosine learning rate scheduler -close_mosaic: 10 # (int) disable mosaic augmentation for final epochs (0 to disable) -resume: False # (bool) resume training from last checkpoint -amp: True # (bool) Automatic Mixed Precision (AMP) training, choices=[True, False], True runs AMP check -fraction: 1.0 # (float) dataset fraction to train on (default is 1.0, all images in train set) -profile: False # (bool) profile ONNX and TensorRT speeds during training for loggers -freeze: None # (int | list, optional) freeze first n layers, or freeze list of layer indices during training -multi_scale: False # (bool) Whether to use multiscale during training -# Segmentation -overlap_mask: True # (bool) masks should overlap during training (segment train only) -mask_ratio: 4 # (int) mask downsample ratio (segment train only) -# Classification -dropout: 0.0 # (float) use dropout regularization (classify train only) - -# Val/Test settings ---------------------------------------------------------------------------------------------------- -val: True # (bool) validate/test during training -split: val # (str) dataset split to use for validation, i.e. 'val', 'test' or 'train' -save_json: False # (bool) save results to JSON file -save_hybrid: False # (bool) save hybrid version of labels (labels + additional predictions) -conf: # (float, optional) object confidence threshold for detection (default 0.25 predict, 0.001 val) -iou: 0.7 # (float) intersection over union (IoU) threshold for NMS -max_det: 300 # (int) maximum number of detections per image -half: False # (bool) use half precision (FP16) -dnn: False # (bool) use OpenCV DNN for ONNX inference -plots: True # (bool) save plots and images during train/val - -# Predict settings ----------------------------------------------------------------------------------------------------- -source: # (str, optional) source directory for images or videos -vid_stride: 1 # (int) video frame-rate stride -stream_buffer: False # (bool) buffer all streaming frames (True) or return the most recent frame (False) -visualize: False # (bool) visualize model features -augment: False # (bool) apply image augmentation to prediction sources -agnostic_nms: False # (bool) class-agnostic NMS -classes: # (int | list[int], optional) filter results by class, i.e. classes=0, or classes=[0,2,3] -retina_masks: False # (bool) use high-resolution segmentation masks -embed: # (list[int], optional) return feature vectors/embeddings from given layers - -# Visualize settings --------------------------------------------------------------------------------------------------- -show: False # (bool) show predicted images and videos if environment allows -save_frames: False # (bool) save predicted individual video frames -save_txt: False # (bool) save results as .txt file -save_conf: False # (bool) save results with confidence scores -save_crop: False # (bool) save cropped images with results -show_labels: True # (bool) show prediction labels, i.e. 'person' -show_conf: True # (bool) show prediction confidence, i.e. '0.99' -show_boxes: True # (bool) show prediction boxes -line_width: # (int, optional) line width of the bounding boxes. Scaled to image size if None. - -# Export settings ------------------------------------------------------------------------------------------------------ -format: torchscript # (str) format to export to, choices at https://docs.ultralytics.com/modes/export/#export-formats -keras: False # (bool) use Kera=s -optimize: False # (bool) TorchScript: optimize for mobile -int8: False # (bool) CoreML/TF INT8 quantization -dynamic: False # (bool) ONNX/TF/TensorRT: dynamic axes -simplify: False # (bool) ONNX: simplify model -opset: # (int, optional) ONNX: opset version -workspace: 4 # (int) TensorRT: workspace size (GB) -nms: False # (bool) CoreML: add NMS - -# Hyperparameters ------------------------------------------------------------------------------------------------------ -lr0: 0.01 # (float) initial learning rate (i.e. SGD=1E-2, Adam=1E-3) -lrf: 0.01 # (float) final learning rate (lr0 * lrf) -momentum: 0.937 # (float) SGD momentum/Adam beta1 -weight_decay: 0.0005 # (float) optimizer weight decay 5e-4 -warmup_epochs: 3.0 # (float) warmup epochs (fractions ok) -warmup_momentum: 0.8 # (float) warmup initial momentum -warmup_bias_lr: 0.1 # (float) warmup initial bias lr -box: 7.5 # (float) box loss gain -cls: 0.5 # (float) cls loss gain (scale with pixels) -dfl: 1.5 # (float) dfl loss gain -pose: 12.0 # (float) pose loss gain -kobj: 1.0 # (float) keypoint obj loss gain -label_smoothing: 0.0 # (float) label smoothing (fraction) -nbs: 64 # (int) nominal batch size -hsv_h: 0.015 # (float) image HSV-Hue augmentation (fraction) -hsv_s: 0.7 # (float) image HSV-Saturation augmentation (fraction) -hsv_v: 0.4 # (float) image HSV-Value augmentation (fraction) -degrees: 0.0 # (float) image rotation (+/- deg) -translate: 0.1 # (float) image translation (+/- fraction) -scale: 0.5 # (float) image scale (+/- gain) -shear: 0.0 # (float) image shear (+/- deg) -perspective: 0.0 # (float) image perspective (+/- fraction), range 0-0.001 -flipud: 0.0 # (float) image flip up-down (probability) -fliplr: 0.5 # (float) image flip left-right (probability) -mosaic: 1.0 # (float) image mosaic (probability) -mixup: 0.0 # (float) image mixup (probability) -copy_paste: 0.0 # (float) segment copy-paste (probability) -auto_augment: randaugment # (str) auto augmentation policy for classification (randaugment, autoaugment, augmix) -erasing: 0.4 # (float) probability of random erasing during classification training (0-1) -crop_fraction: 1.0 # (float) image crop fraction for classification evaluation/inference (0-1) - -# Custom config.yaml --------------------------------------------------------------------------------------------------- -cfg: # (str, optional) for overriding defaults.yaml - -# Tracker settings ------------------------------------------------------------------------------------------------------ -tracker: botsort.yaml # (str) tracker type, choices=[botsort.yaml, bytetrack.yaml] diff --git a/ultralytics-main/ultralytics/cfg/models/README.md b/ultralytics-main/ultralytics/cfg/models/README.md deleted file mode 100644 index c022fb5..0000000 --- a/ultralytics-main/ultralytics/cfg/models/README.md +++ /dev/null @@ -1,40 +0,0 @@ -## Models - -Welcome to the Ultralytics Models directory! Here you will find a wide variety of pre-configured model configuration files (`*.yaml`s) that can be used to create custom YOLO models. The models in this directory have been expertly crafted and fine-tuned by the Ultralytics team to provide the best performance for a wide range of object detection and image segmentation tasks. - -These model configurations cover a wide range of scenarios, from simple object detection to more complex tasks like instance segmentation and object tracking. They are also designed to run efficiently on a variety of hardware platforms, from CPUs to GPUs. Whether you are a seasoned machine learning practitioner or just getting started with YOLO, this directory provides a great starting point for your custom model development needs. - -To get started, simply browse through the models in this directory and find one that best suits your needs. Once you've selected a model, you can use the provided `*.yaml` file to train and deploy your custom YOLO model with ease. See full details at the Ultralytics [Docs](https://docs.ultralytics.com/models), and if you need help or have any questions, feel free to reach out to the Ultralytics team for support. So, don't wait, start creating your custom YOLO model now! - -### Usage - -Model `*.yaml` files may be used directly in the Command Line Interface (CLI) with a `yolo` command: - -```bash -yolo task=detect mode=train model=yolov8n.yaml data=coco128.yaml epochs=100 -``` - -They may also be used directly in a Python environment, and accepts the same [arguments](https://docs.ultralytics.com/usage/cfg/) as in the CLI example above: - -```python -from ultralytics import YOLO - -model = YOLO("model.yaml") # build a YOLOv8n model from scratch -# YOLO("model.pt") use pre-trained model if available -model.info() # display model information -model.train(data="coco128.yaml", epochs=100) # train the model -``` - -## Pre-trained Model Architectures - -Ultralytics supports many model architectures. Visit https://docs.ultralytics.com/models to view detailed information and usage. Any of these models can be used by loading their configs or pretrained checkpoints if available. - -## Contribute New Models - -Have you trained a new YOLO variant or achieved state-of-the-art performance with specific tuning? We'd love to showcase your work in our Models section! Contributions from the community in the form of new models, architectures, or optimizations are highly valued and can significantly enrich our repository. - -By contributing to this section, you're helping us offer a wider array of model choices and configurations to the community. It's a fantastic way to share your knowledge and expertise while making the Ultralytics YOLO ecosystem even more versatile. - -To get started, please consult our [Contributing Guide](https://docs.ultralytics.com/help/contributing) for step-by-step instructions on how to submit a Pull Request (PR) 🛠️. Your contributions are eagerly awaited! - -Let's join hands to extend the range and capabilities of the Ultralytics YOLO models 🙏! diff --git a/ultralytics-main/ultralytics/cfg/models/rt-detr/rtdetr-l.yaml b/ultralytics-main/ultralytics/cfg/models/rt-detr/rtdetr-l.yaml deleted file mode 100644 index c6eb0b3..0000000 --- a/ultralytics-main/ultralytics/cfg/models/rt-detr/rtdetr-l.yaml +++ /dev/null @@ -1,50 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# RT-DETR-l object detection model with P3-P5 outputs. For details see https://docs.ultralytics.com/models/rtdetr - -# Parameters -nc: 80 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n-cls.yaml' will call yolov8-cls.yaml with scale 'n' - # [depth, width, max_channels] - l: [1.00, 1.00, 1024] - -backbone: - # [from, repeats, module, args] - - [-1, 1, HGStem, [32, 48]] # 0-P2/4 - - [-1, 6, HGBlock, [48, 128, 3]] # stage 1 - - - [-1, 1, DWConv, [128, 3, 2, 1, False]] # 2-P3/8 - - [-1, 6, HGBlock, [96, 512, 3]] # stage 2 - - - [-1, 1, DWConv, [512, 3, 2, 1, False]] # 4-P3/16 - - [-1, 6, HGBlock, [192, 1024, 5, True, False]] # cm, c2, k, light, shortcut - - [-1, 6, HGBlock, [192, 1024, 5, True, True]] - - [-1, 6, HGBlock, [192, 1024, 5, True, True]] # stage 3 - - - [-1, 1, DWConv, [1024, 3, 2, 1, False]] # 8-P4/32 - - [-1, 6, HGBlock, [384, 2048, 5, True, False]] # stage 4 - -head: - - [-1, 1, Conv, [256, 1, 1, None, 1, 1, False]] # 10 input_proj.2 - - [-1, 1, AIFI, [1024, 8]] - - [-1, 1, Conv, [256, 1, 1]] # 12, Y5, lateral_convs.0 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [7, 1, Conv, [256, 1, 1, None, 1, 1, False]] # 14 input_proj.1 - - [[-2, -1], 1, Concat, [1]] - - [-1, 3, RepC3, [256]] # 16, fpn_blocks.0 - - [-1, 1, Conv, [256, 1, 1]] # 17, Y4, lateral_convs.1 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [3, 1, Conv, [256, 1, 1, None, 1, 1, False]] # 19 input_proj.0 - - [[-2, -1], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, RepC3, [256]] # X3 (21), fpn_blocks.1 - - - [-1, 1, Conv, [256, 3, 2]] # 22, downsample_convs.0 - - [[-1, 17], 1, Concat, [1]] # cat Y4 - - [-1, 3, RepC3, [256]] # F4 (24), pan_blocks.0 - - - [-1, 1, Conv, [256, 3, 2]] # 25, downsample_convs.1 - - [[-1, 12], 1, Concat, [1]] # cat Y5 - - [-1, 3, RepC3, [256]] # F5 (27), pan_blocks.1 - - - [[21, 24, 27], 1, RTDETRDecoder, [nc]] # Detect(P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/rt-detr/rtdetr-resnet101.yaml b/ultralytics-main/ultralytics/cfg/models/rt-detr/rtdetr-resnet101.yaml deleted file mode 100644 index a68bb5d..0000000 --- a/ultralytics-main/ultralytics/cfg/models/rt-detr/rtdetr-resnet101.yaml +++ /dev/null @@ -1,42 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# RT-DETR-ResNet101 object detection model with P3-P5 outputs. - -# Parameters -nc: 80 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n-cls.yaml' will call yolov8-cls.yaml with scale 'n' - # [depth, width, max_channels] - l: [1.00, 1.00, 1024] - -backbone: - # [from, repeats, module, args] - - [-1, 1, ResNetLayer, [3, 64, 1, True, 1]] # 0 - - [-1, 1, ResNetLayer, [64, 64, 1, False, 3]] # 1 - - [-1, 1, ResNetLayer, [256, 128, 2, False, 4]] # 2 - - [-1, 1, ResNetLayer, [512, 256, 2, False, 23]] # 3 - - [-1, 1, ResNetLayer, [1024, 512, 2, False, 3]] # 4 - -head: - - [-1, 1, Conv, [256, 1, 1, None, 1, 1, False]] # 5 - - [-1, 1, AIFI, [1024, 8]] - - [-1, 1, Conv, [256, 1, 1]] # 7 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [3, 1, Conv, [256, 1, 1, None, 1, 1, False]] # 9 - - [[-2, -1], 1, Concat, [1]] - - [-1, 3, RepC3, [256]] # 11 - - [-1, 1, Conv, [256, 1, 1]] # 12 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [2, 1, Conv, [256, 1, 1, None, 1, 1, False]] # 14 - - [[-2, -1], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, RepC3, [256]] # X3 (16), fpn_blocks.1 - - - [-1, 1, Conv, [256, 3, 2]] # 17, downsample_convs.0 - - [[-1, 12], 1, Concat, [1]] # cat Y4 - - [-1, 3, RepC3, [256]] # F4 (19), pan_blocks.0 - - - [-1, 1, Conv, [256, 3, 2]] # 20, downsample_convs.1 - - [[-1, 7], 1, Concat, [1]] # cat Y5 - - [-1, 3, RepC3, [256]] # F5 (22), pan_blocks.1 - - - [[16, 19, 22], 1, RTDETRDecoder, [nc]] # Detect(P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/rt-detr/rtdetr-resnet50.yaml b/ultralytics-main/ultralytics/cfg/models/rt-detr/rtdetr-resnet50.yaml deleted file mode 100644 index 7145910..0000000 --- a/ultralytics-main/ultralytics/cfg/models/rt-detr/rtdetr-resnet50.yaml +++ /dev/null @@ -1,42 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# RT-DETR-ResNet50 object detection model with P3-P5 outputs. - -# Parameters -nc: 80 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n-cls.yaml' will call yolov8-cls.yaml with scale 'n' - # [depth, width, max_channels] - l: [1.00, 1.00, 1024] - -backbone: - # [from, repeats, module, args] - - [-1, 1, ResNetLayer, [3, 64, 1, True, 1]] # 0 - - [-1, 1, ResNetLayer, [64, 64, 1, False, 3]] # 1 - - [-1, 1, ResNetLayer, [256, 128, 2, False, 4]] # 2 - - [-1, 1, ResNetLayer, [512, 256, 2, False, 6]] # 3 - - [-1, 1, ResNetLayer, [1024, 512, 2, False, 3]] # 4 - -head: - - [-1, 1, Conv, [256, 1, 1, None, 1, 1, False]] # 5 - - [-1, 1, AIFI, [1024, 8]] - - [-1, 1, Conv, [256, 1, 1]] # 7 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [3, 1, Conv, [256, 1, 1, None, 1, 1, False]] # 9 - - [[-2, -1], 1, Concat, [1]] - - [-1, 3, RepC3, [256]] # 11 - - [-1, 1, Conv, [256, 1, 1]] # 12 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [2, 1, Conv, [256, 1, 1, None, 1, 1, False]] # 14 - - [[-2, -1], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, RepC3, [256]] # X3 (16), fpn_blocks.1 - - - [-1, 1, Conv, [256, 3, 2]] # 17, downsample_convs.0 - - [[-1, 12], 1, Concat, [1]] # cat Y4 - - [-1, 3, RepC3, [256]] # F4 (19), pan_blocks.0 - - - [-1, 1, Conv, [256, 3, 2]] # 20, downsample_convs.1 - - [[-1, 7], 1, Concat, [1]] # cat Y5 - - [-1, 3, RepC3, [256]] # F5 (22), pan_blocks.1 - - - [[16, 19, 22], 1, RTDETRDecoder, [nc]] # Detect(P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/rt-detr/rtdetr-x.yaml b/ultralytics-main/ultralytics/cfg/models/rt-detr/rtdetr-x.yaml deleted file mode 100644 index 0e819b0..0000000 --- a/ultralytics-main/ultralytics/cfg/models/rt-detr/rtdetr-x.yaml +++ /dev/null @@ -1,54 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# RT-DETR-x object detection model with P3-P5 outputs. For details see https://docs.ultralytics.com/models/rtdetr - -# Parameters -nc: 80 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n-cls.yaml' will call yolov8-cls.yaml with scale 'n' - # [depth, width, max_channels] - x: [1.00, 1.00, 2048] - -backbone: - # [from, repeats, module, args] - - [-1, 1, HGStem, [32, 64]] # 0-P2/4 - - [-1, 6, HGBlock, [64, 128, 3]] # stage 1 - - - [-1, 1, DWConv, [128, 3, 2, 1, False]] # 2-P3/8 - - [-1, 6, HGBlock, [128, 512, 3]] - - [-1, 6, HGBlock, [128, 512, 3, False, True]] # 4-stage 2 - - - [-1, 1, DWConv, [512, 3, 2, 1, False]] # 5-P3/16 - - [-1, 6, HGBlock, [256, 1024, 5, True, False]] # cm, c2, k, light, shortcut - - [-1, 6, HGBlock, [256, 1024, 5, True, True]] - - [-1, 6, HGBlock, [256, 1024, 5, True, True]] - - [-1, 6, HGBlock, [256, 1024, 5, True, True]] - - [-1, 6, HGBlock, [256, 1024, 5, True, True]] # 10-stage 3 - - - [-1, 1, DWConv, [1024, 3, 2, 1, False]] # 11-P4/32 - - [-1, 6, HGBlock, [512, 2048, 5, True, False]] - - [-1, 6, HGBlock, [512, 2048, 5, True, True]] # 13-stage 4 - -head: - - [-1, 1, Conv, [384, 1, 1, None, 1, 1, False]] # 14 input_proj.2 - - [-1, 1, AIFI, [2048, 8]] - - [-1, 1, Conv, [384, 1, 1]] # 16, Y5, lateral_convs.0 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [10, 1, Conv, [384, 1, 1, None, 1, 1, False]] # 18 input_proj.1 - - [[-2, -1], 1, Concat, [1]] - - [-1, 3, RepC3, [384]] # 20, fpn_blocks.0 - - [-1, 1, Conv, [384, 1, 1]] # 21, Y4, lateral_convs.1 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [4, 1, Conv, [384, 1, 1, None, 1, 1, False]] # 23 input_proj.0 - - [[-2, -1], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, RepC3, [384]] # X3 (25), fpn_blocks.1 - - - [-1, 1, Conv, [384, 3, 2]] # 26, downsample_convs.0 - - [[-1, 21], 1, Concat, [1]] # cat Y4 - - [-1, 3, RepC3, [384]] # F4 (28), pan_blocks.0 - - - [-1, 1, Conv, [384, 3, 2]] # 29, downsample_convs.1 - - [[-1, 16], 1, Concat, [1]] # cat Y5 - - [-1, 3, RepC3, [384]] # F5 (31), pan_blocks.1 - - - [[25, 28, 31], 1, RTDETRDecoder, [nc]] # Detect(P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/v3/yolov3-spp.yaml b/ultralytics-main/ultralytics/cfg/models/v3/yolov3-spp.yaml deleted file mode 100644 index 6724f4e..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v3/yolov3-spp.yaml +++ /dev/null @@ -1,46 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv3-SPP object detection model with P3-P5 outputs. For details see https://docs.ultralytics.com/models/yolov3 - -# Parameters -nc: 80 # number of classes -depth_multiple: 1.0 # model depth multiple -width_multiple: 1.0 # layer channel multiple - -# darknet53 backbone -backbone: - # [from, number, module, args] - - [-1, 1, Conv, [32, 3, 1]] # 0 - - [-1, 1, Conv, [64, 3, 2]] # 1-P1/2 - - [-1, 1, Bottleneck, [64]] - - [-1, 1, Conv, [128, 3, 2]] # 3-P2/4 - - [-1, 2, Bottleneck, [128]] - - [-1, 1, Conv, [256, 3, 2]] # 5-P3/8 - - [-1, 8, Bottleneck, [256]] - - [-1, 1, Conv, [512, 3, 2]] # 7-P4/16 - - [-1, 8, Bottleneck, [512]] - - [-1, 1, Conv, [1024, 3, 2]] # 9-P5/32 - - [-1, 4, Bottleneck, [1024]] # 10 - -# YOLOv3-SPP head -head: - - [-1, 1, Bottleneck, [1024, False]] - - [-1, 1, SPP, [512, [5, 9, 13]]] - - [-1, 1, Conv, [1024, 3, 1]] - - [-1, 1, Conv, [512, 1, 1]] - - [-1, 1, Conv, [1024, 3, 1]] # 15 (P5/32-large) - - - [-2, 1, Conv, [256, 1, 1]] - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 8], 1, Concat, [1]] # cat backbone P4 - - [-1, 1, Bottleneck, [512, False]] - - [-1, 1, Bottleneck, [512, False]] - - [-1, 1, Conv, [256, 1, 1]] - - [-1, 1, Conv, [512, 3, 1]] # 22 (P4/16-medium) - - - [-2, 1, Conv, [128, 1, 1]] - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P3 - - [-1, 1, Bottleneck, [256, False]] - - [-1, 2, Bottleneck, [256, False]] # 27 (P3/8-small) - - - [[27, 22, 15], 1, Detect, [nc]] # Detect(P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/v3/yolov3-tiny.yaml b/ultralytics-main/ultralytics/cfg/models/v3/yolov3-tiny.yaml deleted file mode 100644 index f3fe257..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v3/yolov3-tiny.yaml +++ /dev/null @@ -1,37 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv3-tiny object detection model with P4-P5 outputs. For details see https://docs.ultralytics.com/models/yolov3 - -# Parameters -nc: 80 # number of classes -depth_multiple: 1.0 # model depth multiple -width_multiple: 1.0 # layer channel multiple - -# YOLOv3-tiny backbone -backbone: - # [from, number, module, args] - - [-1, 1, Conv, [16, 3, 1]] # 0 - - [-1, 1, nn.MaxPool2d, [2, 2, 0]] # 1-P1/2 - - [-1, 1, Conv, [32, 3, 1]] - - [-1, 1, nn.MaxPool2d, [2, 2, 0]] # 3-P2/4 - - [-1, 1, Conv, [64, 3, 1]] - - [-1, 1, nn.MaxPool2d, [2, 2, 0]] # 5-P3/8 - - [-1, 1, Conv, [128, 3, 1]] - - [-1, 1, nn.MaxPool2d, [2, 2, 0]] # 7-P4/16 - - [-1, 1, Conv, [256, 3, 1]] - - [-1, 1, nn.MaxPool2d, [2, 2, 0]] # 9-P5/32 - - [-1, 1, Conv, [512, 3, 1]] - - [-1, 1, nn.ZeroPad2d, [[0, 1, 0, 1]]] # 11 - - [-1, 1, nn.MaxPool2d, [2, 1, 0]] # 12 - -# YOLOv3-tiny head -head: - - [-1, 1, Conv, [1024, 3, 1]] - - [-1, 1, Conv, [256, 1, 1]] - - [-1, 1, Conv, [512, 3, 1]] # 15 (P5/32-large) - - - [-2, 1, Conv, [128, 1, 1]] - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 8], 1, Concat, [1]] # cat backbone P4 - - [-1, 1, Conv, [256, 3, 1]] # 19 (P4/16-medium) - - - [[19, 15], 1, Detect, [nc]] # Detect(P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/v3/yolov3.yaml b/ultralytics-main/ultralytics/cfg/models/v3/yolov3.yaml deleted file mode 100644 index 716866a..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v3/yolov3.yaml +++ /dev/null @@ -1,46 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv3 object detection model with P3-P5 outputs. For details see https://docs.ultralytics.com/models/yolov3 - -# Parameters -nc: 80 # number of classes -depth_multiple: 1.0 # model depth multiple -width_multiple: 1.0 # layer channel multiple - -# darknet53 backbone -backbone: - # [from, number, module, args] - - [-1, 1, Conv, [32, 3, 1]] # 0 - - [-1, 1, Conv, [64, 3, 2]] # 1-P1/2 - - [-1, 1, Bottleneck, [64]] - - [-1, 1, Conv, [128, 3, 2]] # 3-P2/4 - - [-1, 2, Bottleneck, [128]] - - [-1, 1, Conv, [256, 3, 2]] # 5-P3/8 - - [-1, 8, Bottleneck, [256]] - - [-1, 1, Conv, [512, 3, 2]] # 7-P4/16 - - [-1, 8, Bottleneck, [512]] - - [-1, 1, Conv, [1024, 3, 2]] # 9-P5/32 - - [-1, 4, Bottleneck, [1024]] # 10 - -# YOLOv3 head -head: - - [-1, 1, Bottleneck, [1024, False]] - - [-1, 1, Conv, [512, 1, 1]] - - [-1, 1, Conv, [1024, 3, 1]] - - [-1, 1, Conv, [512, 1, 1]] - - [-1, 1, Conv, [1024, 3, 1]] # 15 (P5/32-large) - - - [-2, 1, Conv, [256, 1, 1]] - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 8], 1, Concat, [1]] # cat backbone P4 - - [-1, 1, Bottleneck, [512, False]] - - [-1, 1, Bottleneck, [512, False]] - - [-1, 1, Conv, [256, 1, 1]] - - [-1, 1, Conv, [512, 3, 1]] # 22 (P4/16-medium) - - - [-2, 1, Conv, [128, 1, 1]] - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P3 - - [-1, 1, Bottleneck, [256, False]] - - [-1, 2, Bottleneck, [256, False]] # 27 (P3/8-small) - - - [[27, 22, 15], 1, Detect, [nc]] # Detect(P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/v5/yolov5-p6.yaml b/ultralytics-main/ultralytics/cfg/models/v5/yolov5-p6.yaml deleted file mode 100644 index 2fd3ac7..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v5/yolov5-p6.yaml +++ /dev/null @@ -1,59 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv5 object detection model with P3-P6 outputs. For details see https://docs.ultralytics.com/models/yolov5 - -# Parameters -nc: 80 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov5n-p6.yaml' will call yolov5-p6.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] - s: [0.33, 0.50, 1024] - m: [0.67, 0.75, 1024] - l: [1.00, 1.00, 1024] - x: [1.33, 1.25, 1024] - -# YOLOv5 v6.0 backbone -backbone: - # [from, number, module, args] - - [-1, 1, Conv, [64, 6, 2, 2]] # 0-P1/2 - - [-1, 1, Conv, [128, 3, 2]] # 1-P2/4 - - [-1, 3, C3, [128]] - - [-1, 1, Conv, [256, 3, 2]] # 3-P3/8 - - [-1, 6, C3, [256]] - - [-1, 1, Conv, [512, 3, 2]] # 5-P4/16 - - [-1, 9, C3, [512]] - - [-1, 1, Conv, [768, 3, 2]] # 7-P5/32 - - [-1, 3, C3, [768]] - - [-1, 1, Conv, [1024, 3, 2]] # 9-P6/64 - - [-1, 3, C3, [1024]] - - [-1, 1, SPPF, [1024, 5]] # 11 - -# YOLOv5 v6.0 head -head: - - [-1, 1, Conv, [768, 1, 1]] - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 8], 1, Concat, [1]] # cat backbone P5 - - [-1, 3, C3, [768, False]] # 15 - - - [-1, 1, Conv, [512, 1, 1]] - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, C3, [512, False]] # 19 - - - [-1, 1, Conv, [256, 1, 1]] - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 3, C3, [256, False]] # 23 (P3/8-small) - - - [-1, 1, Conv, [256, 3, 2]] - - [[-1, 20], 1, Concat, [1]] # cat head P4 - - [-1, 3, C3, [512, False]] # 26 (P4/16-medium) - - - [-1, 1, Conv, [512, 3, 2]] - - [[-1, 16], 1, Concat, [1]] # cat head P5 - - [-1, 3, C3, [768, False]] # 29 (P5/32-large) - - - [-1, 1, Conv, [768, 3, 2]] - - [[-1, 12], 1, Concat, [1]] # cat head P6 - - [-1, 3, C3, [1024, False]] # 32 (P6/64-xlarge) - - - [[23, 26, 29, 32], 1, Detect, [nc]] # Detect(P3, P4, P5, P6) diff --git a/ultralytics-main/ultralytics/cfg/models/v5/yolov5.yaml b/ultralytics-main/ultralytics/cfg/models/v5/yolov5.yaml deleted file mode 100644 index 8fdc79e..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v5/yolov5.yaml +++ /dev/null @@ -1,48 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv5 object detection model with P3-P5 outputs. For details see https://docs.ultralytics.com/models/yolov5 - -# Parameters -nc: 80 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov5n.yaml' will call yolov5.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] - s: [0.33, 0.50, 1024] - m: [0.67, 0.75, 1024] - l: [1.00, 1.00, 1024] - x: [1.33, 1.25, 1024] - -# YOLOv5 v6.0 backbone -backbone: - # [from, number, module, args] - - [-1, 1, Conv, [64, 6, 2, 2]] # 0-P1/2 - - [-1, 1, Conv, [128, 3, 2]] # 1-P2/4 - - [-1, 3, C3, [128]] - - [-1, 1, Conv, [256, 3, 2]] # 3-P3/8 - - [-1, 6, C3, [256]] - - [-1, 1, Conv, [512, 3, 2]] # 5-P4/16 - - [-1, 9, C3, [512]] - - [-1, 1, Conv, [1024, 3, 2]] # 7-P5/32 - - [-1, 3, C3, [1024]] - - [-1, 1, SPPF, [1024, 5]] # 9 - -# YOLOv5 v6.0 head -head: - - [-1, 1, Conv, [512, 1, 1]] - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, C3, [512, False]] # 13 - - - [-1, 1, Conv, [256, 1, 1]] - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 3, C3, [256, False]] # 17 (P3/8-small) - - - [-1, 1, Conv, [256, 3, 2]] - - [[-1, 14], 1, Concat, [1]] # cat head P4 - - [-1, 3, C3, [512, False]] # 20 (P4/16-medium) - - - [-1, 1, Conv, [512, 3, 2]] - - [[-1, 10], 1, Concat, [1]] # cat head P5 - - [-1, 3, C3, [1024, False]] # 23 (P5/32-large) - - - [[17, 20, 23], 1, Detect, [nc]] # Detect(P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/v6/yolov6.yaml b/ultralytics-main/ultralytics/cfg/models/v6/yolov6.yaml deleted file mode 100644 index f39dfb4..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v6/yolov6.yaml +++ /dev/null @@ -1,53 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv6 object detection model with P3-P5 outputs. For Usage examples see https://docs.ultralytics.com/models/yolov6 - -# Parameters -nc: 80 # number of classes -activation: nn.ReLU() # (optional) model default activation function -scales: # model compound scaling constants, i.e. 'model=yolov6n.yaml' will call yolov8.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] - s: [0.33, 0.50, 1024] - m: [0.67, 0.75, 768] - l: [1.00, 1.00, 512] - x: [1.00, 1.25, 512] - -# YOLOv6-3.0s backbone -backbone: - # [from, repeats, module, args] - - [-1, 1, Conv, [64, 3, 2]] # 0-P1/2 - - [-1, 1, Conv, [128, 3, 2]] # 1-P2/4 - - [-1, 6, Conv, [128, 3, 1]] - - [-1, 1, Conv, [256, 3, 2]] # 3-P3/8 - - [-1, 12, Conv, [256, 3, 1]] - - [-1, 1, Conv, [512, 3, 2]] # 5-P4/16 - - [-1, 18, Conv, [512, 3, 1]] - - [-1, 1, Conv, [1024, 3, 2]] # 7-P5/32 - - [-1, 6, Conv, [1024, 3, 1]] - - [-1, 1, SPPF, [1024, 5]] # 9 - -# YOLOv6-3.0s head -head: - - [-1, 1, Conv, [256, 1, 1]] - - [-1, 1, nn.ConvTranspose2d, [256, 2, 2, 0]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 1, Conv, [256, 3, 1]] - - [-1, 9, Conv, [256, 3, 1]] # 14 - - - [-1, 1, Conv, [128, 1, 1]] - - [-1, 1, nn.ConvTranspose2d, [128, 2, 2, 0]] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 1, Conv, [128, 3, 1]] - - [-1, 9, Conv, [128, 3, 1]] # 19 - - - [-1, 1, Conv, [128, 3, 2]] - - [[-1, 15], 1, Concat, [1]] # cat head P4 - - [-1, 1, Conv, [256, 3, 1]] - - [-1, 9, Conv, [256, 3, 1]] # 23 - - - [-1, 1, Conv, [256, 3, 2]] - - [[-1, 10], 1, Concat, [1]] # cat head P5 - - [-1, 1, Conv, [512, 3, 1]] - - [-1, 9, Conv, [512, 3, 1]] # 27 - - - [[19, 23, 27], 1, Detect, [nc]] # Detect(P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-cls-resnet101.yaml b/ultralytics-main/ultralytics/cfg/models/v8/yolov8-cls-resnet101.yaml deleted file mode 100644 index 6867f88..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-cls-resnet101.yaml +++ /dev/null @@ -1,25 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv8-cls image classification model. For Usage examples see https://docs.ultralytics.com/tasks/classify - -# Parameters -nc: 1000 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n-cls.yaml' will call yolov8-cls.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] - s: [0.33, 0.50, 1024] - m: [0.67, 0.75, 1024] - l: [1.00, 1.00, 1024] - x: [1.00, 1.25, 1024] - -# YOLOv8.0n backbone -backbone: - # [from, repeats, module, args] - - [-1, 1, ResNetLayer, [3, 64, 1, True, 1]] # 0-P1/2 - - [-1, 1, ResNetLayer, [64, 64, 1, False, 3]] # 1-P2/4 - - [-1, 1, ResNetLayer, [256, 128, 2, False, 4]] # 2-P3/8 - - [-1, 1, ResNetLayer, [512, 256, 2, False, 23]] # 3-P4/16 - - [-1, 1, ResNetLayer, [1024, 512, 2, False, 3]] # 4-P5/32 - -# YOLOv8.0n head -head: - - [-1, 1, Classify, [nc]] # Classify diff --git a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-cls-resnet50.yaml b/ultralytics-main/ultralytics/cfg/models/v8/yolov8-cls-resnet50.yaml deleted file mode 100644 index 8ffd111..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-cls-resnet50.yaml +++ /dev/null @@ -1,25 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv8-cls image classification model. For Usage examples see https://docs.ultralytics.com/tasks/classify - -# Parameters -nc: 1000 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n-cls.yaml' will call yolov8-cls.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] - s: [0.33, 0.50, 1024] - m: [0.67, 0.75, 1024] - l: [1.00, 1.00, 1024] - x: [1.00, 1.25, 1024] - -# YOLOv8.0n backbone -backbone: - # [from, repeats, module, args] - - [-1, 1, ResNetLayer, [3, 64, 1, True, 1]] # 0-P1/2 - - [-1, 1, ResNetLayer, [64, 64, 1, False, 3]] # 1-P2/4 - - [-1, 1, ResNetLayer, [256, 128, 2, False, 4]] # 2-P3/8 - - [-1, 1, ResNetLayer, [512, 256, 2, False, 6]] # 3-P4/16 - - [-1, 1, ResNetLayer, [1024, 512, 2, False, 3]] # 4-P5/32 - -# YOLOv8.0n head -head: - - [-1, 1, Classify, [nc]] # Classify diff --git a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-cls.yaml b/ultralytics-main/ultralytics/cfg/models/v8/yolov8-cls.yaml deleted file mode 100644 index 180fc65..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-cls.yaml +++ /dev/null @@ -1,29 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv8-cls image classification model. For Usage examples see https://docs.ultralytics.com/tasks/classify - -# Parameters -nc: 1000 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n-cls.yaml' will call yolov8-cls.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] - s: [0.33, 0.50, 1024] - m: [0.67, 0.75, 1024] - l: [1.00, 1.00, 1024] - x: [1.00, 1.25, 1024] - -# YOLOv8.0n backbone -backbone: - # [from, repeats, module, args] - - [-1, 1, Conv, [64, 3, 2]] # 0-P1/2 - - [-1, 1, Conv, [128, 3, 2]] # 1-P2/4 - - [-1, 3, C2f, [128, True]] - - [-1, 1, Conv, [256, 3, 2]] # 3-P3/8 - - [-1, 6, C2f, [256, True]] - - [-1, 1, Conv, [512, 3, 2]] # 5-P4/16 - - [-1, 6, C2f, [512, True]] - - [-1, 1, Conv, [1024, 3, 2]] # 7-P5/32 - - [-1, 3, C2f, [1024, True]] - -# YOLOv8.0n head -head: - - [-1, 1, Classify, [nc]] # Classify diff --git a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-ghost-p2.yaml b/ultralytics-main/ultralytics/cfg/models/v8/yolov8-ghost-p2.yaml deleted file mode 100644 index aee2093..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-ghost-p2.yaml +++ /dev/null @@ -1,54 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv8 object detection model with P2-P5 outputs. For Usage examples see https://docs.ultralytics.com/tasks/detect - -# Parameters -nc: 80 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n.yaml' will call yolov8.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] # YOLOv8n-ghost-p2 summary: 491 layers, 2033944 parameters, 2033928 gradients, 13.8 GFLOPs - s: [0.33, 0.50, 1024] # YOLOv8s-ghost-p2 summary: 491 layers, 5562080 parameters, 5562064 gradients, 25.1 GFLOPs - m: [0.67, 0.75, 768] # YOLOv8m-ghost-p2 summary: 731 layers, 9031728 parameters, 9031712 gradients, 42.8 GFLOPs - l: [1.00, 1.00, 512] # YOLOv8l-ghost-p2 summary: 971 layers, 12214448 parameters, 12214432 gradients, 69.1 GFLOPs - x: [1.00, 1.25, 512] # YOLOv8x-ghost-p2 summary: 971 layers, 18664776 parameters, 18664760 gradients, 103.3 GFLOPs - -# YOLOv8.0-ghost backbone -backbone: - # [from, repeats, module, args] - - [-1, 1, Conv, [64, 3, 2]] # 0-P1/2 - - [-1, 1, GhostConv, [128, 3, 2]] # 1-P2/4 - - [-1, 3, C3Ghost, [128, True]] - - [-1, 1, GhostConv, [256, 3, 2]] # 3-P3/8 - - [-1, 6, C3Ghost, [256, True]] - - [-1, 1, GhostConv, [512, 3, 2]] # 5-P4/16 - - [-1, 6, C3Ghost, [512, True]] - - [-1, 1, GhostConv, [1024, 3, 2]] # 7-P5/32 - - [-1, 3, C3Ghost, [1024, True]] - - [-1, 1, SPPF, [1024, 5]] # 9 - -# YOLOv8.0-ghost-p2 head -head: - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, C3Ghost, [512]] # 12 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 3, C3Ghost, [256]] # 15 (P3/8-small) - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 2], 1, Concat, [1]] # cat backbone P2 - - [-1, 3, C3Ghost, [128]] # 18 (P2/4-xsmall) - - - [-1, 1, GhostConv, [128, 3, 2]] - - [[-1, 15], 1, Concat, [1]] # cat head P3 - - [-1, 3, C3Ghost, [256]] # 21 (P3/8-small) - - - [-1, 1, GhostConv, [256, 3, 2]] - - [[-1, 12], 1, Concat, [1]] # cat head P4 - - [-1, 3, C3Ghost, [512]] # 24 (P4/16-medium) - - - [-1, 1, GhostConv, [512, 3, 2]] - - [[-1, 9], 1, Concat, [1]] # cat head P5 - - [-1, 3, C3Ghost, [1024]] # 27 (P5/32-large) - - - [[18, 21, 24, 27], 1, Detect, [nc]] # Detect(P2, P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-ghost-p6.yaml b/ultralytics-main/ultralytics/cfg/models/v8/yolov8-ghost-p6.yaml deleted file mode 100644 index b35f4cd..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-ghost-p6.yaml +++ /dev/null @@ -1,56 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv8 object detection model with P3-P6 outputs. For Usage examples see https://docs.ultralytics.com/tasks/detect - -# Parameters -nc: 80 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n-p6.yaml' will call yolov8-p6.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] # YOLOv8n-ghost-p6 summary: 529 layers, 2901100 parameters, 2901084 gradients, 5.8 GFLOPs - s: [0.33, 0.50, 1024] # YOLOv8s-ghost-p6 summary: 529 layers, 9520008 parameters, 9519992 gradients, 16.4 GFLOPs - m: [0.67, 0.75, 768] # YOLOv8m-ghost-p6 summary: 789 layers, 18002904 parameters, 18002888 gradients, 34.4 GFLOPs - l: [1.00, 1.00, 512] # YOLOv8l-ghost-p6 summary: 1049 layers, 21227584 parameters, 21227568 gradients, 55.3 GFLOPs - x: [1.00, 1.25, 512] # YOLOv8x-ghost-p6 summary: 1049 layers, 33057852 parameters, 33057836 gradients, 85.7 GFLOPs - -# YOLOv8.0-ghost backbone -backbone: - # [from, repeats, module, args] - - [-1, 1, Conv, [64, 3, 2]] # 0-P1/2 - - [-1, 1, GhostConv, [128, 3, 2]] # 1-P2/4 - - [-1, 3, C3Ghost, [128, True]] - - [-1, 1, GhostConv, [256, 3, 2]] # 3-P3/8 - - [-1, 6, C3Ghost, [256, True]] - - [-1, 1, GhostConv, [512, 3, 2]] # 5-P4/16 - - [-1, 6, C3Ghost, [512, True]] - - [-1, 1, GhostConv, [768, 3, 2]] # 7-P5/32 - - [-1, 3, C3Ghost, [768, True]] - - [-1, 1, GhostConv, [1024, 3, 2]] # 9-P6/64 - - [-1, 3, C3Ghost, [1024, True]] - - [-1, 1, SPPF, [1024, 5]] # 11 - -# YOLOv8.0-ghost-p6 head -head: - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 8], 1, Concat, [1]] # cat backbone P5 - - [-1, 3, C3Ghost, [768]] # 14 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, C3Ghost, [512]] # 17 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 3, C3Ghost, [256]] # 20 (P3/8-small) - - - [-1, 1, GhostConv, [256, 3, 2]] - - [[-1, 17], 1, Concat, [1]] # cat head P4 - - [-1, 3, C3Ghost, [512]] # 23 (P4/16-medium) - - - [-1, 1, GhostConv, [512, 3, 2]] - - [[-1, 14], 1, Concat, [1]] # cat head P5 - - [-1, 3, C3Ghost, [768]] # 26 (P5/32-large) - - - [-1, 1, GhostConv, [768, 3, 2]] - - [[-1, 11], 1, Concat, [1]] # cat head P6 - - [-1, 3, C3Ghost, [1024]] # 29 (P6/64-xlarge) - - - [[20, 23, 26, 29], 1, Detect, [nc]] # Detect(P3, P4, P5, P6) diff --git a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-ghost.yaml b/ultralytics-main/ultralytics/cfg/models/v8/yolov8-ghost.yaml deleted file mode 100644 index adc1802..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-ghost.yaml +++ /dev/null @@ -1,47 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv8 object detection model with P3-P5 outputs. For Usage examples see https://docs.ultralytics.com/tasks/detect -# Employs Ghost convolutions and modules proposed in Huawei's GhostNet in https://arxiv.org/abs/1911.11907v2 - -# Parameters -nc: 80 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n.yaml' will call yolov8.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] # YOLOv8n-ghost summary: 403 layers, 1865316 parameters, 1865300 gradients, 5.8 GFLOPs - s: [0.33, 0.50, 1024] # YOLOv8s-ghost summary: 403 layers, 5960072 parameters, 5960056 gradients, 16.4 GFLOPs - m: [0.67, 0.75, 768] # YOLOv8m-ghost summary: 603 layers, 10336312 parameters, 10336296 gradients, 32.7 GFLOPs - l: [1.00, 1.00, 512] # YOLOv8l-ghost summary: 803 layers, 14277872 parameters, 14277856 gradients, 53.7 GFLOPs - x: [1.00, 1.25, 512] # YOLOv8x-ghost summary: 803 layers, 22229308 parameters, 22229292 gradients, 83.3 GFLOPs - -# YOLOv8.0n-ghost backbone -backbone: - # [from, repeats, module, args] - - [-1, 1, Conv, [64, 3, 2]] # 0-P1/2 - - [-1, 1, GhostConv, [128, 3, 2]] # 1-P2/4 - - [-1, 3, C3Ghost, [128, True]] - - [-1, 1, GhostConv, [256, 3, 2]] # 3-P3/8 - - [-1, 6, C3Ghost, [256, True]] - - [-1, 1, GhostConv, [512, 3, 2]] # 5-P4/16 - - [-1, 6, C3Ghost, [512, True]] - - [-1, 1, GhostConv, [1024, 3, 2]] # 7-P5/32 - - [-1, 3, C3Ghost, [1024, True]] - - [-1, 1, SPPF, [1024, 5]] # 9 - -# YOLOv8.0n head -head: - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, C3Ghost, [512]] # 12 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 3, C3Ghost, [256]] # 15 (P3/8-small) - - - [-1, 1, GhostConv, [256, 3, 2]] - - [[-1, 12], 1, Concat, [1]] # cat head P4 - - [-1, 3, C3Ghost, [512]] # 18 (P4/16-medium) - - - [-1, 1, GhostConv, [512, 3, 2]] - - [[-1, 9], 1, Concat, [1]] # cat head P5 - - [-1, 3, C3Ghost, [1024]] # 21 (P5/32-large) - - - [[15, 18, 21], 1, Detect, [nc]] # Detect(P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-obb.yaml b/ultralytics-main/ultralytics/cfg/models/v8/yolov8-obb.yaml deleted file mode 100644 index 7a7f60c..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-obb.yaml +++ /dev/null @@ -1,46 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv8 Oriented Bounding Boxes (OBB) model with P3-P5 outputs. For Usage examples see https://docs.ultralytics.com/tasks/detect - -# Parameters -nc: 80 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n.yaml' will call yolov8.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] # YOLOv8n summary: 225 layers, 3157200 parameters, 3157184 gradients, 8.9 GFLOPs - s: [0.33, 0.50, 1024] # YOLOv8s summary: 225 layers, 11166560 parameters, 11166544 gradients, 28.8 GFLOPs - m: [0.67, 0.75, 768] # YOLOv8m summary: 295 layers, 25902640 parameters, 25902624 gradients, 79.3 GFLOPs - l: [1.00, 1.00, 512] # YOLOv8l summary: 365 layers, 43691520 parameters, 43691504 gradients, 165.7 GFLOPs - x: [1.00, 1.25, 512] # YOLOv8x summary: 365 layers, 68229648 parameters, 68229632 gradients, 258.5 GFLOPs - -# YOLOv8.0n backbone -backbone: - # [from, repeats, module, args] - - [-1, 1, Conv, [64, 3, 2]] # 0-P1/2 - - [-1, 1, Conv, [128, 3, 2]] # 1-P2/4 - - [-1, 3, C2f, [128, True]] - - [-1, 1, Conv, [256, 3, 2]] # 3-P3/8 - - [-1, 6, C2f, [256, True]] - - [-1, 1, Conv, [512, 3, 2]] # 5-P4/16 - - [-1, 6, C2f, [512, True]] - - [-1, 1, Conv, [1024, 3, 2]] # 7-P5/32 - - [-1, 3, C2f, [1024, True]] - - [-1, 1, SPPF, [1024, 5]] # 9 - -# YOLOv8.0n head -head: - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, C2f, [512]] # 12 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 3, C2f, [256]] # 15 (P3/8-small) - - - [-1, 1, Conv, [256, 3, 2]] - - [[-1, 12], 1, Concat, [1]] # cat head P4 - - [-1, 3, C2f, [512]] # 18 (P4/16-medium) - - - [-1, 1, Conv, [512, 3, 2]] - - [[-1, 9], 1, Concat, [1]] # cat head P5 - - [-1, 3, C2f, [1024]] # 21 (P5/32-large) - - - [[15, 18, 21], 1, OBB, [nc, 1]] # OBB(P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-p2.yaml b/ultralytics-main/ultralytics/cfg/models/v8/yolov8-p2.yaml deleted file mode 100644 index 5392774..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-p2.yaml +++ /dev/null @@ -1,54 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv8 object detection model with P2-P5 outputs. For Usage examples see https://docs.ultralytics.com/tasks/detect - -# Parameters -nc: 80 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n.yaml' will call yolov8.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] - s: [0.33, 0.50, 1024] - m: [0.67, 0.75, 768] - l: [1.00, 1.00, 512] - x: [1.00, 1.25, 512] - -# YOLOv8.0 backbone -backbone: - # [from, repeats, module, args] - - [-1, 1, Conv, [64, 3, 2]] # 0-P1/2 - - [-1, 1, Conv, [128, 3, 2]] # 1-P2/4 - - [-1, 3, C2f, [128, True]] - - [-1, 1, Conv, [256, 3, 2]] # 3-P3/8 - - [-1, 6, C2f, [256, True]] - - [-1, 1, Conv, [512, 3, 2]] # 5-P4/16 - - [-1, 6, C2f, [512, True]] - - [-1, 1, Conv, [1024, 3, 2]] # 7-P5/32 - - [-1, 3, C2f, [1024, True]] - - [-1, 1, SPPF, [1024, 5]] # 9 - -# YOLOv8.0-p2 head -head: - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, C2f, [512]] # 12 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 3, C2f, [256]] # 15 (P3/8-small) - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 2], 1, Concat, [1]] # cat backbone P2 - - [-1, 3, C2f, [128]] # 18 (P2/4-xsmall) - - - [-1, 1, Conv, [128, 3, 2]] - - [[-1, 15], 1, Concat, [1]] # cat head P3 - - [-1, 3, C2f, [256]] # 21 (P3/8-small) - - - [-1, 1, Conv, [256, 3, 2]] - - [[-1, 12], 1, Concat, [1]] # cat head P4 - - [-1, 3, C2f, [512]] # 24 (P4/16-medium) - - - [-1, 1, Conv, [512, 3, 2]] - - [[-1, 9], 1, Concat, [1]] # cat head P5 - - [-1, 3, C2f, [1024]] # 27 (P5/32-large) - - - [[18, 21, 24, 27], 1, Detect, [nc]] # Detect(P2, P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-p6.yaml b/ultralytics-main/ultralytics/cfg/models/v8/yolov8-p6.yaml deleted file mode 100644 index 2d6d5f9..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-p6.yaml +++ /dev/null @@ -1,56 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv8 object detection model with P3-P6 outputs. For Usage examples see https://docs.ultralytics.com/tasks/detect - -# Parameters -nc: 80 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n-p6.yaml' will call yolov8-p6.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] - s: [0.33, 0.50, 1024] - m: [0.67, 0.75, 768] - l: [1.00, 1.00, 512] - x: [1.00, 1.25, 512] - -# YOLOv8.0x6 backbone -backbone: - # [from, repeats, module, args] - - [-1, 1, Conv, [64, 3, 2]] # 0-P1/2 - - [-1, 1, Conv, [128, 3, 2]] # 1-P2/4 - - [-1, 3, C2f, [128, True]] - - [-1, 1, Conv, [256, 3, 2]] # 3-P3/8 - - [-1, 6, C2f, [256, True]] - - [-1, 1, Conv, [512, 3, 2]] # 5-P4/16 - - [-1, 6, C2f, [512, True]] - - [-1, 1, Conv, [768, 3, 2]] # 7-P5/32 - - [-1, 3, C2f, [768, True]] - - [-1, 1, Conv, [1024, 3, 2]] # 9-P6/64 - - [-1, 3, C2f, [1024, True]] - - [-1, 1, SPPF, [1024, 5]] # 11 - -# YOLOv8.0x6 head -head: - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 8], 1, Concat, [1]] # cat backbone P5 - - [-1, 3, C2, [768, False]] # 14 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, C2, [512, False]] # 17 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 3, C2, [256, False]] # 20 (P3/8-small) - - - [-1, 1, Conv, [256, 3, 2]] - - [[-1, 17], 1, Concat, [1]] # cat head P4 - - [-1, 3, C2, [512, False]] # 23 (P4/16-medium) - - - [-1, 1, Conv, [512, 3, 2]] - - [[-1, 14], 1, Concat, [1]] # cat head P5 - - [-1, 3, C2, [768, False]] # 26 (P5/32-large) - - - [-1, 1, Conv, [768, 3, 2]] - - [[-1, 11], 1, Concat, [1]] # cat head P6 - - [-1, 3, C2, [1024, False]] # 29 (P6/64-xlarge) - - - [[20, 23, 26, 29], 1, Detect, [nc]] # Detect(P3, P4, P5, P6) diff --git a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-pose-p6.yaml b/ultralytics-main/ultralytics/cfg/models/v8/yolov8-pose-p6.yaml deleted file mode 100644 index 60007ac..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-pose-p6.yaml +++ /dev/null @@ -1,57 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv8-pose-p6 keypoints/pose estimation model. For Usage examples see https://docs.ultralytics.com/tasks/pose - -# Parameters -nc: 1 # number of classes -kpt_shape: [17, 3] # number of keypoints, number of dims (2 for x,y or 3 for x,y,visible) -scales: # model compound scaling constants, i.e. 'model=yolov8n-p6.yaml' will call yolov8-p6.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] - s: [0.33, 0.50, 1024] - m: [0.67, 0.75, 768] - l: [1.00, 1.00, 512] - x: [1.00, 1.25, 512] - -# YOLOv8.0x6 backbone -backbone: - # [from, repeats, module, args] - - [-1, 1, Conv, [64, 3, 2]] # 0-P1/2 - - [-1, 1, Conv, [128, 3, 2]] # 1-P2/4 - - [-1, 3, C2f, [128, True]] - - [-1, 1, Conv, [256, 3, 2]] # 3-P3/8 - - [-1, 6, C2f, [256, True]] - - [-1, 1, Conv, [512, 3, 2]] # 5-P4/16 - - [-1, 6, C2f, [512, True]] - - [-1, 1, Conv, [768, 3, 2]] # 7-P5/32 - - [-1, 3, C2f, [768, True]] - - [-1, 1, Conv, [1024, 3, 2]] # 9-P6/64 - - [-1, 3, C2f, [1024, True]] - - [-1, 1, SPPF, [1024, 5]] # 11 - -# YOLOv8.0x6 head -head: - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 8], 1, Concat, [1]] # cat backbone P5 - - [-1, 3, C2, [768, False]] # 14 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, C2, [512, False]] # 17 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 3, C2, [256, False]] # 20 (P3/8-small) - - - [-1, 1, Conv, [256, 3, 2]] - - [[-1, 17], 1, Concat, [1]] # cat head P4 - - [-1, 3, C2, [512, False]] # 23 (P4/16-medium) - - - [-1, 1, Conv, [512, 3, 2]] - - [[-1, 14], 1, Concat, [1]] # cat head P5 - - [-1, 3, C2, [768, False]] # 26 (P5/32-large) - - - [-1, 1, Conv, [768, 3, 2]] - - [[-1, 11], 1, Concat, [1]] # cat head P6 - - [-1, 3, C2, [1024, False]] # 29 (P6/64-xlarge) - - - [[20, 23, 26, 29], 1, Pose, [nc, kpt_shape]] # Pose(P3, P4, P5, P6) diff --git a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-pose.yaml b/ultralytics-main/ultralytics/cfg/models/v8/yolov8-pose.yaml deleted file mode 100644 index 60388ef..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-pose.yaml +++ /dev/null @@ -1,47 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv8-pose keypoints/pose estimation model. For Usage examples see https://docs.ultralytics.com/tasks/pose - -# Parameters -nc: 1 # number of classes -kpt_shape: [17, 3] # number of keypoints, number of dims (2 for x,y or 3 for x,y,visible) -scales: # model compound scaling constants, i.e. 'model=yolov8n-pose.yaml' will call yolov8-pose.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] - s: [0.33, 0.50, 1024] - m: [0.67, 0.75, 768] - l: [1.00, 1.00, 512] - x: [1.00, 1.25, 512] - -# YOLOv8.0n backbone -backbone: - # [from, repeats, module, args] - - [-1, 1, Conv, [64, 3, 2]] # 0-P1/2 - - [-1, 1, Conv, [128, 3, 2]] # 1-P2/4 - - [-1, 3, C2f, [128, True]] - - [-1, 1, Conv, [256, 3, 2]] # 3-P3/8 - - [-1, 6, C2f, [256, True]] - - [-1, 1, Conv, [512, 3, 2]] # 5-P4/16 - - [-1, 6, C2f, [512, True]] - - [-1, 1, Conv, [1024, 3, 2]] # 7-P5/32 - - [-1, 3, C2f, [1024, True]] - - [-1, 1, SPPF, [1024, 5]] # 9 - -# YOLOv8.0n head -head: - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, C2f, [512]] # 12 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 3, C2f, [256]] # 15 (P3/8-small) - - - [-1, 1, Conv, [256, 3, 2]] - - [[-1, 12], 1, Concat, [1]] # cat head P4 - - [-1, 3, C2f, [512]] # 18 (P4/16-medium) - - - [-1, 1, Conv, [512, 3, 2]] - - [[-1, 9], 1, Concat, [1]] # cat head P5 - - [-1, 3, C2f, [1024]] # 21 (P5/32-large) - - - [[15, 18, 21], 1, Pose, [nc, kpt_shape]] # Pose(P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-rtdetr.yaml b/ultralytics-main/ultralytics/cfg/models/v8/yolov8-rtdetr.yaml deleted file mode 100644 index 27b790b..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-rtdetr.yaml +++ /dev/null @@ -1,46 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv8 object detection model with P3-P5 outputs. For Usage examples see https://docs.ultralytics.com/tasks/detect - -# Parameters -nc: 80 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n.yaml' will call yolov8.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] # YOLOv8n summary: 225 layers, 3157200 parameters, 3157184 gradients, 8.9 GFLOPs - s: [0.33, 0.50, 1024] # YOLOv8s summary: 225 layers, 11166560 parameters, 11166544 gradients, 28.8 GFLOPs - m: [0.67, 0.75, 768] # YOLOv8m summary: 295 layers, 25902640 parameters, 25902624 gradients, 79.3 GFLOPs - l: [1.00, 1.00, 512] # YOLOv8l summary: 365 layers, 43691520 parameters, 43691504 gradients, 165.7 GFLOPs - x: [1.00, 1.25, 512] # YOLOv8x summary: 365 layers, 68229648 parameters, 68229632 gradients, 258.5 GFLOPs - -# YOLOv8.0n backbone -backbone: - # [from, repeats, module, args] - - [-1, 1, Conv, [64, 3, 2]] # 0-P1/2 - - [-1, 1, Conv, [128, 3, 2]] # 1-P2/4 - - [-1, 3, C2f, [128, True]] - - [-1, 1, Conv, [256, 3, 2]] # 3-P3/8 - - [-1, 6, C2f, [256, True]] - - [-1, 1, Conv, [512, 3, 2]] # 5-P4/16 - - [-1, 6, C2f, [512, True]] - - [-1, 1, Conv, [1024, 3, 2]] # 7-P5/32 - - [-1, 3, C2f, [1024, True]] - - [-1, 1, SPPF, [1024, 5]] # 9 - -# YOLOv8.0n head -head: - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, C2f, [512]] # 12 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 3, C2f, [256]] # 15 (P3/8-small) - - - [-1, 1, Conv, [256, 3, 2]] - - [[-1, 12], 1, Concat, [1]] # cat head P4 - - [-1, 3, C2f, [512]] # 18 (P4/16-medium) - - - [-1, 1, Conv, [512, 3, 2]] - - [[-1, 9], 1, Concat, [1]] # cat head P5 - - [-1, 3, C2f, [1024]] # 21 (P5/32-large) - - - [[15, 18, 21], 1, RTDETRDecoder, [nc]] # Detect(P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-seg-p6.yaml b/ultralytics-main/ultralytics/cfg/models/v8/yolov8-seg-p6.yaml deleted file mode 100644 index 78c0444..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-seg-p6.yaml +++ /dev/null @@ -1,56 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv8-seg-p6 instance segmentation model. For Usage examples see https://docs.ultralytics.com/tasks/segment - -# Parameters -nc: 80 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n-seg-p6.yaml' will call yolov8-seg-p6.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] - s: [0.33, 0.50, 1024] - m: [0.67, 0.75, 768] - l: [1.00, 1.00, 512] - x: [1.00, 1.25, 512] - -# YOLOv8.0x6 backbone -backbone: - # [from, repeats, module, args] - - [-1, 1, Conv, [64, 3, 2]] # 0-P1/2 - - [-1, 1, Conv, [128, 3, 2]] # 1-P2/4 - - [-1, 3, C2f, [128, True]] - - [-1, 1, Conv, [256, 3, 2]] # 3-P3/8 - - [-1, 6, C2f, [256, True]] - - [-1, 1, Conv, [512, 3, 2]] # 5-P4/16 - - [-1, 6, C2f, [512, True]] - - [-1, 1, Conv, [768, 3, 2]] # 7-P5/32 - - [-1, 3, C2f, [768, True]] - - [-1, 1, Conv, [1024, 3, 2]] # 9-P6/64 - - [-1, 3, C2f, [1024, True]] - - [-1, 1, SPPF, [1024, 5]] # 11 - -# YOLOv8.0x6 head -head: - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 8], 1, Concat, [1]] # cat backbone P5 - - [-1, 3, C2, [768, False]] # 14 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, C2, [512, False]] # 17 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 3, C2, [256, False]] # 20 (P3/8-small) - - - [-1, 1, Conv, [256, 3, 2]] - - [[-1, 17], 1, Concat, [1]] # cat head P4 - - [-1, 3, C2, [512, False]] # 23 (P4/16-medium) - - - [-1, 1, Conv, [512, 3, 2]] - - [[-1, 14], 1, Concat, [1]] # cat head P5 - - [-1, 3, C2, [768, False]] # 26 (P5/32-large) - - - [-1, 1, Conv, [768, 3, 2]] - - [[-1, 11], 1, Concat, [1]] # cat head P6 - - [-1, 3, C2, [1024, False]] # 29 (P6/64-xlarge) - - - [[20, 23, 26, 29], 1, Segment, [nc, 32, 256]] # Pose(P3, P4, P5, P6) diff --git a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-seg.yaml b/ultralytics-main/ultralytics/cfg/models/v8/yolov8-seg.yaml deleted file mode 100644 index 700b795..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-seg.yaml +++ /dev/null @@ -1,46 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv8-seg instance segmentation model. For Usage examples see https://docs.ultralytics.com/tasks/segment - -# Parameters -nc: 80 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n-seg.yaml' will call yolov8-seg.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] - s: [0.33, 0.50, 1024] - m: [0.67, 0.75, 768] - l: [1.00, 1.00, 512] - x: [1.00, 1.25, 512] - -# YOLOv8.0n backbone -backbone: - # [from, repeats, module, args] - - [-1, 1, Conv, [64, 3, 2]] # 0-P1/2 - - [-1, 1, Conv, [128, 3, 2]] # 1-P2/4 - - [-1, 3, C2f, [128, True]] - - [-1, 1, Conv, [256, 3, 2]] # 3-P3/8 - - [-1, 6, C2f, [256, True]] - - [-1, 1, Conv, [512, 3, 2]] # 5-P4/16 - - [-1, 6, C2f, [512, True]] - - [-1, 1, Conv, [1024, 3, 2]] # 7-P5/32 - - [-1, 3, C2f, [1024, True]] - - [-1, 1, SPPF, [1024, 5]] # 9 - -# YOLOv8.0n head -head: - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, C2f, [512]] # 12 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 3, C2f, [256]] # 15 (P3/8-small) - - - [-1, 1, Conv, [256, 3, 2]] - - [[-1, 12], 1, Concat, [1]] # cat head P4 - - [-1, 3, C2f, [512]] # 18 (P4/16-medium) - - - [-1, 1, Conv, [512, 3, 2]] - - [[-1, 9], 1, Concat, [1]] # cat head P5 - - [-1, 3, C2f, [1024]] # 21 (P5/32-large) - - - [[15, 18, 21], 1, Segment, [nc, 32, 256]] # Segment(P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-world.yaml b/ultralytics-main/ultralytics/cfg/models/v8/yolov8-world.yaml deleted file mode 100644 index c21a7f0..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-world.yaml +++ /dev/null @@ -1,48 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv8-World object detection model with P3-P5 outputs. For details see https://docs.ultralytics.com/tasks/detect - -# Parameters -nc: 80 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n.yaml' will call yolov8.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] # YOLOv8n summary: 225 layers, 3157200 parameters, 3157184 gradients, 8.9 GFLOPs - s: [0.33, 0.50, 1024] # YOLOv8s summary: 225 layers, 11166560 parameters, 11166544 gradients, 28.8 GFLOPs - m: [0.67, 0.75, 768] # YOLOv8m summary: 295 layers, 25902640 parameters, 25902624 gradients, 79.3 GFLOPs - l: [1.00, 1.00, 512] # YOLOv8l summary: 365 layers, 43691520 parameters, 43691504 gradients, 165.7 GFLOPs - x: [1.00, 1.25, 512] # YOLOv8x summary: 365 layers, 68229648 parameters, 68229632 gradients, 258.5 GFLOPs - -# YOLOv8.0n backbone -backbone: - # [from, repeats, module, args] - - [-1, 1, Conv, [64, 3, 2]] # 0-P1/2 - - [-1, 1, Conv, [128, 3, 2]] # 1-P2/4 - - [-1, 3, C2f, [128, True]] - - [-1, 1, Conv, [256, 3, 2]] # 3-P3/8 - - [-1, 6, C2f, [256, True]] - - [-1, 1, Conv, [512, 3, 2]] # 5-P4/16 - - [-1, 6, C2f, [512, True]] - - [-1, 1, Conv, [1024, 3, 2]] # 7-P5/32 - - [-1, 3, C2f, [1024, True]] - - [-1, 1, SPPF, [1024, 5]] # 9 - -# YOLOv8.0n head -head: - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, C2fAttn, [512, 256, 8]] # 12 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 3, C2fAttn, [256, 128, 4]] # 15 (P3/8-small) - - - [[15, 12, 9], 1, ImagePoolingAttn, [256]] # 16 (P3/8-small) - - - [15, 1, Conv, [256, 3, 2]] - - [[-1, 12], 1, Concat, [1]] # cat head P4 - - [-1, 3, C2fAttn, [512, 256, 8]] # 19 (P4/16-medium) - - - [-1, 1, Conv, [512, 3, 2]] - - [[-1, 9], 1, Concat, [1]] # cat head P5 - - [-1, 3, C2fAttn, [1024, 512, 16]] # 22 (P5/32-large) - - - [[15, 19, 22], 1, WorldDetect, [nc, 512, False]] # Detect(P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-worldv2.yaml b/ultralytics-main/ultralytics/cfg/models/v8/yolov8-worldv2.yaml deleted file mode 100644 index 322b97d..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v8/yolov8-worldv2.yaml +++ /dev/null @@ -1,46 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv8-World-v2 object detection model with P3-P5 outputs. For details see https://docs.ultralytics.com/tasks/detect - -# Parameters -nc: 80 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n.yaml' will call yolov8.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] # YOLOv8n summary: 225 layers, 3157200 parameters, 3157184 gradients, 8.9 GFLOPs - s: [0.33, 0.50, 1024] # YOLOv8s summary: 225 layers, 11166560 parameters, 11166544 gradients, 28.8 GFLOPs - m: [0.67, 0.75, 768] # YOLOv8m summary: 295 layers, 25902640 parameters, 25902624 gradients, 79.3 GFLOPs - l: [1.00, 1.00, 512] # YOLOv8l summary: 365 layers, 43691520 parameters, 43691504 gradients, 165.7 GFLOPs - x: [1.00, 1.25, 512] # YOLOv8x summary: 365 layers, 68229648 parameters, 68229632 gradients, 258.5 GFLOPs - -# YOLOv8.0n backbone -backbone: - # [from, repeats, module, args] - - [-1, 1, Conv, [64, 3, 2]] # 0-P1/2 - - [-1, 1, Conv, [128, 3, 2]] # 1-P2/4 - - [-1, 3, C2f, [128, True]] - - [-1, 1, Conv, [256, 3, 2]] # 3-P3/8 - - [-1, 6, C2f, [256, True]] - - [-1, 1, Conv, [512, 3, 2]] # 5-P4/16 - - [-1, 6, C2f, [512, True]] - - [-1, 1, Conv, [1024, 3, 2]] # 7-P5/32 - - [-1, 3, C2f, [1024, True]] - - [-1, 1, SPPF, [1024, 5]] # 9 - -# YOLOv8.0n head -head: - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, C2fAttn, [512, 256, 8]] # 12 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 3, C2fAttn, [256, 128, 4]] # 15 (P3/8-small) - - - [15, 1, Conv, [256, 3, 2]] - - [[-1, 12], 1, Concat, [1]] # cat head P4 - - [-1, 3, C2fAttn, [512, 256, 8]] # 18 (P4/16-medium) - - - [-1, 1, Conv, [512, 3, 2]] - - [[-1, 9], 1, Concat, [1]] # cat head P5 - - [-1, 3, C2fAttn, [1024, 512, 16]] # 21 (P5/32-large) - - - [[15, 18, 21], 1, WorldDetect, [nc, 512, True]] # Detect(P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/v8/yolov8.yaml b/ultralytics-main/ultralytics/cfg/models/v8/yolov8.yaml deleted file mode 100644 index 167b180..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v8/yolov8.yaml +++ /dev/null @@ -1,46 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# YOLOv8 object detection model with P3-P5 outputs. For Usage examples see https://docs.ultralytics.com/tasks/detect - -# Parameters -nc: 2 # number of classes -scales: # model compound scaling constants, i.e. 'model=yolov8n.yaml' will call yolov8.yaml with scale 'n' - # [depth, width, max_channels] - n: [0.33, 0.25, 1024] # YOLOv8n summary: 225 layers, 3157200 parameters, 3157184 gradients, 8.9 GFLOPs - s: [0.33, 0.50, 1024] # YOLOv8s summary: 225 layers, 11166560 parameters, 11166544 gradients, 28.8 GFLOPs - m: [0.67, 0.75, 768] # YOLOv8m summary: 295 layers, 25902640 parameters, 25902624 gradients, 79.3 GFLOPs - l: [1.00, 1.00, 512] # YOLOv8l summary: 365 layers, 43691520 parameters, 43691504 gradients, 165.7 GFLOPs - x: [1.00, 1.25, 512] # YOLOv8x summary: 365 layers, 68229648 parameters, 68229632 gradients, 258.5 GFLOPs - -# YOLOv8.0n backbone -backbone: - # [from, repeats, module, args] - - [-1, 1, Conv, [64, 3, 2]] # 0-P1/2 - - [-1, 1, Conv, [128, 3, 2]] # 1-P2/4 - - [-1, 3, C2f, [128, True]] - - [-1, 1, Conv, [256, 3, 2]] # 3-P3/8 - - [-1, 6, C2f, [256, True]] - - [-1, 1, Conv, [512, 3, 2]] # 5-P4/16 - - [-1, 6, C2f, [512, True]] - - [-1, 1, Conv, [1024, 3, 2]] # 7-P5/32 - - [-1, 3, C2f, [1024, True]] - - [-1, 1, SPPF, [1024, 5]] # 9 - -# YOLOv8.0n head -head: - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 3, C2f, [512]] # 12 - - - [-1, 1, nn.Upsample, [None, 2, "nearest"]] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 3, C2f, [256]] # 15 (P3/8-small) - - - [-1, 1, Conv, [256, 3, 2]] - - [[-1, 12], 1, Concat, [1]] # cat head P4 - - [-1, 3, C2f, [512]] # 18 (P4/16-medium) - - - [-1, 1, Conv, [512, 3, 2]] - - [[-1, 9], 1, Concat, [1]] # cat head P5 - - [-1, 3, C2f, [1024]] # 21 (P5/32-large) - - - [[15, 18, 21], 1, Detect, [nc]] # Detect(P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/v9/yolov9c.yaml b/ultralytics-main/ultralytics/cfg/models/v9/yolov9c.yaml deleted file mode 100644 index 66c02d6..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v9/yolov9c.yaml +++ /dev/null @@ -1,36 +0,0 @@ -# YOLOv9 - -# parameters -nc: 80 # number of classes - -# gelan backbone -backbone: - - [-1, 1, Conv, [64, 3, 2]] # 0-P1/2 - - [-1, 1, Conv, [128, 3, 2]] # 1-P2/4 - - [-1, 1, RepNCSPELAN4, [256, 128, 64, 1]] # 2 - - [-1, 1, ADown, [256]] # 3-P3/8 - - [-1, 1, RepNCSPELAN4, [512, 256, 128, 1]] # 4 - - [-1, 1, ADown, [512]] # 5-P4/16 - - [-1, 1, RepNCSPELAN4, [512, 512, 256, 1]] # 6 - - [-1, 1, ADown, [512]] # 7-P5/32 - - [-1, 1, RepNCSPELAN4, [512, 512, 256, 1]] # 8 - - [-1, 1, SPPELAN, [512, 256]] # 9 - -head: - - [-1, 1, nn.Upsample, [None, 2, 'nearest']] - - [[-1, 6], 1, Concat, [1]] # cat backbone P4 - - [-1, 1, RepNCSPELAN4, [512, 512, 256, 1]] # 12 - - - [-1, 1, nn.Upsample, [None, 2, 'nearest']] - - [[-1, 4], 1, Concat, [1]] # cat backbone P3 - - [-1, 1, RepNCSPELAN4, [256, 256, 128, 1]] # 15 (P3/8-small) - - - [-1, 1, ADown, [256]] - - [[-1, 12], 1, Concat, [1]] # cat head P4 - - [-1, 1, RepNCSPELAN4, [512, 512, 256, 1]] # 18 (P4/16-medium) - - - [-1, 1, ADown, [512]] - - [[-1, 9], 1, Concat, [1]] # cat head P5 - - [-1, 1, RepNCSPELAN4, [512, 512, 256, 1]] # 21 (P5/32-large) - - - [[15, 18, 21], 1, Detect, [nc]] # DDetect(P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/models/v9/yolov9e.yaml b/ultralytics-main/ultralytics/cfg/models/v9/yolov9e.yaml deleted file mode 100644 index 8e15a42..0000000 --- a/ultralytics-main/ultralytics/cfg/models/v9/yolov9e.yaml +++ /dev/null @@ -1,60 +0,0 @@ -# YOLOv9 - -# parameters -nc: 80 # number of classes - -# gelan backbone -backbone: - - [-1, 1, Silence, []] - - [-1, 1, Conv, [64, 3, 2]] # 1-P1/2 - - [-1, 1, Conv, [128, 3, 2]] # 2-P2/4 - - [-1, 1, RepNCSPELAN4, [256, 128, 64, 2]] # 3 - - [-1, 1, ADown, [256]] # 4-P3/8 - - [-1, 1, RepNCSPELAN4, [512, 256, 128, 2]] # 5 - - [-1, 1, ADown, [512]] # 6-P4/16 - - [-1, 1, RepNCSPELAN4, [1024, 512, 256, 2]] # 7 - - [-1, 1, ADown, [1024]] # 8-P5/32 - - [-1, 1, RepNCSPELAN4, [1024, 512, 256, 2]] # 9 - - - [1, 1, CBLinear, [[64]]] # 10 - - [3, 1, CBLinear, [[64, 128]]] # 11 - - [5, 1, CBLinear, [[64, 128, 256]]] # 12 - - [7, 1, CBLinear, [[64, 128, 256, 512]]] # 13 - - [9, 1, CBLinear, [[64, 128, 256, 512, 1024]]] # 14 - - - [0, 1, Conv, [64, 3, 2]] # 15-P1/2 - - [[10, 11, 12, 13, 14, -1], 1, CBFuse, [[0, 0, 0, 0, 0]]] # 16 - - [-1, 1, Conv, [128, 3, 2]] # 17-P2/4 - - [[11, 12, 13, 14, -1], 1, CBFuse, [[1, 1, 1, 1]]] # 18 - - [-1, 1, RepNCSPELAN4, [256, 128, 64, 2]] # 19 - - [-1, 1, ADown, [256]] # 20-P3/8 - - [[12, 13, 14, -1], 1, CBFuse, [[2, 2, 2]]] # 21 - - [-1, 1, RepNCSPELAN4, [512, 256, 128, 2]] # 22 - - [-1, 1, ADown, [512]] # 23-P4/16 - - [[13, 14, -1], 1, CBFuse, [[3, 3]]] # 24 - - [-1, 1, RepNCSPELAN4, [1024, 512, 256, 2]] # 25 - - [-1, 1, ADown, [1024]] # 26-P5/32 - - [[14, -1], 1, CBFuse, [[4]]] # 27 - - [-1, 1, RepNCSPELAN4, [1024, 512, 256, 2]] # 28 - - [-1, 1, SPPELAN, [512, 256]] # 29 - -# gelan head -head: - - [-1, 1, nn.Upsample, [None, 2, 'nearest']] - - [[-1, 25], 1, Concat, [1]] # cat backbone P4 - - [-1, 1, RepNCSPELAN4, [512, 512, 256, 2]] # 32 - - - [-1, 1, nn.Upsample, [None, 2, 'nearest']] - - [[-1, 22], 1, Concat, [1]] # cat backbone P3 - - [-1, 1, RepNCSPELAN4, [256, 256, 128, 2]] # 35 (P3/8-small) - - - [-1, 1, ADown, [256]] - - [[-1, 32], 1, Concat, [1]] # cat head P4 - - [-1, 1, RepNCSPELAN4, [512, 512, 256, 2]] # 38 (P4/16-medium) - - - [-1, 1, ADown, [512]] - - [[-1, 29], 1, Concat, [1]] # cat head P5 - - [-1, 1, RepNCSPELAN4, [512, 1024, 512, 2]] # 41 (P5/32-large) - - # detect - - [[35, 38, 41], 1, Detect, [nc]] # Detect(P3, P4, P5) diff --git a/ultralytics-main/ultralytics/cfg/trackers/botsort.yaml b/ultralytics-main/ultralytics/cfg/trackers/botsort.yaml deleted file mode 100644 index 0c66dc6..0000000 --- a/ultralytics-main/ultralytics/cfg/trackers/botsort.yaml +++ /dev/null @@ -1,18 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# Default YOLO tracker settings for BoT-SORT tracker https://github.com/NirAharon/BoT-SORT - -tracker_type: botsort # tracker type, ['botsort', 'bytetrack'] -track_high_thresh: 0.5 # threshold for the first association -track_low_thresh: 0.1 # threshold for the second association -new_track_thresh: 0.6 # threshold for init new track if the detection does not match any tracks -track_buffer: 30 # buffer to calculate the time when to remove tracks -match_thresh: 0.8 # threshold for matching tracks -# min_box_area: 10 # threshold for min box areas(for tracker evaluation, not used for now) -# mot20: False # for tracker evaluation(not used for now) - -# BoT-SORT settings -gmc_method: sparseOptFlow # method of global motion compensation -# ReID model related thresh (not supported yet) -proximity_thresh: 0.5 -appearance_thresh: 0.25 -with_reid: False diff --git a/ultralytics-main/ultralytics/cfg/trackers/bytetrack.yaml b/ultralytics-main/ultralytics/cfg/trackers/bytetrack.yaml deleted file mode 100644 index 29d352c..0000000 --- a/ultralytics-main/ultralytics/cfg/trackers/bytetrack.yaml +++ /dev/null @@ -1,11 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# Default YOLO tracker settings for ByteTrack tracker https://github.com/ifzhang/ByteTrack - -tracker_type: bytetrack # tracker type, ['botsort', 'bytetrack'] -track_high_thresh: 0.5 # threshold for the first association -track_low_thresh: 0.1 # threshold for the second association -new_track_thresh: 0.6 # threshold for init new track if the detection does not match any tracks -track_buffer: 30 # buffer to calculate the time when to remove tracks -match_thresh: 0.8 # threshold for matching tracks -# min_box_area: 10 # threshold for min box areas(for tracker evaluation, not used for now) -# mot20: False # for tracker evaluation(not used for now) diff --git a/ultralytics-main/ultralytics/data/__init__.py b/ultralytics-main/ultralytics/data/__init__.py deleted file mode 100644 index 9f91ce9..0000000 --- a/ultralytics-main/ultralytics/data/__init__.py +++ /dev/null @@ -1,15 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from .base import BaseDataset -from .build import build_dataloader, build_yolo_dataset, load_inference_source -from .dataset import ClassificationDataset, SemanticDataset, YOLODataset - -__all__ = ( - "BaseDataset", - "ClassificationDataset", - "SemanticDataset", - "YOLODataset", - "build_yolo_dataset", - "build_dataloader", - "load_inference_source", -) diff --git a/ultralytics-main/ultralytics/data/annotator.py b/ultralytics-main/ultralytics/data/annotator.py deleted file mode 100644 index b5b899c..0000000 --- a/ultralytics-main/ultralytics/data/annotator.py +++ /dev/null @@ -1,50 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from pathlib import Path - -from ultralytics import SAM, YOLO - - -def auto_annotate(data, det_model="yolov8x.pt", sam_model="sam_b.pt", device="", output_dir=None): - """ - Automatically annotates images using a YOLO object detection model and a SAM segmentation model. - - Args: - data (str): Path to a folder containing images to be annotated. - det_model (str, optional): Pre-trained YOLO detection model. Defaults to 'yolov8x.pt'. - sam_model (str, optional): Pre-trained SAM segmentation model. Defaults to 'sam_b.pt'. - device (str, optional): Device to run the models on. Defaults to an empty string (CPU or GPU, if available). - output_dir (str | None | optional): Directory to save the annotated results. - Defaults to a 'labels' folder in the same directory as 'data'. - - Example: - ```python - from ultralytics.data.annotator import auto_annotate - - auto_annotate(data='ultralytics/assets', det_model='yolov8n.pt', sam_model='mobile_sam.pt') - ``` - """ - det_model = YOLO(det_model) - sam_model = SAM(sam_model) - - data = Path(data) - if not output_dir: - output_dir = data.parent / f"{data.stem}_auto_annotate_labels" - Path(output_dir).mkdir(exist_ok=True, parents=True) - - det_results = det_model(data, stream=True, device=device) - - for result in det_results: - class_ids = result.boxes.cls.int().tolist() # noqa - if len(class_ids): - boxes = result.boxes.xyxy # Boxes object for bbox outputs - sam_results = sam_model(result.orig_img, bboxes=boxes, verbose=False, save=False, device=device) - segments = sam_results[0].masks.xyn # noqa - - with open(f"{Path(output_dir) / Path(result.path).stem}.txt", "w") as f: - for i in range(len(segments)): - s = segments[i] - if len(s) == 0: - continue - segment = map(str, segments[i].reshape(-1).tolist()) - f.write(f"{class_ids[i]} " + " ".join(segment) + "\n") diff --git a/ultralytics-main/ultralytics/data/augment.py b/ultralytics-main/ultralytics/data/augment.py deleted file mode 100644 index a16f60b..0000000 --- a/ultralytics-main/ultralytics/data/augment.py +++ /dev/null @@ -1,1250 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import math -import random -from copy import deepcopy - -import cv2 -import numpy as np -import torch -import torchvision.transforms as T - -from ultralytics.utils import LOGGER, colorstr -from ultralytics.utils.checks import check_version -from ultralytics.utils.instance import Instances -from ultralytics.utils.metrics import bbox_ioa -from ultralytics.utils.ops import segment2box, xyxyxyxy2xywhr -from ultralytics.utils.torch_utils import TORCHVISION_0_10, TORCHVISION_0_11, TORCHVISION_0_13 -from .utils import polygons2masks, polygons2masks_overlap - -DEFAULT_MEAN = (0.0, 0.0, 0.0) -DEFAULT_STD = (1.0, 1.0, 1.0) -DEFAULT_CROP_FTACTION = 1.0 - - -# TODO: we might need a BaseTransform to make all these augments be compatible with both classification and semantic -class BaseTransform: - """ - Base class for image transformations. - - This is a generic transformation class that can be extended for specific image processing needs. - The class is designed to be compatible with both classification and semantic segmentation tasks. - - Methods: - __init__: Initializes the BaseTransform object. - apply_image: Applies image transformation to labels. - apply_instances: Applies transformations to object instances in labels. - apply_semantic: Applies semantic segmentation to an image. - __call__: Applies all label transformations to an image, instances, and semantic masks. - """ - - def __init__(self) -> None: - """Initializes the BaseTransform object.""" - pass - - def apply_image(self, labels): - """Applies image transformations to labels.""" - pass - - def apply_instances(self, labels): - """Applies transformations to object instances in labels.""" - pass - - def apply_semantic(self, labels): - """Applies semantic segmentation to an image.""" - pass - - def __call__(self, labels): - """Applies all label transformations to an image, instances, and semantic masks.""" - self.apply_image(labels) - self.apply_instances(labels) - self.apply_semantic(labels) - - -class Compose: - """Class for composing multiple image transformations.""" - - def __init__(self, transforms): - """Initializes the Compose object with a list of transforms.""" - self.transforms = transforms - - def __call__(self, data): - """Applies a series of transformations to input data.""" - for t in self.transforms: - data = t(data) - return data - - def append(self, transform): - """Appends a new transform to the existing list of transforms.""" - self.transforms.append(transform) - - def tolist(self): - """Converts the list of transforms to a standard Python list.""" - return self.transforms - - def __repr__(self): - """Returns a string representation of the object.""" - return f"{self.__class__.__name__}({', '.join([f'{t}' for t in self.transforms])})" - - -class BaseMixTransform: - """ - Class for base mix (MixUp/Mosaic) transformations. - - This implementation is from mmyolo. - """ - - def __init__(self, dataset, pre_transform=None, p=0.0) -> None: - """Initializes the BaseMixTransform object with dataset, pre_transform, and probability.""" - self.dataset = dataset - self.pre_transform = pre_transform - self.p = p - - def __call__(self, labels): - """Applies pre-processing transforms and mixup/mosaic transforms to labels data.""" - if random.uniform(0, 1) > self.p: - return labels - - # Get index of one or three other images - indexes = self.get_indexes() - if isinstance(indexes, int): - indexes = [indexes] - - # Get images information will be used for Mosaic or MixUp - mix_labels = [self.dataset.get_image_and_label(i) for i in indexes] - - if self.pre_transform is not None: - for i, data in enumerate(mix_labels): - mix_labels[i] = self.pre_transform(data) - labels["mix_labels"] = mix_labels - - # Mosaic or MixUp - labels = self._mix_transform(labels) - labels.pop("mix_labels", None) - return labels - - def _mix_transform(self, labels): - """Applies MixUp or Mosaic augmentation to the label dictionary.""" - raise NotImplementedError - - def get_indexes(self): - """Gets a list of shuffled indexes for mosaic augmentation.""" - raise NotImplementedError - - -class Mosaic(BaseMixTransform): - """ - Mosaic augmentation. - - This class performs mosaic augmentation by combining multiple (4 or 9) images into a single mosaic image. - The augmentation is applied to a dataset with a given probability. - - Attributes: - dataset: The dataset on which the mosaic augmentation is applied. - imgsz (int, optional): Image size (height and width) after mosaic pipeline of a single image. Default to 640. - p (float, optional): Probability of applying the mosaic augmentation. Must be in the range 0-1. Default to 1.0. - n (int, optional): The grid size, either 4 (for 2x2) or 9 (for 3x3). - """ - - def __init__(self, dataset, imgsz=640, p=1.0, n=4): - """Initializes the object with a dataset, image size, probability, and border.""" - assert 0 <= p <= 1.0, f"The probability should be in range [0, 1], but got {p}." - assert n in (4, 9), "grid must be equal to 4 or 9." - super().__init__(dataset=dataset, p=p) - self.dataset = dataset - self.imgsz = imgsz - self.border = (-imgsz // 2, -imgsz // 2) # width, height - self.n = n - - def get_indexes(self, buffer=True): - """Return a list of random indexes from the dataset.""" - if buffer: # select images from buffer - return random.choices(list(self.dataset.buffer), k=self.n - 1) - else: # select any images - return [random.randint(0, len(self.dataset) - 1) for _ in range(self.n - 1)] - - def _mix_transform(self, labels): - """Apply mixup transformation to the input image and labels.""" - assert labels.get("rect_shape", None) is None, "rect and mosaic are mutually exclusive." - assert len(labels.get("mix_labels", [])), "There are no other images for mosaic augment." - return ( - self._mosaic3(labels) if self.n == 3 else self._mosaic4(labels) if self.n == 4 else self._mosaic9(labels) - ) # This code is modified for mosaic3 method. - - def _mosaic3(self, labels): - """Create a 1x3 image mosaic.""" - mosaic_labels = [] - s = self.imgsz - for i in range(3): - labels_patch = labels if i == 0 else labels["mix_labels"][i - 1] - # Load image - img = labels_patch["img"] - h, w = labels_patch.pop("resized_shape") - - # Place img in img3 - if i == 0: # center - img3 = np.full((s * 3, s * 3, img.shape[2]), 114, dtype=np.uint8) # base image with 3 tiles - h0, w0 = h, w - c = s, s, s + w, s + h # xmin, ymin, xmax, ymax (base) coordinates - elif i == 1: # right - c = s + w0, s, s + w0 + w, s + h - elif i == 2: # left - c = s - w, s + h0 - h, s, s + h0 - - padw, padh = c[:2] - x1, y1, x2, y2 = (max(x, 0) for x in c) # allocate coords - - img3[y1:y2, x1:x2] = img[y1 - padh :, x1 - padw :] # img3[ymin:ymax, xmin:xmax] - # hp, wp = h, w # height, width previous for next iteration - - # Labels assuming imgsz*2 mosaic size - labels_patch = self._update_labels(labels_patch, padw + self.border[0], padh + self.border[1]) - mosaic_labels.append(labels_patch) - final_labels = self._cat_labels(mosaic_labels) - - final_labels["img"] = img3[-self.border[0] : self.border[0], -self.border[1] : self.border[1]] - return final_labels - - def _mosaic4(self, labels): - """Create a 2x2 image mosaic.""" - mosaic_labels = [] - s = self.imgsz - yc, xc = (int(random.uniform(-x, 2 * s + x)) for x in self.border) # mosaic center x, y - for i in range(4): - labels_patch = labels if i == 0 else labels["mix_labels"][i - 1] - # Load image - img = labels_patch["img"] - h, w = labels_patch.pop("resized_shape") - - # Place img in img4 - if i == 0: # top left - img4 = np.full((s * 2, s * 2, img.shape[2]), 114, dtype=np.uint8) # base image with 4 tiles - x1a, y1a, x2a, y2a = max(xc - w, 0), max(yc - h, 0), xc, yc # xmin, ymin, xmax, ymax (large image) - x1b, y1b, x2b, y2b = w - (x2a - x1a), h - (y2a - y1a), w, h # xmin, ymin, xmax, ymax (small image) - elif i == 1: # top right - x1a, y1a, x2a, y2a = xc, max(yc - h, 0), min(xc + w, s * 2), yc - x1b, y1b, x2b, y2b = 0, h - (y2a - y1a), min(w, x2a - x1a), h - elif i == 2: # bottom left - x1a, y1a, x2a, y2a = max(xc - w, 0), yc, xc, min(s * 2, yc + h) - x1b, y1b, x2b, y2b = w - (x2a - x1a), 0, w, min(y2a - y1a, h) - elif i == 3: # bottom right - x1a, y1a, x2a, y2a = xc, yc, min(xc + w, s * 2), min(s * 2, yc + h) - x1b, y1b, x2b, y2b = 0, 0, min(w, x2a - x1a), min(y2a - y1a, h) - - img4[y1a:y2a, x1a:x2a] = img[y1b:y2b, x1b:x2b] # img4[ymin:ymax, xmin:xmax] - padw = x1a - x1b - padh = y1a - y1b - - labels_patch = self._update_labels(labels_patch, padw, padh) - mosaic_labels.append(labels_patch) - final_labels = self._cat_labels(mosaic_labels) - final_labels["img"] = img4 - return final_labels - - def _mosaic9(self, labels): - """Create a 3x3 image mosaic.""" - mosaic_labels = [] - s = self.imgsz - hp, wp = -1, -1 # height, width previous - for i in range(9): - labels_patch = labels if i == 0 else labels["mix_labels"][i - 1] - # Load image - img = labels_patch["img"] - h, w = labels_patch.pop("resized_shape") - - # Place img in img9 - if i == 0: # center - img9 = np.full((s * 3, s * 3, img.shape[2]), 114, dtype=np.uint8) # base image with 4 tiles - h0, w0 = h, w - c = s, s, s + w, s + h # xmin, ymin, xmax, ymax (base) coordinates - elif i == 1: # top - c = s, s - h, s + w, s - elif i == 2: # top right - c = s + wp, s - h, s + wp + w, s - elif i == 3: # right - c = s + w0, s, s + w0 + w, s + h - elif i == 4: # bottom right - c = s + w0, s + hp, s + w0 + w, s + hp + h - elif i == 5: # bottom - c = s + w0 - w, s + h0, s + w0, s + h0 + h - elif i == 6: # bottom left - c = s + w0 - wp - w, s + h0, s + w0 - wp, s + h0 + h - elif i == 7: # left - c = s - w, s + h0 - h, s, s + h0 - elif i == 8: # top left - c = s - w, s + h0 - hp - h, s, s + h0 - hp - - padw, padh = c[:2] - x1, y1, x2, y2 = (max(x, 0) for x in c) # allocate coords - - # Image - img9[y1:y2, x1:x2] = img[y1 - padh :, x1 - padw :] # img9[ymin:ymax, xmin:xmax] - hp, wp = h, w # height, width previous for next iteration - - # Labels assuming imgsz*2 mosaic size - labels_patch = self._update_labels(labels_patch, padw + self.border[0], padh + self.border[1]) - mosaic_labels.append(labels_patch) - final_labels = self._cat_labels(mosaic_labels) - - final_labels["img"] = img9[-self.border[0] : self.border[0], -self.border[1] : self.border[1]] - return final_labels - - @staticmethod - def _update_labels(labels, padw, padh): - """Update labels.""" - nh, nw = labels["img"].shape[:2] - labels["instances"].convert_bbox(format="xyxy") - labels["instances"].denormalize(nw, nh) - labels["instances"].add_padding(padw, padh) - return labels - - def _cat_labels(self, mosaic_labels): - """Return labels with mosaic border instances clipped.""" - if len(mosaic_labels) == 0: - return {} - cls = [] - instances = [] - imgsz = self.imgsz * 2 # mosaic imgsz - for labels in mosaic_labels: - cls.append(labels["cls"]) - instances.append(labels["instances"]) - # Final labels - final_labels = { - "im_file": mosaic_labels[0]["im_file"], - "ori_shape": mosaic_labels[0]["ori_shape"], - "resized_shape": (imgsz, imgsz), - "cls": np.concatenate(cls, 0), - "instances": Instances.concatenate(instances, axis=0), - "mosaic_border": self.border, - } - final_labels["instances"].clip(imgsz, imgsz) - good = final_labels["instances"].remove_zero_area_boxes() - final_labels["cls"] = final_labels["cls"][good] - return final_labels - - -class MixUp(BaseMixTransform): - """Class for applying MixUp augmentation to the dataset.""" - - def __init__(self, dataset, pre_transform=None, p=0.0) -> None: - """Initializes MixUp object with dataset, pre_transform, and probability of applying MixUp.""" - super().__init__(dataset=dataset, pre_transform=pre_transform, p=p) - - def get_indexes(self): - """Get a random index from the dataset.""" - return random.randint(0, len(self.dataset) - 1) - - def _mix_transform(self, labels): - """Applies MixUp augmentation as per https://arxiv.org/pdf/1710.09412.pdf.""" - r = np.random.beta(32.0, 32.0) # mixup ratio, alpha=beta=32.0 - labels2 = labels["mix_labels"][0] - labels["img"] = (labels["img"] * r + labels2["img"] * (1 - r)).astype(np.uint8) - labels["instances"] = Instances.concatenate([labels["instances"], labels2["instances"]], axis=0) - labels["cls"] = np.concatenate([labels["cls"], labels2["cls"]], 0) - return labels - - -class RandomPerspective: - """ - Implements random perspective and affine transformations on images and corresponding bounding boxes, segments, and - keypoints. These transformations include rotation, translation, scaling, and shearing. The class also offers the - option to apply these transformations conditionally with a specified probability. - - Attributes: - degrees (float): Degree range for random rotations. - translate (float): Fraction of total width and height for random translation. - scale (float): Scaling factor interval, e.g., a scale factor of 0.1 allows a resize between 90%-110%. - shear (float): Shear intensity (angle in degrees). - perspective (float): Perspective distortion factor. - border (tuple): Tuple specifying mosaic border. - pre_transform (callable): A function/transform to apply to the image before starting the random transformation. - - Methods: - affine_transform(img, border): Applies a series of affine transformations to the image. - apply_bboxes(bboxes, M): Transforms bounding boxes using the calculated affine matrix. - apply_segments(segments, M): Transforms segments and generates new bounding boxes. - apply_keypoints(keypoints, M): Transforms keypoints. - __call__(labels): Main method to apply transformations to both images and their corresponding annotations. - box_candidates(box1, box2): Filters out bounding boxes that don't meet certain criteria post-transformation. - """ - - def __init__( - self, degrees=0.0, translate=0.1, scale=0.5, shear=0.0, perspective=0.0, border=(0, 0), pre_transform=None - ): - """Initializes RandomPerspective object with transformation parameters.""" - - self.degrees = degrees - self.translate = translate - self.scale = scale - self.shear = shear - self.perspective = perspective - self.border = border # mosaic border - self.pre_transform = pre_transform - - def affine_transform(self, img, border): - """ - Applies a sequence of affine transformations centered around the image center. - - Args: - img (ndarray): Input image. - border (tuple): Border dimensions. - - Returns: - img (ndarray): Transformed image. - M (ndarray): Transformation matrix. - s (float): Scale factor. - """ - - # Center - C = np.eye(3, dtype=np.float32) - - C[0, 2] = -img.shape[1] / 2 # x translation (pixels) - C[1, 2] = -img.shape[0] / 2 # y translation (pixels) - - # Perspective - P = np.eye(3, dtype=np.float32) - P[2, 0] = random.uniform(-self.perspective, self.perspective) # x perspective (about y) - P[2, 1] = random.uniform(-self.perspective, self.perspective) # y perspective (about x) - - # Rotation and Scale - R = np.eye(3, dtype=np.float32) - a = random.uniform(-self.degrees, self.degrees) - # a += random.choice([-180, -90, 0, 90]) # add 90deg rotations to small rotations - s = random.uniform(1 - self.scale, 1 + self.scale) - # s = 2 ** random.uniform(-scale, scale) - R[:2] = cv2.getRotationMatrix2D(angle=a, center=(0, 0), scale=s) - - # Shear - S = np.eye(3, dtype=np.float32) - S[0, 1] = math.tan(random.uniform(-self.shear, self.shear) * math.pi / 180) # x shear (deg) - S[1, 0] = math.tan(random.uniform(-self.shear, self.shear) * math.pi / 180) # y shear (deg) - - # Translation - T = np.eye(3, dtype=np.float32) - T[0, 2] = random.uniform(0.5 - self.translate, 0.5 + self.translate) * self.size[0] # x translation (pixels) - T[1, 2] = random.uniform(0.5 - self.translate, 0.5 + self.translate) * self.size[1] # y translation (pixels) - - # Combined rotation matrix - M = T @ S @ R @ P @ C # order of operations (right to left) is IMPORTANT - # Affine image - if (border[0] != 0) or (border[1] != 0) or (M != np.eye(3)).any(): # image changed - if self.perspective: - img = cv2.warpPerspective(img, M, dsize=self.size, borderValue=(114, 114, 114)) - else: # affine - img = cv2.warpAffine(img, M[:2], dsize=self.size, borderValue=(114, 114, 114)) - return img, M, s - - def apply_bboxes(self, bboxes, M): - """ - Apply affine to bboxes only. - - Args: - bboxes (ndarray): list of bboxes, xyxy format, with shape (num_bboxes, 4). - M (ndarray): affine matrix. - - Returns: - new_bboxes (ndarray): bboxes after affine, [num_bboxes, 4]. - """ - n = len(bboxes) - if n == 0: - return bboxes - - xy = np.ones((n * 4, 3), dtype=bboxes.dtype) - xy[:, :2] = bboxes[:, [0, 1, 2, 3, 0, 3, 2, 1]].reshape(n * 4, 2) # x1y1, x2y2, x1y2, x2y1 - xy = xy @ M.T # transform - xy = (xy[:, :2] / xy[:, 2:3] if self.perspective else xy[:, :2]).reshape(n, 8) # perspective rescale or affine - - # Create new boxes - x = xy[:, [0, 2, 4, 6]] - y = xy[:, [1, 3, 5, 7]] - return np.concatenate((x.min(1), y.min(1), x.max(1), y.max(1)), dtype=bboxes.dtype).reshape(4, n).T - - def apply_segments(self, segments, M): - """ - Apply affine to segments and generate new bboxes from segments. - - Args: - segments (ndarray): list of segments, [num_samples, 500, 2]. - M (ndarray): affine matrix. - - Returns: - new_segments (ndarray): list of segments after affine, [num_samples, 500, 2]. - new_bboxes (ndarray): bboxes after affine, [N, 4]. - """ - n, num = segments.shape[:2] - if n == 0: - return [], segments - - xy = np.ones((n * num, 3), dtype=segments.dtype) - segments = segments.reshape(-1, 2) - xy[:, :2] = segments - xy = xy @ M.T # transform - xy = xy[:, :2] / xy[:, 2:3] - segments = xy.reshape(n, -1, 2) - bboxes = np.stack([segment2box(xy, self.size[0], self.size[1]) for xy in segments], 0) - segments[..., 0] = segments[..., 0].clip(bboxes[:, 0:1], bboxes[:, 2:3]) - segments[..., 1] = segments[..., 1].clip(bboxes[:, 1:2], bboxes[:, 3:4]) - return bboxes, segments - - def apply_keypoints(self, keypoints, M): - """ - Apply affine to keypoints. - - Args: - keypoints (ndarray): keypoints, [N, 17, 3]. - M (ndarray): affine matrix. - - Returns: - new_keypoints (ndarray): keypoints after affine, [N, 17, 3]. - """ - n, nkpt = keypoints.shape[:2] - if n == 0: - return keypoints - xy = np.ones((n * nkpt, 3), dtype=keypoints.dtype) - visible = keypoints[..., 2].reshape(n * nkpt, 1) - xy[:, :2] = keypoints[..., :2].reshape(n * nkpt, 2) - xy = xy @ M.T # transform - xy = xy[:, :2] / xy[:, 2:3] # perspective rescale or affine - out_mask = (xy[:, 0] < 0) | (xy[:, 1] < 0) | (xy[:, 0] > self.size[0]) | (xy[:, 1] > self.size[1]) - visible[out_mask] = 0 - return np.concatenate([xy, visible], axis=-1).reshape(n, nkpt, 3) - - def __call__(self, labels): - """ - Affine images and targets. - - Args: - labels (dict): a dict of `bboxes`, `segments`, `keypoints`. - """ - if self.pre_transform and "mosaic_border" not in labels: - labels = self.pre_transform(labels) - labels.pop("ratio_pad", None) # do not need ratio pad - - img = labels["img"] - cls = labels["cls"] - instances = labels.pop("instances") - # Make sure the coord formats are right - instances.convert_bbox(format="xyxy") - instances.denormalize(*img.shape[:2][::-1]) - - border = labels.pop("mosaic_border", self.border) - self.size = img.shape[1] + border[1] * 2, img.shape[0] + border[0] * 2 # w, h - # M is affine matrix - # Scale for func:`box_candidates` - img, M, scale = self.affine_transform(img, border) - - bboxes = self.apply_bboxes(instances.bboxes, M) - - segments = instances.segments - keypoints = instances.keypoints - # Update bboxes if there are segments. - if len(segments): - bboxes, segments = self.apply_segments(segments, M) - - if keypoints is not None: - keypoints = self.apply_keypoints(keypoints, M) - new_instances = Instances(bboxes, segments, keypoints, bbox_format="xyxy", normalized=False) - # Clip - new_instances.clip(*self.size) - - # Filter instances - instances.scale(scale_w=scale, scale_h=scale, bbox_only=True) - # Make the bboxes have the same scale with new_bboxes - i = self.box_candidates( - box1=instances.bboxes.T, box2=new_instances.bboxes.T, area_thr=0.01 if len(segments) else 0.10 - ) - labels["instances"] = new_instances[i] - labels["cls"] = cls[i] - labels["img"] = img - labels["resized_shape"] = img.shape[:2] - return labels - - def box_candidates(self, box1, box2, wh_thr=2, ar_thr=100, area_thr=0.1, eps=1e-16): - """ - Compute box candidates based on a set of thresholds. This method compares the characteristics of the boxes - before and after augmentation to decide whether a box is a candidate for further processing. - - Args: - box1 (numpy.ndarray): The 4,n bounding box before augmentation, represented as [x1, y1, x2, y2]. - box2 (numpy.ndarray): The 4,n bounding box after augmentation, represented as [x1, y1, x2, y2]. - wh_thr (float, optional): The width and height threshold in pixels. Default is 2. - ar_thr (float, optional): The aspect ratio threshold. Default is 100. - area_thr (float, optional): The area ratio threshold. Default is 0.1. - eps (float, optional): A small epsilon value to prevent division by zero. Default is 1e-16. - - Returns: - (numpy.ndarray): A boolean array indicating which boxes are candidates based on the given thresholds. - """ - w1, h1 = box1[2] - box1[0], box1[3] - box1[1] - w2, h2 = box2[2] - box2[0], box2[3] - box2[1] - ar = np.maximum(w2 / (h2 + eps), h2 / (w2 + eps)) # aspect ratio - return (w2 > wh_thr) & (h2 > wh_thr) & (w2 * h2 / (w1 * h1 + eps) > area_thr) & (ar < ar_thr) # candidates - - -class RandomHSV: - """ - This class is responsible for performing random adjustments to the Hue, Saturation, and Value (HSV) channels of an - image. - - The adjustments are random but within limits set by hgain, sgain, and vgain. - """ - - def __init__(self, hgain=0.5, sgain=0.5, vgain=0.5) -> None: - """ - Initialize RandomHSV class with gains for each HSV channel. - - Args: - hgain (float, optional): Maximum variation for hue. Default is 0.5. - sgain (float, optional): Maximum variation for saturation. Default is 0.5. - vgain (float, optional): Maximum variation for value. Default is 0.5. - """ - self.hgain = hgain - self.sgain = sgain - self.vgain = vgain - - def __call__(self, labels): - """ - Applies random HSV augmentation to an image within the predefined limits. - - The modified image replaces the original image in the input 'labels' dict. - """ - img = labels["img"] - if self.hgain or self.sgain or self.vgain: - r = np.random.uniform(-1, 1, 3) * [self.hgain, self.sgain, self.vgain] + 1 # random gains - hue, sat, val = cv2.split(cv2.cvtColor(img, cv2.COLOR_BGR2HSV)) - dtype = img.dtype # uint8 - - x = np.arange(0, 256, dtype=r.dtype) - lut_hue = ((x * r[0]) % 180).astype(dtype) - lut_sat = np.clip(x * r[1], 0, 255).astype(dtype) - lut_val = np.clip(x * r[2], 0, 255).astype(dtype) - - im_hsv = cv2.merge((cv2.LUT(hue, lut_hue), cv2.LUT(sat, lut_sat), cv2.LUT(val, lut_val))) - cv2.cvtColor(im_hsv, cv2.COLOR_HSV2BGR, dst=img) # no return needed - return labels - - -class RandomFlip: - """ - Applies a random horizontal or vertical flip to an image with a given probability. - - Also updates any instances (bounding boxes, keypoints, etc.) accordingly. - """ - - def __init__(self, p=0.5, direction="horizontal", flip_idx=None) -> None: - """ - Initializes the RandomFlip class with probability and direction. - - Args: - p (float, optional): The probability of applying the flip. Must be between 0 and 1. Default is 0.5. - direction (str, optional): The direction to apply the flip. Must be 'horizontal' or 'vertical'. - Default is 'horizontal'. - flip_idx (array-like, optional): Index mapping for flipping keypoints, if any. - """ - assert direction in ["horizontal", "vertical"], f"Support direction `horizontal` or `vertical`, got {direction}" - assert 0 <= p <= 1.0 - - self.p = p - self.direction = direction - self.flip_idx = flip_idx - - def __call__(self, labels): - """ - Applies random flip to an image and updates any instances like bounding boxes or keypoints accordingly. - - Args: - labels (dict): A dictionary containing the keys 'img' and 'instances'. 'img' is the image to be flipped. - 'instances' is an object containing bounding boxes and optionally keypoints. - - Returns: - (dict): The same dict with the flipped image and updated instances under the 'img' and 'instances' keys. - """ - img = labels["img"] - instances = labels.pop("instances") - instances.convert_bbox(format="xywh") - h, w = img.shape[:2] - h = 1 if instances.normalized else h - w = 1 if instances.normalized else w - - # Flip up-down - if self.direction == "vertical" and random.random() < self.p: - img = np.flipud(img) - instances.flipud(h) - if self.direction == "horizontal" and random.random() < self.p: - img = np.fliplr(img) - instances.fliplr(w) - # For keypoints - if self.flip_idx is not None and instances.keypoints is not None: - instances.keypoints = np.ascontiguousarray(instances.keypoints[:, self.flip_idx, :]) - labels["img"] = np.ascontiguousarray(img) - labels["instances"] = instances - return labels - - -class LetterBox: - """Resize image and padding for detection, instance segmentation, pose.""" - - def __init__(self, new_shape=(640, 640), auto=False, scaleFill=False, scaleup=True, center=True, stride=32): - """Initialize LetterBox object with specific parameters.""" - self.new_shape = new_shape - self.auto = auto - self.scaleFill = scaleFill - self.scaleup = scaleup - self.stride = stride - self.center = center # Put the image in the middle or top-left - - def __call__(self, labels=None, image=None): - """Return updated labels and image with added border.""" - if labels is None: - labels = {} - img = labels.get("img") if image is None else image - shape = img.shape[:2] # current shape [height, width] - new_shape = labels.pop("rect_shape", self.new_shape) - if isinstance(new_shape, int): - new_shape = (new_shape, new_shape) - - # Scale ratio (new / old) - r = min(new_shape[0] / shape[0], new_shape[1] / shape[1]) - if not self.scaleup: # only scale down, do not scale up (for better val mAP) - r = min(r, 1.0) - - # Compute padding - ratio = r, r # width, height ratios - new_unpad = int(round(shape[1] * r)), int(round(shape[0] * r)) - dw, dh = new_shape[1] - new_unpad[0], new_shape[0] - new_unpad[1] # wh padding - if self.auto: # minimum rectangle - dw, dh = np.mod(dw, self.stride), np.mod(dh, self.stride) # wh padding - elif self.scaleFill: # stretch - dw, dh = 0.0, 0.0 - new_unpad = (new_shape[1], new_shape[0]) - ratio = new_shape[1] / shape[1], new_shape[0] / shape[0] # width, height ratios - - if self.center: - dw /= 2 # divide padding into 2 sides - dh /= 2 - - if shape[::-1] != new_unpad: # resize - img = cv2.resize(img, new_unpad, interpolation=cv2.INTER_LINEAR) - top, bottom = int(round(dh - 0.1)) if self.center else 0, int(round(dh + 0.1)) - left, right = int(round(dw - 0.1)) if self.center else 0, int(round(dw + 0.1)) - img = cv2.copyMakeBorder( - img, top, bottom, left, right, cv2.BORDER_CONSTANT, value=(114, 114, 114) - ) # add border - if labels.get("ratio_pad"): - labels["ratio_pad"] = (labels["ratio_pad"], (left, top)) # for evaluation - - if len(labels): - labels = self._update_labels(labels, ratio, dw, dh) - labels["img"] = img - labels["resized_shape"] = new_shape - return labels - else: - return img - - def _update_labels(self, labels, ratio, padw, padh): - """Update labels.""" - labels["instances"].convert_bbox(format="xyxy") - labels["instances"].denormalize(*labels["img"].shape[:2][::-1]) - labels["instances"].scale(*ratio) - labels["instances"].add_padding(padw, padh) - return labels - - -class CopyPaste: - """ - Implements the Copy-Paste augmentation as described in the paper https://arxiv.org/abs/2012.07177. This class is - responsible for applying the Copy-Paste augmentation on images and their corresponding instances. - """ - - def __init__(self, p=0.5) -> None: - """ - Initializes the CopyPaste class with a given probability. - - Args: - p (float, optional): The probability of applying the Copy-Paste augmentation. Must be between 0 and 1. - Default is 0.5. - """ - self.p = p - - def __call__(self, labels): - """ - Applies the Copy-Paste augmentation to the given image and instances. - - Args: - labels (dict): A dictionary containing: - - 'img': The image to augment. - - 'cls': Class labels associated with the instances. - - 'instances': Object containing bounding boxes, and optionally, keypoints and segments. - - Returns: - (dict): Dict with augmented image and updated instances under the 'img', 'cls', and 'instances' keys. - - Notes: - 1. Instances are expected to have 'segments' as one of their attributes for this augmentation to work. - 2. This method modifies the input dictionary 'labels' in place. - """ - im = labels["img"] - cls = labels["cls"] - h, w = im.shape[:2] - instances = labels.pop("instances") - instances.convert_bbox(format="xyxy") - instances.denormalize(w, h) - if self.p and len(instances.segments): - n = len(instances) - _, w, _ = im.shape # height, width, channels - im_new = np.zeros(im.shape, np.uint8) - - # Calculate ioa first then select indexes randomly - ins_flip = deepcopy(instances) - ins_flip.fliplr(w) - - ioa = bbox_ioa(ins_flip.bboxes, instances.bboxes) # intersection over area, (N, M) - indexes = np.nonzero((ioa < 0.30).all(1))[0] # (N, ) - n = len(indexes) - for j in random.sample(list(indexes), k=round(self.p * n)): - cls = np.concatenate((cls, cls[[j]]), axis=0) - instances = Instances.concatenate((instances, ins_flip[[j]]), axis=0) - cv2.drawContours(im_new, instances.segments[[j]].astype(np.int32), -1, (1, 1, 1), cv2.FILLED) - - result = cv2.flip(im, 1) # augment segments (flip left-right) - i = cv2.flip(im_new, 1).astype(bool) - im[i] = result[i] - - labels["img"] = im - labels["cls"] = cls - labels["instances"] = instances - return labels - - -class Albumentations: - """ - Albumentations transformations. - - Optional, uninstall package to disable. Applies Blur, Median Blur, convert to grayscale, Contrast Limited Adaptive - Histogram Equalization, random change of brightness and contrast, RandomGamma and lowering of image quality by - compression. - """ - - def __init__(self, p=1.0): - """Initialize the transform object for YOLO bbox formatted params.""" - self.p = p - self.transform = None - prefix = colorstr("albumentations: ") - try: - import albumentations as A - - check_version(A.__version__, "1.0.3", hard=True) # version requirement - - # Transforms - T = [ - A.Blur(p=0.01), - A.MedianBlur(p=0.01), - A.ToGray(p=0.01), - A.CLAHE(p=0.01), - A.RandomBrightnessContrast(p=0.0), - A.RandomGamma(p=0.0), - A.ImageCompression(quality_lower=75, p=0.0), - ] - self.transform = A.Compose(T, bbox_params=A.BboxParams(format="yolo", label_fields=["class_labels"])) - - LOGGER.info(prefix + ", ".join(f"{x}".replace("always_apply=False, ", "") for x in T if x.p)) - except ImportError: # package not installed, skip - pass - except Exception as e: - LOGGER.info(f"{prefix}{e}") - - def __call__(self, labels): - """Generates object detections and returns a dictionary with detection results.""" - im = labels["img"] - cls = labels["cls"] - if len(cls): - labels["instances"].convert_bbox("xywh") - labels["instances"].normalize(*im.shape[:2][::-1]) - bboxes = labels["instances"].bboxes - # TODO: add supports of segments and keypoints - if self.transform and random.random() < self.p: - new = self.transform(image=im, bboxes=bboxes, class_labels=cls) # transformed - if len(new["class_labels"]) > 0: # skip update if no bbox in new im - labels["img"] = new["image"] - labels["cls"] = np.array(new["class_labels"]) - bboxes = np.array(new["bboxes"], dtype=np.float32) - labels["instances"].update(bboxes=bboxes) - return labels - - -# TODO: technically this is not an augmentation, maybe we should put this to another files -class Format: - """ - Formats image annotations for object detection, instance segmentation, and pose estimation tasks. The class - standardizes the image and instance annotations to be used by the `collate_fn` in PyTorch DataLoader. - - Attributes: - bbox_format (str): Format for bounding boxes. Default is 'xywh'. - normalize (bool): Whether to normalize bounding boxes. Default is True. - return_mask (bool): Return instance masks for segmentation. Default is False. - return_keypoint (bool): Return keypoints for pose estimation. Default is False. - mask_ratio (int): Downsample ratio for masks. Default is 4. - mask_overlap (bool): Whether to overlap masks. Default is True. - batch_idx (bool): Keep batch indexes. Default is True. - """ - - def __init__( - self, - bbox_format="xywh", - normalize=True, - return_mask=False, - return_keypoint=False, - return_obb=False, - mask_ratio=4, - mask_overlap=True, - batch_idx=True, - ): - """Initializes the Format class with given parameters.""" - self.bbox_format = bbox_format - self.normalize = normalize - self.return_mask = return_mask # set False when training detection only - self.return_keypoint = return_keypoint - self.return_obb = return_obb - self.mask_ratio = mask_ratio - self.mask_overlap = mask_overlap - self.batch_idx = batch_idx # keep the batch indexes - - def __call__(self, labels): - """Return formatted image, classes, bounding boxes & keypoints to be used by 'collate_fn'.""" - img = labels.pop("img") - h, w = img.shape[:2] - cls = labels.pop("cls") - instances = labels.pop("instances") - instances.convert_bbox(format=self.bbox_format) - instances.denormalize(w, h) - nl = len(instances) - - if self.return_mask: - if nl: - masks, instances, cls = self._format_segments(instances, cls, w, h) - masks = torch.from_numpy(masks) - else: - masks = torch.zeros( - 1 if self.mask_overlap else nl, img.shape[0] // self.mask_ratio, img.shape[1] // self.mask_ratio - ) - labels["masks"] = masks - if self.normalize: - instances.normalize(w, h) - labels["img"] = self._format_img(img) - labels["cls"] = torch.from_numpy(cls) if nl else torch.zeros(nl) - labels["bboxes"] = torch.from_numpy(instances.bboxes) if nl else torch.zeros((nl, 4)) - if self.return_keypoint: - labels["keypoints"] = torch.from_numpy(instances.keypoints) - if self.return_obb: - labels["bboxes"] = ( - xyxyxyxy2xywhr(torch.from_numpy(instances.segments)) if len(instances.segments) else torch.zeros((0, 5)) - ) - # Then we can use collate_fn - if self.batch_idx: - labels["batch_idx"] = torch.zeros(nl) - return labels - - def _format_img(self, img): - """Format the image for YOLO from Numpy array to PyTorch tensor.""" - if len(img.shape) < 3: - img = np.expand_dims(img, -1) - img = np.ascontiguousarray(img.transpose(2, 0, 1)[::-1]) - img = torch.from_numpy(img) - return img - - def _format_segments(self, instances, cls, w, h): - """Convert polygon points to bitmap.""" - segments = instances.segments - if self.mask_overlap: - masks, sorted_idx = polygons2masks_overlap((h, w), segments, downsample_ratio=self.mask_ratio) - masks = masks[None] # (640, 640) -> (1, 640, 640) - instances = instances[sorted_idx] - cls = cls[sorted_idx] - else: - masks = polygons2masks((h, w), segments, color=1, downsample_ratio=self.mask_ratio) - - return masks, instances, cls - - -def v8_transforms(dataset, imgsz, hyp, stretch=False): - """Convert images to a size suitable for YOLOv8 training.""" - pre_transform = Compose( - [ - Mosaic(dataset, imgsz=imgsz, p=hyp.mosaic), - CopyPaste(p=hyp.copy_paste), - RandomPerspective( - degrees=hyp.degrees, - translate=hyp.translate, - scale=hyp.scale, - shear=hyp.shear, - perspective=hyp.perspective, - pre_transform=None if stretch else LetterBox(new_shape=(imgsz, imgsz)), - ), - ] - ) - flip_idx = dataset.data.get("flip_idx", []) # for keypoints augmentation - if dataset.use_keypoints: - kpt_shape = dataset.data.get("kpt_shape", None) - if len(flip_idx) == 0 and hyp.fliplr > 0.0: - hyp.fliplr = 0.0 - LOGGER.warning("WARNING ⚠️ No 'flip_idx' array defined in data.yaml, setting augmentation 'fliplr=0.0'") - elif flip_idx and (len(flip_idx) != kpt_shape[0]): - raise ValueError(f"data.yaml flip_idx={flip_idx} length must be equal to kpt_shape[0]={kpt_shape[0]}") - - return Compose( - [ - pre_transform, - MixUp(dataset, pre_transform=pre_transform, p=hyp.mixup), - Albumentations(p=1.0), - RandomHSV(hgain=hyp.hsv_h, sgain=hyp.hsv_s, vgain=hyp.hsv_v), - RandomFlip(direction="vertical", p=hyp.flipud), - RandomFlip(direction="horizontal", p=hyp.fliplr, flip_idx=flip_idx), - ] - ) # transforms - - -# Classification augmentations ----------------------------------------------------------------------------------------- -def classify_transforms( - size=224, - mean=DEFAULT_MEAN, - std=DEFAULT_STD, - interpolation: T.InterpolationMode = T.InterpolationMode.BILINEAR, - crop_fraction: float = DEFAULT_CROP_FTACTION, -): - """ - Classification transforms for evaluation/inference. Inspired by timm/data/transforms_factory.py. - - Args: - size (int): image size - mean (tuple): mean values of RGB channels - std (tuple): std values of RGB channels - interpolation (T.InterpolationMode): interpolation mode. default is T.InterpolationMode.BILINEAR. - crop_fraction (float): fraction of image to crop. default is 1.0. - - Returns: - (T.Compose): torchvision transforms - """ - - if isinstance(size, (tuple, list)): - assert len(size) == 2 - scale_size = tuple(math.floor(x / crop_fraction) for x in size) - else: - scale_size = math.floor(size / crop_fraction) - scale_size = (scale_size, scale_size) - - # aspect ratio is preserved, crops center within image, no borders are added, image is lost - if scale_size[0] == scale_size[1]: - # simple case, use torchvision built-in Resize w/ shortest edge mode (scalar size arg) - tfl = [T.Resize(scale_size[0], interpolation=interpolation)] - else: - # resize shortest edge to matching target dim for non-square target - tfl = [T.Resize(scale_size)] - tfl += [T.CenterCrop(size)] - - tfl += [ - T.ToTensor(), - T.Normalize( - mean=torch.tensor(mean), - std=torch.tensor(std), - ), - ] - - return T.Compose(tfl) - - -# Classification augmentations train --------------------------------------------------------------------------------------- -def classify_augmentations( - size=224, - mean=DEFAULT_MEAN, - std=DEFAULT_STD, - scale=None, - ratio=None, - hflip=0.5, - vflip=0.0, - auto_augment=None, - hsv_h=0.015, # image HSV-Hue augmentation (fraction) - hsv_s=0.4, # image HSV-Saturation augmentation (fraction) - hsv_v=0.4, # image HSV-Value augmentation (fraction) - force_color_jitter=False, - erasing=0.0, - interpolation: T.InterpolationMode = T.InterpolationMode.BILINEAR, -): - """ - Classification transforms with augmentation for training. Inspired by timm/data/transforms_factory.py. - - Args: - size (int): image size - scale (tuple): scale range of the image. default is (0.08, 1.0) - ratio (tuple): aspect ratio range of the image. default is (3./4., 4./3.) - mean (tuple): mean values of RGB channels - std (tuple): std values of RGB channels - hflip (float): probability of horizontal flip - vflip (float): probability of vertical flip - auto_augment (str): auto augmentation policy. can be 'randaugment', 'augmix', 'autoaugment' or None. - hsv_h (float): image HSV-Hue augmentation (fraction) - hsv_s (float): image HSV-Saturation augmentation (fraction) - hsv_v (float): image HSV-Value augmentation (fraction) - force_color_jitter (bool): force to apply color jitter even if auto augment is enabled - erasing (float): probability of random erasing - interpolation (T.InterpolationMode): interpolation mode. default is T.InterpolationMode.BILINEAR. - - Returns: - (T.Compose): torchvision transforms - """ - # Transforms to apply if albumentations not installed - if not isinstance(size, int): - raise TypeError(f"classify_transforms() size {size} must be integer, not (list, tuple)") - scale = tuple(scale or (0.08, 1.0)) # default imagenet scale range - ratio = tuple(ratio or (3.0 / 4.0, 4.0 / 3.0)) # default imagenet ratio range - primary_tfl = [T.RandomResizedCrop(size, scale=scale, ratio=ratio, interpolation=interpolation)] - if hflip > 0.0: - primary_tfl += [T.RandomHorizontalFlip(p=hflip)] - if vflip > 0.0: - primary_tfl += [T.RandomVerticalFlip(p=vflip)] - - secondary_tfl = [] - disable_color_jitter = False - if auto_augment: - assert isinstance(auto_augment, str) - # color jitter is typically disabled if AA/RA on, - # this allows override without breaking old hparm cfgs - disable_color_jitter = not force_color_jitter - - if auto_augment == "randaugment": - if TORCHVISION_0_11: - secondary_tfl += [T.RandAugment(interpolation=interpolation)] - else: - LOGGER.warning('"auto_augment=randaugment" requires torchvision >= 0.11.0. Disabling it.') - - elif auto_augment == "augmix": - if TORCHVISION_0_13: - secondary_tfl += [T.AugMix(interpolation=interpolation)] - else: - LOGGER.warning('"auto_augment=augmix" requires torchvision >= 0.13.0. Disabling it.') - - elif auto_augment == "autoaugment": - if TORCHVISION_0_10: - secondary_tfl += [T.AutoAugment(interpolation=interpolation)] - else: - LOGGER.warning('"auto_augment=autoaugment" requires torchvision >= 0.10.0. Disabling it.') - - else: - raise ValueError( - f'Invalid auto_augment policy: {auto_augment}. Should be one of "randaugment", ' - f'"augmix", "autoaugment" or None' - ) - - if not disable_color_jitter: - secondary_tfl += [T.ColorJitter(brightness=hsv_v, contrast=hsv_v, saturation=hsv_s, hue=hsv_h)] - - final_tfl = [ - T.ToTensor(), - T.Normalize(mean=torch.tensor(mean), std=torch.tensor(std)), - T.RandomErasing(p=erasing, inplace=True), - ] - - return T.Compose(primary_tfl + secondary_tfl + final_tfl) - - -# NOTE: keep this class for backward compatibility -class ClassifyLetterBox: - """ - YOLOv8 LetterBox class for image preprocessing, designed to be part of a transformation pipeline, e.g., - T.Compose([LetterBox(size), ToTensor()]). - - Attributes: - h (int): Target height of the image. - w (int): Target width of the image. - auto (bool): If True, automatically solves for short side using stride. - stride (int): The stride value, used when 'auto' is True. - """ - - def __init__(self, size=(640, 640), auto=False, stride=32): - """ - Initializes the ClassifyLetterBox class with a target size, auto-flag, and stride. - - Args: - size (Union[int, Tuple[int, int]]): The target dimensions (height, width) for the letterbox. - auto (bool): If True, automatically calculates the short side based on stride. - stride (int): The stride value, used when 'auto' is True. - """ - super().__init__() - self.h, self.w = (size, size) if isinstance(size, int) else size - self.auto = auto # pass max size integer, automatically solve for short side using stride - self.stride = stride # used with auto - - def __call__(self, im): - """ - Resizes the image and pads it with a letterbox method. - - Args: - im (numpy.ndarray): The input image as a numpy array of shape HWC. - - Returns: - (numpy.ndarray): The letterboxed and resized image as a numpy array. - """ - imh, imw = im.shape[:2] - r = min(self.h / imh, self.w / imw) # ratio of new/old dimensions - h, w = round(imh * r), round(imw * r) # resized image dimensions - - # Calculate padding dimensions - hs, ws = (math.ceil(x / self.stride) * self.stride for x in (h, w)) if self.auto else (self.h, self.w) - top, left = round((hs - h) / 2 - 0.1), round((ws - w) / 2 - 0.1) - - # Create padded image - im_out = np.full((hs, ws, 3), 114, dtype=im.dtype) - im_out[top : top + h, left : left + w] = cv2.resize(im, (w, h), interpolation=cv2.INTER_LINEAR) - return im_out - - -# NOTE: keep this class for backward compatibility -class CenterCrop: - """YOLOv8 CenterCrop class for image preprocessing, designed to be part of a transformation pipeline, e.g., - T.Compose([CenterCrop(size), ToTensor()]). - """ - - def __init__(self, size=640): - """Converts an image from numpy array to PyTorch tensor.""" - super().__init__() - self.h, self.w = (size, size) if isinstance(size, int) else size - - def __call__(self, im): - """ - Resizes and crops the center of the image using a letterbox method. - - Args: - im (numpy.ndarray): The input image as a numpy array of shape HWC. - - Returns: - (numpy.ndarray): The center-cropped and resized image as a numpy array. - """ - imh, imw = im.shape[:2] - m = min(imh, imw) # min dimension - top, left = (imh - m) // 2, (imw - m) // 2 - return cv2.resize(im[top : top + m, left : left + m], (self.w, self.h), interpolation=cv2.INTER_LINEAR) - - -# NOTE: keep this class for backward compatibility -class ToTensor: - """YOLOv8 ToTensor class for image preprocessing, i.e., T.Compose([LetterBox(size), ToTensor()]).""" - - def __init__(self, half=False): - """Initialize YOLOv8 ToTensor object with optional half-precision support.""" - super().__init__() - self.half = half - - def __call__(self, im): - """ - Transforms an image from a numpy array to a PyTorch tensor, applying optional half-precision and normalization. - - Args: - im (numpy.ndarray): Input image as a numpy array with shape (H, W, C) in BGR order. - - Returns: - (torch.Tensor): The transformed image as a PyTorch tensor in float32 or float16, normalized to [0, 1]. - """ - im = np.ascontiguousarray(im.transpose((2, 0, 1))[::-1]) # HWC to CHW -> BGR to RGB -> contiguous - im = torch.from_numpy(im) # to torch - im = im.half() if self.half else im.float() # uint8 to fp16/32 - im /= 255.0 # 0-255 to 0.0-1.0 - return im diff --git a/ultralytics-main/ultralytics/data/base.py b/ultralytics-main/ultralytics/data/base.py deleted file mode 100644 index 6af8d3c..0000000 --- a/ultralytics-main/ultralytics/data/base.py +++ /dev/null @@ -1,311 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import glob -import math -import os -import random -from copy import deepcopy -from multiprocessing.pool import ThreadPool -from pathlib import Path -from typing import Optional - -import cv2 -import numpy as np -import psutil -from torch.utils.data import Dataset - -from ultralytics.utils import DEFAULT_CFG, LOCAL_RANK, LOGGER, NUM_THREADS, TQDM -from .utils import HELP_URL, IMG_FORMATS - - -class BaseDataset(Dataset): - """ - Base dataset class for loading and processing image data. - - Args: - img_path (str): Path to the folder containing images. - imgsz (int, optional): Image size. Defaults to 640. - cache (bool, optional): Cache images to RAM or disk during training. Defaults to False. - augment (bool, optional): If True, data augmentation is applied. Defaults to True. - hyp (dict, optional): Hyperparameters to apply data augmentation. Defaults to None. - prefix (str, optional): Prefix to print in log messages. Defaults to ''. - rect (bool, optional): If True, rectangular training is used. Defaults to False. - batch_size (int, optional): Size of batches. Defaults to None. - stride (int, optional): Stride. Defaults to 32. - pad (float, optional): Padding. Defaults to 0.0. - single_cls (bool, optional): If True, single class training is used. Defaults to False. - classes (list): List of included classes. Default is None. - fraction (float): Fraction of dataset to utilize. Default is 1.0 (use all data). - - Attributes: - im_files (list): List of image file paths. - labels (list): List of label data dictionaries. - ni (int): Number of images in the dataset. - ims (list): List of loaded images. - npy_files (list): List of numpy file paths. - transforms (callable): Image transformation function. - """ - - def __init__( - self, - img_path, - imgsz=640, - cache=False, - augment=True, - hyp=DEFAULT_CFG, - prefix="", - rect=False, - batch_size=16, - stride=32, - pad=0.5, - single_cls=False, - classes=None, - fraction=1.0, - ): - """Initialize BaseDataset with given configuration and options.""" - super().__init__() - self.img_path = img_path - self.imgsz = imgsz - self.augment = augment - self.single_cls = single_cls - self.prefix = prefix - self.fraction = fraction - self.im_files = self.get_img_files(self.img_path) - self.labels = self.get_labels() - self.update_labels(include_class=classes) # single_cls and include_class - self.ni = len(self.labels) # number of images - self.rect = rect - self.batch_size = batch_size - self.stride = stride - self.pad = pad - if self.rect: - assert self.batch_size is not None - self.set_rectangle() - - # Buffer thread for mosaic images - self.buffer = [] # buffer size = batch size - self.max_buffer_length = min((self.ni, self.batch_size * 8, 1000)) if self.augment else 0 - - # Cache images - if cache == "ram" and not self.check_cache_ram(): - cache = False - self.ims, self.im_hw0, self.im_hw = [None] * self.ni, [None] * self.ni, [None] * self.ni - self.npy_files = [Path(f).with_suffix(".npy") for f in self.im_files] - if cache: - self.cache_images(cache) - - # Transforms - self.transforms = self.build_transforms(hyp=hyp) - - def get_img_files(self, img_path): - """Read image files.""" - try: - f = [] # image files - for p in img_path if isinstance(img_path, list) else [img_path]: - p = Path(p) # os-agnostic - if p.is_dir(): # dir - f += glob.glob(str(p / "**" / "*.*"), recursive=True) - # F = list(p.rglob('*.*')) # pathlib - elif p.is_file(): # file - with open(p) as t: - t = t.read().strip().splitlines() - parent = str(p.parent) + os.sep - f += [x.replace("./", parent) if x.startswith("./") else x for x in t] # local to global path - # F += [p.parent / x.lstrip(os.sep) for x in t] # local to global path (pathlib) - else: - raise FileNotFoundError(f"{self.prefix}{p} does not exist") - im_files = sorted(x.replace("/", os.sep) for x in f if x.split(".")[-1].lower() in IMG_FORMATS) - # self.img_files = sorted([x for x in f if x.suffix[1:].lower() in IMG_FORMATS]) # pathlib - assert im_files, f"{self.prefix}No images found in {img_path}" - except Exception as e: - raise FileNotFoundError(f"{self.prefix}Error loading data from {img_path}\n{HELP_URL}") from e - if self.fraction < 1: - # im_files = im_files[: round(len(im_files) * self.fraction)] - num_elements_to_select = round(len(im_files) * self.fraction) - im_files = random.sample(im_files, num_elements_to_select) - return im_files - - def update_labels(self, include_class: Optional[list]): - """Update labels to include only these classes (optional).""" - include_class_array = np.array(include_class).reshape(1, -1) - for i in range(len(self.labels)): - if include_class is not None: - cls = self.labels[i]["cls"] - bboxes = self.labels[i]["bboxes"] - segments = self.labels[i]["segments"] - keypoints = self.labels[i]["keypoints"] - j = (cls == include_class_array).any(1) - self.labels[i]["cls"] = cls[j] - self.labels[i]["bboxes"] = bboxes[j] - if segments: - self.labels[i]["segments"] = [segments[si] for si, idx in enumerate(j) if idx] - if keypoints is not None: - self.labels[i]["keypoints"] = keypoints[j] - if self.single_cls: - self.labels[i]["cls"][:, 0] = 0 - - def load_image(self, i, rect_mode=True): - """Loads 1 image from dataset index 'i', returns (im, resized hw).""" - im, f, fn = self.ims[i], self.im_files[i], self.npy_files[i] - if im is None: # not cached in RAM - if fn.exists(): # load npy - try: - im = np.load(fn) - except Exception as e: - LOGGER.warning(f"{self.prefix}WARNING ⚠️ Removing corrupt *.npy image file {fn} due to: {e}") - Path(fn).unlink(missing_ok=True) - im = cv2.imread(f) # BGR - else: # read image - im = cv2.imread(f) # BGR - if im is None: - raise FileNotFoundError(f"Image Not Found {f}") - - h0, w0 = im.shape[:2] # orig hw - if rect_mode: # resize long side to imgsz while maintaining aspect ratio - r = self.imgsz / max(h0, w0) # ratio - if r != 1: # if sizes are not equal - w, h = (min(math.ceil(w0 * r), self.imgsz), min(math.ceil(h0 * r), self.imgsz)) - im = cv2.resize(im, (w, h), interpolation=cv2.INTER_LINEAR) - elif not (h0 == w0 == self.imgsz): # resize by stretching image to square imgsz - im = cv2.resize(im, (self.imgsz, self.imgsz), interpolation=cv2.INTER_LINEAR) - - # Add to buffer if training with augmentations - if self.augment: - self.ims[i], self.im_hw0[i], self.im_hw[i] = im, (h0, w0), im.shape[:2] # im, hw_original, hw_resized - self.buffer.append(i) - if len(self.buffer) >= self.max_buffer_length: - j = self.buffer.pop(0) - self.ims[j], self.im_hw0[j], self.im_hw[j] = None, None, None - - return im, (h0, w0), im.shape[:2] - - return self.ims[i], self.im_hw0[i], self.im_hw[i] - - def cache_images(self, cache): - """Cache images to memory or disk.""" - b, gb = 0, 1 << 30 # bytes of cached images, bytes per gigabytes - fcn = self.cache_images_to_disk if cache == "disk" else self.load_image - with ThreadPool(NUM_THREADS) as pool: - results = pool.imap(fcn, range(self.ni)) - pbar = TQDM(enumerate(results), total=self.ni, disable=LOCAL_RANK > 0) - for i, x in pbar: - if cache == "disk": - b += self.npy_files[i].stat().st_size - else: # 'ram' - self.ims[i], self.im_hw0[i], self.im_hw[i] = x # im, hw_orig, hw_resized = load_image(self, i) - b += self.ims[i].nbytes - pbar.desc = f"{self.prefix}Caching images ({b / gb:.1f}GB {cache})" - pbar.close() - - def cache_images_to_disk(self, i): - """Saves an image as an *.npy file for faster loading.""" - f = self.npy_files[i] - if not f.exists(): - np.save(f.as_posix(), cv2.imread(self.im_files[i]), allow_pickle=False) - - def check_cache_ram(self, safety_margin=0.5): - """Check image caching requirements vs available memory.""" - b, gb = 0, 1 << 30 # bytes of cached images, bytes per gigabytes - n = min(self.ni, 30) # extrapolate from 30 random images - for _ in range(n): - im = cv2.imread(random.choice(self.im_files)) # sample image - ratio = self.imgsz / max(im.shape[0], im.shape[1]) # max(h, w) # ratio - b += im.nbytes * ratio**2 - mem_required = b * self.ni / n * (1 + safety_margin) # GB required to cache dataset into RAM - mem = psutil.virtual_memory() - cache = mem_required < mem.available # to cache or not to cache, that is the question - if not cache: - LOGGER.info( - f'{self.prefix}{mem_required / gb:.1f}GB RAM required to cache images ' - f'with {int(safety_margin * 100)}% safety margin but only ' - f'{mem.available / gb:.1f}/{mem.total / gb:.1f}GB available, ' - f"{'caching images ✅' if cache else 'not caching images ⚠️'}" - ) - return cache - - def set_rectangle(self): - """Sets the shape of bounding boxes for YOLO detections as rectangles.""" - bi = np.floor(np.arange(self.ni) / self.batch_size).astype(int) # batch index - nb = bi[-1] + 1 # number of batches - - s = np.array([x.pop("shape") for x in self.labels]) # hw - ar = s[:, 0] / s[:, 1] # aspect ratio - irect = ar.argsort() - self.im_files = [self.im_files[i] for i in irect] - self.labels = [self.labels[i] for i in irect] - ar = ar[irect] - - # Set training image shapes - shapes = [[1, 1]] * nb - for i in range(nb): - ari = ar[bi == i] - mini, maxi = ari.min(), ari.max() - if maxi < 1: - shapes[i] = [maxi, 1] - elif mini > 1: - shapes[i] = [1, 1 / mini] - - self.batch_shapes = np.ceil(np.array(shapes) * self.imgsz / self.stride + self.pad).astype(int) * self.stride - self.batch = bi # batch index of image - - def __getitem__(self, index): - """Returns transformed label information for given index.""" - return self.transforms(self.get_image_and_label(index)) - - def get_image_and_label(self, index): - """Get and return label information from the dataset.""" - label = deepcopy(self.labels[index]) # requires deepcopy() https://github.com/ultralytics/ultralytics/pull/1948 - label.pop("shape", None) # shape is for rect, remove it - label["img"], label["ori_shape"], label["resized_shape"] = self.load_image(index) - label["ratio_pad"] = ( - label["resized_shape"][0] / label["ori_shape"][0], - label["resized_shape"][1] / label["ori_shape"][1], - ) # for evaluation - if self.rect: - label["rect_shape"] = self.batch_shapes[self.batch[index]] - return self.update_labels_info(label) - - def __len__(self): - """Returns the length of the labels list for the dataset.""" - return len(self.labels) - - def update_labels_info(self, label): - """Custom your label format here.""" - return label - - def build_transforms(self, hyp=None): - """ - Users can customize augmentations here. - - Example: - ```python - if self.augment: - # Training transforms - return Compose([]) - else: - # Val transforms - return Compose([]) - ``` - """ - raise NotImplementedError - - def get_labels(self): - """ - Users can customize their own format here. - - Note: - Ensure output is a dictionary with the following keys: - ```python - dict( - im_file=im_file, - shape=shape, # format: (height, width) - cls=cls, - bboxes=bboxes, # xywh - segments=segments, # xy - keypoints=keypoints, # xy - normalized=True, # or False - bbox_format="xyxy", # or xywh, ltwh - ) - ``` - """ - raise NotImplementedError diff --git a/ultralytics-main/ultralytics/data/build.py b/ultralytics-main/ultralytics/data/build.py deleted file mode 100644 index 37c5fa4..0000000 --- a/ultralytics-main/ultralytics/data/build.py +++ /dev/null @@ -1,186 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import os -import random -from pathlib import Path - -import numpy as np -import torch -from PIL import Image -from torch.utils.data import dataloader, distributed - -from ultralytics.data.loaders import ( - LOADERS, - LoadImagesAndVideos, - LoadPilAndNumpy, - LoadScreenshots, - LoadStreams, - LoadTensor, - SourceTypes, - autocast_list, -) -from ultralytics.data.utils import IMG_FORMATS, VID_FORMATS -from ultralytics.utils import RANK, colorstr -from ultralytics.utils.checks import check_file -from .dataset import YOLODataset -from .utils import PIN_MEMORY - - -class InfiniteDataLoader(dataloader.DataLoader): - """ - Dataloader that reuses workers. - - Uses same syntax as vanilla DataLoader. - """ - - def __init__(self, *args, **kwargs): - """Dataloader that infinitely recycles workers, inherits from DataLoader.""" - super().__init__(*args, **kwargs) - object.__setattr__(self, "batch_sampler", _RepeatSampler(self.batch_sampler)) - self.iterator = super().__iter__() - - def __len__(self): - """Returns the length of the batch sampler's sampler.""" - return len(self.batch_sampler.sampler) - - def __iter__(self): - """Creates a sampler that repeats indefinitely.""" - for _ in range(len(self)): - yield next(self.iterator) - - def reset(self): - """ - Reset iterator. - - This is useful when we want to modify settings of dataset while training. - """ - self.iterator = self._get_iterator() - - -class _RepeatSampler: - """ - Sampler that repeats forever. - - Args: - sampler (Dataset.sampler): The sampler to repeat. - """ - - def __init__(self, sampler): - """Initializes an object that repeats a given sampler indefinitely.""" - self.sampler = sampler - - def __iter__(self): - """Iterates over the 'sampler' and yields its contents.""" - while True: - yield from iter(self.sampler) - - -def seed_worker(worker_id): # noqa - """Set dataloader worker seed https://pytorch.org/docs/stable/notes/randomness.html#dataloader.""" - worker_seed = torch.initial_seed() % 2**32 - np.random.seed(worker_seed) - random.seed(worker_seed) - - -def build_yolo_dataset(cfg, img_path, batch, data, mode="train", rect=False, stride=32): - """Build YOLO Dataset.""" - return YOLODataset( - img_path=img_path, - imgsz=cfg.imgsz, - batch_size=batch, - augment=mode == "train", # augmentation - hyp=cfg, # TODO: probably add a get_hyps_from_cfg function - rect=cfg.rect or rect, # rectangular batches - cache=cfg.cache or None, - single_cls=cfg.single_cls or False, - stride=int(stride), - pad=0.0 if mode == "train" else 0.5, - prefix=colorstr(f"{mode}: "), - task=cfg.task, - classes=cfg.classes, - data=data, - fraction=cfg.fraction if mode == "train" else 1.0, - ) - - -def build_dataloader(dataset, batch, workers, shuffle=True, rank=-1): - """Return an InfiniteDataLoader or DataLoader for training or validation set.""" - batch = min(batch, len(dataset)) - nd = torch.cuda.device_count() # number of CUDA devices - nw = min([os.cpu_count() // max(nd, 1), workers]) # number of workers - sampler = None if rank == -1 else distributed.DistributedSampler(dataset, shuffle=shuffle) - generator = torch.Generator() - generator.manual_seed(6148914691236517205 + RANK) - return InfiniteDataLoader( - dataset=dataset, - batch_size=batch, - shuffle=shuffle and sampler is None, - num_workers=nw, - sampler=sampler, - pin_memory=PIN_MEMORY, - collate_fn=getattr(dataset, "collate_fn", None), - worker_init_fn=seed_worker, - generator=generator, - ) - - -def check_source(source): - """Check source type and return corresponding flag values.""" - webcam, screenshot, from_img, in_memory, tensor = False, False, False, False, False - if isinstance(source, (str, int, Path)): # int for local usb camera - source = str(source) - is_file = Path(source).suffix[1:] in (IMG_FORMATS + VID_FORMATS) - is_url = source.lower().startswith(("https://", "http://", "rtsp://", "rtmp://", "tcp://")) - webcam = source.isnumeric() or source.endswith(".streams") or (is_url and not is_file) - screenshot = source.lower() == "screen" - if is_url and is_file: - source = check_file(source) # download - elif isinstance(source, LOADERS): - in_memory = True - elif isinstance(source, (list, tuple)): - source = autocast_list(source) # convert all list elements to PIL or np arrays - from_img = True - elif isinstance(source, (Image.Image, np.ndarray)): - from_img = True - elif isinstance(source, torch.Tensor): - tensor = True - else: - raise TypeError("Unsupported image type. For supported types see https://docs.ultralytics.com/modes/predict") - - return source, webcam, screenshot, from_img, in_memory, tensor - - -def load_inference_source(source=None, batch=1, vid_stride=1, buffer=False): - """ - Loads an inference source for object detection and applies necessary transformations. - - Args: - source (str, Path, Tensor, PIL.Image, np.ndarray): The input source for inference. - batch (int, optional): Batch size for dataloaders. Default is 1. - vid_stride (int, optional): The frame interval for video sources. Default is 1. - buffer (bool, optional): Determined whether stream frames will be buffered. Default is False. - - Returns: - dataset (Dataset): A dataset object for the specified input source. - """ - source, stream, screenshot, from_img, in_memory, tensor = check_source(source) - source_type = source.source_type if in_memory else SourceTypes(stream, screenshot, from_img, tensor) - - # Dataloader - if tensor: - dataset = LoadTensor(source) - elif in_memory: - dataset = source - elif stream: - dataset = LoadStreams(source, vid_stride=vid_stride, buffer=buffer) - elif screenshot: - dataset = LoadScreenshots(source) - elif from_img: - dataset = LoadPilAndNumpy(source) - else: - dataset = LoadImagesAndVideos(source, batch=batch, vid_stride=vid_stride) - - # Attach source types to the dataset - setattr(dataset, "source_type", source_type) - - return dataset diff --git a/ultralytics-main/ultralytics/data/converter.py b/ultralytics-main/ultralytics/data/converter.py deleted file mode 100644 index eff4dac..0000000 --- a/ultralytics-main/ultralytics/data/converter.py +++ /dev/null @@ -1,542 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import json -from collections import defaultdict -from pathlib import Path - -import cv2 -import numpy as np - -from ultralytics.utils import LOGGER, TQDM -from ultralytics.utils.files import increment_path - - -def coco91_to_coco80_class(): - """ - Converts 91-index COCO class IDs to 80-index COCO class IDs. - - Returns: - (list): A list of 91 class IDs where the index represents the 80-index class ID and the value is the - corresponding 91-index class ID. - """ - return [ - 0, - 1, - 2, - 3, - 4, - 5, - 6, - 7, - 8, - 9, - 10, - None, - 11, - 12, - 13, - 14, - 15, - 16, - 17, - 18, - 19, - 20, - 21, - 22, - 23, - None, - 24, - 25, - None, - None, - 26, - 27, - 28, - 29, - 30, - 31, - 32, - 33, - 34, - 35, - 36, - 37, - 38, - 39, - None, - 40, - 41, - 42, - 43, - 44, - 45, - 46, - 47, - 48, - 49, - 50, - 51, - 52, - 53, - 54, - 55, - 56, - 57, - 58, - 59, - None, - 60, - None, - None, - 61, - None, - 62, - 63, - 64, - 65, - 66, - 67, - 68, - 69, - 70, - 71, - 72, - None, - 73, - 74, - 75, - 76, - 77, - 78, - 79, - None, - ] - - -def coco80_to_coco91_class(): - """ - Converts 80-index (val2014) to 91-index (paper). - For details see https://tech.amikelive.com/node-718/what-object-categories-labels-are-in-coco-dataset/. - - Example: - ```python - import numpy as np - - a = np.loadtxt('data/coco.names', dtype='str', delimiter='\n') - b = np.loadtxt('data/coco_paper.names', dtype='str', delimiter='\n') - x1 = [list(a[i] == b).index(True) + 1 for i in range(80)] # darknet to coco - x2 = [list(b[i] == a).index(True) if any(b[i] == a) else None for i in range(91)] # coco to darknet - ``` - """ - return [ - 1, - 2, - 3, - 4, - 5, - 6, - 7, - 8, - 9, - 10, - 11, - 13, - 14, - 15, - 16, - 17, - 18, - 19, - 20, - 21, - 22, - 23, - 24, - 25, - 27, - 28, - 31, - 32, - 33, - 34, - 35, - 36, - 37, - 38, - 39, - 40, - 41, - 42, - 43, - 44, - 46, - 47, - 48, - 49, - 50, - 51, - 52, - 53, - 54, - 55, - 56, - 57, - 58, - 59, - 60, - 61, - 62, - 63, - 64, - 65, - 67, - 70, - 72, - 73, - 74, - 75, - 76, - 77, - 78, - 79, - 80, - 81, - 82, - 84, - 85, - 86, - 87, - 88, - 89, - 90, - ] - - -def convert_coco( - labels_dir="../coco/annotations/", - save_dir="coco_converted/", - use_segments=False, - use_keypoints=False, - cls91to80=True, -): - """ - Converts COCO dataset annotations to a YOLO annotation format suitable for training YOLO models. - - Args: - labels_dir (str, optional): Path to directory containing COCO dataset annotation files. - save_dir (str, optional): Path to directory to save results to. - use_segments (bool, optional): Whether to include segmentation masks in the output. - use_keypoints (bool, optional): Whether to include keypoint annotations in the output. - cls91to80 (bool, optional): Whether to map 91 COCO class IDs to the corresponding 80 COCO class IDs. - - Example: - ```python - from ultralytics.data.converter import convert_coco - - convert_coco('../datasets/coco/annotations/', use_segments=True, use_keypoints=False, cls91to80=True) - ``` - - Output: - Generates output files in the specified output directory. - """ - - # Create dataset directory - save_dir = increment_path(save_dir) # increment if save directory already exists - for p in save_dir / "labels", save_dir / "images": - p.mkdir(parents=True, exist_ok=True) # make dir - - # Convert classes - coco80 = coco91_to_coco80_class() - - # Import json - for json_file in sorted(Path(labels_dir).resolve().glob("*.json")): - fn = Path(save_dir) / "labels" / json_file.stem.replace("instances_", "") # folder name - fn.mkdir(parents=True, exist_ok=True) - with open(json_file) as f: - data = json.load(f) - - # Create image dict - images = {f'{x["id"]:d}': x for x in data["images"]} - # Create image-annotations dict - imgToAnns = defaultdict(list) - for ann in data["annotations"]: - imgToAnns[ann["image_id"]].append(ann) - - # Write labels file - for img_id, anns in TQDM(imgToAnns.items(), desc=f"Annotations {json_file}"): - img = images[f"{img_id:d}"] - h, w, f = img["height"], img["width"], img["file_name"] - - bboxes = [] - segments = [] - keypoints = [] - for ann in anns: - if ann["iscrowd"]: - continue - # The COCO box format is [top left x, top left y, width, height] - box = np.array(ann["bbox"], dtype=np.float64) - box[:2] += box[2:] / 2 # xy top-left corner to center - box[[0, 2]] /= w # normalize x - box[[1, 3]] /= h # normalize y - if box[2] <= 0 or box[3] <= 0: # if w <= 0 and h <= 0 - continue - - cls = coco80[ann["category_id"] - 1] if cls91to80 else ann["category_id"] - 1 # class - box = [cls] + box.tolist() - if box not in bboxes: - bboxes.append(box) - if use_segments and ann.get("segmentation") is not None: - if len(ann["segmentation"]) == 0: - segments.append([]) - continue - elif len(ann["segmentation"]) > 1: - s = merge_multi_segment(ann["segmentation"]) - s = (np.concatenate(s, axis=0) / np.array([w, h])).reshape(-1).tolist() - else: - s = [j for i in ann["segmentation"] for j in i] # all segments concatenated - s = (np.array(s).reshape(-1, 2) / np.array([w, h])).reshape(-1).tolist() - s = [cls] + s - segments.append(s) - if use_keypoints and ann.get("keypoints") is not None: - keypoints.append( - box + (np.array(ann["keypoints"]).reshape(-1, 3) / np.array([w, h, 1])).reshape(-1).tolist() - ) - - # Write - with open((fn / f).with_suffix(".txt"), "a") as file: - for i in range(len(bboxes)): - if use_keypoints: - line = (*(keypoints[i]),) # cls, box, keypoints - else: - line = ( - *(segments[i] if use_segments and len(segments[i]) > 0 else bboxes[i]), - ) # cls, box or segments - file.write(("%g " * len(line)).rstrip() % line + "\n") - - LOGGER.info(f"COCO data converted successfully.\nResults saved to {save_dir.resolve()}") - - -def convert_dota_to_yolo_obb(dota_root_path: str): - """ - Converts DOTA dataset annotations to YOLO OBB (Oriented Bounding Box) format. - - The function processes images in the 'train' and 'val' folders of the DOTA dataset. For each image, it reads the - associated label from the original labels directory and writes new labels in YOLO OBB format to a new directory. - - Args: - dota_root_path (str): The root directory path of the DOTA dataset. - - Example: - ```python - from ultralytics.data.converter import convert_dota_to_yolo_obb - - convert_dota_to_yolo_obb('path/to/DOTA') - ``` - - Notes: - The directory structure assumed for the DOTA dataset: - - - DOTA - ├─ images - │ ├─ train - │ └─ val - └─ labels - ├─ train_original - └─ val_original - - After execution, the function will organize the labels into: - - - DOTA - └─ labels - ├─ train - └─ val - """ - dota_root_path = Path(dota_root_path) - - # Class names to indices mapping - class_mapping = { - "plane": 0, - "ship": 1, - "storage-tank": 2, - "baseball-diamond": 3, - "tennis-court": 4, - "basketball-court": 5, - "ground-track-field": 6, - "harbor": 7, - "bridge": 8, - "large-vehicle": 9, - "small-vehicle": 10, - "helicopter": 11, - "roundabout": 12, - "soccer-ball-field": 13, - "swimming-pool": 14, - "container-crane": 15, - "airport": 16, - "helipad": 17, - } - - def convert_label(image_name, image_width, image_height, orig_label_dir, save_dir): - """Converts a single image's DOTA annotation to YOLO OBB format and saves it to a specified directory.""" - orig_label_path = orig_label_dir / f"{image_name}.txt" - save_path = save_dir / f"{image_name}.txt" - - with orig_label_path.open("r") as f, save_path.open("w") as g: - lines = f.readlines() - for line in lines: - parts = line.strip().split() - if len(parts) < 9: - continue - class_name = parts[8] - class_idx = class_mapping[class_name] - coords = [float(p) for p in parts[:8]] - normalized_coords = [ - coords[i] / image_width if i % 2 == 0 else coords[i] / image_height for i in range(8) - ] - formatted_coords = ["{:.6g}".format(coord) for coord in normalized_coords] - g.write(f"{class_idx} {' '.join(formatted_coords)}\n") - - for phase in ["train", "val"]: - image_dir = dota_root_path / "images" / phase - orig_label_dir = dota_root_path / "labels" / f"{phase}_original" - save_dir = dota_root_path / "labels" / phase - - save_dir.mkdir(parents=True, exist_ok=True) - - image_paths = list(image_dir.iterdir()) - for image_path in TQDM(image_paths, desc=f"Processing {phase} images"): - if image_path.suffix != ".png": - continue - image_name_without_ext = image_path.stem - img = cv2.imread(str(image_path)) - h, w = img.shape[:2] - convert_label(image_name_without_ext, w, h, orig_label_dir, save_dir) - - -def min_index(arr1, arr2): - """ - Find a pair of indexes with the shortest distance between two arrays of 2D points. - - Args: - arr1 (np.ndarray): A NumPy array of shape (N, 2) representing N 2D points. - arr2 (np.ndarray): A NumPy array of shape (M, 2) representing M 2D points. - - Returns: - (tuple): A tuple containing the indexes of the points with the shortest distance in arr1 and arr2 respectively. - """ - dis = ((arr1[:, None, :] - arr2[None, :, :]) ** 2).sum(-1) - return np.unravel_index(np.argmin(dis, axis=None), dis.shape) - - -def merge_multi_segment(segments): - """ - Merge multiple segments into one list by connecting the coordinates with the minimum distance between each segment. - This function connects these coordinates with a thin line to merge all segments into one. - - Args: - segments (List[List]): Original segmentations in COCO's JSON file. - Each element is a list of coordinates, like [segmentation1, segmentation2,...]. - - Returns: - s (List[np.ndarray]): A list of connected segments represented as NumPy arrays. - """ - s = [] - segments = [np.array(i).reshape(-1, 2) for i in segments] - idx_list = [[] for _ in range(len(segments))] - - # Record the indexes with min distance between each segment - for i in range(1, len(segments)): - idx1, idx2 = min_index(segments[i - 1], segments[i]) - idx_list[i - 1].append(idx1) - idx_list[i].append(idx2) - - # Use two round to connect all the segments - for k in range(2): - # Forward connection - if k == 0: - for i, idx in enumerate(idx_list): - # Middle segments have two indexes, reverse the index of middle segments - if len(idx) == 2 and idx[0] > idx[1]: - idx = idx[::-1] - segments[i] = segments[i][::-1, :] - - segments[i] = np.roll(segments[i], -idx[0], axis=0) - segments[i] = np.concatenate([segments[i], segments[i][:1]]) - # Deal with the first segment and the last one - if i in [0, len(idx_list) - 1]: - s.append(segments[i]) - else: - idx = [0, idx[1] - idx[0]] - s.append(segments[i][idx[0] : idx[1] + 1]) - - else: - for i in range(len(idx_list) - 1, -1, -1): - if i not in [0, len(idx_list) - 1]: - idx = idx_list[i] - nidx = abs(idx[1] - idx[0]) - s.append(segments[i][nidx:]) - return s - - -def yolo_bbox2segment(im_dir, save_dir=None, sam_model="sam_b.pt"): - """ - Converts existing object detection dataset (bounding boxes) to segmentation dataset or oriented bounding box (OBB) - in YOLO format. Generates segmentation data using SAM auto-annotator as needed. - - Args: - im_dir (str | Path): Path to image directory to convert. - save_dir (str | Path): Path to save the generated labels, labels will be saved - into `labels-segment` in the same directory level of `im_dir` if save_dir is None. Default: None. - sam_model (str): Segmentation model to use for intermediate segmentation data; optional. - - Notes: - The input directory structure assumed for dataset: - - - im_dir - ├─ 001.jpg - ├─ .. - └─ NNN.jpg - - labels - ├─ 001.txt - ├─ .. - └─ NNN.txt - """ - from ultralytics.data import YOLODataset - from ultralytics.utils.ops import xywh2xyxy - from ultralytics.utils import LOGGER - from ultralytics import SAM - from tqdm import tqdm - - # NOTE: add placeholder to pass class index check - dataset = YOLODataset(im_dir, data=dict(names=list(range(1000)))) - if len(dataset.labels[0]["segments"]) > 0: # if it's segment data - LOGGER.info("Segmentation labels detected, no need to generate new ones!") - return - - LOGGER.info("Detection labels detected, generating segment labels by SAM model!") - sam_model = SAM(sam_model) - for l in tqdm(dataset.labels, total=len(dataset.labels), desc="Generating segment labels"): - h, w = l["shape"] - boxes = l["bboxes"] - if len(boxes) == 0: # skip empty labels - continue - boxes[:, [0, 2]] *= w - boxes[:, [1, 3]] *= h - im = cv2.imread(l["im_file"]) - sam_results = sam_model(im, bboxes=xywh2xyxy(boxes), verbose=False, save=False) - l["segments"] = sam_results[0].masks.xyn - - save_dir = Path(save_dir) if save_dir else Path(im_dir).parent / "labels-segment" - save_dir.mkdir(parents=True, exist_ok=True) - for l in dataset.labels: - texts = [] - lb_name = Path(l["im_file"]).with_suffix(".txt").name - txt_file = save_dir / lb_name - cls = l["cls"] - for i, s in enumerate(l["segments"]): - line = (int(cls[i]), *s.reshape(-1)) - texts.append(("%g " * len(line)).rstrip() % line) - if texts: - with open(txt_file, "a") as f: - f.writelines(text + "\n" for text in texts) - LOGGER.info(f"Generated segment labels saved in {save_dir}") diff --git a/ultralytics-main/ultralytics/data/dataset.py b/ultralytics-main/ultralytics/data/dataset.py deleted file mode 100644 index f358b9b..0000000 --- a/ultralytics-main/ultralytics/data/dataset.py +++ /dev/null @@ -1,382 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -import contextlib -from itertools import repeat -from multiprocessing.pool import ThreadPool -from pathlib import Path - -import cv2 -import numpy as np -import torch -import torchvision -from PIL import Image - -from ultralytics.utils import LOCAL_RANK, NUM_THREADS, TQDM, colorstr, is_dir_writeable -from ultralytics.utils.ops import resample_segments -from .augment import Compose, Format, Instances, LetterBox, classify_augmentations, classify_transforms, v8_transforms -from .base import BaseDataset -from .utils import HELP_URL, LOGGER, get_hash, img2label_paths, verify_image, verify_image_label - -# Ultralytics dataset *.cache version, >= 1.0.0 for YOLOv8 -DATASET_CACHE_VERSION = "1.0.3" - - -class YOLODataset(BaseDataset): - """ - Dataset class for loading object detection and/or segmentation labels in YOLO format. - - Args: - data (dict, optional): A dataset YAML dictionary. Defaults to None. - task (str): An explicit arg to point current task, Defaults to 'detect'. - - Returns: - (torch.utils.data.Dataset): A PyTorch dataset object that can be used for training an object detection model. - """ - - def __init__(self, *args, data=None, task="detect", **kwargs): - """Initializes the YOLODataset with optional configurations for segments and keypoints.""" - self.use_segments = task == "segment" - self.use_keypoints = task == "pose" - self.use_obb = task == "obb" - self.data = data - assert not (self.use_segments and self.use_keypoints), "Can not use both segments and keypoints." - super().__init__(*args, **kwargs) - - def cache_labels(self, path=Path("./labels.cache")): - """ - Cache dataset labels, check images and read shapes. - - Args: - path (Path): Path where to save the cache file. Default is Path('./labels.cache'). - - Returns: - (dict): labels. - """ - x = {"labels": []} - nm, nf, ne, nc, msgs = 0, 0, 0, 0, [] # number missing, found, empty, corrupt, messages - desc = f"{self.prefix}Scanning {path.parent / path.stem}..." - total = len(self.im_files) - nkpt, ndim = self.data.get("kpt_shape", (0, 0)) - if self.use_keypoints and (nkpt <= 0 or ndim not in (2, 3)): - raise ValueError( - "'kpt_shape' in data.yaml missing or incorrect. Should be a list with [number of " - "keypoints, number of dims (2 for x,y or 3 for x,y,visible)], i.e. 'kpt_shape: [17, 3]'" - ) - with ThreadPool(NUM_THREADS) as pool: - results = pool.imap( - func=verify_image_label, - iterable=zip( - self.im_files, - self.label_files, - repeat(self.prefix), - repeat(self.use_keypoints), - repeat(len(self.data["names"])), - repeat(nkpt), - repeat(ndim), - ), - ) - pbar = TQDM(results, desc=desc, total=total) - for im_file, lb, shape, segments, keypoint, nm_f, nf_f, ne_f, nc_f, msg in pbar: - nm += nm_f - nf += nf_f - ne += ne_f - nc += nc_f - if im_file: - x["labels"].append( - dict( - im_file=im_file, - shape=shape, - cls=lb[:, 0:1], # n, 1 - bboxes=lb[:, 1:], # n, 4 - segments=segments, - keypoints=keypoint, - normalized=True, - bbox_format="xywh", - ) - ) - if msg: - msgs.append(msg) - pbar.desc = f"{desc} {nf} images, {nm + ne} backgrounds, {nc} corrupt" - pbar.close() - - if msgs: - LOGGER.info("\n".join(msgs)) - if nf == 0: - LOGGER.warning(f"{self.prefix}WARNING ⚠️ No labels found in {path}. {HELP_URL}") - x["hash"] = get_hash(self.label_files + self.im_files) - x["results"] = nf, nm, ne, nc, len(self.im_files) - x["msgs"] = msgs # warnings - save_dataset_cache_file(self.prefix, path, x) - return x - - def get_labels(self): - """Returns dictionary of labels for YOLO training.""" - self.label_files = img2label_paths(self.im_files) - cache_path = Path(self.label_files[0]).parent.with_suffix(".cache") - try: - cache, exists = load_dataset_cache_file(cache_path), True # attempt to load a *.cache file - assert cache["version"] == DATASET_CACHE_VERSION # matches current version - assert cache["hash"] == get_hash(self.label_files + self.im_files) # identical hash - except (FileNotFoundError, AssertionError, AttributeError): - cache, exists = self.cache_labels(cache_path), False # run cache ops - - # Display cache - nf, nm, ne, nc, n = cache.pop("results") # found, missing, empty, corrupt, total - if exists and LOCAL_RANK in (-1, 0): - d = f"Scanning {cache_path}... {nf} images, {nm + ne} backgrounds, {nc} corrupt" - TQDM(None, desc=self.prefix + d, total=n, initial=n) # display results - if cache["msgs"]: - LOGGER.info("\n".join(cache["msgs"])) # display warnings - - # Read cache - [cache.pop(k) for k in ("hash", "version", "msgs")] # remove items - labels = cache["labels"] - if not labels: - LOGGER.warning(f"WARNING ⚠️ No images found in {cache_path}, training may not work correctly. {HELP_URL}") - self.im_files = [lb["im_file"] for lb in labels] # update im_files - - # Check if the dataset is all boxes or all segments - lengths = ((len(lb["cls"]), len(lb["bboxes"]), len(lb["segments"])) for lb in labels) - len_cls, len_boxes, len_segments = (sum(x) for x in zip(*lengths)) - if len_segments and len_boxes != len_segments: - LOGGER.warning( - f"WARNING ⚠️ Box and segment counts should be equal, but got len(segments) = {len_segments}, " - f"len(boxes) = {len_boxes}. To resolve this only boxes will be used and all segments will be removed. " - "To avoid this please supply either a detect or segment dataset, not a detect-segment mixed dataset." - ) - for lb in labels: - lb["segments"] = [] - if len_cls == 0: - LOGGER.warning(f"WARNING ⚠️ No labels found in {cache_path}, training may not work correctly. {HELP_URL}") - return labels - - def build_transforms(self, hyp=None): - """Builds and appends transforms to the list.""" - if self.augment: - hyp.mosaic = hyp.mosaic if self.augment and not self.rect else 0.0 - hyp.mixup = hyp.mixup if self.augment and not self.rect else 0.0 - transforms = v8_transforms(self, self.imgsz, hyp) - else: - transforms = Compose([LetterBox(new_shape=(self.imgsz, self.imgsz), scaleup=False)]) - transforms.append( - Format( - bbox_format="xywh", - normalize=True, - return_mask=self.use_segments, - return_keypoint=self.use_keypoints, - return_obb=self.use_obb, - batch_idx=True, - mask_ratio=hyp.mask_ratio, - mask_overlap=hyp.overlap_mask, - ) - ) - return transforms - - def close_mosaic(self, hyp): - """Sets mosaic, copy_paste and mixup options to 0.0 and builds transformations.""" - hyp.mosaic = 0.0 # set mosaic ratio=0.0 - hyp.copy_paste = 0.0 # keep the same behavior as previous v8 close-mosaic - hyp.mixup = 0.0 # keep the same behavior as previous v8 close-mosaic - self.transforms = self.build_transforms(hyp) - - def update_labels_info(self, label): - """ - Custom your label format here. - - Note: - cls is not with bboxes now, classification and semantic segmentation need an independent cls label - Can also support classification and semantic segmentation by adding or removing dict keys there. - """ - bboxes = label.pop("bboxes") - segments = label.pop("segments", []) - keypoints = label.pop("keypoints", None) - bbox_format = label.pop("bbox_format") - normalized = label.pop("normalized") - - # NOTE: do NOT resample oriented boxes - segment_resamples = 100 if self.use_obb else 1000 - if len(segments) > 0: - # list[np.array(1000, 2)] * num_samples - # (N, 1000, 2) - segments = np.stack(resample_segments(segments, n=segment_resamples), axis=0) - else: - segments = np.zeros((0, segment_resamples, 2), dtype=np.float32) - label["instances"] = Instances(bboxes, segments, keypoints, bbox_format=bbox_format, normalized=normalized) - return label - - @staticmethod - def collate_fn(batch): - """Collates data samples into batches.""" - new_batch = {} - keys = batch[0].keys() - values = list(zip(*[list(b.values()) for b in batch])) - for i, k in enumerate(keys): - value = values[i] - if k == "img": - value = torch.stack(value, 0) - if k in ["masks", "keypoints", "bboxes", "cls", "segments", "obb"]: - value = torch.cat(value, 0) - new_batch[k] = value - new_batch["batch_idx"] = list(new_batch["batch_idx"]) - for i in range(len(new_batch["batch_idx"])): - new_batch["batch_idx"][i] += i # add target image index for build_targets() - new_batch["batch_idx"] = torch.cat(new_batch["batch_idx"], 0) - return new_batch - - -# Classification dataloaders ------------------------------------------------------------------------------------------- -class ClassificationDataset(torchvision.datasets.ImageFolder): - """ - Extends torchvision ImageFolder to support YOLO classification tasks, offering functionalities like image - augmentation, caching, and verification. It's designed to efficiently handle large datasets for training deep - learning models, with optional image transformations and caching mechanisms to speed up training. - - This class allows for augmentations using both torchvision and Albumentations libraries, and supports caching images - in RAM or on disk to reduce IO overhead during training. Additionally, it implements a robust verification process - to ensure data integrity and consistency. - - Attributes: - cache_ram (bool): Indicates if caching in RAM is enabled. - cache_disk (bool): Indicates if caching on disk is enabled. - samples (list): A list of tuples, each containing the path to an image, its class index, path to its .npy cache - file (if caching on disk), and optionally the loaded image array (if caching in RAM). - torch_transforms (callable): PyTorch transforms to be applied to the images. - """ - - def __init__(self, root, args, augment=False, prefix=""): - """ - Initialize YOLO object with root, image size, augmentations, and cache settings. - - Args: - root (str): Path to the dataset directory where images are stored in a class-specific folder structure. - args (Namespace): Configuration containing dataset-related settings such as image size, augmentation - parameters, and cache settings. It includes attributes like `imgsz` (image size), `fraction` (fraction - of data to use), `scale`, `fliplr`, `flipud`, `cache` (disk or RAM caching for faster training), - `auto_augment`, `hsv_h`, `hsv_s`, `hsv_v`, and `crop_fraction`. - augment (bool, optional): Whether to apply augmentations to the dataset. Default is False. - prefix (str, optional): Prefix for logging and cache filenames, aiding in dataset identification and - debugging. Default is an empty string. - """ - super().__init__(root=root) - if augment and args.fraction < 1.0: # reduce training fraction - self.samples = self.samples[: round(len(self.samples) * args.fraction)] - self.prefix = colorstr(f"{prefix}: ") if prefix else "" - self.cache_ram = args.cache is True or args.cache == "ram" # cache images into RAM - self.cache_disk = args.cache == "disk" # cache images on hard drive as uncompressed *.npy files - self.samples = self.verify_images() # filter out bad images - self.samples = [list(x) + [Path(x[0]).with_suffix(".npy"), None] for x in self.samples] # file, index, npy, im - scale = (1.0 - args.scale, 1.0) # (0.08, 1.0) - self.torch_transforms = ( - classify_augmentations( - size=args.imgsz, - scale=scale, - hflip=args.fliplr, - vflip=args.flipud, - erasing=args.erasing, - auto_augment=args.auto_augment, - hsv_h=args.hsv_h, - hsv_s=args.hsv_s, - hsv_v=args.hsv_v, - ) - if augment - else classify_transforms(size=args.imgsz, crop_fraction=args.crop_fraction) - ) - - def __getitem__(self, i): - """Returns subset of data and targets corresponding to given indices.""" - f, j, fn, im = self.samples[i] # filename, index, filename.with_suffix('.npy'), image - if self.cache_ram and im is None: - im = self.samples[i][3] = cv2.imread(f) - elif self.cache_disk: - if not fn.exists(): # load npy - np.save(fn.as_posix(), cv2.imread(f), allow_pickle=False) - im = np.load(fn) - else: # read image - im = cv2.imread(f) # BGR - # Convert NumPy array to PIL image - im = Image.fromarray(cv2.cvtColor(im, cv2.COLOR_BGR2RGB)) - sample = self.torch_transforms(im) - return {"img": sample, "cls": j} - - def __len__(self) -> int: - """Return the total number of samples in the dataset.""" - return len(self.samples) - - def verify_images(self): - """Verify all images in dataset.""" - desc = f"{self.prefix}Scanning {self.root}..." - path = Path(self.root).with_suffix(".cache") # *.cache file path - - with contextlib.suppress(FileNotFoundError, AssertionError, AttributeError): - cache = load_dataset_cache_file(path) # attempt to load a *.cache file - assert cache["version"] == DATASET_CACHE_VERSION # matches current version - assert cache["hash"] == get_hash([x[0] for x in self.samples]) # identical hash - nf, nc, n, samples = cache.pop("results") # found, missing, empty, corrupt, total - if LOCAL_RANK in (-1, 0): - d = f"{desc} {nf} images, {nc} corrupt" - TQDM(None, desc=d, total=n, initial=n) - if cache["msgs"]: - LOGGER.info("\n".join(cache["msgs"])) # display warnings - return samples - - # Run scan if *.cache retrieval failed - nf, nc, msgs, samples, x = 0, 0, [], [], {} - with ThreadPool(NUM_THREADS) as pool: - results = pool.imap(func=verify_image, iterable=zip(self.samples, repeat(self.prefix))) - pbar = TQDM(results, desc=desc, total=len(self.samples)) - for sample, nf_f, nc_f, msg in pbar: - if nf_f: - samples.append(sample) - if msg: - msgs.append(msg) - nf += nf_f - nc += nc_f - pbar.desc = f"{desc} {nf} images, {nc} corrupt" - pbar.close() - if msgs: - LOGGER.info("\n".join(msgs)) - x["hash"] = get_hash([x[0] for x in self.samples]) - x["results"] = nf, nc, len(samples), samples - x["msgs"] = msgs # warnings - save_dataset_cache_file(self.prefix, path, x) - return samples - - -def load_dataset_cache_file(path): - """Load an Ultralytics *.cache dictionary from path.""" - import gc - - gc.disable() # reduce pickle load time https://github.com/ultralytics/ultralytics/pull/1585 - cache = np.load(str(path), allow_pickle=True).item() # load dict - gc.enable() - return cache - - -def save_dataset_cache_file(prefix, path, x): - """Save an Ultralytics dataset *.cache dictionary x to path.""" - x["version"] = DATASET_CACHE_VERSION # add cache version - if is_dir_writeable(path.parent): - if path.exists(): - path.unlink() # remove *.cache file if exists - np.save(str(path), x) # save cache for next time - path.with_suffix(".cache.npy").rename(path) # remove .npy suffix - LOGGER.info(f"{prefix}New cache created: {path}") - else: - LOGGER.warning(f"{prefix}WARNING ⚠️ Cache directory {path.parent} is not writeable, cache not saved.") - - -# TODO: support semantic segmentation -class SemanticDataset(BaseDataset): - """ - Semantic Segmentation Dataset. - - This class is responsible for handling datasets used for semantic segmentation tasks. It inherits functionalities - from the BaseDataset class. - - Note: - This class is currently a placeholder and needs to be populated with methods and attributes for supporting - semantic segmentation tasks. - """ - - def __init__(self): - """Initialize a SemanticDataset object.""" - super().__init__() diff --git a/ultralytics-main/ultralytics/data/explorer/__init__.py b/ultralytics-main/ultralytics/data/explorer/__init__.py deleted file mode 100644 index ce594dc..0000000 --- a/ultralytics-main/ultralytics/data/explorer/__init__.py +++ /dev/null @@ -1,5 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from .utils import plot_query_result - -__all__ = ["plot_query_result"] diff --git a/ultralytics-main/ultralytics/data/explorer/explorer.py b/ultralytics-main/ultralytics/data/explorer/explorer.py deleted file mode 100644 index d21a5c2..0000000 --- a/ultralytics-main/ultralytics/data/explorer/explorer.py +++ /dev/null @@ -1,472 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from io import BytesIO -from pathlib import Path -from typing import Any, List, Tuple, Union - -import cv2 -import numpy as np -import torch -from PIL import Image -from matplotlib import pyplot as plt -from pandas import DataFrame -from tqdm import tqdm - -from ultralytics.data.augment import Format -from ultralytics.data.dataset import YOLODataset -from ultralytics.data.utils import check_det_dataset -from ultralytics.models.yolo.model import YOLO -from ultralytics.utils import LOGGER, IterableSimpleNamespace, checks, USER_CONFIG_DIR -from .utils import get_sim_index_schema, get_table_schema, plot_query_result, prompt_sql_query, sanitize_batch - - -class ExplorerDataset(YOLODataset): - def __init__(self, *args, data: dict = None, **kwargs) -> None: - super().__init__(*args, data=data, **kwargs) - - def load_image(self, i: int) -> Union[Tuple[np.ndarray, Tuple[int, int], Tuple[int, int]], Tuple[None, None, None]]: - """Loads 1 image from dataset index 'i' without any resize ops.""" - im, f, fn = self.ims[i], self.im_files[i], self.npy_files[i] - if im is None: # not cached in RAM - if fn.exists(): # load npy - im = np.load(fn) - else: # read image - im = cv2.imread(f) # BGR - if im is None: - raise FileNotFoundError(f"Image Not Found {f}") - h0, w0 = im.shape[:2] # orig hw - return im, (h0, w0), im.shape[:2] - - return self.ims[i], self.im_hw0[i], self.im_hw[i] - - def build_transforms(self, hyp: IterableSimpleNamespace = None): - """Creates transforms for dataset images without resizing.""" - return Format( - bbox_format="xyxy", - normalize=False, - return_mask=self.use_segments, - return_keypoint=self.use_keypoints, - batch_idx=True, - mask_ratio=hyp.mask_ratio, - mask_overlap=hyp.overlap_mask, - ) - - -class Explorer: - def __init__( - self, - data: Union[str, Path] = "coco128.yaml", - model: str = "yolov8n.pt", - uri: str = USER_CONFIG_DIR / "explorer", - ) -> None: - # Note duckdb==0.10.0 bug https://github.com/ultralytics/ultralytics/pull/8181 - checks.check_requirements(["lancedb>=0.4.3", "duckdb<=0.9.2"]) - import lancedb - - self.connection = lancedb.connect(uri) - self.table_name = Path(data).name.lower() + "_" + model.lower() - self.sim_idx_base_name = ( - f"{self.table_name}_sim_idx".lower() - ) # Use this name and append thres and top_k to reuse the table - self.model = YOLO(model) - self.data = data # None - self.choice_set = None - - self.table = None - self.progress = 0 - - def create_embeddings_table(self, force: bool = False, split: str = "train") -> None: - """ - Create LanceDB table containing the embeddings of the images in the dataset. The table will be reused if it - already exists. Pass force=True to overwrite the existing table. - - Args: - force (bool): Whether to overwrite the existing table or not. Defaults to False. - split (str): Split of the dataset to use. Defaults to 'train'. - - Example: - ```python - exp = Explorer() - exp.create_embeddings_table() - ``` - """ - if self.table is not None and not force: - LOGGER.info("Table already exists. Reusing it. Pass force=True to overwrite it.") - return - if self.table_name in self.connection.table_names() and not force: - LOGGER.info(f"Table {self.table_name} already exists. Reusing it. Pass force=True to overwrite it.") - self.table = self.connection.open_table(self.table_name) - self.progress = 1 - return - if self.data is None: - raise ValueError("Data must be provided to create embeddings table") - - data_info = check_det_dataset(self.data) - if split not in data_info: - raise ValueError( - f"Split {split} is not found in the dataset. Available keys in the dataset are {list(data_info.keys())}" - ) - - choice_set = data_info[split] - choice_set = choice_set if isinstance(choice_set, list) else [choice_set] - self.choice_set = choice_set - dataset = ExplorerDataset(img_path=choice_set, data=data_info, augment=False, cache=False, task=self.model.task) - - # Create the table schema - batch = dataset[0] - vector_size = self.model.embed(batch["im_file"], verbose=False)[0].shape[0] - table = self.connection.create_table(self.table_name, schema=get_table_schema(vector_size), mode="overwrite") - table.add( - self._yield_batches( - dataset, - data_info, - self.model, - exclude_keys=["img", "ratio_pad", "resized_shape", "ori_shape", "batch_idx"], - ) - ) - - self.table = table - - def _yield_batches(self, dataset: ExplorerDataset, data_info: dict, model: YOLO, exclude_keys: List[str]): - """Generates batches of data for embedding, excluding specified keys.""" - for i in tqdm(range(len(dataset))): - self.progress = float(i + 1) / len(dataset) - batch = dataset[i] - for k in exclude_keys: - batch.pop(k, None) - batch = sanitize_batch(batch, data_info) - batch["vector"] = model.embed(batch["im_file"], verbose=False)[0].detach().tolist() - yield [batch] - - def query( - self, imgs: Union[str, np.ndarray, List[str], List[np.ndarray]] = None, limit: int = 25 - ) -> Any: # pyarrow.Table - """ - Query the table for similar images. Accepts a single image or a list of images. - - Args: - imgs (str or list): Path to the image or a list of paths to the images. - limit (int): Number of results to return. - - Returns: - (pyarrow.Table): An arrow table containing the results. Supports converting to: - - pandas dataframe: `result.to_pandas()` - - dict of lists: `result.to_pydict()` - - Example: - ```python - exp = Explorer() - exp.create_embeddings_table() - similar = exp.query(img='https://ultralytics.com/images/zidane.jpg') - ``` - """ - if self.table is None: - raise ValueError("Table is not created. Please create the table first.") - if isinstance(imgs, str): - imgs = [imgs] - assert isinstance(imgs, list), f"img must be a string or a list of strings. Got {type(imgs)}" - embeds = self.model.embed(imgs) - # Get avg if multiple images are passed (len > 1) - embeds = torch.mean(torch.stack(embeds), 0).cpu().numpy() if len(embeds) > 1 else embeds[0].cpu().numpy() - return self.table.search(embeds).limit(limit).to_arrow() - - def sql_query( - self, query: str, return_type: str = "pandas" - ) -> Union[DataFrame, Any, None]: # pandas.dataframe or pyarrow.Table - """ - Run a SQL-Like query on the table. Utilizes LanceDB predicate pushdown. - - Args: - query (str): SQL query to run. - return_type (str): Type of the result to return. Can be either 'pandas' or 'arrow'. Defaults to 'pandas'. - - Returns: - (pyarrow.Table): An arrow table containing the results. - - Example: - ```python - exp = Explorer() - exp.create_embeddings_table() - query = "SELECT * FROM 'table' WHERE labels LIKE '%person%'" - result = exp.sql_query(query) - ``` - """ - assert return_type in { - "pandas", - "arrow", - }, f"Return type should be either `pandas` or `arrow`, but got {return_type}" - import duckdb - - if self.table is None: - raise ValueError("Table is not created. Please create the table first.") - - # Note: using filter pushdown would be a better long term solution. Temporarily using duckdb for this. - table = self.table.to_arrow() # noqa NOTE: Don't comment this. This line is used by DuckDB - if not query.startswith("SELECT") and not query.startswith("WHERE"): - raise ValueError( - f"Query must start with SELECT or WHERE. You can either pass the entire query or just the WHERE clause. found {query}" - ) - if query.startswith("WHERE"): - query = f"SELECT * FROM 'table' {query}" - LOGGER.info(f"Running query: {query}") - - rs = duckdb.sql(query) - if return_type == "arrow": - return rs.arrow() - elif return_type == "pandas": - return rs.df() - - def plot_sql_query(self, query: str, labels: bool = True) -> Image.Image: - """ - Plot the results of a SQL-Like query on the table. - Args: - query (str): SQL query to run. - labels (bool): Whether to plot the labels or not. - - Returns: - (PIL.Image): Image containing the plot. - - Example: - ```python - exp = Explorer() - exp.create_embeddings_table() - query = "SELECT * FROM 'table' WHERE labels LIKE '%person%'" - result = exp.plot_sql_query(query) - ``` - """ - result = self.sql_query(query, return_type="arrow") - if len(result) == 0: - LOGGER.info("No results found.") - return None - img = plot_query_result(result, plot_labels=labels) - return Image.fromarray(img) - - def get_similar( - self, - img: Union[str, np.ndarray, List[str], List[np.ndarray]] = None, - idx: Union[int, List[int]] = None, - limit: int = 25, - return_type: str = "pandas", - ) -> Union[DataFrame, Any]: # pandas.dataframe or pyarrow.Table - """ - Query the table for similar images. Accepts a single image or a list of images. - - Args: - img (str or list): Path to the image or a list of paths to the images. - idx (int or list): Index of the image in the table or a list of indexes. - limit (int): Number of results to return. Defaults to 25. - return_type (str): Type of the result to return. Can be either 'pandas' or 'arrow'. Defaults to 'pandas'. - - Returns: - (pandas.DataFrame): A dataframe containing the results. - - Example: - ```python - exp = Explorer() - exp.create_embeddings_table() - similar = exp.get_similar(img='https://ultralytics.com/images/zidane.jpg') - ``` - """ - assert return_type in { - "pandas", - "arrow", - }, f"Return type should be either `pandas` or `arrow`, but got {return_type}" - img = self._check_imgs_or_idxs(img, idx) - similar = self.query(img, limit=limit) - - if return_type == "arrow": - return similar - elif return_type == "pandas": - return similar.to_pandas() - - def plot_similar( - self, - img: Union[str, np.ndarray, List[str], List[np.ndarray]] = None, - idx: Union[int, List[int]] = None, - limit: int = 25, - labels: bool = True, - ) -> Image.Image: - """ - Plot the similar images. Accepts images or indexes. - - Args: - img (str or list): Path to the image or a list of paths to the images. - idx (int or list): Index of the image in the table or a list of indexes. - labels (bool): Whether to plot the labels or not. - limit (int): Number of results to return. Defaults to 25. - - Returns: - (PIL.Image): Image containing the plot. - - Example: - ```python - exp = Explorer() - exp.create_embeddings_table() - similar = exp.plot_similar(img='https://ultralytics.com/images/zidane.jpg') - ``` - """ - similar = self.get_similar(img, idx, limit, return_type="arrow") - if len(similar) == 0: - LOGGER.info("No results found.") - return None - img = plot_query_result(similar, plot_labels=labels) - return Image.fromarray(img) - - def similarity_index(self, max_dist: float = 0.2, top_k: float = None, force: bool = False) -> DataFrame: - """ - Calculate the similarity index of all the images in the table. Here, the index will contain the data points that - are max_dist or closer to the image in the embedding space at a given index. - - Args: - max_dist (float): maximum L2 distance between the embeddings to consider. Defaults to 0.2. - top_k (float): Percentage of the closest data points to consider when counting. Used to apply limit when running - vector search. Defaults: None. - force (bool): Whether to overwrite the existing similarity index or not. Defaults to True. - - Returns: - (pandas.DataFrame): A dataframe containing the similarity index. Each row corresponds to an image, and columns - include indices of similar images and their respective distances. - - Example: - ```python - exp = Explorer() - exp.create_embeddings_table() - sim_idx = exp.similarity_index() - ``` - """ - if self.table is None: - raise ValueError("Table is not created. Please create the table first.") - sim_idx_table_name = f"{self.sim_idx_base_name}_thres_{max_dist}_top_{top_k}".lower() - if sim_idx_table_name in self.connection.table_names() and not force: - LOGGER.info("Similarity matrix already exists. Reusing it. Pass force=True to overwrite it.") - return self.connection.open_table(sim_idx_table_name).to_pandas() - - if top_k and not (1.0 >= top_k >= 0.0): - raise ValueError(f"top_k must be between 0.0 and 1.0. Got {top_k}") - if max_dist < 0.0: - raise ValueError(f"max_dist must be greater than 0. Got {max_dist}") - - top_k = int(top_k * len(self.table)) if top_k else len(self.table) - top_k = max(top_k, 1) - features = self.table.to_lance().to_table(columns=["vector", "im_file"]).to_pydict() - im_files = features["im_file"] - embeddings = features["vector"] - - sim_table = self.connection.create_table(sim_idx_table_name, schema=get_sim_index_schema(), mode="overwrite") - - def _yield_sim_idx(): - """Generates a dataframe with similarity indices and distances for images.""" - for i in tqdm(range(len(embeddings))): - sim_idx = self.table.search(embeddings[i]).limit(top_k).to_pandas().query(f"_distance <= {max_dist}") - yield [ - { - "idx": i, - "im_file": im_files[i], - "count": len(sim_idx), - "sim_im_files": sim_idx["im_file"].tolist(), - } - ] - - sim_table.add(_yield_sim_idx()) - self.sim_index = sim_table - return sim_table.to_pandas() - - def plot_similarity_index(self, max_dist: float = 0.2, top_k: float = None, force: bool = False) -> Image: - """ - Plot the similarity index of all the images in the table. Here, the index will contain the data points that are - max_dist or closer to the image in the embedding space at a given index. - - Args: - max_dist (float): maximum L2 distance between the embeddings to consider. Defaults to 0.2. - top_k (float): Percentage of closest data points to consider when counting. Used to apply limit when - running vector search. Defaults to 0.01. - force (bool): Whether to overwrite the existing similarity index or not. Defaults to True. - - Returns: - (PIL.Image): Image containing the plot. - - Example: - ```python - exp = Explorer() - exp.create_embeddings_table() - - similarity_idx_plot = exp.plot_similarity_index() - similarity_idx_plot.show() # view image preview - similarity_idx_plot.save('path/to/save/similarity_index_plot.png') # save contents to file - ``` - """ - sim_idx = self.similarity_index(max_dist=max_dist, top_k=top_k, force=force) - sim_count = sim_idx["count"].tolist() - sim_count = np.array(sim_count) - - indices = np.arange(len(sim_count)) - - # Create the bar plot - plt.bar(indices, sim_count) - - # Customize the plot (optional) - plt.xlabel("data idx") - plt.ylabel("Count") - plt.title("Similarity Count") - buffer = BytesIO() - plt.savefig(buffer, format="png") - buffer.seek(0) - - # Use Pillow to open the image from the buffer - return Image.fromarray(np.array(Image.open(buffer))) - - def _check_imgs_or_idxs( - self, img: Union[str, np.ndarray, List[str], List[np.ndarray], None], idx: Union[None, int, List[int]] - ) -> List[np.ndarray]: - if img is None and idx is None: - raise ValueError("Either img or idx must be provided.") - if img is not None and idx is not None: - raise ValueError("Only one of img or idx must be provided.") - if idx is not None: - idx = idx if isinstance(idx, list) else [idx] - img = self.table.to_lance().take(idx, columns=["im_file"]).to_pydict()["im_file"] - - return img if isinstance(img, list) else [img] - - def ask_ai(self, query): - """ - Ask AI a question. - - Args: - query (str): Question to ask. - - Returns: - (pandas.DataFrame): A dataframe containing filtered results to the SQL query. - - Example: - ```python - exp = Explorer() - exp.create_embeddings_table() - answer = exp.ask_ai('Show images with 1 person and 2 dogs') - ``` - """ - result = prompt_sql_query(query) - try: - df = self.sql_query(result) - except Exception as e: - LOGGER.error("AI generated query is not valid. Please try again with a different prompt") - LOGGER.error(e) - return None - return df - - def visualize(self, result): - """ - Visualize the results of a query. TODO. - - Args: - result (pyarrow.Table): Table containing the results of a query. - """ - pass - - def generate_report(self, result): - """ - Generate a report of the dataset. - - TODO - """ - pass diff --git a/ultralytics-main/ultralytics/data/explorer/gui/__init__.py b/ultralytics-main/ultralytics/data/explorer/gui/__init__.py deleted file mode 100644 index 9e68dc1..0000000 --- a/ultralytics-main/ultralytics/data/explorer/gui/__init__.py +++ /dev/null @@ -1 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license diff --git a/ultralytics-main/ultralytics/data/explorer/gui/dash.py b/ultralytics-main/ultralytics/data/explorer/gui/dash.py deleted file mode 100644 index b082d49..0000000 --- a/ultralytics-main/ultralytics/data/explorer/gui/dash.py +++ /dev/null @@ -1,268 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import time -from threading import Thread - -import pandas as pd - -from ultralytics import Explorer -from ultralytics.utils import ROOT, SETTINGS -from ultralytics.utils.checks import check_requirements - -check_requirements(("streamlit>=1.29.0", "streamlit-select>=0.3")) - -import streamlit as st -from streamlit_select import image_select - - -def _get_explorer(): - """Initializes and returns an instance of the Explorer class.""" - exp = Explorer(data=st.session_state.get("dataset"), model=st.session_state.get("model")) - thread = Thread( - target=exp.create_embeddings_table, kwargs={"force": st.session_state.get("force_recreate_embeddings")} - ) - thread.start() - progress_bar = st.progress(0, text="Creating embeddings table...") - while exp.progress < 1: - time.sleep(0.1) - progress_bar.progress(exp.progress, text=f"Progress: {exp.progress * 100}%") - thread.join() - st.session_state["explorer"] = exp - progress_bar.empty() - - -def init_explorer_form(): - """Initializes an Explorer instance and creates embeddings table with progress tracking.""" - datasets = ROOT / "cfg" / "datasets" - ds = [d.name for d in datasets.glob("*.yaml")] - models = [ - "yolov8n.pt", - "yolov8s.pt", - "yolov8m.pt", - "yolov8l.pt", - "yolov8x.pt", - "yolov8n-seg.pt", - "yolov8s-seg.pt", - "yolov8m-seg.pt", - "yolov8l-seg.pt", - "yolov8x-seg.pt", - "yolov8n-pose.pt", - "yolov8s-pose.pt", - "yolov8m-pose.pt", - "yolov8l-pose.pt", - "yolov8x-pose.pt", - ] - with st.form(key="explorer_init_form"): - col1, col2 = st.columns(2) - with col1: - st.selectbox("Select dataset", ds, key="dataset", index=ds.index("coco128.yaml")) - with col2: - st.selectbox("Select model", models, key="model") - st.checkbox("Force recreate embeddings", key="force_recreate_embeddings") - - st.form_submit_button("Explore", on_click=_get_explorer) - - -def query_form(): - """Sets up a form in Streamlit to initialize Explorer with dataset and model selection.""" - with st.form("query_form"): - col1, col2 = st.columns([0.8, 0.2]) - with col1: - st.text_input( - "Query", - "WHERE labels LIKE '%person%' AND labels LIKE '%dog%'", - label_visibility="collapsed", - key="query", - ) - with col2: - st.form_submit_button("Query", on_click=run_sql_query) - - -def ai_query_form(): - """Sets up a Streamlit form for user input to initialize Explorer with dataset and model selection.""" - with st.form("ai_query_form"): - col1, col2 = st.columns([0.8, 0.2]) - with col1: - st.text_input("Query", "Show images with 1 person and 1 dog", label_visibility="collapsed", key="ai_query") - with col2: - st.form_submit_button("Ask AI", on_click=run_ai_query) - - -def find_similar_imgs(imgs): - """Initializes a Streamlit form for AI-based image querying with custom input.""" - exp = st.session_state["explorer"] - similar = exp.get_similar(img=imgs, limit=st.session_state.get("limit"), return_type="arrow") - paths = similar.to_pydict()["im_file"] - st.session_state["imgs"] = paths - st.session_state["res"] = similar - - -def similarity_form(selected_imgs): - """Initializes a form for AI-based image querying with custom input in Streamlit.""" - st.write("Similarity Search") - with st.form("similarity_form"): - subcol1, subcol2 = st.columns([1, 1]) - with subcol1: - st.number_input( - "limit", min_value=None, max_value=None, value=25, label_visibility="collapsed", key="limit" - ) - - with subcol2: - disabled = not len(selected_imgs) - st.write("Selected: ", len(selected_imgs)) - st.form_submit_button( - "Search", - disabled=disabled, - on_click=find_similar_imgs, - args=(selected_imgs,), - ) - if disabled: - st.error("Select at least one image to search.") - - -# def persist_reset_form(): -# with st.form("persist_reset"): -# col1, col2 = st.columns([1, 1]) -# with col1: -# st.form_submit_button("Reset", on_click=reset) -# -# with col2: -# st.form_submit_button("Persist", on_click=update_state, args=("PERSISTING", True)) - - -def run_sql_query(): - """Executes an SQL query and returns the results.""" - st.session_state["error"] = None - query = st.session_state.get("query") - if query.rstrip().lstrip(): - exp = st.session_state["explorer"] - res = exp.sql_query(query, return_type="arrow") - st.session_state["imgs"] = res.to_pydict()["im_file"] - st.session_state["res"] = res - - -def run_ai_query(): - """Execute SQL query and update session state with query results.""" - if not SETTINGS["openai_api_key"]: - st.session_state["error"] = ( - 'OpenAI API key not found in settings. Please run yolo settings openai_api_key="..."' - ) - return - st.session_state["error"] = None - query = st.session_state.get("ai_query") - if query.rstrip().lstrip(): - exp = st.session_state["explorer"] - res = exp.ask_ai(query) - if not isinstance(res, pd.DataFrame) or res.empty: - st.session_state["error"] = "No results found using AI generated query. Try another query or rerun it." - return - st.session_state["imgs"] = res["im_file"].to_list() - st.session_state["res"] = res - - -def reset_explorer(): - """Resets the explorer to its initial state by clearing session variables.""" - st.session_state["explorer"] = None - st.session_state["imgs"] = None - st.session_state["error"] = None - - -def utralytics_explorer_docs_callback(): - """Resets the explorer to its initial state by clearing session variables.""" - with st.container(border=True): - st.image( - "https://raw.githubusercontent.com/ultralytics/assets/main/logo/Ultralytics_Logotype_Original.svg", - width=100, - ) - st.markdown( - "

This demo is built using Ultralytics Explorer API. Visit API docs to try examples & learn more

", - unsafe_allow_html=True, - help=None, - ) - st.link_button("Ultrlaytics Explorer API", "https://docs.ultralytics.com/datasets/explorer/") - - -def layout(): - """Resets explorer session variables and provides documentation with a link to API docs.""" - st.set_page_config(layout="wide", initial_sidebar_state="collapsed") - st.markdown("

Ultralytics Explorer Demo

", unsafe_allow_html=True) - - if st.session_state.get("explorer") is None: - init_explorer_form() - return - - st.button(":arrow_backward: Select Dataset", on_click=reset_explorer) - exp = st.session_state.get("explorer") - col1, col2 = st.columns([0.75, 0.25], gap="small") - imgs = [] - if st.session_state.get("error"): - st.error(st.session_state["error"]) - else: - if st.session_state.get("imgs"): - imgs = st.session_state.get("imgs") - else: - imgs = exp.table.to_lance().to_table(columns=["im_file"]).to_pydict()["im_file"] - st.session_state["res"] = exp.table.to_arrow() - total_imgs, selected_imgs = len(imgs), [] - with col1: - subcol1, subcol2, subcol3, subcol4, subcol5 = st.columns(5) - with subcol1: - st.write("Max Images Displayed:") - with subcol2: - num = st.number_input( - "Max Images Displayed", - min_value=0, - max_value=total_imgs, - value=min(500, total_imgs), - key="num_imgs_displayed", - label_visibility="collapsed", - ) - with subcol3: - st.write("Start Index:") - with subcol4: - start_idx = st.number_input( - "Start Index", - min_value=0, - max_value=total_imgs, - value=0, - key="start_index", - label_visibility="collapsed", - ) - with subcol5: - reset = st.button("Reset", use_container_width=False, key="reset") - if reset: - st.session_state["imgs"] = None - st.experimental_rerun() - - query_form() - ai_query_form() - if total_imgs: - labels, boxes, masks, kpts, classes = None, None, None, None, None - task = exp.model.task - if st.session_state.get("display_labels"): - labels = st.session_state.get("res").to_pydict()["labels"][start_idx : start_idx + num] - boxes = st.session_state.get("res").to_pydict()["bboxes"][start_idx : start_idx + num] - masks = st.session_state.get("res").to_pydict()["masks"][start_idx : start_idx + num] - kpts = st.session_state.get("res").to_pydict()["keypoints"][start_idx : start_idx + num] - classes = st.session_state.get("res").to_pydict()["cls"][start_idx : start_idx + num] - imgs_displayed = imgs[start_idx : start_idx + num] - selected_imgs = image_select( - f"Total samples: {total_imgs}", - images=imgs_displayed, - use_container_width=False, - # indices=[i for i in range(num)] if select_all else None, - labels=labels, - classes=classes, - bboxes=boxes, - masks=masks if task == "segment" else None, - kpts=kpts if task == "pose" else None, - ) - - with col2: - similarity_form(selected_imgs) - display_labels = st.checkbox("Labels", value=False, key="display_labels") - utralytics_explorer_docs_callback() - - -if __name__ == "__main__": - layout() diff --git a/ultralytics-main/ultralytics/data/explorer/utils.py b/ultralytics-main/ultralytics/data/explorer/utils.py deleted file mode 100644 index d1c4b9b..0000000 --- a/ultralytics-main/ultralytics/data/explorer/utils.py +++ /dev/null @@ -1,166 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import getpass -from typing import List - -import cv2 -import numpy as np -import pandas as pd - -from ultralytics.data.augment import LetterBox -from ultralytics.utils import LOGGER as logger -from ultralytics.utils import SETTINGS -from ultralytics.utils.checks import check_requirements -from ultralytics.utils.ops import xyxy2xywh -from ultralytics.utils.plotting import plot_images - - -def get_table_schema(vector_size): - """Extracts and returns the schema of a database table.""" - from lancedb.pydantic import LanceModel, Vector - - class Schema(LanceModel): - im_file: str - labels: List[str] - cls: List[int] - bboxes: List[List[float]] - masks: List[List[List[int]]] - keypoints: List[List[List[float]]] - vector: Vector(vector_size) - - return Schema - - -def get_sim_index_schema(): - """Returns a LanceModel schema for a database table with specified vector size.""" - from lancedb.pydantic import LanceModel - - class Schema(LanceModel): - idx: int - im_file: str - count: int - sim_im_files: List[str] - - return Schema - - -def sanitize_batch(batch, dataset_info): - """Sanitizes input batch for inference, ensuring correct format and dimensions.""" - batch["cls"] = batch["cls"].flatten().int().tolist() - box_cls_pair = sorted(zip(batch["bboxes"].tolist(), batch["cls"]), key=lambda x: x[1]) - batch["bboxes"] = [box for box, _ in box_cls_pair] - batch["cls"] = [cls for _, cls in box_cls_pair] - batch["labels"] = [dataset_info["names"][i] for i in batch["cls"]] - batch["masks"] = batch["masks"].tolist() if "masks" in batch else [[[]]] - batch["keypoints"] = batch["keypoints"].tolist() if "keypoints" in batch else [[[]]] - return batch - - -def plot_query_result(similar_set, plot_labels=True): - """ - Plot images from the similar set. - - Args: - similar_set (list): Pyarrow or pandas object containing the similar data points - plot_labels (bool): Whether to plot labels or not - """ - similar_set = ( - similar_set.to_dict(orient="list") if isinstance(similar_set, pd.DataFrame) else similar_set.to_pydict() - ) - empty_masks = [[[]]] - empty_boxes = [[]] - images = similar_set.get("im_file", []) - bboxes = similar_set.get("bboxes", []) if similar_set.get("bboxes") is not empty_boxes else [] - masks = similar_set.get("masks") if similar_set.get("masks")[0] != empty_masks else [] - kpts = similar_set.get("keypoints") if similar_set.get("keypoints")[0] != empty_masks else [] - cls = similar_set.get("cls", []) - - plot_size = 640 - imgs, batch_idx, plot_boxes, plot_masks, plot_kpts = [], [], [], [], [] - for i, imf in enumerate(images): - im = cv2.imread(imf) - im = cv2.cvtColor(im, cv2.COLOR_BGR2RGB) - h, w = im.shape[:2] - r = min(plot_size / h, plot_size / w) - imgs.append(LetterBox(plot_size, center=False)(image=im).transpose(2, 0, 1)) - if plot_labels: - if len(bboxes) > i and len(bboxes[i]) > 0: - box = np.array(bboxes[i], dtype=np.float32) - box[:, [0, 2]] *= r - box[:, [1, 3]] *= r - plot_boxes.append(box) - if len(masks) > i and len(masks[i]) > 0: - mask = np.array(masks[i], dtype=np.uint8)[0] - plot_masks.append(LetterBox(plot_size, center=False)(image=mask)) - if len(kpts) > i and kpts[i] is not None: - kpt = np.array(kpts[i], dtype=np.float32) - kpt[:, :, :2] *= r - plot_kpts.append(kpt) - batch_idx.append(np.ones(len(np.array(bboxes[i], dtype=np.float32))) * i) - imgs = np.stack(imgs, axis=0) - masks = np.stack(plot_masks, axis=0) if plot_masks else np.zeros(0, dtype=np.uint8) - kpts = np.concatenate(plot_kpts, axis=0) if plot_kpts else np.zeros((0, 51), dtype=np.float32) - boxes = xyxy2xywh(np.concatenate(plot_boxes, axis=0)) if plot_boxes else np.zeros(0, dtype=np.float32) - batch_idx = np.concatenate(batch_idx, axis=0) - cls = np.concatenate([np.array(c, dtype=np.int32) for c in cls], axis=0) - - return plot_images( - imgs, batch_idx, cls, bboxes=boxes, masks=masks, kpts=kpts, max_subplots=len(images), save=False, threaded=False - ) - - -def prompt_sql_query(query): - """Plots images with optional labels from a similar data set.""" - check_requirements("openai>=1.6.1") - from openai import OpenAI - - if not SETTINGS["openai_api_key"]: - logger.warning("OpenAI API key not found in settings. Please enter your API key below.") - openai_api_key = getpass.getpass("OpenAI API key: ") - SETTINGS.update({"openai_api_key": openai_api_key}) - openai = OpenAI(api_key=SETTINGS["openai_api_key"]) - - messages = [ - { - "role": "system", - "content": """ - You are a helpful data scientist proficient in SQL. You need to output exactly one SQL query based on - the following schema and a user request. You only need to output the format with fixed selection - statement that selects everything from "'table'", like `SELECT * from 'table'` - - Schema: - im_file: string not null - labels: list not null - child 0, item: string - cls: list not null - child 0, item: int64 - bboxes: list> not null - child 0, item: list - child 0, item: double - masks: list>> not null - child 0, item: list> - child 0, item: list - child 0, item: int64 - keypoints: list>> not null - child 0, item: list> - child 0, item: list - child 0, item: double - vector: fixed_size_list[256] not null - child 0, item: float - - Some details about the schema: - - the "labels" column contains the string values like 'person' and 'dog' for the respective objects - in each image - - the "cls" column contains the integer values on these classes that map them the labels - - Example of a correct query: - request - Get all data points that contain 2 or more people and at least one dog - correct query- - SELECT * FROM 'table' WHERE ARRAY_LENGTH(cls) >= 2 AND ARRAY_LENGTH(FILTER(labels, x -> x = 'person')) >= 2 AND ARRAY_LENGTH(FILTER(labels, x -> x = 'dog')) >= 1; - """, - }, - {"role": "user", "content": f"{query}"}, - ] - - response = openai.chat.completions.create(model="gpt-3.5-turbo", messages=messages) - return response.choices[0].message.content diff --git a/ultralytics-main/ultralytics/data/loaders.py b/ultralytics-main/ultralytics/data/loaders.py deleted file mode 100644 index 4b89770..0000000 --- a/ultralytics-main/ultralytics/data/loaders.py +++ /dev/null @@ -1,555 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import glob -import math -import os -import time -from dataclasses import dataclass -from pathlib import Path -from threading import Thread -from urllib.parse import urlparse - -import cv2 -import numpy as np -import requests -import torch -from PIL import Image - -from ultralytics.data.utils import IMG_FORMATS, VID_FORMATS -from ultralytics.utils import LOGGER, is_colab, is_kaggle, ops -from ultralytics.utils.checks import check_requirements - - -@dataclass -class SourceTypes: - """Class to represent various types of input sources for predictions.""" - - stream: bool = False - screenshot: bool = False - from_img: bool = False - tensor: bool = False - - -class LoadStreams: - """ - Stream Loader for various types of video streams, Supports RTSP, RTMP, HTTP, and TCP streams. - - Attributes: - sources (str): The source input paths or URLs for the video streams. - vid_stride (int): Video frame-rate stride, defaults to 1. - buffer (bool): Whether to buffer input streams, defaults to False. - running (bool): Flag to indicate if the streaming thread is running. - mode (str): Set to 'stream' indicating real-time capture. - imgs (list): List of image frames for each stream. - fps (list): List of FPS for each stream. - frames (list): List of total frames for each stream. - threads (list): List of threads for each stream. - shape (list): List of shapes for each stream. - caps (list): List of cv2.VideoCapture objects for each stream. - bs (int): Batch size for processing. - - Methods: - __init__: Initialize the stream loader. - update: Read stream frames in daemon thread. - close: Close stream loader and release resources. - __iter__: Returns an iterator object for the class. - __next__: Returns source paths, transformed, and original images for processing. - __len__: Return the length of the sources object. - - Example: - ```bash - yolo predict source='rtsp://example.com/media.mp4' - ``` - """ - - def __init__(self, sources="file.streams", vid_stride=1, buffer=False): - """Initialize instance variables and check for consistent input stream shapes.""" - torch.backends.cudnn.benchmark = True # faster for fixed-size inference - self.buffer = buffer # buffer input streams - self.running = True # running flag for Thread - self.mode = "stream" - self.vid_stride = vid_stride # video frame-rate stride - - sources = Path(sources).read_text().rsplit() if os.path.isfile(sources) else [sources] - n = len(sources) - self.bs = n - self.fps = [0] * n # frames per second - self.frames = [0] * n - self.threads = [None] * n - self.caps = [None] * n # video capture objects - self.imgs = [[] for _ in range(n)] # images - self.shape = [[] for _ in range(n)] # image shapes - self.sources = [ops.clean_str(x) for x in sources] # clean source names for later - for i, s in enumerate(sources): # index, source - # Start thread to read frames from video stream - st = f"{i + 1}/{n}: {s}... " - if urlparse(s).hostname in ("www.youtube.com", "youtube.com", "youtu.be"): # if source is YouTube video - # YouTube format i.e. 'https://www.youtube.com/watch?v=Zgi9g1ksQHc' or 'https://youtu.be/LNwODJXcvt4' - s = get_best_youtube_url(s) - s = eval(s) if s.isnumeric() else s # i.e. s = '0' local webcam - if s == 0 and (is_colab() or is_kaggle()): - raise NotImplementedError( - "'source=0' webcam not supported in Colab and Kaggle notebooks. " - "Try running 'source=0' in a local environment." - ) - self.caps[i] = cv2.VideoCapture(s) # store video capture object - if not self.caps[i].isOpened(): - raise ConnectionError(f"{st}Failed to open {s}") - w = int(self.caps[i].get(cv2.CAP_PROP_FRAME_WIDTH)) - h = int(self.caps[i].get(cv2.CAP_PROP_FRAME_HEIGHT)) - fps = self.caps[i].get(cv2.CAP_PROP_FPS) # warning: may return 0 or nan - self.frames[i] = max(int(self.caps[i].get(cv2.CAP_PROP_FRAME_COUNT)), 0) or float( - "inf" - ) # infinite stream fallback - self.fps[i] = max((fps if math.isfinite(fps) else 0) % 100, 0) or 30 # 30 FPS fallback - - success, im = self.caps[i].read() # guarantee first frame - if not success or im is None: - raise ConnectionError(f"{st}Failed to read images from {s}") - self.imgs[i].append(im) - self.shape[i] = im.shape - self.threads[i] = Thread(target=self.update, args=([i, self.caps[i], s]), daemon=True) - LOGGER.info(f"{st}Success ✅ ({self.frames[i]} frames of shape {w}x{h} at {self.fps[i]:.2f} FPS)") - self.threads[i].start() - LOGGER.info("") # newline - - def update(self, i, cap, stream): - """Read stream `i` frames in daemon thread.""" - n, f = 0, self.frames[i] # frame number, frame array - while self.running and cap.isOpened() and n < (f - 1): - if len(self.imgs[i]) < 30: # keep a <=30-image buffer - n += 1 - cap.grab() # .read() = .grab() followed by .retrieve() - if n % self.vid_stride == 0: - success, im = cap.retrieve() - if not success: - im = np.zeros(self.shape[i], dtype=np.uint8) - LOGGER.warning("WARNING ⚠️ Video stream unresponsive, please check your IP camera connection.") - cap.open(stream) # re-open stream if signal was lost - if self.buffer: - self.imgs[i].append(im) - else: - self.imgs[i] = [im] - else: - time.sleep(0.01) # wait until the buffer is empty - - def close(self): - """Close stream loader and release resources.""" - self.running = False # stop flag for Thread - for thread in self.threads: - if thread.is_alive(): - thread.join(timeout=5) # Add timeout - for cap in self.caps: # Iterate through the stored VideoCapture objects - try: - cap.release() # release video capture - except Exception as e: - LOGGER.warning(f"WARNING ⚠️ Could not release VideoCapture object: {e}") - cv2.destroyAllWindows() - - def __iter__(self): - """Iterates through YOLO image feed and re-opens unresponsive streams.""" - self.count = -1 - return self - - def __next__(self): - """Returns source paths, transformed and original images for processing.""" - self.count += 1 - - images = [] - for i, x in enumerate(self.imgs): - # Wait until a frame is available in each buffer - while not x: - if not self.threads[i].is_alive() or cv2.waitKey(1) == ord("q"): # q to quit - self.close() - raise StopIteration - time.sleep(1 / min(self.fps)) - x = self.imgs[i] - if not x: - LOGGER.warning(f"WARNING ⚠️ Waiting for stream {i}") - - # Get and remove the first frame from imgs buffer - if self.buffer: - images.append(x.pop(0)) - - # Get the last frame, and clear the rest from the imgs buffer - else: - images.append(x.pop(-1) if x else np.zeros(self.shape[i], dtype=np.uint8)) - x.clear() - - return self.sources, images, [""] * self.bs - - def __len__(self): - """Return the length of the sources object.""" - return self.bs # 1E12 frames = 32 streams at 30 FPS for 30 years - - -class LoadScreenshots: - """ - YOLOv8 screenshot dataloader. - - This class manages the loading of screenshot images for processing with YOLOv8. - Suitable for use with `yolo predict source=screen`. - - Attributes: - source (str): The source input indicating which screen to capture. - screen (int): The screen number to capture. - left (int): The left coordinate for screen capture area. - top (int): The top coordinate for screen capture area. - width (int): The width of the screen capture area. - height (int): The height of the screen capture area. - mode (str): Set to 'stream' indicating real-time capture. - frame (int): Counter for captured frames. - sct (mss.mss): Screen capture object from `mss` library. - bs (int): Batch size, set to 1. - monitor (dict): Monitor configuration details. - - Methods: - __iter__: Returns an iterator object. - __next__: Captures the next screenshot and returns it. - """ - - def __init__(self, source): - """Source = [screen_number left top width height] (pixels).""" - check_requirements("mss") - import mss # noqa - - source, *params = source.split() - self.screen, left, top, width, height = 0, None, None, None, None # default to full screen 0 - if len(params) == 1: - self.screen = int(params[0]) - elif len(params) == 4: - left, top, width, height = (int(x) for x in params) - elif len(params) == 5: - self.screen, left, top, width, height = (int(x) for x in params) - self.mode = "stream" - self.frame = 0 - self.sct = mss.mss() - self.bs = 1 - self.fps = 30 - - # Parse monitor shape - monitor = self.sct.monitors[self.screen] - self.top = monitor["top"] if top is None else (monitor["top"] + top) - self.left = monitor["left"] if left is None else (monitor["left"] + left) - self.width = width or monitor["width"] - self.height = height or monitor["height"] - self.monitor = {"left": self.left, "top": self.top, "width": self.width, "height": self.height} - - def __iter__(self): - """Returns an iterator of the object.""" - return self - - def __next__(self): - """mss screen capture: get raw pixels from the screen as np array.""" - im0 = np.asarray(self.sct.grab(self.monitor))[:, :, :3] # BGRA to BGR - s = f"screen {self.screen} (LTWH): {self.left},{self.top},{self.width},{self.height}: " - - self.frame += 1 - return [str(self.screen)], [im0], [s] # screen, img, string - - -class LoadImagesAndVideos: - """ - YOLOv8 image/video dataloader. - - This class manages the loading and pre-processing of image and video data for YOLOv8. It supports loading from - various formats, including single image files, video files, and lists of image and video paths. - - Attributes: - files (list): List of image and video file paths. - nf (int): Total number of files (images and videos). - video_flag (list): Flags indicating whether a file is a video (True) or an image (False). - mode (str): Current mode, 'image' or 'video'. - vid_stride (int): Stride for video frame-rate, defaults to 1. - bs (int): Batch size, set to 1 for this class. - cap (cv2.VideoCapture): Video capture object for OpenCV. - frame (int): Frame counter for video. - frames (int): Total number of frames in the video. - count (int): Counter for iteration, initialized at 0 during `__iter__()`. - - Methods: - _new_video(path): Create a new cv2.VideoCapture object for a given video path. - """ - - def __init__(self, path, batch=1, vid_stride=1): - """Initialize the Dataloader and raise FileNotFoundError if file not found.""" - parent = None - if isinstance(path, str) and Path(path).suffix == ".txt": # *.txt file with img/vid/dir on each line - parent = Path(path).parent - path = Path(path).read_text().splitlines() # list of sources - files = [] - for p in sorted(path) if isinstance(path, (list, tuple)) else [path]: - a = str(Path(p).absolute()) # do not use .resolve() https://github.com/ultralytics/ultralytics/issues/2912 - if "*" in a: - files.extend(sorted(glob.glob(a, recursive=True))) # glob - elif os.path.isdir(a): - files.extend(sorted(glob.glob(os.path.join(a, "*.*")))) # dir - elif os.path.isfile(a): - files.append(a) # files (absolute or relative to CWD) - elif parent and (parent / p).is_file(): - files.append(str((parent / p).absolute())) # files (relative to *.txt file parent) - else: - raise FileNotFoundError(f"{p} does not exist") - - images = [x for x in files if x.split(".")[-1].lower() in IMG_FORMATS] - videos = [x for x in files if x.split(".")[-1].lower() in VID_FORMATS] - ni, nv = len(images), len(videos) - - self.files = images + videos - self.nf = ni + nv # number of files - self.ni = ni # number of images - self.video_flag = [False] * ni + [True] * nv - self.mode = "image" - self.vid_stride = vid_stride # video frame-rate stride - self.bs = batch - if any(videos): - self._new_video(videos[0]) # new video - else: - self.cap = None - if self.nf == 0: - raise FileNotFoundError( - f"No images or videos found in {p}. " - f"Supported formats are:\nimages: {IMG_FORMATS}\nvideos: {VID_FORMATS}" - ) - - def __iter__(self): - """Returns an iterator object for VideoStream or ImageFolder.""" - self.count = 0 - return self - - def __next__(self): - """Returns the next batch of images or video frames along with their paths and metadata.""" - paths, imgs, info = [], [], [] - while len(imgs) < self.bs: - if self.count >= self.nf: # end of file list - if len(imgs) > 0: - return paths, imgs, info # return last partial batch - else: - raise StopIteration - - path = self.files[self.count] - if self.video_flag[self.count]: - self.mode = "video" - if not self.cap or not self.cap.isOpened(): - self._new_video(path) - - for _ in range(self.vid_stride): - success = self.cap.grab() - if not success: - break # end of video or failure - - if success: - success, im0 = self.cap.retrieve() - if success: - self.frame += 1 - paths.append(path) - imgs.append(im0) - info.append(f"video {self.count + 1}/{self.nf} (frame {self.frame}/{self.frames}) {path}: ") - if self.frame == self.frames: # end of video - self.count += 1 - self.cap.release() - else: - # Move to the next file if the current video ended or failed to open - self.count += 1 - if self.cap: - self.cap.release() - if self.count < self.nf: - self._new_video(self.files[self.count]) - else: - self.mode = "image" - im0 = cv2.imread(path) # BGR - if im0 is None: - raise FileNotFoundError(f"Image Not Found {path}") - paths.append(path) - imgs.append(im0) - info.append(f"image {self.count + 1}/{self.nf} {path}: ") - self.count += 1 # move to the next file - if self.count >= self.ni: # end of image list - break - - return paths, imgs, info - - def _new_video(self, path): - """Creates a new video capture object for the given path.""" - self.frame = 0 - self.cap = cv2.VideoCapture(path) - self.fps = int(self.cap.get(cv2.CAP_PROP_FPS)) - if not self.cap.isOpened(): - raise FileNotFoundError(f"Failed to open video {path}") - self.frames = int(self.cap.get(cv2.CAP_PROP_FRAME_COUNT) / self.vid_stride) - - def __len__(self): - """Returns the number of batches in the object.""" - return math.ceil(self.nf / self.bs) # number of files - - -class LoadPilAndNumpy: - """ - Load images from PIL and Numpy arrays for batch processing. - - This class is designed to manage loading and pre-processing of image data from both PIL and Numpy formats. - It performs basic validation and format conversion to ensure that the images are in the required format for - downstream processing. - - Attributes: - paths (list): List of image paths or autogenerated filenames. - im0 (list): List of images stored as Numpy arrays. - mode (str): Type of data being processed, defaults to 'image'. - bs (int): Batch size, equivalent to the length of `im0`. - - Methods: - _single_check(im): Validate and format a single image to a Numpy array. - """ - - def __init__(self, im0): - """Initialize PIL and Numpy Dataloader.""" - if not isinstance(im0, list): - im0 = [im0] - self.paths = [getattr(im, "filename", f"image{i}.jpg") for i, im in enumerate(im0)] - self.im0 = [self._single_check(im) for im in im0] - self.mode = "image" - self.bs = len(self.im0) - - @staticmethod - def _single_check(im): - """Validate and format an image to numpy array.""" - assert isinstance(im, (Image.Image, np.ndarray)), f"Expected PIL/np.ndarray image type, but got {type(im)}" - if isinstance(im, Image.Image): - if im.mode != "RGB": - im = im.convert("RGB") - im = np.asarray(im)[:, :, ::-1] - im = np.ascontiguousarray(im) # contiguous - return im - - def __len__(self): - """Returns the length of the 'im0' attribute.""" - return len(self.im0) - - def __next__(self): - """Returns batch paths, images, processed images, None, ''.""" - if self.count == 1: # loop only once as it's batch inference - raise StopIteration - self.count += 1 - return self.paths, self.im0, [""] * self.bs - - def __iter__(self): - """Enables iteration for class LoadPilAndNumpy.""" - self.count = 0 - return self - - -class LoadTensor: - """ - Load images from torch.Tensor data. - - This class manages the loading and pre-processing of image data from PyTorch tensors for further processing. - - Attributes: - im0 (torch.Tensor): The input tensor containing the image(s). - bs (int): Batch size, inferred from the shape of `im0`. - mode (str): Current mode, set to 'image'. - paths (list): List of image paths or filenames. - count (int): Counter for iteration, initialized at 0 during `__iter__()`. - - Methods: - _single_check(im, stride): Validate and possibly modify the input tensor. - """ - - def __init__(self, im0) -> None: - """Initialize Tensor Dataloader.""" - self.im0 = self._single_check(im0) - self.bs = self.im0.shape[0] - self.mode = "image" - self.paths = [getattr(im, "filename", f"image{i}.jpg") for i, im in enumerate(im0)] - - @staticmethod - def _single_check(im, stride=32): - """Validate and format an image to torch.Tensor.""" - s = ( - f"WARNING ⚠️ torch.Tensor inputs should be BCHW i.e. shape(1, 3, 640, 640) " - f"divisible by stride {stride}. Input shape{tuple(im.shape)} is incompatible." - ) - if len(im.shape) != 4: - if len(im.shape) != 3: - raise ValueError(s) - LOGGER.warning(s) - im = im.unsqueeze(0) - if im.shape[2] % stride or im.shape[3] % stride: - raise ValueError(s) - if im.max() > 1.0 + torch.finfo(im.dtype).eps: # torch.float32 eps is 1.2e-07 - LOGGER.warning( - f"WARNING ⚠️ torch.Tensor inputs should be normalized 0.0-1.0 but max value is {im.max()}. " - f"Dividing input by 255." - ) - im = im.float() / 255.0 - - return im - - def __iter__(self): - """Returns an iterator object.""" - self.count = 0 - return self - - def __next__(self): - """Return next item in the iterator.""" - if self.count == 1: - raise StopIteration - self.count += 1 - return self.paths, self.im0, [""] * self.bs - - def __len__(self): - """Returns the batch size.""" - return self.bs - - -def autocast_list(source): - """Merges a list of source of different types into a list of numpy arrays or PIL images.""" - files = [] - for im in source: - if isinstance(im, (str, Path)): # filename or uri - files.append(Image.open(requests.get(im, stream=True).raw if str(im).startswith("http") else im)) - elif isinstance(im, (Image.Image, np.ndarray)): # PIL or np Image - files.append(im) - else: - raise TypeError( - f"type {type(im).__name__} is not a supported Ultralytics prediction source type. \n" - f"See https://docs.ultralytics.com/modes/predict for supported source types." - ) - - return files - - -def get_best_youtube_url(url, use_pafy=True): - """ - Retrieves the URL of the best quality MP4 video stream from a given YouTube video. - - This function uses the pafy or yt_dlp library to extract the video info from YouTube. It then finds the highest - quality MP4 format that has video codec but no audio codec, and returns the URL of this video stream. - - Args: - url (str): The URL of the YouTube video. - use_pafy (bool): Use the pafy package, default=True, otherwise use yt_dlp package. - - Returns: - (str): The URL of the best quality MP4 video stream, or None if no suitable stream is found. - """ - if use_pafy: - check_requirements(("pafy", "youtube_dl==2020.12.2")) - import pafy # noqa - - return pafy.new(url).getbestvideo(preftype="mp4").url - else: - check_requirements("yt-dlp") - import yt_dlp - - with yt_dlp.YoutubeDL({"quiet": True}) as ydl: - info_dict = ydl.extract_info(url, download=False) # extract info - for f in reversed(info_dict.get("formats", [])): # reversed because best is usually last - # Find a format with video codec, no audio, *.mp4 extension at least 1920x1080 size - good_size = (f.get("width") or 0) >= 1920 or (f.get("height") or 0) >= 1080 - if good_size and f["vcodec"] != "none" and f["acodec"] == "none" and f["ext"] == "mp4": - return f.get("url") - - -# Define constants -LOADERS = (LoadStreams, LoadPilAndNumpy, LoadImagesAndVideos, LoadScreenshots) diff --git a/ultralytics-main/ultralytics/data/scripts/download_weights.sh b/ultralytics-main/ultralytics/data/scripts/download_weights.sh deleted file mode 100644 index 87db31f..0000000 --- a/ultralytics-main/ultralytics/data/scripts/download_weights.sh +++ /dev/null @@ -1,18 +0,0 @@ -#!/bin/bash -# Ultralytics YOLO 🚀, AGPL-3.0 license -# Download latest models from https://github.com/ultralytics/assets/releases -# Example usage: bash ultralytics/data/scripts/download_weights.sh -# parent -# └── weights -# ├── yolov8n.pt ← downloads here -# ├── yolov8s.pt -# └── ... - -python - < gap, f"invalid crop_size gap pair [{crop_size} {gap}]" - step = crop_size - gap - - xn = 1 if w <= crop_size else ceil((w - crop_size) / step + 1) - xs = [step * i for i in range(xn)] - if len(xs) > 1 and xs[-1] + crop_size > w: - xs[-1] = w - crop_size - - yn = 1 if h <= crop_size else ceil((h - crop_size) / step + 1) - ys = [step * i for i in range(yn)] - if len(ys) > 1 and ys[-1] + crop_size > h: - ys[-1] = h - crop_size - - start = np.array(list(itertools.product(xs, ys)), dtype=np.int64) - stop = start + crop_size - windows.append(np.concatenate([start, stop], axis=1)) - windows = np.concatenate(windows, axis=0) - - im_in_wins = windows.copy() - im_in_wins[:, 0::2] = np.clip(im_in_wins[:, 0::2], 0, w) - im_in_wins[:, 1::2] = np.clip(im_in_wins[:, 1::2], 0, h) - im_areas = (im_in_wins[:, 2] - im_in_wins[:, 0]) * (im_in_wins[:, 3] - im_in_wins[:, 1]) - win_areas = (windows[:, 2] - windows[:, 0]) * (windows[:, 3] - windows[:, 1]) - im_rates = im_areas / win_areas - if not (im_rates > im_rate_thr).any(): - max_rate = im_rates.max() - im_rates[abs(im_rates - max_rate) < eps] = 1 - return windows[im_rates > im_rate_thr] - - -def get_window_obj(anno, windows, iof_thr=0.7): - """Get objects for each window.""" - h, w = anno["ori_size"] - label = anno["label"] - if len(label): - label[:, 1::2] *= w - label[:, 2::2] *= h - iofs = bbox_iof(label[:, 1:], windows) - # Unnormalized and misaligned coordinates - return [(label[iofs[:, i] >= iof_thr]) for i in range(len(windows))] # window_anns - else: - return [np.zeros((0, 9), dtype=np.float32) for _ in range(len(windows))] # window_anns - - -def crop_and_save(anno, windows, window_objs, im_dir, lb_dir): - """ - Crop images and save new labels. - - Args: - anno (dict): Annotation dict, including `filepath`, `label`, `ori_size` as its keys. - windows (list): A list of windows coordinates. - window_objs (list): A list of labels inside each window. - im_dir (str): The output directory path of images. - lb_dir (str): The output directory path of labels. - - Notes: - The directory structure assumed for the DOTA dataset: - - data_root - - images - - train - - val - - labels - - train - - val - """ - im = cv2.imread(anno["filepath"]) - name = Path(anno["filepath"]).stem - for i, window in enumerate(windows): - x_start, y_start, x_stop, y_stop = window.tolist() - new_name = f"{name}__{x_stop - x_start}__{x_start}___{y_start}" - patch_im = im[y_start:y_stop, x_start:x_stop] - ph, pw = patch_im.shape[:2] - - cv2.imwrite(str(Path(im_dir) / f"{new_name}.jpg"), patch_im) - label = window_objs[i] - if len(label) == 0: - continue - label[:, 1::2] -= x_start - label[:, 2::2] -= y_start - label[:, 1::2] /= pw - label[:, 2::2] /= ph - - with open(Path(lb_dir) / f"{new_name}.txt", "w") as f: - for lb in label: - formatted_coords = ["{:.6g}".format(coord) for coord in lb[1:]] - f.write(f"{int(lb[0])} {' '.join(formatted_coords)}\n") - - -def split_images_and_labels(data_root, save_dir, split="train", crop_sizes=[1024], gaps=[200]): - """ - Split both images and labels. - - Notes: - The directory structure assumed for the DOTA dataset: - - data_root - - images - - split - - labels - - split - and the output directory structure is: - - save_dir - - images - - split - - labels - - split - """ - im_dir = Path(save_dir) / "images" / split - im_dir.mkdir(parents=True, exist_ok=True) - lb_dir = Path(save_dir) / "labels" / split - lb_dir.mkdir(parents=True, exist_ok=True) - - annos = load_yolo_dota(data_root, split=split) - for anno in tqdm(annos, total=len(annos), desc=split): - windows = get_windows(anno["ori_size"], crop_sizes, gaps) - window_objs = get_window_obj(anno, windows) - crop_and_save(anno, windows, window_objs, str(im_dir), str(lb_dir)) - - -def split_trainval(data_root, save_dir, crop_size=1024, gap=200, rates=[1.0]): - """ - Split train and val set of DOTA. - - Notes: - The directory structure assumed for the DOTA dataset: - - data_root - - images - - train - - val - - labels - - train - - val - and the output directory structure is: - - save_dir - - images - - train - - val - - labels - - train - - val - """ - crop_sizes, gaps = [], [] - for r in rates: - crop_sizes.append(int(crop_size / r)) - gaps.append(int(gap / r)) - for split in ["train", "val"]: - split_images_and_labels(data_root, save_dir, split, crop_sizes, gaps) - - -def split_test(data_root, save_dir, crop_size=1024, gap=200, rates=[1.0]): - """ - Split test set of DOTA, labels are not included within this set. - - Notes: - The directory structure assumed for the DOTA dataset: - - data_root - - images - - test - and the output directory structure is: - - save_dir - - images - - test - """ - crop_sizes, gaps = [], [] - for r in rates: - crop_sizes.append(int(crop_size / r)) - gaps.append(int(gap / r)) - save_dir = Path(save_dir) / "images" / "test" - save_dir.mkdir(parents=True, exist_ok=True) - - im_dir = Path(data_root) / "images" / "test" - assert im_dir.exists(), f"Can't find {im_dir}, please check your data root." - im_files = glob(str(im_dir / "*")) - for im_file in tqdm(im_files, total=len(im_files), desc="test"): - w, h = exif_size(Image.open(im_file)) - windows = get_windows((h, w), crop_sizes=crop_sizes, gaps=gaps) - im = cv2.imread(im_file) - name = Path(im_file).stem - for window in windows: - x_start, y_start, x_stop, y_stop = window.tolist() - new_name = f"{name}__{x_stop - x_start}__{x_start}___{y_start}" - patch_im = im[y_start:y_stop, x_start:x_stop] - cv2.imwrite(str(save_dir / f"{new_name}.jpg"), patch_im) - - -if __name__ == "__main__": - split_trainval(data_root="DOTAv2", save_dir="DOTAv2-split") - split_test(data_root="DOTAv2", save_dir="DOTAv2-split") diff --git a/ultralytics-main/ultralytics/data/utils.py b/ultralytics-main/ultralytics/data/utils.py deleted file mode 100644 index 1ce8127..0000000 --- a/ultralytics-main/ultralytics/data/utils.py +++ /dev/null @@ -1,651 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import contextlib -import hashlib -import json -import os -import random -import subprocess -import time -import zipfile -from multiprocessing.pool import ThreadPool -from pathlib import Path -from tarfile import is_tarfile - -import cv2 -import numpy as np -from PIL import Image, ImageOps - -from ultralytics.nn.autobackend import check_class_names -from ultralytics.utils import ( - DATASETS_DIR, - LOGGER, - NUM_THREADS, - ROOT, - SETTINGS_YAML, - TQDM, - clean_url, - colorstr, - emojis, - yaml_load, - yaml_save, -) -from ultralytics.utils.checks import check_file, check_font, is_ascii -from ultralytics.utils.downloads import download, safe_download, unzip_file -from ultralytics.utils.ops import segments2boxes - -HELP_URL = "See https://docs.ultralytics.com/datasets/detect for dataset formatting guidance." -IMG_FORMATS = "bmp", "dng", "jpeg", "jpg", "mpo", "png", "tif", "tiff", "webp", "pfm" # image suffixes -VID_FORMATS = "asf", "avi", "gif", "m4v", "mkv", "mov", "mp4", "mpeg", "mpg", "ts", "wmv", "webm" # video suffixes -PIN_MEMORY = str(os.getenv("PIN_MEMORY", True)).lower() == "true" # global pin_memory for dataloaders - - -def img2label_paths(img_paths): - """Define label paths as a function of image paths.""" - sa, sb = f"{os.sep}images{os.sep}", f"{os.sep}labels{os.sep}" # /images/, /labels/ substrings - return [sb.join(x.rsplit(sa, 1)).rsplit(".", 1)[0] + ".txt" for x in img_paths] - - -def get_hash(paths): - """Returns a single hash value of a list of paths (files or dirs).""" - size = sum(os.path.getsize(p) for p in paths if os.path.exists(p)) # sizes - h = hashlib.sha256(str(size).encode()) # hash sizes - h.update("".join(paths).encode()) # hash paths - return h.hexdigest() # return hash - - -def exif_size(img: Image.Image): - """Returns exif-corrected PIL size.""" - s = img.size # (width, height) - if img.format == "JPEG": # only support JPEG images - with contextlib.suppress(Exception): - exif = img.getexif() - if exif: - rotation = exif.get(274, None) # the EXIF key for the orientation tag is 274 - if rotation in [6, 8]: # rotation 270 or 90 - s = s[1], s[0] - return s - - -def verify_image(args): - """Verify one image.""" - (im_file, cls), prefix = args - # Number (found, corrupt), message - nf, nc, msg = 0, 0, "" - try: - im = Image.open(im_file) - im.verify() # PIL verify - shape = exif_size(im) # image size - shape = (shape[1], shape[0]) # hw - assert (shape[0] > 9) & (shape[1] > 9), f"image size {shape} <10 pixels" - assert im.format.lower() in IMG_FORMATS, f"invalid image format {im.format}" - if im.format.lower() in ("jpg", "jpeg"): - with open(im_file, "rb") as f: - f.seek(-2, 2) - if f.read() != b"\xff\xd9": # corrupt JPEG - ImageOps.exif_transpose(Image.open(im_file)).save(im_file, "JPEG", subsampling=0, quality=100) - msg = f"{prefix}WARNING ⚠️ {im_file}: corrupt JPEG restored and saved" - nf = 1 - except Exception as e: - nc = 1 - msg = f"{prefix}WARNING ⚠️ {im_file}: ignoring corrupt image/label: {e}" - return (im_file, cls), nf, nc, msg - - -def verify_image_label(args): - """Verify one image-label pair.""" - im_file, lb_file, prefix, keypoint, num_cls, nkpt, ndim = args - # Number (missing, found, empty, corrupt), message, segments, keypoints - nm, nf, ne, nc, msg, segments, keypoints = 0, 0, 0, 0, "", [], None - try: - # Verify images - im = Image.open(im_file) - im.verify() # PIL verify - shape = exif_size(im) # image size - shape = (shape[1], shape[0]) # hw - assert (shape[0] > 9) & (shape[1] > 9), f"image size {shape} <10 pixels" - assert im.format.lower() in IMG_FORMATS, f"invalid image format {im.format}" - if im.format.lower() in ("jpg", "jpeg"): - with open(im_file, "rb") as f: - f.seek(-2, 2) - if f.read() != b"\xff\xd9": # corrupt JPEG - ImageOps.exif_transpose(Image.open(im_file)).save(im_file, "JPEG", subsampling=0, quality=100) - msg = f"{prefix}WARNING ⚠️ {im_file}: corrupt JPEG restored and saved" - - # Verify labels - if os.path.isfile(lb_file): - nf = 1 # label found - with open(lb_file) as f: - lb = [x.split() for x in f.read().strip().splitlines() if len(x)] - if any(len(x) > 6 for x in lb) and (not keypoint): # is segment - classes = np.array([x[0] for x in lb], dtype=np.float32) - segments = [np.array(x[1:], dtype=np.float32).reshape(-1, 2) for x in lb] # (cls, xy1...) - lb = np.concatenate((classes.reshape(-1, 1), segments2boxes(segments)), 1) # (cls, xywh) - lb = np.array(lb, dtype=np.float32) - nl = len(lb) - if nl: - if keypoint: - assert lb.shape[1] == (5 + nkpt * ndim), f"labels require {(5 + nkpt * ndim)} columns each" - points = lb[:, 5:].reshape(-1, ndim)[:, :2] - else: - assert lb.shape[1] == 5, f"labels require 5 columns, {lb.shape[1]} columns detected" - points = lb[:, 1:] - assert points.max() <= 1, f"non-normalized or out of bounds coordinates {points[points > 1]}" - assert lb.min() >= 0, f"negative label values {lb[lb < 0]}" - - # All labels - max_cls = lb[:, 0].max() # max label count - assert max_cls <= num_cls, ( - f"Label class {int(max_cls)} exceeds dataset class count {num_cls}. " - f"Possible class labels are 0-{num_cls - 1}" - ) - _, i = np.unique(lb, axis=0, return_index=True) - if len(i) < nl: # duplicate row check - lb = lb[i] # remove duplicates - if segments: - segments = [segments[x] for x in i] - msg = f"{prefix}WARNING ⚠️ {im_file}: {nl - len(i)} duplicate labels removed" - else: - ne = 1 # label empty - lb = np.zeros((0, (5 + nkpt * ndim) if keypoint else 5), dtype=np.float32) - else: - nm = 1 # label missing - lb = np.zeros((0, (5 + nkpt * ndim) if keypoints else 5), dtype=np.float32) - if keypoint: - keypoints = lb[:, 5:].reshape(-1, nkpt, ndim) - if ndim == 2: - kpt_mask = np.where((keypoints[..., 0] < 0) | (keypoints[..., 1] < 0), 0.0, 1.0).astype(np.float32) - keypoints = np.concatenate([keypoints, kpt_mask[..., None]], axis=-1) # (nl, nkpt, 3) - lb = lb[:, :5] - return im_file, lb, shape, segments, keypoints, nm, nf, ne, nc, msg - except Exception as e: - nc = 1 - msg = f"{prefix}WARNING ⚠️ {im_file}: ignoring corrupt image/label: {e}" - return [None, None, None, None, None, nm, nf, ne, nc, msg] - - -def polygon2mask(imgsz, polygons, color=1, downsample_ratio=1): - """ - Convert a list of polygons to a binary mask of the specified image size. - - Args: - imgsz (tuple): The size of the image as (height, width). - polygons (list[np.ndarray]): A list of polygons. Each polygon is an array with shape [N, M], where - N is the number of polygons, and M is the number of points such that M % 2 = 0. - color (int, optional): The color value to fill in the polygons on the mask. Defaults to 1. - downsample_ratio (int, optional): Factor by which to downsample the mask. Defaults to 1. - - Returns: - (np.ndarray): A binary mask of the specified image size with the polygons filled in. - """ - mask = np.zeros(imgsz, dtype=np.uint8) - polygons = np.asarray(polygons, dtype=np.int32) - polygons = polygons.reshape((polygons.shape[0], -1, 2)) - cv2.fillPoly(mask, polygons, color=color) - nh, nw = (imgsz[0] // downsample_ratio, imgsz[1] // downsample_ratio) - # Note: fillPoly first then resize is trying to keep the same loss calculation method when mask-ratio=1 - return cv2.resize(mask, (nw, nh)) - - -def polygons2masks(imgsz, polygons, color, downsample_ratio=1): - """ - Convert a list of polygons to a set of binary masks of the specified image size. - - Args: - imgsz (tuple): The size of the image as (height, width). - polygons (list[np.ndarray]): A list of polygons. Each polygon is an array with shape [N, M], where - N is the number of polygons, and M is the number of points such that M % 2 = 0. - color (int): The color value to fill in the polygons on the masks. - downsample_ratio (int, optional): Factor by which to downsample each mask. Defaults to 1. - - Returns: - (np.ndarray): A set of binary masks of the specified image size with the polygons filled in. - """ - return np.array([polygon2mask(imgsz, [x.reshape(-1)], color, downsample_ratio) for x in polygons]) - - -def polygons2masks_overlap(imgsz, segments, downsample_ratio=1): - """Return a (640, 640) overlap mask.""" - masks = np.zeros( - (imgsz[0] // downsample_ratio, imgsz[1] // downsample_ratio), - dtype=np.int32 if len(segments) > 255 else np.uint8, - ) - areas = [] - ms = [] - for si in range(len(segments)): - mask = polygon2mask(imgsz, [segments[si].reshape(-1)], downsample_ratio=downsample_ratio, color=1) - ms.append(mask) - areas.append(mask.sum()) - areas = np.asarray(areas) - index = np.argsort(-areas) - ms = np.array(ms)[index] - for i in range(len(segments)): - mask = ms[i] * (i + 1) - masks = masks + mask - masks = np.clip(masks, a_min=0, a_max=i + 1) - return masks, index - - -def find_dataset_yaml(path: Path) -> Path: - """ - Find and return the YAML file associated with a Detect, Segment or Pose dataset. - - This function searches for a YAML file at the root level of the provided directory first, and if not found, it - performs a recursive search. It prefers YAML files that have the same stem as the provided path. An AssertionError - is raised if no YAML file is found or if multiple YAML files are found. - - Args: - path (Path): The directory path to search for the YAML file. - - Returns: - (Path): The path of the found YAML file. - """ - files = list(path.glob("*.yaml")) or list(path.rglob("*.yaml")) # try root level first and then recursive - assert files, f"No YAML file found in '{path.resolve()}'" - if len(files) > 1: - files = [f for f in files if f.stem == path.stem] # prefer *.yaml files that match - assert len(files) == 1, f"Expected 1 YAML file in '{path.resolve()}', but found {len(files)}.\n{files}" - return files[0] - - -def check_det_dataset(dataset, autodownload=True): - """ - Download, verify, and/or unzip a dataset if not found locally. - - This function checks the availability of a specified dataset, and if not found, it has the option to download and - unzip the dataset. It then reads and parses the accompanying YAML data, ensuring key requirements are met and also - resolves paths related to the dataset. - - Args: - dataset (str): Path to the dataset or dataset descriptor (like a YAML file). - autodownload (bool, optional): Whether to automatically download the dataset if not found. Defaults to True. - - Returns: - (dict): Parsed dataset information and paths. - """ - - file = check_file(dataset) - - # Download (optional) - extract_dir = "" - if zipfile.is_zipfile(file) or is_tarfile(file): - new_dir = safe_download(file, dir=DATASETS_DIR, unzip=True, delete=False) - file = find_dataset_yaml(DATASETS_DIR / new_dir) - extract_dir, autodownload = file.parent, False - - # Read YAML - data = yaml_load(file, append_filename=True) # dictionary - - # Checks - for k in "train", "val": - if k not in data: - if k != "val" or "validation" not in data: - raise SyntaxError( - emojis(f"{dataset} '{k}:' key missing ❌.\n'train' and 'val' are required in all data YAMLs.") - ) - LOGGER.info("WARNING ⚠️ renaming data YAML 'validation' key to 'val' to match YOLO format.") - data["val"] = data.pop("validation") # replace 'validation' key with 'val' key - if "names" not in data and "nc" not in data: - raise SyntaxError(emojis(f"{dataset} key missing ❌.\n either 'names' or 'nc' are required in all data YAMLs.")) - if "names" in data and "nc" in data and len(data["names"]) != data["nc"]: - raise SyntaxError(emojis(f"{dataset} 'names' length {len(data['names'])} and 'nc: {data['nc']}' must match.")) - if "names" not in data: - data["names"] = [f"class_{i}" for i in range(data["nc"])] - else: - data["nc"] = len(data["names"]) - - data["names"] = check_class_names(data["names"]) - - # Resolve paths - path = Path(extract_dir or data.get("path") or Path(data.get("yaml_file", "")).parent) # dataset root - if not path.is_absolute(): - path = (DATASETS_DIR / path).resolve() - - # Set paths - data["path"] = path # download scripts - for k in "train", "val", "test": - if data.get(k): # prepend path - if isinstance(data[k], str): - x = (path / data[k]).resolve() - if not x.exists() and data[k].startswith("../"): - x = (path / data[k][3:]).resolve() - data[k] = str(x) - else: - data[k] = [str((path / x).resolve()) for x in data[k]] - - # Parse YAML - val, s = (data.get(x) for x in ("val", "download")) - if val: - val = [Path(x).resolve() for x in (val if isinstance(val, list) else [val])] # val path - if not all(x.exists() for x in val): - name = clean_url(dataset) # dataset name with URL auth stripped - m = f"\nDataset '{name}' images not found ⚠️, missing path '{[x for x in val if not x.exists()][0]}'" - if s and autodownload: - LOGGER.warning(m) - else: - m += f"\nNote dataset download directory is '{DATASETS_DIR}'. You can update this in '{SETTINGS_YAML}'" - raise FileNotFoundError(m) - t = time.time() - r = None # success - if s.startswith("http") and s.endswith(".zip"): # URL - safe_download(url=s, dir=DATASETS_DIR, delete=True) - elif s.startswith("bash "): # bash script - LOGGER.info(f"Running {s} ...") - r = os.system(s) - else: # python script - exec(s, {"yaml": data}) - dt = f"({round(time.time() - t, 1)}s)" - s = f"success ✅ {dt}, saved to {colorstr('bold', DATASETS_DIR)}" if r in (0, None) else f"failure {dt} ❌" - LOGGER.info(f"Dataset download {s}\n") - check_font("Arial.ttf" if is_ascii(data["names"]) else "Arial.Unicode.ttf") # download fonts - - return data # dictionary - - -def check_cls_dataset(dataset, split=""): - """ - Checks a classification dataset such as Imagenet. - - This function accepts a `dataset` name and attempts to retrieve the corresponding dataset information. - If the dataset is not found locally, it attempts to download the dataset from the internet and save it locally. - - Args: - dataset (str | Path): The name of the dataset. - split (str, optional): The split of the dataset. Either 'val', 'test', or ''. Defaults to ''. - - Returns: - (dict): A dictionary containing the following keys: - - 'train' (Path): The directory path containing the training set of the dataset. - - 'val' (Path): The directory path containing the validation set of the dataset. - - 'test' (Path): The directory path containing the test set of the dataset. - - 'nc' (int): The number of classes in the dataset. - - 'names' (dict): A dictionary of class names in the dataset. - """ - - # Download (optional if dataset=https://file.zip is passed directly) - if str(dataset).startswith(("http:/", "https:/")): - dataset = safe_download(dataset, dir=DATASETS_DIR, unzip=True, delete=False) - elif Path(dataset).suffix in (".zip", ".tar", ".gz"): - file = check_file(dataset) - dataset = safe_download(file, dir=DATASETS_DIR, unzip=True, delete=False) - - dataset = Path(dataset) - data_dir = (dataset if dataset.is_dir() else (DATASETS_DIR / dataset)).resolve() - if not data_dir.is_dir(): - LOGGER.warning(f"\nDataset not found ⚠️, missing path {data_dir}, attempting download...") - t = time.time() - if str(dataset) == "imagenet": - subprocess.run(f"bash {ROOT / 'data/scripts/get_imagenet.sh'}", shell=True, check=True) - else: - url = f"https://github.com/ultralytics/yolov5/releases/download/v1.0/{dataset}.zip" - download(url, dir=data_dir.parent) - s = f"Dataset download success ✅ ({time.time() - t:.1f}s), saved to {colorstr('bold', data_dir)}\n" - LOGGER.info(s) - train_set = data_dir / "train" - val_set = ( - data_dir / "val" - if (data_dir / "val").exists() - else data_dir / "validation" - if (data_dir / "validation").exists() - else None - ) # data/test or data/val - test_set = data_dir / "test" if (data_dir / "test").exists() else None # data/val or data/test - if split == "val" and not val_set: - LOGGER.warning("WARNING ⚠️ Dataset 'split=val' not found, using 'split=test' instead.") - elif split == "test" and not test_set: - LOGGER.warning("WARNING ⚠️ Dataset 'split=test' not found, using 'split=val' instead.") - - nc = len([x for x in (data_dir / "train").glob("*") if x.is_dir()]) # number of classes - names = [x.name for x in (data_dir / "train").iterdir() if x.is_dir()] # class names list - names = dict(enumerate(sorted(names))) - - # Print to console - for k, v in {"train": train_set, "val": val_set, "test": test_set}.items(): - prefix = f'{colorstr(f"{k}:")} {v}...' - if v is None: - LOGGER.info(prefix) - else: - files = [path for path in v.rglob("*.*") if path.suffix[1:].lower() in IMG_FORMATS] - nf = len(files) # number of files - nd = len({file.parent for file in files}) # number of directories - if nf == 0: - if k == "train": - raise FileNotFoundError(emojis(f"{dataset} '{k}:' no training images found ❌ ")) - else: - LOGGER.warning(f"{prefix} found {nf} images in {nd} classes: WARNING ⚠️ no images found") - elif nd != nc: - LOGGER.warning(f"{prefix} found {nf} images in {nd} classes: ERROR ❌️ requires {nc} classes, not {nd}") - else: - LOGGER.info(f"{prefix} found {nf} images in {nd} classes ✅ ") - - return {"train": train_set, "val": val_set, "test": test_set, "nc": nc, "names": names} - - -class HUBDatasetStats: - """ - A class for generating HUB dataset JSON and `-hub` dataset directory. - - Args: - path (str): Path to data.yaml or data.zip (with data.yaml inside data.zip). Default is 'coco8.yaml'. - task (str): Dataset task. Options are 'detect', 'segment', 'pose', 'classify'. Default is 'detect'. - autodownload (bool): Attempt to download dataset if not found locally. Default is False. - - Example: - Download *.zip files from https://github.com/ultralytics/hub/tree/main/example_datasets - i.e. https://github.com/ultralytics/hub/raw/main/example_datasets/coco8.zip for coco8.zip. - ```python - from ultralytics.data.utils import HUBDatasetStats - - stats = HUBDatasetStats('path/to/coco8.zip', task='detect') # detect dataset - stats = HUBDatasetStats('path/to/coco8-seg.zip', task='segment') # segment dataset - stats = HUBDatasetStats('path/to/coco8-pose.zip', task='pose') # pose dataset - stats = HUBDatasetStats('path/to/imagenet10.zip', task='classify') # classification dataset - - stats.get_json(save=True) - stats.process_images() - ``` - """ - - def __init__(self, path="coco8.yaml", task="detect", autodownload=False): - """Initialize class.""" - path = Path(path).resolve() - LOGGER.info(f"Starting HUB dataset checks for {path}....") - - self.task = task # detect, segment, pose, classify - if self.task == "classify": - unzip_dir = unzip_file(path) - data = check_cls_dataset(unzip_dir) - data["path"] = unzip_dir - else: # detect, segment, pose - _, data_dir, yaml_path = self._unzip(Path(path)) - try: - # Load YAML with checks - data = yaml_load(yaml_path) - data["path"] = "" # strip path since YAML should be in dataset root for all HUB datasets - yaml_save(yaml_path, data) - data = check_det_dataset(yaml_path, autodownload) # dict - data["path"] = data_dir # YAML path should be set to '' (relative) or parent (absolute) - except Exception as e: - raise Exception("error/HUB/dataset_stats/init") from e - - self.hub_dir = Path(f'{data["path"]}-hub') - self.im_dir = self.hub_dir / "images" - self.stats = {"nc": len(data["names"]), "names": list(data["names"].values())} # statistics dictionary - self.data = data - - @staticmethod - def _unzip(path): - """Unzip data.zip.""" - if not str(path).endswith(".zip"): # path is data.yaml - return False, None, path - unzip_dir = unzip_file(path, path=path.parent) - assert unzip_dir.is_dir(), ( - f"Error unzipping {path}, {unzip_dir} not found. " f"path/to/abc.zip MUST unzip to path/to/abc/" - ) - return True, str(unzip_dir), find_dataset_yaml(unzip_dir) # zipped, data_dir, yaml_path - - def _hub_ops(self, f): - """Saves a compressed image for HUB previews.""" - compress_one_image(f, self.im_dir / Path(f).name) # save to dataset-hub - - def get_json(self, save=False, verbose=False): - """Return dataset JSON for Ultralytics HUB.""" - - def _round(labels): - """Update labels to integer class and 4 decimal place floats.""" - if self.task == "detect": - coordinates = labels["bboxes"] - elif self.task == "segment": - coordinates = [x.flatten() for x in labels["segments"]] - elif self.task == "pose": - n = labels["keypoints"].shape[0] - coordinates = np.concatenate((labels["bboxes"], labels["keypoints"].reshape(n, -1)), 1) - else: - raise ValueError("Undefined dataset task.") - zipped = zip(labels["cls"], coordinates) - return [[int(c[0]), *(round(float(x), 4) for x in points)] for c, points in zipped] - - for split in "train", "val", "test": - self.stats[split] = None # predefine - path = self.data.get(split) - - # Check split - if path is None: # no split - continue - files = [f for f in Path(path).rglob("*.*") if f.suffix[1:].lower() in IMG_FORMATS] # image files in split - if not files: # no images - continue - - # Get dataset statistics - if self.task == "classify": - from torchvision.datasets import ImageFolder - - dataset = ImageFolder(self.data[split]) - - x = np.zeros(len(dataset.classes)).astype(int) - for im in dataset.imgs: - x[im[1]] += 1 - - self.stats[split] = { - "instance_stats": {"total": len(dataset), "per_class": x.tolist()}, - "image_stats": {"total": len(dataset), "unlabelled": 0, "per_class": x.tolist()}, - "labels": [{Path(k).name: v} for k, v in dataset.imgs], - } - else: - from ultralytics.data import YOLODataset - - dataset = YOLODataset(img_path=self.data[split], data=self.data, task=self.task) - x = np.array( - [ - np.bincount(label["cls"].astype(int).flatten(), minlength=self.data["nc"]) - for label in TQDM(dataset.labels, total=len(dataset), desc="Statistics") - ] - ) # shape(128x80) - self.stats[split] = { - "instance_stats": {"total": int(x.sum()), "per_class": x.sum(0).tolist()}, - "image_stats": { - "total": len(dataset), - "unlabelled": int(np.all(x == 0, 1).sum()), - "per_class": (x > 0).sum(0).tolist(), - }, - "labels": [{Path(k).name: _round(v)} for k, v in zip(dataset.im_files, dataset.labels)], - } - - # Save, print and return - if save: - self.hub_dir.mkdir(parents=True, exist_ok=True) # makes dataset-hub/ - stats_path = self.hub_dir / "stats.json" - LOGGER.info(f"Saving {stats_path.resolve()}...") - with open(stats_path, "w") as f: - json.dump(self.stats, f) # save stats.json - if verbose: - LOGGER.info(json.dumps(self.stats, indent=2, sort_keys=False)) - return self.stats - - def process_images(self): - """Compress images for Ultralytics HUB.""" - from ultralytics.data import YOLODataset # ClassificationDataset - - self.im_dir.mkdir(parents=True, exist_ok=True) # makes dataset-hub/images/ - for split in "train", "val", "test": - if self.data.get(split) is None: - continue - dataset = YOLODataset(img_path=self.data[split], data=self.data) - with ThreadPool(NUM_THREADS) as pool: - for _ in TQDM(pool.imap(self._hub_ops, dataset.im_files), total=len(dataset), desc=f"{split} images"): - pass - LOGGER.info(f"Done. All images saved to {self.im_dir}") - return self.im_dir - - -def compress_one_image(f, f_new=None, max_dim=1920, quality=50): - """ - Compresses a single image file to reduced size while preserving its aspect ratio and quality using either the Python - Imaging Library (PIL) or OpenCV library. If the input image is smaller than the maximum dimension, it will not be - resized. - - Args: - f (str): The path to the input image file. - f_new (str, optional): The path to the output image file. If not specified, the input file will be overwritten. - max_dim (int, optional): The maximum dimension (width or height) of the output image. Default is 1920 pixels. - quality (int, optional): The image compression quality as a percentage. Default is 50%. - - Example: - ```python - from pathlib import Path - from ultralytics.data.utils import compress_one_image - - for f in Path('path/to/dataset').rglob('*.jpg'): - compress_one_image(f) - ``` - """ - - try: # use PIL - im = Image.open(f) - r = max_dim / max(im.height, im.width) # ratio - if r < 1.0: # image too large - im = im.resize((int(im.width * r), int(im.height * r))) - im.save(f_new or f, "JPEG", quality=quality, optimize=True) # save - except Exception as e: # use OpenCV - LOGGER.info(f"WARNING ⚠️ HUB ops PIL failure {f}: {e}") - im = cv2.imread(f) - im_height, im_width = im.shape[:2] - r = max_dim / max(im_height, im_width) # ratio - if r < 1.0: # image too large - im = cv2.resize(im, (int(im_width * r), int(im_height * r)), interpolation=cv2.INTER_AREA) - cv2.imwrite(str(f_new or f), im) - - -def autosplit(path=DATASETS_DIR / "coco8/images", weights=(0.9, 0.1, 0.0), annotated_only=False): - """ - Automatically split a dataset into train/val/test splits and save the resulting splits into autosplit_*.txt files. - - Args: - path (Path, optional): Path to images directory. Defaults to DATASETS_DIR / 'coco8/images'. - weights (list | tuple, optional): Train, validation, and test split fractions. Defaults to (0.9, 0.1, 0.0). - annotated_only (bool, optional): If True, only images with an associated txt file are used. Defaults to False. - - Example: - ```python - from ultralytics.data.utils import autosplit - - autosplit() - ``` - """ - - path = Path(path) # images dir - files = sorted(x for x in path.rglob("*.*") if x.suffix[1:].lower() in IMG_FORMATS) # image files only - n = len(files) # number of files - random.seed(0) # for reproducibility - indices = random.choices([0, 1, 2], weights=weights, k=n) # assign each image to a split - - txt = ["autosplit_train.txt", "autosplit_val.txt", "autosplit_test.txt"] # 3 txt files - for x in txt: - if (path.parent / x).exists(): - (path.parent / x).unlink() # remove existing - - LOGGER.info(f"Autosplitting images from {path}" + ", using *.txt labeled images only" * annotated_only) - for i, img in TQDM(zip(indices, files), total=n): - if not annotated_only or Path(img2label_paths([str(img)])[0]).exists(): # check label - with open(path.parent / txt[i], "a") as f: - f.write(f"./{img.relative_to(path.parent).as_posix()}" + "\n") # add image to txt file diff --git a/ultralytics-main/ultralytics/engine/__init__.py b/ultralytics-main/ultralytics/engine/__init__.py deleted file mode 100644 index 9e68dc1..0000000 --- a/ultralytics-main/ultralytics/engine/__init__.py +++ /dev/null @@ -1 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license diff --git a/ultralytics-main/ultralytics/engine/exporter.py b/ultralytics-main/ultralytics/engine/exporter.py deleted file mode 100644 index 859106a..0000000 --- a/ultralytics-main/ultralytics/engine/exporter.py +++ /dev/null @@ -1,1141 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -""" -Export a YOLOv8 PyTorch model to other formats. TensorFlow exports authored by https://github.com/zldrobit - -Format | `format=argument` | Model ---- | --- | --- -PyTorch | - | yolov8n.pt -TorchScript | `torchscript` | yolov8n.torchscript -ONNX | `onnx` | yolov8n.onnx -OpenVINO | `openvino` | yolov8n_openvino_model/ -TensorRT | `engine` | yolov8n.engine -CoreML | `coreml` | yolov8n.mlpackage -TensorFlow SavedModel | `saved_model` | yolov8n_saved_model/ -TensorFlow GraphDef | `pb` | yolov8n.pb -TensorFlow Lite | `tflite` | yolov8n.tflite -TensorFlow Edge TPU | `edgetpu` | yolov8n_edgetpu.tflite -TensorFlow.js | `tfjs` | yolov8n_web_model/ -PaddlePaddle | `paddle` | yolov8n_paddle_model/ -NCNN | `ncnn` | yolov8n_ncnn_model/ - -Requirements: - $ pip install "ultralytics[export]" - -Python: - from ultralytics import YOLO - model = YOLO('yolov8n.pt') - results = model.export(format='onnx') - -CLI: - $ yolo mode=export model=yolov8n.pt format=onnx - -Inference: - $ yolo predict model=yolov8n.pt # PyTorch - yolov8n.torchscript # TorchScript - yolov8n.onnx # ONNX Runtime or OpenCV DNN with dnn=True - yolov8n_openvino_model # OpenVINO - yolov8n.engine # TensorRT - yolov8n.mlpackage # CoreML (macOS-only) - yolov8n_saved_model # TensorFlow SavedModel - yolov8n.pb # TensorFlow GraphDef - yolov8n.tflite # TensorFlow Lite - yolov8n_edgetpu.tflite # TensorFlow Edge TPU - yolov8n_paddle_model # PaddlePaddle - yolov8n_ncnn_model # NCNN - -TensorFlow.js: - $ cd .. && git clone https://github.com/zldrobit/tfjs-yolov5-example.git && cd tfjs-yolov5-example - $ npm install - $ ln -s ../../yolov5/yolov8n_web_model public/yolov8n_web_model - $ npm start -""" - -import json -import os -import shutil -import subprocess -import time -import warnings -from copy import deepcopy -from datetime import datetime -from pathlib import Path - -import numpy as np -import torch - -from ultralytics.cfg import get_cfg -from ultralytics.data.dataset import YOLODataset -from ultralytics.data.utils import check_det_dataset -from ultralytics.nn.autobackend import check_class_names, default_class_names -from ultralytics.nn.modules import C2f, Detect, RTDETRDecoder -from ultralytics.nn.tasks import DetectionModel, SegmentationModel, WorldModel -from ultralytics.utils import ( - ARM64, - DEFAULT_CFG, - LINUX, - LOGGER, - MACOS, - ROOT, - WINDOWS, - __version__, - callbacks, - colorstr, - get_default_args, - yaml_save, -) -from ultralytics.utils.checks import PYTHON_VERSION, check_imgsz, check_is_path_safe, check_requirements, check_version -from ultralytics.utils.downloads import attempt_download_asset, get_github_assets -from ultralytics.utils.files import file_size, spaces_in_path -from ultralytics.utils.ops import Profile -from ultralytics.utils.torch_utils import TORCH_1_13, get_latest_opset, select_device, smart_inference_mode - - -def export_formats(): - """YOLOv8 export formats.""" - import pandas - - x = [ - ["PyTorch", "-", ".pt", True, True], - ["TorchScript", "torchscript", ".torchscript", True, True], - ["ONNX", "onnx", ".onnx", True, True], - ["OpenVINO", "openvino", "_openvino_model", True, False], - ["TensorRT", "engine", ".engine", False, True], - ["CoreML", "coreml", ".mlpackage", True, False], - ["TensorFlow SavedModel", "saved_model", "_saved_model", True, True], - ["TensorFlow GraphDef", "pb", ".pb", True, True], - ["TensorFlow Lite", "tflite", ".tflite", True, False], - ["TensorFlow Edge TPU", "edgetpu", "_edgetpu.tflite", True, False], - ["TensorFlow.js", "tfjs", "_web_model", True, False], - ["PaddlePaddle", "paddle", "_paddle_model", True, True], - ["NCNN", "ncnn", "_ncnn_model", True, True], - ] - return pandas.DataFrame(x, columns=["Format", "Argument", "Suffix", "CPU", "GPU"]) - - -def gd_outputs(gd): - """TensorFlow GraphDef model output node names.""" - name_list, input_list = [], [] - for node in gd.node: # tensorflow.core.framework.node_def_pb2.NodeDef - name_list.append(node.name) - input_list.extend(node.input) - return sorted(f"{x}:0" for x in list(set(name_list) - set(input_list)) if not x.startswith("NoOp")) - - -def try_export(inner_func): - """YOLOv8 export decorator, i..e @try_export.""" - inner_args = get_default_args(inner_func) - - def outer_func(*args, **kwargs): - """Export a model.""" - prefix = inner_args["prefix"] - try: - with Profile() as dt: - f, model = inner_func(*args, **kwargs) - LOGGER.info(f"{prefix} export success ✅ {dt.t:.1f}s, saved as '{f}' ({file_size(f):.1f} MB)") - return f, model - except Exception as e: - LOGGER.info(f"{prefix} export failure ❌ {dt.t:.1f}s: {e}") - raise e - - return outer_func - - -class Exporter: - """ - A class for exporting a model. - - Attributes: - args (SimpleNamespace): Configuration for the exporter. - callbacks (list, optional): List of callback functions. Defaults to None. - """ - - def __init__(self, cfg=DEFAULT_CFG, overrides=None, _callbacks=None): - """ - Initializes the Exporter class. - - Args: - cfg (str, optional): Path to a configuration file. Defaults to DEFAULT_CFG. - overrides (dict, optional): Configuration overrides. Defaults to None. - _callbacks (dict, optional): Dictionary of callback functions. Defaults to None. - """ - self.args = get_cfg(cfg, overrides) - if self.args.format.lower() in ("coreml", "mlmodel"): # fix attempt for protobuf<3.20.x errors - os.environ["PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION"] = "python" # must run before TensorBoard callback - - self.callbacks = _callbacks or callbacks.get_default_callbacks() - callbacks.add_integration_callbacks(self) - - @smart_inference_mode() - def __call__(self, model=None): - """Returns list of exported files/dirs after running callbacks.""" - self.run_callbacks("on_export_start") - t = time.time() - fmt = self.args.format.lower() # to lowercase - if fmt in ("tensorrt", "trt"): # 'engine' aliases - fmt = "engine" - if fmt in ("mlmodel", "mlpackage", "mlprogram", "apple", "ios", "coreml"): # 'coreml' aliases - fmt = "coreml" - fmts = tuple(export_formats()["Argument"][1:]) # available export formats - flags = [x == fmt for x in fmts] - if sum(flags) != 1: - raise ValueError(f"Invalid export format='{fmt}'. Valid formats are {fmts}") - jit, onnx, xml, engine, coreml, saved_model, pb, tflite, edgetpu, tfjs, paddle, ncnn = flags # export booleans - - # Device - if fmt == "engine" and self.args.device is None: - LOGGER.warning("WARNING ⚠️ TensorRT requires GPU export, automatically assigning device=0") - self.args.device = "0" - self.device = select_device("cpu" if self.args.device is None else self.args.device) - - # Checks - if not hasattr(model, "names"): - model.names = default_class_names() - model.names = check_class_names(model.names) - if self.args.half and onnx and self.device.type == "cpu": - LOGGER.warning("WARNING ⚠️ half=True only compatible with GPU export, i.e. use device=0") - self.args.half = False - assert not self.args.dynamic, "half=True not compatible with dynamic=True, i.e. use only one." - self.imgsz = check_imgsz(self.args.imgsz, stride=model.stride, min_dim=2) # check image size - if self.args.optimize: - assert not ncnn, "optimize=True not compatible with format='ncnn', i.e. use optimize=False" - assert self.device.type == "cpu", "optimize=True not compatible with cuda devices, i.e. use device='cpu'" - if edgetpu and not LINUX: - raise SystemError("Edge TPU export only supported on Linux. See https://coral.ai/docs/edgetpu/compiler/") - if isinstance(model, WorldModel): - LOGGER.warning( - "WARNING ⚠️ YOLOWorld (original version) export is not supported to any format.\n" - "WARNING ⚠️ YOLOWorldv2 models (i.e. 'yolov8s-worldv2.pt') only support export to " - "(torchscript, onnx, openvino, engine, coreml) formats. " - "See https://docs.ultralytics.com/models/yolo-world for details." - ) - - # Input - im = torch.zeros(self.args.batch, 3, *self.imgsz).to(self.device) - file = Path( - getattr(model, "pt_path", None) or getattr(model, "yaml_file", None) or model.yaml.get("yaml_file", "") - ) - if file.suffix in {".yaml", ".yml"}: - file = Path(file.name) - - # Update model - model = deepcopy(model).to(self.device) - for p in model.parameters(): - p.requires_grad = False - model.eval() - model.float() - model = model.fuse() - for m in model.modules(): - if isinstance(m, (Detect, RTDETRDecoder)): # includes all Detect subclasses like Segment, Pose, OBB - m.dynamic = self.args.dynamic - m.export = True - m.format = self.args.format - elif isinstance(m, C2f) and not any((saved_model, pb, tflite, edgetpu, tfjs)): - # EdgeTPU does not support FlexSplitV while split provides cleaner ONNX graph - m.forward = m.forward_split - - y = None - for _ in range(2): - y = model(im) # dry runs - if self.args.half and onnx and self.device.type != "cpu": - im, model = im.half(), model.half() # to FP16 - - # Filter warnings - warnings.filterwarnings("ignore", category=torch.jit.TracerWarning) # suppress TracerWarning - warnings.filterwarnings("ignore", category=UserWarning) # suppress shape prim::Constant missing ONNX warning - warnings.filterwarnings("ignore", category=DeprecationWarning) # suppress CoreML np.bool deprecation warning - - # Assign - self.im = im - self.model = model - self.file = file - self.output_shape = ( - tuple(y.shape) - if isinstance(y, torch.Tensor) - else tuple(tuple(x.shape if isinstance(x, torch.Tensor) else []) for x in y) - ) - self.pretty_name = Path(self.model.yaml.get("yaml_file", self.file)).stem.replace("yolo", "YOLO") - data = model.args["data"] if hasattr(model, "args") and isinstance(model.args, dict) else "" - description = f'Ultralytics {self.pretty_name} model {f"trained on {data}" if data else ""}' - self.metadata = { - "description": description, - "author": "Ultralytics", - "date": datetime.now().isoformat(), - "version": __version__, - "license": "AGPL-3.0 License (https://ultralytics.com/license)", - "docs": "https://docs.ultralytics.com", - "stride": int(max(model.stride)), - "task": model.task, - "batch": self.args.batch, - "imgsz": self.imgsz, - "names": model.names, - } # model metadata - if model.task == "pose": - self.metadata["kpt_shape"] = model.model[-1].kpt_shape - - LOGGER.info( - f"\n{colorstr('PyTorch:')} starting from '{file}' with input shape {tuple(im.shape)} BCHW and " - f'output shape(s) {self.output_shape} ({file_size(file):.1f} MB)' - ) - - # Exports - f = [""] * len(fmts) # exported filenames - if jit or ncnn: # TorchScript - f[0], _ = self.export_torchscript() - if engine: # TensorRT required before ONNX - f[1], _ = self.export_engine() - if onnx: # ONNX - f[2], _ = self.export_onnx() - if xml: # OpenVINO - f[3], _ = self.export_openvino() - if coreml: # CoreML - f[4], _ = self.export_coreml() - if any((saved_model, pb, tflite, edgetpu, tfjs)): # TensorFlow formats - self.args.int8 |= edgetpu - f[5], keras_model = self.export_saved_model() - if pb or tfjs: # pb prerequisite to tfjs - f[6], _ = self.export_pb(keras_model=keras_model) - if tflite: - f[7], _ = self.export_tflite(keras_model=keras_model, nms=False, agnostic_nms=self.args.agnostic_nms) - if edgetpu: - f[8], _ = self.export_edgetpu(tflite_model=Path(f[5]) / f"{self.file.stem}_full_integer_quant.tflite") - if tfjs: - f[9], _ = self.export_tfjs() - if paddle: # PaddlePaddle - f[10], _ = self.export_paddle() - if ncnn: # NCNN - f[11], _ = self.export_ncnn() - - # Finish - f = [str(x) for x in f if x] # filter out '' and None - if any(f): - f = str(Path(f[-1])) - square = self.imgsz[0] == self.imgsz[1] - s = ( - "" - if square - else f"WARNING ⚠️ non-PyTorch val requires square images, 'imgsz={self.imgsz}' will not " - f"work. Use export 'imgsz={max(self.imgsz)}' if val is required." - ) - imgsz = self.imgsz[0] if square else str(self.imgsz)[1:-1].replace(" ", "") - predict_data = f"data={data}" if model.task == "segment" and fmt == "pb" else "" - q = "int8" if self.args.int8 else "half" if self.args.half else "" # quantization - LOGGER.info( - f'\nExport complete ({time.time() - t:.1f}s)' - f"\nResults saved to {colorstr('bold', file.parent.resolve())}" - f'\nPredict: yolo predict task={model.task} model={f} imgsz={imgsz} {q} {predict_data}' - f'\nValidate: yolo val task={model.task} model={f} imgsz={imgsz} data={data} {q} {s}' - f'\nVisualize: https://netron.app' - ) - - self.run_callbacks("on_export_end") - return f # return list of exported files/dirs - - @try_export - def export_torchscript(self, prefix=colorstr("TorchScript:")): - """YOLOv8 TorchScript model export.""" - LOGGER.info(f"\n{prefix} starting export with torch {torch.__version__}...") - f = self.file.with_suffix(".torchscript") - - ts = torch.jit.trace(self.model, self.im, strict=False) - extra_files = {"config.txt": json.dumps(self.metadata)} # torch._C.ExtraFilesMap() - if self.args.optimize: # https://pytorch.org/tutorials/recipes/mobile_interpreter.html - LOGGER.info(f"{prefix} optimizing for mobile...") - from torch.utils.mobile_optimizer import optimize_for_mobile - - optimize_for_mobile(ts)._save_for_lite_interpreter(str(f), _extra_files=extra_files) - else: - ts.save(str(f), _extra_files=extra_files) - return f, None - - @try_export - def export_onnx(self, prefix=colorstr("ONNX:")): - """YOLOv8 ONNX export.""" - requirements = ["onnx>=1.12.0"] - if self.args.simplify: - requirements += ["onnxsim>=0.4.33", "onnxruntime-gpu" if torch.cuda.is_available() else "onnxruntime"] - if ARM64: - check_requirements("cmake") # 'cmake' is needed to build onnxsim on aarch64 - check_requirements(requirements) - import onnx # noqa - - opset_version = self.args.opset or get_latest_opset() - LOGGER.info(f"\n{prefix} starting export with onnx {onnx.__version__} opset {opset_version}...") - f = str(self.file.with_suffix(".onnx")) - - output_names = ["output0", "output1"] if isinstance(self.model, SegmentationModel) else ["output0"] - dynamic = self.args.dynamic - if dynamic: - dynamic = {"images": {0: "batch", 2: "height", 3: "width"}} # shape(1,3,640,640) - if isinstance(self.model, SegmentationModel): - dynamic["output0"] = {0: "batch", 2: "anchors"} # shape(1, 116, 8400) - dynamic["output1"] = {0: "batch", 2: "mask_height", 3: "mask_width"} # shape(1,32,160,160) - elif isinstance(self.model, DetectionModel): - dynamic["output0"] = {0: "batch", 2: "anchors"} # shape(1, 84, 8400) - - torch.onnx.export( - self.model.cpu() if dynamic else self.model, # dynamic=True only compatible with cpu - self.im.cpu() if dynamic else self.im, - f, - verbose=False, - opset_version=opset_version, - do_constant_folding=True, # WARNING: DNN inference with torch>=1.12 may require do_constant_folding=False - input_names=["images"], - output_names=output_names, - dynamic_axes=dynamic or None, - ) - - # Checks - model_onnx = onnx.load(f) # load onnx model - # onnx.checker.check_model(model_onnx) # check onnx model - - # Simplify - if self.args.simplify: - try: - import onnxsim - - LOGGER.info(f"{prefix} simplifying with onnxsim {onnxsim.__version__}...") - # subprocess.run(f'onnxsim "{f}" "{f}"', shell=True) - model_onnx, check = onnxsim.simplify(model_onnx) - assert check, "Simplified ONNX model could not be validated" - except Exception as e: - LOGGER.info(f"{prefix} simplifier failure: {e}") - - # Metadata - for k, v in self.metadata.items(): - meta = model_onnx.metadata_props.add() - meta.key, meta.value = k, str(v) - - onnx.save(model_onnx, f) - return f, model_onnx - - @try_export - def export_openvino(self, prefix=colorstr("OpenVINO:")): - """YOLOv8 OpenVINO export.""" - check_requirements("openvino>=2024.0.0") # requires openvino: https://pypi.org/project/openvino/ - import openvino as ov - - LOGGER.info(f"\n{prefix} starting export with openvino {ov.__version__}...") - assert TORCH_1_13, f"OpenVINO export requires torch>=1.13.0 but torch=={torch.__version__} is installed" - ov_model = ov.convert_model( - self.model.cpu(), - input=None if self.args.dynamic else [self.im.shape], - example_input=self.im, - ) - - def serialize(ov_model, file): - """Set RT info, serialize and save metadata YAML.""" - ov_model.set_rt_info("YOLOv8", ["model_info", "model_type"]) - ov_model.set_rt_info(True, ["model_info", "reverse_input_channels"]) - ov_model.set_rt_info(114, ["model_info", "pad_value"]) - ov_model.set_rt_info([255.0], ["model_info", "scale_values"]) - ov_model.set_rt_info(self.args.iou, ["model_info", "iou_threshold"]) - ov_model.set_rt_info([v.replace(" ", "_") for v in self.model.names.values()], ["model_info", "labels"]) - if self.model.task != "classify": - ov_model.set_rt_info("fit_to_window_letterbox", ["model_info", "resize_type"]) - - ov.runtime.save_model(ov_model, file, compress_to_fp16=self.args.half) - yaml_save(Path(file).parent / "metadata.yaml", self.metadata) # add metadata.yaml - - if self.args.int8: - fq = str(self.file).replace(self.file.suffix, f"_int8_openvino_model{os.sep}") - fq_ov = str(Path(fq) / self.file.with_suffix(".xml").name) - if not self.args.data: - self.args.data = DEFAULT_CFG.data or "coco128.yaml" - LOGGER.warning( - f"{prefix} WARNING ⚠️ INT8 export requires a missing 'data' arg for calibration. " - f"Using default 'data={self.args.data}'." - ) - check_requirements("nncf>=2.8.0") - import nncf - - def transform_fn(data_item): - """Quantization transform function.""" - assert ( - data_item["img"].dtype == torch.uint8 - ), "Input image must be uint8 for the quantization preprocessing" - im = data_item["img"].numpy().astype(np.float32) / 255.0 # uint8 to fp16/32 and 0 - 255 to 0.0 - 1.0 - return np.expand_dims(im, 0) if im.ndim == 3 else im - - # Generate calibration data for integer quantization - LOGGER.info(f"{prefix} collecting INT8 calibration images from 'data={self.args.data}'") - data = check_det_dataset(self.args.data) - dataset = YOLODataset(data["val"], data=data, imgsz=self.imgsz[0], augment=False) - n = len(dataset) - if n < 300: - LOGGER.warning(f"{prefix} WARNING ⚠️ >300 images recommended for INT8 calibration, found {n} images.") - quantization_dataset = nncf.Dataset(dataset, transform_fn) - - ignored_scope = None - if isinstance(self.model.model[-1], Detect): - # Includes all Detect subclasses like Segment, Pose, OBB, WorldDetect - head_module_name = ".".join(list(self.model.named_modules())[-1][0].split(".")[:2]) - - ignored_scope = nncf.IgnoredScope( # ignore operations - patterns=[ - f".*{head_module_name}/.*/Add", - f".*{head_module_name}/.*/Sub*", - f".*{head_module_name}/.*/Mul*", - f".*{head_module_name}/.*/Div*", - f".*{head_module_name}\\.dfl.*", - ], - types=["Sigmoid"], - ) - - quantized_ov_model = nncf.quantize( - ov_model, quantization_dataset, preset=nncf.QuantizationPreset.MIXED, ignored_scope=ignored_scope - ) - serialize(quantized_ov_model, fq_ov) - return fq, None - - f = str(self.file).replace(self.file.suffix, f"_openvino_model{os.sep}") - f_ov = str(Path(f) / self.file.with_suffix(".xml").name) - - serialize(ov_model, f_ov) - return f, None - - @try_export - def export_paddle(self, prefix=colorstr("PaddlePaddle:")): - """YOLOv8 Paddle export.""" - check_requirements(("paddlepaddle", "x2paddle")) - import x2paddle # noqa - from x2paddle.convert import pytorch2paddle # noqa - - LOGGER.info(f"\n{prefix} starting export with X2Paddle {x2paddle.__version__}...") - f = str(self.file).replace(self.file.suffix, f"_paddle_model{os.sep}") - - pytorch2paddle(module=self.model, save_dir=f, jit_type="trace", input_examples=[self.im]) # export - yaml_save(Path(f) / "metadata.yaml", self.metadata) # add metadata.yaml - return f, None - - @try_export - def export_ncnn(self, prefix=colorstr("NCNN:")): - """ - YOLOv8 NCNN export using PNNX https://github.com/pnnx/pnnx. - """ - check_requirements("ncnn") - import ncnn # noqa - - LOGGER.info(f"\n{prefix} starting export with NCNN {ncnn.__version__}...") - f = Path(str(self.file).replace(self.file.suffix, f"_ncnn_model{os.sep}")) - f_ts = self.file.with_suffix(".torchscript") - - name = Path("pnnx.exe" if WINDOWS else "pnnx") # PNNX filename - pnnx = name if name.is_file() else ROOT / name - if not pnnx.is_file(): - LOGGER.warning( - f"{prefix} WARNING ⚠️ PNNX not found. Attempting to download binary file from " - "https://github.com/pnnx/pnnx/.\nNote PNNX Binary file must be placed in current working directory " - f"or in {ROOT}. See PNNX repo for full installation instructions." - ) - system = "macos" if MACOS else "windows" if WINDOWS else "linux-aarch64" if ARM64 else "linux" - _, assets = get_github_assets(repo="pnnx/pnnx", retry=True) - if assets: - url = [x for x in assets if f"{system}.zip" in x][0] - else: - url = f"https://github.com/pnnx/pnnx/releases/download/20240226/pnnx-20240226-{system}.zip" - LOGGER.warning(f"{prefix} WARNING ⚠️ PNNX GitHub assets not found, using default {url}") - asset = attempt_download_asset(url, repo="pnnx/pnnx", release="latest") - if check_is_path_safe(Path.cwd(), asset): # avoid path traversal security vulnerability - unzip_dir = Path(asset).with_suffix("") - (unzip_dir / name).rename(pnnx) # move binary to ROOT - shutil.rmtree(unzip_dir) # delete unzip dir - Path(asset).unlink() # delete zip - pnnx.chmod(0o777) # set read, write, and execute permissions for everyone - - ncnn_args = [ - f'ncnnparam={f / "model.ncnn.param"}', - f'ncnnbin={f / "model.ncnn.bin"}', - f'ncnnpy={f / "model_ncnn.py"}', - ] - - pnnx_args = [ - f'pnnxparam={f / "model.pnnx.param"}', - f'pnnxbin={f / "model.pnnx.bin"}', - f'pnnxpy={f / "model_pnnx.py"}', - f'pnnxonnx={f / "model.pnnx.onnx"}', - ] - - cmd = [ - str(pnnx), - str(f_ts), - *ncnn_args, - *pnnx_args, - f"fp16={int(self.args.half)}", - f"device={self.device.type}", - f'inputshape="{[self.args.batch, 3, *self.imgsz]}"', - ] - f.mkdir(exist_ok=True) # make ncnn_model directory - LOGGER.info(f"{prefix} running '{' '.join(cmd)}'") - subprocess.run(cmd, check=True) - - # Remove debug files - pnnx_files = [x.split("=")[-1] for x in pnnx_args] - for f_debug in ("debug.bin", "debug.param", "debug2.bin", "debug2.param", *pnnx_files): - Path(f_debug).unlink(missing_ok=True) - - yaml_save(f / "metadata.yaml", self.metadata) # add metadata.yaml - return str(f), None - - @try_export - def export_coreml(self, prefix=colorstr("CoreML:")): - """YOLOv8 CoreML export.""" - mlmodel = self.args.format.lower() == "mlmodel" # legacy *.mlmodel export format requested - check_requirements("coremltools>=6.0,<=6.2" if mlmodel else "coremltools>=7.0") - import coremltools as ct # noqa - - LOGGER.info(f"\n{prefix} starting export with coremltools {ct.__version__}...") - assert not WINDOWS, "CoreML export is not supported on Windows, please run on macOS or Linux." - f = self.file.with_suffix(".mlmodel" if mlmodel else ".mlpackage") - if f.is_dir(): - shutil.rmtree(f) - - bias = [0.0, 0.0, 0.0] - scale = 1 / 255 - classifier_config = None - if self.model.task == "classify": - classifier_config = ct.ClassifierConfig(list(self.model.names.values())) if self.args.nms else None - model = self.model - elif self.model.task == "detect": - model = IOSDetectModel(self.model, self.im) if self.args.nms else self.model - else: - if self.args.nms: - LOGGER.warning(f"{prefix} WARNING ⚠️ 'nms=True' is only available for Detect models like 'yolov8n.pt'.") - # TODO CoreML Segment and Pose model pipelining - model = self.model - - ts = torch.jit.trace(model.eval(), self.im, strict=False) # TorchScript model - ct_model = ct.convert( - ts, - inputs=[ct.ImageType("image", shape=self.im.shape, scale=scale, bias=bias)], - classifier_config=classifier_config, - convert_to="neuralnetwork" if mlmodel else "mlprogram", - ) - bits, mode = (8, "kmeans") if self.args.int8 else (16, "linear") if self.args.half else (32, None) - if bits < 32: - if "kmeans" in mode: - check_requirements("scikit-learn") # scikit-learn package required for k-means quantization - if mlmodel: - ct_model = ct.models.neural_network.quantization_utils.quantize_weights(ct_model, bits, mode) - elif bits == 8: # mlprogram already quantized to FP16 - import coremltools.optimize.coreml as cto - - op_config = cto.OpPalettizerConfig(mode="kmeans", nbits=bits, weight_threshold=512) - config = cto.OptimizationConfig(global_config=op_config) - ct_model = cto.palettize_weights(ct_model, config=config) - if self.args.nms and self.model.task == "detect": - if mlmodel: - # coremltools<=6.2 NMS export requires Python<3.11 - check_version(PYTHON_VERSION, "<3.11", name="Python ", hard=True) - weights_dir = None - else: - ct_model.save(str(f)) # save otherwise weights_dir does not exist - weights_dir = str(f / "Data/com.apple.CoreML/weights") - ct_model = self._pipeline_coreml(ct_model, weights_dir=weights_dir) - - m = self.metadata # metadata dict - ct_model.short_description = m.pop("description") - ct_model.author = m.pop("author") - ct_model.license = m.pop("license") - ct_model.version = m.pop("version") - ct_model.user_defined_metadata.update({k: str(v) for k, v in m.items()}) - try: - ct_model.save(str(f)) # save *.mlpackage - except Exception as e: - LOGGER.warning( - f"{prefix} WARNING ⚠️ CoreML export to *.mlpackage failed ({e}), reverting to *.mlmodel export. " - f"Known coremltools Python 3.11 and Windows bugs https://github.com/apple/coremltools/issues/1928." - ) - f = f.with_suffix(".mlmodel") - ct_model.save(str(f)) - return f, ct_model - - @try_export - def export_engine(self, prefix=colorstr("TensorRT:")): - """YOLOv8 TensorRT export https://developer.nvidia.com/tensorrt.""" - assert self.im.device.type != "cpu", "export running on CPU but must be on GPU, i.e. use 'device=0'" - f_onnx, _ = self.export_onnx() # run before trt import https://github.com/ultralytics/ultralytics/issues/7016 - - try: - import tensorrt as trt # noqa - except ImportError: - if LINUX: - check_requirements("nvidia-tensorrt", cmds="-U --index-url https://pypi.ngc.nvidia.com") - import tensorrt as trt # noqa - - check_version(trt.__version__, "7.0.0", hard=True) # require tensorrt>=7.0.0 - - self.args.simplify = True - - LOGGER.info(f"\n{prefix} starting export with TensorRT {trt.__version__}...") - assert Path(f_onnx).exists(), f"failed to export ONNX file: {f_onnx}" - f = self.file.with_suffix(".engine") # TensorRT engine file - logger = trt.Logger(trt.Logger.INFO) - if self.args.verbose: - logger.min_severity = trt.Logger.Severity.VERBOSE - - builder = trt.Builder(logger) - config = builder.create_builder_config() - config.max_workspace_size = self.args.workspace * 1 << 30 - # config.set_memory_pool_limit(trt.MemoryPoolType.WORKSPACE, workspace << 30) # fix TRT 8.4 deprecation notice - - flag = 1 << int(trt.NetworkDefinitionCreationFlag.EXPLICIT_BATCH) - network = builder.create_network(flag) - parser = trt.OnnxParser(network, logger) - if not parser.parse_from_file(f_onnx): - raise RuntimeError(f"failed to load ONNX file: {f_onnx}") - - inputs = [network.get_input(i) for i in range(network.num_inputs)] - outputs = [network.get_output(i) for i in range(network.num_outputs)] - for inp in inputs: - LOGGER.info(f'{prefix} input "{inp.name}" with shape{inp.shape} {inp.dtype}') - for out in outputs: - LOGGER.info(f'{prefix} output "{out.name}" with shape{out.shape} {out.dtype}') - - if self.args.dynamic: - shape = self.im.shape - if shape[0] <= 1: - LOGGER.warning(f"{prefix} WARNING ⚠️ 'dynamic=True' model requires max batch size, i.e. 'batch=16'") - profile = builder.create_optimization_profile() - for inp in inputs: - profile.set_shape(inp.name, (1, *shape[1:]), (max(1, shape[0] // 2), *shape[1:]), shape) - config.add_optimization_profile(profile) - - LOGGER.info( - f"{prefix} building FP{16 if builder.platform_has_fast_fp16 and self.args.half else 32} engine as {f}" - ) - if builder.platform_has_fast_fp16 and self.args.half: - config.set_flag(trt.BuilderFlag.FP16) - - del self.model - torch.cuda.empty_cache() - - # Write file - with builder.build_engine(network, config) as engine, open(f, "wb") as t: - # Metadata - meta = json.dumps(self.metadata) - t.write(len(meta).to_bytes(4, byteorder="little", signed=True)) - t.write(meta.encode()) - # Model - t.write(engine.serialize()) - - return f, None - - @try_export - def export_saved_model(self, prefix=colorstr("TensorFlow SavedModel:")): - """YOLOv8 TensorFlow SavedModel export.""" - cuda = torch.cuda.is_available() - try: - import tensorflow as tf # noqa - except ImportError: - suffix = "-macos" if MACOS else "-aarch64" if ARM64 else "" if cuda else "-cpu" - version = "" if ARM64 else "<=2.13.1" - check_requirements(f"tensorflow{suffix}{version}") - import tensorflow as tf # noqa - if ARM64: - check_requirements("cmake") # 'cmake' is needed to build onnxsim on aarch64 - check_requirements( - ( - "onnx>=1.12.0", - "onnx2tf>=1.15.4,<=1.17.5", - "sng4onnx>=1.0.1", - "onnxsim>=0.4.33", - "onnx_graphsurgeon>=0.3.26", - "tflite_support", - "flatbuffers>=23.5.26,<100", # update old 'flatbuffers' included inside tensorflow package - "onnxruntime-gpu" if cuda else "onnxruntime", - ), - cmds="--extra-index-url https://pypi.ngc.nvidia.com", - ) # onnx_graphsurgeon only on NVIDIA - - LOGGER.info(f"\n{prefix} starting export with tensorflow {tf.__version__}...") - check_version( - tf.__version__, - "<=2.13.1", - name="tensorflow", - verbose=True, - msg="https://github.com/ultralytics/ultralytics/issues/5161", - ) - import onnx2tf - - f = Path(str(self.file).replace(self.file.suffix, "_saved_model")) - if f.is_dir(): - shutil.rmtree(f) # delete output folder - - # Pre-download calibration file to fix https://github.com/PINTO0309/onnx2tf/issues/545 - onnx2tf_file = Path("calibration_image_sample_data_20x128x128x3_float32.npy") - if not onnx2tf_file.exists(): - attempt_download_asset(f"{onnx2tf_file}.zip", unzip=True, delete=True) - - # Export to ONNX - self.args.simplify = True - f_onnx, _ = self.export_onnx() - - # Export to TF - tmp_file = f / "tmp_tflite_int8_calibration_images.npy" # int8 calibration images file - np_data = None - if self.args.int8: - verbosity = "info" - if self.args.data: - # Generate calibration data for integer quantization - LOGGER.info(f"{prefix} collecting INT8 calibration images from 'data={self.args.data}'") - data = check_det_dataset(self.args.data) - dataset = YOLODataset(data["val"], data=data, imgsz=self.imgsz[0], augment=False) - images = [] - for i, batch in enumerate(dataset): - if i >= 100: # maximum number of calibration images - break - im = batch["img"].permute(1, 2, 0)[None] # list to nparray, CHW to BHWC - images.append(im) - f.mkdir() - images = torch.cat(images, 0).float() - # mean = images.view(-1, 3).mean(0) # imagenet mean [123.675, 116.28, 103.53] - # std = images.view(-1, 3).std(0) # imagenet std [58.395, 57.12, 57.375] - np.save(str(tmp_file), images.numpy()) # BHWC - np_data = [["images", tmp_file, [[[[0, 0, 0]]]], [[[[255, 255, 255]]]]]] - else: - verbosity = "error" - - LOGGER.info(f"{prefix} starting TFLite export with onnx2tf {onnx2tf.__version__}...") - onnx2tf.convert( - input_onnx_file_path=f_onnx, - output_folder_path=str(f), - not_use_onnxsim=True, - verbosity=verbosity, - output_integer_quantized_tflite=self.args.int8, - quant_type="per-tensor", # "per-tensor" (faster) or "per-channel" (slower but more accurate) - custom_input_op_name_np_data_path=np_data, - ) - yaml_save(f / "metadata.yaml", self.metadata) # add metadata.yaml - - # Remove/rename TFLite models - if self.args.int8: - tmp_file.unlink(missing_ok=True) - for file in f.rglob("*_dynamic_range_quant.tflite"): - file.rename(file.with_name(file.stem.replace("_dynamic_range_quant", "_int8") + file.suffix)) - for file in f.rglob("*_integer_quant_with_int16_act.tflite"): - file.unlink() # delete extra fp16 activation TFLite files - - # Add TFLite metadata - for file in f.rglob("*.tflite"): - f.unlink() if "quant_with_int16_act.tflite" in str(f) else self._add_tflite_metadata(file) - - return str(f), tf.saved_model.load(f, tags=None, options=None) # load saved_model as Keras model - - @try_export - def export_pb(self, keras_model, prefix=colorstr("TensorFlow GraphDef:")): - """YOLOv8 TensorFlow GraphDef *.pb export https://github.com/leimao/Frozen_Graph_TensorFlow.""" - import tensorflow as tf # noqa - from tensorflow.python.framework.convert_to_constants import convert_variables_to_constants_v2 # noqa - - LOGGER.info(f"\n{prefix} starting export with tensorflow {tf.__version__}...") - f = self.file.with_suffix(".pb") - - m = tf.function(lambda x: keras_model(x)) # full model - m = m.get_concrete_function(tf.TensorSpec(keras_model.inputs[0].shape, keras_model.inputs[0].dtype)) - frozen_func = convert_variables_to_constants_v2(m) - frozen_func.graph.as_graph_def() - tf.io.write_graph(graph_or_graph_def=frozen_func.graph, logdir=str(f.parent), name=f.name, as_text=False) - return f, None - - @try_export - def export_tflite(self, keras_model, nms, agnostic_nms, prefix=colorstr("TensorFlow Lite:")): - """YOLOv8 TensorFlow Lite export.""" - import tensorflow as tf # noqa - - LOGGER.info(f"\n{prefix} starting export with tensorflow {tf.__version__}...") - saved_model = Path(str(self.file).replace(self.file.suffix, "_saved_model")) - if self.args.int8: - f = saved_model / f"{self.file.stem}_int8.tflite" # fp32 in/out - elif self.args.half: - f = saved_model / f"{self.file.stem}_float16.tflite" # fp32 in/out - else: - f = saved_model / f"{self.file.stem}_float32.tflite" - return str(f), None - - @try_export - def export_edgetpu(self, tflite_model="", prefix=colorstr("Edge TPU:")): - """YOLOv8 Edge TPU export https://coral.ai/docs/edgetpu/models-intro/.""" - LOGGER.warning(f"{prefix} WARNING ⚠️ Edge TPU known bug https://github.com/ultralytics/ultralytics/issues/1185") - - cmd = "edgetpu_compiler --version" - help_url = "https://coral.ai/docs/edgetpu/compiler/" - assert LINUX, f"export only supported on Linux. See {help_url}" - if subprocess.run(cmd, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, shell=True).returncode != 0: - LOGGER.info(f"\n{prefix} export requires Edge TPU compiler. Attempting install from {help_url}") - sudo = subprocess.run("sudo --version >/dev/null", shell=True).returncode == 0 # sudo installed on system - for c in ( - "curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -", - 'echo "deb https://packages.cloud.google.com/apt coral-edgetpu-stable main" | ' - "sudo tee /etc/apt/sources.list.d/coral-edgetpu.list", - "sudo apt-get update", - "sudo apt-get install edgetpu-compiler", - ): - subprocess.run(c if sudo else c.replace("sudo ", ""), shell=True, check=True) - ver = subprocess.run(cmd, shell=True, capture_output=True, check=True).stdout.decode().split()[-1] - - LOGGER.info(f"\n{prefix} starting export with Edge TPU compiler {ver}...") - f = str(tflite_model).replace(".tflite", "_edgetpu.tflite") # Edge TPU model - - cmd = f'edgetpu_compiler -s -d -k 10 --out_dir "{Path(f).parent}" "{tflite_model}"' - LOGGER.info(f"{prefix} running '{cmd}'") - subprocess.run(cmd, shell=True) - self._add_tflite_metadata(f) - return f, None - - @try_export - def export_tfjs(self, prefix=colorstr("TensorFlow.js:")): - """YOLOv8 TensorFlow.js export.""" - check_requirements("tensorflowjs") - if ARM64: - # Fix error: `np.object` was a deprecated alias for the builtin `object` when exporting to TF.js on ARM64 - check_requirements("numpy==1.23.5") - import tensorflow as tf - import tensorflowjs as tfjs # noqa - - LOGGER.info(f"\n{prefix} starting export with tensorflowjs {tfjs.__version__}...") - f = str(self.file).replace(self.file.suffix, "_web_model") # js dir - f_pb = str(self.file.with_suffix(".pb")) # *.pb path - - gd = tf.Graph().as_graph_def() # TF GraphDef - with open(f_pb, "rb") as file: - gd.ParseFromString(file.read()) - outputs = ",".join(gd_outputs(gd)) - LOGGER.info(f"\n{prefix} output node names: {outputs}") - - quantization = "--quantize_float16" if self.args.half else "--quantize_uint8" if self.args.int8 else "" - with spaces_in_path(f_pb) as fpb_, spaces_in_path(f) as f_: # exporter can not handle spaces in path - cmd = ( - "tensorflowjs_converter " - f'--input_format=tf_frozen_model {quantization} --output_node_names={outputs} "{fpb_}" "{f_}"' - ) - LOGGER.info(f"{prefix} running '{cmd}'") - subprocess.run(cmd, shell=True) - - if " " in f: - LOGGER.warning(f"{prefix} WARNING ⚠️ your model may not work correctly with spaces in path '{f}'.") - - # f_json = Path(f) / 'model.json' # *.json path - # with open(f_json, 'w') as j: # sort JSON Identity_* in ascending order - # subst = re.sub( - # r'{"outputs": {"Identity.?.?": {"name": "Identity.?.?"}, ' - # r'"Identity.?.?": {"name": "Identity.?.?"}, ' - # r'"Identity.?.?": {"name": "Identity.?.?"}, ' - # r'"Identity.?.?": {"name": "Identity.?.?"}}}', - # r'{"outputs": {"Identity": {"name": "Identity"}, ' - # r'"Identity_1": {"name": "Identity_1"}, ' - # r'"Identity_2": {"name": "Identity_2"}, ' - # r'"Identity_3": {"name": "Identity_3"}}}', - # f_json.read_text(), - # ) - # j.write(subst) - yaml_save(Path(f) / "metadata.yaml", self.metadata) # add metadata.yaml - return f, None - - def _add_tflite_metadata(self, file): - """Add metadata to *.tflite models per https://www.tensorflow.org/lite/models/convert/metadata.""" - from tflite_support import flatbuffers # noqa - from tflite_support import metadata as _metadata # noqa - from tflite_support import metadata_schema_py_generated as _metadata_fb # noqa - - # Create model info - model_meta = _metadata_fb.ModelMetadataT() - model_meta.name = self.metadata["description"] - model_meta.version = self.metadata["version"] - model_meta.author = self.metadata["author"] - model_meta.license = self.metadata["license"] - - # Label file - tmp_file = Path(file).parent / "temp_meta.txt" - with open(tmp_file, "w") as f: - f.write(str(self.metadata)) - - label_file = _metadata_fb.AssociatedFileT() - label_file.name = tmp_file.name - label_file.type = _metadata_fb.AssociatedFileType.TENSOR_AXIS_LABELS - - # Create input info - input_meta = _metadata_fb.TensorMetadataT() - input_meta.name = "image" - input_meta.description = "Input image to be detected." - input_meta.content = _metadata_fb.ContentT() - input_meta.content.contentProperties = _metadata_fb.ImagePropertiesT() - input_meta.content.contentProperties.colorSpace = _metadata_fb.ColorSpaceType.RGB - input_meta.content.contentPropertiesType = _metadata_fb.ContentProperties.ImageProperties - - # Create output info - output1 = _metadata_fb.TensorMetadataT() - output1.name = "output" - output1.description = "Coordinates of detected objects, class labels, and confidence score" - output1.associatedFiles = [label_file] - if self.model.task == "segment": - output2 = _metadata_fb.TensorMetadataT() - output2.name = "output" - output2.description = "Mask protos" - output2.associatedFiles = [label_file] - - # Create subgraph info - subgraph = _metadata_fb.SubGraphMetadataT() - subgraph.inputTensorMetadata = [input_meta] - subgraph.outputTensorMetadata = [output1, output2] if self.model.task == "segment" else [output1] - model_meta.subgraphMetadata = [subgraph] - - b = flatbuffers.Builder(0) - b.Finish(model_meta.Pack(b), _metadata.MetadataPopulator.METADATA_FILE_IDENTIFIER) - metadata_buf = b.Output() - - populator = _metadata.MetadataPopulator.with_model_file(str(file)) - populator.load_metadata_buffer(metadata_buf) - populator.load_associated_files([str(tmp_file)]) - populator.populate() - tmp_file.unlink() - - def _pipeline_coreml(self, model, weights_dir=None, prefix=colorstr("CoreML Pipeline:")): - """YOLOv8 CoreML pipeline.""" - import coremltools as ct # noqa - - LOGGER.info(f"{prefix} starting pipeline with coremltools {ct.__version__}...") - _, _, h, w = list(self.im.shape) # BCHW - - # Output shapes - spec = model.get_spec() - out0, out1 = iter(spec.description.output) - if MACOS: - from PIL import Image - - img = Image.new("RGB", (w, h)) # w=192, h=320 - out = model.predict({"image": img}) - out0_shape = out[out0.name].shape # (3780, 80) - out1_shape = out[out1.name].shape # (3780, 4) - else: # linux and windows can not run model.predict(), get sizes from PyTorch model output y - out0_shape = self.output_shape[2], self.output_shape[1] - 4 # (3780, 80) - out1_shape = self.output_shape[2], 4 # (3780, 4) - - # Checks - names = self.metadata["names"] - nx, ny = spec.description.input[0].type.imageType.width, spec.description.input[0].type.imageType.height - _, nc = out0_shape # number of anchors, number of classes - # _, nc = out0.type.multiArrayType.shape - assert len(names) == nc, f"{len(names)} names found for nc={nc}" # check - - # Define output shapes (missing) - out0.type.multiArrayType.shape[:] = out0_shape # (3780, 80) - out1.type.multiArrayType.shape[:] = out1_shape # (3780, 4) - # spec.neuralNetwork.preprocessing[0].featureName = '0' - - # Flexible input shapes - # from coremltools.models.neural_network import flexible_shape_utils - # s = [] # shapes - # s.append(flexible_shape_utils.NeuralNetworkImageSize(320, 192)) - # s.append(flexible_shape_utils.NeuralNetworkImageSize(640, 384)) # (height, width) - # flexible_shape_utils.add_enumerated_image_sizes(spec, feature_name='image', sizes=s) - # r = flexible_shape_utils.NeuralNetworkImageSizeRange() # shape ranges - # r.add_height_range((192, 640)) - # r.add_width_range((192, 640)) - # flexible_shape_utils.update_image_size_range(spec, feature_name='image', size_range=r) - - # Print - # print(spec.description) - - # Model from spec - model = ct.models.MLModel(spec, weights_dir=weights_dir) - - # 3. Create NMS protobuf - nms_spec = ct.proto.Model_pb2.Model() - nms_spec.specificationVersion = 5 - for i in range(2): - decoder_output = model._spec.description.output[i].SerializeToString() - nms_spec.description.input.add() - nms_spec.description.input[i].ParseFromString(decoder_output) - nms_spec.description.output.add() - nms_spec.description.output[i].ParseFromString(decoder_output) - - nms_spec.description.output[0].name = "confidence" - nms_spec.description.output[1].name = "coordinates" - - output_sizes = [nc, 4] - for i in range(2): - ma_type = nms_spec.description.output[i].type.multiArrayType - ma_type.shapeRange.sizeRanges.add() - ma_type.shapeRange.sizeRanges[0].lowerBound = 0 - ma_type.shapeRange.sizeRanges[0].upperBound = -1 - ma_type.shapeRange.sizeRanges.add() - ma_type.shapeRange.sizeRanges[1].lowerBound = output_sizes[i] - ma_type.shapeRange.sizeRanges[1].upperBound = output_sizes[i] - del ma_type.shape[:] - - nms = nms_spec.nonMaximumSuppression - nms.confidenceInputFeatureName = out0.name # 1x507x80 - nms.coordinatesInputFeatureName = out1.name # 1x507x4 - nms.confidenceOutputFeatureName = "confidence" - nms.coordinatesOutputFeatureName = "coordinates" - nms.iouThresholdInputFeatureName = "iouThreshold" - nms.confidenceThresholdInputFeatureName = "confidenceThreshold" - nms.iouThreshold = 0.45 - nms.confidenceThreshold = 0.25 - nms.pickTop.perClass = True - nms.stringClassLabels.vector.extend(names.values()) - nms_model = ct.models.MLModel(nms_spec) - - # 4. Pipeline models together - pipeline = ct.models.pipeline.Pipeline( - input_features=[ - ("image", ct.models.datatypes.Array(3, ny, nx)), - ("iouThreshold", ct.models.datatypes.Double()), - ("confidenceThreshold", ct.models.datatypes.Double()), - ], - output_features=["confidence", "coordinates"], - ) - pipeline.add_model(model) - pipeline.add_model(nms_model) - - # Correct datatypes - pipeline.spec.description.input[0].ParseFromString(model._spec.description.input[0].SerializeToString()) - pipeline.spec.description.output[0].ParseFromString(nms_model._spec.description.output[0].SerializeToString()) - pipeline.spec.description.output[1].ParseFromString(nms_model._spec.description.output[1].SerializeToString()) - - # Update metadata - pipeline.spec.specificationVersion = 5 - pipeline.spec.description.metadata.userDefined.update( - {"IoU threshold": str(nms.iouThreshold), "Confidence threshold": str(nms.confidenceThreshold)} - ) - - # Save the model - model = ct.models.MLModel(pipeline.spec, weights_dir=weights_dir) - model.input_description["image"] = "Input image" - model.input_description["iouThreshold"] = f"(optional) IoU threshold override (default: {nms.iouThreshold})" - model.input_description["confidenceThreshold"] = ( - f"(optional) Confidence threshold override (default: {nms.confidenceThreshold})" - ) - model.output_description["confidence"] = 'Boxes × Class confidence (see user-defined metadata "classes")' - model.output_description["coordinates"] = "Boxes × [x, y, width, height] (relative to image size)" - LOGGER.info(f"{prefix} pipeline success") - return model - - def add_callback(self, event: str, callback): - """Appends the given callback.""" - self.callbacks[event].append(callback) - - def run_callbacks(self, event: str): - """Execute all callbacks for a given event.""" - for callback in self.callbacks.get(event, []): - callback(self) - - -class IOSDetectModel(torch.nn.Module): - """Wrap an Ultralytics YOLO model for Apple iOS CoreML export.""" - - def __init__(self, model, im): - """Initialize the IOSDetectModel class with a YOLO model and example image.""" - super().__init__() - _, _, h, w = im.shape # batch, channel, height, width - self.model = model - self.nc = len(model.names) # number of classes - if w == h: - self.normalize = 1.0 / w # scalar - else: - self.normalize = torch.tensor([1.0 / w, 1.0 / h, 1.0 / w, 1.0 / h]) # broadcast (slower, smaller) - - def forward(self, x): - """Normalize predictions of object detection model with input size-dependent factors.""" - xywh, cls = self.model(x)[0].transpose(0, 1).split((4, self.nc), 1) - return cls, xywh * self.normalize # confidence (3780, 80), coordinates (3780, 4) diff --git a/ultralytics-main/ultralytics/engine/model.py b/ultralytics-main/ultralytics/engine/model.py deleted file mode 100644 index ace045f..0000000 --- a/ultralytics-main/ultralytics/engine/model.py +++ /dev/null @@ -1,821 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import inspect -import sys -from pathlib import Path -from typing import Union - -import numpy as np -import torch - -from ultralytics.cfg import TASK2DATA, get_cfg, get_save_dir -from ultralytics.hub.utils import HUB_WEB_ROOT -from ultralytics.nn.tasks import attempt_load_one_weight, guess_model_task, nn, yaml_model_load -from ultralytics.utils import ASSETS, DEFAULT_CFG_DICT, LOGGER, RANK, SETTINGS, callbacks, checks, emojis, yaml_load - - -class Model(nn.Module): - """ - A base class for implementing YOLO models, unifying APIs across different model types. - - This class provides a common interface for various operations related to YOLO models, such as training, - validation, prediction, exporting, and benchmarking. It handles different types of models, including those - loaded from local files, Ultralytics HUB, or Triton Server. The class is designed to be flexible and - extendable for different tasks and model configurations. - - Args: - model (Union[str, Path], optional): Path or name of the model to load or create. This can be a local file - path, a model name from Ultralytics HUB, or a Triton Server model. Defaults to 'yolov8n.pt'. - task (Any, optional): The task type associated with the YOLO model. This can be used to specify the model's - application domain, such as object detection, segmentation, etc. Defaults to None. - verbose (bool, optional): If True, enables verbose output during the model's operations. Defaults to False. - - Attributes: - callbacks (dict): A dictionary of callback functions for various events during model operations. - predictor (BasePredictor): The predictor object used for making predictions. - model (nn.Module): The underlying PyTorch model. - trainer (BaseTrainer): The trainer object used for training the model. - ckpt (dict): The checkpoint data if the model is loaded from a *.pt file. - cfg (str): The configuration of the model if loaded from a *.yaml file. - ckpt_path (str): The path to the checkpoint file. - overrides (dict): A dictionary of overrides for model configuration. - metrics (dict): The latest training/validation metrics. - session (HUBTrainingSession): The Ultralytics HUB session, if applicable. - task (str): The type of task the model is intended for. - model_name (str): The name of the model. - - Methods: - __call__: Alias for the predict method, enabling the model instance to be callable. - _new: Initializes a new model based on a configuration file. - _load: Loads a model from a checkpoint file. - _check_is_pytorch_model: Ensures that the model is a PyTorch model. - reset_weights: Resets the model's weights to their initial state. - load: Loads model weights from a specified file. - save: Saves the current state of the model to a file. - info: Logs or returns information about the model. - fuse: Fuses Conv2d and BatchNorm2d layers for optimized inference. - predict: Performs object detection predictions. - track: Performs object tracking. - val: Validates the model on a dataset. - benchmark: Benchmarks the model on various export formats. - export: Exports the model to different formats. - train: Trains the model on a dataset. - tune: Performs hyperparameter tuning. - _apply: Applies a function to the model's tensors. - add_callback: Adds a callback function for an event. - clear_callback: Clears all callbacks for an event. - reset_callbacks: Resets all callbacks to their default functions. - _get_hub_session: Retrieves or creates an Ultralytics HUB session. - is_triton_model: Checks if a model is a Triton Server model. - is_hub_model: Checks if a model is an Ultralytics HUB model. - _reset_ckpt_args: Resets checkpoint arguments when loading a PyTorch model. - _smart_load: Loads the appropriate module based on the model task. - task_map: Provides a mapping from model tasks to corresponding classes. - - Raises: - FileNotFoundError: If the specified model file does not exist or is inaccessible. - ValueError: If the model file or configuration is invalid or unsupported. - ImportError: If required dependencies for specific model types (like HUB SDK) are not installed. - TypeError: If the model is not a PyTorch model when required. - AttributeError: If required attributes or methods are not implemented or available. - NotImplementedError: If a specific model task or mode is not supported. - """ - - def __init__( - self, - model: Union[str, Path] = "yolov8n.pt", - task: str = None, - verbose: bool = False, - ) -> None: - """ - Initializes a new instance of the YOLO model class. - - This constructor sets up the model based on the provided model path or name. It handles various types of model - sources, including local files, Ultralytics HUB models, and Triton Server models. The method initializes several - important attributes of the model and prepares it for operations like training, prediction, or export. - - Args: - model (Union[str, Path], optional): The path or model file to load or create. This can be a local - file path, a model name from Ultralytics HUB, or a Triton Server model. Defaults to 'yolov8n.pt'. - task (Any, optional): The task type associated with the YOLO model, specifying its application domain. - Defaults to None. - verbose (bool, optional): If True, enables verbose output during the model's initialization and subsequent - operations. Defaults to False. - - Raises: - FileNotFoundError: If the specified model file does not exist or is inaccessible. - ValueError: If the model file or configuration is invalid or unsupported. - ImportError: If required dependencies for specific model types (like HUB SDK) are not installed. - """ - super().__init__() - self.callbacks = callbacks.get_default_callbacks() - self.predictor = None # reuse predictor - self.model = None # model object - self.trainer = None # trainer object - self.ckpt = None # if loaded from *.pt - self.cfg = None # if loaded from *.yaml - self.ckpt_path = None - self.overrides = {} # overrides for trainer object - self.metrics = None # validation/training metrics - self.session = None # HUB session - self.task = task # task type - self.model_name = model = str(model).strip() # strip spaces - - # Check if Ultralytics HUB model from https://hub.ultralytics.com - if self.is_hub_model(model): - # Fetch model from HUB - checks.check_requirements("hub-sdk>=0.0.5") - self.session = self._get_hub_session(model) - model = self.session.model_file - - # Check if Triton Server model - elif self.is_triton_model(model): - self.model = model - self.task = task - return - - # Load or create new YOLO model - model = checks.check_model_file_from_stem(model) # add suffix, i.e. yolov8n -> yolov8n.pt - if Path(model).suffix in (".yaml", ".yml"): - self._new(model, task=task, verbose=verbose) - else: - self._load(model, task=task) - - self.model_name = model - - def __call__( - self, - source: Union[str, Path, int, list, tuple, np.ndarray, torch.Tensor] = None, - stream: bool = False, - **kwargs, - ) -> list: - """ - An alias for the predict method, enabling the model instance to be callable. - - This method simplifies the process of making predictions by allowing the model instance to be called directly - with the required arguments for prediction. - - Args: - source (str | Path | int | PIL.Image | np.ndarray, optional): The source of the image for making - predictions. Accepts various types, including file paths, URLs, PIL images, and numpy arrays. - Defaults to None. - stream (bool, optional): If True, treats the input source as a continuous stream for predictions. - Defaults to False. - **kwargs (any): Additional keyword arguments for configuring the prediction process. - - Returns: - (List[ultralytics.engine.results.Results]): A list of prediction results, encapsulated in the Results class. - """ - return self.predict(source, stream, **kwargs) - - @staticmethod - def _get_hub_session(model: str): - """Creates a session for Hub Training.""" - from ultralytics.hub.session import HUBTrainingSession - - session = HUBTrainingSession(model) - return session if session.client.authenticated else None - - @staticmethod - def is_triton_model(model: str) -> bool: - """Is model a Triton Server URL string, i.e. :////""" - from urllib.parse import urlsplit - - url = urlsplit(model) - return url.netloc and url.path and url.scheme in {"http", "grpc"} - - @staticmethod - def is_hub_model(model: str) -> bool: - """Check if the provided model is a HUB model.""" - return any( - ( - model.startswith(f"{HUB_WEB_ROOT}/models/"), # i.e. https://hub.ultralytics.com/models/MODEL_ID - [len(x) for x in model.split("_")] == [42, 20], # APIKEY_MODELID - len(model) == 20 and not Path(model).exists() and all(x not in model for x in "./\\"), # MODELID - ) - ) - - def _new(self, cfg: str, task=None, model=None, verbose=False) -> None: - """ - Initializes a new model and infers the task type from the model definitions. - - Args: - cfg (str): model configuration file - task (str | None): model task - model (BaseModel): Customized model. - verbose (bool): display model info on load - """ - cfg_dict = yaml_model_load(cfg) - self.cfg = cfg - self.task = task or guess_model_task(cfg_dict) - self.model = (model or self._smart_load("model"))(cfg_dict, verbose=verbose and RANK == -1) # build model - self.overrides["model"] = self.cfg - self.overrides["task"] = self.task - - # Below added to allow export from YAMLs - self.model.args = {**DEFAULT_CFG_DICT, **self.overrides} # combine default and model args (prefer model args) - self.model.task = self.task - - def _load(self, weights: str, task=None) -> None: - """ - Initializes a new model and infers the task type from the model head. - - Args: - weights (str): model checkpoint to be loaded - task (str | None): model task - """ - suffix = Path(weights).suffix - if suffix == ".pt": - self.model, self.ckpt = attempt_load_one_weight(weights) - self.task = self.model.args["task"] - self.overrides = self.model.args = self._reset_ckpt_args(self.model.args) - self.ckpt_path = self.model.pt_path - else: - weights = checks.check_file(weights) - self.model, self.ckpt = weights, None - self.task = task or guess_model_task(weights) - self.ckpt_path = weights - self.overrides["model"] = weights - self.overrides["task"] = self.task - - def _check_is_pytorch_model(self) -> None: - """Raises TypeError is model is not a PyTorch model.""" - pt_str = isinstance(self.model, (str, Path)) and Path(self.model).suffix == ".pt" - pt_module = isinstance(self.model, nn.Module) - if not (pt_module or pt_str): - raise TypeError( - f"model='{self.model}' should be a *.pt PyTorch model to run this method, but is a different format. " - f"PyTorch models can train, val, predict and export, i.e. 'model.train(data=...)', but exported " - f"formats like ONNX, TensorRT etc. only support 'predict' and 'val' modes, " - f"i.e. 'yolo predict model=yolov8n.onnx'.\nTo run CUDA or MPS inference please pass the device " - f"argument directly in your inference command, i.e. 'model.predict(source=..., device=0)'" - ) - - def reset_weights(self) -> "Model": - """ - Resets the model parameters to randomly initialized values, effectively discarding all training information. - - This method iterates through all modules in the model and resets their parameters if they have a - 'reset_parameters' method. It also ensures that all parameters have 'requires_grad' set to True, enabling them - to be updated during training. - - Returns: - self (ultralytics.engine.model.Model): The instance of the class with reset weights. - - Raises: - AssertionError: If the model is not a PyTorch model. - """ - self._check_is_pytorch_model() - for m in self.model.modules(): - if hasattr(m, "reset_parameters"): - m.reset_parameters() - for p in self.model.parameters(): - p.requires_grad = True - return self - - def load(self, weights: Union[str, Path] = "yolov8n.pt") -> "Model": - """ - Loads parameters from the specified weights file into the model. - - This method supports loading weights from a file or directly from a weights object. It matches parameters by - name and shape and transfers them to the model. - - Args: - weights (str | Path): Path to the weights file or a weights object. Defaults to 'yolov8n.pt'. - - Returns: - self (ultralytics.engine.model.Model): The instance of the class with loaded weights. - - Raises: - AssertionError: If the model is not a PyTorch model. - """ - self._check_is_pytorch_model() - if isinstance(weights, (str, Path)): - weights, self.ckpt = attempt_load_one_weight(weights) - self.model.load(weights) - return self - - def save(self, filename: Union[str, Path] = "saved_model.pt", use_dill=True) -> None: - """ - Saves the current model state to a file. - - This method exports the model's checkpoint (ckpt) to the specified filename. - - Args: - filename (str | Path): The name of the file to save the model to. Defaults to 'saved_model.pt'. - use_dill (bool): Whether to try using dill for serialization if available. Defaults to True. - - Raises: - AssertionError: If the model is not a PyTorch model. - """ - self._check_is_pytorch_model() - from ultralytics import __version__ - from datetime import datetime - - updates = { - "date": datetime.now().isoformat(), - "version": __version__, - "license": "AGPL-3.0 License (https://ultralytics.com/license)", - "docs": "https://docs.ultralytics.com", - } - torch.save({**self.ckpt, **updates}, filename, use_dill=use_dill) - - def info(self, detailed: bool = False, verbose: bool = True): - """ - Logs or returns model information. - - This method provides an overview or detailed information about the model, depending on the arguments passed. - It can control the verbosity of the output. - - Args: - detailed (bool): If True, shows detailed information about the model. Defaults to False. - verbose (bool): If True, prints the information. If False, returns the information. Defaults to True. - - Returns: - (list): Various types of information about the model, depending on the 'detailed' and 'verbose' parameters. - - Raises: - AssertionError: If the model is not a PyTorch model. - """ - self._check_is_pytorch_model() - return self.model.info(detailed=detailed, verbose=verbose) - - def fuse(self): - """ - Fuses Conv2d and BatchNorm2d layers in the model. - - This method optimizes the model by fusing Conv2d and BatchNorm2d layers, which can improve inference speed. - - Raises: - AssertionError: If the model is not a PyTorch model. - """ - self._check_is_pytorch_model() - self.model.fuse() - - def embed( - self, - source: Union[str, Path, int, list, tuple, np.ndarray, torch.Tensor] = None, - stream: bool = False, - **kwargs, - ) -> list: - """ - Generates image embeddings based on the provided source. - - This method is a wrapper around the 'predict()' method, focusing on generating embeddings from an image source. - It allows customization of the embedding process through various keyword arguments. - - Args: - source (str | int | PIL.Image | np.ndarray): The source of the image for generating embeddings. - The source can be a file path, URL, PIL image, numpy array, etc. Defaults to None. - stream (bool): If True, predictions are streamed. Defaults to False. - **kwargs (any): Additional keyword arguments for configuring the embedding process. - - Returns: - (List[torch.Tensor]): A list containing the image embeddings. - - Raises: - AssertionError: If the model is not a PyTorch model. - """ - if not kwargs.get("embed"): - kwargs["embed"] = [len(self.model.model) - 2] # embed second-to-last layer if no indices passed - return self.predict(source, stream, **kwargs) - - def predict( - self, - source: Union[str, Path, int, list, tuple, np.ndarray, torch.Tensor] = None, - stream: bool = False, - predictor=None, - **kwargs, - ) -> list: - """ - Performs predictions on the given image source using the YOLO model. - - This method facilitates the prediction process, allowing various configurations through keyword arguments. - It supports predictions with custom predictors or the default predictor method. The method handles different - types of image sources and can operate in a streaming mode. It also provides support for SAM-type models - through 'prompts'. - - The method sets up a new predictor if not already present and updates its arguments with each call. - It also issues a warning and uses default assets if the 'source' is not provided. The method determines if it - is being called from the command line interface and adjusts its behavior accordingly, including setting defaults - for confidence threshold and saving behavior. - - Args: - source (str | int | PIL.Image | np.ndarray, optional): The source of the image for making predictions. - Accepts various types, including file paths, URLs, PIL images, and numpy arrays. Defaults to ASSETS. - stream (bool, optional): Treats the input source as a continuous stream for predictions. Defaults to False. - predictor (BasePredictor, optional): An instance of a custom predictor class for making predictions. - If None, the method uses a default predictor. Defaults to None. - **kwargs (any): Additional keyword arguments for configuring the prediction process. These arguments allow - for further customization of the prediction behavior. - - Returns: - (List[ultralytics.engine.results.Results]): A list of prediction results, encapsulated in the Results class. - - Raises: - AttributeError: If the predictor is not properly set up. - """ - if source is None: - source = ASSETS - LOGGER.warning(f"WARNING ⚠️ 'source' is missing. Using 'source={source}'.") - - is_cli = (sys.argv[0].endswith("yolo") or sys.argv[0].endswith("ultralytics")) and any( - x in sys.argv for x in ("predict", "track", "mode=predict", "mode=track") - ) - - custom = {"conf": 0.25, "batch": 1, "save": is_cli, "mode": "predict"} # method defaults - args = {**self.overrides, **custom, **kwargs} # highest priority args on the right - prompts = args.pop("prompts", None) # for SAM-type models - - if not self.predictor: - self.predictor = predictor or self._smart_load("predictor")(overrides=args, _callbacks=self.callbacks) - self.predictor.setup_model(model=self.model, verbose=is_cli) - else: # only update args if predictor is already setup - self.predictor.args = get_cfg(self.predictor.args, args) - if "project" in args or "name" in args: - self.predictor.save_dir = get_save_dir(self.predictor.args) - if prompts and hasattr(self.predictor, "set_prompts"): # for SAM-type models - self.predictor.set_prompts(prompts) - return self.predictor.predict_cli(source=source) if is_cli else self.predictor(source=source, stream=stream) - - def track( - self, - source: Union[str, Path, int, list, tuple, np.ndarray, torch.Tensor] = None, - stream: bool = False, - persist: bool = False, - **kwargs, - ) -> list: - """ - Conducts object tracking on the specified input source using the registered trackers. - - This method performs object tracking using the model's predictors and optionally registered trackers. It is - capable of handling different types of input sources such as file paths or video streams. The method supports - customization of the tracking process through various keyword arguments. It registers trackers if they are not - already present and optionally persists them based on the 'persist' flag. - - The method sets a default confidence threshold specifically for ByteTrack-based tracking, which requires low - confidence predictions as input. The tracking mode is explicitly set in the keyword arguments. - - Args: - source (str, optional): The input source for object tracking. It can be a file path, URL, or video stream. - stream (bool, optional): Treats the input source as a continuous video stream. Defaults to False. - persist (bool, optional): Persists the trackers between different calls to this method. Defaults to False. - **kwargs (any): Additional keyword arguments for configuring the tracking process. These arguments allow - for further customization of the tracking behavior. - - Returns: - (List[ultralytics.engine.results.Results]): A list of tracking results, encapsulated in the Results class. - - Raises: - AttributeError: If the predictor does not have registered trackers. - """ - if not hasattr(self.predictor, "trackers"): - from ultralytics.trackers import register_tracker - - register_tracker(self, persist) - kwargs["conf"] = kwargs.get("conf") or 0.1 # ByteTrack-based method needs low confidence predictions as input - kwargs["batch"] = kwargs.get("batch") or 1 # batch-size 1 for tracking in videos - kwargs["mode"] = "track" - return self.predict(source=source, stream=stream, **kwargs) - - def val( - self, - validator=None, - **kwargs, - ): - """ - Validates the model using a specified dataset and validation configuration. - - This method facilitates the model validation process, allowing for a range of customization through various - settings and configurations. It supports validation with a custom validator or the default validation approach. - The method combines default configurations, method-specific defaults, and user-provided arguments to configure - the validation process. After validation, it updates the model's metrics with the results obtained from the - validator. - - The method supports various arguments that allow customization of the validation process. For a comprehensive - list of all configurable options, users should refer to the 'configuration' section in the documentation. - - Args: - validator (BaseValidator, optional): An instance of a custom validator class for validating the model. If - None, the method uses a default validator. Defaults to None. - **kwargs (any): Arbitrary keyword arguments representing the validation configuration. These arguments are - used to customize various aspects of the validation process. - - Returns: - (dict): Validation metrics obtained from the validation process. - - Raises: - AssertionError: If the model is not a PyTorch model. - """ - custom = {"rect": True} # method defaults - args = {**self.overrides, **custom, **kwargs, "mode": "val"} # highest priority args on the right - - validator = (validator or self._smart_load("validator"))(args=args, _callbacks=self.callbacks) - validator(model=self.model) - self.metrics = validator.metrics - return validator.metrics - - def benchmark( - self, - **kwargs, - ): - """ - Benchmarks the model across various export formats to evaluate performance. - - This method assesses the model's performance in different export formats, such as ONNX, TorchScript, etc. - It uses the 'benchmark' function from the ultralytics.utils.benchmarks module. The benchmarking is configured - using a combination of default configuration values, model-specific arguments, method-specific defaults, and - any additional user-provided keyword arguments. - - The method supports various arguments that allow customization of the benchmarking process, such as dataset - choice, image size, precision modes, device selection, and verbosity. For a comprehensive list of all - configurable options, users should refer to the 'configuration' section in the documentation. - - Args: - **kwargs (any): Arbitrary keyword arguments to customize the benchmarking process. These are combined with - default configurations, model-specific arguments, and method defaults. - - Returns: - (dict): A dictionary containing the results of the benchmarking process. - - Raises: - AssertionError: If the model is not a PyTorch model. - """ - self._check_is_pytorch_model() - from ultralytics.utils.benchmarks import benchmark - - custom = {"verbose": False} # method defaults - args = {**DEFAULT_CFG_DICT, **self.model.args, **custom, **kwargs, "mode": "benchmark"} - return benchmark( - model=self, - data=kwargs.get("data"), # if no 'data' argument passed set data=None for default datasets - imgsz=args["imgsz"], - half=args["half"], - int8=args["int8"], - device=args["device"], - verbose=kwargs.get("verbose"), - ) - - def export( - self, - **kwargs, - ): - """ - Exports the model to a different format suitable for deployment. - - This method facilitates the export of the model to various formats (e.g., ONNX, TorchScript) for deployment - purposes. It uses the 'Exporter' class for the export process, combining model-specific overrides, method - defaults, and any additional arguments provided. The combined arguments are used to configure export settings. - - The method supports a wide range of arguments to customize the export process. For a comprehensive list of all - possible arguments, refer to the 'configuration' section in the documentation. - - Args: - **kwargs (any): Arbitrary keyword arguments to customize the export process. These are combined with the - model's overrides and method defaults. - - Returns: - (object): The exported model in the specified format, or an object related to the export process. - - Raises: - AssertionError: If the model is not a PyTorch model. - """ - self._check_is_pytorch_model() - from .exporter import Exporter - - custom = {"imgsz": self.model.args["imgsz"], "batch": 1, "data": None, "verbose": False} # method defaults - args = {**self.overrides, **custom, **kwargs, "mode": "export"} # highest priority args on the right - return Exporter(overrides=args, _callbacks=self.callbacks)(model=self.model) - - def train( - self, - trainer=None, - **kwargs, - ): - """ - Trains the model using the specified dataset and training configuration. - - This method facilitates model training with a range of customizable settings and configurations. It supports - training with a custom trainer or the default training approach defined in the method. The method handles - different scenarios, such as resuming training from a checkpoint, integrating with Ultralytics HUB, and - updating model and configuration after training. - - When using Ultralytics HUB, if the session already has a loaded model, the method prioritizes HUB training - arguments and issues a warning if local arguments are provided. It checks for pip updates and combines default - configurations, method-specific defaults, and user-provided arguments to configure the training process. After - training, it updates the model and its configurations, and optionally attaches metrics. - - Args: - trainer (BaseTrainer, optional): An instance of a custom trainer class for training the model. If None, the - method uses a default trainer. Defaults to None. - **kwargs (any): Arbitrary keyword arguments representing the training configuration. These arguments are - used to customize various aspects of the training process. - - Returns: - (dict | None): Training metrics if available and training is successful; otherwise, None. - - Raises: - AssertionError: If the model is not a PyTorch model. - PermissionError: If there is a permission issue with the HUB session. - ModuleNotFoundError: If the HUB SDK is not installed. - """ - self._check_is_pytorch_model() - if hasattr(self.session, "model") and self.session.model.id: # Ultralytics HUB session with loaded model - if any(kwargs): - LOGGER.warning("WARNING ⚠️ using HUB training arguments, ignoring local training arguments.") - kwargs = self.session.train_args # overwrite kwargs - - checks.check_pip_update_available() - - overrides = yaml_load(checks.check_yaml(kwargs["cfg"])) if kwargs.get("cfg") else self.overrides - custom = {"data": DEFAULT_CFG_DICT["data"] or TASK2DATA[self.task]} # method defaults - args = {**overrides, **custom, **kwargs, "mode": "train"} # highest priority args on the right - if args.get("resume"): - args["resume"] = self.ckpt_path - - self.trainer = (trainer or self._smart_load("trainer"))(overrides=args, _callbacks=self.callbacks) - if not args.get("resume"): # manually set model only if not resuming - self.trainer.model = self.trainer.get_model(weights=self.model if self.ckpt else None, cfg=self.model.yaml) - self.model = self.trainer.model - - if SETTINGS["hub"] is True and not self.session: - # Create a model in HUB - try: - self.session = self._get_hub_session(self.model_name) - if self.session: - self.session.create_model(args) - # Check model was created - if not getattr(self.session.model, "id", None): - self.session = None - except (PermissionError, ModuleNotFoundError): - # Ignore PermissionError and ModuleNotFoundError which indicates hub-sdk not installed - pass - - self.trainer.hub_session = self.session # attach optional HUB session - self.trainer.train() - # Update model and cfg after training - if RANK in (-1, 0): - ckpt = self.trainer.best if self.trainer.best.exists() else self.trainer.last - self.model, _ = attempt_load_one_weight(ckpt) - self.overrides = self.model.args - self.metrics = getattr(self.trainer.validator, "metrics", None) # TODO: no metrics returned by DDP - return self.metrics - - def tune( - self, - use_ray=False, - iterations=10, - *args, - **kwargs, - ): - """ - Conducts hyperparameter tuning for the model, with an option to use Ray Tune. - - This method supports two modes of hyperparameter tuning: using Ray Tune or a custom tuning method. - When Ray Tune is enabled, it leverages the 'run_ray_tune' function from the ultralytics.utils.tuner module. - Otherwise, it uses the internal 'Tuner' class for tuning. The method combines default, overridden, and - custom arguments to configure the tuning process. - - Args: - use_ray (bool): If True, uses Ray Tune for hyperparameter tuning. Defaults to False. - iterations (int): The number of tuning iterations to perform. Defaults to 10. - *args (list): Variable length argument list for additional arguments. - **kwargs (any): Arbitrary keyword arguments. These are combined with the model's overrides and defaults. - - Returns: - (dict): A dictionary containing the results of the hyperparameter search. - - Raises: - AssertionError: If the model is not a PyTorch model. - """ - self._check_is_pytorch_model() - if use_ray: - from ultralytics.utils.tuner import run_ray_tune - - return run_ray_tune(self, max_samples=iterations, *args, **kwargs) - else: - from .tuner import Tuner - - custom = {} # method defaults - args = {**self.overrides, **custom, **kwargs, "mode": "train"} # highest priority args on the right - return Tuner(args=args, _callbacks=self.callbacks)(model=self, iterations=iterations) - - def _apply(self, fn) -> "Model": - """Apply to(), cpu(), cuda(), half(), float() to model tensors that are not parameters or registered buffers.""" - self._check_is_pytorch_model() - self = super()._apply(fn) # noqa - self.predictor = None # reset predictor as device may have changed - self.overrides["device"] = self.device # was str(self.device) i.e. device(type='cuda', index=0) -> 'cuda:0' - return self - - @property - def names(self) -> list: - """ - Retrieves the class names associated with the loaded model. - - This property returns the class names if they are defined in the model. It checks the class names for validity - using the 'check_class_names' function from the ultralytics.nn.autobackend module. - - Returns: - (list | None): The class names of the model if available, otherwise None. - """ - from ultralytics.nn.autobackend import check_class_names - - return check_class_names(self.model.names) if hasattr(self.model, "names") else None - - @property - def device(self) -> torch.device: - """ - Retrieves the device on which the model's parameters are allocated. - - This property is used to determine whether the model's parameters are on CPU or GPU. It only applies to models - that are instances of nn.Module. - - Returns: - (torch.device | None): The device (CPU/GPU) of the model if it is a PyTorch model, otherwise None. - """ - return next(self.model.parameters()).device if isinstance(self.model, nn.Module) else None - - @property - def transforms(self): - """ - Retrieves the transformations applied to the input data of the loaded model. - - This property returns the transformations if they are defined in the model. - - Returns: - (object | None): The transform object of the model if available, otherwise None. - """ - return self.model.transforms if hasattr(self.model, "transforms") else None - - def add_callback(self, event: str, func) -> None: - """ - Adds a callback function for a specified event. - - This method allows the user to register a custom callback function that is triggered on a specific event during - model training or inference. - - Args: - event (str): The name of the event to attach the callback to. - func (callable): The callback function to be registered. - - Raises: - ValueError: If the event name is not recognized. - """ - self.callbacks[event].append(func) - - def clear_callback(self, event: str) -> None: - """ - Clears all callback functions registered for a specified event. - - This method removes all custom and default callback functions associated with the given event. - - Args: - event (str): The name of the event for which to clear the callbacks. - - Raises: - ValueError: If the event name is not recognized. - """ - self.callbacks[event] = [] - - def reset_callbacks(self) -> None: - """ - Resets all callbacks to their default functions. - - This method reinstates the default callback functions for all events, removing any custom callbacks that were - added previously. - """ - for event in callbacks.default_callbacks.keys(): - self.callbacks[event] = [callbacks.default_callbacks[event][0]] - - @staticmethod - def _reset_ckpt_args(args: dict) -> dict: - """Reset arguments when loading a PyTorch model.""" - include = {"imgsz", "data", "task", "single_cls"} # only remember these arguments when loading a PyTorch model - return {k: v for k, v in args.items() if k in include} - - # def __getattr__(self, attr): - # """Raises error if object has no requested attribute.""" - # name = self.__class__.__name__ - # raise AttributeError(f"'{name}' object has no attribute '{attr}'. See valid attributes below.\n{self.__doc__}") - - def _smart_load(self, key: str): - """Load model/trainer/validator/predictor.""" - try: - return self.task_map[self.task][key] - except Exception as e: - name = self.__class__.__name__ - mode = inspect.stack()[1][3] # get the function name. - raise NotImplementedError( - emojis(f"WARNING ⚠️ '{name}' model does not support '{mode}' mode for '{self.task}' task yet.") - ) from e - - @property - def task_map(self) -> dict: - """ - Map head to model, trainer, validator, and predictor classes. - - Returns: - task_map (dict): The map of model task to mode classes. - """ - raise NotImplementedError("Please provide task map for your model!") diff --git a/ultralytics-main/ultralytics/engine/predictor.py b/ultralytics-main/ultralytics/engine/predictor.py deleted file mode 100644 index 921f273..0000000 --- a/ultralytics-main/ultralytics/engine/predictor.py +++ /dev/null @@ -1,397 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -""" -Run prediction on images, videos, directories, globs, YouTube, webcam, streams, etc. - -Usage - sources: - $ yolo mode=predict model=yolov8n.pt source=0 # webcam - img.jpg # image - vid.mp4 # video - screen # screenshot - path/ # directory - list.txt # list of images - list.streams # list of streams - 'path/*.jpg' # glob - 'https://youtu.be/LNwODJXcvt4' # YouTube - 'rtsp://example.com/media.mp4' # RTSP, RTMP, HTTP, TCP stream - -Usage - formats: - $ yolo mode=predict model=yolov8n.pt # PyTorch - yolov8n.torchscript # TorchScript - yolov8n.onnx # ONNX Runtime or OpenCV DNN with dnn=True - yolov8n_openvino_model # OpenVINO - yolov8n.engine # TensorRT - yolov8n.mlpackage # CoreML (macOS-only) - yolov8n_saved_model # TensorFlow SavedModel - yolov8n.pb # TensorFlow GraphDef - yolov8n.tflite # TensorFlow Lite - yolov8n_edgetpu.tflite # TensorFlow Edge TPU - yolov8n_paddle_model # PaddlePaddle - yolov8n_ncnn_model # NCNN -""" - -import platform -import re -import threading -from pathlib import Path - -import cv2 -import numpy as np -import torch - -from ultralytics.cfg import get_cfg, get_save_dir -from ultralytics.data import load_inference_source -from ultralytics.data.augment import LetterBox, classify_transforms -from ultralytics.nn.autobackend import AutoBackend -from ultralytics.utils import DEFAULT_CFG, LOGGER, MACOS, WINDOWS, callbacks, colorstr, ops -from ultralytics.utils.checks import check_imgsz, check_imshow -from ultralytics.utils.files import increment_path -from ultralytics.utils.torch_utils import select_device, smart_inference_mode - -STREAM_WARNING = """ -WARNING ⚠️ inference results will accumulate in RAM unless `stream=True` is passed, causing potential out-of-memory -errors for large sources or long-running streams and videos. See https://docs.ultralytics.com/modes/predict/ for help. - -Example: - results = model(source=..., stream=True) # generator of Results objects - for r in results: - boxes = r.boxes # Boxes object for bbox outputs - masks = r.masks # Masks object for segment masks outputs - probs = r.probs # Class probabilities for classification outputs -""" - - -class BasePredictor: - """ - BasePredictor. - - A base class for creating predictors. - - Attributes: - args (SimpleNamespace): Configuration for the predictor. - save_dir (Path): Directory to save results. - done_warmup (bool): Whether the predictor has finished setup. - model (nn.Module): Model used for prediction. - data (dict): Data configuration. - device (torch.device): Device used for prediction. - dataset (Dataset): Dataset used for prediction. - vid_writer (dict): Dictionary of {save_path: video_writer, ...} writer for saving video output. - """ - - def __init__(self, cfg=DEFAULT_CFG, overrides=None, _callbacks=None): - """ - Initializes the BasePredictor class. - - Args: - cfg (str, optional): Path to a configuration file. Defaults to DEFAULT_CFG. - overrides (dict, optional): Configuration overrides. Defaults to None. - """ - self.args = get_cfg(cfg, overrides) - self.save_dir = get_save_dir(self.args) - if self.args.conf is None: - self.args.conf = 0.25 # default conf=0.25 - self.done_warmup = False - if self.args.show: - self.args.show = check_imshow(warn=True) - - # Usable if setup is done - self.model = None - self.data = self.args.data # data_dict - self.imgsz = None - self.device = None - self.dataset = None - self.vid_writer = {} # dict of {save_path: video_writer, ...} - self.plotted_img = None - self.source_type = None - self.seen = 0 - self.windows = [] - self.batch = None - self.results = None - self.transforms = None - self.callbacks = _callbacks or callbacks.get_default_callbacks() - self.txt_path = None - self._lock = threading.Lock() # for automatic thread-safe inference - callbacks.add_integration_callbacks(self) - - def preprocess(self, im): - """ - Prepares input image before inference. - - Args: - im (torch.Tensor | List(np.ndarray)): BCHW for tensor, [(HWC) x B] for list. - """ - not_tensor = not isinstance(im, torch.Tensor) - if not_tensor: - im = np.stack(self.pre_transform(im)) - im = im[..., ::-1].transpose((0, 3, 1, 2)) # BGR to RGB, BHWC to BCHW, (n, 3, h, w) - im = np.ascontiguousarray(im) # contiguous - im = torch.from_numpy(im) - - im = im.to(self.device) - im = im.half() if self.model.fp16 else im.float() # uint8 to fp16/32 - if not_tensor: - im /= 255 # 0 - 255 to 0.0 - 1.0 - return im - - def inference(self, im, *args, **kwargs): - """Runs inference on a given image using the specified model and arguments.""" - visualize = ( - increment_path(self.save_dir / Path(self.batch[0][0]).stem, mkdir=True) - if self.args.visualize and (not self.source_type.tensor) - else False - ) - return self.model(im, augment=self.args.augment, visualize=visualize, embed=self.args.embed, *args, **kwargs) - - def pre_transform(self, im): - """ - Pre-transform input image before inference. - - Args: - im (List(np.ndarray)): (N, 3, h, w) for tensor, [(h, w, 3) x N] for list. - - Returns: - (list): A list of transformed images. - """ - same_shapes = len({x.shape for x in im}) == 1 - letterbox = LetterBox(self.imgsz, auto=same_shapes and self.model.pt, stride=self.model.stride) - return [letterbox(image=x) for x in im] - - def postprocess(self, preds, img, orig_imgs): - """Post-processes predictions for an image and returns them.""" - return preds - - def __call__(self, source=None, model=None, stream=False, *args, **kwargs): - """Performs inference on an image or stream.""" - self.stream = stream - if stream: - return self.stream_inference(source, model, *args, **kwargs) - else: - return list(self.stream_inference(source, model, *args, **kwargs)) # merge list of Result into one - - def predict_cli(self, source=None, model=None): - """ - Method used for CLI prediction. - - It uses always generator as outputs as not required by CLI mode. - """ - gen = self.stream_inference(source, model) - for _ in gen: # noqa, running CLI inference without accumulating any outputs (do not modify) - pass - - def setup_source(self, source): - """Sets up source and inference mode.""" - self.imgsz = check_imgsz(self.args.imgsz, stride=self.model.stride, min_dim=2) # check image size - self.transforms = ( - getattr( - self.model.model, - "transforms", - classify_transforms(self.imgsz[0], crop_fraction=self.args.crop_fraction), - ) - if self.args.task == "classify" - else None - ) - self.dataset = load_inference_source( - source=source, - batch=self.args.batch, - vid_stride=self.args.vid_stride, - buffer=self.args.stream_buffer, - ) - self.source_type = self.dataset.source_type - if not getattr(self, "stream", True) and ( - self.source_type.stream - or self.source_type.screenshot - or len(self.dataset) > 1000 # many images - or any(getattr(self.dataset, "video_flag", [False])) - ): # videos - LOGGER.warning(STREAM_WARNING) - self.vid_writer = {} - - @smart_inference_mode() - def stream_inference(self, source=None, model=None, *args, **kwargs): - """Streams real-time inference on camera feed and saves results to file.""" - if self.args.verbose: - LOGGER.info("") - - # Setup model - if not self.model: - self.setup_model(model) - - with self._lock: # for thread-safe inference - # Setup source every time predict is called - self.setup_source(source if source is not None else self.args.source) - - # Check if save_dir/ label file exists - if self.args.save or self.args.save_txt: - (self.save_dir / "labels" if self.args.save_txt else self.save_dir).mkdir(parents=True, exist_ok=True) - - # Warmup model - if not self.done_warmup: - self.model.warmup(imgsz=(1 if self.model.pt or self.model.triton else self.dataset.bs, 3, *self.imgsz)) - self.done_warmup = True - - self.seen, self.windows, self.batch = 0, [], None - profilers = ( - ops.Profile(device=self.device), - ops.Profile(device=self.device), - ops.Profile(device=self.device), - ) - self.run_callbacks("on_predict_start") - for self.batch in self.dataset: - self.run_callbacks("on_predict_batch_start") - paths, im0s, s = self.batch - - # Preprocess - with profilers[0]: - im = self.preprocess(im0s) - - # Inference - with profilers[1]: - preds = self.inference(im, *args, **kwargs) - if self.args.embed: - yield from [preds] if isinstance(preds, torch.Tensor) else preds # yield embedding tensors - continue - - # Postprocess - with profilers[2]: - self.results = self.postprocess(preds, im, im0s) - self.run_callbacks("on_predict_postprocess_end") - - # Visualize, save, write results - n = len(im0s) - for i in range(n): - self.seen += 1 - self.results[i].speed = { - "preprocess": profilers[0].dt * 1e3 / n, - "inference": profilers[1].dt * 1e3 / n, - "postprocess": profilers[2].dt * 1e3 / n, - } - if self.args.verbose or self.args.save or self.args.save_txt or self.args.show: - s[i] += self.write_results(i, Path(paths[i]), im, s) - - # Print batch results - if self.args.verbose: - LOGGER.info("\n".join(s)) - - self.run_callbacks("on_predict_batch_end") - yield from self.results - - # Release assets - for v in self.vid_writer.values(): - if isinstance(v, cv2.VideoWriter): - v.release() - - # Print final results - if self.args.verbose and self.seen: - t = tuple(x.t / self.seen * 1e3 for x in profilers) # speeds per image - LOGGER.info( - f"Speed: %.1fms preprocess, %.1fms inference, %.1fms postprocess per image at shape " - f"{(min(self.args.batch, self.seen), 3, *im.shape[2:])}" % t - ) - if self.args.save or self.args.save_txt or self.args.save_crop: - nl = len(list(self.save_dir.glob("labels/*.txt"))) # number of labels - s = f"\n{nl} label{'s' * (nl > 1)} saved to {self.save_dir / 'labels'}" if self.args.save_txt else "" - LOGGER.info(f"Results saved to {colorstr('bold', self.save_dir)}{s}") - self.run_callbacks("on_predict_end") - - def setup_model(self, model, verbose=True): - """Initialize YOLO model with given parameters and set it to evaluation mode.""" - self.model = AutoBackend( - weights=model or self.args.model, - device=select_device(self.args.device, verbose=verbose), - dnn=self.args.dnn, - data=self.args.data, - fp16=self.args.half, - batch=self.args.batch, - fuse=True, - verbose=verbose, - ) - - self.device = self.model.device # update device - self.args.half = self.model.fp16 # update half - self.model.eval() - - def write_results(self, i, p, im, s): - """Write inference results to a file or directory.""" - string = "" # print string - if len(im.shape) == 3: - im = im[None] # expand for batch dim - if self.source_type.stream or self.source_type.from_img or self.source_type.tensor: # batch_size >= 1 - string += f"{i}: " - frame = self.dataset.count - else: - match = re.search(r"frame (\d+)/", s[i]) - frame = int(match.group(1)) if match else None # 0 if frame undetermined - - self.txt_path = self.save_dir / "labels" / (p.stem + ("" if self.dataset.mode == "image" else f"_{frame}")) - string += "%gx%g " % im.shape[2:] - result = self.results[i] - result.save_dir = self.save_dir.__str__() # used in other locations - string += result.verbose() + f"{result.speed['inference']:.1f}ms" - - # Add predictions to image - if self.args.save or self.args.show: - self.plotted_img = result.plot( - line_width=self.args.line_width, - boxes=self.args.show_boxes, - conf=self.args.show_conf, - labels=self.args.show_labels, - im_gpu=None if self.args.retina_masks else im[i], - ) - - # Save results - if self.args.save_txt: - result.save_txt(f"{self.txt_path}.txt", save_conf=self.args.save_conf) - if self.args.save_crop: - result.save_crop(save_dir=self.save_dir / "crops", file_name=self.txt_path.stem) - if self.args.show: - self.show(str(p)) - if self.args.save: - self.save_predicted_images(str(self.save_dir / p.name), frame) - - return string - - def save_predicted_images(self, save_path="", frame=0): - """Save video predictions as mp4 at specified path.""" - im = self.plotted_img - - # Save videos and streams - if self.dataset.mode in {"stream", "video"}: - fps = self.dataset.fps if self.dataset.mode == "video" else 30 - frames_path = f'{save_path.split(".", 1)[0]}_frames/' - if save_path not in self.vid_writer: # new video - if self.args.save_frames: - Path(frames_path).mkdir(parents=True, exist_ok=True) - suffix, fourcc = (".mp4", "avc1") if MACOS else (".avi", "WMV2") if WINDOWS else (".avi", "MJPG") - self.vid_writer[save_path] = cv2.VideoWriter( - filename=str(Path(save_path).with_suffix(suffix)), - fourcc=cv2.VideoWriter_fourcc(*fourcc), - fps=fps, # integer required, floats produce error in MP4 codec - frameSize=(im.shape[1], im.shape[0]), # (width, height) - ) - - # Save video - self.vid_writer[save_path].write(im) - if self.args.save_frames: - cv2.imwrite(f"{frames_path}{frame}.jpg", im) - - # Save images - else: - cv2.imwrite(save_path, im) - - def show(self, p=""): - """Display an image in a window using OpenCV imshow().""" - im = self.plotted_img - if platform.system() == "Linux" and p not in self.windows: - self.windows.append(p) - cv2.namedWindow(p, cv2.WINDOW_NORMAL | cv2.WINDOW_KEEPRATIO) # allow window resize (Linux) - cv2.resizeWindow(p, im.shape[1], im.shape[0]) # (width, height) - cv2.imshow(p, im) - cv2.waitKey(300 if self.dataset.mode == "image" else 1) # 1 millisecond - - def run_callbacks(self, event: str): - """Runs all registered callbacks for a specific event.""" - for callback in self.callbacks.get(event, []): - callback(self) - - def add_callback(self, event: str, func): - """Add callback.""" - self.callbacks[event].append(func) diff --git a/ultralytics-main/ultralytics/engine/results.py b/ultralytics-main/ultralytics/engine/results.py deleted file mode 100644 index 96c9449..0000000 --- a/ultralytics-main/ultralytics/engine/results.py +++ /dev/null @@ -1,728 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -""" -Ultralytics Results, Boxes and Masks classes for handling inference results. - -Usage: See https://docs.ultralytics.com/modes/predict/ -""" - -from copy import deepcopy -from functools import lru_cache -from pathlib import Path -import numpy as np -import torch -from ultralytics.data.augment import LetterBox -from ultralytics.utils import LOGGER, SimpleClass, ops -from ultralytics.utils.plotting import Annotator, colors, save_one_box -from ultralytics.utils.torch_utils import smart_inference_mode - - -class BaseTensor(SimpleClass): - """Base tensor class with additional methods for easy manipulation and device handling.""" - - def __init__(self, data, orig_shape) -> None: - """ - Initialize BaseTensor with data and original shape. - - Args: - data (torch.Tensor | np.ndarray): Predictions, such as bboxes, masks and keypoints. - orig_shape (tuple): Original shape of image. - """ - assert isinstance(data, (torch.Tensor, np.ndarray)) - self.data = data - self.orig_shape = orig_shape - - @property - def shape(self): - """Return the shape of the data tensor.""" - return self.data.shape - - def cpu(self): - """Return a copy of the tensor on CPU memory.""" - return self if isinstance(self.data, np.ndarray) else self.__class__(self.data.cpu(), self.orig_shape) - - def numpy(self): - """Return a copy of the tensor as a numpy array.""" - return self if isinstance(self.data, np.ndarray) else self.__class__(self.data.numpy(), self.orig_shape) - - def cuda(self): - """Return a copy of the tensor on GPU memory.""" - return self.__class__(torch.as_tensor(self.data).cuda(), self.orig_shape) - - def to(self, *args, **kwargs): - """Return a copy of the tensor with the specified device and dtype.""" - return self.__class__(torch.as_tensor(self.data).to(*args, **kwargs), self.orig_shape) - - def __len__(self): # override len(results) - """Return the length of the data tensor.""" - return len(self.data) - - def __getitem__(self, idx): - """Return a BaseTensor with the specified index of the data tensor.""" - return self.__class__(self.data[idx], self.orig_shape) - - -class Results(SimpleClass): - """ - A class for storing and manipulating inference results. - - Attributes: - orig_img (numpy.ndarray): Original image as a numpy array. - orig_shape (tuple): Original image shape in (height, width) format. - boxes (Boxes, optional): Object containing detection bounding boxes. - masks (Masks, optional): Object containing detection masks. - probs (Probs, optional): Object containing class probabilities for classification tasks. - keypoints (Keypoints, optional): Object containing detected keypoints for each object. - speed (dict): Dictionary of preprocess, inference, and postprocess speeds (ms/image). - names (dict): Dictionary of class names. - path (str): Path to the image file. - - Methods: - update(boxes=None, masks=None, probs=None, obb=None): Updates object attributes with new detection results. - cpu(): Returns a copy of the Results object with all tensors on CPU memory. - numpy(): Returns a copy of the Results object with all tensors as numpy arrays. - cuda(): Returns a copy of the Results object with all tensors on GPU memory. - to(*args, **kwargs): Returns a copy of the Results object with tensors on a specified device and dtype. - new(): Returns a new Results object with the same image, path, and names. - plot(...): Plots detection results on an input image, returning an annotated image. - show(): Show annotated results to screen. - save(filename): Save annotated results to file. - verbose(): Returns a log string for each task, detailing detections and classifications. - save_txt(txt_file, save_conf=False): Saves detection results to a text file. - save_crop(save_dir, file_name=Path("im.jpg")): Saves cropped detection images. - tojson(normalize=False): Converts detection results to JSON format. - """ - - def __init__(self, orig_img, path, names, boxes=None, masks=None, probs=None, keypoints=None, obb=None) -> None: - """ - Initialize the Results class. - - Args: - orig_img (numpy.ndarray): The original image as a numpy array. - path (str): The path to the image file. - names (dict): A dictionary of class names. - boxes (torch.tensor, optional): A 2D tensor of bounding box coordinates for each detection. - masks (torch.tensor, optional): A 3D tensor of detection masks, where each mask is a binary image. - probs (torch.tensor, optional): A 1D tensor of probabilities of each class for classification task. - keypoints (torch.tensor, optional): A 2D tensor of keypoint coordinates for each detection. - obb (torch.tensor, optional): A 2D tensor of oriented bounding box coordinates for each detection. - """ - self.orig_img = orig_img - self.orig_shape = orig_img.shape[:2] - self.boxes = Boxes(boxes, self.orig_shape) if boxes is not None else None # native size boxes - self.masks = Masks(masks, self.orig_shape) if masks is not None else None # native size or imgsz masks - self.probs = Probs(probs) if probs is not None else None - self.keypoints = Keypoints(keypoints, self.orig_shape) if keypoints is not None else None - self.obb = OBB(obb, self.orig_shape) if obb is not None else None - self.speed = {"preprocess": None, "inference": None, "postprocess": None} # milliseconds per image - self.names = names - self.path = path - self.save_dir = None - self._keys = "boxes", "masks", "probs", "keypoints", "obb" - - def __getitem__(self, idx): - """Return a Results object for the specified index.""" - return self._apply("__getitem__", idx) - - def __len__(self): - """Return the number of detections in the Results object.""" - for k in self._keys: - v = getattr(self, k) - if v is not None: - return len(v) - - def update(self, boxes=None, masks=None, probs=None, obb=None): - """Update the boxes, masks, and probs attributes of the Results object.""" - if boxes is not None: - self.boxes = Boxes(ops.clip_boxes(boxes, self.orig_shape), self.orig_shape) - if masks is not None: - self.masks = Masks(masks, self.orig_shape) - if probs is not None: - self.probs = probs - if obb is not None: - self.obb = OBB(obb, self.orig_shape) - - def _apply(self, fn, *args, **kwargs): - """ - Applies a function to all non-empty attributes and returns a new Results object with modified attributes. This - function is internally called by methods like .to(), .cuda(), .cpu(), etc. - - Args: - fn (str): The name of the function to apply. - *args: Variable length argument list to pass to the function. - **kwargs: Arbitrary keyword arguments to pass to the function. - - Returns: - Results: A new Results object with attributes modified by the applied function. - """ - r = self.new() - for k in self._keys: - v = getattr(self, k) - if v is not None: - setattr(r, k, getattr(v, fn)(*args, **kwargs)) - return r - - def cpu(self): - """Return a copy of the Results object with all tensors on CPU memory.""" - return self._apply("cpu") - - def numpy(self): - """Return a copy of the Results object with all tensors as numpy arrays.""" - return self._apply("numpy") - - def cuda(self): - """Return a copy of the Results object with all tensors on GPU memory.""" - return self._apply("cuda") - - def to(self, *args, **kwargs): - """Return a copy of the Results object with tensors on the specified device and dtype.""" - return self._apply("to", *args, **kwargs) - - def new(self): - """Return a new Results object with the same image, path, and names.""" - return Results(orig_img=self.orig_img, path=self.path, names=self.names) - - def plot( - self, - conf=True, - line_width=None, - font_size=None, - font="Arial.ttf", - pil=False, - img=None, - im_gpu=None, - kpt_radius=5, - kpt_line=True, - labels=True, - boxes=True, - masks=True, - probs=True, - show=False, - save=False, - filename=None, - ): - """ - Plots the detection results on an input RGB image. Accepts a numpy array (cv2) or a PIL Image. - - Args: - conf (bool): Whether to plot the detection confidence score. - line_width (float, optional): The line width of the bounding boxes. If None, it is scaled to the image size. - font_size (float, optional): The font size of the text. If None, it is scaled to the image size. - font (str): The font to use for the text. - pil (bool): Whether to return the image as a PIL Image. - img (numpy.ndarray): Plot to another image. if not, plot to original image. - im_gpu (torch.Tensor): Normalized image in gpu with shape (1, 3, 640, 640), for faster mask plotting. - kpt_radius (int, optional): Radius of the drawn keypoints. Default is 5. - kpt_line (bool): Whether to draw lines connecting keypoints. - labels (bool): Whether to plot the label of bounding boxes. - boxes (bool): Whether to plot the bounding boxes. - masks (bool): Whether to plot the masks. - probs (bool): Whether to plot classification probability - show (bool): Whether to display the annotated image directly. - save (bool): Whether to save the annotated image to `filename`. - filename (str): Filename to save image to if save is True. - - Returns: - (numpy.ndarray): A numpy array of the annotated image. - - Example: - ```python - from PIL import Image - from ultralytics import YOLO - - model = YOLO('yolov8n.pt') - results = model('bus.jpg') # results list - for r in results: - im_array = r.plot() # plot a BGR numpy array of predictions - im = Image.fromarray(im_array[..., ::-1]) # RGB PIL image - im.show() # show image - im.save('results.jpg') # save image - ``` - """ - if img is None and isinstance(self.orig_img, torch.Tensor): - img = (self.orig_img[0].detach().permute(1, 2, 0).contiguous() * 255).to(torch.uint8).cpu().numpy() - - names = self.names - is_obb = self.obb is not None - pred_boxes, show_boxes = self.obb if is_obb else self.boxes, boxes - pred_masks, show_masks = self.masks, masks - pred_probs, show_probs = self.probs, probs - annotator = Annotator( - deepcopy(self.orig_img if img is None else img), - line_width, - font_size, - font, - pil or (pred_probs is not None and show_probs), # Classify tasks default to pil=True - example=names, - ) - - # Plot Segment results - if pred_masks and show_masks: - if im_gpu is None: - img = LetterBox(pred_masks.shape[1:])(image=annotator.result()) - im_gpu = ( - torch.as_tensor(img, dtype=torch.float16, device=pred_masks.data.device) - .permute(2, 0, 1) - .flip(0) - .contiguous() - / 255 - ) - idx = pred_boxes.cls if pred_boxes else range(len(pred_masks)) - annotator.masks(pred_masks.data, colors=[colors(x, True) for x in idx], im_gpu=im_gpu) - - # Plot Detect results - if pred_boxes is not None and show_boxes: - for d in reversed(pred_boxes): - c, conf, id = int(d.cls), float(d.conf) if conf else None, None if d.id is None else int(d.id.item()) - name = ("" if id is None else f"id:{id} ") + names[c] - label = (f"{name} {conf:.2f}" if conf else name) if labels else None - box = d.xyxyxyxy.reshape(-1, 4, 2).squeeze() if is_obb else d.xyxy.squeeze() - annotator.box_label(box, label, color=colors(c, True), rotated=is_obb) - - # Plot Classify results - if pred_probs is not None and show_probs: - text = ",\n".join(f"{names[j] if names else j} {pred_probs.data[j]:.2f}" for j in pred_probs.top5) - x = round(self.orig_shape[0] * 0.03) - annotator.text([x, x], text, txt_color=(255, 255, 255)) # TODO: allow setting colors - - # Plot Pose results - if self.keypoints is not None: - for k in reversed(self.keypoints.data): - annotator.kpts(k, self.orig_shape, radius=kpt_radius, kpt_line=kpt_line) - - # Show results - if show: - annotator.show(self.path) - - # Save results - if save: - annotator.save(filename) - - return annotator.result() - - def show(self, *args, **kwargs): - """Show annotated results image.""" - self.plot(show=True, *args, **kwargs) - - def save(self, filename=None, *args, **kwargs): - """Save annotated results image.""" - if not filename: - filename = f"results_{Path(self.path).name}" - self.plot(save=True, filename=filename, *args, **kwargs) - return filename - - def verbose(self): - """Return log string for each task.""" - log_string = "" - probs = self.probs - boxes = self.boxes - if len(self) == 0: - return log_string if probs is not None else f"{log_string}(no detections), " - if probs is not None: - log_string += f"{', '.join(f'{self.names[j]} {probs.data[j]:.2f}' for j in probs.top5)}, " - if boxes: - for c in boxes.cls.unique(): - n = (boxes.cls == c).sum() # detections per class - log_string += f"{n} {self.names[int(c)]}{'s' * (n > 1)}, " - return log_string - - def save_txt(self, txt_file, save_conf=False): - """ - Save predictions into txt file. - - Args: - txt_file (str): txt file path. - save_conf (bool): save confidence score or not. - """ - is_obb = self.obb is not None - boxes = self.obb if is_obb else self.boxes - masks = self.masks - probs = self.probs - kpts = self.keypoints - texts = [] - if probs is not None: - # Classify - [texts.append(f"{probs.data[j]:.2f} {self.names[j]}") for j in probs.top5] - elif boxes: - # Detect/segment/pose - for j, d in enumerate(boxes): - c, conf, id = int(d.cls), float(d.conf), None if d.id is None else int(d.id.item()) - line = (c, *(d.xyxyxyxyn.view(-1) if is_obb else d.xywhn.view(-1))) - if masks: - seg = masks[j].xyn[0].copy().reshape(-1) # reversed mask.xyn, (n,2) to (n*2) - line = (c, *seg) - if kpts is not None: - kpt = torch.cat((kpts[j].xyn, kpts[j].conf[..., None]), 2) if kpts[j].has_visible else kpts[j].xyn - line += (*kpt.reshape(-1).tolist(),) - line += (conf,) * save_conf + (() if id is None else (id,)) - texts.append(("%g " * len(line)).rstrip() % line) - - if texts: - Path(txt_file).parent.mkdir(parents=True, exist_ok=True) # make directory - with open(txt_file, "a") as f: - f.writelines(text + "\n" for text in texts) - - def save_crop(self, save_dir, file_name=Path("im.jpg")): - """ - Save cropped predictions to `save_dir/cls/file_name.jpg`. - - Args: - save_dir (str | pathlib.Path): Save path. - file_name (str | pathlib.Path): File name. - """ - if self.probs is not None: - LOGGER.warning("WARNING ⚠️ Classify task do not support `save_crop`.") - return - if self.obb is not None: - LOGGER.warning("WARNING ⚠️ OBB task do not support `save_crop`.") - return - for d in self.boxes: - save_one_box( - d.xyxy, - self.orig_img.copy(), - file=Path(save_dir) / self.names[int(d.cls)] / f"{Path(file_name)}.jpg", - BGR=True, - ) - - def tojson(self, normalize=False): - """Convert the object to JSON format.""" - if self.probs is not None: - LOGGER.warning("Warning: Classify task do not support `tojson` yet.") - return - - import json - - # Create list of detection dictionaries - results = [] - data = self.boxes.data.cpu().tolist() - h, w = self.orig_shape if normalize else (1, 1) - for i, row in enumerate(data): # xyxy, track_id if tracking, conf, class_id - box = {"x1": row[0] / w, "y1": row[1] / h, "x2": row[2] / w, "y2": row[3] / h} - conf = row[-2] - class_id = int(row[-1]) - name = self.names[class_id] - result = {"name": name, "class": class_id, "confidence": conf, "box": box} - if self.boxes.is_track: - result["track_id"] = int(row[-3]) # track ID - if self.masks: - x, y = self.masks.xy[i][:, 0], self.masks.xy[i][:, 1] # numpy array - result["segments"] = {"x": (x / w).tolist(), "y": (y / h).tolist()} - if self.keypoints is not None: - x, y, visible = self.keypoints[i].data[0].cpu().unbind(dim=1) # torch Tensor - result["keypoints"] = {"x": (x / w).tolist(), "y": (y / h).tolist(), "visible": visible.tolist()} - results.append(result) - - # Convert detections to JSON - return json.dumps(results, indent=2) - - -class Boxes(BaseTensor): - """ - Manages detection boxes, providing easy access and manipulation of box coordinates, confidence scores, class - identifiers, and optional tracking IDs. Supports multiple formats for box coordinates, including both absolute and - normalized forms. - - Attributes: - data (torch.Tensor): The raw tensor containing detection boxes and their associated data. - orig_shape (tuple): The original image size as a tuple (height, width), used for normalization. - is_track (bool): Indicates whether tracking IDs are included in the box data. - - Properties: - xyxy (torch.Tensor | numpy.ndarray): Boxes in [x1, y1, x2, y2] format. - conf (torch.Tensor | numpy.ndarray): Confidence scores for each box. - cls (torch.Tensor | numpy.ndarray): Class labels for each box. - id (torch.Tensor | numpy.ndarray, optional): Tracking IDs for each box, if available. - xywh (torch.Tensor | numpy.ndarray): Boxes in [x, y, width, height] format, calculated on demand. - xyxyn (torch.Tensor | numpy.ndarray): Normalized [x1, y1, x2, y2] boxes, relative to `orig_shape`. - xywhn (torch.Tensor | numpy.ndarray): Normalized [x, y, width, height] boxes, relative to `orig_shape`. - - Methods: - cpu(): Moves the boxes to CPU memory. - numpy(): Converts the boxes to a numpy array format. - cuda(): Moves the boxes to CUDA (GPU) memory. - to(device, dtype=None): Moves the boxes to the specified device. - """ - - def __init__(self, boxes, orig_shape) -> None: - """ - Initialize the Boxes class. - - Args: - boxes (torch.Tensor | numpy.ndarray): A tensor or numpy array containing the detection boxes, with - shape (num_boxes, 6) or (num_boxes, 7). The last two columns contain confidence and class values. - If present, the third last column contains track IDs. - orig_shape (tuple): Original image size, in the format (height, width). - """ - if boxes.ndim == 1: - boxes = boxes[None, :] - n = boxes.shape[-1] - assert n in (6, 7), f"expected 6 or 7 values but got {n}" # xyxy, track_id, conf, cls - super().__init__(boxes, orig_shape) - self.is_track = n == 7 - self.orig_shape = orig_shape - - @property - def xyxy(self): - """Return the boxes in xyxy format.""" - return self.data[:, :4] - - @property - def conf(self): - """Return the confidence values of the boxes.""" - return self.data[:, -2] - - @property - def cls(self): - """Return the class values of the boxes.""" - return self.data[:, -1] - - @property - def id(self): - """Return the track IDs of the boxes (if available).""" - return self.data[:, -3] if self.is_track else None - - @property - @lru_cache(maxsize=2) # maxsize 1 should suffice - def xywh(self): - """Return the boxes in xywh format.""" - return ops.xyxy2xywh(self.xyxy) - - @property - @lru_cache(maxsize=2) - def xyxyn(self): - """Return the boxes in xyxy format normalized by original image size.""" - xyxy = self.xyxy.clone() if isinstance(self.xyxy, torch.Tensor) else np.copy(self.xyxy) - xyxy[..., [0, 2]] /= self.orig_shape[1] - xyxy[..., [1, 3]] /= self.orig_shape[0] - return xyxy - - @property - @lru_cache(maxsize=2) - def xywhn(self): - """Return the boxes in xywh format normalized by original image size.""" - xywh = ops.xyxy2xywh(self.xyxy) - xywh[..., [0, 2]] /= self.orig_shape[1] - xywh[..., [1, 3]] /= self.orig_shape[0] - return xywh - - -class Masks(BaseTensor): - """ - A class for storing and manipulating detection masks. - - Attributes: - xy (list): A list of segments in pixel coordinates. - xyn (list): A list of normalized segments. - - Methods: - cpu(): Returns the masks tensor on CPU memory. - numpy(): Returns the masks tensor as a numpy array. - cuda(): Returns the masks tensor on GPU memory. - to(device, dtype): Returns the masks tensor with the specified device and dtype. - """ - - def __init__(self, masks, orig_shape) -> None: - """Initialize the Masks class with the given masks tensor and original image shape.""" - if masks.ndim == 2: - masks = masks[None, :] - super().__init__(masks, orig_shape) - - @property - @lru_cache(maxsize=1) - def xyn(self): - """Return normalized segments.""" - return [ - ops.scale_coords(self.data.shape[1:], x, self.orig_shape, normalize=True) - for x in ops.masks2segments(self.data) - ] - - @property - @lru_cache(maxsize=1) - def xy(self): - """Return segments in pixel coordinates.""" - return [ - ops.scale_coords(self.data.shape[1:], x, self.orig_shape, normalize=False) - for x in ops.masks2segments(self.data) - ] - - -class Keypoints(BaseTensor): - """ - A class for storing and manipulating detection keypoints. - - Attributes: - xy (torch.Tensor): A collection of keypoints containing x, y coordinates for each detection. - xyn (torch.Tensor): A normalized version of xy with coordinates in the range [0, 1]. - conf (torch.Tensor): Confidence values associated with keypoints if available, otherwise None. - - Methods: - cpu(): Returns a copy of the keypoints tensor on CPU memory. - numpy(): Returns a copy of the keypoints tensor as a numpy array. - cuda(): Returns a copy of the keypoints tensor on GPU memory. - to(device, dtype): Returns a copy of the keypoints tensor with the specified device and dtype. - """ - - @smart_inference_mode() # avoid keypoints < conf in-place error - def __init__(self, keypoints, orig_shape) -> None: - """Initializes the Keypoints object with detection keypoints and original image size.""" - if keypoints.ndim == 2: - keypoints = keypoints[None, :] - if keypoints.shape[2] == 3: # x, y, conf - mask = keypoints[..., 2] < 0.5 # points with conf < 0.5 (not visible) - keypoints[..., :2][mask] = 0 - super().__init__(keypoints, orig_shape) - self.has_visible = self.data.shape[-1] == 3 - - @property - @lru_cache(maxsize=1) - def xy(self): - """Returns x, y coordinates of keypoints.""" - return self.data[..., :2] - - @property - @lru_cache(maxsize=1) - def xyn(self): - """Returns normalized x, y coordinates of keypoints.""" - xy = self.xy.clone() if isinstance(self.xy, torch.Tensor) else np.copy(self.xy) - xy[..., 0] /= self.orig_shape[1] - xy[..., 1] /= self.orig_shape[0] - return xy - - @property - @lru_cache(maxsize=1) - def conf(self): - """Returns confidence values of keypoints if available, else None.""" - return self.data[..., 2] if self.has_visible else None - - -class Probs(BaseTensor): - """ - A class for storing and manipulating classification predictions. - - Attributes: - top1 (int): Index of the top 1 class. - top5 (list[int]): Indices of the top 5 classes. - top1conf (torch.Tensor): Confidence of the top 1 class. - top5conf (torch.Tensor): Confidences of the top 5 classes. - - Methods: - cpu(): Returns a copy of the probs tensor on CPU memory. - numpy(): Returns a copy of the probs tensor as a numpy array. - cuda(): Returns a copy of the probs tensor on GPU memory. - to(): Returns a copy of the probs tensor with the specified device and dtype. - """ - - def __init__(self, probs, orig_shape=None) -> None: - """Initialize the Probs class with classification probabilities and optional original shape of the image.""" - super().__init__(probs, orig_shape) - - @property - @lru_cache(maxsize=1) - def top1(self): - """Return the index of top 1.""" - return int(self.data.argmax()) - - @property - @lru_cache(maxsize=1) - def top5(self): - """Return the indices of top 5.""" - return (-self.data).argsort(0)[:5].tolist() # this way works with both torch and numpy. - - @property - @lru_cache(maxsize=1) - def top1conf(self): - """Return the confidence of top 1.""" - return self.data[self.top1] - - @property - @lru_cache(maxsize=1) - def top5conf(self): - """Return the confidences of top 5.""" - return self.data[self.top5] - - -class OBB(BaseTensor): - """ - A class for storing and manipulating Oriented Bounding Boxes (OBB). - - Args: - boxes (torch.Tensor | numpy.ndarray): A tensor or numpy array containing the detection boxes, - with shape (num_boxes, 7) or (num_boxes, 8). The last two columns contain confidence and class values. - If present, the third last column contains track IDs, and the fifth column from the left contains rotation. - orig_shape (tuple): Original image size, in the format (height, width). - - Attributes: - xywhr (torch.Tensor | numpy.ndarray): The boxes in [x_center, y_center, width, height, rotation] format. - conf (torch.Tensor | numpy.ndarray): The confidence values of the boxes. - cls (torch.Tensor | numpy.ndarray): The class values of the boxes. - id (torch.Tensor | numpy.ndarray): The track IDs of the boxes (if available). - xyxyxyxyn (torch.Tensor | numpy.ndarray): The rotated boxes in xyxyxyxy format normalized by orig image size. - xyxyxyxy (torch.Tensor | numpy.ndarray): The rotated boxes in xyxyxyxy format. - xyxy (torch.Tensor | numpy.ndarray): The horizontal boxes in xyxyxyxy format. - data (torch.Tensor): The raw OBB tensor (alias for `boxes`). - - Methods: - cpu(): Move the object to CPU memory. - numpy(): Convert the object to a numpy array. - cuda(): Move the object to CUDA memory. - to(*args, **kwargs): Move the object to the specified device. - """ - - def __init__(self, boxes, orig_shape) -> None: - """Initialize the Boxes class.""" - if boxes.ndim == 1: - boxes = boxes[None, :] - n = boxes.shape[-1] - assert n in (7, 8), f"expected 7 or 8 values but got {n}" # xywh, rotation, track_id, conf, cls - super().__init__(boxes, orig_shape) - self.is_track = n == 8 - self.orig_shape = orig_shape - - @property - def xywhr(self): - """Return the rotated boxes in xywhr format.""" - return self.data[:, :5] - - @property - def conf(self): - """Return the confidence values of the boxes.""" - return self.data[:, -2] - - @property - def cls(self): - """Return the class values of the boxes.""" - return self.data[:, -1] - - @property - def id(self): - """Return the track IDs of the boxes (if available).""" - return self.data[:, -3] if self.is_track else None - - @property - @lru_cache(maxsize=2) - def xyxyxyxy(self): - """Return the boxes in xyxyxyxy format, (N, 4, 2).""" - return ops.xywhr2xyxyxyxy(self.xywhr) - - @property - @lru_cache(maxsize=2) - def xyxyxyxyn(self): - """Return the boxes in xyxyxyxy format, (N, 4, 2).""" - xyxyxyxyn = self.xyxyxyxy.clone() if isinstance(self.xyxyxyxy, torch.Tensor) else np.copy(self.xyxyxyxy) - xyxyxyxyn[..., 0] /= self.orig_shape[1] - xyxyxyxyn[..., 1] /= self.orig_shape[0] - return xyxyxyxyn - - @property - @lru_cache(maxsize=2) - def xyxy(self): - """ - Return the horizontal boxes in xyxy format, (N, 4). - - Accepts both torch and numpy boxes. - """ - x1 = self.xyxyxyxy[..., 0].min(1).values - x2 = self.xyxyxyxy[..., 0].max(1).values - y1 = self.xyxyxyxy[..., 1].min(1).values - y2 = self.xyxyxyxy[..., 1].max(1).values - xyxy = [x1, y1, x2, y2] - return np.stack(xyxy, axis=-1) if isinstance(self.data, np.ndarray) else torch.stack(xyxy, dim=-1) diff --git a/ultralytics-main/ultralytics/engine/trainer.py b/ultralytics-main/ultralytics/engine/trainer.py deleted file mode 100644 index 29d6f1d..0000000 --- a/ultralytics-main/ultralytics/engine/trainer.py +++ /dev/null @@ -1,758 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -""" -Train a model on a dataset. - -Usage: - $ yolo mode=train model=yolov8n.pt data=coco128.yaml imgsz=640 epochs=100 batch=16 -""" - -import math -import os -import subprocess -import time -import warnings -from copy import deepcopy -from datetime import datetime, timedelta -from pathlib import Path - -import numpy as np -import torch -from torch import distributed as dist -from torch import nn, optim - -from ultralytics.cfg import get_cfg, get_save_dir -from ultralytics.data.utils import check_cls_dataset, check_det_dataset -from ultralytics.nn.tasks import attempt_load_one_weight, attempt_load_weights -from ultralytics.utils import ( - DEFAULT_CFG, - LOGGER, - RANK, - TQDM, - __version__, - callbacks, - clean_url, - colorstr, - emojis, - yaml_save, -) -from ultralytics.utils.autobatch import check_train_batch_size -from ultralytics.utils.checks import check_amp, check_file, check_imgsz, check_model_file_from_stem, print_args -from ultralytics.utils.dist import ddp_cleanup, generate_ddp_command -from ultralytics.utils.files import get_latest_run -from ultralytics.utils.torch_utils import ( - EarlyStopping, - ModelEMA, - de_parallel, - init_seeds, - one_cycle, - select_device, - strip_optimizer, -) - - -class BaseTrainer: - """ - BaseTrainer. - - A base class for creating trainers. - - Attributes: - args (SimpleNamespace): Configuration for the trainer. - validator (BaseValidator): Validator instance. - model (nn.Module): Model instance. - callbacks (defaultdict): Dictionary of callbacks. - save_dir (Path): Directory to save results. - wdir (Path): Directory to save weights. - last (Path): Path to the last checkpoint. - best (Path): Path to the best checkpoint. - save_period (int): Save checkpoint every x epochs (disabled if < 1). - batch_size (int): Batch size for training. - epochs (int): Number of epochs to train for. - start_epoch (int): Starting epoch for training. - device (torch.device): Device to use for training. - amp (bool): Flag to enable AMP (Automatic Mixed Precision). - scaler (amp.GradScaler): Gradient scaler for AMP. - data (str): Path to data. - trainset (torch.utils.data.Dataset): Training dataset. - testset (torch.utils.data.Dataset): Testing dataset. - ema (nn.Module): EMA (Exponential Moving Average) of the model. - resume (bool): Resume training from a checkpoint. - lf (nn.Module): Loss function. - scheduler (torch.optim.lr_scheduler._LRScheduler): Learning rate scheduler. - best_fitness (float): The best fitness value achieved. - fitness (float): Current fitness value. - loss (float): Current loss value. - tloss (float): Total loss value. - loss_names (list): List of loss names. - csv (Path): Path to results CSV file. - """ - - def __init__(self, cfg=DEFAULT_CFG, overrides=None, _callbacks=None): - """ - Initializes the BaseTrainer class. - - Args: - cfg (str, optional): Path to a configuration file. Defaults to DEFAULT_CFG. - overrides (dict, optional): Configuration overrides. Defaults to None. - """ - self.args = get_cfg(cfg, overrides) - self.check_resume(overrides) - self.device = select_device(self.args.device, self.args.batch) - self.validator = None - self.metrics = None - self.plots = {} - init_seeds(self.args.seed + 1 + RANK, deterministic=self.args.deterministic) - - # Dirs - self.save_dir = get_save_dir(self.args) - self.args.name = self.save_dir.name # update name for loggers - self.wdir = self.save_dir / "weights" # weights dir - if RANK in (-1, 0): - self.wdir.mkdir(parents=True, exist_ok=True) # make dir - self.args.save_dir = str(self.save_dir) - yaml_save(self.save_dir / "args.yaml", vars(self.args)) # save run args - self.last, self.best = self.wdir / "last.pt", self.wdir / "best.pt" # checkpoint paths - self.save_period = self.args.save_period - - self.batch_size = self.args.batch - self.epochs = self.args.epochs - self.start_epoch = 0 - if RANK == -1: - print_args(vars(self.args)) - - # Device - if self.device.type in ("cpu", "mps"): - self.args.workers = 0 # faster CPU training as time dominated by inference, not dataloading - - # Model and Dataset - self.model = check_model_file_from_stem(self.args.model) # add suffix, i.e. yolov8n -> yolov8n.pt - try: - if self.args.task == "classify": - self.data = check_cls_dataset(self.args.data) - elif self.args.data.split(".")[-1] in ("yaml", "yml") or self.args.task in ( - "detect", - "segment", - "pose", - "obb", - ): - self.data = check_det_dataset(self.args.data) - if "yaml_file" in self.data: - self.args.data = self.data["yaml_file"] # for validating 'yolo train data=url.zip' usage - except Exception as e: - raise RuntimeError(emojis(f"Dataset '{clean_url(self.args.data)}' error ❌ {e}")) from e - - self.trainset, self.testset = self.get_dataset(self.data) - self.ema = None - - # Optimization utils init - self.lf = None - self.scheduler = None - - # Epoch level metrics - self.best_fitness = None - self.fitness = None - self.loss = None - self.tloss = None - self.loss_names = ["Loss"] - self.csv = self.save_dir / "results.csv" - self.plot_idx = [0, 1, 2] - - # Callbacks - self.callbacks = _callbacks or callbacks.get_default_callbacks() - if RANK in (-1, 0): - callbacks.add_integration_callbacks(self) - - def add_callback(self, event: str, callback): - """Appends the given callback.""" - self.callbacks[event].append(callback) - - def set_callback(self, event: str, callback): - """Overrides the existing callbacks with the given callback.""" - self.callbacks[event] = [callback] - - def run_callbacks(self, event: str): - """Run all existing callbacks associated with a particular event.""" - for callback in self.callbacks.get(event, []): - callback(self) - - def train(self): - """Allow device='', device=None on Multi-GPU systems to default to device=0.""" - if isinstance(self.args.device, str) and len(self.args.device): # i.e. device='0' or device='0,1,2,3' - world_size = len(self.args.device.split(",")) - elif isinstance(self.args.device, (tuple, list)): # i.e. device=[0, 1, 2, 3] (multi-GPU from CLI is list) - world_size = len(self.args.device) - elif torch.cuda.is_available(): # i.e. device=None or device='' or device=number - world_size = 1 # default to device 0 - else: # i.e. device='cpu' or 'mps' - world_size = 0 - - # Run subprocess if DDP training, else train normally - if world_size > 1 and "LOCAL_RANK" not in os.environ: - # Argument checks - if self.args.rect: - LOGGER.warning("WARNING ⚠️ 'rect=True' is incompatible with Multi-GPU training, setting 'rect=False'") - self.args.rect = False - if self.args.batch == -1: - LOGGER.warning( - "WARNING ⚠️ 'batch=-1' for AutoBatch is incompatible with Multi-GPU training, setting " - "default 'batch=16'" - ) - self.args.batch = 16 - - # Command - cmd, file = generate_ddp_command(world_size, self) - try: - LOGGER.info(f'{colorstr("DDP:")} debug command {" ".join(cmd)}') - subprocess.run(cmd, check=True) - except Exception as e: - raise e - finally: - ddp_cleanup(self, str(file)) - - else: - self._do_train(world_size) - - def _setup_scheduler(self): - """Initialize training learning rate scheduler.""" - if self.args.cos_lr: - self.lf = one_cycle(1, self.args.lrf, self.epochs) # cosine 1->hyp['lrf'] - else: - self.lf = lambda x: max(1 - x / self.epochs, 0) * (1.0 - self.args.lrf) + self.args.lrf # linear - self.scheduler = optim.lr_scheduler.LambdaLR(self.optimizer, lr_lambda=self.lf) - - def _setup_ddp(self, world_size): - """Initializes and sets the DistributedDataParallel parameters for training.""" - torch.cuda.set_device(RANK) - self.device = torch.device("cuda", RANK) - # LOGGER.info(f'DDP info: RANK {RANK}, WORLD_SIZE {world_size}, DEVICE {self.device}') - os.environ["NCCL_BLOCKING_WAIT"] = "1" # set to enforce timeout - dist.init_process_group( - "nccl" if dist.is_nccl_available() else "gloo", - timeout=timedelta(seconds=10800), # 3 hours - rank=RANK, - world_size=world_size, - ) - - def _setup_train(self, world_size): - """Builds dataloaders and optimizer on correct rank process.""" - - # Model - self.run_callbacks("on_pretrain_routine_start") - ckpt = self.setup_model() - self.model = self.model.to(self.device) - self.set_model_attributes() - - # Freeze layers - freeze_list = ( - self.args.freeze - if isinstance(self.args.freeze, list) - else range(self.args.freeze) - if isinstance(self.args.freeze, int) - else [] - ) - always_freeze_names = [".dfl"] # always freeze these layers - freeze_layer_names = [f"model.{x}." for x in freeze_list] + always_freeze_names - for k, v in self.model.named_parameters(): - # v.register_hook(lambda x: torch.nan_to_num(x)) # NaN to 0 (commented for erratic training results) - if any(x in k for x in freeze_layer_names): - LOGGER.info(f"Freezing layer '{k}'") - v.requires_grad = False - elif not v.requires_grad and v.dtype.is_floating_point: # only floating point Tensor can require gradients - LOGGER.info( - f"WARNING ⚠️ setting 'requires_grad=True' for frozen layer '{k}'. " - "See ultralytics.engine.trainer for customization of frozen layers." - ) - v.requires_grad = True - - # Check AMP - self.amp = torch.tensor(self.args.amp).to(self.device) # True or False - if self.amp and RANK in (-1, 0): # Single-GPU and DDP - callbacks_backup = callbacks.default_callbacks.copy() # backup callbacks as check_amp() resets them - self.amp = torch.tensor(check_amp(self.model), device=self.device) - callbacks.default_callbacks = callbacks_backup # restore callbacks - if RANK > -1 and world_size > 1: # DDP - dist.broadcast(self.amp, src=0) # broadcast the tensor from rank 0 to all other ranks (returns None) - self.amp = bool(self.amp) # as boolean - self.scaler = torch.cuda.amp.GradScaler(enabled=self.amp) - if world_size > 1: - self.model = nn.parallel.DistributedDataParallel(self.model, device_ids=[RANK]) - - # Check imgsz - gs = max(int(self.model.stride.max() if hasattr(self.model, "stride") else 32), 32) # grid size (max stride) - self.args.imgsz = check_imgsz(self.args.imgsz, stride=gs, floor=gs, max_dim=1) - self.stride = gs # for multiscale training - - # Batch size - if self.batch_size == -1 and RANK == -1: # single-GPU only, estimate best batch size - self.args.batch = self.batch_size = check_train_batch_size(self.model, self.args.imgsz, self.amp) - - # Dataloaders - batch_size = self.batch_size // max(world_size, 1) - self.train_loader = self.get_dataloader(self.trainset, batch_size=batch_size, rank=RANK, mode="train") - if RANK in (-1, 0): - # Note: When training DOTA dataset, double batch size could get OOM on images with >2000 objects. - self.test_loader = self.get_dataloader( - self.testset, batch_size=batch_size if self.args.task == "obb" else batch_size * 2, rank=-1, mode="val" - ) - self.validator = self.get_validator() - metric_keys = self.validator.metrics.keys + self.label_loss_items(prefix="val") - self.metrics = dict(zip(metric_keys, [0] * len(metric_keys))) - self.ema = ModelEMA(self.model) - if self.args.plots: - self.plot_training_labels() - - # Optimizer - self.accumulate = max(round(self.args.nbs / self.batch_size), 1) # accumulate loss before optimizing - weight_decay = self.args.weight_decay * self.batch_size * self.accumulate / self.args.nbs # scale weight_decay - iterations = math.ceil(len(self.train_loader.dataset) / max(self.batch_size, self.args.nbs)) * self.epochs - self.optimizer = self.build_optimizer( - model=self.model, - name=self.args.optimizer, - lr=self.args.lr0, - momentum=self.args.momentum, - decay=weight_decay, - iterations=iterations, - ) - # Scheduler - self._setup_scheduler() - self.stopper, self.stop = EarlyStopping(patience=self.args.patience), False - self.resume_training(ckpt) - self.scheduler.last_epoch = self.start_epoch - 1 # do not move - self.run_callbacks("on_pretrain_routine_end") - - def _do_train(self, world_size=1): - """Train completed, evaluate and plot if specified by arguments.""" - if world_size > 1: - self._setup_ddp(world_size) - self._setup_train(world_size) - - nb = len(self.train_loader) # number of batches - nw = max(round(self.args.warmup_epochs * nb), 100) if self.args.warmup_epochs > 0 else -1 # warmup iterations - last_opt_step = -1 - self.epoch_time = None - self.epoch_time_start = time.time() - self.train_time_start = time.time() - self.run_callbacks("on_train_start") - LOGGER.info( - f'Image sizes {self.args.imgsz} train, {self.args.imgsz} val\n' - f'Using {self.train_loader.num_workers * (world_size or 1)} dataloader workers\n' - f"Logging results to {colorstr('bold', self.save_dir)}\n" - f'Starting training for ' + (f"{self.args.time} hours..." if self.args.time else f"{self.epochs} epochs...") - ) - if self.args.close_mosaic: - base_idx = (self.epochs - self.args.close_mosaic) * nb - self.plot_idx.extend([base_idx, base_idx + 1, base_idx + 2]) - epoch = self.start_epoch - while True: - self.epoch = epoch - self.run_callbacks("on_train_epoch_start") - self.model.train() - if RANK != -1: - self.train_loader.sampler.set_epoch(epoch) - pbar = enumerate(self.train_loader) - # Update dataloader attributes (optional) - if epoch == (self.epochs - self.args.close_mosaic): - self._close_dataloader_mosaic() - self.train_loader.reset() - - if RANK in (-1, 0): - LOGGER.info(self.progress_string()) - pbar = TQDM(enumerate(self.train_loader), total=nb) - self.tloss = None - self.optimizer.zero_grad() - for i, batch in pbar: - self.run_callbacks("on_train_batch_start") - # Warmup - ni = i + nb * epoch - if ni <= nw: - xi = [0, nw] # x interp - self.accumulate = max(1, int(np.interp(ni, xi, [1, self.args.nbs / self.batch_size]).round())) - for j, x in enumerate(self.optimizer.param_groups): - # Bias lr falls from 0.1 to lr0, all other lrs rise from 0.0 to lr0 - x["lr"] = np.interp( - ni, xi, [self.args.warmup_bias_lr if j == 0 else 0.0, x["initial_lr"] * self.lf(epoch)] - ) - if "momentum" in x: - x["momentum"] = np.interp(ni, xi, [self.args.warmup_momentum, self.args.momentum]) - - # Forward - with torch.cuda.amp.autocast(self.amp): - batch = self.preprocess_batch(batch) - self.loss, self.loss_items = self.model(batch) - if RANK != -1: - self.loss *= world_size - self.tloss = ( - (self.tloss * i + self.loss_items) / (i + 1) if self.tloss is not None else self.loss_items - ) - - # Backward - self.scaler.scale(self.loss).backward() - - # Optimize - https://pytorch.org/docs/master/notes/amp_examples.html - if ni - last_opt_step >= self.accumulate: - self.optimizer_step() - last_opt_step = ni - - # Timed stopping - if self.args.time: - self.stop = (time.time() - self.train_time_start) > (self.args.time * 3600) - if RANK != -1: # if DDP training - broadcast_list = [self.stop if RANK == 0 else None] - dist.broadcast_object_list(broadcast_list, 0) # broadcast 'stop' to all ranks - self.stop = broadcast_list[0] - if self.stop: # training time exceeded - break - - # Log - mem = f"{torch.cuda.memory_reserved() / 1E9 if torch.cuda.is_available() else 0:.3g}G" # (GB) - loss_len = self.tloss.shape[0] if len(self.tloss.shape) else 1 - losses = self.tloss if loss_len > 1 else torch.unsqueeze(self.tloss, 0) - if RANK in (-1, 0): - pbar.set_description( - ("%11s" * 2 + "%11.4g" * (2 + loss_len)) - % (f"{epoch + 1}/{self.epochs}", mem, *losses, batch["cls"].shape[0], batch["img"].shape[-1]) - ) - self.run_callbacks("on_batch_end") - if self.args.plots and ni in self.plot_idx: - self.plot_training_samples(batch, ni) - - self.run_callbacks("on_train_batch_end") - - self.lr = {f"lr/pg{ir}": x["lr"] for ir, x in enumerate(self.optimizer.param_groups)} # for loggers - self.run_callbacks("on_train_epoch_end") - if RANK in (-1, 0): - final_epoch = epoch + 1 == self.epochs - self.ema.update_attr(self.model, include=["yaml", "nc", "args", "names", "stride", "class_weights"]) - - # Validation - if self.args.val or final_epoch or self.stopper.possible_stop or self.stop: - self.metrics, self.fitness = self.validate() - self.save_metrics(metrics={**self.label_loss_items(self.tloss), **self.metrics, **self.lr}) - self.stop |= self.stopper(epoch + 1, self.fitness) or final_epoch - if self.args.time: - self.stop |= (time.time() - self.train_time_start) > (self.args.time * 3600) - - # Save model - if self.args.save or final_epoch: - self.save_model() - self.run_callbacks("on_model_save") - - # Scheduler - t = time.time() - self.epoch_time = t - self.epoch_time_start - self.epoch_time_start = t - with warnings.catch_warnings(): - warnings.simplefilter("ignore") # suppress 'Detected lr_scheduler.step() before optimizer.step()' - if self.args.time: - mean_epoch_time = (t - self.train_time_start) / (epoch - self.start_epoch + 1) - self.epochs = self.args.epochs = math.ceil(self.args.time * 3600 / mean_epoch_time) - self._setup_scheduler() - self.scheduler.last_epoch = self.epoch # do not move - self.stop |= epoch >= self.epochs # stop if exceeded epochs - self.scheduler.step() - self.run_callbacks("on_fit_epoch_end") - torch.cuda.empty_cache() # clear GPU memory at end of epoch, may help reduce CUDA out of memory errors - - # Early Stopping - if RANK != -1: # if DDP training - broadcast_list = [self.stop if RANK == 0 else None] - dist.broadcast_object_list(broadcast_list, 0) # broadcast 'stop' to all ranks - self.stop = broadcast_list[0] - if self.stop: - break # must break all DDP ranks - epoch += 1 - - if RANK in (-1, 0): - # Do final val with best.pt - LOGGER.info( - f"\n{epoch - self.start_epoch + 1} epochs completed in " - f"{(time.time() - self.train_time_start) / 3600:.3f} hours." - ) - self.final_eval() - if self.args.plots: - self.plot_metrics() - self.run_callbacks("on_train_end") - torch.cuda.empty_cache() - self.run_callbacks("teardown") - - def save_model(self): - """Save model training checkpoints with additional metadata.""" - import pandas as pd # scope for faster startup - - metrics = {**self.metrics, **{"fitness": self.fitness}} - results = {k.strip(): v for k, v in pd.read_csv(self.csv).to_dict(orient="list").items()} - ckpt = { - "epoch": self.epoch, - "best_fitness": self.best_fitness, - "model": deepcopy(de_parallel(self.model)).half(), - "ema": deepcopy(self.ema.ema).half(), - "updates": self.ema.updates, - "optimizer": self.optimizer.state_dict(), - "train_args": vars(self.args), # save as dict - "train_metrics": metrics, - "train_results": results, - "date": datetime.now().isoformat(), - "version": __version__, - "license": "AGPL-3.0 (https://ultralytics.com/license)", - "docs": "https://docs.ultralytics.com", - } - - # Save last and best - torch.save(ckpt, self.last) - if self.best_fitness == self.fitness: - torch.save(ckpt, self.best) - if (self.save_period > 0) and (self.epoch > 0) and (self.epoch % self.save_period == 0): - torch.save(ckpt, self.wdir / f"epoch{self.epoch}.pt") - - @staticmethod - def get_dataset(data): - """ - Get train, val path from data dict if it exists. - - Returns None if data format is not recognized. - """ - return data["train"], data.get("val") or data.get("test") - - def setup_model(self): - """Load/create/download model for any task.""" - if isinstance(self.model, torch.nn.Module): # if model is loaded beforehand. No setup needed - return - - model, weights = self.model, None - ckpt = None - if str(model).endswith(".pt"): - weights, ckpt = attempt_load_one_weight(model) - cfg = ckpt["model"].yaml - else: - cfg = model - self.model = self.get_model(cfg=cfg, weights=weights, verbose=RANK == -1) # calls Model(cfg, weights) - return ckpt - - def optimizer_step(self): - """Perform a single step of the training optimizer with gradient clipping and EMA update.""" - self.scaler.unscale_(self.optimizer) # unscale gradients - torch.nn.utils.clip_grad_norm_(self.model.parameters(), max_norm=10.0) # clip gradients - self.scaler.step(self.optimizer) - self.scaler.update() - self.optimizer.zero_grad() - if self.ema: - self.ema.update(self.model) - - def preprocess_batch(self, batch): - """Allows custom preprocessing model inputs and ground truths depending on task type.""" - return batch - - def validate(self): - """ - Runs validation on test set using self.validator. - - The returned dict is expected to contain "fitness" key. - """ - metrics = self.validator(self) - fitness = metrics.pop("fitness", -self.loss.detach().cpu().numpy()) # use loss as fitness measure if not found - if not self.best_fitness or self.best_fitness < fitness: - self.best_fitness = fitness - return metrics, fitness - - def get_model(self, cfg=None, weights=None, verbose=True): - """Get model and raise NotImplementedError for loading cfg files.""" - raise NotImplementedError("This task trainer doesn't support loading cfg files") - - def get_validator(self): - """Returns a NotImplementedError when the get_validator function is called.""" - raise NotImplementedError("get_validator function not implemented in trainer") - - def get_dataloader(self, dataset_path, batch_size=16, rank=0, mode="train"): - """Returns dataloader derived from torch.data.Dataloader.""" - raise NotImplementedError("get_dataloader function not implemented in trainer") - - def build_dataset(self, img_path, mode="train", batch=None): - """Build dataset.""" - raise NotImplementedError("build_dataset function not implemented in trainer") - - def label_loss_items(self, loss_items=None, prefix="train"): - """ - Returns a loss dict with labelled training loss items tensor. - - Note: - This is not needed for classification but necessary for segmentation & detection - """ - return {"loss": loss_items} if loss_items is not None else ["loss"] - - def set_model_attributes(self): - """To set or update model parameters before training.""" - self.model.names = self.data["names"] - - def build_targets(self, preds, targets): - """Builds target tensors for training YOLO model.""" - pass - - def progress_string(self): - """Returns a string describing training progress.""" - return "" - - # TODO: may need to put these following functions into callback - def plot_training_samples(self, batch, ni): - """Plots training samples during YOLO training.""" - pass - - def plot_training_labels(self): - """Plots training labels for YOLO model.""" - pass - - def save_metrics(self, metrics): - """Saves training metrics to a CSV file.""" - keys, vals = list(metrics.keys()), list(metrics.values()) - n = len(metrics) + 1 # number of cols - s = "" if self.csv.exists() else (("%23s," * n % tuple(["epoch"] + keys)).rstrip(",") + "\n") # header - with open(self.csv, "a") as f: - f.write(s + ("%23.5g," * n % tuple([self.epoch + 1] + vals)).rstrip(",") + "\n") - - def plot_metrics(self): - """Plot and display metrics visually.""" - pass - - def on_plot(self, name, data=None): - """Registers plots (e.g. to be consumed in callbacks)""" - path = Path(name) - self.plots[path] = {"data": data, "timestamp": time.time()} - - def final_eval(self): - """Performs final evaluation and validation for object detection YOLO model.""" - for f in self.last, self.best: - if f.exists(): - strip_optimizer(f) # strip optimizers - if f is self.best: - LOGGER.info(f"\nValidating {f}...") - self.validator.args.plots = self.args.plots - self.metrics = self.validator(model=f) - self.metrics.pop("fitness", None) - self.run_callbacks("on_fit_epoch_end") - - def check_resume(self, overrides): - """Check if resume checkpoint exists and update arguments accordingly.""" - resume = self.args.resume - if resume: - try: - exists = isinstance(resume, (str, Path)) and Path(resume).exists() - last = Path(check_file(resume) if exists else get_latest_run()) - - # Check that resume data YAML exists, otherwise strip to force re-download of dataset - ckpt_args = attempt_load_weights(last).args - if not Path(ckpt_args["data"]).exists(): - ckpt_args["data"] = self.args.data - - resume = True - self.args = get_cfg(ckpt_args) - self.args.model = str(last) # reinstate model - for k in "imgsz", "batch": # allow arg updates to reduce memory on resume if crashed due to CUDA OOM - if k in overrides: - setattr(self.args, k, overrides[k]) - - except Exception as e: - raise FileNotFoundError( - "Resume checkpoint not found. Please pass a valid checkpoint to resume from, " - "i.e. 'yolo train resume model=path/to/last.pt'" - ) from e - self.resume = resume - - def resume_training(self, ckpt): - """Resume YOLO training from given epoch and best fitness.""" - if ckpt is None: - return - best_fitness = 0.0 - start_epoch = ckpt["epoch"] + 1 - if ckpt["optimizer"] is not None: - self.optimizer.load_state_dict(ckpt["optimizer"]) # optimizer - best_fitness = ckpt["best_fitness"] - if self.ema and ckpt.get("ema"): - self.ema.ema.load_state_dict(ckpt["ema"].float().state_dict()) # EMA - self.ema.updates = ckpt["updates"] - if self.resume: - assert start_epoch > 0, ( - f"{self.args.model} training to {self.epochs} epochs is finished, nothing to resume.\n" - f"Start a new training without resuming, i.e. 'yolo train model={self.args.model}'" - ) - LOGGER.info( - f"Resuming training from {self.args.model} from epoch {start_epoch + 1} to {self.epochs} total epochs" - ) - if self.epochs < start_epoch: - LOGGER.info( - f"{self.model} has been trained for {ckpt['epoch']} epochs. Fine-tuning for {self.epochs} more epochs." - ) - self.epochs += ckpt["epoch"] # finetune additional epochs - self.best_fitness = best_fitness - self.start_epoch = start_epoch - if start_epoch > (self.epochs - self.args.close_mosaic): - self._close_dataloader_mosaic() - - def _close_dataloader_mosaic(self): - """Update dataloaders to stop using mosaic augmentation.""" - if hasattr(self.train_loader.dataset, "mosaic"): - self.train_loader.dataset.mosaic = False - if hasattr(self.train_loader.dataset, "close_mosaic"): - LOGGER.info("Closing dataloader mosaic") - self.train_loader.dataset.close_mosaic(hyp=self.args) - - def build_optimizer(self, model, name="auto", lr=0.001, momentum=0.9, decay=1e-5, iterations=1e5): - """ - Constructs an optimizer for the given model, based on the specified optimizer name, learning rate, momentum, - weight decay, and number of iterations. - - Args: - model (torch.nn.Module): The model for which to build an optimizer. - name (str, optional): The name of the optimizer to use. If 'auto', the optimizer is selected - based on the number of iterations. Default: 'auto'. - lr (float, optional): The learning rate for the optimizer. Default: 0.001. - momentum (float, optional): The momentum factor for the optimizer. Default: 0.9. - decay (float, optional): The weight decay for the optimizer. Default: 1e-5. - iterations (float, optional): The number of iterations, which determines the optimizer if - name is 'auto'. Default: 1e5. - - Returns: - (torch.optim.Optimizer): The constructed optimizer. - """ - - g = [], [], [] # optimizer parameter groups - bn = tuple(v for k, v in nn.__dict__.items() if "Norm" in k) # normalization layers, i.e. BatchNorm2d() - if name == "auto": - LOGGER.info( - f"{colorstr('optimizer:')} 'optimizer=auto' found, " - f"ignoring 'lr0={self.args.lr0}' and 'momentum={self.args.momentum}' and " - f"determining best 'optimizer', 'lr0' and 'momentum' automatically... " - ) - nc = getattr(model, "nc", 10) # number of classes - lr_fit = round(0.002 * 5 / (4 + nc), 6) # lr0 fit equation to 6 decimal places - name, lr, momentum = ("SGD", 0.01, 0.9) if iterations > 10000 else ("AdamW", lr_fit, 0.9) - self.args.warmup_bias_lr = 0.0 # no higher than 0.01 for Adam - - for module_name, module in model.named_modules(): - for param_name, param in module.named_parameters(recurse=False): - fullname = f"{module_name}.{param_name}" if module_name else param_name - if "bias" in fullname: # bias (no decay) - g[2].append(param) - elif isinstance(module, bn): # weight (no decay) - g[1].append(param) - else: # weight (with decay) - g[0].append(param) - - if name in ("Adam", "Adamax", "AdamW", "NAdam", "RAdam"): - optimizer = getattr(optim, name, optim.Adam)(g[2], lr=lr, betas=(momentum, 0.999), weight_decay=0.0) - elif name == "RMSProp": - optimizer = optim.RMSprop(g[2], lr=lr, momentum=momentum) - elif name == "SGD": - optimizer = optim.SGD(g[2], lr=lr, momentum=momentum, nesterov=True) - else: - raise NotImplementedError( - f"Optimizer '{name}' not found in list of available optimizers " - f"[Adam, AdamW, NAdam, RAdam, RMSProp, SGD, auto]." - "To request support for addition optimizers please visit https://github.com/ultralytics/ultralytics." - ) - - optimizer.add_param_group({"params": g[0], "weight_decay": decay}) # add g0 with weight_decay - optimizer.add_param_group({"params": g[1], "weight_decay": 0.0}) # add g1 (BatchNorm2d weights) - LOGGER.info( - f"{colorstr('optimizer:')} {type(optimizer).__name__}(lr={lr}, momentum={momentum}) with parameter groups " - f'{len(g[1])} weight(decay=0.0), {len(g[0])} weight(decay={decay}), {len(g[2])} bias(decay=0.0)' - ) - return optimizer diff --git a/ultralytics-main/ultralytics/engine/tuner.py b/ultralytics-main/ultralytics/engine/tuner.py deleted file mode 100644 index a009e73..0000000 --- a/ultralytics-main/ultralytics/engine/tuner.py +++ /dev/null @@ -1,241 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -""" -This module provides functionalities for hyperparameter tuning of the Ultralytics YOLO models for object detection, -instance segmentation, image classification, pose estimation, and multi-object tracking. - -Hyperparameter tuning is the process of systematically searching for the optimal set of hyperparameters -that yield the best model performance. This is particularly crucial in deep learning models like YOLO, -where small changes in hyperparameters can lead to significant differences in model accuracy and efficiency. - -Example: - Tune hyperparameters for YOLOv8n on COCO8 at imgsz=640 and epochs=30 for 300 tuning iterations. - ```python - from ultralytics import YOLO - - model = YOLO('yolov8n.pt') - model.tune(data='coco8.yaml', epochs=10, iterations=300, optimizer='AdamW', plots=False, save=False, val=False) - ``` -""" - -import random -import shutil -import subprocess -import time - -import numpy as np -import torch - -from ultralytics.cfg import get_cfg, get_save_dir -from ultralytics.utils import DEFAULT_CFG, LOGGER, callbacks, colorstr, remove_colorstr, yaml_print, yaml_save -from ultralytics.utils.plotting import plot_tune_results - - -class Tuner: - """ - Class responsible for hyperparameter tuning of YOLO models. - - The class evolves YOLO model hyperparameters over a given number of iterations - by mutating them according to the search space and retraining the model to evaluate their performance. - - Attributes: - space (dict): Hyperparameter search space containing bounds and scaling factors for mutation. - tune_dir (Path): Directory where evolution logs and results will be saved. - tune_csv (Path): Path to the CSV file where evolution logs are saved. - - Methods: - _mutate(hyp: dict) -> dict: - Mutates the given hyperparameters within the bounds specified in `self.space`. - - __call__(): - Executes the hyperparameter evolution across multiple iterations. - - Example: - Tune hyperparameters for YOLOv8n on COCO8 at imgsz=640 and epochs=30 for 300 tuning iterations. - ```python - from ultralytics import YOLO - - model = YOLO('yolov8n.pt') - model.tune(data='coco8.yaml', epochs=10, iterations=300, optimizer='AdamW', plots=False, save=False, val=False) - ``` - - Tune with custom search space. - ```python - from ultralytics import YOLO - - model = YOLO('yolov8n.pt') - model.tune(space={key1: val1, key2: val2}) # custom search space dictionary - ``` - """ - - def __init__(self, args=DEFAULT_CFG, _callbacks=None): - """ - Initialize the Tuner with configurations. - - Args: - args (dict, optional): Configuration for hyperparameter evolution. - """ - self.space = args.pop("space", None) or { # key: (min, max, gain(optional)) - # 'optimizer': tune.choice(['SGD', 'Adam', 'AdamW', 'NAdam', 'RAdam', 'RMSProp']), - "lr0": (1e-5, 1e-1), # initial learning rate (i.e. SGD=1E-2, Adam=1E-3) - "lrf": (0.0001, 0.1), # final OneCycleLR learning rate (lr0 * lrf) - "momentum": (0.7, 0.98, 0.3), # SGD momentum/Adam beta1 - "weight_decay": (0.0, 0.001), # optimizer weight decay 5e-4 - "warmup_epochs": (0.0, 5.0), # warmup epochs (fractions ok) - "warmup_momentum": (0.0, 0.95), # warmup initial momentum - "box": (1.0, 20.0), # box loss gain - "cls": (0.2, 4.0), # cls loss gain (scale with pixels) - "dfl": (0.4, 6.0), # dfl loss gain - "hsv_h": (0.0, 0.1), # image HSV-Hue augmentation (fraction) - "hsv_s": (0.0, 0.9), # image HSV-Saturation augmentation (fraction) - "hsv_v": (0.0, 0.9), # image HSV-Value augmentation (fraction) - "degrees": (0.0, 45.0), # image rotation (+/- deg) - "translate": (0.0, 0.9), # image translation (+/- fraction) - "scale": (0.0, 0.95), # image scale (+/- gain) - "shear": (0.0, 10.0), # image shear (+/- deg) - "perspective": (0.0, 0.001), # image perspective (+/- fraction), range 0-0.001 - "flipud": (0.0, 1.0), # image flip up-down (probability) - "fliplr": (0.0, 1.0), # image flip left-right (probability) - "mosaic": (0.0, 1.0), # image mixup (probability) - "mixup": (0.0, 1.0), # image mixup (probability) - "copy_paste": (0.0, 1.0), # segment copy-paste (probability) - } - self.args = get_cfg(overrides=args) - self.tune_dir = get_save_dir(self.args, name="tune") - self.tune_csv = self.tune_dir / "tune_results.csv" - self.callbacks = _callbacks or callbacks.get_default_callbacks() - self.prefix = colorstr("Tuner: ") - callbacks.add_integration_callbacks(self) - LOGGER.info( - f"{self.prefix}Initialized Tuner instance with 'tune_dir={self.tune_dir}'\n" - f"{self.prefix}💡 Learn about tuning at https://docs.ultralytics.com/guides/hyperparameter-tuning" - ) - - def _mutate(self, parent="single", n=5, mutation=0.8, sigma=0.2): - """ - Mutates the hyperparameters based on bounds and scaling factors specified in `self.space`. - - Args: - parent (str): Parent selection method: 'single' or 'weighted'. - n (int): Number of parents to consider. - mutation (float): Probability of a parameter mutation in any given iteration. - sigma (float): Standard deviation for Gaussian random number generator. - - Returns: - (dict): A dictionary containing mutated hyperparameters. - """ - if self.tune_csv.exists(): # if CSV file exists: select best hyps and mutate - # Select parent(s) - x = np.loadtxt(self.tune_csv, ndmin=2, delimiter=",", skiprows=1) - fitness = x[:, 0] # first column - n = min(n, len(x)) # number of previous results to consider - x = x[np.argsort(-fitness)][:n] # top n mutations - w = x[:, 0] - x[:, 0].min() + 1e-6 # weights (sum > 0) - if parent == "single" or len(x) == 1: - # x = x[random.randint(0, n - 1)] # random selection - x = x[random.choices(range(n), weights=w)[0]] # weighted selection - elif parent == "weighted": - x = (x * w.reshape(n, 1)).sum(0) / w.sum() # weighted combination - - # Mutate - r = np.random # method - r.seed(int(time.time())) - g = np.array([v[2] if len(v) == 3 else 1.0 for k, v in self.space.items()]) # gains 0-1 - ng = len(self.space) - v = np.ones(ng) - while all(v == 1): # mutate until a change occurs (prevent duplicates) - v = (g * (r.random(ng) < mutation) * r.randn(ng) * r.random() * sigma + 1).clip(0.3, 3.0) - hyp = {k: float(x[i + 1] * v[i]) for i, k in enumerate(self.space.keys())} - else: - hyp = {k: getattr(self.args, k) for k in self.space.keys()} - - # Constrain to limits - for k, v in self.space.items(): - hyp[k] = max(hyp[k], v[0]) # lower limit - hyp[k] = min(hyp[k], v[1]) # upper limit - hyp[k] = round(hyp[k], 5) # significant digits - - return hyp - - def __call__(self, model=None, iterations=10, cleanup=True): - """ - Executes the hyperparameter evolution process when the Tuner instance is called. - - This method iterates through the number of iterations, performing the following steps in each iteration: - 1. Load the existing hyperparameters or initialize new ones. - 2. Mutate the hyperparameters using the `mutate` method. - 3. Train a YOLO model with the mutated hyperparameters. - 4. Log the fitness score and mutated hyperparameters to a CSV file. - - Args: - model (Model): A pre-initialized YOLO model to be used for training. - iterations (int): The number of generations to run the evolution for. - cleanup (bool): Whether to delete iteration weights to reduce storage space used during tuning. - - Note: - The method utilizes the `self.tune_csv` Path object to read and log hyperparameters and fitness scores. - Ensure this path is set correctly in the Tuner instance. - """ - - t0 = time.time() - best_save_dir, best_metrics = None, None - (self.tune_dir / "weights").mkdir(parents=True, exist_ok=True) - for i in range(iterations): - # Mutate hyperparameters - mutated_hyp = self._mutate() - LOGGER.info(f"{self.prefix}Starting iteration {i + 1}/{iterations} with hyperparameters: {mutated_hyp}") - - metrics = {} - train_args = {**vars(self.args), **mutated_hyp} - save_dir = get_save_dir(get_cfg(train_args)) - weights_dir = save_dir / "weights" - try: - # Train YOLO model with mutated hyperparameters (run in subprocess to avoid dataloader hang) - cmd = ["yolo", "train", *(f"{k}={v}" for k, v in train_args.items())] - return_code = subprocess.run(cmd, check=True).returncode - ckpt_file = weights_dir / ("best.pt" if (weights_dir / "best.pt").exists() else "last.pt") - metrics = torch.load(ckpt_file)["train_metrics"] - assert return_code == 0, "training failed" - - except Exception as e: - LOGGER.warning(f"WARNING ❌️ training failure for hyperparameter tuning iteration {i + 1}\n{e}") - - # Save results and mutated_hyp to CSV - fitness = metrics.get("fitness", 0.0) - log_row = [round(fitness, 5)] + [mutated_hyp[k] for k in self.space.keys()] - headers = "" if self.tune_csv.exists() else (",".join(["fitness"] + list(self.space.keys())) + "\n") - with open(self.tune_csv, "a") as f: - f.write(headers + ",".join(map(str, log_row)) + "\n") - - # Get best results - x = np.loadtxt(self.tune_csv, ndmin=2, delimiter=",", skiprows=1) - fitness = x[:, 0] # first column - best_idx = fitness.argmax() - best_is_current = best_idx == i - if best_is_current: - best_save_dir = save_dir - best_metrics = {k: round(v, 5) for k, v in metrics.items()} - for ckpt in weights_dir.glob("*.pt"): - shutil.copy2(ckpt, self.tune_dir / "weights") - elif cleanup: - shutil.rmtree(ckpt_file.parent) # remove iteration weights/ dir to reduce storage space - - # Plot tune results - plot_tune_results(self.tune_csv) - - # Save and print tune results - header = ( - f'{self.prefix}{i + 1}/{iterations} iterations complete ✅ ({time.time() - t0:.2f}s)\n' - f'{self.prefix}Results saved to {colorstr("bold", self.tune_dir)}\n' - f'{self.prefix}Best fitness={fitness[best_idx]} observed at iteration {best_idx + 1}\n' - f'{self.prefix}Best fitness metrics are {best_metrics}\n' - f'{self.prefix}Best fitness model is {best_save_dir}\n' - f'{self.prefix}Best fitness hyperparameters are printed below.\n' - ) - LOGGER.info("\n" + header) - data = {k: float(x[best_idx, i + 1]) for i, k in enumerate(self.space.keys())} - yaml_save( - self.tune_dir / "best_hyperparameters.yaml", - data=data, - header=remove_colorstr(header.replace(self.prefix, "# ")) + "\n", - ) - yaml_print(self.tune_dir / "best_hyperparameters.yaml") diff --git a/ultralytics-main/ultralytics/engine/validator.py b/ultralytics-main/ultralytics/engine/validator.py deleted file mode 100644 index 17666e3..0000000 --- a/ultralytics-main/ultralytics/engine/validator.py +++ /dev/null @@ -1,338 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -""" -Check a model's accuracy on a test or val split of a dataset. - -Usage: - $ yolo mode=val model=yolov8n.pt data=coco128.yaml imgsz=640 - -Usage - formats: - $ yolo mode=val model=yolov8n.pt # PyTorch - yolov8n.torchscript # TorchScript - yolov8n.onnx # ONNX Runtime or OpenCV DNN with dnn=True - yolov8n_openvino_model # OpenVINO - yolov8n.engine # TensorRT - yolov8n.mlpackage # CoreML (macOS-only) - yolov8n_saved_model # TensorFlow SavedModel - yolov8n.pb # TensorFlow GraphDef - yolov8n.tflite # TensorFlow Lite - yolov8n_edgetpu.tflite # TensorFlow Edge TPU - yolov8n_paddle_model # PaddlePaddle - yolov8n_ncnn_model # NCNN -""" - -import json -import time -from pathlib import Path - -import numpy as np -import torch - -from ultralytics.cfg import get_cfg, get_save_dir -from ultralytics.data.utils import check_cls_dataset, check_det_dataset -from ultralytics.nn.autobackend import AutoBackend -from ultralytics.utils import LOGGER, TQDM, callbacks, colorstr, emojis -from ultralytics.utils.checks import check_imgsz -from ultralytics.utils.ops import Profile -from ultralytics.utils.torch_utils import de_parallel, select_device, smart_inference_mode - - -class BaseValidator: - """ - BaseValidator. - - A base class for creating validators. - - Attributes: - args (SimpleNamespace): Configuration for the validator. - dataloader (DataLoader): Dataloader to use for validation. - pbar (tqdm): Progress bar to update during validation. - model (nn.Module): Model to validate. - data (dict): Data dictionary. - device (torch.device): Device to use for validation. - batch_i (int): Current batch index. - training (bool): Whether the model is in training mode. - names (dict): Class names. - seen: Records the number of images seen so far during validation. - stats: Placeholder for statistics during validation. - confusion_matrix: Placeholder for a confusion matrix. - nc: Number of classes. - iouv: (torch.Tensor): IoU thresholds from 0.50 to 0.95 in spaces of 0.05. - jdict (dict): Dictionary to store JSON validation results. - speed (dict): Dictionary with keys 'preprocess', 'inference', 'loss', 'postprocess' and their respective - batch processing times in milliseconds. - save_dir (Path): Directory to save results. - plots (dict): Dictionary to store plots for visualization. - callbacks (dict): Dictionary to store various callback functions. - """ - - def __init__(self, dataloader=None, save_dir=None, pbar=None, args=None, _callbacks=None): - """ - Initializes a BaseValidator instance. - - Args: - dataloader (torch.utils.data.DataLoader): Dataloader to be used for validation. - save_dir (Path, optional): Directory to save results. - pbar (tqdm.tqdm): Progress bar for displaying progress. - args (SimpleNamespace): Configuration for the validator. - _callbacks (dict): Dictionary to store various callback functions. - """ - self.args = get_cfg(overrides=args) - self.dataloader = dataloader - self.pbar = pbar - self.stride = None - self.data = None - self.device = None - self.batch_i = None - self.training = True - self.names = None - self.seen = None - self.stats = None - self.confusion_matrix = None - self.nc = None - self.iouv = None - self.jdict = None - self.speed = {"preprocess": 0.0, "inference": 0.0, "loss": 0.0, "postprocess": 0.0} - - self.save_dir = save_dir or get_save_dir(self.args) - (self.save_dir / "labels" if self.args.save_txt else self.save_dir).mkdir(parents=True, exist_ok=True) - if self.args.conf is None: - self.args.conf = 0.001 # default conf=0.001 - self.args.imgsz = check_imgsz(self.args.imgsz, max_dim=1) - - self.plots = {} - self.callbacks = _callbacks or callbacks.get_default_callbacks() - - @smart_inference_mode() - def __call__(self, trainer=None, model=None): - """Supports validation of a pre-trained model if passed or a model being trained if trainer is passed (trainer - gets priority). - """ - self.training = trainer is not None - augment = self.args.augment and (not self.training) - if self.training: - self.device = trainer.device - self.data = trainer.data - self.args.half = self.device.type != "cpu" # force FP16 val during training - model = trainer.ema.ema or trainer.model - model = model.half() if self.args.half else model.float() - # self.model = model - self.loss = torch.zeros_like(trainer.loss_items, device=trainer.device) - self.args.plots &= trainer.stopper.possible_stop or (trainer.epoch == trainer.epochs - 1) - model.eval() - else: - callbacks.add_integration_callbacks(self) - model = AutoBackend( - weights=model or self.args.model, - device=select_device(self.args.device, self.args.batch), - dnn=self.args.dnn, - data=self.args.data, - fp16=self.args.half, - ) - # self.model = model - self.device = model.device # update device - self.args.half = model.fp16 # update half - stride, pt, jit, engine = model.stride, model.pt, model.jit, model.engine - imgsz = check_imgsz(self.args.imgsz, stride=stride) - if engine: - self.args.batch = model.batch_size - elif not pt and not jit: - self.args.batch = 1 # export.py models default to batch-size 1 - LOGGER.info(f"Forcing batch=1 square inference (1,3,{imgsz},{imgsz}) for non-PyTorch models") - - if str(self.args.data).split(".")[-1] in ("yaml", "yml"): - self.data = check_det_dataset(self.args.data) - elif self.args.task == "classify": - self.data = check_cls_dataset(self.args.data, split=self.args.split) - else: - raise FileNotFoundError(emojis(f"Dataset '{self.args.data}' for task={self.args.task} not found ❌")) - - if self.device.type in ("cpu", "mps"): - self.args.workers = 0 # faster CPU val as time dominated by inference, not dataloading - if not pt: - self.args.rect = False - self.stride = model.stride # used in get_dataloader() for padding - self.dataloader = self.dataloader or self.get_dataloader(self.data.get(self.args.split), self.args.batch) - - model.eval() - model.warmup(imgsz=(1 if pt else self.args.batch, 3, imgsz, imgsz)) # warmup - - self.run_callbacks("on_val_start") - dt = ( - Profile(device=self.device), - Profile(device=self.device), - Profile(device=self.device), - Profile(device=self.device), - ) - bar = TQDM(self.dataloader, desc=self.get_desc(), total=len(self.dataloader)) - self.init_metrics(de_parallel(model)) - self.jdict = [] # empty before each val - for batch_i, batch in enumerate(bar): - self.run_callbacks("on_val_batch_start") - self.batch_i = batch_i - # Preprocess - with dt[0]: - batch = self.preprocess(batch) - - # Inference - with dt[1]: - preds = model(batch["img"], augment=augment) - - # Loss - with dt[2]: - if self.training: - self.loss += model.loss(batch, preds)[1] - - # Postprocess - with dt[3]: - preds = self.postprocess(preds) - - self.update_metrics(preds, batch) - if self.args.plots and batch_i < 3: - self.plot_val_samples(batch, batch_i) - self.plot_predictions(batch, preds, batch_i) - - self.run_callbacks("on_val_batch_end") - stats = self.get_stats() - self.check_stats(stats) - self.speed = dict(zip(self.speed.keys(), (x.t / len(self.dataloader.dataset) * 1e3 for x in dt))) - self.finalize_metrics() - self.print_results() - self.run_callbacks("on_val_end") - if self.training: - model.float() - results = {**stats, **trainer.label_loss_items(self.loss.cpu() / len(self.dataloader), prefix="val")} - return {k: round(float(v), 5) for k, v in results.items()} # return results as 5 decimal place floats - else: - LOGGER.info( - "Speed: %.1fms preprocess, %.1fms inference, %.1fms loss, %.1fms postprocess per image" - % tuple(self.speed.values()) - ) - if self.args.save_json and self.jdict: - with open(str(self.save_dir / "predictions.json"), "w") as f: - LOGGER.info(f"Saving {f.name}...") - json.dump(self.jdict, f) # flatten and save - stats = self.eval_json(stats) # update stats - if self.args.plots or self.args.save_json: - LOGGER.info(f"Results saved to {colorstr('bold', self.save_dir)}") - return stats - - def match_predictions(self, pred_classes, true_classes, iou, use_scipy=False): - """ - Matches predictions to ground truth objects (pred_classes, true_classes) using IoU. - - Args: - pred_classes (torch.Tensor): Predicted class indices of shape(N,). - true_classes (torch.Tensor): Target class indices of shape(M,). - iou (torch.Tensor): An NxM tensor containing the pairwise IoU values for predictions and ground of truth - use_scipy (bool): Whether to use scipy for matching (more precise). - - Returns: - (torch.Tensor): Correct tensor of shape(N,10) for 10 IoU thresholds. - """ - # Dx10 matrix, where D - detections, 10 - IoU thresholds - correct = np.zeros((pred_classes.shape[0], self.iouv.shape[0])).astype(bool) - # LxD matrix where L - labels (rows), D - detections (columns) - correct_class = true_classes[:, None] == pred_classes - iou = iou * correct_class # zero out the wrong classes - iou = iou.cpu().numpy() - for i, threshold in enumerate(self.iouv.cpu().tolist()): - if use_scipy: - # WARNING: known issue that reduces mAP in https://github.com/ultralytics/ultralytics/pull/4708 - import scipy # scope import to avoid importing for all commands - - cost_matrix = iou * (iou >= threshold) - if cost_matrix.any(): - labels_idx, detections_idx = scipy.optimize.linear_sum_assignment(cost_matrix, maximize=True) - valid = cost_matrix[labels_idx, detections_idx] > 0 - if valid.any(): - correct[detections_idx[valid], i] = True - else: - matches = np.nonzero(iou >= threshold) # IoU > threshold and classes match - matches = np.array(matches).T - if matches.shape[0]: - if matches.shape[0] > 1: - matches = matches[iou[matches[:, 0], matches[:, 1]].argsort()[::-1]] - matches = matches[np.unique(matches[:, 1], return_index=True)[1]] - # matches = matches[matches[:, 2].argsort()[::-1]] - matches = matches[np.unique(matches[:, 0], return_index=True)[1]] - correct[matches[:, 1].astype(int), i] = True - return torch.tensor(correct, dtype=torch.bool, device=pred_classes.device) - - def add_callback(self, event: str, callback): - """Appends the given callback.""" - self.callbacks[event].append(callback) - - def run_callbacks(self, event: str): - """Runs all callbacks associated with a specified event.""" - for callback in self.callbacks.get(event, []): - callback(self) - - def get_dataloader(self, dataset_path, batch_size): - """Get data loader from dataset path and batch size.""" - raise NotImplementedError("get_dataloader function not implemented for this validator") - - def build_dataset(self, img_path): - """Build dataset.""" - raise NotImplementedError("build_dataset function not implemented in validator") - - def preprocess(self, batch): - """Preprocesses an input batch.""" - return batch - - def postprocess(self, preds): - """Describes and summarizes the purpose of 'postprocess()' but no details mentioned.""" - return preds - - def init_metrics(self, model): - """Initialize performance metrics for the YOLO model.""" - pass - - def update_metrics(self, preds, batch): - """Updates metrics based on predictions and batch.""" - pass - - def finalize_metrics(self, *args, **kwargs): - """Finalizes and returns all metrics.""" - pass - - def get_stats(self): - """Returns statistics about the model's performance.""" - return {} - - def check_stats(self, stats): - """Checks statistics.""" - pass - - def print_results(self): - """Prints the results of the model's predictions.""" - pass - - def get_desc(self): - """Get description of the YOLO model.""" - pass - - @property - def metric_keys(self): - """Returns the metric keys used in YOLO training/validation.""" - return [] - - def on_plot(self, name, data=None): - """Registers plots (e.g. to be consumed in callbacks)""" - self.plots[Path(name)] = {"data": data, "timestamp": time.time()} - - # TODO: may need to put these following functions into callback - def plot_val_samples(self, batch, ni): - """Plots validation samples during training.""" - pass - - def plot_predictions(self, batch, preds, ni): - """Plots YOLO model predictions on batch images.""" - pass - - def pred_to_json(self, preds, batch): - """Convert predictions to JSON format.""" - pass - - def eval_json(self, stats): - """Evaluate and return JSON format of prediction statistics.""" - pass diff --git a/ultralytics-main/ultralytics/hub/__init__.py b/ultralytics-main/ultralytics/hub/__init__.py deleted file mode 100644 index b46bea4..0000000 --- a/ultralytics-main/ultralytics/hub/__init__.py +++ /dev/null @@ -1,128 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import requests - -from ultralytics.data.utils import HUBDatasetStats -from ultralytics.hub.auth import Auth -from ultralytics.hub.utils import HUB_API_ROOT, HUB_WEB_ROOT, PREFIX -from ultralytics.utils import LOGGER, SETTINGS, checks - - -def login(api_key: str = None, save=True) -> bool: - """ - Log in to the Ultralytics HUB API using the provided API key. - - The session is not stored; a new session is created when needed using the saved SETTINGS or the HUB_API_KEY - environment variable if successfully authenticated. - - Args: - api_key (str, optional): API key to use for authentication. - If not provided, it will be retrieved from SETTINGS or HUB_API_KEY environment variable. - save (bool, optional): Whether to save the API key to SETTINGS if authentication is successful. - - Returns: - (bool): True if authentication is successful, False otherwise. - """ - checks.check_requirements("hub-sdk>=0.0.2") - from hub_sdk import HUBClient - - api_key_url = f"{HUB_WEB_ROOT}/settings?tab=api+keys" # set the redirect URL - saved_key = SETTINGS.get("api_key") - active_key = api_key or saved_key - credentials = {"api_key": active_key} if active_key and active_key != "" else None # set credentials - - client = HUBClient(credentials) # initialize HUBClient - - if client.authenticated: - # Successfully authenticated with HUB - - if save and client.api_key != saved_key: - SETTINGS.update({"api_key": client.api_key}) # update settings with valid API key - - # Set message based on whether key was provided or retrieved from settings - log_message = ( - "New authentication successful ✅" if client.api_key == api_key or not credentials else "Authenticated ✅" - ) - LOGGER.info(f"{PREFIX}{log_message}") - - return True - else: - # Failed to authenticate with HUB - LOGGER.info(f"{PREFIX}Get API key from {api_key_url} and then run 'yolo hub login API_KEY'") - return False - - -def logout(): - """ - Log out of Ultralytics HUB by removing the API key from the settings file. To log in again, use 'yolo hub login'. - - Example: - ```python - from ultralytics import hub - - hub.logout() - ``` - """ - SETTINGS["api_key"] = "" - SETTINGS.save() - LOGGER.info(f"{PREFIX}logged out ✅. To log in again, use 'yolo hub login'.") - - -def reset_model(model_id=""): - """Reset a trained model to an untrained state.""" - r = requests.post(f"{HUB_API_ROOT}/model-reset", json={"modelId": model_id}, headers={"x-api-key": Auth().api_key}) - if r.status_code == 200: - LOGGER.info(f"{PREFIX}Model reset successfully") - return - LOGGER.warning(f"{PREFIX}Model reset failure {r.status_code} {r.reason}") - - -def export_fmts_hub(): - """Returns a list of HUB-supported export formats.""" - from ultralytics.engine.exporter import export_formats - - return list(export_formats()["Argument"][1:]) + ["ultralytics_tflite", "ultralytics_coreml"] - - -def export_model(model_id="", format="torchscript"): - """Export a model to all formats.""" - assert format in export_fmts_hub(), f"Unsupported export format '{format}', valid formats are {export_fmts_hub()}" - r = requests.post( - f"{HUB_API_ROOT}/v1/models/{model_id}/export", json={"format": format}, headers={"x-api-key": Auth().api_key} - ) - assert r.status_code == 200, f"{PREFIX}{format} export failure {r.status_code} {r.reason}" - LOGGER.info(f"{PREFIX}{format} export started ✅") - - -def get_export(model_id="", format="torchscript"): - """Get an exported model dictionary with download URL.""" - assert format in export_fmts_hub(), f"Unsupported export format '{format}', valid formats are {export_fmts_hub()}" - r = requests.post( - f"{HUB_API_ROOT}/get-export", - json={"apiKey": Auth().api_key, "modelId": model_id, "format": format}, - headers={"x-api-key": Auth().api_key}, - ) - assert r.status_code == 200, f"{PREFIX}{format} get_export failure {r.status_code} {r.reason}" - return r.json() - - -def check_dataset(path="", task="detect"): - """ - Function for error-checking HUB dataset Zip file before upload. It checks a dataset for errors before it is uploaded - to the HUB. Usage examples are given below. - - Args: - path (str, optional): Path to data.zip (with data.yaml inside data.zip). Defaults to ''. - task (str, optional): Dataset task. Options are 'detect', 'segment', 'pose', 'classify'. Defaults to 'detect'. - - Example: - ```python - from ultralytics.hub import check_dataset - - check_dataset('path/to/coco8.zip', task='detect') # detect dataset - check_dataset('path/to/coco8-seg.zip', task='segment') # segment dataset - check_dataset('path/to/coco8-pose.zip', task='pose') # pose dataset - ``` - """ - HUBDatasetStats(path=path, task=task).get_json() - LOGGER.info(f"Checks completed correctly ✅. Upload this dataset to {HUB_WEB_ROOT}/datasets/.") diff --git a/ultralytics-main/ultralytics/hub/auth.py b/ultralytics-main/ultralytics/hub/auth.py deleted file mode 100644 index 6ede303..0000000 --- a/ultralytics-main/ultralytics/hub/auth.py +++ /dev/null @@ -1,136 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import requests - -from ultralytics.hub.utils import HUB_API_ROOT, HUB_WEB_ROOT, PREFIX, request_with_credentials -from ultralytics.utils import LOGGER, SETTINGS, emojis, is_colab - -API_KEY_URL = f"{HUB_WEB_ROOT}/settings?tab=api+keys" - - -class Auth: - """ - Manages authentication processes including API key handling, cookie-based authentication, and header generation. - - The class supports different methods of authentication: - 1. Directly using an API key. - 2. Authenticating using browser cookies (specifically in Google Colab). - 3. Prompting the user to enter an API key. - - Attributes: - id_token (str or bool): Token used for identity verification, initialized as False. - api_key (str or bool): API key for authentication, initialized as False. - model_key (bool): Placeholder for model key, initialized as False. - """ - - id_token = api_key = model_key = False - - def __init__(self, api_key="", verbose=False): - """ - Initialize the Auth class with an optional API key. - - Args: - api_key (str, optional): May be an API key or a combination API key and model ID, i.e. key_id - """ - # Split the input API key in case it contains a combined key_model and keep only the API key part - api_key = api_key.split("_")[0] - - # Set API key attribute as value passed or SETTINGS API key if none passed - self.api_key = api_key or SETTINGS.get("api_key", "") - - # If an API key is provided - if self.api_key: - # If the provided API key matches the API key in the SETTINGS - if self.api_key == SETTINGS.get("api_key"): - # Log that the user is already logged in - if verbose: - LOGGER.info(f"{PREFIX}Authenticated ✅") - return - else: - # Attempt to authenticate with the provided API key - success = self.authenticate() - # If the API key is not provided and the environment is a Google Colab notebook - elif is_colab(): - # Attempt to authenticate using browser cookies - success = self.auth_with_cookies() - else: - # Request an API key - success = self.request_api_key() - - # Update SETTINGS with the new API key after successful authentication - if success: - SETTINGS.update({"api_key": self.api_key}) - # Log that the new login was successful - if verbose: - LOGGER.info(f"{PREFIX}New authentication successful ✅") - elif verbose: - LOGGER.info(f"{PREFIX}Get API key from {API_KEY_URL} and then run 'yolo hub login API_KEY'") - - def request_api_key(self, max_attempts=3): - """ - Prompt the user to input their API key. - - Returns the model ID. - """ - import getpass - - for attempts in range(max_attempts): - LOGGER.info(f"{PREFIX}Login. Attempt {attempts + 1} of {max_attempts}") - input_key = getpass.getpass(f"Enter API key from {API_KEY_URL} ") - self.api_key = input_key.split("_")[0] # remove model id if present - if self.authenticate(): - return True - raise ConnectionError(emojis(f"{PREFIX}Failed to authenticate ❌")) - - def authenticate(self) -> bool: - """ - Attempt to authenticate with the server using either id_token or API key. - - Returns: - (bool): True if authentication is successful, False otherwise. - """ - try: - if header := self.get_auth_header(): - r = requests.post(f"{HUB_API_ROOT}/v1/auth", headers=header) - if not r.json().get("success", False): - raise ConnectionError("Unable to authenticate.") - return True - raise ConnectionError("User has not authenticated locally.") - except ConnectionError: - self.id_token = self.api_key = False # reset invalid - LOGGER.warning(f"{PREFIX}Invalid API key ⚠️") - return False - - def auth_with_cookies(self) -> bool: - """ - Attempt to fetch authentication via cookies and set id_token. User must be logged in to HUB and running in a - supported browser. - - Returns: - (bool): True if authentication is successful, False otherwise. - """ - if not is_colab(): - return False # Currently only works with Colab - try: - authn = request_with_credentials(f"{HUB_API_ROOT}/v1/auth/auto") - if authn.get("success", False): - self.id_token = authn.get("data", {}).get("idToken", None) - self.authenticate() - return True - raise ConnectionError("Unable to fetch browser authentication details.") - except ConnectionError: - self.id_token = False # reset invalid - return False - - def get_auth_header(self): - """ - Get the authentication header for making API requests. - - Returns: - (dict): The authentication header if id_token or API key is set, None otherwise. - """ - if self.id_token: - return {"authorization": f"Bearer {self.id_token}"} - elif self.api_key: - return {"x-api-key": self.api_key} - # else returns None diff --git a/ultralytics-main/ultralytics/hub/session.py b/ultralytics-main/ultralytics/hub/session.py deleted file mode 100644 index ebde7aa..0000000 --- a/ultralytics-main/ultralytics/hub/session.py +++ /dev/null @@ -1,355 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import threading -import time -from http import HTTPStatus -from pathlib import Path - -import requests - -from ultralytics.hub.utils import HUB_WEB_ROOT, HELP_MSG, PREFIX, TQDM -from ultralytics.utils import LOGGER, SETTINGS, __version__, checks, emojis, is_colab -from ultralytics.utils.errors import HUBModelError - -AGENT_NAME = f"python-{__version__}-colab" if is_colab() else f"python-{__version__}-local" - - -class HUBTrainingSession: - """ - HUB training session for Ultralytics HUB YOLO models. Handles model initialization, heartbeats, and checkpointing. - - Attributes: - agent_id (str): Identifier for the instance communicating with the server. - model_id (str): Identifier for the YOLO model being trained. - model_url (str): URL for the model in Ultralytics HUB. - api_url (str): API URL for the model in Ultralytics HUB. - auth_header (dict): Authentication header for the Ultralytics HUB API requests. - rate_limits (dict): Rate limits for different API calls (in seconds). - timers (dict): Timers for rate limiting. - metrics_queue (dict): Queue for the model's metrics. - model (dict): Model data fetched from Ultralytics HUB. - alive (bool): Indicates if the heartbeat loop is active. - """ - - def __init__(self, identifier): - """ - Initialize the HUBTrainingSession with the provided model identifier. - - Args: - identifier (str): Model identifier used to initialize the HUB training session. - It can be a URL string or a model key with specific format. - - Raises: - ValueError: If the provided model identifier is invalid. - ConnectionError: If connecting with global API key is not supported. - ModuleNotFoundError: If hub-sdk package is not installed. - """ - from hub_sdk import HUBClient - - self.rate_limits = { - "metrics": 3.0, - "ckpt": 900.0, - "heartbeat": 300.0, - } # rate limits (seconds) - self.metrics_queue = {} # holds metrics for each epoch until upload - self.metrics_upload_failed_queue = {} # holds metrics for each epoch if upload failed - self.timers = {} # holds timers in ultralytics/utils/callbacks/hub.py - - # Parse input - api_key, model_id, self.filename = self._parse_identifier(identifier) - - # Get credentials - active_key = api_key or SETTINGS.get("api_key") - credentials = {"api_key": active_key} if active_key else None # set credentials - - # Initialize client - self.client = HUBClient(credentials) - - if model_id: - self.load_model(model_id) # load existing model - else: - self.model = self.client.model() # load empty model - - def load_model(self, model_id): - """Loads an existing model from Ultralytics HUB using the provided model identifier.""" - self.model = self.client.model(model_id) - if not self.model.data: # then model does not exist - raise ValueError(emojis("❌ The specified HUB model does not exist")) # TODO: improve error handling - - self.model_url = f"{HUB_WEB_ROOT}/models/{self.model.id}" - - self._set_train_args() - - # Start heartbeats for HUB to monitor agent - self.model.start_heartbeat(self.rate_limits["heartbeat"]) - LOGGER.info(f"{PREFIX}View model at {self.model_url} 🚀") - - def create_model(self, model_args): - """Initializes a HUB training session with the specified model identifier.""" - payload = { - "config": { - "batchSize": model_args.get("batch", -1), - "epochs": model_args.get("epochs", 300), - "imageSize": model_args.get("imgsz", 640), - "patience": model_args.get("patience", 100), - "device": model_args.get("device", ""), - "cache": model_args.get("cache", "ram"), - }, - "dataset": {"name": model_args.get("data")}, - "lineage": { - "architecture": { - "name": self.filename.replace(".pt", "").replace(".yaml", ""), - }, - "parent": {}, - }, - "meta": {"name": self.filename}, - } - - if self.filename.endswith(".pt"): - payload["lineage"]["parent"]["name"] = self.filename - - self.model.create_model(payload) - - # Model could not be created - # TODO: improve error handling - if not self.model.id: - return - - self.model_url = f"{HUB_WEB_ROOT}/models/{self.model.id}" - - # Start heartbeats for HUB to monitor agent - self.model.start_heartbeat(self.rate_limits["heartbeat"]) - - LOGGER.info(f"{PREFIX}View model at {self.model_url} 🚀") - - def _parse_identifier(self, identifier): - """ - Parses the given identifier to determine the type of identifier and extract relevant components. - - The method supports different identifier formats: - - A HUB URL, which starts with HUB_WEB_ROOT followed by '/models/' - - An identifier containing an API key and a model ID separated by an underscore - - An identifier that is solely a model ID of a fixed length - - A local filename that ends with '.pt' or '.yaml' - - Args: - identifier (str): The identifier string to be parsed. - - Returns: - (tuple): A tuple containing the API key, model ID, and filename as applicable. - - Raises: - HUBModelError: If the identifier format is not recognized. - """ - - # Initialize variables - api_key, model_id, filename = None, None, None - - # Check if identifier is a HUB URL - if identifier.startswith(f"{HUB_WEB_ROOT}/models/"): - # Extract the model_id after the HUB_WEB_ROOT URL - model_id = identifier.split(f"{HUB_WEB_ROOT}/models/")[-1] - else: - # Split the identifier based on underscores only if it's not a HUB URL - parts = identifier.split("_") - - # Check if identifier is in the format of API key and model ID - if len(parts) == 2 and len(parts[0]) == 42 and len(parts[1]) == 20: - api_key, model_id = parts - # Check if identifier is a single model ID - elif len(parts) == 1 and len(parts[0]) == 20: - model_id = parts[0] - # Check if identifier is a local filename - elif identifier.endswith(".pt") or identifier.endswith(".yaml"): - filename = identifier - else: - raise HUBModelError( - f"model='{identifier}' could not be parsed. Check format is correct. " - f"Supported formats are Ultralytics HUB URL, apiKey_modelId, modelId, local pt or yaml file." - ) - - return api_key, model_id, filename - - def _set_train_args(self): - """ - Initializes training arguments and creates a model entry on the Ultralytics HUB. - - This method sets up training arguments based on the model's state and updates them with any additional - arguments provided. It handles different states of the model, such as whether it's resumable, pretrained, - or requires specific file setup. - - Raises: - ValueError: If the model is already trained, if required dataset information is missing, or if there are - issues with the provided training arguments. - """ - if self.model.is_trained(): - raise ValueError(emojis(f"Model is already trained and uploaded to {self.model_url} 🚀")) - - if self.model.is_resumable(): - # Model has saved weights - self.train_args = {"data": self.model.get_dataset_url(), "resume": True} - self.model_file = self.model.get_weights_url("last") - else: - # Model has no saved weights - self.train_args = self.model.data.get("train_args") # new response - - # Set the model file as either a *.pt or *.yaml file - self.model_file = ( - self.model.get_weights_url("parent") if self.model.is_pretrained() else self.model.get_architecture() - ) - - if "data" not in self.train_args: - # RF bug - datasets are sometimes not exported - raise ValueError("Dataset may still be processing. Please wait a minute and try again.") - - self.model_file = checks.check_yolov5u_filename(self.model_file, verbose=False) # YOLOv5->YOLOv5u - self.model_id = self.model.id - - def request_queue( - self, - request_func, - retry=3, - timeout=30, - thread=True, - verbose=True, - progress_total=None, - *args, - **kwargs, - ): - def retry_request(): - """Attempts to call `request_func` with retries, timeout, and optional threading.""" - t0 = time.time() # Record the start time for the timeout - for i in range(retry + 1): - if (time.time() - t0) > timeout: - LOGGER.warning(f"{PREFIX}Timeout for request reached. {HELP_MSG}") - break # Timeout reached, exit loop - - response = request_func(*args, **kwargs) - if response is None: - LOGGER.warning(f"{PREFIX}Received no response from the request. {HELP_MSG}") - time.sleep(2**i) # Exponential backoff before retrying - continue # Skip further processing and retry - - if progress_total: - self._show_upload_progress(progress_total, response) - - if HTTPStatus.OK <= response.status_code < HTTPStatus.MULTIPLE_CHOICES: - # if request related to metrics upload - if kwargs.get("metrics"): - self.metrics_upload_failed_queue = {} - return response # Success, no need to retry - - if i == 0: - # Initial attempt, check status code and provide messages - message = self._get_failure_message(response, retry, timeout) - - if verbose: - LOGGER.warning(f"{PREFIX}{message} {HELP_MSG} ({response.status_code})") - - if not self._should_retry(response.status_code): - LOGGER.warning(f"{PREFIX}Request failed. {HELP_MSG} ({response.status_code}") - break # Not an error that should be retried, exit loop - - time.sleep(2**i) # Exponential backoff for retries - - # if request related to metrics upload and exceed retries - if response is None and kwargs.get("metrics"): - self.metrics_upload_failed_queue.update(kwargs.get("metrics", None)) - - return response - - if thread: - # Start a new thread to run the retry_request function - threading.Thread(target=retry_request, daemon=True).start() - else: - # If running in the main thread, call retry_request directly - return retry_request() - - def _should_retry(self, status_code): - """Determines if a request should be retried based on the HTTP status code.""" - retry_codes = { - HTTPStatus.REQUEST_TIMEOUT, - HTTPStatus.BAD_GATEWAY, - HTTPStatus.GATEWAY_TIMEOUT, - } - return status_code in retry_codes - - def _get_failure_message(self, response: requests.Response, retry: int, timeout: int): - """ - Generate a retry message based on the response status code. - - Args: - response: The HTTP response object. - retry: The number of retry attempts allowed. - timeout: The maximum timeout duration. - - Returns: - (str): The retry message. - """ - if self._should_retry(response.status_code): - return f"Retrying {retry}x for {timeout}s." if retry else "" - elif response.status_code == HTTPStatus.TOO_MANY_REQUESTS: # rate limit - headers = response.headers - return ( - f"Rate limit reached ({headers['X-RateLimit-Remaining']}/{headers['X-RateLimit-Limit']}). " - f"Please retry after {headers['Retry-After']}s." - ) - else: - try: - return response.json().get("message", "No JSON message.") - except AttributeError: - return "Unable to read JSON." - - def upload_metrics(self): - """Upload model metrics to Ultralytics HUB.""" - return self.request_queue(self.model.upload_metrics, metrics=self.metrics_queue.copy(), thread=True) - - def upload_model( - self, - epoch: int, - weights: str, - is_best: bool = False, - map: float = 0.0, - final: bool = False, - ) -> None: - """ - Upload a model checkpoint to Ultralytics HUB. - - Args: - epoch (int): The current training epoch. - weights (str): Path to the model weights file. - is_best (bool): Indicates if the current model is the best one so far. - map (float): Mean average precision of the model. - final (bool): Indicates if the model is the final model after training. - """ - if Path(weights).is_file(): - progress_total = Path(weights).stat().st_size if final else None # Only show progress if final - self.request_queue( - self.model.upload_model, - epoch=epoch, - weights=weights, - is_best=is_best, - map=map, - final=final, - retry=10, - timeout=3600, - thread=not final, - progress_total=progress_total, - ) - else: - LOGGER.warning(f"{PREFIX}WARNING ⚠️ Model upload issue. Missing model {weights}.") - - def _show_upload_progress(self, content_length: int, response: requests.Response) -> None: - """ - Display a progress bar to track the upload progress of a file download. - - Args: - content_length (int): The total size of the content to be downloaded in bytes. - response (requests.Response): The response object from the file download request. - - Returns: - None - """ - with TQDM(total=content_length, unit="B", unit_scale=True, unit_divisor=1024) as pbar: - for data in response.iter_content(chunk_size=1024): - pbar.update(len(data)) diff --git a/ultralytics-main/ultralytics/hub/utils.py b/ultralytics-main/ultralytics/hub/utils.py deleted file mode 100644 index 5c00076..0000000 --- a/ultralytics-main/ultralytics/hub/utils.py +++ /dev/null @@ -1,247 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import os -import platform -import random -import sys -import threading -import time -from pathlib import Path - -import requests - -from ultralytics.utils import ( - ENVIRONMENT, - LOGGER, - ONLINE, - RANK, - SETTINGS, - TESTS_RUNNING, - TQDM, - TryExcept, - __version__, - colorstr, - get_git_origin_url, - is_colab, - is_git_dir, - is_pip_package, -) -from ultralytics.utils.downloads import GITHUB_ASSETS_NAMES - -HUB_API_ROOT = os.environ.get("ULTRALYTICS_HUB_API", "https://api.ultralytics.com") -HUB_WEB_ROOT = os.environ.get("ULTRALYTICS_HUB_WEB", "https://hub.ultralytics.com") - -PREFIX = colorstr("Ultralytics HUB: ") -HELP_MSG = "If this issue persists please visit https://github.com/ultralytics/hub/issues for assistance." - - -def request_with_credentials(url: str) -> any: - """ - Make an AJAX request with cookies attached in a Google Colab environment. - - Args: - url (str): The URL to make the request to. - - Returns: - (any): The response data from the AJAX request. - - Raises: - OSError: If the function is not run in a Google Colab environment. - """ - if not is_colab(): - raise OSError("request_with_credentials() must run in a Colab environment") - from google.colab import output # noqa - from IPython import display # noqa - - display.display( - display.Javascript( - """ - window._hub_tmp = new Promise((resolve, reject) => { - const timeout = setTimeout(() => reject("Failed authenticating existing browser session"), 5000) - fetch("%s", { - method: 'POST', - credentials: 'include' - }) - .then((response) => resolve(response.json())) - .then((json) => { - clearTimeout(timeout); - }).catch((err) => { - clearTimeout(timeout); - reject(err); - }); - }); - """ - % url - ) - ) - return output.eval_js("_hub_tmp") - - -def requests_with_progress(method, url, **kwargs): - """ - Make an HTTP request using the specified method and URL, with an optional progress bar. - - Args: - method (str): The HTTP method to use (e.g. 'GET', 'POST'). - url (str): The URL to send the request to. - **kwargs (any): Additional keyword arguments to pass to the underlying `requests.request` function. - - Returns: - (requests.Response): The response object from the HTTP request. - - Note: - - If 'progress' is set to True, the progress bar will display the download progress for responses with a known - content length. - - If 'progress' is a number then progress bar will display assuming content length = progress. - """ - progress = kwargs.pop("progress", False) - if not progress: - return requests.request(method, url, **kwargs) - response = requests.request(method, url, stream=True, **kwargs) - total = int(response.headers.get("content-length", 0) if isinstance(progress, bool) else progress) # total size - try: - pbar = TQDM(total=total, unit="B", unit_scale=True, unit_divisor=1024) - for data in response.iter_content(chunk_size=1024): - pbar.update(len(data)) - pbar.close() - except requests.exceptions.ChunkedEncodingError: # avoid 'Connection broken: IncompleteRead' warnings - response.close() - return response - - -def smart_request(method, url, retry=3, timeout=30, thread=True, code=-1, verbose=True, progress=False, **kwargs): - """ - Makes an HTTP request using the 'requests' library, with exponential backoff retries up to a specified timeout. - - Args: - method (str): The HTTP method to use for the request. Choices are 'post' and 'get'. - url (str): The URL to make the request to. - retry (int, optional): Number of retries to attempt before giving up. Default is 3. - timeout (int, optional): Timeout in seconds after which the function will give up retrying. Default is 30. - thread (bool, optional): Whether to execute the request in a separate daemon thread. Default is True. - code (int, optional): An identifier for the request, used for logging purposes. Default is -1. - verbose (bool, optional): A flag to determine whether to print out to console or not. Default is True. - progress (bool, optional): Whether to show a progress bar during the request. Default is False. - **kwargs (any): Keyword arguments to be passed to the requests function specified in method. - - Returns: - (requests.Response): The HTTP response object. If the request is executed in a separate thread, returns None. - """ - retry_codes = (408, 500) # retry only these codes - - @TryExcept(verbose=verbose) - def func(func_method, func_url, **func_kwargs): - """Make HTTP requests with retries and timeouts, with optional progress tracking.""" - r = None # response - t0 = time.time() # initial time for timer - for i in range(retry + 1): - if (time.time() - t0) > timeout: - break - r = requests_with_progress(func_method, func_url, **func_kwargs) # i.e. get(url, data, json, files) - if r.status_code < 300: # return codes in the 2xx range are generally considered "good" or "successful" - break - try: - m = r.json().get("message", "No JSON message.") - except AttributeError: - m = "Unable to read JSON." - if i == 0: - if r.status_code in retry_codes: - m += f" Retrying {retry}x for {timeout}s." if retry else "" - elif r.status_code == 429: # rate limit - h = r.headers # response headers - m = ( - f"Rate limit reached ({h['X-RateLimit-Remaining']}/{h['X-RateLimit-Limit']}). " - f"Please retry after {h['Retry-After']}s." - ) - if verbose: - LOGGER.warning(f"{PREFIX}{m} {HELP_MSG} ({r.status_code} #{code})") - if r.status_code not in retry_codes: - return r - time.sleep(2**i) # exponential standoff - return r - - args = method, url - kwargs["progress"] = progress - if thread: - threading.Thread(target=func, args=args, kwargs=kwargs, daemon=True).start() - else: - return func(*args, **kwargs) - - -class Events: - """ - A class for collecting anonymous event analytics. Event analytics are enabled when sync=True in settings and - disabled when sync=False. Run 'yolo settings' to see and update settings YAML file. - - Attributes: - url (str): The URL to send anonymous events. - rate_limit (float): The rate limit in seconds for sending events. - metadata (dict): A dictionary containing metadata about the environment. - enabled (bool): A flag to enable or disable Events based on certain conditions. - """ - - url = "https://www.google-analytics.com/mp/collect?measurement_id=G-X8NCJYTQXM&api_secret=QLQrATrNSwGRFRLE-cbHJw" - - def __init__(self): - """Initializes the Events object with default values for events, rate_limit, and metadata.""" - self.events = [] # events list - self.rate_limit = 60.0 # rate limit (seconds) - self.t = 0.0 # rate limit timer (seconds) - self.metadata = { - "cli": Path(sys.argv[0]).name == "yolo", - "install": "git" if is_git_dir() else "pip" if is_pip_package() else "other", - "python": ".".join(platform.python_version_tuple()[:2]), # i.e. 3.10 - "version": __version__, - "env": ENVIRONMENT, - "session_id": round(random.random() * 1e15), - "engagement_time_msec": 1000, - } - self.enabled = ( - SETTINGS["sync"] - and RANK in (-1, 0) - and not TESTS_RUNNING - and ONLINE - and (is_pip_package() or get_git_origin_url() == "https://github.com/ultralytics/ultralytics.git") - ) - - def __call__(self, cfg): - """ - Attempts to add a new event to the events list and send events if the rate limit is reached. - - Args: - cfg (IterableSimpleNamespace): The configuration object containing mode and task information. - """ - if not self.enabled: - # Events disabled, do nothing - return - - # Attempt to add to events - if len(self.events) < 25: # Events list limited to 25 events (drop any events past this) - params = { - **self.metadata, - "task": cfg.task, - "model": cfg.model if cfg.model in GITHUB_ASSETS_NAMES else "custom", - } - if cfg.mode == "export": - params["format"] = cfg.format - self.events.append({"name": cfg.mode, "params": params}) - - # Check rate limit - t = time.time() - if (t - self.t) < self.rate_limit: - # Time is under rate limiter, wait to send - return - - # Time is over rate limiter, send now - data = {"client_id": SETTINGS["uuid"], "events": self.events} # SHA-256 anonymized UUID hash and events list - - # POST equivalent to requests.post(self.url, json=data) - smart_request("post", self.url, json=data, retry=0, verbose=False) - - # Reset events and rate limit timer - self.events = [] - self.t = t - - -# Run below code on hub/utils init ------------------------------------------------------------------------------------- -events = Events() diff --git a/ultralytics-main/ultralytics/models/__init__.py b/ultralytics-main/ultralytics/models/__init__.py deleted file mode 100644 index b9b6eb3..0000000 --- a/ultralytics-main/ultralytics/models/__init__.py +++ /dev/null @@ -1,7 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from .rtdetr import RTDETR -from .sam import SAM -from .yolo import YOLO, YOLOWorld - -__all__ = "YOLO", "RTDETR", "SAM", "YOLOWorld" # allow simpler import diff --git a/ultralytics-main/ultralytics/models/fastsam/__init__.py b/ultralytics-main/ultralytics/models/fastsam/__init__.py deleted file mode 100644 index eabf5b9..0000000 --- a/ultralytics-main/ultralytics/models/fastsam/__init__.py +++ /dev/null @@ -1,8 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from .model import FastSAM -from .predict import FastSAMPredictor -from .prompt import FastSAMPrompt -from .val import FastSAMValidator - -__all__ = "FastSAMPredictor", "FastSAM", "FastSAMPrompt", "FastSAMValidator" diff --git a/ultralytics-main/ultralytics/models/fastsam/model.py b/ultralytics-main/ultralytics/models/fastsam/model.py deleted file mode 100644 index c01e66b..0000000 --- a/ultralytics-main/ultralytics/models/fastsam/model.py +++ /dev/null @@ -1,33 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from pathlib import Path - -from ultralytics.engine.model import Model -from .predict import FastSAMPredictor -from .val import FastSAMValidator - - -class FastSAM(Model): - """ - FastSAM model interface. - - Example: - ```python - from ultralytics import FastSAM - - model = FastSAM('last.pt') - results = model.predict('ultralytics/assets/bus.jpg') - ``` - """ - - def __init__(self, model="FastSAM-x.pt"): - """Call the __init__ method of the parent class (YOLO) with the updated default model.""" - if str(model) == "FastSAM.pt": - model = "FastSAM-x.pt" - assert Path(model).suffix not in (".yaml", ".yml"), "FastSAM models only support pre-trained models." - super().__init__(model=model, task="segment") - - @property - def task_map(self): - """Returns a dictionary mapping segment task to corresponding predictor and validator classes.""" - return {"segment": {"predictor": FastSAMPredictor, "validator": FastSAMValidator}} diff --git a/ultralytics-main/ultralytics/models/fastsam/predict.py b/ultralytics-main/ultralytics/models/fastsam/predict.py deleted file mode 100644 index 0ef1803..0000000 --- a/ultralytics-main/ultralytics/models/fastsam/predict.py +++ /dev/null @@ -1,86 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import torch - -from ultralytics.engine.results import Results -from ultralytics.models.fastsam.utils import bbox_iou -from ultralytics.models.yolo.detect.predict import DetectionPredictor -from ultralytics.utils import DEFAULT_CFG, ops - - -class FastSAMPredictor(DetectionPredictor): - """ - FastSAMPredictor is specialized for fast SAM (Segment Anything Model) segmentation prediction tasks in Ultralytics - YOLO framework. - - This class extends the DetectionPredictor, customizing the prediction pipeline specifically for fast SAM. - It adjusts post-processing steps to incorporate mask prediction and non-max suppression while optimizing - for single-class segmentation. - - Attributes: - cfg (dict): Configuration parameters for prediction. - overrides (dict, optional): Optional parameter overrides for custom behavior. - _callbacks (dict, optional): Optional list of callback functions to be invoked during prediction. - """ - - def __init__(self, cfg=DEFAULT_CFG, overrides=None, _callbacks=None): - """ - Initializes the FastSAMPredictor class, inheriting from DetectionPredictor and setting the task to 'segment'. - - Args: - cfg (dict): Configuration parameters for prediction. - overrides (dict, optional): Optional parameter overrides for custom behavior. - _callbacks (dict, optional): Optional list of callback functions to be invoked during prediction. - """ - super().__init__(cfg, overrides, _callbacks) - self.args.task = "segment" - - def postprocess(self, preds, img, orig_imgs): - """ - Perform post-processing steps on predictions, including non-max suppression and scaling boxes to original image - size, and returns the final results. - - Args: - preds (list): The raw output predictions from the model. - img (torch.Tensor): The processed image tensor. - orig_imgs (list | torch.Tensor): The original image or list of images. - - Returns: - (list): A list of Results objects, each containing processed boxes, masks, and other metadata. - """ - p = ops.non_max_suppression( - preds[0], - self.args.conf, - self.args.iou, - agnostic=self.args.agnostic_nms, - max_det=self.args.max_det, - nc=1, # set to 1 class since SAM has no class predictions - classes=self.args.classes, - ) - full_box = torch.zeros(p[0].shape[1], device=p[0].device) - full_box[2], full_box[3], full_box[4], full_box[6:] = img.shape[3], img.shape[2], 1.0, 1.0 - full_box = full_box.view(1, -1) - critical_iou_index = bbox_iou(full_box[0][:4], p[0][:, :4], iou_thres=0.9, image_shape=img.shape[2:]) - if critical_iou_index.numel() != 0: - full_box[0][4] = p[0][critical_iou_index][:, 4] - full_box[0][6:] = p[0][critical_iou_index][:, 6:] - p[0][critical_iou_index] = full_box - - if not isinstance(orig_imgs, list): # input images are a torch.Tensor, not a list - orig_imgs = ops.convert_torch2numpy_batch(orig_imgs) - - results = [] - proto = preds[1][-1] if len(preds[1]) == 3 else preds[1] # second output is len 3 if pt, but only 1 if exported - for i, pred in enumerate(p): - orig_img = orig_imgs[i] - img_path = self.batch[0][i] - if not len(pred): # save empty boxes - masks = None - elif self.args.retina_masks: - pred[:, :4] = ops.scale_boxes(img.shape[2:], pred[:, :4], orig_img.shape) - masks = ops.process_mask_native(proto[i], pred[:, 6:], pred[:, :4], orig_img.shape[:2]) # HWC - else: - masks = ops.process_mask(proto[i], pred[:, 6:], pred[:, :4], img.shape[2:], upsample=True) # HWC - pred[:, :4] = ops.scale_boxes(img.shape[2:], pred[:, :4], orig_img.shape) - results.append(Results(orig_img, path=img_path, names=self.model.names, boxes=pred[:, :6], masks=masks)) - return results diff --git a/ultralytics-main/ultralytics/models/fastsam/prompt.py b/ultralytics-main/ultralytics/models/fastsam/prompt.py deleted file mode 100644 index f7bf5ad..0000000 --- a/ultralytics-main/ultralytics/models/fastsam/prompt.py +++ /dev/null @@ -1,357 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import os -from pathlib import Path - -import cv2 -import matplotlib.pyplot as plt -import numpy as np -import torch -from PIL import Image - -from ultralytics.utils import TQDM - - -class FastSAMPrompt: - """ - Fast Segment Anything Model class for image annotation and visualization. - - Attributes: - device (str): Computing device ('cuda' or 'cpu'). - results: Object detection or segmentation results. - source: Source image or image path. - clip: CLIP model for linear assignment. - """ - - def __init__(self, source, results, device="cuda") -> None: - """Initializes FastSAMPrompt with given source, results and device, and assigns clip for linear assignment.""" - self.device = device - self.results = results - self.source = source - - # Import and assign clip - try: - import clip - except ImportError: - from ultralytics.utils.checks import check_requirements - - check_requirements("git+https://github.com/openai/CLIP.git") - import clip - self.clip = clip - - @staticmethod - def _segment_image(image, bbox): - """Segments the given image according to the provided bounding box coordinates.""" - image_array = np.array(image) - segmented_image_array = np.zeros_like(image_array) - x1, y1, x2, y2 = bbox - segmented_image_array[y1:y2, x1:x2] = image_array[y1:y2, x1:x2] - segmented_image = Image.fromarray(segmented_image_array) - black_image = Image.new("RGB", image.size, (255, 255, 255)) - # transparency_mask = np.zeros_like((), dtype=np.uint8) - transparency_mask = np.zeros((image_array.shape[0], image_array.shape[1]), dtype=np.uint8) - transparency_mask[y1:y2, x1:x2] = 255 - transparency_mask_image = Image.fromarray(transparency_mask, mode="L") - black_image.paste(segmented_image, mask=transparency_mask_image) - return black_image - - @staticmethod - def _format_results(result, filter=0): - """Formats detection results into list of annotations each containing ID, segmentation, bounding box, score and - area. - """ - annotations = [] - n = len(result.masks.data) if result.masks is not None else 0 - for i in range(n): - mask = result.masks.data[i] == 1.0 - if torch.sum(mask) >= filter: - annotation = { - "id": i, - "segmentation": mask.cpu().numpy(), - "bbox": result.boxes.data[i], - "score": result.boxes.conf[i], - } - annotation["area"] = annotation["segmentation"].sum() - annotations.append(annotation) - return annotations - - @staticmethod - def _get_bbox_from_mask(mask): - """Applies morphological transformations to the mask, displays it, and if with_contours is True, draws - contours. - """ - mask = mask.astype(np.uint8) - contours, hierarchy = cv2.findContours(mask, cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE) - x1, y1, w, h = cv2.boundingRect(contours[0]) - x2, y2 = x1 + w, y1 + h - if len(contours) > 1: - for b in contours: - x_t, y_t, w_t, h_t = cv2.boundingRect(b) - x1 = min(x1, x_t) - y1 = min(y1, y_t) - x2 = max(x2, x_t + w_t) - y2 = max(y2, y_t + h_t) - return [x1, y1, x2, y2] - - def plot( - self, - annotations, - output, - bbox=None, - points=None, - point_label=None, - mask_random_color=True, - better_quality=True, - retina=False, - with_contours=True, - ): - """ - Plots annotations, bounding boxes, and points on images and saves the output. - - Args: - annotations (list): Annotations to be plotted. - output (str or Path): Output directory for saving the plots. - bbox (list, optional): Bounding box coordinates [x1, y1, x2, y2]. Defaults to None. - points (list, optional): Points to be plotted. Defaults to None. - point_label (list, optional): Labels for the points. Defaults to None. - mask_random_color (bool, optional): Whether to use random color for masks. Defaults to True. - better_quality (bool, optional): Whether to apply morphological transformations for better mask quality. Defaults to True. - retina (bool, optional): Whether to use retina mask. Defaults to False. - with_contours (bool, optional): Whether to plot contours. Defaults to True. - """ - pbar = TQDM(annotations, total=len(annotations)) - for ann in pbar: - result_name = os.path.basename(ann.path) - image = ann.orig_img[..., ::-1] # BGR to RGB - original_h, original_w = ann.orig_shape - # For macOS only - # plt.switch_backend('TkAgg') - plt.figure(figsize=(original_w / 100, original_h / 100)) - # Add subplot with no margin. - plt.subplots_adjust(top=1, bottom=0, right=1, left=0, hspace=0, wspace=0) - plt.margins(0, 0) - plt.gca().xaxis.set_major_locator(plt.NullLocator()) - plt.gca().yaxis.set_major_locator(plt.NullLocator()) - plt.imshow(image) - - if ann.masks is not None: - masks = ann.masks.data - if better_quality: - if isinstance(masks[0], torch.Tensor): - masks = np.array(masks.cpu()) - for i, mask in enumerate(masks): - mask = cv2.morphologyEx(mask.astype(np.uint8), cv2.MORPH_CLOSE, np.ones((3, 3), np.uint8)) - masks[i] = cv2.morphologyEx(mask.astype(np.uint8), cv2.MORPH_OPEN, np.ones((8, 8), np.uint8)) - - self.fast_show_mask( - masks, - plt.gca(), - random_color=mask_random_color, - bbox=bbox, - points=points, - pointlabel=point_label, - retinamask=retina, - target_height=original_h, - target_width=original_w, - ) - - if with_contours: - contour_all = [] - temp = np.zeros((original_h, original_w, 1)) - for i, mask in enumerate(masks): - mask = mask.astype(np.uint8) - if not retina: - mask = cv2.resize(mask, (original_w, original_h), interpolation=cv2.INTER_NEAREST) - contours, _ = cv2.findContours(mask, cv2.RETR_TREE, cv2.CHAIN_APPROX_SIMPLE) - contour_all.extend(iter(contours)) - cv2.drawContours(temp, contour_all, -1, (255, 255, 255), 2) - color = np.array([0 / 255, 0 / 255, 1.0, 0.8]) - contour_mask = temp / 255 * color.reshape(1, 1, -1) - plt.imshow(contour_mask) - - # Save the figure - save_path = Path(output) / result_name - save_path.parent.mkdir(exist_ok=True, parents=True) - plt.axis("off") - plt.savefig(save_path, bbox_inches="tight", pad_inches=0, transparent=True) - plt.close() - pbar.set_description(f"Saving {result_name} to {save_path}") - - @staticmethod - def fast_show_mask( - annotation, - ax, - random_color=False, - bbox=None, - points=None, - pointlabel=None, - retinamask=True, - target_height=960, - target_width=960, - ): - """ - Quickly shows the mask annotations on the given matplotlib axis. - - Args: - annotation (array-like): Mask annotation. - ax (matplotlib.axes.Axes): Matplotlib axis. - random_color (bool, optional): Whether to use random color for masks. Defaults to False. - bbox (list, optional): Bounding box coordinates [x1, y1, x2, y2]. Defaults to None. - points (list, optional): Points to be plotted. Defaults to None. - pointlabel (list, optional): Labels for the points. Defaults to None. - retinamask (bool, optional): Whether to use retina mask. Defaults to True. - target_height (int, optional): Target height for resizing. Defaults to 960. - target_width (int, optional): Target width for resizing. Defaults to 960. - """ - n, h, w = annotation.shape # batch, height, width - - areas = np.sum(annotation, axis=(1, 2)) - annotation = annotation[np.argsort(areas)] - - index = (annotation != 0).argmax(axis=0) - if random_color: - color = np.random.random((n, 1, 1, 3)) - else: - color = np.ones((n, 1, 1, 3)) * np.array([30 / 255, 144 / 255, 1.0]) - transparency = np.ones((n, 1, 1, 1)) * 0.6 - visual = np.concatenate([color, transparency], axis=-1) - mask_image = np.expand_dims(annotation, -1) * visual - - show = np.zeros((h, w, 4)) - h_indices, w_indices = np.meshgrid(np.arange(h), np.arange(w), indexing="ij") - indices = (index[h_indices, w_indices], h_indices, w_indices, slice(None)) - - show[h_indices, w_indices, :] = mask_image[indices] - if bbox is not None: - x1, y1, x2, y2 = bbox - ax.add_patch(plt.Rectangle((x1, y1), x2 - x1, y2 - y1, fill=False, edgecolor="b", linewidth=1)) - # Draw point - if points is not None: - plt.scatter( - [point[0] for i, point in enumerate(points) if pointlabel[i] == 1], - [point[1] for i, point in enumerate(points) if pointlabel[i] == 1], - s=20, - c="y", - ) - plt.scatter( - [point[0] for i, point in enumerate(points) if pointlabel[i] == 0], - [point[1] for i, point in enumerate(points) if pointlabel[i] == 0], - s=20, - c="m", - ) - - if not retinamask: - show = cv2.resize(show, (target_width, target_height), interpolation=cv2.INTER_NEAREST) - ax.imshow(show) - - @torch.no_grad() - def retrieve(self, model, preprocess, elements, search_text: str, device) -> int: - """Processes images and text with a model, calculates similarity, and returns softmax score.""" - preprocessed_images = [preprocess(image).to(device) for image in elements] - tokenized_text = self.clip.tokenize([search_text]).to(device) - stacked_images = torch.stack(preprocessed_images) - image_features = model.encode_image(stacked_images) - text_features = model.encode_text(tokenized_text) - image_features /= image_features.norm(dim=-1, keepdim=True) - text_features /= text_features.norm(dim=-1, keepdim=True) - probs = 100.0 * image_features @ text_features.T - return probs[:, 0].softmax(dim=0) - - def _crop_image(self, format_results): - """Crops an image based on provided annotation format and returns cropped images and related data.""" - if os.path.isdir(self.source): - raise ValueError(f"'{self.source}' is a directory, not a valid source for this function.") - image = Image.fromarray(cv2.cvtColor(self.results[0].orig_img, cv2.COLOR_BGR2RGB)) - ori_w, ori_h = image.size - annotations = format_results - mask_h, mask_w = annotations[0]["segmentation"].shape - if ori_w != mask_w or ori_h != mask_h: - image = image.resize((mask_w, mask_h)) - cropped_boxes = [] - cropped_images = [] - not_crop = [] - filter_id = [] - for _, mask in enumerate(annotations): - if np.sum(mask["segmentation"]) <= 100: - filter_id.append(_) - continue - bbox = self._get_bbox_from_mask(mask["segmentation"]) # bbox from mask - cropped_boxes.append(self._segment_image(image, bbox)) # save cropped image - cropped_images.append(bbox) # save cropped image bbox - - return cropped_boxes, cropped_images, not_crop, filter_id, annotations - - def box_prompt(self, bbox): - """Modifies the bounding box properties and calculates IoU between masks and bounding box.""" - if self.results[0].masks is not None: - assert bbox[2] != 0 and bbox[3] != 0 - if os.path.isdir(self.source): - raise ValueError(f"'{self.source}' is a directory, not a valid source for this function.") - masks = self.results[0].masks.data - target_height, target_width = self.results[0].orig_shape - h = masks.shape[1] - w = masks.shape[2] - if h != target_height or w != target_width: - bbox = [ - int(bbox[0] * w / target_width), - int(bbox[1] * h / target_height), - int(bbox[2] * w / target_width), - int(bbox[3] * h / target_height), - ] - bbox[0] = max(round(bbox[0]), 0) - bbox[1] = max(round(bbox[1]), 0) - bbox[2] = min(round(bbox[2]), w) - bbox[3] = min(round(bbox[3]), h) - - # IoUs = torch.zeros(len(masks), dtype=torch.float32) - bbox_area = (bbox[3] - bbox[1]) * (bbox[2] - bbox[0]) - - masks_area = torch.sum(masks[:, bbox[1] : bbox[3], bbox[0] : bbox[2]], dim=(1, 2)) - orig_masks_area = torch.sum(masks, dim=(1, 2)) - - union = bbox_area + orig_masks_area - masks_area - iou = masks_area / union - max_iou_index = torch.argmax(iou) - - self.results[0].masks.data = torch.tensor(np.array([masks[max_iou_index].cpu().numpy()])) - return self.results - - def point_prompt(self, points, pointlabel): # numpy - """Adjusts points on detected masks based on user input and returns the modified results.""" - if self.results[0].masks is not None: - if os.path.isdir(self.source): - raise ValueError(f"'{self.source}' is a directory, not a valid source for this function.") - masks = self._format_results(self.results[0], 0) - target_height, target_width = self.results[0].orig_shape - h = masks[0]["segmentation"].shape[0] - w = masks[0]["segmentation"].shape[1] - if h != target_height or w != target_width: - points = [[int(point[0] * w / target_width), int(point[1] * h / target_height)] for point in points] - onemask = np.zeros((h, w)) - for annotation in masks: - mask = annotation["segmentation"] if isinstance(annotation, dict) else annotation - for i, point in enumerate(points): - if mask[point[1], point[0]] == 1 and pointlabel[i] == 1: - onemask += mask - if mask[point[1], point[0]] == 1 and pointlabel[i] == 0: - onemask -= mask - onemask = onemask >= 1 - self.results[0].masks.data = torch.tensor(np.array([onemask])) - return self.results - - def text_prompt(self, text): - """Processes a text prompt, applies it to existing results and returns the updated results.""" - if self.results[0].masks is not None: - format_results = self._format_results(self.results[0], 0) - cropped_boxes, cropped_images, not_crop, filter_id, annotations = self._crop_image(format_results) - clip_model, preprocess = self.clip.load("ViT-B/32", device=self.device) - scores = self.retrieve(clip_model, preprocess, cropped_boxes, text, device=self.device) - max_idx = scores.argsort() - max_idx = max_idx[-1] - max_idx += sum(np.array(filter_id) <= int(max_idx)) - self.results[0].masks.data = torch.tensor(np.array([annotations[max_idx]["segmentation"]])) - return self.results - - def everything_prompt(self): - """Returns the processed results from the previous methods in the class.""" - return self.results diff --git a/ultralytics-main/ultralytics/models/fastsam/utils.py b/ultralytics-main/ultralytics/models/fastsam/utils.py deleted file mode 100644 index 480e903..0000000 --- a/ultralytics-main/ultralytics/models/fastsam/utils.py +++ /dev/null @@ -1,67 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import torch - - -def adjust_bboxes_to_image_border(boxes, image_shape, threshold=20): - """ - Adjust bounding boxes to stick to image border if they are within a certain threshold. - - Args: - boxes (torch.Tensor): (n, 4) - image_shape (tuple): (height, width) - threshold (int): pixel threshold - - Returns: - adjusted_boxes (torch.Tensor): adjusted bounding boxes - """ - - # Image dimensions - h, w = image_shape - - # Adjust boxes - boxes[boxes[:, 0] < threshold, 0] = 0 # x1 - boxes[boxes[:, 1] < threshold, 1] = 0 # y1 - boxes[boxes[:, 2] > w - threshold, 2] = w # x2 - boxes[boxes[:, 3] > h - threshold, 3] = h # y2 - return boxes - - -def bbox_iou(box1, boxes, iou_thres=0.9, image_shape=(640, 640), raw_output=False): - """ - Compute the Intersection-Over-Union of a bounding box with respect to an array of other bounding boxes. - - Args: - box1 (torch.Tensor): (4, ) - boxes (torch.Tensor): (n, 4) - iou_thres (float): IoU threshold - image_shape (tuple): (height, width) - raw_output (bool): If True, return the raw IoU values instead of the indices - - Returns: - high_iou_indices (torch.Tensor): Indices of boxes with IoU > thres - """ - boxes = adjust_bboxes_to_image_border(boxes, image_shape) - # Obtain coordinates for intersections - x1 = torch.max(box1[0], boxes[:, 0]) - y1 = torch.max(box1[1], boxes[:, 1]) - x2 = torch.min(box1[2], boxes[:, 2]) - y2 = torch.min(box1[3], boxes[:, 3]) - - # Compute the area of intersection - intersection = (x2 - x1).clamp(0) * (y2 - y1).clamp(0) - - # Compute the area of both individual boxes - box1_area = (box1[2] - box1[0]) * (box1[3] - box1[1]) - box2_area = (boxes[:, 2] - boxes[:, 0]) * (boxes[:, 3] - boxes[:, 1]) - - # Compute the area of union - union = box1_area + box2_area - intersection - - # Compute the IoU - iou = intersection / union # Should be shape (n, ) - if raw_output: - return 0 if iou.numel() == 0 else iou - - # return indices of boxes with IoU > thres - return torch.nonzero(iou > iou_thres).flatten() diff --git a/ultralytics-main/ultralytics/models/fastsam/val.py b/ultralytics-main/ultralytics/models/fastsam/val.py deleted file mode 100644 index 9014b27..0000000 --- a/ultralytics-main/ultralytics/models/fastsam/val.py +++ /dev/null @@ -1,40 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from ultralytics.models.yolo.segment import SegmentationValidator -from ultralytics.utils.metrics import SegmentMetrics - - -class FastSAMValidator(SegmentationValidator): - """ - Custom validation class for fast SAM (Segment Anything Model) segmentation in Ultralytics YOLO framework. - - Extends the SegmentationValidator class, customizing the validation process specifically for fast SAM. This class - sets the task to 'segment' and uses the SegmentMetrics for evaluation. Additionally, plotting features are disabled - to avoid errors during validation. - - Attributes: - dataloader: The data loader object used for validation. - save_dir (str): The directory where validation results will be saved. - pbar: A progress bar object. - args: Additional arguments for customization. - _callbacks: List of callback functions to be invoked during validation. - """ - - def __init__(self, dataloader=None, save_dir=None, pbar=None, args=None, _callbacks=None): - """ - Initialize the FastSAMValidator class, setting the task to 'segment' and metrics to SegmentMetrics. - - Args: - dataloader (torch.utils.data.DataLoader): Dataloader to be used for validation. - save_dir (Path, optional): Directory to save results. - pbar (tqdm.tqdm): Progress bar for displaying progress. - args (SimpleNamespace): Configuration for the validator. - _callbacks (dict): Dictionary to store various callback functions. - - Notes: - Plots for ConfusionMatrix and other related metrics are disabled in this class to avoid errors. - """ - super().__init__(dataloader, save_dir, pbar, args, _callbacks) - self.args.task = "segment" - self.args.plots = False # disable ConfusionMatrix and other plots to avoid errors - self.metrics = SegmentMetrics(save_dir=self.save_dir, on_plot=self.on_plot) diff --git a/ultralytics-main/ultralytics/models/nas/__init__.py b/ultralytics-main/ultralytics/models/nas/__init__.py deleted file mode 100644 index b095a05..0000000 --- a/ultralytics-main/ultralytics/models/nas/__init__.py +++ /dev/null @@ -1,7 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from .model import NAS -from .predict import NASPredictor -from .val import NASValidator - -__all__ = "NASPredictor", "NASValidator", "NAS" diff --git a/ultralytics-main/ultralytics/models/nas/model.py b/ultralytics-main/ultralytics/models/nas/model.py deleted file mode 100644 index 7997e96..0000000 --- a/ultralytics-main/ultralytics/models/nas/model.py +++ /dev/null @@ -1,83 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -""" -YOLO-NAS model interface. - -Example: - ```python - from ultralytics import NAS - - model = NAS('yolo_nas_s') - results = model.predict('ultralytics/assets/bus.jpg') - ``` -""" - -from pathlib import Path - -import torch - -from ultralytics.engine.model import Model -from ultralytics.utils.torch_utils import model_info, smart_inference_mode -from .predict import NASPredictor -from .val import NASValidator - - -class NAS(Model): - """ - YOLO NAS model for object detection. - - This class provides an interface for the YOLO-NAS models and extends the `Model` class from Ultralytics engine. - It is designed to facilitate the task of object detection using pre-trained or custom-trained YOLO-NAS models. - - Example: - ```python - from ultralytics import NAS - - model = NAS('yolo_nas_s') - results = model.predict('ultralytics/assets/bus.jpg') - ``` - - Attributes: - model (str): Path to the pre-trained model or model name. Defaults to 'yolo_nas_s.pt'. - - Note: - YOLO-NAS models only support pre-trained models. Do not provide YAML configuration files. - """ - - def __init__(self, model="yolo_nas_s.pt") -> None: - """Initializes the NAS model with the provided or default 'yolo_nas_s.pt' model.""" - assert Path(model).suffix not in (".yaml", ".yml"), "YOLO-NAS models only support pre-trained models." - super().__init__(model, task="detect") - - @smart_inference_mode() - def _load(self, weights: str, task: str): - """Loads an existing NAS model weights or creates a new NAS model with pretrained weights if not provided.""" - import super_gradients - - suffix = Path(weights).suffix - if suffix == ".pt": - self.model = torch.load(weights) - elif suffix == "": - self.model = super_gradients.training.models.get(weights, pretrained_weights="coco") - # Standardize model - self.model.fuse = lambda verbose=True: self.model - self.model.stride = torch.tensor([32]) - self.model.names = dict(enumerate(self.model._class_names)) - self.model.is_fused = lambda: False # for info() - self.model.yaml = {} # for info() - self.model.pt_path = weights # for export() - self.model.task = "detect" # for export() - - def info(self, detailed=False, verbose=True): - """ - Logs model info. - - Args: - detailed (bool): Show detailed information about model. - verbose (bool): Controls verbosity. - """ - return model_info(self.model, detailed=detailed, verbose=verbose, imgsz=640) - - @property - def task_map(self): - """Returns a dictionary mapping tasks to respective predictor and validator classes.""" - return {"detect": {"predictor": NASPredictor, "validator": NASValidator}} diff --git a/ultralytics-main/ultralytics/models/nas/predict.py b/ultralytics-main/ultralytics/models/nas/predict.py deleted file mode 100644 index 2e48546..0000000 --- a/ultralytics-main/ultralytics/models/nas/predict.py +++ /dev/null @@ -1,60 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import torch - -from ultralytics.engine.predictor import BasePredictor -from ultralytics.engine.results import Results -from ultralytics.utils import ops - - -class NASPredictor(BasePredictor): - """ - Ultralytics YOLO NAS Predictor for object detection. - - This class extends the `BasePredictor` from Ultralytics engine and is responsible for post-processing the - raw predictions generated by the YOLO NAS models. It applies operations like non-maximum suppression and - scaling the bounding boxes to fit the original image dimensions. - - Attributes: - args (Namespace): Namespace containing various configurations for post-processing. - - Example: - ```python - from ultralytics import NAS - - model = NAS('yolo_nas_s') - predictor = model.predictor - # Assumes that raw_preds, img, orig_imgs are available - results = predictor.postprocess(raw_preds, img, orig_imgs) - ``` - - Note: - Typically, this class is not instantiated directly. It is used internally within the `NAS` class. - """ - - def postprocess(self, preds_in, img, orig_imgs): - """Postprocess predictions and returns a list of Results objects.""" - - # Cat boxes and class scores - boxes = ops.xyxy2xywh(preds_in[0][0]) - preds = torch.cat((boxes, preds_in[0][1]), -1).permute(0, 2, 1) - - preds = ops.non_max_suppression( - preds, - self.args.conf, - self.args.iou, - agnostic=self.args.agnostic_nms, - max_det=self.args.max_det, - classes=self.args.classes, - ) - - if not isinstance(orig_imgs, list): # input images are a torch.Tensor, not a list - orig_imgs = ops.convert_torch2numpy_batch(orig_imgs) - - results = [] - for i, pred in enumerate(preds): - orig_img = orig_imgs[i] - pred[:, :4] = ops.scale_boxes(img.shape[2:], pred[:, :4], orig_img.shape) - img_path = self.batch[0][i] - results.append(Results(orig_img, path=img_path, names=self.model.names, boxes=pred)) - return results diff --git a/ultralytics-main/ultralytics/models/nas/val.py b/ultralytics-main/ultralytics/models/nas/val.py deleted file mode 100644 index a4a4f99..0000000 --- a/ultralytics-main/ultralytics/models/nas/val.py +++ /dev/null @@ -1,50 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import torch - -from ultralytics.models.yolo.detect import DetectionValidator -from ultralytics.utils import ops - -__all__ = ["NASValidator"] - - -class NASValidator(DetectionValidator): - """ - Ultralytics YOLO NAS Validator for object detection. - - Extends `DetectionValidator` from the Ultralytics models package and is designed to post-process the raw predictions - generated by YOLO NAS models. It performs non-maximum suppression to remove overlapping and low-confidence boxes, - ultimately producing the final detections. - - Attributes: - args (Namespace): Namespace containing various configurations for post-processing, such as confidence and IoU thresholds. - lb (torch.Tensor): Optional tensor for multilabel NMS. - - Example: - ```python - from ultralytics import NAS - - model = NAS('yolo_nas_s') - validator = model.validator - # Assumes that raw_preds are available - final_preds = validator.postprocess(raw_preds) - ``` - - Note: - This class is generally not instantiated directly but is used internally within the `NAS` class. - """ - - def postprocess(self, preds_in): - """Apply Non-maximum suppression to prediction outputs.""" - boxes = ops.xyxy2xywh(preds_in[0][0]) - preds = torch.cat((boxes, preds_in[0][1]), -1).permute(0, 2, 1) - return ops.non_max_suppression( - preds, - self.args.conf, - self.args.iou, - labels=self.lb, - multi_label=False, - agnostic=self.args.single_cls, - max_det=self.args.max_det, - max_time_img=0.5, - ) diff --git a/ultralytics-main/ultralytics/models/rtdetr/__init__.py b/ultralytics-main/ultralytics/models/rtdetr/__init__.py deleted file mode 100644 index 172c74b..0000000 --- a/ultralytics-main/ultralytics/models/rtdetr/__init__.py +++ /dev/null @@ -1,7 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from .model import RTDETR -from .predict import RTDETRPredictor -from .val import RTDETRValidator - -__all__ = "RTDETRPredictor", "RTDETRValidator", "RTDETR" diff --git a/ultralytics-main/ultralytics/models/rtdetr/model.py b/ultralytics-main/ultralytics/models/rtdetr/model.py deleted file mode 100644 index 440df17..0000000 --- a/ultralytics-main/ultralytics/models/rtdetr/model.py +++ /dev/null @@ -1,54 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -""" -Interface for Baidu's RT-DETR, a Vision Transformer-based real-time object detector. RT-DETR offers real-time -performance and high accuracy, excelling in accelerated backends like CUDA with TensorRT. It features an efficient -hybrid encoder and IoU-aware query selection for enhanced detection accuracy. - -For more information on RT-DETR, visit: https://arxiv.org/pdf/2304.08069.pdf -""" - -from ultralytics.engine.model import Model -from ultralytics.nn.tasks import RTDETRDetectionModel - -from .predict import RTDETRPredictor -from .train import RTDETRTrainer -from .val import RTDETRValidator - - -class RTDETR(Model): - """ - Interface for Baidu's RT-DETR model. This Vision Transformer-based object detector provides real-time performance - with high accuracy. It supports efficient hybrid encoding, IoU-aware query selection, and adaptable inference speed. - - Attributes: - model (str): Path to the pre-trained model. Defaults to 'rtdetr-l.pt'. - """ - - def __init__(self, model="rtdetr-l.pt") -> None: - """ - Initializes the RT-DETR model with the given pre-trained model file. Supports .pt and .yaml formats. - - Args: - model (str): Path to the pre-trained model. Defaults to 'rtdetr-l.pt'. - - Raises: - NotImplementedError: If the model file extension is not 'pt', 'yaml', or 'yml'. - """ - super().__init__(model=model, task="detect") - - @property - def task_map(self) -> dict: - """ - Returns a task map for RT-DETR, associating tasks with corresponding Ultralytics classes. - - Returns: - dict: A dictionary mapping task names to Ultralytics task classes for the RT-DETR model. - """ - return { - "detect": { - "predictor": RTDETRPredictor, - "validator": RTDETRValidator, - "trainer": RTDETRTrainer, - "model": RTDETRDetectionModel, - } - } diff --git a/ultralytics-main/ultralytics/models/rtdetr/predict.py b/ultralytics-main/ultralytics/models/rtdetr/predict.py deleted file mode 100644 index 7fc918b..0000000 --- a/ultralytics-main/ultralytics/models/rtdetr/predict.py +++ /dev/null @@ -1,86 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import torch - -from ultralytics.data.augment import LetterBox -from ultralytics.engine.predictor import BasePredictor -from ultralytics.engine.results import Results -from ultralytics.utils import ops - - -class RTDETRPredictor(BasePredictor): - """ - RT-DETR (Real-Time Detection Transformer) Predictor extending the BasePredictor class for making predictions using - Baidu's RT-DETR model. - - This class leverages the power of Vision Transformers to provide real-time object detection while maintaining - high accuracy. It supports key features like efficient hybrid encoding and IoU-aware query selection. - - Example: - ```python - from ultralytics.utils import ASSETS - from ultralytics.models.rtdetr import RTDETRPredictor - - args = dict(model='rtdetr-l.pt', source=ASSETS) - predictor = RTDETRPredictor(overrides=args) - predictor.predict_cli() - ``` - - Attributes: - imgsz (int): Image size for inference (must be square and scale-filled). - args (dict): Argument overrides for the predictor. - """ - - def postprocess(self, preds, img, orig_imgs): - """ - Postprocess the raw predictions from the model to generate bounding boxes and confidence scores. - - The method filters detections based on confidence and class if specified in `self.args`. - - Args: - preds (list): List of [predictions, extra] from the model. - img (torch.Tensor): Processed input images. - orig_imgs (list or torch.Tensor): Original, unprocessed images. - - Returns: - (list[Results]): A list of Results objects containing the post-processed bounding boxes, confidence scores, - and class labels. - """ - if not isinstance(preds, (list, tuple)): # list for PyTorch inference but list[0] Tensor for export inference - preds = [preds, None] - - nd = preds[0].shape[-1] - bboxes, scores = preds[0].split((4, nd - 4), dim=-1) - - if not isinstance(orig_imgs, list): # input images are a torch.Tensor, not a list - orig_imgs = ops.convert_torch2numpy_batch(orig_imgs) - - results = [] - for i, bbox in enumerate(bboxes): # (300, 4) - bbox = ops.xywh2xyxy(bbox) - score, cls = scores[i].max(-1, keepdim=True) # (300, 1) - idx = score.squeeze(-1) > self.args.conf # (300, ) - if self.args.classes is not None: - idx = (cls == torch.tensor(self.args.classes, device=cls.device)).any(1) & idx - pred = torch.cat([bbox, score, cls], dim=-1)[idx] # filter - orig_img = orig_imgs[i] - oh, ow = orig_img.shape[:2] - pred[..., [0, 2]] *= ow - pred[..., [1, 3]] *= oh - img_path = self.batch[0][i] - results.append(Results(orig_img, path=img_path, names=self.model.names, boxes=pred)) - return results - - def pre_transform(self, im): - """ - Pre-transforms the input images before feeding them into the model for inference. The input images are - letterboxed to ensure a square aspect ratio and scale-filled. The size must be square(640) and scaleFilled. - - Args: - im (list[np.ndarray] |torch.Tensor): Input images of shape (N,3,h,w) for tensor, [(h,w,3) x N] for list. - - Returns: - (list): List of pre-transformed images ready for model inference. - """ - letterbox = LetterBox(self.imgsz, auto=False, scaleFill=True) - return [letterbox(image=x) for x in im] diff --git a/ultralytics-main/ultralytics/models/rtdetr/train.py b/ultralytics-main/ultralytics/models/rtdetr/train.py deleted file mode 100644 index 10a8f9b..0000000 --- a/ultralytics-main/ultralytics/models/rtdetr/train.py +++ /dev/null @@ -1,101 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from copy import copy - -import torch - -from ultralytics.models.yolo.detect import DetectionTrainer -from ultralytics.nn.tasks import RTDETRDetectionModel -from ultralytics.utils import RANK, colorstr -from .val import RTDETRDataset, RTDETRValidator - - -class RTDETRTrainer(DetectionTrainer): - """ - Trainer class for the RT-DETR model developed by Baidu for real-time object detection. Extends the DetectionTrainer - class for YOLO to adapt to the specific features and architecture of RT-DETR. This model leverages Vision - Transformers and has capabilities like IoU-aware query selection and adaptable inference speed. - - Notes: - - F.grid_sample used in RT-DETR does not support the `deterministic=True` argument. - - AMP training can lead to NaN outputs and may produce errors during bipartite graph matching. - - Example: - ```python - from ultralytics.models.rtdetr.train import RTDETRTrainer - - args = dict(model='rtdetr-l.yaml', data='coco8.yaml', imgsz=640, epochs=3) - trainer = RTDETRTrainer(overrides=args) - trainer.train() - ``` - """ - - def get_model(self, cfg=None, weights=None, verbose=True): - """ - Initialize and return an RT-DETR model for object detection tasks. - - Args: - cfg (dict, optional): Model configuration. Defaults to None. - weights (str, optional): Path to pre-trained model weights. Defaults to None. - verbose (bool): Verbose logging if True. Defaults to True. - - Returns: - (RTDETRDetectionModel): Initialized model. - """ - model = RTDETRDetectionModel(cfg, nc=self.data["nc"], verbose=verbose and RANK == -1) - if weights: - model.load(weights) - return model - - def build_dataset(self, img_path, mode="val", batch=None): - """ - Build and return an RT-DETR dataset for training or validation. - - Args: - img_path (str): Path to the folder containing images. - mode (str): Dataset mode, either 'train' or 'val'. - batch (int, optional): Batch size for rectangle training. Defaults to None. - - Returns: - (RTDETRDataset): Dataset object for the specific mode. - """ - return RTDETRDataset( - img_path=img_path, - imgsz=self.args.imgsz, - batch_size=batch, - augment=mode == "train", - hyp=self.args, - rect=False, - cache=self.args.cache or None, - prefix=colorstr(f"{mode}: "), - data=self.data, - ) - - def get_validator(self): - """ - Returns a DetectionValidator suitable for RT-DETR model validation. - - Returns: - (RTDETRValidator): Validator object for model validation. - """ - self.loss_names = "giou_loss", "cls_loss", "l1_loss" - return RTDETRValidator(self.test_loader, save_dir=self.save_dir, args=copy(self.args)) - - def preprocess_batch(self, batch): - """ - Preprocess a batch of images. Scales and converts the images to float format. - - Args: - batch (dict): Dictionary containing a batch of images, bboxes, and labels. - - Returns: - (dict): Preprocessed batch. - """ - batch = super().preprocess_batch(batch) - bs = len(batch["img"]) - batch_idx = batch["batch_idx"] - gt_bbox, gt_class = [], [] - for i in range(bs): - gt_bbox.append(batch["bboxes"][batch_idx == i].to(batch_idx.device)) - gt_class.append(batch["cls"][batch_idx == i].to(device=batch_idx.device, dtype=torch.long)) - return batch diff --git a/ultralytics-main/ultralytics/models/rtdetr/val.py b/ultralytics-main/ultralytics/models/rtdetr/val.py deleted file mode 100644 index 88bb0ae..0000000 --- a/ultralytics-main/ultralytics/models/rtdetr/val.py +++ /dev/null @@ -1,135 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import torch - -from ultralytics.data import YOLODataset -from ultralytics.data.augment import Compose, Format, v8_transforms -from ultralytics.models.yolo.detect import DetectionValidator -from ultralytics.utils import colorstr, ops - -__all__ = ("RTDETRValidator",) # tuple or list - - -class RTDETRDataset(YOLODataset): - """ - Real-Time DEtection and TRacking (RT-DETR) dataset class extending the base YOLODataset class. - - This specialized dataset class is designed for use with the RT-DETR object detection model and is optimized for - real-time detection and tracking tasks. - """ - - def __init__(self, *args, data=None, **kwargs): - """Initialize the RTDETRDataset class by inheriting from the YOLODataset class.""" - super().__init__(*args, data=data, **kwargs) - - # NOTE: add stretch version load_image for RTDETR mosaic - def load_image(self, i, rect_mode=False): - """Loads 1 image from dataset index 'i', returns (im, resized hw).""" - return super().load_image(i=i, rect_mode=rect_mode) - - def build_transforms(self, hyp=None): - """Temporary, only for evaluation.""" - if self.augment: - hyp.mosaic = hyp.mosaic if self.augment and not self.rect else 0.0 - hyp.mixup = hyp.mixup if self.augment and not self.rect else 0.0 - transforms = v8_transforms(self, self.imgsz, hyp, stretch=True) - else: - # transforms = Compose([LetterBox(new_shape=(self.imgsz, self.imgsz), auto=False, scaleFill=True)]) - transforms = Compose([]) - transforms.append( - Format( - bbox_format="xywh", - normalize=True, - return_mask=self.use_segments, - return_keypoint=self.use_keypoints, - batch_idx=True, - mask_ratio=hyp.mask_ratio, - mask_overlap=hyp.overlap_mask, - ) - ) - return transforms - - -class RTDETRValidator(DetectionValidator): - """ - RTDETRValidator extends the DetectionValidator class to provide validation capabilities specifically tailored for - the RT-DETR (Real-Time DETR) object detection model. - - The class allows building of an RTDETR-specific dataset for validation, applies Non-maximum suppression for - post-processing, and updates evaluation metrics accordingly. - - Example: - ```python - from ultralytics.models.rtdetr import RTDETRValidator - - args = dict(model='rtdetr-l.pt', data='coco8.yaml') - validator = RTDETRValidator(args=args) - validator() - ``` - - Note: - For further details on the attributes and methods, refer to the parent DetectionValidator class. - """ - - def build_dataset(self, img_path, mode="val", batch=None): - """ - Build an RTDETR Dataset. - - Args: - img_path (str): Path to the folder containing images. - mode (str): `train` mode or `val` mode, users are able to customize different augmentations for each mode. - batch (int, optional): Size of batches, this is for `rect`. Defaults to None. - """ - return RTDETRDataset( - img_path=img_path, - imgsz=self.args.imgsz, - batch_size=batch, - augment=False, # no augmentation - hyp=self.args, - rect=False, # no rect - cache=self.args.cache or None, - prefix=colorstr(f"{mode}: "), - data=self.data, - ) - - def postprocess(self, preds): - """Apply Non-maximum suppression to prediction outputs.""" - if not isinstance(preds, (list, tuple)): # list for PyTorch inference but list[0] Tensor for export inference - preds = [preds, None] - - bs, _, nd = preds[0].shape - bboxes, scores = preds[0].split((4, nd - 4), dim=-1) - bboxes *= self.args.imgsz - outputs = [torch.zeros((0, 6), device=bboxes.device)] * bs - for i, bbox in enumerate(bboxes): # (300, 4) - bbox = ops.xywh2xyxy(bbox) - score, cls = scores[i].max(-1) # (300, ) - # Do not need threshold for evaluation as only got 300 boxes here - # idx = score > self.args.conf - pred = torch.cat([bbox, score[..., None], cls[..., None]], dim=-1) # filter - # Sort by confidence to correctly get internal metrics - pred = pred[score.argsort(descending=True)] - outputs[i] = pred # [idx] - - return outputs - - def _prepare_batch(self, si, batch): - """Prepares a batch for training or inference by applying transformations.""" - idx = batch["batch_idx"] == si - cls = batch["cls"][idx].squeeze(-1) - bbox = batch["bboxes"][idx] - ori_shape = batch["ori_shape"][si] - imgsz = batch["img"].shape[2:] - ratio_pad = batch["ratio_pad"][si] - if len(cls): - bbox = ops.xywh2xyxy(bbox) # target boxes - bbox[..., [0, 2]] *= ori_shape[1] # native-space pred - bbox[..., [1, 3]] *= ori_shape[0] # native-space pred - return dict(cls=cls, bbox=bbox, ori_shape=ori_shape, imgsz=imgsz, ratio_pad=ratio_pad) - - def _prepare_pred(self, pred, pbatch): - """Prepares and returns a batch with transformed bounding boxes and class labels.""" - predn = pred.clone() - predn[..., [0, 2]] *= pbatch["ori_shape"][1] / self.args.imgsz # native-space pred - predn[..., [1, 3]] *= pbatch["ori_shape"][0] / self.args.imgsz # native-space pred - return predn.float() diff --git a/ultralytics-main/ultralytics/models/sam/__init__.py b/ultralytics-main/ultralytics/models/sam/__init__.py deleted file mode 100644 index 8701fcc..0000000 --- a/ultralytics-main/ultralytics/models/sam/__init__.py +++ /dev/null @@ -1,6 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from .model import SAM -from .predict import Predictor - -__all__ = "SAM", "Predictor" # tuple or list diff --git a/ultralytics-main/ultralytics/models/sam/amg.py b/ultralytics-main/ultralytics/models/sam/amg.py deleted file mode 100644 index 128108f..0000000 --- a/ultralytics-main/ultralytics/models/sam/amg.py +++ /dev/null @@ -1,187 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import math -from itertools import product -from typing import Any, Generator, List, Tuple - -import numpy as np -import torch - - -def is_box_near_crop_edge( - boxes: torch.Tensor, crop_box: List[int], orig_box: List[int], atol: float = 20.0 -) -> torch.Tensor: - """Return a boolean tensor indicating if boxes are near the crop edge.""" - crop_box_torch = torch.as_tensor(crop_box, dtype=torch.float, device=boxes.device) - orig_box_torch = torch.as_tensor(orig_box, dtype=torch.float, device=boxes.device) - boxes = uncrop_boxes_xyxy(boxes, crop_box).float() - near_crop_edge = torch.isclose(boxes, crop_box_torch[None, :], atol=atol, rtol=0) - near_image_edge = torch.isclose(boxes, orig_box_torch[None, :], atol=atol, rtol=0) - near_crop_edge = torch.logical_and(near_crop_edge, ~near_image_edge) - return torch.any(near_crop_edge, dim=1) - - -def batch_iterator(batch_size: int, *args) -> Generator[List[Any], None, None]: - """Yield batches of data from the input arguments.""" - assert args and all(len(a) == len(args[0]) for a in args), "Batched iteration must have same-size inputs." - n_batches = len(args[0]) // batch_size + int(len(args[0]) % batch_size != 0) - for b in range(n_batches): - yield [arg[b * batch_size : (b + 1) * batch_size] for arg in args] - - -def calculate_stability_score(masks: torch.Tensor, mask_threshold: float, threshold_offset: float) -> torch.Tensor: - """ - Computes the stability score for a batch of masks. - - The stability score is the IoU between the binary masks obtained by thresholding the predicted mask logits at high - and low values. - - Notes: - - One mask is always contained inside the other. - - Save memory by preventing unnecessary cast to torch.int64 - """ - intersections = (masks > (mask_threshold + threshold_offset)).sum(-1, dtype=torch.int16).sum(-1, dtype=torch.int32) - unions = (masks > (mask_threshold - threshold_offset)).sum(-1, dtype=torch.int16).sum(-1, dtype=torch.int32) - return intersections / unions - - -def build_point_grid(n_per_side: int) -> np.ndarray: - """Generate a 2D grid of evenly spaced points in the range [0,1]x[0,1].""" - offset = 1 / (2 * n_per_side) - points_one_side = np.linspace(offset, 1 - offset, n_per_side) - points_x = np.tile(points_one_side[None, :], (n_per_side, 1)) - points_y = np.tile(points_one_side[:, None], (1, n_per_side)) - return np.stack([points_x, points_y], axis=-1).reshape(-1, 2) - - -def build_all_layer_point_grids(n_per_side: int, n_layers: int, scale_per_layer: int) -> List[np.ndarray]: - """Generate point grids for all crop layers.""" - return [build_point_grid(int(n_per_side / (scale_per_layer**i))) for i in range(n_layers + 1)] - - -def generate_crop_boxes( - im_size: Tuple[int, ...], n_layers: int, overlap_ratio: float -) -> Tuple[List[List[int]], List[int]]: - """ - Generates a list of crop boxes of different sizes. - - Each layer has (2**i)**2 boxes for the ith layer. - """ - crop_boxes, layer_idxs = [], [] - im_h, im_w = im_size - short_side = min(im_h, im_w) - - # Original image - crop_boxes.append([0, 0, im_w, im_h]) - layer_idxs.append(0) - - def crop_len(orig_len, n_crops, overlap): - """Crops bounding boxes to the size of the input image.""" - return int(math.ceil((overlap * (n_crops - 1) + orig_len) / n_crops)) - - for i_layer in range(n_layers): - n_crops_per_side = 2 ** (i_layer + 1) - overlap = int(overlap_ratio * short_side * (2 / n_crops_per_side)) - - crop_w = crop_len(im_w, n_crops_per_side, overlap) - crop_h = crop_len(im_h, n_crops_per_side, overlap) - - crop_box_x0 = [int((crop_w - overlap) * i) for i in range(n_crops_per_side)] - crop_box_y0 = [int((crop_h - overlap) * i) for i in range(n_crops_per_side)] - - # Crops in XYWH format - for x0, y0 in product(crop_box_x0, crop_box_y0): - box = [x0, y0, min(x0 + crop_w, im_w), min(y0 + crop_h, im_h)] - crop_boxes.append(box) - layer_idxs.append(i_layer + 1) - - return crop_boxes, layer_idxs - - -def uncrop_boxes_xyxy(boxes: torch.Tensor, crop_box: List[int]) -> torch.Tensor: - """Uncrop bounding boxes by adding the crop box offset.""" - x0, y0, _, _ = crop_box - offset = torch.tensor([[x0, y0, x0, y0]], device=boxes.device) - # Check if boxes has a channel dimension - if len(boxes.shape) == 3: - offset = offset.unsqueeze(1) - return boxes + offset - - -def uncrop_points(points: torch.Tensor, crop_box: List[int]) -> torch.Tensor: - """Uncrop points by adding the crop box offset.""" - x0, y0, _, _ = crop_box - offset = torch.tensor([[x0, y0]], device=points.device) - # Check if points has a channel dimension - if len(points.shape) == 3: - offset = offset.unsqueeze(1) - return points + offset - - -def uncrop_masks(masks: torch.Tensor, crop_box: List[int], orig_h: int, orig_w: int) -> torch.Tensor: - """Uncrop masks by padding them to the original image size.""" - x0, y0, x1, y1 = crop_box - if x0 == 0 and y0 == 0 and x1 == orig_w and y1 == orig_h: - return masks - # Coordinate transform masks - pad_x, pad_y = orig_w - (x1 - x0), orig_h - (y1 - y0) - pad = (x0, pad_x - x0, y0, pad_y - y0) - return torch.nn.functional.pad(masks, pad, value=0) - - -def remove_small_regions(mask: np.ndarray, area_thresh: float, mode: str) -> Tuple[np.ndarray, bool]: - """Remove small disconnected regions or holes in a mask, returning the mask and a modification indicator.""" - import cv2 # type: ignore - - assert mode in {"holes", "islands"} - correct_holes = mode == "holes" - working_mask = (correct_holes ^ mask).astype(np.uint8) - n_labels, regions, stats, _ = cv2.connectedComponentsWithStats(working_mask, 8) - sizes = stats[:, -1][1:] # Row 0 is background label - small_regions = [i + 1 for i, s in enumerate(sizes) if s < area_thresh] - if not small_regions: - return mask, False - fill_labels = [0] + small_regions - if not correct_holes: - # If every region is below threshold, keep largest - fill_labels = [i for i in range(n_labels) if i not in fill_labels] or [int(np.argmax(sizes)) + 1] - mask = np.isin(regions, fill_labels) - return mask, True - - -def batched_mask_to_box(masks: torch.Tensor) -> torch.Tensor: - """ - Calculates boxes in XYXY format around masks. - - Return [0,0,0,0] for an empty mask. For input shape C1xC2x...xHxW, the output shape is C1xC2x...x4. - """ - # torch.max below raises an error on empty inputs, just skip in this case - if torch.numel(masks) == 0: - return torch.zeros(*masks.shape[:-2], 4, device=masks.device) - - # Normalize shape to CxHxW - shape = masks.shape - h, w = shape[-2:] - masks = masks.flatten(0, -3) if len(shape) > 2 else masks.unsqueeze(0) - # Get top and bottom edges - in_height, _ = torch.max(masks, dim=-1) - in_height_coords = in_height * torch.arange(h, device=in_height.device)[None, :] - bottom_edges, _ = torch.max(in_height_coords, dim=-1) - in_height_coords = in_height_coords + h * (~in_height) - top_edges, _ = torch.min(in_height_coords, dim=-1) - - # Get left and right edges - in_width, _ = torch.max(masks, dim=-2) - in_width_coords = in_width * torch.arange(w, device=in_width.device)[None, :] - right_edges, _ = torch.max(in_width_coords, dim=-1) - in_width_coords = in_width_coords + w * (~in_width) - left_edges, _ = torch.min(in_width_coords, dim=-1) - - # If the mask is empty the right edge will be to the left of the left edge. - # Replace these boxes with [0, 0, 0, 0] - empty_filter = (right_edges < left_edges) | (bottom_edges < top_edges) - out = torch.stack([left_edges, top_edges, right_edges, bottom_edges], dim=-1) - out = out * (~empty_filter).unsqueeze(-1) - - # Return to original shape - return out.reshape(*shape[:-2], 4) if len(shape) > 2 else out[0] diff --git a/ultralytics-main/ultralytics/models/sam/build.py b/ultralytics-main/ultralytics/models/sam/build.py deleted file mode 100644 index 266587e..0000000 --- a/ultralytics-main/ultralytics/models/sam/build.py +++ /dev/null @@ -1,160 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -# Copyright (c) Meta Platforms, Inc. and affiliates. -# All rights reserved. - -# This source code is licensed under the license found in the -# LICENSE file in the root directory of this source tree. - -from functools import partial - -import torch - -from ultralytics.utils.downloads import attempt_download_asset -from .modules.decoders import MaskDecoder -from .modules.encoders import ImageEncoderViT, PromptEncoder -from .modules.sam import Sam -from .modules.tiny_encoder import TinyViT -from .modules.transformer import TwoWayTransformer - - -def build_sam_vit_h(checkpoint=None): - """Build and return a Segment Anything Model (SAM) h-size model.""" - return _build_sam( - encoder_embed_dim=1280, - encoder_depth=32, - encoder_num_heads=16, - encoder_global_attn_indexes=[7, 15, 23, 31], - checkpoint=checkpoint, - ) - - -def build_sam_vit_l(checkpoint=None): - """Build and return a Segment Anything Model (SAM) l-size model.""" - return _build_sam( - encoder_embed_dim=1024, - encoder_depth=24, - encoder_num_heads=16, - encoder_global_attn_indexes=[5, 11, 17, 23], - checkpoint=checkpoint, - ) - - -def build_sam_vit_b(checkpoint=None): - """Build and return a Segment Anything Model (SAM) b-size model.""" - return _build_sam( - encoder_embed_dim=768, - encoder_depth=12, - encoder_num_heads=12, - encoder_global_attn_indexes=[2, 5, 8, 11], - checkpoint=checkpoint, - ) - - -def build_mobile_sam(checkpoint=None): - """Build and return Mobile Segment Anything Model (Mobile-SAM).""" - return _build_sam( - encoder_embed_dim=[64, 128, 160, 320], - encoder_depth=[2, 2, 6, 2], - encoder_num_heads=[2, 4, 5, 10], - encoder_global_attn_indexes=None, - mobile_sam=True, - checkpoint=checkpoint, - ) - - -def _build_sam( - encoder_embed_dim, encoder_depth, encoder_num_heads, encoder_global_attn_indexes, checkpoint=None, mobile_sam=False -): - """Builds the selected SAM model architecture.""" - prompt_embed_dim = 256 - image_size = 1024 - vit_patch_size = 16 - image_embedding_size = image_size // vit_patch_size - image_encoder = ( - TinyViT( - img_size=1024, - in_chans=3, - num_classes=1000, - embed_dims=encoder_embed_dim, - depths=encoder_depth, - num_heads=encoder_num_heads, - window_sizes=[7, 7, 14, 7], - mlp_ratio=4.0, - drop_rate=0.0, - drop_path_rate=0.0, - use_checkpoint=False, - mbconv_expand_ratio=4.0, - local_conv_size=3, - layer_lr_decay=0.8, - ) - if mobile_sam - else ImageEncoderViT( - depth=encoder_depth, - embed_dim=encoder_embed_dim, - img_size=image_size, - mlp_ratio=4, - norm_layer=partial(torch.nn.LayerNorm, eps=1e-6), - num_heads=encoder_num_heads, - patch_size=vit_patch_size, - qkv_bias=True, - use_rel_pos=True, - global_attn_indexes=encoder_global_attn_indexes, - window_size=14, - out_chans=prompt_embed_dim, - ) - ) - sam = Sam( - image_encoder=image_encoder, - prompt_encoder=PromptEncoder( - embed_dim=prompt_embed_dim, - image_embedding_size=(image_embedding_size, image_embedding_size), - input_image_size=(image_size, image_size), - mask_in_chans=16, - ), - mask_decoder=MaskDecoder( - num_multimask_outputs=3, - transformer=TwoWayTransformer( - depth=2, - embedding_dim=prompt_embed_dim, - mlp_dim=2048, - num_heads=8, - ), - transformer_dim=prompt_embed_dim, - iou_head_depth=3, - iou_head_hidden_dim=256, - ), - pixel_mean=[123.675, 116.28, 103.53], - pixel_std=[58.395, 57.12, 57.375], - ) - if checkpoint is not None: - checkpoint = attempt_download_asset(checkpoint) - with open(checkpoint, "rb") as f: - state_dict = torch.load(f) - sam.load_state_dict(state_dict) - sam.eval() - # sam.load_state_dict(torch.load(checkpoint), strict=True) - # sam.eval() - return sam - - -sam_model_map = { - "sam_h.pt": build_sam_vit_h, - "sam_l.pt": build_sam_vit_l, - "sam_b.pt": build_sam_vit_b, - "mobile_sam.pt": build_mobile_sam, -} - - -def build_sam(ckpt="sam_b.pt"): - """Build a SAM model specified by ckpt.""" - model_builder = None - ckpt = str(ckpt) # to allow Path ckpt types - for k in sam_model_map.keys(): - if ckpt.endswith(k): - model_builder = sam_model_map.get(k) - - if not model_builder: - raise FileNotFoundError(f"{ckpt} is not a supported SAM model. Available models are: \n {sam_model_map.keys()}") - - return model_builder(ckpt) diff --git a/ultralytics-main/ultralytics/models/sam/model.py b/ultralytics-main/ultralytics/models/sam/model.py deleted file mode 100644 index cb12bc7..0000000 --- a/ultralytics-main/ultralytics/models/sam/model.py +++ /dev/null @@ -1,114 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -""" -SAM model interface. - -This module provides an interface to the Segment Anything Model (SAM) from Ultralytics, designed for real-time image -segmentation tasks. The SAM model allows for promptable segmentation with unparalleled versatility in image analysis, -and has been trained on the SA-1B dataset. It features zero-shot performance capabilities, enabling it to adapt to new -image distributions and tasks without prior knowledge. - -Key Features: - - Promptable segmentation - - Real-time performance - - Zero-shot transfer capabilities - - Trained on SA-1B dataset -""" - -from pathlib import Path - -from ultralytics.engine.model import Model -from ultralytics.utils.torch_utils import model_info -from .build import build_sam -from .predict import Predictor - - -class SAM(Model): - """ - SAM (Segment Anything Model) interface class. - - SAM is designed for promptable real-time image segmentation. It can be used with a variety of prompts such as - bounding boxes, points, or labels. The model has capabilities for zero-shot performance and is trained on the SA-1B - dataset. - """ - - def __init__(self, model="sam_b.pt") -> None: - """ - Initializes the SAM model with a pre-trained model file. - - Args: - model (str): Path to the pre-trained SAM model file. File should have a .pt or .pth extension. - - Raises: - NotImplementedError: If the model file extension is not .pt or .pth. - """ - if model and Path(model).suffix not in (".pt", ".pth"): - raise NotImplementedError("SAM prediction requires pre-trained *.pt or *.pth model.") - super().__init__(model=model, task="segment") - - def _load(self, weights: str, task=None): - """ - Loads the specified weights into the SAM model. - - Args: - weights (str): Path to the weights file. - task (str, optional): Task name. Defaults to None. - """ - self.model = build_sam(weights) - - def predict(self, source, stream=False, bboxes=None, points=None, labels=None, **kwargs): - """ - Performs segmentation prediction on the given image or video source. - - Args: - source (str): Path to the image or video file, or a PIL.Image object, or a numpy.ndarray object. - stream (bool, optional): If True, enables real-time streaming. Defaults to False. - bboxes (list, optional): List of bounding box coordinates for prompted segmentation. Defaults to None. - points (list, optional): List of points for prompted segmentation. Defaults to None. - labels (list, optional): List of labels for prompted segmentation. Defaults to None. - - Returns: - (list): The model predictions. - """ - overrides = dict(conf=0.25, task="segment", mode="predict", imgsz=1024) - kwargs.update(overrides) - prompts = dict(bboxes=bboxes, points=points, labels=labels) - return super().predict(source, stream, prompts=prompts, **kwargs) - - def __call__(self, source=None, stream=False, bboxes=None, points=None, labels=None, **kwargs): - """ - Alias for the 'predict' method. - - Args: - source (str): Path to the image or video file, or a PIL.Image object, or a numpy.ndarray object. - stream (bool, optional): If True, enables real-time streaming. Defaults to False. - bboxes (list, optional): List of bounding box coordinates for prompted segmentation. Defaults to None. - points (list, optional): List of points for prompted segmentation. Defaults to None. - labels (list, optional): List of labels for prompted segmentation. Defaults to None. - - Returns: - (list): The model predictions. - """ - return self.predict(source, stream, bboxes, points, labels, **kwargs) - - def info(self, detailed=False, verbose=True): - """ - Logs information about the SAM model. - - Args: - detailed (bool, optional): If True, displays detailed information about the model. Defaults to False. - verbose (bool, optional): If True, displays information on the console. Defaults to True. - - Returns: - (tuple): A tuple containing the model's information. - """ - return model_info(self.model, detailed=detailed, verbose=verbose) - - @property - def task_map(self): - """ - Provides a mapping from the 'segment' task to its corresponding 'Predictor'. - - Returns: - (dict): A dictionary mapping the 'segment' task to its corresponding 'Predictor'. - """ - return {"segment": {"predictor": Predictor}} diff --git a/ultralytics-main/ultralytics/models/sam/modules/__init__.py b/ultralytics-main/ultralytics/models/sam/modules/__init__.py deleted file mode 100644 index 9e68dc1..0000000 --- a/ultralytics-main/ultralytics/models/sam/modules/__init__.py +++ /dev/null @@ -1 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license diff --git a/ultralytics-main/ultralytics/models/sam/modules/decoders.py b/ultralytics-main/ultralytics/models/sam/modules/decoders.py deleted file mode 100644 index 073b1ad..0000000 --- a/ultralytics-main/ultralytics/models/sam/modules/decoders.py +++ /dev/null @@ -1,190 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from typing import List, Tuple, Type - -import torch -from torch import nn -from torch.nn import functional as F - -from ultralytics.nn.modules import LayerNorm2d - - -class MaskDecoder(nn.Module): - """ - Decoder module for generating masks and their associated quality scores, using a transformer architecture to predict - masks given image and prompt embeddings. - - Attributes: - transformer_dim (int): Channel dimension for the transformer module. - transformer (nn.Module): The transformer module used for mask prediction. - num_multimask_outputs (int): Number of masks to predict for disambiguating masks. - iou_token (nn.Embedding): Embedding for the IoU token. - num_mask_tokens (int): Number of mask tokens. - mask_tokens (nn.Embedding): Embedding for the mask tokens. - output_upscaling (nn.Sequential): Neural network sequence for upscaling the output. - output_hypernetworks_mlps (nn.ModuleList): Hypernetwork MLPs for generating masks. - iou_prediction_head (nn.Module): MLP for predicting mask quality. - """ - - def __init__( - self, - *, - transformer_dim: int, - transformer: nn.Module, - num_multimask_outputs: int = 3, - activation: Type[nn.Module] = nn.GELU, - iou_head_depth: int = 3, - iou_head_hidden_dim: int = 256, - ) -> None: - """ - Predicts masks given an image and prompt embeddings, using a transformer architecture. - - Args: - transformer_dim (int): the channel dimension of the transformer module - transformer (nn.Module): the transformer used to predict masks - num_multimask_outputs (int): the number of masks to predict when disambiguating masks - activation (nn.Module): the type of activation to use when upscaling masks - iou_head_depth (int): the depth of the MLP used to predict mask quality - iou_head_hidden_dim (int): the hidden dimension of the MLP used to predict mask quality - """ - super().__init__() - self.transformer_dim = transformer_dim - self.transformer = transformer - - self.num_multimask_outputs = num_multimask_outputs - - self.iou_token = nn.Embedding(1, transformer_dim) - self.num_mask_tokens = num_multimask_outputs + 1 - self.mask_tokens = nn.Embedding(self.num_mask_tokens, transformer_dim) - - self.output_upscaling = nn.Sequential( - nn.ConvTranspose2d(transformer_dim, transformer_dim // 4, kernel_size=2, stride=2), - LayerNorm2d(transformer_dim // 4), - activation(), - nn.ConvTranspose2d(transformer_dim // 4, transformer_dim // 8, kernel_size=2, stride=2), - activation(), - ) - self.output_hypernetworks_mlps = nn.ModuleList( - [MLP(transformer_dim, transformer_dim, transformer_dim // 8, 3) for _ in range(self.num_mask_tokens)] - ) - - self.iou_prediction_head = MLP(transformer_dim, iou_head_hidden_dim, self.num_mask_tokens, iou_head_depth) - - def forward( - self, - image_embeddings: torch.Tensor, - image_pe: torch.Tensor, - sparse_prompt_embeddings: torch.Tensor, - dense_prompt_embeddings: torch.Tensor, - multimask_output: bool, - ) -> Tuple[torch.Tensor, torch.Tensor]: - """ - Predict masks given image and prompt embeddings. - - Args: - image_embeddings (torch.Tensor): the embeddings from the image encoder - image_pe (torch.Tensor): positional encoding with the shape of image_embeddings - sparse_prompt_embeddings (torch.Tensor): the embeddings of the points and boxes - dense_prompt_embeddings (torch.Tensor): the embeddings of the mask inputs - multimask_output (bool): Whether to return multiple masks or a single mask. - - Returns: - torch.Tensor: batched predicted masks - torch.Tensor: batched predictions of mask quality - """ - masks, iou_pred = self.predict_masks( - image_embeddings=image_embeddings, - image_pe=image_pe, - sparse_prompt_embeddings=sparse_prompt_embeddings, - dense_prompt_embeddings=dense_prompt_embeddings, - ) - - # Select the correct mask or masks for output - mask_slice = slice(1, None) if multimask_output else slice(0, 1) - masks = masks[:, mask_slice, :, :] - iou_pred = iou_pred[:, mask_slice] - - # Prepare output - return masks, iou_pred - - def predict_masks( - self, - image_embeddings: torch.Tensor, - image_pe: torch.Tensor, - sparse_prompt_embeddings: torch.Tensor, - dense_prompt_embeddings: torch.Tensor, - ) -> Tuple[torch.Tensor, torch.Tensor]: - """ - Predicts masks. - - See 'forward' for more details. - """ - # Concatenate output tokens - output_tokens = torch.cat([self.iou_token.weight, self.mask_tokens.weight], dim=0) - output_tokens = output_tokens.unsqueeze(0).expand(sparse_prompt_embeddings.shape[0], -1, -1) - tokens = torch.cat((output_tokens, sparse_prompt_embeddings), dim=1) - - # Expand per-image data in batch direction to be per-mask - src = torch.repeat_interleave(image_embeddings, tokens.shape[0], dim=0) - src = src + dense_prompt_embeddings - pos_src = torch.repeat_interleave(image_pe, tokens.shape[0], dim=0) - b, c, h, w = src.shape - - # Run the transformer - hs, src = self.transformer(src, pos_src, tokens) - iou_token_out = hs[:, 0, :] - mask_tokens_out = hs[:, 1 : (1 + self.num_mask_tokens), :] - - # Upscale mask embeddings and predict masks using the mask tokens - src = src.transpose(1, 2).view(b, c, h, w) - upscaled_embedding = self.output_upscaling(src) - hyper_in_list: List[torch.Tensor] = [ - self.output_hypernetworks_mlps[i](mask_tokens_out[:, i, :]) for i in range(self.num_mask_tokens) - ] - hyper_in = torch.stack(hyper_in_list, dim=1) - b, c, h, w = upscaled_embedding.shape - masks = (hyper_in @ upscaled_embedding.view(b, c, h * w)).view(b, -1, h, w) - - # Generate mask quality predictions - iou_pred = self.iou_prediction_head(iou_token_out) - - return masks, iou_pred - - -class MLP(nn.Module): - """ - MLP (Multi-Layer Perceptron) model lightly adapted from - https://github.com/facebookresearch/MaskFormer/blob/main/mask_former/modeling/transformer/transformer_predictor.py - """ - - def __init__( - self, - input_dim: int, - hidden_dim: int, - output_dim: int, - num_layers: int, - sigmoid_output: bool = False, - ) -> None: - """ - Initializes the MLP (Multi-Layer Perceptron) model. - - Args: - input_dim (int): The dimensionality of the input features. - hidden_dim (int): The dimensionality of the hidden layers. - output_dim (int): The dimensionality of the output layer. - num_layers (int): The number of hidden layers. - sigmoid_output (bool, optional): Apply a sigmoid activation to the output layer. Defaults to False. - """ - super().__init__() - self.num_layers = num_layers - h = [hidden_dim] * (num_layers - 1) - self.layers = nn.ModuleList(nn.Linear(n, k) for n, k in zip([input_dim] + h, h + [output_dim])) - self.sigmoid_output = sigmoid_output - - def forward(self, x): - """Executes feedforward within the neural network module and applies activation.""" - for i, layer in enumerate(self.layers): - x = F.relu(layer(x)) if i < self.num_layers - 1 else layer(x) - if self.sigmoid_output: - x = torch.sigmoid(x) - return x diff --git a/ultralytics-main/ultralytics/models/sam/modules/encoders.py b/ultralytics-main/ultralytics/models/sam/modules/encoders.py deleted file mode 100644 index a51c347..0000000 --- a/ultralytics-main/ultralytics/models/sam/modules/encoders.py +++ /dev/null @@ -1,603 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from typing import Any, Optional, Tuple, Type - -import numpy as np -import torch -import torch.nn as nn -import torch.nn.functional as F - -from ultralytics.nn.modules import LayerNorm2d, MLPBlock - - -class ImageEncoderViT(nn.Module): - """ - An image encoder using Vision Transformer (ViT) architecture for encoding an image into a compact latent space. The - encoder takes an image, splits it into patches, and processes these patches through a series of transformer blocks. - The encoded patches are then processed through a neck to generate the final encoded representation. - - This class and its supporting functions below lightly adapted from the ViTDet backbone available at - https://github.com/facebookresearch/detectron2/blob/main/detectron2/modeling/backbone/vit.py. - - Attributes: - img_size (int): Dimension of input images, assumed to be square. - patch_embed (PatchEmbed): Module for patch embedding. - pos_embed (nn.Parameter, optional): Absolute positional embedding for patches. - blocks (nn.ModuleList): List of transformer blocks for processing patch embeddings. - neck (nn.Sequential): Neck module to further process the output. - """ - - def __init__( - self, - img_size: int = 1024, - patch_size: int = 16, - in_chans: int = 3, - embed_dim: int = 768, - depth: int = 12, - num_heads: int = 12, - mlp_ratio: float = 4.0, - out_chans: int = 256, - qkv_bias: bool = True, - norm_layer: Type[nn.Module] = nn.LayerNorm, - act_layer: Type[nn.Module] = nn.GELU, - use_abs_pos: bool = True, - use_rel_pos: bool = False, - rel_pos_zero_init: bool = True, - window_size: int = 0, - global_attn_indexes: Tuple[int, ...] = (), - ) -> None: - """ - Args: - img_size (int): Input image size. - patch_size (int): Patch size. - in_chans (int): Number of input image channels. - embed_dim (int): Patch embedding dimension. - depth (int): Depth of ViT. - num_heads (int): Number of attention heads in each ViT block. - mlp_ratio (float): Ratio of mlp hidden dim to embedding dim. - qkv_bias (bool): If True, add a learnable bias to query, key, value. - norm_layer (nn.Module): Normalization layer. - act_layer (nn.Module): Activation layer. - use_abs_pos (bool): If True, use absolute positional embeddings. - use_rel_pos (bool): If True, add relative positional embeddings to the attention map. - rel_pos_zero_init (bool): If True, zero initialize relative positional parameters. - window_size (int): Window size for window attention blocks. - global_attn_indexes (list): Indexes for blocks using global attention. - """ - super().__init__() - self.img_size = img_size - - self.patch_embed = PatchEmbed( - kernel_size=(patch_size, patch_size), - stride=(patch_size, patch_size), - in_chans=in_chans, - embed_dim=embed_dim, - ) - - self.pos_embed: Optional[nn.Parameter] = None - if use_abs_pos: - # Initialize absolute positional embedding with pretrain image size. - self.pos_embed = nn.Parameter(torch.zeros(1, img_size // patch_size, img_size // patch_size, embed_dim)) - - self.blocks = nn.ModuleList() - for i in range(depth): - block = Block( - dim=embed_dim, - num_heads=num_heads, - mlp_ratio=mlp_ratio, - qkv_bias=qkv_bias, - norm_layer=norm_layer, - act_layer=act_layer, - use_rel_pos=use_rel_pos, - rel_pos_zero_init=rel_pos_zero_init, - window_size=window_size if i not in global_attn_indexes else 0, - input_size=(img_size // patch_size, img_size // patch_size), - ) - self.blocks.append(block) - - self.neck = nn.Sequential( - nn.Conv2d( - embed_dim, - out_chans, - kernel_size=1, - bias=False, - ), - LayerNorm2d(out_chans), - nn.Conv2d( - out_chans, - out_chans, - kernel_size=3, - padding=1, - bias=False, - ), - LayerNorm2d(out_chans), - ) - - def forward(self, x: torch.Tensor) -> torch.Tensor: - """Processes input through patch embedding, applies positional embedding if present, and passes through blocks - and neck. - """ - x = self.patch_embed(x) - if self.pos_embed is not None: - x = x + self.pos_embed - for blk in self.blocks: - x = blk(x) - return self.neck(x.permute(0, 3, 1, 2)) - - -class PromptEncoder(nn.Module): - """ - Encodes different types of prompts, including points, boxes, and masks, for input to SAM's mask decoder. The encoder - produces both sparse and dense embeddings for the input prompts. - - Attributes: - embed_dim (int): Dimension of the embeddings. - input_image_size (Tuple[int, int]): Size of the input image as (H, W). - image_embedding_size (Tuple[int, int]): Spatial size of the image embedding as (H, W). - pe_layer (PositionEmbeddingRandom): Module for random position embedding. - num_point_embeddings (int): Number of point embeddings for different types of points. - point_embeddings (nn.ModuleList): List of point embeddings. - not_a_point_embed (nn.Embedding): Embedding for points that are not a part of any label. - mask_input_size (Tuple[int, int]): Size of the input mask. - mask_downscaling (nn.Sequential): Neural network for downscaling the mask. - no_mask_embed (nn.Embedding): Embedding for cases where no mask is provided. - """ - - def __init__( - self, - embed_dim: int, - image_embedding_size: Tuple[int, int], - input_image_size: Tuple[int, int], - mask_in_chans: int, - activation: Type[nn.Module] = nn.GELU, - ) -> None: - """ - Encodes prompts for input to SAM's mask decoder. - - Args: - embed_dim (int): The prompts' embedding dimension - image_embedding_size (tuple(int, int)): The spatial size of the - image embedding, as (H, W). - input_image_size (int): The padded size of the image as input - to the image encoder, as (H, W). - mask_in_chans (int): The number of hidden channels used for - encoding input masks. - activation (nn.Module): The activation to use when encoding - input masks. - """ - super().__init__() - self.embed_dim = embed_dim - self.input_image_size = input_image_size - self.image_embedding_size = image_embedding_size - self.pe_layer = PositionEmbeddingRandom(embed_dim // 2) - - self.num_point_embeddings: int = 4 # pos/neg point + 2 box corners - point_embeddings = [nn.Embedding(1, embed_dim) for _ in range(self.num_point_embeddings)] - self.point_embeddings = nn.ModuleList(point_embeddings) - self.not_a_point_embed = nn.Embedding(1, embed_dim) - - self.mask_input_size = (4 * image_embedding_size[0], 4 * image_embedding_size[1]) - self.mask_downscaling = nn.Sequential( - nn.Conv2d(1, mask_in_chans // 4, kernel_size=2, stride=2), - LayerNorm2d(mask_in_chans // 4), - activation(), - nn.Conv2d(mask_in_chans // 4, mask_in_chans, kernel_size=2, stride=2), - LayerNorm2d(mask_in_chans), - activation(), - nn.Conv2d(mask_in_chans, embed_dim, kernel_size=1), - ) - self.no_mask_embed = nn.Embedding(1, embed_dim) - - def get_dense_pe(self) -> torch.Tensor: - """ - Returns the positional encoding used to encode point prompts, applied to a dense set of points the shape of the - image encoding. - - Returns: - torch.Tensor: Positional encoding with shape 1x(embed_dim)x(embedding_h)x(embedding_w) - """ - return self.pe_layer(self.image_embedding_size).unsqueeze(0) - - def _embed_points(self, points: torch.Tensor, labels: torch.Tensor, pad: bool) -> torch.Tensor: - """Embeds point prompts.""" - points = points + 0.5 # Shift to center of pixel - if pad: - padding_point = torch.zeros((points.shape[0], 1, 2), device=points.device) - padding_label = -torch.ones((labels.shape[0], 1), device=labels.device) - points = torch.cat([points, padding_point], dim=1) - labels = torch.cat([labels, padding_label], dim=1) - point_embedding = self.pe_layer.forward_with_coords(points, self.input_image_size) - point_embedding[labels == -1] = 0.0 - point_embedding[labels == -1] += self.not_a_point_embed.weight - point_embedding[labels == 0] += self.point_embeddings[0].weight - point_embedding[labels == 1] += self.point_embeddings[1].weight - return point_embedding - - def _embed_boxes(self, boxes: torch.Tensor) -> torch.Tensor: - """Embeds box prompts.""" - boxes = boxes + 0.5 # Shift to center of pixel - coords = boxes.reshape(-1, 2, 2) - corner_embedding = self.pe_layer.forward_with_coords(coords, self.input_image_size) - corner_embedding[:, 0, :] += self.point_embeddings[2].weight - corner_embedding[:, 1, :] += self.point_embeddings[3].weight - return corner_embedding - - def _embed_masks(self, masks: torch.Tensor) -> torch.Tensor: - """Embeds mask inputs.""" - return self.mask_downscaling(masks) - - def _get_batch_size( - self, - points: Optional[Tuple[torch.Tensor, torch.Tensor]], - boxes: Optional[torch.Tensor], - masks: Optional[torch.Tensor], - ) -> int: - """Gets the batch size of the output given the batch size of the input prompts.""" - if points is not None: - return points[0].shape[0] - elif boxes is not None: - return boxes.shape[0] - elif masks is not None: - return masks.shape[0] - else: - return 1 - - def _get_device(self) -> torch.device: - """Returns the device of the first point embedding's weight tensor.""" - return self.point_embeddings[0].weight.device - - def forward( - self, - points: Optional[Tuple[torch.Tensor, torch.Tensor]], - boxes: Optional[torch.Tensor], - masks: Optional[torch.Tensor], - ) -> Tuple[torch.Tensor, torch.Tensor]: - """ - Embeds different types of prompts, returning both sparse and dense embeddings. - - Args: - points (tuple(torch.Tensor, torch.Tensor), None): point coordinates and labels to embed. - boxes (torch.Tensor, None): boxes to embed - masks (torch.Tensor, None): masks to embed - - Returns: - torch.Tensor: sparse embeddings for the points and boxes, with shape BxNx(embed_dim), where N is determined - by the number of input points and boxes. - torch.Tensor: dense embeddings for the masks, in the shape Bx(embed_dim)x(embed_H)x(embed_W) - """ - bs = self._get_batch_size(points, boxes, masks) - sparse_embeddings = torch.empty((bs, 0, self.embed_dim), device=self._get_device()) - if points is not None: - coords, labels = points - point_embeddings = self._embed_points(coords, labels, pad=(boxes is None)) - sparse_embeddings = torch.cat([sparse_embeddings, point_embeddings], dim=1) - if boxes is not None: - box_embeddings = self._embed_boxes(boxes) - sparse_embeddings = torch.cat([sparse_embeddings, box_embeddings], dim=1) - - if masks is not None: - dense_embeddings = self._embed_masks(masks) - else: - dense_embeddings = self.no_mask_embed.weight.reshape(1, -1, 1, 1).expand( - bs, -1, self.image_embedding_size[0], self.image_embedding_size[1] - ) - - return sparse_embeddings, dense_embeddings - - -class PositionEmbeddingRandom(nn.Module): - """Positional encoding using random spatial frequencies.""" - - def __init__(self, num_pos_feats: int = 64, scale: Optional[float] = None) -> None: - """Initializes a position embedding using random spatial frequencies.""" - super().__init__() - if scale is None or scale <= 0.0: - scale = 1.0 - self.register_buffer("positional_encoding_gaussian_matrix", scale * torch.randn((2, num_pos_feats))) - - # Set non-deterministic for forward() error 'cumsum_cuda_kernel does not have a deterministic implementation' - torch.use_deterministic_algorithms(False) - torch.backends.cudnn.deterministic = False - - def _pe_encoding(self, coords: torch.Tensor) -> torch.Tensor: - """Positionally encode points that are normalized to [0,1].""" - # Assuming coords are in [0, 1]^2 square and have d_1 x ... x d_n x 2 shape - coords = 2 * coords - 1 - coords = coords @ self.positional_encoding_gaussian_matrix - coords = 2 * np.pi * coords - # Outputs d_1 x ... x d_n x C shape - return torch.cat([torch.sin(coords), torch.cos(coords)], dim=-1) - - def forward(self, size: Tuple[int, int]) -> torch.Tensor: - """Generate positional encoding for a grid of the specified size.""" - h, w = size - device: Any = self.positional_encoding_gaussian_matrix.device - grid = torch.ones((h, w), device=device, dtype=torch.float32) - y_embed = grid.cumsum(dim=0) - 0.5 - x_embed = grid.cumsum(dim=1) - 0.5 - y_embed = y_embed / h - x_embed = x_embed / w - - pe = self._pe_encoding(torch.stack([x_embed, y_embed], dim=-1)) - return pe.permute(2, 0, 1) # C x H x W - - def forward_with_coords(self, coords_input: torch.Tensor, image_size: Tuple[int, int]) -> torch.Tensor: - """Positionally encode points that are not normalized to [0,1].""" - coords = coords_input.clone() - coords[:, :, 0] = coords[:, :, 0] / image_size[1] - coords[:, :, 1] = coords[:, :, 1] / image_size[0] - return self._pe_encoding(coords.to(torch.float)) # B x N x C - - -class Block(nn.Module): - """Transformer blocks with support of window attention and residual propagation blocks.""" - - def __init__( - self, - dim: int, - num_heads: int, - mlp_ratio: float = 4.0, - qkv_bias: bool = True, - norm_layer: Type[nn.Module] = nn.LayerNorm, - act_layer: Type[nn.Module] = nn.GELU, - use_rel_pos: bool = False, - rel_pos_zero_init: bool = True, - window_size: int = 0, - input_size: Optional[Tuple[int, int]] = None, - ) -> None: - """ - Args: - dim (int): Number of input channels. - num_heads (int): Number of attention heads in each ViT block. - mlp_ratio (float): Ratio of mlp hidden dim to embedding dim. - qkv_bias (bool): If True, add a learnable bias to query, key, value. - norm_layer (nn.Module): Normalization layer. - act_layer (nn.Module): Activation layer. - use_rel_pos (bool): If True, add relative positional embeddings to the attention map. - rel_pos_zero_init (bool): If True, zero initialize relative positional parameters. - window_size (int): Window size for window attention blocks. If it equals 0, then - use global attention. - input_size (tuple(int, int), None): Input resolution for calculating the relative - positional parameter size. - """ - super().__init__() - self.norm1 = norm_layer(dim) - self.attn = Attention( - dim, - num_heads=num_heads, - qkv_bias=qkv_bias, - use_rel_pos=use_rel_pos, - rel_pos_zero_init=rel_pos_zero_init, - input_size=input_size if window_size == 0 else (window_size, window_size), - ) - - self.norm2 = norm_layer(dim) - self.mlp = MLPBlock(embedding_dim=dim, mlp_dim=int(dim * mlp_ratio), act=act_layer) - - self.window_size = window_size - - def forward(self, x: torch.Tensor) -> torch.Tensor: - """Executes a forward pass through the transformer block with window attention and non-overlapping windows.""" - shortcut = x - x = self.norm1(x) - # Window partition - if self.window_size > 0: - H, W = x.shape[1], x.shape[2] - x, pad_hw = window_partition(x, self.window_size) - - x = self.attn(x) - # Reverse window partition - if self.window_size > 0: - x = window_unpartition(x, self.window_size, pad_hw, (H, W)) - - x = shortcut + x - return x + self.mlp(self.norm2(x)) - - -class Attention(nn.Module): - """Multi-head Attention block with relative position embeddings.""" - - def __init__( - self, - dim: int, - num_heads: int = 8, - qkv_bias: bool = True, - use_rel_pos: bool = False, - rel_pos_zero_init: bool = True, - input_size: Optional[Tuple[int, int]] = None, - ) -> None: - """ - Initialize Attention module. - - Args: - dim (int): Number of input channels. - num_heads (int): Number of attention heads. - qkv_bias (bool): If True, add a learnable bias to query, key, value. - rel_pos_zero_init (bool): If True, zero initialize relative positional parameters. - input_size (tuple(int, int), None): Input resolution for calculating the relative - positional parameter size. - """ - super().__init__() - self.num_heads = num_heads - head_dim = dim // num_heads - self.scale = head_dim**-0.5 - - self.qkv = nn.Linear(dim, dim * 3, bias=qkv_bias) - self.proj = nn.Linear(dim, dim) - - self.use_rel_pos = use_rel_pos - if self.use_rel_pos: - assert input_size is not None, "Input size must be provided if using relative positional encoding." - # Initialize relative positional embeddings - self.rel_pos_h = nn.Parameter(torch.zeros(2 * input_size[0] - 1, head_dim)) - self.rel_pos_w = nn.Parameter(torch.zeros(2 * input_size[1] - 1, head_dim)) - - def forward(self, x: torch.Tensor) -> torch.Tensor: - """Applies the forward operation including attention, normalization, MLP, and indexing within window limits.""" - B, H, W, _ = x.shape - # qkv with shape (3, B, nHead, H * W, C) - qkv = self.qkv(x).reshape(B, H * W, 3, self.num_heads, -1).permute(2, 0, 3, 1, 4) - # q, k, v with shape (B * nHead, H * W, C) - q, k, v = qkv.reshape(3, B * self.num_heads, H * W, -1).unbind(0) - - attn = (q * self.scale) @ k.transpose(-2, -1) - - if self.use_rel_pos: - attn = add_decomposed_rel_pos(attn, q, self.rel_pos_h, self.rel_pos_w, (H, W), (H, W)) - - attn = attn.softmax(dim=-1) - x = (attn @ v).view(B, self.num_heads, H, W, -1).permute(0, 2, 3, 1, 4).reshape(B, H, W, -1) - return self.proj(x) - - -def window_partition(x: torch.Tensor, window_size: int) -> Tuple[torch.Tensor, Tuple[int, int]]: - """ - Partition into non-overlapping windows with padding if needed. - Args: - x (tensor): input tokens with [B, H, W, C]. - window_size (int): window size. - - Returns: - windows: windows after partition with [B * num_windows, window_size, window_size, C]. - (Hp, Wp): padded height and width before partition - """ - B, H, W, C = x.shape - - pad_h = (window_size - H % window_size) % window_size - pad_w = (window_size - W % window_size) % window_size - if pad_h > 0 or pad_w > 0: - x = F.pad(x, (0, 0, 0, pad_w, 0, pad_h)) - Hp, Wp = H + pad_h, W + pad_w - - x = x.view(B, Hp // window_size, window_size, Wp // window_size, window_size, C) - windows = x.permute(0, 1, 3, 2, 4, 5).contiguous().view(-1, window_size, window_size, C) - return windows, (Hp, Wp) - - -def window_unpartition( - windows: torch.Tensor, window_size: int, pad_hw: Tuple[int, int], hw: Tuple[int, int] -) -> torch.Tensor: - """ - Window unpartition into original sequences and removing padding. - - Args: - windows (tensor): input tokens with [B * num_windows, window_size, window_size, C]. - window_size (int): window size. - pad_hw (Tuple): padded height and width (Hp, Wp). - hw (Tuple): original height and width (H, W) before padding. - - Returns: - x: unpartitioned sequences with [B, H, W, C]. - """ - Hp, Wp = pad_hw - H, W = hw - B = windows.shape[0] // (Hp * Wp // window_size // window_size) - x = windows.view(B, Hp // window_size, Wp // window_size, window_size, window_size, -1) - x = x.permute(0, 1, 3, 2, 4, 5).contiguous().view(B, Hp, Wp, -1) - - if Hp > H or Wp > W: - x = x[:, :H, :W, :].contiguous() - return x - - -def get_rel_pos(q_size: int, k_size: int, rel_pos: torch.Tensor) -> torch.Tensor: - """ - Get relative positional embeddings according to the relative positions of query and key sizes. - - Args: - q_size (int): size of query q. - k_size (int): size of key k. - rel_pos (Tensor): relative position embeddings (L, C). - - Returns: - Extracted positional embeddings according to relative positions. - """ - max_rel_dist = int(2 * max(q_size, k_size) - 1) - # Interpolate rel pos if needed. - if rel_pos.shape[0] != max_rel_dist: - # Interpolate rel pos. - rel_pos_resized = F.interpolate( - rel_pos.reshape(1, rel_pos.shape[0], -1).permute(0, 2, 1), - size=max_rel_dist, - mode="linear", - ) - rel_pos_resized = rel_pos_resized.reshape(-1, max_rel_dist).permute(1, 0) - else: - rel_pos_resized = rel_pos - - # Scale the coords with short length if shapes for q and k are different. - q_coords = torch.arange(q_size)[:, None] * max(k_size / q_size, 1.0) - k_coords = torch.arange(k_size)[None, :] * max(q_size / k_size, 1.0) - relative_coords = (q_coords - k_coords) + (k_size - 1) * max(q_size / k_size, 1.0) - - return rel_pos_resized[relative_coords.long()] - - -def add_decomposed_rel_pos( - attn: torch.Tensor, - q: torch.Tensor, - rel_pos_h: torch.Tensor, - rel_pos_w: torch.Tensor, - q_size: Tuple[int, int], - k_size: Tuple[int, int], -) -> torch.Tensor: - """ - Calculate decomposed Relative Positional Embeddings from mvitv2 paper at - https://github.com/facebookresearch/mvit/blob/main/mvit/models/attention.py. - - Args: - attn (Tensor): attention map. - q (Tensor): query q in the attention layer with shape (B, q_h * q_w, C). - rel_pos_h (Tensor): relative position embeddings (Lh, C) for height axis. - rel_pos_w (Tensor): relative position embeddings (Lw, C) for width axis. - q_size (Tuple): spatial sequence size of query q with (q_h, q_w). - k_size (Tuple): spatial sequence size of key k with (k_h, k_w). - - Returns: - attn (Tensor): attention map with added relative positional embeddings. - """ - q_h, q_w = q_size - k_h, k_w = k_size - Rh = get_rel_pos(q_h, k_h, rel_pos_h) - Rw = get_rel_pos(q_w, k_w, rel_pos_w) - - B, _, dim = q.shape - r_q = q.reshape(B, q_h, q_w, dim) - rel_h = torch.einsum("bhwc,hkc->bhwk", r_q, Rh) - rel_w = torch.einsum("bhwc,wkc->bhwk", r_q, Rw) - - attn = (attn.view(B, q_h, q_w, k_h, k_w) + rel_h[:, :, :, :, None] + rel_w[:, :, :, None, :]).view( - B, q_h * q_w, k_h * k_w - ) - - return attn - - -class PatchEmbed(nn.Module): - """Image to Patch Embedding.""" - - def __init__( - self, - kernel_size: Tuple[int, int] = (16, 16), - stride: Tuple[int, int] = (16, 16), - padding: Tuple[int, int] = (0, 0), - in_chans: int = 3, - embed_dim: int = 768, - ) -> None: - """ - Initialize PatchEmbed module. - - Args: - kernel_size (Tuple): kernel size of the projection layer. - stride (Tuple): stride of the projection layer. - padding (Tuple): padding size of the projection layer. - in_chans (int): Number of input image channels. - embed_dim (int): Patch embedding dimension. - """ - super().__init__() - - self.proj = nn.Conv2d(in_chans, embed_dim, kernel_size=kernel_size, stride=stride, padding=padding) - - def forward(self, x: torch.Tensor) -> torch.Tensor: - """Computes patch embedding by applying convolution and transposing resulting tensor.""" - return self.proj(x).permute(0, 2, 3, 1) # B C H W -> B H W C diff --git a/ultralytics-main/ultralytics/models/sam/modules/sam.py b/ultralytics-main/ultralytics/models/sam/modules/sam.py deleted file mode 100644 index 95d9bbe..0000000 --- a/ultralytics-main/ultralytics/models/sam/modules/sam.py +++ /dev/null @@ -1,65 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -# Copyright (c) Meta Platforms, Inc. and affiliates. -# All rights reserved. - -# This source code is licensed under the license found in the -# LICENSE file in the root directory of this source tree. - -from typing import List - -import torch -from torch import nn - -from .decoders import MaskDecoder -from .encoders import ImageEncoderViT, PromptEncoder - - -class Sam(nn.Module): - """ - Sam (Segment Anything Model) is designed for object segmentation tasks. It uses image encoders to generate image - embeddings, and prompt encoders to encode various types of input prompts. These embeddings are then used by the mask - decoder to predict object masks. - - Attributes: - mask_threshold (float): Threshold value for mask prediction. - image_format (str): Format of the input image, default is 'RGB'. - image_encoder (ImageEncoderViT): The backbone used to encode the image into embeddings. - prompt_encoder (PromptEncoder): Encodes various types of input prompts. - mask_decoder (MaskDecoder): Predicts object masks from the image and prompt embeddings. - pixel_mean (List[float]): Mean pixel values for image normalization. - pixel_std (List[float]): Standard deviation values for image normalization. - """ - - mask_threshold: float = 0.0 - image_format: str = "RGB" - - def __init__( - self, - image_encoder: ImageEncoderViT, - prompt_encoder: PromptEncoder, - mask_decoder: MaskDecoder, - pixel_mean: List[float] = (123.675, 116.28, 103.53), - pixel_std: List[float] = (58.395, 57.12, 57.375), - ) -> None: - """ - Initialize the Sam class to predict object masks from an image and input prompts. - - Note: - All forward() operations moved to SAMPredictor. - - Args: - image_encoder (ImageEncoderViT): The backbone used to encode the image into image embeddings. - prompt_encoder (PromptEncoder): Encodes various types of input prompts. - mask_decoder (MaskDecoder): Predicts masks from the image embeddings and encoded prompts. - pixel_mean (List[float], optional): Mean values for normalizing pixels in the input image. Defaults to - (123.675, 116.28, 103.53). - pixel_std (List[float], optional): Std values for normalizing pixels in the input image. Defaults to - (58.395, 57.12, 57.375). - """ - super().__init__() - self.image_encoder = image_encoder - self.prompt_encoder = prompt_encoder - self.mask_decoder = mask_decoder - self.register_buffer("pixel_mean", torch.Tensor(pixel_mean).view(-1, 1, 1), False) - self.register_buffer("pixel_std", torch.Tensor(pixel_std).view(-1, 1, 1), False) diff --git a/ultralytics-main/ultralytics/models/sam/modules/tiny_encoder.py b/ultralytics-main/ultralytics/models/sam/modules/tiny_encoder.py deleted file mode 100644 index 98f5ac0..0000000 --- a/ultralytics-main/ultralytics/models/sam/modules/tiny_encoder.py +++ /dev/null @@ -1,742 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -# -------------------------------------------------------- -# TinyViT Model Architecture -# Copyright (c) 2022 Microsoft -# Adapted from LeViT and Swin Transformer -# LeViT: (https://github.com/facebookresearch/levit) -# Swin: (https://github.com/microsoft/swin-transformer) -# Build the TinyViT Model -# -------------------------------------------------------- - -import itertools -from typing import Tuple - -import torch -import torch.nn as nn -import torch.nn.functional as F -import torch.utils.checkpoint as checkpoint - -from ultralytics.utils.instance import to_2tuple - - -class Conv2d_BN(torch.nn.Sequential): - """A sequential container that performs 2D convolution followed by batch normalization.""" - - def __init__(self, a, b, ks=1, stride=1, pad=0, dilation=1, groups=1, bn_weight_init=1): - """Initializes the MBConv model with given input channels, output channels, expansion ratio, activation, and - drop path. - """ - super().__init__() - self.add_module("c", torch.nn.Conv2d(a, b, ks, stride, pad, dilation, groups, bias=False)) - bn = torch.nn.BatchNorm2d(b) - torch.nn.init.constant_(bn.weight, bn_weight_init) - torch.nn.init.constant_(bn.bias, 0) - self.add_module("bn", bn) - - -class PatchEmbed(nn.Module): - """Embeds images into patches and projects them into a specified embedding dimension.""" - - def __init__(self, in_chans, embed_dim, resolution, activation): - """Initialize the PatchMerging class with specified input, output dimensions, resolution and activation - function. - """ - super().__init__() - img_size: Tuple[int, int] = to_2tuple(resolution) - self.patches_resolution = (img_size[0] // 4, img_size[1] // 4) - self.num_patches = self.patches_resolution[0] * self.patches_resolution[1] - self.in_chans = in_chans - self.embed_dim = embed_dim - n = embed_dim - self.seq = nn.Sequential( - Conv2d_BN(in_chans, n // 2, 3, 2, 1), - activation(), - Conv2d_BN(n // 2, n, 3, 2, 1), - ) - - def forward(self, x): - """Runs input tensor 'x' through the PatchMerging model's sequence of operations.""" - return self.seq(x) - - -class MBConv(nn.Module): - """Mobile Inverted Bottleneck Conv (MBConv) layer, part of the EfficientNet architecture.""" - - def __init__(self, in_chans, out_chans, expand_ratio, activation, drop_path): - """Initializes a convolutional layer with specified dimensions, input resolution, depth, and activation - function. - """ - super().__init__() - self.in_chans = in_chans - self.hidden_chans = int(in_chans * expand_ratio) - self.out_chans = out_chans - - self.conv1 = Conv2d_BN(in_chans, self.hidden_chans, ks=1) - self.act1 = activation() - - self.conv2 = Conv2d_BN(self.hidden_chans, self.hidden_chans, ks=3, stride=1, pad=1, groups=self.hidden_chans) - self.act2 = activation() - - self.conv3 = Conv2d_BN(self.hidden_chans, out_chans, ks=1, bn_weight_init=0.0) - self.act3 = activation() - - # NOTE: `DropPath` is needed only for training. - # self.drop_path = DropPath(drop_path) if drop_path > 0. else nn.Identity() - self.drop_path = nn.Identity() - - def forward(self, x): - """Implements the forward pass for the model architecture.""" - shortcut = x - x = self.conv1(x) - x = self.act1(x) - x = self.conv2(x) - x = self.act2(x) - x = self.conv3(x) - x = self.drop_path(x) - x += shortcut - return self.act3(x) - - -class PatchMerging(nn.Module): - """Merges neighboring patches in the feature map and projects to a new dimension.""" - - def __init__(self, input_resolution, dim, out_dim, activation): - """Initializes the ConvLayer with specific dimension, input resolution, depth, activation, drop path, and other - optional parameters. - """ - super().__init__() - - self.input_resolution = input_resolution - self.dim = dim - self.out_dim = out_dim - self.act = activation() - self.conv1 = Conv2d_BN(dim, out_dim, 1, 1, 0) - stride_c = 1 if out_dim in [320, 448, 576] else 2 - self.conv2 = Conv2d_BN(out_dim, out_dim, 3, stride_c, 1, groups=out_dim) - self.conv3 = Conv2d_BN(out_dim, out_dim, 1, 1, 0) - - def forward(self, x): - """Applies forward pass on the input utilizing convolution and activation layers, and returns the result.""" - if x.ndim == 3: - H, W = self.input_resolution - B = len(x) - # (B, C, H, W) - x = x.view(B, H, W, -1).permute(0, 3, 1, 2) - - x = self.conv1(x) - x = self.act(x) - - x = self.conv2(x) - x = self.act(x) - x = self.conv3(x) - return x.flatten(2).transpose(1, 2) - - -class ConvLayer(nn.Module): - """ - Convolutional Layer featuring multiple MobileNetV3-style inverted bottleneck convolutions (MBConv). - - Optionally applies downsample operations to the output, and provides support for gradient checkpointing. - """ - - def __init__( - self, - dim, - input_resolution, - depth, - activation, - drop_path=0.0, - downsample=None, - use_checkpoint=False, - out_dim=None, - conv_expand_ratio=4.0, - ): - """ - Initializes the ConvLayer with the given dimensions and settings. - - Args: - dim (int): The dimensionality of the input and output. - input_resolution (Tuple[int, int]): The resolution of the input image. - depth (int): The number of MBConv layers in the block. - activation (Callable): Activation function applied after each convolution. - drop_path (Union[float, List[float]]): Drop path rate. Single float or a list of floats for each MBConv. - downsample (Optional[Callable]): Function for downsampling the output. None to skip downsampling. - use_checkpoint (bool): Whether to use gradient checkpointing to save memory. - out_dim (Optional[int]): The dimensionality of the output. None means it will be the same as `dim`. - conv_expand_ratio (float): Expansion ratio for the MBConv layers. - """ - super().__init__() - self.dim = dim - self.input_resolution = input_resolution - self.depth = depth - self.use_checkpoint = use_checkpoint - - # Build blocks - self.blocks = nn.ModuleList( - [ - MBConv( - dim, - dim, - conv_expand_ratio, - activation, - drop_path[i] if isinstance(drop_path, list) else drop_path, - ) - for i in range(depth) - ] - ) - - # Patch merging layer - self.downsample = ( - None - if downsample is None - else downsample(input_resolution, dim=dim, out_dim=out_dim, activation=activation) - ) - - def forward(self, x): - """Processes the input through a series of convolutional layers and returns the activated output.""" - for blk in self.blocks: - x = checkpoint.checkpoint(blk, x) if self.use_checkpoint else blk(x) - return x if self.downsample is None else self.downsample(x) - - -class Mlp(nn.Module): - """ - Multi-layer Perceptron (MLP) for transformer architectures. - - This layer takes an input with in_features, applies layer normalization and two fully-connected layers. - """ - - def __init__(self, in_features, hidden_features=None, out_features=None, act_layer=nn.GELU, drop=0.0): - """Initializes Attention module with the given parameters including dimension, key_dim, number of heads, etc.""" - super().__init__() - out_features = out_features or in_features - hidden_features = hidden_features or in_features - self.norm = nn.LayerNorm(in_features) - self.fc1 = nn.Linear(in_features, hidden_features) - self.fc2 = nn.Linear(hidden_features, out_features) - self.act = act_layer() - self.drop = nn.Dropout(drop) - - def forward(self, x): - """Applies operations on input x and returns modified x, runs downsample if not None.""" - x = self.norm(x) - x = self.fc1(x) - x = self.act(x) - x = self.drop(x) - x = self.fc2(x) - return self.drop(x) - - -class Attention(torch.nn.Module): - """ - Multi-head attention module with support for spatial awareness, applying attention biases based on spatial - resolution. Implements trainable attention biases for each unique offset between spatial positions in the resolution - grid. - - Attributes: - ab (Tensor, optional): Cached attention biases for inference, deleted during training. - """ - - def __init__( - self, - dim, - key_dim, - num_heads=8, - attn_ratio=4, - resolution=(14, 14), - ): - """ - Initializes the Attention module. - - Args: - dim (int): The dimensionality of the input and output. - key_dim (int): The dimensionality of the keys and queries. - num_heads (int, optional): Number of attention heads. Default is 8. - attn_ratio (float, optional): Attention ratio, affecting the dimensions of the value vectors. Default is 4. - resolution (Tuple[int, int], optional): Spatial resolution of the input feature map. Default is (14, 14). - - Raises: - AssertionError: If `resolution` is not a tuple of length 2. - """ - super().__init__() - - assert isinstance(resolution, tuple) and len(resolution) == 2 - self.num_heads = num_heads - self.scale = key_dim**-0.5 - self.key_dim = key_dim - self.nh_kd = nh_kd = key_dim * num_heads - self.d = int(attn_ratio * key_dim) - self.dh = int(attn_ratio * key_dim) * num_heads - self.attn_ratio = attn_ratio - h = self.dh + nh_kd * 2 - - self.norm = nn.LayerNorm(dim) - self.qkv = nn.Linear(dim, h) - self.proj = nn.Linear(self.dh, dim) - - points = list(itertools.product(range(resolution[0]), range(resolution[1]))) - N = len(points) - attention_offsets = {} - idxs = [] - for p1 in points: - for p2 in points: - offset = (abs(p1[0] - p2[0]), abs(p1[1] - p2[1])) - if offset not in attention_offsets: - attention_offsets[offset] = len(attention_offsets) - idxs.append(attention_offsets[offset]) - self.attention_biases = torch.nn.Parameter(torch.zeros(num_heads, len(attention_offsets))) - self.register_buffer("attention_bias_idxs", torch.LongTensor(idxs).view(N, N), persistent=False) - - @torch.no_grad() - def train(self, mode=True): - """Sets the module in training mode and handles attribute 'ab' based on the mode.""" - super().train(mode) - if mode and hasattr(self, "ab"): - del self.ab - else: - self.ab = self.attention_biases[:, self.attention_bias_idxs] - - def forward(self, x): # x - """Performs forward pass over the input tensor 'x' by applying normalization and querying keys/values.""" - B, N, _ = x.shape # B, N, C - - # Normalization - x = self.norm(x) - - qkv = self.qkv(x) - # (B, N, num_heads, d) - q, k, v = qkv.view(B, N, self.num_heads, -1).split([self.key_dim, self.key_dim, self.d], dim=3) - # (B, num_heads, N, d) - q = q.permute(0, 2, 1, 3) - k = k.permute(0, 2, 1, 3) - v = v.permute(0, 2, 1, 3) - self.ab = self.ab.to(self.attention_biases.device) - - attn = (q @ k.transpose(-2, -1)) * self.scale + ( - self.attention_biases[:, self.attention_bias_idxs] if self.training else self.ab - ) - attn = attn.softmax(dim=-1) - x = (attn @ v).transpose(1, 2).reshape(B, N, self.dh) - return self.proj(x) - - -class TinyViTBlock(nn.Module): - """TinyViT Block that applies self-attention and a local convolution to the input.""" - - def __init__( - self, - dim, - input_resolution, - num_heads, - window_size=7, - mlp_ratio=4.0, - drop=0.0, - drop_path=0.0, - local_conv_size=3, - activation=nn.GELU, - ): - """ - Initializes the TinyViTBlock. - - Args: - dim (int): The dimensionality of the input and output. - input_resolution (Tuple[int, int]): Spatial resolution of the input feature map. - num_heads (int): Number of attention heads. - window_size (int, optional): Window size for attention. Default is 7. - mlp_ratio (float, optional): Ratio of mlp hidden dim to embedding dim. Default is 4. - drop (float, optional): Dropout rate. Default is 0. - drop_path (float, optional): Stochastic depth rate. Default is 0. - local_conv_size (int, optional): The kernel size of the local convolution. Default is 3. - activation (torch.nn, optional): Activation function for MLP. Default is nn.GELU. - - Raises: - AssertionError: If `window_size` is not greater than 0. - AssertionError: If `dim` is not divisible by `num_heads`. - """ - super().__init__() - self.dim = dim - self.input_resolution = input_resolution - self.num_heads = num_heads - assert window_size > 0, "window_size must be greater than 0" - self.window_size = window_size - self.mlp_ratio = mlp_ratio - - # NOTE: `DropPath` is needed only for training. - # self.drop_path = DropPath(drop_path) if drop_path > 0. else nn.Identity() - self.drop_path = nn.Identity() - - assert dim % num_heads == 0, "dim must be divisible by num_heads" - head_dim = dim // num_heads - - window_resolution = (window_size, window_size) - self.attn = Attention(dim, head_dim, num_heads, attn_ratio=1, resolution=window_resolution) - - mlp_hidden_dim = int(dim * mlp_ratio) - mlp_activation = activation - self.mlp = Mlp(in_features=dim, hidden_features=mlp_hidden_dim, act_layer=mlp_activation, drop=drop) - - pad = local_conv_size // 2 - self.local_conv = Conv2d_BN(dim, dim, ks=local_conv_size, stride=1, pad=pad, groups=dim) - - def forward(self, x): - """Applies attention-based transformation or padding to input 'x' before passing it through a local - convolution. - """ - H, W = self.input_resolution - B, L, C = x.shape - assert L == H * W, "input feature has wrong size" - res_x = x - if H == self.window_size and W == self.window_size: - x = self.attn(x) - else: - x = x.view(B, H, W, C) - pad_b = (self.window_size - H % self.window_size) % self.window_size - pad_r = (self.window_size - W % self.window_size) % self.window_size - padding = pad_b > 0 or pad_r > 0 - - if padding: - x = F.pad(x, (0, 0, 0, pad_r, 0, pad_b)) - - pH, pW = H + pad_b, W + pad_r - nH = pH // self.window_size - nW = pW // self.window_size - # Window partition - x = ( - x.view(B, nH, self.window_size, nW, self.window_size, C) - .transpose(2, 3) - .reshape(B * nH * nW, self.window_size * self.window_size, C) - ) - x = self.attn(x) - # Window reverse - x = x.view(B, nH, nW, self.window_size, self.window_size, C).transpose(2, 3).reshape(B, pH, pW, C) - - if padding: - x = x[:, :H, :W].contiguous() - - x = x.view(B, L, C) - - x = res_x + self.drop_path(x) - - x = x.transpose(1, 2).reshape(B, C, H, W) - x = self.local_conv(x) - x = x.view(B, C, L).transpose(1, 2) - - return x + self.drop_path(self.mlp(x)) - - def extra_repr(self) -> str: - """Returns a formatted string representing the TinyViTBlock's parameters: dimension, input resolution, number of - attentions heads, window size, and MLP ratio. - """ - return ( - f"dim={self.dim}, input_resolution={self.input_resolution}, num_heads={self.num_heads}, " - f"window_size={self.window_size}, mlp_ratio={self.mlp_ratio}" - ) - - -class BasicLayer(nn.Module): - """A basic TinyViT layer for one stage in a TinyViT architecture.""" - - def __init__( - self, - dim, - input_resolution, - depth, - num_heads, - window_size, - mlp_ratio=4.0, - drop=0.0, - drop_path=0.0, - downsample=None, - use_checkpoint=False, - local_conv_size=3, - activation=nn.GELU, - out_dim=None, - ): - """ - Initializes the BasicLayer. - - Args: - dim (int): The dimensionality of the input and output. - input_resolution (Tuple[int, int]): Spatial resolution of the input feature map. - depth (int): Number of TinyViT blocks. - num_heads (int): Number of attention heads. - window_size (int): Local window size. - mlp_ratio (float, optional): Ratio of mlp hidden dim to embedding dim. Default is 4. - drop (float, optional): Dropout rate. Default is 0. - drop_path (float | tuple[float], optional): Stochastic depth rate. Default is 0. - downsample (nn.Module | None, optional): Downsample layer at the end of the layer. Default is None. - use_checkpoint (bool, optional): Whether to use checkpointing to save memory. Default is False. - local_conv_size (int, optional): Kernel size of the local convolution. Default is 3. - activation (torch.nn, optional): Activation function for MLP. Default is nn.GELU. - out_dim (int | None, optional): The output dimension of the layer. Default is None. - - Raises: - ValueError: If `drop_path` is a list of float but its length doesn't match `depth`. - """ - super().__init__() - self.dim = dim - self.input_resolution = input_resolution - self.depth = depth - self.use_checkpoint = use_checkpoint - - # Build blocks - self.blocks = nn.ModuleList( - [ - TinyViTBlock( - dim=dim, - input_resolution=input_resolution, - num_heads=num_heads, - window_size=window_size, - mlp_ratio=mlp_ratio, - drop=drop, - drop_path=drop_path[i] if isinstance(drop_path, list) else drop_path, - local_conv_size=local_conv_size, - activation=activation, - ) - for i in range(depth) - ] - ) - - # Patch merging layer - self.downsample = ( - None - if downsample is None - else downsample(input_resolution, dim=dim, out_dim=out_dim, activation=activation) - ) - - def forward(self, x): - """Performs forward propagation on the input tensor and returns a normalized tensor.""" - for blk in self.blocks: - x = checkpoint.checkpoint(blk, x) if self.use_checkpoint else blk(x) - return x if self.downsample is None else self.downsample(x) - - def extra_repr(self) -> str: - """Returns a string representation of the extra_repr function with the layer's parameters.""" - return f"dim={self.dim}, input_resolution={self.input_resolution}, depth={self.depth}" - - -class LayerNorm2d(nn.Module): - """A PyTorch implementation of Layer Normalization in 2D.""" - - def __init__(self, num_channels: int, eps: float = 1e-6) -> None: - """Initialize LayerNorm2d with the number of channels and an optional epsilon.""" - super().__init__() - self.weight = nn.Parameter(torch.ones(num_channels)) - self.bias = nn.Parameter(torch.zeros(num_channels)) - self.eps = eps - - def forward(self, x: torch.Tensor) -> torch.Tensor: - """Perform a forward pass, normalizing the input tensor.""" - u = x.mean(1, keepdim=True) - s = (x - u).pow(2).mean(1, keepdim=True) - x = (x - u) / torch.sqrt(s + self.eps) - return self.weight[:, None, None] * x + self.bias[:, None, None] - - -class TinyViT(nn.Module): - """ - The TinyViT architecture for vision tasks. - - Attributes: - img_size (int): Input image size. - in_chans (int): Number of input channels. - num_classes (int): Number of classification classes. - embed_dims (List[int]): List of embedding dimensions for each layer. - depths (List[int]): List of depths for each layer. - num_heads (List[int]): List of number of attention heads for each layer. - window_sizes (List[int]): List of window sizes for each layer. - mlp_ratio (float): Ratio of MLP hidden dimension to embedding dimension. - drop_rate (float): Dropout rate for drop layers. - drop_path_rate (float): Drop path rate for stochastic depth. - use_checkpoint (bool): Use checkpointing for efficient memory usage. - mbconv_expand_ratio (float): Expansion ratio for MBConv layer. - local_conv_size (int): Local convolution kernel size. - layer_lr_decay (float): Layer-wise learning rate decay. - - Note: - This implementation is generalized to accept a list of depths, attention heads, - embedding dimensions and window sizes, which allows you to create a - "stack" of TinyViT models of varying configurations. - """ - - def __init__( - self, - img_size=224, - in_chans=3, - num_classes=1000, - embed_dims=[96, 192, 384, 768], - depths=[2, 2, 6, 2], - num_heads=[3, 6, 12, 24], - window_sizes=[7, 7, 14, 7], - mlp_ratio=4.0, - drop_rate=0.0, - drop_path_rate=0.1, - use_checkpoint=False, - mbconv_expand_ratio=4.0, - local_conv_size=3, - layer_lr_decay=1.0, - ): - """ - Initializes the TinyViT model. - - Args: - img_size (int, optional): The input image size. Defaults to 224. - in_chans (int, optional): Number of input channels. Defaults to 3. - num_classes (int, optional): Number of classification classes. Defaults to 1000. - embed_dims (List[int], optional): List of embedding dimensions for each layer. Defaults to [96, 192, 384, 768]. - depths (List[int], optional): List of depths for each layer. Defaults to [2, 2, 6, 2]. - num_heads (List[int], optional): List of number of attention heads for each layer. Defaults to [3, 6, 12, 24]. - window_sizes (List[int], optional): List of window sizes for each layer. Defaults to [7, 7, 14, 7]. - mlp_ratio (float, optional): Ratio of MLP hidden dimension to embedding dimension. Defaults to 4. - drop_rate (float, optional): Dropout rate. Defaults to 0. - drop_path_rate (float, optional): Drop path rate for stochastic depth. Defaults to 0.1. - use_checkpoint (bool, optional): Whether to use checkpointing for efficient memory usage. Defaults to False. - mbconv_expand_ratio (float, optional): Expansion ratio for MBConv layer. Defaults to 4.0. - local_conv_size (int, optional): Local convolution kernel size. Defaults to 3. - layer_lr_decay (float, optional): Layer-wise learning rate decay. Defaults to 1.0. - """ - super().__init__() - self.img_size = img_size - self.num_classes = num_classes - self.depths = depths - self.num_layers = len(depths) - self.mlp_ratio = mlp_ratio - - activation = nn.GELU - - self.patch_embed = PatchEmbed( - in_chans=in_chans, embed_dim=embed_dims[0], resolution=img_size, activation=activation - ) - - patches_resolution = self.patch_embed.patches_resolution - self.patches_resolution = patches_resolution - - # Stochastic depth - dpr = [x.item() for x in torch.linspace(0, drop_path_rate, sum(depths))] # stochastic depth decay rule - - # Build layers - self.layers = nn.ModuleList() - for i_layer in range(self.num_layers): - kwargs = dict( - dim=embed_dims[i_layer], - input_resolution=( - patches_resolution[0] // (2 ** (i_layer - 1 if i_layer == 3 else i_layer)), - patches_resolution[1] // (2 ** (i_layer - 1 if i_layer == 3 else i_layer)), - ), - # input_resolution=(patches_resolution[0] // (2 ** i_layer), - # patches_resolution[1] // (2 ** i_layer)), - depth=depths[i_layer], - drop_path=dpr[sum(depths[:i_layer]) : sum(depths[: i_layer + 1])], - downsample=PatchMerging if (i_layer < self.num_layers - 1) else None, - use_checkpoint=use_checkpoint, - out_dim=embed_dims[min(i_layer + 1, len(embed_dims) - 1)], - activation=activation, - ) - if i_layer == 0: - layer = ConvLayer(conv_expand_ratio=mbconv_expand_ratio, **kwargs) - else: - layer = BasicLayer( - num_heads=num_heads[i_layer], - window_size=window_sizes[i_layer], - mlp_ratio=self.mlp_ratio, - drop=drop_rate, - local_conv_size=local_conv_size, - **kwargs, - ) - self.layers.append(layer) - - # Classifier head - self.norm_head = nn.LayerNorm(embed_dims[-1]) - self.head = nn.Linear(embed_dims[-1], num_classes) if num_classes > 0 else torch.nn.Identity() - - # Init weights - self.apply(self._init_weights) - self.set_layer_lr_decay(layer_lr_decay) - self.neck = nn.Sequential( - nn.Conv2d( - embed_dims[-1], - 256, - kernel_size=1, - bias=False, - ), - LayerNorm2d(256), - nn.Conv2d( - 256, - 256, - kernel_size=3, - padding=1, - bias=False, - ), - LayerNorm2d(256), - ) - - def set_layer_lr_decay(self, layer_lr_decay): - """Sets the learning rate decay for each layer in the TinyViT model.""" - decay_rate = layer_lr_decay - - # Layers -> blocks (depth) - depth = sum(self.depths) - lr_scales = [decay_rate ** (depth - i - 1) for i in range(depth)] - - def _set_lr_scale(m, scale): - """Sets the learning rate scale for each layer in the model based on the layer's depth.""" - for p in m.parameters(): - p.lr_scale = scale - - self.patch_embed.apply(lambda x: _set_lr_scale(x, lr_scales[0])) - i = 0 - for layer in self.layers: - for block in layer.blocks: - block.apply(lambda x: _set_lr_scale(x, lr_scales[i])) - i += 1 - if layer.downsample is not None: - layer.downsample.apply(lambda x: _set_lr_scale(x, lr_scales[i - 1])) - assert i == depth - for m in [self.norm_head, self.head]: - m.apply(lambda x: _set_lr_scale(x, lr_scales[-1])) - - for k, p in self.named_parameters(): - p.param_name = k - - def _check_lr_scale(m): - """Checks if the learning rate scale attribute is present in module's parameters.""" - for p in m.parameters(): - assert hasattr(p, "lr_scale"), p.param_name - - self.apply(_check_lr_scale) - - def _init_weights(self, m): - """Initializes weights for linear layers and layer normalization in the given module.""" - if isinstance(m, nn.Linear): - # NOTE: This initialization is needed only for training. - # trunc_normal_(m.weight, std=.02) - if m.bias is not None: - nn.init.constant_(m.bias, 0) - elif isinstance(m, nn.LayerNorm): - nn.init.constant_(m.bias, 0) - nn.init.constant_(m.weight, 1.0) - - @torch.jit.ignore - def no_weight_decay_keywords(self): - """Returns a dictionary of parameter names where weight decay should not be applied.""" - return {"attention_biases"} - - def forward_features(self, x): - """Runs the input through the model layers and returns the transformed output.""" - x = self.patch_embed(x) # x input is (N, C, H, W) - - x = self.layers[0](x) - start_i = 1 - - for i in range(start_i, len(self.layers)): - layer = self.layers[i] - x = layer(x) - B, _, C = x.shape - x = x.view(B, 64, 64, C) - x = x.permute(0, 3, 1, 2) - return self.neck(x) - - def forward(self, x): - """Executes a forward pass on the input tensor through the constructed model layers.""" - return self.forward_features(x) diff --git a/ultralytics-main/ultralytics/models/sam/modules/transformer.py b/ultralytics-main/ultralytics/models/sam/modules/transformer.py deleted file mode 100644 index 1ad0741..0000000 --- a/ultralytics-main/ultralytics/models/sam/modules/transformer.py +++ /dev/null @@ -1,274 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import math -from typing import Tuple, Type - -import torch -from torch import Tensor, nn - -from ultralytics.nn.modules import MLPBlock - - -class TwoWayTransformer(nn.Module): - """ - A Two-Way Transformer module that enables the simultaneous attention to both image and query points. This class - serves as a specialized transformer decoder that attends to an input image using queries whose positional embedding - is supplied. This is particularly useful for tasks like object detection, image segmentation, and point cloud - processing. - - Attributes: - depth (int): The number of layers in the transformer. - embedding_dim (int): The channel dimension for the input embeddings. - num_heads (int): The number of heads for multihead attention. - mlp_dim (int): The internal channel dimension for the MLP block. - layers (nn.ModuleList): The list of TwoWayAttentionBlock layers that make up the transformer. - final_attn_token_to_image (Attention): The final attention layer applied from the queries to the image. - norm_final_attn (nn.LayerNorm): The layer normalization applied to the final queries. - """ - - def __init__( - self, - depth: int, - embedding_dim: int, - num_heads: int, - mlp_dim: int, - activation: Type[nn.Module] = nn.ReLU, - attention_downsample_rate: int = 2, - ) -> None: - """ - A transformer decoder that attends to an input image using queries whose positional embedding is supplied. - - Args: - depth (int): number of layers in the transformer - embedding_dim (int): the channel dimension for the input embeddings - num_heads (int): the number of heads for multihead attention. Must - divide embedding_dim - mlp_dim (int): the channel dimension internal to the MLP block - activation (nn.Module): the activation to use in the MLP block - """ - super().__init__() - self.depth = depth - self.embedding_dim = embedding_dim - self.num_heads = num_heads - self.mlp_dim = mlp_dim - self.layers = nn.ModuleList() - - for i in range(depth): - self.layers.append( - TwoWayAttentionBlock( - embedding_dim=embedding_dim, - num_heads=num_heads, - mlp_dim=mlp_dim, - activation=activation, - attention_downsample_rate=attention_downsample_rate, - skip_first_layer_pe=(i == 0), - ) - ) - - self.final_attn_token_to_image = Attention(embedding_dim, num_heads, downsample_rate=attention_downsample_rate) - self.norm_final_attn = nn.LayerNorm(embedding_dim) - - def forward( - self, - image_embedding: Tensor, - image_pe: Tensor, - point_embedding: Tensor, - ) -> Tuple[Tensor, Tensor]: - """ - Args: - image_embedding (torch.Tensor): image to attend to. Should be shape B x embedding_dim x h x w for any h and w. - image_pe (torch.Tensor): the positional encoding to add to the image. Must have same shape as image_embedding. - point_embedding (torch.Tensor): the embedding to add to the query points. - Must have shape B x N_points x embedding_dim for any N_points. - - Returns: - (torch.Tensor): the processed point_embedding - (torch.Tensor): the processed image_embedding - """ - # BxCxHxW -> BxHWxC == B x N_image_tokens x C - bs, c, h, w = image_embedding.shape - image_embedding = image_embedding.flatten(2).permute(0, 2, 1) - image_pe = image_pe.flatten(2).permute(0, 2, 1) - - # Prepare queries - queries = point_embedding - keys = image_embedding - - # Apply transformer blocks and final layernorm - for layer in self.layers: - queries, keys = layer( - queries=queries, - keys=keys, - query_pe=point_embedding, - key_pe=image_pe, - ) - - # Apply the final attention layer from the points to the image - q = queries + point_embedding - k = keys + image_pe - attn_out = self.final_attn_token_to_image(q=q, k=k, v=keys) - queries = queries + attn_out - queries = self.norm_final_attn(queries) - - return queries, keys - - -class TwoWayAttentionBlock(nn.Module): - """ - An attention block that performs both self-attention and cross-attention in two directions: queries to keys and - keys to queries. This block consists of four main layers: (1) self-attention on sparse inputs, (2) cross-attention - of sparse inputs to dense inputs, (3) an MLP block on sparse inputs, and (4) cross-attention of dense inputs to - sparse inputs. - - Attributes: - self_attn (Attention): The self-attention layer for the queries. - norm1 (nn.LayerNorm): Layer normalization following the first attention block. - cross_attn_token_to_image (Attention): Cross-attention layer from queries to keys. - norm2 (nn.LayerNorm): Layer normalization following the second attention block. - mlp (MLPBlock): MLP block that transforms the query embeddings. - norm3 (nn.LayerNorm): Layer normalization following the MLP block. - norm4 (nn.LayerNorm): Layer normalization following the third attention block. - cross_attn_image_to_token (Attention): Cross-attention layer from keys to queries. - skip_first_layer_pe (bool): Whether to skip the positional encoding in the first layer. - """ - - def __init__( - self, - embedding_dim: int, - num_heads: int, - mlp_dim: int = 2048, - activation: Type[nn.Module] = nn.ReLU, - attention_downsample_rate: int = 2, - skip_first_layer_pe: bool = False, - ) -> None: - """ - A transformer block with four layers: (1) self-attention of sparse inputs, (2) cross attention of sparse - inputs to dense inputs, (3) mlp block on sparse inputs, and (4) cross attention of dense inputs to sparse - inputs. - - Args: - embedding_dim (int): the channel dimension of the embeddings - num_heads (int): the number of heads in the attention layers - mlp_dim (int): the hidden dimension of the mlp block - activation (nn.Module): the activation of the mlp block - skip_first_layer_pe (bool): skip the PE on the first layer - """ - super().__init__() - self.self_attn = Attention(embedding_dim, num_heads) - self.norm1 = nn.LayerNorm(embedding_dim) - - self.cross_attn_token_to_image = Attention(embedding_dim, num_heads, downsample_rate=attention_downsample_rate) - self.norm2 = nn.LayerNorm(embedding_dim) - - self.mlp = MLPBlock(embedding_dim, mlp_dim, activation) - self.norm3 = nn.LayerNorm(embedding_dim) - - self.norm4 = nn.LayerNorm(embedding_dim) - self.cross_attn_image_to_token = Attention(embedding_dim, num_heads, downsample_rate=attention_downsample_rate) - - self.skip_first_layer_pe = skip_first_layer_pe - - def forward(self, queries: Tensor, keys: Tensor, query_pe: Tensor, key_pe: Tensor) -> Tuple[Tensor, Tensor]: - """Apply self-attention and cross-attention to queries and keys and return the processed embeddings.""" - - # Self attention block - if self.skip_first_layer_pe: - queries = self.self_attn(q=queries, k=queries, v=queries) - else: - q = queries + query_pe - attn_out = self.self_attn(q=q, k=q, v=queries) - queries = queries + attn_out - queries = self.norm1(queries) - - # Cross attention block, tokens attending to image embedding - q = queries + query_pe - k = keys + key_pe - attn_out = self.cross_attn_token_to_image(q=q, k=k, v=keys) - queries = queries + attn_out - queries = self.norm2(queries) - - # MLP block - mlp_out = self.mlp(queries) - queries = queries + mlp_out - queries = self.norm3(queries) - - # Cross attention block, image embedding attending to tokens - q = queries + query_pe - k = keys + key_pe - attn_out = self.cross_attn_image_to_token(q=k, k=q, v=queries) - keys = keys + attn_out - keys = self.norm4(keys) - - return queries, keys - - -class Attention(nn.Module): - """An attention layer that allows for downscaling the size of the embedding after projection to queries, keys, and - values. - """ - - def __init__( - self, - embedding_dim: int, - num_heads: int, - downsample_rate: int = 1, - ) -> None: - """ - Initializes the Attention model with the given dimensions and settings. - - Args: - embedding_dim (int): The dimensionality of the input embeddings. - num_heads (int): The number of attention heads. - downsample_rate (int, optional): The factor by which the internal dimensions are downsampled. Defaults to 1. - - Raises: - AssertionError: If 'num_heads' does not evenly divide the internal dimension (embedding_dim / downsample_rate). - """ - super().__init__() - self.embedding_dim = embedding_dim - self.internal_dim = embedding_dim // downsample_rate - self.num_heads = num_heads - assert self.internal_dim % num_heads == 0, "num_heads must divide embedding_dim." - - self.q_proj = nn.Linear(embedding_dim, self.internal_dim) - self.k_proj = nn.Linear(embedding_dim, self.internal_dim) - self.v_proj = nn.Linear(embedding_dim, self.internal_dim) - self.out_proj = nn.Linear(self.internal_dim, embedding_dim) - - @staticmethod - def _separate_heads(x: Tensor, num_heads: int) -> Tensor: - """Separate the input tensor into the specified number of attention heads.""" - b, n, c = x.shape - x = x.reshape(b, n, num_heads, c // num_heads) - return x.transpose(1, 2) # B x N_heads x N_tokens x C_per_head - - @staticmethod - def _recombine_heads(x: Tensor) -> Tensor: - """Recombine the separated attention heads into a single tensor.""" - b, n_heads, n_tokens, c_per_head = x.shape - x = x.transpose(1, 2) - return x.reshape(b, n_tokens, n_heads * c_per_head) # B x N_tokens x C - - def forward(self, q: Tensor, k: Tensor, v: Tensor) -> Tensor: - """Compute the attention output given the input query, key, and value tensors.""" - - # Input projections - q = self.q_proj(q) - k = self.k_proj(k) - v = self.v_proj(v) - - # Separate into heads - q = self._separate_heads(q, self.num_heads) - k = self._separate_heads(k, self.num_heads) - v = self._separate_heads(v, self.num_heads) - - # Attention - _, _, _, c_per_head = q.shape - attn = q @ k.permute(0, 1, 3, 2) # B x N_heads x N_tokens x N_tokens - attn = attn / math.sqrt(c_per_head) - attn = torch.softmax(attn, dim=-1) - - # Get output - out = attn @ v - out = self._recombine_heads(out) - return self.out_proj(out) diff --git a/ultralytics-main/ultralytics/models/sam/predict.py b/ultralytics-main/ultralytics/models/sam/predict.py deleted file mode 100644 index 63ca632..0000000 --- a/ultralytics-main/ultralytics/models/sam/predict.py +++ /dev/null @@ -1,474 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -""" -Generate predictions using the Segment Anything Model (SAM). - -SAM is an advanced image segmentation model offering features like promptable segmentation and zero-shot performance. -This module contains the implementation of the prediction logic and auxiliary utilities required to perform segmentation -using SAM. It forms an integral part of the Ultralytics framework and is designed for high-performance, real-time image -segmentation tasks. -""" - -import numpy as np -import torch -import torch.nn.functional as F -import torchvision - -from ultralytics.data.augment import LetterBox -from ultralytics.engine.predictor import BasePredictor -from ultralytics.engine.results import Results -from ultralytics.utils import DEFAULT_CFG, ops -from ultralytics.utils.torch_utils import select_device -from .amg import ( - batch_iterator, - batched_mask_to_box, - build_all_layer_point_grids, - calculate_stability_score, - generate_crop_boxes, - is_box_near_crop_edge, - remove_small_regions, - uncrop_boxes_xyxy, - uncrop_masks, -) -from .build import build_sam - - -class Predictor(BasePredictor): - """ - Predictor class for the Segment Anything Model (SAM), extending BasePredictor. - - The class provides an interface for model inference tailored to image segmentation tasks. - With advanced architecture and promptable segmentation capabilities, it facilitates flexible and real-time - mask generation. The class is capable of working with various types of prompts such as bounding boxes, - points, and low-resolution masks. - - Attributes: - cfg (dict): Configuration dictionary specifying model and task-related parameters. - overrides (dict): Dictionary containing values that override the default configuration. - _callbacks (dict): Dictionary of user-defined callback functions to augment behavior. - args (namespace): Namespace to hold command-line arguments or other operational variables. - im (torch.Tensor): Preprocessed input image tensor. - features (torch.Tensor): Extracted image features used for inference. - prompts (dict): Collection of various prompt types, such as bounding boxes and points. - segment_all (bool): Flag to control whether to segment all objects in the image or only specified ones. - """ - - def __init__(self, cfg=DEFAULT_CFG, overrides=None, _callbacks=None): - """ - Initialize the Predictor with configuration, overrides, and callbacks. - - The method sets up the Predictor object and applies any configuration overrides or callbacks provided. It - initializes task-specific settings for SAM, such as retina_masks being set to True for optimal results. - - Args: - cfg (dict): Configuration dictionary. - overrides (dict, optional): Dictionary of values to override default configuration. - _callbacks (dict, optional): Dictionary of callback functions to customize behavior. - """ - if overrides is None: - overrides = {} - overrides.update(dict(task="segment", mode="predict", imgsz=1024)) - super().__init__(cfg, overrides, _callbacks) - self.args.retina_masks = True - self.im = None - self.features = None - self.prompts = {} - self.segment_all = False - - def preprocess(self, im): - """ - Preprocess the input image for model inference. - - The method prepares the input image by applying transformations and normalization. - It supports both torch.Tensor and list of np.ndarray as input formats. - - Args: - im (torch.Tensor | List[np.ndarray]): BCHW tensor format or list of HWC numpy arrays. - - Returns: - (torch.Tensor): The preprocessed image tensor. - """ - if self.im is not None: - return self.im - not_tensor = not isinstance(im, torch.Tensor) - if not_tensor: - im = np.stack(self.pre_transform(im)) - im = im[..., ::-1].transpose((0, 3, 1, 2)) - im = np.ascontiguousarray(im) - im = torch.from_numpy(im) - - im = im.to(self.device) - im = im.half() if self.model.fp16 else im.float() - if not_tensor: - im = (im - self.mean) / self.std - return im - - def pre_transform(self, im): - """ - Perform initial transformations on the input image for preprocessing. - - The method applies transformations such as resizing to prepare the image for further preprocessing. - Currently, batched inference is not supported; hence the list length should be 1. - - Args: - im (List[np.ndarray]): List containing images in HWC numpy array format. - - Returns: - (List[np.ndarray]): List of transformed images. - """ - assert len(im) == 1, "SAM model does not currently support batched inference" - letterbox = LetterBox(self.args.imgsz, auto=False, center=False) - return [letterbox(image=x) for x in im] - - def inference(self, im, bboxes=None, points=None, labels=None, masks=None, multimask_output=False, *args, **kwargs): - """ - Perform image segmentation inference based on the given input cues, using the currently loaded image. This - method leverages SAM's (Segment Anything Model) architecture consisting of image encoder, prompt encoder, and - mask decoder for real-time and promptable segmentation tasks. - - Args: - im (torch.Tensor): The preprocessed input image in tensor format, with shape (N, C, H, W). - bboxes (np.ndarray | List, optional): Bounding boxes with shape (N, 4), in XYXY format. - points (np.ndarray | List, optional): Points indicating object locations with shape (N, 2), in pixel coordinates. - labels (np.ndarray | List, optional): Labels for point prompts, shape (N, ). 1 for foreground and 0 for background. - masks (np.ndarray, optional): Low-resolution masks from previous predictions. Shape should be (N, H, W). For SAM, H=W=256. - multimask_output (bool, optional): Flag to return multiple masks. Helpful for ambiguous prompts. Defaults to False. - - Returns: - (tuple): Contains the following three elements. - - np.ndarray: The output masks in shape CxHxW, where C is the number of generated masks. - - np.ndarray: An array of length C containing quality scores predicted by the model for each mask. - - np.ndarray: Low-resolution logits of shape CxHxW for subsequent inference, where H=W=256. - """ - # Override prompts if any stored in self.prompts - bboxes = self.prompts.pop("bboxes", bboxes) - points = self.prompts.pop("points", points) - masks = self.prompts.pop("masks", masks) - - if all(i is None for i in [bboxes, points, masks]): - return self.generate(im, *args, **kwargs) - - return self.prompt_inference(im, bboxes, points, labels, masks, multimask_output) - - def prompt_inference(self, im, bboxes=None, points=None, labels=None, masks=None, multimask_output=False): - """ - Internal function for image segmentation inference based on cues like bounding boxes, points, and masks. - Leverages SAM's specialized architecture for prompt-based, real-time segmentation. - - Args: - im (torch.Tensor): The preprocessed input image in tensor format, with shape (N, C, H, W). - bboxes (np.ndarray | List, optional): Bounding boxes with shape (N, 4), in XYXY format. - points (np.ndarray | List, optional): Points indicating object locations with shape (N, 2), in pixel coordinates. - labels (np.ndarray | List, optional): Labels for point prompts, shape (N, ). 1 for foreground and 0 for background. - masks (np.ndarray, optional): Low-resolution masks from previous predictions. Shape should be (N, H, W). For SAM, H=W=256. - multimask_output (bool, optional): Flag to return multiple masks. Helpful for ambiguous prompts. Defaults to False. - - Returns: - (tuple): Contains the following three elements. - - np.ndarray: The output masks in shape CxHxW, where C is the number of generated masks. - - np.ndarray: An array of length C containing quality scores predicted by the model for each mask. - - np.ndarray: Low-resolution logits of shape CxHxW for subsequent inference, where H=W=256. - """ - features = self.model.image_encoder(im) if self.features is None else self.features - - src_shape, dst_shape = self.batch[1][0].shape[:2], im.shape[2:] - r = 1.0 if self.segment_all else min(dst_shape[0] / src_shape[0], dst_shape[1] / src_shape[1]) - # Transform input prompts - if points is not None: - points = torch.as_tensor(points, dtype=torch.float32, device=self.device) - points = points[None] if points.ndim == 1 else points - # Assuming labels are all positive if users don't pass labels. - if labels is None: - labels = np.ones(points.shape[0]) - labels = torch.as_tensor(labels, dtype=torch.int32, device=self.device) - points *= r - # (N, 2) --> (N, 1, 2), (N, ) --> (N, 1) - points, labels = points[:, None, :], labels[:, None] - if bboxes is not None: - bboxes = torch.as_tensor(bboxes, dtype=torch.float32, device=self.device) - bboxes = bboxes[None] if bboxes.ndim == 1 else bboxes - bboxes *= r - if masks is not None: - masks = torch.as_tensor(masks, dtype=torch.float32, device=self.device).unsqueeze(1) - - points = (points, labels) if points is not None else None - # Embed prompts - sparse_embeddings, dense_embeddings = self.model.prompt_encoder(points=points, boxes=bboxes, masks=masks) - - # Predict masks - pred_masks, pred_scores = self.model.mask_decoder( - image_embeddings=features, - image_pe=self.model.prompt_encoder.get_dense_pe(), - sparse_prompt_embeddings=sparse_embeddings, - dense_prompt_embeddings=dense_embeddings, - multimask_output=multimask_output, - ) - - # (N, d, H, W) --> (N*d, H, W), (N, d) --> (N*d, ) - # `d` could be 1 or 3 depends on `multimask_output`. - return pred_masks.flatten(0, 1), pred_scores.flatten(0, 1) - - def generate( - self, - im, - crop_n_layers=0, - crop_overlap_ratio=512 / 1500, - crop_downscale_factor=1, - point_grids=None, - points_stride=32, - points_batch_size=64, - conf_thres=0.88, - stability_score_thresh=0.95, - stability_score_offset=0.95, - crop_nms_thresh=0.7, - ): - """ - Perform image segmentation using the Segment Anything Model (SAM). - - This function segments an entire image into constituent parts by leveraging SAM's advanced architecture - and real-time performance capabilities. It can optionally work on image crops for finer segmentation. - - Args: - im (torch.Tensor): Input tensor representing the preprocessed image with dimensions (N, C, H, W). - crop_n_layers (int): Specifies the number of layers for additional mask predictions on image crops. - Each layer produces 2**i_layer number of image crops. - crop_overlap_ratio (float): Determines the extent of overlap between crops. Scaled down in subsequent layers. - crop_downscale_factor (int): Scaling factor for the number of sampled points-per-side in each layer. - point_grids (list[np.ndarray], optional): Custom grids for point sampling normalized to [0,1]. - Used in the nth crop layer. - points_stride (int, optional): Number of points to sample along each side of the image. - Exclusive with 'point_grids'. - points_batch_size (int): Batch size for the number of points processed simultaneously. - conf_thres (float): Confidence threshold [0,1] for filtering based on the model's mask quality prediction. - stability_score_thresh (float): Stability threshold [0,1] for mask filtering based on mask stability. - stability_score_offset (float): Offset value for calculating stability score. - crop_nms_thresh (float): IoU cutoff for Non-Maximum Suppression (NMS) to remove duplicate masks between crops. - - Returns: - (tuple): A tuple containing segmented masks, confidence scores, and bounding boxes. - """ - self.segment_all = True - ih, iw = im.shape[2:] - crop_regions, layer_idxs = generate_crop_boxes((ih, iw), crop_n_layers, crop_overlap_ratio) - if point_grids is None: - point_grids = build_all_layer_point_grids(points_stride, crop_n_layers, crop_downscale_factor) - pred_masks, pred_scores, pred_bboxes, region_areas = [], [], [], [] - for crop_region, layer_idx in zip(crop_regions, layer_idxs): - x1, y1, x2, y2 = crop_region - w, h = x2 - x1, y2 - y1 - area = torch.tensor(w * h, device=im.device) - points_scale = np.array([[w, h]]) # w, h - # Crop image and interpolate to input size - crop_im = F.interpolate(im[..., y1:y2, x1:x2], (ih, iw), mode="bilinear", align_corners=False) - # (num_points, 2) - points_for_image = point_grids[layer_idx] * points_scale - crop_masks, crop_scores, crop_bboxes = [], [], [] - for (points,) in batch_iterator(points_batch_size, points_for_image): - pred_mask, pred_score = self.prompt_inference(crop_im, points=points, multimask_output=True) - # Interpolate predicted masks to input size - pred_mask = F.interpolate(pred_mask[None], (h, w), mode="bilinear", align_corners=False)[0] - idx = pred_score > conf_thres - pred_mask, pred_score = pred_mask[idx], pred_score[idx] - - stability_score = calculate_stability_score( - pred_mask, self.model.mask_threshold, stability_score_offset - ) - idx = stability_score > stability_score_thresh - pred_mask, pred_score = pred_mask[idx], pred_score[idx] - # Bool type is much more memory-efficient. - pred_mask = pred_mask > self.model.mask_threshold - # (N, 4) - pred_bbox = batched_mask_to_box(pred_mask).float() - keep_mask = ~is_box_near_crop_edge(pred_bbox, crop_region, [0, 0, iw, ih]) - if not torch.all(keep_mask): - pred_bbox, pred_mask, pred_score = pred_bbox[keep_mask], pred_mask[keep_mask], pred_score[keep_mask] - - crop_masks.append(pred_mask) - crop_bboxes.append(pred_bbox) - crop_scores.append(pred_score) - - # Do nms within this crop - crop_masks = torch.cat(crop_masks) - crop_bboxes = torch.cat(crop_bboxes) - crop_scores = torch.cat(crop_scores) - keep = torchvision.ops.nms(crop_bboxes, crop_scores, self.args.iou) # NMS - crop_bboxes = uncrop_boxes_xyxy(crop_bboxes[keep], crop_region) - crop_masks = uncrop_masks(crop_masks[keep], crop_region, ih, iw) - crop_scores = crop_scores[keep] - - pred_masks.append(crop_masks) - pred_bboxes.append(crop_bboxes) - pred_scores.append(crop_scores) - region_areas.append(area.expand(len(crop_masks))) - - pred_masks = torch.cat(pred_masks) - pred_bboxes = torch.cat(pred_bboxes) - pred_scores = torch.cat(pred_scores) - region_areas = torch.cat(region_areas) - - # Remove duplicate masks between crops - if len(crop_regions) > 1: - scores = 1 / region_areas - keep = torchvision.ops.nms(pred_bboxes, scores, crop_nms_thresh) - pred_masks, pred_bboxes, pred_scores = pred_masks[keep], pred_bboxes[keep], pred_scores[keep] - - return pred_masks, pred_scores, pred_bboxes - - def setup_model(self, model, verbose=True): - """ - Initializes the Segment Anything Model (SAM) for inference. - - This method sets up the SAM model by allocating it to the appropriate device and initializing the necessary - parameters for image normalization and other Ultralytics compatibility settings. - - Args: - model (torch.nn.Module): A pre-trained SAM model. If None, a model will be built based on configuration. - verbose (bool): If True, prints selected device information. - - Attributes: - model (torch.nn.Module): The SAM model allocated to the chosen device for inference. - device (torch.device): The device to which the model and tensors are allocated. - mean (torch.Tensor): The mean values for image normalization. - std (torch.Tensor): The standard deviation values for image normalization. - """ - device = select_device(self.args.device, verbose=verbose) - if model is None: - model = build_sam(self.args.model) - model.eval() - self.model = model.to(device) - self.device = device - self.mean = torch.tensor([123.675, 116.28, 103.53]).view(-1, 1, 1).to(device) - self.std = torch.tensor([58.395, 57.12, 57.375]).view(-1, 1, 1).to(device) - - # Ultralytics compatibility settings - self.model.pt = False - self.model.triton = False - self.model.stride = 32 - self.model.fp16 = False - self.done_warmup = True - - def postprocess(self, preds, img, orig_imgs): - """ - Post-processes SAM's inference outputs to generate object detection masks and bounding boxes. - - The method scales masks and boxes to the original image size and applies a threshold to the mask predictions. The - SAM model uses advanced architecture and promptable segmentation tasks to achieve real-time performance. - - Args: - preds (tuple): The output from SAM model inference, containing masks, scores, and optional bounding boxes. - img (torch.Tensor): The processed input image tensor. - orig_imgs (list | torch.Tensor): The original, unprocessed images. - - Returns: - (list): List of Results objects containing detection masks, bounding boxes, and other metadata. - """ - # (N, 1, H, W), (N, 1) - pred_masks, pred_scores = preds[:2] - pred_bboxes = preds[2] if self.segment_all else None - names = dict(enumerate(str(i) for i in range(len(pred_masks)))) - - if not isinstance(orig_imgs, list): # input images are a torch.Tensor, not a list - orig_imgs = ops.convert_torch2numpy_batch(orig_imgs) - - results = [] - for i, masks in enumerate([pred_masks]): - orig_img = orig_imgs[i] - if pred_bboxes is not None: - pred_bboxes = ops.scale_boxes(img.shape[2:], pred_bboxes.float(), orig_img.shape, padding=False) - cls = torch.arange(len(pred_masks), dtype=torch.int32, device=pred_masks.device) - pred_bboxes = torch.cat([pred_bboxes, pred_scores[:, None], cls[:, None]], dim=-1) - - masks = ops.scale_masks(masks[None].float(), orig_img.shape[:2], padding=False)[0] - masks = masks > self.model.mask_threshold # to bool - img_path = self.batch[0][i] - results.append(Results(orig_img, path=img_path, names=names, masks=masks, boxes=pred_bboxes)) - # Reset segment-all mode. - self.segment_all = False - return results - - def setup_source(self, source): - """ - Sets up the data source for inference. - - This method configures the data source from which images will be fetched for inference. The source could be a - directory, a video file, or other types of image data sources. - - Args: - source (str | Path): The path to the image data source for inference. - """ - if source is not None: - super().setup_source(source) - - def set_image(self, image): - """ - Preprocesses and sets a single image for inference. - - This function sets up the model if not already initialized, configures the data source to the specified image, - and preprocesses the image for feature extraction. Only one image can be set at a time. - - Args: - image (str | np.ndarray): Image file path as a string, or a np.ndarray image read by cv2. - - Raises: - AssertionError: If more than one image is set. - """ - if self.model is None: - model = build_sam(self.args.model) - self.setup_model(model) - self.setup_source(image) - assert len(self.dataset) == 1, "`set_image` only supports setting one image!" - for batch in self.dataset: - im = self.preprocess(batch[1]) - self.features = self.model.image_encoder(im) - self.im = im - break - - def set_prompts(self, prompts): - """Set prompts in advance.""" - self.prompts = prompts - - def reset_image(self): - """Resets the image and its features to None.""" - self.im = None - self.features = None - - @staticmethod - def remove_small_regions(masks, min_area=0, nms_thresh=0.7): - """ - Perform post-processing on segmentation masks generated by the Segment Anything Model (SAM). Specifically, this - function removes small disconnected regions and holes from the input masks, and then performs Non-Maximum - Suppression (NMS) to eliminate any newly created duplicate boxes. - - Args: - masks (torch.Tensor): A tensor containing the masks to be processed. Shape should be (N, H, W), where N is - the number of masks, H is height, and W is width. - min_area (int): The minimum area below which disconnected regions and holes will be removed. Defaults to 0. - nms_thresh (float): The IoU threshold for the NMS algorithm. Defaults to 0.7. - - Returns: - (tuple([torch.Tensor, List[int]])): - - new_masks (torch.Tensor): The processed masks with small regions removed. Shape is (N, H, W). - - keep (List[int]): The indices of the remaining masks post-NMS, which can be used to filter the boxes. - """ - if len(masks) == 0: - return masks - - # Filter small disconnected regions and holes - new_masks = [] - scores = [] - for mask in masks: - mask = mask.cpu().numpy().astype(np.uint8) - mask, changed = remove_small_regions(mask, min_area, mode="holes") - unchanged = not changed - mask, changed = remove_small_regions(mask, min_area, mode="islands") - unchanged = unchanged and not changed - - new_masks.append(torch.as_tensor(mask).unsqueeze(0)) - # Give score=0 to changed masks and 1 to unchanged masks so NMS prefers masks not needing postprocessing - scores.append(float(unchanged)) - - # Recalculate boxes and remove any new duplicates - new_masks = torch.cat(new_masks, dim=0) - boxes = batched_mask_to_box(new_masks) - keep = torchvision.ops.nms(boxes.float(), torch.as_tensor(scores), nms_thresh) - - return new_masks[keep].to(device=masks.device, dtype=masks.dtype), keep diff --git a/ultralytics-main/ultralytics/models/utils/__init__.py b/ultralytics-main/ultralytics/models/utils/__init__.py deleted file mode 100644 index 9e68dc1..0000000 --- a/ultralytics-main/ultralytics/models/utils/__init__.py +++ /dev/null @@ -1 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license diff --git a/ultralytics-main/ultralytics/models/utils/loss.py b/ultralytics-main/ultralytics/models/utils/loss.py deleted file mode 100644 index ac48775..0000000 --- a/ultralytics-main/ultralytics/models/utils/loss.py +++ /dev/null @@ -1,345 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import torch -import torch.nn as nn -import torch.nn.functional as F - -from ultralytics.utils.loss import FocalLoss, VarifocalLoss -from ultralytics.utils.metrics import bbox_iou -from .ops import HungarianMatcher - - -class DETRLoss(nn.Module): - """ - DETR (DEtection TRansformer) Loss class. This class calculates and returns the different loss components for the - DETR object detection model. It computes classification loss, bounding box loss, GIoU loss, and optionally auxiliary - losses. - - Attributes: - nc (int): The number of classes. - loss_gain (dict): Coefficients for different loss components. - aux_loss (bool): Whether to compute auxiliary losses. - use_fl (bool): Use FocalLoss or not. - use_vfl (bool): Use VarifocalLoss or not. - use_uni_match (bool): Whether to use a fixed layer to assign labels for the auxiliary branch. - uni_match_ind (int): The fixed indices of a layer to use if `use_uni_match` is True. - matcher (HungarianMatcher): Object to compute matching cost and indices. - fl (FocalLoss or None): Focal Loss object if `use_fl` is True, otherwise None. - vfl (VarifocalLoss or None): Varifocal Loss object if `use_vfl` is True, otherwise None. - device (torch.device): Device on which tensors are stored. - """ - - def __init__( - self, nc=80, loss_gain=None, aux_loss=True, use_fl=True, use_vfl=False, use_uni_match=False, uni_match_ind=0 - ): - """ - DETR loss function. - - Args: - nc (int): The number of classes. - loss_gain (dict): The coefficient of loss. - aux_loss (bool): If 'aux_loss = True', loss at each decoder layer are to be used. - use_vfl (bool): Use VarifocalLoss or not. - use_uni_match (bool): Whether to use a fixed layer to assign labels for auxiliary branch. - uni_match_ind (int): The fixed indices of a layer. - """ - super().__init__() - - if loss_gain is None: - loss_gain = {"class": 1, "bbox": 5, "giou": 2, "no_object": 0.1, "mask": 1, "dice": 1} - self.nc = nc - self.matcher = HungarianMatcher(cost_gain={"class": 2, "bbox": 5, "giou": 2}) - self.loss_gain = loss_gain - self.aux_loss = aux_loss - self.fl = FocalLoss() if use_fl else None - self.vfl = VarifocalLoss() if use_vfl else None - - self.use_uni_match = use_uni_match - self.uni_match_ind = uni_match_ind - self.device = None - - def _get_loss_class(self, pred_scores, targets, gt_scores, num_gts, postfix=""): - """Computes the classification loss based on predictions, target values, and ground truth scores.""" - # Logits: [b, query, num_classes], gt_class: list[[n, 1]] - name_class = f"loss_class{postfix}" - bs, nq = pred_scores.shape[:2] - # one_hot = F.one_hot(targets, self.nc + 1)[..., :-1] # (bs, num_queries, num_classes) - one_hot = torch.zeros((bs, nq, self.nc + 1), dtype=torch.int64, device=targets.device) - one_hot.scatter_(2, targets.unsqueeze(-1), 1) - one_hot = one_hot[..., :-1] - gt_scores = gt_scores.view(bs, nq, 1) * one_hot - - if self.fl: - if num_gts and self.vfl: - loss_cls = self.vfl(pred_scores, gt_scores, one_hot) - else: - loss_cls = self.fl(pred_scores, one_hot.float()) - loss_cls /= max(num_gts, 1) / nq - else: - loss_cls = nn.BCEWithLogitsLoss(reduction="none")(pred_scores, gt_scores).mean(1).sum() # YOLO CLS loss - - return {name_class: loss_cls.squeeze() * self.loss_gain["class"]} - - def _get_loss_bbox(self, pred_bboxes, gt_bboxes, postfix=""): - """Calculates and returns the bounding box loss and GIoU loss for the predicted and ground truth bounding - boxes. - """ - # Boxes: [b, query, 4], gt_bbox: list[[n, 4]] - name_bbox = f"loss_bbox{postfix}" - name_giou = f"loss_giou{postfix}" - - loss = {} - if len(gt_bboxes) == 0: - loss[name_bbox] = torch.tensor(0.0, device=self.device) - loss[name_giou] = torch.tensor(0.0, device=self.device) - return loss - - loss[name_bbox] = self.loss_gain["bbox"] * F.l1_loss(pred_bboxes, gt_bboxes, reduction="sum") / len(gt_bboxes) - loss[name_giou] = 1.0 - bbox_iou(pred_bboxes, gt_bboxes, xywh=True, GIoU=True) - loss[name_giou] = loss[name_giou].sum() / len(gt_bboxes) - loss[name_giou] = self.loss_gain["giou"] * loss[name_giou] - return {k: v.squeeze() for k, v in loss.items()} - - # This function is for future RT-DETR Segment models - # def _get_loss_mask(self, masks, gt_mask, match_indices, postfix=''): - # # masks: [b, query, h, w], gt_mask: list[[n, H, W]] - # name_mask = f'loss_mask{postfix}' - # name_dice = f'loss_dice{postfix}' - # - # loss = {} - # if sum(len(a) for a in gt_mask) == 0: - # loss[name_mask] = torch.tensor(0., device=self.device) - # loss[name_dice] = torch.tensor(0., device=self.device) - # return loss - # - # num_gts = len(gt_mask) - # src_masks, target_masks = self._get_assigned_bboxes(masks, gt_mask, match_indices) - # src_masks = F.interpolate(src_masks.unsqueeze(0), size=target_masks.shape[-2:], mode='bilinear')[0] - # # TODO: torch does not have `sigmoid_focal_loss`, but it's not urgent since we don't use mask branch for now. - # loss[name_mask] = self.loss_gain['mask'] * F.sigmoid_focal_loss(src_masks, target_masks, - # torch.tensor([num_gts], dtype=torch.float32)) - # loss[name_dice] = self.loss_gain['dice'] * self._dice_loss(src_masks, target_masks, num_gts) - # return loss - - # This function is for future RT-DETR Segment models - # @staticmethod - # def _dice_loss(inputs, targets, num_gts): - # inputs = F.sigmoid(inputs).flatten(1) - # targets = targets.flatten(1) - # numerator = 2 * (inputs * targets).sum(1) - # denominator = inputs.sum(-1) + targets.sum(-1) - # loss = 1 - (numerator + 1) / (denominator + 1) - # return loss.sum() / num_gts - - def _get_loss_aux( - self, - pred_bboxes, - pred_scores, - gt_bboxes, - gt_cls, - gt_groups, - match_indices=None, - postfix="", - masks=None, - gt_mask=None, - ): - """Get auxiliary losses.""" - # NOTE: loss class, bbox, giou, mask, dice - loss = torch.zeros(5 if masks is not None else 3, device=pred_bboxes.device) - if match_indices is None and self.use_uni_match: - match_indices = self.matcher( - pred_bboxes[self.uni_match_ind], - pred_scores[self.uni_match_ind], - gt_bboxes, - gt_cls, - gt_groups, - masks=masks[self.uni_match_ind] if masks is not None else None, - gt_mask=gt_mask, - ) - for i, (aux_bboxes, aux_scores) in enumerate(zip(pred_bboxes, pred_scores)): - aux_masks = masks[i] if masks is not None else None - loss_ = self._get_loss( - aux_bboxes, - aux_scores, - gt_bboxes, - gt_cls, - gt_groups, - masks=aux_masks, - gt_mask=gt_mask, - postfix=postfix, - match_indices=match_indices, - ) - loss[0] += loss_[f"loss_class{postfix}"] - loss[1] += loss_[f"loss_bbox{postfix}"] - loss[2] += loss_[f"loss_giou{postfix}"] - # if masks is not None and gt_mask is not None: - # loss_ = self._get_loss_mask(aux_masks, gt_mask, match_indices, postfix) - # loss[3] += loss_[f'loss_mask{postfix}'] - # loss[4] += loss_[f'loss_dice{postfix}'] - - loss = { - f"loss_class_aux{postfix}": loss[0], - f"loss_bbox_aux{postfix}": loss[1], - f"loss_giou_aux{postfix}": loss[2], - } - # if masks is not None and gt_mask is not None: - # loss[f'loss_mask_aux{postfix}'] = loss[3] - # loss[f'loss_dice_aux{postfix}'] = loss[4] - return loss - - @staticmethod - def _get_index(match_indices): - """Returns batch indices, source indices, and destination indices from provided match indices.""" - batch_idx = torch.cat([torch.full_like(src, i) for i, (src, _) in enumerate(match_indices)]) - src_idx = torch.cat([src for (src, _) in match_indices]) - dst_idx = torch.cat([dst for (_, dst) in match_indices]) - return (batch_idx, src_idx), dst_idx - - def _get_assigned_bboxes(self, pred_bboxes, gt_bboxes, match_indices): - """Assigns predicted bounding boxes to ground truth bounding boxes based on the match indices.""" - pred_assigned = torch.cat( - [ - t[i] if len(i) > 0 else torch.zeros(0, t.shape[-1], device=self.device) - for t, (i, _) in zip(pred_bboxes, match_indices) - ] - ) - gt_assigned = torch.cat( - [ - t[j] if len(j) > 0 else torch.zeros(0, t.shape[-1], device=self.device) - for t, (_, j) in zip(gt_bboxes, match_indices) - ] - ) - return pred_assigned, gt_assigned - - def _get_loss( - self, - pred_bboxes, - pred_scores, - gt_bboxes, - gt_cls, - gt_groups, - masks=None, - gt_mask=None, - postfix="", - match_indices=None, - ): - """Get losses.""" - if match_indices is None: - match_indices = self.matcher( - pred_bboxes, pred_scores, gt_bboxes, gt_cls, gt_groups, masks=masks, gt_mask=gt_mask - ) - - idx, gt_idx = self._get_index(match_indices) - pred_bboxes, gt_bboxes = pred_bboxes[idx], gt_bboxes[gt_idx] - - bs, nq = pred_scores.shape[:2] - targets = torch.full((bs, nq), self.nc, device=pred_scores.device, dtype=gt_cls.dtype) - targets[idx] = gt_cls[gt_idx] - - gt_scores = torch.zeros([bs, nq], device=pred_scores.device) - if len(gt_bboxes): - gt_scores[idx] = bbox_iou(pred_bboxes.detach(), gt_bboxes, xywh=True).squeeze(-1) - - loss = {} - loss.update(self._get_loss_class(pred_scores, targets, gt_scores, len(gt_bboxes), postfix)) - loss.update(self._get_loss_bbox(pred_bboxes, gt_bboxes, postfix)) - # if masks is not None and gt_mask is not None: - # loss.update(self._get_loss_mask(masks, gt_mask, match_indices, postfix)) - return loss - - def forward(self, pred_bboxes, pred_scores, batch, postfix="", **kwargs): - """ - Args: - pred_bboxes (torch.Tensor): [l, b, query, 4] - pred_scores (torch.Tensor): [l, b, query, num_classes] - batch (dict): A dict includes: - gt_cls (torch.Tensor) with shape [num_gts, ], - gt_bboxes (torch.Tensor): [num_gts, 4], - gt_groups (List(int)): a list of batch size length includes the number of gts of each image. - postfix (str): postfix of loss name. - """ - self.device = pred_bboxes.device - match_indices = kwargs.get("match_indices", None) - gt_cls, gt_bboxes, gt_groups = batch["cls"], batch["bboxes"], batch["gt_groups"] - - total_loss = self._get_loss( - pred_bboxes[-1], pred_scores[-1], gt_bboxes, gt_cls, gt_groups, postfix=postfix, match_indices=match_indices - ) - - if self.aux_loss: - total_loss.update( - self._get_loss_aux( - pred_bboxes[:-1], pred_scores[:-1], gt_bboxes, gt_cls, gt_groups, match_indices, postfix - ) - ) - - return total_loss - - -class RTDETRDetectionLoss(DETRLoss): - """ - Real-Time DeepTracker (RT-DETR) Detection Loss class that extends the DETRLoss. - - This class computes the detection loss for the RT-DETR model, which includes the standard detection loss as well as - an additional denoising training loss when provided with denoising metadata. - """ - - def forward(self, preds, batch, dn_bboxes=None, dn_scores=None, dn_meta=None): - """ - Forward pass to compute the detection loss. - - Args: - preds (tuple): Predicted bounding boxes and scores. - batch (dict): Batch data containing ground truth information. - dn_bboxes (torch.Tensor, optional): Denoising bounding boxes. Default is None. - dn_scores (torch.Tensor, optional): Denoising scores. Default is None. - dn_meta (dict, optional): Metadata for denoising. Default is None. - - Returns: - (dict): Dictionary containing the total loss and, if applicable, the denoising loss. - """ - pred_bboxes, pred_scores = preds - total_loss = super().forward(pred_bboxes, pred_scores, batch) - - # Check for denoising metadata to compute denoising training loss - if dn_meta is not None: - dn_pos_idx, dn_num_group = dn_meta["dn_pos_idx"], dn_meta["dn_num_group"] - assert len(batch["gt_groups"]) == len(dn_pos_idx) - - # Get the match indices for denoising - match_indices = self.get_dn_match_indices(dn_pos_idx, dn_num_group, batch["gt_groups"]) - - # Compute the denoising training loss - dn_loss = super().forward(dn_bboxes, dn_scores, batch, postfix="_dn", match_indices=match_indices) - total_loss.update(dn_loss) - else: - # If no denoising metadata is provided, set denoising loss to zero - total_loss.update({f"{k}_dn": torch.tensor(0.0, device=self.device) for k in total_loss.keys()}) - - return total_loss - - @staticmethod - def get_dn_match_indices(dn_pos_idx, dn_num_group, gt_groups): - """ - Get the match indices for denoising. - - Args: - dn_pos_idx (List[torch.Tensor]): List of tensors containing positive indices for denoising. - dn_num_group (int): Number of denoising groups. - gt_groups (List[int]): List of integers representing the number of ground truths for each image. - - Returns: - (List[tuple]): List of tuples containing matched indices for denoising. - """ - dn_match_indices = [] - idx_groups = torch.as_tensor([0, *gt_groups[:-1]]).cumsum_(0) - for i, num_gt in enumerate(gt_groups): - if num_gt > 0: - gt_idx = torch.arange(end=num_gt, dtype=torch.long) + idx_groups[i] - gt_idx = gt_idx.repeat(dn_num_group) - assert len(dn_pos_idx[i]) == len(gt_idx), "Expected the same length, " - f"but got {len(dn_pos_idx[i])} and {len(gt_idx)} respectively." - dn_match_indices.append((dn_pos_idx[i], gt_idx)) - else: - dn_match_indices.append((torch.zeros([0], dtype=torch.long), torch.zeros([0], dtype=torch.long))) - return dn_match_indices diff --git a/ultralytics-main/ultralytics/models/utils/ops.py b/ultralytics-main/ultralytics/models/utils/ops.py deleted file mode 100644 index 4f66fee..0000000 --- a/ultralytics-main/ultralytics/models/utils/ops.py +++ /dev/null @@ -1,263 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import torch -import torch.nn as nn -import torch.nn.functional as F -from scipy.optimize import linear_sum_assignment - -from ultralytics.utils.metrics import bbox_iou -from ultralytics.utils.ops import xywh2xyxy, xyxy2xywh - - -class HungarianMatcher(nn.Module): - """ - A module implementing the HungarianMatcher, which is a differentiable module to solve the assignment problem in an - end-to-end fashion. - - HungarianMatcher performs optimal assignment over the predicted and ground truth bounding boxes using a cost - function that considers classification scores, bounding box coordinates, and optionally, mask predictions. - - Attributes: - cost_gain (dict): Dictionary of cost coefficients: 'class', 'bbox', 'giou', 'mask', and 'dice'. - use_fl (bool): Indicates whether to use Focal Loss for the classification cost calculation. - with_mask (bool): Indicates whether the model makes mask predictions. - num_sample_points (int): The number of sample points used in mask cost calculation. - alpha (float): The alpha factor in Focal Loss calculation. - gamma (float): The gamma factor in Focal Loss calculation. - - Methods: - forward(pred_bboxes, pred_scores, gt_bboxes, gt_cls, gt_groups, masks=None, gt_mask=None): Computes the - assignment between predictions and ground truths for a batch. - _cost_mask(bs, num_gts, masks=None, gt_mask=None): Computes the mask cost and dice cost if masks are predicted. - """ - - def __init__(self, cost_gain=None, use_fl=True, with_mask=False, num_sample_points=12544, alpha=0.25, gamma=2.0): - """Initializes HungarianMatcher with cost coefficients, Focal Loss, mask prediction, sample points, and alpha - gamma factors. - """ - super().__init__() - if cost_gain is None: - cost_gain = {"class": 1, "bbox": 5, "giou": 2, "mask": 1, "dice": 1} - self.cost_gain = cost_gain - self.use_fl = use_fl - self.with_mask = with_mask - self.num_sample_points = num_sample_points - self.alpha = alpha - self.gamma = gamma - - def forward(self, pred_bboxes, pred_scores, gt_bboxes, gt_cls, gt_groups, masks=None, gt_mask=None): - """ - Forward pass for HungarianMatcher. This function computes costs based on prediction and ground truth - (classification cost, L1 cost between boxes and GIoU cost between boxes) and finds the optimal matching between - predictions and ground truth based on these costs. - - Args: - pred_bboxes (Tensor): Predicted bounding boxes with shape [batch_size, num_queries, 4]. - pred_scores (Tensor): Predicted scores with shape [batch_size, num_queries, num_classes]. - gt_cls (torch.Tensor): Ground truth classes with shape [num_gts, ]. - gt_bboxes (torch.Tensor): Ground truth bounding boxes with shape [num_gts, 4]. - gt_groups (List[int]): List of length equal to batch size, containing the number of ground truths for - each image. - masks (Tensor, optional): Predicted masks with shape [batch_size, num_queries, height, width]. - Defaults to None. - gt_mask (List[Tensor], optional): List of ground truth masks, each with shape [num_masks, Height, Width]. - Defaults to None. - - Returns: - (List[Tuple[Tensor, Tensor]]): A list of size batch_size, each element is a tuple (index_i, index_j), where: - - index_i is the tensor of indices of the selected predictions (in order) - - index_j is the tensor of indices of the corresponding selected ground truth targets (in order) - For each batch element, it holds: - len(index_i) = len(index_j) = min(num_queries, num_target_boxes) - """ - - bs, nq, nc = pred_scores.shape - - if sum(gt_groups) == 0: - return [(torch.tensor([], dtype=torch.long), torch.tensor([], dtype=torch.long)) for _ in range(bs)] - - # We flatten to compute the cost matrices in a batch - # [batch_size * num_queries, num_classes] - pred_scores = pred_scores.detach().view(-1, nc) - pred_scores = F.sigmoid(pred_scores) if self.use_fl else F.softmax(pred_scores, dim=-1) - # [batch_size * num_queries, 4] - pred_bboxes = pred_bboxes.detach().view(-1, 4) - - # Compute the classification cost - pred_scores = pred_scores[:, gt_cls] - if self.use_fl: - neg_cost_class = (1 - self.alpha) * (pred_scores**self.gamma) * (-(1 - pred_scores + 1e-8).log()) - pos_cost_class = self.alpha * ((1 - pred_scores) ** self.gamma) * (-(pred_scores + 1e-8).log()) - cost_class = pos_cost_class - neg_cost_class - else: - cost_class = -pred_scores - - # Compute the L1 cost between boxes - cost_bbox = (pred_bboxes.unsqueeze(1) - gt_bboxes.unsqueeze(0)).abs().sum(-1) # (bs*num_queries, num_gt) - - # Compute the GIoU cost between boxes, (bs*num_queries, num_gt) - cost_giou = 1.0 - bbox_iou(pred_bboxes.unsqueeze(1), gt_bboxes.unsqueeze(0), xywh=True, GIoU=True).squeeze(-1) - - # Final cost matrix - C = ( - self.cost_gain["class"] * cost_class - + self.cost_gain["bbox"] * cost_bbox - + self.cost_gain["giou"] * cost_giou - ) - # Compute the mask cost and dice cost - if self.with_mask: - C += self._cost_mask(bs, gt_groups, masks, gt_mask) - - # Set invalid values (NaNs and infinities) to 0 (fixes ValueError: matrix contains invalid numeric entries) - C[C.isnan() | C.isinf()] = 0.0 - - C = C.view(bs, nq, -1).cpu() - indices = [linear_sum_assignment(c[i]) for i, c in enumerate(C.split(gt_groups, -1))] - gt_groups = torch.as_tensor([0, *gt_groups[:-1]]).cumsum_(0) # (idx for queries, idx for gt) - return [ - (torch.tensor(i, dtype=torch.long), torch.tensor(j, dtype=torch.long) + gt_groups[k]) - for k, (i, j) in enumerate(indices) - ] - - # This function is for future RT-DETR Segment models - # def _cost_mask(self, bs, num_gts, masks=None, gt_mask=None): - # assert masks is not None and gt_mask is not None, 'Make sure the input has `mask` and `gt_mask`' - # # all masks share the same set of points for efficient matching - # sample_points = torch.rand([bs, 1, self.num_sample_points, 2]) - # sample_points = 2.0 * sample_points - 1.0 - # - # out_mask = F.grid_sample(masks.detach(), sample_points, align_corners=False).squeeze(-2) - # out_mask = out_mask.flatten(0, 1) - # - # tgt_mask = torch.cat(gt_mask).unsqueeze(1) - # sample_points = torch.cat([a.repeat(b, 1, 1, 1) for a, b in zip(sample_points, num_gts) if b > 0]) - # tgt_mask = F.grid_sample(tgt_mask, sample_points, align_corners=False).squeeze([1, 2]) - # - # with torch.cuda.amp.autocast(False): - # # binary cross entropy cost - # pos_cost_mask = F.binary_cross_entropy_with_logits(out_mask, torch.ones_like(out_mask), reduction='none') - # neg_cost_mask = F.binary_cross_entropy_with_logits(out_mask, torch.zeros_like(out_mask), reduction='none') - # cost_mask = torch.matmul(pos_cost_mask, tgt_mask.T) + torch.matmul(neg_cost_mask, 1 - tgt_mask.T) - # cost_mask /= self.num_sample_points - # - # # dice cost - # out_mask = F.sigmoid(out_mask) - # numerator = 2 * torch.matmul(out_mask, tgt_mask.T) - # denominator = out_mask.sum(-1, keepdim=True) + tgt_mask.sum(-1).unsqueeze(0) - # cost_dice = 1 - (numerator + 1) / (denominator + 1) - # - # C = self.cost_gain['mask'] * cost_mask + self.cost_gain['dice'] * cost_dice - # return C - - -def get_cdn_group( - batch, num_classes, num_queries, class_embed, num_dn=100, cls_noise_ratio=0.5, box_noise_scale=1.0, training=False -): - """ - Get contrastive denoising training group. This function creates a contrastive denoising training group with positive - and negative samples from the ground truths (gt). It applies noise to the class labels and bounding box coordinates, - and returns the modified labels, bounding boxes, attention mask and meta information. - - Args: - batch (dict): A dict that includes 'gt_cls' (torch.Tensor with shape [num_gts, ]), 'gt_bboxes' - (torch.Tensor with shape [num_gts, 4]), 'gt_groups' (List(int)) which is a list of batch size length - indicating the number of gts of each image. - num_classes (int): Number of classes. - num_queries (int): Number of queries. - class_embed (torch.Tensor): Embedding weights to map class labels to embedding space. - num_dn (int, optional): Number of denoising. Defaults to 100. - cls_noise_ratio (float, optional): Noise ratio for class labels. Defaults to 0.5. - box_noise_scale (float, optional): Noise scale for bounding box coordinates. Defaults to 1.0. - training (bool, optional): If it's in training mode. Defaults to False. - - Returns: - (Tuple[Optional[Tensor], Optional[Tensor], Optional[Tensor], Optional[Dict]]): The modified class embeddings, - bounding boxes, attention mask and meta information for denoising. If not in training mode or 'num_dn' - is less than or equal to 0, the function returns None for all elements in the tuple. - """ - - if (not training) or num_dn <= 0: - return None, None, None, None - gt_groups = batch["gt_groups"] - total_num = sum(gt_groups) - max_nums = max(gt_groups) - if max_nums == 0: - return None, None, None, None - - num_group = num_dn // max_nums - num_group = 1 if num_group == 0 else num_group - # Pad gt to max_num of a batch - bs = len(gt_groups) - gt_cls = batch["cls"] # (bs*num, ) - gt_bbox = batch["bboxes"] # bs*num, 4 - b_idx = batch["batch_idx"] - - # Each group has positive and negative queries. - dn_cls = gt_cls.repeat(2 * num_group) # (2*num_group*bs*num, ) - dn_bbox = gt_bbox.repeat(2 * num_group, 1) # 2*num_group*bs*num, 4 - dn_b_idx = b_idx.repeat(2 * num_group).view(-1) # (2*num_group*bs*num, ) - - # Positive and negative mask - # (bs*num*num_group, ), the second total_num*num_group part as negative samples - neg_idx = torch.arange(total_num * num_group, dtype=torch.long, device=gt_bbox.device) + num_group * total_num - - if cls_noise_ratio > 0: - # Half of bbox prob - mask = torch.rand(dn_cls.shape) < (cls_noise_ratio * 0.5) - idx = torch.nonzero(mask).squeeze(-1) - # Randomly put a new one here - new_label = torch.randint_like(idx, 0, num_classes, dtype=dn_cls.dtype, device=dn_cls.device) - dn_cls[idx] = new_label - - if box_noise_scale > 0: - known_bbox = xywh2xyxy(dn_bbox) - - diff = (dn_bbox[..., 2:] * 0.5).repeat(1, 2) * box_noise_scale # 2*num_group*bs*num, 4 - - rand_sign = torch.randint_like(dn_bbox, 0, 2) * 2.0 - 1.0 - rand_part = torch.rand_like(dn_bbox) - rand_part[neg_idx] += 1.0 - rand_part *= rand_sign - known_bbox += rand_part * diff - known_bbox.clip_(min=0.0, max=1.0) - dn_bbox = xyxy2xywh(known_bbox) - dn_bbox = torch.logit(dn_bbox, eps=1e-6) # inverse sigmoid - - num_dn = int(max_nums * 2 * num_group) # total denoising queries - # class_embed = torch.cat([class_embed, torch.zeros([1, class_embed.shape[-1]], device=class_embed.device)]) - dn_cls_embed = class_embed[dn_cls] # bs*num * 2 * num_group, 256 - padding_cls = torch.zeros(bs, num_dn, dn_cls_embed.shape[-1], device=gt_cls.device) - padding_bbox = torch.zeros(bs, num_dn, 4, device=gt_bbox.device) - - map_indices = torch.cat([torch.tensor(range(num), dtype=torch.long) for num in gt_groups]) - pos_idx = torch.stack([map_indices + max_nums * i for i in range(num_group)], dim=0) - - map_indices = torch.cat([map_indices + max_nums * i for i in range(2 * num_group)]) - padding_cls[(dn_b_idx, map_indices)] = dn_cls_embed - padding_bbox[(dn_b_idx, map_indices)] = dn_bbox - - tgt_size = num_dn + num_queries - attn_mask = torch.zeros([tgt_size, tgt_size], dtype=torch.bool) - # Match query cannot see the reconstruct - attn_mask[num_dn:, :num_dn] = True - # Reconstruct cannot see each other - for i in range(num_group): - if i == 0: - attn_mask[max_nums * 2 * i : max_nums * 2 * (i + 1), max_nums * 2 * (i + 1) : num_dn] = True - if i == num_group - 1: - attn_mask[max_nums * 2 * i : max_nums * 2 * (i + 1), : max_nums * i * 2] = True - else: - attn_mask[max_nums * 2 * i : max_nums * 2 * (i + 1), max_nums * 2 * (i + 1) : num_dn] = True - attn_mask[max_nums * 2 * i : max_nums * 2 * (i + 1), : max_nums * 2 * i] = True - dn_meta = { - "dn_pos_idx": [p.reshape(-1) for p in pos_idx.cpu().split(list(gt_groups), dim=1)], - "dn_num_group": num_group, - "dn_num_split": [num_dn, num_queries], - } - - return ( - padding_cls.to(class_embed.device), - padding_bbox.to(class_embed.device), - attn_mask.to(class_embed.device), - dn_meta, - ) diff --git a/ultralytics-main/ultralytics/models/yolo/__init__.py b/ultralytics-main/ultralytics/models/yolo/__init__.py deleted file mode 100644 index 7b1a597..0000000 --- a/ultralytics-main/ultralytics/models/yolo/__init__.py +++ /dev/null @@ -1,7 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from ultralytics.models.yolo import classify, detect, obb, pose, segment - -from .model import YOLO, YOLOWorld - -__all__ = "classify", "segment", "detect", "pose", "obb", "YOLO", "YOLOWorld" diff --git a/ultralytics-main/ultralytics/models/yolo/classify/__init__.py b/ultralytics-main/ultralytics/models/yolo/classify/__init__.py deleted file mode 100644 index ca92f89..0000000 --- a/ultralytics-main/ultralytics/models/yolo/classify/__init__.py +++ /dev/null @@ -1,7 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from ultralytics.models.yolo.classify.predict import ClassificationPredictor -from ultralytics.models.yolo.classify.train import ClassificationTrainer -from ultralytics.models.yolo.classify.val import ClassificationValidator - -__all__ = "ClassificationPredictor", "ClassificationTrainer", "ClassificationValidator" diff --git a/ultralytics-main/ultralytics/models/yolo/classify/predict.py b/ultralytics-main/ultralytics/models/yolo/classify/predict.py deleted file mode 100644 index 853ef04..0000000 --- a/ultralytics-main/ultralytics/models/yolo/classify/predict.py +++ /dev/null @@ -1,61 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import cv2 -import torch -from PIL import Image - -from ultralytics.engine.predictor import BasePredictor -from ultralytics.engine.results import Results -from ultralytics.utils import DEFAULT_CFG, ops - - -class ClassificationPredictor(BasePredictor): - """ - A class extending the BasePredictor class for prediction based on a classification model. - - Notes: - - Torchvision classification models can also be passed to the 'model' argument, i.e. model='resnet18'. - - Example: - ```python - from ultralytics.utils import ASSETS - from ultralytics.models.yolo.classify import ClassificationPredictor - - args = dict(model='yolov8n-cls.pt', source=ASSETS) - predictor = ClassificationPredictor(overrides=args) - predictor.predict_cli() - ``` - """ - - def __init__(self, cfg=DEFAULT_CFG, overrides=None, _callbacks=None): - """Initializes ClassificationPredictor setting the task to 'classify'.""" - super().__init__(cfg, overrides, _callbacks) - self.args.task = "classify" - self._legacy_transform_name = "ultralytics.yolo.data.augment.ToTensor" - - def preprocess(self, img): - """Converts input image to model-compatible data type.""" - if not isinstance(img, torch.Tensor): - is_legacy_transform = any( - self._legacy_transform_name in str(transform) for transform in self.transforms.transforms - ) - if is_legacy_transform: # to handle legacy transforms - img = torch.stack([self.transforms(im) for im in img], dim=0) - else: - img = torch.stack( - [self.transforms(Image.fromarray(cv2.cvtColor(im, cv2.COLOR_BGR2RGB))) for im in img], dim=0 - ) - img = (img if isinstance(img, torch.Tensor) else torch.from_numpy(img)).to(self.model.device) - return img.half() if self.model.fp16 else img.float() # uint8 to fp16/32 - - def postprocess(self, preds, img, orig_imgs): - """Post-processes predictions to return Results objects.""" - if not isinstance(orig_imgs, list): # input images are a torch.Tensor, not a list - orig_imgs = ops.convert_torch2numpy_batch(orig_imgs) - - results = [] - for i, pred in enumerate(preds): - orig_img = orig_imgs[i] - img_path = self.batch[0][i] - results.append(Results(orig_img, path=img_path, names=self.model.names, probs=pred)) - return results diff --git a/ultralytics-main/ultralytics/models/yolo/classify/train.py b/ultralytics-main/ultralytics/models/yolo/classify/train.py deleted file mode 100644 index a7bbe77..0000000 --- a/ultralytics-main/ultralytics/models/yolo/classify/train.py +++ /dev/null @@ -1,158 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import torch -import torchvision - -from ultralytics.data import ClassificationDataset, build_dataloader -from ultralytics.engine.trainer import BaseTrainer -from ultralytics.models import yolo -from ultralytics.nn.tasks import ClassificationModel, attempt_load_one_weight -from ultralytics.utils import DEFAULT_CFG, LOGGER, RANK, colorstr -from ultralytics.utils.plotting import plot_images, plot_results -from ultralytics.utils.torch_utils import is_parallel, strip_optimizer, torch_distributed_zero_first - - -class ClassificationTrainer(BaseTrainer): - """ - A class extending the BaseTrainer class for training based on a classification model. - - Notes: - - Torchvision classification models can also be passed to the 'model' argument, i.e. model='resnet18'. - - Example: - ```python - from ultralytics.models.yolo.classify import ClassificationTrainer - - args = dict(model='yolov8n-cls.pt', data='imagenet10', epochs=3) - trainer = ClassificationTrainer(overrides=args) - trainer.train() - ``` - """ - - def __init__(self, cfg=DEFAULT_CFG, overrides=None, _callbacks=None): - """Initialize a ClassificationTrainer object with optional configuration overrides and callbacks.""" - if overrides is None: - overrides = {} - overrides["task"] = "classify" - if overrides.get("imgsz") is None: - overrides["imgsz"] = 224 - super().__init__(cfg, overrides, _callbacks) - - def set_model_attributes(self): - """Set the YOLO model's class names from the loaded dataset.""" - self.model.names = self.data["names"] - - def get_model(self, cfg=None, weights=None, verbose=True): - """Returns a modified PyTorch model configured for training YOLO.""" - model = ClassificationModel(cfg, nc=self.data["nc"], verbose=verbose and RANK == -1) - if weights: - model.load(weights) - - for m in model.modules(): - if not self.args.pretrained and hasattr(m, "reset_parameters"): - m.reset_parameters() - if isinstance(m, torch.nn.Dropout) and self.args.dropout: - m.p = self.args.dropout # set dropout - for p in model.parameters(): - p.requires_grad = True # for training - return model - - def setup_model(self): - """Load, create or download model for any task.""" - if isinstance(self.model, torch.nn.Module): # if model is loaded beforehand. No setup needed - return - - model, ckpt = str(self.model), None - # Load a YOLO model locally, from torchvision, or from Ultralytics assets - if model.endswith(".pt"): - self.model, ckpt = attempt_load_one_weight(model, device="cpu") - for p in self.model.parameters(): - p.requires_grad = True # for training - elif model.split(".")[-1] in ("yaml", "yml"): - self.model = self.get_model(cfg=model) - elif model in torchvision.models.__dict__: - self.model = torchvision.models.__dict__[model](weights="IMAGENET1K_V1" if self.args.pretrained else None) - else: - FileNotFoundError(f"ERROR: model={model} not found locally or online. Please check model name.") - ClassificationModel.reshape_outputs(self.model, self.data["nc"]) - - return ckpt - - def build_dataset(self, img_path, mode="train", batch=None): - """Creates a ClassificationDataset instance given an image path, and mode (train/test etc.).""" - return ClassificationDataset(root=img_path, args=self.args, augment=mode == "train", prefix=mode) - - def get_dataloader(self, dataset_path, batch_size=16, rank=0, mode="train"): - """Returns PyTorch DataLoader with transforms to preprocess images for inference.""" - with torch_distributed_zero_first(rank): # init dataset *.cache only once if DDP - dataset = self.build_dataset(dataset_path, mode) - - loader = build_dataloader(dataset, batch_size, self.args.workers, rank=rank) - # Attach inference transforms - if mode != "train": - if is_parallel(self.model): - self.model.module.transforms = loader.dataset.torch_transforms - else: - self.model.transforms = loader.dataset.torch_transforms - return loader - - def preprocess_batch(self, batch): - """Preprocesses a batch of images and classes.""" - batch["img"] = batch["img"].to(self.device) - batch["cls"] = batch["cls"].to(self.device) - return batch - - def progress_string(self): - """Returns a formatted string showing training progress.""" - return ("\n" + "%11s" * (4 + len(self.loss_names))) % ( - "Epoch", - "GPU_mem", - *self.loss_names, - "Instances", - "Size", - ) - - def get_validator(self): - """Returns an instance of ClassificationValidator for validation.""" - self.loss_names = ["loss"] - return yolo.classify.ClassificationValidator(self.test_loader, self.save_dir, _callbacks=self.callbacks) - - def label_loss_items(self, loss_items=None, prefix="train"): - """ - Returns a loss dict with labelled training loss items tensor. - - Not needed for classification but necessary for segmentation & detection - """ - keys = [f"{prefix}/{x}" for x in self.loss_names] - if loss_items is None: - return keys - loss_items = [round(float(loss_items), 5)] - return dict(zip(keys, loss_items)) - - def plot_metrics(self): - """Plots metrics from a CSV file.""" - plot_results(file=self.csv, classify=True, on_plot=self.on_plot) # save results.png - - def final_eval(self): - """Evaluate trained model and save validation results.""" - for f in self.last, self.best: - if f.exists(): - strip_optimizer(f) # strip optimizers - if f is self.best: - LOGGER.info(f"\nValidating {f}...") - self.validator.args.data = self.args.data - self.validator.args.plots = self.args.plots - self.metrics = self.validator(model=f) - self.metrics.pop("fitness", None) - self.run_callbacks("on_fit_epoch_end") - LOGGER.info(f"Results saved to {colorstr('bold', self.save_dir)}") - - def plot_training_samples(self, batch, ni): - """Plots training samples with their annotations.""" - plot_images( - images=batch["img"], - batch_idx=torch.arange(len(batch["img"])), - cls=batch["cls"].view(-1), # warning: use .view(), not .squeeze() for Classify models - fname=self.save_dir / f"train_batch{ni}.jpg", - on_plot=self.on_plot, - ) diff --git a/ultralytics-main/ultralytics/models/yolo/classify/val.py b/ultralytics-main/ultralytics/models/yolo/classify/val.py deleted file mode 100644 index de3cff2..0000000 --- a/ultralytics-main/ultralytics/models/yolo/classify/val.py +++ /dev/null @@ -1,113 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import torch - -from ultralytics.data import ClassificationDataset, build_dataloader -from ultralytics.engine.validator import BaseValidator -from ultralytics.utils import LOGGER -from ultralytics.utils.metrics import ClassifyMetrics, ConfusionMatrix -from ultralytics.utils.plotting import plot_images - - -class ClassificationValidator(BaseValidator): - """ - A class extending the BaseValidator class for validation based on a classification model. - - Notes: - - Torchvision classification models can also be passed to the 'model' argument, i.e. model='resnet18'. - - Example: - ```python - from ultralytics.models.yolo.classify import ClassificationValidator - - args = dict(model='yolov8n-cls.pt', data='imagenet10') - validator = ClassificationValidator(args=args) - validator() - ``` - """ - - def __init__(self, dataloader=None, save_dir=None, pbar=None, args=None, _callbacks=None): - """Initializes ClassificationValidator instance with args, dataloader, save_dir, and progress bar.""" - super().__init__(dataloader, save_dir, pbar, args, _callbacks) - self.targets = None - self.pred = None - self.args.task = "classify" - self.metrics = ClassifyMetrics() - - def get_desc(self): - """Returns a formatted string summarizing classification metrics.""" - return ("%22s" + "%11s" * 2) % ("classes", "top1_acc", "top5_acc") - - def init_metrics(self, model): - """Initialize confusion matrix, class names, and top-1 and top-5 accuracy.""" - self.names = model.names - self.nc = len(model.names) - self.confusion_matrix = ConfusionMatrix(nc=self.nc, conf=self.args.conf, task="classify") - self.pred = [] - self.targets = [] - - def preprocess(self, batch): - """Preprocesses input batch and returns it.""" - batch["img"] = batch["img"].to(self.device, non_blocking=True) - batch["img"] = batch["img"].half() if self.args.half else batch["img"].float() - batch["cls"] = batch["cls"].to(self.device) - return batch - - def update_metrics(self, preds, batch): - """Updates running metrics with model predictions and batch targets.""" - n5 = min(len(self.names), 5) - self.pred.append(preds.argsort(1, descending=True)[:, :n5]) - self.targets.append(batch["cls"]) - - def finalize_metrics(self, *args, **kwargs): - """Finalizes metrics of the model such as confusion_matrix and speed.""" - self.confusion_matrix.process_cls_preds(self.pred, self.targets) - if self.args.plots: - for normalize in True, False: - self.confusion_matrix.plot( - save_dir=self.save_dir, names=self.names.values(), normalize=normalize, on_plot=self.on_plot - ) - self.metrics.speed = self.speed - self.metrics.confusion_matrix = self.confusion_matrix - self.metrics.save_dir = self.save_dir - - def get_stats(self): - """Returns a dictionary of metrics obtained by processing targets and predictions.""" - self.metrics.process(self.targets, self.pred) - return self.metrics.results_dict - - def build_dataset(self, img_path): - """Creates and returns a ClassificationDataset instance using given image path and preprocessing parameters.""" - return ClassificationDataset(root=img_path, args=self.args, augment=False, prefix=self.args.split) - - def get_dataloader(self, dataset_path, batch_size): - """Builds and returns a data loader for classification tasks with given parameters.""" - dataset = self.build_dataset(dataset_path) - return build_dataloader(dataset, batch_size, self.args.workers, rank=-1) - - def print_results(self): - """Prints evaluation metrics for YOLO object detection model.""" - pf = "%22s" + "%11.3g" * len(self.metrics.keys) # print format - LOGGER.info(pf % ("all", self.metrics.top1, self.metrics.top5)) - - def plot_val_samples(self, batch, ni): - """Plot validation image samples.""" - plot_images( - images=batch["img"], - batch_idx=torch.arange(len(batch["img"])), - cls=batch["cls"].view(-1), # warning: use .view(), not .squeeze() for Classify models - fname=self.save_dir / f"val_batch{ni}_labels.jpg", - names=self.names, - on_plot=self.on_plot, - ) - - def plot_predictions(self, batch, preds, ni): - """Plots predicted bounding boxes on input images and saves the result.""" - plot_images( - batch["img"], - batch_idx=torch.arange(len(batch["img"])), - cls=torch.argmax(preds, dim=1), - fname=self.save_dir / f"val_batch{ni}_pred.jpg", - names=self.names, - on_plot=self.on_plot, - ) # pred diff --git a/ultralytics-main/ultralytics/models/yolo/detect/__init__.py b/ultralytics-main/ultralytics/models/yolo/detect/__init__.py deleted file mode 100644 index 5f3e62c..0000000 --- a/ultralytics-main/ultralytics/models/yolo/detect/__init__.py +++ /dev/null @@ -1,7 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from .predict import DetectionPredictor -from .train import DetectionTrainer -from .val import DetectionValidator - -__all__ = "DetectionPredictor", "DetectionTrainer", "DetectionValidator" diff --git a/ultralytics-main/ultralytics/models/yolo/detect/predict.py b/ultralytics-main/ultralytics/models/yolo/detect/predict.py deleted file mode 100644 index 3a0c628..0000000 --- a/ultralytics-main/ultralytics/models/yolo/detect/predict.py +++ /dev/null @@ -1,43 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from ultralytics.engine.predictor import BasePredictor -from ultralytics.engine.results import Results -from ultralytics.utils import ops - - -class DetectionPredictor(BasePredictor): - """ - A class extending the BasePredictor class for prediction based on a detection model. - - Example: - ```python - from ultralytics.utils import ASSETS - from ultralytics.models.yolo.detect import DetectionPredictor - - args = dict(model='yolov8n.pt', source=ASSETS) - predictor = DetectionPredictor(overrides=args) - predictor.predict_cli() - ``` - """ - - def postprocess(self, preds, img, orig_imgs): - """Post-processes predictions and returns a list of Results objects.""" - preds = ops.non_max_suppression( - preds, - self.args.conf, - self.args.iou, - agnostic=self.args.agnostic_nms, - max_det=self.args.max_det, - classes=self.args.classes, - ) - - if not isinstance(orig_imgs, list): # input images are a torch.Tensor, not a list - orig_imgs = ops.convert_torch2numpy_batch(orig_imgs) - - results = [] - for i, pred in enumerate(preds): - orig_img = orig_imgs[i] - pred[:, :4] = ops.scale_boxes(img.shape[2:], pred[:, :4], orig_img.shape) - img_path = self.batch[0][i] - results.append(Results(orig_img, path=img_path, names=self.model.names, boxes=pred)) - return results diff --git a/ultralytics-main/ultralytics/models/yolo/detect/train.py b/ultralytics-main/ultralytics/models/yolo/detect/train.py deleted file mode 100644 index 3326512..0000000 --- a/ultralytics-main/ultralytics/models/yolo/detect/train.py +++ /dev/null @@ -1,143 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import math -import random -from copy import copy - -import numpy as np -import torch.nn as nn - -from ultralytics.data import build_dataloader, build_yolo_dataset -from ultralytics.engine.trainer import BaseTrainer -from ultralytics.models import yolo -from ultralytics.nn.tasks import DetectionModel -from ultralytics.utils import LOGGER, RANK -from ultralytics.utils.plotting import plot_images, plot_labels, plot_results -from ultralytics.utils.torch_utils import de_parallel, torch_distributed_zero_first - - -class DetectionTrainer(BaseTrainer): - """ - A class extending the BaseTrainer class for training based on a detection model. - - Example: - ```python - from ultralytics.models.yolo.detect import DetectionTrainer - - args = dict(model='yolov8n.pt', data='coco8.yaml', epochs=3) - trainer = DetectionTrainer(overrides=args) - trainer.train() - ``` - """ - - def build_dataset(self, img_path, mode="train", batch=None): - """ - Build YOLO Dataset. - - Args: - img_path (str): Path to the folder containing images. - mode (str): `train` mode or `val` mode, users are able to customize different augmentations for each mode. - batch (int, optional): Size of batches, this is for `rect`. Defaults to None. - """ - gs = max(int(de_parallel(self.model).stride.max() if self.model else 0), 32) - return build_yolo_dataset(self.args, img_path, batch, self.data, mode=mode, rect=mode == "val", stride=gs) - - def get_dataloader(self, dataset_path, batch_size=16, rank=0, mode="train"): - """Construct and return dataloader.""" - assert mode in ["train", "val"] - with torch_distributed_zero_first(rank): # init dataset *.cache only once if DDP - dataset = self.build_dataset(dataset_path, mode, batch_size) - shuffle = mode == "train" - if getattr(dataset, "rect", False) and shuffle: - LOGGER.warning("WARNING ⚠️ 'rect=True' is incompatible with DataLoader shuffle, setting shuffle=False") - shuffle = False - workers = self.args.workers if mode == "train" else self.args.workers * 2 - return build_dataloader(dataset, batch_size, workers, shuffle, rank) # return dataloader - - def preprocess_batch(self, batch): - """Preprocesses a batch of images by scaling and converting to float.""" - batch["img"] = batch["img"].to(self.device, non_blocking=True).float() / 255 - if self.args.multi_scale: - imgs = batch["img"] - sz = ( - random.randrange(self.args.imgsz * 0.5, self.args.imgsz * 1.5 + self.stride) - // self.stride - * self.stride - ) # size - sf = sz / max(imgs.shape[2:]) # scale factor - if sf != 1: - ns = [ - math.ceil(x * sf / self.stride) * self.stride for x in imgs.shape[2:] - ] # new shape (stretched to gs-multiple) - imgs = nn.functional.interpolate(imgs, size=ns, mode="bilinear", align_corners=False) - batch["img"] = imgs - return batch - - def set_model_attributes(self): - """Nl = de_parallel(self.model).model[-1].nl # number of detection layers (to scale hyps).""" - # self.args.box *= 3 / nl # scale to layers - # self.args.cls *= self.data["nc"] / 80 * 3 / nl # scale to classes and layers - # self.args.cls *= (self.args.imgsz / 640) ** 2 * 3 / nl # scale to image size and layers - self.model.nc = self.data["nc"] # attach number of classes to model - self.model.names = self.data["names"] # attach class names to model - self.model.args = self.args # attach hyperparameters to model - # TODO: self.model.class_weights = labels_to_class_weights(dataset.labels, nc).to(device) * nc - - def get_model(self, cfg=None, weights=None, verbose=True): - """Return a YOLO detection model.""" - model = DetectionModel(cfg, nc=self.data["nc"], verbose=verbose and RANK == -1) - if weights: - model.load(weights) - return model - - def get_validator(self): - """Returns a DetectionValidator for YOLO model validation.""" - self.loss_names = "box_loss", "cls_loss", "dfl_loss" - return yolo.detect.DetectionValidator( - self.test_loader, save_dir=self.save_dir, args=copy(self.args), _callbacks=self.callbacks - ) - - def label_loss_items(self, loss_items=None, prefix="train"): - """ - Returns a loss dict with labelled training loss items tensor. - - Not needed for classification but necessary for segmentation & detection - """ - keys = [f"{prefix}/{x}" for x in self.loss_names] - if loss_items is not None: - loss_items = [round(float(x), 5) for x in loss_items] # convert tensors to 5 decimal place floats - return dict(zip(keys, loss_items)) - else: - return keys - - def progress_string(self): - """Returns a formatted string of training progress with epoch, GPU memory, loss, instances and size.""" - return ("\n" + "%11s" * (4 + len(self.loss_names))) % ( - "Epoch", - "GPU_mem", - *self.loss_names, - "Instances", - "Size", - ) - - def plot_training_samples(self, batch, ni): - """Plots training samples with their annotations.""" - plot_images( - images=batch["img"], - batch_idx=batch["batch_idx"], - cls=batch["cls"].squeeze(-1), - bboxes=batch["bboxes"], - paths=batch["im_file"], - fname=self.save_dir / f"train_batch{ni}.jpg", - on_plot=self.on_plot, - ) - - def plot_metrics(self): - """Plots metrics from a CSV file.""" - plot_results(file=self.csv, on_plot=self.on_plot) # save results.png - - def plot_training_labels(self): - """Create a labeled training plot of the YOLO model.""" - boxes = np.concatenate([lb["bboxes"] for lb in self.train_loader.dataset.labels], 0) - cls = np.concatenate([lb["cls"] for lb in self.train_loader.dataset.labels], 0) - plot_labels(boxes, cls.squeeze(), names=self.data["names"], save_dir=self.save_dir, on_plot=self.on_plot) diff --git a/ultralytics-main/ultralytics/models/yolo/detect/val.py b/ultralytics-main/ultralytics/models/yolo/detect/val.py deleted file mode 100644 index 8226cd6..0000000 --- a/ultralytics-main/ultralytics/models/yolo/detect/val.py +++ /dev/null @@ -1,299 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import os -from pathlib import Path - -import numpy as np -import torch - -from ultralytics.data import build_dataloader, build_yolo_dataset, converter -from ultralytics.engine.validator import BaseValidator -from ultralytics.utils import LOGGER, ops -from ultralytics.utils.checks import check_requirements -from ultralytics.utils.metrics import ConfusionMatrix, DetMetrics, box_iou -from ultralytics.utils.plotting import output_to_target, plot_images - - -class DetectionValidator(BaseValidator): - """ - A class extending the BaseValidator class for validation based on a detection model. - - Example: - ```python - from ultralytics.models.yolo.detect import DetectionValidator - - args = dict(model='yolov8n.pt', data='coco8.yaml') - validator = DetectionValidator(args=args) - validator() - ``` - """ - - def __init__(self, dataloader=None, save_dir=None, pbar=None, args=None, _callbacks=None): - """Initialize detection model with necessary variables and settings.""" - super().__init__(dataloader, save_dir, pbar, args, _callbacks) - self.nt_per_class = None - self.is_coco = False - self.class_map = None - self.args.task = "detect" - self.metrics = DetMetrics(save_dir=self.save_dir, on_plot=self.on_plot) - self.iouv = torch.linspace(0.5, 0.95, 10) # IoU vector for mAP@0.5:0.95 - self.niou = self.iouv.numel() - self.lb = [] # for autolabelling - - def preprocess(self, batch): - """Preprocesses batch of images for YOLO training.""" - batch["img"] = batch["img"].to(self.device, non_blocking=True) - batch["img"] = (batch["img"].half() if self.args.half else batch["img"].float()) / 255 - for k in ["batch_idx", "cls", "bboxes"]: - batch[k] = batch[k].to(self.device) - - if self.args.save_hybrid: - height, width = batch["img"].shape[2:] - nb = len(batch["img"]) - bboxes = batch["bboxes"] * torch.tensor((width, height, width, height), device=self.device) - self.lb = ( - [ - torch.cat([batch["cls"][batch["batch_idx"] == i], bboxes[batch["batch_idx"] == i]], dim=-1) - for i in range(nb) - ] - if self.args.save_hybrid - else [] - ) # for autolabelling - - return batch - - def init_metrics(self, model): - """Initialize evaluation metrics for YOLO.""" - val = self.data.get(self.args.split, "") # validation path - self.is_coco = isinstance(val, str) and "coco" in val and val.endswith(f"{os.sep}val2017.txt") # is COCO - self.class_map = converter.coco80_to_coco91_class() if self.is_coco else list(range(1000)) - self.args.save_json |= self.is_coco and not self.training # run on final val if training COCO - self.names = model.names - self.nc = len(model.names) - self.metrics.names = self.names - self.metrics.plot = self.args.plots - self.confusion_matrix = ConfusionMatrix(nc=self.nc, conf=self.args.conf) - self.seen = 0 - self.jdict = [] - self.stats = dict(tp=[], conf=[], pred_cls=[], target_cls=[]) - - def get_desc(self): - """Return a formatted string summarizing class metrics of YOLO model.""" - return ("%22s" + "%11s" * 6) % ("Class", "Images", "Instances", "Box(P", "R", "mAP50", "mAP50-95)") - - def postprocess(self, preds): - """Apply Non-maximum suppression to prediction outputs.""" - return ops.non_max_suppression( - preds, - self.args.conf, - self.args.iou, - labels=self.lb, - multi_label=True, - agnostic=self.args.single_cls, - max_det=self.args.max_det, - ) - - def _prepare_batch(self, si, batch): - """Prepares a batch of images and annotations for validation.""" - idx = batch["batch_idx"] == si - cls = batch["cls"][idx].squeeze(-1) - bbox = batch["bboxes"][idx] - ori_shape = batch["ori_shape"][si] - imgsz = batch["img"].shape[2:] - ratio_pad = batch["ratio_pad"][si] - if len(cls): - bbox = ops.xywh2xyxy(bbox) * torch.tensor(imgsz, device=self.device)[[1, 0, 1, 0]] # target boxes - ops.scale_boxes(imgsz, bbox, ori_shape, ratio_pad=ratio_pad) # native-space labels - return dict(cls=cls, bbox=bbox, ori_shape=ori_shape, imgsz=imgsz, ratio_pad=ratio_pad) - - def _prepare_pred(self, pred, pbatch): - """Prepares a batch of images and annotations for validation.""" - predn = pred.clone() - ops.scale_boxes( - pbatch["imgsz"], predn[:, :4], pbatch["ori_shape"], ratio_pad=pbatch["ratio_pad"] - ) # native-space pred - return predn - - def update_metrics(self, preds, batch): - """Metrics.""" - for si, pred in enumerate(preds): - self.seen += 1 - npr = len(pred) - stat = dict( - conf=torch.zeros(0, device=self.device), - pred_cls=torch.zeros(0, device=self.device), - tp=torch.zeros(npr, self.niou, dtype=torch.bool, device=self.device), - ) - pbatch = self._prepare_batch(si, batch) - cls, bbox = pbatch.pop("cls"), pbatch.pop("bbox") - nl = len(cls) - stat["target_cls"] = cls - if npr == 0: - if nl: - for k in self.stats.keys(): - self.stats[k].append(stat[k]) - if self.args.plots: - self.confusion_matrix.process_batch(detections=None, gt_bboxes=bbox, gt_cls=cls) - continue - - # Predictions - if self.args.single_cls: - pred[:, 5] = 0 - predn = self._prepare_pred(pred, pbatch) - stat["conf"] = predn[:, 4] - stat["pred_cls"] = predn[:, 5] - - # Evaluate - if nl: - stat["tp"] = self._process_batch(predn, bbox, cls) - if self.args.plots: - self.confusion_matrix.process_batch(predn, bbox, cls) - for k in self.stats.keys(): - self.stats[k].append(stat[k]) - - # Save - if self.args.save_json: - self.pred_to_json(predn, batch["im_file"][si]) - if self.args.save_txt: - file = self.save_dir / "labels" / f'{Path(batch["im_file"][si]).stem}.txt' - self.save_one_txt(predn, self.args.save_conf, pbatch["ori_shape"], file) - - def finalize_metrics(self, *args, **kwargs): - """Set final values for metrics speed and confusion matrix.""" - self.metrics.speed = self.speed - self.metrics.confusion_matrix = self.confusion_matrix - - def get_stats(self): - """Returns metrics statistics and results dictionary.""" - stats = {k: torch.cat(v, 0).cpu().numpy() for k, v in self.stats.items()} # to numpy - if len(stats) and stats["tp"].any(): - self.metrics.process(**stats) - self.nt_per_class = np.bincount( - stats["target_cls"].astype(int), minlength=self.nc - ) # number of targets per class - return self.metrics.results_dict - - def print_results(self): - """Prints training/validation set metrics per class.""" - pf = "%22s" + "%11i" * 2 + "%11.3g" * len(self.metrics.keys) # print format - LOGGER.info(pf % ("all", self.seen, self.nt_per_class.sum(), *self.metrics.mean_results())) - if self.nt_per_class.sum() == 0: - LOGGER.warning(f"WARNING ⚠️ no labels found in {self.args.task} set, can not compute metrics without labels") - - # Print results per class - if self.args.verbose and not self.training and self.nc > 1 and len(self.stats): - for i, c in enumerate(self.metrics.ap_class_index): - LOGGER.info(pf % (self.names[c], self.seen, self.nt_per_class[c], *self.metrics.class_result(i))) - - if self.args.plots: - for normalize in True, False: - self.confusion_matrix.plot( - save_dir=self.save_dir, names=self.names.values(), normalize=normalize, on_plot=self.on_plot - ) - - def _process_batch(self, detections, gt_bboxes, gt_cls): - """ - Return correct prediction matrix. - - Args: - detections (torch.Tensor): Tensor of shape [N, 6] representing detections. - Each detection is of the format: x1, y1, x2, y2, conf, class. - labels (torch.Tensor): Tensor of shape [M, 5] representing labels. - Each label is of the format: class, x1, y1, x2, y2. - - Returns: - (torch.Tensor): Correct prediction matrix of shape [N, 10] for 10 IoU levels. - """ - iou = box_iou(gt_bboxes, detections[:, :4]) - return self.match_predictions(detections[:, 5], gt_cls, iou) - - def build_dataset(self, img_path, mode="val", batch=None): - """ - Build YOLO Dataset. - - Args: - img_path (str): Path to the folder containing images. - mode (str): `train` mode or `val` mode, users are able to customize different augmentations for each mode. - batch (int, optional): Size of batches, this is for `rect`. Defaults to None. - """ - return build_yolo_dataset(self.args, img_path, batch, self.data, mode=mode, stride=self.stride) - - def get_dataloader(self, dataset_path, batch_size): - """Construct and return dataloader.""" - dataset = self.build_dataset(dataset_path, batch=batch_size, mode="val") - return build_dataloader(dataset, batch_size, self.args.workers, shuffle=False, rank=-1) # return dataloader - - def plot_val_samples(self, batch, ni): - """Plot validation image samples.""" - plot_images( - batch["img"], - batch["batch_idx"], - batch["cls"].squeeze(-1), - batch["bboxes"], - paths=batch["im_file"], - fname=self.save_dir / f"val_batch{ni}_labels.jpg", - names=self.names, - on_plot=self.on_plot, - ) - - def plot_predictions(self, batch, preds, ni): - """Plots predicted bounding boxes on input images and saves the result.""" - plot_images( - batch["img"], - *output_to_target(preds, max_det=self.args.max_det), - paths=batch["im_file"], - fname=self.save_dir / f"val_batch{ni}_pred.jpg", - names=self.names, - on_plot=self.on_plot, - ) # pred - - def save_one_txt(self, predn, save_conf, shape, file): - """Save YOLO detections to a txt file in normalized coordinates in a specific format.""" - gn = torch.tensor(shape)[[1, 0, 1, 0]] # normalization gain whwh - for *xyxy, conf, cls in predn.tolist(): - xywh = (ops.xyxy2xywh(torch.tensor(xyxy).view(1, 4)) / gn).view(-1).tolist() # normalized xywh - line = (cls, *xywh, conf) if save_conf else (cls, *xywh) # label format - with open(file, "a") as f: - f.write(("%g " * len(line)).rstrip() % line + "\n") - - def pred_to_json(self, predn, filename): - """Serialize YOLO predictions to COCO json format.""" - stem = Path(filename).stem - image_id = int(stem) if stem.isnumeric() else stem - box = ops.xyxy2xywh(predn[:, :4]) # xywh - box[:, :2] -= box[:, 2:] / 2 # xy center to top-left corner - for p, b in zip(predn.tolist(), box.tolist()): - self.jdict.append( - { - "image_id": image_id, - "category_id": self.class_map[int(p[5])], - "bbox": [round(x, 3) for x in b], - "score": round(p[4], 5), - } - ) - - def eval_json(self, stats): - """Evaluates YOLO output in JSON format and returns performance statistics.""" - if self.args.save_json and self.is_coco and len(self.jdict): - anno_json = self.data["path"] / "annotations/instances_val2017.json" # annotations - pred_json = self.save_dir / "predictions.json" # predictions - LOGGER.info(f"\nEvaluating pycocotools mAP using {pred_json} and {anno_json}...") - try: # https://github.com/cocodataset/cocoapi/blob/master/PythonAPI/pycocoEvalDemo.ipynb - check_requirements("pycocotools>=2.0.6") - from pycocotools.coco import COCO # noqa - from pycocotools.cocoeval import COCOeval # noqa - - for x in anno_json, pred_json: - assert x.is_file(), f"{x} file not found" - anno = COCO(str(anno_json)) # init annotations api - pred = anno.loadRes(str(pred_json)) # init predictions api (must pass string, not Path) - eval = COCOeval(anno, pred, "bbox") - if self.is_coco: - eval.params.imgIds = [int(Path(x).stem) for x in self.dataloader.dataset.im_files] # images to eval - eval.evaluate() - eval.accumulate() - eval.summarize() - stats[self.metrics.keys[-1]], stats[self.metrics.keys[-2]] = eval.stats[:2] # update mAP50-95 and mAP50 - except Exception as e: - LOGGER.warning(f"pycocotools unable to run: {e}") - return stats diff --git a/ultralytics-main/ultralytics/models/yolo/model.py b/ultralytics-main/ultralytics/models/yolo/model.py deleted file mode 100644 index 1bd38d3..0000000 --- a/ultralytics-main/ultralytics/models/yolo/model.py +++ /dev/null @@ -1,106 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from pathlib import Path - -from ultralytics.engine.model import Model -from ultralytics.models import yolo -from ultralytics.nn.tasks import ClassificationModel, DetectionModel, OBBModel, PoseModel, SegmentationModel, WorldModel -from ultralytics.utils import yaml_load, ROOT - - -class YOLO(Model): - """YOLO (You Only Look Once) object detection model.""" - - def __init__(self, model="yolov8n.pt", task=None, verbose=False): - """Initialize YOLO model, switching to YOLOWorld if model filename contains '-world'.""" - path = Path(model) - if "-world" in path.stem and path.suffix in {".pt", ".yaml", ".yml"}: # if YOLOWorld PyTorch model - new_instance = YOLOWorld(path) - self.__class__ = type(new_instance) - self.__dict__ = new_instance.__dict__ - else: - # Continue with default YOLO initialization - super().__init__(model=model, task=task, verbose=verbose) - - @property - def task_map(self): - """Map head to model, trainer, validator, and predictor classes.""" - return { - "classify": { - "model": ClassificationModel, - "trainer": yolo.classify.ClassificationTrainer, - "validator": yolo.classify.ClassificationValidator, - "predictor": yolo.classify.ClassificationPredictor, - }, - "detect": { - "model": DetectionModel, - "trainer": yolo.detect.DetectionTrainer, - "validator": yolo.detect.DetectionValidator, - "predictor": yolo.detect.DetectionPredictor, - }, - "segment": { - "model": SegmentationModel, - "trainer": yolo.segment.SegmentationTrainer, - "validator": yolo.segment.SegmentationValidator, - "predictor": yolo.segment.SegmentationPredictor, - }, - "pose": { - "model": PoseModel, - "trainer": yolo.pose.PoseTrainer, - "validator": yolo.pose.PoseValidator, - "predictor": yolo.pose.PosePredictor, - }, - "obb": { - "model": OBBModel, - "trainer": yolo.obb.OBBTrainer, - "validator": yolo.obb.OBBValidator, - "predictor": yolo.obb.OBBPredictor, - }, - } - - -class YOLOWorld(Model): - """YOLO-World object detection model.""" - - def __init__(self, model="yolov8s-world.pt") -> None: - """ - Initializes the YOLOv8-World model with the given pre-trained model file. Supports *.pt and *.yaml formats. - - Args: - model (str | Path): Path to the pre-trained model. Defaults to 'yolov8s-world.pt'. - """ - super().__init__(model=model, task="detect") - - # Assign default COCO class names when there are no custom names - if not hasattr(self.model, "names"): - self.model.names = yaml_load(ROOT / "cfg/datasets/coco8.yaml").get("names") - - @property - def task_map(self): - """Map head to model, validator, and predictor classes.""" - return { - "detect": { - "model": WorldModel, - "validator": yolo.detect.DetectionValidator, - "predictor": yolo.detect.DetectionPredictor, - } - } - - def set_classes(self, classes): - """ - Set classes. - - Args: - classes (List(str)): A list of categories i.e ["person"]. - """ - self.model.set_classes(classes) - # Remove background if it's given - background = " " - if background in classes: - classes.remove(background) - self.model.names = classes - - # Reset method class names - # self.predictor = None # reset predictor otherwise old names remain - if self.predictor: - self.predictor.model.names = classes diff --git a/ultralytics-main/ultralytics/models/yolo/obb/__init__.py b/ultralytics-main/ultralytics/models/yolo/obb/__init__.py deleted file mode 100644 index f60349a..0000000 --- a/ultralytics-main/ultralytics/models/yolo/obb/__init__.py +++ /dev/null @@ -1,7 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from .predict import OBBPredictor -from .train import OBBTrainer -from .val import OBBValidator - -__all__ = "OBBPredictor", "OBBTrainer", "OBBValidator" diff --git a/ultralytics-main/ultralytics/models/yolo/obb/predict.py b/ultralytics-main/ultralytics/models/yolo/obb/predict.py deleted file mode 100644 index bb8d4d3..0000000 --- a/ultralytics-main/ultralytics/models/yolo/obb/predict.py +++ /dev/null @@ -1,53 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import torch - -from ultralytics.engine.results import Results -from ultralytics.models.yolo.detect.predict import DetectionPredictor -from ultralytics.utils import DEFAULT_CFG, ops - - -class OBBPredictor(DetectionPredictor): - """ - A class extending the DetectionPredictor class for prediction based on an Oriented Bounding Box (OBB) model. - - Example: - ```python - from ultralytics.utils import ASSETS - from ultralytics.models.yolo.obb import OBBPredictor - - args = dict(model='yolov8n-obb.pt', source=ASSETS) - predictor = OBBPredictor(overrides=args) - predictor.predict_cli() - ``` - """ - - def __init__(self, cfg=DEFAULT_CFG, overrides=None, _callbacks=None): - """Initializes OBBPredictor with optional model and data configuration overrides.""" - super().__init__(cfg, overrides, _callbacks) - self.args.task = "obb" - - def postprocess(self, preds, img, orig_imgs): - """Post-processes predictions and returns a list of Results objects.""" - preds = ops.non_max_suppression( - preds, - self.args.conf, - self.args.iou, - agnostic=self.args.agnostic_nms, - max_det=self.args.max_det, - nc=len(self.model.names), - classes=self.args.classes, - rotated=True, - ) - - if not isinstance(orig_imgs, list): # input images are a torch.Tensor, not a list - orig_imgs = ops.convert_torch2numpy_batch(orig_imgs) - - results = [] - for pred, orig_img, img_path in zip(preds, orig_imgs, self.batch[0]): - rboxes = ops.regularize_rboxes(torch.cat([pred[:, :4], pred[:, -1:]], dim=-1)) - rboxes[:, :4] = ops.scale_boxes(img.shape[2:], rboxes[:, :4], orig_img.shape, xywh=True) - # xywh, r, conf, cls - obb = torch.cat([rboxes, pred[:, 4:6]], dim=-1) - results.append(Results(orig_img, path=img_path, names=self.model.names, obb=obb)) - return results diff --git a/ultralytics-main/ultralytics/models/yolo/obb/train.py b/ultralytics-main/ultralytics/models/yolo/obb/train.py deleted file mode 100644 index 40a35a9..0000000 --- a/ultralytics-main/ultralytics/models/yolo/obb/train.py +++ /dev/null @@ -1,42 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from copy import copy - -from ultralytics.models import yolo -from ultralytics.nn.tasks import OBBModel -from ultralytics.utils import DEFAULT_CFG, RANK - - -class OBBTrainer(yolo.detect.DetectionTrainer): - """ - A class extending the DetectionTrainer class for training based on an Oriented Bounding Box (OBB) model. - - Example: - ```python - from ultralytics.models.yolo.obb import OBBTrainer - - args = dict(model='yolov8n-obb.pt', data='dota8.yaml', epochs=3) - trainer = OBBTrainer(overrides=args) - trainer.train() - ``` - """ - - def __init__(self, cfg=DEFAULT_CFG, overrides=None, _callbacks=None): - """Initialize a OBBTrainer object with given arguments.""" - if overrides is None: - overrides = {} - overrides["task"] = "obb" - super().__init__(cfg, overrides, _callbacks) - - def get_model(self, cfg=None, weights=None, verbose=True): - """Return OBBModel initialized with specified config and weights.""" - model = OBBModel(cfg, ch=3, nc=self.data["nc"], verbose=verbose and RANK == -1) - if weights: - model.load(weights) - - return model - - def get_validator(self): - """Return an instance of OBBValidator for validation of YOLO model.""" - self.loss_names = "box_loss", "cls_loss", "dfl_loss" - return yolo.obb.OBBValidator(self.test_loader, save_dir=self.save_dir, args=copy(self.args)) diff --git a/ultralytics-main/ultralytics/models/yolo/obb/val.py b/ultralytics-main/ultralytics/models/yolo/obb/val.py deleted file mode 100644 index c440fe2..0000000 --- a/ultralytics-main/ultralytics/models/yolo/obb/val.py +++ /dev/null @@ -1,185 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from pathlib import Path - -import torch - -from ultralytics.models.yolo.detect import DetectionValidator -from ultralytics.utils import LOGGER, ops -from ultralytics.utils.metrics import OBBMetrics, batch_probiou -from ultralytics.utils.plotting import output_to_rotated_target, plot_images - - -class OBBValidator(DetectionValidator): - """ - A class extending the DetectionValidator class for validation based on an Oriented Bounding Box (OBB) model. - - Example: - ```python - from ultralytics.models.yolo.obb import OBBValidator - - args = dict(model='yolov8n-obb.pt', data='dota8.yaml') - validator = OBBValidator(args=args) - validator(model=args['model']) - ``` - """ - - def __init__(self, dataloader=None, save_dir=None, pbar=None, args=None, _callbacks=None): - """Initialize OBBValidator and set task to 'obb', metrics to OBBMetrics.""" - super().__init__(dataloader, save_dir, pbar, args, _callbacks) - self.args.task = "obb" - self.metrics = OBBMetrics(save_dir=self.save_dir, plot=True, on_plot=self.on_plot) - - def init_metrics(self, model): - """Initialize evaluation metrics for YOLO.""" - super().init_metrics(model) - val = self.data.get(self.args.split, "") # validation path - self.is_dota = isinstance(val, str) and "DOTA" in val # is COCO - - def postprocess(self, preds): - """Apply Non-maximum suppression to prediction outputs.""" - return ops.non_max_suppression( - preds, - self.args.conf, - self.args.iou, - labels=self.lb, - nc=self.nc, - multi_label=True, - agnostic=self.args.single_cls, - max_det=self.args.max_det, - rotated=True, - ) - - def _process_batch(self, detections, gt_bboxes, gt_cls): - """ - Return correct prediction matrix. - - Args: - detections (torch.Tensor): Tensor of shape [N, 7] representing detections. - Each detection is of the format: x1, y1, x2, y2, conf, class, angle. - gt_bboxes (torch.Tensor): Tensor of shape [M, 5] representing rotated boxes. - Each box is of the format: x1, y1, x2, y2, angle. - labels (torch.Tensor): Tensor of shape [M] representing labels. - - Returns: - (torch.Tensor): Correct prediction matrix of shape [N, 10] for 10 IoU levels. - """ - iou = batch_probiou(gt_bboxes, torch.cat([detections[:, :4], detections[:, -1:]], dim=-1)) - return self.match_predictions(detections[:, 5], gt_cls, iou) - - def _prepare_batch(self, si, batch): - """Prepares and returns a batch for OBB validation.""" - idx = batch["batch_idx"] == si - cls = batch["cls"][idx].squeeze(-1) - bbox = batch["bboxes"][idx] - ori_shape = batch["ori_shape"][si] - imgsz = batch["img"].shape[2:] - ratio_pad = batch["ratio_pad"][si] - if len(cls): - bbox[..., :4].mul_(torch.tensor(imgsz, device=self.device)[[1, 0, 1, 0]]) # target boxes - ops.scale_boxes(imgsz, bbox, ori_shape, ratio_pad=ratio_pad, xywh=True) # native-space labels - return dict(cls=cls, bbox=bbox, ori_shape=ori_shape, imgsz=imgsz, ratio_pad=ratio_pad) - - def _prepare_pred(self, pred, pbatch): - """Prepares and returns a batch for OBB validation with scaled and padded bounding boxes.""" - predn = pred.clone() - ops.scale_boxes( - pbatch["imgsz"], predn[:, :4], pbatch["ori_shape"], ratio_pad=pbatch["ratio_pad"], xywh=True - ) # native-space pred - return predn - - def plot_predictions(self, batch, preds, ni): - """Plots predicted bounding boxes on input images and saves the result.""" - plot_images( - batch["img"], - *output_to_rotated_target(preds, max_det=self.args.max_det), - paths=batch["im_file"], - fname=self.save_dir / f"val_batch{ni}_pred.jpg", - names=self.names, - on_plot=self.on_plot, - ) # pred - - def pred_to_json(self, predn, filename): - """Serialize YOLO predictions to COCO json format.""" - stem = Path(filename).stem - image_id = int(stem) if stem.isnumeric() else stem - rbox = torch.cat([predn[:, :4], predn[:, -1:]], dim=-1) - poly = ops.xywhr2xyxyxyxy(rbox).view(-1, 8) - for i, (r, b) in enumerate(zip(rbox.tolist(), poly.tolist())): - self.jdict.append( - { - "image_id": image_id, - "category_id": self.class_map[int(predn[i, 5].item())], - "score": round(predn[i, 4].item(), 5), - "rbox": [round(x, 3) for x in r], - "poly": [round(x, 3) for x in b], - } - ) - - def save_one_txt(self, predn, save_conf, shape, file): - """Save YOLO detections to a txt file in normalized coordinates in a specific format.""" - gn = torch.tensor(shape)[[1, 0]] # normalization gain whwh - for *xywh, conf, cls, angle in predn.tolist(): - xywha = torch.tensor([*xywh, angle]).view(1, 5) - xyxyxyxy = (ops.xywhr2xyxyxyxy(xywha) / gn).view(-1).tolist() # normalized xywh - line = (cls, *xyxyxyxy, conf) if save_conf else (cls, *xyxyxyxy) # label format - with open(file, "a") as f: - f.write(("%g " * len(line)).rstrip() % line + "\n") - - def eval_json(self, stats): - """Evaluates YOLO output in JSON format and returns performance statistics.""" - if self.args.save_json and self.is_dota and len(self.jdict): - import json - import re - from collections import defaultdict - - pred_json = self.save_dir / "predictions.json" # predictions - pred_txt = self.save_dir / "predictions_txt" # predictions - pred_txt.mkdir(parents=True, exist_ok=True) - data = json.load(open(pred_json)) - # Save split results - LOGGER.info(f"Saving predictions with DOTA format to {pred_txt}...") - for d in data: - image_id = d["image_id"] - score = d["score"] - classname = self.names[d["category_id"]].replace(" ", "-") - p = d["poly"] - - with open(f'{pred_txt / f"Task1_{classname}"}.txt', "a") as f: - f.writelines(f"{image_id} {score} {p[0]} {p[1]} {p[2]} {p[3]} {p[4]} {p[5]} {p[6]} {p[7]}\n") - # Save merged results, this could result slightly lower map than using official merging script, - # because of the probiou calculation. - pred_merged_txt = self.save_dir / "predictions_merged_txt" # predictions - pred_merged_txt.mkdir(parents=True, exist_ok=True) - merged_results = defaultdict(list) - LOGGER.info(f"Saving merged predictions with DOTA format to {pred_merged_txt}...") - for d in data: - image_id = d["image_id"].split("__")[0] - pattern = re.compile(r"\d+___\d+") - x, y = (int(c) for c in re.findall(pattern, d["image_id"])[0].split("___")) - bbox, score, cls = d["rbox"], d["score"], d["category_id"] - bbox[0] += x - bbox[1] += y - bbox.extend([score, cls]) - merged_results[image_id].append(bbox) - for image_id, bbox in merged_results.items(): - bbox = torch.tensor(bbox) - max_wh = torch.max(bbox[:, :2]).item() * 2 - c = bbox[:, 6:7] * max_wh # classes - scores = bbox[:, 5] # scores - b = bbox[:, :5].clone() - b[:, :2] += c - # 0.3 could get results close to the ones from official merging script, even slightly better. - i = ops.nms_rotated(b, scores, 0.3) - bbox = bbox[i] - - b = ops.xywhr2xyxyxyxy(bbox[:, :5]).view(-1, 8) - for x in torch.cat([b, bbox[:, 5:7]], dim=-1).tolist(): - classname = self.names[int(x[-1])].replace(" ", "-") - p = [round(i, 3) for i in x[:-2]] # poly - score = round(x[-2], 3) - - with open(f'{pred_merged_txt / f"Task1_{classname}"}.txt', "a") as f: - f.writelines(f"{image_id} {score} {p[0]} {p[1]} {p[2]} {p[3]} {p[4]} {p[5]} {p[6]} {p[7]}\n") - - return stats diff --git a/ultralytics-main/ultralytics/models/yolo/pose/__init__.py b/ultralytics-main/ultralytics/models/yolo/pose/__init__.py deleted file mode 100644 index d566943..0000000 --- a/ultralytics-main/ultralytics/models/yolo/pose/__init__.py +++ /dev/null @@ -1,7 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from .predict import PosePredictor -from .train import PoseTrainer -from .val import PoseValidator - -__all__ = "PoseTrainer", "PoseValidator", "PosePredictor" diff --git a/ultralytics-main/ultralytics/models/yolo/pose/predict.py b/ultralytics-main/ultralytics/models/yolo/pose/predict.py deleted file mode 100644 index 7c55709..0000000 --- a/ultralytics-main/ultralytics/models/yolo/pose/predict.py +++ /dev/null @@ -1,58 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from ultralytics.engine.results import Results -from ultralytics.models.yolo.detect.predict import DetectionPredictor -from ultralytics.utils import DEFAULT_CFG, LOGGER, ops - - -class PosePredictor(DetectionPredictor): - """ - A class extending the DetectionPredictor class for prediction based on a pose model. - - Example: - ```python - from ultralytics.utils import ASSETS - from ultralytics.models.yolo.pose import PosePredictor - - args = dict(model='yolov8n-pose.pt', source=ASSETS) - predictor = PosePredictor(overrides=args) - predictor.predict_cli() - ``` - """ - - def __init__(self, cfg=DEFAULT_CFG, overrides=None, _callbacks=None): - """Initializes PosePredictor, sets task to 'pose' and logs a warning for using 'mps' as device.""" - super().__init__(cfg, overrides, _callbacks) - self.args.task = "pose" - if isinstance(self.args.device, str) and self.args.device.lower() == "mps": - LOGGER.warning( - "WARNING ⚠️ Apple MPS known Pose bug. Recommend 'device=cpu' for Pose models. " - "See https://github.com/ultralytics/ultralytics/issues/4031." - ) - - def postprocess(self, preds, img, orig_imgs): - """Return detection results for a given input image or list of images.""" - preds = ops.non_max_suppression( - preds, - self.args.conf, - self.args.iou, - agnostic=self.args.agnostic_nms, - max_det=self.args.max_det, - classes=self.args.classes, - nc=len(self.model.names), - ) - - if not isinstance(orig_imgs, list): # input images are a torch.Tensor, not a list - orig_imgs = ops.convert_torch2numpy_batch(orig_imgs) - - results = [] - for i, pred in enumerate(preds): - orig_img = orig_imgs[i] - pred[:, :4] = ops.scale_boxes(img.shape[2:], pred[:, :4], orig_img.shape).round() - pred_kpts = pred[:, 6:].view(len(pred), *self.model.kpt_shape) if len(pred) else pred[:, 6:] - pred_kpts = ops.scale_coords(img.shape[2:], pred_kpts, orig_img.shape) - img_path = self.batch[0][i] - results.append( - Results(orig_img, path=img_path, names=self.model.names, boxes=pred[:, :6], keypoints=pred_kpts) - ) - return results diff --git a/ultralytics-main/ultralytics/models/yolo/pose/train.py b/ultralytics-main/ultralytics/models/yolo/pose/train.py deleted file mode 100644 index f5229e5..0000000 --- a/ultralytics-main/ultralytics/models/yolo/pose/train.py +++ /dev/null @@ -1,79 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from copy import copy - -from ultralytics.models import yolo -from ultralytics.nn.tasks import PoseModel -from ultralytics.utils import DEFAULT_CFG, LOGGER -from ultralytics.utils.plotting import plot_images, plot_results - - -class PoseTrainer(yolo.detect.DetectionTrainer): - """ - A class extending the DetectionTrainer class for training based on a pose model. - - Example: - ```python - from ultralytics.models.yolo.pose import PoseTrainer - - args = dict(model='yolov8n-pose.pt', data='coco8-pose.yaml', epochs=3) - trainer = PoseTrainer(overrides=args) - trainer.train() - ``` - """ - - def __init__(self, cfg=DEFAULT_CFG, overrides=None, _callbacks=None): - """Initialize a PoseTrainer object with specified configurations and overrides.""" - if overrides is None: - overrides = {} - overrides["task"] = "pose" - super().__init__(cfg, overrides, _callbacks) - - if isinstance(self.args.device, str) and self.args.device.lower() == "mps": - LOGGER.warning( - "WARNING ⚠️ Apple MPS known Pose bug. Recommend 'device=cpu' for Pose models. " - "See https://github.com/ultralytics/ultralytics/issues/4031." - ) - - def get_model(self, cfg=None, weights=None, verbose=True): - """Get pose estimation model with specified configuration and weights.""" - model = PoseModel(cfg, ch=3, nc=self.data["nc"], data_kpt_shape=self.data["kpt_shape"], verbose=verbose) - if weights: - model.load(weights) - - return model - - def set_model_attributes(self): - """Sets keypoints shape attribute of PoseModel.""" - super().set_model_attributes() - self.model.kpt_shape = self.data["kpt_shape"] - - def get_validator(self): - """Returns an instance of the PoseValidator class for validation.""" - self.loss_names = "box_loss", "pose_loss", "kobj_loss", "cls_loss", "dfl_loss" - return yolo.pose.PoseValidator( - self.test_loader, save_dir=self.save_dir, args=copy(self.args), _callbacks=self.callbacks - ) - - def plot_training_samples(self, batch, ni): - """Plot a batch of training samples with annotated class labels, bounding boxes, and keypoints.""" - images = batch["img"] - kpts = batch["keypoints"] - cls = batch["cls"].squeeze(-1) - bboxes = batch["bboxes"] - paths = batch["im_file"] - batch_idx = batch["batch_idx"] - plot_images( - images, - batch_idx, - cls, - bboxes, - kpts=kpts, - paths=paths, - fname=self.save_dir / f"train_batch{ni}.jpg", - on_plot=self.on_plot, - ) - - def plot_metrics(self): - """Plots training/val metrics.""" - plot_results(file=self.csv, pose=True, on_plot=self.on_plot) # save results.png diff --git a/ultralytics-main/ultralytics/models/yolo/pose/val.py b/ultralytics-main/ultralytics/models/yolo/pose/val.py deleted file mode 100644 index 8405686..0000000 --- a/ultralytics-main/ultralytics/models/yolo/pose/val.py +++ /dev/null @@ -1,248 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from pathlib import Path - -import numpy as np -import torch - -from ultralytics.models.yolo.detect import DetectionValidator -from ultralytics.utils import LOGGER, ops -from ultralytics.utils.checks import check_requirements -from ultralytics.utils.metrics import OKS_SIGMA, PoseMetrics, box_iou, kpt_iou -from ultralytics.utils.plotting import output_to_target, plot_images - - -class PoseValidator(DetectionValidator): - """ - A class extending the DetectionValidator class for validation based on a pose model. - - Example: - ```python - from ultralytics.models.yolo.pose import PoseValidator - - args = dict(model='yolov8n-pose.pt', data='coco8-pose.yaml') - validator = PoseValidator(args=args) - validator() - ``` - """ - - def __init__(self, dataloader=None, save_dir=None, pbar=None, args=None, _callbacks=None): - """Initialize a 'PoseValidator' object with custom parameters and assigned attributes.""" - super().__init__(dataloader, save_dir, pbar, args, _callbacks) - self.sigma = None - self.kpt_shape = None - self.args.task = "pose" - self.metrics = PoseMetrics(save_dir=self.save_dir, on_plot=self.on_plot) - if isinstance(self.args.device, str) and self.args.device.lower() == "mps": - LOGGER.warning( - "WARNING ⚠️ Apple MPS known Pose bug. Recommend 'device=cpu' for Pose models. " - "See https://github.com/ultralytics/ultralytics/issues/4031." - ) - - def preprocess(self, batch): - """Preprocesses the batch by converting the 'keypoints' data into a float and moving it to the device.""" - batch = super().preprocess(batch) - batch["keypoints"] = batch["keypoints"].to(self.device).float() - return batch - - def get_desc(self): - """Returns description of evaluation metrics in string format.""" - return ("%22s" + "%11s" * 10) % ( - "Class", - "Images", - "Instances", - "Box(P", - "R", - "mAP50", - "mAP50-95)", - "Pose(P", - "R", - "mAP50", - "mAP50-95)", - ) - - def postprocess(self, preds): - """Apply non-maximum suppression and return detections with high confidence scores.""" - return ops.non_max_suppression( - preds, - self.args.conf, - self.args.iou, - labels=self.lb, - multi_label=True, - agnostic=self.args.single_cls, - max_det=self.args.max_det, - nc=self.nc, - ) - - def init_metrics(self, model): - """Initiate pose estimation metrics for YOLO model.""" - super().init_metrics(model) - self.kpt_shape = self.data["kpt_shape"] - is_pose = self.kpt_shape == [17, 3] - nkpt = self.kpt_shape[0] - self.sigma = OKS_SIGMA if is_pose else np.ones(nkpt) / nkpt - self.stats = dict(tp_p=[], tp=[], conf=[], pred_cls=[], target_cls=[]) - - def _prepare_batch(self, si, batch): - """Prepares a batch for processing by converting keypoints to float and moving to device.""" - pbatch = super()._prepare_batch(si, batch) - kpts = batch["keypoints"][batch["batch_idx"] == si] - h, w = pbatch["imgsz"] - kpts = kpts.clone() - kpts[..., 0] *= w - kpts[..., 1] *= h - kpts = ops.scale_coords(pbatch["imgsz"], kpts, pbatch["ori_shape"], ratio_pad=pbatch["ratio_pad"]) - pbatch["kpts"] = kpts - return pbatch - - def _prepare_pred(self, pred, pbatch): - """Prepares and scales keypoints in a batch for pose processing.""" - predn = super()._prepare_pred(pred, pbatch) - nk = pbatch["kpts"].shape[1] - pred_kpts = predn[:, 6:].view(len(predn), nk, -1) - ops.scale_coords(pbatch["imgsz"], pred_kpts, pbatch["ori_shape"], ratio_pad=pbatch["ratio_pad"]) - return predn, pred_kpts - - def update_metrics(self, preds, batch): - """Metrics.""" - for si, pred in enumerate(preds): - self.seen += 1 - npr = len(pred) - stat = dict( - conf=torch.zeros(0, device=self.device), - pred_cls=torch.zeros(0, device=self.device), - tp=torch.zeros(npr, self.niou, dtype=torch.bool, device=self.device), - tp_p=torch.zeros(npr, self.niou, dtype=torch.bool, device=self.device), - ) - pbatch = self._prepare_batch(si, batch) - cls, bbox = pbatch.pop("cls"), pbatch.pop("bbox") - nl = len(cls) - stat["target_cls"] = cls - if npr == 0: - if nl: - for k in self.stats.keys(): - self.stats[k].append(stat[k]) - if self.args.plots: - self.confusion_matrix.process_batch(detections=None, gt_bboxes=bbox, gt_cls=cls) - continue - - # Predictions - if self.args.single_cls: - pred[:, 5] = 0 - predn, pred_kpts = self._prepare_pred(pred, pbatch) - stat["conf"] = predn[:, 4] - stat["pred_cls"] = predn[:, 5] - - # Evaluate - if nl: - stat["tp"] = self._process_batch(predn, bbox, cls) - stat["tp_p"] = self._process_batch(predn, bbox, cls, pred_kpts, pbatch["kpts"]) - if self.args.plots: - self.confusion_matrix.process_batch(predn, bbox, cls) - - for k in self.stats.keys(): - self.stats[k].append(stat[k]) - - # Save - if self.args.save_json: - self.pred_to_json(predn, batch["im_file"][si]) - # if self.args.save_txt: - # save_one_txt(predn, save_conf, shape, file=save_dir / 'labels' / f'{path.stem}.txt') - - def _process_batch(self, detections, gt_bboxes, gt_cls, pred_kpts=None, gt_kpts=None): - """ - Return correct prediction matrix. - - Args: - detections (torch.Tensor): Tensor of shape [N, 6] representing detections. - Each detection is of the format: x1, y1, x2, y2, conf, class. - labels (torch.Tensor): Tensor of shape [M, 5] representing labels. - Each label is of the format: class, x1, y1, x2, y2. - pred_kpts (torch.Tensor, optional): Tensor of shape [N, 51] representing predicted keypoints. - 51 corresponds to 17 keypoints each with 3 values. - gt_kpts (torch.Tensor, optional): Tensor of shape [N, 51] representing ground truth keypoints. - - Returns: - torch.Tensor: Correct prediction matrix of shape [N, 10] for 10 IoU levels. - """ - if pred_kpts is not None and gt_kpts is not None: - # `0.53` is from https://github.com/jin-s13/xtcocoapi/blob/master/xtcocotools/cocoeval.py#L384 - area = ops.xyxy2xywh(gt_bboxes)[:, 2:].prod(1) * 0.53 - iou = kpt_iou(gt_kpts, pred_kpts, sigma=self.sigma, area=area) - else: # boxes - iou = box_iou(gt_bboxes, detections[:, :4]) - - return self.match_predictions(detections[:, 5], gt_cls, iou) - - def plot_val_samples(self, batch, ni): - """Plots and saves validation set samples with predicted bounding boxes and keypoints.""" - plot_images( - batch["img"], - batch["batch_idx"], - batch["cls"].squeeze(-1), - batch["bboxes"], - kpts=batch["keypoints"], - paths=batch["im_file"], - fname=self.save_dir / f"val_batch{ni}_labels.jpg", - names=self.names, - on_plot=self.on_plot, - ) - - def plot_predictions(self, batch, preds, ni): - """Plots predictions for YOLO model.""" - pred_kpts = torch.cat([p[:, 6:].view(-1, *self.kpt_shape) for p in preds], 0) - plot_images( - batch["img"], - *output_to_target(preds, max_det=self.args.max_det), - kpts=pred_kpts, - paths=batch["im_file"], - fname=self.save_dir / f"val_batch{ni}_pred.jpg", - names=self.names, - on_plot=self.on_plot, - ) # pred - - def pred_to_json(self, predn, filename): - """Converts YOLO predictions to COCO JSON format.""" - stem = Path(filename).stem - image_id = int(stem) if stem.isnumeric() else stem - box = ops.xyxy2xywh(predn[:, :4]) # xywh - box[:, :2] -= box[:, 2:] / 2 # xy center to top-left corner - for p, b in zip(predn.tolist(), box.tolist()): - self.jdict.append( - { - "image_id": image_id, - "category_id": self.class_map[int(p[5])], - "bbox": [round(x, 3) for x in b], - "keypoints": p[6:], - "score": round(p[4], 5), - } - ) - - def eval_json(self, stats): - """Evaluates object detection model using COCO JSON format.""" - if self.args.save_json and self.is_coco and len(self.jdict): - anno_json = self.data["path"] / "annotations/person_keypoints_val2017.json" # annotations - pred_json = self.save_dir / "predictions.json" # predictions - LOGGER.info(f"\nEvaluating pycocotools mAP using {pred_json} and {anno_json}...") - try: # https://github.com/cocodataset/cocoapi/blob/master/PythonAPI/pycocoEvalDemo.ipynb - check_requirements("pycocotools>=2.0.6") - from pycocotools.coco import COCO # noqa - from pycocotools.cocoeval import COCOeval # noqa - - for x in anno_json, pred_json: - assert x.is_file(), f"{x} file not found" - anno = COCO(str(anno_json)) # init annotations api - pred = anno.loadRes(str(pred_json)) # init predictions api (must pass string, not Path) - for i, eval in enumerate([COCOeval(anno, pred, "bbox"), COCOeval(anno, pred, "keypoints")]): - if self.is_coco: - eval.params.imgIds = [int(Path(x).stem) for x in self.dataloader.dataset.im_files] # im to eval - eval.evaluate() - eval.accumulate() - eval.summarize() - idx = i * 4 + 2 - stats[self.metrics.keys[idx + 1]], stats[self.metrics.keys[idx]] = eval.stats[ - :2 - ] # update mAP50-95 and mAP50 - except Exception as e: - LOGGER.warning(f"pycocotools unable to run: {e}") - return stats diff --git a/ultralytics-main/ultralytics/models/yolo/segment/__init__.py b/ultralytics-main/ultralytics/models/yolo/segment/__init__.py deleted file mode 100644 index ec1ac79..0000000 --- a/ultralytics-main/ultralytics/models/yolo/segment/__init__.py +++ /dev/null @@ -1,7 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from .predict import SegmentationPredictor -from .train import SegmentationTrainer -from .val import SegmentationValidator - -__all__ = "SegmentationPredictor", "SegmentationTrainer", "SegmentationValidator" diff --git a/ultralytics-main/ultralytics/models/yolo/segment/predict.py b/ultralytics-main/ultralytics/models/yolo/segment/predict.py deleted file mode 100644 index 9d7015f..0000000 --- a/ultralytics-main/ultralytics/models/yolo/segment/predict.py +++ /dev/null @@ -1,57 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from ultralytics.engine.results import Results -from ultralytics.models.yolo.detect.predict import DetectionPredictor -from ultralytics.utils import DEFAULT_CFG, ops - - -class SegmentationPredictor(DetectionPredictor): - """ - A class extending the DetectionPredictor class for prediction based on a segmentation model. - - Example: - ```python - from ultralytics.utils import ASSETS - from ultralytics.models.yolo.segment import SegmentationPredictor - - args = dict(model='yolov8n-seg.pt', source=ASSETS) - predictor = SegmentationPredictor(overrides=args) - predictor.predict_cli() - ``` - """ - - def __init__(self, cfg=DEFAULT_CFG, overrides=None, _callbacks=None): - """Initializes the SegmentationPredictor with the provided configuration, overrides, and callbacks.""" - super().__init__(cfg, overrides, _callbacks) - self.args.task = "segment" - - def postprocess(self, preds, img, orig_imgs): - """Applies non-max suppression and processes detections for each image in an input batch.""" - p = ops.non_max_suppression( - preds[0], - self.args.conf, - self.args.iou, - agnostic=self.args.agnostic_nms, - max_det=self.args.max_det, - nc=len(self.model.names), - classes=self.args.classes, - ) - - if not isinstance(orig_imgs, list): # input images are a torch.Tensor, not a list - orig_imgs = ops.convert_torch2numpy_batch(orig_imgs) - - results = [] - proto = preds[1][-1] if isinstance(preds[1], tuple) else preds[1] # tuple if PyTorch model or array if exported - for i, pred in enumerate(p): - orig_img = orig_imgs[i] - img_path = self.batch[0][i] - if not len(pred): # save empty boxes - masks = None - elif self.args.retina_masks: - pred[:, :4] = ops.scale_boxes(img.shape[2:], pred[:, :4], orig_img.shape) - masks = ops.process_mask_native(proto[i], pred[:, 6:], pred[:, :4], orig_img.shape[:2]) # HWC - else: - masks = ops.process_mask(proto[i], pred[:, 6:], pred[:, :4], img.shape[2:], upsample=True) # HWC - pred[:, :4] = ops.scale_boxes(img.shape[2:], pred[:, :4], orig_img.shape) - results.append(Results(orig_img, path=img_path, names=self.model.names, boxes=pred[:, :6], masks=masks)) - return results diff --git a/ultralytics-main/ultralytics/models/yolo/segment/train.py b/ultralytics-main/ultralytics/models/yolo/segment/train.py deleted file mode 100644 index 126baf2..0000000 --- a/ultralytics-main/ultralytics/models/yolo/segment/train.py +++ /dev/null @@ -1,62 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from copy import copy - -from ultralytics.models import yolo -from ultralytics.nn.tasks import SegmentationModel -from ultralytics.utils import DEFAULT_CFG, RANK -from ultralytics.utils.plotting import plot_images, plot_results - - -class SegmentationTrainer(yolo.detect.DetectionTrainer): - """ - A class extending the DetectionTrainer class for training based on a segmentation model. - - Example: - ```python - from ultralytics.models.yolo.segment import SegmentationTrainer - - args = dict(model='yolov8n-seg.pt', data='coco8-seg.yaml', epochs=3) - trainer = SegmentationTrainer(overrides=args) - trainer.train() - ``` - """ - - def __init__(self, cfg=DEFAULT_CFG, overrides=None, _callbacks=None): - """Initialize a SegmentationTrainer object with given arguments.""" - if overrides is None: - overrides = {} - overrides["task"] = "segment" - super().__init__(cfg, overrides, _callbacks) - - def get_model(self, cfg=None, weights=None, verbose=True): - """Return SegmentationModel initialized with specified config and weights.""" - model = SegmentationModel(cfg, ch=3, nc=self.data["nc"], verbose=verbose and RANK == -1) - if weights: - model.load(weights) - - return model - - def get_validator(self): - """Return an instance of SegmentationValidator for validation of YOLO model.""" - self.loss_names = "box_loss", "seg_loss", "cls_loss", "dfl_loss" - return yolo.segment.SegmentationValidator( - self.test_loader, save_dir=self.save_dir, args=copy(self.args), _callbacks=self.callbacks - ) - - def plot_training_samples(self, batch, ni): - """Creates a plot of training sample images with labels and box coordinates.""" - plot_images( - batch["img"], - batch["batch_idx"], - batch["cls"].squeeze(-1), - batch["bboxes"], - masks=batch["masks"], - paths=batch["im_file"], - fname=self.save_dir / f"train_batch{ni}.jpg", - on_plot=self.on_plot, - ) - - def plot_metrics(self): - """Plots training/val metrics.""" - plot_results(file=self.csv, segment=True, on_plot=self.on_plot) # save results.png diff --git a/ultralytics-main/ultralytics/models/yolo/segment/val.py b/ultralytics-main/ultralytics/models/yolo/segment/val.py deleted file mode 100644 index 94757c4..0000000 --- a/ultralytics-main/ultralytics/models/yolo/segment/val.py +++ /dev/null @@ -1,277 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from multiprocessing.pool import ThreadPool -from pathlib import Path - -import numpy as np -import torch -import torch.nn.functional as F - -from ultralytics.models.yolo.detect import DetectionValidator -from ultralytics.utils import LOGGER, NUM_THREADS, ops -from ultralytics.utils.checks import check_requirements -from ultralytics.utils.metrics import SegmentMetrics, box_iou, mask_iou -from ultralytics.utils.plotting import output_to_target, plot_images - - -class SegmentationValidator(DetectionValidator): - """ - A class extending the DetectionValidator class for validation based on a segmentation model. - - Example: - ```python - from ultralytics.models.yolo.segment import SegmentationValidator - - args = dict(model='yolov8n-seg.pt', data='coco8-seg.yaml') - validator = SegmentationValidator(args=args) - validator() - ``` - """ - - def __init__(self, dataloader=None, save_dir=None, pbar=None, args=None, _callbacks=None): - """Initialize SegmentationValidator and set task to 'segment', metrics to SegmentMetrics.""" - super().__init__(dataloader, save_dir, pbar, args, _callbacks) - self.plot_masks = None - self.process = None - self.args.task = "segment" - self.metrics = SegmentMetrics(save_dir=self.save_dir, on_plot=self.on_plot) - - def preprocess(self, batch): - """Preprocesses batch by converting masks to float and sending to device.""" - batch = super().preprocess(batch) - batch["masks"] = batch["masks"].to(self.device).float() - return batch - - def init_metrics(self, model): - """Initialize metrics and select mask processing function based on save_json flag.""" - super().init_metrics(model) - self.plot_masks = [] - if self.args.save_json: - check_requirements("pycocotools>=2.0.6") - self.process = ops.process_mask_upsample # more accurate - else: - self.process = ops.process_mask # faster - self.stats = dict(tp_m=[], tp=[], conf=[], pred_cls=[], target_cls=[]) - - def get_desc(self): - """Return a formatted description of evaluation metrics.""" - return ("%22s" + "%11s" * 10) % ( - "Class", - "Images", - "Instances", - "Box(P", - "R", - "mAP50", - "mAP50-95)", - "Mask(P", - "R", - "mAP50", - "mAP50-95)", - ) - - def postprocess(self, preds): - """Post-processes YOLO predictions and returns output detections with proto.""" - p = ops.non_max_suppression( - preds[0], - self.args.conf, - self.args.iou, - labels=self.lb, - multi_label=True, - agnostic=self.args.single_cls, - max_det=self.args.max_det, - nc=self.nc, - ) - proto = preds[1][-1] if len(preds[1]) == 3 else preds[1] # second output is len 3 if pt, but only 1 if exported - return p, proto - - def _prepare_batch(self, si, batch): - """Prepares a batch for training or inference by processing images and targets.""" - prepared_batch = super()._prepare_batch(si, batch) - midx = [si] if self.args.overlap_mask else batch["batch_idx"] == si - prepared_batch["masks"] = batch["masks"][midx] - return prepared_batch - - def _prepare_pred(self, pred, pbatch, proto): - """Prepares a batch for training or inference by processing images and targets.""" - predn = super()._prepare_pred(pred, pbatch) - pred_masks = self.process(proto, pred[:, 6:], pred[:, :4], shape=pbatch["imgsz"]) - return predn, pred_masks - - def update_metrics(self, preds, batch): - """Metrics.""" - for si, (pred, proto) in enumerate(zip(preds[0], preds[1])): - self.seen += 1 - npr = len(pred) - stat = dict( - conf=torch.zeros(0, device=self.device), - pred_cls=torch.zeros(0, device=self.device), - tp=torch.zeros(npr, self.niou, dtype=torch.bool, device=self.device), - tp_m=torch.zeros(npr, self.niou, dtype=torch.bool, device=self.device), - ) - pbatch = self._prepare_batch(si, batch) - cls, bbox = pbatch.pop("cls"), pbatch.pop("bbox") - nl = len(cls) - stat["target_cls"] = cls - if npr == 0: - if nl: - for k in self.stats.keys(): - self.stats[k].append(stat[k]) - if self.args.plots: - self.confusion_matrix.process_batch(detections=None, gt_bboxes=bbox, gt_cls=cls) - continue - - # Masks - gt_masks = pbatch.pop("masks") - # Predictions - if self.args.single_cls: - pred[:, 5] = 0 - predn, pred_masks = self._prepare_pred(pred, pbatch, proto) - stat["conf"] = predn[:, 4] - stat["pred_cls"] = predn[:, 5] - - # Evaluate - if nl: - stat["tp"] = self._process_batch(predn, bbox, cls) - stat["tp_m"] = self._process_batch( - predn, bbox, cls, pred_masks, gt_masks, self.args.overlap_mask, masks=True - ) - if self.args.plots: - self.confusion_matrix.process_batch(predn, bbox, cls) - - for k in self.stats.keys(): - self.stats[k].append(stat[k]) - - pred_masks = torch.as_tensor(pred_masks, dtype=torch.uint8) - if self.args.plots and self.batch_i < 3: - self.plot_masks.append(pred_masks[:15].cpu()) # filter top 15 to plot - - # Save - if self.args.save_json: - pred_masks = ops.scale_image( - pred_masks.permute(1, 2, 0).contiguous().cpu().numpy(), - pbatch["ori_shape"], - ratio_pad=batch["ratio_pad"][si], - ) - self.pred_to_json(predn, batch["im_file"][si], pred_masks) - # if self.args.save_txt: - # save_one_txt(predn, save_conf, shape, file=save_dir / 'labels' / f'{path.stem}.txt') - - def finalize_metrics(self, *args, **kwargs): - """Sets speed and confusion matrix for evaluation metrics.""" - self.metrics.speed = self.speed - self.metrics.confusion_matrix = self.confusion_matrix - - def _process_batch(self, detections, gt_bboxes, gt_cls, pred_masks=None, gt_masks=None, overlap=False, masks=False): - """ - Return correct prediction matrix. - - Args: - detections (array[N, 6]), x1, y1, x2, y2, conf, class - labels (array[M, 5]), class, x1, y1, x2, y2 - - Returns: - correct (array[N, 10]), for 10 IoU levels - """ - if masks: - if overlap: - nl = len(gt_cls) - index = torch.arange(nl, device=gt_masks.device).view(nl, 1, 1) + 1 - gt_masks = gt_masks.repeat(nl, 1, 1) # shape(1,640,640) -> (n,640,640) - gt_masks = torch.where(gt_masks == index, 1.0, 0.0) - if gt_masks.shape[1:] != pred_masks.shape[1:]: - gt_masks = F.interpolate(gt_masks[None], pred_masks.shape[1:], mode="bilinear", align_corners=False)[0] - gt_masks = gt_masks.gt_(0.5) - iou = mask_iou(gt_masks.view(gt_masks.shape[0], -1), pred_masks.view(pred_masks.shape[0], -1)) - else: # boxes - iou = box_iou(gt_bboxes, detections[:, :4]) - - return self.match_predictions(detections[:, 5], gt_cls, iou) - - def plot_val_samples(self, batch, ni): - """Plots validation samples with bounding box labels.""" - plot_images( - batch["img"], - batch["batch_idx"], - batch["cls"].squeeze(-1), - batch["bboxes"], - masks=batch["masks"], - paths=batch["im_file"], - fname=self.save_dir / f"val_batch{ni}_labels.jpg", - names=self.names, - on_plot=self.on_plot, - ) - - def plot_predictions(self, batch, preds, ni): - """Plots batch predictions with masks and bounding boxes.""" - plot_images( - batch["img"], - *output_to_target(preds[0], max_det=15), # not set to self.args.max_det due to slow plotting speed - torch.cat(self.plot_masks, dim=0) if len(self.plot_masks) else self.plot_masks, - paths=batch["im_file"], - fname=self.save_dir / f"val_batch{ni}_pred.jpg", - names=self.names, - on_plot=self.on_plot, - ) # pred - self.plot_masks.clear() - - def pred_to_json(self, predn, filename, pred_masks): - """ - Save one JSON result. - - Examples: - >>> result = {"image_id": 42, "category_id": 18, "bbox": [258.15, 41.29, 348.26, 243.78], "score": 0.236} - """ - from pycocotools.mask import encode # noqa - - def single_encode(x): - """Encode predicted masks as RLE and append results to jdict.""" - rle = encode(np.asarray(x[:, :, None], order="F", dtype="uint8"))[0] - rle["counts"] = rle["counts"].decode("utf-8") - return rle - - stem = Path(filename).stem - image_id = int(stem) if stem.isnumeric() else stem - box = ops.xyxy2xywh(predn[:, :4]) # xywh - box[:, :2] -= box[:, 2:] / 2 # xy center to top-left corner - pred_masks = np.transpose(pred_masks, (2, 0, 1)) - with ThreadPool(NUM_THREADS) as pool: - rles = pool.map(single_encode, pred_masks) - for i, (p, b) in enumerate(zip(predn.tolist(), box.tolist())): - self.jdict.append( - { - "image_id": image_id, - "category_id": self.class_map[int(p[5])], - "bbox": [round(x, 3) for x in b], - "score": round(p[4], 5), - "segmentation": rles[i], - } - ) - - def eval_json(self, stats): - """Return COCO-style object detection evaluation metrics.""" - if self.args.save_json and self.is_coco and len(self.jdict): - anno_json = self.data["path"] / "annotations/instances_val2017.json" # annotations - pred_json = self.save_dir / "predictions.json" # predictions - LOGGER.info(f"\nEvaluating pycocotools mAP using {pred_json} and {anno_json}...") - try: # https://github.com/cocodataset/cocoapi/blob/master/PythonAPI/pycocoEvalDemo.ipynb - check_requirements("pycocotools>=2.0.6") - from pycocotools.coco import COCO # noqa - from pycocotools.cocoeval import COCOeval # noqa - - for x in anno_json, pred_json: - assert x.is_file(), f"{x} file not found" - anno = COCO(str(anno_json)) # init annotations api - pred = anno.loadRes(str(pred_json)) # init predictions api (must pass string, not Path) - for i, eval in enumerate([COCOeval(anno, pred, "bbox"), COCOeval(anno, pred, "segm")]): - if self.is_coco: - eval.params.imgIds = [int(Path(x).stem) for x in self.dataloader.dataset.im_files] # im to eval - eval.evaluate() - eval.accumulate() - eval.summarize() - idx = i * 4 + 2 - stats[self.metrics.keys[idx + 1]], stats[self.metrics.keys[idx]] = eval.stats[ - :2 - ] # update mAP50-95 and mAP50 - except Exception as e: - LOGGER.warning(f"pycocotools unable to run: {e}") - return stats diff --git a/ultralytics-main/ultralytics/nn/__init__.py b/ultralytics-main/ultralytics/nn/__init__.py deleted file mode 100644 index 6905d34..0000000 --- a/ultralytics-main/ultralytics/nn/__init__.py +++ /dev/null @@ -1,29 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from .tasks import ( - BaseModel, - ClassificationModel, - DetectionModel, - SegmentationModel, - attempt_load_one_weight, - attempt_load_weights, - guess_model_scale, - guess_model_task, - parse_model, - torch_safe_load, - yaml_model_load, -) - -__all__ = ( - "attempt_load_one_weight", - "attempt_load_weights", - "parse_model", - "yaml_model_load", - "guess_model_task", - "guess_model_scale", - "torch_safe_load", - "DetectionModel", - "SegmentationModel", - "ClassificationModel", - "BaseModel", -) diff --git a/ultralytics-main/ultralytics/nn/autobackend.py b/ultralytics-main/ultralytics/nn/autobackend.py deleted file mode 100644 index bebfdbe..0000000 --- a/ultralytics-main/ultralytics/nn/autobackend.py +++ /dev/null @@ -1,628 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import ast -import contextlib -import json -import platform -import zipfile -from collections import OrderedDict, namedtuple -from pathlib import Path - -import cv2 -import numpy as np -import torch -import torch.nn as nn -from PIL import Image - -from ultralytics.utils import ARM64, LINUX, LOGGER, ROOT, yaml_load -from ultralytics.utils.checks import check_requirements, check_suffix, check_version, check_yaml -from ultralytics.utils.downloads import attempt_download_asset, is_url - - -def check_class_names(names): - """ - Check class names. - - Map imagenet class codes to human-readable names if required. Convert lists to dicts. - """ - if isinstance(names, list): # names is a list - names = dict(enumerate(names)) # convert to dict - if isinstance(names, dict): - # Convert 1) string keys to int, i.e. '0' to 0, and non-string values to strings, i.e. True to 'True' - names = {int(k): str(v) for k, v in names.items()} - n = len(names) - if max(names.keys()) >= n: - raise KeyError( - f"{n}-class dataset requires class indices 0-{n - 1}, but you have invalid class indices " - f"{min(names.keys())}-{max(names.keys())} defined in your dataset YAML." - ) - if isinstance(names[0], str) and names[0].startswith("n0"): # imagenet class codes, i.e. 'n01440764' - names_map = yaml_load(ROOT / "cfg/datasets/ImageNet.yaml")["map"] # human-readable names - names = {k: names_map[v] for k, v in names.items()} - return names - - -def default_class_names(data=None): - """Applies default class names to an input YAML file or returns numerical class names.""" - if data: - with contextlib.suppress(Exception): - return yaml_load(check_yaml(data))["names"] - return {i: f"class{i}" for i in range(999)} # return default if above errors - - -class AutoBackend(nn.Module): - """ - Handles dynamic backend selection for running inference using Ultralytics YOLO models. - - The AutoBackend class is designed to provide an abstraction layer for various inference engines. It supports a wide - range of formats, each with specific naming conventions as outlined below: - - Supported Formats and Naming Conventions: - | Format | File Suffix | - |-----------------------|------------------| - | PyTorch | *.pt | - | TorchScript | *.torchscript | - | ONNX Runtime | *.onnx | - | ONNX OpenCV DNN | *.onnx (dnn=True)| - | OpenVINO | *openvino_model/ | - | CoreML | *.mlpackage | - | TensorRT | *.engine | - | TensorFlow SavedModel | *_saved_model | - | TensorFlow GraphDef | *.pb | - | TensorFlow Lite | *.tflite | - | TensorFlow Edge TPU | *_edgetpu.tflite | - | PaddlePaddle | *_paddle_model | - | NCNN | *_ncnn_model | - - This class offers dynamic backend switching capabilities based on the input model format, making it easier to deploy - models across various platforms. - """ - - @torch.no_grad() - def __init__( - self, - weights="yolov8n.pt", - device=torch.device("cpu"), - dnn=False, - data=None, - fp16=False, - batch=1, - fuse=True, - verbose=True, - ): - """ - Initialize the AutoBackend for inference. - - Args: - weights (str): Path to the model weights file. Defaults to 'yolov8n.pt'. - device (torch.device): Device to run the model on. Defaults to CPU. - dnn (bool): Use OpenCV DNN module for ONNX inference. Defaults to False. - data (str | Path | optional): Path to the additional data.yaml file containing class names. Optional. - fp16 (bool): Enable half-precision inference. Supported only on specific backends. Defaults to False. - batch (int): Batch-size to assume for inference. - fuse (bool): Fuse Conv2D + BatchNorm layers for optimization. Defaults to True. - verbose (bool): Enable verbose logging. Defaults to True. - """ - super().__init__() - w = str(weights[0] if isinstance(weights, list) else weights) - nn_module = isinstance(weights, torch.nn.Module) - ( - pt, - jit, - onnx, - xml, - engine, - coreml, - saved_model, - pb, - tflite, - edgetpu, - tfjs, - paddle, - ncnn, - triton, - ) = self._model_type(w) - fp16 &= pt or jit or onnx or xml or engine or nn_module or triton # FP16 - nhwc = coreml or saved_model or pb or tflite or edgetpu # BHWC formats (vs torch BCWH) - stride = 32 # default stride - model, metadata = None, None - - # Set device - cuda = torch.cuda.is_available() and device.type != "cpu" # use CUDA - if cuda and not any([nn_module, pt, jit, engine, onnx]): # GPU dataloader formats - device = torch.device("cpu") - cuda = False - - # Download if not local - if not (pt or triton or nn_module): - w = attempt_download_asset(w) - - # In-memory PyTorch model - if nn_module: - model = weights.to(device) - model = model.fuse(verbose=verbose) if fuse else model - if hasattr(model, "kpt_shape"): - kpt_shape = model.kpt_shape # pose-only - stride = max(int(model.stride.max()), 32) # model stride - names = model.module.names if hasattr(model, "module") else model.names # get class names - model.half() if fp16 else model.float() - self.model = model # explicitly assign for to(), cpu(), cuda(), half() - pt = True - - # PyTorch - elif pt: - from ultralytics.nn.tasks import attempt_load_weights - - model = attempt_load_weights( - weights if isinstance(weights, list) else w, device=device, inplace=True, fuse=fuse - ) - if hasattr(model, "kpt_shape"): - kpt_shape = model.kpt_shape # pose-only - stride = max(int(model.stride.max()), 32) # model stride - names = model.module.names if hasattr(model, "module") else model.names # get class names - model.half() if fp16 else model.float() - self.model = model # explicitly assign for to(), cpu(), cuda(), half() - - # TorchScript - elif jit: - LOGGER.info(f"Loading {w} for TorchScript inference...") - extra_files = {"config.txt": ""} # model metadata - model = torch.jit.load(w, _extra_files=extra_files, map_location=device) - model.half() if fp16 else model.float() - if extra_files["config.txt"]: # load metadata dict - metadata = json.loads(extra_files["config.txt"], object_hook=lambda x: dict(x.items())) - - # ONNX OpenCV DNN - elif dnn: - LOGGER.info(f"Loading {w} for ONNX OpenCV DNN inference...") - check_requirements("opencv-python>=4.5.4") - net = cv2.dnn.readNetFromONNX(w) - - # ONNX Runtime - elif onnx: - LOGGER.info(f"Loading {w} for ONNX Runtime inference...") - check_requirements(("onnx", "onnxruntime-gpu" if cuda else "onnxruntime")) - import onnxruntime - - providers = ["CUDAExecutionProvider", "CPUExecutionProvider"] if cuda else ["CPUExecutionProvider"] - session = onnxruntime.InferenceSession(w, providers=providers) - output_names = [x.name for x in session.get_outputs()] - metadata = session.get_modelmeta().custom_metadata_map - - # OpenVINO - elif xml: - LOGGER.info(f"Loading {w} for OpenVINO inference...") - check_requirements("openvino>=2024.0.0") - import openvino as ov - - core = ov.Core() - w = Path(w) - if not w.is_file(): # if not *.xml - w = next(w.glob("*.xml")) # get *.xml file from *_openvino_model dir - ov_model = core.read_model(model=str(w), weights=w.with_suffix(".bin")) - if ov_model.get_parameters()[0].get_layout().empty: - ov_model.get_parameters()[0].set_layout(ov.Layout("NCHW")) - batch_dim = ov.get_batch(ov_model) - if batch_dim.is_static: - batch_size = batch_dim.get_length() - - # OpenVINO inference modes are 'LATENCY', 'THROUGHPUT' (not recommended), or 'CUMULATIVE_THROUGHPUT' - inference_mode = "CUMULATIVE_THROUGHPUT" if batch > 1 else "LATENCY" - LOGGER.info(f"Using OpenVINO {inference_mode} mode for batch-size={batch_size} inference...") - ov_compiled_model = core.compile_model( - ov_model, - device_name="AUTO", # AUTO selects best available device, do not modify - config={"PERFORMANCE_HINT": inference_mode}, - ) - input_name = ov_compiled_model.input().get_any_name() - metadata = w.parent / "metadata.yaml" - - # TensorRT - elif engine: - LOGGER.info(f"Loading {w} for TensorRT inference...") - try: - import tensorrt as trt # noqa https://developer.nvidia.com/nvidia-tensorrt-download - except ImportError: - if LINUX: - check_requirements("nvidia-tensorrt", cmds="-U --index-url https://pypi.ngc.nvidia.com") - import tensorrt as trt # noqa - check_version(trt.__version__, "7.0.0", hard=True) # require tensorrt>=7.0.0 - if device.type == "cpu": - device = torch.device("cuda:0") - Binding = namedtuple("Binding", ("name", "dtype", "shape", "data", "ptr")) - logger = trt.Logger(trt.Logger.INFO) - # Read file - with open(w, "rb") as f, trt.Runtime(logger) as runtime: - meta_len = int.from_bytes(f.read(4), byteorder="little") # read metadata length - metadata = json.loads(f.read(meta_len).decode("utf-8")) # read metadata - model = runtime.deserialize_cuda_engine(f.read()) # read engine - context = model.create_execution_context() - bindings = OrderedDict() - output_names = [] - fp16 = False # default updated below - dynamic = False - for i in range(model.num_bindings): - name = model.get_binding_name(i) - dtype = trt.nptype(model.get_binding_dtype(i)) - if model.binding_is_input(i): - if -1 in tuple(model.get_binding_shape(i)): # dynamic - dynamic = True - context.set_binding_shape(i, tuple(model.get_profile_shape(0, i)[2])) - if dtype == np.float16: - fp16 = True - else: # output - output_names.append(name) - shape = tuple(context.get_binding_shape(i)) - im = torch.from_numpy(np.empty(shape, dtype=dtype)).to(device) - bindings[name] = Binding(name, dtype, shape, im, int(im.data_ptr())) - binding_addrs = OrderedDict((n, d.ptr) for n, d in bindings.items()) - batch_size = bindings["images"].shape[0] # if dynamic, this is instead max batch size - - # CoreML - elif coreml: - LOGGER.info(f"Loading {w} for CoreML inference...") - import coremltools as ct - - model = ct.models.MLModel(w) - metadata = dict(model.user_defined_metadata) - - # TF SavedModel - elif saved_model: - LOGGER.info(f"Loading {w} for TensorFlow SavedModel inference...") - import tensorflow as tf - - keras = False # assume TF1 saved_model - model = tf.keras.models.load_model(w) if keras else tf.saved_model.load(w) - metadata = Path(w) / "metadata.yaml" - - # TF GraphDef - elif pb: # https://www.tensorflow.org/guide/migrate#a_graphpb_or_graphpbtxt - LOGGER.info(f"Loading {w} for TensorFlow GraphDef inference...") - import tensorflow as tf - - from ultralytics.engine.exporter import gd_outputs - - def wrap_frozen_graph(gd, inputs, outputs): - """Wrap frozen graphs for deployment.""" - x = tf.compat.v1.wrap_function(lambda: tf.compat.v1.import_graph_def(gd, name=""), []) # wrapped - ge = x.graph.as_graph_element - return x.prune(tf.nest.map_structure(ge, inputs), tf.nest.map_structure(ge, outputs)) - - gd = tf.Graph().as_graph_def() # TF GraphDef - with open(w, "rb") as f: - gd.ParseFromString(f.read()) - frozen_func = wrap_frozen_graph(gd, inputs="x:0", outputs=gd_outputs(gd)) - - # TFLite or TFLite Edge TPU - elif tflite or edgetpu: # https://www.tensorflow.org/lite/guide/python#install_tensorflow_lite_for_python - try: # https://coral.ai/docs/edgetpu/tflite-python/#update-existing-tf-lite-code-for-the-edge-tpu - from tflite_runtime.interpreter import Interpreter, load_delegate - except ImportError: - import tensorflow as tf - - Interpreter, load_delegate = tf.lite.Interpreter, tf.lite.experimental.load_delegate - if edgetpu: # TF Edge TPU https://coral.ai/software/#edgetpu-runtime - LOGGER.info(f"Loading {w} for TensorFlow Lite Edge TPU inference...") - delegate = {"Linux": "libedgetpu.so.1", "Darwin": "libedgetpu.1.dylib", "Windows": "edgetpu.dll"}[ - platform.system() - ] - interpreter = Interpreter(model_path=w, experimental_delegates=[load_delegate(delegate)]) - else: # TFLite - LOGGER.info(f"Loading {w} for TensorFlow Lite inference...") - interpreter = Interpreter(model_path=w) # load TFLite model - interpreter.allocate_tensors() # allocate - input_details = interpreter.get_input_details() # inputs - output_details = interpreter.get_output_details() # outputs - # Load metadata - with contextlib.suppress(zipfile.BadZipFile): - with zipfile.ZipFile(w, "r") as model: - meta_file = model.namelist()[0] - metadata = ast.literal_eval(model.read(meta_file).decode("utf-8")) - - # TF.js - elif tfjs: - raise NotImplementedError("YOLOv8 TF.js inference is not currently supported.") - - # PaddlePaddle - elif paddle: - LOGGER.info(f"Loading {w} for PaddlePaddle inference...") - check_requirements("paddlepaddle-gpu" if cuda else "paddlepaddle") - import paddle.inference as pdi # noqa - - w = Path(w) - if not w.is_file(): # if not *.pdmodel - w = next(w.rglob("*.pdmodel")) # get *.pdmodel file from *_paddle_model dir - config = pdi.Config(str(w), str(w.with_suffix(".pdiparams"))) - if cuda: - config.enable_use_gpu(memory_pool_init_size_mb=2048, device_id=0) - predictor = pdi.create_predictor(config) - input_handle = predictor.get_input_handle(predictor.get_input_names()[0]) - output_names = predictor.get_output_names() - metadata = w.parents[1] / "metadata.yaml" - - # NCNN - elif ncnn: - LOGGER.info(f"Loading {w} for NCNN inference...") - check_requirements("git+https://github.com/Tencent/ncnn.git" if ARM64 else "ncnn") # requires NCNN - import ncnn as pyncnn - - net = pyncnn.Net() - net.opt.use_vulkan_compute = cuda - w = Path(w) - if not w.is_file(): # if not *.param - w = next(w.glob("*.param")) # get *.param file from *_ncnn_model dir - net.load_param(str(w)) - net.load_model(str(w.with_suffix(".bin"))) - metadata = w.parent / "metadata.yaml" - - # NVIDIA Triton Inference Server - elif triton: - check_requirements("tritonclient[all]") - from ultralytics.utils.triton import TritonRemoteModel - - model = TritonRemoteModel(w) - - # Any other format (unsupported) - else: - from ultralytics.engine.exporter import export_formats - - raise TypeError( - f"model='{w}' is not a supported model format. " - f"See https://docs.ultralytics.com/modes/predict for help.\n\n{export_formats()}" - ) - - # Load external metadata YAML - if isinstance(metadata, (str, Path)) and Path(metadata).exists(): - metadata = yaml_load(metadata) - if metadata: - for k, v in metadata.items(): - if k in ("stride", "batch"): - metadata[k] = int(v) - elif k in ("imgsz", "names", "kpt_shape") and isinstance(v, str): - metadata[k] = eval(v) - stride = metadata["stride"] - task = metadata["task"] - batch = metadata["batch"] - imgsz = metadata["imgsz"] - names = metadata["names"] - kpt_shape = metadata.get("kpt_shape") - elif not (pt or triton or nn_module): - LOGGER.warning(f"WARNING ⚠️ Metadata not found for 'model={weights}'") - - # Check names - if "names" not in locals(): # names missing - names = default_class_names(data) - names = check_class_names(names) - - # Disable gradients - if pt: - for p in model.parameters(): - p.requires_grad = False - - self.__dict__.update(locals()) # assign all variables to self - - def forward(self, im, augment=False, visualize=False, embed=None): - """ - Runs inference on the YOLOv8 MultiBackend model. - - Args: - im (torch.Tensor): The image tensor to perform inference on. - augment (bool): whether to perform data augmentation during inference, defaults to False - visualize (bool): whether to visualize the output predictions, defaults to False - embed (list, optional): A list of feature vectors/embeddings to return. - - Returns: - (tuple): Tuple containing the raw output tensor, and processed output for visualization (if visualize=True) - """ - b, ch, h, w = im.shape # batch, channel, height, width - if self.fp16 and im.dtype != torch.float16: - im = im.half() # to FP16 - if self.nhwc: - im = im.permute(0, 2, 3, 1) # torch BCHW to numpy BHWC shape(1,320,192,3) - - # PyTorch - if self.pt or self.nn_module: - y = self.model(im, augment=augment, visualize=visualize, embed=embed) - - # TorchScript - elif self.jit: - y = self.model(im) - - # ONNX OpenCV DNN - elif self.dnn: - im = im.cpu().numpy() # torch to numpy - self.net.setInput(im) - y = self.net.forward() - - # ONNX Runtime - elif self.onnx: - im = im.cpu().numpy() # torch to numpy - y = self.session.run(self.output_names, {self.session.get_inputs()[0].name: im}) - - # OpenVINO - elif self.xml: - im = im.cpu().numpy() # FP32 - - if self.inference_mode in {"THROUGHPUT", "CUMULATIVE_THROUGHPUT"}: # optimized for larger batch-sizes - n = im.shape[0] # number of images in batch - results = [None] * n # preallocate list with None to match the number of images - - def callback(request, userdata): - """Places result in preallocated list using userdata index.""" - results[userdata] = request.results - - # Create AsyncInferQueue, set the callback and start asynchronous inference for each input image - async_queue = self.ov.runtime.AsyncInferQueue(self.ov_compiled_model) - async_queue.set_callback(callback) - for i in range(n): - # Start async inference with userdata=i to specify the position in results list - async_queue.start_async(inputs={self.input_name: im[i : i + 1]}, userdata=i) # keep image as BCHW - async_queue.wait_all() # wait for all inference requests to complete - y = np.concatenate([list(r.values())[0] for r in results]) - - else: # inference_mode = "LATENCY", optimized for fastest first result at batch-size 1 - y = list(self.ov_compiled_model(im).values()) - - # TensorRT - elif self.engine: - if self.dynamic and im.shape != self.bindings["images"].shape: - i = self.model.get_binding_index("images") - self.context.set_binding_shape(i, im.shape) # reshape if dynamic - self.bindings["images"] = self.bindings["images"]._replace(shape=im.shape) - for name in self.output_names: - i = self.model.get_binding_index(name) - self.bindings[name].data.resize_(tuple(self.context.get_binding_shape(i))) - s = self.bindings["images"].shape - assert im.shape == s, f"input size {im.shape} {'>' if self.dynamic else 'not equal to'} max model size {s}" - self.binding_addrs["images"] = int(im.data_ptr()) - self.context.execute_v2(list(self.binding_addrs.values())) - y = [self.bindings[x].data for x in sorted(self.output_names)] - - # CoreML - elif self.coreml: - im = im[0].cpu().numpy() - im_pil = Image.fromarray((im * 255).astype("uint8")) - # im = im.resize((192, 320), Image.BILINEAR) - y = self.model.predict({"image": im_pil}) # coordinates are xywh normalized - if "confidence" in y: - raise TypeError( - "Ultralytics only supports inference of non-pipelined CoreML models exported with " - f"'nms=False', but 'model={w}' has an NMS pipeline created by an 'nms=True' export." - ) - # TODO: CoreML NMS inference handling - # from ultralytics.utils.ops import xywh2xyxy - # box = xywh2xyxy(y['coordinates'] * [[w, h, w, h]]) # xyxy pixels - # conf, cls = y['confidence'].max(1), y['confidence'].argmax(1).astype(np.float32) - # y = np.concatenate((box, conf.reshape(-1, 1), cls.reshape(-1, 1)), 1) - elif len(y) == 1: # classification model - y = list(y.values()) - elif len(y) == 2: # segmentation model - y = list(reversed(y.values())) # reversed for segmentation models (pred, proto) - - # PaddlePaddle - elif self.paddle: - im = im.cpu().numpy().astype(np.float32) - self.input_handle.copy_from_cpu(im) - self.predictor.run() - y = [self.predictor.get_output_handle(x).copy_to_cpu() for x in self.output_names] - - # NCNN - elif self.ncnn: - mat_in = self.pyncnn.Mat(im[0].cpu().numpy()) - ex = self.net.create_extractor() - input_names, output_names = self.net.input_names(), self.net.output_names() - ex.input(input_names[0], mat_in) - y = [] - for output_name in output_names: - mat_out = self.pyncnn.Mat() - ex.extract(output_name, mat_out) - y.append(np.array(mat_out)[None]) - - # NVIDIA Triton Inference Server - elif self.triton: - im = im.cpu().numpy() # torch to numpy - y = self.model(im) - - # TensorFlow (SavedModel, GraphDef, Lite, Edge TPU) - else: - im = im.cpu().numpy() - if self.saved_model: # SavedModel - y = self.model(im, training=False) if self.keras else self.model(im) - if not isinstance(y, list): - y = [y] - elif self.pb: # GraphDef - y = self.frozen_func(x=self.tf.constant(im)) - if len(y) == 2 and len(self.names) == 999: # segments and names not defined - ip, ib = (0, 1) if len(y[0].shape) == 4 else (1, 0) # index of protos, boxes - nc = y[ib].shape[1] - y[ip].shape[3] - 4 # y = (1, 160, 160, 32), (1, 116, 8400) - self.names = {i: f"class{i}" for i in range(nc)} - else: # Lite or Edge TPU - details = self.input_details[0] - integer = details["dtype"] in (np.int8, np.int16) # is TFLite quantized int8 or int16 model - if integer: - scale, zero_point = details["quantization"] - im = (im / scale + zero_point).astype(details["dtype"]) # de-scale - self.interpreter.set_tensor(details["index"], im) - self.interpreter.invoke() - y = [] - for output in self.output_details: - x = self.interpreter.get_tensor(output["index"]) - if integer: - scale, zero_point = output["quantization"] - x = (x.astype(np.float32) - zero_point) * scale # re-scale - if x.ndim > 2: # if task is not classification - # Denormalize xywh by image size. See https://github.com/ultralytics/ultralytics/pull/1695 - # xywh are normalized in TFLite/EdgeTPU to mitigate quantization error of integer models - x[:, [0, 2]] *= w - x[:, [1, 3]] *= h - y.append(x) - # TF segment fixes: export is reversed vs ONNX export and protos are transposed - if len(y) == 2: # segment with (det, proto) output order reversed - if len(y[1].shape) != 4: - y = list(reversed(y)) # should be y = (1, 116, 8400), (1, 160, 160, 32) - y[1] = np.transpose(y[1], (0, 3, 1, 2)) # should be y = (1, 116, 8400), (1, 32, 160, 160) - y = [x if isinstance(x, np.ndarray) else x.numpy() for x in y] - - # for x in y: - # print(type(x), len(x)) if isinstance(x, (list, tuple)) else print(type(x), x.shape) # debug shapes - if isinstance(y, (list, tuple)): - return self.from_numpy(y[0]) if len(y) == 1 else [self.from_numpy(x) for x in y] - else: - return self.from_numpy(y) - - def from_numpy(self, x): - """ - Convert a numpy array to a tensor. - - Args: - x (np.ndarray): The array to be converted. - - Returns: - (torch.Tensor): The converted tensor - """ - return torch.tensor(x).to(self.device) if isinstance(x, np.ndarray) else x - - def warmup(self, imgsz=(1, 3, 640, 640)): - """ - Warm up the model by running one forward pass with a dummy input. - - Args: - imgsz (tuple): The shape of the dummy input tensor in the format (batch_size, channels, height, width) - """ - warmup_types = self.pt, self.jit, self.onnx, self.engine, self.saved_model, self.pb, self.triton, self.nn_module - if any(warmup_types) and (self.device.type != "cpu" or self.triton): - im = torch.empty(*imgsz, dtype=torch.half if self.fp16 else torch.float, device=self.device) # input - for _ in range(2 if self.jit else 1): - self.forward(im) # warmup - - @staticmethod - def _model_type(p="path/to/model.pt"): - """ - This function takes a path to a model file and returns the model type. Possibles types are pt, jit, onnx, xml, - engine, coreml, saved_model, pb, tflite, edgetpu, tfjs, ncnn or paddle. - - Args: - p: path to the model file. Defaults to path/to/model.pt - - Examples: - >>> model = AutoBackend(weights="path/to/model.onnx") - >>> model_type = model._model_type() # returns "onnx" - """ - from ultralytics.engine.exporter import export_formats - - sf = list(export_formats().Suffix) # export suffixes - if not is_url(p, check=False) and not isinstance(p, str): - check_suffix(p, sf) # checks - name = Path(p).name - types = [s in name for s in sf] - types[5] |= name.endswith(".mlmodel") # retain support for older Apple CoreML *.mlmodel formats - types[8] &= not types[9] # tflite &= not edgetpu - if any(types): - triton = False - else: - from urllib.parse import urlsplit - - url = urlsplit(p) - triton = bool(url.netloc) and bool(url.path) and url.scheme in {"http", "grpc"} - - return types + [triton] diff --git a/ultralytics-main/ultralytics/nn/modules/__init__.py b/ultralytics-main/ultralytics/nn/modules/__init__.py deleted file mode 100644 index d785c00..0000000 --- a/ultralytics-main/ultralytics/nn/modules/__init__.py +++ /dev/null @@ -1,138 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -""" -Ultralytics modules. - -Example: - Visualize a module with Netron. - ```python - from ultralytics.nn.modules import * - import torch - import os - - x = torch.ones(1, 128, 40, 40) - m = Conv(128, 128) - f = f'{m._get_name()}.onnx' - torch.onnx.export(m, x, f) - os.system(f'onnxsim {f} {f} && open {f}') - ``` -""" - -from .block import ( - C1, - C2, - C3, - C3TR, - DFL, - SPP, - SPPF, - Bottleneck, - BottleneckCSP, - C2f, - C2fAttn, - ImagePoolingAttn, - C3Ghost, - C3x, - GhostBottleneck, - HGBlock, - HGStem, - Proto, - RepC3, - ResNetLayer, - ContrastiveHead, - BNContrastiveHead, - RepNCSPELAN4, - ADown, - SPPELAN, - CBFuse, - CBLinear, - Silence, -) -from .conv import ( - CBAM, - ChannelAttention, - Concat, - Conv, - Conv2, - ConvTranspose, - DWConv, - DWConvTranspose2d, - Focus, - GhostConv, - LightConv, - RepConv, - SpatialAttention, -) -from .head import OBB, Classify, Detect, Pose, RTDETRDecoder, Segment, WorldDetect -from .transformer import ( - AIFI, - MLP, - DeformableTransformerDecoder, - DeformableTransformerDecoderLayer, - LayerNorm2d, - MLPBlock, - MSDeformAttn, - TransformerBlock, - TransformerEncoderLayer, - TransformerLayer, -) - -__all__ = ( - "Conv", - "Conv2", - "LightConv", - "RepConv", - "DWConv", - "DWConvTranspose2d", - "ConvTranspose", - "Focus", - "GhostConv", - "ChannelAttention", - "SpatialAttention", - "CBAM", - "Concat", - "TransformerLayer", - "TransformerBlock", - "MLPBlock", - "LayerNorm2d", - "DFL", - "HGBlock", - "HGStem", - "SPP", - "SPPF", - "C1", - "C2", - "C3", - "C2f", - "C2fAttn", - "C3x", - "C3TR", - "C3Ghost", - "GhostBottleneck", - "Bottleneck", - "BottleneckCSP", - "Proto", - "Detect", - "Segment", - "Pose", - "Classify", - "TransformerEncoderLayer", - "RepC3", - "RTDETRDecoder", - "AIFI", - "DeformableTransformerDecoder", - "DeformableTransformerDecoderLayer", - "MSDeformAttn", - "MLP", - "ResNetLayer", - "OBB", - "WorldDetect", - "ImagePoolingAttn", - "ContrastiveHead", - "BNContrastiveHead", - "RepNCSPELAN4", - "ADown", - "SPPELAN", - "CBFuse", - "CBLinear", - "Silence", -) diff --git a/ultralytics-main/ultralytics/nn/modules/block.py b/ultralytics-main/ultralytics/nn/modules/block.py deleted file mode 100644 index a263b60..0000000 --- a/ultralytics-main/ultralytics/nn/modules/block.py +++ /dev/null @@ -1,698 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -"""Block modules.""" - -import torch -import torch.nn as nn -import torch.nn.functional as F - -from .conv import Conv, DWConv, GhostConv, LightConv, RepConv, autopad -from .transformer import TransformerBlock - -__all__ = ( - "DFL", - "HGBlock", - "HGStem", - "SPP", - "SPPF", - "C1", - "C2", - "C3", - "C2f", - "C2fAttn", - "ImagePoolingAttn", - "ContrastiveHead", - "BNContrastiveHead", - "C3x", - "C3TR", - "C3Ghost", - "GhostBottleneck", - "Bottleneck", - "BottleneckCSP", - "Proto", - "RepC3", - "ResNetLayer", - "RepNCSPELAN4", - "ADown", - "SPPELAN", - "CBFuse", - "CBLinear", - "Silence", -) - - -class DFL(nn.Module): - """ - Integral module of Distribution Focal Loss (DFL). - - Proposed in Generalized Focal Loss https://ieeexplore.ieee.org/document/9792391 - """ - - def __init__(self, c1=16): - """Initialize a convolutional layer with a given number of input channels.""" - super().__init__() - self.conv = nn.Conv2d(c1, 1, 1, bias=False).requires_grad_(False) - x = torch.arange(c1, dtype=torch.float) - self.conv.weight.data[:] = nn.Parameter(x.view(1, c1, 1, 1)) - self.c1 = c1 - - def forward(self, x): - """Applies a transformer layer on input tensor 'x' and returns a tensor.""" - b, _, a = x.shape # batch, channels, anchors - return self.conv(x.view(b, 4, self.c1, a).transpose(2, 1).softmax(1)).view(b, 4, a) - # return self.conv(x.view(b, self.c1, 4, a).softmax(1)).view(b, 4, a) - - -class Proto(nn.Module): - """YOLOv8 mask Proto module for segmentation models.""" - - def __init__(self, c1, c_=256, c2=32): - """ - Initializes the YOLOv8 mask Proto module with specified number of protos and masks. - - Input arguments are ch_in, number of protos, number of masks. - """ - super().__init__() - self.cv1 = Conv(c1, c_, k=3) - self.upsample = nn.ConvTranspose2d(c_, c_, 2, 2, 0, bias=True) # nn.Upsample(scale_factor=2, mode='nearest') - self.cv2 = Conv(c_, c_, k=3) - self.cv3 = Conv(c_, c2) - - def forward(self, x): - """Performs a forward pass through layers using an upsampled input image.""" - return self.cv3(self.cv2(self.upsample(self.cv1(x)))) - - -class HGStem(nn.Module): - """ - StemBlock of PPHGNetV2 with 5 convolutions and one maxpool2d. - - https://github.com/PaddlePaddle/PaddleDetection/blob/develop/ppdet/modeling/backbones/hgnet_v2.py - """ - - def __init__(self, c1, cm, c2): - """Initialize the SPP layer with input/output channels and specified kernel sizes for max pooling.""" - super().__init__() - self.stem1 = Conv(c1, cm, 3, 2, act=nn.ReLU()) - self.stem2a = Conv(cm, cm // 2, 2, 1, 0, act=nn.ReLU()) - self.stem2b = Conv(cm // 2, cm, 2, 1, 0, act=nn.ReLU()) - self.stem3 = Conv(cm * 2, cm, 3, 2, act=nn.ReLU()) - self.stem4 = Conv(cm, c2, 1, 1, act=nn.ReLU()) - self.pool = nn.MaxPool2d(kernel_size=2, stride=1, padding=0, ceil_mode=True) - - def forward(self, x): - """Forward pass of a PPHGNetV2 backbone layer.""" - x = self.stem1(x) - x = F.pad(x, [0, 1, 0, 1]) - x2 = self.stem2a(x) - x2 = F.pad(x2, [0, 1, 0, 1]) - x2 = self.stem2b(x2) - x1 = self.pool(x) - x = torch.cat([x1, x2], dim=1) - x = self.stem3(x) - x = self.stem4(x) - return x - - -class HGBlock(nn.Module): - """ - HG_Block of PPHGNetV2 with 2 convolutions and LightConv. - - https://github.com/PaddlePaddle/PaddleDetection/blob/develop/ppdet/modeling/backbones/hgnet_v2.py - """ - - def __init__(self, c1, cm, c2, k=3, n=6, lightconv=False, shortcut=False, act=nn.ReLU()): - """Initializes a CSP Bottleneck with 1 convolution using specified input and output channels.""" - super().__init__() - block = LightConv if lightconv else Conv - self.m = nn.ModuleList(block(c1 if i == 0 else cm, cm, k=k, act=act) for i in range(n)) - self.sc = Conv(c1 + n * cm, c2 // 2, 1, 1, act=act) # squeeze conv - self.ec = Conv(c2 // 2, c2, 1, 1, act=act) # excitation conv - self.add = shortcut and c1 == c2 - - def forward(self, x): - """Forward pass of a PPHGNetV2 backbone layer.""" - y = [x] - y.extend(m(y[-1]) for m in self.m) - y = self.ec(self.sc(torch.cat(y, 1))) - return y + x if self.add else y - - -class SPP(nn.Module): - """Spatial Pyramid Pooling (SPP) layer https://arxiv.org/abs/1406.4729.""" - - def __init__(self, c1, c2, k=(5, 9, 13)): - """Initialize the SPP layer with input/output channels and pooling kernel sizes.""" - super().__init__() - c_ = c1 // 2 # hidden channels - self.cv1 = Conv(c1, c_, 1, 1) - self.cv2 = Conv(c_ * (len(k) + 1), c2, 1, 1) - self.m = nn.ModuleList([nn.MaxPool2d(kernel_size=x, stride=1, padding=x // 2) for x in k]) - - def forward(self, x): - """Forward pass of the SPP layer, performing spatial pyramid pooling.""" - x = self.cv1(x) - return self.cv2(torch.cat([x] + [m(x) for m in self.m], 1)) - - -class SPPF(nn.Module): - """Spatial Pyramid Pooling - Fast (SPPF) layer for YOLOv5 by Glenn Jocher.""" - - def __init__(self, c1, c2, k=5): - """ - Initializes the SPPF layer with given input/output channels and kernel size. - - This module is equivalent to SPP(k=(5, 9, 13)). - """ - super().__init__() - c_ = c1 // 2 # hidden channels - self.cv1 = Conv(c1, c_, 1, 1) - self.cv2 = Conv(c_ * 4, c2, 1, 1) - self.m = nn.MaxPool2d(kernel_size=k, stride=1, padding=k // 2) - - def forward(self, x): - """Forward pass through Ghost Convolution block.""" - x = self.cv1(x) - y1 = self.m(x) - y2 = self.m(y1) - return self.cv2(torch.cat((x, y1, y2, self.m(y2)), 1)) - - -class C1(nn.Module): - """CSP Bottleneck with 1 convolution.""" - - def __init__(self, c1, c2, n=1): - """Initializes the CSP Bottleneck with configurations for 1 convolution with arguments ch_in, ch_out, number.""" - super().__init__() - self.cv1 = Conv(c1, c2, 1, 1) - self.m = nn.Sequential(*(Conv(c2, c2, 3) for _ in range(n))) - - def forward(self, x): - """Applies cross-convolutions to input in the C3 module.""" - y = self.cv1(x) - return self.m(y) + y - - -class C2(nn.Module): - """CSP Bottleneck with 2 convolutions.""" - - def __init__(self, c1, c2, n=1, shortcut=True, g=1, e=0.5): - """Initializes the CSP Bottleneck with 2 convolutions module with arguments ch_in, ch_out, number, shortcut, - groups, expansion. - """ - super().__init__() - self.c = int(c2 * e) # hidden channels - self.cv1 = Conv(c1, 2 * self.c, 1, 1) - self.cv2 = Conv(2 * self.c, c2, 1) # optional act=FReLU(c2) - # self.attention = ChannelAttention(2 * self.c) # or SpatialAttention() - self.m = nn.Sequential(*(Bottleneck(self.c, self.c, shortcut, g, k=((3, 3), (3, 3)), e=1.0) for _ in range(n))) - - def forward(self, x): - """Forward pass through the CSP bottleneck with 2 convolutions.""" - a, b = self.cv1(x).chunk(2, 1) - return self.cv2(torch.cat((self.m(a), b), 1)) - - -class C2f(nn.Module): - """Faster Implementation of CSP Bottleneck with 2 convolutions.""" - - def __init__(self, c1, c2, n=1, shortcut=False, g=1, e=0.5): - """Initialize CSP bottleneck layer with two convolutions with arguments ch_in, ch_out, number, shortcut, groups, - expansion. - """ - super().__init__() - self.c = int(c2 * e) # hidden channels - self.cv1 = Conv(c1, 2 * self.c, 1, 1) - self.cv2 = Conv((2 + n) * self.c, c2, 1) # optional act=FReLU(c2) - self.m = nn.ModuleList(Bottleneck(self.c, self.c, shortcut, g, k=((3, 3), (3, 3)), e=1.0) for _ in range(n)) - - def forward(self, x): - """Forward pass through C2f layer.""" - y = list(self.cv1(x).chunk(2, 1)) - y.extend(m(y[-1]) for m in self.m) - return self.cv2(torch.cat(y, 1)) - - def forward_split(self, x): - """Forward pass using split() instead of chunk().""" - y = list(self.cv1(x).split((self.c, self.c), 1)) - y.extend(m(y[-1]) for m in self.m) - return self.cv2(torch.cat(y, 1)) - - -class C3(nn.Module): - """CSP Bottleneck with 3 convolutions.""" - - def __init__(self, c1, c2, n=1, shortcut=True, g=1, e=0.5): - """Initialize the CSP Bottleneck with given channels, number, shortcut, groups, and expansion values.""" - super().__init__() - c_ = int(c2 * e) # hidden channels - self.cv1 = Conv(c1, c_, 1, 1) - self.cv2 = Conv(c1, c_, 1, 1) - self.cv3 = Conv(2 * c_, c2, 1) # optional act=FReLU(c2) - self.m = nn.Sequential(*(Bottleneck(c_, c_, shortcut, g, k=((1, 1), (3, 3)), e=1.0) for _ in range(n))) - - def forward(self, x): - """Forward pass through the CSP bottleneck with 2 convolutions.""" - return self.cv3(torch.cat((self.m(self.cv1(x)), self.cv2(x)), 1)) - - -class C3x(C3): - """C3 module with cross-convolutions.""" - - def __init__(self, c1, c2, n=1, shortcut=True, g=1, e=0.5): - """Initialize C3TR instance and set default parameters.""" - super().__init__(c1, c2, n, shortcut, g, e) - self.c_ = int(c2 * e) - self.m = nn.Sequential(*(Bottleneck(self.c_, self.c_, shortcut, g, k=((1, 3), (3, 1)), e=1) for _ in range(n))) - - -class RepC3(nn.Module): - """Rep C3.""" - - def __init__(self, c1, c2, n=3, e=1.0): - """Initialize CSP Bottleneck with a single convolution using input channels, output channels, and number.""" - super().__init__() - c_ = int(c2 * e) # hidden channels - self.cv1 = Conv(c1, c2, 1, 1) - self.cv2 = Conv(c1, c2, 1, 1) - self.m = nn.Sequential(*[RepConv(c_, c_) for _ in range(n)]) - self.cv3 = Conv(c_, c2, 1, 1) if c_ != c2 else nn.Identity() - - def forward(self, x): - """Forward pass of RT-DETR neck layer.""" - return self.cv3(self.m(self.cv1(x)) + self.cv2(x)) - - -class C3TR(C3): - """C3 module with TransformerBlock().""" - - def __init__(self, c1, c2, n=1, shortcut=True, g=1, e=0.5): - """Initialize C3Ghost module with GhostBottleneck().""" - super().__init__(c1, c2, n, shortcut, g, e) - c_ = int(c2 * e) - self.m = TransformerBlock(c_, c_, 4, n) - - -class C3Ghost(C3): - """C3 module with GhostBottleneck().""" - - def __init__(self, c1, c2, n=1, shortcut=True, g=1, e=0.5): - """Initialize 'SPP' module with various pooling sizes for spatial pyramid pooling.""" - super().__init__(c1, c2, n, shortcut, g, e) - c_ = int(c2 * e) # hidden channels - self.m = nn.Sequential(*(GhostBottleneck(c_, c_) for _ in range(n))) - - -class GhostBottleneck(nn.Module): - """Ghost Bottleneck https://github.com/huawei-noah/ghostnet.""" - - def __init__(self, c1, c2, k=3, s=1): - """Initializes GhostBottleneck module with arguments ch_in, ch_out, kernel, stride.""" - super().__init__() - c_ = c2 // 2 - self.conv = nn.Sequential( - GhostConv(c1, c_, 1, 1), # pw - DWConv(c_, c_, k, s, act=False) if s == 2 else nn.Identity(), # dw - GhostConv(c_, c2, 1, 1, act=False), # pw-linear - ) - self.shortcut = ( - nn.Sequential(DWConv(c1, c1, k, s, act=False), Conv(c1, c2, 1, 1, act=False)) if s == 2 else nn.Identity() - ) - - def forward(self, x): - """Applies skip connection and concatenation to input tensor.""" - return self.conv(x) + self.shortcut(x) - - -class Bottleneck(nn.Module): - """Standard bottleneck.""" - - def __init__(self, c1, c2, shortcut=True, g=1, k=(3, 3), e=0.5): - """Initializes a bottleneck module with given input/output channels, shortcut option, group, kernels, and - expansion. - """ - super().__init__() - c_ = int(c2 * e) # hidden channels - self.cv1 = Conv(c1, c_, k[0], 1) - self.cv2 = Conv(c_, c2, k[1], 1, g=g) - self.add = shortcut and c1 == c2 - - def forward(self, x): - """'forward()' applies the YOLO FPN to input data.""" - return x + self.cv2(self.cv1(x)) if self.add else self.cv2(self.cv1(x)) - - -class BottleneckCSP(nn.Module): - """CSP Bottleneck https://github.com/WongKinYiu/CrossStagePartialNetworks.""" - - def __init__(self, c1, c2, n=1, shortcut=True, g=1, e=0.5): - """Initializes the CSP Bottleneck given arguments for ch_in, ch_out, number, shortcut, groups, expansion.""" - super().__init__() - c_ = int(c2 * e) # hidden channels - self.cv1 = Conv(c1, c_, 1, 1) - self.cv2 = nn.Conv2d(c1, c_, 1, 1, bias=False) - self.cv3 = nn.Conv2d(c_, c_, 1, 1, bias=False) - self.cv4 = Conv(2 * c_, c2, 1, 1) - self.bn = nn.BatchNorm2d(2 * c_) # applied to cat(cv2, cv3) - self.act = nn.SiLU() - self.m = nn.Sequential(*(Bottleneck(c_, c_, shortcut, g, e=1.0) for _ in range(n))) - - def forward(self, x): - """Applies a CSP bottleneck with 3 convolutions.""" - y1 = self.cv3(self.m(self.cv1(x))) - y2 = self.cv2(x) - return self.cv4(self.act(self.bn(torch.cat((y1, y2), 1)))) - - -class ResNetBlock(nn.Module): - """ResNet block with standard convolution layers.""" - - def __init__(self, c1, c2, s=1, e=4): - """Initialize convolution with given parameters.""" - super().__init__() - c3 = e * c2 - self.cv1 = Conv(c1, c2, k=1, s=1, act=True) - self.cv2 = Conv(c2, c2, k=3, s=s, p=1, act=True) - self.cv3 = Conv(c2, c3, k=1, act=False) - self.shortcut = nn.Sequential(Conv(c1, c3, k=1, s=s, act=False)) if s != 1 or c1 != c3 else nn.Identity() - - def forward(self, x): - """Forward pass through the ResNet block.""" - return F.relu(self.cv3(self.cv2(self.cv1(x))) + self.shortcut(x)) - - -class ResNetLayer(nn.Module): - """ResNet layer with multiple ResNet blocks.""" - - def __init__(self, c1, c2, s=1, is_first=False, n=1, e=4): - """Initializes the ResNetLayer given arguments.""" - super().__init__() - self.is_first = is_first - - if self.is_first: - self.layer = nn.Sequential( - Conv(c1, c2, k=7, s=2, p=3, act=True), nn.MaxPool2d(kernel_size=3, stride=2, padding=1) - ) - else: - blocks = [ResNetBlock(c1, c2, s, e=e)] - blocks.extend([ResNetBlock(e * c2, c2, 1, e=e) for _ in range(n - 1)]) - self.layer = nn.Sequential(*blocks) - - def forward(self, x): - """Forward pass through the ResNet layer.""" - return self.layer(x) - - -class MaxSigmoidAttnBlock(nn.Module): - """Max Sigmoid attention block.""" - - def __init__(self, c1, c2, nh=1, ec=128, gc=512, scale=False): - """Initializes MaxSigmoidAttnBlock with specified arguments.""" - super().__init__() - self.nh = nh - self.hc = c2 // nh - self.ec = Conv(c1, ec, k=1, act=False) if c1 != ec else None - self.gl = nn.Linear(gc, ec) - self.bias = nn.Parameter(torch.zeros(nh)) - self.proj_conv = Conv(c1, c2, k=3, s=1, act=False) - self.scale = nn.Parameter(torch.ones(1, nh, 1, 1)) if scale else 1.0 - - def forward(self, x, guide): - """Forward process.""" - bs, _, h, w = x.shape - - guide = self.gl(guide) - guide = guide.view(bs, -1, self.nh, self.hc) - embed = self.ec(x) if self.ec is not None else x - embed = embed.view(bs, self.nh, self.hc, h, w) - - aw = torch.einsum("bmchw,bnmc->bmhwn", embed, guide) - aw = aw.max(dim=-1)[0] - aw = aw / (self.hc**0.5) - aw = aw + self.bias[None, :, None, None] - aw = aw.sigmoid() * self.scale - - x = self.proj_conv(x) - x = x.view(bs, self.nh, -1, h, w) - x = x * aw.unsqueeze(2) - return x.view(bs, -1, h, w) - - -class C2fAttn(nn.Module): - """C2f module with an additional attn module.""" - - def __init__(self, c1, c2, n=1, ec=128, nh=1, gc=512, shortcut=False, g=1, e=0.5): - """Initialize CSP bottleneck layer with two convolutions with arguments ch_in, ch_out, number, shortcut, groups, - expansion. - """ - super().__init__() - self.c = int(c2 * e) # hidden channels - self.cv1 = Conv(c1, 2 * self.c, 1, 1) - self.cv2 = Conv((3 + n) * self.c, c2, 1) # optional act=FReLU(c2) - self.m = nn.ModuleList(Bottleneck(self.c, self.c, shortcut, g, k=((3, 3), (3, 3)), e=1.0) for _ in range(n)) - self.attn = MaxSigmoidAttnBlock(self.c, self.c, gc=gc, ec=ec, nh=nh) - - def forward(self, x, guide): - """Forward pass through C2f layer.""" - y = list(self.cv1(x).chunk(2, 1)) - y.extend(m(y[-1]) for m in self.m) - y.append(self.attn(y[-1], guide)) - return self.cv2(torch.cat(y, 1)) - - def forward_split(self, x, guide): - """Forward pass using split() instead of chunk().""" - y = list(self.cv1(x).split((self.c, self.c), 1)) - y.extend(m(y[-1]) for m in self.m) - y.append(self.attn(y[-1], guide)) - return self.cv2(torch.cat(y, 1)) - - -class ImagePoolingAttn(nn.Module): - """ImagePoolingAttn: Enhance the text embeddings with image-aware information.""" - - def __init__(self, ec=256, ch=(), ct=512, nh=8, k=3, scale=False): - """Initializes ImagePoolingAttn with specified arguments.""" - super().__init__() - - nf = len(ch) - self.query = nn.Sequential(nn.LayerNorm(ct), nn.Linear(ct, ec)) - self.key = nn.Sequential(nn.LayerNorm(ec), nn.Linear(ec, ec)) - self.value = nn.Sequential(nn.LayerNorm(ec), nn.Linear(ec, ec)) - self.proj = nn.Linear(ec, ct) - self.scale = nn.Parameter(torch.tensor([0.0]), requires_grad=True) if scale else 1.0 - self.projections = nn.ModuleList([nn.Conv2d(in_channels, ec, kernel_size=1) for in_channels in ch]) - self.im_pools = nn.ModuleList([nn.AdaptiveMaxPool2d((k, k)) for _ in range(nf)]) - self.ec = ec - self.nh = nh - self.nf = nf - self.hc = ec // nh - self.k = k - - def forward(self, x, text): - """Executes attention mechanism on input tensor x and guide tensor.""" - bs = x[0].shape[0] - assert len(x) == self.nf - num_patches = self.k**2 - x = [pool(proj(x)).view(bs, -1, num_patches) for (x, proj, pool) in zip(x, self.projections, self.im_pools)] - x = torch.cat(x, dim=-1).transpose(1, 2) - q = self.query(text) - k = self.key(x) - v = self.value(x) - - # q = q.reshape(1, text.shape[1], self.nh, self.hc).repeat(bs, 1, 1, 1) - q = q.reshape(bs, -1, self.nh, self.hc) - k = k.reshape(bs, -1, self.nh, self.hc) - v = v.reshape(bs, -1, self.nh, self.hc) - - aw = torch.einsum("bnmc,bkmc->bmnk", q, k) - aw = aw / (self.hc**0.5) - aw = F.softmax(aw, dim=-1) - - x = torch.einsum("bmnk,bkmc->bnmc", aw, v) - x = self.proj(x.reshape(bs, -1, self.ec)) - return x * self.scale + text - - -class ContrastiveHead(nn.Module): - """Contrastive Head for YOLO-World compute the region-text scores according to the similarity between image and text - features. - """ - - def __init__(self): - """Initializes ContrastiveHead with specified region-text similarity parameters.""" - super().__init__() - self.bias = nn.Parameter(torch.zeros([])) - self.logit_scale = nn.Parameter(torch.ones([]) * torch.tensor(1 / 0.07).log()) - - def forward(self, x, w): - """Forward function of contrastive learning.""" - x = F.normalize(x, dim=1, p=2) - w = F.normalize(w, dim=-1, p=2) - x = torch.einsum("bchw,bkc->bkhw", x, w) - return x * self.logit_scale.exp() + self.bias - - -class BNContrastiveHead(nn.Module): - """ - Batch Norm Contrastive Head for YOLO-World using batch norm instead of l2-normalization. - - Args: - embed_dims (int): Embed dimensions of text and image features. - """ - - def __init__(self, embed_dims: int): - """Initialize ContrastiveHead with region-text similarity parameters.""" - super().__init__() - self.norm = nn.BatchNorm2d(embed_dims) - self.bias = nn.Parameter(torch.zeros([])) - # use -1.0 is more stable - self.logit_scale = nn.Parameter(-1.0 * torch.ones([])) - - def forward(self, x, w): - """Forward function of contrastive learning.""" - x = self.norm(x) - w = F.normalize(w, dim=-1, p=2) - x = torch.einsum("bchw,bkc->bkhw", x, w) - return x * self.logit_scale.exp() + self.bias - - -class RepBottleneck(nn.Module): - """Rep bottleneck.""" - - def __init__(self, c1, c2, shortcut=True, g=1, k=(3, 3), e=0.5): - """Initializes a RepBottleneck module with customizable in/out channels, shortcut option, groups and expansion - ratio. - """ - super().__init__() - c_ = int(c2 * e) # hidden channels - self.cv1 = RepConv(c1, c_, k[0], 1) - self.cv2 = Conv(c_, c2, k[1], 1, g=g) - self.add = shortcut and c1 == c2 - - def forward(self, x): - """Forward pass through RepBottleneck layer.""" - return x + self.cv2(self.cv1(x)) if self.add else self.cv2(self.cv1(x)) - - -class RepCSP(nn.Module): - """Rep CSP Bottleneck with 3 convolutions.""" - - def __init__(self, c1, c2, n=1, shortcut=True, g=1, e=0.5): - """Initializes RepCSP layer with given channels, repetitions, shortcut, groups and expansion ratio.""" - super().__init__() - c_ = int(c2 * e) # hidden channels - self.cv1 = Conv(c1, c_, 1, 1) - self.cv2 = Conv(c1, c_, 1, 1) - self.cv3 = Conv(2 * c_, c2, 1) # optional act=FReLU(c2) - self.m = nn.Sequential(*(RepBottleneck(c_, c_, shortcut, g, e=1.0) for _ in range(n))) - - def forward(self, x): - """Forward pass through RepCSP layer.""" - return self.cv3(torch.cat((self.m(self.cv1(x)), self.cv2(x)), 1)) - - -class RepNCSPELAN4(nn.Module): - """CSP-ELAN.""" - - def __init__(self, c1, c2, c3, c4, n=1): - """Initializes CSP-ELAN layer with specified channel sizes, repetitions, and convolutions.""" - super().__init__() - self.c = c3 // 2 - self.cv1 = Conv(c1, c3, 1, 1) - self.cv2 = nn.Sequential(RepCSP(c3 // 2, c4, n), Conv(c4, c4, 3, 1)) - self.cv3 = nn.Sequential(RepCSP(c4, c4, n), Conv(c4, c4, 3, 1)) - self.cv4 = Conv(c3 + (2 * c4), c2, 1, 1) - - def forward(self, x): - """Forward pass through RepNCSPELAN4 layer.""" - y = list(self.cv1(x).chunk(2, 1)) - y.extend((m(y[-1])) for m in [self.cv2, self.cv3]) - return self.cv4(torch.cat(y, 1)) - - def forward_split(self, x): - """Forward pass using split() instead of chunk().""" - y = list(self.cv1(x).split((self.c, self.c), 1)) - y.extend(m(y[-1]) for m in [self.cv2, self.cv3]) - return self.cv4(torch.cat(y, 1)) - - -class ADown(nn.Module): - """ADown.""" - - def __init__(self, c1, c2): - """Initializes ADown module with convolution layers to downsample input from channels c1 to c2.""" - super().__init__() - self.c = c2 // 2 - self.cv1 = Conv(c1 // 2, self.c, 3, 2, 1) - self.cv2 = Conv(c1 // 2, self.c, 1, 1, 0) - - def forward(self, x): - """Forward pass through ADown layer.""" - x = torch.nn.functional.avg_pool2d(x, 2, 1, 0, False, True) - x1, x2 = x.chunk(2, 1) - x1 = self.cv1(x1) - x2 = torch.nn.functional.max_pool2d(x2, 3, 2, 1) - x2 = self.cv2(x2) - return torch.cat((x1, x2), 1) - - -class SPPELAN(nn.Module): - """SPP-ELAN.""" - - def __init__(self, c1, c2, c3, k=5): - """Initializes SPP-ELAN block with convolution and max pooling layers for spatial pyramid pooling.""" - super().__init__() - self.c = c3 - self.cv1 = Conv(c1, c3, 1, 1) - self.cv2 = nn.MaxPool2d(kernel_size=k, stride=1, padding=k // 2) - self.cv3 = nn.MaxPool2d(kernel_size=k, stride=1, padding=k // 2) - self.cv4 = nn.MaxPool2d(kernel_size=k, stride=1, padding=k // 2) - self.cv5 = Conv(4 * c3, c2, 1, 1) - - def forward(self, x): - """Forward pass through SPPELAN layer.""" - y = [self.cv1(x)] - y.extend(m(y[-1]) for m in [self.cv2, self.cv3, self.cv4]) - return self.cv5(torch.cat(y, 1)) - - -class Silence(nn.Module): - """Silence.""" - - def __init__(self): - """Initializes the Silence module.""" - super(Silence, self).__init__() - - def forward(self, x): - """Forward pass through Silence layer.""" - return x - - -class CBLinear(nn.Module): - """CBLinear.""" - - def __init__(self, c1, c2s, k=1, s=1, p=None, g=1): - """Initializes the CBLinear module, passing inputs unchanged.""" - super(CBLinear, self).__init__() - self.c2s = c2s - self.conv = nn.Conv2d(c1, sum(c2s), k, s, autopad(k, p), groups=g, bias=True) - - def forward(self, x): - """Forward pass through CBLinear layer.""" - outs = self.conv(x).split(self.c2s, dim=1) - return outs - - -class CBFuse(nn.Module): - """CBFuse.""" - - def __init__(self, idx): - """Initializes CBFuse module with layer index for selective feature fusion.""" - super(CBFuse, self).__init__() - self.idx = idx - - def forward(self, xs): - """Forward pass through CBFuse layer.""" - target_size = xs[-1].shape[2:] - res = [F.interpolate(x[self.idx[i]], size=target_size, mode="nearest") for i, x in enumerate(xs[:-1])] - out = torch.sum(torch.stack(res + xs[-1:]), dim=0) - return out diff --git a/ultralytics-main/ultralytics/nn/modules/conv.py b/ultralytics-main/ultralytics/nn/modules/conv.py deleted file mode 100644 index 399c422..0000000 --- a/ultralytics-main/ultralytics/nn/modules/conv.py +++ /dev/null @@ -1,333 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -"""Convolution modules.""" - -import math - -import numpy as np -import torch -import torch.nn as nn - -__all__ = ( - "Conv", - "Conv2", - "LightConv", - "DWConv", - "DWConvTranspose2d", - "ConvTranspose", - "Focus", - "GhostConv", - "ChannelAttention", - "SpatialAttention", - "CBAM", - "Concat", - "RepConv", -) - - -def autopad(k, p=None, d=1): # kernel, padding, dilation - """Pad to 'same' shape outputs.""" - if d > 1: - k = d * (k - 1) + 1 if isinstance(k, int) else [d * (x - 1) + 1 for x in k] # actual kernel-size - if p is None: - p = k // 2 if isinstance(k, int) else [x // 2 for x in k] # auto-pad - return p - - -class Conv(nn.Module): - """Standard convolution with args(ch_in, ch_out, kernel, stride, padding, groups, dilation, activation).""" - - default_act = nn.SiLU() # default activation - - def __init__(self, c1, c2, k=1, s=1, p=None, g=1, d=1, act=True): - """Initialize Conv layer with given arguments including activation.""" - super().__init__() - self.conv = nn.Conv2d(c1, c2, k, s, autopad(k, p, d), groups=g, dilation=d, bias=False) - self.bn = nn.BatchNorm2d(c2) - self.act = self.default_act if act is True else act if isinstance(act, nn.Module) else nn.Identity() - - def forward(self, x): - """Apply convolution, batch normalization and activation to input tensor.""" - return self.act(self.bn(self.conv(x))) - - def forward_fuse(self, x): - """Perform transposed convolution of 2D data.""" - return self.act(self.conv(x)) - - -class Conv2(Conv): - """Simplified RepConv module with Conv fusing.""" - - def __init__(self, c1, c2, k=3, s=1, p=None, g=1, d=1, act=True): - """Initialize Conv layer with given arguments including activation.""" - super().__init__(c1, c2, k, s, p, g=g, d=d, act=act) - self.cv2 = nn.Conv2d(c1, c2, 1, s, autopad(1, p, d), groups=g, dilation=d, bias=False) # add 1x1 conv - - def forward(self, x): - """Apply convolution, batch normalization and activation to input tensor.""" - return self.act(self.bn(self.conv(x) + self.cv2(x))) - - def forward_fuse(self, x): - """Apply fused convolution, batch normalization and activation to input tensor.""" - return self.act(self.bn(self.conv(x))) - - def fuse_convs(self): - """Fuse parallel convolutions.""" - w = torch.zeros_like(self.conv.weight.data) - i = [x // 2 for x in w.shape[2:]] - w[:, :, i[0] : i[0] + 1, i[1] : i[1] + 1] = self.cv2.weight.data.clone() - self.conv.weight.data += w - self.__delattr__("cv2") - self.forward = self.forward_fuse - - -class LightConv(nn.Module): - """ - Light convolution with args(ch_in, ch_out, kernel). - - https://github.com/PaddlePaddle/PaddleDetection/blob/develop/ppdet/modeling/backbones/hgnet_v2.py - """ - - def __init__(self, c1, c2, k=1, act=nn.ReLU()): - """Initialize Conv layer with given arguments including activation.""" - super().__init__() - self.conv1 = Conv(c1, c2, 1, act=False) - self.conv2 = DWConv(c2, c2, k, act=act) - - def forward(self, x): - """Apply 2 convolutions to input tensor.""" - return self.conv2(self.conv1(x)) - - -class DWConv(Conv): - """Depth-wise convolution.""" - - def __init__(self, c1, c2, k=1, s=1, d=1, act=True): # ch_in, ch_out, kernel, stride, dilation, activation - """Initialize Depth-wise convolution with given parameters.""" - super().__init__(c1, c2, k, s, g=math.gcd(c1, c2), d=d, act=act) - - -class DWConvTranspose2d(nn.ConvTranspose2d): - """Depth-wise transpose convolution.""" - - def __init__(self, c1, c2, k=1, s=1, p1=0, p2=0): # ch_in, ch_out, kernel, stride, padding, padding_out - """Initialize DWConvTranspose2d class with given parameters.""" - super().__init__(c1, c2, k, s, p1, p2, groups=math.gcd(c1, c2)) - - -class ConvTranspose(nn.Module): - """Convolution transpose 2d layer.""" - - default_act = nn.SiLU() # default activation - - def __init__(self, c1, c2, k=2, s=2, p=0, bn=True, act=True): - """Initialize ConvTranspose2d layer with batch normalization and activation function.""" - super().__init__() - self.conv_transpose = nn.ConvTranspose2d(c1, c2, k, s, p, bias=not bn) - self.bn = nn.BatchNorm2d(c2) if bn else nn.Identity() - self.act = self.default_act if act is True else act if isinstance(act, nn.Module) else nn.Identity() - - def forward(self, x): - """Applies transposed convolutions, batch normalization and activation to input.""" - return self.act(self.bn(self.conv_transpose(x))) - - def forward_fuse(self, x): - """Applies activation and convolution transpose operation to input.""" - return self.act(self.conv_transpose(x)) - - -class Focus(nn.Module): - """Focus wh information into c-space.""" - - def __init__(self, c1, c2, k=1, s=1, p=None, g=1, act=True): - """Initializes Focus object with user defined channel, convolution, padding, group and activation values.""" - super().__init__() - self.conv = Conv(c1 * 4, c2, k, s, p, g, act=act) - # self.contract = Contract(gain=2) - - def forward(self, x): - """ - Applies convolution to concatenated tensor and returns the output. - - Input shape is (b,c,w,h) and output shape is (b,4c,w/2,h/2). - """ - return self.conv(torch.cat((x[..., ::2, ::2], x[..., 1::2, ::2], x[..., ::2, 1::2], x[..., 1::2, 1::2]), 1)) - # return self.conv(self.contract(x)) - - -class GhostConv(nn.Module): - """Ghost Convolution https://github.com/huawei-noah/ghostnet.""" - - def __init__(self, c1, c2, k=1, s=1, g=1, act=True): - """Initializes the GhostConv object with input channels, output channels, kernel size, stride, groups and - activation. - """ - super().__init__() - c_ = c2 // 2 # hidden channels - self.cv1 = Conv(c1, c_, k, s, None, g, act=act) - self.cv2 = Conv(c_, c_, 5, 1, None, c_, act=act) - - def forward(self, x): - """Forward propagation through a Ghost Bottleneck layer with skip connection.""" - y = self.cv1(x) - return torch.cat((y, self.cv2(y)), 1) - - -class RepConv(nn.Module): - """ - RepConv is a basic rep-style block, including training and deploy status. - - This module is used in RT-DETR. - Based on https://github.com/DingXiaoH/RepVGG/blob/main/repvgg.py - """ - - default_act = nn.SiLU() # default activation - - def __init__(self, c1, c2, k=3, s=1, p=1, g=1, d=1, act=True, bn=False, deploy=False): - """Initializes Light Convolution layer with inputs, outputs & optional activation function.""" - super().__init__() - assert k == 3 and p == 1 - self.g = g - self.c1 = c1 - self.c2 = c2 - self.act = self.default_act if act is True else act if isinstance(act, nn.Module) else nn.Identity() - - self.bn = nn.BatchNorm2d(num_features=c1) if bn and c2 == c1 and s == 1 else None - self.conv1 = Conv(c1, c2, k, s, p=p, g=g, act=False) - self.conv2 = Conv(c1, c2, 1, s, p=(p - k // 2), g=g, act=False) - - def forward_fuse(self, x): - """Forward process.""" - return self.act(self.conv(x)) - - def forward(self, x): - """Forward process.""" - id_out = 0 if self.bn is None else self.bn(x) - return self.act(self.conv1(x) + self.conv2(x) + id_out) - - def get_equivalent_kernel_bias(self): - """Returns equivalent kernel and bias by adding 3x3 kernel, 1x1 kernel and identity kernel with their biases.""" - kernel3x3, bias3x3 = self._fuse_bn_tensor(self.conv1) - kernel1x1, bias1x1 = self._fuse_bn_tensor(self.conv2) - kernelid, biasid = self._fuse_bn_tensor(self.bn) - return kernel3x3 + self._pad_1x1_to_3x3_tensor(kernel1x1) + kernelid, bias3x3 + bias1x1 + biasid - - def _pad_1x1_to_3x3_tensor(self, kernel1x1): - """Pads a 1x1 tensor to a 3x3 tensor.""" - if kernel1x1 is None: - return 0 - else: - return torch.nn.functional.pad(kernel1x1, [1, 1, 1, 1]) - - def _fuse_bn_tensor(self, branch): - """Generates appropriate kernels and biases for convolution by fusing branches of the neural network.""" - if branch is None: - return 0, 0 - if isinstance(branch, Conv): - kernel = branch.conv.weight - running_mean = branch.bn.running_mean - running_var = branch.bn.running_var - gamma = branch.bn.weight - beta = branch.bn.bias - eps = branch.bn.eps - elif isinstance(branch, nn.BatchNorm2d): - if not hasattr(self, "id_tensor"): - input_dim = self.c1 // self.g - kernel_value = np.zeros((self.c1, input_dim, 3, 3), dtype=np.float32) - for i in range(self.c1): - kernel_value[i, i % input_dim, 1, 1] = 1 - self.id_tensor = torch.from_numpy(kernel_value).to(branch.weight.device) - kernel = self.id_tensor - running_mean = branch.running_mean - running_var = branch.running_var - gamma = branch.weight - beta = branch.bias - eps = branch.eps - std = (running_var + eps).sqrt() - t = (gamma / std).reshape(-1, 1, 1, 1) - return kernel * t, beta - running_mean * gamma / std - - def fuse_convs(self): - """Combines two convolution layers into a single layer and removes unused attributes from the class.""" - if hasattr(self, "conv"): - return - kernel, bias = self.get_equivalent_kernel_bias() - self.conv = nn.Conv2d( - in_channels=self.conv1.conv.in_channels, - out_channels=self.conv1.conv.out_channels, - kernel_size=self.conv1.conv.kernel_size, - stride=self.conv1.conv.stride, - padding=self.conv1.conv.padding, - dilation=self.conv1.conv.dilation, - groups=self.conv1.conv.groups, - bias=True, - ).requires_grad_(False) - self.conv.weight.data = kernel - self.conv.bias.data = bias - for para in self.parameters(): - para.detach_() - self.__delattr__("conv1") - self.__delattr__("conv2") - if hasattr(self, "nm"): - self.__delattr__("nm") - if hasattr(self, "bn"): - self.__delattr__("bn") - if hasattr(self, "id_tensor"): - self.__delattr__("id_tensor") - - -class ChannelAttention(nn.Module): - """Channel-attention module https://github.com/open-mmlab/mmdetection/tree/v3.0.0rc1/configs/rtmdet.""" - - def __init__(self, channels: int) -> None: - """Initializes the class and sets the basic configurations and instance variables required.""" - super().__init__() - self.pool = nn.AdaptiveAvgPool2d(1) - self.fc = nn.Conv2d(channels, channels, 1, 1, 0, bias=True) - self.act = nn.Sigmoid() - - def forward(self, x: torch.Tensor) -> torch.Tensor: - """Applies forward pass using activation on convolutions of the input, optionally using batch normalization.""" - return x * self.act(self.fc(self.pool(x))) - - -class SpatialAttention(nn.Module): - """Spatial-attention module.""" - - def __init__(self, kernel_size=7): - """Initialize Spatial-attention module with kernel size argument.""" - super().__init__() - assert kernel_size in (3, 7), "kernel size must be 3 or 7" - padding = 3 if kernel_size == 7 else 1 - self.cv1 = nn.Conv2d(2, 1, kernel_size, padding=padding, bias=False) - self.act = nn.Sigmoid() - - def forward(self, x): - """Apply channel and spatial attention on input for feature recalibration.""" - return x * self.act(self.cv1(torch.cat([torch.mean(x, 1, keepdim=True), torch.max(x, 1, keepdim=True)[0]], 1))) - - -class CBAM(nn.Module): - """Convolutional Block Attention Module.""" - - def __init__(self, c1, kernel_size=7): - """Initialize CBAM with given input channel (c1) and kernel size.""" - super().__init__() - self.channel_attention = ChannelAttention(c1) - self.spatial_attention = SpatialAttention(kernel_size) - - def forward(self, x): - """Applies the forward pass through C1 module.""" - return self.spatial_attention(self.channel_attention(x)) - - -class Concat(nn.Module): - """Concatenate a list of tensors along dimension.""" - - def __init__(self, dimension=1): - """Concatenates a list of tensors along a specified dimension.""" - super().__init__() - self.d = dimension - - def forward(self, x): - """Forward pass for the YOLOv8 mask Proto module.""" - return torch.cat(x, self.d) diff --git a/ultralytics-main/ultralytics/nn/modules/head.py b/ultralytics-main/ultralytics/nn/modules/head.py deleted file mode 100644 index 9cd794e..0000000 --- a/ultralytics-main/ultralytics/nn/modules/head.py +++ /dev/null @@ -1,482 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -"""Model head modules.""" - -import math - -import torch -import torch.nn as nn -from torch.nn.init import constant_, xavier_uniform_ - -from ultralytics.utils.tal import TORCH_1_10, dist2bbox, dist2rbox, make_anchors -from .block import DFL, Proto, ContrastiveHead, BNContrastiveHead -from .conv import Conv -from .transformer import MLP, DeformableTransformerDecoder, DeformableTransformerDecoderLayer -from .utils import bias_init_with_prob, linear_init - -__all__ = "Detect", "Segment", "Pose", "Classify", "OBB", "RTDETRDecoder" - - -class Detect(nn.Module): - """YOLOv8 Detect head for detection models.""" - - dynamic = False # force grid reconstruction - export = False # export mode - shape = None - anchors = torch.empty(0) # init - strides = torch.empty(0) # init - - def __init__(self, nc=80, ch=()): - """Initializes the YOLOv8 detection layer with specified number of classes and channels.""" - super().__init__() - self.nc = nc # number of classes - self.nl = len(ch) # number of detection layers - self.reg_max = 16 # DFL channels (ch[0] // 16 to scale 4/8/12/16/20 for n/s/m/l/x) - self.no = nc + self.reg_max * 4 # number of outputs per anchor - self.stride = torch.zeros(self.nl) # strides computed during build - c2, c3 = max((16, ch[0] // 4, self.reg_max * 4)), max(ch[0], min(self.nc, 100)) # channels - self.cv2 = nn.ModuleList( - nn.Sequential(Conv(x, c2, 3), Conv(c2, c2, 3), nn.Conv2d(c2, 4 * self.reg_max, 1)) for x in ch - ) - self.cv3 = nn.ModuleList(nn.Sequential(Conv(x, c3, 3), Conv(c3, c3, 3), nn.Conv2d(c3, self.nc, 1)) for x in ch) - self.dfl = DFL(self.reg_max) if self.reg_max > 1 else nn.Identity() - - def forward(self, x): - """Concatenates and returns predicted bounding boxes and class probabilities.""" - for i in range(self.nl): - x[i] = torch.cat((self.cv2[i](x[i]), self.cv3[i](x[i])), 1) - if self.training: # Training path - return x - - # Inference path - shape = x[0].shape # BCHW - x_cat = torch.cat([xi.view(shape[0], self.no, -1) for xi in x], 2) - if self.dynamic or self.shape != shape: - self.anchors, self.strides = (x.transpose(0, 1) for x in make_anchors(x, self.stride, 0.5)) - self.shape = shape - - if self.export and self.format in ("saved_model", "pb", "tflite", "edgetpu", "tfjs"): # avoid TF FlexSplitV ops - box = x_cat[:, : self.reg_max * 4] - cls = x_cat[:, self.reg_max * 4 :] - else: - box, cls = x_cat.split((self.reg_max * 4, self.nc), 1) - - if self.export and self.format in ("tflite", "edgetpu"): - # Precompute normalization factor to increase numerical stability - # See https://github.com/ultralytics/ultralytics/issues/7371 - grid_h = shape[2] - grid_w = shape[3] - grid_size = torch.tensor([grid_w, grid_h, grid_w, grid_h], device=box.device).reshape(1, 4, 1) - norm = self.strides / (self.stride[0] * grid_size) - dbox = self.decode_bboxes(self.dfl(box) * norm, self.anchors.unsqueeze(0) * norm[:, :2]) - else: - dbox = self.decode_bboxes(self.dfl(box), self.anchors.unsqueeze(0)) * self.strides - - y = torch.cat((dbox, cls.sigmoid()), 1) - return y if self.export else (y, x) - - def bias_init(self): - """Initialize Detect() biases, WARNING: requires stride availability.""" - m = self # self.model[-1] # Detect() module - # cf = torch.bincount(torch.tensor(np.concatenate(dataset.labels, 0)[:, 0]).long(), minlength=nc) + 1 - # ncf = math.log(0.6 / (m.nc - 0.999999)) if cf is None else torch.log(cf / cf.sum()) # nominal class frequency - for a, b, s in zip(m.cv2, m.cv3, m.stride): # from - a[-1].bias.data[:] = 1.0 # box - b[-1].bias.data[: m.nc] = math.log(5 / m.nc / (640 / s) ** 2) # cls (.01 objects, 80 classes, 640 img) - - def decode_bboxes(self, bboxes, anchors): - """Decode bounding boxes.""" - return dist2bbox(bboxes, anchors, xywh=True, dim=1) - - -class Segment(Detect): - """YOLOv8 Segment head for segmentation models.""" - - def __init__(self, nc=80, nm=32, npr=256, ch=()): - """Initialize the YOLO model attributes such as the number of masks, prototypes, and the convolution layers.""" - super().__init__(nc, ch) - self.nm = nm # number of masks - self.npr = npr # number of protos - self.proto = Proto(ch[0], self.npr, self.nm) # protos - self.detect = Detect.forward - - c4 = max(ch[0] // 4, self.nm) - self.cv4 = nn.ModuleList(nn.Sequential(Conv(x, c4, 3), Conv(c4, c4, 3), nn.Conv2d(c4, self.nm, 1)) for x in ch) - - def forward(self, x): - """Return model outputs and mask coefficients if training, otherwise return outputs and mask coefficients.""" - p = self.proto(x[0]) # mask protos - bs = p.shape[0] # batch size - - mc = torch.cat([self.cv4[i](x[i]).view(bs, self.nm, -1) for i in range(self.nl)], 2) # mask coefficients - x = self.detect(self, x) - if self.training: - return x, mc, p - return (torch.cat([x, mc], 1), p) if self.export else (torch.cat([x[0], mc], 1), (x[1], mc, p)) - - -class OBB(Detect): - """YOLOv8 OBB detection head for detection with rotation models.""" - - def __init__(self, nc=80, ne=1, ch=()): - """Initialize OBB with number of classes `nc` and layer channels `ch`.""" - super().__init__(nc, ch) - self.ne = ne # number of extra parameters - self.detect = Detect.forward - - c4 = max(ch[0] // 4, self.ne) - self.cv4 = nn.ModuleList(nn.Sequential(Conv(x, c4, 3), Conv(c4, c4, 3), nn.Conv2d(c4, self.ne, 1)) for x in ch) - - def forward(self, x): - """Concatenates and returns predicted bounding boxes and class probabilities.""" - bs = x[0].shape[0] # batch size - angle = torch.cat([self.cv4[i](x[i]).view(bs, self.ne, -1) for i in range(self.nl)], 2) # OBB theta logits - # NOTE: set `angle` as an attribute so that `decode_bboxes` could use it. - angle = (angle.sigmoid() - 0.25) * math.pi # [-pi/4, 3pi/4] - # angle = angle.sigmoid() * math.pi / 2 # [0, pi/2] - if not self.training: - self.angle = angle - x = self.detect(self, x) - if self.training: - return x, angle - return torch.cat([x, angle], 1) if self.export else (torch.cat([x[0], angle], 1), (x[1], angle)) - - def decode_bboxes(self, bboxes, anchors): - """Decode rotated bounding boxes.""" - return dist2rbox(bboxes, self.angle, anchors, dim=1) - - -class Pose(Detect): - """YOLOv8 Pose head for keypoints models.""" - - def __init__(self, nc=80, kpt_shape=(17, 3), ch=()): - """Initialize YOLO network with default parameters and Convolutional Layers.""" - super().__init__(nc, ch) - self.kpt_shape = kpt_shape # number of keypoints, number of dims (2 for x,y or 3 for x,y,visible) - self.nk = kpt_shape[0] * kpt_shape[1] # number of keypoints total - self.detect = Detect.forward - - c4 = max(ch[0] // 4, self.nk) - self.cv4 = nn.ModuleList(nn.Sequential(Conv(x, c4, 3), Conv(c4, c4, 3), nn.Conv2d(c4, self.nk, 1)) for x in ch) - - def forward(self, x): - """Perform forward pass through YOLO model and return predictions.""" - bs = x[0].shape[0] # batch size - kpt = torch.cat([self.cv4[i](x[i]).view(bs, self.nk, -1) for i in range(self.nl)], -1) # (bs, 17*3, h*w) - x = self.detect(self, x) - if self.training: - return x, kpt - pred_kpt = self.kpts_decode(bs, kpt) - return torch.cat([x, pred_kpt], 1) if self.export else (torch.cat([x[0], pred_kpt], 1), (x[1], kpt)) - - def kpts_decode(self, bs, kpts): - """Decodes keypoints.""" - ndim = self.kpt_shape[1] - if self.export: # required for TFLite export to avoid 'PLACEHOLDER_FOR_GREATER_OP_CODES' bug - y = kpts.view(bs, *self.kpt_shape, -1) - a = (y[:, :, :2] * 2.0 + (self.anchors - 0.5)) * self.strides - if ndim == 3: - a = torch.cat((a, y[:, :, 2:3].sigmoid()), 2) - return a.view(bs, self.nk, -1) - else: - y = kpts.clone() - if ndim == 3: - y[:, 2::3] = y[:, 2::3].sigmoid() # sigmoid (WARNING: inplace .sigmoid_() Apple MPS bug) - y[:, 0::ndim] = (y[:, 0::ndim] * 2.0 + (self.anchors[0] - 0.5)) * self.strides - y[:, 1::ndim] = (y[:, 1::ndim] * 2.0 + (self.anchors[1] - 0.5)) * self.strides - return y - - -class Classify(nn.Module): - """YOLOv8 classification head, i.e. x(b,c1,20,20) to x(b,c2).""" - - def __init__(self, c1, c2, k=1, s=1, p=None, g=1): - """Initializes YOLOv8 classification head with specified input and output channels, kernel size, stride, - padding, and groups. - """ - super().__init__() - c_ = 1280 # efficientnet_b0 size - self.conv = Conv(c1, c_, k, s, p, g) - self.pool = nn.AdaptiveAvgPool2d(1) # to x(b,c_,1,1) - self.drop = nn.Dropout(p=0.0, inplace=True) - self.linear = nn.Linear(c_, c2) # to x(b,c2) - - def forward(self, x): - """Performs a forward pass of the YOLO model on input image data.""" - if isinstance(x, list): - x = torch.cat(x, 1) - x = self.linear(self.drop(self.pool(self.conv(x)).flatten(1))) - return x if self.training else x.softmax(1) - - -class WorldDetect(Detect): - def __init__(self, nc=80, embed=512, with_bn=False, ch=()): - """Initialize YOLOv8 detection layer with nc classes and layer channels ch.""" - super().__init__(nc, ch) - c3 = max(ch[0], min(self.nc, 100)) - self.cv3 = nn.ModuleList(nn.Sequential(Conv(x, c3, 3), Conv(c3, c3, 3), nn.Conv2d(c3, embed, 1)) for x in ch) - self.cv4 = nn.ModuleList(BNContrastiveHead(embed) if with_bn else ContrastiveHead() for _ in ch) - - def forward(self, x, text): - """Concatenates and returns predicted bounding boxes and class probabilities.""" - for i in range(self.nl): - x[i] = torch.cat((self.cv2[i](x[i]), self.cv4[i](self.cv3[i](x[i]), text)), 1) - if self.training: - return x - - # Inference path - shape = x[0].shape # BCHW - x_cat = torch.cat([xi.view(shape[0], self.nc + self.reg_max * 4, -1) for xi in x], 2) - if self.dynamic or self.shape != shape: - self.anchors, self.strides = (x.transpose(0, 1) for x in make_anchors(x, self.stride, 0.5)) - self.shape = shape - - if self.export and self.format in ("saved_model", "pb", "tflite", "edgetpu", "tfjs"): # avoid TF FlexSplitV ops - box = x_cat[:, : self.reg_max * 4] - cls = x_cat[:, self.reg_max * 4 :] - else: - box, cls = x_cat.split((self.reg_max * 4, self.nc), 1) - - if self.export and self.format in ("tflite", "edgetpu"): - # Precompute normalization factor to increase numerical stability - # See https://github.com/ultralytics/ultralytics/issues/7371 - grid_h = shape[2] - grid_w = shape[3] - grid_size = torch.tensor([grid_w, grid_h, grid_w, grid_h], device=box.device).reshape(1, 4, 1) - norm = self.strides / (self.stride[0] * grid_size) - dbox = self.decode_bboxes(self.dfl(box) * norm, self.anchors.unsqueeze(0) * norm[:, :2]) - else: - dbox = self.decode_bboxes(self.dfl(box), self.anchors.unsqueeze(0)) * self.strides - - y = torch.cat((dbox, cls.sigmoid()), 1) - return y if self.export else (y, x) - - -class RTDETRDecoder(nn.Module): - """ - Real-Time Deformable Transformer Decoder (RTDETRDecoder) module for object detection. - - This decoder module utilizes Transformer architecture along with deformable convolutions to predict bounding boxes - and class labels for objects in an image. It integrates features from multiple layers and runs through a series of - Transformer decoder layers to output the final predictions. - """ - - export = False # export mode - - def __init__( - self, - nc=80, - ch=(512, 1024, 2048), - hd=256, # hidden dim - nq=300, # num queries - ndp=4, # num decoder points - nh=8, # num head - ndl=6, # num decoder layers - d_ffn=1024, # dim of feedforward - dropout=0.0, - act=nn.ReLU(), - eval_idx=-1, - # Training args - nd=100, # num denoising - label_noise_ratio=0.5, - box_noise_scale=1.0, - learnt_init_query=False, - ): - """ - Initializes the RTDETRDecoder module with the given parameters. - - Args: - nc (int): Number of classes. Default is 80. - ch (tuple): Channels in the backbone feature maps. Default is (512, 1024, 2048). - hd (int): Dimension of hidden layers. Default is 256. - nq (int): Number of query points. Default is 300. - ndp (int): Number of decoder points. Default is 4. - nh (int): Number of heads in multi-head attention. Default is 8. - ndl (int): Number of decoder layers. Default is 6. - d_ffn (int): Dimension of the feed-forward networks. Default is 1024. - dropout (float): Dropout rate. Default is 0. - act (nn.Module): Activation function. Default is nn.ReLU. - eval_idx (int): Evaluation index. Default is -1. - nd (int): Number of denoising. Default is 100. - label_noise_ratio (float): Label noise ratio. Default is 0.5. - box_noise_scale (float): Box noise scale. Default is 1.0. - learnt_init_query (bool): Whether to learn initial query embeddings. Default is False. - """ - super().__init__() - self.hidden_dim = hd - self.nhead = nh - self.nl = len(ch) # num level - self.nc = nc - self.num_queries = nq - self.num_decoder_layers = ndl - - # Backbone feature projection - self.input_proj = nn.ModuleList(nn.Sequential(nn.Conv2d(x, hd, 1, bias=False), nn.BatchNorm2d(hd)) for x in ch) - # NOTE: simplified version but it's not consistent with .pt weights. - # self.input_proj = nn.ModuleList(Conv(x, hd, act=False) for x in ch) - - # Transformer module - decoder_layer = DeformableTransformerDecoderLayer(hd, nh, d_ffn, dropout, act, self.nl, ndp) - self.decoder = DeformableTransformerDecoder(hd, decoder_layer, ndl, eval_idx) - - # Denoising part - self.denoising_class_embed = nn.Embedding(nc, hd) - self.num_denoising = nd - self.label_noise_ratio = label_noise_ratio - self.box_noise_scale = box_noise_scale - - # Decoder embedding - self.learnt_init_query = learnt_init_query - if learnt_init_query: - self.tgt_embed = nn.Embedding(nq, hd) - self.query_pos_head = MLP(4, 2 * hd, hd, num_layers=2) - - # Encoder head - self.enc_output = nn.Sequential(nn.Linear(hd, hd), nn.LayerNorm(hd)) - self.enc_score_head = nn.Linear(hd, nc) - self.enc_bbox_head = MLP(hd, hd, 4, num_layers=3) - - # Decoder head - self.dec_score_head = nn.ModuleList([nn.Linear(hd, nc) for _ in range(ndl)]) - self.dec_bbox_head = nn.ModuleList([MLP(hd, hd, 4, num_layers=3) for _ in range(ndl)]) - - self._reset_parameters() - - def forward(self, x, batch=None): - """Runs the forward pass of the module, returning bounding box and classification scores for the input.""" - from ultralytics.models.utils.ops import get_cdn_group - - # Input projection and embedding - feats, shapes = self._get_encoder_input(x) - - # Prepare denoising training - dn_embed, dn_bbox, attn_mask, dn_meta = get_cdn_group( - batch, - self.nc, - self.num_queries, - self.denoising_class_embed.weight, - self.num_denoising, - self.label_noise_ratio, - self.box_noise_scale, - self.training, - ) - - embed, refer_bbox, enc_bboxes, enc_scores = self._get_decoder_input(feats, shapes, dn_embed, dn_bbox) - - # Decoder - dec_bboxes, dec_scores = self.decoder( - embed, - refer_bbox, - feats, - shapes, - self.dec_bbox_head, - self.dec_score_head, - self.query_pos_head, - attn_mask=attn_mask, - ) - x = dec_bboxes, dec_scores, enc_bboxes, enc_scores, dn_meta - if self.training: - return x - # (bs, 300, 4+nc) - y = torch.cat((dec_bboxes.squeeze(0), dec_scores.squeeze(0).sigmoid()), -1) - return y if self.export else (y, x) - - def _generate_anchors(self, shapes, grid_size=0.05, dtype=torch.float32, device="cpu", eps=1e-2): - """Generates anchor bounding boxes for given shapes with specific grid size and validates them.""" - anchors = [] - for i, (h, w) in enumerate(shapes): - sy = torch.arange(end=h, dtype=dtype, device=device) - sx = torch.arange(end=w, dtype=dtype, device=device) - grid_y, grid_x = torch.meshgrid(sy, sx, indexing="ij") if TORCH_1_10 else torch.meshgrid(sy, sx) - grid_xy = torch.stack([grid_x, grid_y], -1) # (h, w, 2) - - valid_WH = torch.tensor([w, h], dtype=dtype, device=device) - grid_xy = (grid_xy.unsqueeze(0) + 0.5) / valid_WH # (1, h, w, 2) - wh = torch.ones_like(grid_xy, dtype=dtype, device=device) * grid_size * (2.0**i) - anchors.append(torch.cat([grid_xy, wh], -1).view(-1, h * w, 4)) # (1, h*w, 4) - - anchors = torch.cat(anchors, 1) # (1, h*w*nl, 4) - valid_mask = ((anchors > eps) & (anchors < 1 - eps)).all(-1, keepdim=True) # 1, h*w*nl, 1 - anchors = torch.log(anchors / (1 - anchors)) - anchors = anchors.masked_fill(~valid_mask, float("inf")) - return anchors, valid_mask - - def _get_encoder_input(self, x): - """Processes and returns encoder inputs by getting projection features from input and concatenating them.""" - # Get projection features - x = [self.input_proj[i](feat) for i, feat in enumerate(x)] - # Get encoder inputs - feats = [] - shapes = [] - for feat in x: - h, w = feat.shape[2:] - # [b, c, h, w] -> [b, h*w, c] - feats.append(feat.flatten(2).permute(0, 2, 1)) - # [nl, 2] - shapes.append([h, w]) - - # [b, h*w, c] - feats = torch.cat(feats, 1) - return feats, shapes - - def _get_decoder_input(self, feats, shapes, dn_embed=None, dn_bbox=None): - """Generates and prepares the input required for the decoder from the provided features and shapes.""" - bs = feats.shape[0] - # Prepare input for decoder - anchors, valid_mask = self._generate_anchors(shapes, dtype=feats.dtype, device=feats.device) - features = self.enc_output(valid_mask * feats) # bs, h*w, 256 - - enc_outputs_scores = self.enc_score_head(features) # (bs, h*w, nc) - - # Query selection - # (bs, num_queries) - topk_ind = torch.topk(enc_outputs_scores.max(-1).values, self.num_queries, dim=1).indices.view(-1) - # (bs, num_queries) - batch_ind = torch.arange(end=bs, dtype=topk_ind.dtype).unsqueeze(-1).repeat(1, self.num_queries).view(-1) - - # (bs, num_queries, 256) - top_k_features = features[batch_ind, topk_ind].view(bs, self.num_queries, -1) - # (bs, num_queries, 4) - top_k_anchors = anchors[:, topk_ind].view(bs, self.num_queries, -1) - - # Dynamic anchors + static content - refer_bbox = self.enc_bbox_head(top_k_features) + top_k_anchors - - enc_bboxes = refer_bbox.sigmoid() - if dn_bbox is not None: - refer_bbox = torch.cat([dn_bbox, refer_bbox], 1) - enc_scores = enc_outputs_scores[batch_ind, topk_ind].view(bs, self.num_queries, -1) - - embeddings = self.tgt_embed.weight.unsqueeze(0).repeat(bs, 1, 1) if self.learnt_init_query else top_k_features - if self.training: - refer_bbox = refer_bbox.detach() - if not self.learnt_init_query: - embeddings = embeddings.detach() - if dn_embed is not None: - embeddings = torch.cat([dn_embed, embeddings], 1) - - return embeddings, refer_bbox, enc_bboxes, enc_scores - - # TODO - def _reset_parameters(self): - """Initializes or resets the parameters of the model's various components with predefined weights and biases.""" - # Class and bbox head init - bias_cls = bias_init_with_prob(0.01) / 80 * self.nc - # NOTE: the weight initialization in `linear_init` would cause NaN when training with custom datasets. - # linear_init(self.enc_score_head) - constant_(self.enc_score_head.bias, bias_cls) - constant_(self.enc_bbox_head.layers[-1].weight, 0.0) - constant_(self.enc_bbox_head.layers[-1].bias, 0.0) - for cls_, reg_ in zip(self.dec_score_head, self.dec_bbox_head): - # linear_init(cls_) - constant_(cls_.bias, bias_cls) - constant_(reg_.layers[-1].weight, 0.0) - constant_(reg_.layers[-1].bias, 0.0) - - linear_init(self.enc_output[0]) - xavier_uniform_(self.enc_output[0].weight) - if self.learnt_init_query: - xavier_uniform_(self.tgt_embed.weight) - xavier_uniform_(self.query_pos_head.layers[0].weight) - xavier_uniform_(self.query_pos_head.layers[1].weight) - for layer in self.input_proj: - xavier_uniform_(layer[0].weight) diff --git a/ultralytics-main/ultralytics/nn/modules/transformer.py b/ultralytics-main/ultralytics/nn/modules/transformer.py deleted file mode 100644 index 062c609..0000000 --- a/ultralytics-main/ultralytics/nn/modules/transformer.py +++ /dev/null @@ -1,426 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -"""Transformer modules.""" - -import math - -import torch -import torch.nn as nn -import torch.nn.functional as F -from torch.nn.init import constant_, xavier_uniform_ - -from .conv import Conv -from .utils import _get_clones, inverse_sigmoid, multi_scale_deformable_attn_pytorch - -__all__ = ( - "TransformerEncoderLayer", - "TransformerLayer", - "TransformerBlock", - "MLPBlock", - "LayerNorm2d", - "AIFI", - "DeformableTransformerDecoder", - "DeformableTransformerDecoderLayer", - "MSDeformAttn", - "MLP", -) - - -class TransformerEncoderLayer(nn.Module): - """Defines a single layer of the transformer encoder.""" - - def __init__(self, c1, cm=2048, num_heads=8, dropout=0.0, act=nn.GELU(), normalize_before=False): - """Initialize the TransformerEncoderLayer with specified parameters.""" - super().__init__() - from ...utils.torch_utils import TORCH_1_9 - - if not TORCH_1_9: - raise ModuleNotFoundError( - "TransformerEncoderLayer() requires torch>=1.9 to use nn.MultiheadAttention(batch_first=True)." - ) - self.ma = nn.MultiheadAttention(c1, num_heads, dropout=dropout, batch_first=True) - # Implementation of Feedforward model - self.fc1 = nn.Linear(c1, cm) - self.fc2 = nn.Linear(cm, c1) - - self.norm1 = nn.LayerNorm(c1) - self.norm2 = nn.LayerNorm(c1) - self.dropout = nn.Dropout(dropout) - self.dropout1 = nn.Dropout(dropout) - self.dropout2 = nn.Dropout(dropout) - - self.act = act - self.normalize_before = normalize_before - - @staticmethod - def with_pos_embed(tensor, pos=None): - """Add position embeddings to the tensor if provided.""" - return tensor if pos is None else tensor + pos - - def forward_post(self, src, src_mask=None, src_key_padding_mask=None, pos=None): - """Performs forward pass with post-normalization.""" - q = k = self.with_pos_embed(src, pos) - src2 = self.ma(q, k, value=src, attn_mask=src_mask, key_padding_mask=src_key_padding_mask)[0] - src = src + self.dropout1(src2) - src = self.norm1(src) - src2 = self.fc2(self.dropout(self.act(self.fc1(src)))) - src = src + self.dropout2(src2) - return self.norm2(src) - - def forward_pre(self, src, src_mask=None, src_key_padding_mask=None, pos=None): - """Performs forward pass with pre-normalization.""" - src2 = self.norm1(src) - q = k = self.with_pos_embed(src2, pos) - src2 = self.ma(q, k, value=src2, attn_mask=src_mask, key_padding_mask=src_key_padding_mask)[0] - src = src + self.dropout1(src2) - src2 = self.norm2(src) - src2 = self.fc2(self.dropout(self.act(self.fc1(src2)))) - return src + self.dropout2(src2) - - def forward(self, src, src_mask=None, src_key_padding_mask=None, pos=None): - """Forward propagates the input through the encoder module.""" - if self.normalize_before: - return self.forward_pre(src, src_mask, src_key_padding_mask, pos) - return self.forward_post(src, src_mask, src_key_padding_mask, pos) - - -class AIFI(TransformerEncoderLayer): - """Defines the AIFI transformer layer.""" - - def __init__(self, c1, cm=2048, num_heads=8, dropout=0, act=nn.GELU(), normalize_before=False): - """Initialize the AIFI instance with specified parameters.""" - super().__init__(c1, cm, num_heads, dropout, act, normalize_before) - - def forward(self, x): - """Forward pass for the AIFI transformer layer.""" - c, h, w = x.shape[1:] - pos_embed = self.build_2d_sincos_position_embedding(w, h, c) - # Flatten [B, C, H, W] to [B, HxW, C] - x = super().forward(x.flatten(2).permute(0, 2, 1), pos=pos_embed.to(device=x.device, dtype=x.dtype)) - return x.permute(0, 2, 1).view([-1, c, h, w]).contiguous() - - @staticmethod - def build_2d_sincos_position_embedding(w, h, embed_dim=256, temperature=10000.0): - """Builds 2D sine-cosine position embedding.""" - assert embed_dim % 4 == 0, "Embed dimension must be divisible by 4 for 2D sin-cos position embedding" - grid_w = torch.arange(w, dtype=torch.float32) - grid_h = torch.arange(h, dtype=torch.float32) - grid_w, grid_h = torch.meshgrid(grid_w, grid_h, indexing="ij") - pos_dim = embed_dim // 4 - omega = torch.arange(pos_dim, dtype=torch.float32) / pos_dim - omega = 1.0 / (temperature**omega) - - out_w = grid_w.flatten()[..., None] @ omega[None] - out_h = grid_h.flatten()[..., None] @ omega[None] - - return torch.cat([torch.sin(out_w), torch.cos(out_w), torch.sin(out_h), torch.cos(out_h)], 1)[None] - - -class TransformerLayer(nn.Module): - """Transformer layer https://arxiv.org/abs/2010.11929 (LayerNorm layers removed for better performance).""" - - def __init__(self, c, num_heads): - """Initializes a self-attention mechanism using linear transformations and multi-head attention.""" - super().__init__() - self.q = nn.Linear(c, c, bias=False) - self.k = nn.Linear(c, c, bias=False) - self.v = nn.Linear(c, c, bias=False) - self.ma = nn.MultiheadAttention(embed_dim=c, num_heads=num_heads) - self.fc1 = nn.Linear(c, c, bias=False) - self.fc2 = nn.Linear(c, c, bias=False) - - def forward(self, x): - """Apply a transformer block to the input x and return the output.""" - x = self.ma(self.q(x), self.k(x), self.v(x))[0] + x - return self.fc2(self.fc1(x)) + x - - -class TransformerBlock(nn.Module): - """Vision Transformer https://arxiv.org/abs/2010.11929.""" - - def __init__(self, c1, c2, num_heads, num_layers): - """Initialize a Transformer module with position embedding and specified number of heads and layers.""" - super().__init__() - self.conv = None - if c1 != c2: - self.conv = Conv(c1, c2) - self.linear = nn.Linear(c2, c2) # learnable position embedding - self.tr = nn.Sequential(*(TransformerLayer(c2, num_heads) for _ in range(num_layers))) - self.c2 = c2 - - def forward(self, x): - """Forward propagates the input through the bottleneck module.""" - if self.conv is not None: - x = self.conv(x) - b, _, w, h = x.shape - p = x.flatten(2).permute(2, 0, 1) - return self.tr(p + self.linear(p)).permute(1, 2, 0).reshape(b, self.c2, w, h) - - -class MLPBlock(nn.Module): - """Implements a single block of a multi-layer perceptron.""" - - def __init__(self, embedding_dim, mlp_dim, act=nn.GELU): - """Initialize the MLPBlock with specified embedding dimension, MLP dimension, and activation function.""" - super().__init__() - self.lin1 = nn.Linear(embedding_dim, mlp_dim) - self.lin2 = nn.Linear(mlp_dim, embedding_dim) - self.act = act() - - def forward(self, x: torch.Tensor) -> torch.Tensor: - """Forward pass for the MLPBlock.""" - return self.lin2(self.act(self.lin1(x))) - - -class MLP(nn.Module): - """Implements a simple multi-layer perceptron (also called FFN).""" - - def __init__(self, input_dim, hidden_dim, output_dim, num_layers): - """Initialize the MLP with specified input, hidden, output dimensions and number of layers.""" - super().__init__() - self.num_layers = num_layers - h = [hidden_dim] * (num_layers - 1) - self.layers = nn.ModuleList(nn.Linear(n, k) for n, k in zip([input_dim] + h, h + [output_dim])) - - def forward(self, x): - """Forward pass for the entire MLP.""" - for i, layer in enumerate(self.layers): - x = F.relu(layer(x)) if i < self.num_layers - 1 else layer(x) - return x - - -class LayerNorm2d(nn.Module): - """ - 2D Layer Normalization module inspired by Detectron2 and ConvNeXt implementations. - - Original implementations in - https://github.com/facebookresearch/detectron2/blob/main/detectron2/layers/batch_norm.py - and - https://github.com/facebookresearch/ConvNeXt/blob/main/models/convnext.py. - """ - - def __init__(self, num_channels, eps=1e-6): - """Initialize LayerNorm2d with the given parameters.""" - super().__init__() - self.weight = nn.Parameter(torch.ones(num_channels)) - self.bias = nn.Parameter(torch.zeros(num_channels)) - self.eps = eps - - def forward(self, x): - """Perform forward pass for 2D layer normalization.""" - u = x.mean(1, keepdim=True) - s = (x - u).pow(2).mean(1, keepdim=True) - x = (x - u) / torch.sqrt(s + self.eps) - return self.weight[:, None, None] * x + self.bias[:, None, None] - - -class MSDeformAttn(nn.Module): - """ - Multiscale Deformable Attention Module based on Deformable-DETR and PaddleDetection implementations. - - https://github.com/fundamentalvision/Deformable-DETR/blob/main/models/ops/modules/ms_deform_attn.py - """ - - def __init__(self, d_model=256, n_levels=4, n_heads=8, n_points=4): - """Initialize MSDeformAttn with the given parameters.""" - super().__init__() - if d_model % n_heads != 0: - raise ValueError(f"d_model must be divisible by n_heads, but got {d_model} and {n_heads}") - _d_per_head = d_model // n_heads - # Better to set _d_per_head to a power of 2 which is more efficient in a CUDA implementation - assert _d_per_head * n_heads == d_model, "`d_model` must be divisible by `n_heads`" - - self.im2col_step = 64 - - self.d_model = d_model - self.n_levels = n_levels - self.n_heads = n_heads - self.n_points = n_points - - self.sampling_offsets = nn.Linear(d_model, n_heads * n_levels * n_points * 2) - self.attention_weights = nn.Linear(d_model, n_heads * n_levels * n_points) - self.value_proj = nn.Linear(d_model, d_model) - self.output_proj = nn.Linear(d_model, d_model) - - self._reset_parameters() - - def _reset_parameters(self): - """Reset module parameters.""" - constant_(self.sampling_offsets.weight.data, 0.0) - thetas = torch.arange(self.n_heads, dtype=torch.float32) * (2.0 * math.pi / self.n_heads) - grid_init = torch.stack([thetas.cos(), thetas.sin()], -1) - grid_init = ( - (grid_init / grid_init.abs().max(-1, keepdim=True)[0]) - .view(self.n_heads, 1, 1, 2) - .repeat(1, self.n_levels, self.n_points, 1) - ) - for i in range(self.n_points): - grid_init[:, :, i, :] *= i + 1 - with torch.no_grad(): - self.sampling_offsets.bias = nn.Parameter(grid_init.view(-1)) - constant_(self.attention_weights.weight.data, 0.0) - constant_(self.attention_weights.bias.data, 0.0) - xavier_uniform_(self.value_proj.weight.data) - constant_(self.value_proj.bias.data, 0.0) - xavier_uniform_(self.output_proj.weight.data) - constant_(self.output_proj.bias.data, 0.0) - - def forward(self, query, refer_bbox, value, value_shapes, value_mask=None): - """ - Perform forward pass for multiscale deformable attention. - - https://github.com/PaddlePaddle/PaddleDetection/blob/develop/ppdet/modeling/transformers/deformable_transformer.py - - Args: - query (torch.Tensor): [bs, query_length, C] - refer_bbox (torch.Tensor): [bs, query_length, n_levels, 2], range in [0, 1], top-left (0,0), - bottom-right (1, 1), including padding area - value (torch.Tensor): [bs, value_length, C] - value_shapes (List): [n_levels, 2], [(H_0, W_0), (H_1, W_1), ..., (H_{L-1}, W_{L-1})] - value_mask (Tensor): [bs, value_length], True for non-padding elements, False for padding elements - - Returns: - output (Tensor): [bs, Length_{query}, C] - """ - bs, len_q = query.shape[:2] - len_v = value.shape[1] - assert sum(s[0] * s[1] for s in value_shapes) == len_v - - value = self.value_proj(value) - if value_mask is not None: - value = value.masked_fill(value_mask[..., None], float(0)) - value = value.view(bs, len_v, self.n_heads, self.d_model // self.n_heads) - sampling_offsets = self.sampling_offsets(query).view(bs, len_q, self.n_heads, self.n_levels, self.n_points, 2) - attention_weights = self.attention_weights(query).view(bs, len_q, self.n_heads, self.n_levels * self.n_points) - attention_weights = F.softmax(attention_weights, -1).view(bs, len_q, self.n_heads, self.n_levels, self.n_points) - # N, Len_q, n_heads, n_levels, n_points, 2 - num_points = refer_bbox.shape[-1] - if num_points == 2: - offset_normalizer = torch.as_tensor(value_shapes, dtype=query.dtype, device=query.device).flip(-1) - add = sampling_offsets / offset_normalizer[None, None, None, :, None, :] - sampling_locations = refer_bbox[:, :, None, :, None, :] + add - elif num_points == 4: - add = sampling_offsets / self.n_points * refer_bbox[:, :, None, :, None, 2:] * 0.5 - sampling_locations = refer_bbox[:, :, None, :, None, :2] + add - else: - raise ValueError(f"Last dim of reference_points must be 2 or 4, but got {num_points}.") - output = multi_scale_deformable_attn_pytorch(value, value_shapes, sampling_locations, attention_weights) - return self.output_proj(output) - - -class DeformableTransformerDecoderLayer(nn.Module): - """ - Deformable Transformer Decoder Layer inspired by PaddleDetection and Deformable-DETR implementations. - - https://github.com/PaddlePaddle/PaddleDetection/blob/develop/ppdet/modeling/transformers/deformable_transformer.py - https://github.com/fundamentalvision/Deformable-DETR/blob/main/models/deformable_transformer.py - """ - - def __init__(self, d_model=256, n_heads=8, d_ffn=1024, dropout=0.0, act=nn.ReLU(), n_levels=4, n_points=4): - """Initialize the DeformableTransformerDecoderLayer with the given parameters.""" - super().__init__() - - # Self attention - self.self_attn = nn.MultiheadAttention(d_model, n_heads, dropout=dropout) - self.dropout1 = nn.Dropout(dropout) - self.norm1 = nn.LayerNorm(d_model) - - # Cross attention - self.cross_attn = MSDeformAttn(d_model, n_levels, n_heads, n_points) - self.dropout2 = nn.Dropout(dropout) - self.norm2 = nn.LayerNorm(d_model) - - # FFN - self.linear1 = nn.Linear(d_model, d_ffn) - self.act = act - self.dropout3 = nn.Dropout(dropout) - self.linear2 = nn.Linear(d_ffn, d_model) - self.dropout4 = nn.Dropout(dropout) - self.norm3 = nn.LayerNorm(d_model) - - @staticmethod - def with_pos_embed(tensor, pos): - """Add positional embeddings to the input tensor, if provided.""" - return tensor if pos is None else tensor + pos - - def forward_ffn(self, tgt): - """Perform forward pass through the Feed-Forward Network part of the layer.""" - tgt2 = self.linear2(self.dropout3(self.act(self.linear1(tgt)))) - tgt = tgt + self.dropout4(tgt2) - return self.norm3(tgt) - - def forward(self, embed, refer_bbox, feats, shapes, padding_mask=None, attn_mask=None, query_pos=None): - """Perform the forward pass through the entire decoder layer.""" - - # Self attention - q = k = self.with_pos_embed(embed, query_pos) - tgt = self.self_attn(q.transpose(0, 1), k.transpose(0, 1), embed.transpose(0, 1), attn_mask=attn_mask)[ - 0 - ].transpose(0, 1) - embed = embed + self.dropout1(tgt) - embed = self.norm1(embed) - - # Cross attention - tgt = self.cross_attn( - self.with_pos_embed(embed, query_pos), refer_bbox.unsqueeze(2), feats, shapes, padding_mask - ) - embed = embed + self.dropout2(tgt) - embed = self.norm2(embed) - - # FFN - return self.forward_ffn(embed) - - -class DeformableTransformerDecoder(nn.Module): - """ - Implementation of Deformable Transformer Decoder based on PaddleDetection. - - https://github.com/PaddlePaddle/PaddleDetection/blob/develop/ppdet/modeling/transformers/deformable_transformer.py - """ - - def __init__(self, hidden_dim, decoder_layer, num_layers, eval_idx=-1): - """Initialize the DeformableTransformerDecoder with the given parameters.""" - super().__init__() - self.layers = _get_clones(decoder_layer, num_layers) - self.num_layers = num_layers - self.hidden_dim = hidden_dim - self.eval_idx = eval_idx if eval_idx >= 0 else num_layers + eval_idx - - def forward( - self, - embed, # decoder embeddings - refer_bbox, # anchor - feats, # image features - shapes, # feature shapes - bbox_head, - score_head, - pos_mlp, - attn_mask=None, - padding_mask=None, - ): - """Perform the forward pass through the entire decoder.""" - output = embed - dec_bboxes = [] - dec_cls = [] - last_refined_bbox = None - refer_bbox = refer_bbox.sigmoid() - for i, layer in enumerate(self.layers): - output = layer(output, refer_bbox, feats, shapes, padding_mask, attn_mask, pos_mlp(refer_bbox)) - - bbox = bbox_head[i](output) - refined_bbox = torch.sigmoid(bbox + inverse_sigmoid(refer_bbox)) - - if self.training: - dec_cls.append(score_head[i](output)) - if i == 0: - dec_bboxes.append(refined_bbox) - else: - dec_bboxes.append(torch.sigmoid(bbox + inverse_sigmoid(last_refined_bbox))) - elif i == self.eval_idx: - dec_cls.append(score_head[i](output)) - dec_bboxes.append(refined_bbox) - break - - last_refined_bbox = refined_bbox - refer_bbox = refined_bbox.detach() if self.training else refined_bbox - - return torch.stack(dec_bboxes), torch.stack(dec_cls) diff --git a/ultralytics-main/ultralytics/nn/modules/utils.py b/ultralytics-main/ultralytics/nn/modules/utils.py deleted file mode 100644 index 1512967..0000000 --- a/ultralytics-main/ultralytics/nn/modules/utils.py +++ /dev/null @@ -1,85 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -"""Module utils.""" - -import copy -import math - -import numpy as np -import torch -import torch.nn as nn -import torch.nn.functional as F -from torch.nn.init import uniform_ - -__all__ = "multi_scale_deformable_attn_pytorch", "inverse_sigmoid" - - -def _get_clones(module, n): - """Create a list of cloned modules from the given module.""" - return nn.ModuleList([copy.deepcopy(module) for _ in range(n)]) - - -def bias_init_with_prob(prior_prob=0.01): - """Initialize conv/fc bias value according to a given probability value.""" - return float(-np.log((1 - prior_prob) / prior_prob)) # return bias_init - - -def linear_init(module): - """Initialize the weights and biases of a linear module.""" - bound = 1 / math.sqrt(module.weight.shape[0]) - uniform_(module.weight, -bound, bound) - if hasattr(module, "bias") and module.bias is not None: - uniform_(module.bias, -bound, bound) - - -def inverse_sigmoid(x, eps=1e-5): - """Calculate the inverse sigmoid function for a tensor.""" - x = x.clamp(min=0, max=1) - x1 = x.clamp(min=eps) - x2 = (1 - x).clamp(min=eps) - return torch.log(x1 / x2) - - -def multi_scale_deformable_attn_pytorch( - value: torch.Tensor, - value_spatial_shapes: torch.Tensor, - sampling_locations: torch.Tensor, - attention_weights: torch.Tensor, -) -> torch.Tensor: - """ - Multiscale deformable attention. - - https://github.com/IDEA-Research/detrex/blob/main/detrex/layers/multi_scale_deform_attn.py - """ - - bs, _, num_heads, embed_dims = value.shape - _, num_queries, num_heads, num_levels, num_points, _ = sampling_locations.shape - value_list = value.split([H_ * W_ for H_, W_ in value_spatial_shapes], dim=1) - sampling_grids = 2 * sampling_locations - 1 - sampling_value_list = [] - for level, (H_, W_) in enumerate(value_spatial_shapes): - # bs, H_*W_, num_heads, embed_dims -> - # bs, H_*W_, num_heads*embed_dims -> - # bs, num_heads*embed_dims, H_*W_ -> - # bs*num_heads, embed_dims, H_, W_ - value_l_ = value_list[level].flatten(2).transpose(1, 2).reshape(bs * num_heads, embed_dims, H_, W_) - # bs, num_queries, num_heads, num_points, 2 -> - # bs, num_heads, num_queries, num_points, 2 -> - # bs*num_heads, num_queries, num_points, 2 - sampling_grid_l_ = sampling_grids[:, :, :, level].transpose(1, 2).flatten(0, 1) - # bs*num_heads, embed_dims, num_queries, num_points - sampling_value_l_ = F.grid_sample( - value_l_, sampling_grid_l_, mode="bilinear", padding_mode="zeros", align_corners=False - ) - sampling_value_list.append(sampling_value_l_) - # (bs, num_queries, num_heads, num_levels, num_points) -> - # (bs, num_heads, num_queries, num_levels, num_points) -> - # (bs, num_heads, 1, num_queries, num_levels*num_points) - attention_weights = attention_weights.transpose(1, 2).reshape( - bs * num_heads, 1, num_queries, num_levels * num_points - ) - output = ( - (torch.stack(sampling_value_list, dim=-2).flatten(-2) * attention_weights) - .sum(-1) - .view(bs, num_heads * embed_dims, num_queries) - ) - return output.transpose(1, 2).contiguous() diff --git a/ultralytics-main/ultralytics/nn/tasks.py b/ultralytics-main/ultralytics/nn/tasks.py deleted file mode 100644 index 64ee7f5..0000000 --- a/ultralytics-main/ultralytics/nn/tasks.py +++ /dev/null @@ -1,1037 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import contextlib -from copy import deepcopy -from pathlib import Path - -import torch -import torch.nn as nn - -from ultralytics.nn.modules import ( - AIFI, - C1, - C2, - C3, - C3TR, - OBB, - SPP, - SPPF, - Bottleneck, - BottleneckCSP, - C2f, - C2fAttn, - ImagePoolingAttn, - C3Ghost, - C3x, - Classify, - Concat, - Conv, - Conv2, - ConvTranspose, - Detect, - DWConv, - DWConvTranspose2d, - Focus, - GhostBottleneck, - GhostConv, - HGBlock, - HGStem, - Pose, - RepC3, - RepConv, - ResNetLayer, - RTDETRDecoder, - Segment, - WorldDetect, - RepNCSPELAN4, - ADown, - SPPELAN, - CBFuse, - CBLinear, - Silence, -) -from ultralytics.utils import DEFAULT_CFG_DICT, DEFAULT_CFG_KEYS, LOGGER, colorstr, emojis, yaml_load -from ultralytics.utils.checks import check_requirements, check_suffix, check_yaml -from ultralytics.utils.loss import v8ClassificationLoss, v8DetectionLoss, v8OBBLoss, v8PoseLoss, v8SegmentationLoss -from ultralytics.utils.plotting import feature_visualization -from ultralytics.utils.torch_utils import ( - fuse_conv_and_bn, - fuse_deconv_and_bn, - initialize_weights, - intersect_dicts, - make_divisible, - model_info, - scale_img, - time_sync, -) - -try: - import thop -except ImportError: - thop = None - - -class BaseModel(nn.Module): - """The BaseModel class serves as a base class for all the models in the Ultralytics YOLO family.""" - - def forward(self, x, *args, **kwargs): - """ - Forward pass of the model on a single scale. Wrapper for `_forward_once` method. - - Args: - x (torch.Tensor | dict): The input image tensor or a dict including image tensor and gt labels. - - Returns: - (torch.Tensor): The output of the network. - """ - if isinstance(x, dict): # for cases of training and validating while training. - return self.loss(x, *args, **kwargs) - return self.predict(x, *args, **kwargs) - - def predict(self, x, profile=False, visualize=False, augment=False, embed=None): - """ - Perform a forward pass through the network. - - Args: - x (torch.Tensor): The input tensor to the model. - profile (bool): Print the computation time of each layer if True, defaults to False. - visualize (bool): Save the feature maps of the model if True, defaults to False. - augment (bool): Augment image during prediction, defaults to False. - embed (list, optional): A list of feature vectors/embeddings to return. - - Returns: - (torch.Tensor): The last output of the model. - """ - if augment: - return self._predict_augment(x) - return self._predict_once(x, profile, visualize, embed) - - def _predict_once(self, x, profile=False, visualize=False, embed=None): - """ - Perform a forward pass through the network. - - Args: - x (torch.Tensor): The input tensor to the model. - profile (bool): Print the computation time of each layer if True, defaults to False. - visualize (bool): Save the feature maps of the model if True, defaults to False. - embed (list, optional): A list of feature vectors/embeddings to return. - - Returns: - (torch.Tensor): The last output of the model. - """ - y, dt, embeddings = [], [], [] # outputs - for m in self.model: - if m.f != -1: # if not from previous layer - x = y[m.f] if isinstance(m.f, int) else [x if j == -1 else y[j] for j in m.f] # from earlier layers - if profile: - self._profile_one_layer(m, x, dt) - x = m(x) # run - y.append(x if m.i in self.save else None) # save output - if visualize: - feature_visualization(x, m.type, m.i, save_dir=visualize) - if embed and m.i in embed: - embeddings.append(nn.functional.adaptive_avg_pool2d(x, (1, 1)).squeeze(-1).squeeze(-1)) # flatten - if m.i == max(embed): - return torch.unbind(torch.cat(embeddings, 1), dim=0) - return x - - def _predict_augment(self, x): - """Perform augmentations on input image x and return augmented inference.""" - LOGGER.warning( - f"WARNING ⚠️ {self.__class__.__name__} does not support augmented inference yet. " - f"Reverting to single-scale inference instead." - ) - return self._predict_once(x) - - def _profile_one_layer(self, m, x, dt): - """ - Profile the computation time and FLOPs of a single layer of the model on a given input. Appends the results to - the provided list. - - Args: - m (nn.Module): The layer to be profiled. - x (torch.Tensor): The input data to the layer. - dt (list): A list to store the computation time of the layer. - - Returns: - None - """ - c = m == self.model[-1] and isinstance(x, list) # is final layer list, copy input as inplace fix - flops = thop.profile(m, inputs=[x.copy() if c else x], verbose=False)[0] / 1e9 * 2 if thop else 0 # FLOPs - t = time_sync() - for _ in range(10): - m(x.copy() if c else x) - dt.append((time_sync() - t) * 100) - if m == self.model[0]: - LOGGER.info(f"{'time (ms)':>10s} {'GFLOPs':>10s} {'params':>10s} module") - LOGGER.info(f"{dt[-1]:10.2f} {flops:10.2f} {m.np:10.0f} {m.type}") - if c: - LOGGER.info(f"{sum(dt):10.2f} {'-':>10s} {'-':>10s} Total") - - def fuse(self, verbose=True): - """ - Fuse the `Conv2d()` and `BatchNorm2d()` layers of the model into a single layer, in order to improve the - computation efficiency. - - Returns: - (nn.Module): The fused model is returned. - """ - if not self.is_fused(): - for m in self.model.modules(): - if isinstance(m, (Conv, Conv2, DWConv)) and hasattr(m, "bn"): - if isinstance(m, Conv2): - m.fuse_convs() - m.conv = fuse_conv_and_bn(m.conv, m.bn) # update conv - delattr(m, "bn") # remove batchnorm - m.forward = m.forward_fuse # update forward - if isinstance(m, ConvTranspose) and hasattr(m, "bn"): - m.conv_transpose = fuse_deconv_and_bn(m.conv_transpose, m.bn) - delattr(m, "bn") # remove batchnorm - m.forward = m.forward_fuse # update forward - if isinstance(m, RepConv): - m.fuse_convs() - m.forward = m.forward_fuse # update forward - self.info(verbose=verbose) - - return self - - def is_fused(self, thresh=10): - """ - Check if the model has less than a certain threshold of BatchNorm layers. - - Args: - thresh (int, optional): The threshold number of BatchNorm layers. Default is 10. - - Returns: - (bool): True if the number of BatchNorm layers in the model is less than the threshold, False otherwise. - """ - bn = tuple(v for k, v in nn.__dict__.items() if "Norm" in k) # normalization layers, i.e. BatchNorm2d() - return sum(isinstance(v, bn) for v in self.modules()) < thresh # True if < 'thresh' BatchNorm layers in model - - def info(self, detailed=False, verbose=True, imgsz=640): - """ - Prints model information. - - Args: - detailed (bool): if True, prints out detailed information about the model. Defaults to False - verbose (bool): if True, prints out the model information. Defaults to False - imgsz (int): the size of the image that the model will be trained on. Defaults to 640 - """ - return model_info(self, detailed=detailed, verbose=verbose, imgsz=imgsz) - - def _apply(self, fn): - """ - Applies a function to all the tensors in the model that are not parameters or registered buffers. - - Args: - fn (function): the function to apply to the model - - Returns: - (BaseModel): An updated BaseModel object. - """ - self = super()._apply(fn) - m = self.model[-1] # Detect() - if isinstance(m, Detect): # includes all Detect subclasses like Segment, Pose, OBB, WorldDetect - m.stride = fn(m.stride) - m.anchors = fn(m.anchors) - m.strides = fn(m.strides) - return self - - def load(self, weights, verbose=True): - """ - Load the weights into the model. - - Args: - weights (dict | torch.nn.Module): The pre-trained weights to be loaded. - verbose (bool, optional): Whether to log the transfer progress. Defaults to True. - """ - model = weights["model"] if isinstance(weights, dict) else weights # torchvision models are not dicts - csd = model.float().state_dict() # checkpoint state_dict as FP32 - csd = intersect_dicts(csd, self.state_dict()) # intersect - self.load_state_dict(csd, strict=False) # load - if verbose: - LOGGER.info(f"Transferred {len(csd)}/{len(self.model.state_dict())} items from pretrained weights") - - def loss(self, batch, preds=None): - """ - Compute loss. - - Args: - batch (dict): Batch to compute loss on - preds (torch.Tensor | List[torch.Tensor]): Predictions. - """ - if not hasattr(self, "criterion"): - self.criterion = self.init_criterion() - - preds = self.forward(batch["img"]) if preds is None else preds - return self.criterion(preds, batch) - - def init_criterion(self): - """Initialize the loss criterion for the BaseModel.""" - raise NotImplementedError("compute_loss() needs to be implemented by task heads") - - -class DetectionModel(BaseModel): - """YOLOv8 detection model.""" - - def __init__(self, cfg="yolov8n.yaml", ch=3, nc=None, verbose=True): # model, input channels, number of classes - """Initialize the YOLOv8 detection model with the given config and parameters.""" - super().__init__() - self.yaml = cfg if isinstance(cfg, dict) else yaml_model_load(cfg) # cfg dict - - # Define model - ch = self.yaml["ch"] = self.yaml.get("ch", ch) # input channels - if nc and nc != self.yaml["nc"]: - LOGGER.info(f"Overriding model.yaml nc={self.yaml['nc']} with nc={nc}") - self.yaml["nc"] = nc # override YAML value - self.model, self.save = parse_model(deepcopy(self.yaml), ch=ch, verbose=verbose) # model, savelist - self.names = {i: f"{i}" for i in range(self.yaml["nc"])} # default names dict - self.inplace = self.yaml.get("inplace", True) - - # Build strides - m = self.model[-1] # Detect() - if isinstance(m, Detect): # includes all Detect subclasses like Segment, Pose, OBB, WorldDetect - s = 256 # 2x min stride - m.inplace = self.inplace - forward = lambda x: self.forward(x)[0] if isinstance(m, (Segment, Pose, OBB)) else self.forward(x) - m.stride = torch.tensor([s / x.shape[-2] for x in forward(torch.zeros(1, ch, s, s))]) # forward - self.stride = m.stride - m.bias_init() # only run once - else: - self.stride = torch.Tensor([32]) # default stride for i.e. RTDETR - - # Init weights, biases - initialize_weights(self) - if verbose: - self.info() - LOGGER.info("") - - def _predict_augment(self, x): - """Perform augmentations on input image x and return augmented inference and train outputs.""" - img_size = x.shape[-2:] # height, width - s = [1, 0.83, 0.67] # scales - f = [None, 3, None] # flips (2-ud, 3-lr) - y = [] # outputs - for si, fi in zip(s, f): - xi = scale_img(x.flip(fi) if fi else x, si, gs=int(self.stride.max())) - yi = super().predict(xi)[0] # forward - yi = self._descale_pred(yi, fi, si, img_size) - y.append(yi) - y = self._clip_augmented(y) # clip augmented tails - return torch.cat(y, -1), None # augmented inference, train - - @staticmethod - def _descale_pred(p, flips, scale, img_size, dim=1): - """De-scale predictions following augmented inference (inverse operation).""" - p[:, :4] /= scale # de-scale - x, y, wh, cls = p.split((1, 1, 2, p.shape[dim] - 4), dim) - if flips == 2: - y = img_size[0] - y # de-flip ud - elif flips == 3: - x = img_size[1] - x # de-flip lr - return torch.cat((x, y, wh, cls), dim) - - def _clip_augmented(self, y): - """Clip YOLO augmented inference tails.""" - nl = self.model[-1].nl # number of detection layers (P3-P5) - g = sum(4**x for x in range(nl)) # grid points - e = 1 # exclude layer count - i = (y[0].shape[-1] // g) * sum(4**x for x in range(e)) # indices - y[0] = y[0][..., :-i] # large - i = (y[-1].shape[-1] // g) * sum(4 ** (nl - 1 - x) for x in range(e)) # indices - y[-1] = y[-1][..., i:] # small - return y - - def init_criterion(self): - """Initialize the loss criterion for the DetectionModel.""" - return v8DetectionLoss(self) - - -class OBBModel(DetectionModel): - """YOLOv8 Oriented Bounding Box (OBB) model.""" - - def __init__(self, cfg="yolov8n-obb.yaml", ch=3, nc=None, verbose=True): - """Initialize YOLOv8 OBB model with given config and parameters.""" - super().__init__(cfg=cfg, ch=ch, nc=nc, verbose=verbose) - - def init_criterion(self): - """Initialize the loss criterion for the model.""" - return v8OBBLoss(self) - - -class SegmentationModel(DetectionModel): - """YOLOv8 segmentation model.""" - - def __init__(self, cfg="yolov8n-seg.yaml", ch=3, nc=None, verbose=True): - """Initialize YOLOv8 segmentation model with given config and parameters.""" - super().__init__(cfg=cfg, ch=ch, nc=nc, verbose=verbose) - - def init_criterion(self): - """Initialize the loss criterion for the SegmentationModel.""" - return v8SegmentationLoss(self) - - -class PoseModel(DetectionModel): - """YOLOv8 pose model.""" - - def __init__(self, cfg="yolov8n-pose.yaml", ch=3, nc=None, data_kpt_shape=(None, None), verbose=True): - """Initialize YOLOv8 Pose model.""" - if not isinstance(cfg, dict): - cfg = yaml_model_load(cfg) # load model YAML - if any(data_kpt_shape) and list(data_kpt_shape) != list(cfg["kpt_shape"]): - LOGGER.info(f"Overriding model.yaml kpt_shape={cfg['kpt_shape']} with kpt_shape={data_kpt_shape}") - cfg["kpt_shape"] = data_kpt_shape - super().__init__(cfg=cfg, ch=ch, nc=nc, verbose=verbose) - - def init_criterion(self): - """Initialize the loss criterion for the PoseModel.""" - return v8PoseLoss(self) - - -class ClassificationModel(BaseModel): - """YOLOv8 classification model.""" - - def __init__(self, cfg="yolov8n-cls.yaml", ch=3, nc=None, verbose=True): - """Init ClassificationModel with YAML, channels, number of classes, verbose flag.""" - super().__init__() - self._from_yaml(cfg, ch, nc, verbose) - - def _from_yaml(self, cfg, ch, nc, verbose): - """Set YOLOv8 model configurations and define the model architecture.""" - self.yaml = cfg if isinstance(cfg, dict) else yaml_model_load(cfg) # cfg dict - - # Define model - ch = self.yaml["ch"] = self.yaml.get("ch", ch) # input channels - if nc and nc != self.yaml["nc"]: - LOGGER.info(f"Overriding model.yaml nc={self.yaml['nc']} with nc={nc}") - self.yaml["nc"] = nc # override YAML value - elif not nc and not self.yaml.get("nc", None): - raise ValueError("nc not specified. Must specify nc in model.yaml or function arguments.") - self.model, self.save = parse_model(deepcopy(self.yaml), ch=ch, verbose=verbose) # model, savelist - self.stride = torch.Tensor([1]) # no stride constraints - self.names = {i: f"{i}" for i in range(self.yaml["nc"])} # default names dict - self.info() - - @staticmethod - def reshape_outputs(model, nc): - """Update a TorchVision classification model to class count 'n' if required.""" - name, m = list((model.model if hasattr(model, "model") else model).named_children())[-1] # last module - if isinstance(m, Classify): # YOLO Classify() head - if m.linear.out_features != nc: - m.linear = nn.Linear(m.linear.in_features, nc) - elif isinstance(m, nn.Linear): # ResNet, EfficientNet - if m.out_features != nc: - setattr(model, name, nn.Linear(m.in_features, nc)) - elif isinstance(m, nn.Sequential): - types = [type(x) for x in m] - if nn.Linear in types: - i = types.index(nn.Linear) # nn.Linear index - if m[i].out_features != nc: - m[i] = nn.Linear(m[i].in_features, nc) - elif nn.Conv2d in types: - i = types.index(nn.Conv2d) # nn.Conv2d index - if m[i].out_channels != nc: - m[i] = nn.Conv2d(m[i].in_channels, nc, m[i].kernel_size, m[i].stride, bias=m[i].bias is not None) - - def init_criterion(self): - """Initialize the loss criterion for the ClassificationModel.""" - return v8ClassificationLoss() - - -class RTDETRDetectionModel(DetectionModel): - """ - RTDETR (Real-time DEtection and Tracking using Transformers) Detection Model class. - - This class is responsible for constructing the RTDETR architecture, defining loss functions, and facilitating both - the training and inference processes. RTDETR is an object detection and tracking model that extends from the - DetectionModel base class. - - Attributes: - cfg (str): The configuration file path or preset string. Default is 'rtdetr-l.yaml'. - ch (int): Number of input channels. Default is 3 (RGB). - nc (int, optional): Number of classes for object detection. Default is None. - verbose (bool): Specifies if summary statistics are shown during initialization. Default is True. - - Methods: - init_criterion: Initializes the criterion used for loss calculation. - loss: Computes and returns the loss during training. - predict: Performs a forward pass through the network and returns the output. - """ - - def __init__(self, cfg="rtdetr-l.yaml", ch=3, nc=None, verbose=True): - """ - Initialize the RTDETRDetectionModel. - - Args: - cfg (str): Configuration file name or path. - ch (int): Number of input channels. - nc (int, optional): Number of classes. Defaults to None. - verbose (bool, optional): Print additional information during initialization. Defaults to True. - """ - super().__init__(cfg=cfg, ch=ch, nc=nc, verbose=verbose) - - def init_criterion(self): - """Initialize the loss criterion for the RTDETRDetectionModel.""" - from ultralytics.models.utils.loss import RTDETRDetectionLoss - - return RTDETRDetectionLoss(nc=self.nc, use_vfl=True) - - def loss(self, batch, preds=None): - """ - Compute the loss for the given batch of data. - - Args: - batch (dict): Dictionary containing image and label data. - preds (torch.Tensor, optional): Precomputed model predictions. Defaults to None. - - Returns: - (tuple): A tuple containing the total loss and main three losses in a tensor. - """ - if not hasattr(self, "criterion"): - self.criterion = self.init_criterion() - - img = batch["img"] - # NOTE: preprocess gt_bbox and gt_labels to list. - bs = len(img) - batch_idx = batch["batch_idx"] - gt_groups = [(batch_idx == i).sum().item() for i in range(bs)] - targets = { - "cls": batch["cls"].to(img.device, dtype=torch.long).view(-1), - "bboxes": batch["bboxes"].to(device=img.device), - "batch_idx": batch_idx.to(img.device, dtype=torch.long).view(-1), - "gt_groups": gt_groups, - } - - preds = self.predict(img, batch=targets) if preds is None else preds - dec_bboxes, dec_scores, enc_bboxes, enc_scores, dn_meta = preds if self.training else preds[1] - if dn_meta is None: - dn_bboxes, dn_scores = None, None - else: - dn_bboxes, dec_bboxes = torch.split(dec_bboxes, dn_meta["dn_num_split"], dim=2) - dn_scores, dec_scores = torch.split(dec_scores, dn_meta["dn_num_split"], dim=2) - - dec_bboxes = torch.cat([enc_bboxes.unsqueeze(0), dec_bboxes]) # (7, bs, 300, 4) - dec_scores = torch.cat([enc_scores.unsqueeze(0), dec_scores]) - - loss = self.criterion( - (dec_bboxes, dec_scores), targets, dn_bboxes=dn_bboxes, dn_scores=dn_scores, dn_meta=dn_meta - ) - # NOTE: There are like 12 losses in RTDETR, backward with all losses but only show the main three losses. - return sum(loss.values()), torch.as_tensor( - [loss[k].detach() for k in ["loss_giou", "loss_class", "loss_bbox"]], device=img.device - ) - - def predict(self, x, profile=False, visualize=False, batch=None, augment=False, embed=None): - """ - Perform a forward pass through the model. - - Args: - x (torch.Tensor): The input tensor. - profile (bool, optional): If True, profile the computation time for each layer. Defaults to False. - visualize (bool, optional): If True, save feature maps for visualization. Defaults to False. - batch (dict, optional): Ground truth data for evaluation. Defaults to None. - augment (bool, optional): If True, perform data augmentation during inference. Defaults to False. - embed (list, optional): A list of feature vectors/embeddings to return. - - Returns: - (torch.Tensor): Model's output tensor. - """ - y, dt, embeddings = [], [], [] # outputs - for m in self.model[:-1]: # except the head part - if m.f != -1: # if not from previous layer - x = y[m.f] if isinstance(m.f, int) else [x if j == -1 else y[j] for j in m.f] # from earlier layers - if profile: - self._profile_one_layer(m, x, dt) - x = m(x) # run - y.append(x if m.i in self.save else None) # save output - if visualize: - feature_visualization(x, m.type, m.i, save_dir=visualize) - if embed and m.i in embed: - embeddings.append(nn.functional.adaptive_avg_pool2d(x, (1, 1)).squeeze(-1).squeeze(-1)) # flatten - if m.i == max(embed): - return torch.unbind(torch.cat(embeddings, 1), dim=0) - head = self.model[-1] - x = head([y[j] for j in head.f], batch) # head inference - return x - - -class WorldModel(DetectionModel): - """YOLOv8 World Model.""" - - def __init__(self, cfg="yolov8s-world.yaml", ch=3, nc=None, verbose=True): - """Initialize YOLOv8 world model with given config and parameters.""" - self.txt_feats = torch.randn(1, nc or 80, 512) # placeholder - super().__init__(cfg=cfg, ch=ch, nc=nc, verbose=verbose) - - def set_classes(self, text): - """Perform a forward pass with optional profiling, visualization, and embedding extraction.""" - try: - import clip - except ImportError: - check_requirements("git+https://github.com/openai/CLIP.git") - import clip - - model, _ = clip.load("ViT-B/32") - device = next(model.parameters()).device - text_token = clip.tokenize(text).to(device) - txt_feats = model.encode_text(text_token).to(dtype=torch.float32) - txt_feats = txt_feats / txt_feats.norm(p=2, dim=-1, keepdim=True) - self.txt_feats = txt_feats.reshape(-1, len(text), txt_feats.shape[-1]).detach() - self.model[-1].nc = len(text) - - def init_criterion(self): - """Initialize the loss criterion for the model.""" - raise NotImplementedError - - def predict(self, x, profile=False, visualize=False, augment=False, embed=None): - """ - Perform a forward pass through the model. - - Args: - x (torch.Tensor): The input tensor. - profile (bool, optional): If True, profile the computation time for each layer. Defaults to False. - visualize (bool, optional): If True, save feature maps for visualization. Defaults to False. - augment (bool, optional): If True, perform data augmentation during inference. Defaults to False. - embed (list, optional): A list of feature vectors/embeddings to return. - - Returns: - (torch.Tensor): Model's output tensor. - """ - txt_feats = self.txt_feats.to(device=x.device, dtype=x.dtype) - if len(txt_feats) != len(x): - txt_feats = txt_feats.repeat(len(x), 1, 1) - ori_txt_feats = txt_feats.clone() - y, dt, embeddings = [], [], [] # outputs - for m in self.model: # except the head part - if m.f != -1: # if not from previous layer - x = y[m.f] if isinstance(m.f, int) else [x if j == -1 else y[j] for j in m.f] # from earlier layers - if profile: - self._profile_one_layer(m, x, dt) - if isinstance(m, C2fAttn): - x = m(x, txt_feats) - elif isinstance(m, WorldDetect): - x = m(x, ori_txt_feats) - elif isinstance(m, ImagePoolingAttn): - txt_feats = m(x, txt_feats) - else: - x = m(x) # run - - y.append(x if m.i in self.save else None) # save output - if visualize: - feature_visualization(x, m.type, m.i, save_dir=visualize) - if embed and m.i in embed: - embeddings.append(nn.functional.adaptive_avg_pool2d(x, (1, 1)).squeeze(-1).squeeze(-1)) # flatten - if m.i == max(embed): - return torch.unbind(torch.cat(embeddings, 1), dim=0) - return x - - -class Ensemble(nn.ModuleList): - """Ensemble of models.""" - - def __init__(self): - """Initialize an ensemble of models.""" - super().__init__() - - def forward(self, x, augment=False, profile=False, visualize=False): - """Function generates the YOLO network's final layer.""" - y = [module(x, augment, profile, visualize)[0] for module in self] - # y = torch.stack(y).max(0)[0] # max ensemble - # y = torch.stack(y).mean(0) # mean ensemble - y = torch.cat(y, 2) # nms ensemble, y shape(B, HW, C) - return y, None # inference, train output - - -# Functions ------------------------------------------------------------------------------------------------------------ - - -@contextlib.contextmanager -def temporary_modules(modules=None): - """ - Context manager for temporarily adding or modifying modules in Python's module cache (`sys.modules`). - - This function can be used to change the module paths during runtime. It's useful when refactoring code, - where you've moved a module from one location to another, but you still want to support the old import - paths for backwards compatibility. - - Args: - modules (dict, optional): A dictionary mapping old module paths to new module paths. - - Example: - ```python - with temporary_modules({'old.module.path': 'new.module.path'}): - import old.module.path # this will now import new.module.path - ``` - - Note: - The changes are only in effect inside the context manager and are undone once the context manager exits. - Be aware that directly manipulating `sys.modules` can lead to unpredictable results, especially in larger - applications or libraries. Use this function with caution. - """ - if not modules: - modules = {} - - import importlib - import sys - - try: - # Set modules in sys.modules under their old name - for old, new in modules.items(): - sys.modules[old] = importlib.import_module(new) - - yield - finally: - # Remove the temporary module paths - for old in modules: - if old in sys.modules: - del sys.modules[old] - - -def torch_safe_load(weight): - """ - This function attempts to load a PyTorch model with the torch.load() function. If a ModuleNotFoundError is raised, - it catches the error, logs a warning message, and attempts to install the missing module via the - check_requirements() function. After installation, the function again attempts to load the model using torch.load(). - - Args: - weight (str): The file path of the PyTorch model. - - Returns: - (dict): The loaded PyTorch model. - """ - from ultralytics.utils.downloads import attempt_download_asset - - check_suffix(file=weight, suffix=".pt") - file = attempt_download_asset(weight) # search online if missing locally - try: - with temporary_modules( - { - "ultralytics.yolo.utils": "ultralytics.utils", - "ultralytics.yolo.v8": "ultralytics.models.yolo", - "ultralytics.yolo.data": "ultralytics.data", - } - ): # for legacy 8.0 Classify and Pose models - ckpt = torch.load(file, map_location="cpu") - - except ModuleNotFoundError as e: # e.name is missing module name - if e.name == "models": - raise TypeError( - emojis( - f"ERROR ❌️ {weight} appears to be an Ultralytics YOLOv5 model originally trained " - f"with https://github.com/ultralytics/yolov5.\nThis model is NOT forwards compatible with " - f"YOLOv8 at https://github.com/ultralytics/ultralytics." - f"\nRecommend fixes are to train a new model using the latest 'ultralytics' package or to " - f"run a command with an official YOLOv8 model, i.e. 'yolo predict model=yolov8n.pt'" - ) - ) from e - LOGGER.warning( - f"WARNING ⚠️ {weight} appears to require '{e.name}', which is not in ultralytics requirements." - f"\nAutoInstall will run now for '{e.name}' but this feature will be removed in the future." - f"\nRecommend fixes are to train a new model using the latest 'ultralytics' package or to " - f"run a command with an official YOLOv8 model, i.e. 'yolo predict model=yolov8n.pt'" - ) - check_requirements(e.name) # install missing module - ckpt = torch.load(file, map_location="cpu") - - if not isinstance(ckpt, dict): - # File is likely a YOLO instance saved with i.e. torch.save(model, "saved_model.pt") - LOGGER.warning( - f"WARNING ⚠️ The file '{weight}' appears to be improperly saved or formatted. " - f"For optimal results, use model.save('filename.pt') to correctly save YOLO models." - ) - ckpt = {"model": ckpt.model} - - return ckpt, file # load - - -def attempt_load_weights(weights, device=None, inplace=True, fuse=False): - """Loads an ensemble of models weights=[a,b,c] or a single model weights=[a] or weights=a.""" - - ensemble = Ensemble() - for w in weights if isinstance(weights, list) else [weights]: - ckpt, w = torch_safe_load(w) # load ckpt - args = {**DEFAULT_CFG_DICT, **ckpt["train_args"]} if "train_args" in ckpt else None # combined args - model = (ckpt.get("ema") or ckpt["model"]).to(device).float() # FP32 model - - # Model compatibility updates - model.args = args # attach args to model - model.pt_path = w # attach *.pt file path to model - model.task = guess_model_task(model) - if not hasattr(model, "stride"): - model.stride = torch.tensor([32.0]) - - # Append - ensemble.append(model.fuse().eval() if fuse and hasattr(model, "fuse") else model.eval()) # model in eval mode - - # Module updates - for m in ensemble.modules(): - if hasattr(m, "inplace"): - m.inplace = inplace - elif isinstance(m, nn.Upsample) and not hasattr(m, "recompute_scale_factor"): - m.recompute_scale_factor = None # torch 1.11.0 compatibility - - # Return model - if len(ensemble) == 1: - return ensemble[-1] - - # Return ensemble - LOGGER.info(f"Ensemble created with {weights}\n") - for k in "names", "nc", "yaml": - setattr(ensemble, k, getattr(ensemble[0], k)) - ensemble.stride = ensemble[int(torch.argmax(torch.tensor([m.stride.max() for m in ensemble])))].stride - assert all(ensemble[0].nc == m.nc for m in ensemble), f"Models differ in class counts {[m.nc for m in ensemble]}" - return ensemble - - -def attempt_load_one_weight(weight, device=None, inplace=True, fuse=False): - """Loads a single model weights.""" - ckpt, weight = torch_safe_load(weight) # load ckpt - args = {**DEFAULT_CFG_DICT, **(ckpt.get("train_args", {}))} # combine model and default args, preferring model args - model = (ckpt.get("ema") or ckpt["model"]).to(device).float() # FP32 model - - # Model compatibility updates - model.args = {k: v for k, v in args.items() if k in DEFAULT_CFG_KEYS} # attach args to model - model.pt_path = weight # attach *.pt file path to model - model.task = guess_model_task(model) - if not hasattr(model, "stride"): - model.stride = torch.tensor([32.0]) - - model = model.fuse().eval() if fuse and hasattr(model, "fuse") else model.eval() # model in eval mode - - # Module updates - for m in model.modules(): - if hasattr(m, "inplace"): - m.inplace = inplace - elif isinstance(m, nn.Upsample) and not hasattr(m, "recompute_scale_factor"): - m.recompute_scale_factor = None # torch 1.11.0 compatibility - - # Return model and ckpt - return model, ckpt - - -def parse_model(d, ch, verbose=True): # model_dict, input_channels(3) - """Parse a YOLO model.yaml dictionary into a PyTorch model.""" - import ast - - # Args - max_channels = float("inf") - nc, act, scales = (d.get(x) for x in ("nc", "activation", "scales")) - depth, width, kpt_shape = (d.get(x, 1.0) for x in ("depth_multiple", "width_multiple", "kpt_shape")) - if scales: - scale = d.get("scale") - if not scale: - scale = tuple(scales.keys())[0] - LOGGER.warning(f"WARNING ⚠️ no model scale passed. Assuming scale='{scale}'.") - depth, width, max_channels = scales[scale] - - if act: - Conv.default_act = eval(act) # redefine default activation, i.e. Conv.default_act = nn.SiLU() - if verbose: - LOGGER.info(f"{colorstr('activation:')} {act}") # print - - if verbose: - LOGGER.info(f"\n{'':>3}{'from':>20}{'n':>3}{'params':>10} {'module':<45}{'arguments':<30}") - ch = [ch] - layers, save, c2 = [], [], ch[-1] # layers, savelist, ch out - for i, (f, n, m, args) in enumerate(d["backbone"] + d["head"]): # from, number, module, args - m = getattr(torch.nn, m[3:]) if "nn." in m else globals()[m] # get module - for j, a in enumerate(args): - if isinstance(a, str): - with contextlib.suppress(ValueError): - args[j] = locals()[a] if a in locals() else ast.literal_eval(a) - - n = n_ = max(round(n * depth), 1) if n > 1 else n # depth gain - if m in ( - Classify, - Conv, - ConvTranspose, - GhostConv, - Bottleneck, - GhostBottleneck, - SPP, - SPPF, - DWConv, - Focus, - BottleneckCSP, - C1, - C2, - C2f, - RepNCSPELAN4, - ADown, - SPPELAN, - C2fAttn, - C3, - C3TR, - C3Ghost, - nn.ConvTranspose2d, - DWConvTranspose2d, - C3x, - RepC3, - ): - c1, c2 = ch[f], args[0] - if c2 != nc: # if c2 not equal to number of classes (i.e. for Classify() output) - c2 = make_divisible(min(c2, max_channels) * width, 8) - if m is C2fAttn: - args[1] = make_divisible(min(args[1], max_channels // 2) * width, 8) # embed channels - args[2] = int( - max(round(min(args[2], max_channels // 2 // 32)) * width, 1) if args[2] > 1 else args[2] - ) # num heads - - args = [c1, c2, *args[1:]] - if m in (BottleneckCSP, C1, C2, C2f, C2fAttn, C3, C3TR, C3Ghost, C3x, RepC3): - args.insert(2, n) # number of repeats - n = 1 - elif m is AIFI: - args = [ch[f], *args] - elif m in (HGStem, HGBlock): - c1, cm, c2 = ch[f], args[0], args[1] - args = [c1, cm, c2, *args[2:]] - if m is HGBlock: - args.insert(4, n) # number of repeats - n = 1 - elif m is ResNetLayer: - c2 = args[1] if args[3] else args[1] * 4 - elif m is nn.BatchNorm2d: - args = [ch[f]] - elif m is Concat: - c2 = sum(ch[x] for x in f) - elif m in (Detect, WorldDetect, Segment, Pose, OBB, ImagePoolingAttn): - args.append([ch[x] for x in f]) - if m is Segment: - args[2] = make_divisible(min(args[2], max_channels) * width, 8) - elif m is RTDETRDecoder: # special case, channels arg must be passed in index 1 - args.insert(1, [ch[x] for x in f]) - elif m is CBLinear: - c2 = args[0] - c1 = ch[f] - args = [c1, c2, *args[1:]] - elif m is CBFuse: - c2 = ch[f[-1]] - else: - c2 = ch[f] - - m_ = nn.Sequential(*(m(*args) for _ in range(n))) if n > 1 else m(*args) # module - t = str(m)[8:-2].replace("__main__.", "") # module type - m.np = sum(x.numel() for x in m_.parameters()) # number params - m_.i, m_.f, m_.type = i, f, t # attach index, 'from' index, type - if verbose: - LOGGER.info(f"{i:>3}{str(f):>20}{n_:>3}{m.np:10.0f} {t:<45}{str(args):<30}") # print - save.extend(x % i for x in ([f] if isinstance(f, int) else f) if x != -1) # append to savelist - layers.append(m_) - if i == 0: - ch = [] - ch.append(c2) - return nn.Sequential(*layers), sorted(save) - - -def yaml_model_load(path): - """Load a YOLOv8 model from a YAML file.""" - import re - - path = Path(path) - if path.stem in (f"yolov{d}{x}6" for x in "nsmlx" for d in (5, 8)): - new_stem = re.sub(r"(\d+)([nslmx])6(.+)?$", r"\1\2-p6\3", path.stem) - LOGGER.warning(f"WARNING ⚠️ Ultralytics YOLO P6 models now use -p6 suffix. Renaming {path.stem} to {new_stem}.") - path = path.with_name(new_stem + path.suffix) - - unified_path = re.sub(r"(\d+)([nslmx])(.+)?$", r"\1\3", str(path)) # i.e. yolov8x.yaml -> yolov8.yaml - yaml_file = check_yaml(unified_path, hard=False) or check_yaml(path) - d = yaml_load(yaml_file) # model dict - d["scale"] = guess_model_scale(path) - d["yaml_file"] = str(path) - return d - - -def guess_model_scale(model_path): - """ - Takes a path to a YOLO model's YAML file as input and extracts the size character of the model's scale. The function - uses regular expression matching to find the pattern of the model scale in the YAML file name, which is denoted by - n, s, m, l, or x. The function returns the size character of the model scale as a string. - - Args: - model_path (str | Path): The path to the YOLO model's YAML file. - - Returns: - (str): The size character of the model's scale, which can be n, s, m, l, or x. - """ - with contextlib.suppress(AttributeError): - import re - - return re.search(r"yolov\d+([nslmx])", Path(model_path).stem).group(1) # n, s, m, l, or x - return "" - - -def guess_model_task(model): - """ - Guess the task of a PyTorch model from its architecture or configuration. - - Args: - model (nn.Module | dict): PyTorch model or model configuration in YAML format. - - Returns: - (str): Task of the model ('detect', 'segment', 'classify', 'pose'). - - Raises: - SyntaxError: If the task of the model could not be determined. - """ - - def cfg2task(cfg): - """Guess from YAML dictionary.""" - m = cfg["head"][-1][-2].lower() # output module name - if m in ("classify", "classifier", "cls", "fc"): - return "classify" - if m == "detect": - return "detect" - if m == "segment": - return "segment" - if m == "pose": - return "pose" - if m == "obb": - return "obb" - - # Guess from model cfg - if isinstance(model, dict): - with contextlib.suppress(Exception): - return cfg2task(model) - - # Guess from PyTorch model - if isinstance(model, nn.Module): # PyTorch model - for x in "model.args", "model.model.args", "model.model.model.args": - with contextlib.suppress(Exception): - return eval(x)["task"] - for x in "model.yaml", "model.model.yaml", "model.model.model.yaml": - with contextlib.suppress(Exception): - return cfg2task(eval(x)) - - for m in model.modules(): - if isinstance(m, Segment): - return "segment" - elif isinstance(m, Classify): - return "classify" - elif isinstance(m, Pose): - return "pose" - elif isinstance(m, OBB): - return "obb" - elif isinstance(m, (Detect, WorldDetect)): - return "detect" - - # Guess from model filename - if isinstance(model, (str, Path)): - model = Path(model) - if "-seg" in model.stem or "segment" in model.parts: - return "segment" - elif "-cls" in model.stem or "classify" in model.parts: - return "classify" - elif "-pose" in model.stem or "pose" in model.parts: - return "pose" - elif "-obb" in model.stem or "obb" in model.parts: - return "obb" - elif "detect" in model.parts: - return "detect" - - # Unable to determine task from model - LOGGER.warning( - "WARNING ⚠️ Unable to automatically guess model task, assuming 'task=detect'. " - "Explicitly define task for your model, i.e. 'task=detect', 'segment', 'classify','pose' or 'obb'." - ) - return "detect" # assume detect diff --git a/ultralytics-main/ultralytics/solutions/__init__.py b/ultralytics-main/ultralytics/solutions/__init__.py deleted file mode 100644 index 9e68dc1..0000000 --- a/ultralytics-main/ultralytics/solutions/__init__.py +++ /dev/null @@ -1 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license diff --git a/ultralytics-main/ultralytics/solutions/ai_gym.py b/ultralytics-main/ultralytics/solutions/ai_gym.py deleted file mode 100644 index b089ed0..0000000 --- a/ultralytics-main/ultralytics/solutions/ai_gym.py +++ /dev/null @@ -1,158 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import cv2 - -from ultralytics.utils.checks import check_imshow -from ultralytics.utils.plotting import Annotator - - -class AIGym: - """A class to manage the gym steps of people in a real-time video stream based on their poses.""" - - def __init__(self): - """Initializes the AIGym with default values for Visual and Image parameters.""" - - # Image and line thickness - self.im0 = None - self.tf = None - - # Keypoints and count information - self.keypoints = None - self.poseup_angle = None - self.posedown_angle = None - self.threshold = 0.001 - - # Store stage, count and angle information - self.angle = None - self.count = None - self.stage = None - self.pose_type = "pushup" - self.kpts_to_check = None - - # Visual Information - self.view_img = False - self.annotator = None - - # Check if environment support imshow - self.env_check = check_imshow(warn=True) - - def set_args( - self, - kpts_to_check, - line_thickness=2, - view_img=False, - pose_up_angle=145.0, - pose_down_angle=90.0, - pose_type="pullup", - ): - """ - Configures the AIGym line_thickness, save image and view image parameters. - - Args: - kpts_to_check (list): 3 keypoints for counting - line_thickness (int): Line thickness for bounding boxes. - view_img (bool): display the im0 - pose_up_angle (float): Angle to set pose position up - pose_down_angle (float): Angle to set pose position down - pose_type (str): "pushup", "pullup" or "abworkout" - """ - self.kpts_to_check = kpts_to_check - self.tf = line_thickness - self.view_img = view_img - self.poseup_angle = pose_up_angle - self.posedown_angle = pose_down_angle - self.pose_type = pose_type - - def start_counting(self, im0, results, frame_count): - """ - Function used to count the gym steps. - - Args: - im0 (ndarray): Current frame from the video stream. - results (list): Pose estimation data - frame_count (int): store current frame count - """ - self.im0 = im0 - if frame_count == 1: - self.count = [0] * len(results[0]) - self.angle = [0] * len(results[0]) - self.stage = ["-" for _ in results[0]] - self.keypoints = results[0].keypoints.data - self.annotator = Annotator(im0, line_width=2) - - num_keypoints = len(results[0]) - - # Resize self.angle, self.count, and self.stage if the number of keypoints has changed - if len(self.angle) != num_keypoints: - self.angle = [0] * num_keypoints - self.count = [0] * num_keypoints - self.stage = ["-" for _ in range(num_keypoints)] - - for ind, k in enumerate(reversed(self.keypoints)): - if self.pose_type in ["pushup", "pullup"]: - self.angle[ind] = self.annotator.estimate_pose_angle( - k[int(self.kpts_to_check[0])].cpu(), - k[int(self.kpts_to_check[1])].cpu(), - k[int(self.kpts_to_check[2])].cpu(), - ) - self.im0 = self.annotator.draw_specific_points(k, self.kpts_to_check, shape=(640, 640), radius=10) - - if self.pose_type == "abworkout": - self.angle[ind] = self.annotator.estimate_pose_angle( - k[int(self.kpts_to_check[0])].cpu(), - k[int(self.kpts_to_check[1])].cpu(), - k[int(self.kpts_to_check[2])].cpu(), - ) - self.im0 = self.annotator.draw_specific_points(k, self.kpts_to_check, shape=(640, 640), radius=10) - if self.angle[ind] > self.poseup_angle: - self.stage[ind] = "down" - if self.angle[ind] < self.posedown_angle and self.stage[ind] == "down": - self.stage[ind] = "up" - self.count[ind] += 1 - self.annotator.plot_angle_and_count_and_stage( - angle_text=self.angle[ind], - count_text=self.count[ind], - stage_text=self.stage[ind], - center_kpt=k[int(self.kpts_to_check[1])], - line_thickness=self.tf, - ) - - if self.pose_type == "pushup": - if self.angle[ind] > self.poseup_angle: - self.stage[ind] = "up" - if self.angle[ind] < self.posedown_angle and self.stage[ind] == "up": - self.stage[ind] = "down" - self.count[ind] += 1 - self.annotator.plot_angle_and_count_and_stage( - angle_text=self.angle[ind], - count_text=self.count[ind], - stage_text=self.stage[ind], - center_kpt=k[int(self.kpts_to_check[1])], - line_thickness=self.tf, - ) - if self.pose_type == "pullup": - if self.angle[ind] > self.poseup_angle: - self.stage[ind] = "down" - if self.angle[ind] < self.posedown_angle and self.stage[ind] == "down": - self.stage[ind] = "up" - self.count[ind] += 1 - self.annotator.plot_angle_and_count_and_stage( - angle_text=self.angle[ind], - count_text=self.count[ind], - stage_text=self.stage[ind], - center_kpt=k[int(self.kpts_to_check[1])], - line_thickness=self.tf, - ) - - self.annotator.kpts(k, shape=(640, 640), radius=1, kpt_line=True) - - if self.env_check and self.view_img: - cv2.imshow("Ultralytics YOLOv8 AI GYM", self.im0) - if cv2.waitKey(1) & 0xFF == ord("q"): - return - - return self.im0 - - -if __name__ == "__main__": - AIGym() diff --git a/ultralytics-main/ultralytics/solutions/distance_calculation.py b/ultralytics-main/ultralytics/solutions/distance_calculation.py deleted file mode 100644 index f09209e..0000000 --- a/ultralytics-main/ultralytics/solutions/distance_calculation.py +++ /dev/null @@ -1,181 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import math - -import cv2 - -from ultralytics.utils.checks import check_imshow -from ultralytics.utils.plotting import Annotator, colors - - -class DistanceCalculation: - """A class to calculate distance between two objects in real-time video stream based on their tracks.""" - - def __init__(self): - """Initializes the distance calculation class with default values for Visual, Image, track and distance - parameters. - """ - - # Visual & im0 information - self.im0 = None - self.annotator = None - self.view_img = False - self.line_color = (255, 255, 0) - self.centroid_color = (255, 0, 255) - - # Predict/track information - self.clss = None - self.names = None - self.boxes = None - self.line_thickness = 2 - self.trk_ids = None - - # Distance calculation information - self.centroids = [] - self.pixel_per_meter = 10 - - # Mouse event - self.left_mouse_count = 0 - self.selected_boxes = {} - - # Check if environment support imshow - self.env_check = check_imshow(warn=True) - - def set_args( - self, - names, - pixels_per_meter=10, - view_img=False, - line_thickness=2, - line_color=(255, 255, 0), - centroid_color=(255, 0, 255), - ): - """ - Configures the distance calculation and display parameters. - - Args: - names (dict): object detection classes names - pixels_per_meter (int): Number of pixels in meter - view_img (bool): Flag indicating frame display - line_thickness (int): Line thickness for bounding boxes. - line_color (RGB): color of centroids line - centroid_color (RGB): colors of bbox centroids - """ - self.names = names - self.pixel_per_meter = pixels_per_meter - self.view_img = view_img - self.line_thickness = line_thickness - self.line_color = line_color - self.centroid_color = centroid_color - - def mouse_event_for_distance(self, event, x, y, flags, param): - """ - This function is designed to move region with mouse events in a real-time video stream. - - Args: - event (int): The type of mouse event (e.g., cv2.EVENT_MOUSEMOVE, cv2.EVENT_LBUTTONDOWN, etc.). - x (int): The x-coordinate of the mouse pointer. - y (int): The y-coordinate of the mouse pointer. - flags (int): Any flags associated with the event (e.g., cv2.EVENT_FLAG_CTRLKEY, - cv2.EVENT_FLAG_SHIFTKEY, etc.). - param (dict): Additional parameters you may want to pass to the function. - """ - global selected_boxes - global left_mouse_count - if event == cv2.EVENT_LBUTTONDOWN: - self.left_mouse_count += 1 - if self.left_mouse_count <= 2: - for box, track_id in zip(self.boxes, self.trk_ids): - if box[0] < x < box[2] and box[1] < y < box[3] and track_id not in self.selected_boxes: - self.selected_boxes[track_id] = [] - self.selected_boxes[track_id] = box - - if event == cv2.EVENT_RBUTTONDOWN: - self.selected_boxes = {} - self.left_mouse_count = 0 - - def extract_tracks(self, tracks): - """ - Extracts results from the provided data. - - Args: - tracks (list): List of tracks obtained from the object tracking process. - """ - self.boxes = tracks[0].boxes.xyxy.cpu() - self.clss = tracks[0].boxes.cls.cpu().tolist() - self.trk_ids = tracks[0].boxes.id.int().cpu().tolist() - - def calculate_centroid(self, box): - """ - Calculate the centroid of bounding box. - - Args: - box (list): Bounding box data - """ - return int((box[0] + box[2]) // 2), int((box[1] + box[3]) // 2) - - def calculate_distance(self, centroid1, centroid2): - """ - Calculate distance between two centroids. - - Args: - centroid1 (point): First bounding box data - centroid2 (point): Second bounding box data - """ - pixel_distance = math.sqrt((centroid1[0] - centroid2[0]) ** 2 + (centroid1[1] - centroid2[1]) ** 2) - return pixel_distance / self.pixel_per_meter, (pixel_distance / self.pixel_per_meter) * 1000 - - def start_process(self, im0, tracks): - """ - Calculate distance between two bounding boxes based on tracking data. - - Args: - im0 (nd array): Image - tracks (list): List of tracks obtained from the object tracking process. - """ - self.im0 = im0 - if tracks[0].boxes.id is None: - if self.view_img: - self.display_frames() - return - self.extract_tracks(tracks) - - self.annotator = Annotator(self.im0, line_width=2) - - for box, cls, track_id in zip(self.boxes, self.clss, self.trk_ids): - self.annotator.box_label(box, color=colors(int(cls), True), label=self.names[int(cls)]) - - if len(self.selected_boxes) == 2: - for trk_id, _ in self.selected_boxes.items(): - if trk_id == track_id: - self.selected_boxes[track_id] = box - - if len(self.selected_boxes) == 2: - for trk_id, box in self.selected_boxes.items(): - centroid = self.calculate_centroid(self.selected_boxes[trk_id]) - self.centroids.append(centroid) - - distance_m, distance_mm = self.calculate_distance(self.centroids[0], self.centroids[1]) - self.annotator.plot_distance_and_line( - distance_m, distance_mm, self.centroids, self.line_color, self.centroid_color - ) - - self.centroids = [] - - if self.view_img and self.env_check: - self.display_frames() - - return im0 - - def display_frames(self): - """Display frame.""" - cv2.namedWindow("Ultralytics Distance Estimation") - cv2.setMouseCallback("Ultralytics Distance Estimation", self.mouse_event_for_distance) - cv2.imshow("Ultralytics Distance Estimation", self.im0) - - if cv2.waitKey(1) & 0xFF == ord("q"): - return - - -if __name__ == "__main__": - DistanceCalculation() diff --git a/ultralytics-main/ultralytics/solutions/heatmap.py b/ultralytics-main/ultralytics/solutions/heatmap.py deleted file mode 100644 index f70e62b..0000000 --- a/ultralytics-main/ultralytics/solutions/heatmap.py +++ /dev/null @@ -1,281 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from collections import defaultdict - -import cv2 -import numpy as np - -from ultralytics.utils.checks import check_imshow, check_requirements -from ultralytics.utils.plotting import Annotator - -check_requirements("shapely>=2.0.0") - -from shapely.geometry import LineString, Point, Polygon - - -class Heatmap: - """A class to draw heatmaps in real-time video stream based on their tracks.""" - - def __init__(self): - """Initializes the heatmap class with default values for Visual, Image, track, count and heatmap parameters.""" - - # Visual information - self.annotator = None - self.view_img = False - self.shape = "circle" - - # Image information - self.imw = None - self.imh = None - self.im0 = None - self.view_in_counts = True - self.view_out_counts = True - - # Heatmap colormap and heatmap np array - self.colormap = None - self.heatmap = None - self.heatmap_alpha = 0.5 - - # Predict/track information - self.boxes = None - self.track_ids = None - self.clss = None - self.track_history = defaultdict(list) - - # Region & Line Information - self.count_reg_pts = None - self.counting_region = None - self.line_dist_thresh = 15 - self.region_thickness = 5 - self.region_color = (255, 0, 255) - - # Object Counting Information - self.in_counts = 0 - self.out_counts = 0 - self.counting_list = [] - self.count_txt_thickness = 0 - self.count_txt_color = (0, 0, 0) - self.count_color = (255, 255, 255) - - # Decay factor - self.decay_factor = 0.99 - - # Check if environment support imshow - self.env_check = check_imshow(warn=True) - - def set_args( - self, - imw, - imh, - colormap=cv2.COLORMAP_JET, - heatmap_alpha=0.5, - view_img=False, - view_in_counts=True, - view_out_counts=True, - count_reg_pts=None, - count_txt_thickness=2, - count_txt_color=(0, 0, 0), - count_color=(255, 255, 255), - count_reg_color=(255, 0, 255), - region_thickness=5, - line_dist_thresh=15, - decay_factor=0.99, - shape="circle", - ): - """ - Configures the heatmap colormap, width, height and display parameters. - - Args: - colormap (cv2.COLORMAP): The colormap to be set. - imw (int): The width of the frame. - imh (int): The height of the frame. - heatmap_alpha (float): alpha value for heatmap display - view_img (bool): Flag indicating frame display - view_in_counts (bool): Flag to control whether to display the incounts on video stream. - view_out_counts (bool): Flag to control whether to display the outcounts on video stream. - count_reg_pts (list): Object counting region points - count_txt_thickness (int): Text thickness for object counting display - count_txt_color (RGB color): count text color value - count_color (RGB color): count text background color value - count_reg_color (RGB color): Color of object counting region - region_thickness (int): Object counting Region thickness - line_dist_thresh (int): Euclidean Distance threshold for line counter - decay_factor (float): value for removing heatmap area after object passed - shape (str): Heatmap shape, rect or circle shape supported - """ - self.imw = imw - self.imh = imh - self.heatmap_alpha = heatmap_alpha - self.view_img = view_img - self.view_in_counts = view_in_counts - self.view_out_counts = view_out_counts - self.colormap = colormap - - # Region and line selection - if count_reg_pts is not None: - if len(count_reg_pts) == 2: - print("Line Counter Initiated.") - self.count_reg_pts = count_reg_pts - self.counting_region = LineString(count_reg_pts) - - elif len(count_reg_pts) == 4: - print("Region Counter Initiated.") - self.count_reg_pts = count_reg_pts - self.counting_region = Polygon(self.count_reg_pts) - - else: - print("Region or line points Invalid, 2 or 4 points supported") - print("Using Line Counter Now") - self.counting_region = Polygon([(20, 400), (1260, 400)]) # dummy points - - # Heatmap new frame - self.heatmap = np.zeros((int(self.imh), int(self.imw)), dtype=np.float32) - - self.count_txt_thickness = count_txt_thickness - self.count_txt_color = count_txt_color - self.count_color = count_color - self.region_color = count_reg_color - self.region_thickness = region_thickness - self.decay_factor = decay_factor - self.line_dist_thresh = line_dist_thresh - self.shape = shape - - # shape of heatmap, if not selected - if self.shape not in ["circle", "rect"]: - print("Unknown shape value provided, 'circle' & 'rect' supported") - print("Using Circular shape now") - self.shape = "circle" - - def extract_results(self, tracks): - """ - Extracts results from the provided data. - - Args: - tracks (list): List of tracks obtained from the object tracking process. - """ - self.boxes = tracks[0].boxes.xyxy.cpu() - self.clss = tracks[0].boxes.cls.cpu().tolist() - self.track_ids = tracks[0].boxes.id.int().cpu().tolist() - - def generate_heatmap(self, im0, tracks): - """ - Generate heatmap based on tracking data. - - Args: - im0 (nd array): Image - tracks (list): List of tracks obtained from the object tracking process. - """ - self.im0 = im0 - if tracks[0].boxes.id is None: - self.heatmap = np.zeros((int(self.imh), int(self.imw)), dtype=np.float32) - if self.view_img and self.env_check: - self.display_frames() - return im0 - self.heatmap *= self.decay_factor # decay factor - self.extract_results(tracks) - self.annotator = Annotator(self.im0, self.count_txt_thickness, None) - - if self.count_reg_pts is not None: - # Draw counting region - if self.view_in_counts or self.view_out_counts: - self.annotator.draw_region( - reg_pts=self.count_reg_pts, color=self.region_color, thickness=self.region_thickness - ) - - for box, cls, track_id in zip(self.boxes, self.clss, self.track_ids): - if self.shape == "circle": - center = (int((box[0] + box[2]) // 2), int((box[1] + box[3]) // 2)) - radius = min(int(box[2]) - int(box[0]), int(box[3]) - int(box[1])) // 2 - - y, x = np.ogrid[0 : self.heatmap.shape[0], 0 : self.heatmap.shape[1]] - mask = (x - center[0]) ** 2 + (y - center[1]) ** 2 <= radius**2 - - self.heatmap[int(box[1]) : int(box[3]), int(box[0]) : int(box[2])] += ( - 2 * mask[int(box[1]) : int(box[3]), int(box[0]) : int(box[2])] - ) - - else: - self.heatmap[int(box[1]) : int(box[3]), int(box[0]) : int(box[2])] += 2 - - # Store tracking hist - track_line = self.track_history[track_id] - track_line.append((float((box[0] + box[2]) / 2), float((box[1] + box[3]) / 2))) - if len(track_line) > 30: - track_line.pop(0) - - # Count objects - if len(self.count_reg_pts) == 4: - if self.counting_region.contains(Point(track_line[-1])) and track_id not in self.counting_list: - self.counting_list.append(track_id) - if box[0] < self.counting_region.centroid.x: - self.out_counts += 1 - else: - self.in_counts += 1 - - elif len(self.count_reg_pts) == 2: - distance = Point(track_line[-1]).distance(self.counting_region) - if distance < self.line_dist_thresh and track_id not in self.counting_list: - self.counting_list.append(track_id) - if box[0] < self.counting_region.centroid.x: - self.out_counts += 1 - else: - self.in_counts += 1 - else: - for box, cls in zip(self.boxes, self.clss): - if self.shape == "circle": - center = (int((box[0] + box[2]) // 2), int((box[1] + box[3]) // 2)) - radius = min(int(box[2]) - int(box[0]), int(box[3]) - int(box[1])) // 2 - - y, x = np.ogrid[0 : self.heatmap.shape[0], 0 : self.heatmap.shape[1]] - mask = (x - center[0]) ** 2 + (y - center[1]) ** 2 <= radius**2 - - self.heatmap[int(box[1]) : int(box[3]), int(box[0]) : int(box[2])] += ( - 2 * mask[int(box[1]) : int(box[3]), int(box[0]) : int(box[2])] - ) - - else: - self.heatmap[int(box[1]) : int(box[3]), int(box[0]) : int(box[2])] += 2 - - # Normalize, apply colormap to heatmap and combine with original image - heatmap_normalized = cv2.normalize(self.heatmap, None, 0, 255, cv2.NORM_MINMAX) - heatmap_colored = cv2.applyColorMap(heatmap_normalized.astype(np.uint8), self.colormap) - - incount_label = f"In Count : {self.in_counts}" - outcount_label = f"OutCount : {self.out_counts}" - - # Display counts based on user choice - counts_label = None - if not self.view_in_counts and not self.view_out_counts: - counts_label = None - elif not self.view_in_counts: - counts_label = outcount_label - elif not self.view_out_counts: - counts_label = incount_label - else: - counts_label = f"{incount_label} {outcount_label}" - - if self.count_reg_pts is not None and counts_label is not None: - self.annotator.count_labels( - counts=counts_label, - count_txt_size=self.count_txt_thickness, - txt_color=self.count_txt_color, - color=self.count_color, - ) - - self.im0 = cv2.addWeighted(self.im0, 1 - self.heatmap_alpha, heatmap_colored, self.heatmap_alpha, 0) - - if self.env_check and self.view_img: - self.display_frames() - - return self.im0 - - def display_frames(self): - """Display frame.""" - cv2.imshow("Ultralytics Heatmap", self.im0) - - if cv2.waitKey(1) & 0xFF == ord("q"): - return - - -if __name__ == "__main__": - Heatmap() diff --git a/ultralytics-main/ultralytics/solutions/object_counter.py b/ultralytics-main/ultralytics/solutions/object_counter.py deleted file mode 100644 index 3cb64fd..0000000 --- a/ultralytics-main/ultralytics/solutions/object_counter.py +++ /dev/null @@ -1,278 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from collections import defaultdict - -import cv2 - -from ultralytics.utils.checks import check_imshow, check_requirements -from ultralytics.utils.plotting import Annotator, colors - -check_requirements("shapely>=2.0.0") - -from shapely.geometry import LineString, Point, Polygon - - -class ObjectCounter: - """A class to manage the counting of objects in a real-time video stream based on their tracks.""" - - def __init__(self): - """Initializes the Counter with default values for various tracking and counting parameters.""" - - # Mouse events - self.is_drawing = False - self.selected_point = None - - # Region & Line Information - self.reg_pts = [(20, 400), (1260, 400)] - self.line_dist_thresh = 15 - self.counting_region = None - self.region_color = (255, 0, 255) - self.region_thickness = 5 - - # Image and annotation Information - self.im0 = None - self.tf = None - self.view_img = False - self.view_in_counts = True - self.view_out_counts = True - - self.names = None # Classes names - self.annotator = None # Annotator - self.window_name = "Ultralytics YOLOv8 Object Counter" - - # Object counting Information - self.in_counts = 0 - self.out_counts = 0 - self.counting_dict = {} - self.count_txt_thickness = 0 - self.count_txt_color = (0, 0, 0) - self.count_color = (255, 255, 255) - - # Tracks info - self.track_history = defaultdict(list) - self.track_thickness = 2 - self.draw_tracks = False - self.track_color = (0, 255, 0) - - # Check if environment support imshow - self.env_check = check_imshow(warn=True) - - def set_args( - self, - classes_names, - reg_pts, - count_reg_color=(255, 0, 255), - line_thickness=2, - track_thickness=2, - view_img=False, - view_in_counts=True, - view_out_counts=True, - draw_tracks=False, - count_txt_thickness=2, - count_txt_color=(0, 0, 0), - count_color=(255, 255, 255), - track_color=(0, 255, 0), - region_thickness=5, - line_dist_thresh=15, - ): - """ - Configures the Counter's image, bounding box line thickness, and counting region points. - - Args: - line_thickness (int): Line thickness for bounding boxes. - view_img (bool): Flag to control whether to display the video stream. - view_in_counts (bool): Flag to control whether to display the incounts on video stream. - view_out_counts (bool): Flag to control whether to display the outcounts on video stream. - reg_pts (list): Initial list of points defining the counting region. - classes_names (dict): Classes names - track_thickness (int): Track thickness - draw_tracks (Bool): draw tracks - count_txt_thickness (int): Text thickness for object counting display - count_txt_color (RGB color): count text color value - count_color (RGB color): count text background color value - count_reg_color (RGB color): Color of object counting region - track_color (RGB color): color for tracks - region_thickness (int): Object counting Region thickness - line_dist_thresh (int): Euclidean Distance threshold for line counter - """ - self.tf = line_thickness - self.view_img = view_img - self.view_in_counts = view_in_counts - self.view_out_counts = view_out_counts - self.track_thickness = track_thickness - self.draw_tracks = draw_tracks - - # Region and line selection - if len(reg_pts) == 2: - print("Line Counter Initiated.") - self.reg_pts = reg_pts - self.counting_region = LineString(self.reg_pts) - elif len(reg_pts) >= 3: - print("Region Counter Initiated.") - self.reg_pts = reg_pts - self.counting_region = Polygon(self.reg_pts) - else: - print("Invalid Region points provided, region_points must be 2 for lines or >= 3 for polygons.") - print("Using Line Counter Now") - self.counting_region = LineString(self.reg_pts) - - self.names = classes_names - self.track_color = track_color - self.count_txt_thickness = count_txt_thickness - self.count_txt_color = count_txt_color - self.count_color = count_color - self.region_color = count_reg_color - self.region_thickness = region_thickness - self.line_dist_thresh = line_dist_thresh - - def mouse_event_for_region(self, event, x, y, flags, params): - """ - This function is designed to move region with mouse events in a real-time video stream. - - Args: - event (int): The type of mouse event (e.g., cv2.EVENT_MOUSEMOVE, cv2.EVENT_LBUTTONDOWN, etc.). - x (int): The x-coordinate of the mouse pointer. - y (int): The y-coordinate of the mouse pointer. - flags (int): Any flags associated with the event (e.g., cv2.EVENT_FLAG_CTRLKEY, - cv2.EVENT_FLAG_SHIFTKEY, etc.). - params (dict): Additional parameters you may want to pass to the function. - """ - if event == cv2.EVENT_LBUTTONDOWN: - for i, point in enumerate(self.reg_pts): - if ( - isinstance(point, (tuple, list)) - and len(point) >= 2 - and (abs(x - point[0]) < 10 and abs(y - point[1]) < 10) - ): - self.selected_point = i - self.is_drawing = True - break - - elif event == cv2.EVENT_MOUSEMOVE: - if self.is_drawing and self.selected_point is not None: - self.reg_pts[self.selected_point] = (x, y) - self.counting_region = Polygon(self.reg_pts) - - elif event == cv2.EVENT_LBUTTONUP: - self.is_drawing = False - self.selected_point = None - - def extract_and_process_tracks(self, tracks): - """Extracts and processes tracks for object counting in a video stream.""" - - # Annotator Init and region drawing - self.annotator = Annotator(self.im0, self.tf, self.names) - - if tracks[0].boxes.id is not None: - boxes = tracks[0].boxes.xyxy.cpu() - clss = tracks[0].boxes.cls.cpu().tolist() - track_ids = tracks[0].boxes.id.int().cpu().tolist() - - # Extract tracks - for box, track_id, cls in zip(boxes, track_ids, clss): - # Draw bounding box - self.annotator.box_label(box, label=f"{track_id}:{self.names[cls]}", color=colors(int(cls), True)) - - # Draw Tracks - track_line = self.track_history[track_id] - track_line.append((float((box[0] + box[2]) / 2), float((box[1] + box[3]) / 2))) - if len(track_line) > 30: - track_line.pop(0) - - # Draw track trails - if self.draw_tracks: - self.annotator.draw_centroid_and_tracks( - track_line, color=self.track_color, track_thickness=self.track_thickness - ) - - prev_position = self.track_history[track_id][-2] if len(self.track_history[track_id]) > 1 else None - centroid = Point((box[:2] + box[2:]) / 2) - - # Count objects - if len(self.reg_pts) >= 3: # any polygon - is_inside = self.counting_region.contains(centroid) - current_position = "in" if is_inside else "out" - - if prev_position is not None: - if self.counting_dict[track_id] != current_position and is_inside: - self.in_counts += 1 - self.counting_dict[track_id] = "in" - elif self.counting_dict[track_id] != current_position and not is_inside: - self.out_counts += 1 - self.counting_dict[track_id] = "out" - else: - self.counting_dict[track_id] = current_position - - else: - self.counting_dict[track_id] = current_position - - elif len(self.reg_pts) == 2: - if prev_position is not None: - is_inside = (box[0] - prev_position[0]) * ( - self.counting_region.centroid.x - prev_position[0] - ) > 0 - current_position = "in" if is_inside else "out" - - if self.counting_dict[track_id] != current_position and is_inside: - self.in_counts += 1 - self.counting_dict[track_id] = "in" - elif self.counting_dict[track_id] != current_position and not is_inside: - self.out_counts += 1 - self.counting_dict[track_id] = "out" - else: - self.counting_dict[track_id] = current_position - else: - self.counting_dict[track_id] = None - - incount_label = f"In Count : {self.in_counts}" - outcount_label = f"OutCount : {self.out_counts}" - - # Display counts based on user choice - counts_label = None - if not self.view_in_counts and not self.view_out_counts: - counts_label = None - elif not self.view_in_counts: - counts_label = outcount_label - elif not self.view_out_counts: - counts_label = incount_label - else: - counts_label = f"{incount_label} {outcount_label}" - - if counts_label is not None: - self.annotator.count_labels( - counts=counts_label, - count_txt_size=self.count_txt_thickness, - txt_color=self.count_txt_color, - color=self.count_color, - ) - - def display_frames(self): - """Display frame.""" - if self.env_check: - self.annotator.draw_region(reg_pts=self.reg_pts, color=self.region_color, thickness=self.region_thickness) - cv2.namedWindow(self.window_name) - if len(self.reg_pts) == 4: # only add mouse event If user drawn region - cv2.setMouseCallback(self.window_name, self.mouse_event_for_region, {"region_points": self.reg_pts}) - cv2.imshow(self.window_name, self.im0) - # Break Window - if cv2.waitKey(1) & 0xFF == ord("q"): - return - - def start_counting(self, im0, tracks): - """ - Main function to start the object counting process. - - Args: - im0 (ndarray): Current frame from the video stream. - tracks (list): List of tracks obtained from the object tracking process. - """ - self.im0 = im0 # store image - self.extract_and_process_tracks(tracks) # draw region even if no objects - - if self.view_img: - self.display_frames() - return self.im0 - - -if __name__ == "__main__": - ObjectCounter() diff --git a/ultralytics-main/ultralytics/solutions/speed.py b/ultralytics-main/ultralytics/solutions/speed.py deleted file mode 100644 index a767710..0000000 --- a/ultralytics-main/ultralytics/solutions/speed.py +++ /dev/null @@ -1,164 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -import math -from collections import defaultdict -from time import time - -import cv2 -import numpy as np - -from ultralytics.utils.checks import check_imshow -from ultralytics.utils.plotting import Annotator, colors -import gol - -class SpeedEstimator: - """A class to estimation speed of objects in real-time video stream based on their tracks.""" - - def __init__(self): - """Initializes the speed-estimator class with default values for Visual, Image, track and speed parameters.""" - - # Visual & im0 information - self.im0 = None - self.annotator = None - self.view_img = False - - # Region information - # self.reg_pts = [(20, 400), (1260, 400)] - self.region_thickness = 3 - - # Predict/track information - self.clss = None - self.names = None - self.boxes = None - self.trk_ids = None - self.trk_pts = None - self.line_thickness = 2 - self.trk_history = defaultdict(list) - - # Speed estimator information - self.current_time = 0 - self.dist_data = {} - self.trk_idslist = [] - self.spdl_dist_thresh = 10 - self.trk_previous_times = {} - self.trk_previous_points = {} - - # Check if environment support imshow - self.env_check = check_imshow(warn=True) - - def set_args( - self, - # reg_pts, - names, - view_img=False, - line_thickness=2, - region_thickness=5, - spdl_dist_thresh=10, - ): - """ - Configures the speed estimation and display parameters. - - Args: - reg_pts (list): Initial list of points defining the speed calculation region. - names (dict): object detection classes names - view_img (bool): Flag indicating frame display - line_thickness (int): Line thickness for bounding boxes. - region_thickness (int): Speed estimation region thickness - spdl_dist_thresh (int): Euclidean distance threshold for speed line - """ - # if reg_pts is None: - # print("Region points not provided, using default values") - # else: - # self.reg_pts = reg_pts - self.names = names - self.view_img = view_img - self.line_thickness = line_thickness - self.region_thickness = region_thickness - self.spdl_dist_thresh = spdl_dist_thresh - - def extract_tracks(self, tracks): - self.boxes = tracks[0].boxes.xyxy.cpu() - self.clss = tracks[0].boxes.cls.cpu().tolist() - self.trk_ids = tracks[0].boxes.id.int().cpu().tolist() - - def store_track_info(self, track_id, box): - - track = self.trk_history[track_id] - bbox_center = (float((box[0] + box[2]) / 2), float((box[1] + box[3]) / 2)) - x_center = (box[0] + box[2]) / 2 - y_center = (box[1] + box[3]) / 2 - - # points_3d = gol.get_value('points_3d') - # a = points_3d[int(y_center), int(x_center), 0] / 1000 - # b = points_3d[int(y_center), int(x_center), 1] / 1000 - # c = points_3d[int(y_center), int(x_center), 2] / 1000 - a = gol.get_value('a') - b = gol.get_value('b') - c = gol.get_value('c') - bbox_center_3d = (float(a), float(b), float(c)) - - # track.append(bbox_center) - track.append(bbox_center_3d) - if len(track) > 30: - track.pop(0) - self.trk_pts = np.hstack(track).astype(np.int32).reshape((-1, 1, 3)) # 修改 - return track - - def plot_box_and_track(self, track_id, box, cls, track): - speed_label = f"{int(self.dist_data[track_id])}km/ph" if track_id in self.dist_data else self.names[int(cls)] - bbox_color = colors(int(track_id)) if track_id in self.dist_data else (255, 0, 255) - self.annotator.box_label(box, speed_label, bbox_color) - # cv2.polylines(self.im0, [self.trk_pts], isClosed=False, color=(0, 255, 0), thickness=1) - # cv2.circle(self.im0, (int(track[-1][0]), int(track[-1][1])), 5, bbox_color, -1) - # 绘制轨迹 - for i in range(len(track) - 1): - cv2.line(self.im0, (int(track[i][0]), int(track[i][1])), (int(track[i + 1][0]), int(track[i + 1][1])), - (0, 255, 0), 1) - # 绘制最后一个点 - cv2.circle(self.im0, (int(track[-1][0]), int(track[-1][1])), 5, bbox_color, -1) - - def calculate_speed(self, trk_id, track): - - if self.trk_previous_times[trk_id] != 0 and trk_id not in self.trk_idslist: - self.trk_idslist.append(trk_id) - time_difference = time() - self.trk_previous_times[trk_id] - if time_difference > 0: - dist_difference_0 = np.abs(track[-1][0] - self.trk_previous_points[trk_id][0]) - dist_difference_1 = np.abs(track[-1][1] - self.trk_previous_points[trk_id][1]) - dist_difference_2 = np.abs(track[-1][2] - self.trk_previous_points[trk_id][2]) - dist_difference = math.sqrt(dist_difference_0 ** 2 + dist_difference_1 ** 2 + dist_difference_2 ** 2) - speed = dist_difference / time_difference - self.dist_data[trk_id] = speed - self.trk_previous_times[trk_id] = time() - self.trk_previous_points[trk_id] = track[-1] - - def estimate_speed(self, im0, tracks, region_color=(255, 0, 0)): - self.im0 = im0 - if tracks[0].boxes.id is None: - if self.view_img and self.env_check: - self.display_frames() - return im0 - self.extract_tracks(tracks) - self.annotator = Annotator(self.im0, line_width=2) - # self.annotator.draw_region(reg_pts=self.reg_pts, color=region_color, thickness=self.region_thickness) - for box, trk_id, cls in zip(self.boxes, self.trk_ids, self.clss): - track = self.store_track_info(trk_id, box) # 将返回的轨迹信息存储在 track 中 - - if trk_id not in self.trk_previous_times: - self.trk_previous_times[trk_id] = 0 - self.plot_box_and_track(trk_id, box, cls, track) - self.calculate_speed(trk_id, track) # 计算速度 - - if self.view_img and self.env_check: - self.display_frames() - - return im0 - - def display_frames(self): - """Display frame.""" - cv2.imshow("Ultralytics Speed Estimation", self.im0) - if cv2.waitKey(1) & 0xFF == ord("q"): - return - - -if __name__ == "__main__": - SpeedEstimator() diff --git a/ultralytics-main/ultralytics/solutions/speed_estimation.py b/ultralytics-main/ultralytics/solutions/speed_estimation.py deleted file mode 100644 index 9fafb0d..0000000 --- a/ultralytics-main/ultralytics/solutions/speed_estimation.py +++ /dev/null @@ -1,198 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from collections import defaultdict -from time import time - -import cv2 -import numpy as np - -from ultralytics.utils.checks import check_imshow -from ultralytics.utils.plotting import Annotator, colors - - -class SpeedEstimator: - """A class to estimation speed of objects in real-time video stream based on their tracks.""" - - def __init__(self): - """Initializes the speed-estimator class with default values for Visual, Image, track and speed parameters.""" - - # Visual & im0 information - self.im0 = None - self.annotator = None - self.view_img = False - - # Region information - self.reg_pts = [(20, 400), (1260, 400)] - self.region_thickness = 3 - - # Predict/track information - self.clss = None - self.names = None - self.boxes = None - self.trk_ids = None - self.trk_pts = None - self.line_thickness = 2 - self.trk_history = defaultdict(list) - - # Speed estimator information - self.current_time = 0 - self.dist_data = {} - self.trk_idslist = [] - self.spdl_dist_thresh = 10 - self.trk_previous_times = {} - self.trk_previous_points = {} - - # Check if environment support imshow - self.env_check = check_imshow(warn=True) - - def set_args( - self, - reg_pts, - names, - view_img=False, - line_thickness=2, - region_thickness=5, - spdl_dist_thresh=10, - ): - """ - Configures the speed estimation and display parameters. - - Args: - reg_pts (list): Initial list of points defining the speed calculation region. - names (dict): object detection classes names - view_img (bool): Flag indicating frame display - line_thickness (int): Line thickness for bounding boxes. - region_thickness (int): Speed estimation region thickness - spdl_dist_thresh (int): Euclidean distance threshold for speed line - """ - if reg_pts is None: - print("Region points not provided, using default values") - else: - self.reg_pts = reg_pts - self.names = names - self.view_img = view_img - self.line_thickness = line_thickness - self.region_thickness = region_thickness - self.spdl_dist_thresh = spdl_dist_thresh - - def extract_tracks(self, tracks): - """ - Extracts results from the provided data. - - Args: - tracks (list): List of tracks obtained from the object tracking process. - """ - self.boxes = tracks[0].boxes.xyxy.cpu() - self.clss = tracks[0].boxes.cls.cpu().tolist() - self.trk_ids = tracks[0].boxes.id.int().cpu().tolist() - - def store_track_info(self, track_id, box): - """ - Store track data. - - Args: - track_id (int): object track id. - box (list): object bounding box data - """ - track = self.trk_history[track_id] - bbox_center = (float((box[0] + box[2]) / 2), float((box[1] + box[3]) / 2)) - track.append(bbox_center) - - if len(track) > 30: - track.pop(0) - - self.trk_pts = np.hstack(track).astype(np.int32).reshape((-1, 1, 2)) - return track - - def plot_box_and_track(self, track_id, box, cls, track): - """ - Plot track and bounding box. - - Args: - track_id (int): object track id. - box (list): object bounding box data - cls (str): object class name - track (list): tracking history for tracks path drawing - """ - speed_label = f"{int(self.dist_data[track_id])}km/ph" if track_id in self.dist_data else self.names[int(cls)] - bbox_color = colors(int(track_id)) if track_id in self.dist_data else (255, 0, 255) - - self.annotator.box_label(box, speed_label, bbox_color) - - cv2.polylines(self.im0, [self.trk_pts], isClosed=False, color=(0, 255, 0), thickness=1) - cv2.circle(self.im0, (int(track[-1][0]), int(track[-1][1])), 5, bbox_color, -1) - - def calculate_speed(self, trk_id, track): - """ - Calculation of object speed. - - Args: - trk_id (int): object track id. - track (list): tracking history for tracks path drawing - """ - - if not self.reg_pts[0][0] < track[-1][0] < self.reg_pts[1][0]: - return - if self.reg_pts[1][1] - self.spdl_dist_thresh < track[-1][1] < self.reg_pts[1][1] + self.spdl_dist_thresh: - direction = "known" - - elif self.reg_pts[0][1] - self.spdl_dist_thresh < track[-1][1] < self.reg_pts[0][1] + self.spdl_dist_thresh: - direction = "known" - - else: - direction = "unknown" - - if self.trk_previous_times[trk_id] != 0 and direction != "unknown" and trk_id not in self.trk_idslist: - self.trk_idslist.append(trk_id) - - time_difference = time() - self.trk_previous_times[trk_id] - if time_difference > 0: - dist_difference = np.abs(track[-1][1] - self.trk_previous_points[trk_id][1]) - speed = dist_difference / time_difference - self.dist_data[trk_id] = speed - - self.trk_previous_times[trk_id] = time() - self.trk_previous_points[trk_id] = track[-1] - - def estimate_speed(self, im0, tracks, region_color=(255, 0, 0)): - """ - Calculate object based on tracking data. - - Args: - im0 (nd array): Image - tracks (list): List of tracks obtained from the object tracking process. - region_color (tuple): Color to use when drawing regions. - """ - self.im0 = im0 - if tracks[0].boxes.id is None: - if self.view_img and self.env_check: - self.display_frames() - return im0 - self.extract_tracks(tracks) - - self.annotator = Annotator(self.im0, line_width=2) - self.annotator.draw_region(reg_pts=self.reg_pts, color=region_color, thickness=self.region_thickness) - - for box, trk_id, cls in zip(self.boxes, self.trk_ids, self.clss): - track = self.store_track_info(trk_id, box) # 将返回的轨迹信息存储在 track 中 - - if trk_id not in self.trk_previous_times: - self.trk_previous_times[trk_id] = 0 - - self.plot_box_and_track(trk_id, box, cls, track) - self.calculate_speed(trk_id, track) # 计算速度 - - if self.view_img and self.env_check: - self.display_frames() - - return im0 - - def display_frames(self): - """Display frame.""" - cv2.imshow("Ultralytics Speed Estimation", self.im0) - if cv2.waitKey(1) & 0xFF == ord("q"): - return - - -if __name__ == "__main__": - SpeedEstimator() diff --git a/ultralytics-main/ultralytics/trackers/README.md b/ultralytics-main/ultralytics/trackers/README.md deleted file mode 100644 index 2cab3c0..0000000 --- a/ultralytics-main/ultralytics/trackers/README.md +++ /dev/null @@ -1,321 +0,0 @@ -# Multi-Object Tracking with Ultralytics YOLO - -YOLOv8 trackers visualization - -Object tracking in the realm of video analytics is a critical task that not only identifies the location and class of objects within the frame but also maintains a unique ID for each detected object as the video progresses. The applications are limitless—ranging from surveillance and security to real-time sports analytics. - -## Why Choose Ultralytics YOLO for Object Tracking? - -The output from Ultralytics trackers is consistent with standard object detection but has the added value of object IDs. This makes it easy to track objects in video streams and perform subsequent analytics. Here's why you should consider using Ultralytics YOLO for your object tracking needs: - -- **Efficiency:** Process video streams in real-time without compromising accuracy. -- **Flexibility:** Supports multiple tracking algorithms and configurations. -- **Ease of Use:** Simple Python API and CLI options for quick integration and deployment. -- **Customizability:** Easy to use with custom trained YOLO models, allowing integration into domain-specific applications. - -**Video Tutorial:** [Object Detection and Tracking with Ultralytics YOLOv8](https://www.youtube.com/embed/hHyHmOtmEgs?si=VNZtXmm45Nb9s-N-). - -## Features at a Glance - -Ultralytics YOLO extends its object detection features to provide robust and versatile object tracking: - -- **Real-Time Tracking:** Seamlessly track objects in high-frame-rate videos. -- **Multiple Tracker Support:** Choose from a variety of established tracking algorithms. -- **Customizable Tracker Configurations:** Tailor the tracking algorithm to meet specific requirements by adjusting various parameters. - -## Available Trackers - -Ultralytics YOLO supports the following tracking algorithms. They can be enabled by passing the relevant YAML configuration file such as `tracker=tracker_type.yaml`: - -- [BoT-SORT](https://github.com/NirAharon/BoT-SORT) - Use `botsort.yaml` to enable this tracker. -- [ByteTrack](https://github.com/ifzhang/ByteTrack) - Use `bytetrack.yaml` to enable this tracker. - -The default tracker is BoT-SORT. - -## Tracking - -To run the tracker on video streams, use a trained Detect, Segment or Pose model such as YOLOv8n, YOLOv8n-seg and YOLOv8n-pose. - -#### Python - -```python -from ultralytics import YOLO - -# Load an official or custom model -model = YOLO("yolov8n.pt") # Load an official Detect model -model = YOLO("yolov8n-seg.pt") # Load an official Segment model -model = YOLO("yolov8n-pose.pt") # Load an official Pose model -model = YOLO("path/to/best.pt") # Load a custom trained model - -# Perform tracking with the model -results = model.track( - source="https://youtu.be/LNwODJXcvt4", show=True -) # Tracking with default tracker -results = model.track( - source="https://youtu.be/LNwODJXcvt4", show=True, tracker="bytetrack.yaml" -) # Tracking with ByteTrack tracker -``` - -#### CLI - -```bash -# Perform tracking with various models using the command line interface -yolo track model=yolov8n.pt source="https://youtu.be/LNwODJXcvt4" # Official Detect model -yolo track model=yolov8n-seg.pt source="https://youtu.be/LNwODJXcvt4" # Official Segment model -yolo track model=yolov8n-pose.pt source="https://youtu.be/LNwODJXcvt4" # Official Pose model -yolo track model=path/to/best.pt source="https://youtu.be/LNwODJXcvt4" # Custom trained model - -# Track using ByteTrack tracker -yolo track model=path/to/best.pt tracker="bytetrack.yaml" -``` - -As can be seen in the above usage, tracking is available for all Detect, Segment and Pose models run on videos or streaming sources. - -## Configuration - -### Tracking Arguments - -Tracking configuration shares properties with Predict mode, such as `conf`, `iou`, and `show`. For further configurations, refer to the [Predict](https://docs.ultralytics.com/modes/predict/) model page. - -#### Python - -```python -from ultralytics import YOLO - -# Configure the tracking parameters and run the tracker -model = YOLO("yolov8n.pt") -results = model.track( - source="https://youtu.be/LNwODJXcvt4", conf=0.3, iou=0.5, show=True -) -``` - -#### CLI - -```bash -# Configure tracking parameters and run the tracker using the command line interface -yolo track model=yolov8n.pt source="https://youtu.be/LNwODJXcvt4" conf=0.3, iou=0.5 show -``` - -### Tracker Selection - -Ultralytics also allows you to use a modified tracker configuration file. To do this, simply make a copy of a tracker config file (for example, `custom_tracker.yaml`) from [ultralytics/cfg/trackers](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/trackers) and modify any configurations (except the `tracker_type`) as per your needs. - -#### Python - -```python -from ultralytics import YOLO - -# Load the model and run the tracker with a custom configuration file -model = YOLO("yolov8n.pt") -results = model.track( - source="https://youtu.be/LNwODJXcvt4", tracker="custom_tracker.yaml" -) -``` - -#### CLI - -```bash -# Load the model and run the tracker with a custom configuration file using the command line interface -yolo track model=yolov8n.pt source="https://youtu.be/LNwODJXcvt4" tracker='custom_tracker.yaml' -``` - -For a comprehensive list of tracking arguments, refer to the [ultralytics/cfg/trackers](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/trackers) page. - -## Python Examples - -### Persisting Tracks Loop - -Here is a Python script using OpenCV (`cv2`) and YOLOv8 to run object tracking on video frames. This script still assumes you have already installed the necessary packages (`opencv-python` and `ultralytics`). The `persist=True` argument tells the tracker than the current image or frame is the next in a sequence and to expect tracks from the previous image in the current image. - -#### Python - -```python -import cv2 -from ultralytics import YOLO - -# Load the YOLOv8 model -model = YOLO("yolov8n.pt") - -# Open the video file -video_path = "path/to/video.mp4" -cap = cv2.VideoCapture(video_path) - -# Loop through the video frames -while cap.isOpened(): - # Read a frame from the video - success, frame = cap.read() - - if success: - # Run YOLOv8 tracking on the frame, persisting tracks between frames - results = model.track(frame, persist=True) - - # Visualize the results on the frame - annotated_frame = results[0].plot() - - # Display the annotated frame - cv2.imshow("YOLOv8 Tracking", annotated_frame) - - # Break the loop if 'q' is pressed - if cv2.waitKey(1) & 0xFF == ord("q"): - break - else: - # Break the loop if the end of the video is reached - break - -# Release the video capture object and close the display window -cap.release() -cv2.destroyAllWindows() -``` - -Please note the change from `model(frame)` to `model.track(frame)`, which enables object tracking instead of simple detection. This modified script will run the tracker on each frame of the video, visualize the results, and display them in a window. The loop can be exited by pressing 'q'. - -### Plotting Tracks Over Time - -Visualizing object tracks over consecutive frames can provide valuable insights into the movement patterns and behavior of detected objects within a video. With Ultralytics YOLOv8, plotting these tracks is a seamless and efficient process. - -In the following example, we demonstrate how to utilize YOLOv8's tracking capabilities to plot the movement of detected objects across multiple video frames. This script involves opening a video file, reading it frame by frame, and utilizing the YOLO model to identify and track various objects. By retaining the center points of the detected bounding boxes and connecting them, we can draw lines that represent the paths followed by the tracked objects. - -#### Python - -```python -from collections import defaultdict - -import cv2 -import numpy as np - -from ultralytics import YOLO - -# Load the YOLOv8 model -model = YOLO("yolov8n.pt") - -# Open the video file -video_path = "path/to/video.mp4" -cap = cv2.VideoCapture(video_path) - -# Store the track history -track_history = defaultdict(lambda: []) - -# Loop through the video frames -while cap.isOpened(): - # Read a frame from the video - success, frame = cap.read() - - if success: - # Run YOLOv8 tracking on the frame, persisting tracks between frames - results = model.track(frame, persist=True) - - # Get the boxes and track IDs - boxes = results[0].boxes.xywh.cpu() - track_ids = results[0].boxes.id.int().cpu().tolist() - - # Visualize the results on the frame - annotated_frame = results[0].plot() - - # Plot the tracks - for box, track_id in zip(boxes, track_ids): - x, y, w, h = box - track = track_history[track_id] - track.append((float(x), float(y))) # x, y center point - if len(track) > 30: # retain 90 tracks for 90 frames - track.pop(0) - - # Draw the tracking lines - points = np.hstack(track).astype(np.int32).reshape((-1, 1, 2)) - cv2.polylines( - annotated_frame, - [points], - isClosed=False, - color=(230, 230, 230), - thickness=10, - ) - - # Display the annotated frame - cv2.imshow("YOLOv8 Tracking", annotated_frame) - - # Break the loop if 'q' is pressed - if cv2.waitKey(1) & 0xFF == ord("q"): - break - else: - # Break the loop if the end of the video is reached - break - -# Release the video capture object and close the display window -cap.release() -cv2.destroyAllWindows() -``` - -### Multithreaded Tracking - -Multithreaded tracking provides the capability to run object tracking on multiple video streams simultaneously. This is particularly useful when handling multiple video inputs, such as from multiple surveillance cameras, where concurrent processing can greatly enhance efficiency and performance. - -In the provided Python script, we make use of Python's `threading` module to run multiple instances of the tracker concurrently. Each thread is responsible for running the tracker on one video file, and all the threads run simultaneously in the background. - -To ensure that each thread receives the correct parameters (the video file and the model to use), we define a function `run_tracker_in_thread` that accepts these parameters and contains the main tracking loop. This function reads the video frame by frame, runs the tracker, and displays the results. - -Two different models are used in this example: `yolov8n.pt` and `yolov8n-seg.pt`, each tracking objects in a different video file. The video files are specified in `video_file1` and `video_file2`. - -The `daemon=True` parameter in `threading.Thread` means that these threads will be closed as soon as the main program finishes. We then start the threads with `start()` and use `join()` to make the main thread wait until both tracker threads have finished. - -Finally, after all threads have completed their task, the windows displaying the results are closed using `cv2.destroyAllWindows()`. - -#### Python - -```python -import threading - -import cv2 -from ultralytics import YOLO - - -def run_tracker_in_thread(filename, model): - video = cv2.VideoCapture(filename) - frames = int(video.get(cv2.CAP_PROP_FRAME_COUNT)) - for _ in range(frames): - ret, frame = video.read() - if ret: - results = model.track(source=frame, persist=True) - res_plotted = results[0].plot() - cv2.imshow("p", res_plotted) - if cv2.waitKey(1) == ord("q"): - break - - -# Load the models -model1 = YOLO("yolov8n.pt") -model2 = YOLO("yolov8n-seg.pt") - -# Define the video files for the trackers -video_file1 = "path/to/video1.mp4" -video_file2 = "path/to/video2.mp4" - -# Create the tracker threads -tracker_thread1 = threading.Thread( - target=run_tracker_in_thread, args=(video_file1, model1), daemon=True -) -tracker_thread2 = threading.Thread( - target=run_tracker_in_thread, args=(video_file2, model2), daemon=True -) - -# Start the tracker threads -tracker_thread1.start() -tracker_thread2.start() - -# Wait for the tracker threads to finish -tracker_thread1.join() -tracker_thread2.join() - -# Clean up and close windows -cv2.destroyAllWindows() -``` - -This example can easily be extended to handle more video files and models by creating more threads and applying the same methodology. - -## Contribute New Trackers - -Are you proficient in multi-object tracking and have successfully implemented or adapted a tracking algorithm with Ultralytics YOLO? We invite you to contribute to our Trackers section in [ultralytics/cfg/trackers](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/trackers)! Your real-world applications and solutions could be invaluable for users working on tracking tasks. - -By contributing to this section, you help expand the scope of tracking solutions available within the Ultralytics YOLO framework, adding another layer of functionality and utility for the community. - -To initiate your contribution, please refer to our [Contributing Guide](https://docs.ultralytics.com/help/contributing) for comprehensive instructions on submitting a Pull Request (PR) 🛠️. We are excited to see what you bring to the table! - -Together, let's enhance the tracking capabilities of the Ultralytics YOLO ecosystem 🙏! diff --git a/ultralytics-main/ultralytics/trackers/__init__.py b/ultralytics-main/ultralytics/trackers/__init__.py deleted file mode 100644 index bf51b8d..0000000 --- a/ultralytics-main/ultralytics/trackers/__init__.py +++ /dev/null @@ -1,7 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from .bot_sort import BOTSORT -from .byte_tracker import BYTETracker -from .track import register_tracker - -__all__ = "register_tracker", "BOTSORT", "BYTETracker" # allow simpler import diff --git a/ultralytics-main/ultralytics/trackers/basetrack.py b/ultralytics-main/ultralytics/trackers/basetrack.py deleted file mode 100644 index c900cac..0000000 --- a/ultralytics-main/ultralytics/trackers/basetrack.py +++ /dev/null @@ -1,105 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -"""This module defines the base classes and structures for object tracking in YOLO.""" - -from collections import OrderedDict - -import numpy as np - - -class TrackState: - """ - Enumeration class representing the possible states of an object being tracked. - - Attributes: - New (int): State when the object is newly detected. - Tracked (int): State when the object is successfully tracked in subsequent frames. - Lost (int): State when the object is no longer tracked. - Removed (int): State when the object is removed from tracking. - """ - - New = 0 - Tracked = 1 - Lost = 2 - Removed = 3 - - -class BaseTrack: - """ - Base class for object tracking, providing foundational attributes and methods. - - Attributes: - _count (int): Class-level counter for unique track IDs. - track_id (int): Unique identifier for the track. - is_activated (bool): Flag indicating whether the track is currently active. - state (TrackState): Current state of the track. - history (OrderedDict): Ordered history of the track's states. - features (list): List of features extracted from the object for tracking. - curr_feature (any): The current feature of the object being tracked. - score (float): The confidence score of the tracking. - start_frame (int): The frame number where tracking started. - frame_id (int): The most recent frame ID processed by the track. - time_since_update (int): Frames passed since the last update. - location (tuple): The location of the object in the context of multi-camera tracking. - - Methods: - end_frame: Returns the ID of the last frame where the object was tracked. - next_id: Increments and returns the next global track ID. - activate: Abstract method to activate the track. - predict: Abstract method to predict the next state of the track. - update: Abstract method to update the track with new data. - mark_lost: Marks the track as lost. - mark_removed: Marks the track as removed. - reset_id: Resets the global track ID counter. - """ - - _count = 0 - - def __init__(self): - """Initializes a new track with unique ID and foundational tracking attributes.""" - self.track_id = 0 - self.is_activated = False - self.state = TrackState.New - self.history = OrderedDict() - self.features = [] - self.curr_feature = None - self.score = 0 - self.start_frame = 0 - self.frame_id = 0 - self.time_since_update = 0 - self.location = (np.inf, np.inf) - - @property - def end_frame(self): - """Return the last frame ID of the track.""" - return self.frame_id - - @staticmethod - def next_id(): - """Increment and return the global track ID counter.""" - BaseTrack._count += 1 - return BaseTrack._count - - def activate(self, *args): - """Abstract method to activate the track with provided arguments.""" - raise NotImplementedError - - def predict(self): - """Abstract method to predict the next state of the track.""" - raise NotImplementedError - - def update(self, *args, **kwargs): - """Abstract method to update the track with new observations.""" - raise NotImplementedError - - def mark_lost(self): - """Mark the track as lost.""" - self.state = TrackState.Lost - - def mark_removed(self): - """Mark the track as removed.""" - self.state = TrackState.Removed - - @staticmethod - def reset_id(): - """Reset the global track ID counter.""" - BaseTrack._count = 0 diff --git a/ultralytics-main/ultralytics/trackers/bot_sort.py b/ultralytics-main/ultralytics/trackers/bot_sort.py deleted file mode 100644 index 31d5e1b..0000000 --- a/ultralytics-main/ultralytics/trackers/bot_sort.py +++ /dev/null @@ -1,200 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from collections import deque - -import numpy as np - -from .basetrack import TrackState -from .byte_tracker import BYTETracker, STrack -from .utils import matching -from .utils.gmc import GMC -from .utils.kalman_filter import KalmanFilterXYWH - - -class BOTrack(STrack): - """ - An extended version of the STrack class for YOLOv8, adding object tracking features. - - Attributes: - shared_kalman (KalmanFilterXYWH): A shared Kalman filter for all instances of BOTrack. - smooth_feat (np.ndarray): Smoothed feature vector. - curr_feat (np.ndarray): Current feature vector. - features (deque): A deque to store feature vectors with a maximum length defined by `feat_history`. - alpha (float): Smoothing factor for the exponential moving average of features. - mean (np.ndarray): The mean state of the Kalman filter. - covariance (np.ndarray): The covariance matrix of the Kalman filter. - - Methods: - update_features(feat): Update features vector and smooth it using exponential moving average. - predict(): Predicts the mean and covariance using Kalman filter. - re_activate(new_track, frame_id, new_id): Reactivates a track with updated features and optionally new ID. - update(new_track, frame_id): Update the YOLOv8 instance with new track and frame ID. - tlwh: Property that gets the current position in tlwh format `(top left x, top left y, width, height)`. - multi_predict(stracks): Predicts the mean and covariance of multiple object tracks using shared Kalman filter. - convert_coords(tlwh): Converts tlwh bounding box coordinates to xywh format. - tlwh_to_xywh(tlwh): Convert bounding box to xywh format `(center x, center y, width, height)`. - - Usage: - bo_track = BOTrack(tlwh, score, cls, feat) - bo_track.predict() - bo_track.update(new_track, frame_id) - """ - - shared_kalman = KalmanFilterXYWH() - - def __init__(self, tlwh, score, cls, feat=None, feat_history=50): - """Initialize YOLOv8 object with temporal parameters, such as feature history, alpha and current features.""" - super().__init__(tlwh, score, cls) - - self.smooth_feat = None - self.curr_feat = None - if feat is not None: - self.update_features(feat) - self.features = deque([], maxlen=feat_history) - self.alpha = 0.9 - - def update_features(self, feat): - """Update features vector and smooth it using exponential moving average.""" - feat /= np.linalg.norm(feat) - self.curr_feat = feat - if self.smooth_feat is None: - self.smooth_feat = feat - else: - self.smooth_feat = self.alpha * self.smooth_feat + (1 - self.alpha) * feat - self.features.append(feat) - self.smooth_feat /= np.linalg.norm(self.smooth_feat) - - def predict(self): - """Predicts the mean and covariance using Kalman filter.""" - mean_state = self.mean.copy() - if self.state != TrackState.Tracked: - mean_state[6] = 0 - mean_state[7] = 0 - - self.mean, self.covariance = self.kalman_filter.predict(mean_state, self.covariance) - - def re_activate(self, new_track, frame_id, new_id=False): - """Reactivates a track with updated features and optionally assigns a new ID.""" - if new_track.curr_feat is not None: - self.update_features(new_track.curr_feat) - super().re_activate(new_track, frame_id, new_id) - - def update(self, new_track, frame_id): - """Update the YOLOv8 instance with new track and frame ID.""" - if new_track.curr_feat is not None: - self.update_features(new_track.curr_feat) - super().update(new_track, frame_id) - - @property - def tlwh(self): - """Get current position in bounding box format `(top left x, top left y, width, height)`.""" - if self.mean is None: - return self._tlwh.copy() - ret = self.mean[:4].copy() - ret[:2] -= ret[2:] / 2 - return ret - - @staticmethod - def multi_predict(stracks): - """Predicts the mean and covariance of multiple object tracks using shared Kalman filter.""" - if len(stracks) <= 0: - return - multi_mean = np.asarray([st.mean.copy() for st in stracks]) - multi_covariance = np.asarray([st.covariance for st in stracks]) - for i, st in enumerate(stracks): - if st.state != TrackState.Tracked: - multi_mean[i][6] = 0 - multi_mean[i][7] = 0 - multi_mean, multi_covariance = BOTrack.shared_kalman.multi_predict(multi_mean, multi_covariance) - for i, (mean, cov) in enumerate(zip(multi_mean, multi_covariance)): - stracks[i].mean = mean - stracks[i].covariance = cov - - def convert_coords(self, tlwh): - """Converts Top-Left-Width-Height bounding box coordinates to X-Y-Width-Height format.""" - return self.tlwh_to_xywh(tlwh) - - @staticmethod - def tlwh_to_xywh(tlwh): - """Convert bounding box to format `(center x, center y, width, height)`.""" - ret = np.asarray(tlwh).copy() - ret[:2] += ret[2:] / 2 - return ret - - -class BOTSORT(BYTETracker): - """ - An extended version of the BYTETracker class for YOLOv8, designed for object tracking with ReID and GMC algorithm. - - Attributes: - proximity_thresh (float): Threshold for spatial proximity (IoU) between tracks and detections. - appearance_thresh (float): Threshold for appearance similarity (ReID embeddings) between tracks and detections. - encoder (object): Object to handle ReID embeddings, set to None if ReID is not enabled. - gmc (GMC): An instance of the GMC algorithm for data association. - args (object): Parsed command-line arguments containing tracking parameters. - - Methods: - get_kalmanfilter(): Returns an instance of KalmanFilterXYWH for object tracking. - init_track(dets, scores, cls, img): Initialize track with detections, scores, and classes. - get_dists(tracks, detections): Get distances between tracks and detections using IoU and (optionally) ReID. - multi_predict(tracks): Predict and track multiple objects with YOLOv8 model. - - Usage: - bot_sort = BOTSORT(args, frame_rate) - bot_sort.init_track(dets, scores, cls, img) - bot_sort.multi_predict(tracks) - - Note: - The class is designed to work with the YOLOv8 object detection model and supports ReID only if enabled via args. - """ - - def __init__(self, args, frame_rate=30): - """Initialize YOLOv8 object with ReID module and GMC algorithm.""" - super().__init__(args, frame_rate) - # ReID module - self.proximity_thresh = args.proximity_thresh - self.appearance_thresh = args.appearance_thresh - - if args.with_reid: - # Haven't supported BoT-SORT(reid) yet - self.encoder = None - self.gmc = GMC(method=args.gmc_method) - - def get_kalmanfilter(self): - """Returns an instance of KalmanFilterXYWH for object tracking.""" - return KalmanFilterXYWH() - - def init_track(self, dets, scores, cls, img=None): - """Initialize track with detections, scores, and classes.""" - if len(dets) == 0: - return [] - if self.args.with_reid and self.encoder is not None: - features_keep = self.encoder.inference(img, dets) - return [BOTrack(xyxy, s, c, f) for (xyxy, s, c, f) in zip(dets, scores, cls, features_keep)] # detections - else: - return [BOTrack(xyxy, s, c) for (xyxy, s, c) in zip(dets, scores, cls)] # detections - - def get_dists(self, tracks, detections): - """Get distances between tracks and detections using IoU and (optionally) ReID embeddings.""" - dists = matching.iou_distance(tracks, detections) - dists_mask = dists > self.proximity_thresh - - # TODO: mot20 - # if not self.args.mot20: - dists = matching.fuse_score(dists, detections) - - if self.args.with_reid and self.encoder is not None: - emb_dists = matching.embedding_distance(tracks, detections) / 2.0 - emb_dists[emb_dists > self.appearance_thresh] = 1.0 - emb_dists[dists_mask] = 1.0 - dists = np.minimum(dists, emb_dists) - return dists - - def multi_predict(self, tracks): - """Predict and track multiple objects with YOLOv8 model.""" - BOTrack.multi_predict(tracks) - - def reset(self): - """Reset tracker.""" - super().reset() - self.gmc.reset_params() diff --git a/ultralytics-main/ultralytics/trackers/byte_tracker.py b/ultralytics-main/ultralytics/trackers/byte_tracker.py deleted file mode 100644 index 01cbca9..0000000 --- a/ultralytics-main/ultralytics/trackers/byte_tracker.py +++ /dev/null @@ -1,444 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import numpy as np - -from .basetrack import BaseTrack, TrackState -from .utils import matching -from .utils.kalman_filter import KalmanFilterXYAH -from ..utils.ops import xywh2ltwh -from ..utils import LOGGER - - -class STrack(BaseTrack): - """ - Single object tracking representation that uses Kalman filtering for state estimation. - - This class is responsible for storing all the information regarding individual tracklets and performs state updates - and predictions based on Kalman filter. - - Attributes: - shared_kalman (KalmanFilterXYAH): Shared Kalman filter that is used across all STrack instances for prediction. - _tlwh (np.ndarray): Private attribute to store top-left corner coordinates and width and height of bounding box. - kalman_filter (KalmanFilterXYAH): Instance of Kalman filter used for this particular object track. - mean (np.ndarray): Mean state estimate vector. - covariance (np.ndarray): Covariance of state estimate. - is_activated (bool): Boolean flag indicating if the track has been activated. - score (float): Confidence score of the track. - tracklet_len (int): Length of the tracklet. - cls (any): Class label for the object. - idx (int): Index or identifier for the object. - frame_id (int): Current frame ID. - start_frame (int): Frame where the object was first detected. - - Methods: - predict(): Predict the next state of the object using Kalman filter. - multi_predict(stracks): Predict the next states for multiple tracks. - multi_gmc(stracks, H): Update multiple track states using a homography matrix. - activate(kalman_filter, frame_id): Activate a new tracklet. - re_activate(new_track, frame_id, new_id): Reactivate a previously lost tracklet. - update(new_track, frame_id): Update the state of a matched track. - convert_coords(tlwh): Convert bounding box to x-y-aspect-height format. - tlwh_to_xyah(tlwh): Convert tlwh bounding box to xyah format. - """ - - shared_kalman = KalmanFilterXYAH() - - def __init__(self, xywh, score, cls): - """Initialize new STrack instance.""" - super().__init__() - # xywh+idx or xywha+idx - assert len(xywh) in [5, 6], f"expected 5 or 6 values but got {len(xywh)}" - self._tlwh = np.asarray(xywh2ltwh(xywh[:4]), dtype=np.float32) - self.kalman_filter = None - self.mean, self.covariance = None, None - self.is_activated = False - - self.score = score - self.tracklet_len = 0 - self.cls = cls - self.idx = xywh[-1] - self.angle = xywh[4] if len(xywh) == 6 else None - - def predict(self): - """Predicts mean and covariance using Kalman filter.""" - mean_state = self.mean.copy() - if self.state != TrackState.Tracked: - mean_state[7] = 0 - self.mean, self.covariance = self.kalman_filter.predict(mean_state, self.covariance) - - @staticmethod - def multi_predict(stracks): - """Perform multi-object predictive tracking using Kalman filter for given stracks.""" - if len(stracks) <= 0: - return - multi_mean = np.asarray([st.mean.copy() for st in stracks]) - multi_covariance = np.asarray([st.covariance for st in stracks]) - for i, st in enumerate(stracks): - if st.state != TrackState.Tracked: - multi_mean[i][7] = 0 - multi_mean, multi_covariance = STrack.shared_kalman.multi_predict(multi_mean, multi_covariance) - for i, (mean, cov) in enumerate(zip(multi_mean, multi_covariance)): - stracks[i].mean = mean - stracks[i].covariance = cov - - @staticmethod - def multi_gmc(stracks, H=np.eye(2, 3)): - """Update state tracks positions and covariances using a homography matrix.""" - if len(stracks) > 0: - multi_mean = np.asarray([st.mean.copy() for st in stracks]) - multi_covariance = np.asarray([st.covariance for st in stracks]) - - R = H[:2, :2] - R8x8 = np.kron(np.eye(4, dtype=float), R) - t = H[:2, 2] - - for i, (mean, cov) in enumerate(zip(multi_mean, multi_covariance)): - mean = R8x8.dot(mean) - mean[:2] += t - cov = R8x8.dot(cov).dot(R8x8.transpose()) - - stracks[i].mean = mean - stracks[i].covariance = cov - - def activate(self, kalman_filter, frame_id): - """Start a new tracklet.""" - self.kalman_filter = kalman_filter - self.track_id = self.next_id() - self.mean, self.covariance = self.kalman_filter.initiate(self.convert_coords(self._tlwh)) - - self.tracklet_len = 0 - self.state = TrackState.Tracked - if frame_id == 1: - self.is_activated = True - self.frame_id = frame_id - self.start_frame = frame_id - - def re_activate(self, new_track, frame_id, new_id=False): - """Reactivates a previously lost track with a new detection.""" - self.mean, self.covariance = self.kalman_filter.update( - self.mean, self.covariance, self.convert_coords(new_track.tlwh) - ) - self.tracklet_len = 0 - self.state = TrackState.Tracked - self.is_activated = True - self.frame_id = frame_id - if new_id: - self.track_id = self.next_id() - self.score = new_track.score - self.cls = new_track.cls - self.angle = new_track.angle - self.idx = new_track.idx - - def update(self, new_track, frame_id): - """ - Update the state of a matched track. - - Args: - new_track (STrack): The new track containing updated information. - frame_id (int): The ID of the current frame. - """ - self.frame_id = frame_id - self.tracklet_len += 1 - - new_tlwh = new_track.tlwh - self.mean, self.covariance = self.kalman_filter.update( - self.mean, self.covariance, self.convert_coords(new_tlwh) - ) - self.state = TrackState.Tracked - self.is_activated = True - - self.score = new_track.score - self.cls = new_track.cls - self.angle = new_track.angle - self.idx = new_track.idx - - def convert_coords(self, tlwh): - """Convert a bounding box's top-left-width-height format to its x-y-aspect-height equivalent.""" - return self.tlwh_to_xyah(tlwh) - - @property - def tlwh(self): - """Get current position in bounding box format (top left x, top left y, width, height).""" - if self.mean is None: - return self._tlwh.copy() - ret = self.mean[:4].copy() - ret[2] *= ret[3] - ret[:2] -= ret[2:] / 2 - return ret - - @property - def xyxy(self): - """Convert bounding box to format (min x, min y, max x, max y), i.e., (top left, bottom right).""" - ret = self.tlwh.copy() - ret[2:] += ret[:2] - return ret - - @staticmethod - def tlwh_to_xyah(tlwh): - """Convert bounding box to format (center x, center y, aspect ratio, height), where the aspect ratio is width / - height. - """ - ret = np.asarray(tlwh).copy() - ret[:2] += ret[2:] / 2 - ret[2] /= ret[3] - return ret - - @property - def xywh(self): - """Get current position in bounding box format (center x, center y, width, height).""" - ret = np.asarray(self.tlwh).copy() - ret[:2] += ret[2:] / 2 - return ret - - @property - def xywha(self): - """Get current position in bounding box format (center x, center y, width, height, angle).""" - if self.angle is None: - LOGGER.warning("WARNING ⚠️ `angle` attr not found, returning `xywh` instead.") - return self.xywh - return np.concatenate([self.xywh, self.angle[None]]) - - @property - def result(self): - """Get current tracking results.""" - coords = self.xyxy if self.angle is None else self.xywha - return coords.tolist() + [self.track_id, self.score, self.cls, self.idx] - - def __repr__(self): - """Return a string representation of the BYTETracker object with start and end frames and track ID.""" - return f"OT_{self.track_id}_({self.start_frame}-{self.end_frame})" - - -class BYTETracker: - """ - BYTETracker: A tracking algorithm built on top of YOLOv8 for object detection and tracking. - - The class is responsible for initializing, updating, and managing the tracks for detected objects in a video - sequence. It maintains the state of tracked, lost, and removed tracks over frames, utilizes Kalman filtering for - predicting the new object locations, and performs data association. - - Attributes: - tracked_stracks (list[STrack]): List of successfully activated tracks. - lost_stracks (list[STrack]): List of lost tracks. - removed_stracks (list[STrack]): List of removed tracks. - frame_id (int): The current frame ID. - args (namespace): Command-line arguments. - max_time_lost (int): The maximum frames for a track to be considered as 'lost'. - kalman_filter (object): Kalman Filter object. - - Methods: - update(results, img=None): Updates object tracker with new detections. - get_kalmanfilter(): Returns a Kalman filter object for tracking bounding boxes. - init_track(dets, scores, cls, img=None): Initialize object tracking with detections. - get_dists(tracks, detections): Calculates the distance between tracks and detections. - multi_predict(tracks): Predicts the location of tracks. - reset_id(): Resets the ID counter of STrack. - joint_stracks(tlista, tlistb): Combines two lists of stracks. - sub_stracks(tlista, tlistb): Filters out the stracks present in the second list from the first list. - remove_duplicate_stracks(stracksa, stracksb): Removes duplicate stracks based on IoU. - """ - - def __init__(self, args, frame_rate=30): - """Initialize a YOLOv8 object to track objects with given arguments and frame rate.""" - self.tracked_stracks = [] # type: list[STrack] - self.lost_stracks = [] # type: list[STrack] - self.removed_stracks = [] # type: list[STrack] - - self.frame_id = 0 - self.args = args - self.max_time_lost = int(frame_rate / 30.0 * args.track_buffer) - self.kalman_filter = self.get_kalmanfilter() - self.reset_id() - - def update(self, results, img=None): - """Updates object tracker with new detections and returns tracked object bounding boxes.""" - self.frame_id += 1 - activated_stracks = [] - refind_stracks = [] - lost_stracks = [] - removed_stracks = [] - - scores = results.conf - bboxes = results.xywhr if hasattr(results, "xywhr") else results.xywh - # Add index - bboxes = np.concatenate([bboxes, np.arange(len(bboxes)).reshape(-1, 1)], axis=-1) - cls = results.cls - - remain_inds = scores > self.args.track_high_thresh - inds_low = scores > self.args.track_low_thresh - inds_high = scores < self.args.track_high_thresh - - inds_second = np.logical_and(inds_low, inds_high) - dets_second = bboxes[inds_second] - dets = bboxes[remain_inds] - scores_keep = scores[remain_inds] - scores_second = scores[inds_second] - cls_keep = cls[remain_inds] - cls_second = cls[inds_second] - - detections = self.init_track(dets, scores_keep, cls_keep, img) - # Add newly detected tracklets to tracked_stracks - unconfirmed = [] - tracked_stracks = [] # type: list[STrack] - for track in self.tracked_stracks: - if not track.is_activated: - unconfirmed.append(track) - else: - tracked_stracks.append(track) - # Step 2: First association, with high score detection boxes - strack_pool = self.joint_stracks(tracked_stracks, self.lost_stracks) - # Predict the current location with KF - self.multi_predict(strack_pool) - if hasattr(self, "gmc") and img is not None: - warp = self.gmc.apply(img, dets) - STrack.multi_gmc(strack_pool, warp) - STrack.multi_gmc(unconfirmed, warp) - - dists = self.get_dists(strack_pool, detections) - matches, u_track, u_detection = matching.linear_assignment(dists, thresh=self.args.match_thresh) - - for itracked, idet in matches: - track = strack_pool[itracked] - det = detections[idet] - if track.state == TrackState.Tracked: - track.update(det, self.frame_id) - activated_stracks.append(track) - else: - track.re_activate(det, self.frame_id, new_id=False) - refind_stracks.append(track) - # Step 3: Second association, with low score detection boxes association the untrack to the low score detections - detections_second = self.init_track(dets_second, scores_second, cls_second, img) - r_tracked_stracks = [strack_pool[i] for i in u_track if strack_pool[i].state == TrackState.Tracked] - # TODO - dists = matching.iou_distance(r_tracked_stracks, detections_second) - matches, u_track, u_detection_second = matching.linear_assignment(dists, thresh=0.5) - for itracked, idet in matches: - track = r_tracked_stracks[itracked] - det = detections_second[idet] - if track.state == TrackState.Tracked: - track.update(det, self.frame_id) - activated_stracks.append(track) - else: - track.re_activate(det, self.frame_id, new_id=False) - refind_stracks.append(track) - - for it in u_track: - track = r_tracked_stracks[it] - if track.state != TrackState.Lost: - track.mark_lost() - lost_stracks.append(track) - # Deal with unconfirmed tracks, usually tracks with only one beginning frame - detections = [detections[i] for i in u_detection] - dists = self.get_dists(unconfirmed, detections) - matches, u_unconfirmed, u_detection = matching.linear_assignment(dists, thresh=0.7) - for itracked, idet in matches: - unconfirmed[itracked].update(detections[idet], self.frame_id) - activated_stracks.append(unconfirmed[itracked]) - for it in u_unconfirmed: - track = unconfirmed[it] - track.mark_removed() - removed_stracks.append(track) - # Step 4: Init new stracks - for inew in u_detection: - track = detections[inew] - if track.score < self.args.new_track_thresh: - continue - track.activate(self.kalman_filter, self.frame_id) - activated_stracks.append(track) - # Step 5: Update state - for track in self.lost_stracks: - if self.frame_id - track.end_frame > self.max_time_lost: - track.mark_removed() - removed_stracks.append(track) - - self.tracked_stracks = [t for t in self.tracked_stracks if t.state == TrackState.Tracked] - self.tracked_stracks = self.joint_stracks(self.tracked_stracks, activated_stracks) - self.tracked_stracks = self.joint_stracks(self.tracked_stracks, refind_stracks) - self.lost_stracks = self.sub_stracks(self.lost_stracks, self.tracked_stracks) - self.lost_stracks.extend(lost_stracks) - self.lost_stracks = self.sub_stracks(self.lost_stracks, self.removed_stracks) - self.tracked_stracks, self.lost_stracks = self.remove_duplicate_stracks(self.tracked_stracks, self.lost_stracks) - self.removed_stracks.extend(removed_stracks) - if len(self.removed_stracks) > 1000: - self.removed_stracks = self.removed_stracks[-999:] # clip remove stracks to 1000 maximum - - return np.asarray([x.result for x in self.tracked_stracks if x.is_activated], dtype=np.float32) - - def get_kalmanfilter(self): - """Returns a Kalman filter object for tracking bounding boxes.""" - return KalmanFilterXYAH() - - def init_track(self, dets, scores, cls, img=None): - """Initialize object tracking with detections and scores using STrack algorithm.""" - return [STrack(xyxy, s, c) for (xyxy, s, c) in zip(dets, scores, cls)] if len(dets) else [] # detections - - def get_dists(self, tracks, detections): - """Calculates the distance between tracks and detections using IoU and fuses scores.""" - dists = matching.iou_distance(tracks, detections) - # TODO: mot20 - # if not self.args.mot20: - dists = matching.fuse_score(dists, detections) - return dists - - def multi_predict(self, tracks): - """Returns the predicted tracks using the YOLOv8 network.""" - STrack.multi_predict(tracks) - - @staticmethod - def reset_id(): - """Resets the ID counter of STrack.""" - STrack.reset_id() - - def reset(self): - """Reset tracker.""" - self.tracked_stracks = [] # type: list[STrack] - self.lost_stracks = [] # type: list[STrack] - self.removed_stracks = [] # type: list[STrack] - self.frame_id = 0 - self.kalman_filter = self.get_kalmanfilter() - self.reset_id() - - @staticmethod - def joint_stracks(tlista, tlistb): - """Combine two lists of stracks into a single one.""" - exists = {} - res = [] - for t in tlista: - exists[t.track_id] = 1 - res.append(t) - for t in tlistb: - tid = t.track_id - if not exists.get(tid, 0): - exists[tid] = 1 - res.append(t) - return res - - @staticmethod - def sub_stracks(tlista, tlistb): - """DEPRECATED CODE in https://github.com/ultralytics/ultralytics/pull/1890/ - stracks = {t.track_id: t for t in tlista} - for t in tlistb: - tid = t.track_id - if stracks.get(tid, 0): - del stracks[tid] - return list(stracks.values()) - """ - track_ids_b = {t.track_id for t in tlistb} - return [t for t in tlista if t.track_id not in track_ids_b] - - @staticmethod - def remove_duplicate_stracks(stracksa, stracksb): - """Remove duplicate stracks with non-maximum IoU distance.""" - pdist = matching.iou_distance(stracksa, stracksb) - pairs = np.where(pdist < 0.15) - dupa, dupb = [], [] - for p, q in zip(*pairs): - timep = stracksa[p].frame_id - stracksa[p].start_frame - timeq = stracksb[q].frame_id - stracksb[q].start_frame - if timep > timeq: - dupb.append(q) - else: - dupa.append(p) - resa = [t for i, t in enumerate(stracksa) if i not in dupa] - resb = [t for i, t in enumerate(stracksb) if i not in dupb] - return resa, resb diff --git a/ultralytics-main/ultralytics/trackers/track.py b/ultralytics-main/ultralytics/trackers/track.py deleted file mode 100644 index 7146a40..0000000 --- a/ultralytics-main/ultralytics/trackers/track.py +++ /dev/null @@ -1,89 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from functools import partial -from pathlib import Path - -import torch - -from ultralytics.utils import IterableSimpleNamespace, yaml_load -from ultralytics.utils.checks import check_yaml -from .bot_sort import BOTSORT -from .byte_tracker import BYTETracker - -# A mapping of tracker types to corresponding tracker classes -TRACKER_MAP = {"bytetrack": BYTETracker, "botsort": BOTSORT} - - -def on_predict_start(predictor: object, persist: bool = False) -> None: - """ - Initialize trackers for object tracking during prediction. - - Args: - predictor (object): The predictor object to initialize trackers for. - persist (bool, optional): Whether to persist the trackers if they already exist. Defaults to False. - - Raises: - AssertionError: If the tracker_type is not 'bytetrack' or 'botsort'. - """ - if hasattr(predictor, "trackers") and persist: - return - - tracker = check_yaml(predictor.args.tracker) - cfg = IterableSimpleNamespace(**yaml_load(tracker)) - - if cfg.tracker_type not in ["bytetrack", "botsort"]: - raise AssertionError(f"Only 'bytetrack' and 'botsort' are supported for now, but got '{cfg.tracker_type}'") - - trackers = [] - for _ in range(predictor.dataset.bs): - tracker = TRACKER_MAP[cfg.tracker_type](args=cfg, frame_rate=30) - trackers.append(tracker) - if predictor.dataset.mode != "stream": # only need one tracker for other modes. - break - predictor.trackers = trackers - predictor.vid_path = [None] * predictor.dataset.bs # for determining when to reset tracker on new video - - -def on_predict_postprocess_end(predictor: object, persist: bool = False) -> None: - """ - Postprocess detected boxes and update with object tracking. - - Args: - predictor (object): The predictor object containing the predictions. - persist (bool, optional): Whether to persist the trackers if they already exist. Defaults to False. - """ - path, im0s = predictor.batch[:2] - - is_obb = predictor.args.task == "obb" - is_stream = predictor.dataset.mode == "stream" - for i in range(len(im0s)): - tracker = predictor.trackers[i if is_stream else 0] - vid_path = predictor.save_dir / Path(path[i]).name - if not persist and predictor.vid_path[i if is_stream else 0] != vid_path: - tracker.reset() - predictor.vid_path[i if is_stream else 0] = vid_path - - det = (predictor.results[i].obb if is_obb else predictor.results[i].boxes).cpu().numpy() - if len(det) == 0: - continue - tracks = tracker.update(det, im0s[i]) - if len(tracks) == 0: - continue - idx = tracks[:, -1].astype(int) - predictor.results[i] = predictor.results[i][idx] - - update_args = dict() - update_args["obb" if is_obb else "boxes"] = torch.as_tensor(tracks[:, :-1]) - predictor.results[i].update(**update_args) - - -def register_tracker(model: object, persist: bool) -> None: - """ - Register tracking callbacks to the model for object tracking during prediction. - - Args: - model (object): The model object to register tracking callbacks for. - persist (bool): Whether to persist the trackers if they already exist. - """ - model.add_callback("on_predict_start", partial(on_predict_start, persist=persist)) - model.add_callback("on_predict_postprocess_end", partial(on_predict_postprocess_end, persist=persist)) diff --git a/ultralytics-main/ultralytics/trackers/utils/__init__.py b/ultralytics-main/ultralytics/trackers/utils/__init__.py deleted file mode 100644 index 9e68dc1..0000000 --- a/ultralytics-main/ultralytics/trackers/utils/__init__.py +++ /dev/null @@ -1 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license diff --git a/ultralytics-main/ultralytics/trackers/utils/gmc.py b/ultralytics-main/ultralytics/trackers/utils/gmc.py deleted file mode 100644 index 806f1b5..0000000 --- a/ultralytics-main/ultralytics/trackers/utils/gmc.py +++ /dev/null @@ -1,363 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import copy - -import cv2 -import numpy as np - -from ultralytics.utils import LOGGER - - -class GMC: - """ - Generalized Motion Compensation (GMC) class for tracking and object detection in video frames. - - This class provides methods for tracking and detecting objects based on several tracking algorithms including ORB, - SIFT, ECC, and Sparse Optical Flow. It also supports downscaling of frames for computational efficiency. - - Attributes: - method (str): The method used for tracking. Options include 'orb', 'sift', 'ecc', 'sparseOptFlow', 'none'. - downscale (int): Factor by which to downscale the frames for processing. - prevFrame (np.ndarray): Stores the previous frame for tracking. - prevKeyPoints (list): Stores the keypoints from the previous frame. - prevDescriptors (np.ndarray): Stores the descriptors from the previous frame. - initializedFirstFrame (bool): Flag to indicate if the first frame has been processed. - - Methods: - __init__(self, method='sparseOptFlow', downscale=2): Initializes a GMC object with the specified method - and downscale factor. - apply(self, raw_frame, detections=None): Applies the chosen method to a raw frame and optionally uses - provided detections. - applyEcc(self, raw_frame, detections=None): Applies the ECC algorithm to a raw frame. - applyFeatures(self, raw_frame, detections=None): Applies feature-based methods like ORB or SIFT to a raw frame. - applySparseOptFlow(self, raw_frame, detections=None): Applies the Sparse Optical Flow method to a raw frame. - """ - - def __init__(self, method: str = "sparseOptFlow", downscale: int = 2) -> None: - """ - Initialize a video tracker with specified parameters. - - Args: - method (str): The method used for tracking. Options include 'orb', 'sift', 'ecc', 'sparseOptFlow', 'none'. - downscale (int): Downscale factor for processing frames. - """ - super().__init__() - - self.method = method - self.downscale = max(1, int(downscale)) - - if self.method == "orb": - self.detector = cv2.FastFeatureDetector_create(20) - self.extractor = cv2.ORB_create() - self.matcher = cv2.BFMatcher(cv2.NORM_HAMMING) - - elif self.method == "sift": - self.detector = cv2.SIFT_create(nOctaveLayers=3, contrastThreshold=0.02, edgeThreshold=20) - self.extractor = cv2.SIFT_create(nOctaveLayers=3, contrastThreshold=0.02, edgeThreshold=20) - self.matcher = cv2.BFMatcher(cv2.NORM_L2) - - elif self.method == "ecc": - number_of_iterations = 5000 - termination_eps = 1e-6 - self.warp_mode = cv2.MOTION_EUCLIDEAN - self.criteria = (cv2.TERM_CRITERIA_EPS | cv2.TERM_CRITERIA_COUNT, number_of_iterations, termination_eps) - - elif self.method == "sparseOptFlow": - self.feature_params = dict( - maxCorners=1000, qualityLevel=0.01, minDistance=1, blockSize=3, useHarrisDetector=False, k=0.04 - ) - - elif self.method in {"none", "None", None}: - self.method = None - else: - raise ValueError(f"Error: Unknown GMC method:{method}") - - self.prevFrame = None - self.prevKeyPoints = None - self.prevDescriptors = None - self.initializedFirstFrame = False - - def apply(self, raw_frame: np.array, detections: list = None) -> np.array: - """ - Apply object detection on a raw frame using specified method. - - Args: - raw_frame (np.ndarray): The raw frame to be processed. - detections (list): List of detections to be used in the processing. - - Returns: - (np.ndarray): Processed frame. - - Examples: - >>> gmc = GMC() - >>> gmc.apply(np.array([[1, 2, 3], [4, 5, 6]])) - array([[1, 2, 3], - [4, 5, 6]]) - """ - if self.method in ["orb", "sift"]: - return self.applyFeatures(raw_frame, detections) - elif self.method == "ecc": - return self.applyEcc(raw_frame) - elif self.method == "sparseOptFlow": - return self.applySparseOptFlow(raw_frame) - else: - return np.eye(2, 3) - - def applyEcc(self, raw_frame: np.array) -> np.array: - """ - Apply ECC algorithm to a raw frame. - - Args: - raw_frame (np.ndarray): The raw frame to be processed. - - Returns: - (np.ndarray): Processed frame. - - Examples: - >>> gmc = GMC() - >>> gmc.applyEcc(np.array([[1, 2, 3], [4, 5, 6]])) - array([[1, 2, 3], - [4, 5, 6]]) - """ - height, width, _ = raw_frame.shape - frame = cv2.cvtColor(raw_frame, cv2.COLOR_BGR2GRAY) - H = np.eye(2, 3, dtype=np.float32) - - # Downscale image - if self.downscale > 1.0: - frame = cv2.GaussianBlur(frame, (3, 3), 1.5) - frame = cv2.resize(frame, (width // self.downscale, height // self.downscale)) - width = width // self.downscale - height = height // self.downscale - - # Handle first frame - if not self.initializedFirstFrame: - # Initialize data - self.prevFrame = frame.copy() - - # Initialization done - self.initializedFirstFrame = True - - return H - - # Run the ECC algorithm. The results are stored in warp_matrix. - # (cc, H) = cv2.findTransformECC(self.prevFrame, frame, H, self.warp_mode, self.criteria) - try: - (_, H) = cv2.findTransformECC(self.prevFrame, frame, H, self.warp_mode, self.criteria, None, 1) - except Exception as e: - LOGGER.warning(f"WARNING: find transform failed. Set warp as identity {e}") - - return H - - def applyFeatures(self, raw_frame: np.array, detections: list = None) -> np.array: - """ - Apply feature-based methods like ORB or SIFT to a raw frame. - - Args: - raw_frame (np.ndarray): The raw frame to be processed. - detections (list): List of detections to be used in the processing. - - Returns: - (np.ndarray): Processed frame. - - Examples: - >>> gmc = GMC() - >>> gmc.applyFeatures(np.array([[1, 2, 3], [4, 5, 6]])) - array([[1, 2, 3], - [4, 5, 6]]) - """ - height, width, _ = raw_frame.shape - frame = cv2.cvtColor(raw_frame, cv2.COLOR_BGR2GRAY) - H = np.eye(2, 3) - - # Downscale image - if self.downscale > 1.0: - frame = cv2.resize(frame, (width // self.downscale, height // self.downscale)) - width = width // self.downscale - height = height // self.downscale - - # Find the keypoints - mask = np.zeros_like(frame) - mask[int(0.02 * height) : int(0.98 * height), int(0.02 * width) : int(0.98 * width)] = 255 - if detections is not None: - for det in detections: - tlbr = (det[:4] / self.downscale).astype(np.int_) - mask[tlbr[1] : tlbr[3], tlbr[0] : tlbr[2]] = 0 - - keypoints = self.detector.detect(frame, mask) - - # Compute the descriptors - keypoints, descriptors = self.extractor.compute(frame, keypoints) - - # Handle first frame - if not self.initializedFirstFrame: - # Initialize data - self.prevFrame = frame.copy() - self.prevKeyPoints = copy.copy(keypoints) - self.prevDescriptors = copy.copy(descriptors) - - # Initialization done - self.initializedFirstFrame = True - - return H - - # Match descriptors - knnMatches = self.matcher.knnMatch(self.prevDescriptors, descriptors, 2) - - # Filter matches based on smallest spatial distance - matches = [] - spatialDistances = [] - - maxSpatialDistance = 0.25 * np.array([width, height]) - - # Handle empty matches case - if len(knnMatches) == 0: - # Store to next iteration - self.prevFrame = frame.copy() - self.prevKeyPoints = copy.copy(keypoints) - self.prevDescriptors = copy.copy(descriptors) - - return H - - for m, n in knnMatches: - if m.distance < 0.9 * n.distance: - prevKeyPointLocation = self.prevKeyPoints[m.queryIdx].pt - currKeyPointLocation = keypoints[m.trainIdx].pt - - spatialDistance = ( - prevKeyPointLocation[0] - currKeyPointLocation[0], - prevKeyPointLocation[1] - currKeyPointLocation[1], - ) - - if (np.abs(spatialDistance[0]) < maxSpatialDistance[0]) and ( - np.abs(spatialDistance[1]) < maxSpatialDistance[1] - ): - spatialDistances.append(spatialDistance) - matches.append(m) - - meanSpatialDistances = np.mean(spatialDistances, 0) - stdSpatialDistances = np.std(spatialDistances, 0) - - inliers = (spatialDistances - meanSpatialDistances) < 2.5 * stdSpatialDistances - - goodMatches = [] - prevPoints = [] - currPoints = [] - for i in range(len(matches)): - if inliers[i, 0] and inliers[i, 1]: - goodMatches.append(matches[i]) - prevPoints.append(self.prevKeyPoints[matches[i].queryIdx].pt) - currPoints.append(keypoints[matches[i].trainIdx].pt) - - prevPoints = np.array(prevPoints) - currPoints = np.array(currPoints) - - # Draw the keypoint matches on the output image - # if False: - # import matplotlib.pyplot as plt - # matches_img = np.hstack((self.prevFrame, frame)) - # matches_img = cv2.cvtColor(matches_img, cv2.COLOR_GRAY2BGR) - # W = self.prevFrame.shape[1] - # for m in goodMatches: - # prev_pt = np.array(self.prevKeyPoints[m.queryIdx].pt, dtype=np.int_) - # curr_pt = np.array(keypoints[m.trainIdx].pt, dtype=np.int_) - # curr_pt[0] += W - # color = np.random.randint(0, 255, 3) - # color = (int(color[0]), int(color[1]), int(color[2])) - # - # matches_img = cv2.line(matches_img, prev_pt, curr_pt, tuple(color), 1, cv2.LINE_AA) - # matches_img = cv2.circle(matches_img, prev_pt, 2, tuple(color), -1) - # matches_img = cv2.circle(matches_img, curr_pt, 2, tuple(color), -1) - # - # plt.figure() - # plt.imshow(matches_img) - # plt.show() - - # Find rigid matrix - if prevPoints.shape[0] > 4: - H, inliers = cv2.estimateAffinePartial2D(prevPoints, currPoints, cv2.RANSAC) - - # Handle downscale - if self.downscale > 1.0: - H[0, 2] *= self.downscale - H[1, 2] *= self.downscale - else: - LOGGER.warning("WARNING: not enough matching points") - - # Store to next iteration - self.prevFrame = frame.copy() - self.prevKeyPoints = copy.copy(keypoints) - self.prevDescriptors = copy.copy(descriptors) - - return H - - def applySparseOptFlow(self, raw_frame: np.array) -> np.array: - """ - Apply Sparse Optical Flow method to a raw frame. - - Args: - raw_frame (np.ndarray): The raw frame to be processed. - - Returns: - (np.ndarray): Processed frame. - - Examples: - >>> gmc = GMC() - >>> gmc.applySparseOptFlow(np.array([[1, 2, 3], [4, 5, 6]])) - array([[1, 2, 3], - [4, 5, 6]]) - """ - height, width, _ = raw_frame.shape - frame = cv2.cvtColor(raw_frame, cv2.COLOR_BGR2GRAY) - H = np.eye(2, 3) - - # Downscale image - if self.downscale > 1.0: - frame = cv2.resize(frame, (width // self.downscale, height // self.downscale)) - - # Find the keypoints - keypoints = cv2.goodFeaturesToTrack(frame, mask=None, **self.feature_params) - - # Handle first frame - if not self.initializedFirstFrame: - self.prevFrame = frame.copy() - self.prevKeyPoints = copy.copy(keypoints) - self.initializedFirstFrame = True - return H - - # Find correspondences - matchedKeypoints, status, _ = cv2.calcOpticalFlowPyrLK(self.prevFrame, frame, self.prevKeyPoints, None) - - # Leave good correspondences only - prevPoints = [] - currPoints = [] - - for i in range(len(status)): - if status[i]: - prevPoints.append(self.prevKeyPoints[i]) - currPoints.append(matchedKeypoints[i]) - - prevPoints = np.array(prevPoints) - currPoints = np.array(currPoints) - - # Find rigid matrix - if (prevPoints.shape[0] > 4) and (prevPoints.shape[0] == prevPoints.shape[0]): - H, _ = cv2.estimateAffinePartial2D(prevPoints, currPoints, cv2.RANSAC) - - if self.downscale > 1.0: - H[0, 2] *= self.downscale - H[1, 2] *= self.downscale - else: - LOGGER.warning("WARNING: not enough matching points") - - self.prevFrame = frame.copy() - self.prevKeyPoints = copy.copy(keypoints) - - return H - - def reset_params(self) -> None: - """Reset parameters.""" - self.prevFrame = None - self.prevKeyPoints = None - self.prevDescriptors = None - self.initializedFirstFrame = False diff --git a/ultralytics-main/ultralytics/trackers/utils/kalman_filter.py b/ultralytics-main/ultralytics/trackers/utils/kalman_filter.py deleted file mode 100644 index 4ae68be..0000000 --- a/ultralytics-main/ultralytics/trackers/utils/kalman_filter.py +++ /dev/null @@ -1,360 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import numpy as np -import scipy.linalg - - -class KalmanFilterXYAH: - """ - For bytetrack. A simple Kalman filter for tracking bounding boxes in image space. - - The 8-dimensional state space (x, y, a, h, vx, vy, va, vh) contains the bounding box center position (x, y), aspect - ratio a, height h, and their respective velocities. - - Object motion follows a constant velocity model. The bounding box location (x, y, a, h) is taken as direct - observation of the state space (linear observation model). - """ - - def __init__(self): - """Initialize Kalman filter model matrices with motion and observation uncertainty weights.""" - ndim, dt = 4, 1.0 - - # Create Kalman filter model matrices - self._motion_mat = np.eye(2 * ndim, 2 * ndim) - for i in range(ndim): - self._motion_mat[i, ndim + i] = dt - self._update_mat = np.eye(ndim, 2 * ndim) - - # Motion and observation uncertainty are chosen relative to the current state estimate. These weights control - # the amount of uncertainty in the model. - self._std_weight_position = 1.0 / 20 - self._std_weight_velocity = 1.0 / 160 - - def initiate(self, measurement: np.ndarray) -> tuple: - """ - Create track from unassociated measurement. - - Args: - measurement (ndarray): Bounding box coordinates (x, y, a, h) with center position (x, y), aspect ratio a, - and height h. - - Returns: - (tuple[ndarray, ndarray]): Returns the mean vector (8 dimensional) and covariance matrix (8x8 dimensional) of - the new track. Unobserved velocities are initialized to 0 mean. - """ - mean_pos = measurement - mean_vel = np.zeros_like(mean_pos) - mean = np.r_[mean_pos, mean_vel] - - std = [ - 2 * self._std_weight_position * measurement[3], - 2 * self._std_weight_position * measurement[3], - 1e-2, - 2 * self._std_weight_position * measurement[3], - 10 * self._std_weight_velocity * measurement[3], - 10 * self._std_weight_velocity * measurement[3], - 1e-5, - 10 * self._std_weight_velocity * measurement[3], - ] - covariance = np.diag(np.square(std)) - return mean, covariance - - def predict(self, mean: np.ndarray, covariance: np.ndarray) -> tuple: - """ - Run Kalman filter prediction step. - - Args: - mean (ndarray): The 8 dimensional mean vector of the object state at the previous time step. - covariance (ndarray): The 8x8 dimensional covariance matrix of the object state at the previous time step. - - Returns: - (tuple[ndarray, ndarray]): Returns the mean vector and covariance matrix of the predicted state. Unobserved - velocities are initialized to 0 mean. - """ - std_pos = [ - self._std_weight_position * mean[3], - self._std_weight_position * mean[3], - 1e-2, - self._std_weight_position * mean[3], - ] - std_vel = [ - self._std_weight_velocity * mean[3], - self._std_weight_velocity * mean[3], - 1e-5, - self._std_weight_velocity * mean[3], - ] - motion_cov = np.diag(np.square(np.r_[std_pos, std_vel])) - - mean = np.dot(mean, self._motion_mat.T) - covariance = np.linalg.multi_dot((self._motion_mat, covariance, self._motion_mat.T)) + motion_cov - - return mean, covariance - - def project(self, mean: np.ndarray, covariance: np.ndarray) -> tuple: - """ - Project state distribution to measurement space. - - Args: - mean (ndarray): The state's mean vector (8 dimensional array). - covariance (ndarray): The state's covariance matrix (8x8 dimensional). - - Returns: - (tuple[ndarray, ndarray]): Returns the projected mean and covariance matrix of the given state estimate. - """ - std = [ - self._std_weight_position * mean[3], - self._std_weight_position * mean[3], - 1e-1, - self._std_weight_position * mean[3], - ] - innovation_cov = np.diag(np.square(std)) - - mean = np.dot(self._update_mat, mean) - covariance = np.linalg.multi_dot((self._update_mat, covariance, self._update_mat.T)) - return mean, covariance + innovation_cov - - def multi_predict(self, mean: np.ndarray, covariance: np.ndarray) -> tuple: - """ - Run Kalman filter prediction step (Vectorized version). - - Args: - mean (ndarray): The Nx8 dimensional mean matrix of the object states at the previous time step. - covariance (ndarray): The Nx8x8 covariance matrix of the object states at the previous time step. - - Returns: - (tuple[ndarray, ndarray]): Returns the mean vector and covariance matrix of the predicted state. Unobserved - velocities are initialized to 0 mean. - """ - std_pos = [ - self._std_weight_position * mean[:, 3], - self._std_weight_position * mean[:, 3], - 1e-2 * np.ones_like(mean[:, 3]), - self._std_weight_position * mean[:, 3], - ] - std_vel = [ - self._std_weight_velocity * mean[:, 3], - self._std_weight_velocity * mean[:, 3], - 1e-5 * np.ones_like(mean[:, 3]), - self._std_weight_velocity * mean[:, 3], - ] - sqr = np.square(np.r_[std_pos, std_vel]).T - - motion_cov = [np.diag(sqr[i]) for i in range(len(mean))] - motion_cov = np.asarray(motion_cov) - - mean = np.dot(mean, self._motion_mat.T) - left = np.dot(self._motion_mat, covariance).transpose((1, 0, 2)) - covariance = np.dot(left, self._motion_mat.T) + motion_cov - - return mean, covariance - - def update(self, mean: np.ndarray, covariance: np.ndarray, measurement: np.ndarray) -> tuple: - """ - Run Kalman filter correction step. - - Args: - mean (ndarray): The predicted state's mean vector (8 dimensional). - covariance (ndarray): The state's covariance matrix (8x8 dimensional). - measurement (ndarray): The 4 dimensional measurement vector (x, y, a, h), where (x, y) is the center - position, a the aspect ratio, and h the height of the bounding box. - - Returns: - (tuple[ndarray, ndarray]): Returns the measurement-corrected state distribution. - """ - projected_mean, projected_cov = self.project(mean, covariance) - - chol_factor, lower = scipy.linalg.cho_factor(projected_cov, lower=True, check_finite=False) - kalman_gain = scipy.linalg.cho_solve( - (chol_factor, lower), np.dot(covariance, self._update_mat.T).T, check_finite=False - ).T - innovation = measurement - projected_mean - - new_mean = mean + np.dot(innovation, kalman_gain.T) - new_covariance = covariance - np.linalg.multi_dot((kalman_gain, projected_cov, kalman_gain.T)) - return new_mean, new_covariance - - def gating_distance( - self, - mean: np.ndarray, - covariance: np.ndarray, - measurements: np.ndarray, - only_position: bool = False, - metric: str = "maha", - ) -> np.ndarray: - """ - Compute gating distance between state distribution and measurements. A suitable distance threshold can be - obtained from `chi2inv95`. If `only_position` is False, the chi-square distribution has 4 degrees of freedom, - otherwise 2. - - Args: - mean (ndarray): Mean vector over the state distribution (8 dimensional). - covariance (ndarray): Covariance of the state distribution (8x8 dimensional). - measurements (ndarray): An Nx4 matrix of N measurements, each in format (x, y, a, h) where (x, y) - is the bounding box center position, a the aspect ratio, and h the height. - only_position (bool, optional): If True, distance computation is done with respect to the bounding box - center position only. Defaults to False. - metric (str, optional): The metric to use for calculating the distance. Options are 'gaussian' for the - squared Euclidean distance and 'maha' for the squared Mahalanobis distance. Defaults to 'maha'. - - Returns: - (np.ndarray): Returns an array of length N, where the i-th element contains the squared distance between - (mean, covariance) and `measurements[i]`. - """ - mean, covariance = self.project(mean, covariance) - if only_position: - mean, covariance = mean[:2], covariance[:2, :2] - measurements = measurements[:, :2] - - d = measurements - mean - if metric == "gaussian": - return np.sum(d * d, axis=1) - elif metric == "maha": - cholesky_factor = np.linalg.cholesky(covariance) - z = scipy.linalg.solve_triangular(cholesky_factor, d.T, lower=True, check_finite=False, overwrite_b=True) - return np.sum(z * z, axis=0) # square maha - else: - raise ValueError("Invalid distance metric") - - -class KalmanFilterXYWH(KalmanFilterXYAH): - """ - For BoT-SORT. A simple Kalman filter for tracking bounding boxes in image space. - - The 8-dimensional state space (x, y, w, h, vx, vy, vw, vh) contains the bounding box center position (x, y), width - w, height h, and their respective velocities. - - Object motion follows a constant velocity model. The bounding box location (x, y, w, h) is taken as direct - observation of the state space (linear observation model). - """ - - def initiate(self, measurement: np.ndarray) -> tuple: - """ - Create track from unassociated measurement. - - Args: - measurement (ndarray): Bounding box coordinates (x, y, w, h) with center position (x, y), width, and height. - - Returns: - (tuple[ndarray, ndarray]): Returns the mean vector (8 dimensional) and covariance matrix (8x8 dimensional) of - the new track. Unobserved velocities are initialized to 0 mean. - """ - mean_pos = measurement - mean_vel = np.zeros_like(mean_pos) - mean = np.r_[mean_pos, mean_vel] - - std = [ - 2 * self._std_weight_position * measurement[2], - 2 * self._std_weight_position * measurement[3], - 2 * self._std_weight_position * measurement[2], - 2 * self._std_weight_position * measurement[3], - 10 * self._std_weight_velocity * measurement[2], - 10 * self._std_weight_velocity * measurement[3], - 10 * self._std_weight_velocity * measurement[2], - 10 * self._std_weight_velocity * measurement[3], - ] - covariance = np.diag(np.square(std)) - return mean, covariance - - def predict(self, mean, covariance) -> tuple: - """ - Run Kalman filter prediction step. - - Args: - mean (ndarray): The 8 dimensional mean vector of the object state at the previous time step. - covariance (ndarray): The 8x8 dimensional covariance matrix of the object state at the previous time step. - - Returns: - (tuple[ndarray, ndarray]): Returns the mean vector and covariance matrix of the predicted state. Unobserved - velocities are initialized to 0 mean. - """ - std_pos = [ - self._std_weight_position * mean[2], - self._std_weight_position * mean[3], - self._std_weight_position * mean[2], - self._std_weight_position * mean[3], - ] - std_vel = [ - self._std_weight_velocity * mean[2], - self._std_weight_velocity * mean[3], - self._std_weight_velocity * mean[2], - self._std_weight_velocity * mean[3], - ] - motion_cov = np.diag(np.square(np.r_[std_pos, std_vel])) - - mean = np.dot(mean, self._motion_mat.T) - covariance = np.linalg.multi_dot((self._motion_mat, covariance, self._motion_mat.T)) + motion_cov - - return mean, covariance - - def project(self, mean, covariance) -> tuple: - """ - Project state distribution to measurement space. - - Args: - mean (ndarray): The state's mean vector (8 dimensional array). - covariance (ndarray): The state's covariance matrix (8x8 dimensional). - - Returns: - (tuple[ndarray, ndarray]): Returns the projected mean and covariance matrix of the given state estimate. - """ - std = [ - self._std_weight_position * mean[2], - self._std_weight_position * mean[3], - self._std_weight_position * mean[2], - self._std_weight_position * mean[3], - ] - innovation_cov = np.diag(np.square(std)) - - mean = np.dot(self._update_mat, mean) - covariance = np.linalg.multi_dot((self._update_mat, covariance, self._update_mat.T)) - return mean, covariance + innovation_cov - - def multi_predict(self, mean, covariance) -> tuple: - """ - Run Kalman filter prediction step (Vectorized version). - - Args: - mean (ndarray): The Nx8 dimensional mean matrix of the object states at the previous time step. - covariance (ndarray): The Nx8x8 covariance matrix of the object states at the previous time step. - - Returns: - (tuple[ndarray, ndarray]): Returns the mean vector and covariance matrix of the predicted state. Unobserved - velocities are initialized to 0 mean. - """ - std_pos = [ - self._std_weight_position * mean[:, 2], - self._std_weight_position * mean[:, 3], - self._std_weight_position * mean[:, 2], - self._std_weight_position * mean[:, 3], - ] - std_vel = [ - self._std_weight_velocity * mean[:, 2], - self._std_weight_velocity * mean[:, 3], - self._std_weight_velocity * mean[:, 2], - self._std_weight_velocity * mean[:, 3], - ] - sqr = np.square(np.r_[std_pos, std_vel]).T - - motion_cov = [np.diag(sqr[i]) for i in range(len(mean))] - motion_cov = np.asarray(motion_cov) - - mean = np.dot(mean, self._motion_mat.T) - left = np.dot(self._motion_mat, covariance).transpose((1, 0, 2)) - covariance = np.dot(left, self._motion_mat.T) + motion_cov - - return mean, covariance - - def update(self, mean, covariance, measurement) -> tuple: - """ - Run Kalman filter correction step. - - Args: - mean (ndarray): The predicted state's mean vector (8 dimensional). - covariance (ndarray): The state's covariance matrix (8x8 dimensional). - measurement (ndarray): The 4 dimensional measurement vector (x, y, w, h), where (x, y) is the center - position, w the width, and h the height of the bounding box. - - Returns: - (tuple[ndarray, ndarray]): Returns the measurement-corrected state distribution. - """ - return super().update(mean, covariance, measurement) diff --git a/ultralytics-main/ultralytics/trackers/utils/matching.py b/ultralytics-main/ultralytics/trackers/utils/matching.py deleted file mode 100644 index fa72b8b..0000000 --- a/ultralytics-main/ultralytics/trackers/utils/matching.py +++ /dev/null @@ -1,138 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import numpy as np -import scipy -from scipy.spatial.distance import cdist - -from ultralytics.utils.metrics import bbox_ioa, batch_probiou - -try: - import lap # for linear_assignment - - assert lap.__version__ # verify package is not directory -except (ImportError, AssertionError, AttributeError): - from ultralytics.utils.checks import check_requirements - - check_requirements("lapx>=0.5.2") # update to lap package from https://github.com/rathaROG/lapx - import lap - - -def linear_assignment(cost_matrix: np.ndarray, thresh: float, use_lap: bool = True) -> tuple: - """ - Perform linear assignment using scipy or lap.lapjv. - - Args: - cost_matrix (np.ndarray): The matrix containing cost values for assignments. - thresh (float): Threshold for considering an assignment valid. - use_lap (bool, optional): Whether to use lap.lapjv. Defaults to True. - - Returns: - Tuple with: - - matched indices - - unmatched indices from 'a' - - unmatched indices from 'b' - """ - - if cost_matrix.size == 0: - return np.empty((0, 2), dtype=int), tuple(range(cost_matrix.shape[0])), tuple(range(cost_matrix.shape[1])) - - if use_lap: - # Use lap.lapjv - # https://github.com/gatagat/lap - _, x, y = lap.lapjv(cost_matrix, extend_cost=True, cost_limit=thresh) - matches = [[ix, mx] for ix, mx in enumerate(x) if mx >= 0] - unmatched_a = np.where(x < 0)[0] - unmatched_b = np.where(y < 0)[0] - else: - # Use scipy.optimize.linear_sum_assignment - # https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.linear_sum_assignment.html - x, y = scipy.optimize.linear_sum_assignment(cost_matrix) # row x, col y - matches = np.asarray([[x[i], y[i]] for i in range(len(x)) if cost_matrix[x[i], y[i]] <= thresh]) - if len(matches) == 0: - unmatched_a = list(np.arange(cost_matrix.shape[0])) - unmatched_b = list(np.arange(cost_matrix.shape[1])) - else: - unmatched_a = list(set(np.arange(cost_matrix.shape[0])) - set(matches[:, 0])) - unmatched_b = list(set(np.arange(cost_matrix.shape[1])) - set(matches[:, 1])) - - return matches, unmatched_a, unmatched_b - - -def iou_distance(atracks: list, btracks: list) -> np.ndarray: - """ - Compute cost based on Intersection over Union (IoU) between tracks. - - Args: - atracks (list[STrack] | list[np.ndarray]): List of tracks 'a' or bounding boxes. - btracks (list[STrack] | list[np.ndarray]): List of tracks 'b' or bounding boxes. - - Returns: - (np.ndarray): Cost matrix computed based on IoU. - """ - - if atracks and isinstance(atracks[0], np.ndarray) or btracks and isinstance(btracks[0], np.ndarray): - atlbrs = atracks - btlbrs = btracks - else: - atlbrs = [track.xywha if track.angle is not None else track.xyxy for track in atracks] - btlbrs = [track.xywha if track.angle is not None else track.xyxy for track in btracks] - - ious = np.zeros((len(atlbrs), len(btlbrs)), dtype=np.float32) - if len(atlbrs) and len(btlbrs): - if len(atlbrs[0]) == 5 and len(btlbrs[0]) == 5: - ious = batch_probiou( - np.ascontiguousarray(atlbrs, dtype=np.float32), - np.ascontiguousarray(btlbrs, dtype=np.float32), - ).numpy() - else: - ious = bbox_ioa( - np.ascontiguousarray(atlbrs, dtype=np.float32), - np.ascontiguousarray(btlbrs, dtype=np.float32), - iou=True, - ) - return 1 - ious # cost matrix - - -def embedding_distance(tracks: list, detections: list, metric: str = "cosine") -> np.ndarray: - """ - Compute distance between tracks and detections based on embeddings. - - Args: - tracks (list[STrack]): List of tracks. - detections (list[BaseTrack]): List of detections. - metric (str, optional): Metric for distance computation. Defaults to 'cosine'. - - Returns: - (np.ndarray): Cost matrix computed based on embeddings. - """ - - cost_matrix = np.zeros((len(tracks), len(detections)), dtype=np.float32) - if cost_matrix.size == 0: - return cost_matrix - det_features = np.asarray([track.curr_feat for track in detections], dtype=np.float32) - # for i, track in enumerate(tracks): - # cost_matrix[i, :] = np.maximum(0.0, cdist(track.smooth_feat.reshape(1,-1), det_features, metric)) - track_features = np.asarray([track.smooth_feat for track in tracks], dtype=np.float32) - cost_matrix = np.maximum(0.0, cdist(track_features, det_features, metric)) # Normalized features - return cost_matrix - - -def fuse_score(cost_matrix: np.ndarray, detections: list) -> np.ndarray: - """ - Fuses cost matrix with detection scores to produce a single similarity matrix. - - Args: - cost_matrix (np.ndarray): The matrix containing cost values for assignments. - detections (list[BaseTrack]): List of detections with scores. - - Returns: - (np.ndarray): Fused similarity matrix. - """ - - if cost_matrix.size == 0: - return cost_matrix - iou_sim = 1 - cost_matrix - det_scores = np.array([det.score for det in detections]) - det_scores = np.expand_dims(det_scores, axis=0).repeat(cost_matrix.shape[0], axis=0) - fuse_sim = iou_sim * det_scores - return 1 - fuse_sim # fuse_cost diff --git a/ultralytics-main/ultralytics/utils/__init__.py b/ultralytics-main/ultralytics/utils/__init__.py deleted file mode 100644 index befa081..0000000 --- a/ultralytics-main/ultralytics/utils/__init__.py +++ /dev/null @@ -1,1049 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import contextlib -import inspect -import logging.config -import os -import platform -import re -import subprocess -import sys -import threading -import time -import urllib -import uuid -from pathlib import Path -from types import SimpleNamespace -from typing import Union - -import cv2 -import matplotlib.pyplot as plt -import numpy as np -import torch -import yaml -from tqdm import tqdm as tqdm_original - -from ultralytics import __version__ - -# PyTorch Multi-GPU DDP Constants -RANK = int(os.getenv("RANK", -1)) -LOCAL_RANK = int(os.getenv("LOCAL_RANK", -1)) # https://pytorch.org/docs/stable/elastic/run.html - -# Other Constants -FILE = Path(__file__).resolve() -ROOT = FILE.parents[1] # YOLO -ASSETS = ROOT / "assets" # default images -DEFAULT_CFG_PATH = ROOT / "cfg/default.yaml" -NUM_THREADS = min(8, max(1, os.cpu_count() - 1)) # number of YOLOv5 multiprocessing threads -AUTOINSTALL = str(os.getenv("YOLO_AUTOINSTALL", True)).lower() == "true" # global auto-install mode -VERBOSE = str(os.getenv("YOLO_VERBOSE", True)).lower() == "true" # global verbose mode -TQDM_BAR_FORMAT = "{l_bar}{bar:10}{r_bar}" if VERBOSE else None # tqdm bar format -LOGGING_NAME = "ultralytics" -MACOS, LINUX, WINDOWS = (platform.system() == x for x in ["Darwin", "Linux", "Windows"]) # environment booleans -ARM64 = platform.machine() in ("arm64", "aarch64") # ARM64 booleans -HELP_MSG = """ - Usage examples for running YOLOv8: - - 1. Install the ultralytics package: - - pip install ultralytics - - 2. Use the Python SDK: - - from ultralytics import YOLO - - # Load a model - model = YOLO('yolov8n.yaml') # build a new model from scratch - model = YOLO("yolov8n.pt") # load a pretrained model (recommended for training) - - # Use the model - results = model.train(data="coco128.yaml", epochs=3) # train the model - results = model.val() # evaluate model performance on the validation set - results = model('https://ultralytics.com/images/bus.jpg') # predict on an image - success = model.export(format='onnx') # export the model to ONNX format - - 3. Use the command line interface (CLI): - - YOLOv8 'yolo' CLI commands use the following syntax: - - yolo TASK MODE ARGS - - Where TASK (optional) is one of [detect, segment, classify] - MODE (required) is one of [train, val, predict, export] - ARGS (optional) are any number of custom 'arg=value' pairs like 'imgsz=320' that override defaults. - See all ARGS at https://docs.ultralytics.com/usage/cfg or with 'yolo cfg' - - - Train a detection model for 10 epochs with an initial learning_rate of 0.01 - yolo detect train data=coco128.yaml model=yolov8n.pt epochs=10 lr0=0.01 - - - Predict a YouTube video using a pretrained segmentation model at image size 320: - yolo segment predict model=yolov8n-seg.pt source='https://youtu.be/LNwODJXcvt4' imgsz=320 - - - Val a pretrained detection model at batch-size 1 and image size 640: - yolo detect val model=yolov8n.pt data=coco128.yaml batch=1 imgsz=640 - - - Export a YOLOv8n classification model to ONNX format at image size 224 by 128 (no TASK required) - yolo export model=yolov8n-cls.pt format=onnx imgsz=224,128 - - - Run special commands: - yolo help - yolo checks - yolo version - yolo settings - yolo copy-cfg - yolo cfg - - Docs: https://docs.ultralytics.com - Community: https://community.ultralytics.com - GitHub: https://github.com/ultralytics/ultralytics - """ - -# Settings -torch.set_printoptions(linewidth=320, precision=4, profile="default") -np.set_printoptions(linewidth=320, formatter={"float_kind": "{:11.5g}".format}) # format short g, %precision=5 -cv2.setNumThreads(0) # prevent OpenCV from multithreading (incompatible with PyTorch DataLoader) -os.environ["NUMEXPR_MAX_THREADS"] = str(NUM_THREADS) # NumExpr max threads -os.environ["CUBLAS_WORKSPACE_CONFIG"] = ":4096:8" # for deterministic training -os.environ["TF_CPP_MIN_LOG_LEVEL"] = "2" # suppress verbose TF compiler warnings in Colab - - -class TQDM(tqdm_original): - """ - Custom Ultralytics tqdm class with different default arguments. - - Args: - *args (list): Positional arguments passed to original tqdm. - **kwargs (any): Keyword arguments, with custom defaults applied. - """ - - def __init__(self, *args, **kwargs): - """ - Initialize custom Ultralytics tqdm class with different default arguments. - - Note these can still be overridden when calling TQDM. - """ - kwargs["disable"] = not VERBOSE or kwargs.get("disable", False) # logical 'and' with default value if passed - kwargs.setdefault("bar_format", TQDM_BAR_FORMAT) # override default value if passed - super().__init__(*args, **kwargs) - - -class SimpleClass: - """Ultralytics SimpleClass is a base class providing helpful string representation, error reporting, and attribute - access methods for easier debugging and usage. - """ - - def __str__(self): - """Return a human-readable string representation of the object.""" - attr = [] - for a in dir(self): - v = getattr(self, a) - if not callable(v) and not a.startswith("_"): - if isinstance(v, SimpleClass): - # Display only the module and class name for subclasses - s = f"{a}: {v.__module__}.{v.__class__.__name__} object" - else: - s = f"{a}: {repr(v)}" - attr.append(s) - return f"{self.__module__}.{self.__class__.__name__} object with attributes:\n\n" + "\n".join(attr) - - def __repr__(self): - """Return a machine-readable string representation of the object.""" - return self.__str__() - - def __getattr__(self, attr): - """Custom attribute access error message with helpful information.""" - name = self.__class__.__name__ - raise AttributeError(f"'{name}' object has no attribute '{attr}'. See valid attributes below.\n{self.__doc__}") - - -class IterableSimpleNamespace(SimpleNamespace): - """Ultralytics IterableSimpleNamespace is an extension class of SimpleNamespace that adds iterable functionality and - enables usage with dict() and for loops. - """ - - def __iter__(self): - """Return an iterator of key-value pairs from the namespace's attributes.""" - return iter(vars(self).items()) - - def __str__(self): - """Return a human-readable string representation of the object.""" - return "\n".join(f"{k}={v}" for k, v in vars(self).items()) - - def __getattr__(self, attr): - """Custom attribute access error message with helpful information.""" - name = self.__class__.__name__ - raise AttributeError( - f""" - '{name}' object has no attribute '{attr}'. This may be caused by a modified or out of date ultralytics - 'default.yaml' file.\nPlease update your code with 'pip install -U ultralytics' and if necessary replace - {DEFAULT_CFG_PATH} with the latest version from - https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/default.yaml - """ - ) - - def get(self, key, default=None): - """Return the value of the specified key if it exists; otherwise, return the default value.""" - return getattr(self, key, default) - - -def plt_settings(rcparams=None, backend="Agg"): - """ - Decorator to temporarily set rc parameters and the backend for a plotting function. - - Example: - decorator: @plt_settings({"font.size": 12}) - context manager: with plt_settings({"font.size": 12}): - - Args: - rcparams (dict): Dictionary of rc parameters to set. - backend (str, optional): Name of the backend to use. Defaults to 'Agg'. - - Returns: - (Callable): Decorated function with temporarily set rc parameters and backend. This decorator can be - applied to any function that needs to have specific matplotlib rc parameters and backend for its execution. - """ - - if rcparams is None: - rcparams = {"font.size": 11} - - def decorator(func): - """Decorator to apply temporary rc parameters and backend to a function.""" - - def wrapper(*args, **kwargs): - """Sets rc parameters and backend, calls the original function, and restores the settings.""" - original_backend = plt.get_backend() - if backend.lower() != original_backend.lower(): - plt.close("all") # auto-close()ing of figures upon backend switching is deprecated since 3.8 - plt.switch_backend(backend) - - with plt.rc_context(rcparams): - result = func(*args, **kwargs) - - if backend != original_backend: - plt.close("all") - plt.switch_backend(original_backend) - return result - - return wrapper - - return decorator - - -def set_logging(name=LOGGING_NAME, verbose=True): - """Sets up logging for the given name with UTF-8 encoding support.""" - level = logging.INFO if verbose and RANK in {-1, 0} else logging.ERROR # rank in world for Multi-GPU trainings - - # Configure the console (stdout) encoding to UTF-8 - formatter = logging.Formatter("%(message)s") # Default formatter - if WINDOWS and sys.stdout.encoding != "utf-8": - try: - if hasattr(sys.stdout, "reconfigure"): - sys.stdout.reconfigure(encoding="utf-8") - elif hasattr(sys.stdout, "buffer"): - import io - - sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8") - else: - sys.stdout.encoding = "utf-8" - except Exception as e: - print(f"Creating custom formatter for non UTF-8 environments due to {e}") - - class CustomFormatter(logging.Formatter): - def format(self, record): - """Sets up logging with UTF-8 encoding and configurable verbosity.""" - return emojis(super().format(record)) - - formatter = CustomFormatter("%(message)s") # Use CustomFormatter to eliminate UTF-8 output as last recourse - - # Create and configure the StreamHandler - stream_handler = logging.StreamHandler(sys.stdout) - stream_handler.setFormatter(formatter) - stream_handler.setLevel(level) - - logger = logging.getLogger(name) - logger.setLevel(level) - logger.addHandler(stream_handler) - logger.propagate = False - return logger - - -# Set logger -LOGGER = set_logging(LOGGING_NAME, verbose=VERBOSE) # define globally (used in train.py, val.py, predict.py, etc.) -for logger in "sentry_sdk", "urllib3.connectionpool": - logging.getLogger(logger).setLevel(logging.CRITICAL + 1) - - -def emojis(string=""): - """Return platform-dependent emoji-safe version of string.""" - return string.encode().decode("ascii", "ignore") if WINDOWS else string - - -class ThreadingLocked: - """ - A decorator class for ensuring thread-safe execution of a function or method. This class can be used as a decorator - to make sure that if the decorated function is called from multiple threads, only one thread at a time will be able - to execute the function. - - Attributes: - lock (threading.Lock): A lock object used to manage access to the decorated function. - - Example: - ```python - from ultralytics.utils import ThreadingLocked - - @ThreadingLocked() - def my_function(): - # Your code here - pass - ``` - """ - - def __init__(self): - """Initializes the decorator class for thread-safe execution of a function or method.""" - self.lock = threading.Lock() - - def __call__(self, f): - """Run thread-safe execution of function or method.""" - from functools import wraps - - @wraps(f) - def decorated(*args, **kwargs): - """Applies thread-safety to the decorated function or method.""" - with self.lock: - return f(*args, **kwargs) - - return decorated - - -def yaml_save(file="data.yaml", data=None, header=""): - """ - Save YAML data to a file. - - Args: - file (str, optional): File name. Default is 'data.yaml'. - data (dict): Data to save in YAML format. - header (str, optional): YAML header to add. - - Returns: - (None): Data is saved to the specified file. - """ - if data is None: - data = {} - file = Path(file) - if not file.parent.exists(): - # Create parent directories if they don't exist - file.parent.mkdir(parents=True, exist_ok=True) - - # Convert Path objects to strings - valid_types = int, float, str, bool, list, tuple, dict, type(None) - for k, v in data.items(): - if not isinstance(v, valid_types): - data[k] = str(v) - - # Dump data to file in YAML format - with open(file, "w", errors="ignore", encoding="utf-8") as f: - if header: - f.write(header) - yaml.safe_dump(data, f, sort_keys=False, allow_unicode=True) - - -def yaml_load(file="data.yaml", append_filename=False): - """ - Load YAML data from a file. - - Args: - file (str, optional): File name. Default is 'data.yaml'. - append_filename (bool): Add the YAML filename to the YAML dictionary. Default is False. - - Returns: - (dict): YAML data and file name. - """ - assert Path(file).suffix in (".yaml", ".yml"), f"Attempting to load non-YAML file {file} with yaml_load()" - with open(file, errors="ignore", encoding="utf-8") as f: - s = f.read() # string - - # Remove special characters - if not s.isprintable(): - s = re.sub(r"[^\x09\x0A\x0D\x20-\x7E\x85\xA0-\uD7FF\uE000-\uFFFD\U00010000-\U0010ffff]+", "", s) - - # Add YAML filename to dict and return - data = yaml.safe_load(s) or {} # always return a dict (yaml.safe_load() may return None for empty files) - if append_filename: - data["yaml_file"] = str(file) - return data - - -def yaml_print(yaml_file: Union[str, Path, dict]) -> None: - """ - Pretty prints a YAML file or a YAML-formatted dictionary. - - Args: - yaml_file: The file path of the YAML file or a YAML-formatted dictionary. - - Returns: - (None) - """ - yaml_dict = yaml_load(yaml_file) if isinstance(yaml_file, (str, Path)) else yaml_file - dump = yaml.dump(yaml_dict, sort_keys=False, allow_unicode=True) - LOGGER.info(f"Printing '{colorstr('bold', 'black', yaml_file)}'\n\n{dump}") - - -# Default configuration -DEFAULT_CFG_DICT = yaml_load(DEFAULT_CFG_PATH) -for k, v in DEFAULT_CFG_DICT.items(): - if isinstance(v, str) and v.lower() == "none": - DEFAULT_CFG_DICT[k] = None -DEFAULT_CFG_KEYS = DEFAULT_CFG_DICT.keys() -DEFAULT_CFG = IterableSimpleNamespace(**DEFAULT_CFG_DICT) - - -def is_ubuntu() -> bool: - """ - Check if the OS is Ubuntu. - - Returns: - (bool): True if OS is Ubuntu, False otherwise. - """ - with contextlib.suppress(FileNotFoundError): - with open("/etc/os-release") as f: - return "ID=ubuntu" in f.read() - return False - - -def is_colab(): - """ - Check if the current script is running inside a Google Colab notebook. - - Returns: - (bool): True if running inside a Colab notebook, False otherwise. - """ - return "COLAB_RELEASE_TAG" in os.environ or "COLAB_BACKEND_VERSION" in os.environ - - -def is_kaggle(): - """ - Check if the current script is running inside a Kaggle kernel. - - Returns: - (bool): True if running inside a Kaggle kernel, False otherwise. - """ - return os.environ.get("PWD") == "/kaggle/working" and os.environ.get("KAGGLE_URL_BASE") == "https://www.kaggle.com" - - -def is_jupyter(): - """ - Check if the current script is running inside a Jupyter Notebook. Verified on Colab, Jupyterlab, Kaggle, Paperspace. - - Returns: - (bool): True if running inside a Jupyter Notebook, False otherwise. - """ - with contextlib.suppress(Exception): - from IPython import get_ipython - - return get_ipython() is not None - return False - - -def is_docker() -> bool: - """ - Determine if the script is running inside a Docker container. - - Returns: - (bool): True if the script is running inside a Docker container, False otherwise. - """ - file = Path("/proc/self/cgroup") - if file.exists(): - with open(file) as f: - return "docker" in f.read() - else: - return False - - -def is_online() -> bool: - """ - Check internet connectivity by attempting to connect to a known online host. - - Returns: - (bool): True if connection is successful, False otherwise. - """ - import socket - - for host in "1.1.1.1", "8.8.8.8", "223.5.5.5": # Cloudflare, Google, AliDNS: - try: - test_connection = socket.create_connection(address=(host, 53), timeout=2) - except (socket.timeout, socket.gaierror, OSError): - continue - else: - # If the connection was successful, close it to avoid a ResourceWarning - test_connection.close() - return True - return False - - -ONLINE = is_online() - - -def is_pip_package(filepath: str = __name__) -> bool: - """ - Determines if the file at the given filepath is part of a pip package. - - Args: - filepath (str): The filepath to check. - - Returns: - (bool): True if the file is part of a pip package, False otherwise. - """ - import importlib.util - - # Get the spec for the module - spec = importlib.util.find_spec(filepath) - - # Return whether the spec is not None and the origin is not None (indicating it is a package) - return spec is not None and spec.origin is not None - - -def is_dir_writeable(dir_path: Union[str, Path]) -> bool: - """ - Check if a directory is writeable. - - Args: - dir_path (str | Path): The path to the directory. - - Returns: - (bool): True if the directory is writeable, False otherwise. - """ - return os.access(str(dir_path), os.W_OK) - - -def is_pytest_running(): - """ - Determines whether pytest is currently running or not. - - Returns: - (bool): True if pytest is running, False otherwise. - """ - return ("PYTEST_CURRENT_TEST" in os.environ) or ("pytest" in sys.modules) or ("pytest" in Path(sys.argv[0]).stem) - - -def is_github_action_running() -> bool: - """ - Determine if the current environment is a GitHub Actions runner. - - Returns: - (bool): True if the current environment is a GitHub Actions runner, False otherwise. - """ - return "GITHUB_ACTIONS" in os.environ and "GITHUB_WORKFLOW" in os.environ and "RUNNER_OS" in os.environ - - -def is_git_dir(): - """ - Determines whether the current file is part of a git repository. If the current file is not part of a git - repository, returns None. - - Returns: - (bool): True if current file is part of a git repository. - """ - return get_git_dir() is not None - - -def get_git_dir(): - """ - Determines whether the current file is part of a git repository and if so, returns the repository root directory. If - the current file is not part of a git repository, returns None. - - Returns: - (Path | None): Git root directory if found or None if not found. - """ - for d in Path(__file__).parents: - if (d / ".git").is_dir(): - return d - - -def get_git_origin_url(): - """ - Retrieves the origin URL of a git repository. - - Returns: - (str | None): The origin URL of the git repository or None if not git directory. - """ - if is_git_dir(): - with contextlib.suppress(subprocess.CalledProcessError): - origin = subprocess.check_output(["git", "config", "--get", "remote.origin.url"]) - return origin.decode().strip() - - -def get_git_branch(): - """ - Returns the current git branch name. If not in a git repository, returns None. - - Returns: - (str | None): The current git branch name or None if not a git directory. - """ - if is_git_dir(): - with contextlib.suppress(subprocess.CalledProcessError): - origin = subprocess.check_output(["git", "rev-parse", "--abbrev-ref", "HEAD"]) - return origin.decode().strip() - - -def get_default_args(func): - """ - Returns a dictionary of default arguments for a function. - - Args: - func (callable): The function to inspect. - - Returns: - (dict): A dictionary where each key is a parameter name, and each value is the default value of that parameter. - """ - signature = inspect.signature(func) - return {k: v.default for k, v in signature.parameters.items() if v.default is not inspect.Parameter.empty} - - -def get_ubuntu_version(): - """ - Retrieve the Ubuntu version if the OS is Ubuntu. - - Returns: - (str): Ubuntu version or None if not an Ubuntu OS. - """ - if is_ubuntu(): - with contextlib.suppress(FileNotFoundError, AttributeError): - with open("/etc/os-release") as f: - return re.search(r'VERSION_ID="(\d+\.\d+)"', f.read())[1] - - -def get_user_config_dir(sub_dir="Ultralytics"): - """ - Return the appropriate config directory based on the environment operating system. - - Args: - sub_dir (str): The name of the subdirectory to create. - - Returns: - (Path): The path to the user config directory. - """ - if WINDOWS: - path = Path.home() / "AppData" / "Roaming" / sub_dir - elif MACOS: # macOS - path = Path.home() / "Library" / "Application Support" / sub_dir - elif LINUX: - path = Path.home() / ".config" / sub_dir - else: - raise ValueError(f"Unsupported operating system: {platform.system()}") - - # GCP and AWS lambda fix, only /tmp is writeable - if not is_dir_writeable(path.parent): - LOGGER.warning( - f"WARNING ⚠️ user config directory '{path}' is not writeable, defaulting to '/tmp' or CWD." - "Alternatively you can define a YOLO_CONFIG_DIR environment variable for this path." - ) - path = Path("/tmp") / sub_dir if is_dir_writeable("/tmp") else Path().cwd() / sub_dir - - # Create the subdirectory if it does not exist - path.mkdir(parents=True, exist_ok=True) - - return path - - -USER_CONFIG_DIR = Path(os.getenv("YOLO_CONFIG_DIR") or get_user_config_dir()) # Ultralytics settings dir -SETTINGS_YAML = USER_CONFIG_DIR / "settings.yaml" - - -def colorstr(*input): - """ - Colors a string based on the provided color and style arguments. Utilizes ANSI escape codes. - See https://en.wikipedia.org/wiki/ANSI_escape_code for more details. - - This function can be called in two ways: - - colorstr('color', 'style', 'your string') - - colorstr('your string') - - In the second form, 'blue' and 'bold' will be applied by default. - - Args: - *input (str): A sequence of strings where the first n-1 strings are color and style arguments, - and the last string is the one to be colored. - - Supported Colors and Styles: - Basic Colors: 'black', 'red', 'green', 'yellow', 'blue', 'magenta', 'cyan', 'white' - Bright Colors: 'bright_black', 'bright_red', 'bright_green', 'bright_yellow', - 'bright_blue', 'bright_magenta', 'bright_cyan', 'bright_white' - Misc: 'end', 'bold', 'underline' - - Returns: - (str): The input string wrapped with ANSI escape codes for the specified color and style. - - Examples: - >>> colorstr('blue', 'bold', 'hello world') - >>> '\033[34m\033[1mhello world\033[0m' - """ - *args, string = input if len(input) > 1 else ("blue", "bold", input[0]) # color arguments, string - colors = { - "black": "\033[30m", # basic colors - "red": "\033[31m", - "green": "\033[32m", - "yellow": "\033[33m", - "blue": "\033[34m", - "magenta": "\033[35m", - "cyan": "\033[36m", - "white": "\033[37m", - "bright_black": "\033[90m", # bright colors - "bright_red": "\033[91m", - "bright_green": "\033[92m", - "bright_yellow": "\033[93m", - "bright_blue": "\033[94m", - "bright_magenta": "\033[95m", - "bright_cyan": "\033[96m", - "bright_white": "\033[97m", - "end": "\033[0m", # misc - "bold": "\033[1m", - "underline": "\033[4m", - } - return "".join(colors[x] for x in args) + f"{string}" + colors["end"] - - -def remove_colorstr(input_string): - """ - Removes ANSI escape codes from a string, effectively un-coloring it. - - Args: - input_string (str): The string to remove color and style from. - - Returns: - (str): A new string with all ANSI escape codes removed. - - Examples: - >>> remove_colorstr(colorstr('blue', 'bold', 'hello world')) - >>> 'hello world' - """ - ansi_escape = re.compile(r"\x1B\[[0-9;]*[A-Za-z]") - return ansi_escape.sub("", input_string) - - -class TryExcept(contextlib.ContextDecorator): - """ - Ultralytics TryExcept class. Use as @TryExcept() decorator or 'with TryExcept():' context manager. - - Examples: - As a decorator: - >>> @TryExcept(msg="Error occurred in func", verbose=True) - >>> def func(): - >>> # Function logic here - >>> pass - - As a context manager: - >>> with TryExcept(msg="Error occurred in block", verbose=True): - >>> # Code block here - >>> pass - """ - - def __init__(self, msg="", verbose=True): - """Initialize TryExcept class with optional message and verbosity settings.""" - self.msg = msg - self.verbose = verbose - - def __enter__(self): - """Executes when entering TryExcept context, initializes instance.""" - pass - - def __exit__(self, exc_type, value, traceback): - """Defines behavior when exiting a 'with' block, prints error message if necessary.""" - if self.verbose and value: - print(emojis(f"{self.msg}{': ' if self.msg else ''}{value}")) - return True - - -class Retry(contextlib.ContextDecorator): - """ - Retry class for function execution with exponential backoff. - - Can be used as a decorator or a context manager to retry a function or block of code on exceptions, up to a - specified number of times with an exponentially increasing delay between retries. - - Examples: - Example usage as a decorator: - >>> @Retry(times=3, delay=2) - >>> def test_func(): - >>> # Replace with function logic that may raise exceptions - >>> return True - - Example usage as a context manager: - >>> with Retry(times=3, delay=2): - >>> # Replace with code block that may raise exceptions - >>> pass - """ - - def __init__(self, times=3, delay=2): - """Initialize Retry class with specified number of retries and delay.""" - self.times = times - self.delay = delay - self._attempts = 0 - - def __call__(self, func): - """Decorator implementation for Retry with exponential backoff.""" - - def wrapped_func(*args, **kwargs): - """Applies retries to the decorated function or method.""" - self._attempts = 0 - while self._attempts < self.times: - try: - return func(*args, **kwargs) - except Exception as e: - self._attempts += 1 - print(f"Retry {self._attempts}/{self.times} failed: {e}") - if self._attempts >= self.times: - raise e - time.sleep(self.delay * (2**self._attempts)) # exponential backoff delay - - return wrapped_func - - def __enter__(self): - """Enter the runtime context related to this object.""" - self._attempts = 0 - - def __exit__(self, exc_type, exc_value, traceback): - """Exit the runtime context related to this object with exponential backoff.""" - if exc_type is not None: - self._attempts += 1 - if self._attempts < self.times: - print(f"Retry {self._attempts}/{self.times} failed: {exc_value}") - time.sleep(self.delay * (2**self._attempts)) # exponential backoff delay - return True # Suppresses the exception and retries - return False # Re-raises the exception if retries are exhausted - - -def threaded(func): - """ - Multi-threads a target function by default and returns the thread or function result. - - Use as @threaded decorator. The function runs in a separate thread unless 'threaded=False' is passed. - """ - - def wrapper(*args, **kwargs): - """Multi-threads a given function based on 'threaded' kwarg and returns the thread or function result.""" - if kwargs.pop("threaded", True): # run in thread - thread = threading.Thread(target=func, args=args, kwargs=kwargs, daemon=True) - thread.start() - return thread - else: - return func(*args, **kwargs) - - return wrapper - - -def set_sentry(): - """ - Initialize the Sentry SDK for error tracking and reporting. Only used if sentry_sdk package is installed and - sync=True in settings. Run 'yolo settings' to see and update settings YAML file. - - Conditions required to send errors (ALL conditions must be met or no errors will be reported): - - sentry_sdk package is installed - - sync=True in YOLO settings - - pytest is not running - - running in a pip package installation - - running in a non-git directory - - running with rank -1 or 0 - - online environment - - CLI used to run package (checked with 'yolo' as the name of the main CLI command) - - The function also configures Sentry SDK to ignore KeyboardInterrupt and FileNotFoundError - exceptions and to exclude events with 'out of memory' in their exception message. - - Additionally, the function sets custom tags and user information for Sentry events. - """ - - def before_send(event, hint): - """ - Modify the event before sending it to Sentry based on specific exception types and messages. - - Args: - event (dict): The event dictionary containing information about the error. - hint (dict): A dictionary containing additional information about the error. - - Returns: - dict: The modified event or None if the event should not be sent to Sentry. - """ - if "exc_info" in hint: - exc_type, exc_value, tb = hint["exc_info"] - if exc_type in (KeyboardInterrupt, FileNotFoundError) or "out of memory" in str(exc_value): - return None # do not send event - - event["tags"] = { - "sys_argv": sys.argv[0], - "sys_argv_name": Path(sys.argv[0]).name, - "install": "git" if is_git_dir() else "pip" if is_pip_package() else "other", - "os": ENVIRONMENT, - } - return event - - if ( - SETTINGS["sync"] - and RANK in (-1, 0) - and Path(sys.argv[0]).name == "yolo" - and not TESTS_RUNNING - and ONLINE - and is_pip_package() - and not is_git_dir() - ): - # If sentry_sdk package is not installed then return and do not use Sentry - try: - import sentry_sdk # noqa - except ImportError: - return - - sentry_sdk.init( - dsn="https://5ff1556b71594bfea135ff0203a0d290@o4504521589325824.ingest.sentry.io/4504521592406016", - debug=False, - traces_sample_rate=1.0, - release=__version__, - environment="production", # 'dev' or 'production' - before_send=before_send, - ignore_errors=[KeyboardInterrupt, FileNotFoundError], - ) - sentry_sdk.set_user({"id": SETTINGS["uuid"]}) # SHA-256 anonymized UUID hash - - -class SettingsManager(dict): - """ - Manages Ultralytics settings stored in a YAML file. - - Args: - file (str | Path): Path to the Ultralytics settings YAML file. Default is USER_CONFIG_DIR / 'settings.yaml'. - version (str): Settings version. In case of local version mismatch, new default settings will be saved. - """ - - def __init__(self, file=SETTINGS_YAML, version="0.0.4"): - """Initialize the SettingsManager with default settings, load and validate current settings from the YAML - file. - """ - import copy - import hashlib - - from ultralytics.utils.checks import check_version - from ultralytics.utils.torch_utils import torch_distributed_zero_first - - git_dir = get_git_dir() - root = git_dir or Path() - datasets_root = (root.parent if git_dir and is_dir_writeable(root.parent) else root).resolve() - - self.file = Path(file) - self.version = version - self.defaults = { - "settings_version": version, - "datasets_dir": str(datasets_root / "datasets"), - "weights_dir": str(root / "weights"), - "runs_dir": str(root / "runs"), - "uuid": hashlib.sha256(str(uuid.getnode()).encode()).hexdigest(), - "sync": True, - "api_key": "", - "openai_api_key": "", - "clearml": True, # integrations - "comet": True, - "dvc": True, - "hub": True, - "mlflow": True, - "neptune": True, - "raytune": True, - "tensorboard": True, - "wandb": True, - } - - super().__init__(copy.deepcopy(self.defaults)) - - with torch_distributed_zero_first(RANK): - if not self.file.exists(): - self.save() - - self.load() - correct_keys = self.keys() == self.defaults.keys() - correct_types = all(type(a) is type(b) for a, b in zip(self.values(), self.defaults.values())) - correct_version = check_version(self["settings_version"], self.version) - help_msg = ( - f"\nView settings with 'yolo settings' or at '{self.file}'" - "\nUpdate settings with 'yolo settings key=value', i.e. 'yolo settings runs_dir=path/to/dir'. " - "For help see https://docs.ultralytics.com/quickstart/#ultralytics-settings." - ) - if not (correct_keys and correct_types and correct_version): - LOGGER.warning( - "WARNING ⚠️ Ultralytics settings reset to default values. This may be due to a possible problem " - f"with your settings or a recent ultralytics package update. {help_msg}" - ) - self.reset() - - if self.get("datasets_dir") == self.get("runs_dir"): - LOGGER.warning( - f"WARNING ⚠️ Ultralytics setting 'datasets_dir: {self.get('datasets_dir')}' " - f"must be different than 'runs_dir: {self.get('runs_dir')}'. " - f"Please change one to avoid possible issues during training. {help_msg}" - ) - - def load(self): - """Loads settings from the YAML file.""" - super().update(yaml_load(self.file)) - - def save(self): - """Saves the current settings to the YAML file.""" - yaml_save(self.file, dict(self)) - - def update(self, *args, **kwargs): - """Updates a setting value in the current settings.""" - super().update(*args, **kwargs) - self.save() - - def reset(self): - """Resets the settings to default and saves them.""" - self.clear() - self.update(self.defaults) - self.save() - - -def deprecation_warn(arg, new_arg, version=None): - """Issue a deprecation warning when a deprecated argument is used, suggesting an updated argument.""" - if not version: - version = float(__version__[:3]) + 0.2 # deprecate after 2nd major release - LOGGER.warning( - f"WARNING ⚠️ '{arg}' is deprecated and will be removed in 'ultralytics {version}' in the future. " - f"Please use '{new_arg}' instead." - ) - - -def clean_url(url): - """Strip auth from URL, i.e. https://url.com/file.txt?auth -> https://url.com/file.txt.""" - url = Path(url).as_posix().replace(":/", "://") # Pathlib turns :// -> :/, as_posix() for Windows - return urllib.parse.unquote(url).split("?")[0] # '%2F' to '/', split https://url.com/file.txt?auth - - -def url2file(url): - """Convert URL to filename, i.e. https://url.com/file.txt?auth -> file.txt.""" - return Path(clean_url(url)).name - - -# Run below code on utils init ------------------------------------------------------------------------------------ - -# Check first-install steps -PREFIX = colorstr("Ultralytics: ") -SETTINGS = SettingsManager() # initialize settings -DATASETS_DIR = Path(SETTINGS["datasets_dir"]) # global datasets directory -WEIGHTS_DIR = Path(SETTINGS["weights_dir"]) # global weights directory -RUNS_DIR = Path(SETTINGS["runs_dir"]) # global runs directory -ENVIRONMENT = ( - "Colab" - if is_colab() - else "Kaggle" - if is_kaggle() - else "Jupyter" - if is_jupyter() - else "Docker" - if is_docker() - else platform.system() -) -TESTS_RUNNING = is_pytest_running() or is_github_action_running() -set_sentry() - -# Apply monkey patches -from .patches import imread, imshow, imwrite, torch_save - -torch.save = torch_save -if WINDOWS: - # Apply cv2 patches for non-ASCII and non-UTF characters in image paths - cv2.imread, cv2.imwrite, cv2.imshow = imread, imwrite, imshow diff --git a/ultralytics-main/ultralytics/utils/autobatch.py b/ultralytics-main/ultralytics/utils/autobatch.py deleted file mode 100644 index daea14e..0000000 --- a/ultralytics-main/ultralytics/utils/autobatch.py +++ /dev/null @@ -1,88 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -"""Functions for estimating the best YOLO batch size to use a fraction of the available CUDA memory in PyTorch.""" - -from copy import deepcopy - -import numpy as np -import torch - -from ultralytics.utils import DEFAULT_CFG, LOGGER, colorstr -from ultralytics.utils.torch_utils import profile - - -def check_train_batch_size(model, imgsz=640, amp=True): - """ - Check YOLO training batch size using the autobatch() function. - - Args: - model (torch.nn.Module): YOLO model to check batch size for. - imgsz (int): Image size used for training. - amp (bool): If True, use automatic mixed precision (AMP) for training. - - Returns: - (int): Optimal batch size computed using the autobatch() function. - """ - - with torch.cuda.amp.autocast(amp): - return autobatch(deepcopy(model).train(), imgsz) # compute optimal batch size - - -def autobatch(model, imgsz=640, fraction=0.60, batch_size=DEFAULT_CFG.batch): - """ - Automatically estimate the best YOLO batch size to use a fraction of the available CUDA memory. - - Args: - model (torch.nn.module): YOLO model to compute batch size for. - imgsz (int, optional): The image size used as input for the YOLO model. Defaults to 640. - fraction (float, optional): The fraction of available CUDA memory to use. Defaults to 0.60. - batch_size (int, optional): The default batch size to use if an error is detected. Defaults to 16. - - Returns: - (int): The optimal batch size. - """ - - # Check device - prefix = colorstr("AutoBatch: ") - LOGGER.info(f"{prefix}Computing optimal batch size for imgsz={imgsz}") - device = next(model.parameters()).device # get model device - if device.type == "cpu": - LOGGER.info(f"{prefix}CUDA not detected, using default CPU batch-size {batch_size}") - return batch_size - if torch.backends.cudnn.benchmark: - LOGGER.info(f"{prefix} ⚠️ Requires torch.backends.cudnn.benchmark=False, using default batch-size {batch_size}") - return batch_size - - # Inspect CUDA memory - gb = 1 << 30 # bytes to GiB (1024 ** 3) - d = str(device).upper() # 'CUDA:0' - properties = torch.cuda.get_device_properties(device) # device properties - t = properties.total_memory / gb # GiB total - r = torch.cuda.memory_reserved(device) / gb # GiB reserved - a = torch.cuda.memory_allocated(device) / gb # GiB allocated - f = t - (r + a) # GiB free - LOGGER.info(f"{prefix}{d} ({properties.name}) {t:.2f}G total, {r:.2f}G reserved, {a:.2f}G allocated, {f:.2f}G free") - - # Profile batch sizes - batch_sizes = [1, 2, 4, 8, 16] - try: - img = [torch.empty(b, 3, imgsz, imgsz) for b in batch_sizes] - results = profile(img, model, n=3, device=device) - - # Fit a solution - y = [x[2] for x in results if x] # memory [2] - p = np.polyfit(batch_sizes[: len(y)], y, deg=1) # first degree polynomial fit - b = int((f * fraction - p[1]) / p[0]) # y intercept (optimal batch size) - if None in results: # some sizes failed - i = results.index(None) # first fail index - if b >= batch_sizes[i]: # y intercept above failure point - b = batch_sizes[max(i - 1, 0)] # select prior safe point - if b < 1 or b > 1024: # b outside of safe range - b = batch_size - LOGGER.info(f"{prefix}WARNING ⚠️ CUDA anomaly detected, using default batch-size {batch_size}.") - - fraction = (np.polyval(p, b) + r + a) / t # actual fraction predicted - LOGGER.info(f"{prefix}Using batch-size {b} for {d} {t * fraction:.2f}G/{t:.2f}G ({fraction * 100:.0f}%) ✅") - return b - except Exception as e: - LOGGER.warning(f"{prefix}WARNING ⚠️ error detected: {e}, using default batch-size {batch_size}.") - return batch_size diff --git a/ultralytics-main/ultralytics/utils/benchmarks.py b/ultralytics-main/ultralytics/utils/benchmarks.py deleted file mode 100644 index 3bc6351..0000000 --- a/ultralytics-main/ultralytics/utils/benchmarks.py +++ /dev/null @@ -1,402 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -""" -Benchmark a YOLO model formats for speed and accuracy. - -Usage: - from ultralytics.utils.benchmarks import ProfileModels, benchmark - ProfileModels(['yolov8n.yaml', 'yolov8s.yaml']).profile() - benchmark(model='yolov8n.pt', imgsz=160) - -Format | `format=argument` | Model ---- | --- | --- -PyTorch | - | yolov8n.pt -TorchScript | `torchscript` | yolov8n.torchscript -ONNX | `onnx` | yolov8n.onnx -OpenVINO | `openvino` | yolov8n_openvino_model/ -TensorRT | `engine` | yolov8n.engine -CoreML | `coreml` | yolov8n.mlpackage -TensorFlow SavedModel | `saved_model` | yolov8n_saved_model/ -TensorFlow GraphDef | `pb` | yolov8n.pb -TensorFlow Lite | `tflite` | yolov8n.tflite -TensorFlow Edge TPU | `edgetpu` | yolov8n_edgetpu.tflite -TensorFlow.js | `tfjs` | yolov8n_web_model/ -PaddlePaddle | `paddle` | yolov8n_paddle_model/ -NCNN | `ncnn` | yolov8n_ncnn_model/ -""" - -import glob -import platform -import time -from pathlib import Path - -import numpy as np -import torch.cuda - -from ultralytics import YOLO, YOLOWorld -from ultralytics.cfg import TASK2DATA, TASK2METRIC -from ultralytics.engine.exporter import export_formats -from ultralytics.utils import ASSETS, LINUX, LOGGER, MACOS, TQDM, WEIGHTS_DIR -from ultralytics.utils.checks import IS_PYTHON_3_12, check_requirements, check_yolo -from ultralytics.utils.files import file_size -from ultralytics.utils.torch_utils import select_device - - -def benchmark( - model=WEIGHTS_DIR / "yolov8n.pt", data=None, imgsz=160, half=False, int8=False, device="cpu", verbose=False -): - """ - Benchmark a YOLO model across different formats for speed and accuracy. - - Args: - model (str | Path | optional): Path to the model file or directory. Default is - Path(SETTINGS['weights_dir']) / 'yolov8n.pt'. - data (str, optional): Dataset to evaluate on, inherited from TASK2DATA if not passed. Default is None. - imgsz (int, optional): Image size for the benchmark. Default is 160. - half (bool, optional): Use half-precision for the model if True. Default is False. - int8 (bool, optional): Use int8-precision for the model if True. Default is False. - device (str, optional): Device to run the benchmark on, either 'cpu' or 'cuda'. Default is 'cpu'. - verbose (bool | float | optional): If True or a float, assert benchmarks pass with given metric. - Default is False. - - Returns: - df (pandas.DataFrame): A pandas DataFrame with benchmark results for each format, including file size, - metric, and inference time. - - Example: - ```python - from ultralytics.utils.benchmarks import benchmark - - benchmark(model='yolov8n.pt', imgsz=640) - ``` - """ - - import pandas as pd - - pd.options.display.max_columns = 10 - pd.options.display.width = 120 - device = select_device(device, verbose=False) - if isinstance(model, (str, Path)): - model = YOLO(model) - - y = [] - t0 = time.time() - for i, (name, format, suffix, cpu, gpu) in export_formats().iterrows(): # index, (name, format, suffix, CPU, GPU) - emoji, filename = "❌", None # export defaults - try: - # Checks - if i == 9: # Edge TPU - assert LINUX, "Edge TPU export only supported on Linux" - elif i == 7: # TF GraphDef - assert model.task != "obb", "TensorFlow GraphDef not supported for OBB task" - elif i in {5, 10}: # CoreML and TF.js - assert MACOS or LINUX, "export only supported on macOS and Linux" - if i in {3, 5}: # CoreML and OpenVINO - assert not IS_PYTHON_3_12, "CoreML and OpenVINO not supported on Python 3.12" - if i in {6, 7, 8, 9, 10}: # All TF formats - assert not isinstance(model, YOLOWorld), "YOLOWorldv2 TensorFlow exports not supported by onnx2tf yet" - if i in {11}: # Paddle - assert not isinstance(model, YOLOWorld), "YOLOWorldv2 Paddle exports not supported yet" - if i in {12}: # NCNN - assert not isinstance(model, YOLOWorld), "YOLOWorldv2 NCNN exports not supported yet" - if "cpu" in device.type: - assert cpu, "inference not supported on CPU" - if "cuda" in device.type: - assert gpu, "inference not supported on GPU" - - # Export - if format == "-": - filename = model.ckpt_path or model.cfg - exported_model = model # PyTorch format - else: - filename = model.export(imgsz=imgsz, format=format, half=half, int8=int8, device=device, verbose=False) - exported_model = YOLO(filename, task=model.task) - assert suffix in str(filename), "export failed" - emoji = "❎" # indicates export succeeded - - # Predict - assert model.task != "pose" or i != 7, "GraphDef Pose inference is not supported" - assert i not in (9, 10), "inference not supported" # Edge TPU and TF.js are unsupported - assert i != 5 or platform.system() == "Darwin", "inference only supported on macOS>=10.13" # CoreML - exported_model.predict(ASSETS / "bus.jpg", imgsz=imgsz, device=device, half=half) - - # Validate - data = data or TASK2DATA[model.task] # task to dataset, i.e. coco8.yaml for task=detect - key = TASK2METRIC[model.task] # task to metric, i.e. metrics/mAP50-95(B) for task=detect - results = exported_model.val( - data=data, batch=1, imgsz=imgsz, plots=False, device=device, half=half, int8=int8, verbose=False - ) - metric, speed = results.results_dict[key], results.speed["inference"] - y.append([name, "✅", round(file_size(filename), 1), round(metric, 4), round(speed, 2)]) - except Exception as e: - if verbose: - assert type(e) is AssertionError, f"Benchmark failure for {name}: {e}" - LOGGER.warning(f"ERROR ❌️ Benchmark failure for {name}: {e}") - y.append([name, emoji, round(file_size(filename), 1), None, None]) # mAP, t_inference - - # Print results - check_yolo(device=device) # print system info - df = pd.DataFrame(y, columns=["Format", "Status❔", "Size (MB)", key, "Inference time (ms/im)"]) - - name = Path(model.ckpt_path).name - s = f"\nBenchmarks complete for {name} on {data} at imgsz={imgsz} ({time.time() - t0:.2f}s)\n{df}\n" - LOGGER.info(s) - with open("benchmarks.log", "a", errors="ignore", encoding="utf-8") as f: - f.write(s) - - if verbose and isinstance(verbose, float): - metrics = df[key].array # values to compare to floor - floor = verbose # minimum metric floor to pass, i.e. = 0.29 mAP for YOLOv5n - assert all(x > floor for x in metrics if pd.notna(x)), f"Benchmark failure: metric(s) < floor {floor}" - - return df - - -class ProfileModels: - """ - ProfileModels class for profiling different models on ONNX and TensorRT. - - This class profiles the performance of different models, returning results such as model speed and FLOPs. - - Attributes: - paths (list): Paths of the models to profile. - num_timed_runs (int): Number of timed runs for the profiling. Default is 100. - num_warmup_runs (int): Number of warmup runs before profiling. Default is 10. - min_time (float): Minimum number of seconds to profile for. Default is 60. - imgsz (int): Image size used in the models. Default is 640. - - Methods: - profile(): Profiles the models and prints the result. - - Example: - ```python - from ultralytics.utils.benchmarks import ProfileModels - - ProfileModels(['yolov8n.yaml', 'yolov8s.yaml'], imgsz=640).profile() - ``` - """ - - def __init__( - self, - paths: list, - num_timed_runs=100, - num_warmup_runs=10, - min_time=60, - imgsz=640, - half=True, - trt=True, - device=None, - ): - """ - Initialize the ProfileModels class for profiling models. - - Args: - paths (list): List of paths of the models to be profiled. - num_timed_runs (int, optional): Number of timed runs for the profiling. Default is 100. - num_warmup_runs (int, optional): Number of warmup runs before the actual profiling starts. Default is 10. - min_time (float, optional): Minimum time in seconds for profiling a model. Default is 60. - imgsz (int, optional): Size of the image used during profiling. Default is 640. - half (bool, optional): Flag to indicate whether to use half-precision floating point for profiling. - trt (bool, optional): Flag to indicate whether to profile using TensorRT. Default is True. - device (torch.device, optional): Device used for profiling. If None, it is determined automatically. - """ - self.paths = paths - self.num_timed_runs = num_timed_runs - self.num_warmup_runs = num_warmup_runs - self.min_time = min_time - self.imgsz = imgsz - self.half = half - self.trt = trt # run TensorRT profiling - self.device = device or torch.device(0 if torch.cuda.is_available() else "cpu") - - def profile(self): - """Logs the benchmarking results of a model, checks metrics against floor and returns the results.""" - files = self.get_files() - - if not files: - print("No matching *.pt or *.onnx files found.") - return - - table_rows = [] - output = [] - for file in files: - engine_file = file.with_suffix(".engine") - if file.suffix in (".pt", ".yaml", ".yml"): - model = YOLO(str(file)) - model.fuse() # to report correct params and GFLOPs in model.info() - model_info = model.info() - if self.trt and self.device.type != "cpu" and not engine_file.is_file(): - engine_file = model.export( - format="engine", half=self.half, imgsz=self.imgsz, device=self.device, verbose=False - ) - onnx_file = model.export( - format="onnx", half=self.half, imgsz=self.imgsz, simplify=True, device=self.device, verbose=False - ) - elif file.suffix == ".onnx": - model_info = self.get_onnx_model_info(file) - onnx_file = file - else: - continue - - t_engine = self.profile_tensorrt_model(str(engine_file)) - t_onnx = self.profile_onnx_model(str(onnx_file)) - table_rows.append(self.generate_table_row(file.stem, t_onnx, t_engine, model_info)) - output.append(self.generate_results_dict(file.stem, t_onnx, t_engine, model_info)) - - self.print_table(table_rows) - return output - - def get_files(self): - """Returns a list of paths for all relevant model files given by the user.""" - files = [] - for path in self.paths: - path = Path(path) - if path.is_dir(): - extensions = ["*.pt", "*.onnx", "*.yaml"] - files.extend([file for ext in extensions for file in glob.glob(str(path / ext))]) - elif path.suffix in {".pt", ".yaml", ".yml"}: # add non-existing - files.append(str(path)) - else: - files.extend(glob.glob(str(path))) - - print(f"Profiling: {sorted(files)}") - return [Path(file) for file in sorted(files)] - - def get_onnx_model_info(self, onnx_file: str): - """Retrieves the information including number of layers, parameters, gradients and FLOPs for an ONNX model - file. - """ - return 0.0, 0.0, 0.0, 0.0 # return (num_layers, num_params, num_gradients, num_flops) - - @staticmethod - def iterative_sigma_clipping(data, sigma=2, max_iters=3): - """Applies an iterative sigma clipping algorithm to the given data times number of iterations.""" - data = np.array(data) - for _ in range(max_iters): - mean, std = np.mean(data), np.std(data) - clipped_data = data[(data > mean - sigma * std) & (data < mean + sigma * std)] - if len(clipped_data) == len(data): - break - data = clipped_data - return data - - def profile_tensorrt_model(self, engine_file: str, eps: float = 1e-3): - """Profiles the TensorRT model, measuring average run time and standard deviation among runs.""" - if not self.trt or not Path(engine_file).is_file(): - return 0.0, 0.0 - - # Model and input - model = YOLO(engine_file) - input_data = np.random.rand(self.imgsz, self.imgsz, 3).astype(np.float32) # must be FP32 - - # Warmup runs - elapsed = 0.0 - for _ in range(3): - start_time = time.time() - for _ in range(self.num_warmup_runs): - model(input_data, imgsz=self.imgsz, verbose=False) - elapsed = time.time() - start_time - - # Compute number of runs as higher of min_time or num_timed_runs - num_runs = max(round(self.min_time / (elapsed + eps) * self.num_warmup_runs), self.num_timed_runs * 50) - - # Timed runs - run_times = [] - for _ in TQDM(range(num_runs), desc=engine_file): - results = model(input_data, imgsz=self.imgsz, verbose=False) - run_times.append(results[0].speed["inference"]) # Convert to milliseconds - - run_times = self.iterative_sigma_clipping(np.array(run_times), sigma=2, max_iters=3) # sigma clipping - return np.mean(run_times), np.std(run_times) - - def profile_onnx_model(self, onnx_file: str, eps: float = 1e-3): - """Profiles an ONNX model by executing it multiple times and returns the mean and standard deviation of run - times. - """ - check_requirements("onnxruntime") - import onnxruntime as ort - - # Session with either 'TensorrtExecutionProvider', 'CUDAExecutionProvider', 'CPUExecutionProvider' - sess_options = ort.SessionOptions() - sess_options.graph_optimization_level = ort.GraphOptimizationLevel.ORT_ENABLE_ALL - sess_options.intra_op_num_threads = 8 # Limit the number of threads - sess = ort.InferenceSession(onnx_file, sess_options, providers=["CPUExecutionProvider"]) - - input_tensor = sess.get_inputs()[0] - input_type = input_tensor.type - - # Mapping ONNX datatype to numpy datatype - if "float16" in input_type: - input_dtype = np.float16 - elif "float" in input_type: - input_dtype = np.float32 - elif "double" in input_type: - input_dtype = np.float64 - elif "int64" in input_type: - input_dtype = np.int64 - elif "int32" in input_type: - input_dtype = np.int32 - else: - raise ValueError(f"Unsupported ONNX datatype {input_type}") - - input_data = np.random.rand(*input_tensor.shape).astype(input_dtype) - input_name = input_tensor.name - output_name = sess.get_outputs()[0].name - - # Warmup runs - elapsed = 0.0 - for _ in range(3): - start_time = time.time() - for _ in range(self.num_warmup_runs): - sess.run([output_name], {input_name: input_data}) - elapsed = time.time() - start_time - - # Compute number of runs as higher of min_time or num_timed_runs - num_runs = max(round(self.min_time / (elapsed + eps) * self.num_warmup_runs), self.num_timed_runs) - - # Timed runs - run_times = [] - for _ in TQDM(range(num_runs), desc=onnx_file): - start_time = time.time() - sess.run([output_name], {input_name: input_data}) - run_times.append((time.time() - start_time) * 1000) # Convert to milliseconds - - run_times = self.iterative_sigma_clipping(np.array(run_times), sigma=2, max_iters=5) # sigma clipping - return np.mean(run_times), np.std(run_times) - - def generate_table_row(self, model_name, t_onnx, t_engine, model_info): - """Generates a formatted string for a table row that includes model performance and metric details.""" - layers, params, gradients, flops = model_info - return ( - f"| {model_name:18s} | {self.imgsz} | - | {t_onnx[0]:.2f} ± {t_onnx[1]:.2f} ms | {t_engine[0]:.2f} ± " - f"{t_engine[1]:.2f} ms | {params / 1e6:.1f} | {flops:.1f} |" - ) - - @staticmethod - def generate_results_dict(model_name, t_onnx, t_engine, model_info): - """Generates a dictionary of model details including name, parameters, GFLOPS and speed metrics.""" - layers, params, gradients, flops = model_info - return { - "model/name": model_name, - "model/parameters": params, - "model/GFLOPs": round(flops, 3), - "model/speed_ONNX(ms)": round(t_onnx[0], 3), - "model/speed_TensorRT(ms)": round(t_engine[0], 3), - } - - @staticmethod - def print_table(table_rows): - """Formats and prints a comparison table for different models with given statistics and performance data.""" - gpu = torch.cuda.get_device_name(0) if torch.cuda.is_available() else "GPU" - header = ( - f"| Model | size
(pixels) | mAPval
50-95 | Speed
CPU ONNX
(ms) | " - f"Speed
{gpu} TensorRT
(ms) | params
(M) | FLOPs
(B) |" - ) - separator = ( - "|-------------|---------------------|--------------------|------------------------------|" - "-----------------------------------|------------------|-----------------|" - ) - - print(f"\n\n{header}") - print(separator) - for row in table_rows: - print(row) diff --git a/ultralytics-main/ultralytics/utils/callbacks/__init__.py b/ultralytics-main/ultralytics/utils/callbacks/__init__.py deleted file mode 100644 index 116babe..0000000 --- a/ultralytics-main/ultralytics/utils/callbacks/__init__.py +++ /dev/null @@ -1,5 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from .base import add_integration_callbacks, default_callbacks, get_default_callbacks - -__all__ = "add_integration_callbacks", "default_callbacks", "get_default_callbacks" diff --git a/ultralytics-main/ultralytics/utils/callbacks/base.py b/ultralytics-main/ultralytics/utils/callbacks/base.py deleted file mode 100644 index d015457..0000000 --- a/ultralytics-main/ultralytics/utils/callbacks/base.py +++ /dev/null @@ -1,219 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -"""Base callbacks.""" - -from collections import defaultdict -from copy import deepcopy - - -# Trainer callbacks ---------------------------------------------------------------------------------------------------- - - -def on_pretrain_routine_start(trainer): - """Called before the pretraining routine starts.""" - pass - - -def on_pretrain_routine_end(trainer): - """Called after the pretraining routine ends.""" - pass - - -def on_train_start(trainer): - """Called when the training starts.""" - pass - - -def on_train_epoch_start(trainer): - """Called at the start of each training epoch.""" - pass - - -def on_train_batch_start(trainer): - """Called at the start of each training batch.""" - pass - - -def optimizer_step(trainer): - """Called when the optimizer takes a step.""" - pass - - -def on_before_zero_grad(trainer): - """Called before the gradients are set to zero.""" - pass - - -def on_train_batch_end(trainer): - """Called at the end of each training batch.""" - pass - - -def on_train_epoch_end(trainer): - """Called at the end of each training epoch.""" - pass - - -def on_fit_epoch_end(trainer): - """Called at the end of each fit epoch (train + val).""" - pass - - -def on_model_save(trainer): - """Called when the model is saved.""" - pass - - -def on_train_end(trainer): - """Called when the training ends.""" - pass - - -def on_params_update(trainer): - """Called when the model parameters are updated.""" - pass - - -def teardown(trainer): - """Called during the teardown of the training process.""" - pass - - -# Validator callbacks -------------------------------------------------------------------------------------------------- - - -def on_val_start(validator): - """Called when the validation starts.""" - pass - - -def on_val_batch_start(validator): - """Called at the start of each validation batch.""" - pass - - -def on_val_batch_end(validator): - """Called at the end of each validation batch.""" - pass - - -def on_val_end(validator): - """Called when the validation ends.""" - pass - - -# Predictor callbacks -------------------------------------------------------------------------------------------------- - - -def on_predict_start(predictor): - """Called when the prediction starts.""" - pass - - -def on_predict_batch_start(predictor): - """Called at the start of each prediction batch.""" - pass - - -def on_predict_batch_end(predictor): - """Called at the end of each prediction batch.""" - pass - - -def on_predict_postprocess_end(predictor): - """Called after the post-processing of the prediction ends.""" - pass - - -def on_predict_end(predictor): - """Called when the prediction ends.""" - pass - - -# Exporter callbacks --------------------------------------------------------------------------------------------------- - - -def on_export_start(exporter): - """Called when the model export starts.""" - pass - - -def on_export_end(exporter): - """Called when the model export ends.""" - pass - - -default_callbacks = { - # Run in trainer - "on_pretrain_routine_start": [on_pretrain_routine_start], - "on_pretrain_routine_end": [on_pretrain_routine_end], - "on_train_start": [on_train_start], - "on_train_epoch_start": [on_train_epoch_start], - "on_train_batch_start": [on_train_batch_start], - "optimizer_step": [optimizer_step], - "on_before_zero_grad": [on_before_zero_grad], - "on_train_batch_end": [on_train_batch_end], - "on_train_epoch_end": [on_train_epoch_end], - "on_fit_epoch_end": [on_fit_epoch_end], # fit = train + val - "on_model_save": [on_model_save], - "on_train_end": [on_train_end], - "on_params_update": [on_params_update], - "teardown": [teardown], - # Run in validator - "on_val_start": [on_val_start], - "on_val_batch_start": [on_val_batch_start], - "on_val_batch_end": [on_val_batch_end], - "on_val_end": [on_val_end], - # Run in predictor - "on_predict_start": [on_predict_start], - "on_predict_batch_start": [on_predict_batch_start], - "on_predict_postprocess_end": [on_predict_postprocess_end], - "on_predict_batch_end": [on_predict_batch_end], - "on_predict_end": [on_predict_end], - # Run in exporter - "on_export_start": [on_export_start], - "on_export_end": [on_export_end], -} - - -def get_default_callbacks(): - """ - Return a copy of the default_callbacks dictionary with lists as default values. - - Returns: - (defaultdict): A defaultdict with keys from default_callbacks and empty lists as default values. - """ - return defaultdict(list, deepcopy(default_callbacks)) - - -def add_integration_callbacks(instance): - """ - Add integration callbacks from various sources to the instance's callbacks. - - Args: - instance (Trainer, Predictor, Validator, Exporter): An object with a 'callbacks' attribute that is a dictionary - of callback lists. - """ - - # Load HUB callbacks - from .hub import callbacks as hub_cb - - callbacks_list = [hub_cb] - - # Load training callbacks - if "Trainer" in instance.__class__.__name__: - from .clearml import callbacks as clear_cb - from .comet import callbacks as comet_cb - from .dvc import callbacks as dvc_cb - from .mlflow import callbacks as mlflow_cb - from .neptune import callbacks as neptune_cb - from .raytune import callbacks as tune_cb - from .tensorboard import callbacks as tb_cb - from .wb import callbacks as wb_cb - - callbacks_list.extend([clear_cb, comet_cb, dvc_cb, mlflow_cb, neptune_cb, tune_cb, tb_cb, wb_cb]) - - # Add the callbacks to the callbacks dictionary - for callbacks in callbacks_list: - for k, v in callbacks.items(): - if v not in instance.callbacks[k]: - instance.callbacks[k].append(v) diff --git a/ultralytics-main/ultralytics/utils/callbacks/clearml.py b/ultralytics-main/ultralytics/utils/callbacks/clearml.py deleted file mode 100644 index a030fc5..0000000 --- a/ultralytics-main/ultralytics/utils/callbacks/clearml.py +++ /dev/null @@ -1,152 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from ultralytics.utils import LOGGER, SETTINGS, TESTS_RUNNING - -try: - assert not TESTS_RUNNING # do not log pytest - assert SETTINGS["clearml"] is True # verify integration is enabled - import clearml - from clearml import Task - from clearml.binding.frameworks.pytorch_bind import PatchPyTorchModelIO - from clearml.binding.matplotlib_bind import PatchedMatplotlib - - assert hasattr(clearml, "__version__") # verify package is not directory - -except (ImportError, AssertionError): - clearml = None - - -def _log_debug_samples(files, title="Debug Samples") -> None: - """ - Log files (images) as debug samples in the ClearML task. - - Args: - files (list): A list of file paths in PosixPath format. - title (str): A title that groups together images with the same values. - """ - import re - - if task := Task.current_task(): - for f in files: - if f.exists(): - it = re.search(r"_batch(\d+)", f.name) - iteration = int(it.groups()[0]) if it else 0 - task.get_logger().report_image( - title=title, series=f.name.replace(it.group(), ""), local_path=str(f), iteration=iteration - ) - - -def _log_plot(title, plot_path) -> None: - """ - Log an image as a plot in the plot section of ClearML. - - Args: - title (str): The title of the plot. - plot_path (str): The path to the saved image file. - """ - import matplotlib.image as mpimg - import matplotlib.pyplot as plt - - img = mpimg.imread(plot_path) - fig = plt.figure() - ax = fig.add_axes([0, 0, 1, 1], frameon=False, aspect="auto", xticks=[], yticks=[]) # no ticks - ax.imshow(img) - - Task.current_task().get_logger().report_matplotlib_figure( - title=title, series="", figure=fig, report_interactive=False - ) - - -def on_pretrain_routine_start(trainer): - """Runs at start of pretraining routine; initializes and connects/ logs task to ClearML.""" - try: - if task := Task.current_task(): - # Make sure the automatic pytorch and matplotlib bindings are disabled! - # We are logging these plots and model files manually in the integration - PatchPyTorchModelIO.update_current_task(None) - PatchedMatplotlib.update_current_task(None) - else: - task = Task.init( - project_name=trainer.args.project or "YOLOv8", - task_name=trainer.args.name, - tags=["YOLOv8"], - output_uri=True, - reuse_last_task_id=False, - auto_connect_frameworks={"pytorch": False, "matplotlib": False}, - ) - LOGGER.warning( - "ClearML Initialized a new task. If you want to run remotely, " - "please add clearml-init and connect your arguments before initializing YOLO." - ) - task.connect(vars(trainer.args), name="General") - except Exception as e: - LOGGER.warning(f"WARNING ⚠️ ClearML installed but not initialized correctly, not logging this run. {e}") - - -def on_train_epoch_end(trainer): - """Logs debug samples for the first epoch of YOLO training and report current training progress.""" - if task := Task.current_task(): - # Log debug samples - if trainer.epoch == 1: - _log_debug_samples(sorted(trainer.save_dir.glob("train_batch*.jpg")), "Mosaic") - # Report the current training progress - for k, v in trainer.label_loss_items(trainer.tloss, prefix="train").items(): - task.get_logger().report_scalar("train", k, v, iteration=trainer.epoch) - for k, v in trainer.lr.items(): - task.get_logger().report_scalar("lr", k, v, iteration=trainer.epoch) - - -def on_fit_epoch_end(trainer): - """Reports model information to logger at the end of an epoch.""" - if task := Task.current_task(): - # You should have access to the validation bboxes under jdict - task.get_logger().report_scalar( - title="Epoch Time", series="Epoch Time", value=trainer.epoch_time, iteration=trainer.epoch - ) - for k, v in trainer.metrics.items(): - task.get_logger().report_scalar("val", k, v, iteration=trainer.epoch) - if trainer.epoch == 0: - from ultralytics.utils.torch_utils import model_info_for_loggers - - for k, v in model_info_for_loggers(trainer).items(): - task.get_logger().report_single_value(k, v) - - -def on_val_end(validator): - """Logs validation results including labels and predictions.""" - if Task.current_task(): - # Log val_labels and val_pred - _log_debug_samples(sorted(validator.save_dir.glob("val*.jpg")), "Validation") - - -def on_train_end(trainer): - """Logs final model and its name on training completion.""" - if task := Task.current_task(): - # Log final results, CM matrix + PR plots - files = [ - "results.png", - "confusion_matrix.png", - "confusion_matrix_normalized.png", - *(f"{x}_curve.png" for x in ("F1", "PR", "P", "R")), - ] - files = [(trainer.save_dir / f) for f in files if (trainer.save_dir / f).exists()] # filter - for f in files: - _log_plot(title=f.stem, plot_path=f) - # Report final metrics - for k, v in trainer.validator.metrics.results_dict.items(): - task.get_logger().report_single_value(k, v) - # Log the final model - task.update_output_model(model_path=str(trainer.best), model_name=trainer.args.name, auto_delete_file=False) - - -callbacks = ( - { - "on_pretrain_routine_start": on_pretrain_routine_start, - "on_train_epoch_end": on_train_epoch_end, - "on_fit_epoch_end": on_fit_epoch_end, - "on_val_end": on_val_end, - "on_train_end": on_train_end, - } - if clearml - else {} -) diff --git a/ultralytics-main/ultralytics/utils/callbacks/comet.py b/ultralytics-main/ultralytics/utils/callbacks/comet.py deleted file mode 100644 index 1c5f585..0000000 --- a/ultralytics-main/ultralytics/utils/callbacks/comet.py +++ /dev/null @@ -1,375 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from ultralytics.utils import LOGGER, RANK, SETTINGS, TESTS_RUNNING, ops - -try: - assert not TESTS_RUNNING # do not log pytest - assert SETTINGS["comet"] is True # verify integration is enabled - import comet_ml - - assert hasattr(comet_ml, "__version__") # verify package is not directory - - import os - from pathlib import Path - - # Ensures certain logging functions only run for supported tasks - COMET_SUPPORTED_TASKS = ["detect"] - - # Names of plots created by YOLOv8 that are logged to Comet - EVALUATION_PLOT_NAMES = "F1_curve", "P_curve", "R_curve", "PR_curve", "confusion_matrix" - LABEL_PLOT_NAMES = "labels", "labels_correlogram" - - _comet_image_prediction_count = 0 - -except (ImportError, AssertionError): - comet_ml = None - - -def _get_comet_mode(): - """Returns the mode of comet set in the environment variables, defaults to 'online' if not set.""" - return os.getenv("COMET_MODE", "online") - - -def _get_comet_model_name(): - """Returns the model name for Comet from the environment variable 'COMET_MODEL_NAME' or defaults to 'YOLOv8'.""" - return os.getenv("COMET_MODEL_NAME", "YOLOv8") - - -def _get_eval_batch_logging_interval(): - """Get the evaluation batch logging interval from environment variable or use default value 1.""" - return int(os.getenv("COMET_EVAL_BATCH_LOGGING_INTERVAL", 1)) - - -def _get_max_image_predictions_to_log(): - """Get the maximum number of image predictions to log from the environment variables.""" - return int(os.getenv("COMET_MAX_IMAGE_PREDICTIONS", 100)) - - -def _scale_confidence_score(score): - """Scales the given confidence score by a factor specified in an environment variable.""" - scale = float(os.getenv("COMET_MAX_CONFIDENCE_SCORE", 100.0)) - return score * scale - - -def _should_log_confusion_matrix(): - """Determines if the confusion matrix should be logged based on the environment variable settings.""" - return os.getenv("COMET_EVAL_LOG_CONFUSION_MATRIX", "false").lower() == "true" - - -def _should_log_image_predictions(): - """Determines whether to log image predictions based on a specified environment variable.""" - return os.getenv("COMET_EVAL_LOG_IMAGE_PREDICTIONS", "true").lower() == "true" - - -def _get_experiment_type(mode, project_name): - """Return an experiment based on mode and project name.""" - if mode == "offline": - return comet_ml.OfflineExperiment(project_name=project_name) - - return comet_ml.Experiment(project_name=project_name) - - -def _create_experiment(args): - """Ensures that the experiment object is only created in a single process during distributed training.""" - if RANK not in (-1, 0): - return - try: - comet_mode = _get_comet_mode() - _project_name = os.getenv("COMET_PROJECT_NAME", args.project) - experiment = _get_experiment_type(comet_mode, _project_name) - experiment.log_parameters(vars(args)) - experiment.log_others( - { - "eval_batch_logging_interval": _get_eval_batch_logging_interval(), - "log_confusion_matrix_on_eval": _should_log_confusion_matrix(), - "log_image_predictions": _should_log_image_predictions(), - "max_image_predictions": _get_max_image_predictions_to_log(), - } - ) - experiment.log_other("Created from", "yolov8") - - except Exception as e: - LOGGER.warning(f"WARNING ⚠️ Comet installed but not initialized correctly, not logging this run. {e}") - - -def _fetch_trainer_metadata(trainer): - """Returns metadata for YOLO training including epoch and asset saving status.""" - curr_epoch = trainer.epoch + 1 - - train_num_steps_per_epoch = len(trainer.train_loader.dataset) // trainer.batch_size - curr_step = curr_epoch * train_num_steps_per_epoch - final_epoch = curr_epoch == trainer.epochs - - save = trainer.args.save - save_period = trainer.args.save_period - save_interval = curr_epoch % save_period == 0 - save_assets = save and save_period > 0 and save_interval and not final_epoch - - return dict(curr_epoch=curr_epoch, curr_step=curr_step, save_assets=save_assets, final_epoch=final_epoch) - - -def _scale_bounding_box_to_original_image_shape(box, resized_image_shape, original_image_shape, ratio_pad): - """ - YOLOv8 resizes images during training and the label values are normalized based on this resized shape. - - This function rescales the bounding box labels to the original image shape. - """ - - resized_image_height, resized_image_width = resized_image_shape - - # Convert normalized xywh format predictions to xyxy in resized scale format - box = ops.xywhn2xyxy(box, h=resized_image_height, w=resized_image_width) - # Scale box predictions from resized image scale back to original image scale - box = ops.scale_boxes(resized_image_shape, box, original_image_shape, ratio_pad) - # Convert bounding box format from xyxy to xywh for Comet logging - box = ops.xyxy2xywh(box) - # Adjust xy center to correspond top-left corner - box[:2] -= box[2:] / 2 - box = box.tolist() - - return box - - -def _format_ground_truth_annotations_for_detection(img_idx, image_path, batch, class_name_map=None): - """Format ground truth annotations for detection.""" - indices = batch["batch_idx"] == img_idx - bboxes = batch["bboxes"][indices] - if len(bboxes) == 0: - LOGGER.debug(f"COMET WARNING: Image: {image_path} has no bounding boxes labels") - return None - - cls_labels = batch["cls"][indices].squeeze(1).tolist() - if class_name_map: - cls_labels = [str(class_name_map[label]) for label in cls_labels] - - original_image_shape = batch["ori_shape"][img_idx] - resized_image_shape = batch["resized_shape"][img_idx] - ratio_pad = batch["ratio_pad"][img_idx] - - data = [] - for box, label in zip(bboxes, cls_labels): - box = _scale_bounding_box_to_original_image_shape(box, resized_image_shape, original_image_shape, ratio_pad) - data.append( - { - "boxes": [box], - "label": f"gt_{label}", - "score": _scale_confidence_score(1.0), - } - ) - - return {"name": "ground_truth", "data": data} - - -def _format_prediction_annotations_for_detection(image_path, metadata, class_label_map=None): - """Format YOLO predictions for object detection visualization.""" - stem = image_path.stem - image_id = int(stem) if stem.isnumeric() else stem - - predictions = metadata.get(image_id) - if not predictions: - LOGGER.debug(f"COMET WARNING: Image: {image_path} has no bounding boxes predictions") - return None - - data = [] - for prediction in predictions: - boxes = prediction["bbox"] - score = _scale_confidence_score(prediction["score"]) - cls_label = prediction["category_id"] - if class_label_map: - cls_label = str(class_label_map[cls_label]) - - data.append({"boxes": [boxes], "label": cls_label, "score": score}) - - return {"name": "prediction", "data": data} - - -def _fetch_annotations(img_idx, image_path, batch, prediction_metadata_map, class_label_map): - """Join the ground truth and prediction annotations if they exist.""" - ground_truth_annotations = _format_ground_truth_annotations_for_detection( - img_idx, image_path, batch, class_label_map - ) - prediction_annotations = _format_prediction_annotations_for_detection( - image_path, prediction_metadata_map, class_label_map - ) - - annotations = [ - annotation for annotation in [ground_truth_annotations, prediction_annotations] if annotation is not None - ] - return [annotations] if annotations else None - - -def _create_prediction_metadata_map(model_predictions): - """Create metadata map for model predictions by groupings them based on image ID.""" - pred_metadata_map = {} - for prediction in model_predictions: - pred_metadata_map.setdefault(prediction["image_id"], []) - pred_metadata_map[prediction["image_id"]].append(prediction) - - return pred_metadata_map - - -def _log_confusion_matrix(experiment, trainer, curr_step, curr_epoch): - """Log the confusion matrix to Comet experiment.""" - conf_mat = trainer.validator.confusion_matrix.matrix - names = list(trainer.data["names"].values()) + ["background"] - experiment.log_confusion_matrix( - matrix=conf_mat, labels=names, max_categories=len(names), epoch=curr_epoch, step=curr_step - ) - - -def _log_images(experiment, image_paths, curr_step, annotations=None): - """Logs images to the experiment with optional annotations.""" - if annotations: - for image_path, annotation in zip(image_paths, annotations): - experiment.log_image(image_path, name=image_path.stem, step=curr_step, annotations=annotation) - - else: - for image_path in image_paths: - experiment.log_image(image_path, name=image_path.stem, step=curr_step) - - -def _log_image_predictions(experiment, validator, curr_step): - """Logs predicted boxes for a single image during training.""" - global _comet_image_prediction_count - - task = validator.args.task - if task not in COMET_SUPPORTED_TASKS: - return - - jdict = validator.jdict - if not jdict: - return - - predictions_metadata_map = _create_prediction_metadata_map(jdict) - dataloader = validator.dataloader - class_label_map = validator.names - - batch_logging_interval = _get_eval_batch_logging_interval() - max_image_predictions = _get_max_image_predictions_to_log() - - for batch_idx, batch in enumerate(dataloader): - if (batch_idx + 1) % batch_logging_interval != 0: - continue - - image_paths = batch["im_file"] - for img_idx, image_path in enumerate(image_paths): - if _comet_image_prediction_count >= max_image_predictions: - return - - image_path = Path(image_path) - annotations = _fetch_annotations( - img_idx, - image_path, - batch, - predictions_metadata_map, - class_label_map, - ) - _log_images( - experiment, - [image_path], - curr_step, - annotations=annotations, - ) - _comet_image_prediction_count += 1 - - -def _log_plots(experiment, trainer): - """Logs evaluation plots and label plots for the experiment.""" - plot_filenames = [trainer.save_dir / f"{plots}.png" for plots in EVALUATION_PLOT_NAMES] - _log_images(experiment, plot_filenames, None) - - label_plot_filenames = [trainer.save_dir / f"{labels}.jpg" for labels in LABEL_PLOT_NAMES] - _log_images(experiment, label_plot_filenames, None) - - -def _log_model(experiment, trainer): - """Log the best-trained model to Comet.ml.""" - model_name = _get_comet_model_name() - experiment.log_model(model_name, file_or_folder=str(trainer.best), file_name="best.pt", overwrite=True) - - -def on_pretrain_routine_start(trainer): - """Creates or resumes a CometML experiment at the start of a YOLO pre-training routine.""" - experiment = comet_ml.get_global_experiment() - is_alive = getattr(experiment, "alive", False) - if not experiment or not is_alive: - _create_experiment(trainer.args) - - -def on_train_epoch_end(trainer): - """Log metrics and save batch images at the end of training epochs.""" - experiment = comet_ml.get_global_experiment() - if not experiment: - return - - metadata = _fetch_trainer_metadata(trainer) - curr_epoch = metadata["curr_epoch"] - curr_step = metadata["curr_step"] - - experiment.log_metrics(trainer.label_loss_items(trainer.tloss, prefix="train"), step=curr_step, epoch=curr_epoch) - - if curr_epoch == 1: - _log_images(experiment, trainer.save_dir.glob("train_batch*.jpg"), curr_step) - - -def on_fit_epoch_end(trainer): - """Logs model assets at the end of each epoch.""" - experiment = comet_ml.get_global_experiment() - if not experiment: - return - - metadata = _fetch_trainer_metadata(trainer) - curr_epoch = metadata["curr_epoch"] - curr_step = metadata["curr_step"] - save_assets = metadata["save_assets"] - - experiment.log_metrics(trainer.metrics, step=curr_step, epoch=curr_epoch) - experiment.log_metrics(trainer.lr, step=curr_step, epoch=curr_epoch) - if curr_epoch == 1: - from ultralytics.utils.torch_utils import model_info_for_loggers - - experiment.log_metrics(model_info_for_loggers(trainer), step=curr_step, epoch=curr_epoch) - - if not save_assets: - return - - _log_model(experiment, trainer) - if _should_log_confusion_matrix(): - _log_confusion_matrix(experiment, trainer, curr_step, curr_epoch) - if _should_log_image_predictions(): - _log_image_predictions(experiment, trainer.validator, curr_step) - - -def on_train_end(trainer): - """Perform operations at the end of training.""" - experiment = comet_ml.get_global_experiment() - if not experiment: - return - - metadata = _fetch_trainer_metadata(trainer) - curr_epoch = metadata["curr_epoch"] - curr_step = metadata["curr_step"] - plots = trainer.args.plots - - _log_model(experiment, trainer) - if plots: - _log_plots(experiment, trainer) - - _log_confusion_matrix(experiment, trainer, curr_step, curr_epoch) - _log_image_predictions(experiment, trainer.validator, curr_step) - experiment.end() - - global _comet_image_prediction_count - _comet_image_prediction_count = 0 - - -callbacks = ( - { - "on_pretrain_routine_start": on_pretrain_routine_start, - "on_train_epoch_end": on_train_epoch_end, - "on_fit_epoch_end": on_fit_epoch_end, - "on_train_end": on_train_end, - } - if comet_ml - else {} -) diff --git a/ultralytics-main/ultralytics/utils/callbacks/dvc.py b/ultralytics-main/ultralytics/utils/callbacks/dvc.py deleted file mode 100644 index ab51dc5..0000000 --- a/ultralytics-main/ultralytics/utils/callbacks/dvc.py +++ /dev/null @@ -1,145 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from ultralytics.utils import LOGGER, SETTINGS, TESTS_RUNNING, checks - -try: - assert not TESTS_RUNNING # do not log pytest - assert SETTINGS["dvc"] is True # verify integration is enabled - import dvclive - - assert checks.check_version("dvclive", "2.11.0", verbose=True) - - import os - import re - from pathlib import Path - - # DVCLive logger instance - live = None - _processed_plots = {} - - # `on_fit_epoch_end` is called on final validation (probably need to be fixed) for now this is the way we - # distinguish final evaluation of the best model vs last epoch validation - _training_epoch = False - -except (ImportError, AssertionError, TypeError): - dvclive = None - - -def _log_images(path, prefix=""): - """Logs images at specified path with an optional prefix using DVCLive.""" - if live: - name = path.name - - # Group images by batch to enable sliders in UI - if m := re.search(r"_batch(\d+)", name): - ni = m[1] - new_stem = re.sub(r"_batch(\d+)", "_batch", path.stem) - name = (Path(new_stem) / ni).with_suffix(path.suffix) - - live.log_image(os.path.join(prefix, name), path) - - -def _log_plots(plots, prefix=""): - """Logs plot images for training progress if they have not been previously processed.""" - for name, params in plots.items(): - timestamp = params["timestamp"] - if _processed_plots.get(name) != timestamp: - _log_images(name, prefix) - _processed_plots[name] = timestamp - - -def _log_confusion_matrix(validator): - """Logs the confusion matrix for the given validator using DVCLive.""" - targets = [] - preds = [] - matrix = validator.confusion_matrix.matrix - names = list(validator.names.values()) - if validator.confusion_matrix.task == "detect": - names += ["background"] - - for ti, pred in enumerate(matrix.T.astype(int)): - for pi, num in enumerate(pred): - targets.extend([names[ti]] * num) - preds.extend([names[pi]] * num) - - live.log_sklearn_plot("confusion_matrix", targets, preds, name="cf.json", normalized=True) - - -def on_pretrain_routine_start(trainer): - """Initializes DVCLive logger for training metadata during pre-training routine.""" - try: - global live - live = dvclive.Live(save_dvc_exp=True, cache_images=True) - LOGGER.info("DVCLive is detected and auto logging is enabled (run 'yolo settings dvc=False' to disable).") - except Exception as e: - LOGGER.warning(f"WARNING ⚠️ DVCLive installed but not initialized correctly, not logging this run. {e}") - - -def on_pretrain_routine_end(trainer): - """Logs plots related to the training process at the end of the pretraining routine.""" - _log_plots(trainer.plots, "train") - - -def on_train_start(trainer): - """Logs the training parameters if DVCLive logging is active.""" - if live: - live.log_params(trainer.args) - - -def on_train_epoch_start(trainer): - """Sets the global variable _training_epoch value to True at the start of training each epoch.""" - global _training_epoch - _training_epoch = True - - -def on_fit_epoch_end(trainer): - """Logs training metrics and model info, and advances to next step on the end of each fit epoch.""" - global _training_epoch - if live and _training_epoch: - all_metrics = {**trainer.label_loss_items(trainer.tloss, prefix="train"), **trainer.metrics, **trainer.lr} - for metric, value in all_metrics.items(): - live.log_metric(metric, value) - - if trainer.epoch == 0: - from ultralytics.utils.torch_utils import model_info_for_loggers - - for metric, value in model_info_for_loggers(trainer).items(): - live.log_metric(metric, value, plot=False) - - _log_plots(trainer.plots, "train") - _log_plots(trainer.validator.plots, "val") - - live.next_step() - _training_epoch = False - - -def on_train_end(trainer): - """Logs the best metrics, plots, and confusion matrix at the end of training if DVCLive is active.""" - if live: - # At the end log the best metrics. It runs validator on the best model internally. - all_metrics = {**trainer.label_loss_items(trainer.tloss, prefix="train"), **trainer.metrics, **trainer.lr} - for metric, value in all_metrics.items(): - live.log_metric(metric, value, plot=False) - - _log_plots(trainer.plots, "val") - _log_plots(trainer.validator.plots, "val") - _log_confusion_matrix(trainer.validator) - - if trainer.best.exists(): - live.log_artifact(trainer.best, copy=True, type="model") - - live.end() - - -callbacks = ( - { - "on_pretrain_routine_start": on_pretrain_routine_start, - "on_pretrain_routine_end": on_pretrain_routine_end, - "on_train_start": on_train_start, - "on_train_epoch_start": on_train_epoch_start, - "on_fit_epoch_end": on_fit_epoch_end, - "on_train_end": on_train_end, - } - if dvclive - else {} -) diff --git a/ultralytics-main/ultralytics/utils/callbacks/hub.py b/ultralytics-main/ultralytics/utils/callbacks/hub.py deleted file mode 100644 index cdb42b9..0000000 --- a/ultralytics-main/ultralytics/utils/callbacks/hub.py +++ /dev/null @@ -1,108 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import json -from time import time - -from ultralytics.hub.utils import HUB_WEB_ROOT, PREFIX, events -from ultralytics.utils import LOGGER, SETTINGS - - -def on_pretrain_routine_end(trainer): - """Logs info before starting timer for upload rate limit.""" - session = getattr(trainer, "hub_session", None) - if session: - # Start timer for upload rate limit - session.timers = { - "metrics": time(), - "ckpt": time(), - } # start timer on session.rate_limit - - -def on_fit_epoch_end(trainer): - """Uploads training progress metrics at the end of each epoch.""" - session = getattr(trainer, "hub_session", None) - if session: - # Upload metrics after val end - all_plots = { - **trainer.label_loss_items(trainer.tloss, prefix="train"), - **trainer.metrics, - } - if trainer.epoch == 0: - from ultralytics.utils.torch_utils import model_info_for_loggers - - all_plots = {**all_plots, **model_info_for_loggers(trainer)} - - session.metrics_queue[trainer.epoch] = json.dumps(all_plots) - - # If any metrics fail to upload, add them to the queue to attempt uploading again. - if session.metrics_upload_failed_queue: - session.metrics_queue.update(session.metrics_upload_failed_queue) - - if time() - session.timers["metrics"] > session.rate_limits["metrics"]: - session.upload_metrics() - session.timers["metrics"] = time() # reset timer - session.metrics_queue = {} # reset queue - - -def on_model_save(trainer): - """Saves checkpoints to Ultralytics HUB with rate limiting.""" - session = getattr(trainer, "hub_session", None) - if session: - # Upload checkpoints with rate limiting - is_best = trainer.best_fitness == trainer.fitness - if time() - session.timers["ckpt"] > session.rate_limits["ckpt"]: - LOGGER.info(f"{PREFIX}Uploading checkpoint {HUB_WEB_ROOT}/models/{session.model.id}") - session.upload_model(trainer.epoch, trainer.last, is_best) - session.timers["ckpt"] = time() # reset timer - - -def on_train_end(trainer): - """Upload final model and metrics to Ultralytics HUB at the end of training.""" - session = getattr(trainer, "hub_session", None) - if session: - # Upload final model and metrics with exponential standoff - LOGGER.info(f"{PREFIX}Syncing final model...") - session.upload_model( - trainer.epoch, - trainer.best, - map=trainer.metrics.get("metrics/mAP50-95(B)", 0), - final=True, - ) - session.alive = False # stop heartbeats - LOGGER.info(f"{PREFIX}Done ✅\n" f"{PREFIX}View model at {session.model_url} 🚀") - - -def on_train_start(trainer): - """Run events on train start.""" - events(trainer.args) - - -def on_val_start(validator): - """Runs events on validation start.""" - events(validator.args) - - -def on_predict_start(predictor): - """Run events on predict start.""" - events(predictor.args) - - -def on_export_start(exporter): - """Run events on export start.""" - events(exporter.args) - - -callbacks = ( - { - "on_pretrain_routine_end": on_pretrain_routine_end, - "on_fit_epoch_end": on_fit_epoch_end, - "on_model_save": on_model_save, - "on_train_end": on_train_end, - "on_train_start": on_train_start, - "on_val_start": on_val_start, - "on_predict_start": on_predict_start, - "on_export_start": on_export_start, - } - if SETTINGS["hub"] is True - else {} -) # verify enabled diff --git a/ultralytics-main/ultralytics/utils/callbacks/mlflow.py b/ultralytics-main/ultralytics/utils/callbacks/mlflow.py deleted file mode 100644 index e554620..0000000 --- a/ultralytics-main/ultralytics/utils/callbacks/mlflow.py +++ /dev/null @@ -1,133 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -""" -MLflow Logging for Ultralytics YOLO. - -This module enables MLflow logging for Ultralytics YOLO. It logs metrics, parameters, and model artifacts. -For setting up, a tracking URI should be specified. The logging can be customized using environment variables. - -Commands: - 1. To set a project name: - `export MLFLOW_EXPERIMENT_NAME=` or use the project= argument - - 2. To set a run name: - `export MLFLOW_RUN=` or use the name= argument - - 3. To start a local MLflow server: - mlflow server --backend-store-uri runs/mlflow - It will by default start a local server at http://127.0.0.1:5000. - To specify a different URI, set the MLFLOW_TRACKING_URI environment variable. - - 4. To kill all running MLflow server instances: - ps aux | grep 'mlflow' | grep -v 'grep' | awk '{print $2}' | xargs kill -9 -""" - -from ultralytics.utils import LOGGER, RUNS_DIR, SETTINGS, TESTS_RUNNING, colorstr - -try: - import os - - assert not TESTS_RUNNING or "test_mlflow" in os.environ.get("PYTEST_CURRENT_TEST", "") # do not log pytest - assert SETTINGS["mlflow"] is True # verify integration is enabled - import mlflow - - assert hasattr(mlflow, "__version__") # verify package is not directory - from pathlib import Path - - PREFIX = colorstr("MLflow: ") - SANITIZE = lambda x: {k.replace("(", "").replace(")", ""): float(v) for k, v in x.items()} - -except (ImportError, AssertionError): - mlflow = None - - -def on_pretrain_routine_end(trainer): - """ - Log training parameters to MLflow at the end of the pretraining routine. - - This function sets up MLflow logging based on environment variables and trainer arguments. It sets the tracking URI, - experiment name, and run name, then starts the MLflow run if not already active. It finally logs the parameters - from the trainer. - - Args: - trainer (ultralytics.engine.trainer.BaseTrainer): The training object with arguments and parameters to log. - - Global: - mlflow: The imported mlflow module to use for logging. - - Environment Variables: - MLFLOW_TRACKING_URI: The URI for MLflow tracking. If not set, defaults to 'runs/mlflow'. - MLFLOW_EXPERIMENT_NAME: The name of the MLflow experiment. If not set, defaults to trainer.args.project. - MLFLOW_RUN: The name of the MLflow run. If not set, defaults to trainer.args.name. - MLFLOW_KEEP_RUN_ACTIVE: Boolean indicating whether to keep the MLflow run active after the end of the training phase. - """ - global mlflow - - uri = os.environ.get("MLFLOW_TRACKING_URI") or str(RUNS_DIR / "mlflow") - LOGGER.debug(f"{PREFIX} tracking uri: {uri}") - mlflow.set_tracking_uri(uri) - - # Set experiment and run names - experiment_name = os.environ.get("MLFLOW_EXPERIMENT_NAME") or trainer.args.project or "/Shared/YOLOv8" - run_name = os.environ.get("MLFLOW_RUN") or trainer.args.name - mlflow.set_experiment(experiment_name) - - mlflow.autolog() - try: - active_run = mlflow.active_run() or mlflow.start_run(run_name=run_name) - LOGGER.info(f"{PREFIX}logging run_id({active_run.info.run_id}) to {uri}") - if Path(uri).is_dir(): - LOGGER.info(f"{PREFIX}view at http://127.0.0.1:5000 with 'mlflow server --backend-store-uri {uri}'") - LOGGER.info(f"{PREFIX}disable with 'yolo settings mlflow=False'") - mlflow.log_params(dict(trainer.args)) - except Exception as e: - LOGGER.warning(f"{PREFIX}WARNING ⚠️ Failed to initialize: {e}\n" f"{PREFIX}WARNING ⚠️ Not tracking this run") - - -def on_train_epoch_end(trainer): - """Log training metrics at the end of each train epoch to MLflow.""" - if mlflow: - mlflow.log_metrics( - metrics={ - **SANITIZE(trainer.lr), - **SANITIZE(trainer.label_loss_items(trainer.tloss, prefix="train")), - }, - step=trainer.epoch, - ) - - -def on_fit_epoch_end(trainer): - """Log training metrics at the end of each fit epoch to MLflow.""" - if mlflow: - mlflow.log_metrics(metrics=SANITIZE(trainer.metrics), step=trainer.epoch) - - -def on_train_end(trainer): - """Log model artifacts at the end of the training.""" - if mlflow: - mlflow.log_artifact(str(trainer.best.parent)) # log save_dir/weights directory with best.pt and last.pt - for f in trainer.save_dir.glob("*"): # log all other files in save_dir - if f.suffix in {".png", ".jpg", ".csv", ".pt", ".yaml"}: - mlflow.log_artifact(str(f)) - keep_run_active = os.environ.get("MLFLOW_KEEP_RUN_ACTIVE", "False").lower() in ("true") - if keep_run_active: - LOGGER.info(f"{PREFIX}mlflow run still alive, remember to close it using mlflow.end_run()") - else: - mlflow.end_run() - LOGGER.debug(f"{PREFIX}mlflow run ended") - - LOGGER.info( - f"{PREFIX}results logged to {mlflow.get_tracking_uri()}\n" - f"{PREFIX}disable with 'yolo settings mlflow=False'" - ) - - -callbacks = ( - { - "on_pretrain_routine_end": on_pretrain_routine_end, - "on_train_epoch_end": on_train_epoch_end, - "on_fit_epoch_end": on_fit_epoch_end, - "on_train_end": on_train_end, - } - if mlflow - else {} -) diff --git a/ultralytics-main/ultralytics/utils/callbacks/neptune.py b/ultralytics-main/ultralytics/utils/callbacks/neptune.py deleted file mode 100644 index 6be8a82..0000000 --- a/ultralytics-main/ultralytics/utils/callbacks/neptune.py +++ /dev/null @@ -1,112 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from ultralytics.utils import LOGGER, SETTINGS, TESTS_RUNNING - -try: - assert not TESTS_RUNNING # do not log pytest - assert SETTINGS["neptune"] is True # verify integration is enabled - import neptune - from neptune.types import File - - assert hasattr(neptune, "__version__") - - run = None # NeptuneAI experiment logger instance - -except (ImportError, AssertionError): - neptune = None - - -def _log_scalars(scalars, step=0): - """Log scalars to the NeptuneAI experiment logger.""" - if run: - for k, v in scalars.items(): - run[k].append(value=v, step=step) - - -def _log_images(imgs_dict, group=""): - """Log scalars to the NeptuneAI experiment logger.""" - if run: - for k, v in imgs_dict.items(): - run[f"{group}/{k}"].upload(File(v)) - - -def _log_plot(title, plot_path): - """ - Log plots to the NeptuneAI experiment logger. - - Args: - title (str): Title of the plot. - plot_path (PosixPath | str): Path to the saved image file. - """ - import matplotlib.image as mpimg - import matplotlib.pyplot as plt - - img = mpimg.imread(plot_path) - fig = plt.figure() - ax = fig.add_axes([0, 0, 1, 1], frameon=False, aspect="auto", xticks=[], yticks=[]) # no ticks - ax.imshow(img) - run[f"Plots/{title}"].upload(fig) - - -def on_pretrain_routine_start(trainer): - """Callback function called before the training routine starts.""" - try: - global run - run = neptune.init_run(project=trainer.args.project or "YOLOv8", name=trainer.args.name, tags=["YOLOv8"]) - run["Configuration/Hyperparameters"] = {k: "" if v is None else v for k, v in vars(trainer.args).items()} - except Exception as e: - LOGGER.warning(f"WARNING ⚠️ NeptuneAI installed but not initialized correctly, not logging this run. {e}") - - -def on_train_epoch_end(trainer): - """Callback function called at end of each training epoch.""" - _log_scalars(trainer.label_loss_items(trainer.tloss, prefix="train"), trainer.epoch + 1) - _log_scalars(trainer.lr, trainer.epoch + 1) - if trainer.epoch == 1: - _log_images({f.stem: str(f) for f in trainer.save_dir.glob("train_batch*.jpg")}, "Mosaic") - - -def on_fit_epoch_end(trainer): - """Callback function called at end of each fit (train+val) epoch.""" - if run and trainer.epoch == 0: - from ultralytics.utils.torch_utils import model_info_for_loggers - - run["Configuration/Model"] = model_info_for_loggers(trainer) - _log_scalars(trainer.metrics, trainer.epoch + 1) - - -def on_val_end(validator): - """Callback function called at end of each validation.""" - if run: - # Log val_labels and val_pred - _log_images({f.stem: str(f) for f in validator.save_dir.glob("val*.jpg")}, "Validation") - - -def on_train_end(trainer): - """Callback function called at end of training.""" - if run: - # Log final results, CM matrix + PR plots - files = [ - "results.png", - "confusion_matrix.png", - "confusion_matrix_normalized.png", - *(f"{x}_curve.png" for x in ("F1", "PR", "P", "R")), - ] - files = [(trainer.save_dir / f) for f in files if (trainer.save_dir / f).exists()] # filter - for f in files: - _log_plot(title=f.stem, plot_path=f) - # Log the final model - run[f"weights/{trainer.args.name or trainer.args.task}/{trainer.best.name}"].upload(File(str(trainer.best))) - - -callbacks = ( - { - "on_pretrain_routine_start": on_pretrain_routine_start, - "on_train_epoch_end": on_train_epoch_end, - "on_fit_epoch_end": on_fit_epoch_end, - "on_val_end": on_val_end, - "on_train_end": on_train_end, - } - if neptune - else {} -) diff --git a/ultralytics-main/ultralytics/utils/callbacks/raytune.py b/ultralytics-main/ultralytics/utils/callbacks/raytune.py deleted file mode 100644 index f269455..0000000 --- a/ultralytics-main/ultralytics/utils/callbacks/raytune.py +++ /dev/null @@ -1,29 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from ultralytics.utils import SETTINGS - -try: - assert SETTINGS["raytune"] is True # verify integration is enabled - import ray - from ray import tune - from ray.air import session - -except (ImportError, AssertionError): - tune = None - - -def on_fit_epoch_end(trainer): - """Sends training metrics to Ray Tune at end of each epoch.""" - if ray.tune.is_session_enabled(): - metrics = trainer.metrics - metrics["epoch"] = trainer.epoch - session.report(metrics) - - -callbacks = ( - { - "on_fit_epoch_end": on_fit_epoch_end, - } - if tune - else {} -) diff --git a/ultralytics-main/ultralytics/utils/callbacks/tensorboard.py b/ultralytics-main/ultralytics/utils/callbacks/tensorboard.py deleted file mode 100644 index 59024ee..0000000 --- a/ultralytics-main/ultralytics/utils/callbacks/tensorboard.py +++ /dev/null @@ -1,106 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -import contextlib - -from ultralytics.utils import LOGGER, SETTINGS, TESTS_RUNNING, colorstr - -try: - # WARNING: do not move SummaryWriter import due to protobuf bug https://github.com/ultralytics/ultralytics/pull/4674 - from torch.utils.tensorboard import SummaryWriter - - assert not TESTS_RUNNING # do not log pytest - assert SETTINGS["tensorboard"] is True # verify integration is enabled - WRITER = None # TensorBoard SummaryWriter instance - PREFIX = colorstr("TensorBoard: ") - - # Imports below only required if TensorBoard enabled - import warnings - from copy import deepcopy - from ultralytics.utils.torch_utils import de_parallel, torch - -except (ImportError, AssertionError, TypeError, AttributeError): - # TypeError for handling 'Descriptors cannot not be created directly.' protobuf errors in Windows - # AttributeError: module 'tensorflow' has no attribute 'io' if 'tensorflow' not installed - SummaryWriter = None - - -def _log_scalars(scalars, step=0): - """Logs scalar values to TensorBoard.""" - if WRITER: - for k, v in scalars.items(): - WRITER.add_scalar(k, v, step) - - -def _log_tensorboard_graph(trainer): - """Log model graph to TensorBoard.""" - - # Input image - imgsz = trainer.args.imgsz - imgsz = (imgsz, imgsz) if isinstance(imgsz, int) else imgsz - p = next(trainer.model.parameters()) # for device, type - im = torch.zeros((1, 3, *imgsz), device=p.device, dtype=p.dtype) # input image (must be zeros, not empty) - - with warnings.catch_warnings(): - warnings.simplefilter("ignore", category=UserWarning) # suppress jit trace warning - warnings.simplefilter("ignore", category=torch.jit.TracerWarning) # suppress jit trace warning - - # Try simple method first (YOLO) - with contextlib.suppress(Exception): - trainer.model.eval() # place in .eval() mode to avoid BatchNorm statistics changes - WRITER.add_graph(torch.jit.trace(de_parallel(trainer.model), im, strict=False), []) - LOGGER.info(f"{PREFIX}model graph visualization added ✅") - return - - # Fallback to TorchScript export steps (RTDETR) - try: - model = deepcopy(de_parallel(trainer.model)) - model.eval() - model = model.fuse(verbose=False) - for m in model.modules(): - if hasattr(m, "export"): # Detect, RTDETRDecoder (Segment and Pose use Detect base class) - m.export = True - m.format = "torchscript" - model(im) # dry run - WRITER.add_graph(torch.jit.trace(model, im, strict=False), []) - LOGGER.info(f"{PREFIX}model graph visualization added ✅") - except Exception as e: - LOGGER.warning(f"{PREFIX}WARNING ⚠️ TensorBoard graph visualization failure {e}") - - -def on_pretrain_routine_start(trainer): - """Initialize TensorBoard logging with SummaryWriter.""" - if SummaryWriter: - try: - global WRITER - WRITER = SummaryWriter(str(trainer.save_dir)) - LOGGER.info(f"{PREFIX}Start with 'tensorboard --logdir {trainer.save_dir}', view at http://localhost:6006/") - except Exception as e: - LOGGER.warning(f"{PREFIX}WARNING ⚠️ TensorBoard not initialized correctly, not logging this run. {e}") - - -def on_train_start(trainer): - """Log TensorBoard graph.""" - if WRITER: - _log_tensorboard_graph(trainer) - - -def on_train_epoch_end(trainer): - """Logs scalar statistics at the end of a training epoch.""" - _log_scalars(trainer.label_loss_items(trainer.tloss, prefix="train"), trainer.epoch + 1) - _log_scalars(trainer.lr, trainer.epoch + 1) - - -def on_fit_epoch_end(trainer): - """Logs epoch metrics at end of training epoch.""" - _log_scalars(trainer.metrics, trainer.epoch + 1) - - -callbacks = ( - { - "on_pretrain_routine_start": on_pretrain_routine_start, - "on_train_start": on_train_start, - "on_fit_epoch_end": on_fit_epoch_end, - "on_train_epoch_end": on_train_epoch_end, - } - if SummaryWriter - else {} -) diff --git a/ultralytics-main/ultralytics/utils/callbacks/wb.py b/ultralytics-main/ultralytics/utils/callbacks/wb.py deleted file mode 100644 index 25a1b64..0000000 --- a/ultralytics-main/ultralytics/utils/callbacks/wb.py +++ /dev/null @@ -1,163 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from ultralytics.utils import SETTINGS, TESTS_RUNNING -from ultralytics.utils.torch_utils import model_info_for_loggers - -try: - assert not TESTS_RUNNING # do not log pytest - assert SETTINGS["wandb"] is True # verify integration is enabled - import wandb as wb - - assert hasattr(wb, "__version__") # verify package is not directory - - import numpy as np - import pandas as pd - - _processed_plots = {} - -except (ImportError, AssertionError): - wb = None - - -def _custom_table(x, y, classes, title="Precision Recall Curve", x_title="Recall", y_title="Precision"): - """ - Create and log a custom metric visualization to wandb.plot.pr_curve. - - This function crafts a custom metric visualization that mimics the behavior of wandb's default precision-recall - curve while allowing for enhanced customization. The visual metric is useful for monitoring model performance across - different classes. - - Args: - x (List): Values for the x-axis; expected to have length N. - y (List): Corresponding values for the y-axis; also expected to have length N. - classes (List): Labels identifying the class of each point; length N. - title (str, optional): Title for the plot; defaults to 'Precision Recall Curve'. - x_title (str, optional): Label for the x-axis; defaults to 'Recall'. - y_title (str, optional): Label for the y-axis; defaults to 'Precision'. - - Returns: - (wandb.Object): A wandb object suitable for logging, showcasing the crafted metric visualization. - """ - df = pd.DataFrame({"class": classes, "y": y, "x": x}).round(3) - fields = {"x": "x", "y": "y", "class": "class"} - string_fields = {"title": title, "x-axis-title": x_title, "y-axis-title": y_title} - return wb.plot_table( - "wandb/area-under-curve/v0", wb.Table(dataframe=df), fields=fields, string_fields=string_fields - ) - - -def _plot_curve( - x, - y, - names=None, - id="precision-recall", - title="Precision Recall Curve", - x_title="Recall", - y_title="Precision", - num_x=100, - only_mean=False, -): - """ - Log a metric curve visualization. - - This function generates a metric curve based on input data and logs the visualization to wandb. - The curve can represent aggregated data (mean) or individual class data, depending on the 'only_mean' flag. - - Args: - x (np.ndarray): Data points for the x-axis with length N. - y (np.ndarray): Corresponding data points for the y-axis with shape CxN, where C is the number of classes. - names (list, optional): Names of the classes corresponding to the y-axis data; length C. Defaults to []. - id (str, optional): Unique identifier for the logged data in wandb. Defaults to 'precision-recall'. - title (str, optional): Title for the visualization plot. Defaults to 'Precision Recall Curve'. - x_title (str, optional): Label for the x-axis. Defaults to 'Recall'. - y_title (str, optional): Label for the y-axis. Defaults to 'Precision'. - num_x (int, optional): Number of interpolated data points for visualization. Defaults to 100. - only_mean (bool, optional): Flag to indicate if only the mean curve should be plotted. Defaults to True. - - Note: - The function leverages the '_custom_table' function to generate the actual visualization. - """ - # Create new x - if names is None: - names = [] - x_new = np.linspace(x[0], x[-1], num_x).round(5) - - # Create arrays for logging - x_log = x_new.tolist() - y_log = np.interp(x_new, x, np.mean(y, axis=0)).round(3).tolist() - - if only_mean: - table = wb.Table(data=list(zip(x_log, y_log)), columns=[x_title, y_title]) - wb.run.log({title: wb.plot.line(table, x_title, y_title, title=title)}) - else: - classes = ["mean"] * len(x_log) - for i, yi in enumerate(y): - x_log.extend(x_new) # add new x - y_log.extend(np.interp(x_new, x, yi)) # interpolate y to new x - classes.extend([names[i]] * len(x_new)) # add class names - wb.log({id: _custom_table(x_log, y_log, classes, title, x_title, y_title)}, commit=False) - - -def _log_plots(plots, step): - """Logs plots from the input dictionary if they haven't been logged already at the specified step.""" - for name, params in plots.items(): - timestamp = params["timestamp"] - if _processed_plots.get(name) != timestamp: - wb.run.log({name.stem: wb.Image(str(name))}, step=step) - _processed_plots[name] = timestamp - - -def on_pretrain_routine_start(trainer): - """Initiate and start project if module is present.""" - wb.run or wb.init(project=trainer.args.project or "YOLOv8", name=trainer.args.name, config=vars(trainer.args)) - - -def on_fit_epoch_end(trainer): - """Logs training metrics and model information at the end of an epoch.""" - wb.run.log(trainer.metrics, step=trainer.epoch + 1) - _log_plots(trainer.plots, step=trainer.epoch + 1) - _log_plots(trainer.validator.plots, step=trainer.epoch + 1) - if trainer.epoch == 0: - wb.run.log(model_info_for_loggers(trainer), step=trainer.epoch + 1) - - -def on_train_epoch_end(trainer): - """Log metrics and save images at the end of each training epoch.""" - wb.run.log(trainer.label_loss_items(trainer.tloss, prefix="train"), step=trainer.epoch + 1) - wb.run.log(trainer.lr, step=trainer.epoch + 1) - if trainer.epoch == 1: - _log_plots(trainer.plots, step=trainer.epoch + 1) - - -def on_train_end(trainer): - """Save the best model as an artifact at end of training.""" - _log_plots(trainer.validator.plots, step=trainer.epoch + 1) - _log_plots(trainer.plots, step=trainer.epoch + 1) - art = wb.Artifact(type="model", name=f"run_{wb.run.id}_model") - if trainer.best.exists(): - art.add_file(trainer.best) - wb.run.log_artifact(art, aliases=["best"]) - for curve_name, curve_values in zip(trainer.validator.metrics.curves, trainer.validator.metrics.curves_results): - x, y, x_title, y_title = curve_values - _plot_curve( - x, - y, - names=list(trainer.validator.metrics.names.values()), - id=f"curves/{curve_name}", - title=curve_name, - x_title=x_title, - y_title=y_title, - ) - wb.run.finish() # required or run continues on dashboard - - -callbacks = ( - { - "on_pretrain_routine_start": on_pretrain_routine_start, - "on_train_epoch_end": on_train_epoch_end, - "on_fit_epoch_end": on_fit_epoch_end, - "on_train_end": on_train_end, - } - if wb - else {} -) diff --git a/ultralytics-main/ultralytics/utils/checks.py b/ultralytics-main/ultralytics/utils/checks.py deleted file mode 100644 index 106fa4e..0000000 --- a/ultralytics-main/ultralytics/utils/checks.py +++ /dev/null @@ -1,729 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import contextlib -import glob -import inspect -import math -import os -import platform -import re -import shutil -import subprocess -import time -from importlib import metadata -from pathlib import Path -from typing import Optional - -import cv2 -import numpy as np -import requests -import torch -from matplotlib import font_manager - -from ultralytics.utils import ( - ASSETS, - AUTOINSTALL, - LINUX, - LOGGER, - ONLINE, - ROOT, - USER_CONFIG_DIR, - SimpleNamespace, - ThreadingLocked, - TryExcept, - clean_url, - colorstr, - downloads, - emojis, - is_colab, - is_docker, - is_github_action_running, - is_jupyter, - is_kaggle, - is_online, - is_pip_package, - url2file, -) - -PYTHON_VERSION = platform.python_version() - - -def parse_requirements(file_path=ROOT.parent / "requirements.txt", package=""): - """ - Parse a requirements.txt file, ignoring lines that start with '#' and any text after '#'. - - Args: - file_path (Path): Path to the requirements.txt file. - package (str, optional): Python package to use instead of requirements.txt file, i.e. package='ultralytics'. - - Returns: - (List[Dict[str, str]]): List of parsed requirements as dictionaries with `name` and `specifier` keys. - - Example: - ```python - from ultralytics.utils.checks import parse_requirements - - parse_requirements(package='ultralytics') - ``` - """ - - if package: - requires = [x for x in metadata.distribution(package).requires if "extra == " not in x] - else: - requires = Path(file_path).read_text().splitlines() - - requirements = [] - for line in requires: - line = line.strip() - if line and not line.startswith("#"): - line = line.split("#")[0].strip() # ignore inline comments - match = re.match(r"([a-zA-Z0-9-_]+)\s*([<>!=~]+.*)?", line) - if match: - requirements.append(SimpleNamespace(name=match[1], specifier=match[2].strip() if match[2] else "")) - - return requirements - - -def parse_version(version="0.0.0") -> tuple: - """ - Convert a version string to a tuple of integers, ignoring any extra non-numeric string attached to the version. This - function replaces deprecated 'pkg_resources.parse_version(v)'. - - Args: - version (str): Version string, i.e. '2.0.1+cpu' - - Returns: - (tuple): Tuple of integers representing the numeric part of the version and the extra string, i.e. (2, 0, 1) - """ - try: - return tuple(map(int, re.findall(r"\d+", version)[:3])) # '2.0.1+cpu' -> (2, 0, 1) - except Exception as e: - LOGGER.warning(f"WARNING ⚠️ failure for parse_version({version}), returning (0, 0, 0): {e}") - return 0, 0, 0 - - -def is_ascii(s) -> bool: - """ - Check if a string is composed of only ASCII characters. - - Args: - s (str): String to be checked. - - Returns: - (bool): True if the string is composed only of ASCII characters, False otherwise. - """ - # Convert list, tuple, None, etc. to string - s = str(s) - - # Check if the string is composed of only ASCII characters - return all(ord(c) < 128 for c in s) - - -def check_imgsz(imgsz, stride=32, min_dim=1, max_dim=2, floor=0): - """ - Verify image size is a multiple of the given stride in each dimension. If the image size is not a multiple of the - stride, update it to the nearest multiple of the stride that is greater than or equal to the given floor value. - - Args: - imgsz (int | cList[int]): Image size. - stride (int): Stride value. - min_dim (int): Minimum number of dimensions. - max_dim (int): Maximum number of dimensions. - floor (int): Minimum allowed value for image size. - - Returns: - (List[int]): Updated image size. - """ - # Convert stride to integer if it is a tensor - stride = int(stride.max() if isinstance(stride, torch.Tensor) else stride) - - # Convert image size to list if it is an integer - if isinstance(imgsz, int): - imgsz = [imgsz] - elif isinstance(imgsz, (list, tuple)): - imgsz = list(imgsz) - else: - raise TypeError( - f"'imgsz={imgsz}' is of invalid type {type(imgsz).__name__}. " - f"Valid imgsz types are int i.e. 'imgsz=640' or list i.e. 'imgsz=[640,640]'" - ) - - # Apply max_dim - if len(imgsz) > max_dim: - msg = ( - "'train' and 'val' imgsz must be an integer, while 'predict' and 'export' imgsz may be a [h, w] list " - "or an integer, i.e. 'yolo export imgsz=640,480' or 'yolo export imgsz=640'" - ) - if max_dim != 1: - raise ValueError(f"imgsz={imgsz} is not a valid image size. {msg}") - LOGGER.warning(f"WARNING ⚠️ updating to 'imgsz={max(imgsz)}'. {msg}") - imgsz = [max(imgsz)] - # Make image size a multiple of the stride - sz = [max(math.ceil(x / stride) * stride, floor) for x in imgsz] - - # Print warning message if image size was updated - if sz != imgsz: - LOGGER.warning(f"WARNING ⚠️ imgsz={imgsz} must be multiple of max stride {stride}, updating to {sz}") - - # Add missing dimensions if necessary - sz = [sz[0], sz[0]] if min_dim == 2 and len(sz) == 1 else sz[0] if min_dim == 1 and len(sz) == 1 else sz - - return sz - - -def check_version( - current: str = "0.0.0", - required: str = "0.0.0", - name: str = "version", - hard: bool = False, - verbose: bool = False, - msg: str = "", -) -> bool: - """ - Check current version against the required version or range. - - Args: - current (str): Current version or package name to get version from. - required (str): Required version or range (in pip-style format). - name (str, optional): Name to be used in warning message. - hard (bool, optional): If True, raise an AssertionError if the requirement is not met. - verbose (bool, optional): If True, print warning message if requirement is not met. - msg (str, optional): Extra message to display if verbose. - - Returns: - (bool): True if requirement is met, False otherwise. - - Example: - ```python - # Check if current version is exactly 22.04 - check_version(current='22.04', required='==22.04') - - # Check if current version is greater than or equal to 22.04 - check_version(current='22.10', required='22.04') # assumes '>=' inequality if none passed - - # Check if current version is less than or equal to 22.04 - check_version(current='22.04', required='<=22.04') - - # Check if current version is between 20.04 (inclusive) and 22.04 (exclusive) - check_version(current='21.10', required='>20.04,<22.04') - ``` - """ - if not current: # if current is '' or None - LOGGER.warning(f"WARNING ⚠️ invalid check_version({current}, {required}) requested, please check values.") - return True - elif not current[0].isdigit(): # current is package name rather than version string, i.e. current='ultralytics' - try: - name = current # assigned package name to 'name' arg - current = metadata.version(current) # get version string from package name - except metadata.PackageNotFoundError as e: - if hard: - raise ModuleNotFoundError(emojis(f"WARNING ⚠️ {current} package is required but not installed")) from e - else: - return False - - if not required: # if required is '' or None - return True - - op = "" - version = "" - result = True - c = parse_version(current) # '1.2.3' -> (1, 2, 3) - for r in required.strip(",").split(","): - op, version = re.match(r"([^0-9]*)([\d.]+)", r).groups() # split '>=22.04' -> ('>=', '22.04') - v = parse_version(version) # '1.2.3' -> (1, 2, 3) - if op == "==" and c != v: - result = False - elif op == "!=" and c == v: - result = False - elif op in (">=", "") and not (c >= v): # if no constraint passed assume '>=required' - result = False - elif op == "<=" and not (c <= v): - result = False - elif op == ">" and not (c > v): - result = False - elif op == "<" and not (c < v): - result = False - if not result: - warning = f"WARNING ⚠️ {name}{op}{version} is required, but {name}=={current} is currently installed {msg}" - if hard: - raise ModuleNotFoundError(emojis(warning)) # assert version requirements met - if verbose: - LOGGER.warning(warning) - return result - - -def check_latest_pypi_version(package_name="ultralytics"): - """ - Returns the latest version of a PyPI package without downloading or installing it. - - Parameters: - package_name (str): The name of the package to find the latest version for. - - Returns: - (str): The latest version of the package. - """ - with contextlib.suppress(Exception): - requests.packages.urllib3.disable_warnings() # Disable the InsecureRequestWarning - response = requests.get(f"https://pypi.org/pypi/{package_name}/json", timeout=3) - if response.status_code == 200: - return response.json()["info"]["version"] - - -def check_pip_update_available(): - """ - Checks if a new version of the ultralytics package is available on PyPI. - - Returns: - (bool): True if an update is available, False otherwise. - """ - if ONLINE and is_pip_package(): - with contextlib.suppress(Exception): - from ultralytics import __version__ - - latest = check_latest_pypi_version() - if check_version(__version__, f"<{latest}"): # check if current version is < latest version - LOGGER.info( - f"New https://pypi.org/project/ultralytics/{latest} available 😃 " - f"Update with 'pip install -U ultralytics'" - ) - return True - return False - - -@ThreadingLocked() -def check_font(font="Arial.ttf"): - """ - Find font locally or download to user's configuration directory if it does not already exist. - - Args: - font (str): Path or name of font. - - Returns: - file (Path): Resolved font file path. - """ - name = Path(font).name - - # Check USER_CONFIG_DIR - file = USER_CONFIG_DIR / name - if file.exists(): - return file - - # Check system fonts - matches = [s for s in font_manager.findSystemFonts() if font in s] - if any(matches): - return matches[0] - - # Download to USER_CONFIG_DIR if missing - url = f"https://ultralytics.com/assets/{name}" - if downloads.is_url(url): - downloads.safe_download(url=url, file=file) - return file - - -def check_python(minimum: str = "3.8.0") -> bool: - """ - Check current python version against the required minimum version. - - Args: - minimum (str): Required minimum version of python. - - Returns: - (bool): Whether the installed Python version meets the minimum constraints. - """ - return check_version(PYTHON_VERSION, minimum, name="Python ", hard=True) - - -@TryExcept() -def check_requirements(requirements=ROOT.parent / "requirements.txt", exclude=(), install=True, cmds=""): - """ - Check if installed dependencies meet YOLOv8 requirements and attempt to auto-update if needed. - - Args: - requirements (Union[Path, str, List[str]]): Path to a requirements.txt file, a single package requirement as a - string, or a list of package requirements as strings. - exclude (Tuple[str]): Tuple of package names to exclude from checking. - install (bool): If True, attempt to auto-update packages that don't meet requirements. - cmds (str): Additional commands to pass to the pip install command when auto-updating. - - Example: - ```python - from ultralytics.utils.checks import check_requirements - - # Check a requirements.txt file - check_requirements('path/to/requirements.txt') - - # Check a single package - check_requirements('ultralytics>=8.0.0') - - # Check multiple packages - check_requirements(['numpy', 'ultralytics>=8.0.0']) - ``` - """ - - prefix = colorstr("red", "bold", "requirements:") - check_python() # check python version - check_torchvision() # check torch-torchvision compatibility - if isinstance(requirements, Path): # requirements.txt file - file = requirements.resolve() - assert file.exists(), f"{prefix} {file} not found, check failed." - requirements = [f"{x.name}{x.specifier}" for x in parse_requirements(file) if x.name not in exclude] - elif isinstance(requirements, str): - requirements = [requirements] - - pkgs = [] - for r in requirements: - r_stripped = r.split("/")[-1].replace(".git", "") # replace git+https://org/repo.git -> 'repo' - match = re.match(r"([a-zA-Z0-9-_]+)([<>!=~]+.*)?", r_stripped) - name, required = match[1], match[2].strip() if match[2] else "" - try: - assert check_version(metadata.version(name), required) # exception if requirements not met - except (AssertionError, metadata.PackageNotFoundError): - pkgs.append(r) - - s = " ".join(f'"{x}"' for x in pkgs) # console string - if s: - if install and AUTOINSTALL: # check environment variable - n = len(pkgs) # number of packages updates - LOGGER.info(f"{prefix} Ultralytics requirement{'s' * (n > 1)} {pkgs} not found, attempting AutoUpdate...") - try: - t = time.time() - assert is_online(), "AutoUpdate skipped (offline)" - LOGGER.info(subprocess.check_output(f"pip install --no-cache {s} {cmds}", shell=True).decode()) - dt = time.time() - t - LOGGER.info( - f"{prefix} AutoUpdate success ✅ {dt:.1f}s, installed {n} package{'s' * (n > 1)}: {pkgs}\n" - f"{prefix} ⚠️ {colorstr('bold', 'Restart runtime or rerun command for updates to take effect')}\n" - ) - except Exception as e: - LOGGER.warning(f"{prefix} ❌ {e}") - return False - else: - return False - - return True - - -def check_torchvision(): - """ - Checks the installed versions of PyTorch and Torchvision to ensure they're compatible. - - This function checks the installed versions of PyTorch and Torchvision, and warns if they're incompatible according - to the provided compatibility table based on: - https://github.com/pytorch/vision#installation. - - The compatibility table is a dictionary where the keys are PyTorch versions and the values are lists of compatible - Torchvision versions. - """ - - import torchvision - - # Compatibility table - compatibility_table = {"2.0": ["0.15"], "1.13": ["0.14"], "1.12": ["0.13"]} - - # Extract only the major and minor versions - v_torch = ".".join(torch.__version__.split("+")[0].split(".")[:2]) - v_torchvision = ".".join(torchvision.__version__.split("+")[0].split(".")[:2]) - - if v_torch in compatibility_table: - compatible_versions = compatibility_table[v_torch] - if all(v_torchvision != v for v in compatible_versions): - print( - f"WARNING ⚠️ torchvision=={v_torchvision} is incompatible with torch=={v_torch}.\n" - f"Run 'pip install torchvision=={compatible_versions[0]}' to fix torchvision or " - "'pip install -U torch torchvision' to update both.\n" - "For a full compatibility table see https://github.com/pytorch/vision#installation" - ) - - -def check_suffix(file="yolov8n.pt", suffix=".pt", msg=""): - """Check file(s) for acceptable suffix.""" - if file and suffix: - if isinstance(suffix, str): - suffix = (suffix,) - for f in file if isinstance(file, (list, tuple)) else [file]: - s = Path(f).suffix.lower().strip() # file suffix - if len(s): - assert s in suffix, f"{msg}{f} acceptable suffix is {suffix}, not {s}" - - -def check_yolov5u_filename(file: str, verbose: bool = True): - """Replace legacy YOLOv5 filenames with updated YOLOv5u filenames.""" - if "yolov3" in file or "yolov5" in file: - if "u.yaml" in file: - file = file.replace("u.yaml", ".yaml") # i.e. yolov5nu.yaml -> yolov5n.yaml - elif ".pt" in file and "u" not in file: - original_file = file - file = re.sub(r"(.*yolov5([nsmlx]))\.pt", "\\1u.pt", file) # i.e. yolov5n.pt -> yolov5nu.pt - file = re.sub(r"(.*yolov5([nsmlx])6)\.pt", "\\1u.pt", file) # i.e. yolov5n6.pt -> yolov5n6u.pt - file = re.sub(r"(.*yolov3(|-tiny|-spp))\.pt", "\\1u.pt", file) # i.e. yolov3-spp.pt -> yolov3-sppu.pt - if file != original_file and verbose: - LOGGER.info( - f"PRO TIP 💡 Replace 'model={original_file}' with new 'model={file}'.\nYOLOv5 'u' models are " - f"trained with https://github.com/ultralytics/ultralytics and feature improved performance vs " - f"standard YOLOv5 models trained with https://github.com/ultralytics/yolov5.\n" - ) - return file - - -def check_model_file_from_stem(model="yolov8n"): - """Return a model filename from a valid model stem.""" - if model and not Path(model).suffix and Path(model).stem in downloads.GITHUB_ASSETS_STEMS: - return Path(model).with_suffix(".pt") # add suffix, i.e. yolov8n -> yolov8n.pt - else: - return model - - -def check_file(file, suffix="", download=True, hard=True): - """Search/download file (if necessary) and return path.""" - check_suffix(file, suffix) # optional - file = str(file).strip() # convert to string and strip spaces - file = check_yolov5u_filename(file) # yolov5n -> yolov5nu - if ( - not file - or ("://" not in file and Path(file).exists()) # '://' check required in Windows Python<3.10 - or file.lower().startswith("grpc://") - ): # file exists or gRPC Triton images - return file - elif download and file.lower().startswith(("https://", "http://", "rtsp://", "rtmp://", "tcp://")): # download - url = file # warning: Pathlib turns :// -> :/ - file = url2file(file) # '%2F' to '/', split https://url.com/file.txt?auth - if Path(file).exists(): - LOGGER.info(f"Found {clean_url(url)} locally at {file}") # file already exists - else: - downloads.safe_download(url=url, file=file, unzip=False) - return file - else: # search - files = glob.glob(str(ROOT / "**" / file), recursive=True) or glob.glob(str(ROOT.parent / file)) # find file - if not files and hard: - raise FileNotFoundError(f"'{file}' does not exist") - elif len(files) > 1 and hard: - raise FileNotFoundError(f"Multiple files match '{file}', specify exact path: {files}") - return files[0] if len(files) else [] # return file - - -def check_yaml(file, suffix=(".yaml", ".yml"), hard=True): - """Search/download YAML file (if necessary) and return path, checking suffix.""" - return check_file(file, suffix, hard=hard) - - -def check_is_path_safe(basedir, path): - """ - Check if the resolved path is under the intended directory to prevent path traversal. - - Args: - basedir (Path | str): The intended directory. - path (Path | str): The path to check. - - Returns: - (bool): True if the path is safe, False otherwise. - """ - base_dir_resolved = Path(basedir).resolve() - path_resolved = Path(path).resolve() - - return path_resolved.is_file() and path_resolved.parts[: len(base_dir_resolved.parts)] == base_dir_resolved.parts - - -def check_imshow(warn=False): - """Check if environment supports image displays.""" - try: - if LINUX: - assert "DISPLAY" in os.environ and not is_docker() and not is_colab() and not is_kaggle() - cv2.imshow("test", np.zeros((8, 8, 3), dtype=np.uint8)) # show a small 8-pixel image - cv2.waitKey(1) - cv2.destroyAllWindows() - cv2.waitKey(1) - return True - except Exception as e: - if warn: - LOGGER.warning(f"WARNING ⚠️ Environment does not support cv2.imshow() or PIL Image.show()\n{e}") - return False - - -def check_yolo(verbose=True, device=""): - """Return a human-readable YOLO software and hardware summary.""" - import psutil - - from ultralytics.utils.torch_utils import select_device - - if is_jupyter(): - if check_requirements("wandb", install=False): - os.system("pip uninstall -y wandb") # uninstall wandb: unwanted account creation prompt with infinite hang - if is_colab(): - shutil.rmtree("sample_data", ignore_errors=True) # remove colab /sample_data directory - - if verbose: - # System info - gib = 1 << 30 # bytes per GiB - ram = psutil.virtual_memory().total - total, used, free = shutil.disk_usage("/") - s = f"({os.cpu_count()} CPUs, {ram / gib:.1f} GB RAM, {(total - free) / gib:.1f}/{total / gib:.1f} GB disk)" - with contextlib.suppress(Exception): # clear display if ipython is installed - from IPython import display - - display.clear_output() - else: - s = "" - - select_device(device=device, newline=False) - LOGGER.info(f"Setup complete ✅ {s}") - - -def collect_system_info(): - """Collect and print relevant system information including OS, Python, RAM, CPU, and CUDA.""" - - import psutil - - from ultralytics.utils import ENVIRONMENT, is_git_dir - from ultralytics.utils.torch_utils import get_cpu_info - - ram_info = psutil.virtual_memory().total / (1024**3) # Convert bytes to GB - check_yolo() - LOGGER.info( - f"\n{'OS':<20}{platform.platform()}\n" - f"{'Environment':<20}{ENVIRONMENT}\n" - f"{'Python':<20}{PYTHON_VERSION}\n" - f"{'Install':<20}{'git' if is_git_dir() else 'pip' if is_pip_package() else 'other'}\n" - f"{'RAM':<20}{ram_info:.2f} GB\n" - f"{'CPU':<20}{get_cpu_info()}\n" - f"{'CUDA':<20}{torch.version.cuda if torch and torch.cuda.is_available() else None}\n" - ) - - for r in parse_requirements(package="ultralytics"): - try: - current = metadata.version(r.name) - is_met = "✅ " if check_version(current, str(r.specifier), hard=True) else "❌ " - except metadata.PackageNotFoundError: - current = "(not installed)" - is_met = "❌ " - LOGGER.info(f"{r.name:<20}{is_met}{current}{r.specifier}") - - if is_github_action_running(): - LOGGER.info( - f"\nRUNNER_OS: {os.getenv('RUNNER_OS')}\n" - f"GITHUB_EVENT_NAME: {os.getenv('GITHUB_EVENT_NAME')}\n" - f"GITHUB_WORKFLOW: {os.getenv('GITHUB_WORKFLOW')}\n" - f"GITHUB_ACTOR: {os.getenv('GITHUB_ACTOR')}\n" - f"GITHUB_REPOSITORY: {os.getenv('GITHUB_REPOSITORY')}\n" - f"GITHUB_REPOSITORY_OWNER: {os.getenv('GITHUB_REPOSITORY_OWNER')}\n" - ) - - -def check_amp(model): - """ - This function checks the PyTorch Automatic Mixed Precision (AMP) functionality of a YOLOv8 model. If the checks - fail, it means there are anomalies with AMP on the system that may cause NaN losses or zero-mAP results, so AMP will - be disabled during training. - - Args: - model (nn.Module): A YOLOv8 model instance. - - Example: - ```python - from ultralytics import YOLO - from ultralytics.utils.checks import check_amp - - model = YOLO('yolov8n.pt').model.cuda() - check_amp(model) - ``` - - Returns: - (bool): Returns True if the AMP functionality works correctly with YOLOv8 model, else False. - """ - device = next(model.parameters()).device # get model device - if device.type in ("cpu", "mps"): - return False # AMP only used on CUDA devices - - def amp_allclose(m, im): - """All close FP32 vs AMP results.""" - a = m(im, device=device, verbose=False)[0].boxes.data # FP32 inference - with torch.cuda.amp.autocast(True): - b = m(im, device=device, verbose=False)[0].boxes.data # AMP inference - del m - return a.shape == b.shape and torch.allclose(a, b.float(), atol=0.5) # close to 0.5 absolute tolerance - - im = ASSETS / "bus.jpg" # image to check - prefix = colorstr("AMP: ") - LOGGER.info(f"{prefix}running Automatic Mixed Precision (AMP) checks with YOLOv8n...") - warning_msg = "Setting 'amp=True'. If you experience zero-mAP or NaN losses you can disable AMP with amp=False." - try: - from ultralytics import YOLO - - assert amp_allclose(YOLO("yolov8n.pt"), im) - LOGGER.info(f"{prefix}checks passed ✅") - except ConnectionError: - LOGGER.warning(f"{prefix}checks skipped ⚠️, offline and unable to download YOLOv8n. {warning_msg}") - except (AttributeError, ModuleNotFoundError): - LOGGER.warning( - f"{prefix}checks skipped ⚠️. " - f"Unable to load YOLOv8n due to possible Ultralytics package modifications. {warning_msg}" - ) - except AssertionError: - LOGGER.warning( - f"{prefix}checks failed ❌. Anomalies were detected with AMP on your system that may lead to " - f"NaN losses or zero-mAP results, so AMP will be disabled during training." - ) - return False - return True - - -def git_describe(path=ROOT): # path must be a directory - """Return human-readable git description, i.e. v5.0-5-g3e25f1e https://git-scm.com/docs/git-describe.""" - with contextlib.suppress(Exception): - return subprocess.check_output(f"git -C {path} describe --tags --long --always", shell=True).decode()[:-1] - return "" - - -def print_args(args: Optional[dict] = None, show_file=True, show_func=False): - """Print function arguments (optional args dict).""" - - def strip_auth(v): - """Clean longer Ultralytics HUB URLs by stripping potential authentication information.""" - return clean_url(v) if (isinstance(v, str) and v.startswith("http") and len(v) > 100) else v - - x = inspect.currentframe().f_back # previous frame - file, _, func, _, _ = inspect.getframeinfo(x) - if args is None: # get args automatically - args, _, _, frm = inspect.getargvalues(x) - args = {k: v for k, v in frm.items() if k in args} - try: - file = Path(file).resolve().relative_to(ROOT).with_suffix("") - except ValueError: - file = Path(file).stem - s = (f"{file}: " if show_file else "") + (f"{func}: " if show_func else "") - LOGGER.info(colorstr(s) + ", ".join(f"{k}={strip_auth(v)}" for k, v in args.items())) - - -def cuda_device_count() -> int: - """ - Get the number of NVIDIA GPUs available in the environment. - - Returns: - (int): The number of NVIDIA GPUs available. - """ - try: - # Run the nvidia-smi command and capture its output - output = subprocess.check_output( - ["nvidia-smi", "--query-gpu=count", "--format=csv,noheader,nounits"], encoding="utf-8" - ) - - # Take the first line and strip any leading/trailing white space - first_line = output.strip().split("\n")[0] - - return int(first_line) - except (subprocess.CalledProcessError, FileNotFoundError, ValueError): - # If the command fails, nvidia-smi is not found, or output is not an integer, assume no GPUs are available - return 0 - - -def cuda_is_available() -> bool: - """ - Check if CUDA is available in the environment. - - Returns: - (bool): True if one or more NVIDIA GPUs are available, False otherwise. - """ - return cuda_device_count() > 0 - - -# Define constants -IS_PYTHON_3_12 = check_version(PYTHON_VERSION, "==3.12", name="Python ", hard=False) diff --git a/ultralytics-main/ultralytics/utils/dist.py b/ultralytics-main/ultralytics/utils/dist.py deleted file mode 100644 index b669e52..0000000 --- a/ultralytics-main/ultralytics/utils/dist.py +++ /dev/null @@ -1,71 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import os -import shutil -import socket -import sys -import tempfile - -from . import USER_CONFIG_DIR -from .torch_utils import TORCH_1_9 - - -def find_free_network_port() -> int: - """ - Finds a free port on localhost. - - It is useful in single-node training when we don't want to connect to a real main node but have to set the - `MASTER_PORT` environment variable. - """ - with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s: - s.bind(("127.0.0.1", 0)) - return s.getsockname()[1] # port - - -def generate_ddp_file(trainer): - """Generates a DDP file and returns its file name.""" - module, name = f"{trainer.__class__.__module__}.{trainer.__class__.__name__}".rsplit(".", 1) - - content = f""" -# Ultralytics Multi-GPU training temp file (should be automatically deleted after use) -overrides = {vars(trainer.args)} - -if __name__ == "__main__": - from {module} import {name} - from ultralytics.utils import DEFAULT_CFG_DICT - - cfg = DEFAULT_CFG_DICT.copy() - cfg.update(save_dir='') # handle the extra key 'save_dir' - trainer = {name}(cfg=cfg, overrides=overrides) - results = trainer.train() -""" - (USER_CONFIG_DIR / "DDP").mkdir(exist_ok=True) - with tempfile.NamedTemporaryFile( - prefix="_temp_", - suffix=f"{id(trainer)}.py", - mode="w+", - encoding="utf-8", - dir=USER_CONFIG_DIR / "DDP", - delete=False, - ) as file: - file.write(content) - return file.name - - -def generate_ddp_command(world_size, trainer): - """Generates and returns command for distributed training.""" - import __main__ # noqa local import to avoid https://github.com/Lightning-AI/lightning/issues/15218 - - if not trainer.resume: - shutil.rmtree(trainer.save_dir) # remove the save_dir - file = generate_ddp_file(trainer) - dist_cmd = "torch.distributed.run" if TORCH_1_9 else "torch.distributed.launch" - port = find_free_network_port() - cmd = [sys.executable, "-m", dist_cmd, "--nproc_per_node", f"{world_size}", "--master_port", f"{port}", file] - return cmd, file - - -def ddp_cleanup(trainer, file): - """Delete temp file if created.""" - if f"{id(trainer)}.py" in file: # if temp_file suffix in file - os.remove(file) diff --git a/ultralytics-main/ultralytics/utils/downloads.py b/ultralytics-main/ultralytics/utils/downloads.py deleted file mode 100644 index c9c33a8..0000000 --- a/ultralytics-main/ultralytics/utils/downloads.py +++ /dev/null @@ -1,500 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import contextlib -import re -import shutil -import subprocess -from itertools import repeat -from multiprocessing.pool import ThreadPool -from pathlib import Path -from urllib import parse, request - -import requests -import torch - -from ultralytics.utils import LOGGER, TQDM, checks, clean_url, emojis, is_online, url2file - -# Define Ultralytics GitHub assets maintained at https://github.com/ultralytics/assets -GITHUB_ASSETS_REPO = "ultralytics/assets" -GITHUB_ASSETS_NAMES = ( - [f"yolov8{k}{suffix}.pt" for k in "nsmlx" for suffix in ("", "-cls", "-seg", "-pose", "-obb")] - + [f"yolov5{k}{resolution}u.pt" for k in "nsmlx" for resolution in ("", "6")] - + [f"yolov3{k}u.pt" for k in ("", "-spp", "-tiny")] - + [f"yolov8{k}-world.pt" for k in "smlx"] - + [f"yolov8{k}-worldv2.pt" for k in "smlx"] - + [f"yolov9{k}.pt" for k in "ce"] - + [f"yolo_nas_{k}.pt" for k in "sml"] - + [f"sam_{k}.pt" for k in "bl"] - + [f"FastSAM-{k}.pt" for k in "sx"] - + [f"rtdetr-{k}.pt" for k in "lx"] - + ["mobile_sam.pt"] - + ["calibration_image_sample_data_20x128x128x3_float32.npy.zip"] -) -GITHUB_ASSETS_STEMS = [Path(k).stem for k in GITHUB_ASSETS_NAMES] - - -def is_url(url, check=True): - """ - Validates if the given string is a URL and optionally checks if the URL exists online. - - Args: - url (str): The string to be validated as a URL. - check (bool, optional): If True, performs an additional check to see if the URL exists online. - Defaults to True. - - Returns: - (bool): Returns True for a valid URL. If 'check' is True, also returns True if the URL exists online. - Returns False otherwise. - - Example: - ```python - valid = is_url("https://www.example.com") - ``` - """ - with contextlib.suppress(Exception): - url = str(url) - result = parse.urlparse(url) - assert all([result.scheme, result.netloc]) # check if is url - if check: - with request.urlopen(url) as response: - return response.getcode() == 200 # check if exists online - return True - return False - - -def delete_dsstore(path, files_to_delete=(".DS_Store", "__MACOSX")): - """ - Deletes all ".DS_store" files under a specified directory. - - Args: - path (str, optional): The directory path where the ".DS_store" files should be deleted. - files_to_delete (tuple): The files to be deleted. - - Example: - ```python - from ultralytics.utils.downloads import delete_dsstore - - delete_dsstore('path/to/dir') - ``` - - Note: - ".DS_store" files are created by the Apple operating system and contain metadata about folders and files. They - are hidden system files and can cause issues when transferring files between different operating systems. - """ - for file in files_to_delete: - matches = list(Path(path).rglob(file)) - LOGGER.info(f"Deleting {file} files: {matches}") - for f in matches: - f.unlink() - - -def zip_directory(directory, compress=True, exclude=(".DS_Store", "__MACOSX"), progress=True): - """ - Zips the contents of a directory, excluding files containing strings in the exclude list. The resulting zip file is - named after the directory and placed alongside it. - - Args: - directory (str | Path): The path to the directory to be zipped. - compress (bool): Whether to compress the files while zipping. Default is True. - exclude (tuple, optional): A tuple of filename strings to be excluded. Defaults to ('.DS_Store', '__MACOSX'). - progress (bool, optional): Whether to display a progress bar. Defaults to True. - - Returns: - (Path): The path to the resulting zip file. - - Example: - ```python - from ultralytics.utils.downloads import zip_directory - - file = zip_directory('path/to/dir') - ``` - """ - from zipfile import ZIP_DEFLATED, ZIP_STORED, ZipFile - - delete_dsstore(directory) - directory = Path(directory) - if not directory.is_dir(): - raise FileNotFoundError(f"Directory '{directory}' does not exist.") - - # Unzip with progress bar - files_to_zip = [f for f in directory.rglob("*") if f.is_file() and all(x not in f.name for x in exclude)] - zip_file = directory.with_suffix(".zip") - compression = ZIP_DEFLATED if compress else ZIP_STORED - with ZipFile(zip_file, "w", compression) as f: - for file in TQDM(files_to_zip, desc=f"Zipping {directory} to {zip_file}...", unit="file", disable=not progress): - f.write(file, file.relative_to(directory)) - - return zip_file # return path to zip file - - -def unzip_file(file, path=None, exclude=(".DS_Store", "__MACOSX"), exist_ok=False, progress=True): - """ - Unzips a *.zip file to the specified path, excluding files containing strings in the exclude list. - - If the zipfile does not contain a single top-level directory, the function will create a new - directory with the same name as the zipfile (without the extension) to extract its contents. - If a path is not provided, the function will use the parent directory of the zipfile as the default path. - - Args: - file (str): The path to the zipfile to be extracted. - path (str, optional): The path to extract the zipfile to. Defaults to None. - exclude (tuple, optional): A tuple of filename strings to be excluded. Defaults to ('.DS_Store', '__MACOSX'). - exist_ok (bool, optional): Whether to overwrite existing contents if they exist. Defaults to False. - progress (bool, optional): Whether to display a progress bar. Defaults to True. - - Raises: - BadZipFile: If the provided file does not exist or is not a valid zipfile. - - Returns: - (Path): The path to the directory where the zipfile was extracted. - - Example: - ```python - from ultralytics.utils.downloads import unzip_file - - dir = unzip_file('path/to/file.zip') - ``` - """ - from zipfile import BadZipFile, ZipFile, is_zipfile - - if not (Path(file).exists() and is_zipfile(file)): - raise BadZipFile(f"File '{file}' does not exist or is a bad zip file.") - if path is None: - path = Path(file).parent # default path - - # Unzip the file contents - with ZipFile(file) as zipObj: - files = [f for f in zipObj.namelist() if all(x not in f for x in exclude)] - top_level_dirs = {Path(f).parts[0] for f in files} - - if len(top_level_dirs) > 1 or (len(files) > 1 and not files[0].endswith("/")): - # Zip has multiple files at top level - path = extract_path = Path(path) / Path(file).stem # i.e. ../datasets/coco8 - else: - # Zip has 1 top-level directory - extract_path = path # i.e. ../datasets - path = Path(path) / list(top_level_dirs)[0] # i.e. ../datasets/coco8 - - # Check if destination directory already exists and contains files - if path.exists() and any(path.iterdir()) and not exist_ok: - # If it exists and is not empty, return the path without unzipping - LOGGER.warning(f"WARNING ⚠️ Skipping {file} unzip as destination directory {path} is not empty.") - return path - - for f in TQDM(files, desc=f"Unzipping {file} to {Path(path).resolve()}...", unit="file", disable=not progress): - # Ensure the file is within the extract_path to avoid path traversal security vulnerability - if ".." in Path(f).parts: - LOGGER.warning(f"Potentially insecure file path: {f}, skipping extraction.") - continue - zipObj.extract(f, extract_path) - - return path # return unzip dir - - -def check_disk_space(url="https://ultralytics.com/assets/coco128.zip", path=Path.cwd(), sf=1.5, hard=True): - """ - Check if there is sufficient disk space to download and store a file. - - Args: - url (str, optional): The URL to the file. Defaults to 'https://ultralytics.com/assets/coco128.zip'. - path (str | Path, optional): The path or drive to check the available free space on. - sf (float, optional): Safety factor, the multiplier for the required free space. Defaults to 2.0. - hard (bool, optional): Whether to throw an error or not on insufficient disk space. Defaults to True. - - Returns: - (bool): True if there is sufficient disk space, False otherwise. - """ - try: - r = requests.head(url) # response - assert r.status_code < 400, f"URL error for {url}: {r.status_code} {r.reason}" # check response - except Exception: - return True # requests issue, default to True - - # Check file size - gib = 1 << 30 # bytes per GiB - data = int(r.headers.get("Content-Length", 0)) / gib # file size (GB) - total, used, free = (x / gib for x in shutil.disk_usage(path)) # bytes - - if data * sf < free: - return True # sufficient space - - # Insufficient space - text = ( - f"WARNING ⚠️ Insufficient free disk space {free:.1f} GB < {data * sf:.3f} GB required, " - f"Please free {data * sf - free:.1f} GB additional disk space and try again." - ) - if hard: - raise MemoryError(text) - LOGGER.warning(text) - return False - - -def get_google_drive_file_info(link): - """ - Retrieves the direct download link and filename for a shareable Google Drive file link. - - Args: - link (str): The shareable link of the Google Drive file. - - Returns: - (str): Direct download URL for the Google Drive file. - (str): Original filename of the Google Drive file. If filename extraction fails, returns None. - - Example: - ```python - from ultralytics.utils.downloads import get_google_drive_file_info - - link = "https://drive.google.com/file/d/1cqT-cJgANNrhIHCrEufUYhQ4RqiWG_lJ/view?usp=drive_link" - url, filename = get_google_drive_file_info(link) - ``` - """ - file_id = link.split("/d/")[1].split("/view")[0] - drive_url = f"https://drive.google.com/uc?export=download&id={file_id}" - filename = None - - # Start session - with requests.Session() as session: - response = session.get(drive_url, stream=True) - if "quota exceeded" in str(response.content.lower()): - raise ConnectionError( - emojis( - f"❌ Google Drive file download quota exceeded. " - f"Please try again later or download this file manually at {link}." - ) - ) - for k, v in response.cookies.items(): - if k.startswith("download_warning"): - drive_url += f"&confirm={v}" # v is token - cd = response.headers.get("content-disposition") - if cd: - filename = re.findall('filename="(.+)"', cd)[0] - return drive_url, filename - - -def safe_download( - url, - file=None, - dir=None, - unzip=True, - delete=False, - curl=False, - retry=3, - min_bytes=1e0, - exist_ok=False, - progress=True, -): - """ - Downloads files from a URL, with options for retrying, unzipping, and deleting the downloaded file. - - Args: - url (str): The URL of the file to be downloaded. - file (str, optional): The filename of the downloaded file. - If not provided, the file will be saved with the same name as the URL. - dir (str, optional): The directory to save the downloaded file. - If not provided, the file will be saved in the current working directory. - unzip (bool, optional): Whether to unzip the downloaded file. Default: True. - delete (bool, optional): Whether to delete the downloaded file after unzipping. Default: False. - curl (bool, optional): Whether to use curl command line tool for downloading. Default: False. - retry (int, optional): The number of times to retry the download in case of failure. Default: 3. - min_bytes (float, optional): The minimum number of bytes that the downloaded file should have, to be considered - a successful download. Default: 1E0. - exist_ok (bool, optional): Whether to overwrite existing contents during unzipping. Defaults to False. - progress (bool, optional): Whether to display a progress bar during the download. Default: True. - - Example: - ```python - from ultralytics.utils.downloads import safe_download - - link = "https://ultralytics.com/assets/bus.jpg" - path = safe_download(link) - ``` - """ - gdrive = url.startswith("https://drive.google.com/") # check if the URL is a Google Drive link - if gdrive: - url, file = get_google_drive_file_info(url) - - f = Path(dir or ".") / (file or url2file(url)) # URL converted to filename - if "://" not in str(url) and Path(url).is_file(): # URL exists ('://' check required in Windows Python<3.10) - f = Path(url) # filename - elif not f.is_file(): # URL and file do not exist - desc = f"Downloading {url if gdrive else clean_url(url)} to '{f}'" - LOGGER.info(f"{desc}...") - f.parent.mkdir(parents=True, exist_ok=True) # make directory if missing - check_disk_space(url, path=f.parent) - for i in range(retry + 1): - try: - if curl or i > 0: # curl download with retry, continue - s = "sS" * (not progress) # silent - r = subprocess.run(["curl", "-#", f"-{s}L", url, "-o", f, "--retry", "3", "-C", "-"]).returncode - assert r == 0, f"Curl return value {r}" - else: # urllib download - method = "torch" - if method == "torch": - torch.hub.download_url_to_file(url, f, progress=progress) - else: - with request.urlopen(url) as response, TQDM( - total=int(response.getheader("Content-Length", 0)), - desc=desc, - disable=not progress, - unit="B", - unit_scale=True, - unit_divisor=1024, - ) as pbar: - with open(f, "wb") as f_opened: - for data in response: - f_opened.write(data) - pbar.update(len(data)) - - if f.exists(): - if f.stat().st_size > min_bytes: - break # success - f.unlink() # remove partial downloads - except Exception as e: - if i == 0 and not is_online(): - raise ConnectionError(emojis(f"❌ Download failure for {url}. Environment is not online.")) from e - elif i >= retry: - raise ConnectionError(emojis(f"❌ Download failure for {url}. Retry limit reached.")) from e - LOGGER.warning(f"⚠️ Download failure, retrying {i + 1}/{retry} {url}...") - - if unzip and f.exists() and f.suffix in ("", ".zip", ".tar", ".gz"): - from zipfile import is_zipfile - - unzip_dir = (dir or f.parent).resolve() # unzip to dir if provided else unzip in place - if is_zipfile(f): - unzip_dir = unzip_file(file=f, path=unzip_dir, exist_ok=exist_ok, progress=progress) # unzip - elif f.suffix in (".tar", ".gz"): - LOGGER.info(f"Unzipping {f} to {unzip_dir}...") - subprocess.run(["tar", "xf" if f.suffix == ".tar" else "xfz", f, "--directory", unzip_dir], check=True) - if delete: - f.unlink() # remove zip - return unzip_dir - - -def get_github_assets(repo="ultralytics/assets", version="latest", retry=False): - """ - Retrieve the specified version's tag and assets from a GitHub repository. If the version is not specified, the - function fetches the latest release assets. - - Args: - repo (str, optional): The GitHub repository in the format 'owner/repo'. Defaults to 'ultralytics/assets'. - version (str, optional): The release version to fetch assets from. Defaults to 'latest'. - retry (bool, optional): Flag to retry the request in case of a failure. Defaults to False. - - Returns: - (tuple): A tuple containing the release tag and a list of asset names. - - Example: - ```python - tag, assets = get_github_assets(repo='ultralytics/assets', version='latest') - ``` - """ - - if version != "latest": - version = f"tags/{version}" # i.e. tags/v6.2 - url = f"https://api.github.com/repos/{repo}/releases/{version}" - r = requests.get(url) # github api - if r.status_code != 200 and r.reason != "rate limit exceeded" and retry: # failed and not 403 rate limit exceeded - r = requests.get(url) # try again - if r.status_code != 200: - LOGGER.warning(f"⚠️ GitHub assets check failure for {url}: {r.status_code} {r.reason}") - return "", [] - data = r.json() - return data["tag_name"], [x["name"] for x in data["assets"]] # tag, assets i.e. ['yolov8n.pt', 'yolov8s.pt', ...] - - -def attempt_download_asset(file, repo="ultralytics/assets", release="v8.1.0", **kwargs): - """ - Attempt to download a file from GitHub release assets if it is not found locally. The function checks for the file - locally first, then tries to download it from the specified GitHub repository release. - - Args: - file (str | Path): The filename or file path to be downloaded. - repo (str, optional): The GitHub repository in the format 'owner/repo'. Defaults to 'ultralytics/assets'. - release (str, optional): The specific release version to be downloaded. Defaults to 'v8.1.0'. - **kwargs (any): Additional keyword arguments for the download process. - - Returns: - (str): The path to the downloaded file. - - Example: - ```python - file_path = attempt_download_asset('yolov5s.pt', repo='ultralytics/assets', release='latest') - ``` - """ - from ultralytics.utils import SETTINGS # scoped for circular import - - # YOLOv3/5u updates - file = str(file) - file = checks.check_yolov5u_filename(file) - file = Path(file.strip().replace("'", "")) - if file.exists(): - return str(file) - elif (SETTINGS["weights_dir"] / file).exists(): - return str(SETTINGS["weights_dir"] / file) - else: - # URL specified - name = Path(parse.unquote(str(file))).name # decode '%2F' to '/' etc. - download_url = f"https://github.com/{repo}/releases/download" - if str(file).startswith(("http:/", "https:/")): # download - url = str(file).replace(":/", "://") # Pathlib turns :// -> :/ - file = url2file(name) # parse authentication https://url.com/file.txt?auth... - if Path(file).is_file(): - LOGGER.info(f"Found {clean_url(url)} locally at {file}") # file already exists - else: - safe_download(url=url, file=file, min_bytes=1e5, **kwargs) - - elif repo == GITHUB_ASSETS_REPO and name in GITHUB_ASSETS_NAMES: - safe_download(url=f"{download_url}/{release}/{name}", file=file, min_bytes=1e5, **kwargs) - - else: - tag, assets = get_github_assets(repo, release) - if not assets: - tag, assets = get_github_assets(repo) # latest release - if name in assets: - safe_download(url=f"{download_url}/{tag}/{name}", file=file, min_bytes=1e5, **kwargs) - - return str(file) - - -def download(url, dir=Path.cwd(), unzip=True, delete=False, curl=False, threads=1, retry=3, exist_ok=False): - """ - Downloads files from specified URLs to a given directory. Supports concurrent downloads if multiple threads are - specified. - - Args: - url (str | list): The URL or list of URLs of the files to be downloaded. - dir (Path, optional): The directory where the files will be saved. Defaults to the current working directory. - unzip (bool, optional): Flag to unzip the files after downloading. Defaults to True. - delete (bool, optional): Flag to delete the zip files after extraction. Defaults to False. - curl (bool, optional): Flag to use curl for downloading. Defaults to False. - threads (int, optional): Number of threads to use for concurrent downloads. Defaults to 1. - retry (int, optional): Number of retries in case of download failure. Defaults to 3. - exist_ok (bool, optional): Whether to overwrite existing contents during unzipping. Defaults to False. - - Example: - ```python - download('https://ultralytics.com/assets/example.zip', dir='path/to/dir', unzip=True) - ``` - """ - dir = Path(dir) - dir.mkdir(parents=True, exist_ok=True) # make directory - if threads > 1: - with ThreadPool(threads) as pool: - pool.map( - lambda x: safe_download( - url=x[0], - dir=x[1], - unzip=unzip, - delete=delete, - curl=curl, - retry=retry, - exist_ok=exist_ok, - progress=threads <= 1, - ), - zip(url, repeat(dir)), - ) - pool.close() - pool.join() - else: - for u in [url] if isinstance(url, (str, Path)) else url: - safe_download(url=u, dir=dir, unzip=unzip, delete=delete, curl=curl, retry=retry, exist_ok=exist_ok) diff --git a/ultralytics-main/ultralytics/utils/errors.py b/ultralytics-main/ultralytics/utils/errors.py deleted file mode 100644 index 86aee1d..0000000 --- a/ultralytics-main/ultralytics/utils/errors.py +++ /dev/null @@ -1,22 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from ultralytics.utils import emojis - - -class HUBModelError(Exception): - """ - Custom exception class for handling errors related to model fetching in Ultralytics YOLO. - - This exception is raised when a requested model is not found or cannot be retrieved. - The message is also processed to include emojis for better user experience. - - Attributes: - message (str): The error message displayed when the exception is raised. - - Note: - The message is automatically processed through the 'emojis' function from the 'ultralytics.utils' package. - """ - - def __init__(self, message="Model not found. Please check model URL and try again."): - """Create an exception for when a model is not found.""" - super().__init__(emojis(message)) diff --git a/ultralytics-main/ultralytics/utils/files.py b/ultralytics-main/ultralytics/utils/files.py deleted file mode 100644 index 719caca..0000000 --- a/ultralytics-main/ultralytics/utils/files.py +++ /dev/null @@ -1,188 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import contextlib -import glob -import os -import shutil -import tempfile -from contextlib import contextmanager -from datetime import datetime -from pathlib import Path - - -class WorkingDirectory(contextlib.ContextDecorator): - """Usage: @WorkingDirectory(dir) decorator or 'with WorkingDirectory(dir):' context manager.""" - - def __init__(self, new_dir): - """Sets the working directory to 'new_dir' upon instantiation.""" - self.dir = new_dir # new dir - self.cwd = Path.cwd().resolve() # current dir - - def __enter__(self): - """Changes the current directory to the specified directory.""" - os.chdir(self.dir) - - def __exit__(self, exc_type, exc_val, exc_tb): # noqa - """Restore the current working directory on context exit.""" - os.chdir(self.cwd) - - -@contextmanager -def spaces_in_path(path): - """ - Context manager to handle paths with spaces in their names. If a path contains spaces, it replaces them with - underscores, copies the file/directory to the new path, executes the context code block, then copies the - file/directory back to its original location. - - Args: - path (str | Path): The original path. - - Yields: - (Path): Temporary path with spaces replaced by underscores if spaces were present, otherwise the original path. - - Example: - ```python - with ultralytics.utils.files import spaces_in_path - - with spaces_in_path('/path/with spaces') as new_path: - # Your code here - ``` - """ - - # If path has spaces, replace them with underscores - if " " in str(path): - string = isinstance(path, str) # input type - path = Path(path) - - # Create a temporary directory and construct the new path - with tempfile.TemporaryDirectory() as tmp_dir: - tmp_path = Path(tmp_dir) / path.name.replace(" ", "_") - - # Copy file/directory - if path.is_dir(): - # tmp_path.mkdir(parents=True, exist_ok=True) - shutil.copytree(path, tmp_path) - elif path.is_file(): - tmp_path.parent.mkdir(parents=True, exist_ok=True) - shutil.copy2(path, tmp_path) - - try: - # Yield the temporary path - yield str(tmp_path) if string else tmp_path - - finally: - # Copy file/directory back - if tmp_path.is_dir(): - shutil.copytree(tmp_path, path, dirs_exist_ok=True) - elif tmp_path.is_file(): - shutil.copy2(tmp_path, path) # Copy back the file - - else: - # If there are no spaces, just yield the original path - yield path - - -def increment_path(path, exist_ok=False, sep="", mkdir=False): - """ - Increments a file or directory path, i.e. runs/exp --> runs/exp{sep}2, runs/exp{sep}3, ... etc. - - If the path exists and exist_ok is not set to True, the path will be incremented by appending a number and sep to - the end of the path. If the path is a file, the file extension will be preserved. If the path is a directory, the - number will be appended directly to the end of the path. If mkdir is set to True, the path will be created as a - directory if it does not already exist. - - Args: - path (str, pathlib.Path): Path to increment. - exist_ok (bool, optional): If True, the path will not be incremented and returned as-is. Defaults to False. - sep (str, optional): Separator to use between the path and the incrementation number. Defaults to ''. - mkdir (bool, optional): Create a directory if it does not exist. Defaults to False. - - Returns: - (pathlib.Path): Incremented path. - """ - path = Path(path) # os-agnostic - if path.exists() and not exist_ok: - path, suffix = (path.with_suffix(""), path.suffix) if path.is_file() else (path, "") - - # Method 1 - for n in range(2, 9999): - p = f"{path}{sep}{n}{suffix}" # increment path - if not os.path.exists(p): - break - path = Path(p) - - if mkdir: - path.mkdir(parents=True, exist_ok=True) # make directory - - return path - - -def file_age(path=__file__): - """Return days since last file update.""" - dt = datetime.now() - datetime.fromtimestamp(Path(path).stat().st_mtime) # delta - return dt.days # + dt.seconds / 86400 # fractional days - - -def file_date(path=__file__): - """Return human-readable file modification date, i.e. '2021-3-26'.""" - t = datetime.fromtimestamp(Path(path).stat().st_mtime) - return f"{t.year}-{t.month}-{t.day}" - - -def file_size(path): - """Return file/dir size (MB).""" - if isinstance(path, (str, Path)): - mb = 1 << 20 # bytes to MiB (1024 ** 2) - path = Path(path) - if path.is_file(): - return path.stat().st_size / mb - elif path.is_dir(): - return sum(f.stat().st_size for f in path.glob("**/*") if f.is_file()) / mb - return 0.0 - - -def get_latest_run(search_dir="."): - """Return path to most recent 'last.pt' in /runs (i.e. to --resume from).""" - last_list = glob.glob(f"{search_dir}/**/last*.pt", recursive=True) - return max(last_list, key=os.path.getctime) if last_list else "" - - -def update_models(model_names=("yolov8n.pt",), source_dir=Path("."), update_names=False): - """ - Updates and re-saves specified YOLO models in an 'updated_models' subdirectory. - - Args: - model_names (tuple, optional): Model filenames to update, defaults to ("yolov8n.pt"). - source_dir (Path, optional): Directory containing models and target subdirectory, defaults to current directory. - update_names (bool, optional): Update model names from a data YAML. - - Example: - ```python - from ultralytics.utils.files import update_models - - model_names = (f"rtdetr-{size}.pt" for size in "lx") - update_models(model_names) - ``` - """ - from ultralytics import YOLO - from ultralytics.nn.autobackend import default_class_names - - target_dir = source_dir / "updated_models" - target_dir.mkdir(parents=True, exist_ok=True) # Ensure target directory exists - - for model_name in model_names: - model_path = source_dir / model_name - print(f"Loading model from {model_path}") - - # Load model - model = YOLO(model_path) - model.half() - if update_names: # update model names from a dataset YAML - model.model.names = default_class_names("coco8.yaml") - - # Define new save path - save_path = target_dir / model_name - - # Save model using model.save() - print(f"Re-saving {model_name} model to {save_path}") - model.save(save_path, use_dill=False) diff --git a/ultralytics-main/ultralytics/utils/instance.py b/ultralytics-main/ultralytics/utils/instance.py deleted file mode 100644 index 4e9ef2c..0000000 --- a/ultralytics-main/ultralytics/utils/instance.py +++ /dev/null @@ -1,407 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from collections import abc -from itertools import repeat -from numbers import Number -from typing import List - -import numpy as np - -from .ops import ltwh2xywh, ltwh2xyxy, xywh2ltwh, xywh2xyxy, xyxy2ltwh, xyxy2xywh - - -def _ntuple(n): - """From PyTorch internals.""" - - def parse(x): - """Parse bounding boxes format between XYWH and LTWH.""" - return x if isinstance(x, abc.Iterable) else tuple(repeat(x, n)) - - return parse - - -to_2tuple = _ntuple(2) -to_4tuple = _ntuple(4) - -# `xyxy` means left top and right bottom -# `xywh` means center x, center y and width, height(YOLO format) -# `ltwh` means left top and width, height(COCO format) -_formats = ["xyxy", "xywh", "ltwh"] - -__all__ = ("Bboxes",) # tuple or list - - -class Bboxes: - """ - A class for handling bounding boxes. - - The class supports various bounding box formats like 'xyxy', 'xywh', and 'ltwh'. - Bounding box data should be provided in numpy arrays. - - Attributes: - bboxes (numpy.ndarray): The bounding boxes stored in a 2D numpy array. - format (str): The format of the bounding boxes ('xyxy', 'xywh', or 'ltwh'). - - Note: - This class does not handle normalization or denormalization of bounding boxes. - """ - - def __init__(self, bboxes, format="xyxy") -> None: - """Initializes the Bboxes class with bounding box data in a specified format.""" - assert format in _formats, f"Invalid bounding box format: {format}, format must be one of {_formats}" - bboxes = bboxes[None, :] if bboxes.ndim == 1 else bboxes - assert bboxes.ndim == 2 - assert bboxes.shape[1] == 4 - self.bboxes = bboxes - self.format = format - # self.normalized = normalized - - def convert(self, format): - """Converts bounding box format from one type to another.""" - assert format in _formats, f"Invalid bounding box format: {format}, format must be one of {_formats}" - if self.format == format: - return - elif self.format == "xyxy": - func = xyxy2xywh if format == "xywh" else xyxy2ltwh - elif self.format == "xywh": - func = xywh2xyxy if format == "xyxy" else xywh2ltwh - else: - func = ltwh2xyxy if format == "xyxy" else ltwh2xywh - self.bboxes = func(self.bboxes) - self.format = format - - def areas(self): - """Return box areas.""" - self.convert("xyxy") - return (self.bboxes[:, 2] - self.bboxes[:, 0]) * (self.bboxes[:, 3] - self.bboxes[:, 1]) - - # def denormalize(self, w, h): - # if not self.normalized: - # return - # assert (self.bboxes <= 1.0).all() - # self.bboxes[:, 0::2] *= w - # self.bboxes[:, 1::2] *= h - # self.normalized = False - # - # def normalize(self, w, h): - # if self.normalized: - # return - # assert (self.bboxes > 1.0).any() - # self.bboxes[:, 0::2] /= w - # self.bboxes[:, 1::2] /= h - # self.normalized = True - - def mul(self, scale): - """ - Args: - scale (tuple | list | int): the scale for four coords. - """ - if isinstance(scale, Number): - scale = to_4tuple(scale) - assert isinstance(scale, (tuple, list)) - assert len(scale) == 4 - self.bboxes[:, 0] *= scale[0] - self.bboxes[:, 1] *= scale[1] - self.bboxes[:, 2] *= scale[2] - self.bboxes[:, 3] *= scale[3] - - def add(self, offset): - """ - Args: - offset (tuple | list | int): the offset for four coords. - """ - if isinstance(offset, Number): - offset = to_4tuple(offset) - assert isinstance(offset, (tuple, list)) - assert len(offset) == 4 - self.bboxes[:, 0] += offset[0] - self.bboxes[:, 1] += offset[1] - self.bboxes[:, 2] += offset[2] - self.bboxes[:, 3] += offset[3] - - def __len__(self): - """Return the number of boxes.""" - return len(self.bboxes) - - @classmethod - def concatenate(cls, boxes_list: List["Bboxes"], axis=0) -> "Bboxes": - """ - Concatenate a list of Bboxes objects into a single Bboxes object. - - Args: - boxes_list (List[Bboxes]): A list of Bboxes objects to concatenate. - axis (int, optional): The axis along which to concatenate the bounding boxes. - Defaults to 0. - - Returns: - Bboxes: A new Bboxes object containing the concatenated bounding boxes. - - Note: - The input should be a list or tuple of Bboxes objects. - """ - assert isinstance(boxes_list, (list, tuple)) - if not boxes_list: - return cls(np.empty(0)) - assert all(isinstance(box, Bboxes) for box in boxes_list) - - if len(boxes_list) == 1: - return boxes_list[0] - return cls(np.concatenate([b.bboxes for b in boxes_list], axis=axis)) - - def __getitem__(self, index) -> "Bboxes": - """ - Retrieve a specific bounding box or a set of bounding boxes using indexing. - - Args: - index (int, slice, or np.ndarray): The index, slice, or boolean array to select - the desired bounding boxes. - - Returns: - Bboxes: A new Bboxes object containing the selected bounding boxes. - - Raises: - AssertionError: If the indexed bounding boxes do not form a 2-dimensional matrix. - - Note: - When using boolean indexing, make sure to provide a boolean array with the same - length as the number of bounding boxes. - """ - if isinstance(index, int): - return Bboxes(self.bboxes[index].view(1, -1)) - b = self.bboxes[index] - assert b.ndim == 2, f"Indexing on Bboxes with {index} failed to return a matrix!" - return Bboxes(b) - - -class Instances: - """ - Container for bounding boxes, segments, and keypoints of detected objects in an image. - - Attributes: - _bboxes (Bboxes): Internal object for handling bounding box operations. - keypoints (ndarray): keypoints(x, y, visible) with shape [N, 17, 3]. Default is None. - normalized (bool): Flag indicating whether the bounding box coordinates are normalized. - segments (ndarray): Segments array with shape [N, 1000, 2] after resampling. - - Args: - bboxes (ndarray): An array of bounding boxes with shape [N, 4]. - segments (list | ndarray, optional): A list or array of object segments. Default is None. - keypoints (ndarray, optional): An array of keypoints with shape [N, 17, 3]. Default is None. - bbox_format (str, optional): The format of bounding boxes ('xywh' or 'xyxy'). Default is 'xywh'. - normalized (bool, optional): Whether the bounding box coordinates are normalized. Default is True. - - Examples: - ```python - # Create an Instances object - instances = Instances( - bboxes=np.array([[10, 10, 30, 30], [20, 20, 40, 40]]), - segments=[np.array([[5, 5], [10, 10]]), np.array([[15, 15], [20, 20]])], - keypoints=np.array([[[5, 5, 1], [10, 10, 1]], [[15, 15, 1], [20, 20, 1]]]) - ) - ``` - - Note: - The bounding box format is either 'xywh' or 'xyxy', and is determined by the `bbox_format` argument. - This class does not perform input validation, and it assumes the inputs are well-formed. - """ - - def __init__(self, bboxes, segments=None, keypoints=None, bbox_format="xywh", normalized=True) -> None: - """ - Args: - bboxes (ndarray): bboxes with shape [N, 4]. - segments (list | ndarray): segments. - keypoints (ndarray): keypoints(x, y, visible) with shape [N, 17, 3]. - """ - self._bboxes = Bboxes(bboxes=bboxes, format=bbox_format) - self.keypoints = keypoints - self.normalized = normalized - self.segments = segments - - def convert_bbox(self, format): - """Convert bounding box format.""" - self._bboxes.convert(format=format) - - @property - def bbox_areas(self): - """Calculate the area of bounding boxes.""" - return self._bboxes.areas() - - def scale(self, scale_w, scale_h, bbox_only=False): - """This might be similar with denormalize func but without normalized sign.""" - self._bboxes.mul(scale=(scale_w, scale_h, scale_w, scale_h)) - if bbox_only: - return - self.segments[..., 0] *= scale_w - self.segments[..., 1] *= scale_h - if self.keypoints is not None: - self.keypoints[..., 0] *= scale_w - self.keypoints[..., 1] *= scale_h - - def denormalize(self, w, h): - """Denormalizes boxes, segments, and keypoints from normalized coordinates.""" - if not self.normalized: - return - self._bboxes.mul(scale=(w, h, w, h)) - self.segments[..., 0] *= w - self.segments[..., 1] *= h - if self.keypoints is not None: - self.keypoints[..., 0] *= w - self.keypoints[..., 1] *= h - self.normalized = False - - def normalize(self, w, h): - """Normalize bounding boxes, segments, and keypoints to image dimensions.""" - if self.normalized: - return - self._bboxes.mul(scale=(1 / w, 1 / h, 1 / w, 1 / h)) - self.segments[..., 0] /= w - self.segments[..., 1] /= h - if self.keypoints is not None: - self.keypoints[..., 0] /= w - self.keypoints[..., 1] /= h - self.normalized = True - - def add_padding(self, padw, padh): - """Handle rect and mosaic situation.""" - assert not self.normalized, "you should add padding with absolute coordinates." - self._bboxes.add(offset=(padw, padh, padw, padh)) - self.segments[..., 0] += padw - self.segments[..., 1] += padh - if self.keypoints is not None: - self.keypoints[..., 0] += padw - self.keypoints[..., 1] += padh - - def __getitem__(self, index) -> "Instances": - """ - Retrieve a specific instance or a set of instances using indexing. - - Args: - index (int, slice, or np.ndarray): The index, slice, or boolean array to select - the desired instances. - - Returns: - Instances: A new Instances object containing the selected bounding boxes, - segments, and keypoints if present. - - Note: - When using boolean indexing, make sure to provide a boolean array with the same - length as the number of instances. - """ - segments = self.segments[index] if len(self.segments) else self.segments - keypoints = self.keypoints[index] if self.keypoints is not None else None - bboxes = self.bboxes[index] - bbox_format = self._bboxes.format - return Instances( - bboxes=bboxes, - segments=segments, - keypoints=keypoints, - bbox_format=bbox_format, - normalized=self.normalized, - ) - - def flipud(self, h): - """Flips the coordinates of bounding boxes, segments, and keypoints vertically.""" - if self._bboxes.format == "xyxy": - y1 = self.bboxes[:, 1].copy() - y2 = self.bboxes[:, 3].copy() - self.bboxes[:, 1] = h - y2 - self.bboxes[:, 3] = h - y1 - else: - self.bboxes[:, 1] = h - self.bboxes[:, 1] - self.segments[..., 1] = h - self.segments[..., 1] - if self.keypoints is not None: - self.keypoints[..., 1] = h - self.keypoints[..., 1] - - def fliplr(self, w): - """Reverses the order of the bounding boxes and segments horizontally.""" - if self._bboxes.format == "xyxy": - x1 = self.bboxes[:, 0].copy() - x2 = self.bboxes[:, 2].copy() - self.bboxes[:, 0] = w - x2 - self.bboxes[:, 2] = w - x1 - else: - self.bboxes[:, 0] = w - self.bboxes[:, 0] - self.segments[..., 0] = w - self.segments[..., 0] - if self.keypoints is not None: - self.keypoints[..., 0] = w - self.keypoints[..., 0] - - def clip(self, w, h): - """Clips bounding boxes, segments, and keypoints values to stay within image boundaries.""" - ori_format = self._bboxes.format - self.convert_bbox(format="xyxy") - self.bboxes[:, [0, 2]] = self.bboxes[:, [0, 2]].clip(0, w) - self.bboxes[:, [1, 3]] = self.bboxes[:, [1, 3]].clip(0, h) - if ori_format != "xyxy": - self.convert_bbox(format=ori_format) - self.segments[..., 0] = self.segments[..., 0].clip(0, w) - self.segments[..., 1] = self.segments[..., 1].clip(0, h) - if self.keypoints is not None: - self.keypoints[..., 0] = self.keypoints[..., 0].clip(0, w) - self.keypoints[..., 1] = self.keypoints[..., 1].clip(0, h) - - def remove_zero_area_boxes(self): - """ - Remove zero-area boxes, i.e. after clipping some boxes may have zero width or height. - - This removes them. - """ - good = self.bbox_areas > 0 - if not all(good): - self._bboxes = self._bboxes[good] - if len(self.segments): - self.segments = self.segments[good] - if self.keypoints is not None: - self.keypoints = self.keypoints[good] - return good - - def update(self, bboxes, segments=None, keypoints=None): - """Updates instance variables.""" - self._bboxes = Bboxes(bboxes, format=self._bboxes.format) - if segments is not None: - self.segments = segments - if keypoints is not None: - self.keypoints = keypoints - - def __len__(self): - """Return the length of the instance list.""" - return len(self.bboxes) - - @classmethod - def concatenate(cls, instances_list: List["Instances"], axis=0) -> "Instances": - """ - Concatenates a list of Instances objects into a single Instances object. - - Args: - instances_list (List[Instances]): A list of Instances objects to concatenate. - axis (int, optional): The axis along which the arrays will be concatenated. Defaults to 0. - - Returns: - Instances: A new Instances object containing the concatenated bounding boxes, - segments, and keypoints if present. - - Note: - The `Instances` objects in the list should have the same properties, such as - the format of the bounding boxes, whether keypoints are present, and if the - coordinates are normalized. - """ - assert isinstance(instances_list, (list, tuple)) - if not instances_list: - return cls(np.empty(0)) - assert all(isinstance(instance, Instances) for instance in instances_list) - - if len(instances_list) == 1: - return instances_list[0] - - use_keypoint = instances_list[0].keypoints is not None - bbox_format = instances_list[0]._bboxes.format - normalized = instances_list[0].normalized - - cat_boxes = np.concatenate([ins.bboxes for ins in instances_list], axis=axis) - cat_segments = np.concatenate([b.segments for b in instances_list], axis=axis) - cat_keypoints = np.concatenate([b.keypoints for b in instances_list], axis=axis) if use_keypoint else None - return cls(cat_boxes, cat_segments, cat_keypoints, bbox_format, normalized) - - @property - def bboxes(self): - """Return bounding boxes.""" - return self._bboxes.bboxes diff --git a/ultralytics-main/ultralytics/utils/loss.py b/ultralytics-main/ultralytics/utils/loss.py deleted file mode 100644 index 360a292..0000000 --- a/ultralytics-main/ultralytics/utils/loss.py +++ /dev/null @@ -1,715 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import torch -import torch.nn as nn -import torch.nn.functional as F - -from ultralytics.utils.metrics import OKS_SIGMA -from ultralytics.utils.ops import crop_mask, xywh2xyxy, xyxy2xywh -from ultralytics.utils.tal import RotatedTaskAlignedAssigner, TaskAlignedAssigner, dist2bbox, dist2rbox, make_anchors -from .metrics import bbox_iou, probiou -from .tal import bbox2dist - - -class VarifocalLoss(nn.Module): - """ - Varifocal loss by Zhang et al. - - https://arxiv.org/abs/2008.13367. - """ - - def __init__(self): - """Initialize the VarifocalLoss class.""" - super().__init__() - - @staticmethod - def forward(pred_score, gt_score, label, alpha=0.75, gamma=2.0): - """Computes varfocal loss.""" - weight = alpha * pred_score.sigmoid().pow(gamma) * (1 - label) + gt_score * label - with torch.cuda.amp.autocast(enabled=False): - loss = ( - (F.binary_cross_entropy_with_logits(pred_score.float(), gt_score.float(), reduction="none") * weight) - .mean(1) - .sum() - ) - return loss - - -class FocalLoss(nn.Module): - """Wraps focal loss around existing loss_fcn(), i.e. criteria = FocalLoss(nn.BCEWithLogitsLoss(), gamma=1.5).""" - - def __init__(self): - """Initializer for FocalLoss class with no parameters.""" - super().__init__() - - @staticmethod - def forward(pred, label, gamma=1.5, alpha=0.25): - """Calculates and updates confusion matrix for object detection/classification tasks.""" - loss = F.binary_cross_entropy_with_logits(pred, label, reduction="none") - # p_t = torch.exp(-loss) - # loss *= self.alpha * (1.000001 - p_t) ** self.gamma # non-zero power for gradient stability - - # TF implementation https://github.com/tensorflow/addons/blob/v0.7.1/tensorflow_addons/losses/focal_loss.py - pred_prob = pred.sigmoid() # prob from logits - p_t = label * pred_prob + (1 - label) * (1 - pred_prob) - modulating_factor = (1.0 - p_t) ** gamma - loss *= modulating_factor - if alpha > 0: - alpha_factor = label * alpha + (1 - label) * (1 - alpha) - loss *= alpha_factor - return loss.mean(1).sum() - - -class BboxLoss(nn.Module): - """Criterion class for computing training losses during training.""" - - def __init__(self, reg_max, use_dfl=False): - """Initialize the BboxLoss module with regularization maximum and DFL settings.""" - super().__init__() - self.reg_max = reg_max - self.use_dfl = use_dfl - - def forward(self, pred_dist, pred_bboxes, anchor_points, target_bboxes, target_scores, target_scores_sum, fg_mask): - """IoU loss.""" - weight = target_scores.sum(-1)[fg_mask].unsqueeze(-1) - iou = bbox_iou(pred_bboxes[fg_mask], target_bboxes[fg_mask], xywh=False, CIoU=True) - loss_iou = ((1.0 - iou) * weight).sum() / target_scores_sum - - # DFL loss - if self.use_dfl: - target_ltrb = bbox2dist(anchor_points, target_bboxes, self.reg_max) - loss_dfl = self._df_loss(pred_dist[fg_mask].view(-1, self.reg_max + 1), target_ltrb[fg_mask]) * weight - loss_dfl = loss_dfl.sum() / target_scores_sum - else: - loss_dfl = torch.tensor(0.0).to(pred_dist.device) - - return loss_iou, loss_dfl - - @staticmethod - def _df_loss(pred_dist, target): - """ - Return sum of left and right DFL losses. - - Distribution Focal Loss (DFL) proposed in Generalized Focal Loss - https://ieeexplore.ieee.org/document/9792391 - """ - tl = target.long() # target left - tr = tl + 1 # target right - wl = tr - target # weight left - wr = 1 - wl # weight right - return ( - F.cross_entropy(pred_dist, tl.view(-1), reduction="none").view(tl.shape) * wl - + F.cross_entropy(pred_dist, tr.view(-1), reduction="none").view(tl.shape) * wr - ).mean(-1, keepdim=True) - - -class RotatedBboxLoss(BboxLoss): - """Criterion class for computing training losses during training.""" - - def __init__(self, reg_max, use_dfl=False): - """Initialize the BboxLoss module with regularization maximum and DFL settings.""" - super().__init__(reg_max, use_dfl) - - def forward(self, pred_dist, pred_bboxes, anchor_points, target_bboxes, target_scores, target_scores_sum, fg_mask): - """IoU loss.""" - weight = target_scores.sum(-1)[fg_mask].unsqueeze(-1) - iou = probiou(pred_bboxes[fg_mask], target_bboxes[fg_mask]) - loss_iou = ((1.0 - iou) * weight).sum() / target_scores_sum - - # DFL loss - if self.use_dfl: - target_ltrb = bbox2dist(anchor_points, xywh2xyxy(target_bboxes[..., :4]), self.reg_max) - loss_dfl = self._df_loss(pred_dist[fg_mask].view(-1, self.reg_max + 1), target_ltrb[fg_mask]) * weight - loss_dfl = loss_dfl.sum() / target_scores_sum - else: - loss_dfl = torch.tensor(0.0).to(pred_dist.device) - - return loss_iou, loss_dfl - - -class KeypointLoss(nn.Module): - """Criterion class for computing training losses.""" - - def __init__(self, sigmas) -> None: - """Initialize the KeypointLoss class.""" - super().__init__() - self.sigmas = sigmas - - def forward(self, pred_kpts, gt_kpts, kpt_mask, area): - """Calculates keypoint loss factor and Euclidean distance loss for predicted and actual keypoints.""" - d = (pred_kpts[..., 0] - gt_kpts[..., 0]).pow(2) + (pred_kpts[..., 1] - gt_kpts[..., 1]).pow(2) - kpt_loss_factor = kpt_mask.shape[1] / (torch.sum(kpt_mask != 0, dim=1) + 1e-9) - # e = d / (2 * (area * self.sigmas) ** 2 + 1e-9) # from formula - e = d / ((2 * self.sigmas).pow(2) * (area + 1e-9) * 2) # from cocoeval - return (kpt_loss_factor.view(-1, 1) * ((1 - torch.exp(-e)) * kpt_mask)).mean() - - -class v8DetectionLoss: - """Criterion class for computing training losses.""" - - def __init__(self, model): # model must be de-paralleled - """Initializes v8DetectionLoss with the model, defining model-related properties and BCE loss function.""" - device = next(model.parameters()).device # get model device - h = model.args # hyperparameters - - m = model.model[-1] # Detect() module - self.bce = nn.BCEWithLogitsLoss(reduction="none") - self.hyp = h - self.stride = m.stride # model strides - self.nc = m.nc # number of classes - self.no = m.no - self.reg_max = m.reg_max - self.device = device - - self.use_dfl = m.reg_max > 1 - - self.assigner = TaskAlignedAssigner(topk=10, num_classes=self.nc, alpha=0.5, beta=6.0) - self.bbox_loss = BboxLoss(m.reg_max - 1, use_dfl=self.use_dfl).to(device) - self.proj = torch.arange(m.reg_max, dtype=torch.float, device=device) - - def preprocess(self, targets, batch_size, scale_tensor): - """Preprocesses the target counts and matches with the input batch size to output a tensor.""" - if targets.shape[0] == 0: - out = torch.zeros(batch_size, 0, 5, device=self.device) - else: - i = targets[:, 0] # image index - _, counts = i.unique(return_counts=True) - counts = counts.to(dtype=torch.int32) - out = torch.zeros(batch_size, counts.max(), 5, device=self.device) - for j in range(batch_size): - matches = i == j - n = matches.sum() - if n: - out[j, :n] = targets[matches, 1:] - out[..., 1:5] = xywh2xyxy(out[..., 1:5].mul_(scale_tensor)) - return out - - def bbox_decode(self, anchor_points, pred_dist): - """Decode predicted object bounding box coordinates from anchor points and distribution.""" - if self.use_dfl: - b, a, c = pred_dist.shape # batch, anchors, channels - pred_dist = pred_dist.view(b, a, 4, c // 4).softmax(3).matmul(self.proj.type(pred_dist.dtype)) - # pred_dist = pred_dist.view(b, a, c // 4, 4).transpose(2,3).softmax(3).matmul(self.proj.type(pred_dist.dtype)) - # pred_dist = (pred_dist.view(b, a, c // 4, 4).softmax(2) * self.proj.type(pred_dist.dtype).view(1, 1, -1, 1)).sum(2) - return dist2bbox(pred_dist, anchor_points, xywh=False) - - def __call__(self, preds, batch): - """Calculate the sum of the loss for box, cls and dfl multiplied by batch size.""" - loss = torch.zeros(3, device=self.device) # box, cls, dfl - feats = preds[1] if isinstance(preds, tuple) else preds - pred_distri, pred_scores = torch.cat([xi.view(feats[0].shape[0], self.no, -1) for xi in feats], 2).split( - (self.reg_max * 4, self.nc), 1 - ) - - pred_scores = pred_scores.permute(0, 2, 1).contiguous() - pred_distri = pred_distri.permute(0, 2, 1).contiguous() - - dtype = pred_scores.dtype - batch_size = pred_scores.shape[0] - imgsz = torch.tensor(feats[0].shape[2:], device=self.device, dtype=dtype) * self.stride[0] # image size (h,w) - anchor_points, stride_tensor = make_anchors(feats, self.stride, 0.5) - - # Targets - targets = torch.cat((batch["batch_idx"].view(-1, 1), batch["cls"].view(-1, 1), batch["bboxes"]), 1) - targets = self.preprocess(targets.to(self.device), batch_size, scale_tensor=imgsz[[1, 0, 1, 0]]) - gt_labels, gt_bboxes = targets.split((1, 4), 2) # cls, xyxy - mask_gt = gt_bboxes.sum(2, keepdim=True).gt_(0) - - # Pboxes - pred_bboxes = self.bbox_decode(anchor_points, pred_distri) # xyxy, (b, h*w, 4) - - _, target_bboxes, target_scores, fg_mask, _ = self.assigner( - pred_scores.detach().sigmoid(), - (pred_bboxes.detach() * stride_tensor).type(gt_bboxes.dtype), - anchor_points * stride_tensor, - gt_labels, - gt_bboxes, - mask_gt, - ) - - target_scores_sum = max(target_scores.sum(), 1) - - # Cls loss - # loss[1] = self.varifocal_loss(pred_scores, target_scores, target_labels) / target_scores_sum # VFL way - loss[1] = self.bce(pred_scores, target_scores.to(dtype)).sum() / target_scores_sum # BCE - - # Bbox loss - if fg_mask.sum(): - target_bboxes /= stride_tensor - loss[0], loss[2] = self.bbox_loss( - pred_distri, pred_bboxes, anchor_points, target_bboxes, target_scores, target_scores_sum, fg_mask - ) - - loss[0] *= self.hyp.box # box gain - loss[1] *= self.hyp.cls # cls gain - loss[2] *= self.hyp.dfl # dfl gain - - return loss.sum() * batch_size, loss.detach() # loss(box, cls, dfl) - - -class v8SegmentationLoss(v8DetectionLoss): - """Criterion class for computing training losses.""" - - def __init__(self, model): # model must be de-paralleled - """Initializes the v8SegmentationLoss class, taking a de-paralleled model as argument.""" - super().__init__(model) - self.overlap = model.args.overlap_mask - - def __call__(self, preds, batch): - """Calculate and return the loss for the YOLO model.""" - loss = torch.zeros(4, device=self.device) # box, cls, dfl - feats, pred_masks, proto = preds if len(preds) == 3 else preds[1] - batch_size, _, mask_h, mask_w = proto.shape # batch size, number of masks, mask height, mask width - pred_distri, pred_scores = torch.cat([xi.view(feats[0].shape[0], self.no, -1) for xi in feats], 2).split( - (self.reg_max * 4, self.nc), 1 - ) - - # B, grids, .. - pred_scores = pred_scores.permute(0, 2, 1).contiguous() - pred_distri = pred_distri.permute(0, 2, 1).contiguous() - pred_masks = pred_masks.permute(0, 2, 1).contiguous() - - dtype = pred_scores.dtype - imgsz = torch.tensor(feats[0].shape[2:], device=self.device, dtype=dtype) * self.stride[0] # image size (h,w) - anchor_points, stride_tensor = make_anchors(feats, self.stride, 0.5) - - # Targets - try: - batch_idx = batch["batch_idx"].view(-1, 1) - targets = torch.cat((batch_idx, batch["cls"].view(-1, 1), batch["bboxes"]), 1) - targets = self.preprocess(targets.to(self.device), batch_size, scale_tensor=imgsz[[1, 0, 1, 0]]) - gt_labels, gt_bboxes = targets.split((1, 4), 2) # cls, xyxy - mask_gt = gt_bboxes.sum(2, keepdim=True).gt_(0) - except RuntimeError as e: - raise TypeError( - "ERROR ❌ segment dataset incorrectly formatted or not a segment dataset.\n" - "This error can occur when incorrectly training a 'segment' model on a 'detect' dataset, " - "i.e. 'yolo train model=yolov8n-seg.pt data=coco8.yaml'.\nVerify your dataset is a " - "correctly formatted 'segment' dataset using 'data=coco8-seg.yaml' " - "as an example.\nSee https://docs.ultralytics.com/datasets/segment/ for help." - ) from e - - # Pboxes - pred_bboxes = self.bbox_decode(anchor_points, pred_distri) # xyxy, (b, h*w, 4) - - _, target_bboxes, target_scores, fg_mask, target_gt_idx = self.assigner( - pred_scores.detach().sigmoid(), - (pred_bboxes.detach() * stride_tensor).type(gt_bboxes.dtype), - anchor_points * stride_tensor, - gt_labels, - gt_bboxes, - mask_gt, - ) - - target_scores_sum = max(target_scores.sum(), 1) - - # Cls loss - # loss[1] = self.varifocal_loss(pred_scores, target_scores, target_labels) / target_scores_sum # VFL way - loss[2] = self.bce(pred_scores, target_scores.to(dtype)).sum() / target_scores_sum # BCE - - if fg_mask.sum(): - # Bbox loss - loss[0], loss[3] = self.bbox_loss( - pred_distri, - pred_bboxes, - anchor_points, - target_bboxes / stride_tensor, - target_scores, - target_scores_sum, - fg_mask, - ) - # Masks loss - masks = batch["masks"].to(self.device).float() - if tuple(masks.shape[-2:]) != (mask_h, mask_w): # downsample - masks = F.interpolate(masks[None], (mask_h, mask_w), mode="nearest")[0] - - loss[1] = self.calculate_segmentation_loss( - fg_mask, masks, target_gt_idx, target_bboxes, batch_idx, proto, pred_masks, imgsz, self.overlap - ) - - # WARNING: lines below prevent Multi-GPU DDP 'unused gradient' PyTorch errors, do not remove - else: - loss[1] += (proto * 0).sum() + (pred_masks * 0).sum() # inf sums may lead to nan loss - - loss[0] *= self.hyp.box # box gain - loss[1] *= self.hyp.box # seg gain - loss[2] *= self.hyp.cls # cls gain - loss[3] *= self.hyp.dfl # dfl gain - - return loss.sum() * batch_size, loss.detach() # loss(box, cls, dfl) - - @staticmethod - def single_mask_loss( - gt_mask: torch.Tensor, pred: torch.Tensor, proto: torch.Tensor, xyxy: torch.Tensor, area: torch.Tensor - ) -> torch.Tensor: - """ - Compute the instance segmentation loss for a single image. - - Args: - gt_mask (torch.Tensor): Ground truth mask of shape (n, H, W), where n is the number of objects. - pred (torch.Tensor): Predicted mask coefficients of shape (n, 32). - proto (torch.Tensor): Prototype masks of shape (32, H, W). - xyxy (torch.Tensor): Ground truth bounding boxes in xyxy format, normalized to [0, 1], of shape (n, 4). - area (torch.Tensor): Area of each ground truth bounding box of shape (n,). - - Returns: - (torch.Tensor): The calculated mask loss for a single image. - - Notes: - The function uses the equation pred_mask = torch.einsum('in,nhw->ihw', pred, proto) to produce the - predicted masks from the prototype masks and predicted mask coefficients. - """ - pred_mask = torch.einsum("in,nhw->ihw", pred, proto) # (n, 32) @ (32, 80, 80) -> (n, 80, 80) - loss = F.binary_cross_entropy_with_logits(pred_mask, gt_mask, reduction="none") - return (crop_mask(loss, xyxy).mean(dim=(1, 2)) / area).sum() - - def calculate_segmentation_loss( - self, - fg_mask: torch.Tensor, - masks: torch.Tensor, - target_gt_idx: torch.Tensor, - target_bboxes: torch.Tensor, - batch_idx: torch.Tensor, - proto: torch.Tensor, - pred_masks: torch.Tensor, - imgsz: torch.Tensor, - overlap: bool, - ) -> torch.Tensor: - """ - Calculate the loss for instance segmentation. - - Args: - fg_mask (torch.Tensor): A binary tensor of shape (BS, N_anchors) indicating which anchors are positive. - masks (torch.Tensor): Ground truth masks of shape (BS, H, W) if `overlap` is False, otherwise (BS, ?, H, W). - target_gt_idx (torch.Tensor): Indexes of ground truth objects for each anchor of shape (BS, N_anchors). - target_bboxes (torch.Tensor): Ground truth bounding boxes for each anchor of shape (BS, N_anchors, 4). - batch_idx (torch.Tensor): Batch indices of shape (N_labels_in_batch, 1). - proto (torch.Tensor): Prototype masks of shape (BS, 32, H, W). - pred_masks (torch.Tensor): Predicted masks for each anchor of shape (BS, N_anchors, 32). - imgsz (torch.Tensor): Size of the input image as a tensor of shape (2), i.e., (H, W). - overlap (bool): Whether the masks in `masks` tensor overlap. - - Returns: - (torch.Tensor): The calculated loss for instance segmentation. - - Notes: - The batch loss can be computed for improved speed at higher memory usage. - For example, pred_mask can be computed as follows: - pred_mask = torch.einsum('in,nhw->ihw', pred, proto) # (i, 32) @ (32, 160, 160) -> (i, 160, 160) - """ - _, _, mask_h, mask_w = proto.shape - loss = 0 - - # Normalize to 0-1 - target_bboxes_normalized = target_bboxes / imgsz[[1, 0, 1, 0]] - - # Areas of target bboxes - marea = xyxy2xywh(target_bboxes_normalized)[..., 2:].prod(2) - - # Normalize to mask size - mxyxy = target_bboxes_normalized * torch.tensor([mask_w, mask_h, mask_w, mask_h], device=proto.device) - - for i, single_i in enumerate(zip(fg_mask, target_gt_idx, pred_masks, proto, mxyxy, marea, masks)): - fg_mask_i, target_gt_idx_i, pred_masks_i, proto_i, mxyxy_i, marea_i, masks_i = single_i - if fg_mask_i.any(): - mask_idx = target_gt_idx_i[fg_mask_i] - if overlap: - gt_mask = masks_i == (mask_idx + 1).view(-1, 1, 1) - gt_mask = gt_mask.float() - else: - gt_mask = masks[batch_idx.view(-1) == i][mask_idx] - - loss += self.single_mask_loss( - gt_mask, pred_masks_i[fg_mask_i], proto_i, mxyxy_i[fg_mask_i], marea_i[fg_mask_i] - ) - - # WARNING: lines below prevents Multi-GPU DDP 'unused gradient' PyTorch errors, do not remove - else: - loss += (proto * 0).sum() + (pred_masks * 0).sum() # inf sums may lead to nan loss - - return loss / fg_mask.sum() - - -class v8PoseLoss(v8DetectionLoss): - """Criterion class for computing training losses.""" - - def __init__(self, model): # model must be de-paralleled - """Initializes v8PoseLoss with model, sets keypoint variables and declares a keypoint loss instance.""" - super().__init__(model) - self.kpt_shape = model.model[-1].kpt_shape - self.bce_pose = nn.BCEWithLogitsLoss() - is_pose = self.kpt_shape == [17, 3] - nkpt = self.kpt_shape[0] # number of keypoints - sigmas = torch.from_numpy(OKS_SIGMA).to(self.device) if is_pose else torch.ones(nkpt, device=self.device) / nkpt - self.keypoint_loss = KeypointLoss(sigmas=sigmas) - - def __call__(self, preds, batch): - """Calculate the total loss and detach it.""" - loss = torch.zeros(5, device=self.device) # box, cls, dfl, kpt_location, kpt_visibility - feats, pred_kpts = preds if isinstance(preds[0], list) else preds[1] - pred_distri, pred_scores = torch.cat([xi.view(feats[0].shape[0], self.no, -1) for xi in feats], 2).split( - (self.reg_max * 4, self.nc), 1 - ) - - # B, grids, .. - pred_scores = pred_scores.permute(0, 2, 1).contiguous() - pred_distri = pred_distri.permute(0, 2, 1).contiguous() - pred_kpts = pred_kpts.permute(0, 2, 1).contiguous() - - dtype = pred_scores.dtype - imgsz = torch.tensor(feats[0].shape[2:], device=self.device, dtype=dtype) * self.stride[0] # image size (h,w) - anchor_points, stride_tensor = make_anchors(feats, self.stride, 0.5) - - # Targets - batch_size = pred_scores.shape[0] - batch_idx = batch["batch_idx"].view(-1, 1) - targets = torch.cat((batch_idx, batch["cls"].view(-1, 1), batch["bboxes"]), 1) - targets = self.preprocess(targets.to(self.device), batch_size, scale_tensor=imgsz[[1, 0, 1, 0]]) - gt_labels, gt_bboxes = targets.split((1, 4), 2) # cls, xyxy - mask_gt = gt_bboxes.sum(2, keepdim=True).gt_(0) - - # Pboxes - pred_bboxes = self.bbox_decode(anchor_points, pred_distri) # xyxy, (b, h*w, 4) - pred_kpts = self.kpts_decode(anchor_points, pred_kpts.view(batch_size, -1, *self.kpt_shape)) # (b, h*w, 17, 3) - - _, target_bboxes, target_scores, fg_mask, target_gt_idx = self.assigner( - pred_scores.detach().sigmoid(), - (pred_bboxes.detach() * stride_tensor).type(gt_bboxes.dtype), - anchor_points * stride_tensor, - gt_labels, - gt_bboxes, - mask_gt, - ) - - target_scores_sum = max(target_scores.sum(), 1) - - # Cls loss - # loss[1] = self.varifocal_loss(pred_scores, target_scores, target_labels) / target_scores_sum # VFL way - loss[3] = self.bce(pred_scores, target_scores.to(dtype)).sum() / target_scores_sum # BCE - - # Bbox loss - if fg_mask.sum(): - target_bboxes /= stride_tensor - loss[0], loss[4] = self.bbox_loss( - pred_distri, pred_bboxes, anchor_points, target_bboxes, target_scores, target_scores_sum, fg_mask - ) - keypoints = batch["keypoints"].to(self.device).float().clone() - keypoints[..., 0] *= imgsz[1] - keypoints[..., 1] *= imgsz[0] - - loss[1], loss[2] = self.calculate_keypoints_loss( - fg_mask, target_gt_idx, keypoints, batch_idx, stride_tensor, target_bboxes, pred_kpts - ) - - loss[0] *= self.hyp.box # box gain - loss[1] *= self.hyp.pose # pose gain - loss[2] *= self.hyp.kobj # kobj gain - loss[3] *= self.hyp.cls # cls gain - loss[4] *= self.hyp.dfl # dfl gain - - return loss.sum() * batch_size, loss.detach() # loss(box, cls, dfl) - - @staticmethod - def kpts_decode(anchor_points, pred_kpts): - """Decodes predicted keypoints to image coordinates.""" - y = pred_kpts.clone() - y[..., :2] *= 2.0 - y[..., 0] += anchor_points[:, [0]] - 0.5 - y[..., 1] += anchor_points[:, [1]] - 0.5 - return y - - def calculate_keypoints_loss( - self, masks, target_gt_idx, keypoints, batch_idx, stride_tensor, target_bboxes, pred_kpts - ): - """ - Calculate the keypoints loss for the model. - - This function calculates the keypoints loss and keypoints object loss for a given batch. The keypoints loss is - based on the difference between the predicted keypoints and ground truth keypoints. The keypoints object loss is - a binary classification loss that classifies whether a keypoint is present or not. - - Args: - masks (torch.Tensor): Binary mask tensor indicating object presence, shape (BS, N_anchors). - target_gt_idx (torch.Tensor): Index tensor mapping anchors to ground truth objects, shape (BS, N_anchors). - keypoints (torch.Tensor): Ground truth keypoints, shape (N_kpts_in_batch, N_kpts_per_object, kpts_dim). - batch_idx (torch.Tensor): Batch index tensor for keypoints, shape (N_kpts_in_batch, 1). - stride_tensor (torch.Tensor): Stride tensor for anchors, shape (N_anchors, 1). - target_bboxes (torch.Tensor): Ground truth boxes in (x1, y1, x2, y2) format, shape (BS, N_anchors, 4). - pred_kpts (torch.Tensor): Predicted keypoints, shape (BS, N_anchors, N_kpts_per_object, kpts_dim). - - Returns: - (tuple): Returns a tuple containing: - - kpts_loss (torch.Tensor): The keypoints loss. - - kpts_obj_loss (torch.Tensor): The keypoints object loss. - """ - batch_idx = batch_idx.flatten() - batch_size = len(masks) - - # Find the maximum number of keypoints in a single image - max_kpts = torch.unique(batch_idx, return_counts=True)[1].max() - - # Create a tensor to hold batched keypoints - batched_keypoints = torch.zeros( - (batch_size, max_kpts, keypoints.shape[1], keypoints.shape[2]), device=keypoints.device - ) - - # TODO: any idea how to vectorize this? - # Fill batched_keypoints with keypoints based on batch_idx - for i in range(batch_size): - keypoints_i = keypoints[batch_idx == i] - batched_keypoints[i, : keypoints_i.shape[0]] = keypoints_i - - # Expand dimensions of target_gt_idx to match the shape of batched_keypoints - target_gt_idx_expanded = target_gt_idx.unsqueeze(-1).unsqueeze(-1) - - # Use target_gt_idx_expanded to select keypoints from batched_keypoints - selected_keypoints = batched_keypoints.gather( - 1, target_gt_idx_expanded.expand(-1, -1, keypoints.shape[1], keypoints.shape[2]) - ) - - # Divide coordinates by stride - selected_keypoints /= stride_tensor.view(1, -1, 1, 1) - - kpts_loss = 0 - kpts_obj_loss = 0 - - if masks.any(): - gt_kpt = selected_keypoints[masks] - area = xyxy2xywh(target_bboxes[masks])[:, 2:].prod(1, keepdim=True) - pred_kpt = pred_kpts[masks] - kpt_mask = gt_kpt[..., 2] != 0 if gt_kpt.shape[-1] == 3 else torch.full_like(gt_kpt[..., 0], True) - kpts_loss = self.keypoint_loss(pred_kpt, gt_kpt, kpt_mask, area) # pose loss - - if pred_kpt.shape[-1] == 3: - kpts_obj_loss = self.bce_pose(pred_kpt[..., 2], kpt_mask.float()) # keypoint obj loss - - return kpts_loss, kpts_obj_loss - - -class v8ClassificationLoss: - """Criterion class for computing training losses.""" - - def __call__(self, preds, batch): - """Compute the classification loss between predictions and true labels.""" - loss = torch.nn.functional.cross_entropy(preds, batch["cls"], reduction="mean") - loss_items = loss.detach() - return loss, loss_items - - -class v8OBBLoss(v8DetectionLoss): - def __init__(self, model): - """ - Initializes v8OBBLoss with model, assigner, and rotated bbox loss. - - Note model must be de-paralleled. - """ - super().__init__(model) - self.assigner = RotatedTaskAlignedAssigner(topk=10, num_classes=self.nc, alpha=0.5, beta=6.0) - self.bbox_loss = RotatedBboxLoss(self.reg_max - 1, use_dfl=self.use_dfl).to(self.device) - - def preprocess(self, targets, batch_size, scale_tensor): - """Preprocesses the target counts and matches with the input batch size to output a tensor.""" - if targets.shape[0] == 0: - out = torch.zeros(batch_size, 0, 6, device=self.device) - else: - i = targets[:, 0] # image index - _, counts = i.unique(return_counts=True) - counts = counts.to(dtype=torch.int32) - out = torch.zeros(batch_size, counts.max(), 6, device=self.device) - for j in range(batch_size): - matches = i == j - n = matches.sum() - if n: - bboxes = targets[matches, 2:] - bboxes[..., :4].mul_(scale_tensor) - out[j, :n] = torch.cat([targets[matches, 1:2], bboxes], dim=-1) - return out - - def __call__(self, preds, batch): - """Calculate and return the loss for the YOLO model.""" - loss = torch.zeros(3, device=self.device) # box, cls, dfl - feats, pred_angle = preds if isinstance(preds[0], list) else preds[1] - batch_size = pred_angle.shape[0] # batch size, number of masks, mask height, mask width - pred_distri, pred_scores = torch.cat([xi.view(feats[0].shape[0], self.no, -1) for xi in feats], 2).split( - (self.reg_max * 4, self.nc), 1 - ) - - # b, grids, .. - pred_scores = pred_scores.permute(0, 2, 1).contiguous() - pred_distri = pred_distri.permute(0, 2, 1).contiguous() - pred_angle = pred_angle.permute(0, 2, 1).contiguous() - - dtype = pred_scores.dtype - imgsz = torch.tensor(feats[0].shape[2:], device=self.device, dtype=dtype) * self.stride[0] # image size (h,w) - anchor_points, stride_tensor = make_anchors(feats, self.stride, 0.5) - - # targets - try: - batch_idx = batch["batch_idx"].view(-1, 1) - targets = torch.cat((batch_idx, batch["cls"].view(-1, 1), batch["bboxes"].view(-1, 5)), 1) - rw, rh = targets[:, 4] * imgsz[0].item(), targets[:, 5] * imgsz[1].item() - targets = targets[(rw >= 2) & (rh >= 2)] # filter rboxes of tiny size to stabilize training - targets = self.preprocess(targets.to(self.device), batch_size, scale_tensor=imgsz[[1, 0, 1, 0]]) - gt_labels, gt_bboxes = targets.split((1, 5), 2) # cls, xywhr - mask_gt = gt_bboxes.sum(2, keepdim=True).gt_(0) - except RuntimeError as e: - raise TypeError( - "ERROR ❌ OBB dataset incorrectly formatted or not a OBB dataset.\n" - "This error can occur when incorrectly training a 'OBB' model on a 'detect' dataset, " - "i.e. 'yolo train model=yolov8n-obb.pt data=dota8.yaml'.\nVerify your dataset is a " - "correctly formatted 'OBB' dataset using 'data=dota8.yaml' " - "as an example.\nSee https://docs.ultralytics.com/datasets/obb/ for help." - ) from e - - # Pboxes - pred_bboxes = self.bbox_decode(anchor_points, pred_distri, pred_angle) # xyxy, (b, h*w, 4) - - bboxes_for_assigner = pred_bboxes.clone().detach() - # Only the first four elements need to be scaled - bboxes_for_assigner[..., :4] *= stride_tensor - _, target_bboxes, target_scores, fg_mask, _ = self.assigner( - pred_scores.detach().sigmoid(), - bboxes_for_assigner.type(gt_bboxes.dtype), - anchor_points * stride_tensor, - gt_labels, - gt_bboxes, - mask_gt, - ) - - target_scores_sum = max(target_scores.sum(), 1) - - # Cls loss - # loss[1] = self.varifocal_loss(pred_scores, target_scores, target_labels) / target_scores_sum # VFL way - loss[1] = self.bce(pred_scores, target_scores.to(dtype)).sum() / target_scores_sum # BCE - - # Bbox loss - if fg_mask.sum(): - target_bboxes[..., :4] /= stride_tensor - loss[0], loss[2] = self.bbox_loss( - pred_distri, pred_bboxes, anchor_points, target_bboxes, target_scores, target_scores_sum, fg_mask - ) - else: - loss[0] += (pred_angle * 0).sum() - - loss[0] *= self.hyp.box # box gain - loss[1] *= self.hyp.cls # cls gain - loss[2] *= self.hyp.dfl # dfl gain - - return loss.sum() * batch_size, loss.detach() # loss(box, cls, dfl) - - def bbox_decode(self, anchor_points, pred_dist, pred_angle): - """ - Decode predicted object bounding box coordinates from anchor points and distribution. - - Args: - anchor_points (torch.Tensor): Anchor points, (h*w, 2). - pred_dist (torch.Tensor): Predicted rotated distance, (bs, h*w, 4). - pred_angle (torch.Tensor): Predicted angle, (bs, h*w, 1). - - Returns: - (torch.Tensor): Predicted rotated bounding boxes with angles, (bs, h*w, 5). - """ - if self.use_dfl: - b, a, c = pred_dist.shape # batch, anchors, channels - pred_dist = pred_dist.view(b, a, 4, c // 4).softmax(3).matmul(self.proj.type(pred_dist.dtype)) - return torch.cat((dist2rbox(pred_dist, pred_angle, anchor_points), pred_angle), dim=-1) diff --git a/ultralytics-main/ultralytics/utils/metrics.py b/ultralytics-main/ultralytics/utils/metrics.py deleted file mode 100644 index 235db56..0000000 --- a/ultralytics-main/ultralytics/utils/metrics.py +++ /dev/null @@ -1,1289 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -"""Model validation metrics.""" - -import math -import warnings -from pathlib import Path - -import matplotlib.pyplot as plt -import numpy as np -import torch - -from ultralytics.utils import LOGGER, SimpleClass, TryExcept, plt_settings - -OKS_SIGMA = ( - np.array([0.26, 0.25, 0.25, 0.35, 0.35, 0.79, 0.79, 0.72, 0.72, 0.62, 0.62, 1.07, 1.07, 0.87, 0.87, 0.89, 0.89]) - / 10.0 -) - - -def bbox_ioa(box1, box2, iou=False, eps=1e-7): - """ - Calculate the intersection over box2 area given box1 and box2. Boxes are in x1y1x2y2 format. - - Args: - box1 (np.ndarray): A numpy array of shape (n, 4) representing n bounding boxes. - box2 (np.ndarray): A numpy array of shape (m, 4) representing m bounding boxes. - iou (bool): Calculate the standard IoU if True else return inter_area/box2_area. - eps (float, optional): A small value to avoid division by zero. Defaults to 1e-7. - - Returns: - (np.ndarray): A numpy array of shape (n, m) representing the intersection over box2 area. - """ - - # Get the coordinates of bounding boxes - b1_x1, b1_y1, b1_x2, b1_y2 = box1.T - b2_x1, b2_y1, b2_x2, b2_y2 = box2.T - - # Intersection area - inter_area = (np.minimum(b1_x2[:, None], b2_x2) - np.maximum(b1_x1[:, None], b2_x1)).clip(0) * ( - np.minimum(b1_y2[:, None], b2_y2) - np.maximum(b1_y1[:, None], b2_y1) - ).clip(0) - - # Box2 area - area = (b2_x2 - b2_x1) * (b2_y2 - b2_y1) - if iou: - box1_area = (b1_x2 - b1_x1) * (b1_y2 - b1_y1) - area = area + box1_area[:, None] - inter_area - - # Intersection over box2 area - return inter_area / (area + eps) - - -def box_iou(box1, box2, eps=1e-7): - """ - Calculate intersection-over-union (IoU) of boxes. Both sets of boxes are expected to be in (x1, y1, x2, y2) format. - Based on https://github.com/pytorch/vision/blob/master/torchvision/ops/boxes.py - - Args: - box1 (torch.Tensor): A tensor of shape (N, 4) representing N bounding boxes. - box2 (torch.Tensor): A tensor of shape (M, 4) representing M bounding boxes. - eps (float, optional): A small value to avoid division by zero. Defaults to 1e-7. - - Returns: - (torch.Tensor): An NxM tensor containing the pairwise IoU values for every element in box1 and box2. - """ - - # inter(N,M) = (rb(N,M,2) - lt(N,M,2)).clamp(0).prod(2) - (a1, a2), (b1, b2) = box1.unsqueeze(1).chunk(2, 2), box2.unsqueeze(0).chunk(2, 2) - inter = (torch.min(a2, b2) - torch.max(a1, b1)).clamp_(0).prod(2) - - # IoU = inter / (area1 + area2 - inter) - return inter / ((a2 - a1).prod(2) + (b2 - b1).prod(2) - inter + eps) - - -def bbox_iou(box1, box2, xywh=True, GIoU=False, DIoU=False, CIoU=False, eps=1e-7): - """ - Calculate Intersection over Union (IoU) of box1(1, 4) to box2(n, 4). - - Args: - box1 (torch.Tensor): A tensor representing a single bounding box with shape (1, 4). - box2 (torch.Tensor): A tensor representing n bounding boxes with shape (n, 4). - xywh (bool, optional): If True, input boxes are in (x, y, w, h) format. If False, input boxes are in - (x1, y1, x2, y2) format. Defaults to True. - GIoU (bool, optional): If True, calculate Generalized IoU. Defaults to False. - DIoU (bool, optional): If True, calculate Distance IoU. Defaults to False. - CIoU (bool, optional): If True, calculate Complete IoU. Defaults to False. - eps (float, optional): A small value to avoid division by zero. Defaults to 1e-7. - - Returns: - (torch.Tensor): IoU, GIoU, DIoU, or CIoU values depending on the specified flags. - """ - - # Get the coordinates of bounding boxes - if xywh: # transform from xywh to xyxy - (x1, y1, w1, h1), (x2, y2, w2, h2) = box1.chunk(4, -1), box2.chunk(4, -1) - w1_, h1_, w2_, h2_ = w1 / 2, h1 / 2, w2 / 2, h2 / 2 - b1_x1, b1_x2, b1_y1, b1_y2 = x1 - w1_, x1 + w1_, y1 - h1_, y1 + h1_ - b2_x1, b2_x2, b2_y1, b2_y2 = x2 - w2_, x2 + w2_, y2 - h2_, y2 + h2_ - else: # x1, y1, x2, y2 = box1 - b1_x1, b1_y1, b1_x2, b1_y2 = box1.chunk(4, -1) - b2_x1, b2_y1, b2_x2, b2_y2 = box2.chunk(4, -1) - w1, h1 = b1_x2 - b1_x1, b1_y2 - b1_y1 + eps - w2, h2 = b2_x2 - b2_x1, b2_y2 - b2_y1 + eps - - # Intersection area - inter = (b1_x2.minimum(b2_x2) - b1_x1.maximum(b2_x1)).clamp_(0) * ( - b1_y2.minimum(b2_y2) - b1_y1.maximum(b2_y1) - ).clamp_(0) - - # Union Area - union = w1 * h1 + w2 * h2 - inter + eps - - # IoU - iou = inter / union - if CIoU or DIoU or GIoU: - cw = b1_x2.maximum(b2_x2) - b1_x1.minimum(b2_x1) # convex (smallest enclosing box) width - ch = b1_y2.maximum(b2_y2) - b1_y1.minimum(b2_y1) # convex height - if CIoU or DIoU: # Distance or Complete IoU https://arxiv.org/abs/1911.08287v1 - c2 = cw.pow(2) + ch.pow(2) + eps # convex diagonal squared - rho2 = ( - (b2_x1 + b2_x2 - b1_x1 - b1_x2).pow(2) + (b2_y1 + b2_y2 - b1_y1 - b1_y2).pow(2) - ) / 4 # center dist**2 - if CIoU: # https://github.com/Zzh-tju/DIoU-SSD-pytorch/blob/master/utils/box/box_utils.py#L47 - v = (4 / math.pi**2) * ((w2 / h2).atan() - (w1 / h1).atan()).pow(2) - with torch.no_grad(): - alpha = v / (v - iou + (1 + eps)) - return iou - (rho2 / c2 + v * alpha) # CIoU - return iou - rho2 / c2 # DIoU - c_area = cw * ch + eps # convex area - return iou - (c_area - union) / c_area # GIoU https://arxiv.org/pdf/1902.09630.pdf - return iou # IoU - - -def mask_iou(mask1, mask2, eps=1e-7): - """ - Calculate masks IoU. - - Args: - mask1 (torch.Tensor): A tensor of shape (N, n) where N is the number of ground truth objects and n is the - product of image width and height. - mask2 (torch.Tensor): A tensor of shape (M, n) where M is the number of predicted objects and n is the - product of image width and height. - eps (float, optional): A small value to avoid division by zero. Defaults to 1e-7. - - Returns: - (torch.Tensor): A tensor of shape (N, M) representing masks IoU. - """ - intersection = torch.matmul(mask1, mask2.T).clamp_(0) - union = (mask1.sum(1)[:, None] + mask2.sum(1)[None]) - intersection # (area1 + area2) - intersection - return intersection / (union + eps) - - -def kpt_iou(kpt1, kpt2, area, sigma, eps=1e-7): - """ - Calculate Object Keypoint Similarity (OKS). - - Args: - kpt1 (torch.Tensor): A tensor of shape (N, 17, 3) representing ground truth keypoints. - kpt2 (torch.Tensor): A tensor of shape (M, 17, 3) representing predicted keypoints. - area (torch.Tensor): A tensor of shape (N,) representing areas from ground truth. - sigma (list): A list containing 17 values representing keypoint scales. - eps (float, optional): A small value to avoid division by zero. Defaults to 1e-7. - - Returns: - (torch.Tensor): A tensor of shape (N, M) representing keypoint similarities. - """ - d = (kpt1[:, None, :, 0] - kpt2[..., 0]).pow(2) + (kpt1[:, None, :, 1] - kpt2[..., 1]).pow(2) # (N, M, 17) - sigma = torch.tensor(sigma, device=kpt1.device, dtype=kpt1.dtype) # (17, ) - kpt_mask = kpt1[..., 2] != 0 # (N, 17) - e = d / (2 * sigma).pow(2) / (area[:, None, None] + eps) / 2 # from cocoeval - # e = d / ((area[None, :, None] + eps) * sigma) ** 2 / 2 # from formula - return ((-e).exp() * kpt_mask[:, None]).sum(-1) / (kpt_mask.sum(-1)[:, None] + eps) - - -def _get_covariance_matrix(boxes): - """ - Generating covariance matrix from obbs. - - Args: - boxes (torch.Tensor): A tensor of shape (N, 5) representing rotated bounding boxes, with xywhr format. - - Returns: - (torch.Tensor): Covariance metrixs corresponding to original rotated bounding boxes. - """ - # Gaussian bounding boxes, ignore the center points (the first two columns) because they are not needed here. - gbbs = torch.cat((boxes[:, 2:4].pow(2) / 12, boxes[:, 4:]), dim=-1) - a, b, c = gbbs.split(1, dim=-1) - cos = c.cos() - sin = c.sin() - cos2 = cos.pow(2) - sin2 = sin.pow(2) - return a * cos2 + b * sin2, a * sin2 + b * cos2, (a - b) * cos * sin - - -def probiou(obb1, obb2, CIoU=False, eps=1e-7): - """ - Calculate the prob IoU between oriented bounding boxes, https://arxiv.org/pdf/2106.06072v1.pdf. - - Args: - obb1 (torch.Tensor): A tensor of shape (N, 5) representing ground truth obbs, with xywhr format. - obb2 (torch.Tensor): A tensor of shape (N, 5) representing predicted obbs, with xywhr format. - eps (float, optional): A small value to avoid division by zero. Defaults to 1e-7. - - Returns: - (torch.Tensor): A tensor of shape (N, ) representing obb similarities. - """ - x1, y1 = obb1[..., :2].split(1, dim=-1) - x2, y2 = obb2[..., :2].split(1, dim=-1) - a1, b1, c1 = _get_covariance_matrix(obb1) - a2, b2, c2 = _get_covariance_matrix(obb2) - - t1 = ( - ((a1 + a2) * (y1 - y2).pow(2) + (b1 + b2) * (x1 - x2).pow(2)) / ((a1 + a2) * (b1 + b2) - (c1 + c2).pow(2) + eps) - ) * 0.25 - t2 = (((c1 + c2) * (x2 - x1) * (y1 - y2)) / ((a1 + a2) * (b1 + b2) - (c1 + c2).pow(2) + eps)) * 0.5 - t3 = ( - ((a1 + a2) * (b1 + b2) - (c1 + c2).pow(2)) - / (4 * ((a1 * b1 - c1.pow(2)).clamp_(0) * (a2 * b2 - c2.pow(2)).clamp_(0)).sqrt() + eps) - + eps - ).log() * 0.5 - bd = (t1 + t2 + t3).clamp(eps, 100.0) - hd = (1.0 - (-bd).exp() + eps).sqrt() - iou = 1 - hd - if CIoU: # only include the wh aspect ratio part - w1, h1 = obb1[..., 2:4].split(1, dim=-1) - w2, h2 = obb2[..., 2:4].split(1, dim=-1) - v = (4 / math.pi**2) * ((w2 / h2).atan() - (w1 / h1).atan()).pow(2) - with torch.no_grad(): - alpha = v / (v - iou + (1 + eps)) - return iou - v * alpha # CIoU - return iou - - -def batch_probiou(obb1, obb2, eps=1e-7): - """ - Calculate the prob IoU between oriented bounding boxes, https://arxiv.org/pdf/2106.06072v1.pdf. - - Args: - obb1 (torch.Tensor | np.ndarray): A tensor of shape (N, 5) representing ground truth obbs, with xywhr format. - obb2 (torch.Tensor | np.ndarray): A tensor of shape (M, 5) representing predicted obbs, with xywhr format. - eps (float, optional): A small value to avoid division by zero. Defaults to 1e-7. - - Returns: - (torch.Tensor): A tensor of shape (N, M) representing obb similarities. - """ - obb1 = torch.from_numpy(obb1) if isinstance(obb1, np.ndarray) else obb1 - obb2 = torch.from_numpy(obb2) if isinstance(obb2, np.ndarray) else obb2 - - x1, y1 = obb1[..., :2].split(1, dim=-1) - x2, y2 = (x.squeeze(-1)[None] for x in obb2[..., :2].split(1, dim=-1)) - a1, b1, c1 = _get_covariance_matrix(obb1) - a2, b2, c2 = (x.squeeze(-1)[None] for x in _get_covariance_matrix(obb2)) - - t1 = ( - ((a1 + a2) * (y1 - y2).pow(2) + (b1 + b2) * (x1 - x2).pow(2)) / ((a1 + a2) * (b1 + b2) - (c1 + c2).pow(2) + eps) - ) * 0.25 - t2 = (((c1 + c2) * (x2 - x1) * (y1 - y2)) / ((a1 + a2) * (b1 + b2) - (c1 + c2).pow(2) + eps)) * 0.5 - t3 = ( - ((a1 + a2) * (b1 + b2) - (c1 + c2).pow(2)) - / (4 * ((a1 * b1 - c1.pow(2)).clamp_(0) * (a2 * b2 - c2.pow(2)).clamp_(0)).sqrt() + eps) - + eps - ).log() * 0.5 - bd = (t1 + t2 + t3).clamp(eps, 100.0) - hd = (1.0 - (-bd).exp() + eps).sqrt() - return 1 - hd - - -def smooth_BCE(eps=0.1): - """ - Computes smoothed positive and negative Binary Cross-Entropy targets. - - This function calculates positive and negative label smoothing BCE targets based on a given epsilon value. - For implementation details, refer to https://github.com/ultralytics/yolov3/issues/238#issuecomment-598028441. - - Args: - eps (float, optional): The epsilon value for label smoothing. Defaults to 0.1. - - Returns: - (tuple): A tuple containing the positive and negative label smoothing BCE targets. - """ - return 1.0 - 0.5 * eps, 0.5 * eps - - -class ConfusionMatrix: - """ - A class for calculating and updating a confusion matrix for object detection and classification tasks. - - Attributes: - task (str): The type of task, either 'detect' or 'classify'. - matrix (np.ndarray): The confusion matrix, with dimensions depending on the task. - nc (int): The number of classes. - conf (float): The confidence threshold for detections. - iou_thres (float): The Intersection over Union threshold. - """ - - def __init__(self, nc, conf=0.25, iou_thres=0.45, task="detect"): - """Initialize attributes for the YOLO model.""" - self.task = task - self.matrix = np.zeros((nc + 1, nc + 1)) if self.task == "detect" else np.zeros((nc, nc)) - self.nc = nc # number of classes - self.conf = 0.25 if conf in (None, 0.001) else conf # apply 0.25 if default val conf is passed - self.iou_thres = iou_thres - - def process_cls_preds(self, preds, targets): - """ - Update confusion matrix for classification task. - - Args: - preds (Array[N, min(nc,5)]): Predicted class labels. - targets (Array[N, 1]): Ground truth class labels. - """ - preds, targets = torch.cat(preds)[:, 0], torch.cat(targets) - for p, t in zip(preds.cpu().numpy(), targets.cpu().numpy()): - self.matrix[p][t] += 1 - - def process_batch(self, detections, gt_bboxes, gt_cls): - """ - Update confusion matrix for object detection task. - - Args: - detections (Array[N, 6] | Array[N, 7]): Detected bounding boxes and their associated information. - Each row should contain (x1, y1, x2, y2, conf, class) - or with an additional element `angle` when it's obb. - gt_bboxes (Array[M, 4]| Array[N, 5]): Ground truth bounding boxes with xyxy/xyxyr format. - gt_cls (Array[M]): The class labels. - """ - if gt_cls.shape[0] == 0: # Check if labels is empty - if detections is not None: - detections = detections[detections[:, 4] > self.conf] - detection_classes = detections[:, 5].int() - for dc in detection_classes: - self.matrix[dc, self.nc] += 1 # false positives - return - if detections is None: - gt_classes = gt_cls.int() - for gc in gt_classes: - self.matrix[self.nc, gc] += 1 # background FN - return - - detections = detections[detections[:, 4] > self.conf] - gt_classes = gt_cls.int() - detection_classes = detections[:, 5].int() - is_obb = detections.shape[1] == 7 and gt_bboxes.shape[1] == 5 # with additional `angle` dimension - iou = ( - batch_probiou(gt_bboxes, torch.cat([detections[:, :4], detections[:, -1:]], dim=-1)) - if is_obb - else box_iou(gt_bboxes, detections[:, :4]) - ) - - x = torch.where(iou > self.iou_thres) - if x[0].shape[0]: - matches = torch.cat((torch.stack(x, 1), iou[x[0], x[1]][:, None]), 1).cpu().numpy() - if x[0].shape[0] > 1: - matches = matches[matches[:, 2].argsort()[::-1]] - matches = matches[np.unique(matches[:, 1], return_index=True)[1]] - matches = matches[matches[:, 2].argsort()[::-1]] - matches = matches[np.unique(matches[:, 0], return_index=True)[1]] - else: - matches = np.zeros((0, 3)) - - n = matches.shape[0] > 0 - m0, m1, _ = matches.transpose().astype(int) - for i, gc in enumerate(gt_classes): - j = m0 == i - if n and sum(j) == 1: - self.matrix[detection_classes[m1[j]], gc] += 1 # correct - else: - self.matrix[self.nc, gc] += 1 # true background - - if n: - for i, dc in enumerate(detection_classes): - if not any(m1 == i): - self.matrix[dc, self.nc] += 1 # predicted background - - def matrix(self): - """Returns the confusion matrix.""" - return self.matrix - - def tp_fp(self): - """Returns true positives and false positives.""" - tp = self.matrix.diagonal() # true positives - fp = self.matrix.sum(1) - tp # false positives - # fn = self.matrix.sum(0) - tp # false negatives (missed detections) - return (tp[:-1], fp[:-1]) if self.task == "detect" else (tp, fp) # remove background class if task=detect - - @TryExcept("WARNING ⚠️ ConfusionMatrix plot failure") - @plt_settings() - def plot(self, normalize=True, save_dir="", names=(), on_plot=None): - """ - Plot the confusion matrix using seaborn and save it to a file. - - Args: - normalize (bool): Whether to normalize the confusion matrix. - save_dir (str): Directory where the plot will be saved. - names (tuple): Names of classes, used as labels on the plot. - on_plot (func): An optional callback to pass plots path and data when they are rendered. - """ - import seaborn as sn - - array = self.matrix / ((self.matrix.sum(0).reshape(1, -1) + 1e-9) if normalize else 1) # normalize columns - array[array < 0.005] = np.nan # don't annotate (would appear as 0.00) - - fig, ax = plt.subplots(1, 1, figsize=(12, 9), tight_layout=True) - nc, nn = self.nc, len(names) # number of classes, names - sn.set(font_scale=1.0 if nc < 50 else 0.8) # for label size - labels = (0 < nn < 99) and (nn == nc) # apply names to ticklabels - ticklabels = (list(names) + ["background"]) if labels else "auto" - with warnings.catch_warnings(): - warnings.simplefilter("ignore") # suppress empty matrix RuntimeWarning: All-NaN slice encountered - sn.heatmap( - array, - ax=ax, - annot=nc < 30, - annot_kws={"size": 8}, - cmap="Blues", - fmt=".2f" if normalize else ".0f", - square=True, - vmin=0.0, - xticklabels=ticklabels, - yticklabels=ticklabels, - ).set_facecolor((1, 1, 1)) - title = "Confusion Matrix" + " Normalized" * normalize - ax.set_xlabel("True") - ax.set_ylabel("Predicted") - ax.set_title(title) - plot_fname = Path(save_dir) / f'{title.lower().replace(" ", "_")}.png' - fig.savefig(plot_fname, dpi=250) - plt.close(fig) - if on_plot: - on_plot(plot_fname) - - def print(self): - """Print the confusion matrix to the console.""" - for i in range(self.nc + 1): - LOGGER.info(" ".join(map(str, self.matrix[i]))) - - -def smooth(y, f=0.05): - """Box filter of fraction f.""" - nf = round(len(y) * f * 2) // 2 + 1 # number of filter elements (must be odd) - p = np.ones(nf // 2) # ones padding - yp = np.concatenate((p * y[0], y, p * y[-1]), 0) # y padded - return np.convolve(yp, np.ones(nf) / nf, mode="valid") # y-smoothed - - -@plt_settings() -def plot_pr_curve(px, py, ap, save_dir=Path("pr_curve.png"), names=(), on_plot=None): - """Plots a precision-recall curve.""" - fig, ax = plt.subplots(1, 1, figsize=(9, 6), tight_layout=True) - py = np.stack(py, axis=1) - - if 0 < len(names) < 21: # display per-class legend if < 21 classes - for i, y in enumerate(py.T): - ax.plot(px, y, linewidth=1, label=f"{names[i]} {ap[i, 0]:.3f}") # plot(recall, precision) - else: - ax.plot(px, py, linewidth=1, color="grey") # plot(recall, precision) - - ax.plot(px, py.mean(1), linewidth=3, color="blue", label="all classes %.3f mAP@0.5" % ap[:, 0].mean()) - ax.set_xlabel("Recall") - ax.set_ylabel("Precision") - ax.set_xlim(0, 1) - ax.set_ylim(0, 1) - ax.legend(bbox_to_anchor=(1.04, 1), loc="upper left") - ax.set_title("Precision-Recall Curve") - fig.savefig(save_dir, dpi=250) - plt.close(fig) - if on_plot: - on_plot(save_dir) - - -@plt_settings() -def plot_mc_curve(px, py, save_dir=Path("mc_curve.png"), names=(), xlabel="Confidence", ylabel="Metric", on_plot=None): - """Plots a metric-confidence curve.""" - fig, ax = plt.subplots(1, 1, figsize=(9, 6), tight_layout=True) - - if 0 < len(names) < 21: # display per-class legend if < 21 classes - for i, y in enumerate(py): - ax.plot(px, y, linewidth=1, label=f"{names[i]}") # plot(confidence, metric) - else: - ax.plot(px, py.T, linewidth=1, color="grey") # plot(confidence, metric) - - y = smooth(py.mean(0), 0.05) - ax.plot(px, y, linewidth=3, color="blue", label=f"all classes {y.max():.2f} at {px[y.argmax()]:.3f}") - ax.set_xlabel(xlabel) - ax.set_ylabel(ylabel) - ax.set_xlim(0, 1) - ax.set_ylim(0, 1) - ax.legend(bbox_to_anchor=(1.04, 1), loc="upper left") - ax.set_title(f"{ylabel}-Confidence Curve") - fig.savefig(save_dir, dpi=250) - plt.close(fig) - if on_plot: - on_plot(save_dir) - - -def compute_ap(recall, precision): - """ - Compute the average precision (AP) given the recall and precision curves. - - Args: - recall (list): The recall curve. - precision (list): The precision curve. - - Returns: - (float): Average precision. - (np.ndarray): Precision envelope curve. - (np.ndarray): Modified recall curve with sentinel values added at the beginning and end. - """ - - # Append sentinel values to beginning and end - mrec = np.concatenate(([0.0], recall, [1.0])) - mpre = np.concatenate(([1.0], precision, [0.0])) - - # Compute the precision envelope - mpre = np.flip(np.maximum.accumulate(np.flip(mpre))) - - # Integrate area under curve - method = "interp" # methods: 'continuous', 'interp' - if method == "interp": - x = np.linspace(0, 1, 101) # 101-point interp (COCO) - ap = np.trapz(np.interp(x, mrec, mpre), x) # integrate - else: # 'continuous' - i = np.where(mrec[1:] != mrec[:-1])[0] # points where x-axis (recall) changes - ap = np.sum((mrec[i + 1] - mrec[i]) * mpre[i + 1]) # area under curve - - return ap, mpre, mrec - - -def ap_per_class( - tp, conf, pred_cls, target_cls, plot=False, on_plot=None, save_dir=Path(), names=(), eps=1e-16, prefix="" -): - """ - Computes the average precision per class for object detection evaluation. - - Args: - tp (np.ndarray): Binary array indicating whether the detection is correct (True) or not (False). - conf (np.ndarray): Array of confidence scores of the detections. - pred_cls (np.ndarray): Array of predicted classes of the detections. - target_cls (np.ndarray): Array of true classes of the detections. - plot (bool, optional): Whether to plot PR curves or not. Defaults to False. - on_plot (func, optional): A callback to pass plots path and data when they are rendered. Defaults to None. - save_dir (Path, optional): Directory to save the PR curves. Defaults to an empty path. - names (tuple, optional): Tuple of class names to plot PR curves. Defaults to an empty tuple. - eps (float, optional): A small value to avoid division by zero. Defaults to 1e-16. - prefix (str, optional): A prefix string for saving the plot files. Defaults to an empty string. - - Returns: - (tuple): A tuple of six arrays and one array of unique classes, where: - tp (np.ndarray): True positive counts at threshold given by max F1 metric for each class.Shape: (nc,). - fp (np.ndarray): False positive counts at threshold given by max F1 metric for each class. Shape: (nc,). - p (np.ndarray): Precision values at threshold given by max F1 metric for each class. Shape: (nc,). - r (np.ndarray): Recall values at threshold given by max F1 metric for each class. Shape: (nc,). - f1 (np.ndarray): F1-score values at threshold given by max F1 metric for each class. Shape: (nc,). - ap (np.ndarray): Average precision for each class at different IoU thresholds. Shape: (nc, 10). - unique_classes (np.ndarray): An array of unique classes that have data. Shape: (nc,). - p_curve (np.ndarray): Precision curves for each class. Shape: (nc, 1000). - r_curve (np.ndarray): Recall curves for each class. Shape: (nc, 1000). - f1_curve (np.ndarray): F1-score curves for each class. Shape: (nc, 1000). - x (np.ndarray): X-axis values for the curves. Shape: (1000,). - prec_values: Precision values at mAP@0.5 for each class. Shape: (nc, 1000). - """ - - # Sort by objectness - i = np.argsort(-conf) - tp, conf, pred_cls = tp[i], conf[i], pred_cls[i] - - # Find unique classes - unique_classes, nt = np.unique(target_cls, return_counts=True) - nc = unique_classes.shape[0] # number of classes, number of detections - - # Create Precision-Recall curve and compute AP for each class - x, prec_values = np.linspace(0, 1, 1000), [] - - # Average precision, precision and recall curves - ap, p_curve, r_curve = np.zeros((nc, tp.shape[1])), np.zeros((nc, 1000)), np.zeros((nc, 1000)) - for ci, c in enumerate(unique_classes): - i = pred_cls == c - n_l = nt[ci] # number of labels - n_p = i.sum() # number of predictions - if n_p == 0 or n_l == 0: - continue - - # Accumulate FPs and TPs - fpc = (1 - tp[i]).cumsum(0) - tpc = tp[i].cumsum(0) - - # Recall - recall = tpc / (n_l + eps) # recall curve - r_curve[ci] = np.interp(-x, -conf[i], recall[:, 0], left=0) # negative x, xp because xp decreases - - # Precision - precision = tpc / (tpc + fpc) # precision curve - p_curve[ci] = np.interp(-x, -conf[i], precision[:, 0], left=1) # p at pr_score - - # AP from recall-precision curve - for j in range(tp.shape[1]): - ap[ci, j], mpre, mrec = compute_ap(recall[:, j], precision[:, j]) - if plot and j == 0: - prec_values.append(np.interp(x, mrec, mpre)) # precision at mAP@0.5 - - prec_values = np.array(prec_values) # (nc, 1000) - - # Compute F1 (harmonic mean of precision and recall) - f1_curve = 2 * p_curve * r_curve / (p_curve + r_curve + eps) - names = [v for k, v in names.items() if k in unique_classes] # list: only classes that have data - names = dict(enumerate(names)) # to dict - if plot: - plot_pr_curve(x, prec_values, ap, save_dir / f"{prefix}PR_curve.png", names, on_plot=on_plot) - plot_mc_curve(x, f1_curve, save_dir / f"{prefix}F1_curve.png", names, ylabel="F1", on_plot=on_plot) - plot_mc_curve(x, p_curve, save_dir / f"{prefix}P_curve.png", names, ylabel="Precision", on_plot=on_plot) - plot_mc_curve(x, r_curve, save_dir / f"{prefix}R_curve.png", names, ylabel="Recall", on_plot=on_plot) - - i = smooth(f1_curve.mean(0), 0.1).argmax() # max F1 index - p, r, f1 = p_curve[:, i], r_curve[:, i], f1_curve[:, i] # max-F1 precision, recall, F1 values - tp = (r * nt).round() # true positives - fp = (tp / (p + eps) - tp).round() # false positives - return tp, fp, p, r, f1, ap, unique_classes.astype(int), p_curve, r_curve, f1_curve, x, prec_values - - -class Metric(SimpleClass): - """ - Class for computing evaluation metrics for YOLOv8 model. - - Attributes: - p (list): Precision for each class. Shape: (nc,). - r (list): Recall for each class. Shape: (nc,). - f1 (list): F1 score for each class. Shape: (nc,). - all_ap (list): AP scores for all classes and all IoU thresholds. Shape: (nc, 10). - ap_class_index (list): Index of class for each AP score. Shape: (nc,). - nc (int): Number of classes. - - Methods: - ap50(): AP at IoU threshold of 0.5 for all classes. Returns: List of AP scores. Shape: (nc,) or []. - ap(): AP at IoU thresholds from 0.5 to 0.95 for all classes. Returns: List of AP scores. Shape: (nc,) or []. - mp(): Mean precision of all classes. Returns: Float. - mr(): Mean recall of all classes. Returns: Float. - map50(): Mean AP at IoU threshold of 0.5 for all classes. Returns: Float. - map75(): Mean AP at IoU threshold of 0.75 for all classes. Returns: Float. - map(): Mean AP at IoU thresholds from 0.5 to 0.95 for all classes. Returns: Float. - mean_results(): Mean of results, returns mp, mr, map50, map. - class_result(i): Class-aware result, returns p[i], r[i], ap50[i], ap[i]. - maps(): mAP of each class. Returns: Array of mAP scores, shape: (nc,). - fitness(): Model fitness as a weighted combination of metrics. Returns: Float. - update(results): Update metric attributes with new evaluation results. - """ - - def __init__(self) -> None: - """Initializes a Metric instance for computing evaluation metrics for the YOLOv8 model.""" - self.p = [] # (nc, ) - self.r = [] # (nc, ) - self.f1 = [] # (nc, ) - self.all_ap = [] # (nc, 10) - self.ap_class_index = [] # (nc, ) - self.nc = 0 - - @property - def ap50(self): - """ - Returns the Average Precision (AP) at an IoU threshold of 0.5 for all classes. - - Returns: - (np.ndarray, list): Array of shape (nc,) with AP50 values per class, or an empty list if not available. - """ - return self.all_ap[:, 0] if len(self.all_ap) else [] - - @property - def ap(self): - """ - Returns the Average Precision (AP) at an IoU threshold of 0.5-0.95 for all classes. - - Returns: - (np.ndarray, list): Array of shape (nc,) with AP50-95 values per class, or an empty list if not available. - """ - return self.all_ap.mean(1) if len(self.all_ap) else [] - - @property - def mp(self): - """ - Returns the Mean Precision of all classes. - - Returns: - (float): The mean precision of all classes. - """ - return self.p.mean() if len(self.p) else 0.0 - - @property - def mr(self): - """ - Returns the Mean Recall of all classes. - - Returns: - (float): The mean recall of all classes. - """ - return self.r.mean() if len(self.r) else 0.0 - - @property - def map50(self): - """ - Returns the mean Average Precision (mAP) at an IoU threshold of 0.5. - - Returns: - (float): The mAP at an IoU threshold of 0.5. - """ - return self.all_ap[:, 0].mean() if len(self.all_ap) else 0.0 - - @property - def map75(self): - """ - Returns the mean Average Precision (mAP) at an IoU threshold of 0.75. - - Returns: - (float): The mAP at an IoU threshold of 0.75. - """ - return self.all_ap[:, 5].mean() if len(self.all_ap) else 0.0 - - @property - def map(self): - """ - Returns the mean Average Precision (mAP) over IoU thresholds of 0.5 - 0.95 in steps of 0.05. - - Returns: - (float): The mAP over IoU thresholds of 0.5 - 0.95 in steps of 0.05. - """ - return self.all_ap.mean() if len(self.all_ap) else 0.0 - - def mean_results(self): - """Mean of results, return mp, mr, map50, map.""" - return [self.mp, self.mr, self.map50, self.map] - - def class_result(self, i): - """Class-aware result, return p[i], r[i], ap50[i], ap[i].""" - return self.p[i], self.r[i], self.ap50[i], self.ap[i] - - @property - def maps(self): - """MAP of each class.""" - maps = np.zeros(self.nc) + self.map - for i, c in enumerate(self.ap_class_index): - maps[c] = self.ap[i] - return maps - - def fitness(self): - """Model fitness as a weighted combination of metrics.""" - w = [0.0, 0.0, 0.1, 0.9] # weights for [P, R, mAP@0.5, mAP@0.5:0.95] - return (np.array(self.mean_results()) * w).sum() - - def update(self, results): - """ - Updates the evaluation metrics of the model with a new set of results. - - Args: - results (tuple): A tuple containing the following evaluation metrics: - - p (list): Precision for each class. Shape: (nc,). - - r (list): Recall for each class. Shape: (nc,). - - f1 (list): F1 score for each class. Shape: (nc,). - - all_ap (list): AP scores for all classes and all IoU thresholds. Shape: (nc, 10). - - ap_class_index (list): Index of class for each AP score. Shape: (nc,). - - Side Effects: - Updates the class attributes `self.p`, `self.r`, `self.f1`, `self.all_ap`, and `self.ap_class_index` based - on the values provided in the `results` tuple. - """ - ( - self.p, - self.r, - self.f1, - self.all_ap, - self.ap_class_index, - self.p_curve, - self.r_curve, - self.f1_curve, - self.px, - self.prec_values, - ) = results - - @property - def curves(self): - """Returns a list of curves for accessing specific metrics curves.""" - return [] - - @property - def curves_results(self): - """Returns a list of curves for accessing specific metrics curves.""" - return [ - [self.px, self.prec_values, "Recall", "Precision"], - [self.px, self.f1_curve, "Confidence", "F1"], - [self.px, self.p_curve, "Confidence", "Precision"], - [self.px, self.r_curve, "Confidence", "Recall"], - ] - - -class DetMetrics(SimpleClass): - """ - This class is a utility class for computing detection metrics such as precision, recall, and mean average precision - (mAP) of an object detection model. - - Args: - save_dir (Path): A path to the directory where the output plots will be saved. Defaults to current directory. - plot (bool): A flag that indicates whether to plot precision-recall curves for each class. Defaults to False. - on_plot (func): An optional callback to pass plots path and data when they are rendered. Defaults to None. - names (tuple of str): A tuple of strings that represents the names of the classes. Defaults to an empty tuple. - - Attributes: - save_dir (Path): A path to the directory where the output plots will be saved. - plot (bool): A flag that indicates whether to plot the precision-recall curves for each class. - on_plot (func): An optional callback to pass plots path and data when they are rendered. - names (tuple of str): A tuple of strings that represents the names of the classes. - box (Metric): An instance of the Metric class for storing the results of the detection metrics. - speed (dict): A dictionary for storing the execution time of different parts of the detection process. - - Methods: - process(tp, conf, pred_cls, target_cls): Updates the metric results with the latest batch of predictions. - keys: Returns a list of keys for accessing the computed detection metrics. - mean_results: Returns a list of mean values for the computed detection metrics. - class_result(i): Returns a list of values for the computed detection metrics for a specific class. - maps: Returns a dictionary of mean average precision (mAP) values for different IoU thresholds. - fitness: Computes the fitness score based on the computed detection metrics. - ap_class_index: Returns a list of class indices sorted by their average precision (AP) values. - results_dict: Returns a dictionary that maps detection metric keys to their computed values. - curves: TODO - curves_results: TODO - """ - - def __init__(self, save_dir=Path("."), plot=False, on_plot=None, names=()) -> None: - """Initialize a DetMetrics instance with a save directory, plot flag, callback function, and class names.""" - self.save_dir = save_dir - self.plot = plot - self.on_plot = on_plot - self.names = names - self.box = Metric() - self.speed = {"preprocess": 0.0, "inference": 0.0, "loss": 0.0, "postprocess": 0.0} - self.task = "detect" - - def process(self, tp, conf, pred_cls, target_cls): - """Process predicted results for object detection and update metrics.""" - results = ap_per_class( - tp, - conf, - pred_cls, - target_cls, - plot=self.plot, - save_dir=self.save_dir, - names=self.names, - on_plot=self.on_plot, - )[2:] - self.box.nc = len(self.names) - self.box.update(results) - - @property - def keys(self): - """Returns a list of keys for accessing specific metrics.""" - return ["metrics/precision(B)", "metrics/recall(B)", "metrics/mAP50(B)", "metrics/mAP50-95(B)"] - - def mean_results(self): - """Calculate mean of detected objects & return precision, recall, mAP50, and mAP50-95.""" - return self.box.mean_results() - - def class_result(self, i): - """Return the result of evaluating the performance of an object detection model on a specific class.""" - return self.box.class_result(i) - - @property - def maps(self): - """Returns mean Average Precision (mAP) scores per class.""" - return self.box.maps - - @property - def fitness(self): - """Returns the fitness of box object.""" - return self.box.fitness() - - @property - def ap_class_index(self): - """Returns the average precision index per class.""" - return self.box.ap_class_index - - @property - def results_dict(self): - """Returns dictionary of computed performance metrics and statistics.""" - return dict(zip(self.keys + ["fitness"], self.mean_results() + [self.fitness])) - - @property - def curves(self): - """Returns a list of curves for accessing specific metrics curves.""" - return ["Precision-Recall(B)", "F1-Confidence(B)", "Precision-Confidence(B)", "Recall-Confidence(B)"] - - @property - def curves_results(self): - """Returns dictionary of computed performance metrics and statistics.""" - return self.box.curves_results - - -class SegmentMetrics(SimpleClass): - """ - Calculates and aggregates detection and segmentation metrics over a given set of classes. - - Args: - save_dir (Path): Path to the directory where the output plots should be saved. Default is the current directory. - plot (bool): Whether to save the detection and segmentation plots. Default is False. - on_plot (func): An optional callback to pass plots path and data when they are rendered. Defaults to None. - names (list): List of class names. Default is an empty list. - - Attributes: - save_dir (Path): Path to the directory where the output plots should be saved. - plot (bool): Whether to save the detection and segmentation plots. - on_plot (func): An optional callback to pass plots path and data when they are rendered. - names (list): List of class names. - box (Metric): An instance of the Metric class to calculate box detection metrics. - seg (Metric): An instance of the Metric class to calculate mask segmentation metrics. - speed (dict): Dictionary to store the time taken in different phases of inference. - - Methods: - process(tp_m, tp_b, conf, pred_cls, target_cls): Processes metrics over the given set of predictions. - mean_results(): Returns the mean of the detection and segmentation metrics over all the classes. - class_result(i): Returns the detection and segmentation metrics of class `i`. - maps: Returns the mean Average Precision (mAP) scores for IoU thresholds ranging from 0.50 to 0.95. - fitness: Returns the fitness scores, which are a single weighted combination of metrics. - ap_class_index: Returns the list of indices of classes used to compute Average Precision (AP). - results_dict: Returns the dictionary containing all the detection and segmentation metrics and fitness score. - """ - - def __init__(self, save_dir=Path("."), plot=False, on_plot=None, names=()) -> None: - """Initialize a SegmentMetrics instance with a save directory, plot flag, callback function, and class names.""" - self.save_dir = save_dir - self.plot = plot - self.on_plot = on_plot - self.names = names - self.box = Metric() - self.seg = Metric() - self.speed = {"preprocess": 0.0, "inference": 0.0, "loss": 0.0, "postprocess": 0.0} - self.task = "segment" - - def process(self, tp, tp_m, conf, pred_cls, target_cls): - """ - Processes the detection and segmentation metrics over the given set of predictions. - - Args: - tp (list): List of True Positive boxes. - tp_m (list): List of True Positive masks. - conf (list): List of confidence scores. - pred_cls (list): List of predicted classes. - target_cls (list): List of target classes. - """ - - results_mask = ap_per_class( - tp_m, - conf, - pred_cls, - target_cls, - plot=self.plot, - on_plot=self.on_plot, - save_dir=self.save_dir, - names=self.names, - prefix="Mask", - )[2:] - self.seg.nc = len(self.names) - self.seg.update(results_mask) - results_box = ap_per_class( - tp, - conf, - pred_cls, - target_cls, - plot=self.plot, - on_plot=self.on_plot, - save_dir=self.save_dir, - names=self.names, - prefix="Box", - )[2:] - self.box.nc = len(self.names) - self.box.update(results_box) - - @property - def keys(self): - """Returns a list of keys for accessing metrics.""" - return [ - "metrics/precision(B)", - "metrics/recall(B)", - "metrics/mAP50(B)", - "metrics/mAP50-95(B)", - "metrics/precision(M)", - "metrics/recall(M)", - "metrics/mAP50(M)", - "metrics/mAP50-95(M)", - ] - - def mean_results(self): - """Return the mean metrics for bounding box and segmentation results.""" - return self.box.mean_results() + self.seg.mean_results() - - def class_result(self, i): - """Returns classification results for a specified class index.""" - return self.box.class_result(i) + self.seg.class_result(i) - - @property - def maps(self): - """Returns mAP scores for object detection and semantic segmentation models.""" - return self.box.maps + self.seg.maps - - @property - def fitness(self): - """Get the fitness score for both segmentation and bounding box models.""" - return self.seg.fitness() + self.box.fitness() - - @property - def ap_class_index(self): - """Boxes and masks have the same ap_class_index.""" - return self.box.ap_class_index - - @property - def results_dict(self): - """Returns results of object detection model for evaluation.""" - return dict(zip(self.keys + ["fitness"], self.mean_results() + [self.fitness])) - - @property - def curves(self): - """Returns a list of curves for accessing specific metrics curves.""" - return [ - "Precision-Recall(B)", - "F1-Confidence(B)", - "Precision-Confidence(B)", - "Recall-Confidence(B)", - "Precision-Recall(M)", - "F1-Confidence(M)", - "Precision-Confidence(M)", - "Recall-Confidence(M)", - ] - - @property - def curves_results(self): - """Returns dictionary of computed performance metrics and statistics.""" - return self.box.curves_results + self.seg.curves_results - - -class PoseMetrics(SegmentMetrics): - """ - Calculates and aggregates detection and pose metrics over a given set of classes. - - Args: - save_dir (Path): Path to the directory where the output plots should be saved. Default is the current directory. - plot (bool): Whether to save the detection and segmentation plots. Default is False. - on_plot (func): An optional callback to pass plots path and data when they are rendered. Defaults to None. - names (list): List of class names. Default is an empty list. - - Attributes: - save_dir (Path): Path to the directory where the output plots should be saved. - plot (bool): Whether to save the detection and segmentation plots. - on_plot (func): An optional callback to pass plots path and data when they are rendered. - names (list): List of class names. - box (Metric): An instance of the Metric class to calculate box detection metrics. - pose (Metric): An instance of the Metric class to calculate mask segmentation metrics. - speed (dict): Dictionary to store the time taken in different phases of inference. - - Methods: - process(tp_m, tp_b, conf, pred_cls, target_cls): Processes metrics over the given set of predictions. - mean_results(): Returns the mean of the detection and segmentation metrics over all the classes. - class_result(i): Returns the detection and segmentation metrics of class `i`. - maps: Returns the mean Average Precision (mAP) scores for IoU thresholds ranging from 0.50 to 0.95. - fitness: Returns the fitness scores, which are a single weighted combination of metrics. - ap_class_index: Returns the list of indices of classes used to compute Average Precision (AP). - results_dict: Returns the dictionary containing all the detection and segmentation metrics and fitness score. - """ - - def __init__(self, save_dir=Path("."), plot=False, on_plot=None, names=()) -> None: - """Initialize the PoseMetrics class with directory path, class names, and plotting options.""" - super().__init__(save_dir, plot, names) - self.save_dir = save_dir - self.plot = plot - self.on_plot = on_plot - self.names = names - self.box = Metric() - self.pose = Metric() - self.speed = {"preprocess": 0.0, "inference": 0.0, "loss": 0.0, "postprocess": 0.0} - self.task = "pose" - - def process(self, tp, tp_p, conf, pred_cls, target_cls): - """ - Processes the detection and pose metrics over the given set of predictions. - - Args: - tp (list): List of True Positive boxes. - tp_p (list): List of True Positive keypoints. - conf (list): List of confidence scores. - pred_cls (list): List of predicted classes. - target_cls (list): List of target classes. - """ - - results_pose = ap_per_class( - tp_p, - conf, - pred_cls, - target_cls, - plot=self.plot, - on_plot=self.on_plot, - save_dir=self.save_dir, - names=self.names, - prefix="Pose", - )[2:] - self.pose.nc = len(self.names) - self.pose.update(results_pose) - results_box = ap_per_class( - tp, - conf, - pred_cls, - target_cls, - plot=self.plot, - on_plot=self.on_plot, - save_dir=self.save_dir, - names=self.names, - prefix="Box", - )[2:] - self.box.nc = len(self.names) - self.box.update(results_box) - - @property - def keys(self): - """Returns list of evaluation metric keys.""" - return [ - "metrics/precision(B)", - "metrics/recall(B)", - "metrics/mAP50(B)", - "metrics/mAP50-95(B)", - "metrics/precision(P)", - "metrics/recall(P)", - "metrics/mAP50(P)", - "metrics/mAP50-95(P)", - ] - - def mean_results(self): - """Return the mean results of box and pose.""" - return self.box.mean_results() + self.pose.mean_results() - - def class_result(self, i): - """Return the class-wise detection results for a specific class i.""" - return self.box.class_result(i) + self.pose.class_result(i) - - @property - def maps(self): - """Returns the mean average precision (mAP) per class for both box and pose detections.""" - return self.box.maps + self.pose.maps - - @property - def fitness(self): - """Computes classification metrics and speed using the `targets` and `pred` inputs.""" - return self.pose.fitness() + self.box.fitness() - - @property - def curves(self): - """Returns a list of curves for accessing specific metrics curves.""" - return [ - "Precision-Recall(B)", - "F1-Confidence(B)", - "Precision-Confidence(B)", - "Recall-Confidence(B)", - "Precision-Recall(P)", - "F1-Confidence(P)", - "Precision-Confidence(P)", - "Recall-Confidence(P)", - ] - - @property - def curves_results(self): - """Returns dictionary of computed performance metrics and statistics.""" - return self.box.curves_results + self.pose.curves_results - - -class ClassifyMetrics(SimpleClass): - """ - Class for computing classification metrics including top-1 and top-5 accuracy. - - Attributes: - top1 (float): The top-1 accuracy. - top5 (float): The top-5 accuracy. - speed (Dict[str, float]): A dictionary containing the time taken for each step in the pipeline. - - Properties: - fitness (float): The fitness of the model, which is equal to top-5 accuracy. - results_dict (Dict[str, Union[float, str]]): A dictionary containing the classification metrics and fitness. - keys (List[str]): A list of keys for the results_dict. - - Methods: - process(targets, pred): Processes the targets and predictions to compute classification metrics. - """ - - def __init__(self) -> None: - """Initialize a ClassifyMetrics instance.""" - self.top1 = 0 - self.top5 = 0 - self.speed = {"preprocess": 0.0, "inference": 0.0, "loss": 0.0, "postprocess": 0.0} - self.task = "classify" - - def process(self, targets, pred): - """Target classes and predicted classes.""" - pred, targets = torch.cat(pred), torch.cat(targets) - correct = (targets[:, None] == pred).float() - acc = torch.stack((correct[:, 0], correct.max(1).values), dim=1) # (top1, top5) accuracy - self.top1, self.top5 = acc.mean(0).tolist() - - @property - def fitness(self): - """Returns mean of top-1 and top-5 accuracies as fitness score.""" - return (self.top1 + self.top5) / 2 - - @property - def results_dict(self): - """Returns a dictionary with model's performance metrics and fitness score.""" - return dict(zip(self.keys + ["fitness"], [self.top1, self.top5, self.fitness])) - - @property - def keys(self): - """Returns a list of keys for the results_dict property.""" - return ["metrics/accuracy_top1", "metrics/accuracy_top5"] - - @property - def curves(self): - """Returns a list of curves for accessing specific metrics curves.""" - return [] - - @property - def curves_results(self): - """Returns a list of curves for accessing specific metrics curves.""" - return [] - - -class OBBMetrics(SimpleClass): - def __init__(self, save_dir=Path("."), plot=False, on_plot=None, names=()) -> None: - self.save_dir = save_dir - self.plot = plot - self.on_plot = on_plot - self.names = names - self.box = Metric() - self.speed = {"preprocess": 0.0, "inference": 0.0, "loss": 0.0, "postprocess": 0.0} - - def process(self, tp, conf, pred_cls, target_cls): - """Process predicted results for object detection and update metrics.""" - results = ap_per_class( - tp, - conf, - pred_cls, - target_cls, - plot=self.plot, - save_dir=self.save_dir, - names=self.names, - on_plot=self.on_plot, - )[2:] - self.box.nc = len(self.names) - self.box.update(results) - - @property - def keys(self): - """Returns a list of keys for accessing specific metrics.""" - return ["metrics/precision(B)", "metrics/recall(B)", "metrics/mAP50(B)", "metrics/mAP50-95(B)"] - - def mean_results(self): - """Calculate mean of detected objects & return precision, recall, mAP50, and mAP50-95.""" - return self.box.mean_results() - - def class_result(self, i): - """Return the result of evaluating the performance of an object detection model on a specific class.""" - return self.box.class_result(i) - - @property - def maps(self): - """Returns mean Average Precision (mAP) scores per class.""" - return self.box.maps - - @property - def fitness(self): - """Returns the fitness of box object.""" - return self.box.fitness() - - @property - def ap_class_index(self): - """Returns the average precision index per class.""" - return self.box.ap_class_index - - @property - def results_dict(self): - """Returns dictionary of computed performance metrics and statistics.""" - return dict(zip(self.keys + ["fitness"], self.mean_results() + [self.fitness])) - - @property - def curves(self): - """Returns a list of curves for accessing specific metrics curves.""" - return [] - - @property - def curves_results(self): - """Returns a list of curves for accessing specific metrics curves.""" - return [] diff --git a/ultralytics-main/ultralytics/utils/ops.py b/ultralytics-main/ultralytics/utils/ops.py deleted file mode 100644 index 439f944..0000000 --- a/ultralytics-main/ultralytics/utils/ops.py +++ /dev/null @@ -1,849 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import contextlib -import math -import re -import time - -import cv2 -import numpy as np -import torch -import torch.nn.functional as F -import torchvision - -from ultralytics.utils import LOGGER -from ultralytics.utils.metrics import batch_probiou - - -class Profile(contextlib.ContextDecorator): - """ - YOLOv8 Profile class. Use as a decorator with @Profile() or as a context manager with 'with Profile():'. - - Example: - ```python - from ultralytics.utils.ops import Profile - - with Profile(device=device) as dt: - pass # slow operation here - - print(dt) # prints "Elapsed time is 9.5367431640625e-07 s" - ``` - """ - - def __init__(self, t=0.0, device: torch.device = None): - """ - Initialize the Profile class. - - Args: - t (float): Initial time. Defaults to 0.0. - device (torch.device): Devices used for model inference. Defaults to None (cpu). - """ - self.t = t - self.device = device - self.cuda = bool(device and str(device).startswith("cuda")) - - def __enter__(self): - """Start timing.""" - self.start = self.time() - return self - - def __exit__(self, type, value, traceback): # noqa - """Stop timing.""" - self.dt = self.time() - self.start # delta-time - self.t += self.dt # accumulate dt - - def __str__(self): - """Returns a human-readable string representing the accumulated elapsed time in the profiler.""" - return f"Elapsed time is {self.t} s" - - def time(self): - """Get current time.""" - if self.cuda: - torch.cuda.synchronize(self.device) - return time.time() - - -def segment2box(segment, width=640, height=640): - """ - Convert 1 segment label to 1 box label, applying inside-image constraint, i.e. (xy1, xy2, ...) to (xyxy). - - Args: - segment (torch.Tensor): the segment label - width (int): the width of the image. Defaults to 640 - height (int): The height of the image. Defaults to 640 - - Returns: - (np.ndarray): the minimum and maximum x and y values of the segment. - """ - x, y = segment.T # segment xy - inside = (x >= 0) & (y >= 0) & (x <= width) & (y <= height) - x = x[inside] - y = y[inside] - return ( - np.array([x.min(), y.min(), x.max(), y.max()], dtype=segment.dtype) - if any(x) - else np.zeros(4, dtype=segment.dtype) - ) # xyxy - - -def scale_boxes(img1_shape, boxes, img0_shape, ratio_pad=None, padding=True, xywh=False): - """ - Rescales bounding boxes (in the format of xyxy by default) from the shape of the image they were originally - specified in (img1_shape) to the shape of a different image (img0_shape). - - Args: - img1_shape (tuple): The shape of the image that the bounding boxes are for, in the format of (height, width). - boxes (torch.Tensor): the bounding boxes of the objects in the image, in the format of (x1, y1, x2, y2) - img0_shape (tuple): the shape of the target image, in the format of (height, width). - ratio_pad (tuple): a tuple of (ratio, pad) for scaling the boxes. If not provided, the ratio and pad will be - calculated based on the size difference between the two images. - padding (bool): If True, assuming the boxes is based on image augmented by yolo style. If False then do regular - rescaling. - xywh (bool): The box format is xywh or not, default=False. - - Returns: - boxes (torch.Tensor): The scaled bounding boxes, in the format of (x1, y1, x2, y2) - """ - if ratio_pad is None: # calculate from img0_shape - gain = min(img1_shape[0] / img0_shape[0], img1_shape[1] / img0_shape[1]) # gain = old / new - pad = ( - round((img1_shape[1] - img0_shape[1] * gain) / 2 - 0.1), - round((img1_shape[0] - img0_shape[0] * gain) / 2 - 0.1), - ) # wh padding - else: - gain = ratio_pad[0][0] - pad = ratio_pad[1] - - if padding: - boxes[..., 0] -= pad[0] # x padding - boxes[..., 1] -= pad[1] # y padding - if not xywh: - boxes[..., 2] -= pad[0] # x padding - boxes[..., 3] -= pad[1] # y padding - boxes[..., :4] /= gain - return clip_boxes(boxes, img0_shape) - - -def make_divisible(x, divisor): - """ - Returns the nearest number that is divisible by the given divisor. - - Args: - x (int): The number to make divisible. - divisor (int | torch.Tensor): The divisor. - - Returns: - (int): The nearest number divisible by the divisor. - """ - if isinstance(divisor, torch.Tensor): - divisor = int(divisor.max()) # to int - return math.ceil(x / divisor) * divisor - - -def nms_rotated(boxes, scores, threshold=0.45): - """ - NMS for obbs, powered by probiou and fast-nms. - - Args: - boxes (torch.Tensor): (N, 5), xywhr. - scores (torch.Tensor): (N, ). - threshold (float): IoU threshold. - - Returns: - """ - if len(boxes) == 0: - return np.empty((0,), dtype=np.int8) - sorted_idx = torch.argsort(scores, descending=True) - boxes = boxes[sorted_idx] - ious = batch_probiou(boxes, boxes).triu_(diagonal=1) - pick = torch.nonzero(ious.max(dim=0)[0] < threshold).squeeze_(-1) - return sorted_idx[pick] - - -def non_max_suppression( - prediction, - conf_thres=0.25, - iou_thres=0.45, - classes=None, - agnostic=False, - multi_label=False, - labels=(), - max_det=300, - nc=0, # number of classes (optional) - max_time_img=0.05, - max_nms=30000, - max_wh=7680, - in_place=True, - rotated=False, -): - """ - Perform non-maximum suppression (NMS) on a set of boxes, with support for masks and multiple labels per box. - - Args: - prediction (torch.Tensor): A tensor of shape (batch_size, num_classes + 4 + num_masks, num_boxes) - containing the predicted boxes, classes, and masks. The tensor should be in the format - output by a model, such as YOLO. - conf_thres (float): The confidence threshold below which boxes will be filtered out. - Valid values are between 0.0 and 1.0. - iou_thres (float): The IoU threshold below which boxes will be filtered out during NMS. - Valid values are between 0.0 and 1.0. - classes (List[int]): A list of class indices to consider. If None, all classes will be considered. - agnostic (bool): If True, the model is agnostic to the number of classes, and all - classes will be considered as one. - multi_label (bool): If True, each box may have multiple labels. - labels (List[List[Union[int, float, torch.Tensor]]]): A list of lists, where each inner - list contains the apriori labels for a given image. The list should be in the format - output by a dataloader, with each label being a tuple of (class_index, x1, y1, x2, y2). - max_det (int): The maximum number of boxes to keep after NMS. - nc (int, optional): The number of classes output by the model. Any indices after this will be considered masks. - max_time_img (float): The maximum time (seconds) for processing one image. - max_nms (int): The maximum number of boxes into torchvision.ops.nms(). - max_wh (int): The maximum box width and height in pixels. - in_place (bool): If True, the input prediction tensor will be modified in place. - - Returns: - (List[torch.Tensor]): A list of length batch_size, where each element is a tensor of - shape (num_boxes, 6 + num_masks) containing the kept boxes, with columns - (x1, y1, x2, y2, confidence, class, mask1, mask2, ...). - """ - - # Checks - assert 0 <= conf_thres <= 1, f"Invalid Confidence threshold {conf_thres}, valid values are between 0.0 and 1.0" - assert 0 <= iou_thres <= 1, f"Invalid IoU {iou_thres}, valid values are between 0.0 and 1.0" - if isinstance(prediction, (list, tuple)): # YOLOv8 model in validation model, output = (inference_out, loss_out) - prediction = prediction[0] # select only inference output - - bs = prediction.shape[0] # batch size - nc = nc or (prediction.shape[1] - 4) # number of classes - nm = prediction.shape[1] - nc - 4 - mi = 4 + nc # mask start index - xc = prediction[:, 4:mi].amax(1) > conf_thres # candidates - - # Settings - # min_wh = 2 # (pixels) minimum box width and height - time_limit = 2.0 + max_time_img * bs # seconds to quit after - multi_label &= nc > 1 # multiple labels per box (adds 0.5ms/img) - - prediction = prediction.transpose(-1, -2) # shape(1,84,6300) to shape(1,6300,84) - if not rotated: - if in_place: - prediction[..., :4] = xywh2xyxy(prediction[..., :4]) # xywh to xyxy - else: - prediction = torch.cat((xywh2xyxy(prediction[..., :4]), prediction[..., 4:]), dim=-1) # xywh to xyxy - - t = time.time() - output = [torch.zeros((0, 6 + nm), device=prediction.device)] * bs - for xi, x in enumerate(prediction): # image index, image inference - # Apply constraints - # x[((x[:, 2:4] < min_wh) | (x[:, 2:4] > max_wh)).any(1), 4] = 0 # width-height - x = x[xc[xi]] # confidence - - # Cat apriori labels if autolabelling - if labels and len(labels[xi]) and not rotated: - lb = labels[xi] - v = torch.zeros((len(lb), nc + nm + 4), device=x.device) - v[:, :4] = xywh2xyxy(lb[:, 1:5]) # box - v[range(len(lb)), lb[:, 0].long() + 4] = 1.0 # cls - x = torch.cat((x, v), 0) - - # If none remain process next image - if not x.shape[0]: - continue - - # Detections matrix nx6 (xyxy, conf, cls) - box, cls, mask = x.split((4, nc, nm), 1) - - if multi_label: - i, j = torch.where(cls > conf_thres) - x = torch.cat((box[i], x[i, 4 + j, None], j[:, None].float(), mask[i]), 1) - else: # best class only - conf, j = cls.max(1, keepdim=True) - x = torch.cat((box, conf, j.float(), mask), 1)[conf.view(-1) > conf_thres] - - # Filter by class - if classes is not None: - x = x[(x[:, 5:6] == torch.tensor(classes, device=x.device)).any(1)] - - # Check shape - n = x.shape[0] # number of boxes - if not n: # no boxes - continue - if n > max_nms: # excess boxes - x = x[x[:, 4].argsort(descending=True)[:max_nms]] # sort by confidence and remove excess boxes - - # Batched NMS - c = x[:, 5:6] * (0 if agnostic else max_wh) # classes - scores = x[:, 4] # scores - if rotated: - boxes = torch.cat((x[:, :2] + c, x[:, 2:4], x[:, -1:]), dim=-1) # xywhr - i = nms_rotated(boxes, scores, iou_thres) - else: - boxes = x[:, :4] + c # boxes (offset by class) - i = torchvision.ops.nms(boxes, scores, iou_thres) # NMS - i = i[:max_det] # limit detections - - # # Experimental - # merge = False # use merge-NMS - # if merge and (1 < n < 3E3): # Merge NMS (boxes merged using weighted mean) - # # Update boxes as boxes(i,4) = weights(i,n) * boxes(n,4) - # from .metrics import box_iou - # iou = box_iou(boxes[i], boxes) > iou_thres # IoU matrix - # weights = iou * scores[None] # box weights - # x[i, :4] = torch.mm(weights, x[:, :4]).float() / weights.sum(1, keepdim=True) # merged boxes - # redundant = True # require redundant detections - # if redundant: - # i = i[iou.sum(1) > 1] # require redundancy - - output[xi] = x[i] - if (time.time() - t) > time_limit: - LOGGER.warning(f"WARNING ⚠️ NMS time limit {time_limit:.3f}s exceeded") - break # time limit exceeded - - return output - - -def clip_boxes(boxes, shape): - """ - Takes a list of bounding boxes and a shape (height, width) and clips the bounding boxes to the shape. - - Args: - boxes (torch.Tensor): the bounding boxes to clip - shape (tuple): the shape of the image - - Returns: - (torch.Tensor | numpy.ndarray): Clipped boxes - """ - if isinstance(boxes, torch.Tensor): # faster individually (WARNING: inplace .clamp_() Apple MPS bug) - boxes[..., 0] = boxes[..., 0].clamp(0, shape[1]) # x1 - boxes[..., 1] = boxes[..., 1].clamp(0, shape[0]) # y1 - boxes[..., 2] = boxes[..., 2].clamp(0, shape[1]) # x2 - boxes[..., 3] = boxes[..., 3].clamp(0, shape[0]) # y2 - else: # np.array (faster grouped) - boxes[..., [0, 2]] = boxes[..., [0, 2]].clip(0, shape[1]) # x1, x2 - boxes[..., [1, 3]] = boxes[..., [1, 3]].clip(0, shape[0]) # y1, y2 - return boxes - - -def clip_coords(coords, shape): - """ - Clip line coordinates to the image boundaries. - - Args: - coords (torch.Tensor | numpy.ndarray): A list of line coordinates. - shape (tuple): A tuple of integers representing the size of the image in the format (height, width). - - Returns: - (torch.Tensor | numpy.ndarray): Clipped coordinates - """ - if isinstance(coords, torch.Tensor): # faster individually (WARNING: inplace .clamp_() Apple MPS bug) - coords[..., 0] = coords[..., 0].clamp(0, shape[1]) # x - coords[..., 1] = coords[..., 1].clamp(0, shape[0]) # y - else: # np.array (faster grouped) - coords[..., 0] = coords[..., 0].clip(0, shape[1]) # x - coords[..., 1] = coords[..., 1].clip(0, shape[0]) # y - return coords - - -def scale_image(masks, im0_shape, ratio_pad=None): - """ - Takes a mask, and resizes it to the original image size. - - Args: - masks (np.ndarray): resized and padded masks/images, [h, w, num]/[h, w, 3]. - im0_shape (tuple): the original image shape - ratio_pad (tuple): the ratio of the padding to the original image. - - Returns: - masks (torch.Tensor): The masks that are being returned. - """ - # Rescale coordinates (xyxy) from im1_shape to im0_shape - im1_shape = masks.shape - if im1_shape[:2] == im0_shape[:2]: - return masks - if ratio_pad is None: # calculate from im0_shape - gain = min(im1_shape[0] / im0_shape[0], im1_shape[1] / im0_shape[1]) # gain = old / new - pad = (im1_shape[1] - im0_shape[1] * gain) / 2, (im1_shape[0] - im0_shape[0] * gain) / 2 # wh padding - else: - # gain = ratio_pad[0][0] - pad = ratio_pad[1] - top, left = int(pad[1]), int(pad[0]) # y, x - bottom, right = int(im1_shape[0] - pad[1]), int(im1_shape[1] - pad[0]) - - if len(masks.shape) < 2: - raise ValueError(f'"len of masks shape" should be 2 or 3, but got {len(masks.shape)}') - masks = masks[top:bottom, left:right] - masks = cv2.resize(masks, (im0_shape[1], im0_shape[0])) - if len(masks.shape) == 2: - masks = masks[:, :, None] - - return masks - - -def xyxy2xywh(x): - """ - Convert bounding box coordinates from (x1, y1, x2, y2) format to (x, y, width, height) format where (x1, y1) is the - top-left corner and (x2, y2) is the bottom-right corner. - - Args: - x (np.ndarray | torch.Tensor): The input bounding box coordinates in (x1, y1, x2, y2) format. - - Returns: - y (np.ndarray | torch.Tensor): The bounding box coordinates in (x, y, width, height) format. - """ - assert x.shape[-1] == 4, f"input shape last dimension expected 4 but input shape is {x.shape}" - y = torch.empty_like(x) if isinstance(x, torch.Tensor) else np.empty_like(x) # faster than clone/copy - y[..., 0] = (x[..., 0] + x[..., 2]) / 2 # x center - y[..., 1] = (x[..., 1] + x[..., 3]) / 2 # y center - y[..., 2] = x[..., 2] - x[..., 0] # width - y[..., 3] = x[..., 3] - x[..., 1] # height - return y - - -def xywh2xyxy(x): - """ - Convert bounding box coordinates from (x, y, width, height) format to (x1, y1, x2, y2) format where (x1, y1) is the - top-left corner and (x2, y2) is the bottom-right corner. - - Args: - x (np.ndarray | torch.Tensor): The input bounding box coordinates in (x, y, width, height) format. - - Returns: - y (np.ndarray | torch.Tensor): The bounding box coordinates in (x1, y1, x2, y2) format. - """ - assert x.shape[-1] == 4, f"input shape last dimension expected 4 but input shape is {x.shape}" - y = torch.empty_like(x) if isinstance(x, torch.Tensor) else np.empty_like(x) # faster than clone/copy - dw = x[..., 2] / 2 # half-width - dh = x[..., 3] / 2 # half-height - y[..., 0] = x[..., 0] - dw # top left x - y[..., 1] = x[..., 1] - dh # top left y - y[..., 2] = x[..., 0] + dw # bottom right x - y[..., 3] = x[..., 1] + dh # bottom right y - return y - - -def xywhn2xyxy(x, w=640, h=640, padw=0, padh=0): - """ - Convert normalized bounding box coordinates to pixel coordinates. - - Args: - x (np.ndarray | torch.Tensor): The bounding box coordinates. - w (int): Width of the image. Defaults to 640 - h (int): Height of the image. Defaults to 640 - padw (int): Padding width. Defaults to 0 - padh (int): Padding height. Defaults to 0 - Returns: - y (np.ndarray | torch.Tensor): The coordinates of the bounding box in the format [x1, y1, x2, y2] where - x1,y1 is the top-left corner, x2,y2 is the bottom-right corner of the bounding box. - """ - assert x.shape[-1] == 4, f"input shape last dimension expected 4 but input shape is {x.shape}" - y = torch.empty_like(x) if isinstance(x, torch.Tensor) else np.empty_like(x) # faster than clone/copy - y[..., 0] = w * (x[..., 0] - x[..., 2] / 2) + padw # top left x - y[..., 1] = h * (x[..., 1] - x[..., 3] / 2) + padh # top left y - y[..., 2] = w * (x[..., 0] + x[..., 2] / 2) + padw # bottom right x - y[..., 3] = h * (x[..., 1] + x[..., 3] / 2) + padh # bottom right y - return y - - -def xyxy2xywhn(x, w=640, h=640, clip=False, eps=0.0): - """ - Convert bounding box coordinates from (x1, y1, x2, y2) format to (x, y, width, height, normalized) format. x, y, - width and height are normalized to image dimensions. - - Args: - x (np.ndarray | torch.Tensor): The input bounding box coordinates in (x1, y1, x2, y2) format. - w (int): The width of the image. Defaults to 640 - h (int): The height of the image. Defaults to 640 - clip (bool): If True, the boxes will be clipped to the image boundaries. Defaults to False - eps (float): The minimum value of the box's width and height. Defaults to 0.0 - - Returns: - y (np.ndarray | torch.Tensor): The bounding box coordinates in (x, y, width, height, normalized) format - """ - if clip: - x = clip_boxes(x, (h - eps, w - eps)) - assert x.shape[-1] == 4, f"input shape last dimension expected 4 but input shape is {x.shape}" - y = torch.empty_like(x) if isinstance(x, torch.Tensor) else np.empty_like(x) # faster than clone/copy - y[..., 0] = ((x[..., 0] + x[..., 2]) / 2) / w # x center - y[..., 1] = ((x[..., 1] + x[..., 3]) / 2) / h # y center - y[..., 2] = (x[..., 2] - x[..., 0]) / w # width - y[..., 3] = (x[..., 3] - x[..., 1]) / h # height - return y - - -def xywh2ltwh(x): - """ - Convert the bounding box format from [x, y, w, h] to [x1, y1, w, h], where x1, y1 are the top-left coordinates. - - Args: - x (np.ndarray | torch.Tensor): The input tensor with the bounding box coordinates in the xywh format - - Returns: - y (np.ndarray | torch.Tensor): The bounding box coordinates in the xyltwh format - """ - y = x.clone() if isinstance(x, torch.Tensor) else np.copy(x) - y[..., 0] = x[..., 0] - x[..., 2] / 2 # top left x - y[..., 1] = x[..., 1] - x[..., 3] / 2 # top left y - return y - - -def xyxy2ltwh(x): - """ - Convert nx4 bounding boxes from [x1, y1, x2, y2] to [x1, y1, w, h], where xy1=top-left, xy2=bottom-right. - - Args: - x (np.ndarray | torch.Tensor): The input tensor with the bounding boxes coordinates in the xyxy format - - Returns: - y (np.ndarray | torch.Tensor): The bounding box coordinates in the xyltwh format. - """ - y = x.clone() if isinstance(x, torch.Tensor) else np.copy(x) - y[..., 2] = x[..., 2] - x[..., 0] # width - y[..., 3] = x[..., 3] - x[..., 1] # height - return y - - -def ltwh2xywh(x): - """ - Convert nx4 boxes from [x1, y1, w, h] to [x, y, w, h] where xy1=top-left, xy=center. - - Args: - x (torch.Tensor): the input tensor - - Returns: - y (np.ndarray | torch.Tensor): The bounding box coordinates in the xywh format. - """ - y = x.clone() if isinstance(x, torch.Tensor) else np.copy(x) - y[..., 0] = x[..., 0] + x[..., 2] / 2 # center x - y[..., 1] = x[..., 1] + x[..., 3] / 2 # center y - return y - - -def xyxyxyxy2xywhr(corners): - """ - Convert batched Oriented Bounding Boxes (OBB) from [xy1, xy2, xy3, xy4] to [xywh, rotation]. Rotation values are - expected in degrees from 0 to 90. - - Args: - corners (numpy.ndarray | torch.Tensor): Input corners of shape (n, 8). - - Returns: - (numpy.ndarray | torch.Tensor): Converted data in [cx, cy, w, h, rotation] format of shape (n, 5). - """ - is_torch = isinstance(corners, torch.Tensor) - points = corners.cpu().numpy() if is_torch else corners - points = points.reshape(len(corners), -1, 2) - rboxes = [] - for pts in points: - # NOTE: Use cv2.minAreaRect to get accurate xywhr, - # especially some objects are cut off by augmentations in dataloader. - (x, y), (w, h), angle = cv2.minAreaRect(pts) - rboxes.append([x, y, w, h, angle / 180 * np.pi]) - return ( - torch.tensor(rboxes, device=corners.device, dtype=corners.dtype) - if is_torch - else np.asarray(rboxes, dtype=points.dtype) - ) # rboxes - - -def xywhr2xyxyxyxy(rboxes): - """ - Convert batched Oriented Bounding Boxes (OBB) from [xywh, rotation] to [xy1, xy2, xy3, xy4]. Rotation values should - be in degrees from 0 to 90. - - Args: - rboxes (numpy.ndarray | torch.Tensor): Boxes in [cx, cy, w, h, rotation] format of shape (n, 5) or (b, n, 5). - - Returns: - (numpy.ndarray | torch.Tensor): Converted corner points of shape (n, 4, 2) or (b, n, 4, 2). - """ - is_numpy = isinstance(rboxes, np.ndarray) - cos, sin = (np.cos, np.sin) if is_numpy else (torch.cos, torch.sin) - - ctr = rboxes[..., :2] - w, h, angle = (rboxes[..., i : i + 1] for i in range(2, 5)) - cos_value, sin_value = cos(angle), sin(angle) - vec1 = [w / 2 * cos_value, w / 2 * sin_value] - vec2 = [-h / 2 * sin_value, h / 2 * cos_value] - vec1 = np.concatenate(vec1, axis=-1) if is_numpy else torch.cat(vec1, dim=-1) - vec2 = np.concatenate(vec2, axis=-1) if is_numpy else torch.cat(vec2, dim=-1) - pt1 = ctr + vec1 + vec2 - pt2 = ctr + vec1 - vec2 - pt3 = ctr - vec1 - vec2 - pt4 = ctr - vec1 + vec2 - return np.stack([pt1, pt2, pt3, pt4], axis=-2) if is_numpy else torch.stack([pt1, pt2, pt3, pt4], dim=-2) - - -def ltwh2xyxy(x): - """ - It converts the bounding box from [x1, y1, w, h] to [x1, y1, x2, y2] where xy1=top-left, xy2=bottom-right. - - Args: - x (np.ndarray | torch.Tensor): the input image - - Returns: - y (np.ndarray | torch.Tensor): the xyxy coordinates of the bounding boxes. - """ - y = x.clone() if isinstance(x, torch.Tensor) else np.copy(x) - y[..., 2] = x[..., 2] + x[..., 0] # width - y[..., 3] = x[..., 3] + x[..., 1] # height - return y - - -def segments2boxes(segments): - """ - It converts segment labels to box labels, i.e. (cls, xy1, xy2, ...) to (cls, xywh) - - Args: - segments (list): list of segments, each segment is a list of points, each point is a list of x, y coordinates - - Returns: - (np.ndarray): the xywh coordinates of the bounding boxes. - """ - boxes = [] - for s in segments: - x, y = s.T # segment xy - boxes.append([x.min(), y.min(), x.max(), y.max()]) # cls, xyxy - return xyxy2xywh(np.array(boxes)) # cls, xywh - - -def resample_segments(segments, n=1000): - """ - Inputs a list of segments (n,2) and returns a list of segments (n,2) up-sampled to n points each. - - Args: - segments (list): a list of (n,2) arrays, where n is the number of points in the segment. - n (int): number of points to resample the segment to. Defaults to 1000 - - Returns: - segments (list): the resampled segments. - """ - for i, s in enumerate(segments): - s = np.concatenate((s, s[0:1, :]), axis=0) - x = np.linspace(0, len(s) - 1, n) - xp = np.arange(len(s)) - segments[i] = ( - np.concatenate([np.interp(x, xp, s[:, i]) for i in range(2)], dtype=np.float32).reshape(2, -1).T - ) # segment xy - return segments - - -def crop_mask(masks, boxes): - """ - It takes a mask and a bounding box, and returns a mask that is cropped to the bounding box. - - Args: - masks (torch.Tensor): [n, h, w] tensor of masks - boxes (torch.Tensor): [n, 4] tensor of bbox coordinates in relative point form - - Returns: - (torch.Tensor): The masks are being cropped to the bounding box. - """ - _, h, w = masks.shape - x1, y1, x2, y2 = torch.chunk(boxes[:, :, None], 4, 1) # x1 shape(n,1,1) - r = torch.arange(w, device=masks.device, dtype=x1.dtype)[None, None, :] # rows shape(1,1,w) - c = torch.arange(h, device=masks.device, dtype=x1.dtype)[None, :, None] # cols shape(1,h,1) - - return masks * ((r >= x1) * (r < x2) * (c >= y1) * (c < y2)) - - -def process_mask_upsample(protos, masks_in, bboxes, shape): - """ - Takes the output of the mask head, and applies the mask to the bounding boxes. This produces masks of higher quality - but is slower. - - Args: - protos (torch.Tensor): [mask_dim, mask_h, mask_w] - masks_in (torch.Tensor): [n, mask_dim], n is number of masks after nms - bboxes (torch.Tensor): [n, 4], n is number of masks after nms - shape (tuple): the size of the input image (h,w) - - Returns: - (torch.Tensor): The upsampled masks. - """ - c, mh, mw = protos.shape # CHW - masks = (masks_in @ protos.float().view(c, -1)).sigmoid().view(-1, mh, mw) - masks = F.interpolate(masks[None], shape, mode="bilinear", align_corners=False)[0] # CHW - masks = crop_mask(masks, bboxes) # CHW - return masks.gt_(0.5) - - -def process_mask(protos, masks_in, bboxes, shape, upsample=False): - """ - Apply masks to bounding boxes using the output of the mask head. - - Args: - protos (torch.Tensor): A tensor of shape [mask_dim, mask_h, mask_w]. - masks_in (torch.Tensor): A tensor of shape [n, mask_dim], where n is the number of masks after NMS. - bboxes (torch.Tensor): A tensor of shape [n, 4], where n is the number of masks after NMS. - shape (tuple): A tuple of integers representing the size of the input image in the format (h, w). - upsample (bool): A flag to indicate whether to upsample the mask to the original image size. Default is False. - - Returns: - (torch.Tensor): A binary mask tensor of shape [n, h, w], where n is the number of masks after NMS, and h and w - are the height and width of the input image. The mask is applied to the bounding boxes. - """ - - c, mh, mw = protos.shape # CHW - ih, iw = shape - masks = (masks_in @ protos.float().view(c, -1)).sigmoid().view(-1, mh, mw) # CHW - width_ratio = mw / iw - height_ratio = mh / ih - - downsampled_bboxes = bboxes.clone() - downsampled_bboxes[:, 0] *= width_ratio - downsampled_bboxes[:, 2] *= width_ratio - downsampled_bboxes[:, 3] *= height_ratio - downsampled_bboxes[:, 1] *= height_ratio - - masks = crop_mask(masks, downsampled_bboxes) # CHW - if upsample: - masks = F.interpolate(masks[None], shape, mode="bilinear", align_corners=False)[0] # CHW - return masks.gt_(0.5) - - -def process_mask_native(protos, masks_in, bboxes, shape): - """ - It takes the output of the mask head, and crops it after upsampling to the bounding boxes. - - Args: - protos (torch.Tensor): [mask_dim, mask_h, mask_w] - masks_in (torch.Tensor): [n, mask_dim], n is number of masks after nms - bboxes (torch.Tensor): [n, 4], n is number of masks after nms - shape (tuple): the size of the input image (h,w) - - Returns: - masks (torch.Tensor): The returned masks with dimensions [h, w, n] - """ - c, mh, mw = protos.shape # CHW - masks = (masks_in @ protos.float().view(c, -1)).sigmoid().view(-1, mh, mw) - masks = scale_masks(masks[None], shape)[0] # CHW - masks = crop_mask(masks, bboxes) # CHW - return masks.gt_(0.5) - - -def scale_masks(masks, shape, padding=True): - """ - Rescale segment masks to shape. - - Args: - masks (torch.Tensor): (N, C, H, W). - shape (tuple): Height and width. - padding (bool): If True, assuming the boxes is based on image augmented by yolo style. If False then do regular - rescaling. - """ - mh, mw = masks.shape[2:] - gain = min(mh / shape[0], mw / shape[1]) # gain = old / new - pad = [mw - shape[1] * gain, mh - shape[0] * gain] # wh padding - if padding: - pad[0] /= 2 - pad[1] /= 2 - top, left = (int(pad[1]), int(pad[0])) if padding else (0, 0) # y, x - bottom, right = (int(mh - pad[1]), int(mw - pad[0])) - masks = masks[..., top:bottom, left:right] - - masks = F.interpolate(masks, shape, mode="bilinear", align_corners=False) # NCHW - return masks - - -def scale_coords(img1_shape, coords, img0_shape, ratio_pad=None, normalize=False, padding=True): - """ - Rescale segment coordinates (xy) from img1_shape to img0_shape. - - Args: - img1_shape (tuple): The shape of the image that the coords are from. - coords (torch.Tensor): the coords to be scaled of shape n,2. - img0_shape (tuple): the shape of the image that the segmentation is being applied to. - ratio_pad (tuple): the ratio of the image size to the padded image size. - normalize (bool): If True, the coordinates will be normalized to the range [0, 1]. Defaults to False. - padding (bool): If True, assuming the boxes is based on image augmented by yolo style. If False then do regular - rescaling. - - Returns: - coords (torch.Tensor): The scaled coordinates. - """ - if ratio_pad is None: # calculate from img0_shape - gain = min(img1_shape[0] / img0_shape[0], img1_shape[1] / img0_shape[1]) # gain = old / new - pad = (img1_shape[1] - img0_shape[1] * gain) / 2, (img1_shape[0] - img0_shape[0] * gain) / 2 # wh padding - else: - gain = ratio_pad[0][0] - pad = ratio_pad[1] - - if padding: - coords[..., 0] -= pad[0] # x padding - coords[..., 1] -= pad[1] # y padding - coords[..., 0] /= gain - coords[..., 1] /= gain - coords = clip_coords(coords, img0_shape) - if normalize: - coords[..., 0] /= img0_shape[1] # width - coords[..., 1] /= img0_shape[0] # height - return coords - - -def regularize_rboxes(rboxes): - """ - Regularize rotated boxes in range [0, pi/2]. - - Args: - rboxes (torch.Tensor): (N, 5), xywhr. - - Returns: - (torch.Tensor): The regularized boxes. - """ - x, y, w, h, t = rboxes.unbind(dim=-1) - # Swap edge and angle if h >= w - w_ = torch.where(w > h, w, h) - h_ = torch.where(w > h, h, w) - t = torch.where(w > h, t, t + math.pi / 2) % math.pi - return torch.stack([x, y, w_, h_, t], dim=-1) # regularized boxes - - -def masks2segments(masks, strategy="largest"): - """ - It takes a list of masks(n,h,w) and returns a list of segments(n,xy) - - Args: - masks (torch.Tensor): the output of the model, which is a tensor of shape (batch_size, 160, 160) - strategy (str): 'concat' or 'largest'. Defaults to largest - - Returns: - segments (List): list of segment masks - """ - segments = [] - for x in masks.int().cpu().numpy().astype("uint8"): - c = cv2.findContours(x, cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE)[0] - if c: - if strategy == "concat": # concatenate all segments - c = np.concatenate([x.reshape(-1, 2) for x in c]) - elif strategy == "largest": # select largest segment - c = np.array(c[np.array([len(x) for x in c]).argmax()]).reshape(-1, 2) - else: - c = np.zeros((0, 2)) # no segments found - segments.append(c.astype("float32")) - return segments - - -def convert_torch2numpy_batch(batch: torch.Tensor) -> np.ndarray: - """ - Convert a batch of FP32 torch tensors (0.0-1.0) to a NumPy uint8 array (0-255), changing from BCHW to BHWC layout. - - Args: - batch (torch.Tensor): Input tensor batch of shape (Batch, Channels, Height, Width) and dtype torch.float32. - - Returns: - (np.ndarray): Output NumPy array batch of shape (Batch, Height, Width, Channels) and dtype uint8. - """ - return (batch.permute(0, 2, 3, 1).contiguous() * 255).clamp(0, 255).to(torch.uint8).cpu().numpy() - - -def clean_str(s): - """ - Cleans a string by replacing special characters with underscore _ - - Args: - s (str): a string needing special characters replaced - - Returns: - (str): a string with special characters replaced by an underscore _ - """ - return re.sub(pattern="[|@#!¡·$€%&()=?¿^*;:,¨´><+]", repl="_", string=s) diff --git a/ultralytics-main/ultralytics/utils/patches.py b/ultralytics-main/ultralytics/utils/patches.py deleted file mode 100644 index d438407..0000000 --- a/ultralytics-main/ultralytics/utils/patches.py +++ /dev/null @@ -1,88 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -"""Monkey patches to update/extend functionality of existing functions.""" - -import time -from pathlib import Path - -import cv2 -import numpy as np -import torch - -# OpenCV Multilanguage-friendly functions ------------------------------------------------------------------------------ -_imshow = cv2.imshow # copy to avoid recursion errors - - -def imread(filename: str, flags: int = cv2.IMREAD_COLOR): - """ - Read an image from a file. - - Args: - filename (str): Path to the file to read. - flags (int, optional): Flag that can take values of cv2.IMREAD_*. Defaults to cv2.IMREAD_COLOR. - - Returns: - (np.ndarray): The read image. - """ - return cv2.imdecode(np.fromfile(filename, np.uint8), flags) - - -def imwrite(filename: str, img: np.ndarray, params=None): - """ - Write an image to a file. - - Args: - filename (str): Path to the file to write. - img (np.ndarray): Image to write. - params (list of ints, optional): Additional parameters. See OpenCV documentation. - - Returns: - (bool): True if the file was written, False otherwise. - """ - try: - cv2.imencode(Path(filename).suffix, img, params)[1].tofile(filename) - return True - except Exception: - return False - - -def imshow(winname: str, mat: np.ndarray): - """ - Displays an image in the specified window. - - Args: - winname (str): Name of the window. - mat (np.ndarray): Image to be shown. - """ - _imshow(winname.encode("unicode_escape").decode(), mat) - - -# PyTorch functions ---------------------------------------------------------------------------------------------------- -_torch_save = torch.save # copy to avoid recursion errors - - -def torch_save(*args, use_dill=True, **kwargs): - """ - Optionally use dill to serialize lambda functions where pickle does not, adding robustness with 3 retries and - exponential standoff in case of save failure. - - Args: - *args (tuple): Positional arguments to pass to torch.save. - use_dill (bool): Whether to try using dill for serialization if available. Defaults to True. - **kwargs (any): Keyword arguments to pass to torch.save. - """ - try: - assert use_dill - import dill as pickle - except (AssertionError, ImportError): - import pickle - - if "pickle_module" not in kwargs: - kwargs["pickle_module"] = pickle - - for i in range(4): # 3 retries - try: - return _torch_save(*args, **kwargs) - except RuntimeError as e: # unable to save, possibly waiting for device to flush or antivirus scan - if i == 3: - raise e - time.sleep((2**i) / 2) # exponential standoff: 0.5s, 1.0s, 2.0s diff --git a/ultralytics-main/ultralytics/utils/plotting.py b/ultralytics-main/ultralytics/utils/plotting.py deleted file mode 100644 index a86d457..0000000 --- a/ultralytics-main/ultralytics/utils/plotting.py +++ /dev/null @@ -1,1048 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import contextlib -import math -import warnings -from pathlib import Path - -import cv2 -import matplotlib.pyplot as plt -import numpy as np -import torch -from PIL import Image, ImageDraw, ImageFont -from PIL import __version__ as pil_version - -from ultralytics.utils import LOGGER, TryExcept, ops, plt_settings, threaded -from .checks import check_font, check_version, is_ascii -from .files import increment_path - - -class Colors: - """ - Ultralytics default color palette https://ultralytics.com/. - - This class provides methods to work with the Ultralytics color palette, including converting hex color codes to - RGB values. - - Attributes: - palette (list of tuple): List of RGB color values. - n (int): The number of colors in the palette. - pose_palette (np.ndarray): A specific color palette array with dtype np.uint8. - """ - - def __init__(self): - """Initialize colors as hex = matplotlib.colors.TABLEAU_COLORS.values().""" - hexs = ( - "FF3838", - "FF9D97", - "FF701F", - "FFB21D", - "CFD231", - "48F90A", - "92CC17", - "3DDB86", - "1A9334", - "00D4BB", - "2C99A8", - "00C2FF", - "344593", - "6473FF", - "0018EC", - "8438FF", - "520085", - "CB38FF", - "FF95C8", - "FF37C7", - ) - self.palette = [self.hex2rgb(f"#{c}") for c in hexs] - self.n = len(self.palette) - self.pose_palette = np.array( - [ - [255, 128, 0], - [255, 153, 51], - [255, 178, 102], - [230, 230, 0], - [255, 153, 255], - [153, 204, 255], - [255, 102, 255], - [255, 51, 255], - [102, 178, 255], - [51, 153, 255], - [255, 153, 153], - [255, 102, 102], - [255, 51, 51], - [153, 255, 153], - [102, 255, 102], - [51, 255, 51], - [0, 255, 0], - [0, 0, 255], - [255, 0, 0], - [255, 255, 255], - ], - dtype=np.uint8, - ) - - def __call__(self, i, bgr=False): - """Converts hex color codes to RGB values.""" - c = self.palette[int(i) % self.n] - return (c[2], c[1], c[0]) if bgr else c - - @staticmethod - def hex2rgb(h): - """Converts hex color codes to RGB values (i.e. default PIL order).""" - return tuple(int(h[1 + i : 1 + i + 2], 16) for i in (0, 2, 4)) - - -colors = Colors() # create instance for 'from utils.plots import colors' - - -class Annotator: - """ - Ultralytics Annotator for train/val mosaics and JPGs and predictions annotations. - - Attributes: - im (Image.Image or numpy array): The image to annotate. - pil (bool): Whether to use PIL or cv2 for drawing annotations. - font (ImageFont.truetype or ImageFont.load_default): Font used for text annotations. - lw (float): Line width for drawing. - skeleton (List[List[int]]): Skeleton structure for keypoints. - limb_color (List[int]): Color palette for limbs. - kpt_color (List[int]): Color palette for keypoints. - """ - - def __init__(self, im, line_width=None, font_size=None, font="Arial.ttf", pil=False, example="abc"): - """Initialize the Annotator class with image and line width along with color palette for keypoints and limbs.""" - non_ascii = not is_ascii(example) # non-latin labels, i.e. asian, arabic, cyrillic - input_is_pil = isinstance(im, Image.Image) - self.pil = pil or non_ascii or input_is_pil - self.lw = line_width or max(round(sum(im.size if input_is_pil else im.shape) / 2 * 0.003), 2) - if self.pil: # use PIL - self.im = im if input_is_pil else Image.fromarray(im) - self.draw = ImageDraw.Draw(self.im) - try: - font = check_font("Arial.Unicode.ttf" if non_ascii else font) - size = font_size or max(round(sum(self.im.size) / 2 * 0.035), 12) - self.font = ImageFont.truetype(str(font), size) - except Exception: - self.font = ImageFont.load_default() - # Deprecation fix for w, h = getsize(string) -> _, _, w, h = getbox(string) - if check_version(pil_version, "9.2.0"): - self.font.getsize = lambda x: self.font.getbbox(x)[2:4] # text width, height - else: # use cv2 - assert im.data.contiguous, "Image not contiguous. Apply np.ascontiguousarray(im) to Annotator input images." - self.im = im if im.flags.writeable else im.copy() - self.tf = max(self.lw - 1, 1) # font thickness - self.sf = self.lw / 3 # font scale - # Pose - self.skeleton = [ - [16, 14], - [14, 12], - [17, 15], - [15, 13], - [12, 13], - [6, 12], - [7, 13], - [6, 7], - [6, 8], - [7, 9], - [8, 10], - [9, 11], - [2, 3], - [1, 2], - [1, 3], - [2, 4], - [3, 5], - [4, 6], - [5, 7], - ] - - self.limb_color = colors.pose_palette[[9, 9, 9, 9, 7, 7, 7, 0, 0, 0, 0, 0, 16, 16, 16, 16, 16, 16, 16]] - self.kpt_color = colors.pose_palette[[16, 16, 16, 16, 16, 0, 0, 0, 0, 0, 0, 9, 9, 9, 9, 9, 9]] - - def box_label(self, box, label="", color=(128, 128, 128), txt_color=(255, 255, 255), rotated=False): - """Add one xyxy box to image with label.""" - if isinstance(box, torch.Tensor): - box = box.tolist() - if self.pil or not is_ascii(label): - if rotated: - p1 = box[0] - # NOTE: PIL-version polygon needs tuple type. - self.draw.polygon([tuple(b) for b in box], width=self.lw, outline=color) - else: - p1 = (box[0], box[1]) - self.draw.rectangle(box, width=self.lw, outline=color) # box - if label: - w, h = self.font.getsize(label) # text width, height - outside = p1[1] - h >= 0 # label fits outside box - self.draw.rectangle( - (p1[0], p1[1] - h if outside else p1[1], p1[0] + w + 1, p1[1] + 1 if outside else p1[1] + h + 1), - fill=color, - ) - # self.draw.text((box[0], box[1]), label, fill=txt_color, font=self.font, anchor='ls') # for PIL>8.0 - self.draw.text((p1[0], p1[1] - h if outside else p1[1]), label, fill=txt_color, font=self.font) - else: # cv2 - if rotated: - p1 = [int(b) for b in box[0]] - # NOTE: cv2-version polylines needs np.asarray type. - cv2.polylines(self.im, [np.asarray(box, dtype=int)], True, color, self.lw) - else: - p1, p2 = (int(box[0]), int(box[1])), (int(box[2]), int(box[3])) - cv2.rectangle(self.im, p1, p2, color, thickness=self.lw, lineType=cv2.LINE_AA) - - if label: - w, h = cv2.getTextSize(label, 0, fontScale=self.sf, thickness=self.tf)[0] # text width, height - outside = p1[1] - h >= 3 - p2 = p1[0] + w, p1[1] - h - 3 if outside else p1[1] + h + 3 - cv2.rectangle(self.im, p1, p2, color, -1, cv2.LINE_AA) # filled - cv2.putText( - self.im, - label, - (p1[0], p1[1] - 2 if outside else p1[1] + h + 2), - 0, - self.sf, - txt_color, - thickness=self.tf, - lineType=cv2.LINE_AA, - ) - - def masks(self, masks, colors, im_gpu, alpha=0.5, retina_masks=False): - """ - Plot masks on image. - - Args: - masks (tensor): Predicted masks on cuda, shape: [n, h, w] - colors (List[List[Int]]): Colors for predicted masks, [[r, g, b] * n] - im_gpu (tensor): Image is in cuda, shape: [3, h, w], range: [0, 1] - alpha (float): Mask transparency: 0.0 fully transparent, 1.0 opaque - retina_masks (bool): Whether to use high resolution masks or not. Defaults to False. - """ - if self.pil: - # Convert to numpy first - self.im = np.asarray(self.im).copy() - if len(masks) == 0: - self.im[:] = im_gpu.permute(1, 2, 0).contiguous().cpu().numpy() * 255 - if im_gpu.device != masks.device: - im_gpu = im_gpu.to(masks.device) - colors = torch.tensor(colors, device=masks.device, dtype=torch.float32) / 255.0 # shape(n,3) - colors = colors[:, None, None] # shape(n,1,1,3) - masks = masks.unsqueeze(3) # shape(n,h,w,1) - masks_color = masks * (colors * alpha) # shape(n,h,w,3) - - inv_alpha_masks = (1 - masks * alpha).cumprod(0) # shape(n,h,w,1) - mcs = masks_color.max(dim=0).values # shape(n,h,w,3) - - im_gpu = im_gpu.flip(dims=[0]) # flip channel - im_gpu = im_gpu.permute(1, 2, 0).contiguous() # shape(h,w,3) - im_gpu = im_gpu * inv_alpha_masks[-1] + mcs - im_mask = im_gpu * 255 - im_mask_np = im_mask.byte().cpu().numpy() - self.im[:] = im_mask_np if retina_masks else ops.scale_image(im_mask_np, self.im.shape) - if self.pil: - # Convert im back to PIL and update draw - self.fromarray(self.im) - - def kpts(self, kpts, shape=(640, 640), radius=5, kpt_line=True): - """ - Plot keypoints on the image. - - Args: - kpts (tensor): Predicted keypoints with shape [17, 3]. Each keypoint has (x, y, confidence). - shape (tuple): Image shape as a tuple (h, w), where h is the height and w is the width. - radius (int, optional): Radius of the drawn keypoints. Default is 5. - kpt_line (bool, optional): If True, the function will draw lines connecting keypoints - for human pose. Default is True. - - Note: - `kpt_line=True` currently only supports human pose plotting. - """ - if self.pil: - # Convert to numpy first - self.im = np.asarray(self.im).copy() - nkpt, ndim = kpts.shape - is_pose = nkpt == 17 and ndim in {2, 3} - kpt_line &= is_pose # `kpt_line=True` for now only supports human pose plotting - for i, k in enumerate(kpts): - color_k = [int(x) for x in self.kpt_color[i]] if is_pose else colors(i) - x_coord, y_coord = k[0], k[1] - if x_coord % shape[1] != 0 and y_coord % shape[0] != 0: - if len(k) == 3: - conf = k[2] - if conf < 0.5: - continue - cv2.circle(self.im, (int(x_coord), int(y_coord)), radius, color_k, -1, lineType=cv2.LINE_AA) - - if kpt_line: - ndim = kpts.shape[-1] - for i, sk in enumerate(self.skeleton): - pos1 = (int(kpts[(sk[0] - 1), 0]), int(kpts[(sk[0] - 1), 1])) - pos2 = (int(kpts[(sk[1] - 1), 0]), int(kpts[(sk[1] - 1), 1])) - if ndim == 3: - conf1 = kpts[(sk[0] - 1), 2] - conf2 = kpts[(sk[1] - 1), 2] - if conf1 < 0.5 or conf2 < 0.5: - continue - if pos1[0] % shape[1] == 0 or pos1[1] % shape[0] == 0 or pos1[0] < 0 or pos1[1] < 0: - continue - if pos2[0] % shape[1] == 0 or pos2[1] % shape[0] == 0 or pos2[0] < 0 or pos2[1] < 0: - continue - cv2.line(self.im, pos1, pos2, [int(x) for x in self.limb_color[i]], thickness=2, lineType=cv2.LINE_AA) - if self.pil: - # Convert im back to PIL and update draw - self.fromarray(self.im) - - def rectangle(self, xy, fill=None, outline=None, width=1): - """Add rectangle to image (PIL-only).""" - self.draw.rectangle(xy, fill, outline, width) - - def text(self, xy, text, txt_color=(255, 255, 255), anchor="top", box_style=False): - """Adds text to an image using PIL or cv2.""" - if anchor == "bottom": # start y from font bottom - w, h = self.font.getsize(text) # text width, height - xy[1] += 1 - h - if self.pil: - if box_style: - w, h = self.font.getsize(text) - self.draw.rectangle((xy[0], xy[1], xy[0] + w + 1, xy[1] + h + 1), fill=txt_color) - # Using `txt_color` for background and draw fg with white color - txt_color = (255, 255, 255) - if "\n" in text: - lines = text.split("\n") - _, h = self.font.getsize(text) - for line in lines: - self.draw.text(xy, line, fill=txt_color, font=self.font) - xy[1] += h - else: - self.draw.text(xy, text, fill=txt_color, font=self.font) - else: - if box_style: - w, h = cv2.getTextSize(text, 0, fontScale=self.sf, thickness=self.tf)[0] # text width, height - outside = xy[1] - h >= 3 - p2 = xy[0] + w, xy[1] - h - 3 if outside else xy[1] + h + 3 - cv2.rectangle(self.im, xy, p2, txt_color, -1, cv2.LINE_AA) # filled - # Using `txt_color` for background and draw fg with white color - txt_color = (255, 255, 255) - cv2.putText(self.im, text, xy, 0, self.sf, txt_color, thickness=self.tf, lineType=cv2.LINE_AA) - - def fromarray(self, im): - """Update self.im from a numpy array.""" - self.im = im if isinstance(im, Image.Image) else Image.fromarray(im) - self.draw = ImageDraw.Draw(self.im) - - def result(self): - """Return annotated image as array.""" - return np.asarray(self.im) - - def show(self, title=None): - """Show the annotated image.""" - Image.fromarray(np.asarray(self.im)[..., ::-1]).show(title) - - def save(self, filename="image.jpg"): - """Save the annotated image to 'filename'.""" - cv2.imwrite(filename, np.asarray(self.im)) - - def draw_region(self, reg_pts=None, color=(0, 255, 0), thickness=5): - """ - Draw region line. - - Args: - reg_pts (list): Region Points (for line 2 points, for region 4 points) - color (tuple): Region Color value - thickness (int): Region area thickness value - """ - cv2.polylines(self.im, [np.array(reg_pts, dtype=np.int32)], isClosed=True, color=color, thickness=thickness) - - def draw_centroid_and_tracks(self, track, color=(255, 0, 255), track_thickness=2): - """ - Draw centroid point and track trails. - - Args: - track (list): object tracking points for trails display - color (tuple): tracks line color - track_thickness (int): track line thickness value - """ - points = np.hstack(track).astype(np.int32).reshape((-1, 1, 2)) - cv2.polylines(self.im, [points], isClosed=False, color=color, thickness=track_thickness) - cv2.circle(self.im, (int(track[-1][0]), int(track[-1][1])), track_thickness * 2, color, -1) - - def count_labels(self, counts=0, count_txt_size=2, color=(255, 255, 255), txt_color=(0, 0, 0)): - """ - Plot counts for object counter. - - Args: - counts (int): objects counts value - count_txt_size (int): text size for counts display - color (tuple): background color of counts display - txt_color (tuple): text color of counts display - """ - self.tf = count_txt_size - tl = self.tf or round(0.002 * (self.im.shape[0] + self.im.shape[1]) / 2) + 1 - tf = max(tl - 1, 1) - - # Get text size for in_count and out_count - t_size_in = cv2.getTextSize(str(counts), 0, fontScale=tl / 2, thickness=tf)[0] - - # Calculate positions for counts label - text_width = t_size_in[0] - text_x = (self.im.shape[1] - text_width) // 2 # Center x-coordinate - text_y = t_size_in[1] - - # Create a rounded rectangle for in_count - cv2.rectangle( - self.im, (text_x - 5, text_y - 5), (text_x + text_width + 7, text_y + t_size_in[1] + 7), color, -1 - ) - cv2.putText( - self.im, str(counts), (text_x, text_y + t_size_in[1]), 0, tl / 2, txt_color, self.tf, lineType=cv2.LINE_AA - ) - - @staticmethod - def estimate_pose_angle(a, b, c): - """ - Calculate the pose angle for object. - - Args: - a (float) : The value of pose point a - b (float): The value of pose point b - c (float): The value o pose point c - - Returns: - angle (degree): Degree value of angle between three points - """ - a, b, c = np.array(a), np.array(b), np.array(c) - radians = np.arctan2(c[1] - b[1], c[0] - b[0]) - np.arctan2(a[1] - b[1], a[0] - b[0]) - angle = np.abs(radians * 180.0 / np.pi) - if angle > 180.0: - angle = 360 - angle - return angle - - def draw_specific_points(self, keypoints, indices=[2, 5, 7], shape=(640, 640), radius=2): - """ - Draw specific keypoints for gym steps counting. - - Args: - keypoints (list): list of keypoints data to be plotted - indices (list): keypoints ids list to be plotted - shape (tuple): imgsz for model inference - radius (int): Keypoint radius value - """ - for i, k in enumerate(keypoints): - if i in indices: - x_coord, y_coord = k[0], k[1] - if x_coord % shape[1] != 0 and y_coord % shape[0] != 0: - if len(k) == 3: - conf = k[2] - if conf < 0.5: - continue - cv2.circle(self.im, (int(x_coord), int(y_coord)), radius, (0, 255, 0), -1, lineType=cv2.LINE_AA) - return self.im - - def plot_angle_and_count_and_stage(self, angle_text, count_text, stage_text, center_kpt, line_thickness=2): - """ - Plot the pose angle, count value and step stage. - - Args: - angle_text (str): angle value for workout monitoring - count_text (str): counts value for workout monitoring - stage_text (str): stage decision for workout monitoring - center_kpt (int): centroid pose index for workout monitoring - line_thickness (int): thickness for text display - """ - angle_text, count_text, stage_text = (f" {angle_text:.2f}", f"Steps : {count_text}", f" {stage_text}") - font_scale = 0.6 + (line_thickness / 10.0) - - # Draw angle - (angle_text_width, angle_text_height), _ = cv2.getTextSize(angle_text, 0, font_scale, line_thickness) - angle_text_position = (int(center_kpt[0]), int(center_kpt[1])) - angle_background_position = (angle_text_position[0], angle_text_position[1] - angle_text_height - 5) - angle_background_size = (angle_text_width + 2 * 5, angle_text_height + 2 * 5 + (line_thickness * 2)) - cv2.rectangle( - self.im, - angle_background_position, - ( - angle_background_position[0] + angle_background_size[0], - angle_background_position[1] + angle_background_size[1], - ), - (255, 255, 255), - -1, - ) - cv2.putText(self.im, angle_text, angle_text_position, 0, font_scale, (0, 0, 0), line_thickness) - - # Draw Counts - (count_text_width, count_text_height), _ = cv2.getTextSize(count_text, 0, font_scale, line_thickness) - count_text_position = (angle_text_position[0], angle_text_position[1] + angle_text_height + 20) - count_background_position = ( - angle_background_position[0], - angle_background_position[1] + angle_background_size[1] + 5, - ) - count_background_size = (count_text_width + 10, count_text_height + 10 + (line_thickness * 2)) - - cv2.rectangle( - self.im, - count_background_position, - ( - count_background_position[0] + count_background_size[0], - count_background_position[1] + count_background_size[1], - ), - (255, 255, 255), - -1, - ) - cv2.putText(self.im, count_text, count_text_position, 0, font_scale, (0, 0, 0), line_thickness) - - # Draw Stage - (stage_text_width, stage_text_height), _ = cv2.getTextSize(stage_text, 0, font_scale, line_thickness) - stage_text_position = (int(center_kpt[0]), int(center_kpt[1]) + angle_text_height + count_text_height + 40) - stage_background_position = (stage_text_position[0], stage_text_position[1] - stage_text_height - 5) - stage_background_size = (stage_text_width + 10, stage_text_height + 10) - - cv2.rectangle( - self.im, - stage_background_position, - ( - stage_background_position[0] + stage_background_size[0], - stage_background_position[1] + stage_background_size[1], - ), - (255, 255, 255), - -1, - ) - cv2.putText(self.im, stage_text, stage_text_position, 0, font_scale, (0, 0, 0), line_thickness) - - def seg_bbox(self, mask, mask_color=(255, 0, 255), det_label=None, track_label=None): - """ - Function for drawing segmented object in bounding box shape. - - Args: - mask (list): masks data list for instance segmentation area plotting - mask_color (tuple): mask foreground color - det_label (str): Detection label text - track_label (str): Tracking label text - """ - cv2.polylines(self.im, [np.int32([mask])], isClosed=True, color=mask_color, thickness=2) - - label = f"Track ID: {track_label}" if track_label else det_label - text_size, _ = cv2.getTextSize(label, 0, 0.7, 1) - - cv2.rectangle( - self.im, - (int(mask[0][0]) - text_size[0] // 2 - 10, int(mask[0][1]) - text_size[1] - 10), - (int(mask[0][0]) + text_size[0] // 2 + 5, int(mask[0][1] + 5)), - mask_color, - -1, - ) - - cv2.putText( - self.im, label, (int(mask[0][0]) - text_size[0] // 2, int(mask[0][1]) - 5), 0, 0.7, (255, 255, 255), 2 - ) - - def plot_distance_and_line(self, distance_m, distance_mm, centroids, line_color, centroid_color): - """ - Plot the distance and line on frame. - - Args: - distance_m (float): Distance between two bbox centroids in meters. - distance_mm (float): Distance between two bbox centroids in millimeters. - centroids (list): Bounding box centroids data. - line_color (RGB): Distance line color. - centroid_color (RGB): Bounding box centroid color. - """ - (text_width_m, text_height_m), _ = cv2.getTextSize( - f"Distance M: {distance_m:.2f}m", cv2.FONT_HERSHEY_SIMPLEX, 0.8, 2 - ) - cv2.rectangle(self.im, (15, 25), (15 + text_width_m + 10, 25 + text_height_m + 20), (255, 255, 255), -1) - cv2.putText( - self.im, - f"Distance M: {distance_m:.2f}m", - (20, 50), - cv2.FONT_HERSHEY_SIMPLEX, - 0.8, - (0, 0, 0), - 2, - cv2.LINE_AA, - ) - - (text_width_mm, text_height_mm), _ = cv2.getTextSize( - f"Distance MM: {distance_mm:.2f}mm", cv2.FONT_HERSHEY_SIMPLEX, 0.8, 2 - ) - cv2.rectangle(self.im, (15, 75), (15 + text_width_mm + 10, 75 + text_height_mm + 20), (255, 255, 255), -1) - cv2.putText( - self.im, - f"Distance MM: {distance_mm:.2f}mm", - (20, 100), - cv2.FONT_HERSHEY_SIMPLEX, - 0.8, - (0, 0, 0), - 2, - cv2.LINE_AA, - ) - - cv2.line(self.im, centroids[0], centroids[1], line_color, 3) - cv2.circle(self.im, centroids[0], 6, centroid_color, -1) - cv2.circle(self.im, centroids[1], 6, centroid_color, -1) - - def visioneye(self, box, center_point, color=(235, 219, 11), pin_color=(255, 0, 255), thickness=2, pins_radius=10): - """ - Function for pinpoint human-vision eye mapping and plotting. - - Args: - box (list): Bounding box coordinates - center_point (tuple): center point for vision eye view - color (tuple): object centroid and line color value - pin_color (tuple): visioneye point color value - thickness (int): int value for line thickness - pins_radius (int): visioneye point radius value - """ - center_bbox = int((box[0] + box[2]) / 2), int((box[1] + box[3]) / 2) - cv2.circle(self.im, center_point, pins_radius, pin_color, -1) - cv2.circle(self.im, center_bbox, pins_radius, color, -1) - cv2.line(self.im, center_point, center_bbox, color, thickness) - - -@TryExcept() # known issue https://github.com/ultralytics/yolov5/issues/5395 -@plt_settings() -def plot_labels(boxes, cls, names=(), save_dir=Path(""), on_plot=None): - """Plot training labels including class histograms and box statistics.""" - import pandas as pd - import seaborn as sn - - # Filter matplotlib>=3.7.2 warning and Seaborn use_inf and is_categorical FutureWarnings - warnings.filterwarnings("ignore", category=UserWarning, message="The figure layout has changed to tight") - warnings.filterwarnings("ignore", category=FutureWarning) - - # Plot dataset labels - LOGGER.info(f"Plotting labels to {save_dir / 'labels.jpg'}... ") - nc = int(cls.max() + 1) # number of classes - boxes = boxes[:1000000] # limit to 1M boxes - x = pd.DataFrame(boxes, columns=["x", "y", "width", "height"]) - - # Seaborn correlogram - sn.pairplot(x, corner=True, diag_kind="auto", kind="hist", diag_kws=dict(bins=50), plot_kws=dict(pmax=0.9)) - plt.savefig(save_dir / "labels_correlogram.jpg", dpi=200) - plt.close() - - # Matplotlib labels - ax = plt.subplots(2, 2, figsize=(8, 8), tight_layout=True)[1].ravel() - y = ax[0].hist(cls, bins=np.linspace(0, nc, nc + 1) - 0.5, rwidth=0.8) - for i in range(nc): - y[2].patches[i].set_color([x / 255 for x in colors(i)]) - ax[0].set_ylabel("instances") - if 0 < len(names) < 30: - ax[0].set_xticks(range(len(names))) - ax[0].set_xticklabels(list(names.values()), rotation=90, fontsize=10) - else: - ax[0].set_xlabel("classes") - sn.histplot(x, x="x", y="y", ax=ax[2], bins=50, pmax=0.9) - sn.histplot(x, x="width", y="height", ax=ax[3], bins=50, pmax=0.9) - - # Rectangles - boxes[:, 0:2] = 0.5 # center - boxes = ops.xywh2xyxy(boxes) * 1000 - img = Image.fromarray(np.ones((1000, 1000, 3), dtype=np.uint8) * 255) - for cls, box in zip(cls[:500], boxes[:500]): - ImageDraw.Draw(img).rectangle(box, width=1, outline=colors(cls)) # plot - ax[1].imshow(img) - ax[1].axis("off") - - for a in [0, 1, 2, 3]: - for s in ["top", "right", "left", "bottom"]: - ax[a].spines[s].set_visible(False) - - fname = save_dir / "labels.jpg" - plt.savefig(fname, dpi=200) - plt.close() - if on_plot: - on_plot(fname) - - -def save_one_box(xyxy, im, file=Path("im.jpg"), gain=1.02, pad=10, square=False, BGR=False, save=True): - """ - Save image crop as {file} with crop size multiple {gain} and {pad} pixels. Save and/or return crop. - - This function takes a bounding box and an image, and then saves a cropped portion of the image according - to the bounding box. Optionally, the crop can be squared, and the function allows for gain and padding - adjustments to the bounding box. - - Args: - xyxy (torch.Tensor or list): A tensor or list representing the bounding box in xyxy format. - im (numpy.ndarray): The input image. - file (Path, optional): The path where the cropped image will be saved. Defaults to 'im.jpg'. - gain (float, optional): A multiplicative factor to increase the size of the bounding box. Defaults to 1.02. - pad (int, optional): The number of pixels to add to the width and height of the bounding box. Defaults to 10. - square (bool, optional): If True, the bounding box will be transformed into a square. Defaults to False. - BGR (bool, optional): If True, the image will be saved in BGR format, otherwise in RGB. Defaults to False. - save (bool, optional): If True, the cropped image will be saved to disk. Defaults to True. - - Returns: - (numpy.ndarray): The cropped image. - - Example: - ```python - from ultralytics.utils.plotting import save_one_box - - xyxy = [50, 50, 150, 150] - im = cv2.imread('image.jpg') - cropped_im = save_one_box(xyxy, im, file='cropped.jpg', square=True) - ``` - """ - - if not isinstance(xyxy, torch.Tensor): # may be list - xyxy = torch.stack(xyxy) - b = ops.xyxy2xywh(xyxy.view(-1, 4)) # boxes - if square: - b[:, 2:] = b[:, 2:].max(1)[0].unsqueeze(1) # attempt rectangle to square - b[:, 2:] = b[:, 2:] * gain + pad # box wh * gain + pad - xyxy = ops.xywh2xyxy(b).long() - xyxy = ops.clip_boxes(xyxy, im.shape) - crop = im[int(xyxy[0, 1]) : int(xyxy[0, 3]), int(xyxy[0, 0]) : int(xyxy[0, 2]), :: (1 if BGR else -1)] - if save: - file.parent.mkdir(parents=True, exist_ok=True) # make directory - f = str(increment_path(file).with_suffix(".jpg")) - # cv2.imwrite(f, crop) # save BGR, https://github.com/ultralytics/yolov5/issues/7007 chroma subsampling issue - Image.fromarray(crop[..., ::-1]).save(f, quality=95, subsampling=0) # save RGB - return crop - - -@threaded -def plot_images( - images, - batch_idx, - cls, - bboxes=np.zeros(0, dtype=np.float32), - confs=None, - masks=np.zeros(0, dtype=np.uint8), - kpts=np.zeros((0, 51), dtype=np.float32), - paths=None, - fname="images.jpg", - names=None, - on_plot=None, - max_subplots=16, - save=True, - conf_thres=0.25, -): - """Plot image grid with labels.""" - if isinstance(images, torch.Tensor): - images = images.cpu().float().numpy() - if isinstance(cls, torch.Tensor): - cls = cls.cpu().numpy() - if isinstance(bboxes, torch.Tensor): - bboxes = bboxes.cpu().numpy() - if isinstance(masks, torch.Tensor): - masks = masks.cpu().numpy().astype(int) - if isinstance(kpts, torch.Tensor): - kpts = kpts.cpu().numpy() - if isinstance(batch_idx, torch.Tensor): - batch_idx = batch_idx.cpu().numpy() - - max_size = 1920 # max image size - bs, _, h, w = images.shape # batch size, _, height, width - bs = min(bs, max_subplots) # limit plot images - ns = np.ceil(bs**0.5) # number of subplots (square) - if np.max(images[0]) <= 1: - images *= 255 # de-normalise (optional) - - # Build Image - mosaic = np.full((int(ns * h), int(ns * w), 3), 255, dtype=np.uint8) # init - for i in range(bs): - x, y = int(w * (i // ns)), int(h * (i % ns)) # block origin - mosaic[y : y + h, x : x + w, :] = images[i].transpose(1, 2, 0) - - # Resize (optional) - scale = max_size / ns / max(h, w) - if scale < 1: - h = math.ceil(scale * h) - w = math.ceil(scale * w) - mosaic = cv2.resize(mosaic, tuple(int(x * ns) for x in (w, h))) - - # Annotate - fs = int((h + w) * ns * 0.01) # font size - annotator = Annotator(mosaic, line_width=round(fs / 10), font_size=fs, pil=True, example=names) - for i in range(bs): - x, y = int(w * (i // ns)), int(h * (i % ns)) # block origin - annotator.rectangle([x, y, x + w, y + h], None, (255, 255, 255), width=2) # borders - if paths: - annotator.text((x + 5, y + 5), text=Path(paths[i]).name[:40], txt_color=(220, 220, 220)) # filenames - if len(cls) > 0: - idx = batch_idx == i - classes = cls[idx].astype("int") - labels = confs is None - - if len(bboxes): - boxes = bboxes[idx] - conf = confs[idx] if confs is not None else None # check for confidence presence (label vs pred) - is_obb = boxes.shape[-1] == 5 # xywhr - boxes = ops.xywhr2xyxyxyxy(boxes) if is_obb else ops.xywh2xyxy(boxes) - if len(boxes): - if boxes[:, :4].max() <= 1.1: # if normalized with tolerance 0.1 - boxes[..., 0::2] *= w # scale to pixels - boxes[..., 1::2] *= h - elif scale < 1: # absolute coords need scale if image scales - boxes[..., :4] *= scale - boxes[..., 0::2] += x - boxes[..., 1::2] += y - for j, box in enumerate(boxes.astype(np.int64).tolist()): - c = classes[j] - color = colors(c) - c = names.get(c, c) if names else c - if labels or conf[j] > conf_thres: - label = f"{c}" if labels else f"{c} {conf[j]:.1f}" - annotator.box_label(box, label, color=color, rotated=is_obb) - - elif len(classes): - for c in classes: - color = colors(c) - c = names.get(c, c) if names else c - annotator.text((x, y), f"{c}", txt_color=color, box_style=True) - - # Plot keypoints - if len(kpts): - kpts_ = kpts[idx].copy() - if len(kpts_): - if kpts_[..., 0].max() <= 1.01 or kpts_[..., 1].max() <= 1.01: # if normalized with tolerance .01 - kpts_[..., 0] *= w # scale to pixels - kpts_[..., 1] *= h - elif scale < 1: # absolute coords need scale if image scales - kpts_ *= scale - kpts_[..., 0] += x - kpts_[..., 1] += y - for j in range(len(kpts_)): - if labels or conf[j] > conf_thres: - annotator.kpts(kpts_[j]) - - # Plot masks - if len(masks): - if idx.shape[0] == masks.shape[0]: # overlap_masks=False - image_masks = masks[idx] - else: # overlap_masks=True - image_masks = masks[[i]] # (1, 640, 640) - nl = idx.sum() - index = np.arange(nl).reshape((nl, 1, 1)) + 1 - image_masks = np.repeat(image_masks, nl, axis=0) - image_masks = np.where(image_masks == index, 1.0, 0.0) - - im = np.asarray(annotator.im).copy() - for j in range(len(image_masks)): - if labels or conf[j] > conf_thres: - color = colors(classes[j]) - mh, mw = image_masks[j].shape - if mh != h or mw != w: - mask = image_masks[j].astype(np.uint8) - mask = cv2.resize(mask, (w, h)) - mask = mask.astype(bool) - else: - mask = image_masks[j].astype(bool) - with contextlib.suppress(Exception): - im[y : y + h, x : x + w, :][mask] = ( - im[y : y + h, x : x + w, :][mask] * 0.4 + np.array(color) * 0.6 - ) - annotator.fromarray(im) - if not save: - return np.asarray(annotator.im) - annotator.im.save(fname) # save - if on_plot: - on_plot(fname) - - -@plt_settings() -def plot_results(file="path/to/results.csv", dir="", segment=False, pose=False, classify=False, on_plot=None): - """ - Plot training results from a results CSV file. The function supports various types of data including segmentation, - pose estimation, and classification. Plots are saved as 'results.png' in the directory where the CSV is located. - - Args: - file (str, optional): Path to the CSV file containing the training results. Defaults to 'path/to/results.csv'. - dir (str, optional): Directory where the CSV file is located if 'file' is not provided. Defaults to ''. - segment (bool, optional): Flag to indicate if the data is for segmentation. Defaults to False. - pose (bool, optional): Flag to indicate if the data is for pose estimation. Defaults to False. - classify (bool, optional): Flag to indicate if the data is for classification. Defaults to False. - on_plot (callable, optional): Callback function to be executed after plotting. Takes filename as an argument. - Defaults to None. - - Example: - ```python - from ultralytics.utils.plotting import plot_results - - plot_results('path/to/results.csv', segment=True) - ``` - """ - import pandas as pd - from scipy.ndimage import gaussian_filter1d - - save_dir = Path(file).parent if file else Path(dir) - if classify: - fig, ax = plt.subplots(2, 2, figsize=(6, 6), tight_layout=True) - index = [1, 4, 2, 3] - elif segment: - fig, ax = plt.subplots(2, 8, figsize=(18, 6), tight_layout=True) - index = [1, 2, 3, 4, 5, 6, 9, 10, 13, 14, 15, 16, 7, 8, 11, 12] - elif pose: - fig, ax = plt.subplots(2, 9, figsize=(21, 6), tight_layout=True) - index = [1, 2, 3, 4, 5, 6, 7, 10, 11, 14, 15, 16, 17, 18, 8, 9, 12, 13] - else: - fig, ax = plt.subplots(2, 5, figsize=(12, 6), tight_layout=True) - index = [1, 2, 3, 4, 5, 8, 9, 10, 6, 7] - ax = ax.ravel() - files = list(save_dir.glob("results*.csv")) - assert len(files), f"No results.csv files found in {save_dir.resolve()}, nothing to plot." - for f in files: - try: - data = pd.read_csv(f) - s = [x.strip() for x in data.columns] - x = data.values[:, 0] - for i, j in enumerate(index): - y = data.values[:, j].astype("float") - # y[y == 0] = np.nan # don't show zero values - ax[i].plot(x, y, marker=".", label=f.stem, linewidth=2, markersize=8) # actual results - ax[i].plot(x, gaussian_filter1d(y, sigma=3), ":", label="smooth", linewidth=2) # smoothing line - ax[i].set_title(s[j], fontsize=12) - # if j in [8, 9, 10]: # share train and val loss y axes - # ax[i].get_shared_y_axes().join(ax[i], ax[i - 5]) - except Exception as e: - LOGGER.warning(f"WARNING: Plotting error for {f}: {e}") - ax[1].legend() - fname = save_dir / "results.png" - fig.savefig(fname, dpi=200) - plt.close() - if on_plot: - on_plot(fname) - - -def plt_color_scatter(v, f, bins=20, cmap="viridis", alpha=0.8, edgecolors="none"): - """ - Plots a scatter plot with points colored based on a 2D histogram. - - Args: - v (array-like): Values for the x-axis. - f (array-like): Values for the y-axis. - bins (int, optional): Number of bins for the histogram. Defaults to 20. - cmap (str, optional): Colormap for the scatter plot. Defaults to 'viridis'. - alpha (float, optional): Alpha for the scatter plot. Defaults to 0.8. - edgecolors (str, optional): Edge colors for the scatter plot. Defaults to 'none'. - - Examples: - >>> v = np.random.rand(100) - >>> f = np.random.rand(100) - >>> plt_color_scatter(v, f) - """ - - # Calculate 2D histogram and corresponding colors - hist, xedges, yedges = np.histogram2d(v, f, bins=bins) - colors = [ - hist[ - min(np.digitize(v[i], xedges, right=True) - 1, hist.shape[0] - 1), - min(np.digitize(f[i], yedges, right=True) - 1, hist.shape[1] - 1), - ] - for i in range(len(v)) - ] - - # Scatter plot - plt.scatter(v, f, c=colors, cmap=cmap, alpha=alpha, edgecolors=edgecolors) - - -def plot_tune_results(csv_file="tune_results.csv"): - """ - Plot the evolution results stored in an 'tune_results.csv' file. The function generates a scatter plot for each key - in the CSV, color-coded based on fitness scores. The best-performing configurations are highlighted on the plots. - - Args: - csv_file (str, optional): Path to the CSV file containing the tuning results. Defaults to 'tune_results.csv'. - - Examples: - >>> plot_tune_results('path/to/tune_results.csv') - """ - - import pandas as pd - from scipy.ndimage import gaussian_filter1d - - # Scatter plots for each hyperparameter - csv_file = Path(csv_file) - data = pd.read_csv(csv_file) - num_metrics_columns = 1 - keys = [x.strip() for x in data.columns][num_metrics_columns:] - x = data.values - fitness = x[:, 0] # fitness - j = np.argmax(fitness) # max fitness index - n = math.ceil(len(keys) ** 0.5) # columns and rows in plot - plt.figure(figsize=(10, 10), tight_layout=True) - for i, k in enumerate(keys): - v = x[:, i + num_metrics_columns] - mu = v[j] # best single result - plt.subplot(n, n, i + 1) - plt_color_scatter(v, fitness, cmap="viridis", alpha=0.8, edgecolors="none") - plt.plot(mu, fitness.max(), "k+", markersize=15) - plt.title(f"{k} = {mu:.3g}", fontdict={"size": 9}) # limit to 40 characters - plt.tick_params(axis="both", labelsize=8) # Set axis label size to 8 - if i % n != 0: - plt.yticks([]) - - file = csv_file.with_name("tune_scatter_plots.png") # filename - plt.savefig(file, dpi=200) - plt.close() - LOGGER.info(f"Saved {file}") - - # Fitness vs iteration - x = range(1, len(fitness) + 1) - plt.figure(figsize=(10, 6), tight_layout=True) - plt.plot(x, fitness, marker="o", linestyle="none", label="fitness") - plt.plot(x, gaussian_filter1d(fitness, sigma=3), ":", label="smoothed", linewidth=2) # smoothing line - plt.title("Fitness vs Iteration") - plt.xlabel("Iteration") - plt.ylabel("Fitness") - plt.grid(True) - plt.legend() - - file = csv_file.with_name("tune_fitness.png") # filename - plt.savefig(file, dpi=200) - plt.close() - LOGGER.info(f"Saved {file}") - - -def output_to_target(output, max_det=300): - """Convert model output to target format [batch_id, class_id, x, y, w, h, conf] for plotting.""" - targets = [] - for i, o in enumerate(output): - box, conf, cls = o[:max_det, :6].cpu().split((4, 1, 1), 1) - j = torch.full((conf.shape[0], 1), i) - targets.append(torch.cat((j, cls, ops.xyxy2xywh(box), conf), 1)) - targets = torch.cat(targets, 0).numpy() - return targets[:, 0], targets[:, 1], targets[:, 2:-1], targets[:, -1] - - -def output_to_rotated_target(output, max_det=300): - """Convert model output to target format [batch_id, class_id, x, y, w, h, conf] for plotting.""" - targets = [] - for i, o in enumerate(output): - box, conf, cls, angle = o[:max_det].cpu().split((4, 1, 1, 1), 1) - j = torch.full((conf.shape[0], 1), i) - targets.append(torch.cat((j, cls, box, angle, conf), 1)) - targets = torch.cat(targets, 0).numpy() - return targets[:, 0], targets[:, 1], targets[:, 2:-1], targets[:, -1] - - -def feature_visualization(x, module_type, stage, n=32, save_dir=Path("runs/detect/exp")): - """ - Visualize feature maps of a given model module during inference. - - Args: - x (torch.Tensor): Features to be visualized. - module_type (str): Module type. - stage (int): Module stage within the model. - n (int, optional): Maximum number of feature maps to plot. Defaults to 32. - save_dir (Path, optional): Directory to save results. Defaults to Path('runs/detect/exp'). - """ - for m in ["Detect", "Pose", "Segment"]: - if m in module_type: - return - _, channels, height, width = x.shape # batch, channels, height, width - if height > 1 and width > 1: - f = save_dir / f"stage{stage}_{module_type.split('.')[-1]}_features.png" # filename - - blocks = torch.chunk(x[0].cpu(), channels, dim=0) # select batch index 0, block by channels - n = min(n, channels) # number of plots - _, ax = plt.subplots(math.ceil(n / 8), 8, tight_layout=True) # 8 rows x n/8 cols - ax = ax.ravel() - plt.subplots_adjust(wspace=0.05, hspace=0.05) - for i in range(n): - ax[i].imshow(blocks[i].squeeze()) # cmap='gray' - ax[i].axis("off") - - LOGGER.info(f"Saving {f}... ({n}/{channels})") - plt.savefig(f, dpi=300, bbox_inches="tight") - plt.close() - np.save(str(f.with_suffix(".npy")), x[0].cpu().numpy()) # npy save diff --git a/ultralytics-main/ultralytics/utils/tal.py b/ultralytics-main/ultralytics/utils/tal.py deleted file mode 100644 index 9cee050..0000000 --- a/ultralytics-main/ultralytics/utils/tal.py +++ /dev/null @@ -1,344 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import torch -import torch.nn as nn - -from .checks import check_version -from .metrics import bbox_iou, probiou -from .ops import xywhr2xyxyxyxy - -TORCH_1_10 = check_version(torch.__version__, "1.10.0") - - -class TaskAlignedAssigner(nn.Module): - """ - A task-aligned assigner for object detection. - - This class assigns ground-truth (gt) objects to anchors based on the task-aligned metric, which combines both - classification and localization information. - - Attributes: - topk (int): The number of top candidates to consider. - num_classes (int): The number of object classes. - alpha (float): The alpha parameter for the classification component of the task-aligned metric. - beta (float): The beta parameter for the localization component of the task-aligned metric. - eps (float): A small value to prevent division by zero. - """ - - def __init__(self, topk=13, num_classes=80, alpha=1.0, beta=6.0, eps=1e-9): - """Initialize a TaskAlignedAssigner object with customizable hyperparameters.""" - super().__init__() - self.topk = topk - self.num_classes = num_classes - self.bg_idx = num_classes - self.alpha = alpha - self.beta = beta - self.eps = eps - - @torch.no_grad() - def forward(self, pd_scores, pd_bboxes, anc_points, gt_labels, gt_bboxes, mask_gt): - """ - Compute the task-aligned assignment. Reference code is available at - https://github.com/Nioolek/PPYOLOE_pytorch/blob/master/ppyoloe/assigner/tal_assigner.py. - - Args: - pd_scores (Tensor): shape(bs, num_total_anchors, num_classes) - pd_bboxes (Tensor): shape(bs, num_total_anchors, 4) - anc_points (Tensor): shape(num_total_anchors, 2) - gt_labels (Tensor): shape(bs, n_max_boxes, 1) - gt_bboxes (Tensor): shape(bs, n_max_boxes, 4) - mask_gt (Tensor): shape(bs, n_max_boxes, 1) - - Returns: - target_labels (Tensor): shape(bs, num_total_anchors) - target_bboxes (Tensor): shape(bs, num_total_anchors, 4) - target_scores (Tensor): shape(bs, num_total_anchors, num_classes) - fg_mask (Tensor): shape(bs, num_total_anchors) - target_gt_idx (Tensor): shape(bs, num_total_anchors) - """ - self.bs = pd_scores.shape[0] - self.n_max_boxes = gt_bboxes.shape[1] - - if self.n_max_boxes == 0: - device = gt_bboxes.device - return ( - torch.full_like(pd_scores[..., 0], self.bg_idx).to(device), - torch.zeros_like(pd_bboxes).to(device), - torch.zeros_like(pd_scores).to(device), - torch.zeros_like(pd_scores[..., 0]).to(device), - torch.zeros_like(pd_scores[..., 0]).to(device), - ) - - mask_pos, align_metric, overlaps = self.get_pos_mask( - pd_scores, pd_bboxes, gt_labels, gt_bboxes, anc_points, mask_gt - ) - - target_gt_idx, fg_mask, mask_pos = self.select_highest_overlaps(mask_pos, overlaps, self.n_max_boxes) - - # Assigned target - target_labels, target_bboxes, target_scores = self.get_targets(gt_labels, gt_bboxes, target_gt_idx, fg_mask) - - # Normalize - align_metric *= mask_pos - pos_align_metrics = align_metric.amax(dim=-1, keepdim=True) # b, max_num_obj - pos_overlaps = (overlaps * mask_pos).amax(dim=-1, keepdim=True) # b, max_num_obj - norm_align_metric = (align_metric * pos_overlaps / (pos_align_metrics + self.eps)).amax(-2).unsqueeze(-1) - target_scores = target_scores * norm_align_metric - - return target_labels, target_bboxes, target_scores, fg_mask.bool(), target_gt_idx - - def get_pos_mask(self, pd_scores, pd_bboxes, gt_labels, gt_bboxes, anc_points, mask_gt): - """Get in_gts mask, (b, max_num_obj, h*w).""" - mask_in_gts = self.select_candidates_in_gts(anc_points, gt_bboxes) - # Get anchor_align metric, (b, max_num_obj, h*w) - align_metric, overlaps = self.get_box_metrics(pd_scores, pd_bboxes, gt_labels, gt_bboxes, mask_in_gts * mask_gt) - # Get topk_metric mask, (b, max_num_obj, h*w) - mask_topk = self.select_topk_candidates(align_metric, topk_mask=mask_gt.expand(-1, -1, self.topk).bool()) - # Merge all mask to a final mask, (b, max_num_obj, h*w) - mask_pos = mask_topk * mask_in_gts * mask_gt - - return mask_pos, align_metric, overlaps - - def get_box_metrics(self, pd_scores, pd_bboxes, gt_labels, gt_bboxes, mask_gt): - """Compute alignment metric given predicted and ground truth bounding boxes.""" - na = pd_bboxes.shape[-2] - mask_gt = mask_gt.bool() # b, max_num_obj, h*w - overlaps = torch.zeros([self.bs, self.n_max_boxes, na], dtype=pd_bboxes.dtype, device=pd_bboxes.device) - bbox_scores = torch.zeros([self.bs, self.n_max_boxes, na], dtype=pd_scores.dtype, device=pd_scores.device) - - ind = torch.zeros([2, self.bs, self.n_max_boxes], dtype=torch.long) # 2, b, max_num_obj - ind[0] = torch.arange(end=self.bs).view(-1, 1).expand(-1, self.n_max_boxes) # b, max_num_obj - ind[1] = gt_labels.squeeze(-1) # b, max_num_obj - # Get the scores of each grid for each gt cls - bbox_scores[mask_gt] = pd_scores[ind[0], :, ind[1]][mask_gt] # b, max_num_obj, h*w - - # (b, max_num_obj, 1, 4), (b, 1, h*w, 4) - pd_boxes = pd_bboxes.unsqueeze(1).expand(-1, self.n_max_boxes, -1, -1)[mask_gt] - gt_boxes = gt_bboxes.unsqueeze(2).expand(-1, -1, na, -1)[mask_gt] - overlaps[mask_gt] = self.iou_calculation(gt_boxes, pd_boxes) - - align_metric = bbox_scores.pow(self.alpha) * overlaps.pow(self.beta) - return align_metric, overlaps - - def iou_calculation(self, gt_bboxes, pd_bboxes): - """IoU calculation for horizontal bounding boxes.""" - return bbox_iou(gt_bboxes, pd_bboxes, xywh=False, CIoU=True).squeeze(-1).clamp_(0) - - def select_topk_candidates(self, metrics, largest=True, topk_mask=None): - """ - Select the top-k candidates based on the given metrics. - - Args: - metrics (Tensor): A tensor of shape (b, max_num_obj, h*w), where b is the batch size, - max_num_obj is the maximum number of objects, and h*w represents the - total number of anchor points. - largest (bool): If True, select the largest values; otherwise, select the smallest values. - topk_mask (Tensor): An optional boolean tensor of shape (b, max_num_obj, topk), where - topk is the number of top candidates to consider. If not provided, - the top-k values are automatically computed based on the given metrics. - - Returns: - (Tensor): A tensor of shape (b, max_num_obj, h*w) containing the selected top-k candidates. - """ - - # (b, max_num_obj, topk) - topk_metrics, topk_idxs = torch.topk(metrics, self.topk, dim=-1, largest=largest) - if topk_mask is None: - topk_mask = (topk_metrics.max(-1, keepdim=True)[0] > self.eps).expand_as(topk_idxs) - # (b, max_num_obj, topk) - topk_idxs.masked_fill_(~topk_mask, 0) - - # (b, max_num_obj, topk, h*w) -> (b, max_num_obj, h*w) - count_tensor = torch.zeros(metrics.shape, dtype=torch.int8, device=topk_idxs.device) - ones = torch.ones_like(topk_idxs[:, :, :1], dtype=torch.int8, device=topk_idxs.device) - for k in range(self.topk): - # Expand topk_idxs for each value of k and add 1 at the specified positions - count_tensor.scatter_add_(-1, topk_idxs[:, :, k : k + 1], ones) - # count_tensor.scatter_add_(-1, topk_idxs, torch.ones_like(topk_idxs, dtype=torch.int8, device=topk_idxs.device)) - # Filter invalid bboxes - count_tensor.masked_fill_(count_tensor > 1, 0) - - return count_tensor.to(metrics.dtype) - - def get_targets(self, gt_labels, gt_bboxes, target_gt_idx, fg_mask): - """ - Compute target labels, target bounding boxes, and target scores for the positive anchor points. - - Args: - gt_labels (Tensor): Ground truth labels of shape (b, max_num_obj, 1), where b is the - batch size and max_num_obj is the maximum number of objects. - gt_bboxes (Tensor): Ground truth bounding boxes of shape (b, max_num_obj, 4). - target_gt_idx (Tensor): Indices of the assigned ground truth objects for positive - anchor points, with shape (b, h*w), where h*w is the total - number of anchor points. - fg_mask (Tensor): A boolean tensor of shape (b, h*w) indicating the positive - (foreground) anchor points. - - Returns: - (Tuple[Tensor, Tensor, Tensor]): A tuple containing the following tensors: - - target_labels (Tensor): Shape (b, h*w), containing the target labels for - positive anchor points. - - target_bboxes (Tensor): Shape (b, h*w, 4), containing the target bounding boxes - for positive anchor points. - - target_scores (Tensor): Shape (b, h*w, num_classes), containing the target scores - for positive anchor points, where num_classes is the number - of object classes. - """ - - # Assigned target labels, (b, 1) - batch_ind = torch.arange(end=self.bs, dtype=torch.int64, device=gt_labels.device)[..., None] - target_gt_idx = target_gt_idx + batch_ind * self.n_max_boxes # (b, h*w) - target_labels = gt_labels.long().flatten()[target_gt_idx] # (b, h*w) - - # Assigned target boxes, (b, max_num_obj, 4) -> (b, h*w, 4) - target_bboxes = gt_bboxes.view(-1, gt_bboxes.shape[-1])[target_gt_idx] - - # Assigned target scores - target_labels.clamp_(0) - - # 10x faster than F.one_hot() - target_scores = torch.zeros( - (target_labels.shape[0], target_labels.shape[1], self.num_classes), - dtype=torch.int64, - device=target_labels.device, - ) # (b, h*w, 80) - target_scores.scatter_(2, target_labels.unsqueeze(-1), 1) - - fg_scores_mask = fg_mask[:, :, None].repeat(1, 1, self.num_classes) # (b, h*w, 80) - target_scores = torch.where(fg_scores_mask > 0, target_scores, 0) - - return target_labels, target_bboxes, target_scores - - @staticmethod - def select_candidates_in_gts(xy_centers, gt_bboxes, eps=1e-9): - """ - Select the positive anchor center in gt. - - Args: - xy_centers (Tensor): shape(h*w, 2) - gt_bboxes (Tensor): shape(b, n_boxes, 4) - - Returns: - (Tensor): shape(b, n_boxes, h*w) - """ - n_anchors = xy_centers.shape[0] - bs, n_boxes, _ = gt_bboxes.shape - lt, rb = gt_bboxes.view(-1, 1, 4).chunk(2, 2) # left-top, right-bottom - bbox_deltas = torch.cat((xy_centers[None] - lt, rb - xy_centers[None]), dim=2).view(bs, n_boxes, n_anchors, -1) - # return (bbox_deltas.min(3)[0] > eps).to(gt_bboxes.dtype) - return bbox_deltas.amin(3).gt_(eps) - - @staticmethod - def select_highest_overlaps(mask_pos, overlaps, n_max_boxes): - """ - If an anchor box is assigned to multiple gts, the one with the highest IoU will be selected. - - Args: - mask_pos (Tensor): shape(b, n_max_boxes, h*w) - overlaps (Tensor): shape(b, n_max_boxes, h*w) - - Returns: - target_gt_idx (Tensor): shape(b, h*w) - fg_mask (Tensor): shape(b, h*w) - mask_pos (Tensor): shape(b, n_max_boxes, h*w) - """ - # (b, n_max_boxes, h*w) -> (b, h*w) - fg_mask = mask_pos.sum(-2) - if fg_mask.max() > 1: # one anchor is assigned to multiple gt_bboxes - mask_multi_gts = (fg_mask.unsqueeze(1) > 1).expand(-1, n_max_boxes, -1) # (b, n_max_boxes, h*w) - max_overlaps_idx = overlaps.argmax(1) # (b, h*w) - - is_max_overlaps = torch.zeros(mask_pos.shape, dtype=mask_pos.dtype, device=mask_pos.device) - is_max_overlaps.scatter_(1, max_overlaps_idx.unsqueeze(1), 1) - - mask_pos = torch.where(mask_multi_gts, is_max_overlaps, mask_pos).float() # (b, n_max_boxes, h*w) - fg_mask = mask_pos.sum(-2) - # Find each grid serve which gt(index) - target_gt_idx = mask_pos.argmax(-2) # (b, h*w) - return target_gt_idx, fg_mask, mask_pos - - -class RotatedTaskAlignedAssigner(TaskAlignedAssigner): - def iou_calculation(self, gt_bboxes, pd_bboxes): - """IoU calculation for rotated bounding boxes.""" - return probiou(gt_bboxes, pd_bboxes).squeeze(-1).clamp_(0) - - @staticmethod - def select_candidates_in_gts(xy_centers, gt_bboxes): - """ - Select the positive anchor center in gt for rotated bounding boxes. - - Args: - xy_centers (Tensor): shape(h*w, 2) - gt_bboxes (Tensor): shape(b, n_boxes, 5) - - Returns: - (Tensor): shape(b, n_boxes, h*w) - """ - # (b, n_boxes, 5) --> (b, n_boxes, 4, 2) - corners = xywhr2xyxyxyxy(gt_bboxes) - # (b, n_boxes, 1, 2) - a, b, _, d = corners.split(1, dim=-2) - ab = b - a - ad = d - a - - # (b, n_boxes, h*w, 2) - ap = xy_centers - a - norm_ab = (ab * ab).sum(dim=-1) - norm_ad = (ad * ad).sum(dim=-1) - ap_dot_ab = (ap * ab).sum(dim=-1) - ap_dot_ad = (ap * ad).sum(dim=-1) - return (ap_dot_ab >= 0) & (ap_dot_ab <= norm_ab) & (ap_dot_ad >= 0) & (ap_dot_ad <= norm_ad) # is_in_box - - -def make_anchors(feats, strides, grid_cell_offset=0.5): - """Generate anchors from features.""" - anchor_points, stride_tensor = [], [] - assert feats is not None - dtype, device = feats[0].dtype, feats[0].device - for i, stride in enumerate(strides): - _, _, h, w = feats[i].shape - sx = torch.arange(end=w, device=device, dtype=dtype) + grid_cell_offset # shift x - sy = torch.arange(end=h, device=device, dtype=dtype) + grid_cell_offset # shift y - sy, sx = torch.meshgrid(sy, sx, indexing="ij") if TORCH_1_10 else torch.meshgrid(sy, sx) - anchor_points.append(torch.stack((sx, sy), -1).view(-1, 2)) - stride_tensor.append(torch.full((h * w, 1), stride, dtype=dtype, device=device)) - return torch.cat(anchor_points), torch.cat(stride_tensor) - - -def dist2bbox(distance, anchor_points, xywh=True, dim=-1): - """Transform distance(ltrb) to box(xywh or xyxy).""" - lt, rb = distance.chunk(2, dim) - x1y1 = anchor_points - lt - x2y2 = anchor_points + rb - if xywh: - c_xy = (x1y1 + x2y2) / 2 - wh = x2y2 - x1y1 - return torch.cat((c_xy, wh), dim) # xywh bbox - return torch.cat((x1y1, x2y2), dim) # xyxy bbox - - -def bbox2dist(anchor_points, bbox, reg_max): - """Transform bbox(xyxy) to dist(ltrb).""" - x1y1, x2y2 = bbox.chunk(2, -1) - return torch.cat((anchor_points - x1y1, x2y2 - anchor_points), -1).clamp_(0, reg_max - 0.01) # dist (lt, rb) - - -def dist2rbox(pred_dist, pred_angle, anchor_points, dim=-1): - """ - Decode predicted object bounding box coordinates from anchor points and distribution. - - Args: - pred_dist (torch.Tensor): Predicted rotated distance, (bs, h*w, 4). - pred_angle (torch.Tensor): Predicted angle, (bs, h*w, 1). - anchor_points (torch.Tensor): Anchor points, (h*w, 2). - Returns: - (torch.Tensor): Predicted rotated bounding boxes, (bs, h*w, 4). - """ - lt, rb = pred_dist.split(2, dim=dim) - cos, sin = torch.cos(pred_angle), torch.sin(pred_angle) - # (bs, h*w, 1) - xf, yf = ((rb - lt) / 2).split(1, dim=dim) - x, y = xf * cos - yf * sin, xf * sin + yf * cos - xy = torch.cat([x, y], dim=dim) + anchor_points - return torch.cat([xy, lt + rb], dim=dim) diff --git a/ultralytics-main/ultralytics/utils/torch_utils.py b/ultralytics-main/ultralytics/utils/torch_utils.py deleted file mode 100644 index ea0cdf1..0000000 --- a/ultralytics-main/ultralytics/utils/torch_utils.py +++ /dev/null @@ -1,608 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import math -import os -import random -import time -from contextlib import contextmanager -from copy import deepcopy -from pathlib import Path -from typing import Union - -import numpy as np -import torch -import torch.distributed as dist -import torch.nn as nn -import torch.nn.functional as F -import torchvision - -from ultralytics.utils import DEFAULT_CFG_DICT, DEFAULT_CFG_KEYS, LOGGER, __version__ -from ultralytics.utils.checks import PYTHON_VERSION, check_version - -try: - import thop -except ImportError: - thop = None - -TORCH_1_9 = check_version(torch.__version__, "1.9.0") -TORCH_1_13 = check_version(torch.__version__, "1.13.0") -TORCH_2_0 = check_version(torch.__version__, "2.0.0") -TORCHVISION_0_10 = check_version(torchvision.__version__, "0.10.0") -TORCHVISION_0_11 = check_version(torchvision.__version__, "0.11.0") -TORCHVISION_0_13 = check_version(torchvision.__version__, "0.13.0") - - -@contextmanager -def torch_distributed_zero_first(local_rank: int): - """Decorator to make all processes in distributed training wait for each local_master to do something.""" - initialized = torch.distributed.is_available() and torch.distributed.is_initialized() - if initialized and local_rank not in (-1, 0): - dist.barrier(device_ids=[local_rank]) - yield - if initialized and local_rank == 0: - dist.barrier(device_ids=[0]) - - -def smart_inference_mode(): - """Applies torch.inference_mode() decorator if torch>=1.9.0 else torch.no_grad() decorator.""" - - def decorate(fn): - """Applies appropriate torch decorator for inference mode based on torch version.""" - if TORCH_1_9 and torch.is_inference_mode_enabled(): - return fn # already in inference_mode, act as a pass-through - else: - return (torch.inference_mode if TORCH_1_9 else torch.no_grad)()(fn) - - return decorate - - -def get_cpu_info(): - """Return a string with system CPU information, i.e. 'Apple M2'.""" - import cpuinfo # pip install py-cpuinfo - - k = "brand_raw", "hardware_raw", "arch_string_raw" # info keys sorted by preference (not all keys always available) - info = cpuinfo.get_cpu_info() # info dict - string = info.get(k[0] if k[0] in info else k[1] if k[1] in info else k[2], "unknown") - return string.replace("(R)", "").replace("CPU ", "").replace("@ ", "") - - -def select_device(device="", batch=0, newline=False, verbose=True): - """ - Selects the appropriate PyTorch device based on the provided arguments. - - The function takes a string specifying the device or a torch.device object and returns a torch.device object - representing the selected device. The function also validates the number of available devices and raises an - exception if the requested device(s) are not available. - - Args: - device (str | torch.device, optional): Device string or torch.device object. - Options are 'None', 'cpu', or 'cuda', or '0' or '0,1,2,3'. Defaults to an empty string, which auto-selects - the first available GPU, or CPU if no GPU is available. - batch (int, optional): Batch size being used in your model. Defaults to 0. - newline (bool, optional): If True, adds a newline at the end of the log string. Defaults to False. - verbose (bool, optional): If True, logs the device information. Defaults to True. - - Returns: - (torch.device): Selected device. - - Raises: - ValueError: If the specified device is not available or if the batch size is not a multiple of the number of - devices when using multiple GPUs. - - Examples: - >>> select_device('cuda:0') - device(type='cuda', index=0) - - >>> select_device('cpu') - device(type='cpu') - - Note: - Sets the 'CUDA_VISIBLE_DEVICES' environment variable for specifying which GPUs to use. - """ - - if isinstance(device, torch.device): - return device - - s = f"Ultralytics YOLOv{__version__} 🚀 Python-{PYTHON_VERSION} torch-{torch.__version__} " - device = str(device).lower() - for remove in "cuda:", "none", "(", ")", "[", "]", "'", " ": - device = device.replace(remove, "") # to string, 'cuda:0' -> '0' and '(0, 1)' -> '0,1' - cpu = device == "cpu" - mps = device in ("mps", "mps:0") # Apple Metal Performance Shaders (MPS) - if cpu or mps: - os.environ["CUDA_VISIBLE_DEVICES"] = "-1" # force torch.cuda.is_available() = False - elif device: # non-cpu device requested - if device == "cuda": - device = "0" - visible = os.environ.get("CUDA_VISIBLE_DEVICES", None) - os.environ["CUDA_VISIBLE_DEVICES"] = device # set environment variable - must be before assert is_available() - if not (torch.cuda.is_available() and torch.cuda.device_count() >= len(device.split(","))): - LOGGER.info(s) - install = ( - "See https://pytorch.org/get-started/locally/ for up-to-date torch install instructions if no " - "CUDA devices are seen by torch.\n" - if torch.cuda.device_count() == 0 - else "" - ) - raise ValueError( - f"Invalid CUDA 'device={device}' requested." - f" Use 'device=cpu' or pass valid CUDA device(s) if available," - f" i.e. 'device=0' or 'device=0,1,2,3' for Multi-GPU.\n" - f"\ntorch.cuda.is_available(): {torch.cuda.is_available()}" - f"\ntorch.cuda.device_count(): {torch.cuda.device_count()}" - f"\nos.environ['CUDA_VISIBLE_DEVICES']: {visible}\n" - f"{install}" - ) - - if not cpu and not mps and torch.cuda.is_available(): # prefer GPU if available - devices = device.split(",") if device else "0" # range(torch.cuda.device_count()) # i.e. 0,1,6,7 - n = len(devices) # device count - if n > 1 and batch > 0 and batch % n != 0: # check batch_size is divisible by device_count - raise ValueError( - f"'batch={batch}' must be a multiple of GPU count {n}. Try 'batch={batch // n * n}' or " - f"'batch={batch // n * n + n}', the nearest batch sizes evenly divisible by {n}." - ) - space = " " * (len(s) + 1) - for i, d in enumerate(devices): - p = torch.cuda.get_device_properties(i) - s += f"{'' if i == 0 else space}CUDA:{d} ({p.name}, {p.total_memory / (1 << 20):.0f}MiB)\n" # bytes to MB - arg = "cuda:0" - elif mps and TORCH_2_0 and torch.backends.mps.is_available(): - # Prefer MPS if available - s += f"MPS ({get_cpu_info()})\n" - arg = "mps" - else: # revert to CPU - s += f"CPU ({get_cpu_info()})\n" - arg = "cpu" - - if verbose: - LOGGER.info(s if newline else s.rstrip()) - return torch.device(arg) - - -def time_sync(): - """PyTorch-accurate time.""" - if torch.cuda.is_available(): - torch.cuda.synchronize() - return time.time() - - -def fuse_conv_and_bn(conv, bn): - """Fuse Conv2d() and BatchNorm2d() layers https://tehnokv.com/posts/fusing-batchnorm-and-conv/.""" - fusedconv = ( - nn.Conv2d( - conv.in_channels, - conv.out_channels, - kernel_size=conv.kernel_size, - stride=conv.stride, - padding=conv.padding, - dilation=conv.dilation, - groups=conv.groups, - bias=True, - ) - .requires_grad_(False) - .to(conv.weight.device) - ) - - # Prepare filters - w_conv = conv.weight.clone().view(conv.out_channels, -1) - w_bn = torch.diag(bn.weight.div(torch.sqrt(bn.eps + bn.running_var))) - fusedconv.weight.copy_(torch.mm(w_bn, w_conv).view(fusedconv.weight.shape)) - - # Prepare spatial bias - b_conv = torch.zeros(conv.weight.shape[0], device=conv.weight.device) if conv.bias is None else conv.bias - b_bn = bn.bias - bn.weight.mul(bn.running_mean).div(torch.sqrt(bn.running_var + bn.eps)) - fusedconv.bias.copy_(torch.mm(w_bn, b_conv.reshape(-1, 1)).reshape(-1) + b_bn) - - return fusedconv - - -def fuse_deconv_and_bn(deconv, bn): - """Fuse ConvTranspose2d() and BatchNorm2d() layers.""" - fuseddconv = ( - nn.ConvTranspose2d( - deconv.in_channels, - deconv.out_channels, - kernel_size=deconv.kernel_size, - stride=deconv.stride, - padding=deconv.padding, - output_padding=deconv.output_padding, - dilation=deconv.dilation, - groups=deconv.groups, - bias=True, - ) - .requires_grad_(False) - .to(deconv.weight.device) - ) - - # Prepare filters - w_deconv = deconv.weight.clone().view(deconv.out_channels, -1) - w_bn = torch.diag(bn.weight.div(torch.sqrt(bn.eps + bn.running_var))) - fuseddconv.weight.copy_(torch.mm(w_bn, w_deconv).view(fuseddconv.weight.shape)) - - # Prepare spatial bias - b_conv = torch.zeros(deconv.weight.shape[1], device=deconv.weight.device) if deconv.bias is None else deconv.bias - b_bn = bn.bias - bn.weight.mul(bn.running_mean).div(torch.sqrt(bn.running_var + bn.eps)) - fuseddconv.bias.copy_(torch.mm(w_bn, b_conv.reshape(-1, 1)).reshape(-1) + b_bn) - - return fuseddconv - - -def model_info(model, detailed=False, verbose=True, imgsz=640): - """ - Model information. - - imgsz may be int or list, i.e. imgsz=640 or imgsz=[640, 320]. - """ - if not verbose: - return - n_p = get_num_params(model) # number of parameters - n_g = get_num_gradients(model) # number of gradients - n_l = len(list(model.modules())) # number of layers - if detailed: - LOGGER.info( - f"{'layer':>5} {'name':>40} {'gradient':>9} {'parameters':>12} {'shape':>20} {'mu':>10} {'sigma':>10}" - ) - for i, (name, p) in enumerate(model.named_parameters()): - name = name.replace("module_list.", "") - LOGGER.info( - "%5g %40s %9s %12g %20s %10.3g %10.3g %10s" - % (i, name, p.requires_grad, p.numel(), list(p.shape), p.mean(), p.std(), p.dtype) - ) - - flops = get_flops(model, imgsz) - fused = " (fused)" if getattr(model, "is_fused", lambda: False)() else "" - fs = f", {flops:.1f} GFLOPs" if flops else "" - yaml_file = getattr(model, "yaml_file", "") or getattr(model, "yaml", {}).get("yaml_file", "") - model_name = Path(yaml_file).stem.replace("yolo", "YOLO") or "Model" - LOGGER.info(f"{model_name} summary{fused}: {n_l} layers, {n_p} parameters, {n_g} gradients{fs}") - return n_l, n_p, n_g, flops - - -def get_num_params(model): - """Return the total number of parameters in a YOLO model.""" - return sum(x.numel() for x in model.parameters()) - - -def get_num_gradients(model): - """Return the total number of parameters with gradients in a YOLO model.""" - return sum(x.numel() for x in model.parameters() if x.requires_grad) - - -def model_info_for_loggers(trainer): - """ - Return model info dict with useful model information. - - Example: - YOLOv8n info for loggers - ```python - results = {'model/parameters': 3151904, - 'model/GFLOPs': 8.746, - 'model/speed_ONNX(ms)': 41.244, - 'model/speed_TensorRT(ms)': 3.211, - 'model/speed_PyTorch(ms)': 18.755} - ``` - """ - if trainer.args.profile: # profile ONNX and TensorRT times - from ultralytics.utils.benchmarks import ProfileModels - - results = ProfileModels([trainer.last], device=trainer.device).profile()[0] - results.pop("model/name") - else: # only return PyTorch times from most recent validation - results = { - "model/parameters": get_num_params(trainer.model), - "model/GFLOPs": round(get_flops(trainer.model), 3), - } - results["model/speed_PyTorch(ms)"] = round(trainer.validator.speed["inference"], 3) - return results - - -def get_flops(model, imgsz=640): - """Return a YOLO model's FLOPs.""" - if not thop: - return 0.0 # if not installed return 0.0 GFLOPs - - try: - model = de_parallel(model) - p = next(model.parameters()) - if not isinstance(imgsz, list): - imgsz = [imgsz, imgsz] # expand if int/float - try: - # Use stride size for input tensor - stride = max(int(model.stride.max()), 32) if hasattr(model, "stride") else 32 # max stride - im = torch.empty((1, p.shape[1], stride, stride), device=p.device) # input image in BCHW format - flops = thop.profile(deepcopy(model), inputs=[im], verbose=False)[0] / 1e9 * 2 # stride GFLOPs - return flops * imgsz[0] / stride * imgsz[1] / stride # imgsz GFLOPs - except Exception: - # Use actual image size for input tensor (i.e. required for RTDETR models) - im = torch.empty((1, p.shape[1], *imgsz), device=p.device) # input image in BCHW format - return thop.profile(deepcopy(model), inputs=[im], verbose=False)[0] / 1e9 * 2 # imgsz GFLOPs - except Exception: - return 0.0 - - -def get_flops_with_torch_profiler(model, imgsz=640): - """Compute model FLOPs (thop alternative).""" - if TORCH_2_0: - model = de_parallel(model) - p = next(model.parameters()) - stride = (max(int(model.stride.max()), 32) if hasattr(model, "stride") else 32) * 2 # max stride - im = torch.zeros((1, p.shape[1], stride, stride), device=p.device) # input image in BCHW format - with torch.profiler.profile(with_flops=True) as prof: - model(im) - flops = sum(x.flops for x in prof.key_averages()) / 1e9 - imgsz = imgsz if isinstance(imgsz, list) else [imgsz, imgsz] # expand if int/float - flops = flops * imgsz[0] / stride * imgsz[1] / stride # 640x640 GFLOPs - return flops - return 0 - - -def initialize_weights(model): - """Initialize model weights to random values.""" - for m in model.modules(): - t = type(m) - if t is nn.Conv2d: - pass # nn.init.kaiming_normal_(m.weight, mode='fan_out', nonlinearity='relu') - elif t is nn.BatchNorm2d: - m.eps = 1e-3 - m.momentum = 0.03 - elif t in [nn.Hardswish, nn.LeakyReLU, nn.ReLU, nn.ReLU6, nn.SiLU]: - m.inplace = True - - -def scale_img(img, ratio=1.0, same_shape=False, gs=32): - """Scales and pads an image tensor of shape img(bs,3,y,x) based on given ratio and grid size gs, optionally - retaining the original shape. - """ - if ratio == 1.0: - return img - h, w = img.shape[2:] - s = (int(h * ratio), int(w * ratio)) # new size - img = F.interpolate(img, size=s, mode="bilinear", align_corners=False) # resize - if not same_shape: # pad/crop img - h, w = (math.ceil(x * ratio / gs) * gs for x in (h, w)) - return F.pad(img, [0, w - s[1], 0, h - s[0]], value=0.447) # value = imagenet mean - - -def make_divisible(x, divisor): - """Returns nearest x divisible by divisor.""" - if isinstance(divisor, torch.Tensor): - divisor = int(divisor.max()) # to int - return math.ceil(x / divisor) * divisor - - -def copy_attr(a, b, include=(), exclude=()): - """Copies attributes from object 'b' to object 'a', with options to include/exclude certain attributes.""" - for k, v in b.__dict__.items(): - if (len(include) and k not in include) or k.startswith("_") or k in exclude: - continue - else: - setattr(a, k, v) - - -def get_latest_opset(): - """Return second-most (for maturity) recently supported ONNX opset by this version of torch.""" - return max(int(k[14:]) for k in vars(torch.onnx) if "symbolic_opset" in k) - 1 # opset - - -def intersect_dicts(da, db, exclude=()): - """Returns a dictionary of intersecting keys with matching shapes, excluding 'exclude' keys, using da values.""" - return {k: v for k, v in da.items() if k in db and all(x not in k for x in exclude) and v.shape == db[k].shape} - - -def is_parallel(model): - """Returns True if model is of type DP or DDP.""" - return isinstance(model, (nn.parallel.DataParallel, nn.parallel.DistributedDataParallel)) - - -def de_parallel(model): - """De-parallelize a model: returns single-GPU model if model is of type DP or DDP.""" - return model.module if is_parallel(model) else model - - -def one_cycle(y1=0.0, y2=1.0, steps=100): - """Returns a lambda function for sinusoidal ramp from y1 to y2 https://arxiv.org/pdf/1812.01187.pdf.""" - return lambda x: max((1 - math.cos(x * math.pi / steps)) / 2, 0) * (y2 - y1) + y1 - - -def init_seeds(seed=0, deterministic=False): - """Initialize random number generator (RNG) seeds https://pytorch.org/docs/stable/notes/randomness.html.""" - random.seed(seed) - np.random.seed(seed) - torch.manual_seed(seed) - torch.cuda.manual_seed(seed) - torch.cuda.manual_seed_all(seed) # for Multi-GPU, exception safe - # torch.backends.cudnn.benchmark = True # AutoBatch problem https://github.com/ultralytics/yolov5/issues/9287 - if deterministic: - if TORCH_2_0: - torch.use_deterministic_algorithms(True, warn_only=True) # warn if deterministic is not possible - torch.backends.cudnn.deterministic = True - os.environ["CUBLAS_WORKSPACE_CONFIG"] = ":4096:8" - os.environ["PYTHONHASHSEED"] = str(seed) - else: - LOGGER.warning("WARNING ⚠️ Upgrade to torch>=2.0.0 for deterministic training.") - else: - torch.use_deterministic_algorithms(False) - torch.backends.cudnn.deterministic = False - - -class ModelEMA: - """Updated Exponential Moving Average (EMA) from https://github.com/rwightman/pytorch-image-models - Keeps a moving average of everything in the model state_dict (parameters and buffers) - For EMA details see https://www.tensorflow.org/api_docs/python/tf/train/ExponentialMovingAverage - To disable EMA set the `enabled` attribute to `False`. - """ - - def __init__(self, model, decay=0.9999, tau=2000, updates=0): - """Create EMA.""" - self.ema = deepcopy(de_parallel(model)).eval() # FP32 EMA - self.updates = updates # number of EMA updates - self.decay = lambda x: decay * (1 - math.exp(-x / tau)) # decay exponential ramp (to help early epochs) - for p in self.ema.parameters(): - p.requires_grad_(False) - self.enabled = True - - def update(self, model): - """Update EMA parameters.""" - if self.enabled: - self.updates += 1 - d = self.decay(self.updates) - - msd = de_parallel(model).state_dict() # model state_dict - for k, v in self.ema.state_dict().items(): - if v.dtype.is_floating_point: # true for FP16 and FP32 - v *= d - v += (1 - d) * msd[k].detach() - # assert v.dtype == msd[k].dtype == torch.float32, f'{k}: EMA {v.dtype}, model {msd[k].dtype}' - - def update_attr(self, model, include=(), exclude=("process_group", "reducer")): - """Updates attributes and saves stripped model with optimizer removed.""" - if self.enabled: - copy_attr(self.ema, model, include, exclude) - - -def strip_optimizer(f: Union[str, Path] = "best.pt", s: str = "") -> None: - """ - Strip optimizer from 'f' to finalize training, optionally save as 's'. - - Args: - f (str): file path to model to strip the optimizer from. Default is 'best.pt'. - s (str): file path to save the model with stripped optimizer to. If not provided, 'f' will be overwritten. - - Returns: - None - - Example: - ```python - from pathlib import Path - from ultralytics.utils.torch_utils import strip_optimizer - - for f in Path('path/to/weights').rglob('*.pt'): - strip_optimizer(f) - ``` - """ - x = torch.load(f, map_location=torch.device("cpu")) - if "model" not in x: - LOGGER.info(f"Skipping {f}, not a valid Ultralytics model.") - return - - if hasattr(x["model"], "args"): - x["model"].args = dict(x["model"].args) # convert from IterableSimpleNamespace to dict - args = {**DEFAULT_CFG_DICT, **x["train_args"]} if "train_args" in x else None # combine args - if x.get("ema"): - x["model"] = x["ema"] # replace model with ema - for k in "optimizer", "best_fitness", "ema", "updates": # keys - x[k] = None - x["epoch"] = -1 - x["model"].half() # to FP16 - for p in x["model"].parameters(): - p.requires_grad = False - x["train_args"] = {k: v for k, v in args.items() if k in DEFAULT_CFG_KEYS} # strip non-default keys - # x['model'].args = x['train_args'] - torch.save(x, s or f) - mb = os.path.getsize(s or f) / 1e6 # file size - LOGGER.info(f"Optimizer stripped from {f},{f' saved as {s},' if s else ''} {mb:.1f}MB") - - -def profile(input, ops, n=10, device=None): - """ - Ultralytics speed, memory and FLOPs profiler. - - Example: - ```python - from ultralytics.utils.torch_utils import profile - - input = torch.randn(16, 3, 640, 640) - m1 = lambda x: x * torch.sigmoid(x) - m2 = nn.SiLU() - profile(input, [m1, m2], n=100) # profile over 100 iterations - ``` - """ - results = [] - if not isinstance(device, torch.device): - device = select_device(device) - LOGGER.info( - f"{'Params':>12s}{'GFLOPs':>12s}{'GPU_mem (GB)':>14s}{'forward (ms)':>14s}{'backward (ms)':>14s}" - f"{'input':>24s}{'output':>24s}" - ) - - for x in input if isinstance(input, list) else [input]: - x = x.to(device) - x.requires_grad = True - for m in ops if isinstance(ops, list) else [ops]: - m = m.to(device) if hasattr(m, "to") else m # device - m = m.half() if hasattr(m, "half") and isinstance(x, torch.Tensor) and x.dtype is torch.float16 else m - tf, tb, t = 0, 0, [0, 0, 0] # dt forward, backward - try: - flops = thop.profile(m, inputs=[x], verbose=False)[0] / 1e9 * 2 if thop else 0 # GFLOPs - except Exception: - flops = 0 - - try: - for _ in range(n): - t[0] = time_sync() - y = m(x) - t[1] = time_sync() - try: - (sum(yi.sum() for yi in y) if isinstance(y, list) else y).sum().backward() - t[2] = time_sync() - except Exception: # no backward method - # print(e) # for debug - t[2] = float("nan") - tf += (t[1] - t[0]) * 1000 / n # ms per op forward - tb += (t[2] - t[1]) * 1000 / n # ms per op backward - mem = torch.cuda.memory_reserved() / 1e9 if torch.cuda.is_available() else 0 # (GB) - s_in, s_out = (tuple(x.shape) if isinstance(x, torch.Tensor) else "list" for x in (x, y)) # shapes - p = sum(x.numel() for x in m.parameters()) if isinstance(m, nn.Module) else 0 # parameters - LOGGER.info(f"{p:12}{flops:12.4g}{mem:>14.3f}{tf:14.4g}{tb:14.4g}{str(s_in):>24s}{str(s_out):>24s}") - results.append([p, flops, mem, tf, tb, s_in, s_out]) - except Exception as e: - LOGGER.info(e) - results.append(None) - torch.cuda.empty_cache() - return results - - -class EarlyStopping: - """Early stopping class that stops training when a specified number of epochs have passed without improvement.""" - - def __init__(self, patience=50): - """ - Initialize early stopping object. - - Args: - patience (int, optional): Number of epochs to wait after fitness stops improving before stopping. - """ - self.best_fitness = 0.0 # i.e. mAP - self.best_epoch = 0 - self.patience = patience or float("inf") # epochs to wait after fitness stops improving to stop - self.possible_stop = False # possible stop may occur next epoch - - def __call__(self, epoch, fitness): - """ - Check whether to stop training. - - Args: - epoch (int): Current epoch of training - fitness (float): Fitness value of current epoch - - Returns: - (bool): True if training should stop, False otherwise - """ - if fitness is None: # check if fitness=None (happens when val=False) - return False - - if fitness >= self.best_fitness: # >= 0 to allow for early zero-fitness stage of training - self.best_epoch = epoch - self.best_fitness = fitness - delta = epoch - self.best_epoch # epochs without improvement - self.possible_stop = delta >= (self.patience - 1) # possible stop may occur next epoch - stop = delta >= self.patience # stop training if patience exceeded - if stop: - LOGGER.info( - f"Stopping training early as no improvement observed in last {self.patience} epochs. " - f"Best results observed at epoch {self.best_epoch}, best model saved as best.pt.\n" - f"To update EarlyStopping(patience={self.patience}) pass a new patience value, " - f"i.e. `patience=300` or use `patience=0` to disable EarlyStopping." - ) - return stop diff --git a/ultralytics-main/ultralytics/utils/triton.py b/ultralytics-main/ultralytics/utils/triton.py deleted file mode 100644 index 3f873a6..0000000 --- a/ultralytics-main/ultralytics/utils/triton.py +++ /dev/null @@ -1,92 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -from typing import List -from urllib.parse import urlsplit - -import numpy as np - - -class TritonRemoteModel: - """ - Client for interacting with a remote Triton Inference Server model. - - Attributes: - endpoint (str): The name of the model on the Triton server. - url (str): The URL of the Triton server. - triton_client: The Triton client (either HTTP or gRPC). - InferInput: The input class for the Triton client. - InferRequestedOutput: The output request class for the Triton client. - input_formats (List[str]): The data types of the model inputs. - np_input_formats (List[type]): The numpy data types of the model inputs. - input_names (List[str]): The names of the model inputs. - output_names (List[str]): The names of the model outputs. - """ - - def __init__(self, url: str, endpoint: str = "", scheme: str = ""): - """ - Initialize the TritonRemoteModel. - - Arguments may be provided individually or parsed from a collective 'url' argument of the form - ://// - - Args: - url (str): The URL of the Triton server. - endpoint (str): The name of the model on the Triton server. - scheme (str): The communication scheme ('http' or 'grpc'). - """ - if not endpoint and not scheme: # Parse all args from URL string - splits = urlsplit(url) - endpoint = splits.path.strip("/").split("/")[0] - scheme = splits.scheme - url = splits.netloc - - self.endpoint = endpoint - self.url = url - - # Choose the Triton client based on the communication scheme - if scheme == "http": - import tritonclient.http as client # noqa - - self.triton_client = client.InferenceServerClient(url=self.url, verbose=False, ssl=False) - config = self.triton_client.get_model_config(endpoint) - else: - import tritonclient.grpc as client # noqa - - self.triton_client = client.InferenceServerClient(url=self.url, verbose=False, ssl=False) - config = self.triton_client.get_model_config(endpoint, as_json=True)["config"] - - # Sort output names alphabetically, i.e. 'output0', 'output1', etc. - config["output"] = sorted(config["output"], key=lambda x: x.get("name")) - - # Define model attributes - type_map = {"TYPE_FP32": np.float32, "TYPE_FP16": np.float16, "TYPE_UINT8": np.uint8} - self.InferRequestedOutput = client.InferRequestedOutput - self.InferInput = client.InferInput - self.input_formats = [x["data_type"] for x in config["input"]] - self.np_input_formats = [type_map[x] for x in self.input_formats] - self.input_names = [x["name"] for x in config["input"]] - self.output_names = [x["name"] for x in config["output"]] - - def __call__(self, *inputs: np.ndarray) -> List[np.ndarray]: - """ - Call the model with the given inputs. - - Args: - *inputs (List[np.ndarray]): Input data to the model. - - Returns: - (List[np.ndarray]): Model outputs. - """ - infer_inputs = [] - input_format = inputs[0].dtype - for i, x in enumerate(inputs): - if x.dtype != self.np_input_formats[i]: - x = x.astype(self.np_input_formats[i]) - infer_input = self.InferInput(self.input_names[i], [*x.shape], self.input_formats[i].replace("TYPE_", "")) - infer_input.set_data_from_numpy(x) - infer_inputs.append(infer_input) - - infer_outputs = [self.InferRequestedOutput(output_name) for output_name in self.output_names] - outputs = self.triton_client.infer(model_name=self.endpoint, inputs=infer_inputs, outputs=infer_outputs) - - return [outputs.as_numpy(output_name).astype(input_format) for output_name in self.output_names] diff --git a/ultralytics-main/ultralytics/utils/tuner.py b/ultralytics-main/ultralytics/utils/tuner.py deleted file mode 100644 index 20e3b75..0000000 --- a/ultralytics-main/ultralytics/utils/tuner.py +++ /dev/null @@ -1,146 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license - -import subprocess - -from ultralytics.cfg import TASK2DATA, TASK2METRIC, get_save_dir -from ultralytics.utils import DEFAULT_CFG, DEFAULT_CFG_DICT, LOGGER, NUM_THREADS - - -def run_ray_tune( - model, space: dict = None, grace_period: int = 10, gpu_per_trial: int = None, max_samples: int = 10, **train_args -): - """ - Runs hyperparameter tuning using Ray Tune. - - Args: - model (YOLO): Model to run the tuner on. - space (dict, optional): The hyperparameter search space. Defaults to None. - grace_period (int, optional): The grace period in epochs of the ASHA scheduler. Defaults to 10. - gpu_per_trial (int, optional): The number of GPUs to allocate per trial. Defaults to None. - max_samples (int, optional): The maximum number of trials to run. Defaults to 10. - train_args (dict, optional): Additional arguments to pass to the `train()` method. Defaults to {}. - - Returns: - (dict): A dictionary containing the results of the hyperparameter search. - - Example: - ```python - from ultralytics import YOLO - - # Load a YOLOv8n model - model = YOLO('yolov8n.pt') - - # Start tuning hyperparameters for YOLOv8n training on the COCO8 dataset - result_grid = model.tune(data='coco8.yaml', use_ray=True) - ``` - """ - - LOGGER.info("💡 Learn about RayTune at https://docs.ultralytics.com/integrations/ray-tune") - if train_args is None: - train_args = {} - - try: - subprocess.run("pip install ray[tune]".split(), check=True) - - import ray - from ray import tune - from ray.air import RunConfig - from ray.air.integrations.wandb import WandbLoggerCallback - from ray.tune.schedulers import ASHAScheduler - except ImportError: - raise ModuleNotFoundError('Tuning hyperparameters requires Ray Tune. Install with: pip install "ray[tune]"') - - try: - import wandb - - assert hasattr(wandb, "__version__") - except (ImportError, AssertionError): - wandb = False - - default_space = { - # 'optimizer': tune.choice(['SGD', 'Adam', 'AdamW', 'NAdam', 'RAdam', 'RMSProp']), - "lr0": tune.uniform(1e-5, 1e-1), - "lrf": tune.uniform(0.01, 1.0), # final OneCycleLR learning rate (lr0 * lrf) - "momentum": tune.uniform(0.6, 0.98), # SGD momentum/Adam beta1 - "weight_decay": tune.uniform(0.0, 0.001), # optimizer weight decay 5e-4 - "warmup_epochs": tune.uniform(0.0, 5.0), # warmup epochs (fractions ok) - "warmup_momentum": tune.uniform(0.0, 0.95), # warmup initial momentum - "box": tune.uniform(0.02, 0.2), # box loss gain - "cls": tune.uniform(0.2, 4.0), # cls loss gain (scale with pixels) - "hsv_h": tune.uniform(0.0, 0.1), # image HSV-Hue augmentation (fraction) - "hsv_s": tune.uniform(0.0, 0.9), # image HSV-Saturation augmentation (fraction) - "hsv_v": tune.uniform(0.0, 0.9), # image HSV-Value augmentation (fraction) - "degrees": tune.uniform(0.0, 45.0), # image rotation (+/- deg) - "translate": tune.uniform(0.0, 0.9), # image translation (+/- fraction) - "scale": tune.uniform(0.0, 0.9), # image scale (+/- gain) - "shear": tune.uniform(0.0, 10.0), # image shear (+/- deg) - "perspective": tune.uniform(0.0, 0.001), # image perspective (+/- fraction), range 0-0.001 - "flipud": tune.uniform(0.0, 1.0), # image flip up-down (probability) - "fliplr": tune.uniform(0.0, 1.0), # image flip left-right (probability) - "mosaic": tune.uniform(0.0, 1.0), # image mixup (probability) - "mixup": tune.uniform(0.0, 1.0), # image mixup (probability) - "copy_paste": tune.uniform(0.0, 1.0), # segment copy-paste (probability) - } - - # Put the model in ray store - task = model.task - model_in_store = ray.put(model) - - def _tune(config): - """ - Trains the YOLO model with the specified hyperparameters and additional arguments. - - Args: - config (dict): A dictionary of hyperparameters to use for training. - - Returns: - None - """ - model_to_train = ray.get(model_in_store) # get the model from ray store for tuning - model_to_train.reset_callbacks() - config.update(train_args) - results = model_to_train.train(**config) - return results.results_dict - - # Get search space - if not space: - space = default_space - LOGGER.warning("WARNING ⚠️ search space not provided, using default search space.") - - # Get dataset - data = train_args.get("data", TASK2DATA[task]) - space["data"] = data - if "data" not in train_args: - LOGGER.warning(f'WARNING ⚠️ data not provided, using default "data={data}".') - - # Define the trainable function with allocated resources - trainable_with_resources = tune.with_resources(_tune, {"cpu": NUM_THREADS, "gpu": gpu_per_trial or 0}) - - # Define the ASHA scheduler for hyperparameter search - asha_scheduler = ASHAScheduler( - time_attr="epoch", - metric=TASK2METRIC[task], - mode="max", - max_t=train_args.get("epochs") or DEFAULT_CFG_DICT["epochs"] or 100, - grace_period=grace_period, - reduction_factor=3, - ) - - # Define the callbacks for the hyperparameter search - tuner_callbacks = [WandbLoggerCallback(project="YOLOv8-tune")] if wandb else [] - - # Create the Ray Tune hyperparameter search tuner - tune_dir = get_save_dir(DEFAULT_CFG, name="tune").resolve() # must be absolute dir - tune_dir.mkdir(parents=True, exist_ok=True) - tuner = tune.Tuner( - trainable_with_resources, - param_space=space, - tune_config=tune.TuneConfig(scheduler=asha_scheduler, num_samples=max_samples), - run_config=RunConfig(callbacks=tuner_callbacks, storage_path=tune_dir), - ) - - # Run the hyperparameter search - tuner.fit() - - # Return the results of the hyperparameter search - return tuner.get_results() diff --git a/ultralytics-main/ultralytics/zidane.jpg b/ultralytics-main/ultralytics/zidane.jpg deleted file mode 100644 index 92d72ea124760ce5dbf9425e3aa8f371e7481328..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 168949 zcmbTcXH*ki_&pj35IRzVK>|{u2mz!BCNwEZlMV@8kt$Un(go=%hR_5NLj>uB-Vsp{ zN$4PiB26TL&{3)=`d)tj+t#|D?!C{P`7~$FI(z2Koc%m||2OmB65yP%zL7qFfdK$u zI6DCU%>ncPKt{&@X=lN7)|gqDnVFcF*+C!{R!(+KP7Zbs4lZuKb6niK+#DR|1kdsE z3xL63PM-4+K>-M#09fFE24Mi6-NVGp#>~tnz{SBO@c%jf>jLnyGLA6=fD94>Otun$H0k8Gt}WCgA_f`mA^K*>wODFEgLG zq7DncdOz9vTJZW8@u3nh|q;gm!+;q%Un}Yy^cVt>D|1g zZ(wL-Y;A)=+uGSXxVd|HdfoT-!8{BJ4GWKmOh`;he)9BLN@muJ?3|amukzj&6_=Ej zl~+_YG&VK2w6?Xs`_%KfmqhOC9~hsYOioSDe4YKiOr@=?(%05Ee(vob93CD2I{E!S zxERiG{-5!`1N(pA;yuH~$ixI>0{ssz2F9?n6UfWNEUw7Hr(+4a7sM~26vrx{n^9Qb z%_gaA^#kl0{DoZ*cJ2G6pZ^2xeo7qb5g*#C`d7QhK)ID2_OUce2&ufHzx z8zAKNG&q3O-qlkByS+Jl8{E+lu-6qZe@LvGD?F)>Z-Z!V_8W{{iZ*`6!3U`s<3?&w zh<TY=CY^h zYgye50f8>2szScn`j(oPMzYf|q3_fL{M{|1_`V?nbf`hJC~Nm-vG2C9Ll_-gCJ|uE zU?5qdKh`QI;V!S`A@bACtSX0&lJU+xKQ%8ng6SUi=q$QyG{V}Y)jV(feFUG^-CjwI~DQ~j?re?;GK zRFkkjq@T58temM{O6=le#H@`XF8svWEFd4K~M=t5-U#*Y3#lpcTA za70$lJCTf(4YRD%Vn%Q*D5diI>zCcYkJFuo?p8~U0D8fQ8Vdd5rC392xmNaYNa$O? zsh6&JNd*fIz6jv1HT3Sv}VD_T#{TI?k zUU+1XSm*ZAEUgkfxsyJaY2A%X4hj6a5_#IbZdui2GH^e5U?V|{VM3~)RHHOlh~^1T zawZp+Tp7NQEdIo*w7`?;+_QKdpX4l0-&>w~K}zzhNG6xxQ>fESMpjHbfIePhvPE;J zMMhp2?8v3zsTae5B_Y;mM~Inz^x&H}6@QiOTFpl=*ds6z^NMF^-tBUuC%lPJ{1bP$ zrlWp8V$%6bwuXW54@H#r)ys-$h1EvlvL6cAYg%Xs|Bk75%j5N=Ltzk893k=#x|v{m ziDy8cRUwwtLP6RO6pKlD(%Lq!C@9;fmV2$6_;Q815Fo)X~a4%?d00ADg zKaEpR-gE|M@kjwh6GTi^oysLO13-AVoj-$P$hElu!XjC*k9woG1Tx;7ty!-3)MtX z<(f}&iv`gBfvbm_4fL;4_9PKd;O1dz=j>ar8&OEfx+=w}L~2lf_v+isA2%Sb%D7H% zzbA#wN6V6+vX&^6`tv1$Oe3j6G85YAI6S)#p_f|8{g{)&zo5z{DQh69`NyW|RmpGg zp@Dty+%pkX!sN&hEg7_vkXC)S{hd;UaKG$4|5y|{dORZbNB9k;6nbWRm3)(@=D1|b z_u~%tA2O^|NhD-8d=#Wo>K~t#Zgk^Ql#SI~a(bpvTIiMx^r4zS_Mr?DH<=R^9l4tK zqk{!0*YPXb$BozXQ#k-g2-1#oc7$W`hnr60&*l0`2lNFLX6LEDt@Mk*>Q9COQJpeJ zpV4VP2Tn@_H42}SSIoCuXdqmO?95W)Z|^FhuWdSm?53*J`WdALr8A5~b9s=AMf&IFIw)e`S<;)ni~abR(^eXAF!$wvqry>>ei#~2l`V$ z^Qt(i(4yRyatTMMEZLOKr#bM?uHv(jC9kI21~Pe-Sm)80`Yx+@jDk|)Y9bIMBpJ$H zGwt~NJV4=&Do)v!Jv1_3V}Z@H&3W_N${}6FbUwALa8&H*)Z0DxTxC}d6ndb-#=f19 zTI|9w+sSS-{)JcC-p;61P%38YXRjVC!qa)FZFkJGx(WDe2CT^{!mI`l?%CO)-&daZwS{_7{NE+S>N|!qprDZXP@qy!p4~OK%Vy!Aouk^qGA{Y> zkjlGmjBsRVsrBjz3z7&l|6I`_-X%tjOY>P@8h>SPBQ1+0g{w$^d9D^99!iLDBKXW( zdCBDCwCz3eBV^3~?#W!;Dur!JJuqQ#?)q|6Ct|n(*pL>!b#m+{qhQF`zQVEQD>PTp zqnfuVCRuo~T5WMSy+hp{x0wA^_YtvV*bA#1MDD4C`>I^1iOBhEQ<^89+ma+7(%@l5$SeUzTd&0W6n^(PB?= z+gf3!KyZC562)ehF%8`(99ButhUTlP`sQn#2%3E1g2oJMIRa@v;?>(pUc&o@c=0(%^EM7tgR7@?_b>_5uT!DBr5>MlB@{76E3haAAIuA<)^OPY5H+2Jy?#wLkzpOoIv*~|Yp z(nQzKNd0O*X%5XqG98XqOEyY_7;-s7%8XMgjd%Jr(v0I~WD{MIcQmCdoVj{4&r1PX z#?;v}uY-U^VXGBQM1oq}sED-HchsIC2*E^XZkTimqfFjTPU?dxN{YTm_3dzv8Nm+0 zDVgajt?qP4MNV{ah1QZ+iSK!T6UQ(W2b$D^7+v|RYDE^X=I2=cd$ zc_7eT!EJrr)}uYK)S<17n;QYy@u_;5i{&nws??wcZvUe2E%4-eVKH$w*{w(~)Pa<5 zybY9(%Q}aaqnWIvJWnyb&isOk?sSUFd2*hnyGS9pSQx&=WNR)>rO1 zb%a6=$~k9fG1)I_aBV0`%ft&LAYFaTtDn=c+FCv=cs|m4O8f50w$p?`y>ZD_mR!^8 zHc-~|wO{y(ZX~d<@^z1*WCavx-7DN!ez5Dbhc+OZl{`1T9Y_wFZZ@q0FHynH2&Cxy z$s~ZZSf=>{<8Gp8v5ZrouwvZdXe37Yfzv;sQm}d;8M$r+Kxw;;?dJ^_Rhaq#GY2Ap zzb6Lsr*-;*nb+++ctZ@#bJ40JhAl zRXCnBe@Ix=Wq>7v4$4~vX`+9n6^!8IUzD3$esS>#jVXMKK7X~py>c5w95XYa=K|#u zo=~wHU{J^GNPh??hm2wzibvG4Gw$sOCp0les4%6qL0bhrQKg``Ne2852>>duUVgQL zB0e;OEf%}SMp?n#w_O=liSR8UCV!SDIaDNclW5N&*vBw+UFTYZuz#qRLuJU(!*1MX?j)=fpRA*Ha+UX zhZetIXeY0aKB?P%u4cBs!Znt&-@Vq^@RF6ayCG{XG-_g&6g)ewR<2&~!CkqY__2iBzH0vVbduu_uN>vvX7QXdwZ5J*HqV7u zR$RXZkZ|8f)7&cWt8&)I*mug(`vL^Ef2iRNG#%!S|4DY(4q@uk;2j-^hUb5H5?KfM z*{72D4byJ*p{!``t(a?1-~uIt<;?{l4lZIHpAC*xh25~=jcj~nWCrCwK+Sc_UBYHT_4cq4!K8?$s$!k{GpS&r=(W>Yh6Wr+GICeww_By zoqb(CvU)K0gA?|E#yi_UYk@+UscF`Cb&}sjz8Y9y|D6 zpSM!p=j7ImUf*Cm@nN~4oOfI>s#TR~^2oexKV!{s( z3w9arsqu&^iUc27sIP0z!E#9Q7J?lx7dITCa;bWx&7j?bEd<%`@==il`fi-*rq0$4 z>E1pp=Pc$bSm}^HC^ZTU?xk>M9EUT$uS_j!P;|b1@&0IE=+Z+iO00o6_kiPri&yAi zs2>pFX|TJ`oiLv0S_Q^5Y8>788#$u2&PQqFbVWJw@z<~Upk}+fNdm{Taea{RQTd-P z70v8;o-8RL7@kUav2s;{FOqY1fIV4|VTH>=uqRvtxt1mcxDAtAj{ke2*_RI*UkmJJdSU?+6gU7)P?J2(w zd8xp}gstCUs2a@uc}`!*b4M+2P5z$!`IYp{a7oeZmtlgWOKoBdZQO4=q!-Z-+~UK+ zkYC4Sw!5h~Q!7J3lOI4}+^*w!)*5FsmKgue%Er$%OY#E1zFHmC355HreA@Z+jO^{E zak5VoJwQp5csF3G&m`U(4Y1jE`7oqrLH7uVUon~=xouIA-hm4r6;MlzuI|4#sxg)H z+0G9`V4a&sc^A!`+@l2gWKH)i+;ogMA6&!o4=)I&ccHmi~gN|8_h{crm30VXsO&K=X z)3ym1Ab4RUXsW%0 z@5MlcB4^|wS+nvpWMMBIutll_d$_Vfe=w-P0=Jo5UTX4K-Z7JSiTP57p3O@i(Bq6X zM4rm%ze0ToxPAjTOPm!GV#>lHRf5D^=eb!}<)%Ia+eB}h-^q6*)^oaCmvTXpRro(( zUi6b#9={^KmG}>E^<~HXg;A67=c@S2lFUCx!Y}5VTxpi~46RtROnpQ~(Y&Th92}iQ z23VAkhs3EP;amcgUQb;|FW1?)e6Y8w#&yCci*DyHND@jsM1~HVA<^GdBh!pKSYE?Y zQogvC3X8=w6S;FZIOVkh$~t}K)_tCj=zy>n$2&I!wleFNr-{R%ZaQVVPT5Re?B-&q z@`F;1v{yPCo$!D~ii|$s%E^dIGrJ>Rxaea5h!&{tDj zT`{r}&6cCI^q3cjAThIk?UHnhO!54ZsdJ*quv%gi<3FQ;cfsV9REQ>iDTl4tU;_<) zM*ECw+nW#egp|KE;nSXthU>E)OC*q@L=R1yQcQPrxZagHDM)1#1Lv@D9ifjCA6ASr zxfIst?54Cn@T=45oIW}geN*!At_K^h$BEHD@zV{q0+JIx z5^HM{GPax*hEyj4Q%B>q|8(|xEO=9WsA7@S%N;^nQ@Yw9rXQ@U<>vQUmUYP501`aB z#1~(K_TqS4#+b<6c2EVebTTB{` zs~xdE!!5J&-ico0v-wpZIH+4wIz!*&sUg6N<^4&gS>J}KUoP;*6_MDp@^EH%*TP}x z+-H%5Uk&YQ}Nx(VG(wlG@QCy@*ABrn-ePWK?|2uThcgGRK^-prNfVmq+C^UV&o zuR%_NHGfZEE5)sKFZQx-w_usONXyEUiKGt}iq>SGDZ#{8?YT6EyY(l2PIy8a@J12_ zSv@i{G1hyZg-tAD+s5PB8+IcLt@Xp|lebFl+n;bn;5VA>s4EPd82oXeX_I4_Kh`%} zGNJqK@~A_Z0!JT2lU(iNd{cL+VACE`*nbjp=kxDr52PPvI5;~`51(~LtFtDg~;&XW33t&eYx>fBi8w5M$pMzShrC2cz*kvi^e85%J;8apAdPoXrw!4r+lD z3<{0?1-}?=bZD=mm(+D@lrZ_9h&`Ve`d6DIEEJ-SYeG8+lQJ*smBi+i~F7`*o3#Bx&PwCu9d z0({s4uK!7(Tu3&UjdT}1e3$&>HTvUCr~Tld8JoHfTag!y3u^lTgvbjWe%D3YG>Oh> zN+HOWYlYT$9P|CzLcS|fVksjnoI&gBj)Gq@2m88iqzdX^zb0p~4Q1*63)g3|PSYc6 zxDp+&=o&#loqi6V3m9$JEgRdj!q9Sdk8p)CXKd?R-AzgH>o<-YGfvQ^#o9(WKpbJR z)3w8~)KLfl_ViqQ^8l6@|CLz>0wKX&CxPb-nGFXqDg6zBENnsIlJ`d;l4Z@lT^q## zz%qykmr7~3FNnAH9!{4%-u;_6iKkG-qr|`PITsnpgbGP_*Kkia=QIF2C>6nZl~~VK zsMgQQJ@@>!fw=sIRP$9Y8b=yt#HZujh+bd<{$RE7!COr=u9lRnN7VaHt;dbyjR8eG zP0|3&82UvY7*#(Klu{IGuTOzOshzs3ju-XxuRG+Pzh{#JRoI@byUGHkdDWUtjxBt` z?4Q%r79k2-JO^x(#v@b`-(V&Z9VzRQZJckUSM+uBn!%)F7-JDGxqY&Y9k38LmQ74w zkZ=*CA~(m|!C&^Oi%JXzvIvR^W+@i!8*CbcnW~5HPmoki){P+R*CqGo9*h{SaRrUO zx}REfrPQb7le}?e%{(LMV!n#|eJVtZip`p8EXv)6$HiiX?Tl_qbFz%zxHH*fwShL- zEzA*g$HewpUi(__ z0tY<6BB-sleA^`N5;k?gToOtd{`2X4{0zxJ==ZpSX?q{wP%HbridzoJf8xUwtGwv#sdx+Jc@fjL~}VYaYd~=iHB|S!Orq z0dfgAR-x5A+Z^#U5k)jVtNt>o6Hx1^E{d{mZa;^8+QY|oaez4Q!qxk}%Rn1B?0m0D zesWeJV)Smcb-Q(2g(R?C{S}mOIUm1f} z$scTr#G>wZd8@gBuz?s{v%kd2tLLZh84Zl1@Y^aC!C#HA@;YPwq);i2?@=8EKbQc&J>}3u$*)6fJsySQ4G|RGF=UaPr>_PQ|LQ;Ho|gn2xp5^l&mTb&70c6qqk zn)oX5rJGS13h?AlPrAX4e9_2sgmuD*8KUafsxY7*zO6R|Zs69`sYyIUloiH!gK3s= z6ZQW>cCVl9t`Qj(cOAHMGwN4isK&dH#W}{3TE8{=gC)n05AREOF0$ zlnlAo1@Aws%4G zYG(J%Ik&j~E<6?4R9)?VPY?iu5WRwJmxICtleB^bYHmDfiS|`;*3uQR$zgK$?67Yd zRWz=1qOv)=JBl#9Lb@OuOaS(D>`)t7}K z*Q+&>-=s?&73)VM6xf1&d>oWZ!9p1i{5acWRH@8%A=S4go@%R}_k*UbTa&$47)4lO z)*-Yg%8yKFg&Cr1EousRH6B zLHp?ZD&v959-!Dil?}@>3YBPG7(7mf!R6U8rhBB$%kE)ZyypKFQ5oX-UT<~f#*I&eJ z@o>IyX8A=*x*Z(QnlbFMgYeZf|8;27vyYZ7TtN5lJt1pLYWJ zF&a~u(~PUOI#O10Be|uIWiM!V+`dAGEd7~`kO#Ife4@V5_Pr$T8^r*@ zcRpJIAXfqaORCBavm2||cXaE^J;dl>*>m`GV1N{`zLX~3&y+~S2eM$A_?rN1>-H8pq*ar0P37T-4v*Q3ISIKUw{C4!Js2Z!NL0ny zAw=}TSemN0QQGrB!A+c^wY_5@$ETMXf!qdD&2m)@`ufX76Ihf1+T+R*TrVJvm4kBH zb=C5))CiCi3$3RG;is0nFTRS6b5zf*HOpt#J@T;+ZM95~)=Yf>^27{#yK#qq8h}Xb z&)~GOnJKb;-_5>HheL#_k(R-OJ&H7DO+}j;i^oyw`r6$!ZH<{mkcnISw0eYP0`@|M zX1nQJ!(fLxX0~aC)$Y6#XJFJM+tbTBtB;CsYW&XZ&fK;lCQ*GOfq~^w+{yJ*eQL$ZZ zR;+(-+3?2dxW!FN*4MD9=Lba=8~7xCn8+;njc%^{lnl!O#on?^R*1~Be@ zjZewdX2YEK`(}yB!u6xDv8nG7h*2Fvv->^J0w{ICyI}zMs2Dh(NB8dEczF43(-l*} zRT%}q?u3f&vdW?%lj3gPRH(37DD7v0&8n511n|bpJD0o>Nb28h=HHZmKpSZ`|MnX zk#H~&A6z7~!M0lVN?R9n=M%B7s!s_?MjX~8;*92#4F&_1WG;h30g}L!spc>8DuNan zncNESvG?#F=Ra#nWVv4m`P{(!4rbTCZ_p|NH+V~-;oI-NqKyXhUFVAsTDN!|${uz` zgEQgVqlp*mws$JZ^%qt0=6VE!ajn`-2@^EvzmVBGFZ}YBE)gD(N|D$ZdXg!tQ#hc zkGIvz9>4#sZa3lD0z|caxxcK#g+s5@d)$!tO?XtOJS%=7kJSA8;+q(gr#1qTVR|^3 z``?i?QTTSJ+mY^%k){m25+Ah}chD%Vg|LTKA%6sqcu&544%g64W7ZIU5 z2u--U^ds4gWC_KXqbH+*5_o8^%&DY=aM7A`HA5t$c#BCTBAaEE0LMToG$BNUr0PpkrR zyY~UtHHCb~9Z%zKGXt&V3grq2oidd)rJFya@$jgMWTA{pC;)!}NAqZf`1R#Q_h8@D zIwZ}>8VzfCIJxujI8=?;L6_(yewp<{8!cQ{EOekY9?zkS0vv_LkJ z&jVM-de8AWUw@B&Ng=3f)3!}!r4hNd`W7QxTsN`y-c*x#TDu8%!q`M-zt5lZVgpQ0 z0V27_Diyv#P4`}FxC4}jJ@timYb@wu2OL{6TfD_V6&`zgL4E7HC_Z})T)}0)9i^_w z$*5<*04LrxX86FDEMdQN={{;o^|dPPKOJ!+S2|PldhY#Tm}gA3bCE=+4o8O36}zesh7d0>Z$5U7r3-Z)JWh*t_fto}36Ec8SyjZ{~g zbt#ZrG2H;16-GIf$ef~?iZN>gSC=S1&69B`dcLZ&p(75#{7x%z8l2G+i}kiz z(gSo;kMQD0!z6Q&-n%W?l1LbSe>fQZ@*X2LGjiXy_eAJ~q~?EEt5&PpnJTeORMSD^ zNEjhB$w7amV<@4uIVCSM4FgPFxC|4;pwxuCX0Fv0>5ltM(CL>~oEJn>rD94C&L=BX zV({Bg_oaO_=j#^-3)7l#QRGlbj34hbVKP7vkRHZ}biy@XTiS^XdMVR*Ele=fzxYF- zLiq2Ak_=nf5e713Jue<9sQs~vhxzznVG*~0S1Vd1CVSm7^;n{~LoxGS9f-51e7T|@ znkpp~w}%f(nP6Mxc^BN&@5+Cf=iW5Mw)s}@T9DaW2cgsl?K)7mOr!0a;mX%xIct&s z&ZHFPSaw}e zIq>N&y5r2bvdBJlS%R|AKs9J+IRiv2dIKK774)opMl2t$CuJJyn_*Atn4N;}o$WL(`64VThx{_GGY(dQDkm zO|{9%&(GR*3uo2cO59+xb#PT3VN6~s*R;6`RqM6#H)hvdYnpGxj-=>ccjsfHf*tIcUWZFg z{|Bf=!#tn906^1v)-AHqBf2+0wau=}xbpsLeO)E2q0k7!VX6M$g`K4k0Kb(iOtc_? z=5kQ({`7@p$go?42|jC#-pyu zCP%$Hskqa<@8U!aheE0?^hppvffu4nlEdv;hKToGeb78<0r9uvnXHi!|e+{ucfpfcLk}12(kqGh0it zTgsOxmmu-)jo9l#~kJtEBaX3Iv{SL_~& zzHO=cfx2L_BUP||P^)`|niZxh=O&D*n}L>-3|5>kRTpS;TpgzHtlK+0j0&2*rwOlU zh--lh42JZCFm_BdAYog_ax?a|Ic-kv?r)6enkO2b1|?|#Ex-1BP#AjRlV5N(a{A_X z1Kl#DdjY;PLfjYtiE|=QFX`21 z1?t*J((QV0d`k(-iDF$HAmp&d&EjeOda|nxJ-)O;6#p+&7k*B)P?dp=zyYC{oha@5i9Et29n+Z z0L$Og>Z!P=qwRyvfn~ZbZGDL{e%>)Jl$xIkw2vTdUu8t39iowGT!-j)>Qx;*YC2 zd^1@bIY!s*RoqIno;)ZWsw{5gd`L~$b_}&vcq#>;=7_*kCw98nG41Dfb~Jr`rcUcE zRBL#UyJi=dUX8;OXHk0R6nYILrwSu3hKu=&goACISWwK*f<{4czpS2PYs?IWfVR4n z)hv_hD;DHI0G6)F<+;#u`-)$h^M8UzUZMq$1kauN<8G>^X`!#vCuod#Q1 zq^3(OL+yp)EEtfIQ%zT6)9aw+LTJl3pBgV?1DGx^ejTlTc=^@H!F*w8Q3UdE*nQz* zCxK-#ch_N>^;{n!AaY9M`zv>i0I75t;j!|?Rp<J)YbnatR6mUJ8uLYm}&9wl^ey z08~zZEdXLys3OFi=!^+rr-yeX-G47dP0rA-e0aaVZNCyvDk~7_l-`t|LTdbBr@law zLy*Fu(=z&D(8vp&BA?#5wAkLba)+%7a{0`FWPP}a7H?bp^Lk~gnJnX5xMp2`bRGBz ztH&AFv{P`q39!UxFv9GqGWUoasyNYU3?&!{iI_W0$*Zbbchq0Y#9fzX2`Brwy~oa= zAOM`9(5ZCciRJsVJfAX*`%J?{03NESI_6bqW>~E&0nh13ZKnAQwY6GAAi(u7kH=|R z&H9Gj!5#X-*t|tGN$I(YG!15*5f(L+y#&{qc||ocn-#`qU{0#cy{`T^N`wslYPM?~ zUx@!9Jz|7duDs1l*94hNb@Vhx@*nKl%09XpMx578|FpdtJ$7DY@}lHO#araV`po6P z45FZ0tbk|d#M1e#*4jsRr>M=zmvLWNmFIK&XF6jn7dnYw{{wh_o7poL^l6bR?}gVt zCTJ#K)0vhfQzC8GuRhTd^9B@=#@fm^C$($zPinN{u(||w>wZLIfO+4q zKVAO;8p4uJMM7BH8VS1=1{};U>P{NkMQ+Rd_?Q|s@4!q?esIUSLg)L*_&f}aMz2jU z1I3sv3}Mqj%hhr*!uKolP@f~+l?VR=@N-3;92*no4G6a{>{I?0T+_T^GH4&(eMwx5dm5SGD1$aP%5f$M?qr8)yh&B*4WFiiK@Qd`sep*{f#-@Zm<7i$PAIB{zlv9P1B9!%kSe45B+(o zNN%QTQ7$EB;aB0@zPUfmal2Oux9TYe&pSBYtIgS^f6_RD+2;RBxFsq-;XtB(KTJ;J zP+GQs@Mz(~g4*O?_!6nUBs_F+WAdS${}SdMTvh$(sK0!&q&&~D(Y#0S&eg{Ee8!uwk#Y-4SP~cOTI+#0RHt++6F_{xw@P35ToFKqj%XqsFzHz(#Arby@d-bD?>9r zAQpa2_x`)_H~Tc|$EbZCDO#j?kdNF)k^7R;mq6sl!4EdkKd;A~>P5Dw{!YryDJ^@H z_;0KBUe20f&GViQkg03cTHbPxP~1e(c|B;C*7x;MNcAM@lDB$6BHeT?MsbtCqKY2W z@P=8#1#)Ixf$|^=wdHnHlFbi2+s%*U8wrchpR1`Fc^{IzOMONXFPFK1m9*EiH+=US zsTaHZ9`VMEuOB~;VC?NIlH`-#O_z~^G>11%_E6Vu|qU)e{8rf2P%ZS!3@>+23v74ZsiRb~z>&q&kud1#$_ z{S0NsWUfKo81E*U{bfe!9ZUBDfv2_8#XenI^!*!$g*vAzbKQO28k8Mj;T8a!Di)eC z-R##@w3EEl3PsDkk~f;?(S-ZV9mkei<9`rd)cPCUpK3|9lLp-|{>Z2pG$xaYGI(6= zHCr~M^w|xM`Xx+sZxw=KtfMkwddrvD!xU+R`Jd>UugxNVD6}mX;80>%{w?XDMN2V& zz@C{;0_FCzk5eoR!JP(sy{|=0FaHxmlue>Z^Xqg4HZn$RL;4$u2H$|HDA#aJpe#m z=hWvfrQoxnYh~nWL#-4%gA%5aXL2a^FLq^Tb@-U2*VjSnGL>#08! zshcTaqKq!%>9I;-eSNww$mrE z;gECYPOi!<4yhRe84s8b6I}Q``AAXjI5=DY8n>7IJI&a+FDM~l6TN-!GC+Q^du~pu zPzC%+Cc7Vyk(FTbsgbueGlJ<~v$B3BrpKSEmEEH`(r46M;cN&J`t4SNkbz%SH@f&R z? zb!KQXw0YWPLJYheiXgIfEhzx#uv%T2E4=x({~`{Bwyi5u+hGY4XToX#UHzTod4JMv zMX3Ni9+TgbzhGXj=EC74a4jVPQl-M;s|~mgY<{RHGZMNdt^Uo$0iFZyso87eAWyGb zHk_QxPN#(k>mv?`?2Pe1rSEaG3zcjvPDDY;+RG*CYo_hZAQypibK1gBck?P9ZuIJ= z5^=`d81sSrZEQ`TqJZArvs+o>~+`5C1x%BS3dIIK8NKSAjUi+ttr~Z@(hCr8D}^Wd<&M$PS+E)?>hD#J>;rS&Ic`YW<>0s{7C^ z{O6K1li?mA^}Uu($y1+upSai^LZ~cFvfF^iuO-9os9A4UlMGQO$>vg6bW)Rei-(aV zNeTIT+V7gi2{FLFDT#v!s3MZ0T;DlsDF_HGiH6g`Z~Pf+7$1E}f>Jep+v=2cy)J@x zNxq5Pa)esPcrHBk?+KK>9+bDXRfMuCH1vxOuZl)6->0;&X>fl$Gr&##eEMy-#W|>r z^Nh3lZ`mbJqC&4&{SpfJMa*5e&@yJWP$rpHJM|iBlrdeSgy6fhJDiRrk?|e6+GdCK$aI%j4h=m@5 zJspE!{RHjxxRj@5nSo*MKjYR9tBxGI7ED}a!GG6z& z1hPs2k?W@CW3w-DYpwmZy`}l=1ukV=yQcDXfLxboc84nw7N>opNUpE38n`8OwnN=% zCxgFu+g^Gyq@al9Ze9Sn2j8}Csdr8g{txg(2s~jAeX9%zR=OUlbx2-6&(;)RWwy{J zB~+6$vi9x)YzO8gndO|(h(?r#s`Ax8<9LK?cj@}+@YC4SioAMaBn!`p-&09CCsOhZ zIqE}c{(!=|VEw!LiROiUr>X9)S}p?yi`@sm(IKn-*SShM@S(#-M};dyNoI9JNlMgI z^iYqt#muO-jQ`A|DSgjkw8YFjOJo4O1oP5NV`XILNxB+(<$nXuKrp}AbGR zip9M=Hy|h+gWnzN86#*joWI6ND$2RQZs#@4UqTu;LUIpd>s>~qRnhQy3y{RuH+oh^ z-Ha2DyVAMZI@GLknu_g0q@CY*ZR85%wTM9{AP{&J*XmKr<`qyAExU0&vC_GnRT+?w zioE*wtR)_%(PtT`ZVneDw{R;C;IWXLZDZrEiCU~mUO1xnLmo~&fAxUNP)IM1ax z;aK2&yzU3n+L#kOkDKYLOj?~C_JOTjZk{*H0s-hv zVA8 zted%rX4r5s)OywH(5h6AloQl*SyQR<&ryTUJ5=)~3ME^KvM>S9eD$hs+qSP5&wpBc zrI_-2bCFcq<8KE5dit7%%@Jg>Y|q{&j2}@$zsZJRF^piLaGvF`3m)FUSBLye_sTlcHz0XRy@R#;=xVqEY z>s;|0+Pr`XZQ3C2NBhT)eXCdDFM_Nzy-q7lItPx{A?A6qIca2b*Bz_q%{M_?Yh&{H zPQyN9V3GOOkat=GcR4%l9^1iw7+pV3vQ{?e2)wwBc8+`3ka(u%{{UFqDyrYJ4B$(E zG3j2X<4H8TD``%ntG1~lxnHvxcCJ9+5IX%U=8uT_q;OAdaMzl2Z7JHZ!7kQO@6V+~ zrrRf$`EA+EJzOoidBj3D;|H2_g)%l zZFD_8(-JNOx{4W?;Bs?ZPMzWF-yU2|aVD$%oFtUU(XFtKGRLV6*AXC^*v4k!_2w5jSwC&(2Uc3L*S2wKO8kr?GFb_C62cj&vR*LE}Uah3ImeQ`}nI!ph>?_6oH+(MAd`D?>t?0K=-WXtU zi1=q1=-#~dtNN$I&kyML5?X7T-jAVbakkadh3B0zj@idU?M$-pz4n@t%x;?h08gGm z1gJ0o9R@y?DY$8SvRl8rm5+k2ZQd)FNteoCa8M7reJO@9!iUHmtL)zv{>ZWT&h7Ob zBK{a9oA1C*2t9L*dRNcC5Pk^iz5|j-&IMwz-k(QN_YZMV?~OkeTQ~ zHAZwKb;02J)|`E`85x!L=-0;j&1rt46|(NIkJq$Em++$2|xKjP^CRXu!r5&f(jfV!5kXys{4N z2*Dj|TGn9b3aBm*T1{!GEa>gz$m_HYm^GnqH(j7_>OBo}@Z1nVY%YJh(zGqES9k%( z)bt{eHZ4HC;SL5{nRIpYGU zn}N6m9Q7FKRVI`$IN*25{#8|^*nsai1Fu?7W3H3d=8?Dvcv3T*~$&x(16OM47X2eyBuJR%bnh=YP?{U85usp zuf#F9a>RO8O^ewwdtK+|18C0~6{7@xUm%_b89i#OF?^+t2qPa#yA*tnEN=jFxYm1< zWRCr2h`LDA zNmuVWp1=@!C)S?twie@%P6+g>5H{_^gS5Ba>Cd%2e%i>s4h@&!gKpMcndhgyHq+3-D+&lX3xIv8Rg~d+gV!DDL_{&lI3)3f z;<;wiI%87AZkYS0X~r^5NQg@1PS*Z@wDpA>7%b#;z~ZKgAfTuOu{?iOfW=f& zyEt5eGsqx{vuxzQQc!dR^HFr+LD=fHDq9$v71i%XdFH9SWLoA2;sQlbVc1 z0op<1H7XkDWd+Xr?t^9*6DrV#QX zQhf=siwZa1Dsz@Upr~2=;DvbWij4_7LlA*_FQKIK0l*B+lZ>#%cg1u$8s^lBe1OVO zWqanRNEaJ<40@WmaHDol7#YAdLgn`cBjo_#kZYkL97@j29Y@N3W6AH2N<${%4mN}O zQ)C0?Cm=I&8s_aUMxM6xVE3)z3Pmu5~t2h1v@TVo%Dw{>h33CnR)a+Ep~G1%NMY>}F$IaWJ}027MIxP&Tg+Kqve&m-yWSEZABH?cSdvt@M(K;=gO zXQgK;8>loRU@JGtoe~;2L!Mu7=G0)<@sc04anmySob=H#btI33CJCVbIIRhRJt&n zk+cFbqjpF5)_v{5N55+oKA5W4x}!%CDa&WE;;?lMV631iTmX2_Q(0f3(-!P$OQ;24 zTRTTjbL&+`pbKDSn4Sr)eqB*X+&)$u_2V@JdZRRh<{*z=_0vrmP2BISue_iR^&k!h zTI#fm#&rq^5_;E~={k=iYjd7>uER>W7y+LQMoILp$h+=yOUU$FE3{3Z?TnBJZne=^ zUlu6k$j8fodi&P}VL2}wBLk6-t#r0mA=f(KOq8xI7xg)LZ2UFvkRzKj)=yU1Yf= zV*@zvSQo0Qn8^#%cS0)}XlRaaQE?z*asg5T0K_QS8?+22sk;e zb5dkd6J}dE2e}@#gLY?PXFaOKl14&hlr95jlU&vOOk+lkv$G?f)zn=D4S)&*k%8ao zSXYq%nG961=tmf=S~ZEr>Jb@{fF#CFO4mPgX^q@%9WZOQx`9)6NXu{t?N~a6m@?tM zY;p?YZ3lZ4k3%CQFrl&~` z{{SowF_5(AqXBYG`0G1~>=OZ;{Ad2X$69XLo0EH?e1|*UR?mJQl z$Qv7idEJhlly9(_u_8#S+zvrF$?5M_Vci}_1bg~=)CNB-;|B}~9QvAkUpbR3!GR+u zj-9IcpF=ja)Y4m}G4ILT4o==qDmktJcMG|PKpXj*t(J`K`r`gJJpdhv z6>d?x7{hvTRc8l+$AQ|dK4M%-@-ZBO3j2zQt_Cxaoc>hVh{FNfoK;7Cq$wFaOhun!)v?IV1!1g%w^CaD1p@kE@>Kp2E350eE^1M^uF`IEkbSCdJDr z&u>#-dHf#m)E*1ebZB(jUAo=h?<0gLCf*WwEPE5z7113P+2mrT*Se2b_$%;jwBNH^ zYQU?+s@_x)?ZNMsHSc#mAGfrV&$YF*M;Kq;e4r?)Kcr5l8b3?7GsQ&$m%mna^?7SJoObHi1h7b+{-G(XR2Dp&&gPina6%V zO7VXZ{6fFIzPQq?Og6$dDLm2@cU8||GmO`r-haZ!vb|Mr54E&vqA_uEID|UqfE9VJ z_rjhQ9vZfP5qPz<{SMCDw8GsSAefHipPkKNCA*ReP-g;#1$bP z>5E)R>E*}Y@D)qNpBr_H%Q@21M}03&Sej3_>ocvpPCIN)xczI+b?=E#>Q8&(Z7WK% zBHVeg>bl8qEk{5j-TDO;JIii?Jg>KI)E$DtXmaZib0+ zp`If6uj2mzi8{@$k>R^_o*^Mu7Mb$n&sTXmpU$N52ZAiTHDNNx9j2kHMIQUx>6n<~ z80I*}d2IJJ?iN=*2=LaM2ZB5+d#6~$ZQA2i)LuZZ0uD}Fu*Q1V%D)#sX`c-0H=3S_ z;Egz4X%-C84OV5!+_~VDUagb-Myi~t$4Kf!jQ5dGPma%4yl1$(^KIY?BZ?9i&2~Fg z7rExWX2u^6*k4}hclzC)l^&S^ZBl5P%rJ4EDLWYm5W+b1+l;>nrVxFhJ>VFd+Z7{!v zbVbp8GYb_umFfn%x;g950Aiqv#~v!Scy%bXd+YcR{{Y9dY`bxe0a4Ib1E+jwwecLb z_V=v>Rw$T3Dt_#Lz-!d}F>QM#h`#W;=~rd2l3SvW-kfI`>(a7SVJCK9BiS9VfW9+b z>-Scc8up!N*79+(ctbN}A~yI@~)pq)DMUJO{`yNI?TGBld8L1G`B!* zJGz6Op4F7=I5v~}%T&3yM<4Oiz|!4WL91+qZ*=k&<6s-63_eyT6-&Y1AiA}+x3-y{ zNKeeDPYcI-($+4oC$PRtnTvV3U!AfFgTVYNjFwxgO+CXDLI>U+mCZa)Gg=)H!!;Lk z*}N&^sI9dXjpN$R`Q8`+7rs4z8ub4Fh~EUX&xk$+o>}yym4caKyNXOW$o8*`F173H z8`x!vRGF4AilunQa%<@CfnOYFghywpN>GkVkU{`^W74}JUy&(pjv3PLq4AH#?}1ld z1Zi$!o++6KRanUxAB}ia(~dw~Wd6SO`pNN|;bpJHn+Y!Le5;r*AS&w$Zt|FOzuLbl zJa3~-;m;K6dR&Uz?WQ2J zk(#kvp<*7H&URKf73Q zJ8)FsbjB-A-f<=|k;i(LR_67q5`dGytth7Qn}hYNI2hmna0g#{(1KEOqy`^amwkck zZraMAboofeb5{~$xNRGO90S_1QNCO$12twdAV4#N`igrIxw5ya6vkAyuQ(MG-71zl zP5|gR6+p?iZ&GoBDkJg|%2*IOdeD}GxoTPPfpR(yqcuk2VkBU!tCC0^sU?)R%yXWg z`qe2Jfn{O{$Lm5&XeM?F0el~BYPpnxSbW6hlXAOtH~^2vtCu(dTb}r&(X@MyXDT+6 z*V3BO0N?_8bDCt2y9BT;+t#Yi!T8QW^sJh(-%6#diKLLA!6AXQ)1_yw=cuYDr((m#4?)dCg5(Thu1LFi+t;wF?3i7^VTU6%&fbSy zDGUgE44*+#jm*7pM{!9Q1QJ^q^c5s)#~2_D*gRG(+hftEM(Cax%$x$to@)KOj1@Tm zow@X?(E=kGAaT%Dm{C~#VboU~)8*GcV{{ZU>oE04H2d!wMAOV75x*tl!K0aJ-+T9kPEZ7eq`El8KJk=-=;QYkn)4fj_CpZU#*EQP%G=57g+E^OBqM?j z+;9a-W5bu)SRQjp3}HS}aNR+nzUF(e?1e~HJ4pi=rx^B(k+VEuy=lTi`N%l^YR8rs zFU%z*Zoxf1waZd=HiEfXBIE=+J;1A0;Xo!+^An8w(6JLT?F63S9xCinFefd`ACzLe zdXjC}^=QV*0jDSs8TW#^S2E`{QJx|iAF;ZmCe5+EtD(uR{ zfSm~LDs@32Di>)4@&{k7S%xjl3Xl~>7%=42$s1(gsTlO+S7d3l>~T(_waQXP=@4%iN0*-1P!MgRPouFPUMSuaq~8DTe@A&e{0nhL~cujArv<3 zXMieIwv?~jB^2;|v6|G1$jcX&ykSN?ewBP_tsH6s;1Se}kz0Eux8O5E7lF>+wMuIM#fVS8KcR30!C)~Yso7PUt;cWy|=c<6m= zI$hB&RYwQr2D(eTCutXW#~iZutc#e?vnvdYj-!%l?Qq)mGA3oqH{HkZ^~G1h2PK>3 z?m_9rUcG=sq?Q9L2OUjjG>l0|#xuw`$j5qDxs;X5V+FtjfJO;Zz^NU~Q4ze3eq4;z z7$t4PkWP6XwO}y{PScWl=clz~*K-{bCuy(|hynT^fAFhO-ZBvwd^qjv_|{>$&eBFk zazGtDs$`i;k^$i39ffjAD*BeC)f#O!BL$o0W$V`zeWA9TfxG*l{{UK~W!f;KC;;ou z1p;PvBml*_p4Bl-mh4>fi!kZNa!2y3R_~M!TaR;DuuHfR!u~xCT(?mBI&Q(h_pZ2l zoKto*;si693hm<<`c<1%JIO1MK3;k+y=O-IR1MkBRqvl#(Tgsnix%V#1~XmM(dX1@ z?rmFOl^NvlGsSM%$RcG5-*|OAS3PNll~kXYaJlbSZRZ>Y3ykBQYqc#8I&G(OuCurz zFu>y+WcRLy!gf&4oGW9te+uHPZpW3Av;`m^U&^;Euayf7ump0#hP1IAZgpvTR#Y5d zbsyHQ3)KK%tcR}L^{!eCLODo{%MuioAaVHA@mzwdleCYOu~{i{CLB0mgC<9Ou@tudi2W zkAgaT@H*5tce$06uwMMvKYwx#;H<1c`Mz#zE@N&+O?#-QUAb)MC*HZuLsekJVMqH} z>+MUZTnlv^9OHmb8LoQv^CyfBIi}boCGN2Q05}AW!1p!JU+Sc>W`0MZ&M9>Zpt#6x z`8ndTX5_XyW1jh_ie{S=$*L&?DJLzToBCC&E2AW&ILThkSPjgfwuUHhGuT$GjBJ5M z0U6F%R>`7VZ>id8b26fpJoV{ahLv)|80C&K4RHEUV9|n3Ta$rZhMKP$mcSU`5`Ok; zq7O?P(p^sbPH=`IN`QC)SRcl>t!4|j5xWiC*C${QELcH|^c)=5N2d_s7=8ZYx|3%- zk0l4e9DbB^ijT`F9sER$zPZ7|w8 zMsa|Dy^64^7ly!gIo;fv&9u2#*J~ZXSLJQQjGT^ZWum${^&NQrTdwBX zLC$;o*EfB11dO|e!pD=zHKTiV$jQsEHO^k$Fk(z+0CgRWX7@B&85)er-zu)ntO0Cw ztQ)yJ=2zSZ#sM91S~rrJ+_Cvaagr+@=0+s&HZUh~JrAXG%FUfI>}OrhNx>{xKo}iA z3dX%%yQE;Hm-xEY%~hjn`u$<}e~sQ~~SM{VOK%2g<=q zIX#aCweAm^kGl#mIbUB)R(0phz>YhE&6Ga~SzLC3ynHp_}uEJiqG3Q6^= zEeSt3JPZOG2lS|I!Ei?7)SsAks|rNG5^&^p9cd`L=sV~kU9HNNUVZ7y5O!9|BGb{*e3F$bKUqNl-p5%XYjxWM{Ul0tmK zPT)KH3U5=CA(V_9pVq4VNs44MNJ14O<{be!AXN*KzB7}!9;eo{_HB0DqF%qo#eT7lX@28QqSV6;YZ*N}b)&n{slBqi!+6 z&sN$#C*d& zy=fwWhDLLYagO!1q*)m+5CzNj$86SIspxAY(z)!P1bicH4fxburOX2H_rIPvM zYwL(0AS)26qxk_`ZOy04pyLSNQ_p@Re$hJQHw|?6-efR27PfH=uqXJ5JlB)z{{R+l z^*Q0y{6QqM0NGe4kdWTkC#TY*@wMdt0NOWkSxALgY?4G=jQ0vnd1kX?Hmj*bW|5_a z6#*6dpQU4HuT#Dho6#PNfAM3)zZEr`Jt?J@-%5>qrHv46f-m+*Ku@Wz-^ZU8FFZ4$ zLE&!(+&z*7K`O?e%QKI>@=59KUR|NZFNgH>v9#K^mpN%B=v8|PCb1UK{hHr0Pb(Li zeB_g!05tU3KVLHamE~(0J|fgLuMla^qCjLzNo3!7BqaH_j(@&-l^ro%UxhperhGNi zbnR2cU^G)nzS~VwH%b?teHY%ktvgt;_-)|1btx@upuYipxvx2CAF{?f``6AsFY!LN zawOzKh z>7FtN-Z-xwxVxWIx$|`y)tGU(4itI;*jAmFhi5;#2oyIs#xYkQ@I>Zaq!#C(6gj5u z+0wADYYx$@T4NpuR+2vjp@OAfy{#{vq*>%^> zcHG3Cqv>BjcvHZU$EHS(I*u0{5IE`STmB#LjkcMnnIM5e9B>7CcAW$f`A{{w6kakH z2M6A{r6k?@9kIcvBgS=a0ZVrYjV-txz~l0+17Gl~X#|-ecLlbBsb648rQ6%a9dI%` zR~_RY0@`?r$)i;A$R&=`$^2_MB-njk>Dc&#UC?EQPcjrNnE>xR<2CGm0VB~bH8hU? z{M)nOd1ZHCR38w$4EijgRak+R;AB`T5hnwT zS3@FiIKavE^sM`vZMi#nJ%wo()fhPTIr-NI2hywgd$Y$LwXHRvW*;cxsz{h5e+_Dz zW-VBtxELMjRd$bY+*Hn;@q?bUo>q}yK8t}`P*c9MEf^hi{OmIXL8#R+myYD@>$+5de&F z+Nnwg*HQ~{!Okk|*eprTe~T4bROf+}_3u^C6SFhfhTBu=JJesQ`b&uY6oYz9tA2N}gd zCQ0BEk;V;q9LrqSm1D=?vQ9x0k7a(xmhow3}Nkx@u*o8|``R!lO3 z{CPRRtw>y=p<&SEX12NJSiF;NPzmRu3ToUzPBN!rjF3;|SmZw)F?qXDd z{5R#5A`pGoP2`J5MK?W6q=zv;uRJRo>-@+QbZTkMO9^CmX-uCbqc^Us6?K zqzqwk#WWBYXP(E>p$;D}gVU!@lnL+y07rZ`PH9S3B}T>A6(r=Hr1P}Y$~WhLFnP~< zq>`v*8@B*CIq%-B23J)i;IBUQ#ZpbQZwMrd(8A8^kCl1oJJtJm_Ku{5_3KpaZUM_P z7s=x%2c=m{mB;{r>N=75*9@=CW4bbmj*Pt;?K^{Hp1(H~*`3gBURNVM$)-g!oQx3e zq;NY@?kvlZwZOo0QyAJ>oAX7)k|rY#0_Qz@0au}j%H4Mod-fGt0p~J+3Ml7j<29`c zM#HDi#&(<DN5hq0OfikL64rcYm}!>lSS_N*2Zm$t#LE z5z`u%Ryd2>Wp=>mGm<+F)z0cR+ZdC`Jbf#?y3?cB#|A$@MROXhuu+0`>^NNa0;QyD z&T;p#fGXNt7vOFf9F^!Rn~LxN6dWf}pIWsI(Gn_?xm$uWirNsi z$1LZ4j;`A0fJr2eewD8U%H}?PQ`)&pIhSrpUBLCtUxM&&;f_xuHQyAHIHb;)UNWO( zh8V)*u5(t!+Qf~AS7FlwzH6CV{{SQ`Lp*bzTA6P)g#hFej!sT%V~wYKou$5@X2IMJ zI+MrgSK_}-q=vyKBpmQ-i?!5407iF?I&`fFFM}1&ET?xSrM{)W?9%y)WpXlcgU)!X zk!mZGmctxmXRp31k+i-!0a$>2PfD`)!5NM-g~m^M=9I0u+ZY`?>RX5bnF#y9o&l;d z>Ms)&Y_olM#bAv~Dxe0!{{SkEOSURT<=O^tPb60q=8@S7ZJQEmhZx}Q=sl}C<5kRV z0)fv2@@pbXwlU<8a7jG&^s3TNjzg6Ps+#6?F84asHl5LKYo?KRDZpcl_32qRcVal* ziXFWRFH`jPsLaf=5{-o!;d&a(zL}URu_`mh59v{U#;P4zTK@5mR^84sSXVb?mGB7t zb64)z$;cQ0)=c}O$t}A)l@+3Qc4l0b)T41HnxGO``c*Wxb}fPrzo)fblMdZ6j(YW{ zMHwlA2^s1KTCQs#QPiTAq_OPY)umx*#fasPN_j-QWOk&*IQv3jx1$Dry!{4Yn{_A!2=}jJzG8Nrm#S82i+WG9&=rAXB6XPbed>V zs=jC$`LacH7GuehFgg*~S36)g!!OD?We1#&--UI>yBxBK(ppY1plt;9 z?^_mkDpX*yp4{U#%358k#v30mJeB7)rE7K+Dkvv!LOTlSO6Mewx+#oDkB~nZ9gR5M z><;Sa8F=^Ru;aW87Y@fgiS(z7;k%a@Zg6X%Y;xOO3zu^P83!MSdcwSwV-Lt}-0iCp z&E^8k`2!@9c>e(PRxS0|ExQV%Z*h~FhFVOcaOF=p13W0tO3S%#UA&UaD%HgKV4;h1 z*F8S9pC-UE#H4`Za6N09US~pX+7vDrxeXyW3)N5EHIaF8thp?B8(ScbYW?ixX2Y;- zak);t~qO|){+wezE$P1RrxAO3Nm=W$;C|UrDWJkDxTbCqAIFS&O4KiwGr!cRj7-! zp~2jv)ODm-h+(-|K{?BIsjZ>}p5I!PKuI__4c9-!Yee1jG_}^Gkbsaj&{;vr%}EN3 z;GLk1jidCYM!8INBer;}3lfm3eozNE>qj+#MX_VrEzto4_1edrRIBq$sw2V1Hv`(6 z2uS&00UzESL8+G@N3dge8|qWu#apQpm0bPp-93#k#0s_)bNoFjc_Z9L+=lDH;QP~L zO{%A$9Ag>AXiUz{vL%aZtZaMt;}uTvFnI$%(yx=qZ6+NPgfDNURCt$h2&8AQ^{lzl)aX>(Ga4)c z3Je~(?^UJ9V5IFQpsg1u7<{|?5!`)iKIM^DDo7)d-l`7L*iIHj3y`c^<@tv^cC4F{ zLon<)#cEu?85qguBl^}&+?+RJM+Ee)>SrwCWlfUVBQ-)oMn*dKJ*wrvATtBF4%zQi zr6qD(xUSgiq36mvkq??d&N0W~SFIQ393D8uQ%%mxfC(LOTJ~{%P3>D-K!RvnL1!r6|_EFj6)SabaBRO)BX_nQs-XPZQ9Zmx&emeCmiSXq^!`Zq^Y)j>F|@n zkoafAI&!9GxVeNFgARc5a%%Rl$6eQzqCs(Grj4=37~*S#-MyB%-vId5_WuA0aIO3&k?uTE(Vmes`SDwE07T zI%N8q<32L@n#M0LXu3Yp#Hu?H?kcJ%b6c&NU{^q~2bw>~cMr-qJ`b0xjN zj%)Ls$e12d`+>kd)#dtsg{ND{i{>!T`@-CiJ*(AVzqq>&ZZNXU<(#m|Irpr|Q_h_& zkm60*b|a_KyjfLUkE^AGaD~~->N+{OyOwl~VvR6^)UG)-Np&c+%bm{zY_alVZZdJj zc9X1D8fK@tNtICGp6Ae4pIz8$8pWKKDFVdKKIv?lBQAYWlquNrj~VKE$Bni5bqm%E z6zqZ_#BiwWqqcjRqiLgFDMPaW9^;Db?0gfd%8b%RtFf?mH$z*Hd^*-lNbx`}Gn|Ou zILB(~oa~jEy(&&xvj;%XZZeY?npe*ONayQaHm3}Bku2ib<8U(B9X}eIP0}@c3$3qV zENY|f?a$?1CaryF+FmY!iLf_EAjUIZeMzgHq$#Ui8QvY&?V;MPLasr<{+0D7!mHt_ zLk+xSs;~gGm^^l`mnQJ-h3%v>+sFaVN0-q3E8hMKU$VfV8*?r`_`&*DHAb{(?53Me zEgwcTy^fU^pK$*GFyN3gx~I`K7(7F%n|M*mrUA&u(w6-FyG6Ho+Aoj-*f=E8csfgK zJwYx!_>%yzQr)YeN-NOhnrbbjsp)a}NZebiV*?xt$<}-^EsSXRARZ1Ysn9j}@6-V_ zWkJ9KuIoExh;%F7y%$c6N_^2iayYz2D%`R@bNH9x(|2I!XDFnG{{R~CuLAv>Pw{2B zxcLgpg>l&CzO2@CsI_hJNVvv&b+0edeh@(xv2w1mOAE=lB*r$J@GF9nN?IG^?I@`q zLb4(7&)Ke|5~Q%(xVyrGnznqH_6wSD=ctN43Dn@_*p zIw9K|4o2Kp$v?Iqg_>^!>sNLz%@W7v9j7hVo-5iD=J1Clhd5$p*F>_jD#ngj%&R&9U1CtBvO-WoMRtO)lOJIS0EC4j%!h( z8-_4F$fzZVWP(5k__0ki4mRA!c(;ZG40{@*acr^Yzdijcb?vqxTyjTHDwLMY6y-_h z6{KX|rV?EYNh4KacK7K}NUN4Otx0Y2a8FJ#ROCRU=O9+;+{VQ+yySH6QpdZfAbL>X zXCM-KVw)J}9V+(`I!H@($gL}BHth}3t1UWr1RA?;#EcSsg#$M1=|D#~}Uztl0RChD{cqx2-J+9TGN&?0X+fd+Oy@4aBlwqN>{n6b}3Bx z=Q%j463d=W8HcB(UAR!7?a0RmjAPofXBccL!S$)Kxux0NO&6Bg8Dt!0sk~vy#sKYF zQbqvX$s8^ZYJkM7y@q`SeEWS*)zZGj1%Q$moPpM)5e8yaNF$yqV+r1I&rWIE843-g zu_P1PvgWzEvP3|X3Jx%TT6}I*js^hr=MGd+fR^v?imIo}KQ}r3DoCd>9FxHQFG}fKSsyiswe>E<%7bVG_UTvc!DQrT z)0|d(PI3-M)K!S?8*^c>7+?@Mts2uq%6c#*6Dr#8WLjp2RGm~8I_VYGcdK{&wA8NJZ@d63u7uz7^^m@suYFGk3q@xtI7!ZcCc-~ zbc%KkYZ((+4>7Vf`tey;_WLFZ+;8U|wbV(Cps+01IrOYs=#dx<61dJ!N}i?O<^|Lt zGr91)cYFOS67f~!GHv-l`B?S*YoWP>hEO?;k1PdZY6?S~XDz`erxaQ4Zx?2BH|iZY zTmn1sn&UOKNR^os5xbmMZG2Kq#zJtU^U}CoV1D(1Am_J1Qte|{$((Mmt>y5_InNz& zT+RDuE4vB?eznnRvI#ff{JPGoOIeT;25Va|J0hW96fkLz6IcVuK|gWT1a?l&GA zZaLAc1WIV4f%4hZYt2C;?C(0_{*;W%dCpIQ>LA<4ZBsOG~KQ}d1vdsWEp za#hJ0AB|u`bft5j$KI^Na?C~!-($vWM71+Ii+j=vw^8Yeyl;1|cal1E#tn0DTpR$$ z<~-H7?%R=^FRgBjcRDEb68Of_K;)i+o;4AZkGwjMPkO>jhFmE87<8%Bjy5*a+$DdRuPt%HMe7PJxM?iTM zA`={goMWX+cF=K&W+1s82iC3I{H!z3RScG57X? zHh@7S9OQJZ+X;^HM=W{_aa`53fl7jK2R`+&1?H4 z$-qt63-4NX*DRzy?Zgg;y>m9VJCv~`FvrS9e+tpJmuMg`$3E5985~lDj)E(#(EZ|= zI3b6BYQGiKh@wc?vkn*)z!lCV)(|%YuLKjEeQ9C6V&w1VfJv^nzUL(4bF58GP@qyl zAf5+WMb!Mylo9hD-Nkb!QZW`(Ja;Gg3S(-@FgF!Z(-qRJ_Bk3!oh#odk9v{^BWJy3 z-d|w`cqIMcd8~KUF_Rx0;FfL$Qf*O6ICdUjI3uyClD2}?>S)V&8+J0lV?L+ev#&1< zdvZqq0OG;p6_+lmv6evU820a3bLveZlaKz8uYrVu{ z9GcC0oU)zS9)_WL31U>Q%zEazWVyFDOxuoL17s3?IH}^fE6#SFx%Cx=9m53!Zh7OH zk*=CNg4n>%J#$>nHd-A~lG5g*T?ba`NjN#L)4 z83O^isggZ_C?T*2BON}KLNm8&@J9!cnz~3u!3P7A&mPoEO@yO;#A{_6Uy;smO#~7M zBoetf1E{5U5|S4xpnTl)rzB!EZPFDaagX7sl8fefAkOns%G4EAnCvMfqQOF?vb;l{W9nhwtX3rU8^Dzp%U~^PuQnELFzjq(j zwVgsUN%w{^$9l`Ujf!O85=KYAYLz8>Hg-mx*2Yc5j9Bmx0zp32n=|ZS2^l^6R;|ou z4l(m*9QLf6r3bDT9B0J&#K5iahzzvl7`b zPTU@PR^5bT62TpNYdVG0OOA;~ZTc@cimZqhgdjf;=6VsaMEMpFY z;~44%W9jj>6pRda#dNkY6St;){{Wp#-j_S+K{EBNx@|$(mpCJlTUM5=gyaC_KpMXQ z9DVQURBV7UDxvv^!994byBJ+d1|^6i1bSC1yE`eERq$#0QMfHx;-mdy3_QgxbqHLFsg)ef;lzHTI+WfdMZPBv6*Hup*Z+u>g!TzUQ*MvyO{m%+}C;Io9Q8+QFg$N7{~*6-Z2f9dpom-Vh;Z1!6S!@Dl(w_z}0O&4bh@w<@Owk==41m zq`8eFj5-sOyRYG1M5;#GA6*!`YGvv(&vpz^K*lFIES#Fk9tqdAC>6}hr`u)YnhG*1oaQfnHt%WZ7{+{@I+dn(tTYaTJb@ny1K+`$f!;pp6~K4`?VFVeNc)QU|r zlC38lR)?Buz8HqZ76|-RB$Jf|fl>h^{{Sy~lSI*VOD9oft-$KXfh46#KSFAbyW$TI zq|z0E6a$7}=W`F~S##@}9n@?s_d_ENK5XKOoULeSNw~gddW<*v-kB=3<(Ziff?6(e zJDk?7-OZnfbcxu-46)=4O1O3W>(2Zo}0PP2{f*I}1xfSmO8sc!F4rOMA+(sdhKtvOO>mE}MJ zhHvLx7l*8b_Xxwv3g;t{kUi_md^uwU+(K5BR>CzO9S~X?hg?eVA=RpJgmVM-8 zg^=VQYV@4B6_1>i6;h`&{7EftyxXS=ax;TnFNR=Ci>ZU6vVp({y>K>{E*P|ovB)`L zU6+J4A|?ZZ9P&kTQL3Xf-q#*sLHj3TOIooJTFQf+xyE~n`0w_h@f=B7qLOL*VRjZOru)rC`ga&V;l)ww;EB_O`-y!w&tPzzNE4mccS4%NRs zv^~f{Bw{>Uen6)tt2Lm(908sMZ?&En?gXjhIO$M5rsgAP3cLyww6Y&1%n1>biP1?_DM2 z2nG%}5OOOP;w1%#AP)Yu(H3(_E~Z@lFhB>f6$e5yoOY{nu10ax<2~xDC{_c|*2$S{ z>^)x}De2ayjDX9}T7?H*hNOvrZ18<5(+e8b?URGpb@i+E?VNFu@6xdmx*pljUbUrc z`*!olIj5*t*^W+I<|=yC=p`g>1Oj^>TEs~REtA)!Xxqp^9Wl@hRJ}-O+D6_3W3~<{ z{4#Je`1Gm~%m^otqp7PZ;EXBTk(|{feT5wIxESFU-@K^r#ApP9O3 zb52GikDH8R>+e-#KOxT^6@Fka4l~o~RAp1Q9AmF1ty`LA2k#6Hpw&6XUpYDb0H#q= zQW$^-$_M9FB~Y)m2Vc^!TsO_h5G91Wqps_bgO{NYdPaY;NITOn`&$n8^fjX8|t7|SWj=k=(W z4gmfTa5<}!LzCa|s0hbZAoVq^%qvM)fuzPkI3(cEA8FgOBOOWNqm(KfhRCRt;h2IL zb2Jhfu@4Rw{>cpO|Nkb5l-8 zV8yp*xTwT@6SM+*9w{cneTY_k0;B*z&myhEI3SXscHBGE3m)<^Gm+ChDn`lx0pqR( z4JV-0&3kDJ50q~tdg88$Jg|0Mm$*db(s{P%}216c(wzSssFw6=8*bcSn(uw5Mz0Rt^%!n{maB{$O zHMwCD9KK7T=NJGA=51U=5q5-9G6Cf0wQpI<#o~P6^&>q`(z@dwrz>Y)r>^~k9-{zy z*F$X*ov1!h!N47Bo73dl7nL|UAx{FjjXe2_^KC9b1g|82g<4iZ^fj#E*%s0PVoy$( zsoY~2Y>+#iY9x6gLC$@;jMUA73EQ;e<|K8gx?@PMa028KGI5M_HI1k!iE!kCTO*E! zweB#hxb8XSR~;)p=#@?eNnG>JD>m#}MjhZ1m-$3%o&g`{n&4`&P#GJpT?r*isvb;OSL3pjhM~{QCudvcPUf=D9KaYel^@`ueoxI zjE+F)Yl+q)Ra1l^`Q4MjslQffw#N;sjf}u&EHVZ<*B7cF2d)U@jC8KURQZ{J1QEf> zt~*d)^_z}yoDTG_*okU#+KZ5{jCJZO9pw4&dC2Cq^#H^8ai2=Un0aLLxxFhzW?TFFMsZ5&m&<|+W=81GimDVLI9a=9S;Q`TZh!RmUCN~)6j_o;K9 zgz<`xP`fTcE;jAwj1Wa#g@T1*103|M$mIZr$Qj^z)z}GMxa9CfG$xHpX*L2dI(Id4 z46^qbIT`I)_Tf%9ci@`83;B*WFl_PZ(vDzJF2>ur&Oq(!R$_~L?mPwVf2CH1c)-ev zxf<Y&vrEu{kUMLzrc9UdeXNnilZRo(Ek8B&xht-4npuit4ibzppI}xO>xS7 zPN-A4ryauyLu76o=QyeS&@;I2Zo|^Efg@`IJvijmoy_2s#{>XRaaUB}k@@q+g(XBQY)Q)|zh$s}}pAv4QDa^m>qX zTs8>KPB;|T)W9Dzag)Y+n(K==B@?8$ye_zoQMaxIQ+-4Cgpu;DGgyOBgt!MGPgc+L zsGCtLa4_Zac=YX>)k@nl7f$A++LG>*=FU&AK~(3|-N6O6_fwDOSu<)pkV2PVL)Nn{ zH6T7*u}?unrn(XA>}p)xz;&cv08X=Cf+Y zTx6M~mktW>3XXSwO22P(ag1Zps})B%86&9XtU*2r%N}|t?O3$VgwBc!gPexo4nQ@l zX5=7pdag2i*Ewf%k^wj%@y2Ub+UI^(U^qLEYR$H37~I#2U8})3Q^t8UZDu=%A1OHJ z`PO_g3Cw(|J8(z8)~zFMDx?F?KU&WAG)cY7TbnDKHr}VcX~Ef5n*n!@{i*}=6bFX- zaaI;FfI;AqipFob*$CZ|Our%_`>Y0iDyt(0akK?ff$566(3t_q;2ey9DvaZNd0qj- zWY;s5`ks_2c^UIYa#2pwM*cbxS=S5#u^1f*3VNE>o-#{dWkJFB6-Mv`!t5gefw!;H zi0F4lK1K!dyPm89o=;AHtz=!Dr(*)R?_0M}<+qcZ4WJQ_YZ~Wrl3N9RE20*N%?zprSkTsPCbq*sY#_{&y^K>v6k?MJPZNXJ?m!7F;S2do(UD50uTo$IrQSS z?H6dk8PC6J(MrZ{m5psVN6LpJcgK3^tfTWb5D8@fV2+;%f^T%(ccRvrwhgY^6caqDuaO?AQu38urL%SQ8ACsH_Yo_p|Y?`!f z5<1G*0|%+~u3ECSIY`wAqyPmK#(G2Ejb-Tsy0o(u6c z&x^I2=+Lv?$n7(%YmAb50bf7qpAvjcqIj=d5!}f35!^AEA0#h0#eEgJ1F zpKp<7P>B!9zh6rI9`Rz^>iQSB$3 zU0H=#D5V|Q<7G6bI*(0{F}4X9P#0sfV;JdOR+Xw)SRw-IC1d-rM^ztrkFc%-Rl1fZ zSkX_KIx)`!*0}E#_|j_|YujsACRx+$?I=8|cgNPeD5oc7x%L$rrmT+7$KMt#yici3 zb95PeIis(aZ)^_JbuNDS9+?&MPmlg9YMw3Bn`S6hoUvx$7T zv(Gss`kM2*n}Z|Ds5dhA^{-nEhe@>02Nzk%Su!jC02yCzD#Y#j=kca#-ZzpNa?Wyi zBQ>9KZ0a{inBC3^suNl(4dVd&SFajW`FUEg;JMUJ_dP#F@q1i2e>ZU*KtI;I9V^6* zJcWdfjE|Q!;1z@tWz`^Da zCRm_3OtFCI>QO zcYJph!R(fnJ%x*IFPQt=;a`lc?`_B0n+Uw0n~}$A^&boPhfcIVZk{xIagZ3k6dL^0 z(|$Hy=r(MY^APRSo^$I_#rs3}m_v1K1^j|JMpZ&*6`G@0XrQZ$rjOL^JL4CFW7L|? zNn?&?f8CbG6nnLHHl8BWH57R?>$qJ0@_uJIdd62j(m4e}i8W z^$!lD78-<8#)oJ=Y7kH3Sfg4J>>RbP~$IT_!Ia+fPTXv3K2&9ex;L=L^Zs;rjBZtQ&7`@Z$o z7y^^>jlGAZP`S5Q&Pf3EKT6NqU1~pMlR4XqRx6eSud4r^J_ZBN@d#kxI>6u#b)h&5reYDahaePpPc9obmw#dm6Hm?Z<4@14$bY z%y2japVF^e$W@7Mdk$+FIj{!P+dP`PZz&v>&`?#o@=nzQ3?TpgDV&aLWl~`wsHv z%gD&*-@PQ04(F+=jXvjMPI%^xcP(l%?p49dW%~X#l{*$1{nwM_VwEf`O&U%j3HS3wW9D9WKy67IRI1-ZW)LJp2D$5S3S07MDer8{eT~x zR+c8*0T{^72DK%HnT`{$ap_spC@s4j4h3{1b5xt$&zd5k@s36gMO0-Wim({18CPnY zuO5c0$r%lupf)=C3h#yNcsPl3F_z7OIXFJmp>7%Wj-IC#UKqf^Jb{DHYQGBLbvZri z+vPZxtVKfPY-6|_X09$%lB}n=Z|O}~_H+w?aqdlAw}Dg>oad5B=CX1rBtx@t2Wcmt zml&x8E(R17Uc6P9q9I5Hfgdm!&otP;79rIDln+GaR zJL8jA-X`St-PgTEDwaSUzG8W7^r`AnOsVCnfX9wA@ANdP127=2;lTh@(yrh#+-DgA zpm1RwI6dj5eMX5xkbYcaJo?qxix%Mj0KiWbK@=UFbJ+AXp=~DABpjdij&W9(V72!& z?S@nZ$ZYa4+O};;%7B?9l+F};m=fQ`2? z3cZ2v+O#cXXk4q0lW5M~$FQvHHjY_v*kAy{nzy({<%50haCrS|t_>Vj8okboPhic7 z816%~u06QLbQTho+M$pfckB39C1)c>;DhEyPe6Ot&Yw7CJxrO&&ls+iE{7zM+-b7! zY(8+uZ(c@gsIt2e6;u2p0~``Zt#CSR-U|)D9ycD9(^+5O;Hb#wCy;2lDmFViNeBzm z1Z0wO1zNVBF@^w>w=6TjIj(xz=@JpOlmX}uKZRVjx(aYM`-9fAax_T4F%5-Q$sC;X zn$Eb&q1l1YMX3$(F`(YtpLR$cFZuHqGkO45LQQI1!qK?i0V1WJ$S7Pc)n0ZKp%S|vXskEvoF98 zTo1;y?Sr!9U;;9Is->VfUUsQGan`Oxg@I9%yS-s5t7deta=ckYca8}lvilMCj)OaGP&E5R{-QNG%}Np z4({3S^rx&Oe54({$6Df)+>%FpA#H#Xk@YQ;ka64mDTyg=HjTZ?^r>Y+%0l3Ci~-1{ z5ClRIhUV$VTE(NOM#Tnj&9RecISY?kfXquTW#kizvexARCExwi+M;-5#?1BT*~V+9 zLl+x8H!FZcj2!WfKb<|4ToMQ&v)lElg}zwu7~|%}J{Suq2nfbAj!CUlZc9!(l-dQ$ zF4Cs}0tOG@YE-r=#~>avlh^523?IKc)P~2*zMhz=1+Zq$NY6u>*O0-bt1>2w5w>y( z8RM{~3sE7A{JW3gT2Ba)KrxIQWPe&oVaq88Xa|xy8qr3}Ln&Rdn%k9SRwq46D99ev zOKpReVpwnoV_E?+epblr!kcw!LwScBuLnPO@T{8Imle>@*ti9c&5Vpx#$ymxC#C_w z{#6|0f)rx_V3X42d1Y4;ndY@)AzT0*yTW|P5%HGF5gVnLtGF>)5$&RKeP}@CxOZ0 zx}xv7gQd->xVN7%Jn@Wzc%_>65%=WuQ;vVavDSA3A%M*iT(-;;&tfXMk~W4Nv{|^g z+_)LR?mcTh;^mP>I+KEPie#4sg7bq^q$RVvC+qy`Iqn};<<`SyxL`*(B=f~pdCQPM zC3*u^3i*wKMsZM>FoUldtfeyE8Si4hn8~}IPfU)K838%={u5G&ak!8PKBkz^6-PBHbV7BZ})@Cdl9L}Adq-qMW=)j(o zZaa>7rxe|fOmIao@)Q)>PkLM2&evna0J7?so4ow+O~2ZA%F~d z6|D?}4dVcG#&KNiEwuv%;PuUFLn%033aHOK=B4d(rYz`fW;@iL2V5;_L$o*pr(Q=& z!_#N=1&>YzZCj}-!S`+?V~(P^DmQbkl1&!8hC(tnhxwNWty>WZ8+OyP0D^lOiWu=A zW;q~Z2cW9~RmySqPSKOrux{^D(xn?{iGr%J0JaVR2fq|FOUYawoO{&E8n9jDs0WO5 z%`cVaE*KIyiFL&~cJiqWGe;}|`S zUxVg2Dh4}_m0gr8k{c(W^{2tZk~;d1wXZ|YlS^}RPsacp`IXEAsZdl4s&RaP-+ni>x=CRQUSy=3CCMwFz6-ur#*EQStF6kiD1kdvb<7OBh z++*In-pcDG9hfg-E3fd=ytfj>fH`F)O8qO&#P*YC)C(m zO|9w#8;gelwyEkpDo+5~X!<9`h_sy}Q%zFAN}R@Ws@dsYJ@Mzn2TjpDJ*8V*Y;?CW zuuP4+k39Ob0iv+rMv46yh* z)?%$3NfM}4{u7G%N5uNE)u)hpZtW86VdFa>mCDk_aAv&hP*I#k@It#ex9%GUBM%CWL4^2_qEKVJ3X9})aN z3{Xro_YZLL5Z+{1(3_8wdFt<6`!5crPJ$!h|^5&}cH&g#58 zlXj7&F#0Nq;^_7<)1zS?a{bi4A~Vd0yn73Cg0 z@O*aSQ*CM)Kf8{CzKai58#H{iYE>q$6TzapxVw{S`J3LfZ#1imNR{w9bgfgQTH0JJ zh_0lQ@|8SOHB0uIKPUl!xXvrKr0&#Wk2W->z9w@<>&zQ+0Uc`Ymdz}iM+c^Av>I`m zemMkZfnCRiJS8lyvJ^NyF;O=dqM)TI9Y@1&3O=)}!D?e*WII*ykUi_a_~Y;^RQPk@ z+kJla28&IV)-{?!K4v`t?_DRtJrL=7&8*W#xCC-|CccRMw)`1$@fY@L(66i)%%4fU zN#w(FS8mdA?O#7RIag77CVexbY%e<0{MNm`hTR782c~OJ!(JxQ?5-nwh?ZgxOyeWg zurPdHrt>g%J1*+GD{vTcH8j?g|U>NdGO7@-}pC#oh9vrL6GEOkL_CLWbQ^1}r zF`YKz3oS)XJej}+z3b`td^@J=npfEGE#sErB-*ls0E}0_{vG|E{6;PzyzuF0=0Y7n zJfHGw>wkq8o-($(w$nUEVD?uE05YlKLEo=>`P@}G!E-`aN6_KrPP}bWJhDA2!5V$m zjU2Z7*xT>GEP7X__&WVRwV}u?H{gsK%!@>gErh#BS0J2>l4|dQwYW5&6n~|lYe*61 zc_hHv6cd{96eBv3Pr5s1xp30-K0*Ds{x4hj@5fgD8`Cb@TWtZ^B`J`6=KJ4Va4Y9a zc-7_H7j`&ojPqOmGq@Vxj(kCSr0lrVCzTn8EUd(iew9``P(UQ$XOKJB=#heiR98dg z=u^CIFk6MdE4X7JLEsv+umO-aeF>?dhht-5Voge@OXOrJ>bU7yPhAg6FtX7Uq==Zo zDmLSu^+s!Kh7F8$1PmJ5bSl7S<>`aov##R~Ng#v$-1Ml2W<;TNrsq9z4hd|K-9=~W z3PX-gFfwslcQIhG9Wj!70a;gDyuwQs0AMaFqAOc7&yv$a0`4Vk_~4VCD-!w)l6#&x zuAbr^U!sc2xVGTuj>5X)tZ>df&Qk6KRmLkC`q(R$UzfH&!n(`bP7ene@7}R4ZApB7 zHPp2^UXJHAE>(ye{uLRQZyoCG>@1SxV{K7khRGQ@#TM=)(?gZ;`A{%>Vy8*E20UavaGqJR8#z!~@tvAmI$8Ip*rn6S(dj%j8Io(nMSdG}mdsMbG zwa~Qh^ENPf=M@nrXE+Vl*wT#jBLlW++Z%IXcXr7YJjJ9{aeD`UQWD*phH zv<~DRqrD-Apx_?-cC7h}O52{iup-Dy4cOz3^(2vQLA7y=<0Gw23aK0^J%@8v1Ykr0 zoOdAq0807UJ#{|DCV!R@RfbgOoEl?Bid&LbIm>kwc1StKNM13X^#rScppn$@d(<^^ zRZ_-Xzzkb-g?Yyuiq4$}@G0PTt(jp1Y1+Y$8OB9Ynj#&E8+q@|ZyijfE3HgfqHX63 zxZ|d37K!6vNEjV!N<{`nJp8TLaZ&jtw+xe>;=5rd%Vc?V756E_8S_3+AD*VPppExn zXC8o3+SvjbhSl}&T9$UBAm9LfDavLrhjIvD#6ij)PB3cB7Rtc=dY+YOVGIhcTrVJ= zm2L}087GCtKt1axE>vq6tCWfaDpYJeI^KOR@s3?ZOj{|A6je6%MMujcCBM|pq09mm3N#4+B3mDjZ7Td zh2&?U1Emg%xoi=+dBFWCyGGRryNdEN+P9C94?@CRg=O3b-Oejk(&PZS`Ac!lbLltD zoSny@J!#>mt*NglkK=}jEXKBrM_K7Lhjn@AvMlUiPJ&&v2-p-ppE_hb%)jA!39 zsc&$lfZy|x#zucy+6^rZd8EzDORz|0%C11l9Fbc#mv~*EHv@uCYUJ&%)d^ly9tZ=a zYFk~ZbS&U5G1UENy_v|<*z6(Hn3V;C5(3~J4R7iCi@Z#O=TpHWsINbc;EXWZ2>{_c zR>iKMVZ#!<@-x@zQ#shu5xMA*>Zlw2VP*hum2m2askvVgcV6|v+G-8*vk)+O_p6Jj z61jE&=K%MvXIG)rsdYzKbz_6Q_Xaos)MHQ|bhD@($9m?H{{ZG2akr@4dQ;n1BY(F! z>?;>lJ&uUbwye<9ulF-<8CK-(>T93W@77rg;}Nb7(0MeM8jzA)mH~G1$DEqQy}S$@ zkC(pT*06PLp|`OqY8On%Km|j8jdD8F?96gVAm`;ZuX%O1cFdOk@NO%aylv-m;m@h# z6e^mM>F8l{V56@zyP`H50M@6$EePIo-|k!a`TjDSxh zRZ|f`#{|}#(G|uA2CGQ{$RPKw)hisfxluE?o^U$iuEu!C3f)dXx#-ZNI>QrO$u z)}_AX#y2OoQMdz>o}(3|3}yIb`7_RHtP9_7UbsCgM$|R{UUB-?4ocb`5rQql8QNQE zVmZcZQU%_JTYjYQgd;1>k2>JO)C+50gCP<3;h{{VN|k?hZyS+GVnkF9mW zIs;1D7}45@+l-dv5PMY7TL7DazDGqJPrYfrn5qHJGuH<-EOv<)&gO0Ff=^oPj1{yw z-(wZ6j|0p&$5-UkK0z2_eq}iC*Veij?a;hsc{uE9yw<9#f)3z&n%kDgGmiH%Je4Xz z1a9Q8^{D)j3S~y+CkNWK8VL6StQa1dJu0k_5O{uZ&U;bI(8kTPJwR`|a=`QhwGyYw zdiCTJ$F*78v4AHXy{WRqBmk)Zp0y2Fn;7?TZ99nhk5FqaXFJFDK+ZANwl0yQ8Qe+E z10L0jbPi7A&Uy;w*xPhQ)3GIY1t;FA&u~E_KQFFo#>0RLVD_rBL&*$BUX`RCT zUS^t6NaSF9cdHS{yr{!x*k?6nJ7#dqbA=zBV(NL1 z>Xt@hSOyD|w4R63n)bm#!Q(uiTHl7)%0BKm2cBvPtiWKZpd90+VeM1VoVBpJXkope z1FjD4N3}%Ie9R9x;8x6#1blFKKS5Fbm}C-04;4|Ums7*7Nv2}S30=5eIvgAfQ+%Zg z1_}1fYBUNTrqPe$=~0_-ISfh9euA}g(DUU?%zJa5nFqFMf*i;&JNB&^pvxTaJ!&aX zfB?exrFWpcpK`jP>ZI{jRauyvg(TzK6&fe6I6ZS$BV01B0playp2)Z+iEY7BqaAvR z(zYZ5yLiaQxT+}@7+_$N*0inA?H?!^;2xEZ$5b@f*0cw^F|=iCHJ+fWi;Bjp{9PSHC2tIi202CQ4FqwR1HpvNMl zMBN^9oF1J&3Q>c(-3hesb1MLa3XLL@)EdjahkCIpzMFg3MR2FfWB?yvFy1mmSpxKF*2h8;z0%k#T&k8I|%ZURU0?I%2QT?#F96sHtr$THa( z4n_r4Dr4+elY{G5r;BL-4X4tokT6{Qq;&(mbwyb4aT3167twmMg&T?_CL99z5q_{i^Pe4cG+oPg>fuW4~}a7u7^=$aftwbmB$K4AlG^D{`_0&dzrad*abZww-tk&}O|~!u~w)UyUc!Kd`N( zeOls1FAQo%+#XANSIf_pLzV7&Ri!CZZOb z69dx~*=XKBiYT2WxOKGy7-sM7>0FnKJUMe@yN@$bi+oq=tTHPE} z>Bco3IsBRQSHiD{x|WeVQr@WYQAXW}0nd8&Jzmnnb84p9T3x{v*nGeqPc`HI3i!=- zG|0{Ektoa9;j7TRIjGI9TthK(pyaG=*9(5n#E%zg>#-s^rMyD!6cr?D}83_NM$SE0OVq@=e9h^GDdPev0cU8uyoy( z36G&aTF1N7cP`Eg4x}~!_O6Jek20)v(Bp0+VqCLyKXd`e`qowC860vm&$V?E*tAG- zj1l~KkMW0TZvlbkoV0^!sYHZ<#yxOzP{v5l)}9!t@>%7fV`2~n_@*c(_kED>r=%ET%LnD&vETq5!i#Y?8ztct1(#Z8R|*>D>mC^ zkzGniif~GvIK@jGZJxNu#xq(`*k!rOJu-xKcML$N*HrBN#XU4WQujlULr?_l$TfgOi@7 zm}A3W-~o<(Ysi#reH?Y%&XPA}RaOdm=dDzDlZ6U0asea0d)Bn}`{Ya@9YG}YH3ZQN zg}^-I0(q?UIvQ3orHO*$s*lvw8--FwCzGB#R;|+R&K!-Sx2;i?L%&YhBONPMqtxb= z?9rCVx_mLf9COm6XpAQWmL&A66EE)w+A*9FO&Id|{{UOtK9$ve%X5*dj<$_qi*oam zoB_>g+9ETn1!4ilI#n1$DH!HG+0T4dy`!qixCdw(y}ufl?&>J6XJX~8r3VVNz zUKZs}K3sGItuits17HUu<{dbzk*H9+Q~)qJ?eAQ!S4UckLq)J|cJtUCGf|sy96{HN zpI-H3$AxX@b_m7~YOiuKqJQ1Fi)dzhJX*&&)PdqYiIP5^hK`zm>5?>(l1~6%@D@eo)k7LC)O}oe4 zV~z+tD|Bb2uE~pUjAghTx_&iC`TY>`;PUFUL$gOWUb1btk=QKz8jbf!NgukYk?R>q^yComD&XK^tTMSp}1hM}KchmJU?;W4}!Hsc|)raZ)ccc6sBF1_fJ*6t5~nV++S3nQIELS0sk} zz#en>RrsT3P+1s%4oK_oU2sY47jJU9TkK^R1@q9Jl{|K&le_{zBxjnr6kC{J1}CTk z^{JwSIr9-pl6VAHZ8)c(-iWN0XjC$&Rz3QRQa!3C%GeSffDUVBI{`Eyc8#RUYc**NsecUSG422yAd)5B{1$-p&SH!(h zE&My7UFvL3!qFiL2<}+$1!VPC1yM!&%=4F0SObyB019!kVmB(}6V|@c@NfJRk6V&B zu6$wQD@_(Q$!j}d=gJ4va4XgH@7N#VC5j-ry4N)~AZ5(LF`r;NR}ArVX=y1M!OB}j zv-4(4Mv&owByva40s*tSmFygfDbLlRB%E3s_Yi{BP`yzHBypmQ_`nO6IVkL z*tA5PZqM+JhOQ;CRRxr&BO{8kw&@TU9JfqolUCzbP*s@Z_U($~l&)N;+eT-tsAm{o zsP(Akk1ox;fCoS`&uY;St2Ws%FnZ^jt2AJ62Os@@^!%tvb3)a6R&mZ7PTAjl7Zdt)7as;t(Wu~j(fir(@GQWbjShV-g4Tk-|~W7LYM zRJ+t2Bx0;%Yi9+!FR80A+qn!0QPU&6IiV2D2s=)C8h%s~z>?>jR??Q58OAE(qWk4Q zKF2kqV*wzjDoE~sol}4olXEFRc^p=~ji_{GU>gTM#*=o`yIk1Qtu`nG9Fd%g-Lkjb z6fqq4AI`JvVh#WpKPdy80BcgqbRd>bnQ%8_h83DgyQ01V{k&lYcZ`FA2+nHsF@kVI zV0Il1MFdQNTO;P_fmb#d_7XOdaB_J1(aQRpMx;v%YRteMK_C!MPs*%D4hohGs&F>0 zKRSpIGEg56~Mo-Rh*rs}Ynuden_3)3rh4uJ1~L*p?Ur zo=?)cqfHr9#Wb!}kQ^VIB%j8qPtmcH@9S44ak-C7_o{O-DYd@n&q~!o$nt996^in{ zR08*_rz@Ht*F$6!0vSshrMcIZ84JP|i$h z7oVkfUIf*l({=l4r8^*286nY!s$Q@*z(f2Ncs@_=qGPkf@J?-x`7`&yOhu-4{ zZ|7WwhpI#HXT(-M2C-Nt@dmKUbqT=B#Tn!-duP3R7m2y=@$yN4qqnVc+I@uAlCDN0UUB?}E2H>;%J-K}3G)kXVbJZ)Y99!pzY;Q` zP^+AE{Oie+(D$PrV_M5du!#-L>`^nkMOCEezTkS-i}>5Yu-$6He<9u{a;l+nK+hHI zx`w@DqFpRf0e09WfLw&Ga(!YO!2bZdMm)A#qF1Aae(tB4ijAdYc^%Kf>sxhqk|aT% zbM*DEE%9ZQu8_v1+*^wI)5Ln*v)q)Bk{FZ8$jy2R zQfouc<&8aL$gg#r%zU!Qfc8DBHeGR|I1ETU44TQhzua9&&%I&Id}MV19faWL`PR{g zwCHlqx{l2Dzl7ctzwvd`P8I&i4-Y3npG?=gXdVudEkY-Vouq}qU)H>H!v6rY6|cgd z2>Yo>M{R6}oItARq zDazqXw?UkAu2WOiVDTlR*vP_5V0dCVW7yZ0{?s?tSH2e>Hq+%;H4AB%%u)B94^S)5 zej9vFmr{};B+^SEATVRW`d2QkbH(V-S`^^brnNoCz@HCq#(lblBjM*<+lHxr|_r+*MzMUuV9tigrL8oRX*K&#A7L#-b2NSkDSa2a{Dalp9-| z6Kz#dJjYm_u4eu4FOKHC$Kzh1C7;8mMPDx7@^p;@E_X0Jv*}*5saqwjmzuzg^=^cF zSI=J^wTU$?Lrv11neDAm&H_GEGY&ZQrIu6nn55rAvDGAAjAa7Y~Dtt5Gr9z4R{y{qpUPebP^tu-WyH4(AK!a4c-)xjAU z2dNzGJXC23+DmO!Cxy*jf*kyyj&Le@7UyDi(4%u|r!3f0+@60Lp>b?T+!?ob9f$t_ zTDlLiorQTqI4XIl-o=bzytByeI5lyN-i9t+4n|ubQI6D*aNL}eS$FmxVK0!M-u~@& zQ`su=zc68d02PmMVYvtifH^y=;~u9SN$7BQ)(oVwJu-S%cYk75 z7k#({=NQ2s{c7i~tcoAFFiuL3O4>0@0Q^7$zu=TkM()>Y9;B%1PjgszcDo!8yTKX7 zc6WAT3<=$n!kWdrvo22nHts7$=5S3U&MxxY6+JoXFgbr+7q#n4UXImqL@;bPMus$2c{iZ2)1CGEXBNs@yg*ZouFkySe-;O4~~y0#oPiJ626IXp|$d zGBA)2ls9TwY|9q;aqZf=7&P;RY+xrQt$${r>%+Gok4nN`XG~q5hZQBFx5`rouQgSy zvc!@Ge(4>nues9l&Bj|DPfE?X)5Kv^F5{o2Lf=DV)6n#lMJx+rBckJv#-frl=Hn{J zMS}Q^WXZJeJxHu=uBP{9huSiP1R;Rw z>+e;jknPK5heEYZOO_-O!47a#pURoNfh^21$i{ja5@T|G2(Jn{H#lL)6^>*Cft|0O zok6Qta;`{kn4Yzlb1%z)M%-kNdg-TRjyjFDI^sY<-MFwljZ~iSV2Fqd>)x3q!hlEs zG3%3A(_M@M>(aYaE^|7L)-+?eGGLyg)1juxI_@95W<5ykwUU>GT#etmCj-)~OK`4$ zu0rFbZxv%FI~N{NB8=lW>JL*)Sy@2{cHrQH-l!$cByZwV>UvX!%W}EO`jJ}M*yfb( z?r8}DY;+y6YEe56lpUwmvKn(2`$x7#Iyv_S^(XPB-$6NP=4~y{BoZ4vYH03DmgH?t zfL1z5xZsjUcInMqhH}R_7$X@KjGHxG&Dbt-!w=MPjw({Vbg|trMfpHpxKo2y1@2?qWXU7~#Cumc4bsR6-GD#5YEyJd zsSHUx;dol}=dP!t30WNgy1-Wh=OFS;HLkfNzV4fVtdV|FAH9OZZ}~LwcFGU?Lv961 ziz-q^u#mG5NyGG@OB#We`GDjo&1XkBDgi7AIQPe`J~;%8dEcCZ_{Kn~IgoyqlI(_ISM}RdWx+yWl@R2Q;(H;)g^5K>SSEJrF^sVHhOzj zJ;Z#-8IA@B2fcI?p+mcCV2-}^m3?j*uvb3dR`8NqBL@rW%u9%hHWZfk?TXF0;FiZD zfN{lb-Nm;(Fgn&%+kh~71I|0v>Q`W?-B`q)Hpx8?U`158jFmX$vz}{Cal80UvhS ztU@Uh1D=GAl~URun|CP(8T!_}ss>(E9P}htEar`42Xghg0kn+gr?zWa6=f@u17oNa zp8!z1dFQ4(R)j0T1&eOyK9$DzyGK%1*uMxWyfT3;m ziMESI$)Vj4QUK05&ow+CxmH26zm3^*_q5+QF6t6SQHDI}b{<^=CrA zE`_UDisK5qdNJwwR-L`D1Lhq#;7X zIKcbdb60HbK3;mBgE+=2ac&m_A&BUxG7Vpb9k?tG?@V|8mC%}q+ij5jn{)#h3xkk* zQ{%MH%DCH%f$oZgz8UCx|5#=ziq9{$ytJ-*B% z5g5nI#den#8&%{Z+~9T3eAXVJV;eU;58cIMQcGizG}*~qTOG)%069E$&%H^fczWwr zy-QnUGRZO78b+myx26Sc*yuBBSCLvlZ6uS(L};KS&1&S z`4loMDBElZ=s()`u4MV7qKvE8jVQLyDgB@S0AR~`Y@pUWex-w|v|3^u61_(A+v#6d z#h_{44bs<5(X{)0Gf!2*!)X{nk8|F;VxS7-yk~y4a1zG@zrACauVqK`JbDwATFaQ@ zb({2yA#)}_yI4)ADI2)ZR&e)*i0Pt(zs&b}& zg@>aB9a-4TsV>2>@^SZlD7V$2WmI-3#F5WR;%+s+^k>@W#IVGG=U^RdVC^kNhD`FWX0y=;|F?jf^r6;A_s{*RHha?q;6j?NO^` zQZ>UM&rf>MkHqaVx!OQ0@-aPrl~I$io5QE0cPsec;D5uPhy_34An?_xx++jz*^eeb z52;?JzH{-%>>Y1sGf&{Z614G2|Ppa+G7X+wAu~a zncwT=xBkj&*`bT4U)_33vDXa3OWm%t?!Qyy*?vX?Y z1J{FAqFt&+Fh@h{QV7GoK{)pnN!hC(Jz6~1L|+G0_C~;!;(EJ2#>_cb;%Q>F8@j^w3(G_K^Ta zNl-W>)~%o{512=m4$vQvN3};|Zm;vR5u6>k>sr?E7GIbzm`@9i-qlFwl6#@i0;O}g zmjf(4eJb6mvxQa39Fv~h(p$mhuq>nyaDByFjTxV40EFd=oaEN(E$WQ<`B0%4N=|ux zrN5Ovh_DG#>W5w&O6qs2SUVZa=NGnCn3oh$EHnjTCAa^Wl1cqEOMBFf0knX)n%qi3G=5tQT}gSn_=mBTQ` zan#gJxP#6ITmxGz5zSW;+ZI_c#Db(}t!Lc6=G~GGJ$R{Skg&iwC!xhsoSp`A>yGtp z98;}*2t(~|a7TKU)_gfU{{V$ll!hQ=4`E9TgMplL)7GJ@oc`6{Lu%RZ!~#xx9@VRF zaur5-^{#p;Laq-^pGwoTljho5uxi&eg-+(}yo!yL{A)%j{Kwo_k~;ChtO#c1esDqK z+O*)gJC~4hE1FBG*9pCjhfkZ#UBrdwpzB(&-T7l(ABAc` zbO|8ie`asxQDke)bz|8+5o*6_@ePfw&EDu5;Z&eFPPO;n#vcz_UTHc-)yGzykP~UyU8fp zinuSl@1%SD70!5Th6*4)x@E-;A6SvD6P1O_=`ahzA6&O?$SRtRx7eOio82 z^vztc)Ggz@k91MUr;gQx2so#h!WKABP&pitm=v(#m^_ggl^LN53`g zfAG&g5xh4Aymr}gbH@_DznskX{k|7!r00RTkzSg+A)29*7 zaETyS`4n^m>s&Rl6r9?WO=$Z{ZAmlWuO9pw@m-g~=C_kjlJ%IZw>z>}sOX}+Q^8uS z+6JhRHt3{{z~r6>(!W%^e`#f^X#PdKD6vR4Fj1WPX1_SUX%7vr!|#Z&T*n!T+VPG+ zA1GiwYnzr1Jdr(!;^w5L-;wr5?Ee7cBXes4Z`&q5@o&9~_N`Y?k5c{XfUHhK9)i9i z{hs_{w{03_Re{Z0NC^yuc)#-=t)~vT7uur!vaPKJvcROEyEUIz~?7DKPqj!MT2~~JP@Su^sNY?U`_|$ z`EUnMrB$>o&ibx|P}-iag;T&EPW3ZepL2nX59wCzpc3JqiBEEKfmUOTv}K6M?UB~B zidz};X?Anh8hWuINJ4S9BcG*Y-096Ak#=Vu_14R5WNs5Edgq)9u5{K{8$gT>Mk3_V2Jd58G&_`Stk{A$=e=!O*a3n-2N>e5 zSy(X~rac91S?Q#($jXkZS?cs1%6583$_n90HKw{6BV=KKUT`@TwPmKFgOz4)O!TcN ztW>xJG84&F>s4zq4qbF?f+HDRXC!k{!=^Se7mk<%y>>C_zGyps>afokCay=LnFj!m zY+wp3n44!KZ=xPJJBB{#&TC%VOaS9b{5|p=!+Z5U)$0=INrz&p8CQZwBC{`aHDcU>xMPLred=6p zXr}r*(xq8R++*0Sjy|7SWRj`e&Vf!q$T`J6TWnONrJ0j+2`JeL zRE%@m-nsom0rH*_Mo?NI~dY`_Pe-&|C391~X5=B`fG#z_<_ zp~tUId(zy6T(DxLxgScc=M1P`8~fPlP}R|e`kGKM!N==b79^`5;a;OPk!w(10y|8y-Pf~8*#=!1e&FG#7M^&QZbQK zlf8v0b}C%m?_vid9epbR7Xe+taGaQVXg-ErtEtw%$Ry>%{ zhO%DdWRrjaq>gdP-Jeh^MdoA7_cs#cGXkVGe@c_>ISi+v<381kYT03ff;~-NSqB4? z#a_&t+`Z>-Ae`iN=9MI8^%>yRWFvNeg!k`OA`OBw)}gV-eG8DW@7J~}#8T~EIQI0a zXyq6yboK34VmatZ9V<4wol#v)B#=2=;Xv*^YSc5~$2g|11XrV>{* zgoW`N<&<>5{VK?l_ln86Pf&51%UKvNEJ*LoTS-U&oa4A11w&5S7b_ZVD-F2F1-@cO zTAn5j*ibus%luVB7Y{Oq49a;Gb|hs5m*r9U=Cf&AaNU+d?@R(02dMR;WWm@8*u-NT z^Gm-ms3i3Hi*PBx$UwjvX ze=lfHMdzB#mLq_!J@^=;mr~42n8-#2K$khobjB+ZXo`|sn(4I|h&WM}#~zi5EJfLh zsBHDe0=gqDE;g;Pg?STX07xBi=~U%Rlg>}AYE1{4CQm9#Ro%)cmd z2SeQTs}MoTWOM0Ln8rZBBy-5CFhkg!f-|2=QlDa@1h*x&fCHVtzolP=2H;c?pI+4z zFe>aja@_$O)#Zf6ka~6eYmu~Q;)&yrEDkWkjyu)cbSnFlXD0`aDhS3KAmlLb&0c{> zJe)TeQAO;uFt(+ec%M9HuN?HPSX6mqIV0|jj&oEk)6Brj1#YL(v>_o>pku%TaOa<` zbG=@M@zTtXL0V}M6IRm^@t+&dgV{06r@TwMZ2UQF?CpjmN!nSQ8-c$^AA8u8FPf0wZlw z2{{KHD&%TI0tR@`N_DzAC|s7n!KoS$tCr3W3%9*(8MB9JZqHtTjAPcNjsv%l19j)US&G=m zFzloNKJNt7?;q~*otgY|TBgy2wMGrvD=;sNDLGTm(y(r=yw>vA7F>dOuCD4eXrDhI zBe2bMKMTAhHC)*2f0KxclMqd%@2@`4( zWLrkq{nBHp9;Uvy)AcAV;zW_c40R`p`L^H2vFV?>g_F!Fw`u4PZ_=`Le~VLLr2(P? z_iDmSfv&DF?#h(;O4XyElRKgsbo`SrL ze0;oH2rZ?!2(I`n-7r6hd*-;$i5@&UmWcOu?q`xW**uQ?xIW#5dNr#&WL3^eaa3i@ zbGrWkjwF`pz@Ng~`DL9aH~d_fFn$Vp4cPVBEw!l~PM zg`kILov;Ig-oAcVX*Xnj9vc|qw>`T~@za>`JB3_)tJ6O9B;F%^Nm?kbJgxx*^%de) z{wZ15qp4O=!cGw?|usah=;7W1fcwvi41_ z1?~BsjP>iE6s5zd4Y`o<>G;q*NeogeN5=92!Rwypyo%q%%XCz%g;)%@9A>n%`}rm4 zGRO$tI30K=v5r0ls%J$QTm&&*5EGnc@hCltCo1I~Wnu*1S^RRVb;r zj1z_kJNniAA6$`OaEHrX$7VmfQz&bAob#Ht$6fJ{;Gc$mIO*}DIMO^=0sA(tploB= zCG`i_wR|PxPX_CM4?IP2p!kx-tTh{VDh7U8hi60lN_}hYD7;hV!xH(8s}tc@Yb<)rfLz0uAq>i>=<@o^{TN94tWEwdh{ixgK|^V5`xTt zZpR>xdRVgTS=VR{v}Tq+kTF*vx3+Op>{W~?8-eF1wF%iA?G)x^MI}M{9<`r5c~>j) zYE^n15%;T3ZEj`CtWmXv*bRh+ZvDk{I$RAKs^>WV@T}{5W08j2*;ou8t!&xA zRDi_gvCq=FY1y208&^6=5OJ2?03Uan+KBmcec{01f!e5P=&p(plLX`{j{WOWDE|O< z10D(EBbw}tQ#hwS#PLL}mv+j5kf*IZBl!xT01?Os2A7b)V+4#6M<0j1Iyknr6kr38 zPgC`+(z4Lyl(iim*ZZev#sK8w=~EmCh(-BxgOks;YBHsm0H*_tgH{XyTzuP?`=^T1 z=1N6Ng%V>9!{x?13ZXi*s&YwPxzA&Y)|DE6m2yh;+&fl$;kJMZ?NNi8qLkl5lhwx6 zA1p&w;p0(ZU3>_7Mj!Egr&#iHqlAJJ;VQ#-K02*mK6sjDY;hDHO z2lO=*t%U@x78-eZbR^_uHz~u3YV%uPq$6n%; zmtt0ft=kR@9AngVtr#T;%HP9|qqo+nZ3BV{BehQ-0D+(Oaal(h*ygWCjii!$U{?)G>~_KFp`!)cqbbKh)OM{~SM$^}WPm}(^{g~j zVUT%Vm^Iq?Bg5~i+!9ogox8}vtf|MD*ttzoi)`8O?br4_^_}d5t4APWbC5-Tn0zkP zEj~5;1iH}RmpZ1Jq2Sy;eg@=W_2gIQ&y0LG4wI!UDnncqOPg~`#7lC9ulo7Rp+_Y{7196iLN7f+B=w^47uf7zG-|T z=f0ORF!MfL%5%uT=DkbyqOsC%ykBGDtqORj(ELMcw+SMB-T35j-n`?()?pGzeBH4W zI|o6GbUwB4c`bFK1615Ju1U@Z>sY#^ ztd}8x?ZK;-*Bi(U^LtfoWM^k#(>2!x%RNt?sVl7+6j$>}wMRJQ*GZ+`mnyF=&#P7* zn`paoKKE~W>U8T{8~urK7(zJSI3l`VD@`;yQIp-BPLpw9$Qn!Z0YKoMPqli_g1jN4 zc$Y?+Td*|8a$7js_|7@$Tyvz} zwB~yBlD90N{ZDH6ZQx6rKN_r-^B|Tc`^E8}U@PkAu62tI9b=YeB#=bAw_?5*(R?TI zBIe;_wp)alu|n$DC9}|1(Ov?&_@SgmuwJA$(Z)n;6plBOjqvs{{U{ide2$#&Vh4jFcQOd0gsKxJxzKK#rxe;OYo(|`@9zS zh`wWmeZ^0vYvHYX#9F6}@6q)ehPm3=RLLqU3>_)Ds-u4DJo>Mb+?MS1ui5j(kEiRg zM$(AYn=Hqj-rrjL+rwJBTv)>>-q1Q{4au+0--Vh~_WISU0h~BEBc*-i;3?1cTm+UV zhz7&l*Dfute{-qyIeeOhL<>UcQX-qyUDH*N4# z1v|ELyB$Sp*~R8zh$^Fy0p!+wkMQM`xA9}4_N|*VRA54{CzD>nS{!Pvv}OBcXwG&P zayEc_)~qN%10NwAcfqQ5@ovNX*~UQ~1#CfRp+Hl?&@RP}^GHGPCT#eZ$rZH8@a?Wj@Z*ilP8@BBXer8dOn#{h^ z3hr>lf#9he{uSu+>E(B4x!{r7v9Gl3?l>TW*A=CkvS$>fspXe?Sdqy9ry1MRHO}g~ zF6DIvQ@(MU^((z39$87_8>9iLIkLHz4p&q!7cv~>WIY4VWWj0m($L^mAspO?S2T#rdrBlmmp z)vKeouqP}47ny+`j;I?EqshBD=~pAORwsZFM?=MF$!5|F zk({5_og^WK7y^3%=~+E>HB82PG<0Bu7Gd00MdqHO4i_DF4_fM)J&*E%j)3F&)^?)^ zb|8*}0FHSzHtJo^1iZchN}}fJlfsdDpmNz4iSw~e| zcCJLV)cc2IX}gpFte8?WjDD2KRdQ8^SMOwZ_Nv>-ae;tFIX&qa+{y_f<@KcWVv~wP z*<<8#tOr6X15}Kab0ZMV$jRtED{|sNxG8*r)Q+`{tV$Uif*C+6GC8Sw9(`9GQON2X zfJZ70Gm4JHm74p{X9swq+qN!^NzbU5V8kQ8IMeB=&AX-6w0V`v*& z^A(?Ehh+h>d+}PaL(F`Z{3&U$t)A-!+GNtW=Os2O!q<;}S*z!RTui`GZH2F^;@fTy#ey-OhI9-;hWmv*eSK za0sjS*bdu!)^U#;h|Whitrn=`l!%%4V;qA_kLGN5^r<|P+wsLo3_D3~K^*cb*Hb$- z$HET$u;#R3Y_=G4k6Nu93?FbjH)B_$flG1MKYF3NmZHhx8@BcXAc~zhAhvP_DX~T6 zft)iF&0JJaLmkIC91bd5MzMp~M2xZi_pqx7g#f~2wm1~^iM+65z2}IBg)~M-vhlzINd#qFbp&)!6E#Ex@}0nRHf z=FqQU$m-S7%?M$%fX6(X)_ue|AQ8atR;QrcTGbr1)@2y8jlhiNqI*B$Dg$FGJ!^92 z-)RFOf&T9~s13LX$^Zq1ao)9azT;H%IrgI`LQS)W$NH<%V|ED?|^F>%6xBuNeF){kn#6`u4}xxtq49Qe6!Q2bPL{ zQU-DlU#P2A#~Vu$OLfgujx3$3GoR9~MmG{%kjIafvv$8Rs=Lt_V~Rc7iOvpjo_?Q7 zwPpLik(lo5(*TN~vA*w>fma;!^HuvWBiX!^AMG6A)~SMe*yt@|Q-&BDdB>%1S)p}8 zq@g1pUwX>ZSygcRN#h)ITb7o}lB|K*SPWws2Q}3V45aU=ZXCwT&gDNY5A&&*7T8xf z3xJh1x+{>ONj-Dx?N$;KwSXAKbj4~b+jdfd7Av@N$DtLX(U{a7#4sR|De+kp$^h9U zeFaW!%0@~MM^o=xrFKh_ute^KPDW2VNXa6c#9%g9s094oGHMAC;4IQB?!el>@IIoe zYMP9CJ&Rn;nIj)6#GP5Y3{q~|mXcetwC=iwr){So2hCyTg+DTZQ`=Z z8+6zc8~_e0hVW{sf?Y~b@ai+M4I7MYjC2FiscYKnM{y?BK4H$?rvtAw^LWX+^W|G3 zfz-aJ>h-@I{gV^#T=t=_ zyeM~l_2>cbSkt1>&gATOmtHM+6lr&=2Xg1qvakGFF5_ldofWxcC+0Qh&*G+* zRz{O{>|`J1Syy-KBk;vWPtBf1cfu`cYa^OX8P|_hV2UW#!s;0(uqxlsbDgxp9?_g>}4=&cL%VImaW~v@ASaQC1_e z6(A|w&wqO2-t02%L5EebT&R{{XFCMPYp~X#2mfQcZVSJ^b@cmv5AE0X-|stsY5S_Av8vR=Kwd z$qmK=k&}=+AE~aYIEAr|7tE3e1Lkw<)DOm~>CnY<8njWBz#Gf=KDE@trIxnd7kFF^ zsx!CVxi1#2-1MVPT?H1RGNLxvMgSenZrdu`B7|jApW_?>ilZIBm2tfglp_JU^!BY7 z^!V?so6crz9zZxF6h&LzGOf&u)@ZZChZq?J$QT&*t5Mp_XJZ>-c`B#x3X@B-S#IIC z$(^K+a)2^G9YLuuYww>EcrtshsRzKpTK@PyV53BOL>^j zXgyT&Mr+WaRm$|_wk8!hUY$w^-~d?gI^wL2iohKD@l@d;$e<5h)oB>8A1HIvX&5!p zd+2th)N{kUh51yjI3028QT?6M8H}E|Bcb=JgUjEv42*TfH5U$d6Uv_1#UzR|Wwgu4 zGtY7=Hnt22EJ-5@4?~K-BCvENvVV&_W{`p9jmkp~fdUpmwc0 zC>Brqpn@^f|XBR#ZGL{(6Iq98}B>(%aQrZ$rt?)}f6G z2PKcpGm(mL0yQLtagIUiD%7>HHW129x}!G(oaen|UCh!WVL{2j=lRv!jFkm?W0f6E zXI(P5Dn=OdkZSHLYI9n+#!C`0`3mE8MFcs{bAerz_%FN>kVnmv&2tx)-eVMX+qaB& z_NwM7D;%Vjrbb|(mM0YGY>KJMZO0rA^}4nN!tx75E9+ZXqq1_%m%Or zr#rjVX0jV_2JU|DIr`UJnpd2woS_4t6sJo7AD1BTGAggp3Bj|7I(8&{t|SAU-j!Bc zCQvYNap_&t=!_d{50v_hel=3(N#08NWCi1=S}xHJHrAaEQ2HUs)F1`04i96#wkiJ&c#PVI7PH{B(UH&K~pYsfyrL|jc!=@Uhh+o{hbRi z843kr$!R5|j*@~f*dqrco@(qrH1~g|x)bBv+FjLXX}y zaseFInfMP;(d_lhFte$d*a5g>2fl04ek|(IX?`2Jx3rrVGa-*?Z@ZEAt7>%lb$gsu z>q<`D4>s|C#UVe4u6&Dyk~MO?p0&(sI^XumHz>-JDacXCz!l`z@jjn&+vna}Il;|s z=(jSgd*W@_80%YgIjqll@F&L${X4_M!n&M`E|`*e){;tcZP@iup4IAF2a5#KKuIiw z0!MGHd~2v*7A=v;uR!>B@d!9J^GL}u4of!&74!L?7uqE_pI4LPRVVCa)am~KX)74+ zwZnA~VzMrJa1JZy$!#P?B>r{oemwCkI{l&-i>-09`IvM^xQFD&2Wo<;uv zWlvh|yeaWlSkZ1Hk|sD_17`;v>b;kOqQAIU%ZR}1xb^&N-#!_B&6*ys_E){RW?2T} z6l5-Y*ELyFdPwV`3{+j<^cnEm<7!W-!xiKX31U|b-`c*8(7aD?s-j68O#=na{-FC- zex3U&>7F07No=JOstw`ZFi$n9r}#_kb2JEyo?bFYU!~CD|lz& zrT+kj<-3aRH;tpr3IJ$CGla|KUfV3T#(Js}>kV|uc_}9H_zBZ4- z9u{fAU$kur7(>y>z&P};Kk%NLCZBKitA+B>er9vn59eHei2O${iS=0}az(lwkfNM! z9;8;-Oh49V%=!^5L#I!cJC%~+Y3`<)=2JY=67J`zbJW(ogulE1$(F`I$4bhyw^VF` z*atlGirKPN$Rp(nI%AS+?V)6>j}fk?L28P?lAtN%@yR~b&{@R$)v=TVCnK-5VOftb z0M1wribqd+=`7X3`J502M;vClW2!T|>TT(ff^tYiJb=fF+O>rzMc{1*A&IQ5FamHJ zEWa_wTIj76q*IWqoMRnxTI?L}p!BmSp-Ehye${dtVIL?_(bu3IDp;W|QTBvU&Iso< zWe_3U+dv%gS`Evw1Q3NQ@}4@MTF{QsB-+6cp2Ix-X<>u+oQ??@0#OBUy~bc<{!i{)H^a1BQGN_V+H-!=nQvC!pmIIGPyaB?@O z91iu5b*6$jBy?_i{x#m-*bFxV*bXZq>d57HF7DYqt6N#+c=f0AbVLG_7ri%z5SBmJ>J!7~|fk&7y-M z;45t#w=aMH09ASo#*_%#oveB3S<>ljnIHlI#~ju(O2bUz{{XUflaL5JhNgdKsEoR( z+IR=jyBTazL*aIgr`**;rkL<{s0@Cf8s}=}iCbe5(!{DU0Z!%U#~jx~W2fy2g#a$eOLpcQCFyl3Y?tQDMoNmkD z%0l2_y9PWOf1aogGF!OLYA8YTH>+fkwNQ(R>T!+$HK}til*b!gMt45?1me8LxD}&b_ z^zj=u*3L&9`c|c#vgaiO6WI3rYZmMgT-uJdwM1n^Qb6aP^{oZD3^F)8jQY`OYRbg( zjB}2)sF9-$gkUi1+)`H5e5EqG0UI-(;8Xm+F+eC=9B^^@)SQM3#y536eT7FLc@{!c z9jET&HC(!A9L>E-Q%0bU!16_B+R^U;B!=N}k zR9xN=B1o_}8LQAh_(DKX4nZEi^(1krAPj9@q*cX$kho)xGg(SjH&kC?k=l{Y0XfMv zVmov!dgB~suEPmu8%NORtx7GvT$8lty<+8ct2T`%bVUq*FvswZ^O}E@rO=$Q>UN$7 zwLC(_v4FVlJJpEbEOIu1>+4+ZO>B1iHGPQI1t&i?SEy={A_~~shCM;6NSg$B%N~T| zIjNR4B0a~4?s}XW=W~5dn9}OX=>mi#FX8?*VIXpTVaOT4^s7r28wa-_RfsLw$t471 z9YrTS4OKl#(Z&}ej4xdFs|jzl*K2QK$pBQQ1y|bKwh0;O#ap%mW3d5T9jl(T9PZZ% zQ@(@k;6T6wl2?qJl$3xcPBJ<0W}@Tp)FDuOe(p0yI4p5g4+ zkwO%O+mKHgsYSaZGdh(GlA@%JEud}(@aY_f)6bCJOuR!zhvLz98%GgqNDXvdN;#OzR|zerDq9wGk~B1diJQS&@sj_j@ZsCLfQgcWaI#PclW51v(Xb3ec3&tmwc7M>6+Jq z6*(+as}2u5nynh5;~=w-m;udb+b&BkR1D+{S3T~o&bX^e!`9sGP@gVwobiF)tt2d} zRY?juXQ?$ZD((4sVmVSXx~#3cJ7;c31LhqoK4#8@mGmHrCT9+KY;--VQqln+1dQ{X z;+Y+|bqIF0e>&2&v@!+xh|7J`+O2D1T5GAJX&SNIIw#A=sr9aw&MczmB#t?(TU&7- z&4Og-f&9g8>8Z6Ju3aZw&q=-j#sGY)g`QW zh>T<&K5q4=V{GxpsQ4SON$4@{U66~|<#Q@SYbMf8G5kPus|#$YkG&&u4{T<&A+-l` zjua8s(yXSM9oRU|akWSDu8V3)n|d7lwxQ!HkK`dCy(lab9jVqNfXYDy2sK!#7@) zVzDHMpqn8&9f@^aAIHF}a-VY@9$F*WzTr7?9g>OTiMN4U!>V@AszXvGT$2``poEJ=|A2`n$ z9jhwV;wLyQht6<##dKDeq!l4T#(nFSw7F6`Df`cI<&58Da(+=ZF@`(}>a;uN3=83< zI2Z%o`x??Kf=&K28o z#!lW(=}Hr`)Vb1AJ=a3ftuJmNySI!b!$uUcovNe171qb$Ssva6)1 z&UkUu;~for`TJS?6_dnT47!e$3ftY-ui6nvC73A50QwsGr(e^p^ziQLBOv7M;5QYI zb8~HfXe7FfT*ChVxY|xf%m~S?9Zp&EUt`aW7T1yaI~Bt`F}ua(GpNr!4PK3iT&m&J z0C#ogy>@>ZJQCgt_=$gI}>7;a(WS3O9G;NsvQ079%_}o7y+HQ z>JLL&aGyO@SOK@VI3!ld^*H3WOcb`%EW~7ixO5+dSdKioNj~u>80bKzhzxC&Y!kt5 z*rkdle0371-5Kl6U6R=6YT6ef3Jc*>0l){GdeRaZ%YaVaFnST|N-^duY{%4erWtnt zI<|RH#yvT#oz}%$LcG{mNfm`pZgN*GJtP{*90B66cs+SO~L><^pgnQPD zL_S;eIm^31t0@4MAH|MMV_n0vlDJ}i_o({URe2Yb!9m^c^{PK&-60`B2d)QGO+9R1 zv%bb1o|MuIwsJWDe-&(5Xre`3h|U}DXN-H+{-37q3ZyplBLFY+u9DA3BqL!+&vDLc zq6<>JowPXkv=uO}W8e<`NzDhtT1QF zwPE3?vuK}c)OO%bqYD}7#a)tGoE2&)>{?43Ux&Ia%19LIvw$53{IgF(?_MY3eNiR3 znb0RafbU(8h-JRj?hKNRN(oBGY+!4}-l(b-^;_i;l^H80%=;k9f?~k9}vMsfVB9#5zr>7O! z{0Y^xeMb6E3V4DvO*d4;DR%z=dfrlgRvy)r@t@%)vG8NX(&>7cGulXe%UiS`B*=OY zYl?VC*~$p-hBjAR%&q;VCyA65B=tD{RW6%!5>XyO7~qkbcl!sCuBntfX!A>;L=O+=#Oq0UD=Y9mdx zW2f82v$eLrib<80O_B!Z(AUx52>fOCc&#l<2g9k{Ivn<|ku=>&q@U+u^Bm_D?SBn5 zCx%OZEr$#TCmed$4k9frPg@6CGj_T9G2yQeL8@3ayv&ROf`>Rb^sLLYf-OPGLFG3) zn}83cc$b7cRPZ{MkjW9q!nO$>wcP3cB$HFNKfN-G5hB;CR4TTOpWZBzYaVOyL&Y&WrjushEJHFdai8~it~S9FX=wosk;m4l zOLE$U?31=P$WC%QX0&ZlBz7`4m(U9R6A4Z4l%<6(ATRQGtX?@($$w{REFDvU5Dvi4WVQhT&n^y zPaultZKgqj12FCm20oRq1>yxDXCb{fu9)qigK3>MoZF>R%be$N&j90!+puPm1aq{r zcRtn2TV4QmmH-@JcP6(j?v#PF{oYTZtrNJlM^9}bQH9zEOoP-_xEMPfpl=7}4b5TO z-4B;1p1jr6oJPh)BWMFBJk{(?-*ajf+JG#BEZm;8rEj&>fD8#IXdT62L2$&4r7%AC z9E#Ypx=>Vu!8J(EPockQwc}oJz;dIws}d;M3aA)40CQBWY-0FRHe3%{lqP}@}%?>-oj5) zl%CC9oD@GMGnL?qsd1->$pSU!sV9-`iU7_)F~8}Y1>P~8y^ngUbpUafUzqcfYo2ED zXDM^1#;VGL3_H~s;oQ4-Hy9g8u7dV3cNI8c>D*Ra+fbY_a0fWzxtXT>6>aUlRSSUK z*!9h9+FR`kNXNE+oo5Ldl}ds(@#sx#Y2{>G4eOs#!8IC)zh`VhsM;5EU?1;Rg5f|M zug!y=DPU01hTFRs1DqOHk8@?V6~{R}4L+Kgx7eK~9%c?Uj;g$7hmaWx;{!d8MNwOj ztW=}!St4gULEY-j-k~~pWn#xC9Xe*TZKGyYG5`VOkZM_NcLpG29+^EW zHjNSa^AzGjr+3YafNK03Qv`BPIjo2QR!z#I9DP0OQrwa<4l~I5*B>$TvZ&q5sUd<@ z&In`l=hCEiX;*NScXRTws0_>r+rzF2`ufyUOSEs`u{j6R)|{kdqjH_x$7|t>HvU2F z?O8VtPVPt_P6cUPmUqZwm(PAGkxm#dB#ivs39R|KV-{h7!6O8pN=I;mb_WNu%=yne)F5Gj z11m$4%v9$C@}&hv(YNubDl4Nbq&eC^3ObSNR$z@!A27(r9jdf01CH6~D*dkHIl&`8 zjb|ow(~XNzpow;ZGmh1M2+7)6K*`1c{c5~8`@Ij+wJoAx-zX=HEG*Cp=DVY0CXJ(TBx#~H?YS*1zfjqO5h$2Ngb(N zu0?%|(MF(+s?v|;R^TCBcBwe_s?hBx3fsBPSG8Y5<)ZF2>!GxjoHWy5A>ngQI66}40Yn4!ez^G&f6F{RXhQ-eeC?!g-+_GSjIV5D7go4Me2YtgdYBH+_@_@jNf%$+LNxnnVKQ|}&RxPWtm%{BMLxMB*oUjG1LzXxZ0-&9QCMkgN9J0eqqIEuY0ow z$n9ZhcWnR$U%Gk&T2SIL2j1W*Va-&6G-hT1DC%n6v|(KGcl17lR&^E4De7q;5wT-} zNB|6DHG18EU@*Dup7lZ{EOxgG(S1j~Xrw#9&ngHfJOFXpxn1qC(;dwSLrfO~C5{gq zX0%ZVIXr(+-l;>CQgebjW2S3D!Ib2DtPcR5)GJ=rI=Wo7ZxXY7tHI}RJYu!&qK%kH z1~I_EP4y1RjOLR^_$=|}ZFhx|eDJ!V} zN~4Sc!Odw~MofGVN8PP$pm`#msirQX_LlfNM1n^_&hR~J8^+N~bA2l$ahPIJx3LGX zuCo4bBHeQ6hB(Ux+m=yWKB;vz)vz<7u$jPST#g5N`CP_N+gqVAZcgW&Yua;O-$`(v zC0WYt zt3vr-G0bZ4J;1kxMo||fv5cPl)YvNCc2B(L7C$Vw@BoOL4EYgCkn`O2cYf&(6F8sM2H0S@ju0aPZwd1P(Qc8)+a zkm@D~!31YLd)D#MSm%;YQPMMsm9hip1of*kYY!4K2FidrJY(rqJmi$CtAWo$)ccxS z>r|33+kwxZ{&fv0C3Z|xT8_8ZXJfcXRfkL-D`!sEC0Ue6yMqI{nDnk)V=%4)0tY!1 zqfwGEz&sueb54X_sU1+N;?>#eb{hWxl>sj>A1*#c+()HuXxiiCN*M~04(Sg=>5B3D zZDgFGU8Ba@T(*QM!NWL_kdL*4Ch_e^cU9<}CFR(I%q4LY9E zH;%`ocpJs`mYS+Y>P`*|5s(M1eRJV0YfU^4MR=w28VANZHDqOw8TaT{{ZXLg;h&M)aS1#)s30zUL}xUgB%5AjAZ1u z0=(x~GTX^-Yvq(I%0N(d*F`RgHk~Z98^&Z)jh#WyTDNUy4yProjDOX?&;HW-Qk{Q) z-ZZ&V8?d=b-*UR!u`2z%>EF9 zQy)=$S^b?JMjDys%>r-1M=55Cy_5T10uN#?h(1YL7 zu0a`)smN97(~8y!qX{xwNQA8Hpp%{lrE9?o?ral}am`kSA%)K;2aTj0`&OO3qb}Yu zJxzB-XmZQYlG~LT^~h7fts7<`#s+=QCZM-X%bnRHJxA+Ol42-9${yIQY+)|N?Zkqh zhEu}|9YK%)`+@8SdaRP7F)Q-($v(9pkc@O-2h3Nws1xvLcQ_Yx|6cdmmbCx7AncPM+|*2pT?g)o{&erP!$t{Avnce z)x1Ne={BrceAiKupl~b7wf_Jb-D;AQP-Rv)NYG#b??P_&NaC+v6qTDb^?wstTQrFh zHO!#r3cbB^Tz0kMR=bsBnO<1f5|BVL0rV!F=195wRI6?3iOD|IN^Nr2PF>dO7EVBX zb6Uk7HC#;PqAo`)^PqES4Wt?W09W@*4*9Ix*{tCiQ65{6$DO#Yb5`+`jvYor0DgYi zt}jsWMa9IKFP`0cRovrCyE;vCTuG&MN8OGXpXupbb^XxfIZeT8J)J2Amv4?s;V%1q_8 z0`Zg1Dx2ZKUB5qwF%_*>(P9b-?pc*-~u1^zY9D@{qo-4NoQgS=9% zZz9P9kXsxdaad7481Ds0;=e+^B=|o^_~+njFBWMjADu0zl5K;dcL&^8#hxYje{rQ< zy2}>U4S-Z}_}4vpNv>$E3#VU|@=tS(W4jIaPCFWKV89mRjNi?xLOx-;IL~U~tSp)CPylw4I#pGSo_`Tu75hf`s%<{v*TddSwvt>ZxozrInE}Q})YsJ?0Q?B|I>n{Nq`NK1 z<~JPuDu?_Oli^HP{sz%Jccqs}T)&pfxk>0ftBPHzfsk;dlaPCg+0*aciZcem94mTy)uj53OGCV|)I8D2TxTCz zzXih;%VQk|*6Un_o#E=l4Y}G$$ib~EeL)7+3^p$$uOhVAm#Npobff@;;PpApYFb^Q z73ITZa0W-#xT`%)T0&K@n|Zu?HgtubCN2Iv27JJPyErTB~|OpdgM11Rm8F+dQyPkU_xR zRqn5YE1)W%{GrEso?)oc%J&;P zYfFqN2up2jVxJ_3Vg-HbPds!!^???o!AQtX`-Lo;(&T)_bH@UkeF@OemiIDb3=mEU z?d?=$)D%cd9uGn9>sgXsl-!}Vvz&~cqt>$LzsJkw{D5^QB-BbnOH-kJMLMb3jCZS0 z-kD2{!*SqawQzH4*l(1L$BY5T)~xAT+cyMmlyQ?;w{hE3)2$~_7tG4aIKv)IST}xP z#tP(Q4%N#+sttToeW1dZ?W{o&*Sp0)3 zIU~}o`PmpFA$>bmG#49`eB3Qsg6+3%UzZ~s_pMh}%-*)KaIj_FoM7^C{V9s!Q00i{ zimUd5kDb60zcDoo*FI>-g7r4+phhg&X_83{_-| z#&AY*axgnpu%rwDyPn;v8Cf0F;%HhG>NAd<~FxS`IS12*@C9 z82tU}R8W}R_s%+siBmFXx1sf`NTuAn0lT0b!0(ES*wrhsh>Af9q-d^TiVRHlOg5L1ad_+_5{Fxn4SsgQN*Q)AbgoooO8ewsR$BA%;j0L&Nw_(hKuAWg=3A`^!BNvg=BISF|~N^F++M-#!>E8+FmiW zLcVfCb;UeH+f?VCfC2i|u@G`b?Bf{r9+a}C=geS+=zGzk(HKb?#?TZ}PT~$vwN$yc z+UF~{k9yj8ixoVm-Sr=-Q1sTsyJ!?bAE3|?0 zo}QTZrMHQrRVjiAAfCWfyFEe|S`pg75g#O=QHs>HKmw@w_YQDrw&{_AIX?V@>sPJD z*vhc?+&k7S+1%`ebtJYVjlg3kspv&(*+dzD%7Vj;{82eq~i& zgDNmZW}V&9*p-&0=)*bt%m_Fwj+L)yf+hfSj(2y@xT+TIm5g*G*9b51%N7RbR%h0aIoSMAFAWlIJmjIXUyw2%ZVwUjZyJw`=cw>w=!e8)NIz^_J{ zIHv5jHLL4k@cM zV#0Dm0NYT4Mh7F(wb6h@YRN;fOsTr6b$7pblu z*Y>;kd#QMe+d%OB#;M}HTIs}a+i5n1mPS5>u}R9x=5BCHR(js4BWjaOBAMh!Wb(F{ z_Nw4=Gv2um7T>L%v`M%lX`P_r;^{)^3 zpM7_w>en;*MN}rn1o9i&zDpB7Z8>s^8b4C5sp4B`r!qW_N#R!<=DEwi90~1YgClCN z+<52luQt`ZOLeK;k1=)t#X##<^h;wk)KKg!@?jAba$UOsJ!^^(x5n*b(xVqWj`qeu zcWX0TFc7#KS&29wO5wHn?IH7$*5FEtalt<;cLu(=u+)AAd=JoUYD0n}`%`6&chBRO7sap}pXAa2}dY0;I8nr1>N=e@%61azkPBWNJw2Z2#W-e}5z za60F$Iyt3cV<0MLA*-@WO%Ee|StKe`InO;Rc<{>tAa`Sw*$s0=;-^Dsri42 zd)6&XcrA?{*#2R6oCp&gzAE`C;ufo3+>lSwq z{h|%F`*6VEZEnLA;Nqm(c1O|Ro7(5A$KyX0XqORvufwoQX(EWl!E`bN9Z6dCUj^!# zM!N&t8&9#{0GQkI^PaVHz+M>Az9Z;u4dgcW^Mw1Q@ae~Fbj5MLDDdKZE!Cou8Ffu2 z*`!nrcs|o^+3C+!0=eT!$~@87+ErIOr!CKDOW3Vol`fTco_7qIj?VhnF%hyV<0O;T zsOa5 z9QXrKj?UmlEMgY{k#e#!oZ`L~f;N#C1cxiTYY$&a{WJK%;ilHU8|$`~HtiezfF#f-%%rxtIJhT@N=GD7PL|Wi`1fati02q*O_7`^77`HV+lM zb8F@&$_~-X9N^V4ZdHa`1rOfFe_HhxnzMHseK2eMiYB|6=Fg{WT1J212krj=tilqdy|r z&eD*0Z<~>v3bb4_JGugR$gIS64gf$`8<_VMJIIRyZf&^E257dH6_At8Wn}=a!ZXc8 z*CtmA#JR=-j+v@2aKVdo{_=yGvuf;5DVFqJzgo$rcT$PdX(MXnVoYOwW0sa@YZS0rK#0Ln@wh8-n#t6B zV4_n8ny|&m2R(k3=bkC}ffk!#Ec4yR2vi|_(~^G*@oiJ%8c96iz1h2sNz^#(M zyw3*}jd$gx_nyJy9~XVKr_;2MZYNdC9Dg%jb9b!YTdbeDAc2-*bIxmmm*R!hv@^wG zOfpZ8GEhEaS+`y~mN-LACUe&v>vXJ-5#CzJ?QS*ez*rT0H_l6co|Tz@;w|xvxeh^W z4_e^wejvT%hiTZOjyuv@c$F^X%)o8#4|-Q@YAn~EUJ^4SHtZbj^v!2Ybgs>o+s|WF zu9^vyG;%8Qou;v-n4@hOBzN_z8qu0_UX8_%Ur|+Lyeu1&yBNtms)v}tNo*Q75JCIg zXK13sxipsm42*p<)|g1(jy(k%S9URz)EY)3%^-~N)OV(=E8j*_nliu+q~@|OqF~$% z9PmYNk+hOd4{TLSn_}fhcK7K*)J84cvRy9aAe9*)de&r-x{w)2HK%o9C9|0$9S%tK zt2S}LsxH&=&FSwz%tdBW1`pPl?#keUf<5b@o5R}yY?a4)&6`ai|NpwP6fNOwrRsD+N;M(?Ct&n-1sj^jkOzjEu=sRV!Uqj z&qH6SnlFYljV9PfV{066{{XYjX`UqTR*mA#9^*^Y^!RQp=3T6Xa7Va3jYVuVD$(U< zeF~MS%bMu??eLF>2ieh*;dYX78EoL!sQ6dG)|T=at`~n91J<@YS^G2G{4&-J=71&C zbZJ|5*$HQdo`=`#Q`n&p1(W1u2dT!Jev@u%Q-iZnrkCDxlPTN{#(u$9l^1$?V%e0*Q8T}^2IbO|Sv zyLt_$2lcP4J`w0I;g1LE7dMKqLa;NFpWzBgCpGjLTqO%w;Lg39i%)a$w#nKkHb_sM z8!|8--cnSL%vPPWggTZuEIafSmuY2yBy#)*7)<^ADAJFzhPYT(ES=%CN^?-K(M%NH0KXAzEpaZ$&53bPVhur<=OMlQ!s9q!4AE;`_2 zn$WYYEfe zP&P{=X{u%sl1V3_Jt=c^3p3DS)RdJ+ZgZbnvu~)97z30! z1XmSlf3cQLXg?|vpZDO1d$Qu4w*b;8jkApe5ZP;7~Sn$Yg-}Q*oSfG5Hvq-Md4s;*GxV(P)vP~fWp;RC+wJ*+ zkj!{2F;4q2W4L|u$0x06$!uAlfZvZwQ4UTqli!Y&<8#>ho=cSy(_%OWpy|-(>rpg8 z!6kO@>sreLNx>(cea%$4w*-!GdK^=XwA9nt-qtakZ6|K!40%4LnYFO&OJla<(yv`a z2p?RKPkPV0k#}_=xWF8ad)Gu~bPko4g=@3EGswW_1FdCCHY6t`WMoy_#xcZqXCtWx zt!7N%<7otAn(L+5;;RP5SK6Q+PIK0*LvqRj^b5!YX0ln%?Zf3imTE{v6_MI20l}s-DAdDy^@(5gFt;GsPiU=fk&uYR_y1Cm9qQ*l7Y_`GB z_o+p}ErM~J9z{j9V|MwD!g$Y6F-Oc4f_HI`#<^|WZcCv#k-WwPa7Q>jO*vJL0O~m; zo+_r|j56K20oJBfSyyuqqXRiTY8vVaSJ1MHi2?H#G281_@Cq&%1}6=UwN@nE9__;! z;~lEV$2e`kcckQR5_Cin_1<%znx=_M4uxDEq~rlmD~THo$s7agRulzX1_l2B+V-TG zs=Im?Ae2bC01c-J>f*H2)$6Jyk0LP4TRA;FD%30c zjF-+jo|&dwL`-UU&qAJtr-yO_xrWkmR~4*ao`x<~V5_STV&V=1Y|o3u>@zU>{Z>$Amf}?HgY=S%MpnY z^1{0k19Z(@5xlq=CZkXHxs+BwR&{vO>{VFV=(JS zE1I@QR#2tOWDl3Q_pOUITVNt~-%6a01UI%Gg>k$afz*eFtj2CZ`>oFC;OP za=0@Qx!%1MPF+t5wqqStG;dGhYb_St?x!!YcwoZ-ekY}Twegqs-PSE$_eAhZL1z$s zuc-wN`0fyq$JV(|+FRpw)RVV{beW0(Gk0*OmOtDdO8KDkTBuy}-D;B6vrk>|9;xD; zNw0N%Lg!PvbC#OsLhbt3=#Tsoi{V5c+M4ggO-9{Y`#pZerxs87YUAf{eTD^odU#jE z8i$H?m^AG+)?3TTm@IKbyyWyX`@Qfx;Z#2dehc_(!j{pjH#YW*J>0+Z(&5*0=jeF+ zE6L3(`x;!a-JMt}UfQm^BHxLutf0NRdDjw7-eFLAC)E4b&Yu>%4JG-xo)Sz+E=K%i z)w`V6uz1^ExV3p2_T3_5_tkP$$4<57TF;Mk`w7F}OoldH&acS|y)j=K3XUr0vFy~P zW5l1~MZKiL>7s4Kmyj_#MtUFqwRAoR(d@hzr0ZTWzKlsGiyIp?kp|N{0wdu1b*%3f zd{mC}P?{(TvN7 z(2Uc1*z$Sx9ZTXbiSF+%WowD&k))ndGJct=H*I&}$1MZ81vm_(f)Ay4{s7W{u)H)0 zM0@MvTXOXZJ63;>wf#F!wHC{547YA_z;aM}n&{?=lBX4PcjEC9NzJmy!~Xz`R|#~m zPR1EgNGt~usp_V=kBGWur}mm%S|W(2JOpfo&nCF#)LKnINRg~c5AfCPPf&Y{WL?>e zbB{{hQI#sHRP;}De4Zy0?c&t+B|1p6OceyM&pm}!lH7TQG3k&y(QSM7t5ST@tq|Zb z&hKiuWiXN%EhC%YHPyQ<=>x|}jf_b$h%Upui|rnR>W4#XG?dsfby<9q!kDG**u zD>2Slx)JGF77^}*EX(_#Hy%1w-}p^DBjLCeH9)SyP*no%W?uEilAO6zZ|GEIDt`Ah zjmsa6`u>2?-Pmi=Sl#D1fkJKJ9PBx*kZu&THMm(&df&o*hXpdv+zt$Uy|LJ;COyG7aPdf*U1G z2<1YSCnuf0l_M3EIsn}de0>deB%8I&TkB$Y;YLtc6jRVIHK%J68L$D`2PL|J>sj{E z?Njp(2ORbK*5#;Kn63z5ypvrq@-dMjtFAVNE6}!i9+f|kQ3xyZDd%-bZ3C%Xl~4iT ze-&9sN0dMX%AT3sU9s54*E85GYqXu*@LHg_&i6eZ(>$!rwB z8P7`SNXhG?D9R4tNl>722V+&G3-aWL2aY>c`P>k}v&hKE=~UeUC}zVFbMl|(TS6(A zw`~YZ6x)DLW0O^$W?*`dJ072fO?5KFbDio2cCQ51E!66x01_3rIpkKnx71wr*qNqg zk+!zbPXyJgNdg=@X=T{)S0!0enF*p^JqkT=3^xWZEb_BVx#>JpR`QHn3J4~wbeyEAPhk&gXqQYnSXZX^yk=aXDaQXRncA6~V$q~2wK zW5+?B-qk7gBh=nh-}8)|oM6(3@DE)5YDj@4Pw<}Jl{3Y$f`ENNswZto0_|Mjjos4E&}Nt8Z&(?T-hL7oSvYUsQ<;z@in zs6%j!-)D9SEMVgU*0BU2k~7Ub##$pA5P0wW>Q=0oM(Fzs!CLe)TElk)!IXehp0)IM z!(WIk8G$_CEW`%{<0ij9{s{QYEX|}(H}4naP3PsseJA1j+4RZL!;+^51B%j7)7?Dg z+Lf92MuqW;`@@n(%&m2&%0XO?*UqhP<-7jq zj57E7R%W5B>OKVVAbUw1+dJ9cdGnNO$WjHE%n&(1hN~s zjkBu=;@h+Wzuv}iUL*0x<2{e;Wv5&Ca@R+<)jU^nrdX`*vV6Rs^|IrhPeEKbj5pS8 z&9XiG207teq_=4L!{BGbjSs^b1Kw)aDQl-$jLUgD1VY{NO>>{LzwK>lru;7Pou`Hh zLt!3^JV|`x5hyd~3M_+2dv)7_vkj&%FP)uwaf)8rZmV7AWa57GFQ5_D)D9v4L zSQjiGEW}~D=k%vZd%-G49C~qB*Ea#3TX|dz=hmq{rO(QH{MEXV$kol&zmg^+j=g;; z<4`VDnStklo-3Re${eoa^9%xd(;HCv!3qkf?r}qs+?1?!E2%U{cay13>9#t|PFIb{Pf~vEbozd@BwyWyGBG#i-^@+qQ*nLE~`m zTt%Lu@AGdC-Ff2`cxvq7TOd9;!Qj#DIvOf%>UIl%u&{{d2a!!}O;jvDOxqd2L!6Sl z@l$=VvUagioZ}o;POhf@%KDl&S7Q^3mFM4HVo|?nq;?b_-+V4Fg=A) zxtOsh%p;yqb{@4p(Y=av(nF<{LqX)}j8=AY^17 z=QU4PemPcl z-MxtD0-RSBWpG4C=If8W(zfkq+5+IH0DRqzWSUxB*+a52O`9nr0PXLdzmIwfh~z31 zGh>sUm7>udpfTuix4jZZdZ+XqDy$CX?#HEN+=%|}c9Y(;CEo9Y(4K;*+#RE7!8z^TyJ1sfj;HQrmT2%XgIRcAY|v0?aej0 z+@yU4KHWUCfWeo)y-v_|Dh>y?O3qR_IUCWG9y|bdbDo2}ShBV_IOE$DVmm+?SRcm~ zcG}$}1OiKrPZ+6k^Eu@aBC-I3!+X`ZEP-qy1@$=VR&A_#+~au913fEB*4VfJ4ZNHW zK~r?}Gq=5FQ-;L`NIkF{(ya&!NUGTiah4US6^a78kYTvTsi~gZZUV$SymYLkC9&BC z(U#W#03cEO!ZUz-)mbeFkd#0WADchYw~ec^kgmN7(e7Z$ z5Ov%!l6uq(ODeZa^&K%<(m)v)?D=~h^_wNTdMR=v?FUrQI}F)$d0Y%v+nQYuJ} z@)Y9)WFDC`c{xS>-q#(+y-Klc+mpG^N?IaQWU!;NAm9vVj@4~ZlmsAc9FhlmY%mg3 z@z1Xnptj_$0-WcAo`cq~aysMOfIuB{ij{F8SjkW`%O2De&T+$Z$mo8xJWvd)s38gH z!>v-ZtZNoY0{o?v0(xyc3{}`il1s+9>ON7NA4)A^Rsg9W9?UC77!)$F0eR&5QFd;n z%dtiU`S?Hx=Q+(>F_Dd=v0?Xs;2z?h@PTr`1I8QW9jb?owZY-P56Ly5GG4jD06s{^ za((N%l{r*u$380+3^hJ!J$oHBhKTbj`LaiBt;lIxX~sP&*zm!U7h7#c)_Ig=BWA$% zubUIb`i;%|%O%vT@?bvZ$-wPe_8vLDigkGI8C_0r8`8aK(2RN?8;H#7)s^Dxk45pG ztFL%z40l>}xu_q_$d)E&yilvevGF^eR^M>i|T^yb<9wpE&Z1n@Vq`^X`ED!$x zUc572ntcycAsnKv;L#3*S3-j5k2Te)CwWPo?Z?Dh`)iCP>wbM|B>10tNZoPrXCY5o z;qGoN7AWOIy^3eljOL##dks{my0h04;$6ZhB7UO@f9E($hn+HDJ^r?TeAwiw(oYMAidbA$aqw0GN&%`UHQRT|2af}ZB=ANGr z?#d#G2;-BUbL(C?CaSxGdBpLIdQld*MnlM~x#FKBdLeVoFNpS|@d|frHNy}SfO)~G zzu`ZX*b^eYc^Uq-<7upu+#kk+tjajw#ZR(Zq#n|L%+F?r;u|3$=g#lpUWTkiX4j+o@SQdsl`xh_HE(;Bm(os9(jb2GJ%#9<^MFYhqNUx}Qba`1aC3Rkb4z z00SxHA57PGq)Bam6mr9L71l-zBkuZF#WU;vXa{iw9_PJm_*=y~t)k3CPIs5L(s>0StdE+;YG>Tab{*o>ljXWqVikKz^V zo?Me%8Ks3bq4hn@S8Z-hYf%j>gr27-H7T~q<+9xO&kXDL-YwLA(SAhml{kcOtK4F$ zd|~*Qo*3}8!&_XRJjJ#!2N~(t+PU2aS6fXXWQtZ!2e&ohpBy}0F1M=-VpK;E+p&M0 zTUOX2`JK-$x{`fTc`m1sq?%SP?%a}1cHam73HX!aAB*igKjG~@YwOwFSNCa^jY;L3 z&y2eVmVnH zVknp2BxbdYZ60ZC6P@I#$A8H3KiRYPW$@0E@o~HhqO#s6g_UnSQ>>hBxw_z`x*p08 zTzXgA`m#eWoC65TbRhSynEwFanl`MT2sK|4>ZOje;!DXd?q`(bxGr(erF{Y7eL^_Q zk|`3#!0mP9d)L8cmHn+(2q*zZ37QC zDA6eeP|xB^KRA0sb4E57k|vkVryB%ke$ z*#rUi7M=VOKZ!C8T6#8+}y5%X#JjnI1a!{z0jlTz*Yp)S%7KS`E zy_0zaaszGP*UmcJvP~n&GwztPZgP6_(!PiAeY~xIs_J%fmV0|vkRT&1k<%UP<~?Up zXP!ZTs#%WS;OCJ~1s6HVnPv?rSZo&-_L3w?^UEu3+1T*Va z#%@rb!y~0__^pI-f}m~PjMuMGT5*SSJOh5=b16J(BkS6jQVeOiOMnYm! z#u)dlnPCi>+!PLj6y{$^{z!$?)?s5V)yEKKAqtCyl>)|^cb!m zOM-M8CYECYEw41Fu^Pm7U3 z9^u(a9iyG6wS5ur`^6q5@LrDh(pt#`?-`B=*|GBxjGX#ZpRsm_rKYy=YVdi=()ndu zk1UbY*T4SQKM$ht*M|H#tZ4CW(_?0~yD{{Pw<_)IdRGF9ty`4!qY2^Zsb6#DnA6A- zd9rzvNX;a&6OztONi?2dkdOvPKuGF+Y5XSa5E0Mb1FyY87Ys)%Nd6l4+)`FJ)3dmN znB%EnFh(lGJNA`G%PRH)ltQc(80788PIFVo3t;jvcq~s}rE{%UnX9<_FP(!IP!A+y zk?matsOCM`IV7AK$8@QF$vsO}$R1Z5Z6mLG zv>#+_yoMYA02%eoHW9Kdz%B{E#YSh_87{2AoNXBSYq}S)7fW_kyTgUslpy5s)K+w} zF=j@>=LJe&kH)laz;Jf9&wO>Pxue26?&x{rt#v^qxtr5eR%y30so<(C`$PVIiz9+e_)W8Va4)~spzOp^{5aAS(u zIxAbM?p$LWRajR>5~oa@@x?(qkjFSt)1LLKdJ-a3eeSr&O3S$c`haoQH7upMpDtLQ z!1t&?Juov?if4W}%|o+=;~DC6N1P@UoPRnt5#4B$ zHQK74SnW#)3}kbPX^|y#P@c%ZRSp}T z-Kk=;e1gN|=NYXA8|67tp;+YOsi_tuBw!Jb){V6@PQ@!&_DlD74D_v-0oVY-r>Lre z91t;(4{r5jHF}~ zVp`pcxZW&+4`v+&7PBoj(N{y%#pD}H{`p5kTOmsZ9eBwCxI3{XhpRTwRA)H$uHQ+y zTj*9`dUY73{t3t9Jq~$R?^4n&*7iJden$O*09!NoOQ zp?{PX$;K<1@NTLEi5cKvaNRktR`B1$tyji(DISq%_mfNaVug1%N{2NSc{5iRvN`r~ zEIW{{;qTJ6^bKfU#pFAU=y*Nb+OVe6r_!$GwY!Q)CXJaHB~q*yb;zu5ww*IpUD*i4 zVEfeQ)zMVs)3-y=uJ*cy13aEH(z0g+w(P46=N;=-$wl>|&Yegk?Z*bH$!5F4sU>+V zao^U5D`<6cC#jvhmnC-r+i}fBxtHbY3CSeYwz1om8DKdEqL$NWW+%&RbMH{t)H{`o zgf}@Lcg;m4rcKxYWAv*A+>ww8=N!{g$%Kah?L6ldle$+lQM(x&vJ}G(I}uuz&H~1y z6VD`ds_@&L%yG3q{LNd2ClUo8QV*qJChT-ZDA~7|u)xS3o$*_Cm!B+UNnCy5-nrXU zZ!BPPeesIhvH8aJ1gEYrc&=GblT)rVlRA4#{K=ioyQWCywPU#`dJw2M+%gSwG0JyF z+qhAR(v8e<77B~k^D!u;Zhrs9$GeM?di=>iT1hPcN5>z ztlOw^j80erPDd0#sR6B!)_6>*<${{USv(1%^4_(;nR zewCyq<%vhRX~7314#uiWY_cI@4_}+N z71>T!TC;|5zK1VymB0v~`0j*o!A<23`X&PdKrQVng(rYfo3^0s)-b5&-5+l|WEU;^Zf=iaXO zGxl!!8EF7O02{Y)&0K&502Kj;%bfJ58*{ymbCZl>rGgFu0rK?(jMg(Yj4bR}idRPxz%lKC&{YeYbqnS(3b^Zz_4EBtu!LQ-F{Jt91eGLrJPOIX z`IxXc0Of|>Ptexo>c$Qgat}Ce^_z6A>yi#Y$Uu0lW1;BMrE{O2d~h2qynq(7=gB7+ z1pC&l+&?P?%H(o$(y3f3upz>d00oCy(lX`H^=aYnxruWV7X%PldJ3a*hap&nBy{gv zS0XeU_Z_*&P%;H&&a3x!lEnS&bgr0A;;V*MGhPA|jDW!4W|)z)9fV|pImKFF5Mw+q zKBqM3pxO=r$nJaBd}n2;^BBB6t~%Zv#yICccQt-HH<3o(amLo~Ot*{$O~WnM*0kdr z*>iwMBacs7Ii2)AcBDB`1U99%khoPOW4NsgXj{vC5IG!TrH(Q|Q_2o^4&tuc4fqO6 zMg~dSiqFlQ6Sq);*Uc z9JRUC2&Jkq&9eeAfd2r*bIA1Km&*A}OaneM$6?;IUeVkJ11E2;4_X$`hx@xgAd}Pq z?^53~vo?ogE6MW8y7b2&R97(W+$`#+n(T_1y%bjVG8Zb79ch`rS9JS z3u;YR#1L=bsZcs&oY57p-pUe3W7id`ZB&OUO5>@=T8=ndc-xG7j=t2JR|J_HQ8ANg zCj$+G&086E01Tdbe=1asqU0x2lkO_VlrpSN;16H%td5kLAxm|L;Ejiz_vuqXAMbZ6 z^cf!crZh!lFR->r00W%W>m>6^WNrWuPI>#y=7(?Dgr>pYf>FNy0(7k z9sARC_*F;E(DWqs?N;?s_G=kkNn_bp)}1uxH56+)k);PYJrT(Gm&R~u7j0)8izVX_ zLT%CT<9*@(02CcU@mLujED1cH{{U5X{v+`e zQ`qTRl1P$8B6I-ZJ7T_~l_f?tTc4lfF%repb8k+EmTNkDY1)jjf>-9?`%=Rv?!g~; za2wXQylWJ5?7e`3vMzWT3Vkb@hC?6+g2S-ly1dRC=xynD>>Ma;9OoqTu7BbhE69?e zIc}phZ6+4vuml`>^sJu|NG_qtegMZOnwO~7r!xi9pb@#;y|YkE0c@!t9%)?pP6!zk z$z%+;3*V`yYiMYl#u*A{4T>7&f{f&hcJENI1Y`r&n8zca$n~eP4N3gMq-P`n-i5l! z8R^tjQ!W7quc)RMBm>_$q&ryA8i3DSFdZq6d`KZ&k4mAu^(UWSS`>qVa&b?fSh}}T z44ucGywkqg!AH%z9nDc^IW&2MCu2xfWyZdFSmfj$)eN!&fwe_eW+VfgQf}aIPADCT zizZZbu7=WY?5#91w&`vGP=C6;&2yH~?wNCw>zcPc$-0zrgi*CddsBN^irSq8mGck@ zIRmA4UJ+llTn)n@^!Kkd(~)I$8Nl|hOYr6`?Z(~+9Fy9fiCoS{ajR=74xUhg5;Ver z$3Nj;J?pnGsOz%Ho!gtBuTAluu(rBeD#*aFBOcY}dK67_sTK-djyS2+$ZFA7XWk$1 zOOM(9A0PZnJ}T8MeEl~>Rhdz_Up)QK%NehwKj5+cHj_d9o-_{*Lgfy>tfEL2vHQ4` zz6kWrE7<=4;Ge$=7vZPCJsw$L@^7_e7jteOF$eC~$zSkVyYkxK!ksy?(QUi9E896y zTh?~>S43xqPD#!6W~b~|@m?(#;NFpCa;#D$5s1)Ws08Dl=Dmww@!hVYr!>~Li7DhX zQT(NSh_4U*ko*s6sC+Q7wYemTHps5Y_X#}nUb*8h+1l$$)2=lQCsZ-X{Y##hxsJ;iO+IERIQ&a`eZcuOrv>Cs`S7=2=xTSSxY`T=7)8 z-kGahTU}Ys0Uvz^QGxCop{_D(3(LnP$&YyIBP9Mb>C)2Xoarw!nehjS8dhcVS7Mxu zb@~%f=uIW$>`9PAD&j>0KQFkhxO_KTh7(9uRdK*5S2a@OMY_>iNZ|xR20@Gy)7H9d zqJ*6HISD4!v|HmXmBYkiKPJ}3MPOWLHXb39$h?g$FWrgrmwlV>Xr!DMK0Xi{RBRmy9N{VuH+vU*Swd$>PI88^vx|WlyeT?8b5LQh5 zq#lNk6gt~O6b$Io0y0qNHDg)TZZ1%nC1+(E5_?xOVp~zX4D1Ri&&(^wej!7d%MqwzBbikRQvgjZHEOh+m8L~>)(oAC%4e_nWfq%kr#Ol z(;r&+S5o+iZ>IRJ^Ix}UlWQ}w?(2@6`ikgrjk#B;rXDFTX*H`iJQ3kx;a?Bl-E_RP zm=;_B{C6YTzLV0m%_rk8!i{UfGPj=hmJE?dtGJ0k%8~RUzA%sCB)&4%HGA7v5&fg* zniK>A{WJ8%d(Z62;&$-Qi6dtN?1os-D)YFXPtLm{r3opfIYm{cD7ES8e7yyv@S(H0 zS2uR<(8!^1Lm?pkJXC>q9l?usBN)Yd5A9vxRPaZ~oqh{{lTOv6O-|e|8S^-N9^BWI z+u4L&qyV7c9Q76SmcH!yXw6#b4T=HI(~NVT{{Wp_hS+&yKfG>mame-*9s9Qz7R02a51md+L zMG@zc263J~xvtuANosR8Vax0 z1Kyk3$mN=AQl_P+yc&F)a3qm?4nXc}$^1T|{bB9%Wmn*WP1ho=rjHIz_=i9ASl#Co?pQSc71YnYWohmtrT=o>wFL92< zjN=*YQIWwtM^jH2b_bv|fdY~-l6q!~_7V`T^xd}tog878fuF*aRObVydYUXOc>YwH z9>^`XMIaz#gIT~UkzE)Ft4#c*(-BRC+Qwb1x}_v}|Gl6H6FCXSjC)y}}Va$7k$ z&H?F93^wlEc{!~4ro`D_x_RcLX+&U>cZgZY9^4i04kGe2%Tn?9YvfzyO#dp3i8??3natY*& zX1vDUU6cO+_32-sY2QO{#nvBcv`dK8VHc9UPu8+LEv+?#{!wGGjtD&~sI}XuY3&OT zaywTCs9QFjdh4`|9x9sbR9^8tT|k~QBJw*CRp)@I9CYdJR6G%@t@Xc=BZ9+#4R6gB zeqsounKJBVK)YNL0UfG&Wt!6B9YV?cyQrKxu;Anzii%|Nm~O}6S{hZD)nyj!-dSbg z&p>I%MrTsaC+ZjMuIcg9!5U_*3`;H4UnR~utco$uv9GJ4_*0=jfi*7;YPL~LX{bcW zIyeV#BEKyE0ALS^n*RX9kBfisjYV)phNgVKEzS_Q=ttJSSY*`Z@kW<5x|3~T0l$PtCG1G+&#hPHTV(n{{Z1F@4+97o+a>Y;xQU^(}_ejtiJ={kn% zi%m~Sp4uoexmrdTQTo@(b~o*3IOlFS_O9l`Q%n6krwrkGn&eI09de4b(Z<}{NucUM zMgkBSPCD1nUjhCv>b?TjtaTkKb%IUXB_#pM5rd5M;=BXIQoYI|l6ORKze?5cR;(hL zH8NuzaoVQ6DAbFLwqvC!MJBgL=?BLjgFY7c!SFj(_=n-EV{76K8WC}G8gjDd0OuU^ z=D$4k*j9Tqn>i{ok=)nNz5)HEej)rh@SdTeczaN@{>aoKD=n?e0q{u1?Dgqh6{*1T z+e#;p%Pa0@Yyp-hCb7fDRH>?R>9g_^SDTu9@9K1Z0lf3A3N8s?AM5X3J;jPMWFu#; zYtOzK%JAIArBnrNg-Op9>knl9X55BupFv7V#h$GnekVIEwmEN=M;NFjvE$`d1GafJ z)IFZ$A(S3)8z0W0HZB#uP}l%u)EmkPY;zB$1!Wxd$>$lNEV9jyr~}fvfu|Q=nKxtm z-_nvTF%XfBw6#cT2Rbaut{HKT#-&SNoR#HI1Y@Oa{{UugEP8XuIp&45DS^tbOjJo5 zL0GE<3m6Hv=57uu?X+24gpi}KJ?YWgC~`5L>%1T5SM8u1*p*TPbnjk$M4is+cj!qJ zTn2SG0|YOvYuiD%s67gR3v*Q9M2(Z?{o4NkGg@#acmp9wBe50c&2rkurB7YS64)We zSg|LMZ(6@;Y_4(}ws`4HfP$pp0(czutJZe>3@#UvKDEx?wr5gHp<>qEBXu8mvEwV= ztV<9i`D^n6cMy70lX8W@RpW!yVx@hhf|G`BNl}50)i%4h-ip>Uni9xLrqBj??@upGjtyveDcOSq#!2XECV@bFWOm#JKPv2m&UwQ^izz5jjFIza9Zght46cE|8R&Ws z#$)z?;BZpVp*^c?K3@!fhN``p4Y_~^9Ff|#OhA#8 zF{+$n)~npaLiu}wgWU8U)zKO0V?Sh`tjKFL+kuVG*Ko~IxwlqK00GAvc*pqG+?Ko* z#!tEVt3G(bpd%oIzy~?}D*2u4jg=VRV+P_D`BbX{cv8F?8W9@>bpz&lR<0Y+evT<8x;xjw=phPh+7wks^XNhCB>&lTj4&l&MTGW&o;; z_3K#oa14^l0V5~d>07A1k7kRp&0Jf8aItSSn|6&HA1*0wJoV5gxYo_p3w?lI62_|lEy zv^wfWE*B}!7$`CV`qNZx#@<2cR$c<@wv<3BhY0($*x zM$z&H6nnO79vhLpLn#290&8B*U6KHJLGuHOnW-dsGJ4qAu?1Lk13aGfy>AZo4y5h+ zb6Iw11|-}u-`cjJVxcw_2r+^ilj~fS9=AFvQj^@CHB*7G4mcokYGDX@4n9>pfKNe5 zXrz<#9ofOjtH~OY!GOR6k%N<1%3CCNs#esdw&N@B?^W*N2qY@GJ@%d}VMre_10-M! za%!Z-BvuMB*_YO;EKMlvW6B(>Yzw=&TB^}tm&gs!@x^J)Xi)A&41c@Qt1vqOz#I@V zGen|_gRw?fcY+Dy+tb#f^1vmE?QiybRk;z7a(3sYN2Nw^qjxIU!9KaEOQI{ET}=6v zSY!syae>Avx0b8BX(55g=Cr3qUzS2hT=f1~st*andY|EA(vwLQdyP4ek`4|yQaSq6 z<8Wf2oDq^p?^Vex${Rd#K&v+LsSXB9V2}q;D;Al&TDf5&!-3RihUi6TS;7!6%DD%y z>rq)@`T>k`Ta0^((})5@VO5nuIUeGeAqlgrbY$bvw4mXaNu>#dt1c$gxWm+0K+$Fs#?pX&B~U4l~79-NzUrtV@7M9=^3%N6b_V zdehvrAx!h0I*@8P2e0W?UNRI8SRT~`quY^4Wmd^8j?~6EH6*;8W15Sc9QL4SGI8u_ z;5Ko`N{=}Lo~_Tl0u+!q<2dU~-cJ;aFlbT8=9ug+QN=W5W1MEB;d;>!-s(TjDIi3p z{J3&H@!(_9mM(e4MJWbDj(sWduH*NxPo*1)o0?$S!IuEnbEU~E$M=9xD~8j@k`b7L zkJh?)bv7`pai-tKuSATRxd)4Ga{&y&i0N8?0Q@ZeGWd<5>8L+>cYPFU4p$m6|!aeu*Pygu5e!|wy@=($}p zQFvuwGl3xEC-A76ZjPIOEd0>+c%0vJmbso(%sK6v7|ZC>L;izoLk>fm4iGx%2zsrZbDB-J@{cf_7GlJJ-joRN@BZ?~_m zD=%E}EVnB0szo9{-dQ^Rb6m*2K4VE52-A)f*JU_K@3G4&%V?gH;Yn>Y_@KSi3~Hz{ zHxftF70rA^)-3&CRP}rQgYIard~$#!Y&^gEjoh zspgXGbC7>Z@s)kDWDMuIuCK!PY`01?z#vy9B9fB1-Gjt9%_j6d$oOTgE4F2klx-{( zyPEnZz}ov`bI8WgesYcSh4tpXO894bR4NeC@Gu7eoOQ25)&3=0>DFmy47;L24b+63 z9{69Sc(A*khuK1^sRGySJMp^v#FCE+_-<=h;!KN~nXw~h_(!HI;eQpTs%Lm7^Ca@v zpvFKXb^6u@t?>fp@8Tx6sZVml?HAHAC^#E4^8SLoGT+A%)5ZQtW})B#2K1PqlsH`#4CxD)C;KZyZ|$$0~N= z1`h|@iui-YkEUMSM|Eo&tct_u9mh;p)nBq-j1G?_oy;;U_cq|5UZqBJfNE;gge^N8 zVO2)uO8WFW{{Y*r?g#k6pxQ#p#@|b8ec0=@hJPbpKEPH{7#V&PeN@N}k>TyaBb3I3quauISUU(B{kyV=oSw=`b#a|;wY!bbU%Y%Y)2tAmNFq$`^N)!yr12K3G^@G%)+Isfj@hE^o<1q^ z=yErglU>SKoS*Ac>H0kPk`0PmJxJ!gFTmdjFFZ>+m4KAaa(NZ)x);GcKS9|g#>OZ& zHhX)0YPnKco>QpyNb^sIUkuek-(LKYAl`5}`c=P(-ZG9CYiK0eh`Rt@K3eI1BKYPl zBG3Ci$VC#SLlonu^{<@u&1PHsmUd!Ksqb00%v4piBh>X-Zlz`{dEgG%tce`4C#N)x zHW=q5dr}9>bvQn>BxtP3k%&Tf9Qt;qvE0CPJ#$IB0QEnG1cuHJ&DbAGHry=GV6eg9 zgTbLj*4jR9;F?l52L5!N#~l9vo+^Y*w~@|ERI3IP8NuugM+0$?xC6CZRt19*oO@E( zG-OcjQ-Ux$eQRe*h)E*kfJyFaILDlvbK4bSAkavJatA+3O$*TKZ&9sajlm@JHCydq z<1PvHroGe8r!tapf%(=$Ugk6;VD$ZHZCc^8(Cjo@lrA#Eis&51;I`e^I3)4KaJntX zNw$tbARc(G(WEj)2nqqzNU9PEU*ZOLVZph6wakpo4 z&OAS;ww->BlY&66WkN4>_@+z%!;Dvl-az(OOr&6`;=Nnp?xrua-z~ml9u7Td>JnF1 zC!P|W2VT_68Ja7lAYnDcLO6MA;!rRf~0;``p4iuivv# z=s`*<&t9jWQcf+aX!bs^Td1!sEj&SEh6O>CDErEK*X0lV76-zRXnz8YC0p26Wu^}n$~$Ee0f6&|T%P|2J&dI8(sxW55wB_|O#3QtdZ^qb}T zO}e<}jz9f%jh)9WH8K1rVAi^;GICgk;Pf@_G3ooDhJ1+}sL323dh!hpPqS(XyK3$u zCAwF(>6XhatR^fra1PVJtm^kYEF-dMl)l2O&OTr{Y~#H~`c^pFr_`U~9<|XWpDe_2 zo(TT5^s;3jfx$fceih1|w>#}~pBi$3xFN@(=bDCHHH)3Aka;JjE2@smouoEFKQQf4 zn~V~_sNc6Z&ougi|r3+bdC&b))1XQg&iY2`^QrC4K(b*LJ{db5Gg zCqDj_R=%T+(aNo_2Mi5K4Z9ggW*;^<$0D~TvoNmWgRV#;JXL3bLmXfO-1Qa1QZ1d- zwkt;-?Xm4amMxYU;;zC%o?GP{61{4+)58M5e@c-ZjCmvH=L8z_Y9^0DosCE&210X{ z9Anb7>U2>_f9f0bZ)WSoJ?0I~F|miMU~KQ>7Xj1kUjf=jDA6E{*_q$?F5U}rh} zO-~%V@VO#FPdVx5wUd%SIfi8RskQU9pl&LzYzfl+liJwOMh_I6s9l;Uh4CFBs=N$*WSJ zDnUgBhw*k5S)&eA9zg#0YT7Mc;!4P&ELaCBT%3H}2&xW%J4jg^x1#i|YluSO9d|GB zDd~>YNt5Qv0;AP0HlX~-C)TYP{O4nX9Sf(2VKVp6#zDB!T?@u@^) zNQa`gQAxWM%iWRMKnp2#7#}FlrEl9s9^_7gsLOC`E)b?Y!4+691Rg$>uVm52Mpx!; zoOG;`yCufT#VA0JcE;S<$UoMtAS|JsK-w~MR8@g~2-*e#&N!_|6c$c*2IB|Q-m&&p zTAIQ|1uBxB!(Ux*F>4ZQBEP1Q2iqXU$}SJ*yam7CnDji9@OF z)2nSxCi=(BjN=15;F{)c;#lQ5P%^j$dRKpa0;pi1G6S?T3|Bd*+F|g68++q}ShZ(+ z9gezdQ=5`7Mlpfhj`dPT%V2`Lxd8XAE2xN&Alkm9)fr=0$v{aedCz*P22cht4r(Q)h7@TzGqSS0C08sk!@u}e)wR-; z3K(u|4CDD%8*OlQL;)p$t($qyF(+OEkz5k9-1Xr?QQaL!o>{(NPdt0pg}GTUxxfp@ z*15Q^3}rVGL14J+k8@h_U8vo)caefQ#y#shTcObCw2j62R}9Jl$36c53X0-Ask?v= zL*AhmD(i#8u%Jvf=OYd2OX-XoL8tNhfJO+&cYTWAeQH!TCUR= zm=*!>KH>YnTF%1ea@2FVlV}HaIU_wPyB)~Vau^(Bj)s(6G^_v_J(PE|i|!k+Ko}cMbIn_0dQCYR zuw@9r+>AiM{RL>nGQzx{Eb zx7DNE+lk(yzRHwUIHeQw+SMIdIZLU#;yrz1)MpTrgZB$_kEJ?IakV`#rSt>!89LUPEs++N0|H#h0Unv9@a(1F zmeOnza#N0TT+XlJS+BKS(#XxU{JA_2YQJTDiPGmdf8qesc5G_nwHqh2W(4OXpQp8Q z`hx=GW1m{@b(rJ5MV=$c8D*{mTSks@56kqV(k*OKkBJ9ElSu3Yt(knm(2hymY1msCa;_UB zV~k?2TtXD{j2@Lyi392DNfd~H#V<}rQA^da)KX+n09faqIixtc!H~K#~e|xir1GOb;j<4Kb3u({{RHi zv5s$!I$gx7cEcOUA3YClE8>ij!yJnHpZ*EKXvy&&D}Znk6M_yhbNs7HOW(1}iP8t` z^`*#?%rds%MnM(wpZpX9!D;aa;0KCy;*TZFFq^0pbMvPl*U^?2&mEvHyGB0>^WTYg z7TS)Pbrk5XB!%O{bU7HV$y2hC=SF<8O#F2HpL|awejj@_c1KPCJq9}0v02=`$pD?( zc**KBUp`&w*Ix>LGWdtXjJr{8*`ik+QI0_e@vlm?)pZ9T?Z7`cu~ZM=Tn7Xas_$rr*U&| zU4bpTC#`eBoRZYqtyHxp)NfK?TY|vyLB>U7T;HPS3%EBOYL?opg)sLfIV5@3C<6tYei-W0YNQ{V-=&djJ>0J z8fkp9C`5!3I4z#FpLYkA#J4#es$&$8;RZn*mOUxAjpW2bvX�n#M^%*&1_Q8RYE% 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 U)TTw=tivogI5l>*#uwE8*<&4X;s5{u diff --git a/ultralytics-main/yolov8-stereo.py b/ultralytics-main/yolov8-stereo.py deleted file mode 100644 index ffee4b3..0000000 --- a/ultralytics-main/yolov8-stereo.py +++ /dev/null @@ -1,69 +0,0 @@ -import cv2 -import torch -import argparse -from ultralytics import YOLO -from stereo import stereoconfig_040_2 -from stereo.stereo import stereo_40 -from stereo.stereo import stereo_threading, MyThread -from stereo.dianyuntu_yolo import preprocess, undistortion, getRectifyTransform, draw_line, rectifyImage, \ - stereoMatchSGBM - -def main(): - cap = cv2.VideoCapture('ultralytics/assets/a2.mp4') - model = YOLO('yolov8n.pt') - cv2.namedWindow('00', cv2.WINDOW_NORMAL) - cv2.resizeWindow('00', 1280, 360) # 设置宽高 - out_video = cv2.VideoWriter('output.avi', cv2.VideoWriter_fourcc(*'XVID'), 30, (2560, 720)) - while True: - ret, im0 = cap.read() - if not ret: - print("Video frame is empty or video processing has been successfully completed.") - break - # img = cv2.cvtColor(image_net, cv2.COLOR_BGRA2BGR) - im0 = cv2.resize(im0, (2560, 720)) - config = stereoconfig_040_2.stereoCamera() - map1x, map1y, map2x, map2y, Q = getRectifyTransform(720, 1280, config) - thread = MyThread(stereo_threading, args=(config, im0, map1x, map1y, map2x, map2y, Q)) - thread.start() - results = model.track(im0, save=False, conf=0.5) - annotated_frame = results[0].plot() - boxes = results[0].boxes.xywh.cpu() - for i, box in enumerate(boxes): - # for box, class_idx in zip(boxes, classes): - x_center, y_center, width, height = box.tolist() - x1 = x_center - width / 2 - y1 = y_center - height / 2 - x2 = x_center + width / 2 - y2 = y_center + height / 2 - print('x2',x2) - if (0 < x2 < 1280): - thread.join() - points_3d = thread.get_result() - # gol.set_value('points_3d', points_3d) - a = points_3d[int(y_center), int(x_center), 0] / 1000 - b = points_3d[int(y_center), int(x_center), 1] / 1000 - c = points_3d[int(y_center), int(x_center), 2] / 1000 - distance = ((a ** 2 + b ** 2 + c ** 2) ** 0.5) - if (distance != 0): - text_dis_avg = "dis:%0.2fm" % distance - cv2.putText(annotated_frame, text_dis_avg, (int(x2 + 5), int(y1 + 30)), cv2.FONT_ITALIC, 1.2, - (0, 255, 255), 3) - cv2.imshow('00', annotated_frame) - out_video.write(annotated_frame) - key = cv2.waitKey(1) - if key == 'q': - break - out_video.release() - cap.release() - cv2.destroyAllWindows() - -if __name__ == '__main__': - parser = argparse.ArgumentParser() - parser.add_argument('--weights', type=str, default='yolov8n.pt', help='model.pt path(s)') - parser.add_argument('--svo', type=str, default=None, help='optional svo file') - parser.add_argument('--img_size', type=int, default=416, help='inference size (pixels)') - parser.add_argument('--conf_thres', type=float, default=0.4, help='object confidence threshold') - opt = parser.parse_args() - - with torch.no_grad(): - main() \ No newline at end of file diff --git a/yolov5_Monocular_social_ranging/.dockerignore b/yolov5_Monocular_social_ranging/.dockerignore new file mode 100644 index 0000000..af51ccc --- /dev/null +++ b/yolov5_Monocular_social_ranging/.dockerignore @@ -0,0 +1,222 @@ +# Repo-specific DockerIgnore ------------------------------------------------------------------------------------------- +#.git +.cache +.idea +runs +output +coco +storage.googleapis.com + +data/samples/* +**/results*.csv +*.jpg + +# Neural Network weights ----------------------------------------------------------------------------------------------- +**/*.pt +**/*.pth +**/*.onnx +**/*.engine +**/*.mlmodel +**/*.torchscript +**/*.torchscript.pt +**/*.tflite +**/*.h5 +**/*.pb +*_saved_model/ +*_web_model/ +*_openvino_model/ + +# Below Copied From .gitignore ----------------------------------------------------------------------------------------- +# Below Copied From .gitignore ----------------------------------------------------------------------------------------- + + +# GitHub Python GitIgnore ---------------------------------------------------------------------------------------------- +# Byte-compiled / optimized / DLL files +__pycache__/ +*.py[cod] +*$py.class + +# C extensions +*.so + +# Distribution / packaging +.Python +env/ +build/ +develop-eggs/ +dist/ +downloads/ +eggs/ +.eggs/ +lib/ +lib64/ +parts/ +sdist/ +var/ +wheels/ +*.egg-info/ +wandb/ +.installed.cfg +*.egg + +# PyInstaller +# Usually these files are written by a python script from a template +# before PyInstaller builds the exe, so as to inject date/other infos into it. +*.manifest +*.spec + +# Installer logs +pip-log.txt +pip-delete-this-directory.txt + +# Unit test / coverage reports +htmlcov/ +.tox/ +.coverage +.coverage.* +.cache +nosetests.xml +coverage.xml +*.cover +.hypothesis/ + +# Translations +*.mo +*.pot + +# Django stuff: +*.log +local_settings.py + +# Flask stuff: +instance/ +.webassets-cache + +# Scrapy stuff: +.scrapy + +# Sphinx documentation +docs/_build/ + +# PyBuilder +target/ + +# Jupyter Notebook +.ipynb_checkpoints + +# pyenv +.python-version + +# celery beat schedule file +celerybeat-schedule + +# SageMath parsed files +*.sage.py + +# dotenv +.env + +# virtualenv +.venv* +venv*/ +ENV*/ + +# Spyder project settings +.spyderproject +.spyproject + +# Rope project settings +.ropeproject + +# mkdocs documentation +/site + +# mypy +.mypy_cache/ + + +# https://github.com/github/gitignore/blob/master/Global/macOS.gitignore ----------------------------------------------- + +# General +.DS_Store +.AppleDouble +.LSOverride + +# Icon must end with two \r +Icon +Icon? + +# Thumbnails +._* + +# Files that might appear in the root of a volume +.DocumentRevisions-V100 +.fseventsd +.Spotlight-V100 +.TemporaryItems +.Trashes +.VolumeIcon.icns +.com.apple.timemachine.donotpresent + +# Directories potentially created on remote AFP share +.AppleDB +.AppleDesktop +Network Trash Folder +Temporary Items +.apdisk + + +# https://github.com/github/gitignore/blob/master/Global/JetBrains.gitignore +# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio and WebStorm +# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839 + +# User-specific stuff: +.idea/* +.idea/**/workspace.xml +.idea/**/tasks.xml +.idea/dictionaries +.html # Bokeh Plots +.pg # TensorFlow Frozen Graphs +.avi # videos + +# Sensitive or high-churn files: +.idea/**/dataSources/ +.idea/**/dataSources.ids +.idea/**/dataSources.local.xml +.idea/**/sqlDataSources.xml +.idea/**/dynamic.xml +.idea/**/uiDesigner.xml + +# Gradle: +.idea/**/gradle.xml +.idea/**/libraries + +# CMake +cmake-build-debug/ +cmake-build-release/ + +# Mongo Explorer plugin: +.idea/**/mongoSettings.xml + +## File-based project format: +*.iws + +## Plugin-specific files: + +# IntelliJ +out/ + +# mpeltonen/sbt-idea plugin +.idea_modules/ + +# JIRA plugin +atlassian-ide-plugin.xml + +# Cursive Clojure plugin +.idea/replstate.xml + +# Crashlytics plugin (for Android Studio and IntelliJ) +com_crashlytics_export_strings.xml +crashlytics.properties +crashlytics-build.properties +fabric.properties diff --git a/yolov5_Monocular_social_ranging/.gitattributes b/yolov5_Monocular_social_ranging/.gitattributes new file mode 100644 index 0000000..dad4239 --- /dev/null +++ b/yolov5_Monocular_social_ranging/.gitattributes @@ -0,0 +1,2 @@ +# this drop notebooks from GitHub language stats +*.ipynb linguist-vendored diff --git a/yolov5_Monocular_social_ranging/.github/FUNDING.yml b/yolov5_Monocular_social_ranging/.github/FUNDING.yml new file mode 100644 index 0000000..3da386f --- /dev/null +++ b/yolov5_Monocular_social_ranging/.github/FUNDING.yml @@ -0,0 +1,5 @@ +# These are supported funding model platforms + +github: glenn-jocher +patreon: ultralytics +open_collective: ultralytics diff --git a/ultralytics-main/.github/ISSUE_TEMPLATE/bug-report.yml b/yolov5_Monocular_social_ranging/.github/ISSUE_TEMPLATE/bug-report.yml similarity index 54% rename from ultralytics-main/.github/ISSUE_TEMPLATE/bug-report.yml rename to yolov5_Monocular_social_ranging/.github/ISSUE_TEMPLATE/bug-report.yml index 203250b..fcb6413 100644 --- a/ultralytics-main/.github/ISSUE_TEMPLATE/bug-report.yml +++ b/yolov5_Monocular_social_ranging/.github/ISSUE_TEMPLATE/bug-report.yml @@ -1,38 +1,37 @@ name: 🐛 Bug Report # title: " " -description: Problems with YOLOv8 +description: Problems with YOLOv5 labels: [bug, triage] body: - type: markdown attributes: value: | - Thank you for submitting a YOLOv8 🐛 Bug Report! + Thank you for submitting a YOLOv5 🐛 Bug Report! - type: checkboxes attributes: label: Search before asking description: > - Please search the Ultralytics [Docs](https://docs.ultralytics.com) and [issues](https://github.com/ultralytics/ultralytics/issues) to see if a similar bug report already exists. + Please search the [issues](https://github.com/ultralytics/yolov5/issues) to see if a similar bug report already exists. options: - label: > - I have searched the YOLOv8 [issues](https://github.com/ultralytics/ultralytics/issues) and found no similar bug report. + I have searched the YOLOv5 [issues](https://github.com/ultralytics/yolov5/issues) and found no similar bug report. required: true - type: dropdown attributes: - label: YOLOv8 Component + label: YOLOv5 Component description: | - Please select the part of YOLOv8 where you found the bug. + Please select the part of YOLOv5 where you found the bug. multiple: true options: - - "Install" - - "Train" - - "Val" - - "Predict" + - "Training" + - "Validation" + - "Detection" - "Export" + - "PyTorch Hub" - "Multi-GPU" - - "Augmentation" - - "Hyperparameter Tuning" + - "Evolution" - "Integrations" - "Other" validations: @@ -52,19 +51,9 @@ body: label: Environment description: Please specify the software and hardware you used to produce the bug. placeholder: | - Paste output of `yolo checks` or `ultralytics.checks()` command, i.e.: - ``` - Ultralytics YOLOv8.0.181 🚀 Python-3.11.2 torch-2.0.1 CPU (Apple M2) - Setup complete ✅ (8 CPUs, 16.0 GB RAM, 266.5/460.4 GB disk) - - OS macOS-13.5.2 - Environment Jupyter - Python 3.11.2 - Install git - RAM 16.00 GB - CPU Apple M2 - CUDA None - ``` + - YOLO: YOLOv5 🚀 v6.0-67-g60e42e1 torch 1.9.0+cu111 CUDA:0 (A100-SXM4-40GB, 40536MiB) + - OS: Ubuntu 20.04 + - Python: 3.9.0 validations: required: false @@ -73,7 +62,7 @@ body: label: Minimal Reproducible Example description: > When asking a question, people will be better able to provide help if you provide code that they can easily understand and use to **reproduce** the problem. - This is referred to by community members as creating a [minimal reproducible example](https://docs.ultralytics.com/help/minimum_reproducible_example/). + This is referred to by community members as creating a [minimal reproducible example](https://stackoverflow.com/help/minimal-reproducible-example). placeholder: | ``` # Code to reproduce your issue here @@ -90,7 +79,7 @@ body: attributes: label: Are you willing to submit a PR? description: > - (Optional) We encourage you to submit a [Pull Request](https://github.com/ultralytics/ultralytics/pulls) (PR) to help improve YOLOv8 for everyone, especially if you have a good understanding of how to implement a fix or feature. - See the YOLOv8 [Contributing Guide](https://docs.ultralytics.com/help/contributing) to get started. + (Optional) We encourage you to submit a [Pull Request](https://github.com/ultralytics/yolov5/pulls) (PR) to help improve YOLOv5 for everyone, especially if you have a good understanding of how to implement a fix or feature. + See the YOLOv5 [Contributing Guide](https://github.com/ultralytics/yolov5/blob/master/CONTRIBUTING.md) to get started. options: - label: Yes I'd like to help by submitting a PR! diff --git a/yolov5_Monocular_social_ranging/.github/ISSUE_TEMPLATE/config.yml b/yolov5_Monocular_social_ranging/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..f388d7b --- /dev/null +++ b/yolov5_Monocular_social_ranging/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,8 @@ +blank_issues_enabled: true +contact_links: + - name: Slack + url: https://join.slack.com/t/ultralytics/shared_invite/zt-w29ei8bp-jczz7QYUmDtgo6r6KcMIAg + about: Ask on Ultralytics Slack Forum + - name: Stack Overflow + url: https://stackoverflow.com/search?q=YOLOv5 + about: Ask on Stack Overflow with 'YOLOv5' tag diff --git a/ultralytics-main/.github/ISSUE_TEMPLATE/feature-request.yml b/yolov5_Monocular_social_ranging/.github/ISSUE_TEMPLATE/feature-request.yml similarity index 58% rename from ultralytics-main/.github/ISSUE_TEMPLATE/feature-request.yml rename to yolov5_Monocular_social_ranging/.github/ISSUE_TEMPLATE/feature-request.yml index 76fc7b1..68ef985 100644 --- a/ultralytics-main/.github/ISSUE_TEMPLATE/feature-request.yml +++ b/yolov5_Monocular_social_ranging/.github/ISSUE_TEMPLATE/feature-request.yml @@ -1,21 +1,21 @@ name: 🚀 Feature Request -description: Suggest a YOLOv8 idea +description: Suggest a YOLOv5 idea # title: " " labels: [enhancement] body: - type: markdown attributes: value: | - Thank you for submitting a YOLOv8 🚀 Feature Request! + Thank you for submitting a YOLOv5 🚀 Feature Request! - type: checkboxes attributes: label: Search before asking description: > - Please search the Ultralytics [Docs](https://docs.ultralytics.com) and [issues](https://github.com/ultralytics/ultralytics/issues) to see if a similar feature request already exists. + Please search the [issues](https://github.com/ultralytics/yolov5/issues) to see if a similar feature request already exists. options: - label: > - I have searched the YOLOv8 [issues](https://github.com/ultralytics/ultralytics/issues) and found no similar feature requests. + I have searched the YOLOv5 [issues](https://github.com/ultralytics/yolov5/issues) and found no similar feature requests. required: true - type: textarea @@ -23,7 +23,7 @@ body: label: Description description: A short description of your feature. placeholder: | - What new feature would you like to see in YOLOv8? + What new feature would you like to see in YOLOv5? validations: required: true @@ -44,7 +44,7 @@ body: attributes: label: Are you willing to submit a PR? description: > - (Optional) We encourage you to submit a [Pull Request](https://github.com/ultralytics/ultralytics/pulls) (PR) to help improve YOLOv8 for everyone, especially if you have a good understanding of how to implement a fix or feature. - See the YOLOv8 [Contributing Guide](https://docs.ultralytics.com/help/contributing) to get started. + (Optional) We encourage you to submit a [Pull Request](https://github.com/ultralytics/yolov5/pulls) (PR) to help improve YOLOv5 for everyone, especially if you have a good understanding of how to implement a fix or feature. + See the YOLOv5 [Contributing Guide](https://github.com/ultralytics/yolov5/blob/master/CONTRIBUTING.md) to get started. options: - label: Yes I'd like to help by submitting a PR! diff --git a/ultralytics-main/.github/ISSUE_TEMPLATE/question.yml b/yolov5_Monocular_social_ranging/.github/ISSUE_TEMPLATE/question.yml similarity index 55% rename from ultralytics-main/.github/ISSUE_TEMPLATE/question.yml rename to yolov5_Monocular_social_ranging/.github/ISSUE_TEMPLATE/question.yml index 090bc5d..8e0993c 100644 --- a/ultralytics-main/.github/ISSUE_TEMPLATE/question.yml +++ b/yolov5_Monocular_social_ranging/.github/ISSUE_TEMPLATE/question.yml @@ -1,21 +1,21 @@ name: ❓ Question -description: Ask a YOLOv8 question +description: Ask a YOLOv5 question # title: " " labels: [question] body: - type: markdown attributes: value: | - Thank you for asking a YOLOv8 ❓ Question! + Thank you for asking a YOLOv5 ❓ Question! - type: checkboxes attributes: label: Search before asking description: > - Please search the Ultralytics [Docs](https://docs.ultralytics.com), [issues](https://github.com/ultralytics/ultralytics/issues) and [discussions](https://github.com/ultralytics/ultralytics/discussions) to see if a similar question already exists. + Please search the [issues](https://github.com/ultralytics/yolov5/issues) and [discussions](https://github.com/ultralytics/yolov5/discussions) to see if a similar question already exists. options: - label: > - I have searched the YOLOv8 [issues](https://github.com/ultralytics/ultralytics/issues) and [discussions](https://github.com/ultralytics/ultralytics/discussions) and found no similar questions. + I have searched the YOLOv5 [issues](https://github.com/ultralytics/yolov5/issues) and [discussions](https://github.com/ultralytics/yolov5/discussions) and found no similar questions. required: true - type: textarea diff --git a/yolov5_Monocular_social_ranging/.github/PULL_REQUEST_TEMPLATE.md b/yolov5_Monocular_social_ranging/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..7a3e1b7 --- /dev/null +++ b/yolov5_Monocular_social_ranging/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,7 @@ +Thank you for submitting a YOLOv5 🚀 Pull Request! We want to make contributing to YOLOv5 as easy and transparent as possible. A few tips to get you started: + +- Search existing YOLOv5 [PRs](https://github.com/ultralytics/yolov5/pull) to see if a similar PR already exists. +- Link this PR to a YOLOv5 [issue](https://github.com/ultralytics/yolov5/issues) to help us understand what bug fix or feature is being implemented. +- Provide before and after profiling/inference/training results to help us quantify the improvement your PR provides (if applicable). + +Please see our ✅ [Contributing Guide](https://github.com/ultralytics/yolov5/blob/master/CONTRIBUTING.md) for more details. diff --git a/ultralytics-main/.github/dependabot.yml b/yolov5_Monocular_social_ranging/.github/dependabot.yml similarity index 65% rename from ultralytics-main/.github/dependabot.yml rename to yolov5_Monocular_social_ranging/.github/dependabot.yml index 2d4ae31..c1b3d5d 100644 --- a/ultralytics-main/.github/dependabot.yml +++ b/yolov5_Monocular_social_ranging/.github/dependabot.yml @@ -1,7 +1,3 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# Dependabot for package version updates -# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates - version: 2 updates: - package-ecosystem: pip @@ -16,7 +12,7 @@ updates: - dependencies - package-ecosystem: github-actions - directory: "/.github/workflows" + directory: "/" schedule: interval: weekly time: "04:00" diff --git a/yolov5_Monocular_social_ranging/.github/workflows/ci-testing.yml b/yolov5_Monocular_social_ranging/.github/workflows/ci-testing.yml new file mode 100644 index 0000000..5cf1613 --- /dev/null +++ b/yolov5_Monocular_social_ranging/.github/workflows/ci-testing.yml @@ -0,0 +1,93 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +name: CI CPU testing + +on: # https://help.github.com/en/actions/reference/events-that-trigger-workflows + push: + branches: [ master ] + pull_request: + # The branches below must be a subset of the branches above + branches: [ master ] + schedule: + - cron: '0 0 * * *' # Runs at 00:00 UTC every day + +jobs: + cpu-tests: + + runs-on: ${{ matrix.os }} + strategy: + fail-fast: false + matrix: + os: [ ubuntu-latest, macos-latest, windows-latest ] + python-version: [ 3.9 ] + model: [ 'yolov5n' ] # models to test + + # Timeout: https://stackoverflow.com/a/59076067/4521646 + timeout-minutes: 60 + steps: + - uses: actions/checkout@v2 + - name: Set up Python ${{ matrix.python-version }} + uses: actions/setup-python@v2 + with: + python-version: ${{ matrix.python-version }} + + # Note: This uses an internal pip API and may not always work + # https://github.com/actions/cache/blob/master/examples.md#multiple-oss-in-a-workflow + - name: Get pip cache + id: pip-cache + run: | + python -c "from pip._internal.locations import USER_CACHE_DIR; print('::set-output name=dir::' + USER_CACHE_DIR)" + + - name: Cache pip + uses: actions/cache@v2.1.7 + with: + path: ${{ steps.pip-cache.outputs.dir }} + key: ${{ runner.os }}-${{ matrix.python-version }}-pip-${{ hashFiles('requirements.txt') }} + restore-keys: | + ${{ runner.os }}-${{ matrix.python-version }}-pip- + + # Known Keras 2.7.0 issue: https://github.com/ultralytics/yolov5/pull/5486 + - name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install -qr requirements.txt -f https://download.pytorch.org/whl/cpu/torch_stable.html + pip install -q onnx tensorflow-cpu keras==2.6.0 # wandb # extras + python --version + pip --version + pip list + shell: bash + + # - name: W&B login + # run: wandb login 345011b3fb26dc8337fd9b20e53857c1d403f2aa + + # - name: Download data + # run: | + # curl -L -o tmp.zip https://github.com/ultralytics/yolov5/releases/download/v1.0/coco128.zip + # unzip -q tmp.zip -d ../datasets + + - name: Tests workflow + run: | + # export PYTHONPATH="$PWD" # to run '$ python *.py' files in subdirectories + d=cpu # device + weights=runs/train/exp/weights/best.pt + + # Train + python train.py --img 64 --batch 32 --weights ${{ matrix.model }}.pt --cfg ${{ matrix.model }}.yaml --epochs 1 --device $d + # Val + python val.py --img 64 --batch 32 --weights ${{ matrix.model }}.pt --device $d + python val.py --img 64 --batch 32 --weights $weights --device $d + # Detect + python detect.py --weights ${{ matrix.model }}.pt --device $d + python detect.py --weights $weights --device $d + python hubconf.py # hub + # Export + python models/yolo.py --cfg ${{ matrix.model }}.yaml # build PyTorch model + python models/tf.py --weights ${{ matrix.model }}.pt # build TensorFlow model + python export.py --weights ${{ matrix.model }}.pt --img 64 --include torchscript onnx # export + # Python + python - <=3.7.0**](https://www.python.org/) with all [requirements.txt](https://github.com/ultralytics/yolov5/blob/master/requirements.txt) installed including [**PyTorch>=1.7**](https://pytorch.org/get-started/locally/). To get started: + ```bash + git clone https://github.com/ultralytics/yolov5 # clone + cd yolov5 + pip install -r requirements.txt # install + ``` + + ## Environments + + YOLOv5 may be run in any of the following up-to-date verified environments (with all dependencies including [CUDA](https://developer.nvidia.com/cuda)/[CUDNN](https://developer.nvidia.com/cudnn), [Python](https://www.python.org/) and [PyTorch](https://pytorch.org/) preinstalled): + + - **Google Colab and Kaggle** notebooks with free GPU: Open In Colab Open In Kaggle + - **Google Cloud** Deep Learning VM. See [GCP Quickstart Guide](https://github.com/ultralytics/yolov5/wiki/GCP-Quickstart) + - **Amazon** Deep Learning AMI. See [AWS Quickstart Guide](https://github.com/ultralytics/yolov5/wiki/AWS-Quickstart) + - **Docker Image**. See [Docker Quickstart Guide](https://github.com/ultralytics/yolov5/wiki/Docker-Quickstart) Docker Pulls + + + ## Status + + CI CPU testing + + If this badge is green, all [YOLOv5 GitHub Actions](https://github.com/ultralytics/yolov5/actions) Continuous Integration (CI) tests are currently passing. CI tests verify correct operation of YOLOv5 training ([train.py](https://github.com/ultralytics/yolov5/blob/master/train.py)), validation ([val.py](https://github.com/ultralytics/yolov5/blob/master/val.py)), inference ([detect.py](https://github.com/ultralytics/yolov5/blob/master/detect.py)) and export ([export.py](https://github.com/ultralytics/yolov5/blob/master/export.py)) on MacOS, Windows, and Ubuntu every 24 hours and on every commit. diff --git a/yolov5_Monocular_social_ranging/.github/workflows/rebase.yml b/yolov5_Monocular_social_ranging/.github/workflows/rebase.yml new file mode 100644 index 0000000..a4db1ef --- /dev/null +++ b/yolov5_Monocular_social_ranging/.github/workflows/rebase.yml @@ -0,0 +1,21 @@ +# https://github.com/marketplace/actions/automatic-rebase + +name: Automatic Rebase +on: + issue_comment: + types: [created] +jobs: + rebase: + name: Rebase + if: github.event.issue.pull_request != '' && contains(github.event.comment.body, '/rebase') + runs-on: ubuntu-latest + steps: + - name: Checkout the latest code + uses: actions/checkout@v2 + with: + token: ${{ secrets.ACTIONS_TOKEN }} + fetch-depth: 0 # otherwise, you will fail to push refs to dest repo + - name: Automatic Rebase + uses: cirrus-actions/rebase@1.5 + env: + GITHUB_TOKEN: ${{ secrets.ACTIONS_TOKEN }} diff --git a/yolov5_Monocular_social_ranging/.github/workflows/stale.yml b/yolov5_Monocular_social_ranging/.github/workflows/stale.yml new file mode 100644 index 0000000..7a83950 --- /dev/null +++ b/yolov5_Monocular_social_ranging/.github/workflows/stale.yml @@ -0,0 +1,38 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +name: Close stale issues +on: + schedule: + - cron: '0 0 * * *' # Runs at 00:00 UTC every day + +jobs: + stale: + runs-on: ubuntu-latest + steps: + - uses: actions/stale@v4 + with: + repo-token: ${{ secrets.GITHUB_TOKEN }} + stale-issue-message: | + 👋 Hello, this issue has been automatically marked as stale because it has not had recent activity. Please note it will be closed if no further activity occurs. + + Access additional [YOLOv5](https://ultralytics.com/yolov5) 🚀 resources: + - **Wiki** – https://github.com/ultralytics/yolov5/wiki + - **Tutorials** – https://github.com/ultralytics/yolov5#tutorials + - **Docs** – https://docs.ultralytics.com + + Access additional [Ultralytics](https://ultralytics.com) ⚡ resources: + - **Ultralytics HUB** – https://ultralytics.com/hub + - **Vision API** – https://ultralytics.com/yolov5 + - **About Us** – https://ultralytics.com/about + - **Join Our Team** – https://ultralytics.com/work + - **Contact Us** – https://ultralytics.com/contact + + Feel free to inform us of any other **issues** you discover or **feature requests** that come to mind in the future. Pull Requests (PRs) are also always welcomed! + + Thank you for your contributions to YOLOv5 🚀 and Vision AI ⭐! + + stale-pr-message: 'This pull request has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions YOLOv5 🚀 and Vision AI ⭐.' + days-before-stale: 30 + days-before-close: 5 + exempt-issue-labels: 'documentation,tutorial,TODO' + operations-per-run: 100 # The maximum number of operations per run, used to control rate limiting. diff --git a/yolov5_Monocular_social_ranging/.gitignore b/yolov5_Monocular_social_ranging/.gitignore new file mode 100644 index 0000000..69a0084 --- /dev/null +++ b/yolov5_Monocular_social_ranging/.gitignore @@ -0,0 +1,256 @@ +# Repo-specific GitIgnore ---------------------------------------------------------------------------------------------- +*.jpg +*.jpeg +*.png +*.bmp +*.tif +*.tiff +*.heic +*.JPG +*.JPEG +*.PNG +*.BMP +*.TIF +*.TIFF +*.HEIC +*.mp4 +*.mov +*.MOV +*.avi +*.data +*.json +*.cfg +!setup.cfg +!cfg/yolov3*.cfg + +storage.googleapis.com +runs/* +data/* +data/images/* +!data/*.yaml +!data/hyps +!data/scripts +!data/images +!data/images/zidane.jpg +!data/images/bus.jpg +!data/*.sh + +results*.csv + +# Datasets ------------------------------------------------------------------------------------------------------------- +coco/ +coco128/ +VOC/ + +# MATLAB GitIgnore ----------------------------------------------------------------------------------------------------- +*.m~ +*.mat +!targets*.mat + +# Neural Network weights ----------------------------------------------------------------------------------------------- +*.weights +*.pt +*.pb +*.onnx +*.engine +*.mlmodel +*.torchscript +*.tflite +*.h5 +*_saved_model/ +*_web_model/ +*_openvino_model/ +darknet53.conv.74 +yolov3-tiny.conv.15 + +# GitHub Python GitIgnore ---------------------------------------------------------------------------------------------- +# Byte-compiled / optimized / DLL files +__pycache__/ +*.py[cod] +*$py.class + +# C extensions +*.so + +# Distribution / packaging +.Python +env/ +build/ +develop-eggs/ +dist/ +downloads/ +eggs/ +.eggs/ +lib/ +lib64/ +parts/ +sdist/ +var/ +wheels/ +*.egg-info/ +/wandb/ +.installed.cfg +*.egg + + +# PyInstaller +# Usually these files are written by a python script from a template +# before PyInstaller builds the exe, so as to inject date/other infos into it. +*.manifest +*.spec + +# Installer logs +pip-log.txt +pip-delete-this-directory.txt + +# Unit test / coverage reports +htmlcov/ +.tox/ +.coverage +.coverage.* +.cache +nosetests.xml +coverage.xml +*.cover +.hypothesis/ + +# Translations +*.mo +*.pot + +# Django stuff: +*.log +local_settings.py + +# Flask stuff: +instance/ +.webassets-cache + +# Scrapy stuff: +.scrapy + +# Sphinx documentation +docs/_build/ + +# PyBuilder +target/ + +# Jupyter Notebook +.ipynb_checkpoints + +# pyenv +.python-version + +# celery beat schedule file +celerybeat-schedule + +# SageMath parsed files +*.sage.py + +# dotenv +.env + +# virtualenv +.venv* +venv*/ +ENV*/ + +# Spyder project settings +.spyderproject +.spyproject + +# Rope project settings +.ropeproject + +# mkdocs documentation +/site + +# mypy +.mypy_cache/ + + +# https://github.com/github/gitignore/blob/master/Global/macOS.gitignore ----------------------------------------------- + +# General +.DS_Store +.AppleDouble +.LSOverride + +# Icon must end with two \r +Icon +Icon? + +# Thumbnails +._* + +# Files that might appear in the root of a volume +.DocumentRevisions-V100 +.fseventsd +.Spotlight-V100 +.TemporaryItems +.Trashes +.VolumeIcon.icns +.com.apple.timemachine.donotpresent + +# Directories potentially created on remote AFP share +.AppleDB +.AppleDesktop +Network Trash Folder +Temporary Items +.apdisk + + +# https://github.com/github/gitignore/blob/master/Global/JetBrains.gitignore +# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio and WebStorm +# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839 + +# User-specific stuff: +.idea/* +.idea/**/workspace.xml +.idea/**/tasks.xml +.idea/dictionaries +.html # Bokeh Plots +.pg # TensorFlow Frozen Graphs +.avi # videos + +# Sensitive or high-churn files: +.idea/**/dataSources/ +.idea/**/dataSources.ids +.idea/**/dataSources.local.xml +.idea/**/sqlDataSources.xml +.idea/**/dynamic.xml +.idea/**/uiDesigner.xml + +# Gradle: +.idea/**/gradle.xml +.idea/**/libraries + +# CMake +cmake-build-debug/ +cmake-build-release/ + +# Mongo Explorer plugin: +.idea/**/mongoSettings.xml + +## File-based project format: +*.iws + +## Plugin-specific files: + +# IntelliJ +out/ + +# mpeltonen/sbt-idea plugin +.idea_modules/ + +# JIRA plugin +atlassian-ide-plugin.xml + +# Cursive Clojure plugin +.idea/replstate.xml + +# Crashlytics plugin (for Android Studio and IntelliJ) +com_crashlytics_export_strings.xml +crashlytics.properties +crashlytics-build.properties +fabric.properties diff --git a/yolov5_Monocular_social_ranging/.pre-commit-config.yaml b/yolov5_Monocular_social_ranging/.pre-commit-config.yaml new file mode 100644 index 0000000..526a560 --- /dev/null +++ b/yolov5_Monocular_social_ranging/.pre-commit-config.yaml @@ -0,0 +1,66 @@ +# Define hooks for code formations +# Will be applied on any updated commit files if a user has installed and linked commit hook + +default_language_version: + python: python3.8 + +# Define bot property if installed via https://github.com/marketplace/pre-commit-ci +ci: + autofix_prs: true + autoupdate_commit_msg: '[pre-commit.ci] pre-commit suggestions' + autoupdate_schedule: quarterly + # submodules: true + +repos: + - repo: https://github.com/pre-commit/pre-commit-hooks + rev: v4.1.0 + hooks: + - id: end-of-file-fixer + - id: trailing-whitespace + - id: check-case-conflict + - id: check-yaml + - id: check-toml + - id: pretty-format-json + - id: check-docstring-first + + - repo: https://github.com/asottile/pyupgrade + rev: v2.31.0 + hooks: + - id: pyupgrade + args: [--py36-plus] + name: Upgrade code + + - repo: https://github.com/PyCQA/isort + rev: 5.10.1 + hooks: + - id: isort + name: Sort imports + + # TODO + #- repo: https://github.com/pre-commit/mirrors-yapf + # rev: v0.31.0 + # hooks: + # - id: yapf + # name: formatting + + # TODO + #- repo: https://github.com/executablebooks/mdformat + # rev: 0.7.7 + # hooks: + # - id: mdformat + # additional_dependencies: + # - mdformat-gfm + # - mdformat-black + # - mdformat_frontmatter + + # TODO + #- repo: https://github.com/asottile/yesqa + # rev: v1.2.3 + # hooks: + # - id: yesqa + + - repo: https://github.com/PyCQA/flake8 + rev: 4.0.1 + hooks: + - id: flake8 + name: PEP8 diff --git a/ultralytics-main/ultralytics/solutions/d_speed.py b/yolov5_Monocular_social_ranging/0.8.1' similarity index 100% rename from ultralytics-main/ultralytics/solutions/d_speed.py rename to yolov5_Monocular_social_ranging/0.8.1' diff --git a/yolov5_Monocular_social_ranging/CONTRIBUTING.md b/yolov5_Monocular_social_ranging/CONTRIBUTING.md new file mode 100644 index 0000000..ebde03a --- /dev/null +++ b/yolov5_Monocular_social_ranging/CONTRIBUTING.md @@ -0,0 +1,94 @@ +## Contributing to YOLOv5 🚀 + +We love your input! We want to make contributing to YOLOv5 as easy and transparent as possible, whether it's: + +- Reporting a bug +- Discussing the current state of the code +- Submitting a fix +- Proposing a new feature +- Becoming a maintainer + +YOLOv5 works so well due to our combined community effort, and for every small improvement you contribute you will be +helping push the frontiers of what's possible in AI 😃! + +## Submitting a Pull Request (PR) 🛠️ + +Submitting a PR is easy! This example shows how to submit a PR for updating `requirements.txt` in 4 steps: + +### 1. Select File to Update + +Select `requirements.txt` to update by clicking on it in GitHub. +

PR_step1

+ +### 2. Click 'Edit this file' + +Button is in top-right corner. +

PR_step2

+ +### 3. Make Changes + +Change `matplotlib` version from `3.2.2` to `3.3`. +

PR_step3

+ +### 4. Preview Changes and Submit PR + +Click on the **Preview changes** tab to verify your updates. At the bottom of the screen select 'Create a **new branch** +for this commit', assign your branch a descriptive name such as `fix/matplotlib_version` and click the green **Propose +changes** button. All done, your PR is now submitted to YOLOv5 for review and approval 😃! +

PR_step4

+ +### PR recommendations + +To allow your work to be integrated as seamlessly as possible, we advise you to: + +- ✅ Verify your PR is **up-to-date with upstream/master.** If your PR is behind upstream/master an + automatic [GitHub Actions](https://github.com/ultralytics/yolov5/blob/master/.github/workflows/rebase.yml) merge may + be attempted by writing /rebase in a new comment, or by running the following code, replacing 'feature' with the name + of your local branch: + +```bash +git remote add upstream https://github.com/ultralytics/yolov5.git +git fetch upstream +# git checkout feature # <--- replace 'feature' with local branch name +git merge upstream/master +git push -u origin -f +``` + +- ✅ Verify all Continuous Integration (CI) **checks are passing**. +- ✅ Reduce changes to the absolute **minimum** required for your bug fix or feature addition. _"It is not daily increase + but daily decrease, hack away the unessential. The closer to the source, the less wastage there is."_ — Bruce Lee + +## Submitting a Bug Report 🐛 + +If you spot a problem with YOLOv5 please submit a Bug Report! + +For us to start investigating a possible problem we need to be able to reproduce it ourselves first. We've created a few +short guidelines below to help users provide what we need in order to get started. + +When asking a question, people will be better able to provide help if you provide **code** that they can easily +understand and use to **reproduce** the problem. This is referred to by community members as creating +a [minimum reproducible example](https://stackoverflow.com/help/minimal-reproducible-example). Your code that reproduces +the problem should be: + +* ✅ **Minimal** – Use as little code as possible that still produces the same problem +* ✅ **Complete** – Provide **all** parts someone else needs to reproduce your problem in the question itself +* ✅ **Reproducible** – Test the code you're about to provide to make sure it reproduces the problem + +In addition to the above requirements, for [Ultralytics](https://ultralytics.com/) to provide assistance your code +should be: + +* ✅ **Current** – Verify that your code is up-to-date with current + GitHub [master](https://github.com/ultralytics/yolov5/tree/master), and if necessary `git pull` or `git clone` a new + copy to ensure your problem has not already been resolved by previous commits. +* ✅ **Unmodified** – Your problem must be reproducible without any modifications to the codebase in this + repository. [Ultralytics](https://ultralytics.com/) does not provide support for custom code ⚠️. + +If you believe your problem meets all of the above criteria, please close this issue and raise a new one using the 🐛 ** +Bug Report** [template](https://github.com/ultralytics/yolov5/issues/new/choose) and providing +a [minimum reproducible example](https://stackoverflow.com/help/minimal-reproducible-example) to help us better +understand and diagnose your problem. + +## License + +By contributing, you agree that your contributions will be licensed under +the [GPL-3.0 license](https://choosealicense.com/licenses/gpl-3.0/) diff --git a/yolov5_Monocular_social_ranging/Dockerfile b/yolov5_Monocular_social_ranging/Dockerfile new file mode 100644 index 0000000..489dd04 --- /dev/null +++ b/yolov5_Monocular_social_ranging/Dockerfile @@ -0,0 +1,64 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Start FROM Nvidia PyTorch image https://ngc.nvidia.com/catalog/containers/nvidia:pytorch +FROM nvcr.io/nvidia/pytorch:21.10-py3 + +# Install linux packages +RUN apt update && apt install -y zip htop screen libgl1-mesa-glx + +# Install python dependencies +COPY requirements.txt . +RUN python -m pip install --upgrade pip +RUN pip uninstall -y torch torchvision torchtext +RUN pip install --no-cache -r requirements.txt albumentations wandb gsutil notebook \ + torch==1.10.2+cu113 torchvision==0.11.3+cu113 -f https://download.pytorch.org/whl/cu113/torch_stable.html +# RUN pip install --no-cache -U torch torchvision + +# Create working directory +RUN mkdir -p /usr/src/app +WORKDIR /usr/src/app + +# Copy contents +COPY . /usr/src/app + +# Downloads to user config dir +ADD https://ultralytics.com/assets/Arial.ttf /root/.config/Ultralytics/ + +# Set environment variables +# ENV HOME=/usr/src/app + + +# Usage Examples ------------------------------------------------------------------------------------------------------- + +# Build and Push +# t=ultralytics/yolov5:latest && sudo docker build -t $t . && sudo docker push $t + +# Pull and Run +# t=ultralytics/yolov5:latest && sudo docker pull $t && sudo docker run -it --ipc=host --gpus all $t + +# Pull and Run with local directory access +# t=ultralytics/yolov5:latest && sudo docker pull $t && sudo docker run -it --ipc=host --gpus all -v "$(pwd)"/datasets:/usr/src/datasets $t + +# Kill all +# sudo docker kill $(sudo docker ps -q) + +# Kill all image-based +# sudo docker kill $(sudo docker ps -qa --filter ancestor=ultralytics/yolov5:latest) + +# Bash into running container +# sudo docker exec -it 5a9b5863d93d bash + +# Bash into stopped container +# id=$(sudo docker ps -qa) && sudo docker start $id && sudo docker exec -it $id bash + +# Clean up +# docker system prune -a --volumes + +# Update Ubuntu drivers +# https://www.maketecheasier.com/install-nvidia-drivers-ubuntu/ + +# DDP test +# python -m torch.distributed.run --nproc_per_node 2 --master_port 1 train.py --epochs 3 + +# GCP VM from Image +# docker.io/ultralytics/yolov5:latest diff --git a/ultralytics-main/LICENSE b/yolov5_Monocular_social_ranging/LICENSE similarity index 86% rename from ultralytics-main/LICENSE rename to yolov5_Monocular_social_ranging/LICENSE index be3f7b2..92b370f 100644 --- a/ultralytics-main/LICENSE +++ b/yolov5_Monocular_social_ranging/LICENSE @@ -1,21 +1,23 @@ - GNU AFFERO GENERAL PUBLIC LICENSE - Version 3, 19 November 2007 +GNU GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 - Copyright (C) 2007 Free Software Foundation, Inc. + Copyright (C) 2007 Free Software Foundation, Inc. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble - The GNU Affero General Public License is a free, copyleft license for -software and other kinds of works, specifically designed to ensure -cooperation with the community in the case of network server software. + The GNU General Public License is a free, copyleft license for +software and other kinds of works. The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, -our General Public Licenses are intended to guarantee your freedom to +the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free -software for all its users. +software for all its users. We, the Free Software Foundation, use the +GNU General Public License for most of our software; it applies also to +any other work released this way by its authors. You can apply it to +your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you @@ -24,34 +26,44 @@ them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things. - Developers that use our General Public Licenses protect your rights -with two steps: (1) assert copyright on the software, and (2) offer -you this License which gives you legal permission to copy, distribute -and/or modify the software. - - A secondary benefit of defending all users' freedom is that -improvements made in alternate versions of the program, if they -receive widespread use, become available for other developers to -incorporate. Many developers of free software are heartened and -encouraged by the resulting cooperation. However, in the case of -software used on network servers, this result may fail to come about. -The GNU General Public License permits making a modified version and -letting the public access it on a server without ever releasing its -source code to the public. - - The GNU Affero General Public License is designed specifically to -ensure that, in such cases, the modified source code becomes available -to the community. It requires the operator of a network server to -provide the source code of the modified version running there to the -users of that server. Therefore, public use of a modified version, on -a publicly accessible server, gives the public access to the source -code of the modified version. - - An older license, called the Affero General Public License and -published by Affero, was designed to accomplish similar goals. This is -a different license, not a version of the Affero GPL, but Affero has -released a new version of the Affero GPL which permits relicensing under -this license. + To protect your rights, we need to prevent others from denying you +these rights or asking you to surrender the rights. Therefore, you have +certain responsibilities if you distribute copies of the software, or if +you modify it: responsibilities to respect the freedom of others. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must pass on to the recipients the same +freedoms that you received. You must make sure that they, too, receive +or can get the source code. And you must show them these terms so they +know their rights. + + Developers that use the GNU GPL protect your rights with two steps: +(1) assert copyright on the software, and (2) offer you this License +giving you legal permission to copy, distribute and/or modify it. + + For the developers' and authors' protection, the GPL clearly explains +that there is no warranty for this free software. For both users' and +authors' sake, the GPL requires that modified versions be marked as +changed, so that their problems will not be attributed erroneously to +authors of previous versions. + + Some devices are designed to deny users access to install or run +modified versions of the software inside them, although the manufacturer +can do so. This is fundamentally incompatible with the aim of +protecting users' freedom to change the software. The systematic +pattern of such abuse occurs in the area of products for individuals to +use, which is precisely where it is most unacceptable. Therefore, we +have designed this version of the GPL to prohibit the practice for those +products. If such problems arise substantially in other domains, we +stand ready to extend this provision to those domains in future versions +of the GPL, as needed to protect the freedom of users. + + Finally, every program is threatened constantly by software patents. +States should not allow patents to restrict development and use of +software on general-purpose computers, but in those that do, we wish to +avoid the special danger that patents applied to a free program could +make it effectively proprietary. To prevent this, the GPL assures that +patents cannot be used to render the program non-free. The precise terms and conditions for copying, distribution and modification follow. @@ -60,7 +72,7 @@ modification follow. 0. Definitions. - "This License" refers to version 3 of the GNU Affero General Public License. + "This License" refers to version 3 of the GNU General Public License. "Copyright" also means copyright-like laws that apply to other kinds of works, such as semiconductor masks. @@ -537,45 +549,35 @@ to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program. - 13. Remote Network Interaction; Use with the GNU General Public License. - - Notwithstanding any other provision of this License, if you modify the -Program, your modified version must prominently offer all users -interacting with it remotely through a computer network (if your version -supports such interaction) an opportunity to receive the Corresponding -Source of your version by providing access to the Corresponding Source -from a network server at no charge, through some standard or customary -means of facilitating copying of software. This Corresponding Source -shall include the Corresponding Source for any work covered by version 3 -of the GNU General Public License that is incorporated pursuant to the -following paragraph. + 13. Use with the GNU Affero General Public License. Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed -under version 3 of the GNU General Public License into a single +under version 3 of the GNU Affero General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, -but the work with which it is combined will remain governed by version -3 of the GNU General Public License. +but the special requirements of the GNU Affero General Public License, +section 13, concerning interaction through a network will apply to the +combination as such. 14. Revised Versions of this License. The Free Software Foundation may publish revised and/or new versions of -the GNU Affero General Public License from time to time. Such new versions -will be similar in spirit to the present version, but may differ in detail to +the GNU General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the -Program specifies that a certain numbered version of the GNU Affero General +Program specifies that a certain numbered version of the GNU General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the -GNU Affero General Public License, you may choose any version ever published +GNU General Public License, you may choose any version ever published by the Free Software Foundation. If the Program specifies that a proxy can decide which future -versions of the GNU Affero General Public License can be used, that proxy's +versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program. @@ -633,29 +635,40 @@ the "copyright" line and a pointer to where the full notice is found. Copyright (C) This program is free software: you can redistribute it and/or modify - it under the terms of the GNU Affero General Public License as published by + it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU Affero General Public License for more details. + GNU General Public License for more details. - You should have received a copy of the GNU Affero General Public License - along with this program. If not, see . + You should have received a copy of the GNU General Public License + along with this program. If not, see . Also add information on how to contact you by electronic and paper mail. - If your software can interact with users remotely through a computer -network, you should also make sure that it provides a way for users to -get its source. For example, if your program is a web application, its -interface could display a "Source" link that leads users to an archive -of the code. There are many ways you could offer source, and different -solutions will be better for different programs; see section 13 for the -specific requirements. + If the program does terminal interaction, make it output a short +notice like this when it starts in an interactive mode: + + Copyright (C) + This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, your program's commands +might be different; for a GUI interface, you would use an "about box". You should also get your employer (if you work as a programmer) or school, if any, to sign a "copyright disclaimer" for the program, if necessary. -For more information on this, and how to apply and follow the GNU AGPL, see -. +For more information on this, and how to apply and follow the GNU GPL, see +. + + The GNU General Public License does not permit incorporating your program +into proprietary programs. If your program is a subroutine library, you +may consider it more useful to permit linking proprietary applications with +the library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. But first, please read +. diff --git a/yolov5_Monocular_social_ranging/README.md b/yolov5_Monocular_social_ranging/README.md new file mode 100644 index 0000000..b03a7c5 --- /dev/null +++ b/yolov5_Monocular_social_ranging/README.md @@ -0,0 +1,304 @@ +
+

+ + +

+
+
+ CI CPU testing + YOLOv5 Citation + Docker Pulls +
+ Open In Colab + Open In Kaggle + Join Forum +
+ +
+

+YOLOv5 🚀 is a family of object detection architectures and models pretrained on the COCO dataset, and represents Ultralytics + open-source research into future vision AI methods, incorporating lessons learned and best practices evolved over thousands of hours of research and development. +

+ + + + + +
+ +##
Documentation
+ +See the [YOLOv5 Docs](https://docs.ultralytics.com) for full documentation on training, testing and deployment. + +##
Quick Start Examples
+ +
+Install + +Clone repo and install [requirements.txt](https://github.com/ultralytics/yolov5/blob/master/requirements.txt) in a +[**Python>=3.7.0**](https://www.python.org/) environment, including +[**PyTorch>=1.7**](https://pytorch.org/get-started/locally/). + +```bash +git clone https://github.com/ultralytics/yolov5 # clone +cd yolov5 +pip install -r requirements.txt # install +``` + +
+ +
+Inference + +Inference with YOLOv5 and [PyTorch Hub](https://github.com/ultralytics/yolov5/issues/36) +. [Models](https://github.com/ultralytics/yolov5/tree/master/models) download automatically from the latest +YOLOv5 [release](https://github.com/ultralytics/yolov5/releases). + +```python +import torch + +# Model +model = torch.hub.load('ultralytics/yolov5', 'yolov5s') # or yolov5m, yolov5l, yolov5x, custom + +# Images +img = 'https://ultralytics.com/images/zidane.jpg' # or file, Path, PIL, OpenCV, numpy, list + +# Inference +results = model(img) + +# Results +results.print() # or .show(), .save(), .crop(), .pandas(), etc. +``` + +
+ + + +
+Inference with detect.py + +`detect.py` runs inference on a variety of sources, downloading [models](https://github.com/ultralytics/yolov5/tree/master/models) automatically from +the latest YOLOv5 [release](https://github.com/ultralytics/yolov5/releases) and saving results to `runs/detect`. + +```bash +python detect.py --source 0 # webcam + img.jpg # image + vid.mp4 # video + path/ # directory + path/*.jpg # glob + 'https://youtu.be/Zgi9g1ksQHc' # YouTube + 'rtsp://example.com/media.mp4' # RTSP, RTMP, HTTP stream +``` + +
+ +
+Training + +The commands below reproduce YOLOv5 [COCO](https://github.com/ultralytics/yolov5/blob/master/data/scripts/get_coco.sh) +results. [Models](https://github.com/ultralytics/yolov5/tree/master/models) +and [datasets](https://github.com/ultralytics/yolov5/tree/master/data) download automatically from the latest +YOLOv5 [release](https://github.com/ultralytics/yolov5/releases). Training times for YOLOv5n/s/m/l/x are +1/2/4/6/8 days on a V100 GPU ([Multi-GPU](https://github.com/ultralytics/yolov5/issues/475) times faster). Use the +largest `--batch-size` possible, or pass `--batch-size -1` for +YOLOv5 [AutoBatch](https://github.com/ultralytics/yolov5/pull/5092). Batch sizes shown for V100-16GB. + +```bash +python train.py --data coco.yaml --cfg yolov5n.yaml --weights '' --batch-size 128 + yolov5s 64 + yolov5m 40 + yolov5l 24 + yolov5x 16 +``` + + + +
+ +
+Tutorials + +* [Train Custom Data](https://github.com/ultralytics/yolov5/wiki/Train-Custom-Data)  🚀 RECOMMENDED +* [Tips for Best Training Results](https://github.com/ultralytics/yolov5/wiki/Tips-for-Best-Training-Results)  ☘️ + RECOMMENDED +* [Weights & Biases Logging](https://github.com/ultralytics/yolov5/issues/1289)  🌟 NEW +* [Roboflow for Datasets, Labeling, and Active Learning](https://github.com/ultralytics/yolov5/issues/4975)  🌟 NEW +* [Multi-GPU Training](https://github.com/ultralytics/yolov5/issues/475) +* [PyTorch Hub](https://github.com/ultralytics/yolov5/issues/36)  ⭐ NEW +* [TFLite, ONNX, CoreML, TensorRT Export](https://github.com/ultralytics/yolov5/issues/251) 🚀 +* [Test-Time Augmentation (TTA)](https://github.com/ultralytics/yolov5/issues/303) +* [Model Ensembling](https://github.com/ultralytics/yolov5/issues/318) +* [Model Pruning/Sparsity](https://github.com/ultralytics/yolov5/issues/304) +* [Hyperparameter Evolution](https://github.com/ultralytics/yolov5/issues/607) +* [Transfer Learning with Frozen Layers](https://github.com/ultralytics/yolov5/issues/1314)  ⭐ NEW +* [TensorRT Deployment](https://github.com/wang-xinyu/tensorrtx) + +
+ +##
Environments
+ +Get started in seconds with our verified environments. Click each icon below for details. + + + +##
Integrations
+ + + +|Weights and Biases|Roboflow ⭐ NEW| +|:-:|:-:| +|Automatically track and visualize all your YOLOv5 training runs in the cloud with [Weights & Biases](https://wandb.ai/site?utm_campaign=repo_yolo_readme)|Label and export your custom datasets directly to YOLOv5 for training with [Roboflow](https://roboflow.com/?ref=ultralytics) | + + + + +##
Why YOLOv5
+ +

+
+ YOLOv5-P5 640 Figure (click to expand) + +

+
+
+ Figure Notes (click to expand) + +* **COCO AP val** denotes mAP@0.5:0.95 metric measured on the 5000-image [COCO val2017](http://cocodataset.org) dataset over various inference sizes from 256 to 1536. +* **GPU Speed** measures average inference time per image on [COCO val2017](http://cocodataset.org) dataset using a [AWS p3.2xlarge](https://aws.amazon.com/ec2/instance-types/p3/) V100 instance at batch-size 32. +* **EfficientDet** data from [google/automl](https://github.com/google/automl) at batch size 8. +* **Reproduce** by `python val.py --task study --data coco.yaml --iou 0.7 --weights yolov5n6.pt yolov5s6.pt yolov5m6.pt yolov5l6.pt yolov5x6.pt` +
+ +### Pretrained Checkpoints + +[assets]: https://github.com/ultralytics/yolov5/releases + +[TTA]: https://github.com/ultralytics/yolov5/issues/303 + +|Model |size
(pixels) |mAPval
0.5:0.95 |mAPval
0.5 |Speed
CPU b1
(ms) |Speed
V100 b1
(ms) |Speed
V100 b32
(ms) |params
(M) |FLOPs
@640 (B) +|--- |--- |--- |--- |--- |--- |--- |--- |--- +|[YOLOv5n][assets] |640 |28.0 |45.7 |**45** |**6.3**|**0.6**|**1.9**|**4.5** +|[YOLOv5s][assets] |640 |37.4 |56.8 |98 |6.4 |0.9 |7.2 |16.5 +|[YOLOv5m][assets] |640 |45.4 |64.1 |224 |8.2 |1.7 |21.2 |49.0 +|[YOLOv5l][assets] |640 |49.0 |67.3 |430 |10.1 |2.7 |46.5 |109.1 +|[YOLOv5x][assets] |640 |50.7 |68.9 |766 |12.1 |4.8 |86.7 |205.7 +| | | | | | | | | +|[YOLOv5n6][assets] |1280 |36.0 |54.4 |153 |8.1 |2.1 |3.2 |4.6 +|[YOLOv5s6][assets] |1280 |44.8 |63.7 |385 |8.2 |3.6 |16.8 |12.6 +|[YOLOv5m6][assets] |1280 |51.3 |69.3 |887 |11.1 |6.8 |35.7 |50.0 +|[YOLOv5l6][assets] |1280 |53.7 |71.3 |1784 |15.8 |10.5 |76.8 |111.4 +|[YOLOv5x6][assets]
+ [TTA][TTA]|1280
1536 |55.0
**55.8** |72.7
**72.7** |3136
- |26.2
- |19.4
- |140.7
- |209.8
- + +
+ Table Notes (click to expand) + +* All checkpoints are trained to 300 epochs with default settings. Nano and Small models use [hyp.scratch-low.yaml](https://github.com/ultralytics/yolov5/blob/master/data/hyps/hyp.scratch-low.yaml) hyps, all others use [hyp.scratch-high.yaml](https://github.com/ultralytics/yolov5/blob/master/data/hyps/hyp.scratch-high.yaml). +* **mAPval** values are for single-model single-scale on [COCO val2017](http://cocodataset.org) dataset.
Reproduce by `python val.py --data coco.yaml --img 640 --conf 0.001 --iou 0.65` +* **Speed** averaged over COCO val images using a [AWS p3.2xlarge](https://aws.amazon.com/ec2/instance-types/p3/) instance. NMS times (~1 ms/img) not included.
Reproduce by `python val.py --data coco.yaml --img 640 --task speed --batch 1` +* **TTA** [Test Time Augmentation](https://github.com/ultralytics/yolov5/issues/303) includes reflection and scale augmentations.
Reproduce by `python val.py --data coco.yaml --img 1536 --iou 0.7 --augment` + +
+ +##
Contribute
+ +We love your input! We want to make contributing to YOLOv5 as easy and transparent as possible. Please see our [Contributing Guide](CONTRIBUTING.md) to get started, and fill out the [YOLOv5 Survey](https://ultralytics.com/survey?utm_source=github&utm_medium=social&utm_campaign=Survey) to send us feedback on your experiences. Thank you to all our contributors! + + + +##
Contact
+ +For YOLOv5 bugs and feature requests please visit [GitHub Issues](https://github.com/ultralytics/yolov5/issues). For business inquiries or +professional support requests please visit [https://ultralytics.com/contact](https://ultralytics.com/contact). + +
+ + diff --git a/yolov5_Monocular_social_ranging/data/Argoverse.yaml b/yolov5_Monocular_social_ranging/data/Argoverse.yaml new file mode 100644 index 0000000..312791b --- /dev/null +++ b/yolov5_Monocular_social_ranging/data/Argoverse.yaml @@ -0,0 +1,67 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +# Argoverse-HD dataset (ring-front-center camera) http://www.cs.cmu.edu/~mengtial/proj/streaming/ by Argo AI +# Example usage: python train.py --data Argoverse.yaml +# parent +# ├── yolov5 +# └── datasets +# └── Argoverse ← downloads here + + +# Train/val/test sets as 1) dir: path/to/imgs, 2) file: path/to/imgs.txt, or 3) list: [path/to/imgs1, path/to/imgs2, ..] +path: ../datasets/Argoverse # dataset root dir +train: Argoverse-1.1/images/train/ # train images (relative to 'path') 39384 images +val: Argoverse-1.1/images/val/ # val images (relative to 'path') 15062 images +test: Argoverse-1.1/images/test/ # test images (optional) https://eval.ai/web/challenges/challenge-page/800/overview + +# Classes +nc: 8 # number of classes +names: ['person', 'bicycle', 'car', 'motorcycle', 'bus', 'truck', 'traffic_light', 'stop_sign'] # class names + + +# Download script/URL (optional) --------------------------------------------------------------------------------------- +download: | + import json + + from tqdm import tqdm + from utils.general import download, Path + + + def argoverse2yolo(set): + labels = {} + a = json.load(open(set, "rb")) + for annot in tqdm(a['annotations'], desc=f"Converting {set} to YOLOv5 format..."): + img_id = annot['image_id'] + img_name = a['images'][img_id]['name'] + img_label_name = img_name[:-3] + "txt" + + cls = annot['category_id'] # instance class id + x_center, y_center, width, height = annot['bbox'] + x_center = (x_center + width / 2) / 1920.0 # offset and scale + y_center = (y_center + height / 2) / 1200.0 # offset and scale + width /= 1920.0 # scale + height /= 1200.0 # scale + + img_dir = set.parents[2] / 'Argoverse-1.1' / 'labels' / a['seq_dirs'][a['images'][annot['image_id']]['sid']] + if not img_dir.exists(): + img_dir.mkdir(parents=True, exist_ok=True) + + k = str(img_dir / img_label_name) + if k not in labels: + labels[k] = [] + labels[k].append(f"{cls} {x_center} {y_center} {width} {height}\n") + + for k in labels: + with open(k, "w") as f: + f.writelines(labels[k]) + + + # Download + dir = Path('../datasets/Argoverse') # dataset root dir + urls = ['https://argoverse-hd.s3.us-east-2.amazonaws.com/Argoverse-HD-Full.zip'] + download(urls, dir=dir, delete=False) + + # Convert + annotations_dir = 'Argoverse-HD/annotations/' + (dir / 'Argoverse-1.1' / 'tracking').rename(dir / 'Argoverse-1.1' / 'images') # rename 'tracking' to 'images' + for d in "train.json", "val.json": + argoverse2yolo(dir / annotations_dir / d) # convert VisDrone annotations to YOLO labels diff --git a/yolov5_Monocular_social_ranging/data/GlobalWheat2020.yaml b/yolov5_Monocular_social_ranging/data/GlobalWheat2020.yaml new file mode 100644 index 0000000..869dace --- /dev/null +++ b/yolov5_Monocular_social_ranging/data/GlobalWheat2020.yaml @@ -0,0 +1,53 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +# Global Wheat 2020 dataset http://www.global-wheat.com/ by University of Saskatchewan +# Example usage: python train.py --data GlobalWheat2020.yaml +# parent +# ├── yolov5 +# └── datasets +# └── GlobalWheat2020 ← downloads here + + +# Train/val/test sets as 1) dir: path/to/imgs, 2) file: path/to/imgs.txt, or 3) list: [path/to/imgs1, path/to/imgs2, ..] +path: ../datasets/GlobalWheat2020 # dataset root dir +train: # train images (relative to 'path') 3422 images + - images/arvalis_1 + - images/arvalis_2 + - images/arvalis_3 + - images/ethz_1 + - images/rres_1 + - images/inrae_1 + - images/usask_1 +val: # val images (relative to 'path') 748 images (WARNING: train set contains ethz_1) + - images/ethz_1 +test: # test images (optional) 1276 images + - images/utokyo_1 + - images/utokyo_2 + - images/nau_1 + - images/uq_1 + +# Classes +nc: 1 # number of classes +names: ['wheat_head'] # class names + + +# Download script/URL (optional) --------------------------------------------------------------------------------------- +download: | + from utils.general import download, Path + + # Download + dir = Path(yaml['path']) # dataset root dir + urls = ['https://zenodo.org/record/4298502/files/global-wheat-codalab-official.zip', + 'https://github.com/ultralytics/yolov5/releases/download/v1.0/GlobalWheat2020_labels.zip'] + download(urls, dir=dir) + + # Make Directories + for p in 'annotations', 'images', 'labels': + (dir / p).mkdir(parents=True, exist_ok=True) + + # Move + for p in 'arvalis_1', 'arvalis_2', 'arvalis_3', 'ethz_1', 'rres_1', 'inrae_1', 'usask_1', \ + 'utokyo_1', 'utokyo_2', 'nau_1', 'uq_1': + (dir / p).rename(dir / 'images' / p) # move to /images + f = (dir / p).with_suffix('.json') # json file + if f.exists(): + f.rename((dir / 'annotations' / p).with_suffix('.json')) # move to /annotations diff --git a/yolov5_Monocular_social_ranging/data/Objects365.yaml b/yolov5_Monocular_social_ranging/data/Objects365.yaml new file mode 100644 index 0000000..4c7cf3f --- /dev/null +++ b/yolov5_Monocular_social_ranging/data/Objects365.yaml @@ -0,0 +1,112 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +# Objects365 dataset https://www.objects365.org/ by Megvii +# Example usage: python train.py --data Objects365.yaml +# parent +# ├── yolov5 +# └── datasets +# └── Objects365 ← downloads here + + +# Train/val/test sets as 1) dir: path/to/imgs, 2) file: path/to/imgs.txt, or 3) list: [path/to/imgs1, path/to/imgs2, ..] +path: ../datasets/Objects365 # dataset root dir +train: images/train # train images (relative to 'path') 1742289 images +val: images/val # val images (relative to 'path') 80000 images +test: # test images (optional) + +# Classes +nc: 365 # number of classes +names: ['Person', 'Sneakers', 'Chair', 'Other Shoes', 'Hat', 'Car', 'Lamp', 'Glasses', 'Bottle', 'Desk', 'Cup', + 'Street Lights', 'Cabinet/shelf', 'Handbag/Satchel', 'Bracelet', 'Plate', 'Picture/Frame', 'Helmet', 'Book', + 'Gloves', 'Storage box', 'Boat', 'Leather Shoes', 'Flower', 'Bench', 'Potted Plant', 'Bowl/Basin', 'Flag', + 'Pillow', 'Boots', 'Vase', 'Microphone', 'Necklace', 'Ring', 'SUV', 'Wine Glass', 'Belt', 'Monitor/TV', + 'Backpack', 'Umbrella', 'Traffic Light', 'Speaker', 'Watch', 'Tie', 'Trash bin Can', 'Slippers', 'Bicycle', + 'Stool', 'Barrel/bucket', 'Van', 'Couch', 'Sandals', 'Basket', 'Drum', 'Pen/Pencil', 'Bus', 'Wild Bird', + 'High Heels', 'Motorcycle', 'Guitar', 'Carpet', 'Cell Phone', 'Bread', 'Camera', 'Canned', 'Truck', + 'Traffic cone', 'Cymbal', 'Lifesaver', 'Towel', 'Stuffed Toy', 'Candle', 'Sailboat', 'Laptop', 'Awning', + 'Bed', 'Faucet', 'Tent', 'Horse', 'Mirror', 'Power outlet', 'Sink', 'Apple', 'Air Conditioner', 'Knife', + 'Hockey Stick', 'Paddle', 'Pickup Truck', 'Fork', 'Traffic Sign', 'Balloon', 'Tripod', 'Dog', 'Spoon', 'Clock', + 'Pot', 'Cow', 'Cake', 'Dinning Table', 'Sheep', 'Hanger', 'Blackboard/Whiteboard', 'Napkin', 'Other Fish', + 'Orange/Tangerine', 'Toiletry', 'Keyboard', 'Tomato', 'Lantern', 'Machinery Vehicle', 'Fan', + 'Green Vegetables', 'Banana', 'Baseball Glove', 'Airplane', 'Mouse', 'Train', 'Pumpkin', 'Soccer', 'Skiboard', + 'Luggage', 'Nightstand', 'Tea pot', 'Telephone', 'Trolley', 'Head Phone', 'Sports Car', 'Stop Sign', + 'Dessert', 'Scooter', 'Stroller', 'Crane', 'Remote', 'Refrigerator', 'Oven', 'Lemon', 'Duck', 'Baseball Bat', + 'Surveillance Camera', 'Cat', 'Jug', 'Broccoli', 'Piano', 'Pizza', 'Elephant', 'Skateboard', 'Surfboard', + 'Gun', 'Skating and Skiing shoes', 'Gas stove', 'Donut', 'Bow Tie', 'Carrot', 'Toilet', 'Kite', 'Strawberry', + 'Other Balls', 'Shovel', 'Pepper', 'Computer Box', 'Toilet Paper', 'Cleaning Products', 'Chopsticks', + 'Microwave', 'Pigeon', 'Baseball', 'Cutting/chopping Board', 'Coffee Table', 'Side Table', 'Scissors', + 'Marker', 'Pie', 'Ladder', 'Snowboard', 'Cookies', 'Radiator', 'Fire Hydrant', 'Basketball', 'Zebra', 'Grape', + 'Giraffe', 'Potato', 'Sausage', 'Tricycle', 'Violin', 'Egg', 'Fire Extinguisher', 'Candy', 'Fire Truck', + 'Billiards', 'Converter', 'Bathtub', 'Wheelchair', 'Golf Club', 'Briefcase', 'Cucumber', 'Cigar/Cigarette', + 'Paint Brush', 'Pear', 'Heavy Truck', 'Hamburger', 'Extractor', 'Extension Cord', 'Tong', 'Tennis Racket', + 'Folder', 'American Football', 'earphone', 'Mask', 'Kettle', 'Tennis', 'Ship', 'Swing', 'Coffee Machine', + 'Slide', 'Carriage', 'Onion', 'Green beans', 'Projector', 'Frisbee', 'Washing Machine/Drying Machine', + 'Chicken', 'Printer', 'Watermelon', 'Saxophone', 'Tissue', 'Toothbrush', 'Ice cream', 'Hot-air balloon', + 'Cello', 'French Fries', 'Scale', 'Trophy', 'Cabbage', 'Hot dog', 'Blender', 'Peach', 'Rice', 'Wallet/Purse', + 'Volleyball', 'Deer', 'Goose', 'Tape', 'Tablet', 'Cosmetics', 'Trumpet', 'Pineapple', 'Golf Ball', + 'Ambulance', 'Parking meter', 'Mango', 'Key', 'Hurdle', 'Fishing Rod', 'Medal', 'Flute', 'Brush', 'Penguin', + 'Megaphone', 'Corn', 'Lettuce', 'Garlic', 'Swan', 'Helicopter', 'Green Onion', 'Sandwich', 'Nuts', + 'Speed Limit Sign', 'Induction Cooker', 'Broom', 'Trombone', 'Plum', 'Rickshaw', 'Goldfish', 'Kiwi fruit', + 'Router/modem', 'Poker Card', 'Toaster', 'Shrimp', 'Sushi', 'Cheese', 'Notepaper', 'Cherry', 'Pliers', 'CD', + 'Pasta', 'Hammer', 'Cue', 'Avocado', 'Hamimelon', 'Flask', 'Mushroom', 'Screwdriver', 'Soap', 'Recorder', + 'Bear', 'Eggplant', 'Board Eraser', 'Coconut', 'Tape Measure/Ruler', 'Pig', 'Showerhead', 'Globe', 'Chips', + 'Steak', 'Crosswalk Sign', 'Stapler', 'Camel', 'Formula 1', 'Pomegranate', 'Dishwasher', 'Crab', + 'Hoverboard', 'Meat ball', 'Rice Cooker', 'Tuba', 'Calculator', 'Papaya', 'Antelope', 'Parrot', 'Seal', + 'Butterfly', 'Dumbbell', 'Donkey', 'Lion', 'Urinal', 'Dolphin', 'Electric Drill', 'Hair Dryer', 'Egg tart', + 'Jellyfish', 'Treadmill', 'Lighter', 'Grapefruit', 'Game board', 'Mop', 'Radish', 'Baozi', 'Target', 'French', + 'Spring Rolls', 'Monkey', 'Rabbit', 'Pencil Case', 'Yak', 'Red Cabbage', 'Binoculars', 'Asparagus', 'Barbell', + 'Scallop', 'Noddles', 'Comb', 'Dumpling', 'Oyster', 'Table Tennis paddle', 'Cosmetics Brush/Eyeliner Pencil', + 'Chainsaw', 'Eraser', 'Lobster', 'Durian', 'Okra', 'Lipstick', 'Cosmetics Mirror', 'Curling', 'Table Tennis'] + + +# Download script/URL (optional) --------------------------------------------------------------------------------------- +download: | + from pycocotools.coco import COCO + from tqdm import tqdm + + from utils.general import Path, download, np, xyxy2xywhn + + # Make Directories + dir = Path(yaml['path']) # dataset root dir + for p in 'images', 'labels': + (dir / p).mkdir(parents=True, exist_ok=True) + for q in 'train', 'val': + (dir / p / q).mkdir(parents=True, exist_ok=True) + + # Train, Val Splits + for split, patches in [('train', 50 + 1), ('val', 43 + 1)]: + print(f"Processing {split} in {patches} patches ...") + images, labels = dir / 'images' / split, dir / 'labels' / split + + # Download + url = f"https://dorc.ks3-cn-beijing.ksyun.com/data-set/2020Objects365%E6%95%B0%E6%8D%AE%E9%9B%86/{split}/" + if split == 'train': + download([f'{url}zhiyuan_objv2_{split}.tar.gz'], dir=dir, delete=False) # annotations json + download([f'{url}patch{i}.tar.gz' for i in range(patches)], dir=images, curl=True, delete=False, threads=8) + elif split == 'val': + download([f'{url}zhiyuan_objv2_{split}.json'], dir=dir, delete=False) # annotations json + download([f'{url}images/v1/patch{i}.tar.gz' for i in range(15 + 1)], dir=images, curl=True, delete=False, threads=8) + download([f'{url}images/v2/patch{i}.tar.gz' for i in range(16, patches)], dir=images, curl=True, delete=False, threads=8) + + # Move + for f in tqdm(images.rglob('*.jpg'), desc=f'Moving {split} images'): + f.rename(images / f.name) # move to /images/{split} + + # Labels + coco = COCO(dir / f'zhiyuan_objv2_{split}.json') + names = [x["name"] for x in coco.loadCats(coco.getCatIds())] + for cid, cat in enumerate(names): + catIds = coco.getCatIds(catNms=[cat]) + imgIds = coco.getImgIds(catIds=catIds) + for im in tqdm(coco.loadImgs(imgIds), desc=f'Class {cid + 1}/{len(names)} {cat}'): + width, height = im["width"], im["height"] + path = Path(im["file_name"]) # image filename + try: + with open(labels / path.with_suffix('.txt').name, 'a') as file: + annIds = coco.getAnnIds(imgIds=im["id"], catIds=catIds, iscrowd=None) + for a in coco.loadAnns(annIds): + x, y, w, h = a['bbox'] # bounding box in xywh (xy top-left corner) + xyxy = np.array([x, y, x + w, y + h])[None] # pixels(1,4) + x, y, w, h = xyxy2xywhn(xyxy, w=width, h=height, clip=True)[0] # normalized and clipped + file.write(f"{cid} {x:.5f} {y:.5f} {w:.5f} {h:.5f}\n") + except Exception as e: + print(e) diff --git a/yolov5_Monocular_social_ranging/data/SKU-110K.yaml b/yolov5_Monocular_social_ranging/data/SKU-110K.yaml new file mode 100644 index 0000000..9481b7a --- /dev/null +++ b/yolov5_Monocular_social_ranging/data/SKU-110K.yaml @@ -0,0 +1,52 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +# SKU-110K retail items dataset https://github.com/eg4000/SKU110K_CVPR19 by Trax Retail +# Example usage: python train.py --data SKU-110K.yaml +# parent +# ├── yolov5 +# └── datasets +# └── SKU-110K ← downloads here + + +# Train/val/test sets as 1) dir: path/to/imgs, 2) file: path/to/imgs.txt, or 3) list: [path/to/imgs1, path/to/imgs2, ..] +path: ../datasets/SKU-110K # dataset root dir +train: train.txt # train images (relative to 'path') 8219 images +val: val.txt # val images (relative to 'path') 588 images +test: test.txt # test images (optional) 2936 images + +# Classes +nc: 1 # number of classes +names: ['object'] # class names + + +# Download script/URL (optional) --------------------------------------------------------------------------------------- +download: | + import shutil + from tqdm import tqdm + from utils.general import np, pd, Path, download, xyxy2xywh + + # Download + dir = Path(yaml['path']) # dataset root dir + parent = Path(dir.parent) # download dir + urls = ['http://trax-geometry.s3.amazonaws.com/cvpr_challenge/SKU110K_fixed.tar.gz'] + download(urls, dir=parent, delete=False) + + # Rename directories + if dir.exists(): + shutil.rmtree(dir) + (parent / 'SKU110K_fixed').rename(dir) # rename dir + (dir / 'labels').mkdir(parents=True, exist_ok=True) # create labels dir + + # Convert labels + names = 'image', 'x1', 'y1', 'x2', 'y2', 'class', 'image_width', 'image_height' # column names + for d in 'annotations_train.csv', 'annotations_val.csv', 'annotations_test.csv': + x = pd.read_csv(dir / 'annotations' / d, names=names).values # annotations + images, unique_images = x[:, 0], np.unique(x[:, 0]) + with open((dir / d).with_suffix('.txt').__str__().replace('annotations_', ''), 'w') as f: + f.writelines(f'./images/{s}\n' for s in unique_images) + for im in tqdm(unique_images, desc=f'Converting {dir / d}'): + cls = 0 # single-class dataset + with open((dir / 'labels' / im).with_suffix('.txt'), 'a') as f: + for r in x[images == im]: + w, h = r[6], r[7] # image width, height + xywh = xyxy2xywh(np.array([[r[1] / w, r[2] / h, r[3] / w, r[4] / h]]))[0] # instance + f.write(f"{cls} {xywh[0]:.5f} {xywh[1]:.5f} {xywh[2]:.5f} {xywh[3]:.5f}\n") # write label diff --git a/yolov5_Monocular_social_ranging/data/VOC.yaml b/yolov5_Monocular_social_ranging/data/VOC.yaml new file mode 100644 index 0000000..975d564 --- /dev/null +++ b/yolov5_Monocular_social_ranging/data/VOC.yaml @@ -0,0 +1,80 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +# PASCAL VOC dataset http://host.robots.ox.ac.uk/pascal/VOC by University of Oxford +# Example usage: python train.py --data VOC.yaml +# parent +# ├── yolov5 +# └── datasets +# └── VOC ← downloads here + + +# Train/val/test sets as 1) dir: path/to/imgs, 2) file: path/to/imgs.txt, or 3) list: [path/to/imgs1, path/to/imgs2, ..] +path: ../datasets/VOC +train: # train images (relative to 'path') 16551 images + - images/train2012 + - images/train2007 + - images/val2012 + - images/val2007 +val: # val images (relative to 'path') 4952 images + - images/test2007 +test: # test images (optional) + - images/test2007 + +# Classes +nc: 20 # number of classes +names: ['aeroplane', 'bicycle', 'bird', 'boat', 'bottle', 'bus', 'car', 'cat', 'chair', 'cow', 'diningtable', 'dog', + 'horse', 'motorbike', 'person', 'pottedplant', 'sheep', 'sofa', 'train', 'tvmonitor'] # class names + + +# Download script/URL (optional) --------------------------------------------------------------------------------------- +download: | + import xml.etree.ElementTree as ET + + from tqdm import tqdm + from utils.general import download, Path + + + def convert_label(path, lb_path, year, image_id): + def convert_box(size, box): + dw, dh = 1. / size[0], 1. / size[1] + x, y, w, h = (box[0] + box[1]) / 2.0 - 1, (box[2] + box[3]) / 2.0 - 1, box[1] - box[0], box[3] - box[2] + return x * dw, y * dh, w * dw, h * dh + + in_file = open(path / f'VOC{year}/Annotations/{image_id}.xml') + out_file = open(lb_path, 'w') + tree = ET.parse(in_file) + root = tree.getroot() + size = root.find('size') + w = int(size.find('width').text) + h = int(size.find('height').text) + + for obj in root.iter('object'): + cls = obj.find('name').text + if cls in yaml['names'] and not int(obj.find('difficult').text) == 1: + xmlbox = obj.find('bndbox') + bb = convert_box((w, h), [float(xmlbox.find(x).text) for x in ('xmin', 'xmax', 'ymin', 'ymax')]) + cls_id = yaml['names'].index(cls) # class id + out_file.write(" ".join([str(a) for a in (cls_id, *bb)]) + '\n') + + + # Download + dir = Path(yaml['path']) # dataset root dir + url = 'https://github.com/ultralytics/yolov5/releases/download/v1.0/' + urls = [url + 'VOCtrainval_06-Nov-2007.zip', # 446MB, 5012 images + url + 'VOCtest_06-Nov-2007.zip', # 438MB, 4953 images + url + 'VOCtrainval_11-May-2012.zip'] # 1.95GB, 17126 images + download(urls, dir=dir / 'images', delete=False) + + # Convert + path = dir / f'images/VOCdevkit' + for year, image_set in ('2012', 'train'), ('2012', 'val'), ('2007', 'train'), ('2007', 'val'), ('2007', 'test'): + imgs_path = dir / 'images' / f'{image_set}{year}' + lbs_path = dir / 'labels' / f'{image_set}{year}' + imgs_path.mkdir(exist_ok=True, parents=True) + lbs_path.mkdir(exist_ok=True, parents=True) + + image_ids = open(path / f'VOC{year}/ImageSets/Main/{image_set}.txt').read().strip().split() + for id in tqdm(image_ids, desc=f'{image_set}{year}'): + f = path / f'VOC{year}/JPEGImages/{id}.jpg' # old img path + lb_path = (lbs_path / f.name).with_suffix('.txt') # new label path + f.rename(imgs_path / f.name) # move image + convert_label(path, lb_path, year, id) # convert labels to YOLO format diff --git a/yolov5_Monocular_social_ranging/data/VisDrone.yaml b/yolov5_Monocular_social_ranging/data/VisDrone.yaml new file mode 100644 index 0000000..83a5c7d --- /dev/null +++ b/yolov5_Monocular_social_ranging/data/VisDrone.yaml @@ -0,0 +1,61 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +# VisDrone2019-DET dataset https://github.com/VisDrone/VisDrone-Dataset by Tianjin University +# Example usage: python train.py --data VisDrone.yaml +# parent +# ├── yolov5 +# └── datasets +# └── VisDrone ← downloads here + + +# Train/val/test sets as 1) dir: path/to/imgs, 2) file: path/to/imgs.txt, or 3) list: [path/to/imgs1, path/to/imgs2, ..] +path: ../datasets/VisDrone # dataset root dir +train: VisDrone2019-DET-train/images # train images (relative to 'path') 6471 images +val: VisDrone2019-DET-val/images # val images (relative to 'path') 548 images +test: VisDrone2019-DET-test-dev/images # test images (optional) 1610 images + +# Classes +nc: 10 # number of classes +names: ['pedestrian', 'people', 'bicycle', 'car', 'van', 'truck', 'tricycle', 'awning-tricycle', 'bus', 'motor'] + + +# Download script/URL (optional) --------------------------------------------------------------------------------------- +download: | + from utils.general import download, os, Path + + def visdrone2yolo(dir): + from PIL import Image + from tqdm import tqdm + + def convert_box(size, box): + # Convert VisDrone box to YOLO xywh box + dw = 1. / size[0] + dh = 1. / size[1] + return (box[0] + box[2] / 2) * dw, (box[1] + box[3] / 2) * dh, box[2] * dw, box[3] * dh + + (dir / 'labels').mkdir(parents=True, exist_ok=True) # make labels directory + pbar = tqdm((dir / 'annotations').glob('*.txt'), desc=f'Converting {dir}') + for f in pbar: + img_size = Image.open((dir / 'images' / f.name).with_suffix('.jpg')).size + lines = [] + with open(f, 'r') as file: # read annotation.txt + for row in [x.split(',') for x in file.read().strip().splitlines()]: + if row[4] == '0': # VisDrone 'ignored regions' class 0 + continue + cls = int(row[5]) - 1 + box = convert_box(img_size, tuple(map(int, row[:4]))) + lines.append(f"{cls} {' '.join(f'{x:.6f}' for x in box)}\n") + with open(str(f).replace(os.sep + 'annotations' + os.sep, os.sep + 'labels' + os.sep), 'w') as fl: + fl.writelines(lines) # write label.txt + + + # Download + dir = Path(yaml['path']) # dataset root dir + urls = ['https://github.com/ultralytics/yolov5/releases/download/v1.0/VisDrone2019-DET-train.zip', + 'https://github.com/ultralytics/yolov5/releases/download/v1.0/VisDrone2019-DET-val.zip', + 'https://github.com/ultralytics/yolov5/releases/download/v1.0/VisDrone2019-DET-test-dev.zip', + 'https://github.com/ultralytics/yolov5/releases/download/v1.0/VisDrone2019-DET-test-challenge.zip'] + download(urls, dir=dir) + + # Convert + for d in 'VisDrone2019-DET-train', 'VisDrone2019-DET-val', 'VisDrone2019-DET-test-dev': + visdrone2yolo(dir / d) # convert VisDrone annotations to YOLO labels diff --git a/yolov5_Monocular_social_ranging/data/coco.yaml b/yolov5_Monocular_social_ranging/data/coco.yaml new file mode 100644 index 0000000..3ed7e48 --- /dev/null +++ b/yolov5_Monocular_social_ranging/data/coco.yaml @@ -0,0 +1,44 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +# COCO 2017 dataset http://cocodataset.org by Microsoft +# Example usage: python train.py --data coco.yaml +# parent +# ├── yolov5 +# └── datasets +# └── coco ← downloads here + + +# Train/val/test sets as 1) dir: path/to/imgs, 2) file: path/to/imgs.txt, or 3) list: [path/to/imgs1, path/to/imgs2, ..] +path: ../datasets/coco # dataset root dir +train: train2017.txt # train images (relative to 'path') 118287 images +val: val2017.txt # val images (relative to 'path') 5000 images +test: test-dev2017.txt # 20288 of 40670 images, submit to https://competitions.codalab.org/competitions/20794 + +# Classes +nc: 80 # number of classes +names: ['person', 'bicycle', 'car', 'motorcycle', 'airplane', 'bus', 'train', 'truck', 'boat', 'traffic light', + 'fire hydrant', 'stop sign', 'parking meter', 'bench', 'bird', 'cat', 'dog', 'horse', 'sheep', 'cow', + 'elephant', 'bear', 'zebra', 'giraffe', 'backpack', 'umbrella', 'handbag', 'tie', 'suitcase', 'frisbee', + 'skis', 'snowboard', 'sports ball', 'kite', 'baseball bat', 'baseball glove', 'skateboard', 'surfboard', + 'tennis racket', 'bottle', 'wine glass', 'cup', 'fork', 'knife', 'spoon', 'bowl', 'banana', 'apple', + 'sandwich', 'orange', 'broccoli', 'carrot', 'hot dog', 'pizza', 'donut', 'cake', 'chair', 'couch', + 'potted plant', 'bed', 'dining table', 'toilet', 'tv', 'laptop', 'mouse', 'remote', 'keyboard', 'cell phone', + 'microwave', 'oven', 'toaster', 'sink', 'refrigerator', 'book', 'clock', 'vase', 'scissors', 'teddy bear', + 'hair drier', 'toothbrush'] # class names + + +# Download script/URL (optional) +download: | + from utils.general import download, Path + + # Download labels + segments = False # segment or box labels + dir = Path(yaml['path']) # dataset root dir + url = 'https://github.com/ultralytics/yolov5/releases/download/v1.0/' + urls = [url + ('coco2017labels-segments.zip' if segments else 'coco2017labels.zip')] # labels + download(urls, dir=dir.parent) + + # Download data + urls = ['http://images.cocodataset.org/zips/train2017.zip', # 19G, 118k images + 'http://images.cocodataset.org/zips/val2017.zip', # 1G, 5k images + 'http://images.cocodataset.org/zips/test2017.zip'] # 7G, 41k images (optional) + download(urls, dir=dir / 'images', threads=3) diff --git a/yolov5_Monocular_social_ranging/data/coco128.yaml b/yolov5_Monocular_social_ranging/data/coco128.yaml new file mode 100644 index 0000000..d07c704 --- /dev/null +++ b/yolov5_Monocular_social_ranging/data/coco128.yaml @@ -0,0 +1,30 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +# COCO128 dataset https://www.kaggle.com/ultralytics/coco128 (first 128 images from COCO train2017) by Ultralytics +# Example usage: python train.py --data coco128.yaml +# parent +# ├── yolov5 +# └── datasets +# └── coco128 ← downloads here + + +# Train/val/test sets as 1) dir: path/to/imgs, 2) file: path/to/imgs.txt, or 3) list: [path/to/imgs1, path/to/imgs2, ..] +path: ../datasets/coco128 # dataset root dir +train: images/train2017 # train images (relative to 'path') 128 images +val: images/train2017 # val images (relative to 'path') 128 images +test: # test images (optional) + +# Classes +nc: 80 # number of classes +names: ['person', 'bicycle', 'car', 'motorcycle', 'airplane', 'bus', 'train', 'truck', 'boat', 'traffic light', + 'fire hydrant', 'stop sign', 'parking meter', 'bench', 'bird', 'cat', 'dog', 'horse', 'sheep', 'cow', + 'elephant', 'bear', 'zebra', 'giraffe', 'backpack', 'umbrella', 'handbag', 'tie', 'suitcase', 'frisbee', + 'skis', 'snowboard', 'sports ball', 'kite', 'baseball bat', 'baseball glove', 'skateboard', 'surfboard', + 'tennis racket', 'bottle', 'wine glass', 'cup', 'fork', 'knife', 'spoon', 'bowl', 'banana', 'apple', + 'sandwich', 'orange', 'broccoli', 'carrot', 'hot dog', 'pizza', 'donut', 'cake', 'chair', 'couch', + 'potted plant', 'bed', 'dining table', 'toilet', 'tv', 'laptop', 'mouse', 'remote', 'keyboard', 'cell phone', + 'microwave', 'oven', 'toaster', 'sink', 'refrigerator', 'book', 'clock', 'vase', 'scissors', 'teddy bear', + 'hair drier', 'toothbrush'] # class names + + +# Download script/URL (optional) +download: https://ultralytics.com/assets/coco128.zip diff --git a/yolov5_Monocular_social_ranging/data/hyps/hyp.Objects365.yaml b/yolov5_Monocular_social_ranging/data/hyps/hyp.Objects365.yaml new file mode 100644 index 0000000..7497174 --- /dev/null +++ b/yolov5_Monocular_social_ranging/data/hyps/hyp.Objects365.yaml @@ -0,0 +1,34 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +# Hyperparameters for Objects365 training +# python train.py --weights yolov5m.pt --data Objects365.yaml --evolve +# See Hyperparameter Evolution tutorial for details https://github.com/ultralytics/yolov5#tutorials + +lr0: 0.00258 +lrf: 0.17 +momentum: 0.779 +weight_decay: 0.00058 +warmup_epochs: 1.33 +warmup_momentum: 0.86 +warmup_bias_lr: 0.0711 +box: 0.0539 +cls: 0.299 +cls_pw: 0.825 +obj: 0.632 +obj_pw: 1.0 +iou_t: 0.2 +anchor_t: 3.44 +anchors: 3.2 +fl_gamma: 0.0 +hsv_h: 0.0188 +hsv_s: 0.704 +hsv_v: 0.36 +degrees: 0.0 +translate: 0.0902 +scale: 0.491 +shear: 0.0 +perspective: 0.0 +flipud: 0.0 +fliplr: 0.5 +mosaic: 1.0 +mixup: 0.0 +copy_paste: 0.0 diff --git a/yolov5_Monocular_social_ranging/data/hyps/hyp.VOC.yaml b/yolov5_Monocular_social_ranging/data/hyps/hyp.VOC.yaml new file mode 100644 index 0000000..aa952c5 --- /dev/null +++ b/yolov5_Monocular_social_ranging/data/hyps/hyp.VOC.yaml @@ -0,0 +1,40 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +# Hyperparameters for VOC training +# python train.py --batch 128 --weights yolov5m6.pt --data VOC.yaml --epochs 50 --img 512 --hyp hyp.scratch-med.yaml --evolve +# See Hyperparameter Evolution tutorial for details https://github.com/ultralytics/yolov5#tutorials + +# YOLOv5 Hyperparameter Evolution Results +# Best generation: 319 +# Last generation: 434 +# metrics/precision, metrics/recall, metrics/mAP_0.5, metrics/mAP_0.5:0.95, val/box_loss, val/obj_loss, val/cls_loss +# 0.86236, 0.86184, 0.91274, 0.72647, 0.0077056, 0.0042449, 0.0013846 + +lr0: 0.0033 +lrf: 0.15184 +momentum: 0.74747 +weight_decay: 0.00025 +warmup_epochs: 3.4278 +warmup_momentum: 0.59032 +warmup_bias_lr: 0.18742 +box: 0.02 +cls: 0.21563 +cls_pw: 0.5 +obj: 0.50843 +obj_pw: 0.6729 +iou_t: 0.2 +anchor_t: 3.4172 +fl_gamma: 0.0 +hsv_h: 0.01032 +hsv_s: 0.5562 +hsv_v: 0.28255 +degrees: 0.0 +translate: 0.04575 +scale: 0.73711 +shear: 0.0 +perspective: 0.0 +flipud: 0.0 +fliplr: 0.5 +mosaic: 0.87158 +mixup: 0.04294 +copy_paste: 0.0 +anchors: 3.3556 diff --git a/yolov5_Monocular_social_ranging/data/hyps/hyp.scratch-high.yaml b/yolov5_Monocular_social_ranging/data/hyps/hyp.scratch-high.yaml new file mode 100644 index 0000000..123cc84 --- /dev/null +++ b/yolov5_Monocular_social_ranging/data/hyps/hyp.scratch-high.yaml @@ -0,0 +1,34 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +# Hyperparameters for high-augmentation COCO training from scratch +# python train.py --batch 32 --cfg yolov5m6.yaml --weights '' --data coco.yaml --img 1280 --epochs 300 +# See tutorials for hyperparameter evolution https://github.com/ultralytics/yolov5#tutorials + +lr0: 0.01 # initial learning rate (SGD=1E-2, Adam=1E-3) +lrf: 0.1 # final OneCycleLR learning rate (lr0 * lrf) +momentum: 0.937 # SGD momentum/Adam beta1 +weight_decay: 0.0005 # optimizer weight decay 5e-4 +warmup_epochs: 3.0 # warmup epochs (fractions ok) +warmup_momentum: 0.8 # warmup initial momentum +warmup_bias_lr: 0.1 # warmup initial bias lr +box: 0.05 # box loss gain +cls: 0.3 # cls loss gain +cls_pw: 1.0 # cls BCELoss positive_weight +obj: 0.7 # obj loss gain (scale with pixels) +obj_pw: 1.0 # obj BCELoss positive_weight +iou_t: 0.20 # IoU training threshold +anchor_t: 4.0 # anchor-multiple threshold +# anchors: 3 # anchors per output layer (0 to ignore) +fl_gamma: 0.0 # focal loss gamma (efficientDet default gamma=1.5) +hsv_h: 0.015 # image HSV-Hue augmentation (fraction) +hsv_s: 0.7 # image HSV-Saturation augmentation (fraction) +hsv_v: 0.4 # image HSV-Value augmentation (fraction) +degrees: 0.0 # image rotation (+/- deg) +translate: 0.1 # image translation (+/- fraction) +scale: 0.9 # image scale (+/- gain) +shear: 0.0 # image shear (+/- deg) +perspective: 0.0 # image perspective (+/- fraction), range 0-0.001 +flipud: 0.0 # image flip up-down (probability) +fliplr: 0.5 # image flip left-right (probability) +mosaic: 1.0 # image mosaic (probability) +mixup: 0.1 # image mixup (probability) +copy_paste: 0.1 # segment copy-paste (probability) diff --git a/yolov5_Monocular_social_ranging/data/hyps/hyp.scratch-low.yaml b/yolov5_Monocular_social_ranging/data/hyps/hyp.scratch-low.yaml new file mode 100644 index 0000000..b9ef1d5 --- /dev/null +++ b/yolov5_Monocular_social_ranging/data/hyps/hyp.scratch-low.yaml @@ -0,0 +1,34 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +# Hyperparameters for low-augmentation COCO training from scratch +# python train.py --batch 64 --cfg yolov5n6.yaml --weights '' --data coco.yaml --img 640 --epochs 300 --linear +# See tutorials for hyperparameter evolution https://github.com/ultralytics/yolov5#tutorials + +lr0: 0.01 # initial learning rate (SGD=1E-2, Adam=1E-3) +lrf: 0.01 # final OneCycleLR learning rate (lr0 * lrf) +momentum: 0.937 # SGD momentum/Adam beta1 +weight_decay: 0.0005 # optimizer weight decay 5e-4 +warmup_epochs: 3.0 # warmup epochs (fractions ok) +warmup_momentum: 0.8 # warmup initial momentum +warmup_bias_lr: 0.1 # warmup initial bias lr +box: 0.05 # box loss gain +cls: 0.5 # cls loss gain +cls_pw: 1.0 # cls BCELoss positive_weight +obj: 1.0 # obj loss gain (scale with pixels) +obj_pw: 1.0 # obj BCELoss positive_weight +iou_t: 0.20 # IoU training threshold +anchor_t: 4.0 # anchor-multiple threshold +# anchors: 3 # anchors per output layer (0 to ignore) +fl_gamma: 0.0 # focal loss gamma (efficientDet default gamma=1.5) +hsv_h: 0.015 # image HSV-Hue augmentation (fraction) +hsv_s: 0.7 # image HSV-Saturation augmentation (fraction) +hsv_v: 0.4 # image HSV-Value augmentation (fraction) +degrees: 0.0 # image rotation (+/- deg) +translate: 0.1 # image translation (+/- fraction) +scale: 0.5 # image scale (+/- gain) +shear: 0.0 # image shear (+/- deg) +perspective: 0.0 # image perspective (+/- fraction), range 0-0.001 +flipud: 0.0 # image flip up-down (probability) +fliplr: 0.5 # image flip left-right (probability) +mosaic: 1.0 # image mosaic (probability) +mixup: 0.0 # image mixup (probability) +copy_paste: 0.0 # segment copy-paste (probability) diff --git a/yolov5_Monocular_social_ranging/data/hyps/hyp.scratch-med.yaml b/yolov5_Monocular_social_ranging/data/hyps/hyp.scratch-med.yaml new file mode 100644 index 0000000..d6867d7 --- /dev/null +++ b/yolov5_Monocular_social_ranging/data/hyps/hyp.scratch-med.yaml @@ -0,0 +1,34 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +# Hyperparameters for medium-augmentation COCO training from scratch +# python train.py --batch 32 --cfg yolov5m6.yaml --weights '' --data coco.yaml --img 1280 --epochs 300 +# See tutorials for hyperparameter evolution https://github.com/ultralytics/yolov5#tutorials + +lr0: 0.01 # initial learning rate (SGD=1E-2, Adam=1E-3) +lrf: 0.1 # final OneCycleLR learning rate (lr0 * lrf) +momentum: 0.937 # SGD momentum/Adam beta1 +weight_decay: 0.0005 # optimizer weight decay 5e-4 +warmup_epochs: 3.0 # warmup epochs (fractions ok) +warmup_momentum: 0.8 # warmup initial momentum +warmup_bias_lr: 0.1 # warmup initial bias lr +box: 0.05 # box loss gain +cls: 0.3 # cls loss gain +cls_pw: 1.0 # cls BCELoss positive_weight +obj: 0.7 # obj loss gain (scale with pixels) +obj_pw: 1.0 # obj BCELoss positive_weight +iou_t: 0.20 # IoU training threshold +anchor_t: 4.0 # anchor-multiple threshold +# anchors: 3 # anchors per output layer (0 to ignore) +fl_gamma: 0.0 # focal loss gamma (efficientDet default gamma=1.5) +hsv_h: 0.015 # image HSV-Hue augmentation (fraction) +hsv_s: 0.7 # image HSV-Saturation augmentation (fraction) +hsv_v: 0.4 # image HSV-Value augmentation (fraction) +degrees: 0.0 # image rotation (+/- deg) +translate: 0.1 # image translation (+/- fraction) +scale: 0.9 # image scale (+/- gain) +shear: 0.0 # image shear (+/- deg) +perspective: 0.0 # image perspective (+/- fraction), range 0-0.001 +flipud: 0.0 # image flip up-down (probability) +fliplr: 0.5 # image flip left-right (probability) +mosaic: 1.0 # image mosaic (probability) +mixup: 0.1 # image mixup (probability) +copy_paste: 0.0 # segment copy-paste (probability) diff --git a/yolov5_Monocular_social_ranging/data/scripts/download_weights.sh b/yolov5_Monocular_social_ranging/data/scripts/download_weights.sh new file mode 100644 index 0000000..e9fa653 --- /dev/null +++ b/yolov5_Monocular_social_ranging/data/scripts/download_weights.sh @@ -0,0 +1,20 @@ +#!/bin/bash +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +# Download latest models from https://github.com/ultralytics/yolov5/releases +# Example usage: bash path/to/download_weights.sh +# parent +# └── yolov5 +# ├── yolov5s.pt ← downloads here +# ├── yolov5m.pt +# └── ... + +python - <= cls >= 0, f'incorrect class index {cls}' + + # Write YOLO label + if id not in shapes: + shapes[id] = Image.open(file).size + box = xyxy2xywhn(box[None].astype(np.float), w=shapes[id][0], h=shapes[id][1], clip=True) + with open((labels / id).with_suffix('.txt'), 'a') as f: + f.write(f"{cls} {' '.join(f'{x:.6f}' for x in box[0])}\n") # write label.txt + except Exception as e: + print(f'WARNING: skipping one label for {file}: {e}') + + + # Download manually from https://challenge.xviewdataset.org + dir = Path(yaml['path']) # dataset root dir + # urls = ['https://d307kc0mrhucc3.cloudfront.net/train_labels.zip', # train labels + # 'https://d307kc0mrhucc3.cloudfront.net/train_images.zip', # 15G, 847 train images + # 'https://d307kc0mrhucc3.cloudfront.net/val_images.zip'] # 5G, 282 val images (no labels) + # download(urls, dir=dir, delete=False) + + # Convert labels + convert_labels(dir / 'xView_train.geojson') + + # Move images + images = Path(dir / 'images') + images.mkdir(parents=True, exist_ok=True) + Path(dir / 'train_images').rename(dir / 'images' / 'train') + Path(dir / 'val_images').rename(dir / 'images' / 'val') + + # Split + autosplit(dir / 'images' / 'train') diff --git a/yolov5_Monocular_social_ranging/detect.py b/yolov5_Monocular_social_ranging/detect.py new file mode 100644 index 0000000..2b35ee7 --- /dev/null +++ b/yolov5_Monocular_social_ranging/detect.py @@ -0,0 +1,332 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +Run inference on images, videos, directories, streams, etc. + +Usage - sources: + $ python path/to/detect.py --weights yolov5s.pt --source 0 # webcam + img.jpg # image + vid.mp4 # video + path/ # directory + path/*.jpg # glob + 'https://youtu.be/Zgi9g1ksQHc' # YouTube + 'rtsp://example.com/media.mp4' # RTSP, RTMP, HTTP stream + +Usage - formats: + $ python path/to/detect.py --weights yolov5s.pt # PyTorch + yolov5s.torchscript # TorchScript + yolov5s.onnx # ONNX Runtime or OpenCV DNN with --dnn + yolov5s.xml # OpenVINO + yolov5s.engine # TensorRT + yolov5s.mlmodel # CoreML (MacOS-only) + yolov5s_saved_model # TensorFlow SavedModel + yolov5s.pb # TensorFlow GraphDef + yolov5s.tflite # TensorFlow Lite + yolov5s_edgetpu.tflite # TensorFlow Edge TPU +""" + +import argparse +import itertools +import os +import sys +from pathlib import Path + +import cv2 +import torch +import torch.backends.cudnn as cudnn + +FILE = Path(__file__).resolve() +ROOT = FILE.parents[0] # YOLOv5 root directory +if str(ROOT) not in sys.path: + sys.path.append(str(ROOT)) # add ROOT to PATH +ROOT = Path(os.path.relpath(ROOT, Path.cwd())) # relative + +from models.common import DetectMultiBackend +from utils.datasets import IMG_FORMATS, VID_FORMATS, LoadImages, LoadStreams +from utils.general import (LOGGER, check_file, check_img_size, check_imshow, check_requirements, colorstr, + increment_path, non_max_suppression, print_args, scale_coords, strip_optimizer, xyxy2xywh) +from utils.plots import Annotator, colors, save_one_box +from utils.torch_utils import select_device, time_sync +from distance import person_distance,car_distance + +def distancing_1(person_coords, car_coords,dis_m1,dis_m, sq, img): + already_red = dict() + centers_people = [] + centers_car = [] + centers = [] + for i in person_coords: + centers_people.append(((int(i[2])+int(i[0]))//2,(int(i[3])+int(i[1]))//2)) + for i_car in car_coords: + centers_car.append(((int(i_car[2])+int(i_car[0]))//2,(int(i_car[3])+int(i_car[1]))//2)) + centers = centers_people +centers_car + for j in centers: + already_red[j] = 2 + x_combs = itertools.product(person_coords, car_coords, repeat=1) + radius = 10 + thickness = 5 + for x in x_combs: + xyxy1, xyxy2 = x[0],x[1] + cntr1 = ((int(xyxy1[2])+int(xyxy1[0]))//2,(int(xyxy1[3])+int(xyxy1[1]))//2) + cntr2 = ((int(xyxy2[2])+int(xyxy2[0]))//2,(int(xyxy2[3])+int(xyxy2[1]))//2) + + dist_x = (cntr2[0] - cntr1[0]) * sq + dist_y = dis_m1 - dis_m + dist = (dist_x ** 2 + dist_y ** 2) ** 0.5 + + color = (0, 255, 255) + cv2.line(img, cntr1, cntr2, color, thickness) + mid = ((int(cntr1[0])+int(cntr2[0]))//2,(int(cntr1[1])+int(cntr2[1]))//2) + cm = round(dist,2) + cv2.putText(img, str(cm)+" m", mid, cv2.FONT_HERSHEY_SIMPLEX , 1, color, 2, cv2.LINE_AA) + already_red[cntr1] = 0 + already_red[cntr2] = 0 + cv2.circle(img, cntr1, radius, color, -1) + cv2.circle(img, cntr2, radius, color, -1) + # Plots one bounding box on image img + tl = round(0.002 * (img.shape[0] + img.shape[1]) / 2) + 1 # line/font thickness + for xy in x: + cntr = ((int(xy[2])+int(xy[0]))//2,(int(xy[3])+int(xy[1]))//2) + if already_red[cntr] == 0: + z1, z2 =(int(xyxy1[0]),int(xyxy1[1])),(int(xyxy1[2]),int(xyxy1[3])) + zz1, zz2 =(int(xyxy2[0]),int(xyxy2[1])),(int(xyxy2[2]),int(xyxy2[3])) + return (img) +@torch.no_grad() +def run(weights=ROOT / 'yolov5s.pt', # model.pt path(s) + source=ROOT / 'data/images', # file/dir/URL/glob, 0 for webcam + data=ROOT / 'data/coco128.yaml', # dataset.yaml path + imgsz=(640, 640), # inference size (height, width) + conf_thres=0.25, # confidence threshold + iou_thres=0.45, # NMS IOU threshold + max_det=1000, # maximum detections per image + device='', # cuda device, i.e. 0 or 0,1,2,3 or cpu + view_img=False, # show results + save_txt=False, # save results to *.txt + save_conf=False, # save confidences in --save-txt labels + save_crop=False, # save cropped prediction boxes + nosave=False, # do not save images/videos + classes=None, # filter by class: --class 0, or --class 0 2 3 + agnostic_nms=False, # class-agnostic NMS + augment=False, # augmented inference + visualize=False, # visualize features + update=False, # update all models + project=ROOT / 'runs/detect', # save results to project/name + name='exp', # save results to project/name + exist_ok=False, # existing project/name ok, do not increment + line_thickness=3, # bounding box thickness (pixels) + hide_labels=False, # hide labels + hide_conf=False, # hide confidences + half=False, # use FP16 half-precision inference + dnn=False, # use OpenCV DNN for ONNX inference + ): + global dis_m, dis_m1, sq + source = str(source) + save_img = not nosave and not source.endswith('.txt') # save inference images + is_file = Path(source).suffix[1:] in (IMG_FORMATS + VID_FORMATS) + is_url = source.lower().startswith(('rtsp://', 'rtmp://', 'http://', 'https://')) + webcam = source.isnumeric() or source.endswith('.txt') or (is_url and not is_file) + if is_url and is_file: + source = check_file(source) # download + + # Directories + save_dir = increment_path(Path(project) / name, exist_ok=exist_ok) # increment run + (save_dir / 'labels' if save_txt else save_dir).mkdir(parents=True, exist_ok=True) # make dir + + # Load model + device = select_device(device) + model = DetectMultiBackend(weights, device=device, dnn=dnn, data=data) + stride, names, pt, jit, onnx, engine = model.stride, model.names, model.pt, model.jit, model.onnx, model.engine + imgsz = check_img_size(imgsz, s=stride) # check image size + + # Half + half &= (pt or jit or onnx or engine) and device.type != 'cpu' # FP16 supported on limited backends with CUDA + if pt or jit: + model.model.half() if half else model.model.float() + + # Dataloader + if webcam: + view_img = check_imshow() + cudnn.benchmark = True # set True to speed up constant image size inference + dataset = LoadStreams(source, img_size=imgsz, stride=stride, auto=pt) + bs = len(dataset) # batch_size + else: + dataset = LoadImages(source, img_size=imgsz, stride=stride, auto=pt) + bs = 1 # batch_size + vid_path, vid_writer = [None] * bs, [None] * bs + + # Run inference + model.warmup(imgsz=(1 if pt else bs, 3, *imgsz), half=half) # warmup + dt, seen = [0.0, 0.0, 0.0], 0 + for path, im, im0s, vid_cap, s in dataset: + t1 = time_sync() + im = torch.from_numpy(im).to(device) + im = im.half() if half else im.float() # uint8 to fp16/32 + im /= 255 # 0 - 255 to 0.0 - 1.0 + if len(im.shape) == 3: + im = im[None] # expand for batch dim + t2 = time_sync() + dt[0] += t2 - t1 + + # Inference + visualize = increment_path(save_dir / Path(path).stem, mkdir=True) if visualize else False + pred = model(im, augment=augment, visualize=visualize) + t3 = time_sync() + dt[1] += t3 - t2 + + # NMS + pred = non_max_suppression(pred, conf_thres, iou_thres, classes, agnostic_nms, max_det=max_det) + dt[2] += time_sync() - t3 + + # Second-stage classifier (optional) + # pred = utils.general.apply_classifier(pred, classifier_model, im, im0s) + + # Process predictions + person_coords = [] + car_coords = [] + for i, det in enumerate(pred): # per image + seen += 1 + if webcam: # batch_size >= 1 + p, im0, frame = path[i], im0s[i].copy(), dataset.count + s += f'{i}: ' + else: + p, im0, frame = path, im0s.copy(), getattr(dataset, 'frame', 0) + + p = Path(p) # to Path + save_path = str(save_dir / p.name) # im.jpg + txt_path = str(save_dir / 'labels' / p.stem) + ('' if dataset.mode == 'image' else f'_{frame}') # im.txt + s += '%gx%g ' % im.shape[2:] # print string + gn = torch.tensor(im0.shape)[[1, 0, 1, 0]] # normalization gain whwh + imc = im0.copy() if save_crop else im0 # for save_crop + annotator = Annotator(im0, line_width=line_thickness, example=str(names)) + if len(det): + # Rescale boxes from img_size to im0 size + det[:, :4] = scale_coords(im.shape[2:], det[:, :4], im0.shape).round() + + # Print results + for c in det[:, -1].unique(): + n = (det[:, -1] == c).sum() # detections per class + s += f"{n} {names[int(c)]}{'s' * (n > 1)}, " # add to string + + # Write results + for *xyxy, conf, cls in reversed(det): + if save_txt: # Write to file + xywh = (xyxy2xywh(torch.tensor(xyxy).view(1, 4)) / gn).view(-1).tolist() # normalized xywh + line = (cls, *xywh, conf) if save_conf else (cls, *xywh) # label format + with open(txt_path + '.txt', 'a') as f: + f.write(('%g ' * len(line)).rstrip() % line + '\n') + if save_img or save_crop or view_img: # Add bbox to image + x1 = int(xyxy[0]) + y1 = int(xyxy[1]) + x2 = int(xyxy[2]) + y2 = int(xyxy[3]) + h = y2-y1 + if names[int(cls)] == "person": + person_coords.append(xyxy) + c = int(cls) # integer class 整数类 1111111111 + label = None if hide_labels else ( + names[c] if hide_conf else f'{names[c]} {conf:.2f}') # 111 + dis_m = person_distance(h) + sq = 170 / h /100 + label += f' {dis_m}m' + txt = '{0}'.format(label) + # annotator.box_label(xyxy, txt, color=(255, 0, 255)) + annotator.box_label(xyxy, txt, color=colors(c, True)) + if names[int(cls)] == "car": + car_coords.append(xyxy) + c = int(cls) # integer class 整数类 1111111111 + label = None if hide_labels else ( + names[c] if hide_conf else f'{names[c]} {conf:.2f}') # 111 + dis_m1 = car_distance(h) + label += f' {dis_m1}m' + txt = '{0}'.format(label) + # annotator.box_label(xyxy, txt, color=(255, 0, 255)) + annotator.box_label(xyxy, txt, color=colors(c, True)) + + if save_crop: + save_one_box(xyxy, imc, file=save_dir / 'crops' / names[c] / f'{p.stem}.jpg', BGR=True) + + # Stream results + im0 = annotator.result() + im = distancing_1(person_coords, car_coords, dis_m1, dis_m, sq, im0) + '''if view_img: + cv2.imshow(str(p), im0) + cv2.waitKey(1) # 1 millisecond''' + if view_img: + cv2.namedWindow("Webcam", cv2.WINDOW_NORMAL) + cv2.resizeWindow("Webcam", 1280, 720) + cv2.moveWindow("Webcam", 0, 100) + cv2.imshow("Webcam", im0) + cv2.waitKey(1) + + # Save results (image with detections) + if save_img: + if dataset.mode == 'image': + cv2.imwrite(save_path, im0) + else: # 'video' or 'stream' + if vid_path[i] != save_path: # new video + vid_path[i] = save_path + if isinstance(vid_writer[i], cv2.VideoWriter): + vid_writer[i].release() # release previous video writer + if vid_cap: # video + fps = vid_cap.get(cv2.CAP_PROP_FPS) + w = int(vid_cap.get(cv2.CAP_PROP_FRAME_WIDTH)) + h = int(vid_cap.get(cv2.CAP_PROP_FRAME_HEIGHT)) + else: # stream + fps, w, h = 30, im0.shape[1], im0.shape[0] + save_path = str(Path(save_path).with_suffix('.mp4')) # force *.mp4 suffix on results videos + vid_writer[i] = cv2.VideoWriter(save_path, cv2.VideoWriter_fourcc(*'mp4v'), fps, (w, h)) + vid_writer[i].write(im0) + + # Print time (inference-only) + LOGGER.info(f'{s}Done. ({t3 - t2:.3f}s)') + + # Print results + t = tuple(x / seen * 1E3 for x in dt) # speeds per image + LOGGER.info(f'Speed: %.1fms pre-process, %.1fms inference, %.1fms NMS per image at shape {(1, 3, *imgsz)}' % t) + if save_txt or save_img: + s = f"\n{len(list(save_dir.glob('labels/*.txt')))} labels saved to {save_dir / 'labels'}" if save_txt else '' + LOGGER.info(f"Results saved to {colorstr('bold', save_dir)}{s}") + if update: + strip_optimizer(weights) # update model (to fix SourceChangeWarning) + + +def parse_opt(): + parser = argparse.ArgumentParser() + parser.add_argument('--weights', nargs='+', type=str, default=ROOT / 'yolov5s.pt', help='model path(s)') + parser.add_argument('--source', type=str, default=ROOT / 'data/images/3.mp4', help='file/dir/URL/glob, 0 for webcam') + parser.add_argument('--data', type=str, default=ROOT / 'data/coco128.yaml', help='(optional) dataset.yaml path') + parser.add_argument('--imgsz', '--img', '--img-size', nargs='+', type=int, default=[640], help='inference size h,w') + parser.add_argument('--conf-thres', type=float, default=0.25, help='confidence threshold') + parser.add_argument('--iou-thres', type=float, default=0.45, help='NMS IoU threshold') + parser.add_argument('--max-det', type=int, default=1000, help='maximum detections per image') + parser.add_argument('--device', default='', help='cuda device, i.e. 0 or 0,1,2,3 or cpu') + parser.add_argument('--view-img', action='store_true', help='show results') + parser.add_argument('--save-txt', action='store_true', help='save results to *.txt') + parser.add_argument('--save-conf', action='store_true', help='save confidences in --save-txt labels') + parser.add_argument('--save-crop', action='store_true', help='save cropped prediction boxes') + parser.add_argument('--nosave', action='store_true', help='do not save images/videos') + parser.add_argument('--classes', nargs='+', type=int, help='filter by class: --classes 0, or --classes 0 2 3') + parser.add_argument('--agnostic-nms', action='store_true', help='class-agnostic NMS') + parser.add_argument('--augment', action='store_true', help='augmented inference') + parser.add_argument('--visualize', action='store_true', help='visualize features') + parser.add_argument('--update', action='store_true', help='update all models') + parser.add_argument('--project', default=ROOT / 'runs/detect', help='save results to project/name') + parser.add_argument('--name', default='exp', help='save results to project/name') + parser.add_argument('--exist-ok', action='store_true', help='existing project/name ok, do not increment') + parser.add_argument('--line-thickness', default=3, type=int, help='bounding box thickness (pixels)') + parser.add_argument('--hide-labels', default=False, action='store_true', help='hide labels') + parser.add_argument('--hide-conf', default=False, action='store_true', help='hide confidences') + parser.add_argument('--half', action='store_true', help='use FP16 half-precision inference') + parser.add_argument('--dnn', action='store_true', help='use OpenCV DNN for ONNX inference') + opt = parser.parse_args() + opt.imgsz *= 2 if len(opt.imgsz) == 1 else 1 # expand + print_args(FILE.stem, opt) + return opt + + +def main(opt): + check_requirements(exclude=('tensorboard', 'thop')) + run(**vars(opt)) + + +if __name__ == "__main__": + opt = parse_opt() + main(opt) diff --git a/yolov5_Monocular_social_ranging/distance.py b/yolov5_Monocular_social_ranging/distance.py new file mode 100644 index 0000000..8db9ef1 --- /dev/null +++ b/yolov5_Monocular_social_ranging/distance.py @@ -0,0 +1,18 @@ +foc = 1990.0 # 镜头焦距 +real_hight_person = 66.9 # 行人高度 +real_hight_car = 57.08 # 轿车高度 + +# 自定义函数，单目测距 +def person_distance(h): + dis_inch = (real_hight_person * foc) / (h - 2) + dis_cm = dis_inch * 2.54 + dis_cm = int(dis_cm) + dis_m = dis_cm/100 + return dis_m + +def car_distance(h): + dis_inch = (real_hight_car * foc) / (h - 2) + dis_cm = dis_inch * 2.54 + dis_cm = int(dis_cm) + dis_m = dis_cm/100 + return dis_m \ No newline at end of file diff --git a/yolov5_Monocular_social_ranging/export.py b/yolov5_Monocular_social_ranging/export.py new file mode 100644 index 0000000..15e92a7 --- /dev/null +++ b/yolov5_Monocular_social_ranging/export.py @@ -0,0 +1,559 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +Export a YOLOv5 PyTorch model to other formats. TensorFlow exports authored by https://github.com/zldrobit + +Format | `export.py --include` | Model +--- | --- | --- +PyTorch | - | yolov5s.pt +TorchScript | `torchscript` | yolov5s.torchscript +ONNX | `onnx` | yolov5s.onnx +OpenVINO | `openvino` | yolov5s_openvino_model/ +TensorRT | `engine` | yolov5s.engine +CoreML | `coreml` | yolov5s.mlmodel +TensorFlow SavedModel | `saved_model` | yolov5s_saved_model/ +TensorFlow GraphDef | `pb` | yolov5s.pb +TensorFlow Lite | `tflite` | yolov5s.tflite +TensorFlow Edge TPU | `edgetpu` | yolov5s_edgetpu.tflite +TensorFlow.js | `tfjs` | yolov5s_web_model/ + +Requirements: + $ pip install -r requirements.txt coremltools onnx onnx-simplifier onnxruntime openvino-dev tensorflow-cpu # CPU + $ pip install -r requirements.txt coremltools onnx onnx-simplifier onnxruntime-gpu openvino-dev tensorflow # GPU + +Usage: + $ python path/to/export.py --weights yolov5s.pt --include torchscript onnx openvino engine coreml tflite ... + +Inference: + $ python path/to/detect.py --weights yolov5s.pt # PyTorch + yolov5s.torchscript # TorchScript + yolov5s.onnx # ONNX Runtime or OpenCV DNN with --dnn + yolov5s.xml # OpenVINO + yolov5s.engine # TensorRT + yolov5s.mlmodel # CoreML (MacOS-only) + yolov5s_saved_model # TensorFlow SavedModel + yolov5s.pb # TensorFlow GraphDef + yolov5s.tflite # TensorFlow Lite + yolov5s_edgetpu.tflite # TensorFlow Edge TPU + +TensorFlow.js: + $ cd .. && git clone https://github.com/zldrobit/tfjs-yolov5-example.git && cd tfjs-yolov5-example + $ npm install + $ ln -s ../../yolov5/yolov5s_web_model public/yolov5s_web_model + $ npm start +""" + +import argparse +import json +import os +import platform +import subprocess +import sys +import time +import warnings +from pathlib import Path + +import pandas as pd +import torch +import torch.nn as nn +from torch.utils.mobile_optimizer import optimize_for_mobile + +FILE = Path(__file__).resolve() +ROOT = FILE.parents[0] # YOLOv5 root directory +if str(ROOT) not in sys.path: + sys.path.append(str(ROOT)) # add ROOT to PATH +ROOT = Path(os.path.relpath(ROOT, Path.cwd())) # relative + +from models.common import Conv +from models.experimental import attempt_load +from models.yolo import Detect +from utils.activations import SiLU +from utils.datasets import LoadImages +from utils.general import (LOGGER, check_dataset, check_img_size, check_requirements, check_version, colorstr, + file_size, print_args, url2file) +from utils.torch_utils import select_device + + +def export_formats(): + # YOLOv5 export formats + x = [['PyTorch', '-', '.pt'], + ['TorchScript', 'torchscript', '.torchscript'], + ['ONNX', 'onnx', '.onnx'], + ['OpenVINO', 'openvino', '_openvino_model'], + ['TensorRT', 'engine', '.engine'], + ['CoreML', 'coreml', '.mlmodel'], + ['TensorFlow SavedModel', 'saved_model', '_saved_model'], + ['TensorFlow GraphDef', 'pb', '.pb'], + ['TensorFlow Lite', 'tflite', '.tflite'], + ['TensorFlow Edge TPU', 'edgetpu', '_edgetpu.tflite'], + ['TensorFlow.js', 'tfjs', '_web_model']] + return pd.DataFrame(x, columns=['Format', 'Argument', 'Suffix']) + + +def export_torchscript(model, im, file, optimize, prefix=colorstr('TorchScript:')): + # YOLOv5 TorchScript model export + try: + LOGGER.info(f'\n{prefix} starting export with torch {torch.__version__}...') + f = file.with_suffix('.torchscript') + + ts = torch.jit.trace(model, im, strict=False) + d = {"shape": im.shape, "stride": int(max(model.stride)), "names": model.names} + extra_files = {'config.txt': json.dumps(d)} # torch._C.ExtraFilesMap() + if optimize: # https://pytorch.org/tutorials/recipes/mobile_interpreter.html + optimize_for_mobile(ts)._save_for_lite_interpreter(str(f), _extra_files=extra_files) + else: + ts.save(str(f), _extra_files=extra_files) + + LOGGER.info(f'{prefix} export success, saved as {f} ({file_size(f):.1f} MB)') + return f + except Exception as e: + LOGGER.info(f'{prefix} export failure: {e}') + + +def export_onnx(model, im, file, opset, train, dynamic, simplify, prefix=colorstr('ONNX:')): + # YOLOv5 ONNX export + try: + check_requirements(('onnx',)) + import onnx + + LOGGER.info(f'\n{prefix} starting export with onnx {onnx.__version__}...') + f = file.with_suffix('.onnx') + + torch.onnx.export(model, im, f, verbose=False, opset_version=opset, + training=torch.onnx.TrainingMode.TRAINING if train else torch.onnx.TrainingMode.EVAL, + do_constant_folding=not train, + input_names=['images'], + output_names=['output'], + dynamic_axes={'images': {0: 'batch', 2: 'height', 3: 'width'}, # shape(1,3,640,640) + 'output': {0: 'batch', 1: 'anchors'} # shape(1,25200,85) + } if dynamic else None) + + # Checks + model_onnx = onnx.load(f) # load onnx model + onnx.checker.check_model(model_onnx) # check onnx model + # LOGGER.info(onnx.helper.printable_graph(model_onnx.graph)) # print + + # Simplify + if simplify: + try: + check_requirements(('onnx-simplifier',)) + import onnxsim + + LOGGER.info(f'{prefix} simplifying with onnx-simplifier {onnxsim.__version__}...') + model_onnx, check = onnxsim.simplify( + model_onnx, + dynamic_input_shape=dynamic, + input_shapes={'images': list(im.shape)} if dynamic else None) + assert check, 'assert check failed' + onnx.save(model_onnx, f) + except Exception as e: + LOGGER.info(f'{prefix} simplifier failure: {e}') + LOGGER.info(f'{prefix} export success, saved as {f} ({file_size(f):.1f} MB)') + return f + except Exception as e: + LOGGER.info(f'{prefix} export failure: {e}') + + +def export_openvino(model, im, file, prefix=colorstr('OpenVINO:')): + # YOLOv5 OpenVINO export + try: + check_requirements(('openvino-dev',)) # requires openvino-dev: https://pypi.org/project/openvino-dev/ + import openvino.inference_engine as ie + + LOGGER.info(f'\n{prefix} starting export with openvino {ie.__version__}...') + f = str(file).replace('.pt', '_openvino_model' + os.sep) + + cmd = f"mo --input_model {file.with_suffix('.onnx')} --output_dir {f}" + subprocess.check_output(cmd, shell=True) + + LOGGER.info(f'{prefix} export success, saved as {f} ({file_size(f):.1f} MB)') + return f + except Exception as e: + LOGGER.info(f'\n{prefix} export failure: {e}') + + +def export_coreml(model, im, file, prefix=colorstr('CoreML:')): + # YOLOv5 CoreML export + try: + check_requirements(('coremltools',)) + import coremltools as ct + + LOGGER.info(f'\n{prefix} starting export with coremltools {ct.__version__}...') + f = file.with_suffix('.mlmodel') + + ts = torch.jit.trace(model, im, strict=False) # TorchScript model + ct_model = ct.convert(ts, inputs=[ct.ImageType('image', shape=im.shape, scale=1 / 255, bias=[0, 0, 0])]) + ct_model.save(f) + + LOGGER.info(f'{prefix} export success, saved as {f} ({file_size(f):.1f} MB)') + return ct_model, f + except Exception as e: + LOGGER.info(f'\n{prefix} export failure: {e}') + return None, None + + +def export_engine(model, im, file, train, half, simplify, workspace=4, verbose=False, prefix=colorstr('TensorRT:')): + # YOLOv5 TensorRT export https://developer.nvidia.com/tensorrt + try: + check_requirements(('tensorrt',)) + import tensorrt as trt + + if trt.__version__[0] == '7': # TensorRT 7 handling https://github.com/ultralytics/yolov5/issues/6012 + grid = model.model[-1].anchor_grid + model.model[-1].anchor_grid = [a[..., :1, :1, :] for a in grid] + export_onnx(model, im, file, 12, train, False, simplify) # opset 12 + model.model[-1].anchor_grid = grid + else: # TensorRT >= 8 + check_version(trt.__version__, '8.0.0', hard=True) # require tensorrt>=8.0.0 + export_onnx(model, im, file, 13, train, False, simplify) # opset 13 + onnx = file.with_suffix('.onnx') + + LOGGER.info(f'\n{prefix} starting export with TensorRT {trt.__version__}...') + assert im.device.type != 'cpu', 'export running on CPU but must be on GPU, i.e. `python export.py --device 0`' + assert onnx.exists(), f'failed to export ONNX file: {onnx}' + f = file.with_suffix('.engine') # TensorRT engine file + logger = trt.Logger(trt.Logger.INFO) + if verbose: + logger.min_severity = trt.Logger.Severity.VERBOSE + + builder = trt.Builder(logger) + config = builder.create_builder_config() + config.max_workspace_size = workspace * 1 << 30 + + flag = (1 << int(trt.NetworkDefinitionCreationFlag.EXPLICIT_BATCH)) + network = builder.create_network(flag) + parser = trt.OnnxParser(network, logger) + if not parser.parse_from_file(str(onnx)): + raise RuntimeError(f'failed to load ONNX file: {onnx}') + + inputs = [network.get_input(i) for i in range(network.num_inputs)] + outputs = [network.get_output(i) for i in range(network.num_outputs)] + LOGGER.info(f'{prefix} Network Description:') + for inp in inputs: + LOGGER.info(f'{prefix}\tinput "{inp.name}" with shape {inp.shape} and dtype {inp.dtype}') + for out in outputs: + LOGGER.info(f'{prefix}\toutput "{out.name}" with shape {out.shape} and dtype {out.dtype}') + + half &= builder.platform_has_fast_fp16 + LOGGER.info(f'{prefix} building FP{16 if half else 32} engine in {f}') + if half: + config.set_flag(trt.BuilderFlag.FP16) + with builder.build_engine(network, config) as engine, open(f, 'wb') as t: + t.write(engine.serialize()) + LOGGER.info(f'{prefix} export success, saved as {f} ({file_size(f):.1f} MB)') + return f + except Exception as e: + LOGGER.info(f'\n{prefix} export failure: {e}') + + +def export_saved_model(model, im, file, dynamic, + tf_nms=False, agnostic_nms=False, topk_per_class=100, topk_all=100, iou_thres=0.45, + conf_thres=0.25, keras=False, prefix=colorstr('TensorFlow SavedModel:')): + # YOLOv5 TensorFlow SavedModel export + try: + import tensorflow as tf + from tensorflow.python.framework.convert_to_constants import convert_variables_to_constants_v2 + + from models.tf import TFDetect, TFModel + + LOGGER.info(f'\n{prefix} starting export with tensorflow {tf.__version__}...') + f = str(file).replace('.pt', '_saved_model') + batch_size, ch, *imgsz = list(im.shape) # BCHW + + tf_model = TFModel(cfg=model.yaml, model=model, nc=model.nc, imgsz=imgsz) + im = tf.zeros((batch_size, *imgsz, 3)) # BHWC order for TensorFlow + _ = tf_model.predict(im, tf_nms, agnostic_nms, topk_per_class, topk_all, iou_thres, conf_thres) + inputs = tf.keras.Input(shape=(*imgsz, 3), batch_size=None if dynamic else batch_size) + outputs = tf_model.predict(inputs, tf_nms, agnostic_nms, topk_per_class, topk_all, iou_thres, conf_thres) + keras_model = tf.keras.Model(inputs=inputs, outputs=outputs) + keras_model.trainable = False + keras_model.summary() + if keras: + keras_model.save(f, save_format='tf') + else: + m = tf.function(lambda x: keras_model(x)) # full model + spec = tf.TensorSpec(keras_model.inputs[0].shape, keras_model.inputs[0].dtype) + m = m.get_concrete_function(spec) + frozen_func = convert_variables_to_constants_v2(m) + tfm = tf.Module() + tfm.__call__ = tf.function(lambda x: frozen_func(x), [spec]) + tfm.__call__(im) + tf.saved_model.save( + tfm, + f, + options=tf.saved_model.SaveOptions(experimental_custom_gradients=False) if + check_version(tf.__version__, '2.6') else tf.saved_model.SaveOptions()) + LOGGER.info(f'{prefix} export success, saved as {f} ({file_size(f):.1f} MB)') + return keras_model, f + except Exception as e: + LOGGER.info(f'\n{prefix} export failure: {e}') + return None, None + + +def export_pb(keras_model, im, file, prefix=colorstr('TensorFlow GraphDef:')): + # YOLOv5 TensorFlow GraphDef *.pb export https://github.com/leimao/Frozen_Graph_TensorFlow + try: + import tensorflow as tf + from tensorflow.python.framework.convert_to_constants import convert_variables_to_constants_v2 + + LOGGER.info(f'\n{prefix} starting export with tensorflow {tf.__version__}...') + f = file.with_suffix('.pb') + + m = tf.function(lambda x: keras_model(x)) # full model + m = m.get_concrete_function(tf.TensorSpec(keras_model.inputs[0].shape, keras_model.inputs[0].dtype)) + frozen_func = convert_variables_to_constants_v2(m) + frozen_func.graph.as_graph_def() + tf.io.write_graph(graph_or_graph_def=frozen_func.graph, logdir=str(f.parent), name=f.name, as_text=False) + + LOGGER.info(f'{prefix} export success, saved as {f} ({file_size(f):.1f} MB)') + return f + except Exception as e: + LOGGER.info(f'\n{prefix} export failure: {e}') + + +def export_tflite(keras_model, im, file, int8, data, ncalib, prefix=colorstr('TensorFlow Lite:')): + # YOLOv5 TensorFlow Lite export + try: + import tensorflow as tf + + LOGGER.info(f'\n{prefix} starting export with tensorflow {tf.__version__}...') + batch_size, ch, *imgsz = list(im.shape) # BCHW + f = str(file).replace('.pt', '-fp16.tflite') + + converter = tf.lite.TFLiteConverter.from_keras_model(keras_model) + converter.target_spec.supported_ops = [tf.lite.OpsSet.TFLITE_BUILTINS] + converter.target_spec.supported_types = [tf.float16] + converter.optimizations = [tf.lite.Optimize.DEFAULT] + if int8: + from models.tf import representative_dataset_gen + dataset = LoadImages(check_dataset(data)['train'], img_size=imgsz, auto=False) # representative data + converter.representative_dataset = lambda: representative_dataset_gen(dataset, ncalib) + converter.target_spec.supported_ops = [tf.lite.OpsSet.TFLITE_BUILTINS_INT8] + converter.target_spec.supported_types = [] + converter.inference_input_type = tf.uint8 # or tf.int8 + converter.inference_output_type = tf.uint8 # or tf.int8 + converter.experimental_new_quantizer = False + f = str(file).replace('.pt', '-int8.tflite') + + tflite_model = converter.convert() + open(f, "wb").write(tflite_model) + LOGGER.info(f'{prefix} export success, saved as {f} ({file_size(f):.1f} MB)') + return f + except Exception as e: + LOGGER.info(f'\n{prefix} export failure: {e}') + + +def export_edgetpu(keras_model, im, file, prefix=colorstr('Edge TPU:')): + # YOLOv5 Edge TPU export https://coral.ai/docs/edgetpu/models-intro/ + try: + cmd = 'edgetpu_compiler --version' + help_url = 'https://coral.ai/docs/edgetpu/compiler/' + assert platform.system() == 'Linux', f'export only supported on Linux. See {help_url}' + if subprocess.run(cmd + ' >/dev/null', shell=True).returncode != 0: + LOGGER.info(f'\n{prefix} export requires Edge TPU compiler. Attempting install from {help_url}') + sudo = subprocess.run('sudo --version >/dev/null', shell=True).returncode == 0 # sudo installed on system + for c in ['curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -', + 'echo "deb https://packages.cloud.google.com/apt coral-edgetpu-stable main" | sudo tee /etc/apt/sources.list.d/coral-edgetpu.list', + 'sudo apt-get update', + 'sudo apt-get install edgetpu-compiler']: + subprocess.run(c if sudo else c.replace('sudo ', ''), shell=True, check=True) + ver = subprocess.run(cmd, shell=True, capture_output=True, check=True).stdout.decode().split()[-1] + + LOGGER.info(f'\n{prefix} starting export with Edge TPU compiler {ver}...') + f = str(file).replace('.pt', '-int8_edgetpu.tflite') # Edge TPU model + f_tfl = str(file).replace('.pt', '-int8.tflite') # TFLite model + + cmd = f"edgetpu_compiler -s {f_tfl}" + subprocess.run(cmd, shell=True, check=True) + + LOGGER.info(f'{prefix} export success, saved as {f} ({file_size(f):.1f} MB)') + return f + except Exception as e: + LOGGER.info(f'\n{prefix} export failure: {e}') + + +def export_tfjs(keras_model, im, file, prefix=colorstr('TensorFlow.js:')): + # YOLOv5 TensorFlow.js export + try: + check_requirements(('tensorflowjs',)) + import re + + import tensorflowjs as tfjs + + LOGGER.info(f'\n{prefix} starting export with tensorflowjs {tfjs.__version__}...') + f = str(file).replace('.pt', '_web_model') # js dir + f_pb = file.with_suffix('.pb') # *.pb path + f_json = f + '/model.json' # *.json path + + cmd = f'tensorflowjs_converter --input_format=tf_frozen_model ' \ + f'--output_node_names="Identity,Identity_1,Identity_2,Identity_3" {f_pb} {f}' + subprocess.run(cmd, shell=True) + + json = open(f_json).read() + with open(f_json, 'w') as j: # sort JSON Identity_* in ascending order + subst = re.sub( + r'{"outputs": {"Identity.?.?": {"name": "Identity.?.?"}, ' + r'"Identity.?.?": {"name": "Identity.?.?"}, ' + r'"Identity.?.?": {"name": "Identity.?.?"}, ' + r'"Identity.?.?": {"name": "Identity.?.?"}}}', + r'{"outputs": {"Identity": {"name": "Identity"}, ' + r'"Identity_1": {"name": "Identity_1"}, ' + r'"Identity_2": {"name": "Identity_2"}, ' + r'"Identity_3": {"name": "Identity_3"}}}', + json) + j.write(subst) + + LOGGER.info(f'{prefix} export success, saved as {f} ({file_size(f):.1f} MB)') + return f + except Exception as e: + LOGGER.info(f'\n{prefix} export failure: {e}') + + +@torch.no_grad() +def run(data=ROOT / 'data/coco128.yaml', # 'dataset.yaml path' + weights=ROOT / 'yolov5s.pt', # weights path + imgsz=(640, 640), # image (height, width) + batch_size=1, # batch size + device='cpu', # cuda device, i.e. 0 or 0,1,2,3 or cpu + include=('torchscript', 'onnx'), # include formats + half=False, # FP16 half-precision export + inplace=False, # set YOLOv5 Detect() inplace=True + train=False, # model.train() mode + optimize=False, # TorchScript: optimize for mobile + int8=False, # CoreML/TF INT8 quantization + dynamic=False, # ONNX/TF: dynamic axes + simplify=False, # ONNX: simplify model + opset=12, # ONNX: opset version + verbose=False, # TensorRT: verbose log + workspace=4, # TensorRT: workspace size (GB) + nms=False, # TF: add NMS to model + agnostic_nms=False, # TF: add agnostic NMS to model + topk_per_class=100, # TF.js NMS: topk per class to keep + topk_all=100, # TF.js NMS: topk for all classes to keep + iou_thres=0.45, # TF.js NMS: IoU threshold + conf_thres=0.25 # TF.js NMS: confidence threshold + ): + t = time.time() + include = [x.lower() for x in include] # to lowercase + formats = tuple(export_formats()['Argument'][1:]) # --include arguments + flags = [x in include for x in formats] + assert sum(flags) == len(include), f'ERROR: Invalid --include {include}, valid --include arguments are {formats}' + jit, onnx, xml, engine, coreml, saved_model, pb, tflite, edgetpu, tfjs = flags # export booleans + file = Path(url2file(weights) if str(weights).startswith(('http:/', 'https:/')) else weights) # PyTorch weights + + # Load PyTorch model + device = select_device(device) + assert not (device.type == 'cpu' and half), '--half only compatible with GPU export, i.e. use --device 0' + model = attempt_load(weights, map_location=device, inplace=True, fuse=True) # load FP32 model + nc, names = model.nc, model.names # number of classes, class names + + # Checks + imgsz *= 2 if len(imgsz) == 1 else 1 # expand + opset = 12 if ('openvino' in include) else opset # OpenVINO requires opset <= 12 + assert nc == len(names), f'Model class count {nc} != len(names) {len(names)}' + + # Input + gs = int(max(model.stride)) # grid size (max stride) + imgsz = [check_img_size(x, gs) for x in imgsz] # verify img_size are gs-multiples + im = torch.zeros(batch_size, 3, *imgsz).to(device) # image size(1,3,320,192) BCHW iDetection + + # Update model + if half: + im, model = im.half(), model.half() # to FP16 + model.train() if train else model.eval() # training mode = no Detect() layer grid construction + for k, m in model.named_modules(): + if isinstance(m, Conv): # assign export-friendly activations + if isinstance(m.act, nn.SiLU): + m.act = SiLU() + elif isinstance(m, Detect): + m.inplace = inplace + m.onnx_dynamic = dynamic + if hasattr(m, 'forward_export'): + m.forward = m.forward_export # assign custom forward (optional) + + for _ in range(2): + y = model(im) # dry runs + shape = tuple(y[0].shape) # model output shape + LOGGER.info(f"\n{colorstr('PyTorch:')} starting from {file} with output shape {shape} ({file_size(file):.1f} MB)") + + # Exports + f = [''] * 10 # exported filenames + warnings.filterwarnings(action='ignore', category=torch.jit.TracerWarning) # suppress TracerWarning + if jit: + f[0] = export_torchscript(model, im, file, optimize) + if engine: # TensorRT required before ONNX + f[1] = export_engine(model, im, file, train, half, simplify, workspace, verbose) + if onnx or xml: # OpenVINO requires ONNX + f[2] = export_onnx(model, im, file, opset, train, dynamic, simplify) + if xml: # OpenVINO + f[3] = export_openvino(model, im, file) + if coreml: + _, f[4] = export_coreml(model, im, file) + + # TensorFlow Exports + if any((saved_model, pb, tflite, edgetpu, tfjs)): + if int8 or edgetpu: # TFLite --int8 bug https://github.com/ultralytics/yolov5/issues/5707 + check_requirements(('flatbuffers==1.12',)) # required before `import tensorflow` + assert not (tflite and tfjs), 'TFLite and TF.js models must be exported separately, please pass only one type.' + model, f[5] = export_saved_model(model, im, file, dynamic, tf_nms=nms or agnostic_nms or tfjs, + agnostic_nms=agnostic_nms or tfjs, topk_per_class=topk_per_class, + topk_all=topk_all, conf_thres=conf_thres, iou_thres=iou_thres) # keras model + if pb or tfjs: # pb prerequisite to tfjs + f[6] = export_pb(model, im, file) + if tflite or edgetpu: + f[7] = export_tflite(model, im, file, int8=int8 or edgetpu, data=data, ncalib=100) + if edgetpu: + f[8] = export_edgetpu(model, im, file) + if tfjs: + f[9] = export_tfjs(model, im, file) + + # Finish + f = [str(x) for x in f if x] # filter out '' and None + if any(f): + LOGGER.info(f'\nExport complete ({time.time() - t:.2f}s)' + f"\nResults saved to {colorstr('bold', file.parent.resolve())}" + f"\nDetect: python detect.py --weights {f[-1]}" + f"\nPyTorch Hub: model = torch.hub.load('ultralytics/yolov5', 'custom', '{f[-1]}')" + f"\nValidate: python val.py --weights {f[-1]}" + f"\nVisualize: https://netron.app") + return f # return list of exported files/dirs + + +def parse_opt(): + parser = argparse.ArgumentParser() + parser.add_argument('--data', type=str, default=ROOT / 'data/coco128.yaml', help='dataset.yaml path') + parser.add_argument('--weights', nargs='+', type=str, default=ROOT / 'yolov5s.pt', help='model.pt path(s)') + parser.add_argument('--imgsz', '--img', '--img-size', nargs='+', type=int, default=[640, 640], help='image (h, w)') + parser.add_argument('--batch-size', type=int, default=1, help='batch size') + parser.add_argument('--device', default='cpu', help='cuda device, i.e. 0 or 0,1,2,3 or cpu') + parser.add_argument('--half', action='store_true', help='FP16 half-precision export') + parser.add_argument('--inplace', action='store_true', help='set YOLOv5 Detect() inplace=True') + parser.add_argument('--train', action='store_true', help='model.train() mode') + parser.add_argument('--optimize', action='store_true', help='TorchScript: optimize for mobile') + parser.add_argument('--int8', action='store_true', help='CoreML/TF INT8 quantization') + parser.add_argument('--dynamic', action='store_true', help='ONNX/TF: dynamic axes') + parser.add_argument('--simplify', action='store_true', help='ONNX: simplify model') + parser.add_argument('--opset', type=int, default=12, help='ONNX: opset version') + parser.add_argument('--verbose', action='store_true', help='TensorRT: verbose log') + parser.add_argument('--workspace', type=int, default=4, help='TensorRT: workspace size (GB)') + parser.add_argument('--nms', action='store_true', help='TF: add NMS to model') + parser.add_argument('--agnostic-nms', action='store_true', help='TF: add agnostic NMS to model') + parser.add_argument('--topk-per-class', type=int, default=100, help='TF.js NMS: topk per class to keep') + parser.add_argument('--topk-all', type=int, default=100, help='TF.js NMS: topk for all classes to keep') + parser.add_argument('--iou-thres', type=float, default=0.45, help='TF.js NMS: IoU threshold') + parser.add_argument('--conf-thres', type=float, default=0.25, help='TF.js NMS: confidence threshold') + parser.add_argument('--include', nargs='+', + default=['torchscript', 'onnx'], + help='torchscript, onnx, openvino, engine, coreml, saved_model, pb, tflite, edgetpu, tfjs') + opt = parser.parse_args() + print_args(FILE.stem, opt) + return opt + + +def main(opt): + for opt.weights in (opt.weights if isinstance(opt.weights, list) else [opt.weights]): + run(**vars(opt)) + + +if __name__ == "__main__": + opt = parse_opt() + main(opt) diff --git a/yolov5_Monocular_social_ranging/hubconf.py b/yolov5_Monocular_social_ranging/hubconf.py new file mode 100644 index 0000000..39fa614 --- /dev/null +++ b/yolov5_Monocular_social_ranging/hubconf.py @@ -0,0 +1,143 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +PyTorch Hub models https://pytorch.org/hub/ultralytics_yolov5/ + +Usage: + import torch + model = torch.hub.load('ultralytics/yolov5', 'yolov5s') + model = torch.hub.load('ultralytics/yolov5:master', 'custom', 'path/to/yolov5s.onnx') # file from branch +""" + +import torch + + +def _create(name, pretrained=True, channels=3, classes=80, autoshape=True, verbose=True, device=None): + """Creates or loads a YOLOv5 model + + Arguments: + name (str): model name 'yolov5s' or path 'path/to/best.pt' + pretrained (bool): load pretrained weights into the model + channels (int): number of input channels + classes (int): number of model classes + autoshape (bool): apply YOLOv5 .autoshape() wrapper to model + verbose (bool): print all information to screen + device (str, torch.device, None): device to use for model parameters + + Returns: + YOLOv5 model + """ + from pathlib import Path + + from models.common import AutoShape, DetectMultiBackend + from models.yolo import Model + from utils.downloads import attempt_download + from utils.general import LOGGER, check_requirements, intersect_dicts, logging + from utils.torch_utils import select_device + + if not verbose: + LOGGER.setLevel(logging.WARNING) + check_requirements(exclude=('tensorboard', 'thop', 'opencv-python')) + name = Path(name) + path = name.with_suffix('.pt') if name.suffix == '' else name # checkpoint path + try: + device = select_device(('0' if torch.cuda.is_available() else 'cpu') if device is None else device) + + if pretrained and channels == 3 and classes == 80: + model = DetectMultiBackend(path, device=device) # download/load FP32 model + # model = models.experimental.attempt_load(path, map_location=device) # download/load FP32 model + else: + cfg = list((Path(__file__).parent / 'models').rglob(f'{path.stem}.yaml'))[0] # model.yaml path + model = Model(cfg, channels, classes) # create model + if pretrained: + ckpt = torch.load(attempt_download(path), map_location=device) # load + csd = ckpt['model'].float().state_dict() # checkpoint state_dict as FP32 + csd = intersect_dicts(csd, model.state_dict(), exclude=['anchors']) # intersect + model.load_state_dict(csd, strict=False) # load + if len(ckpt['model'].names) == classes: + model.names = ckpt['model'].names # set class names attribute + if autoshape: + model = AutoShape(model) # for file/URI/PIL/cv2/np inputs and NMS + return model.to(device) + + except Exception as e: + help_url = 'https://github.com/ultralytics/yolov5/issues/36' + s = f'{e}. Cache may be out of date, try `force_reload=True` or see {help_url} for help.' + raise Exception(s) from e + + +def custom(path='path/to/model.pt', autoshape=True, verbose=True, device=None): + # YOLOv5 custom or local model + return _create(path, autoshape=autoshape, verbose=verbose, device=device) + + +def yolov5n(pretrained=True, channels=3, classes=80, autoshape=True, verbose=True, device=None): + # YOLOv5-nano model https://github.com/ultralytics/yolov5 + return _create('yolov5n', pretrained, channels, classes, autoshape, verbose, device) + + +def yolov5s(pretrained=True, channels=3, classes=80, autoshape=True, verbose=True, device=None): + # YOLOv5-small model https://github.com/ultralytics/yolov5 + return _create('yolov5s', pretrained, channels, classes, autoshape, verbose, device) + + +def yolov5m(pretrained=True, channels=3, classes=80, autoshape=True, verbose=True, device=None): + # YOLOv5-medium model https://github.com/ultralytics/yolov5 + return _create('yolov5m', pretrained, channels, classes, autoshape, verbose, device) + + +def yolov5l(pretrained=True, channels=3, classes=80, autoshape=True, verbose=True, device=None): + # YOLOv5-large model https://github.com/ultralytics/yolov5 + return _create('yolov5l', pretrained, channels, classes, autoshape, verbose, device) + + +def yolov5x(pretrained=True, channels=3, classes=80, autoshape=True, verbose=True, device=None): + # YOLOv5-xlarge model https://github.com/ultralytics/yolov5 + return _create('yolov5x', pretrained, channels, classes, autoshape, verbose, device) + + +def yolov5n6(pretrained=True, channels=3, classes=80, autoshape=True, verbose=True, device=None): + # YOLOv5-nano-P6 model https://github.com/ultralytics/yolov5 + return _create('yolov5n6', pretrained, channels, classes, autoshape, verbose, device) + + +def yolov5s6(pretrained=True, channels=3, classes=80, autoshape=True, verbose=True, device=None): + # YOLOv5-small-P6 model https://github.com/ultralytics/yolov5 + return _create('yolov5s6', pretrained, channels, classes, autoshape, verbose, device) + + +def yolov5m6(pretrained=True, channels=3, classes=80, autoshape=True, verbose=True, device=None): + # YOLOv5-medium-P6 model https://github.com/ultralytics/yolov5 + return _create('yolov5m6', pretrained, channels, classes, autoshape, verbose, device) + + +def yolov5l6(pretrained=True, channels=3, classes=80, autoshape=True, verbose=True, device=None): + # YOLOv5-large-P6 model https://github.com/ultralytics/yolov5 + return _create('yolov5l6', pretrained, channels, classes, autoshape, verbose, device) + + +def yolov5x6(pretrained=True, channels=3, classes=80, autoshape=True, verbose=True, device=None): + # YOLOv5-xlarge-P6 model https://github.com/ultralytics/yolov5 + return _create('yolov5x6', pretrained, channels, classes, autoshape, verbose, device) + + +if __name__ == '__main__': + model = _create(name='yolov5s', pretrained=True, channels=3, classes=80, autoshape=True, verbose=True) # pretrained + # model = custom(path='path/to/model.pt') # custom + + # Verify inference + from pathlib import Path + + import cv2 + import numpy as np + from PIL import Image + + imgs = ['data/images/zidane.jpg', # filename + Path('data/images/zidane.jpg'), # Path + 'https://ultralytics.com/images/zidane.jpg', # URI + cv2.imread('data/images/bus.jpg')[:, :, ::-1], # OpenCV + Image.open('data/images/bus.jpg'), # PIL + np.zeros((320, 640, 3))] # numpy + + results = model(imgs, size=320) # batched inference + results.print() + results.save() diff --git a/yolov5_Monocular_social_ranging/models/__init__.py b/yolov5_Monocular_social_ranging/models/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/yolov5_Monocular_social_ranging/models/common.py b/yolov5_Monocular_social_ranging/models/common.py new file mode 100644 index 0000000..0dae024 --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/common.py @@ -0,0 +1,677 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +Common modules +""" + +import json +import math +import platform +import warnings +from collections import OrderedDict, namedtuple +from copy import copy +from pathlib import Path + +import cv2 +import numpy as np +import pandas as pd +import requests +import torch +import torch.nn as nn +import yaml +from PIL import Image +from torch.cuda import amp + +from utils.datasets import exif_transpose, letterbox +from utils.general import (LOGGER, check_requirements, check_suffix, check_version, colorstr, increment_path, + make_divisible, non_max_suppression, scale_coords, xywh2xyxy, xyxy2xywh) +from utils.plots import Annotator, colors, save_one_box +from utils.torch_utils import copy_attr, time_sync + + +def autopad(k, p=None): # kernel, padding + # Pad to 'same' + if p is None: + p = k // 2 if isinstance(k, int) else [x // 2 for x in k] # auto-pad + return p + + +class Conv(nn.Module): + # Standard convolution + def __init__(self, c1, c2, k=1, s=1, p=None, g=1, act=True): # ch_in, ch_out, kernel, stride, padding, groups + super().__init__() + self.conv = nn.Conv2d(c1, c2, k, s, autopad(k, p), groups=g, bias=False) + self.bn = nn.BatchNorm2d(c2) + self.act = nn.SiLU() if act is True else (act if isinstance(act, nn.Module) else nn.Identity()) + + def forward(self, x): + return self.act(self.bn(self.conv(x))) + + def forward_fuse(self, x): + return self.act(self.conv(x)) + + +class DWConv(Conv): + # Depth-wise convolution class + def __init__(self, c1, c2, k=1, s=1, act=True): # ch_in, ch_out, kernel, stride, padding, groups + super().__init__(c1, c2, k, s, g=math.gcd(c1, c2), act=act) + + +class TransformerLayer(nn.Module): + # Transformer layer https://arxiv.org/abs/2010.11929 (LayerNorm layers removed for better performance) + def __init__(self, c, num_heads): + super().__init__() + self.q = nn.Linear(c, c, bias=False) + self.k = nn.Linear(c, c, bias=False) + self.v = nn.Linear(c, c, bias=False) + self.ma = nn.MultiheadAttention(embed_dim=c, num_heads=num_heads) + self.fc1 = nn.Linear(c, c, bias=False) + self.fc2 = nn.Linear(c, c, bias=False) + + def forward(self, x): + x = self.ma(self.q(x), self.k(x), self.v(x))[0] + x + x = self.fc2(self.fc1(x)) + x + return x + + +class TransformerBlock(nn.Module): + # Vision Transformer https://arxiv.org/abs/2010.11929 + def __init__(self, c1, c2, num_heads, num_layers): + super().__init__() + self.conv = None + if c1 != c2: + self.conv = Conv(c1, c2) + self.linear = nn.Linear(c2, c2) # learnable position embedding + self.tr = nn.Sequential(*(TransformerLayer(c2, num_heads) for _ in range(num_layers))) + self.c2 = c2 + + def forward(self, x): + if self.conv is not None: + x = self.conv(x) + b, _, w, h = x.shape + p = x.flatten(2).permute(2, 0, 1) + return self.tr(p + self.linear(p)).permute(1, 2, 0).reshape(b, self.c2, w, h) + + +class Bottleneck(nn.Module): + # Standard bottleneck + def __init__(self, c1, c2, shortcut=True, g=1, e=0.5): # ch_in, ch_out, shortcut, groups, expansion + super().__init__() + c_ = int(c2 * e) # hidden channels + self.cv1 = Conv(c1, c_, 1, 1) + self.cv2 = Conv(c_, c2, 3, 1, g=g) + self.add = shortcut and c1 == c2 + + def forward(self, x): + return x + self.cv2(self.cv1(x)) if self.add else self.cv2(self.cv1(x)) + + +class BottleneckCSP(nn.Module): + # CSP Bottleneck https://github.com/WongKinYiu/CrossStagePartialNetworks + def __init__(self, c1, c2, n=1, shortcut=True, g=1, e=0.5): # ch_in, ch_out, number, shortcut, groups, expansion + super().__init__() + c_ = int(c2 * e) # hidden channels + self.cv1 = Conv(c1, c_, 1, 1) + self.cv2 = nn.Conv2d(c1, c_, 1, 1, bias=False) + self.cv3 = nn.Conv2d(c_, c_, 1, 1, bias=False) + self.cv4 = Conv(2 * c_, c2, 1, 1) + self.bn = nn.BatchNorm2d(2 * c_) # applied to cat(cv2, cv3) + self.act = nn.SiLU() + self.m = nn.Sequential(*(Bottleneck(c_, c_, shortcut, g, e=1.0) for _ in range(n))) + + def forward(self, x): + y1 = self.cv3(self.m(self.cv1(x))) + y2 = self.cv2(x) + return self.cv4(self.act(self.bn(torch.cat((y1, y2), dim=1)))) + + +class C3(nn.Module): + # CSP Bottleneck with 3 convolutions + def __init__(self, c1, c2, n=1, shortcut=True, g=1, e=0.5): # ch_in, ch_out, number, shortcut, groups, expansion + super().__init__() + c_ = int(c2 * e) # hidden channels + self.cv1 = Conv(c1, c_, 1, 1) + self.cv2 = Conv(c1, c_, 1, 1) + self.cv3 = Conv(2 * c_, c2, 1) # act=FReLU(c2) + self.m = nn.Sequential(*(Bottleneck(c_, c_, shortcut, g, e=1.0) for _ in range(n))) + # self.m = nn.Sequential(*[CrossConv(c_, c_, 3, 1, g, 1.0, shortcut) for _ in range(n)]) + + def forward(self, x): + return self.cv3(torch.cat((self.m(self.cv1(x)), self.cv2(x)), dim=1)) + + +class C3TR(C3): + # C3 module with TransformerBlock() + def __init__(self, c1, c2, n=1, shortcut=True, g=1, e=0.5): + super().__init__(c1, c2, n, shortcut, g, e) + c_ = int(c2 * e) + self.m = TransformerBlock(c_, c_, 4, n) + + +class C3SPP(C3): + # C3 module with SPP() + def __init__(self, c1, c2, k=(5, 9, 13), n=1, shortcut=True, g=1, e=0.5): + super().__init__(c1, c2, n, shortcut, g, e) + c_ = int(c2 * e) + self.m = SPP(c_, c_, k) + + +class C3Ghost(C3): + # C3 module with GhostBottleneck() + def __init__(self, c1, c2, n=1, shortcut=True, g=1, e=0.5): + super().__init__(c1, c2, n, shortcut, g, e) + c_ = int(c2 * e) # hidden channels + self.m = nn.Sequential(*(GhostBottleneck(c_, c_) for _ in range(n))) + + +class SPP(nn.Module): + # Spatial Pyramid Pooling (SPP) layer https://arxiv.org/abs/1406.4729 + def __init__(self, c1, c2, k=(5, 9, 13)): + super().__init__() + c_ = c1 // 2 # hidden channels + self.cv1 = Conv(c1, c_, 1, 1) + self.cv2 = Conv(c_ * (len(k) + 1), c2, 1, 1) + self.m = nn.ModuleList([nn.MaxPool2d(kernel_size=x, stride=1, padding=x // 2) for x in k]) + + def forward(self, x): + x = self.cv1(x) + with warnings.catch_warnings(): + warnings.simplefilter('ignore') # suppress torch 1.9.0 max_pool2d() warning + return self.cv2(torch.cat([x] + [m(x) for m in self.m], 1)) + + +class SPPF(nn.Module): + # Spatial Pyramid Pooling - Fast (SPPF) layer for YOLOv5 by Glenn Jocher + def __init__(self, c1, c2, k=5): # equivalent to SPP(k=(5, 9, 13)) + super().__init__() + c_ = c1 // 2 # hidden channels + self.cv1 = Conv(c1, c_, 1, 1) + self.cv2 = Conv(c_ * 4, c2, 1, 1) + self.m = nn.MaxPool2d(kernel_size=k, stride=1, padding=k // 2) + + def forward(self, x): + x = self.cv1(x) + with warnings.catch_warnings(): + warnings.simplefilter('ignore') # suppress torch 1.9.0 max_pool2d() warning + y1 = self.m(x) + y2 = self.m(y1) + return self.cv2(torch.cat([x, y1, y2, self.m(y2)], 1)) + + +class Focus(nn.Module): + # Focus wh information into c-space + def __init__(self, c1, c2, k=1, s=1, p=None, g=1, act=True): # ch_in, ch_out, kernel, stride, padding, groups + super().__init__() + self.conv = Conv(c1 * 4, c2, k, s, p, g, act) + # self.contract = Contract(gain=2) + + def forward(self, x): # x(b,c,w,h) -> y(b,4c,w/2,h/2) + return self.conv(torch.cat([x[..., ::2, ::2], x[..., 1::2, ::2], x[..., ::2, 1::2], x[..., 1::2, 1::2]], 1)) + # return self.conv(self.contract(x)) + + +class GhostConv(nn.Module): + # Ghost Convolution https://github.com/huawei-noah/ghostnet + def __init__(self, c1, c2, k=1, s=1, g=1, act=True): # ch_in, ch_out, kernel, stride, groups + super().__init__() + c_ = c2 // 2 # hidden channels + self.cv1 = Conv(c1, c_, k, s, None, g, act) + self.cv2 = Conv(c_, c_, 5, 1, None, c_, act) + + def forward(self, x): + y = self.cv1(x) + return torch.cat([y, self.cv2(y)], 1) + + +class GhostBottleneck(nn.Module): + # Ghost Bottleneck https://github.com/huawei-noah/ghostnet + def __init__(self, c1, c2, k=3, s=1): # ch_in, ch_out, kernel, stride + super().__init__() + c_ = c2 // 2 + self.conv = nn.Sequential(GhostConv(c1, c_, 1, 1), # pw + DWConv(c_, c_, k, s, act=False) if s == 2 else nn.Identity(), # dw + GhostConv(c_, c2, 1, 1, act=False)) # pw-linear + self.shortcut = nn.Sequential(DWConv(c1, c1, k, s, act=False), + Conv(c1, c2, 1, 1, act=False)) if s == 2 else nn.Identity() + + def forward(self, x): + return self.conv(x) + self.shortcut(x) + + +class Contract(nn.Module): + # Contract width-height into channels, i.e. x(1,64,80,80) to x(1,256,40,40) + def __init__(self, gain=2): + super().__init__() + self.gain = gain + + def forward(self, x): + b, c, h, w = x.size() # assert (h / s == 0) and (W / s == 0), 'Indivisible gain' + s = self.gain + x = x.view(b, c, h // s, s, w // s, s) # x(1,64,40,2,40,2) + x = x.permute(0, 3, 5, 1, 2, 4).contiguous() # x(1,2,2,64,40,40) + return x.view(b, c * s * s, h // s, w // s) # x(1,256,40,40) + + +class Expand(nn.Module): + # Expand channels into width-height, i.e. x(1,64,80,80) to x(1,16,160,160) + def __init__(self, gain=2): + super().__init__() + self.gain = gain + + def forward(self, x): + b, c, h, w = x.size() # assert C / s ** 2 == 0, 'Indivisible gain' + s = self.gain + x = x.view(b, s, s, c // s ** 2, h, w) # x(1,2,2,16,80,80) + x = x.permute(0, 3, 4, 1, 5, 2).contiguous() # x(1,16,80,2,80,2) + return x.view(b, c // s ** 2, h * s, w * s) # x(1,16,160,160) + + +class Concat(nn.Module): + # Concatenate a list of tensors along dimension + def __init__(self, dimension=1): + super().__init__() + self.d = dimension + + def forward(self, x): + return torch.cat(x, self.d) + + +class DetectMultiBackend(nn.Module): + # YOLOv5 MultiBackend class for python inference on various backends + def __init__(self, weights='yolov5s.pt', device=None, dnn=False, data=None): + # Usage: + # PyTorch: weights = *.pt + # TorchScript: *.torchscript + # ONNX Runtime: *.onnx + # ONNX OpenCV DNN: *.onnx with --dnn + # OpenVINO: *.xml + # CoreML: *.mlmodel + # TensorRT: *.engine + # TensorFlow SavedModel: *_saved_model + # TensorFlow GraphDef: *.pb + # TensorFlow Lite: *.tflite + # TensorFlow Edge TPU: *_edgetpu.tflite + from models.experimental import attempt_download, attempt_load # scoped to avoid circular import + + super().__init__() + w = str(weights[0] if isinstance(weights, list) else weights) + pt, jit, onnx, xml, engine, coreml, saved_model, pb, tflite, edgetpu, tfjs = self.model_type(w) # get backend + stride, names = 64, [f'class{i}' for i in range(1000)] # assign defaults + w = attempt_download(w) # download if not local + if data: # data.yaml path (optional) + with open(data, errors='ignore') as f: + names = yaml.safe_load(f)['names'] # class names + + if pt: # PyTorch + model = attempt_load(weights if isinstance(weights, list) else w, map_location=device) + stride = max(int(model.stride.max()), 32) # model stride + names = model.module.names if hasattr(model, 'module') else model.names # get class names + self.model = model # explicitly assign for to(), cpu(), cuda(), half() + elif jit: # TorchScript + LOGGER.info(f'Loading {w} for TorchScript inference...') + extra_files = {'config.txt': ''} # model metadata + model = torch.jit.load(w, _extra_files=extra_files) + if extra_files['config.txt']: + d = json.loads(extra_files['config.txt']) # extra_files dict + stride, names = int(d['stride']), d['names'] + elif dnn: # ONNX OpenCV DNN + LOGGER.info(f'Loading {w} for ONNX OpenCV DNN inference...') + check_requirements(('opencv-python>=4.5.4',)) + net = cv2.dnn.readNetFromONNX(w) + elif onnx: # ONNX Runtime + LOGGER.info(f'Loading {w} for ONNX Runtime inference...') + cuda = torch.cuda.is_available() + check_requirements(('onnx', 'onnxruntime-gpu' if cuda else 'onnxruntime')) + import onnxruntime + providers = ['CUDAExecutionProvider', 'CPUExecutionProvider'] if cuda else ['CPUExecutionProvider'] + session = onnxruntime.InferenceSession(w, providers=providers) + elif xml: # OpenVINO + LOGGER.info(f'Loading {w} for OpenVINO inference...') + check_requirements(('openvino-dev',)) # requires openvino-dev: https://pypi.org/project/openvino-dev/ + import openvino.inference_engine as ie + core = ie.IECore() + if not Path(w).is_file(): # if not *.xml + w = next(Path(w).glob('*.xml')) # get *.xml file from *_openvino_model dir + network = core.read_network(model=w, weights=Path(w).with_suffix('.bin')) # *.xml, *.bin paths + executable_network = core.load_network(network, device_name='CPU', num_requests=1) + elif engine: # TensorRT + LOGGER.info(f'Loading {w} for TensorRT inference...') + import tensorrt as trt # https://developer.nvidia.com/nvidia-tensorrt-download + check_version(trt.__version__, '7.0.0', hard=True) # require tensorrt>=7.0.0 + Binding = namedtuple('Binding', ('name', 'dtype', 'shape', 'data', 'ptr')) + logger = trt.Logger(trt.Logger.INFO) + with open(w, 'rb') as f, trt.Runtime(logger) as runtime: + model = runtime.deserialize_cuda_engine(f.read()) + bindings = OrderedDict() + for index in range(model.num_bindings): + name = model.get_binding_name(index) + dtype = trt.nptype(model.get_binding_dtype(index)) + shape = tuple(model.get_binding_shape(index)) + data = torch.from_numpy(np.empty(shape, dtype=np.dtype(dtype))).to(device) + bindings[name] = Binding(name, dtype, shape, data, int(data.data_ptr())) + binding_addrs = OrderedDict((n, d.ptr) for n, d in bindings.items()) + context = model.create_execution_context() + batch_size = bindings['images'].shape[0] + elif coreml: # CoreML + LOGGER.info(f'Loading {w} for CoreML inference...') + import coremltools as ct + model = ct.models.MLModel(w) + else: # TensorFlow (SavedModel, GraphDef, Lite, Edge TPU) + if saved_model: # SavedModel + LOGGER.info(f'Loading {w} for TensorFlow SavedModel inference...') + import tensorflow as tf + keras = False # assume TF1 saved_model + model = tf.keras.models.load_model(w) if keras else tf.saved_model.load(w) + elif pb: # GraphDef https://www.tensorflow.org/guide/migrate#a_graphpb_or_graphpbtxt + LOGGER.info(f'Loading {w} for TensorFlow GraphDef inference...') + import tensorflow as tf + + def wrap_frozen_graph(gd, inputs, outputs): + x = tf.compat.v1.wrap_function(lambda: tf.compat.v1.import_graph_def(gd, name=""), []) # wrapped + ge = x.graph.as_graph_element + return x.prune(tf.nest.map_structure(ge, inputs), tf.nest.map_structure(ge, outputs)) + + gd = tf.Graph().as_graph_def() # graph_def + gd.ParseFromString(open(w, 'rb').read()) + frozen_func = wrap_frozen_graph(gd, inputs="x:0", outputs="Identity:0") + elif tflite or edgetpu: # https://www.tensorflow.org/lite/guide/python#install_tensorflow_lite_for_python + try: # https://coral.ai/docs/edgetpu/tflite-python/#update-existing-tf-lite-code-for-the-edge-tpu + from tflite_runtime.interpreter import Interpreter, load_delegate + except ImportError: + import tensorflow as tf + Interpreter, load_delegate = tf.lite.Interpreter, tf.lite.experimental.load_delegate, + if edgetpu: # Edge TPU https://coral.ai/software/#edgetpu-runtime + LOGGER.info(f'Loading {w} for TensorFlow Lite Edge TPU inference...') + delegate = {'Linux': 'libedgetpu.so.1', + 'Darwin': 'libedgetpu.1.dylib', + 'Windows': 'edgetpu.dll'}[platform.system()] + interpreter = Interpreter(model_path=w, experimental_delegates=[load_delegate(delegate)]) + else: # Lite + LOGGER.info(f'Loading {w} for TensorFlow Lite inference...') + interpreter = Interpreter(model_path=w) # load TFLite model + interpreter.allocate_tensors() # allocate + input_details = interpreter.get_input_details() # inputs + output_details = interpreter.get_output_details() # outputs + elif tfjs: + raise Exception('ERROR: YOLOv5 TF.js inference is not supported') + self.__dict__.update(locals()) # assign all variables to self + + def forward(self, im, augment=False, visualize=False, val=False): + # YOLOv5 MultiBackend inference + b, ch, h, w = im.shape # batch, channel, height, width + if self.pt or self.jit: # PyTorch + y = self.model(im) if self.jit else self.model(im, augment=augment, visualize=visualize) + return y if val else y[0] + elif self.dnn: # ONNX OpenCV DNN + im = im.cpu().numpy() # torch to numpy + self.net.setInput(im) + y = self.net.forward() + elif self.onnx: # ONNX Runtime + im = im.cpu().numpy() # torch to numpy + y = self.session.run([self.session.get_outputs()[0].name], {self.session.get_inputs()[0].name: im})[0] + elif self.xml: # OpenVINO + im = im.cpu().numpy() # FP32 + desc = self.ie.TensorDesc(precision='FP32', dims=im.shape, layout='NCHW') # Tensor Description + request = self.executable_network.requests[0] # inference request + request.set_blob(blob_name='images', blob=self.ie.Blob(desc, im)) # name=next(iter(request.input_blobs)) + request.infer() + y = request.output_blobs['output'].buffer # name=next(iter(request.output_blobs)) + elif self.engine: # TensorRT + assert im.shape == self.bindings['images'].shape, (im.shape, self.bindings['images'].shape) + self.binding_addrs['images'] = int(im.data_ptr()) + self.context.execute_v2(list(self.binding_addrs.values())) + y = self.bindings['output'].data + elif self.coreml: # CoreML + im = im.permute(0, 2, 3, 1).cpu().numpy() # torch BCHW to numpy BHWC shape(1,320,192,3) + im = Image.fromarray((im[0] * 255).astype('uint8')) + # im = im.resize((192, 320), Image.ANTIALIAS) + y = self.model.predict({'image': im}) # coordinates are xywh normalized + if 'confidence' in y: + box = xywh2xyxy(y['coordinates'] * [[w, h, w, h]]) # xyxy pixels + conf, cls = y['confidence'].max(1), y['confidence'].argmax(1).astype(np.float) + y = np.concatenate((box, conf.reshape(-1, 1), cls.reshape(-1, 1)), 1) + else: + k = 'var_' + str(sorted(int(k.replace('var_', '')) for k in y)[-1]) # output key + y = y[k] # output + else: # TensorFlow (SavedModel, GraphDef, Lite, Edge TPU) + im = im.permute(0, 2, 3, 1).cpu().numpy() # torch BCHW to numpy BHWC shape(1,320,192,3) + if self.saved_model: # SavedModel + y = (self.model(im, training=False) if self.keras else self.model(im)[0]).numpy() + elif self.pb: # GraphDef + y = self.frozen_func(x=self.tf.constant(im)).numpy() + else: # Lite or Edge TPU + input, output = self.input_details[0], self.output_details[0] + int8 = input['dtype'] == np.uint8 # is TFLite quantized uint8 model + if int8: + scale, zero_point = input['quantization'] + im = (im / scale + zero_point).astype(np.uint8) # de-scale + self.interpreter.set_tensor(input['index'], im) + self.interpreter.invoke() + y = self.interpreter.get_tensor(output['index']) + if int8: + scale, zero_point = output['quantization'] + y = (y.astype(np.float32) - zero_point) * scale # re-scale + y[..., :4] *= [w, h, w, h] # xywh normalized to pixels + + y = torch.tensor(y) if isinstance(y, np.ndarray) else y + return (y, []) if val else y + + def warmup(self, imgsz=(1, 3, 640, 640), half=False): + # Warmup model by running inference once + if self.pt or self.jit or self.onnx or self.engine: # warmup types + if isinstance(self.device, torch.device) and self.device.type != 'cpu': # only warmup GPU models + im = torch.zeros(*imgsz).to(self.device).type(torch.half if half else torch.float) # input image + self.forward(im) # warmup + + @staticmethod + def model_type(p='path/to/model.pt'): + # Return model type from model path, i.e. path='path/to/model.onnx' -> type=onnx + from export import export_formats + suffixes = list(export_formats().Suffix) + ['.xml'] # export suffixes + check_suffix(p, suffixes) # checks + p = Path(p).name # eliminate trailing separators + pt, jit, onnx, xml, engine, coreml, saved_model, pb, tflite, edgetpu, tfjs, xml2 = (s in p for s in suffixes) + xml |= xml2 # *_openvino_model or *.xml + tflite &= not edgetpu # *.tflite + return pt, jit, onnx, xml, engine, coreml, saved_model, pb, tflite, edgetpu, tfjs + + +class AutoShape(nn.Module): + # YOLOv5 input-robust model wrapper for passing cv2/np/PIL/torch inputs. Includes preprocessing, inference and NMS + conf = 0.25 # NMS confidence threshold + iou = 0.45 # NMS IoU threshold + agnostic = False # NMS class-agnostic + multi_label = False # NMS multiple labels per box + classes = None # (optional list) filter by class, i.e. = [0, 15, 16] for COCO persons, cats and dogs + max_det = 1000 # maximum number of detections per image + amp = False # Automatic Mixed Precision (AMP) inference + + def __init__(self, model): + super().__init__() + LOGGER.info('Adding AutoShape... ') + copy_attr(self, model, include=('yaml', 'nc', 'hyp', 'names', 'stride', 'abc'), exclude=()) # copy attributes + self.dmb = isinstance(model, DetectMultiBackend) # DetectMultiBackend() instance + self.pt = not self.dmb or model.pt # PyTorch model + self.model = model.eval() + + def _apply(self, fn): + # Apply to(), cpu(), cuda(), half() to model tensors that are not parameters or registered buffers + self = super()._apply(fn) + if self.pt: + m = self.model.model.model[-1] if self.dmb else self.model.model[-1] # Detect() + m.stride = fn(m.stride) + m.grid = list(map(fn, m.grid)) + if isinstance(m.anchor_grid, list): + m.anchor_grid = list(map(fn, m.anchor_grid)) + return self + + @torch.no_grad() + def forward(self, imgs, size=640, augment=False, profile=False): + # Inference from various sources. For height=640, width=1280, RGB images example inputs are: + # file: imgs = 'data/images/zidane.jpg' # str or PosixPath + # URI: = 'https://ultralytics.com/images/zidane.jpg' + # OpenCV: = cv2.imread('image.jpg')[:,:,::-1] # HWC BGR to RGB x(640,1280,3) + # PIL: = Image.open('image.jpg') or ImageGrab.grab() # HWC x(640,1280,3) + # numpy: = np.zeros((640,1280,3)) # HWC + # torch: = torch.zeros(16,3,320,640) # BCHW (scaled to size=640, 0-1 values) + # multiple: = [Image.open('image1.jpg'), Image.open('image2.jpg'), ...] # list of images + + t = [time_sync()] + p = next(self.model.parameters()) if self.pt else torch.zeros(1) # for device and type + autocast = self.amp and (p.device.type != 'cpu') # Automatic Mixed Precision (AMP) inference + if isinstance(imgs, torch.Tensor): # torch + with amp.autocast(enabled=autocast): + return self.model(imgs.to(p.device).type_as(p), augment, profile) # inference + + # Pre-process + n, imgs = (len(imgs), imgs) if isinstance(imgs, list) else (1, [imgs]) # number of images, list of images + shape0, shape1, files = [], [], [] # image and inference shapes, filenames + for i, im in enumerate(imgs): + f = f'image{i}' # filename + if isinstance(im, (str, Path)): # filename or uri + im, f = Image.open(requests.get(im, stream=True).raw if str(im).startswith('http') else im), im + im = np.asarray(exif_transpose(im)) + elif isinstance(im, Image.Image): # PIL Image + im, f = np.asarray(exif_transpose(im)), getattr(im, 'filename', f) or f + files.append(Path(f).with_suffix('.jpg').name) + if im.shape[0] < 5: # image in CHW + im = im.transpose((1, 2, 0)) # reverse dataloader .transpose(2, 0, 1) + im = im[..., :3] if im.ndim == 3 else np.tile(im[..., None], 3) # enforce 3ch input + s = im.shape[:2] # HWC + shape0.append(s) # image shape + g = (size / max(s)) # gain + shape1.append([y * g for y in s]) + imgs[i] = im if im.data.contiguous else np.ascontiguousarray(im) # update + shape1 = [make_divisible(x, self.stride) for x in np.stack(shape1, 0).max(0)] # inference shape + x = [letterbox(im, new_shape=shape1 if self.pt else size, auto=False)[0] for im in imgs] # pad + x = np.stack(x, 0) if n > 1 else x[0][None] # stack + x = np.ascontiguousarray(x.transpose((0, 3, 1, 2))) # BHWC to BCHW + x = torch.from_numpy(x).to(p.device).type_as(p) / 255 # uint8 to fp16/32 + t.append(time_sync()) + + with amp.autocast(enabled=autocast): + # Inference + y = self.model(x, augment, profile) # forward + t.append(time_sync()) + + # Post-process + y = non_max_suppression(y if self.dmb else y[0], self.conf, iou_thres=self.iou, classes=self.classes, + agnostic=self.agnostic, multi_label=self.multi_label, max_det=self.max_det) # NMS + for i in range(n): + scale_coords(shape1, y[i][:, :4], shape0[i]) + + t.append(time_sync()) + return Detections(imgs, y, files, t, self.names, x.shape) + + +class Detections: + # YOLOv5 detections class for inference results + def __init__(self, imgs, pred, files, times=(0, 0, 0, 0), names=None, shape=None): + super().__init__() + d = pred[0].device # device + gn = [torch.tensor([*(im.shape[i] for i in [1, 0, 1, 0]), 1, 1], device=d) for im in imgs] # normalizations + self.imgs = imgs # list of images as numpy arrays + self.pred = pred # list of tensors pred[0] = (xyxy, conf, cls) + self.names = names # class names + self.files = files # image filenames + self.times = times # profiling times + self.xyxy = pred # xyxy pixels + self.xywh = [xyxy2xywh(x) for x in pred] # xywh pixels + self.xyxyn = [x / g for x, g in zip(self.xyxy, gn)] # xyxy normalized + self.xywhn = [x / g for x, g in zip(self.xywh, gn)] # xywh normalized + self.n = len(self.pred) # number of images (batch size) + self.t = tuple((times[i + 1] - times[i]) * 1000 / self.n for i in range(3)) # timestamps (ms) + self.s = shape # inference BCHW shape + + def display(self, pprint=False, show=False, save=False, crop=False, render=False, save_dir=Path('')): + crops = [] + for i, (im, pred) in enumerate(zip(self.imgs, self.pred)): + s = f'image {i + 1}/{len(self.pred)}: {im.shape[0]}x{im.shape[1]} ' # string + if pred.shape[0]: + for c in pred[:, -1].unique(): + n = (pred[:, -1] == c).sum() # detections per class + s += f"{n} {self.names[int(c)]}{'s' * (n > 1)}, " # add to string + if show or save or render or crop: + annotator = Annotator(im, example=str(self.names)) + for *box, conf, cls in reversed(pred): # xyxy, confidence, class + label = f'{self.names[int(cls)]} {conf:.2f}' + if crop: + file = save_dir / 'crops' / self.names[int(cls)] / self.files[i] if save else None + crops.append({'box': box, 'conf': conf, 'cls': cls, 'label': label, + 'im': save_one_box(box, im, file=file, save=save)}) + else: # all others + annotator.box_label(box, label, color=colors(cls)) + im = annotator.im + else: + s += '(no detections)' + + im = Image.fromarray(im.astype(np.uint8)) if isinstance(im, np.ndarray) else im # from np + if pprint: + LOGGER.info(s.rstrip(', ')) + if show: + im.show(self.files[i]) # show + if save: + f = self.files[i] + im.save(save_dir / f) # save + if i == self.n - 1: + LOGGER.info(f"Saved {self.n} image{'s' * (self.n > 1)} to {colorstr('bold', save_dir)}") + if render: + self.imgs[i] = np.asarray(im) + if crop: + if save: + LOGGER.info(f'Saved results to {save_dir}\n') + return crops + + def print(self): + self.display(pprint=True) # print results + LOGGER.info(f'Speed: %.1fms pre-process, %.1fms inference, %.1fms NMS per image at shape {tuple(self.s)}' % + self.t) + + def show(self): + self.display(show=True) # show results + + def save(self, save_dir='runs/detect/exp'): + save_dir = increment_path(save_dir, exist_ok=save_dir != 'runs/detect/exp', mkdir=True) # increment save_dir + self.display(save=True, save_dir=save_dir) # save results + + def crop(self, save=True, save_dir='runs/detect/exp'): + save_dir = increment_path(save_dir, exist_ok=save_dir != 'runs/detect/exp', mkdir=True) if save else None + return self.display(crop=True, save=save, save_dir=save_dir) # crop results + + def render(self): + self.display(render=True) # render results + return self.imgs + + def pandas(self): + # return detections as pandas DataFrames, i.e. print(results.pandas().xyxy[0]) + new = copy(self) # return copy + ca = 'xmin', 'ymin', 'xmax', 'ymax', 'confidence', 'class', 'name' # xyxy columns + cb = 'xcenter', 'ycenter', 'width', 'height', 'confidence', 'class', 'name' # xywh columns + for k, c in zip(['xyxy', 'xyxyn', 'xywh', 'xywhn'], [ca, ca, cb, cb]): + a = [[x[:5] + [int(x[5]), self.names[int(x[5])]] for x in x.tolist()] for x in getattr(self, k)] # update + setattr(new, k, [pd.DataFrame(x, columns=c) for x in a]) + return new + + def tolist(self): + # return a list of Detections objects, i.e. 'for result in results.tolist():' + r = range(self.n) # iterable + x = [Detections([self.imgs[i]], [self.pred[i]], [self.files[i]], self.times, self.names, self.s) for i in r] + # for d in x: + # for k in ['imgs', 'pred', 'xyxy', 'xyxyn', 'xywh', 'xywhn']: + # setattr(d, k, getattr(d, k)[0]) # pop out of list + return x + + def __len__(self): + return self.n + + +class Classify(nn.Module): + # Classification head, i.e. x(b,c1,20,20) to x(b,c2) + def __init__(self, c1, c2, k=1, s=1, p=None, g=1): # ch_in, ch_out, kernel, stride, padding, groups + super().__init__() + self.aap = nn.AdaptiveAvgPool2d(1) # to x(b,c1,1,1) + self.conv = nn.Conv2d(c1, c2, k, s, autopad(k, p), groups=g) # to x(b,c2,1,1) + self.flat = nn.Flatten() + + def forward(self, x): + z = torch.cat([self.aap(y) for y in (x if isinstance(x, list) else [x])], 1) # cat if list + return self.flat(self.conv(z)) # flatten to x(b,c2) diff --git a/yolov5_Monocular_social_ranging/models/experimental.py b/yolov5_Monocular_social_ranging/models/experimental.py new file mode 100644 index 0000000..463e551 --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/experimental.py @@ -0,0 +1,120 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +Experimental modules +""" +import math + +import numpy as np +import torch +import torch.nn as nn + +from models.common import Conv +from utils.downloads import attempt_download + + +class CrossConv(nn.Module): + # Cross Convolution Downsample + def __init__(self, c1, c2, k=3, s=1, g=1, e=1.0, shortcut=False): + # ch_in, ch_out, kernel, stride, groups, expansion, shortcut + super().__init__() + c_ = int(c2 * e) # hidden channels + self.cv1 = Conv(c1, c_, (1, k), (1, s)) + self.cv2 = Conv(c_, c2, (k, 1), (s, 1), g=g) + self.add = shortcut and c1 == c2 + + def forward(self, x): + return x + self.cv2(self.cv1(x)) if self.add else self.cv2(self.cv1(x)) + + +class Sum(nn.Module): + # Weighted sum of 2 or more layers https://arxiv.org/abs/1911.09070 + def __init__(self, n, weight=False): # n: number of inputs + super().__init__() + self.weight = weight # apply weights boolean + self.iter = range(n - 1) # iter object + if weight: + self.w = nn.Parameter(-torch.arange(1.0, n) / 2, requires_grad=True) # layer weights + + def forward(self, x): + y = x[0] # no weight + if self.weight: + w = torch.sigmoid(self.w) * 2 + for i in self.iter: + y = y + x[i + 1] * w[i] + else: + for i in self.iter: + y = y + x[i + 1] + return y + + +class MixConv2d(nn.Module): + # Mixed Depth-wise Conv https://arxiv.org/abs/1907.09595 + def __init__(self, c1, c2, k=(1, 3), s=1, equal_ch=True): # ch_in, ch_out, kernel, stride, ch_strategy + super().__init__() + n = len(k) # number of convolutions + if equal_ch: # equal c_ per group + i = torch.linspace(0, n - 1E-6, c2).floor() # c2 indices + c_ = [(i == g).sum() for g in range(n)] # intermediate channels + else: # equal weight.numel() per group + b = [c2] + [0] * n + a = np.eye(n + 1, n, k=-1) + a -= np.roll(a, 1, axis=1) + a *= np.array(k) ** 2 + a[0] = 1 + c_ = np.linalg.lstsq(a, b, rcond=None)[0].round() # solve for equal weight indices, ax = b + + self.m = nn.ModuleList( + [nn.Conv2d(c1, int(c_), k, s, k // 2, groups=math.gcd(c1, int(c_)), bias=False) for k, c_ in zip(k, c_)]) + self.bn = nn.BatchNorm2d(c2) + self.act = nn.SiLU() + + def forward(self, x): + return self.act(self.bn(torch.cat([m(x) for m in self.m], 1))) + + +class Ensemble(nn.ModuleList): + # Ensemble of models + def __init__(self): + super().__init__() + + def forward(self, x, augment=False, profile=False, visualize=False): + y = [] + for module in self: + y.append(module(x, augment, profile, visualize)[0]) + # y = torch.stack(y).max(0)[0] # max ensemble + # y = torch.stack(y).mean(0) # mean ensemble + y = torch.cat(y, 1) # nms ensemble + return y, None # inference, train output + + +def attempt_load(weights, map_location=None, inplace=True, fuse=True): + from models.yolo import Detect, Model + + # Loads an ensemble of models weights=[a,b,c] or a single model weights=[a] or weights=a + model = Ensemble() + for w in weights if isinstance(weights, list) else [weights]: + ckpt = torch.load(attempt_download(w), map_location=map_location) # load + if fuse: + model.append(ckpt['ema' if ckpt.get('ema') else 'model'].float().fuse().eval()) # FP32 model + else: + model.append(ckpt['ema' if ckpt.get('ema') else 'model'].float().eval()) # without layer fuse + + # Compatibility updates + for m in model.modules(): + if type(m) in [nn.Hardswish, nn.LeakyReLU, nn.ReLU, nn.ReLU6, nn.SiLU, Detect, Model]: + m.inplace = inplace # pytorch 1.7.0 compatibility + if type(m) is Detect: + if not isinstance(m.anchor_grid, list): # new Detect Layer compatibility + delattr(m, 'anchor_grid') + setattr(m, 'anchor_grid', [torch.zeros(1)] * m.nl) + elif type(m) is Conv: + m._non_persistent_buffers_set = set() # pytorch 1.6.0 compatibility + + if len(model) == 1: + return model[-1] # return model + else: + print(f'Ensemble created with {weights}\n') + for k in ['names']: + setattr(model, k, getattr(model[-1], k)) + model.stride = model[torch.argmax(torch.tensor([m.stride.max() for m in model])).int()].stride # max stride + return model # return ensemble diff --git a/yolov5_Monocular_social_ranging/models/hub/anchors.yaml b/yolov5_Monocular_social_ranging/models/hub/anchors.yaml new file mode 100644 index 0000000..e4d7beb --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/hub/anchors.yaml @@ -0,0 +1,59 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +# Default anchors for COCO data + + +# P5 ------------------------------------------------------------------------------------------------------------------- +# P5-640: +anchors_p5_640: + - [10,13, 16,30, 33,23] # P3/8 + - [30,61, 62,45, 59,119] # P4/16 + - [116,90, 156,198, 373,326] # P5/32 + + +# P6 ------------------------------------------------------------------------------------------------------------------- +# P6-640: thr=0.25: 0.9964 BPR, 5.54 anchors past thr, n=12, img_size=640, metric_all=0.281/0.716-mean/best, past_thr=0.469-mean: 9,11, 21,19, 17,41, 43,32, 39,70, 86,64, 65,131, 134,130, 120,265, 282,180, 247,354, 512,387 +anchors_p6_640: + - [9,11, 21,19, 17,41] # P3/8 + - [43,32, 39,70, 86,64] # P4/16 + - [65,131, 134,130, 120,265] # P5/32 + - [282,180, 247,354, 512,387] # P6/64 + +# P6-1280: thr=0.25: 0.9950 BPR, 5.55 anchors past thr, n=12, img_size=1280, metric_all=0.281/0.714-mean/best, past_thr=0.468-mean: 19,27, 44,40, 38,94, 96,68, 86,152, 180,137, 140,301, 303,264, 238,542, 436,615, 739,380, 925,792 +anchors_p6_1280: + - [19,27, 44,40, 38,94] # P3/8 + - [96,68, 86,152, 180,137] # P4/16 + - [140,301, 303,264, 238,542] # P5/32 + - [436,615, 739,380, 925,792] # P6/64 + +# P6-1920: thr=0.25: 0.9950 BPR, 5.55 anchors past thr, n=12, img_size=1920, metric_all=0.281/0.714-mean/best, past_thr=0.468-mean: 28,41, 67,59, 57,141, 144,103, 129,227, 270,205, 209,452, 455,396, 358,812, 653,922, 1109,570, 1387,1187 +anchors_p6_1920: + - [28,41, 67,59, 57,141] # P3/8 + - [144,103, 129,227, 270,205] # P4/16 + - [209,452, 455,396, 358,812] # P5/32 + - [653,922, 1109,570, 1387,1187] # P6/64 + + +# P7 ------------------------------------------------------------------------------------------------------------------- +# P7-640: thr=0.25: 0.9962 BPR, 6.76 anchors past thr, n=15, img_size=640, metric_all=0.275/0.733-mean/best, past_thr=0.466-mean: 11,11, 13,30, 29,20, 30,46, 61,38, 39,92, 78,80, 146,66, 79,163, 149,150, 321,143, 157,303, 257,402, 359,290, 524,372 +anchors_p7_640: + - [11,11, 13,30, 29,20] # P3/8 + - [30,46, 61,38, 39,92] # P4/16 + - [78,80, 146,66, 79,163] # P5/32 + - [149,150, 321,143, 157,303] # P6/64 + - [257,402, 359,290, 524,372] # P7/128 + +# P7-1280: thr=0.25: 0.9968 BPR, 6.71 anchors past thr, n=15, img_size=1280, metric_all=0.273/0.732-mean/best, past_thr=0.463-mean: 19,22, 54,36, 32,77, 70,83, 138,71, 75,173, 165,159, 148,334, 375,151, 334,317, 251,626, 499,474, 750,326, 534,814, 1079,818 +anchors_p7_1280: + - [19,22, 54,36, 32,77] # P3/8 + - [70,83, 138,71, 75,173] # P4/16 + - [165,159, 148,334, 375,151] # P5/32 + - [334,317, 251,626, 499,474] # P6/64 + - [750,326, 534,814, 1079,818] # P7/128 + +# P7-1920: thr=0.25: 0.9968 BPR, 6.71 anchors past thr, n=15, img_size=1920, metric_all=0.273/0.732-mean/best, past_thr=0.463-mean: 29,34, 81,55, 47,115, 105,124, 207,107, 113,259, 247,238, 222,500, 563,227, 501,476, 376,939, 749,711, 1126,489, 801,1222, 1618,1227 +anchors_p7_1920: + - [29,34, 81,55, 47,115] # P3/8 + - [105,124, 207,107, 113,259] # P4/16 + - [247,238, 222,500, 563,227] # P5/32 + - [501,476, 376,939, 749,711] # P6/64 + - [1126,489, 801,1222, 1618,1227] # P7/128 diff --git a/yolov5_Monocular_social_ranging/models/hub/yolov3-spp.yaml b/yolov5_Monocular_social_ranging/models/hub/yolov3-spp.yaml new file mode 100644 index 0000000..c669821 --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/hub/yolov3-spp.yaml @@ -0,0 +1,51 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 1.0 # model depth multiple +width_multiple: 1.0 # layer channel multiple +anchors: + - [10,13, 16,30, 33,23] # P3/8 + - [30,61, 62,45, 59,119] # P4/16 + - [116,90, 156,198, 373,326] # P5/32 + +# darknet53 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [32, 3, 1]], # 0 + [-1, 1, Conv, [64, 3, 2]], # 1-P1/2 + [-1, 1, Bottleneck, [64]], + [-1, 1, Conv, [128, 3, 2]], # 3-P2/4 + [-1, 2, Bottleneck, [128]], + [-1, 1, Conv, [256, 3, 2]], # 5-P3/8 + [-1, 8, Bottleneck, [256]], + [-1, 1, Conv, [512, 3, 2]], # 7-P4/16 + [-1, 8, Bottleneck, [512]], + [-1, 1, Conv, [1024, 3, 2]], # 9-P5/32 + [-1, 4, Bottleneck, [1024]], # 10 + ] + +# YOLOv3-SPP head +head: + [[-1, 1, Bottleneck, [1024, False]], + [-1, 1, SPP, [512, [5, 9, 13]]], + [-1, 1, Conv, [1024, 3, 1]], + [-1, 1, Conv, [512, 1, 1]], + [-1, 1, Conv, [1024, 3, 1]], # 15 (P5/32-large) + + [-2, 1, Conv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 8], 1, Concat, [1]], # cat backbone P4 + [-1, 1, Bottleneck, [512, False]], + [-1, 1, Bottleneck, [512, False]], + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, Conv, [512, 3, 1]], # 22 (P4/16-medium) + + [-2, 1, Conv, [128, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P3 + [-1, 1, Bottleneck, [256, False]], + [-1, 2, Bottleneck, [256, False]], # 27 (P3/8-small) + + [[27, 22, 15], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5) + ] diff --git a/yolov5_Monocular_social_ranging/models/hub/yolov3-tiny.yaml b/yolov5_Monocular_social_ranging/models/hub/yolov3-tiny.yaml new file mode 100644 index 0000000..b28b443 --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/hub/yolov3-tiny.yaml @@ -0,0 +1,41 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 1.0 # model depth multiple +width_multiple: 1.0 # layer channel multiple +anchors: + - [10,14, 23,27, 37,58] # P4/16 + - [81,82, 135,169, 344,319] # P5/32 + +# YOLOv3-tiny backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [16, 3, 1]], # 0 + [-1, 1, nn.MaxPool2d, [2, 2, 0]], # 1-P1/2 + [-1, 1, Conv, [32, 3, 1]], + [-1, 1, nn.MaxPool2d, [2, 2, 0]], # 3-P2/4 + [-1, 1, Conv, [64, 3, 1]], + [-1, 1, nn.MaxPool2d, [2, 2, 0]], # 5-P3/8 + [-1, 1, Conv, [128, 3, 1]], + [-1, 1, nn.MaxPool2d, [2, 2, 0]], # 7-P4/16 + [-1, 1, Conv, [256, 3, 1]], + [-1, 1, nn.MaxPool2d, [2, 2, 0]], # 9-P5/32 + [-1, 1, Conv, [512, 3, 1]], + [-1, 1, nn.ZeroPad2d, [[0, 1, 0, 1]]], # 11 + [-1, 1, nn.MaxPool2d, [2, 1, 0]], # 12 + ] + +# YOLOv3-tiny head +head: + [[-1, 1, Conv, [1024, 3, 1]], + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, Conv, [512, 3, 1]], # 15 (P5/32-large) + + [-2, 1, Conv, [128, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 8], 1, Concat, [1]], # cat backbone P4 + [-1, 1, Conv, [256, 3, 1]], # 19 (P4/16-medium) + + [[19, 15], 1, Detect, [nc, anchors]], # Detect(P4, P5) + ] diff --git a/yolov5_Monocular_social_ranging/models/hub/yolov3.yaml b/yolov5_Monocular_social_ranging/models/hub/yolov3.yaml new file mode 100644 index 0000000..d1ef912 --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/hub/yolov3.yaml @@ -0,0 +1,51 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 1.0 # model depth multiple +width_multiple: 1.0 # layer channel multiple +anchors: + - [10,13, 16,30, 33,23] # P3/8 + - [30,61, 62,45, 59,119] # P4/16 + - [116,90, 156,198, 373,326] # P5/32 + +# darknet53 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [32, 3, 1]], # 0 + [-1, 1, Conv, [64, 3, 2]], # 1-P1/2 + [-1, 1, Bottleneck, [64]], + [-1, 1, Conv, [128, 3, 2]], # 3-P2/4 + [-1, 2, Bottleneck, [128]], + [-1, 1, Conv, [256, 3, 2]], # 5-P3/8 + [-1, 8, Bottleneck, [256]], + [-1, 1, Conv, [512, 3, 2]], # 7-P4/16 + [-1, 8, Bottleneck, [512]], + [-1, 1, Conv, [1024, 3, 2]], # 9-P5/32 + [-1, 4, Bottleneck, [1024]], # 10 + ] + +# YOLOv3 head +head: + [[-1, 1, Bottleneck, [1024, False]], + [-1, 1, Conv, [512, 1, 1]], + [-1, 1, Conv, [1024, 3, 1]], + [-1, 1, Conv, [512, 1, 1]], + [-1, 1, Conv, [1024, 3, 1]], # 15 (P5/32-large) + + [-2, 1, Conv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 8], 1, Concat, [1]], # cat backbone P4 + [-1, 1, Bottleneck, [512, False]], + [-1, 1, Bottleneck, [512, False]], + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, Conv, [512, 3, 1]], # 22 (P4/16-medium) + + [-2, 1, Conv, [128, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P3 + [-1, 1, Bottleneck, [256, False]], + [-1, 2, Bottleneck, [256, False]], # 27 (P3/8-small) + + [[27, 22, 15], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5) + ] diff --git a/yolov5_Monocular_social_ranging/models/hub/yolov5-bifpn.yaml b/yolov5_Monocular_social_ranging/models/hub/yolov5-bifpn.yaml new file mode 100644 index 0000000..504815f --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/hub/yolov5-bifpn.yaml @@ -0,0 +1,48 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 1.0 # model depth multiple +width_multiple: 1.0 # layer channel multiple +anchors: + - [10,13, 16,30, 33,23] # P3/8 + - [30,61, 62,45, 59,119] # P4/16 + - [116,90, 156,198, 373,326] # P5/32 + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [64, 6, 2, 2]], # 0-P1/2 + [-1, 1, Conv, [128, 3, 2]], # 1-P2/4 + [-1, 3, C3, [128]], + [-1, 1, Conv, [256, 3, 2]], # 3-P3/8 + [-1, 6, C3, [256]], + [-1, 1, Conv, [512, 3, 2]], # 5-P4/16 + [-1, 9, C3, [512]], + [-1, 1, Conv, [1024, 3, 2]], # 7-P5/32 + [-1, 3, C3, [1024]], + [-1, 1, SPPF, [1024, 5]], # 9 + ] + +# YOLOv5 v6.0 BiFPN head +head: + [[-1, 1, Conv, [512, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P4 + [-1, 3, C3, [512, False]], # 13 + + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 4], 1, Concat, [1]], # cat backbone P3 + [-1, 3, C3, [256, False]], # 17 (P3/8-small) + + [-1, 1, Conv, [256, 3, 2]], + [[-1, 14, 6], 1, Concat, [1]], # cat P4 <--- BiFPN change + [-1, 3, C3, [512, False]], # 20 (P4/16-medium) + + [-1, 1, Conv, [512, 3, 2]], + [[-1, 10], 1, Concat, [1]], # cat head P5 + [-1, 3, C3, [1024, False]], # 23 (P5/32-large) + + [[17, 20, 23], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5) + ] diff --git a/yolov5_Monocular_social_ranging/models/hub/yolov5-fpn.yaml b/yolov5_Monocular_social_ranging/models/hub/yolov5-fpn.yaml new file mode 100644 index 0000000..a23e9c6 --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/hub/yolov5-fpn.yaml @@ -0,0 +1,42 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 1.0 # model depth multiple +width_multiple: 1.0 # layer channel multiple +anchors: + - [10,13, 16,30, 33,23] # P3/8 + - [30,61, 62,45, 59,119] # P4/16 + - [116,90, 156,198, 373,326] # P5/32 + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [64, 6, 2, 2]], # 0-P1/2 + [-1, 1, Conv, [128, 3, 2]], # 1-P2/4 + [-1, 3, C3, [128]], + [-1, 1, Conv, [256, 3, 2]], # 3-P3/8 + [-1, 6, C3, [256]], + [-1, 1, Conv, [512, 3, 2]], # 5-P4/16 + [-1, 9, C3, [512]], + [-1, 1, Conv, [1024, 3, 2]], # 7-P5/32 + [-1, 3, C3, [1024]], + [-1, 1, SPPF, [1024, 5]], # 9 + ] + +# YOLOv5 v6.0 FPN head +head: + [[-1, 3, C3, [1024, False]], # 10 (P5/32-large) + + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P4 + [-1, 1, Conv, [512, 1, 1]], + [-1, 3, C3, [512, False]], # 14 (P4/16-medium) + + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 4], 1, Concat, [1]], # cat backbone P3 + [-1, 1, Conv, [256, 1, 1]], + [-1, 3, C3, [256, False]], # 18 (P3/8-small) + + [[18, 14, 10], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5) + ] diff --git a/yolov5_Monocular_social_ranging/models/hub/yolov5-p2.yaml b/yolov5_Monocular_social_ranging/models/hub/yolov5-p2.yaml new file mode 100644 index 0000000..554117d --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/hub/yolov5-p2.yaml @@ -0,0 +1,54 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 1.0 # model depth multiple +width_multiple: 1.0 # layer channel multiple +anchors: 3 # AutoAnchor evolves 3 anchors per P output layer + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [64, 6, 2, 2]], # 0-P1/2 + [-1, 1, Conv, [128, 3, 2]], # 1-P2/4 + [-1, 3, C3, [128]], + [-1, 1, Conv, [256, 3, 2]], # 3-P3/8 + [-1, 6, C3, [256]], + [-1, 1, Conv, [512, 3, 2]], # 5-P4/16 + [-1, 9, C3, [512]], + [-1, 1, Conv, [1024, 3, 2]], # 7-P5/32 + [-1, 3, C3, [1024]], + [-1, 1, SPPF, [1024, 5]], # 9 + ] + +# YOLOv5 v6.0 head with (P2, P3, P4, P5) outputs +head: + [[-1, 1, Conv, [512, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P4 + [-1, 3, C3, [512, False]], # 13 + + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 4], 1, Concat, [1]], # cat backbone P3 + [-1, 3, C3, [256, False]], # 17 (P3/8-small) + + [-1, 1, Conv, [128, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 2], 1, Concat, [1]], # cat backbone P2 + [-1, 1, C3, [128, False]], # 21 (P2/4-xsmall) + + [-1, 1, Conv, [128, 3, 2]], + [[-1, 18], 1, Concat, [1]], # cat head P3 + [-1, 3, C3, [256, False]], # 24 (P3/8-small) + + [-1, 1, Conv, [256, 3, 2]], + [[-1, 14], 1, Concat, [1]], # cat head P4 + [-1, 3, C3, [512, False]], # 27 (P4/16-medium) + + [-1, 1, Conv, [512, 3, 2]], + [[-1, 10], 1, Concat, [1]], # cat head P5 + [-1, 3, C3, [1024, False]], # 30 (P5/32-large) + + [[21, 24, 27, 30], 1, Detect, [nc, anchors]], # Detect(P2, P3, P4, P5) + ] diff --git a/yolov5_Monocular_social_ranging/models/hub/yolov5-p34.yaml b/yolov5_Monocular_social_ranging/models/hub/yolov5-p34.yaml new file mode 100644 index 0000000..dbf0f85 --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/hub/yolov5-p34.yaml @@ -0,0 +1,41 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 0.33 # model depth multiple +width_multiple: 0.50 # layer channel multiple +anchors: 3 # AutoAnchor evolves 3 anchors per P output layer + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [ [ -1, 1, Conv, [ 64, 6, 2, 2 ] ], # 0-P1/2 + [ -1, 1, Conv, [ 128, 3, 2 ] ], # 1-P2/4 + [ -1, 3, C3, [ 128 ] ], + [ -1, 1, Conv, [ 256, 3, 2 ] ], # 3-P3/8 + [ -1, 6, C3, [ 256 ] ], + [ -1, 1, Conv, [ 512, 3, 2 ] ], # 5-P4/16 + [ -1, 9, C3, [ 512 ] ], + [ -1, 1, Conv, [ 1024, 3, 2 ] ], # 7-P5/32 + [ -1, 3, C3, [ 1024 ] ], + [ -1, 1, SPPF, [ 1024, 5 ] ], # 9 + ] + +# YOLOv5 v6.0 head with (P3, P4) outputs +head: + [ [ -1, 1, Conv, [ 512, 1, 1 ] ], + [ -1, 1, nn.Upsample, [ None, 2, 'nearest' ] ], + [ [ -1, 6 ], 1, Concat, [ 1 ] ], # cat backbone P4 + [ -1, 3, C3, [ 512, False ] ], # 13 + + [ -1, 1, Conv, [ 256, 1, 1 ] ], + [ -1, 1, nn.Upsample, [ None, 2, 'nearest' ] ], + [ [ -1, 4 ], 1, Concat, [ 1 ] ], # cat backbone P3 + [ -1, 3, C3, [ 256, False ] ], # 17 (P3/8-small) + + [ -1, 1, Conv, [ 256, 3, 2 ] ], + [ [ -1, 14 ], 1, Concat, [ 1 ] ], # cat head P4 + [ -1, 3, C3, [ 512, False ] ], # 20 (P4/16-medium) + + [ [ 17, 20 ], 1, Detect, [ nc, anchors ] ], # Detect(P3, P4) + ] diff --git a/yolov5_Monocular_social_ranging/models/hub/yolov5-p6.yaml b/yolov5_Monocular_social_ranging/models/hub/yolov5-p6.yaml new file mode 100644 index 0000000..a17202f --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/hub/yolov5-p6.yaml @@ -0,0 +1,56 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 1.0 # model depth multiple +width_multiple: 1.0 # layer channel multiple +anchors: 3 # AutoAnchor evolves 3 anchors per P output layer + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [64, 6, 2, 2]], # 0-P1/2 + [-1, 1, Conv, [128, 3, 2]], # 1-P2/4 + [-1, 3, C3, [128]], + [-1, 1, Conv, [256, 3, 2]], # 3-P3/8 + [-1, 6, C3, [256]], + [-1, 1, Conv, [512, 3, 2]], # 5-P4/16 + [-1, 9, C3, [512]], + [-1, 1, Conv, [768, 3, 2]], # 7-P5/32 + [-1, 3, C3, [768]], + [-1, 1, Conv, [1024, 3, 2]], # 9-P6/64 + [-1, 3, C3, [1024]], + [-1, 1, SPPF, [1024, 5]], # 11 + ] + +# YOLOv5 v6.0 head with (P3, P4, P5, P6) outputs +head: + [[-1, 1, Conv, [768, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 8], 1, Concat, [1]], # cat backbone P5 + [-1, 3, C3, [768, False]], # 15 + + [-1, 1, Conv, [512, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P4 + [-1, 3, C3, [512, False]], # 19 + + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 4], 1, Concat, [1]], # cat backbone P3 + [-1, 3, C3, [256, False]], # 23 (P3/8-small) + + [-1, 1, Conv, [256, 3, 2]], + [[-1, 20], 1, Concat, [1]], # cat head P4 + [-1, 3, C3, [512, False]], # 26 (P4/16-medium) + + [-1, 1, Conv, [512, 3, 2]], + [[-1, 16], 1, Concat, [1]], # cat head P5 + [-1, 3, C3, [768, False]], # 29 (P5/32-large) + + [-1, 1, Conv, [768, 3, 2]], + [[-1, 12], 1, Concat, [1]], # cat head P6 + [-1, 3, C3, [1024, False]], # 32 (P6/64-xlarge) + + [[23, 26, 29, 32], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5, P6) + ] diff --git a/yolov5_Monocular_social_ranging/models/hub/yolov5-p7.yaml b/yolov5_Monocular_social_ranging/models/hub/yolov5-p7.yaml new file mode 100644 index 0000000..edd7d13 --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/hub/yolov5-p7.yaml @@ -0,0 +1,67 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 1.0 # model depth multiple +width_multiple: 1.0 # layer channel multiple +anchors: 3 # AutoAnchor evolves 3 anchors per P output layer + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [64, 6, 2, 2]], # 0-P1/2 + [-1, 1, Conv, [128, 3, 2]], # 1-P2/4 + [-1, 3, C3, [128]], + [-1, 1, Conv, [256, 3, 2]], # 3-P3/8 + [-1, 6, C3, [256]], + [-1, 1, Conv, [512, 3, 2]], # 5-P4/16 + [-1, 9, C3, [512]], + [-1, 1, Conv, [768, 3, 2]], # 7-P5/32 + [-1, 3, C3, [768]], + [-1, 1, Conv, [1024, 3, 2]], # 9-P6/64 + [-1, 3, C3, [1024]], + [-1, 1, Conv, [1280, 3, 2]], # 11-P7/128 + [-1, 3, C3, [1280]], + [-1, 1, SPPF, [1280, 5]], # 13 + ] + +# YOLOv5 v6.0 head with (P3, P4, P5, P6, P7) outputs +head: + [[-1, 1, Conv, [1024, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 10], 1, Concat, [1]], # cat backbone P6 + [-1, 3, C3, [1024, False]], # 17 + + [-1, 1, Conv, [768, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 8], 1, Concat, [1]], # cat backbone P5 + [-1, 3, C3, [768, False]], # 21 + + [-1, 1, Conv, [512, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P4 + [-1, 3, C3, [512, False]], # 25 + + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 4], 1, Concat, [1]], # cat backbone P3 + [-1, 3, C3, [256, False]], # 29 (P3/8-small) + + [-1, 1, Conv, [256, 3, 2]], + [[-1, 26], 1, Concat, [1]], # cat head P4 + [-1, 3, C3, [512, False]], # 32 (P4/16-medium) + + [-1, 1, Conv, [512, 3, 2]], + [[-1, 22], 1, Concat, [1]], # cat head P5 + [-1, 3, C3, [768, False]], # 35 (P5/32-large) + + [-1, 1, Conv, [768, 3, 2]], + [[-1, 18], 1, Concat, [1]], # cat head P6 + [-1, 3, C3, [1024, False]], # 38 (P6/64-xlarge) + + [-1, 1, Conv, [1024, 3, 2]], + [[-1, 14], 1, Concat, [1]], # cat head P7 + [-1, 3, C3, [1280, False]], # 41 (P7/128-xxlarge) + + [[29, 32, 35, 38, 41], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5, P6, P7) + ] diff --git a/yolov5_Monocular_social_ranging/models/hub/yolov5-panet.yaml b/yolov5_Monocular_social_ranging/models/hub/yolov5-panet.yaml new file mode 100644 index 0000000..ccfbf90 --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/hub/yolov5-panet.yaml @@ -0,0 +1,48 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 1.0 # model depth multiple +width_multiple: 1.0 # layer channel multiple +anchors: + - [10,13, 16,30, 33,23] # P3/8 + - [30,61, 62,45, 59,119] # P4/16 + - [116,90, 156,198, 373,326] # P5/32 + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [64, 6, 2, 2]], # 0-P1/2 + [-1, 1, Conv, [128, 3, 2]], # 1-P2/4 + [-1, 3, C3, [128]], + [-1, 1, Conv, [256, 3, 2]], # 3-P3/8 + [-1, 6, C3, [256]], + [-1, 1, Conv, [512, 3, 2]], # 5-P4/16 + [-1, 9, C3, [512]], + [-1, 1, Conv, [1024, 3, 2]], # 7-P5/32 + [-1, 3, C3, [1024]], + [-1, 1, SPPF, [1024, 5]], # 9 + ] + +# YOLOv5 v6.0 PANet head +head: + [[-1, 1, Conv, [512, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P4 + [-1, 3, C3, [512, False]], # 13 + + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 4], 1, Concat, [1]], # cat backbone P3 + [-1, 3, C3, [256, False]], # 17 (P3/8-small) + + [-1, 1, Conv, [256, 3, 2]], + [[-1, 14], 1, Concat, [1]], # cat head P4 + [-1, 3, C3, [512, False]], # 20 (P4/16-medium) + + [-1, 1, Conv, [512, 3, 2]], + [[-1, 10], 1, Concat, [1]], # cat head P5 + [-1, 3, C3, [1024, False]], # 23 (P5/32-large) + + [[17, 20, 23], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5) + ] diff --git a/yolov5_Monocular_social_ranging/models/hub/yolov5l6.yaml b/yolov5_Monocular_social_ranging/models/hub/yolov5l6.yaml new file mode 100644 index 0000000..632c2cb --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/hub/yolov5l6.yaml @@ -0,0 +1,60 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 1.0 # model depth multiple +width_multiple: 1.0 # layer channel multiple +anchors: + - [19,27, 44,40, 38,94] # P3/8 + - [96,68, 86,152, 180,137] # P4/16 + - [140,301, 303,264, 238,542] # P5/32 + - [436,615, 739,380, 925,792] # P6/64 + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [64, 6, 2, 2]], # 0-P1/2 + [-1, 1, Conv, [128, 3, 2]], # 1-P2/4 + [-1, 3, C3, [128]], + [-1, 1, Conv, [256, 3, 2]], # 3-P3/8 + [-1, 6, C3, [256]], + [-1, 1, Conv, [512, 3, 2]], # 5-P4/16 + [-1, 9, C3, [512]], + [-1, 1, Conv, [768, 3, 2]], # 7-P5/32 + [-1, 3, C3, [768]], + [-1, 1, Conv, [1024, 3, 2]], # 9-P6/64 + [-1, 3, C3, [1024]], + [-1, 1, SPPF, [1024, 5]], # 11 + ] + +# YOLOv5 v6.0 head +head: + [[-1, 1, Conv, [768, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 8], 1, Concat, [1]], # cat backbone P5 + [-1, 3, C3, [768, False]], # 15 + + [-1, 1, Conv, [512, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P4 + [-1, 3, C3, [512, False]], # 19 + + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 4], 1, Concat, [1]], # cat backbone P3 + [-1, 3, C3, [256, False]], # 23 (P3/8-small) + + [-1, 1, Conv, [256, 3, 2]], + [[-1, 20], 1, Concat, [1]], # cat head P4 + [-1, 3, C3, [512, False]], # 26 (P4/16-medium) + + [-1, 1, Conv, [512, 3, 2]], + [[-1, 16], 1, Concat, [1]], # cat head P5 + [-1, 3, C3, [768, False]], # 29 (P5/32-large) + + [-1, 1, Conv, [768, 3, 2]], + [[-1, 12], 1, Concat, [1]], # cat head P6 + [-1, 3, C3, [1024, False]], # 32 (P6/64-xlarge) + + [[23, 26, 29, 32], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5, P6) + ] diff --git a/yolov5_Monocular_social_ranging/models/hub/yolov5m6.yaml b/yolov5_Monocular_social_ranging/models/hub/yolov5m6.yaml new file mode 100644 index 0000000..ecc53fd --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/hub/yolov5m6.yaml @@ -0,0 +1,60 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 0.67 # model depth multiple +width_multiple: 0.75 # layer channel multiple +anchors: + - [19,27, 44,40, 38,94] # P3/8 + - [96,68, 86,152, 180,137] # P4/16 + - [140,301, 303,264, 238,542] # P5/32 + - [436,615, 739,380, 925,792] # P6/64 + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [64, 6, 2, 2]], # 0-P1/2 + [-1, 1, Conv, [128, 3, 2]], # 1-P2/4 + [-1, 3, C3, [128]], + [-1, 1, Conv, [256, 3, 2]], # 3-P3/8 + [-1, 6, C3, [256]], + [-1, 1, Conv, [512, 3, 2]], # 5-P4/16 + [-1, 9, C3, [512]], + [-1, 1, Conv, [768, 3, 2]], # 7-P5/32 + [-1, 3, C3, [768]], + [-1, 1, Conv, [1024, 3, 2]], # 9-P6/64 + [-1, 3, C3, [1024]], + [-1, 1, SPPF, [1024, 5]], # 11 + ] + +# YOLOv5 v6.0 head +head: + [[-1, 1, Conv, [768, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 8], 1, Concat, [1]], # cat backbone P5 + [-1, 3, C3, [768, False]], # 15 + + [-1, 1, Conv, [512, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P4 + [-1, 3, C3, [512, False]], # 19 + + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 4], 1, Concat, [1]], # cat backbone P3 + [-1, 3, C3, [256, False]], # 23 (P3/8-small) + + [-1, 1, Conv, [256, 3, 2]], + [[-1, 20], 1, Concat, [1]], # cat head P4 + [-1, 3, C3, [512, False]], # 26 (P4/16-medium) + + [-1, 1, Conv, [512, 3, 2]], + [[-1, 16], 1, Concat, [1]], # cat head P5 + [-1, 3, C3, [768, False]], # 29 (P5/32-large) + + [-1, 1, Conv, [768, 3, 2]], + [[-1, 12], 1, Concat, [1]], # cat head P6 + [-1, 3, C3, [1024, False]], # 32 (P6/64-xlarge) + + [[23, 26, 29, 32], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5, P6) + ] diff --git a/yolov5_Monocular_social_ranging/models/hub/yolov5n6.yaml b/yolov5_Monocular_social_ranging/models/hub/yolov5n6.yaml new file mode 100644 index 0000000..0c0c71d --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/hub/yolov5n6.yaml @@ -0,0 +1,60 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 0.33 # model depth multiple +width_multiple: 0.25 # layer channel multiple +anchors: + - [19,27, 44,40, 38,94] # P3/8 + - [96,68, 86,152, 180,137] # P4/16 + - [140,301, 303,264, 238,542] # P5/32 + - [436,615, 739,380, 925,792] # P6/64 + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [64, 6, 2, 2]], # 0-P1/2 + [-1, 1, Conv, [128, 3, 2]], # 1-P2/4 + [-1, 3, C3, [128]], + [-1, 1, Conv, [256, 3, 2]], # 3-P3/8 + [-1, 6, C3, [256]], + [-1, 1, Conv, [512, 3, 2]], # 5-P4/16 + [-1, 9, C3, [512]], + [-1, 1, Conv, [768, 3, 2]], # 7-P5/32 + [-1, 3, C3, [768]], + [-1, 1, Conv, [1024, 3, 2]], # 9-P6/64 + [-1, 3, C3, [1024]], + [-1, 1, SPPF, [1024, 5]], # 11 + ] + +# YOLOv5 v6.0 head +head: + [[-1, 1, Conv, [768, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 8], 1, Concat, [1]], # cat backbone P5 + [-1, 3, C3, [768, False]], # 15 + + [-1, 1, Conv, [512, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P4 + [-1, 3, C3, [512, False]], # 19 + + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 4], 1, Concat, [1]], # cat backbone P3 + [-1, 3, C3, [256, False]], # 23 (P3/8-small) + + [-1, 1, Conv, [256, 3, 2]], + [[-1, 20], 1, Concat, [1]], # cat head P4 + [-1, 3, C3, [512, False]], # 26 (P4/16-medium) + + [-1, 1, Conv, [512, 3, 2]], + [[-1, 16], 1, Concat, [1]], # cat head P5 + [-1, 3, C3, [768, False]], # 29 (P5/32-large) + + [-1, 1, Conv, [768, 3, 2]], + [[-1, 12], 1, Concat, [1]], # cat head P6 + [-1, 3, C3, [1024, False]], # 32 (P6/64-xlarge) + + [[23, 26, 29, 32], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5, P6) + ] diff --git a/yolov5_Monocular_social_ranging/models/hub/yolov5s-ghost.yaml b/yolov5_Monocular_social_ranging/models/hub/yolov5s-ghost.yaml new file mode 100644 index 0000000..ff9519c --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/hub/yolov5s-ghost.yaml @@ -0,0 +1,48 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 0.33 # model depth multiple +width_multiple: 0.50 # layer channel multiple +anchors: + - [10,13, 16,30, 33,23] # P3/8 + - [30,61, 62,45, 59,119] # P4/16 + - [116,90, 156,198, 373,326] # P5/32 + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [64, 6, 2, 2]], # 0-P1/2 + [-1, 1, GhostConv, [128, 3, 2]], # 1-P2/4 + [-1, 3, C3Ghost, [128]], + [-1, 1, GhostConv, [256, 3, 2]], # 3-P3/8 + [-1, 6, C3Ghost, [256]], + [-1, 1, GhostConv, [512, 3, 2]], # 5-P4/16 + [-1, 9, C3Ghost, [512]], + [-1, 1, GhostConv, [1024, 3, 2]], # 7-P5/32 + [-1, 3, C3Ghost, [1024]], + [-1, 1, SPPF, [1024, 5]], # 9 + ] + +# YOLOv5 v6.0 head +head: + [[-1, 1, GhostConv, [512, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P4 + [-1, 3, C3Ghost, [512, False]], # 13 + + [-1, 1, GhostConv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 4], 1, Concat, [1]], # cat backbone P3 + [-1, 3, C3Ghost, [256, False]], # 17 (P3/8-small) + + [-1, 1, GhostConv, [256, 3, 2]], + [[-1, 14], 1, Concat, [1]], # cat head P4 + [-1, 3, C3Ghost, [512, False]], # 20 (P4/16-medium) + + [-1, 1, GhostConv, [512, 3, 2]], + [[-1, 10], 1, Concat, [1]], # cat head P5 + [-1, 3, C3Ghost, [1024, False]], # 23 (P5/32-large) + + [[17, 20, 23], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5) + ] diff --git a/yolov5_Monocular_social_ranging/models/hub/yolov5s-transformer.yaml b/yolov5_Monocular_social_ranging/models/hub/yolov5s-transformer.yaml new file mode 100644 index 0000000..100d7c4 --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/hub/yolov5s-transformer.yaml @@ -0,0 +1,48 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 0.33 # model depth multiple +width_multiple: 0.50 # layer channel multiple +anchors: + - [10,13, 16,30, 33,23] # P3/8 + - [30,61, 62,45, 59,119] # P4/16 + - [116,90, 156,198, 373,326] # P5/32 + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [64, 6, 2, 2]], # 0-P1/2 + [-1, 1, Conv, [128, 3, 2]], # 1-P2/4 + [-1, 3, C3, [128]], + [-1, 1, Conv, [256, 3, 2]], # 3-P3/8 + [-1, 6, C3, [256]], + [-1, 1, Conv, [512, 3, 2]], # 5-P4/16 + [-1, 9, C3, [512]], + [-1, 1, Conv, [1024, 3, 2]], # 7-P5/32 + [-1, 3, C3TR, [1024]], # 9 <--- C3TR() Transformer module + [-1, 1, SPPF, [1024, 5]], # 9 + ] + +# YOLOv5 v6.0 head +head: + [[-1, 1, Conv, [512, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P4 + [-1, 3, C3, [512, False]], # 13 + + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 4], 1, Concat, [1]], # cat backbone P3 + [-1, 3, C3, [256, False]], # 17 (P3/8-small) + + [-1, 1, Conv, [256, 3, 2]], + [[-1, 14], 1, Concat, [1]], # cat head P4 + [-1, 3, C3, [512, False]], # 20 (P4/16-medium) + + [-1, 1, Conv, [512, 3, 2]], + [[-1, 10], 1, Concat, [1]], # cat head P5 + [-1, 3, C3, [1024, False]], # 23 (P5/32-large) + + [[17, 20, 23], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5) + ] diff --git a/yolov5_Monocular_social_ranging/models/hub/yolov5s6.yaml b/yolov5_Monocular_social_ranging/models/hub/yolov5s6.yaml new file mode 100644 index 0000000..a28fb55 --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/hub/yolov5s6.yaml @@ -0,0 +1,60 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 0.33 # model depth multiple +width_multiple: 0.50 # layer channel multiple +anchors: + - [19,27, 44,40, 38,94] # P3/8 + - [96,68, 86,152, 180,137] # P4/16 + - [140,301, 303,264, 238,542] # P5/32 + - [436,615, 739,380, 925,792] # P6/64 + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [64, 6, 2, 2]], # 0-P1/2 + [-1, 1, Conv, [128, 3, 2]], # 1-P2/4 + [-1, 3, C3, [128]], + [-1, 1, Conv, [256, 3, 2]], # 3-P3/8 + [-1, 6, C3, [256]], + [-1, 1, Conv, [512, 3, 2]], # 5-P4/16 + [-1, 9, C3, [512]], + [-1, 1, Conv, [768, 3, 2]], # 7-P5/32 + [-1, 3, C3, [768]], + [-1, 1, Conv, [1024, 3, 2]], # 9-P6/64 + [-1, 3, C3, [1024]], + [-1, 1, SPPF, [1024, 5]], # 11 + ] + +# YOLOv5 v6.0 head +head: + [[-1, 1, Conv, [768, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 8], 1, Concat, [1]], # cat backbone P5 + [-1, 3, C3, [768, False]], # 15 + + [-1, 1, Conv, [512, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P4 + [-1, 3, C3, [512, False]], # 19 + + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 4], 1, Concat, [1]], # cat backbone P3 + [-1, 3, C3, [256, False]], # 23 (P3/8-small) + + [-1, 1, Conv, [256, 3, 2]], + [[-1, 20], 1, Concat, [1]], # cat head P4 + [-1, 3, C3, [512, False]], # 26 (P4/16-medium) + + [-1, 1, Conv, [512, 3, 2]], + [[-1, 16], 1, Concat, [1]], # cat head P5 + [-1, 3, C3, [768, False]], # 29 (P5/32-large) + + [-1, 1, Conv, [768, 3, 2]], + [[-1, 12], 1, Concat, [1]], # cat head P6 + [-1, 3, C3, [1024, False]], # 32 (P6/64-xlarge) + + [[23, 26, 29, 32], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5, P6) + ] diff --git a/yolov5_Monocular_social_ranging/models/hub/yolov5x6.yaml b/yolov5_Monocular_social_ranging/models/hub/yolov5x6.yaml new file mode 100644 index 0000000..ba795c4 --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/hub/yolov5x6.yaml @@ -0,0 +1,60 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 1.33 # model depth multiple +width_multiple: 1.25 # layer channel multiple +anchors: + - [19,27, 44,40, 38,94] # P3/8 + - [96,68, 86,152, 180,137] # P4/16 + - [140,301, 303,264, 238,542] # P5/32 + - [436,615, 739,380, 925,792] # P6/64 + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [64, 6, 2, 2]], # 0-P1/2 + [-1, 1, Conv, [128, 3, 2]], # 1-P2/4 + [-1, 3, C3, [128]], + [-1, 1, Conv, [256, 3, 2]], # 3-P3/8 + [-1, 6, C3, [256]], + [-1, 1, Conv, [512, 3, 2]], # 5-P4/16 + [-1, 9, C3, [512]], + [-1, 1, Conv, [768, 3, 2]], # 7-P5/32 + [-1, 3, C3, [768]], + [-1, 1, Conv, [1024, 3, 2]], # 9-P6/64 + [-1, 3, C3, [1024]], + [-1, 1, SPPF, [1024, 5]], # 11 + ] + +# YOLOv5 v6.0 head +head: + [[-1, 1, Conv, [768, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 8], 1, Concat, [1]], # cat backbone P5 + [-1, 3, C3, [768, False]], # 15 + + [-1, 1, Conv, [512, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P4 + [-1, 3, C3, [512, False]], # 19 + + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 4], 1, Concat, [1]], # cat backbone P3 + [-1, 3, C3, [256, False]], # 23 (P3/8-small) + + [-1, 1, Conv, [256, 3, 2]], + [[-1, 20], 1, Concat, [1]], # cat head P4 + [-1, 3, C3, [512, False]], # 26 (P4/16-medium) + + [-1, 1, Conv, [512, 3, 2]], + [[-1, 16], 1, Concat, [1]], # cat head P5 + [-1, 3, C3, [768, False]], # 29 (P5/32-large) + + [-1, 1, Conv, [768, 3, 2]], + [[-1, 12], 1, Concat, [1]], # cat head P6 + [-1, 3, C3, [1024, False]], # 32 (P6/64-xlarge) + + [[23, 26, 29, 32], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5, P6) + ] diff --git a/yolov5_Monocular_social_ranging/models/tf.py b/yolov5_Monocular_social_ranging/models/tf.py new file mode 100644 index 0000000..74681e4 --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/tf.py @@ -0,0 +1,464 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +TensorFlow, Keras and TFLite versions of YOLOv5 +Authored by https://github.com/zldrobit in PR https://github.com/ultralytics/yolov5/pull/1127 + +Usage: + $ python models/tf.py --weights yolov5s.pt + +Export: + $ python path/to/export.py --weights yolov5s.pt --include saved_model pb tflite tfjs +""" + +import argparse +import sys +from copy import deepcopy +from pathlib import Path + +FILE = Path(__file__).resolve() +ROOT = FILE.parents[1] # YOLOv5 root directory +if str(ROOT) not in sys.path: + sys.path.append(str(ROOT)) # add ROOT to PATH +# ROOT = ROOT.relative_to(Path.cwd()) # relative + +import numpy as np +import tensorflow as tf +import torch +import torch.nn as nn +from tensorflow import keras + +from models.common import C3, SPP, SPPF, Bottleneck, BottleneckCSP, Concat, Conv, DWConv, Focus, autopad +from models.experimental import CrossConv, MixConv2d, attempt_load +from models.yolo import Detect +from utils.activations import SiLU +from utils.general import LOGGER, make_divisible, print_args + + +class TFBN(keras.layers.Layer): + # TensorFlow BatchNormalization wrapper + def __init__(self, w=None): + super().__init__() + self.bn = keras.layers.BatchNormalization( + beta_initializer=keras.initializers.Constant(w.bias.numpy()), + gamma_initializer=keras.initializers.Constant(w.weight.numpy()), + moving_mean_initializer=keras.initializers.Constant(w.running_mean.numpy()), + moving_variance_initializer=keras.initializers.Constant(w.running_var.numpy()), + epsilon=w.eps) + + def call(self, inputs): + return self.bn(inputs) + + +class TFPad(keras.layers.Layer): + def __init__(self, pad): + super().__init__() + self.pad = tf.constant([[0, 0], [pad, pad], [pad, pad], [0, 0]]) + + def call(self, inputs): + return tf.pad(inputs, self.pad, mode='constant', constant_values=0) + + +class TFConv(keras.layers.Layer): + # Standard convolution + def __init__(self, c1, c2, k=1, s=1, p=None, g=1, act=True, w=None): + # ch_in, ch_out, weights, kernel, stride, padding, groups + super().__init__() + assert g == 1, "TF v2.2 Conv2D does not support 'groups' argument" + assert isinstance(k, int), "Convolution with multiple kernels are not allowed." + # TensorFlow convolution padding is inconsistent with PyTorch (e.g. k=3 s=2 'SAME' padding) + # see https://stackoverflow.com/questions/52975843/comparing-conv2d-with-padding-between-tensorflow-and-pytorch + + conv = keras.layers.Conv2D( + c2, k, s, 'SAME' if s == 1 else 'VALID', use_bias=False if hasattr(w, 'bn') else True, + kernel_initializer=keras.initializers.Constant(w.conv.weight.permute(2, 3, 1, 0).numpy()), + bias_initializer='zeros' if hasattr(w, 'bn') else keras.initializers.Constant(w.conv.bias.numpy())) + self.conv = conv if s == 1 else keras.Sequential([TFPad(autopad(k, p)), conv]) + self.bn = TFBN(w.bn) if hasattr(w, 'bn') else tf.identity + + # YOLOv5 activations + if isinstance(w.act, nn.LeakyReLU): + self.act = (lambda x: keras.activations.relu(x, alpha=0.1)) if act else tf.identity + elif isinstance(w.act, nn.Hardswish): + self.act = (lambda x: x * tf.nn.relu6(x + 3) * 0.166666667) if act else tf.identity + elif isinstance(w.act, (nn.SiLU, SiLU)): + self.act = (lambda x: keras.activations.swish(x)) if act else tf.identity + else: + raise Exception(f'no matching TensorFlow activation found for {w.act}') + + def call(self, inputs): + return self.act(self.bn(self.conv(inputs))) + + +class TFFocus(keras.layers.Layer): + # Focus wh information into c-space + def __init__(self, c1, c2, k=1, s=1, p=None, g=1, act=True, w=None): + # ch_in, ch_out, kernel, stride, padding, groups + super().__init__() + self.conv = TFConv(c1 * 4, c2, k, s, p, g, act, w.conv) + + def call(self, inputs): # x(b,w,h,c) -> y(b,w/2,h/2,4c) + # inputs = inputs / 255 # normalize 0-255 to 0-1 + return self.conv(tf.concat([inputs[:, ::2, ::2, :], + inputs[:, 1::2, ::2, :], + inputs[:, ::2, 1::2, :], + inputs[:, 1::2, 1::2, :]], 3)) + + +class TFBottleneck(keras.layers.Layer): + # Standard bottleneck + def __init__(self, c1, c2, shortcut=True, g=1, e=0.5, w=None): # ch_in, ch_out, shortcut, groups, expansion + super().__init__() + c_ = int(c2 * e) # hidden channels + self.cv1 = TFConv(c1, c_, 1, 1, w=w.cv1) + self.cv2 = TFConv(c_, c2, 3, 1, g=g, w=w.cv2) + self.add = shortcut and c1 == c2 + + def call(self, inputs): + return inputs + self.cv2(self.cv1(inputs)) if self.add else self.cv2(self.cv1(inputs)) + + +class TFConv2d(keras.layers.Layer): + # Substitution for PyTorch nn.Conv2D + def __init__(self, c1, c2, k, s=1, g=1, bias=True, w=None): + super().__init__() + assert g == 1, "TF v2.2 Conv2D does not support 'groups' argument" + self.conv = keras.layers.Conv2D( + c2, k, s, 'VALID', use_bias=bias, + kernel_initializer=keras.initializers.Constant(w.weight.permute(2, 3, 1, 0).numpy()), + bias_initializer=keras.initializers.Constant(w.bias.numpy()) if bias else None, ) + + def call(self, inputs): + return self.conv(inputs) + + +class TFBottleneckCSP(keras.layers.Layer): + # CSP Bottleneck https://github.com/WongKinYiu/CrossStagePartialNetworks + def __init__(self, c1, c2, n=1, shortcut=True, g=1, e=0.5, w=None): + # ch_in, ch_out, number, shortcut, groups, expansion + super().__init__() + c_ = int(c2 * e) # hidden channels + self.cv1 = TFConv(c1, c_, 1, 1, w=w.cv1) + self.cv2 = TFConv2d(c1, c_, 1, 1, bias=False, w=w.cv2) + self.cv3 = TFConv2d(c_, c_, 1, 1, bias=False, w=w.cv3) + self.cv4 = TFConv(2 * c_, c2, 1, 1, w=w.cv4) + self.bn = TFBN(w.bn) + self.act = lambda x: keras.activations.relu(x, alpha=0.1) + self.m = keras.Sequential([TFBottleneck(c_, c_, shortcut, g, e=1.0, w=w.m[j]) for j in range(n)]) + + def call(self, inputs): + y1 = self.cv3(self.m(self.cv1(inputs))) + y2 = self.cv2(inputs) + return self.cv4(self.act(self.bn(tf.concat((y1, y2), axis=3)))) + + +class TFC3(keras.layers.Layer): + # CSP Bottleneck with 3 convolutions + def __init__(self, c1, c2, n=1, shortcut=True, g=1, e=0.5, w=None): + # ch_in, ch_out, number, shortcut, groups, expansion + super().__init__() + c_ = int(c2 * e) # hidden channels + self.cv1 = TFConv(c1, c_, 1, 1, w=w.cv1) + self.cv2 = TFConv(c1, c_, 1, 1, w=w.cv2) + self.cv3 = TFConv(2 * c_, c2, 1, 1, w=w.cv3) + self.m = keras.Sequential([TFBottleneck(c_, c_, shortcut, g, e=1.0, w=w.m[j]) for j in range(n)]) + + def call(self, inputs): + return self.cv3(tf.concat((self.m(self.cv1(inputs)), self.cv2(inputs)), axis=3)) + + +class TFSPP(keras.layers.Layer): + # Spatial pyramid pooling layer used in YOLOv3-SPP + def __init__(self, c1, c2, k=(5, 9, 13), w=None): + super().__init__() + c_ = c1 // 2 # hidden channels + self.cv1 = TFConv(c1, c_, 1, 1, w=w.cv1) + self.cv2 = TFConv(c_ * (len(k) + 1), c2, 1, 1, w=w.cv2) + self.m = [keras.layers.MaxPool2D(pool_size=x, strides=1, padding='SAME') for x in k] + + def call(self, inputs): + x = self.cv1(inputs) + return self.cv2(tf.concat([x] + [m(x) for m in self.m], 3)) + + +class TFSPPF(keras.layers.Layer): + # Spatial pyramid pooling-Fast layer + def __init__(self, c1, c2, k=5, w=None): + super().__init__() + c_ = c1 // 2 # hidden channels + self.cv1 = TFConv(c1, c_, 1, 1, w=w.cv1) + self.cv2 = TFConv(c_ * 4, c2, 1, 1, w=w.cv2) + self.m = keras.layers.MaxPool2D(pool_size=k, strides=1, padding='SAME') + + def call(self, inputs): + x = self.cv1(inputs) + y1 = self.m(x) + y2 = self.m(y1) + return self.cv2(tf.concat([x, y1, y2, self.m(y2)], 3)) + + +class TFDetect(keras.layers.Layer): + def __init__(self, nc=80, anchors=(), ch=(), imgsz=(640, 640), w=None): # detection layer + super().__init__() + self.stride = tf.convert_to_tensor(w.stride.numpy(), dtype=tf.float32) + self.nc = nc # number of classes + self.no = nc + 5 # number of outputs per anchor + self.nl = len(anchors) # number of detection layers + self.na = len(anchors[0]) // 2 # number of anchors + self.grid = [tf.zeros(1)] * self.nl # init grid + self.anchors = tf.convert_to_tensor(w.anchors.numpy(), dtype=tf.float32) + self.anchor_grid = tf.reshape(self.anchors * tf.reshape(self.stride, [self.nl, 1, 1]), + [self.nl, 1, -1, 1, 2]) + self.m = [TFConv2d(x, self.no * self.na, 1, w=w.m[i]) for i, x in enumerate(ch)] + self.training = False # set to False after building model + self.imgsz = imgsz + for i in range(self.nl): + ny, nx = self.imgsz[0] // self.stride[i], self.imgsz[1] // self.stride[i] + self.grid[i] = self._make_grid(nx, ny) + + def call(self, inputs): + z = [] # inference output + x = [] + for i in range(self.nl): + x.append(self.m[i](inputs[i])) + # x(bs,20,20,255) to x(bs,3,20,20,85) + ny, nx = self.imgsz[0] // self.stride[i], self.imgsz[1] // self.stride[i] + x[i] = tf.transpose(tf.reshape(x[i], [-1, ny * nx, self.na, self.no]), [0, 2, 1, 3]) + + if not self.training: # inference + y = tf.sigmoid(x[i]) + xy = (y[..., 0:2] * 2 - 0.5 + self.grid[i]) * self.stride[i] # xy + wh = (y[..., 2:4] * 2) ** 2 * self.anchor_grid[i] + # Normalize xywh to 0-1 to reduce calibration error + xy /= tf.constant([[self.imgsz[1], self.imgsz[0]]], dtype=tf.float32) + wh /= tf.constant([[self.imgsz[1], self.imgsz[0]]], dtype=tf.float32) + y = tf.concat([xy, wh, y[..., 4:]], -1) + z.append(tf.reshape(y, [-1, self.na * ny * nx, self.no])) + + return x if self.training else (tf.concat(z, 1), x) + + @staticmethod + def _make_grid(nx=20, ny=20): + # yv, xv = torch.meshgrid([torch.arange(ny), torch.arange(nx)]) + # return torch.stack((xv, yv), 2).view((1, 1, ny, nx, 2)).float() + xv, yv = tf.meshgrid(tf.range(nx), tf.range(ny)) + return tf.cast(tf.reshape(tf.stack([xv, yv], 2), [1, 1, ny * nx, 2]), dtype=tf.float32) + + +class TFUpsample(keras.layers.Layer): + def __init__(self, size, scale_factor, mode, w=None): # warning: all arguments needed including 'w' + super().__init__() + assert scale_factor == 2, "scale_factor must be 2" + self.upsample = lambda x: tf.image.resize(x, (x.shape[1] * 2, x.shape[2] * 2), method=mode) + # self.upsample = keras.layers.UpSampling2D(size=scale_factor, interpolation=mode) + # with default arguments: align_corners=False, half_pixel_centers=False + # self.upsample = lambda x: tf.raw_ops.ResizeNearestNeighbor(images=x, + # size=(x.shape[1] * 2, x.shape[2] * 2)) + + def call(self, inputs): + return self.upsample(inputs) + + +class TFConcat(keras.layers.Layer): + def __init__(self, dimension=1, w=None): + super().__init__() + assert dimension == 1, "convert only NCHW to NHWC concat" + self.d = 3 + + def call(self, inputs): + return tf.concat(inputs, self.d) + + +def parse_model(d, ch, model, imgsz): # model_dict, input_channels(3) + LOGGER.info(f"\n{'':>3}{'from':>18}{'n':>3}{'params':>10} {'module':<40}{'arguments':<30}") + anchors, nc, gd, gw = d['anchors'], d['nc'], d['depth_multiple'], d['width_multiple'] + na = (len(anchors[0]) // 2) if isinstance(anchors, list) else anchors # number of anchors + no = na * (nc + 5) # number of outputs = anchors * (classes + 5) + + layers, save, c2 = [], [], ch[-1] # layers, savelist, ch out + for i, (f, n, m, args) in enumerate(d['backbone'] + d['head']): # from, number, module, args + m_str = m + m = eval(m) if isinstance(m, str) else m # eval strings + for j, a in enumerate(args): + try: + args[j] = eval(a) if isinstance(a, str) else a # eval strings + except NameError: + pass + + n = max(round(n * gd), 1) if n > 1 else n # depth gain + if m in [nn.Conv2d, Conv, Bottleneck, SPP, SPPF, DWConv, MixConv2d, Focus, CrossConv, BottleneckCSP, C3]: + c1, c2 = ch[f], args[0] + c2 = make_divisible(c2 * gw, 8) if c2 != no else c2 + + args = [c1, c2, *args[1:]] + if m in [BottleneckCSP, C3]: + args.insert(2, n) + n = 1 + elif m is nn.BatchNorm2d: + args = [ch[f]] + elif m is Concat: + c2 = sum(ch[-1 if x == -1 else x + 1] for x in f) + elif m is Detect: + args.append([ch[x + 1] for x in f]) + if isinstance(args[1], int): # number of anchors + args[1] = [list(range(args[1] * 2))] * len(f) + args.append(imgsz) + else: + c2 = ch[f] + + tf_m = eval('TF' + m_str.replace('nn.', '')) + m_ = keras.Sequential([tf_m(*args, w=model.model[i][j]) for j in range(n)]) if n > 1 \ + else tf_m(*args, w=model.model[i]) # module + + torch_m_ = nn.Sequential(*(m(*args) for _ in range(n))) if n > 1 else m(*args) # module + t = str(m)[8:-2].replace('__main__.', '') # module type + np = sum(x.numel() for x in torch_m_.parameters()) # number params + m_.i, m_.f, m_.type, m_.np = i, f, t, np # attach index, 'from' index, type, number params + LOGGER.info(f'{i:>3}{str(f):>18}{str(n):>3}{np:>10} {t:<40}{str(args):<30}') # print + save.extend(x % i for x in ([f] if isinstance(f, int) else f) if x != -1) # append to savelist + layers.append(m_) + ch.append(c2) + return keras.Sequential(layers), sorted(save) + + +class TFModel: + def __init__(self, cfg='yolov5s.yaml', ch=3, nc=None, model=None, imgsz=(640, 640)): # model, channels, classes + super().__init__() + if isinstance(cfg, dict): + self.yaml = cfg # model dict + else: # is *.yaml + import yaml # for torch hub + self.yaml_file = Path(cfg).name + with open(cfg) as f: + self.yaml = yaml.load(f, Loader=yaml.FullLoader) # model dict + + # Define model + if nc and nc != self.yaml['nc']: + LOGGER.info(f"Overriding {cfg} nc={self.yaml['nc']} with nc={nc}") + self.yaml['nc'] = nc # override yaml value + self.model, self.savelist = parse_model(deepcopy(self.yaml), ch=[ch], model=model, imgsz=imgsz) + + def predict(self, inputs, tf_nms=False, agnostic_nms=False, topk_per_class=100, topk_all=100, iou_thres=0.45, + conf_thres=0.25): + y = [] # outputs + x = inputs + for i, m in enumerate(self.model.layers): + if m.f != -1: # if not from previous layer + x = y[m.f] if isinstance(m.f, int) else [x if j == -1 else y[j] for j in m.f] # from earlier layers + + x = m(x) # run + y.append(x if m.i in self.savelist else None) # save output + + # Add TensorFlow NMS + if tf_nms: + boxes = self._xywh2xyxy(x[0][..., :4]) + probs = x[0][:, :, 4:5] + classes = x[0][:, :, 5:] + scores = probs * classes + if agnostic_nms: + nms = AgnosticNMS()((boxes, classes, scores), topk_all, iou_thres, conf_thres) + return nms, x[1] + else: + boxes = tf.expand_dims(boxes, 2) + nms = tf.image.combined_non_max_suppression( + boxes, scores, topk_per_class, topk_all, iou_thres, conf_thres, clip_boxes=False) + return nms, x[1] + + return x[0] # output only first tensor [1,6300,85] = [xywh, conf, class0, class1, ...] + # x = x[0][0] # [x(1,6300,85), ...] to x(6300,85) + # xywh = x[..., :4] # x(6300,4) boxes + # conf = x[..., 4:5] # x(6300,1) confidences + # cls = tf.reshape(tf.cast(tf.argmax(x[..., 5:], axis=1), tf.float32), (-1, 1)) # x(6300,1) classes + # return tf.concat([conf, cls, xywh], 1) + + @staticmethod + def _xywh2xyxy(xywh): + # Convert nx4 boxes from [x, y, w, h] to [x1, y1, x2, y2] where xy1=top-left, xy2=bottom-right + x, y, w, h = tf.split(xywh, num_or_size_splits=4, axis=-1) + return tf.concat([x - w / 2, y - h / 2, x + w / 2, y + h / 2], axis=-1) + + +class AgnosticNMS(keras.layers.Layer): + # TF Agnostic NMS + def call(self, input, topk_all, iou_thres, conf_thres): + # wrap map_fn to avoid TypeSpec related error https://stackoverflow.com/a/65809989/3036450 + return tf.map_fn(lambda x: self._nms(x, topk_all, iou_thres, conf_thres), input, + fn_output_signature=(tf.float32, tf.float32, tf.float32, tf.int32), + name='agnostic_nms') + + @staticmethod + def _nms(x, topk_all=100, iou_thres=0.45, conf_thres=0.25): # agnostic NMS + boxes, classes, scores = x + class_inds = tf.cast(tf.argmax(classes, axis=-1), tf.float32) + scores_inp = tf.reduce_max(scores, -1) + selected_inds = tf.image.non_max_suppression( + boxes, scores_inp, max_output_size=topk_all, iou_threshold=iou_thres, score_threshold=conf_thres) + selected_boxes = tf.gather(boxes, selected_inds) + padded_boxes = tf.pad(selected_boxes, + paddings=[[0, topk_all - tf.shape(selected_boxes)[0]], [0, 0]], + mode="CONSTANT", constant_values=0.0) + selected_scores = tf.gather(scores_inp, selected_inds) + padded_scores = tf.pad(selected_scores, + paddings=[[0, topk_all - tf.shape(selected_boxes)[0]]], + mode="CONSTANT", constant_values=-1.0) + selected_classes = tf.gather(class_inds, selected_inds) + padded_classes = tf.pad(selected_classes, + paddings=[[0, topk_all - tf.shape(selected_boxes)[0]]], + mode="CONSTANT", constant_values=-1.0) + valid_detections = tf.shape(selected_inds)[0] + return padded_boxes, padded_scores, padded_classes, valid_detections + + +def representative_dataset_gen(dataset, ncalib=100): + # Representative dataset generator for use with converter.representative_dataset, returns a generator of np arrays + for n, (path, img, im0s, vid_cap, string) in enumerate(dataset): + input = np.transpose(img, [1, 2, 0]) + input = np.expand_dims(input, axis=0).astype(np.float32) + input /= 255 + yield [input] + if n >= ncalib: + break + + +def run(weights=ROOT / 'yolov5s.pt', # weights path + imgsz=(640, 640), # inference size h,w + batch_size=1, # batch size + dynamic=False, # dynamic batch size + ): + # PyTorch model + im = torch.zeros((batch_size, 3, *imgsz)) # BCHW image + model = attempt_load(weights, map_location=torch.device('cpu'), inplace=True, fuse=False) + _ = model(im) # inference + model.info() + + # TensorFlow model + im = tf.zeros((batch_size, *imgsz, 3)) # BHWC image + tf_model = TFModel(cfg=model.yaml, model=model, nc=model.nc, imgsz=imgsz) + _ = tf_model.predict(im) # inference + + # Keras model + im = keras.Input(shape=(*imgsz, 3), batch_size=None if dynamic else batch_size) + keras_model = keras.Model(inputs=im, outputs=tf_model.predict(im)) + keras_model.summary() + + LOGGER.info('PyTorch, TensorFlow and Keras models successfully verified.\nUse export.py for TF model export.') + + +def parse_opt(): + parser = argparse.ArgumentParser() + parser.add_argument('--weights', type=str, default=ROOT / 'yolov5s.pt', help='weights path') + parser.add_argument('--imgsz', '--img', '--img-size', nargs='+', type=int, default=[640], help='inference size h,w') + parser.add_argument('--batch-size', type=int, default=1, help='batch size') + parser.add_argument('--dynamic', action='store_true', help='dynamic batch size') + opt = parser.parse_args() + opt.imgsz *= 2 if len(opt.imgsz) == 1 else 1 # expand + print_args(FILE.stem, opt) + return opt + + +def main(opt): + run(**vars(opt)) + + +if __name__ == "__main__": + opt = parse_opt() + main(opt) diff --git a/yolov5_Monocular_social_ranging/models/yolo.py b/yolov5_Monocular_social_ranging/models/yolo.py new file mode 100644 index 0000000..f659a04 --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/yolo.py @@ -0,0 +1,329 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +YOLO-specific modules + +Usage: + $ python path/to/models/yolo.py --cfg yolov5s.yaml +""" + +import argparse +import sys +from copy import deepcopy +from pathlib import Path + +FILE = Path(__file__).resolve() +ROOT = FILE.parents[1] # YOLOv5 root directory +if str(ROOT) not in sys.path: + sys.path.append(str(ROOT)) # add ROOT to PATH +# ROOT = ROOT.relative_to(Path.cwd()) # relative + +from models.common import * +from models.experimental import * +from utils.autoanchor import check_anchor_order +from utils.general import LOGGER, check_version, check_yaml, make_divisible, print_args +from utils.plots import feature_visualization +from utils.torch_utils import fuse_conv_and_bn, initialize_weights, model_info, scale_img, select_device, time_sync + +try: + import thop # for FLOPs computation +except ImportError: + thop = None + + +class Detect(nn.Module): + stride = None # strides computed during build + onnx_dynamic = False # ONNX export parameter + + def __init__(self, nc=80, anchors=(), ch=(), inplace=True): # detection layer + super().__init__() + self.nc = nc # number of classes + self.no = nc + 5 # number of outputs per anchor + self.nl = len(anchors) # number of detection layers + self.na = len(anchors[0]) // 2 # number of anchors + self.grid = [torch.zeros(1)] * self.nl # init grid + self.anchor_grid = [torch.zeros(1)] * self.nl # init anchor grid + self.register_buffer('anchors', torch.tensor(anchors).float().view(self.nl, -1, 2)) # shape(nl,na,2) + self.m = nn.ModuleList(nn.Conv2d(x, self.no * self.na, 1) for x in ch) # output conv + self.inplace = inplace # use in-place ops (e.g. slice assignment) + + def forward(self, x): + z = [] # inference output + for i in range(self.nl): + x[i] = self.m[i](x[i]) # conv + bs, _, ny, nx = x[i].shape # x(bs,255,20,20) to x(bs,3,20,20,85) + x[i] = x[i].view(bs, self.na, self.no, ny, nx).permute(0, 1, 3, 4, 2).contiguous() + + if not self.training: # inference + if self.onnx_dynamic or self.grid[i].shape[2:4] != x[i].shape[2:4]: + self.grid[i], self.anchor_grid[i] = self._make_grid(nx, ny, i) + + y = x[i].sigmoid() + if self.inplace: + y[..., 0:2] = (y[..., 0:2] * 2 - 0.5 + self.grid[i]) * self.stride[i] # xy + y[..., 2:4] = (y[..., 2:4] * 2) ** 2 * self.anchor_grid[i] # wh + else: # for YOLOv5 on AWS Inferentia https://github.com/ultralytics/yolov5/pull/2953 + xy = (y[..., 0:2] * 2 - 0.5 + self.grid[i]) * self.stride[i] # xy + wh = (y[..., 2:4] * 2) ** 2 * self.anchor_grid[i] # wh + y = torch.cat((xy, wh, y[..., 4:]), -1) + z.append(y.view(bs, -1, self.no)) + + return x if self.training else (torch.cat(z, 1), x) + + def _make_grid(self, nx=20, ny=20, i=0): + d = self.anchors[i].device + if check_version(torch.__version__, '1.10.0'): # torch>=1.10.0 meshgrid workaround for torch>=0.7 compatibility + yv, xv = torch.meshgrid([torch.arange(ny, device=d), torch.arange(nx, device=d)], indexing='ij') + else: + yv, xv = torch.meshgrid([torch.arange(ny, device=d), torch.arange(nx, device=d)]) + grid = torch.stack((xv, yv), 2).expand((1, self.na, ny, nx, 2)).float() + anchor_grid = (self.anchors[i].clone() * self.stride[i]) \ + .view((1, self.na, 1, 1, 2)).expand((1, self.na, ny, nx, 2)).float() + return grid, anchor_grid + + +class Model(nn.Module): + def __init__(self, cfg='yolov5s.yaml', ch=3, nc=None, anchors=None): # model, input channels, number of classes + super().__init__() + if isinstance(cfg, dict): + self.yaml = cfg # model dict + else: # is *.yaml + import yaml # for torch hub + self.yaml_file = Path(cfg).name + with open(cfg, encoding='ascii', errors='ignore') as f: + self.yaml = yaml.safe_load(f) # model dict + + # Define model + ch = self.yaml['ch'] = self.yaml.get('ch', ch) # input channels + if nc and nc != self.yaml['nc']: + LOGGER.info(f"Overriding model.yaml nc={self.yaml['nc']} with nc={nc}") + self.yaml['nc'] = nc # override yaml value + if anchors: + LOGGER.info(f'Overriding model.yaml anchors with anchors={anchors}') + self.yaml['anchors'] = round(anchors) # override yaml value + self.model, self.save = parse_model(deepcopy(self.yaml), ch=[ch]) # model, savelist + self.names = [str(i) for i in range(self.yaml['nc'])] # default names + self.inplace = self.yaml.get('inplace', True) + + # Build strides, anchors + m = self.model[-1] # Detect() + if isinstance(m, Detect): + s = 256 # 2x min stride + m.inplace = self.inplace + m.stride = torch.tensor([s / x.shape[-2] for x in self.forward(torch.zeros(1, ch, s, s))]) # forward + m.anchors /= m.stride.view(-1, 1, 1) + check_anchor_order(m) + self.stride = m.stride + self._initialize_biases() # only run once + + # Init weights, biases + initialize_weights(self) + self.info() + LOGGER.info('') + + def forward(self, x, augment=False, profile=False, visualize=False): + if augment: + return self._forward_augment(x) # augmented inference, None + return self._forward_once(x, profile, visualize) # single-scale inference, train + + def _forward_augment(self, x): + img_size = x.shape[-2:] # height, width + s = [1, 0.83, 0.67] # scales + f = [None, 3, None] # flips (2-ud, 3-lr) + y = [] # outputs + for si, fi in zip(s, f): + xi = scale_img(x.flip(fi) if fi else x, si, gs=int(self.stride.max())) + yi = self._forward_once(xi)[0] # forward + # cv2.imwrite(f'img_{si}.jpg', 255 * xi[0].cpu().numpy().transpose((1, 2, 0))[:, :, ::-1]) # save + yi = self._descale_pred(yi, fi, si, img_size) + y.append(yi) + y = self._clip_augmented(y) # clip augmented tails + return torch.cat(y, 1), None # augmented inference, train + + def _forward_once(self, x, profile=False, visualize=False): + y, dt = [], [] # outputs + for m in self.model: + if m.f != -1: # if not from previous layer + x = y[m.f] if isinstance(m.f, int) else [x if j == -1 else y[j] for j in m.f] # from earlier layers + if profile: + self._profile_one_layer(m, x, dt) + x = m(x) # run + y.append(x if m.i in self.save else None) # save output + if visualize: + feature_visualization(x, m.type, m.i, save_dir=visualize) + return x + + def _descale_pred(self, p, flips, scale, img_size): + # de-scale predictions following augmented inference (inverse operation) + if self.inplace: + p[..., :4] /= scale # de-scale + if flips == 2: + p[..., 1] = img_size[0] - p[..., 1] # de-flip ud + elif flips == 3: + p[..., 0] = img_size[1] - p[..., 0] # de-flip lr + else: + x, y, wh = p[..., 0:1] / scale, p[..., 1:2] / scale, p[..., 2:4] / scale # de-scale + if flips == 2: + y = img_size[0] - y # de-flip ud + elif flips == 3: + x = img_size[1] - x # de-flip lr + p = torch.cat((x, y, wh, p[..., 4:]), -1) + return p + + def _clip_augmented(self, y): + # Clip YOLOv5 augmented inference tails + nl = self.model[-1].nl # number of detection layers (P3-P5) + g = sum(4 ** x for x in range(nl)) # grid points + e = 1 # exclude layer count + i = (y[0].shape[1] // g) * sum(4 ** x for x in range(e)) # indices + y[0] = y[0][:, :-i] # large + i = (y[-1].shape[1] // g) * sum(4 ** (nl - 1 - x) for x in range(e)) # indices + y[-1] = y[-1][:, i:] # small + return y + + def _profile_one_layer(self, m, x, dt): + c = isinstance(m, Detect) # is final layer, copy input as inplace fix + o = thop.profile(m, inputs=(x.copy() if c else x,), verbose=False)[0] / 1E9 * 2 if thop else 0 # FLOPs + t = time_sync() + for _ in range(10): + m(x.copy() if c else x) + dt.append((time_sync() - t) * 100) + if m == self.model[0]: + LOGGER.info(f"{'time (ms)':>10s} {'GFLOPs':>10s} {'params':>10s} {'module'}") + LOGGER.info(f'{dt[-1]:10.2f} {o:10.2f} {m.np:10.0f} {m.type}') + if c: + LOGGER.info(f"{sum(dt):10.2f} {'-':>10s} {'-':>10s} Total") + + def _initialize_biases(self, cf=None): # initialize biases into Detect(), cf is class frequency + # https://arxiv.org/abs/1708.02002 section 3.3 + # cf = torch.bincount(torch.tensor(np.concatenate(dataset.labels, 0)[:, 0]).long(), minlength=nc) + 1. + m = self.model[-1] # Detect() module + for mi, s in zip(m.m, m.stride): # from + b = mi.bias.view(m.na, -1) # conv.bias(255) to (3,85) + b.data[:, 4] += math.log(8 / (640 / s) ** 2) # obj (8 objects per 640 image) + b.data[:, 5:] += math.log(0.6 / (m.nc - 0.999999)) if cf is None else torch.log(cf / cf.sum()) # cls + mi.bias = torch.nn.Parameter(b.view(-1), requires_grad=True) + + def _print_biases(self): + m = self.model[-1] # Detect() module + for mi in m.m: # from + b = mi.bias.detach().view(m.na, -1).T # conv.bias(255) to (3,85) + LOGGER.info( + ('%6g Conv2d.bias:' + '%10.3g' * 6) % (mi.weight.shape[1], *b[:5].mean(1).tolist(), b[5:].mean())) + + # def _print_weights(self): + # for m in self.model.modules(): + # if type(m) is Bottleneck: + # LOGGER.info('%10.3g' % (m.w.detach().sigmoid() * 2)) # shortcut weights + + def fuse(self): # fuse model Conv2d() + BatchNorm2d() layers + LOGGER.info('Fusing layers... ') + for m in self.model.modules(): + if isinstance(m, (Conv, DWConv)) and hasattr(m, 'bn'): + m.conv = fuse_conv_and_bn(m.conv, m.bn) # update conv + delattr(m, 'bn') # remove batchnorm + m.forward = m.forward_fuse # update forward + self.info() + return self + + def info(self, verbose=False, img_size=640): # print model information + model_info(self, verbose, img_size) + + def _apply(self, fn): + # Apply to(), cpu(), cuda(), half() to model tensors that are not parameters or registered buffers + self = super()._apply(fn) + m = self.model[-1] # Detect() + if isinstance(m, Detect): + m.stride = fn(m.stride) + m.grid = list(map(fn, m.grid)) + if isinstance(m.anchor_grid, list): + m.anchor_grid = list(map(fn, m.anchor_grid)) + return self + + +def parse_model(d, ch): # model_dict, input_channels(3) + LOGGER.info(f"\n{'':>3}{'from':>18}{'n':>3}{'params':>10} {'module':<40}{'arguments':<30}") + anchors, nc, gd, gw = d['anchors'], d['nc'], d['depth_multiple'], d['width_multiple'] + na = (len(anchors[0]) // 2) if isinstance(anchors, list) else anchors # number of anchors + no = na * (nc + 5) # number of outputs = anchors * (classes + 5) + + layers, save, c2 = [], [], ch[-1] # layers, savelist, ch out + for i, (f, n, m, args) in enumerate(d['backbone'] + d['head']): # from, number, module, args + m = eval(m) if isinstance(m, str) else m # eval strings + for j, a in enumerate(args): + try: + args[j] = eval(a) if isinstance(a, str) else a # eval strings + except NameError: + pass + + n = n_ = max(round(n * gd), 1) if n > 1 else n # depth gain + if m in [Conv, GhostConv, Bottleneck, GhostBottleneck, SPP, SPPF, DWConv, MixConv2d, Focus, CrossConv, + BottleneckCSP, C3, C3TR, C3SPP, C3Ghost]: + c1, c2 = ch[f], args[0] + if c2 != no: # if not output + c2 = make_divisible(c2 * gw, 8) + + args = [c1, c2, *args[1:]] + if m in [BottleneckCSP, C3, C3TR, C3Ghost]: + args.insert(2, n) # number of repeats + n = 1 + elif m is nn.BatchNorm2d: + args = [ch[f]] + elif m is Concat: + c2 = sum(ch[x] for x in f) + elif m is Detect: + args.append([ch[x] for x in f]) + if isinstance(args[1], int): # number of anchors + args[1] = [list(range(args[1] * 2))] * len(f) + elif m is Contract: + c2 = ch[f] * args[0] ** 2 + elif m is Expand: + c2 = ch[f] // args[0] ** 2 + else: + c2 = ch[f] + + m_ = nn.Sequential(*(m(*args) for _ in range(n))) if n > 1 else m(*args) # module + t = str(m)[8:-2].replace('__main__.', '') # module type + np = sum(x.numel() for x in m_.parameters()) # number params + m_.i, m_.f, m_.type, m_.np = i, f, t, np # attach index, 'from' index, type, number params + LOGGER.info(f'{i:>3}{str(f):>18}{n_:>3}{np:10.0f} {t:<40}{str(args):<30}') # print + save.extend(x % i for x in ([f] if isinstance(f, int) else f) if x != -1) # append to savelist + layers.append(m_) + if i == 0: + ch = [] + ch.append(c2) + return nn.Sequential(*layers), sorted(save) + + +if __name__ == '__main__': + parser = argparse.ArgumentParser() + parser.add_argument('--cfg', type=str, default='yolov5s.yaml', help='model.yaml') + parser.add_argument('--device', default='', help='cuda device, i.e. 0 or 0,1,2,3 or cpu') + parser.add_argument('--profile', action='store_true', help='profile model speed') + parser.add_argument('--test', action='store_true', help='test all yolo*.yaml') + opt = parser.parse_args() + opt.cfg = check_yaml(opt.cfg) # check YAML + print_args(FILE.stem, opt) + device = select_device(opt.device) + + # Create model + model = Model(opt.cfg).to(device) + model.train() + + # Profile + if opt.profile: + img = torch.rand(8 if torch.cuda.is_available() else 1, 3, 640, 640).to(device) + y = model(img, profile=True) + + # Test all models + if opt.test: + for cfg in Path(ROOT / 'models').rglob('yolo*.yaml'): + try: + _ = Model(cfg) + except Exception as e: + print(f'Error in {cfg}: {e}') + + # Tensorboard (not working https://github.com/ultralytics/yolov5/issues/2898) + # from torch.utils.tensorboard import SummaryWriter + # tb_writer = SummaryWriter('.') + # LOGGER.info("Run 'tensorboard --logdir=models' to view tensorboard at http://localhost:6006/") + # tb_writer.add_graph(torch.jit.trace(model, img, strict=False), []) # add model graph diff --git a/yolov5_Monocular_social_ranging/models/yolov5l.yaml b/yolov5_Monocular_social_ranging/models/yolov5l.yaml new file mode 100644 index 0000000..ce8a5de --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/yolov5l.yaml @@ -0,0 +1,48 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 1.0 # model depth multiple +width_multiple: 1.0 # layer channel multiple +anchors: + - [10,13, 16,30, 33,23] # P3/8 + - [30,61, 62,45, 59,119] # P4/16 + - [116,90, 156,198, 373,326] # P5/32 + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [64, 6, 2, 2]], # 0-P1/2 + [-1, 1, Conv, [128, 3, 2]], # 1-P2/4 + [-1, 3, C3, [128]], + [-1, 1, Conv, [256, 3, 2]], # 3-P3/8 + [-1, 6, C3, [256]], + [-1, 1, Conv, [512, 3, 2]], # 5-P4/16 + [-1, 9, C3, [512]], + [-1, 1, Conv, [1024, 3, 2]], # 7-P5/32 + [-1, 3, C3, [1024]], + [-1, 1, SPPF, [1024, 5]], # 9 + ] + +# YOLOv5 v6.0 head +head: + [[-1, 1, Conv, [512, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P4 + [-1, 3, C3, [512, False]], # 13 + + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 4], 1, Concat, [1]], # cat backbone P3 + [-1, 3, C3, [256, False]], # 17 (P3/8-small) + + [-1, 1, Conv, [256, 3, 2]], + [[-1, 14], 1, Concat, [1]], # cat head P4 + [-1, 3, C3, [512, False]], # 20 (P4/16-medium) + + [-1, 1, Conv, [512, 3, 2]], + [[-1, 10], 1, Concat, [1]], # cat head P5 + [-1, 3, C3, [1024, False]], # 23 (P5/32-large) + + [[17, 20, 23], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5) + ] diff --git a/yolov5_Monocular_social_ranging/models/yolov5m.yaml b/yolov5_Monocular_social_ranging/models/yolov5m.yaml new file mode 100644 index 0000000..ad13ab3 --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/yolov5m.yaml @@ -0,0 +1,48 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 0.67 # model depth multiple +width_multiple: 0.75 # layer channel multiple +anchors: + - [10,13, 16,30, 33,23] # P3/8 + - [30,61, 62,45, 59,119] # P4/16 + - [116,90, 156,198, 373,326] # P5/32 + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [64, 6, 2, 2]], # 0-P1/2 + [-1, 1, Conv, [128, 3, 2]], # 1-P2/4 + [-1, 3, C3, [128]], + [-1, 1, Conv, [256, 3, 2]], # 3-P3/8 + [-1, 6, C3, [256]], + [-1, 1, Conv, [512, 3, 2]], # 5-P4/16 + [-1, 9, C3, [512]], + [-1, 1, Conv, [1024, 3, 2]], # 7-P5/32 + [-1, 3, C3, [1024]], + [-1, 1, SPPF, [1024, 5]], # 9 + ] + +# YOLOv5 v6.0 head +head: + [[-1, 1, Conv, [512, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P4 + [-1, 3, C3, [512, False]], # 13 + + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 4], 1, Concat, [1]], # cat backbone P3 + [-1, 3, C3, [256, False]], # 17 (P3/8-small) + + [-1, 1, Conv, [256, 3, 2]], + [[-1, 14], 1, Concat, [1]], # cat head P4 + [-1, 3, C3, [512, False]], # 20 (P4/16-medium) + + [-1, 1, Conv, [512, 3, 2]], + [[-1, 10], 1, Concat, [1]], # cat head P5 + [-1, 3, C3, [1024, False]], # 23 (P5/32-large) + + [[17, 20, 23], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5) + ] diff --git a/yolov5_Monocular_social_ranging/models/yolov5n.yaml b/yolov5_Monocular_social_ranging/models/yolov5n.yaml new file mode 100644 index 0000000..8a28a40 --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/yolov5n.yaml @@ -0,0 +1,48 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 0.33 # model depth multiple +width_multiple: 0.25 # layer channel multiple +anchors: + - [10,13, 16,30, 33,23] # P3/8 + - [30,61, 62,45, 59,119] # P4/16 + - [116,90, 156,198, 373,326] # P5/32 + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [64, 6, 2, 2]], # 0-P1/2 + [-1, 1, Conv, [128, 3, 2]], # 1-P2/4 + [-1, 3, C3, [128]], + [-1, 1, Conv, [256, 3, 2]], # 3-P3/8 + [-1, 6, C3, [256]], + [-1, 1, Conv, [512, 3, 2]], # 5-P4/16 + [-1, 9, C3, [512]], + [-1, 1, Conv, [1024, 3, 2]], # 7-P5/32 + [-1, 3, C3, [1024]], + [-1, 1, SPPF, [1024, 5]], # 9 + ] + +# YOLOv5 v6.0 head +head: + [[-1, 1, Conv, [512, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P4 + [-1, 3, C3, [512, False]], # 13 + + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 4], 1, Concat, [1]], # cat backbone P3 + [-1, 3, C3, [256, False]], # 17 (P3/8-small) + + [-1, 1, Conv, [256, 3, 2]], + [[-1, 14], 1, Concat, [1]], # cat head P4 + [-1, 3, C3, [512, False]], # 20 (P4/16-medium) + + [-1, 1, Conv, [512, 3, 2]], + [[-1, 10], 1, Concat, [1]], # cat head P5 + [-1, 3, C3, [1024, False]], # 23 (P5/32-large) + + [[17, 20, 23], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5) + ] diff --git a/yolov5_Monocular_social_ranging/models/yolov5s.yaml b/yolov5_Monocular_social_ranging/models/yolov5s.yaml new file mode 100644 index 0000000..f35beab --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/yolov5s.yaml @@ -0,0 +1,48 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 0.33 # model depth multiple +width_multiple: 0.50 # layer channel multiple +anchors: + - [10,13, 16,30, 33,23] # P3/8 + - [30,61, 62,45, 59,119] # P4/16 + - [116,90, 156,198, 373,326] # P5/32 + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [64, 6, 2, 2]], # 0-P1/2 + [-1, 1, Conv, [128, 3, 2]], # 1-P2/4 + [-1, 3, C3, [128]], + [-1, 1, Conv, [256, 3, 2]], # 3-P3/8 + [-1, 6, C3, [256]], + [-1, 1, Conv, [512, 3, 2]], # 5-P4/16 + [-1, 9, C3, [512]], + [-1, 1, Conv, [1024, 3, 2]], # 7-P5/32 + [-1, 3, C3, [1024]], + [-1, 1, SPPF, [1024, 5]], # 9 + ] + +# YOLOv5 v6.0 head +head: + [[-1, 1, Conv, [512, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P4 + [-1, 3, C3, [512, False]], # 13 + + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 4], 1, Concat, [1]], # cat backbone P3 + [-1, 3, C3, [256, False]], # 17 (P3/8-small) + + [-1, 1, Conv, [256, 3, 2]], + [[-1, 14], 1, Concat, [1]], # cat head P4 + [-1, 3, C3, [512, False]], # 20 (P4/16-medium) + + [-1, 1, Conv, [512, 3, 2]], + [[-1, 10], 1, Concat, [1]], # cat head P5 + [-1, 3, C3, [1024, False]], # 23 (P5/32-large) + + [[17, 20, 23], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5) + ] diff --git a/yolov5_Monocular_social_ranging/models/yolov5x.yaml b/yolov5_Monocular_social_ranging/models/yolov5x.yaml new file mode 100644 index 0000000..f617a02 --- /dev/null +++ b/yolov5_Monocular_social_ranging/models/yolov5x.yaml @@ -0,0 +1,48 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license + +# Parameters +nc: 80 # number of classes +depth_multiple: 1.33 # model depth multiple +width_multiple: 1.25 # layer channel multiple +anchors: + - [10,13, 16,30, 33,23] # P3/8 + - [30,61, 62,45, 59,119] # P4/16 + - [116,90, 156,198, 373,326] # P5/32 + +# YOLOv5 v6.0 backbone +backbone: + # [from, number, module, args] + [[-1, 1, Conv, [64, 6, 2, 2]], # 0-P1/2 + [-1, 1, Conv, [128, 3, 2]], # 1-P2/4 + [-1, 3, C3, [128]], + [-1, 1, Conv, [256, 3, 2]], # 3-P3/8 + [-1, 6, C3, [256]], + [-1, 1, Conv, [512, 3, 2]], # 5-P4/16 + [-1, 9, C3, [512]], + [-1, 1, Conv, [1024, 3, 2]], # 7-P5/32 + [-1, 3, C3, [1024]], + [-1, 1, SPPF, [1024, 5]], # 9 + ] + +# YOLOv5 v6.0 head +head: + [[-1, 1, Conv, [512, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 6], 1, Concat, [1]], # cat backbone P4 + [-1, 3, C3, [512, False]], # 13 + + [-1, 1, Conv, [256, 1, 1]], + [-1, 1, nn.Upsample, [None, 2, 'nearest']], + [[-1, 4], 1, Concat, [1]], # cat backbone P3 + [-1, 3, C3, [256, False]], # 17 (P3/8-small) + + [-1, 1, Conv, [256, 3, 2]], + [[-1, 14], 1, Concat, [1]], # cat head P4 + [-1, 3, C3, [512, False]], # 20 (P4/16-medium) + + [-1, 1, Conv, [512, 3, 2]], + [[-1, 10], 1, Concat, [1]], # cat head P5 + [-1, 3, C3, [1024, False]], # 23 (P5/32-large) + + [[17, 20, 23], 1, Detect, [nc, anchors]], # Detect(P3, P4, P5) + ] diff --git a/yolov5_Monocular_social_ranging/requirements.txt b/yolov5_Monocular_social_ranging/requirements.txt new file mode 100644 index 0000000..96fc9d1 --- /dev/null +++ b/yolov5_Monocular_social_ranging/requirements.txt @@ -0,0 +1,37 @@ +# pip install -r requirements.txt + +# Base ---------------------------------------- +matplotlib>=3.2.2 +numpy>=1.18.5 +opencv-python>=4.1.2 +Pillow>=7.1.2 +PyYAML>=5.3.1 +requests>=2.23.0 +scipy>=1.4.1 +torch>=1.7.0 +torchvision>=0.8.1 +tqdm>=4.41.0 + +# Logging ------------------------------------- +tensorboard>=2.4.1 +# wandb + +# Plotting ------------------------------------ +pandas>=1.1.4 +seaborn>=0.11.0 + +# Export -------------------------------------- +# coremltools>=4.1 # CoreML export +# onnx>=1.9.0 # ONNX export +# onnx-simplifier>=0.3.6 # ONNX simplifier +# scikit-learn==0.19.2 # CoreML quantization +# tensorflow>=2.4.1 # TFLite export +# tensorflowjs>=3.9.0 # TF.js export +# openvino-dev # OpenVINO export + +# Extras -------------------------------------- +# albumentations>=1.0.3 +# Cython # for pycocotools https://github.com/cocodataset/cocoapi/issues/172 +# pycocotools>=2.0 # COCO mAP +# roboflow +thop # FLOPs computation diff --git a/yolov5_Monocular_social_ranging/setup.cfg b/yolov5_Monocular_social_ranging/setup.cfg new file mode 100644 index 0000000..20ea49a --- /dev/null +++ b/yolov5_Monocular_social_ranging/setup.cfg @@ -0,0 +1,45 @@ +# Project-wide configuration file, can be used for package metadata and other toll configurations +# Example usage: global configuration for PEP8 (via flake8) setting or default pytest arguments + +[metadata] +license_file = LICENSE +description-file = README.md + + +[tool:pytest] +norecursedirs = + .git + dist + build +addopts = + --doctest-modules + --durations=25 + --color=yes + + +[flake8] +max-line-length = 120 +exclude = .tox,*.egg,build,temp +select = E,W,F +doctests = True +verbose = 2 +# https://pep8.readthedocs.io/en/latest/intro.html#error-codes +format = pylint +# see: https://www.flake8rules.com/ +ignore = + E731 # Do not assign a lambda expression, use a def + F405 # name may be undefined, or defined from star imports: module + E402 # module level import not at top of file + F401 # module imported but unused + W504 # line break after binary operator + E127 # continuation line over-indented for visual indent + W504 # line break after binary operator + E231 # missing whitespace after ‘,’, ‘;’, or ‘:’ + E501 # line too long + F403 # ‘from module import *’ used; unable to detect undefined names + + +[isort] +# https://pycqa.github.io/isort/docs/configuration/options.html +line_length = 120 +multi_line_output = 0 diff --git a/yolov5_Monocular_social_ranging/train.py b/yolov5_Monocular_social_ranging/train.py new file mode 100644 index 0000000..d8df31b --- /dev/null +++ b/yolov5_Monocular_social_ranging/train.py @@ -0,0 +1,643 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +Train a YOLOv5 model on a custom dataset. + +Models and datasets download automatically from the latest YOLOv5 release. +Models: https://github.com/ultralytics/yolov5/tree/master/models +Datasets: https://github.com/ultralytics/yolov5/tree/master/data +Tutorial: https://github.com/ultralytics/yolov5/wiki/Train-Custom-Data + +Usage: + $ python path/to/train.py --data coco128.yaml --weights yolov5s.pt --img 640 # from pretrained (RECOMMENDED) + $ python path/to/train.py --data coco128.yaml --weights '' --cfg yolov5s.yaml --img 640 # from scratch +""" + +import argparse +import math +import os +import random +import sys +import time +from copy import deepcopy +from datetime import datetime +from pathlib import Path + +import numpy as np +import torch +import torch.distributed as dist +import torch.nn as nn +import yaml +from torch.cuda import amp +from torch.nn.parallel import DistributedDataParallel as DDP +from torch.optim import SGD, Adam, AdamW, lr_scheduler +from tqdm import tqdm + +FILE = Path(__file__).resolve() +ROOT = FILE.parents[0] # YOLOv5 root directory +if str(ROOT) not in sys.path: + sys.path.append(str(ROOT)) # add ROOT to PATH +ROOT = Path(os.path.relpath(ROOT, Path.cwd())) # relative + +import val # for end-of-epoch mAP +from models.experimental import attempt_load +from models.yolo import Model +from utils.autoanchor import check_anchors +from utils.autobatch import check_train_batch_size +from utils.callbacks import Callbacks +from utils.datasets import create_dataloader +from utils.downloads import attempt_download +from utils.general import (LOGGER, check_dataset, check_file, check_git_status, check_img_size, check_requirements, + check_suffix, check_yaml, colorstr, get_latest_run, increment_path, init_seeds, + intersect_dicts, labels_to_class_weights, labels_to_image_weights, methods, one_cycle, + print_args, print_mutation, strip_optimizer) +from utils.loggers import Loggers +from utils.loggers.wandb.wandb_utils import check_wandb_resume +from utils.loss import ComputeLoss +from utils.metrics import fitness +from utils.plots import plot_evolve, plot_labels +from utils.torch_utils import EarlyStopping, ModelEMA, de_parallel, select_device, torch_distributed_zero_first + +LOCAL_RANK = int(os.getenv('LOCAL_RANK', -1)) # https://pytorch.org/docs/stable/elastic/run.html +RANK = int(os.getenv('RANK', -1)) +WORLD_SIZE = int(os.getenv('WORLD_SIZE', 1)) + + +def train(hyp, # path/to/hyp.yaml or hyp dictionary + opt, + device, + callbacks + ): + save_dir, epochs, batch_size, weights, single_cls, evolve, data, cfg, resume, noval, nosave, workers, freeze = \ + Path(opt.save_dir), opt.epochs, opt.batch_size, opt.weights, opt.single_cls, opt.evolve, opt.data, opt.cfg, \ + opt.resume, opt.noval, opt.nosave, opt.workers, opt.freeze + + # Directories + w = save_dir / 'weights' # weights dir + (w.parent if evolve else w).mkdir(parents=True, exist_ok=True) # make dir + last, best = w / 'last.pt', w / 'best.pt' + + # Hyperparameters + if isinstance(hyp, str): + with open(hyp, errors='ignore') as f: + hyp = yaml.safe_load(f) # load hyps dict + LOGGER.info(colorstr('hyperparameters: ') + ', '.join(f'{k}={v}' for k, v in hyp.items())) + + # Save run settings + if not evolve: + with open(save_dir / 'hyp.yaml', 'w') as f: + yaml.safe_dump(hyp, f, sort_keys=False) + with open(save_dir / 'opt.yaml', 'w') as f: + yaml.safe_dump(vars(opt), f, sort_keys=False) + + # Loggers + data_dict = None + if RANK in [-1, 0]: + loggers = Loggers(save_dir, weights, opt, hyp, LOGGER) # loggers instance + if loggers.wandb: + data_dict = loggers.wandb.data_dict + if resume: + weights, epochs, hyp, batch_size = opt.weights, opt.epochs, opt.hyp, opt.batch_size + + # Register actions + for k in methods(loggers): + callbacks.register_action(k, callback=getattr(loggers, k)) + + # Config + plots = not evolve # create plots + cuda = device.type != 'cpu' + init_seeds(1 + RANK) + with torch_distributed_zero_first(LOCAL_RANK): + data_dict = data_dict or check_dataset(data) # check if None + train_path, val_path = data_dict['train'], data_dict['val'] + nc = 1 if single_cls else int(data_dict['nc']) # number of classes + names = ['item'] if single_cls and len(data_dict['names']) != 1 else data_dict['names'] # class names + assert len(names) == nc, f'{len(names)} names found for nc={nc} dataset in {data}' # check + is_coco = isinstance(val_path, str) and val_path.endswith('coco/val2017.txt') # COCO dataset + + # Model + check_suffix(weights, '.pt') # check weights + pretrained = weights.endswith('.pt') + if pretrained: + with torch_distributed_zero_first(LOCAL_RANK): + weights = attempt_download(weights) # download if not found locally + ckpt = torch.load(weights, map_location='cpu') # load checkpoint to CPU to avoid CUDA memory leak + model = Model(cfg or ckpt['model'].yaml, ch=3, nc=nc, anchors=hyp.get('anchors')).to(device) # create + exclude = ['anchor'] if (cfg or hyp.get('anchors')) and not resume else [] # exclude keys + csd = ckpt['model'].float().state_dict() # checkpoint state_dict as FP32 + csd = intersect_dicts(csd, model.state_dict(), exclude=exclude) # intersect + model.load_state_dict(csd, strict=False) # load + LOGGER.info(f'Transferred {len(csd)}/{len(model.state_dict())} items from {weights}') # report + else: + model = Model(cfg, ch=3, nc=nc, anchors=hyp.get('anchors')).to(device) # create + + # Freeze + freeze = [f'model.{x}.' for x in (freeze if len(freeze) > 1 else range(freeze[0]))] # layers to freeze + for k, v in model.named_parameters(): + v.requires_grad = True # train all layers + if any(x in k for x in freeze): + LOGGER.info(f'freezing {k}') + v.requires_grad = False + + # Image size + gs = max(int(model.stride.max()), 32) # grid size (max stride) + imgsz = check_img_size(opt.imgsz, gs, floor=gs * 2) # verify imgsz is gs-multiple + + # Batch size + if RANK == -1 and batch_size == -1: # single-GPU only, estimate best batch size + batch_size = check_train_batch_size(model, imgsz) + loggers.on_params_update({"batch_size": batch_size}) + + # Optimizer + nbs = 64 # nominal batch size + accumulate = max(round(nbs / batch_size), 1) # accumulate loss before optimizing + hyp['weight_decay'] *= batch_size * accumulate / nbs # scale weight_decay + LOGGER.info(f"Scaled weight_decay = {hyp['weight_decay']}") + + g0, g1, g2 = [], [], [] # optimizer parameter groups + for v in model.modules(): + if hasattr(v, 'bias') and isinstance(v.bias, nn.Parameter): # bias + g2.append(v.bias) + if isinstance(v, nn.BatchNorm2d): # weight (no decay) + g0.append(v.weight) + elif hasattr(v, 'weight') and isinstance(v.weight, nn.Parameter): # weight (with decay) + g1.append(v.weight) + + if opt.optimizer == 'Adam': + optimizer = Adam(g0, lr=hyp['lr0'], betas=(hyp['momentum'], 0.999)) # adjust beta1 to momentum + elif opt.optimizer == 'AdamW': + optimizer = AdamW(g0, lr=hyp['lr0'], betas=(hyp['momentum'], 0.999)) # adjust beta1 to momentum + else: + optimizer = SGD(g0, lr=hyp['lr0'], momentum=hyp['momentum'], nesterov=True) + + optimizer.add_param_group({'params': g1, 'weight_decay': hyp['weight_decay']}) # add g1 with weight_decay + optimizer.add_param_group({'params': g2}) # add g2 (biases) + LOGGER.info(f"{colorstr('optimizer:')} {type(optimizer).__name__} with parameter groups " + f"{len(g0)} weight (no decay), {len(g1)} weight, {len(g2)} bias") + del g0, g1, g2 + + # Scheduler + if opt.cos_lr: + lf = one_cycle(1, hyp['lrf'], epochs) # cosine 1->hyp['lrf'] + else: + lf = lambda x: (1 - x / epochs) * (1.0 - hyp['lrf']) + hyp['lrf'] # linear + scheduler = lr_scheduler.LambdaLR(optimizer, lr_lambda=lf) # plot_lr_scheduler(optimizer, scheduler, epochs) + + # EMA + ema = ModelEMA(model) if RANK in [-1, 0] else None + + # Resume + start_epoch, best_fitness = 0, 0.0 + if pretrained: + # Optimizer + if ckpt['optimizer'] is not None: + optimizer.load_state_dict(ckpt['optimizer']) + best_fitness = ckpt['best_fitness'] + + # EMA + if ema and ckpt.get('ema'): + ema.ema.load_state_dict(ckpt['ema'].float().state_dict()) + ema.updates = ckpt['updates'] + + # Epochs + start_epoch = ckpt['epoch'] + 1 + if resume: + assert start_epoch > 0, f'{weights} training to {epochs} epochs is finished, nothing to resume.' + if epochs < start_epoch: + LOGGER.info(f"{weights} has been trained for {ckpt['epoch']} epochs. Fine-tuning for {epochs} more epochs.") + epochs += ckpt['epoch'] # finetune additional epochs + + del ckpt, csd + + # DP mode + if cuda and RANK == -1 and torch.cuda.device_count() > 1: + LOGGER.warning('WARNING: DP not recommended, use torch.distributed.run for best DDP Multi-GPU results.\n' + 'See Multi-GPU Tutorial at https://github.com/ultralytics/yolov5/issues/475 to get started.') + model = torch.nn.DataParallel(model) + + # SyncBatchNorm + if opt.sync_bn and cuda and RANK != -1: + model = torch.nn.SyncBatchNorm.convert_sync_batchnorm(model).to(device) + LOGGER.info('Using SyncBatchNorm()') + + # Trainloader + train_loader, dataset = create_dataloader(train_path, imgsz, batch_size // WORLD_SIZE, gs, single_cls, + hyp=hyp, augment=True, cache=None if opt.cache == 'val' else opt.cache, + rect=opt.rect, rank=LOCAL_RANK, workers=workers, + image_weights=opt.image_weights, quad=opt.quad, + prefix=colorstr('train: '), shuffle=True) + mlc = int(np.concatenate(dataset.labels, 0)[:, 0].max()) # max label class + nb = len(train_loader) # number of batches + assert mlc < nc, f'Label class {mlc} exceeds nc={nc} in {data}. Possible class labels are 0-{nc - 1}' + + # Process 0 + if RANK in [-1, 0]: + val_loader = create_dataloader(val_path, imgsz, batch_size // WORLD_SIZE * 2, gs, single_cls, + hyp=hyp, cache=None if noval else opt.cache, + rect=True, rank=-1, workers=workers * 2, pad=0.5, + prefix=colorstr('val: '))[0] + + if not resume: + labels = np.concatenate(dataset.labels, 0) + # c = torch.tensor(labels[:, 0]) # classes + # cf = torch.bincount(c.long(), minlength=nc) + 1. # frequency + # model._initialize_biases(cf.to(device)) + if plots: + plot_labels(labels, names, save_dir) + + # Anchors + if not opt.noautoanchor: + check_anchors(dataset, model=model, thr=hyp['anchor_t'], imgsz=imgsz) + model.half().float() # pre-reduce anchor precision + + callbacks.run('on_pretrain_routine_end') + + # DDP mode + if cuda and RANK != -1: + model = DDP(model, device_ids=[LOCAL_RANK], output_device=LOCAL_RANK) + + # Model attributes + nl = de_parallel(model).model[-1].nl # number of detection layers (to scale hyps) + hyp['box'] *= 3 / nl # scale to layers + hyp['cls'] *= nc / 80 * 3 / nl # scale to classes and layers + hyp['obj'] *= (imgsz / 640) ** 2 * 3 / nl # scale to image size and layers + hyp['label_smoothing'] = opt.label_smoothing + model.nc = nc # attach number of classes to model + model.hyp = hyp # attach hyperparameters to model + model.class_weights = labels_to_class_weights(dataset.labels, nc).to(device) * nc # attach class weights + model.names = names + + # Start training + t0 = time.time() + nw = max(round(hyp['warmup_epochs'] * nb), 1000) # number of warmup iterations, max(3 epochs, 1k iterations) + # nw = min(nw, (epochs - start_epoch) / 2 * nb) # limit warmup to < 1/2 of training + last_opt_step = -1 + maps = np.zeros(nc) # mAP per class + results = (0, 0, 0, 0, 0, 0, 0) # P, R, mAP@.5, mAP@.5-.95, val_loss(box, obj, cls) + scheduler.last_epoch = start_epoch - 1 # do not move + scaler = amp.GradScaler(enabled=cuda) + stopper = EarlyStopping(patience=opt.patience) + compute_loss = ComputeLoss(model) # init loss class + LOGGER.info(f'Image sizes {imgsz} train, {imgsz} val\n' + f'Using {train_loader.num_workers * WORLD_SIZE} dataloader workers\n' + f"Logging results to {colorstr('bold', save_dir)}\n" + f'Starting training for {epochs} epochs...') + for epoch in range(start_epoch, epochs): # epoch ------------------------------------------------------------------ + model.train() + + # Update image weights (optional, single-GPU only) + if opt.image_weights: + cw = model.class_weights.cpu().numpy() * (1 - maps) ** 2 / nc # class weights + iw = labels_to_image_weights(dataset.labels, nc=nc, class_weights=cw) # image weights + dataset.indices = random.choices(range(dataset.n), weights=iw, k=dataset.n) # rand weighted idx + + # Update mosaic border (optional) + # b = int(random.uniform(0.25 * imgsz, 0.75 * imgsz + gs) // gs * gs) + # dataset.mosaic_border = [b - imgsz, -b] # height, width borders + + mloss = torch.zeros(3, device=device) # mean losses + if RANK != -1: + train_loader.sampler.set_epoch(epoch) + pbar = enumerate(train_loader) + LOGGER.info(('\n' + '%10s' * 7) % ('Epoch', 'gpu_mem', 'box', 'obj', 'cls', 'labels', 'img_size')) + if RANK in [-1, 0]: + pbar = tqdm(pbar, total=nb, bar_format='{l_bar}{bar:10}{r_bar}{bar:-10b}') # progress bar + optimizer.zero_grad() + for i, (imgs, targets, paths, _) in pbar: # batch ------------------------------------------------------------- + ni = i + nb * epoch # number integrated batches (since train start) + imgs = imgs.to(device, non_blocking=True).float() / 255 # uint8 to float32, 0-255 to 0.0-1.0 + + # Warmup + if ni <= nw: + xi = [0, nw] # x interp + # compute_loss.gr = np.interp(ni, xi, [0.0, 1.0]) # iou loss ratio (obj_loss = 1.0 or iou) + accumulate = max(1, np.interp(ni, xi, [1, nbs / batch_size]).round()) + for j, x in enumerate(optimizer.param_groups): + # bias lr falls from 0.1 to lr0, all other lrs rise from 0.0 to lr0 + x['lr'] = np.interp(ni, xi, [hyp['warmup_bias_lr'] if j == 2 else 0.0, x['initial_lr'] * lf(epoch)]) + if 'momentum' in x: + x['momentum'] = np.interp(ni, xi, [hyp['warmup_momentum'], hyp['momentum']]) + + # Multi-scale + if opt.multi_scale: + sz = random.randrange(imgsz * 0.5, imgsz * 1.5 + gs) // gs * gs # size + sf = sz / max(imgs.shape[2:]) # scale factor + if sf != 1: + ns = [math.ceil(x * sf / gs) * gs for x in imgs.shape[2:]] # new shape (stretched to gs-multiple) + imgs = nn.functional.interpolate(imgs, size=ns, mode='bilinear', align_corners=False) + + # Forward + with amp.autocast(enabled=cuda): + pred = model(imgs) # forward + loss, loss_items = compute_loss(pred, targets.to(device)) # loss scaled by batch_size + if RANK != -1: + loss *= WORLD_SIZE # gradient averaged between devices in DDP mode + if opt.quad: + loss *= 4. + + # Backward + scaler.scale(loss).backward() + + # Optimize + if ni - last_opt_step >= accumulate: + scaler.step(optimizer) # optimizer.step + scaler.update() + optimizer.zero_grad() + if ema: + ema.update(model) + last_opt_step = ni + + # Log + if RANK in [-1, 0]: + mloss = (mloss * i + loss_items) / (i + 1) # update mean losses + mem = f'{torch.cuda.memory_reserved() / 1E9 if torch.cuda.is_available() else 0:.3g}G' # (GB) + pbar.set_description(('%10s' * 2 + '%10.4g' * 5) % ( + f'{epoch}/{epochs - 1}', mem, *mloss, targets.shape[0], imgs.shape[-1])) + callbacks.run('on_train_batch_end', ni, model, imgs, targets, paths, plots, opt.sync_bn) + if callbacks.stop_training: + return + # end batch ------------------------------------------------------------------------------------------------ + + # Scheduler + lr = [x['lr'] for x in optimizer.param_groups] # for loggers + scheduler.step() + + if RANK in [-1, 0]: + # mAP + callbacks.run('on_train_epoch_end', epoch=epoch) + ema.update_attr(model, include=['yaml', 'nc', 'hyp', 'names', 'stride', 'class_weights']) + final_epoch = (epoch + 1 == epochs) or stopper.possible_stop + if not noval or final_epoch: # Calculate mAP + results, maps, _ = val.run(data_dict, + batch_size=batch_size // WORLD_SIZE * 2, + imgsz=imgsz, + model=ema.ema, + single_cls=single_cls, + dataloader=val_loader, + save_dir=save_dir, + plots=False, + callbacks=callbacks, + compute_loss=compute_loss) + + # Update best mAP + fi = fitness(np.array(results).reshape(1, -1)) # weighted combination of [P, R, mAP@.5, mAP@.5-.95] + if fi > best_fitness: + best_fitness = fi + log_vals = list(mloss) + list(results) + lr + callbacks.run('on_fit_epoch_end', log_vals, epoch, best_fitness, fi) + + # Save model + if (not nosave) or (final_epoch and not evolve): # if save + ckpt = {'epoch': epoch, + 'best_fitness': best_fitness, + 'model': deepcopy(de_parallel(model)).half(), + 'ema': deepcopy(ema.ema).half(), + 'updates': ema.updates, + 'optimizer': optimizer.state_dict(), + 'wandb_id': loggers.wandb.wandb_run.id if loggers.wandb else None, + 'date': datetime.now().isoformat()} + + # Save last, best and delete + torch.save(ckpt, last) + if best_fitness == fi: + torch.save(ckpt, best) + if (epoch > 0) and (opt.save_period > 0) and (epoch % opt.save_period == 0): + torch.save(ckpt, w / f'epoch{epoch}.pt') + del ckpt + callbacks.run('on_model_save', last, epoch, final_epoch, best_fitness, fi) + + # Stop Single-GPU + if RANK == -1 and stopper(epoch=epoch, fitness=fi): + break + + # Stop DDP TODO: known issues shttps://github.com/ultralytics/yolov5/pull/4576 + # stop = stopper(epoch=epoch, fitness=fi) + # if RANK == 0: + # dist.broadcast_object_list([stop], 0) # broadcast 'stop' to all ranks + + # Stop DPP + # with torch_distributed_zero_first(RANK): + # if stop: + # break # must break all DDP ranks + + # end epoch ---------------------------------------------------------------------------------------------------- + # end training ----------------------------------------------------------------------------------------------------- + if RANK in [-1, 0]: + LOGGER.info(f'\n{epoch - start_epoch + 1} epochs completed in {(time.time() - t0) / 3600:.3f} hours.') + for f in last, best: + if f.exists(): + strip_optimizer(f) # strip optimizers + if f is best: + LOGGER.info(f'\nValidating {f}...') + results, _, _ = val.run(data_dict, + batch_size=batch_size // WORLD_SIZE * 2, + imgsz=imgsz, + model=attempt_load(f, device).half(), + iou_thres=0.65 if is_coco else 0.60, # best pycocotools results at 0.65 + single_cls=single_cls, + dataloader=val_loader, + save_dir=save_dir, + save_json=is_coco, + verbose=True, + plots=True, + callbacks=callbacks, + compute_loss=compute_loss) # val best model with plots + if is_coco: + callbacks.run('on_fit_epoch_end', list(mloss) + list(results) + lr, epoch, best_fitness, fi) + + callbacks.run('on_train_end', last, best, plots, epoch, results) + LOGGER.info(f"Results saved to {colorstr('bold', save_dir)}") + + torch.cuda.empty_cache() + return results + + +def parse_opt(known=False): + parser = argparse.ArgumentParser() + parser.add_argument('--weights', type=str, default=ROOT / 'yolov5s.pt', help='initial weights path') + parser.add_argument('--cfg', type=str, default='', help='model.yaml path') + parser.add_argument('--data', type=str, default=ROOT / 'data/coco128.yaml', help='dataset.yaml path') + parser.add_argument('--hyp', type=str, default=ROOT / 'data/hyps/hyp.scratch-low.yaml', help='hyperparameters path') + parser.add_argument('--epochs', type=int, default=300) + parser.add_argument('--batch-size', type=int, default=16, help='total batch size for all GPUs, -1 for autobatch') + parser.add_argument('--imgsz', '--img', '--img-size', type=int, default=640, help='train, val image size (pixels)') + parser.add_argument('--rect', action='store_true', help='rectangular training') + parser.add_argument('--resume', nargs='?', const=True, default=False, help='resume most recent training') + parser.add_argument('--nosave', action='store_true', help='only save final checkpoint') + parser.add_argument('--noval', action='store_true', help='only validate final epoch') + parser.add_argument('--noautoanchor', action='store_true', help='disable AutoAnchor') + parser.add_argument('--evolve', type=int, nargs='?', const=300, help='evolve hyperparameters for x generations') + parser.add_argument('--bucket', type=str, default='', help='gsutil bucket') + parser.add_argument('--cache', type=str, nargs='?', const='ram', help='--cache images in "ram" (default) or "disk"') + parser.add_argument('--image-weights', action='store_true', help='use weighted image selection for training') + parser.add_argument('--device', default='', help='cuda device, i.e. 0 or 0,1,2,3 or cpu') + parser.add_argument('--multi-scale', action='store_true', help='vary img-size +/- 50%%') + parser.add_argument('--single-cls', action='store_true', help='train multi-class data as single-class') + parser.add_argument('--optimizer', type=str, choices=['SGD', 'Adam', 'AdamW'], default='SGD', help='optimizer') + parser.add_argument('--sync-bn', action='store_true', help='use SyncBatchNorm, only available in DDP mode') + parser.add_argument('--workers', type=int, default=8, help='max dataloader workers (per RANK in DDP mode)') + parser.add_argument('--project', default=ROOT / 'runs/train', help='save to project/name') + parser.add_argument('--name', default='exp', help='save to project/name') + parser.add_argument('--exist-ok', action='store_true', help='existing project/name ok, do not increment') + parser.add_argument('--quad', action='store_true', help='quad dataloader') + parser.add_argument('--cos-lr', action='store_true', help='cosine LR scheduler') + parser.add_argument('--label-smoothing', type=float, default=0.0, help='Label smoothing epsilon') + parser.add_argument('--patience', type=int, default=100, help='EarlyStopping patience (epochs without improvement)') + parser.add_argument('--freeze', nargs='+', type=int, default=[0], help='Freeze layers: backbone=10, first3=0 1 2') + parser.add_argument('--save-period', type=int, default=-1, help='Save checkpoint every x epochs (disabled if < 1)') + parser.add_argument('--local_rank', type=int, default=-1, help='DDP parameter, do not modify') + + # Weights & Biases arguments + parser.add_argument('--entity', default=None, help='W&B: Entity') + parser.add_argument('--upload_dataset', nargs='?', const=True, default=False, help='W&B: Upload data, "val" option') + parser.add_argument('--bbox_interval', type=int, default=-1, help='W&B: Set bounding-box image logging interval') + parser.add_argument('--artifact_alias', type=str, default='latest', help='W&B: Version of dataset artifact to use') + + opt = parser.parse_known_args()[0] if known else parser.parse_args() + return opt + + +def main(opt, callbacks=Callbacks()): + # Checks + if RANK in [-1, 0]: + print_args(FILE.stem, opt) + check_git_status() + check_requirements(exclude=['thop']) + + # Resume + if opt.resume and not check_wandb_resume(opt) and not opt.evolve: # resume an interrupted run + ckpt = opt.resume if isinstance(opt.resume, str) else get_latest_run() # specified or most recent path + assert os.path.isfile(ckpt), 'ERROR: --resume checkpoint does not exist' + with open(Path(ckpt).parent.parent / 'opt.yaml', errors='ignore') as f: + opt = argparse.Namespace(**yaml.safe_load(f)) # replace + opt.cfg, opt.weights, opt.resume = '', ckpt, True # reinstate + LOGGER.info(f'Resuming training from {ckpt}') + else: + opt.data, opt.cfg, opt.hyp, opt.weights, opt.project = \ + check_file(opt.data), check_yaml(opt.cfg), check_yaml(opt.hyp), str(opt.weights), str(opt.project) # checks + assert len(opt.cfg) or len(opt.weights), 'either --cfg or --weights must be specified' + if opt.evolve: + if opt.project == str(ROOT / 'runs/train'): # if default project name, rename to runs/evolve + opt.project = str(ROOT / 'runs/evolve') + opt.exist_ok, opt.resume = opt.resume, False # pass resume to exist_ok and disable resume + opt.save_dir = str(increment_path(Path(opt.project) / opt.name, exist_ok=opt.exist_ok)) + + # DDP mode + device = select_device(opt.device, batch_size=opt.batch_size) + if LOCAL_RANK != -1: + msg = 'is not compatible with YOLOv5 Multi-GPU DDP training' + assert not opt.image_weights, f'--image-weights {msg}' + assert not opt.evolve, f'--evolve {msg}' + assert opt.batch_size != -1, f'AutoBatch with --batch-size -1 {msg}, please pass a valid --batch-size' + assert opt.batch_size % WORLD_SIZE == 0, f'--batch-size {opt.batch_size} must be multiple of WORLD_SIZE' + assert torch.cuda.device_count() > LOCAL_RANK, 'insufficient CUDA devices for DDP command' + torch.cuda.set_device(LOCAL_RANK) + device = torch.device('cuda', LOCAL_RANK) + dist.init_process_group(backend="nccl" if dist.is_nccl_available() else "gloo") + + # Train + if not opt.evolve: + train(opt.hyp, opt, device, callbacks) + if WORLD_SIZE > 1 and RANK == 0: + LOGGER.info('Destroying process group... ') + dist.destroy_process_group() + + # Evolve hyperparameters (optional) + else: + # Hyperparameter evolution metadata (mutation scale 0-1, lower_limit, upper_limit) + meta = {'lr0': (1, 1e-5, 1e-1), # initial learning rate (SGD=1E-2, Adam=1E-3) + 'lrf': (1, 0.01, 1.0), # final OneCycleLR learning rate (lr0 * lrf) + 'momentum': (0.3, 0.6, 0.98), # SGD momentum/Adam beta1 + 'weight_decay': (1, 0.0, 0.001), # optimizer weight decay + 'warmup_epochs': (1, 0.0, 5.0), # warmup epochs (fractions ok) + 'warmup_momentum': (1, 0.0, 0.95), # warmup initial momentum + 'warmup_bias_lr': (1, 0.0, 0.2), # warmup initial bias lr + 'box': (1, 0.02, 0.2), # box loss gain + 'cls': (1, 0.2, 4.0), # cls loss gain + 'cls_pw': (1, 0.5, 2.0), # cls BCELoss positive_weight + 'obj': (1, 0.2, 4.0), # obj loss gain (scale with pixels) + 'obj_pw': (1, 0.5, 2.0), # obj BCELoss positive_weight + 'iou_t': (0, 0.1, 0.7), # IoU training threshold + 'anchor_t': (1, 2.0, 8.0), # anchor-multiple threshold + 'anchors': (2, 2.0, 10.0), # anchors per output grid (0 to ignore) + 'fl_gamma': (0, 0.0, 2.0), # focal loss gamma (efficientDet default gamma=1.5) + 'hsv_h': (1, 0.0, 0.1), # image HSV-Hue augmentation (fraction) + 'hsv_s': (1, 0.0, 0.9), # image HSV-Saturation augmentation (fraction) + 'hsv_v': (1, 0.0, 0.9), # image HSV-Value augmentation (fraction) + 'degrees': (1, 0.0, 45.0), # image rotation (+/- deg) + 'translate': (1, 0.0, 0.9), # image translation (+/- fraction) + 'scale': (1, 0.0, 0.9), # image scale (+/- gain) + 'shear': (1, 0.0, 10.0), # image shear (+/- deg) + 'perspective': (0, 0.0, 0.001), # image perspective (+/- fraction), range 0-0.001 + 'flipud': (1, 0.0, 1.0), # image flip up-down (probability) + 'fliplr': (0, 0.0, 1.0), # image flip left-right (probability) + 'mosaic': (1, 0.0, 1.0), # image mixup (probability) + 'mixup': (1, 0.0, 1.0), # image mixup (probability) + 'copy_paste': (1, 0.0, 1.0)} # segment copy-paste (probability) + + with open(opt.hyp, errors='ignore') as f: + hyp = yaml.safe_load(f) # load hyps dict + if 'anchors' not in hyp: # anchors commented in hyp.yaml + hyp['anchors'] = 3 + opt.noval, opt.nosave, save_dir = True, True, Path(opt.save_dir) # only val/save final epoch + # ei = [isinstance(x, (int, float)) for x in hyp.values()] # evolvable indices + evolve_yaml, evolve_csv = save_dir / 'hyp_evolve.yaml', save_dir / 'evolve.csv' + if opt.bucket: + os.system(f'gsutil cp gs://{opt.bucket}/evolve.csv {evolve_csv}') # download evolve.csv if exists + + for _ in range(opt.evolve): # generations to evolve + if evolve_csv.exists(): # if evolve.csv exists: select best hyps and mutate + # Select parent(s) + parent = 'single' # parent selection method: 'single' or 'weighted' + x = np.loadtxt(evolve_csv, ndmin=2, delimiter=',', skiprows=1) + n = min(5, len(x)) # number of previous results to consider + x = x[np.argsort(-fitness(x))][:n] # top n mutations + w = fitness(x) - fitness(x).min() + 1E-6 # weights (sum > 0) + if parent == 'single' or len(x) == 1: + # x = x[random.randint(0, n - 1)] # random selection + x = x[random.choices(range(n), weights=w)[0]] # weighted selection + elif parent == 'weighted': + x = (x * w.reshape(n, 1)).sum(0) / w.sum() # weighted combination + + # Mutate + mp, s = 0.8, 0.2 # mutation probability, sigma + npr = np.random + npr.seed(int(time.time())) + g = np.array([meta[k][0] for k in hyp.keys()]) # gains 0-1 + ng = len(meta) + v = np.ones(ng) + while all(v == 1): # mutate until a change occurs (prevent duplicates) + v = (g * (npr.random(ng) < mp) * npr.randn(ng) * npr.random() * s + 1).clip(0.3, 3.0) + for i, k in enumerate(hyp.keys()): # plt.hist(v.ravel(), 300) + hyp[k] = float(x[i + 7] * v[i]) # mutate + + # Constrain to limits + for k, v in meta.items(): + hyp[k] = max(hyp[k], v[1]) # lower limit + hyp[k] = min(hyp[k], v[2]) # upper limit + hyp[k] = round(hyp[k], 5) # significant digits + + # Train mutation + results = train(hyp.copy(), opt, device, callbacks) + callbacks = Callbacks() + # Write mutation results + print_mutation(results, hyp.copy(), save_dir, opt.bucket) + + # Plot results + plot_evolve(evolve_csv) + LOGGER.info(f'Hyperparameter evolution finished {opt.evolve} generations\n' + f"Results saved to {colorstr('bold', save_dir)}\n" + f'Usage example: $ python train.py --hyp {evolve_yaml}') + + +def run(**kwargs): + # Usage: import train; train.run(data='coco128.yaml', imgsz=320, weights='yolov5m.pt') + opt = parse_opt(True) + for k, v in kwargs.items(): + setattr(opt, k, v) + main(opt) + return opt + + +if __name__ == "__main__": + opt = parse_opt() + main(opt) diff --git a/yolov5_Monocular_social_ranging/tutorial.ipynb b/yolov5_Monocular_social_ranging/tutorial.ipynb new file mode 100644 index 0000000..09b2b33 --- /dev/null +++ b/yolov5_Monocular_social_ranging/tutorial.ipynb @@ -0,0 +1,1102 @@ +{ + "nbformat": 4, + "nbformat_minor": 0, + "metadata": { + "colab": { + "name": "YOLOv5 Tutorial", + "provenance": [], + "collapsed_sections": [], + "include_colab_link": true + }, + "kernelspec": { + "name": "python3", + "display_name": "Python 3" + }, + "accelerator": "GPU", + "widgets": { + "application/vnd.jupyter.widget-state+json": { + "eb95db7cae194218b3fcefb439b6352f": { + "model_module": "@jupyter-widgets/controls", + "model_name": "HBoxModel", + "model_module_version": "1.5.0", + "state": { + "_view_name": "HBoxView", + "_dom_classes": [], + "_model_name": "HBoxModel", + "_view_module": "@jupyter-widgets/controls", + "_model_module_version": "1.5.0", + "_view_count": null, + "_view_module_version": "1.5.0", + "box_style": "", + "layout": "IPY_MODEL_769ecde6f2e64bacb596ce972f8d3d2d", + "_model_module": "@jupyter-widgets/controls", + "children": [ + "IPY_MODEL_384a001876054c93b0af45cd1e960bfe", + "IPY_MODEL_dded0aeae74440f7ba2ffa0beb8dd612", + "IPY_MODEL_5296d28be75740b2892ae421bbec3657" + ] + } + }, + "769ecde6f2e64bacb596ce972f8d3d2d": { + "model_module": "@jupyter-widgets/base", + "model_name": "LayoutModel", + "model_module_version": "1.2.0", + "state": { + "_view_name": "LayoutView", + "grid_template_rows": null, + "right": null, + "justify_content": null, + "_view_module": "@jupyter-widgets/base", + "overflow": null, + "_model_module_version": "1.2.0", + "_view_count": null, + "flex_flow": null, + "width": null, + "min_width": null, + "border": null, + "align_items": null, + "bottom": null, + "_model_module": "@jupyter-widgets/base", + "top": null, + "grid_column": null, + "overflow_y": null, + "overflow_x": null, + "grid_auto_flow": null, + "grid_area": null, + "grid_template_columns": null, + "flex": null, + "_model_name": "LayoutModel", + "justify_items": null, + "grid_row": null, + "max_height": null, + "align_content": null, + "visibility": null, + "align_self": null, + "height": null, + "min_height": null, + "padding": null, + "grid_auto_rows": null, + "grid_gap": null, + "max_width": null, + "order": null, + "_view_module_version": "1.2.0", + "grid_template_areas": null, + "object_position": null, + "object_fit": null, + "grid_auto_columns": null, + "margin": null, + "display": null, + "left": null + } + }, + "384a001876054c93b0af45cd1e960bfe": { + "model_module": "@jupyter-widgets/controls", + "model_name": "HTMLModel", + "model_module_version": "1.5.0", + "state": { + "_view_name": "HTMLView", + "style": "IPY_MODEL_9f09facb2a6c4a7096810d327c8b551c", + "_dom_classes": [], + "description": "", + "_model_name": "HTMLModel", + "placeholder": "​", + "_view_module": "@jupyter-widgets/controls", + "_model_module_version": "1.5.0", + "value": "100%", + "_view_count": null, + "_view_module_version": "1.5.0", + "description_tooltip": null, + "_model_module": "@jupyter-widgets/controls", + "layout": "IPY_MODEL_25621cff5d16448cb7260e839fd0f543" + } + }, + "dded0aeae74440f7ba2ffa0beb8dd612": { + "model_module": "@jupyter-widgets/controls", + "model_name": "FloatProgressModel", + "model_module_version": "1.5.0", + "state": { + "_view_name": "ProgressView", + "style": "IPY_MODEL_0ce7164fc0c74bb9a2b5c7037375a727", + "_dom_classes": [], + "description": "", + "_model_name": "FloatProgressModel", + "bar_style": "success", + "max": 818322941, + "_view_module": "@jupyter-widgets/controls", + "_model_module_version": "1.5.0", + "value": 818322941, + "_view_count": null, + "_view_module_version": "1.5.0", + "orientation": "horizontal", + "min": 0, + "description_tooltip": null, + "_model_module": "@jupyter-widgets/controls", + "layout": "IPY_MODEL_c4c4593c10904cb5b8a5724d60c7e181" + } + }, + "5296d28be75740b2892ae421bbec3657": { + "model_module": "@jupyter-widgets/controls", + "model_name": "HTMLModel", + "model_module_version": "1.5.0", + "state": { + "_view_name": "HTMLView", + "style": "IPY_MODEL_473371611126476c88d5d42ec7031ed6", + "_dom_classes": [], + "description": "", + "_model_name": "HTMLModel", + "placeholder": "​", + "_view_module": "@jupyter-widgets/controls", + "_model_module_version": "1.5.0", + "value": " 780M/780M [00:11<00:00, 91.9MB/s]", + "_view_count": null, + "_view_module_version": "1.5.0", + "description_tooltip": null, + "_model_module": "@jupyter-widgets/controls", + "layout": "IPY_MODEL_65efdfd0d26c46e79c8c5ff3b77126cc" + } + }, + "9f09facb2a6c4a7096810d327c8b551c": { + "model_module": "@jupyter-widgets/controls", + "model_name": "DescriptionStyleModel", + "model_module_version": "1.5.0", + "state": { + "_view_name": "StyleView", + "_model_name": "DescriptionStyleModel", + "description_width": "", + "_view_module": "@jupyter-widgets/base", + "_model_module_version": "1.5.0", + "_view_count": null, + "_view_module_version": "1.2.0", + "_model_module": "@jupyter-widgets/controls" + } + }, + "25621cff5d16448cb7260e839fd0f543": { + "model_module": "@jupyter-widgets/base", + "model_name": "LayoutModel", + "model_module_version": "1.2.0", + "state": { + "_view_name": "LayoutView", + "grid_template_rows": null, + "right": null, + "justify_content": null, + "_view_module": "@jupyter-widgets/base", + "overflow": null, + "_model_module_version": "1.2.0", + "_view_count": null, + "flex_flow": null, + "width": null, + "min_width": null, + "border": null, + "align_items": null, + "bottom": null, + "_model_module": "@jupyter-widgets/base", + "top": null, + "grid_column": null, + "overflow_y": null, + "overflow_x": null, + "grid_auto_flow": null, + "grid_area": null, + "grid_template_columns": null, + "flex": null, + "_model_name": "LayoutModel", + "justify_items": null, + "grid_row": null, + "max_height": null, + "align_content": null, + "visibility": null, + "align_self": null, + "height": null, + "min_height": null, + "padding": null, + "grid_auto_rows": null, + "grid_gap": null, + "max_width": null, + "order": null, + "_view_module_version": "1.2.0", + "grid_template_areas": null, + "object_position": null, + "object_fit": null, + "grid_auto_columns": null, + "margin": null, + "display": null, + "left": null + } + }, + "0ce7164fc0c74bb9a2b5c7037375a727": { + "model_module": "@jupyter-widgets/controls", + "model_name": "ProgressStyleModel", + "model_module_version": "1.5.0", + "state": { + "_view_name": "StyleView", + "_model_name": "ProgressStyleModel", + "description_width": "", + "_view_module": "@jupyter-widgets/base", + "_model_module_version": "1.5.0", + "_view_count": null, + "_view_module_version": "1.2.0", + "bar_color": null, + "_model_module": "@jupyter-widgets/controls" + } + }, + "c4c4593c10904cb5b8a5724d60c7e181": { + "model_module": "@jupyter-widgets/base", + "model_name": "LayoutModel", + "model_module_version": "1.2.0", + "state": { + "_view_name": "LayoutView", + "grid_template_rows": null, + "right": null, + "justify_content": null, + "_view_module": "@jupyter-widgets/base", + "overflow": null, + "_model_module_version": "1.2.0", + "_view_count": null, + "flex_flow": null, + "width": null, + "min_width": null, + "border": null, + "align_items": null, + "bottom": null, + "_model_module": "@jupyter-widgets/base", + "top": null, + "grid_column": null, + "overflow_y": null, + "overflow_x": null, + "grid_auto_flow": null, + "grid_area": null, + "grid_template_columns": null, + "flex": null, + "_model_name": "LayoutModel", + "justify_items": null, + "grid_row": null, + "max_height": null, + "align_content": null, + "visibility": null, + "align_self": null, + "height": null, + "min_height": null, + "padding": null, + "grid_auto_rows": null, + "grid_gap": null, + "max_width": null, + "order": null, + "_view_module_version": "1.2.0", + "grid_template_areas": null, + "object_position": null, + "object_fit": null, + "grid_auto_columns": null, + "margin": null, + "display": null, + "left": null + } + }, + "473371611126476c88d5d42ec7031ed6": { + "model_module": "@jupyter-widgets/controls", + "model_name": "DescriptionStyleModel", + "model_module_version": "1.5.0", + "state": { + "_view_name": "StyleView", + "_model_name": "DescriptionStyleModel", + "description_width": "", + "_view_module": "@jupyter-widgets/base", + "_model_module_version": "1.5.0", + "_view_count": null, + "_view_module_version": "1.2.0", + "_model_module": "@jupyter-widgets/controls" + } + }, + "65efdfd0d26c46e79c8c5ff3b77126cc": { + "model_module": "@jupyter-widgets/base", + "model_name": "LayoutModel", + "model_module_version": "1.2.0", + "state": { + "_view_name": "LayoutView", + "grid_template_rows": null, + "right": null, + "justify_content": null, + "_view_module": "@jupyter-widgets/base", + "overflow": null, + "_model_module_version": "1.2.0", + "_view_count": null, + "flex_flow": null, + "width": null, + "min_width": null, + "border": null, + "align_items": null, + "bottom": null, + "_model_module": "@jupyter-widgets/base", + "top": null, + "grid_column": null, + "overflow_y": null, + "overflow_x": null, + "grid_auto_flow": null, + "grid_area": null, + "grid_template_columns": null, + "flex": null, + "_model_name": "LayoutModel", + "justify_items": null, + "grid_row": null, + "max_height": null, + "align_content": null, + "visibility": null, + "align_self": null, + "height": null, + "min_height": null, + "padding": null, + "grid_auto_rows": null, + "grid_gap": null, + "max_width": null, + "order": null, + "_view_module_version": "1.2.0", + "grid_template_areas": null, + "object_position": null, + "object_fit": null, + "grid_auto_columns": null, + "margin": null, + "display": null, + "left": null + } + } + } + } + }, + "cells": [ + { + "cell_type": "markdown", + "metadata": { + "id": "view-in-github", + "colab_type": "text" + }, + "source": [ + "\"Open" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "t6MPjfT5NrKQ" + }, + "source": [ + "\n", + "\n", + "\n", + "This is the **official YOLOv5 🚀 notebook** by **Ultralytics**, and is freely available for redistribution under the [GPL-3.0 license](https://choosealicense.com/licenses/gpl-3.0/). \n", + "For more information please visit https://github.com/ultralytics/yolov5 and https://ultralytics.com. Thank you!" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "7mGmQbAO5pQb" + }, + "source": [ + "# Setup\n", + "\n", + "Clone repo, install dependencies and check PyTorch and GPU." + ] + }, + { + "cell_type": "code", + "metadata": { + "id": "wbvMlHd_QwMG", + "colab": { + "base_uri": "https://localhost:8080/" + }, + "outputId": "3809e5a9-dd41-4577-fe62-5531abf7cca2" + }, + "source": [ + "!git clone https://github.com/ultralytics/yolov5 # clone\n", + "%cd yolov5\n", + "%pip install -qr requirements.txt # install\n", + "\n", + "import torch\n", + "from yolov5 import utils\n", + "display = utils.notebook_init() # checks" + ], + "execution_count": null, + "outputs": [ + { + "output_type": "stream", + "name": "stdout", + "text": [ + "YOLOv5 🚀 v6.0-48-g84a8099 torch 1.10.0+cu102 CUDA:0 (Tesla V100-SXM2-16GB, 16160MiB)\n", + "Setup complete ✅\n" + ] + } + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "4JnkELT0cIJg" + }, + "source": [ + "# 1. Inference\n", + "\n", + "`detect.py` runs YOLOv5 inference on a variety of sources, downloading models automatically from the [latest YOLOv5 release](https://github.com/ultralytics/yolov5/releases), and saving results to `runs/detect`. Example inference sources are:\n", + "\n", + "```shell\n", + "python detect.py --source 0 # webcam\n", + " img.jpg # image \n", + " vid.mp4 # video\n", + " path/ # directory\n", + " path/*.jpg # glob\n", + " 'https://youtu.be/Zgi9g1ksQHc' # YouTube\n", + " 'rtsp://example.com/media.mp4' # RTSP, RTMP, HTTP stream\n", + "```" + ] + }, + { + "cell_type": "code", + "metadata": { + "id": "zR9ZbuQCH7FX", + "colab": { + "base_uri": "https://localhost:8080/" + }, + "outputId": "8f7e6588-215d-4ebd-93af-88b871e770a7" + }, + "source": [ + "!python detect.py --weights yolov5s.pt --img 640 --conf 0.25 --source data/images\n", + "display.Image(filename='runs/detect/exp/zidane.jpg', width=600)" + ], + "execution_count": null, + "outputs": [ + { + "output_type": "stream", + "name": "stdout", + "text": [ + "\u001b[34m\u001b[1mdetect: \u001b[0mweights=['yolov5s.pt'], source=data/images, imgsz=[640, 640], conf_thres=0.25, iou_thres=0.45, max_det=1000, device=, view_img=False, save_txt=False, save_conf=False, save_crop=False, nosave=False, classes=None, agnostic_nms=False, augment=False, visualize=False, update=False, project=runs/detect, name=exp, exist_ok=False, line_thickness=3, hide_labels=False, hide_conf=False, half=False, dnn=False\n", + "YOLOv5 🚀 v6.0-48-g84a8099 torch 1.10.0+cu102 CUDA:0 (Tesla V100-SXM2-16GB, 16160MiB)\n", + "\n", + "Fusing layers... \n", + "Model Summary: 213 layers, 7225885 parameters, 0 gradients\n", + "image 1/2 /content/yolov5/data/images/bus.jpg: 640x480 4 persons, 1 bus, Done. (0.007s)\n", + "image 2/2 /content/yolov5/data/images/zidane.jpg: 384x640 2 persons, 1 tie, Done. (0.007s)\n", + "Speed: 0.5ms pre-process, 6.9ms inference, 1.3ms NMS per image at shape (1, 3, 640, 640)\n", + "Results saved to \u001b[1mruns/detect/exp\u001b[0m\n" + ] + } + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "hkAzDWJ7cWTr" + }, + "source": [ + "        \n", + "" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "0eq1SMWl6Sfn" + }, + "source": [ + "# 2. Validate\n", + "Validate a model's accuracy on [COCO](https://cocodataset.org/#home) val or test-dev datasets. Models are downloaded automatically from the [latest YOLOv5 release](https://github.com/ultralytics/yolov5/releases). To show results by class use the `--verbose` flag. Note that `pycocotools` metrics may be ~1% better than the equivalent repo metrics, as is visible below, due to slight differences in mAP computation." + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "eyTZYGgRjnMc" + }, + "source": [ + "## COCO val\n", + "Download [COCO val 2017](https://github.com/ultralytics/yolov5/blob/74b34872fdf41941cddcf243951cdb090fbac17b/data/coco.yaml#L14) dataset (1GB - 5000 images), and test model accuracy." + ] + }, + { + "cell_type": "code", + "metadata": { + "id": "WQPtK1QYVaD_", + "colab": { + "base_uri": "https://localhost:8080/", + "height": 48, + "referenced_widgets": [ + "eb95db7cae194218b3fcefb439b6352f", + "769ecde6f2e64bacb596ce972f8d3d2d", + "384a001876054c93b0af45cd1e960bfe", + "dded0aeae74440f7ba2ffa0beb8dd612", + "5296d28be75740b2892ae421bbec3657", + "9f09facb2a6c4a7096810d327c8b551c", + "25621cff5d16448cb7260e839fd0f543", + "0ce7164fc0c74bb9a2b5c7037375a727", + "c4c4593c10904cb5b8a5724d60c7e181", + "473371611126476c88d5d42ec7031ed6", + "65efdfd0d26c46e79c8c5ff3b77126cc" + ] + }, + "outputId": "bcf9a448-1f9b-4a41-ad49-12f181faf05a" + }, + "source": [ + "# Download COCO val\n", + "torch.hub.download_url_to_file('https://ultralytics.com/assets/coco2017val.zip', 'tmp.zip')\n", + "!unzip -q tmp.zip -d ../datasets && rm tmp.zip" + ], + "execution_count": null, + "outputs": [ + { + "output_type": "display_data", + "data": { + "application/vnd.jupyter.widget-view+json": { + "model_id": "eb95db7cae194218b3fcefb439b6352f", + "version_minor": 0, + "version_major": 2 + }, + "text/plain": [ + " 0%| | 0.00/780M [00:00

\n", + "Close the active learning loop by sampling images from your inference conditions with the `roboflow` pip package\n", + "

\n", + "\n", + "Train a YOLOv5s model on the [COCO128](https://www.kaggle.com/ultralytics/coco128) dataset with `--data coco128.yaml`, starting from pretrained `--weights yolov5s.pt`, or from randomly initialized `--weights '' --cfg yolov5s.yaml`.\n", + "\n", + "- **Pretrained [Models](https://github.com/ultralytics/yolov5/tree/master/models)** are downloaded\n", + "automatically from the [latest YOLOv5 release](https://github.com/ultralytics/yolov5/releases)\n", + "- **[Datasets](https://github.com/ultralytics/yolov5/tree/master/data)** available for autodownload include: [COCO](https://github.com/ultralytics/yolov5/blob/master/data/coco.yaml), [COCO128](https://github.com/ultralytics/yolov5/blob/master/data/coco128.yaml), [VOC](https://github.com/ultralytics/yolov5/blob/master/data/VOC.yaml), [Argoverse](https://github.com/ultralytics/yolov5/blob/master/data/Argoverse.yaml), [VisDrone](https://github.com/ultralytics/yolov5/blob/master/data/VisDrone.yaml), [GlobalWheat](https://github.com/ultralytics/yolov5/blob/master/data/GlobalWheat2020.yaml), [xView](https://github.com/ultralytics/yolov5/blob/master/data/xView.yaml), [Objects365](https://github.com/ultralytics/yolov5/blob/master/data/Objects365.yaml), [SKU-110K](https://github.com/ultralytics/yolov5/blob/master/data/SKU-110K.yaml).\n", + "- **Training Results** are saved to `runs/train/` with incrementing run directories, i.e. `runs/train/exp2`, `runs/train/exp3` etc.\n", + "

\n", + "\n", + "## Train on Custom Data with Roboflow 🌟 NEW\n", + "\n", + "[Roboflow](https://roboflow.com/?ref=ultralytics) enables you to easily **organize, label, and prepare** a high quality dataset with your own custom data. Roboflow also makes it easy to establish an active learning pipeline, collaborate with your team on dataset improvement, and integrate directly into your model building workflow with the `roboflow` pip package.\n", + "\n", + "- Custom Training Example: [https://blog.roboflow.com/how-to-train-yolov5-on-a-custom-dataset/](https://blog.roboflow.com/how-to-train-yolov5-on-a-custom-dataset/?ref=ultralytics)\n", + "- Custom Training Notebook: [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/roboflow-ai/yolov5-custom-training-tutorial/blob/main/yolov5-custom-training.ipynb)\n", + "
\n", + "\n", + "

Label images lightning fast (including with model-assisted labeling)" + ] + }, + { + "cell_type": "code", + "metadata": { + "id": "bOy5KI2ncnWd" + }, + "source": [ + "# Tensorboard (optional)\n", + "%load_ext tensorboard\n", + "%tensorboard --logdir runs/train" + ], + "execution_count": null, + "outputs": [] + }, + { + "cell_type": "code", + "metadata": { + "id": "2fLAV42oNb7M" + }, + "source": [ + "# Weights & Biases (optional)\n", + "%pip install -q wandb\n", + "import wandb\n", + "wandb.login()" + ], + "execution_count": null, + "outputs": [] + }, + { + "cell_type": "code", + "metadata": { + "id": "1NcFxRcFdJ_O", + "colab": { + "base_uri": "https://localhost:8080/" + }, + "outputId": "8724d13d-6711-4a12-d96a-1c655e5c3549" + }, + "source": [ + "# Train YOLOv5s on COCO128 for 3 epochs\n", + "!python train.py --img 640 --batch 16 --epochs 3 --data coco128.yaml --weights yolov5s.pt --cache" + ], + "execution_count": null, + "outputs": [ + { + "output_type": "stream", + "name": "stdout", + "text": [ + "\u001b[34m\u001b[1mtrain: \u001b[0mweights=yolov5s.pt, cfg=, data=coco128.yaml, hyp=data/hyps/hyp.scratch.yaml, epochs=3, batch_size=16, imgsz=640, rect=False, resume=False, nosave=False, noval=False, noautoanchor=False, evolve=None, bucket=, cache=ram, image_weights=False, device=, multi_scale=False, single_cls=False, adam=False, sync_bn=False, workers=8, project=runs/train, name=exp, exist_ok=False, quad=False, linear_lr=False, label_smoothing=0.0, patience=100, freeze=0, save_period=-1, local_rank=-1, entity=None, upload_dataset=False, bbox_interval=-1, artifact_alias=latest\n", + "\u001b[34m\u001b[1mgithub: \u001b[0mup to date with https://github.com/ultralytics/yolov5 ✅\n", + "YOLOv5 🚀 v6.0-48-g84a8099 torch 1.10.0+cu102 CUDA:0 (Tesla V100-SXM2-16GB, 16160MiB)\n", + "\n", + "\u001b[34m\u001b[1mhyperparameters: \u001b[0mlr0=0.01, lrf=0.1, momentum=0.937, weight_decay=0.0005, warmup_epochs=3.0, warmup_momentum=0.8, warmup_bias_lr=0.1, box=0.05, cls=0.5, cls_pw=1.0, obj=1.0, obj_pw=1.0, iou_t=0.2, anchor_t=4.0, fl_gamma=0.0, hsv_h=0.015, hsv_s=0.7, hsv_v=0.4, degrees=0.0, translate=0.1, scale=0.5, shear=0.0, perspective=0.0, flipud=0.0, fliplr=0.5, mosaic=1.0, mixup=0.0, copy_paste=0.0\n", + "\u001b[34m\u001b[1mWeights & Biases: \u001b[0mrun 'pip install wandb' to automatically track and visualize YOLOv5 🚀 runs (RECOMMENDED)\n", + "\u001b[34m\u001b[1mTensorBoard: \u001b[0mStart with 'tensorboard --logdir runs/train', view at http://localhost:6006/\n", + "\n", + " from n params module arguments \n", + " 0 -1 1 3520 models.common.Conv [3, 32, 6, 2, 2] \n", + " 1 -1 1 18560 models.common.Conv [32, 64, 3, 2] \n", + " 2 -1 1 18816 models.common.C3 [64, 64, 1] \n", + " 3 -1 1 73984 models.common.Conv [64, 128, 3, 2] \n", + " 4 -1 2 115712 models.common.C3 [128, 128, 2] \n", + " 5 -1 1 295424 models.common.Conv [128, 256, 3, 2] \n", + " 6 -1 3 625152 models.common.C3 [256, 256, 3] \n", + " 7 -1 1 1180672 models.common.Conv [256, 512, 3, 2] \n", + " 8 -1 1 1182720 models.common.C3 [512, 512, 1] \n", + " 9 -1 1 656896 models.common.SPPF [512, 512, 5] \n", + " 10 -1 1 131584 models.common.Conv [512, 256, 1, 1] \n", + " 11 -1 1 0 torch.nn.modules.upsampling.Upsample [None, 2, 'nearest'] \n", + " 12 [-1, 6] 1 0 models.common.Concat [1] \n", + " 13 -1 1 361984 models.common.C3 [512, 256, 1, False] \n", + " 14 -1 1 33024 models.common.Conv [256, 128, 1, 1] \n", + " 15 -1 1 0 torch.nn.modules.upsampling.Upsample [None, 2, 'nearest'] \n", + " 16 [-1, 4] 1 0 models.common.Concat [1] \n", + " 17 -1 1 90880 models.common.C3 [256, 128, 1, False] \n", + " 18 -1 1 147712 models.common.Conv [128, 128, 3, 2] \n", + " 19 [-1, 14] 1 0 models.common.Concat [1] \n", + " 20 -1 1 296448 models.common.C3 [256, 256, 1, False] \n", + " 21 -1 1 590336 models.common.Conv [256, 256, 3, 2] \n", + " 22 [-1, 10] 1 0 models.common.Concat [1] \n", + " 23 -1 1 1182720 models.common.C3 [512, 512, 1, False] \n", + " 24 [17, 20, 23] 1 229245 models.yolo.Detect [80, [[10, 13, 16, 30, 33, 23], [30, 61, 62, 45, 59, 119], [116, 90, 156, 198, 373, 326]], [128, 256, 512]]\n", + "Model Summary: 270 layers, 7235389 parameters, 7235389 gradients, 16.5 GFLOPs\n", + "\n", + "Transferred 349/349 items from yolov5s.pt\n", + "Scaled weight_decay = 0.0005\n", + "\u001b[34m\u001b[1moptimizer:\u001b[0m SGD with parameter groups 57 weight, 60 weight (no decay), 60 bias\n", + "\u001b[34m\u001b[1malbumentations: \u001b[0mversion 1.0.3 required by YOLOv5, but version 0.1.12 is currently installed\n", + "\u001b[34m\u001b[1mtrain: \u001b[0mScanning '../datasets/coco128/labels/train2017.cache' images and labels... 128 found, 0 missing, 2 empty, 0 corrupted: 100% 128/128 [00:00\"Weights

" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "-WPvRbS5Swl6" + }, + "source": [ + "## Local Logging\n", + "\n", + "All results are logged by default to `runs/train`, with a new experiment directory created for each new training as `runs/train/exp2`, `runs/train/exp3`, etc. View train and val jpgs to see mosaics, labels, predictions and augmentation effects. Note an Ultralytics **Mosaic Dataloader** is used for training (shown below), which combines 4 images into 1 mosaic during training.\n", + "\n", + "> \n", + "`train_batch0.jpg` shows train batch 0 mosaics and labels\n", + "\n", + "> \n", + "`test_batch0_labels.jpg` shows val batch 0 labels\n", + "\n", + "> \n", + "`test_batch0_pred.jpg` shows val batch 0 _predictions_\n", + "\n", + "Training results are automatically logged to [Tensorboard](https://www.tensorflow.org/tensorboard) and [CSV](https://github.com/ultralytics/yolov5/pull/4148) as `results.csv`, which is plotted as `results.png` (below) after training completes. You can also plot any `results.csv` file manually:\n", + "\n", + "```python\n", + "from utils.plots import plot_results \n", + "plot_results('path/to/results.csv') # plot 'results.csv' as 'results.png'\n", + "```\n", + "\n", + "\"COCO128" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "Zelyeqbyt3GD" + }, + "source": [ + "# Environments\n", + "\n", + "YOLOv5 may be run in any of the following up-to-date verified environments (with all dependencies including [CUDA](https://developer.nvidia.com/cuda)/[CUDNN](https://developer.nvidia.com/cudnn), [Python](https://www.python.org/) and [PyTorch](https://pytorch.org/) preinstalled):\n", + "\n", + "- **Google Colab and Kaggle** notebooks with free GPU: \"Open \"Open\n", + "- **Google Cloud** Deep Learning VM. See [GCP Quickstart Guide](https://github.com/ultralytics/yolov5/wiki/GCP-Quickstart)\n", + "- **Amazon** Deep Learning AMI. See [AWS Quickstart Guide](https://github.com/ultralytics/yolov5/wiki/AWS-Quickstart)\n", + "- **Docker Image**. See [Docker Quickstart Guide](https://github.com/ultralytics/yolov5/wiki/Docker-Quickstart) \"Docker\n" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "6Qu7Iesl0p54" + }, + "source": [ + "# Status\n", + "\n", + "![CI CPU testing](https://github.com/ultralytics/yolov5/workflows/CI%20CPU%20testing/badge.svg)\n", + "\n", + "If this badge is green, all [YOLOv5 GitHub Actions](https://github.com/ultralytics/yolov5/actions) Continuous Integration (CI) tests are currently passing. CI tests verify correct operation of YOLOv5 training ([train.py](https://github.com/ultralytics/yolov5/blob/master/train.py)), testing ([val.py](https://github.com/ultralytics/yolov5/blob/master/val.py)), inference ([detect.py](https://github.com/ultralytics/yolov5/blob/master/detect.py)) and export ([export.py](https://github.com/ultralytics/yolov5/blob/master/export.py)) on MacOS, Windows, and Ubuntu every 24 hours and on every commit.\n" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "IEijrePND_2I" + }, + "source": [ + "# Appendix\n", + "\n", + "Optional extras below. Unit tests validate repo functionality and should be run on any PRs submitted.\n" + ] + }, + { + "cell_type": "code", + "metadata": { + "id": "mcKoSIK2WSzj" + }, + "source": [ + "# Reproduce\n", + "for x in 'yolov5n', 'yolov5s', 'yolov5m', 'yolov5l', 'yolov5x':\n", + " !python val.py --weights {x}.pt --data coco.yaml --img 640 --task speed # speed\n", + " !python val.py --weights {x}.pt --data coco.yaml --img 640 --conf 0.001 --iou 0.65 # mAP" + ], + "execution_count": null, + "outputs": [] + }, + { + "cell_type": "code", + "metadata": { + "id": "GMusP4OAxFu6" + }, + "source": [ + "# PyTorch Hub\n", + "import torch\n", + "\n", + "# Model\n", + "model = torch.hub.load('ultralytics/yolov5', 'yolov5s')\n", + "\n", + "# Images\n", + "dir = 'https://ultralytics.com/images/'\n", + "imgs = [dir + f for f in ('zidane.jpg', 'bus.jpg')] # batch of images\n", + "\n", + "# Inference\n", + "results = model(imgs)\n", + "results.print() # or .show(), .save()" + ], + "execution_count": null, + "outputs": [] + }, + { + "cell_type": "code", + "metadata": { + "id": "FGH0ZjkGjejy" + }, + "source": [ + "# CI Checks\n", + "%%shell\n", + "export PYTHONPATH=\"$PWD\" # to run *.py. files in subdirectories\n", + "rm -rf runs # remove runs/\n", + "for m in yolov5n; do # models\n", + " python train.py --img 64 --batch 32 --weights $m.pt --epochs 1 --device 0 # train pretrained\n", + " python train.py --img 64 --batch 32 --weights '' --cfg $m.yaml --epochs 1 --device 0 # train scratch\n", + " for d in 0 cpu; do # devices\n", + " python val.py --weights $m.pt --device $d # val official\n", + " python val.py --weights runs/train/exp/weights/best.pt --device $d # val custom\n", + " python detect.py --weights $m.pt --device $d # detect official\n", + " python detect.py --weights runs/train/exp/weights/best.pt --device $d # detect custom\n", + " done\n", + " python hubconf.py # hub\n", + " python models/yolo.py --cfg $m.yaml # build PyTorch model\n", + " python models/tf.py --weights $m.pt # build TensorFlow model\n", + " python export.py --img 64 --batch 1 --weights $m.pt --include torchscript onnx # export\n", + "done" + ], + "execution_count": null, + "outputs": [] + }, + { + "cell_type": "code", + "metadata": { + "id": "gogI-kwi3Tye" + }, + "source": [ + "# Profile\n", + "from utils.torch_utils import profile\n", + "\n", + "m1 = lambda x: x * torch.sigmoid(x)\n", + "m2 = torch.nn.SiLU()\n", + "results = profile(input=torch.randn(16, 3, 640, 640), ops=[m1, m2], n=100)" + ], + "execution_count": null, + "outputs": [] + }, + { + "cell_type": "code", + "metadata": { + "id": "RVRSOhEvUdb5" + }, + "source": [ + "# Evolve\n", + "!python train.py --img 640 --batch 64 --epochs 100 --data coco128.yaml --weights yolov5s.pt --cache --noautoanchor --evolve\n", + "!d=runs/train/evolve && cp evolve.* $d && zip -r evolve.zip $d && gsutil mv evolve.zip gs://bucket # upload results (optional)" + ], + "execution_count": null, + "outputs": [] + }, + { + "cell_type": "code", + "metadata": { + "id": "BSgFCAcMbk1R" + }, + "source": [ + "# VOC\n", + "for b, m in zip([64, 64, 32, 16], ['yolov5s', 'yolov5m', 'yolov5l', 'yolov5x']): # zip(batch_size, model)\n", + " !python train.py --batch {b} --weights {m}.pt --data VOC.yaml --epochs 50 --cache --img 512 --nosave --hyp hyp.finetune.yaml --project VOC --name {m}" + ], + "execution_count": null, + "outputs": [] + }, + { + "cell_type": "code", + "metadata": { + "id": "VTRwsvA9u7ln" + }, + "source": [ + "# TensorRT \n", + "# https://docs.nvidia.com/deeplearning/tensorrt/install-guide/index.html#installing-pip\n", + "!pip install -U nvidia-tensorrt --index-url https://pypi.ngc.nvidia.com # install\n", + "!python export.py --weights yolov5s.pt --include engine --imgsz 640 640 --device 0 # export\n", + "!python detect.py --weights yolov5s.engine --imgsz 640 640 --device 0 # inference" + ], + "execution_count": null, + "outputs": [] + } + ] +} diff --git a/yolov5_Monocular_social_ranging/utils/__init__.py b/yolov5_Monocular_social_ranging/utils/__init__.py new file mode 100644 index 0000000..295aebf --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/__init__.py @@ -0,0 +1,37 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +utils/initialization +""" + + +def notebook_init(verbose=True): + # Check system software and hardware + print('Checking setup...') + + import os + import shutil + + from utils.general import check_requirements, emojis, is_colab + from utils.torch_utils import select_device # imports + + check_requirements(('psutil', 'IPython')) + import psutil + from IPython import display # to display images and clear console output + + if is_colab(): + shutil.rmtree('/content/sample_data', ignore_errors=True) # remove colab /sample_data directory + + if verbose: + # System info + # gb = 1 / 1000 ** 3 # bytes to GB + gib = 1 / 1024 ** 3 # bytes to GiB + ram = psutil.virtual_memory().total + total, used, free = shutil.disk_usage("/") + display.clear_output() + s = f'({os.cpu_count()} CPUs, {ram * gib:.1f} GB RAM, {(total - free) * gib:.1f}/{total * gib:.1f} GB disk)' + else: + s = '' + + select_device(newline=False) + print(emojis(f'Setup complete ✅ {s}')) + return display diff --git a/yolov5_Monocular_social_ranging/utils/activations.py b/yolov5_Monocular_social_ranging/utils/activations.py new file mode 100644 index 0000000..a4ff789 --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/activations.py @@ -0,0 +1,101 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +Activation functions +""" + +import torch +import torch.nn as nn +import torch.nn.functional as F + + +# SiLU https://arxiv.org/pdf/1606.08415.pdf ---------------------------------------------------------------------------- +class SiLU(nn.Module): # export-friendly version of nn.SiLU() + @staticmethod + def forward(x): + return x * torch.sigmoid(x) + + +class Hardswish(nn.Module): # export-friendly version of nn.Hardswish() + @staticmethod + def forward(x): + # return x * F.hardsigmoid(x) # for TorchScript and CoreML + return x * F.hardtanh(x + 3, 0.0, 6.0) / 6.0 # for TorchScript, CoreML and ONNX + + +# Mish https://github.com/digantamisra98/Mish -------------------------------------------------------------------------- +class Mish(nn.Module): + @staticmethod + def forward(x): + return x * F.softplus(x).tanh() + + +class MemoryEfficientMish(nn.Module): + class F(torch.autograd.Function): + @staticmethod + def forward(ctx, x): + ctx.save_for_backward(x) + return x.mul(torch.tanh(F.softplus(x))) # x * tanh(ln(1 + exp(x))) + + @staticmethod + def backward(ctx, grad_output): + x = ctx.saved_tensors[0] + sx = torch.sigmoid(x) + fx = F.softplus(x).tanh() + return grad_output * (fx + x * sx * (1 - fx * fx)) + + def forward(self, x): + return self.F.apply(x) + + +# FReLU https://arxiv.org/abs/2007.11824 ------------------------------------------------------------------------------- +class FReLU(nn.Module): + def __init__(self, c1, k=3): # ch_in, kernel + super().__init__() + self.conv = nn.Conv2d(c1, c1, k, 1, 1, groups=c1, bias=False) + self.bn = nn.BatchNorm2d(c1) + + def forward(self, x): + return torch.max(x, self.bn(self.conv(x))) + + +# ACON https://arxiv.org/pdf/2009.04759.pdf ---------------------------------------------------------------------------- +class AconC(nn.Module): + r""" ACON activation (activate or not). + AconC: (p1*x-p2*x) * sigmoid(beta*(p1*x-p2*x)) + p2*x, beta is a learnable parameter + according to "Activate or Not: Learning Customized Activation" . + """ + + def __init__(self, c1): + super().__init__() + self.p1 = nn.Parameter(torch.randn(1, c1, 1, 1)) + self.p2 = nn.Parameter(torch.randn(1, c1, 1, 1)) + self.beta = nn.Parameter(torch.ones(1, c1, 1, 1)) + + def forward(self, x): + dpx = (self.p1 - self.p2) * x + return dpx * torch.sigmoid(self.beta * dpx) + self.p2 * x + + +class MetaAconC(nn.Module): + r""" ACON activation (activate or not). + MetaAconC: (p1*x-p2*x) * sigmoid(beta*(p1*x-p2*x)) + p2*x, beta is generated by a small network + according to "Activate or Not: Learning Customized Activation" . + """ + + def __init__(self, c1, k=1, s=1, r=16): # ch_in, kernel, stride, r + super().__init__() + c2 = max(r, c1 // r) + self.p1 = nn.Parameter(torch.randn(1, c1, 1, 1)) + self.p2 = nn.Parameter(torch.randn(1, c1, 1, 1)) + self.fc1 = nn.Conv2d(c1, c2, k, s, bias=True) + self.fc2 = nn.Conv2d(c2, c1, k, s, bias=True) + # self.bn1 = nn.BatchNorm2d(c2) + # self.bn2 = nn.BatchNorm2d(c1) + + def forward(self, x): + y = x.mean(dim=2, keepdims=True).mean(dim=3, keepdims=True) + # batch-size 1 bug/instabilities https://github.com/ultralytics/yolov5/issues/2891 + # beta = torch.sigmoid(self.bn2(self.fc2(self.bn1(self.fc1(y))))) # bug/unstable + beta = torch.sigmoid(self.fc2(self.fc1(y))) # bug patch BN layers removed + dpx = (self.p1 - self.p2) * x + return dpx * torch.sigmoid(beta * dpx) + self.p2 * x diff --git a/yolov5_Monocular_social_ranging/utils/augmentations.py b/yolov5_Monocular_social_ranging/utils/augmentations.py new file mode 100644 index 0000000..0311b97 --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/augmentations.py @@ -0,0 +1,277 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +Image augmentation functions +""" + +import math +import random + +import cv2 +import numpy as np + +from utils.general import LOGGER, check_version, colorstr, resample_segments, segment2box +from utils.metrics import bbox_ioa + + +class Albumentations: + # YOLOv5 Albumentations class (optional, only used if package is installed) + def __init__(self): + self.transform = None + try: + import albumentations as A + check_version(A.__version__, '1.0.3', hard=True) # version requirement + + self.transform = A.Compose([ + A.Blur(p=0.01), + A.MedianBlur(p=0.01), + A.ToGray(p=0.01), + A.CLAHE(p=0.01), + A.RandomBrightnessContrast(p=0.0), + A.RandomGamma(p=0.0), + A.ImageCompression(quality_lower=75, p=0.0)], + bbox_params=A.BboxParams(format='yolo', label_fields=['class_labels'])) + + LOGGER.info(colorstr('albumentations: ') + ', '.join(f'{x}' for x in self.transform.transforms if x.p)) + except ImportError: # package not installed, skip + pass + except Exception as e: + LOGGER.info(colorstr('albumentations: ') + f'{e}') + + def __call__(self, im, labels, p=1.0): + if self.transform and random.random() < p: + new = self.transform(image=im, bboxes=labels[:, 1:], class_labels=labels[:, 0]) # transformed + im, labels = new['image'], np.array([[c, *b] for c, b in zip(new['class_labels'], new['bboxes'])]) + return im, labels + + +def augment_hsv(im, hgain=0.5, sgain=0.5, vgain=0.5): + # HSV color-space augmentation + if hgain or sgain or vgain: + r = np.random.uniform(-1, 1, 3) * [hgain, sgain, vgain] + 1 # random gains + hue, sat, val = cv2.split(cv2.cvtColor(im, cv2.COLOR_BGR2HSV)) + dtype = im.dtype # uint8 + + x = np.arange(0, 256, dtype=r.dtype) + lut_hue = ((x * r[0]) % 180).astype(dtype) + lut_sat = np.clip(x * r[1], 0, 255).astype(dtype) + lut_val = np.clip(x * r[2], 0, 255).astype(dtype) + + im_hsv = cv2.merge((cv2.LUT(hue, lut_hue), cv2.LUT(sat, lut_sat), cv2.LUT(val, lut_val))) + cv2.cvtColor(im_hsv, cv2.COLOR_HSV2BGR, dst=im) # no return needed + + +def hist_equalize(im, clahe=True, bgr=False): + # Equalize histogram on BGR image 'im' with im.shape(n,m,3) and range 0-255 + yuv = cv2.cvtColor(im, cv2.COLOR_BGR2YUV if bgr else cv2.COLOR_RGB2YUV) + if clahe: + c = cv2.createCLAHE(clipLimit=2.0, tileGridSize=(8, 8)) + yuv[:, :, 0] = c.apply(yuv[:, :, 0]) + else: + yuv[:, :, 0] = cv2.equalizeHist(yuv[:, :, 0]) # equalize Y channel histogram + return cv2.cvtColor(yuv, cv2.COLOR_YUV2BGR if bgr else cv2.COLOR_YUV2RGB) # convert YUV image to RGB + + +def replicate(im, labels): + # Replicate labels + h, w = im.shape[:2] + boxes = labels[:, 1:].astype(int) + x1, y1, x2, y2 = boxes.T + s = ((x2 - x1) + (y2 - y1)) / 2 # side length (pixels) + for i in s.argsort()[:round(s.size * 0.5)]: # smallest indices + x1b, y1b, x2b, y2b = boxes[i] + bh, bw = y2b - y1b, x2b - x1b + yc, xc = int(random.uniform(0, h - bh)), int(random.uniform(0, w - bw)) # offset x, y + x1a, y1a, x2a, y2a = [xc, yc, xc + bw, yc + bh] + im[y1a:y2a, x1a:x2a] = im[y1b:y2b, x1b:x2b] # im4[ymin:ymax, xmin:xmax] + labels = np.append(labels, [[labels[i, 0], x1a, y1a, x2a, y2a]], axis=0) + + return im, labels + + +def letterbox(im, new_shape=(640, 640), color=(114, 114, 114), auto=True, scaleFill=False, scaleup=True, stride=32): + # Resize and pad image while meeting stride-multiple constraints + shape = im.shape[:2] # current shape [height, width] + if isinstance(new_shape, int): + new_shape = (new_shape, new_shape) + + # Scale ratio (new / old) + r = min(new_shape[0] / shape[0], new_shape[1] / shape[1]) + if not scaleup: # only scale down, do not scale up (for better val mAP) + r = min(r, 1.0) + + # Compute padding + ratio = r, r # width, height ratios + new_unpad = int(round(shape[1] * r)), int(round(shape[0] * r)) + dw, dh = new_shape[1] - new_unpad[0], new_shape[0] - new_unpad[1] # wh padding + if auto: # minimum rectangle + dw, dh = np.mod(dw, stride), np.mod(dh, stride) # wh padding + elif scaleFill: # stretch + dw, dh = 0.0, 0.0 + new_unpad = (new_shape[1], new_shape[0]) + ratio = new_shape[1] / shape[1], new_shape[0] / shape[0] # width, height ratios + + dw /= 2 # divide padding into 2 sides + dh /= 2 + + if shape[::-1] != new_unpad: # resize + im = cv2.resize(im, new_unpad, interpolation=cv2.INTER_LINEAR) + top, bottom = int(round(dh - 0.1)), int(round(dh + 0.1)) + left, right = int(round(dw - 0.1)), int(round(dw + 0.1)) + im = cv2.copyMakeBorder(im, top, bottom, left, right, cv2.BORDER_CONSTANT, value=color) # add border + return im, ratio, (dw, dh) + + +def random_perspective(im, targets=(), segments=(), degrees=10, translate=.1, scale=.1, shear=10, perspective=0.0, + border=(0, 0)): + # torchvision.transforms.RandomAffine(degrees=(-10, 10), translate=(0.1, 0.1), scale=(0.9, 1.1), shear=(-10, 10)) + # targets = [cls, xyxy] + + height = im.shape[0] + border[0] * 2 # shape(h,w,c) + width = im.shape[1] + border[1] * 2 + + # Center + C = np.eye(3) + C[0, 2] = -im.shape[1] / 2 # x translation (pixels) + C[1, 2] = -im.shape[0] / 2 # y translation (pixels) + + # Perspective + P = np.eye(3) + P[2, 0] = random.uniform(-perspective, perspective) # x perspective (about y) + P[2, 1] = random.uniform(-perspective, perspective) # y perspective (about x) + + # Rotation and Scale + R = np.eye(3) + a = random.uniform(-degrees, degrees) + # a += random.choice([-180, -90, 0, 90]) # add 90deg rotations to small rotations + s = random.uniform(1 - scale, 1 + scale) + # s = 2 ** random.uniform(-scale, scale) + R[:2] = cv2.getRotationMatrix2D(angle=a, center=(0, 0), scale=s) + + # Shear + S = np.eye(3) + S[0, 1] = math.tan(random.uniform(-shear, shear) * math.pi / 180) # x shear (deg) + S[1, 0] = math.tan(random.uniform(-shear, shear) * math.pi / 180) # y shear (deg) + + # Translation + T = np.eye(3) + T[0, 2] = random.uniform(0.5 - translate, 0.5 + translate) * width # x translation (pixels) + T[1, 2] = random.uniform(0.5 - translate, 0.5 + translate) * height # y translation (pixels) + + # Combined rotation matrix + M = T @ S @ R @ P @ C # order of operations (right to left) is IMPORTANT + if (border[0] != 0) or (border[1] != 0) or (M != np.eye(3)).any(): # image changed + if perspective: + im = cv2.warpPerspective(im, M, dsize=(width, height), borderValue=(114, 114, 114)) + else: # affine + im = cv2.warpAffine(im, M[:2], dsize=(width, height), borderValue=(114, 114, 114)) + + # Visualize + # import matplotlib.pyplot as plt + # ax = plt.subplots(1, 2, figsize=(12, 6))[1].ravel() + # ax[0].imshow(im[:, :, ::-1]) # base + # ax[1].imshow(im2[:, :, ::-1]) # warped + + # Transform label coordinates + n = len(targets) + if n: + use_segments = any(x.any() for x in segments) + new = np.zeros((n, 4)) + if use_segments: # warp segments + segments = resample_segments(segments) # upsample + for i, segment in enumerate(segments): + xy = np.ones((len(segment), 3)) + xy[:, :2] = segment + xy = xy @ M.T # transform + xy = xy[:, :2] / xy[:, 2:3] if perspective else xy[:, :2] # perspective rescale or affine + + # clip + new[i] = segment2box(xy, width, height) + + else: # warp boxes + xy = np.ones((n * 4, 3)) + xy[:, :2] = targets[:, [1, 2, 3, 4, 1, 4, 3, 2]].reshape(n * 4, 2) # x1y1, x2y2, x1y2, x2y1 + xy = xy @ M.T # transform + xy = (xy[:, :2] / xy[:, 2:3] if perspective else xy[:, :2]).reshape(n, 8) # perspective rescale or affine + + # create new boxes + x = xy[:, [0, 2, 4, 6]] + y = xy[:, [1, 3, 5, 7]] + new = np.concatenate((x.min(1), y.min(1), x.max(1), y.max(1))).reshape(4, n).T + + # clip + new[:, [0, 2]] = new[:, [0, 2]].clip(0, width) + new[:, [1, 3]] = new[:, [1, 3]].clip(0, height) + + # filter candidates + i = box_candidates(box1=targets[:, 1:5].T * s, box2=new.T, area_thr=0.01 if use_segments else 0.10) + targets = targets[i] + targets[:, 1:5] = new[i] + + return im, targets + + +def copy_paste(im, labels, segments, p=0.5): + # Implement Copy-Paste augmentation https://arxiv.org/abs/2012.07177, labels as nx5 np.array(cls, xyxy) + n = len(segments) + if p and n: + h, w, c = im.shape # height, width, channels + im_new = np.zeros(im.shape, np.uint8) + for j in random.sample(range(n), k=round(p * n)): + l, s = labels[j], segments[j] + box = w - l[3], l[2], w - l[1], l[4] + ioa = bbox_ioa(box, labels[:, 1:5]) # intersection over area + if (ioa < 0.30).all(): # allow 30% obscuration of existing labels + labels = np.concatenate((labels, [[l[0], *box]]), 0) + segments.append(np.concatenate((w - s[:, 0:1], s[:, 1:2]), 1)) + cv2.drawContours(im_new, [segments[j].astype(np.int32)], -1, (255, 255, 255), cv2.FILLED) + + result = cv2.bitwise_and(src1=im, src2=im_new) + result = cv2.flip(result, 1) # augment segments (flip left-right) + i = result > 0 # pixels to replace + # i[:, :] = result.max(2).reshape(h, w, 1) # act over ch + im[i] = result[i] # cv2.imwrite('debug.jpg', im) # debug + + return im, labels, segments + + +def cutout(im, labels, p=0.5): + # Applies image cutout augmentation https://arxiv.org/abs/1708.04552 + if random.random() < p: + h, w = im.shape[:2] + scales = [0.5] * 1 + [0.25] * 2 + [0.125] * 4 + [0.0625] * 8 + [0.03125] * 16 # image size fraction + for s in scales: + mask_h = random.randint(1, int(h * s)) # create random masks + mask_w = random.randint(1, int(w * s)) + + # box + xmin = max(0, random.randint(0, w) - mask_w // 2) + ymin = max(0, random.randint(0, h) - mask_h // 2) + xmax = min(w, xmin + mask_w) + ymax = min(h, ymin + mask_h) + + # apply random color mask + im[ymin:ymax, xmin:xmax] = [random.randint(64, 191) for _ in range(3)] + + # return unobscured labels + if len(labels) and s > 0.03: + box = np.array([xmin, ymin, xmax, ymax], dtype=np.float32) + ioa = bbox_ioa(box, labels[:, 1:5]) # intersection over area + labels = labels[ioa < 0.60] # remove >60% obscured labels + + return labels + + +def mixup(im, labels, im2, labels2): + # Applies MixUp augmentation https://arxiv.org/pdf/1710.09412.pdf + r = np.random.beta(32.0, 32.0) # mixup ratio, alpha=beta=32.0 + im = (im * r + im2 * (1 - r)).astype(np.uint8) + labels = np.concatenate((labels, labels2), 0) + return im, labels + + +def box_candidates(box1, box2, wh_thr=2, ar_thr=100, area_thr=0.1, eps=1e-16): # box1(4,n), box2(4,n) + # Compute candidate boxes: box1 before augment, box2 after augment, wh_thr (pixels), aspect_ratio_thr, area_ratio + w1, h1 = box1[2] - box1[0], box1[3] - box1[1] + w2, h2 = box2[2] - box2[0], box2[3] - box2[1] + ar = np.maximum(w2 / (h2 + eps), h2 / (w2 + eps)) # aspect ratio + return (w2 > wh_thr) & (h2 > wh_thr) & (w2 * h2 / (w1 * h1 + eps) > area_thr) & (ar < ar_thr) # candidates diff --git a/yolov5_Monocular_social_ranging/utils/autoanchor.py b/yolov5_Monocular_social_ranging/utils/autoanchor.py new file mode 100644 index 0000000..27d6fb6 --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/autoanchor.py @@ -0,0 +1,165 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +AutoAnchor utils +""" + +import random + +import numpy as np +import torch +import yaml +from tqdm import tqdm + +from utils.general import LOGGER, colorstr, emojis + +PREFIX = colorstr('AutoAnchor: ') + + +def check_anchor_order(m): + # Check anchor order against stride order for YOLOv5 Detect() module m, and correct if necessary + a = m.anchors.prod(-1).view(-1) # anchor area + da = a[-1] - a[0] # delta a + ds = m.stride[-1] - m.stride[0] # delta s + if da.sign() != ds.sign(): # same order + LOGGER.info(f'{PREFIX}Reversing anchor order') + m.anchors[:] = m.anchors.flip(0) + + +def check_anchors(dataset, model, thr=4.0, imgsz=640): + # Check anchor fit to data, recompute if necessary + m = model.module.model[-1] if hasattr(model, 'module') else model.model[-1] # Detect() + shapes = imgsz * dataset.shapes / dataset.shapes.max(1, keepdims=True) + scale = np.random.uniform(0.9, 1.1, size=(shapes.shape[0], 1)) # augment scale + wh = torch.tensor(np.concatenate([l[:, 3:5] * s for s, l in zip(shapes * scale, dataset.labels)])).float() # wh + + def metric(k): # compute metric + r = wh[:, None] / k[None] + x = torch.min(r, 1 / r).min(2)[0] # ratio metric + best = x.max(1)[0] # best_x + aat = (x > 1 / thr).float().sum(1).mean() # anchors above threshold + bpr = (best > 1 / thr).float().mean() # best possible recall + return bpr, aat + + anchors = m.anchors.clone() * m.stride.to(m.anchors.device).view(-1, 1, 1) # current anchors + bpr, aat = metric(anchors.cpu().view(-1, 2)) + s = f'\n{PREFIX}{aat:.2f} anchors/target, {bpr:.3f} Best Possible Recall (BPR). ' + if bpr > 0.98: # threshold to recompute + LOGGER.info(emojis(f'{s}Current anchors are a good fit to dataset ✅')) + else: + LOGGER.info(emojis(f'{s}Anchors are a poor fit to dataset ⚠️, attempting to improve...')) + na = m.anchors.numel() // 2 # number of anchors + try: + anchors = kmean_anchors(dataset, n=na, img_size=imgsz, thr=thr, gen=1000, verbose=False) + except Exception as e: + LOGGER.info(f'{PREFIX}ERROR: {e}') + new_bpr = metric(anchors)[0] + if new_bpr > bpr: # replace anchors + anchors = torch.tensor(anchors, device=m.anchors.device).type_as(m.anchors) + m.anchors[:] = anchors.clone().view_as(m.anchors) / m.stride.to(m.anchors.device).view(-1, 1, 1) # loss + check_anchor_order(m) + LOGGER.info(f'{PREFIX}New anchors saved to model. Update model *.yaml to use these anchors in the future.') + else: + LOGGER.info(f'{PREFIX}Original anchors better than new anchors. Proceeding with original anchors.') + + +def kmean_anchors(dataset='./data/coco128.yaml', n=9, img_size=640, thr=4.0, gen=1000, verbose=True): + """ Creates kmeans-evolved anchors from training dataset + + Arguments: + dataset: path to data.yaml, or a loaded dataset + n: number of anchors + img_size: image size used for training + thr: anchor-label wh ratio threshold hyperparameter hyp['anchor_t'] used for training, default=4.0 + gen: generations to evolve anchors using genetic algorithm + verbose: print all results + + Return: + k: kmeans evolved anchors + + Usage: + from utils.autoanchor import *; _ = kmean_anchors() + """ + from scipy.cluster.vq import kmeans + + npr = np.random + thr = 1 / thr + + def metric(k, wh): # compute metrics + r = wh[:, None] / k[None] + x = torch.min(r, 1 / r).min(2)[0] # ratio metric + # x = wh_iou(wh, torch.tensor(k)) # iou metric + return x, x.max(1)[0] # x, best_x + + def anchor_fitness(k): # mutation fitness + _, best = metric(torch.tensor(k, dtype=torch.float32), wh) + return (best * (best > thr).float()).mean() # fitness + + def print_results(k, verbose=True): + k = k[np.argsort(k.prod(1))] # sort small to large + x, best = metric(k, wh0) + bpr, aat = (best > thr).float().mean(), (x > thr).float().mean() * n # best possible recall, anch > thr + s = f'{PREFIX}thr={thr:.2f}: {bpr:.4f} best possible recall, {aat:.2f} anchors past thr\n' \ + f'{PREFIX}n={n}, img_size={img_size}, metric_all={x.mean():.3f}/{best.mean():.3f}-mean/best, ' \ + f'past_thr={x[x > thr].mean():.3f}-mean: ' + for i, x in enumerate(k): + s += '%i,%i, ' % (round(x[0]), round(x[1])) + if verbose: + LOGGER.info(s[:-2]) + return k + + if isinstance(dataset, str): # *.yaml file + with open(dataset, errors='ignore') as f: + data_dict = yaml.safe_load(f) # model dict + from utils.datasets import LoadImagesAndLabels + dataset = LoadImagesAndLabels(data_dict['train'], augment=True, rect=True) + + # Get label wh + shapes = img_size * dataset.shapes / dataset.shapes.max(1, keepdims=True) + wh0 = np.concatenate([l[:, 3:5] * s for s, l in zip(shapes, dataset.labels)]) # wh + + # Filter + i = (wh0 < 3.0).any(1).sum() + if i: + LOGGER.info(f'{PREFIX}WARNING: Extremely small objects found. {i} of {len(wh0)} labels are < 3 pixels in size.') + wh = wh0[(wh0 >= 2.0).any(1)] # filter > 2 pixels + # wh = wh * (npr.rand(wh.shape[0], 1) * 0.9 + 0.1) # multiply by random scale 0-1 + + # Kmeans calculation + LOGGER.info(f'{PREFIX}Running kmeans for {n} anchors on {len(wh)} points...') + s = wh.std(0) # sigmas for whitening + k = kmeans(wh / s, n, iter=30)[0] * s # points + if len(k) != n: # kmeans may return fewer points than requested if wh is insufficient or too similar + LOGGER.warning(f'{PREFIX}WARNING: scipy.cluster.vq.kmeans returned only {len(k)} of {n} requested points') + k = np.sort(npr.rand(n * 2)).reshape(n, 2) * img_size # random init + wh = torch.tensor(wh, dtype=torch.float32) # filtered + wh0 = torch.tensor(wh0, dtype=torch.float32) # unfiltered + k = print_results(k, verbose=False) + + # Plot + # k, d = [None] * 20, [None] * 20 + # for i in tqdm(range(1, 21)): + # k[i-1], d[i-1] = kmeans(wh / s, i) # points, mean distance + # fig, ax = plt.subplots(1, 2, figsize=(14, 7), tight_layout=True) + # ax = ax.ravel() + # ax[0].plot(np.arange(1, 21), np.array(d) ** 2, marker='.') + # fig, ax = plt.subplots(1, 2, figsize=(14, 7)) # plot wh + # ax[0].hist(wh[wh[:, 0]<100, 0],400) + # ax[1].hist(wh[wh[:, 1]<100, 1],400) + # fig.savefig('wh.png', dpi=200) + + # Evolve + f, sh, mp, s = anchor_fitness(k), k.shape, 0.9, 0.1 # fitness, generations, mutation prob, sigma + pbar = tqdm(range(gen), desc=f'{PREFIX}Evolving anchors with Genetic Algorithm:') # progress bar + for _ in pbar: + v = np.ones(sh) + while (v == 1).all(): # mutate until a change occurs (prevent duplicates) + v = ((npr.random(sh) < mp) * random.random() * npr.randn(*sh) * s + 1).clip(0.3, 3.0) + kg = (k.copy() * v).clip(min=2.0) + fg = anchor_fitness(kg) + if fg > f: + f, k = fg, kg.copy() + pbar.desc = f'{PREFIX}Evolving anchors with Genetic Algorithm: fitness = {f:.4f}' + if verbose: + print_results(k, verbose) + + return print_results(k) diff --git a/yolov5_Monocular_social_ranging/utils/autobatch.py b/yolov5_Monocular_social_ranging/utils/autobatch.py new file mode 100644 index 0000000..cb94f04 --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/autobatch.py @@ -0,0 +1,57 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +Auto-batch utils +""" + +from copy import deepcopy + +import numpy as np +import torch +from torch.cuda import amp + +from utils.general import LOGGER, colorstr +from utils.torch_utils import profile + + +def check_train_batch_size(model, imgsz=640): + # Check YOLOv5 training batch size + with amp.autocast(): + return autobatch(deepcopy(model).train(), imgsz) # compute optimal batch size + + +def autobatch(model, imgsz=640, fraction=0.9, batch_size=16): + # Automatically estimate best batch size to use `fraction` of available CUDA memory + # Usage: + # import torch + # from utils.autobatch import autobatch + # model = torch.hub.load('ultralytics/yolov5', 'yolov5s', autoshape=False) + # print(autobatch(model)) + + prefix = colorstr('AutoBatch: ') + LOGGER.info(f'{prefix}Computing optimal batch size for --imgsz {imgsz}') + device = next(model.parameters()).device # get model device + if device.type == 'cpu': + LOGGER.info(f'{prefix}CUDA not detected, using default CPU batch-size {batch_size}') + return batch_size + + d = str(device).upper() # 'CUDA:0' + properties = torch.cuda.get_device_properties(device) # device properties + t = properties.total_memory / 1024 ** 3 # (GiB) + r = torch.cuda.memory_reserved(device) / 1024 ** 3 # (GiB) + a = torch.cuda.memory_allocated(device) / 1024 ** 3 # (GiB) + f = t - (r + a) # free inside reserved + LOGGER.info(f'{prefix}{d} ({properties.name}) {t:.2f}G total, {r:.2f}G reserved, {a:.2f}G allocated, {f:.2f}G free') + + batch_sizes = [1, 2, 4, 8, 16] + try: + img = [torch.zeros(b, 3, imgsz, imgsz) for b in batch_sizes] + y = profile(img, model, n=3, device=device) + except Exception as e: + LOGGER.warning(f'{prefix}{e}') + + y = [x[2] for x in y if x] # memory [2] + batch_sizes = batch_sizes[:len(y)] + p = np.polyfit(batch_sizes, y, deg=1) # first degree polynomial fit + b = int((f * fraction - p[1]) / p[0]) # y intercept (optimal batch size) + LOGGER.info(f'{prefix}Using batch-size {b} for {d} {t * fraction:.2f}G/{t:.2f}G ({fraction * 100:.0f}%)') + return b diff --git a/yolov5_Monocular_social_ranging/utils/aws/__init__.py b/yolov5_Monocular_social_ranging/utils/aws/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/yolov5_Monocular_social_ranging/utils/aws/mime.sh b/yolov5_Monocular_social_ranging/utils/aws/mime.sh new file mode 100644 index 0000000..c319a83 --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/aws/mime.sh @@ -0,0 +1,26 @@ +# AWS EC2 instance startup 'MIME' script https://aws.amazon.com/premiumsupport/knowledge-center/execute-user-data-ec2/ +# This script will run on every instance restart, not only on first start +# --- DO NOT COPY ABOVE COMMENTS WHEN PASTING INTO USERDATA --- + +Content-Type: multipart/mixed; boundary="//" +MIME-Version: 1.0 + +--// +Content-Type: text/cloud-config; charset="us-ascii" +MIME-Version: 1.0 +Content-Transfer-Encoding: 7bit +Content-Disposition: attachment; filename="cloud-config.txt" + +#cloud-config +cloud_final_modules: +- [scripts-user, always] + +--// +Content-Type: text/x-shellscript; charset="us-ascii" +MIME-Version: 1.0 +Content-Transfer-Encoding: 7bit +Content-Disposition: attachment; filename="userdata.txt" + +#!/bin/bash +# --- paste contents of userdata.sh here --- +--// diff --git a/yolov5_Monocular_social_ranging/utils/aws/resume.py b/yolov5_Monocular_social_ranging/utils/aws/resume.py new file mode 100644 index 0000000..b21731c --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/aws/resume.py @@ -0,0 +1,40 @@ +# Resume all interrupted trainings in yolov5/ dir including DDP trainings +# Usage: $ python utils/aws/resume.py + +import os +import sys +from pathlib import Path + +import torch +import yaml + +FILE = Path(__file__).resolve() +ROOT = FILE.parents[2] # YOLOv5 root directory +if str(ROOT) not in sys.path: + sys.path.append(str(ROOT)) # add ROOT to PATH + +port = 0 # --master_port +path = Path('').resolve() +for last in path.rglob('*/**/last.pt'): + ckpt = torch.load(last) + if ckpt['optimizer'] is None: + continue + + # Load opt.yaml + with open(last.parent.parent / 'opt.yaml', errors='ignore') as f: + opt = yaml.safe_load(f) + + # Get device count + d = opt['device'].split(',') # devices + nd = len(d) # number of devices + ddp = nd > 1 or (nd == 0 and torch.cuda.device_count() > 1) # distributed data parallel + + if ddp: # multi-GPU + port += 1 + cmd = f'python -m torch.distributed.run --nproc_per_node {nd} --master_port {port} train.py --resume {last}' + else: # single-GPU + cmd = f'python train.py --resume {last}' + + cmd += ' > /dev/null 2>&1 &' # redirect output to dev/null and run in daemon thread + print(cmd) + os.system(cmd) diff --git a/yolov5_Monocular_social_ranging/utils/aws/userdata.sh b/yolov5_Monocular_social_ranging/utils/aws/userdata.sh new file mode 100644 index 0000000..5fc1332 --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/aws/userdata.sh @@ -0,0 +1,27 @@ +#!/bin/bash +# AWS EC2 instance startup script https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/user-data.html +# This script will run only once on first instance start (for a re-start script see mime.sh) +# /home/ubuntu (ubuntu) or /home/ec2-user (amazon-linux) is working dir +# Use >300 GB SSD + +cd home/ubuntu +if [ ! -d yolov5 ]; then + echo "Running first-time script." # install dependencies, download COCO, pull Docker + git clone https://github.com/ultralytics/yolov5 -b master && sudo chmod -R 777 yolov5 + cd yolov5 + bash data/scripts/get_coco.sh && echo "COCO done." & + sudo docker pull ultralytics/yolov5:latest && echo "Docker done." & + python -m pip install --upgrade pip && pip install -r requirements.txt && python detect.py && echo "Requirements done." & + wait && echo "All tasks done." # finish background tasks +else + echo "Running re-start script." # resume interrupted runs + i=0 + list=$(sudo docker ps -qa) # container list i.e. $'one\ntwo\nthree\nfour' + while IFS= read -r id; do + ((i++)) + echo "restarting container $i: $id" + sudo docker start $id + # sudo docker exec -it $id python train.py --resume # single-GPU + sudo docker exec -d $id python utils/aws/resume.py # multi-scenario + done <<<"$list" +fi diff --git a/yolov5_Monocular_social_ranging/utils/benchmarks.py b/yolov5_Monocular_social_ranging/utils/benchmarks.py new file mode 100644 index 0000000..962df81 --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/benchmarks.py @@ -0,0 +1,92 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +Run YOLOv5 benchmarks on all supported export formats + +Format | `export.py --include` | Model +--- | --- | --- +PyTorch | - | yolov5s.pt +TorchScript | `torchscript` | yolov5s.torchscript +ONNX | `onnx` | yolov5s.onnx +OpenVINO | `openvino` | yolov5s_openvino_model/ +TensorRT | `engine` | yolov5s.engine +CoreML | `coreml` | yolov5s.mlmodel +TensorFlow SavedModel | `saved_model` | yolov5s_saved_model/ +TensorFlow GraphDef | `pb` | yolov5s.pb +TensorFlow Lite | `tflite` | yolov5s.tflite +TensorFlow Edge TPU | `edgetpu` | yolov5s_edgetpu.tflite +TensorFlow.js | `tfjs` | yolov5s_web_model/ + +Requirements: + $ pip install -r requirements.txt coremltools onnx onnx-simplifier onnxruntime openvino-dev tensorflow-cpu # CPU + $ pip install -r requirements.txt coremltools onnx onnx-simplifier onnxruntime-gpu openvino-dev tensorflow # GPU + +Usage: + $ python utils/benchmarks.py --weights yolov5s.pt --img 640 +""" + +import argparse +import sys +import time +from pathlib import Path + +import pandas as pd + +FILE = Path(__file__).resolve() +ROOT = FILE.parents[1] # YOLOv5 root directory +if str(ROOT) not in sys.path: + sys.path.append(str(ROOT)) # add ROOT to PATH +# ROOT = ROOT.relative_to(Path.cwd()) # relative + +import export +import val +from utils import notebook_init +from utils.general import LOGGER, print_args + + +def run(weights=ROOT / 'yolov5s.pt', # weights path + imgsz=640, # inference size (pixels) + batch_size=1, # batch size + data=ROOT / 'data/coco128.yaml', # dataset.yaml path + ): + y, t = [], time.time() + formats = export.export_formats() + for i, (name, f, suffix) in formats.iterrows(): # index, (name, file, suffix) + try: + w = weights if f == '-' else export.run(weights=weights, imgsz=[imgsz], include=[f], device='cpu')[-1] + assert suffix in str(w), 'export failed' + result = val.run(data, w, batch_size, imgsz=imgsz, plots=False, device='cpu', task='benchmark') + metrics = result[0] # metrics (mp, mr, map50, map, *losses(box, obj, cls)) + speeds = result[2] # times (preprocess, inference, postprocess) + y.append([name, metrics[3], speeds[1]]) # mAP, t_inference + except Exception as e: + LOGGER.warning(f'WARNING: Benchmark failure for {name}: {e}') + y.append([name, None, None]) # mAP, t_inference + + # Print results + LOGGER.info('\n') + parse_opt() + notebook_init() # print system info + py = pd.DataFrame(y, columns=['Format', 'mAP@0.5:0.95', 'Inference time (ms)']) + LOGGER.info(f'\nBenchmarks complete ({time.time() - t:.2f}s)') + LOGGER.info(str(py)) + return py + + +def parse_opt(): + parser = argparse.ArgumentParser() + parser.add_argument('--weights', type=str, default=ROOT / 'yolov5s.pt', help='weights path') + parser.add_argument('--imgsz', '--img', '--img-size', type=int, default=640, help='inference size (pixels)') + parser.add_argument('--batch-size', type=int, default=1, help='batch size') + parser.add_argument('--data', type=str, default=ROOT / 'data/coco128.yaml', help='dataset.yaml path') + opt = parser.parse_args() + print_args(FILE.stem, opt) + return opt + + +def main(opt): + run(**vars(opt)) + + +if __name__ == "__main__": + opt = parse_opt() + main(opt) diff --git a/yolov5_Monocular_social_ranging/utils/callbacks.py b/yolov5_Monocular_social_ranging/utils/callbacks.py new file mode 100644 index 0000000..c51c268 --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/callbacks.py @@ -0,0 +1,78 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +Callback utils +""" + + +class Callbacks: + """" + Handles all registered callbacks for YOLOv5 Hooks + """ + + def __init__(self): + # Define the available callbacks + self._callbacks = { + 'on_pretrain_routine_start': [], + 'on_pretrain_routine_end': [], + + 'on_train_start': [], + 'on_train_epoch_start': [], + 'on_train_batch_start': [], + 'optimizer_step': [], + 'on_before_zero_grad': [], + 'on_train_batch_end': [], + 'on_train_epoch_end': [], + + 'on_val_start': [], + 'on_val_batch_start': [], + 'on_val_image_end': [], + 'on_val_batch_end': [], + 'on_val_end': [], + + 'on_fit_epoch_end': [], # fit = train + val + 'on_model_save': [], + 'on_train_end': [], + 'on_params_update': [], + 'teardown': [], + } + self.stop_training = False # set True to interrupt training + + def register_action(self, hook, name='', callback=None): + """ + Register a new action to a callback hook + + Args: + hook The callback hook name to register the action to + name The name of the action for later reference + callback The callback to fire + """ + assert hook in self._callbacks, f"hook '{hook}' not found in callbacks {self._callbacks}" + assert callable(callback), f"callback '{callback}' is not callable" + self._callbacks[hook].append({'name': name, 'callback': callback}) + + def get_registered_actions(self, hook=None): + """" + Returns all the registered actions by callback hook + + Args: + hook The name of the hook to check, defaults to all + """ + if hook: + return self._callbacks[hook] + else: + return self._callbacks + + def run(self, hook, *args, **kwargs): + """ + Loop through the registered actions and fire all callbacks + + Args: + hook The name of the hook to check, defaults to all + args Arguments to receive from YOLOv5 + kwargs Keyword Arguments to receive from YOLOv5 + """ + + assert hook in self._callbacks, f"hook '{hook}' not found in callbacks {self._callbacks}" + + for logger in self._callbacks[hook]: + logger['callback'](*args, **kwargs) diff --git a/yolov5_Monocular_social_ranging/utils/datasets.py b/yolov5_Monocular_social_ranging/utils/datasets.py new file mode 100644 index 0000000..e132e04 --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/datasets.py @@ -0,0 +1,1037 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +Dataloaders and dataset utils +""" + +import glob +import hashlib +import json +import math +import os +import random +import shutil +import time +from itertools import repeat +from multiprocessing.pool import Pool, ThreadPool +from pathlib import Path +from threading import Thread +from zipfile import ZipFile + +import cv2 +import numpy as np +import torch +import torch.nn.functional as F +import yaml +from PIL import ExifTags, Image, ImageOps +from torch.utils.data import DataLoader, Dataset, dataloader, distributed +from tqdm import tqdm + +from utils.augmentations import Albumentations, augment_hsv, copy_paste, letterbox, mixup, random_perspective +from utils.general import (DATASETS_DIR, LOGGER, NUM_THREADS, check_dataset, check_requirements, check_yaml, clean_str, + segments2boxes, xyn2xy, xywh2xyxy, xywhn2xyxy, xyxy2xywhn) +from utils.torch_utils import torch_distributed_zero_first + +# Parameters +HELP_URL = 'https://github.com/ultralytics/yolov5/wiki/Train-Custom-Data' +IMG_FORMATS = ['bmp', 'dng', 'jpeg', 'jpg', 'mpo', 'png', 'tif', 'tiff', 'webp'] # include image suffixes +VID_FORMATS = ['asf', 'avi', 'gif', 'm4v', 'mkv', 'mov', 'mp4', 'mpeg', 'mpg', 'wmv'] # include video suffixes + +# Get orientation exif tag +for orientation in ExifTags.TAGS.keys(): + if ExifTags.TAGS[orientation] == 'Orientation': + break + + +def get_hash(paths): + # Returns a single hash value of a list of paths (files or dirs) + size = sum(os.path.getsize(p) for p in paths if os.path.exists(p)) # sizes + h = hashlib.md5(str(size).encode()) # hash sizes + h.update(''.join(paths).encode()) # hash paths + return h.hexdigest() # return hash + + +def exif_size(img): + # Returns exif-corrected PIL size + s = img.size # (width, height) + try: + rotation = dict(img._getexif().items())[orientation] + if rotation == 6: # rotation 270 + s = (s[1], s[0]) + elif rotation == 8: # rotation 90 + s = (s[1], s[0]) + except Exception: + pass + + return s + + +def exif_transpose(image): + """ + Transpose a PIL image accordingly if it has an EXIF Orientation tag. + Inplace version of https://github.com/python-pillow/Pillow/blob/master/src/PIL/ImageOps.py exif_transpose() + + :param image: The image to transpose. + :return: An image. + """ + exif = image.getexif() + orientation = exif.get(0x0112, 1) # default 1 + if orientation > 1: + method = {2: Image.FLIP_LEFT_RIGHT, + 3: Image.ROTATE_180, + 4: Image.FLIP_TOP_BOTTOM, + 5: Image.TRANSPOSE, + 6: Image.ROTATE_270, + 7: Image.TRANSVERSE, + 8: Image.ROTATE_90, + }.get(orientation) + if method is not None: + image = image.transpose(method) + del exif[0x0112] + image.info["exif"] = exif.tobytes() + return image + + +def create_dataloader(path, imgsz, batch_size, stride, single_cls=False, hyp=None, augment=False, cache=False, pad=0.0, + rect=False, rank=-1, workers=8, image_weights=False, quad=False, prefix='', shuffle=False): + if rect and shuffle: + LOGGER.warning('WARNING: --rect is incompatible with DataLoader shuffle, setting shuffle=False') + shuffle = False + with torch_distributed_zero_first(rank): # init dataset *.cache only once if DDP + dataset = LoadImagesAndLabels(path, imgsz, batch_size, + augment=augment, # augmentation + hyp=hyp, # hyperparameters + rect=rect, # rectangular batches + cache_images=cache, + single_cls=single_cls, + stride=int(stride), + pad=pad, + image_weights=image_weights, + prefix=prefix) + + batch_size = min(batch_size, len(dataset)) + nd = torch.cuda.device_count() # number of CUDA devices + nw = min([os.cpu_count() // max(nd, 1), batch_size if batch_size > 1 else 0, workers]) # number of workers + sampler = None if rank == -1 else distributed.DistributedSampler(dataset, shuffle=shuffle) + loader = DataLoader if image_weights else InfiniteDataLoader # only DataLoader allows for attribute updates + return loader(dataset, + batch_size=batch_size, + shuffle=shuffle and sampler is None, + num_workers=nw, + sampler=sampler, + pin_memory=True, + collate_fn=LoadImagesAndLabels.collate_fn4 if quad else LoadImagesAndLabels.collate_fn), dataset + + +class InfiniteDataLoader(dataloader.DataLoader): + """ Dataloader that reuses workers + + Uses same syntax as vanilla DataLoader + """ + + def __init__(self, *args, **kwargs): + super().__init__(*args, **kwargs) + object.__setattr__(self, 'batch_sampler', _RepeatSampler(self.batch_sampler)) + self.iterator = super().__iter__() + + def __len__(self): + return len(self.batch_sampler.sampler) + + def __iter__(self): + for i in range(len(self)): + yield next(self.iterator) + + +class _RepeatSampler: + """ Sampler that repeats forever + + Args: + sampler (Sampler) + """ + + def __init__(self, sampler): + self.sampler = sampler + + def __iter__(self): + while True: + yield from iter(self.sampler) + + +class LoadImages: + # YOLOv5 image/video dataloader, i.e. `python detect.py --source image.jpg/vid.mp4` + def __init__(self, path, img_size=640, stride=32, auto=True): + p = str(Path(path).resolve()) # os-agnostic absolute path + if '*' in p: + files = sorted(glob.glob(p, recursive=True)) # glob + elif os.path.isdir(p): + files = sorted(glob.glob(os.path.join(p, '*.*'))) # dir + elif os.path.isfile(p): + files = [p] # files + else: + raise Exception(f'ERROR: {p} does not exist') + + images = [x for x in files if x.split('.')[-1].lower() in IMG_FORMATS] + videos = [x for x in files if x.split('.')[-1].lower() in VID_FORMATS] + ni, nv = len(images), len(videos) + + self.img_size = img_size + self.stride = stride + self.files = images + videos + self.nf = ni + nv # number of files + self.video_flag = [False] * ni + [True] * nv + self.mode = 'image' + self.auto = auto + if any(videos): + self.new_video(videos[0]) # new video + else: + self.cap = None + assert self.nf > 0, f'No images or videos found in {p}. ' \ + f'Supported formats are:\nimages: {IMG_FORMATS}\nvideos: {VID_FORMATS}' + + def __iter__(self): + self.count = 0 + return self + + def __next__(self): + if self.count == self.nf: + raise StopIteration + path = self.files[self.count] + + if self.video_flag[self.count]: + # Read video + self.mode = 'video' + ret_val, img0 = self.cap.read() + while not ret_val: + self.count += 1 + self.cap.release() + if self.count == self.nf: # last video + raise StopIteration + else: + path = self.files[self.count] + self.new_video(path) + ret_val, img0 = self.cap.read() + + self.frame += 1 + s = f'video {self.count + 1}/{self.nf} ({self.frame}/{self.frames}) {path}: ' + + else: + # Read image + self.count += 1 + img0 = cv2.imread(path) # BGR + assert img0 is not None, f'Image Not Found {path}' + s = f'image {self.count}/{self.nf} {path}: ' + + # Padded resize + img = letterbox(img0, self.img_size, stride=self.stride, auto=self.auto)[0] + + # Convert + img = img.transpose((2, 0, 1))[::-1] # HWC to CHW, BGR to RGB + img = np.ascontiguousarray(img) + + return path, img, img0, self.cap, s + + def new_video(self, path): + self.frame = 0 + self.cap = cv2.VideoCapture(path) + self.frames = int(self.cap.get(cv2.CAP_PROP_FRAME_COUNT)) + + def __len__(self): + return self.nf # number of files + + +class LoadWebcam: # for inference + # YOLOv5 local webcam dataloader, i.e. `python detect.py --source 0` + def __init__(self, pipe='0', img_size=640, stride=32): + self.img_size = img_size + self.stride = stride + self.pipe = eval(pipe) if pipe.isnumeric() else pipe + self.cap = cv2.VideoCapture(self.pipe) # video capture object + self.cap.set(cv2.CAP_PROP_BUFFERSIZE, 3) # set buffer size + + def __iter__(self): + self.count = -1 + return self + + def __next__(self): + self.count += 1 + if cv2.waitKey(1) == ord('q'): # q to quit + self.cap.release() + cv2.destroyAllWindows() + raise StopIteration + + # Read frame + ret_val, img0 = self.cap.read() + img0 = cv2.flip(img0, 1) # flip left-right + + # Print + assert ret_val, f'Camera Error {self.pipe}' + img_path = 'webcam.jpg' + s = f'webcam {self.count}: ' + + # Padded resize + img = letterbox(img0, self.img_size, stride=self.stride)[0] + + # Convert + img = img.transpose((2, 0, 1))[::-1] # HWC to CHW, BGR to RGB + img = np.ascontiguousarray(img) + + return img_path, img, img0, None, s + + def __len__(self): + return 0 + + +class LoadStreams: + # YOLOv5 streamloader, i.e. `python detect.py --source 'rtsp://example.com/media.mp4' # RTSP, RTMP, HTTP streams` + def __init__(self, sources='streams.txt', img_size=640, stride=32, auto=True): + self.mode = 'stream' + self.img_size = img_size + self.stride = stride + + if os.path.isfile(sources): + with open(sources) as f: + sources = [x.strip() for x in f.read().strip().splitlines() if len(x.strip())] + else: + sources = [sources] + + n = len(sources) + self.imgs, self.fps, self.frames, self.threads = [None] * n, [0] * n, [0] * n, [None] * n + self.sources = [clean_str(x) for x in sources] # clean source names for later + self.auto = auto + for i, s in enumerate(sources): # index, source + # Start thread to read frames from video stream + st = f'{i + 1}/{n}: {s}... ' + if 'youtube.com/' in s or 'youtu.be/' in s: # if source is YouTube video + check_requirements(('pafy', 'youtube_dl==2020.12.2')) + import pafy + s = pafy.new(s).getbest(preftype="mp4").url # YouTube URL + s = eval(s) if s.isnumeric() else s # i.e. s = '0' local webcam + cap = cv2.VideoCapture(s) + assert cap.isOpened(), f'{st}Failed to open {s}' + w = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH)) + h = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT)) + fps = cap.get(cv2.CAP_PROP_FPS) # warning: may return 0 or nan + self.frames[i] = max(int(cap.get(cv2.CAP_PROP_FRAME_COUNT)), 0) or float('inf') # infinite stream fallback + self.fps[i] = max((fps if math.isfinite(fps) else 0) % 100, 0) or 30 # 30 FPS fallback + + _, self.imgs[i] = cap.read() # guarantee first frame + self.threads[i] = Thread(target=self.update, args=([i, cap, s]), daemon=True) + LOGGER.info(f"{st} Success ({self.frames[i]} frames {w}x{h} at {self.fps[i]:.2f} FPS)") + self.threads[i].start() + LOGGER.info('') # newline + + # check for common shapes + s = np.stack([letterbox(x, self.img_size, stride=self.stride, auto=self.auto)[0].shape for x in self.imgs]) + self.rect = np.unique(s, axis=0).shape[0] == 1 # rect inference if all shapes equal + if not self.rect: + LOGGER.warning('WARNING: Stream shapes differ. For optimal performance supply similarly-shaped streams.') + + def update(self, i, cap, stream): + # Read stream `i` frames in daemon thread + n, f, read = 0, self.frames[i], 1 # frame number, frame array, inference every 'read' frame + while cap.isOpened() and n < f: + n += 1 + # _, self.imgs[index] = cap.read() + cap.grab() + if n % read == 0: + success, im = cap.retrieve() + if success: + self.imgs[i] = im + else: + LOGGER.warning('WARNING: Video stream unresponsive, please check your IP camera connection.') + self.imgs[i] = np.zeros_like(self.imgs[i]) + cap.open(stream) # re-open stream if signal was lost + time.sleep(1 / self.fps[i]) # wait time + + def __iter__(self): + self.count = -1 + return self + + def __next__(self): + self.count += 1 + if not all(x.is_alive() for x in self.threads) or cv2.waitKey(1) == ord('q'): # q to quit + cv2.destroyAllWindows() + raise StopIteration + + # Letterbox + img0 = self.imgs.copy() + img = [letterbox(x, self.img_size, stride=self.stride, auto=self.rect and self.auto)[0] for x in img0] + + # Stack + img = np.stack(img, 0) + + # Convert + img = img[..., ::-1].transpose((0, 3, 1, 2)) # BGR to RGB, BHWC to BCHW + img = np.ascontiguousarray(img) + + return self.sources, img, img0, None, '' + + def __len__(self): + return len(self.sources) # 1E12 frames = 32 streams at 30 FPS for 30 years + + +def img2label_paths(img_paths): + # Define label paths as a function of image paths + sa, sb = os.sep + 'images' + os.sep, os.sep + 'labels' + os.sep # /images/, /labels/ substrings + return [sb.join(x.rsplit(sa, 1)).rsplit('.', 1)[0] + '.txt' for x in img_paths] + + +class LoadImagesAndLabels(Dataset): + # YOLOv5 train_loader/val_loader, loads images and labels for training and validation + cache_version = 0.6 # dataset labels *.cache version + + def __init__(self, path, img_size=640, batch_size=16, augment=False, hyp=None, rect=False, image_weights=False, + cache_images=False, single_cls=False, stride=32, pad=0.0, prefix=''): + self.img_size = img_size + self.augment = augment + self.hyp = hyp + self.image_weights = image_weights + self.rect = False if image_weights else rect + self.mosaic = self.augment and not self.rect # load 4 images at a time into a mosaic (only during training) + self.mosaic_border = [-img_size // 2, -img_size // 2] + self.stride = stride + self.path = path + self.albumentations = Albumentations() if augment else None + + try: + f = [] # image files + for p in path if isinstance(path, list) else [path]: + p = Path(p) # os-agnostic + if p.is_dir(): # dir + f += glob.glob(str(p / '**' / '*.*'), recursive=True) + # f = list(p.rglob('*.*')) # pathlib + elif p.is_file(): # file + with open(p) as t: + t = t.read().strip().splitlines() + parent = str(p.parent) + os.sep + f += [x.replace('./', parent) if x.startswith('./') else x for x in t] # local to global path + # f += [p.parent / x.lstrip(os.sep) for x in t] # local to global path (pathlib) + else: + raise Exception(f'{prefix}{p} does not exist') + self.img_files = sorted(x.replace('/', os.sep) for x in f if x.split('.')[-1].lower() in IMG_FORMATS) + # self.img_files = sorted([x for x in f if x.suffix[1:].lower() in IMG_FORMATS]) # pathlib + assert self.img_files, f'{prefix}No images found' + except Exception as e: + raise Exception(f'{prefix}Error loading data from {path}: {e}\nSee {HELP_URL}') + + # Check cache + self.label_files = img2label_paths(self.img_files) # labels + cache_path = (p if p.is_file() else Path(self.label_files[0]).parent).with_suffix('.cache') + try: + cache, exists = np.load(cache_path, allow_pickle=True).item(), True # load dict + assert cache['version'] == self.cache_version # same version + assert cache['hash'] == get_hash(self.label_files + self.img_files) # same hash + except Exception: + cache, exists = self.cache_labels(cache_path, prefix), False # cache + + # Display cache + nf, nm, ne, nc, n = cache.pop('results') # found, missing, empty, corrupt, total + if exists: + d = f"Scanning '{cache_path}' images and labels... {nf} found, {nm} missing, {ne} empty, {nc} corrupt" + tqdm(None, desc=prefix + d, total=n, initial=n) # display cache results + if cache['msgs']: + LOGGER.info('\n'.join(cache['msgs'])) # display warnings + assert nf > 0 or not augment, f'{prefix}No labels in {cache_path}. Can not train without labels. See {HELP_URL}' + + # Read cache + [cache.pop(k) for k in ('hash', 'version', 'msgs')] # remove items + labels, shapes, self.segments = zip(*cache.values()) + self.labels = list(labels) + self.shapes = np.array(shapes, dtype=np.float64) + self.img_files = list(cache.keys()) # update + self.label_files = img2label_paths(cache.keys()) # update + n = len(shapes) # number of images + bi = np.floor(np.arange(n) / batch_size).astype(np.int) # batch index + nb = bi[-1] + 1 # number of batches + self.batch = bi # batch index of image + self.n = n + self.indices = range(n) + + # Update labels + include_class = [] # filter labels to include only these classes (optional) + include_class_array = np.array(include_class).reshape(1, -1) + for i, (label, segment) in enumerate(zip(self.labels, self.segments)): + if include_class: + j = (label[:, 0:1] == include_class_array).any(1) + self.labels[i] = label[j] + if segment: + self.segments[i] = segment[j] + if single_cls: # single-class training, merge all classes into 0 + self.labels[i][:, 0] = 0 + if segment: + self.segments[i][:, 0] = 0 + + # Rectangular Training + if self.rect: + # Sort by aspect ratio + s = self.shapes # wh + ar = s[:, 1] / s[:, 0] # aspect ratio + irect = ar.argsort() + self.img_files = [self.img_files[i] for i in irect] + self.label_files = [self.label_files[i] for i in irect] + self.labels = [self.labels[i] for i in irect] + self.shapes = s[irect] # wh + ar = ar[irect] + + # Set training image shapes + shapes = [[1, 1]] * nb + for i in range(nb): + ari = ar[bi == i] + mini, maxi = ari.min(), ari.max() + if maxi < 1: + shapes[i] = [maxi, 1] + elif mini > 1: + shapes[i] = [1, 1 / mini] + + self.batch_shapes = np.ceil(np.array(shapes) * img_size / stride + pad).astype(np.int) * stride + + # Cache images into RAM/disk for faster training (WARNING: large datasets may exceed system resources) + self.imgs, self.img_npy = [None] * n, [None] * n + if cache_images: + if cache_images == 'disk': + self.im_cache_dir = Path(Path(self.img_files[0]).parent.as_posix() + '_npy') + self.img_npy = [self.im_cache_dir / Path(f).with_suffix('.npy').name for f in self.img_files] + self.im_cache_dir.mkdir(parents=True, exist_ok=True) + gb = 0 # Gigabytes of cached images + self.img_hw0, self.img_hw = [None] * n, [None] * n + results = ThreadPool(NUM_THREADS).imap(self.load_image, range(n)) + pbar = tqdm(enumerate(results), total=n) + for i, x in pbar: + if cache_images == 'disk': + if not self.img_npy[i].exists(): + np.save(self.img_npy[i].as_posix(), x[0]) + gb += self.img_npy[i].stat().st_size + else: # 'ram' + self.imgs[i], self.img_hw0[i], self.img_hw[i] = x # im, hw_orig, hw_resized = load_image(self, i) + gb += self.imgs[i].nbytes + pbar.desc = f'{prefix}Caching images ({gb / 1E9:.1f}GB {cache_images})' + pbar.close() + + def cache_labels(self, path=Path('./labels.cache'), prefix=''): + # Cache dataset labels, check images and read shapes + x = {} # dict + nm, nf, ne, nc, msgs = 0, 0, 0, 0, [] # number missing, found, empty, corrupt, messages + desc = f"{prefix}Scanning '{path.parent / path.stem}' images and labels..." + with Pool(NUM_THREADS) as pool: + pbar = tqdm(pool.imap(verify_image_label, zip(self.img_files, self.label_files, repeat(prefix))), + desc=desc, total=len(self.img_files)) + for im_file, lb, shape, segments, nm_f, nf_f, ne_f, nc_f, msg in pbar: + nm += nm_f + nf += nf_f + ne += ne_f + nc += nc_f + if im_file: + x[im_file] = [lb, shape, segments] + if msg: + msgs.append(msg) + pbar.desc = f"{desc}{nf} found, {nm} missing, {ne} empty, {nc} corrupt" + + pbar.close() + if msgs: + LOGGER.info('\n'.join(msgs)) + if nf == 0: + LOGGER.warning(f'{prefix}WARNING: No labels found in {path}. See {HELP_URL}') + x['hash'] = get_hash(self.label_files + self.img_files) + x['results'] = nf, nm, ne, nc, len(self.img_files) + x['msgs'] = msgs # warnings + x['version'] = self.cache_version # cache version + try: + np.save(path, x) # save cache for next time + path.with_suffix('.cache.npy').rename(path) # remove .npy suffix + LOGGER.info(f'{prefix}New cache created: {path}') + except Exception as e: + LOGGER.warning(f'{prefix}WARNING: Cache directory {path.parent} is not writeable: {e}') # not writeable + return x + + def __len__(self): + return len(self.img_files) + + # def __iter__(self): + # self.count = -1 + # print('ran dataset iter') + # #self.shuffled_vector = np.random.permutation(self.nF) if self.augment else np.arange(self.nF) + # return self + + def __getitem__(self, index): + index = self.indices[index] # linear, shuffled, or image_weights + + hyp = self.hyp + mosaic = self.mosaic and random.random() < hyp['mosaic'] + if mosaic: + # Load mosaic + img, labels = self.load_mosaic(index) + shapes = None + + # MixUp augmentation + if random.random() < hyp['mixup']: + img, labels = mixup(img, labels, *self.load_mosaic(random.randint(0, self.n - 1))) + + else: + # Load image + img, (h0, w0), (h, w) = self.load_image(index) + + # Letterbox + shape = self.batch_shapes[self.batch[index]] if self.rect else self.img_size # final letterboxed shape + img, ratio, pad = letterbox(img, shape, auto=False, scaleup=self.augment) + shapes = (h0, w0), ((h / h0, w / w0), pad) # for COCO mAP rescaling + + labels = self.labels[index].copy() + if labels.size: # normalized xywh to pixel xyxy format + labels[:, 1:] = xywhn2xyxy(labels[:, 1:], ratio[0] * w, ratio[1] * h, padw=pad[0], padh=pad[1]) + + if self.augment: + img, labels = random_perspective(img, labels, + degrees=hyp['degrees'], + translate=hyp['translate'], + scale=hyp['scale'], + shear=hyp['shear'], + perspective=hyp['perspective']) + + nl = len(labels) # number of labels + if nl: + labels[:, 1:5] = xyxy2xywhn(labels[:, 1:5], w=img.shape[1], h=img.shape[0], clip=True, eps=1E-3) + + if self.augment: + # Albumentations + img, labels = self.albumentations(img, labels) + nl = len(labels) # update after albumentations + + # HSV color-space + augment_hsv(img, hgain=hyp['hsv_h'], sgain=hyp['hsv_s'], vgain=hyp['hsv_v']) + + # Flip up-down + if random.random() < hyp['flipud']: + img = np.flipud(img) + if nl: + labels[:, 2] = 1 - labels[:, 2] + + # Flip left-right + if random.random() < hyp['fliplr']: + img = np.fliplr(img) + if nl: + labels[:, 1] = 1 - labels[:, 1] + + # Cutouts + # labels = cutout(img, labels, p=0.5) + # nl = len(labels) # update after cutout + + labels_out = torch.zeros((nl, 6)) + if nl: + labels_out[:, 1:] = torch.from_numpy(labels) + + # Convert + img = img.transpose((2, 0, 1))[::-1] # HWC to CHW, BGR to RGB + img = np.ascontiguousarray(img) + + return torch.from_numpy(img), labels_out, self.img_files[index], shapes + + def load_image(self, i): + # loads 1 image from dataset index 'i', returns (im, original hw, resized hw) + im = self.imgs[i] + if im is None: # not cached in RAM + npy = self.img_npy[i] + if npy and npy.exists(): # load npy + im = np.load(npy) + else: # read image + f = self.img_files[i] + im = cv2.imread(f) # BGR + assert im is not None, f'Image Not Found {f}' + h0, w0 = im.shape[:2] # orig hw + r = self.img_size / max(h0, w0) # ratio + if r != 1: # if sizes are not equal + im = cv2.resize(im, + (int(w0 * r), int(h0 * r)), + interpolation=cv2.INTER_LINEAR if (self.augment or r > 1) else cv2.INTER_AREA) + return im, (h0, w0), im.shape[:2] # im, hw_original, hw_resized + else: + return self.imgs[i], self.img_hw0[i], self.img_hw[i] # im, hw_original, hw_resized + + def load_mosaic(self, index): + # YOLOv5 4-mosaic loader. Loads 1 image + 3 random images into a 4-image mosaic + labels4, segments4 = [], [] + s = self.img_size + yc, xc = (int(random.uniform(-x, 2 * s + x)) for x in self.mosaic_border) # mosaic center x, y + indices = [index] + random.choices(self.indices, k=3) # 3 additional image indices + random.shuffle(indices) + for i, index in enumerate(indices): + # Load image + img, _, (h, w) = self.load_image(index) + + # place img in img4 + if i == 0: # top left + img4 = np.full((s * 2, s * 2, img.shape[2]), 114, dtype=np.uint8) # base image with 4 tiles + x1a, y1a, x2a, y2a = max(xc - w, 0), max(yc - h, 0), xc, yc # xmin, ymin, xmax, ymax (large image) + x1b, y1b, x2b, y2b = w - (x2a - x1a), h - (y2a - y1a), w, h # xmin, ymin, xmax, ymax (small image) + elif i == 1: # top right + x1a, y1a, x2a, y2a = xc, max(yc - h, 0), min(xc + w, s * 2), yc + x1b, y1b, x2b, y2b = 0, h - (y2a - y1a), min(w, x2a - x1a), h + elif i == 2: # bottom left + x1a, y1a, x2a, y2a = max(xc - w, 0), yc, xc, min(s * 2, yc + h) + x1b, y1b, x2b, y2b = w - (x2a - x1a), 0, w, min(y2a - y1a, h) + elif i == 3: # bottom right + x1a, y1a, x2a, y2a = xc, yc, min(xc + w, s * 2), min(s * 2, yc + h) + x1b, y1b, x2b, y2b = 0, 0, min(w, x2a - x1a), min(y2a - y1a, h) + + img4[y1a:y2a, x1a:x2a] = img[y1b:y2b, x1b:x2b] # img4[ymin:ymax, xmin:xmax] + padw = x1a - x1b + padh = y1a - y1b + + # Labels + labels, segments = self.labels[index].copy(), self.segments[index].copy() + if labels.size: + labels[:, 1:] = xywhn2xyxy(labels[:, 1:], w, h, padw, padh) # normalized xywh to pixel xyxy format + segments = [xyn2xy(x, w, h, padw, padh) for x in segments] + labels4.append(labels) + segments4.extend(segments) + + # Concat/clip labels + labels4 = np.concatenate(labels4, 0) + for x in (labels4[:, 1:], *segments4): + np.clip(x, 0, 2 * s, out=x) # clip when using random_perspective() + # img4, labels4 = replicate(img4, labels4) # replicate + + # Augment + img4, labels4, segments4 = copy_paste(img4, labels4, segments4, p=self.hyp['copy_paste']) + img4, labels4 = random_perspective(img4, labels4, segments4, + degrees=self.hyp['degrees'], + translate=self.hyp['translate'], + scale=self.hyp['scale'], + shear=self.hyp['shear'], + perspective=self.hyp['perspective'], + border=self.mosaic_border) # border to remove + + return img4, labels4 + + def load_mosaic9(self, index): + # YOLOv5 9-mosaic loader. Loads 1 image + 8 random images into a 9-image mosaic + labels9, segments9 = [], [] + s = self.img_size + indices = [index] + random.choices(self.indices, k=8) # 8 additional image indices + random.shuffle(indices) + hp, wp = -1, -1 # height, width previous + for i, index in enumerate(indices): + # Load image + img, _, (h, w) = self.load_image(index) + + # place img in img9 + if i == 0: # center + img9 = np.full((s * 3, s * 3, img.shape[2]), 114, dtype=np.uint8) # base image with 4 tiles + h0, w0 = h, w + c = s, s, s + w, s + h # xmin, ymin, xmax, ymax (base) coordinates + elif i == 1: # top + c = s, s - h, s + w, s + elif i == 2: # top right + c = s + wp, s - h, s + wp + w, s + elif i == 3: # right + c = s + w0, s, s + w0 + w, s + h + elif i == 4: # bottom right + c = s + w0, s + hp, s + w0 + w, s + hp + h + elif i == 5: # bottom + c = s + w0 - w, s + h0, s + w0, s + h0 + h + elif i == 6: # bottom left + c = s + w0 - wp - w, s + h0, s + w0 - wp, s + h0 + h + elif i == 7: # left + c = s - w, s + h0 - h, s, s + h0 + elif i == 8: # top left + c = s - w, s + h0 - hp - h, s, s + h0 - hp + + padx, pady = c[:2] + x1, y1, x2, y2 = (max(x, 0) for x in c) # allocate coords + + # Labels + labels, segments = self.labels[index].copy(), self.segments[index].copy() + if labels.size: + labels[:, 1:] = xywhn2xyxy(labels[:, 1:], w, h, padx, pady) # normalized xywh to pixel xyxy format + segments = [xyn2xy(x, w, h, padx, pady) for x in segments] + labels9.append(labels) + segments9.extend(segments) + + # Image + img9[y1:y2, x1:x2] = img[y1 - pady:, x1 - padx:] # img9[ymin:ymax, xmin:xmax] + hp, wp = h, w # height, width previous + + # Offset + yc, xc = (int(random.uniform(0, s)) for _ in self.mosaic_border) # mosaic center x, y + img9 = img9[yc:yc + 2 * s, xc:xc + 2 * s] + + # Concat/clip labels + labels9 = np.concatenate(labels9, 0) + labels9[:, [1, 3]] -= xc + labels9[:, [2, 4]] -= yc + c = np.array([xc, yc]) # centers + segments9 = [x - c for x in segments9] + + for x in (labels9[:, 1:], *segments9): + np.clip(x, 0, 2 * s, out=x) # clip when using random_perspective() + # img9, labels9 = replicate(img9, labels9) # replicate + + # Augment + img9, labels9 = random_perspective(img9, labels9, segments9, + degrees=self.hyp['degrees'], + translate=self.hyp['translate'], + scale=self.hyp['scale'], + shear=self.hyp['shear'], + perspective=self.hyp['perspective'], + border=self.mosaic_border) # border to remove + + return img9, labels9 + + @staticmethod + def collate_fn(batch): + img, label, path, shapes = zip(*batch) # transposed + for i, lb in enumerate(label): + lb[:, 0] = i # add target image index for build_targets() + return torch.stack(img, 0), torch.cat(label, 0), path, shapes + + @staticmethod + def collate_fn4(batch): + img, label, path, shapes = zip(*batch) # transposed + n = len(shapes) // 4 + img4, label4, path4, shapes4 = [], [], path[:n], shapes[:n] + + ho = torch.tensor([[0.0, 0, 0, 1, 0, 0]]) + wo = torch.tensor([[0.0, 0, 1, 0, 0, 0]]) + s = torch.tensor([[1, 1, 0.5, 0.5, 0.5, 0.5]]) # scale + for i in range(n): # zidane torch.zeros(16,3,720,1280) # BCHW + i *= 4 + if random.random() < 0.5: + im = F.interpolate(img[i].unsqueeze(0).float(), scale_factor=2.0, mode='bilinear', align_corners=False)[ + 0].type(img[i].type()) + lb = label[i] + else: + im = torch.cat((torch.cat((img[i], img[i + 1]), 1), torch.cat((img[i + 2], img[i + 3]), 1)), 2) + lb = torch.cat((label[i], label[i + 1] + ho, label[i + 2] + wo, label[i + 3] + ho + wo), 0) * s + img4.append(im) + label4.append(lb) + + for i, lb in enumerate(label4): + lb[:, 0] = i # add target image index for build_targets() + + return torch.stack(img4, 0), torch.cat(label4, 0), path4, shapes4 + + +# Ancillary functions -------------------------------------------------------------------------------------------------- +def create_folder(path='./new'): + # Create folder + if os.path.exists(path): + shutil.rmtree(path) # delete output folder + os.makedirs(path) # make new output folder + + +def flatten_recursive(path=DATASETS_DIR / 'coco128'): + # Flatten a recursive directory by bringing all files to top level + new_path = Path(str(path) + '_flat') + create_folder(new_path) + for file in tqdm(glob.glob(str(Path(path)) + '/**/*.*', recursive=True)): + shutil.copyfile(file, new_path / Path(file).name) + + +def extract_boxes(path=DATASETS_DIR / 'coco128'): # from utils.datasets import *; extract_boxes() + # Convert detection dataset into classification dataset, with one directory per class + path = Path(path) # images dir + shutil.rmtree(path / 'classifier') if (path / 'classifier').is_dir() else None # remove existing + files = list(path.rglob('*.*')) + n = len(files) # number of files + for im_file in tqdm(files, total=n): + if im_file.suffix[1:] in IMG_FORMATS: + # image + im = cv2.imread(str(im_file))[..., ::-1] # BGR to RGB + h, w = im.shape[:2] + + # labels + lb_file = Path(img2label_paths([str(im_file)])[0]) + if Path(lb_file).exists(): + with open(lb_file) as f: + lb = np.array([x.split() for x in f.read().strip().splitlines()], dtype=np.float32) # labels + + for j, x in enumerate(lb): + c = int(x[0]) # class + f = (path / 'classifier') / f'{c}' / f'{path.stem}_{im_file.stem}_{j}.jpg' # new filename + if not f.parent.is_dir(): + f.parent.mkdir(parents=True) + + b = x[1:] * [w, h, w, h] # box + # b[2:] = b[2:].max() # rectangle to square + b[2:] = b[2:] * 1.2 + 3 # pad + b = xywh2xyxy(b.reshape(-1, 4)).ravel().astype(np.int) + + b[[0, 2]] = np.clip(b[[0, 2]], 0, w) # clip boxes outside of image + b[[1, 3]] = np.clip(b[[1, 3]], 0, h) + assert cv2.imwrite(str(f), im[b[1]:b[3], b[0]:b[2]]), f'box failure in {f}' + + +def autosplit(path=DATASETS_DIR / 'coco128/images', weights=(0.9, 0.1, 0.0), annotated_only=False): + """ Autosplit a dataset into train/val/test splits and save path/autosplit_*.txt files + Usage: from utils.datasets import *; autosplit() + Arguments + path: Path to images directory + weights: Train, val, test weights (list, tuple) + annotated_only: Only use images with an annotated txt file + """ + path = Path(path) # images dir + files = sorted(x for x in path.rglob('*.*') if x.suffix[1:].lower() in IMG_FORMATS) # image files only + n = len(files) # number of files + random.seed(0) # for reproducibility + indices = random.choices([0, 1, 2], weights=weights, k=n) # assign each image to a split + + txt = ['autosplit_train.txt', 'autosplit_val.txt', 'autosplit_test.txt'] # 3 txt files + [(path.parent / x).unlink(missing_ok=True) for x in txt] # remove existing + + print(f'Autosplitting images from {path}' + ', using *.txt labeled images only' * annotated_only) + for i, img in tqdm(zip(indices, files), total=n): + if not annotated_only or Path(img2label_paths([str(img)])[0]).exists(): # check label + with open(path.parent / txt[i], 'a') as f: + f.write('./' + img.relative_to(path.parent).as_posix() + '\n') # add image to txt file + + +def verify_image_label(args): + # Verify one image-label pair + im_file, lb_file, prefix = args + nm, nf, ne, nc, msg, segments = 0, 0, 0, 0, '', [] # number (missing, found, empty, corrupt), message, segments + try: + # verify images + im = Image.open(im_file) + im.verify() # PIL verify + shape = exif_size(im) # image size + assert (shape[0] > 9) & (shape[1] > 9), f'image size {shape} <10 pixels' + assert im.format.lower() in IMG_FORMATS, f'invalid image format {im.format}' + if im.format.lower() in ('jpg', 'jpeg'): + with open(im_file, 'rb') as f: + f.seek(-2, 2) + if f.read() != b'\xff\xd9': # corrupt JPEG + ImageOps.exif_transpose(Image.open(im_file)).save(im_file, 'JPEG', subsampling=0, quality=100) + msg = f'{prefix}WARNING: {im_file}: corrupt JPEG restored and saved' + + # verify labels + if os.path.isfile(lb_file): + nf = 1 # label found + with open(lb_file) as f: + lb = [x.split() for x in f.read().strip().splitlines() if len(x)] + if any([len(x) > 8 for x in lb]): # is segment + classes = np.array([x[0] for x in lb], dtype=np.float32) + segments = [np.array(x[1:], dtype=np.float32).reshape(-1, 2) for x in lb] # (cls, xy1...) + lb = np.concatenate((classes.reshape(-1, 1), segments2boxes(segments)), 1) # (cls, xywh) + lb = np.array(lb, dtype=np.float32) + nl = len(lb) + if nl: + assert lb.shape[1] == 5, f'labels require 5 columns, {lb.shape[1]} columns detected' + assert (lb >= 0).all(), f'negative label values {lb[lb < 0]}' + assert (lb[:, 1:] <= 1).all(), f'non-normalized or out of bounds coordinates {lb[:, 1:][lb[:, 1:] > 1]}' + _, i = np.unique(lb, axis=0, return_index=True) + if len(i) < nl: # duplicate row check + lb = lb[i] # remove duplicates + if segments: + segments = segments[i] + msg = f'{prefix}WARNING: {im_file}: {nl - len(i)} duplicate labels removed' + else: + ne = 1 # label empty + lb = np.zeros((0, 5), dtype=np.float32) + else: + nm = 1 # label missing + lb = np.zeros((0, 5), dtype=np.float32) + return im_file, lb, shape, segments, nm, nf, ne, nc, msg + except Exception as e: + nc = 1 + msg = f'{prefix}WARNING: {im_file}: ignoring corrupt image/label: {e}' + return [None, None, None, None, nm, nf, ne, nc, msg] + + +def dataset_stats(path='coco128.yaml', autodownload=False, verbose=False, profile=False, hub=False): + """ Return dataset statistics dictionary with images and instances counts per split per class + To run in parent directory: export PYTHONPATH="$PWD/yolov5" + Usage1: from utils.datasets import *; dataset_stats('coco128.yaml', autodownload=True) + Usage2: from utils.datasets import *; dataset_stats('path/to/coco128_with_yaml.zip') + Arguments + path: Path to data.yaml or data.zip (with data.yaml inside data.zip) + autodownload: Attempt to download dataset if not found locally + verbose: Print stats dictionary + """ + + def round_labels(labels): + # Update labels to integer class and 6 decimal place floats + return [[int(c), *(round(x, 4) for x in points)] for c, *points in labels] + + def unzip(path): + # Unzip data.zip TODO: CONSTRAINT: path/to/abc.zip MUST unzip to 'path/to/abc/' + if str(path).endswith('.zip'): # path is data.zip + assert Path(path).is_file(), f'Error unzipping {path}, file not found' + ZipFile(path).extractall(path=path.parent) # unzip + dir = path.with_suffix('') # dataset directory == zip name + return True, str(dir), next(dir.rglob('*.yaml')) # zipped, data_dir, yaml_path + else: # path is data.yaml + return False, None, path + + def hub_ops(f, max_dim=1920): + # HUB ops for 1 image 'f': resize and save at reduced quality in /dataset-hub for web/app viewing + f_new = im_dir / Path(f).name # dataset-hub image filename + try: # use PIL + im = Image.open(f) + r = max_dim / max(im.height, im.width) # ratio + if r < 1.0: # image too large + im = im.resize((int(im.width * r), int(im.height * r))) + im.save(f_new, 'JPEG', quality=75, optimize=True) # save + except Exception as e: # use OpenCV + print(f'WARNING: HUB ops PIL failure {f}: {e}') + im = cv2.imread(f) + im_height, im_width = im.shape[:2] + r = max_dim / max(im_height, im_width) # ratio + if r < 1.0: # image too large + im = cv2.resize(im, (int(im_width * r), int(im_height * r)), interpolation=cv2.INTER_AREA) + cv2.imwrite(str(f_new), im) + + zipped, data_dir, yaml_path = unzip(Path(path)) + with open(check_yaml(yaml_path), errors='ignore') as f: + data = yaml.safe_load(f) # data dict + if zipped: + data['path'] = data_dir # TODO: should this be dir.resolve()? + check_dataset(data, autodownload) # download dataset if missing + hub_dir = Path(data['path'] + ('-hub' if hub else '')) + stats = {'nc': data['nc'], 'names': data['names']} # statistics dictionary + for split in 'train', 'val', 'test': + if data.get(split) is None: + stats[split] = None # i.e. no test set + continue + x = [] + dataset = LoadImagesAndLabels(data[split]) # load dataset + for label in tqdm(dataset.labels, total=dataset.n, desc='Statistics'): + x.append(np.bincount(label[:, 0].astype(int), minlength=data['nc'])) + x = np.array(x) # shape(128x80) + stats[split] = {'instance_stats': {'total': int(x.sum()), 'per_class': x.sum(0).tolist()}, + 'image_stats': {'total': dataset.n, 'unlabelled': int(np.all(x == 0, 1).sum()), + 'per_class': (x > 0).sum(0).tolist()}, + 'labels': [{str(Path(k).name): round_labels(v.tolist())} for k, v in + zip(dataset.img_files, dataset.labels)]} + + if hub: + im_dir = hub_dir / 'images' + im_dir.mkdir(parents=True, exist_ok=True) + for _ in tqdm(ThreadPool(NUM_THREADS).imap(hub_ops, dataset.img_files), total=dataset.n, desc='HUB Ops'): + pass + + # Profile + stats_path = hub_dir / 'stats.json' + if profile: + for _ in range(1): + file = stats_path.with_suffix('.npy') + t1 = time.time() + np.save(file, stats) + t2 = time.time() + x = np.load(file, allow_pickle=True) + print(f'stats.npy times: {time.time() - t2:.3f}s read, {t2 - t1:.3f}s write') + + file = stats_path.with_suffix('.json') + t1 = time.time() + with open(file, 'w') as f: + json.dump(stats, f) # save stats *.json + t2 = time.time() + with open(file) as f: + x = json.load(f) # load hyps dict + print(f'stats.json times: {time.time() - t2:.3f}s read, {t2 - t1:.3f}s write') + + # Save, print and return + if hub: + print(f'Saving {stats_path.resolve()}...') + with open(stats_path, 'w') as f: + json.dump(stats, f) # save stats.json + if verbose: + print(json.dumps(stats, indent=2, sort_keys=False)) + return stats diff --git a/yolov5_Monocular_social_ranging/utils/downloads.py b/yolov5_Monocular_social_ranging/utils/downloads.py new file mode 100644 index 0000000..d7b87cb --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/downloads.py @@ -0,0 +1,153 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +Download utils +""" + +import os +import platform +import subprocess +import time +import urllib +from pathlib import Path +from zipfile import ZipFile + +import requests +import torch + + +def gsutil_getsize(url=''): + # gs://bucket/file size https://cloud.google.com/storage/docs/gsutil/commands/du + s = subprocess.check_output(f'gsutil du {url}', shell=True).decode('utf-8') + return eval(s.split(' ')[0]) if len(s) else 0 # bytes + + +def safe_download(file, url, url2=None, min_bytes=1E0, error_msg=''): + # Attempts to download file from url or url2, checks and removes incomplete downloads < min_bytes + file = Path(file) + assert_msg = f"Downloaded file '{file}' does not exist or size is < min_bytes={min_bytes}" + try: # url1 + print(f'Downloading {url} to {file}...') + torch.hub.download_url_to_file(url, str(file)) + assert file.exists() and file.stat().st_size > min_bytes, assert_msg # check + except Exception as e: # url2 + file.unlink(missing_ok=True) # remove partial downloads + print(f'ERROR: {e}\nRe-attempting {url2 or url} to {file}...') + os.system(f"curl -L '{url2 or url}' -o '{file}' --retry 3 -C -") # curl download, retry and resume on fail + finally: + if not file.exists() or file.stat().st_size < min_bytes: # check + file.unlink(missing_ok=True) # remove partial downloads + print(f"ERROR: {assert_msg}\n{error_msg}") + print('') + + +def attempt_download(file, repo='ultralytics/yolov5'): # from utils.downloads import *; attempt_download() + # Attempt file download if does not exist + file = Path(str(file).strip().replace("'", '')) + + if not file.exists(): + # URL specified + name = Path(urllib.parse.unquote(str(file))).name # decode '%2F' to '/' etc. + if str(file).startswith(('http:/', 'https:/')): # download + url = str(file).replace(':/', '://') # Pathlib turns :// -> :/ + file = name.split('?')[0] # parse authentication https://url.com/file.txt?auth... + if Path(file).is_file(): + print(f'Found {url} locally at {file}') # file already exists + else: + safe_download(file=file, url=url, min_bytes=1E5) + return file + + # GitHub assets + file.parent.mkdir(parents=True, exist_ok=True) # make parent dir (if required) + try: + response = requests.get(f'https://api.github.com/repos/{repo}/releases/latest').json() # github api + assets = [x['name'] for x in response['assets']] # release assets, i.e. ['yolov5s.pt', 'yolov5m.pt', ...] + tag = response['tag_name'] # i.e. 'v1.0' + except Exception: # fallback plan + assets = ['yolov5n.pt', 'yolov5s.pt', 'yolov5m.pt', 'yolov5l.pt', 'yolov5x.pt', + 'yolov5n6.pt', 'yolov5s6.pt', 'yolov5m6.pt', 'yolov5l6.pt', 'yolov5x6.pt'] + try: + tag = subprocess.check_output('git tag', shell=True, stderr=subprocess.STDOUT).decode().split()[-1] + except Exception: + tag = 'v6.0' # current release + + if name in assets: + safe_download(file, + url=f'https://github.com/{repo}/releases/download/{tag}/{name}', + # url2=f'https://storage.googleapis.com/{repo}/ckpt/{name}', # backup url (optional) + min_bytes=1E5, + error_msg=f'{file} missing, try downloading from https://github.com/{repo}/releases/') + + return str(file) + + +def gdrive_download(id='16TiPfZj7htmTyhntwcZyEEAejOUxuT6m', file='tmp.zip'): + # Downloads a file from Google Drive. from yolov5.utils.downloads import *; gdrive_download() + t = time.time() + file = Path(file) + cookie = Path('cookie') # gdrive cookie + print(f'Downloading https://drive.google.com/uc?export=download&id={id} as {file}... ', end='') + file.unlink(missing_ok=True) # remove existing file + cookie.unlink(missing_ok=True) # remove existing cookie + + # Attempt file download + out = "NUL" if platform.system() == "Windows" else "/dev/null" + os.system(f'curl -c ./cookie -s -L "drive.google.com/uc?export=download&id={id}" > {out}') + if os.path.exists('cookie'): # large file + s = f'curl -Lb ./cookie "drive.google.com/uc?export=download&confirm={get_token()}&id={id}" -o {file}' + else: # small file + s = f'curl -s -L -o {file} "drive.google.com/uc?export=download&id={id}"' + r = os.system(s) # execute, capture return + cookie.unlink(missing_ok=True) # remove existing cookie + + # Error check + if r != 0: + file.unlink(missing_ok=True) # remove partial + print('Download error ') # raise Exception('Download error') + return r + + # Unzip if archive + if file.suffix == '.zip': + print('unzipping... ', end='') + ZipFile(file).extractall(path=file.parent) # unzip + file.unlink() # remove zip + + print(f'Done ({time.time() - t:.1f}s)') + return r + + +def get_token(cookie="./cookie"): + with open(cookie) as f: + for line in f: + if "download" in line: + return line.split()[-1] + return "" + +# Google utils: https://cloud.google.com/storage/docs/reference/libraries ---------------------------------------------- +# +# +# def upload_blob(bucket_name, source_file_name, destination_blob_name): +# # Uploads a file to a bucket +# # https://cloud.google.com/storage/docs/uploading-objects#storage-upload-object-python +# +# storage_client = storage.Client() +# bucket = storage_client.get_bucket(bucket_name) +# blob = bucket.blob(destination_blob_name) +# +# blob.upload_from_filename(source_file_name) +# +# print('File {} uploaded to {}.'.format( +# source_file_name, +# destination_blob_name)) +# +# +# def download_blob(bucket_name, source_blob_name, destination_file_name): +# # Uploads a blob from a bucket +# storage_client = storage.Client() +# bucket = storage_client.get_bucket(bucket_name) +# blob = bucket.blob(source_blob_name) +# +# blob.download_to_filename(destination_file_name) +# +# print('Blob {} downloaded to {}.'.format( +# source_blob_name, +# destination_file_name)) diff --git a/yolov5_Monocular_social_ranging/utils/flask_rest_api/README.md b/yolov5_Monocular_social_ranging/utils/flask_rest_api/README.md new file mode 100644 index 0000000..a726acb --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/flask_rest_api/README.md @@ -0,0 +1,73 @@ +# Flask REST API + +[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/). + +## Requirements + +[Flask](https://palletsprojects.com/p/flask/) is required. Install with: + +```shell +$ pip install Flask +``` + +## Run + +After Flask installation run: + +```shell +$ python3 restapi.py --port 5000 +``` + +Then use [curl](https://curl.se/) to perform a request: + +```shell +$ curl -X POST -F image=@zidane.jpg 'http://localhost:5000/v1/object-detection/yolov5s' +``` + +The model inference results are returned as a JSON response: + +```json +[ + { + "class": 0, + "confidence": 0.8900438547, + "height": 0.9318675399, + "name": "person", + "width": 0.3264600933, + "xcenter": 0.7438579798, + "ycenter": 0.5207948685 + }, + { + "class": 0, + "confidence": 0.8440024257, + "height": 0.7155083418, + "name": "person", + "width": 0.6546785235, + "xcenter": 0.427829951, + "ycenter": 0.6334488392 + }, + { + "class": 27, + "confidence": 0.3771208823, + "height": 0.3902671337, + "name": "tie", + "width": 0.0696444362, + "xcenter": 0.3675483763, + "ycenter": 0.7991207838 + }, + { + "class": 27, + "confidence": 0.3527112305, + "height": 0.1540903747, + "name": "tie", + "width": 0.0336618312, + "xcenter": 0.7814827561, + "ycenter": 0.5065554976 + } +] +``` + +An example python script to perform inference using [requests](https://docs.python-requests.org/en/master/) is given +in `example_request.py` diff --git a/yolov5_Monocular_social_ranging/utils/flask_rest_api/example_request.py b/yolov5_Monocular_social_ranging/utils/flask_rest_api/example_request.py new file mode 100644 index 0000000..ff21f30 --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/flask_rest_api/example_request.py @@ -0,0 +1,13 @@ +"""Perform test request""" +import pprint + +import requests + +DETECTION_URL = "http://localhost:5000/v1/object-detection/yolov5s" +TEST_IMAGE = "zidane.jpg" + +image_data = open(TEST_IMAGE, "rb").read() + +response = requests.post(DETECTION_URL, files={"image": image_data}).json() + +pprint.pprint(response) diff --git a/yolov5_Monocular_social_ranging/utils/flask_rest_api/restapi.py b/yolov5_Monocular_social_ranging/utils/flask_rest_api/restapi.py new file mode 100644 index 0000000..b93ad16 --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/flask_rest_api/restapi.py @@ -0,0 +1,37 @@ +""" +Run a rest API exposing the yolov5s object detection model +""" +import argparse +import io + +import torch +from flask import Flask, request +from PIL import Image + +app = Flask(__name__) + +DETECTION_URL = "/v1/object-detection/yolov5s" + + +@app.route(DETECTION_URL, methods=["POST"]) +def predict(): + if not request.method == "POST": + return + + if request.files.get("image"): + image_file = request.files["image"] + image_bytes = image_file.read() + + img = Image.open(io.BytesIO(image_bytes)) + + results = model(img, size=640) # reduce size=320 for faster inference + return results.pandas().xyxy[0].to_json(orient="records") + + +if __name__ == "__main__": + parser = argparse.ArgumentParser(description="Flask API exposing YOLOv5 model") + parser.add_argument("--port", default=5000, type=int, help="port number") + args = parser.parse_args() + + model = torch.hub.load("ultralytics/yolov5", "yolov5s", force_reload=True) # force_reload to recache + app.run(host="0.0.0.0", port=args.port) # debug=True causes Restarting with stat diff --git a/yolov5_Monocular_social_ranging/utils/general.py b/yolov5_Monocular_social_ranging/utils/general.py new file mode 100644 index 0000000..3044b9c --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/general.py @@ -0,0 +1,880 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +General utils +""" + +import contextlib +import glob +import logging +import math +import os +import platform +import random +import re +import shutil +import signal +import time +import urllib +from itertools import repeat +from multiprocessing.pool import ThreadPool +from pathlib import Path +from subprocess import check_output +from zipfile import ZipFile + +import cv2 +import numpy as np +import pandas as pd +import pkg_resources as pkg +import torch +import torchvision +import yaml + +from utils.downloads import gsutil_getsize +from utils.metrics import box_iou, fitness + +# Settings +FILE = Path(__file__).resolve() +ROOT = FILE.parents[1] # YOLOv5 root directory +DATASETS_DIR = ROOT.parent / 'datasets' # YOLOv5 datasets directory +NUM_THREADS = min(8, max(1, os.cpu_count() - 1)) # number of YOLOv5 multiprocessing threads +VERBOSE = str(os.getenv('YOLOv5_VERBOSE', True)).lower() == 'true' # global verbose mode +FONT = 'Arial.ttf' # https://ultralytics.com/assets/Arial.ttf + +torch.set_printoptions(linewidth=320, precision=5, profile='long') +np.set_printoptions(linewidth=320, formatter={'float_kind': '{:11.5g}'.format}) # format short g, %precision=5 +pd.options.display.max_columns = 10 +cv2.setNumThreads(0) # prevent OpenCV from multithreading (incompatible with PyTorch DataLoader) +os.environ['NUMEXPR_MAX_THREADS'] = str(NUM_THREADS) # NumExpr max threads + + +def is_kaggle(): + # Is environment a Kaggle Notebook? + try: + assert os.environ.get('PWD') == '/kaggle/working' + assert os.environ.get('KAGGLE_URL_BASE') == 'https://www.kaggle.com' + return True + except AssertionError: + return False + + +def is_writeable(dir, test=False): + # Return True if directory has write permissions, test opening a file with write permissions if test=True + if test: # method 1 + file = Path(dir) / 'tmp.txt' + try: + with open(file, 'w'): # open file with write permissions + pass + file.unlink() # remove file + return True + except OSError: + return False + else: # method 2 + return os.access(dir, os.R_OK) # possible issues on Windows + + +def set_logging(name=None, verbose=VERBOSE): + # Sets level and returns logger + if is_kaggle(): + for h in logging.root.handlers: + logging.root.removeHandler(h) # remove all handlers associated with the root logger object + rank = int(os.getenv('RANK', -1)) # rank in world for Multi-GPU trainings + logging.basicConfig(format="%(message)s", level=logging.INFO if (verbose and rank in (-1, 0)) else logging.WARNING) + return logging.getLogger(name) + + +LOGGER = set_logging('yolov5') # define globally (used in train.py, val.py, detect.py, etc.) + + +def user_config_dir(dir='Ultralytics', env_var='YOLOV5_CONFIG_DIR'): + # Return path of user configuration directory. Prefer environment variable if exists. Make dir if required. + env = os.getenv(env_var) + if env: + path = Path(env) # use environment variable + else: + cfg = {'Windows': 'AppData/Roaming', 'Linux': '.config', 'Darwin': 'Library/Application Support'} # 3 OS dirs + path = Path.home() / cfg.get(platform.system(), '') # OS-specific config dir + path = (path if is_writeable(path) else Path('/tmp')) / dir # GCP and AWS lambda fix, only /tmp is writeable + path.mkdir(exist_ok=True) # make if required + return path + + +CONFIG_DIR = user_config_dir() # Ultralytics settings dir + + +class Profile(contextlib.ContextDecorator): + # Usage: @Profile() decorator or 'with Profile():' context manager + def __enter__(self): + self.start = time.time() + + def __exit__(self, type, value, traceback): + print(f'Profile results: {time.time() - self.start:.5f}s') + + +class Timeout(contextlib.ContextDecorator): + # Usage: @Timeout(seconds) decorator or 'with Timeout(seconds):' context manager + def __init__(self, seconds, *, timeout_msg='', suppress_timeout_errors=True): + self.seconds = int(seconds) + self.timeout_message = timeout_msg + self.suppress = bool(suppress_timeout_errors) + + def _timeout_handler(self, signum, frame): + raise TimeoutError(self.timeout_message) + + def __enter__(self): + signal.signal(signal.SIGALRM, self._timeout_handler) # Set handler for SIGALRM + signal.alarm(self.seconds) # start countdown for SIGALRM to be raised + + def __exit__(self, exc_type, exc_val, exc_tb): + signal.alarm(0) # Cancel SIGALRM if it's scheduled + if self.suppress and exc_type is TimeoutError: # Suppress TimeoutError + return True + + +class WorkingDirectory(contextlib.ContextDecorator): + # Usage: @WorkingDirectory(dir) decorator or 'with WorkingDirectory(dir):' context manager + def __init__(self, new_dir): + self.dir = new_dir # new dir + self.cwd = Path.cwd().resolve() # current dir + + def __enter__(self): + os.chdir(self.dir) + + def __exit__(self, exc_type, exc_val, exc_tb): + os.chdir(self.cwd) + + +def try_except(func): + # try-except function. Usage: @try_except decorator + def handler(*args, **kwargs): + try: + func(*args, **kwargs) + except Exception as e: + print(e) + + return handler + + +def methods(instance): + # Get class/instance methods + return [f for f in dir(instance) if callable(getattr(instance, f)) and not f.startswith("__")] + + +def print_args(name, opt): + # Print argparser arguments + LOGGER.info(colorstr(f'{name}: ') + ', '.join(f'{k}={v}' for k, v in vars(opt).items())) + + +def init_seeds(seed=0): + # Initialize random number generator (RNG) seeds https://pytorch.org/docs/stable/notes/randomness.html + # cudnn seed 0 settings are slower and more reproducible, else faster and less reproducible + import torch.backends.cudnn as cudnn + random.seed(seed) + np.random.seed(seed) + torch.manual_seed(seed) + cudnn.benchmark, cudnn.deterministic = (False, True) if seed == 0 else (True, False) + + +def intersect_dicts(da, db, exclude=()): + # Dictionary intersection of matching keys and shapes, omitting 'exclude' keys, using da values + return {k: v for k, v in da.items() if k in db and not any(x in k for x in exclude) and v.shape == db[k].shape} + + +def get_latest_run(search_dir='.'): + # Return path to most recent 'last.pt' in /runs (i.e. to --resume from) + last_list = glob.glob(f'{search_dir}/**/last*.pt', recursive=True) + return max(last_list, key=os.path.getctime) if last_list else '' + + +def is_docker(): + # Is environment a Docker container? + return Path('/workspace').exists() # or Path('/.dockerenv').exists() + + +def is_colab(): + # Is environment a Google Colab instance? + try: + import google.colab + return True + except ImportError: + return False + + +def is_pip(): + # Is file in a pip package? + return 'site-packages' in Path(__file__).resolve().parts + + +def is_ascii(s=''): + # Is string composed of all ASCII (no UTF) characters? (note str().isascii() introduced in python 3.7) + s = str(s) # convert list, tuple, None, etc. to str + return len(s.encode().decode('ascii', 'ignore')) == len(s) + + +def is_chinese(s='人工智能'): + # Is string composed of any Chinese characters? + return True if re.search('[\u4e00-\u9fff]', str(s)) else False + + +def emojis(str=''): + # Return platform-dependent emoji-safe version of string + return str.encode().decode('ascii', 'ignore') if platform.system() == 'Windows' else str + + +def file_size(path): + # Return file/dir size (MB) + path = Path(path) + if path.is_file(): + return path.stat().st_size / 1E6 + elif path.is_dir(): + return sum(f.stat().st_size for f in path.glob('**/*') if f.is_file()) / 1E6 + else: + return 0.0 + + +def check_online(): + # Check internet connectivity + import socket + try: + socket.create_connection(("1.1.1.1", 443), 5) # check host accessibility + return True + except OSError: + return False + + +@try_except +@WorkingDirectory(ROOT) +def check_git_status(): + # Recommend 'git pull' if code is out of date + msg = ', for updates see https://github.com/ultralytics/yolov5' + s = colorstr('github: ') # string + assert Path('.git').exists(), s + 'skipping check (not a git repository)' + msg + assert not is_docker(), s + 'skipping check (Docker image)' + msg + assert check_online(), s + 'skipping check (offline)' + msg + + cmd = 'git fetch && git config --get remote.origin.url' + url = check_output(cmd, shell=True, timeout=5).decode().strip().rstrip('.git') # git fetch + branch = check_output('git rev-parse --abbrev-ref HEAD', shell=True).decode().strip() # checked out + n = int(check_output(f'git rev-list {branch}..origin/master --count', shell=True)) # commits behind + if n > 0: + s += f"⚠️ YOLOv5 is out of date by {n} commit{'s' * (n > 1)}. Use `git pull` or `git clone {url}` to update." + else: + s += f'up to date with {url} ✅' + LOGGER.info(emojis(s)) # emoji-safe + + +def check_python(minimum='3.6.2'): + # Check current python version vs. required python version + check_version(platform.python_version(), minimum, name='Python ', hard=True) + + +def check_version(current='0.0.0', minimum='0.0.0', name='version ', pinned=False, hard=False, verbose=False): + # Check version vs. required version + current, minimum = (pkg.parse_version(x) for x in (current, minimum)) + result = (current == minimum) if pinned else (current >= minimum) # bool + s = f'{name}{minimum} required by YOLOv5, but {name}{current} is currently installed' # string + if hard: + assert result, s # assert min requirements met + if verbose and not result: + LOGGER.warning(s) + return result + + +@try_except +def check_requirements(requirements=ROOT / 'requirements.txt', exclude=(), install=True): + # Check installed dependencies meet requirements (pass *.txt file or list of packages) + prefix = colorstr('red', 'bold', 'requirements:') + check_python() # check python version + if isinstance(requirements, (str, Path)): # requirements.txt file + file = Path(requirements) + assert file.exists(), f"{prefix} {file.resolve()} not found, check failed." + with file.open() as f: + requirements = [f'{x.name}{x.specifier}' for x in pkg.parse_requirements(f) if x.name not in exclude] + else: # list or tuple of packages + requirements = [x for x in requirements if x not in exclude] + + n = 0 # number of packages updates + for r in requirements: + try: + pkg.require(r) + except Exception: # DistributionNotFound or VersionConflict if requirements not met + s = f"{prefix} {r} not found and is required by YOLOv5" + if install: + LOGGER.info(f"{s}, attempting auto-update...") + try: + assert check_online(), f"'pip install {r}' skipped (offline)" + LOGGER.info(check_output(f"pip install '{r}'", shell=True).decode()) + n += 1 + except Exception as e: + LOGGER.warning(f'{prefix} {e}') + else: + LOGGER.info(f'{s}. Please install and rerun your command.') + + if n: # if packages updated + source = file.resolve() if 'file' in locals() else requirements + s = f"{prefix} {n} package{'s' * (n > 1)} updated per {source}\n" \ + f"{prefix} ⚠️ {colorstr('bold', 'Restart runtime or rerun command for updates to take effect')}\n" + LOGGER.info(emojis(s)) + + +def check_img_size(imgsz, s=32, floor=0): + # Verify image size is a multiple of stride s in each dimension + if isinstance(imgsz, int): # integer i.e. img_size=640 + new_size = max(make_divisible(imgsz, int(s)), floor) + else: # list i.e. img_size=[640, 480] + new_size = [max(make_divisible(x, int(s)), floor) for x in imgsz] + if new_size != imgsz: + LOGGER.warning(f'WARNING: --img-size {imgsz} must be multiple of max stride {s}, updating to {new_size}') + return new_size + + +def check_imshow(): + # Check if environment supports image displays + try: + assert not is_docker(), 'cv2.imshow() is disabled in Docker environments' + assert not is_colab(), 'cv2.imshow() is disabled in Google Colab environments' + cv2.imshow('test', np.zeros((1, 1, 3))) + cv2.waitKey(1) + cv2.destroyAllWindows() + cv2.waitKey(1) + return True + except Exception as e: + LOGGER.warning(f'WARNING: Environment does not support cv2.imshow() or PIL Image.show() image displays\n{e}') + return False + + +def check_suffix(file='yolov5s.pt', suffix=('.pt',), msg=''): + # Check file(s) for acceptable suffix + if file and suffix: + if isinstance(suffix, str): + suffix = [suffix] + for f in file if isinstance(file, (list, tuple)) else [file]: + s = Path(f).suffix.lower() # file suffix + if len(s): + assert s in suffix, f"{msg}{f} acceptable suffix is {suffix}" + + +def check_yaml(file, suffix=('.yaml', '.yml')): + # Search/download YAML file (if necessary) and return path, checking suffix + return check_file(file, suffix) + + +def check_file(file, suffix=''): + # Search/download file (if necessary) and return path + check_suffix(file, suffix) # optional + file = str(file) # convert to str() + if Path(file).is_file() or file == '': # exists + return file + elif file.startswith(('http:/', 'https:/')): # download + url = str(Path(file)).replace(':/', '://') # Pathlib turns :// -> :/ + file = Path(urllib.parse.unquote(file).split('?')[0]).name # '%2F' to '/', split https://url.com/file.txt?auth + if Path(file).is_file(): + LOGGER.info(f'Found {url} locally at {file}') # file already exists + else: + LOGGER.info(f'Downloading {url} to {file}...') + torch.hub.download_url_to_file(url, file) + assert Path(file).exists() and Path(file).stat().st_size > 0, f'File download failed: {url}' # check + return file + else: # search + files = [] + for d in 'data', 'models', 'utils': # search directories + files.extend(glob.glob(str(ROOT / d / '**' / file), recursive=True)) # find file + assert len(files), f'File not found: {file}' # assert file was found + assert len(files) == 1, f"Multiple files match '{file}', specify exact path: {files}" # assert unique + return files[0] # return file + + +def check_font(font=FONT): + # Download font to CONFIG_DIR if necessary + font = Path(font) + if not font.exists() and not (CONFIG_DIR / font.name).exists(): + url = "https://ultralytics.com/assets/" + font.name + LOGGER.info(f'Downloading {url} to {CONFIG_DIR / font.name}...') + torch.hub.download_url_to_file(url, str(font), progress=False) + + +def check_dataset(data, autodownload=True): + # Download and/or unzip dataset if not found locally + # Usage: https://github.com/ultralytics/yolov5/releases/download/v1.0/coco128_with_yaml.zip + + # Download (optional) + extract_dir = '' + if isinstance(data, (str, Path)) and str(data).endswith('.zip'): # i.e. gs://bucket/dir/coco128.zip + download(data, dir=DATASETS_DIR, unzip=True, delete=False, curl=False, threads=1) + data = next((DATASETS_DIR / Path(data).stem).rglob('*.yaml')) + extract_dir, autodownload = data.parent, False + + # Read yaml (optional) + if isinstance(data, (str, Path)): + with open(data, errors='ignore') as f: + data = yaml.safe_load(f) # dictionary + + # Resolve paths + path = Path(extract_dir or data.get('path') or '') # optional 'path' default to '.' + if not path.is_absolute(): + path = (ROOT / path).resolve() + for k in 'train', 'val', 'test': + if data.get(k): # prepend path + data[k] = str(path / data[k]) if isinstance(data[k], str) else [str(path / x) for x in data[k]] + + # Parse yaml + assert 'nc' in data, "Dataset 'nc' key missing." + if 'names' not in data: + data['names'] = [f'class{i}' for i in range(data['nc'])] # assign class names if missing + train, val, test, s = (data.get(x) for x in ('train', 'val', 'test', 'download')) + if val: + val = [Path(x).resolve() for x in (val if isinstance(val, list) else [val])] # val path + if not all(x.exists() for x in val): + LOGGER.info('\nDataset not found, missing paths: %s' % [str(x) for x in val if not x.exists()]) + if s and autodownload: # download script + root = path.parent if 'path' in data else '..' # unzip directory i.e. '../' + if s.startswith('http') and s.endswith('.zip'): # URL + f = Path(s).name # filename + LOGGER.info(f'Downloading {s} to {f}...') + torch.hub.download_url_to_file(s, f) + Path(root).mkdir(parents=True, exist_ok=True) # create root + ZipFile(f).extractall(path=root) # unzip + Path(f).unlink() # remove zip + r = None # success + elif s.startswith('bash '): # bash script + LOGGER.info(f'Running {s} ...') + r = os.system(s) + else: # python script + r = exec(s, {'yaml': data}) # return None + LOGGER.info(f"Dataset autodownload {f'success, saved to {root}' if r in (0, None) else 'failure'}\n") + else: + raise Exception('Dataset not found.') + + return data # dictionary + + +def url2file(url): + # Convert URL to filename, i.e. https://url.com/file.txt?auth -> file.txt + url = str(Path(url)).replace(':/', '://') # Pathlib turns :// -> :/ + file = Path(urllib.parse.unquote(url)).name.split('?')[0] # '%2F' to '/', split https://url.com/file.txt?auth + return file + + +def download(url, dir='.', unzip=True, delete=True, curl=False, threads=1): + # Multi-threaded file download and unzip function, used in data.yaml for autodownload + def download_one(url, dir): + # Download 1 file + f = dir / Path(url).name # filename + if Path(url).is_file(): # exists in current path + Path(url).rename(f) # move to dir + elif not f.exists(): + LOGGER.info(f'Downloading {url} to {f}...') + if curl: + os.system(f"curl -L '{url}' -o '{f}' --retry 9 -C -") # curl download, retry and resume on fail + else: + torch.hub.download_url_to_file(url, f, progress=True) # torch download + if unzip and f.suffix in ('.zip', '.gz'): + LOGGER.info(f'Unzipping {f}...') + if f.suffix == '.zip': + ZipFile(f).extractall(path=dir) # unzip + elif f.suffix == '.gz': + os.system(f'tar xfz {f} --directory {f.parent}') # unzip + if delete: + f.unlink() # remove zip + + dir = Path(dir) + dir.mkdir(parents=True, exist_ok=True) # make directory + if threads > 1: + pool = ThreadPool(threads) + pool.imap(lambda x: download_one(*x), zip(url, repeat(dir))) # multi-threaded + pool.close() + pool.join() + else: + for u in [url] if isinstance(url, (str, Path)) else url: + download_one(u, dir) + + +def make_divisible(x, divisor): + # Returns nearest x divisible by divisor + if isinstance(divisor, torch.Tensor): + divisor = int(divisor.max()) # to int + return math.ceil(x / divisor) * divisor + + +def clean_str(s): + # Cleans a string by replacing special characters with underscore _ + return re.sub(pattern="[|@#!¡·$€%&()=?¿^*;:,¨´><+]", repl="_", string=s) + + +def one_cycle(y1=0.0, y2=1.0, steps=100): + # lambda function for sinusoidal ramp from y1 to y2 https://arxiv.org/pdf/1812.01187.pdf + return lambda x: ((1 - math.cos(x * math.pi / steps)) / 2) * (y2 - y1) + y1 + + +def colorstr(*input): + # Colors a string https://en.wikipedia.org/wiki/ANSI_escape_code, i.e. colorstr('blue', 'hello world') + *args, string = input if len(input) > 1 else ('blue', 'bold', input[0]) # color arguments, string + colors = {'black': '\033[30m', # basic colors + 'red': '\033[31m', + 'green': '\033[32m', + 'yellow': '\033[33m', + 'blue': '\033[34m', + 'magenta': '\033[35m', + 'cyan': '\033[36m', + 'white': '\033[37m', + 'bright_black': '\033[90m', # bright colors + 'bright_red': '\033[91m', + 'bright_green': '\033[92m', + 'bright_yellow': '\033[93m', + 'bright_blue': '\033[94m', + 'bright_magenta': '\033[95m', + 'bright_cyan': '\033[96m', + 'bright_white': '\033[97m', + 'end': '\033[0m', # misc + 'bold': '\033[1m', + 'underline': '\033[4m'} + return ''.join(colors[x] for x in args) + f'{string}' + colors['end'] + + +def labels_to_class_weights(labels, nc=80): + # Get class weights (inverse frequency) from training labels + if labels[0] is None: # no labels loaded + return torch.Tensor() + + labels = np.concatenate(labels, 0) # labels.shape = (866643, 5) for COCO + classes = labels[:, 0].astype(np.int) # labels = [class xywh] + weights = np.bincount(classes, minlength=nc) # occurrences per class + + # Prepend gridpoint count (for uCE training) + # gpi = ((320 / 32 * np.array([1, 2, 4])) ** 2 * 3).sum() # gridpoints per image + # weights = np.hstack([gpi * len(labels) - weights.sum() * 9, weights * 9]) ** 0.5 # prepend gridpoints to start + + weights[weights == 0] = 1 # replace empty bins with 1 + weights = 1 / weights # number of targets per class + weights /= weights.sum() # normalize + return torch.from_numpy(weights) + + +def labels_to_image_weights(labels, nc=80, class_weights=np.ones(80)): + # Produces image weights based on class_weights and image contents + class_counts = np.array([np.bincount(x[:, 0].astype(np.int), minlength=nc) for x in labels]) + image_weights = (class_weights.reshape(1, nc) * class_counts).sum(1) + # index = random.choices(range(n), weights=image_weights, k=1) # weight image sample + return image_weights + + +def coco80_to_coco91_class(): # converts 80-index (val2014) to 91-index (paper) + # https://tech.amikelive.com/node-718/what-object-categories-labels-are-in-coco-dataset/ + # a = np.loadtxt('data/coco.names', dtype='str', delimiter='\n') + # b = np.loadtxt('data/coco_paper.names', dtype='str', delimiter='\n') + # x1 = [list(a[i] == b).index(True) + 1 for i in range(80)] # darknet to coco + # x2 = [list(b[i] == a).index(True) if any(b[i] == a) else None for i in range(91)] # coco to darknet + x = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 27, 28, 31, 32, 33, 34, + 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, + 64, 65, 67, 70, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 84, 85, 86, 87, 88, 89, 90] + return x + + +def xyxy2xywh(x): + # Convert nx4 boxes from [x1, y1, x2, y2] to [x, y, w, h] where xy1=top-left, xy2=bottom-right + y = x.clone() if isinstance(x, torch.Tensor) else np.copy(x) + y[:, 0] = (x[:, 0] + x[:, 2]) / 2 # x center + y[:, 1] = (x[:, 1] + x[:, 3]) / 2 # y center + y[:, 2] = x[:, 2] - x[:, 0] # width + y[:, 3] = x[:, 3] - x[:, 1] # height + return y + + +def xywh2xyxy(x): + # Convert nx4 boxes from [x, y, w, h] to [x1, y1, x2, y2] where xy1=top-left, xy2=bottom-right + y = x.clone() if isinstance(x, torch.Tensor) else np.copy(x) + y[:, 0] = x[:, 0] - x[:, 2] / 2 # top left x + y[:, 1] = x[:, 1] - x[:, 3] / 2 # top left y + y[:, 2] = x[:, 0] + x[:, 2] / 2 # bottom right x + y[:, 3] = x[:, 1] + x[:, 3] / 2 # bottom right y + return y + + +def xywhn2xyxy(x, w=640, h=640, padw=0, padh=0): + # Convert nx4 boxes from [x, y, w, h] normalized to [x1, y1, x2, y2] where xy1=top-left, xy2=bottom-right + y = x.clone() if isinstance(x, torch.Tensor) else np.copy(x) + y[:, 0] = w * (x[:, 0] - x[:, 2] / 2) + padw # top left x + y[:, 1] = h * (x[:, 1] - x[:, 3] / 2) + padh # top left y + y[:, 2] = w * (x[:, 0] + x[:, 2] / 2) + padw # bottom right x + y[:, 3] = h * (x[:, 1] + x[:, 3] / 2) + padh # bottom right y + return y + + +def xyxy2xywhn(x, w=640, h=640, clip=False, eps=0.0): + # Convert nx4 boxes from [x1, y1, x2, y2] to [x, y, w, h] normalized where xy1=top-left, xy2=bottom-right + if clip: + clip_coords(x, (h - eps, w - eps)) # warning: inplace clip + y = x.clone() if isinstance(x, torch.Tensor) else np.copy(x) + y[:, 0] = ((x[:, 0] + x[:, 2]) / 2) / w # x center + y[:, 1] = ((x[:, 1] + x[:, 3]) / 2) / h # y center + y[:, 2] = (x[:, 2] - x[:, 0]) / w # width + y[:, 3] = (x[:, 3] - x[:, 1]) / h # height + return y + + +def xyn2xy(x, w=640, h=640, padw=0, padh=0): + # Convert normalized segments into pixel segments, shape (n,2) + y = x.clone() if isinstance(x, torch.Tensor) else np.copy(x) + y[:, 0] = w * x[:, 0] + padw # top left x + y[:, 1] = h * x[:, 1] + padh # top left y + return y + + +def segment2box(segment, width=640, height=640): + # Convert 1 segment label to 1 box label, applying inside-image constraint, i.e. (xy1, xy2, ...) to (xyxy) + x, y = segment.T # segment xy + inside = (x >= 0) & (y >= 0) & (x <= width) & (y <= height) + x, y, = x[inside], y[inside] + return np.array([x.min(), y.min(), x.max(), y.max()]) if any(x) else np.zeros((1, 4)) # xyxy + + +def segments2boxes(segments): + # Convert segment labels to box labels, i.e. (cls, xy1, xy2, ...) to (cls, xywh) + boxes = [] + for s in segments: + x, y = s.T # segment xy + boxes.append([x.min(), y.min(), x.max(), y.max()]) # cls, xyxy + return xyxy2xywh(np.array(boxes)) # cls, xywh + + +def resample_segments(segments, n=1000): + # Up-sample an (n,2) segment + for i, s in enumerate(segments): + x = np.linspace(0, len(s) - 1, n) + xp = np.arange(len(s)) + segments[i] = np.concatenate([np.interp(x, xp, s[:, i]) for i in range(2)]).reshape(2, -1).T # segment xy + return segments + + +def scale_coords(img1_shape, coords, img0_shape, ratio_pad=None): + # Rescale coords (xyxy) from img1_shape to img0_shape + if ratio_pad is None: # calculate from img0_shape + gain = min(img1_shape[0] / img0_shape[0], img1_shape[1] / img0_shape[1]) # gain = old / new + pad = (img1_shape[1] - img0_shape[1] * gain) / 2, (img1_shape[0] - img0_shape[0] * gain) / 2 # wh padding + else: + gain = ratio_pad[0][0] + pad = ratio_pad[1] + + coords[:, [0, 2]] -= pad[0] # x padding + coords[:, [1, 3]] -= pad[1] # y padding + coords[:, :4] /= gain + clip_coords(coords, img0_shape) + return coords + + +def clip_coords(boxes, shape): + # Clip bounding xyxy bounding boxes to image shape (height, width) + if isinstance(boxes, torch.Tensor): # faster individually + boxes[:, 0].clamp_(0, shape[1]) # x1 + boxes[:, 1].clamp_(0, shape[0]) # y1 + boxes[:, 2].clamp_(0, shape[1]) # x2 + boxes[:, 3].clamp_(0, shape[0]) # y2 + else: # np.array (faster grouped) + boxes[:, [0, 2]] = boxes[:, [0, 2]].clip(0, shape[1]) # x1, x2 + boxes[:, [1, 3]] = boxes[:, [1, 3]].clip(0, shape[0]) # y1, y2 + + +def non_max_suppression(prediction, conf_thres=0.25, iou_thres=0.45, classes=None, agnostic=False, multi_label=False, + labels=(), max_det=300): + """Runs Non-Maximum Suppression (NMS) on inference results + + Returns: + list of detections, on (n,6) tensor per image [xyxy, conf, cls] + """ + + nc = prediction.shape[2] - 5 # number of classes + xc = prediction[..., 4] > conf_thres # candidates + + # Checks + assert 0 <= conf_thres <= 1, f'Invalid Confidence threshold {conf_thres}, valid values are between 0.0 and 1.0' + assert 0 <= iou_thres <= 1, f'Invalid IoU {iou_thres}, valid values are between 0.0 and 1.0' + + # Settings + min_wh, max_wh = 2, 7680 # (pixels) minimum and maximum box width and height + max_nms = 30000 # maximum number of boxes into torchvision.ops.nms() + time_limit = 10.0 # seconds to quit after + redundant = True # require redundant detections + multi_label &= nc > 1 # multiple labels per box (adds 0.5ms/img) + merge = False # use merge-NMS + + t = time.time() + output = [torch.zeros((0, 6), device=prediction.device)] * prediction.shape[0] + for xi, x in enumerate(prediction): # image index, image inference + # Apply constraints + x[((x[..., 2:4] < min_wh) | (x[..., 2:4] > max_wh)).any(1), 4] = 0 # width-height + x = x[xc[xi]] # confidence + + # Cat apriori labels if autolabelling + if labels and len(labels[xi]): + lb = labels[xi] + v = torch.zeros((len(lb), nc + 5), device=x.device) + v[:, :4] = lb[:, 1:5] # box + v[:, 4] = 1.0 # conf + v[range(len(lb)), lb[:, 0].long() + 5] = 1.0 # cls + x = torch.cat((x, v), 0) + + # If none remain process next image + if not x.shape[0]: + continue + + # Compute conf + x[:, 5:] *= x[:, 4:5] # conf = obj_conf * cls_conf + + # Box (center x, center y, width, height) to (x1, y1, x2, y2) + box = xywh2xyxy(x[:, :4]) + + # Detections matrix nx6 (xyxy, conf, cls) + if multi_label: + i, j = (x[:, 5:] > conf_thres).nonzero(as_tuple=False).T + x = torch.cat((box[i], x[i, j + 5, None], j[:, None].float()), 1) + else: # best class only + conf, j = x[:, 5:].max(1, keepdim=True) + x = torch.cat((box, conf, j.float()), 1)[conf.view(-1) > conf_thres] + + # Filter by class + if classes is not None: + x = x[(x[:, 5:6] == torch.tensor(classes, device=x.device)).any(1)] + + # Apply finite constraint + # if not torch.isfinite(x).all(): + # x = x[torch.isfinite(x).all(1)] + + # Check shape + n = x.shape[0] # number of boxes + if not n: # no boxes + continue + elif n > max_nms: # excess boxes + x = x[x[:, 4].argsort(descending=True)[:max_nms]] # sort by confidence + + # Batched NMS + c = x[:, 5:6] * (0 if agnostic else max_wh) # classes + boxes, scores = x[:, :4] + c, x[:, 4] # boxes (offset by class), scores + i = torchvision.ops.nms(boxes, scores, iou_thres) # NMS + if i.shape[0] > max_det: # limit detections + i = i[:max_det] + if merge and (1 < n < 3E3): # Merge NMS (boxes merged using weighted mean) + # update boxes as boxes(i,4) = weights(i,n) * boxes(n,4) + iou = box_iou(boxes[i], boxes) > iou_thres # iou matrix + weights = iou * scores[None] # box weights + x[i, :4] = torch.mm(weights, x[:, :4]).float() / weights.sum(1, keepdim=True) # merged boxes + if redundant: + i = i[iou.sum(1) > 1] # require redundancy + + output[xi] = x[i] + if (time.time() - t) > time_limit: + LOGGER.warning(f'WARNING: NMS time limit {time_limit}s exceeded') + break # time limit exceeded + + return output + + +def strip_optimizer(f='best.pt', s=''): # from utils.general import *; strip_optimizer() + # Strip optimizer from 'f' to finalize training, optionally save as 's' + x = torch.load(f, map_location=torch.device('cpu')) + if x.get('ema'): + x['model'] = x['ema'] # replace model with ema + for k in 'optimizer', 'best_fitness', 'wandb_id', 'ema', 'updates': # keys + x[k] = None + x['epoch'] = -1 + x['model'].half() # to FP16 + for p in x['model'].parameters(): + p.requires_grad = False + torch.save(x, s or f) + mb = os.path.getsize(s or f) / 1E6 # filesize + LOGGER.info(f"Optimizer stripped from {f},{(' saved as %s,' % s) if s else ''} {mb:.1f}MB") + + +def print_mutation(results, hyp, save_dir, bucket, prefix=colorstr('evolve: ')): + evolve_csv = save_dir / 'evolve.csv' + evolve_yaml = save_dir / 'hyp_evolve.yaml' + keys = ('metrics/precision', 'metrics/recall', 'metrics/mAP_0.5', 'metrics/mAP_0.5:0.95', + 'val/box_loss', 'val/obj_loss', 'val/cls_loss') + tuple(hyp.keys()) # [results + hyps] + keys = tuple(x.strip() for x in keys) + vals = results + tuple(hyp.values()) + n = len(keys) + + # Download (optional) + if bucket: + url = f'gs://{bucket}/evolve.csv' + if gsutil_getsize(url) > (evolve_csv.stat().st_size if evolve_csv.exists() else 0): + os.system(f'gsutil cp {url} {save_dir}') # download evolve.csv if larger than local + + # Log to evolve.csv + s = '' if evolve_csv.exists() else (('%20s,' * n % keys).rstrip(',') + '\n') # add header + with open(evolve_csv, 'a') as f: + f.write(s + ('%20.5g,' * n % vals).rstrip(',') + '\n') + + # Save yaml + with open(evolve_yaml, 'w') as f: + data = pd.read_csv(evolve_csv) + data = data.rename(columns=lambda x: x.strip()) # strip keys + i = np.argmax(fitness(data.values[:, :4])) # + generations = len(data) + f.write('# YOLOv5 Hyperparameter Evolution Results\n' + + f'# Best generation: {i}\n' + + f'# Last generation: {generations - 1}\n' + + '# ' + ', '.join(f'{x.strip():>20s}' for x in keys[:7]) + '\n' + + '# ' + ', '.join(f'{x:>20.5g}' for x in data.values[i, :7]) + '\n\n') + yaml.safe_dump(data.loc[i][7:].to_dict(), f, sort_keys=False) + + # Print to screen + LOGGER.info(prefix + f'{generations} generations finished, current result:\n' + + prefix + ', '.join(f'{x.strip():>20s}' for x in keys) + '\n' + + prefix + ', '.join(f'{x:20.5g}' for x in vals) + '\n\n') + + if bucket: + os.system(f'gsutil cp {evolve_csv} {evolve_yaml} gs://{bucket}') # upload + + +def apply_classifier(x, model, img, im0): + # Apply a second stage classifier to YOLO outputs + # Example model = torchvision.models.__dict__['efficientnet_b0'](pretrained=True).to(device).eval() + im0 = [im0] if isinstance(im0, np.ndarray) else im0 + for i, d in enumerate(x): # per image + if d is not None and len(d): + d = d.clone() + + # Reshape and pad cutouts + b = xyxy2xywh(d[:, :4]) # boxes + b[:, 2:] = b[:, 2:].max(1)[0].unsqueeze(1) # rectangle to square + b[:, 2:] = b[:, 2:] * 1.3 + 30 # pad + d[:, :4] = xywh2xyxy(b).long() + + # Rescale boxes from img_size to im0 size + scale_coords(img.shape[2:], d[:, :4], im0[i].shape) + + # Classes + pred_cls1 = d[:, 5].long() + ims = [] + for j, a in enumerate(d): # per item + cutout = im0[i][int(a[1]):int(a[3]), int(a[0]):int(a[2])] + im = cv2.resize(cutout, (224, 224)) # BGR + # cv2.imwrite('example%i.jpg' % j, cutout) + + im = im[:, :, ::-1].transpose(2, 0, 1) # BGR to RGB, to 3x416x416 + im = np.ascontiguousarray(im, dtype=np.float32) # uint8 to float32 + im /= 255 # 0 - 255 to 0.0 - 1.0 + ims.append(im) + + pred_cls2 = model(torch.Tensor(ims).to(d.device)).argmax(1) # classifier prediction + x[i] = x[i][pred_cls1 == pred_cls2] # retain matching class detections + + return x + + +def increment_path(path, exist_ok=False, sep='', mkdir=False): + # Increment file or directory path, i.e. runs/exp --> runs/exp{sep}2, runs/exp{sep}3, ... etc. + path = Path(path) # os-agnostic + if path.exists() and not exist_ok: + path, suffix = (path.with_suffix(''), path.suffix) if path.is_file() else (path, '') + dirs = glob.glob(f"{path}{sep}*") # similar paths + matches = [re.search(rf"%s{sep}(\d+)" % path.stem, d) for d in dirs] + i = [int(m.groups()[0]) for m in matches if m] # indices + n = max(i) + 1 if i else 2 # increment number + path = Path(f"{path}{sep}{n}{suffix}") # increment path + if mkdir: + path.mkdir(parents=True, exist_ok=True) # make directory + return path + + +# Variables +NCOLS = 0 if is_docker() else shutil.get_terminal_size().columns # terminal window size for tqdm diff --git a/yolov5_Monocular_social_ranging/utils/google_app_engine/Dockerfile b/yolov5_Monocular_social_ranging/utils/google_app_engine/Dockerfile new file mode 100644 index 0000000..0155618 --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/google_app_engine/Dockerfile @@ -0,0 +1,25 @@ +FROM gcr.io/google-appengine/python + +# Create a virtualenv for dependencies. This isolates these packages from +# system-level packages. +# Use -p python3 or -p python3.7 to select python version. Default is version 2. +RUN virtualenv /env -p python3 + +# Setting these environment variables are the same as running +# source /env/bin/activate. +ENV VIRTUAL_ENV /env +ENV PATH /env/bin:$PATH + +RUN apt-get update && apt-get install -y python-opencv + +# Copy the application's requirements.txt and run pip to install all +# dependencies into the virtualenv. +ADD requirements.txt /app/requirements.txt +RUN pip install -r /app/requirements.txt + +# Add the application source code. +ADD . /app + +# Run a WSGI server to serve the application. gunicorn must be declared as +# a dependency in requirements.txt. +CMD gunicorn -b :$PORT main:app diff --git a/yolov5_Monocular_social_ranging/utils/google_app_engine/additional_requirements.txt b/yolov5_Monocular_social_ranging/utils/google_app_engine/additional_requirements.txt new file mode 100644 index 0000000..42d7ffc --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/google_app_engine/additional_requirements.txt @@ -0,0 +1,4 @@ +# add these requirements in your app on top of the existing ones +pip==21.1 +Flask==1.0.2 +gunicorn==19.9.0 diff --git a/yolov5_Monocular_social_ranging/utils/google_app_engine/app.yaml b/yolov5_Monocular_social_ranging/utils/google_app_engine/app.yaml new file mode 100644 index 0000000..5056b7c --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/google_app_engine/app.yaml @@ -0,0 +1,14 @@ +runtime: custom +env: flex + +service: yolov5app + +liveness_check: + initial_delay_sec: 600 + +manual_scaling: + instances: 1 +resources: + cpu: 1 + memory_gb: 4 + disk_size_gb: 20 diff --git a/yolov5_Monocular_social_ranging/utils/loggers/__init__.py b/yolov5_Monocular_social_ranging/utils/loggers/__init__.py new file mode 100644 index 0000000..86ccf38 --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/loggers/__init__.py @@ -0,0 +1,168 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +Logging utils +""" + +import os +import warnings +from threading import Thread + +import pkg_resources as pkg +import torch +from torch.utils.tensorboard import SummaryWriter + +from utils.general import colorstr, emojis +from utils.loggers.wandb.wandb_utils import WandbLogger +from utils.plots import plot_images, plot_results +from utils.torch_utils import de_parallel + +LOGGERS = ('csv', 'tb', 'wandb') # text-file, TensorBoard, Weights & Biases +RANK = int(os.getenv('RANK', -1)) + +try: + import wandb + + assert hasattr(wandb, '__version__') # verify package import not local dir + if pkg.parse_version(wandb.__version__) >= pkg.parse_version('0.12.2') and RANK in [0, -1]: + try: + wandb_login_success = wandb.login(timeout=30) + except wandb.errors.UsageError: # known non-TTY terminal issue + wandb_login_success = False + if not wandb_login_success: + wandb = None +except (ImportError, AssertionError): + wandb = None + + +class Loggers(): + # YOLOv5 Loggers class + def __init__(self, save_dir=None, weights=None, opt=None, hyp=None, logger=None, include=LOGGERS): + self.save_dir = save_dir + self.weights = weights + self.opt = opt + self.hyp = hyp + self.logger = logger # for printing results to console + self.include = include + self.keys = ['train/box_loss', 'train/obj_loss', 'train/cls_loss', # train loss + 'metrics/precision', 'metrics/recall', 'metrics/mAP_0.5', 'metrics/mAP_0.5:0.95', # metrics + 'val/box_loss', 'val/obj_loss', 'val/cls_loss', # val loss + 'x/lr0', 'x/lr1', 'x/lr2'] # params + self.best_keys = ['best/epoch', 'best/precision', 'best/recall', 'best/mAP_0.5', 'best/mAP_0.5:0.95',] + for k in LOGGERS: + setattr(self, k, None) # init empty logger dictionary + self.csv = True # always log to csv + + # Message + if not wandb: + prefix = colorstr('Weights & Biases: ') + s = f"{prefix}run 'pip install wandb' to automatically track and visualize YOLOv5 🚀 runs (RECOMMENDED)" + print(emojis(s)) + + # TensorBoard + s = self.save_dir + if 'tb' in self.include and not self.opt.evolve: + prefix = colorstr('TensorBoard: ') + self.logger.info(f"{prefix}Start with 'tensorboard --logdir {s.parent}', view at http://localhost:6006/") + self.tb = SummaryWriter(str(s)) + + # W&B + if wandb and 'wandb' in self.include: + wandb_artifact_resume = isinstance(self.opt.resume, str) and self.opt.resume.startswith('wandb-artifact://') + run_id = torch.load(self.weights).get('wandb_id') if self.opt.resume and not wandb_artifact_resume else None + self.opt.hyp = self.hyp # add hyperparameters + self.wandb = WandbLogger(self.opt, run_id) + else: + self.wandb = None + + def on_pretrain_routine_end(self): + # Callback runs on pre-train routine end + paths = self.save_dir.glob('*labels*.jpg') # training labels + if self.wandb: + self.wandb.log({"Labels": [wandb.Image(str(x), caption=x.name) for x in paths]}) + + def on_train_batch_end(self, ni, model, imgs, targets, paths, plots, sync_bn): + # Callback runs on train batch end + if plots: + if ni == 0: + if not sync_bn: # tb.add_graph() --sync known issue https://github.com/ultralytics/yolov5/issues/3754 + with warnings.catch_warnings(): + warnings.simplefilter('ignore') # suppress jit trace warning + self.tb.add_graph(torch.jit.trace(de_parallel(model), imgs[0:1], strict=False), []) + if ni < 3: + f = self.save_dir / f'train_batch{ni}.jpg' # filename + Thread(target=plot_images, args=(imgs, targets, paths, f), daemon=True).start() + if self.wandb and ni == 10: + files = sorted(self.save_dir.glob('train*.jpg')) + self.wandb.log({'Mosaics': [wandb.Image(str(f), caption=f.name) for f in files if f.exists()]}) + + def on_train_epoch_end(self, epoch): + # Callback runs on train epoch end + if self.wandb: + self.wandb.current_epoch = epoch + 1 + + def on_val_image_end(self, pred, predn, path, names, im): + # Callback runs on val image end + if self.wandb: + self.wandb.val_one_image(pred, predn, path, names, im) + + def on_val_end(self): + # Callback runs on val end + if self.wandb: + files = sorted(self.save_dir.glob('val*.jpg')) + self.wandb.log({"Validation": [wandb.Image(str(f), caption=f.name) for f in files]}) + + def on_fit_epoch_end(self, vals, epoch, best_fitness, fi): + # Callback runs at the end of each fit (train+val) epoch + x = {k: v for k, v in zip(self.keys, vals)} # dict + if self.csv: + file = self.save_dir / 'results.csv' + n = len(x) + 1 # number of cols + s = '' if file.exists() else (('%20s,' * n % tuple(['epoch'] + self.keys)).rstrip(',') + '\n') # add header + with open(file, 'a') as f: + f.write(s + ('%20.5g,' * n % tuple([epoch] + vals)).rstrip(',') + '\n') + + if self.tb: + for k, v in x.items(): + self.tb.add_scalar(k, v, epoch) + + if self.wandb: + if best_fitness == fi: + best_results = [epoch] + vals[3:7] + for i, name in enumerate(self.best_keys): + self.wandb.wandb_run.summary[name] = best_results[i] # log best results in the summary + self.wandb.log(x) + self.wandb.end_epoch(best_result=best_fitness == fi) + + def on_model_save(self, last, epoch, final_epoch, best_fitness, fi): + # Callback runs on model save event + if self.wandb: + if ((epoch + 1) % self.opt.save_period == 0 and not final_epoch) and self.opt.save_period != -1: + self.wandb.log_model(last.parent, self.opt, epoch, fi, best_model=best_fitness == fi) + + def on_train_end(self, last, best, plots, epoch, results): + # Callback runs on training end + if plots: + plot_results(file=self.save_dir / 'results.csv') # save results.png + files = ['results.png', 'confusion_matrix.png', *(f'{x}_curve.png' for x in ('F1', 'PR', 'P', 'R'))] + files = [(self.save_dir / f) for f in files if (self.save_dir / f).exists()] # filter + + if self.tb: + import cv2 + for f in files: + self.tb.add_image(f.stem, cv2.imread(str(f))[..., ::-1], epoch, dataformats='HWC') + + if self.wandb: + self.wandb.log({k: v for k, v in zip(self.keys[3:10], results)}) # log best.pt val results + self.wandb.log({"Results": [wandb.Image(str(f), caption=f.name) for f in files]}) + # Calling wandb.log. TODO: Refactor this into WandbLogger.log_model + if not self.opt.evolve: + wandb.log_artifact(str(best if best.exists() else last), type='model', + name='run_' + self.wandb.wandb_run.id + '_model', + aliases=['latest', 'best', 'stripped']) + self.wandb.finish_run() + + def on_params_update(self, params): + # Update hyperparams or configs of the experiment + # params: A dict containing {param: value} pairs + if self.wandb: + self.wandb.wandb_run.config.update(params, allow_val_change=True) diff --git a/yolov5_Monocular_social_ranging/utils/loggers/wandb/README.md b/yolov5_Monocular_social_ranging/utils/loggers/wandb/README.md new file mode 100644 index 0000000..63d9998 --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/loggers/wandb/README.md @@ -0,0 +1,152 @@ +📚 This guide explains how to use **Weights & Biases** (W&B) with YOLOv5 🚀. UPDATED 29 September 2021. +* [About Weights & Biases](#about-weights-&-biases) +* [First-Time Setup](#first-time-setup) +* [Viewing runs](#viewing-runs) +* [Disabling wandb](#disabling-wandb) +* [Advanced Usage: Dataset Versioning and Evaluation](#advanced-usage) +* [Reports: Share your work with the world!](#reports) + +## About Weights & Biases +Think of [W&B](https://wandb.ai/site?utm_campaign=repo_yolo_wandbtutorial) like GitHub for machine learning models. With a few lines of code, save everything you need to debug, compare and reproduce your models — architecture, hyperparameters, git commits, model weights, GPU usage, and even datasets and predictions. + +Used by top researchers including teams at OpenAI, Lyft, Github, and MILA, W&B is part of the new standard of best practices for machine learning. How W&B can help you optimize your machine learning workflows: + + * [Debug](https://wandb.ai/wandb/getting-started/reports/Visualize-Debug-Machine-Learning-Models--VmlldzoyNzY5MDk#Free-2) model performance in real time + * [GPU usage](https://wandb.ai/wandb/getting-started/reports/Visualize-Debug-Machine-Learning-Models--VmlldzoyNzY5MDk#System-4) visualized automatically + * [Custom charts](https://wandb.ai/wandb/customizable-charts/reports/Powerful-Custom-Charts-To-Debug-Model-Peformance--VmlldzoyNzY4ODI) for powerful, extensible visualization + * [Share insights](https://wandb.ai/wandb/getting-started/reports/Visualize-Debug-Machine-Learning-Models--VmlldzoyNzY5MDk#Share-8) interactively with collaborators + * [Optimize hyperparameters](https://docs.wandb.com/sweeps) efficiently + * [Track](https://docs.wandb.com/artifacts) datasets, pipelines, and production models + +## First-Time Setup +
+ Toggle Details +When you first train, W&B will prompt you to create a new account and will generate an **API key** for you. If you are an existing user you can retrieve your key from https://wandb.ai/authorize. This key is used to tell W&B where to log your data. You only need to supply your key once, and then it is remembered on the same device. + +W&B will create a cloud **project** (default is 'YOLOv5') for your training runs, and each new training run will be provided a unique run **name** within that project as project/name. You can also manually set your project and run name as: + + ```shell + $ python train.py --project ... --name ... + ``` + +YOLOv5 notebook example: Open In Colab Open In Kaggle +Screen Shot 2021-09-29 at 10 23 13 PM + + +
+ +## Viewing Runs +
+ Toggle Details +Run information streams from your environment to the W&B cloud console as you train. This allows you to monitor and even cancel runs in realtime . All important information is logged: + + * Training & Validation losses + * Metrics: Precision, Recall, mAP@0.5, mAP@0.5:0.95 + * Learning Rate over time + * A bounding box debugging panel, showing the training progress over time + * GPU: Type, **GPU Utilization**, power, temperature, **CUDA memory usage** + * System: Disk I/0, CPU utilization, RAM memory usage + * Your trained model as W&B Artifact + * Environment: OS and Python types, Git repository and state, **training command** + +

Weights & Biases dashboard

+
+ + ## Disabling wandb +* training after running `wandb disabled` inside that directory creates no wandb run +![Screenshot (84)](https://user-images.githubusercontent.com/15766192/143441777-c780bdd7-7cb4-4404-9559-b4316030a985.png) + +* To enable wandb again, run `wandb online` +![Screenshot (85)](https://user-images.githubusercontent.com/15766192/143441866-7191b2cb-22f0-4e0f-ae64-2dc47dc13078.png) + +## Advanced Usage +You can leverage W&B artifacts and Tables integration to easily visualize and manage your datasets, models and training evaluations. Here are some quick examples to get you started. +
+

1: Train and Log Evaluation simultaneousy

+ This is an extension of the previous section, but it'll also training after uploading the dataset. This also evaluation Table + Evaluation table compares your predictions and ground truths across the validation set for each epoch. It uses the references to the already uploaded datasets, + so no images will be uploaded from your system more than once. +
+ Usage + Code $ python train.py --upload_data val + +![Screenshot from 2021-11-21 17-40-06](https://user-images.githubusercontent.com/15766192/142761183-c1696d8c-3f38-45ab-991a-bb0dfd98ae7d.png) +
+ +

2. Visualize and Version Datasets

+ Log, visualize, dynamically query, and understand your data with W&B Tables. You can use the following command to log your dataset as a W&B Table. This will generate a {dataset}_wandb.yaml file which can be used to train from dataset artifact. +
+ Usage + Code $ python utils/logger/wandb/log_dataset.py --project ... --name ... --data .. + + ![Screenshot (64)](https://user-images.githubusercontent.com/15766192/128486078-d8433890-98a3-4d12-8986-b6c0e3fc64b9.png) +
+ +

3: Train using dataset artifact

+ When you upload a dataset as described in the first section, you get a new config file with an added `_wandb` to its name. This file contains the information that + can be used to train a model directly from the dataset artifact. This also logs evaluation +
+ Usage + Code $ python train.py --data {data}_wandb.yaml + +![Screenshot (72)](https://user-images.githubusercontent.com/15766192/128979739-4cf63aeb-a76f-483f-8861-1c0100b938a5.png) +
+ +

4: Save model checkpoints as artifacts

+ To enable saving and versioning checkpoints of your experiment, pass `--save_period n` with the base cammand, where `n` represents checkpoint interval. + You can also log both the dataset and model checkpoints simultaneously. If not passed, only the final model will be logged + +
+ Usage + Code $ python train.py --save_period 1 + +![Screenshot (68)](https://user-images.githubusercontent.com/15766192/128726138-ec6c1f60-639d-437d-b4ee-3acd9de47ef3.png) +
+ +
+ +

5: Resume runs from checkpoint artifacts.

+Any run can be resumed using artifacts if the --resume argument starts with wandb-artifact:// prefix followed by the run path, i.e, wandb-artifact://username/project/runid . This doesn't require the model checkpoint to be present on the local system. + +
+ Usage + Code $ python train.py --resume wandb-artifact://{run_path} + +![Screenshot (70)](https://user-images.githubusercontent.com/15766192/128728988-4e84b355-6c87-41ae-a591-14aecf45343e.png) +
+ +

6: Resume runs from dataset artifact & checkpoint artifacts.

+ Local dataset or model checkpoints are not required. This can be used to resume runs directly on a different device + The syntax is same as the previous section, but you'll need to lof both the dataset and model checkpoints as artifacts, i.e, set bot --upload_dataset or + train from _wandb.yaml file and set --save_period + +
+ Usage + Code $ python train.py --resume wandb-artifact://{run_path} + +![Screenshot (70)](https://user-images.githubusercontent.com/15766192/128728988-4e84b355-6c87-41ae-a591-14aecf45343e.png) +
+ + + +

Reports

+W&B Reports can be created from your saved runs for sharing online. Once a report is created you will receive a link you can use to publically share your results. Here is an example report created from the COCO128 tutorial trainings of all four YOLOv5 models ([link](https://wandb.ai/glenn-jocher/yolov5_tutorial/reports/YOLOv5-COCO128-Tutorial-Results--VmlldzozMDI5OTY)). + +Weights & Biases Reports + + +## Environments + +YOLOv5 may be run in any of the following up-to-date verified environments (with all dependencies including [CUDA](https://developer.nvidia.com/cuda)/[CUDNN](https://developer.nvidia.com/cudnn), [Python](https://www.python.org/) and [PyTorch](https://pytorch.org/) preinstalled): + +- **Google Colab and Kaggle** notebooks with free GPU: Open In Colab Open In Kaggle +- **Google Cloud** Deep Learning VM. See [GCP Quickstart Guide](https://github.com/ultralytics/yolov5/wiki/GCP-Quickstart) +- **Amazon** Deep Learning AMI. See [AWS Quickstart Guide](https://github.com/ultralytics/yolov5/wiki/AWS-Quickstart) +- **Docker Image**. See [Docker Quickstart Guide](https://github.com/ultralytics/yolov5/wiki/Docker-Quickstart) Docker Pulls + + +## Status + +![CI CPU testing](https://github.com/ultralytics/yolov5/workflows/CI%20CPU%20testing/badge.svg) + +If this badge is green, all [YOLOv5 GitHub Actions](https://github.com/ultralytics/yolov5/actions) Continuous Integration (CI) tests are currently passing. CI tests verify correct operation of YOLOv5 training ([train.py](https://github.com/ultralytics/yolov5/blob/master/train.py)), validation ([val.py](https://github.com/ultralytics/yolov5/blob/master/val.py)), inference ([detect.py](https://github.com/ultralytics/yolov5/blob/master/detect.py)) and export ([export.py](https://github.com/ultralytics/yolov5/blob/master/export.py)) on MacOS, Windows, and Ubuntu every 24 hours and on every commit. diff --git a/yolov5_Monocular_social_ranging/utils/loggers/wandb/__init__.py b/yolov5_Monocular_social_ranging/utils/loggers/wandb/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/yolov5_Monocular_social_ranging/utils/loggers/wandb/log_dataset.py b/yolov5_Monocular_social_ranging/utils/loggers/wandb/log_dataset.py new file mode 100644 index 0000000..06e81fb --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/loggers/wandb/log_dataset.py @@ -0,0 +1,27 @@ +import argparse + +from wandb_utils import WandbLogger + +from utils.general import LOGGER + +WANDB_ARTIFACT_PREFIX = 'wandb-artifact://' + + +def create_dataset_artifact(opt): + logger = WandbLogger(opt, None, job_type='Dataset Creation') # TODO: return value unused + if not logger.wandb: + LOGGER.info("install wandb using `pip install wandb` to log the dataset") + + +if __name__ == '__main__': + parser = argparse.ArgumentParser() + parser.add_argument('--data', type=str, default='data/coco128.yaml', help='data.yaml path') + parser.add_argument('--single-cls', action='store_true', help='train as single-class dataset') + parser.add_argument('--project', type=str, default='YOLOv5', help='name of W&B Project') + parser.add_argument('--entity', default=None, help='W&B entity') + parser.add_argument('--name', type=str, default='log dataset', help='name of W&B run') + + opt = parser.parse_args() + opt.resume = False # Explicitly disallow resume check for dataset upload job + + create_dataset_artifact(opt) diff --git a/yolov5_Monocular_social_ranging/utils/loggers/wandb/sweep.py b/yolov5_Monocular_social_ranging/utils/loggers/wandb/sweep.py new file mode 100644 index 0000000..206059b --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/loggers/wandb/sweep.py @@ -0,0 +1,41 @@ +import sys +from pathlib import Path + +import wandb + +FILE = Path(__file__).resolve() +ROOT = FILE.parents[3] # YOLOv5 root directory +if str(ROOT) not in sys.path: + sys.path.append(str(ROOT)) # add ROOT to PATH + +from train import parse_opt, train +from utils.callbacks import Callbacks +from utils.general import increment_path +from utils.torch_utils import select_device + + +def sweep(): + wandb.init() + # Get hyp dict from sweep agent + hyp_dict = vars(wandb.config).get("_items") + + # Workaround: get necessary opt args + opt = parse_opt(known=True) + opt.batch_size = hyp_dict.get("batch_size") + opt.save_dir = str(increment_path(Path(opt.project) / opt.name, exist_ok=opt.exist_ok or opt.evolve)) + opt.epochs = hyp_dict.get("epochs") + opt.nosave = True + opt.data = hyp_dict.get("data") + opt.weights = str(opt.weights) + opt.cfg = str(opt.cfg) + opt.data = str(opt.data) + opt.hyp = str(opt.hyp) + opt.project = str(opt.project) + device = select_device(opt.device, batch_size=opt.batch_size) + + # train + train(hyp_dict, opt, device, callbacks=Callbacks()) + + +if __name__ == "__main__": + sweep() diff --git a/yolov5_Monocular_social_ranging/utils/loggers/wandb/sweep.yaml b/yolov5_Monocular_social_ranging/utils/loggers/wandb/sweep.yaml new file mode 100644 index 0000000..c7790d7 --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/loggers/wandb/sweep.yaml @@ -0,0 +1,143 @@ +# Hyperparameters for training +# To set range- +# Provide min and max values as: +# parameter: +# +# min: scalar +# max: scalar +# OR +# +# Set a specific list of search space- +# parameter: +# values: [scalar1, scalar2, scalar3...] +# +# You can use grid, bayesian and hyperopt search strategy +# For more info on configuring sweeps visit - https://docs.wandb.ai/guides/sweeps/configuration + +program: utils/loggers/wandb/sweep.py +method: random +metric: + name: metrics/mAP_0.5 + goal: maximize + +parameters: + # hyperparameters: set either min, max range or values list + data: + value: "data/coco128.yaml" + batch_size: + values: [64] + epochs: + values: [10] + + lr0: + distribution: uniform + min: 1e-5 + max: 1e-1 + lrf: + distribution: uniform + min: 0.01 + max: 1.0 + momentum: + distribution: uniform + min: 0.6 + max: 0.98 + weight_decay: + distribution: uniform + min: 0.0 + max: 0.001 + warmup_epochs: + distribution: uniform + min: 0.0 + max: 5.0 + warmup_momentum: + distribution: uniform + min: 0.0 + max: 0.95 + warmup_bias_lr: + distribution: uniform + min: 0.0 + max: 0.2 + box: + distribution: uniform + min: 0.02 + max: 0.2 + cls: + distribution: uniform + min: 0.2 + max: 4.0 + cls_pw: + distribution: uniform + min: 0.5 + max: 2.0 + obj: + distribution: uniform + min: 0.2 + max: 4.0 + obj_pw: + distribution: uniform + min: 0.5 + max: 2.0 + iou_t: + distribution: uniform + min: 0.1 + max: 0.7 + anchor_t: + distribution: uniform + min: 2.0 + max: 8.0 + fl_gamma: + distribution: uniform + min: 0.0 + max: 0.1 + hsv_h: + distribution: uniform + min: 0.0 + max: 0.1 + hsv_s: + distribution: uniform + min: 0.0 + max: 0.9 + hsv_v: + distribution: uniform + min: 0.0 + max: 0.9 + degrees: + distribution: uniform + min: 0.0 + max: 45.0 + translate: + distribution: uniform + min: 0.0 + max: 0.9 + scale: + distribution: uniform + min: 0.0 + max: 0.9 + shear: + distribution: uniform + min: 0.0 + max: 10.0 + perspective: + distribution: uniform + min: 0.0 + max: 0.001 + flipud: + distribution: uniform + min: 0.0 + max: 1.0 + fliplr: + distribution: uniform + min: 0.0 + max: 1.0 + mosaic: + distribution: uniform + min: 0.0 + max: 1.0 + mixup: + distribution: uniform + min: 0.0 + max: 1.0 + copy_paste: + distribution: uniform + min: 0.0 + max: 1.0 diff --git a/yolov5_Monocular_social_ranging/utils/loggers/wandb/wandb_utils.py b/yolov5_Monocular_social_ranging/utils/loggers/wandb/wandb_utils.py new file mode 100644 index 0000000..3835436 --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/loggers/wandb/wandb_utils.py @@ -0,0 +1,562 @@ +"""Utilities and tools for tracking runs with Weights & Biases.""" + +import logging +import os +import sys +from contextlib import contextmanager +from pathlib import Path +from typing import Dict + +import yaml +from tqdm import tqdm + +FILE = Path(__file__).resolve() +ROOT = FILE.parents[3] # YOLOv5 root directory +if str(ROOT) not in sys.path: + sys.path.append(str(ROOT)) # add ROOT to PATH + +from utils.datasets import LoadImagesAndLabels, img2label_paths +from utils.general import LOGGER, check_dataset, check_file + +try: + import wandb + + assert hasattr(wandb, '__version__') # verify package import not local dir +except (ImportError, AssertionError): + wandb = None + +RANK = int(os.getenv('RANK', -1)) +WANDB_ARTIFACT_PREFIX = 'wandb-artifact://' + + +def remove_prefix(from_string, prefix=WANDB_ARTIFACT_PREFIX): + return from_string[len(prefix):] + + +def check_wandb_config_file(data_config_file): + wandb_config = '_wandb.'.join(data_config_file.rsplit('.', 1)) # updated data.yaml path + if Path(wandb_config).is_file(): + return wandb_config + return data_config_file + + +def check_wandb_dataset(data_file): + is_trainset_wandb_artifact = False + is_valset_wandb_artifact = False + if check_file(data_file) and data_file.endswith('.yaml'): + with open(data_file, errors='ignore') as f: + data_dict = yaml.safe_load(f) + is_trainset_wandb_artifact = (isinstance(data_dict['train'], str) and + data_dict['train'].startswith(WANDB_ARTIFACT_PREFIX)) + is_valset_wandb_artifact = (isinstance(data_dict['val'], str) and + data_dict['val'].startswith(WANDB_ARTIFACT_PREFIX)) + if is_trainset_wandb_artifact or is_valset_wandb_artifact: + return data_dict + else: + return check_dataset(data_file) + + +def get_run_info(run_path): + run_path = Path(remove_prefix(run_path, WANDB_ARTIFACT_PREFIX)) + run_id = run_path.stem + project = run_path.parent.stem + entity = run_path.parent.parent.stem + model_artifact_name = 'run_' + run_id + '_model' + return entity, project, run_id, model_artifact_name + + +def check_wandb_resume(opt): + process_wandb_config_ddp_mode(opt) if RANK not in [-1, 0] else None + if isinstance(opt.resume, str): + if opt.resume.startswith(WANDB_ARTIFACT_PREFIX): + if RANK not in [-1, 0]: # For resuming DDP runs + entity, project, run_id, model_artifact_name = get_run_info(opt.resume) + api = wandb.Api() + artifact = api.artifact(entity + '/' + project + '/' + model_artifact_name + ':latest') + modeldir = artifact.download() + opt.weights = str(Path(modeldir) / "last.pt") + return True + return None + + +def process_wandb_config_ddp_mode(opt): + with open(check_file(opt.data), errors='ignore') as f: + data_dict = yaml.safe_load(f) # data dict + train_dir, val_dir = None, None + if isinstance(data_dict['train'], str) and data_dict['train'].startswith(WANDB_ARTIFACT_PREFIX): + api = wandb.Api() + train_artifact = api.artifact(remove_prefix(data_dict['train']) + ':' + opt.artifact_alias) + train_dir = train_artifact.download() + train_path = Path(train_dir) / 'data/images/' + data_dict['train'] = str(train_path) + + if isinstance(data_dict['val'], str) and data_dict['val'].startswith(WANDB_ARTIFACT_PREFIX): + api = wandb.Api() + val_artifact = api.artifact(remove_prefix(data_dict['val']) + ':' + opt.artifact_alias) + val_dir = val_artifact.download() + val_path = Path(val_dir) / 'data/images/' + data_dict['val'] = str(val_path) + if train_dir or val_dir: + ddp_data_path = str(Path(val_dir) / 'wandb_local_data.yaml') + with open(ddp_data_path, 'w') as f: + yaml.safe_dump(data_dict, f) + opt.data = ddp_data_path + + +class WandbLogger(): + """Log training runs, datasets, models, and predictions to Weights & Biases. + + This logger sends information to W&B at wandb.ai. By default, this information + includes hyperparameters, system configuration and metrics, model metrics, + and basic data metrics and analyses. + + By providing additional command line arguments to train.py, datasets, + models and predictions can also be logged. + + For more on how this logger is used, see the Weights & Biases documentation: + https://docs.wandb.com/guides/integrations/yolov5 + """ + + def __init__(self, opt, run_id=None, job_type='Training'): + """ + - Initialize WandbLogger instance + - Upload dataset if opt.upload_dataset is True + - Setup trainig processes if job_type is 'Training' + + arguments: + opt (namespace) -- Commandline arguments for this run + run_id (str) -- Run ID of W&B run to be resumed + job_type (str) -- To set the job_type for this run + + """ + # Pre-training routine -- + self.job_type = job_type + self.wandb, self.wandb_run = wandb, None if not wandb else wandb.run + self.val_artifact, self.train_artifact = None, None + self.train_artifact_path, self.val_artifact_path = None, None + self.result_artifact = None + self.val_table, self.result_table = None, None + self.bbox_media_panel_images = [] + self.val_table_path_map = None + self.max_imgs_to_log = 16 + self.wandb_artifact_data_dict = None + self.data_dict = None + # It's more elegant to stick to 1 wandb.init call, + # but useful config data is overwritten in the WandbLogger's wandb.init call + if isinstance(opt.resume, str): # checks resume from artifact + if opt.resume.startswith(WANDB_ARTIFACT_PREFIX): + entity, project, run_id, model_artifact_name = get_run_info(opt.resume) + model_artifact_name = WANDB_ARTIFACT_PREFIX + model_artifact_name + assert wandb, 'install wandb to resume wandb runs' + # Resume wandb-artifact:// runs here| workaround for not overwriting wandb.config + self.wandb_run = wandb.init(id=run_id, + project=project, + entity=entity, + resume='allow', + allow_val_change=True) + opt.resume = model_artifact_name + elif self.wandb: + self.wandb_run = wandb.init(config=opt, + resume="allow", + project='YOLOv5' if opt.project == 'runs/train' else Path(opt.project).stem, + entity=opt.entity, + name=opt.name if opt.name != 'exp' else None, + job_type=job_type, + id=run_id, + allow_val_change=True) if not wandb.run else wandb.run + if self.wandb_run: + if self.job_type == 'Training': + if opt.upload_dataset: + if not opt.resume: + self.wandb_artifact_data_dict = self.check_and_upload_dataset(opt) + + if opt.resume: + # resume from artifact + if isinstance(opt.resume, str) and opt.resume.startswith(WANDB_ARTIFACT_PREFIX): + self.data_dict = dict(self.wandb_run.config.data_dict) + else: # local resume + self.data_dict = check_wandb_dataset(opt.data) + else: + self.data_dict = check_wandb_dataset(opt.data) + self.wandb_artifact_data_dict = self.wandb_artifact_data_dict or self.data_dict + + # write data_dict to config. useful for resuming from artifacts. Do this only when not resuming. + self.wandb_run.config.update({'data_dict': self.wandb_artifact_data_dict}, + allow_val_change=True) + self.setup_training(opt) + + if self.job_type == 'Dataset Creation': + self.wandb_run.config.update({"upload_dataset": True}) + self.data_dict = self.check_and_upload_dataset(opt) + + def check_and_upload_dataset(self, opt): + """ + Check if the dataset format is compatible and upload it as W&B artifact + + arguments: + opt (namespace)-- Commandline arguments for current run + + returns: + Updated dataset info dictionary where local dataset paths are replaced by WAND_ARFACT_PREFIX links. + """ + assert wandb, 'Install wandb to upload dataset' + config_path = self.log_dataset_artifact(opt.data, + opt.single_cls, + 'YOLOv5' if opt.project == 'runs/train' else Path(opt.project).stem) + with open(config_path, errors='ignore') as f: + wandb_data_dict = yaml.safe_load(f) + return wandb_data_dict + + def setup_training(self, opt): + """ + Setup the necessary processes for training YOLO models: + - Attempt to download model checkpoint and dataset artifacts if opt.resume stats with WANDB_ARTIFACT_PREFIX + - Update data_dict, to contain info of previous run if resumed and the paths of dataset artifact if downloaded + - Setup log_dict, initialize bbox_interval + + arguments: + opt (namespace) -- commandline arguments for this run + + """ + self.log_dict, self.current_epoch = {}, 0 + self.bbox_interval = opt.bbox_interval + if isinstance(opt.resume, str): + modeldir, _ = self.download_model_artifact(opt) + if modeldir: + self.weights = Path(modeldir) / "last.pt" + config = self.wandb_run.config + opt.weights, opt.save_period, opt.batch_size, opt.bbox_interval, opt.epochs, opt.hyp, opt.imgsz = str( + self.weights), config.save_period, config.batch_size, config.bbox_interval, config.epochs,\ + config.hyp, config.imgsz + data_dict = self.data_dict + if self.val_artifact is None: # If --upload_dataset is set, use the existing artifact, don't download + self.train_artifact_path, self.train_artifact = self.download_dataset_artifact(data_dict.get('train'), + opt.artifact_alias) + self.val_artifact_path, self.val_artifact = self.download_dataset_artifact(data_dict.get('val'), + opt.artifact_alias) + + if self.train_artifact_path is not None: + train_path = Path(self.train_artifact_path) / 'data/images/' + data_dict['train'] = str(train_path) + if self.val_artifact_path is not None: + val_path = Path(self.val_artifact_path) / 'data/images/' + data_dict['val'] = str(val_path) + + if self.val_artifact is not None: + self.result_artifact = wandb.Artifact("run_" + wandb.run.id + "_progress", "evaluation") + columns = ["epoch", "id", "ground truth", "prediction"] + columns.extend(self.data_dict['names']) + self.result_table = wandb.Table(columns) + self.val_table = self.val_artifact.get("val") + if self.val_table_path_map is None: + self.map_val_table_path() + if opt.bbox_interval == -1: + self.bbox_interval = opt.bbox_interval = (opt.epochs // 10) if opt.epochs > 10 else 1 + if opt.evolve: + self.bbox_interval = opt.bbox_interval = opt.epochs + 1 + train_from_artifact = self.train_artifact_path is not None and self.val_artifact_path is not None + # Update the the data_dict to point to local artifacts dir + if train_from_artifact: + self.data_dict = data_dict + + def download_dataset_artifact(self, path, alias): + """ + download the model checkpoint artifact if the path starts with WANDB_ARTIFACT_PREFIX + + arguments: + path -- path of the dataset to be used for training + alias (str)-- alias of the artifact to be download/used for training + + returns: + (str, wandb.Artifact) -- path of the downladed dataset and it's corresponding artifact object if dataset + is found otherwise returns (None, None) + """ + if isinstance(path, str) and path.startswith(WANDB_ARTIFACT_PREFIX): + artifact_path = Path(remove_prefix(path, WANDB_ARTIFACT_PREFIX) + ":" + alias) + dataset_artifact = wandb.use_artifact(artifact_path.as_posix().replace("\\", "/")) + assert dataset_artifact is not None, "'Error: W&B dataset artifact doesn\'t exist'" + datadir = dataset_artifact.download() + return datadir, dataset_artifact + return None, None + + def download_model_artifact(self, opt): + """ + download the model checkpoint artifact if the resume path starts with WANDB_ARTIFACT_PREFIX + + arguments: + opt (namespace) -- Commandline arguments for this run + """ + if opt.resume.startswith(WANDB_ARTIFACT_PREFIX): + model_artifact = wandb.use_artifact(remove_prefix(opt.resume, WANDB_ARTIFACT_PREFIX) + ":latest") + assert model_artifact is not None, 'Error: W&B model artifact doesn\'t exist' + modeldir = model_artifact.download() + # epochs_trained = model_artifact.metadata.get('epochs_trained') + total_epochs = model_artifact.metadata.get('total_epochs') + is_finished = total_epochs is None + assert not is_finished, 'training is finished, can only resume incomplete runs.' + return modeldir, model_artifact + return None, None + + def log_model(self, path, opt, epoch, fitness_score, best_model=False): + """ + Log the model checkpoint as W&B artifact + + arguments: + path (Path) -- Path of directory containing the checkpoints + opt (namespace) -- Command line arguments for this run + epoch (int) -- Current epoch number + fitness_score (float) -- fitness score for current epoch + best_model (boolean) -- Boolean representing if the current checkpoint is the best yet. + """ + model_artifact = wandb.Artifact('run_' + wandb.run.id + '_model', type='model', metadata={ + 'original_url': str(path), + 'epochs_trained': epoch + 1, + 'save period': opt.save_period, + 'project': opt.project, + 'total_epochs': opt.epochs, + 'fitness_score': fitness_score + }) + model_artifact.add_file(str(path / 'last.pt'), name='last.pt') + wandb.log_artifact(model_artifact, + aliases=['latest', 'last', 'epoch ' + str(self.current_epoch), 'best' if best_model else '']) + LOGGER.info(f"Saving model artifact on epoch {epoch + 1}") + + def log_dataset_artifact(self, data_file, single_cls, project, overwrite_config=False): + """ + Log the dataset as W&B artifact and return the new data file with W&B links + + arguments: + data_file (str) -- the .yaml file with information about the dataset like - path, classes etc. + single_class (boolean) -- train multi-class data as single-class + project (str) -- project name. Used to construct the artifact path + overwrite_config (boolean) -- overwrites the data.yaml file if set to true otherwise creates a new + file with _wandb postfix. Eg -> data_wandb.yaml + + returns: + the new .yaml file with artifact links. it can be used to start training directly from artifacts + """ + upload_dataset = self.wandb_run.config.upload_dataset + log_val_only = isinstance(upload_dataset, str) and upload_dataset == 'val' + self.data_dict = check_dataset(data_file) # parse and check + data = dict(self.data_dict) + nc, names = (1, ['item']) if single_cls else (int(data['nc']), data['names']) + names = {k: v for k, v in enumerate(names)} # to index dictionary + + # log train set + if not log_val_only: + self.train_artifact = self.create_dataset_table(LoadImagesAndLabels( + data['train'], rect=True, batch_size=1), names, name='train') if data.get('train') else None + if data.get('train'): + data['train'] = WANDB_ARTIFACT_PREFIX + str(Path(project) / 'train') + + self.val_artifact = self.create_dataset_table(LoadImagesAndLabels( + data['val'], rect=True, batch_size=1), names, name='val') if data.get('val') else None + if data.get('val'): + data['val'] = WANDB_ARTIFACT_PREFIX + str(Path(project) / 'val') + + path = Path(data_file) + # create a _wandb.yaml file with artifacts links if both train and test set are logged + if not log_val_only: + path = (path.stem if overwrite_config else path.stem + '_wandb') + '.yaml' # updated data.yaml path + path = ROOT / 'data' / path + data.pop('download', None) + data.pop('path', None) + with open(path, 'w') as f: + yaml.safe_dump(data, f) + LOGGER.info(f"Created dataset config file {path}") + + if self.job_type == 'Training': # builds correct artifact pipeline graph + if not log_val_only: + self.wandb_run.log_artifact( + self.train_artifact) # calling use_artifact downloads the dataset. NOT NEEDED! + self.wandb_run.use_artifact(self.val_artifact) + self.val_artifact.wait() + self.val_table = self.val_artifact.get('val') + self.map_val_table_path() + else: + self.wandb_run.log_artifact(self.train_artifact) + self.wandb_run.log_artifact(self.val_artifact) + return path + + def map_val_table_path(self): + """ + Map the validation dataset Table like name of file -> it's id in the W&B Table. + Useful for - referencing artifacts for evaluation. + """ + self.val_table_path_map = {} + LOGGER.info("Mapping dataset") + for i, data in enumerate(tqdm(self.val_table.data)): + self.val_table_path_map[data[3]] = data[0] + + def create_dataset_table(self, dataset: LoadImagesAndLabels, class_to_id: Dict[int, str], name: str = 'dataset'): + """ + Create and return W&B artifact containing W&B Table of the dataset. + + arguments: + dataset -- instance of LoadImagesAndLabels class used to iterate over the data to build Table + class_to_id -- hash map that maps class ids to labels + name -- name of the artifact + + returns: + dataset artifact to be logged or used + """ + # TODO: Explore multiprocessing to slpit this loop parallely| This is essential for speeding up the the logging + artifact = wandb.Artifact(name=name, type="dataset") + img_files = tqdm([dataset.path]) if isinstance(dataset.path, str) and Path(dataset.path).is_dir() else None + img_files = tqdm(dataset.img_files) if not img_files else img_files + for img_file in img_files: + if Path(img_file).is_dir(): + artifact.add_dir(img_file, name='data/images') + labels_path = 'labels'.join(dataset.path.rsplit('images', 1)) + artifact.add_dir(labels_path, name='data/labels') + else: + artifact.add_file(img_file, name='data/images/' + Path(img_file).name) + label_file = Path(img2label_paths([img_file])[0]) + artifact.add_file(str(label_file), + name='data/labels/' + label_file.name) if label_file.exists() else None + table = wandb.Table(columns=["id", "train_image", "Classes", "name"]) + class_set = wandb.Classes([{'id': id, 'name': name} for id, name in class_to_id.items()]) + for si, (img, labels, paths, shapes) in enumerate(tqdm(dataset)): + box_data, img_classes = [], {} + for cls, *xywh in labels[:, 1:].tolist(): + cls = int(cls) + box_data.append({"position": {"middle": [xywh[0], xywh[1]], "width": xywh[2], "height": xywh[3]}, + "class_id": cls, + "box_caption": "%s" % (class_to_id[cls])}) + img_classes[cls] = class_to_id[cls] + boxes = {"ground_truth": {"box_data": box_data, "class_labels": class_to_id}} # inference-space + table.add_data(si, wandb.Image(paths, classes=class_set, boxes=boxes), list(img_classes.values()), + Path(paths).name) + artifact.add(table, name) + return artifact + + def log_training_progress(self, predn, path, names): + """ + Build evaluation Table. Uses reference from validation dataset table. + + arguments: + predn (list): list of predictions in the native space in the format - [xmin, ymin, xmax, ymax, confidence, class] + path (str): local path of the current evaluation image + names (dict(int, str)): hash map that maps class ids to labels + """ + class_set = wandb.Classes([{'id': id, 'name': name} for id, name in names.items()]) + box_data = [] + avg_conf_per_class = [0] * len(self.data_dict['names']) + pred_class_count = {} + for *xyxy, conf, cls in predn.tolist(): + if conf >= 0.25: + cls = int(cls) + box_data.append( + {"position": {"minX": xyxy[0], "minY": xyxy[1], "maxX": xyxy[2], "maxY": xyxy[3]}, + "class_id": cls, + "box_caption": f"{names[cls]} {conf:.3f}", + "scores": {"class_score": conf}, + "domain": "pixel"}) + avg_conf_per_class[cls] += conf + + if cls in pred_class_count: + pred_class_count[cls] += 1 + else: + pred_class_count[cls] = 1 + + for pred_class in pred_class_count.keys(): + avg_conf_per_class[pred_class] = avg_conf_per_class[pred_class] / pred_class_count[pred_class] + + boxes = {"predictions": {"box_data": box_data, "class_labels": names}} # inference-space + id = self.val_table_path_map[Path(path).name] + self.result_table.add_data(self.current_epoch, + id, + self.val_table.data[id][1], + wandb.Image(self.val_table.data[id][1], boxes=boxes, classes=class_set), + *avg_conf_per_class + ) + + def val_one_image(self, pred, predn, path, names, im): + """ + Log validation data for one image. updates the result Table if validation dataset is uploaded and log bbox media panel + + arguments: + pred (list): list of scaled predictions in the format - [xmin, ymin, xmax, ymax, confidence, class] + predn (list): list of predictions in the native space - [xmin, ymin, xmax, ymax, confidence, class] + path (str): local path of the current evaluation image + """ + if self.val_table and self.result_table: # Log Table if Val dataset is uploaded as artifact + self.log_training_progress(predn, path, names) + + if len(self.bbox_media_panel_images) < self.max_imgs_to_log and self.current_epoch > 0: + if self.current_epoch % self.bbox_interval == 0: + box_data = [{"position": {"minX": xyxy[0], "minY": xyxy[1], "maxX": xyxy[2], "maxY": xyxy[3]}, + "class_id": int(cls), + "box_caption": f"{names[int(cls)]} {conf:.3f}", + "scores": {"class_score": conf}, + "domain": "pixel"} for *xyxy, conf, cls in pred.tolist()] + boxes = {"predictions": {"box_data": box_data, "class_labels": names}} # inference-space + self.bbox_media_panel_images.append(wandb.Image(im, boxes=boxes, caption=path.name)) + + def log(self, log_dict): + """ + save the metrics to the logging dictionary + + arguments: + log_dict (Dict) -- metrics/media to be logged in current step + """ + if self.wandb_run: + for key, value in log_dict.items(): + self.log_dict[key] = value + + def end_epoch(self, best_result=False): + """ + commit the log_dict, model artifacts and Tables to W&B and flush the log_dict. + + arguments: + best_result (boolean): Boolean representing if the result of this evaluation is best or not + """ + if self.wandb_run: + with all_logging_disabled(): + if self.bbox_media_panel_images: + self.log_dict["BoundingBoxDebugger"] = self.bbox_media_panel_images + try: + wandb.log(self.log_dict) + except BaseException as e: + LOGGER.info( + f"An error occurred in wandb logger. The training will proceed without interruption. More info\n{e}") + self.wandb_run.finish() + self.wandb_run = None + + self.log_dict = {} + self.bbox_media_panel_images = [] + if self.result_artifact: + self.result_artifact.add(self.result_table, 'result') + wandb.log_artifact(self.result_artifact, aliases=['latest', 'last', 'epoch ' + str(self.current_epoch), + ('best' if best_result else '')]) + + wandb.log({"evaluation": self.result_table}) + columns = ["epoch", "id", "ground truth", "prediction"] + columns.extend(self.data_dict['names']) + self.result_table = wandb.Table(columns) + self.result_artifact = wandb.Artifact("run_" + wandb.run.id + "_progress", "evaluation") + + def finish_run(self): + """ + Log metrics if any and finish the current W&B run + """ + if self.wandb_run: + if self.log_dict: + with all_logging_disabled(): + wandb.log(self.log_dict) + wandb.run.finish() + + +@contextmanager +def all_logging_disabled(highest_level=logging.CRITICAL): + """ source - https://gist.github.com/simon-weber/7853144 + A context manager that will prevent any logging messages triggered during the body from being processed. + :param highest_level: the maximum logging level in use. + This would only need to be changed if a custom level greater than CRITICAL is defined. + """ + previous_level = logging.root.manager.disable + logging.disable(highest_level) + try: + yield + finally: + logging.disable(previous_level) diff --git a/yolov5_Monocular_social_ranging/utils/loss.py b/yolov5_Monocular_social_ranging/utils/loss.py new file mode 100644 index 0000000..5aa9f01 --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/loss.py @@ -0,0 +1,222 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +Loss functions +""" + +import torch +import torch.nn as nn + +from utils.metrics import bbox_iou +from utils.torch_utils import de_parallel + + +def smooth_BCE(eps=0.1): # https://github.com/ultralytics/yolov3/issues/238#issuecomment-598028441 + # return positive, negative label smoothing BCE targets + return 1.0 - 0.5 * eps, 0.5 * eps + + +class BCEBlurWithLogitsLoss(nn.Module): + # BCEwithLogitLoss() with reduced missing label effects. + def __init__(self, alpha=0.05): + super().__init__() + self.loss_fcn = nn.BCEWithLogitsLoss(reduction='none') # must be nn.BCEWithLogitsLoss() + self.alpha = alpha + + def forward(self, pred, true): + loss = self.loss_fcn(pred, true) + pred = torch.sigmoid(pred) # prob from logits + dx = pred - true # reduce only missing label effects + # dx = (pred - true).abs() # reduce missing label and false label effects + alpha_factor = 1 - torch.exp((dx - 1) / (self.alpha + 1e-4)) + loss *= alpha_factor + return loss.mean() + + +class FocalLoss(nn.Module): + # Wraps focal loss around existing loss_fcn(), i.e. criteria = FocalLoss(nn.BCEWithLogitsLoss(), gamma=1.5) + def __init__(self, loss_fcn, gamma=1.5, alpha=0.25): + super().__init__() + self.loss_fcn = loss_fcn # must be nn.BCEWithLogitsLoss() + self.gamma = gamma + self.alpha = alpha + self.reduction = loss_fcn.reduction + self.loss_fcn.reduction = 'none' # required to apply FL to each element + + def forward(self, pred, true): + loss = self.loss_fcn(pred, true) + # p_t = torch.exp(-loss) + # loss *= self.alpha * (1.000001 - p_t) ** self.gamma # non-zero power for gradient stability + + # TF implementation https://github.com/tensorflow/addons/blob/v0.7.1/tensorflow_addons/losses/focal_loss.py + pred_prob = torch.sigmoid(pred) # prob from logits + p_t = true * pred_prob + (1 - true) * (1 - pred_prob) + alpha_factor = true * self.alpha + (1 - true) * (1 - self.alpha) + modulating_factor = (1.0 - p_t) ** self.gamma + loss *= alpha_factor * modulating_factor + + if self.reduction == 'mean': + return loss.mean() + elif self.reduction == 'sum': + return loss.sum() + else: # 'none' + return loss + + +class QFocalLoss(nn.Module): + # Wraps Quality focal loss around existing loss_fcn(), i.e. criteria = FocalLoss(nn.BCEWithLogitsLoss(), gamma=1.5) + def __init__(self, loss_fcn, gamma=1.5, alpha=0.25): + super().__init__() + self.loss_fcn = loss_fcn # must be nn.BCEWithLogitsLoss() + self.gamma = gamma + self.alpha = alpha + self.reduction = loss_fcn.reduction + self.loss_fcn.reduction = 'none' # required to apply FL to each element + + def forward(self, pred, true): + loss = self.loss_fcn(pred, true) + + pred_prob = torch.sigmoid(pred) # prob from logits + alpha_factor = true * self.alpha + (1 - true) * (1 - self.alpha) + modulating_factor = torch.abs(true - pred_prob) ** self.gamma + loss *= alpha_factor * modulating_factor + + if self.reduction == 'mean': + return loss.mean() + elif self.reduction == 'sum': + return loss.sum() + else: # 'none' + return loss + + +class ComputeLoss: + # Compute losses + def __init__(self, model, autobalance=False): + self.sort_obj_iou = False + device = next(model.parameters()).device # get model device + h = model.hyp # hyperparameters + + # Define criteria + BCEcls = nn.BCEWithLogitsLoss(pos_weight=torch.tensor([h['cls_pw']], device=device)) + BCEobj = nn.BCEWithLogitsLoss(pos_weight=torch.tensor([h['obj_pw']], device=device)) + + # Class label smoothing https://arxiv.org/pdf/1902.04103.pdf eqn 3 + self.cp, self.cn = smooth_BCE(eps=h.get('label_smoothing', 0.0)) # positive, negative BCE targets + + # Focal loss + g = h['fl_gamma'] # focal loss gamma + if g > 0: + BCEcls, BCEobj = FocalLoss(BCEcls, g), FocalLoss(BCEobj, g) + + det = de_parallel(model).model[-1] # Detect() module + self.balance = {3: [4.0, 1.0, 0.4]}.get(det.nl, [4.0, 1.0, 0.25, 0.06, 0.02]) # P3-P7 + self.ssi = list(det.stride).index(16) if autobalance else 0 # stride 16 index + self.BCEcls, self.BCEobj, self.gr, self.hyp, self.autobalance = BCEcls, BCEobj, 1.0, h, autobalance + for k in 'na', 'nc', 'nl', 'anchors': + setattr(self, k, getattr(det, k)) + + def __call__(self, p, targets): # predictions, targets, model + device = targets.device + lcls, lbox, lobj = torch.zeros(1, device=device), torch.zeros(1, device=device), torch.zeros(1, device=device) + tcls, tbox, indices, anchors = self.build_targets(p, targets) # targets + + # Losses + for i, pi in enumerate(p): # layer index, layer predictions + b, a, gj, gi = indices[i] # image, anchor, gridy, gridx + tobj = torch.zeros_like(pi[..., 0], device=device) # target obj + + n = b.shape[0] # number of targets + if n: + ps = pi[b, a, gj, gi] # prediction subset corresponding to targets + + # Regression + pxy = ps[:, :2].sigmoid() * 2 - 0.5 + pwh = (ps[:, 2:4].sigmoid() * 2) ** 2 * anchors[i] + pbox = torch.cat((pxy, pwh), 1) # predicted box + iou = bbox_iou(pbox.T, tbox[i], x1y1x2y2=False, CIoU=True) # iou(prediction, target) + lbox += (1.0 - iou).mean() # iou loss + + # Objectness + score_iou = iou.detach().clamp(0).type(tobj.dtype) + if self.sort_obj_iou: + sort_id = torch.argsort(score_iou) + b, a, gj, gi, score_iou = b[sort_id], a[sort_id], gj[sort_id], gi[sort_id], score_iou[sort_id] + tobj[b, a, gj, gi] = (1.0 - self.gr) + self.gr * score_iou # iou ratio + + # Classification + if self.nc > 1: # cls loss (only if multiple classes) + t = torch.full_like(ps[:, 5:], self.cn, device=device) # targets + t[range(n), tcls[i]] = self.cp + lcls += self.BCEcls(ps[:, 5:], t) # BCE + + # Append targets to text file + # with open('targets.txt', 'a') as file: + # [file.write('%11.5g ' * 4 % tuple(x) + '\n') for x in torch.cat((txy[i], twh[i]), 1)] + + obji = self.BCEobj(pi[..., 4], tobj) + lobj += obji * self.balance[i] # obj loss + if self.autobalance: + self.balance[i] = self.balance[i] * 0.9999 + 0.0001 / obji.detach().item() + + if self.autobalance: + self.balance = [x / self.balance[self.ssi] for x in self.balance] + lbox *= self.hyp['box'] + lobj *= self.hyp['obj'] + lcls *= self.hyp['cls'] + bs = tobj.shape[0] # batch size + + return (lbox + lobj + lcls) * bs, torch.cat((lbox, lobj, lcls)).detach() + + def build_targets(self, p, targets): + # Build targets for compute_loss(), input targets(image,class,x,y,w,h) + na, nt = self.na, targets.shape[0] # number of anchors, targets + tcls, tbox, indices, anch = [], [], [], [] + gain = torch.ones(7, device=targets.device) # normalized to gridspace gain + ai = torch.arange(na, device=targets.device).float().view(na, 1).repeat(1, nt) # same as .repeat_interleave(nt) + targets = torch.cat((targets.repeat(na, 1, 1), ai[:, :, None]), 2) # append anchor indices + + g = 0.5 # bias + off = torch.tensor([[0, 0], + [1, 0], [0, 1], [-1, 0], [0, -1], # j,k,l,m + # [1, 1], [1, -1], [-1, 1], [-1, -1], # jk,jm,lk,lm + ], device=targets.device).float() * g # offsets + + for i in range(self.nl): + anchors = self.anchors[i] + gain[2:6] = torch.tensor(p[i].shape)[[3, 2, 3, 2]] # xyxy gain + + # Match targets to anchors + t = targets * gain + if nt: + # Matches + r = t[:, :, 4:6] / anchors[:, None] # wh ratio + j = torch.max(r, 1 / r).max(2)[0] < self.hyp['anchor_t'] # compare + # j = wh_iou(anchors, t[:, 4:6]) > model.hyp['iou_t'] # iou(3,n)=wh_iou(anchors(3,2), gwh(n,2)) + t = t[j] # filter + + # Offsets + gxy = t[:, 2:4] # grid xy + gxi = gain[[2, 3]] - gxy # inverse + j, k = ((gxy % 1 < g) & (gxy > 1)).T + l, m = ((gxi % 1 < g) & (gxi > 1)).T + j = torch.stack((torch.ones_like(j), j, k, l, m)) + t = t.repeat((5, 1, 1))[j] + offsets = (torch.zeros_like(gxy)[None] + off[:, None])[j] + else: + t = targets[0] + offsets = 0 + + # Define + b, c = t[:, :2].long().T # image, class + gxy = t[:, 2:4] # grid xy + gwh = t[:, 4:6] # grid wh + gij = (gxy - offsets).long() + gi, gj = gij.T # grid xy indices + + # Append + a = t[:, 6].long() # anchor indices + indices.append((b, a, gj.clamp_(0, gain[3] - 1), gi.clamp_(0, gain[2] - 1))) # image, anchor, grid indices + tbox.append(torch.cat((gxy - gij, gwh), 1)) # box + anch.append(anchors[a]) # anchors + tcls.append(c) # class + + return tcls, tbox, indices, anch diff --git a/yolov5_Monocular_social_ranging/utils/metrics.py b/yolov5_Monocular_social_ranging/utils/metrics.py new file mode 100644 index 0000000..857fa5d --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/metrics.py @@ -0,0 +1,342 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +Model validation metrics +""" + +import math +import warnings +from pathlib import Path + +import matplotlib.pyplot as plt +import numpy as np +import torch + + +def fitness(x): + # Model fitness as a weighted combination of metrics + w = [0.0, 0.0, 0.1, 0.9] # weights for [P, R, mAP@0.5, mAP@0.5:0.95] + return (x[:, :4] * w).sum(1) + + +def ap_per_class(tp, conf, pred_cls, target_cls, plot=False, save_dir='.', names=(), eps=1e-16): + """ Compute the average precision, given the recall and precision curves. + Source: https://github.com/rafaelpadilla/Object-Detection-Metrics. + # Arguments + tp: True positives (nparray, nx1 or nx10). + conf: Objectness value from 0-1 (nparray). + pred_cls: Predicted object classes (nparray). + target_cls: True object classes (nparray). + plot: Plot precision-recall curve at mAP@0.5 + save_dir: Plot save directory + # Returns + The average precision as computed in py-faster-rcnn. + """ + + # Sort by objectness + i = np.argsort(-conf) + tp, conf, pred_cls = tp[i], conf[i], pred_cls[i] + + # Find unique classes + unique_classes, nt = np.unique(target_cls, return_counts=True) + nc = unique_classes.shape[0] # number of classes, number of detections + + # Create Precision-Recall curve and compute AP for each class + px, py = np.linspace(0, 1, 1000), [] # for plotting + ap, p, r = np.zeros((nc, tp.shape[1])), np.zeros((nc, 1000)), np.zeros((nc, 1000)) + for ci, c in enumerate(unique_classes): + i = pred_cls == c + n_l = nt[ci] # number of labels + n_p = i.sum() # number of predictions + + if n_p == 0 or n_l == 0: + continue + else: + # Accumulate FPs and TPs + fpc = (1 - tp[i]).cumsum(0) + tpc = tp[i].cumsum(0) + + # Recall + recall = tpc / (n_l + eps) # recall curve + r[ci] = np.interp(-px, -conf[i], recall[:, 0], left=0) # negative x, xp because xp decreases + + # Precision + precision = tpc / (tpc + fpc) # precision curve + p[ci] = np.interp(-px, -conf[i], precision[:, 0], left=1) # p at pr_score + + # AP from recall-precision curve + for j in range(tp.shape[1]): + ap[ci, j], mpre, mrec = compute_ap(recall[:, j], precision[:, j]) + if plot and j == 0: + py.append(np.interp(px, mrec, mpre)) # precision at mAP@0.5 + + # Compute F1 (harmonic mean of precision and recall) + f1 = 2 * p * r / (p + r + eps) + names = [v for k, v in names.items() if k in unique_classes] # list: only classes that have data + names = {i: v for i, v in enumerate(names)} # to dict + if plot: + plot_pr_curve(px, py, ap, Path(save_dir) / 'PR_curve.png', names) + plot_mc_curve(px, f1, Path(save_dir) / 'F1_curve.png', names, ylabel='F1') + plot_mc_curve(px, p, Path(save_dir) / 'P_curve.png', names, ylabel='Precision') + plot_mc_curve(px, r, Path(save_dir) / 'R_curve.png', names, ylabel='Recall') + + i = f1.mean(0).argmax() # max F1 index + p, r, f1 = p[:, i], r[:, i], f1[:, i] + tp = (r * nt).round() # true positives + fp = (tp / (p + eps) - tp).round() # false positives + return tp, fp, p, r, f1, ap, unique_classes.astype('int32') + + +def compute_ap(recall, precision): + """ Compute the average precision, given the recall and precision curves + # Arguments + recall: The recall curve (list) + precision: The precision curve (list) + # Returns + Average precision, precision curve, recall curve + """ + + # Append sentinel values to beginning and end + mrec = np.concatenate(([0.0], recall, [1.0])) + mpre = np.concatenate(([1.0], precision, [0.0])) + + # Compute the precision envelope + mpre = np.flip(np.maximum.accumulate(np.flip(mpre))) + + # Integrate area under curve + method = 'interp' # methods: 'continuous', 'interp' + if method == 'interp': + x = np.linspace(0, 1, 101) # 101-point interp (COCO) + ap = np.trapz(np.interp(x, mrec, mpre), x) # integrate + else: # 'continuous' + i = np.where(mrec[1:] != mrec[:-1])[0] # points where x axis (recall) changes + ap = np.sum((mrec[i + 1] - mrec[i]) * mpre[i + 1]) # area under curve + + return ap, mpre, mrec + + +class ConfusionMatrix: + # Updated version of https://github.com/kaanakan/object_detection_confusion_matrix + def __init__(self, nc, conf=0.25, iou_thres=0.45): + self.matrix = np.zeros((nc + 1, nc + 1)) + self.nc = nc # number of classes + self.conf = conf + self.iou_thres = iou_thres + + def process_batch(self, detections, labels): + """ + Return intersection-over-union (Jaccard index) of boxes. + Both sets of boxes are expected to be in (x1, y1, x2, y2) format. + Arguments: + detections (Array[N, 6]), x1, y1, x2, y2, conf, class + labels (Array[M, 5]), class, x1, y1, x2, y2 + Returns: + None, updates confusion matrix accordingly + """ + detections = detections[detections[:, 4] > self.conf] + gt_classes = labels[:, 0].int() + detection_classes = detections[:, 5].int() + iou = box_iou(labels[:, 1:], detections[:, :4]) + + x = torch.where(iou > self.iou_thres) + if x[0].shape[0]: + matches = torch.cat((torch.stack(x, 1), iou[x[0], x[1]][:, None]), 1).cpu().numpy() + if x[0].shape[0] > 1: + matches = matches[matches[:, 2].argsort()[::-1]] + matches = matches[np.unique(matches[:, 1], return_index=True)[1]] + matches = matches[matches[:, 2].argsort()[::-1]] + matches = matches[np.unique(matches[:, 0], return_index=True)[1]] + else: + matches = np.zeros((0, 3)) + + n = matches.shape[0] > 0 + m0, m1, _ = matches.transpose().astype(np.int16) + for i, gc in enumerate(gt_classes): + j = m0 == i + if n and sum(j) == 1: + self.matrix[detection_classes[m1[j]], gc] += 1 # correct + else: + self.matrix[self.nc, gc] += 1 # background FP + + if n: + for i, dc in enumerate(detection_classes): + if not any(m1 == i): + self.matrix[dc, self.nc] += 1 # background FN + + def matrix(self): + return self.matrix + + def tp_fp(self): + tp = self.matrix.diagonal() # true positives + fp = self.matrix.sum(1) - tp # false positives + # fn = self.matrix.sum(0) - tp # false negatives (missed detections) + return tp[:-1], fp[:-1] # remove background class + + def plot(self, normalize=True, save_dir='', names=()): + try: + import seaborn as sn + + array = self.matrix / ((self.matrix.sum(0).reshape(1, -1) + 1E-9) if normalize else 1) # normalize columns + array[array < 0.005] = np.nan # don't annotate (would appear as 0.00) + + fig = plt.figure(figsize=(12, 9), tight_layout=True) + nc, nn = self.nc, len(names) # number of classes, names + sn.set(font_scale=1.0 if nc < 50 else 0.8) # for label size + labels = (0 < nn < 99) and (nn == nc) # apply names to ticklabels + with warnings.catch_warnings(): + warnings.simplefilter('ignore') # suppress empty matrix RuntimeWarning: All-NaN slice encountered + sn.heatmap(array, annot=nc < 30, annot_kws={"size": 8}, cmap='Blues', fmt='.2f', square=True, vmin=0.0, + xticklabels=names + ['background FP'] if labels else "auto", + yticklabels=names + ['background FN'] if labels else "auto").set_facecolor((1, 1, 1)) + fig.axes[0].set_xlabel('True') + fig.axes[0].set_ylabel('Predicted') + fig.savefig(Path(save_dir) / 'confusion_matrix.png', dpi=250) + plt.close() + except Exception as e: + print(f'WARNING: ConfusionMatrix plot failure: {e}') + + def print(self): + for i in range(self.nc + 1): + print(' '.join(map(str, self.matrix[i]))) + + +def bbox_iou(box1, box2, x1y1x2y2=True, GIoU=False, DIoU=False, CIoU=False, eps=1e-7): + # Returns the IoU of box1 to box2. box1 is 4, box2 is nx4 + box2 = box2.T + + # Get the coordinates of bounding boxes + if x1y1x2y2: # x1, y1, x2, y2 = box1 + b1_x1, b1_y1, b1_x2, b1_y2 = box1[0], box1[1], box1[2], box1[3] + b2_x1, b2_y1, b2_x2, b2_y2 = box2[0], box2[1], box2[2], box2[3] + else: # transform from xywh to xyxy + b1_x1, b1_x2 = box1[0] - box1[2] / 2, box1[0] + box1[2] / 2 + b1_y1, b1_y2 = box1[1] - box1[3] / 2, box1[1] + box1[3] / 2 + b2_x1, b2_x2 = box2[0] - box2[2] / 2, box2[0] + box2[2] / 2 + b2_y1, b2_y2 = box2[1] - box2[3] / 2, box2[1] + box2[3] / 2 + + # Intersection area + inter = (torch.min(b1_x2, b2_x2) - torch.max(b1_x1, b2_x1)).clamp(0) * \ + (torch.min(b1_y2, b2_y2) - torch.max(b1_y1, b2_y1)).clamp(0) + + # Union Area + w1, h1 = b1_x2 - b1_x1, b1_y2 - b1_y1 + eps + w2, h2 = b2_x2 - b2_x1, b2_y2 - b2_y1 + eps + union = w1 * h1 + w2 * h2 - inter + eps + + iou = inter / union + if CIoU or DIoU or GIoU: + cw = torch.max(b1_x2, b2_x2) - torch.min(b1_x1, b2_x1) # convex (smallest enclosing box) width + ch = torch.max(b1_y2, b2_y2) - torch.min(b1_y1, b2_y1) # convex height + if CIoU or DIoU: # Distance or Complete IoU https://arxiv.org/abs/1911.08287v1 + c2 = cw ** 2 + ch ** 2 + eps # convex diagonal squared + rho2 = ((b2_x1 + b2_x2 - b1_x1 - b1_x2) ** 2 + + (b2_y1 + b2_y2 - b1_y1 - b1_y2) ** 2) / 4 # center distance squared + if CIoU: # https://github.com/Zzh-tju/DIoU-SSD-pytorch/blob/master/utils/box/box_utils.py#L47 + v = (4 / math.pi ** 2) * torch.pow(torch.atan(w2 / h2) - torch.atan(w1 / h1), 2) + with torch.no_grad(): + alpha = v / (v - iou + (1 + eps)) + return iou - (rho2 / c2 + v * alpha) # CIoU + return iou - rho2 / c2 # DIoU + c_area = cw * ch + eps # convex area + return iou - (c_area - union) / c_area # GIoU https://arxiv.org/pdf/1902.09630.pdf + return iou # IoU + + +def box_iou(box1, box2): + # https://github.com/pytorch/vision/blob/master/torchvision/ops/boxes.py + """ + Return intersection-over-union (Jaccard index) of boxes. + Both sets of boxes are expected to be in (x1, y1, x2, y2) format. + Arguments: + box1 (Tensor[N, 4]) + box2 (Tensor[M, 4]) + Returns: + iou (Tensor[N, M]): the NxM matrix containing the pairwise + IoU values for every element in boxes1 and boxes2 + """ + + def box_area(box): + # box = 4xn + return (box[2] - box[0]) * (box[3] - box[1]) + + area1 = box_area(box1.T) + area2 = box_area(box2.T) + + # inter(N,M) = (rb(N,M,2) - lt(N,M,2)).clamp(0).prod(2) + inter = (torch.min(box1[:, None, 2:], box2[:, 2:]) - torch.max(box1[:, None, :2], box2[:, :2])).clamp(0).prod(2) + return inter / (area1[:, None] + area2 - inter) # iou = inter / (area1 + area2 - inter) + + +def bbox_ioa(box1, box2, eps=1E-7): + """ Returns the intersection over box2 area given box1, box2. Boxes are x1y1x2y2 + box1: np.array of shape(4) + box2: np.array of shape(nx4) + returns: np.array of shape(n) + """ + + box2 = box2.transpose() + + # Get the coordinates of bounding boxes + b1_x1, b1_y1, b1_x2, b1_y2 = box1[0], box1[1], box1[2], box1[3] + b2_x1, b2_y1, b2_x2, b2_y2 = box2[0], box2[1], box2[2], box2[3] + + # Intersection area + inter_area = (np.minimum(b1_x2, b2_x2) - np.maximum(b1_x1, b2_x1)).clip(0) * \ + (np.minimum(b1_y2, b2_y2) - np.maximum(b1_y1, b2_y1)).clip(0) + + # box2 area + box2_area = (b2_x2 - b2_x1) * (b2_y2 - b2_y1) + eps + + # Intersection over box2 area + return inter_area / box2_area + + +def wh_iou(wh1, wh2): + # Returns the nxm IoU matrix. wh1 is nx2, wh2 is mx2 + wh1 = wh1[:, None] # [N,1,2] + wh2 = wh2[None] # [1,M,2] + inter = torch.min(wh1, wh2).prod(2) # [N,M] + return inter / (wh1.prod(2) + wh2.prod(2) - inter) # iou = inter / (area1 + area2 - inter) + + +# Plots ---------------------------------------------------------------------------------------------------------------- + +def plot_pr_curve(px, py, ap, save_dir='pr_curve.png', names=()): + # Precision-recall curve + fig, ax = plt.subplots(1, 1, figsize=(9, 6), tight_layout=True) + py = np.stack(py, axis=1) + + if 0 < len(names) < 21: # display per-class legend if < 21 classes + for i, y in enumerate(py.T): + ax.plot(px, y, linewidth=1, label=f'{names[i]} {ap[i, 0]:.3f}') # plot(recall, precision) + else: + ax.plot(px, py, linewidth=1, color='grey') # plot(recall, precision) + + ax.plot(px, py.mean(1), linewidth=3, color='blue', label='all classes %.3f mAP@0.5' % ap[:, 0].mean()) + ax.set_xlabel('Recall') + ax.set_ylabel('Precision') + ax.set_xlim(0, 1) + ax.set_ylim(0, 1) + plt.legend(bbox_to_anchor=(1.04, 1), loc="upper left") + fig.savefig(Path(save_dir), dpi=250) + plt.close() + + +def plot_mc_curve(px, py, save_dir='mc_curve.png', names=(), xlabel='Confidence', ylabel='Metric'): + # Metric-confidence curve + fig, ax = plt.subplots(1, 1, figsize=(9, 6), tight_layout=True) + + if 0 < len(names) < 21: # display per-class legend if < 21 classes + for i, y in enumerate(py): + ax.plot(px, y, linewidth=1, label=f'{names[i]}') # plot(confidence, metric) + else: + ax.plot(px, py.T, linewidth=1, color='grey') # plot(confidence, metric) + + y = py.mean(0) + ax.plot(px, y, linewidth=3, color='blue', label=f'all classes {y.max():.2f} at {px[y.argmax()]:.3f}') + ax.set_xlabel(xlabel) + ax.set_ylabel(ylabel) + ax.set_xlim(0, 1) + ax.set_ylim(0, 1) + plt.legend(bbox_to_anchor=(1.04, 1), loc="upper left") + fig.savefig(Path(save_dir), dpi=250) + plt.close() diff --git a/yolov5_Monocular_social_ranging/utils/plots.py b/yolov5_Monocular_social_ranging/utils/plots.py new file mode 100644 index 0000000..6c3f5bc --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/plots.py @@ -0,0 +1,471 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +Plotting utils +""" + +import math +import os +from copy import copy +from pathlib import Path + +import cv2 +import matplotlib +import matplotlib.pyplot as plt +import numpy as np +import pandas as pd +import seaborn as sn +import torch +from PIL import Image, ImageDraw, ImageFont + +from utils.general import (CONFIG_DIR, FONT, LOGGER, Timeout, check_font, check_requirements, clip_coords, + increment_path, is_ascii, is_chinese, try_except, xywh2xyxy, xyxy2xywh) +from utils.metrics import fitness + +# Settings +RANK = int(os.getenv('RANK', -1)) +matplotlib.rc('font', **{'size': 11}) +matplotlib.use('Agg') # for writing to files only + + +class Colors: + # Ultralytics color palette https://ultralytics.com/ + def __init__(self): + # hex = matplotlib.colors.TABLEAU_COLORS.values() + hex = ('FF3838', 'FF9D97', 'FF701F', 'FFB21D', 'CFD231', '48F90A', '92CC17', '3DDB86', '1A9334', '00D4BB', + '2C99A8', '00C2FF', '344593', '6473FF', '0018EC', '8438FF', '520085', 'CB38FF', 'FF95C8', 'FF37C7') + self.palette = [self.hex2rgb('#' + c) for c in hex] + self.n = len(self.palette) + + def __call__(self, i, bgr=False): + c = self.palette[int(i) % self.n] + return (c[2], c[1], c[0]) if bgr else c + + @staticmethod + def hex2rgb(h): # rgb order (PIL) + return tuple(int(h[1 + i:1 + i + 2], 16) for i in (0, 2, 4)) + + +colors = Colors() # create instance for 'from utils.plots import colors' + + +def check_pil_font(font=FONT, size=10): + # Return a PIL TrueType Font, downloading to CONFIG_DIR if necessary + font = Path(font) + font = font if font.exists() else (CONFIG_DIR / font.name) + try: + return ImageFont.truetype(str(font) if font.exists() else font.name, size) + except Exception: # download if missing + check_font(font) + try: + return ImageFont.truetype(str(font), size) + except TypeError: + check_requirements('Pillow>=8.4.0') # known issue https://github.com/ultralytics/yolov5/issues/5374 + + +class Annotator: + if RANK in (-1, 0): + check_pil_font() # download TTF if necessary + + # YOLOv5 Annotator for train/val mosaics and jpgs and detect/hub inference annotations + def __init__(self, im, line_width=None, font_size=None, font='Arial.ttf', pil=False, example='abc'): + assert im.data.contiguous, 'Image not contiguous. Apply np.ascontiguousarray(im) to Annotator() input images.' + self.pil = pil or not is_ascii(example) or is_chinese(example) + if self.pil: # use PIL + self.im = im if isinstance(im, Image.Image) else Image.fromarray(im) + self.draw = ImageDraw.Draw(self.im) + self.font = check_pil_font(font='Arial.Unicode.ttf' if is_chinese(example) else font, + size=font_size or max(round(sum(self.im.size) / 2 * 0.035), 12)) + else: # use cv2 + self.im = im + self.lw = line_width or max(round(sum(im.shape) / 2 * 0.003), 2) # line width + + def box_label(self, box, label='', color=(128, 128, 128), txt_color=(255, 255, 255)): + # Add one xyxy box to image with label + if self.pil or not is_ascii(label): + self.draw.rectangle(box, width=self.lw, outline=color) # box + if label: + w, h = self.font.getsize(label) # text width, height + outside = box[1] - h >= 0 # label fits outside box + self.draw.rectangle((box[0], + box[1] - h if outside else box[1], + box[0] + w + 1, + box[1] + 1 if outside else box[1] + h + 1), fill=color) + # self.draw.text((box[0], box[1]), label, fill=txt_color, font=self.font, anchor='ls') # for PIL>8.0 + self.draw.text((box[0], box[1] - h if outside else box[1]), label, fill=txt_color, font=self.font) + else: # cv2 + p1, p2 = (int(box[0]), int(box[1])), (int(box[2]), int(box[3])) + cv2.rectangle(self.im, p1, p2, color, thickness=self.lw, lineType=cv2.LINE_AA) + if label: + tf = max(self.lw - 1, 1) # font thickness + w, h = cv2.getTextSize(label, 0, fontScale=self.lw / 3, thickness=tf)[0] # text width, height + outside = p1[1] - h - 3 >= 0 # label fits outside box + p2 = p1[0] + w, p1[1] - h - 3 if outside else p1[1] + h + 3 + cv2.rectangle(self.im, p1, p2, color, -1, cv2.LINE_AA) # filled + cv2.putText(self.im, label, (p1[0], p1[1] - 2 if outside else p1[1] + h + 2), 0, self.lw / 3, txt_color, + thickness=tf, lineType=cv2.LINE_AA) + + def rectangle(self, xy, fill=None, outline=None, width=1): + # Add rectangle to image (PIL-only) + self.draw.rectangle(xy, fill, outline, width) + + def text(self, xy, text, txt_color=(255, 255, 255)): + # Add text to image (PIL-only) + w, h = self.font.getsize(text) # text width, height + self.draw.text((xy[0], xy[1] - h + 1), text, fill=txt_color, font=self.font) + + def result(self): + # Return annotated image as array + return np.asarray(self.im) + + +def feature_visualization(x, module_type, stage, n=32, save_dir=Path('runs/detect/exp')): + """ + x: Features to be visualized + module_type: Module type + stage: Module stage within model + n: Maximum number of feature maps to plot + save_dir: Directory to save results + """ + if 'Detect' not in module_type: + batch, channels, height, width = x.shape # batch, channels, height, width + if height > 1 and width > 1: + f = save_dir / f"stage{stage}_{module_type.split('.')[-1]}_features.png" # filename + + blocks = torch.chunk(x[0].cpu(), channels, dim=0) # select batch index 0, block by channels + n = min(n, channels) # number of plots + fig, ax = plt.subplots(math.ceil(n / 8), 8, tight_layout=True) # 8 rows x n/8 cols + ax = ax.ravel() + plt.subplots_adjust(wspace=0.05, hspace=0.05) + for i in range(n): + ax[i].imshow(blocks[i].squeeze()) # cmap='gray' + ax[i].axis('off') + + LOGGER.info(f'Saving {f}... ({n}/{channels})') + plt.savefig(f, dpi=300, bbox_inches='tight') + plt.close() + np.save(str(f.with_suffix('.npy')), x[0].cpu().numpy()) # npy save + + +def hist2d(x, y, n=100): + # 2d histogram used in labels.png and evolve.png + xedges, yedges = np.linspace(x.min(), x.max(), n), np.linspace(y.min(), y.max(), n) + hist, xedges, yedges = np.histogram2d(x, y, (xedges, yedges)) + xidx = np.clip(np.digitize(x, xedges) - 1, 0, hist.shape[0] - 1) + yidx = np.clip(np.digitize(y, yedges) - 1, 0, hist.shape[1] - 1) + return np.log(hist[xidx, yidx]) + + +def butter_lowpass_filtfilt(data, cutoff=1500, fs=50000, order=5): + from scipy.signal import butter, filtfilt + + # https://stackoverflow.com/questions/28536191/how-to-filter-smooth-with-scipy-numpy + def butter_lowpass(cutoff, fs, order): + nyq = 0.5 * fs + normal_cutoff = cutoff / nyq + return butter(order, normal_cutoff, btype='low', analog=False) + + b, a = butter_lowpass(cutoff, fs, order=order) + return filtfilt(b, a, data) # forward-backward filter + + +def output_to_target(output): + # Convert model output to target format [batch_id, class_id, x, y, w, h, conf] + targets = [] + for i, o in enumerate(output): + for *box, conf, cls in o.cpu().numpy(): + targets.append([i, cls, *list(*xyxy2xywh(np.array(box)[None])), conf]) + return np.array(targets) + + +def plot_images(images, targets, paths=None, fname='images.jpg', names=None, max_size=1920, max_subplots=16): + # Plot image grid with labels + if isinstance(images, torch.Tensor): + images = images.cpu().float().numpy() + if isinstance(targets, torch.Tensor): + targets = targets.cpu().numpy() + if np.max(images[0]) <= 1: + images *= 255 # de-normalise (optional) + bs, _, h, w = images.shape # batch size, _, height, width + bs = min(bs, max_subplots) # limit plot images + ns = np.ceil(bs ** 0.5) # number of subplots (square) + + # Build Image + mosaic = np.full((int(ns * h), int(ns * w), 3), 255, dtype=np.uint8) # init + for i, im in enumerate(images): + if i == max_subplots: # if last batch has fewer images than we expect + break + x, y = int(w * (i // ns)), int(h * (i % ns)) # block origin + im = im.transpose(1, 2, 0) + mosaic[y:y + h, x:x + w, :] = im + + # Resize (optional) + scale = max_size / ns / max(h, w) + if scale < 1: + h = math.ceil(scale * h) + w = math.ceil(scale * w) + mosaic = cv2.resize(mosaic, tuple(int(x * ns) for x in (w, h))) + + # Annotate + fs = int((h + w) * ns * 0.01) # font size + annotator = Annotator(mosaic, line_width=round(fs / 10), font_size=fs, pil=True, example=names) + for i in range(i + 1): + x, y = int(w * (i // ns)), int(h * (i % ns)) # block origin + annotator.rectangle([x, y, x + w, y + h], None, (255, 255, 255), width=2) # borders + if paths: + annotator.text((x + 5, y + 5 + h), text=Path(paths[i]).name[:40], txt_color=(220, 220, 220)) # filenames + if len(targets) > 0: + ti = targets[targets[:, 0] == i] # image targets + boxes = xywh2xyxy(ti[:, 2:6]).T + classes = ti[:, 1].astype('int') + labels = ti.shape[1] == 6 # labels if no conf column + conf = None if labels else ti[:, 6] # check for confidence presence (label vs pred) + + if boxes.shape[1]: + if boxes.max() <= 1.01: # if normalized with tolerance 0.01 + boxes[[0, 2]] *= w # scale to pixels + boxes[[1, 3]] *= h + elif scale < 1: # absolute coords need scale if image scales + boxes *= scale + boxes[[0, 2]] += x + boxes[[1, 3]] += y + for j, box in enumerate(boxes.T.tolist()): + cls = classes[j] + color = colors(cls) + cls = names[cls] if names else cls + if labels or conf[j] > 0.25: # 0.25 conf thresh + label = f'{cls}' if labels else f'{cls} {conf[j]:.1f}' + annotator.box_label(box, label, color=color) + annotator.im.save(fname) # save + + +def plot_lr_scheduler(optimizer, scheduler, epochs=300, save_dir=''): + # Plot LR simulating training for full epochs + optimizer, scheduler = copy(optimizer), copy(scheduler) # do not modify originals + y = [] + for _ in range(epochs): + scheduler.step() + y.append(optimizer.param_groups[0]['lr']) + plt.plot(y, '.-', label='LR') + plt.xlabel('epoch') + plt.ylabel('LR') + plt.grid() + plt.xlim(0, epochs) + plt.ylim(0) + plt.savefig(Path(save_dir) / 'LR.png', dpi=200) + plt.close() + + +def plot_val_txt(): # from utils.plots import *; plot_val() + # Plot val.txt histograms + x = np.loadtxt('val.txt', dtype=np.float32) + box = xyxy2xywh(x[:, :4]) + cx, cy = box[:, 0], box[:, 1] + + fig, ax = plt.subplots(1, 1, figsize=(6, 6), tight_layout=True) + ax.hist2d(cx, cy, bins=600, cmax=10, cmin=0) + ax.set_aspect('equal') + plt.savefig('hist2d.png', dpi=300) + + fig, ax = plt.subplots(1, 2, figsize=(12, 6), tight_layout=True) + ax[0].hist(cx, bins=600) + ax[1].hist(cy, bins=600) + plt.savefig('hist1d.png', dpi=200) + + +def plot_targets_txt(): # from utils.plots import *; plot_targets_txt() + # Plot targets.txt histograms + x = np.loadtxt('targets.txt', dtype=np.float32).T + s = ['x targets', 'y targets', 'width targets', 'height targets'] + fig, ax = plt.subplots(2, 2, figsize=(8, 8), tight_layout=True) + ax = ax.ravel() + for i in range(4): + ax[i].hist(x[i], bins=100, label=f'{x[i].mean():.3g} +/- {x[i].std():.3g}') + ax[i].legend() + ax[i].set_title(s[i]) + plt.savefig('targets.jpg', dpi=200) + + +def plot_val_study(file='', dir='', x=None): # from utils.plots import *; plot_val_study() + # Plot file=study.txt generated by val.py (or plot all study*.txt in dir) + save_dir = Path(file).parent if file else Path(dir) + plot2 = False # plot additional results + if plot2: + ax = plt.subplots(2, 4, figsize=(10, 6), tight_layout=True)[1].ravel() + + fig2, ax2 = plt.subplots(1, 1, figsize=(8, 4), tight_layout=True) + # for f in [save_dir / f'study_coco_{x}.txt' for x in ['yolov5n6', 'yolov5s6', 'yolov5m6', 'yolov5l6', 'yolov5x6']]: + for f in sorted(save_dir.glob('study*.txt')): + y = np.loadtxt(f, dtype=np.float32, usecols=[0, 1, 2, 3, 7, 8, 9], ndmin=2).T + x = np.arange(y.shape[1]) if x is None else np.array(x) + if plot2: + s = ['P', 'R', 'mAP@.5', 'mAP@.5:.95', 't_preprocess (ms/img)', 't_inference (ms/img)', 't_NMS (ms/img)'] + for i in range(7): + ax[i].plot(x, y[i], '.-', linewidth=2, markersize=8) + ax[i].set_title(s[i]) + + j = y[3].argmax() + 1 + ax2.plot(y[5, 1:j], y[3, 1:j] * 1E2, '.-', linewidth=2, markersize=8, + label=f.stem.replace('study_coco_', '').replace('yolo', 'YOLO')) + + ax2.plot(1E3 / np.array([209, 140, 97, 58, 35, 18]), [34.6, 40.5, 43.0, 47.5, 49.7, 51.5], + 'k.-', linewidth=2, markersize=8, alpha=.25, label='EfficientDet') + + ax2.grid(alpha=0.2) + ax2.set_yticks(np.arange(20, 60, 5)) + ax2.set_xlim(0, 57) + ax2.set_ylim(25, 55) + ax2.set_xlabel('GPU Speed (ms/img)') + ax2.set_ylabel('COCO AP val') + ax2.legend(loc='lower right') + f = save_dir / 'study.png' + print(f'Saving {f}...') + plt.savefig(f, dpi=300) + + +@try_except # known issue https://github.com/ultralytics/yolov5/issues/5395 +@Timeout(30) # known issue https://github.com/ultralytics/yolov5/issues/5611 +def plot_labels(labels, names=(), save_dir=Path('')): + # plot dataset labels + LOGGER.info(f"Plotting labels to {save_dir / 'labels.jpg'}... ") + c, b = labels[:, 0], labels[:, 1:].transpose() # classes, boxes + nc = int(c.max() + 1) # number of classes + x = pd.DataFrame(b.transpose(), columns=['x', 'y', 'width', 'height']) + + # seaborn correlogram + sn.pairplot(x, corner=True, diag_kind='auto', kind='hist', diag_kws=dict(bins=50), plot_kws=dict(pmax=0.9)) + plt.savefig(save_dir / 'labels_correlogram.jpg', dpi=200) + plt.close() + + # matplotlib labels + matplotlib.use('svg') # faster + ax = plt.subplots(2, 2, figsize=(8, 8), tight_layout=True)[1].ravel() + y = ax[0].hist(c, bins=np.linspace(0, nc, nc + 1) - 0.5, rwidth=0.8) + try: # color histogram bars by class + [y[2].patches[i].set_color([x / 255 for x in colors(i)]) for i in range(nc)] # known issue #3195 + except Exception: + pass + ax[0].set_ylabel('instances') + if 0 < len(names) < 30: + ax[0].set_xticks(range(len(names))) + ax[0].set_xticklabels(names, rotation=90, fontsize=10) + else: + ax[0].set_xlabel('classes') + sn.histplot(x, x='x', y='y', ax=ax[2], bins=50, pmax=0.9) + sn.histplot(x, x='width', y='height', ax=ax[3], bins=50, pmax=0.9) + + # rectangles + labels[:, 1:3] = 0.5 # center + labels[:, 1:] = xywh2xyxy(labels[:, 1:]) * 2000 + img = Image.fromarray(np.ones((2000, 2000, 3), dtype=np.uint8) * 255) + for cls, *box in labels[:1000]: + ImageDraw.Draw(img).rectangle(box, width=1, outline=colors(cls)) # plot + ax[1].imshow(img) + ax[1].axis('off') + + for a in [0, 1, 2, 3]: + for s in ['top', 'right', 'left', 'bottom']: + ax[a].spines[s].set_visible(False) + + plt.savefig(save_dir / 'labels.jpg', dpi=200) + matplotlib.use('Agg') + plt.close() + + +def plot_evolve(evolve_csv='path/to/evolve.csv'): # from utils.plots import *; plot_evolve() + # Plot evolve.csv hyp evolution results + evolve_csv = Path(evolve_csv) + data = pd.read_csv(evolve_csv) + keys = [x.strip() for x in data.columns] + x = data.values + f = fitness(x) + j = np.argmax(f) # max fitness index + plt.figure(figsize=(10, 12), tight_layout=True) + matplotlib.rc('font', **{'size': 8}) + print(f'Best results from row {j} of {evolve_csv}:') + for i, k in enumerate(keys[7:]): + v = x[:, 7 + i] + mu = v[j] # best single result + plt.subplot(6, 5, i + 1) + plt.scatter(v, f, c=hist2d(v, f, 20), cmap='viridis', alpha=.8, edgecolors='none') + plt.plot(mu, f.max(), 'k+', markersize=15) + plt.title(f'{k} = {mu:.3g}', fontdict={'size': 9}) # limit to 40 characters + if i % 5 != 0: + plt.yticks([]) + print(f'{k:>15}: {mu:.3g}') + f = evolve_csv.with_suffix('.png') # filename + plt.savefig(f, dpi=200) + plt.close() + print(f'Saved {f}') + + +def plot_results(file='path/to/results.csv', dir=''): + # Plot training results.csv. Usage: from utils.plots import *; plot_results('path/to/results.csv') + save_dir = Path(file).parent if file else Path(dir) + fig, ax = plt.subplots(2, 5, figsize=(12, 6), tight_layout=True) + ax = ax.ravel() + files = list(save_dir.glob('results*.csv')) + assert len(files), f'No results.csv files found in {save_dir.resolve()}, nothing to plot.' + for fi, f in enumerate(files): + try: + data = pd.read_csv(f) + s = [x.strip() for x in data.columns] + x = data.values[:, 0] + for i, j in enumerate([1, 2, 3, 4, 5, 8, 9, 10, 6, 7]): + y = data.values[:, j] + # y[y == 0] = np.nan # don't show zero values + ax[i].plot(x, y, marker='.', label=f.stem, linewidth=2, markersize=8) + ax[i].set_title(s[j], fontsize=12) + # if j in [8, 9, 10]: # share train and val loss y axes + # ax[i].get_shared_y_axes().join(ax[i], ax[i - 5]) + except Exception as e: + LOGGER.info(f'Warning: Plotting error for {f}: {e}') + ax[1].legend() + fig.savefig(save_dir / 'results.png', dpi=200) + plt.close() + + +def profile_idetection(start=0, stop=0, labels=(), save_dir=''): + # Plot iDetection '*.txt' per-image logs. from utils.plots import *; profile_idetection() + ax = plt.subplots(2, 4, figsize=(12, 6), tight_layout=True)[1].ravel() + s = ['Images', 'Free Storage (GB)', 'RAM Usage (GB)', 'Battery', 'dt_raw (ms)', 'dt_smooth (ms)', 'real-world FPS'] + files = list(Path(save_dir).glob('frames*.txt')) + for fi, f in enumerate(files): + try: + results = np.loadtxt(f, ndmin=2).T[:, 90:-30] # clip first and last rows + n = results.shape[1] # number of rows + x = np.arange(start, min(stop, n) if stop else n) + results = results[:, x] + t = (results[0] - results[0].min()) # set t0=0s + results[0] = x + for i, a in enumerate(ax): + if i < len(results): + label = labels[fi] if len(labels) else f.stem.replace('frames_', '') + a.plot(t, results[i], marker='.', label=label, linewidth=1, markersize=5) + a.set_title(s[i]) + a.set_xlabel('time (s)') + # if fi == len(files) - 1: + # a.set_ylim(bottom=0) + for side in ['top', 'right']: + a.spines[side].set_visible(False) + else: + a.remove() + except Exception as e: + print(f'Warning: Plotting error for {f}; {e}') + ax[1].legend() + plt.savefig(Path(save_dir) / 'idetection_profile.png', dpi=200) + + +def save_one_box(xyxy, im, file='image.jpg', gain=1.02, pad=10, square=False, BGR=False, save=True): + # Save image crop as {file} with crop size multiple {gain} and {pad} pixels. Save and/or return crop + xyxy = torch.tensor(xyxy).view(-1, 4) + b = xyxy2xywh(xyxy) # boxes + if square: + b[:, 2:] = b[:, 2:].max(1)[0].unsqueeze(1) # attempt rectangle to square + b[:, 2:] = b[:, 2:] * gain + pad # box wh * gain + pad + xyxy = xywh2xyxy(b).long() + clip_coords(xyxy, im.shape) + crop = im[int(xyxy[0, 1]):int(xyxy[0, 3]), int(xyxy[0, 0]):int(xyxy[0, 2]), ::(1 if BGR else -1)] + if save: + file.parent.mkdir(parents=True, exist_ok=True) # make directory + cv2.imwrite(str(increment_path(file).with_suffix('.jpg')), crop) + return crop diff --git a/yolov5_Monocular_social_ranging/utils/torch_utils.py b/yolov5_Monocular_social_ranging/utils/torch_utils.py new file mode 100644 index 0000000..c5257c6 --- /dev/null +++ b/yolov5_Monocular_social_ranging/utils/torch_utils.py @@ -0,0 +1,329 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +PyTorch utils +""" + +import datetime +import math +import os +import platform +import subprocess +import time +import warnings +from contextlib import contextmanager +from copy import deepcopy +from pathlib import Path + +import torch +import torch.distributed as dist +import torch.nn as nn +import torch.nn.functional as F + +from utils.general import LOGGER + +try: + import thop # for FLOPs computation +except ImportError: + thop = None + +# Suppress PyTorch warnings +warnings.filterwarnings('ignore', message='User provided device_type of \'cuda\', but CUDA is not available. Disabling') + + +@contextmanager +def torch_distributed_zero_first(local_rank: int): + """ + Decorator to make all processes in distributed training wait for each local_master to do something. + """ + if local_rank not in [-1, 0]: + dist.barrier(device_ids=[local_rank]) + yield + if local_rank == 0: + dist.barrier(device_ids=[0]) + + +def date_modified(path=__file__): + # return human-readable file modification date, i.e. '2021-3-26' + t = datetime.datetime.fromtimestamp(Path(path).stat().st_mtime) + return f'{t.year}-{t.month}-{t.day}' + + +def git_describe(path=Path(__file__).parent): # path must be a directory + # return human-readable git description, i.e. v5.0-5-g3e25f1e https://git-scm.com/docs/git-describe + s = f'git -C {path} describe --tags --long --always' + try: + return subprocess.check_output(s, shell=True, stderr=subprocess.STDOUT).decode()[:-1] + except subprocess.CalledProcessError: + return '' # not a git repository + + +def device_count(): + # Returns number of CUDA devices available. Safe version of torch.cuda.device_count(). Only works on Linux. + assert platform.system() == 'Linux', 'device_count() function only works on Linux' + try: + cmd = 'nvidia-smi -L | wc -l' + return int(subprocess.run(cmd, shell=True, capture_output=True, check=True).stdout.decode().split()[-1]) + except Exception: + return 0 + + +def select_device(device='', batch_size=0, newline=True): + # device = 'cpu' or '0' or '0,1,2,3' + s = f'YOLOv5 🚀 {git_describe() or date_modified()} torch {torch.__version__} ' # string + device = str(device).strip().lower().replace('cuda:', '') # to string, 'cuda:0' to '0' + cpu = device == 'cpu' + if cpu: + os.environ['CUDA_VISIBLE_DEVICES'] = '-1' # force torch.cuda.is_available() = False + elif device: # non-cpu device requested + os.environ['CUDA_VISIBLE_DEVICES'] = device # set environment variable - must be before assert is_available() + assert torch.cuda.is_available() and torch.cuda.device_count() >= len(device.replace(',', '')), \ + f"Invalid CUDA '--device {device}' requested, use '--device cpu' or pass valid CUDA device(s)" + + cuda = not cpu and torch.cuda.is_available() + if cuda: + devices = device.split(',') if device else '0' # range(torch.cuda.device_count()) # i.e. 0,1,6,7 + n = len(devices) # device count + if n > 1 and batch_size > 0: # check batch_size is divisible by device_count + assert batch_size % n == 0, f'batch-size {batch_size} not multiple of GPU count {n}' + space = ' ' * (len(s) + 1) + for i, d in enumerate(devices): + p = torch.cuda.get_device_properties(i) + s += f"{'' if i == 0 else space}CUDA:{d} ({p.name}, {p.total_memory / 1024 ** 2:.0f}MiB)\n" # bytes to MB + else: + s += 'CPU\n' + + if not newline: + s = s.rstrip() + LOGGER.info(s.encode().decode('ascii', 'ignore') if platform.system() == 'Windows' else s) # emoji-safe + return torch.device('cuda:0' if cuda else 'cpu') + + +def time_sync(): + # pytorch-accurate time + if torch.cuda.is_available(): + torch.cuda.synchronize() + return time.time() + + +def profile(input, ops, n=10, device=None): + # YOLOv5 speed/memory/FLOPs profiler + # + # Usage: + # input = torch.randn(16, 3, 640, 640) + # m1 = lambda x: x * torch.sigmoid(x) + # m2 = nn.SiLU() + # profile(input, [m1, m2], n=100) # profile over 100 iterations + + results = [] + device = device or select_device() + print(f"{'Params':>12s}{'GFLOPs':>12s}{'GPU_mem (GB)':>14s}{'forward (ms)':>14s}{'backward (ms)':>14s}" + f"{'input':>24s}{'output':>24s}") + + for x in input if isinstance(input, list) else [input]: + x = x.to(device) + x.requires_grad = True + for m in ops if isinstance(ops, list) else [ops]: + m = m.to(device) if hasattr(m, 'to') else m # device + m = m.half() if hasattr(m, 'half') and isinstance(x, torch.Tensor) and x.dtype is torch.float16 else m + tf, tb, t = 0, 0, [0, 0, 0] # dt forward, backward + try: + flops = thop.profile(m, inputs=(x,), verbose=False)[0] / 1E9 * 2 # GFLOPs + except Exception: + flops = 0 + + try: + for _ in range(n): + t[0] = time_sync() + y = m(x) + t[1] = time_sync() + try: + _ = (sum(yi.sum() for yi in y) if isinstance(y, list) else y).sum().backward() + t[2] = time_sync() + except Exception: # no backward method + # print(e) # for debug + t[2] = float('nan') + tf += (t[1] - t[0]) * 1000 / n # ms per op forward + tb += (t[2] - t[1]) * 1000 / n # ms per op backward + mem = torch.cuda.memory_reserved() / 1E9 if torch.cuda.is_available() else 0 # (GB) + s_in = tuple(x.shape) if isinstance(x, torch.Tensor) else 'list' + s_out = tuple(y.shape) if isinstance(y, torch.Tensor) else 'list' + p = sum(list(x.numel() for x in m.parameters())) if isinstance(m, nn.Module) else 0 # parameters + print(f'{p:12}{flops:12.4g}{mem:>14.3f}{tf:14.4g}{tb:14.4g}{str(s_in):>24s}{str(s_out):>24s}') + results.append([p, flops, mem, tf, tb, s_in, s_out]) + except Exception as e: + print(e) + results.append(None) + torch.cuda.empty_cache() + return results + + +def is_parallel(model): + # Returns True if model is of type DP or DDP + return type(model) in (nn.parallel.DataParallel, nn.parallel.DistributedDataParallel) + + +def de_parallel(model): + # De-parallelize a model: returns single-GPU model if model is of type DP or DDP + return model.module if is_parallel(model) else model + + +def initialize_weights(model): + for m in model.modules(): + t = type(m) + if t is nn.Conv2d: + pass # nn.init.kaiming_normal_(m.weight, mode='fan_out', nonlinearity='relu') + elif t is nn.BatchNorm2d: + m.eps = 1e-3 + m.momentum = 0.03 + elif t in [nn.Hardswish, nn.LeakyReLU, nn.ReLU, nn.ReLU6, nn.SiLU]: + m.inplace = True + + +def find_modules(model, mclass=nn.Conv2d): + # Finds layer indices matching module class 'mclass' + return [i for i, m in enumerate(model.module_list) if isinstance(m, mclass)] + + +def sparsity(model): + # Return global model sparsity + a, b = 0, 0 + for p in model.parameters(): + a += p.numel() + b += (p == 0).sum() + return b / a + + +def prune(model, amount=0.3): + # Prune model to requested global sparsity + import torch.nn.utils.prune as prune + print('Pruning model... ', end='') + for name, m in model.named_modules(): + if isinstance(m, nn.Conv2d): + prune.l1_unstructured(m, name='weight', amount=amount) # prune + prune.remove(m, 'weight') # make permanent + print(' %.3g global sparsity' % sparsity(model)) + + +def fuse_conv_and_bn(conv, bn): + # Fuse convolution and batchnorm layers https://tehnokv.com/posts/fusing-batchnorm-and-conv/ + fusedconv = nn.Conv2d(conv.in_channels, + conv.out_channels, + kernel_size=conv.kernel_size, + stride=conv.stride, + padding=conv.padding, + groups=conv.groups, + bias=True).requires_grad_(False).to(conv.weight.device) + + # prepare filters + w_conv = conv.weight.clone().view(conv.out_channels, -1) + w_bn = torch.diag(bn.weight.div(torch.sqrt(bn.eps + bn.running_var))) + fusedconv.weight.copy_(torch.mm(w_bn, w_conv).view(fusedconv.weight.shape)) + + # prepare spatial bias + b_conv = torch.zeros(conv.weight.size(0), device=conv.weight.device) if conv.bias is None else conv.bias + b_bn = bn.bias - bn.weight.mul(bn.running_mean).div(torch.sqrt(bn.running_var + bn.eps)) + fusedconv.bias.copy_(torch.mm(w_bn, b_conv.reshape(-1, 1)).reshape(-1) + b_bn) + + return fusedconv + + +def model_info(model, verbose=False, img_size=640): + # Model information. img_size may be int or list, i.e. img_size=640 or img_size=[640, 320] + n_p = sum(x.numel() for x in model.parameters()) # number parameters + n_g = sum(x.numel() for x in model.parameters() if x.requires_grad) # number gradients + if verbose: + print(f"{'layer':>5} {'name':>40} {'gradient':>9} {'parameters':>12} {'shape':>20} {'mu':>10} {'sigma':>10}") + for i, (name, p) in enumerate(model.named_parameters()): + name = name.replace('module_list.', '') + print('%5g %40s %9s %12g %20s %10.3g %10.3g' % + (i, name, p.requires_grad, p.numel(), list(p.shape), p.mean(), p.std())) + + try: # FLOPs + from thop import profile + stride = max(int(model.stride.max()), 32) if hasattr(model, 'stride') else 32 + img = torch.zeros((1, model.yaml.get('ch', 3), stride, stride), device=next(model.parameters()).device) # input + flops = profile(deepcopy(model), inputs=(img,), verbose=False)[0] / 1E9 * 2 # stride GFLOPs + img_size = img_size if isinstance(img_size, list) else [img_size, img_size] # expand if int/float + fs = ', %.1f GFLOPs' % (flops * img_size[0] / stride * img_size[1] / stride) # 640x640 GFLOPs + except (ImportError, Exception): + fs = '' + + LOGGER.info(f"Model Summary: {len(list(model.modules()))} layers, {n_p} parameters, {n_g} gradients{fs}") + + +def scale_img(img, ratio=1.0, same_shape=False, gs=32): # img(16,3,256,416) + # scales img(bs,3,y,x) by ratio constrained to gs-multiple + if ratio == 1.0: + return img + else: + h, w = img.shape[2:] + s = (int(h * ratio), int(w * ratio)) # new size + img = F.interpolate(img, size=s, mode='bilinear', align_corners=False) # resize + if not same_shape: # pad/crop img + h, w = (math.ceil(x * ratio / gs) * gs for x in (h, w)) + return F.pad(img, [0, w - s[1], 0, h - s[0]], value=0.447) # value = imagenet mean + + +def copy_attr(a, b, include=(), exclude=()): + # Copy attributes from b to a, options to only include [...] and to exclude [...] + for k, v in b.__dict__.items(): + if (len(include) and k not in include) or k.startswith('_') or k in exclude: + continue + else: + setattr(a, k, v) + + +class EarlyStopping: + # YOLOv5 simple early stopper + def __init__(self, patience=30): + self.best_fitness = 0.0 # i.e. mAP + self.best_epoch = 0 + self.patience = patience or float('inf') # epochs to wait after fitness stops improving to stop + self.possible_stop = False # possible stop may occur next epoch + + def __call__(self, epoch, fitness): + if fitness >= self.best_fitness: # >= 0 to allow for early zero-fitness stage of training + self.best_epoch = epoch + self.best_fitness = fitness + delta = epoch - self.best_epoch # epochs without improvement + self.possible_stop = delta >= (self.patience - 1) # possible stop may occur next epoch + stop = delta >= self.patience # stop training if patience exceeded + if stop: + LOGGER.info(f'Stopping training early as no improvement observed in last {self.patience} epochs. ' + f'Best results observed at epoch {self.best_epoch}, best model saved as best.pt.\n' + f'To update EarlyStopping(patience={self.patience}) pass a new patience value, ' + f'i.e. `python train.py --patience 300` or use `--patience 0` to disable EarlyStopping.') + return stop + + +class ModelEMA: + """ Updated Exponential Moving Average (EMA) from https://github.com/rwightman/pytorch-image-models + Keeps a moving average of everything in the model state_dict (parameters and buffers) + For EMA details see https://www.tensorflow.org/api_docs/python/tf/train/ExponentialMovingAverage + """ + + def __init__(self, model, decay=0.9999, updates=0): + # Create EMA + self.ema = deepcopy(de_parallel(model)).eval() # FP32 EMA + # if next(model.parameters()).device.type != 'cpu': + # self.ema.half() # FP16 EMA + self.updates = updates # number of EMA updates + self.decay = lambda x: decay * (1 - math.exp(-x / 2000)) # decay exponential ramp (to help early epochs) + for p in self.ema.parameters(): + p.requires_grad_(False) + + def update(self, model): + # Update EMA parameters + with torch.no_grad(): + self.updates += 1 + d = self.decay(self.updates) + + msd = de_parallel(model).state_dict() # model state_dict + for k, v in self.ema.state_dict().items(): + if v.dtype.is_floating_point: + v *= d + v += (1 - d) * msd[k].detach() + + def update_attr(self, model, include=(), exclude=('process_group', 'reducer')): + # Update EMA attributes + copy_attr(self.ema, model, include, exclude) diff --git a/yolov5_Monocular_social_ranging/val.py b/yolov5_Monocular_social_ranging/val.py new file mode 100644 index 0000000..78abbda --- /dev/null +++ b/yolov5_Monocular_social_ranging/val.py @@ -0,0 +1,383 @@ +# YOLOv5 🚀 by Ultralytics, GPL-3.0 license +""" +Validate a trained YOLOv5 model accuracy on a custom dataset + +Usage: + $ python path/to/val.py --weights yolov5s.pt --data coco128.yaml --img 640 + +Usage - formats: + $ python path/to/val.py --weights yolov5s.pt # PyTorch + yolov5s.torchscript # TorchScript + yolov5s.onnx # ONNX Runtime or OpenCV DNN with --dnn + yolov5s.xml # OpenVINO + yolov5s.engine # TensorRT + yolov5s.mlmodel # CoreML (MacOS-only) + yolov5s_saved_model # TensorFlow SavedModel + yolov5s.pb # TensorFlow GraphDef + yolov5s.tflite # TensorFlow Lite + yolov5s_edgetpu.tflite # TensorFlow Edge TPU +""" + +import argparse +import json +import os +import sys +from pathlib import Path +from threading import Thread + +import numpy as np +import torch +from tqdm import tqdm + +FILE = Path(__file__).resolve() +ROOT = FILE.parents[0] # YOLOv5 root directory +if str(ROOT) not in sys.path: + sys.path.append(str(ROOT)) # add ROOT to PATH +ROOT = Path(os.path.relpath(ROOT, Path.cwd())) # relative + +from models.common import DetectMultiBackend +from utils.callbacks import Callbacks +from utils.datasets import create_dataloader +from utils.general import (LOGGER, box_iou, check_dataset, check_img_size, check_requirements, check_yaml, + coco80_to_coco91_class, colorstr, increment_path, non_max_suppression, print_args, + scale_coords, xywh2xyxy, xyxy2xywh) +from utils.metrics import ConfusionMatrix, ap_per_class +from utils.plots import output_to_target, plot_images, plot_val_study +from utils.torch_utils import select_device, time_sync + + +def save_one_txt(predn, save_conf, shape, file): + # Save one txt result + gn = torch.tensor(shape)[[1, 0, 1, 0]] # normalization gain whwh + for *xyxy, conf, cls in predn.tolist(): + xywh = (xyxy2xywh(torch.tensor(xyxy).view(1, 4)) / gn).view(-1).tolist() # normalized xywh + line = (cls, *xywh, conf) if save_conf else (cls, *xywh) # label format + with open(file, 'a') as f: + f.write(('%g ' * len(line)).rstrip() % line + '\n') + + +def save_one_json(predn, jdict, path, class_map): + # Save one JSON result {"image_id": 42, "category_id": 18, "bbox": [258.15, 41.29, 348.26, 243.78], "score": 0.236} + image_id = int(path.stem) if path.stem.isnumeric() else path.stem + box = xyxy2xywh(predn[:, :4]) # xywh + box[:, :2] -= box[:, 2:] / 2 # xy center to top-left corner + for p, b in zip(predn.tolist(), box.tolist()): + jdict.append({'image_id': image_id, + 'category_id': class_map[int(p[5])], + 'bbox': [round(x, 3) for x in b], + 'score': round(p[4], 5)}) + + +def process_batch(detections, labels, iouv): + """ + Return correct predictions matrix. Both sets of boxes are in (x1, y1, x2, y2) format. + Arguments: + detections (Array[N, 6]), x1, y1, x2, y2, conf, class + labels (Array[M, 5]), class, x1, y1, x2, y2 + Returns: + correct (Array[N, 10]), for 10 IoU levels + """ + correct = torch.zeros(detections.shape[0], iouv.shape[0], dtype=torch.bool, device=iouv.device) + iou = box_iou(labels[:, 1:], detections[:, :4]) + x = torch.where((iou >= iouv[0]) & (labels[:, 0:1] == detections[:, 5])) # IoU above threshold and classes match + if x[0].shape[0]: + matches = torch.cat((torch.stack(x, 1), iou[x[0], x[1]][:, None]), 1).cpu().numpy() # [label, detection, iou] + if x[0].shape[0] > 1: + matches = matches[matches[:, 2].argsort()[::-1]] + matches = matches[np.unique(matches[:, 1], return_index=True)[1]] + # matches = matches[matches[:, 2].argsort()[::-1]] + matches = matches[np.unique(matches[:, 0], return_index=True)[1]] + matches = torch.Tensor(matches).to(iouv.device) + correct[matches[:, 1].long()] = matches[:, 2:3] >= iouv + return correct + + +@torch.no_grad() +def run(data, + weights=None, # model.pt path(s) + batch_size=32, # batch size + imgsz=640, # inference size (pixels) + conf_thres=0.001, # confidence threshold + iou_thres=0.6, # NMS IoU threshold + task='val', # train, val, test, speed or study + device='', # cuda device, i.e. 0 or 0,1,2,3 or cpu + workers=8, # max dataloader workers (per RANK in DDP mode) + single_cls=False, # treat as single-class dataset + augment=False, # augmented inference + verbose=False, # verbose output + save_txt=False, # save results to *.txt + save_hybrid=False, # save label+prediction hybrid results to *.txt + save_conf=False, # save confidences in --save-txt labels + save_json=False, # save a COCO-JSON results file + project=ROOT / 'runs/val', # save to project/name + name='exp', # save to project/name + exist_ok=False, # existing project/name ok, do not increment + half=True, # use FP16 half-precision inference + dnn=False, # use OpenCV DNN for ONNX inference + model=None, + dataloader=None, + save_dir=Path(''), + plots=True, + callbacks=Callbacks(), + compute_loss=None, + ): + # Initialize/load model and set device + training = model is not None + if training: # called by train.py + device, pt, jit, engine = next(model.parameters()).device, True, False, False # get model device, PyTorch model + + half &= device.type != 'cpu' # half precision only supported on CUDA + model.half() if half else model.float() + else: # called directly + device = select_device(device, batch_size=batch_size) + + # Directories + save_dir = increment_path(Path(project) / name, exist_ok=exist_ok) # increment run + (save_dir / 'labels' if save_txt else save_dir).mkdir(parents=True, exist_ok=True) # make dir + + # Load model + model = DetectMultiBackend(weights, device=device, dnn=dnn, data=data) + stride, pt, jit, onnx, engine = model.stride, model.pt, model.jit, model.onnx, model.engine + imgsz = check_img_size(imgsz, s=stride) # check image size + half &= (pt or jit or onnx or engine) and device.type != 'cpu' # FP16 supported on limited backends with CUDA + if pt or jit: + model.model.half() if half else model.model.float() + elif engine: + batch_size = model.batch_size + else: + half = False + batch_size = 1 # export.py models default to batch-size 1 + device = torch.device('cpu') + LOGGER.info(f'Forcing --batch-size 1 square inference shape(1,3,{imgsz},{imgsz}) for non-PyTorch backends') + + # Data + data = check_dataset(data) # check + + # Configure + model.eval() + is_coco = isinstance(data.get('val'), str) and data['val'].endswith('coco/val2017.txt') # COCO dataset + nc = 1 if single_cls else int(data['nc']) # number of classes + iouv = torch.linspace(0.5, 0.95, 10).to(device) # iou vector for mAP@0.5:0.95 + niou = iouv.numel() + + # Dataloader + if not training: + model.warmup(imgsz=(1 if pt else batch_size, 3, imgsz, imgsz), half=half) # warmup + pad = 0.0 if task in ('speed', 'benchmark') else 0.5 + rect = False if task == 'benchmark' else pt # square inference for benchmarks + task = task if task in ('train', 'val', 'test') else 'val' # path to train/val/test images + dataloader = create_dataloader(data[task], imgsz, batch_size, stride, single_cls, pad=pad, rect=rect, + workers=workers, prefix=colorstr(f'{task}: '))[0] + + seen = 0 + confusion_matrix = ConfusionMatrix(nc=nc) + names = {k: v for k, v in enumerate(model.names if hasattr(model, 'names') else model.module.names)} + class_map = coco80_to_coco91_class() if is_coco else list(range(1000)) + s = ('%20s' + '%11s' * 6) % ('Class', 'Images', 'Labels', 'P', 'R', 'mAP@.5', 'mAP@.5:.95') + dt, p, r, f1, mp, mr, map50, map = [0.0, 0.0, 0.0], 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 + loss = torch.zeros(3, device=device) + jdict, stats, ap, ap_class = [], [], [], [] + pbar = tqdm(dataloader, desc=s, bar_format='{l_bar}{bar:10}{r_bar}{bar:-10b}') # progress bar + for batch_i, (im, targets, paths, shapes) in enumerate(pbar): + t1 = time_sync() + if pt or jit or engine: + im = im.to(device, non_blocking=True) + targets = targets.to(device) + im = im.half() if half else im.float() # uint8 to fp16/32 + im /= 255 # 0 - 255 to 0.0 - 1.0 + nb, _, height, width = im.shape # batch size, channels, height, width + t2 = time_sync() + dt[0] += t2 - t1 + + # Inference + out, train_out = model(im) if training else model(im, augment=augment, val=True) # inference, loss outputs + dt[1] += time_sync() - t2 + + # Loss + if compute_loss: + loss += compute_loss([x.float() for x in train_out], targets)[1] # box, obj, cls + + # NMS + targets[:, 2:] *= torch.Tensor([width, height, width, height]).to(device) # to pixels + lb = [targets[targets[:, 0] == i, 1:] for i in range(nb)] if save_hybrid else [] # for autolabelling + t3 = time_sync() + out = non_max_suppression(out, conf_thres, iou_thres, labels=lb, multi_label=True, agnostic=single_cls) + dt[2] += time_sync() - t3 + + # Metrics + for si, pred in enumerate(out): + labels = targets[targets[:, 0] == si, 1:] + nl = len(labels) + tcls = labels[:, 0].tolist() if nl else [] # target class + path, shape = Path(paths[si]), shapes[si][0] + seen += 1 + + if len(pred) == 0: + if nl: + stats.append((torch.zeros(0, niou, dtype=torch.bool), torch.Tensor(), torch.Tensor(), tcls)) + continue + + # Predictions + if single_cls: + pred[:, 5] = 0 + predn = pred.clone() + scale_coords(im[si].shape[1:], predn[:, :4], shape, shapes[si][1]) # native-space pred + + # Evaluate + if nl: + tbox = xywh2xyxy(labels[:, 1:5]) # target boxes + scale_coords(im[si].shape[1:], tbox, shape, shapes[si][1]) # native-space labels + labelsn = torch.cat((labels[:, 0:1], tbox), 1) # native-space labels + correct = process_batch(predn, labelsn, iouv) + if plots: + confusion_matrix.process_batch(predn, labelsn) + else: + correct = torch.zeros(pred.shape[0], niou, dtype=torch.bool) + stats.append((correct.cpu(), pred[:, 4].cpu(), pred[:, 5].cpu(), tcls)) # (correct, conf, pcls, tcls) + + # Save/log + if save_txt: + save_one_txt(predn, save_conf, shape, file=save_dir / 'labels' / (path.stem + '.txt')) + if save_json: + save_one_json(predn, jdict, path, class_map) # append to COCO-JSON dictionary + callbacks.run('on_val_image_end', pred, predn, path, names, im[si]) + + # Plot images + if plots and batch_i < 3: + f = save_dir / f'val_batch{batch_i}_labels.jpg' # labels + Thread(target=plot_images, args=(im, targets, paths, f, names), daemon=True).start() + f = save_dir / f'val_batch{batch_i}_pred.jpg' # predictions + Thread(target=plot_images, args=(im, output_to_target(out), paths, f, names), daemon=True).start() + + # Compute metrics + stats = [np.concatenate(x, 0) for x in zip(*stats)] # to numpy + if len(stats) and stats[0].any(): + tp, fp, p, r, f1, ap, ap_class = ap_per_class(*stats, plot=plots, save_dir=save_dir, names=names) + ap50, ap = ap[:, 0], ap.mean(1) # AP@0.5, AP@0.5:0.95 + mp, mr, map50, map = p.mean(), r.mean(), ap50.mean(), ap.mean() + nt = np.bincount(stats[3].astype(np.int64), minlength=nc) # number of targets per class + else: + nt = torch.zeros(1) + + # Print results + pf = '%20s' + '%11i' * 2 + '%11.3g' * 4 # print format + LOGGER.info(pf % ('all', seen, nt.sum(), mp, mr, map50, map)) + + # Print results per class + if (verbose or (nc < 50 and not training)) and nc > 1 and len(stats): + for i, c in enumerate(ap_class): + LOGGER.info(pf % (names[c], seen, nt[c], p[i], r[i], ap50[i], ap[i])) + + # Print speeds + t = tuple(x / seen * 1E3 for x in dt) # speeds per image + if not training: + shape = (batch_size, 3, imgsz, imgsz) + LOGGER.info(f'Speed: %.1fms pre-process, %.1fms inference, %.1fms NMS per image at shape {shape}' % t) + + # Plots + if plots: + confusion_matrix.plot(save_dir=save_dir, names=list(names.values())) + callbacks.run('on_val_end') + + # Save JSON + if save_json and len(jdict): + w = Path(weights[0] if isinstance(weights, list) else weights).stem if weights is not None else '' # weights + anno_json = str(Path(data.get('path', '../coco')) / 'annotations/instances_val2017.json') # annotations json + pred_json = str(save_dir / f"{w}_predictions.json") # predictions json + LOGGER.info(f'\nEvaluating pycocotools mAP... saving {pred_json}...') + with open(pred_json, 'w') as f: + json.dump(jdict, f) + + try: # https://github.com/cocodataset/cocoapi/blob/master/PythonAPI/pycocoEvalDemo.ipynb + check_requirements(['pycocotools']) + from pycocotools.coco import COCO + from pycocotools.cocoeval import COCOeval + + anno = COCO(anno_json) # init annotations api + pred = anno.loadRes(pred_json) # init predictions api + eval = COCOeval(anno, pred, 'bbox') + if is_coco: + eval.params.imgIds = [int(Path(x).stem) for x in dataloader.dataset.img_files] # image IDs to evaluate + eval.evaluate() + eval.accumulate() + eval.summarize() + map, map50 = eval.stats[:2] # update results (mAP@0.5:0.95, mAP@0.5) + except Exception as e: + LOGGER.info(f'pycocotools unable to run: {e}') + + # Return results + model.float() # for training + if not training: + s = f"\n{len(list(save_dir.glob('labels/*.txt')))} labels saved to {save_dir / 'labels'}" if save_txt else '' + LOGGER.info(f"Results saved to {colorstr('bold', save_dir)}{s}") + maps = np.zeros(nc) + map + for i, c in enumerate(ap_class): + maps[c] = ap[i] + return (mp, mr, map50, map, *(loss.cpu() / len(dataloader)).tolist()), maps, t + + +def parse_opt(): + parser = argparse.ArgumentParser() + parser.add_argument('--data', type=str, default=ROOT / 'data/coco128.yaml', help='dataset.yaml path') + parser.add_argument('--weights', nargs='+', type=str, default=ROOT / 'yolov5s.pt', help='model.pt path(s)') + parser.add_argument('--batch-size', type=int, default=32, help='batch size') + parser.add_argument('--imgsz', '--img', '--img-size', type=int, default=640, help='inference size (pixels)') + parser.add_argument('--conf-thres', type=float, default=0.001, help='confidence threshold') + parser.add_argument('--iou-thres', type=float, default=0.6, help='NMS IoU threshold') + parser.add_argument('--task', default='val', help='train, val, test, speed or study') + parser.add_argument('--device', default='', help='cuda device, i.e. 0 or 0,1,2,3 or cpu') + parser.add_argument('--workers', type=int, default=8, help='max dataloader workers (per RANK in DDP mode)') + parser.add_argument('--single-cls', action='store_true', help='treat as single-class dataset') + parser.add_argument('--augment', action='store_true', help='augmented inference') + parser.add_argument('--verbose', action='store_true', help='report mAP by class') + parser.add_argument('--save-txt', action='store_true', help='save results to *.txt') + parser.add_argument('--save-hybrid', action='store_true', help='save label+prediction hybrid results to *.txt') + parser.add_argument('--save-conf', action='store_true', help='save confidences in --save-txt labels') + parser.add_argument('--save-json', action='store_true', help='save a COCO-JSON results file') + parser.add_argument('--project', default=ROOT / 'runs/val', help='save to project/name') + parser.add_argument('--name', default='exp', help='save to project/name') + parser.add_argument('--exist-ok', action='store_true', help='existing project/name ok, do not increment') + parser.add_argument('--half', action='store_true', help='use FP16 half-precision inference') + parser.add_argument('--dnn', action='store_true', help='use OpenCV DNN for ONNX inference') + opt = parser.parse_args() + opt.data = check_yaml(opt.data) # check YAML + opt.save_json |= opt.data.endswith('coco.yaml') + opt.save_txt |= opt.save_hybrid + print_args(FILE.stem, opt) + return opt + + +def main(opt): + check_requirements(requirements=ROOT / 'requirements.txt', exclude=('tensorboard', 'thop')) + + if opt.task in ('train', 'val', 'test'): # run normally + if opt.conf_thres > 0.001: # https://github.com/ultralytics/yolov5/issues/1466 + LOGGER.info(f'WARNING: confidence threshold {opt.conf_thres} >> 0.001 will produce invalid mAP values.') + run(**vars(opt)) + + else: + weights = opt.weights if isinstance(opt.weights, list) else [opt.weights] + opt.half = True # FP16 for fastest results + if opt.task == 'speed': # speed benchmarks + # python val.py --task speed --data coco.yaml --batch 1 --weights yolov5n.pt yolov5s.pt... + opt.conf_thres, opt.iou_thres, opt.save_json = 0.25, 0.45, False + for opt.weights in weights: + run(**vars(opt), plots=False) + + elif opt.task == 'study': # speed vs mAP benchmarks + # python val.py --task study --data coco.yaml --iou 0.7 --weights yolov5n.pt yolov5s.pt... + for opt.weights in weights: + f = f'study_{Path(opt.data).stem}_{Path(opt.weights).stem}.txt' # filename to save to + x, y = list(range(256, 1536 + 128, 128)), [] # x axis (image sizes), y axis + for opt.imgsz in x: # img-size + LOGGER.info(f'\nRunning {f} --imgsz {opt.imgsz}...') + r, _, t = run(**vars(opt), plots=False) + y.append(r + t) # results and times + np.savetxt(f, y, fmt='%10.4g') # save + os.system('zip -r study.zip study_*.txt') + plot_val_study(x=x) # plot + + +if __name__ == "__main__": + opt = parse_opt() + main(opt)

V6XV(eRr}@lW=gNot-W$+6UJt<)wW4F=eykN0Q_ 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�N-A>-~WvsTlepgqO*BM>e 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 kVi?*Z^5X-HeJe5-dOaK4? diff --git a/ultralytics-main/dataset/coco128/labels/train2017.cache b/ultralytics-main/dataset/coco128/labels/train2017.cache deleted file mode 100644 index 5d453a78cbd9cf0d30584869a357e24d35732dd2..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3475 zcmciFTW}Lq7y#gu7APs86)C8o1;GX=WpizU*#u}sCA7uGVxXyUH`#PUbNhEsS^^Xb zLYoSrh=>Kn3wWU-f?AYT1VtR3DKkEJ8J~FY#c>A4;RW9GoD;j7ojf{|%_KAX=bW7V zzjOBAlS9p|P3tz67`hDGYQmxtl53V%*KBX8sjaSwBxNM?iC|I=izK|7k0~OKD-xd) z@wsVHZFNue|2vGmrJ+PRp32mPlCoGAPsdP{mt{U<49a3CnNX0N4k05La;=PsaPC_u z@fr5QgoY9UO8cRVgNY_z$)f)ng;6FY8ex)ug27;Dal+(*Y(JE9Fva96^_Sq-b}%+K zH?R2zAN0fLMNlCOw8PXMm}c@%!cAhlAjTA!-VS$}df;x8e=-h6E0o*E@urTKOTp+k=y*X&JJAw=ov{`~?d)?+#2i)VIh)1OIFr#VCgr>`-eQ>Y8 z6bD22GG|H#iHcN7m}3?PvoVLS)K}66_enX2hz;&14i9iJXWYRJbM+1e1P=-W4O8*Y z;-l9~-tZ8DYJs8%LUN0!z`XI%=9AGL=3qf?w6Z=}D9ssYV2(HLaaS+s^jz(_?arjn zu$M+>dT%YXdGOD+vORzNE19c{; z2(wkMpRHw*I!BD8&W)L9Svat&b7Lb~dTcuahajoK^`wuJ1D7hioC@DLHRS&NX2SF1 zy!mXZ;yinFFegkz4_=VjNMyPft+05mjjg5U@F)VeAYoKiTHGux$x5{n;qerO$EoM> zYCJ16o|PokRU9;^JdK4sk0Dr{$MZPp^8^P^syu5bPx*#l+-+0hBz^W*$5pxjZ~R@a zTY$GWF&d8#!CK1Gq~mEW3Xe{<>}G!>?jJ4MbEQSw%m{_ z&E%Z&>_f1h^1P_yIZzZHtDfg2jpt>J=O9V-6%G!mJg*k=97gb39?ucd=XDMSRi2}i z=g-kL_Ig#!+xHTswyTqED`U*(&ep zKb#)2T4wD$#;$A4mFCLRi`}GD!$$~CQ=X4?JZFl+W7qS1qVb&7c+QbjKjq*vmFM$9 zo?!&%^LV}>eZJ)2g32>Od4$nzl*iY7o4qzR#-1I@@sNEEDb0k3Jjqm^Q3PL6o{M=r zBHbfOyduHZ{uOw;Xm`0>7J+eCdB!FR4xXtGTkIiA#AdPaLWr?Donaf#i-Oq_3c2hq zo72vR1($`fGG@kR5$oX+{eK{f3f}cAaM|QD`V91CMDPtAEv|GZ@NGL>p)I@c|AuHX W0pHPmy}6F5v%=Lh-oAb>)cp&eY=2.6.0 x2paddle -# Fix error: `np.bool` was a deprecated alias for the builtin `bool` segmentation error in Tests -RUN pip install --no-cache numpy==1.23.5 -# Remove exported models -RUN rm -rf tmp - -# Set environment variables -ENV OMP_NUM_THREADS=1 -# Avoid DDP error "MKL_THREADING_LAYER=INTEL is incompatible with libgomp.so.1 library" https://github.com/pytorch/pytorch/issues/37377 -ENV MKL_THREADING_LAYER=GNU - - -# Usage Examples ------------------------------------------------------------------------------------------------------- - -# Build and Push -# t=ultralytics/ultralytics:latest && sudo docker build -f docker/Dockerfile -t $t . && sudo docker push $t - -# Pull and Run with access to all GPUs -# t=ultralytics/ultralytics:latest && sudo docker pull $t && sudo docker run -it --ipc=host --gpus all $t - -# Pull and Run with access to GPUs 2 and 3 (inside container CUDA devices will appear as 0 and 1) -# t=ultralytics/ultralytics:latest && sudo docker pull $t && sudo docker run -it --ipc=host --gpus '"device=2,3"' $t - -# Pull and Run with local directory access -# t=ultralytics/ultralytics:latest && sudo docker pull $t && sudo docker run -it --ipc=host --gpus all -v "$(pwd)"/datasets:/usr/src/datasets $t - -# Kill all -# sudo docker kill $(sudo docker ps -q) - -# Kill all image-based -# sudo docker kill $(sudo docker ps -qa --filter ancestor=ultralytics/ultralytics:latest) - -# DockerHub tag update -# t=ultralytics/ultralytics:latest tnew=ultralytics/ultralytics:v6.2 && sudo docker pull $t && sudo docker tag $t $tnew && sudo docker push $tnew - -# Clean up -# sudo docker system prune -a --volumes - -# Update Ubuntu drivers -# https://www.maketecheasier.com/install-nvidia-drivers-ubuntu/ - -# DDP test -# python -m torch.distributed.run --nproc_per_node 2 --master_port 1 train.py --epochs 3 - -# GCP VM from Image -# docker.io/ultralytics/ultralytics:latest diff --git a/ultralytics-main/docker/Dockerfile-arm64 b/ultralytics-main/docker/Dockerfile-arm64 deleted file mode 100644 index e9ab84c..0000000 --- a/ultralytics-main/docker/Dockerfile-arm64 +++ /dev/null @@ -1,51 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# Builds ultralytics/ultralytics:latest-arm64 image on DockerHub https://hub.docker.com/r/ultralytics/ultralytics -# Image is aarch64-compatible for Apple M1, M2, M3, Raspberry Pi and other ARM architectures - -# Start FROM Ubuntu image https://hub.docker.com/_/ubuntu with "FROM arm64v8/ubuntu:22.04" (deprecated) -# Start FROM Debian image for arm64v8 https://hub.docker.com/r/arm64v8/debian (new) -FROM arm64v8/debian:bookworm-slim - -# Downloads to user config dir -ADD https://github.com/ultralytics/assets/releases/download/v0.0.0/Arial.ttf \ - https://github.com/ultralytics/assets/releases/download/v0.0.0/Arial.Unicode.ttf \ - /root/.config/Ultralytics/ - -# Install linux packages -# g++ required to build 'tflite_support' and 'lap' packages, libusb-1.0-0 required for 'tflite_support' package -# cmake and build-essential is needed to build onnxsim when exporting to tflite -RUN apt update \ - && apt install --no-install-recommends -y python3-pip git zip curl htop gcc libgl1 libglib2.0-0 libpython3-dev gnupg g++ libusb-1.0-0 build-essential - -# Create working directory -WORKDIR /usr/src/ultralytics - -# Copy contents -# COPY . /usr/src/ultralytics # git permission issues inside container -RUN git clone https://github.com/ultralytics/ultralytics -b main /usr/src/ultralytics -ADD https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8n.pt /usr/src/ultralytics/ - -# Remove python3.11/EXTERNALLY-MANAGED to avoid 'externally-managed-environment' issue, Debian 12 Bookworm error -RUN rm -rf /usr/lib/python3.11/EXTERNALLY-MANAGED - -# Install pip packages -RUN python3 -m pip install --upgrade pip wheel -RUN pip install --no-cache -e ".[export]" - -# Creates a symbolic link to make 'python' point to 'python3' -RUN ln -sf /usr/bin/python3 /usr/bin/python - - -# Usage Examples ------------------------------------------------------------------------------------------------------- - -# Build and Push -# t=ultralytics/ultralytics:latest-arm64 && sudo docker build --platform linux/arm64 -f docker/Dockerfile-arm64 -t $t . && sudo docker push $t - -# Run -# t=ultralytics/ultralytics:latest-arm64 && sudo docker run -it --ipc=host $t - -# Pull and Run -# t=ultralytics/ultralytics:latest-arm64 && sudo docker pull $t && sudo docker run -it --ipc=host $t - -# Pull and Run with local volume mounted -# t=ultralytics/ultralytics:latest-arm64 && sudo docker pull $t && sudo docker run -it --ipc=host -v "$(pwd)"/datasets:/usr/src/datasets $t diff --git a/ultralytics-main/docker/Dockerfile-conda b/ultralytics-main/docker/Dockerfile-conda deleted file mode 100644 index 30d4ce1..0000000 --- a/ultralytics-main/docker/Dockerfile-conda +++ /dev/null @@ -1,40 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# Builds ultralytics/ultralytics:latest-conda image on DockerHub https://hub.docker.com/r/ultralytics/ultralytics -# Image is optimized for Ultralytics Anaconda (https://anaconda.org/conda-forge/ultralytics) installation and usage - -# Start FROM miniconda3 image https://hub.docker.com/r/continuumio/miniconda3 -FROM continuumio/miniconda3:latest - -# Downloads to user config dir -ADD https://github.com/ultralytics/assets/releases/download/v0.0.0/Arial.ttf \ - https://github.com/ultralytics/assets/releases/download/v0.0.0/Arial.Unicode.ttf \ - /root/.config/Ultralytics/ - -# Install linux packages -RUN apt update \ - && apt install --no-install-recommends -y libgl1 - -# Copy contents -ADD https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8n.pt . - -# Install conda packages -# mkl required to fix 'OSError: libmkl_intel_lp64.so.2: cannot open shared object file: No such file or directory' -RUN conda config --set solver libmamba && \ - conda install pytorch torchvision pytorch-cuda=11.8 -c pytorch -c nvidia && \ - conda install -c conda-forge ultralytics mkl - # conda install -c pytorch -c nvidia -c conda-forge pytorch torchvision pytorch-cuda=11.8 ultralytics mkl - - -# Usage Examples ------------------------------------------------------------------------------------------------------- - -# Build and Push -# t=ultralytics/ultralytics:latest-conda && sudo docker build -f docker/Dockerfile-cpu -t $t . && sudo docker push $t - -# Run -# t=ultralytics/ultralytics:latest-conda && sudo docker run -it --ipc=host $t - -# Pull and Run -# t=ultralytics/ultralytics:latest-conda && sudo docker pull $t && sudo docker run -it --ipc=host $t - -# Pull and Run with local volume mounted -# t=ultralytics/ultralytics:latest-conda && sudo docker pull $t && sudo docker run -it --ipc=host -v "$(pwd)"/datasets:/usr/src/datasets $t diff --git a/ultralytics-main/docker/Dockerfile-cpu b/ultralytics-main/docker/Dockerfile-cpu deleted file mode 100644 index f829ebf..0000000 --- a/ultralytics-main/docker/Dockerfile-cpu +++ /dev/null @@ -1,57 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# Builds ultralytics/ultralytics:latest-cpu image on DockerHub https://hub.docker.com/r/ultralytics/ultralytics -# Image is CPU-optimized for ONNX, OpenVINO and PyTorch YOLOv8 deployments - -# Start FROM Ubuntu image https://hub.docker.com/_/ubuntu -FROM ubuntu:23.10 - -# Downloads to user config dir -ADD https://github.com/ultralytics/assets/releases/download/v0.0.0/Arial.ttf \ - https://github.com/ultralytics/assets/releases/download/v0.0.0/Arial.Unicode.ttf \ - /root/.config/Ultralytics/ - -# Install linux packages -# g++ required to build 'tflite_support' and 'lap' packages, libusb-1.0-0 required for 'tflite_support' package -RUN apt update \ - && apt install --no-install-recommends -y python3-pip git zip curl htop libgl1 libglib2.0-0 libpython3-dev gnupg g++ libusb-1.0-0 - -# Create working directory -WORKDIR /usr/src/ultralytics - -# Copy contents -# COPY . /usr/src/ultralytics # git permission issues inside container -RUN git clone https://github.com/ultralytics/ultralytics -b main /usr/src/ultralytics -ADD https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8n.pt /usr/src/ultralytics/ - -# Remove python3.11/EXTERNALLY-MANAGED or use 'pip install --break-system-packages' avoid 'externally-managed-environment' Ubuntu nightly error -RUN rm -rf /usr/lib/python3.11/EXTERNALLY-MANAGED - -# Install pip packages -RUN python3 -m pip install --upgrade pip wheel -RUN pip install --no-cache -e ".[export]" --extra-index-url https://download.pytorch.org/whl/cpu - -# Run exports to AutoInstall packages -RUN yolo export model=tmp/yolov8n.pt format=edgetpu imgsz=32 -RUN yolo export model=tmp/yolov8n.pt format=ncnn imgsz=32 -# Requires <= Python 3.10, bug with paddlepaddle==2.5.0 https://github.com/PaddlePaddle/X2Paddle/issues/991 -# RUN pip install --no-cache paddlepaddle>=2.6.0 x2paddle -# Remove exported models -RUN rm -rf tmp - -# Creates a symbolic link to make 'python' point to 'python3' -RUN ln -sf /usr/bin/python3 /usr/bin/python - - -# Usage Examples ------------------------------------------------------------------------------------------------------- - -# Build and Push -# t=ultralytics/ultralytics:latest-cpu && sudo docker build -f docker/Dockerfile-cpu -t $t . && sudo docker push $t - -# Run -# t=ultralytics/ultralytics:latest-cpu && sudo docker run -it --ipc=host --name NAME $t - -# Pull and Run -# t=ultralytics/ultralytics:latest-cpu && sudo docker pull $t && sudo docker run -it --ipc=host --name NAME $t - -# Pull and Run with local volume mounted -# t=ultralytics/ultralytics:latest-cpu && sudo docker pull $t && sudo docker run -it --ipc=host -v "$(pwd)"/datasets:/usr/src/datasets $t diff --git a/ultralytics-main/docker/Dockerfile-jetson b/ultralytics-main/docker/Dockerfile-jetson deleted file mode 100644 index 6528628..0000000 --- a/ultralytics-main/docker/Dockerfile-jetson +++ /dev/null @@ -1,50 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# Builds ultralytics/ultralytics:jetson image on DockerHub https://hub.docker.com/r/ultralytics/ultralytics -# Supports JetPack for YOLOv8 on Jetson Nano, TX1/TX2, Xavier NX, AGX Xavier, AGX Orin, and Orin NX - -# Start FROM https://catalog.ngc.nvidia.com/orgs/nvidia/containers/l4t-pytorch -FROM nvcr.io/nvidia/l4t-pytorch:r35.2.1-pth2.0-py3 - -# Downloads to user config dir -ADD https://github.com/ultralytics/assets/releases/download/v0.0.0/Arial.ttf \ - https://github.com/ultralytics/assets/releases/download/v0.0.0/Arial.Unicode.ttf \ - /root/.config/Ultralytics/ - -# Install linux packages -# g++ required to build 'tflite_support' and 'lap' packages, libusb-1.0-0 required for 'tflite_support' package -RUN apt update \ - && apt install --no-install-recommends -y gcc git zip curl htop libgl1 libglib2.0-0 libpython3-dev gnupg g++ libusb-1.0-0 - -# Create working directory -WORKDIR /usr/src/ultralytics - -# Copy contents -# COPY . /usr/src/ultralytics # git permission issues inside container -RUN git clone https://github.com/ultralytics/ultralytics -b main /usr/src/ultralytics -ADD https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8n.pt /usr/src/ultralytics/ - -# Remove opencv-python from Ultralytics dependencies as it conflicts with opencv-python installed in base image -RUN grep -v "opencv-python" pyproject.toml > temp.toml && mv temp.toml pyproject.toml - -# Install pip packages manually for TensorRT compatibility https://github.com/NVIDIA/TensorRT/issues/2567 -RUN python3 -m pip install --upgrade pip wheel -RUN pip install --no-cache tqdm matplotlib pyyaml psutil pandas onnx "numpy==1.23" -RUN pip install --no-cache -e . - -# Set environment variables -ENV OMP_NUM_THREADS=1 - - -# Usage Examples ------------------------------------------------------------------------------------------------------- - -# Build and Push -# t=ultralytics/ultralytics:latest-jetson && sudo docker build --platform linux/arm64 -f docker/Dockerfile-jetson -t $t . && sudo docker push $t - -# Run -# t=ultralytics/ultralytics:latest-jetson && sudo docker run -it --ipc=host $t - -# Pull and Run -# t=ultralytics/ultralytics:latest-jetson && sudo docker pull $t && sudo docker run -it --ipc=host $t - -# Pull and Run with NVIDIA runtime -# t=ultralytics/ultralytics:latest-jetson && sudo docker pull $t && sudo docker run -it --ipc=host --runtime=nvidia $t diff --git a/ultralytics-main/docker/Dockerfile-python b/ultralytics-main/docker/Dockerfile-python deleted file mode 100644 index 8423dbb..0000000 --- a/ultralytics-main/docker/Dockerfile-python +++ /dev/null @@ -1,54 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# Builds ultralytics/ultralytics:latest-cpu image on DockerHub https://hub.docker.com/r/ultralytics/ultralytics -# Image is CPU-optimized for ONNX, OpenVINO and PyTorch YOLOv8 deployments - -# Use the official Python 3.10 slim-bookworm as base image -FROM python:3.10-slim-bookworm - -# Downloads to user config dir -ADD https://github.com/ultralytics/assets/releases/download/v0.0.0/Arial.ttf \ - https://github.com/ultralytics/assets/releases/download/v0.0.0/Arial.Unicode.ttf \ - /root/.config/Ultralytics/ - -# Install linux packages -# g++ required to build 'tflite_support' and 'lap' packages, libusb-1.0-0 required for 'tflite_support' package -RUN apt update \ - && apt install --no-install-recommends -y python3-pip git zip curl htop libgl1 libglib2.0-0 libpython3-dev gnupg g++ libusb-1.0-0 - -# Create working directory -WORKDIR /usr/src/ultralytics - -# Copy contents -# COPY . /usr/src/ultralytics # git permission issues inside container -RUN git clone https://github.com/ultralytics/ultralytics -b main /usr/src/ultralytics -ADD https://github.com/ultralytics/assets/releases/download/v8.1.0/yolov8n.pt /usr/src/ultralytics/ - -# Remove python3.11/EXTERNALLY-MANAGED or use 'pip install --break-system-packages' avoid 'externally-managed-environment' Ubuntu nightly error -# RUN rm -rf /usr/lib/python3.11/EXTERNALLY-MANAGED - -# Install pip packages -RUN python3 -m pip install --upgrade pip wheel -RUN pip install --no-cache -e ".[export]" --extra-index-url https://download.pytorch.org/whl/cpu - -# Run exports to AutoInstall packages -RUN yolo export model=tmp/yolov8n.pt format=edgetpu imgsz=32 -RUN yolo export model=tmp/yolov8n.pt format=ncnn imgsz=32 -# Requires <= Python 3.10, bug with paddlepaddle==2.5.0 https://github.com/PaddlePaddle/X2Paddle/issues/991 -RUN pip install --no-cache paddlepaddle>=2.6.0 x2paddle -# Remove exported models -RUN rm -rf tmp - - -# Usage Examples ------------------------------------------------------------------------------------------------------- - -# Build and Push -# t=ultralytics/ultralytics:latest-python && sudo docker build -f docker/Dockerfile-python -t $t . && sudo docker push $t - -# Run -# t=ultralytics/ultralytics:latest-python && sudo docker run -it --ipc=host $t - -# Pull and Run -# t=ultralytics/ultralytics:latest-python && sudo docker pull $t && sudo docker run -it --ipc=host $t - -# Pull and Run with local volume mounted -# t=ultralytics/ultralytics:latest-python && sudo docker pull $t && sudo docker run -it --ipc=host -v "$(pwd)"/datasets:/usr/src/datasets $t diff --git a/ultralytics-main/docker/Dockerfile-runner b/ultralytics-main/docker/Dockerfile-runner deleted file mode 100644 index c0f8659..0000000 --- a/ultralytics-main/docker/Dockerfile-runner +++ /dev/null @@ -1,38 +0,0 @@ -# Ultralytics YOLO 🚀, AGPL-3.0 license -# Builds GitHub actions CI runner image for deployment to DockerHub https://hub.docker.com/r/ultralytics/ultralytics -# Image is CUDA-optimized for YOLOv8 single/multi-GPU training and inference tests - -# Start FROM Ultralytics GPU image -FROM ultralytics/ultralytics:latest - -# Set the working directory -WORKDIR /actions-runner - -# Download and unpack the latest runner from https://github.com/actions/runner -RUN FILENAME=actions-runner-linux-x64-2.309.0.tar.gz && \ - curl -o $FILENAME -L https://github.com/actions/runner/releases/download/v2.309.0/$FILENAME && \ - tar xzf $FILENAME && \ - rm $FILENAME - -# Install runner dependencies -ENV RUNNER_ALLOW_RUNASROOT=1 -ENV DEBIAN_FRONTEND=noninteractive -RUN ./bin/installdependencies.sh && \ - apt-get -y install libicu-dev - -# Inline ENTRYPOINT command to configure and start runner with default TOKEN and NAME -ENTRYPOINT sh -c './config.sh --url https://github.com/ultralytics/ultralytics \ - --token ${GITHUB_RUNNER_TOKEN:-TOKEN} \ - --name ${GITHUB_RUNNER_NAME:-NAME} \ - --labels gpu-latest \ - --replace && \ - ./run.sh' - - -# Usage Examples ------------------------------------------------------------------------------------------------------- - -# Build and Push -# t=ultralytics/ultralytics:latest-runner && sudo docker build -f docker/Dockerfile-runner -t $t . && sudo docker push $t - -# Pull and Run in detached mode with access to GPUs 0 and 1 -# t=ultralytics/ultralytics:latest-runner && sudo docker run -d -e GITHUB_RUNNER_TOKEN=TOKEN -e GITHUB_RUNNER_NAME=NAME --ipc=host --gpus '"device=0,1"' $t diff --git a/ultralytics-main/docs/README.md b/ultralytics-main/docs/README.md deleted file mode 100644 index 954e130..0000000 --- a/ultralytics-main/docs/README.md +++ /dev/null @@ -1,140 +0,0 @@ -
- - -# 📚 Ultralytics Docs - -Ultralytics Docs are the gateway to understanding and utilizing our cutting-edge machine learning tools. These documents are deployed to [https://docs.ultralytics.com](https://docs.ultralytics.com) for your convenience. - -[![pages-build-deployment](https://github.com/ultralytics/docs/actions/workflows/pages/pages-build-deployment/badge.svg)](https://github.com/ultralytics/docs/actions/workflows/pages/pages-build-deployment) [![Check Broken links](https://github.com/ultralytics/docs/actions/workflows/links.yml/badge.svg)](https://github.com/ultralytics/docs/actions/workflows/links.yml) [![Check Domains](https://github.com/ultralytics/docs/actions/workflows/check_domains.yml/badge.svg)](https://github.com/ultralytics/docs/actions/workflows/check_domains.yml) [![Ultralytics Actions](https://github.com/ultralytics/docs/actions/workflows/format.yml/badge.svg)](https://github.com/ultralytics/docs/actions/workflows/format.yml) Discord - -## 🛠️ Installation - -[![PyPI version](https://badge.fury.io/py/ultralytics.svg)](https://badge.fury.io/py/ultralytics) [![Downloads](https://static.pepy.tech/badge/ultralytics)](https://pepy.tech/project/ultralytics) - -To install the ultralytics package in developer mode, ensure you have Git and Python 3 installed on your system. Then, follow these steps: - -1. Clone the ultralytics repository to your local machine using Git: - - ```bash - git clone https://github.com/ultralytics/ultralytics.git - ``` - -2. Navigate to the cloned repository's root directory: - - ```bash - cd ultralytics - ``` - -3. Install the package in developer mode using pip (or pip3 for Python 3): - - ```bash - pip install -e '.[dev]' - ``` - -- This command installs the ultralytics package along with all development dependencies, allowing you to modify the package code and have the changes immediately reflected in your Python environment. - -## 🚀 Building and Serving Locally - -The `mkdocs serve` command builds and serves a local version of your MkDocs documentation, ideal for development and testing: - -```bash -mkdocs serve -``` - -- #### Command Breakdown: - - - `mkdocs` is the main MkDocs command-line interface. - - `serve` is the subcommand to build and locally serve your documentation. - -- 🧐 Note: - - - Grasp changes to the docs in real-time as `mkdocs serve` supports live reloading. - - To stop the local server, press `CTRL+C`. - -## 🌍 Building and Serving Multi-Language - -Supporting multi-language documentation? Follow these steps: - -1. Stage all new language \*.md files with Git: - - ```bash - git add docs/**/*.md -f - ``` - -2. Build all languages to the `/site` folder, ensuring relevant root-level files are present: - - ```bash - # Clear existing /site directory - rm -rf site - - # Loop through each language config file and build - mkdocs build -f docs/mkdocs.yml - for file in docs/mkdocs_*.yml; do - echo "Building MkDocs site with $file" - mkdocs build -f "$file" - done - ``` - -3. To preview your site, initiate a simple HTTP server: - - ```bash - cd site - python -m http.server - # Open in your preferred browser - ``` - -- 🖥️ Access the live site at `http://localhost:8000`. - -## 📤 Deploying Your Documentation Site - -Choose a hosting provider and deployment method for your MkDocs documentation: - -- Configure `mkdocs.yml` with deployment settings. -- Use `mkdocs deploy` to build and deploy your site. - -* ### GitHub Pages Deployment Example: - ```bash - mkdocs gh-deploy - ``` - -- Update the "Custom domain" in your repository's settings for a personalized URL. - -![196814117-fc16e711-d2be-4722-9536-b7c6d78fd167](https://user-images.githubusercontent.com/26833433/210150206-9e86dcd7-10af-43e4-9eb2-9518b3799eac.png) - -- For detailed deployment guidance, consult the [MkDocs documentation](https://www.mkdocs.org/user-guide/deploying-your-docs/). - -## 💡 Contribute - -We cherish the community's input as it drives Ultralytics open-source initiatives. Dive into the [Contributing Guide](https://docs.ultralytics.com/help/contributing) and share your thoughts via our [Survey](https://ultralytics.com/survey?utm_source=github&utm_medium=social&utm_campaign=Survey). A heartfelt thank you 🙏 to each contributor! - - - -![Ultralytics open-source contributors](https://github.com/ultralytics/assets/raw/main/im/image-contributors.png) - -## 📜 License - -Ultralytics presents two licensing options: - -- **AGPL-3.0 License**: Perfect for academia and open collaboration. Details are in the [LICENSE](https://github.com/ultralytics/ultralytics/blob/main/LICENSE) file. -- **Enterprise License**: Tailored for commercial usage, offering a seamless blend of Ultralytics technology in your products. Learn more at [Ultralytics Licensing](https://ultralytics.com/license). - -## ✉️ Contact - -For bug reports and feature requests, navigate to [GitHub Issues](https://github.com/ultralytics/docs/issues). Engage with peers and the Ultralytics team on [Discord](https://ultralytics.com/discord) for enriching conversations! - -
-

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 z zh~)Lp{{UK^nw)d5401bXrAex3aazUZ#XN@~e5@3XneH?C)+M#y+HTAeTSbKc?f~cc z)%!+|3OysLw1p>qkA%IGa~D*8BI!8*mvMoKx)lM`;8B3Smb~)(zgFaMCN}1Ch{mpu~=* zUAQM1#T?+`j;(c_I{Fb13_??o(=P?#DH!>H0l<8Kf6w!z5Jc!cU8Lk?c*SNU avRhq8BvKGn);#B`lhFP=)Tt9|pa0o=2-L>_ diff --git a/ultralytics-main/dataset/coco128/images/train2017/image_BS1_465_00_42_16.jpg b/ultralytics-main/dataset/coco128/images/train2017/image_BS1_465_00_42_16.jpg deleted file mode 100644 index bea513aa1d210d45ecf1407b3d5c26bf5ea232fd..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 234158 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%0D{T> z(f%6JA3*rt^LUEc=0cjDnH*NvuwxlzVhn6Z$-zye@Nf?wQ+xvbvVUir{79#!#%i*Js(C zbf;5UacGhb!L8_==7{iMICEO=B4F)a?x3PueZ)qTK9JO0YwNjFJx=k%7{@ zT6wKGH)ucW1TPKAl)vhhTxq>Yv;dpbqE#;Y>L68Xl z0C-~@g{q!!LLD#ZfASKHt+(WP0ny`*b8~2tTTR|uLQtOk_L)2-V!mRBNanVb%eSi`MUZ^Mk&sB^xU7jGv5Q!fQlH_j znFf^Xi)!~5Goxg0-WYkMSf7-E^5dRcij|$<+OuDf-5Qpf7`Ag zi0)z)Hx^-@G1ocmT-U_wFN7W|n%6;#_HVJ(uO_;R6R4+%B)3~~@3hGr%D!PM)PauQ zH#}5x48ErKUvWIO;{eh>cMKLZ@i@Ymuk{-p$GG22?}(oTd9pS!suA4RWhkNyg8`y<`o{{X^2@h8B( zFz~j!5%MlHty4%_cwwI;d2Mr%12#eVk=S4!c*T3}m!$kT*V4lKNVT|{%I4BLmb$UJ zj$pB{C4eC9ETmw9LC7`TSBS9~NT}lDbpHUFDc|OE{YL?ae&&zKwEpAadH(=!zuHsb z#ri?J&p2YbwMtGc^@sT~XNAVo zUgb}dU#cD9Z`zjQ$2R_Ffj%@?YZDQHQ;>V&_UpR)zf5r;c8J*jh!=Z9~BS01muysZTh= zO=014V9Z81d2UQB7oNO|&G6oxVew;7lf?f37rqVXHmKN5nu{g<%c#x+uui<5IRiWs z*0`;A<4=w5BsTUob{6;`KKoxax}0F}2jyJ+nx~I7kkH&}^N5+Z6a=dE&j+{XUwWjbI{|xcsS(>lje#`(74d#()T$Ve+c-N$ruCPwrzYNe`6SF zBz8E?0$>{NlfyIHz%9kt;do&AAbmgmb)R{lt)eqYfBV8d^9*Iahp##OtIU;}(9@E~ zEq4fj`E$5j4nQL{CAHU-yC7E}bRJ^=04ip$r=XCB*8XsyukODy>FxMdF|&%^Z2h!I zJ%{tG`ECjZ)$Xlvx5`ObL0s+N=BYjP);6jFInMrSIAzk~BYoca2pwIZ4TO!i2J)W67xiMkb9v7z{pb8>N)|?0pBLM z-v(G~b`gzVRj~_e6YXT)$O?dSy#D|R&q3b1mGQeQaXglWG?qs(wY+=s7zRwrN6G^5 z21en@+;Lx@=6K9jBBR#m)q6W?%N`u?{{W1PPkjKjw2Co-wZL=N_jph?jEs+Q_#T5u z@YcJ1s84&XYjPI4mF2r#(mr<+f`AMsCy)Ud$jIifG{1;Ix5mr1Ysq1&P5yyWByN41?E$t+Bg{Jb{Wk@@SW48l6w*?!HeqRu# z-l<&PE-7fv;=@Fa%UD*`^+ua5<_UuzG_sGpU7G{1AY}aB)qZ*4ohE=@+8~x8`xRkW0~~W+WlTL?>}wgt?9P);)O3jMqP4Z%nL(5oNkt4$ zg(%*DXM@n3^{YB@m2QRO>Q@28U=~w{+moDy3P=ru!3DQ-(+4WkS4Oj2IrP|~kqatb zT-~aZ)T)ei1Z93)91cf0uCK#3J{7ksulSF|mbTJ@L^578?Pn?u!5JY70!PdVEr0>) zE6uG5M{`)k$>>dCqw5z&X)k1Do9AKs#@gx$87xQM!O2m9o(Doq7a9%i_OBb>M3B9j zLnIdvmJ&(B?nYJtS7|Ch%Y8>m=qB+ViD35-TKK<5P0{(c7VmV(>ls6a*^=Q-K7^B2 zG?vw`?N;AG(&xIjix%*rM9iDMWe5`(f0pwH4BAX@cc;qI zj!crWNtDTTBh2S$`FOzTfzqnKi#3a)*FGoFn*JE(3vO;0G;b+pD&P`uaKormkVh+m zdYwV1xCbm%9#}lWSJm(upaHE3511-tNV_5p#kBTm!n^A*PjM~b=BoWL0tbjun z-GyP!atZ2kM?vP)mEMTWxgoY%t;dP(&Y7!QqQhuVqM21Ts_tdZF~MNFdVqTh-MZBi z#BCTChA7#*(Gx~o#VX`uj(+hx91fi0uPI`p@+->?EJrFvjSQE?-^yqCgl-dXVZc2I z2OQ@Wzv1b$t8Wjbos2q!;h2fr+Cy?r%olQi1~JdRYtOApZQM0z%h#`Di&vLd zn^lhDOPJXI0Hax|qhuqEgewp}@y1Ccf^)W;2C=W)z`AZElGZ)%9mLR}b&$5+2ywvs z+2rxkw=L!Pe3vD)t!CTIwr6LF)o?nUxFaJ2pv`aiV@0snEZ0=BvIx7G5#R@K3fLQo z90EpgeMdrQPmz1bhZb>qa=g)T*E&SObzdInQ2C zrx=&IUzqdgiG0zNlXQ^Gp_qY&+(82*5_le!GOsCUM6@nTsY9>WL2DeCMgg*6P~cujAoRxridzZ19eHsr#kQ$vE}N-Yclm9(Pu<|-7zE=Sjw?@3@Wz{UfA)J_a^m8D zG({7%pp=y1l|rryADD51PJZut#%gyoROKSJhv8i_Rk&&HU})o3*#r5E3WeNL10->i z!Ou@h+_%zneF>gBtMyw}AP+tQKpWJSB}R8(aBy*udt$fsZwYv>OIWT3lIv&2E?)!9 zI2i4f=YV_q*OUI!UlDYlhk6C|-l^hC5pf-)k*JXi1dQWxAY}C9b|ho9MjkkfMP*HE za;Hn#!tER%?VbBacsJqSf=-R$D`bmMy_3pySy)ORfJWSq69swB4p?J?YtO%APuZ+X zs;9-T9!01&r#qIDQMZlU#vPz^`F67~z(Ppi0CEN^&AtSDGrs+&el=Wp>%{WoNwu8G z0G0Oz01upr2HbFPJ+Z(Uuh8uWNbu%`;d?6wl}u(3VVcSyzDQ!(Y%^rwjielN&szHo zeQI1if>=6E^(FB?UWWpNtIL~f9HbXorkW$)XZ9(inne>qBM_wYkfVPH+(E}byyrYp zUEXVUuu7K~Q9N=Yx?&*PWLyHuK@6q4gOSe|B-8v)eQ5+TM)IA|4mZyp6oG=cO~*fX z?+`&4?kk7Xd}P<`ZFJDAA(}x0lq6$uzod-lrAh<~ zHMYUDl_7&1li2poO7!64D@M{M@aCNy$)+?RWC{hWLF8D~7^`7H;OgTbpdtoC;D zU21wshGdZ7h~ybidTwk6;DhKzTe8>eo+BFSaVheFOrMwn4j7E{!1nv5m&?<&3Eb&d zFkDA89Tb%a5tm|=AQS$vha){XAPiy8a-*s(=q;tRrrmC(GDox%y_*CD0ANio(5xbYpg+|%YNs)sA#uZLRM;w20p%FzUl=d;-tTMY5nnZFL3E&ma0N`V& z=sNLS#G>hS88r5_lH%tofyBh+iEe#BBpx~*)pX+JFCj^*Zb7f!==7; zvWUo>oM6YlEE|*=2N^gxz^u7uOPh!m`BvZ=vGU4x@`b}5gy$pv`t~&?wC#0r_H*3a z`7XGHa*>V3PSQvQ8+OnDVa___R_>c@^IDkvxs(_kkX-G!34k_{g4<8=5u6I|=24A| zl$#sjyC^O1md@(HNp2W0Hv@Ee!Q?O;jt5Uqde_uu(X^yUWYVo~z)vn8E_4ibu^?`4 z3C?g2Uu+Xo$z}_EqSzUe%K;&lG3GYyt+;If{G^aGpS$_x>K-MY(qRUdq(;wkADjVL zm4Rm`a1#&+ZM=iX+;-=R#xhsFrnazHU#TPQoZQ${wC95hye{+0}^C$O8#K31f z0K<~G$jGed?|ea`qy3>RuA6x?&mFKY6lAHuWx+rSjvH|~!RlCPc)R;UP$OA;%XkYo z+iEhBIms%A1dI|$#&8JduQgY|{sz?=JIlM~H=9WE(@>Hq9k}YMQCNZl5&=DXaa(iJ z{&iN7Tq~26AdSb8r-98_z47L^ZKke~;te9k z874a-oo@BwpP>JpJb9 z7!__E0(fVWOoK(a`%TQs&mFuw6#U!PVyZTEV#gTZ5_qlQEIW_s+jW5EN zz9T;ot{TeTBlcKLsZS|479<^+1d_QV<7%AsCbGU4_|o#vz|encYBy3`%7bO#f!Sd~ z2vuJ!i5L(@cx>d7R2&EX+WsEXJQ46m?F*q_e`$#we8{BFmQ-@i8TTqFBY+CzV1QU= zUx8j4(mX}*+fLTvxRMzWO9^!gvJ|^Vg$@o!_sCFj#&AimS*l;zinO#&R@r`p#mP>{ z?exzaN2S=sp+%wHY8N|6YpHV}kAOxpFrz&&=bhq0}@6(G5FSJj&#f24@+3& zNM=@Ps^ z8m{gX$n5cjkEtYl!y^K+{8i#T55<2EwT}bp7WYj0mX|%by0{R?$n2sulPK)cI4&gq zEbd~&{Oer{_#ac(Vu7^1TH8yW;uc$fv_#p7m^beT$py|q0fsxB!#U=BUEte263AU@ zmoi?;h!$(u-F(ZFkQK?pE=gneRA3OGUi+_L-!3m%vsxmb%Q1b>aO+C|cgxq_cKwn;6y^ zhnN(zyorS>#DqIapP7GN!{Okv%tc7ODq3Eb*YIa`97H8b?OMmq9xJlZwEGl-)k=BR ziz`gX`@)leeqgxC<8K+k&wAm!n=LZ!jl8Ogcu2gmhJN`uVsptIyHvVo#kAFu={5Zr z+4+*lEE+46GfMza!bw&%U5*0*g$@@P-bvxUG4Th6@AUb#yS--CDD0wA(8D-pjocCg zAkOE9;5%QdTwF@|Yvv z2c>b>I_Hj_R(qcjT10@2utlX?@CUz_k`E^pRzDc(U)lk!fR;8><+*}LQGqRh8OO{x z2P1=#&2<{*ho!#KS5wl2bD7C8mK{g0uczl((x9wp$#H9O519qJoQ(Xv zzYf*T_^J_cd!|U!$UoCr0p-0afw=#eaOn(s1Q%~2W zx0!Uw(bs9zfm8Ljo7TNLHI&i8R+Fa6I)Ur zyUfYQ0~OC}7GM%22P3dG-%Xe&bCtV-K)d!K{`VDE&t(NXv4PW%{=I7IRr@b}}-)eYSHtr>W{&WEi)}FDSmCpmz zR8Ykr{ot5>b$Vxv$Fzb$K4#l(7=8zgG6p?)FLF2T5{{SkMWlNh@OMt~l#uxtptyOpKUC^*$=}4Dl zn_*GUTy~@a*~xg4eTI10sQ&;}BMfd|uc+@MqNGxG zHsIGm$ayo5#mQMxHj zqtSHF8eNd7aNw{XD-T-fv@eJgK%V0KApav z^~qBS33N7vX{WjGdS{KMRo<5*sN-g9sn9+q-dcdGGbjMy1Jj!Mx5IuU*0i0?sb9V1 zB>w5hRAlSjM?JqP>@0k7Z7f3@(D%%l2E4lYa+gE0mN6!MCE@=7j4~|Aw@`fN@2Ort z3iST~1$=Tse5chI;~cT%SH@OeE7R6IUEN5o4tGb$t(_O*1%<1qhgFfl=myp!{{SAZ zCbm(1zazFd$n`$l*YwYXzZi7ZvG{}G>kUVE#CH+^B~NvcPUSz1cxT1m_$D5Y;wyP| zPlaA8K-)=%$5WH$93B=?*XYByTH?Gf@rc=6i5JBN1?owOoB0B3)%*whN5&l>zVTcV zE^v3pAUO5NQ&>}$WtYF*$=kJ^hbZB38p_{(r^MeCz5)DO_$jKTuZ;X7s93ynX4ds% zV4$hUWRW-rBOrsGGh6-#{j+``=$4D%{{V|H+j#dwGGa>~5kw@oi3uCLyMi}o8NhJk zpJ9*Dj}Caxz+V!y=`>AO#5yjaYb<}hvAzYBhoMJL>FZuU@vr^~Tku!nX`5d7QQ{j< z4r+3rFxh`;X39p#U`Av7GC4d~M6*o07ieRt+4on|^+nUe)}`-ImY>(jpE2Ed6ZSp$ z@P==OUl3;SM~J15FX8VJ0``+iRDS9ifB{B$Q`3`>IIk7>x%(=7S@=VDCHIVUCYH=D z_;p($=G&FY+QM9Xr-FMNXWqNNjeoI^#ovRvjnjvoU0R}_?ne3852BDd`qynL6;wH}wN+Slmj3`J zzusk8)04GWS@&P%x78I>QP{p$>WV^=P@ggzF`@G5!*S_UbgTUNyzyrIK_@(<1d_(ZIlQ)fi z6>7GAH1PaU`GZpM{mgR|LJkCo8zF`;!xKYU%vfAHU>dfyfgL4vrPIdxONRw-19@W1u zjx4-IX>H;uwCgLoJx)pBYt1>Knkf{0M=kVZ52fUm)=2gQCX@NLb}(6uS8 z#l~a5vzHRVFawpA2h45`e~ELzHT6I2%l`lcarlq$zev%39{gMIwx6u{Q%#L6l5H}` zL33voRAmr;?Z5!!5DCEfm#us@Wx&|%JRI=NR7STP59%%9?-gpgmZB|D z>~yQma(F{H8%gsb47ebZv4~b+GI7Yr_(%I(d>Q!n;7FwKXT%*gDMZ1b(vsxIaBxXO zBtV8%U^yJ%^&s(GuBE4F)|ZPUa9v!yfn)O{pD_YHU;_|aI307?^fmC)jch$`TCwG8 zrH`SEsn>@!HkvriBg0xV+ebf!wMhhWTnKJ$Y-XBB#Nl^ImU!epA>1-Z;lZO$+P1W&^51*BP)TXEB4DH(pvcA# z0P&n2wIz+L5hCikb&M?c63aADz{wK^@6+)-bJW)}sTH)D(G=vq75V-*M~?hw{gplh zd~)#p<=4e8hB?w6F*@8ut3AETI-V7wRoT0eH+32J$oc2uKl~Gi#QqhAYmeCP;|9O* z=Sa1HInt-s?xBW99RM-819wtD!xC~0eW~LY@b8E`JsyQ~X&uGtfp9eC)LRmR%0HXF zG7d*g8_!+UYu9#9d0p>c;4qBa=kEoh5e)t^|zA?4eEp!jb_w^#jwu=9uaV z%A>bwYQE=mXI~A5n_Tg`^55^@@jeFqnm^#6KOVnk`|VfZx9ySe-{MD(Ej;+`taY0O zh2gevnEOAOGeZ=ZXHS_6Fxo)`j(uy!AGYs-HC<}j(@F6zrKH*1TA4LJ3{7m!aj0oT zO0qWH!4_1L$#t4CuA#8ohZXfL=fX`acsg$t&EiNcW4!|Y=HL5HW?wc$-IEAngRfk2 zPET`Qd*Hu^ehBdz>R0*)!z(xvSXy+tn@#=R_ZTxqqB2GS!?OEiV3S;#tnitPok~>s zW&PIDzoo7B7}CT07&NLrUYA#E?`i%gn18`7eh=P!HPU=h@I&K&if;T@r+9N*xrx)c-DtGk>14InOB|R?9UK&|&aZpx=dXRgt&hf2@gQ5s!fSXJ zfK~p~7<1@x&;I~gmA)j~OK!$p$QTeMgy#ml&0y3*=0*#Ty5Yi zWCmV)asG2((Mqh5@=~4mI=yekD8S7X?2okXY1bGd7wsV~KU60(%Hof%lXngcG6=52lzIh z)}_0S)*oX9rKAQwIY?i)Ny$HrIg%FI(eEIRGXDV6twS12BoV=E$0ur%!=It8ODzKO zS$xUEs;&gq4HTu!PP zv-^+~_3l`GIv>Kd^u0erwMLihtuQ~ryRvY4kO>?N^fj{`!!OM6O&mZ2l|p`A{{VOl zkUjaYI}wX%H55aak$Xz;Yg;@Q6HfmCXB$MHyj}7xKp{y79eVrMb>RI^L(+=szh|{q z$Cn27R~+yIXMvn_$UF{fk<#_KZ;ISP5VWhhCYH>G^yKb1>70%Zdsd{3mtnN+YfiR` z26Wpa!7er(;YliTIpCg12Q~8ex|ORoq$MVGHoA&yTC&9zvR+0Rqq&yYumQZaZh7Ef zj&gIHao=Z0hTBDxVi0X(fZn~aw})YTG29gsadtVvuQ!L$Q+N>D z#{-C4Yhg@-hTKY=lbrtmwVrC_r-`N1bhxZyc~@ZA={36`M!;egW>O{VgSCjyJair< zT5?Z8ws#Th@-6Z3=BcaP*u*sSc%`+vO|lrd|h%S8~rJXCt9fLpLWl!*DQbFT=V$l+zT}OQ;Z-<1wK$UD;#7{-SXhGLONLyo3*s~A*gl!A3C1yd1CuoT5H-u~Dm!g+PKqXb zyN8N-AY986uJl$6cLxU`sMrQ@Fu>OR&bQ$GV^)j9{t&yC)>cU^+xt#7bTNi=cub*5*{su)5V%q z-IVswS~5Xns;gQHNTZ1V0IWL$%`kS`%iy-txZ~yWtH-VEX&SA&9i6B4=9hk9)Nk~Q zh7a~jC}g+tW0{sSF!IES9_e-ylC6P;7&}cjPw`%@b$t!(#g3zD@ksXb#d9KA${!^j zMg#qzHV}CZ2;!jdexIyr9v`&R*G7@v3T0qLof$d5z9k-Ch%7wrOkZXn*dbQ`t2=h15 zYxx>FwIkH^D;cgY^m*1DAMI16w1~Q{s;Jp@$&H-=VIyuTa2Zq#;O7F55d3D;ybE&v zG4W=#r}%HfHt>0HCZVX0B0GZ?azf^8><{xQkV~JK5Vi7W#6S2buZy2TeG}n-g{-WJ zWH4*Glm=_qLMo~Vk%?3zU}9ON4BVbLub#YL;@=qjNYzh>Jagg;{aW#}w(9=q%Od3D zfwz?l48`SCWV4%@%GW&LPm@ikM?v+bW9{{X>JJ`r3)d7!9somTWK1Gp{M9K78zj}Pc=?$n2yicoRgllIK&mmg3@T*J$Ff zyKTU*WmUmeDwz#}3F1C8UzeJH?VbBk=~mI&S$tEzcw%g&yx^FRBdW)@ImQo7!2H?Z zjo%6W-v0o#4~MT`QhU!2>MJB7H@DR^`DBZ3_F~&sW%iLNKu@W*y1B~^%4 zU@^7+ZjI4f-nVrf7f z+xu82y1&a^AYVg;^JzHDR2Z_8bcX4%LC8&F| ze{A-W#&*f`%L|RjG6v9d_gLfQ8TtHvS(xBjc#2LJ(Oo-!MvAl|uNQNz_=)>Wd|miy z@Z0Pc{{Rzh?`*7X*`~VIJUCu>w)uF7G?E`VfeZ_O5h0Y|jC^ygc>_kJtV>@g%G}P=z5pK&j9!@;f9ue9Z#d)+1$e+f@hL% zFVBr*X&vMFvJ-5Q4aA1RbB&_9eKIA3N}f$SK%QtW_eXOT{qTsnT&V}kVYHAlybO_w zuj2h1#%W<@WSZYlvQ%5Z3Z!xtL{`YmtOK8zV;x3v0p_fFgu1jJ+Sid6W{fn#AW}Kp zZQUu|jjbjD!yK-0k^y7#b@8#sNz|0C-um1UaaswfTwLmFFWVz)Mwp2uj(HkQ-zaXq za#caxbDg=`F`CiP{1xI2LK|z@ygPp!O#2Cz)PUfOtE++cPV8r4O*nntgVNE z0D-gvy#D}n=a!?VDB7K_HL0jHJ$Bi|w+>b)E#sXo7>~R1;P7%Wp2PWOw`}yiV*5u} z?5@SIo&c~sP{)*ClOO98j)08gfX&|+=QS^ipAj^;ptaQWO+M0T;WueC){VAEhQdUD zF~J+gM)Jx?%8pHF_(#UxB#Pw)!>xHlcJ^k_K1lXS24x4qfjtI6T==yLxMBVk}1YL7eq#TH~>Ua3lssDoT$oyf(YQ} zu{`yzd&NH%wY%sorSPA@YpB|3e7l8ROOn70g!7auoz09F2OREQ7bdf9rl{$p{37Mh-gf8vck?=#5* z!y=L8%_|m7y;yF>az1g#91hio;t90*r)&A;zn%B_OuyOkKbX67xv+D$<|Ci3FzC`tgaVk0|y6j;BDswW6-0QwHv7``7@ewixH}wx>!>_)-tSUi;z12K~caR4s+JH_&zXvHn&*dpTx;!c^rG$LEMO{ z*d!h0umEm*6+MMbs`&3w)NUZK)@~nUaw5le0S>BuZcRYL6PK|c?R>M(ETz0AB@3CHgWoVYD@;PjSC@p{p3>1tU?P13l z2d{1a0Ee?{QM9mXxNFmPneHtHyAHO`_duH+E3LcI4enWU@w^SYZg=zj17VjB&unO7-aBYtJlkdfD7cP*XkTHQ149 ztS=yRKkF>*onubLfMz)ZJxRgI!Os0$M2Dyz-VZ$IU<#%Twu>%94Znf!p&%-s;b?K$M zv9*ERsJPUlNaOn?epy|v%b8EgxLD#=ZWQARTyef6_-}m$m8Kh&oCjoMN3OMR@5`4xMloLmuC8nEyt;c(*wagcn5u&Y}moDC3)C@MV z;aPE!@)D$}VSsXdOToH+pC^Ron^c=@777boO*R6fbGe-Spnf0^%DnSV_+h3EOzJv} z#z|ozr587HsAtNO{{SO}B#=&69PT`fklx$yvp|Af6~51_%8YJ0tff`X4tY=tk(J~g z_4T|tkG^1{r1ekG&WvQ`sl#fTTx_i-n`V+A;yHuo9sBj;^UYvi>2tPPXh$u=s~iA* zeGj#J4z=Me4t4uS+V4OE2%=H7v)2Kac|N4$9qW|T{5_>a3414rnTZTo=N$h4g?_U} zr!-Nl;&6w<@yi%30&N`fNXHe*>$1sZs%hF4-LOTQQI1#$n6UuIBCzNEreDsz8&sCj z8|=2%4I1O_lv~42zy-Cv^4M)SlX4t&?ieY^uTKqD(m1gc?uc&m z$G2dxJ0^RU?OEEDoyIaH+%e8@ax1UZEx?b=WyVJt9V?&IBaa2nNY4Wzy~=aGr;*Ck zjwe@&c)?A)_BGAw*7Lh(<me*+A$kFhmCNeZp?-MOjCM8K33DNw=xd$E zGqavLVwN|SHwh}C2cgXucLoMyI7aK7lGQ|beC{KZ3k zsoupB-L0++ExE8k%Jd`h=kTQ$DC##T+&YZYqr2ObQNag;L)Z&3%N5!N3^y?T8bF~= z*Wlx=SFqU}e`Ev&Q;7NKJ9YM}6GI_g>e&Ojnm{&T&gjV}za43tmDmuydgK~Kn+FWp z&w6fUSwT(#ALpe2PaI=8h>_Eb@l#+h21xm+BAB7Xj81*(N0%dhJ9ix^=)jmr>w~nF z_U53yScw-9QMGx=u2{9)r09>+4dI=lAxq_xXyNR=G0VxwGZLQq<2a9g2`~ zjt()3YonACB&4wF4KTdNkVih z+2NO?Q-VhmZVul}^{H_~xvy(?I%jj_W0f7vT(s6jqXrR>GxtYo#e-2*+CM-l%H2aV zaUlercUE(RS_JHMmU`4p7;zvV`&IZGPI-LCh$|oBRynRB-bS@>7V8R6BL|A!(zOVr zMP;~BIuZ%ux#bR1MJCRbk>-tB7IA}|jMFVO%~rxpEz67^s?^Os<^sD`;Af_HR)T4^ z(xG%J{l24V@>oRLa=HF*>6nQ#XrlU%rrzXyp{lu@lbReEmepP+sX`1SDH z;!Ua~*EZ}~3hlV=4^ha$9C8hD{{S0*W8Z{Ee3Kw6E(XGNID#^Jbr$0;=kFq#X42D_V>eWN-r4b$~PO$8A~;wC+^P^ zeDM*-CxUa+74?V4zxXF7ihL}ssQfPR9-XgRY%(pKQQ+6 z;RlEs-%!!@Jr_|?i2->bE;G=MjJ$L?>Fr+560Qds9&9CF`*r^Slhq!6B9V((h5pmiBwKsPfB=7YYw_IjJ7&3$ z8GIS=&Xo&Y_zTCjTD7gqnPJnXc8c;KPYUYF19ZlHz4_|9`@^5c?-O`V`$M@{F7(@*TagTR z5v|3!Tp<}pT!F`-uTS_z`+k1Ye+q2i@bum^eP2VhASRir+sAPp(%YPFky+55c~TBo zp1jw>W;_Kbw=5j*7xrK1{{YP%-WxxXR<9fR^*>dt{{U)_fL<+?t*tf9L9f2j6>M4? zzn$0+6;9BuFirqDBxf0@^xuu11MqTd8vVAN29Ru}kWBLkM-xF3BgcSWZ`?WsM@bAXohZ^8<+w!fsvn# zd@=iEe0=yl6gn5}1>pYx>>Vb1;}!m*o)Ws$5?I2B*g)`2g1@^TBPk@7Id#CVq`nRR z0KrGUX6<*w@MxY2*RM5;d2Q8}%fen9xR_g~B3G4SjI=TQ%fqM(p1&{^#f`~vSV;3y zr_CPe^Dn^~P{*m&wO7jfHD~yq(QmF?>3YS=Lt}KBg@%^PX>A-*M`>}%EUwtt9DoFF zN!nZZgKacC8RH9^-w*1Vhl8}M9aB?^Y9<1VnGv+IZ7c=}W?lg~1C65_z<(Wn z9r){7z3_&e@Q1`c9*4sg&2t;;8gg`>M1lU~&PNvl{~X)<-$5Q%1K(XdoyxO}j|EUdp^>94DJs?T21eie9Q zP15y?^_ueQ#hQkc?H-(xBgkZUkZx#L0r!~z4y?QaDc%n7&&2I|&gw6ZzaG2~sAyV- zn+#e$iQ$h7PYuM_0Lg12HQU7{ylTorxGg7{f)prI>}A-h`D5mc`B!a!D>VLRE+Uk1 z7K@KJ3}|JO7|+UiAkwwW0!_s;llPxEq>||rWKK}H z$SQI(_!4XMw%geFE8MayRv5NO+>w)qBB6Ub7@SKj_aEKfGx`dmFXys7>! z90IW~QcEl3pQqzcqKQ(}UNgUeQ`h7I!d%RyG2^q`F8j?@(5_!i%TnEKZg`c&*!v_Pxzq8)C;%HQE2THlJmLxn9 z3Yp!>&f$cM9I43z75Wi#a4%QOisOUSv}}K<6`818+C~)5a2zWft0q4h>4r;}^WJf7 zcDptH&Wl<*AB-OtU-sUsr8n%(-dCs5U%~IYr4~^b!%EZBj)e1)7rA7+Z zgzB1%S_3p%z2rK4q@B@S+zWPRC!QZ`5=cF|=D(om{=sxadU(sJ`Mk101M5@CrOBwH zS=~)6iHtl_lE9Bb4+g%I30nn(hb<~;FC#aVO8)>C;D0;u-C1fx%LUp_0r`w_?;n__ z6pX0ZX6^5v=bHWO@fYly`!@LLC9v^l?BC!$Xv)M$+K+-X`Pq(o?r3*s-#M-q#UJoX zpV&uNcD2;MXHO1kb0Xy+@c#hXH0c-UEhda7%WLU;EBJm_Ph}2nqQ3c4Wk>h-x|+8dUgA7xCipC zFI@isgMYpa%8WcS`%?JY(a0>n+PXHIc&q5RiaTxxu5xR2jl(~*bIUHot&#bDWtm)M z_VO~@y3+ab50!~HJwdO%{9pe72LAy3P_>Yc1Af+C7Swlii(2qy)}9n#<1Y=>&Q5Xs zAIiMj#DDNaAKSAaTV25Bw7A{t5}tJUDmY#xCTuRSkmuR zkFrB{(jJ|53iD4D{>=XXwC96dw~N1KkBJ&eAwF#PUk~*`8ensoga$9iaTL_4&uK5b z#nGDHCq5OGfOl+hg3Z>OG^s8~E4#J<=il4%tgG2Av~5TG8(P0xJMhFEJ5XV7ai4gk z+W!EhSw~PdV+Z)L&{A~Rtm0TM*y7Pt?#}I}KEA{BIHXu%d_BsS?gmZ=y;pYte(EB` z9*Wo;{&n;}>=XMa_k${@1w8pN8cVmnvRoNS#u`ld3P{BLf{JY+TkFjEO-+BqA3QbR^|kCwizu<-2qW$ad$I=$K} zX5L7y1IrO(<$_dv`*Xjd?E`N>7d4zT&k}eKN0Y*LfevGmG?k?JM*YWd>IgZ&&3X2> z@Z-dHI-2V~AMo`;+*jf`QB1|~!F@vBZ3avG-6~rfhh5WKDUvoLU@9C10OC|57$MFNO6WW_ zV{ze~ZS{*^5WLnFu-r{3mK4IFi7?~<-dGusvga9zG1P-g#E@uqI+Pl3h-I4Qg9%5WT-nqTGJi` z)O4xNxd=;ik}~uCoT8z|@)#&%jedffbA!T#*5~n#klon7kkW_=;t$Ck`yg_NH z>v!5*nv2akIyaqj6tUp>m<+Ocdsu=~a8dG}dSg4`sn(v0PsHb(k~X|`X|1%9+W2o) zw6%tKTH$Zyj9nXf#E5sq4isez@O|_^~|=*u4*skM;wHO zg^(Z)yIhgHk_>-)J9lK-c#BcKjyWRMX1A4~&B%MQS~&vXkn()aMmQ`xC?dPPFT~oS zSxGjtZwPQ!Lvs_Wd8kW~gpINo6v*7TARK1BW%Y^?rjUc6*|_G0P*5Fkab6t9PStJ>2TYt}oZtPjKWY144C$uR!{*A)d!XWYEMkJ`jF>1@o=Dgb z0AH6GJ;@dD=ZtmhzZPn5uV3EpX8>TwjjB2TF~{N3zfItt5~+!Y)^Q1_bX`npO+69o zc7L_S?)I{iMu*Cfk>o+S6-QMFPD+Kq1Jn#2xvy^c7yDjV-Q6aWbFUzD1dB_w3L7eT z42lli4pjF3EZ4*q6Rb0Dk-$JR)33d3X&Ri-%Cki)fRDLfIOHBVuhDVbDVJh!?h%cj zaxW#R`g5=Nul^Fx4Bbm@;Je*N%G0F#Jkx5+ZQmx^t%cQaf|aicGv zExIWv!dHxhU8kZBKqH~ebees?#*YfRG#U6W!$kbWBvaCoGu5s1Ph)P`$mBpCY2r3 z5y(8jcV(zZkw}HzgfXOvmfQ-R*bc$FXOE|jVTW}6$bJ6+@GK}sN$N+W_}k*IgqF+; zIK+P-N#l}Pl67TJ?o)AQEJGu+2pEoL&zLzys;Zip>;?kmq=-zmSGjo|s zEH4VGNAj@3jGUglk;Xkmdym0i2;D=VO)^fF7PH#3+ZkC(f-oBn0on=cp5Wsd=fyOO zyIHionvK?yrdx$cBoUxiZ0!m&kaAn@o=GFUeJh}7?Q7v%O*>cABLU)df-75+WN|81n)Vy(3rMa4yppqQ`9n$aZsU*wjy}2i*D3Kn%FZ7M z-ZZwX$1COSU;$w2a(T%-9=Sf)=DX=ue9FfydU0@PJlFPjD}*KS!8kpCD#X==qqbmG zW7}yJ(daho{h2Gr7$!F$l{wF+^sKA9#7WuY!)KBQYWiF}^hbeFS={CB?IM*(bH{PJ zrD1CJN)*PiqhRsQb6w+0=ASW8V0On^itkUhx{u73+8p=&-zV{}Mw_{Vnn#Z6HYk!3 z6FhgU%cwRIqAZ@oSFl)kQpZ>E9gdE4=o#-W76^pE1T5?oK|Ke|M>W0UzuDUJ!!aZ3 z+6I>zvO9*3@dwJ7EOK82ASYsZYM>Q~HVii-KITh)? zBlsVErot{uQ>dB#jh$1^GKmFOsH0e*vB=XNP?xzVSyH zPF)$uN?zLGCM$#|YZgD3`S+_LNEnvfdRD#ffv?^MjneWER1hV#Z}6^rOovlbBzLe# z9^T=hnRXq!f#CGW$ib}L8KY>|r#+c->|$izCIWUc#leAGN34z(T>WQ}NAAo7u-0$4naNuD%;y z+GPI#YeK+tpDc|306MOo3)GeOCDpqRP~>OyspM#-I6aw@BFcw$2**xpL~l0*j!5l} zm8`xL)-Vz{;eOZ>f&A(l?+19C0`}T!ZUd*9pW~V=%2STlGp2?Y1qjA^?^r}iGjd5 z&raCQB^eiVSs=k7Ey{LknO+GKa8eV zb!G`05(gv>l%2+1WNoDF1cUO^Rze69MoApw^u~FvdDC{#r6bXNKdV3(%{ngjU%sOR*8CSRPMd@M?@`vg z;>%SFDziR0A9VDtlT6iuD0aBW&#iG)Qd=4;9eu5&Cx{#ZdVRFd^r<)eXx4dBNTb0geXK#(Gxg_CLbU8d<-GJZY!tej&2L zvf1C;I)!ZV1gcl&Jqu?%pGx`LL-8+(d?h(q&h#W?gTNn3?|dEcBSq9-&1UkY&Pw@X zYq$Gez5f6z`P^PlQk&OJYffi<0zurNuCC~ zK-lGso?sw;2Y@T)UyXmV$HotWQfJ1#96x490X022yx0#T_<+iD&@dc|{SEkY;~$3F zn_GB$T=5yw?`|6?*LJVAR{#Qt>I&ny1cToKyNizo>jCa9^r&qv;kfw%M{pRrFFdIr zkU`GebDVQo;j_%s11?Iho-3o@@BaXY6T%Yy0#I%gi$jj8x&!CI7S{gWixO~S^;XmugJ7IXc_82Nh*z#N~(zfL|R zf5AUK5`0*+I*fi1m&3Oy%$kmnvD=J=&P+sYe_Z1yJ!|EUjKA*-#dS~Tj@<(g89`J9~2FSAF`o(KN`g0Or?vGAmR6!Evi9}C=|l*pR3mXw0* zv%bN;KoLCkCX3u^dDSSZl8ZPojTszmNG|{Mu;+%_XqIJ zcs00p32tmF_Hy$5Q#+~S>nQTg-F81q{3qdG_$aT1z8&g1ewpHL4*1_i)1r>sN4fsg zx6`#LV_}Au_e&zkP?h;)!TDHiH~{(Ahdw&|Iq=r47sF55`$F+6c#g|gF0uH5lFArv zr4b0`6T}iFL`)yO(nrYTf%A96&)c8l&w}*N>|yZ|;OU?OzC`9Zpo zoSOB$Q})mJ0r89B)u+Qx9{6>Pmaw!|@c5261TCMJdfYH78I_LUMJW^lF7AJfTjerMk-n`Qpnl5Av za(G~(oRYI{yHkD&?!) zO~m_#KJHKX_NH4yJdcRpJf5357|72*;aXA&?X84sxqulgqbGxmXSGD6g3M}KrdRDV zDLCZ_IQ%){uUkPOc*Jmp48Q^yah|;X6`vTn^7k8QTjs+ZzW)6^xT`T*-&{DF8&+Zo z44~wkk59(Ar#4xyX=My>190ytJBUUZ$>;#aJNK=Kbjv4+M6tjF1>}cTUNP69`e4?5 zt&;|h?(TUaC9=_ZU9bq}ABRrWw+-Y%+}uY1ZKNMFb_nVZ93SqEyyx1us#IuCV@AVB zj^Y*&Ku8?MHxf@H`@=uyCb#sBI@Q%cmKeOEFtW{p2**|L>6+zW@niW8u{b2I9AJ*Q z86eijhP*lAzZ2?^=o$}!^*v7d;RLpJT5g>+#L}*Dxl%POK+oR61F0gs>eFl@r6*)| zR(h6^q={K}%-H!DM%f(p7|;0C==@V)(FN1)R!MP_6p{o7jFEyv6YXBn@K^o`XYtd= ztq!5_A6u~SMV50U6Ur}j2Of(AN6SEcUQok7cD~H`C;tEh=>3-d56Nw-&)}H+RjNU_ zuBYQM75e45$JvZx+W_*VqGv75kNgr}K(Mri_x6tXmb%r*RV}0VYA1%- z8z8VZGN_h8#^049AZHEf_4U@N49bzqsN0~7ZB>fG6bhhV02VQTJq872YknuR(jaMD z?2{aPzGbwG$Bw}rS3cOqN~K0W7N@C4E`&8|>`w#y7x-E5R>W!l01P}KqiD!t3naR9 z3e(KJgtNBkWjucyv8x)#ige8?2`0Od05n^G@fE!zmA^l)#im_LoSt}&6Y1)E z*P-d29M>|+(RF9f zOc#50#~^WvYJ5)kn`bLtSa=@SSGOZ5bl(vx%yZC%xQg9dp16GDrg~DrZ>wouA$>aM6Mk43sQ+Y}Z29TZ&fOm-_q4+DGjV4~#rY-W3{#rKIZ+p%*?M)NQ4+xl$B6 zC`S2YDx?$S}R2i*!|-Slg~`o&-XqI@h8TAjM_w+CXsb-ZKdDa z-RfQ;Xab99p-YvHD4n@^oZNIAA}2hsTKdP~{{Vw6G>cy;Zq`*$0DLex`hGQ)dhw*v zMv$Qy!tDrjOQ(bYj1D>Aj32F1mr1;maS|gJ-GE$UABnE=C@q3)OPp;St0ptvvo$?3 z8P-OECk(*m;iTYw1w=7YF_j3TpHB{6G)L_csuBLkKh~wR(d?p7*JKhp;c!~7SXx~! zp99@mtPWEf4Z)LVpez6c;~B>Q5OO z_>KPn1w;LhJZtf*{tBh8HPxP-r0Dv$gtR?lQr42~EzxX&n$e_VG?;s%_Ew2ea2!J( z0+Pm~CC`;CU0GM3xT4?O(ZiVFXF5t&)cM!;B>juLRr^tD7hWaSWSdFwj+HxG-|IzJ z_qT#Ib+n8U4)UxRwg>|Xa99!bx5e#W!CwnJHo6_1=8+AipJuv#ouydmNdrUnaGA`K zNc-5X(u@X3UUG6rRekXL;lJ#a;5#eNhnEpUY2o2<6cR1lN+dG6$s;jumU&s?R|KmP zsezCHuZX@W_?yJv9ejB-@Ckmzx2(o!;#FoOV7UqhBn)$$04wIJVsYG8naaH9%Z7)- zt#7~0{{X;8jVQu`<+i7wdim z@@aJ0bzKfixZM=Ai39l|3051kBQeRsjD7X^t|iPdcWMfaA5`GFvF+` z7!ccX$*}`75KATtXQ^T{T-<&Z_=_8+qME!~ZnG3Io4Y$mrL%-6xFo1kB!}k-u$+=o zNYLSi;F`CJv|GlqxYnYU8LsUe?yY5lB?%}}HimPM!NZUlINYQ=2FdwY)2a5Q&HZ{C z^CWJ;@gG^T(Jl0w4-r~kszP0FKe8Gp5t$gGIxCTb76R>5&Qy$3rk4KzR)W^c^2Vjblea# zDdEw}%RF(dyf+0(OBe)@%D{2^=|DIm=K!1@DM_np5Zjvw zuC)s{mI9MowYJo|jZB3WNY&aoPwz4Y;fBcsa%->I#o60aC!w9FTk3M^>*6m9-9a=l z0WuA!QFo@v6L{U08(F&WWX3Q?H6K!+SJ9@^wL2KDeE8dKou$Z$)+4erEMTAjs}aB> z{a6Hoz*aW5tZA)pn~3L$*gR$#Y*IJmENFrHG!!3lS{q}r0XfELhrd&^3aBkFiHT}jWUNVkUJFz zJk@(Y2%bNJrdq3Jt6Q$N`j&3CB;MTT7zqk?0DS`k0>O zT6>!?WPtf(5hAoi=V_a35DF-6Z~@1BV+v}`Yvg(J=9AN5`VEA-gIhzWYA{D_l~q=- zGBw4)GBXry*;68cf)oXA2MTMe(7Yjk6{Wq@cEaatw1~G?B*h{5@`Vt5iy&;CcdyJ3 zrB_SKZ5lPyHIEA2>IUD+SFy6T3oH_t{`Ogdg$*YqxC6cvlBeRfl>%Doa(p_}w7ciC z%00Y(e6u41wC_bxDsBODxF|bDbF>~Rp4wjwbpE``j9O;28efj|y-765wFs?k-bVQ} z%`{0O1NRsi2qjdvRvZJ8PBM11Jsw$YrPVYGxy-ttYl$V*cFcxNs-&vz`A-d=dCBBf zbQZUIo%3r;;k(IJBA`H*(jn>(%!>Ho!N?%=$;dSjz1FpX7LTQBiKal&vzX;~FEH7) z-C2I`8*(=P008<|4N8)dv9wc6>tea^--D!EAMAw^n72!G*OCJpk}#;QdTl2e`9M_| zVo4rp@yFwTfV=_W*Ou>DYk7Q(JQp+hf>y=}BViZ=Z%mwwXB7{`y?epF57RFt)x1rp z`NGZ5*~F3+TnwuzZJ7fnfJrAk@K3^j9KJQ{pAj{`>=|`AC9<FAO<(z($j`gOct zx`{KK4bhSXA-$2DG!gARfazG#-ndetSAM|b+t>VR{)>AQa(VL17-zpdKb?09m+uffHTeyPM_yB_6O{Ht@xW-@NDwWsCjyHS8O#KFYK0@Ng*%2 z=kpL58X^G~Y;CQx{7N!zh_Ey&RxJ5N1=oIkfoz1jnAB)2^#ju*@=lCwI17#+L1E}x?KF6m>t@iwh-0>70q>UV6g zCnZQ5vJ0uf8;NWTZXley!ha1qJUb?o97`z_xY9N*nTi!rqjkAIB?h>4WHsMIX>yyvoc%;={SUazh{XbK&QqtzC z_&34wUf+0^PVoKp>9vF;nvK?tG-y$XAPJ-j3S)0VcwF<5oDF;8M};&y8^|8$EwpwD z9^M#L5qR23lz|%#zj?A0XBc2B$NXbw@mEl|fp7d5X$7Qm;LU$3G_eUKMsl8NNwJyA zlO7IO54u4$x8To%deQL7(mY=dt2Ui|Br<9C+I(=?Tw5PE%*vSdDvkS{_hWG!1;*Oy zrI%5J6zbLaUhn*jr8vDKxw4S>bX(ltSZW%UuYYrJDF&q1b-w#9F%PjrMmBE#{&2h>$S@_h=ne`H=Do3=sHmFK;@)rF z+(Tu19C0MX79k5ffrMmALZhAAP%|t67! z?WVP;U%+Cu)efLUk+0e!GB{OWvPO!96<9K^f5^I7OxXN6Yo0Sb$=Yp00jmIc_V%_c!vLFey-%M;rj z@cpEI5#H-_czXKxP|{`d9&vAZWax|)6`iu62OJf`wsH_;*GwUZqc`m7xi3vkDAB7^ zVlRg}AB;6$6=|A5(qcAeP*$4eZOE{Vz_>7|CHVjh@^Er`SKD4p*Yg2$HHla)Oi_p$ zG>?FIBm&%JbLpG_3FE;&18Y7K_>J)f(?{^~B=*b|E8%j3f0OPM54nKtC z*Q0ob9bcR##$5wmm1`BN*GCQY0 zt2Ae^KAn$0n6F6I^%>Sb^sOvMoa~2jVgcvo7&s@dezoU68tw%D01h>oB>B;;i73)? zz#Q^;B>cI+Jb-&wbs0A#Wl=6xa(Yel7SQ?YoIIF#$si}bDu%OlWhS8Q1VeAB{&ej& z&i>C&mfBW!0#k%^2WZDnTFSd}lAVAt&PW5A`m8I_A3It*mL}C~V^1ZOLyoKsLVQHU zOcAbq2sN2_Ae^5v*SB9<&X3GzbQwT8F5_OkEshyN<-JE=o(9ZUIAvf|k;aG_PP@m9Z=D!?s`rvNU-yZuy-QAcnS>L`&)&lvepM8DZN&O$j1pQhRGjz!0QDO6 z@R7UJ;Kaw5W>0bBzZ=}bV7l=%x^~m+Cx%B&pL0gQHdJua50EK4iS5X%K0EwJaG=mDVA?E|J&3bN?Hnuq;-SszT z@$ZWkC$|bDj#z+PMU`|J#xdAr^y!+-{{V!`UD7;P7l`#~Em93~6AX&swyUN#$P^wM zf--$isjI#f)g-%tqO;hGZ4pR>tTXc*llh9n@rIC^rkvVT68X(;rbs1;@?&w&T^`Ev}CnkiwV2Y-iu4an_oI7WWGweW-r(FK>FaCx~pL zZNJ($Byg;!C-kf*NkQ2g(`}tV)^yUi-0D}jr$w*X=l6F69RC0ju1+m$PG-Yu3Nz4< zYB}#3pYE9?7B?IFsIk|F!bf6wV#Kid-AM6Dy7V>rzmiom5PvRyLUNN{4fPJ4U) zRc>z#>8-XzEsT-|c>Yz-+-o;h*8)gWI2_@4_pAC}j21`O$+z5$iW~>eGW+Ou(16j% zNC!Jxss8{PTkSVb)vf-_EnfvFsUp^LMa>H!s6?(NmXgMvH%04mRy zQK`06KM$gce>UG)n`k-mr1{1@GuEb)!+O8`u((G|@Iv5^(xro52!3@S_cftyt3p&V z$T{vv=B38r?Iez8SJeDNrA!j)5@OB-(Vl-E-_obkd~K;(0K_vdd>q!!sXevKK3vG0 zuO#5tCwXfgk#Xil5qoy*2i^Yw>sE577PdNR&gks4zlq3^sB3puC+>mA=bGxYzlu6+ zTUqbf4{%{(Kb3hf7IL?rW~H*c73o&(@5DeXftS;smFL#O#hp-}q+HrvMiu12Bd8cAw=5xOh%jDc zXFE-Kbuj65I-^w{;C0O|;f!-j1cAC@Ku_puSbP<#>Xs7gJ{+)_qPK0b%^%%EjPiSM zGhR=m-O30E%1$}xPu99^68hOfwakdpu69WxF6H(Z0=Xy66L?88wb1?`_^ZQEzMZM= zn$^@SkryN|$ovma(!Ec>UmL9N(QV}MHlVO5MN1hk9Y6|l0Lj1@80nmMuO`v8D{12v z+Jq6vnLjd;2>w-m`@`aP{?O9(ONEtJj*(4$@1s~wc8N*zzEbRQRZYg*ZJ zXRE;SfwohZ&g01pSPVDx>5xILlG0mSh~DnjRL`6Q2&k@`ard}B-7DiS4fyNC{tv!4 z_qUQ6wkrLr$wt}-P6)+&hr=J*4@cM3XxgWUEaAM76X%guB)G?A1MZQNk(`m!JqONW z^6Io*(z-nwc$m#t^q(L66ZlKV$L$IK00fTs z7x8`>JWue8RJ-uTwQ&@UBq{sb3E4+aERgCqAH1jdvxd(f#dbBO#Pz&0A>%3f3l{cmY){9 zB5bUtm142h;E+vYc2Dr6%1VdN{Ih+p!N4G9y!|b$wK!JpNr+-dDA?)gn)j*Hr(PV; zX|CwtoM%Q{vsPm~5#uiwcpCEJ{{X=LDZkMryG2W;u)dZdaHD`7QGk<%U^fGR%sZOz z$L%o(j66T7ct7Je!ksU~ZK*_-(D;ttGhwJ&zyxE;2H#{d#rvcLJY~x6%P}C2Ji50_ z7mng9GU^X2xaDzGZXPMvEWu-03G&pxeDuMtY(@(Yi1_2LeVE}|q#lmPjKsFr6Nsd; zZ!Z`ixeVQXc^_K2jU!HHTT4P^?isVQ+nzmm_UlpGO*Qi(A_R;QR|Dq+fDdnO^>W%6 z?MB(%or%i3ARo%UP0GS6M7LLS5hmqa6NF>fV?8*n8%U>=uJ|L5V&O`HTOZW*G|P=j z+>!P>K+ltnsf-`T--FtkE?!LT$jRkLIUVbsa{}G4wRub^>aF*WV!5F488xf6SZtMf1%$7}gkTM+xx3>W*WKR% zzu=#Lv$w*54gJr9CGiffj2U$w6Uetrt-;E{wQbPkWH5_x>AMy5Zk3?fTSmKLH~?)^ zj3@&DU~~WumBUg=9*rEe%UX>2EB1N+0D@O|A4R)^#2*;EMJ}^<5)b&3=}PwYA&9}u zgo$PxoDd>CIIpk%9(*eBSHmp;cyHm~f;5d9!-FNZn`DrQ2ml6N9O5w88I`j8pAJ(iL8Bv2=WbzO18+CBis@BI{ zI%yNjs9MSY03SA&3~}Am4E}Y-`0K=awwt5gUult~%^VK#*+%Dd*csRg^OMkHzAK~g z4fdOCp{AIiBLSS@LG7C7;`nc`>-Q}8cXr7WjDu|I%6^U9<-ivGgq&x#A&sVHN3-Z^4sNf0u*86cHEz}+jTx&4&98{&j{JWXr1;Eb*Hjm);Q zD91m%ibZDi$EXLe!=U&Dp;%b9i~j%%GsRcS8-ojKw~<|lF^&hF8yD%;LjCcI^dp#I z;H=E0hm^KwRj+(}_-W$UEp-i3Rc$v@h5;KL8&ikuv$o)H-)w~lA9!bHM*GJCxz7;% zX!vjutZen$YinnA*&NsK&k6#Y2w@zq3Bsux6y%&ALC#-(&oDewB)<^uox^4;hthP# zV~%+O%;u`;9t!Z@l|Pqp<9`>t;O%!vZQzXa+0qmXpKgAYl}v6HTPODfFmvkv0I#^v zo5nf@pqCc>Jyd(2=4VsrYs2QwWMYJD)okg;H@@6 zW8m)sOK6BgHX{+Mk<%n_ah~FmeKna!=)1^2xihT#`l0Y1l*>Ju>7-d2oEU0P)ig zllfN0m*HEh*agj{-<+&QccUiXX5Ii5wc$^M8pXxRTA1>$E^aJbk$8p@t zrD*> z7Q8{?o6#H^?6zrX3pLH2lW~Q-m5xFJM&=t9LyWFBDPhJ(jawBM#p|zNsaFq$ecALL zxAE7&wwi_1HdpC)c^VHp%RAH)!hy6LwsFAbzHIo<@e9Njy5EUBQLp%~M!nK?O*+jM z8Lj0rBo?g2V;kFJ{_=SVBWd~911Y+>9be=B0E2W7?FnWETSm1>Ld&Vc3+HIY9HvOl z&Pl*dxa0Vj~KN8+jlOpY1ky@OWHi zZHTnJ+G|&Si1TrIikx*I_{Z@(S@_H1#qcM9?O;tgnWjh;K-c4 z^y}-#RF>i$NzufyGpGQJyCEx_kQA#ZJoT>Cygl%zK)tlrJTnUE>28v&dX9@_6EKW! zjor({a;n%Ep_H6huYp&`(SA?|B z?Ky;t{kE2GDJ!)6j3dLK;YlluZt7}nL*TE%F9~V){v*}A6D(6A?|1}_e$cPX?7m&m zArJ!WK41xUCvF1_4JYGOh24$C-S3OVgwg)yOWRPZYdql;yzH3@SAQgMbI=eoTGo>I zpI?&G#Mk=PlO^=lk=klgd2<-9O1n6TSNj?Auwe>ZuF(m`K#wd5Jc4pL036`wukiey9s}$i71L&03%T}Q zHLjWl*23*F8CeZWA?pKz+E%{{Rspu&Y78wSSq5 zv)L0}CYND(ZEIm`sCa(z*48r~p=lyX8F<}ULotz>RcsBx_+<_TR@+fyE*$Q50yk3_VU^mz;D#M*8&euyt8mu7C-IVrrnH>gwWMMR2rVn5 zvH5PKuv~Deq@0j@R$QJRk51Ao{1vahg0}jdz|-yn%ry%OlOi;`oLr$W`Gu7i1+aHx zIW-ZdQQFeAzpt5;m5!TM@MInXkzv%~d&aPr?GW6_d{=uaWs+FfgnW^ckh#ZDNX=QH z)OBUN)4U_%O*2Y)tR#-&E3H56FDo=fODSpc7&cfo7<{g{9ZxCY1t&(1$5!#XLl>At zmNwd|d3PK|D-o64jFZ+^^k497bIHl{Hat?cJ{g=}Yky+Dc&*u{itf!naQNG}ENh03 zd11W~SY+@rO?iKb^)C=#YZEoMg)Fbd*p~8mq$vcY1F>d|Hdf>B0>HR+EXN#fJG!>B zrs&qv*jefKA7Gj}Bzs%ggUfH`KK!bjua?F@z%-zO;GNrn8aj2Ihm7?L9a>98xL>s+ z+Z{>-1iL9sxjTxJxsa7OIUw~Sx@pbPe9~9^KU12jl--f$_Rj{tcQ&6FfbKO5oi=~8 zO>t>+4kDH`P(eb<>nHlP03jIzo;dbD0qV9h=yqpM)h_K6BgwgzNPMXBvdW%R(V-4D z5O`s^hD&3Oy*tOhv-4`{qxh@CziHIWQrWb2mR?`k6u!;j79qXJeB~6fh9r~=fk(w3 z6h0Q|o+_WiTCS;Xl3z-1w5abQ4R-*-tL{Qsyv0NxaRx?CGD#&|ODQ_{*VL?(ENgprMkyJHZH%?nCbkO`m z7ulKG8+*%bO+V2DQbs0(;N=KaTqy@@qMQN+b65LCkK3<&8DptIYL12}5V=O$zF9|* z5Sx)*kt7M$3l3jDs|ra@JlQ@y?@tFd$u|`isbm8NYv40Bb)F-`GtCi>)rAjpiUK=Q9>1vRQai7^<+r;Z8}e%%cs7&G9Oo zDtBF7zso}@KW4Su^IzKI_LJ9qQz_7`d`#&Q28w$vJ5zaW@}!N~bsYMDPB!)FUpYhK zC5@Xg43m?&a%vA1_?Guy)hE846`nzzsyYGCXYdt-FRphO!N3{Lrjinh*tt2=t&oM-c{#{DAI74!zGsd|q_^`GGEtv}JP%A}s82Q3(=wp) zz$Xl@GmoVrSzdVpXSr4xIbaVXoc$`Ns4!~-U^UL z&Up1X01|k>BkIrDkHSsjFB@N3cyHo1r)EvUu8$6_tjli=%%uou{?5iTAPbUFcJA7t zSxDSIPWS_Dqg;6U&f5A{beDPsQaNmbq_H3<1P`0FeaZVM>6&$y#EohwlJ(vz7KA2` zbi;5V3PRFseDrr^`IU@)h#CCzjBydeQI(dq{Ys|^N@~ZcX@3cIjXK`>^xYw?Rw^!a%QHAhO(d_@M8sMtq%N@^Lmd%acK1(jC{Q+p$nIZO=lO5hQkoXu_@4`|Xn8orr# zr_UYUE;So;OP{r|#A>mkqZh~=009GT8$8$I^<_Ln-!oV8N2wZmS(~k?Xf{v{O6x(> z^$XDmx(+?Q^HTpFAcA@IZtZ zj4Y@C11gxw>x>X(w!Qdof8o1-9C-52T=5hJH;+P^(@mKSC(UTiA)7BNV2mOg97sQ<2bi0uFWixO|?`vn9e~>&RnlTP+>t)pCY>W z+wmgdt|GbkJ)~G!SlToZ-bJWdMv*_tOnFrp$yn4j2JD^z+g_`w{4MdWgW}CY#eOdF zTWglklN35uuQZmzSd(DdlSJz|c5u#fBVaM?4Pt0F+HZ(n`rdzs7XJX*MdnCk*44|z zBUIh6EP#SbZ5)zDe(res+y*k8Doxb2SHCsd`EI`>%&SUC_AUG}@IQ!e{3oV(!%>j{ z)TN0nqM4BdP$`se1;!b26;o?|@En|)vt#3pb6dH#(C4<&blYo~plj)tIOa%I*Kn3V zq=^+kV~{sCGmK!@s7>&@$C}TBtRDA8xYQxLXpWZJLwPoEIYLz;%)}`9_)^(pkI(B^zq`zVB4q8Fti>+PsEmTDvs>w4otTCgIjgt~6Vu6}a2nVX;80qw_&EJOY z?a7;f*y}fwvTs-y)5Y2M4%65eLmNXz| zz6m+`y$C;@JHwtb)Abn+n-$Cp6~yWwh+9a_8ejr~OaSGG7%X~|f-$zOPowHD6RZ;k zm@scCo+A5qazMvU2o2vn6V|@6oLqM_Zs$LLrdvy6=UT-#8*| zqsMWkUs(N^vo)>5%)$|u$~SZEp198J8tXMkOc!D+Xc9>hFaVJw+kyu_ARdZH2eI`S z#nm*Awmh0`z2pK}<&xevwhTmjl!K4}!0VsOB%17|?9rV?c(cm1Z4X?%(*FRoqga`6 zGDX21f#hsHqOo;5Hi(y=+E7OsQmhB#ftu^S4td&#g9LkuhPQ|0Y~&Ld$mjg=Se`7? zf;&PT&?|5Ut$kJ>WPJ5R?#@=`IkF^&PIg_n4dtgl`2PU&sxx_!Aupp!{k=zY z<~E3PB)P{RH(IB4sK;(bcVisnb6&+Kp~W<2J@Q01KZkC|`;e3UDztjlvP#yG=r`)v z+(O#39^RSttw}ZOWO97d)1X{``l^-QwPz}okL6>~f|kp8t-Ovz z`hDzdr{@0vMtpvFtc^!r(H;|TbnhANW{83Ot7`uC;fdNDpJP}Wj<0I4iL~(JWt|Q>*)7rABD5I*CDb(2>YZ<=q?}#q+ z2}EGZOtC9IHk{#?^CR`G86}!nK?(^2rhlzz`1j#;t-h5ex20Lz`F5-3c~E1R!3DZ? z`Eq{>=dQHN5Esg^^2Rbxn)yBbXoJ4SlceJHEkf6DmRTdfZusW6blpk@geA%=9CPvm zn&q0_)W*0!e05TUXY#6(>)tQ7I5v?tJTN%^wJqve zi|%xj_;*NEAq>l&%OMq3PY&4-Qajs}&r)QpSbSCDcfglPT<5f;e@e7GN3I3Q(eu;p z&x6<8P*RM#8G62vspvN!+FD+tBVqpleh3F}_s<`VZs`{~hNEt?N2%>*P(Isq*HW^yE`21Mj9Mk}NOO&^n$qORjN7EQ5uYTRC8@9%ru1M})!&ODx_h?6d z-R7W@()meoBt(vYAsMFWUl6p}<6kxsSoO!IYV4Y}nRI;U=h{g7rD-`_j#jrJwZ7G& zW3)$+)B;8-{5SfQ!VfmhcW3Vh&-ALI=S^|FE)=(HoO4fx`VsRPS0|{)6(g}cmlq1f zTGQJg(|+4X}MtCBpihBvy{dRkR4r#7J^XD9Unv1YW43hN7fK6=U9Wu0!wn&P) zIRtgaYGJjBS70;m)~qd`nI7ow2frAk*{oHLW>lX@nB7{lv>@f;+l+gP)3NaeopOVD zRv7EtR-0I)iafwEj@|2>@pgxCWsOHljGy`G5MCeLRuWvs@pm>Y^~(sKa!ucYrnmIJ z6IrML$R8t;4SB7t%HAgUI3NI2gZkCWIp#;n%H!Xqa@3<2xwKn7XHM}2gRtJpxjm11 z+p*UynQ(3ZBcLn&Ysqx2P_qW}3CCO-+OX98x81z(dgrBi)o5KEFq22CSa_9f4pKvp zOxHoBc=Bjdbay0V^SQYEJuAuVwP>9KNh6$f^{t&Q{s}RQnH6!)5A?4#tps&KrH@|I zd}D2?N90||tVqGg&VIhNR`W?q#%VOE6;FJ0KY^|;IHzpd+=xN3*m1W+8eC| zjFbn8Y86V_V&lbz0>Q+J-WfCzQqkusljb&bV5p>!A0JXd)d~EJP1r(2! zxy}!_PSxkvz~QUA?9E|XtU8}*XE5+1bzN4@ z*EiHA0NDB@b*O0JVv4=jIwW5kfST)Imco_1CG`0 zo(1^Xq3V)0p{)3VC0S6YiRHsC3Cm-q4@_~=yn6Twv|aZ{eJnzrk8{^`=hJ*?;rp)- zc-zC4I-ZktAKC7-yX$3|-r_dMed!=7`Sc?guaiG%U-%@a!To_m>`<7n~)@B^Pf51_y)4z!|M;ONi~{ zj^-KV3__5|+;jLJ(u_7M5rm&LIa~VbhgnmcZ6$N@_u_Bt+3{=P7Ot9a#6JaUnq9De zE*b7^+sc)|&&eZw>m2)M{{OJ|>3Z!^E0JrS2p# zLnYn1O|a+Yz;!s}XQw<@&7ZV){1X%5Pl)X-W%y&IYFd5m+|tXd-YxRTTaZMl3k40F zZ4j#<`H3Et^mu&!FG}m?k1kjTH~Y8upO2Diaw7iZ1yvacqiE^Z@uo+3o@p$Z$@_)7 zAM@6-gmM;HC17wsBYqA~Pp5j))8Jx!<0&Nu8*G5_lgH|Lub-5e#96dextWOEGIA3+ z#!3Av?VtD~*X$GU8}{k(uZp}Y@oUGrmYaLw=&bHE?K;LpRlJH;kzBbrljUgC9gMt5 z$r%;!@7nIi?$$t0Qs;~ha7Xp^ucCk8n7_34v->N4*d7x2j*L~dLyO9|F4Idw! zdmf4Lhf%qTBdC3yU4Y)JCP4an*I}jnLbjCzj0WO64nIEi@U(cd5q?_Vr}-ZI^2|jI zqMxDi_0Q~`@xw)9GkiXh=gS-$E7)K3-U~S_R5`0Svdpo85QT)ta(=plhs&(T2SiQP+XIqq;p=?4EHa@ui{zxoZR(kzj`OZ^6BfRKFvx)3#(wq zD(xWtG$y5^Y4W|@rJO=Z01{j(fX|MZBd#)Wo|X4q?Y4ueua&83cJ~1P01d<{pukk3;2WP)czak4#%9OqQ-wU#dOBCD!&ZV`INCssy;Jch;wsqXAbg78O>SKwXYFg zmS&LwPrn)K`U?80`}SSR8P1zXs#b7t=ZQ+HLj+f&r$jNV% z&jfN{dThPsk{$$ zb8-xuu&5*_1J@fsA58ug>{|EiSFT^rzQf0sQlQ2K&Yau5`45lMx!b?k=i=U+nYEKl zx&Y_*7mSA5XVLqbgfzsUwFcEJs}QrymO2UCd^iP7)E29po7NDYNTVQOV_mF2fla>F6o#;;$|S zWK~riNgV!EDsQ1)(9*WkV6coOx zE{m!nh=!Xqjz|~`GQ{=)d)GtY&xP97zdUl^+?Zf>1V~lBZ%hvL>OLOu&xQO9f=Cfw zZqrJ4I-cNq5A&MjtBIk8(Y-}dtCGPC5mXXb z>OebAK=H2?{7~1tL!^l{Yk0-U`%HJU2H!jp1stmYyW?dKkg9sF3lm&diheG^uIpCX zcAb9&g5uHFNstp$9vdJM8oUbly47x=wC}0sVsklPk{Tmw-^Mmk zEw-@n&!~wvF_{EHc$p3u$RsO*dE^}O4hT3LZ^f@3X`g3L5^CNkxrEv3Mdq`(NMuG( zpe70*F-XJUt^s1ifyHBZ_r*3I3Gn;PeRX-J+0791q`bC^YzW-0{nBqx?n@njhgK>= zg0=DA#=nkQ=f$mUbXyHF(k9xGhqo;5>NgHaByKx~;0IBRo~OGe$}t(0YwZ=gJPb}T zrDXLrzAJoRzW9N4H-+>s5ntTfJ>;^w?AaV@&AYG#x#t99oQn2;+0)<%_L9gKHAsE3wW18&vXmt}FIn{hKXihTh}FHgj#BR9CrFB|?&fC;_rV z0_x3-uGZrqSG0Ji`##m}d_Sq{m#Jk3hpp^wZ!M%Cv@#aiE6E50aq`An8%{ayPqCcl zbTIV(rG<7~UAOy;DRWESk+}ov)}AP^)&9?8ERAP*2)MdcR96lAfh2fRRAqw#217}6(J)kV`t+a^BSRX4arYBb;1OmLD;;h?C-Ac-BCMonZ)NXC9 z=KDp(wb0)@O^vQ4Z2azJ2X;CuFyrM1g>AfbpzG3K%i#SjUd$k{Gum!9FqOblCfxq* zls@GHhgD@8Yv5|Q)os3>XG~e4CAWlG>~AzpI^8AHNQ9dx)J1|;R*Wlutmoz0bMm`- zgIxxb@PEZnc!1q_Zrwz3NgVM-cI@nh5+y~E*Lu3`G7+>K22+vV?wbXTmZ&G2!s%+Q zjoM+b6#+nHI5=P8RxK8- zu4y`D_07+RWw4Ug;nmIEoSP>nYq%*SJPo7V>3TnzY9(l*88>4n zBu?Ov0^>NrCtN-jwkEGE6K}E{>cR_q9YiBS)zax^(C_sd3wytt%esqPEA%zD~kvqdnUQk1W~#dNn?#JWZL=0$k=aU3vD~F>sYht zx;Ks`wM&~fhB<8_k>u2_e8Q4O@@7J;au`CYbI4JHkW)3E;x7ovX<&4(8YP9qHy5kq zL#gTHMkS6C%B18o$Aysf1Lwg9HPKblx{RjNM<=}54zJ*7(nW_(TS?;)Mg68N<%&qr zm>sg27|9Zi&#)#`Ze6>6VorC5VAL-rnq3>j7G?-%hCA`5NYgSz?efaXigtkR!{x{( zCsK2aPvUg&^qMjizJSJ6MVxk4&niMogpxn>b~}u2(UwNp@;Uj`=N7yr;0qaUQ~L_g zq*A10#{iYrX=1>ipK=hzGDa5x3C4F;j;wu;zc0NQ%AUF$*M~G4Ju2?oPrB1AY}B38 z#XQj@a-%5*NYQe`=UxsMqYM#(y$6PV8|r#>@bM>wEOosu37$Pl3#)xdT+JQSV2O|` zIRK5tk+zW8AeF+`K`(?nHKVIXZhWAPtX*St?ZiZ8Uw1QXf6n=BAOvZTK;eE$FxYS9Q8 zP9$WKA~HtNS0ng@_wID~zTGgLrkc|Apk=iR%*+!lf+XBFI0FET@LOuRVev3}YP$6{ zn@-DfOGbxN9vqLw{utEn)WZ>X)BeyIQmjkFq$?{v zUAHkmJ~4tta(@`SLOd7Y_l6B__S#LYy`+Uy+^7Ofrg;gR0x&|Ab;!uA@OVXDuPv_M z_1jaHq~#QGKeQ(R_&^80#9cJ$sjliiDrmJWE_~U+91+H2gt&39P)OS9y=M}pjRJpP?)d*dg>t#igYn_KHT$++?*WJiuQ1-@cN?YIZ9 z9A^M$l1cOTxcfZp*A80)?y_Sa;o84$;jD@ob{RQYzsTjYz1T>S$Vo}S$>-%Fs!wS( zv+rk3t^8T%H6;3zNJ`szYtPC69MxN?ZW=v}_s2}&57NHE5lByBDG`~$F1gPDH#H=2 zeVq%iA-bPRh#w~oMoHr!)R4578A)U-gN{aPXrV2|QzY1u-PMOrm%q}lL>_o{PMQAz zXQveg6517t-9c`n(xypuB19!lTOfsR)`qUGQQLeF(VJBGg{A3s5xUDf#TDaFSsNS` z2ZD3R2ZC$q4J*WY&x8IjYF-ZT_l_{l)x;DL>xF5!T36;5|21z(4kuQj}uNHV;PfM$d+k2R;Hzl{&t&FDJtbszCbOUOTK-#QM6ypP$ z^ZC9l{2cJy_Pz@6E$Fpnb3MvDw$`t23Pwqtvg=3R?}s=hRw{FA83otK6Hua7DdXLF&;)Y0bh|~viwvg>e|tJd%xwe-l|zy z%Tir#UmZtdr(JlH<1x3^HO7d;rB8O(FFOY$fR7>w(GJjN$M-|_aMws^( z@?9)3qYSW=NREDDqj$>eRPM)a$}^*usMMOgpZ8V1SJvMv{!5mvTJm1&K5?_~KgA6r zUANVyi&63t*{0KU-w@wi*%!A`!*U5?k%9uOxnv;ib)=osk7@h-ZzDBZ)SoK)fXW{AD1jx z_2V%Vv2>KB1@d3lDE%t?6Avmraj6yBm=Os3}IQo1yxv(dgmFR7Eg$Laqyb!N51jyp?+Gx`L^-d zEv=DNj~G<9Mn);~;|C$wk^lo3aPATqJk}M`-RrBj<@%lSsVTzE9!>i-c<0BS8Stc% zSn1Q3&)~3YE`Kfx8twocK-klJ}PRKo-MN4VolPcNX(=iz+f?D z<&V?br&{|0`@`wtJqp_T-$IgmdEr^DE@iV&4#IbkB~7FT&&~-OmjvK*@NKokNp<$f zB}iXr{pU}953PM|`z!drN%1Fy#ekaI`${sh%{*{$Ci6%4AGU|98Xa6kZz;<&S% zENR+sM%WxjG@N8~38r7#`O~$DLWQ<@NRXFc!#Geva7g4~e@x(6Ux>U*rq6w7TG?-7 z{oSPAYDXH7*dj99mz5nD9G<-^wAAk{ns4meOM7dm;*pkVXNjc>-!aK6w{gKxFjVEY zWZ+jh7ME#tsl#bwtVL%Lk|dhe#yCWg#gzMc&Q9JPcx~$!Tc8nr0wpliIZ= zyR!tx)6+Fp<~vu3kz6SB4W4V$rf^M}mwJAh@ds2Jarc7Ob={7b+20w!9B>6{PZUZD zt;W>{pyspn0^VPk0QpWqBdvNgWy;abQC%EfxpHmq?;R4CYdFdC6YnVMd;b7R=9=M^cRO+0Cz|)^&zhal!l7wwSb44NTnl@Y3WtrD z{&lfy&6|0T0oZa;knn34 z7T&D%qbhb+M|T&Cql~O_M+-(uH! zZs)>Us;Qnh%W=Yk%|Qi&$O=e6Z$sLzXi#{%;#pGe;_?WRJ>}RpC$=-zvPQnpUo>|> zhu`y;ARkGXHI*#2a)8n06O;-buQ&mwd~)Hq;pwtYU<6nxC0${siD>p zTg#Q-X*_3|<*2z?Nt%&eS}?=JSJx>-&7{hpJFYv z<0fQS=yPb7$)#Ml8DHHgu-r)X&Ogp8G??{gN_6BZOm^y9937w5qkSaIzrD5CdlkntmX|uI zI9ZdE{ArKyt8vY%G2w0VoQ>HT{Y^1m#ZTb>2>|uMg|xb(kULQ zDYp8pipiUSBKwh1W@#2){{Txvx;Z|h1XM41e551%`5ln+QbVn2@*RmbL4AU|b%4mEBzF_7@mq zC}MjIVz9hT;cH9CeCTG{>c1;5T>I2Cp61b-Dq7rIDG~|i$UOiDKd7xMO!>iPu3MJJ-76p;`VK2| zNWT-R%9`DR@;N$;YJVmoyz1UTBVfn@>h)9TBL}^mdlI;S0aR_tCM(%O#Y9KTbcDY{#lyMm(#?BtWB+ARzv=^NyFQ zHM1+jfzJU>59wXchdwBHro!1FxAAVVZiomAYpTr{9sdA@#c)-^$~zlIvg(ga)Z0wH zj9c8sj2*I}`sdj7s4To8c?`d7(URe?0{{;2hpu_g>&0_ce-=DpCeZ#g)+Yeu`MR94 z9RC2onB><*p?qHPL~XEmf=705o9#AmOaB0)BRQ@~LU1*UQ#N!Tj6O8*73{`uHR1Ar zNK9o*($3@h8Ey(oH&9-NdW5(fr4eK@LMO10G;wj1hn^ za7f6nTkwDFL817E!Pfc>-HcIQEyE+;HPaxCSZ#5&K_}%sa=ZdL91kYGUtXWXsyirR zY4zOvKeV@NsXobSe(LqP=@xB51yxo9g;{bf4jPq4eDJ>5&(MZ0&8`GU6ZxCu?$&oiE zZOLXngN%Z6o^w{TzYSb!mSuF%@x~WpU!e-?kO14y%EKcEw_2g6-B{ljn(|4mK3|+T zJ$ri|_1ySV#U3Bgt)jEGvUDy~+%8p>i1sW%_vzE|uOk^Ldp4228K~4vyIB2T{gi)i zPltN^X=XNAo9Te9joe}4t!Pce!XV|{vPp6HwefX zKF@Tl2p}BrPhuV5nv07gkY_6uX zhCw6d-s(ualEJq!G8JIWo=!&?9V_#UZbee=P}|V^Xy-V2tIu=#4)Di`?IlGGsQ||7X7HcE%-xIgIw^>#y=E5@LRZ3{ii+B#=R2=;zSFK z4pf1YUd!RH_$qJhBcUXEFNl69UtFu(g%?YtSfr~Vd~mG@4f65{&t84J3fWF78o^w* zh`?f2vR^ayM%%>mhTC~&;eUmr=la#u@dlrPy6+k23Usf_F9`nt!D0Mapng3XC$b%aku5b$pjK}jCAyU3;qis@c#f(C09U_=5^Xy(JxvTC{(jJ^C2q1 zLY(3H`VL1w)w3E}xU@^bVJd4Gue|*TZCYrrR&=|Gt%_l`gOK^-@T<#lDzZxvIL|q+ zi993!00nyeo~`u8*1TP&YnJlHPnBh5WG>oImp)l!ArbwUfHI`E4o0v1J{$H}yphbB zhPkD>H_vHxrAw3;$Smj@B_wAGUo2FCo-;pK%qeQ6FO|+|#g1Ju-c(=I@0+@K7(=Z{j7mI)BDZHY=~QiJr#w{HuV36Q3;n#9$M^Jab;f;U9?p z2l1_}T91W1Yo_Wj&ZNNhm#H9d4ha}M;Mdn>9AAv0l`4;4GtIir5!|Y-5y8piRh61^7}}uVWD#GbU~`&Ss%x2R;Qs+bjP7=s?#$seB9gN2)1Xj{#Umo~G6_0sP}DT@b!;_x}JK3YsgFm9~IK9A~|H zX<+MVW%mhAaoL`IH|(?Ufflwu%o%aHQ{j`8aRBabEg|UHuXsA z!p@}YD7JGRCHRAF;kEl3pE_n^f=5i}^X*(-r|~}W>i9gURSD&so=EHmO6B$4b5!wu zw$R$6TgMR`<19hPPJUm<^R6r6N5$`k9}H%W%-@HPXT&nds zBcaB6SLAbYle=fqMbV)iX*1L=u9sH2Tb)wy`BCBanE}Y-Bd=QI{8#bwLDD32^&K&&IkrDas#5s z$%esZ7$rI_d8V7H=<-~*iO#MpuU&|@hDD6Bff0*%jFsCNEAufepEHbco_EClCh@HD zK+S(Og^W=~(pxB!IprG)f?v!fP@ICJ_CSfbSY!B zfWxivOx_2$miJbJL%5RE-cBKcVYcGkq;Siu9*g(e8Gw+<|zbeDxb1I6R80hzXk>l5?EADfjw4cYn68uZM zkHH#c@=FSNQn*`eF>sqo9C3vMfHD9)bv0Y|fA}}7U--;h>;4_SOPguYn&)Z|jkTO? z3|D&sfa5qIfswm4jqn@cPl>#Bt=Q|Uqg`CsTwQrrw~*PE5FyAi5=w)B1^_(dDg+sHL2GGugOy%s@+aJga|X!Iap{cdra(8#cVQ^O?N-@5bA z&XqaNS1ITo7uVqNm;56dCD)UCbqt43u)elb-E2Sx81~HVBOQau>LMhC;+4(J{ixzjZC@b-fxirsk=TFEmrS;owOFlO2v z6wS988+Ps)%F}esOHi;fLk^`Rkm_>7c@oWK<;8A=HUbs%5Hsi$F zuZS*ms9>-+n@s5|KtIxLCXg~KEQ)YcU=j{a0XujUuX(NbWXo^jZ--ueg1yA*{&J~= zMqCJiRzE8_OcprV6Sq7H<%S{4b$0y!0L-@Rb2_KQ`z<2E;Of^g2|R%ewzoHeKQ2~v zCtxfN=FZT$Ip{NvItctt1lp~Q)`6*c(&}?Y@jP&S$dE+>Oy*!WLf&lauweg2Jw}%%- zv4-%)Z){3yPb_i)QrX8l(*FQ%c&g^lLGcg74KCK!_Vhj7 zxIrz%mQtW7_Uh@d4ckfJ{nq0=HzVPnf;w-8B-1qy4CppdM|R3J4Kn8SZsoI?#ze48 zRF(x z?u{BwviiHfs#p7rl;vy4!@jcd-lgIQG(Qdg(>hk0dmO6IXLAkANG_pqy<%04IS-p4 zBu1pLRV%!PBy3;!zvDKcqg?1dFNJ2i(ruZ|#+{|Du+(69;zbb`Z#F4alz}N?L1@CU z%ZkMDw~6h(B3xygd!IQXh_gn`y>P@w5Gjla9YF}dSA9xuRMV)Un(r0)rEk1y zT@xno)S4vMS6VgH8qE4d+?LGtx0;>i@gvTmZV5$l>K;W`W;^3B0Cy{K+BS#dUk_g1 zUs@X*Ydbq>=8VZB&n3#off|CWsCRzsCg4v5GL4~+o~Oef3*9!2YvK)3%SDe&)Z>~d zZy*mUNgLaGcN7;VO+hewt7w7wuNQjokzp=?V^99UPE-Ed6q|3b{<)nTLxu< zP|DkhLRby8v0>s}V%E*9w2RF~3(MO%M0YouJIF3$++s_%NMqV^*?*Qi9qMw5c;z1_}o`q$!9c&RNw()GxpgBK?9R)EQH*iy~`kb#a!Ao72NjGb#giUxf)eIzi)7uql87eHI1 z5fa4GuI7Y*Kv9JRu+DN07m7Y2>2Y{z27}?~EF)`{HkbF&+H6G<6(KyS2wm)Vjlr|O zoM(>cR`%A4h5Xi^*U0DOs|{NZ6W-}i_(pwe!dh%Huh~PiX52K(BH}p)U3pvpIXNl; zI0C*r{heHiY8Pl5Sd+8>Ff+-{YrOdB@yh=IL0KS=Te)^I z!q)-i{pL!1rJ_ABT1>e6+lU7h^ER>Kd3;5GE&i(lyt16g#2lV6o_XzGqwtpxDsS7> z*85*mmZX(NVQN=bH+M1{tAis*a_plS?Z^OQt!G>be8MB0&U%dFuk@|k=8a(r5l$BY zla0KOe@f35O2^H!Ior!A;MeLj;G(REZJDz9o?v+ku>KR*AJ@HEvWLw~%8#6IbHMih z0PE5`@WKl+ZE^R5FW1+KZO*S_7&wuUhZ&3>y#AHC64aV|I3YkmW>)?o(xLL?U?Nfq z1H!5FKmBT_HS=5_HYnJVI~h%d$ICxWkcV=0F{{W)P327I00oH3bJ zdiS!xL&o#TZ8WikSsP@?fm>n8Bu2#NBjF#6d~@Tk8D0%@!cjwTj@Ne9cW}uR)7u#{ z6mdrB^GA~Z0KVjI3=V$ndQG>1wf$RFU1Hx-ztXO5U{rf?w%9`xfxR7~DBFU!-YQOG z`AGYX`Cca#jltAZXFFTwf)IsAbc%X6gMJ?Pe?k$rf^^+fOB~W_`mc`kMY*4O4YC6* z=a|x<#vNmu3G@4s$+q+90YV!8_c|=!MQ%+~x$mFtlM8_PZnN7ED4?+DO5T$doWHtmh2Pw~SR#rz(?Gs(ah$_SD%*5O%eS z*Ltn3!pCVR!AcQD+?acijG>laBDl{763iY-&k^4d-4`=*vMcCb?0Tp;vIUl4f1 z$9hBSHa`m^vW3gED+R1J(b-A63o9IE?X!>#x&^>FB&jvV>AHW9@9yW(H7!R;(dP2w zQ5CdPyh?;Bk14#@WpG)r7=_@v?b>&H4yk?MTYnDArrBFuPib(NxzjH1l-t6Hg#l>@ zVi<-1rot4VBP5*8I;I_R#YbNz-M;oUE5_Pb<2*Ovi)}{fE+_Fd#mrMPHRRC}=@edG zBO?p6vhMf17ceA{&D3;>x z-bUQaB2gC7>h97xUzmadV4cTlFx2W-#K9%i3lA8^R^0i|$6Ak#yaA{U9Q-_;?dF6@ zXC#u$rQ&c({pf&hIoza7Fa`W~YDu022=i`3r)k;jSAfGtllCIOJpX74}d3 z6eGhUN!P!$T-)2U2@zGYo6S`~4hw?4a(MaJb;w+(KPrVc5H$Cb8GOQ|h}9L#4my0J zwSQe?a;aAZ2{~+$o-V!~oSZ$CpL?>6w9trt(qIBLA30Y>01my$Q}qD!F)>wwrIaSoYsZzQ)pNIY*@iv#?dwu#;ml+ZklF%8K zi5nz1-Mo67o`;iCYSwaG5A=&E<6sUI;y69eYT)!AhY?#|UB#(suwK2j^w!c%HKH8( zPGbXw1EP<^7_HfSCiZr+PYt76jD6Tx$J3sQMSUI{pOI>KRe4it#&?M^rR1x)=c&VUS!O$E+{t?-!{fY{PTx+g zUbQZ3YH-TU=!#R#d2$!bn4Ee^YEz>XE|bAjo@kLO<29}^B+HgMFVD9Y%@ym{@01_=HjS2StT zJC~9z$WAy>@{D>_o2?UG1njue%_!sf(SW0pGvNpta^5&8p%`0W-48NRtt|q)}y$#y)u`()Aunv z?VLCH{VJvM+7XAhkw_g%=RNyXCagA_JtM*T?XC8o9G5zp69f5jxI1@&(2#m$e=6nt zO`~a3M{}&rs6f|p-0l|fPOtJ3Jv)!-ScAsbT6(6Mw@T2<7ReG=56VYFk`H5!Jt|l) z?WO?Dh|vAXaBwNbuI5~_Phr;b%@HTb1bbGFo<^gXkqWn?AJkTPztETky}yJWFj_!4 z{A%u(aiV$YC7z`VH&POD$o%Unk-2etmj#v7A0U;v`?w>D4x4!3voSy2!jo2?RM5f+ zPN5!qhH=5EEwxJn7!7|CuUu{i`qw7R)iXJvynzJ&10#6HNreC6u1yJkX0)F@tI+gl5R=f_bOQ4b-u2PcwEs`qrcmYGfRD=RUP+ zH??)zu>eMT_03C7y#=w%q}qf^+opURVF;>vgx3*HFD;pbs5%ZaU38jtw8wTw9XP5t zb^jcYw-DN_vCB=kIrf7-2;gJUH69+i^1Ja&Yza5&^{%};C) z4YJ5`c;L_^tZ5tMW(+cM>rqXAXEDP-Hy)?fqe~Pca!lPQp4V_yeDU8sY8hyf6|hiF z<_FMJ%9h)IbtoC<6-(@sgO}P!=m$!fBbk?PmJe)$nwC2jLR+3CyB@---q{HgD|AnB z^VC;1R|T?d&s?9Ds$9>ga~G7@^%W9c>2c6Yof$7H||_@CZ2DkP#!6P1E}?`c~H5mW_MP%fkyO|bLtISx7C=wScMtq=HnH>+3T|* z>5L9CYeF4lPPi<3c0Sd~JUh9xY95Jc;&ivc@|=OmVT$OqpAg&0fZ(R7lBN|iq7{#B(lv#X0cIedd=XtnlYeUAV!4p0BLRW0 z7twruXiB3-S7_(v9QxN=qxihWFN!(#UKZxpe!1Lizp zLW4Zxkaek{g+A=S-E7Cm^eOgWK?~Yf2KjA1Y_$Q(8lDI{mbagMu^EWBmK` zQpYS>U`u#p!%ND7*vaTJPrW^?lg$nGLxKkQ-;fS|_CLaw^2P{n1a}IkP~egYA&xp{ zp5Og`)$^4rT^!eCs3f|0bV1s z-F?qm@~UBM{nj4Uqpa3-t$O}@eGcPTiQ$WBMV9f^WD28$k@9yrJd@wGbUqqMts_RZ z@h!ExNSTs#a9jCRZ{bWnvtFIsyRW(;dZW z{{U;dT!n}%A{Jy=*_e(pr1k)F{e3GMl$wtzv~e@)dc}{3C6@l)8$S?f?3bHj5X%P< z{E8XM??TQMNh`eaNyArOJbi2YE*KH%y#=E22TF-Sfk*iuVxkXn1 zlg2Z{V0IwzP7Qh0FtjG@q>hSs=|J|&yQi}@t8=Km+M8emmNw-JmN{T0P=o+iBXWX6 zcjmjl18N#IoR(L5W%1IkuI*A=dGz_rk}HA>Z&;&{CfP{km5QGDub1?c@n427<+alc zjcYR%EUvHT@r)@T1ShG&spFjWKBM6eidx5qyge1Aj)i9#k{23`_c64rp?3rs%BTtp zuwS~xxhJK0IGnn1)-LB}A2XVj+dic5U+rD-N8!JTVTK=w*H#uY+eN2Ob2RRfK`~TB zpD-p~H-9mUta)7Jlz_y0hlGFNrN0xr5vs%C?Hj}vUNwVsVoTVyf3>^HWGc|9^4Dtt zvxe+_a%=Pd07LlAXLqK{r1+Lw-?GcAMTwd?Aq%>;ADvDGj;@4+y$nTzSNy5%5 zUaIHm&XfND1%r||f%R{Kx}1>7DUIY(Vg=PVFhe4)@H-F)J6oPP?|d8o00mq4Ij(p( z>-y(~wJQtwrby<~JhIH$3%$|6*h1u!xt9P8k&&Oue+v9(kHq?tXrsnjQMqtKTTL_w z>$vdk&A|DAq;Qd{2L6EO~nB{vX^Xk?}_7Rk?~rlG@Wv@b&zXJdrCqE>;byFs!?n zg$Fqx0&DWq!rZQl_l^ zPj&d8`*D0t@o$PQ?*19x!{F^UeKt^ZZD!ddxsjs|7j&VSEu>=SEWTg`RFd05*OfPq zbcyxdE5w?-wmPNT-F=GANw&Kx6R@b02`9?FV_*=>2`bIFlZ2Z0g?w2M@dllCBC?dW zZ#5J`T@{g}Wj`?}OlB~1lBJ2_qtfPGVmYC`)7Bq4;#*ci%!=8QYP@c^A)KsW5JAfo zUQf;PRjNj=_eOOwH7Y-Om$h#bS?T^SkZF1a&A<9lcrFq@A;5Nz3T9;r{{VT@c5rrQ zpaz%68V$FL*^TGhiuc-j+udpR8oOz>uxP0~ zc9u6fi5Cn@OO4E_CJ+Ku3lI4@QtU8@AT`tyJb%{{>5hqRI>vE$L0ntFU#gS z;Z&(0fXsT`4_KP|`TRlRyG=^sbySxA;{M7s2@D=#X-cS2$cwdus)K>Jk{1<{Zre)K zS5@%M=BZ`Hh#-jOR5@I=xDNwTH)T8Y^jRTUU?! zZ|$>P8FcsZgBgf$ghp`cqj=}|pRr~G=C2C)d&GYgyjuFL&7P%w3YjFkk_$OxW*qRP zLHV+KcFE%vU&Hn~{{Y3G7NvyuPWKlqS*6J1yB=}}1D~(sUsC)n_)q@;2=<4j+g@GW zSzKOXNM=hM#q#8YI3cjA42_07V~%Cdu3o6c-lP7z94$G@=wF03-Y587r&)L+ z-@?~7w(~@0lIjbuC_^8f8<8XtfenysIU z?%c``n;NvF^hWK;Eet(MeM?N$;MVlNi5iuijpf58pL3<^SP`&hk%Ovk-WUXb-U2o{ zgYtrv7mH`{L+G%0gHPA3Z*CT7VX(ZK>PLoWxmcrLJz$PFPT&hl)R16LOE_%YB%u}!kh&vM&XL=Z}fc&R)!5S?($1(M3UsJnsHmSmLoWr zM6!tj`FL3Nw0sp+IT@@!h`toF(Db?N{4HX)>w6fEG>Ri6@e?#nk&LkAqvt%FXR)mo zD-Ag)^0e3Wxr2=Fsl&za<6iOIoOaqp{832)#UYB;)*&0iu*iiJfszIR+DSNdJg_27 zC*T&N4~H${(!4_*rm_}U8uDB6@uE$&iy=F@mQq0U`HLJidWXW#38mvjZ{lAK%V?0< zNY-g_B#P54YN$ZiM6Nu&%u3~k)+FO|R?mz46Q$Vra%-;*_-0)>{>L0q+23kS<;CU4 z<+7Opc^ybuFyN^^P65kgY5lE>jJ=wYOVJjnU0s~yG5kL8cDWqaTAhZWCH0DZxrBE1 z_fUnH0P18oV$6{f@|8a}F~(x?U&JKvzN4qAA{ z=8^FK0K)zm@Rpl#;(rj@;`2d*IqqKg${tBkqPP+qpPL3ZR#2dILVi(P_3>D0NjjeU z?f(D_YwsmwaM1i__^IQ4E(xu*yEt_ldxPfb!z=c1*6T0X+)XJGL^mlCZbjR;01DSd z;oGl@y7k69VP|tJkjj?Js9OS*DpVqwR#y=D8{131oo&1jP`x444tH5ShCDUu?&3Q&;6M%B*Z z#IVJ0`0wMjy_Sar6L>ZlH3%&{)xIA$mgfbxnF^0B@IQF0SPg^*=Ds!f{{ZnrS@?me zO=+sY43Nsrf}%dEqZ?P{&M}fbPC8fBaNbFX%EI+w&A$zm*>#qPICCBX6Zsh6pbu z4AF6tGC4gxEB6d04we#%gcgY6X%WY&B+ul#92|zo_5T1pY2I#FtY`oo2!6cO_g2av zY?dJjVv3yf8Rxf3iCPA>^5jjd2`E819>2=F;*6zntqf4Fn5YVao=!1TW@zUuS|l5D zkjw}3{#7&D%va7!_}O=Vs?G=>=laxh!3UKayh?{?1gjje>$v2eewBM5NT+QY!uWN^)Ap24cs`FvRx$bpHUe1M@R+j=9JA??RDAuAM%eaRh5` z7)IJx<&^x~jxbLr`c>OCc8!dK?{ex`jDJ3B8WC)fVZKs9``tZ{TC+XvxlPhejz|RH z9zRNQS2SB2dM>qXq{eo>WoXraI0beL1j2)t;SYy?1B*+CLbmvp+NJVDu&toInIi}n z3ALp8iu}#Bl1h9k2F3fV?r{T}x1~yoM8LZ+UTO1AK&&DarxCD7hzU z;9(dV{HC=`zF)e8Zr4_=`Pi$@*0qbnO4B?IXlK5H@Acvnq^+Sf-Dv^N(z6}nAqBeudogJ=sQl3AoGKx~gJ zGBIdw_1_fgx@31&`bMoK<+?m=XEbK!OR`i2MQO*G7(!)MP2CwlKf_si-@@;R`qqgT ziS_>g7I=d1PD_@IcyTY`veYBCWpdaq{$A!~aDH;2pS$yOSbRMdBOL>C zd1SMT<-e8gB(@`A5q#yhuty;|V5+QG00Pr=--ZhPAT<#LW@f zL`QBJOo=cno>>6}^3FX*FN2zYgEX6ce?`2G2yPUm+v;f~D#i9~-6-4?9f6o_I8+5e z>04s4nSLFl(s$`^_yhgqwniS4;yRE8DEIJd!t|i_@Y2sTAJ4JxJx{UBiZyU>R1A!bn$PaF%*>Ex$%Mt-N*@YYifoYeE zNz=3)8c(yq8MD+hn+uV8t;;e<#T9(DE%FCYcS_`7{HE{0e;R3#d{DT%wbW+1)hvG0 zEdpQ&% zQ_zfp6Sm%XuO^-eBRJ_HZ!L;~6@mpNvRy_--;>?!ZD2NFz8r5<+~?CB@_P5r>0X)p zNcjDAj}ktopzF_Z17(t1SxNJgC0a(>0`AIXmmp+rg^Cz{ow4HFFP zJ3e1*gM;6#M&;HG-d5=q@?2rIjC+r#IHiL6*<<-5W!&3CFwZ^l`q#A9hazn=)_-RY zh>>WTq#ha8Z(_H%zLAvOOCq{Pjm`#LMq2?vJBC|0{vqxMP`pCsl_`)FRXsSqNM*j;sjeXFPCt^dMKzo*MCWmxwe-HOp(Y z)GmI?9qs104*O6RP+u7zDl?71;Z*VfuawPjyp@#Vw>_*SXDITsCr!AvwfLFhPYfhd zgtXMr;aT=>Q7ybO;Ot^E^Yh8)K9#HDIQ+{8g4tD_)MIo0J*$ZD)VBxX#=Cbts@pMm z7E5b#Jh+%a9#nkH2+8Ug^&>oS(D=7hYkLzqJ^)}CfI1%4*@e=YIP2>sa#yypT5mFd zN{&YCVEqMi`iL_~S~!RUJQnR+6W@!KWoa@`Q@4-OvaVtiOh9Eg9r?|Al&*3+7&?Wl zMkarqPX{?QjP|o!F<9ncpmNL)HP_$A6n4f~;#a`_?nPlqcRYt;+OFTNZnq2QV$W`5 zAy(_=8Qf}<*!eENjGp;w-MW(ICT0w{Ba~sE)~K08QZqW@yisA}bG3Rc<9v zaH>H1R%s%WW@r2$nnWq(SqUQ~9O6UPpqIc~0Nbj{4tc=;0PEI@UQYwBnFA6}2Q^@7 ziy$b<0}t;~vNY$KFcZL6QAk}ih9?~{NZtbWanbVYOY$oD8mioibYw7Z4T^3vhn%JbG65oKzNN>F-WU*FQQYK=i3` zxYVq3@@SqZ^2<$Y9^T+$vl7!((k=%0$VMbMAdY>oE3=zekyCasG0yL$X5Psi!scj$ zsW>|u2lS-i%TjF5EisSgw{6(q?x<|;(%y2?7wO8m$Q7ffNgNUjTf340{{U85`ukR+ z*y-0NEfFMoRBBf;xs1BhSq~e!uNhTS{uMX&)w?Ln$LPpwNv$mu1@hDr*nfprI!2uA z%O#5B^kK#-9mAR>aerYV{{YA01KTZ%d>V{M%eH08@Nj9r*t$|5EZedYep0S^{b^T2 zwEqBC=E;xx>BS>OV)R;yNx>>X=xQ6w$m99mEyuPRs?Fi6Z25^J^v4w!_A8Xlyv2zf zGfPpXhfgi6;4)h_NcvL)j!xc#xTZ&?+^eY)9o@1>&+AqWn>akkNyi{Jf7Y>T%+YKl zSMkQaT(~NFjMWWCM2ctoZkFdc`IUziWN8;;sbv2EcmDvcDn--hKmom&5B5|X{{Sjl zbsThOI&N4ojnR~jp@kw%5Ia=rDSG&DOcdrFCrE$DaQHDeG1vzq#GEOJ?Joh41yQdBHYq88fZ4n8Y{0*w5a` zt?f5nxPSoaqXX}3Cb(-IRf!Jn((ImQg2BChDNHC0ZlDPHyaB9w-IvZK-=eCU| zxd1cgY2b~dAFtuhy)fG#E@q68<&ejCErE~c{VVgC)NRh(Iv%l1*wXpmEJ2&8+&T|XIttsi z)AYEnR9aqnzFebZ%W%xC@{n8SIO&o870XeuWWwqw+j_ze$_%6uafSy2^ZiaL>>hs7 zC%yAL!Zw9$;~B^U9=Z1z`qq8ax{0&fbz;Ta1y7Z+k4zt2o-lAn8R#i2wMnJc1ott| zYQ9p&w&j!taB_JFO;^J*XxFFyCp%e+xmAIf$C0p-ND44WC%!m1 z;-9K`R_?;v?M%D5}8~v!6zL7=BVmkKGk&nW6QkL7D(Wce$#UtWtYrQz{Ue0 z>ywf(p7pcgC?fF&k3P3?;tNu2ty;z_n`_lO*|H3T5`|Ro3l4tx8S7cPKlWA9rjr%R z>UvWy>w9^^I~mSb)%4>u|=J7KKB&kE-x+Mm>rg?h;YsnlPGm=KqW#PFI@EgHPU=DsAzFrcvr*U*|XcMwwCc&N+;Tr zVk0k@RP1$p6qt;YmM7&E->-x`A>mIE+v$3ao#FW`(@%o(+WyK*d&ta2;m8t=vF(t8 z;go~7Zsr`SnfycXOTyY^wykNb>NeKO@yR8wn=wbXzHpd%ii8=7RU=>&V3`PRNXM63 z9{J+v#oO2Xg(`B6`WzpDJ``vgcZD^*MQ^6MX>BH+d!M%KzJ#(!itsA|8bAh6$mc9o z*+VunnWlUr*1R{WKEL7ZOIN(pWVU;KJ5$i+c;&j0aK1{%xXe{Z+w-POhz{K29Y&q3 z>bgCh;7MNUTl;uy^f=_Ug^UXt2_Y=yOYH(BaB@_c0m0(A&kHw=v@Z;QWv;1nHTABb zX0g%r7i`KNHAjqYDp(&nQdorzhi*ZPr9&5rpEQ$N_a#)b)V==z2#feS<4e8q0!wvc zr9%Ywc30M`6I!1zqhK#H5EzEZ+{q*0fZJ=K@U*v=Ut>=WX&Q9xc{|UjL4Oa=ZDK;O zQPcwQkimG!Ja?>@@tv$%#CF~%(5%wNXkfOwGuzxoZf(*d8W@%}!z(^y{oyP&?mQ2h zUK{TL_?JeK+RMea@!ab-Uu1SXWER0nF>rPlWgL>nBm;q~Z$E@Jy<)?`cG?V+ zTOfi7?j*X}rWaf*Mv6BQ0){+oK;5zhaTj{;h&(lW7lv*8Wt%%oXfq|omG)w0Ny}U+ z$s#kHB#b=3MhgHdRnCbzr3w$ybf?(gnrxARumBBV&W*9g3Vye=-@tu{~y0$PSmZ>x=a*7Gs7%E1m<&cGBAQCuSvsWwQ ztp~-LCYW{0Eho>oyeyL~toF+!54tc(8u5hsWIHE#`?y4eN;+;%&#wATM7t z1Q5;ggZ=9Hg6CB655;d2h^{WBxnj&!j96`@vN3`45?ks?sC-r8O;6${iFZr}C2$rv z(1Fkbc9ZGbJab;<@E72m7M6I|d@*+SR~D~0Xm57nBm{(W8dp z{1>#ET+;iwYZgc21ce+KCanCNZbEnI19JbzV)`_+$q$Dh3dBKrUw|&xb z$CJ>X%X6%DCmD>DNjsA2*6e$ zNW*!lRb}yw#;K%S>wgb*IWKImvNIhzJ(0fkPzi{9?mkj*#0AQpLB__XuG;CXr`kV< zEv1nFhQ|9;SuRZQ&gjn@#^;O;p)gpscB<{ksuK9TSY2w`2=MEymsWAG)gldUA-Pv+ zA&f*yNIq#?zst3@Y-93muMY5&(m$1sj#U!>0ERV>A4{lOYSz{;+%L+~t+kwv^1m{_ z0bj~rl#+KSP!ApIe+}!pZni(MCRZ&yUTiVlS))ZMXGX~kRE9q@5Hqs?;Nu6DkH(s| zr>EQP@iNPAW{c%XrK3wLJZvOcAIdq%;|<&nat}1&zt^s``VITZEO@aR5pV)a3$v zp}L*QwWq7=+H|@ZT{ptQ+}Q0^uz1`k%rY;`8Vr_VR5A>xV0N(w2aeTs9|_%fj(-a4 zR(7^`HoA;|YKrdUNfqj?vKb>%$S@XHQZ@sUoG}E}4AE*j?xk(3_+whsCXYtnr^hvv z49O^;U@pqxnf9sj$t6KXez_Ue7*2MtD;3We#OmR?*L539PaWvLVY9HX)8&&>Ha7}G zeZ^G><)qrXLj?)D4n9yuSB$ptgkA%R<=eCjfn7ACP7TIZm!-yJSVMY$vi{LwC^Kmj{fUaD#7*W4MBd~Gfef*@;xxi3%U4SWi~b^b3tMd+HH#&- zlFnth@V%^W8s5(p%u+0<^Tw#*OUo#H9KZ3dYnSlX#4io_v&Hu5_69|Q!%(w%B97uT zOPjQfVuocqS;2T?A$I_v9i#i*tbQ8sPO+xzdKLYIvLv!aZ=_#Kr^X@Et=1rJGD$Db zlu9l#tlZ^51ERMhT$L%LyIcD89Xc_3-0!WfydiI7J|XKL5bo|6>CqEx*2nDv-c{Wq zMq`Ylu3sz>NeHWhl?_-w6Mi=MeHry{4tzaHE-cKFG~Z*|lE!fqrdcLc8C}9mZUhMP zxB|kw_rV_+{5EwRa*T+IfMahd z{{V@;FlySQmp&B462rb!hgGn(flP>Eg@jTCB%dv$m3Uyw7b@G7))l3%k92)qB>1`U zd3Ds(?8(%$i8R9;7V|8HW0`!k2^npVy$W%;aKUm9v0V5|N!0u^W2$OiEZcQ!cCcGo zM_^InxQHsOiHwDBI2Q8vGVV^K9&23a+G5|>-Ouqa?cuI&t!B1(6bV(tfgFWTFuo*0 zWXBm-+6l_~)H5tBBkbb^eXgUg%1wWf$0*L`AHvHYg1TMJ=&|tJR@cpRT3hHZCXoOV zM-58c94Isge}!EC7ODaQ-PW&;ZxW+_HI)8@BbzVXUl z?$$iF_K*0hueF7~fi|c1Sglq_EMRPlxL__@X<&FjT#bN`0XXBQ&R2J~_cAl@XU@>9 zxyK!{bLrgYgXvp7I`I>0`np0&)$ZyMZvpq7z=%D0)7>C+&6 zYxg{lEQSLLqL!yCWLk~1SCf-DBLp3a`d82+DLqRwOC-tisbn2KU0WRKWyf?mc>YVy9)c!DdA`94_8}QSJKGT`WgD=GmOv(br1DT6Gx`4joEnny)vV_#S&)VYBDT@;m#KMvhn+G^I)3uPiXRj|`-R>xv{SFS&aJRPcQ8f=<;Zvpdm zOC)xxQbofRJ4oHPDyzxCEJrxac*lofbk<-?q$4r_(GBrF>xwfFvZ%kx$|L{&r!57A-00qQaH#b@!Vy6R3_=hF_)T&y*g2n zzv^@TC-{x=7eb2f!*>4w3axGRTW|H6sJPx_Vu`dx85_QFA!6CaNF<%xW5&|u@qBhx zo;dMs)|q8-9e_G?n!W6@#XY=)Ze>Ktj5};QRHl5eN|AwF#oz4{@Hbn4T;F)c(?dZ# zQd?>EZ!5yFZw^?OP93*7a!K_ij&s_0f5tuq@h+DIwvB0RJ5PT#&G42uE$(Fsp-w*g zM;du*!Lnm3Jegdu6_l`;oIO2hIQg{y08nYZx*MJx)?)C4y1$EVY(}MdXJ-@bvIcu- zcS|Iy<}ie+aHZVjpo9=cOCAqX*SuBY4O>yR@y3%B61Ju;@8;CfVJwKKVhXYn=gZ~E zM^M>q#EkAeeTAlq+PrrfMYa5E1-sm^y0%NH6ew^}RLqgZBjQ$Fs@`vu+yaVf8?O~< zdd7=wp*Mx>=hd%n#Bj;I-r{#AHS*avZ7RottGhe6+E+C=R~l2hjoa$_8O=?vb=a}s zT~^;n3#>z@-ChZvI9f#1?h8AZ<{@E;*el=$8_ZyVyDWDuF*V<`X?p#|=8JC?jPb;| zhj#W{f^b+d+zR8VUrY>FPosEeQ_${YwTZ@~BRfhZuwN)7Y#R}(ynB&`NCSd-;{cP% z_}c4Ow!661F6@lb%_BroH!4X|azJ()h%DLXJY$?UrzsqAPlbVL6 z4zsRa>N28g4(Rc4vs$|-kPqNxVaVj+wB*-0HOz3_77`e@ zz66R66Cg89c_qi0b9*67vbW3CmyCvB4mx$uU!kljQjKM4BUn^$dL0&<@j6fV zSX#}(WfDh@NWm?HMnFKpB=LYUNv@Yw_?2g@_dYc>t6~KqHe}1p1_>F(d^^V4{^#qy~6w-QBkQ*Ds$ z$}?#<3OvS;GWN>Wb=Hq|BodON&;wf68jN8$8TB01Deu-s!=1eP*Hk5DLrliM)8`Rq zk8{?u9x0)Gva$EYZ_j%SjBzrMJAx1LsyC7}_U?-(BydMHz3#3_i#$tk+m1&(9Dh2> z*B}aua;!td-1P6__Wes_)5;g5dn z{eL>`Gr*w?gy?q?LFW1WdV(t^=fn4wQ<-C%74UmxcB(hinU?}KE8J#*r(>O;MV4kGaM_Fg9=WUA zU1jpxO{Gp$dWua>$u0ui!ys9s2WSiTxanERSh7aDXZfU$gZN-?d(k#1et=mk6 z7>th0Gn#wcqb@{Xfz(zS=`cpZSlQRyRf|`hoUB(tvDbHM&Bo@2n%=-%s=^2S3%ypq z)2*);?N-Dj!=WAN&1Uy7?DN$ee-<-DT6~d46p+u*k;ZE$8v=GP=bBcS+g)2?Kry@4 zt2At8;YZ=cbUL1u4eTXe5(wx>=~!2G_xfbJZenQ@A1hW(8pcRus-%Ldy!8ZBk)lij zv9ns9++0K& z3%ejl8-df}8T#!2*PX+CJYOIHj@yM_u)bvkvBvJe)^eo=wk=Lw&z^idmiG7O&%PPn z9g}y9058Vk69OJn6JwBZKR%BQ9FgUlCHs_FI!33XN@H^D;+_mh& z5P@Uba9sWG#18rE?O%>hbD^VB-4+XRJ-qV9TM096B?;~b9dprgaz!q}K&PbuaBfOCxFjyu(z8%2`ihs2RWzdHuc9{Kuby=N%h z0z|qtqLy;G4KD5n8!kVqh z8IpJ{;CRua7cvED26NDp#~J3M(5@FwmTB!8M=o3B4%iq3X9tX)Mn__62}N5%?2+B+ z_ns5iG?RIJx`SNAg_6=I8v+a#V#FQU0AOdOXWz$WCfjeO+oT~5$KSPw2b}ag^Pg&$ z!)q|q=G85%r%3QoqMqGBkerZL1p1S~&q33!lm)eoP9)WDC;LCzcfZ-=Kw~TN$lG}5 zow?{vJHG_PV})T$SnvP)%)kW5S*sxVvffyLC%Y&lL9&!rPT`oTkEZcWvZ? z2*wZ1S2T}>x>t&PAN{v&d2J@I4bnQ<$+e}DF&$`_IwNIa7hO|_2JP{1BQ+;)OE^(2dSvX2JqmS*6jF~>2JNJp7v zTNaJVhC6xOK|N0!kJM`TlUcs-KA3zgJT2x~PLh3&>e@(}a=Xq|Tm?mT<+iTX8;_?H ztvoy6ZCk{C8Phf0M^+Z9<|!bv)7j*=LN`eGL%q>ilolBSJRAz-m0EJvTR)i`@oegJ z{R;B?UOq0m@WfMH-pZmR)F*WNap6lOn@X&ID`i-Nn2yjw=ApW89o}BYec*V--LVfzH9rN$B~1jxrtqs2uT9rcE$$W$MWaqEzfIz3lEEY zcYhRr74+FGnVMo?w2#eFQ5D#T)NV|OlOHckoOL;W4?Y@cS9bRrc9X7J-RcJFJXo1h zHZx9)u-xo8f8Bz)T!5xR1{ZS$UUVzc=BF-KZkPW6fLcmtq-j45wQmh*cbbof+ULX~ z-HeuYFxfnlhh_+dGK8NYS-i#@TLBOTRRXrWC2Qgj3|ZT2y3d50QMJ8U77NI(jMLbl zk~ceI3H#^R3hm0P5ZNQ8W%z63CX1&s4;pHh^6EBLw(&?cOK>fWaon+ann@*DcQHl8 zSOa6R-NqhRJa6L-8^@!;_By_sbdq1(J>p$6vu=?*)S40|+z!UcK)F#F0gJtS{w6q< zxn!>V^uOF|^?FeEn=1TO(7aQ7b7SJ45b4+U)>fC|E3G%}9(%~{tN~OYx^3JG6hpVq zAQDY${5H}wscf&b$o?F?t%jRq(>zu>sEPE*Qbvk9qU>DB5!sB$Ng^VHfZ463{AkrY zNvPd;dsWp}Pl|Z${D+aZ_Mz2ff*_+M4NxbXh6x`wT3 zaeFDdxY1@eGRy&H!o&dtE_ay~uvK4-Z6}F?!nbLzYR5;??ljiZ^)Vf<+JS{y)>V#F z@WJ?KNht1nnBZrFExfl8JU?h?rG;{Q zgO#o=+5O*U{XVJgufiVG^W=%E-Y1hwn(>e5Bxx zaq}0%ZyW0$5_OSlX(ZFb677v)LzysgPXH6sJoUv{_>u7&Q}JG^_IehhdoXX@g^@7q zpal_>P&ffV1Ghf)weTIRJym2cADj z%dj-Ej2o|3-22;O2R>$c@9e?*D@HW8@m{RVuGWa~To_4FxzSf8MnEO`8D3Qeer%s; z(!L#No*&kcb$Mfz;EoG5l4gzOzOa$xXC^cYxNnI(+zo)soO(szzZ0DjH(e*g@M*#3 zw}Dx1+0sp{teeNotGMnU^!dDs!gOtJ++F(HqDsKL0)ABmq6{B*Blta!pG_G%Xp%l)x$%$9~g(Wb*2G(p0u z`IrVaa4=AiZFo<{@Ob6zb*&ai+Roy~%!)g5M79wmZg$EswO4W^cvFmZCpZ%7dJ)m} zbn#R&C7!MlTZ@P_M3I@2J%%KRC<+u8jR?VKQb{ANbJB$9}UYLL&R1z= zwDUu-^4oNoMfsdc>R8tQ0K>~)3;5Sv((L~LwTl$DM){ozM)q_HZif)%)3z|_;iQm&hBR{rYz*=l^do|HUe;Vb*eymR60N*zSo zYR{%C-Vn)mXjvmkH+gKuLlY)3!ADZ~Dn(6O<2Q)>OKSn}mxtpfEkU8Vx7F_?3k++v zAl_oc!M6l{poJ%$$2G$EnqL6;cUjP`EG!_8N3)F0ZE1F`D4y9~DDPEzW=18InL#BL zfB}vwuY$Zi;oGkfUD)_nRKBp8Vv!?(?!#H`j?L8EnH8Es>~~0GY=Yb!q}K7kQH*(= z-)pb(Bidcr9e0X!yRBMN_m;Z&F9%;rkcjnZZK9S5Rz0z^L={kZPz*>i0l8pC6e?k9{sYkTguAzwPPEo1 zv(lw#Z1t@%@9mmxpd#T)GKLJ~N*D-%>-VcD;qa9{IZEqmX#W6GoktBUSHAJD!+l!L z&eOt{dWe!~W18IF>GulzeCCx4mPJ+}i73&tGLT-g6bZ?pZ=+RK9JN$xyVTy18RhF zLNjdx$L9Ef@L$7mMRoAU!k!?TQ?t~do=1`=OOH5+(N;E{h==gRz`T=DY^W%W91Vn;Gk#w$_9Qv_`mTp z#2zm31@-2w;vmu8%Ex38uHB23jb8v|f|5552t7SEJ~(`B)U}}|iD?kGTdy|eTVyff zCoaL`KQ8fx4nQnGQa!Qc6D`4iI!+5@7`)Cw;PgC>quRe-;cgs`0v^_)yYtlJt5vpD z)MjR!tdkiqcNI+jA6_XWyMiQKvW8$rNX~k3>M1X7?aXKF`Hn^O{w{rg4waQWc$X~3 zH|z^;Wh2yPzd?$!Ih)YXo3k%K7#_TXS~-lP-54Y>WtA%V`|PqF@D zppx{!im@O=l2w8G$0LrNxjwws>Mg`ZzlPms*KI8xc8p0PWrjgtm~+NDdvjj3;{8)b zw9svBG_4oy2kj{%O3@rj8GvUh2HX}^;CdYO=g4$P9{y-xd4q45W;j$S+tlEmhuHP} z>)ZTa@V8X8(ri~w)@&{;V1g^Tg@xkJuuHHae7u6AhR;FIh`+PfidRE@Z%Nf} zFSPr0Ys;NJ>rz#FsCInw2aOlYdx_X^IYi~28rQMiI*)FsrE=`dyP(8Y3*fZe>O8N z&{V@4Gc#^GgJ<|ykIU(1RVd=$)#j~zZmx=x(OBm^9s3)>@PkDAM~3x#>-}$EiEJ;f zUrDpLk41&zGEN#PW-N%ZF2|JtmP81tu*le_@rOt8ZizqqBvW|m&&0R-WxSCO5XGm@ z3f;vVhCj4Q+ZbFX41yvAj$@32fWIuW{2|qRQK`)ZI+?WCV)iG0A!7`?l!Y@wOA{6FxU!|UUbJi5N3E>=Xi(^~fSElI5Wu*lNc+%oyQ zRvnmZuko-72#tMNV`C`u*Q%#4OMI`;6lFh$a}VKd{{W1>D(Ma3n@<+oX^?ns+S1)W5$8WKl46+#Z z;InSXBLXEYxDpxq)c*jqOX<*P`XtK+m!{e=mg`tZt!KKCWGD%* zVPZj2rn#@$Lq)al#+TtqXSIM|Ug*)>-pd^CndWomv*4%^yO!lJc?Xlo388q?$38ak ze75@5wEC=80hlbo-g)s8vZRkJq=Gq6!1+w5y9pbB_J7-lz`hi@&~&|b!#aJP!r0oR zZKzn@!z$fJ<$xsL9H)QF7z)L6&I7PgEA;OTD1ApB=QXSC{{RHX6HUsKXU7+>sNBJJ zZ=#9@l162PVgV6OI6MHXp!Lr^aZGoxHs(v65ux&k*b1;D05DO4lbqyj9-aDEP2+zJ zHl1Y+^jR@p!a#~i1A^J-E7S}hy2m_o*A>fNE}O{TER6WUP)}Z+GJUbzHF8O8ZSDn}QM;a?xf}vcNj!HQ zvsK}U9VkbwM3UUEmn_j3_aQjOS3M4WGs!&T6bqYY3p?8g;{b?^u@T%H9OtndgN_eM zrDhtL`h<5@9x=AMTS)$U5w*mdiu~>lduNW-)7@Q1s97#8)B?Pf?r~WYTAS^5&0?Mu zG9-$>D!5R%BN-hq-<@k)=$e8`(c8FT>*e5ngjSK7MstH~=3dfexhm2X=kF2v)vHLZ zQb4d?sZq&MoSM?sG^_hJ{rW}&4x%&8Ju*#ZMGeiQzGQaF$WIuTAJVjMnFMq-R?_-x zNUAz@W6nPcvE|4h@+GojPf`iRNn?Ixw_Mpi0q1PspZx@XI=c<_nPPU{HPV;i6hRpr z^yJ7ZiK{cF{^^pC-9`tO6DS>b9&u1yvqHo=X9GUswr0P!U`j$t0&veC<-+c)>#O}d z%ekBqc;?%0lHNP3ngo_ll!C!b=}4>aDS1mh{+Js>}Q*MXHp}LMtX)`wGo0G6?O+6hZQx&#+I$MESqLM8hU;55GHnD2Qw2d& zn#sK?_nuK>A~W=y+6Y`HM6<2Mo&8h!p)JM$C~rK zLIX9ijmbQWlsMzQ4>iA-a){KEM9DA!Nl;FLZQs=u)8F1^lQ7 z0A~iHZ94hm4<4Z=dL6>7N3F*+Opb&wUrLJ8T8XX-$q)g0?&$bCRR)-nwo=@dk^IuyT14o0$7^ca1k}gAlbI8t39R`f^cj5#a#k548m_Pk` zY#PR_7`y4P|ljV&7Rh4<_I-?g6XQczZ>b zP1D#e@Gvov{D{p!-WSo76Ah3<*DAzk@yV%{#TfdTkpa52eaxdSszJ)smKTxSpm?8t z1`czSvmJ68#eIEy(t!J@GCXKk|EO#;E)6i6kSgFf> zD=HfcnIp^^li+siQpsnl#6w%&ZuVi;otV`6a~|s2Mx zAYfIYagM(&BGc4JH78Q2@&Iw(w5;#G(0JqDrDI8bXMz=v9;r}4uUo9f53~d$uHk@w zhNYy@b~+g@F1cmE?}JR9NG7ypxq%%|1ZSmZ!>!tE+coTd+<pQ_HNR~=g23feqmHs?BH%jZk?Moy)=;ACzmv0Ku;MpnSG^46Pv3DPpe1VeJd#~ zO_R9<7dsC*KF!5SRJjra0ArDgY;SEk2@wEq;uz^oGfJceQ;c<~vo$6JG`W>B2LNKG zZK}JYOoBP$t8YR#VB?|3H6#;9lB~EL@+w*c?0oC?RgF)PC}6A@Z2R50{{TLAqHS%V-h6qP-&PxAU#Q>JN)4*gC!V|~z~y2hcD62Nng zga$d}0sOew)na6c;w-&OWak5@AB|s*=Fr@tMH&Q6yB2iL(bTCK`ecgZt_;{w}J>bAgVnu_$}OI)6n+r#H;2;i#G170 zsI(KsI}|egokXQ#WQ%BGOl|YBun~|CVrw(T-V^bc!ygDmqUqY5-HxTF-v}>^4AH-k zsw7EJ{oo5K6S%hE**Oi0=4`xWKDFW`5_qB`d@Y5v7RhmzU5eX*JZ15_Bz^2C>N(lC z_`9X*-es4GCb^A)jWvTLNUxPD3JsDGf)wN^A%;_qYsmIfjMbIbR5_|?Xkz~W!ck@M zGsh6?9wwGci+fd)?*8)APXbwRg_RM3AH}x=7+!ekj?Hwh19-E;Q0g`x50BWO*5!RT zUg{D_GD4eFK-)Gevj#$VZad|PJpKNs;2nQRvheMd>~_Lpbw=(|m;Rw5cVe*!C05QfCH(V`m zco)U`FNMA%+}Y_~9n&MYO*T07eNC<=wMireoT1uV0}-}Ha4>L2&zp?!KZrb04xuXP z{vKt!name2salxY)u9JtI+C%Z!ytg&m=0LtyA1=yx{SXR=F;^20tFh*w-Vyc&&-+u z1TQ3V&E^9Te<|cvPzXL^43ms`_?j(FO{c2Y-tFjZ3BsCMotD4j?+5sn^2f%n;U5p^ zx>}{ap=Sl#GTdEVLZm}5QtriY&%);$ve+wwu@A(*hn^UoPl&!I(AQAZEi4^urSQeZovKJR3t8foX1%jS3o5MWNRC$dr)DSRO^1T4 zN1KYmVWS1lQLFa8o?TzyZ45@d*17BYmb368Uma;)I`EJ7j2dj$c5!Rgm+~vkBBDLP z+2lykWlIR8RO4_ZOY>ek@f*kfG1PoHW1+?H(@#2uf*WYuShL*SNVe%KVp#?m5Ua?} zI+u}Hp8W2k<2Ki|8!rmz_A}Vtom5SxYQ|)e++4&TaLILiZ}Ulvee5FSGLR|wpTu4$ zO%ucZA=D$X^F$X*CX*Zzv^I_~vlW*=z1uRglFV{dbC5E5@OU3(UMlWuqLbI~B6x_) zNPb4Q!|&RA;_t(|c=WFoXd1idx>lB!nuVfT!V!hMqGs~iK%vS7Axe-6v3AZdK7IJ> z@vr_9Ply_hyQ7On7p@w4;(&$>0Z;(|D-3gxFnGoX6_xQ{<3^$4_@uJFy>w-|cZwy# ztPrrrmbhlx0-dAgEK~q{=O^Lqot^VGwQ-`o#1MjI6I!z%YycRz8%{TG+QbqR;2Ql4 zF3GT%8{+3lDRx4Xr!}dy@OR;Ez2ZL>X_u2(To`7#Q5>=(*x1K%kQ>3xarlgODMqC?6uj2o)roDz z9Y@1`CTqw}-r8H^r-u4E#X2@UD@m zXssoc)sCNhVG~`l`Ow@(CL!cUjggKB=0*Vg**IPT(5$>oVP~vpehi0Id+mDJY$07P zXtzl+#WSV@It5bhWOpDs$GGRMc(B9a8`i6~o?FH?U7FL(-e`@l}PmC;asYMRzcI1#j!Ch|>YY(M( zt@KMRMjL0-Ze^TXLn6xeR(BAov1TXterCqpO6|!60NYimVkuIqHSFN8=da{ajnP{B z!agm~wJTjk(KTnfTg&KdbXl3FxehTTQv^h4%S7fpF5sdw*S*V6hnl9F;cE?3Oo8-W zW=%Xkmuo%5k_h6H$axW>Y?$Q?g;)S30PX5n3@tO_$Hc!KYcPC0*8FiEk!=^*EN-uC zEMrq7F~}c$lSaAT;I{V31a1caU`?g?qfYP_#arKpIzNc6_4Jy+!#1fk_++@7YwTxm z3dX@hkgK$+kXzJaR)#tecegh7SGB(*SgJ{Ac2>9l01LH!M)OB?*6#H{Qb{fhDGWhb z_Oz}%$1GgB91zT)vD|aVoP0*N@TH%Oue?L3OC_bon)6%RYF3vj64umj*@j>?wm?_T z;>EIf`K!>pHDPqa#2O#ObD;QNP}6l-?=Gjj*M84)1O?QQZxRE&k*&c%6p%vnZM7Dc z@iIRd_>1kD-`S?PmgTKV-V~MB&S4MCK@6;84n`9tm@6&`&kY$?rBd;~p1;yEsHZ6y zULgL;@m7y-4wLZmAF}F3CN3{zNYO;?AdMXgw&}~4bwCwEup3F-c+U#>`%AX*?xT5U zW|m8TRe_%p;_5%`SqTWNOp5$S1j2BUAOp@A*c zndM7`P3ATb7~@h2Vdcuq0bmOEx<|v^65j8{dbf*y4{0|tTqTnoGUHQdql8Ngp(eJH zH;g(Ij57roQMmkpnAdv7(VGUd{gik)#ycxypF6Lh!Dss;-E9bEe%z1(1&G zO495+$mWrT5S%Dh+$7pI%h+Q)A^x{ZX;7(>Uj zlM(s8M)CmjINI#k`EYta6!;I|!|PX`B=C)ug^W7f3pKrlmuMK-uISN`LVVF-Uji|pN%AaPsG0tH3yC4o6UIjDCeBPZt}?%_|q%pMToq;z#Yqm0|b-H^@U!Y z={tI@6a0&ta*?wK?DeZ?-({Ba_9Nm27M62Gq_F!rc-mEPGTg*fqr!g*+o)`uk<9q( zTJcZAt$8)C5?xwZ={K5uGs}6Ts>b$=7IoS(nUJYi&N5Vsl?vdgRqQNuzY$;fZrjJ2 zKZ@+^mg@Cnzqp%N0!a^$+u%FX_ba|cO}{tFoRO2BUsUk+lc#w8KZl+vi%gbVo1e8^ zC8W;q-l)M@qe)^6tGQ9R1f7`Na7e=sDvq!3V6|d_k$m zZ*RlAH!^Gt3S1K`lN2=KkO6FCKqY`d; z5oKom;}f{CVo5ymN$u9N&Z#KOi{?m~%QBF0!5QbLZ_2W#)Qho|BicfcADxsI_4TZ4t7c2nJZxAi@DG3U z*02{}`$^0j#&{{t{0vOLYcyU7Nmrr?0Q& zQb7veu(N{Uf%5|_Zip~txT zR=XlBZs;0J(O<(I-NIYqLAq0x=R6#D#{;>qOZbPc>dB&7=r)=&g@7)_4d(A)L2>ed zg*jYcascG*uP)Q4Nv!J8A5HrBpw?W`TW*YV^$pM_t;KNY<0dE_@(0rybzuXUm04*uH4#L+gNH7+yqMz zDDxtZI3-=dzzjxJRda4#jBMzEAbB1vMiBqJM--T7r% zvG#dc!l?~f{tD2139NX}K+!%Rc!J6=5oyy(w)XxWW_#^kX@W%7vX!{~-t~$%ASPN_ zZkjL}P0{>5A~;G?o2H{{zH21i{_Q?!(Ms(dKY{PONNg;$hM{k(NwwG z=)W>=;`~|S-wt@&Tbsk4A=a%l9TsbdBZ0LoTJT=p$js9;HnPWH!UhrfEb-iI!MKf4 zwY1BS9cmU8qFTW$l-Vse3PVofRM(6`A#fH6j zQ*#K_V@cEz8)7pS8IfOj&Q5EEu({Ip&k)^Rn?W_ro|K7Wb$L2lk;=GzY(%ojVWr&auWOY7gGJ{$$X6$8V{0$*X8^F-@Nb8_ zGi7Ag+6RjxwZFH#gk5O5n@v2h%NcT#WSmA%&fAx2o!BIhO=7TETr_VAjs5Q4w$!Q3 zP5GVAz-(QUQU z_I*Q2({FWFnA$m+fJ0~mO(T+w&2X|A5MvRl5P`@)Q2bBR{7vGI1nQSAlWNo4Tf5HM z-HXZ|C2=Z7ke7L8*msnV8;(F+oV9+P!PT8QYHeEV>5VliEgzg(`}k8<_(GRUt4Nxa ziHyl+C08&KO23#lZs=8%0ryDD9)r#9ZtT-xh%k7_#EiV;bZ#?@n)(ajc9W^=DdV39 zN2YzAIOdi~JmVZ&B9R#x3+^kmN%=q{Yli2MkDaxRGHCT1n+PIgWM*jD;K@w51Q0BmEl-SXP%qH#}e)cL$bd1S6Et!Z-JT(Ue&t~W>>a_0ww)Z`P>uRK%djT&v9 zdt7di2!`L3f#|>t_aJs85)A^zODS=4os*xCl1L*xaNOsPw8L+7+a~iKHEc8>FWz!h8%OrAX|xwzFNx+!%kx5zNjg2=-I19nf$Jt?aX zp$+HRG_7LB_R&*Dvb-kIUJMw++Q%p5uf1~d1&*N6CrQ**6DWS|s; zNX$zEgYsd0dK~=-ucAH=YZe;MgQ85vUL^pW^#{MNTI9t}RJB8lRP<*X;=MLTg=B2y zbFi@eD~q~@X&LQUDwELXt$SCAbgN$|x<;7_amRn9d7p~3=oS9g2nxvEHg)%_!(utr ziIqN6FF=mvZDh2T5Lg}xo_q7nO!|EBvCOg%dTN9$U$NfSr8;vv0HKx#EZaD=c6 z#y+)aBqq*Y?!v{R%vwBXtNqBr{{SkcEvybix^rM3?~(kvS63t=AVZw`de&vltZgwd zvB}BFtz+gwW);ShrMNy+Qm*cyUq8<^n|I;(W92WWUNiTrs5WOmHZo5Ed8+qXT#_y_ zG1O#L*;u6ParYWs)MGGTzH!L)s+vx#K7p(Tn?F7fyEww+^&=eDQ+1`b)06~yW2vrx zUeTnAGb5=gKnyd`WPe)8wu-uvvDw<)-OCmfM%m=HPw7M4T-&Dc0`tjDIaGOp{JJ)jS~91&G6{9R`Q;O-;0 zeAWK|v0A(YPX7RSa#Z4}U3hOtf4m7^*{iz+%hatmiLF(9_5)z$jyhF{JW*)C6p-w| z#}#VROVaIN5l3y6BOHv>w)UEQ1c;ziB=R^rUV>#$?#XGQSEVuTl9!#RJ$6z@%de2#w-L^B4 z$9kh}1*{HFmaW(jdQ{JE1c!WLKy%Z~IHoRCNvU5MKh=HXoZ!_T?F*62bGN=mYS4md zeps$ua5|_T)KytDhJ>HryMMd^{#c~lhoLamB{5*K2HVLCilcdc(;c!E$vm&EK1*rj zV63r%MghV8hM~F8rFH)Rk8R`+lt(dAJ-Jg@xoTWuu2M_i?CE!T;G;Kj(zNXLV>F=} zJU6kdS+u74lH$@t>ww2N{CKMNGn--LU0*a#rwBZMKV9C^X%{8O8e0i~eex9{h zOFTI(44BXNX$GSkfOnkdp&cnZ4K_OCOtNDW`Cie3?}S%K;lkyf5%3$<8dx#F0X=%>s{Q*q}x z=xY|6MW#b8i76jyhC(y%#YTeYqf%)^CRvg#j%t~fyIAX5~jFXNzA75&pOVus! z3R*p@f)$meWZRY9oCAT#&whhFF<*+$M0ySAYEL!Je9J3;G0eN8xAQQLFhS#-arDMd z)~{%qeyOVJ(&<(&Z!Ocp&LUX@G@CNT5pk9z0tPyfSNuPuY6)j?KlWwkn00tg)kd{wKf9~t;l!~X!;U)WN_g|4nm&D;TH5yH7}o45z$BY@vCZ3Lbx%d1*D zCaz}WmWMsMdnJ8eP`}x_0@1?=+7U)ZanXU=dCqb%)aH|2)a~?d5czt=-QsMC5&|P5 zYDhU|9OEZr5u9VW$O7i2q1xI-Y2r;)gFD)Wnh37Z!P@Mh04y&~c}Ct~t)77ete#4|GeZ=4%QS4Q<^WI1pn{yi zE8ssA_?y8xw}@ZE^0mFSfy_}rBUyJ%3IGDH?_}K|JCx;ibr}HAUxvOT@TY`c?^x0; z>|$$on&RI6;Y5*@$txys8<1Ei`M5a)iskPB=1rGt3usJ!!OXDle1IKV_`tE^qZ)t57nHhLA$O4Sp2n-;T4<2vuPeMv++E7d@ZM&qh)z3Ovun?HZr>?E*atyta#h=sp*4O zwH-%B)vvFtwJm!809DqmmT$Jj2An2XAaNK~3c-}V(II?*i@q?Ua3Z`ase5+r?!IJe zC$XihczeM*LPf7#Y1)K3rK5>-n52lrVTMSGc}k;lNw_?lom+O+O{}4+-^2T_6j=s; z56x{GU1@7*w(-unwcR5+xr+cc9hE~8#29$Mz^xAt+r{w{UC=a}&2Hr&j`rTl(dG!i zT*yKch`v__IkB{tQe1MxJT1kxt3&~zO~Qdu>%vxi=vRq|}1j(8D*Y(-+yDUN;e5r$ZI22e0} z{tv4p>5dCXe9ygqua)l#Ii zinxew$ml*@-Kk*k^=kVkJy+xSFy@V{k3{g_hkhNwV+V`%4~iD5EY>@Fy)xHQ2{9`X zg(8p0V17_RSwT{}S0t9m@V|`SG@ryCBDk}$5zb*xC+$-v^B@^2z+(%5NyZCgWRsj# zPl|sMXKg+m0^3x$yt08jnBtcRS&~L3KnGqx0QDmbc_ym-DA4Y_XRb__5ty|5OG%}@ zx|acC%D%ypahGARbIBleJpC?PmrDu$(OOqsJc+W4xtrlHguX2C1>c*eX&3ifTXPYcF)uX>ZfnvJfLrs-ZA(=Bwg5JtW$(lo{M<@-WNgd~ND1h8@lRpC&V za-fRtehyyvcf&pqeJ51bg|+(J>GR#&z|oXck~!p^TjwK?fk-@tagKQ#iLdy(!X6#H z(W20_{ZCR`TfI+K{?M|KP5i!1tOZsiMv_?K8jGUF{F8DD?%Kt??8k_)H7k2MaaLcC z-=N&t!(IF8>rB_c*oUQrq_xg=B%42w=;ZB+2H`Px=pIV!48Tn?w@WqCSsjQ801F7?4j#%f0 z9flydSs7K7mtyk-F{;K*S+djoBcnu@$HKSHFSVUVTD*;xOQWjY&hul=l2CTAGPId< zk|P8SvF#px;y)aC+ru-rg5tEZ)Gxect6XW?ZTnn#BH9u|BF7<8mh9}oLEc>NB%hR; z!quDhh`8{cyWmSpv8&t9bN!DD)_1QYT0+Fk*B6NU5Hx;7Gaz@`c9Ppm6$8V=Wth6w z=9-Kjo{!J-{SLJ%afiLRZ^6Db_)}xzuM=s$CGmar^j8o?XQB}>F$-7Q`{s}+9&3aJhGb8ji#cu59s$}s&*8s>Vut$f zTk#FPr=~8KcEH@-=x-`XZU)3VRF_uYjnB%elajcu>rVKG;b<l56O37$0W+$vJI)+7OkM(a>m~Jkm9v6KdKccrQ)U?Hf*n zO!xYP&_{0^k;lCyI3oo4^570PqJW!A*Hd%he}$edv(k09xwp5HNM1c>OTV=8qC|%i zGb1~V>$Lf8xmTG0CHE^1E8*vb{8vAS#Ix#_&t)UQaV5pg*P8zTYx5syBxjG^vvbGG zh2*VY@!yAhGCm*0@hiiZ_Lo|+#?ai%)=aFH=+bXiZ2X@rk?ts1a5>4y@-Y#Etr$VH z-kM$g;*D7KJ;y`1@B#4KK@OdN45w6@Ykgu#p5oienGmg$BC8}(r`EQ&WUKwLQ|3Z~Yz@T0_@8?w0Zw~u@q9;lZHC0#~O z5vw(_TdqiwNJ5xbGn7D6Bg;J(%QfUw$+>I({xFl_pQ1PvYi1e=#>Non9so|S#M^HL+ z>3bxWk=??wNWrc*5|T?M5d5xJ5vrb8lAj7RjW@#j!LjiUqb;T0ls4Q&qj?NfnklXj z+&hBI1G9x~#ni|~HZLBZ;`<*9+jv^TO7VMWvgykl*QsNE-gNV{Z5T`;05-r*=Gp*l zykz9_;%eZqvQVa*y{`WN$$loWyrXl@bPovpIq|-f+DC=_X1dcE;bC(WqY9Q zl?4Xe9$9zs#~lujuik1pgnD(KiyA*aRF2B(-&C}7J-kWf`HKlazG9+@o!MFTmQr)H z3Z*B(kAa>7x1IEl1umC;qDchN>adrNONE$40=vkJuOh6TXl=)lD~1FSTly!2?X@oj z-K~zXZyRZM(!lq3&|l_oTsO2 zKMgPZ5oZ1;)NS_Z*Y=U>7Fv>DK&19ni@Jdt}+UfSlih%iHV{37>h}@0H-MlV;j2}vld;484#+udkpQz}wSuA?J z%$k+Fc9KfVDvjy;rp>8E3OmT5e(A3}*M2MOejD(O&x*V;a|_P)Htjy0b9mP;8;IbD zz0?duX(I&Mp$l(p0x(pbyt^yK)tc9u@6CT-aHlB!lgj@9YQKs8EuQdrcGt#MnwX9` z=9XCJEel)CFqJ|hji}quyI>EP4V-X(bk;6pvpuidhI6mVEb z(@NdXHnTa+Q&4NN>E;v;qn|E#1={%lCR<+?hfbAx)(In3i3*IKatA$dD&-{Bg0`Vyr-#emD*=IoB&quU0G_pdOcPtI z5zEL@qjpEHT6|0`qE(UtHi4bebg5&6OCY+IA2mwy2^b?Dzgo>FxuRMW0=h}HU<9iG zPx<^aMcuQ*EMQ3x7#m2=LXq$7`R2Fgv5hU3;cYy~vw}+S52xqFQCmbHA+?U(+dH=8 zkEjD4-%4AT7?e{<7wXp5aj9qN)H;!#na{ZOsjT!bD(PX>oCE|0JZ~RPnd7Hw)`MhE zxzC#WcHx{hdEkuq>OP+I_^kD2xM<_IW=D)2$W8!mMo8nhKZv5ugG%OI^^;E~_>whD z;4^%uA5oLxEx9SA)!`BruQ zv3WABq%tgt6CWv9Z38$hg&i}rbn_`92$Mi_LVHcMTwbXP^Bc4G0r*1 zPCY-)TiBZxVTRo#k9D(-$+-2&1dnl?^Ipy44+!b^-wI;!1V0g8WR78*OO#^D!)Qf> zk@KNb)bIf~3RKsPSl?N^$tE1KutOUYliRmy_0JZ3IK8s?Ii+~&!bD447-bJIWRg!d zK#Wk!xf=kl2%{^`-M}}4n{xBhysdT|x}Kl=HQxAM9VvC#zh~yub;G4e5Z4!4yox*M zVu*#bX#CG99axFjp(Xgjafa%=H{)L)d?dcP_@!y5Xr3R_W|+lwKA~r4CDbuV3`8_A zxaZ7uh1zyvUC|mvbzRjj!2_m8@H0rZ@RWL_I+vBU@QEh>07dhsl2Cleihk>CKxKb= z7BB~^Xn0HEcZKzT0^E&j#Ya)nKoi_u_;*h?M&HdvV+@HZFPS1Alt~&%4&ct;G8h~4 zY*r?OF%^BH(YtEfy7a&3bW)UJ`dnWYd}*`Q{8fLUcy~hn%ARSGL#OB$GQ|TJA&w#C zAyQ*m9F{5>nNHvvXk2$1P3MOEH>K$IRyuR)cJ~(!W}X?NwzSi3iw&zZZ@X)=yGa}8 zJAlDfBX^8zI){LC-xTT+_@lv>wwHIoW4DnnB!ld>>;p5#qE%KuF2&iqELBPQWz3fI zc%CcGQ$_HeyKiA*DoJfDQj-$g1}`IGPICziNY5LvN%{Em>fmEi(x&-V`tA4&+B>$- zTi0~dz3}p;x!|ehR)#dvb%v5le>p9fG=vhZ9O}D+Gk~oY?d(V(R#cGqHcM|h%IXjF z#8Y)6m3O;n;ttG)Fj>=c2H*1lLXxW4-OZ1Mw$oqA(cRohWi8ss_S+St&T{GIO3u>k zDK6H^5wmX_cn5CuZ5e1J9%Ga+qbMvDgo?;X+*~eH zl{#xl+!Ix0YadGf!yXzIzAe4@pEuesptQ1U8<*6?0_HO8WIj$zZ;>={f{eRJgn^b- zDfI@e;#~(=k{Enhpv-KJ1?i_ z8iK-R*w*oB?HIR~R*G1T@Eq*Wxx)J5=W_FX3HSMe6DtLYKk%I|KHO<=F2 zDqEP0o^xCUyfQMu8nFO^_;))b+xmV(how&m7bmIf&`vb@Pn~`tU+De^{id%kKF@O^ z>Y8J~hAna9B54jvv!fPu`D0@qRhRc{HtkS;b@+?n)8UUFY8p3# zw}Z3-tPdxR#GbY8f3PAFWok}0^57Y7lbUcR87oZ~;0HtnUERm^Uier{N<4a(7g%@zWkyXF-Y2-4a9Bu=S8{@VwrX?UjVk)ApBuP%#p>R9NK=85I9TK$e`H2(lS@}~nms!b;3m_E;O3bK+x za(Nvp?~3ea3@^%(SAxLw?fBL`yZx2?(9CnxIVQcBzG$5Gvo%C0frp;K^Q^-9Whk4Cd3y+j;t};f-5^% zg{HMQ0o0GX?OInNe=h-t(2A)fK4fJkQ-jA9EU280iv`7oyom_Oken$v`G@$|p;}tS zaRNwU*u;G4*P7!mWL+;&OWcr=%oy|672R3lM2_wUTsj6;4Z#FvohJE-s=Ah}tgS>0 zGnV&0)n4k@i522)qaFVM&lJr9WKIXG7yQ_2o zagLQTKst7mkGcu$aYe1$XKSDb@&r_jtT_W9if5F_cM^8`W~CvEcN$L_`9^xKMPuLT zDJmZ!Kwx+kx|bHxL$_}rbKIYLp>-X(lW=0EIN)=SdX|;TO{8V%K4fgs%m8u79;4Q_ zE!TO&AvoxBn$N$on;&bnm*!r1?Nex4tXGkk&P0)%I-bY;C>u0Cvsu%4jP>I==Ae?z z6D+H@2c|Js_b`k7Wc@0amK(>6tg_oSN8MYf$v=~G zRS_?tQm<_zBJxh&m7w~3EQK75XPoz@K8tR@Hw3c2 zU0$qkD|w4EK*T(&kOou|yGp4f0()`IcM@w;>G!r5UKqcXE~biDnby$)D@H&?MkjU| zLT%{8WDqcG@T#@r&B~6+O2;MQPl}eB74$wG(shfewD_ZqwA+iDVHtD)@>g-#a7YIy zkxZcRvGu64=9G;{N~_+}+P$Ev!GYW?Otb zkWF%>Lq>oVc0_@R+*E@qU|^c_@lwLlgOYytp_6eU@h`(IN^Mrt;dR%Aw8MXGo7;VA z)s)9~2obt`#O^3nTNyv{(4akP39fZ1Or8vfK(f-U9HhkC0CGxy+l$0xD~@^C73Nc#G}Uk z8`2Wf#d?|4^sfpv(&%z(DI8z8cQPAz-BF8%Do>Kcg4>ANWIMc>UTG;c{d~-&C)C^5 z{4L?H6b*M?_;ceVx3|$WsjuzrHDI$Ce2woFs8;|q(kezmg=J8{ka`YlQSr{J;_)!l z(@+B8;fi;`Gqwd}HC?9^dHkY8PG>xLr3%7jRfCTDv8*M=^sDKymVU zkW05AWcdRIBO{8}EwsDu2KE@klHN}4*^^;*L(r6eF&LbJ6Mk1aPtdyb ze+slcZM+MkY1YjnZMgejk=&L>SSi-4012J9#s4VOO{t+jFd`+eJe_T%xYkHrREVDEhb_*8&06*u$ zA==Bd-~+jiS8j3Z>8txG=^iB01%w)&urD96_96ItXW{t%A=yo#=#y&+2ubf_xwKIrfU#$|P+Q9rq^hjFa5m$X0=+9h z@T>T5!(Z^1T=+uqC5KHG%X4?IJ+c;wt>Y|L<^9-3+*d1%WbF%3S@=80x>t=gs~-h; zXHV0uZ{`|Jt(D8|dw(w4877kojI5--Mq94j0?%B8fAFw;0coktd%Hp6%@XSSPnyc(QqWe&EVkCr z#A123upW9UtV|PUI}|GxOji@Ec<;u45+=Ct&aJEIQQTR~B)G8Fw=;-Q9#(M4v`H51 zs{$8jE6E2n)OcILH|g+`SJ!^oWA$bjD{i41jX}XKs_-n&4+GOAS55K%0OML{8pPfT z&~*jWB-6xJ(CUvDl1zwP7eTm|USkJ$R!2P;SBB}{3f25s;u!5^mPuAgw~#QTDQq3N zBa#93;=ap=vRXK1@s)JCTi@?7kGviq@HVI7Jx}cOO)PM}(j*X<+qj%$5&<76@6CN9 zC+zRxF92(H-w`|y@dV%6T|{O}sPwSVO)EHsT_Y|x#T=}zs_3~ABIhi2`cLe$@T>;R=z3HE$%K+?ez;QrHspI6mn+WB6$`~stOFKq( zV=BuM?%$oRIT;G0hEBZcsa1A%dT9RuFCa?mQ@in$DU=oKq4;1)^Oz9X`LKTQ%eO$5QZ~ zrJ?w7C%Lz_xV+P%wYIjG&yp*66vrc{oJ>>fkSc~4kxAT0=e`>0J`UD(3oi+1c316j ztk^_>uM=Vmc4L{{X@0Y0D(GIzJG6M)0H_Exfb7 z@at;UO{c|hB!**Yb!QLB=1CN&1c-83N)oKaSDXswJZq%u8l{A~?}0o!powp^ud>Z) zpzX17B!#3i`HrSrhiKvvfbAv%%kyE#t3ElklU2PFj}O_!tKRA_bhmb{u|+g7+$Wf+ z7-N(>QOmYivz8nYn!1J8igo`07O#metX^vuuuU@5z_7yh`v4IjJ4;BZ6O*--c#%M2 zLspn+#+tlVo^NtgZehNg;Y3%o_`RcCX&SsH3!OIF&`%piWlfPcp7O|9LKRgdRRauQ zFxy?H#UF;+E{SDluGpOtWw4aoTsk}k;__KUaWurJ1xzP--G>Lv-GS1$4QAt0)9#_t zZMEG(!ph@Rx{p*JZwlMYQY;H57x-P3$ZTvQW_itD@Vh9v|3&@ODQ#yi# zxCTaNAeL~aZuKM_1JRUMOTt#IQC3wfzn69Y00Z$gijOU=sj={%Q1K0qjO5%P)htrx z?%w*{HI#+o$SP#cRn_pYw*z=7j1mbx-KbsoB ztIx}BitGLy?8DKf*S=nid_TI=t~^)pM;F=opB(&4_;=y`G5js!8#tj6;#nfHLp)5w$z*0wFi`Cv!kl54IBaD09~i~t)^Dl! z1H(5n++6@~uP(qvN#t$imNYrou`JHy?fT}qJuBc}hQ2202gPvdIJ%nR-gUXQyk{}M zk>Eoj0kK20a+4wFEO0r+c@!mua#br%T)&U?@*PO1%F!}BDe?Bl#6B~*y72CX+SJz1 zy7O9=+w76q#O0JTE0jX4?!=A1!VWD9NG@bxGU^sc%LOX#{{Sf@ z0vB;n9xEqQ_<`^fSMe6AH64EMPtkR7FEj~sh<-;B9m@sD%5PIAo4g|h#DHwtSf8Jx z_*1TG-V!%3*jw69Z#;=9dk0;{ONE9c-Lq)Ha=2y;3lp`gt?{qy_wip#*X=c*6nJAv z&~0=t4XuW$eQACDqYPIz!cR4rlZh^7%N?% zmTkagg7bhej90&rWEk32RHr21XDKBUlh+;YbvboMgsaXlP_Ny7;NzZp{&k2vo2HY? ziDQreCNZ8A-!facO`836#>5|#XE@^r@cx;iCYtgibuF?ObLC3TpE)H?2TbFG&(L?R(q??9 z%DU48jsA@Sqbm@~Lu2d6=~fMd`gD=n-EeR=#~3At*CUR#by7Qh*H%i-PE{4$s2LdK zd*tvvDxtl+v@UNhQC3{}*^hG)M^Jkl=cX#sWZP2Q@FlSX!4M!5<`xV)5PdWFQt0}Y znHo(LmoUg12gxJvpG@}k{7q)u>I)=mZa17UV27f&^yy5rw3^x$p5R9m55!F)E_0rq zy*;RV6qSv8$yp{rYj)PLK0pyNG?_z zqadBs5DxblQNiSJGoC-4X4}mZN@GY%ow-Iv`EWY(_#eu*WAffO%81HO9`IFEmF0%h z-#K1`oE)AHHEt!*R#sCdlHd{oDQ@1MhbO1COK!y|llXeXNq-c+aoVm6ES#xcI3ylA zJOfj< zl_Ir93d9dN0r~Pd@A`XJr`>#C)h6(|_&)ytL%B<7E&Qdpx4vWMk~W5T#Ahn3s5xfn zcwd(u4rzp~h@C!FqIYHT>U#I=_v6Q~@L!#!Yf;S5$1E3CH*h07EOv)zj^I_^5LpqC zgZXl8ZfYDl03adB2|K&jU*t zI(2lDdR;qyK`2#mx<);wm1nEjKA)`kj^zcURG2y&0gTgt7=l{ z#J%;!s;rT@C7NjfhUuJ%D> zxV6(u6AZI7Ztk#wlnkiE6$InvYdnEMCp@!^YIBgOI0;ahDdP1NADOQ~)qy0*>S&VOEy#|r+cR{eyb=dqrr|YdH%Ry|BGT#fQ zWr<|Dy=do0V>o3t%47_FZ!IHGZpJ)!b*jbi^7Uc8Xu#MYJP5sUHguFAQ=_kWFm4$)Q`K zPu8%IjXW$=HcQm@BTlTeF~4b#hId{p_(d+Wpy{@cX`_pXbrEl&LksEBq4MT+m9I&= z3njdMXOyf)**Gj2ljWZhzJ=od0EAL_rpgG{Skk5z*Ap9yZ~)mGGOCZ>$Z|t5eu0;2 zpP8%c&k<-p4t!hT7<@@<<6ReDpIGzs?GEcr)|zYWMpT7lOIRh0G%pZEl*&V_aH2c6 z$-h4&_-|FyG>ab@{3O*h=*^JC|B#Xnb) z)t4rY{H;IpJiK%)?9t=1-QEbE-er+dhUnRxlG!-uGtd73s}$>5Y$0{GhBl0&0L707 zAY+050M<1X<+iD7d2tq@r(9ZH!zLxPxKd0+mST*D1$O7Z^s30>apzBSAMZijg+W8d zY-6Xdu1OX892#*=A2}_}Z?j!9%oYIKhUFe+;6dm?KDesUB+Bh)BEHyz0}BkQlhmAo zLHZHzRhIf&31SSYK+f4Ra;F4iKbQFSspnLZF*I|#y135yT|oqV*<}EG0iN}wcNNUt zS7Y4^XiG9OHVXm$*2V$kbnEr1c5YDYQUi3ufl&B|RD~wByRrGBGYFq^7VOx;J$;W( zI`dYv%ZF|tDoYMj`qqhDM`_?4a`R7|*DsaW-7`KP7y|;TFF}?r#Hp53oDATarab0w)8Sa2$0DSX z;E3|=kOoCnd)Xf-fDlioIjXo4+(_{-3UiUoLh?Bo+mbutgt^?HJ~;IqDN<5j%O!An zj8SkIB#Ph(DTUlr^P(u2@ni<=BA2E zh?gXN0<|!1>R565R8d1Da{_LMuqjZ}xoMPVf?HV%!h!dkbLr_>H=2F@h2Yg~6^0HS2Rnsz zbJ`pDS{G>DNcn+U&0R80Dkg>?SqV4{<+wjuMv6+r+I7{<%B$>Rgbl0*TDvWgWZXJ? zn!~WwPJ?lY<7c&ZKPcm2&lS)`ty{E1D(o11sz)@5YQ|;WlP2FeCT!y;7^>+M(Hyzp z{{XStw4}XI#g+oS@rp*&ASv^4$E`(}(w%KN00^y{*#+}g(mNkz|IM+T>pQMZWi zXBhNT#YopyR}f-H19z*8;+2{yHkp;>z}!Zv8`K(>8#tuIY}=1>-kmMAl+Dah^^XNsvD*C^#Bg_LgXRwKI#yIMh6)ms_|sFen$`=s8ZR&l zn4+DDjFsS=le7ie0MFrH&lNE9oKsH6WTA9@4e$$AUj}??)g`{rV20#aLk)(VDw8F& z(io)Oxf_zMs(`U&Qg;w?4SF|$yji5`*H?cIn@^cmd+W=+S5dVIbv3l|w28eYET3ou zqL2tvhENFIy1sX{*56aPxAAITTIzQtNft85%%r;ql(a;E0$A->aWmraJ!9X?$? zDRkMb)?gsirV_}~w7>(F1}KzAfCt%xoDxXPz3`3YhlRCG8%ptg#od*zpB;o&HnvB~ zwuV^*aTO%9NwK9FCvHjU$i*)L{7Smiw4Fvj7WgLW^7mc1x{~%gdvriVicn5L1IsxQ z1_L4YV<4_i1NPq2+C}qz49%{^8&4MMJ{`J!S4zITu$oLm9qURXj#zLTAxPX?&Wm_* z6>wVs@Wj(2)U^^t$BJ6;T(m2B_GyooB11ea_lZ&@+Zrew1r3ax0a)6<#5?U&EuH>} za|3ABEoTfD7XDPFkdYSP*(sGxy*VJBc*T2Ph~5a%H2E~MrcY-*&G;E|pN)4!m2&%{0=)$T6z%X@`ywy=tM2GeYU0?)K6ZF1@gBAuf$mS_GUC&KTE z-wI?p5b-vzZ((N&iR^D~7#Sd$q*4of*=`+Km*xi`cEvm4r-rU)(B{;%?-A<%0BX_a zgijr<(-Rbz4DpQoxp3}EbGZl%ag$#wR#B$foGouBV^3uy^(lC!%UsZWGbOKwb^BQ7 z(jqghNb4DP-R_@BVWPaAlnNnaFOD*5*QAd_;- z=4}ZSQXC&Gg0U&M`E1NvAOhX)v+&2n{wj=kqd|{CvAH+MZ#6fJV(JGjo^p>XG9Q&V zW>NQ-jlA%`6ZHQ8gxa2ic^`vKgppbOqB-JE%jPED{<=$jgCz5=<`+h>F z(UZkqCGnSmbpHSk_@BZS*H)?xo|CPm*%uSEUuby*nP&^NyxfvBgLHMp(L!yJbq);P9=NQ__*tHE!VJ6E1>;uq~eH17=Drk1Z1w-%AZZ34yR z%3dHB%>;DdgN&Sn0AOTS8Sw|=lj$)J4(jpW-Pu^#Tij{3i*Q0sbL8MND`$b`G3mSH z0g3J84XgN%#hQyr1Os!w3A=&y&;J0g0=|zd$RmkLrXgP6am)bAKs3MP=ebt)9dE?< z?RsL8euG5wAcr#+>>B5q+`C<-A@;TQy%xJasNbc`#?CsM; z#}=Y)r^Zhaw~B0sjXViy<|NUbdg+i0YpIf1p-qV8e9KbFY`JL>1W+C9*&y`a8~iij zUkcBAYvF(F)zfrQZ1S}DmPjZ0M6tXe`HO9tazd47Wkv@Bo^!&V9qw#AE8*4f_05L4 zHlL;sGS*Qa+R0ojs`3FM#GfeI%06t2uOuHJ@i)Zp8(Mg5%X#7*OH{wpOkZlgT{uf< zC-PO550{Yf$cRo4DtY9g1L0}mv3QJKsmGGqTUUL3H2(mCX?R-4sl%u0UOv)pwa*6M z*t}BTNOWtInmFT-tno#$fo>ut9f@PsQZfL|a9ho;u|0A>7!uy)~&wC zBnukIjXZH|46+w2RJSXSnMWBO5Aj#UKMi;lG@WwGQ@0m-dulpus#wkdb_x<$B;dsE zvpO*Zw$>o=$b-f{9`SvThBT}H02DReucB&tit9J<#cQzIh2I0P+(yy_vnzpxWOv>V+v_fDOPnIMUzN5Y;CdBITR0!hN>jNp1+h_a1p7V!T7gJQPO zwV9%OO+#2%ibnfL1iD3t@>W+d#L7_^0L}=lKZG9+CDrUS*zRG#k~sYP zR7pxmzF1^CbAV9+7&*Xl4m)=~Ch;$cd`+X;e{5VQm#Jwn%_R1=G22|(TgxD}hE2hl z{zs8y-;x(#I1RSFKSKC6x((*6J``y`@Q~`-To$nES9emR@Z1>QQO4o67LiNvyNOMQ zCyYt1{7UfFg@2~#z9+fx=8F&ZV%%KmP)Q}mrXzQjM7CgnsZ32F2)NIh2_G&i=Bs8@ zE8^6nPVe#ij=55)80vhhFU7wVnY63D8VNOpwz`K+(_a4oPTd{56SSd~O2~%?oHFEq z7~m5^_?zMl?}=g7{{Z10y#~urSXNIiNXM9=ODmQnlGw>y?Zz8wqvo z9#8Ce-W{k%=?}e^iOJF>k#Jj-ba*#+7)U>@q&eu=X zuA}=%wRo*#f=hNpj4lp#$@|WwfRt`HT#k3co-)zAA@M&@)^+%=Z?C1*ZUgD|(UfbS zoJNpM9Fg&nyp;=qkC%`QZ|eRa)_h5(&3UExQrkm&jbI&KMrnjHTf8JRh!~QCh_XNj zBa_D3?Ws}Ll5RFu-r|euXKG#~(sUmU%O;88=wiN_LpG#^-f1kYVUPm5LXG?PZUI;T zWngmI0}y<7@x85;#+RsTXHSn)@@1ANRxh<&kcVnB#;vtfxB8&KE=nG9#6d=A?c;Jz(@Z-Vqd^EqevGE?80JYRgtLu98 zlFj7J6hz4IgplpR+^U|V4;yELos}F1vTjzJ``NT=%Gxumu=u}uCWv**Ux?Q?+QibL zLE-4_q;EjA~9vAp!d7{`hlNws-a-@-4%@Tmd z;Hzyd^Sp?eB~eO@1}&Yh1Nc+nMw0evAB-ill_#0(FEoh!!?sT-M4-0{Nm*60Q~(gR z^MzVICGc&(j4!OmiM6d(OBiNjV|5+Zk#O;W5QWb1C+^-`hEO=@No62~@#9Y{_N_{t z%}CQEY)#F7IWD4FMALT=1Tpz&TMFT)#s zCg|!K&Y^j(%+j;Hv<$Jc7xMPYzCa@bU{cS?`IqH93fSy-R*|@{F;1(>WEW2x|_=Bqc&)0r5(R@*5@rzH^ zF10I^xzu!xGfI+sn_HuAZw1QR0(_{1*M@ob$u1yWvEo9?vHbDiiEjQU>9?AF#rTf% zNfxH|>`AyY12X0D%PEmufsB%K!RvcL@CU$aJsGs!C&d<%T)o}n-py&Lc_^0QWMoaD zvagJmMp6r9vB<7TU{xxXo3sAxS8lI=#MU)q$!=Sn5A8YNdyQMe+Mc80pAvXwuc4lM zqi-?!=82+)21aE7Gc>!U&mk5@!xv`9#oj5qw})4f3s!_Ow&fA@AoGF1z!}HoUc385 z>i!1PbgLWf3AI@gS?*RvzmE$l6C0z#+5PG;`AH*oW86>Af#D4_0%>QOaLOAm&N2b_ z>-tye94&^gM+xuAwdSmF)oN0@7HgK8=X9vd6;41n`tw=~EUc>pmeOy>?xNfB^u{`I z#X$xAzLo{V5Ui4a%RT(;80(Jb2N~=~tu6HJe;8MRzk8D^DwYIu#s_Nq2&O{VtE${w zqZYl7Y6jWm;BMXSKJo8WXTE!2u)<_W*d59JahjG}^CYsx6|f3MHZpEp3}+slKT}n1 zq|@Vu9kx!+UHAOw82JL@p1d(XRjt;QS$ zazW1E2`7(WeYmQRqUsTlHG8y-Zu`hXj1Ui~&jymc$}H)u_p&ogkgAX18BxFvcIUMbhI+TL!8*t@FWKb)Xobj|@d=iK$G@!LX? zslIU0h8dMk83uZT++(rsJ9Vq}I%bU{8EvoT5w1$K_HU-|RA2`DzrlOy`dH8*(#@dLQeF zs_PmA!7ZVRQ6^6Ijz)6dgC0JeGn@|8#bUms##?_P&8^Ny%vpki$sFe+^XpHudwXp% zL8-b4ln*P)lwq>Kas~$glm0cIE}0GZb<=-y67h)}pQT-}&?Ac9V-TT+O2+vNM@;&4 z@6JcHEdaBoI)yRKbt1c9NBi!+<$LgZW36{$e;jGv3A&$0cQz7RwVmj@gif(TKIb79 ztZICj7&yaZNL7H`D}awtk`((qB}q~Vasb{v0sjCdzJ~Z?;tvk^md-2EGc9UnRhDg1-!G+0gqAmJ7ul-m*N@Gzp}3F^jFZO2TQ+_ zdy6!)Ga;Om^Ab6X^8#0Rbzil+lzoJr7xq<)NxsoKi(=XApj3h=)hz9{(5#@->a(r>kd)NbUw`!=hm z!7@d2aLF0CG5z0=gjvHY5>b$r402Xm&x{@?_@Uw}Yq@QFIcNQuKa(Zxt+PiZ!9|G4 zDu)ctvm!IiP zm2MW<7^p-`iD8Z7RFU^Yva9WaJ%ANbK8O90(^gLy%cW=@D6zKIu3kGMsX?c-(#JHH zPUp*sV=5z)49tqSEgK*pM2enqFM)g|CB&Nkjp7|fU+njGH)i%CvP0&`M0YQNh;fXu z-1*wyF+BTE>~kiceep1Or$%c{YgCf=$&qhkSB2z;C$>k06oOEv*`qAj$Z)$?1&YH? zSnPc`wbf~E-S5!T2Zxj@UQ1Kx?LvQwbLx=Y58I>1dgZLzu+yz1o8caTsaRg$sVde; zmVO`e6oVY7Rqg}E=mT=BwMXJdi~cho4J7h>b@*YXc$V_Ydw)Mo_zmJ=d8b=MGziNY2rzh_r*L0H6^8uSVq~O#QLVStgfwd@uO6;x$xDh4TDwD+f%q{*La%B$qdaB zpo}5g7?NGyYNdJjtU^X=UN7Yh?Y*S1ql;ZSH)P zjy67LlOsr3qg7b&zq3%H{hDq!w)RW>k8ee-#MJ&K{C3o|`J3V=!H)xcLDMwYuOhqg zPlh#3Lqv{Lxx{TO78lkRk>9RN%+pBne(`tZGF84{)^)8Lz~3I!H^H4&$4&brw$W&w z64vZBrt?)w5{;rIJBP|&v~biDTC(x|?w8?M^%ymlm-{=y$sw}S)-^>~ zQ6>v1jfrE1RdO7cEbZnuwUgW0w3U6c*-pCPQ@gQ9FxNUc)-qo zzCG*IzAjm&uX|00({15_VUX>RpDHJBEd1-k?tG~wpBt--@h6AOH}dLs z5)p5ACg)chj{F>w#Qfa*bv5_cDymdtW9DkXsWT4mT-0tZW|Y}2(_o8rgA63X`g4L0 zeB&PVW9{vCAC~?e)a+uADR-TBd3YTN*a#$%jAt0Ztm~T%CNj}pSZtqp2>Ad=IO?OW zIu3esRi?MRv1o>x4YX%_Wf+uKz$B58jE%nCI`;Hn_0-8m<9t!6T*swE8WR+P>O8yi z=7QUMbSK~5wR9=wcHUeJACv)(D~b4(sB1Cl3g2#Ek2Eouq+mj}?i-#*Jb};*S6$(o zO-AVk$=OjCCwxKA*QIG0Yhq^>k<=}_Dv2bx9XQYb0A9Mk0qWAW-98szow)gjTz~be zhPbuAd@L97Hyo?Q&V4cn#WzZqR@3iQqm3lPjlpi(J~PBW3Iz?*z_wTHsE*u zDyyvcn@93NheYu_Spb&2(Vzi+vlY{W&vE%z1uBw^wl{IU%;c^#$1e6yoT)n;l0U6G zPq}!YYio&tDtZ|KfF2o>o)G)XCJ$CQ=V%^3*84;m0;8LTL~Pf9$mJj z1HOGWhbQ!>T=-j2SlPd^uF*j1ZQB(*@lSG+mt&r}hss<$xaT9SQDD)?NXQxMyRBbvRElk&;H=xL6~ zlIHLcw{IhiC&`rEaV+uCp`XDUh2wHq{$y7aM`JBdK&%_zZZ5M zQp&3(xCqF3;~X3hYS&1mx`Y+l0Udf*7o%Ozq3UTnHrS*aCdXWMKj+rFct~Xu$0#9& zK{dQ3q0czkki`YuObda4M|!xMN(<_V9ZbYM2rdhr*&vY zLc=UbKx3Sqm1@#!E|TDTo8dnx5;RofI4&(ePWtkDS zs-egL^I7i1aN}+}hNT;b41|&EjMZF4)&;>Kmx0ilsO(utBz*{|F6Ow6ONBTCsP9>K z8r|c*5-`4?tw~BO+Ky?!CD7H$zjU?3F3_Ia!jRv-sBp}`%7e_#8iXN&DMc`A`P*&7d`vb*_3EpSj93t zPlrYr2ONsXv%Fm<=lc@=Qn~q|X3rp=neYDq)~yR^q`5^q{-fHe_=`vW)v##HU`rU? z1dMr8>7PTzEryMIc?(7oSI^7e8O1hu3X`$&r=}|l!n3Cl&8}owl;0bI2Z@LHfSYP`?*uV8O=k1Y24=TCe%@gYaHZ#<<2UiU*c~ndskD? zF&*opYkk{_#yIPaDzx@dNO^?&@L9=l$e z()H)PvHM*2R)f#Kk)m`Fpms*uhvwieG64r8C$(b_hu%KEy^~b4yNRDzx0>e08Rv5B zksXpo-!IsR((CwV1nD}S^)UD~Xks#SMj z?IDn!rwDL3&20ET#y2nGt1U`+?Pis3_g|YeM>5-dtnr1$HwD|Chb_(ssv51QjlL!L zN#4^$yqWbEo@ws>!7?b020+DSU<2k&(X?t=qY5&-ip19b7u@(R8Fd{d*5=|XNyHC& z$U?&@1)3(>KZ#V4>w-Gf%8fdS`$uM4w^Ohm8a^U;PeJ>1mWg@f>ke=Hlvtr?(4bIC zjF8e22^|0(^ICc*k9ECo!M9qjp=U0N>gIHbZq-sYlPs~aF$Iq0E^-J0JU3Ma4-RN{ zR~{?2@fU#ZUMX#)n^S0Qm1Qxhf=QK;8|8VF$fwIv#T}6Cz*@JW{3Ox*Uo^U;bKgJN zW09oPNL`S?u|Xq-a^Jjj9C>FTFf79z4SBV{v*|ywLW>=t3u%PNIfAql%?c7Rx9j+F<)uZ{lz7__vzvhXw#U1@iYqVrC6 zZ}gUpwfeyTTVYaoSr&a~QFXc~{Ix%xi5K0hFE0s&d?ellO_K zJT>60N=-AwUllx0;wY>xwJ$9p(1dRt!z)3Sg&r-tFsjVQ113JFf-;|1)U@3Z;qWG- zXmsVCFSSf<$ZKGdJIbh_4f8Clzcx8|m*qQm9{w*6&#(CQeKSEwWrD`a>f=w-?PU8x zH`;CHw~`{^zFq4fXAj5R`?xvz+0K;;(v>*!^M025iJY~)k;!Nu4K?o$**(RsiKc0` zX7hdJ)$=U2%`3AIvI$wY^6epG$IKKl$x)l}tKwh6Tkj1+eWB`7$u^oCPkQAbW|XmM zQIG%_y9Fa04=GRZ(eY#A7K7or5zh+xF9B@AY-n-9(Uj#MXQ{p9#o^0)8fuI+cX7<)Op;$diNI+u1;c=a; z0~}*Dt@}29&bs%CJY^mI=7|mFn`vfluV9h_&hRAZ7w-O0Ki52Q{qD0Wk(OHZpB4Nu zkHpp*$Beuc6mUpUq)DNe!dZN%rwswd)H@rM#s=0MatEoH=X5Zy>h#|0ev7AcCek_S z{9C76`1}46ABWa(TFU#k?`aazSg0Y1%(Ae715#Wscw( zl#*8<5-@&!;;1<{6?rY6{2k3{tL?G9@bBSm=YoD1U--OgHnw+G(@7qmW2eSryS#jr zmnUO_rFJNCpkYqt9O5Z1E_@r{C^X$q!WV6?!KfwmmA%!*ZUaXqV=Fh7QwtirNWU)7 zalpVHhMp?$pNswtS@@I078WqVx~!5NT#es*~3v#%#oE&JNNmYpxu)>Qdk zh~hja;-3|G!%T-y@jjOSCxtUd?%c_L zdvH`4E+hW{REyNIBt|!PVX;9YV`Gh73*nE$%~IP?(PG!mp=&pZl04f<4(nN>Lb3uw z%)!isoEAA7vAF!EvZ;;1!lyiwOUnNMo~H1pWvV=~Yp)J!{sFSO@b8Fi@2(-ahCee> zv1nsRC-ateMOE`6j6lwHh!(n8_*VeF^Z_S=O|THf={n*Kcl(?v*~D7L93Z=e53{<)l%xYQff75Eo={ zj0cv-)VG*?Lee}Vs%x`qx~Gr#UzieUCYH}Da>67qnGQZ<<+om2_ivIoHG}Yu(^1m= ze;&W#{{R_XYB$zfZfzDnp6JgUO*2MU4y>j%Z!iuq695RTy;H(IHM{YAmKwZQ@@tPg zo>rS}ZyPLf6_acT82MvpKXBv#a6lx1wLG>|@s3{7%Gd1w0O7pHRg(; z^FNr;f z3OL$uTXseR0(3NuQ{qR2mh0@^8M^W{=axw&7R8bUV&E!gET}i_QH{W0o`Bacccb{a z&rSaTgs$sIwPh z$ENrj;va~wH0Yo{ADZHa%|`vT5i7PXb0 zooxt(+Sz>Tr-9`8j01D+F~!>%%C6TNK(7<=Pl$XK;Y(DLMDZ=t+`I^osk-?s-)P+? z7@h;<2=;M|l5z!6xbfxf>snvh>&Pt?LR_ee1>M<+W<_iPw3Qi96-PCU@~KWd(N_5~ zu9rjIb-xq%DhsPEb3-xeT6dH78BEp@n~2(JC5L%n0bRlv-Bd9E%A{kQbPwU{dryZ} zJ}lF`OC80Ly10N}P726_?F>~FS($fk%7O;L@FKp{>hE6EHvd`C482UmKz8s%whaP zaRsslNv;{?7~QX@pJArn=crr$(f$DN7mh9^hrs%s#<8dB>hQdqgf{T*hBQ}ROS>4E zi2z|w1Me1P*16%2inCt4J}460-^{n|=fIZiNMOQ9*phzEAW38)eqt3fjDS3GyCh?it;gU9wOcE6_+@7nqkSU@ z+fLK&o+Ttl9A(@nVY7RvInOFfr_o*&x#gWe~EwLGqdqyMCQT^%}Vq%_DQGRx~dB%R{2>+Rl<~DyMf#* zp7^8UFArPTYF0W5A84ra^RWrW8|5VOimYqs2x`?LV%fjQ$j&H&(&d-Cmi=Fp|TlD1080&n{p5+5KP z?SqV*XOB~iW|H1k@`bbupD^dlW0l58&N~lUrEhZ9p+p5_P~3(;E`QJRuGMB2A&UM_ zwCq`SEQIcGcq5)Zl}c+DTj!2Tn4)M1S0za#XCIbxS1)4U7n}$=Y+*0~>Us{}=bEK+ zHJo3%wwujxesUXveL1GmL`mE}(P3{BhP}j*;G-bp8SZ+H3H>Sdx`CV>fruHwP)>UC zd*Z3z-r3I@TE%P>^pVtak4*O&&0EqTOKVRn&H#qsXO2%!K8N!a9K@~5Xwx(%K`KJX z>Zb#%VD`wt>-p6muq!EHJdymi7t!ijP1d9^KGS1mjHw9K440reG_*Bhx z4x@P^$g;-9QgE_!_<%5eqaA3yv7T9X*$}GC0x^6A!xUbC&rA2pJXB=sHcT{u;T|aV@;C#gtDlZJPu$0mgT7my|oo^Id(SEz8LBSeyV4Ab%`>^{d@{AEN2nKkV77>yvnHONk35yjp}3DWA@`jz@{g z9z3)>Gj3lqav%is^7AZO!*b}`Z7n>^+^l2%&Yu~z&xh7pj-3+1bZfj^U0O;v87GYi zR@w;OPjmb@ACAEI!LDgKsM5SVtp(Asj?R0_iG=qOMr61uOUd$gZIfkU>C00i5^zYuau8A9yGJ5ZiAQUU*JjM)O;OMZAz( zd2#92k$F&nuOlo{f#tRfF(86U0>IaWjaV8L{iR6V%k%R$jZ0`+@UO&MJrd##Hp<%K z;^xXZ3){sOW^9FQOm_0i`@#zC3<`n?$*)-WS@ARWc<^tCB=L8QJ_L^!>ag2e+xTx& z@l3Jb={B%Nz{b#NjR;vL+ElgG#Iq3W#xzjea$Xj>i%{0I`%P0+Z2`RLQfsSS3OQ$c zc&5QdY!b=0VybTL4==o*LW|)Cg%w)qZ>_!R|8r3$pSHH>I@->X*3EeA_N#fsz7Z$G5cu~%sYFc|s3oB#f+H(H@xQ&`z z{HrSg(8P9?z(p1GKkVP)Plwij5w0!#BjRJNM`xp3*?4*hw1X&?Yw5HZZ5sN2v~QYQ8AXM| zO&NjH_tM5u8d)2ACfdN$?zLE6$5Zg9!(B$}!s0n*zO&Qwdwr}*ZO-`BE?7vHjpa&Q z+wF`?Aur}(n!QKH_BI|H@d4Ls9Jimmy8>H;0^qg4S9EwcqoXh@<~yI% zDb<8vnb9QV^*p!4Uk-dx;ja%_pNPH+)%93jcv9vc_)KJ&#S<&Z<=cjUE5RPtBHmUx zc@=(8OCJsR<9~Incs%&i#GWWz8^ddDX<=`&D@!m~yFo^AI>xc>mHj^i#LBL!QPA-kIQ@|gQs-E=rHa^;PTZB=f(S@7c5U(+7+ z&0zBR)~}zlM=N~KwF_iE)KkDAh$Nhf%kd@1m%tXcOQo1Rpc#aL*=`BIDo+3aPI27l z@R!1H>hf7@S`~%z#Q=Yr-fS`3jCq50FhS=hj+|!|SHrgHd!$`>Ze31RXatu~z)3sV zLZHS#-I2~gz~tkTUt2~Tn;sQL+0L{&Wz;f5b!?zH!H5BbJPfG)D#g}^B+w&60!)t> zWj?YHvnWsz7LcIr+@&U;{U-#*oF>Y&QD@Z2ayQas4W#_vFS`*p8g zD(K~HoJWo{n_Hg=-`TyLrMe`0$}~gd2*HTxKqQXboc(L9@C>%gZEYMUM&I_!Kmg4#VI-4bK|t$erZzyJ;^ zp&L7yPEN+{)|qG%dfNrsyzJvO&s@7L$eP+27Y7+2;MZ5GEOFa5*}iOX=qsIkjllEY zIqzDys~JX2>bx1^CKhJG@B+Jm7{IL?>0at5jsOr9`9lo;zgpoebvZ3=2bX}r=V?3> zU2c!43(Ih1z&-M7hIHIzbD=e3J5rUVnU+x7>J|dWQ?*G57+~rc9zE)X z{{V!1H_IlA0+u)>BLcKuHc7nICvQ{7=TgfA&5{pa?+Q+zQ$;qB&90MoX4|y?01;|X zAUN3uqax$}`D&WvYa$`H#5b;6g7+n5Bzx}%^XpfowkJ3Q{M>{7eW_Bxo;}`P??5O? zEysK6U>4SaDgC1p5rRzCY5c$xldi3`q!$)!*!gn|gFpAog0*in#+2?b;DOH-UF^1@ z5yn}&ty1MhT+6jO)Ha19jwyjB8}8Xk_s1&4`*Zlze`?kXpEF8g0LSj`5s&1`Kb>g# z1n2LMPz@=7a^7JBp#!}p`vPmRjXt5QE3unOx!Ku-NZ9n zKtC{~ezmJJOu3B6I6eE&t07$ORyfB3gxKAVdTn~f^_JFUC?Dm^DFJieBn)HTwe$}c z&uykh1k931gdp20mOqAbMa{EIx*@dW9x8tY*eYtzr`!bFFv=e+6T81Pag?q^lu|S& zzfGa;(}Fn2BNV}XX(9!WaSPA}tJ;TzEwFJ6B(_FGU>yDxRlGX($?{kpy<=iBKLcCy zNf}x_39PTrmx(829l<%xOfFYBis)mvHAYPoa0|^Jatxh+Flo|wa!DCPI;6pI^5zvk z$O^t3ASlIQ~XA)hPTRP%*`$reKPME%u+^nd(cedm zdyny_&2d>HT`yoV?S662M-?xb1Ag?#%f|#YbJ5!CDnXDb!Q`xf{)AG!&aG;tS`btp zPyW3=VRAO~I!JD;TL~iuKE|tR3#JpjtyBTYV7&cn1+{yGQ#Hk`hy#Dm76AKaAJ(Lo z#V||}O|g-4hG5@zgyIe}iKjFX3vl*xZsVhjVzZ}~;yH;+a>Q~-?N5hUWB?_*>~4T9 zGy6u)Ml86=>JL%PE25&GQIgyOo8l6w?5EbVXVh+$$j9>rwIsT?xLxqiwByiKIqe{s z_lGJ^@nZs~n7deqN$~`>lWifCw-{lH*BX@fWFw3ZRc!HDNv07XWV-_$o1v{UYK<6g zEpv{?8Krc>%H%qxkkb$CD;aTcqa$g?@#&hAMb@7F5W&EaICNv)r?rs8GMoCZLiy)r*8U z9k?-!4mui!1k71a1Y~ps zQ&w-dC+`>K!TGb+k!hCa2h7}r9&&JTQBNP45oLX> z2SZF-)WG?a`x8X7KtFl0uty+sQ6!7GyQ!-F4BU4MtV zP_SF;3wSNWnyE4BHW$%@G6#}CzDn?SD2h;o=L0N3AQ7dY_-5K)7E9qT1Zp#H(<6p$ zN#eId8(lQb<&(ELJ61(G$YG4*03YPMO-e2Ujf02A-b=z>CDpt`;;U^vG(FlRZ!FeMk{>LXVv(LS0D?jC zl?QU!=M7KsrT2riZ9OKrmi=!n8ffm(r4dT5xxi+J0F@&kFUsFA&sy=-N|2W-TKD_E zubFY#`JAVWyjiMh&u3`2uLaC1l1PX)HLDdEjadlJ0F_8T-#G(0p*%z2%|F3%c$|3E z7V_g#NMy3o>{;C`rByR2l3*b+GeqNX5422xWQMH$6UDlBhrCQRe;8>FmRg0Av^R5U z?>C>RfU6X$QxXrCd2)oQ7$pd-{{Rwr#V3}>U9+;Znkmp2gio?Rl1356$ioY{*pq?D z!S7z3JTJCNHs8=9lux3*A71!BTkz$-h&(&3mxol2CbW*^r`py0sDXk_xy+lKxCay;`br#qk$v|05!V)(&BjNeZ=D^1%=T8XyQ22}C zKNs0+*18n;7E@h;_B(U|SZZRTb#ztZG_5sia-_!@}@c++Ql$ zjY95UDk~cyFnyc+rZE667-a50yKF81QRh_Q>0xX0xnJh4buD6E(X|g1>6&$omw;~O z)wHX1O-|7-F^_obQQ^0z5)L?MRYQ*%aol{LQy#ajsVD7-nQYLQ(>_L!Q+4MH;o zq#(|-NXq$832&Qm05>c5bDmqr{{RqtJK?_z-$7$wR^&!tf=g@tvQH$4!X=OpL&i3< zWNpUblaNqyI(4sxd|L&Mx#C@Z9Xo8$TU?8R(!|lKCNg4O%5pry26zk4YU)@Dbt$>c zTHiNuY0&ox{w+U*HKg%7=vMkt>A>msdK56k(5y(Hot|2OxtW)dwDW_=HI?J9joJr? zJO(E4=8n34uXzkjZ*!;Jvcjtw#Dpp``Ev;d4(-|5mL02!@&5pcyf2`<_EYJz-lXCy zg}SpFcFA&JN!&;i&j6n-hy*TECmG4dO60r|;ja~GJ~z@I?2@#S-iYo^v1V9faI3hG z4ihZr1J*nbWF5l^Q0PVVySkp$-Jj<4 zGMqA{2_4%G10} z;$-j+p`}?^HT|^mUNy#x!TJaMkB5QC?K#ZJ~Eas3yb%Yy|r!Vy>+nRDBjXK&j@&4cP5bTgI@3vWC!vj@Po(&l!#a0@JRhUoS+UeDm7k|5hEO46a+j>~Z(w$fOhGlEoiMusB2Jr&fyQ991rGB1t3 zDfo@?C&Zf1jVc#i(pP?aV{ zy^hsnmgwNd8ZbY0cLER02ph@U&j{Ww_#@+=5nA1NqsDs0)#Ck@2sF#t87=N1P+nVo z*q7qz`BUHExD=C$Li9Zpzc zf?JD;wFvGdc;Z%HByc`gWkQ;{}_7 zLf1v%pW0s6#2U4~fh_(SDYm@vJQK*;eVbb(5?jiqAh4DIx~AY!g0zfTj#%@y7Y$Pb zg|!&DE&4{^*I_?-?reCU;YW$S5o+-Gr{Qh2yXh+`K)+(WjW@-z0`f6#0-rZ%aC3!| zj!x_yL*o9E;)Ipj`&Q63?MfG#ElX^I;s~zpmweI2e&KT<{ovsXmH<}g?TO=Cjb6z< z9O)MF�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 WIiquxV4VK|5IHzMk3Wq7fB)I4_NCPT diff --git a/ultralytics-main/dataset/coco128/images/train2017/image_BS1_462_00_42_15.jpg b/ultralytics-main/dataset/coco128/images/train2017/image_BS1_462_00_42_15.jpg deleted file mode 100644 index 7e47ffe08411b36ff335dbd6b1b724d9dc7f07d2..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 233728 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