ZEISS Microscopy Knowledge Base
Help
ZEISS Microscopy Knowledge Base
Search

Interactive Measurements

Interactive measurements enable you to measure the properties of a sample, for example, angles, area, and intensities of pixels. The tools can be classified as follows (the available tools depend on your hardware setup and licenses):

  • Annotations
  • Enable you to add text labels to an image, mark objects of interest, or determine the coordinates of a point in the standard or relative coordinate system.
  • Areas/Contours
  • The majority of these tools enable you to calculate the area (in pixels) enclosed by various shapes. Furthermore, the mean intensity of the enclosed pixels is also calculated. Some Area Tools are used to calculate the length of curves, such as the Spline Curve tool.
  • Distances
  • Enable you to measure angles and distances between lines, curves and points.

The software offers the possibility to use a magnetic cursor in your image. This cursor detects edges/contrast changes and automatically moves to them, which can help you to add measurements or annotations. Note that this cursor only works reliably on one channel, so for multi-channel images only activate one channel in the view options. The magnetic cursor can be activated and deactivated via the right-click context menu of your image, or with the shortcut Alt + C.

For more information on an individual tool, see the tool reference.

Adjusting Interactive Measurements

You can adjust various properties of interactive measurements, for example:

  • Line color, strength, and style
  • Text font, color, and size
  • Opacity
  • Measurement results displayed in the in the Center Screen Area next to the interactive measurement and in the corresponding tool
  1. An interactive measurement workbench is selected.
  2. You have performed at least one interactive measurement.
  1. Select the desired interactive measurement tool.
  2. Click the gear wheel icon.
  3. White gear (cog) icon with a small white sparkle on dark square background
  4. Adjust the parameters as desired.
  5. The measurements are updated immediately.

Using Interactive Measurement Tools

Interactive measurement tools enable you to measure distances, angles, areas, and intensities of pixels. In the Favorites section you can arrange your favorite tools by simply dragging them from the tools selection to the favorites bar.

  1. An image is displayed.
  2. The Interactive Measurement workbench is selected.
  1. Select the desired measurement tool from the tool selection. Note that by default the Keep Measurement Tool checkbox at the bottom of the tool selection is activated. This will keep the selected tool active after you have drawn in a measurement.
  2. Alternatively, select a tool from the Favorites bar.
  3. If it is not visible, click + Add Tool and double-click on the desired tool.
    Note that only parameters of the active tool are displayed in the workbench area.
  4. Click to place the measurement tool in the image.
  5. For more information about how to use each tool, see Interactive Measurements Workbench.
  6. To add more measurements, repeat the above steps.
  7. The selected tool remains active until you press Esc or close the window Apply selected tool (Esc to abort).

If desired, you can modify the measurement as follows:

  • Sorting interactive measurements
  • Editing interactive measurements
  • Adding an annotation to interactive measurements
  • Repeating or correcting an interactive measurement

Layering Interactive Measurements

Each measurement is stored in an imaginary layer. By default, the first measurement is the bottom layer and the most recent measurement is the top layer. You can change the order of the layers, for example if two measurements overlap and one is obscuring the other.

To move a measurement up or down a layer:

  1. Right-click the measurement.
  2. Select how you want to move the measurement:
  3. Bring Forwards: up one layer
  4. Send Backwards: down one layer
  5. Bring to Front: to top
  6. Send to Back: to bottom

Adding an Annotation to Interactive Measurements

You can add an annotation to an interactive measurement, for example to label an area of the sample.

Adding an annotation

To add an annotation:

  1. At least one measurement is visible in the Center Screen Area.
  1. Double-click the measurement in the Center Screen Area.
  2. Enter the desired text.
  3. To add an extra line of text press the Enter key.
  4. Click outside the measurement.

You can change the formatting of the annotation in the same way as you change the appearance of the measurement result.

  1. You cannot apply different text formatting to the annotation and the measurement result.
  2. You cannot apply different formatting to individual words or characters of the annotation.

Removing an annotation

To remove an annotation:

  1. At least one measurement is visible in the Center Screen Area.
  1. Double-click the desired measurement.
  2. Delete all the text in the annotation.
  3. Click outside the measurement.

Editing Interactive Measurements

You can change the following properties of an interactive measurement:

  • Size and position of the entire measurement (measurement result and individual nodes)
  • Position of measurement result
  • Number and position of individual nodes

For some tools you can change their orientation (rotation or placement of the measurement arcs).

For more information, refer to the help topic for the corresponding tool.

Entire measurement

To change the properties of the entire measurement:

  1. At least one measurement is visible in the Center Screen Area.
  1. Click the desired measurement and perform one of the following actions:

Graphic

Aim

Action

Gray octagon inside a blue rectangular frame with a dashed blue octagon outline above-left

Move measurement

Click within the bounding box and drag

Gray octagon inside a blue rectangular frame with a dashed blue octagon overlay and blue square resize handles

Resize freely

Drag the sides of the bounding box

