| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995 |
- # Copyright 2022 The HuggingFace Inc. team. 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.
- """PyTorch LiLT model."""
- import math
- import torch
- from torch import nn
- from torch.nn import BCEWithLogitsLoss, CrossEntropyLoss, MSELoss
- from ... import initialization as init
- from ...activations import ACT2FN
- from ...modeling_layers import GradientCheckpointingLayer
- from ...modeling_outputs import (
- BaseModelOutput,
- BaseModelOutputWithPooling,
- QuestionAnsweringModelOutput,
- SequenceClassifierOutput,
- TokenClassifierOutput,
- )
- from ...modeling_utils import PreTrainedModel
- from ...pytorch_utils import apply_chunking_to_forward
- from ...utils import auto_docstring, logging
- from .configuration_lilt import LiltConfig
- logger = logging.get_logger(__name__)
- class LiltTextEmbeddings(nn.Module):
- def __init__(self, config):
- super().__init__()
- self.word_embeddings = nn.Embedding(config.vocab_size, config.hidden_size, padding_idx=config.pad_token_id)
- 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.LayerNorm = nn.LayerNorm(config.hidden_size, eps=config.layer_norm_eps)
- self.dropout = nn.Dropout(config.hidden_dropout_prob)
- # position_ids (1, len position emb) is contiguous in memory and exported when serialized
- self.register_buffer(
- "position_ids", torch.arange(config.max_position_embeddings).expand((1, -1)), persistent=False
- )
- # End copy
- self.padding_idx = config.pad_token_id
- self.position_embeddings = nn.Embedding(
- config.max_position_embeddings, config.hidden_size, padding_idx=self.padding_idx
- )
- def forward(
- self,
- input_ids=None,
- token_type_ids=None,
- position_ids=None,
- inputs_embeds=None,
- ):
- if position_ids is None:
- if input_ids is not None:
- # Create the position ids from the input token ids. Any padded tokens remain padded.
- position_ids = self.create_position_ids_from_input_ids(input_ids, self.padding_idx).to(
- input_ids.device
- )
- else:
- position_ids = self.create_position_ids_from_inputs_embeds(inputs_embeds)
- if input_ids is not None:
- input_shape = input_ids.size()
- else:
- input_shape = inputs_embeds.size()[:-1]
- if token_type_ids is None:
- token_type_ids = torch.zeros(input_shape, dtype=torch.long, device=self.position_ids.device)
- if inputs_embeds is None:
- inputs_embeds = self.word_embeddings(input_ids)
- token_type_embeddings = self.token_type_embeddings(token_type_ids)
- embeddings = inputs_embeds + token_type_embeddings
- position_embeddings = self.position_embeddings(position_ids)
- embeddings += position_embeddings
- embeddings = self.LayerNorm(embeddings)
- embeddings = self.dropout(embeddings)
- return embeddings, position_ids
- def create_position_ids_from_input_ids(self, input_ids, padding_idx):
- """
- Args:
- Replace non-padding symbols with their position numbers. Position numbers begin at padding_idx+1. Padding
- symbols are ignored. This is modified from fairseq's `utils.make_positions`.
- x: torch.Tensor x:
- Returns: torch.Tensor
- """
- # The series of casts and type-conversions here are carefully balanced to both work with ONNX export and XLA.
- mask = input_ids.ne(padding_idx).int()
- incremental_indices = (torch.cumsum(mask, dim=1).type_as(mask)) * mask
- return incremental_indices.long() + padding_idx
- def create_position_ids_from_inputs_embeds(self, inputs_embeds):
- """
- Args:
- We are provided embeddings directly. We cannot infer which are padded so just generate sequential position ids.:
- inputs_embeds: torch.Tensor
- Returns: torch.Tensor
- """
- input_shape = inputs_embeds.size()[:-1]
- sequence_length = input_shape[1]
- position_ids = torch.arange(
- self.padding_idx + 1, sequence_length + self.padding_idx + 1, dtype=torch.long, device=inputs_embeds.device
- )
- return position_ids.unsqueeze(0).expand(input_shape)
- class LiltLayoutEmbeddings(nn.Module):
- def __init__(self, config):
- super().__init__()
- # we divide the hidden_size by 6 here as there are 6 different layout embeddings,
- # namely left_position, upper_position, right_position, lower_position, height, width
- self.x_position_embeddings = nn.Embedding(config.max_2d_position_embeddings, config.hidden_size // 6)
- self.y_position_embeddings = nn.Embedding(config.max_2d_position_embeddings, config.hidden_size // 6)
- self.h_position_embeddings = nn.Embedding(config.max_2d_position_embeddings, config.hidden_size // 6)
- self.w_position_embeddings = nn.Embedding(config.max_2d_position_embeddings, config.hidden_size // 6)
- self.padding_idx = config.pad_token_id
- self.box_position_embeddings = nn.Embedding(
- config.max_position_embeddings,
- config.hidden_size // config.channel_shrink_ratio,
- padding_idx=self.padding_idx,
- )
- self.box_linear_embeddings = nn.Linear(
- in_features=config.hidden_size, out_features=config.hidden_size // config.channel_shrink_ratio
- )
- self.LayerNorm = nn.LayerNorm(config.hidden_size // config.channel_shrink_ratio, eps=config.layer_norm_eps)
- self.dropout = nn.Dropout(config.hidden_dropout_prob)
- def forward(self, bbox=None, position_ids=None):
- try:
- left_position_embeddings = self.x_position_embeddings(bbox[:, :, 0])
- upper_position_embeddings = self.y_position_embeddings(bbox[:, :, 1])
- right_position_embeddings = self.x_position_embeddings(bbox[:, :, 2])
- lower_position_embeddings = self.y_position_embeddings(bbox[:, :, 3])
- except IndexError as e:
- raise IndexError("The `bbox` coordinate values should be within 0-1000 range.") from e
- h_position_embeddings = self.h_position_embeddings(bbox[:, :, 3] - bbox[:, :, 1])
- w_position_embeddings = self.w_position_embeddings(bbox[:, :, 2] - bbox[:, :, 0])
- spatial_position_embeddings = torch.cat(
- [
- left_position_embeddings,
- upper_position_embeddings,
- right_position_embeddings,
- lower_position_embeddings,
- h_position_embeddings,
- w_position_embeddings,
- ],
- dim=-1,
- )
- spatial_position_embeddings = self.box_linear_embeddings(spatial_position_embeddings)
- box_position_embeddings = self.box_position_embeddings(position_ids)
- spatial_position_embeddings = spatial_position_embeddings + box_position_embeddings
- spatial_position_embeddings = self.LayerNorm(spatial_position_embeddings)
- spatial_position_embeddings = self.dropout(spatial_position_embeddings)
- return spatial_position_embeddings
- class LiltSelfAttention(nn.Module):
- def __init__(self, config, layer_idx=None):
- super().__init__()
- if config.hidden_size % config.num_attention_heads != 0 and not hasattr(config, "embedding_size"):
- raise ValueError(
- f"The hidden size ({config.hidden_size}) is not a multiple of the number of attention "
- f"heads ({config.num_attention_heads})"
- )
- self.num_attention_heads = config.num_attention_heads
- self.attention_head_size = int(config.hidden_size / config.num_attention_heads)
- self.all_head_size = self.num_attention_heads * self.attention_head_size
- self.query = nn.Linear(config.hidden_size, self.all_head_size)
- self.key = nn.Linear(config.hidden_size, self.all_head_size)
- self.value = nn.Linear(config.hidden_size, self.all_head_size)
- self.layout_query = nn.Linear(
- config.hidden_size // config.channel_shrink_ratio, self.all_head_size // config.channel_shrink_ratio
- )
- self.layout_key = nn.Linear(
- config.hidden_size // config.channel_shrink_ratio, self.all_head_size // config.channel_shrink_ratio
- )
- self.layout_value = nn.Linear(
- config.hidden_size // config.channel_shrink_ratio, self.all_head_size // config.channel_shrink_ratio
- )
- self.dropout = nn.Dropout(config.attention_probs_dropout_prob)
- self.channel_shrink_ratio = config.channel_shrink_ratio
- self.layer_idx = layer_idx
- def transpose_for_scores(self, x, r=1):
- new_x_shape = x.size()[:-1] + (self.num_attention_heads, self.attention_head_size // r)
- x = x.view(*new_x_shape)
- return x.permute(0, 2, 1, 3)
- def forward(
- self,
- hidden_states,
- layout_inputs,
- attention_mask=None,
- output_attentions=False,
- ):
- layout_value_layer = self.transpose_for_scores(self.layout_value(layout_inputs), r=self.channel_shrink_ratio)
- layout_key_layer = self.transpose_for_scores(self.layout_key(layout_inputs), r=self.channel_shrink_ratio)
- layout_query_layer = self.transpose_for_scores(self.layout_query(layout_inputs), r=self.channel_shrink_ratio)
- mixed_query_layer = self.query(hidden_states)
- key_layer = self.transpose_for_scores(self.key(hidden_states))
- value_layer = self.transpose_for_scores(self.value(hidden_states))
- query_layer = self.transpose_for_scores(mixed_query_layer)
- attention_scores = torch.matmul(query_layer, key_layer.transpose(-1, -2))
- layout_attention_scores = torch.matmul(layout_query_layer, layout_key_layer.transpose(-1, -2))
- tmp_attention_scores = attention_scores / math.sqrt(self.attention_head_size)
- tmp_layout_attention_scores = layout_attention_scores / math.sqrt(
- self.attention_head_size // self.channel_shrink_ratio
- )
- attention_scores = tmp_attention_scores + tmp_layout_attention_scores
- layout_attention_scores = tmp_layout_attention_scores + tmp_attention_scores
- if attention_mask is not None:
- # Apply the attention mask is (precomputed for all layers in BertModel forward() function)
- layout_attention_scores = layout_attention_scores + attention_mask
- # Normalize the attention scores to probabilities.
- layout_attention_probs = nn.Softmax(dim=-1)(layout_attention_scores)
- # This is actually dropping out entire tokens to attend to, which might
- # seem a bit unusual, but is taken from the original Transformer paper.
- layout_attention_probs = self.dropout(layout_attention_probs)
- layout_context_layer = torch.matmul(layout_attention_probs, layout_value_layer)
- layout_context_layer = layout_context_layer.permute(0, 2, 1, 3).contiguous()
- new_context_layer_shape = layout_context_layer.size()[:-2] + (self.all_head_size // self.channel_shrink_ratio,)
- layout_context_layer = layout_context_layer.view(*new_context_layer_shape)
- if attention_mask is not None:
- # Apply the attention mask is (precomputed for all layers in RobertaModel forward() function)
- attention_scores = attention_scores + attention_mask
- # Normalize the attention scores to probabilities.
- attention_probs = nn.Softmax(dim=-1)(attention_scores)
- # This is actually dropping out entire tokens to attend to, which might
- # seem a bit unusual, but is taken from the original Transformer paper.
- attention_probs = self.dropout(attention_probs)
- context_layer = torch.matmul(attention_probs, value_layer)
- context_layer = context_layer.permute(0, 2, 1, 3).contiguous()
- new_context_layer_shape = context_layer.size()[:-2] + (self.all_head_size,)
- context_layer = context_layer.view(*new_context_layer_shape)
- outputs = (context_layer, layout_context_layer)
- if output_attentions:
- outputs = outputs + (attention_probs,)
- return outputs
- # Copied from transformers.models.bert.modeling_bert.BertSelfOutput
- class LiltSelfOutput(nn.Module):
- def __init__(self, config):
- super().__init__()
- self.dense = nn.Linear(config.hidden_size, config.hidden_size)
- self.LayerNorm = nn.LayerNorm(config.hidden_size, eps=config.layer_norm_eps)
- self.dropout = nn.Dropout(config.hidden_dropout_prob)
- def forward(self, hidden_states: torch.Tensor, input_tensor: torch.Tensor) -> torch.Tensor:
- hidden_states = self.dense(hidden_states)
- hidden_states = self.dropout(hidden_states)
- hidden_states = self.LayerNorm(hidden_states + input_tensor)
- return hidden_states
- class LiltAttention(nn.Module):
- def __init__(self, config, layer_idx=None):
- super().__init__()
- self.self = LiltSelfAttention(config, layer_idx=layer_idx)
- self.output = LiltSelfOutput(config)
- ori_hidden_size = config.hidden_size
- config.hidden_size = config.hidden_size // config.channel_shrink_ratio
- self.layout_output = LiltSelfOutput(config)
- config.hidden_size = ori_hidden_size
- def forward(
- self,
- hidden_states: torch.Tensor,
- layout_inputs: torch.Tensor,
- attention_mask: torch.FloatTensor | None = None,
- output_attentions: bool | None = False,
- ) -> tuple[torch.Tensor]:
- self_outputs = self.self(
- hidden_states,
- layout_inputs,
- attention_mask,
- output_attentions,
- )
- attention_output = self.output(self_outputs[0], hidden_states)
- layout_attention_output = self.layout_output(self_outputs[1], layout_inputs)
- outputs = (attention_output, layout_attention_output) + self_outputs[2:] # add attentions if we output them
- return outputs
- # Copied from transformers.models.bert.modeling_bert.BertIntermediate
- class LiltIntermediate(nn.Module):
- def __init__(self, config):
- super().__init__()
- self.dense = nn.Linear(config.hidden_size, config.intermediate_size)
- if isinstance(config.hidden_act, str):
- self.intermediate_act_fn = ACT2FN[config.hidden_act]
- else:
- self.intermediate_act_fn = config.hidden_act
- def forward(self, hidden_states: torch.Tensor) -> torch.Tensor:
- hidden_states = self.dense(hidden_states)
- hidden_states = self.intermediate_act_fn(hidden_states)
- return hidden_states
- # Copied from transformers.models.bert.modeling_bert.BertOutput
- class LiltOutput(nn.Module):
- def __init__(self, config):
- super().__init__()
- self.dense = nn.Linear(config.intermediate_size, config.hidden_size)
- self.LayerNorm = nn.LayerNorm(config.hidden_size, eps=config.layer_norm_eps)
- self.dropout = nn.Dropout(config.hidden_dropout_prob)
- def forward(self, hidden_states: torch.Tensor, input_tensor: torch.Tensor) -> torch.Tensor:
- hidden_states = self.dense(hidden_states)
- hidden_states = self.dropout(hidden_states)
- hidden_states = self.LayerNorm(hidden_states + input_tensor)
- return hidden_states
- class LiltLayer(GradientCheckpointingLayer):
- def __init__(self, config, layer_idx=None):
- super().__init__()
- self.chunk_size_feed_forward = config.chunk_size_feed_forward
- self.seq_len_dim = 1
- self.attention = LiltAttention(config, layer_idx=layer_idx)
- self.intermediate = LiltIntermediate(config)
- self.output = LiltOutput(config)
- ori_hidden_size = config.hidden_size
- ori_intermediate_size = config.intermediate_size
- config.hidden_size = config.hidden_size // config.channel_shrink_ratio
- config.intermediate_size = config.intermediate_size // config.channel_shrink_ratio
- self.layout_intermediate = LiltIntermediate(config)
- self.layout_output = LiltOutput(config)
- config.hidden_size = ori_hidden_size
- config.intermediate_size = ori_intermediate_size
- def forward(
- self,
- hidden_states: torch.Tensor,
- layout_inputs: torch.Tensor,
- attention_mask: torch.FloatTensor | None = None,
- output_attentions: bool | None = False,
- ) -> tuple[torch.Tensor]:
- self_attention_outputs = self.attention(
- hidden_states,
- layout_inputs,
- attention_mask,
- output_attentions=output_attentions,
- )
- attention_output = self_attention_outputs[0]
- layout_attention_output = self_attention_outputs[1]
- outputs = self_attention_outputs[2:] # add self attentions if we output attention weights
- layer_output = apply_chunking_to_forward(
- self.feed_forward_chunk, self.chunk_size_feed_forward, self.seq_len_dim, attention_output
- )
- layout_layer_output = apply_chunking_to_forward(
- self.layout_feed_forward_chunk, self.chunk_size_feed_forward, self.seq_len_dim, layout_attention_output
- )
- outputs = (layer_output, layout_layer_output) + outputs
- return outputs
- # Copied from transformers.models.bert.modeling_bert.BertLayer.feed_forward_chunk
- def feed_forward_chunk(self, attention_output):
- intermediate_output = self.intermediate(attention_output)
- layer_output = self.output(intermediate_output, attention_output)
- return layer_output
- def layout_feed_forward_chunk(self, attention_output):
- intermediate_output = self.layout_intermediate(attention_output)
- layer_output = self.layout_output(intermediate_output, attention_output)
- return layer_output
- class LiltEncoder(nn.Module):
- def __init__(self, config):
- super().__init__()
- self.config = config
- self.layer = nn.ModuleList([LiltLayer(config) for _ in range(config.num_hidden_layers)])
- def forward(
- self,
- hidden_states: torch.Tensor,
- layout_inputs: torch.Tensor,
- attention_mask: torch.FloatTensor | None = None,
- output_attentions: bool | None = False,
- output_hidden_states: bool | None = False,
- return_dict: bool | None = True,
- ) -> tuple[torch.Tensor] | BaseModelOutput:
- all_hidden_states = () if output_hidden_states else None
- all_self_attentions = () if output_attentions else None
- for i, layer_module in enumerate(self.layer):
- if output_hidden_states:
- all_hidden_states = all_hidden_states + (hidden_states,)
- layer_outputs = layer_module(
- hidden_states,
- layout_inputs,
- attention_mask,
- output_attentions,
- )
- hidden_states = layer_outputs[0]
- layout_inputs = layer_outputs[1]
- if output_attentions:
- all_self_attentions = all_self_attentions + (layer_outputs[2],)
- if output_hidden_states:
- all_hidden_states = all_hidden_states + (hidden_states,)
- if not return_dict:
- return tuple(
- v
- for v in [
- hidden_states,
- all_hidden_states,
- all_self_attentions,
- ]
- if v is not None
- )
- return BaseModelOutput(
- last_hidden_state=hidden_states,
- hidden_states=all_hidden_states,
- attentions=all_self_attentions,
- )
- # Copied from transformers.models.bert.modeling_bert.BertPooler
- class LiltPooler(nn.Module):
- def __init__(self, config):
- super().__init__()
- self.dense = nn.Linear(config.hidden_size, config.hidden_size)
- self.activation = nn.Tanh()
- def forward(self, hidden_states: torch.Tensor) -> torch.Tensor:
- # We "pool" the model by simply taking the hidden state corresponding
- # to the first token.
- first_token_tensor = hidden_states[:, 0]
- pooled_output = self.dense(first_token_tensor)
- pooled_output = self.activation(pooled_output)
- return pooled_output
- @auto_docstring
- class LiltPreTrainedModel(PreTrainedModel):
- config: LiltConfig
- base_model_prefix = "lilt"
- supports_gradient_checkpointing = True
- _no_split_modules = []
- def _init_weights(self, module):
- super()._init_weights(module)
- if isinstance(module, LiltTextEmbeddings):
- init.copy_(module.position_ids, torch.arange(module.position_ids.shape[-1]).expand((1, -1)))
- @auto_docstring
- class LiltModel(LiltPreTrainedModel):
- def __init__(self, config, add_pooling_layer=True):
- r"""
- add_pooling_layer (bool, *optional*, defaults to `True`):
- Whether to add a pooling layer
- """
- super().__init__(config)
- self.config = config
- self.embeddings = LiltTextEmbeddings(config)
- self.layout_embeddings = LiltLayoutEmbeddings(config)
- self.encoder = LiltEncoder(config)
- self.pooler = LiltPooler(config) if add_pooling_layer else None
- # Initialize weights and apply final processing
- self.post_init()
- def get_input_embeddings(self):
- return self.embeddings.word_embeddings
- def set_input_embeddings(self, value):
- self.embeddings.word_embeddings = value
- @auto_docstring
- def forward(
- self,
- input_ids: torch.Tensor | None = None,
- bbox: torch.Tensor | None = None,
- attention_mask: torch.Tensor | None = None,
- token_type_ids: torch.Tensor | None = None,
- position_ids: torch.Tensor | None = None,
- inputs_embeds: torch.Tensor | None = None,
- output_attentions: bool | None = None,
- output_hidden_states: bool | None = None,
- return_dict: bool | None = None,
- **kwargs,
- ) -> tuple[torch.Tensor] | BaseModelOutputWithPooling:
- r"""
- bbox (`torch.LongTensor` of shape `(batch_size, sequence_length, 4)`, *optional*):
- Bounding boxes of each input sequence tokens. Selected in the range `[0,
- config.max_2d_position_embeddings-1]`. Each bounding box should be a normalized version in (x0, y0, x1, y1)
- format, where (x0, y0) corresponds to the position of the upper left corner in the bounding box, and (x1,
- y1) represents the position of the lower right corner. See [Overview](#Overview) for normalization.
- Examples:
- ```python
- >>> from transformers import AutoTokenizer, AutoModel
- >>> from datasets import load_dataset
- >>> tokenizer = AutoTokenizer.from_pretrained("SCUT-DLVCLab/lilt-roberta-en-base")
- >>> model = AutoModel.from_pretrained("SCUT-DLVCLab/lilt-roberta-en-base")
- >>> dataset = load_dataset("nielsr/funsd-layoutlmv3", split="train")
- >>> example = dataset[0]
- >>> words = example["tokens"]
- >>> boxes = example["bboxes"]
- >>> encoding = tokenizer(words, boxes=boxes, return_tensors="pt")
- >>> outputs = model(**encoding)
- >>> last_hidden_states = outputs.last_hidden_state
- ```"""
- 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
- )
- return_dict = return_dict if return_dict is not None else self.config.return_dict
- if input_ids is not None and inputs_embeds is not None:
- raise ValueError("You cannot specify both input_ids and inputs_embeds at the same time")
- elif input_ids is not None:
- self.warn_if_padding_and_no_attention_mask(input_ids, attention_mask)
- input_shape = input_ids.size()
- elif inputs_embeds is not None:
- input_shape = inputs_embeds.size()[:-1]
- else:
- raise ValueError("You have to specify either input_ids or inputs_embeds")
- batch_size, seq_length = input_shape
- device = input_ids.device if input_ids is not None else inputs_embeds.device
- if bbox is None:
- bbox = torch.zeros(input_shape + (4,), dtype=torch.long, device=device)
- if attention_mask is None:
- attention_mask = torch.ones(((batch_size, seq_length)), device=device)
- if token_type_ids is None:
- if hasattr(self.embeddings, "token_type_ids"):
- buffered_token_type_ids = self.embeddings.token_type_ids[:, :seq_length]
- buffered_token_type_ids_expanded = buffered_token_type_ids.expand(batch_size, seq_length)
- token_type_ids = buffered_token_type_ids_expanded
- else:
- token_type_ids = torch.zeros(input_shape, dtype=torch.long, device=device)
- # We can provide a self-attention mask of dimensions [batch_size, from_seq_length, to_seq_length]
- # ourselves in which case we just need to make it broadcastable to all heads.
- extended_attention_mask: torch.Tensor = self.get_extended_attention_mask(attention_mask, input_shape)
- embedding_output, position_ids = self.embeddings(
- input_ids=input_ids,
- position_ids=position_ids,
- token_type_ids=token_type_ids,
- inputs_embeds=inputs_embeds,
- )
- layout_embedding_output = self.layout_embeddings(bbox=bbox, position_ids=position_ids)
- encoder_outputs = self.encoder(
- embedding_output,
- layout_embedding_output,
- attention_mask=extended_attention_mask,
- output_attentions=output_attentions,
- output_hidden_states=output_hidden_states,
- return_dict=return_dict,
- )
- sequence_output = encoder_outputs[0]
- pooled_output = self.pooler(sequence_output) if self.pooler is not None else None
- if not return_dict:
- return (sequence_output, pooled_output) + encoder_outputs[1:]
- return BaseModelOutputWithPooling(
- last_hidden_state=sequence_output,
- pooler_output=pooled_output,
- hidden_states=encoder_outputs.hidden_states,
- attentions=encoder_outputs.attentions,
- )
- @auto_docstring(
- custom_intro="""
- LiLT Model transformer with a sequence classification/regression head on top (a linear layer on top of the pooled
- output) e.g. for GLUE tasks.
- """
- )
- class LiltForSequenceClassification(LiltPreTrainedModel):
- # Copied from transformers.models.roberta.modeling_roberta.RobertaForSequenceClassification.__init__ with Roberta->Lilt, roberta->lilt
- def __init__(self, config):
- super().__init__(config)
- self.num_labels = config.num_labels
- self.config = config
- self.lilt = LiltModel(config, add_pooling_layer=False)
- self.classifier = LiltClassificationHead(config)
- # Initialize weights and apply final processing
- self.post_init()
- @auto_docstring
- def forward(
- self,
- input_ids: torch.LongTensor | None = None,
- bbox: torch.Tensor | None = None,
- attention_mask: torch.FloatTensor | None = None,
- token_type_ids: torch.LongTensor | None = None,
- position_ids: torch.LongTensor | None = None,
- inputs_embeds: torch.FloatTensor | None = None,
- labels: torch.LongTensor | None = None,
- output_attentions: bool | None = None,
- output_hidden_states: bool | None = None,
- return_dict: bool | None = None,
- **kwargs,
- ) -> tuple[torch.Tensor] | SequenceClassifierOutput:
- r"""
- bbox (`torch.LongTensor` of shape `(batch_size, sequence_length, 4)`, *optional*):
- Bounding boxes of each input sequence tokens. Selected in the range `[0,
- config.max_2d_position_embeddings-1]`. Each bounding box should be a normalized version in (x0, y0, x1, y1)
- format, where (x0, y0) corresponds to the position of the upper left corner in the bounding box, and (x1,
- y1) represents the position of the lower right corner. See [Overview](#Overview) for normalization.
- labels (`torch.LongTensor` of shape `(batch_size,)`, *optional*):
- Labels for computing the sequence classification/regression loss. Indices should be in `[0, ...,
- config.num_labels - 1]`. If `config.num_labels == 1` a regression loss is computed (Mean-Square loss), If
- `config.num_labels > 1` a classification loss is computed (Cross-Entropy).
- Examples:
- ```python
- >>> from transformers import AutoTokenizer, AutoModelForSequenceClassification
- >>> from datasets import load_dataset
- >>> tokenizer = AutoTokenizer.from_pretrained("SCUT-DLVCLab/lilt-roberta-en-base")
- >>> model = AutoModelForSequenceClassification.from_pretrained("SCUT-DLVCLab/lilt-roberta-en-base")
- >>> dataset = load_dataset("nielsr/funsd-layoutlmv3", split="train")
- >>> example = dataset[0]
- >>> words = example["tokens"]
- >>> boxes = example["bboxes"]
- >>> encoding = tokenizer(words, boxes=boxes, return_tensors="pt")
- >>> outputs = model(**encoding)
- >>> predicted_class_idx = outputs.logits.argmax(-1).item()
- >>> predicted_class = model.config.id2label[predicted_class_idx]
- ```"""
- return_dict = return_dict if return_dict is not None else self.config.return_dict
- outputs = self.lilt(
- input_ids,
- bbox=bbox,
- attention_mask=attention_mask,
- token_type_ids=token_type_ids,
- position_ids=position_ids,
- inputs_embeds=inputs_embeds,
- output_attentions=output_attentions,
- output_hidden_states=output_hidden_states,
- return_dict=return_dict,
- )
- sequence_output = outputs[0]
- logits = self.classifier(sequence_output)
- loss = None
- if labels is not None:
- # move labels to correct device
- labels = labels.to(logits.device)
- if self.config.problem_type is None:
- if self.num_labels == 1:
- self.config.problem_type = "regression"
- elif self.num_labels > 1 and (labels.dtype == torch.long or labels.dtype == torch.int):
- self.config.problem_type = "single_label_classification"
- else:
- self.config.problem_type = "multi_label_classification"
- if self.config.problem_type == "regression":
- loss_fct = MSELoss()
- if self.num_labels == 1:
- loss = loss_fct(logits.squeeze(), labels.squeeze())
- else:
- loss = loss_fct(logits, labels)
- elif self.config.problem_type == "single_label_classification":
- loss_fct = CrossEntropyLoss()
- loss = loss_fct(logits.view(-1, self.num_labels), labels.view(-1))
- elif self.config.problem_type == "multi_label_classification":
- loss_fct = BCEWithLogitsLoss()
- loss = loss_fct(logits, labels)
- if not return_dict:
- output = (logits,) + outputs[2:]
- return ((loss,) + output) if loss is not None else output
- return SequenceClassifierOutput(
- loss=loss,
- logits=logits,
- hidden_states=outputs.hidden_states,
- attentions=outputs.attentions,
- )
- @auto_docstring
- class LiltForTokenClassification(LiltPreTrainedModel):
- # Copied from transformers.models.roberta.modeling_roberta.RobertaForTokenClassification.__init__ with Roberta->Lilt, roberta->lilt
- def __init__(self, config):
- super().__init__(config)
- self.num_labels = config.num_labels
- self.lilt = LiltModel(config, add_pooling_layer=False)
- classifier_dropout = (
- config.classifier_dropout if config.classifier_dropout is not None else config.hidden_dropout_prob
- )
- self.dropout = nn.Dropout(classifier_dropout)
- self.classifier = nn.Linear(config.hidden_size, config.num_labels)
- # Initialize weights and apply final processing
- self.post_init()
- @auto_docstring
- def forward(
- self,
- input_ids: torch.LongTensor | None = None,
- bbox: torch.LongTensor | None = None,
- attention_mask: torch.FloatTensor | None = None,
- token_type_ids: torch.LongTensor | None = None,
- position_ids: torch.LongTensor | None = None,
- inputs_embeds: torch.FloatTensor | None = None,
- labels: torch.LongTensor | None = None,
- output_attentions: bool | None = None,
- output_hidden_states: bool | None = None,
- return_dict: bool | None = None,
- **kwargs,
- ) -> tuple[torch.Tensor] | TokenClassifierOutput:
- r"""
- bbox (`torch.LongTensor` of shape `(batch_size, sequence_length, 4)`, *optional*):
- Bounding boxes of each input sequence tokens. Selected in the range `[0,
- config.max_2d_position_embeddings-1]`. Each bounding box should be a normalized version in (x0, y0, x1, y1)
- format, where (x0, y0) corresponds to the position of the upper left corner in the bounding box, and (x1,
- y1) represents the position of the lower right corner. See [Overview](#Overview) for normalization.
- labels (`torch.LongTensor` of shape `(batch_size, sequence_length)`, *optional*):
- Labels for computing the token classification loss. Indices should be in `[0, ..., config.num_labels - 1]`.
- Examples:
- ```python
- >>> from transformers import AutoTokenizer, AutoModelForTokenClassification
- >>> from datasets import load_dataset
- >>> tokenizer = AutoTokenizer.from_pretrained("SCUT-DLVCLab/lilt-roberta-en-base")
- >>> model = AutoModelForTokenClassification.from_pretrained("SCUT-DLVCLab/lilt-roberta-en-base")
- >>> dataset = load_dataset("nielsr/funsd-layoutlmv3", split="train")
- >>> example = dataset[0]
- >>> words = example["tokens"]
- >>> boxes = example["bboxes"]
- >>> encoding = tokenizer(words, boxes=boxes, return_tensors="pt")
- >>> outputs = model(**encoding)
- >>> predicted_class_indices = outputs.logits.argmax(-1)
- ```"""
- return_dict = return_dict if return_dict is not None else self.config.return_dict
- outputs = self.lilt(
- input_ids,
- bbox=bbox,
- attention_mask=attention_mask,
- token_type_ids=token_type_ids,
- position_ids=position_ids,
- inputs_embeds=inputs_embeds,
- output_attentions=output_attentions,
- output_hidden_states=output_hidden_states,
- return_dict=return_dict,
- )
- sequence_output = outputs[0]
- sequence_output = self.dropout(sequence_output)
- logits = self.classifier(sequence_output)
- loss = None
- if labels is not None:
- # move labels to correct device
- labels = labels.to(logits.device)
- loss_fct = CrossEntropyLoss()
- loss = loss_fct(logits.view(-1, self.num_labels), labels.view(-1))
- if not return_dict:
- output = (logits,) + outputs[2:]
- return ((loss,) + output) if loss is not None else output
- return TokenClassifierOutput(
- loss=loss,
- logits=logits,
- hidden_states=outputs.hidden_states,
- attentions=outputs.attentions,
- )
- # Copied from transformers.models.roberta.modeling_roberta.RobertaClassificationHead with Roberta->Lilt
- class LiltClassificationHead(nn.Module):
- """Head for sentence-level classification tasks."""
- def __init__(self, config):
- super().__init__()
- self.dense = nn.Linear(config.hidden_size, config.hidden_size)
- classifier_dropout = (
- config.classifier_dropout if config.classifier_dropout is not None else config.hidden_dropout_prob
- )
- self.dropout = nn.Dropout(classifier_dropout)
- self.out_proj = nn.Linear(config.hidden_size, config.num_labels)
- def forward(self, features, **kwargs):
- x = features[:, 0, :] # take <s> token (equiv. to [CLS])
- x = self.dropout(x)
- x = self.dense(x)
- x = torch.tanh(x)
- x = self.dropout(x)
- x = self.out_proj(x)
- return x
- @auto_docstring
- class LiltForQuestionAnswering(LiltPreTrainedModel):
- # Copied from transformers.models.roberta.modeling_roberta.RobertaForQuestionAnswering.__init__ with Roberta->Lilt, roberta->lilt
- def __init__(self, config):
- super().__init__(config)
- self.num_labels = config.num_labels
- self.lilt = LiltModel(config, add_pooling_layer=False)
- self.qa_outputs = nn.Linear(config.hidden_size, config.num_labels)
- # Initialize weights and apply final processing
- self.post_init()
- @auto_docstring
- def forward(
- self,
- input_ids: torch.LongTensor | None = None,
- bbox: torch.LongTensor | None = None,
- attention_mask: torch.FloatTensor | None = None,
- token_type_ids: torch.LongTensor | None = None,
- position_ids: torch.LongTensor | None = None,
- inputs_embeds: torch.FloatTensor | None = None,
- start_positions: torch.LongTensor | None = None,
- end_positions: torch.LongTensor | None = None,
- output_attentions: bool | None = None,
- output_hidden_states: bool | None = None,
- return_dict: bool | None = None,
- **kwargs,
- ) -> tuple[torch.Tensor] | QuestionAnsweringModelOutput:
- r"""
- bbox (`torch.LongTensor` of shape `(batch_size, sequence_length, 4)`, *optional*):
- Bounding boxes of each input sequence tokens. Selected in the range `[0,
- config.max_2d_position_embeddings-1]`. Each bounding box should be a normalized version in (x0, y0, x1, y1)
- format, where (x0, y0) corresponds to the position of the upper left corner in the bounding box, and (x1,
- y1) represents the position of the lower right corner. See [Overview](#Overview) for normalization.
- Examples:
- ```python
- >>> from transformers import AutoTokenizer, AutoModelForQuestionAnswering
- >>> from datasets import load_dataset
- >>> tokenizer = AutoTokenizer.from_pretrained("SCUT-DLVCLab/lilt-roberta-en-base")
- >>> model = AutoModelForQuestionAnswering.from_pretrained("SCUT-DLVCLab/lilt-roberta-en-base")
- >>> dataset = load_dataset("nielsr/funsd-layoutlmv3", split="train")
- >>> example = dataset[0]
- >>> words = example["tokens"]
- >>> boxes = example["bboxes"]
- >>> encoding = tokenizer(words, boxes=boxes, return_tensors="pt")
- >>> outputs = model(**encoding)
- >>> answer_start_index = outputs.start_logits.argmax()
- >>> answer_end_index = outputs.end_logits.argmax()
- >>> predict_answer_tokens = encoding.input_ids[0, answer_start_index : answer_end_index + 1]
- >>> predicted_answer = tokenizer.decode(predict_answer_tokens)
- ```"""
- return_dict = return_dict if return_dict is not None else self.config.return_dict
- outputs = self.lilt(
- input_ids,
- bbox=bbox,
- attention_mask=attention_mask,
- token_type_ids=token_type_ids,
- position_ids=position_ids,
- inputs_embeds=inputs_embeds,
- output_attentions=output_attentions,
- output_hidden_states=output_hidden_states,
- return_dict=return_dict,
- )
- sequence_output = outputs[0]
- logits = self.qa_outputs(sequence_output)
- start_logits, end_logits = logits.split(1, dim=-1)
- start_logits = start_logits.squeeze(-1).contiguous()
- end_logits = end_logits.squeeze(-1).contiguous()
- total_loss = None
- if start_positions is not None and end_positions is not None:
- # If we are on multi-GPU, split add a dimension
- if len(start_positions.size()) > 1:
- start_positions = start_positions.squeeze(-1)
- if len(end_positions.size()) > 1:
- end_positions = end_positions.squeeze(-1)
- # sometimes the start/end positions are outside our model inputs, we ignore these terms
- ignored_index = start_logits.size(1)
- start_positions = start_positions.clamp(0, ignored_index)
- end_positions = end_positions.clamp(0, ignored_index)
- loss_fct = CrossEntropyLoss(ignore_index=ignored_index)
- start_loss = loss_fct(start_logits, start_positions)
- end_loss = loss_fct(end_logits, end_positions)
- total_loss = (start_loss + end_loss) / 2
- if not return_dict:
- output = (start_logits, end_logits) + outputs[2:]
- return ((total_loss,) + output) if total_loss is not None else output
- return QuestionAnsweringModelOutput(
- loss=total_loss,
- start_logits=start_logits,
- end_logits=end_logits,
- hidden_states=outputs.hidden_states,
- attentions=outputs.attentions,
- )
- __all__ = [
- "LiltForQuestionAnswering",
- "LiltForSequenceClassification",
- "LiltForTokenClassification",
- "LiltModel",
- "LiltPreTrainedModel",
- ]
|