camel_tools.morphology.generator

The generator component of CAMeL Tools.

Classes

class camel_tools.morphology.generator.Generator(db)

Morphological generator component.

Parameters:

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

Raises:

GeneratorError – If db is not an instance of MorphologyDB or if db does not support generation.

all_feats()

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

Returns:

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

Return type:

frozenset of str

generate(lemma, feats)

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

Parameters:

• lemma (str) – Lemma to generate from.

• feats (dict) – Dictionary of features. Must contain ‘pos’ feature. 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:

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

• InvalidGeneratorFeatureValue – 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 generator instance.

Returns:

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

Return type:

frozenset of str

Examples

from camel_tools.morphology.database import MorphologyDB
from camel_tools.morphology.generator import Generator

# Initialize database in generation mode
db = MorphologyDB.builtin_db(flags='g')

# Create generator instance
generator = Generator(db)

# Specify lemma and features to generate for
lemma = 'شارِع'
features = {
    'pos': 'noun',
    'gen': 'm',
    'num': 'p'
}

# Generate analyses for lemma and features
analyses = generator.generate(lemma, features)