Projects and Workspaces

Please take a look at the video that explains the workflow: Create a project

Creating a Simple Project

To create a simple project go to File > Load Image File.

In the Load Image File(s) dialog box you can:

  1. Select multiple files by holding down the Shift or Ctrl keys.
  2. Access a list of recently accessed folders displays in the Go to Folder drop-down list. You can also paste a file path into this field (which will also update the folder buttons at the top of the dialog box).

To later add additional image or thematic layers go to File > Add Data Layer in the main menu.

When loading a rule set into a project, multiple layer aliases might refer to the same physical image channel. This happens when the names of the image layers in the ruleset differ from the names introduced when loading the data. In this case, the View Settings window will display only the layer aliases loaded from the rule set. To avoid such situations, please try to keep consistency in the naming of the image channels.

Creating a Project using the Source View dialog

The Source View dialog provides users a simple data management area to modify input layer alias, display orders and access information on file details.

To open the dialog choose View > Source View.

Select the Add input layer to project button to load data files, alternatively you can select the files in the Windows File Explorer and drag and drop them to the dialog to import them. You can add image layers, vector and point cloud layers to a new or existing project.

Furthermore, eCognition project (.dpr) and workspace (.dpj) files can be added by drag and drop.

This button deletes a selected data layer or a whole project (dependent on selection).

Source View dialog with project selected

The upper pane of the Source View dialog shows the project name, all data layers loaded, their alias and file paths. On selection of a project file or data file the lower pane shows different details and settings.

If you right click in the upper pane on the project name or a data file you can select one of the following options from the context menu:

 

The lower pane of the Source View dialog shows the following details

A) on selection of a project:

B)  on selection of a data file:

 

Use this option to add new maps to your project. Once you have added new maps, you can switch between their properties using the tabs at the bottom of this dialog.

Creating a Project with Predefined Settings

When you create a new project, the software generates a main map representing the image data of a scene. To prepare this, you select image layers and optional data sources like thematic layers or metadata for loading to a new project. You can rearrange the image layers, select a subset of the image or modify the project default settings. In addition, you can add metadata.

An image file contains one or more image layers. For example, an RGB image file contains three image layers, which are displayed through the Red, Green and Blue channels (layers).

Open the Create Project dialog box by going to File > New Project (for more detailed information on creating a project, refer to The Create Project Dialog Box). The Import Image Layers dialog box opens. Select the image data you wish to import, then press the Open button to display the Create Project dialog box.

File Formats

Opening certain file formats or structures requires you to select the correct driver in the File Type drop-down list.

Then select from the main file in the files area. If you select a repository file (archive file), another Import Image Layers dialog box opens, where you can select from the contained files. Press Open to display the Create Project dialog box.

The Create Project Dialog Box


Create Project dialog box

The Create Project dialog box gives you several options. These options can be edited at any time by selecting File > Modify Open Project:

In special cases you may want to ignore the unit information from the included geocoding information. To do so, deactivate Initialize Unit Conversion from Input File item in Tools > Options in the main menu

To define a subset in two-dimensional (2D) image data load the full scene into your workspace:

To define a subset in 3D data please refer to chapter User Guide > Working with Point Cloud Data

Geocoding and Projection

Geocoding

Geocoding is the assignment of positioning marks in images by coordinates. Typically, available geocoding information is automatically detected: if not, you can enter coordinates manually. Images without geocodes create automatically a virtual coordinate system with a value of 0/0 at the upper left and a unit of 1 pixel. For such images, geocoding represents the pixel coordinates instead of geographic coordinates.


The Layer Properties dialog box allows you to assign geocoding information

eCognition can reproject raster image layers and vector layers. If the coordinate system is supported, coordinates from inserted files are detected automatically. If the information is not included in the image file but is nevertheless available, you can edit it manually.

After importing a layer in the Create New Project or Modify Existing Project dialog boxes, double-click on a layer to open the Layer Properties dialog box. To edit geocoding information, select the Geocoding check box. You can edit the following:

