Documentazione pacchetto API per mlconjug

Riferimento API per le classi in mlconjug.mlconjug.py

Modulo MLConjug Main.

Questo modulo dichiara le classi principali con cui l’utente interagisce.

Il modulo definisce le classi necessarie per interfacciarsi con i modelli Machine Learning.

mlconjug.mlconjug.extract_verb_features(verb, lang, ngram_range)

Vectorizer personalizzato ottimizzato per l’estrazione delle funzionalità dei verbi.

Le sottoclassi di Vectorizer sklearn.feature_extraction.text.CountVectorizer.

As in Indo-European languages verbs are inflected by adding a morphological suffix, the vectorizer extracts verb endings and produces a vector representation of the verb with binary features.

Per migliorare i risultati dell’estrazione delle funzionalità, sono state incluse molte altre funzionalità:

Le caratteristiche sono i n-grammi finali del verbo, che iniziano con n-grammi, la lunghezza del verbo, il numero di vocali, il numero di consonanti e il rapporto delle vocali rispetto alle consonanti.

Parametri:

• verb – string. Verb to vectorize»
• lang – string. Language to analyze.
• ngram_range – tuple. La gamma della finestra scorrevole di ngram.

Ritorna:

elenco. Elenco delle caratteristiche più salienti del verbo per il compito di trovare la classe di coniugazione.

class mlconjug.mlconjug.Conjugator(language='fr', model=None)

Questa è la classe principale del progetto.

The class manages the Verbiste data set and provides an interface with the scikit-learn pipeline.

If no parameters are provided, the default language is set to french and the pre-trained french conjugation pipeline is used.

La classe definisce il metodo conjugate (verb, language) che è il metodo principale del modulo.

Parametri:

• language – string. Lingua del coniugatore. La lingua predefinita è» fr «per il francese.
• model – mlconjug.Model o scikit-learn Pipeline o Classifier che implementano i metodi fit () e prediction (). Una pipeline fornita dall’utente se l’utente ha addestrato la propria pipeline.

conjugate(verb, subject='abbrev')

Questo è il metodo principale di questa classe.

Prima controlla se il verbo è in Verbiste.

If it is not, and a pre-trained scikit-learn pipeline has been supplied, the method then calls the pipeline to predict the conjugation class of the provided verb.

Restituisce un oggetto Verb o None.

Parametri:

• verb – string. Verb to conjugate»
• subject – string Attiva i pronomi abbreviati o pieni Il valore predefinito è» abbrev «Seleziona» pronome «per i pronomi completi.

Ritorna:

Oggetto Verb o None.

set_model(model)

Assigns the provided pre-trained scikit-learn pipeline to be able to conjugate unknown verbs.

Parametri:model – Scikit-learn Classifier o Pipeline.

class mlconjug.mlconjug.DataSet(verbs_dict)

Questa classe contiene e gestisce il set di dati.

Defines helper methodss for managing Machine Learning tasks like constructing a training and testing set.

Parametri:verbs_dict – Un dizionario di verbi e la loro corrispondente classe di coniugazione.

construct_dict_conjug()

Compila il dizionario contenente i modelli di coniugazione.

Compila gli elenchi contenenti i verbi e i loro modelli.

split_data(threshold=8, proportion=0.5)

Divide i dati in una formazione e un set di test.

Parametri:

• threshold – int. Dimensione minima della classe di coniugazione da dividere»
• proportion – float. Proporzione di campioni nel set di allenamento. Deve essere compresa tra 0 e 1.

class mlconjug.mlconjug.Model(vectorizer=None, feature_selector=None, classifier=None, language=None)

Basi: object

This class manages the scikit-learn pipeline.

La pipeline include un vettore di funzionalità, un selettore di funzionalità e un classificatore.

If any of the vectorizer, feature selector or classifier is not supplied at instance declaration, the __init__ method will provide good default values that get more than 92% prediction accuracy.

Parametri:

• vectorizer – Scikit-learn Vectorizer.
• feature_selector – Scikit-learn Classifier con un metodo fit_transform ()
• classifier – Scikit-learn Classifier con un metodo di previsione ()
• language – linguaggio del corpus di verbi da analizzare.

train(samples, labels)

Trains the pipeline on the supplied samples and labels.

Parametri:

• samples – sgstr «Elenco dei verbi.
• labels – sgstr «Elenco di modelli di verbi.

predict(verbs)

Predice la classe di coniugazione dell’elenco di verbi fornito.

Parametri:verbs – sgstr «Elenco dei verbi. Ritorna:sgstr «Elenco dei gruppi di coniugazione previsti.

