run_mlm.py 29.7 KB
Newer Older
Matt's avatar
Matt committed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
#!/usr/bin/env python
# coding=utf-8
# Copyright 2021 The HuggingFace Inc. team. All rights reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""
Fine-tuning the library models for masked language modeling (BERT, ALBERT, RoBERTa...)
on a text file or a dataset without using HuggingFace Trainer.

Here is the full list of checkpoints on the hub that can be fine-tuned by this script:
21
https://huggingface.co/models?filter=fill-mask
Matt's avatar
Matt committed
22
23
24
"""
# You can also adapt this script on your own mlm task. Pointers for this are left as comments.

Matt's avatar
Matt committed
25
import json
Matt's avatar
Matt committed
26
27
28
29
30
31
import logging
import math
import os
import random
import sys
from dataclasses import dataclass, field
32
from itertools import chain
Matt's avatar
Matt committed
33
34
35
36
37
38
from pathlib import Path
from typing import Optional

import datasets
import tensorflow as tf
from datasets import load_dataset
39
from sklearn.model_selection import train_test_split
Matt's avatar
Matt committed
40
41
42
43
44
45

import transformers
from transformers import (
    CONFIG_MAPPING,
    CONFIG_NAME,
    TF2_WEIGHTS_NAME,
46
    TF_MODEL_FOR_MASKED_LM_MAPPING,
Matt's avatar
Matt committed
47
48
    AutoConfig,
    AutoTokenizer,
Joao Gante's avatar
Joao Gante committed
49
    DataCollatorForLanguageModeling,
Matt's avatar
Matt committed
50
    HfArgumentParser,
Matt's avatar
Matt committed
51
    PushToHubCallback,
Matt's avatar
Matt committed
52
53
54
55
56
    TFAutoModelForMaskedLM,
    TFTrainingArguments,
    create_optimizer,
    set_seed,
)
57
from transformers.utils import send_example_telemetry
Matt's avatar
Matt committed
58
59
60
61
from transformers.utils.versions import require_version


logger = logging.getLogger(__name__)
62
63
require_version("datasets>=1.8.0", "To fix: pip install -r examples/tensorflow/language-modeling/requirements.txt")
MODEL_CONFIG_CLASSES = list(TF_MODEL_FOR_MASKED_LM_MAPPING.keys())
Matt's avatar
Matt committed
64
65
66
67
68
69
70
71
72
73
74
75
76
MODEL_TYPES = tuple(conf.model_type for conf in MODEL_CONFIG_CLASSES)


# region Command-line arguments
@dataclass
class ModelArguments:
    """
    Arguments pertaining to which model/config/tokenizer we are going to fine-tune, or train from scratch.
    """

    model_name_or_path: Optional[str] = field(
        default=None,
        metadata={
Sylvain Gugger's avatar
Sylvain Gugger committed
77
            "help": (
78
                "The model checkpoint for weights initialization. Don't set if you want to train a model from scratch."
Sylvain Gugger's avatar
Sylvain Gugger committed
79
            )
Matt's avatar
Matt committed
80
81
82
83
84
85
86
87
88
        },
    )
    model_type: Optional[str] = field(
        default=None,
        metadata={"help": "If training from scratch, pass a model type from the list: " + ", ".join(MODEL_TYPES)},
    )
    config_overrides: Optional[str] = field(
        default=None,
        metadata={
Sylvain Gugger's avatar
Sylvain Gugger committed
89
90
91
92
            "help": (
                "Override some existing default config settings when a model is trained from scratch. Example: "
                "n_embd=10,resid_pdrop=0.2,scale_attn_weights=false,summary_type=cls_index"
            )
Matt's avatar
Matt committed
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
        },
    )
    config_name: Optional[str] = field(
        default=None, metadata={"help": "Pretrained config name or path if not the same as model_name"}
    )
    tokenizer_name: Optional[str] = field(
        default=None, metadata={"help": "Pretrained tokenizer name or path if not the same as model_name"}
    )
    cache_dir: Optional[str] = field(
        default=None,
        metadata={"help": "Where do you want to store the pretrained models downloaded from huggingface.co"},
    )
    use_fast_tokenizer: bool = field(
        default=True,
        metadata={"help": "Whether to use one of the fast tokenizer (backed by the tokenizers library) or not."},
    )
    model_revision: str = field(
        default="main",
        metadata={"help": "The specific model version to use (can be a branch name, tag name or commit id)."},
    )
113
114
    token: str = field(
        default=None,
Matt's avatar
Matt committed
115
        metadata={
Sylvain Gugger's avatar
Sylvain Gugger committed
116
            "help": (
117
118
                "The token to use as HTTP bearer authorization for remote files. If not specified, will use the token "
                "generated when running `huggingface-cli login` (stored in `~/.huggingface`)."
Sylvain Gugger's avatar
Sylvain Gugger committed
119
            )
Matt's avatar
Matt committed
120
121
        },
    )
122
123
124
125
    trust_remote_code: bool = field(
        default=False,
        metadata={
            "help": (
126
127
128
                "Whether to trust the execution of code from datasets/models defined on the Hub."
                " This option should only be set to `True` for repositories you trust and in which you have read the"
                " code, as it will execute code present on the Hub on your local machine."
129
130
131
            )
        },
    )
Matt's avatar
Matt committed
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168

    def __post_init__(self):
        if self.config_overrides is not None and (self.config_name is not None or self.model_name_or_path is not None):
            raise ValueError(
                "--config_overrides can't be used in combination with --config_name or --model_name_or_path"
            )


@dataclass
class DataTrainingArguments:
    """
    Arguments pertaining to what data we are going to input our model for training and eval.
    """

    dataset_name: Optional[str] = field(
        default=None, metadata={"help": "The name of the dataset to use (via the datasets library)."}
    )
    dataset_config_name: Optional[str] = field(
        default=None, metadata={"help": "The configuration name of the dataset to use (via the datasets library)."}
    )
    train_file: Optional[str] = field(default=None, metadata={"help": "The input training data file (a text file)."})
    validation_file: Optional[str] = field(
        default=None,
        metadata={"help": "An optional input evaluation data file to evaluate the perplexity on (a text file)."},
    )
    overwrite_cache: bool = field(
        default=False, metadata={"help": "Overwrite the cached training and evaluation sets"}
    )
    validation_split_percentage: Optional[int] = field(
        default=5,
        metadata={
            "help": "The percentage of the train set used as validation set in case there's no validation split"
        },
    )
    max_seq_length: Optional[int] = field(
        default=None,
        metadata={
Sylvain Gugger's avatar
Sylvain Gugger committed
169
170
171
172
            "help": (
                "The maximum total input sequence length after tokenization. Sequences longer "
                "than this will be truncated."
            )
Matt's avatar
Matt committed
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
        },
    )
    preprocessing_num_workers: Optional[int] = field(
        default=None,
        metadata={"help": "The number of processes to use for the preprocessing."},
    )
    mlm_probability: float = field(
        default=0.15, metadata={"help": "Ratio of tokens to mask for masked language modeling loss"}
    )
    line_by_line: bool = field(
        default=False,
        metadata={"help": "Whether distinct lines of text in the dataset are to be handled as distinct sequences."},
    )
    pad_to_max_length: bool = field(
        default=False,
        metadata={
Sylvain Gugger's avatar
Sylvain Gugger committed
189
190
191
192
            "help": (
                "Whether to pad all samples to `max_seq_length`. "
                "If False, will pad the samples dynamically when batching to the maximum length in the batch."
            )
Matt's avatar
Matt committed
193
194
195
196
197
        },
    )
    max_train_samples: Optional[int] = field(
        default=None,
        metadata={
Sylvain Gugger's avatar
Sylvain Gugger committed
198
199
200
201
            "help": (
                "For debugging purposes or quicker training, truncate the number of training examples to this "
                "value if set."
            )
Matt's avatar
Matt committed
202
203
204
205
206
        },
    )
    max_eval_samples: Optional[int] = field(
        default=None,
        metadata={
Sylvain Gugger's avatar
Sylvain Gugger committed
207
208
209
210
            "help": (
                "For debugging purposes or quicker training, truncate the number of evaluation examples to this "
                "value if set."
            )
Matt's avatar
Matt committed
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
        },
    )

    def __post_init__(self):
        if self.dataset_name is None and self.train_file is None and self.validation_file is None:
            raise ValueError("Need either a dataset name or a training/validation file.")
        else:
            if self.train_file is not None:
                extension = self.train_file.split(".")[-1]
                assert extension in ["csv", "json", "txt"], "`train_file` should be a csv, a json or a txt file."
            if self.validation_file is not None:
                extension = self.validation_file.split(".")[-1]
                assert extension in ["csv", "json", "txt"], "`validation_file` should be a csv, a json or a txt file."


# endregion


def main():
    # region Argument Parsing
    parser = HfArgumentParser((ModelArguments, DataTrainingArguments, TFTrainingArguments))
    if len(sys.argv) == 2 and sys.argv[1].endswith(".json"):
        # If we pass only one argument to the script and it's the path to a json file,
        # let's parse it to get our arguments.
        model_args, data_args, training_args = parser.parse_json_file(json_file=os.path.abspath(sys.argv[1]))
    else:
        model_args, data_args, training_args = parser.parse_args_into_dataclasses()

239
240
241
242
    # Sending telemetry. Tracking the example usage helps us better allocate resources to maintain them. The
    # information sent is the one passed as arguments along with your Python/PyTorch versions.
    send_example_telemetry("run_mlm", model_args, data_args, framework="tensorflow")

Matt's avatar
Matt committed
243
244
245
246
247
248
249
250
251
252
253
254
    # Sanity checks
    if data_args.dataset_name is None and data_args.train_file is None and data_args.validation_file is None:
        raise ValueError("Need either a dataset name or a training/validation file.")
    else:
        if data_args.train_file is not None:
            extension = data_args.train_file.split(".")[-1]
            assert extension in ["csv", "json", "txt"], "`train_file` should be a csv, json or txt file."
        if data_args.validation_file is not None:
            extension = data_args.validation_file.split(".")[-1]
            assert extension in ["csv", "json", "txt"], "`validation_file` should be a csv, json or txt file."

    if training_args.output_dir is not None:
255
        training_args.output_dir = Path(training_args.output_dir)
Matt's avatar
Matt committed
256
257
258
259
260
261
262
263
264
265
266
        os.makedirs(training_args.output_dir, exist_ok=True)

    if isinstance(training_args.strategy, tf.distribute.TPUStrategy) and not data_args.pad_to_max_length:
        logger.warning("We are training on TPU - forcing pad_to_max_length")
        data_args.pad_to_max_length = True
    # endregion

    # region Checkpoints
    # Detecting last checkpoint.
    checkpoint = None
    if len(os.listdir(training_args.output_dir)) > 0 and not training_args.overwrite_output_dir:
267
268
        config_path = training_args.output_dir / CONFIG_NAME
        weights_path = training_args.output_dir / TF2_WEIGHTS_NAME
Matt's avatar
Matt committed
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
        if config_path.is_file() and weights_path.is_file():
            checkpoint = training_args.output_dir
            logger.warning(
                f"Checkpoint detected, resuming training from checkpoint in {training_args.output_dir}. To avoid this"
                " behavior, change the `--output_dir` or add `--overwrite_output_dir` to train from scratch."
            )
        else:
            raise ValueError(
                f"Output directory ({training_args.output_dir}) already exists and is not empty. "
                "Use --overwrite_output_dir to continue regardless."
            )

    # endregion

    # region Setup logging
    # accelerator.is_local_main_process is only True for one process per machine.
    logger.setLevel(logging.INFO)
    datasets.utils.logging.set_verbosity_warning()
    transformers.utils.logging.set_verbosity_info()
    # endregion

    # If passed along, set the training seed now.
    if training_args.seed is not None:
        set_seed(training_args.seed)

    # region Load datasets
    # Get the datasets: you can either provide your own CSV/JSON/TXT training and evaluation files (see below)
    # or just provide the name of one of the public datasets available on the hub at https://huggingface.co/datasets/
    # (the dataset will be downloaded automatically from the datasets Hub).
    #
    # For CSV/JSON files, this script will use the column called 'text' or the first column if no column called
    # 'text' is found. You can easily tweak this behavior (see below).
    #
    # In distributed training, the load_dataset function guarantee that only one local process can concurrently
    # download the dataset.
    if data_args.dataset_name is not None:
        # Downloading and loading a dataset from the hub.
306
307
308
        raw_datasets = load_dataset(
            data_args.dataset_name,
            data_args.dataset_config_name,
309
            token=model_args.token,
310
            trust_remote_code=model_args.trust_remote_code,
311
        )
Matt's avatar
Matt committed
312
313
314
315
316
        if "validation" not in raw_datasets.keys():
            raw_datasets["validation"] = load_dataset(
                data_args.dataset_name,
                data_args.dataset_config_name,
                split=f"train[:{data_args.validation_split_percentage}%]",
317
                token=model_args.token,
318
                trust_remote_code=model_args.trust_remote_code,
Matt's avatar
Matt committed
319
320
321
322
323
            )
            raw_datasets["train"] = load_dataset(
                data_args.dataset_name,
                data_args.dataset_config_name,
                split=f"train[{data_args.validation_split_percentage}%:]",
324
                token=model_args.token,
325
                trust_remote_code=model_args.trust_remote_code,
Matt's avatar
Matt committed
326
327
328
329
330
            )
    else:
        data_files = {}
        if data_args.train_file is not None:
            data_files["train"] = data_args.train_file
331
            extension = data_args.train_file.split(".")[-1]
Matt's avatar
Matt committed
332
333
        if data_args.validation_file is not None:
            data_files["validation"] = data_args.validation_file
334
            extension = data_args.validation_file.split(".")[-1]
Matt's avatar
Matt committed
335
336
        if extension == "txt":
            extension = "text"
337
338
339
        raw_datasets = load_dataset(
            extension,
            data_files=data_files,
340
            token=model_args.token,
341
        )
342

Matt's avatar
Matt committed
343
    # See more about loading any type of standard or custom dataset (from files, python dict, pandas DataFrame, etc) at
344
    # https://huggingface.co/docs/datasets/loading_datasets.
Matt's avatar
Matt committed
345
346
347
348
349
350
351
    # endregion

    # region Load pretrained model and tokenizer
    #
    # In distributed training, the .from_pretrained methods guarantee that only one local process can concurrently
    # download model & vocab.
    if checkpoint is not None:
352
353
354
        config = AutoConfig.from_pretrained(
            checkpoint, token=model_args.token, trust_remote_code=model_args.trust_remote_code
        )
Matt's avatar
Matt committed
355
    elif model_args.config_name:
356
357
358
        config = AutoConfig.from_pretrained(
            model_args.config_name, token=model_args.token, trust_remote_code=model_args.trust_remote_code
        )
Matt's avatar
Matt committed
359
    elif model_args.model_name_or_path:
360
        config = AutoConfig.from_pretrained(
361
            model_args.model_name_or_path, token=model_args.token, trust_remote_code=model_args.trust_remote_code
362
        )
Matt's avatar
Matt committed
363
364
365
366
367
    else:
        config = CONFIG_MAPPING[model_args.model_type]()
        logger.warning("You are instantiating a new config instance from scratch.")

    if model_args.tokenizer_name:
368
        tokenizer = AutoTokenizer.from_pretrained(
369
            model_args.tokenizer_name, token=model_args.token, trust_remote_code=model_args.trust_remote_code
370
        )
Matt's avatar
Matt committed
371
    elif model_args.model_name_or_path:
372
        tokenizer = AutoTokenizer.from_pretrained(
373
            model_args.model_name_or_path, token=model_args.token, trust_remote_code=model_args.trust_remote_code
374
        )
Matt's avatar
Matt committed
375
376
    else:
        raise ValueError(
377
            "You are instantiating a new tokenizer from scratch. This is not supported by this script. "
Matt's avatar
Matt committed
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
            "You can do it from another script, save it, and load it from here, using --tokenizer_name."
        )
    # endregion

    # region Dataset preprocessing
    # First we tokenize all the texts.
    column_names = raw_datasets["train"].column_names
    text_column_name = "text" if "text" in column_names else column_names[0]

    if data_args.max_seq_length is None:
        max_seq_length = tokenizer.model_max_length
        if max_seq_length > 1024:
            logger.warning(
                f"The tokenizer picked seems to have a very large `model_max_length` ({tokenizer.model_max_length}). "
                "Picking 1024 instead. You can reduce that default value by passing --max_seq_length xxx."
            )
            max_seq_length = 1024
    else:
        if data_args.max_seq_length > tokenizer.model_max_length:
            logger.warning(
398
                f"The max_seq_length passed ({data_args.max_seq_length}) is larger than the maximum length for the "
Matt's avatar
Matt committed
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
                f"model ({tokenizer.model_max_length}). Using max_seq_length={tokenizer.model_max_length}."
            )
        max_seq_length = min(data_args.max_seq_length, tokenizer.model_max_length)

    if data_args.line_by_line:
        # When using line_by_line, we just tokenize each nonempty line.
        padding = "max_length" if data_args.pad_to_max_length else False

        def tokenize_function(examples):
            # Remove empty lines
            examples[text_column_name] = [
                line for line in examples[text_column_name] if len(line) > 0 and not line.isspace()
            ]
            return tokenizer(
                examples[text_column_name],
                padding=padding,
                truncation=True,
                max_length=max_seq_length,
                # We use this option because DataCollatorForLanguageModeling (see below) is more efficient when it
                # receives the `special_tokens_mask`.
                return_special_tokens_mask=True,
            )

        tokenized_datasets = raw_datasets.map(
            tokenize_function,
            batched=True,
            num_proc=data_args.preprocessing_num_workers,
            remove_columns=[text_column_name],
            load_from_cache_file=not data_args.overwrite_cache,
            desc="Running tokenizer on dataset line_by_line",
        )
    else:
        # Otherwise, we tokenize every text, then concatenate them together before splitting them in smaller parts.
        # We use `return_special_tokens_mask=True` because DataCollatorForLanguageModeling (see below) is more
        # efficient when it receives the `special_tokens_mask`.
        def tokenize_function(examples):
            return tokenizer(examples[text_column_name], return_special_tokens_mask=True)

        tokenized_datasets = raw_datasets.map(
            tokenize_function,
            batched=True,
            num_proc=data_args.preprocessing_num_workers,
            remove_columns=column_names,
            load_from_cache_file=not data_args.overwrite_cache,
            desc="Running tokenizer on every text in dataset",
        )

        # Main data processing function that will concatenate all texts from our dataset and generate chunks of
        # max_seq_length.
        def group_texts(examples):
            # Concatenate all texts.
450
            concatenated_examples = {k: list(chain(*examples[k])) for k in examples.keys()}
Matt's avatar
Matt committed
451
452
453
            total_length = len(concatenated_examples[list(examples.keys())[0]])
            # We drop the small remainder, we could add padding if the model supported it instead of this drop, you can
            # customize this part to your needs.
454
455
            if total_length >= max_seq_length:
                total_length = (total_length // max_seq_length) * max_seq_length
Matt's avatar
Matt committed
456
457
458
459
460
461
462
463
464
465
466
467
            # Split by chunks of max_len.
            result = {
                k: [t[i : i + max_seq_length] for i in range(0, total_length, max_seq_length)]
                for k, t in concatenated_examples.items()
            }
            return result

        # Note that with `batched=True`, this map processes 1,000 texts together, so group_texts throws away a
        # remainder for each of those groups of 1,000 texts. You can adjust that batch_size here but a higher value
        # might be slower to preprocess.
        #
        # To speed up this part, we use multiprocessing. See the documentation of the map method for more information:
468
        # https://huggingface.co/docs/datasets/process#map
Matt's avatar
Matt committed
469
470
471
472
473
474
475
476
477
478

        tokenized_datasets = tokenized_datasets.map(
            group_texts,
            batched=True,
            num_proc=data_args.preprocessing_num_workers,
            load_from_cache_file=not data_args.overwrite_cache,
            desc=f"Grouping texts in chunks of {max_seq_length}",
        )

    train_dataset = tokenized_datasets["train"]
479
480
481
482
483

    if data_args.validation_file is not None:
        eval_dataset = tokenized_datasets["validation"]
    else:
        logger.info(
Sylvain Gugger's avatar
Sylvain Gugger committed
484
485
            f"Validation file not found: using {data_args.validation_split_percentage}% of the dataset as validation"
            " as provided in data_args"
486
487
        )
        train_indices, val_indices = train_test_split(
488
            list(range(len(train_dataset))), test_size=data_args.validation_split_percentage / 100
489
490
491
492
493
        )

        eval_dataset = train_dataset.select(val_indices)
        train_dataset = train_dataset.select(train_indices)

Matt's avatar
Matt committed
494
    if data_args.max_train_samples is not None:
495
496
        max_train_samples = min(len(train_dataset), data_args.max_train_samples)
        train_dataset = train_dataset.select(range(max_train_samples))
Matt's avatar
Matt committed
497
    if data_args.max_eval_samples is not None:
498
499
        max_eval_samples = min(len(eval_dataset), data_args.max_eval_samples)
        eval_dataset = eval_dataset.select(range(max_eval_samples))
Matt's avatar
Matt committed
500
501

    # Log a few random samples from the training set:
Matt's avatar
Matt committed
502
    for index in random.sample(range(len(train_dataset)), min(3, len(train_dataset))):
Matt's avatar
Matt committed
503
504
505
506
507
508
        logger.info(f"Sample {index} of the training set: {train_dataset[index]}.")
    # endregion

    with training_args.strategy.scope():
        # region Prepare model
        if checkpoint is not None:
509
            model = TFAutoModelForMaskedLM.from_pretrained(
510
                checkpoint, config=config, token=model_args.token, trust_remote_code=model_args.trust_remote_code
511
            )
Matt's avatar
Matt committed
512
        elif model_args.model_name_or_path:
513
            model = TFAutoModelForMaskedLM.from_pretrained(
514
515
516
517
                model_args.model_name_or_path,
                config=config,
                token=model_args.token,
                trust_remote_code=model_args.trust_remote_code,
518
            )
Matt's avatar
Matt committed
519
520
        else:
            logger.info("Training new model from scratch")
521
522
523
            model = TFAutoModelForMaskedLM.from_config(
                config, token=model_args.token, trust_remote_code=model_args.trust_remote_code
            )
Matt's avatar
Matt committed
524

525
526
        # We resize the embeddings only when necessary to avoid index errors. If you are creating a model from scratch
        # on a small vocab and want a smaller embedding size, remove this test.
527
528
529
530
531
532
533
534
535
        embeddings = model.get_input_embeddings()

        # Matt: This is a temporary workaround as we transition our models to exclusively using Keras embeddings.
        #       As soon as the transition is complete, all embeddings should be keras.Embeddings layers, and
        #       the weights will always be in embeddings.embeddings.
        if hasattr(embeddings, "embeddings"):
            embedding_size = embeddings.embeddings.shape[0]
        else:
            embedding_size = embeddings.weight.shape[0]
536
537
        if len(tokenizer) > embedding_size:
            model.resize_token_embeddings(len(tokenizer))
Matt's avatar
Matt committed
538
539
540
541
        # endregion

        # region TF Dataset preparation
        num_replicas = training_args.strategy.num_replicas_in_sync
Joao Gante's avatar
Joao Gante committed
542
        data_collator = DataCollatorForLanguageModeling(
543
            tokenizer=tokenizer, mlm_probability=data_args.mlm_probability, return_tensors="np"
Joao Gante's avatar
Joao Gante committed
544
        )
Matt's avatar
Matt committed
545
546
        options = tf.data.Options()
        options.experimental_distribute.auto_shard_policy = tf.data.experimental.AutoShardPolicy.OFF
Joao Gante's avatar
Joao Gante committed
547

Matt's avatar
Matt committed
548
549
550
551
552
553
554
555
556
557
558
        # model.prepare_tf_dataset() wraps a Hugging Face dataset in a tf.data.Dataset which is ready to use in
        # training. This is the recommended way to use a Hugging Face dataset when training with Keras. You can also
        # use the lower-level dataset.to_tf_dataset() method, but you will have to specify things like column names
        # yourself if you use this method, whereas they are automatically inferred from the model input names when
        # using model.prepare_tf_dataset()
        # For more info see the docs:
        # https://huggingface.co/docs/transformers/main/en/main_classes/model#transformers.TFPreTrainedModel.prepare_tf_dataset
        # https://huggingface.co/docs/datasets/main/en/package_reference/main_classes#datasets.Dataset.to_tf_dataset

        tf_train_dataset = model.prepare_tf_dataset(
            train_dataset,
Joao Gante's avatar
Joao Gante committed
559
560
561
562
563
            shuffle=True,
            batch_size=num_replicas * training_args.per_device_train_batch_size,
            collate_fn=data_collator,
        ).with_options(options)

Matt's avatar
Matt committed
564
565
        tf_eval_dataset = model.prepare_tf_dataset(
            eval_dataset,
Joao Gante's avatar
Joao Gante committed
566
567
            # labels are passed as input, as we will use the model's internal loss
            shuffle=False,
Matt's avatar
Matt committed
568
            batch_size=num_replicas * training_args.per_device_eval_batch_size,
Joao Gante's avatar
Joao Gante committed
569
570
571
            collate_fn=data_collator,
            drop_remainder=True,
        ).with_options(options)
Matt's avatar
Matt committed
572
573
574
        # endregion

        # region Optimizer and loss
Matt's avatar
Matt committed
575
576
577
578
579
580
581
582
        num_train_steps = len(tf_train_dataset) * int(training_args.num_train_epochs)
        if training_args.warmup_steps > 0:
            num_warmup_steps = training_args.warmup_steps
        elif training_args.warmup_ratio > 0:
            num_warmup_steps = int(num_train_steps * training_args.warmup_ratio)
        else:
            num_warmup_steps = 0

Matt's avatar
Matt committed
583
584
585
        # Bias and layernorm weights are automatically excluded from the decay
        optimizer, lr_schedule = create_optimizer(
            init_lr=training_args.learning_rate,
Matt's avatar
Matt committed
586
587
            num_train_steps=num_train_steps,
            num_warmup_steps=num_warmup_steps,
Matt's avatar
Matt committed
588
589
590
591
            adam_beta1=training_args.adam_beta1,
            adam_beta2=training_args.adam_beta2,
            adam_epsilon=training_args.adam_epsilon,
            weight_decay_rate=training_args.weight_decay,
Matt's avatar
Matt committed
592
            adam_global_clipnorm=training_args.max_grad_norm,
Matt's avatar
Matt committed
593
594
        )

595
596
597
        # Transformers models compute the right loss for their task by default when labels are passed, and will
        # use this for training unless you specify your own loss function in compile().
        model.compile(optimizer=optimizer, jit_compile=training_args.xla)
Matt's avatar
Matt committed
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
        # endregion

        # region Preparing push_to_hub and model card
        push_to_hub_model_id = training_args.push_to_hub_model_id
        model_name = model_args.model_name_or_path.split("/")[-1]
        if not push_to_hub_model_id:
            if data_args.dataset_name is not None:
                push_to_hub_model_id = f"{model_name}-finetuned-{data_args.dataset_name}"
            else:
                push_to_hub_model_id = f"{model_name}-finetuned-mlm"

        model_card_kwargs = {"finetuned_from": model_args.model_name_or_path, "tasks": "fill-mask"}
        if data_args.dataset_name is not None:
            model_card_kwargs["dataset_tags"] = data_args.dataset_name
            if data_args.dataset_config_name is not None:
                model_card_kwargs["dataset_args"] = data_args.dataset_config_name
                model_card_kwargs["dataset"] = f"{data_args.dataset_name} {data_args.dataset_config_name}"
            else:
                model_card_kwargs["dataset"] = data_args.dataset_name

        if training_args.push_to_hub:
            callbacks = [
                PushToHubCallback(
                    output_dir=training_args.output_dir,
622
623
                    hub_model_id=push_to_hub_model_id,
                    hub_token=training_args.push_to_hub_token,
Matt's avatar
Matt committed
624
625
626
627
628
629
                    tokenizer=tokenizer,
                    **model_card_kwargs,
                )
            ]
        else:
            callbacks = []
Matt's avatar
Matt committed
630
631
632
633
634
635
636
637
638
        # endregion

        # region Training and validation
        logger.info("***** Running training *****")
        logger.info(f"  Num examples = {len(train_dataset)}")
        logger.info(f"  Num Epochs = {training_args.num_train_epochs}")
        logger.info(f"  Instantaneous batch size per device = {training_args.per_device_train_batch_size}")
        logger.info(f"  Total train batch size = {training_args.per_device_train_batch_size * num_replicas}")

Matt's avatar
Matt committed
639
640
641
642
        # For long training runs, you may wish to use the PushToHub() callback here to save intermediate checkpoints
        # to the Hugging Face Hub rather than just pushing the finished model.
        # See https://huggingface.co/docs/transformers/main_classes/keras_callbacks#transformers.PushToHubCallback

Matt's avatar
Matt committed
643
644
645
646
        history = model.fit(
            tf_train_dataset,
            validation_data=tf_eval_dataset,
            epochs=int(training_args.num_train_epochs),
Matt's avatar
Matt committed
647
            callbacks=callbacks,
Matt's avatar
Matt committed
648
        )
Matt's avatar
Matt committed
649
        train_loss = history.history["loss"][-1]
Matt's avatar
Matt committed
650
        try:
Matt's avatar
Matt committed
651
            train_perplexity = math.exp(train_loss)
Matt's avatar
Matt committed
652
653
        except OverflowError:
            train_perplexity = math.inf
Matt's avatar
Matt committed
654
655
656
657
658
659
660
661
662
663
        logger.info(f"  Final train loss: {train_loss:.3f}")
        logger.info(f"  Final train perplexity: {train_perplexity:.3f}")

    validation_loss = history.history["val_loss"][-1]
    try:
        validation_perplexity = math.exp(validation_loss)
    except OverflowError:
        validation_perplexity = math.inf
    logger.info(f"  Final validation loss: {validation_loss:.3f}")
    logger.info(f"  Final validation perplexity: {validation_perplexity:.3f}")
Matt's avatar
Matt committed
664

Matt's avatar
Matt committed
665
666
    if training_args.output_dir is not None:
        output_eval_file = os.path.join(training_args.output_dir, "all_results.json")
667
        results_dict = {}
Matt's avatar
Matt committed
668
669
670
671
672
673
674
        results_dict["train_loss"] = train_loss
        results_dict["train_perplexity"] = train_perplexity
        results_dict["eval_loss"] = validation_loss
        results_dict["eval_perplexity"] = validation_perplexity
        with open(output_eval_file, "w") as writer:
            writer.write(json.dumps(results_dict))
        # endregion
Matt's avatar
Matt committed
675

Matt's avatar
Matt committed
676
677
678
    if training_args.output_dir is not None and not training_args.push_to_hub:
        # If we're not pushing to hub, at least save a local copy when we're done
        model.save_pretrained(training_args.output_dir)
Matt's avatar
Matt committed
679
680
681
682


if __name__ == "__main__":
    main()