diff --git a/.github/ISSUE_TEMPLATE/--bug-report.md b/.github/ISSUE_TEMPLATE/--bug-report.md
index 500b606..5a05db2 100644
--- a/.github/ISSUE_TEMPLATE/--bug-report.md
+++ b/.github/ISSUE_TEMPLATE/--bug-report.md
@@ -1,41 +1,42 @@
----
-name: "\U0001F41BBug report"
-about: Create a report to help us improve
-title: ''
-labels: bug
-assignees: ''
+______________________________________________________________________
----
+name: "\\U0001F41BBug report" about: Create a report to help us improve title: '' labels: bug assignees: ''
+
+______________________________________________________________________
Before submitting a bug report, please ensure that you are using the latest versions of:
- - Python
- - PyTorch
- - This repository (run `git fetch && git status -uno` to check and `git pull` to update)
-
+
+- Python
+- PyTorch
+- This repository (run `git fetch && git status -uno` to check and `git pull` to update)
+
**Your issue must be reproducible on a public dataset (i.e COCO) using the latest version of the repository, and you must supply code to reproduce, or we can not help you.**
If this is a custom training question we suggest you include your `train*.jpg`, `test*.jpg` and `results.png` figures.
-
## 🐛 Bug
+
A clear and concise description of what the bug is.
## To Reproduce
+
**REQUIRED**: Code to reproduce your issue below
+
```
python train.py ...
```
-
## Expected behavior
+
A clear and concise description of what you expected to happen.
## Environment
-If applicable, add screenshots to help explain your problem.
- - OS: [e.g. Ubuntu]
- - GPU [e.g. 2080 Ti]
+If applicable, add screenshots to help explain your problem.
+- OS: \[e.g. Ubuntu\]
+- GPU \[e.g. 2080 Ti\]
## Additional context
+
Add any other context about the problem here.
diff --git a/.github/ISSUE_TEMPLATE/--feature-request.md b/.github/ISSUE_TEMPLATE/--feature-request.md
index b16020d..639c74f 100644
--- a/.github/ISSUE_TEMPLATE/--feature-request.md
+++ b/.github/ISSUE_TEMPLATE/--feature-request.md
@@ -1,13 +1,11 @@
----
-name: "\U0001F680Feature request"
-about: Suggest an idea for this project
-title: ''
-labels: enhancement
-assignees: ''
+______________________________________________________________________
----
+name: "\\U0001F680Feature request" about: Suggest an idea for this project title: '' labels: enhancement assignees: ''
+
+______________________________________________________________________
## 🚀 Feature
+
## Motivation
diff --git a/.github/workflows/format.yml b/.github/workflows/format.yml
index a814a9c..27b2c7d 100644
--- a/.github/workflows/format.yml
+++ b/.github/workflows/format.yml
@@ -1,20 +1,23 @@
-# Ultralytics 🚀, AGPL-3.0 license
-# Ultralytics Format Workflow
-# This workflow automatically formats code and documentation in pull requests and pushes to main branch
+# 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: [master]
+ branches: [main,master]
pull_request:
- branches: [master]
+ branches: [main,master]
jobs:
format:
runs-on: ubuntu-latest
steps:
- - name: Checkout Repository
- uses: actions/checkout@v4
- - name: Run Ultralytics Formatting Actions
+ - name: Run Ultralytics Formatting
uses: ultralytics/actions@main
+ with:
+ python: true
+ docstrings: true
+ markdown: true
+ spelling: true
diff --git a/README.md b/README.md
index 6778748..4d9056a 100755
--- a/README.md
+++ b/README.md
@@ -16,6 +16,7 @@ pip3 install -U -r requirements.txt
```
The following packages should be included:
+
- `numpy`: For numerical operations.
- `scipy`: Useful for scientific and technical computations.
- `torch`: The PyTorch machine learning framework.
@@ -30,6 +31,7 @@ Start by downloading the xView data from the [data download page](https://challe
# 🏋️♂️ Training
## Preprocessing Steps
+
Before we launch into training, we perform preprocessing on the targets to clean them up:
1. Outliers are removed using sigma-rejection.
@@ -38,13 +40,17 @@ Before we launch into training, we perform preprocessing on the targets to clean
## Starting the Training
+
**To start training**, execute `train.py` after you have downloaded the xView data. You'll need to specify the path to your xView data on line 41 (for local execution) or line 43 (if you're working in the cloud).
## Resuming Training
+
**To resume training**, use the following command:
+
```bash
train.py --resume 1
```
+
Training will continue from the most recent checkpoint found in the `latest.pt` file.
During training, each epoch will process 8 randomly sampled 608x608 chips from each full-resolution image. If you're using a GPU like the Nvidia GTX 1080 Ti, you can expect to complete around 100 epochs per day.
@@ -59,15 +65,15 @@ You'll see loss plots for bounding boxes, objectness, and class confidence that
During training, `datasets.py` will apply various augmentations to the full-resolution input images using OpenCV. Here are the specifications for each augmentation applied:
-| Augmentation | Description |
-|------------------------|-------------------------------------------|
-| Translation | +/- 1% (vertical and horizontal) |
-| Rotation | +/- 20 degrees |
-| Shear | +/- 3 degrees (vertical and horizontal) |
-| Scale | +/- 30% |
-| Reflection | 50% probability (vertical and horizontal) |
-| HSV Saturation | +/- 50% |
-| HSV Intensity | +/- 50% |
+| Augmentation | Description |
+| -------------- | ----------------------------------------- |
+| Translation | +/- 1% (vertical and horizontal) |
+| Rotation | +/- 20 degrees |
+| Shear | +/- 3 degrees (vertical and horizontal) |
+| Scale | +/- 30% |
+| Reflection | 50% probability (vertical and horizontal) |
+| HSV Saturation | +/- 50% |
+| HSV Intensity | +/- 50% |
Please note that augmentation is applied **only** during training and not during inference. All corresponding bounding boxes are automatically adjusted to match the augmented images.
@@ -88,6 +94,7 @@ If you use this repository or the associated tools and datasets in your research
🤝 We love contributions from the community! Our open-source projects thrive on your help. To start contributing, please check out our [Contributing Guide](https://docs.ultralytics.com/help/contributing). Additionally, we'd love to hear from you through our [Survey](https://ultralytics.com/survey?utm_source=github&utm_medium=social&utm_campaign=Survey). It's a way to **impact** the future of our projects. A big shoutout and thank you 🙏 to all our contributors!
+
