wn

A modern, interlingual wordnet interface for Python

https://github.com/goodmami/wn

Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

✓
CITATION.cff file
Found CITATION.cff file
✓
codemeta.json file
Found codemeta.json file
✓
.zenodo.json file
Found .zenodo.json file
○
DOI references
○
Academic publication links
○
Committers with academic emails
○
Institutional organization owner
○
JOSS paper metadata
○
Scientific vocabulary similarity
Low similarity (14.4%) to scientific vocabulary

Keywords

dictionary lexicon library nlp python-library wordnet wordnets

Keywords from Contributors

spacy

Last synced: 4 months ago · JSON representation ·

Repository

A modern, interlingual wordnet interface for Python

Basic Info

Host: GitHub
Owner: goodmami
License: mit
Language: Python
Default Branch: main
Homepage: https://wn.readthedocs.io/
Size: 830 KB

Statistics

Stars: 256
Watchers: 5
Forks: 27
Open Issues: 22
Releases: 27

Topics

dictionary lexicon library nlp python-library wordnet wordnets

Created over 5 years ago · Last pushed 6 months ago

Metadata Files

Readme Changelog Contributing License Citation

README.md

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):

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
Six similarity metrics
Functions for exploring taxonomies
Support for lemmatization and unicode normalization
Full support of the WN-LMF 1.3 format, including word pronunciations and lexicon extensions
SQL-based backend offers very fast startup and improved performance on many kinds of queries

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) 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, or OpenWordnet-EN.

| Name | Specifier | # Synsets | Notes | | ------------------------------------------ | ---------------------- | --------: | ----- | | Open English WordNet | oewn:2024
oewn:2023
oewn:2022
oewn:2021
ewn:2020
ewn:2019 | 120630
120135
120068
120039
120053
117791 | Recommended

| | 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 |

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
odenet:1.3 | 36268
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 Multilingual Wordnet (OMW) Collection

The Open Multilingual Wordnet collection (omw:1.4) installs the following lexicons (from here) 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) 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 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 |

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).

Citation

Michael Wayne Goodman and Francis Bond. 2021. Intrinsically Interlingual: The Wn Python Library for Wordnets In Proceedings of the 11th Global Wordnet Conference, pages 100–107, University of South Africa (UNISA). Global Wordnet Association.

Owner

Name: Michael Wayne Goodman
Login: goodmami
Kind: user
Location: Oregon

Website: http://www.goodmami.org
Repositories: 49
Profile: https://github.com/goodmami

Computational Linguist, Data Scientist

Citation (CITATION.cff)

cff-version: 1.2.0
title: Wn
message: >-
  Please cite this software using the metadata from
  'preferred-citation'.
type: software
authors:
  - given-names: Michael Wayne
    family-names: Goodman
    email: goodman.m.w@gmail.com
    orcid: 'https://orcid.org/0000-0002-2896-5141'
  - given-names: Francis
    family-names: Bond
    email: bond@ieee.org
    orcid: 'https://orcid.org/0000-0003-4973-8068'
repository-code: 'https://github.com/goodmami/wn/'
preferred-citation:
  type: conference-paper
  authors:
  - given-names: Michael Wayne
    family-names: Goodman
    email: goodmami@uw.edu
    orcid: 'https://orcid.org/0000-0002-2896-5141'
    affiliation: Nanyang Technological University
  - given-names: Francis
    family-names: Bond
    email: bond@ieee.org
    orcid: 'https://orcid.org/0000-0003-4973-8068'
    affiliation: Nanyang Technological University
  start: 100  # First page number
  end: 107  # Last page number
  conference:
      name: "Proceedings of the 11th Global Wordnet Conference"
  title: "Intrinsically Interlingual: The Wn Python Library for Wordnets"
  year: 2021
  month: 1
  url: 'https://aclanthology.org/2021.gwc-1.12/'
  publisher: "Global Wordnet Association"

GitHub Events

Total

Create event: 33
Release event: 5
Issues event: 72
Watch event: 37
Delete event: 25
Issue comment event: 59
Push event: 56
Pull request review event: 12
Pull request review comment event: 11
Pull request event: 59
Fork event: 2

Last Year

Create event: 33
Release event: 5
Issues event: 72
Watch event: 37
Delete event: 25
Issue comment event: 59
Push event: 56
Pull request review event: 12
Pull request review comment event: 11
Pull request event: 59
Fork event: 2

Committers

Last synced: 7 months ago

All Time

Total Commits: 549
Total Committers: 10
Avg Commits per committer: 54.9
Development Distribution Score (DDS): 0.016

