## Validate.get_tabular_report() Validation report as a GT table. Usage ``` python Validate.get_tabular_report( title=":default:", incl_header=None, incl_footer=None, incl_footer_timings=None, incl_footer_notes=None, incl_dimensions=None ) ``` The [get_tabular_report()](Validate.get_tabular_report.md#pointblank.Validate.get_tabular_report) method returns a GT table object that represents the validation report. This validation table provides a summary of the validation results, including the validation steps, the number of test units, the number of failing test units, and the fraction of failing test units. The table also includes status indicators for the 'warning', 'error', and 'critical' levels. You could simply display the validation table without the use of the [get_tabular_report()](Validate.get_tabular_report.md#pointblank.Validate.get_tabular_report) method. However, the method provides a way to customize the title of the report. In the future this method may provide additional options for customizing the report. ## Parameters `title: str | None = ``":default:"` Options for customizing the title of the report. The default is the `":default:"` value which produces a generic title. Another option is `":tbl_name:"`, and that presents the name of the table as the title for the report. If no title is wanted, then `":none:"` can be used. Aside from keyword options, text can be provided for the title. This will be interpreted as Markdown text and transformed internally to HTML. `incl_header: bool | None = None` Controls whether the header section should be displayed. If `None`, uses the global configuration setting. The header contains the table name, label, and threshold information. `incl_footer: bool | None = None` Controls whether the footer section should be displayed. If `None`, uses the global configuration setting. The footer can contain validation timing information and notes. `incl_footer_timings: bool | None = None` Controls whether validation timing information (start time, duration, end time) should be displayed in the footer. If `None`, uses the global configuration setting. Only applies when `incl_footer=True`. `incl_footer_notes: bool | None = None` Controls whether notes from validation steps should be displayed in the footer. If `None`, uses the global configuration setting. Only applies when `incl_footer=True`. `incl_dimensions: bool | None = None` Controls whether the data quality dimension display is shown: a color-coded dimension badge on each step number and a health-score summary block in the footer. If `None`, uses the global configuration setting (which defaults to `False`, i.e., opt-in). Set to `True` to include it for this report. ## Returns `GT` A GT table object that represents the validation report. ## Examples Let's create a [Validate](Validate.md#pointblank.Validate) object with a few validation steps and then interrogate the data table to see how it performs against the validation plan. We can then generate a tabular report to get a summary of the results. ``` python import pointblank as pb import polars as pl # Create a Polars DataFrame tbl_pl = pl.DataFrame({"x": [1, 2, 3, 4], "y": [4, 5, 6, 7]}) # Validate data using Polars DataFrame validation = ( pb.Validate(data=tbl_pl, tbl_name="tbl_xy", thresholds=(2, 3, 4)) .col_vals_gt(columns="x", value=1) .col_vals_lt(columns="x", value=3) .col_vals_le(columns="y", value=7) .interrogate() ) # Look at the validation table validation ```
Pointblank Validation
2026-07-13|17:52:05 Polarstbl_xyWARNING2ERROR3CRITICAL4
STEP COLUMNS VALUES TBL EVAL UNITS PASS FAIL W E C EXT
#4CA64C66 1
col_vals_gt()
x 1 ✓ 4 3
0.75		 1
0.25		 ○ ○ ○ CSV
#AAAAAA 2
col_vals_lt()
x 3 ✓ 4 2
0.50		 2
0.50		 ● ○ ○ CSV
#4CA64C 3
col_vals_le()
y 7 ✓ 4 4
1.00		 0
0.00		 ○ ○ ○ --
2026-07-13 17:52:05 UTC< 1 s2026-07-13 17:52:05 UTC
The validation table is displayed with a default title ('Validation Report'). We can use the [get_tabular_report()](Validate.get_tabular_report.md#pointblank.Validate.get_tabular_report) method to customize the title of the report. For example, we can set the title to the name of the table by using the `title=":tbl_name:"` option. This will use the string provided in the `tbl_name=` argument of the [Validate](Validate.md#pointblank.Validate) object. ``` python validation.get_tabular_report(title=":tbl_name:") ``` 2Njk0NzQgQzkuNDg4NzUwNDYsOS44MzQ5NTMyOCA3LjgzNTUyODYzLDguMTgxOTQ3MzYgNS44MDM3NTA0Niw4LjE4MTk0NzM2IFogTTUuODAzNzUwNDYsMTQuODE0OTE1IEM0LjE3ODIxOTk3LDE0LjgxNDkxNSAyLjg1NTc4Mjg1LDEzLjQ5MjQ3NzggMi44NTU3ODI4NSwxMS44NjY5NDc0IEMyLjg1NTc4Mjg1LDEwLjI0MTQxNjkgNC4xNzgyMTk5Nyw4LjkxODk3OTc1IDUuODAzNzUwNDYsOC45MTg5Nzk3NSBDNy40MjkyODA5NSw4LjkxODk3OTc1IDguNzUxNzE4MDcsMTAuMjQxNDE2OSA4Ljc1MTcxODA3LDExLjg2Njk0NzQgQzguNzUxNzE4MDcsMTMuNDkyNDc3OCA3LjQyOTI4MDk1LDE0LjgxNDkxNSA1LjgwMzc1MDQ2LDE0LjgxNDkxNSBaIiBpZD0iU2hhcGUiIGZpbGw9IiMwMDAwMDAiIGZpbGwtcnVsZT0ibm9uemVybyIgLz4KICAgICAgICAgICAgPHBhdGggZD0iTTEzLjk2MzgxODksOC42OTkzMzUgQzEzLjkzNjQ2MjEsOC43MDQzMDkyNSAxMy45MDkxMDU5LDguNzExNzY5NjggMTMuODg0MjM1OSw4LjcxOTIzMDc0IEMxMy43ODIyNzA0LDguNzM2NjM5NjcgMTMuNjg3NzY1NCw4Ljc3NjQzMTE1IDEzLjYwNTY5NTYsOC44Mzg2MDUxOCBMMTAuMjQzMzE1NiwxMS4zODUyNTk4IEMxMC4wNzY2ODg2LDExLjUwNDYzNDMgOS45NzcyMDk5MywxMS42OTg2MTgxIDkuOTc3MjA5OTMsMTEuOTAyNTQ5MSBDOS45NzcyMDk5MywxMi4xMDY0ODA3IDEwLjA3NjY4ODYsMTIuMzAwNDYzOSAxMC4yNDMzMTU2LDEyLjQxOTgzODMgTDEzLjYwNTY5NTYsMTQuOTY2NDkzIEMxMy44OTE2OTcsMTUuMTgwMzcyNSAxNC4yOTcwNzI5LDE1LjEyMzE3MjEgMTQuNTEwOTUxNywxNC44MzcxNzA3IEMxNC43MjQ4MzEzLDE0LjU1MTE2OTIgMTQuNjY3NjMwOSwxNC4xNDU3OTQgMTQuMzgxNjI5NCwxMy45MzE5MTQ1IEwxMi41MzEzMjU3LDEyLjUzOTIxMjcgTDIxLjg4MTI0OTUsMTIuNTM5MjEyNyBMMjEuODgxMjQ5NSwxMS4yNjU4ODU0IEwxMi41MzEzMjU3LDExLjI2NTg4NTQgTDE0LjM4MTYyOTQsOS44NzMxODM2NCBDMTQuNjM3Nzg3Miw5LjcxNjUwNDUzIDE0Ljc0OTcwMDYsOS40MDA2NjAxNCAxNC42NDc3MzUxLDkuMTE3MTQ1NTMgQzE0LjU0ODI1NjQsOC44MzM2MzE1NiAxNC4yNjIyNTUsOC42NTk1NDM1MiAxMy45NjM4MTg5LDguNjk5MzM1IFoiIGlkPSJhcnJvdyIgZmlsbD0iIzAwMDAwMCIgdHJhbnNmb3JtPSJ0cmFuc2xhdGUoMTUuOTI5MjMwLCAxMS44OTQ3MzcpIHJvdGF0ZSgtMTgwLjAwMDAwMCkgdHJhbnNsYXRlKC0xNS45MjkyMzAsIC0xMS44OTQ3MzcpICIgLz4KICAgICAgICA8L2c+CiAgICA8L2c+Cjwvc3ZnPg==" />
tbl_xy
2026-07-13|17:52:05 Polarstbl_xyWARNING2ERROR3CRITICAL4
STEP COLUMNS VALUES TBL EVAL UNITS PASS FAIL W E C EXT
#4CA64C66 1
col_vals_gt()
x 1 ✓ 4 3
0.75		 1
0.25		 ○ ○ ○ CSV
#AAAAAA 2
col_vals_lt()
x 3 ✓ 4 2
0.50		 2
0.50		 ● ○ ○ CSV
#4CA64C 3
col_vals_le()
y 7 ✓ 4 4
1.00		 0
0.00		 ○ ○ ○ --
2026-07-13 17:52:05 UTC< 1 s2026-07-13 17:52:05 UTC
The title of the report is now set to the name of the table, which is 'tbl_xy'. This can be useful if you have multiple tables and want to keep track of which table the validation report is for. Alternatively, you can provide your own title for the report. ``` python validation.get_tabular_report(title="Report for Table XY") ``` SAxMy45MDkxMDU5LDguNzExNzY5NjggMTMuODg0MjM1OSw4LjcxOTIzMDc0IEMxMy43ODIyNzA0LDguNzM2NjM5NjcgMTMuNjg3NzY1NCw4Ljc3NjQzMTE1IDEzLjYwNTY5NTYsOC44Mzg2MDUxOCBMMTAuMjQzMzE1NiwxMS4zODUyNTk4IEMxMC4wNzY2ODg2LDExLjUwNDYzNDMgOS45NzcyMDk5MywxMS42OTg2MTgxIDkuOTc3MjA5OTMsMTEuOTAyNTQ5MSBDOS45NzcyMDk5MywxMi4xMDY0ODA3IDEwLjA3NjY4ODYsMTIuMzAwNDYzOSAxMC4yNDMzMTU2LDEyLjQxOTgzODMgTDEzLjYwNTY5NTYsMTQuOTY2NDkzIEMxMy44OTE2OTcsMTUuMTgwMzcyNSAxNC4yOTcwNzI5LDE1LjEyMzE3MjEgMTQuNTEwOTUxNywxNC44MzcxNzA3IEMxNC43MjQ4MzEzLDE0LjU1MTE2OTIgMTQuNjY3NjMwOSwxNC4xNDU3OTQgMTQuMzgxNjI5NCwxMy45MzE5MTQ1IEwxMi41MzEzMjU3LDEyLjUzOTIxMjcgTDIxLjg4MTI0OTUsMTIuNTM5MjEyNyBMMjEuODgxMjQ5NSwxMS4yNjU4ODU0IEwxMi41MzEzMjU3LDExLjI2NTg4NTQgTDE0LjM4MTYyOTQsOS44NzMxODM2NCBDMTQuNjM3Nzg3Miw5LjcxNjUwNDUzIDE0Ljc0OTcwMDYsOS40MDA2NjAxNCAxNC42NDc3MzUxLDkuMTE3MTQ1NTMgQzE0LjU0ODI1NjQsOC44MzM2MzE1NiAxNC4yNjIyNTUsOC42NTk1NDM1MiAxMy45NjM4MTg5LDguNjk5MzM1IFoiIGlkPSJhcnJvdyIgZmlsbD0iIzAwMDAwMCIgdHJhbnNmb3JtPSJ0cmFuc2xhdGUoMTUuOTI5MjMwLCAxMS44OTQ3MzcpIHJvdGF0ZSgtMTgwLjAwMDAwMCkgdHJhbnNsYXRlKC0xNS45MjkyMzAsIC0xMS44OTQ3MzcpICIgLz4KICAgICAgICA8L2c+CiAgICA8L2c+Cjwvc3ZnPg==" />

Report for Table XY
2026-07-13|17:52:05 Polarstbl_xyWARNING2ERROR3CRITICAL4
STEP COLUMNS VALUES TBL EVAL UNITS PASS FAIL W E C EXT
#4CA64C66 1
col_vals_gt()
x 1 ✓ 4 3
0.75		 1
0.25		 ○ ○ ○ CSV
#AAAAAA 2
col_vals_lt()
x 3 ✓ 4 2
0.50		 2
0.50		 ● ○ ○ CSV
#4CA64C 3
col_vals_le()
y 7 ✓ 4 4
1.00		 0
0.00		 ○ ○ ○ --
2026-07-13 17:52:05 UTC< 1 s2026-07-13 17:52:05 UTC
The title of the report is now set to 'Report for Table XY'. This can be useful if you want to provide a more descriptive title for the report.