Link to this sectionUltralytics YOLOv5 🚀 no Guia de Início Rápido do AzureML#

Bem-vindo ao guia de início rápido do Ultralytics YOLOv5 para o Microsoft Azure Machine Learning (AzureML)! Este guia vai te orientar na configuração do YOLOv5 em uma instância de computação do AzureML, cobrindo desde a criação de um ambiente virtual até o treinamento e a execução de inferência com o modelo.

Link to this sectionO que é o Azure?#

Azure é a plataforma abrangente de computação em nuvem da Microsoft. Ela oferece uma vasta gama de serviços, incluindo poder computacional, bancos de dados, ferramentas de análise, recursos de aprendizado de máquina e soluções de rede. O Azure permite que organizações criem, implantem e gerenciem aplicativos e serviços por meio de centros de dados gerenciados pela Microsoft, facilitando a migração de cargas de trabalho da infraestrutura local para a nuvem.

Link to this sectionO que é o Azure Machine Learning (AzureML)?#

Azure Machine Learning (AzureML) é um serviço de nuvem especializado projetado para desenvolver, treinar e implantar modelos de aprendizado de máquina. Ele oferece um ambiente colaborativo com ferramentas adequadas para cientistas de dados e desenvolvedores de todos os níveis de habilidade. Recursos principais incluem aprendizado de máquina automatizado (AutoML), uma interface de arrastar e soltar para criação de modelos e um poderoso SDK Python para controle mais granular sobre o ciclo de vida de ML. O AzureML simplifica o processo de incorporar modelagem preditiva em aplicativos.

Link to this sectionPré-requisitos#

Para seguir este guia, você precisará de uma assinatura do Azure ativa e acesso a um workspace do AzureML. Se você não tiver um workspace configurado, consulte a documentação oficial do Azure para criar um.

Link to this sectionCriar uma Instância de Computação#

Uma instância de computação no AzureML fornece uma estação de trabalho gerenciada baseada em nuvem para cientistas de dados.

1. Navegue até o seu workspace do AzureML.
2. No painel esquerdo, selecione Compute.
3. Vá para a aba Compute instances e clique em New.
4. Configure sua instância selecionando os recursos apropriados de CPU ou GPU com base nas suas necessidades de treinamento ou inferência.

Link to this sectionAbrir um Terminal#

Assim que sua instância de computação estiver em execução, você pode acessar seu terminal diretamente do estúdio AzureML.

1. Vá para a seção Notebooks no painel esquerdo.
2. Encontre sua instância de computação no menu suspenso superior.
3. Clique na opção Terminal abaixo do navegador de arquivos para abrir uma interface de linha de comando para sua instância.

Link to this sectionConfigurar e Executar o YOLOv5#

Agora, vamos configurar o ambiente e executar o Ultralytics YOLOv5.

Link to this sectionCriar um Ambiente Virtual#

É uma boa prática usar um ambiente virtual para gerenciar dependências. Usaremos o Conda, que já vem pré-instalado nas instâncias de computação do AzureML. Para um guia detalhado de configuração do Conda, veja o Guia de Início Rápido do Conda da Ultralytics.

Crie um ambiente Conda (por exemplo, yolov5env) com uma versão específica do Python e ative-o:

conda create --name yolov5env -y python=3.10 # Create a new Conda environment
conda activate yolov5env                     # Activate the environment
conda install pip -y                         # Ensure pip is installed

Link to this sectionClonar o Repositório do YOLOv5#

Clone o repositório oficial do Ultralytics YOLOv5 do GitHub usando Git:

git clone https://github.com/ultralytics/yolov5 # Clone the repository
cd yolov5                                       # Navigate into the directory
# Initialize submodules (if any, though YOLOv5 typically doesn't require this step)
# git submodule update --init --recursive

Link to this sectionInstalar Dependências#

Instale os pacotes Python necessários listados no arquivo requirements.txt. Também instalamos o ONNX para recursos de exportação de modelos.

pip install -r requirements.txt # Install core dependencies
pip install "onnx>=1.12.0"      # Install ONNX for exporting

Link to this sectionRealizar Tarefas com YOLOv5#

Com a configuração concluída, agora você pode treinar, validar, realizar inferência e exportar seu modelo YOLOv5.

• Treine o modelo em um conjunto de dados como o COCO128. Verifique a documentação do Modo de Treinamento para mais detalhes.

  # Start training using yolov5s pretrained weights on the COCO128 dataset
  python train.py --data coco128.yaml --weights yolov5s.pt --img 640 --epochs 10 --batch 16

• Valide o desempenho do modelo treinado usando métricas como Precisão, Revocação e mAP. Veja o guia do Modo de Validação para opções.

  # Validate the yolov5s model on the COCO128 validation set
  python val.py --weights yolov5s.pt --data coco128.yaml --img 640

• Execute a Inferência em novas imagens ou vídeos. Explore a documentação do Modo de Predição para várias fontes de inferência.

  # Run inference with yolov5s on sample images
  python detect.py --weights yolov5s.pt --source data/images --img 640

• Exporte o modelo para diferentes formatos como ONNX, TensorRT ou CoreML para implantação. Consulte o guia do Modo de Exportação e a página de Integração ONNX.

  # Export yolov5s to ONNX format
  python export.py --weights yolov5s.pt --include onnx --img 640

Link to this sectionUsando um Notebook#

Se preferir uma experiência interativa, você pode executar esses comandos dentro de um Notebook AzureML. Você precisará criar um kernel IPython personalizado vinculado ao seu ambiente Conda.

Link to this sectionCriar um Novo Kernel IPython#

Execute os seguintes comandos no terminal da sua instância de computação:

# Ensure your Conda environment is active
# conda activate yolov5env

# Install ipykernel if not already present
conda install ipykernel -y

# Create a new kernel linked to your environment
python -m ipykernel install --user --name yolov5env --display-name "Python (yolov5env)"

Após criar o kernel, atualize seu navegador. Quando abrir ou criar um arquivo de notebook .ipynb, selecione seu novo kernel ("Python (yolov5env)") no menu suspenso de kernels no canto superior direito.

Link to this sectionExecutando Comandos em Células de Notebook#

• Células Python: O código nas células Python será executado automaticamente usando o kernel yolov5env selecionado.

• Células Bash: Para executar comandos de shell, use o comando mágico %%bash no início da célula. Lembre-se de ativar seu ambiente Conda dentro de cada célula bash, pois elas não herdam automaticamente o contexto do ambiente do kernel do notebook.

  %%bash
  source activate yolov5env # Activate environment within the cell
  
  # Example: Run validation using the activated environment
  python val.py --weights yolov5s.pt --data coco128.yaml --img 640

Parabéns! Você configurou e executou com sucesso o Ultralytics YOLOv5 no AzureML. Para explorações adicionais, considere verificar outras Integrações Ultralytics ou a documentação detalhada do YOLOv5. Você também pode achar a documentação do AzureML útil para cenários avançados, como treinamento distribuído ou implantação de modelos como um endpoint.