Past Year

Commits: 38
Committers: 3
Avg Commits per committer: 12.667
Development Distribution Score (DDS): 0.053

Top Committers

Name	Email	Commits
Michael Wayne Goodman	g**w@g**m	540
yoyo-go	5****o	1
alvations	a**s@g**m	1
Sugato Ray	s****y	1
Silvan Laube	s**e@h**m	1
Raymund Zacharias	r**1@y**e	1
Jannes Müller	h**e@g**e	1
Christian Clauss	c**s@m**m	1
Francis Dion	f**0@o**m	1
Diego	d**a@e**m	1

Committer Domains (Top 20 + Academic)

evernote.com: 1 me.com: 1 gmx.de: 1 yahoo.de: 1

Issues and Pull Requests

Last synced: 4 months ago

All Time

Total issues: 64
Total pull requests: 66
Average time to close issues: 9 months
Average time to close pull requests: 7 days
Total issue authors: 21
Total pull request authors: 10
Average comments per issue: 2.17
Average comments per pull request: 0.17
Merged pull requests: 56
Bot issues: 0
Bot pull requests: 0

Past Year

Issues: 36
Pull requests: 51
Average time to close issues: 11 days
Average time to close pull requests: about 22 hours
Issue authors: 9
Pull request authors: 6
Average comments per issue: 1.44
Average comments per pull request: 0.06
Merged pull requests: 42
Bot issues: 0
Bot pull requests: 0

View more stats

Top Authors

Issue Authors

goodmami (40)
jmccrae (4)
fcbond (4)
francis-dion (2)
sugatoray (2)
06kellyjac (1)
rayza (1)
forgot (1)
LifeIsStrange (1)
dchaplinsky (1)
garymazz (1)
BramVanroy (1)
chlor (1)
AmitMY (1)
klebster2 (1)

Pull Request Authors

goodmami (66)
amit-nagish (2)
sugatoray (2)
rayza (2)
Laubeee (2)
Hypercookie (1)
forgot (1)
fcbond (1)
cclauss (1)
francis-dion (1)

Top Labels

Issue Labels

enhancement (29) bug (20) maintenance (9) good first issue (3) wontfix (3) schema (2) documentation (2) question (2) invalid (1) help wanted (1)

Pull Request Labels

Packages

Total packages: 1
Total downloads:
- pypi 19,806 last-month

Total dependent packages: 3
Total dependent repositories: 47
Total versions: 48
Total maintainers: 1

pypi.org: wn

Wordnet interface library

Documentation: https://wn.readthedocs.io/
License: MIT License Copyright (c) 2020 Michael Wayne Goodman Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Latest release: 0.13.0
published 7 months ago

Versions: 48
Dependent Packages: 3
Dependent Repositories: 47
Downloads: 19,806 Last month

Rankings

Dependent repos count: 2.1%

Dependent packages count: 2.4%

Average: 3.5%

Downloads: 6.0%

Maintainers (1)

goodmami

Last synced: 4 months ago

Dependencies

docs/requirements.txt pypi

furo ==2021.10.9
sphinx *
sphinx-copybutton ==0.4.0

.github/workflows/checks.yml actions

actions/checkout v3 composite
actions/setup-python v4 composite

.github/workflows/release.yml actions

actions/checkout v3 composite
actions/setup-python v4 composite

pyproject.toml pypi

requests *
tomli *
typing-extensions python_version < '3.8'

wn

Science Score: 44.0%

Keywords

Keywords from Contributors

Repository

Basic Info

Statistics

Topics

Metadata Files

README.md

Installation

Getting Started

Features

Available Wordnets

English Wordnets

Other Wordnets and Collections

Open Multilingual Wordnet (OMW) Collection

Open Wordnet (OWN) Collection

Collaborative Interlingual Index

Changes to the Index

ewn → oewn

pwn → omw-en, omw-en31

*wn → omw-* for OMW wordnets

Citation

Owner

Citation (CITATION.cff)

GitHub Events

Total

Last Year

Committers

All Time

Past Year

Top Committers

Committer Domains (Top 20 + Academic)

Issues and Pull Requests

All Time

Past Year

Top Authors

Issue Authors

Pull Request Authors

Top Labels

Issue Labels

Pull Request Labels

Packages

pypi.org: wn

Rankings

Maintainers (1)

Dependencies

`ewn` → `oewn`

`pwn` → `omw-en`, `omw-en31`

`wn` → `omw-` for OMW wordnets