Upload folder using huggingface_hub

.gitattributes

@@ -33,3 +33,140 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+train/data/images/0091adebfcb5f89a5fba26f6dbee05a9fad57175.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/057a29579ba6406ad3c9283adc1982a2ef039896.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/07de3c8342cfb1c10bc8a80236716269ff717bae.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/0858f8b85fdd8c24ac2193945396193a1b5a5425.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/09b3fd8cf275dacb240560bb1a10197ecb708930.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/09e202b87fd773b618a28734a4e4d3991f674c33.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/0a3e72c2be56c5a09ba92d1ca8b258911f615775.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/0b25ba1afea366789a02d7ed29e00866cde349bc.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/0c2c20cde5abaa9fd3d8790334fa5f729a1a6cb6.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/0c63a5caf9483f091842467318c38779dab042db.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/0def4e58ede4eec142a5f38e8e40017ca96ad219.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/10fac2a268bc6458e0cbdd320e8c226acc873e60.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/1149a5714b9996e444a684bb18f084f45828bb22.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/11632fd86170ac8c73859fec470c7f8d9d744180.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/16dd072c9fc679c247d769ad57f779ef7615e64b.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/18448c73438fc5bd382590b7132bcffc8f77096c.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/1966fd7abebfbe5c85914e9c5b9b164e70474a1b.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/19dbcbd3e622ae131d4485981626a0b5a054f5d3.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/1a24f792ad050260800db77c3d18727241c30947.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/1ec7e95745cfa23d61f43f458b847ca40eee6984.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/2000563f22e01e119e109d2e393e1fa9d1c37c8d.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/211b831639a7943abb6a88eea27a0321fa99908d.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/212f863866ad46f047326f8cf8b7c57b65beba86.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/213215993ce40d5ba5022776d1f4bd62159219bd.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/213ad700d26c21410d7a6822613e2f512807ecfa.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/233cb9eec68ba1890eaac511b38d742d01c5b78a.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/269eb61af28eaf07fdcdd464d697330c12ae431e.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/2ca28b1da3d20b79a2a8330b34e3319716ef8d64.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/2d510e9c557a4048e7f9831e1a5f4fde1accfdcb.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/2d5d1a01cda890e66ab50c9e8adcb0fb60de1a68.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/2ed1f720a8704f0d16a7d78e6ad2b1033e4079d8.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/302f56828b011703b5af6aa9b7441110925d5284.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/3165af409b58bd8af871b53c629de5012c2c5fc3.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/34ad243f197bdc83dcef6052a0755050afcf2f2e.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/362093a4bc31591ffea317c41d0179102abd57ca.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/3823b2c567af7b65123b6a4355ffc5bba42271c8.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/3b11c8dac1c6a8c722d51847dd447f9908ed6953.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/3bbe9ff28afeef6df455cc8406f88947baf41445.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/3f4ddae2adc70b2810e0d8ace0c4b3468fc922e8.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/3f8de64309a193e1a1a1389d7fbfc7390892badc.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/416fa969e7c671c4fd5670714304a2be91795a20.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/41f1c6c1ae5ab9639949437bd47e7ee94bc9bf38.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/4835158c093e3ffd52342a423809364754226b2b.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/4a6279b1c2151f7d1eec87d6afd939ddcaa66601.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/4b432acdc1a3ce7f969bdf234b3b3050d3b3d924.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/53a01ff48d650b43cf17cc5fe1bf494aee25616c.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/56c28acf11c5decc8d221f1ca2e3df6bd2d049d4.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/57ed0c91325ebfd4ab57b6ee7d6755013e2912c4.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/60768f20302a19d26b68b54686dd00207ec16ab1.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/6411a2eb71083e3b1ec21ae9ba7d6b0c2057486b.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/64b69bfd6ebc7aab4c59dd7eaab36ec6687d5a4f.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/6591a5973bf43844b54a56923fd8269e36f545fa.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/6712ada9ee0d76aa6855ec71527aaab91fe775ca.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/68044adadc1f99dd2d091ac5c8f107c595d3dfe4.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/6c7f4135347c97002cc509191190489c70b019c2.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/6caaabb091b3e4d5a96f906d043b510672fe5751.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/6cdd254f70783fde4ef918397b9928c055c31a6e.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/6df6ed6bf2c45b9f563fed96c54c202ca36801a6.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/717b6337d94f91b668cd3345b57548f7281d928c.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/72248b60ff1b333706360f1963cedb9eab96c503.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/723b3be297360a03eaa3448d47a23458a71c6b83.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/7345707b622b904d8596597005d4d3243e8c720d.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/75bb59d95441573f403a39e955067ca4c91c9206.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/7aec9418171da9ade28c28711c9154b46c59fd4c.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/7c93c5cf5e39d4ed21e6d9e247aba32bba1e77cf.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/7e8599e2becd9b4c556291688b281d7df0a17fc2.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/81d022c02a3d6edd0adb48a0e7775e586cfc798f.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/82f66c4b9c7497bd7e4d7844e99fcdfa4797ab6d.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/8396d3bcf1af915c6017798bc3931a50e035fa35.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/873067d35eab53239bc8eaa3518e7e86c6137751.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/88f2be7e541422cb1907913745289d84caad8a64.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/895a1cc14227639f36b0c8a51a172e262b9a85a1.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/8c265861b3f212435e3b47a56ba1dffe756563e8.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/8da3dae46b78f22ea5d5767f037585ceddec91e9.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/8efbe84e4bc438f5cb00b85c56da39b698ec2403.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/91dd2d6c11a95a8ab1fde7038ce8beeca2563f85.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/943ef2e48e0573c826c9d3196b869e2acdbe4b22.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/95b888cca2d084c1cce4719558d9f2cc5dee9aeb.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/96997251cb2d29d6e4b44c93f04d02acf9d70eb6.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/9c94bc5a0e42903d9a82b48c36e7c2a8f5d4edde.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/9d1afdef0ace707ae00a7bf3068e2ae01c91391b.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/9d8e8700f5fbc7c1645c59e057d05eff910fbdd2.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/a16cb0e7a01bcbd8886a9158a57eac677dda32c2.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/a2c661b36d4d90347cbc293140ebd08139efad8c.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/a39428c0990c7b281b1f72c52ce8a0c96cb76a60.webp filter=lfs diff=lfs merge=lfs -text
+train/data/images/a7868c3e09167fe55b094129d560ef83521c5395.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/a95346412eeed4427f5e2a4dd114bc644dd8c667.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/ac448fb4f13b9625e101988eab36e9327ea756f5.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/aca23d3803f305e35173fffd661249cbeb86f282.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/aedd2a22d300537657f5d86ee7b0d037c0fc6aa0.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/afb7ef626b79bb323d6668293567c765550cbcc5.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/afc2b715ec8b7ee2b439e248c473685e0b3230af.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/b14259eb63660b602c024997e7e2e33091a52993.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/b1627e6fc85ec2548deaaaa92a440f0b33e2569b.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/b24e100245a0087d7c13352bbc40db2d51e48b3d.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/b9e7ee5cf684bfb7dce477acb9f7679bc528317a.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/bb77786b35084ad4d8ae108d7f2c46720530571d.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/bbe1c3fe8c0f09a10c32a69fdc9bc4323e584c67.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/c1d8b401e449733f19d32805c40aee4fafbc631b.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/c1e1a508068bf406d5f8d5352888a7ddef501ea6.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/c26828fda1ec04b30f01955e78e8765c0cf7f993.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/c51b3af203816478323672e4e5f4e2dfe92021ab.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/c897d423efa0b078a31e745e0379a48d4c5aaa44.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/c9cb629ae7f3a4df17153f9e228888b511a3f8df.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/cb82349e33740e07c907a4de3efe22ea32558d52.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/cc5fe1c6d53b3dea3d7a3cb4828dc7c90851af73.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/ced2837d3160d3a33f4465b90ee53db99452eaf5.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/cf41a5189775028a7d22776778efbfc9e3a6a1ef.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/d01cbccd080e3894d6e7ae064276ea385e0c63d5.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/d54a49da740521ff4b2419a0c7f3dcb80049d449.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/da980999897949db9693ddf30ec22ce6a38974d5.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/dd143f5f9ca77f2d11718ee2957fb1cb8b4941a9.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/df710130b188b93bbb85d2196f7d921e9d99d6bb.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/e3bfd3635dbc0efcab18a5f251a641039481d7c9.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/e4e4bdb7727a68e46e244c46d4b625733791f0e0.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/e65982052a28bb225c41129bf520b636d3f5c993.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/e69827c1d179e2cff9f1dfd745cd7f864cde9b44.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/e8efa238f38e4b1d7d6637875c5db680789d6434.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/e925224221c558ba59ebdfe2171f0a24e9d22596.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/ea7734c33b77abe22f2686fcb792e294e0b91f3c.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/eba5dbad20b4b5970e014d3780cc4bce0cdc3f0f.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/ecd2d0ad8d921cb16df6321d3173bb40e17ceb18.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/ecd391135d962276d9695a3b92ca5bc99ab47472.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/eee25dbb6e5acfd232f3b06d2634622146508cff.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/ef218422623f25027414d833d5eda1a9e092951f.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/f000712509be2b3aa7ca8b8a088a83b4b651295a.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/f044c830f1a824aebddda957c7f1f48fff5b5323.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/f08ec936ae59fa9cd9fe2706c8f7f47dbc42f9c4.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/f2005ba22e54fb2ca12e54805394c09357e8bba3.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/f292d8e2973ceb973a7b69a22289e8615128ec1a.png filter=lfs diff=lfs merge=lfs -text
+train/data/images/f39875ba5456839611670c1511558631f2425028.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/f677afa36ba02078745b41049fdacd20de244785.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/f874be4a158f1a8e2641b612233d7b3e1fc8d1e3.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/f927b4372f85162d0bad7059228d3490ffb48f79.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/fc0f3cdc42d1af9b05a1ff82f53147d3b9133b1c.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/fd3f697eab37eeadc6e0ae1c068197c9923ab8f2.jpg filter=lfs diff=lfs merge=lfs -text
+train/data/images/ff05ed7bd591f1f3c07d87d9a50491eb5c28d36c.jpg filter=lfs diff=lfs merge=lfs -text

