Geomatica Modeler. User Guide. Version 10.1

Transcription

1 User Guide Version 10.1

2 2007 Enterprises Inc.. All rights reserved. COPYRIGHT NOTICE Software copyrighted by, 50 West Wilmot St., Suite 200, Richmond Hill, ON CANADA L4B 1M5 Telephone number: (905) RESTRICTED RIGHTS Canadian Government Use, duplication, or disclosure by the Government is subject to restrictions as set forth in DSS "General Conditions - Short Form - Licensed Software". U.S. Government Use, duplication, or disclosure by the Government is subject to restrictions set forth in subparagraph (b)(3) of the Rights in Technical Data and Computer Software clause of DFARS or subparagraph (c)(1) and (2) of the Commercial Computer Software-Restricted Rights clause at 48 CFR as amended, or any successor regulations thereto. PCI,, PCI and design (logo), Geomatica, Committed to GeoIntelligence Solutions, GeoGateway, FLY!, OrthoEngine, RADARSOFT, EASI/PACE, ImageWorks, GCPWorks, PCI Author, PCI Visual Modeler, and SPANS are registered trademarks of PCI Geomatics Enterprises, Inc. Sentinel is a registered trademark of SafeNet, Inc. All other trademarks and registered trademarks are the property of their respective owners.

3 Table of Contents Introduction to Modeler... 7 Starting Modeler from a UNIX operating system... 7 Starting Modeler from a Windows operating system... 7 Model graphical elements... 7 Module graphical elements... 8 Understanding the Modeler window Setting preferences for the Modeler window Setting preferences for a canvas Exiting Modeler Using the Module Librarian Opening the Module Librarian from the Modeler window...15 Closing the Module Librarian from the Modeler window Viewing available modules...15 Resizing the Module Librarian window...16 Managing module categories...16 Hiding and displaying folders...17 Placing an example model on the canvas Reconfiguring and saving an example model in Read Only mode Editing and saving an example model Viewing a list of modules used in a session Searching for modules Searching the Module Librarian for one or more keywords Working with a model Opening a model...21 Opening a model from a PIX file Opening a model from the file list Closing a model Setting model preferences Making a model read-only Making a model writeable...23 Saving a new model...23 Overwriting an existing model...23 Saving a model with a different name...23 i

4 Creating a profile for a model Refreshing a model...24 Viewing the whole model Viewing a model in compact mode Toggling between models Zooming in on a model...25 Zooming out from a model...25 Deleting a model from canvas Constructing and executing a model Placing a module on the canvas using Add to Canvas...27 Placing a module on the canvas using Select Algorithm Moving a single module Moving two or more modules simultaneously Changing the location of a module's ports by 90 degrees Deleting a module from the canvas...28 Deleting two or more modules simultaneously Connecting modules with a pipe Setting preferences for pipes Accessing a module's control panel...30 Accessing the control panels of two or more modules Closing all control panels Hiding the icon of a module Making icons visible Accessing the File Utility...31 Executing a model in single execution mode Stopping a run in single execution mode...32 Re-running a model in single execution mode Viewing a log message...32 Viewing the console content...32 Viewing pipe content Viewing cache content Clearing cache contents...33 Activating a deactivated module Process flow for constructing a model...34 Accessing the control panel of a module in the Module Librarian Viewing a list of modules used in a session Accessing the GeoRaster Metadata Mapper Construction of a single execution model...37 Classifying and converting raster data to vector data Step 1: Placing the modules on the canvas Step 2: Configuring the first Import module...37 ii

5 Step 3: Configuring the second Import module...38 Step 4: Connecting the modules Step 5: Configuring the FMO module...38 Step 6: Configuring the Export module Step 7: Executing the model Batch processing Understanding the Batch Parameter Sets Table...41 Creating a model for batch processing Types of batch processing...42 One file-to-many batch parameter sets...42 Many files-to-one batch parameter set Many files-to-many batch parameter sets Running a model in batch mode...44 Running modules configured for batch mode in single execution mode Stopping a model in batch mode...44 Scheduling a batch process Constructing and executing a simple model in batch mode Step 1: Placing the Import module on the canvas Step 2: Setting the batch parameters for the Import module Step 3: Placing the remaining modules on the canvas Step 4: Connecting the modules Step 5: Setting the batch parameters for the Contour module...48 Step 6: Setting the batch parameters for the Export module Step 7: Setting the batch parameters for the Viewer module Step 8: Testing the irvine. pix file Step 9: Running the model in batch mode Common modules...51 Parameter-specific information Configuring a module Import module Placing the Import module on the canvas Accessing Import module from the control panel Choosing input layers Viewing process messages Displaying the Import module in batch mode Loading one input file multiple times Loading multiple input files individually Loading multiple input files simultaneously Choosing individual input layers Choosing all layers simultaneously Deselecting all selected layers iii

6 Removing a batch parameter set Returning to single execution mode Export module...55 Placing the Export module on the canvas Accessing Export module the control panel Configuring the Export module Viewing process messages Displaying the Export module in batch mode Selecting multiple output files simultaneously Using multiple input files as output files Adding multiple copies of the same output file Saving all output files to the same directory Adding a prefix, a suffix, or a time stamp to all output file names Auto-incrementing all file names Viewer module...59 Placing the Viewer module on the canvas Accessing the Viewer module control panel Configuring the Viewer module Viewing process messages Displaying the Viewer module in batch mode Configuring the Viewer module for batch mode Adding a batch parameter set Auto-incrementing a parameter Removing a batch parameter set Closing all viewers Returning to single execution mode Split and Merge modules...61 Placing the Split module on the canvas Accessing the Split module control panel Viewing process messages Placing the Merge module on the canvas Accessing the Merge module control panel Viewing process messages TypeSplit and TypeMerge modules...62 Placing the TypeSplit module on the canvas Accessing the TypeSplit module control panel Configuring the TypeSplit module Viewing process messages Placing the TypeMerge module on the canvas Accessing the TypeMerge module control panel Viewing process messages iv

7 Accumulate module Placing the Accumulate module on the canvas Accessing the Accumulate module control panel Viewing process messages Release and Comment modules...64 Placing the Release module on the canvas Accessing the Release module control panel Configuring the Release module Viewing process messages Placing the Comment module on the canvas Accessing the Comment module control panel Adding text to the Comment module Reproj module...65 Placing the Reproj module on the canvas Accessing the Reproj module control panel:...66 Choosing projections and extents Choosing a Pixel projection Choosing a UTM projection Choosing an earth model Choosing a Long/Lat projection Choosing a Meter projection Choosing a Foot projection Choosing projections for SPCS Choosing other projections Choosing a resample method Choosing a transformation order Choosing a sampling interval Viewing process messages Using the Reproj module in batch mode Setting the value for a parameter automatically Clearing an automatically set parameter Displaying the Reproj module in batch mode Adding batch parameter sets Changing parameters for all batch sets simultaneously Removing a batch parameter set Returning to single execution mode v

8 6

9 Chapter 1 Introduction to Modeler Geomatica Modeler provides an interactive methodology for the development of both simple and complex data processing flows. Modeler provides access to a number of standard operations such as data import and export, as well as most EASI/PACE processing algorithms. You build processing models by placing modules on the Modeler canvas and then connecting the modules with pipes to create a process flow. You first configure the modules and then execute the model in either single execution mode or batch mode. During the execution of the model, graphical cues indicate the data flow through the process. The Module Librarian enables quick access to all modules. operating system 1. Start Geomatica. 2. On the Geomatica toolbar, click the Modeler button. Model graphical elements A model that you create on the Modeler canvas consists of graphical elements representing modules and data flow. Figure 1. Example of a model Starting Modeler from a UNIX operating system Type modeler at the command line. Starting Modeler from a Windows 7

