Make a dataframe colorful
colorDF(x, theme = NULL)
as.colorDF(x, ...)
a data frame or similar object, e.g. tibble, data.table or any object for which as.data.frame call returns a data frame
Which theme to use
further arguments are passed to colorDF()
.
a colorful data frame – identical object but with the .style
attribute set and class "colorDF" added.
These functions turn any data frame like object (i.e. object which inherits the data.frame class, such as a tibble or a data table).
Apart from adding the S3 class "colorDF", the .style
attribute (and
later the .coltp
attribute), the only thing that really changes is
the print method (see print_colorDF()
). In other words, the behavior
of the object does not change (e.g., a base::data.frame()
will by the default
drop dimensions if one column is selected, while a tibble::tibble()
will
not). colorDF is just for visualization, never truly manipulation.
Several color themes come with the package; see colorDF_themes_show()
.
When creating a colorful data frame, a theme might be directly selected;
otherwise the getOption("colorDF_theme")
is consulted and if NULL, a
default theme will be selected. The theme associated with an object
becomes a style and can be further manipulated (see df_style()
).
as.colorDF()
calls colorDF()
; this function is only here for
completeness.
Introduction to the package;
df_style()
on how to modify style of the colorful data frame;
col_type()
on how to change column types;
colorDF_themes()
to list all themes; colorDF_themes_show()
to view all themes.
colorDF(mtcars)
#> # Color data frame (class colorDF) 11 x 32:
#> # (Showing rows 1 - 20 out of 32)
#> │mpg │cyl │disp │hp │drat │wt │qsec │vs │am │gear
#> Mazda RX4│ 21│ 6│ 160│ 110│ 3.9│ 2.6│ 16│ 0│ 1│ 4
#> Mazda RX4 Wag│ 21│ 6│ 160│ 110│ 3.9│ 2.9│ 17│ 0│ 1│ 4
#> Datsun 710│ 23│ 4│ 108│ 93│ 3.9│ 2.3│ 19│ 1│ 1│ 4
#> Hornet 4 Drive│ 21│ 6│ 258│ 110│ 3.1│ 3.2│ 19│ 1│ 0│ 3
#> Hornet Sportabout│ 19│ 8│ 360│ 175│ 3.1│ 3.4│ 17│ 0│ 0│ 3
#> Valiant│ 18│ 6│ 225│ 105│ 2.8│ 3.5│ 20│ 1│ 0│ 3
#> Duster 360│ 14│ 8│ 360│ 245│ 3.2│ 3.6│ 16│ 0│ 0│ 3
#> Merc 240D│ 24│ 4│ 147│ 62│ 3.7│ 3.2│ 20│ 1│ 0│ 4
#> Merc 230│ 23│ 4│ 141│ 95│ 3.9│ 3.1│ 23│ 1│ 0│ 4
#> Merc 280│ 19│ 6│ 168│ 123│ 3.9│ 3.4│ 18│ 1│ 0│ 4
#> Merc 280C│ 18│ 6│ 168│ 123│ 3.9│ 3.4│ 19│ 1│ 0│ 4
#> Merc 450SE│ 16│ 8│ 276│ 180│ 3.1│ 4.1│ 17│ 0│ 0│ 3
#> Merc 450SL│ 17│ 8│ 276│ 180│ 3.1│ 3.7│ 18│ 0│ 0│ 3
#> Merc 450SLC│ 15│ 8│ 276│ 180│ 3.1│ 3.8│ 18│ 0│ 0│ 3
#> Cadillac Fleetwood│ 10│ 8│ 472│ 205│ 2.9│ 5.2│ 18│ 0│ 0│ 3
#> Lincoln Continental│ 10│ 8│ 460│ 215│ 3.0│ 5.4│ 18│ 0│ 0│ 3
#> Chrysler Imperial│ 15│ 8│ 440│ 230│ 3.2│ 5.3│ 17│ 0│ 0│ 3
#> Fiat 128│ 32│ 4│ 79│ 66│ 4.1│ 2.2│ 19│ 1│ 1│ 4
#> Honda Civic│ 30│ 4│ 76│ 52│ 4.9│ 1.6│ 19│ 1│ 1│ 4
#> Toyota Corolla│ 34│ 4│ 71│ 65│ 4.2│ 1.8│ 20│ 1│ 1│ 4
#> │carb
#> Mazda RX4│ 4
#> Mazda RX4 Wag│ 4
#> Datsun 710│ 1
#> Hornet 4 Drive│ 1
#> Hornet Sportabout│ 2
#> Valiant│ 1
#> Duster 360│ 4
#> Merc 240D│ 2
#> Merc 230│ 2
#> Merc 280│ 4
#> Merc 280C│ 4
#> Merc 450SE│ 3
#> Merc 450SL│ 3
#> Merc 450SLC│ 3
#> Cadillac Fleetwood│ 4
#> Lincoln Continental│ 4
#> Chrysler Imperial│ 4
#> Fiat 128│ 1
#> Honda Civic│ 2
#> Toyota Corolla│ 1
colorDF(mtcars, theme="bw")
#> # Color data frame (class colorDF) 11 x 32:
#> # (Showing rows 1 - 20 out of 32)
#> │mpg │cyl │disp │hp │drat │wt │qsec │vs │am │gear
#> Mazda RX4│ 21│ 6│ 160│ 110│ 3.9│ 2.6│ 16│ 0│ 1│ 4
#> Mazda RX4 Wag│ 21│ 6│ 160│ 110│ 3.9│ 2.9│ 17│ 0│ 1│ 4
#> Datsun 710│ 23│ 4│ 108│ 93│ 3.9│ 2.3│ 19│ 1│ 1│ 4
#> Hornet 4 Drive│ 21│ 6│ 258│ 110│ 3.1│ 3.2│ 19│ 1│ 0│ 3
#> Hornet Sportabout│ 19│ 8│ 360│ 175│ 3.1│ 3.4│ 17│ 0│ 0│ 3
#> Valiant│ 18│ 6│ 225│ 105│ 2.8│ 3.5│ 20│ 1│ 0│ 3
#> Duster 360│ 14│ 8│ 360│ 245│ 3.2│ 3.6│ 16│ 0│ 0│ 3
#> Merc 240D│ 24│ 4│ 147│ 62│ 3.7│ 3.2│ 20│ 1│ 0│ 4
#> Merc 230│ 23│ 4│ 141│ 95│ 3.9│ 3.1│ 23│ 1│ 0│ 4
#> Merc 280│ 19│ 6│ 168│ 123│ 3.9│ 3.4│ 18│ 1│ 0│ 4
#> Merc 280C│ 18│ 6│ 168│ 123│ 3.9│ 3.4│ 19│ 1│ 0│ 4
#> Merc 450SE│ 16│ 8│ 276│ 180│ 3.1│ 4.1│ 17│ 0│ 0│ 3
#> Merc 450SL│ 17│ 8│ 276│ 180│ 3.1│ 3.7│ 18│ 0│ 0│ 3
#> Merc 450SLC│ 15│ 8│ 276│ 180│ 3.1│ 3.8│ 18│ 0│ 0│ 3
#> Cadillac Fleetwood│ 10│ 8│ 472│ 205│ 2.9│ 5.2│ 18│ 0│ 0│ 3
#> Lincoln Continental│ 10│ 8│ 460│ 215│ 3.0│ 5.4│ 18│ 0│ 0│ 3
#> Chrysler Imperial│ 15│ 8│ 440│ 230│ 3.2│ 5.3│ 17│ 0│ 0│ 3
#> Fiat 128│ 32│ 4│ 79│ 66│ 4.1│ 2.2│ 19│ 1│ 1│ 4
#> Honda Civic│ 30│ 4│ 76│ 52│ 4.9│ 1.6│ 19│ 1│ 1│ 4
#> Toyota Corolla│ 34│ 4│ 71│ 65│ 4.2│ 1.8│ 20│ 1│ 1│ 4
#> │carb
#> Mazda RX4│ 4
#> Mazda RX4 Wag│ 4
#> Datsun 710│ 1
#> Hornet 4 Drive│ 1
#> Hornet Sportabout│ 2
#> Valiant│ 1
#> Duster 360│ 4
#> Merc 240D│ 2
#> Merc 230│ 2
#> Merc 280│ 4
#> Merc 280C│ 4
#> Merc 450SE│ 3
#> Merc 450SL│ 3
#> Merc 450SLC│ 3
#> Cadillac Fleetwood│ 4
#> Lincoln Continental│ 4
#> Chrysler Imperial│ 4
#> Fiat 128│ 1
#> Honda Civic│ 2
#> Toyota Corolla│ 1