Task schedule visualisation support

[YueZhang-studyuse]

We need to visualise the task schedule (planned schedule and actual schedule) for each timestep.

Things to consider: (1) Now one task is more than one location, so we need to consider how to show the orders and different locations of one single task. -> we consider to mark the location as task_id.order. Suggestions to handle this:

Show a task

• if having a list of tasks (maybe only tasks revealed or assigned at the current timestep, anyway, someway you can select a task)
• select a task
• grey all other elements on the visualiser, only left the selected task shown and in colour
• have order labelled on each task location/errand

Show tasks associated with an agent

• select an agent
• somewhere show a list of tasks assigned to this agent
• then you can select a task and show the task

(2) Separate Task assignments from events and add more panels for task errors.

(3) We run out of colors! so far we already use pink, orange, green, blue, grey, red.

(4) Keep task-related information minimal but useful.

• We might don't want a big list of all the tasks, as there may have too much tasks no one can work with it.
• We might only show tasks or information related to tasks for the current timestep, keeping information shown minimal but useful.

(5) Task assignment errors:

• Task assignment made but rejected by task manager

@shchan13 Please add more.

[nobodyczcz]

Aug 15:

Items with a "*" are required items before release/competition start

*Bugs:

• click the agent the tasks shown are not the current assigned/working task

*UC1 Views:

• Default view:
  • agents are labeled with id
  • shown tasks selected as "current"
• Shown tasks drop down changes the view to:
  • current: just next errand location of all agents
  • assigned: current + all subsequent errands of tasks that are currently assigned to agents.
  • all: current + assigned + revealed but unassigned
• Task colouring:
  • next errand location of every agent is orange
  • rest of errands of all assigned tasks is pink
  • errands of revealed but unassigned tasks is light yellow, e.g.: #eeeaa2
  • no task id numbers on the map

*UC2 Agent Tracking:

• When click on an agent, planned path to reach the first errand of first task is shown.
• Link subsequent errands and tasks (assigned to the select agent) with arrowed dash lines, swapping color between tasks.
• Allow select multiple agents (shift click), and show paths, linkes, tasks for all selected agents.
• Update paths, tasks, links as agent moves and tasks completed/assigned.
• Disappear finished errands.
• Click on no agent no task locations to unselect all agnets.

*UC3 Event List:

• in the event list, list all events happened at or before current timestep.
• click the event jump to the associated timestep

UC4 Task Tracking:

• click a location, if multiple tasks share the location, show a list of related task and agents in a box on control panel
• Then allow user select an item in the box
• If select an item with related agent, similar to UC2 show paths, links, tasks for all tasks related assigned to the agent.
• click a task, if not assigned, just show links between errands of the task.

UC5 Errors:

• List and visualise both task scheduler errors and path planner errors.
• Show all the errors, timestep first details after timestep
• Planner errors: on default, at every timestep show all the affected agents coloured in red
• Scheduler errors: by default show all the affected agents in red and put x on affected locations
• Select an error from the list, shows only the affected agents (for planner error) or agents plus tasks for scheduler error.

[nobodyczcz]

2024-9-6 Comments:

• UC2:

  • the visualisation only works in a static manner, we need to update the display while agent moves
  • arrow start from agent to next errands and then between remainning errands
  • with a toggle to show paths or not on the panel
  • path off by default
  • lines that connect agent and errands be thiner, refer to keisuke's visualisation as a reference: https://kei18.github.io/

• UC3:

  • Currently only display assignment events, but we have more in 2024 , e.g. errand, and task completion
  • show where we are up to in the event list \
  • for each even, show the timetstep first, then other event information.
  • we can color the past events and errors in grey. The color get updated when timestep moves forwards or backwards.