|
|
| import os |
| from typing import Optional, Union |
| from transformers import AutoModel, PreTrainedModel, AutoConfig, BertModel |
| from transformers.modeling_outputs import TokenClassifierOutput |
| from torch import nn |
| from torch.nn import CrossEntropyLoss |
|
|
| from typing import List, Optional |
|
|
| import torch |
| from itertools import islice |
| from .configuration_bionexttager import BioNExtTaggerConfig |
|
|
|
|
| NUM_PER_LAYER = 16 |
|
|
| class BioNExtTaggerModel(PreTrainedModel): |
| config_class = BioNExtTaggerConfig |
| _keys_to_ignore_on_load_unexpected = [r"pooler"] |
|
|
| def __init__(self, config): |
| super().__init__(config) |
| self.num_labels = config.num_labels |
| |
| self.bert = BertModel(config, add_pooling_layer=False) |
| |
| |
| |
| |
| |
| |
| self.dropout = nn.Dropout(config.hidden_dropout_prob) |
| self.dense = nn.Linear(config.hidden_size, config.hidden_size) |
| self.dense_activation = nn.GELU(approximate='none') |
| self.classifier = nn.Linear(config.hidden_size, config.num_labels) |
| self.crf = CRF(num_tags=config.num_labels, batch_first=True) |
| self.reduction=config.crf_reduction |
| |
| if self.config.freeze == True: |
| self.manage_freezing() |
| |
| |
| |
| def manage_freezing(self): |
| for _, param in self.bert.embeddings.named_parameters(): |
| param.requires_grad = False |
| |
| num_encoders_to_freeze = self.config.num_frozen_encoder |
| if num_encoders_to_freeze > 0: |
| for _, param in islice(self.bert.encoder.named_parameters(), num_encoders_to_freeze*NUM_PER_LAYER): |
| param.requires_grad = False |
| |
| |
| def forward(self, |
| input_ids=None, |
| attention_mask=None, |
| token_type_ids=None, |
| position_ids=None, |
| head_mask=None, |
| inputs_embeds=None, |
| labels=None, |
| output_attentions=None, |
| output_hidden_states=None, |
| return_dict=None |
| ): |
| |
| return_dict = return_dict if return_dict is not None else self.config.use_return_dict |
| |
| outputs = self.bert(input_ids, |
| attention_mask=attention_mask, |
| token_type_ids=token_type_ids, |
| position_ids=position_ids, |
| head_mask=head_mask, |
| inputs_embeds=inputs_embeds, |
| output_attentions=output_attentions, |
| output_hidden_states=output_hidden_states, |
| return_dict=return_dict) |
|
|
| sequence_output = outputs[0] |
| sequence_output = self.dropout(sequence_output) |
| dense_output = self.dense(sequence_output) |
| dense_output = self.dense_activation(dense_output) |
| logits = self.classifier(dense_output) |
| |
|
|
| loss = None |
| if labels is not None: |
| |
| |
| |
| return self.crf(logits, labels, reduction=self.reduction), logits |
| else: |
| |
| |
| return torch.Tensor(self.crf.decode(logits)) |
|
|
|
|
|
|
| |
|
|
|
|
|
|
| LARGE_NEGATIVE_NUMBER = -1e9 |
|
|
| class CRF(nn.Module): |
| """Conditional random field. |
| This module implements a conditional random field [LMP01]_. The forward computation |
| of this class computes the log likelihood of the given sequence of tags and |
| emission score tensor. This class also has `~CRF.decode` method which finds |
| the best tag sequence given an emission score tensor using `Viterbi algorithm`_. |
| Args: |
| num_tags: Number of tags. |
| batch_first: Whether the first dimension corresponds to the size of a minibatch. |
| Attributes: |
| start_transitions (`~torch.nn.Parameter`): Start transition score tensor of size |
| ``(num_tags,)``. |
| end_transitions (`~torch.nn.Parameter`): End transition score tensor of size |
| ``(num_tags,)``. |
| transitions (`~torch.nn.Parameter`): Transition score tensor of size |
| ``(num_tags, num_tags)``. |
| .. [LMP01] Lafferty, J., McCallum, A., Pereira, F. (2001). |
| "Conditional random fields: Probabilistic models for segmenting and |
| labeling sequence data". *Proc. 18th International Conf. on Machine |
| Learning*. Morgan Kaufmann. pp. 282–289. |
| .. _Viterbi algorithm: https://en.wikipedia.org/wiki/Viterbi_algorithm |
| """ |
|
|
| def __init__(self, num_tags: int, batch_first: bool = False) -> None: |
| if num_tags <= 0: |
| raise ValueError(f'invalid number of tags: {num_tags}') |
| super().__init__() |
| self.num_tags = num_tags |
| self.batch_first = batch_first |
| self.start_transitions = nn.Parameter(torch.empty(num_tags)) |
| self.end_transitions = nn.Parameter(torch.empty(num_tags)) |
| self.transitions = nn.Parameter(torch.empty(num_tags, num_tags)) |
|
|
| self.reset_parameters() |
| self.mask_impossible_transitions() |
|
|
| def reset_parameters(self) -> None: |
| """Initialize the transition parameters. |
| The parameters will be initialized randomly from a uniform distribution |
| between -0.1 and 0.1. |
| """ |
| nn.init.uniform_(self.start_transitions, -0.1, 0.1) |
| nn.init.uniform_(self.end_transitions, -0.1, 0.1) |
| nn.init.uniform_(self.transitions, -0.1, 0.1) |
| |
| def mask_impossible_transitions(self) -> None: |
| """Set the value of impossible transitions to LARGE_NEGATIVE_NUMBER |
| - start transition value of I-X |
| - transition score of O -> I |
| """ |
| with torch.no_grad(): |
| |
| for i in range(6): |
| self.start_transitions[i*2+2] = LARGE_NEGATIVE_NUMBER |
| |
| self.transitions[0][i*2+2] = LARGE_NEGATIVE_NUMBER |
| |
| |
| for j in range(6): |
| if j!=i: |
| self.transitions[i*2+1][j*2+2] = LARGE_NEGATIVE_NUMBER |
| self.transitions[i*2+2][j*2+2] = LARGE_NEGATIVE_NUMBER |
| |
| |
| |
| def __repr__(self) -> str: |
| return f'{self.__class__.__name__}(num_tags={self.num_tags})' |
|
|
| def forward( |
| self, |
| emissions: torch.Tensor, |
| tags: torch.LongTensor, |
| mask: Optional[torch.ByteTensor] = None, |
| reduction: str = 'sum', |
| ) -> torch.Tensor: |
| """Compute the conditional log likelihood of a sequence of tags given emission scores. |
| Args: |
| emissions (`~torch.Tensor`): Emission score tensor of size |
| ``(seq_length, batch_size, num_tags)`` if ``batch_first`` is ``False``, |
| ``(batch_size, seq_length, num_tags)`` otherwise. |
| tags (`~torch.LongTensor`): Sequence of tags tensor of size |
| ``(seq_length, batch_size)`` if ``batch_first`` is ``False``, |
| ``(batch_size, seq_length)`` otherwise. |
| mask (`~torch.ByteTensor`): Mask tensor of size ``(seq_length, batch_size)`` |
| if ``batch_first`` is ``False``, ``(batch_size, seq_length)`` otherwise. |
| reduction: Specifies the reduction to apply to the output: |
| ``none|sum|mean|token_mean``. ``none``: no reduction will be applied. |
| ``sum``: the output will be summed over batches. ``mean``: the output will be |
| averaged over batches. ``token_mean``: the output will be averaged over tokens. |
| Returns: |
| `~torch.Tensor`: The log likelihood. This will have size ``(batch_size,)`` if |
| reduction is ``none``, ``()`` otherwise. |
| """ |
| |
| self._validate(emissions, tags=tags, mask=mask) |
| if reduction not in ('none', 'sum', 'mean', 'token_mean'): |
| raise ValueError(f'invalid reduction: {reduction}') |
| if mask is None: |
| mask = torch.ones_like(tags, dtype=torch.uint8) |
|
|
| if self.batch_first: |
| emissions = emissions.transpose(0, 1) |
| tags = tags.transpose(0, 1) |
| mask = mask.transpose(0, 1) |
|
|
| |
| numerator = self._compute_score(emissions, tags, mask) |
| |
| denominator = self._compute_normalizer(emissions, mask) |
| |
| llh = numerator - denominator |
| nllh = -llh |
| |
| if reduction == 'none': |
| return nllh |
| if reduction == 'sum': |
| return nllh.sum() |
| if reduction == 'mean': |
| return nllh.mean() |
| assert reduction == 'token_mean' |
| return nllh.sum() / mask.type_as(emissions).sum() |
|
|
| def decode(self, emissions: torch.Tensor, |
| mask: Optional[torch.ByteTensor] = None) -> List[List[int]]: |
| """Find the most likely tag sequence using Viterbi algorithm. |
| Args: |
| emissions (`~torch.Tensor`): Emission score tensor of size |
| ``(seq_length, batch_size, num_tags)`` if ``batch_first`` is ``False``, |
| ``(batch_size, seq_length, num_tags)`` otherwise. |
| mask (`~torch.ByteTensor`): Mask tensor of size ``(seq_length, batch_size)`` |
| if ``batch_first`` is ``False``, ``(batch_size, seq_length)`` otherwise. |
| Returns: |
| List of list containing the best tag sequence for each batch. |
| """ |
| self._validate(emissions, mask=mask) |
| if mask is None: |
| mask = emissions.new_ones(emissions.shape[:2], dtype=torch.uint8) |
|
|
| if self.batch_first: |
| emissions = emissions.transpose(0, 1) |
| mask = mask.transpose(0, 1) |
|
|
| return self._viterbi_decode(emissions, mask) |
|
|
| def _validate( |
| self, |
| emissions: torch.Tensor, |
| tags: Optional[torch.LongTensor] = None, |
| mask: Optional[torch.ByteTensor] = None) -> None: |
| if emissions.dim() != 3: |
| raise ValueError(f'emissions must have dimension of 3, got {emissions.dim()}') |
| if emissions.size(2) != self.num_tags: |
| raise ValueError( |
| f'expected last dimension of emissions is {self.num_tags}, ' |
| f'got {emissions.size(2)}') |
|
|
| if tags is not None: |
| if emissions.shape[:2] != tags.shape: |
| raise ValueError( |
| 'the first two dimensions of emissions and tags must match, ' |
| f'got {tuple(emissions.shape[:2])} and {tuple(tags.shape)}') |
|
|
| if mask is not None: |
| if emissions.shape[:2] != mask.shape: |
| raise ValueError( |
| 'the first two dimensions of emissions and mask must match, ' |
| f'got {tuple(emissions.shape[:2])} and {tuple(mask.shape)}') |
| no_empty_seq = not self.batch_first and mask[0].all() |
| no_empty_seq_bf = self.batch_first and mask[:, 0].all() |
| if not no_empty_seq and not no_empty_seq_bf: |
| raise ValueError('mask of the first timestep must all be on') |
|
|
| def _compute_score( |
| self, emissions: torch.Tensor, tags: torch.LongTensor, |
| mask: torch.ByteTensor) -> torch.Tensor: |
| |
| |
| |
| assert emissions.dim() == 3 and tags.dim() == 2 |
| assert emissions.shape[:2] == tags.shape |
| assert emissions.size(2) == self.num_tags |
| assert mask.shape == tags.shape |
| assert mask[0].all() |
|
|
| seq_length, batch_size = tags.shape |
| mask = mask.type_as(emissions) |
|
|
| |
| |
| score = self.start_transitions[tags[0]] |
| score += emissions[0, torch.arange(batch_size), tags[0]] |
|
|
| for i in range(1, seq_length): |
| |
| |
| score += self.transitions[tags[i - 1], tags[i]] * mask[i] |
|
|
| |
| |
| score += emissions[i, torch.arange(batch_size), tags[i]] * mask[i] |
|
|
| |
| |
| seq_ends = mask.long().sum(dim=0) - 1 |
| |
| last_tags = tags[seq_ends, torch.arange(batch_size)] |
| |
| score += self.end_transitions[last_tags] |
|
|
| return score |
|
|
| def _compute_normalizer( |
| self, emissions: torch.Tensor, mask: torch.ByteTensor) -> torch.Tensor: |
| |
| |
| assert emissions.dim() == 3 and mask.dim() == 2 |
| assert emissions.shape[:2] == mask.shape |
| assert emissions.size(2) == self.num_tags |
| assert mask[0].all() |
|
|
| seq_length = emissions.size(0) |
|
|
| |
| |
| |
| |
| score = self.start_transitions + emissions[0] |
|
|
| for i in range(1, seq_length): |
| |
| |
| broadcast_score = score.unsqueeze(2) |
|
|
| |
| |
| broadcast_emissions = emissions[i].unsqueeze(1) |
|
|
| |
| |
| |
| |
| |
| next_score = broadcast_score + self.transitions + broadcast_emissions |
|
|
| |
| |
| |
| |
| next_score = torch.logsumexp(next_score, dim=1) |
|
|
| |
| |
| score = torch.where(mask[i].unsqueeze(1).bool(), next_score, score) |
|
|
| |
| |
| score += self.end_transitions |
|
|
| |
| |
| return torch.logsumexp(score, dim=1) |
|
|
| def _viterbi_decode(self, emissions: torch.FloatTensor, |
| mask: torch.ByteTensor) -> List[List[int]]: |
| |
| |
| assert emissions.dim() == 3 and mask.dim() == 2 |
| assert emissions.shape[:2] == mask.shape |
| assert emissions.size(2) == self.num_tags |
| assert mask[0].all() |
|
|
| seq_length, batch_size = mask.shape |
|
|
| |
| |
| score = self.start_transitions + emissions[0] |
| history = [] |
|
|
| |
| |
| |
| |
| |
|
|
| |
| |
| for i in range(1, seq_length): |
| |
| |
| broadcast_score = score.unsqueeze(2) |
|
|
| |
| |
| broadcast_emission = emissions[i].unsqueeze(1) |
|
|
| |
| |
| |
| |
| next_score = broadcast_score + self.transitions + broadcast_emission |
|
|
| |
| |
| next_score, indices = next_score.max(dim=1) |
|
|
| |
| |
| |
| score = torch.where(mask[i].unsqueeze(1).bool(), next_score, score) |
| history.append(indices) |
|
|
| |
| |
| score += self.end_transitions |
|
|
| |
|
|
| |
| seq_ends = mask.long().sum(dim=0) - 1 |
| best_tags_list = [] |
|
|
| for idx in range(batch_size): |
| |
| |
| _, best_last_tag = score[idx].max(dim=0) |
| best_tags = [best_last_tag.item()] |
|
|
| |
| |
| for hist in reversed(history[:seq_ends[idx]]): |
| best_last_tag = hist[idx][best_tags[-1]] |
| best_tags.append(best_last_tag.item()) |
|
|
| |
| best_tags.reverse() |
| best_tags_list.append(best_tags) |
|
|
| return best_tags_list |
| |
| |
|
|