Creating and Executing Models

Adding Model Components to a Model

  1. Make sure the Model View (#4) and the Model Components (#8) list are visible (Main Menu » View » Model View Mode).
  2. Drag the model component from the Model Components (#8) list into the aggregate component you want to add it to.

Deleting Model Components From a Model

  1. Select the model components you want to delete.
  2. Right-click on the component or link you want to delete and select Delete <ComponentName | Link> or Delete <X> Components if you selected one or more component.

Building a Processing Pipeline

  1. Add the processing components to the model you want to link to a processing pipeline.
  2. Select the Link Components (#7) tool on the Main Toolbar.
  3. Establish the output-input links between components:
    • Left-click on the component producing a given output and hold the mouse button down.
    • Drag the link line onto the target component receiving the produced image/RAT as input.
    • Release the left mouse button.

    Note: Two processing components may share more than one output-input-link, e.g. MapAlgebra and ImageWriter. To establish multiple links between two components, just create as many links as required. However, while you will see the component providing the input images being listed multiple times in the Inputs list of the receiving component, only one link-line will be visible between the components. Please refer to [Multiple Inputs and Outputs] for information on how to reference multiple output/input correctly.

  4. Repeat step 3 until all output-input links between the pipeline components are created.
  5. Deselect the Link Components tool.

  6. Define/double check the components’ properties: For the error-free execution of the processing pipeline, it is important to double check the components’ properties.

    Important: An important concept of the modelling framework is that it requires an image’s data type, dimension, and number of bands (image characteristics) to be explicitly specified. Furthermore, the image characteristics of an output have to match the image characteristics of the associated downstream input. If these characteristics do not match, the pipeline will not execute properly and produce an error.

Selecting Model Components

Select Components Without Any Tool Being Selected

  1. Make sure all tools on the Main Toolbar are deselected.
  2. Press and hold the Ctrl key.
  3. Left-click the unselected components you want to select.

Select Components Using the Selection Tool

  1. Select the Selection Tool (#5) on the Main Toolbar.
  2. Draw a box around the components you want to select:
    • Left-click and hold on a specific location in the model to mark a corner of the ‘selection box’.
    • Drag the mouse to draw a selection box around the components you want to select.
    • Release the left mouse button.

Important: If the Selection Tool is activated (has been selected) on the Main Toolbar, a simple left-click anywhere in the model clears the current selection. However, if you press and hold the Ctrl key, the component clicked will be removed from or added to the current selection depending on whether it is currently selected or not.

Add Components to the Current Selection

Regardless of which of the above methods you are using to select components, just press and hold the Ctrl button while using the given method to add additional components to your selection.

Remove Components From the Current Selection

Selected components can be removed from the current selection by simply selecting them again with any of the two described methods above.

Clear the Current Selection

Press the Clear Selection button (#6) on the Main Toolbar.

Grouping Pipelines into Aggregate Components

  1. Select the components you want to group into an aggregate component.
  2. Open the context menu (i.e. right-click anywhere) and select Create Sequential Group.

Note: LUMASS only allows you to group model components that share the same host (parent) component, i.e. that are inside the same aggregate component. Note that the ‘root’ component is an aggregate component.

Moving and Copying Model Components

If you want to move or copy more than one model component, select the components you want to move or copy before following the below steps.

Drag and Drop

  1. Left-click on (one of) the component(s) you want to copy or move.
  2. Press and hold either the Shift or Ctrl key, depending on whether you want to move or copy the component(s).
  3. Drag the comoponent(s) to its (their) target location (aggregate component) in the model.
  4. Release the left mouse button and the Shift or Ctrl key.

Cut / Copy and Paste

  1. Open the context menu (i.e. right-click anywhere).
  2. Select either Cut ... or Copy ... from the menu depending on whether you want to move or copy the component(s).
  3. Right-click at the target location (aggregate component) to open the context menu.
  4. Select Paste ... from the menu.

Saving Model Component

If you want to save more than one independent model components, select them.

Saving Model Components to Disk

  1. Right click on (one of) the (selected) component(s) to open the context menu.
  2. Select Save ... As ....
  3. Specify the filename under which to save the (selected) model component(s).
  4. Click Save on the FileDialog.

Adding a Model Component to the User Models List

The User Models list (#9) shows models stored in a specific folder configured by the user (Main Menu » Settings » Configure Settings » UserModels). In addition to saving a model component in that folder using the context menu, users can simply drag and drop a model component onto the User Models list:

  1. Press and hold the Ctrl key.
  2. Left-click and hold on the component you want to add to the User Models.
  3. Drag the component onto the User Models list (#9).
  4. Release the left mouse button and the Ctrl key.

Note: Since a model is expected to be encapsulated in a single aggregate component, you may only drag a single component onto the User Models list.

Loading Model Components

Drag and Drop from the User Models List

  1. Scroll to the user model you want to add to the Model View (#4) and the Model Components (#8).
  2. Drag the name of the User Model into the Model View and drop it onto an empty space of the aggregate component you want to add it to.

Drag and Drop from the Filesystem Browser

  1. Open your filesystem browser and navigate to the LUMASS model file (*.lmx or *.lmv) you want to load.
  2. Drag either the *.lmx or *.lmv file into the Model View.
  3. Drop the file onto an empty space within the target aggregate component you want to add the model component to.

Context Menu from a Specific Model Component

  1. Right-click on the aggregate component you want to add a saved model component to.
  2. Select Load into ...
  3. Use the filesystem browser to navigate to the model file you want to add to the given component.
  4. Select either the *.lmx or *.lmv file of the model and confirm by clicking the Open button.

Executing a Model

Execute the Entire Model

To execute the entire model assembled in the Model View, simply press the Play button (#10) on the Main Toolbar.

Execute a Specific Model Component

Users can execute individual aggregate components or individual processing pipelines inside a given aggregate component by executing the aggregate component or the sink component at the bottom or downstream end of the processing pipeline:

  1. Right-click on the model component you want to execute to open the context menu.

  2. Select Execute ... to invoke the component’s Update function.

    Note: In case your processing pipeline ends in a DataBuffer or DataBufferReference component, you would be selecting Update ... in step 2.

Important: Before you execute a selected model component, make sure that all potentially required data that is produced by upstream components and that are not part of the given aggregate component or processing pipeline, have been produced!