camel_tools.morphology.reinflector

The reinflector component of CAMeL Tools.

Classes

class camel_tools.morphology.reinflector.Reinflector(db)

Morphological reinflector component.

Parameters:

db (MorphologyDB) – Database to use for generation. Must be opened in reinflection mode or both analysis and generation modes.

Raises:

ReinflectorError – If db is not an instance of MorphologyDB or if db does not support reinflection.

all_feats()

Return a set of all features provided by the database used in this reinflector instance.

Returns:

The set all features provided by the database used in this reinflector instance.

Return type:

frozenset of str

reinflect(word, feats)

Generate surface forms and their associated analyses for a given word and a given set of (possibly underspecified) features. The surface form is accessed through the diac feature.

Parameters:

• word (str) – Word to reinflect.

• feats (dict) – Dictionary of features. See CAMeL Morphology Features for more information on features and their values.

Returns:

List of generated analyses. See CAMeL Morphology Features for more information on features and their values.

Return type:

list of dict

Raises:

• InvalidReinflectorFeature – If a feature is given that is not defined in database.

• InvalidReinflectorFeatureValue – If an invalid value is given to a feature or if ‘pos’ feature is not defined.

tok_feats()

Return a set of tokenization features provided by the database used in this reinflector instance.

Returns:

The set tokenization features provided by the database used in this reinflector instance.

Return type:

frozenset of str

Examples

from camel_tools.morphology.database import MorphologyDB
from camel_tools.morphology.reinflector import Reinflector

# Initialize database in reinflection mode
db = MorphologyDB.builtin_db(flags='r')

# Create reinflector instance
reinflector = Reinflector(db)

# Specify word and features to generate for
word = 'شوارع'
features = {
    'gen': 'm',
    'num': 'd',
    'prc1': 'bi_prep'
}

# Generate analyses for lemma and features
analyses = reinflector.reinflect(word, features)