This package has the purpose to print data in matrices using different backends. It was orizinally inspired in the functionality provided by ASCII Tables.
PrettyTables.jl allows to print the data together with some table sections. They can be modified by the user to obtain the desired output. The sections currently available are:
This design is heavily inspired by the R's package gt but the API is highly different due to the differences between the R and Julia languages.
julia> using Pkg
julia> Pkg.add("PrettyTables")
We present in the following an example showing some of the features available in PrettyTables.jl.
julia> using PrettyTables, StyledStrings
# == Creating the Table ====================================================================
julia> v1_t = 0:5:20
julia> v1_a = ones(length(v1_t)) * 1.0
julia> v1_v = @. 0 + v1_a * v1_t
julia> v1_d = @. 0 + v1_a * v1_t^2 / 2
julia> v2_t = 0:5:20
julia> v2_a = ones(length(v2_t)) * 0.75
julia> v2_v = @. 0 + v2_a * v2_t
julia> v2_d = @. 0 + v2_a * v2_t^2 / 2
julia> table = [
v1_t v1_a v1_v v1_d
v2_t v2_a v2_v v2_d
];
# == Configuring the Table =================================================================
julia> title = "Table 1. Data obtained from the test procedure."
julia> subtitle = "Comparison between two vehicles"
julia> column_labels = [
[EmptyCells(2), MultiColumn(2, "Estimated Data")],
["Time (s)", "Acceleration", "Velocity", "Position"],
]
julia> units = [
styled"{(foreground=gray):[s]}",
styled"{(foreground=gray):[m / s²]}",
styled"{(foreground=gray):[m / s]}",
styled"{(foreground=gray):[m]}",
]
julia> push!(column_labels, units)
julia> merge_column_label_cells = :auto
julia> row_group_labels = [
1 => "Vehicle #1",
6 => "Vehicle #2"
]
julia> summary_rows = [
(data, j) -> maximum(@views data[ 1:5, j]),
(data, j) -> maximum(@views data[6:10, j]),
]
julia> summary_row_labels = [
"Max. for Vehicle #1",
"Max. for Vehicle #2",
]
julia> footnotes = [
(:column_label, 1, 3) => "Estimated data based on the acceleration measurement."
]
julia> highlighters = [
TextHighlighter((data, i, j) -> (j == 3) && (data[i, j] > 10), crayon"fg:red bold")
TextHighlighter((data, i, j) -> (j == 4) && (data[i, j] > 10), crayon"fg:blue bold")
]
julia> table_format = TextTableFormat(;
# Remove vertical lines.
@text__no_vertical_lines
)
julia> style = TextTableStyle(
column_label = crayon"bold",
first_line_merged_column_label = crayon"fg:yellow bold underline",
footnote = crayon"fg:cyan",
row_group_label = crayon"fg:magenta bold",
subtitle = crayon"italics",
title = crayon"fg:yellow bold",
)
# == Printing the Table ====================================================================
julia> pretty_table(
table;
column_labels,
footnotes,
highlighters,
merge_column_label_cells,
row_group_labels,
style,
subtitle,
summary_row_labels,
summary_rows,
table_format,
title,
)
See the documentation.