File size: 2,474 Bytes
0f3b9a0
 
 
350d202
 
 
 
 
 
 
 
 
 
0f3b9a0
34ddf30
350d202
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
0f3b9a0
350d202
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
---
language:
- fa
license: cc-by-sa-4.0
library_name: spacy
pipeline_tag: feature-extraction
tags:
- spacy
- feature-extraction
- floret
- word-embeddings
- persian
- farsi
---

# fa_floret_400k

Persian floret static vector table: 50,000 rows x 300 dimensions, `minn=maxn=5`,
`hash_count=2`, trained on 400,000 Persian documents. Vectors only, no pipeline components.

This is the table used by the `fa_dep_news_md` / `fa_core_news_md` / `fa_ent_news_md` tier.
Because floret hashes subwords rather than storing whole-word keys, there are no OOV tokens:
every string gets a vector, which is what makes it usable on Persian text where inconsistent
ZWNJ placement otherwise explodes the vocabulary.

## Install

```bash
pip install https://huggingface.co/Phazel/fa_floret_400k/resolve/main/fa_floret_400k-0.1.0-py3-none-any.whl
```

## Use

```python
import spacy

nlp = spacy.load("fa_floret_400k")   # vectors only: nlp.pipe_names == []
print(nlp.vocab.vectors.shape)       # (50000, 300)
print(nlp("کتاب‌های").vector.shape)   # (300,)
```

To train a pipeline against this table, pass it to spaCy's `--paths.vectors` and set
`components.tok2vec.model.embed.include_static_vectors = true`:

```bash
python -m spacy train config.cfg --paths.vectors fa_floret_400k
```

## Vector table

| Property | Value |
| --- | --- |
| Rows | 50,000 |
| Dimensions | 300 |
| Mode | floret (subword, Bloom-hashed) |
| `minn` / `maxn` | 5 / 5 |
| `hash_count` | 2 |
| Training corpus | 400,000 Persian documents |

## Related

| Package | Rows | Corpus | Used by |
| --- | ---: | --- | --- |
| [`fa_floret_400k`](https://huggingface.co/Phazel/fa_floret_400k) | 50k | 400k Persian documents | `md` tier |
| [`fa_floret_full_wiki`](https://huggingface.co/Phazel/fa_floret_full_wiki) | 50k | full Persian Wikipedia dump | — |
| [`fa_floret_wiki_200k`](https://huggingface.co/Phazel/fa-floret-wiki-vectors) | 200k | full Persian Wikipedia dump, 5 epochs | `lg` tier |

Trained pipelines that consume these tables, plus the measured accuracy deltas each table
buys, are in [`spacy-persian`](https://github.com/Fazel94/spacy-persian) (`docs/MODELS.md`
§6-7).

## Sources and licence

| Source | Author | Licence |
| --- | --- | --- |
| [`fa_floret` static vectors, 50k rows x 300d, 400k Persian documents](https://github.com/Fazel94/spacy-persian) | Kiyarash Fazeli | CC BY-SA 4.0 |

Released under **CC BY-SA 4.0**, the same licence the `md` pipelines that embed this table
carry.