blinjrm commited on
Commit
511910b
·
1 Parent(s): 4f4cd41

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +62 -15
README.md CHANGED
@@ -7,20 +7,67 @@ sdk: static
7
  pinned: false
8
  ---
9
 
10
- # Detection datasets
11
 
12
- *Easily load and transform datasets for object detection.*
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
13
 
14
- `detection_datasets` aims to make it easier to work with detection datasets.
15
-
16
- It is both an organisation sharing detection datasets on the 🤗 Hub, and a Python library to load, transform and export detection datasets to multiple formats corresponding to object detection frameworks / models.
17
-
18
- ---
19
-
20
- **Documentation**: https://blinjrm.github.io/detection-datasets/
21
-
22
- **Source Code**: https://github.com/blinjrm/detection-datasets
23
-
24
- ---
25
-
26
- **More datasets to come! 🔥**
 
 
 
 
 
 
 
 
 
 
 
 
7
  pinned: false
8
  ---
9
 
10
+ <div align="center">
11
 
12
+ <p><img src="https://raw.githubusercontent.com/blinjrm/detection-datasets/main/images/dd_logo.png" alt="logo" width="100"/></p>
13
+ <p><br></p>
14
+ <h1 id="detection-datasets">Detection datasets</h1>
15
+ <p><br></p>
16
+ <p><em>Easily load and transform datasets for object detection.</em></p>
17
+ <p></div>
18
+ <br></p>
19
+ <hr>
20
+ <p><strong>Documentation</strong>: <a href="https://blinjrm.github.io/detection-datasets/">https://blinjrm.github.io/detection-datasets/</a></p>
21
+ <p><strong>Source Code</strong>: <a href="https://github.com/blinjrm/detection-datasets">https://github.com/blinjrm/detection-datasets</a></p>
22
+ <p><strong>Datasets on Hugging Face Hub</strong>: <a href="https://huggingface.co/detection-datasets">https://huggingface.co/detection-datasets</a></p>
23
+ <hr>
24
+ <p><br></p>
25
+ <p><code>detection_datasets</code> aims to make it easier to work with detection datasets. </p>
26
+ <p>This library works alongside the <a href="https://huggingface.co/detection-datasets">Detection dataset</a> organisation on the 🤗 Hub, where some detection datasets have been uploaded in the format expected by the library, and are ready to use. </p>
27
+ <p>The main features are:</p>
28
+ <ul>
29
+ <li><strong>Read</strong> the dataset :<ul>
30
+ <li>From disk if it has already been downloaded.</li>
31
+ <li>Directly from the Hugging Face Hub if it <a href="https://huggingface.co/detection-datasets">already exist</a>.</li>
32
+ </ul>
33
+ </li>
34
+ <li><strong>Transform</strong> the dataset:<ul>
35
+ <li>Select a subset of data.</li>
36
+ <li>Remap categories.</li>
37
+ <li>Create new train-val-test splits.</li>
38
+ </ul>
39
+ </li>
40
+ <li><strong>Visualize</strong> the annotations and images.</li>
41
+ <li><strong>Write</strong> the dataset:<ul>
42
+ <li>To disk, selecting the target detection format: <code>COCO</code>, <code>YOLO</code> and more to come.</li>
43
+ <li>To the Hugging Face Hub for easy reuse in a different environment and share with the community.</li>
44
+ </ul>
45
+ </li>
46
+ </ul>
47
+ <p><br></p>
48
+ <div align="center">
49
 
50
+ <hr>
51
+ <p><em>Read the <a href="https://github.com/blinjrm/detection-datasets/blob/main/README.md#getting-started">quick start</a>, or directly jump to the tutorials:</em></p>
52
+ <table>
53
+ <thead>
54
+ <tr>
55
+ <th>Goal</th>
56
+ <th style="text-align:center">Tutorial</th>
57
+ <th style="text-align:center">Colab</th>
58
+ </tr>
59
+ </thead>
60
+ <tbody>
61
+ <tr>
62
+ <td>Load from disk and upload to the Hub</td>
63
+ <td style="text-align:center"><a href="https://blinjrm.github.io/detection-datasets/tutorials/1_Read/">Open in the docs</a></td>
64
+ <td style="text-align:center"><a href="https://colab.research.google.com/github/blinjrm/detection-datasets/blob/main/docs/tutorials/1_Read.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"></a></td>
65
+ </tr>
66
+ <tr>
67
+ <td>Load from the Hub and transform</td>
68
+ <td style="text-align:center"><a href="https://blinjrm.github.io/detection-datasets/tutorials/2_Transform/">Open in the docs</a></td>
69
+ <td style="text-align:center"><a href="https://colab.research.google.com/github/blinjrm/detection-datasets/blob/main/docs/tutorials/2_Transform.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"></a></td>
70
+ </tr>
71
+ </tbody>
72
+ </table>
73
+ <hr>