Create README.md

README.md

@@ -0,0 +1,107 @@
+---
+language:
+- en
+base_model:
+- Ultralytics/YOLO11
+tags:
+- yolo
+- yolo11
+- yolo11n
+- urchin
+- sea
+- marine-detection
+pipeline_tag: object-detection
+---
+# Yolo11n Sea Urchin Detector
+
+## Model Details / Overview
+This model was trained to detect sea urchins using the YOLO11 architecture. It leverages data from multiple open datasets to identify and locate urchins in various underwater images.
+
+- **Model Architecture**: YOLO11n
+- **Task**: Object Detection (Urchin Detection)
+- **Footage Type**: Underwater Footage (Color and Grayscale)
+- **Classes**: 1 (urchin)
+
+## Test Results
+![results](./results.jpg)
+
+## Model Weights
+The model's weights can be found [here](./yolo11n_urchin_trained.pt)
+
+# Intended Use
+- Real-time detections on underwater footage
+- Post-processed video/imagery for detecting sea urchins in underwater environments
+
+# Factors
+### Model Performance 
+- Multi-source Dataset: Trained on datasets that include color and urchin images from various angles, enabling the model to perform effectively across different visual inputs.
+- Model Architecture (YOLO11n): Lightweight and optimized for real-time urchin detection in underwater footage.
+- Training Data: The dataset includes a mix of color and grayscale images, split into 70% training, 20% validation, and 10% test data.
+- Training Parameters: Configured with 50 epochs, a 0.001 learning rate, and 640x640 image size for optimal model convergence.
+
+## Datasets
+The training data was collected, parsed and organized from open sources:
+1. **[Orange-OpenSource Marine-Detect](https://github.com/Orange-OpenSource/marine-detect)**
+2. **[Roboflow - Sakana Urchins CJLib](https://universe.roboflow.com/sakana/urchins-cjlib)**
+
+- **Roboflow Details**:
+  - **Workspace**: sakana
+  - **Project**: urchins-cjlib
+  - **Version**: 1
+  - **License**: CC BY 4.0
+  - **URL**: [https://universe.roboflow.com/sakana/urchins-cjlib/dataset/1](https://universe.roboflow.com/sakana/urchins-cjlib/dataset/1)
+
+### Dataset Composition:
+- **Training Images**: 1169
+- **Validation Images**: 334
+- **Test Images**: 168
+- **Train/Val/Test Split Ratio**: 7:2:1
+
+## Metrics
+Below are the key metrics from the model evaluation on the validation set:
+
+- **Precision**: 0.885
+- **Recall**: 0.861
+- **mAP50**: 0.937
+- **mAP50-95**: 0.852
+
+## Training Validation Results
+### Training and Validation Losses
+![Training and Validation Losses](./train/results.png)
+
+### Confusion Matrix
+![Confusion Matrix](./train/confusion_matrix.png)
+
+### Precision-Recall Curve
+![Precision-Recall Curve](./train/PR_curve.png)
+
+### F1 Score Curve
+![F1 Score Curve](./train/F1_curve.png)
+
+## Training Configuration
+- **Model Weights File**: `yolo11n_urchin_trained.pt`
+- **Number of Epochs**: 50
+- **Learning Rate**: 0.001
+- **Batch Size**: 32
+- **Image Size**: 640x640
+
+## Deployment
+### How to Use the Model
+
+To use the trained model, follow these steps:
+
+1. **Load the Model**:
+   ```python
+   from ultralytics import YOLO
+
+   # Load the model
+   model = YOLO("yolo11n_urchin_trained.pt")
+   
+## Limitations
+The model was trained on a mix of open source images. It may not generalize well to other environments or non-marine scenarios. Additionally, environmental variations, occlusions, or poor lighting may affect performance.
+
+## Additional Notes:
+Dataset Sources: 
+- Two datasets were combined to improve model robustness, allowing the model to adapt to varying lighting and coloration conditions.
+Ethical Considerations: 
+- The detection results should be validated before using them for critical applications. The model’s performance in new environments might vary, and it may have biases if certain types of sea urchins were underrepresented in the training datasets.