ZEISS Knowledge Base
Help
ZEISS Knowledge Base

Drawing objects interactively

This guide explains you how to perform an interactive objects drawing.

The interactive objects drawing method allows to directly define the structure edges by using one of the many graphic tools available. The object drawing is, not always but often, the unique approach available to get the object outline and shape. This is more evident when the images have a complex texture or a not well defined edges (e.g. EM or CT images).

Overview

Vision4D offers a wide drawing tool collection, comprising the fully manual methods as well as some semi-automatic approaches. The drawing tool collection is available on the top icon panel. It's content varies according to the viewing method setting.

With the 4D viewing method on, both the Magic Wand tool as well as the tool to place simple geometric shapes, markers or spheres on the volume are available. The 2D viewing method allows access to more tools, including the Manual Drawing tool, the Magic Wand tool, and the simple geometric shapes creator tool. In this modality, the drawn objects can be also edited.

The objects created manually are, to all purposes, evaluable segments, exactly as the objects gathered using the automatic approach (Pipeline). All the available measurements can be quantified.

These objects can also be applied as free shape ROI to mask part of the volume or managed to perform evaluations about between structures' interactions and relationships (Objects Compartmentalization, Objects Co-Localization, etc.).

Drawing objects in 2D

To draw objects in 2D, select the 2D view.

Using the Draw Objects tool

The Draw Objects tool is useful to identify complex 3D structures that can’t easily be segmented using threshold-based techniques. This tool can be used to define completely new objects. The objects drawing workflow starts by defining the outline of objects on a 2D plane. The drawing procedure is continued over all the planes on which the object is extending, scrolling through the stack as needed, until the object is completely outlined. Existing objects can be also be modified adjusting the outline shape.

Defining the outline of objects on a 2D plane:

  1. By default, the brush tool is activated.
  1. Drag and drop the brush tool on the image to define the outline of the object in the current plane.
  2. To remove unnecessary parts of the objects, use the right mouse button to erase portion of the outline with the brush, or select the erase tool from the toolbar.
  3. As you navigate up or down through the stack a shadow of the object outline will appear shaded white.
  4. Use the brush or erase tool on this shadow to confirm the presence of the object in the current plane.
  5. The outline will turn blue
  6. Correct the outline as required. NOTE: Outlines of the same object defined over non-contiguous planes will automatically be interpolated through interstitial planes and appear as blue dashed regions. These can be corrected using the brush or erase tool as needed.
  7. Proceed to add or remove as much of the outline as needed through the whole depth of the object, until the object outline is complete.
  8. Click the Finish button to validate your results, or the Cancel button to discard changes.

As mentioned previously, rather than to define a new object, the Draw Objects tool can also be used to correct existing objects. In that case you should start by using the Select Object button to first activate an object for editing and then use the brush and erase tools as described above. Users can also use an ellipse of polygon to define the outline on the active plane. In either case the brush or erase tools can still be used to further amend the outline if needed.

Using the Move Objects tool

The Move Objects tool is used to change the object position. Once the objects have been created, they can be copied or moved in other positions, planes or time points.

Moving an object:

  1. The Move Objects tool must be selected.
  1. Left-click on the object to select it.
  2. Press the Copy Selected Object button.
  3. Drag the object in a new position.
  4. Press Paste or Move Here to confirm the new location.

In the presence of a 3D object, the whole segment (shape and volume) will be repositioned.

Using the Magic Wand tool

The Magic Wand tool is the starting point for object editing or identifying a handful of significant objects from a larger selection of objects with similar object features. While all the manual object drawing tools are driven by the pure skill of the user, some objects can be identified more quickly using the Magic Wand tool. Only its visual interpretation defines the size and shape of the object.

  1. The Magic Wand tool must be selected.
  1. Position the mouse cursor over the structure of interest.
  2. All the pixels having the same intensity (plus/minus the tolerance) of the pixel below the cursor will be highlighted. NOTE: Changing the target position, the object preview will also change.
  3. Adjust the tolerance value, if the object preview is underestimated or overestimated.

The tolerance sets the intensity percentage range that is located around the focused pixel accordingly to the following settings (the selection is added to the object):

  • All pixels with the same intensity value - tolerance and higher are selected.
  • All pixels with the same intensity value + tolerance and lower are selected.
  • All pixels with the same intensity value ± tolerance are selected.

This means that in the case of a user looking for bright objects with a tolerance of 50, if the user were to click with a pixel with an intensity of 128, the object would include all pixels within the region with an intensity of 78 or more.

The magic wand can be set up to work on all channels of a multichannel image, or on individual channels as needed by using the Channel Visibility panel.

Measuring a structure of interest

The Measure tool is a quick and easy way to measure simple distances or areas. It is a way to estimate the size of a structure when required. For example several automatic operators require information concerning the dimension of the structures. Use the Measure Tool to get these informations.

  1. The Measure tool must be selected.
  1. Select the appropriate tool (linear distance or closed regions).
  2. Apply the measurement over the structure of interest.
  3. Right-click to confirm the area of the measurement.

All the objects drawn manually are listed in the data table. Please refer to the Object Table chapter for more details about the data management.

The objects manually created are labelled using a TAG. By default, the TAG inherits the tool name (e.g., the Magic Wand tool has the Magic Wand TAG).

What is a TAG

The TAG is an object property assigned to it by the running operator (only the preprocessing operators don't use the TAGs) and used to link all the detected objects to a common collection. By default, the TAG inherits the name from the operator that has generated it. For example, the objects created by BLOB FINDER will have a TAG called “Blob Finder”. The TAG is the Vision4D's way to create a logical and hierarchical relationship between the objects without duplicating them. A single object can belong to many collections. Therefore, it can have numerous TAG's attached to it. The rule is: one object, many TAGs.

The operator's name can be edited. We strongly suggest to rename the operators according to the structure detected typology (e.g., DAPI Nuclei, GFP Cells, etc.).

Impressum
Carl-Zeiss-Strasse 22
73447 Oberkochen
Germany
Legal