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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
|
<p align="center">
<img src="https://raw.githubusercontent.com/goodmami/wn/main/docs/_static/wn-logo.svg" alt="Wn logo">
<br>
<strong>a Python library for wordnets</strong>
<br>
<a href="https://pypi.org/project/wn/"><img src="https://img.shields.io/pypi/v/wn.svg?style=flat-square" alt="PyPI link"></a>
<img src="https://img.shields.io/pypi/pyversions/wn.svg?style=flat-square" alt="Python Support">
<a href="https://github.com/goodmami/wn/actions?query=workflow%3A%22tests%22"><img src="https://github.com/goodmami/wn/workflows/tests/badge.svg" alt="tests"></a>
<a href="https://wn.readthedocs.io/en/latest/?badge=latest"><img src="https://readthedocs.org/projects/wn/badge/?version=latest&style=flat-square" alt="Documentation Status"></a>
<a href="https://anaconda.org/conda-forge/wn"><img src="https://img.shields.io/conda/vn/conda-forge/wn.svg?&style=flat-square" alt="Conda-Forge Version"></a>
<br>
<a href="https://github.com/goodmami/wn#available-wordnets">Available Wordnets</a>
| <a href="https://wn.readthedocs.io/">Documentation</a>
| <a href="https://wn.readthedocs.io/en/latest/faq.html">FAQ</a>
| <a href="https://wn.readthedocs.io/en/latest/guides/nltk-migration.html">Migrating from NLTK</a>
| <a href="https://github.com/goodmami/wn/projects">Roadmap</a>
</p>
---
Wn is a Python library for exploring information in wordnets.
## Installation
Install it from PyPI using **pip**:
```sh
pip install wn
```
Or install using **conda** from the conda-forge channel
([conda-forge/wn-feedstock](https://github.com/conda-forge/wn-feedstock)):
```sh
conda install -c conda-forge wn
```
## Getting Started
First, download some data:
```sh
python -m wn download oewn:2024 # the Open English WordNet 2024
```
Now start exploring:
```python
>>> import wn
>>> en = wn.Wordnet('oewn:2024') # Create Wordnet object to query
>>> ss = en.synsets('win', pos='v')[0] # Get the first synset for 'win'
>>> ss.definition() # Get the synset's definition
'be the winner in a contest or competition; be victorious'
```
## Features
- Multilingual by design; first-class support for wordnets in any language
- Interlingual queries via the [Collaborative Interlingual Index](https://github.com/globalwordnet/cili/)
- Six [similarity metrics](https://wn.readthedocs.io/en/latest/api/wn.similarity.html)
- Functions for [exploring taxonomies](https://wn.readthedocs.io/en/latest/api/wn.taxonomy.html)
- Support for [lemmatization] ([Morphy] for English is built-in) and unicode [normalization]
- Full support of the [WN-LMF 1.3](https://globalwordnet.github.io/schemas/) format, including word pronunciations and lexicon extensions
- SQL-based backend offers very fast startup and improved performance on many kinds of queries
[lemmatization]: https://wn.readthedocs.io/en/latest/guides/lemmatization.html#lemmatization
[normalization]: https://wn.readthedocs.io/en/latest/guides/lemmatization.html#normalization
[Morphy]: https://wn.readthedocs.io/en/latest/api/wn.morphy.html
## Available Wordnets
Any WN-LMF-formatted wordnet can be added to Wn's database from a local
file or remote URL, but Wn also maintains an index (see
[wn/index.toml](https://github.com/goodmami/wn/blob/main/wn/index.toml))
of available projects, similar to a package manager for software, to aid
in the discovery and downloading of new wordnets. The projects in this
index are listed below.
### English Wordnets
There are several English wordnets available. In general it is
recommended to use the latest [Open English Wordnet], but if you have
stricter compatibility needs for, e.g., experiment replicability, you
may try the [OMW English Wordnet based on WordNet 3.0] (compatible with
the Princeton WordNet 3.0 and with the [NLTK]), or [OpenWordnet-EN] (for
use with the Portuguese wordnet [OpenWordnet-PT]).
| Name | Specifier | # Synsets | Notes |
| ------------------------------------------ | ---------------------- | --------: | ----- |
| [Open English WordNet] | `oewn:2024`<br/> `oewn:2023`<br/> `oewn:2022`<br/> `oewn:2021`<br/> `ewn:2020`<br/> `ewn:2019` | 120630<br/>120135<br/>120068<br/>120039<br/>120053<br/>117791 | Recommended<br/> <br/> <br/> <br/> <br/> |
| [OMW English Wordnet based on WordNet 3.0] | `omw-en:1.4` | 117659 | Included with `omw:1.4` |
| [OMW English Wordnet based on WordNet 3.1] | `omw-en31:1.4` | 117791 | |
| [OpenWordnet-EN] | `own-en:1.0.0` | 117659 | Included with `own:1.0.0` |
[Open English WordNet]: https://en-word.net
[Open Multilingual Wordnet]: https://github.com/omwn
[OMW English Wordnet based on WordNet 3.0]: https://github.com/omwn/omw-data
[OMW English Wordnet based on WordNet 3.1]: https://github.com/omwn/omw-data
[OpenWordnet-EN]: https://github.com/own-pt/openWordnet-PT
[OpenWordnet-PT]: https://github.com/own-pt/openWordnet-PT
[NLTK]: https://www.nltk.org/
### Other Wordnets and Collections
These are standalone non-English wordnets and collections. The wordnets
of each collection are listed further down.
| Name | Specifier | # Synsets | Language |
| ------------------------------------------ | ----------------------------- | --------------: | ---------------- |
| [Open Multilingual Wordnet] | `omw:1.4` | n/a | multiple [[mul]] |
| [Open German WordNet] | `odenet:1.4`<br/>`odenet:1.3` | 36268<br/>36159 | German [de] |
| [Open Wordnets for Portuguese and English] | `own:1.0.0` | n/a | multiple [[mul]] |
| [KurdNet] | `kurdnet:1.0` | 2144 | Kurdish [ckb] |
[Open English WordNet]: https://github.com/globalwordnet/english-wordnet
[Open Multilingual Wordnet]: https://github.com/omwn
[OMW English Wordnet based on WordNet 3.0]: https://github.com/omwn
[OMW English Wordnet based on WordNet 3.1]: https://github.com/omwn
[Open German WordNet]: https://github.com/hdaSprachtechnologie/odenet
[Open Wordnets for Portuguese and English]: https://github.com/own-pt
[mul]: https://iso639-3.sil.org/code/mul
[KurdNet]: https://sinaahmadi.github.io/resources/kurdnet.html
### Open Multilingual Wordnet (OMW) Collection
The *Open Multilingual Wordnet* collection (`omw:1.4`) installs the
following lexicons (from
[here](https://github.com/omwn/omw-data/releases/tag/v1.4)) which can
also be downloaded and installed independently:
| Name | Specifier | # Synsets | Language |
| ---------------------------------------- | -------------- | --------: | -------------------------------- |
| Albanet | `omw-sq:1.4` | 4675 | Albanian [sq] |
| Arabic WordNet (AWN v2) | `omw-arb:1.4` | 9916 | Arabic [arb] |
| BulTreeBank Wordnet (BTB-WN) | `omw-bg:1.4` | 4959 | Bulgarian [bg] |
| Chinese Open Wordnet | `omw-cmn:1.4` | 42312 | Mandarin (Simplified) [cmn-Hans] |
| Croatian Wordnet | `omw-hr:1.4` | 23120 | Croatian [hr] |
| DanNet | `omw-da:1.4` | 4476 | Danish [da] |
| FinnWordNet | `omw-fi:1.4` | 116763 | Finnish [fi] |
| Greek Wordnet | `omw-el:1.4` | 18049 | Greek [el] |
| Hebrew Wordnet | `omw-he:1.4` | 5448 | Hebrew [he] |
| IceWordNet | `omw-is:1.4` | 4951 | Icelandic [is] |
| Italian Wordnet | `omw-iwn:1.4` | 15563 | Italian [it] |
| Japanese Wordnet | `omw-ja:1.4` | 57184 | Japanese [ja] |
| Lithuanian WordNet | `omw-lt:1.4` | 9462 | Lithuanian [lt] |
| Multilingual Central Repository | `omw-ca:1.4` | 45826 | Catalan [ca] |
| Multilingual Central Repository | `omw-eu:1.4` | 29413 | Basque [eu] |
| Multilingual Central Repository | `omw-gl:1.4` | 19312 | Galician [gl] |
| Multilingual Central Repository | `omw-es:1.4` | 38512 | Spanish [es] |
| MultiWordNet | `omw-it:1.4` | 35001 | Italian [it] |
| Norwegian Wordnet | `omw-nb:1.4` | 4455 | Norwegian (Bokmål) [nb] |
| Norwegian Wordnet | `omw-nn:1.4` | 3671 | Norwegian (Nynorsk) [nn] |
| OMW English Wordnet based on WordNet 3.0 | `omw-en:1.4` | 117659 | English [en] |
| Open Dutch WordNet | `omw-nl:1.4` | 30177 | Dutch [nl] |
| OpenWN-PT | `omw-pt:1.4` | 43895 | Portuguese [pt] |
| plWordNet | `omw-pl:1.4` | 33826 | Polish [pl] |
| Romanian Wordnet | `omw-ro:1.4` | 56026 | Romanian [ro] |
| Slovak WordNet | `omw-sk:1.4` | 18507 | Slovak [sk] |
| sloWNet | `omw-sl:1.4` | 42583 | Slovenian [sl] |
| Swedish (SALDO) | `omw-sv:1.4` | 6796 | Swedish [sv] |
| Thai Wordnet | `omw-th:1.4` | 73350 | Thai [th] |
| WOLF (Wordnet Libre du Français) | `omw-fr:1.4` | 59091 | French [fr] |
| Wordnet Bahasa | `omw-id:1.4` | 38085 | Indonesian [id] |
| Wordnet Bahasa | `omw-zsm:1.4` | 36911 | Malaysian [zsm] |
### Open Wordnet (OWN) Collection
The *Open Wordnets for Portuguese and English* collection (`own:1.0.0`)
installs the following lexicons (from
[here](https://github.com/own-pt/openWordnet-PT/releases/tag/v1.0.0))
which can also be downloaded and installed independently:
| Name | Specifier | # Synsets | Language |
| -------------- | -------------- | --------: | --------------- |
| OpenWordnet-PT | `own-pt:1.0.0` | 52670 | Portuguese [pt] |
| OpenWordnet-EN | `own-en:1.0.0` | 117659 | English [en] |
### Collaborative Interlingual Index
While not a wordnet, the [Collaborative Interlingual Index] (CILI)
represents the interlingual backbone of many wordnets. Wn, including
interlingual queries, will function without CILI loaded, but adding it
to the database makes available the full list of concepts, their status
(active, deprecated, etc.), and their definitions.
| Name | Specifier | # Concepts |
| ---------------------------------- | ---------- | ---------: |
| [Collaborative Interlingual Index] | `cili:1.0` | 117659 |
[Collaborative Interlingual Index]: https://github.com/globalwordnet/cili/
## Changes to the Index
### `ewn` → `oewn`
The 2021 version of the *Open English WordNet* (`oewn:2021`) has
changed its lexicon ID from `ewn` to `oewn`, so the index is updated
accordingly. The previous versions are still available as `ewn:2019`
and `ewn:2020`.
### `pwn` → `omw-en`, `omw-en31`
The wordnet formerly called the *Princeton WordNet* (`pwn:3.0`,
`pwn:3.1`) is now called the *OMW English Wordnet based on WordNet
3.0* (`omw-en`) and the *OMW English Wordnet based on WordNet 3.1*
(`omw-en31`). This is more accurate, as it is a OMW-produced
derivative of the original WordNet data, and it also avoids license or
trademark issues.
### `*wn` → `omw-*` for OMW wordnets
All OMW wordnets have changed their ID scheme from `...wn` to `omw-..` and the version no longer
includes `+omw` (e.g., `bulwn:1.3+omw` is now `omw-bg:1.4`).
|
