Project Wizard

The project wizard is the dialog used for creating a new project, or modifying the settings of an existing project.

Creating a project is done by clicking on the New Project button after starting the application

Tip

When creating a project, none of the settings are final. They can all be modified later.

Modifying a project is done by clicking on the settings button after opening a project

Tip

When modifying an existing project, the wizard will warn if any of the changes are destructive (for example, removing a label name).

Settings

When creating or modifying a project, the following dialog is presented.

Feature Level

The feature level combo-box is there to simplify the definition of a Project. As the complexity of ImFusion Labels grows, it can be difficult for new users to distinguish the main features from the more situational ones. The simpler feature level focuses on the former.

Normal: This is the default, and simplest feature level, only the minimum options needed to create a project are exposed. More specifically, all Image Type are allowed, only one Project Type can be active at a time and Data Tags are disabled.

Advanced: This mode exposes most of the settings to the user. The allowed Image Type can be changed, Data Tags can be configured and multiple Project Type can be enabled at the same time.

Expert: This mode exposes all settings. In addition to the advanced mode, multiple layers of the active Project Type can be configured. For more information, refer to the Layers page.

Functional settings

Project Name This is a simple human-readable name to help identifying the project. Most importantly, it is used in the “Recent Projects” table when starting ImFusion Labels.

Project Path This is the folder in which the project and all its related data will be stored. It should be an empty folder.

Project Type This is the type of annotation that will be associated to each dataset. For more details about the annotation types, see the Project Type page.

Image Type This is the type of datasets that will be allowed in the project. If a type of image is unchecked, it will be skipped by the Import Dialog and not added to the database. If all types are checked, all types of datasets will be allowed.

Data Tags This table is used to define the tags that can be applied to each dataset. For more information about tags, see the Data Tags page.

Depending on the active Project Type, one or more additional tables will be visible. They are used to define the annotation types. For example, if “Pixelwise Segmentation” is checked, the table will define the objects that can be segmented in this project. The labels can be modified, and new labels can be created as well.

After Project Creation

After the project settings are defined, clicking the Accept button will create the project and its file structure.

Once the project is created, the Database tab is active, showing an empty database. The next step is to import datasets into the project, following the process described in the Import page.

Project Instructions

After creating a project, optional instructions can be added. This can be useful to log how the annotations have been performed, or to instruct other annotators. Those instructions are displayed in a side panel on the left, which can also be collapsed:

The instructions are defined by placing a instructions.html next to the project.xml in the project folder. ImFusion Labels only supports a subset of HTML. This includes headings, lists and images. All supported elements are listed here. Images are always loaded relative to the instructions.html file and must reside in the project folder. External images are not supported.

The above screenshot uses the following html file:

<!DOCTYPE html>
<html>
<body>
  <h1>Pick a dataset</h1>
  <p>Please only label datasets which are assigned to you.</p>
  <p>Also notify the project lead when you want to re-label a completed dataset</p>

  <h1>Segmenting lungs</h1>
  <p>When segmenting the lungs please make sure that the Tracheobronchial Tree is included.</p>
  <p>For example the final segmentation should look like this:</p>
  <br>
  <img width="200" src="good.png" />
  <br>
  <p>and <strong>not</strong> like this:</p>
  <br>
  <img width="200" src="bad.png" />
</body>
</html>

If no instructions.html is present (the default), the sidebar won’t be visible.