User Guide: Difference between revisions
| Line 13: | Line 13: | ||
== File Menu == | == File Menu == | ||
The file menu has the following options. | 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. | 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. | 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. | 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. | 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). | 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. | (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. | (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. | (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. | (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 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. | 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. | 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. | 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. | e) CloseAll: Close all views and documents. | ||
f) Save: This option is the same as Save As. | 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. | |||
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. | 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. | 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. | ||
Revision as of 20:17, 3 November 2006
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.