10 Module graphical elements A graphical element representing a module consists of an icon, the module name, the status indicator bar, and one or more port glyphs. Figure 2. Example of a module graphic Glyphs Glyphs are graphical representations of data ports. Ports are the data input and output points of a module. Figure 4. Example of a glyph Most modules have at least one data input and one data output port. Some modules, however, have only input or output ports; for example, the Import module has only output ports, while the Export module has only input ports. A few modules have neither input nor output ports, such as the IHR module, which reads a database image header. Icons The term icon refers to the graphic located at the center of a module graphical element and identifies the function of a module. Figure 3. Icon for the Import module An input glyph represents an input port where data is stored prior to being processed by the module. Moving the cursor over the glyph displays an arrow showing the direction of data flow. An output glyph represents an output port where processed data is stored. Moving the cursor over the glyph displays an arrow showing the direction of data flow. One output port can be connected to multiple input ports. The connection characteristics of a port are indicated by the color of its glyph: Red: Mandatory connection Green: A connected port 8

11 Yellow: Optional connection Grayed out: No connection possible A port can be "thin" or "fat". A thin port accepts a single layer or segment. A fat port, which is slightly larger than a thin port, accepts multiple layers or segments. Each type of data has a corresponding port, and hence a corresponding glyph. Some modules can accept more than one type of data and, therefore, can display more than one type of glyph. The most common glyph types are shown in the table below. Table 1. Common glyphs Raster Layer Lookup Table (LUT) Bitmap Layer Vector Layer Text Mixed Layers Signature Layer Pseudocolor Table Ground Control Points Layer Any Port: accepts all layer types Signatures Math Model When you position your cursor over a glyph, the port type displays in the status area of the Modeler window. For information on the Modeler window, see Understanding the Modeler window on page 12. When you click a module's output glyph, ports on modules that cannot accept data from that module are shaded gray. Ports that can accept data do not change. Any and Mixed ports Ports of the Any type can accept all layer types shown in Table 1. Although you can feed more than one layer into an Any port, you cannot concurrently feed in layers of different types. For example, an Any port can accept two raster layers, but not a combination of one raster layer and one vector layer. When you connect an Any port, its glyph changes to reflect the type of layer the port contains. A Mixed port can accept more than one type of layer and more than one layer of each type. For example, you can feed two raster layers and two vector layers into a Mixed port. When you connect a Mixed port, its glyph does not change. Master ports The master port is the first input port on most modules. Master ports are not graphically distinguished from other port types. Figure 5. Master port 9

12 If you run a module that is not correctly configured, it displays a broken icon (figure below). For information on activating a module, see Activating a deactivated module on page 33. Figure 6. Deactivated module A master port defines the resolution, the bounds, and the georeferencing for all layers feeding into any other port on the module. If a layer with a resolution or extent different from that defined by the master port is fed into a non-master port, the layer may be re-sampled, cropped, or extended to conform with the master port settings. Generally, you must have data in the master port of a module for a model to run. Status indicator bar The color of a module's status indicator bar indicates the processing mode: Red: Module is not connected or is improperly configured and will not execute Green: Module is properly configured and is ready to execute Blue: Module is in processing mode Gray: Processing is complete and data is stored in the cache Yellow: A warning message has been logged Pipes Pipes are graphical elements that represent data transmission paths between modules. A pipe can be "thin" or "fat". A thin pipe contains only one layer of information. A fat pipe, which is wider than a thin pipe, contains multiple layers of information. Figure 7. Pipe types Deactivated module 10

13 Thin pipes connect to thin ports only, and fat pipes connect to fat ports only. However, there is an exception to this rule. If you connect a module with a single output layer to a second module, a thin pipe will connect the modules. If you then increase the number of output layers, a fat pipe will connect the modules. However, the thin input port will not change to a fat input port. If you run the model, the second module deactivates. Modules are connected by clicking the output port of the module to connect from and then clicking the input port of the module to connect to. Figure 8. Module connections With this type of connection, the same data is sent to both modules. The connection does not split the data. For information on splitting data, see Placing the Split module on the canvas on page 61. You can also connect between a pipe and a module by first clicking the pipe, and then clicking the input port on the connecting module. Figure 9. Module linked to pipe Pipe types A pipe is default color-coded according to the type of data that it transmits: Green: Raster data White: Vector data Red: Bitmap data Blue: Pseudocolor table Yellow: Lookup table Black: Dead pipe Tip: The most frequent causes for dead pipes are moving, renaming, and deleting an input file or layer. For information on customizing pipe color, see Connecting modules with a pipe on page

14 Caches After a model has executed without errors, bulges (called caches) containing intermediate files form. To save a file stored in a cache, you must attach an Export module to the pipe containing the cache. For information on the Export module, see Placing the Export module on the canvas on page 55. Figure 10. Graphical representation of a cache The menu bar and the toolbar provide access to functionalities that apply to a model and the Modeler window. Models are constructed on the canvas. For information on viewing cache content, see Viewing pipe content on page 32. Understanding the Modeler window The Modeler window contains a menu bar, a toolbar, a canvas, and a status area. Figure 11. Modeler window The left field of the status area displays information about the processing mode of a model, such as Writeable, ReadOnly, or Drag Mode. When you pass your cursor over an object (such as a module, a pipe, or a port) on the canvas, information about that object displays in the center field of the status area. This field also displays any Modeler actions, such as loading a model or opening the Module Librarian. The right field of the status area displays the processing bar when a model executes. Setting preferences for the Modeler window You can choose whether or not to display the Modeler 12

15 toolbar and the status area. You can also customize the canvas size to fit the model size. Furthermore, you can customize the Modeler window size and the cache viewer window size. To set preferences for the Modeler window: 1. From the Preference menu, choose Preference. The Main Preferences dialog box opens. 2. Click the Windows tab. 3. In the Windows Attributes section, enable the Button Bar check box to display the Modeler toolbar. 4. Enable the Status Area check box to display the status area. 5. Enable the Use Model Bounds check box to match the dimensions of the canvas to the dimensions of the model. To customize the Modeler window size: 1. In the Window Size section, click the down arrow to the right of X-Size, and choose a number between 256 and The default setting for X-size is 600 pixels. 2. Click the down arrow to the right of Y-Size, and choose a number between 256 and The default setting for Y-size is 434 pixels. To customize the cache viewer window size: 1. In the Cache Window Size section, click the down arrow to the right of X-Size, and choose a number between 64 and The default setting for X-size is 256 pixels. 2. Click the down arrow to the right of Y-Size, and choose a number between 64 and The default setting for X-size is 256 pixels. To set default parameters for the windows: 1. In the Set to Defaults section, click Default. 2. Click Accept. To save the Modeler and Cache window preferences: From the Preference menu, choose Save Preferences. Setting preferences for a canvas You can use the New Model function to display a blank canvas. You can create a model on the blank canvas without closing any open models. You can also customize the color of the canvas and display a customized grid to which you can snap model graphical elements. After you have set your canvas preferences, you can save them. To open a blank canvas: From the File menu, choose New Model. A blank 13

16 canvas displays. Tip: You can also open a blank canvas by clicking the New Model button on the Modeler menu, by choosing the Grid command. If a check mark displays next to Grid, a grid displays. If a check mark does not display, the grid does not display. toolbar. To set the canvas background color: 1. From the Preference menu, choose Preference. The Main Preferences dialog box opens. 2. Click the Canvas tab if it is not already displayed. 3. In the Canvas Attribute section, click the down arrow to the right of Background Color, and choose a color from the list. To display a grid: 1. In the Grid Attribute section, enable the Grid check box to display grid lines on the canvas. 2. Enable the Snap to Grid check box to snap graphical elements to the grid. 3. Click the down arrow to the right of Grid Color, and choose a color from the list. 4. Click the up arrow or the down arrow to the right of X-size, and choose a spacing between vertical grid lines. 5. Click the up arrow or the down arrow to the right of Y-size, and choose a spacing between horizontal grid lines. Tip: You can also choose the Snap Grid function from the View menu by choosing the Snap Grid command. If a check mark displays next to Snap Grid, the function is enabled. If a check mark does not display, the function is disabled. To set default preferences for the canvas: 1. In the Set to Defaults section, click Default. 2. Click Accept. To save the canvas preferences: From the Preference menu, choose Save Preferences. Exiting Modeler You can exit Modeler from the File menu. From the File menu, choose Exit. The Modeler window and the Module Librarian close. Tip: You can also display the grid from the View 14

