where_AKA (09/21/09)

CRHM Platform

AKA Screen.

    The AKA function was used in the development of CRHM to provide features before they could be implemented properly. It is not supported and should never be used.

    The AKA menu  provides an overview to all the inputs and outputs of a CRHM model.  It has two major views,

  1. Variables - shows all module output and input variables.
  2. Observations - displays all observations pertaining to the model.  Observations are denoted as simple or declared (terminated with a '#' SYMBOL).  The former are from original meteorological data and the latter are module generated observations, usually derived from the former, i.e. from meteorological data.

    The main purpose of this screen is to control the flow of observations within a model.  An important secondary use is to allow the user to rename simple observations.

Screen Components.

    The centre of the screen is a spreadsheet.  The two columns on the right hand side lists the outputs and their sources. These are available for inputs to other modules. The source can be a module or 'observation' if a simple observation. Along the top of the spreadsheet the modules and their inputs are listed and underneath the input is listed again opposite its source.

Radio buttons.

    By selecting one of the two mutually exclusive buttons,  the user can choose the Variables or Observations display.

Script.

    This text pad displays the script instructions to CRHM that control the model.  It is largely intended to be used as an informational screen.  The file menu allows the script to be saved and restored to alter another model without having to re-type the instructions.  The scripts for the Variable/Observations are handled separately and are compiled into the current model using the 'save to model' button.

ListBox.

    Lists all the modules  in the current model.

File menu.

It allows the script  to be saved in a file (*.aka). A previously saved script may be loaded and applied to the current screen.

The usual file options are available; Open, Save, Save As and Exit.

'Save to Model'

    Saves the changes to the current screen script to the model.

'Void Changes'

    Will remove any current changes up to the last 'Save to Model' for this screen.  To remove all changes use 'Escape'.  However this will remove all changes in all screens since the AKA screen was loaded.

'Remove Unused'

    Removes all unused observations or variables.

'Escape'

    Exits AKA screen restoring all the model scripts to what they were before the AKA screen was executed. 

    N.B. The normal way of exiting the AKA screen is via 'Exit' in the top right hand corner or in the file menu.  This will save any changes made.

Editing Screens.

    Rename.

Allows simple observations to be renamed to what is available in the open observation file(s).  It does not check availability till run time.  Display cell "u", will change to e.g. "[ u -> UUU ]" if the observation "u" has been renamed "UUU". The observation "UUU" must exist when the model is run.

    Connect and Re-connect.

This operation allows the user to change module inputs.  This feature is executed by first selecting the cell beside the desired new name (column 2, it will be empty if not a renamed simple observation).  Next, right click on the module input to be changed.  The cell will now contain the new name.  Left clicking returns to the original value.  Display cell "QdroDext" will change to "[QdroDext -> QdroFlatD]" if the input "QdroDext" is redirected to "QdroFlatD".  When the model is run the normal input "QdroDext" will use the "QdroFlatD" values.  An observation example is "Qsi" becoming "[ Qsi -> QsiA# ]".  Instead of the simple observation "Qsi" being used the calculated "QsiA#" from the module "Annandale" will be used.  In the examples "--> QsiA#" and "--> QdroFlatD" will appear opposite the source of the variables to indicate to the user it is being used.