model/best.onnx

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:690f0eb7d626de52902665ccd233629f27a75443b8420aa5e884cc7f248a9860
+size 105941004

train/README.md

@@ -0,0 +1,175 @@
+
+---
+library_name: ultralytics
+pipeline_tag: object-detection
+tags:
+  - computer-vision
+  - object-detection
+  - oriented-object-detection
+  - yolo
+  - yolov8
+  - onnx
+---
+
+# Outflock Camera Component OBB Model and Dataset
+
+This repository contains a YOLOv8 medium oriented-bounding-box model and its
+training dataset. The model detects three parts of fixed camera systems:
+
+| ID | Class | Description |
+| ---: | --- | --- |
+| 0 | `Body` | Camera body or outer housing. |
+| 1 | `Lens` | Visible camera lens or optical module. |
+| 2 | `System` | The complete camera assembly or installed system. |
+
+The model was developed for experiments to recognize Flock ALPR camera systems and their specific components. *This model is for educational purposes only and should not be used for illegal purposes.*
+
+ Flock cameras are showing up across the country, without the consent of citizens and are impinging on personal privacy and civil liberties - while also continuously being used for nefarious purposes by the very organizations citizens are told to trust.
+
+For more information on Flock and on the widespread utilization of ALPR camera systems, please see [DeFlock.org](https://deflock.org).
+
+## Model details
+
+| Property | Value |
+| --- | --- |
+| Architecture | Ultralytics YOLOv8m-OBB |
+| Task | Oriented object detection |
+| Format | ONNX |
+| Model file | `model/best.onnx` |
+| Model size | 105,941,004 bytes, approximately 101 MiB |
+| SHA-256 | `690f0eb7d626de52902665ccd233629f27a75443b8420aa5e884cc7f248a9860` |
+| Ultralytics version recorded in ONNX | 8.4.104 |
+| Input | `images`, float32 `[1, 3, 960, 960]` |
+| Output | `output0`, float32 `[1, 8, 18900]` |
+| ONNX opset | 12 |
+| Batch size | 1, fixed |
+| Embedded NMS | No |
+
+Each raw output prediction contains four oriented-box values, three class
+scores, and one angle value. Confidence filtering and class-aware rotated NMS must be applied by the consumer.
+
+The Outflock OpenCV pipeline letterboxes images to 960 by 960 pixels with a `(114, 114, 114)` fill color, scales pixels by `1 / 255`, converts BGR to RGB, and uses NCHW layout. Detected boxes are mapped back into the original image coordinates after inference.
+
+## Training configuration
+
+The model was initialized from `yolov8m-obb.pt` and trained using
+`train/trainObbModel.py` with the following configuration:
+
+| Setting | Value |
+| --- | --- |
+| Maximum epochs | 50 |
+| Early-stopping patience | 20 epochs |
+| Image size | 960 |
+| Batch size | 16 |
+| Optimizer | Automatic selection |
+| Mixed precision | Enabled |
+| Pretrained weights | Enabled |
+| Training device | CUDA device 0 |
+| Workers | 8 |
+
+Configured augmentations include limited rotation, translation, scale,
+perspective, horizontal flipping, mosaic, and mixup. Vertical flipping and
+copy-paste augmentation are disabled. See `train/trainObbModel.py` for the exact values.
+
+No training history, held-out test split, or evaluation metrics are included
+with the current export. The validation split was used during training, so it
+should not be treated as an independent test set.
+
+## Dataset summary
+
+The uploadable dataset is generated at `train/datasets/camera_obb` in
+Ultralytics YOLO OBB format.
+
+| Split | Images | OBB annotations | Body | Lens | System |
+| --- | ---: | ---: | ---: | ---: | ---: |
+| Train | 152 | 429 | 156 | 152 | 121 |
+| Validation | 37 | 98 | 38 | 30 | 30 |
+| Total | 189 | 527 | 194 | 182 | 151 |
+
+There is no test split. The preparation script creates a deterministic 80/20
+train/validation split using seed 42 and excludes images whose matching label file is absent or fails validation.
+
+The generated dataset contains 149 JPEG, 35 PNG, and 5 WebP images. Image widths range from 320 to 4,032 pixels and heights range from 180 to 3,410 pixels. The median width is 1,200 pixels and the median height is 820 pixels.
+
+### Directory layout
+
+```text
+datasets/camera_obb/
+├── data.yaml
+├── images/
+│   ├── train/
+│   └── val/
+└── labels/
+    ├── train/
+    └── val/
+```
+
+The generated `labels/*.cache` files are Ultralytics caches and are not part
+of the underlying annotation format. They may be deleted and regenerated.
+
+### Annotation format
+
+Each image has a same-stem `.txt` label file. Every line describes one
+oriented bounding box:
+
+```text
+class_id x1 y1 x2 y2 x3 y3 x4 y4
+```
+
+The four corner points are stored in polygon order. Coordinates are normalized to the image width and height and are expected to fall in the inclusive range from 0 to 1.
+
+Example:
+
+```text
+1 0.31 0.42 0.46 0.39 0.49 0.53 0.34 0.56
+```
+
+## Reproducing the dataset and model
+
+The training script rebuilds the generated dataset from `train/data`, trains the model, and optionally exports ONNX:
+
+```bash
+python train/trainObbModel.py --onnx
+```
+
+The main dependencies are PyTorch, Ultralytics, and PyYAML. Training expects a CUDA device by default. The generated `data.yaml` contains an absolute local path, so run the preparation script again or update its `path` entry after moving the dataset.
+
+Run OpenCV inference on one image with:
+
+```bash
+python train/testObbOpenCv.py path/to/image.jpg \
+  --model flight/model/best.onnx \
+  --output path/to/output.jpg \
+  --conf 0.25 \
+  --iou 0.45 \
+  --imgsz 960
+```
+
+## Intended uses
+
+- Research and development involving oriented detection of the three camera component classes above.
+- Testing Outflock's OpenCV and flight-camera inference pipeline.
+- Fine-tuning or benchmarking on imagery with a similar viewpoint and domain, after establishing appropriate data rights.
+
+## Limitations and out-of-scope uses
+
+- The dataset is small and was collected around a narrow search concept.
+- Search-engine sampling can introduce geographic, product, viewpoint,
+  resolution, and source-selection biases.
+- Random image splitting does not guarantee that near-duplicate images or the same physical camera do not appear in both splits.
+- The dataset has no independent test set and the exported model has no
+  published accuracy, precision, recall, or mAP measurements.
+- Performance on other camera designs, aerial viewpoints, difficult weather, occlusion, motion blur, or low-light imagery is unknown.
+- This model should not be used as the sole input to safety-critical navigation, law enforcement, identification, or surveillance decisions.
+
+## Licensing, provenance, and privacy
+
+The ONNX metadata identifies the exported Ultralytics model as AGPL-3.0. Users are responsible for complying with the applicable Ultralytics and model weight licensing terms.
+
+The image acquisition utility performs a DuckDuckGo image search for
+`flock camera` and downloads third-party image results. The current dataset does not include a source URL, author, attribution, consent record, or license manifest for each image. Consequently, the right to redistribute the images cannot be established from this repository alone, and no dataset license is asserted by this card.
+
+Before publishing the dataset, audit every image for copyright and
+redistribution rights, remove images without adequate permission, and review the files and embedded metadata for people, license plates, addresses, trademarks, or other sensitive information. Until that audit is complete, a private or access-controlled Hugging Face dataset repository is recommended.
+
+This README documents the current files and does not itself grant permission to redistribute the underlying images.