17 Chapter 2 Using the Module Librarian The Module Librarian provides access to the modules that can process your data. When you start Modeler, the Module Librarian and the Modeler window open simultaneously. You can also open or close the Module Librarian from the Modeler window. Opening the Module Librarian from the Modeler window The Module Librarian provides access to the modules that can process your data. When you start Modeler, the Module Librarian and the Modeler window open simultaneously. You can also open or close the Module Librarian from the Modeler window. If the Module Librarian dialog box is closed, then from the View menu, choose Module Librarian. The Module Librarian dialog box opens. Closing the Module Librarian from the Modeler window If the Module Librarian dialog box is open, then from the View menu, choose Module Librarian. The Module Librarian dialog box closes. Tip: You can also open and close the Module Librarian from the Modeler toolbar by clicking the Module Librarian button. Viewing available modules Modules are the basic building blocks for your model. You access modules from the Algorithm Library tree view located in the left panel of the Module Librarian. Modules are sorted according to their functionality and are listed alphabetically. Algorithm Library categories The Algorithm Library displays the following categories: User Defined PCI Predefined PCI Predefined contains the following categories: All Algorithms All Bitmap Algorithms All Image Algorithms 15

18 All Vector Algorithms Geomatica Analysis Classification Common Data Interchange Image Correction Image Processing Radar Analysis Spatial Analysis Utilities Note: You can access only modules in the Module Librarian that are licensed to you. Modules that are not licensed to you are identified with a lock. Super-modules A super-module provides quick access to a number of modules that perform a similar task. The names of the modules comprising a super-module are displayed on the left-hand side of the super-module's control panel. All modules comprising the super-modules are also accessible from the Algorithm Library tree view of the Module Librarian dialog box. With a super-module, you can execute only one module at a time, and you must set all mandatory parameters for a module before you can run a super-module. You can access four super-modules: MTEXTRD: Text Reading From File MTEXTWR: Text Writing To File SUPCLASS: Supervised Classification USUPCLASS: Unsupervised Classification For more information on super-modules, see the Geomatica Algorithm Reference. Resizing the Module Librarian window You can change the size of the Module Librarian window. 1. Do one or more of the following: Click and drag a corner of the window to change the width and the height simultaneously. Click and drag the left or right border of the window to change the width of the window. Click and drag the top or bottom border of the window to change the height of the window. Managing module categories In the Algorithm Library tree view, you can create user-defined categories to which you can add shortcuts to your frequently used modules. You can also rename all user-defined categories. To create a folder in the User Defined category: In the Algorithm Library tree view, right-click the User Defined category folder, and click New Folder. To create a subfolder in the User Defined folder: 16

19 In the Algorithm Library tree view, right-click a User Defined category subfolder, and click New Folder. Note: You can create two levels of subfolders for the User Defined category. You cannot create subfolders for the PCI Predefined category. To rename the User Defined category folder or a subfolder: 1. Right-click the User Defined category folder or a subfolder, and choose Rename. 2. Type a name in the box. Note: You cannot rename a PCI Predefined category. To add a module shortcut to the User Defined category folder or a subfolder: 1. In the Algorithm Library tree view, choose a module name. 2. Right-click the module name, and choose Add to User Defined and the name of the category folder in which to place the module. Tip: You can also create a shortcut by clicking a module name in the PCI Predefined list and dragging it to a user-defined category folder. Note: You can create shortcuts to modules from the PCI Predefined category and from a shortcut in a user-defined category. To delete a User Defined category subfolder: In the Algorithm Library tree view, right-click a User Defined category subfolder, and choose Delete. Note: You cannot delete a PCI Predefined category. Hiding and displaying folders You can hide and delete shortcuts and folders that are displayed in the tree view but that you do not use. You can hide: The User Defined category folder and any of its subfolders and shortcuts The PCI Predefined category folder and any of its subfolders To hide a folder: Right-click a folder in the Algorithm Library tree view, and choose Hide. The folder no longer displays in the Algorithm Library tree view. To hide a shortcut in the User Defined category or a subfolder: Right-click a shortcut in the Algorithm Library tree view, and choose Hide. The shortcut no longer displays in the Algorithm Library tree view. Note: You cannot hide a module belonging to the PCI Predefined subcategories. 17

20 To display a hidden User Defined category folder: In the Algorithm Library tree view, right-click Algorithm Library, and choose Show All Categories. To display a hidden subfolder or shortcut belonging to the User Defined category: Right-click a subfolder containing a hidden folder or shortcut, and click Show All. The hidden subfolder or shortcut displays in the Algorithm Library tree view. To display a hidden PCI Predefined subfolder: Right-click PCI Predefined in the Algorithm Library tree view, and click Show All Categories. The hidden category folder displays in the Algorithm Library tree view. If more than one category folder was hidden, all hidden category folders display. Placing an example model on the canvas Before you start building a model around a specific module or modules, you can view a read-only example model of the module. You can also execute an example model after placing it on the canvas. You can execute the example model in single execution mode or in batch mode. To set up a model for batch mode, see Understanding the Batch Parameter Sets Table on page 41. For most example models, all parameters on the control panel are correctly set for one or more files located in the Geomatica demo folder. For more information on executing a model, see Executing a model in single execution mode on page 31. Note: Data for most example models can also be found on the demo data distribution CDs. The data on these CDs is organized in such a way that you can copy the entire contents of the CD (including subdirectories) directly to the /geomatica/demo directory. The example models provide you with information that can help you incorporate a module into a more complex model. For example, a model provides A brief description of the function of the module The type of data the module can process The number of Import modules required Whether or not the output is viewable Whether or not the process module needs to be accompanied by the Split or the Merge module Modules that must precede the module You can reconfigure and save a read-only model with a different name, and you can edit an example model and save it with a different name. In the Module Librarian, you can also view a list of modules that you have opened in a session. 1. From the Algorithm Library tree view, choose a 18

21 module. The module's icon displays in the Selected Algorithm window. 2. Click Load Example. The example model displays on the canvas. Reconfiguring and saving an example model in Read Only mode 1. Reconfigure one or more modules. 2. From the File menu, choose Save Model As. The File Selector dialog box opens. 3. In the File Selector dialog box, navigate to the folder in which you want to save the file. 4. In the File Name box, type a name. You cannot save the example model in read-only mode with its original name. 5. Click Save. Note: You can reconfigure the individual modules for an example model in Read Only mode, but you can neither move the modules on the canvas nor add modules to the model. To move or to add modules, you must first make the model editable; see Editing and saving an example model on page 19. Editing and saving an example model 1. From the File menu, choose Read Only. The check mark next to Read Only is removed. 2. Edit the model. 3. From the File menu, choose Save Model As. The File Selector dialog box opens. 4. In the File Selector dialog box, navigate to the folder in which you want to save the file. 5. In the File Name box, type a name. 6. Click Save. Caution: Do not overwrite example model files. Viewing a list of modules used in a session Right-click anywhere in the left panel of the Module Librarian. Searching for modules You can search the Module Librarian to locate a module based on its complete or partial name or based on one or more complete or partial keywords by using the algorithm search function. You can also search for a module name or keywords in a specific category in the Algorithm Library tree view. 1. In the Module Librarian dialog box, click Find. The Find Algorithm dialog box opens. 2. In the Find What box, type the complete or partial name of the module. 3. Enable one or more of the following check boxes: Match Algorithm Name: search for a module using the name of the module. 19

