easyannotate 0.4.0__tar.gz → 0.4.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. {easyannotate-0.4.0 → easyannotate-0.4.1}/.gitignore +4 -0
  2. {easyannotate-0.4.0 → easyannotate-0.4.1}/PKG-INFO +14 -9
  3. {easyannotate-0.4.0 → easyannotate-0.4.1}/README.md +13 -8
  4. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/tools/install.py +15 -0
  5. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/annotations/coco.py +1 -1
  6. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/bktree.py +1 -1
  7. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/imaging.py +1 -1
  8. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/ops/dataset.py +1 -1
  9. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/ops/export.py +1 -1
  10. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/pipeline.py +1 -1
  11. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/annotate/render.js +9 -0
  12. {easyannotate-0.4.0 → easyannotate-0.4.1}/pyproject.toml +1 -1
  13. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/conftest.py +1 -1
  14. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_annotations.py +1 -1
  15. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_dataset_ops.py +1 -1
  16. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_exif.py +1 -1
  17. easyannotate-0.4.1/tests/test_install_clip.py +98 -0
  18. {easyannotate-0.4.0 → easyannotate-0.4.1}/LICENSE +0 -0
  19. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/__init__.py +0 -0
  20. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/__main__.py +0 -0
  21. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/__init__.py +0 -0
  22. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/attach.py +0 -0
  23. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/demo.py +0 -0
  24. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/images.py +0 -0
  25. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/labels.py +0 -0
  26. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/loop.py +0 -0
  27. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/projects.py +0 -0
  28. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/review.py +0 -0
  29. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/schema.sql +0 -0
  30. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/shapes.py +0 -0
  31. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/store.py +0 -0
  32. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/tools/__init__.py +0 -0
  33. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/tools/fake.py +0 -0
  34. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/tools/local.py +0 -0
  35. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/tools/postprocess.py +0 -0
  36. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/tools/protocol.py +0 -0
  37. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/tools/registry.py +0 -0
  38. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/tools/results.py +0 -0
  39. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/annotate/tools/serve.py +0 -0
  40. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/cli/__init__.py +0 -0
  41. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/cli/main.py +0 -0
  42. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/cli/menu.py +0 -0
  43. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/cli/render.py +0 -0
  44. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/__init__.py +0 -0
  45. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/annotations/__init__.py +0 -0
  46. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/annotations/csvfmt.py +0 -0
  47. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/annotations/dota.py +0 -0
  48. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/annotations/formats.py +0 -0
  49. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/annotations/labelme.py +0 -0
  50. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/annotations/model.py +0 -0
  51. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/annotations/voc.py +0 -0
  52. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/annotations/yolo.py +0 -0
  53. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/fs.py +0 -0
  54. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/ops/__init__.py +0 -0
  55. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/ops/analyze.py +0 -0
  56. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/ops/annotate_export.py +0 -0
  57. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/ops/audit.py +0 -0
  58. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/ops/augment.py +0 -0
  59. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/ops/collect.py +0 -0
  60. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/ops/combine.py +0 -0
  61. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/ops/convert.py +0 -0
  62. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/ops/dedup.py +0 -0
  63. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/ops/image.py +0 -0
  64. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/ops/labels.py +0 -0
  65. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/ops/pairing.py +0 -0
  66. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/ops/rename.py +0 -0
  67. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/ops/report.py +0 -0
  68. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/ops/visualize.py +0 -0
  69. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/pairs.py +0 -0
  70. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/parallel.py +0 -0
  71. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/provenance.py +0 -0
  72. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/registry.py +0 -0
  73. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/stats.py +0 -0
  74. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/types.py +0 -0
  75. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/core/writer.py +0 -0
  76. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/desktop.py +0 -0
  77. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/hardware.py +0 -0
  78. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/py.typed +0 -0
  79. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/__init__.py +0 -0
  80. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/app.py +0 -0
  81. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/binding.py +0 -0
  82. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/deps.py +0 -0
  83. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/jobs.py +0 -0
  84. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/limits.py +0 -0
  85. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/routers/__init__.py +0 -0
  86. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/routers/annotate.py +0 -0
  87. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/routers/local.py +0 -0
  88. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/routers/media.py +0 -0
  89. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/routers/predictions.py +0 -0
  90. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/routers/promote.py +0 -0
  91. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/routers/tools.py +0 -0
  92. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/annotate/api.js +0 -0
  93. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/annotate/app.js +0 -0
  94. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/annotate/assist.js +0 -0
  95. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/annotate/filmstrip.js +0 -0
  96. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/annotate/hit.js +0 -0
  97. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/annotate/labels.js +0 -0
  98. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/annotate/scene.js +0 -0
  99. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/annotate/shapelist.js +0 -0
  100. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/annotate/tools/box.js +0 -0
  101. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/annotate/tools/line.js +0 -0
  102. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/annotate/tools/obb.js +0 -0
  103. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/annotate/tools/point.js +0 -0
  104. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/annotate/tools/polygon.js +0 -0
  105. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/annotate/tools/select.js +0 -0
  106. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/annotate/undo.js +0 -0
  107. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/annotate/viewport.js +0 -0
  108. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/annotate.html +0 -0
  109. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/static/index.html +0 -0
  110. {easyannotate-0.4.0 → easyannotate-0.4.1}/data_factory/service/workspace.py +0 -0
  111. {easyannotate-0.4.0 → easyannotate-0.4.1}/easyannotate/__init__.py +0 -0
  112. {easyannotate-0.4.0 → easyannotate-0.4.1}/easyannotate/__main__.py +0 -0
  113. {easyannotate-0.4.0 → easyannotate-0.4.1}/easyannotate/project.py +0 -0
  114. {easyannotate-0.4.0 → easyannotate-0.4.1}/easyannotate/py.typed +0 -0
  115. {easyannotate-0.4.0 → easyannotate-0.4.1}/examples/web_api.py +0 -0
  116. {easyannotate-0.4.0 → easyannotate-0.4.1}/recipes/model_loop.yaml +0 -0
  117. {easyannotate-0.4.0 → easyannotate-0.4.1}/recipes/train_ready_yolo.yaml +0 -0
  118. {easyannotate-0.4.0 → easyannotate-0.4.1}/recipes/voc_to_coco.yaml +0 -0
  119. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/fake_trainer.py +0 -0
  120. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_annotate_api.py +0 -0
  121. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_annotate_attach.py +0 -0
  122. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_annotate_editor.py +0 -0
  123. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_annotate_store.py +0 -0
  124. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_clean_ops.py +0 -0
  125. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_compat.py +0 -0
  126. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_core.py +0 -0
  127. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_demo.py +0 -0
  128. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_desktop.py +0 -0
  129. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_export_classes.py +0 -0
  130. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_formats.py +0 -0
  131. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_imaging.py +0 -0
  132. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_infra.py +0 -0
  133. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_kinds.py +0 -0
  134. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_local_link.py +0 -0
  135. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_loop.py +0 -0
  136. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_new_ops.py +0 -0
  137. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_pipeline_cli.py +0 -0
  138. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_postprocess.py +0 -0
  139. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_public_api.py +0 -0
  140. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_review.py +0 -0
  141. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_review_b_findings.py +0 -0
  142. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_review_c_findings.py +0 -0
  143. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_review_d_findings.py +0 -0
  144. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_review_queue.py +0 -0
  145. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_service.py +0 -0
  146. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_sidecar.py +0 -0
  147. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_tools.py +0 -0
  148. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_tools_api.py +0 -0
  149. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_tools_batch.py +0 -0
  150. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_trust.py +0 -0
  151. {easyannotate-0.4.0 → easyannotate-0.4.1}/tests/test_wire.py +0 -0
