gianlp.models.text_representations.char_embedding_sequence.CharEmbeddingSequence

class gianlp.models.text_representations.char_embedding_sequence.CharEmbeddingSequence(embedding_dimension: int = 256, sequence_maxlen: int = 80, min_freq_percentile: int = 5, random_state: int = 42)

Bases: TextRepresentation

Char embedding sequence input

Variables

_char_indexes – mapping from char to index
_keras_model – Keras model built from processing the text input
_embedding_dimension – the dimension of the embedding
_sequence_maxlen – the max length of an allowed sequence
_min_freq_percentile – the minimum frequency percentile to consider a char as known
_random_state – the random seed used for randomized operations

Parameters

embedding_dimension – The char embedding dimension
sequence_maxlen – The maximum allowed sequence length
min_freq_percentile – minimum percentile of the frequency for keeping a char. If a char has a frequency lower than this percentile it would be treated as unknown.
random_state – random seed

Methods

`build`	Builds the whole chain of models in a recursive manner using the functional API.
`deserialize`	Deserializes a model
`parallel_tokenizer`	Parallelizable wrapper for the tokenizer
`preprocess_texts`	Given texts returns the array representation needed for forwarding the keras model
`serialize`	Serializes the model to be deserialized with the deserialize method
`tokenize_texts`	Function for tokenizing texts

Attributes

`inputs`	Method for getting all models that serve as input.
`inputs_shape`	Returns the shapes of the inputs of the model
`outputs_shape`	Returns the output shape of the model
`trainable_weights_amount`	Computes the total amount of trainable weights
`weights_amount`	Computes the total amount of weights

preprocess_texts(texts: Union[List[str], Series]) → Union[List[ndarray], ndarray]

Given texts returns the array representation needed for forwarding the keras model

Parameters: texts – the texts to preprocess
Returns: a numpy array of shape (#texts, _sequence_maxlen)

build(texts: Union[List[str], Series, Dict[str, List[str]], DataFrame]) → None

Builds the whole chain of models in a recursive manner using the functional API. Some operations may need the model to be built.

Parameters: texts – the texts for building if needed, some models have to learn from a sample corpus before working
Raises: ValueError – If the multi-text input keys do not match with the ones in a multi-text model

classmethod deserialize(data: bytes) → BaseModel

Deserializes a model

Parameters: data – the data for deserializing
Returns: a BaseModel object

static get_bytes_from_model(model: Model, copy: bool = False) → bytes

Transforms a keras model into bytes

Parameters

model – the keras model
copy – whether to copy the model before saving. copying the model is needed for complex nested models because the keras save/load can fail

Returns

a byte array

static get_model_from_bytes(data: bytes) → Model

Given bytes from keras model serialized with get_bytes_from_model method returns the model

Parameters: data – the model bytes
Returns: a keras model

property inputs: ModelInputsWrapper

Method for getting all models that serve as input. All TextRepresentation have no models as an input.

Returns: a list or list of tuples containing BaseModel objects

property inputs_shape: Union[List[ModelIOShape], ModelIOShape]

Returns the shapes of the inputs of the model

Returns: a list of shape tuple or shape tuple

static parallel_tokenizer(text: str, tokenizer: Callable[[str], List[str]], sequence_maxlength: Optional[int] = None) → List[str]

Parallelizable wrapper for the tokenizer

Parameters

text – the text to tokenize
tokenizer – the tokenizer
sequence_maxlength – optional sequence maxlength.

Returns

a list of lists with string tokens

serialize() → bytes

Serializes the model to be deserialized with the deserialize method

Returns: a byte array

static tokenize_texts(texts: Union[List[str], Series], tokenizer: Callable[[str], List[str]], sequence_maxlength: Optional[int] = None) → List[List[str]]

Function for tokenizing texts

Parameters

texts – the texts to tokenize
tokenizer – the tokenizer
sequence_maxlength – optional sequence maxlength.

Returns

a list of lists with string tokens

property trainable_weights_amount: Optional[int]

Computes the total amount of trainable weights

Returns: the total amount of trainable weights or none if not built

property weights_amount: Optional[int]

Computes the total amount of weights

Returns: the total amount of weights or none if not built

property outputs_shape: ModelIOShape

Returns the output shape of the model

Returns: a list of shape tuple or shape tuple