mirror of
https://github.com/explosion/spaCy.git
synced 2024-12-26 09:56:28 +03:00
92 lines
3.3 KiB
Cython
92 lines
3.3 KiB
Cython
# cython: profile=True
|
|
# cython: embedsignature=True
|
|
|
|
|
|
from libc.stdlib cimport calloc, free, realloc
|
|
|
|
cdef class Lexeme:
|
|
"""A lexical type.
|
|
|
|
Clients should avoid instantiating Lexemes directly, and instead use get_lexeme
|
|
from a language module, e.g. spacy.en.get_lexeme . This allows us to use only
|
|
one Lexeme object per lexical type.
|
|
|
|
Attributes:
|
|
id (view_id_t):
|
|
A unique ID of the word's string.
|
|
|
|
Implemented as the memory-address of the string,
|
|
as we use Python's string interning to guarantee that only one copy
|
|
of each string is seen.
|
|
|
|
string (unicode):
|
|
The unicode string.
|
|
|
|
Implemented as a property; relatively expensive.
|
|
|
|
length (size_t):
|
|
The number of unicode code-points in the string.
|
|
|
|
prob (double):
|
|
An estimate of the word's unigram log probability.
|
|
|
|
Probabilities are calculated from a large text corpus, and smoothed using
|
|
simple Good-Turing. Estimates are read from data/en/probabilities, and
|
|
can be replaced using spacy.en.load_probabilities.
|
|
|
|
cluster (int):
|
|
An integer representation of the word's Brown cluster.
|
|
|
|
A Brown cluster is an address into a binary tree, which gives some (noisy)
|
|
information about the word's distributional context.
|
|
|
|
>>> strings = (u'pineapple', u'apple', u'dapple', u'scalable')
|
|
>>> print ["{0:b"} % lookup(s).cluster for s in strings]
|
|
["100111110110", "100111100100", "01010111011001", "100111110110"]
|
|
|
|
The clusterings are unideal, but often slightly useful.
|
|
"pineapple" and "apple" share a long prefix, indicating a similar meaning,
|
|
while "dapple" is totally different. On the other hand, "scalable" receives
|
|
the same cluster ID as "pineapple", which is not what we'd like.
|
|
"""
|
|
def __cinit__(self, utf8_t string, size_t length, list views, prob=0.0,
|
|
flags=0):
|
|
self.id = <id_t>&string
|
|
self.length = length
|
|
self.nr_strings = 0
|
|
self.add_views(views)
|
|
|
|
def __dealloc__(self):
|
|
free(self.views)
|
|
|
|
property string:
|
|
def __get__(self):
|
|
return self.strings[0].decode('utf8')
|
|
|
|
cpdef unicode get_view_string(self, size_t i):
|
|
assert i < self.nr_strings
|
|
return self.strings[i].decode('utf8')
|
|
|
|
cpdef id_t get_view_id(self, size_t i) except 0:
|
|
assert i < self.nr_strings
|
|
return <id_t>&self.views[i]
|
|
|
|
cpdef int add_view(self, unicode view) except -1:
|
|
self.nr_views += 1
|
|
self.views = <char**>realloc(self.views, self.nr_views * sizeof(utf8_t))
|
|
cdef bytes utf8_string = view.encode('utf8')
|
|
# Intern strings, allowing pointer comparison
|
|
utf8_string = intern(utf8_string)
|
|
self.views[self.nr_views - 1] = utf8_string
|
|
|
|
cpdef bint check_flag(self, size_t flag_id) except *:
|
|
"""Access the value of one of the pre-computed boolean distribution features.
|
|
|
|
Meanings depend on the language-specific distributional features being loaded.
|
|
The suggested features for latin-alphabet languages are: TODO
|
|
"""
|
|
return self.flags & (1 << flag_id)
|
|
|
|
cpdef int set_flag(self, size_t flag_id) except -1:
|
|
self.flags |= (1 << flag_id)
|