Documentation of methods, parameters, allowed values, term definitions, etc, etc

[jmiller-dr]

Search before asking

• I have searched the YOLOv5 issues and found no similar feature requests.

Description

There's a documentation webpage and some tutorials, but no actual documentation. Please provide documentation for each method, argument, etc.

Custom detection is particularly poorly documented and highly glossed over in the little tutorials.

Use case

No response

Additional

No response

Are you willing to submit a PR?

• Yes I'd like to help by submitting a PR!

[github-actions]

👋 Hello @jmiller-dr, thank you for your interest in YOLOv5 🚀! Please visit our ⭐️ Tutorials to get started, where you can find quickstart guides for simple tasks like Custom Data Training all the way to advanced concepts like Hyperparameter Evolution.

If this is a 🐛 Bug Report, please provide screenshots and minimum viable code to reproduce your issue, otherwise we can not help you.

If this is a custom training ❓ Question, please provide as much information as possible, including dataset images, training logs, screenshots, and a public link to online W&B logging if available.

For business inquiries or professional support requests please visit https://ultralytics.com or email support@ultralytics.com.

Requirements

Python>=3.7.0 with all requirements.txt installed including PyTorch>=1.7. To get started:

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/CUDNN, Python and PyTorch preinstalled):

• Google Colab and Kaggle notebooks with free GPU:
• Google Cloud Deep Learning VM. See GCP Quickstart Guide
• Amazon Deep Learning AMI. See AWS Quickstart Guide
• Docker Image. See Docker Quickstart Guide

Status

If this badge is green, all YOLOv5 GitHub Actions Continuous Integration (CI) tests are currently passing. CI tests verify correct operation of YOLOv5 training (train.py), validation (val.py), inference (detect.py) and export (export.py) on macOS, Windows, and Ubuntu every 24 hours and on every commit.

[glenn-jocher]

@jmiller-dr thanks for your feedback! Yes, docs are something have highlighted for improvement in our roadmap, particularly for the high level classes and functions. For custom python inference I'd recommend the PyTorch Hub tutorial, as this provides the most deployment flexibility and also offers many usage examples:

Tutorials

• Train Custom Data  🚀 RECOMMENDED
• Tips for Best Training Results  ☘️ RECOMMENDED
• Multi-GPU Training
• PyTorch Hub 🌟 NEW
• TFLite, ONNX, CoreML, TensorRT Export 🚀
• Test-Time Augmentation (TTA)
• Model Ensembling
• Model Pruning/Sparsity
• Hyperparameter Evolution
• Transfer Learning with Frozen Layers
• Architecture Summary 🌟 NEW
• Weights & Biases Logging
• Roboflow for Datasets, Labeling, and Active Learning  🌟 NEW
• ClearML Logging 🌟 NEW
• Deci Platform 🌟 NEW
• Comet Logging 🌟 NEW

Good luck 🍀 and let us know if you have any other questions!

[jmiller-dr]

Thank you! Cheers

…

On Sun, Sep 25, 2022 at 2:19 PM Glenn Jocher ***@***.***> wrote: @jmiller-dr <https://github.com/jmiller-dr> thanks for your feedback! Yes, docs are something have highlighted for improvement in our roadmap, particularly for the high level classes and functions. For custom python inference I'd recommend the PyTorch Hub tutorial <https://docs.ultralytics.com/yolov5/tutorials/pytorch_hub_model_loading>, as this provides the most deployment flexibility and also offers many usage examples: Tutorials - Train Custom Data <https://docs.ultralytics.com/yolov5/tutorials/train_custom_data> 🚀 RECOMMENDED - Tips for Best Training Results <https://docs.ultralytics.com/guides/model-training-tips/> ☘️ RECOMMENDED - Multi-GPU Training <https://docs.ultralytics.com/yolov5/tutorials/multi_gpu_training> - PyTorch Hub <https://docs.ultralytics.com/yolov5/tutorials/pytorch_hub_model_loading> 🌟 NEW - TFLite, ONNX, CoreML, TensorRT Export <https://docs.ultralytics.com/yolov5/tutorials/model_export> 🚀 - Test-Time Augmentation (TTA) <https://docs.ultralytics.com/yolov5/tutorials/test_time_augmentation> - Model Ensembling <https://docs.ultralytics.com/yolov5/tutorials/model_ensembling> - Model Pruning/Sparsity <https://docs.ultralytics.com/yolov5/tutorials/model_pruning_and_sparsity> - Hyperparameter Evolution <https://docs.ultralytics.com/yolov5/tutorials/hyperparameter_evolution> - Transfer Learning with Frozen Layers <https://docs.ultralytics.com/yolov5/tutorials/transfer_learning_with_frozen_layers> - Architecture Summary <https://docs.ultralytics.com/yolov5/tutorials/architecture_description> 🌟 NEW - Weights & Biases Logging <https://github.com/ultralytics/yolov5/issues/1289> - Roboflow for Datasets, Labeling, and Active Learning <https://docs.ultralytics.com/yolov5/tutorials/roboflow_datasets_integration> 🌟 NEW - ClearML Logging <https://docs.ultralytics.com/yolov5/tutorials/clearml_logging_integration> 🌟 NEW - Deci Platform <https://github.com/ultralytics/yolov5/wiki/Deci-Platform> 🌟 NEW - Comet Logging <https://docs.ultralytics.com/yolov5/tutorials/comet_logging_integration> 🌟 NEW Good luck 🍀 and let us know if you have any other questions! — Reply to this email directly, view it on GitHub <#9584 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ATR65FZ24XEN6D2ITBK56NLWACJR3ANCNFSM6AAAAAAQVFQNA4> . You are receiving this because you were mentioned.Message ID: ***@***.***>

-- Jason Miller Customer-Facing Data Scientist <https://www.datarobot.com/> <https://www.linkedin.com/company/datarobot> <https://www.facebook.com/datarobotinc/> <https://twitter.com/DataRobot> <https://www.instagram.com/datarobot/> This email may contain confidential and privileged material for the sole use of the intended recipient. Any review, use, distribution or disclosure by others is strictly prohibited. If you are not the intended recipient, or authorized to receive for the recipient, please contact the sender by reply email and delete all copies of this message. Please see our Privacy Policy <https://www.datarobot.com/privacy/> to learn how we use your personal data. DataRobot, Inc. 225 Franklin Street, 13th Floor Boston, MA 02110

[github-actions]

👋 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 🚀 resources:

• Wiki – https://github.com/ultralytics/yolov5/wiki
• Tutorials – https://docs.ultralytics.com/yolov5
• Docs – https://docs.ultralytics.com

Access additional Ultralytics ⚡ 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 ⭐!

[pderrenger]

@jmiller-dr thank you for your kind words! If you have any further questions or need assistance with YOLOv5, feel free to ask.