aibox.nlp.features.portuguese.conjugation

Características relacionadas com conjugação verbal.

Classes

Conjugation(value)

Classe utilitária, armazena as 3 conjugações verbais da língua portuguesa.

ConjugationExtractor([nlp])

Extrator de características de conjugação.

ConjugationFeatures(conjugation_score, ...)

Características de conjugação verbal.
class aibox.nlp.features.portuguese.conjugation.ConjugationFeatures(conjugation_score: float, conjugation_first_ratio: float, conjugation_second_ratio: float, conjugation_third_ratio: float, conjugation_irregular_ratio: float)[código-fonte]

Base: DataclassFeatureSet

Características de conjugação verbal.

Para informações sobre as características, acessar as referências.

Referências:

[1]: Silva Filho, M. W. da, Nascimento, A. C. A., Miranda, P., Rodrigues, L., Cordeiro, T., Isotani, S., Bittencourt, I. I., & Mello, R. F. (2023). Automated Formal Register Scoring of Student Narrative Essays Written in Portuguese. In Anais do II Workshop de Aplicações Práticas de Learning Analytics em Instituições de Ensino no Brasil (WAPLA 2023) (pp. 1–11). Workshop de Aplicações Práticas de Learning Analytics em Instituições de Ensino no Brasil. Sociedade Brasileira de Computação.

Parâmetros:

  • conjugation_score (float)

  • conjugation_first_ratio (float)

  • conjugation_second_ratio (float)

  • conjugation_third_ratio (float)

  • conjugation_irregular_ratio (float)

as_dict() → dict[str, float]

Retorna os valores das características desse conjunto para um dado texto.

Retorna:

características contidas nesse FeatureSet para um dado texto.

Tipo de retorno:

dict[str, float]

as_numpy() → ndarray[float32]

Retorna as características como uma NumPy array. Os valores de cada índice são correspondentes às características na ordem de names().

Retorna:

array de np.float32 representando os valores das características.

Tipo de retorno:

ndarray[float32]

as_tensor(device: str | None = None) → Tensor

Retorna as características como um tensor. Os valores de cada índice são correspondentes às características na ordem de names().

Parâmetros:

device (str, opcional) – dispositivo de armazenamento.

Retorna:

Tensor do torch representado os valores das características.

Tipo de retorno:

Tensor

names() → list[str]

Retorna os nomes das características em ordem lexicográfica. Todos os outros métodos apresentam os valores conforme essa ordem.

Retorna:

nome das características desse conjunto.

Tipo de retorno:

list[str]

class aibox.nlp.features.portuguese.conjugation.Conjugation(value)[código-fonte]

Base: Enum

Classe utilitária, armazena as 3 conjugações verbais da língua portuguesa.

static from_verb(regular_verb_root: str) → Conjugation[código-fonte]

Obtém a conjugação de um verbo regular a partir de sua raiz (infinitivo).

Parâmetros:

regular_verb_root (str) – verbo em sua forma normal (e.g., cantar, ler).

Retorna:

conjugação desse verbo regular (1ª, 2ª ou 3ª).

Tipo de retorno:

Conjugation

static from_desinencia(desinencia: str) → Conjugation[código-fonte]

Obtém a conjugação de acordo com a desinência do verbo.

Parâmetros:

desinencia (str) – desinência do verbo (e.g., ER, AR, IR).

Retorna:

Conjugação para essa desinência (1ª, 2ª ou 3ª).

Tipo de retorno:

Conjugation

class aibox.nlp.features.portuguese.conjugation.ConjugationExtractor(nlp: Language | None = None)[código-fonte]

Base: FeatureExtractor

Extrator de características de conjugação.

Parâmetros:

nlp (Language | None) – modelo do spaCy para ser utilizado. Defaults to “pt_core_news_md”.

Exemplo de uso em FeatureExtractor

property feature_set: type[ConjugationFeatures]

Retorna a classe que contém o conjunto de características retornado por esse extrator.

Retorna:

classe do conjunto de características retornado por esse extrator.

extract(text: str, **kwargs) → ConjugationFeatures[código-fonte]

Realiza a extração de características para o texto de entrada.

Parâmetros:

  • text (str) – texto.

  • **kwargs – argumentos extras que pode ser utilizados por alguns extratores para controlar o processo de extração.

Retorna:

características para o texto de entrada.

Tipo de retorno:

ConjugationFeatures

vectorize(text: str | list[str] | ndarray[str_], vector_type: str = 'numpy', device: str | None = None, **kwargs) → ndarray | Tensor

Método para vetorização de textos. A vetorização de múltiplos textos é realizada de forma paralela sempre que possível.

Aceita os campos n_workers (default=`min(4, cpu_count)`) e show_bar (default=`true`) quando array-like de string. Demais parâmetros são passados para _vectorize().

n_workers é utilizado quando a implementação utiliza multiprocessing. Caso n_workers <= 1, um for.

Parâmetros:

  • text (str | list[str] | ndarray[str_]) – texto ou textos de entrada.

  • vector_type (str, opcional) – tipo do vetor de saída (‘numpy ou ‘torch’).

  • device (str, opcional.) – dispositivo para armazenamento do tensor Torch. Padrão é CPU.

  • **kwargs – parâmetros extras que podem ser utilizados por alguns vetorizadores para controlar o processo de vetorização.

Retorna:

representação numérica do texto.

Tipo de retorno:

ndarray | Tensor