.. _XPageModel: Model Page ---------- The *Model Page* of DEXiWin :ref:`Model Window ` provides :ref:`workspace ` and :ref:`commands ` for editing a :ref:`DEXi model `: its `structure `__, `attributes `__, `scales `__ and `functions `__, but excluding `alternatives `__. .. image:: images/PageModel.png :alt: DEXiWin: Model Page .. _XPageModelWorkspace: Workspace ~~~~~~~~~ The *Model Page* workspace consists of two main areas: - *Model tree view* (left): This area displays the structure of the edited model. The first column shows attributes and their :ref:`status `. There are up to three associated columns that display the selected attribute's *Description*, *Scale* and *Function* summary. The visibility of individual colums can be selected through the :ref:`View ` menu. - *Attribute panel* (right): Contains fields for editing the name, description, scale and function of the currently selected attribute in the *Model tree view*. This panel can be visible or not, depending on :ref:`View ` menu settings. There are four buttons located on the panel, which correspond to :ref:`commands ` that activate editing windows: - |AttDescr| Attribute's name and description - |Scale| :ref:`Scale Editor`, associated with - |SelectScale| :ref:`Scale Selection ` - |Function| :ref:`Function Editor ` (available only for aggregate attributes) .. _XPageModelCommands: Commands ~~~~~~~~ *Model Page* commands can be invoked by: - Pressing a button shown on the toolbar or *Attribute panel* - Invoking some :ref:`editing command ` - Selecting an item from the pop-up menu that appears after right-clicking the mouse - Selecting an item from the menus: - :ref:`File ` - :ref:`Edit ` - :ref:`View ` - :ref:`Window ` - :ref:`Help ` .. _XMenuEditModel: Model Editing Commands ~~~~~~~~~~~~~~~~~~~~~~ |ModelDescr| **Edit model name and description**: Opens a separate window for editing this model's name and description. |AttDescr| **Edit attribute name and description**: Opens a separate window for editing the name and description of the currently selected attribute. |AddAttDown| **Add attribute**: This command creates a new attribute and inserts it into the tree as a sibling of the currently selected attribute. The new attribute is automatically called "New", so you should consider giving it a more meaningful name. |AddAttRight| **Add child**: Creates a new attribute and inserts it into the tree as a child of the currently selected attribute. The new attribute is automatically called "New", so you should consider giving it a more meaningful name. |DeleteAttribute| **Delete attribute or subtree**: The effect of this command depends on the type of the currently selected attribute: - For an aggregate attribute: it discards all its descendants and its function, effectively converting it into a basic attribute. - For a basic attribute: it deletes that attribute. Thus, to completely delete a sub-tree of attributes from the model, you should "delete it twice". |Cut| **Cut**: Equivalent to **Copy** followed by **Delete attribute or subtree**. |Copy| **Copy**: Copies the currently selected sub-tree into the clipboard for further use. |Paste| **Paste**: Inserts previously **Cut** or **Copied** sub-tree into the model, replacing the currently selected basic attribute. Pasting is enabled only when positioned on a basic attribute that has a compatible scale with the cut/copied subtree. |DuplicateAttribute| **Duplicate**: Makes a copy of the currently selected attribute or sub-tree and inserts it as a new top-level sub-tree in the model, so that it can be moved around later. |MoveDown| **Move down**: Moves the currently selected attribute one place down according to what is shown in the tree view. |MoveUp| **Move up**: Moves the currently selected attribute one place up according to what is shown in the tree view. |Search| **Search...**: Open a window in which you can define a text to be searched for in the model. You can also select components in which to search: attribute names, attribute descriptions, and/or scales. The search can be case sensitive or not. |FindNext| **Find next**: Continues searching from the current position in the model. |Undo| **Undo**: Undo the last tree-editing operation. |Redo| **Redo**: Redo the last undone tree-editing operation. Edit/Scale """""""""" |Scale| **Edit scale...**: Invokes the :ref:`Scale Editor ` to create or edit the scale of the currently selected attribute. |SelectScale| **Select scale...**: Invokes the :ref:`Scale Selector ` window to select/change the scale of the current attribute from the list of compatible scales. |DeleteScale| **Delete scale**: Deletes the scale of the currently selected attribute. |ReverseScale| **Reverse scale**: The scale of the currently selected attribute is reversed: all scale's values are put in reverse order, and the scale's order is changed from ascending to descending or vice versa. The underlying functions, if any, are also changed so that the original function mappings are preserved. Edit/Function """"""""""""" |Function| **Edit function**: Invokes the :ref:`Function Editor ` to create or edit the aggregation or discretization function corresponding to the currently selected aggregate attribute. |DeleteFunction| **Delete function**: Deletes the aggregation or discretization function associated with the currently selected aggregate attribute. .. _XPageModelEdit: Other Model Editing Commands """""""""""""""""""""""""""" The following model editing commands can also be invoked on the *Model tree view*: **F2** or double click on attribute name: Start editing attribute name. Double click on attribute name or description: Start editing the text. **Drag and drop**: Move individual attributes or sub-trees from one position in the model to another. After dropping, the moved subtree is attached as a child to the target attribute. Only those moves are allowed that do not introduce cycles in the model. A subtree cannot be moved to itself. **Join attributes**: This is a special case of **Drag and drop** for joining (merging) two attributes together. It can be invoked by dragging a child attribute to the parent one, but only when the former is the only child of its parent and the scales of the attributes are compatible. .. _XMenuViewModel: View Menu ~~~~~~~~~ |ExpandAll| **Expand all**: Fully expand tree view and show all attributes. |ExpandOne| **Expand one level**: Extends the display of the tree by expanding the inner-most collapsed sub-trees by one level. |CollapseAll| **Collapse all**: Fully collapse tree view so that only root attributes are displayed. |CollapseOne| **Collapse one level**: Collapses the display of the tree by one level. **F8** **Resize columns**: Adapt columns of the *Model tree view* to the actual width of displayed text. **Attribute panel**: Display or hide *Attribute panel*. **Description**: Display or hide the *Description* column in the *Model tree view*. **Scale**: Display or hide the *Scale* column in the *Model tree view*. **Function**: Display or hide the *Function* summary column in the *Model tree view*. |TreeView| **Tree view...**: Open the :ref:`Tree View ` window. .. _XPageModel_stat: Attribute Status ~~~~~~~~~~~~~~~~ In the *Model tree view*, attributes are associated with different icons that indicate their status. Status of Aggregate Attributes """""""""""""""""""""""""""""" - |StatAggUndef|: Aggregate attribute without defined scale and function. - |StatAggUndefIncomplete|: Aggregate attribute with defined scale, but undefined function. A function cannot be created due to incompletely defined child attributes. - |StatAggUndefOk|: Aggregate attribute with defined scale, but undefined function. A function can be created. - |StatAggDefUndet|: Aggregate attribute with defined scale and function. However, the function is not fully `determined `__. - |StatAggDefDet|: Aggregate attribute with defined scale and fully determined function (the desired state of any function). Status of Basic Attributes """""""""""""""""""""""""" - |StatBasicUnDef|: A basic attribute with an undefined scale. - |StatBasicDiscr|: A basic attribute with a defined `discrete (qualitative) `__ scale. - |StatBasicCont|: A basic attribute with a defined `continuous `__ scale. - |StatBasicLink|: A `linked `__ attribute. Remarks ~~~~~~~ Changing the structure and scales of attributes can substantially affect previously defined functions and alternatives. In some cases, for example when adding or deleting an attribute value, DEXiWin tries to adapt the affected function and alternatives so that information is preserved as much as possible. Unfortunately, such adaptation are not possible with some drastic changes, such as when adding or deleting attributes. In these cases, the function is deleted by DEXiWin and should be defined anew. Before deleting a function, DEXiWin issues a warning and asks for confirmation. Consequently, you might want to develop your tree structure as completely as possible before attempting to define functions and alternatives. .. |ModelDescr| image:: icons/ImgModelDescr.png .. |AttDescr| image:: icons/ImgAttDescr.png .. |Function| image:: icons/ImgFunction.png .. |DeleteFunction| image:: icons/ImgFunctionDelete.png .. |Scale| image:: icons/ImgScale.png .. |SelectScale| image:: icons/ImgScaleSelect.png .. |DeleteScale| image:: icons/ImgScaleDelete.png .. |ReverseScale| image:: icons/ImgScaleReverse.png .. |AddAttDown| image:: icons/ImgAttributeAddDown.png .. |AddAttRight| image:: icons/ImgAttributeAddRight.png .. |DeleteAttribute| image:: icons/ImgAttributeDelete.png .. |DuplicateAttribute| image:: icons/ImgAttributeDuplicate.png .. |Cut| image:: icons/ImgCut.png .. |Copy| image:: icons/ImgCopy.png .. |Paste| image:: icons/ImgPaste.png .. |MoveUp| image:: icons/ImgMoveUp.png .. |MoveDown| image:: icons/ImgMoveDown.png .. |Search| image:: icons/ImgSearch.png .. |FindNext| image:: icons/ImgFindNext.png .. |ExpandAll| image:: icons/ImgTreeExpandAll.png .. |ExpandOne| image:: icons/ImgTreeExpandOne.png .. |CollapseAll| image:: icons/ImgTreeCollapseAll.png .. |CollapseOne| image:: icons/ImgTreeCollapseOne.png .. |Undo| image:: icons/ImgUndo.png .. |Redo| image:: icons/ImgRedo.png .. |TreeView| image:: icons/ImgTreeView.png .. |StatAggUndef| image:: icons/ImgAttAggUndef.png .. |StatAggUndefIncomplete| image:: icons/ImgAttAggUndefIncomplete.png .. |StatAggUndefOk| image:: icons/ImgAttAggUndefOK.png .. |StatAggDefUndet| image:: icons/ImgAttAggDefUndet.png .. |StatAggDefDet| image:: icons/ImgAttAggDefDet.png .. |StatBasicUnDef| image:: icons/ImgAttTermUnDef.png .. |StatBasicDiscr| image:: icons/ImgAttTermDiscr.png .. |StatBasicCont| image:: icons/ImgAttTermCont.png .. |StatBasicLink| image:: icons/ImgAttTermLink.png .. toctree:: :hidden: XMenuFile XMenuWindow XEditScale XSelectScale XEditFunction