This function is especially helpful if one wants to show a complete section only as one entry in the Gantt-chart

collapse_section(dt, project, section,
  task_label = "{project}::{section} collapsed")

Arguments

dt

time lines processed by calculate_time_lines

project

that conatins the section that should be collapsed

section

that will be collapsed to one entry

task_label

the label that is used for the corresonding collapsed entry

Value

dt but all entries for the provided section in the provided project are collapsed to one entry. Start and end time for the collapsed entry are the minimum and maximum start and end times of the single tasks and deadline is set to the minimum deadline (if available).