@@ -15,6 +15,10 @@ Models/
15
15
  *.mp4
16
16
  *.avi
17
17
  *.mov
18
+ # Except the demo's own media: CC0 photos and the recording made from them.
19
+ !docs/demo_photos/*.jpg
20
+ !docs/demo.mp4
21
+ !docs/segmentation.mp4
18
22
 
19
23
  # ── Python ────────────────────────────────────────────────────────────────
20
24
  .venv/
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: easyannotate
3
- Version: 0.4.0
3
+ Version: 0.4.1
4
4
  Summary: Image annotation with nothing to set up: draw, review model predictions fast, export a correct dataset
5
5
  Project-URL: Homepage, https://shivpratapsinghpanwar.github.io/EasyAnnotate/
6
6
  Project-URL: Source, https://github.com/shivpratapsinghpanwar/EasyAnnotate
@@ -49,7 +49,7 @@ Description-Content-Type: text/markdown
49
49
 
50
50
  # EasyAnnotate
51
51
 
52
- ![EasyAnnotate: draw, name a class, review a model's predictions, export](https://raw.githubusercontent.com/shivpratapsinghpanwar/EasyAnnotate/main/docs/demo.gif)
52
+ ![EasyAnnotate on real photos: draw a box, outline with SAM, find every person, dog and car with a text prompt, review least sure first](https://raw.githubusercontent.com/shivpratapsinghpanwar/EasyAnnotate/main/docs/demo.gif)
53
53
 
54
54
  **Image annotation with nothing to set up.** Open a folder, draw a box, type a
55
55
  class name — that is the whole workflow. Load a model's predictions and review
@@ -339,9 +339,11 @@ easyannotate tools install --cpu # skip the GPU build
339
339
  easyannotate tools status # what this machine gets, and what is installed
340
340
  ```
341
341
 
342
- From a source checkout, before the first PyPI release:
343
- `easyannotate tools install --source .` The desktop app has the same thing
344
- as an "Install AI tools" button.
342
+ The tools come from PyPI as
343
+ [`easyannotate-tools`](https://pypi.org/project/easyannotate-tools/), pinned
344
+ to your `easyannotate` version. From a source checkout,
345
+ `easyannotate tools install --source .` installs your working copy instead.
346
+ The desktop app has the same thing as an "Install AI tools" button.
345
347
 
346
348
  The installer reads the GPU, its memory and its driver. NVIDIA cards get the
347
349
  PyTorch CUDA build their driver was made for (12.8 or 12.6; PyTorch 2.7 with
@@ -356,6 +358,9 @@ Then the Assist panel appears in the editor:
356
358
 
357
359
  - **Outline (SAM)** — drag a box, or click, on an object: SAM 2.1 traces it
358
360
  and you get a simplified polygon with draggable vertices.
361
+
362
+ ![Segmentation with SAM 2.1: a car from one rough box, three dogs from one click each, three people from a box each, every one a filled mask](https://raw.githubusercontent.com/shivpratapsinghpanwar/EasyAnnotate/main/docs/segmentation.gif)
363
+
359
364
  - **Find every…** — type a class name (or several: `door, handle`) and run it
360
365
  on this image, or on *every unreviewed image* as a job. The results are
361
366
  predictions: dashed, scored, filtered by the slider, accepted with `A`,
@@ -503,7 +508,7 @@ consumer; a web API is another.
503
508
 
504
509
  ## What it catches
505
510
 
506
- Run on the real Project_Door V3 set (3,686 images, 3,871 objects):
511
+ Run on the real door dataset, V3 (3,686 images, 3,871 objects):
507
512
 
508
513
  ```
509
514
  $ easyannotate inspect.health --folder ./pascal_voc
@@ -631,7 +636,7 @@ downloads); `easyannotate train` on 4 reviewed images, 3 epochs, then
631
636
  predicting 20 more: 16 s end to end.
632
637
 
633
638
  Decode-bound stages run across threads, in input order, so results stay
634
- reproducible. Measured on the real Project_Door set:
639
+ reproducible. Measured on the real door dataset:
635
640
 
636
641
  | Stage | Serial | Parallel | |
637
642
  |---|---|---|---|
@@ -715,7 +720,7 @@ not batch operations.
715
720
 
716
721
  - **COCO exported four classes where there were two.** Categories were keyed on
717
722
  the raw XML string, so `Open` and `open` became separate classes — splitting
718
- Project_Door V3 as 1341/1385/645/500. Export now folds case by default and
723
+ the door dataset's V3 as 1341/1385/645/500. Export now folds case by default and
719
724
  *reports* every merge; `labels.rename --fold-case` fixes it at the source, and
720
725
  `inspect.health` now flags it as an error before you get that far.
721
726
  - **SAM polygons exported as empty masks.** The two annotation tools write
@@ -762,6 +767,6 @@ landed, which is the failure that silently ruins a dataset.
762
767
 
763
768
  ## Datasets in this repository
764
769
 
765
- `Projects/Project_Door/` holds the door-state dataset (V3: 3686 images, 3871
770
+ `Projects/` holds the door-state dataset (V3: 3686 images, 3871
766
771
  objects) and `Models/Sam2.1_tiny/` the SAM 2.1 tiny checkpoint. Neither is
767
772
  tracked by git.
@@ -1,6 +1,6 @@
1
1
  # EasyAnnotate
2
2
 
3
- ![EasyAnnotate: draw, name a class, review a model's predictions, export](https://raw.githubusercontent.com/shivpratapsinghpanwar/EasyAnnotate/main/docs/demo.gif)
3
+ ![EasyAnnotate on real photos: draw a box, outline with SAM, find every person, dog and car with a text prompt, review least sure first](https://raw.githubusercontent.com/shivpratapsinghpanwar/EasyAnnotate/main/docs/demo.gif)
4
4
 
5
5
  **Image annotation with nothing to set up.** Open a folder, draw a box, type a
6
6
  class name — that is the whole workflow. Load a model's predictions and review
@@ -290,9 +290,11 @@ easyannotate tools install --cpu # skip the GPU build
290
290
  easyannotate tools status # what this machine gets, and what is installed
291
291
  ```
292
292
 
293
- From a source checkout, before the first PyPI release:
294
- `easyannotate tools install --source .` The desktop app has the same thing
295
- as an "Install AI tools" button.
293
+ The tools come from PyPI as
294
+ [`easyannotate-tools`](https://pypi.org/project/easyannotate-tools/), pinned
295
+ to your `easyannotate` version. From a source checkout,
296
+ `easyannotate tools install --source .` installs your working copy instead.
297
+ The desktop app has the same thing as an "Install AI tools" button.
296
298
 
297
299
  The installer reads the GPU, its memory and its driver. NVIDIA cards get the
298
300
  PyTorch CUDA build their driver was made for (12.8 or 12.6; PyTorch 2.7 with
@@ -307,6 +309,9 @@ Then the Assist panel appears in the editor:
307
309
 
308
310
  - **Outline (SAM)** — drag a box, or click, on an object: SAM 2.1 traces it
309
311
  and you get a simplified polygon with draggable vertices.
312
+
313
+ ![Segmentation with SAM 2.1: a car from one rough box, three dogs from one click each, three people from a box each, every one a filled mask](https://raw.githubusercontent.com/shivpratapsinghpanwar/EasyAnnotate/main/docs/segmentation.gif)
314
+
310
315
  - **Find every…** — type a class name (or several: `door, handle`) and run it
311
316
  on this image, or on *every unreviewed image* as a job. The results are
312
317
  predictions: dashed, scored, filtered by the slider, accepted with `A`,
@@ -454,7 +459,7 @@ consumer; a web API is another.
454
459
 
455
460
  ## What it catches
456
461
 
457
- Run on the real Project_Door V3 set (3,686 images, 3,871 objects):
462
+ Run on the real door dataset, V3 (3,686 images, 3,871 objects):
458
463
 
459
464
  ```
460
465
  $ easyannotate inspect.health --folder ./pascal_voc
@@ -582,7 +587,7 @@ downloads); `easyannotate train` on 4 reviewed images, 3 epochs, then
582
587
  predicting 20 more: 16 s end to end.
583
588
 
584
589
  Decode-bound stages run across threads, in input order, so results stay
585
- reproducible. Measured on the real Project_Door set:
590
+ reproducible. Measured on the real door dataset:
586
591
 
587
592
  | Stage | Serial | Parallel | |
588
593
  |---|---|---|---|
@@ -666,7 +671,7 @@ not batch operations.
666
671
 
667
672
  - **COCO exported four classes where there were two.** Categories were keyed on
668
673
  the raw XML string, so `Open` and `open` became separate classes — splitting
669
- Project_Door V3 as 1341/1385/645/500. Export now folds case by default and
674
+ the door dataset's V3 as 1341/1385/645/500. Export now folds case by default and
670
675
  *reports* every merge; `labels.rename --fold-case` fixes it at the source, and
671
676
  `inspect.health` now flags it as an error before you get that far.
672
677
  - **SAM polygons exported as empty masks.** The two annotation tools write
@@ -713,6 +718,6 @@ landed, which is the failure that silently ruins a dataset.
713
718
 
714
719
  ## Datasets in this repository
715
720
 
716
- `Projects/Project_Door/` holds the door-state dataset (V3: 3686 images, 3871
721
+ `Projects/` holds the door-state dataset (V3: 3686 images, 3871
717
722
  objects) and `Models/Sam2.1_tiny/` the SAM 2.1 tiny checkpoint. Neither is
718
723
  tracked by git.
@@ -40,6 +40,13 @@ from .local import child_environment, python_for_tools
40
40
  PROFILE = "profile.json"
41
41
  PYTHON_VERSION = "3.12"
42
42
 
43
+ #: YOLO-World's text encoder. Ultralytics installs it on first use, with git;
44
+ #: measured on a fresh install from PyPI with no git on PATH, that failed and
45
+ #: text prompts said "No module named 'clip'". The app's environment has no
46
+ #: pip for it either. So the installer brings it: a GitHub archive, which
47
+ #: needs no git, pinned to one commit.
48
+ CLIP = "clip @ https://github.com/ultralytics/CLIP/archive/7ffa84b3bfa40c42ecc1c77147a855e69cb2dd40.zip"
49
+
43
50
  #: Run in the new environment. Real work on the device, not
44
51
  #: torch.cuda.is_available(): measured on a 529 driver with the cu126 build,
45
52
  #: that said True while every allocation failed ("device busy or unavailable").
@@ -205,6 +212,14 @@ def install(
205
212
  packages = [f"easyannotate-tools=={__version__}"]
206
213
  on_line("installing the EasyAnnotate tools and Ultralytics")
207
214
  run(pip + packages)
215
+ # A step of its own: a network that reaches PyPI but not github.com then
216
+ # loses text prompts, not the whole install.
217
+ on_line("installing CLIP for text prompts, from github.com")
218
+ try:
219
+ run(pip + [CLIP])
220
+ except InstallError:
221
+ on_line("warning: CLIP did not install (is github.com reachable?) -- "
222
+ "outlines work; text prompts will not until a reinstall")
208
223
 
209
224
  profile = {
210
225
  "device": chosen.device,
@@ -3,7 +3,7 @@
3
3
  The category handling here is deliberate. The original converter keyed
4
4
  categories on the raw XML string, so a dataset whose labels drifted between
5
5
  ``Open`` and ``open`` came out with four classes instead of two -- exactly what
6
- happened to Project_Door V3 (Close/Open/open/close split 1341/1385/645/500).
6
+ happened to the door dataset's V3 (Close/Open/open/close split 1341/1385/645/500).
7
7
  The builder now folds case by default and reports every merge it made, so the
8
8
  drift is fixed *and* visible rather than silently baked into the export.
9
9
  """
@@ -2,7 +2,7 @@
2
2
 
3
3
  Perceptual dedup needs "find everything within N bits of this hash". Doing that
4
4
  by comparing every image to every kept image is O(n^2): on the 15k-image
5
- Project_Door set that is ~112 million comparisons, which is why the original
5
+ door dataset that is ~112 million comparisons, which is why the original
6
6
  script was only ever run on small folders.
7
7
 
8
8
  A BK-tree exploits the triangle inequality -- Hamming distance is a metric, so
@@ -60,7 +60,7 @@ def image_size(path: Path) -> tuple[int, int]:
60
60
  relative to the image the annotator drew on and the trainer loads, with
61
61
  nothing anywhere reporting an error.
62
62
 
63
- Verified on the current Project_Door data: 3,000 of 3,000 images are
63
+ Verified on the current door dataset: 3,000 of 3,000 images are
64
64
  orientation 1, so nothing is corrupt today. It arrives with the first phone
65
65
  photo a public tool receives.
66
66
  """
@@ -2,7 +2,7 @@
2
2
 
3
3
  The README listed train/test splitting as a supported capability but no script
4
4
  ever implemented it. It is implemented here, and stratified by default -- an
5
- unstratified random split of an imbalanced set (Project_Door has ~200 hard
5
+ unstratified random split of an imbalanced set (the door dataset has ~200 hard
6
6
  negatives against ~3500 positives) can easily land almost every negative in one
7
7
  side and skew the evaluation.
8
8
  """
@@ -3,7 +3,7 @@
3
3
  Two behaviour changes from the original converter, both deliberate:
4
4
 
5
5
  * Categories fold case by default, so ``Open`` and ``open`` are one class. The
6
- original produced four classes for Project_Door V3 where there are two.
6
+ original produced four classes for the door dataset's V3 where there are two.
7
7
  * ``area`` is the true polygon area when a mask exists, not the box area.
8
8
 
9
9
  Both are reported in the result, so the export never changes your data silently.
@@ -6,7 +6,7 @@ someone else, or from a web backend, without anyone remembering the order.
6
6
 
7
7
  name: door-v4
8
8
  vars:
9
- root: D:/Data_factory/Projects/Project_Door/working
9
+ root: ./datasets/doors/working
10
10
  steps:
11
11
  - op: clean.orphans
12
12
  with: {folder: "${root}", scope: labels, action: delete}
@@ -84,6 +84,15 @@ export function draw(ctx, rect, scene, view, mips, options = {}) {
84
84
  if (selected) drawVertices(ctx, shape.polygon, colour, unit);
85
85
  } else if (shape.polygon && shape.polygon.length >= 3) {
86
86
  tracePath(ctx, shape.polygon, true);
87
+ // A mask is a region, not a wire: a light fill in the class colour
88
+ // shows what it covers at a glance, and the photo still shows through.
89
+ if (kind === "polygon") {
90
+ const alpha = ctx.globalAlpha;
91
+ ctx.globalAlpha = alpha * (selected ? 0.3 : 0.22);
92
+ ctx.fillStyle = colour;
93
+ ctx.fill();
94
+ ctx.globalAlpha = alpha;
95
+ }
87
96
  ctx.stroke();
88
97
  if (selected) drawVertices(ctx, shape.polygon, colour, unit);
89
98
  if (selected && kind === "obb") drawRotationHandle(ctx, shape, colour, unit, view.scale);
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "easyannotate"
3
- version = "0.4.0"
3
+ version = "0.4.1"
4
4
  description = "Image annotation with nothing to set up: draw, review model predictions fast, export a correct dataset"
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.12"
@@ -123,7 +123,7 @@ def make_pair(folder: Path, stem: str, label: str, seed: int, **kwargs) -> tuple
123
123
 
124
124
  @pytest.fixture
125
125
  def dataset(tmp_path: Path) -> Path:
126
- """A small dataset carrying every defect the real Project_Door set had.
126
+ """A small dataset carrying every defect the real door dataset had.
127
127
 
128
128
  Contents: case-variant classes, both polygon dialects, a hard negative, an
129
129
  exact duplicate, an orphan image, an orphan label, and a corrupt XML.
@@ -134,7 +134,7 @@ class TestCocoBuilder:
134
134
  for annotation in self._two_spellings():
135
135
  builder.add(annotation)
136
136
  document = builder.build()
137
- # This is the Project_Door V3 defect: four classes where there are two.
137
+ # This is the door dataset's V3 defect: four classes where there are two.
138
138
  assert len(document["categories"]) == 1
139
139
  assert builder.categories.merges() == {"Open": ["Open", "open"]}
140
140
 
@@ -140,7 +140,7 @@ class TestSort:
140
140
 
141
141
  class TestCocoExport:
142
142
  def test_case_variants_collapse_to_one_class(self, dataset: Path):
143
- """The Project_Door V3 defect: four classes exported where there are two."""
143
+ """The door dataset's V3 defect: four classes exported where there are two."""
144
144
  output = dataset.parent / "coco"
145
145
  result = df.run("export.coco", {"folder": dataset, "output": output})
146
146
 
@@ -6,7 +6,7 @@ operation in this package do not. So a person draws a box on the *displayed*
6
6
  image and we record it against the *stored* dimensions -- rotated 90 degrees
7
7
  from the pixels a trainer will load, with nothing anywhere reporting an error.
8
8
 
9
- Not currently live: all 3,000 sampled Project_Door images are orientation 1.
9
+ Not currently live: all 3,000 sampled door-dataset images are orientation 1.
10
10
  It arrives with the first phone photo, which is exactly what a public
11
11
  annotation tool receives. These tests build the tagged images the real data
12
12
  has never contained.
@@ -0,0 +1,98 @@
1
+ """The installer brings YOLO-World's CLIP itself, with no git.
2
+
3
+ Found by installing from PyPI on a machine without git on PATH: Ultralytics'
4
+ own first-use install of CLIP needs git, failed, and every text prompt said
5
+ "No module named 'clip'". SAM worked, so nothing else showed it.
6
+ """
7
+
8
+ import subprocess
9
+ from pathlib import Path
10
+
11
+ import pytest
12
+
13
+ from data_factory import hardware
14
+ from data_factory.annotate.tools import install as installer
15
+
16
+
17
+ @pytest.fixture
18
+ def env(tmp_path, monkeypatch):
19
+ home = tmp_path / "toolshome"
20
+ monkeypatch.setenv("DATAFACTORY_TOOLS_HOME", str(home))
21
+ python = installer.tools_python(home)
22
+ python.parent.mkdir(parents=True)
23
+ python.write_bytes(b"")
24
+ monkeypatch.setattr(hardware, "detect", lambda: hardware.Hardware(os="Windows", cpu_count=8, ram_gb=16))
25
+ monkeypatch.setattr(installer, "bundled_wheels", lambda: [])
26
+ state = {"commands": [], "fail": None}
27
+
28
+ class Proc:
29
+ def __init__(self, cmd, **kw):
30
+ self.cmd = [str(part) for part in cmd]
31
+ state["commands"].append(self.cmd)
32
+ self.stdout = iter(["ok\n"])
33
+
34
+ def wait(self):
35
+ return 1 if state["fail"] and state["fail"](self.cmd) else 0
36
+
37
+ def poll(self):
38
+ return self.wait()
39
+
40
+ monkeypatch.setattr(installer.subprocess, "Popen", Proc)
41
+ probe = 'PROBE {"device": "cpu", "torch": "2.7.1", "error": ""}\n'
42
+ monkeypatch.setattr(installer.subprocess, "run",
43
+ lambda *a, **k: subprocess.CompletedProcess(a[0], 0, probe, ""))
44
+ return state
45
+
46
+
47
+ def _clip_after_the_tools(commands, tools_part):
48
+ """CLIP is installed, into the same environment, after the tools."""
49
+ tools = next(i for i, c in enumerate(commands) if any(tools_part in part for part in c))
50
+ clip = next(i for i, c in enumerate(commands) if installer.CLIP in c)
51
+ assert clip > tools, commands
52
+ assert commands[clip][:-1] == commands[tools][:commands[clip].index(installer.CLIP)], "same pip, same environment"
53
+
54
+
55
+ @pytest.mark.parametrize("uv", ["uv", None])
56
+ def test_clip_is_installed_with_the_tools_from_pypi(env, monkeypatch, uv):
57
+ monkeypatch.setattr(installer, "find_uv", lambda: uv)
58
+ installer.install(on_line=lambda line: None)
59
+ _clip_after_the_tools(env["commands"], "easyannotate-tools==")
60
+
61
+
62
+ def test_clip_is_installed_from_a_checkout_and_from_bundled_wheels(env, monkeypatch, tmp_path):
63
+ monkeypatch.setattr(installer, "find_uv", lambda: "uv")
64
+ installer.install(source=tmp_path / "checkout", on_line=lambda line: None)
65
+ _clip_after_the_tools(env["commands"], "checkout")
66
+
67
+ env["commands"].clear()
68
+ wheel = tmp_path / "easyannotate_tools-0.4.0-py3-none-any.whl"
69
+ monkeypatch.setattr(installer, "bundled_wheels", lambda: [wheel])
70
+ installer.install(on_line=lambda line: None)
71
+ _clip_after_the_tools(env["commands"], "easyannotate_tools-0.4.0")
72
+
73
+
74
+ def test_no_github_costs_text_prompts_not_the_install(env, monkeypatch):
75
+ """A network that reaches PyPI but blocks github.com: SAM must still install."""
76
+ monkeypatch.setattr(installer, "find_uv", lambda: "uv")
77
+ env["fail"] = lambda cmd: installer.CLIP in cmd
78
+ lines = []
79
+ profile = installer.install(on_line=lines.append)
80
+ assert profile["verified_device"] == "cpu"
81
+ assert installer.status()["installed"]
82
+ assert any("CLIP did not install" in line for line in lines), lines
83
+
84
+
85
+ def test_a_failed_tools_install_still_fails(env, monkeypatch):
86
+ monkeypatch.setattr(installer, "find_uv", lambda: "uv")
87
+ env["fail"] = lambda cmd: any("easyannotate-tools==" in part for part in cmd)
88
+ with pytest.raises(installer.InstallError):
89
+ installer.install(on_line=lambda line: None)
90
+
91
+
92
+ def test_clip_needs_no_git_and_is_pinned():
93
+ name, _, url = installer.CLIP.partition(" @ ")
94
+ assert name == "clip"
95
+ assert url.startswith("https://github.com/ultralytics/CLIP/archive/") and url.endswith(".zip")
96
+ assert "git+" not in installer.CLIP
97
+ commit = Path(url).stem
98
+ assert len(commit) == 40 and all(c in "0123456789abcdef" for c in commit), "pin a commit, not a branch"
File without changes