Riferimento API per le classi in mlconjug.PyVerbiste.py

PyVerbiste.

Una libreria Python per coniugare i verbi in francese, inglese, spagnolo, italiano, portoghese e rumeno (più presto).

Contiene dati di coniugazione generati da modelli di apprendimento automatico che utilizzano la libreria python mlconjug.

Maggiori informazioni su mlconjug all’indirizzo https://pypi.org/project/mlconjug/

I dati di coniugazione sono conformi allo schema XML definito da Verbiste.

Maggiori informazioni su Verbiste su https://perso.b2b2c.ca/~sarrazip/dev/conjug_manager.html

class mlconjug.PyVerbiste.ConjugManager(language='default')

This is the class handling the mlconjug json files.

Parametri:language – string. | The language of the conjugator. The default value is fr for French. | The allowed values are: fr, en, es, it, pt, ro.

_load_verbs(verbs_file)

Load and parses the verbs from the json file.

Parametri:verbs_file – string or path object. Path to the verbs json file.

_load_conjugations(conjugations_file)

Load and parses the conjugations from the xml file.

Parametri:conjugations_file – oggetto stringa o percorso Percorso per il file xml di coniugazione.

_detect_allowed_endings()

Rileva le terminazioni consentite per i verbi nelle lingue supportate.

Tutte le lingue supportate tranne l’inglese limitano il formato che un verbo può assumere.

Poiché l’inglese è molto più produttivo e vario nella morfologia dei suoi verbi, ogni parola è consentita come un verbo.

Ritorna:set. Un set contenente le terminazioni consentite di verbi nella lingua di destinazione.

is_valid_verb(verb)

Controlla se il verbo è un verbo valido nella lingua specificata.

Le parole inglesi sono sempre trattate come possibili verbi.

I verbi in altre lingue sono filtrati dai loro finali.

Parametri:verb – stringa, il verbo coniugare. Ritorna:bool, vero se il verbo è un verbo valido nella lingua, altrimenti falso.

get_verb_info(verb)

Ottiene informazioni sui verbi e restituisce un’istanza VerbInfo.

Parametri:verb – string. Verb to conjugate» Ritorna:Oggetto VerbInfo o Nessuno.

get_conjug_info(template)

Ottiene informazioni di coniugazione corrispondenti al modello specificato.

Parametri:template – string Nome del modello di fine del verbo. Ritorna:OrderedDict o None. OrderedDict contenente i suffissi coniugati del modello.

class mlconjug.PyVerbiste.Verbiste(language='default')

Basi: mlconjug.PyVerbiste.ConjugManager

Questa è la classe che gestisce i file xml di Verbiste.

Parametri:language – string. | The language of the conjugator. The default value is fr for French. | The allowed values are: fr, en, es, it, pt, ro.

_load_verbs(verbs_file)

Load and parses the verbs from the xml file.

Parametri:verbs_file – oggetto stringa o percorso. Percorso del file xml verbi.

_parse_verbs(file)

Parses the XML file.

Parametri:file – FileObject. File XML contenente i verbi. Ritorna:OrderedDict. Un OrderedDict contenente il verbo e il suo modello per tutti i verbi nel file.

_load_conjugations(conjugations_file)

Load and parses the conjugations from the xml file.

Parametri:conjugations_file – oggetto stringa o percorso Percorso per il file xml di coniugazione.

_parse_conjugations(file)

Parses the XML file.

Parametri:file – FileObject. File XML contenente i modelli di coniugazione. Ritorna:OrderedDict. Un OrderedDict contenente tutti i modelli di coniugazione nel file.

_load_tense(tense)

Carica e analizza le forme flesse del tempo dal file xml.

Parametri:tense – elenco di tag xml contenenti moduli flessi. L’elenco delle forme flesse per il tempo corrente in elaborazione. Ritorna:list. List of inflected forms.

_detect_allowed_endings()

Rileva le terminazioni consentite per i verbi nelle lingue supportate.

Tutte le lingue supportate tranne l’inglese limitano il formato che un verbo può assumere.

Poiché l’inglese è molto più produttivo e vario nella morfologia dei suoi verbi, ogni parola è consentita come un verbo.

Ritorna:set. Un set contenente le terminazioni consentite di verbi nella lingua di destinazione.

get_conjug_info(template)

Ottiene informazioni di coniugazione corrispondenti al modello specificato.

Parametri:template – string Nome del modello di fine del verbo. Ritorna:OrderedDict o None. OrderedDict contenente i suffissi coniugati del modello.