22 Wrap Around: when the check box is enabled, the Find Algorithm utility continues to show the results of the search each time you click Find Next. When the check box is cleared, the Find Algorithm utility searches through the Module Librarian only once. When the search is completed, the Find Algorithm utility shows an End of Search message. 4. Click Find Next. The module is selected in the Algorithm Library tree view and displays in the Selected Module window. the search is completed, the Find Algorithm utility shows an End of Search message. 4. Click Find Next. The module is selected in the Algorithm Library tree view and displays in the Selected Module window. Note: You can also access the Find Algorithm dialog box by right-clicking anywhere on the Algorithm Library tree view panel, and then choosing Find. All categories in the Module Librarian will be searched. Searching the Module Librarian for one or more keywords 1. In the Module Librarian, click Find. The Find Algorithm dialog box opens. 2. n the Find What box, type one or more complete or partial keywords. 3. Enable one or more of the following check boxes: Match Algorithm Description Using Any Keyword: search the Module Librarian using any of the keywords in the Find What box. Match Algorithm Description Using All Keywords: search the Module Librarian based on all keywords in the Find What box. Wrap Around: when the check box is enabled, the Find Algorithm utility continues to show the results of the search each time you click Find Next. When the check box is cleared, the Find Algorithm utility searches through the Module Librarian only once. When 20

23 Chapter 3 Working with a model Modeler makes it easy to open, close, delete, view, and save models. You can also set model preferences, create a profile for a model, or make a model read-only or writeable. Opening a model A model file has the extension.mod. You can also open a model from a PIX file. You can have more than one model open at the same time in Modeler. 1. From the File menu, choose Open Model. The File Selector dialog box opens. 2. Navigate to the folder containing the model file, choose the file from the list, and click Open. Tip: The selected model displays on the canvas. You can also open a model by clicking the Open button on the Modeler toolbar. Opening a model from a PIX file 1. From the File menu, choose Open Model from PIX File. The File Selector dialog box opens. 2. Navigate to the folder containing the PIX file you want to display, choose the file, and click Open. Note: To open a model from a PIX file, you must have saved the model to a text layer on a PIX File. You can save a model to a text layer from the control panel of the Export module, see Placing the Export module on the canvas on page 55. Opening a model from the file list From the File menu, choose a file name from the list of previously opened files. The selected model displays on the canvas. Closing a model 1. From the File menu, choose Close Model. The Modeler Warning dialog box opens. 2. In the Modeler Warning dialog box, choose one of the following: Save: Save model with current name Save As: Save model with a different name Discard Changes: Discard changes and close model Cancel: Do not save changes and keep model 21

24 open Caution: If you choose Save As, and then choose Cancel in the File Selector dialog box, the model closes and the changes are not saved. Tip: You can also close a model by clicking the Close button on the Modeler toolbar. Setting model preferences You can set model preferences, such as making module icons visible or invisible, displaying a model in compact mode, and setting pipe selection color. Making an icon invisible does not change the size of a module's graphical element, whereas choosing compact mode reduces the size of a module graphical elements. For more information on viewing a model in compact mode, see Viewing the whole model on page 24. After you have set the model preferences, you can save them. To set model attributes: 1. From the Preference menu, choose Preference. The Main Preferences dialog box opens. 2. Click the Model tab if it is not already displayed. 3. In the Model Attribute section, do any of the following: Enable the Icon Visible check box to make all icons visible Enable the Icon Compact Mode check box to reduce the size for the graphical element of all modules Click the down arrow to the right of Module Color, and choose a color Click the down arrow to the right of Module Selection Color to choose a module selection color 4. Click Accept. Note: You can also set the compact mode from the View menu, see Viewing a model in compact mode on page 25. You can also choose whether or not to display icons from the View menu, see Hiding the icon of a module on page 31. To set the pipe selection color: In the Pipe Attributes section, click the down arrow to the right of Pipe Selection Color, and choose a color. To set default values for a model attribute: 1. In the Set to Defaults section, click Default. 2. Click Accept. To save model preferences: From the Preference menu, choose Save 22

25 Preferences. Making a model read-only If the model is in writeable mode, from the File menu, choose Read Only. A check mark displays next to Read Only, and the model displays with a dark gray color. Making a model writeable If the model is in read-only mode, from the File menu, choose Read Only. The check mark next to Read Only is removed, and the model displays with color. Saving a new model 1. From the File menu, choose Save Model. The File Selector dialog box opens. 2. In the File Selector dialog box, navigate to the folder in which you want to save the model. 3. In the File Name box, type a name. 4. Click Save. Overwriting an existing model From the File menu, choose Save Model. Tip: You can also save a model by clicking the Save button on the Modeler toolbar. Note: When you save a model after it has executed, the intermediate file and the output files are not saved with the model. Saving a model with a different name 1. From the File menu, choose Save Model As. The File Selector dialog box opens. 2. In the File Selector dialog box, navigate to the folder in which you want to save the model. 3. In the File Name box, type a name. 4. Click Save. Creating a profile for a model You can create a model profile to add information about the model that may be required by other users. You can add information such as the author's and the organization's name and a description of the model. Some information, such as Modeler version number, is provided by default. 1. From the View menu, choose Model Profile. The 23

26 Model Profile dialog box opens. 2. In the Author box, type the name of the person who created the model. This field accepts up to 256 alphanumeric characters and typographic symbols. 3. In the Organization box, type the name of your organization. This field accepts up to 256 alphanumeric characters and typographic symbols. 4. In the Model Description box, type information about the model. 5. Do one of the following: Click Accept : Accept changes and close the dialog box. Click Cancel: Undo all the changes and close the dialog box. The following fields are read-only: Version: Displays the Modeler version used to develop a model Compatible Versions: Displays the Modeler versions that a model is compatible with Batch Information: Specifies whether or not a model contains batch file information Last Modified Date: Displays the date, in MM-DD-YY format, when a model was last modified. For example, July 1, 2002 displays as Last Modified Time: Displays the time, in HH:MM:ss format, when a model was last modified. For example, 5:30 in the afternoon displays as 17:30:00 Refreshing a model You can center a model on the canvas by using the Overview command from the View menu. When the size of the model layout exceeds the size of the canvas, choosing the Overview command will also resize the model dimension to match that of the canvas. By default, a module displays with A full-size icon A module name Input and output ports vertically aligned Input ports displayed on the left side of the module Output ports displayed on the right side of the module When you work with a model in compact mode, however, a module's icon will not display and the size of a module graphical element is smaller than in normal mode. In compact mode, a module's name is displayed and the input and output ports are horizontally aligned. From the View menu, choose Refresh. Choosing this functions refreshes the canvas. Viewing the whole model From the View menu, choose Overview. Choosing this function centers the model on the canvas. 24

27 Viewing a model in compact mode From the View menu, choose Compact Mode. The icons are not displayed. Only module names display. For information on how to set the compact mode as a preference, see Setting model preferences on page 22. Toggling between models 1. From the Edit menu, choose All Open Models. The All Open Models dialog box opens. 2. In the All Open Models dialog box, click the up arrow or the down arrow to navigate to the name of the model you want to display. The selected model displays on the canvas. 3. Click Close. Zooming out from a model From the View menu, choose Zoom Out. Deleting a model from canvas You can select a model on the canvas and delete it. Deleting a saved model from the canvas does not delete it from the folder it is stored in. 1. From the Edit menu, choose Select All. All components of a model displayed on the canvas are selected. 2. From the Edit menu, choose Delete. The model is removed from the canvas. Zooming in on a model To view a model in more detail, you can zoom in on the model. To view a model in less detail, you can zoom out from the model. If you have more than one model open in Modeler, you can view different models by toggling between them. From the View menu, choose Zoom In. 25

28 26

29 graphical element displays. Chapter 4 Constructing and executing a model Constructing and executing a model in Modeler involves the following main tasks: Placing and moving modules around on the canvas Configuring modules Connecting modules Running the model Placing a module on the canvas using Add to Canvas To facilitate model construction, modules have the following properties: A module can be moved from one location to another on the canvas Two or more modules can be selected on the canvas and moved simultaneously The location of the ports on a module can be changed A module can be deleted from a canvas 1. In the Module Librarian, from the Algorithm Library tree view, choose a module. 2. Click Add to Canvas. 3. Click anywhere on the canvas. The module Placing a module on the canvas using Select Algorithm 1. In the Module Librarian, from the Algorithm Library tree view, choose a module. 2. Click the module's graphic element displaying in the Select Algorithm view. 3. Click anywhere on the canvas. The module graphical element displays. For information on configuring a module, see Accessing a module's control panel on page 30. For examples of configuring modules, see Common modules on page 51. Moving a single module Click a module and drag it to a different location on the canvas. If the module is connected to pipes, the pipes remain connected and automatically adjust. Moving two or more modules simultaneously 1. On the canvas, click and drag a box around the modules that you want to move. 27

