Precisely define steps for the ChangeToolbox workflow

Change (Toolbox) Workflow

We need to precisely define the steps our implemented prototype has to support for the ChangeToolbox workflow. We already did this in some way, but I would like to have this information here.

Goal of the workflow

The goal of the change workflow is to quantify, assess, and apply expert judgement to changes in climate variables and derived events by comparing multiple simulations.

Workflow description

Phase 1 (Overview, based on averages): Quantification and assessment of the temporal and spatial significance and robustness of regional climate change projections in variables such as precipitation (or temperature, ...).

Phase 2 (Detailed view, based on events): Quantification and assessment of the temporal and spatial significance and robustness of high precipitation events, and their properties, in regional climate change projections.

Workflow steps - Phase 1

Step	Task	Visual Encoding & Interaction	Goal	Input Data	Output (Data)	Issue	Status
(1)	Select data sets (reference, comparisons) for change analysis	Select a data set from a list of available ones, provide filters to reduce the list	From 4 experiments (ex. historical, rcp2.6, rcp4.5, rcp8.5) group data sets returned into ensembles for comparison.	ESGF Archive (via REST API)	Download URLs for selected datasets	#44 (closed) #64 #65 #66 (closed)
(1.1)	Select data sets (reference, comparisons) for change analysis	Button to apply pre-selected climate model combinations for the 4 experiments	Allow user to use pre-selected climate model combinations.	ESGF Archive (via REST API)	Download URLs for selected datasets	#223 (closed) #226 (closed) #79 (closed) #64 #65
(2)	Define relevant date/time range per experimental data set (ex: historical, rcp8.5)	Set start and end time/date via date range slider	Define relevant start and end dates	overall date range of each data set	Start and end date for each selected data set	#6 (closed) #48 (closed)	✔
(2.1)	Define relevant date/time averaging intervals for each (ex) data set (reference: 1#, comparison: 2#)	Set interval start/end date via range slider	Define averaging intervals	Previously selected Start End date for data sets	start and end date/time for averaging intervals	#51 (closed) #67
(3)	Define a single region of interest (ROI)	Provide a polygon, either via drag'n'drop a file on the map (geojson or shapefile) or clicking a polygon on the map	Region of interest	optional: geojson or shapefile	ROI polygon geometry	#30 (closed) #58 (closed) #66 (closed) #227 (closed) #80 (moved) digital-earth/de-climate-change/de-change-backend-module#11 (moved)
(4)	Start change analysis in backend module	button	Send user data to backend logic module and start change analysis process	output data of steps (1)-(3)	a pre-rendered timeseries chart (preferably in SVG format)	#5 (closed) #69 (closed) #70 (closed)
(4.1)	Progress of analysis in backend module	Progress bar	Inform user status of analysis process	Status of 'download, statistics, plotting', possibly add warning		#81 #225 (closed)	-
(4.2)	Generate change overlays	-backend task-	Enables the assessment of the change analysis result	output data of steps (1)-(3)	a change plot with 3 bands (b1: change values, b2: significance indicator, (b3: robust indicator)-optional)
(5)	Assess the change analysis results	-	Quantification and assessment of temporal and spatial significance and robustness	Output of the change analysis module	Export of the assessed input data
(5.1)	Identify specific values of the time series and the driving model	Mouse over the chart line shows detailed information (value, date, driving model)	support interpretation of the results	chart / timeseries
(5.2)	Identify detailed statistical values	Mouse over the box plot chart elements shows quantile information etc.	support interpretation of the results	chart / statistics values	-
(6)	Export plots, data from different stages of processing, ROI co-ordinates for publications and reproducibility	Export button original data, processed data (*pkl, *excel), plotted data, plot	Export data for additional scientific studies			#228 (closed) #74 (closed)

Workflow steps - Potential Given Time

Step	Task	Visual Encoding & Interaction	Goal	Input Data	Output (Data)	Issue
(Ideas)	Identify detailed information on a specific location	Mouse over the map layer element shows the delta change value and lat/lon for the mouse position	support local interpretation of the results	map layer	-
(Ideas)	Switch displayed map layer between averaging intervals	Clicking on the box plot intervals	investigate the spatial distribution for a particular interval	box plot & averaging interval map layers	-

Workflow Chart