Gray octagon inside a blue rectangular frame with a dashed blue octagon inset and blue corner resize handles

Resize (proportional)

Press Ctrl and drag the corners of the bounding box

Measurement result

To change the properties of the measurement result:

  1. At least one measurement is visible in the Center Screen Area.
  1. Click the desired measurement and perform the following action:

Graphic

Aim

Action

Gray octagon inside a blue rectangle below a blue circle labeled Abc and a small dashed circle labeled Abc

Move measurement result

Drag the node of the measurement result

Annotation position

To alter the position of an annotation:

  1. At least one measurement is visible in the Center Screen Area.
  1. Click the desired measurement.
  2. Place the cursor over the annotation node. The cursor changes to a hand icon.
  3. Drag the node to the new location.

Individual nodes

To change the properties of individual measurement nodes:

  1. At least one measurement is visible in the Center Screen Area.
  2. The measurement was created by defining multiple nodes.
  1. Right-click the desired measurement.
  2. Click Edit Points.
  3. Perform one of the following actions:

Graphic

Aim

Action

Gray octagon left connected by a dashed blue polyline to a blue triangular node shape with three circular node handles

Move node

Drag node

Light gray polygon with three blue circular nodes along its upper-right edge

Add node

Click between two nodes

Light gray polygon with three blue circular nodes and a dashed blue line between the top and right nodes

Remove node

Press Ctrl and click node

Hiding an Interactive Measurement

Normally, when a job is run, interactive measurements are automatically placed on the image at the location specified in Create a new template and edit it within Job Mode. However, it is also possible to create an interactive measurement task where the image has no measurements pre-placed. In this case, ensure that the operator knows where to perform the measurement (e.g. using a suitable workbench description).

  1. Click the desired measurement.
  2. Delete the measurement using the DEL key on your keyboard.

The tool remains in the Workbench Area but the measurement is no longer displayed in the image. The operator running the job later can create the measurement freely instead of modifying a pre-placed measurement.

You can also use this feature to correct a faulty measurement while working in Create a new template and edit it within Job Mode:

  1. Delete the measurement from the image and click the Redraw button in the tool to repeat the measurement correctly.

Changing Units of Measurements

  1. You have drawn in a measurement to an image, e.g. a Distance measurement.
  1. Select the measurement by clicking on it.
  2. Click on the Properties icon in the measurement box.
    Interactive Measurements UI showing Distance 1 value 1029,909 µm and Create Table button
  3. The Properties dialog opens.
  4. Select the desired unit from the Unit drop-down list, e.g. mm instead of µm.
    Properties dialog with Unit dropdown open showing mm selected among µm m cm nm pm in mil
  1. The changed unit will be displayed in the image and in the measurement box.
    Length 1 panel showing Distance 1,072 mm

Adding Measurements to a Live Image

  1. The 2D Acquisition or 2D Acquisition (automatic) Workbench is selected.
  2. You see the Live image of the microscope camera.
  1. Click on + Add Tool.
  2. The list of tools is displayed.
  3. Double-click on the desired measurement tool under Areas/Contours or Distances, e.g. Distance.
  4. The measurement tool is active.
  5. Draw in the measurement to the live image.
  6. If you click on Snap, the image will be acquired including the drawn in measurement. Do not forget to save the image to your file system.

Formatting Graphical Elements

Once you have applied annotations, angles or other graphical elements to your image, you can format each of them separately. It is only possible to format the elements in the Interactive Measurements workbench. If the formatted element is available in the Topography Measurements workbench, the applied format will be used there as well. The following tools of the workbenches correspond:

Topography Measurements workbench

Interactive Measurements workbench

Profile Distance tool

Distance tool

Profile Angel tool

Angle tool

Profile Line (x, y) tool

Not available

Profile Circle (Radius, In-Out) tool

Circle (Radius, In-Out) tool
  1. In the Interactive Measurement workbench, you have added text or measurements to an image, e.g. a distance measurement.
    Grayscale image with red horizontal measurement arrow labeled 266888,884 nm
  1. Select the element, and from the context menu, select Format Graphical Elements.
  2. The following dialog is displayed.
    Dialog titled Format graphical elements showing red line color bar, font Calibri, size 10 pt, opacity 100 and default/reset buttons
  3. Format the graphical elements according to your needs, e.g., click on the red line and choose a different color. Note that it is not possible to adapt the font size for a tool of the Topography Measurements workbench. To use the new formats for any measurement of this tool in both workbenches, click Set As New Global Default, and click Close.
  4. From now on, the format settings are used for all measurements of the configured tool, and for the corresponding tools of the Topography Measurements workbench.
    Grayscale image with magenta dotted horizontal measurement arrow labeled 266888,884 nm

ON THIS PAGE

PRODUCTS
ZENX Ray SoftwareEM SoftwareSolutions Lab
ABOUT ZEISS
AboutCareerNewsroomCompliance
Social Media
LinkedInFacebookYouTubeXInstagram
Impressum
Carl-Zeiss-Strasse 22
73447 Oberkochen
Germany
Legal