vSPD-online is a web-based implementation of the Authority’s vectorised Scheduling, Pricing and Dispatch (vSPD) model.
Unlike the standalone vSPD, users do not require a GAMS license to operate vSPD-online. Behind the scenes, vSPD-online employs exactly the same model codes and solution algorithms as the standalone vSPD, and it calls upon the same collection of input data files. In other words, vSPD-online is mathematically identical to standalone vSPD.
However, the data inputs that vSPD-online users are able to modify are restricted compared to standalone vSPD. Initially, only the demand parameters can be changed. Once users have gained a little familiarity with vSPD-online, we will enable the various offer parameters to be modified as well.
Registration
Users must first register in order to use vSPD-online. A single sign-on facility enables access to all parts of the EMI website that require sign-on. This is a one-time task and requires users to provide a username, an email address, and an affiliation. In the interests of openness and transparency, we would encourage users to use their actual first and last names as their username, and current workplace for affiliation. You can edit your user profile details at any time after you've registered.
vSPD-online concepts
There are really only two actions users need to undertake in order to use vSPD-online:
- Create an override
- Create a job.
Create an override
An override is a named collection of user-specified data values that defines an experiment, or counterfactual scenario. It is called an override because the specified data values literally 'override' the existing or base case values in the model. In other words, creating an override is the mechanism by which a vSPD-online user implements a ‘what if’ question, e.g. what if North Island demand increased by 10%?
An override may contain one or more components. For example, one component may be to increase North Island demand by 10% in all trading periods of the day whereas a second component might decrease South Island demand by 3% in trading periods 30-36. Users add components one at a time until they’ve finished building the override, and then they submit it. After an override has been submitted it is stored in the system and is then available for all vSPD-online users to make use of.
Three ways to modify input data
When specifying how the base case input data is to be modified, three methods are available:
- Scale – scale the existing base case data by some scalar, e.g. 0.95 to reduce by 5% or 1.1 to increase by 10%.
- Increment – increase or decrease the existing base case data by some specified amount, e.g. 7.3 to increase demand by 7.3MW or -5 to decrease demand by 5MW.
- Replace – replace the existing base case data with a new value.
Three ways to create an override component
Three approaches to adding a new component to an override are available:
- Create a new component from scratch.
- Use an existing override as a starting point and edit it to create new override components for the current override.
- Upload the required data from a CSV or an Excel file – this first requires first downloading an override component so that a file template is available for editing. An opportunity to download an override component as a CSV or an Excel file exists during the process of adding components to an override.
Create a job
Activating the 'create a job' function causes the vSPD-online user to be stepped through the process of configuring an instance of the vSPD model to be solved.
The job must be given a name and description – users should try to make these as meaningful as possible, as the name and description will appear in the vSPD dashboard for all to see. If an override is to be applied, then the relevant override must be selected.
Solving vSPD without using an override simply causes the base case for the selected days and trading periods to be solved. In other words, the prices, dispatch, branch flows etc that actually occurred in the final pricing run of SPD for the day and trading periods selected will be reproduced. It is reasonable to do this if you want to compare the base case solution with one or more counterfactual solutions.
vSPD-online users are restricted to solving no more than seven contiguous days in one job. Within that 7-day interval, users may select any or all of the trading periods to be solved on any or all of the days.
Once the job has been submitted, it will appear as a record in the vSPD dashboard. When the job is finished, the user will receive an email containing a link to the vSPD output files, which can then be downloaded. Any other user can download the output files as well, directly from the vSPD dashboard.
