Update README.md
Browse files
README.md
CHANGED
|
@@ -88,35 +88,6 @@ truncated or altered file is detected rather than trusted.
|
|
| 88 |
Commercial use, redistribution and modification are permitted; the only condition is attribution —
|
| 89 |
credit the QuantEM authors, link to the licence, and indicate if you made changes.
|
| 90 |
|
| 91 |
-
The `quantem-core` and `napari-quantem` **code** is BSD-3-Clause, which is a separate licence on a
|
| 92 |
-
separate thing.
|
| 93 |
-
|
| 94 |
-
CC BY rather than a software licence because weights are not source code: the "source and binary
|
| 95 |
-
form" language of BSD does not map onto a state dict. CC BY is also what most of the underlying
|
| 96 |
-
annotation data uses, which keeps the attribution chain coherent.
|
| 97 |
-
|
| 98 |
-
### Position on training data
|
| 99 |
-
|
| 100 |
-
Training data for the released heads is CC0 or CC BY 4.0 with the exceptions below. Two sources
|
| 101 |
-
carry copyleft rather than field-of-use terms:
|
| 102 |
-
|
| 103 |
-
| Source | Licence | Share of that organelle's train+val crops |
|
| 104 |
-
|---|---|--:|
|
| 105 |
-
| DeepContact | GPL-3.0 (applied to data) | mito 5.6 %, ER 11.4 % |
|
| 106 |
-
| ASEM / Incasem | CC BY-SA 4.0 | mito 2.5 %, ER 4.8 % |
|
| 107 |
-
|
| 108 |
-
**Our position is that trained weights are not a derivative work or adaptation of the training
|
| 109 |
-
images.** They are statistical parameters, not a reproduction or transformation of any particular
|
| 110 |
-
image. We state this explicitly rather than leaving it implied, and we apply it consistently —
|
| 111 |
-
we do not treat the weights as independent of the data here and as derived from it elsewhere.
|
| 112 |
-
Attribution is given in full below regardless, because attribution is owed to every CC-licensed
|
| 113 |
-
source whether or not ShareAlike is triggered.
|
| 114 |
-
|
| 115 |
-
Two sources with research-use-only terms — **Lucchi++** (EPFL) and **Kasthuri++**
|
| 116 |
-
(Harvard/Lichtman) — were present in earlier mitochondria runs and have been **removed**; the
|
| 117 |
-
released mitochondria head is retrained without them. A field-of-use restriction binds regardless
|
| 118 |
-
of how the derivative-work question is decided, so those could not be reasoned around.
|
| 119 |
-
|
| 120 |
## Attribution
|
| 121 |
|
| 122 |
Full per-source tables, with tile and crop counts and a DOI for every entry, are published as
|
|
@@ -127,27 +98,6 @@ datasets alongside these weights:
|
|
| 127 |
* **[`ArrojoeDrigoLab/quantem-base-model-sources`](https://huggingface.co/datasets/ArrojoeDrigoLab/quantem-base-model-sources)**
|
| 128 |
— all 655 datasets in the corpus the base encoder was pretrained on.
|
| 129 |
|
| 130 |
-
Those two tables are generated directly from the manuscript's supplementary tables, so they
|
| 131 |
-
cannot drift from what was actually trained on. They are the authoritative list; this card
|
| 132 |
-
deliberately does not keep a second copy.
|
| 133 |
-
|
| 134 |
-
**Modifications.** All sources were tiled, cropped and in some cases resampled; annotations were
|
| 135 |
-
consolidated onto a common organelle vocabulary. No source is redistributed here in its original
|
| 136 |
-
form.
|
| 137 |
-
|
| 138 |
-
**Pretraining corpus.** The QuantEM ViT-B encoder was pretrained on the wider EM corpus described
|
| 139 |
-
in the manuscript — public repositories under their own terms, plus data contributed directly by
|
| 140 |
-
27 authors under CC BY 4.0 for this purpose. Contributors are named in the manuscript
|
| 141 |
-
acknowledgements and Supplementary Table 1.
|
| 142 |
-
|
| 143 |
-
## Upstream components
|
| 144 |
-
|
| 145 |
-
| Component | Licence | Notes |
|
| 146 |
-
|---|---|---|
|
| 147 |
-
| `timm` (DINOv3 / DINOv2 architecture code) | Apache-2.0 | `timm/models/eva.py` states its DINOv3 code is a modification of the EVA model and is Apache-2.0 like the rest of timm; only *Meta's weights* remain under the DINOv3 licence. **No Meta weights are used or redistributed here.** |
|
| 148 |
-
| QuantEM ViT-B encoder | ours, CC BY 4.0 | Trained **from scratch** on our own EM corpus using the published DINOv3 recipe. No Meta checkpoint was used as initialisation and the released artifact contains no Meta tensors. |
|
| 149 |
-
| OmniEM (EM-DINO) ViT-L encoder | code MIT (`pku-maleilab/omniem-package`) | The four OmniEM heads are built on the encoder published by Lei Ma's group at PKU; please cite OmniEM if you use them. The heads themselves are ours. |
|
| 150 |
-
|
| 151 |
## Citation
|
| 152 |
|
| 153 |
Acree *et al.*, *QuantEM: An optimized platform of vision transformer-based models for
|
|
|
|
| 88 |
Commercial use, redistribution and modification are permitted; the only condition is attribution —
|
| 89 |
credit the QuantEM authors, link to the licence, and indicate if you made changes.
|
| 90 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 91 |
## Attribution
|
| 92 |
|
| 93 |
Full per-source tables, with tile and crop counts and a DOI for every entry, are published as
|
|
|
|
| 98 |
* **[`ArrojoeDrigoLab/quantem-base-model-sources`](https://huggingface.co/datasets/ArrojoeDrigoLab/quantem-base-model-sources)**
|
| 99 |
— all 655 datasets in the corpus the base encoder was pretrained on.
|
| 100 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 101 |
## Citation
|
| 102 |
|
| 103 |
Acree *et al.*, *QuantEM: An optimized platform of vision transformer-based models for
|