Documentazione pacchetto API per mlconjug¶
Riferimento API per le classi in mlconjug.mlconjug.py¶
Modulo MLConjug Main.
-
mlconjug.mlconjug.
extract_verb_features
(verb, lang, ngram_range)[sorgente]¶ - 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)[sorgente]¶ - 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')[sorgente]¶ - 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)[sorgente]¶ 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)[sorgente]¶ - 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
()[sorgente]¶ - 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)[sorgente]¶ 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)[sorgente]¶ - 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)[sorgente]¶ Trains the pipeline on the supplied samples and labels.
Parametri: - samples – sgstr «Elenco dei verbi.
- labels – sgstr «Elenco di modelli di verbi.
-
predict
(verbs)[sorgente]¶ 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.
-
class
mlconjug.PyVerbiste.
ConjugManager
(language='default')[sorgente]¶ 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)[sorgente]¶ 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)[sorgente]¶ 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
()[sorgente]¶ - 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)[sorgente]¶ - 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)[sorgente]¶ Ottiene informazioni sui verbi e restituisce un’istanza VerbInfo.
Parametri: verb – string. Verb to conjugate» Ritorna: Oggetto VerbInfo o Nessuno.
-
get_conjug_info
(template)[sorgente]¶ 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')[sorgente]¶ 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)[sorgente]¶ Load and parses the verbs from the xml file.
Parametri: verbs_file – oggetto stringa o percorso. Percorso del file xml verbi.
-
_parse_verbs
(file)[sorgente]¶ 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)[sorgente]¶ 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)[sorgente]¶ 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)[sorgente]¶ 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)[sorgente]¶ 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)[sorgente]¶ 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
()[sorgente]¶ Iterates over all conjugated forms and returns a list of tuples of those conjugated forms. :return:
-
_load_conjug
()[sorgente]¶ - 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)[sorgente]¶ - Basi:
mlconjug.PyVerbiste.Verb
Questa classe definisce l’oggetto verbo francese.
-
_load_conjug
()[sorgente]¶ - 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)[sorgente]¶ - Basi:
mlconjug.PyVerbiste.Verb
Questa classe definisce l’oggetto verbo inglese.
-
_load_conjug
()[sorgente]¶ - 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)[sorgente]¶ - Basi:
mlconjug.PyVerbiste.Verb
Questa classe definisce l’oggetto verbo spagnolo.
-
_load_conjug
()[sorgente]¶ - 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)[sorgente]¶ - Basi:
mlconjug.PyVerbiste.Verb
Questa classe definisce l’oggetto Verb italiano.
-
_load_conjug
()[sorgente]¶ - 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)[sorgente]¶ - Basi:
mlconjug.PyVerbiste.Verb
Questa classe definisce l’oggetto Verb Portoghese.
-
_load_conjug
()[sorgente]¶ - 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)[sorgente]¶ - 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
()[sorgente]¶ - Compila le forme flesse del verbo.Aggiunge pronomi personali ai verbi incurvati.
-