콘텐츠로 건너뛰기

Efficient Hyperparameter Tuning with Ray Tune and YOLO11

하이퍼파라미터 튜닝은 최적의 하이퍼파라미터 세트를 발견하여 최고의 모델 성능을 달성하는 데 필수적입니다. 여기에는 다양한 하이퍼파라미터로 테스트를 실행하고 각 테스트의 성능을 평가하는 작업이 포함됩니다.

Accelerate Tuning with Ultralytics YOLO11 and Ray Tune

Ultralytics YOLO11 incorporates Ray Tune for hyperparameter tuning, streamlining the optimization of YOLO11 model hyperparameters. With Ray Tune, you can utilize advanced search strategies, parallelism, and early stopping to expedite the tuning process.

레이 튠

레이 튠 개요

Ray Tune 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 YOLO11.

다음과의 통합 Weights & Biases

YOLO11 also allows optional integration with Weights & Biases for monitoring the tuning process.

설치

필요한 패키지를 설치하려면 실행합니다:

설치

# Install and update Ultralytics and Ray Tune packages
pip install -U ultralytics "ray[tune]"

# Optionally install W&B for logging
pip install wandb

사용법

사용법

from ultralytics import YOLO

# Load a YOLO11n model
model = YOLO("yolo11n.pt")

# Start tuning hyperparameters for YOLO11n training on the COCO8 dataset
result_grid = model.tune(data="coco8.yaml", use_ray=True)

tune() 메서드 매개변수

그리고 tune() method in YOLO11 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:

매개변수유형설명기본값
datastrThe 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.
spacedict, optionalA 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, YOLO11 uses a default search space with various hyperparameters.
grace_periodint, optionalThe grace period in epochs for the ASHA scheduler 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_trialint, optional튜닝 중 평가판당 할당할 GPU 수입니다. 이는 특히 다중GPU 환경에서 GPU 사용량을 관리하는 데 도움이 됩니다. 제공되지 않으면 튜너는 사용 가능한 모든 GPU를 사용합니다.없음
iterationsint, optional튜닝 중에 실행할 최대 트라이얼 횟수입니다. 이 매개 변수는 테스트되는 총 하이퍼파라미터 조합 수를 제어하여 튜닝 프로세스가 무한정 실행되지 않도록 하는 데 도움이 됩니다.10
**train_argsdict, optional에 전달할 추가 인수는 train() method during tuning. These arguments can include settings like the number of training epochs, batch size, and other training-specific configurations.{}

이러한 파라미터를 사용자 지정하면 특정 요구 사항과 사용 가능한 컴퓨팅 리소스에 맞게 하이퍼파라미터 최적화 프로세스를 미세 조정할 수 있습니다.

기본 검색 공간 설명

The following table lists the default search space parameters for hyperparameter tuning in YOLO11 with Ray Tune. Each parameter has a specific value range defined by tune.uniform().

매개변수값 범위설명
lr0tune.uniform(1e-5, 1e-1)Initial learning rate
lrftune.uniform(0.01, 1.0)최종 학습률 계수
momentumtune.uniform(0.6, 0.98)모멘텀
weight_decaytune.uniform(0.0, 0.001)체중 감소
warmup_epochstune.uniform(0.0, 5.0)워밍업 에포크
warmup_momentumtune.uniform(0.0, 0.95)워밍업 모멘텀
boxtune.uniform(0.02, 0.2)박스 감량 무게
clstune.uniform(0.2, 4.0)클래스 감량 체중
hsv_htune.uniform(0.0, 0.1)색조 확대 범위
hsv_stune.uniform(0.0, 0.9)채도 증강 범위
hsv_vtune.uniform(0.0, 0.9)값(밝기) 확대 범위
degreestune.uniform(0.0, 45.0)회전 확대 범위(도)
translatetune.uniform(0.0, 0.9)번역 증강 범위
scaletune.uniform(0.0, 0.9)확장 범위 확대
sheartune.uniform(0.0, 10.0)전단 증강 범위(도)
perspectivetune.uniform(0.0, 0.001)원근 증강 범위
flipudtune.uniform(0.0, 1.0)수직 뒤집기 확대 확률
fliplrtune.uniform(0.0, 1.0)수평 뒤집기 확대 확률
mosaictune.uniform(0.0, 1.0)모자이크 확대 확률
mixuptune.uniform(0.0, 1.0)믹스업 증강 확률
copy_pastetune.uniform(0.0, 1.0)복사-붙여넣기 확대 확률