30 2. Click one of the selected modules and drag it to a different location. If the modules are connected with pipes, the pipes remain connected and move with the modules. Tip: You can also move two or more modules by pressing the CTRL key, clicking each module to be moved, clicking a selected module, and dragging it to a different location. Changing the location of a module's ports by 90 degrees Deleting a module from the canvas 1. On the canvas, click a module. 2. From the Edit menu, choose Delete. The module and all pipes connected to it are removed from the canvas. Tip: You can also delete a module by clicking it, and then clicking the Delete button on the Modeler toolbar. 1. Click a module on the canvas. 2. From the Edit menu, choose Rotate. The ports rotate 90 degrees clockwise. You cannot rotate the ports counterclockwise. When you choose this function, all ports on a module rotate; you cannot rotate only one port on a module that has more than one port. 3. To move the ports a further 90 degrees clockwise, repeat steps 1 and 2. Tip: You can also rotate the ports by clicking the module, and then clicking the Rotate button on the Modeler toolbar. Deleting two or more modules simultaneously 1. Press the CTRL key, and click each module that you want to delete. 2. From the Edit menu, choose Delete. The modules and all pipes connected to them are removed from the canvas. Tip: You can also delete two or more modules by pressing the CTRL key, clicking each module to be deleted, and then clicking the Delete button on the Modeler toolbar. 28

31 Connecting modules with a pipe Modules are connected with pipes. A pipe is automatically created if you click the output port of one module and then click a compatible input port of another module. Mixed and Any output ports can be connected to any other type of port. For more information on port types, see Module graphical elements on page 8. Click the output port of the module you want to connect from and then click the input port of the module you want to connect to. A pipe displays if the output data and the input port are compatible. If they are incompatible, then a pipe will not display. Caution: Always connect modules before you configure them, because for some modules the default settings of an input layer can override a module's configuration. An exception is the Import module, which you must configure for it to display a port. Note: You can also connect modules by clicking the input port of one module and the output port of a second module. There is no limit to the number of modules you can connect. Setting preferences for pipes You can customize the color code for a pipe according to the layer type it can transmit. For more information on pipe colors, see Module graphical elements on page 8. To set preferences for pipes: 1. From the Preference menu, choose Preference. The Main Preferences dialog box opens. 2. Click the Pipe Colors tab. 3. For a pipe type, click the down arrow to the right of the pipe type, and choose a color from the list. 4. Click Accept. To set default parameters for pipe colors: 1. In the Set to Defaults section, click Default. 2. Click Accept. To save pipe color preferences: From the Preference menu, choose Save Preferences. To connect a module from a pipe: 1. Click a pipe. The pipe displays with a blue border. 2. Click an available input port of a module. A pipe branches from the original pipe to the module. 29

32 Note: With this type of connection, the same data is sent to both modules. The connection does not split the data. For information on splitting data, see Placing the Split module on the canvas on page 61. To break a connection between modules: 1. Click a pipe. The pipe displays with a blue border. 2. From the Edit menu, choose Break Connection. The pipe is removed. Tip: You can also delete a pipe by clicking it, and then clicking the Delete button on the Modeler toolbar. Accessing a module's control panel You configure a module from its control panel. Although all modules have a control panel, not all modules are configurable. The control panel for non-configurable modules provides access to process messages only. Parameters on the control panel are color coded to help you determine which parameters are mandatory and which are optional: Red disk: Mandatory parameter Yellow disk: Optional parameter Green disk: Parameter has been provided All parameters that you configure for a module are local. Hence, you can configure a parameter differently for different modules within the same model. For information on configuring a specific module, see the Geomatica Algorithm Reference. For examples of configuring modules, see Common modules on page On the canvas, click a module, and then right-click. 2. Choose Open MCP(s). The module's control panel opens. You can now configure the module. When a module is correctly configured, the red status indicator of the module graphical element is replaced by a green status indicator. Tip: You can also access a module's control panel by double-clicking the module's icon. Accessing the control panels of two or more modules 1. Press the CTRL key, and click each module for which you want to open the control panel. 2. On the canvas, click a module, and then right-click. 3. Choose Open MCP(s). The control panel for each selected module opens. You can now configure the modules. When a module is correctly configured, the red status indicator of the module graphical element is replaced by a green status indicator. Closing all control panels From the Edit menu, choose Close All Module Control Panels. 30

33 Hiding the icon of a module By default, all modules display with icons. When you deselect the Icons Visible command, all modules display without icons. When you choose to display a module without an icon, the size of a module's graphical element does not change. If you want to reduce the size of the graphical element, you must display the model in compact mode. For information on displaying a model in compact mode, see Viewing the whole model on page 24. The File Utility dialog box enables you to view detailed information about a selected GeoGateway file. You can also edit certain types of information depending on the GeoGateway format type and read/write status of the file. From the View menu, choose Icons Visible. The check mark next to the Icons Visible command is removed, and icons do not display. Making icons visible From the View menu, choose Icons Visible. A check mark displays next to the Icons Visible command, and icons display. Note: You can also access this option from the Model tab in the Main Preference dialog box, see Setting model preferences on page 22. Accessing the File Utility From the File menu, choose Utility. The File Utility dialog box opens. Executing a model in single execution mode After you have placed, configured, and connected the modules, you can execute the model. You can also stop a run. From the Execute menu, choose Run. The Progress Monitor bar displays. If the Viewer module is part of your model, the Modeler Viewer window automatically displays a map. For information on the Viewer module, see Placing the Viewer module on the canvas on page 59. If your model contains improperly configured modules, the model will not execute, and the improperly configured modules will deactivate. For information on activating a module, see Activating a deactivated module on page 33. Tip: You can also execute a model in single execution mode by clicking the Run Model button on the Modeler toolbar. 31

34 Stopping a run in single execution mode From the Execute menu, choose Stop. Tip: You can also stop a run in single execution mode by clicking the Stop button on the Modeler toolbar. Re-running a model in single execution mode 1. From the Edit menu, choose Clear All Caches. 2. From the Execute menu, choose Run. Tip: To reduce processing time, do not clear the caches after you add a module to a model that has run. When you re-run the updated model, only the added module and all modules directly downstream from it will re-run. To reduce processing time, do not clear the caches after you re-configure a module of a model that has run. When you re-run the updated model, only the re-configured module and all modules directly downstream from it will re-run. Viewing a log message The Log tab on a module's control panel displays information recorded while the module was executing. When an executing model encounters an error, a process message displays in the text box on the Log tab. 1. Double-click the icon of a module. The module's control panel opens. 2. Click the Log tab. The process message displays in the text box. Viewing the console content The Console provides the following information about a model that has been executed: The name of the model The name of each module in the model Parameter settings for each module Process message for each module Time at which the model was executed You can also save the console content to a text file. From the View menu, choose Console. The Warning Messages dialog box displays. Viewing pipe content You can view the content of a cache bulge in a Cache Viewer window. The name of the file is displayed in the Viewer title bar. Pipe content and cache content are the same. 1. Click a pipe, and then right-click the pipe. 2. Choose View Pipe Contents and the file name. The pipe content displays in a Cache Viewer window. 32