Please find eCognition's projection and reprojection tools in Tools > Assign Projection and Tools > Reproject Data described in User Guide > Tools > Projection and Reprojection.

Assign No-Data Values


The Assign No Data Values Dialog Box

No-data values can be assigned to scenes with two dimensions only. This allows you to set the value of pixels that are not to be analyzed. Only no-data-value definitions can be applied to maps that have not yet been analyzed.

No-data values can be assigned to image pixel values (or combinations of values) to save processing time. These areas will not be included in the image analysis. Typical examples for no-data values are bright or dark background areas. The Assign No Data Value dialog box can be accessed when you create or modify a project.

After preloading image layers press the No Data button. The Assign No Data Values dialog box opens:

Importing Image Layers of Different Scales

You can insert image layers and thematic layers with different resolutions (scales) into a map. They need not have the same number of columns and rows. To combine image layers of different resolutions (scales), the images with the lower resolution – having a larger pixel size – are resampled to the size of the smallest pixel size. If the layers have exactly the same size and geographical position, then geocoding is not necessary for the resampling of images.


Left: Higher resolution – small pixel size. Right: Lower resolution – image is resampled to be imported

Editing Multidimensional Map Parameters

When creating a new map, you can check and edit parameters of multidimensional maps that represent time series. Typically, these parameters are taken automatically from the image data set and this display is for checking only. However in special cases you may want to change the number, the distance and the starting item of frames. The preconditions for amending these values are:

To open the edit multidimensional map parameters, create a new project or add a map to an existing one. After preloading image layers press the Edit button. The Layer Properties dialog box opens.

Editable parameters are listed in the following table - Multidimensional Map Parameters:

Parameter Description Calc button Default
Number of frames The number of two-dimensional images each representing a single film picture (frame) of a scene with time dimension. Click the Calc button to calculate the rounded ratio of width and height of the internal map. 1
Frame distance Change the temporal distance between frames. (no influence) 1
Frame start Change the number of the first displayed frame. (no influence) 0

Confirm with OK and return to the previous dialog box. After the a with a new map has been created or saved, the parameters of multidimensional maps cannot be changed any more.

Multisource Data Fusion

If the loaded image files are geo-referenced to one single coordinate system, image layers and thematic layers with a different geographical coverage, size, or resolution can be inserted.

This means that image data and thematic data of various origins can be used simultaneously. The different information channels can be brought into a reasonable relationship to each other.


Layers with different geographical coverage

 

Related to:

From the ground up - Video - Multi-temporal Change Detection (customized import - NDVI - batch)

From the ground up - Video - Customized Import

 

Creating, Saving and Loading Workspaces

The Workspace window lets you view and manage all the projects in your workspace, along with other relevant data. You can open it by selecting View > Windows > Workspace from the main menu.


Workspace window with Summary and Export Specification and drop-down view menu

The Workspace window is split in two panes:

In List View and Folder View, information is displayed about a selected project – its state, scale, the time of the last processing and any available comments. The Scale column displays the scale of the scene. Depending on the processed analysis, there are additional columns providing exported result values.

Opening and Creating New Workspaces

To open a workspace, go to File > Open Workspace in the main menu. Workspaces have the .dpj extension. This function uses the same customized dialog as described for loading an image file (Creating a Simple Project).

See this video that explains the possibilities of creating a predefined import or customized import routine and a detailed template for batch creation of projects - Video - Customized Import

Alternatively you can select workspace (.dpj) or project (.dpr) files in the Windows File Explorer and drag and drop them to the workspace window to import them.


The Open Workspace dialog box

To create a new workspace, select File > New Workspace from the main menu or use the Create New Workspace button on the default toolbar. The Create New Workspace dialog box lets you name your workspace and define its file location – it will then be displayed as the root folder in the Workspace window.

If you need to define another output root folder, it is preferable to do so before you load scenes into the workspace. However, you can modify the path of the output root folder later on using File > Workspace Properties.

User Permissions

