import pandas as pd
from great_tables import GT
numbers_tbl = pd.DataFrame({"arabic": [1, 8, 24, 85], "roman": [1, 8, 24, 85]})
(
GT(numbers_tbl, rowname_col="arabic")
.fmt_roman(columns="roman")
)| roman | |
|---|---|
| 1 | I |
| 8 | VIII |
| 24 | XXIV |
| 85 | LXXXV |
GT.fmt_roman
GT.fmt_roman(self, columns=None, rows=None, case='upper', pattern='{x}')Format values as Roman numerals.
With numeric values in a gt table we can transform those to Roman numerals, rounding values as necessary.
Parameters
columns :SelectExpr= None-
The columns to target. Can either be a single column name or a series of column names provided in a list.
rows :int|list[int] | None = None-
In conjunction with
columns=, we can specify which of their rows should undergo formatting. The default is all rows, resulting in all rows in targeted columns being formatted. Alternatively, we can supply a list of row indices. case :str= 'upper'-
Should Roman numerals should be rendered as uppercase (
"upper") or lowercase ("lower") letters? By default, this is set to"upper". pattern :str= '{x}'-
A formatting pattern that allows for decoration of the formatted value. The formatted value is represented by the
{x}(which can be used multiple times, if needed) and all other characters will be interpreted as string literals.
Returns
: GT-
The GT object is returned. This is the same object that the method is called on so that we can facilitate method chaining.
Examples
Let’s first create a DataFrame containing small numeric values and then introduce that to GT(). We’ll then format the roman column to appear as Roman numerals with the fmt_roman() method.
See Also
The functional version of this method, val_fmt_roman(), allows you to format a single numerical value (or a list of them).