35 Viewing cache content 1. Click a cache bulge, and then right-click the cache. 2. Choose View Cache, 1 or 3 Layers. The layer or layers display in a Cache Viewer window. A Cache Viewer window displays a map of the first layer if fewer than three layers are available. If three or more layers are available, then the first three layers are displayed. Note: You can also view the cache content by double-clicking the cache bulge. Clearing cache contents From the Edit menu, choose Clear All Caches. Note: Clearing the cache content is the same as clearing the pipe content. Tip: You can also clear the cache content by clicking the cache bulge and pressing the DELETE key. Activating a deactivated module All incorrectly configured modules in a model will deactivate if the model is run. The deactivation is indicated by a break through the center of the module's icon (see Module graphical elements on page 8 ). You can reactivate a module by configuring it correctly. Modules deactivate most commonly for the following reasons: Mandatory parameters are not configured Input layer missing Output file not specified More than one layer fed into a thin port Caution: If you connect a module with a single output layer to a second module, a thin pipe will connect the modules. If you then increase the number of output layers, a fat pipe will connect the modules. However, the thin input port will not change to a fat input port. If you run the model, the second module deactivates. 1. On the canvas, click a deactivated module, and then right-click. 2. Choose Open MCP(s). The module's control panel opens. 3. Click the Log tab, and read the error message. 4. Click the tab containing the incorrect configuration, and provide the correct input parameter or parameters. 5. Click Accept. Note: If a module deactivates because an incorrect layer was loaded in the Import module, you do not have to reactivate the module prior to the next run. Simply load the correct layer and re-run the model. The module will automatically reactivate. 33

36 Note: Choosing the Clear All Caches command from the Edit menu also activates deactivated modules. However, you must still view the module's control panel to determine the cause of the deactivation and to properly configure the module prior to the next run. Process flow for constructing a model The process flow outlined below provides you with a general overview of constructing and running a model. Depending on the complexity of your model, your specific process flow can differ from the one outlined below. For example, you will not require a Viewer module for some models. The process flow outlined below is valid for models that can be executed in single execution mode and in batch mode. When constructing a model, particularly a complex one, it is advisable to establish and adhere to a process flow because a process flow can facilitate troubleshooting. For an example showing how to construct a model, see Construction of a single execution model on page 37. Step 1. Plan the layout of your model. Step 2. Place all required input files in a convenient location, such as a dedicated drive or a folder. Step 3. Place one or more Import modules if required on the canvas (see Placing the Import module on the canvas on page 52 ) and configure them. Step 4. Place the required process modules on the canvas and configure them (see Placing a module on the canvas using Add to Canvas on page 27 ). Step 5. Place the Export module on the canvas (see Placing the Export module on the canvas on page 55 ) and configure them. Step 6. Place one or more Viewer modules on the canvas if required (see Placing the Viewer module on the canvas on page 59 ) and configure them. Step 7. Connect all modules with pipes (see Setting preferences for pipes on page 29 ). Step 8. Place the Comment module on the canvas and add comments (see Placing the Comment module on the canvas on page 65 ). Step 9. Save the model (see Saving a new model on page 23 ). Step 10. Run the model (see Executing a model in single execution mode on page 31 and Understanding the Batch Parameter Sets Table on page 41 ). Step 11. View the output in the Viewer window if applicable (see Placing the Viewer module on the canvas on page 59 ). 34

37 Accessing the control panel of a module in the Module Librarian You can execute a module in standalone mode directly from the Module Librarian. Standalone mode processing enables you to generate output with minimal software involvement and user interaction. Input and output parameters are configured from a module's control panel. You can view a list of modules that you have opened in a session. The modules in the Common folder of the Algorithm Library cannot be used in standalone mode. In the Algorithm Library tree view, click a module name, and choose Open. The module control panel opens. The control panels that are accessible from the Module Librarian differ from those panels that are accessible from the Modeler canvas. Viewing a list of modules used in a session Through the Oracle Spatial option, Oracle 10g offers the ability to store, index, and manage geographic features represented in raster formats. GeoRaster Metadata Mapper loads raster data sets into your Oracle 10g. The GeoRaster Metadata Mapper is a wizard designed to Create a Metadata Field Mapping file, which contains the mapping scheme for transferring metadata from rasters to fields in a GeoRaster table. This file can be used with the ORARASLOAD in Modeler to transfer rasters in a batch process. Transfer one raster, its metadata, and other values into a GeoRaster table. Update an existing raster, its metadata, and other values in a GeoRaster table. From the File menu, choose GeoRaster Metadata Mapper. The GeoRaster Metadata Mapper opens. Note: You can also access the GeoRaster Metadata Mapper by clicking the GeoRaster Metadata Mapper button on the Modeler toolbar. To view the list, right-click anywhere in the left panel of the Module Librarian. Accessing the GeoRaster Metadata Mapper 35

38 36

39 viewer. Chapter 5 Construction of a single execution model In this section, a brief description of how to construct and execute a model in single execution mode is given. The model uses irvine.pix as input file. The file is located in the Geomatica demo folder. If you wish, you can construct the model to familiarize yourself with the single execution process. Classifying and converting raster data to vector data This example model uses the FMO and the RTV modules to classify raster data and to convert the classified raster data to vector data, respectively. The FMO module performs MODE filtering to remove complex mixes of pixels from the raster to create a classified raster that is easier to interpret than the original raster. The RTV module then converts the classified raster to a vector file in ArcView SHP format for export to a vector Geographic Information System (GIS). The RTV module creates vector polygons that group adjoining pixels that were assigned to a feature or a class during classification by the FMO module. The vector output is then displayed on top of the original raster layer in a For more information on the modules, see the Geomatica Algorithm Reference. Step 1: Placing the modules on the canvas 1. Right-click the canvas, and choose Common Modules, Import. 2. Click in the upper left quadrant of the canvas. 3. In the Module Librarian, expand All Algorithms, and choose FMO. 4. Click Add to Canvas, and click on the canvas to the right of the Import module. 5. In the Module Librarian, expand All Algorithms, and choose RTV. 6. Click Add to Canvas, and click on the canvas to the right of the FMO module. 7. Right-click the canvas, and choose Common Modules, Export. 8. Click to the right of the RTV module. 9. Right-click the canvas, and choose Common Modules, Viewer. 10. Click below the Export module. 11. Right-click the Import module, and choose Duplicate. 12. Click below the RTV module. Step 2: Configuring the first Import module 37

40 1. Double-click the icon of the first Import module. The Import Module Control Panel opens. 2. On the Input Params 1 tab, click Browse. The File Selector dialog box opens. 3. In the File Selector dialog box, navigate to the demo folder, and choose irvine. pix. 4. Click Open. 5. On the Input Params 1 tab, from the Available Layers list, enable the check box for 7[8U]Supervised Classification Results. 6. Click Accept. The output port glyph displays. Step 3: Configuring the second Import module 1. Double-click the icon of the first Import module. The Import Module Control Panel opens. 2. On the Input Params 1 tab, click Browse. The File Selector dialog box opens. 3. In the File Selector dialog box, navigate to the demo folder, and choose irvine. pix. 4. Click Open. 5. On the Input Params 1 tab, from the Available Layers list, enable the check boxes for the following files: 1 [8U] um +/ um TM band 1: blue-green 2 [8U] um +/ um TM band 2: green 3 [8U] um +/ um TM band 3: red 6. Click Accept. The output port glyph displays. Step 4: Connecting the modules 1. Click the output port of the first Import module, and the input port of the FMO module. 2. Click the output port of the FMO module, and then click input port of the RTV module. 3. Click the output port of the RTV module, and then click input port of the Export module. 4. Click the output port of the second Import module, and then click input port of the Viewer module. Step 5: Configuring the FMO module 1. Double-click the icon of the FMO module. The FMO Module Control Panel opens. 2. On the Input Params 1 tab, click the down arrow for X Pixels, and choose 7 from the list. 3. Click the down arrow for Y Pixels and choose 7 from the list. The size of your filter window is now 7 pixels by 7 pixels. 4. Click Accept. Note: You do not need to configure the RTV module. Step 6: Configuring the Export module 1. Double-click the icon of the Export module. The Export Module Control Panel opens. 2. On the Input Params 1 tab, click Browse. The File Selector dialog box opens. 38

