Jump to content

User Guide

From SELESwiki
Revision as of 20:30, 3 November 2006 by Fei (talk | contribs) (→File Menu)

Note: this conversion between the Word .doc and the Wiki is incomplete: please help

Documentation Version SELES v3.1

The purpose of this guide is to assist users of the Windows version of SELES. The SELES user interface is based on Windows NT, and runs best under Windows NT, Windows 2000 and Windows XP. It assumes that the models to be used have already been constructed. See the SELES Model Builder’s Guide and the SELES Scenario Reference for information on how to construct SELES models. This document describes how to use the SELES program to load in initial conditions and models and to run simulations.

Startup

After starting SELES, the user will be presented with the following interface. The operations available under each pull down menu are described in the following sections.

File Menu

The file menu has the following options.

  • a) New: Creates a new view window with a viewname “Seles#”, where # is a number (numbered sequentially from 1). The underlying raster will be 100 by 100, with all zeros.
  • b) New2: Creates a new view window with dimensions taken from a current view, and user specified bounds and name. A pull down list of current views can be used to select the reference layer.
  • c) Open: Open an existing file. The result of this operation depends on the contents of the file being opened. There are some file naming conventions, but the name itself is not used to determine the type of file. There are four main types of files that can be opened: GIS raster map files, SELES static model files, SELES dynamic model files and SELES scenario files. These files are each opened by selecting the desired file using the browser. Information on the internal structure of these SELES files is described in other documents.

The GIS formats supported are GRASS (binary, compressed and ASCII), ERDAS (8 and 16 bit) and ARC ASCII. To open a GIS raster map file, select the raster file in a GIS database to open (for GRASS this will be a file in the “cell” directory of a mapset). The map contained in this file (in conjunction with information stored in associated files, such as the header and colour files) will be displayed in a new window.

There are four types of static model files (See the section on the Static Models Menu and the SELES Static Model Reference for more details).

  • (i) SELES Neutral Model Files (generally with a .nm suffix) contain information for creating neutral models. Provided that a valid model is read, a new view is opened and an instance of the model is generated.
  • (ii) SELES Site Specific Model Files (generally with a .sm suffix) contain information for creating site-specific models. Provided that a valid model is read, and that the views required by this model exist, a new view is opened and an instance of the model is generated.
  • (iii) SELES Fractal Model Files (generally with a .frm suffix) contain information for creating fractal models. Provided that a valid model is read, a new view is opened and an instance of the model is generated.
  • (iv) SELES Value Model Files (generally with a .vm suffix) contain information for creating Value (or Statistical Summary) Models. Provided that a value model is read, and that the views required by this model exist, an instance of the model is generated.

SELES Simulation Model Files (generally with a .sel suffix) are used to organize and store a complete specification of a dynamic landscape simulation model. Provided a valid simulation model is read, and that the views containing the initial conditions for the simulation exist, the simulation is set up. This set-up reads in and checks the landscape events used by the model, and initializes the initial state of all raster layers. Any views for displaying the output state of dynamic layers are automatically created, if required. SELES Scenario Files (generally with a .scn suffix) are used to group a set of GIS and model files. When opened, each sub-model file listed in the scenario file will be loaded in the order specified. This is useful, for example, to load a set of GIS raster layers that form the initial conditions for a simulation and a SELES Simulation Model.

  • c) DryRun: Opens and “dry runs” a scenario file. A dry run performs all tasks in a scenario except for actually running a simulation.
  • d) Close: Close the current selected view. This can also be accomplished by clicking with the mouse on the “Close” icon (the “X”) on the top right corner of the view window.
  • e) CloseAll: Close all views and documents.
  • f) Save: This option is the same as Save As.
  • g) Save As ...: Save the raster in the currently active view as a GIS raster file or the

currently displayed image in the view as a JPEG file. This option will bring up a file browser from which the directory and file name can be set. The “Save as type” pull-down menu allows selection of the type of information or GIS format to save. The directory for a GRASS GIS raster should be the “cell” directory of a GRASS mapset. The header and other required associated files will be automatically created in the correct directory of the mapset.

  • h) List of recent documents: Between the print options and the Exit option is a list of the recently opened documents (if any). A document can be re-opened or the window associated with a currently opened document can be activated by selecting from this list.
  • i) Exit: Exit the SELES application. This can also be achieved by clicking with the mouse on the “Close” icon (the “X”) on the top right corner of the main application window.

View Menu

The main options available from this menu are “Raster View Properties”, “Show Legend” and “Histogram”. Show Legend brings up a dialog that displays legend information (taken from a GRASS-format “cats”, or category, file associated with a raster or model file) for the currently selected view. It also shows the colour, value and label under the mouse position.

Raster View Properties brings up the following dialog box to control image display properties. The “Colour Display” check box controls whether the image is output in colour or 

black and white. The “Raster Number” list is only used for multi-layer (interleaved) rasters. Each view of a multi-layer raster can select a single raster layer for display.  The "Raster Value Range" is used to select an appropriate range of values for displaying these rasters.  For ordinary rasters, the value range shows the minimum and maximum values for the raster and cannot be edited.  The option “Fit Colours to Max/Min will rescale the colour lookup table to match the actual range of values rather than the bounds.

The “Use Image as Mask” option allows selection of another view to use as a visual mask on the current image. If selected, those values in the range [Minimum, Maximum] from the mask image will be drawn over the current layer.

The “Use Image as Hue” allows another image to be used as a hue modifier for the current image display. If selected, then the chosen view will be used to modify the hue of the current image. The minimum and maximum values from the chosen view should contain values that specify the minimum and maximum hue value in the hue image. Higher values in the hue image will cause the corresponding pixels in the current image to be displayed brighter.

The “Use Image as Depth” option allows an image to be displayed as a 3-D map, where the selected image provides the height, or elevation, of each pixel in the 3-D map. If selected, then the current image will be "draped" over the 3-D representation of the "Depth" image. There are two methods for rendering the 3-D representation of the height data. “Continuous” height data is used when the raster is a continuous variable (such as elevation), in which neighbouring values have similar in values, and are thus interpolated. “Discrete” height data is for rasters that represent a categorical variable, and so neighbouring height values are not assumed to be related.

This dialog box is also used to control the shared memory state of the image in a view. The default is for the image to be local. That is, the memory for the image is local and internal to the current SELES application. If “Offer Image to Share” is selected, then the image will be local to the current SELES application, but other applications that include SEED shared memory support can access the image directly. That is, an external application can “open” the shared memory image and access it as if the memory were local to that application. If “Share External Memory” is selected, then the image named in the “External Image Name” is assumed to have been offered by some external application with SEED shared memory support. If found, the image behaves as if it was local to this SELES application, but it will actually be in shared memory between the two applications.

The “Histogram” option brings up a dialog box with which simple histograms can be displayed of selected layers, optionally masked by other layers”. The colours used for the histogram classes are taken from the colour used for the smallest value in the class. The “Histogram2” option brings up a more detailed dialog box in which histograms can be specified as in summary models by defining the region over which the histogram is defined, and the function used to define classes.

Retrieved from "https://seles.info/index.php?title=User_Guide&oldid=2738"