From ea2c6f1afc6cdbbdbe386edd0fc08917c5ef66cf Mon Sep 17 00:00:00 2001 From: Antonio V Mendoza Date: Thu, 3 Sep 2020 04:02:25 -0400 Subject: [PATCH] Adding the LXMERT pretraining model (MultiModal languageXvision) to HuggingFace's suite of models (#5793) * added template files for LXMERT and competed the configuration_lxmert.py * added modeling, tokization, testing, and finishing touched for lxmert [yet to be tested] * added model card for lxmert * cleaning up lxmert code * Update src/transformers/modeling_lxmert.py Co-authored-by: Lysandre Debut * Update src/transformers/modeling_tf_lxmert.py Co-authored-by: Lysandre Debut * Update src/transformers/modeling_tf_lxmert.py Co-authored-by: Lysandre Debut * Update src/transformers/modeling_lxmert.py Co-authored-by: Lysandre Debut * tested torch lxmert, changed documtention, updated outputs, and other small fixes * Update src/transformers/convert_pytorch_checkpoint_to_tf2.py Co-authored-by: Lysandre Debut * Update src/transformers/convert_pytorch_checkpoint_to_tf2.py Co-authored-by: Lysandre Debut * Update src/transformers/convert_pytorch_checkpoint_to_tf2.py Co-authored-by: Lysandre Debut * renaming, other small issues, did not change TF code in this commit * added lxmert question answering model in pytorch * added capability to edit number of qa labels for lxmert * made answer optional for lxmert question answering * add option to return hidden_states for lxmert * changed default qa labels for lxmert * changed config archive path * squshing 3 commits: merged UI + testing improvments + more UI and testing * changed some variable names for lxmert * TF LXMERT * Various fixes to LXMERT * Final touches to LXMERT * AutoTokenizer order * Add LXMERT to index.rst and README.md * Merge commit test fixes + Style update * TensorFlow 2.3.0 sequential model changes variable names Remove inherited test * Update src/transformers/modeling_tf_pytorch_utils.py * Update docs/source/model_doc/lxmert.rst Co-authored-by: Sylvain Gugger <35901082+sgugger@users.noreply.github.com> * Update docs/source/model_doc/lxmert.rst Co-authored-by: Sylvain Gugger <35901082+sgugger@users.noreply.github.com> * Update src/transformers/modeling_tf_lxmert.py Co-authored-by: Sylvain Gugger <35901082+sgugger@users.noreply.github.com> * added suggestions * Fixes * Final fixes for TF model * Fix docs Co-authored-by: Lysandre Debut Co-authored-by: Lysandre Co-authored-by: Sylvain Gugger <35901082+sgugger@users.noreply.github.com> --- README.md | 5 +- docs/source/index.rst | 6 +- docs/source/model_doc/lxmert.rst | 109 ++ docs/source/pretrained_models.rst | 6 +- .../uncnlp/lxmert-base-uncased/LICENSE | 21 + .../uncnlp/lxmert-base-uncased/README.md | 34 + .../lxmert-base-uncased/lxmert_model-1.jpg | Bin 0 -> 281338 bytes src/transformers/__init__.py | 19 + src/transformers/commands/convert.py | 10 +- src/transformers/configuration_auto.py | 6 + src/transformers/configuration_lxmert.py | 179 +++ ...xmert_original_tf_checkpoint_to_pytorch.py | 61 + .../convert_pytorch_checkpoint_to_tf2.py | 18 + src/transformers/modeling_auto.py | 4 + src/transformers/modeling_lxmert.py | 1426 +++++++++++++++++ src/transformers/modeling_tf_lxmert.py | 1378 ++++++++++++++++ src/transformers/modeling_tf_mobilebert.py | 12 +- src/transformers/modeling_tf_utils.py | 2 +- src/transformers/tokenization_auto.py | 5 + src/transformers/tokenization_lxmert.py | 80 + tests/test_modeling_lxmert.py | 684 ++++++++ tests/test_modeling_tf_lxmert.py | 680 ++++++++ tests/test_tokenization_lxmert.py | 65 + 23 files changed, 4798 insertions(+), 12 deletions(-) create mode 100644 docs/source/model_doc/lxmert.rst create mode 100644 model_cards/uncnlp/lxmert-base-uncased/LICENSE create mode 100644 model_cards/uncnlp/lxmert-base-uncased/README.md create mode 100644 model_cards/uncnlp/lxmert-base-uncased/lxmert_model-1.jpg create mode 100644 src/transformers/configuration_lxmert.py create mode 100755 src/transformers/convert_lxmert_original_tf_checkpoint_to_pytorch.py create mode 100644 src/transformers/modeling_lxmert.py create mode 100644 src/transformers/modeling_tf_lxmert.py create mode 100644 src/transformers/tokenization_lxmert.py create mode 100644 tests/test_modeling_lxmert.py create mode 100644 tests/test_modeling_tf_lxmert.py create mode 100644 tests/test_tokenization_lxmert.py diff --git a/README.md b/README.md index 9d82251138..9f161b8364 100644 --- a/README.md +++ b/README.md @@ -172,8 +172,9 @@ for Open-Domain Question Answering](https://arxiv.org/abs/2004.04906) by Vladimi Min, Patrick Lewis, Ledell Wu, Sergey Edunov, Danqi Chen, and Wen-tau Yih. 23. **[Pegasus](https://github.com/google-research/pegasus)** (from Google) released with the paper [PEGASUS: Pre-training with Extracted Gap-sentences for Abstractive Summarization](https://arxiv.org/abs/1912.08777)> by Jingqing Zhang, Yao Zhao, Mohammad Saleh and Peter J. Liu. 24. **[MBart](https://github.com/pytorch/fairseq/tree/master/examples/mbart)** (from Facebook) released with the paper [Multilingual Denoising Pre-training for Neural Machine Translation](https://arxiv.org/abs/2001.08210) by Yinhan Liu, Jiatao Gu, Naman Goyal, Xian Li, Sergey Edunov, Marjan Ghazvininejad, Mike Lewis, Luke Zettlemoyer. -25. **[Other community models](https://huggingface.co/models)**, contributed by the [community](https://huggingface.co/users). -26. Want to contribute a new model? We have added a **detailed guide and templates** to guide you in the process of adding a new model. You can find them in the [`templates`](./templates) folder of the repository. Be sure to check the [contributing guidelines](./CONTRIBUTING.md) and contact the maintainers or open an issue to collect feedbacks before starting your PR. +25. **[LXMERT](https://github.com/airsplay/lxmert)** (from UNC Chapel Hill) released with the paper [LXMERT: Learning Cross-Modality Encoder Representations from Transformers for Open-Domain Question Answering](https://arxiv.org/abs/1908.07490) by Hao Tan and Mohit Bansal. +26. **[Other community models](https://huggingface.co/models)**, contributed by the [community](https://huggingface.co/users). +27. Want to contribute a new model? We have added a **detailed guide and templates** to guide you in the process of adding a new model. You can find them in the [`templates`](./templates) folder of the repository. Be sure to check the [contributing guidelines](./CONTRIBUTING.md) and contact the maintainers or open an issue to collect feedbacks before starting your PR. These implementations have been tested on several datasets (see the example scripts) and should match the performances of the original implementations (e.g. ~93 F1 on SQuAD for BERT Whole-Word-Masking, ~88 F1 on RocStories for OpenAI GPT, ~18.3 perplexity on WikiText 103 for Transformer-XL, ~0.916 Pearson R coefficient on STS-B for XLNet). You can find more details on the performances in the Examples section of the [documentation](https://huggingface.co/transformers/examples.html). diff --git a/docs/source/index.rst b/docs/source/index.rst index 33b549d17f..a2acc39466 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -128,7 +128,10 @@ conversion utilities for the following models: `_ by Jingqing Zhang, Yao Zhao, Mohammad Saleh and Peter J. Liu. 24. `MBart `_ (from Facebook) released with the paper `Multilingual Denoising Pre-training for Neural Machine Translation `_ by Yinhan Liu, Jiatao Gu, Naman Goyal, Xian Li, Sergey Edunov, Marjan Ghazvininejad, Mike Lewis, Luke Zettlemoyer. -25. `Other community models `_, contributed by the `community +25. `LXMERT `_ (from UNC Chapel Hill) released with the paper `LXMERT: Learning + Cross-Modality Encoder Representations from Transformers for Open-Domain Question + Answering `_ by Hao Tan and Mohit Bansal. +26. `Other community models `_, contributed by the `community `_. .. toctree:: @@ -213,6 +216,7 @@ conversion utilities for the following models: model_doc/dpr model_doc/pegasus model_doc/mbart + model_doc/lxmert internal/modeling_utils internal/tokenization_utils internal/pipelines_utils diff --git a/docs/source/model_doc/lxmert.rst b/docs/source/model_doc/lxmert.rst new file mode 100644 index 0000000000..e9c7ad339f --- /dev/null +++ b/docs/source/model_doc/lxmert.rst @@ -0,0 +1,109 @@ +LXMERT +---------------------------------------------------- + +Overview +~~~~~~~~~~~~~~~~~~~~~ + +The LXMERT model was proposed in `LXMERT: Learning Cross-Modality Encoder Representations from Transformers `__ +by Hao Tan & Mohit Bansal. It is a series of bidirectional transformer encoders (one for the vision modality, one for the language modality, and then one to fuse both modalities) +pre-trained using a combination of masked language modeling, visual-language text alignment, ROI-feature regression, masked visual-attribute modeling, masked visual-object modeling, and visual-question answering objectives. +The pretraining consists of multiple multi-modal datasets: MSCOCO, Visual-Genome + Visual-Genome Question Answering, VQA 2.0, and GQA. + +The abstract from the paper is the following: + +*Vision-and-language reasoning requires an understanding of visual concepts, language semantics, and, most importantly, the alignment and relationships between these two +modalities. We thus propose the LXMERT +(Learning Cross-Modality Encoder Representations from Transformers) framework to learn +these vision-and-language connections. In +LXMERT, we build a large-scale Transformer +model that consists of three encoders: an object relationship encoder, a language encoder, +and a cross-modality encoder. Next, to endow our model with the capability of connecting vision and language semantics, we +pre-train the model with large amounts of +image-and-sentence pairs, via five diverse representative pre-training tasks: masked language modeling, masked object prediction +(feature regression and label classification), +cross-modality matching, and image question answering. These tasks help in learning both intra-modality and cross-modality relationships. After fine-tuning from our pretrained parameters, our model achieves the +state-of-the-art results on two visual question answering datasets (i.e., VQA and GQA). +We also show the generalizability of our pretrained cross-modality model by adapting it to +a challenging visual-reasoning task, NLVR +, +and improve the previous best result by 22% +absolute (54% to 76%). Lastly, we demonstrate detailed ablation studies to prove that +both our novel model components and pretraining strategies significantly contribute to +our strong results; and also present several +attention visualizations for the different encoders* + +Tips: + +- Bounding boxes are not necessary to be used in the visual feature embeddings, any kind of visual-spacial features will work. +- Both the language hidden states and the visual hidden states that LXMERT outputs are passed through the cross-modality layer, so they + contain information from both modalities. To access a modality that only attends to itself, select the vision/language hidden states from the first input in the tuple. +- The bi-directional cross-modality encoder attention only returns attention values when the language modality is used as the input and the vision modality is used as the context vector. Further, + while the cross-modality encoder contains self-attention for each respective modality and cross-attention, only the cross attention is returned and both self attention outputs are disregarded. + +The code can be found `here `__ + + +LxmertConfig +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. autoclass:: transformers.LxmertConfig + :members: + + +LxmertTokenizer +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. autoclass:: transformers.LxmertTokenizer + :members: build_inputs_with_special_tokens, get_special_tokens_mask, + create_token_type_ids_from_sequences, save_vocabulary + + +Lxmert specific outputs +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. autoclass:: transformers.modeling_lxmert.LxmertModelOutput + :members: + +.. autoclass:: transformers.modeling_lxmert.LxmertForPreTrainingOutput + :members: + +.. autoclass:: transformers.modeling_lxmert.LxmertForQuestionAnsweringOutput + :members: + +.. autoclass:: transformers.modeling_tf_lxmert.TFLxmertModelOutput + :members: + +.. autoclass:: transformers.modeling_tf_lxmert.TFLxmertForPreTrainingOutput + :members: + + +LxmertModel +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. autoclass:: transformers.LxmertModel + :members: + +LxmertForPreTraining +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. autoclass:: transformers.LxmertForPreTraining + :members: + +LxmertForQuestionAnswering +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. autoclass:: transformers.LxmertForQuestionAnswering + :members: + + +TFLxmertModel +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. autoclass:: transformers.TFLxmertModel + :members: + +TFLxmertForPreTraining +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. autoclass:: transformers.TFLxmertForPreTraining + :members: diff --git a/docs/source/pretrained_models.rst b/docs/source/pretrained_models.rst index 44a6b721fa..5acdb9f761 100644 --- a/docs/source/pretrained_models.rst +++ b/docs/source/pretrained_models.rst @@ -363,4 +363,8 @@ For a list that includes community-uploaded models, refer to `https://huggingfac | +------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ | | ``facebook/mbart-large-en-ro`` | | 24-layer, 1024-hidden, 16-heads, 610M parameters | | | | | mbart-large-cc25 model finetuned on WMT english romanian translation. | -+-------------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ \ No newline at end of file ++-------------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ +| Lxmert | ``lxmert-base-uncased`` | | 9-language layers, 9-relationship layers, and 12-cross-modality layers | +| | | | 768-hidden, 12-heads (for each layer) ~ 228M parameters | +| | | | Starting from lxmert-base checkpoint, trained on over 9 million image-text couplets from COCO, VisualGenome, GQA, VQA | ++-------------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ diff --git a/model_cards/uncnlp/lxmert-base-uncased/LICENSE b/model_cards/uncnlp/lxmert-base-uncased/LICENSE new file mode 100644 index 0000000000..52df82d356 --- /dev/null +++ b/model_cards/uncnlp/lxmert-base-uncased/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2019 Hao Tan + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/model_cards/uncnlp/lxmert-base-uncased/README.md b/model_cards/uncnlp/lxmert-base-uncased/README.md new file mode 100644 index 0000000000..1cb7d36f5b --- /dev/null +++ b/model_cards/uncnlp/lxmert-base-uncased/README.md @@ -0,0 +1,34 @@ +# LXMERT + +## Model Description + +[LXMERT](https://arxiv.org/abs/1908.07490) is a pre-trained multimodal transformer. The model takes an image and a sentence as input and compute cross-modal representions. The model is converted from [LXMERT github](https://github.com/airsplay/lxmert) by [Antonio Mendoza](https://avmendoza.info/) and is authored by [Hao Tan](https://www.cs.unc.edu/~airsplay/). + +![](./lxmert_model-1.jpg?raw=True) + +## Usage + + +## Training Data and Prodcedure +The model is jointly trained on multiple vision-and-language datasets. +We included two image captioning datsets (i.e., [MS COCO](http://cocodataset.org/#home), [Visual Genome](https://visualgenome.org/)) and three image-question answering datasets (i.e., [VQA](https://visualqa.org/), [GQA](https://cs.stanford.edu/people/dorarad/gqa/), [VG QA](https://github.com/yukezhu/visual7w-toolkit)). The model is pre-trained on the above datasets for 20 epochs (roughly 670K iterations with batch size 256), which takes around 8 days on 4 Titan V cards. The details of training could be found in the [LXMERT paper](https://arxiv.org/pdf/1908.07490.pdf). + +## Eval Results +| Split | [VQA](https://visualqa.org/) | [GQA](https://cs.stanford.edu/people/dorarad/gqa/) | [NLVR2](http://lil.nlp.cornell.edu/nlvr/) | +|----------- |:----: |:---: |:------:| +| Local Validation | 69.90% | 59.80% | 74.95% | +| Test-Dev | 72.42% | 60.00% | 74.45% (Test-P) | +| Test-Standard | 72.54% | 60.33% | 76.18% (Test-U) | + + +## Reference +```bibtex +@inproceedings{tan2019lxmert, + title={LXMERT: Learning Cross-Modality Encoder Representations from Transformers}, + author={Tan, Hao and Bansal, Mohit}, + booktitle={Proceedings of the 2019 Conference on Empirical Methods in Natural Language Processing}, + year={2019} +} +``` + + diff --git a/model_cards/uncnlp/lxmert-base-uncased/lxmert_model-1.jpg b/model_cards/uncnlp/lxmert-base-uncased/lxmert_model-1.jpg new file mode 100644 index 0000000000000000000000000000000000000000..20e3b7cce3c13de4296895899ebad2c52bbe9d7d GIT binary patch literal 281338 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ƚJ56p|_g1Lq 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 z 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%0DSN90<1&UQUU)TJN3VM`>&pHVJU_&xrG+D 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 literal 0 HcmV?d00001 diff --git a/src/transformers/__init__.py b/src/transformers/__init__.py index 48e812fb98..624246b338 100755 --- a/src/transformers/__init__.py +++ b/src/transformers/__init__.py @@ -31,6 +31,7 @@ from .configuration_encoder_decoder import EncoderDecoderConfig from .configuration_flaubert import FLAUBERT_PRETRAINED_CONFIG_ARCHIVE_MAP, FlaubertConfig from .configuration_gpt2 import GPT2_PRETRAINED_CONFIG_ARCHIVE_MAP, GPT2Config from .configuration_longformer import LONGFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP, LongformerConfig +from .configuration_lxmert import LXMERT_PRETRAINED_CONFIG_ARCHIVE_MAP, LxmertConfig from .configuration_marian import MarianConfig from .configuration_mbart import MBartConfig from .configuration_mmbt import MMBTConfig @@ -156,6 +157,7 @@ from .tokenization_electra import ElectraTokenizer, ElectraTokenizerFast from .tokenization_flaubert import FlaubertTokenizer from .tokenization_gpt2 import GPT2Tokenizer, GPT2TokenizerFast from .tokenization_longformer import LongformerTokenizer, LongformerTokenizerFast +from .tokenization_lxmert import LxmertTokenizer, LxmertTokenizerFast from .tokenization_mbart import MBartTokenizer from .tokenization_mobilebert import MobileBertTokenizer, MobileBertTokenizerFast from .tokenization_openai import OpenAIGPTTokenizer, OpenAIGPTTokenizerFast @@ -343,6 +345,15 @@ if is_torch_available(): LongformerModel, LongformerSelfAttention, ) + from .modeling_lxmert import ( + LxmertEncoder, + LxmertForPreTraining, + LxmertForQuestionAnswering, + LxmertModel, + LxmertPreTrainedModel, + LxmertVisualFeatureEncoder, + LxmertXLayer, + ) from .modeling_marian import MarianMTModel from .modeling_mbart import MBartForConditionalGeneration from .modeling_mmbt import MMBTForClassification, MMBTModel, ModalEmbeddings @@ -573,6 +584,14 @@ if is_tf_available(): TFLongformerModel, TFLongformerSelfAttention, ) + from .modeling_tf_lxmert import ( + TF_LXMERT_PRETRAINED_MODEL_ARCHIVE_LIST, + TFLxmertForPreTraining, + TFLxmertMainLayer, + TFLxmertModel, + TFLxmertPreTrainedModel, + TFLxmertVisualFeatureEncoder, + ) from .modeling_tf_mobilebert import ( TF_MOBILEBERT_PRETRAINED_MODEL_ARCHIVE_LIST, TFMobileBertForMaskedLM, diff --git a/src/transformers/commands/convert.py b/src/transformers/commands/convert.py index 8c3f952f4a..f9e7822409 100644 --- a/src/transformers/commands/convert.py +++ b/src/transformers/commands/convert.py @@ -155,5 +155,13 @@ class ConvertCommand(BaseTransformersCLICommand): ) convert_xlm_checkpoint_to_pytorch(self._tf_checkpoint, self._pytorch_dump_output) + elif self._model_type == "lxmert": + from transformers.convert_lxmert_original_pytorch_checkpoint_to_pytorch import ( + convert_lxmert_checkpoint_to_pytorch, + ) + + convert_lxmert_checkpoint_to_pytorch(self._tf_checkpoint, self._pytorch_dump_output) else: - raise ValueError("--model_type should be selected in the list [bert, gpt, gpt2, transfo_xl, xlnet, xlm]") + raise ValueError( + "--model_type should be selected in the list [bert, gpt, gpt2, transfo_xl, xlnet, xlm, lxmert]" + ) diff --git a/src/transformers/configuration_auto.py b/src/transformers/configuration_auto.py index 737cd811aa..6dc1e5dd0d 100644 --- a/src/transformers/configuration_auto.py +++ b/src/transformers/configuration_auto.py @@ -28,6 +28,7 @@ from .configuration_encoder_decoder import EncoderDecoderConfig from .configuration_flaubert import FLAUBERT_PRETRAINED_CONFIG_ARCHIVE_MAP, FlaubertConfig from .configuration_gpt2 import GPT2_PRETRAINED_CONFIG_ARCHIVE_MAP, GPT2Config from .configuration_longformer import LONGFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP, LongformerConfig +from .configuration_lxmert import LXMERT_PRETRAINED_CONFIG_ARCHIVE_MAP, LxmertConfig from .configuration_marian import MarianConfig from .configuration_mbart import MBART_PRETRAINED_CONFIG_ARCHIVE_MAP, MBartConfig from .configuration_mobilebert import MobileBertConfig @@ -66,6 +67,7 @@ ALL_PRETRAINED_CONFIG_ARCHIVE_MAP = dict( ELECTRA_PRETRAINED_CONFIG_ARCHIVE_MAP, LONGFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP, RETRIBERT_PRETRAINED_CONFIG_ARCHIVE_MAP, + LXMERT_PRETRAINED_CONFIG_ARCHIVE_MAP, ] for key, value, in pretrained_map.items() ) @@ -166,6 +168,10 @@ CONFIG_MAPPING = OrderedDict( "encoder-decoder", EncoderDecoderConfig, ), + ( + "lxmert", + LxmertConfig, + ), ] ) diff --git a/src/transformers/configuration_lxmert.py b/src/transformers/configuration_lxmert.py new file mode 100644 index 0000000000..7e5c0a168a --- /dev/null +++ b/src/transformers/configuration_lxmert.py @@ -0,0 +1,179 @@ +# coding=utf-8 +# Copyright 2018, Hao Tan, Mohit Bansal +# +# 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. +""" LXMERT model configuration """ + + +import logging + +from .configuration_utils import PretrainedConfig + + +logger = logging.getLogger(__name__) + +LXMERT_PRETRAINED_CONFIG_ARCHIVE_MAP = { + "unc-nlp/lxmert-base-uncased": "", +} + + +class LxmertConfig(PretrainedConfig): + r""" + This is the configuration class to store the configuration of a :class:`~transformers.BertModel`. + It is used to instantiate an Lxmert model according to the specified arguments, defining the model + architecture. + + + Args: + vocab_size (:obj:`int`, optional, defaults to 30522): + Vocabulary size of the BERT model. Defines the different tokens that + can be represented by the `inputs_ids` passed to the forward method of :class:`~transformers.BertModel`. + hidden_size (:obj:`int`, optional, defaults to 768): + Dimensionality of the encoder layers and the pooler layer. + r_layers (:obj:`int`, optional, defaults to 5): + Number of hidden layers in the Transformer visual encoder. + l_layers (:obj:`int`, optional, defaults to 9): + Number of hidden layers in the Transformer language encoder. + x_layers (:obj:`int`, optional, defaults to 5): + Number of hidden layers in the Transformer cross modality encoder. + num_attention_heads (:obj:`int`, optional, defaults to 5): + Number of attention heads for each attention layer in the Transformer encoder. + intermediate_size (:obj:`int`, optional, defaults to 3072): + Dimensionality of the "intermediate" (i.e., feed-forward) layer in the Transformer encoder. + hidden_act (:obj:`str` or :obj:`function`, optional, defaults to "gelu"): + The non-linear activation function (function or string) in the encoder and pooler. + If string, "gelu", "relu", "swish" and "gelu_new" are supported. + hidden_dropout_prob (:obj:`float`, optional, defaults to 0.1): + The dropout probabilitiy for all fully connected layers in the embeddings, encoder, and pooler. + attention_probs_dropout_prob (:obj:`float`, optional, defaults to 0.1): + The dropout ratio for the attention probabilities. + max_position_embeddings (:obj:`int`, optional, defaults to 512): + The maximum sequence length that this model might ever be used with. + Typically set this to something large just in case (e.g., 512 or 1024 or 2048). + type_vocab_size (:obj:`int`, optional, defaults to 2): + The vocabulary size of the `token_type_ids` passed into :class:`~transformers.BertModel`. + initializer_range (:obj:`float`, optional, defaults to 0.02): + The standard deviation of the truncated_normal_initializer for initializing all weight matrices. + layer_norm_eps (:obj:`float`, optional, defaults to 1e-12): + The epsilon used by the layer normalization layers. + visual_feat_dim (:obj:`int`, optional, defaults to 2048): + This represents the last dimension of the pooled-object features used as input for the model, + representing the size of each object feature itself. + visual_pos_dim (:obj:`int`, optional, defaults to 4): + This represents the number of spacial features that are mixed into the visual features. + The default is set to 4 because most commonly this will represent the location of a bounding box. + i.e. (x, y, width, height) + visual_loss_normalizer (:obj:`float`, optional, defaults to 1/15): + This represents the scaling factor in which each visual loss is multiplied by if during pretraining, + one decided to train with multiple vision-based loss objectives. + num_qa_labels (:obj:`int`, optional, defaults to 9500): + This represents the total number of different question answering (QA) labels there are. If using more than one dataset with QA, + the user will need to account for the total number of labels that all of the datasets have in total. + num_object_labels (:obj:`int`, optional, defaults to 1600): + This represents the total number of semantically unique objects that lxmert will be able to classify a pooled-object feature + as belonging too. + num_attr_labels (:obj:`int`, optional, defaults to 400): + This represents the total number of semantically unique attributes that lxmert will be able to classify a pooled-object feature + as possessing. + task_matched (:obj:`bool`, optional, defaults to True): + This task is used for sentence-image matching. If the sentence correctly describes the image the label will be 1. + If the sentence does not correctly describe the image, the label will be 0. + task_mask_lm (:obj:`bool`, optional, defaults to True): + This task is the defacto masked langauge modeling used in pretraining models such as BERT. + task_obj_predict (:obj:`bool`, optional, defaults to True): + This task is set to true if the user would like to perform one of the following loss objectives: + object predicition, atrribute predicition, feature regression + task_qa (:obj:`bool`, optional, defaults to True): + This task specifies whether or not Lxmert will calculate the question-asnwering loss objective + visual_obj_loss (:obj:`bool`, optional, defaults to True): + This task specifies whether or not Lxmert will calculate the object-prediction loss objective + visual_attr_loss (:obj:`bool`, optional, defaults to True): + This task specifies whether or not Lxmert will calculate the attribute-prediction loss objective + visual_feat_loss (:obj:`bool`, optional, defaults to True): + This task specifies whether or not Lxmert will calculate the feature-regression loss objective + output_attentions (:obj:`bool`, optional, defaults to False): + if True, the vision, langauge, and cross-modality layers will be returned + output_hidden_states (:obj:`bool`, optional, defaults to False): + if True, final cross-modality hidden states for language and vision features will be returned + + """ + + model_type = "lxmert" + + def __init__( + self, + vocab_size=30522, + hidden_size=768, + num_attention_heads=12, + num_labels=2, + num_qa_labels=9500, + num_object_labels=1600, + num_attr_labels=400, + intermediate_size=3072, + hidden_act="gelu", + hidden_dropout_prob=0.1, + attention_probs_dropout_prob=0.1, + max_position_embeddings=512, + type_vocab_size=2, + initializer_range=0.02, + layer_norm_eps=1e-12, + pad_token_id=0, + l_layers=9, + x_layers=5, + r_layers=5, + visual_feat_dim=2048, + visual_pos_dim=4, + visual_loss_normalizer=6.67, + task_matched=True, + task_mask_lm=True, + task_obj_predict=True, + task_qa=True, + visual_obj_loss=True, + visual_attr_loss=True, + visual_feat_loss=True, + output_attentions=False, + output_hidden_states=False, + **kwargs, + ): + super().__init__(**kwargs) + self.vocab_size = vocab_size + self.hidden_size = hidden_size + self.num_attention_heads = num_attention_heads + self.num_labels = num_labels + self.hidden_act = hidden_act + self.intermediate_size = intermediate_size + self.hidden_dropout_prob = hidden_dropout_prob + self.attention_probs_dropout_prob = attention_probs_dropout_prob + self.max_position_embeddings = max_position_embeddings + self.type_vocab_size = type_vocab_size + self.initializer_range = initializer_range + self.layer_norm_eps = layer_norm_eps + self.num_qa_labels = num_qa_labels + self.num_object_labels = num_object_labels + self.num_attr_labels = num_attr_labels + self.l_layers = l_layers + self.x_layers = x_layers + self.r_layers = r_layers + self.visual_feat_dim = visual_feat_dim + self.visual_pos_dim = visual_pos_dim + self.visual_loss_normalizer = visual_loss_normalizer + self.task_matched = task_matched + self.task_mask_lm = task_mask_lm + self.task_obj_predict = task_obj_predict + self.task_qa = task_qa + self.visual_obj_loss = visual_obj_loss + self.visual_attr_loss = visual_attr_loss + self.visual_feat_loss = visual_feat_loss + self.output_hidden_states = output_hidden_states + self.output_attentions = self.output_attentions + self.num_hidden_layers = {"vision": r_layers, "cross_encoder": x_layers, "language": l_layers} diff --git a/src/transformers/convert_lxmert_original_tf_checkpoint_to_pytorch.py b/src/transformers/convert_lxmert_original_tf_checkpoint_to_pytorch.py new file mode 100755 index 0000000000..e4125ed566 --- /dev/null +++ b/src/transformers/convert_lxmert_original_tf_checkpoint_to_pytorch.py @@ -0,0 +1,61 @@ +# coding=utf-8 +# Copyright 2018 The HuggingFace Inc. team. +# +# 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. +"""Convert LXMERT checkpoint.""" + + +import argparse +import logging + +import torch + +from transformers import LxmertConfig, LxmertForPreTraining, load_tf_weights_in_lxmert + + +logging.basicConfig(level=logging.INFO) + + +def convert_tf_checkpoint_to_pytorch(tf_checkpoint_path, config_file, pytorch_dump_path): + # Initialise PyTorch model + config = LxmertConfig.from_json_file(config_file) + print("Building PyTorch model from configuration: {}".format(str(config))) + model = LxmertForPreTraining(config) + + # Load weights from tf checkpoint + load_tf_weights_in_lxmert(model, config, tf_checkpoint_path) + + # Save pytorch-model + print("Save PyTorch model to {}".format(pytorch_dump_path)) + torch.save(model.state_dict(), pytorch_dump_path) + + +if __name__ == "__main__": + parser = argparse.ArgumentParser() + # Required parameters + parser.add_argument( + "--tf_checkpoint_path", default=None, type=str, required=True, help="Path to the TensorFlow checkpoint path." + ) + parser.add_argument( + "--config_file", + default=None, + type=str, + required=True, + help="The config json file corresponding to the pre-trained model. \n" + "This specifies the model architecture.", + ) + parser.add_argument( + "--pytorch_dump_path", default=None, type=str, required=True, help="Path to the output PyTorch model." + ) + args = parser.parse_args() + convert_tf_checkpoint_to_pytorch(args.tf_checkpoint_path, args.config_file, args.pytorch_dump_path) diff --git a/src/transformers/convert_pytorch_checkpoint_to_tf2.py b/src/transformers/convert_pytorch_checkpoint_to_tf2.py index 51b57d005f..cb0ef84848 100755 --- a/src/transformers/convert_pytorch_checkpoint_to_tf2.py +++ b/src/transformers/convert_pytorch_checkpoint_to_tf2.py @@ -27,6 +27,7 @@ from transformers import ( ELECTRA_PRETRAINED_CONFIG_ARCHIVE_MAP, FLAUBERT_PRETRAINED_CONFIG_ARCHIVE_MAP, GPT2_PRETRAINED_CONFIG_ARCHIVE_MAP, + LXMERT_PRETRAINED_CONFIG_ARCHIVE_MAP, OPENAI_GPT_PRETRAINED_CONFIG_ARCHIVE_MAP, ROBERTA_PRETRAINED_CONFIG_ARCHIVE_MAP, T5_PRETRAINED_CONFIG_ARCHIVE_MAP, @@ -43,6 +44,7 @@ from transformers import ( ElectraConfig, FlaubertConfig, GPT2Config, + LxmertConfig, OpenAIGPTConfig, RobertaConfig, T5Config, @@ -57,6 +59,8 @@ from transformers import ( TFElectraForPreTraining, TFFlaubertWithLMHeadModel, TFGPT2LMHeadModel, + TFLxmertForPreTraining, + TFLxmertVisualFeatureEncoder, TFOpenAIGPTLMHeadModel, TFRobertaForMaskedLM, TFRobertaForSequenceClassification, @@ -94,6 +98,8 @@ if is_torch_available(): ElectraForPreTraining, FlaubertWithLMHeadModel, GPT2LMHeadModel, + LxmertForPreTraining, + LxmertVisualFeatureEncoder, OpenAIGPTLMHeadModel, RobertaForMaskedLM, RobertaForSequenceClassification, @@ -204,6 +210,18 @@ MODEL_CLASSES = { DistilBertForQuestionAnswering, DISTILBERT_PRETRAINED_CONFIG_ARCHIVE_MAP, ), + "lxmert": ( + LxmertConfig, + TFLxmertForPreTraining, + LxmertForPreTraining, + LXMERT_PRETRAINED_CONFIG_ARCHIVE_MAP, + ), + "lxmert-visual-feature-encoder": ( + LxmertConfig, + TFLxmertVisualFeatureEncoder, + LxmertVisualFeatureEncoder, + LXMERT_PRETRAINED_CONFIG_ARCHIVE_MAP, + ), "ctrl": ( CTRLConfig, TFCTRLLMHeadModel, diff --git a/src/transformers/modeling_auto.py b/src/transformers/modeling_auto.py index 390c303a96..7f85ce16dd 100644 --- a/src/transformers/modeling_auto.py +++ b/src/transformers/modeling_auto.py @@ -31,6 +31,7 @@ from .configuration_auto import ( FlaubertConfig, GPT2Config, LongformerConfig, + LxmertConfig, MBartConfig, MobileBertConfig, OpenAIGPTConfig, @@ -116,6 +117,7 @@ from .modeling_longformer import ( LongformerForTokenClassification, LongformerModel, ) +from .modeling_lxmert import LxmertForPreTraining, LxmertModel from .modeling_marian import MarianMTModel from .modeling_mbart import MBartForConditionalGeneration from .modeling_mobilebert import ( @@ -200,6 +202,7 @@ MODEL_MAPPING = OrderedDict( (CTRLConfig, CTRLModel), (ElectraConfig, ElectraModel), (ReformerConfig, ReformerModel), + (LxmertConfig, LxmertModel), ] ) @@ -224,6 +227,7 @@ MODEL_FOR_PRETRAINING_MAPPING = OrderedDict( (XLMConfig, XLMWithLMHeadModel), (CTRLConfig, CTRLLMHeadModel), (ElectraConfig, ElectraForPreTraining), + (LxmertConfig, LxmertForPreTraining), ] ) diff --git a/src/transformers/modeling_lxmert.py b/src/transformers/modeling_lxmert.py new file mode 100644 index 0000000000..68c08f7f09 --- /dev/null +++ b/src/transformers/modeling_lxmert.py @@ -0,0 +1,1426 @@ +# coding=utf-8 +# Copyright 2018 Hao Tan, Mohit Bansal, and the HuggingFace team +# +# 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 LXMERT model. """ + + +import logging +import math +import os +from dataclasses import dataclass +from typing import Optional, Tuple + +import torch +from torch import nn +from torch.nn import CrossEntropyLoss, SmoothL1Loss + +from .activations import gelu, swish +from .configuration_lxmert import LxmertConfig +from .file_utils import ( + ModelOutput, + add_code_sample_docstrings, + add_start_docstrings, + add_start_docstrings_to_callable, + replace_return_docstrings, +) +from .modeling_utils import PreTrainedModel + + +logger = logging.getLogger(__name__) + +_CONFIG_FOR_DOC = "LxmertConfig" +_TOKENIZER_FOR_DOC = "LxmertTokenizer" + +LXMERT_PRETRAINED_MODEL_ARCHIVE_LIST = [ + "unc-nlp/lxmert-base-uncased", +] + + +class GeLU(nn.Module): + def __init__(self): + super().__init__() + + def forward(self, x): + return gelu(x) + + +@dataclass +class LxmertModelOutput(ModelOutput): + """ + Lxmert's outputs that contain the last hidden states, pooled outputs, and attention probabilites for + the language, visual, and, cross-modality encoders. + (note: the visual encoder in Lxmert is referred to as the "relation-ship" encoder") + + + Args: + language_output (:obj:`torch.FloatTensor` of shape :obj:`(batch_size, sequence_length, hidden_size)`): + Sequence of hidden-states at the output of the last layer of the language encoder. + vision_output (:obj:`torch.FloatTensor` of shape :obj:`(batch_size, sequence_length, hidden_size)`): + Sequence of hidden-states at the output of the last layer of the visual encoder. + pooled_output (:obj:`torch.FloatTensor` of shape :obj:`(batch_size, hidden_size)`): + Last layer hidden-state of the first token of the sequence (classification, CLS, token) + further processed by a Linear layer and a Tanh activation function. The Linear + language_hidden_states (:obj:`tuple(torch.FloatTensor)`, `optional`, returned when ``output_hidden_states=True`` is passed or when ``config.output_hidden_states=True``): + Tuple of :obj:`torch.FloatTensor` (one for input features + one for the output of each cross-modality layer) + of shape :obj:`(batch_size, sequence_length, hidden_size)`. + vision_hidden_states (:obj:`tuple(torch.FloatTensor)`, `optional`, returned when ``output_hidden_states=True`` is passed or when ``config.output_hidden_states=True``): + Tuple of :obj:`torch.FloatTensor` (one for input features + one for the output of each cross-modality layer) + of shape :obj:`(batch_size, sequence_length, hidden_size)`. + language_attentions (:obj:`tuple(torch.FloatTensor)`, `optional`, returned when ``output_attentions=True`` is passed or when ``config.output_attentions=True``): + Tuple of :obj:`torch.FloatTensor` (one for each layer) of shape + :obj:`(batch_size, num_heads, sequence_length, sequence_length)`. + Attentions weights after the attention softmax, used to compute the weighted average in the self-attention + heads. + vision_attentions (:obj:`tuple(torch.FloatTensor)`, `optional`, returned when ``output_attentions=True`` is passed or when ``config.output_attentions=True``): + Tuple of :obj:`torch.FloatTensor` (one for each layer) of shape + :obj:`(batch_size, num_heads, sequence_length, sequence_length)`. + Attentions weights after the attention softmax, used to compute the weighted average in the self-attention + heads. + cross_encoder_attentions (:obj:`tuple(torch.FloatTensor)`, `optional`, returned when ``output_attentions=True`` is passed or when ``config.output_attentions=True``): + Tuple of :obj:`torch.FloatTensor` (one for each layer) of shape + :obj:`(batch_size, num_heads, sequence_length, sequence_length)`. + Attentions weights after the attention softmax, used to compute the weighted average in the self-attention + heads. + """ + + language_output: Optional[torch.FloatTensor] = None + vision_output: Optional[torch.FloatTensor] = None + pooled_output: Optional[torch.FloatTensor] = None + language_hidden_states: Optional[Tuple[torch.FloatTensor]] = None + vision_hidden_states: Optional[Tuple[torch.FloatTensor]] = None + language_attentions: Optional[Tuple[torch.FloatTensor]] = None + vision_attentions: Optional[Tuple[torch.FloatTensor]] = None + cross_encoder_attentions: Optional[Tuple[torch.FloatTensor]] = None + + +@dataclass +class LxmertForQuestionAnsweringOutput(ModelOutput): + """ + Output type of :class:`~transformers.LxmertForQuestionAnswering`. + + Args: + loss (`optional`, returned when ``labels`` is provided, ``torch.FloatTensor`` of shape :obj:`(1,)`): + Total loss as the sum of the masked language modeling loss and the next sequence prediction (classification) loss.k. + question_answering_score: (:obj:`torch.FloatTensor` of shape :obj:`(batch_size, n_qa_answers)`, `optional`): + Prediction scores of question answering objective (classification). + language_hidden_states (:obj:`tuple(torch.FloatTensor)`, `optional`, returned when ``output_hidden_states=True`` is passed or when ``config.output_hidden_states=True``): + Tuple of :obj:`torch.FloatTensor` (one for input features + one for the output of each cross-modality layer) + of shape :obj:`(batch_size, sequence_length, hidden_size)`. + vision_hidden_states (:obj:`tuple(torch.FloatTensor)`, `optional`, returned when ``output_hidden_states=True`` is passed or when ``config.output_hidden_states=True``): + Tuple of :obj:`torch.FloatTensor` (one for input features + one for the output of each cross-modality layer) + of shape :obj:`(batch_size, sequence_length, hidden_size)`. + language_attentions (:obj:`tuple(torch.FloatTensor)`, `optional`, returned when ``output_attentions=True`` is passed or when ``config.output_attentions=True``): + Tuple of :obj:`torch.FloatTensor` (one for each layer) of shape + :obj:`(batch_size, num_heads, sequence_length, sequence_length)`. + Attentions weights after the attention softmax, used to compute the weighted average in the self-attention + heads. + vision_attentions (:obj:`tuple(torch.FloatTensor)`, `optional`, returned when ``output_attentions=True`` is passed or when ``config.output_attentions=True``): + Tuple of :obj:`torch.FloatTensor` (one for each layer) of shape + :obj:`(batch_size, num_heads, sequence_length, sequence_length)`. + Attentions weights after the attention softmax, used to compute the weighted average in the self-attention + heads. + cross_encoder_attentions (:obj:`tuple(torch.FloatTensor)`, `optional`, returned when ``output_attentions=True`` is passed or when ``config.output_attentions=True``): + Tuple of :obj:`torch.FloatTensor` (one for each layer) of shape + :obj:`(batch_size, num_heads, sequence_length, sequence_length)`. + Attentions weights after the attention softmax, used to compute the weighted average in the self-attention + heads. + """ + + loss: Optional[torch.FloatTensor] = None + question_answering_score: Optional[torch.FloatTensor] = None + language_hidden_states: Optional[Tuple[torch.FloatTensor]] = None + vision_hidden_states: Optional[Tuple[torch.FloatTensor]] = None + language_attentions: Optional[Tuple[torch.FloatTensor]] = None + vision_attentions: Optional[Tuple[torch.FloatTensor]] = None + cross_encoder_attentions: Optional[Tuple[torch.FloatTensor]] = None + + +@dataclass +class LxmertForPreTrainingOutput(ModelOutput): + """ + Output type of :class:`~transformers.LxmertForPreTrainingModel`. + + Args: + loss (`optional`, returned when ``labels`` is provided, ``torch.FloatTensor`` of shape :obj:`(1,)`): + Total loss as the sum of the masked language modeling loss and the next sequence prediction (classification) loss. + prediction_logits (:obj:`torch.FloatTensor` of shape :obj:`(batch_size, sequence_length, config.vocab_size)`): + Prediction scores of the language modeling head (scores for each vocabulary token before SoftMax). + cross_relationship_score: (:obj:`torch.FloatTensor` of shape :obj:`(batch_size, 2)`): + Prediction scores of the textual matching objective (classification) head (scores of True/False + continuation before SoftMax). + question_answering_score: (:obj:`torch.FloatTensor` of shape :obj:`(batch_size, n_qa_answers)`): + Prediction scores of question answering objective (classification). + language_hidden_states (:obj:`tuple(torch.FloatTensor)`, `optional`, returned when ``output_hidden_states=True`` is passed or when ``config.output_hidden_states=True``): + Tuple of :obj:`torch.FloatTensor` (one for input features + one for the output of each cross-modality layer) + of shape :obj:`(batch_size, sequence_length, hidden_size)`. + vision_hidden_states (:obj:`tuple(torch.FloatTensor)`, `optional`, returned when ``output_hidden_states=True`` is passed or when ``config.output_hidden_states=True``): + Tuple of :obj:`torch.FloatTensor` (one for input features + one for the output of each cross-modality layer) + of shape :obj:`(batch_size, sequence_length, hidden_size)`. + language_attentions (:obj:`tuple(torch.FloatTensor)`, `optional`, returned when ``output_attentions=True`` is passed or when ``config.output_attentions=True``): + Tuple of :obj:`torch.FloatTensor` (one for each layer) of shape + :obj:`(batch_size, num_heads, sequence_length, sequence_length)`. + Attentions weights after the attention softmax, used to compute the weighted average in the self-attention + heads. + vision_attentions (:obj:`tuple(torch.FloatTensor)`, `optional`, returned when ``output_attentions=True`` is passed or when ``config.output_attentions=True``): + Tuple of :obj:`torch.FloatTensor` (one for each layer) of shape + :obj:`(batch_size, num_heads, sequence_length, sequence_length)`. + Attentions weights after the attention softmax, used to compute the weighted average in the self-attention + heads. + cross_encoder_attentions (:obj:`tuple(torch.FloatTensor)`, `optional`, returned when ``output_attentions=True`` is passed or when ``config.output_attentions=True``): + Tuple of :obj:`torch.FloatTensor` (one for each layer) of shape + :obj:`(batch_size, num_heads, sequence_length, sequence_length)`. + Attentions weights after the attention softmax, used to compute the weighted average in the self-attention + heads. + + """ + + loss: [torch.FloatTensor] = None + prediction_logits: Optional[torch.FloatTensor] = None + cross_relationship_score: Optional[torch.FloatTensor] = None + question_answering_score: Optional[torch.FloatTensor] = None + language_hidden_states: Optional[Tuple[torch.FloatTensor]] = None + vision_hidden_states: Optional[Tuple[torch.FloatTensor]] = None + language_attentions: Optional[Tuple[torch.FloatTensor]] = None + vision_attentions: Optional[Tuple[torch.FloatTensor]] = None + cross_encoder_attentions: Optional[Tuple[torch.FloatTensor]] = None + + +def load_tf_weights_in_lxmert(model, config, tf_checkpoint_path): + """Load tf checkpoints in a pytorch model.""" + try: + import re + + import numpy as np + import tensorflow as tf + except ImportError: + logger.error( + "Loading a TensorFlow model in PyTorch, requires TensorFlow to be installed. Please see " + "https://www.tensorflow.org/install/ for installation instructions." + ) + raise + tf_path = os.path.abspath(tf_checkpoint_path) + logger.info("Converting TensorFlow checkpoint from {}".format(tf_path)) + # Load weights from TF model + init_vars = tf.train.list_variables(tf_path) + names = [] + arrays = [] + for name, shape in init_vars: + logger.info("Loading TF weight {} with shape {}".format(name, shape)) + array = tf.train.load_variable(tf_path, name) + names.append(name) + arrays.append(array) + + for name, array in zip(names, arrays): + name = name.split("/") + # adam_v and adam_m are variables used in AdamWeightDecayOptimizer to calculated m and v + # which are not required for using pretrained model + if any( + n + in [ + "adam_v", + "adam_m", + "AdamWeightDecayOptimizer", + "AdamWeightDecayOptimizer_1", + "global_step", + ] + for n in name + ): + logger.info("Skipping {}".format("/".join(name))) + continue + pointer = model + for m_name in name: + if re.fullmatch(r"[A-Za-z]+_\d+", m_name): + scope_names = re.split(r"_(\d+)", m_name) + else: + scope_names = [m_name] + if scope_names[0] == "kernel" or scope_names[0] == "gamma": + pointer = getattr(pointer, "weight") + elif scope_names[0] == "output_bias" or scope_names[0] == "beta": + pointer = getattr(pointer, "bias") + elif scope_names[0] == "output_weights": + pointer = getattr(pointer, "weight") + elif scope_names[0] == "squad": + pointer = getattr(pointer, "classifier") + else: + try: + pointer = getattr(pointer, scope_names[0]) + except AttributeError: + logger.info("Skipping {}".format("/".join(name))) + continue + if len(scope_names) >= 2: + num = int(scope_names[1]) + pointer = pointer[num] + if m_name[-11:] == "_embeddings": + pointer = getattr(pointer, "weight") + elif m_name == "kernel": + array = np.transpose(array) + try: + assert pointer.shape == array.shape + except AssertionError as e: + e.args += (pointer.shape, array.shape) + raise + logger.info("Initialize PyTorch weight {}".format(name)) + pointer.data = torch.from_numpy(array) + return model + + +ACT2FN = {"gelu": gelu, "relu": torch.nn.functional.relu, "swish": swish} + +LxmertLayerNorm = torch.nn.LayerNorm + + +class LxmertEmbeddings(nn.Module): + """Construct the embeddings from word, position and token_type embeddings.""" + + def __init__(self, config): + super().__init__() + self.word_embeddings = nn.Embedding(config.vocab_size, config.hidden_size, padding_idx=0) + self.position_embeddings = nn.Embedding(config.max_position_embeddings, config.hidden_size, padding_idx=0) + self.token_type_embeddings = nn.Embedding(config.type_vocab_size, config.hidden_size, padding_idx=0) + + # self.LayerNorm is not snake-cased to stick with TensorFlow model variable name and be able to load + # any TensorFlow checkpoint file + self.LayerNorm = LxmertLayerNorm(config.hidden_size, eps=1e-12) + self.dropout = nn.Dropout(config.hidden_dropout_prob) + + def forward(self, input_ids, token_type_ids=None, inputs_embeds=None): + if input_ids is not None: + input_shape = input_ids.size() + device = input_ids.device + else: + input_shape = inputs_embeds.size()[:-1] + device = inputs_embeds.device + seq_length = input_shape[1] + + position_ids = torch.arange(seq_length, dtype=torch.long, device=device) + position_ids = position_ids.unsqueeze(0).expand(input_shape) + + 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) + position_embeddings = self.position_embeddings(position_ids) + token_type_embeddings = self.token_type_embeddings(token_type_ids) + + embeddings = inputs_embeds + position_embeddings + token_type_embeddings + embeddings = self.LayerNorm(embeddings) + embeddings = self.dropout(embeddings) + return embeddings + + +class LxmertAttention(nn.Module): + def __init__(self, config, ctx_dim=None): + super().__init__() + if config.hidden_size % config.num_attention_heads != 0: + raise ValueError( + "The hidden size (%d) is not a multiple of the number of attention " + "heads (%d)" % (config.hidden_size, 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.head_size = self.num_attention_heads * self.attention_head_size + + # visual_dim = 2048 + if ctx_dim is None: + ctx_dim = config.hidden_size + self.query = nn.Linear(config.hidden_size, self.head_size) + self.key = nn.Linear(ctx_dim, self.head_size) + self.value = nn.Linear(ctx_dim, self.head_size) + + self.dropout = nn.Dropout(config.attention_probs_dropout_prob) + + def transpose_for_scores(self, x): + new_x_shape = x.size()[:-1] + ( + self.num_attention_heads, + self.attention_head_size, + ) + x = x.view(*new_x_shape) + return x.permute(0, 2, 1, 3) + + def forward(self, hidden_states, context, attention_mask=None, output_attentions=False): + mixed_query_layer = self.query(hidden_states) + mixed_key_layer = self.key(context) + mixed_value_layer = self.value(context) + + query_layer = self.transpose_for_scores(mixed_query_layer) + key_layer = self.transpose_for_scores(mixed_key_layer) + value_layer = self.transpose_for_scores(mixed_value_layer) + + # Take the dot product between "query" and "key" to get the raw attention scores. + attention_scores = torch.matmul(query_layer, key_layer.transpose(-1, -2)) + attention_scores = attention_scores / math.sqrt(self.attention_head_size) + # Apply the attention mask is (precomputed for all layers in BertModel forward() function) + if attention_mask is not None: + 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.head_size,) + context_layer = context_layer.view(*new_context_layer_shape) + + outputs = (context_layer, attention_probs) if output_attentions else (context_layer,) + return outputs + + +class LxmertAttentionOutput(nn.Module): + def __init__(self, config): + super().__init__() + self.dense = nn.Linear(config.hidden_size, config.hidden_size) + self.LayerNorm = LxmertLayerNorm(config.hidden_size, eps=1e-12) + self.dropout = nn.Dropout(config.hidden_dropout_prob) + + def forward(self, hidden_states, input_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 LxmertCrossAttentionLayer(nn.Module): + def __init__(self, config): + super().__init__() + self.att = LxmertAttention(config) + self.output = LxmertAttentionOutput(config) + + def forward(self, input_tensor, ctx_tensor, ctx_att_mask=None, output_attentions=False): + output = self.att(input_tensor, ctx_tensor, ctx_att_mask, output_attentions=output_attentions) + if output_attentions: + attention_probs = output[1] + attention_output = self.output(output[0], input_tensor) + outputs = (attention_output, attention_probs) if output_attentions else (attention_output,) + return outputs + + +class LxmertSelfAttentionLayer(nn.Module): + def __init__(self, config): + super().__init__() + self.self = LxmertAttention(config) + self.output = LxmertAttentionOutput(config) + + def forward(self, input_tensor, attention_mask, output_attentions=False): + # Self attention attends to itself, thus keys and querys are the same (input_tensor). + output = self.self( + input_tensor, + input_tensor, + attention_mask, + output_attentions=output_attentions, + ) + if output_attentions: + attention_probs = output[1] + attention_output = self.output(output[0], input_tensor) + outputs = (attention_output, attention_probs) if output_attentions else (attention_output,) + return outputs + + +class LxmertIntermediate(nn.Module): + def __init__(self, config): + super().__init__() + self.dense = nn.Linear(config.hidden_size, config.intermediate_size) + self.intermediate_act_fn = ACT2FN[config.hidden_act] + + def forward(self, hidden_states): + hidden_states = self.dense(hidden_states) + hidden_states = self.intermediate_act_fn(hidden_states) + return hidden_states + + +class LxmertOutput(nn.Module): + def __init__(self, config): + super().__init__() + self.dense = nn.Linear(config.intermediate_size, config.hidden_size) + self.LayerNorm = LxmertLayerNorm(config.hidden_size, eps=1e-12) + self.dropout = nn.Dropout(config.hidden_dropout_prob) + + def forward(self, hidden_states, input_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 LxmertLayer(nn.Module): + def __init__(self, config): + super().__init__() + self.attention = LxmertSelfAttentionLayer(config) + self.intermediate = LxmertIntermediate(config) + self.output = LxmertOutput(config) + + def forward(self, hidden_states, attention_mask=None, output_attentions=False): + outputs = self.attention(hidden_states, attention_mask, output_attentions=output_attentions) + attention_output = outputs[0] + intermediate_output = self.intermediate(attention_output) + layer_output = self.output(intermediate_output, attention_output) + outputs = (layer_output,) + outputs[1:] # add attentions if we output them + return outputs + + +class LxmertXLayer(nn.Module): + def __init__(self, config): + super().__init__() + # The cross-attention Layer + self.visual_attention = LxmertCrossAttentionLayer(config) + + # Self-attention Layers + self.lang_self_att = LxmertSelfAttentionLayer(config) + self.visn_self_att = LxmertSelfAttentionLayer(config) + + # Intermediate and Output Layers (FFNs) + self.lang_inter = LxmertIntermediate(config) + self.lang_output = LxmertOutput(config) + self.visn_inter = LxmertIntermediate(config) + self.visn_output = LxmertOutput(config) + + def cross_att( + self, + lang_input, + lang_attention_mask, + visual_input, + visual_attention_mask, + output_x_attentions=False, + ): + # Cross Attention + lang_att_output = self.visual_attention( + lang_input, + visual_input, + ctx_att_mask=visual_attention_mask, + output_attentions=output_x_attentions, + ) + visual_att_output = self.visual_attention( + visual_input, + lang_input, + ctx_att_mask=lang_attention_mask, + output_attentions=False, + ) + return lang_att_output, visual_att_output + + def self_att(self, lang_input, lang_attention_mask, visual_input, visual_attention_mask): + # Self Attention + lang_att_output = self.lang_self_att(lang_input, lang_attention_mask, output_attentions=False) + visual_att_output = self.visn_self_att(visual_input, visual_attention_mask, output_attentions=False) + return lang_att_output[0], visual_att_output[0] + + def output_fc(self, lang_input, visual_input): + # FC layers + lang_inter_output = self.lang_inter(lang_input) + visual_inter_output = self.visn_inter(visual_input) + + # Layer output + lang_output = self.lang_output(lang_inter_output, lang_input) + visual_output = self.visn_output(visual_inter_output, visual_input) + + return lang_output, visual_output + + def forward( + self, + lang_feats, + lang_attention_mask, + visual_feats, + visual_attention_mask, + output_attentions=False, + ): + + lang_att_output, visual_att_output = self.cross_att( + lang_input=lang_feats, + lang_attention_mask=lang_attention_mask, + visual_input=visual_feats, + visual_attention_mask=visual_attention_mask, + output_x_attentions=output_attentions, + ) + attention_probs = lang_att_output[1:] + lang_att_output, visual_att_output = self.self_att( + lang_att_output[0], + lang_attention_mask, + visual_att_output[0], + visual_attention_mask, + ) + + lang_output, visual_output = self.output_fc(lang_att_output, visual_att_output) + return ( + ( + lang_output, + visual_output, + attention_probs[0], + ) + if output_attentions + else (lang_output, visual_output) + ) + + +class LxmertVisualFeatureEncoder(nn.Module): + def __init__(self, config): + super().__init__() + feat_dim = config.visual_feat_dim + pos_dim = config.visual_pos_dim + + # Object feature encoding + self.visn_fc = nn.Linear(feat_dim, config.hidden_size) + self.visn_layer_norm = LxmertLayerNorm(config.hidden_size, eps=1e-12) + + # Box position encoding + self.box_fc = nn.Linear(pos_dim, config.hidden_size) + self.box_layer_norm = LxmertLayerNorm(config.hidden_size, eps=1e-12) + + self.dropout = nn.Dropout(config.hidden_dropout_prob) + + def forward(self, visual_feats, visual_pos): + x = self.visn_fc(visual_feats) + x = self.visn_layer_norm(x) + y = self.box_fc(visual_pos) + y = self.box_layer_norm(y) + output = (x + y) / 2 + + output = self.dropout(output) + return output + + +class LxmertEncoder(nn.Module): + def __init__(self, config): + super().__init__() + + # Obj-level image embedding layer + self.visn_fc = LxmertVisualFeatureEncoder(config) + self.config = config + + # Number of layers + self.num_l_layers = config.l_layers + self.num_x_layers = config.x_layers + self.num_r_layers = config.r_layers + + # Layers + # Using self.layer instead of self.l_layer to support loading BERT weights. + self.layer = nn.ModuleList([LxmertLayer(config) for _ in range(self.num_l_layers)]) + self.x_layers = nn.ModuleList([LxmertXLayer(config) for _ in range(self.num_x_layers)]) + self.r_layers = nn.ModuleList([LxmertLayer(config) for _ in range(self.num_r_layers)]) + + def forward( + self, + lang_feats, + lang_attention_mask, + visual_feats, + visual_pos, + visual_attention_mask=None, + output_attentions=None, + ): + + vision_hidden_states = () + language_hidden_states = () + vision_attentions = () if output_attentions or self.config.output_attentions else None + language_attentions = () if output_attentions or self.config.output_attentions else None + cross_encoder_attentions = () if output_attentions or self.config.output_attentions else None + + visual_feats = self.visn_fc(visual_feats, visual_pos) + + # Run language layers + for layer_module in self.layer: + l_outputs = layer_module(lang_feats, lang_attention_mask, output_attentions=output_attentions) + lang_feats = l_outputs[0] + language_hidden_states = language_hidden_states + (lang_feats,) + if language_attentions is not None: + language_attentions = language_attentions + (l_outputs[1],) + + # Run relational layers + for layer_module in self.r_layers: + v_outputs = layer_module(visual_feats, visual_attention_mask, output_attentions=output_attentions) + visual_feats = v_outputs[0] + vision_hidden_states = vision_hidden_states + (visual_feats,) + if vision_attentions is not None: + vision_attentions = vision_attentions + (v_outputs[1],) + + # Run cross-modality layers + for layer_module in self.x_layers: + x_outputs = layer_module( + lang_feats, + lang_attention_mask, + visual_feats, + visual_attention_mask, + output_attentions=output_attentions, + ) + lang_feats, visual_feats = x_outputs[:2] + vision_hidden_states = vision_hidden_states + (visual_feats,) + language_hidden_states = language_hidden_states + (lang_feats,) + if cross_encoder_attentions is not None: + cross_encoder_attentions = cross_encoder_attentions + (x_outputs[2],) + visual_encoder_outputs = ( + vision_hidden_states, + vision_attentions if output_attentions else None, + ) + lang_encoder_outputs = ( + language_hidden_states, + language_attentions if output_attentions else None, + ) + return ( + visual_encoder_outputs, + lang_encoder_outputs, + cross_encoder_attentions if output_attentions else None, + ) + + +class LxmertPooler(nn.Module): + def __init__(self, config): + super(LxmertPooler, self).__init__() + self.dense = nn.Linear(config.hidden_size, config.hidden_size) + self.activation = nn.Tanh() + + def forward(self, hidden_states): + # 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 + + +class LxmertPredictionHeadTransform(nn.Module): + def __init__(self, config): + super(LxmertPredictionHeadTransform, self).__init__() + self.dense = nn.Linear(config.hidden_size, config.hidden_size) + self.transform_act_fn = ACT2FN[config.hidden_act] + self.LayerNorm = LxmertLayerNorm(config.hidden_size, eps=1e-12) + + def forward(self, hidden_states): + hidden_states = self.dense(hidden_states) + hidden_states = self.transform_act_fn(hidden_states) + hidden_states = self.LayerNorm(hidden_states) + return hidden_states + + +class LxmertLMPredictionHead(nn.Module): + def __init__(self, config, lxmert_model_embedding_weights): + super(LxmertLMPredictionHead, self).__init__() + self.transform = LxmertPredictionHeadTransform(config) + + # The output weights are the same as the input embeddings, but there is + # an output-only bias for each token. + self.decoder = nn.Linear( + lxmert_model_embedding_weights.size(1), + lxmert_model_embedding_weights.size(0), + bias=False, + ) + self.decoder.weight = lxmert_model_embedding_weights + self.bias = nn.Parameter(torch.zeros(lxmert_model_embedding_weights.size(0))) + + def forward(self, hidden_states): + hidden_states = self.transform(hidden_states) + hidden_states = self.decoder(hidden_states) + self.bias + return hidden_states + + +class LxmertVisualAnswerHead(nn.Module): + def __init__(self, config, num_labels): + super().__init__() + hid_dim = config.hidden_size + self.logit_fc = nn.Sequential( + nn.Linear(hid_dim, hid_dim * 2), + GeLU(), + LxmertLayerNorm(hid_dim * 2, eps=1e-12), + nn.Linear(hid_dim * 2, num_labels), + ) + + def forward(self, hidden_states): + return self.logit_fc(hidden_states) + + +class LxmertVisualObjHead(nn.Module): + def __init__(self, config): + super().__init__() + self.transform = LxmertPredictionHeadTransform(config) + # Decide the use of visual losses + visual_losses = {} + if config.visual_obj_loss: + visual_losses["obj"] = {"shape": (-1,), "num": config.num_object_labels} + if config.visual_attr_loss: + visual_losses["attr"] = {"shape": (-1,), "num": config.num_attr_labels} + if config.visual_obj_loss: + visual_losses["feat"] = { + "shape": (-1, config.visual_feat_dim), + "num": config.visual_feat_dim, + } + self.visual_losses = visual_losses + + # The output weights are the same as the input embeddings, but there is + # an output-only bias for each token. + self.decoder_dict = nn.ModuleDict( + {key: nn.Linear(config.hidden_size, self.visual_losses[key]["num"]) for key in self.visual_losses} + ) + + def forward(self, hidden_states): + hidden_states = self.transform(hidden_states) + output = {} + for key in self.visual_losses: + output[key] = self.decoder_dict[key](hidden_states) + return output + + +class LxmertPreTrainingHeads(nn.Module): + def __init__(self, config, lxmert_model_embedding_weights): + super(LxmertPreTrainingHeads, self).__init__() + self.predictions = LxmertLMPredictionHead(config, lxmert_model_embedding_weights) + self.seq_relationship = nn.Linear(config.hidden_size, 2) + + def forward(self, sequence_output, pooled_output): + prediction_scores = self.predictions(sequence_output) + seq_relationship_score = self.seq_relationship(pooled_output) + return prediction_scores, seq_relationship_score + + +class LxmertPreTrainedModel(PreTrainedModel): + """An abstract class to handle weights initialization and + a simple interface for downloading and loading pretrained models. + """ + + config_class = LxmertConfig + load_tf_weights = load_tf_weights_in_lxmert + base_model_prefix = "lxmert" + + def _init_weights(self, module): + """ Initialize the weights """ + if isinstance(module, (nn.Linear, nn.Embedding)): + # Slightly different from the TF version which uses truncated_normal for initialization + # cf https://github.com/pytorch/pytorch/pull/5617 + module.weight.data.normal_(mean=0.0, std=self.config.initializer_range) + elif isinstance(module, LxmertLayerNorm): + module.bias.data.zero_() + module.weight.data.fill_(1.0) + if isinstance(module, nn.Linear) and module.bias is not None: + module.bias.data.zero_() + + +LXMERT_START_DOCSTRING = r""" + The LXMERT model was proposed in `LXMERT: Learning Cross-Modality Encoder Representations from Transformers `__ + by Hao Tan and Mohit Bansal. It's a vision and language transformer model, + pre-trained on a variety of multi-modal datasets comprising of GQA, VQAv2.0, MCSCOCO captions, and Visual genome, + using a combination of masked language modeling, region of interest feature regression, + cross entropy loss for question answering attribute prediction, and object tag predicition. + + This model is a PyTorch `torch.nn.Module `_ sub-class. + Use it as a regular PyTorch Module and refer to the PyTorch documentation for all matter related to general + usage and behavior. + + Parameters: + config (:class:`~transformers.LxmertConfig`): Model configuration class with all the parameters of the model. + Initializing with a config file does not load the weights associated with the model, only the configuration. + Check out the :meth:`~transformers.PreTrainedModel.from_pretrained` method to load the model weights. +""" + +LXMERT_INPUTS_DOCSTRING = r""" + + Args: + input_ids (:obj:`torch.LongTensor` of shape :obj:`{0}`): + Indices of input sequence tokens in the vocabulary. + + Indices can be obtained using :class:`transformers.LxmertTokenizer`. + See :func:`transformers.PreTrainedTokenizer.encode` and + :func:`transformers.PreTrainedTokenizer.__call__` for details. + + `What are input IDs? <../glossary.html#input-ids>`__ + visual_feats: (:obj:`torch.FloatTensor` of shape :obj:՝(batch_size, num_visual_features, visual_feat_dim)՝): + This input represents visual features. They ROI pooled object features from bounding boxes using a faster-RCNN model) + These are currently not provided by the transformers library + visual_pos: (:obj:`torch.FloatTensor` of shape :obj:՝(batch_size, num_visual_features, visual_pos_dim)՝): + This input represents spacial features corresponding to their relative (via index) visual features. + The pre-trained lxmert model expects these spacial features to be normalized bounding boxes on a scale of 0~1. + These are currently not provided by the transformers library + attention_mask (:obj:`torch.FloatTensor` of shape :obj:`{0}`, `optional`, defaults to :obj:`None`): + Mask to avoid performing attention on padding token indices. + Mask values selected in ``[0, 1]``: + ``1`` for tokens that are NOT MASKED, ``0`` for MASKED tokens. + + `What are attention masks? <../glossary.html#attention-mask>`__ + visual_attention_mask (:obj:`torch.FloatTensor` of shape :obj:`{0}`, `optional`, defaults to :obj:`None`): + Mask to avoid performing attention on padding token indices. + Mask values selected in ``[0, 1]``: + ``1`` for tokens that are NOT MASKED, ``0`` for MASKED tokens. + + `What are attention masks? <../glossary.html#attention-mask>`__ + token_type_ids (:obj:`torch.LongTensor` of shape :obj:`{0}`, `optional`, defaults to :obj:`None`): + Segment token indices to indicate first and second portions of the inputs. + Indices are selected in ``[0, 1]``: ``0`` corresponds to a `sentence A` token, ``1`` + corresponds to a `sentence B` token + + `What are token type IDs? <../glossary.html#token-type-ids>`_ + inputs_embeds (:obj:`torch.FloatTensor` of shape :obj:`(batch_size, sequence_length, hidden_size)`, `optional`, defaults to :obj:`None`): + Optionally, instead of passing :obj:`input_ids` you can choose to directly pass an embedded representation. + 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. + output_attentions: (:obj:`bool`, `optional`, defaults to :obj:`None`): + If set to ``True``, the attentions tensors of all attention layers for the visual, language, and cross-modality encoder are returned. + output_hidden_states (:obj:`bool`, `optional`, defaults to :obj:`None`): + If set to ``True``, the hidden states for each respective modality will be returned when used as the input vector in the cross-modality encoder. + return_dict (:obj:`bool`, `optional`, defaults to :obj:`None`): + If set to ``True``, the model will return a :class:`~transformers.file_utils.LxmertModelOutput` instead of a + plain tuple. +""" + + +@add_start_docstrings( + "The bare Lxmert Model transformer outputting raw hidden-states without any specific head on top.", + LXMERT_START_DOCSTRING, +) +class LxmertModel(LxmertPreTrainedModel): + def __init__(self, config): + super().__init__(config) + self.embeddings = LxmertEmbeddings(config) + self.encoder = LxmertEncoder(config) + self.pooler = LxmertPooler(config) + self.init_weights() + + def get_input_embeddings(self): + return self.embeddings.word_embeddings + + def set_input_embeddings(self, new_embeddings): + self.embeddings.word_embeddings = new_embeddings + + @add_start_docstrings_to_callable(LXMERT_INPUTS_DOCSTRING.format("(batch_size, sequence_length)")) + @add_code_sample_docstrings( + tokenizer_class=_TOKENIZER_FOR_DOC, + checkpoint="unc-nlp/lxmert-base-uncased", + output_type=LxmertModelOutput, + config_class=_CONFIG_FOR_DOC, + ) + def forward( + self, + input_ids=None, + visual_feats=None, + visual_pos=None, + attention_mask=None, + visual_attention_mask=None, + token_type_ids=None, + inputs_embeds=None, + output_attentions=None, + output_hidden_states=None, + return_dict=None, + ): + + 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.use_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: + 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") + + assert visual_feats is not None, "`visual_feats` cannot be `None`" + assert visual_pos is not None, "`visual_pos` cannot be `None`" + + device = input_ids.device if input_ids is not None else inputs_embeds.device + + if attention_mask is None: + attention_mask = torch.ones(input_shape, device=device) + if token_type_ids is None: + token_type_ids = torch.zeros(input_shape, dtype=torch.long, device=device) + + # We create a 3D attention mask from a 2D tensor mask. + # Sizes are [batch_size, 1, 1, to_seq_length] + # So we can broadcast to [batch_size, num_heads, from_seq_length, to_seq_length] + # this attention mask is more simple than the triangular masking of causal attention + # used in OpenAI GPT, we just need to prepare the broadcast dimension here. + extended_attention_mask = attention_mask.unsqueeze(1).unsqueeze(2) + + # Since attention_mask is 1.0 for positions we want to attend and 0.0 for + # masked positions, this operation will create a tensor which is 0.0 for + # positions we want to attend and -10000.0 for masked positions. + # Since we are adding it to the raw scores before the softmax, this is + # effectively the same as removing these entirely. + extended_attention_mask = extended_attention_mask.to(dtype=next(self.parameters()).dtype) + extended_attention_mask = (1.0 - extended_attention_mask) * -10000.0 + + # Process the visual attention mask + if visual_attention_mask is not None: + extended_visual_attention_mask = visual_attention_mask.unsqueeze(1).unsqueeze(2) + extended_visual_attention_mask = extended_visual_attention_mask.to(dtype=next(self.parameters()).dtype) + extended_visual_attention_mask = (1.0 - extended_visual_attention_mask) * -10000.0 + else: + extended_visual_attention_mask = None + + # Positional Word Embeddings + embedding_output = self.embeddings(input_ids, token_type_ids, inputs_embeds) + + # Run Lxmert encoder + encoder_outputs = self.encoder( + embedding_output, + extended_attention_mask, + visual_feats=visual_feats, + visual_pos=visual_pos, + visual_attention_mask=extended_visual_attention_mask, + output_attentions=output_attentions, + ) + + visual_encoder_outputs, lang_encoder_outputs = encoder_outputs[:2] + vision_hidden_states = visual_encoder_outputs[0] + language_hidden_states = lang_encoder_outputs[0] + + all_attentions = () + if output_attentions: + language_attentions = lang_encoder_outputs[1] + vision_attentions = visual_encoder_outputs[1] + cross_encoder_attentions = encoder_outputs[2] + all_attentions = ( + language_attentions, + vision_attentions, + cross_encoder_attentions, + ) + + hidden_states = (language_hidden_states, vision_hidden_states) if output_hidden_states else () + + visual_output = vision_hidden_states[-1] + lang_output = language_hidden_states[-1] + pooled_output = self.pooler(lang_output) + + if not return_dict: + return (lang_output, visual_output, pooled_output) + hidden_states + all_attentions + + return LxmertModelOutput( + pooled_output=pooled_output, + language_output=lang_output, + vision_output=visual_output, + language_hidden_states=language_hidden_states if output_hidden_states else None, + vision_hidden_states=vision_hidden_states if output_hidden_states else None, + language_attentions=language_attentions if output_attentions else None, + vision_attentions=vision_attentions if output_attentions else None, + cross_encoder_attentions=cross_encoder_attentions if output_attentions else None, + ) + + +@add_start_docstrings( + """Lxmert Model with a specified pre-training head on top. """, + LXMERT_START_DOCSTRING, +) +class LxmertForPreTraining(LxmertPreTrainedModel): + def __init__(self, config): + super().__init__(config) + # Configuration + self.config = config + self.num_qa_labels = config.num_qa_labels + self.visual_loss_normalizer = config.visual_loss_normalizer + + # Use of pre-training tasks + self.task_mask_lm = config.task_mask_lm + self.task_obj_predict = config.task_obj_predict + self.task_matched = config.task_matched + self.task_qa = config.task_qa + + # Lxmert backbone + self.lxmert = LxmertModel(config) + + # Pre-training heads + self.cls = LxmertPreTrainingHeads(config, self.lxmert.embeddings.word_embeddings.weight) + if self.task_obj_predict: + self.obj_predict_head = LxmertVisualObjHead(config) + if self.task_qa: + self.answer_head = LxmertVisualAnswerHead(config, self.num_qa_labels) + + # Weight initialization + self.init_weights() + + # Loss functions + self.loss_fcts = { + "l2": SmoothL1Loss(reduction="none"), + "visual_ce": CrossEntropyLoss(reduction="none"), + "ce": CrossEntropyLoss(), + } + + visual_losses = {} + if config.visual_obj_loss: + visual_losses["obj"] = { + "shape": (-1,), + "num": config.num_object_labels, + "loss": "visual_ce", + } + if config.visual_attr_loss: + visual_losses["attr"] = { + "shape": (-1,), + "num": config.num_attr_labels, + "loss": "visual_ce", + } + if config.visual_obj_loss: + visual_losses["feat"] = { + "shape": (-1, config.visual_feat_dim), + "num": config.visual_feat_dim, + "loss": "l2", + } + self.visual_losses = visual_losses + + def resize_num_qa_labels(self, num_labels): + """ + Build a resized question answering linear layer Module from a provided new linear layer. Increasing the size will add newly + initialized weights. Reducing the size will remove weights from the end + + Args: + cur_qa_logit_layer (:obj:`torch.nn.Linear`): + Old linear layer to be resized. + num_labels (:obj:`int`, `optional`): + New number of labels in the linear layer weight matrix. + Increasing the size will add newly initialized weights at the end. Reducing the size will remove + weights from the end. If not provided or :obj:`None`, just returns a pointer to the qa labels + :obj:`torch.nn.Linear`` module of the model wihtout doing anything. + + Return: + :obj:`torch.nn.Linear`: Pointer to the resized Linear layer or the old Linear layer + """ + + cur_qa_logit_layer = self.get_qa_logit_layer() + if num_labels is None or cur_qa_logit_layer is None: + return + new_qa_logit_layer = self._resize_qa_labels(num_labels) + self.config.num_qa_labels = num_labels + self.num_qa_labels = num_labels + + return new_qa_logit_layer + + def _resize_qa_labels(self, num_labels): + cur_qa_logit_layer = self.get_qa_logit_layer() + new_qa_logit_layer = self._get_resized_qa_labels(cur_qa_logit_layer, num_labels) + self._set_qa_logit_layer(new_qa_logit_layer) + return self.get_qa_logit_layer() + + def get_qa_logit_layer(self) -> nn.Module: + """ + Returns the the linear layer that produces question answering logits. + + Returns: + :obj:`nn.Module`: A torch module mapping the question answering prediction hidden states or :obj:`None` if + LXMERT does not have a visual answering head. + """ + if hasattr(self, "answer_head"): + return self.answer_head.logit_fc[-1] + + def _set_qa_logit_layer(self, qa_logit_layer): + self.answer_head.logit_fc[-1] = qa_logit_layer + + def _get_resized_qa_labels(self, cur_qa_logit_layer, num_labels): + + if num_labels is None: + return cur_qa_logit_layer + + cur_qa_labels, hidden_dim = cur_qa_logit_layer.weight.size() + if cur_qa_labels == num_labels: + return cur_qa_logit_layer + + # Build new linear output + if getattr(cur_qa_logit_layer, "bias", None) is not None: + new_qa_logit_layer = nn.Linear(hidden_dim, num_labels) + else: + new_qa_logit_layer = nn.Linear(hidden_dim, num_labels, bias=False) + + new_qa_logit_layer.to(cur_qa_logit_layer.weight.device) + + # initialize all new labels + self._init_weights(new_qa_logit_layer) + + # Copy labels from the previous weights + num_labels_to_copy = min(cur_qa_labels, num_labels) + new_qa_logit_layer.weight.data[:num_labels_to_copy, :] = cur_qa_logit_layer.weight.data[:num_labels_to_copy, :] + if getattr(cur_qa_logit_layer, "bias", None) is not None: + new_qa_logit_layer.bias.data[:num_labels_to_copy] = cur_qa_logit_layer.bias.data[:num_labels_to_copy] + + return new_qa_logit_layer + + @add_start_docstrings_to_callable(LXMERT_INPUTS_DOCSTRING.format("(batch_size, sequence_length)")) + @replace_return_docstrings(output_type=LxmertForPreTrainingOutput, config_class=_CONFIG_FOR_DOC) + def forward( + self, + input_ids=None, + visual_feats=None, + visual_pos=None, + attention_mask=None, + visual_attention_mask=None, + token_type_ids=None, + inputs_embeds=None, + masked_lm_labels=None, + obj_labels=None, + matched_label=None, + ans=None, + output_attentions=None, + output_hidden_states=None, + return_dict=None, + ): + r""" + masked_lm_labels (``torch.LongTensor`` of shape ``(batch_size, sequence_length)``, `optional`, defaults to :obj:`None`): + Labels for computing the masked language modeling loss. + Indices should be in ``[-100, 0, ..., config.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 + in ``[0, ..., config.vocab_size]`` + obj_labels: (``Dict[Str: Tuple[Torch.FloatTensor, Torch.FloatTensor]]``, `optional`, defaults to :obj: `None`): + each key is named after each one of the visual losses and each element of the tuple is of the shape + ``(batch_size, num_features)`` and ``(batch_size, num_features, visual_feature_dim)`` + for each the label id and the label score respectively + matched_label (``torch.LongTensor`` of shape ``(batch_size,)``, `optional`, defaults to :obj:`None`): + Labels for computing the whether or not the text input matches the image (classification) loss. Input should be a sequence pair (see :obj:`input_ids` docstring) + Indices should be in ``[0, 1]``. + ``0`` indicates that the sentence does not match the image + ``1`` indicates that the sentence does match the image + ans: (``Torch.Tensor`` of shape ``(batch_size)``, `optional`, defaults to :obj: `None`): + a one hot representation hof the correct answer `optional` + + Returns: + """ + + device = input_ids.device if input_ids is not None else inputs_embeds.device + lxmert_output = self.lxmert( + input_ids=input_ids, + visual_feats=visual_feats, + visual_pos=visual_pos, + token_type_ids=token_type_ids, + attention_mask=attention_mask, + visual_attention_mask=visual_attention_mask, + inputs_embeds=inputs_embeds, + output_hidden_states=output_hidden_states, + output_attentions=output_attentions, + return_dict=return_dict, + ) + + lang_output, visual_output, pooled_output = ( + lxmert_output[0], + lxmert_output[1], + lxmert_output[2], + ) + lang_prediction_scores, cross_relationship_score = self.cls(lang_output, pooled_output) + if self.task_qa: + answer_score = self.answer_head(pooled_output) + else: + answer_score = pooled_output[0][0] + + total_loss = ( + None + if (masked_lm_labels is None and matched_label is None and obj_labels is None and ans is None) + else torch.tensor(0.0, device=device) + ) + if masked_lm_labels is not None and self.task_mask_lm: + masked_lm_loss = self.loss_fcts["ce"]( + lang_prediction_scores.view(-1, self.config.vocab_size), + masked_lm_labels.view(-1), + ) + total_loss += masked_lm_loss + if matched_label is not None and self.task_matched: + matched_loss = self.loss_fcts["ce"](cross_relationship_score.view(-1, 2), matched_label.view(-1)) + total_loss += matched_loss + if obj_labels is not None and self.task_obj_predict: + total_visual_loss = torch.tensor(0.0, device=input_ids.device) + visual_prediction_scores_dict = self.obj_predict_head(visual_output) + for key, key_info in self.visual_losses.items(): + label, mask_conf = obj_labels[key] + output_dim = key_info["num"] + loss_fct_name = key_info["loss"] + label_shape = key_info["shape"] + weight = self.visual_loss_normalizer + visual_loss_fct = self.loss_fcts[loss_fct_name] + visual_prediction_scores = visual_prediction_scores_dict[key] + visual_loss = visual_loss_fct( + visual_prediction_scores.view(-1, output_dim), + label.view(*label_shape), + ) + if visual_loss.dim() > 1: # Regression Losses + visual_loss = visual_loss.mean(1) + visual_loss = (visual_loss * mask_conf.view(-1)).mean() * weight + total_visual_loss += visual_loss + total_loss += total_visual_loss + if ans is not None and self.task_qa: + answer_loss = self.loss_fcts["ce"](answer_score.view(-1, self.num_qa_labels), ans.view(-1)) + total_loss += answer_loss + + if not return_dict: + output = ( + lang_prediction_scores, + cross_relationship_score, + answer_score, + ) + lxmert_output[3:] + return ((total_loss,) + output) if total_loss is not None else output + + return LxmertForPreTrainingOutput( + loss=total_loss, + prediction_logits=lang_prediction_scores, + cross_relationship_score=cross_relationship_score, + question_answering_score=answer_score, + language_hidden_states=lxmert_output.language_hidden_states, + vision_hidden_states=lxmert_output.vision_hidden_states, + language_attentions=lxmert_output.language_attentions, + vision_attentions=lxmert_output.vision_attentions, + cross_encoder_attentions=lxmert_output.cross_encoder_attentions, + ) + + +@add_start_docstrings( + """Lxmert Model with a visual-answering head on top for downstream QA tasks""", + LXMERT_START_DOCSTRING, +) +class LxmertForQuestionAnswering(LxmertPreTrainedModel): + def __init__(self, config): + super().__init__(config) + # Configuration + self.config = config + self.num_qa_labels = config.num_qa_labels + self.visual_loss_normalizer = config.visual_loss_normalizer + + # Lxmert backbone + self.lxmert = LxmertModel(config) + + self.answer_head = LxmertVisualAnswerHead(config, self.num_qa_labels) + + # Weight initialization + self.init_weights() + + # Loss function + self.loss = CrossEntropyLoss() + + def resize_num_qa_labels(self, num_labels): + """ + Build a resized question answering linear layer Module from a provided new linear layer. Increasing the size will add newly + initialized weights. Reducing the size will remove weights from the end + + Args: + cur_qa_logit_layer (:obj:`torch.nn.Linear`): + Old linear layer to be resized. + num_labels (:obj:`int`, `optional`): + New number of labels in the linear layer weight matrix. + Increasing the size will add newly initialized weights at the end. Reducing the size will remove + weights from the end. If not provided or :obj:`None`, just returns a pointer to the qa labels + :obj:`torch.nn.Linear`` module of the model wihtout doing anything. + + Return: + :obj:`torch.nn.Linear`: Pointer to the resized Linear layer or the old Linear layer + """ + + cur_qa_logit_layer = self.get_qa_logit_layer() + if num_labels is None or cur_qa_logit_layer is None: + return + new_qa_logit_layer = self._resize_qa_labels(num_labels) + self.config.num_qa_labels = num_labels + self.num_qa_labels = num_labels + + return new_qa_logit_layer + + def _resize_qa_labels(self, num_labels): + cur_qa_logit_layer = self.get_qa_logit_layer() + new_qa_logit_layer = self._get_resized_qa_labels(cur_qa_logit_layer, num_labels) + self._set_qa_logit_layer(new_qa_logit_layer) + return self.get_qa_logit_layer() + + def get_qa_logit_layer(self) -> nn.Module: + """ + Returns the the linear layer that produces question answering logits + + Returns: + :obj:`nn.Module`: A torch module mapping the question answering prediction hidden states. + :obj:`None`: A NoneType object if Lxmert does not have the visual answering head. + """ + + if hasattr(self, "answer_head"): + return self.answer_head.logit_fc[-1] + + def _set_qa_logit_layer(self, qa_logit_layer): + self.answer_head.logit_fc[-1] = qa_logit_layer + + def _get_resized_qa_labels(self, cur_qa_logit_layer, num_labels): + + if num_labels is None: + return cur_qa_logit_layer + + cur_qa_labels, hidden_dim = cur_qa_logit_layer.weight.size() + if cur_qa_labels == num_labels: + return cur_qa_logit_layer + + # Build new linear output + if getattr(cur_qa_logit_layer, "bias", None) is not None: + new_qa_logit_layer = nn.Linear(hidden_dim, num_labels) + else: + new_qa_logit_layer = nn.Linear(hidden_dim, num_labels, bias=False) + + new_qa_logit_layer.to(cur_qa_logit_layer.weight.device) + + # initialize all new labels + self._init_weights(new_qa_logit_layer) + + # Copy labels from the previous weights + num_labels_to_copy = min(cur_qa_labels, num_labels) + new_qa_logit_layer.weight.data[:num_labels_to_copy, :] = cur_qa_logit_layer.weight.data[:num_labels_to_copy, :] + if getattr(cur_qa_logit_layer, "bias", None) is not None: + new_qa_logit_layer.bias.data[:num_labels_to_copy] = cur_qa_logit_layer.bias.data[:num_labels_to_copy] + + return new_qa_logit_layer + + @add_start_docstrings_to_callable(LXMERT_INPUTS_DOCSTRING.format("(batch_size, sequence_length)")) + @add_code_sample_docstrings( + tokenizer_class=_TOKENIZER_FOR_DOC, + checkpoint="unc-nlp/lxmert-base-uncased", + output_type=LxmertForQuestionAnsweringOutput, + config_class=_CONFIG_FOR_DOC, + ) + def forward( + self, + input_ids=None, + visual_feats=None, + visual_pos=None, + attention_mask=None, + visual_attention_mask=None, + token_type_ids=None, + inputs_embeds=None, + labels=None, + output_attentions=None, + output_hidden_states=None, + return_dict=None, + ): + r""" + labels: (``Torch.Tensor`` of shape ``(batch_size)``, `optional`): + a one hot representation of the correct answer + + Returns: + """ + + lxmert_output = self.lxmert( + input_ids=input_ids, + visual_feats=visual_feats, + visual_pos=visual_pos, + token_type_ids=token_type_ids, + attention_mask=attention_mask, + visual_attention_mask=visual_attention_mask, + inputs_embeds=inputs_embeds, + output_hidden_states=output_hidden_states, + output_attentions=output_attentions, + return_dict=return_dict, + ) + + pooled_output = lxmert_output[2] + answer_score = self.answer_head(pooled_output) + loss = None + if labels is not None: + loss = self.loss(answer_score.view(-1, self.num_qa_labels), labels.view(-1)) + + if not return_dict: + output = (answer_score,) + lxmert_output[3:] + return (loss,) + output if loss is not None else output + + return LxmertForQuestionAnsweringOutput( + loss=loss, + question_answering_score=answer_score, + language_hidden_states=lxmert_output.language_hidden_states, + vision_hidden_states=lxmert_output.vision_hidden_states, + language_attentions=lxmert_output.language_attentions, + vision_attentions=lxmert_output.vision_attentions, + cross_encoder_attentions=lxmert_output.cross_encoder_attentions, + ) diff --git a/src/transformers/modeling_tf_lxmert.py b/src/transformers/modeling_tf_lxmert.py new file mode 100644 index 0000000000..3905b13459 --- /dev/null +++ b/src/transformers/modeling_tf_lxmert.py @@ -0,0 +1,1378 @@ +# coding=utf-8 +# Copyright 2018 The Google AI Language Team Authors, The HuggingFace Inc. team, and the +# Lxmert Authors. +# Copyright (c) 2018, NVIDIA CORPORATION. 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. +""" TF 2.0 LXMERT model. """ + + +import logging +from dataclasses import dataclass +from typing import Dict, Optional, Tuple + +import numpy as np +import tensorflow as tf + +from transformers import BatchEncoding + +from .configuration_lxmert import LxmertConfig +from .file_utils import ( + ModelOutput, + add_code_sample_docstrings, + add_start_docstrings, + add_start_docstrings_to_callable, + replace_return_docstrings, +) +from .modeling_tf_utils import TFPreTrainedModel, get_initializer, keras_serializable, shape_list + + +logger = logging.getLogger(__name__) + + +_CONFIG_FOR_DOC = "LxmertConfig" +_TOKENIZER_FOR_DOC = "LxmertTokenizer" + +TF_LXMERT_PRETRAINED_MODEL_ARCHIVE_LIST = [ + "unc-nlp/lxmert-base-uncased", +] + + +def gelu(x): + """Gaussian Error Linear Unit. + Original Implementation of the gelu activation function in Google Bert repo when initially created. + For information: OpenAI GPT's gelu is slightly different (and gives slightly different results): + 0.5 * x * (1 + torch.tanh(math.sqrt(2 / math.pi) * (x + 0.044715 * torch.pow(x, 3)))) + Also see https://arxiv.org/abs/1606.08415 + """ + cdf = 0.5 * (1.0 + tf.math.erf(x / tf.math.sqrt(2.0))) + return x * cdf + + +def gelu_new(x): + """Gaussian Error Linear Unit. + This is a smoother version of the RELU. + Original paper: https://arxiv.org/abs/1606.08415 + Args: + x: float Tensor to perform activation. + Returns: + `x` with the GELU activation applied. + """ + cdf = 0.5 * (1.0 + tf.tanh((np.sqrt(2 / np.pi) * (x + 0.044715 * tf.pow(x, 3))))) + return x * cdf + + +def swish(x): + return x * tf.sigmoid(x) + + +ACT2FN = { + "gelu": tf.keras.layers.Activation(gelu), + "relu": tf.keras.activations.relu, + "swish": tf.keras.layers.Activation(swish), + "gelu_new": tf.keras.layers.Activation(gelu_new), +} + + +@dataclass +class TFLxmertModelOutput(ModelOutput): + """ + Lxmert's outputs that contain the last hidden states, pooled outputs, and attention probabilites for + the language, visual, and, cross-modality encoders. + (note: the visual encoder in Lxmert is referred to as the "relation-ship" encoder") + + + Args: + language_output (:obj:`tf.Tensor` of shape :obj:`(batch_size, sequence_length, hidden_size)`): + Sequence of hidden-states at the output of the last layer of the language encoder. + vision_output (:obj:`tf.Tensor` of shape :obj:`(batch_size, sequence_length, hidden_size)`): + Sequence of hidden-states at the output of the last layer of the visual encoder. + pooled_output (:obj:`tf.Tensor` of shape :obj:`(batch_size, hidden_size)`): + Last layer hidden-state of the first token of the sequence (classification, CLS, token) + further processed by a Linear layer and a Tanh activation function. The Linear + language_hidden_states (:obj:`tuple(tf.Tensor)`, `optional`, returned when ``output_hidden_states=True`` is passed or when ``config.output_hidden_states=True``): + Tuple of :obj:`tf.Tensor` (one for input features + one for the output of each cross-modality layer) + of shape :obj:`(batch_size, sequence_length, hidden_size)`. + vision_hidden_states (:obj:`tuple(tf.Tensor)`, `optional`, returned when ``output_hidden_states=True`` is passed or when ``config.output_hidden_states=True``): + Tuple of :obj:`tf.Tensor` (one for input features + one for the output of each cross-modality layer) + of shape :obj:`(batch_size, sequence_length, hidden_size)`. + language_attentions (:obj:`tuple(tf.Tensor)`, `optional`, returned when ``output_attentions=True`` is passed or when ``config.output_attentions=True``): + Tuple of :obj:`tf.Tensor` (one for each layer) of shape + :obj:`(batch_size, num_heads, sequence_length, sequence_length)`. + Attentions weights after the attention softmax, used to compute the weighted average in the self-attention + heads. + vision_attentions (:obj:`tuple(tf.Tensor)`, `optional`, returned when ``output_attentions=True`` is passed or when ``config.output_attentions=True``): + Tuple of :obj:`tf.Tensor` (one for each layer) of shape + :obj:`(batch_size, num_heads, sequence_length, sequence_length)`. + Attentions weights after the attention softmax, used to compute the weighted average in the self-attention + heads. + cross_encoder_attentions (:obj:`tuple(tf.Tensor)`, `optional`, returned when ``output_attentions=True`` is passed or when ``config.output_attentions=True``): + Tuple of :obj:`tf.Tensor` (one for each layer) of shape + :obj:`(batch_size, num_heads, sequence_length, sequence_length)`. + Attentions weights after the attention softmax, used to compute the weighted average in the self-attention + heads. + """ + + language_output: Optional[tf.Tensor] = None + vision_output: Optional[tf.Tensor] = None + pooled_output: Optional[tf.Tensor] = None + language_hidden_states: Optional[Tuple[tf.Tensor]] = None + vision_hidden_states: Optional[Tuple[tf.Tensor]] = None + language_attentions: Optional[Tuple[tf.Tensor]] = None + vision_attentions: Optional[Tuple[tf.Tensor]] = None + cross_encoder_attentions: Optional[Tuple[tf.Tensor]] = None + + +@dataclass +class TFLxmertForPreTrainingOutput(ModelOutput): + """ + Output type of :class:`~transformers.LxmertForPreTrainingModel`. + + Args: + loss (`optional`, returned when ``labels`` is provided, ``tf.Tensor`` of shape :obj:`(1,)`): + Total loss as the sum of the masked language modeling loss and the next sequence prediction (classification) loss. + prediction_logits (:obj:`tf.Tensor` of shape :obj:`(batch_size, sequence_length, config.vocab_size)`): + Prediction scores of the language modeling head (scores for each vocabulary token before SoftMax). + cross_relationship_score: (:obj:`tf.Tensor` of shape :obj:`(batch_size, 2)`): + Prediction scores of the textual matching objective (classification) head (scores of True/False + continuation before SoftMax). + question_answering_score: (:obj:`tf.Tensor` of shape :obj:`(batch_size, n_qa_answers)`): + Prediction scores of question answering objective (classification). + language_hidden_states (:obj:`tuple(tf.Tensor)`, `optional`, returned when ``output_hidden_states=True`` is passed or when ``config.output_hidden_states=True``): + Tuple of :obj:`tf.Tensor` (one for input features + one for the output of each cross-modality layer) + of shape :obj:`(batch_size, sequence_length, hidden_size)`. + vision_hidden_states (:obj:`tuple(tf.Tensor)`, `optional`, returned when ``output_hidden_states=True`` is passed or when ``config.output_hidden_states=True``): + Tuple of :obj:`tf.Tensor` (one for input features + one for the output of each cross-modality layer) + of shape :obj:`(batch_size, sequence_length, hidden_size)`. + language_attentions (:obj:`tuple(tf.Tensor)`, `optional`, returned when ``output_attentions=True`` is passed or when ``config.output_attentions=True``): + Tuple of :obj:`tf.Tensor` (one for each layer) of shape + :obj:`(batch_size, num_heads, sequence_length, sequence_length)`. + Attentions weights after the attention softmax, used to compute the weighted average in the self-attention + heads. + vision_attentions (:obj:`tuple(tf.Tensor)`, `optional`, returned when ``output_attentions=True`` is passed or when ``config.output_attentions=True``): + Tuple of :obj:`tf.Tensor` (one for each layer) of shape + :obj:`(batch_size, num_heads, sequence_length, sequence_length)`. + Attentions weights after the attention softmax, used to compute the weighted average in the self-attention + heads. + cross_encoder_attentions (:obj:`tuple(tf.Tensor)`, `optional`, returned when ``output_attentions=True`` is passed or when ``config.output_attentions=True``): + Tuple of :obj:`tf.Tensor` (one for each layer) of shape + :obj:`(batch_size, num_heads, sequence_length, sequence_length)`. + Attentions weights after the attention softmax, used to compute the weighted average in the self-attention + heads. + + """ + + loss: [tf.Tensor] = None + prediction_logits: Optional[tf.Tensor] = None + cross_relationship_score: Optional[tf.Tensor] = None + question_answering_score: Optional[tf.Tensor] = None + language_hidden_states: Optional[Tuple[tf.Tensor]] = None + vision_hidden_states: Optional[Tuple[tf.Tensor]] = None + language_attentions: Optional[Tuple[tf.Tensor]] = None + vision_attentions: Optional[Tuple[tf.Tensor]] = None + cross_encoder_attentions: Optional[Tuple[tf.Tensor]] = None + + +class TFLxmertVisualFeatureEncoder(tf.keras.layers.Layer): + def __init__(self, config, **kwargs): + super().__init__(**kwargs) + + # Object feature encoding + self.visn_fc = tf.keras.layers.Dense( + config.hidden_size, + kernel_initializer=get_initializer(config.initializer_range), + name="visn_fc", + ) + self.visn_layer_norm = tf.keras.layers.LayerNormalization( + epsilon=config.layer_norm_eps, name="visn_layer_norm" + ) + + # Box position encoding + self.box_fc = tf.keras.layers.Dense( + config.hidden_size, + kernel_initializer=get_initializer(config.initializer_range), + name="box_fc", + ) + self.box_layer_norm = tf.keras.layers.LayerNormalization(epsilon=config.layer_norm_eps, name="box_layer_norm") + + self.dropout = tf.keras.layers.Dropout(config.hidden_dropout_prob) + + def call(self, visn_input, training=False): + feats, boxes = visn_input + + x = self.visn_fc(feats) + x = self.visn_layer_norm(x) + y = self.box_fc(boxes) + y = self.box_layer_norm(y) + output = (x + y) / 2 + + output = self.dropout(output, training=training) + return output + + +class TFLxmertEmbeddings(tf.keras.layers.Layer): + """Construct the embeddings from word, position and token_type embeddings.""" + + def __init__(self, config, **kwargs): + super().__init__(**kwargs) + self.vocab_size = config.vocab_size + self.hidden_size = config.hidden_size + self.initializer_range = config.initializer_range + + self.position_embeddings = tf.keras.layers.Embedding( + config.max_position_embeddings, + config.hidden_size, + embeddings_initializer=get_initializer(self.initializer_range), + name="position_embeddings", + ) + self.token_type_embeddings = tf.keras.layers.Embedding( + config.type_vocab_size, + config.hidden_size, + embeddings_initializer=get_initializer(self.initializer_range), + name="token_type_embeddings", + ) + + # self.LayerNorm is not snake-cased to stick with TensorFlow model variable name and be able to load + # any TensorFlow checkpoint file + self.LayerNorm = tf.keras.layers.LayerNormalization(epsilon=config.layer_norm_eps, name="LayerNorm") + self.dropout = tf.keras.layers.Dropout(config.hidden_dropout_prob) + + def build(self, input_shape): + """Build shared word embedding layer """ + with tf.name_scope("word_embeddings"): + # Create and initialize weights. The random normal initializer was chosen + # arbitrarily, and works well. + self.word_embeddings = self.add_weight( + "weight", + shape=[self.vocab_size, self.hidden_size], + initializer=get_initializer(self.initializer_range), + ) + super().build(input_shape) + + def call(self, inputs, mode="embedding", training=False): + """Get token embeddings of inputs. + Args: + inputs: list of three int64 tensors with shape [batch_size, length]: (input_ids, position_ids, token_type_ids) + mode: string, a valid value is one of "embedding" and "linear". + Returns: + outputs: (1) If mode == "embedding", output embedding tensor, float32 with + shape [batch_size, length, embedding_size]; (2) mode == "linear", output + linear tensor, float32 with shape [batch_size, length, vocab_size]. + Raises: + ValueError: if mode is not valid. + + Shared weights logic adapted from + https://github.com/tensorflow/models/blob/a009f4fb9d2fc4949e32192a944688925ef78659/official/transformer/v2/embedding_layer.py#L24 + """ + if mode == "embedding": + return self._embedding(inputs, training=training) + elif mode == "linear": + return self._linear(inputs) + else: + raise ValueError("mode {} is not valid.".format(mode)) + + def _embedding(self, inputs, training=False): + """Applies embedding based on inputs tensor.""" + input_ids, token_type_ids, inputs_embeds = inputs + + if input_ids is not None: + input_shape = shape_list(input_ids) + else: + input_shape = shape_list(inputs_embeds)[:-1] + + seq_length = input_shape[1] + position_ids = tf.range(seq_length, dtype=tf.int32)[tf.newaxis, :] + if token_type_ids is None: + token_type_ids = tf.fill(input_shape, 0) + + if inputs_embeds is None: + inputs_embeds = tf.gather(self.word_embeddings, input_ids) + position_embeddings = self.position_embeddings(position_ids) + token_type_embeddings = self.token_type_embeddings(token_type_ids) + + embeddings = inputs_embeds + position_embeddings + token_type_embeddings + embeddings = self.LayerNorm(embeddings) + embeddings = self.dropout(embeddings, training=training) + return embeddings + + def _linear(self, inputs): + """Computes logits by running inputs through a linear layer. + Args: + inputs: A float32 tensor with shape [batch_size, length, hidden_size] + Returns: + float32 tensor with shape [batch_size, length, vocab_size]. + """ + batch_size = shape_list(inputs)[0] + length = shape_list(inputs)[1] + + x = tf.reshape(inputs, [-1, self.hidden_size]) + logits = tf.matmul(x, self.word_embeddings, transpose_b=True) + + return tf.reshape(logits, [batch_size, length, self.vocab_size]) + + +class TFLxmertAttention(tf.keras.layers.Layer): + def __init__(self, config, **kwargs): + super().__init__(**kwargs) + if config.hidden_size % config.num_attention_heads != 0: + raise ValueError( + "The hidden size (%d) is not a multiple of the number of attention " + "heads (%d)" % (config.hidden_size, config.num_attention_heads) + ) + + self.num_attention_heads = config.num_attention_heads + assert config.hidden_size % config.num_attention_heads == 0 + 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 = tf.keras.layers.Dense( + self.all_head_size, + kernel_initializer=get_initializer(config.initializer_range), + name="query", + ) + self.key = tf.keras.layers.Dense( + self.all_head_size, + kernel_initializer=get_initializer(config.initializer_range), + name="key", + ) + self.value = tf.keras.layers.Dense( + self.all_head_size, + kernel_initializer=get_initializer(config.initializer_range), + name="value", + ) + + self.dropout = tf.keras.layers.Dropout(config.attention_probs_dropout_prob) + + def transpose_for_scores(self, x, batch_size): + x = tf.reshape(x, (batch_size, -1, self.num_attention_heads, self.attention_head_size)) + return tf.transpose(x, perm=[0, 2, 1, 3]) + + def call(self, hidden_states, context, attention_mask, output_attentions, training=False): + batch_size = shape_list(hidden_states)[0] + mixed_query_layer = self.query(hidden_states) + mixed_key_layer = self.key(context) + mixed_value_layer = self.value(context) + + query_layer = self.transpose_for_scores(mixed_query_layer, batch_size) + key_layer = self.transpose_for_scores(mixed_key_layer, batch_size) + value_layer = self.transpose_for_scores(mixed_value_layer, batch_size) + + # Take the dot product between "query" and "key" to get the raw attention scores. + attention_scores = tf.matmul( + query_layer, key_layer, transpose_b=True + ) # (batch size, num_heads, seq_len_q, seq_len_k) + dk = tf.cast(shape_list(key_layer)[-1], tf.float32) # scale attention_scores + attention_scores = attention_scores / tf.math.sqrt(dk) + + if attention_mask is not None: + # Apply the attention mask is (precomputed for all layers in TFBertModel call() function) + attention_scores = attention_scores + attention_mask + + # Normalize the attention scores to probabilities. + attention_probs = tf.nn.softmax(attention_scores, axis=-1) + + # 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, training=training) + context_layer = tf.matmul(attention_probs, value_layer) + + context_layer = tf.transpose(context_layer, perm=[0, 2, 1, 3]) + context_layer = tf.reshape( + context_layer, (batch_size, -1, self.all_head_size) + ) # (batch_size, seq_len_q, all_head_size) + + outputs = (context_layer, attention_probs) if output_attentions else (context_layer,) + return outputs + + +class TFLxmertIntermediate(tf.keras.layers.Layer): + def __init__(self, config, **kwargs): + super().__init__(**kwargs) + self.dense = tf.keras.layers.Dense( + config.intermediate_size, + kernel_initializer=get_initializer(config.initializer_range), + name="dense", + ) + if isinstance(config.hidden_act, str): + self.intermediate_act_fn = ACT2FN[config.hidden_act] + else: + self.intermediate_act_fn = config.hidden_act + + def call(self, hidden_states): + hidden_states = self.dense(hidden_states) + hidden_states = self.intermediate_act_fn(hidden_states) + return hidden_states + + +class TFLxmertOutput(tf.keras.layers.Layer): + def __init__(self, config, **kwargs): + super().__init__(**kwargs) + self.dense = tf.keras.layers.Dense( + config.hidden_size, + kernel_initializer=get_initializer(config.initializer_range), + name="dense", + ) + + self.LayerNorm = tf.keras.layers.LayerNormalization(epsilon=config.layer_norm_eps, name="LayerNorm") + self.dropout = tf.keras.layers.Dropout(config.hidden_dropout_prob) + + def call(self, hidden_states, input_tensor, training=False): + hidden_states = self.dense(hidden_states) + hidden_states = self.dropout(hidden_states, training) + hidden_states = self.LayerNorm(hidden_states + input_tensor) + return hidden_states + + +class TFLxmertAttentionOutput(tf.keras.layers.Layer): + def __init__(self, config, **kwargs): + super().__init__(**kwargs) + self.dense = tf.keras.layers.Dense( + config.hidden_size, + kernel_initializer=get_initializer(config.initializer_range), + name="dense", + ) + self.LayerNorm = tf.keras.layers.LayerNormalization(epsilon=config.layer_norm_eps, name="LayerNorm") + self.dropout = tf.keras.layers.Dropout(config.hidden_dropout_prob) + + def call(self, hidden_states, input_tensor, training=False): + hidden_states = self.dense(hidden_states) + hidden_states = self.dropout(hidden_states, training=training) + hidden_states = self.LayerNorm(hidden_states + input_tensor) + return hidden_states + + +class TFLxmertSelfAttentionLayer(tf.keras.layers.Layer): + def __init__(self, config, **kwargs): + super().__init__(**kwargs) + self.self = TFLxmertAttention(config, name="self") + self.attention_output = TFLxmertAttentionOutput(config, name="output") + + def call(self, input_tensor, attention_mask, output_attentions, training=False): + # Self attention attends to itself, thus keys and querys are the same (input_tensor). + self_output = self.self(input_tensor, input_tensor, attention_mask, output_attentions) + if output_attentions: + attention_probs = self_output[1] + attention_output = self.attention_output(self_output[0], input_tensor) + return (attention_output, attention_probs) if output_attentions else (attention_output,) + + +class TFLxmertCrossAttentionLayer(tf.keras.layers.Layer): + def __init__(self, config, **kwargs): + super().__init__(**kwargs) + self.att = TFLxmertAttention(config, name="att") + self.attention_output = TFLxmertAttentionOutput(config, name="output") + + def call( + self, + input_tensor, + ctx_tensor, + ctx_att_mask, + output_attentions=False, + training=False, + ): + output = self.att(input_tensor, ctx_tensor, ctx_att_mask, output_attentions, training=training) + if output_attentions: + attention_probs = output[1] + attention_output = self.attention_output(output[0], input_tensor, training=training) + outputs = (attention_output, attention_probs) if output_attentions else (attention_output,) + return outputs + + +class TFLxmertLayer(tf.keras.layers.Layer): + def __init__(self, config, **kwargs): + super().__init__(**kwargs) + self.attention = TFLxmertSelfAttentionLayer(config, name="attention") + self.intermediate = TFLxmertIntermediate(config, name="intermediate") + self.transformer_output = TFLxmertOutput(config, name="output") + + def call(self, hidden_states, attention_mask, output_attentions, training=False): + attention_outputs = self.attention(hidden_states, attention_mask, output_attentions, training=training) + attention_output = attention_outputs[0] + intermediate_output = self.intermediate(attention_output) + layer_output = self.transformer_output(intermediate_output, attention_output, training=training) + outputs = (layer_output,) + attention_outputs[1:] # add attentions if we output them + return outputs + + +class TFLxmertXLayer(tf.keras.layers.Layer): + def __init__(self, config, **kwargs): + super().__init__(**kwargs) + self.visual_attention = TFLxmertCrossAttentionLayer(config, name="visual_attention") + + # Self-attention Layers + self.lang_self_att = TFLxmertSelfAttentionLayer(config, name="lang_self_att") + self.visn_self_att = TFLxmertSelfAttentionLayer(config, name="visn_self_att") + + # Intermediate and Output Layers (FFNs) + self.lang_inter = TFLxmertIntermediate(config, name="lang_inter") + self.lang_output = TFLxmertOutput(config, name="lang_output") + self.visn_inter = TFLxmertIntermediate(config, name="visn_inter") + self.visn_output = TFLxmertOutput(config, name="visn_output") + + def cross_att( + self, + lang_input, + lang_attention_mask, + visn_input, + visn_attention_mask, + output_attentions, + training=False, + ): + # Cross Attention + + # Keras saving and loading model *does not work* with the same inputs for two layers. + lang_attention_lang_input = tf.identity(lang_input) + visn_attention_lang_input = tf.identity(lang_input) + lang_attention_visn_input = tf.identity(visn_input) + visn_attention_visn_input = tf.identity(visn_input) + + lang_att_output = self.visual_attention( + lang_attention_lang_input, + lang_attention_visn_input, + visn_attention_mask, + output_attentions=output_attentions, + training=training, + ) + visn_att_output = self.visual_attention( + visn_attention_visn_input, + visn_attention_lang_input, + lang_attention_mask, + output_attentions=output_attentions, + training=training, + ) + return lang_att_output, visn_att_output + + def self_att( + self, + lang_input, + lang_attention_mask, + visn_input, + visn_attention_mask, + training=False, + ): + # Self Attention + output_attentions = False + lang_att_output = self.lang_self_att(lang_input, lang_attention_mask, output_attentions, training=training) + visn_att_output = self.visn_self_att(visn_input, visn_attention_mask, output_attentions, training=training) + return lang_att_output[0], visn_att_output[0] + + def output_fc(self, lang_input, visn_input, training=False): + # FC layers + lang_inter_output = self.lang_inter(lang_input) + visn_inter_output = self.visn_inter(visn_input) + + # Layer output + lang_output = self.lang_output(lang_inter_output, lang_input, training) + visn_output = self.visn_output(visn_inter_output, visn_input, training) + return lang_output, visn_output + + def call( + self, + lang_feats, + lang_attention_mask, + visn_feats, + visn_attention_mask, + output_attentions, + training=False, + ): + lang_att_output = lang_feats + visn_att_output = visn_feats + + lang_att_output, visn_att_output = self.cross_att( + lang_att_output, + lang_attention_mask, + visn_att_output, + visn_attention_mask, + output_attentions, + training=training, + ) + attention_probs = lang_att_output[1:] + lang_att_output, visn_att_output = self.self_att( + lang_att_output[0], + lang_attention_mask, + visn_att_output[0], + visn_attention_mask, + training=training, + ) + lang_output, visn_output = self.output_fc(lang_att_output, visn_att_output, training=training) + + return (lang_output, visn_output, attention_probs[0]) if output_attentions else (lang_output, visn_output) + + +class TFLxmertEncoder(tf.keras.layers.Layer): + def __init__(self, config, **kwargs): + super().__init__(**kwargs) + + self.visn_fc = TFLxmertVisualFeatureEncoder(config, name="visn_fc") + + # Number of layers + self.num_l_layers = config.l_layers + self.num_x_layers = config.x_layers + self.num_r_layers = config.r_layers + + # Layers + # Using self.layer instead of self.l_layer to support loading BERT weights. + self.layer = [TFLxmertLayer(config, name="layer_._{}".format(i)) for i in range(self.num_l_layers)] + self.x_layers = [TFLxmertXLayer(config, name="x_layers_._{}".format(i)) for i in range(self.num_x_layers)] + self.r_layers = [TFLxmertLayer(config, name="r_layers_._{}".format(i)) for i in range(self.num_r_layers)] + self.config = config + + def call( + self, + lang_feats=None, + lang_attention_mask=None, + visual_feats=None, + visual_pos=None, + visual_attention_mask=None, + output_attentions=None, + training=False, + ): + vision_hidden_states = () + language_hidden_states = () + vision_attentions = () if output_attentions or self.config.output_attentions else None + language_attentions = () if output_attentions or self.config.output_attentions else None + cross_encoder_attentions = () if output_attentions or self.config.output_attentions else None + + visual_feats = self.visn_fc([visual_feats, visual_pos], training=training) + + # Run language layers + for layer_module in self.layer: + l_outputs = layer_module(lang_feats, lang_attention_mask, output_attentions, training=training) + lang_feats = l_outputs[0] + language_hidden_states = language_hidden_states + (lang_feats,) + if language_attentions is not None: + language_attentions = language_attentions + (l_outputs[1],) + + # Run relational layers + for layer_module in self.r_layers: + v_outputs = layer_module( + visual_feats, + visual_attention_mask, + output_attentions, + training=training, + ) + visual_feats = v_outputs[0] + vision_hidden_states = vision_hidden_states + (visual_feats,) + if vision_attentions is not None: + vision_attentions = vision_attentions + (v_outputs[1],) + + # Run cross-modality layers + for layer_module in self.x_layers: + x_outputs = layer_module( + lang_feats, + lang_attention_mask, + visual_feats, + visual_attention_mask, + output_attentions, + training=training, + ) + lang_feats, visual_feats = x_outputs[:2] + vision_hidden_states = vision_hidden_states + (visual_feats,) + language_hidden_states = language_hidden_states + (lang_feats,) + if cross_encoder_attentions is not None: + cross_encoder_attentions = cross_encoder_attentions + (x_outputs[2],) + + visual_encoder_outputs = ( + vision_hidden_states, + vision_attentions if output_attentions else None, + ) + lang_encoder_outputs = ( + language_hidden_states, + language_attentions if output_attentions else None, + ) + + return ( + visual_encoder_outputs, + lang_encoder_outputs, + cross_encoder_attentions if output_attentions else None, + ) + + +@keras_serializable +class TFLxmertMainLayer(tf.keras.layers.Layer): + config_class = LxmertConfig + + @property + def dummy_inputs(self): + """Dummy inputs to build the network. + + Returns: + tf.Tensor with dummy inputs + """ + batch_size = 2 + num_visual_features = 10 + input_ids = tf.constant([[3, 5, 6], [2, 3, 4]]) + visual_feats = tf.random.uniform((batch_size, num_visual_features, self.config.visual_feat_dim)) + visual_pos = tf.random.uniform((batch_size, num_visual_features, 4)) + + return { + "input_ids": input_ids, + "visual_feats": visual_feats, + "visual_pos": visual_pos, + } + + def __init__(self, config, **kwargs): + super().__init__(**kwargs) + self.num_l_layers = config.l_layers + self.num_x_layers = config.x_layers + self.num_r_layers = config.r_layers + self.initializer_range = config.initializer_range + self.output_attentions = config.output_attentions + self.output_hidden_states = config.output_hidden_states + self.return_dict = config.use_return_dict + self.embeddings = TFLxmertEmbeddings(config, name="embeddings") + self.encoder = TFLxmertEncoder(config, name="encoder") + self.pooler = TFLxmertPooler(config, name="pooler") + self.config = config + + def get_input_embeddings(self): + return self.embeddings + + def set_input_embeddings(self, value): + self.embeddings.word_embeddings = value + self.embeddings.vocab_size = value.shape[0] + + def _resize_token_embeddings(self, new_num_tokens): + raise NotImplementedError + + def _prune_heads(self, heads_to_prune): + raise NotImplementedError + + def call( + self, + inputs, + visual_feats=None, + visual_pos=None, + attention_mask=None, + visual_attention_mask=None, + token_type_ids=None, + inputs_embeds=None, + output_attentions=None, + output_hidden_states=None, + return_dict=None, + training=False, + ): + if isinstance(inputs, (tuple, list)): + input_ids = inputs[0] + visual_feats = inputs[1] if len(inputs) > 1 else visual_feats + visual_pos = inputs[2] if len(inputs) > 2 else visual_pos + attention_mask = inputs[3] if len(inputs) > 3 else attention_mask + visual_attention_mask = inputs[4] if len(inputs) > 4 else visual_attention_mask + token_type_ids = inputs[5] if len(inputs) > 5 else token_type_ids + inputs_embeds = inputs[6] if len(inputs) > 6 else inputs_embeds + output_attentions = inputs[7] if len(inputs) > 7 else output_attentions + output_hidden_states = inputs[8] if len(inputs) > 8 else output_hidden_states + return_dict = inputs[9] if len(inputs) > 9 else return_dict + assert len(inputs) <= 10, "Too many inputs." + elif isinstance(inputs, dict): + input_ids = inputs.get("input_ids") + visual_feats = inputs.get("visual_feats", visual_feats) + visual_pos = inputs.get("visual_pos", visual_pos) + attention_mask = inputs.get("attention_mask", attention_mask) + visual_attention_mask = inputs.get("visual_attention_mask", visual_attention_mask) + token_type_ids = inputs.get("token_type_ids", token_type_ids) + inputs_embeds = inputs.get("inputs_embeds", inputs_embeds) + output_attentions = inputs.get("output_attentions", output_attentions) + output_hidden_states = inputs.get("output_hidden_states", output_hidden_states) + return_dict = inputs.get("return_dict", return_dict) + assert len(inputs) <= 10, "Too many inputs." + else: + input_ids = inputs + + output_attentions = output_attentions if output_attentions is not None else self.output_attentions + output_hidden_states = output_hidden_states if output_hidden_states is not None else self.output_hidden_states + return_dict = return_dict if return_dict is not None else self.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: + input_shape = shape_list(input_ids) + elif inputs_embeds is not None: + input_shape = shape_list(inputs_embeds)[:-1] + else: + raise ValueError("You have to specify either input_ids or inputs_embeds") + if visual_pos is None or visual_feats is None: + raise ValueError("visual_feats and visual_pos cannot be `None` in LXMERT's `call` method.") + + if attention_mask is None: + attention_mask = tf.fill(input_shape, 1) + if token_type_ids is None: + token_type_ids = tf.fill(input_shape, 0) + + # We create a 3D attention mask from a 2D tensor mask. + # Sizes are [batch_size, 1, 1, to_seq_length] + # So we can broadcast to [batch_size, num_heads, from_seq_length, to_seq_length] + # this attention mask is more simple than the triangular masking of causal attention + # used in OpenAI GPT, we just need to prepare the broadcast dimension here. + extended_attention_mask = attention_mask[:, tf.newaxis, tf.newaxis, :] + + # Since attention_mask is 1.0 for positions we want to attend and 0.0 for + # masked positions, this operation will create a tensor which is 0.0 for + # positions we want to attend and -10000.0 for masked positions. + # Since we are adding it to the raw scores before the softmax, this is + # effectively the same as removing these entirely. + + extended_attention_mask = tf.cast(extended_attention_mask, tf.float32) + extended_attention_mask = (1.0 - extended_attention_mask) * -10000.0 + + if visual_attention_mask is not None: + extended_visual_attention_mask = visual_attention_mask[:, tf.newaxis, tf.newaxis, :] + + extended_visual_attention_mask = tf.cast(extended_visual_attention_mask, tf.float32) + extended_visual_attention_mask = (1.0 - extended_visual_attention_mask) * -10000.0 + else: + extended_visual_attention_mask = None + + # Positional Word Embeddings + embedding_output = self.embeddings([input_ids, token_type_ids, inputs_embeds], training=training) + + # Run Lxmert encoder + encoder_outputs = self.encoder( + embedding_output, + extended_attention_mask, + visual_feats, + visual_pos, + extended_visual_attention_mask, + output_attentions=output_attentions, + training=training, + ) + visual_encoder_outputs, lang_encoder_outputs = encoder_outputs[:2] + vision_hidden_states = visual_encoder_outputs[0] + language_hidden_states = lang_encoder_outputs[0] + + all_attentions = () + if output_attentions: + language_attentions = lang_encoder_outputs[1] + vision_attentions = visual_encoder_outputs[1] + cross_encoder_attentions = encoder_outputs[2] + all_attentions = ( + language_attentions, + vision_attentions, + cross_encoder_attentions, + ) + + hidden_states = (language_hidden_states, vision_hidden_states) if output_hidden_states else () + + visual_output = vision_hidden_states[-1] + lang_output = language_hidden_states[-1] + pooled_output = self.pooler(lang_output) + + if not return_dict: + return (lang_output, visual_output, pooled_output) + hidden_states + all_attentions + + return TFLxmertModelOutput( + pooled_output=pooled_output, + language_output=lang_output, + vision_output=visual_output, + language_hidden_states=language_hidden_states if output_hidden_states else None, + vision_hidden_states=vision_hidden_states if output_hidden_states else None, + language_attentions=language_attentions if output_attentions else None, + vision_attentions=vision_attentions if output_attentions else None, + cross_encoder_attentions=cross_encoder_attentions if output_attentions else None, + ) + + +class TFLxmertPreTrainedModel(TFPreTrainedModel): + """An abstract class to handle weights initialization and + a simple interface for downloading and loading pretrained models. + """ + + config_class = LxmertConfig + base_model_prefix = "lxmert" + + @property + def dummy_inputs(self) -> Dict[str, tf.Tensor]: + return getattr(self, self.base_model_prefix).dummy_inputs + + +LXMERT_START_DOCSTRING = r""" + The LXMERT model was proposed in `LXMERT: Learning Cross-Modality Encoder Representations from Transformers `__ + by Hao Tan and Mohit Bansal. It's a vision and language transformer model, + pre-trained on a variety of multi-modal datasets comprising of GQA, VQAv2.0, MCSCOCO captions, and Visual genome, + using a combination of masked language modeling, region of interest feature regression, + cross entropy loss for question answering attribute prediction, and object tag predicition. + + This model is a `tf.keras.Model `__ sub-class. + Use it as a regular TF 2.0 Keras Model and + refer to the TF 2.0 documentation for all matter related to general usage and behavior. + + Note on the model inputs: + TF 2.0 models accepts two formats as inputs: + + - having all inputs as keyword arguments (like PyTorch models), or + - having all inputs as a list, tuple or dict in the first positional arguments. + + This second option is useful when using :obj:`tf.keras.Model.fit()` method which currently requires having + all the tensors in the first argument of the model call function: :obj:`model(inputs)`. + + If you choose this second option, there are three possibilities you can use to gather all the input Tensors + in the first positional argument : + + - a single Tensor with input_ids only and nothing else: :obj:`model(inputs_ids)` + - a list of varying length with one or several input Tensors IN THE ORDER given in the docstring: + :obj:`model([input_ids, attention_mask])` or :obj:`model([input_ids, attention_mask, token_type_ids])` + - a dictionary with one or several input Tensors associated to the input names given in the docstring: + :obj:`model({'input_ids': input_ids, 'token_type_ids': token_type_ids})` + + Parameters: + config (:class:`~transformers.LxmertConfig`): Model configuration class with all the parameters of the model. + Initializing with a config file does not load the weights associated with the model, only the configuration. + Check out the :meth:`~transformers.PreTrainedModel.from_pretrained` method to load the model weights. +""" + +LXMERT_INPUTS_DOCSTRING = r""" + Args: + input_ids (:obj:`np.ndarray` or :obj:`tf.Tensor` of shape :obj:`(batch_size, sequence_length)`): + Indices of input sequence tokens in the vocabulary. + + Indices can be obtained using :class:`transformers.LxmertTokenizer`. + See :func:`transformers.PreTrainedTokenizer.encode` and + :func:`transformers.PreTrainedTokenizer.__call__` for details. + + `What are input IDs? <../glossary.html#input-ids>`__ + attention_mask (:obj:`tf.Tensor` of shape :obj:`{0}`, `optional`, defaults to :obj:`None`): + Mask to avoid performing attention on padding token indices. + Mask values selected in ``[0, 1]``: + ``1`` for tokens that are NOT MASKED, ``0`` for MASKED tokens. + + `What are attention masks? <../glossary.html#attention-mask>`__ + token_type_ids (:obj:`tf.Tensor` of shape :obj:`{0}`, `optional`, defaults to :obj:`None`): + Segment token indices to indicate first and second portions of the inputs. + Indices are selected in ``[0, 1]``: ``0`` corresponds to a `sentence A` token, ``1`` + corresponds to a `sentence B` token + + `What are token type IDs? <../glossary.html#token-type-ids>`_ + visual_feats: (:obj:`tf.Tensor` of shape :obj:՝(batch_size, num_visual_features, visual_feat_dim)՝): + This input represents visual features. They ROI pooled object features from bounding boxes using a faster-RCNN model) + These are currently not provided by the transformers library + visual_attention_mask (:obj:`tf.Tensor` of shape :obj:`{0}`, `optional`, defaults to :obj:`None`): + Mask to avoid performing attention on padding token indices. + Mask values selected in ``[0, 1]``: + ``1`` for tokens that are NOT MASKED, ``0`` for MASKED tokens. + + `What are attention masks? <../glossary.html#attention-mask>`__ +""" + + +@add_start_docstrings( + "The bare Lxmert Model transformer outputing raw hidden-states without any specific head on top.", + LXMERT_START_DOCSTRING, +) +class TFLxmertModel(TFLxmertPreTrainedModel): + def __init__(self, config, *inputs, **kwargs): + super().__init__(config, *inputs, **kwargs) + self.lxmert = TFLxmertMainLayer(config, name="lxmert") + + @add_start_docstrings_to_callable(LXMERT_INPUTS_DOCSTRING.format("(batch_size, sequence_length)")) + @add_code_sample_docstrings( + tokenizer_class=_TOKENIZER_FOR_DOC, + checkpoint="unc-nlp/lxmert-base-uncased", + output_type=TFLxmertModelOutput, + config_class=_CONFIG_FOR_DOC, + ) + def call(self, inputs, *args, **kwargs): + outputs = self.lxmert(inputs, *args, **kwargs) + return outputs + + +class TFLxmertPooler(tf.keras.layers.Layer): + def __init__(self, config, **kwargs): + super().__init__(**kwargs) + self.dense = tf.keras.layers.Dense( + config.hidden_size, + kernel_initializer=get_initializer(config.initializer_range), + activation="tanh", + name="dense", + ) + + def call(self, hidden_states): + # 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) + return pooled_output + + +class TFLxmertPredictionHeadTransform(tf.keras.layers.Layer): + def __init__(self, config, **kwargs): + super().__init__(**kwargs) + self.dense = tf.keras.layers.Dense( + config.hidden_size, + kernel_initializer=get_initializer(config.initializer_range), + name="dense", + ) + if isinstance(config.hidden_act, str): + self.transform_act_fn = ACT2FN[config.hidden_act] + else: + self.transform_act_fn = config.hidden_act + self.LayerNorm = tf.keras.layers.LayerNormalization(epsilon=config.layer_norm_eps, name="LayerNorm") + + def call(self, hidden_states): + hidden_states = self.dense(hidden_states) + hidden_states = self.transform_act_fn(hidden_states) + hidden_states = self.LayerNorm(hidden_states) + return hidden_states + + +class TFLxmertLMPredictionHead(tf.keras.layers.Layer): + def __init__(self, config, input_embeddings, **kwargs): + super().__init__(**kwargs) + self.vocab_size = config.vocab_size + self.transform = TFLxmertPredictionHeadTransform(config, name="transform") + + # The output weights are the same as the input embeddings, but there is + # an output-only bias for each token. + self.input_embeddings = input_embeddings + + def build(self, input_shape): + self.bias = self.add_weight(shape=(self.vocab_size,), initializer="zeros", trainable=True, name="bias") + super().build(input_shape) + + def call(self, hidden_states): + hidden_states = self.transform(hidden_states) + hidden_states = self.input_embeddings(hidden_states, mode="linear") + hidden_states = hidden_states + self.bias + return hidden_states + + +class TFLxmertMLMHead(tf.keras.layers.Layer): + def __init__(self, config, input_embeddings, **kwargs): + super().__init__(**kwargs) + + self.predictions = TFLxmertLMPredictionHead(config, input_embeddings, name="predictions") + + def call(self, sequence_output): + prediction_scores = self.predictions(sequence_output) + return prediction_scores + + +class TFLxmertPreTrainingHeads(tf.keras.layers.Layer): + def __init__(self, config, input_embeddings, **kwargs): + super().__init__(**kwargs) + self.predictions = TFLxmertLMPredictionHead(config, input_embeddings, name="predictions") + + self.seq_relationship = tf.keras.layers.Dense( + 2, + kernel_initializer=get_initializer(config.initializer_range), + name="seq_relationship", + ) + + def call(self, sequence_output, pooled_output): + prediction_scores = self.predictions(sequence_output) + seq_relationship_score = self.seq_relationship(pooled_output) + return prediction_scores, seq_relationship_score + + +class TFLxmertVisualAnswerHead(tf.keras.layers.Layer): + def __init__(self, config, num_labels, **kwargs): + super().__init__(**kwargs) + hid_dim = config.hidden_size + self.dense = tf.keras.layers.Dense( + hid_dim * 2, + kernel_initializer=get_initializer(config.initializer_range), + name="logit_fc_._0", + ) + self.activation = tf.keras.layers.Activation(gelu) + self.layer_norm = tf.keras.layers.LayerNormalization(epsilon=config.layer_norm_eps, name="logit_fc_._2") + self.dense_1 = tf.keras.layers.Dense( + num_labels, + kernel_initializer=get_initializer(config.initializer_range), + name="logit_fc_._3", + ) + + def call(self, hidden_states): + hidden_states = self.dense(hidden_states) + hidden_states = self.activation(hidden_states) + hidden_states = self.layer_norm(hidden_states) + hidden_states = self.dense_1(hidden_states) + + return hidden_states + + +class TFLxmertVisualObjHead(tf.keras.layers.Layer): + def __init__(self, config, **kwargs): + super().__init__(**kwargs) + self.transform = TFLxmertPredictionHeadTransform(config, name="transform") + + # Decide the use of visual losses + visual_losses = {} + if config.visual_obj_loss: + visual_losses["obj"] = {"shape": (-1,), "num": config.num_object_labels} + if config.visual_attr_loss: + visual_losses["attr"] = {"shape": (-1,), "num": config.num_attr_labels} + if config.visual_obj_loss: + visual_losses["feat"] = {"shape": (-1, 2048), "num": config.visual_feat_dim} + self.visual_losses = visual_losses + + # The output weights are the same as the input embeddings, but there is + # an output-only bias for each token. + self.decoder_dict = { + key: tf.keras.layers.Dense( + self.visual_losses[key]["num"], + kernel_initializer=get_initializer(config.initializer_range), + name=f"decoder_dict.{key}", + ) + for key in self.visual_losses + } + + def call(self, hidden_states): + hidden_states = self.transform(hidden_states) + output = {} + for key in self.visual_losses: + output[key] = self.decoder_dict[key](hidden_states) + return output + + +@add_start_docstrings("""Lxmert Model with a `language modeling` head on top. """, LXMERT_START_DOCSTRING) +class TFLxmertForPreTraining(TFLxmertPreTrainedModel): + def __init__(self, config, *inputs, **kwargs): + super().__init__(config, *inputs, **kwargs) + + self.config = config + self.num_qa_labels = config.num_qa_labels + self.visual_loss_normalizer = config.visual_loss_normalizer + + # Use of pre-training tasks + self.task_mask_lm = config.task_mask_lm + self.task_obj_predict = config.task_obj_predict + self.task_matched = config.task_matched + self.task_qa = config.task_qa + + # Lxmert backbone + self.lxmert = TFLxmertMainLayer(config, name="lxmert") + + # Pre-training heads + self.cls = TFLxmertPreTrainingHeads(config, self.lxmert.embeddings, name="cls") + if self.task_obj_predict: + self.obj_predict_head = TFLxmertVisualObjHead(config, name="obj_predict_head") + if self.task_qa: + self.answer_head = TFLxmertVisualAnswerHead(config, self.num_qa_labels, name="answer_head") + + # Loss functions + self.loss_fcts = { + "l2": tf.keras.losses.Huber(delta=1.0, name="huber_loss"), + "visn_ce": tf.keras.losses.SparseCategoricalCrossentropy(from_logits=True), + "ce": tf.keras.losses.SparseCategoricalCrossentropy(from_logits=True), + } + + visual_losses = {} + if config.visual_obj_loss: + visual_losses["obj"] = { + "shape": (-1,), + "num": config.num_object_labels, + "loss": "visn_ce", + } + if config.visual_attr_loss: + visual_losses["attr"] = { + "shape": (-1,), + "num": config.num_attr_labels, + "loss": "visn_ce", + } + if config.visual_obj_loss: + visual_losses["feat"] = { + "shape": (-1, config.visual_feat_dim), + "num": config.visual_feat_dim, + "loss": "l2", + } + self.visual_losses = visual_losses + + @property + def dummy_inputs(self): + """Dummy inputs to build the network. + + Returns: + tf.Tensor with dummy inputs + """ + batch_size = 2 + num_visual_features = 10 + input_ids = tf.constant([[3, 5, 6], [2, 3, 4]]) + visual_feats = tf.random.uniform((batch_size, num_visual_features, self.config.visual_feat_dim)) + visual_pos = tf.random.uniform((batch_size, num_visual_features, 4)) + + if self.config.task_obj_predict: + obj_labels = {} + if self.config.visual_attr_loss and self.config.task_obj_predict: + obj_labels["attr"] = ( + tf.ones([batch_size, num_visual_features]), + tf.ones([batch_size, num_visual_features]), + ) + if self.config.visual_feat_loss and self.config.task_obj_predict: + obj_labels["feat"] = ( + tf.ones([batch_size, num_visual_features, self.config.visual_feat_dim]), + tf.ones([batch_size, num_visual_features]), + ) + if self.config.visual_obj_loss and self.config.task_obj_predict: + obj_labels["obj"] = ( + tf.ones([batch_size, num_visual_features]), + tf.ones([batch_size, num_visual_features]), + ) + + return { + **{ + "input_ids": input_ids, + "visual_feats": visual_feats, + "visual_pos": visual_pos, + }, + **({"obj_labels": obj_labels} if self.config.task_obj_predict else {}), + } + + @add_start_docstrings_to_callable(LXMERT_INPUTS_DOCSTRING.format("(batch_size, sequence_length)")) + @replace_return_docstrings(output_type=TFLxmertForPreTrainingOutput, config_class=_CONFIG_FOR_DOC) + def call( + self, + inputs=None, + visual_feats=None, + visual_pos=None, + attention_mask=None, + visual_attention_mask=None, + token_type_ids=None, + inputs_embeds=None, + masked_lm_labels=None, + obj_labels=None, + matched_label=None, + ans=None, + output_attentions=None, + output_hidden_states=None, + return_dict=None, + ): + r""" + masked_lm_labels (``tf.Tensor`` of shape ``(batch_size, sequence_length)``, `optional`, defaults to :obj:`None`): + Labels for computing the masked language modeling loss. + Indices should be in ``[-100, 0, ..., config.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 + in ``[0, ..., config.vocab_size]`` + obj_labels: (``Dict[Str: Tuple[tf.Tensor, tf.Tensor]]``, `optional`, defaults to :obj: `None`): + each key is named after each one of the visual losses and each element of the tuple is of the shape + ``(batch_size, num_features)`` and ``(batch_size, num_features, visual_feature_dim)`` + for each the label id and the label score respectively + matched_label (``tf.Tensor`` of shape ``(batch_size,)``, `optional`, defaults to :obj:`None`): + Labels for computing the whether or not the text input matches the image (classification) loss. Input should be a sequence pair (see :obj:`input_ids` docstring) + Indices should be in ``[0, 1]``. + ``0`` indicates that the sentence does not match the image + ``1`` indicates that the sentence does match the image + ans: (``Torch.Tensor`` of shape ``(batch_size)``, `optional`, defaults to :obj: `None`): + a one hot representation hof the correct answer `optional` + + Returns: + """ + if isinstance(inputs, (tuple, list)): + masked_lm_labels = inputs[7] if len(inputs) > 7 else masked_lm_labels + obj_labels = inputs[8] if len(inputs) > 8 else obj_labels + matched_label = inputs[9] if len(inputs) > 9 else matched_label + ans = inputs[10] if len(inputs) > 10 else ans + if len(inputs) > 10: + inputs = inputs[:10] + elif isinstance(inputs, (dict, BatchEncoding)): + masked_lm_labels = inputs.pop("masked_lm_labels", masked_lm_labels) + obj_labels = inputs.pop("obj_labels", obj_labels) + matched_label = inputs.pop("matched_label", matched_label) + ans = inputs.pop("ans", ans) + + lxmert_output = self.lxmert( + inputs, + visual_feats=visual_feats, + visual_pos=visual_pos, + attention_mask=attention_mask, + visual_attention_mask=visual_attention_mask, + token_type_ids=token_type_ids, + inputs_embeds=inputs_embeds, + output_hidden_states=output_hidden_states, + output_attentions=output_attentions, + return_dict=return_dict, + ) + + lang_output, visual_output, pooled_output = ( + lxmert_output[0], + lxmert_output[1], + lxmert_output[2], + ) + lang_prediction_scores, cross_relationship_score = self.cls(lang_output, pooled_output) + if self.task_qa: + answer_score = self.answer_head(pooled_output) + else: + answer_score = pooled_output[0][0] + + total_loss = ( + None + if (masked_lm_labels is None and matched_label is None and obj_labels is None and ans is None) + else tf.constant(0.0) + ) + losses = () + if masked_lm_labels is not None and self.task_mask_lm: + masked_lm_loss = self.loss_fcts["ce"]( + tf.reshape(masked_lm_labels, [-1]), + tf.reshape(lang_prediction_scores, [-1, self.config.vocab_size]), + ) + total_loss += masked_lm_loss + losses += (masked_lm_loss,) + if matched_label is not None and self.task_matched: + matched_loss = self.loss_fcts["ce"]( + tf.reshape(matched_label, [-1]), + tf.reshape(cross_relationship_score, [-1, 2]), + ) + total_loss += matched_loss + losses += (matched_loss,) + if obj_labels is not None and self.task_obj_predict: + total_visn_loss = 0.0 + visn_prediction_scores_dict = self.obj_predict_head(visual_output) + for key, key_info in self.visual_losses.items(): + label, mask_conf = obj_labels[key] + output_dim = key_info["num"] + loss_fct_name = key_info["loss"] + label_shape = key_info["shape"] + weight = self.visual_loss_normalizer + visn_loss_fct = self.loss_fcts[loss_fct_name] + visn_prediction_scores = visn_prediction_scores_dict[key] + visn_loss = visn_loss_fct( + tf.reshape(label, label_shape), + tf.reshape(visn_prediction_scores, [-1, output_dim]), + ) + + if visn_loss.ndim > 1: # Regression Losses + visn_loss = tf.reduce_mean(visn_loss) + visn_loss = tf.reduce_mean(visn_loss * tf.cast(tf.reshape(mask_conf, [-1]), visn_loss.dtype)) * weight + total_visn_loss += visn_loss + losses += (visn_loss,) + total_loss += total_visn_loss + if ans is not None and self.task_qa: + answer_loss = self.loss_fcts["ce"]( + tf.reshape(ans, [-1]), tf.reshape(answer_score, [-1, self.num_qa_labels]) + ) + # exclude "*2" here to match the effect of QA losses. + # Previous: (loss *0) for 6 epochs, (loss *2) for 6 epochs. (Used 10 instead of 6 in EMNLP paper) + # Now : (loss *1) for 12 epochs + # + # * 2 # Multiply by 2 because > half of the data will not have label + total_loss += answer_loss + losses += (answer_loss,) + # return total_loss, tf.stack(losses)[tf.new_axis, ...], answer_score.detach() + + if not return_dict: + output = ( + lang_prediction_scores, + cross_relationship_score, + answer_score, + ) + lxmert_output[3:] + return ((total_loss,) + output) if total_loss is not None else output + + return TFLxmertForPreTrainingOutput( + loss=total_loss, + prediction_logits=lang_prediction_scores, + cross_relationship_score=cross_relationship_score, + question_answering_score=answer_score, + language_hidden_states=lxmert_output.language_hidden_states, + vision_hidden_states=lxmert_output.vision_hidden_states, + language_attentions=lxmert_output.language_attentions, + vision_attentions=lxmert_output.vision_attentions, + cross_encoder_attentions=lxmert_output.cross_encoder_attentions, + ) diff --git a/src/transformers/modeling_tf_mobilebert.py b/src/transformers/modeling_tf_mobilebert.py index 67681be039..f9001d5867 100644 --- a/src/transformers/modeling_tf_mobilebert.py +++ b/src/transformers/modeling_tf_mobilebert.py @@ -883,7 +883,7 @@ MOBILEBERT_START_DOCSTRING = r""" MOBILEBERT_INPUTS_DOCSTRING = r""" Args: - input_ids (:obj:`Numpy array` or :obj:`tf.Tensor` of shape :obj:`{0}`): + input_ids (:obj:`np.ndarray` or :obj:`tf.Tensor` of shape :obj:`{0}`): Indices of input sequence tokens in the vocabulary. Indices can be obtained using :class:`transformers.MobileBertTokenizer`. @@ -891,28 +891,28 @@ MOBILEBERT_INPUTS_DOCSTRING = r""" :func:`transformers.PreTrainedTokenizer.__call__` for details. `What are input IDs? <../glossary.html#input-ids>`__ - attention_mask (:obj:`Numpy array` or :obj:`tf.Tensor` of shape :obj:`{0}`, `optional`, defaults to :obj:`None`): + attention_mask (:obj:`np.ndarray` or :obj:`tf.Tensor` of shape :obj:`{0}`, `optional`, defaults to :obj:`None`): Mask to avoid performing attention on padding token indices. Mask values selected in ``[0, 1]``: ``1`` for tokens that are NOT MASKED, ``0`` for MASKED tokens. `What are attention masks? <../glossary.html#attention-mask>`__ - token_type_ids (:obj:`Numpy array` or :obj:`tf.Tensor` of shape :obj:`{0}`, `optional`, defaults to :obj:`None`): + token_type_ids (:obj:`np.ndarray` or :obj:`tf.Tensor` of shape :obj:`{0}`, `optional`, defaults to :obj:`None`): Segment token indices to indicate first and second portions of the inputs. Indices are selected in ``[0, 1]``: ``0`` corresponds to a `sentence A` token, ``1`` corresponds to a `sentence B` token `What are token type IDs? <../glossary.html#token-type-ids>`__ - position_ids (:obj:`Numpy array` or :obj:`tf.Tensor` of shape :obj:`{0}`, `optional`, defaults to :obj:`None`): + position_ids (:obj:`np.ndarray` or :obj:`tf.Tensor` of shape :obj:`{0}`, `optional`, defaults to :obj:`None`): Indices of positions of each input sequence tokens in the position embeddings. Selected in the range ``[0, config.max_position_embeddings - 1]``. `What are position IDs? <../glossary.html#position-ids>`__ - head_mask (:obj:`Numpy array` or :obj:`tf.Tensor` of shape :obj:`(num_heads,)` or :obj:`(num_layers, num_heads)`, `optional`, defaults to :obj:`None`): + head_mask (:obj:`np.ndarray` or :obj:`tf.Tensor` of shape :obj:`(num_heads,)` or :obj:`(num_layers, num_heads)`, `optional`, defaults to :obj:`None`): Mask to nullify selected heads of the self-attention modules. Mask values selected in ``[0, 1]``: :obj:`1` indicates the head is **not masked**, :obj:`0` indicates the head is **masked**. - inputs_embeds (:obj:`Numpy array` or :obj:`tf.Tensor` of shape :obj:`(batch_size, sequence_length, embedding_dim)`, `optional`, defaults to :obj:`None`): + inputs_embeds (:obj:`np.ndarray` or :obj:`tf.Tensor` of shape :obj:`(batch_size, sequence_length, embedding_dim)`, `optional`, defaults to :obj:`None`): Optionally, instead of passing :obj:`input_ids` you can to directly pass an embedded representation. 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. diff --git a/src/transformers/modeling_tf_utils.py b/src/transformers/modeling_tf_utils.py index 4db9b4f47d..4ec504810e 100644 --- a/src/transformers/modeling_tf_utils.py +++ b/src/transformers/modeling_tf_utils.py @@ -191,7 +191,7 @@ class TFSequenceClassificationLoss: """ def compute_loss(self, labels, logits): - if shape_list(logits)[1] == 1: + if len(shape_list(logits)) == 1 or shape_list(logits)[1] == 1: loss_fn = tf.keras.losses.MeanSquaredError(reduction=tf.keras.losses.Reduction.NONE) else: loss_fn = tf.keras.losses.SparseCategoricalCrossentropy( diff --git a/src/transformers/tokenization_auto.py b/src/transformers/tokenization_auto.py index f35b445287..626e576759 100644 --- a/src/transformers/tokenization_auto.py +++ b/src/transformers/tokenization_auto.py @@ -29,6 +29,7 @@ from .configuration_auto import ( FlaubertConfig, GPT2Config, LongformerConfig, + LxmertConfig, MarianConfig, MBartConfig, MobileBertConfig, @@ -55,6 +56,7 @@ from .tokenization_electra import ElectraTokenizer, ElectraTokenizerFast from .tokenization_flaubert import FlaubertTokenizer from .tokenization_gpt2 import GPT2Tokenizer, GPT2TokenizerFast from .tokenization_longformer import LongformerTokenizer, LongformerTokenizerFast +from .tokenization_lxmert import LxmertTokenizer, LxmertTokenizerFast from .tokenization_marian import MarianTokenizer from .tokenization_mbart import MBartTokenizer from .tokenization_mobilebert import MobileBertTokenizer, MobileBertTokenizerFast @@ -91,6 +93,7 @@ TOKENIZER_MAPPING = OrderedDict( (RobertaConfig, (RobertaTokenizer, RobertaTokenizerFast)), (ReformerConfig, (ReformerTokenizer, None)), (ElectraConfig, (ElectraTokenizer, ElectraTokenizerFast)), + (LxmertConfig, (LxmertTokenizer, LxmertTokenizerFast)), (BertConfig, (BertTokenizer, BertTokenizerFast)), (OpenAIGPTConfig, (OpenAIGPTTokenizer, OpenAIGPTTokenizerFast)), (GPT2Config, (GPT2Tokenizer, GPT2TokenizerFast)), @@ -128,6 +131,7 @@ class AutoTokenizer: - `xlm`: XLMTokenizer (XLM model) - `ctrl`: CTRLTokenizer (Salesforce CTRL model) - `electra`: ElectraTokenizer (Google ELECTRA model) + - `lxmert`: LxmertTokenizer (Lxmert model) This class cannot be instantiated using `__init__()` (throw an error). """ @@ -163,6 +167,7 @@ class AutoTokenizer: - `xlm`: XLMTokenizer (XLM model) - `ctrl`: CTRLTokenizer (Salesforce CTRL model) - `electra`: ElectraTokenizer (Google ELECTRA model) + - `lxmert`: LxmertTokenizer (Lxmert model) Params: pretrained_model_name_or_path: either: diff --git a/src/transformers/tokenization_lxmert.py b/src/transformers/tokenization_lxmert.py new file mode 100644 index 0000000000..316d43f95b --- /dev/null +++ b/src/transformers/tokenization_lxmert.py @@ -0,0 +1,80 @@ +# coding=utf-8 +# Copyright 2020 The Google AI Team, Stanford University and The HuggingFace Inc. team. +# +# 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. + +from .tokenization_bert import BertTokenizer, BertTokenizerFast + + +#################################################### +# Mapping from the keyword arguments names of Tokenizer `__init__` +# to file names for serializing Tokenizer instances +#################################################### +VOCAB_FILES_NAMES = {"vocab_file": "vocab.txt"} + +#################################################### +# Mapping from the keyword arguments names of Tokenizer `__init__` +# to pretrained vocabulary URL for all the model shortcut names. +#################################################### +PRETRAINED_VOCAB_FILES_MAP = { + "vocab_file": { + "unc-nlp/lxmert-base-uncased": "https://s3.amazonaws.com/models.huggingface.co/bert/bert-base-uncased-vocab.txt", + } +} + +#################################################### +# Mapping from model shortcut names to max length of inputs +#################################################### +PRETRAINED_POSITIONAL_EMBEDDINGS_SIZES = { + "unc-nlp/lxmert-base-uncased": 512, +} +#################################################### +# Mapping from model shortcut names to a dictionary of additional +# keyword arguments for Tokenizer `__init__`. +# To be used for checkpoint specific configurations. +#################################################### +PRETRAINED_INIT_CONFIGURATION = { + "unc-nlp/lxmert-base-uncased": {"do_lower_case": True}, +} + + +class LxmertTokenizer(BertTokenizer): + r""" + Constructs an Lxmert tokenizer. + :class:`~transformers.LxmertTokenizer` is identical to :class:`~transformers.BertTokenizer` and runs end-to-end + tokenization: punctuation splitting + wordpiece. + + Refer to superclass :class:`~transformers.BertTokenizer` for usage examples and documentation concerning + parameters. + """ + + vocab_files_names = VOCAB_FILES_NAMES + pretrained_vocab_files_map = PRETRAINED_VOCAB_FILES_MAP + max_model_input_sizes = PRETRAINED_POSITIONAL_EMBEDDINGS_SIZES + pretrained_init_configuration = PRETRAINED_INIT_CONFIGURATION + + +class LxmertTokenizerFast(BertTokenizerFast): + r""" + Constructs a "Fast" Lxmert Fast tokenizer (backed by HuggingFace's `tokenizers` library). + + :class:`~transformers.LxmertTokenizerFast` is identical to :class:`~transformers.BertTokenizerFast` and runs end-to-end + tokenization: punctuation splitting + wordpiece. + + Refer to superclass :class:`~transformers.BertTokenizerFast` for usage examples and documentation concerning + parameters. + """ + vocab_files_names = VOCAB_FILES_NAMES + pretrained_vocab_files_map = PRETRAINED_VOCAB_FILES_MAP + max_model_input_sizes = PRETRAINED_POSITIONAL_EMBEDDINGS_SIZES + pretrained_init_configuration = PRETRAINED_INIT_CONFIGURATION diff --git a/tests/test_modeling_lxmert.py b/tests/test_modeling_lxmert.py new file mode 100644 index 0000000000..5484f2b71c --- /dev/null +++ b/tests/test_modeling_lxmert.py @@ -0,0 +1,684 @@ +# coding=utf-8 +# Copyright 2018 LXMERT Authors. +# +# 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. + + +import unittest + +from transformers import is_torch_available +from transformers.testing_utils import require_torch, slow, torch_device + +from .test_configuration_common import ConfigTester +from .test_modeling_common import ModelTesterMixin, ids_tensor + + +if is_torch_available(): + import torch + + from transformers import LxmertConfig, LxmertForPreTraining, LxmertForQuestionAnswering, LxmertModel + from transformers.modeling_lxmert import LXMERT_PRETRAINED_MODEL_ARCHIVE_LIST + + +class LxmertModelTester: + """You can also import this e.g from .test_modeling_bart import BartModelTester """ + + def __init__( + self, + parent, + vocab_size=300, + hidden_size=28, + num_attention_heads=2, + num_labels=2, + intermediate_size=64, + hidden_act="gelu", + hidden_dropout_prob=0.1, + attention_probs_dropout_prob=0.1, + max_position_embeddings=512, + type_vocab_size=2, + initializer_range=0.02, + layer_norm_eps=1e-12, + pad_token_id=0, + num_qa_labels=30, + num_object_labels=16, + num_attr_labels=4, + num_visual_features=10, + l_layers=2, + x_layers=1, + r_layers=1, + visual_feat_dim=128, + visual_pos_dim=4, + visual_loss_normalizer=6.67, + seq_length=20, + batch_size=4, + is_training=True, + task_matched=True, + task_mask_lm=True, + task_obj_predict=True, + task_qa=True, + visual_obj_loss=True, + visual_attr_loss=True, + visual_feat_loss=True, + use_token_type_ids=True, + use_lang_mask=True, + output_attentions=False, + output_hidden_states=False, + scope=None, + ): + self.parent = parent + self.vocab_size = vocab_size + self.hidden_size = hidden_size + self.num_attention_heads = num_attention_heads + self.num_labels = num_labels + self.intermediate_size = intermediate_size + self.hidden_act = hidden_act + self.hidden_dropout_prob = hidden_dropout_prob + self.attention_probs_dropout_prob = attention_probs_dropout_prob + self.max_position_embeddings = max_position_embeddings + self.type_vocab_size = type_vocab_size + self.initializer_range = initializer_range + self.layer_norm_eps = layer_norm_eps + self.pad_token_id = pad_token_id + self.num_qa_labels = num_qa_labels + self.num_object_labels = num_object_labels + self.num_attr_labels = num_attr_labels + self.l_layers = l_layers + self.x_layers = x_layers + self.r_layers = r_layers + self.visual_feat_dim = visual_feat_dim + self.visual_pos_dim = visual_pos_dim + self.visual_loss_normalizer = visual_loss_normalizer + self.seq_length = seq_length + self.batch_size = batch_size + self.is_training = is_training + self.use_lang_mask = use_lang_mask + self.task_matched = task_matched + self.task_mask_lm = task_mask_lm + self.task_obj_predict = task_obj_predict + self.task_qa = task_qa + self.visual_obj_loss = visual_obj_loss + self.visual_attr_loss = visual_attr_loss + self.visual_feat_loss = visual_feat_loss + self.num_visual_features = num_visual_features + self.use_token_type_ids = use_token_type_ids + self.output_attentions = output_attentions + self.output_hidden_states = output_hidden_states + self.scope = scope + self.num_hidden_layers = {"vision": r_layers, "cross_encoder": x_layers, "language": l_layers} + + def prepare_config_and_inputs(self): + + output_attentions = self.output_attentions + input_ids = ids_tensor([self.batch_size, self.seq_length], vocab_size=self.vocab_size) + visual_feats = torch.rand(self.batch_size, self.num_visual_features, self.visual_feat_dim) + bounding_boxes = torch.rand(self.batch_size, self.num_visual_features, 4) + + input_mask = None + if self.use_lang_mask: + input_mask = ids_tensor([self.batch_size, self.seq_length], vocab_size=2) + token_type_ids = None + if self.use_token_type_ids: + token_type_ids = ids_tensor([self.batch_size, self.seq_length], self.type_vocab_size) + obj_labels = None + if self.task_obj_predict: + obj_labels = {} + if self.visual_attr_loss and self.task_obj_predict: + obj_labels["attr"] = ( + ids_tensor([self.batch_size, self.num_visual_features], self.num_attr_labels), + ids_tensor([self.batch_size, self.num_visual_features], self.num_attr_labels), + ) + if self.visual_feat_loss and self.task_obj_predict: + obj_labels["feat"] = ( + ids_tensor( + [self.batch_size, self.num_visual_features, self.visual_feat_dim], self.num_visual_features + ), + ids_tensor([self.batch_size, self.num_visual_features], self.num_visual_features), + ) + if self.visual_obj_loss and self.task_obj_predict: + obj_labels["obj"] = ( + ids_tensor([self.batch_size, self.num_visual_features], self.num_object_labels), + ids_tensor([self.batch_size, self.num_visual_features], self.num_object_labels), + ) + ans = None + if self.task_qa: + ans = ids_tensor([self.batch_size], self.num_qa_labels) + masked_lm_labels = None + if self.task_mask_lm: + masked_lm_labels = ids_tensor([self.batch_size, self.seq_length], self.vocab_size) + matched_label = None + if self.task_matched: + matched_label = ids_tensor([self.batch_size], self.num_labels) + + config = LxmertConfig( + vocab_size=self.vocab_size, + hidden_size=self.hidden_size, + num_attention_heads=self.num_attention_heads, + num_labels=self.num_labels, + intermediate_size=self.intermediate_size, + hidden_act=self.hidden_act, + hidden_dropout_prob=self.hidden_dropout_prob, + attention_probs_dropout_prob=self.attention_probs_dropout_prob, + max_position_embeddings=self.max_position_embeddings, + type_vocab_size=self.type_vocab_size, + initializer_range=self.initializer_range, + layer_norm_eps=self.layer_norm_eps, + pad_token_id=self.pad_token_id, + num_qa_labels=self.num_qa_labels, + num_object_labels=self.num_object_labels, + num_attr_labels=self.num_attr_labels, + l_layers=self.l_layers, + x_layers=self.x_layers, + r_layers=self.r_layers, + visual_feat_dim=self.visual_feat_dim, + visual_pos_dim=self.visual_pos_dim, + visual_loss_normalizer=self.visual_loss_normalizer, + task_matched=self.task_matched, + task_mask_lm=self.task_mask_lm, + task_obj_predict=self.task_obj_predict, + task_qa=self.task_qa, + visual_obj_loss=self.visual_obj_loss, + visual_attr_loss=self.visual_attr_loss, + visual_feat_loss=self.visual_feat_loss, + output_attentions=self.output_attentions, + output_hidden_states=self.output_hidden_states, + ) + + return ( + config, + input_ids, + visual_feats, + bounding_boxes, + token_type_ids, + input_mask, + obj_labels, + masked_lm_labels, + matched_label, + ans, + output_attentions, + ) + + def create_and_check_lxmert_model( + self, + config, + input_ids, + visual_feats, + bounding_boxes, + token_type_ids, + input_mask, + obj_labels, + masked_lm_labels, + matched_label, + ans, + output_attentions, + ): + model = LxmertModel(config=config) + model.to(torch_device) + model.eval() + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + output_attentions=output_attentions, + ) + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + output_attentions=not output_attentions, + ) + result = model(input_ids, visual_feats, bounding_boxes, return_dict=False) + result = model(input_ids, visual_feats, bounding_boxes, return_dict=True) + + self.parent.assertEqual(result.language_output.shape, (self.batch_size, self.seq_length, self.hidden_size)) + self.parent.assertEqual( + result.vision_output.shape, (self.batch_size, self.num_visual_features, self.hidden_size) + ) + self.parent.assertEqual(result.pooled_output.shape, (self.batch_size, self.hidden_size)) + + def create_and_check_lxmert_for_question_answering( + self, + config, + input_ids, + visual_feats, + bounding_boxes, + token_type_ids, + input_mask, + obj_labels, + masked_lm_labels, + matched_label, + ans, + output_attentions, + ): + model = LxmertForQuestionAnswering(config=config) + model.to(torch_device) + model.eval() + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + labels=ans, + output_attentions=output_attentions, + return_dict=True, + ) + result = model(input_ids, visual_feats, bounding_boxes, labels=ans) + result = model( + input_ids, + visual_feats, + bounding_boxes, + labels=ans, + token_type_ids=token_type_ids, + attention_mask=input_mask, + output_attentions=output_attentions, + ) + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + labels=ans, + output_attentions=not output_attentions, + return_dict=True, + ) + + self.parent.assertEqual(result.question_answering_score.shape, (self.batch_size, self.num_qa_labels)) + + def create_and_check_lxmert_for_pretraining( + self, + config, + input_ids, + visual_feats, + bounding_boxes, + token_type_ids, + input_mask, + obj_labels, + masked_lm_labels, + matched_label, + ans, + output_attentions, + ): + model = LxmertForPreTraining(config=config) + model.to(torch_device) + model.eval() + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + masked_lm_labels=masked_lm_labels, + obj_labels=obj_labels, + matched_label=matched_label, + ans=ans, + output_attentions=output_attentions, + return_dict=True, + ) + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + masked_lm_labels=masked_lm_labels, + output_attentions=not output_attentions, + return_dict=False, + ) + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + masked_lm_labels=masked_lm_labels, + ) + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + obj_labels=obj_labels, + ) + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + matched_label=matched_label, + ) + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + ans=ans, + ) + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + masked_lm_labels=masked_lm_labels, + obj_labels=obj_labels, + matched_label=matched_label, + ans=ans, + output_attentions=not output_attentions, + return_dict=True, + ) + + self.parent.assertEqual(result.prediction_logits.shape, (self.batch_size, self.seq_length, self.vocab_size)) + + def resize_lxmert_num_qa_labels( + self, + config, + input_ids, + visual_feats, + bounding_boxes, + token_type_ids, + input_mask, + obj_labels, + masked_lm_labels, + matched_label, + ans, + output_attentions, + ): + + start_labels = config.num_qa_labels + num_large_labels = config.num_qa_labels * 2 + num_small_labels = int(config.num_qa_labels * 2) + less_labels_ans = ids_tensor([self.batch_size], num_small_labels) + more_labels_ans = ids_tensor([self.batch_size], num_large_labels) + model_pretrain = LxmertForPreTraining(config=config) + model_qa = LxmertForQuestionAnswering(config=config) + config.num_labels = num_small_labels + end_labels = config.num_labels + + result_pretrain = model_pretrain( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + ans=ans, + return_dict=True, + ) + + result_qa = model_qa( + input_ids, + visual_feats, + bounding_boxes, + labels=ans, + token_type_ids=token_type_ids, + attention_mask=input_mask, + return_dict=True, + ) + + model_pretrain.resize_num_qa_labels(num_small_labels) + model_qa.resize_num_qa_labels(num_small_labels) + + result_pretrain_less = model_pretrain( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + ans=less_labels_ans, + return_dict=True, + ) + + result_qa_less = model_qa( + input_ids, + visual_feats, + bounding_boxes, + labels=less_labels_ans, + token_type_ids=token_type_ids, + attention_mask=input_mask, + return_dict=True, + ) + + model_pretrain.resize_num_qa_labels(num_large_labels) + model_qa.resize_num_qa_labels(num_large_labels) + + result_pretrain_more = model_pretrain( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + ans=more_labels_ans, + return_dict=True, + ) + + result_qa_more = model_qa( + input_ids, + visual_feats, + bounding_boxes, + labels=more_labels_ans, + token_type_ids=token_type_ids, + attention_mask=input_mask, + return_dict=True, + ) + + model_qa_labels = model_qa.num_qa_labels + + self.parent.assertNotEqual(start_labels, end_labels) + self.parent.assertNotEqual(model_qa_labels, start_labels) + self.parent.assertEqual(result_qa.question_answering_score.shape, (self.batch_size, start_labels)) + self.parent.assertEqual(result_pretrain.question_answering_score.shape, (self.batch_size, start_labels)) + self.parent.assertEqual(result_qa_less.question_answering_score.shape, (self.batch_size, num_small_labels)) + self.parent.assertEqual( + result_pretrain_less.question_answering_score.shape, (self.batch_size, num_small_labels) + ) + self.parent.assertEqual(result_qa_more.question_answering_score.shape, (self.batch_size, num_large_labels)) + self.parent.assertEqual( + result_pretrain_more.question_answering_score.shape, (self.batch_size, num_large_labels) + ) + + def prepare_config_and_inputs_for_common(self): + config_and_inputs = self.prepare_config_and_inputs() + ( + config, + input_ids, + visual_feats, + bounding_boxes, + token_type_ids, + input_mask, + obj_labels, + masked_lm_labels, + matched_label, + ans, + output_attentions, + ) = config_and_inputs + + inputs_dict = { + "input_ids": input_ids, + "visual_feats": visual_feats, + "visual_pos": bounding_boxes, + "token_type_ids": token_type_ids, + "attention_mask": input_mask, + } + + return config, inputs_dict + + +@require_torch +class LxmertModelTest(ModelTesterMixin, unittest.TestCase): + + all_model_classes = (LxmertModel, LxmertForPreTraining, LxmertForQuestionAnswering) if is_torch_available() else () + + test_head_masking = False + test_pruning = False + test_torchscript = False + + test_head_masking = False + test_pruning = False + test_torchscript = False + + def setUp(self): + self.model_tester = LxmertModelTester(self) + self.config_tester = ConfigTester(self, config_class=LxmertConfig, hidden_size=37) + + def test_config(self): + self.config_tester.run_common_tests() + + def test_lxmert_model(self): + config_and_inputs = self.model_tester.prepare_config_and_inputs() + self.model_tester.create_and_check_lxmert_model(*config_and_inputs) + + def test_lxmert_question_answering(self): + config_and_inputs = self.model_tester.prepare_config_and_inputs() + self.model_tester.create_and_check_lxmert_for_question_answering(*config_and_inputs) + + def test_lxmert_pretraining(self): + config_and_inputs = self.model_tester.prepare_config_and_inputs() + self.model_tester.create_and_check_lxmert_for_pretraining(*config_and_inputs) + + def test_lxmert_question_answering_labels_resize(self): + config_and_inputs = self.model_tester.prepare_config_and_inputs() + self.model_tester.resize_lxmert_num_qa_labels(*config_and_inputs) + + @slow + def test_model_from_pretrained(self): + for model_name in LXMERT_PRETRAINED_MODEL_ARCHIVE_LIST[:1]: + model = LxmertModel.from_pretrained(model_name) + self.assertIsNotNone(model) + + def test_attention_outputs(self): + config, inputs_dict = self.model_tester.prepare_config_and_inputs_for_common() + seq_len = getattr(self.model_tester, "seq_length", None) + encoder_seq_length = getattr(self.model_tester, "encoder_seq_length", seq_len) + encoder_key_length = getattr(self.model_tester, "key_length", encoder_seq_length) + chunk_length = getattr(self.model_tester, "chunk_length", None) + if chunk_length is not None and hasattr(self.model_tester, "num_hashes"): + encoder_seq_length = encoder_seq_length * self.model_tester.num_hashes + + for model_class in self.all_model_classes: + inputs_dict["output_attentions"] = True + inputs_dict["output_hidden_states"] = False + model = model_class(config) + model.to(torch_device) + model.eval() + with torch.no_grad(): + outputs = model(**self._prepare_for_class(inputs_dict, model_class)) + + language_attentions, vision_attentions, cross_encoder_attentions = (outputs[-3], outputs[-2], outputs[-1]) + + self.assertEqual(len(language_attentions), self.model_tester.num_hidden_layers["language"]) + self.assertEqual(len(vision_attentions), self.model_tester.num_hidden_layers["vision"]) + self.assertEqual(len(cross_encoder_attentions), self.model_tester.num_hidden_layers["cross_encoder"]) + + # check that output_attentions also work using config + del inputs_dict["output_attentions"] + config.output_attentions = True + model = model_class(config) + model.to(torch_device) + model.eval() + with torch.no_grad(): + outputs = model(**self._prepare_for_class(inputs_dict, model_class)) + + language_attentions, vision_attentions, cross_encoder_attentions = (outputs[-3], outputs[-2], outputs[-1]) + self.assertEqual(len(language_attentions), self.model_tester.num_hidden_layers["language"]) + self.assertEqual(len(vision_attentions), self.model_tester.num_hidden_layers["vision"]) + self.assertEqual(len(cross_encoder_attentions), self.model_tester.num_hidden_layers["cross_encoder"]) + + attentions = [language_attentions, vision_attentions, cross_encoder_attentions] + attention_shapes = [ + [self.model_tester.num_attention_heads, encoder_seq_length, encoder_key_length], + [ + self.model_tester.num_attention_heads, + self.model_tester.num_visual_features, + self.model_tester.num_visual_features, + ], + [self.model_tester.num_attention_heads, encoder_key_length, self.model_tester.num_visual_features], + ] + + for attention, attention_shape in zip(attentions, attention_shapes): + self.assertListEqual(list(attention[0].shape[-3:]), attention_shape) + out_len = len(outputs) + + # Check attention is always last and order is fine + inputs_dict["output_attentions"] = True + inputs_dict["output_hidden_states"] = True + model = model_class(config) + model.to(torch_device) + model.eval() + with torch.no_grad(): + outputs = model(**self._prepare_for_class(inputs_dict, model_class)) + + # 2 hidden states were added + self.assertEqual(out_len + 2, len(outputs)) + + language_attentions, vision_attentions, cross_encoder_attentions = (outputs[-3], outputs[-2], outputs[-1]) + self.assertEqual(len(language_attentions), self.model_tester.num_hidden_layers["language"]) + self.assertEqual(len(vision_attentions), self.model_tester.num_hidden_layers["vision"]) + self.assertEqual(len(cross_encoder_attentions), self.model_tester.num_hidden_layers["cross_encoder"]) + + attentions = [language_attentions, vision_attentions, cross_encoder_attentions] + attention_shapes = [ + [self.model_tester.num_attention_heads, encoder_seq_length, encoder_key_length], + [ + self.model_tester.num_attention_heads, + self.model_tester.num_visual_features, + self.model_tester.num_visual_features, + ], + [self.model_tester.num_attention_heads, encoder_key_length, self.model_tester.num_visual_features], + ] + + for attention, attention_shape in zip(attentions, attention_shapes): + self.assertListEqual(list(attention[0].shape[-3:]), attention_shape) + + def test_hidden_states_output(self): + def check_hidden_states_output(inputs_dict, config, model_class): + model = model_class(config) + model.to(torch_device) + model.eval() + + with torch.no_grad(): + outputs = model(**self._prepare_for_class(inputs_dict, model_class)) + language_hidden_states, vision_hidden_states = outputs[-2], outputs[-1] + + self.assertEqual(len(language_hidden_states), self.model_tester.num_hidden_layers["language"] + 1) + self.assertEqual(len(vision_hidden_states), self.model_tester.num_hidden_layers["vision"] + 1) + + seq_length = self.model_tester.seq_length + num_visual_features = self.model_tester.num_visual_features + + self.assertListEqual( + list(language_hidden_states[0].shape[-2:]), + [seq_length, self.model_tester.hidden_size], + ) + self.assertListEqual( + list(vision_hidden_states[0].shape[-2:]), + [num_visual_features, self.model_tester.hidden_size], + ) + + config, inputs_dict = self.model_tester.prepare_config_and_inputs_for_common() + + for model_class in self.all_model_classes: + inputs_dict["output_hidden_states"] = True + check_hidden_states_output(inputs_dict, config, model_class) + + # check that output_hidden_states also work using config + del inputs_dict["output_hidden_states"] + config.output_hidden_states = True + + check_hidden_states_output(inputs_dict, config, model_class) diff --git a/tests/test_modeling_tf_lxmert.py b/tests/test_modeling_tf_lxmert.py new file mode 100644 index 0000000000..89c67c9290 --- /dev/null +++ b/tests/test_modeling_tf_lxmert.py @@ -0,0 +1,680 @@ +# coding=utf-8 +# Copyright 2018 XXX Authors. +# +# 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. +import tempfile +import unittest + +from transformers import LxmertConfig, is_tf_available +from transformers.testing_utils import require_tf, slow + +from .test_configuration_common import ConfigTester +from .test_modeling_tf_common import TFModelTesterMixin, ids_tensor + + +if is_tf_available(): + import tensorflow as tf + + from transformers.modeling_tf_lxmert import TFLxmertForPreTraining, TFLxmertModel + + +class TFLxmertModelTester(object): + def __init__( + self, + parent, + vocab_size=300, + hidden_size=28, + num_attention_heads=2, + num_labels=2, + intermediate_size=64, + hidden_act="gelu", + hidden_dropout_prob=0.1, + attention_probs_dropout_prob=0.1, + max_position_embeddings=512, + type_vocab_size=2, + initializer_range=0.02, + layer_norm_eps=1e-12, + pad_token_id=0, + num_qa_labels=30, + num_object_labels=16, + num_attr_labels=4, + num_visual_features=10, + l_layers=2, + x_layers=1, + r_layers=1, + visual_feat_dim=128, + visual_pos_dim=4, + visual_loss_normalizer=6.67, + seq_length=20, + batch_size=8, + is_training=True, + task_matched=True, + task_mask_lm=True, + task_obj_predict=True, + task_qa=True, + visual_obj_loss=True, + visual_attr_loss=True, + visual_feat_loss=True, + use_token_type_ids=True, + use_lang_mask=True, + output_attentions=False, + output_hidden_states=False, + scope=None, + ): + self.parent = parent + self.vocab_size = vocab_size + self.hidden_size = hidden_size + self.num_attention_heads = num_attention_heads + self.num_labels = num_labels + self.intermediate_size = intermediate_size + self.hidden_act = hidden_act + self.hidden_dropout_prob = hidden_dropout_prob + self.attention_probs_dropout_prob = attention_probs_dropout_prob + self.max_position_embeddings = max_position_embeddings + self.type_vocab_size = type_vocab_size + self.initializer_range = initializer_range + self.layer_norm_eps = layer_norm_eps + self.pad_token_id = pad_token_id + self.num_qa_labels = num_qa_labels + self.num_object_labels = num_object_labels + self.num_attr_labels = num_attr_labels + self.l_layers = l_layers + self.x_layers = x_layers + self.r_layers = r_layers + self.visual_feat_dim = visual_feat_dim + self.visual_pos_dim = visual_pos_dim + self.visual_loss_normalizer = visual_loss_normalizer + self.seq_length = seq_length + self.batch_size = batch_size + self.is_training = is_training + self.use_lang_mask = use_lang_mask + self.task_matched = task_matched + self.task_mask_lm = task_mask_lm + self.task_obj_predict = task_obj_predict + self.task_qa = task_qa + self.visual_obj_loss = visual_obj_loss + self.visual_attr_loss = visual_attr_loss + self.visual_feat_loss = visual_feat_loss + self.num_visual_features = num_visual_features + self.use_token_type_ids = use_token_type_ids + self.output_attentions = output_attentions + self.output_hidden_states = output_hidden_states + self.scope = scope + self.num_hidden_layers = {"vision": r_layers, "cross_encoder": x_layers, "language": l_layers} + + def prepare_config_and_inputs(self): + output_attentions = self.output_attentions + input_ids = ids_tensor([self.batch_size, self.seq_length], vocab_size=self.vocab_size) + visual_feats = tf.random.uniform((self.batch_size, self.num_visual_features, self.visual_feat_dim)) + bounding_boxes = tf.random.uniform((self.batch_size, self.num_visual_features, 4)) + + input_mask = None + if self.use_lang_mask: + input_mask = ids_tensor([self.batch_size, self.seq_length], vocab_size=2) + token_type_ids = None + if self.use_token_type_ids: + token_type_ids = ids_tensor([self.batch_size, self.seq_length], self.type_vocab_size) + obj_labels = None + if self.task_obj_predict: + obj_labels = {} + if self.visual_attr_loss and self.task_obj_predict: + obj_labels["attr"] = ( + ids_tensor([self.batch_size, self.num_visual_features], self.num_attr_labels), + ids_tensor([self.batch_size, self.num_visual_features], self.num_attr_labels), + ) + if self.visual_feat_loss and self.task_obj_predict: + obj_labels["feat"] = ( + ids_tensor( + [self.batch_size, self.num_visual_features, self.visual_feat_dim], self.num_visual_features + ), + ids_tensor([self.batch_size, self.num_visual_features], self.num_visual_features), + ) + if self.visual_obj_loss and self.task_obj_predict: + obj_labels["obj"] = ( + ids_tensor([self.batch_size, self.num_visual_features], self.num_object_labels), + ids_tensor([self.batch_size, self.num_visual_features], self.num_object_labels), + ) + ans = None + if self.task_qa: + ans = ids_tensor([self.batch_size], self.num_qa_labels) + masked_lm_labels = None + if self.task_mask_lm: + masked_lm_labels = ids_tensor([self.batch_size, self.seq_length], self.vocab_size) + matched_label = None + if self.task_matched: + matched_label = ids_tensor([self.batch_size], self.num_labels) + + config = LxmertConfig( + vocab_size=self.vocab_size, + hidden_size=self.hidden_size, + num_attention_heads=self.num_attention_heads, + num_labels=self.num_labels, + intermediate_size=self.intermediate_size, + hidden_act=self.hidden_act, + hidden_dropout_prob=self.hidden_dropout_prob, + attention_probs_dropout_prob=self.attention_probs_dropout_prob, + max_position_embeddings=self.max_position_embeddings, + type_vocab_size=self.type_vocab_size, + initializer_range=self.initializer_range, + layer_norm_eps=self.layer_norm_eps, + pad_token_id=self.pad_token_id, + num_qa_labels=self.num_qa_labels, + num_object_labels=self.num_object_labels, + num_attr_labels=self.num_attr_labels, + l_layers=self.l_layers, + x_layers=self.x_layers, + r_layers=self.r_layers, + visual_feat_dim=self.visual_feat_dim, + visual_pos_dim=self.visual_pos_dim, + visual_loss_normalizer=self.visual_loss_normalizer, + task_matched=self.task_matched, + task_mask_lm=self.task_mask_lm, + task_obj_predict=self.task_obj_predict, + task_qa=self.task_qa, + visual_obj_loss=self.visual_obj_loss, + visual_attr_loss=self.visual_attr_loss, + visual_feat_loss=self.visual_feat_loss, + output_attentions=self.output_attentions, + output_hidden_states=self.output_hidden_states, + ) + + return ( + config, + input_ids, + visual_feats, + bounding_boxes, + token_type_ids, + input_mask, + obj_labels, + masked_lm_labels, + matched_label, + ans, + output_attentions, + ) + + def create_and_check_lxmert_model( + self, + config, + input_ids, + visual_feats, + bounding_boxes, + token_type_ids, + input_mask, + obj_labels, + masked_lm_labels, + matched_label, + ans, + output_attentions, + ): + model = TFLxmertModel(config=config) + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + output_attentions=output_attentions, + ) + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + output_attentions=not output_attentions, + ) + result = model(input_ids, visual_feats, bounding_boxes, return_dict=False) + result = model(input_ids, visual_feats, bounding_boxes, return_dict=True) + + self.parent.assertEqual(result.language_output.shape, (self.batch_size, self.seq_length, self.hidden_size)) + self.parent.assertEqual( + result.vision_output.shape, (self.batch_size, self.num_visual_features, self.hidden_size) + ) + self.parent.assertEqual(result.pooled_output.shape, (self.batch_size, self.hidden_size)) + + def prepare_config_and_inputs_for_common(self, return_obj_labels=False): + config_and_inputs = self.prepare_config_and_inputs() + ( + config, + input_ids, + visual_feats, + bounding_boxes, + token_type_ids, + input_mask, + obj_labels, + masked_lm_labels, + matched_label, + ans, + output_attentions, + ) = config_and_inputs + + inputs_dict = { + "input_ids": input_ids, + "visual_feats": visual_feats, + "visual_pos": bounding_boxes, + "token_type_ids": token_type_ids, + "attention_mask": input_mask, + } + + if return_obj_labels: + inputs_dict["obj_labels"] = obj_labels + + return config, inputs_dict + + def create_and_check_lxmert_for_pretraining( + self, + config, + input_ids, + visual_feats, + bounding_boxes, + token_type_ids, + input_mask, + obj_labels, + masked_lm_labels, + matched_label, + ans, + output_attentions, + ): + model = TFLxmertForPreTraining(config=config) + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + masked_lm_labels=masked_lm_labels, + obj_labels=obj_labels, + matched_label=matched_label, + ans=ans, + output_attentions=output_attentions, + return_dict=True, + ) + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + masked_lm_labels=masked_lm_labels, + output_attentions=not output_attentions, + return_dict=False, + ) + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + masked_lm_labels=masked_lm_labels, + ) + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + obj_labels=obj_labels, + ) + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + matched_label=matched_label, + ) + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + ans=ans, + ) + result = model( + input_ids, + visual_feats, + bounding_boxes, + token_type_ids=token_type_ids, + attention_mask=input_mask, + masked_lm_labels=masked_lm_labels, + obj_labels=obj_labels, + matched_label=matched_label, + ans=ans, + output_attentions=not output_attentions, + return_dict=True, + ) + + self.parent.assertEqual(result.prediction_logits.shape, (self.batch_size, self.seq_length, self.vocab_size)) + + +@require_tf +class TFLxmertModelTest(TFModelTesterMixin, unittest.TestCase): + + all_model_classes = (TFLxmertModel, TFLxmertForPreTraining) if is_tf_available() else () + + def setUp(self): + self.model_tester = TFLxmertModelTester(self) + self.config_tester = ConfigTester(self, config_class=LxmertConfig, hidden_size=37) + + def test_config(self): + self.config_tester.run_common_tests() + + def test_lxmert_model(self): + config_and_inputs = self.model_tester.prepare_config_and_inputs() + self.model_tester.create_and_check_lxmert_model(*config_and_inputs) + + def test_lxmert_for_pretraining(self): + config_and_inputs = self.model_tester.prepare_config_and_inputs() + self.model_tester.create_and_check_lxmert_for_pretraining(*config_and_inputs) + + @slow + def test_model_from_pretrained(self): + for model_name in ["unc-nlp/lxmert-base-uncased"]: + model = TFLxmertModel.from_pretrained(model_name) + self.assertIsNotNone(model) + + def test_attention_outputs(self): + config, inputs_dict = self.model_tester.prepare_config_and_inputs_for_common() + + encoder_seq_length = ( + self.model_tester.encoder_seq_length + if hasattr(self.model_tester, "encoder_seq_length") + else self.model_tester.seq_length + ) + encoder_key_length = ( + self.model_tester.key_length if hasattr(self.model_tester, "key_length") else encoder_seq_length + ) + + for model_class in self.all_model_classes: + inputs_dict["output_attentions"] = True + inputs_dict["output_hidden_states"] = False + model = model_class(config) + outputs = model(self._prepare_for_class(inputs_dict, model_class)) + language_attentions, vision_attentions, cross_encoder_attentions = (outputs[-3], outputs[-2], outputs[-1]) + + self.assertEqual(model.config.output_hidden_states, False) + + self.assertEqual(len(language_attentions), self.model_tester.num_hidden_layers["language"]) + self.assertEqual(len(vision_attentions), self.model_tester.num_hidden_layers["vision"]) + self.assertEqual(len(cross_encoder_attentions), self.model_tester.num_hidden_layers["cross_encoder"]) + + attentions = [language_attentions, vision_attentions, cross_encoder_attentions] + attention_shapes = [ + [self.model_tester.num_attention_heads, encoder_seq_length, encoder_key_length], + [ + self.model_tester.num_attention_heads, + self.model_tester.num_visual_features, + self.model_tester.num_visual_features, + ], + [self.model_tester.num_attention_heads, encoder_key_length, self.model_tester.num_visual_features], + ] + + for attention, attention_shape in zip(attentions, attention_shapes): + self.assertListEqual(list(attention[0].shape[-3:]), attention_shape) + out_len = len(outputs) + + # Check attention is always last and order is fine + inputs_dict["output_attentions"] = True + inputs_dict["output_hidden_states"] = True + model = model_class(config) + outputs = model(self._prepare_for_class(inputs_dict, model_class)) + + # 2 hidden states were added + self.assertEqual(out_len + 2, len(outputs)) + language_attentions, vision_attentions, cross_encoder_attentions = (outputs[-3], outputs[-2], outputs[-1]) + self.assertEqual(len(language_attentions), self.model_tester.num_hidden_layers["language"]) + self.assertEqual(len(vision_attentions), self.model_tester.num_hidden_layers["vision"]) + self.assertEqual(len(cross_encoder_attentions), self.model_tester.num_hidden_layers["cross_encoder"]) + + attentions = [language_attentions, vision_attentions, cross_encoder_attentions] + attention_shapes = [ + [self.model_tester.num_attention_heads, encoder_seq_length, encoder_key_length], + [ + self.model_tester.num_attention_heads, + self.model_tester.num_visual_features, + self.model_tester.num_visual_features, + ], + [self.model_tester.num_attention_heads, encoder_key_length, self.model_tester.num_visual_features], + ] + + for attention, attention_shape in zip(attentions, attention_shapes): + self.assertListEqual(list(attention[0].shape[-3:]), attention_shape) + + def test_hidden_states_output(self): + config, inputs_dict = self.model_tester.prepare_config_and_inputs_for_common() + + def check_hidden_states_output(config, inputs_dict, model_class): + model = model_class(config) + outputs = model(self._prepare_for_class(inputs_dict, model_class)) + language_hidden_states, vision_hidden_states = outputs[-2], outputs[-1] + + self.assertEqual(len(language_hidden_states), self.model_tester.num_hidden_layers["language"] + 1) + self.assertEqual(len(vision_hidden_states), self.model_tester.num_hidden_layers["vision"] + 1) + + seq_length = self.model_tester.seq_length + num_visual_features = self.model_tester.num_visual_features + + self.assertListEqual( + list(language_hidden_states[0].shape[-2:]), + [seq_length, self.model_tester.hidden_size], + ) + self.assertListEqual( + list(vision_hidden_states[0].shape[-2:]), + [num_visual_features, self.model_tester.hidden_size], + ) + + for model_class in self.all_model_classes: + inputs_dict["output_hidden_states"] = True + check_hidden_states_output(config, inputs_dict, model_class) + + del inputs_dict["output_hidden_states"] + config.output_hidden_states = True + check_hidden_states_output(config, inputs_dict, model_class) + + def test_pt_tf_model_equivalence(self): + from transformers import is_torch_available + + if not is_torch_available(): + return + + import torch + + import transformers + + for model_class in self.all_model_classes: + config, inputs_dict = self.model_tester.prepare_config_and_inputs_for_common( + return_obj_labels="PreTraining" in model_class.__name__ + ) + + pt_model_class_name = model_class.__name__[2:] # Skip the "TF" at the beggining + pt_model_class = getattr(transformers, pt_model_class_name) + + config.output_hidden_states = True + config.task_obj_predict = False + + tf_model = model_class(config) + pt_model = pt_model_class(config) + + # Check we can load pt model in tf and vice-versa with model => model functions + + tf_model = transformers.load_pytorch_model_in_tf2_model( + tf_model, pt_model, tf_inputs=self._prepare_for_class(inputs_dict, model_class) + ) + pt_model = transformers.load_tf2_model_in_pytorch_model(pt_model, tf_model) + + # Check predictions on first output (logits/hidden-states) are close enought given low-level computational differences + pt_model.eval() + + # Delete obj labels as we want to compute the hidden states and not the loss + + if "obj_labels" in inputs_dict: + del inputs_dict["obj_labels"] + + def torch_type(key): + if key in ("visual_feats", "visual_pos"): + return torch.float32 + else: + return torch.long + + def recursive_numpy_convert(iterable): + return_dict = {} + for key, value in iterable.items(): + if isinstance(value, dict): + return_dict[key] = recursive_numpy_convert(value) + else: + if isinstance(value, (list, tuple)): + return_dict[key] = ( + torch.from_numpy(iter_value.numpy()).to(torch_type(key)) for iter_value in value + ) + else: + return_dict[key] = torch.from_numpy(value.numpy()).to(torch_type(key)) + return return_dict + + pt_inputs_dict = recursive_numpy_convert(self._prepare_for_class(inputs_dict, model_class)) + + # need to rename encoder-decoder "inputs" for PyTorch + if "inputs" in pt_inputs_dict and self.is_encoder_decoder: + pt_inputs_dict["input_ids"] = pt_inputs_dict.pop("inputs") + + with torch.no_grad(): + pto = pt_model(**pt_inputs_dict) + tfo = tf_model(self._prepare_for_class(inputs_dict, model_class), training=False) + tf_hidden_states = tfo[0].numpy() + pt_hidden_states = pto[0].numpy() + + import numpy as np + + tf_nans = np.copy(np.isnan(tf_hidden_states)) + pt_nans = np.copy(np.isnan(pt_hidden_states)) + + pt_hidden_states[tf_nans] = 0 + tf_hidden_states[tf_nans] = 0 + pt_hidden_states[pt_nans] = 0 + tf_hidden_states[pt_nans] = 0 + + max_diff = np.amax(np.abs(tf_hidden_states - pt_hidden_states)) + # Debug info (remove when fixed) + if max_diff >= 2e-2: + print("===") + print(model_class) + print(config) + print(inputs_dict) + print(pt_inputs_dict) + self.assertLessEqual(max_diff, 6e-2) + + # Check we can load pt model in tf and vice-versa with checkpoint => model functions + with tempfile.TemporaryDirectory() as tmpdirname: + import os + + pt_checkpoint_path = os.path.join(tmpdirname, "pt_model.bin") + torch.save(pt_model.state_dict(), pt_checkpoint_path) + tf_model = transformers.load_pytorch_checkpoint_in_tf2_model(tf_model, pt_checkpoint_path) + + tf_checkpoint_path = os.path.join(tmpdirname, "tf_model.h5") + tf_model.save_weights(tf_checkpoint_path) + pt_model = transformers.load_tf2_checkpoint_in_pytorch_model(pt_model, tf_checkpoint_path) + + # Check predictions on first output (logits/hidden-states) are close enought given low-level computational differences + pt_model.eval() + pt_inputs_dict = dict( + (name, torch.from_numpy(key.numpy()).to(torch.long)) + for name, key in self._prepare_for_class(inputs_dict, model_class).items() + ) + + for key, value in pt_inputs_dict.items(): + if key in ("visual_feats", "visual_pos"): + pt_inputs_dict[key] = value.to(torch.float32) + else: + pt_inputs_dict[key] = value.to(torch.long) + + with torch.no_grad(): + pto = pt_model(**pt_inputs_dict) + tfo = tf_model(self._prepare_for_class(inputs_dict, model_class)) + tfo = tfo[0].numpy() + pto = pto[0].numpy() + tf_nans = np.copy(np.isnan(tfo)) + pt_nans = np.copy(np.isnan(pto)) + + pto[tf_nans] = 0 + tfo[tf_nans] = 0 + pto[pt_nans] = 0 + tfo[pt_nans] = 0 + + max_diff = np.amax(np.abs(tfo - pto)) + self.assertLessEqual(max_diff, 6e-2) + + def test_save_load(self): + for model_class in self.all_model_classes: + config, inputs_dict = self.model_tester.prepare_config_and_inputs_for_common( + return_obj_labels="PreTraining" in model_class.__name__ + ) + + model = model_class(config) + outputs = model(self._prepare_for_class(inputs_dict, model_class)) + + with tempfile.TemporaryDirectory() as tmpdirname: + model.save_pretrained(tmpdirname) + model = model_class.from_pretrained(tmpdirname) + after_outputs = model(self._prepare_for_class(inputs_dict, model_class)) + + self.assert_outputs_same(after_outputs, outputs) + + def test_compile_tf_model(self): + optimizer = tf.keras.optimizers.Adam(learning_rate=3e-5, epsilon=1e-08, clipnorm=1.0) + loss = tf.keras.losses.SparseCategoricalCrossentropy(from_logits=True) + metric = tf.keras.metrics.SparseCategoricalAccuracy("accuracy") + + for model_class in self.all_model_classes: + config, inputs_dict = self.model_tester.prepare_config_and_inputs_for_common( + return_obj_labels="PreTraining" in model_class.__name__ + ) + + input_ids = tf.keras.Input( + batch_shape=(self.model_tester.batch_size, self.model_tester.seq_length), + name="input_ids", + dtype="int32", + ) + visual_feats = tf.keras.Input( + batch_shape=( + self.model_tester.batch_size, + self.model_tester.num_visual_features, + self.model_tester.visual_feat_dim, + ), + name="visual_feats", + dtype="int32", + ) + visual_pos = tf.keras.Input( + batch_shape=(self.model_tester.batch_size, self.model_tester.num_visual_features, 4), + name="visual_pos", + dtype="int32", + ) + + # Prepare our model + model = model_class(config) + + # Let's load it from the disk to be sure we can use pretrained weights + with tempfile.TemporaryDirectory() as tmpdirname: + outputs = model(self._prepare_for_class(inputs_dict, model_class)) # build the model + model.save_pretrained(tmpdirname) + model = model_class.from_pretrained(tmpdirname) + + outputs_dict = model(input_ids, visual_feats, visual_pos) + hidden_states = outputs_dict[0] + + # Add a dense layer on top to test integration with other keras modules + outputs = tf.keras.layers.Dense(2, activation="softmax", name="outputs")(hidden_states) + + # Compile extended model + extended_model = tf.keras.Model(inputs=[input_ids, visual_feats, visual_pos], outputs=[outputs]) + extended_model.compile(optimizer=optimizer, loss=loss, metrics=[metric]) diff --git a/tests/test_tokenization_lxmert.py b/tests/test_tokenization_lxmert.py new file mode 100644 index 0000000000..e3c157568c --- /dev/null +++ b/tests/test_tokenization_lxmert.py @@ -0,0 +1,65 @@ +# coding=utf-8 +# Copyright 2018 LXMERT Authors. +# +# 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. + + +import os +import unittest + +from transformers.tokenization_bert import VOCAB_FILES_NAMES +from transformers.tokenization_lxmert import LxmertTokenizer + +from .test_tokenization_common import TokenizerTesterMixin + + +class LxmertTokenizationTest(TokenizerTesterMixin, unittest.TestCase): + + tokenizer_class = LxmertTokenizer + + def setUp(self): + super().setUp() + + vocab_tokens = [ + "[UNK]", + "[CLS]", + "[SEP]", + "want", + "##want", + "##ed", + "wa", + "un", + "runn", + "##ing", + ",", + "low", + "lowest", + ] + self.vocab_file = os.path.join(self.tmpdirname, VOCAB_FILES_NAMES["vocab_file"]) + with open(self.vocab_file, "w", encoding="utf-8") as vocab_writer: + vocab_writer.write("".join([x + "\n" for x in vocab_tokens])) + + def get_tokenizer(self, **kwargs): + return LxmertTokenizer.from_pretrained(self.tmpdirname, **kwargs) + + def get_input_output_texts(self, tokenizer): + input_text = "UNwant\u00E9d,running" + output_text = "unwanted, running" + return input_text, output_text + + def test_full_tokenizer(self): + tokenizer = self.tokenizer_class(self.vocab_file) + + tokens = tokenizer.tokenize("UNwant\u00E9d,running") + self.assertListEqual(tokens, ["un", "##want", "##ed", ",", "runn", "##ing"]) + self.assertListEqual(tokenizer.convert_tokens_to_ids(tokens), [7, 4, 5, 10, 8, 9])