The two check-boxes at the bottom left of the Open Workspace dialog box determine the permissions of the user who opens it.

If a Project Edit user opens a workspace before a full user, the Workspace view will display the status ‘locked’. Users can use the Project History function to show all modifications made by other users.

Multiple access is not possible in Data Management mode. If a workspace is opened using an older software version, it cannot be opened with eCognition Developer at the same time.

Importing Scenes into a Workspace


Predefined Import - Import Scenes dialog box

Before you can start working on data, you must import scenes in order to add image data to the workspace. During import, a project is created for each scene. You can select different predefined import templates according to the image acquisition facility producing your image data.

Predefined Import

File > Predefined Import > Import Scenes dialog :

  1. Import template drop-down - select a predefined template (details see next chapter).
  2. Root Folder of Image - Browse to open the Select a Folder dialog and select a root folder that contains your structured image data.
  3. Preview field - displays the subordinate file structure of the selected image data root folder. (To check the resulting preview use the plus and minus buttons to expand and collapse folders and right-click an item and select Delete to remove before importing.)
  4. Click OK to import scenes. The tree view on the left-hand pane of the Workspace window displays the file structure of the new projects, each of which administrate one scene.


Folder structure in the Workspace window
Supported Import Templates

You can use various import templates to import scenes:

Each import template is provided by a so called connector. Connectors are available according to the edition of the eCognition Server you are using. By default, the connectors for predefined import are stored in the installation folder \bin\drivers\import. If you want to use a different storage folder, you can change this setting under Tools > Options > General.

A full list of supported and generic image formats is available in Supported Raster, Point Cloud and Vector Formats

About Generic Import Templates

Image files are scanned into a workspace with a specific method, using import templates, and in a specific order according to folder hierarchy. This section lists principles of basic import templates used for importing scenes within the Import Scenes dialog box.

Import Template (Connector) Description File Formats File Based? Windows Linux
Generic – one file per scene A scene may consist of multiple image layers. All image layers are saved to one file All Yes Yes Yes
Generic – one scene per folder All files that are found in a folder will be loaded to one scene All Yes Yes Yes
Options

Images are scanned in a specific order in the preview or workspace. There are two options:

  1. Check-box Search in subfolders activated:
    • Files in selected folder and all subfolders
    • Takes the first item in current folder
    • If this item is a folder, then steps into this folder and continues search there.
  2. Deactivate the check-box Search in subfolders:
    • Selects only files directly in the folder
    • Alphabetical ascending
      For example, one might import the following images with this folder structure:
      • [selected folder] > [1] > [5] > 1.tif & 8.tif
      • [selected folder] > [1] > [8] > 5.tif
      • [selected folder] > [1] > 3.tif & 7.tif
      • [selected folder] > [3] > 6.tif
      • [selected folder] > 2.tif & 4.tif

Generic import templates may support additional instruments or image readers not listed here. For more information about unlisted import templates contact Trimble via https://support.ecognition.com/

Configuring the Workspace Display

eCognition Developer offers several options for customizing the Workspace.


Context menu in Workspace information pane


Modify Column Dialog Box

To select what information is displayed in columns, right-click in the pane to display the context menu.

  1. Expand All Columns will auto fit the columns to the width of the pane. If this is selected, the menu will subsequently display the Collapse All Menus option.
  2. Selecting Insert Column or Modify Column displays the Modify Column dialog box:
    • In Type, select the column you wish to display
    • In Name, enter the text to appear in the heading
    • In Width, select the width in pixels
    • In Alignment, choose between left, right and center
    • Press OK to confirm. You can change the position of a column by dragging it with the mouse.
  3. Select Delete Column to get rid of a column
  4. Modify Views launches the Edit Views dialog box, which lets you save a particular view.
    • Use the buttons to add or delete views
    • Selecting Add launches the Add New View dialog box. Enter the name of your custom view and select the view on which you wish to base it in the Copy Columns From field.


Edit Views Dialog Box (selecting Add launches Add New View)