4 Basic operations
The first step is to initialise the flowchart with
as_fc. The last step, if we want to visualise the created
flowchart, is to draw the flowchart with fc_draw. In
between we can combine the functions fc_split.,
fc_filter, fc_merge, fc_stack
with the operator pipe (|> or %>$) to
create complex flowchart structures.
4.1 Initialize
To initialize a flowchart from a dataset we have to use the
as_fc() function:
## List of 2
## $ data: tibble [925 × 21] (S3: tbl_df/tbl/data.frame)
## $ fc : tibble [1 × 17] (S3: tbl_df/tbl/data.frame)
## - attr(*, "class")= chr "fc"The safo_fc object created is a fc object,
which consists of a list containing the tibble of the dataframe
associated with the flowchart and the tibble that stores the flowchart
parameters. In this example, safo_fc$data corresponds to
the safo dataset while safo_fc$fc contains the
parameters of the initial flowchart:
## # A tibble: 1 × 17
## id x y n N perc text type group just text_color text_fs
## <dbl> <dbl> <dbl> <int> <int> <chr> <chr> <chr> <lgl> <chr> <chr> <dbl>
## 1 1 0.5 0.5 925 925 100 "Ini… init NA cent… black 8
## # ℹ 5 more variables: text_fface <dbl>, text_ffamily <lgl>, text_padding <dbl>,
## # bg_fill <chr>, border_color <chr>Alternatively, if a dataframe is not available, we can initialize a
flowchart using the N = argument manually specifying the
number of rows:
4.2 Draw
The function fc_draw() allows to draw the flowchart
associated to any fc object. Following the last example, we
can draw the initial flowchart that has been previously created:
4.3 Filter
We can filter the flowchart using fc_filter() specifying
the logic in which the filter is to be applied. For example, we can show
the number of patients that were randomized in the study:
safo |>
as_fc(label = "Patients assessed for eligibility") |>
fc_filter(!is.na(group), label = "Randomized", show_exc = TRUE) |>
fc_draw()
Percentages are calculated from the box in the previous level. See
‘Modify function arguments’ for more information on the
label= and show_exc= arguments.
Alternatively, if the column to filter is not available, we can use
the N = argument to manually specify the number of rows of
the resulting filter:
safo |>
as_fc(label = "Patients assessed for eligibility") |>
fc_filter(N = 215, label = "Randomized", show_exc = TRUE) |>
fc_draw()
4.4 Split
We can split the flowchart into groups using fc_split()
specifying the grouping variable. The function will split the flowchart
into as many categories as the specified variable has. For example, we
can split the previous flowchart showing the patients allocated in the
two study treatments:
safo |>
dplyr::filter(!is.na(group)) |>
as_fc(label = "Randomized patients") |>
fc_split(group) |>
fc_draw()
Percentages are calculated from the box in the previous level.
Alternatively, if the column to split is not available, we can use
the N = argument to manually specify the number of rows in
each group of the resulting split:
safo |>
dplyr::filter(!is.na(group)) |>
as_fc(label = "Randomized patients") |>
fc_split(N = c(105, 110), label = c("cloxacillin plus fosfomycin", "cloxacillin alone")) |>
fc_draw()
