# Copyright (c) 2021 PaddlePaddle Authors. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""Modeling classes for UNIMO model."""
from typing import Optional, Tuple
import paddle
import paddle.nn as nn
import paddle.nn.functional as F
from paddle import Tensor
from ...utils.env import CONFIG_NAME
from ...utils.log import logger
from .. import PretrainedModel, register_base_model
from ..model_outputs import CausalLMOutputWithCrossAttentions
from .configuration import (
UNIMO_PRETRAINED_INIT_CONFIGURATION,
UNIMO_PRETRAINED_RESOURCE_FILES_MAP,
UNIMOConfig,
)
__all__ = [
"UNIMOPretrainedModel",
"UNIMOModel",
"UNIMOLMHeadModel",
"UNIMOForMaskedLM",
"UNIMOForConditionalGeneration",
]
[文档]class UNIMOPretrainedModel(PretrainedModel):
"""
An abstract class for pretrained UNIMO models. It provides UNIMO related
`model_config_file`, `pretrained_init_configuration`, `resource_files_names`,
`pretrained_resource_files_map`, `base_model_prefix` for downloading
and loading pretrained models.
See :class:`~paddlenlp.transformers.model_utils.PretrainedModel` for more details.
"""
model_config_file = CONFIG_NAME
pretrained_init_configuration = UNIMO_PRETRAINED_INIT_CONFIGURATION
pretrained_resource_files_map = UNIMO_PRETRAINED_RESOURCE_FILES_MAP
base_model_prefix = "unimo"
config_class = UNIMOConfig
def init_weights(self, layer):
# Initialization hook
if isinstance(layer, (nn.Linear, nn.Embedding)):
# In the dygraph mode, use the `set_value` to reset the parameter directly,
# and reset the `state_dict` to update parameter in static mode.
if isinstance(layer.weight, paddle.Tensor):
layer.weight.set_value(
paddle.tensor.normal(
mean=0.0,
std=self.config.initializer_range,
shape=layer.weight.shape,
)
)
class UNIMOEmbeddings(nn.Layer):
# Include embeddings from word, position and token_type.
def __init__(self, config: UNIMOConfig):
super(UNIMOEmbeddings, self).__init__()
self.word_embeddings = nn.Embedding(config.vocab_size, config.hidden_size)
self.position_embeddings = nn.Embedding(config.max_position_embeddings, config.hidden_size)
self.token_type_embeddings = nn.Embedding(config.type_vocab_size, config.hidden_size)
self.pad_token_id = config.pad_token_id
def forward(
self,
input_ids: Optional[Tensor] = None,
token_type_ids: Optional[Tensor] = None,
position_ids: Optional[Tensor] = None,
input_embeddings: Optional[Tensor] = None,
):
if input_ids is None and input_embeddings is None:
raise ValueError("You cannot specify both input_ids and inputs_embeds at the same time")
elif input_ids is not None:
inputs_shape = paddle.shape(input_ids)
elif input_embeddings is not None:
inputs_shape = paddle.shape(input_embeddings)[:-1]
else:
raise ValueError("You have to specify either input_ids or inputs_embeds")
if input_embeddings is None:
input_embeddings = self.word_embeddings(input_ids)
if position_ids is None:
if self.pad_token_id is None:
position_ids = paddle.expand_as(paddle.arange(end=inputs_shape[1], dtype="int64"), inputs_shape)
else:
if input_ids is not None:
num_pad = paddle.sum((input_ids == self.pad_token_id).astype("float32"), axis=-1, keepdim=True)
position_ids = F.relu(
paddle.expand_as(paddle.arange(end=inputs_shape[1], dtype="int64"), inputs_shape) - num_pad
).astype("int64")
else:
logger.warning(
"Position_ids or pad_token_ids should be provided when input_embeds is specified, "
"otherwise an unexpected result may be returned since `[0, 1, ..., sequence length - 1]` will be generated as a default position_ids."
)
position_ids = paddle.expand_as(paddle.arange(end=inputs_shape[1], dtype="int64"), inputs_shape)
position_ids.stop_gradient = True
position_embeddings = self.position_embeddings(position_ids)
if token_type_ids is None:
token_type_ids = paddle.zeros_like(input_ids, dtype="int64")
token_type_ids.stop_gradient = True
token_type_embeddings = self.token_type_embeddings(token_type_ids)
embeddings = input_embeddings + position_embeddings + token_type_embeddings
return embeddings
[文档]@register_base_model
class UNIMOModel(UNIMOPretrainedModel):
"""
The bare UNIMO Model outputting raw hidden-states.
This model inherits from :class:`~paddlenlp.transformers.model_utils.PretrainedModel`.
Refer to the superclass documentation for the generic methods.
This model is also a `paddle.nn.Layer <https://www.paddlepaddle.org.cn/documentation/docs/en/api/paddle/fluid/dygraph/layers/Layer_en.html>`__ subclass.
Use it as a regular Paddle Layer and refer to the Paddle
documentation for all matter related to general usage and behavior.
Args:
config (:class:`UNIMOConfig`):
An instance of UNIMOConfig used to construct UNIMOModel.
"""
def __init__(self, config: UNIMOConfig):
super(UNIMOModel, self).__init__(config)
self.unk_token_id = config.unk_token_id
self.pad_token_id = config.pad_token_id
self.bos_token_id = config.bos_token_id
self.eos_token_id = config.eos_token_id
self.mask_token_id = config.mask_token_id
self.initializer_range = config.initializer_range
self.embeddings = UNIMOEmbeddings(config)
encoder_layer = nn.TransformerEncoderLayer(
config.hidden_size,
config.num_attention_heads,
config.intermediate_size,
dropout=config.hidden_dropout_prob,
activation=config.hidden_act,
attn_dropout=config.attention_probs_dropout_prob,
act_dropout=0,
normalize_before=config.normalize_before,
)
self.encoder_norm = nn.LayerNorm(config.hidden_size)
# post_encoder_norm = nn.LayerNorm(config.hidden_size)
self.dropout = nn.Dropout(config.hidden_dropout_prob)
self.encoder = nn.TransformerEncoder(
encoder_layer,
config.num_hidden_layers,
# post_encoder_norm,
)
self.apply(self.init_weights)
[文档] def forward(
self,
input_ids: Optional[Tensor] = None,
token_type_ids: Optional[Tensor] = None,
position_ids: Optional[Tensor] = None,
attention_mask: Optional[Tensor] = None,
use_cache: Optional[bool] = None,
cache: Optional[Tuple[Tensor]] = None,
inputs_embeds: Optional[Tensor] = None,
output_attentions: Optional[bool] = None,
output_hidden_states: Optional[bool] = None,
return_dict: Optional[bool] = None,
):
r"""
The UNIMOModel forward method, overrides the special :meth:`__call__` method.
Args:
input_ids (Tensor, optional):
Indices of input sequence tokens in the vocabulary. They are
numerical representations of tokens that build the input sequence.
It's data type should be `int64` and has a shape of [batch_size, sequence_length].
token_type_ids (Tensor):
Segment token indices to indicate first and second portions of
the inputs. Indices can be either 0 or 1:
- 0 corresponds to a **sentence A** token,
- 1 corresponds to a **sentence B** token.
It's data type should be `int64` and has a shape of [batch_size, sequence_length].
Defaults to None, which means no segment embeddings is added to token embeddings.
position_ids (Tensor):
Indices of positions of each input sequence tokens in the position embeddings.
Selected in the range ``[0, max_position_embeddings - 1]``.
It's data type should be `int64` and has a shape of [batch_size, sequence_length].
Defaults to `None`.
attention_mask (Tensor):
Mask used in multi-head attention to avoid performing attention to some unwanted positions,
usually the paddings or the subsequent positions.
Its data type can be int, float and bool.
When the data type is bool, the `masked` tokens have `False` values and the others have `True` values.
When the data type is int, the `masked` tokens have `0` values and the others have `1` values.
When the data type is float, the `masked` tokens have `-INF` values and the others have `0` values.
It is a tensor with shape broadcasted to `[batch_size, num_attention_heads, sequence_length, sequence_length]`.
For example, its shape can be [batch_size, sequence_length], [batch_size, sequence_length, sequence_length],
[batch_size, num_attention_heads, sequence_length, sequence_length].
Defaults to `None`, which means nothing needed to be prevented attention to.
use_cache: (bool, optional):
Whether or not use the model cache to speed up decoding.
Defaults to `False`.
cache (list, optional):
It is a list, and each element in the list is `incremental_cache`
produced by :meth:`paddle.nn.TransformerEncoderLayer.gen_cache`
method. See :meth:`paddle.nn.TransformerEncoder.gen_cache`
method for more details. It is only used for inference and
should be None for training. Defaults to `None`.
inputs_embeds (Tensor, optional):
Optionally, instead of passing `input_ids` you can choose to directly pass an embedded representation
of shape `(batch_size, sequence_length, hidden_size)`. This is useful if you want more control over
how to convert `input_ids` indices into associated vectors than the model's internal embedding lookup matrix.
Default to None.
output_attentions (bool, optional):
Whether or not to return the attentions tensors of all attention layers. See `attentions` under returned
tensors for more detail. Defaults to `False`.
output_hidden_states (bool, optional):
Whether or not to return the hidden states of all layers. See `hidden_states` under returned tensors for
more detail. Defaults to `False`.
return_dict (bool, optional):
Whether to return a :class:`~paddlenlp.transformers.model_outputs.BaseModelOutputWithPastAndCrossAttentions` object. If `False`, the output
will be a tuple of tensors. Defaults to `False`.
Returns:
An instance of :class:`~paddlenlp.transformers.model_outputs.BaseModelOutputWithPastAndCrossAttentions` if
`return_dict=True`. Otherwise it returns a tuple of tensors corresponding
to ordered and not None (depending on the input arguments) fields of
:class:`~paddlenlp.transformers.model_outputs.BaseModelOutputWithPastAndCrossAttentions`.
Especially, When `return_dict=output_hidden_states=output_attentions=False` and `cache=None`,
returns tensor `Sequence_output` of shape [batch_size, sequence_length, hidden_size],
which is the output at the last layer of the model.
Example:
.. code-block::
from paddlenlp.transformers import UNIMOModel
from paddlenlp.transformers import UNIMOTokenizer
model = UNIMOModel.from_pretrained('unimo-text-1.0')
tokenizer = UNIMOTokenizer.from_pretrained('unimo-text-1.0')
inputs = tokenizer.gen_encode("Welcome to use PaddlePaddle and PaddleNLP!", return_tensors=True)
outputs = model(**inputs)
"""
output_attentions = output_attentions if output_attentions is not None else self.config.output_attentions
output_hidden_states = (
output_hidden_states if output_hidden_states is not None else self.config.output_hidden_states
)
use_cache = use_cache if use_cache is not None else self.config.use_cache
return_dict = return_dict if return_dict is not None else self.config.use_return_dict
if attention_mask is None:
if input_ids is not None:
attention_mask = (
(input_ids == self.pad_token_id).astype(paddle.get_default_dtype()) * -1e4
).unsqueeze([1, 2])
else:
logger.warning(
"Provided inputs_embeds while attention_mask is None, attention weights will not be masked during forwarding."
)
if attention_mask is not None:
attention_mask.stop_gradient = True
embedding_output = self.embeddings(input_ids, token_type_ids, position_ids, inputs_embeds)
embedding_output = self.encoder_norm(embedding_output)
embedding_output = self.dropout(embedding_output)
if use_cache and cache is None:
cache = self.encoder.gen_cache(embedding_output)
outputs = self.encoder(
embedding_output,
attention_mask,
cache,
output_attentions=output_attentions,
output_hidden_states=output_hidden_states,
return_dict=return_dict,
)
return outputs
class UNIMOLMHead(nn.Layer):
def __init__(self, hidden_size, vocab_size, activation, embedding_weights=None):
super(UNIMOLMHead, self).__init__()
self.transform = nn.Linear(hidden_size, hidden_size)
self.activation = getattr(nn.functional, activation)
self.layer_norm = nn.LayerNorm(hidden_size)
self.decoder_weight = (
self.create_parameter(shape=[vocab_size, hidden_size], dtype=self.transform.weight.dtype, is_bias=False)
if embedding_weights is None
else embedding_weights
)
self.decoder_bias = self.create_parameter(shape=[vocab_size], dtype=self.decoder_weight.dtype, is_bias=True)
def forward(self, hidden_states: Tensor, masked_positions: Optional[Tensor] = None):
if masked_positions is not None:
hidden_states = paddle.reshape(hidden_states, [-1, hidden_states.shape[-1]])
hidden_states = paddle.tensor.gather(hidden_states, masked_positions)
hidden_states = self.transform(hidden_states)
hidden_states = self.activation(hidden_states)
hidden_states = self.layer_norm(hidden_states)
logits = paddle.tensor.matmul(hidden_states, self.decoder_weight, transpose_y=True) + self.decoder_bias
return logits
[文档]class UNIMOLMHeadModel(UNIMOPretrainedModel):
"""
The UNIMO Model with a `language modeling` head on top designed for generation tasks.
Args:
unimo (:class:`UNIMOModel`):
An instance of :class:`UNIMOModel`.
"""
def __init__(self, config: UNIMOConfig):
super(UNIMOLMHeadModel, self).__init__(config)
self.unimo = UNIMOModel(config)
self.lm_head = UNIMOLMHead(
config.hidden_size,
config.vocab_size,
config.hidden_act,
self.unimo.embeddings.word_embeddings.weight,
)
self.apply(self.init_weights)
[文档] def forward(
self,
input_ids: Optional[Tensor] = None,
token_type_ids: Optional[Tensor] = None,
position_ids: Optional[Tensor] = None,
attention_mask: Optional[Tensor] = None,
masked_positions: Optional[Tensor] = None,
use_cache: Optional[bool] = None,
cache: Optional[Tuple[Tensor]] = None,
inputs_embeds: Optional[Tensor] = None,
labels: Optional[Tensor] = None,
output_attentions: Optional[bool] = None,
output_hidden_states: Optional[bool] = None,
return_dict: Optional[bool] = None,
):
r"""
The UNIMOLMHeadModel forward method, overrides the special
:meth:`__call__` method.
Args:
input_ids (Tensor, optional):
See :class:`UNIMOModel`.
token_type_ids (Tensor):
See :class:`UNIMOModel`.
position_ids (Tensor):
See :class:`UNIMOModel`.
attention_mask (Tensor):
See :class:`UNIMOModel`.
use_cache: (bool, optional):
See :class:`UNIMOModel`.
cache (list, optional):
See :class:`UNIMOModel`.
inputs_embeds (Tensor, optional):
See :class:`UNIMOModel`.
labels (Tensor, optional):
Labels for computing the left-to-right language modeling loss. Indices should be in
`[-100, 0, ..., vocab_size]` (see `input_ids` docstring) Tokens with indices set to `-100` are
ignored (masked), the loss is only computed for the tokens with labels n `[0, ..., vocab_size]`
output_attentions (bool, optional):
See :class:`UNIMOModel`.
output_hidden_states (bool, optional):
See :class:`UNIMOModel`.
return_dict (bool, optional):
Whether to return a :class:`~paddlenlp.transformers.model_outputs.CausalLMOutputWithPastAndCrossAttentions` object. If `False`, the output
will be a tuple of tensors. Defaults to `False`.
Returns:
An instance of :class:`~paddlenlp.transformers.model_outputs.CausalLMOutputWithPastAndCrossAttentions` if
`return_dict=True`. Otherwise it returns a tuple of tensors corresponding
to ordered and not None (depending on the input arguments) fields of
:class:`~paddlenlp.transformers.model_outputs.CausalLMOutputWithPastAndCrossAttentions`.
Especially, When `return_dict=output_hidden_states=output_attentions=False` and `cache=labels=None`,
returns tensor `logits` of shape [batch_size, sequence_length, hidden_size],
which is the output at the last layer of the model.
Example:
.. code-block::
from paddlenlp.transformers import UNIMOLMHeadModel
from paddlenlp.transformers import UNIMOTokenizer
model = UNIMOLMHeadModel.from_pretrained('unimo-text-1.0')
tokenizer = UNIMOTokenizer.from_pretrained('unimo-text-1.0')
inputs = tokenizer.gen_encode(
"Welcome to use PaddlePaddle and PaddleNLP!",
return_tensors=True,
is_split_into_words=False)
logits = model(**inputs)
"""
return_dict = return_dict if return_dict is not None else self.config.use_return_dict
outputs = self.unimo(
input_ids,
token_type_ids,
position_ids,
attention_mask,
use_cache,
cache,
inputs_embeds=inputs_embeds,
output_attentions=output_attentions,
output_hidden_states=output_hidden_states,
return_dict=return_dict,
)
input_type = type(input_ids) if input_ids is not None else type(inputs_embeds)
sequence_output = outputs if isinstance(outputs, input_type) else outputs[0]
logits = self.lm_head(sequence_output, masked_positions)
lm_loss = None
if labels is not None:
loss_fct = nn.CrossEntropyLoss()
lm_loss = loss_fct(logits.reshape((-1, self.unimo.config.vocab_size)), labels.reshape((-1,)))
if not return_dict:
if isinstance(outputs, input_type):
return (lm_loss, logits) if lm_loss is not None else logits
else:
outputs = (logits,) + outputs[1:]
return ((lm_loss,) + outputs) if lm_loss is not None else outputs
return CausalLMOutputWithCrossAttentions(
loss=lm_loss,
logits=logits,
past_key_values=outputs.past_key_values,
hidden_states=outputs.hidden_states,
attentions=outputs.attentions,
cross_attentions=outputs.cross_attentions,
)
def prepare_fast_entry(self, kwargs):
from paddlenlp.ops import FasterMIRO, FasterUNIMOText
use_fp16_decoding = kwargs.get("use_fp16_decoding", False)
decode_strategy = kwargs.get("decode_strategy")
if decode_strategy == "sampling" and kwargs.get("top_k") != 0 and kwargs.get("top_p") != 1:
raise AttributeError(
"Only topk sampling or topp sampling are supported. "
"Topk sampling and topp sampling cannot be both applied in the fast version."
)
if kwargs["repetition_penalty"] != 1.0:
# not support for repetition_penalty yet in the fast version
raise AttributeError("'repetition_penalty != 1' is not supported yet in the fast version")
if kwargs["forced_bos_token_id"] is not None:
# not support for min_length yet in the fast version
raise AttributeError(
"Only topk sampling or topp sampling are supported. "
"Topk sampling and topp sampling cannot be both applied in the fast version."
)
if getattr(self.encoder, "norm", None) is None:
self._fast_entry = FasterUNIMOText(self, use_fp16_decoding=use_fp16_decoding).forward
else:
self._fast_entry = FasterMIRO(self, use_fp16_decoding=use_fp16_decoding).forward
return self._fast_entry
def adjust_logits_during_generation(self, logits):
# pre-process distribution
logits[:, self.unimo.unk_token_id] = -1e9
logits[:, self.unimo.pad_token_id] = -1e9
logits[:, self.unimo.bos_token_id] = -1e9
return logits
def prepare_inputs_for_generation(
self,
input_ids,
token_type_ids=None,
position_ids=None,
attention_mask=None,
use_cache=False,
cache=None,
**kwargs
):
if position_ids is None:
if self.pad_token_id is None:
position_ids = paddle.expand_as(
paddle.arange(end=paddle.shape(input_ids)[1], dtype="int64"), input_ids
)
else:
num_pad = paddle.sum((input_ids == self.pad_token_id).astype("float32"), axis=-1, keepdim=True)
position_ids = F.relu(
paddle.expand_as(paddle.arange(end=paddle.shape(input_ids)[1], dtype="float32"), input_ids)
- num_pad
).astype("int64")
position_ids.stop_gradient = True
if token_type_ids is None:
token_type_ids = paddle.zeros_like(input_ids, dtype="int64")
token_type_ids.stop_gradient = True
if attention_mask is None:
attention_mask = ((input_ids == self.pad_token_id).astype(paddle.get_default_dtype()) * -1e4).unsqueeze(
[1, 2]
)
attention_mask.stop_gradient = True
# only last token for inputs_ids if cache is defined in kwargs
if cache is not None:
input_ids = input_ids[:, -1].unsqueeze(-1)
if token_type_ids is not None:
token_type_ids = token_type_ids[:, -1].unsqueeze(-1)
if position_ids is not None:
position_ids = position_ids[:, -1].unsqueeze(-1)
if attention_mask is not None:
attention_mask = attention_mask[:, :, -1:, :]
return {
"input_ids": input_ids,
"token_type_ids": token_type_ids,
"position_ids": position_ids,
"attention_mask": attention_mask,
"use_cache": use_cache,
"cache": cache,
}
def __getattr__(self, name):
try:
return super().__getattr__(name)
except AttributeError:
return getattr(getattr(self, self.base_model_prefix), name)
UNIMOForMaskedLM = UNIMOLMHeadModel
UNIMOForConditionalGeneration = UNIMOLMHeadModel