Skip to main content
Version: Next

How to manage work packages

The Work Package Manager is a web UI for browsing, inspecting, and managing work packages submitted to the Hosting Capacity Service.

Work Package List

The main page shows all submitted work packages with their ID, name, author, creation date, status, and completion date. The list can be filtered by name, ID, or author using the search bar.

Status

A work package moves through several states during its lifecycle:

StatusDescription
PendingWaiting to be processed.
RunningCurrently executing.
SucceededAll SYF (Scenario/Year/Feeder) jobs completed successfully.
FailedOne or more SYF jobs encountered an error.
Timed OutOne or more SYF jobs did not complete within the allowed time (Queue issue, contact Zepben for more details).
CancelledManually cancelled before completing.

Hovering over a status badge shows a detailed breakdown of SYF job counts per state. This status updates in real time (every 5 seconds) as the work package progresses, no need to refresh the page.

Work Package Detail Page

Click View Info on any row to open the detail page. It has three panels:

  • Description — a free-text description that can be edited via the Edit button.
  • Config — a read-only JSON tree of the full configuration the work package was submitted with, including the syfConfig block (feeders, years, and scenarios).
  • Progress Details — SYF job statuses broken down by pipeline stage (Generation, Execution, Result Processing). Each stage row shows a count and can be expanded. The table below lists every individual Feeder/Scenario/Year combination and its current status.

Cancelling a Work Package

Click Cancel Work Package at the top of the Work Package Detail Page to stop any in-progress or pending SYF jobs. Jobs that have already completed are unaffected. Results from cancelled work packages will be incomplete and should not be used for analysis.

info

Cancellation is irreversible — a cancelled work package cannot be resumed. Submit a new work package to re-run it.

Deleting Work Packages

Select one or more work packages using the checkboxes, then click Delete at the bottom of the list. This removes the work package from the list but does not delete associated results from the system.