사용자 지정 검색 공간 예제

In this example, we demonstrate how to use a custom search space for hyperparameter tuning with Ray Tune and YOLO11. By providing a custom search space, you can focus the tuning process on specific hyperparameters of interest.

사용법

from ultralytics import YOLO

# Define a YOLO model
model = YOLO("yolo11n.pt")

# Run Ray Tune on the model
result_grid = model.tune(
    data="coco8.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 "yolo11n.pt" pretrained weights. Then, we call the tune() 메서드에 "coco8.yaml"로 데이터 세트 구성을 지정합니다. 초기 학습률에 대한 사용자 정의 검색 공간을 제공합니다. lr0 키 "lr0"과 값 tune.uniform(1e-5, 1e-1). 마지막으로, 에포크 수와 같은 추가 훈련 인수를 다음과 같이 튠 메서드에 직접 전달합니다. epochs=50.

레이 튠 결과 처리

레이 튜닝으로 하이퍼파라미터 튜닝 실험을 실행한 후에는 얻은 결과에 대해 다양한 분석을 수행해야 할 수 있습니다. 이 가이드에서는 이러한 결과를 처리하고 분석하는 일반적인 워크플로를 안내합니다.

디렉토리에서 튜닝 실험 결과 로드

튜닝 실험을 실행한 후 tuner.fit()를 사용하면 디렉토리에서 결과를 로드할 수 있습니다. 이 기능은 특히 초기 교육 스크립트가 종료된 후 분석을 수행하는 경우에 유용합니다.

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()

기본 실험 수준 분석

평가판이 어떻게 수행되었는지에 대한 개요를 확인하세요. 평가판 중에 오류가 있었는지 빠르게 확인할 수 있습니다.

if result_grid.errors:
    print("One or more trials failed!")
else:
    print("No errors!")

기본 평가판 수준 분석

개별 평가판 하이퍼파라미터 구성 및 마지막으로 보고된 지표에 액세스합니다.

for i, result in enumerate(result_grid):
    print(f"Trial #{i}: Configuration: {result.config}, Last Reported Metrics: {result.metrics}")

평가판에 대해 보고된 지표의 전체 기록 플로팅하기

각 평가판에 대해 보고된 지표의 기록을 플로팅하여 시간이 지남에 따라 지표가 어떻게 변화했는지 확인할 수 있습니다.

import matplotlib.pyplot as plt

for i, result in enumerate(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()

요약

이 문서에서는 Ultralytics 을 사용하여 레이 튠으로 실행한 실험의 결과를 분석하는 일반적인 워크플로우를 다루었습니다. 주요 단계에는 디렉토리에서 실험 결과를 로드하고, 기본 실험 수준 및 시험 수준 분석을 수행하고, 메트릭을 플로팅하는 것이 포함됩니다.

레이튠의 결과 분석 문서 페이지에서 하이퍼파라미터 튜닝 실험을 최대한 활용하기 위한 자세한 내용을 살펴보세요.

자주 묻는 질문

How do I tune the hyperparameters of my YOLO11 model using Ray Tune?

To tune the hyperparameters of your Ultralytics YOLO11 model using Ray Tune, follow these steps:

  1. 필요한 패키지를 설치합니다:

    pip install -U ultralytics "ray[tune]"
    pip install wandb  # optional for logging
    
  2. Load your YOLO11 model and start tuning:

    from ultralytics import YOLO
    
    # Load a YOLO11 model
    model = YOLO("yolo11n.pt")
    
    # Start tuning with the COCO8 dataset
    result_grid = model.tune(data="coco8.yaml", use_ray=True)
    

레이 튠의 고급 검색 전략과 병렬 처리를 활용하여 모델의 하이퍼파라미터를 효율적으로 최적화합니다. 자세한 내용은 레이 튠 설명서를 참조하세요.

What are the default hyperparameters for YOLO11 tuning with Ray Tune?

Ultralytics YOLO11 uses the following default hyperparameters for tuning with Ray Tune:

매개변수값 범위설명
lr0tune.uniform(1e-5, 1e-1)초기 학습률
lrftune.uniform(0.01, 1.0)최종 학습률 계수
momentumtune.uniform(0.6, 0.98)모멘텀
weight_decaytune.uniform(0.0, 0.001)체중 감소
warmup_epochstune.uniform(0.0, 5.0)워밍업 에포크
boxtune.uniform(0.02, 0.2)박스 감량 무게
clstune.uniform(0.2, 4.0)클래스 감량 체중
hsv_htune.uniform(0.0, 0.1)색조 확대 범위
translatetune.uniform(0.0, 0.9)번역 증강 범위

이러한 하이퍼파라미터는 특정 요구사항에 맞게 사용자 지정할 수 있습니다. 전체 목록과 자세한 내용은 하이퍼파라미터 튜닝 가이드를 참조하세요.

How can I integrate Weights & Biases with my YOLO11 model tuning?

To integrate Weights & Biases (W&B) with your Ultralytics YOLO11 tuning process:

  1. W&B를 설치합니다:

    pip install wandb
    
  2. 튜닝 스크립트를 수정합니다:

    import wandb
    
    from ultralytics import YOLO
    
    wandb.init(project="YOLO-Tuning", entity="your-entity")
    
    # Load YOLO model
    model = YOLO("yolo11n.pt")
    
    # Tune hyperparameters
    result_grid = model.tune(data="coco8.yaml", use_ray=True)
    

이 설정을 통해 튜닝 프로세스를 모니터링하고, 하이퍼파라미터 구성을 추적하고, W&B에서 결과를 시각화할 수 있습니다.

Why should I use Ray Tune for hyperparameter optimization with YOLO11?

레이 튠은 하이퍼파라미터 최적화를 위한 다양한 이점을 제공합니다:

  • 고급 검색 전략: 효율적인 매개변수 검색을 위해 베이지안 최적화 및 HyperOpt와 같은 알고리즘을 활용합니다.
  • 병렬 처리: 여러 번의 시험 실행을 병렬로 지원하여 튜닝 프로세스의 속도를 크게 높입니다.
  • 조기 종료: ASHA와 같은 전략을 사용하여 실적이 저조한 실험을 조기에 종료하여 컴퓨팅 리소스를 절약합니다.

Ray Tune seamlessly integrates with Ultralytics YOLO11, providing an easy-to-use interface for tuning hyperparameters effectively. To get started, check out the Efficient Hyperparameter Tuning with Ray Tune and YOLO11 guide.

How can I define a custom search space for YOLO11 hyperparameter tuning?

To define a custom search space for your YOLO11 hyperparameter tuning with Ray Tune:

from ray import tune

from ultralytics import YOLO

model = YOLO("yolo11n.pt")
search_space = {"lr0": tune.uniform(1e-5, 1e-1), "momentum": tune.uniform(0.6, 0.98)}
result_grid = model.tune(data="coco8.yaml", space=search_space, use_ray=True)

이렇게 하면 튜닝 프로세스 중에 탐색할 초기 학습 속도 및 운동량과 같은 하이퍼파라미터의 범위를 사용자 지정할 수 있습니다. 고급 구성에 대해서는 사용자 지정 검색 공간 예제 섹션을 참조하세요.

📅 Created 11 months ago ✏️ Updated 1 month ago

댓글