From 8661d4d392f43389ed56cfd461a8f1160e3be593 Mon Sep 17 00:00:00 2001
From: avsolatorio <avsolatorio@users.noreply.github.com>
Date: Fri, 18 Oct 2024 07:00:42 +0000
Subject: [PATCH] deploy: f08984f2ad5f50307bc47e83e42f676f35d11b8e

---
 .doctrees/environment.pickle | Bin 4306657 -> 4306657 bytes
 .doctrees/index.doctree      | Bin 3960582 -> 3960582 bytes
 index.html                   |   2 +-
 searchindex.js               |   2 +-
 4 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.doctrees/environment.pickle b/.doctrees/environment.pickle
index 0883c2208dbad8a4a4c565309503368e1eed0345..858da70c7fcae7aba3b931dd9bfae1c1ab854d0e 100644
GIT binary patch
delta 11593
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

delta 11579
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
F{ttg6Ss?%b

diff --git a/.doctrees/index.doctree b/.doctrees/index.doctree
index ea11af717bd705a61f2eaad0c43a6dc6c48a59a8..e2efacb80b28d5128d2794df20f4c1a5f404f2ca 100644
GIT binary patch
delta 10609
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

delta 10928
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
A8~^|S

diff --git a/index.html b/index.html
index e253e38..cb7e309 100644
--- a/index.html
+++ b/index.html
@@ -432,7 +432,7 @@ <h2>Installation<a class="headerlink" href="#installation" title="Permalink to t
 <h2>Usage<a class="headerlink" href="#usage" title="Permalink to this heading">#</a></h2>
 <p>We show examples of using the REaLTabFormer for modeling and generating synthetic data from a trained model.</p>
 <blockquote>
-<div><p>[!INFO]
+<div><p>[!NOTE]
 The model implements an optimal stopping criterion based on the synthetic data distribution when training a non-relational tabular model.
 The model will stop training when the synthetic data distribution is close to the real data distribution.</p>
 <p><strong>Make sure to set the <code class="docutils literal notranslate"><span class="pre">epochs</span></code> parameter to a large number to allow the model to fit the data better.</strong>
diff --git a/searchindex.js b/searchindex.js
index 9528a77..7de8300 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["autoapi/index", "autoapi/realtabformer/__main__/index", "autoapi/realtabformer/data_utils/index", "autoapi/realtabformer/index", "autoapi/realtabformer/realtabformer/index", "autoapi/realtabformer/rtf_analyze/index", "autoapi/realtabformer/rtf_datacollator/index", "autoapi/realtabformer/rtf_exceptions/index", "autoapi/realtabformer/rtf_sampler/index", "autoapi/realtabformer/rtf_trainer/index", "autoapi/realtabformer/rtf_validators/index", "index"], "filenames": ["autoapi/index.rst", "autoapi/realtabformer/__main__/index.rst", "autoapi/realtabformer/data_utils/index.rst", "autoapi/realtabformer/index.rst", "autoapi/realtabformer/realtabformer/index.rst", "autoapi/realtabformer/rtf_analyze/index.rst", "autoapi/realtabformer/rtf_datacollator/index.rst", "autoapi/realtabformer/rtf_exceptions/index.rst", "autoapi/realtabformer/rtf_sampler/index.rst", "autoapi/realtabformer/rtf_trainer/index.rst", "autoapi/realtabformer/rtf_validators/index.rst", "index.rst"], "titles": ["API Reference", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer.__main__</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer.data_utils</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer.realtabformer</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer.rtf_analyze</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer.rtf_datacollator</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer.rtf_exceptions</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer.rtf_sampler</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer.rtf_trainer</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer.rtf_validators</span></code>", "REaLTabFormer"], "terms": {"thi": [0, 3, 4, 5, 6, 8, 9, 11], "page": 0, "contain": [0, 3, 4, 5, 8], "auto": 0, "gener": [0, 3, 4, 5, 7, 8, 11], "document": 0, "1": [0, 3, 4, 5, 8, 11], "realtabform": 0, "__main__": [0, 3, 11], "data_util": [0, 3, 11], "rtf_analyz": [0, 3, 11], "rtf_datacol": [0, 3, 11], "rtf_except": [0, 3, 11], "rtf_sampler": [0, 3, 11], "rtf_trainer": [0, 3, 11], "rtf_valid": [0, 3, 4, 8, 11], "creat": [0, 11], "sphinx": 0, "autoapi": 0, "entri": 1, "point": [1, 11], "when": [1, 3, 4, 6, 7, 9, 11], "invok": 1, "python": [1, 11], "m": 1, "teacher_forcing_pr": 2, "_teacherforc": 2, "sourc": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11], "special_col_sep": 2, "___": 2, "numeric_na_token": 2, "invalid_nums_r": 2, "0": [2, 3, 4, 5, 8, 11], "9": 2, "tabularartefact": 2, "best_disc_model": 2, "str": [2, 3, 4, 5, 6, 7, 8, 10], "best": [2, 3, 4], "disc": 2, "model": [2, 3, 4, 5, 8, 9, 11], "mean_best_disc_model": 2, "mean": [2, 3, 4], "not_best_disc_model": 2, "last_epoch_model": 2, "last": 2, "epoch": [2, 3, 4, 9, 11], "static": [2, 5, 8], "artefact": [2, 11], "modelfilenam": 2, "rtf_config_json": 2, "rtf_config": 2, "json": 2, "rtf_model_pt": 2, "rtf_model": [2, 8, 11], "pt": [2, 6], "name": [2, 3, 4, 5, 10, 11], "modeltyp": 2, "tabular": [2, 3, 4, 8], "relat": [2, 3, 4, 8], "type": [2, 5, 6, 9, 11], "coldatatyp": 2, "numer": [2, 5], "datetim": 2, "categor": [2, 3, 4, 5, 8], "specialtoken": 2, "unk": 2, "sep": 2, "pad": [2, 6], "cl": 2, "mask": 2, "bo": [2, 8], "eo": [2, 8], "bmem": [2, 8], "emem": [2, 8], "rmask": 2, "sptype": 2, "token": [2, 3, 4, 8, 9], "get_uuid": 2, "fix_multi_decim": 2, "v": [2, 11], "build_vocab": 2, "df": [2, 3, 4, 10, 11], "panda": [2, 3, 4, 5, 8, 10, 11], "datafram": [2, 3, 4, 5, 8, 10], "none": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11], "special_token": 2, "add_column": 2, "bool": [2, 3, 4, 5, 8, 10], "true": [2, 3, 4, 5, 8, 11], "process_numeric_data": 2, "seri": [2, 3, 4, 5, 8, 10], "max_len": 2, "int": [2, 3, 4, 5, 6, 8, 9, 10], "10": [2, 3, 4, 8, 11], "numeric_precis": [2, 3, 4], "4": [2, 3, 4, 5, 11], "transform_data": 2, "dict": [2, 3, 4, 5, 8, 9, 10], "tupl": [2, 9, 10], "process_datetime_data": 2, "process_categorical_data": 2, "encode_partition_numeric_col": 2, "col": [2, 8, 10], "tr": 2, "col_zfil": 2, "decode_partition_numeric_col": 2, "partition_col": 2, "tokenize_numeric_col": 2, "npart": 2, "2": [2, 3, 4, 5, 8, 11], "encode_column_valu": 2, "decode_column_valu": 2, "encode_processed_column": 2, "idx": 2, "dtype": 2, "decode_processed_column": 2, "extract_processed_column": 2, "is_numeric_col": 2, "is_datetime_col": 2, "is_categorical_col": 2, "is_numeric_datetime_col": 2, "process_data": 2, "numeric_max_len": [2, 3, 4], "numeric_npart": [2, 3, 4], "first_col_typ": 2, "col_transform_data": [2, 8], "target_col": [2, 3, 4, 5, 8], "get_token_id": 2, "vocab_token2id": 2, "mask_rat": [2, 3, 4], "float": [2, 3, 4, 5, 10], "get_input_id": 2, "exampl": [2, 3, 4, 11], "vocab": [2, 8], "column": [2, 3, 4, 5, 8, 11], "list": [2, 3, 4, 5, 6, 8, 9], "return_label_id": 2, "return_token_type_id": 2, "fals": [2, 3, 4, 5], "affix_bo": 2, "affix_eo": 2, "make_dataset": 2, "dataset": [2, 3, 4, 9, 11], "get_relational_input_id": 2, "input_idx": 2, "output_dataset": 2, "in_out_idx": 2, "output_max_length": [2, 3, 4, 11], "make_relational_dataset": 2, "in_df": [2, 3, 4, 11], "out_df": [2, 3, 4], "model_typ": [3, 4, 5, 8, 11], "tabular_config": [3, 4], "transform": [3, 4, 6, 8, 9, 11], "gpt2": [3, 4], "gpt2config": [3, 4], "relational_config": [3, 4], "encoderdecoderconfig": [3, 4], "parent_realtabformer_path": [3, 4, 11], "pathlib": [3, 4, 11], "path": [3, 4, 11], "freeze_parent_model": [3, 4], "checkpoints_dir": [3, 4], "rtf_checkpoint": [3, 4], "samples_save_dir": [3, 4], "rtf_sampl": [3, 4], "1000": [3, 4, 5], "batch_siz": [3, 4, 11], "8": [3, 4, 11], "random_st": [3, 4, 5, 8], "1029": [3, 4, 5, 8], "train_siz": [3, 4, 11], "512": [3, 4, 11], "early_stopping_pati": [3, 4], "5": [3, 4, 5, 6, 11], "early_stopping_threshold": [3, 4], "training_args_kwarg": [3, 4], "_invalid_model_typ": [3, 4], "_init_tabular": [3, 4], "_init_rel": [3, 4], "_extract_column_info": [3, 4], "_generate_vocab": [3, 4], "_check_model": [3, 4], "_split_train_eval_dataset": [3, 4], "fit": [3, 4, 11], "join_on": [3, 4, 11], "resume_from_checkpoint": [3, 4], "devic": [3, 4, 8], "cuda": [3, 4, 8], "num_bootstrap": [3, 4, 5, 11], "500": [3, 4, 11], "frac": [3, 4, 5], "165": [3, 4], "frac_max_data": [3, 4], "10000": [3, 4], "qt_max": [3, 4, 5], "05": [3, 4, 5], "qt_max_default": [3, 4], "qt_interv": [3, 4, 5], "100": [3, 4, 5, 6, 11], "qt_interval_uniqu": [3, 4], "distanc": [3, 4, 5], "sklearn": [3, 4, 5, 11], "metric": [3, 4, 5], "pairwis": [3, 4, 5], "manhattan_dist": [3, 4, 5], "quantil": [3, 4, 5], "95": [3, 4, 5], "n_critic": [3, 4], "n_critic_stop": [3, 4], "gen_round": [3, 4], "3": [3, 4, 5, 8, 11], "sensitivity_max_col_num": [3, 4], "20": [3, 4], "use_k": [3, 4, 5], "full_sensit": [3, 4, 5], "sensitivity_orig_frac_multipl": [3, 4, 5], "orig_samples_round": [3, 4], "load_from_best_mean_sensit": [3, 4], "train": [3, 4, 5, 9, 11], "data": [3, 4, 5, 6, 8], "paramet": [3, 4, 5, 6, 11], "dure": [3, 4], "sampl": [3, 4, 5, 7, 8], "goe": [3, 4], "decod": [3, 4], "observ": [3, 4, 5, 7, 8, 11], "from": [3, 4, 5, 6, 11], "which": [3, 4, 5, 7, 11], "encod": [3, 4, 5], "link": [3, 4], "tabl": [3, 4, 11], "If": [3, 4, 6], "resum": [3, 4], "latest": [3, 4], "checkpoint": [3, 4, 9], "given": [3, 4, 5, 8], "where": [3, 4, 11], "run": [3, 4], "us": [3, 4, 5, 6, 8, 11], "torch": [3, 4, 8, 9], "e": [3, 4], "g": [3, 4, 11], "cpu": [3, 4], "mp": [3, 4], "experiment": [3, 4], "number": [3, 4, 5, 8, 9, 10, 11], "bootstrap": [3, 4, 5], "The": [3, 4, 5, 6, 8, 9, 11], "fraction": [3, 4], "maximum": [3, 4, 6], "row": [3, 4, 5], "have": [3, 4, 5, 9, 11], "discrimin": [3, 4, 5], "default": [3, 4, 5, 6, 11], "interv": [3, 4], "check": [3, 4], "process": [3, 4, 5], "valu": [3, 4, 5, 6, 8, 9], "between": [3, 4, 5, 11], "perform": [3, 4, 5], "assess": [3, 4, 5], "critic": [3, 4], "round": [3, 4, 5], "without": [3, 4, 5, 7, 11], "improv": [3, 4, 11], "after": [3, 4, 7], "stop": [3, 4, 11], "comput": [3, 4, 5, 6], "sensit": [3, 4, 5], "whether": [3, 4, 5], "k": [3, 4], "test": [3, 4, 5], "full": [3, 4, 5], "size": [3, 4, 5], "rel": [3, 4, 5, 8], "chosen": [3, 4, 5], "larger": [3, 4, 5], "i": [3, 4, 5, 6, 7, 8, 9, 11], "more": [3, 4, 5], "robust": [3, 4, 5], "threshold": [3, 4, 5], "howev": [3, 4, 5], "multipli": [3, 4, 5], "must": [3, 4, 5, 9, 11], "less": [3, 4, 5], "than": [3, 4, 5], "hold": [3, 4], "out": [3, 4, 11], "load": [3, 4, 11], "target": [3, 4, 5, 8], "return": [3, 4, 5, 6, 7, 8, 9], "trainer": [3, 4, 9], "_train_with_sensit": [3, 4], "_set_up_relational_coder_config": [3, 4], "_fit_rel": [3, 4], "_fit_tabular": [3, 4], "num_train_epoch": [3, 4], "target_epoch": [3, 4, 9], "_build_tabular_train": [3, 4], "n_sampl": [3, 4, 8, 11], "input_unique_id": [3, 4, 8, 11], "input_df": [3, 4, 8, 11], "input_id": [3, 4, 8], "tensor": [3, 4, 6, 8, 9], "gen_batch": [3, 4, 8, 11], "128": [3, 4, 8], "seed_input": [3, 4, 8], "ani": [3, 4, 5, 8, 10, 11], "save_sampl": [3, 4], "constrain_tokens_gen": [3, 4, 8], "valid": [3, 4, 7, 8, 10], "observationvalid": [3, 4, 8, 10, 11], "continuous_empty_limit": [3, 4, 8], "suppress_token": [3, 4, 8], "forced_decoder_id": [3, 4, 8], "related_num": [3, 4, 8], "generate_kwarg": [3, 4, 8], "synthet": [3, 4, 5], "uniqu": [3, 4, 11], "identifi": [3, 4, 11], "input": [3, 4, 5, 6, 7], "note": [3, 4, 5, 11], "argument": [3, 4, 5, 9], "prefer": [3, 4], "condit": [3, 4], "control": [3, 4, 9], "batch": [3, 4, 8], "should": [3, 4, 5, 9], "adjust": [3, 4], "base": [3, 4, 5, 7, 8, 9, 10, 11], "resourc": [3, 4], "A": [3, 4, 5, 11], "dictionari": [3, 4], "col_nam": [3, 4], "seed": [3, 4, 5], "onli": [3, 4, 5], "ar": [3, 4, 6, 8, 11], "actual": [3, 4, 5], "first": [3, 4, 5], "sequenc": [3, 4, 6, 11], "set": [3, 4, 5, 6, 7, 9, 11], "we": [3, 4, 5, 11], "impos": [3, 4], "constraint": [3, 4], "each": [3, 4, 5, 9], "step": [3, 4, 8, 9, 11], "limit": [3, 4, 7], "an": [3, 4, 9, 11], "instanc": [3, 4], "appli": [3, 4, 5], "don": [3, 4, 11], "t": [3, 4, 11], "support": [3, 4, 11], "inter": [3, 4], "see": [3, 4, 6], "doc": [3, 4], "how": [3, 4], "up": [3, 4, 9], "continuous_invalid_limit": [3, 4], "rais": [3, 4, 7], "except": [3, 4, 7], "empti": [3, 4, 7], "been": [3, 4, 9, 11], "produc": [3, 4, 8], "continu": [3, 4, 7, 9], "prevent": [3, 4], "infinit": [3, 4], "loop": [3, 4], "qualiti": [3, 4], "good": [3, 4], "alwai": [3, 4], "invalid": [3, 4, 11], "supress": [3, 4], "supresstoken": [3, 4], "logit": [3, 4], "processor": [3, 4, 5], "log": [3, 4], "prob": [3, 4], "inf": [3, 4], "so": [3, 4, 5], "thei": [3, 4, 11], "featur": [3, 4, 5, 6], "imput": [3, 4], "miss": [3, 4], "pair": [3, 4], "integ": [3, 4], "indic": [3, 4, 5], "map": [3, 4], "forc": [3, 4, 9, 11], "befor": [3, 4, 9], "For": [3, 4, 5], "123": [3, 4], "second": [3, 4], "index": [3, 4, 8, 11], "constrain": [3, 4, 8], "specif": [3, 4, 7], "stratif": [3, 4], "variabl": [3, 4, 8], "survei": [3, 4], "geo1": [3, 4], "urban": [3, 4], "rural": [3, 4], "child": [3, 4, 11], "expect": [3, 4, 5, 8], "parent": [3, 4, 11], "It": [3, 4, 5], "can": [3, 4, 5, 11], "also": [3, 4, 11], "correspond": [3, 4], "same": [3, 4, 5, 11], "addit": [3, 4, 11], "keyword": [3, 4], "suppli": [3, 4], "method": [3, 4, 5, 8, 9, 11], "comprehens": [3, 4], "http": [3, 4, 11], "huggingfac": [3, 4, 6, 11], "co": [3, 4], "v4": [3, 4], "24": [3, 4], "en": [3, 4], "main_class": [3, 4], "text_gener": [3, 4], "generation_util": [3, 4], "generationmixin": [3, 4], "predict": [3, 4, 5, 8], "target_pos_v": [3, 4, 5, 8], "32": [3, 4, 8], "obs_sampl": [3, 4, 8], "30": [3, 4, 8], "fillunk": [3, 4, 8], "disable_progress_bar": [3, 4, 8], "make": [3, 4, 5, 9, 11], "form": [3, 4], "posit": [3, 4, 8], "binari": [3, 4], "classif": [3, 4], "one": [3, 4, 5, 8], "mani": [3, 4, 5, 8], "multi": [3, 4, 8], "function": [3, 5, 6], "fill": [3, 4, 8], "unknown": [3, 4, 8], "mode": [3, 4, 8], "either": [3, 4, 9], "pass": [3, 4, 9, 11], "": [3, 4, 11], "save": [3, 4, 5, 9, 11], "allow_overwrit": [3, 4], "weight": [3, 4], "configur": [3, 4], "file": [3, 4, 11], "directori": [3, 4, 11], "param": [3, 4, 9], "classmethod": [3, 4], "load_from_dir": [3, 4, 11], "implement": [4, 5, 8, 11], "_normalize_gpt2_state_dict": 4, "state_dict": 4, "_validate_get_devic": 4, "syntheticdatabench": 5, "test_siz": 5, "test_df": 5, "handl": 5, "all": [5, 11], "need": 5, "register_synthetic_data": 5, "regist": 5, "split": 5, "accord": 5, "n_train": 5, "n_test": 5, "done": [5, 9], "replac": 5, "arg": [5, 9, 10], "least": 5, "compute_distance_to_closest_record": 5, "origin": 5, "want": [5, 11], "compar": 5, "ideal": 5, "measure_ml_effici": 5, "baseestim": 5, "provid": [5, 6, 11], "both": [5, 11], "pd": [5, 11], "preprocess_data": 5, "other": [5, 11], "fillna": 5, "preprocess": 5, "mix": 5, "matrix": 5, "extract": 5, "pipelin": 5, "hot": 5, "standard": 5, "preprocessor": 5, "column_nam": 5, "new": [5, 11], "option": [5, 6], "compute_discriminator_predict": 5, "build": [5, 11], "attempt": 5, "distinguish": 5, "next": 5, "add": 5, "label": [5, 6], "combin": 5, "final": 5, "classifi": 5, "logisticregress": 5, "scikit": 5, "learn": 5, "proport": 5, "includ": [5, 11], "random": 5, "y_test": 5, "y_pred": 5, "get_dcr": 5, "is_test": 5, "get": [5, 11], "dcr": 5, "experi": [5, 11], "get_ml_effici": 5, "ml": 5, "effici": 5, "get_discriminator_perform": 5, "compute_data_copying_predict": 5, "compute_sensitivity_metr": 5, "tsvd": 5, "decomposit": 5, "truncatedsvd": 5, "max_col_num": 5, "50": [5, 11], "verbos": 5, "compute_sensitivity_threshold": 5, "train_data": 5, "return_valu": 5, "estim": 5, "deriv": 5, "becaus": 5, "detect": 5, "tend": 5, "closer": 5, "statist": 5, "synth_min": 5, "test_min": 5, "systemat": 5, "copi": [5, 11], "statict": 5, "becom": 5, "instead": 5, "singl": [5, 8], "boostrap": 5, "syntheticdataexperi": 5, "data_id": 5, "n": 5, "x": [5, 11], "analysi": 5, "relationaldatacol": 6, "collat": 6, "dynam": 6, "receiv": 6, "well": 6, "adopt": 6, "datacollatorforseq2seq": 6, "max_length": [6, 8], "length": 6, "abov": 6, "pad_to_multiple_of": 6, "multipl": 6, "especi": 6, "enabl": 6, "core": 6, "nvidia": 6, "hardwar": 6, "capabl": 6, "7": [6, 11], "volta": 6, "label_pad_token_id": 6, "id": [6, 11], "automat": 6, "ignor": 6, "pytorch": 6, "loss": 6, "return_tensor": 6, "allow": [6, 11], "np": 6, "tf": 6, "__call__": 6, "sampleemptyerror": 7, "messag": 7, "in_siz": 7, "salari": 7, "caus": 7, "error": 7, "explan": 7, "__str__": 7, "self": 7, "sampleemptylimiterror": 7, "still": [7, 11], "some": [7, 11], "algorithm": 8, "nq_col": 8, "_nq_ds_": 8, "realsampl": 8, "pretrainedmodel": [8, 9], "processed_column": 8, "col_siz": 8, "col_idx_id": 8, "datetime_column": 8, "column_dtyp": 8, "column_has_miss": 8, "drop_na_col": 8, "abstract": [8, 10], "_prefix_allowed_tokens_fn": 8, "batch_id": 8, "_convert_to_t": 8, "synth_df": 8, "_gener": 8, "as_numpi": 8, "numpi": [8, 10], "ndarrai": 8, "_validate_synth_sampl": 8, "synth_sampl": 8, "_recover_data_valu": 8, "_processes_sampl": 8, "sample_output": 8, "relate_id": 8, "_validate_data": 8, "_validate_miss": 8, "tabularsampl": 8, "sampler": 8, "sampler_from_model": 8, "_process_seed_input": 8, "sample_tabular": 8, "relationalsampl": 8, "in_col_transform_data": 8, "sample_rel": 8, "_get_min_max_length": 8, "_sample_input_batch": 8, "_get_relational_col_idx_id": 8, "len_id": 8, "equal": 8, "per": 8, "logger": 9, "saveepochendcallback": 9, "save_epoch": 9, "trainercallback": 9, "callback": 9, "end": 9, "on_epoch_end": 9, "trainingargu": 9, "state": [9, 11], "trainerst": 9, "trainercontrol": 9, "kwarg": [9, 10], "resumabletrain": 9, "nn": 9, "data_col": 9, "datacol": 9, "train_dataset": 9, "eval_dataset": 9, "pretrainedtokenizerbas": 9, "model_init": 9, "callabl": 9, "compute_metr": 9, "evalpredict": 9, "optim": [9, 11], "lr_schedul": 9, "lambdalr": 9, "preprocess_logits_for_metr": 9, "schedul": 9, "consist": 9, "over": 9, "paus": 9, "similar": 9, "intermitt": 9, "create_schedul": 9, "num_training_step": 9, "setup": 9, "call": 9, "do": 9, "validatorbas": 10, "rangevalid": 10, "min_val": 10, "max_val": 10, "val": 10, "geovalid": [10, 11], "geo_bound": 10, "shape": [10, 11], "geometri": [10, 11], "polygon": [10, 11], "multipolygon": [10, 11], "lon": 10, "lat": 10, "validate_df": 10, "add_valid": [10, 11], "remove_valid": 10, "realist": 11, "offer": 11, "unifi": 11, "framework": 11, "synthes": 11, "differ": 11, "seq2seq": 11, "non": 11, "gpt": 11, "box": 11, "independ": 11, "paper": 11, "arxiv": 11, "avail": 11, "pypi": 11, "easili": 11, "pip": 11, "version": 11, "show": 11, "info": 11, "criterion": 11, "distribut": 11, "close": 11, "real": 11, "sure": 11, "larg": 11, "better": 11, "met": 11, "import": 11, "read_csv": 11, "foo": 11, "csv": 11, "remov": 11, "you": 11, "gradient_accumulation_step": 11, "logging_step": 11, "current": 11, "In": 11, "idxxxx": 11, "store": 11, "len": 11, "rtf_model2": 11, "o": 11, "parent_df": 11, "child_df": 11, "bar": 11, "unique_id": 11, "kei": 11, "assert": 11, "field": 11, "parent_model": 11, "drop": 11, "axi": 11, "pdir": 11, "rtf_parent": 11, "most": 11, "recent": 11, "specifi": 11, "parent_model_path": 11, "idxxx": 11, "sort": 11, "p": 11, "glob": 11, "is_dir": 11, "getmtim": 11, "child_model": 11, "parent_sampl": 11, "parend_df": 11, "reset_index": 11, "child_sampl": 11, "64": 11, "interfac": 11, "filter": 11, "below": 11, "chart": 11, "left": 11, "latitud": 11, "longitud": 11, "right": 11, "california": 11, "boundari": 11, "even": 11, "did": 11, "fall": 11, "outsid": 11, "scarc": 11, "geopanda": 11, "dev": 11, "null": 11, "git": 11, "clone": 11, "github": 11, "com": 11, "joncutr": 11, "tutori": 11, "seaborn": 11, "sn": 11, "matplotlib": 11, "pyplot": 11, "plt": 11, "rtf_val": 11, "linestr": 11, "fetch_california_h": 11, "def": 11, "plot_sf": 11, "titl": 11, "xlim": 11, "126": 11, "113": 11, "ylim": 11, "31": 11, "43": 11, "bin": 11, "dd": 11, "pp": 11, "loc": 11, "min": 11, "max": 11, "jointgrid": 11, "y": 11, "marginal_tick": 11, "plot_joint": 11, "histplot": 11, "plot": 11, "ax": 11, "ax_joint": 11, "set_xlim": 11, "set_ylim": 11, "plot_margin": 11, "element": 11, "color": 11, "03012d": 11, "set_titl": 11, "tight_layout": 11, "geograph": 11, "read_fil": 11, "usa": 11, "censu": 11, "2014": 11, "shp": 11, "to_cr": 11, "epsg": 11, "4326": 11, "gp": 11, "project": 11, "hous": 11, "as_fram": 11, "frame": 11, "small": 11, "demo": 11, "200": 11, "reduc": 11, "raw": 11, "samples_raw": 11, "10240": 11, "obs_valid": 11, "geo_valid": 11, "samples_valid": 11, "visual": 11, "pleas": 11, "cite": 11, "our": 11, "work": 11, "your": 11, "research": 11, "articl": 11, "solatorio2023realtabform": 11, "author": 11, "solatorio": 11, "aivin": 11, "dupriez": 11, "olivi": 11, "journal": 11, "preprint": 11, "2302": 11, "02041": 11, "year": 11, "2023": 11, "thank": 11, "world": 11, "bank": 11, "unhcr": 11, "joint": 11, "center": 11, "displac": 11, "jdc": 11, "fund": 11, "enhanc": 11, "respons": 11, "microdata": 11, "access": 11, "polici": 11, "situat": 11, "kp": 11, "p174174": 11, "ginp": 11, "tf0b5124": 11, "part": 11, "went": 11, "develop": 11, "wa": 11, "popul": 11, "disclosur": 11, "risk": 11, "mosaic": 11, "effect": 11, "send": 11, "hug": 11, "open": 11, "softwar": 11, "releas": 11, "And": 11, "api": 11, "refer": 11, "submodul": 11, "packag": 11, "class": 11}, "objects": {"": [[3, 0, 0, "-", "realtabformer"]], "realtabformer": [[3, 1, 1, "", "REaLTabFormer"], [1, 0, 0, "-", "__main__"], [2, 0, 0, "-", "data_utils"], [4, 0, 0, "-", "realtabformer"], [5, 0, 0, "-", "rtf_analyze"], [6, 0, 0, "-", "rtf_datacollator"], [7, 0, 0, "-", "rtf_exceptions"], [8, 0, 0, "-", "rtf_sampler"], [9, 0, 0, "-", "rtf_trainer"], [10, 0, 0, "-", "rtf_validators"]], "realtabformer.REaLTabFormer": [[3, 2, 1, "", "_build_tabular_trainer"], [3, 2, 1, "", "_check_model"], [3, 2, 1, "", "_extract_column_info"], [3, 2, 1, "", "_fit_relational"], [3, 2, 1, "", "_fit_tabular"], [3, 2, 1, "", "_generate_vocab"], [3, 2, 1, "", "_init_relational"], [3, 2, 1, "", "_init_tabular"], [3, 2, 1, "", "_invalid_model_type"], [3, 2, 1, "", "_set_up_relational_coder_configs"], [3, 2, 1, "", "_split_train_eval_dataset"], [3, 2, 1, "", "_train_with_sensitivity"], [3, 2, 1, "", "fit"], [3, 2, 1, "", "load_from_dir"], [3, 2, 1, "", "predict"], [3, 2, 1, "", "sample"], [3, 2, 1, "", "save"]], "realtabformer.data_utils": [[2, 1, 1, "", "ColDataType"], [2, 4, 1, "", "INVALID_NUMS_RE"], [2, 1, 1, "", "ModelFileName"], [2, 1, 1, "", "ModelType"], [2, 4, 1, "", "NUMERIC_NA_TOKEN"], [2, 4, 1, "", "SPECIAL_COL_SEP"], [2, 1, 1, "", "SpecialTokens"], [2, 4, 1, "", "TEACHER_FORCING_PRE"], [2, 1, 1, "", "TabularArtefact"], [2, 5, 1, "", "build_vocab"], [2, 5, 1, "", "decode_column_values"], [2, 5, 1, "", "decode_partition_numeric_col"], [2, 5, 1, "", "decode_processed_column"], [2, 5, 1, "", "encode_column_values"], [2, 5, 1, "", "encode_partition_numeric_col"], [2, 5, 1, "", "encode_processed_column"], [2, 5, 1, "", "extract_processed_column"], [2, 5, 1, "", "fix_multi_decimal"], [2, 5, 1, "", "get_input_ids"], [2, 5, 1, "", "get_relational_input_ids"], [2, 5, 1, "", "get_token_id"], [2, 5, 1, "", "get_uuid"], [2, 5, 1, "", "is_categorical_col"], [2, 5, 1, "", "is_datetime_col"], [2, 5, 1, "", "is_numeric_col"], [2, 5, 1, "", "is_numeric_datetime_col"], [2, 5, 1, "", "make_dataset"], [2, 5, 1, "", "make_relational_dataset"], [2, 5, 1, "", "process_categorical_data"], [2, 5, 1, "", "process_data"], [2, 5, 1, "", "process_datetime_data"], [2, 5, 1, "", "process_numeric_data"], [2, 5, 1, "", "tokenize_numeric_col"]], "realtabformer.data_utils.ColDataType": [[2, 3, 1, "", "CATEGORICAL"], [2, 3, 1, "", "DATETIME"], [2, 3, 1, "", "NUMERIC"], [2, 2, 1, "", "types"]], "realtabformer.data_utils.ModelFileName": [[2, 2, 1, "", "names"], [2, 3, 1, "", "rtf_config_json"], [2, 3, 1, "", "rtf_model_pt"]], "realtabformer.data_utils.ModelType": [[2, 3, 1, "", "relational"], [2, 3, 1, "", "tabular"], [2, 2, 1, "", "types"]], "realtabformer.data_utils.SpecialTokens": [[2, 3, 1, "", "BMEM"], [2, 3, 1, "", "BOS"], [2, 3, 1, "", "CLS"], [2, 3, 1, "", "EMEM"], [2, 3, 1, "", "EOS"], [2, 3, 1, "", "MASK"], [2, 3, 1, "", "PAD"], [2, 3, 1, "", "RMASK"], [2, 3, 1, "", "SEP"], [2, 3, 1, "", "SPTYPE"], [2, 3, 1, "", "UNK"], [2, 2, 1, "", "tokens"]], "realtabformer.data_utils.TabularArtefact": [[2, 2, 1, "", "artefacts"], [2, 3, 1, "", "best_disc_model"], [2, 3, 1, "", "last_epoch_model"], [2, 3, 1, "", "mean_best_disc_model"], [2, 3, 1, "", "not_best_disc_model"]], "realtabformer.realtabformer": [[4, 1, 1, "", "REaLTabFormer"], [4, 5, 1, "", "_normalize_gpt2_state_dict"], [4, 5, 1, "", "_validate_get_device"]], "realtabformer.realtabformer.REaLTabFormer": [[4, 2, 1, "", "_build_tabular_trainer"], [4, 2, 1, "", "_check_model"], [4, 2, 1, "", "_extract_column_info"], [4, 2, 1, "", "_fit_relational"], [4, 2, 1, "", "_fit_tabular"], [4, 2, 1, "", "_generate_vocab"], [4, 2, 1, "", "_init_relational"], [4, 2, 1, "", "_init_tabular"], [4, 2, 1, "", "_invalid_model_type"], [4, 2, 1, "", "_set_up_relational_coder_configs"], [4, 2, 1, "", "_split_train_eval_dataset"], [4, 2, 1, "", "_train_with_sensitivity"], [4, 2, 1, "", "fit"], [4, 2, 1, "", "load_from_dir"], [4, 2, 1, "", "predict"], [4, 2, 1, "", "sample"], [4, 2, 1, "", "save"]], "realtabformer.rtf_analyze": [[5, 1, 1, "", "SyntheticDataBench"], [5, 1, 1, "", "SyntheticDataExperiment"]], "realtabformer.rtf_analyze.SyntheticDataBench": [[5, 2, 1, "", "compute_data_copying_predictions"], [5, 2, 1, "", "compute_discriminator_predictions"], [5, 2, 1, "", "compute_distance_to_closest_records"], [5, 2, 1, "", "compute_sensitivity_metric"], [5, 2, 1, "", "compute_sensitivity_threshold"], [5, 2, 1, "", "get_dcr"], [5, 2, 1, "", "get_discriminator_performance"], [5, 2, 1, "", "get_ml_efficiency"], [5, 2, 1, "", "measure_ml_efficiency"], [5, 2, 1, "", "preprocess_data"], [5, 2, 1, "", "register_synthetic_data"]], "realtabformer.rtf_datacollator": [[6, 1, 1, "", "RelationalDataCollator"]], "realtabformer.rtf_datacollator.RelationalDataCollator": [[6, 2, 1, "", "__call__"], [6, 3, 1, "", "label_pad_token_id"], [6, 3, 1, "", "max_length"], [6, 3, 1, "", "pad_to_multiple_of"], [6, 3, 1, "", "return_tensors"]], "realtabformer.rtf_exceptions": [[7, 6, 1, "", "SampleEmptyError"], [7, 6, 1, "", "SampleEmptyLimitError"]], "realtabformer.rtf_exceptions.SampleEmptyError": [[7, 2, 1, "", "__str__"]], "realtabformer.rtf_sampler": [[8, 4, 1, "", "NQ_COL"], [8, 1, 1, "", "REaLSampler"], [8, 1, 1, "", "RelationalSampler"], [8, 1, 1, "", "TabularSampler"]], "realtabformer.rtf_sampler.REaLSampler": [[8, 2, 1, "", "_convert_to_table"], [8, 2, 1, "", "_generate"], [8, 2, 1, "", "_prefix_allowed_tokens_fn"], [8, 2, 1, "", "_processes_sample"], [8, 2, 1, "", "_recover_data_values"], [8, 2, 1, "", "_validate_data"], [8, 2, 1, "", "_validate_missing"], [8, 2, 1, "", "_validate_synth_sample"]], "realtabformer.rtf_sampler.RelationalSampler": [[8, 2, 1, "", "_get_min_max_length"], [8, 2, 1, "", "_get_relational_col_idx_ids"], [8, 2, 1, "", "_prefix_allowed_tokens_fn"], [8, 2, 1, "", "_sample_input_batch"], [8, 2, 1, "", "sample_relational"], [8, 2, 1, "", "sampler_from_model"]], "realtabformer.rtf_sampler.TabularSampler": [[8, 2, 1, "", "_prefix_allowed_tokens_fn"], [8, 2, 1, "", "_process_seed_input"], [8, 2, 1, "", "predict"], [8, 2, 1, "", "sample_tabular"], [8, 2, 1, "", "sampler_from_model"]], "realtabformer.rtf_trainer": [[9, 1, 1, "", "ResumableTrainer"], [9, 1, 1, "", "SaveEpochEndCallback"], [9, 4, 1, "", "logger"]], "realtabformer.rtf_trainer.ResumableTrainer": [[9, 2, 1, "", "create_scheduler"]], "realtabformer.rtf_trainer.SaveEpochEndCallback": [[9, 2, 1, "", "on_epoch_end"]], "realtabformer.rtf_validators": [[10, 1, 1, "", "GeoValidator"], [10, 1, 1, "", "ObservationValidator"], [10, 1, 1, "", "RangeValidator"], [10, 1, 1, "", "ValidatorBase"]], "realtabformer.rtf_validators.GeoValidator": [[10, 2, 1, "", "validate"]], "realtabformer.rtf_validators.ObservationValidator": [[10, 2, 1, "", "add_validator"], [10, 2, 1, "", "remove_validator"], [10, 2, 1, "", "validate"], [10, 2, 1, "", "validate_df"]], "realtabformer.rtf_validators.RangeValidator": [[10, 2, 1, "", "validate"]], "realtabformer.rtf_validators.ValidatorBase": [[10, 2, 1, "", "validate"]]}, "objtypes": {"0": "py:module", "1": "py:class", "2": "py:method", "3": "py:attribute", "4": "py:data", "5": "py:function", "6": "py:exception"}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "class", "Python class"], "2": ["py", "method", "Python method"], "3": ["py", "attribute", "Python attribute"], "4": ["py", "data", "Python data"], "5": ["py", "function", "Python function"], "6": ["py", "exception", "Python exception"]}, "titleterms": {"api": 0, "refer": 0, "realtabform": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11], "__main__": 1, "data_util": 2, "modul": [2, 4, 5, 6, 7, 8, 9, 10], "content": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11], "class": [2, 3, 4, 5, 6, 8, 9, 10], "function": [2, 4], "attribut": [2, 8, 9], "submodul": 3, "packag": 3, "rtf_analyz": 5, "rtf_datacol": 6, "rtf_except": 7, "rtf_sampler": 8, "rtf_trainer": 9, "rtf_valid": 10, "instal": 11, "usag": 11, "regular": 11, "tabular": 11, "data": 11, "relat": 11, "valid": 11, "synthet": 11, "sampl": 11, "citat": 11, "acknowledg": 11, "document": 11}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.intersphinx": 1, "sphinx.ext.viewcode": 1, "sphinx": 57}, "alltitles": {"API Reference": [[0, "api-reference"]], "realtabformer.__main__": [[1, "module-realtabformer.__main__"]], "realtabformer.data_utils": [[2, "module-realtabformer.data_utils"]], "Module Contents": [[2, "module-contents"], [4, "module-contents"], [5, "module-contents"], [6, "module-contents"], [7, "module-contents"], [8, "module-contents"], [9, "module-contents"], [10, "module-contents"]], "Classes": [[2, "classes"], [3, "classes"], [4, "classes"], [5, "classes"], [6, "classes"], [8, "classes"], [9, "classes"], [10, "classes"]], "Functions": [[2, "functions"], [4, "functions"]], "Attributes": [[2, "attributes"], [8, "attributes"], [9, "attributes"]], "realtabformer": [[3, "module-realtabformer"]], "Submodules": [[3, "submodules"]], "Package Contents": [[3, "package-contents"]], "realtabformer.realtabformer": [[4, "module-realtabformer.realtabformer"]], "realtabformer.rtf_analyze": [[5, "module-realtabformer.rtf_analyze"]], "realtabformer.rtf_datacollator": [[6, "module-realtabformer.rtf_datacollator"]], "realtabformer.rtf_exceptions": [[7, "module-realtabformer.rtf_exceptions"]], "realtabformer.rtf_sampler": [[8, "module-realtabformer.rtf_sampler"]], "realtabformer.rtf_trainer": [[9, "module-realtabformer.rtf_trainer"]], "realtabformer.rtf_validators": [[10, "module-realtabformer.rtf_validators"]], "REaLTabFormer": [[11, "realtabformer"]], "Installation": [[11, "installation"]], "Usage": [[11, "usage"]], "REaLTabFormer for regular tabular data": [[11, "realtabformer-for-regular-tabular-data"]], "REaLTabFormer for relational data": [[11, "realtabformer-for-relational-data"]], "Validators for synthetic samples": [[11, "validators-for-synthetic-samples"]], "Citation": [[11, "citation"]], "Acknowledgments": [[11, "acknowledgments"]], "Documentation": [[11, "documentation"]], "Contents": [[11, null]]}, "indexentries": {"module": [[1, "module-realtabformer.__main__"], [2, "module-realtabformer.data_utils"], [3, "module-realtabformer"], [4, "module-realtabformer.realtabformer"], [5, "module-realtabformer.rtf_analyze"], [6, "module-realtabformer.rtf_datacollator"], [7, "module-realtabformer.rtf_exceptions"], [8, "module-realtabformer.rtf_sampler"], [9, "module-realtabformer.rtf_trainer"], [10, "module-realtabformer.rtf_validators"]], "realtabformer.__main__": [[1, "module-realtabformer.__main__"]], "bmem (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.BMEM"]], "bos (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.BOS"]], "categorical (realtabformer.data_utils.coldatatype attribute)": [[2, "realtabformer.data_utils.ColDataType.CATEGORICAL"]], "cls (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.CLS"]], "coldatatype (class in realtabformer.data_utils)": [[2, "realtabformer.data_utils.ColDataType"]], "datetime (realtabformer.data_utils.coldatatype attribute)": [[2, "realtabformer.data_utils.ColDataType.DATETIME"]], "emem (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.EMEM"]], "eos (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.EOS"]], "invalid_nums_re (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.INVALID_NUMS_RE"]], "mask (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.MASK"]], "modelfilename (class in realtabformer.data_utils)": [[2, "realtabformer.data_utils.ModelFileName"]], "modeltype (class in realtabformer.data_utils)": [[2, "realtabformer.data_utils.ModelType"]], "numeric (realtabformer.data_utils.coldatatype attribute)": [[2, "realtabformer.data_utils.ColDataType.NUMERIC"]], "numeric_na_token (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.NUMERIC_NA_TOKEN"]], "pad (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.PAD"]], "rmask (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.RMASK"]], "sep (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.SEP"]], "special_col_sep (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.SPECIAL_COL_SEP"]], "sptype (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.SPTYPE"]], "specialtokens (class in realtabformer.data_utils)": [[2, "realtabformer.data_utils.SpecialTokens"]], "teacher_forcing_pre (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.TEACHER_FORCING_PRE"]], "tabularartefact (class in realtabformer.data_utils)": [[2, "realtabformer.data_utils.TabularArtefact"]], "unk (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.UNK"]], "artefacts() (realtabformer.data_utils.tabularartefact static method)": [[2, "realtabformer.data_utils.TabularArtefact.artefacts"]], "best_disc_model (realtabformer.data_utils.tabularartefact attribute)": [[2, "realtabformer.data_utils.TabularArtefact.best_disc_model"]], "build_vocab() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.build_vocab"]], "decode_column_values() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.decode_column_values"]], "decode_partition_numeric_col() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.decode_partition_numeric_col"]], "decode_processed_column() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.decode_processed_column"]], "encode_column_values() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.encode_column_values"]], "encode_partition_numeric_col() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.encode_partition_numeric_col"]], "encode_processed_column() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.encode_processed_column"]], "extract_processed_column() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.extract_processed_column"]], "fix_multi_decimal() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.fix_multi_decimal"]], "get_input_ids() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.get_input_ids"]], "get_relational_input_ids() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.get_relational_input_ids"]], "get_token_id() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.get_token_id"]], "get_uuid() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.get_uuid"]], "is_categorical_col() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.is_categorical_col"]], "is_datetime_col() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.is_datetime_col"]], "is_numeric_col() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.is_numeric_col"]], "is_numeric_datetime_col() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.is_numeric_datetime_col"]], "last_epoch_model (realtabformer.data_utils.tabularartefact attribute)": [[2, "realtabformer.data_utils.TabularArtefact.last_epoch_model"]], "make_dataset() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.make_dataset"]], "make_relational_dataset() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.make_relational_dataset"]], "mean_best_disc_model (realtabformer.data_utils.tabularartefact attribute)": [[2, "realtabformer.data_utils.TabularArtefact.mean_best_disc_model"]], "names() (realtabformer.data_utils.modelfilename static method)": [[2, "realtabformer.data_utils.ModelFileName.names"]], "not_best_disc_model (realtabformer.data_utils.tabularartefact attribute)": [[2, "realtabformer.data_utils.TabularArtefact.not_best_disc_model"]], "process_categorical_data() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.process_categorical_data"]], "process_data() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.process_data"]], "process_datetime_data() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.process_datetime_data"]], "process_numeric_data() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.process_numeric_data"]], "realtabformer.data_utils": [[2, "module-realtabformer.data_utils"]], "relational (realtabformer.data_utils.modeltype attribute)": [[2, "realtabformer.data_utils.ModelType.relational"]], "rtf_config_json (realtabformer.data_utils.modelfilename attribute)": [[2, "realtabformer.data_utils.ModelFileName.rtf_config_json"]], "rtf_model_pt (realtabformer.data_utils.modelfilename attribute)": [[2, "realtabformer.data_utils.ModelFileName.rtf_model_pt"]], "tabular (realtabformer.data_utils.modeltype attribute)": [[2, "realtabformer.data_utils.ModelType.tabular"]], "tokenize_numeric_col() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.tokenize_numeric_col"]], "tokens() (realtabformer.data_utils.specialtokens static method)": [[2, "realtabformer.data_utils.SpecialTokens.tokens"]], "types() (realtabformer.data_utils.coldatatype static method)": [[2, "realtabformer.data_utils.ColDataType.types"]], "types() (realtabformer.data_utils.modeltype static method)": [[2, "realtabformer.data_utils.ModelType.types"]], "realtabformer (class in realtabformer)": [[3, "realtabformer.REaLTabFormer"]], "_build_tabular_trainer() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._build_tabular_trainer"]], "_check_model() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._check_model"]], "_extract_column_info() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._extract_column_info"]], "_fit_relational() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._fit_relational"]], "_fit_tabular() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._fit_tabular"]], "_generate_vocab() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._generate_vocab"]], "_init_relational() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._init_relational"]], "_init_tabular() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._init_tabular"]], "_invalid_model_type() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._invalid_model_type"]], "_set_up_relational_coder_configs() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._set_up_relational_coder_configs"]], "_split_train_eval_dataset() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._split_train_eval_dataset"]], "_train_with_sensitivity() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._train_with_sensitivity"]], "fit() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer.fit"]], "load_from_dir() (realtabformer.realtabformer class method)": [[3, "realtabformer.REaLTabFormer.load_from_dir"]], "predict() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer.predict"]], "realtabformer": [[3, "module-realtabformer"]], "sample() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer.sample"]], "save() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer.save"]], "realtabformer (class in realtabformer.realtabformer)": [[4, "realtabformer.realtabformer.REaLTabFormer"]], "_build_tabular_trainer() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._build_tabular_trainer"]], "_check_model() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._check_model"]], "_extract_column_info() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._extract_column_info"]], "_fit_relational() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._fit_relational"]], "_fit_tabular() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._fit_tabular"]], "_generate_vocab() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._generate_vocab"]], "_init_relational() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._init_relational"]], "_init_tabular() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._init_tabular"]], "_invalid_model_type() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._invalid_model_type"]], "_normalize_gpt2_state_dict() (in module realtabformer.realtabformer)": [[4, "realtabformer.realtabformer._normalize_gpt2_state_dict"]], "_set_up_relational_coder_configs() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._set_up_relational_coder_configs"]], "_split_train_eval_dataset() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._split_train_eval_dataset"]], "_train_with_sensitivity() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._train_with_sensitivity"]], "_validate_get_device() (in module realtabformer.realtabformer)": [[4, "realtabformer.realtabformer._validate_get_device"]], "fit() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer.fit"]], "load_from_dir() (realtabformer.realtabformer.realtabformer class method)": [[4, "realtabformer.realtabformer.REaLTabFormer.load_from_dir"]], "predict() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer.predict"]], "realtabformer.realtabformer": [[4, "module-realtabformer.realtabformer"]], "sample() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer.sample"]], "save() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer.save"]], "syntheticdatabench (class in realtabformer.rtf_analyze)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench"]], "syntheticdataexperiment (class in realtabformer.rtf_analyze)": [[5, "realtabformer.rtf_analyze.SyntheticDataExperiment"]], "compute_data_copying_predictions() (realtabformer.rtf_analyze.syntheticdatabench static method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.compute_data_copying_predictions"]], "compute_discriminator_predictions() (realtabformer.rtf_analyze.syntheticdatabench static method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.compute_discriminator_predictions"]], "compute_distance_to_closest_records() (realtabformer.rtf_analyze.syntheticdatabench static method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.compute_distance_to_closest_records"]], "compute_sensitivity_metric() (realtabformer.rtf_analyze.syntheticdatabench static method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.compute_sensitivity_metric"]], "compute_sensitivity_threshold() (realtabformer.rtf_analyze.syntheticdatabench static method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.compute_sensitivity_threshold"]], "get_dcr() (realtabformer.rtf_analyze.syntheticdatabench method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.get_dcr"]], "get_discriminator_performance() (realtabformer.rtf_analyze.syntheticdatabench method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.get_discriminator_performance"]], "get_ml_efficiency() (realtabformer.rtf_analyze.syntheticdatabench method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.get_ml_efficiency"]], "measure_ml_efficiency() (realtabformer.rtf_analyze.syntheticdatabench static method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.measure_ml_efficiency"]], "preprocess_data() (realtabformer.rtf_analyze.syntheticdatabench static method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.preprocess_data"]], "realtabformer.rtf_analyze": [[5, "module-realtabformer.rtf_analyze"]], "register_synthetic_data() (realtabformer.rtf_analyze.syntheticdatabench method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.register_synthetic_data"]], "relationaldatacollator (class in realtabformer.rtf_datacollator)": [[6, "realtabformer.rtf_datacollator.RelationalDataCollator"]], "__call__() (realtabformer.rtf_datacollator.relationaldatacollator method)": [[6, "realtabformer.rtf_datacollator.RelationalDataCollator.__call__"]], "label_pad_token_id (realtabformer.rtf_datacollator.relationaldatacollator attribute)": [[6, "realtabformer.rtf_datacollator.RelationalDataCollator.label_pad_token_id"]], "max_length (realtabformer.rtf_datacollator.relationaldatacollator attribute)": [[6, "realtabformer.rtf_datacollator.RelationalDataCollator.max_length"]], "pad_to_multiple_of (realtabformer.rtf_datacollator.relationaldatacollator attribute)": [[6, "realtabformer.rtf_datacollator.RelationalDataCollator.pad_to_multiple_of"]], "realtabformer.rtf_datacollator": [[6, "module-realtabformer.rtf_datacollator"]], "return_tensors (realtabformer.rtf_datacollator.relationaldatacollator attribute)": [[6, "realtabformer.rtf_datacollator.RelationalDataCollator.return_tensors"]], "sampleemptyerror": [[7, "realtabformer.rtf_exceptions.SampleEmptyError"]], "sampleemptylimiterror": [[7, "realtabformer.rtf_exceptions.SampleEmptyLimitError"]], "__str__() (realtabformer.rtf_exceptions.sampleemptyerror method)": [[7, "realtabformer.rtf_exceptions.SampleEmptyError.__str__"]], "realtabformer.rtf_exceptions": [[7, "module-realtabformer.rtf_exceptions"]], "nq_col (in module realtabformer.rtf_sampler)": [[8, "realtabformer.rtf_sampler.NQ_COL"]], "realsampler (class in realtabformer.rtf_sampler)": [[8, "realtabformer.rtf_sampler.REaLSampler"]], "relationalsampler (class in realtabformer.rtf_sampler)": [[8, "realtabformer.rtf_sampler.RelationalSampler"]], "tabularsampler (class in realtabformer.rtf_sampler)": [[8, "realtabformer.rtf_sampler.TabularSampler"]], "_convert_to_table() (realtabformer.rtf_sampler.realsampler method)": [[8, "realtabformer.rtf_sampler.REaLSampler._convert_to_table"]], "_generate() (realtabformer.rtf_sampler.realsampler method)": [[8, "realtabformer.rtf_sampler.REaLSampler._generate"]], "_get_min_max_length() (realtabformer.rtf_sampler.relationalsampler method)": [[8, "realtabformer.rtf_sampler.RelationalSampler._get_min_max_length"]], "_get_relational_col_idx_ids() (realtabformer.rtf_sampler.relationalsampler method)": [[8, "realtabformer.rtf_sampler.RelationalSampler._get_relational_col_idx_ids"]], "_prefix_allowed_tokens_fn() (realtabformer.rtf_sampler.realsampler method)": [[8, "realtabformer.rtf_sampler.REaLSampler._prefix_allowed_tokens_fn"]], "_prefix_allowed_tokens_fn() (realtabformer.rtf_sampler.relationalsampler method)": [[8, "realtabformer.rtf_sampler.RelationalSampler._prefix_allowed_tokens_fn"]], "_prefix_allowed_tokens_fn() (realtabformer.rtf_sampler.tabularsampler method)": [[8, "realtabformer.rtf_sampler.TabularSampler._prefix_allowed_tokens_fn"]], "_process_seed_input() (realtabformer.rtf_sampler.tabularsampler method)": [[8, "realtabformer.rtf_sampler.TabularSampler._process_seed_input"]], "_processes_sample() (realtabformer.rtf_sampler.realsampler method)": [[8, "realtabformer.rtf_sampler.REaLSampler._processes_sample"]], "_recover_data_values() (realtabformer.rtf_sampler.realsampler method)": [[8, "realtabformer.rtf_sampler.REaLSampler._recover_data_values"]], "_sample_input_batch() (realtabformer.rtf_sampler.relationalsampler method)": [[8, "realtabformer.rtf_sampler.RelationalSampler._sample_input_batch"]], "_validate_data() (realtabformer.rtf_sampler.realsampler method)": [[8, "realtabformer.rtf_sampler.REaLSampler._validate_data"]], "_validate_missing() (realtabformer.rtf_sampler.realsampler method)": [[8, "realtabformer.rtf_sampler.REaLSampler._validate_missing"]], "_validate_synth_sample() (realtabformer.rtf_sampler.realsampler method)": [[8, "realtabformer.rtf_sampler.REaLSampler._validate_synth_sample"]], "predict() (realtabformer.rtf_sampler.tabularsampler method)": [[8, "realtabformer.rtf_sampler.TabularSampler.predict"]], "realtabformer.rtf_sampler": [[8, "module-realtabformer.rtf_sampler"]], "sample_relational() (realtabformer.rtf_sampler.relationalsampler method)": [[8, "realtabformer.rtf_sampler.RelationalSampler.sample_relational"]], "sample_tabular() (realtabformer.rtf_sampler.tabularsampler method)": [[8, "realtabformer.rtf_sampler.TabularSampler.sample_tabular"]], "sampler_from_model() (realtabformer.rtf_sampler.relationalsampler static method)": [[8, "realtabformer.rtf_sampler.RelationalSampler.sampler_from_model"]], "sampler_from_model() (realtabformer.rtf_sampler.tabularsampler static method)": [[8, "realtabformer.rtf_sampler.TabularSampler.sampler_from_model"]], "resumabletrainer (class in realtabformer.rtf_trainer)": [[9, "realtabformer.rtf_trainer.ResumableTrainer"]], "saveepochendcallback (class in realtabformer.rtf_trainer)": [[9, "realtabformer.rtf_trainer.SaveEpochEndCallback"]], "create_scheduler() (realtabformer.rtf_trainer.resumabletrainer method)": [[9, "realtabformer.rtf_trainer.ResumableTrainer.create_scheduler"]], "logger (in module realtabformer.rtf_trainer)": [[9, "realtabformer.rtf_trainer.logger"]], "on_epoch_end() (realtabformer.rtf_trainer.saveepochendcallback method)": [[9, "realtabformer.rtf_trainer.SaveEpochEndCallback.on_epoch_end"]], "realtabformer.rtf_trainer": [[9, "module-realtabformer.rtf_trainer"]], "geovalidator (class in realtabformer.rtf_validators)": [[10, "realtabformer.rtf_validators.GeoValidator"]], "observationvalidator (class in realtabformer.rtf_validators)": [[10, "realtabformer.rtf_validators.ObservationValidator"]], "rangevalidator (class in realtabformer.rtf_validators)": [[10, "realtabformer.rtf_validators.RangeValidator"]], "validatorbase (class in realtabformer.rtf_validators)": [[10, "realtabformer.rtf_validators.ValidatorBase"]], "add_validator() (realtabformer.rtf_validators.observationvalidator method)": [[10, "realtabformer.rtf_validators.ObservationValidator.add_validator"]], "realtabformer.rtf_validators": [[10, "module-realtabformer.rtf_validators"]], "remove_validator() (realtabformer.rtf_validators.observationvalidator method)": [[10, "realtabformer.rtf_validators.ObservationValidator.remove_validator"]], "validate() (realtabformer.rtf_validators.geovalidator method)": [[10, "realtabformer.rtf_validators.GeoValidator.validate"]], "validate() (realtabformer.rtf_validators.observationvalidator method)": [[10, "realtabformer.rtf_validators.ObservationValidator.validate"]], "validate() (realtabformer.rtf_validators.rangevalidator method)": [[10, "realtabformer.rtf_validators.RangeValidator.validate"]], "validate() (realtabformer.rtf_validators.validatorbase method)": [[10, "realtabformer.rtf_validators.ValidatorBase.validate"]], "validate_df() (realtabformer.rtf_validators.observationvalidator method)": [[10, "realtabformer.rtf_validators.ObservationValidator.validate_df"]]}})
\ No newline at end of file
+Search.setIndex({"docnames": ["autoapi/index", "autoapi/realtabformer/__main__/index", "autoapi/realtabformer/data_utils/index", "autoapi/realtabformer/index", "autoapi/realtabformer/realtabformer/index", "autoapi/realtabformer/rtf_analyze/index", "autoapi/realtabformer/rtf_datacollator/index", "autoapi/realtabformer/rtf_exceptions/index", "autoapi/realtabformer/rtf_sampler/index", "autoapi/realtabformer/rtf_trainer/index", "autoapi/realtabformer/rtf_validators/index", "index"], "filenames": ["autoapi/index.rst", "autoapi/realtabformer/__main__/index.rst", "autoapi/realtabformer/data_utils/index.rst", "autoapi/realtabformer/index.rst", "autoapi/realtabformer/realtabformer/index.rst", "autoapi/realtabformer/rtf_analyze/index.rst", "autoapi/realtabformer/rtf_datacollator/index.rst", "autoapi/realtabformer/rtf_exceptions/index.rst", "autoapi/realtabformer/rtf_sampler/index.rst", "autoapi/realtabformer/rtf_trainer/index.rst", "autoapi/realtabformer/rtf_validators/index.rst", "index.rst"], "titles": ["API Reference", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer.__main__</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer.data_utils</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer.realtabformer</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer.rtf_analyze</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer.rtf_datacollator</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer.rtf_exceptions</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer.rtf_sampler</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer.rtf_trainer</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">realtabformer.rtf_validators</span></code>", "REaLTabFormer"], "terms": {"thi": [0, 3, 4, 5, 6, 8, 9, 11], "page": 0, "contain": [0, 3, 4, 5, 8], "auto": 0, "gener": [0, 3, 4, 5, 7, 8, 11], "document": 0, "1": [0, 3, 4, 5, 8, 11], "realtabform": 0, "__main__": [0, 3, 11], "data_util": [0, 3, 11], "rtf_analyz": [0, 3, 11], "rtf_datacol": [0, 3, 11], "rtf_except": [0, 3, 11], "rtf_sampler": [0, 3, 11], "rtf_trainer": [0, 3, 11], "rtf_valid": [0, 3, 4, 8, 11], "creat": [0, 11], "sphinx": 0, "autoapi": 0, "entri": 1, "point": [1, 11], "when": [1, 3, 4, 6, 7, 9, 11], "invok": 1, "python": [1, 11], "m": 1, "teacher_forcing_pr": 2, "_teacherforc": 2, "sourc": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11], "special_col_sep": 2, "___": 2, "numeric_na_token": 2, "invalid_nums_r": 2, "0": [2, 3, 4, 5, 8, 11], "9": 2, "tabularartefact": 2, "best_disc_model": 2, "str": [2, 3, 4, 5, 6, 7, 8, 10], "best": [2, 3, 4], "disc": 2, "model": [2, 3, 4, 5, 8, 9, 11], "mean_best_disc_model": 2, "mean": [2, 3, 4], "not_best_disc_model": 2, "last_epoch_model": 2, "last": 2, "epoch": [2, 3, 4, 9, 11], "static": [2, 5, 8], "artefact": [2, 11], "modelfilenam": 2, "rtf_config_json": 2, "rtf_config": 2, "json": 2, "rtf_model_pt": 2, "rtf_model": [2, 8, 11], "pt": [2, 6], "name": [2, 3, 4, 5, 10, 11], "modeltyp": 2, "tabular": [2, 3, 4, 8], "relat": [2, 3, 4, 8], "type": [2, 5, 6, 9, 11], "coldatatyp": 2, "numer": [2, 5], "datetim": 2, "categor": [2, 3, 4, 5, 8], "specialtoken": 2, "unk": 2, "sep": 2, "pad": [2, 6], "cl": 2, "mask": 2, "bo": [2, 8], "eo": [2, 8], "bmem": [2, 8], "emem": [2, 8], "rmask": 2, "sptype": 2, "token": [2, 3, 4, 8, 9], "get_uuid": 2, "fix_multi_decim": 2, "v": [2, 11], "build_vocab": 2, "df": [2, 3, 4, 10, 11], "panda": [2, 3, 4, 5, 8, 10, 11], "datafram": [2, 3, 4, 5, 8, 10], "none": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11], "special_token": 2, "add_column": 2, "bool": [2, 3, 4, 5, 8, 10], "true": [2, 3, 4, 5, 8, 11], "process_numeric_data": 2, "seri": [2, 3, 4, 5, 8, 10], "max_len": 2, "int": [2, 3, 4, 5, 6, 8, 9, 10], "10": [2, 3, 4, 8, 11], "numeric_precis": [2, 3, 4], "4": [2, 3, 4, 5, 11], "transform_data": 2, "dict": [2, 3, 4, 5, 8, 9, 10], "tupl": [2, 9, 10], "process_datetime_data": 2, "process_categorical_data": 2, "encode_partition_numeric_col": 2, "col": [2, 8, 10], "tr": 2, "col_zfil": 2, "decode_partition_numeric_col": 2, "partition_col": 2, "tokenize_numeric_col": 2, "npart": 2, "2": [2, 3, 4, 5, 8, 11], "encode_column_valu": 2, "decode_column_valu": 2, "encode_processed_column": 2, "idx": 2, "dtype": 2, "decode_processed_column": 2, "extract_processed_column": 2, "is_numeric_col": 2, "is_datetime_col": 2, "is_categorical_col": 2, "is_numeric_datetime_col": 2, "process_data": 2, "numeric_max_len": [2, 3, 4], "numeric_npart": [2, 3, 4], "first_col_typ": 2, "col_transform_data": [2, 8], "target_col": [2, 3, 4, 5, 8], "get_token_id": 2, "vocab_token2id": 2, "mask_rat": [2, 3, 4], "float": [2, 3, 4, 5, 10], "get_input_id": 2, "exampl": [2, 3, 4, 11], "vocab": [2, 8], "column": [2, 3, 4, 5, 8, 11], "list": [2, 3, 4, 5, 6, 8, 9], "return_label_id": 2, "return_token_type_id": 2, "fals": [2, 3, 4, 5], "affix_bo": 2, "affix_eo": 2, "make_dataset": 2, "dataset": [2, 3, 4, 9, 11], "get_relational_input_id": 2, "input_idx": 2, "output_dataset": 2, "in_out_idx": 2, "output_max_length": [2, 3, 4, 11], "make_relational_dataset": 2, "in_df": [2, 3, 4, 11], "out_df": [2, 3, 4], "model_typ": [3, 4, 5, 8, 11], "tabular_config": [3, 4], "transform": [3, 4, 6, 8, 9, 11], "gpt2": [3, 4], "gpt2config": [3, 4], "relational_config": [3, 4], "encoderdecoderconfig": [3, 4], "parent_realtabformer_path": [3, 4, 11], "pathlib": [3, 4, 11], "path": [3, 4, 11], "freeze_parent_model": [3, 4], "checkpoints_dir": [3, 4], "rtf_checkpoint": [3, 4], "samples_save_dir": [3, 4], "rtf_sampl": [3, 4], "1000": [3, 4, 5], "batch_siz": [3, 4, 11], "8": [3, 4, 11], "random_st": [3, 4, 5, 8], "1029": [3, 4, 5, 8], "train_siz": [3, 4, 11], "512": [3, 4, 11], "early_stopping_pati": [3, 4], "5": [3, 4, 5, 6, 11], "early_stopping_threshold": [3, 4], "training_args_kwarg": [3, 4], "_invalid_model_typ": [3, 4], "_init_tabular": [3, 4], "_init_rel": [3, 4], "_extract_column_info": [3, 4], "_generate_vocab": [3, 4], "_check_model": [3, 4], "_split_train_eval_dataset": [3, 4], "fit": [3, 4, 11], "join_on": [3, 4, 11], "resume_from_checkpoint": [3, 4], "devic": [3, 4, 8], "cuda": [3, 4, 8], "num_bootstrap": [3, 4, 5, 11], "500": [3, 4, 11], "frac": [3, 4, 5], "165": [3, 4], "frac_max_data": [3, 4], "10000": [3, 4], "qt_max": [3, 4, 5], "05": [3, 4, 5], "qt_max_default": [3, 4], "qt_interv": [3, 4, 5], "100": [3, 4, 5, 6, 11], "qt_interval_uniqu": [3, 4], "distanc": [3, 4, 5], "sklearn": [3, 4, 5, 11], "metric": [3, 4, 5], "pairwis": [3, 4, 5], "manhattan_dist": [3, 4, 5], "quantil": [3, 4, 5], "95": [3, 4, 5], "n_critic": [3, 4], "n_critic_stop": [3, 4], "gen_round": [3, 4], "3": [3, 4, 5, 8, 11], "sensitivity_max_col_num": [3, 4], "20": [3, 4], "use_k": [3, 4, 5], "full_sensit": [3, 4, 5], "sensitivity_orig_frac_multipl": [3, 4, 5], "orig_samples_round": [3, 4], "load_from_best_mean_sensit": [3, 4], "train": [3, 4, 5, 9, 11], "data": [3, 4, 5, 6, 8], "paramet": [3, 4, 5, 6, 11], "dure": [3, 4], "sampl": [3, 4, 5, 7, 8], "goe": [3, 4], "decod": [3, 4], "observ": [3, 4, 5, 7, 8, 11], "from": [3, 4, 5, 6, 11], "which": [3, 4, 5, 7, 11], "encod": [3, 4, 5], "link": [3, 4], "tabl": [3, 4, 11], "If": [3, 4, 6], "resum": [3, 4], "latest": [3, 4], "checkpoint": [3, 4, 9], "given": [3, 4, 5, 8], "where": [3, 4, 11], "run": [3, 4], "us": [3, 4, 5, 6, 8, 11], "torch": [3, 4, 8, 9], "e": [3, 4], "g": [3, 4, 11], "cpu": [3, 4], "mp": [3, 4], "experiment": [3, 4], "number": [3, 4, 5, 8, 9, 10, 11], "bootstrap": [3, 4, 5], "The": [3, 4, 5, 6, 8, 9, 11], "fraction": [3, 4], "maximum": [3, 4, 6], "row": [3, 4, 5], "have": [3, 4, 5, 9, 11], "discrimin": [3, 4, 5], "default": [3, 4, 5, 6, 11], "interv": [3, 4], "check": [3, 4], "process": [3, 4, 5], "valu": [3, 4, 5, 6, 8, 9], "between": [3, 4, 5, 11], "perform": [3, 4, 5], "assess": [3, 4, 5], "critic": [3, 4], "round": [3, 4, 5], "without": [3, 4, 5, 7, 11], "improv": [3, 4, 11], "after": [3, 4, 7], "stop": [3, 4, 11], "comput": [3, 4, 5, 6], "sensit": [3, 4, 5], "whether": [3, 4, 5], "k": [3, 4], "test": [3, 4, 5], "full": [3, 4, 5], "size": [3, 4, 5], "rel": [3, 4, 5, 8], "chosen": [3, 4, 5], "larger": [3, 4, 5], "i": [3, 4, 5, 6, 7, 8, 9, 11], "more": [3, 4, 5], "robust": [3, 4, 5], "threshold": [3, 4, 5], "howev": [3, 4, 5], "multipli": [3, 4, 5], "must": [3, 4, 5, 9, 11], "less": [3, 4, 5], "than": [3, 4, 5], "hold": [3, 4], "out": [3, 4, 11], "load": [3, 4, 11], "target": [3, 4, 5, 8], "return": [3, 4, 5, 6, 7, 8, 9], "trainer": [3, 4, 9], "_train_with_sensit": [3, 4], "_set_up_relational_coder_config": [3, 4], "_fit_rel": [3, 4], "_fit_tabular": [3, 4], "num_train_epoch": [3, 4], "target_epoch": [3, 4, 9], "_build_tabular_train": [3, 4], "n_sampl": [3, 4, 8, 11], "input_unique_id": [3, 4, 8, 11], "input_df": [3, 4, 8, 11], "input_id": [3, 4, 8], "tensor": [3, 4, 6, 8, 9], "gen_batch": [3, 4, 8, 11], "128": [3, 4, 8], "seed_input": [3, 4, 8], "ani": [3, 4, 5, 8, 10, 11], "save_sampl": [3, 4], "constrain_tokens_gen": [3, 4, 8], "valid": [3, 4, 7, 8, 10], "observationvalid": [3, 4, 8, 10, 11], "continuous_empty_limit": [3, 4, 8], "suppress_token": [3, 4, 8], "forced_decoder_id": [3, 4, 8], "related_num": [3, 4, 8], "generate_kwarg": [3, 4, 8], "synthet": [3, 4, 5], "uniqu": [3, 4, 11], "identifi": [3, 4, 11], "input": [3, 4, 5, 6, 7], "note": [3, 4, 5, 11], "argument": [3, 4, 5, 9], "prefer": [3, 4], "condit": [3, 4], "control": [3, 4, 9], "batch": [3, 4, 8], "should": [3, 4, 5, 9], "adjust": [3, 4], "base": [3, 4, 5, 7, 8, 9, 10, 11], "resourc": [3, 4], "A": [3, 4, 5, 11], "dictionari": [3, 4], "col_nam": [3, 4], "seed": [3, 4, 5], "onli": [3, 4, 5], "ar": [3, 4, 6, 8, 11], "actual": [3, 4, 5], "first": [3, 4, 5], "sequenc": [3, 4, 6, 11], "set": [3, 4, 5, 6, 7, 9, 11], "we": [3, 4, 5, 11], "impos": [3, 4], "constraint": [3, 4], "each": [3, 4, 5, 9], "step": [3, 4, 8, 9, 11], "limit": [3, 4, 7], "an": [3, 4, 9, 11], "instanc": [3, 4], "appli": [3, 4, 5], "don": [3, 4, 11], "t": [3, 4, 11], "support": [3, 4, 11], "inter": [3, 4], "see": [3, 4, 6], "doc": [3, 4], "how": [3, 4], "up": [3, 4, 9], "continuous_invalid_limit": [3, 4], "rais": [3, 4, 7], "except": [3, 4, 7], "empti": [3, 4, 7], "been": [3, 4, 9, 11], "produc": [3, 4, 8], "continu": [3, 4, 7, 9], "prevent": [3, 4], "infinit": [3, 4], "loop": [3, 4], "qualiti": [3, 4], "good": [3, 4], "alwai": [3, 4], "invalid": [3, 4, 11], "supress": [3, 4], "supresstoken": [3, 4], "logit": [3, 4], "processor": [3, 4, 5], "log": [3, 4], "prob": [3, 4], "inf": [3, 4], "so": [3, 4, 5], "thei": [3, 4, 11], "featur": [3, 4, 5, 6], "imput": [3, 4], "miss": [3, 4], "pair": [3, 4], "integ": [3, 4], "indic": [3, 4, 5], "map": [3, 4], "forc": [3, 4, 9, 11], "befor": [3, 4, 9], "For": [3, 4, 5], "123": [3, 4], "second": [3, 4], "index": [3, 4, 8, 11], "constrain": [3, 4, 8], "specif": [3, 4, 7], "stratif": [3, 4], "variabl": [3, 4, 8], "survei": [3, 4], "geo1": [3, 4], "urban": [3, 4], "rural": [3, 4], "child": [3, 4, 11], "expect": [3, 4, 5, 8], "parent": [3, 4, 11], "It": [3, 4, 5], "can": [3, 4, 5, 11], "also": [3, 4, 11], "correspond": [3, 4], "same": [3, 4, 5, 11], "addit": [3, 4, 11], "keyword": [3, 4], "suppli": [3, 4], "method": [3, 4, 5, 8, 9, 11], "comprehens": [3, 4], "http": [3, 4, 11], "huggingfac": [3, 4, 6, 11], "co": [3, 4], "v4": [3, 4], "24": [3, 4], "en": [3, 4], "main_class": [3, 4], "text_gener": [3, 4], "generation_util": [3, 4], "generationmixin": [3, 4], "predict": [3, 4, 5, 8], "target_pos_v": [3, 4, 5, 8], "32": [3, 4, 8], "obs_sampl": [3, 4, 8], "30": [3, 4, 8], "fillunk": [3, 4, 8], "disable_progress_bar": [3, 4, 8], "make": [3, 4, 5, 9, 11], "form": [3, 4], "posit": [3, 4, 8], "binari": [3, 4], "classif": [3, 4], "one": [3, 4, 5, 8], "mani": [3, 4, 5, 8], "multi": [3, 4, 8], "function": [3, 5, 6], "fill": [3, 4, 8], "unknown": [3, 4, 8], "mode": [3, 4, 8], "either": [3, 4, 9], "pass": [3, 4, 9, 11], "": [3, 4, 11], "save": [3, 4, 5, 9, 11], "allow_overwrit": [3, 4], "weight": [3, 4], "configur": [3, 4], "file": [3, 4, 11], "directori": [3, 4, 11], "param": [3, 4, 9], "classmethod": [3, 4], "load_from_dir": [3, 4, 11], "implement": [4, 5, 8, 11], "_normalize_gpt2_state_dict": 4, "state_dict": 4, "_validate_get_devic": 4, "syntheticdatabench": 5, "test_siz": 5, "test_df": 5, "handl": 5, "all": [5, 11], "need": 5, "register_synthetic_data": 5, "regist": 5, "split": 5, "accord": 5, "n_train": 5, "n_test": 5, "done": [5, 9], "replac": 5, "arg": [5, 9, 10], "least": 5, "compute_distance_to_closest_record": 5, "origin": 5, "want": [5, 11], "compar": 5, "ideal": 5, "measure_ml_effici": 5, "baseestim": 5, "provid": [5, 6, 11], "both": [5, 11], "pd": [5, 11], "preprocess_data": 5, "other": [5, 11], "fillna": 5, "preprocess": 5, "mix": 5, "matrix": 5, "extract": 5, "pipelin": 5, "hot": 5, "standard": 5, "preprocessor": 5, "column_nam": 5, "new": [5, 11], "option": [5, 6], "compute_discriminator_predict": 5, "build": [5, 11], "attempt": 5, "distinguish": 5, "next": 5, "add": 5, "label": [5, 6], "combin": 5, "final": 5, "classifi": 5, "logisticregress": 5, "scikit": 5, "learn": 5, "proport": 5, "includ": [5, 11], "random": 5, "y_test": 5, "y_pred": 5, "get_dcr": 5, "is_test": 5, "get": [5, 11], "dcr": 5, "experi": [5, 11], "get_ml_effici": 5, "ml": 5, "effici": 5, "get_discriminator_perform": 5, "compute_data_copying_predict": 5, "compute_sensitivity_metr": 5, "tsvd": 5, "decomposit": 5, "truncatedsvd": 5, "max_col_num": 5, "50": [5, 11], "verbos": 5, "compute_sensitivity_threshold": 5, "train_data": 5, "return_valu": 5, "estim": 5, "deriv": 5, "becaus": 5, "detect": 5, "tend": 5, "closer": 5, "statist": 5, "synth_min": 5, "test_min": 5, "systemat": 5, "copi": [5, 11], "statict": 5, "becom": 5, "instead": 5, "singl": [5, 8], "boostrap": 5, "syntheticdataexperi": 5, "data_id": 5, "n": 5, "x": [5, 11], "analysi": 5, "relationaldatacol": 6, "collat": 6, "dynam": 6, "receiv": 6, "well": 6, "adopt": 6, "datacollatorforseq2seq": 6, "max_length": [6, 8], "length": 6, "abov": 6, "pad_to_multiple_of": 6, "multipl": 6, "especi": 6, "enabl": 6, "core": 6, "nvidia": 6, "hardwar": 6, "capabl": 6, "7": [6, 11], "volta": 6, "label_pad_token_id": 6, "id": [6, 11], "automat": 6, "ignor": 6, "pytorch": 6, "loss": 6, "return_tensor": 6, "allow": [6, 11], "np": 6, "tf": 6, "__call__": 6, "sampleemptyerror": 7, "messag": 7, "in_siz": 7, "salari": 7, "caus": 7, "error": 7, "explan": 7, "__str__": 7, "self": 7, "sampleemptylimiterror": 7, "still": [7, 11], "some": [7, 11], "algorithm": 8, "nq_col": 8, "_nq_ds_": 8, "realsampl": 8, "pretrainedmodel": [8, 9], "processed_column": 8, "col_siz": 8, "col_idx_id": 8, "datetime_column": 8, "column_dtyp": 8, "column_has_miss": 8, "drop_na_col": 8, "abstract": [8, 10], "_prefix_allowed_tokens_fn": 8, "batch_id": 8, "_convert_to_t": 8, "synth_df": 8, "_gener": 8, "as_numpi": 8, "numpi": [8, 10], "ndarrai": 8, "_validate_synth_sampl": 8, "synth_sampl": 8, "_recover_data_valu": 8, "_processes_sampl": 8, "sample_output": 8, "relate_id": 8, "_validate_data": 8, "_validate_miss": 8, "tabularsampl": 8, "sampler": 8, "sampler_from_model": 8, "_process_seed_input": 8, "sample_tabular": 8, "relationalsampl": 8, "in_col_transform_data": 8, "sample_rel": 8, "_get_min_max_length": 8, "_sample_input_batch": 8, "_get_relational_col_idx_id": 8, "len_id": 8, "equal": 8, "per": 8, "logger": 9, "saveepochendcallback": 9, "save_epoch": 9, "trainercallback": 9, "callback": 9, "end": 9, "on_epoch_end": 9, "trainingargu": 9, "state": [9, 11], "trainerst": 9, "trainercontrol": 9, "kwarg": [9, 10], "resumabletrain": 9, "nn": 9, "data_col": 9, "datacol": 9, "train_dataset": 9, "eval_dataset": 9, "pretrainedtokenizerbas": 9, "model_init": 9, "callabl": 9, "compute_metr": 9, "evalpredict": 9, "optim": [9, 11], "lr_schedul": 9, "lambdalr": 9, "preprocess_logits_for_metr": 9, "schedul": 9, "consist": 9, "over": 9, "paus": 9, "similar": 9, "intermitt": 9, "create_schedul": 9, "num_training_step": 9, "setup": 9, "call": 9, "do": 9, "validatorbas": 10, "rangevalid": 10, "min_val": 10, "max_val": 10, "val": 10, "geovalid": [10, 11], "geo_bound": 10, "shape": [10, 11], "geometri": [10, 11], "polygon": [10, 11], "multipolygon": [10, 11], "lon": 10, "lat": 10, "validate_df": 10, "add_valid": [10, 11], "remove_valid": 10, "realist": 11, "offer": 11, "unifi": 11, "framework": 11, "synthes": 11, "differ": 11, "seq2seq": 11, "non": 11, "gpt": 11, "box": 11, "independ": 11, "paper": 11, "arxiv": 11, "avail": 11, "pypi": 11, "easili": 11, "pip": 11, "version": 11, "show": 11, "criterion": 11, "distribut": 11, "close": 11, "real": 11, "sure": 11, "larg": 11, "better": 11, "met": 11, "import": 11, "read_csv": 11, "foo": 11, "csv": 11, "remov": 11, "you": 11, "gradient_accumulation_step": 11, "logging_step": 11, "current": 11, "In": 11, "idxxxx": 11, "store": 11, "len": 11, "rtf_model2": 11, "o": 11, "parent_df": 11, "child_df": 11, "bar": 11, "unique_id": 11, "kei": 11, "assert": 11, "field": 11, "parent_model": 11, "drop": 11, "axi": 11, "pdir": 11, "rtf_parent": 11, "most": 11, "recent": 11, "specifi": 11, "parent_model_path": 11, "idxxx": 11, "sort": 11, "p": 11, "glob": 11, "is_dir": 11, "getmtim": 11, "child_model": 11, "parent_sampl": 11, "parend_df": 11, "reset_index": 11, "child_sampl": 11, "64": 11, "interfac": 11, "filter": 11, "below": 11, "chart": 11, "left": 11, "latitud": 11, "longitud": 11, "right": 11, "california": 11, "boundari": 11, "even": 11, "did": 11, "fall": 11, "outsid": 11, "scarc": 11, "geopanda": 11, "dev": 11, "null": 11, "git": 11, "clone": 11, "github": 11, "com": 11, "joncutr": 11, "tutori": 11, "seaborn": 11, "sn": 11, "matplotlib": 11, "pyplot": 11, "plt": 11, "rtf_val": 11, "linestr": 11, "fetch_california_h": 11, "def": 11, "plot_sf": 11, "titl": 11, "xlim": 11, "126": 11, "113": 11, "ylim": 11, "31": 11, "43": 11, "bin": 11, "dd": 11, "pp": 11, "loc": 11, "min": 11, "max": 11, "jointgrid": 11, "y": 11, "marginal_tick": 11, "plot_joint": 11, "histplot": 11, "plot": 11, "ax": 11, "ax_joint": 11, "set_xlim": 11, "set_ylim": 11, "plot_margin": 11, "element": 11, "color": 11, "03012d": 11, "set_titl": 11, "tight_layout": 11, "geograph": 11, "read_fil": 11, "usa": 11, "censu": 11, "2014": 11, "shp": 11, "to_cr": 11, "epsg": 11, "4326": 11, "gp": 11, "project": 11, "hous": 11, "as_fram": 11, "frame": 11, "small": 11, "demo": 11, "200": 11, "reduc": 11, "raw": 11, "samples_raw": 11, "10240": 11, "obs_valid": 11, "geo_valid": 11, "samples_valid": 11, "visual": 11, "pleas": 11, "cite": 11, "our": 11, "work": 11, "your": 11, "research": 11, "articl": 11, "solatorio2023realtabform": 11, "author": 11, "solatorio": 11, "aivin": 11, "dupriez": 11, "olivi": 11, "journal": 11, "preprint": 11, "2302": 11, "02041": 11, "year": 11, "2023": 11, "thank": 11, "world": 11, "bank": 11, "unhcr": 11, "joint": 11, "center": 11, "displac": 11, "jdc": 11, "fund": 11, "enhanc": 11, "respons": 11, "microdata": 11, "access": 11, "polici": 11, "situat": 11, "kp": 11, "p174174": 11, "ginp": 11, "tf0b5124": 11, "part": 11, "went": 11, "develop": 11, "wa": 11, "popul": 11, "disclosur": 11, "risk": 11, "mosaic": 11, "effect": 11, "send": 11, "hug": 11, "open": 11, "softwar": 11, "releas": 11, "And": 11, "api": 11, "refer": 11, "submodul": 11, "packag": 11, "class": 11}, "objects": {"": [[3, 0, 0, "-", "realtabformer"]], "realtabformer": [[3, 1, 1, "", "REaLTabFormer"], [1, 0, 0, "-", "__main__"], [2, 0, 0, "-", "data_utils"], [4, 0, 0, "-", "realtabformer"], [5, 0, 0, "-", "rtf_analyze"], [6, 0, 0, "-", "rtf_datacollator"], [7, 0, 0, "-", "rtf_exceptions"], [8, 0, 0, "-", "rtf_sampler"], [9, 0, 0, "-", "rtf_trainer"], [10, 0, 0, "-", "rtf_validators"]], "realtabformer.REaLTabFormer": [[3, 2, 1, "", "_build_tabular_trainer"], [3, 2, 1, "", "_check_model"], [3, 2, 1, "", "_extract_column_info"], [3, 2, 1, "", "_fit_relational"], [3, 2, 1, "", "_fit_tabular"], [3, 2, 1, "", "_generate_vocab"], [3, 2, 1, "", "_init_relational"], [3, 2, 1, "", "_init_tabular"], [3, 2, 1, "", "_invalid_model_type"], [3, 2, 1, "", "_set_up_relational_coder_configs"], [3, 2, 1, "", "_split_train_eval_dataset"], [3, 2, 1, "", "_train_with_sensitivity"], [3, 2, 1, "", "fit"], [3, 2, 1, "", "load_from_dir"], [3, 2, 1, "", "predict"], [3, 2, 1, "", "sample"], [3, 2, 1, "", "save"]], "realtabformer.data_utils": [[2, 1, 1, "", "ColDataType"], [2, 4, 1, "", "INVALID_NUMS_RE"], [2, 1, 1, "", "ModelFileName"], [2, 1, 1, "", "ModelType"], [2, 4, 1, "", "NUMERIC_NA_TOKEN"], [2, 4, 1, "", "SPECIAL_COL_SEP"], [2, 1, 1, "", "SpecialTokens"], [2, 4, 1, "", "TEACHER_FORCING_PRE"], [2, 1, 1, "", "TabularArtefact"], [2, 5, 1, "", "build_vocab"], [2, 5, 1, "", "decode_column_values"], [2, 5, 1, "", "decode_partition_numeric_col"], [2, 5, 1, "", "decode_processed_column"], [2, 5, 1, "", "encode_column_values"], [2, 5, 1, "", "encode_partition_numeric_col"], [2, 5, 1, "", "encode_processed_column"], [2, 5, 1, "", "extract_processed_column"], [2, 5, 1, "", "fix_multi_decimal"], [2, 5, 1, "", "get_input_ids"], [2, 5, 1, "", "get_relational_input_ids"], [2, 5, 1, "", "get_token_id"], [2, 5, 1, "", "get_uuid"], [2, 5, 1, "", "is_categorical_col"], [2, 5, 1, "", "is_datetime_col"], [2, 5, 1, "", "is_numeric_col"], [2, 5, 1, "", "is_numeric_datetime_col"], [2, 5, 1, "", "make_dataset"], [2, 5, 1, "", "make_relational_dataset"], [2, 5, 1, "", "process_categorical_data"], [2, 5, 1, "", "process_data"], [2, 5, 1, "", "process_datetime_data"], [2, 5, 1, "", "process_numeric_data"], [2, 5, 1, "", "tokenize_numeric_col"]], "realtabformer.data_utils.ColDataType": [[2, 3, 1, "", "CATEGORICAL"], [2, 3, 1, "", "DATETIME"], [2, 3, 1, "", "NUMERIC"], [2, 2, 1, "", "types"]], "realtabformer.data_utils.ModelFileName": [[2, 2, 1, "", "names"], [2, 3, 1, "", "rtf_config_json"], [2, 3, 1, "", "rtf_model_pt"]], "realtabformer.data_utils.ModelType": [[2, 3, 1, "", "relational"], [2, 3, 1, "", "tabular"], [2, 2, 1, "", "types"]], "realtabformer.data_utils.SpecialTokens": [[2, 3, 1, "", "BMEM"], [2, 3, 1, "", "BOS"], [2, 3, 1, "", "CLS"], [2, 3, 1, "", "EMEM"], [2, 3, 1, "", "EOS"], [2, 3, 1, "", "MASK"], [2, 3, 1, "", "PAD"], [2, 3, 1, "", "RMASK"], [2, 3, 1, "", "SEP"], [2, 3, 1, "", "SPTYPE"], [2, 3, 1, "", "UNK"], [2, 2, 1, "", "tokens"]], "realtabformer.data_utils.TabularArtefact": [[2, 2, 1, "", "artefacts"], [2, 3, 1, "", "best_disc_model"], [2, 3, 1, "", "last_epoch_model"], [2, 3, 1, "", "mean_best_disc_model"], [2, 3, 1, "", "not_best_disc_model"]], "realtabformer.realtabformer": [[4, 1, 1, "", "REaLTabFormer"], [4, 5, 1, "", "_normalize_gpt2_state_dict"], [4, 5, 1, "", "_validate_get_device"]], "realtabformer.realtabformer.REaLTabFormer": [[4, 2, 1, "", "_build_tabular_trainer"], [4, 2, 1, "", "_check_model"], [4, 2, 1, "", "_extract_column_info"], [4, 2, 1, "", "_fit_relational"], [4, 2, 1, "", "_fit_tabular"], [4, 2, 1, "", "_generate_vocab"], [4, 2, 1, "", "_init_relational"], [4, 2, 1, "", "_init_tabular"], [4, 2, 1, "", "_invalid_model_type"], [4, 2, 1, "", "_set_up_relational_coder_configs"], [4, 2, 1, "", "_split_train_eval_dataset"], [4, 2, 1, "", "_train_with_sensitivity"], [4, 2, 1, "", "fit"], [4, 2, 1, "", "load_from_dir"], [4, 2, 1, "", "predict"], [4, 2, 1, "", "sample"], [4, 2, 1, "", "save"]], "realtabformer.rtf_analyze": [[5, 1, 1, "", "SyntheticDataBench"], [5, 1, 1, "", "SyntheticDataExperiment"]], "realtabformer.rtf_analyze.SyntheticDataBench": [[5, 2, 1, "", "compute_data_copying_predictions"], [5, 2, 1, "", "compute_discriminator_predictions"], [5, 2, 1, "", "compute_distance_to_closest_records"], [5, 2, 1, "", "compute_sensitivity_metric"], [5, 2, 1, "", "compute_sensitivity_threshold"], [5, 2, 1, "", "get_dcr"], [5, 2, 1, "", "get_discriminator_performance"], [5, 2, 1, "", "get_ml_efficiency"], [5, 2, 1, "", "measure_ml_efficiency"], [5, 2, 1, "", "preprocess_data"], [5, 2, 1, "", "register_synthetic_data"]], "realtabformer.rtf_datacollator": [[6, 1, 1, "", "RelationalDataCollator"]], "realtabformer.rtf_datacollator.RelationalDataCollator": [[6, 2, 1, "", "__call__"], [6, 3, 1, "", "label_pad_token_id"], [6, 3, 1, "", "max_length"], [6, 3, 1, "", "pad_to_multiple_of"], [6, 3, 1, "", "return_tensors"]], "realtabformer.rtf_exceptions": [[7, 6, 1, "", "SampleEmptyError"], [7, 6, 1, "", "SampleEmptyLimitError"]], "realtabformer.rtf_exceptions.SampleEmptyError": [[7, 2, 1, "", "__str__"]], "realtabformer.rtf_sampler": [[8, 4, 1, "", "NQ_COL"], [8, 1, 1, "", "REaLSampler"], [8, 1, 1, "", "RelationalSampler"], [8, 1, 1, "", "TabularSampler"]], "realtabformer.rtf_sampler.REaLSampler": [[8, 2, 1, "", "_convert_to_table"], [8, 2, 1, "", "_generate"], [8, 2, 1, "", "_prefix_allowed_tokens_fn"], [8, 2, 1, "", "_processes_sample"], [8, 2, 1, "", "_recover_data_values"], [8, 2, 1, "", "_validate_data"], [8, 2, 1, "", "_validate_missing"], [8, 2, 1, "", "_validate_synth_sample"]], "realtabformer.rtf_sampler.RelationalSampler": [[8, 2, 1, "", "_get_min_max_length"], [8, 2, 1, "", "_get_relational_col_idx_ids"], [8, 2, 1, "", "_prefix_allowed_tokens_fn"], [8, 2, 1, "", "_sample_input_batch"], [8, 2, 1, "", "sample_relational"], [8, 2, 1, "", "sampler_from_model"]], "realtabformer.rtf_sampler.TabularSampler": [[8, 2, 1, "", "_prefix_allowed_tokens_fn"], [8, 2, 1, "", "_process_seed_input"], [8, 2, 1, "", "predict"], [8, 2, 1, "", "sample_tabular"], [8, 2, 1, "", "sampler_from_model"]], "realtabformer.rtf_trainer": [[9, 1, 1, "", "ResumableTrainer"], [9, 1, 1, "", "SaveEpochEndCallback"], [9, 4, 1, "", "logger"]], "realtabformer.rtf_trainer.ResumableTrainer": [[9, 2, 1, "", "create_scheduler"]], "realtabformer.rtf_trainer.SaveEpochEndCallback": [[9, 2, 1, "", "on_epoch_end"]], "realtabformer.rtf_validators": [[10, 1, 1, "", "GeoValidator"], [10, 1, 1, "", "ObservationValidator"], [10, 1, 1, "", "RangeValidator"], [10, 1, 1, "", "ValidatorBase"]], "realtabformer.rtf_validators.GeoValidator": [[10, 2, 1, "", "validate"]], "realtabformer.rtf_validators.ObservationValidator": [[10, 2, 1, "", "add_validator"], [10, 2, 1, "", "remove_validator"], [10, 2, 1, "", "validate"], [10, 2, 1, "", "validate_df"]], "realtabformer.rtf_validators.RangeValidator": [[10, 2, 1, "", "validate"]], "realtabformer.rtf_validators.ValidatorBase": [[10, 2, 1, "", "validate"]]}, "objtypes": {"0": "py:module", "1": "py:class", "2": "py:method", "3": "py:attribute", "4": "py:data", "5": "py:function", "6": "py:exception"}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "class", "Python class"], "2": ["py", "method", "Python method"], "3": ["py", "attribute", "Python attribute"], "4": ["py", "data", "Python data"], "5": ["py", "function", "Python function"], "6": ["py", "exception", "Python exception"]}, "titleterms": {"api": 0, "refer": 0, "realtabform": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11], "__main__": 1, "data_util": 2, "modul": [2, 4, 5, 6, 7, 8, 9, 10], "content": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11], "class": [2, 3, 4, 5, 6, 8, 9, 10], "function": [2, 4], "attribut": [2, 8, 9], "submodul": 3, "packag": 3, "rtf_analyz": 5, "rtf_datacol": 6, "rtf_except": 7, "rtf_sampler": 8, "rtf_trainer": 9, "rtf_valid": 10, "instal": 11, "usag": 11, "regular": 11, "tabular": 11, "data": 11, "relat": 11, "valid": 11, "synthet": 11, "sampl": 11, "citat": 11, "acknowledg": 11, "document": 11}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.intersphinx": 1, "sphinx.ext.viewcode": 1, "sphinx": 57}, "alltitles": {"API Reference": [[0, "api-reference"]], "realtabformer.__main__": [[1, "module-realtabformer.__main__"]], "realtabformer.data_utils": [[2, "module-realtabformer.data_utils"]], "Module Contents": [[2, "module-contents"], [4, "module-contents"], [5, "module-contents"], [6, "module-contents"], [7, "module-contents"], [8, "module-contents"], [9, "module-contents"], [10, "module-contents"]], "Classes": [[2, "classes"], [3, "classes"], [4, "classes"], [5, "classes"], [6, "classes"], [8, "classes"], [9, "classes"], [10, "classes"]], "Functions": [[2, "functions"], [4, "functions"]], "Attributes": [[2, "attributes"], [8, "attributes"], [9, "attributes"]], "realtabformer": [[3, "module-realtabformer"]], "Submodules": [[3, "submodules"]], "Package Contents": [[3, "package-contents"]], "realtabformer.realtabformer": [[4, "module-realtabformer.realtabformer"]], "realtabformer.rtf_analyze": [[5, "module-realtabformer.rtf_analyze"]], "realtabformer.rtf_datacollator": [[6, "module-realtabformer.rtf_datacollator"]], "realtabformer.rtf_exceptions": [[7, "module-realtabformer.rtf_exceptions"]], "realtabformer.rtf_sampler": [[8, "module-realtabformer.rtf_sampler"]], "realtabformer.rtf_trainer": [[9, "module-realtabformer.rtf_trainer"]], "realtabformer.rtf_validators": [[10, "module-realtabformer.rtf_validators"]], "REaLTabFormer": [[11, "realtabformer"]], "Installation": [[11, "installation"]], "Usage": [[11, "usage"]], "REaLTabFormer for regular tabular data": [[11, "realtabformer-for-regular-tabular-data"]], "REaLTabFormer for relational data": [[11, "realtabformer-for-relational-data"]], "Validators for synthetic samples": [[11, "validators-for-synthetic-samples"]], "Citation": [[11, "citation"]], "Acknowledgments": [[11, "acknowledgments"]], "Documentation": [[11, "documentation"]], "Contents": [[11, null]]}, "indexentries": {"module": [[1, "module-realtabformer.__main__"], [2, "module-realtabformer.data_utils"], [3, "module-realtabformer"], [4, "module-realtabformer.realtabformer"], [5, "module-realtabformer.rtf_analyze"], [6, "module-realtabformer.rtf_datacollator"], [7, "module-realtabformer.rtf_exceptions"], [8, "module-realtabformer.rtf_sampler"], [9, "module-realtabformer.rtf_trainer"], [10, "module-realtabformer.rtf_validators"]], "realtabformer.__main__": [[1, "module-realtabformer.__main__"]], "bmem (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.BMEM"]], "bos (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.BOS"]], "categorical (realtabformer.data_utils.coldatatype attribute)": [[2, "realtabformer.data_utils.ColDataType.CATEGORICAL"]], "cls (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.CLS"]], "coldatatype (class in realtabformer.data_utils)": [[2, "realtabformer.data_utils.ColDataType"]], "datetime (realtabformer.data_utils.coldatatype attribute)": [[2, "realtabformer.data_utils.ColDataType.DATETIME"]], "emem (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.EMEM"]], "eos (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.EOS"]], "invalid_nums_re (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.INVALID_NUMS_RE"]], "mask (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.MASK"]], "modelfilename (class in realtabformer.data_utils)": [[2, "realtabformer.data_utils.ModelFileName"]], "modeltype (class in realtabformer.data_utils)": [[2, "realtabformer.data_utils.ModelType"]], "numeric (realtabformer.data_utils.coldatatype attribute)": [[2, "realtabformer.data_utils.ColDataType.NUMERIC"]], "numeric_na_token (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.NUMERIC_NA_TOKEN"]], "pad (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.PAD"]], "rmask (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.RMASK"]], "sep (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.SEP"]], "special_col_sep (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.SPECIAL_COL_SEP"]], "sptype (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.SPTYPE"]], "specialtokens (class in realtabformer.data_utils)": [[2, "realtabformer.data_utils.SpecialTokens"]], "teacher_forcing_pre (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.TEACHER_FORCING_PRE"]], "tabularartefact (class in realtabformer.data_utils)": [[2, "realtabformer.data_utils.TabularArtefact"]], "unk (realtabformer.data_utils.specialtokens attribute)": [[2, "realtabformer.data_utils.SpecialTokens.UNK"]], "artefacts() (realtabformer.data_utils.tabularartefact static method)": [[2, "realtabformer.data_utils.TabularArtefact.artefacts"]], "best_disc_model (realtabformer.data_utils.tabularartefact attribute)": [[2, "realtabformer.data_utils.TabularArtefact.best_disc_model"]], "build_vocab() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.build_vocab"]], "decode_column_values() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.decode_column_values"]], "decode_partition_numeric_col() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.decode_partition_numeric_col"]], "decode_processed_column() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.decode_processed_column"]], "encode_column_values() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.encode_column_values"]], "encode_partition_numeric_col() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.encode_partition_numeric_col"]], "encode_processed_column() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.encode_processed_column"]], "extract_processed_column() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.extract_processed_column"]], "fix_multi_decimal() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.fix_multi_decimal"]], "get_input_ids() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.get_input_ids"]], "get_relational_input_ids() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.get_relational_input_ids"]], "get_token_id() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.get_token_id"]], "get_uuid() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.get_uuid"]], "is_categorical_col() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.is_categorical_col"]], "is_datetime_col() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.is_datetime_col"]], "is_numeric_col() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.is_numeric_col"]], "is_numeric_datetime_col() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.is_numeric_datetime_col"]], "last_epoch_model (realtabformer.data_utils.tabularartefact attribute)": [[2, "realtabformer.data_utils.TabularArtefact.last_epoch_model"]], "make_dataset() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.make_dataset"]], "make_relational_dataset() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.make_relational_dataset"]], "mean_best_disc_model (realtabformer.data_utils.tabularartefact attribute)": [[2, "realtabformer.data_utils.TabularArtefact.mean_best_disc_model"]], "names() (realtabformer.data_utils.modelfilename static method)": [[2, "realtabformer.data_utils.ModelFileName.names"]], "not_best_disc_model (realtabformer.data_utils.tabularartefact attribute)": [[2, "realtabformer.data_utils.TabularArtefact.not_best_disc_model"]], "process_categorical_data() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.process_categorical_data"]], "process_data() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.process_data"]], "process_datetime_data() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.process_datetime_data"]], "process_numeric_data() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.process_numeric_data"]], "realtabformer.data_utils": [[2, "module-realtabformer.data_utils"]], "relational (realtabformer.data_utils.modeltype attribute)": [[2, "realtabformer.data_utils.ModelType.relational"]], "rtf_config_json (realtabformer.data_utils.modelfilename attribute)": [[2, "realtabformer.data_utils.ModelFileName.rtf_config_json"]], "rtf_model_pt (realtabformer.data_utils.modelfilename attribute)": [[2, "realtabformer.data_utils.ModelFileName.rtf_model_pt"]], "tabular (realtabformer.data_utils.modeltype attribute)": [[2, "realtabformer.data_utils.ModelType.tabular"]], "tokenize_numeric_col() (in module realtabformer.data_utils)": [[2, "realtabformer.data_utils.tokenize_numeric_col"]], "tokens() (realtabformer.data_utils.specialtokens static method)": [[2, "realtabformer.data_utils.SpecialTokens.tokens"]], "types() (realtabformer.data_utils.coldatatype static method)": [[2, "realtabformer.data_utils.ColDataType.types"]], "types() (realtabformer.data_utils.modeltype static method)": [[2, "realtabformer.data_utils.ModelType.types"]], "realtabformer (class in realtabformer)": [[3, "realtabformer.REaLTabFormer"]], "_build_tabular_trainer() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._build_tabular_trainer"]], "_check_model() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._check_model"]], "_extract_column_info() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._extract_column_info"]], "_fit_relational() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._fit_relational"]], "_fit_tabular() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._fit_tabular"]], "_generate_vocab() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._generate_vocab"]], "_init_relational() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._init_relational"]], "_init_tabular() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._init_tabular"]], "_invalid_model_type() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._invalid_model_type"]], "_set_up_relational_coder_configs() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._set_up_relational_coder_configs"]], "_split_train_eval_dataset() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._split_train_eval_dataset"]], "_train_with_sensitivity() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer._train_with_sensitivity"]], "fit() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer.fit"]], "load_from_dir() (realtabformer.realtabformer class method)": [[3, "realtabformer.REaLTabFormer.load_from_dir"]], "predict() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer.predict"]], "realtabformer": [[3, "module-realtabformer"]], "sample() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer.sample"]], "save() (realtabformer.realtabformer method)": [[3, "realtabformer.REaLTabFormer.save"]], "realtabformer (class in realtabformer.realtabformer)": [[4, "realtabformer.realtabformer.REaLTabFormer"]], "_build_tabular_trainer() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._build_tabular_trainer"]], "_check_model() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._check_model"]], "_extract_column_info() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._extract_column_info"]], "_fit_relational() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._fit_relational"]], "_fit_tabular() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._fit_tabular"]], "_generate_vocab() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._generate_vocab"]], "_init_relational() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._init_relational"]], "_init_tabular() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._init_tabular"]], "_invalid_model_type() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._invalid_model_type"]], "_normalize_gpt2_state_dict() (in module realtabformer.realtabformer)": [[4, "realtabformer.realtabformer._normalize_gpt2_state_dict"]], "_set_up_relational_coder_configs() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._set_up_relational_coder_configs"]], "_split_train_eval_dataset() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._split_train_eval_dataset"]], "_train_with_sensitivity() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer._train_with_sensitivity"]], "_validate_get_device() (in module realtabformer.realtabformer)": [[4, "realtabformer.realtabformer._validate_get_device"]], "fit() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer.fit"]], "load_from_dir() (realtabformer.realtabformer.realtabformer class method)": [[4, "realtabformer.realtabformer.REaLTabFormer.load_from_dir"]], "predict() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer.predict"]], "realtabformer.realtabformer": [[4, "module-realtabformer.realtabformer"]], "sample() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer.sample"]], "save() (realtabformer.realtabformer.realtabformer method)": [[4, "realtabformer.realtabformer.REaLTabFormer.save"]], "syntheticdatabench (class in realtabformer.rtf_analyze)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench"]], "syntheticdataexperiment (class in realtabformer.rtf_analyze)": [[5, "realtabformer.rtf_analyze.SyntheticDataExperiment"]], "compute_data_copying_predictions() (realtabformer.rtf_analyze.syntheticdatabench static method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.compute_data_copying_predictions"]], "compute_discriminator_predictions() (realtabformer.rtf_analyze.syntheticdatabench static method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.compute_discriminator_predictions"]], "compute_distance_to_closest_records() (realtabformer.rtf_analyze.syntheticdatabench static method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.compute_distance_to_closest_records"]], "compute_sensitivity_metric() (realtabformer.rtf_analyze.syntheticdatabench static method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.compute_sensitivity_metric"]], "compute_sensitivity_threshold() (realtabformer.rtf_analyze.syntheticdatabench static method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.compute_sensitivity_threshold"]], "get_dcr() (realtabformer.rtf_analyze.syntheticdatabench method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.get_dcr"]], "get_discriminator_performance() (realtabformer.rtf_analyze.syntheticdatabench method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.get_discriminator_performance"]], "get_ml_efficiency() (realtabformer.rtf_analyze.syntheticdatabench method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.get_ml_efficiency"]], "measure_ml_efficiency() (realtabformer.rtf_analyze.syntheticdatabench static method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.measure_ml_efficiency"]], "preprocess_data() (realtabformer.rtf_analyze.syntheticdatabench static method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.preprocess_data"]], "realtabformer.rtf_analyze": [[5, "module-realtabformer.rtf_analyze"]], "register_synthetic_data() (realtabformer.rtf_analyze.syntheticdatabench method)": [[5, "realtabformer.rtf_analyze.SyntheticDataBench.register_synthetic_data"]], "relationaldatacollator (class in realtabformer.rtf_datacollator)": [[6, "realtabformer.rtf_datacollator.RelationalDataCollator"]], "__call__() (realtabformer.rtf_datacollator.relationaldatacollator method)": [[6, "realtabformer.rtf_datacollator.RelationalDataCollator.__call__"]], "label_pad_token_id (realtabformer.rtf_datacollator.relationaldatacollator attribute)": [[6, "realtabformer.rtf_datacollator.RelationalDataCollator.label_pad_token_id"]], "max_length (realtabformer.rtf_datacollator.relationaldatacollator attribute)": [[6, "realtabformer.rtf_datacollator.RelationalDataCollator.max_length"]], "pad_to_multiple_of (realtabformer.rtf_datacollator.relationaldatacollator attribute)": [[6, "realtabformer.rtf_datacollator.RelationalDataCollator.pad_to_multiple_of"]], "realtabformer.rtf_datacollator": [[6, "module-realtabformer.rtf_datacollator"]], "return_tensors (realtabformer.rtf_datacollator.relationaldatacollator attribute)": [[6, "realtabformer.rtf_datacollator.RelationalDataCollator.return_tensors"]], "sampleemptyerror": [[7, "realtabformer.rtf_exceptions.SampleEmptyError"]], "sampleemptylimiterror": [[7, "realtabformer.rtf_exceptions.SampleEmptyLimitError"]], "__str__() (realtabformer.rtf_exceptions.sampleemptyerror method)": [[7, "realtabformer.rtf_exceptions.SampleEmptyError.__str__"]], "realtabformer.rtf_exceptions": [[7, "module-realtabformer.rtf_exceptions"]], "nq_col (in module realtabformer.rtf_sampler)": [[8, "realtabformer.rtf_sampler.NQ_COL"]], "realsampler (class in realtabformer.rtf_sampler)": [[8, "realtabformer.rtf_sampler.REaLSampler"]], "relationalsampler (class in realtabformer.rtf_sampler)": [[8, "realtabformer.rtf_sampler.RelationalSampler"]], "tabularsampler (class in realtabformer.rtf_sampler)": [[8, "realtabformer.rtf_sampler.TabularSampler"]], "_convert_to_table() (realtabformer.rtf_sampler.realsampler method)": [[8, "realtabformer.rtf_sampler.REaLSampler._convert_to_table"]], "_generate() (realtabformer.rtf_sampler.realsampler method)": [[8, "realtabformer.rtf_sampler.REaLSampler._generate"]], "_get_min_max_length() (realtabformer.rtf_sampler.relationalsampler method)": [[8, "realtabformer.rtf_sampler.RelationalSampler._get_min_max_length"]], "_get_relational_col_idx_ids() (realtabformer.rtf_sampler.relationalsampler method)": [[8, "realtabformer.rtf_sampler.RelationalSampler._get_relational_col_idx_ids"]], "_prefix_allowed_tokens_fn() (realtabformer.rtf_sampler.realsampler method)": [[8, "realtabformer.rtf_sampler.REaLSampler._prefix_allowed_tokens_fn"]], "_prefix_allowed_tokens_fn() (realtabformer.rtf_sampler.relationalsampler method)": [[8, "realtabformer.rtf_sampler.RelationalSampler._prefix_allowed_tokens_fn"]], "_prefix_allowed_tokens_fn() (realtabformer.rtf_sampler.tabularsampler method)": [[8, "realtabformer.rtf_sampler.TabularSampler._prefix_allowed_tokens_fn"]], "_process_seed_input() (realtabformer.rtf_sampler.tabularsampler method)": [[8, "realtabformer.rtf_sampler.TabularSampler._process_seed_input"]], "_processes_sample() (realtabformer.rtf_sampler.realsampler method)": [[8, "realtabformer.rtf_sampler.REaLSampler._processes_sample"]], "_recover_data_values() (realtabformer.rtf_sampler.realsampler method)": [[8, "realtabformer.rtf_sampler.REaLSampler._recover_data_values"]], "_sample_input_batch() (realtabformer.rtf_sampler.relationalsampler method)": [[8, "realtabformer.rtf_sampler.RelationalSampler._sample_input_batch"]], "_validate_data() (realtabformer.rtf_sampler.realsampler method)": [[8, "realtabformer.rtf_sampler.REaLSampler._validate_data"]], "_validate_missing() (realtabformer.rtf_sampler.realsampler method)": [[8, "realtabformer.rtf_sampler.REaLSampler._validate_missing"]], "_validate_synth_sample() (realtabformer.rtf_sampler.realsampler method)": [[8, "realtabformer.rtf_sampler.REaLSampler._validate_synth_sample"]], "predict() (realtabformer.rtf_sampler.tabularsampler method)": [[8, "realtabformer.rtf_sampler.TabularSampler.predict"]], "realtabformer.rtf_sampler": [[8, "module-realtabformer.rtf_sampler"]], "sample_relational() (realtabformer.rtf_sampler.relationalsampler method)": [[8, "realtabformer.rtf_sampler.RelationalSampler.sample_relational"]], "sample_tabular() (realtabformer.rtf_sampler.tabularsampler method)": [[8, "realtabformer.rtf_sampler.TabularSampler.sample_tabular"]], "sampler_from_model() (realtabformer.rtf_sampler.relationalsampler static method)": [[8, "realtabformer.rtf_sampler.RelationalSampler.sampler_from_model"]], "sampler_from_model() (realtabformer.rtf_sampler.tabularsampler static method)": [[8, "realtabformer.rtf_sampler.TabularSampler.sampler_from_model"]], "resumabletrainer (class in realtabformer.rtf_trainer)": [[9, "realtabformer.rtf_trainer.ResumableTrainer"]], "saveepochendcallback (class in realtabformer.rtf_trainer)": [[9, "realtabformer.rtf_trainer.SaveEpochEndCallback"]], "create_scheduler() (realtabformer.rtf_trainer.resumabletrainer method)": [[9, "realtabformer.rtf_trainer.ResumableTrainer.create_scheduler"]], "logger (in module realtabformer.rtf_trainer)": [[9, "realtabformer.rtf_trainer.logger"]], "on_epoch_end() (realtabformer.rtf_trainer.saveepochendcallback method)": [[9, "realtabformer.rtf_trainer.SaveEpochEndCallback.on_epoch_end"]], "realtabformer.rtf_trainer": [[9, "module-realtabformer.rtf_trainer"]], "geovalidator (class in realtabformer.rtf_validators)": [[10, "realtabformer.rtf_validators.GeoValidator"]], "observationvalidator (class in realtabformer.rtf_validators)": [[10, "realtabformer.rtf_validators.ObservationValidator"]], "rangevalidator (class in realtabformer.rtf_validators)": [[10, "realtabformer.rtf_validators.RangeValidator"]], "validatorbase (class in realtabformer.rtf_validators)": [[10, "realtabformer.rtf_validators.ValidatorBase"]], "add_validator() (realtabformer.rtf_validators.observationvalidator method)": [[10, "realtabformer.rtf_validators.ObservationValidator.add_validator"]], "realtabformer.rtf_validators": [[10, "module-realtabformer.rtf_validators"]], "remove_validator() (realtabformer.rtf_validators.observationvalidator method)": [[10, "realtabformer.rtf_validators.ObservationValidator.remove_validator"]], "validate() (realtabformer.rtf_validators.geovalidator method)": [[10, "realtabformer.rtf_validators.GeoValidator.validate"]], "validate() (realtabformer.rtf_validators.observationvalidator method)": [[10, "realtabformer.rtf_validators.ObservationValidator.validate"]], "validate() (realtabformer.rtf_validators.rangevalidator method)": [[10, "realtabformer.rtf_validators.RangeValidator.validate"]], "validate() (realtabformer.rtf_validators.validatorbase method)": [[10, "realtabformer.rtf_validators.ValidatorBase.validate"]], "validate_df() (realtabformer.rtf_validators.observationvalidator method)": [[10, "realtabformer.rtf_validators.ObservationValidator.validate_df"]]}})
\ No newline at end of file