Skip to content

user_stories

Will Usher edited this page Oct 2, 2018 · 8 revisions

User stories

Focus on the intent. Express one need.

Template

As a I want So that

See - Actors for a list of actors used in this document

Scenarios

As a modeller I want to select a different scenario So that I can see how my model performs

As an analyst I want to view scenario data So that I can assess the input assumptions

As a modeller I want to import scenario data So that I can run my model under new assumptions

As a modeller I want to import scenario data So that I can run my model in isolation from other models

As an analyst I want a unique scenario code (e.g. hi-hot-AB-29) to be understandable or explained So that I can easily select the scenario I wish to run

As an analyst I want to explore the range of scenarios dimensions visually So that it is easier to understand the range of uncertainty portrayed across the scenarios

As a modeller I want to define a scenario model batch process So that I can transform high level scenario data into low-level sector data

Database

As a database administrator I want to define user groups So that I can prevent unauthorised access to security sensitive spatial data

As a modeller I want to save my model configuration to the database So that I can retrieve it in the future

As an analyst I want to identify the versions of models used to generate results So that I can match changes in model code to changes in model results

Provenance

As an analyst I want to compare model inputs and results between model runs So that I can understand why and how model results differ

Configuration

As a modeller I want to configure my simulation model So that I can use it in multiple different system-of-system model

As a modeller I want to configure a system-of-system model So that I can reuse my SosModel in multiple model runs

As a modeller I want the system to tell me if the models require input parameter data which is not yet provided So that it is easier to provide a SosModel with the correct data

As a modeller I want to associate a SosModel input with a Scenario Set So that I can choose between scenarios when defining a model run

Decisions

As a modeller I want to define a pre-specified planning pipeline So that I can run a SosModel to see what happens

As a modeller I want to define a set of planning rules So that I can run a SosModel to see what happens

As a modeller I want to define an objective function and planning constraints So that I can run a SosModel to see what happens

As a modeller I want use a multi-objective evolutionary algorithm So that I can to explore trade-offs between different portfolios of investments

As a developer I want to view a log of optimisation interations So that I can debug my optimisation algorithm

As a modeller I want to configure a decision manager with different algorithms So that I can explore the decision space of a system-of-systems model

As a modeller I want to specify the spatial constraints on interventions So that I can create a realistic picture of where investments could take place

As a modeller I want to model maximum build rates of technologies So that I can include realistic representation of the UK's human capacity to build out infrastructure

As a decision manager I want to see a list of available interventions So that I can pick one or more to make up into a decision

As a decision manager I want to run a SosModel in a decision iteration So that I can see the effect of my choice of interventions

As a decision manager I want access model results for previous decision iteration So that I can choose the best next action to test

As a decision manager I want to collate historical interventions and new actions So that I can determine the current post-decision state of the system

As a decision manager I want to specify different iteration/timestep permutations to run the SosModel So that I can implement different algorithms to make decisions