41 3. In the File Selector dialog box, navigate to the demo folder. 4. In the File Name box, type polygons. shp. 5. Click Save. 6. Click Accept. Step 7: Executing the model From the Execute menu, choose Run. The layers are displayed in the Viewer. Figure 12. Vector layer displayed on top of original raster layer 39

42 40

43 Chapter 6 Batch processing Batch processing is done using the batch parameter sets table in Modeler. This chapter explains how to execute a model in batch mode. Understanding the Batch Parameter Sets Table When executing a model in batch mode, generally one or more files or layers are processed with one or more batch parameter sets resulting in two or more output files or layers. Batch parameter sets are defined on a module's control panel and include all parameters that can be configured for one batch pass. Each configurable module has a Batch Parameter Sets table, which is used to configure a module for batch mode. The Batch Parameter Sets table has the following properties: Each row of the table is a batch parameter set. The parameters displayed in the table can be edited from the tabs only; parameters cannot be edited from the table. The table can be hidden. The content of the active row in a table displays on the tabs. The values of only the active row can be applied by clicking the Run button (single execution mode) on the Modeler tool bar. Configuring the parameters on the tabs before displaying the Batch Parameter Sets table displays the parameter values in the Batch Parameter Sets table. To facilitate populating the Batch Parameter Sets table, you can Select multiple rows or the whole table and then edit all parameters from the tabs so that all selected Batch Parameter Sets are identical. Click anywhere in a table row to display its contents on the tabs. For some modules, one or more of the following functions are available from the table by right-clicking a column heading: Auto-increment: increments a numeric or a text value that you have to enter. This option updates parameters for all cells in a selected column. Set Automatically: takes the parameter value from the input file or generates the parameter value from the system. This option updates parameter values for a selected cell or cells. Add Files: enables you to add multiple input or output files simultaneously. Selected files are appended to the table. From Input Module: loads the input files as output files. This function acts on all cells in a column and overwrites existing cell content. Change Directory: saves all selected output files simultaneously to the same directory. Add Prefix/Suffix: differentiates output files from 41

44 other files by attaching a prefix, a suffix, a time stamp, or all three to the output file name. This option applies to all selected cells. For examples of configuring modules for batch processing, see Common modules on page 51. Creating a model for batch processing In Modeler, executing a model in batch mode involves three basic steps: 1. Construct the model: place the modules that you require on the canvas and connect them. For information on model construction, see Placing a module on the canvas using Add to Canvas on page Configure the modules for batch mode: set up the batch parameter setstable for each module (see Understanding the Batch Parameter Sets Table on page 41 ). For information on configuring a module, see Common modules on page Execute the model: click the Run Batch button on the Modeler toolbar. Types of batch processing Modeler performs three basic types of batch processing: one file or layer-to-many batch parameter sets many files or layers-to-one batch parameter set many files or layers-to-many batch parameter sets In a single model, you can have various combinations of the above-mentioned batch processing types. At least two batch parameter sets must be defined for at least one module for a model to process in batch mode. Generally, when processing in batch mode, Modeler applies the first batch parameter set (first row of a Batch Parameter Sets table) of the first module. Then, Modeler applies the first batch parameter set of the second module, and so on until the first batch parameter sets of all modules have been executed. Then, Modeler repeats the above process for each subsequent batch parameter set of each module until all parameter sets have been executed. Figure 13. Relationship between batch parameter sets Note: Batch mode is not available with standalone-module processing executed from the Module Librarian. One file-to-many batch parameter sets In one file or layer-to-many batch parameter sets 42

45 processing, Modeler processes the same input file or layer with different batch parameter sets, which you define on a module's control panel. Figure 14. One file or layer-to-many batch parameter sets Input file or layer processing sequence Modeler applies the first batch parameter set to the input file or layer and then stores the result in the first output file. Next, Modeler applies the second batch parameter set to the input file or layer and stores the result in the second output file or appends it as a layer. This process continues until all batch parameter sets have are applied. Many files-to-one batch parameter set In many files or layers-to-one parameter set batch processing, Modeler processes each input file or layer with the same batch parameter set, which you define on a module's control panel. Figure 15. Many files or layers-to-one batch parameter set Input file or layer processing sequence Modeler applies the batch parameter set to the first input file or layer and then stores the result in the first output file. Modeler then applies the same batch parameter set to the second input file or layer and stores the result in the second output file or appends it as a layer. This process continues until all files or layers are processed. Many files-to-many batch parameter sets In many files or layers-to-many batch parameter sets processing, Modeler processes each input file or layer with a unique batch parameter set, which you define on a module's control panel. Figure 16. Many files or layers-to-many batch parameter sets Input file or layer processing sequence Modeler applies the first batch parameter set to the first input file or layer and then stores the result in the first output file. Modeler then applies the second batch parameter set to the second input file or layer and stores the result to the second output file or appends it as a layer. This process continues until all input files or layers are processed. 43

46 Executing a model set up for batch mode in single execution mode You can configure all modules of a model in batch mode and then run the model in non-batch mode to check that your model is correctly set up. In this process, the parameter set that displays on the Input Params 1 panel of a module's control panel is applied. Running a model in batch mode You have to configure at least one module in batch mode to process a model in batch mode. From the Execute menu, choose Run Batch. Note: You can also execute a model in batch mode by clicking the Run Batch button on the Modeler toolbar. Running modules configured for batch mode in single execution mode 1. For each module, choose a batch parameter set. 2. From the Execute menu, choose Run. Stopping a model in batch mode From the Execute menu, choose Stop Batch. Note: You can also stop a model processing in batch mode by clicking the Stop Batch button on the Modeler toolbar. Scheduling a batch process After you have set up a batch process, you can schedule it to start running at a time that is convenient for you. 1. From the Execute menu, choose Schedule Batch. The Schedule Batch dialog box is displayed. Note: You can also access the Schedule Batch dialog box by clicking the Schedule Batch button on the Modeler toolbar. 2. Click the Start batch process at (hh:mm) check box. 3. Click the hour arrow to choose a number between 1 and Click the minute arrow to choose a number between 0 and Do one of the following: to start the process between midnight and noon, choose am. 44

47 to start the process between noon and midnight, choose pm. 6. Click Run. 45

48 46

49 Chapter 7 Constructing and executing a simple model in batch mode In this section, a brief description on how to construct and execute a model in batch mode using two input layers and two batch parameter sets is given. The model uses the DEM layers of irvine.pix and dem.pix as input; the files are located in the Geomatica demo folder. Ten meter contours will be generated for the irvine.pix file, and 25 m contours will be generated from the dem.pix file. The contours will be displayed in separate viewers. The import module, the contour module, the export module, and the viewer module will be configured for batch processing. If you wish, you can construct this model to familiarize yourself with the batch process. For more information on configuring modules for batch processing, see Common modules on page 51. The process flow for constructing and executing this model is as follows: Step 1. Place the Import module on the canvas. Step 2. Import the irvine.pix file and the dem.pix file using the Import module, and select the DEM layers as the input layers. Step 3. Place the Contour, Export, and Viewer modules on the canvas. Step 4. Connect all modules. Step 5. Configure two batch parameter sets for the Contour module: contour interval for 10 m and 25 meter. Step 6. Configure the Export module for Contour10.pix and Contour25.pix output files. Step 7. Configure the Viewer module to display two viewers: Contour10 and Contour25. Step 8. Test the irvine.pix file in single execution mode. Step 9. Execute the model in batch mode. Step 1: Placing the Import module on the canvas 1. Right-click the canvas, and choose Common Modules, Import. 2. Click the canvas. The module displays on the canvas. Step 2: Setting the batch parameters for the Import module 47