get_verb_info(verb)

Ottiene informazioni sui verbi e restituisce un’istanza VerbInfo.

Parametri:verb – string. Verb to conjugate» Ritorna:Oggetto VerbInfo o Nessuno.

is_valid_verb(verb)

Controlla se il verbo è un verbo valido nella lingua specificata.

Le parole inglesi sono sempre trattate come possibili verbi.

I verbi in altre lingue sono filtrati dai loro finali.

Parametri:verb – stringa, il verbo coniugare. Ritorna:bool, vero se il verbo è un verbo valido nella lingua, altrimenti falso.

class mlconjug.PyVerbiste.VerbInfo(infinitive, root, template)

Questa classe definisce la struttura delle informazioni sui verbi del Verbese.

Parametri:

• infinitive – stringa, forma infinita del verbo»
• root – stringa, radice lessicale del verbo»
• template – string Nome del modello di fine del verbo.

class mlconjug.PyVerbiste.Verb(verb_info, conjug_info, subject='abbrev', predicted=False)

This class defines the Verb Object. TODO: Make the conjugated forms iterable by implementing the iterator protocol.

Parametri:

• verb_info – Oggetto VerbInfo.
• conjug_info – OrderedDict.
• subject – string Attiva i pronomi abbreviati o pieni Il valore predefinito è» abbrev «Seleziona» pronome «per i pronomi completi.
• predicted – bool. Indica se le informazioni di coniugazione sono state previste dal modello o recuperate dal set di dati.

iterate()

Iterates over all conjugated forms and returns a list of tuples of those conjugated forms. :return:

_load_conjug()

Compila le forme flesse del verbo.

Questa è la versione generica di questo metodo.

Non aggiunge pronomi personali alle forme coniugate.

Questo metodo può gestire qualsiasi nuovo linguaggio se la struttura di coniugazione è conforme allo schema XML di Verbiste.

class mlconjug.PyVerbiste.VerbFr(verb_info, conjug_info, subject='abbrev', predicted=False)

Basi: mlconjug.PyVerbiste.Verb

Questa classe definisce l’oggetto verbo francese.

_load_conjug()

Compila le forme flesse del verbo.

Aggiunge pronomi personali ai verbi incurvati.

iterate()

Iterates over all conjugated forms and returns a list of tuples of those conjugated forms. :return:

class mlconjug.PyVerbiste.VerbEn(verb_info, conjug_info, subject='abbrev', predicted=False)

Basi: mlconjug.PyVerbiste.Verb

Questa classe definisce l’oggetto verbo inglese.

_load_conjug()

Compila le forme flesse del verbo.

Aggiunge pronomi personali ai verbi incurvati.

iterate()

Iterates over all conjugated forms and returns a list of tuples of those conjugated forms. :return:

class mlconjug.PyVerbiste.VerbEs(verb_info, conjug_info, subject='abbrev', predicted=False)

Basi: mlconjug.PyVerbiste.Verb

Questa classe definisce l’oggetto verbo spagnolo.

_load_conjug()

Compila le forme flesse del verbo.

Aggiunge pronomi personali ai verbi incurvati.

iterate()

Iterates over all conjugated forms and returns a list of tuples of those conjugated forms. :return:

class mlconjug.PyVerbiste.VerbIt(verb_info, conjug_info, subject='abbrev', predicted=False)

Basi: mlconjug.PyVerbiste.Verb

Questa classe definisce l’oggetto Verb italiano.

_load_conjug()

Compila le forme flesse del verbo.

Aggiunge pronomi personali ai verbi incurvati.

iterate()

Iterates over all conjugated forms and returns a list of tuples of those conjugated forms. :return:

class mlconjug.PyVerbiste.VerbPt(verb_info, conjug_info, subject='abbrev', predicted=False)

Basi: mlconjug.PyVerbiste.Verb

Questa classe definisce l’oggetto Verb Portoghese.

_load_conjug()

Compila le forme flesse del verbo.

Aggiunge pronomi personali ai verbi incurvati.

iterate()

Iterates over all conjugated forms and returns a list of tuples of those conjugated forms. :return:

class mlconjug.PyVerbiste.VerbRo(verb_info, conjug_info, subject='abbrev', predicted=False)

Basi: mlconjug.PyVerbiste.Verb

Questa classe definisce l’oggetto Verb Rumeno.

iterate()

Iterates over all conjugated forms and returns a list of tuples of those conjugated forms. :return:

_load_conjug()

Compila le forme flesse del verbo.

Aggiunge pronomi personali ai verbi incurvati.