50 1. Double-click the Import module icon on the canvas. The Import Module Control Panel opens. 2. On the Import Module Control Panel, click Batch. 3. In the Batch Parameter Sets table, right-click the File column heading, and choose Add Files. The File Selector dialog box opens. 4. Navigate to the demo folder. 5. Press the SHIFT key, and choose dem. pix and irvine. pix. Both file names display in the Batch Parameter Sets table. 6. In the Batch Parameter Sets table, choose irvine. pix. 7. On the Input Params 1 tab, from the Available Layers list, enable the check box for the 10[16S]USGS Elevation Data layer. The Raster column displays in the Batch Parameter Sets table. 8. In the Batch Parameter Sets table, choose dem. pix. 9. On the Input Params 1 tab, from the Available Layers list, enable the check box for the 10[16S]DEM layer. 10. Click Accept. Step 3: Placing the remaining modules on the canvas 1. In the Module Librarian, choose the Contour module in the Algorithm Library tree view, and click Add to Canvas. 2. Click the canvas to the right of the Import module. The module displays on the canvas. 3. Right-click the canvas, and choose Common Modules, Export. 4. Click the canvas to the right of the Contour module. The module displays on the canvas. 5. Right-click the canvas, and choose Common Modules, Viewer. 6. Click the canvas below the Export module. The module displays on the canvas. Step 4: Connecting the modules Connect the modules as follows: The Import module to the Contour module. The Contour module to the Export module. The exit pipe of the Contour module to the Viewer module. For information on connecting modules, see Setting preferences for pipes on page 29. Step 5: Setting the batch parameters for the Contour module 1. Double-click the Contour module icon on the canvas. The Contour Module Control Panel opens. 2. Click Batch. 3. On the Contour Module Control Panel, click the Input Params 1 tab if it is not already displayed. 4. Click the Add button (+) once. 5. Click in the first row of the Batch Parameter Sets table. The row-number cell displays in yellow. 6. On the Input Params 1 tab, click the Contour Interval arrow, and choose 10 from the list. 48

51 7. Click in the second row of the Batch Parameter Sets table. The row-number cell displays in yellow. 8. On the Input Params 1 tab, click the Contour Interval arrow, and choose 25 from the list. 9. Click Accept. Step 6: Setting the batch parameters for the Export module 1. Double-click the Export module icon on the canvas. The Export Module Control Panel opens. 2. Click Batch. 3. On the Export Module Control Panel, click the Input Params 1 tab if it is not already displayed. 4. Click the Add button (+) once. 5. In the Batch Parameter Sets table, click anywhere in the first row. The row-number cell displays in yellow. 6. On the Input Params 1 tab, click Browse. The File Selector dialog box opens. 7. In the File Selector dialog box, navigate to the demo folder. 8. In the File Name box, type Contour10. pix, and click Save. 9. In the Batch Parameter Sets table, click anywhere in the second row. The row-number cell displays in yellow. 10. On the Input Params 1 tab, click Browse. The File Selector dialog box opens. 11. In the File Selector dialog box, navigate to the demo folder. 12. In the File Name box, type Contour25. pix, and click Save. 13. Click Accept. Step 7: Setting the batch parameters for the Viewer module 1. Double-click the Viewer module icon on the canvas. The Viewer Module Control Panel opens. 2. Click Batch. 3. On the Viewer Module Control Panel, click the Input Params 1 tab if it is not already displayed. 4. Click the Add button (+) once. 5. Double-click the first cell of the first row. The row-number cell displays in yellow, and on the Input Params 1 tab, the Viewer Name box is selected. 6. In the Viewer Name box, type Contour Double-click the first cell of the second row. 8. In the Viewer Name box, type Contour Click Accept. Step 8: Testing the irvine. pix file 1. Double-click the Import module icon. The Import Module Control Panel opens. 2. Click Batch, and in the Batch Parameter Sets table, choose irvine. pix. 3. Click Accept. 4. Double-click the Contour module icon. The Contour Module Control Panel opens. 5. Click Batch, and in the Batch Parameter Sets table, choose the first batch parameter set. 6. Click Accept. 7. Click the Viewer module icon. The Viewer Module 49

52 Control Panel opens. 8. Click Batch, and in the Batch Parameter Sets table, choose the first batch parameter set. 9. Click Accept. 10. From the Execute menu, choose Run. The Viewer window displays. Step 9: Running the model in batch mode From the Execute menu, choose Run Batch. When the run is complete, the Modeler Viewer 10 and the Modeler Viewer 25 windows display. 50

53 Chapter 8 Common modules Modeler uses modules to perform processing functions that transform data. These common modules are accessible from the Modeler canvas: Import: imports a file or files that are to be processed Export: exports the processed layers to a file Viewer: enables you to view output as a map Merge: merges layers of the same data type TypeMerge: merges layers of different data type Split: splits layers of the same data type TypeSplit: splits layers of different data type Accumulate: accumulates processed layers before passing the group of layers to the next module in the process flow. This module is primarily used for batch processing. Release: releases stored layers either by group or by layer The Comment module: adds comments to a model The Reproj module: reprojects data This information will familiarize you with various module configurations. Descriptions on configuring these modules for batch mode are also provided where applicable. Parameter-specific information Detailed information for a module's parameters can be found in the Geomatica Algorithm Reference. You can also obtain more information for most modules from the example models (see Placing an example model on the canvas on page 18 ). Configuring a module You configure a module from its control panel for single execution mode and for batch execution mode. Any configurable module can be configured for batch mode (see Understanding the Batch Parameter Sets Table on page 41 ) by using the Batch Parameter Sets table. Non-configurable modules can also be used in a model that will be executed in batch mode. For example, you can use the non-configurable TypeMerge module in batch processing. Import module The Import module is used to load data layers into a model. You have to specify an input file and choose at least one input layer before an output port displays on this module. You can load only one file into an Import module in single execution mode. If you need to load more than one file, either configure the Import module for batch mode or place further Import modules on the canvas. The Import module displays all available layers by type. 51

54 The type of input layers you choose determines the types of output ports that display on the module. An output port displays for each type of layer you choose. If you choose more than one type of output layer, a Mixed-type port also displays. You can load the following data types into the Import module: Raster Vector Bitmap Binary Georeference Lookup table Orbit Text Array Math Models Signatures Pseudocolor table Ground control points For more information on the Import module, see the Geomatica Algorithm Reference. Placing the Import module on the canvas 1. Right-click the canvas, and choose Common Modules, Import. 2. Click the canvas. The module displays on the canvas. Accessing Import module from the control panel 1. On the canvas, click the Import module, and then right-click. 2. Choose Open MCP(s). The Import Module Control Panel opens. Choosing input layers 1. On the Input Params 1 tab, click Browse. The File Selector dialog box opens. 2. In the File Selector dialog box, navigate to the folder containing the file you want to import. 3. Click the file name, and then click Open. 4. Do one of the following: In the File Selector dialog box, navigate to the folder containing the file you want to import, click the file name, and then click Open. The Available Layers list displays the layers sorted by layer type. In the File Selector dialog box, click Remote Data. The Remote Data wizard opens enabling you to access data stored on Oracle 10g. For more information on the Remote Data wizard, see the Selecting Data from Remote Data Sources section of the Geomatica Help. 5. On the Input Params 1 tab, in the Available Layers list, enable the check box for each layer you want to import. The Available Layers list displays the layers sorted by layer type. 6. Click Accept. The red status indicator on the module graphical 52

55 element is replaced by a green status indicator. Deselecting all layers from an Import module that is connected to another module will deactivate the Import module. Viewing process messages On the Import Module Control Panel, click the Log tab. The process messages display. Displaying the Import module in batch mode You configure a module for batch mode by defining two or more batch parameter sets for that module. Modeler can process three multiple-input file configurations in batch mode: Two or more layers in a file processed individually Two or more layers in a file processed collectively A combination of the above mentioned configurations For Modeler to process two or more layers in a file individually, load the file multiple times into the Import module. You then choose a different layer from each copy of the file. For information on loading the same file multiple times into the Import module, see Loading one input file multiple times on page 54. Figure 17. Layers from same file processed individually For Modeler to process two or more layers in a file collectively, load the file into the Import module. You then choose the layers you want to process. Figure 18. Layers from same file processed collectively An alternative method for processing each layer individually is to load all layers in the Import module and 53